20 tools with complete schemas and descriptions, but quality is uneven. All tools have input schemas with type definitions and descriptions present. Naming follows verb_noun convention (desktop_*, session_*, app_*, window_*, observe_*, ocr_*, vision_*, input_*). However, descriptions are terse (10-50 chars typical), lack WHEN/WHY context, and omit recovery guidance. Parameter descriptions exist but are minimal. No output schemas documented. Error handling is absent from tool definitions. Session-based architecture (session_id parameter) adds complexity without clear idempotency guarantees. Tools like window_focus accept multiple selector types (window_id, title, title_contains, app) but lack guidance on precedence or mutual exclusivity.

• Expand tool descriptions to 100-200 chars. Include WHEN to call (e.g., 'Call after app_launch to verify the window appeared'), WHAT it returns (e.g., 'Returns list of window IDs and titles'), and HOW it differs from similar tools (e.g., 'Unlike window_list, this focuses a specific window').
• Document output schemas for all tools. Specify field names, types, and whether they chain to other tools. E.g., 'observe_capture returns {artifact_id: string, width: int, height: int}' so LLMs know artifact_id feeds ocr_read.
• For window_focus, window_move, window_resize: clarify selector precedence. E.g., 'If window_id is provided, it takes precedence over title and app. If only title_contains is given, the first matching window is selected.'
• Add error handling guidance to each tool. E.g., 'app_launch returns {success: bool, error?: string}. If error is "app not found", try app_list to find the correct name. If error is "permission denied", the user must grant access.'
• Document session_id semantics: is it required or optional? Are operations idempotent if session_id is omitted? What is the session lifetime? Add a session_open description explaining when to create a new session vs reuse an existing one.

Inferred effective spec: 2025-06-18+.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry