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): qualify the reference guarantee for dynamic keys
jkomyno committed
Aug 7, 2026 at 19:39 UTC
ecd9217d5d0bbdf2bd04e6a5cac4bed3094e0e19
1 file changed
+7
-2
docs/content/changelog/08-06-26-free-form-tool-arguments.mdx
+7
-2
@@ -24,6 +24,7 @@ An object schema that names no properties is now treated as open: arbitrary cont
24
**Before:**
25
26
```python
27
+# tool comes from Composio(provider=LangchainProvider()).tools.get(...)
28
# dataset_query is declared as {"type": "object"} with no properties
29
tool.run({"dataset_query": {"database": 1, "query": {"source-table": 2}}})
30
# The argument was accepted, then arrived at execution as an empty object
@@ -56,6 +57,8 @@ Where a schema declares `patternProperties` or a schema-valued `additionalProper
57
58
Root-level `patternProperties` and boolean- or schema-valued `additionalProperties` also survive tool schema parsing; they were previously dropped before any converter could see them.
59
60
+In Python, a `$ref` inside a `patternProperties` or schema-valued `additionalProperties` schema must be a local JSON Pointer such as `#/properties/foo`. External, anchored, and unresolvable references now raise a `ValueError` while the tool is wrapped, rather than being ignored along with the constraint that carried them.
61
+
62
### Behavior Change for Python Agentic Providers
63
64
<Callout type="warn">
@@ -88,7 +91,7 @@ This brings Python in line with the TypeScript SDK, where the Zod converter has
91
92
- **`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.
93
- **`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.
94
+- **Declared field behavior, aliases for reserved Python keywords, `skip_default`, combiners, and references in declared fields.** All unchanged. References inside a dynamic-key schema are the exception, as described above.
95
96
### Behavior Change for the Claude Agent SDK Provider
97
@@ -111,4 +114,6 @@ This is also what makes free-form object arguments reach execution intact throug
114
115
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.
116
114
-The two unknown-key rejections described above — Python agentic providers, and the Claude Agent SDK provider — are the behavior changes. Tools whose schemas set `additionalProperties: true`, or whose objects declare no properties, are unaffected.
117
+The two unknown-key rejections described above — Python agentic providers, and the Claude Agent SDK provider — are the behavior changes at call time. Tools whose schemas set `additionalProperties: true`, or whose objects declare no properties, are unaffected.
118
+
119
+The one remaining change happens earlier, while a Python tool is wrapped: a non-local `$ref` inside a dynamic-key schema now raises instead of being ignored. Only tools whose `patternProperties` or schema-valued `additionalProperties` carry an external, anchored, or unresolvable reference are affected.