Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs(changelog): say that early schema-defect failure can fail a previously passing call
Both SDKs surfaced an invalid dynamic-key schema only when validation descended into it, so a payload that stayed out of the affected branch ran against a schema that could not fully validate it. Failing at the schema is the point, but it is a behavior change and the entry framed it as affecting only already-failing input.
jkomyno committed
Aug 7, 2026 at 23:26 UTC
3d56a02ff9751db9e78861bf339d8858ccd6fdb1
1 file changed
+1
-1
docs/content/changelog/08-06-26-free-form-tool-arguments.mdx
+1
-1
@@ -145,4 +145,4 @@ The two unknown-key rejections described above (Python agentic providers and the
145
146
`additionalProperties: true` still opts an object out of unknown-key rejection. Declaring no properties does too, unless the object sets `additionalProperties: false` — an explicit `false` closes it, and Python now raises on the unknown keys it used to drop there, the same drop-to-raise transition as the first change. Neither opt-out covers the third change: if the object carries `patternProperties` or a schema-valued `additionalProperties`, its keys are validated against those schemas. An open object with no dynamic-key constraints is unaffected by it.
147
148
-The remaining changes happen earlier, when the tool's schema is first read rather than when it is called: an invalid dynamic-key schema now fails instead of being ignored. In Python that is a raise while the tool is wrapped, covering an invalid reference, regular expression, or Draft 7 subschema. In the CLI it is a schema compile failure, covering an invalid `patternProperties` regular expression or an unresolvable reference inside a dynamic-key subschema. Only tools whose `patternProperties` or schema-valued `additionalProperties` carry one of those defects are affected.
148
+The remaining changes happen earlier, when the tool's schema is first read rather than when it is called: an invalid dynamic-key schema now fails instead of being ignored. In Python that is a raise while the tool is wrapped, covering an invalid reference, regular expression, or Draft 7 subschema. In the CLI it is a schema compile failure, covering an invalid `patternProperties` regular expression or an unresolvable reference inside a dynamic-key subschema. Only tools whose `patternProperties` or schema-valued `additionalProperties` carry one of those defects are affected. Note that this can fail a call that previously succeeded: both SDKs used to surface such a defect only if validation happened to descend into that part of the schema, so a payload that stayed out of the affected branch ran against a schema that could not fully validate it. That is now a failure naming the schema, rather than a silent gap in validation.