Aura defines 4 tools with mixed quality. Two patch tools (project__apply_patch, project__patch) have detailed parameter schemas and descriptions but lack critical error handling guidance. One session search tool is well-described with sensible constraints. One export tool lacks output documentation. All tools have descriptions above 20 chars and input schemas with types, but error recovery patterns and output structure documentation are largely absent. Tool naming is clear (verb_noun pattern), but composition could be tighter.

• Add explicit return type documentation for session__export. Document the bundle directory structure, metadata format, and artifact storage layout. Example: 'Returns a dict with keys: {session_id, out_dir, num_artifacts, manifest_ref}'.
• Add error classification to all patch tools. Document retryable errors (merge conflict, encoding issue) vs. fatal ones (invalid patch format, permission denied). Include recovery guidance: 'On merge conflict, return conflict markers and suggest calling project__patch with a simplified diff.'
• Consolidate project__patch and project__apply_patch into a single tool that accepts both unified diff and apply_patch format, with a 'format' parameter enum. Or rename one to avoid confusion (e.g., project__apply_patch_raw vs. project__apply_unified_diff).
• Add output schema definitions for all tools. Use structured JSON responses with typed fields, not free-form text. E.g., {ok: bool, changes: [{file, before_ref, after_ref, diff_chars}], errors: [{code, message, file}]}.
• For session__export, document behavior on collision (overwrite, error, new suffix). Validate 'out_dir' is not an absolute path or outside project root. Return structured result: {ok, export_dir, session_id, artifact_count, manifest_url}.
• Add dry_run validation guidance to descriptions. E.g., 'Set dry_run=true to preview changes without writing files. Always dry_run first for large or risky patches.'
• For session__search, document max_results behavior when results exceed limit. Does it return a cursor for pagination? What is the total count?