Two tools with clear names and reasonable descriptions, but critical gaps in schema completeness and parameter documentation. search_polymarket has a basic input schema (query string) but lacks output schema documentation. submit_decomposition references DecomposeSchema (Zod-based) but the actual schema structure is not visible in the provided code, only the import is shown. Both tools lack explicit parameter constraints (enums, ranges, formats). Error handling is present but generic (Anthropic APIError catch-all). No tool annotations (readOnlyHint/destructiveHint) despite clear risk profiles (READ_ONLY vs WRITE). Descriptions are adequate (100-150 chars) but could be more LLM-optimized with dependency hints and recovery guidance.

• Document the output schema for search_polymarket. Specify that it returns an array of objects with fields: polymarketSlug (string), yesPrice (number), noPrice (number), volume24h (number), liquidity (number), endDate (string ISO 8601). Include this in the tool description or as a separate schema reference.
• Add tool annotations: use betaZodTool's readOnlyHint: true for search_polymarket and destructiveHint: true for submit_decomposition. This enables agents to reason about retry safety and side effects.
• Constrain the 'query' parameter: add maxLength (e.g., 200 chars), pattern (English alphanumeric + spaces), and a note that queries should be 2-5 keywords. Replace examples in description with an enum or pattern constraint.
• Enhance error messages with recovery guidance. E.g., if searchPolymarket returns empty results, return 'No markets found for query "{query}". Try broader keywords like "hurricane", "WTI", or "Fed". Or call submit_decomposition with fewer factors.' instead of a bare error.
• Expose the full DecomposeSchema definition in the code snippet or documentation. Verify that 'factors' array has minItems: 3, maxItems: 6, and each factor object has required fields with descriptions and enum constraints for 'category' (weather|price|policy|macro) and 'severity' (low|med|high|critical).