Session Watcher provides 3 read-only transcript search tools with reasonable input schemas but inconsistent description quality and minimal output schema documentation. Tool names use clear verb_noun convention (turn_page, turn_search, turn_locate). Descriptions are present but vary in clarity, turn_search and turn_locate have detailed guidance (~150-200 chars), while turn_page is more terse (~100 chars). Input parameters have type definitions and descriptions, but output schemas are entirely undocumented. No parameter enums or constraints are specified. Error handling and recovery guidance are absent. Tools are composition-friendly (each does one thing) and appear idempotent (read-only operations). The codebase shows attention to deterministic serialization and text encoding (lib/dialogue-tool.js), suggesting care for reliable tool behavior, but this sophistication is not reflected in the public tool interface documentation.

• Document output schema for all three tools. Specify field names, types, and whether results are paginated. Example: 'Returns array of {turn_id: string, speaker: string, content: string, timestamp: ISO8601, scope?: string}'.
• Add parameter format guidance. For turn_page's 'before' parameter, explain the S{k}:{T} cursor format (what k and T represent, whether cursors are opaque or parseable).
• Specify default pagination behavior. If turn_search and turn_locate return all matches by default, document any limits ('Results limited to 100 most recent matches') or note if pagination is manual-only.
• Add error recovery hints to tool descriptions. Example: 'If search returns no results, try a shorter query term or use turn_locate to search by concept instead of exact literal.'
• Consider adding a 'scope' enum to turn_search and turn_locate with examples: S{k}:{T} format and what values mean. LLMs need help understanding the scoping grammar.
• Document any rate limits or performance characteristics (e.g., 'turn_search may be slow on very large transcripts; consider narrowing the scope parameter').