@devries-cameron20 / composio Mirror · read-only / commits / 1ebdedd1c
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 16:00 UTC

docs(changelog): record the CLI schema compile failure

The wrap-time paragraph named only Python. The CLI now fails the same way on the two defects its validator can detect, so both the dynamic-keys section and Backward Compatibility say which SDK does what, and note that a reference outside a dynamic-key subschema is still left alone.

jkomyno committed Aug 7, 2026 at 22:41 UTC 1ebdedd1cd0c2ee1cb697ebe4f5917d46b6c80a3
2 files changed +4 -1
docs/content/changelog/08-06-26-free-form-tool-arguments.mdx
+3 -1
@@ -84,6 +84,8 @@ wrapped.run({"metadata": {"count_a": 3}})
84
85 In Python, an invalid `patternProperties` or schema-valued `additionalProperties` schema now raises while the tool is wrapped instead of being ignored. This includes an external, anchored, or unresolvable `$ref`, a `patternProperties` key that is not a valid regular expression, or a dynamic-key subschema that is not valid Draft 7. A `$ref` in these schemas must be a local JSON Pointer such as `#/properties/foo`. The rule is transitive: a local pointer whose target carries a non-local reference raises too. A `$ref`-shaped value under `const`, `default`, `enum`, or `examples` is instance data rather than a reference, and is left alone.
86
87 +The CLI's validator fails early on the two of those it can detect: a `patternProperties` key that is not a valid regular expression, and a reference inside a dynamic-key subschema that does not resolve, following local pointers transitively. Both are now reported when the schema is compiled, naming the cached schema path, rather than once per call as though the arguments were at fault. A reference outside a dynamic-key subschema is still left to the validator, so a tool whose unused branch carries a dangling reference keeps working.
88 +
89 ### Behavior Change for Python Agentic Providers
90
91 <Callout type="warn">
@@ -143,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, and so does declaring no properties. Neither opts out of the third change: if the object also carries `patternProperties` or a schema-valued `additionalProperties`, its keys are validated against those schemas. Objects with no dynamic-key constraints at all are unaffected.
147
146 -The one remaining change happens earlier, while a Python tool is wrapped: an invalid dynamic-key schema now raises instead of being ignored. Only tools whose `patternProperties` or schema-valued `additionalProperties` contain an invalid reference, regular expression, or Draft 7 subschema 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.
ts/packages/cli/CHANGELOG.md
+1
@@ -16,6 +16,7 @@
16 ### Patch Changes
17
18 - Free-form object arguments now pass CLI tool-input validation and keep their content instead of failing with an unknown-key error. Run `composio upgrade` to install the fixed CLI binary.
19 +- A tool schema the validator cannot interpret is now reported as a schema compile failure naming the cached schema path, instead of once per call as an input error blaming your arguments. This covers a `patternProperties` key that is not a valid regular expression, and a reference inside a `patternProperties` or schema-valued `additionalProperties` subschema that does not resolve.
20 - Fix Linux `composio upgrade` failures with `ETXTBSY` by staging CLI files in
21 the install directory and renaming the executable last. The installer and
22 companion repair use the same replacement strategy, and the running binary