@devries-cameron20 / composio-1 / commits / 3639ad29a
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.

docs(changelog): align free-form object release notes

jkomyno committed Aug 7, 2026 at 00:07 UTC 3639ad29a69b925dfc047569b4ba292b134667a0
2 files changed +19 -18
docs/content/changelog/08-06-26-free-form-tool-arguments.mdx
+18 -18
@@ -4,23 +4,20 @@ description: 'Tool arguments declared as bare objects are no longer rejected or
4 date: '2026-08-06'
5 ---
6
7 -## Version Information
7 +### SDK Versions
8
9 -### Python
10 -
11 -- Package: `composio`
12 -- Version: `0.19.0`+
13 -
14 -### TypeScript/JavaScript
15 -
16 -- Packages: `@composio/core`, `@composio/json-schema-to-zod`, `@composio/claude-agent-sdk`
17 -- Versions: `0.15.0`+, `0.3.0`+, `0.11.0`+
9 +| SDK | Version |
10 +| ----------------------------------------- | -------- |
11 +| Python `composio` | `0.19.0` |
12 +| TypeScript `@composio/core` | `0.15.0` |
13 +| TypeScript `@composio/json-schema-to-zod` | `0.3.0` |
14 +| TypeScript `@composio/claude-agent-sdk` | `0.11.0` |
15
16 ---
17
18 A tool argument declared as a bare `{"type": "object"}` — with no `properties` of its own — was rejected or silently emptied at every schema conversion boundary. This affects any tool that takes a free-form payload, such as `dataset_query` on `METABASE_POST_API_CARD`.
19
23 -## What Changed
20 +### What Changed
21
22 An object schema that names no properties is now treated as open: arbitrary content is accepted and preserved, at the root, nested inside another object, and inside array items.
23
@@ -47,7 +44,9 @@ In TypeScript the same schema was rejected outright rather than emptied, both in
44
45 Those inputs are now accepted.
46
50 -### Dynamic keys apply only where they should
47 +The CLI-side fix ships with the CLI binary rather than the npm packages above. Upgrade it with `composio upgrade`.
48 +
49 +#### Dynamic keys apply only where they should
50
51 Where a schema declares `patternProperties` or a schema-valued `additionalProperties`, each key is now validated against exactly the schemas that claim it. Previously a key could pass by satisfying an unrelated pattern instead of its own.
52
@@ -57,7 +56,7 @@ Where a schema declares `patternProperties` or a schema-valued `additionalProper
56
57 Root-level `patternProperties` and boolean- or schema-valued `additionalProperties` also survive tool schema parsing; they were previously dropped before any converter could see them.
58
60 -## Behavior Change for Python Agentic Providers
59 +### Behavior Change for Python Agentic Providers
60
61 <Callout type="warn">
62 **Behavior change**
@@ -85,12 +84,13 @@ wrapped.run({"name": "a", "typo": 1})
84
85 This brings Python in line with the TypeScript SDK, where the Zod converter has always rejected unknown keys for schemas that name properties. Strictness applies only when `additionalProperties` is omitted; `additionalProperties: true` and schema-valued forms behave as declared.
86
88 -### Not affected
87 +#### Not affected
88
90 -- **`composio_openai`, `composio_anthropic`, `composio_gemini`, and the other non-agentic providers.** These hand the raw JSON schema to the model API and pass the returned arguments straight through, so they never build a Pydantic model from a tool schema.
89 +- **`composio_openai`, `composio_anthropic`, and the other non-agentic providers.** These hand the raw JSON schema to the model API and pass the returned arguments straight through, so they never build a Pydantic model from a tool schema.
90 +- **`composio_gemini`.** Gemini builds a typed signature through `json_schema_to_pydantic_type`, so free-form object arguments now use `Dict[str, Any]` instead of an empty model. It does not use `json_schema_to_model`, so the unknown-key rejection above does not apply.
91 - **Declared field behavior, aliases for reserved Python keywords, `skip_default`, combiners, and references.** All unchanged.
92
93 -## Behavior Change for the Claude Agent SDK Provider
93 +### Behavior Change for the Claude Agent SDK Provider
94
95 <Callout type="warn">
96 **Behavior change**
@@ -103,11 +103,11 @@ A raw shape carries only the per-property map, so root-level `additionalProperti
103
104 This is also what makes free-form object arguments reach execution intact through this provider: the content of a bare `{"type": "object"}` argument survives registration instead of being discarded with the rest of the root constraints.
105
106 -### Not affected
106 +#### Not affected
107
108 - **`@composio/vercel`, `@composio/langchain`, and `@composio/llamaindex`.** These already registered complete schemas, so they picked the fix up with no change.
109
110 -## Backward Compatibility
110 +### Backward Compatibility
111
112 Accepting and preserving free-form object content is backward compatible: payloads that previously failed now succeed, and payloads that previously arrived empty now arrive complete.
113
ts/packages/cli/CHANGELOG.md
+1
@@ -15,6 +15,7 @@
15
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 - Fix Linux `composio upgrade` failures with `ETXTBSY` by staging CLI files in
20 the install directory and renaming the executable last. The installer and
21 companion repair use the same replacement strategy, and the running binary