Single tool 'readtext' has a clear verb-noun name and acceptable description (89 chars), but critical gaps undermine quality. Input schema is visible with two parameters (image_path, detail), both typed as string/boolean with descriptions. However, the output schema is completely undocumented, the description mentions 'text lines with bounding boxes and confidences' but no structured output format is defined. This forces LLMs to guess at response structure. The 'detail' parameter defaults to true but lacks explanation of what 'full detail' vs summary mode returns. No error handling guidance (e.g., what happens if image_path is invalid, unsupported format, or OCR fails). No pagination or result limits documented despite OCR potentially returning many lines. Missing: idempotency statement, permission/scope declaration, and recovery guidance for common failures.
Run CRAFT+CRNN OCR over an image file and return the recognized text lines with their bounding boxes and confidences.
Output schema completely undocumented. Description mentions 'text lines with bounding boxes and confidences' but no structured format (JSON object fields, array structure, data types) is defined. LLMs cannot plan downstream processing without knowing response shape.
No error handling guidance. Tool description does not explain what happens on invalid image_path, unsupported image formats, OCR failures, or file access errors. LLMs receive raw errors with no recovery path.
'detail' parameter defaults to true but lacks explanation of what 'full detail' mode returns vs false. Ambiguous parameter behavior invites misuse.
No result limits or pagination documented. OCR on large images could return hundreds of text lines. Unbounded results risk context window exhaustion.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
No idempotency statement. Unclear if repeated calls with same image_path return identical results or if OCR is non-deterministic. Agents retry on ambiguous failures, non-idempotent tools risk duplicate processing.