Needle has 20 tools with explicit schemas and descriptions visible in source. However, descriptions are terse (10-50 chars, well below the 194-char baseline), parameter descriptions are minimal or absent, and output schemas are not documented. Tool naming is verb-first and clear (status, workspace_add, search, read, exec), but parameter documentation is sparse. No tool annotations (readOnlyHint/destructiveHint) despite clear risk levels. Error handling guidance is absent, tools return errors but do not guide recovery. Schemas show types (PathBuf, String, SearchOptions) but lack constraints (enums, ranges, patterns). The exec tool accepts arbitrary shell commands with optional timeout but no validation guidance in the description.

• Expand tool descriptions to 100-200 chars. Example: 'status' → 'Get daemon status including version, PID, and build information. Call this first to verify the daemon is running and check its version before other operations.'
• Document SearchOptions and WireBudget types inline or in parameter descriptions. Example: 'options: SearchOptions controlling max_results (1-1000, default 50), case_sensitive (bool), and file_type_filter (optional regex)'.
• Add output schema documentation for each tool. Example: 'repos returns {repositories: [{name, path, language_histogram: {lang: count}}], total_count}'.
• Add tool annotations: mark 'exec' and 'shutdown' with destructiveHint=true; mark 'read', 'search', 'files', 'text', 'symbols', 'refs', 'context', 'inspect', 'raw', 'runs', 'status', 'workspace_list', 'repos', 'ping' with readOnlyHint=true; mark 'workspace_add', 'workspace_remove', 'reindex', 'git' with appropriate hints.
• Add error recovery guidance to 'exec' description: 'On timeout, the command is killed and output is discarded. On non-zero exit, inspect the error output via inspect(handle, failure=true). Adapters (rg, git, cargo, etc.) may transform output, see adapter docs for expected format.'