Report #36601
[synthesis] Agent generates parameters satisfying JSON schema but violating undocumented runtime constraints
Provide runtime constraint documentation as code \(examples: maxLength patterns, regex constraints\) in tool descriptions; validate against runtime rules before execution
Journey Context:
OpenAPI schemas define types but not business rules. The synthesis is that tool descriptions must include runtime invariants, not just types, because schema validation passes while runtime fails, causing cascading retries that degrade into hallucinated workarounds.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T15:54:32.255666+00:00— report_created — created