@devries-cameron20 / composio Mirror · read-only / commits / 7e78b720d
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: update documentation for new changelog entries (#4116)

## Summary - Consolidates the provider documentation generated for the Python 0.19.0 and TypeScript provider releases. - Documents object-schema handling, dynamic-key validation, omitted/default argument behavior, and provider-specific validation failures. - Supersedes #4115, whose generated patch overlaps this one. ## Verification - `bun run types:check` - `bun run test` - `bun run lint:links` - Adversarial source-backed review with Claude Opus 5 (medium effort) --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: jkomyno <alberto@composio.dev>

sdkrelease[bot] committed Aug 11, 2026 at 12:29 UTC 7e78b720df8b7a068e04e04a3bfdcc7c3e5cb983
4 files changed +16
docs/content/docs/providers/anthropic.mdx
+2
@@ -256,6 +256,8 @@ for await (const content of query({
256 }
257 }
258 ```
259 +
260 +The provider registers each tool's complete object schema. Object arguments that declare no properties reach execution with arbitrary nested keys unchanged, while root-level constraints such as `additionalProperties` and `patternProperties` remain enforced. Invalid arguments return an error result, and the tool does not run.
261 </Tab>
262 </Tabs>
263 </Step>
docs/content/docs/providers/crewai.mdx
+4
@@ -65,6 +65,10 @@ print(result)
65
66 Each Composio tool becomes a CrewAI `BaseTool` whose `args_schema` is built from the tool's input schema, so CrewAI validates arguments before running anything.
67
68 +Object arguments that declare no properties accept and preserve arbitrary nested keys. For objects that declare named properties, undeclared keys are rejected unless the schema allows them with `additionalProperties`. Schemas that use `patternProperties` or schema-valued `additionalProperties` also validate dynamic keys before execution.
69 +
70 +The provider preserves whether an optional argument was omitted or explicitly set to `None`. By default, declared defaults are included, while optional arguments without defaults stay absent. Set `schema_config={"skip_defaults": True}` when creating the provider to leave declared defaults absent too.
71 +
72 When validation fails, the tool does not raise. It returns a structured result instead:
73
74 ```python
docs/content/docs/providers/google.mdx
+2
@@ -15,6 +15,8 @@ The Google provider formats Composio tools for [Gemini](https://ai.google.dev/)
15
16 In Python, the Gemini provider (`composio_gemini`) wraps Composio tools as typed callables, and the `google-genai` SDK's Automatic Function Calling executes tool calls inside the chat loop for you. In TypeScript, the Google provider transforms Composio tools into Gemini function declarations, and you run the loop: execute each call with `composio.provider.executeToolCall`, feed the result back, and repeat until the model replies with text.
17
18 +Object arguments that declare no properties preserve arbitrary nested keys in both providers. The TypeScript provider also adds `type: "object"` to schema nodes that declare `properties` without a type, which is the shape Gemini expects for object schemas.
19 +
20 <Steps>
21 <Step>
22 **Install**
docs/content/docs/providers/langchain.mdx
+8
@@ -176,6 +176,14 @@ print(result["messages"][-1].content)
176
177 </IntegrationTabs>
178
179 +## Python argument validation
180 +
181 +The Python LangChain and LangGraph providers build a Pydantic argument model from each tool's JSON Schema. Object arguments that declare no properties accept and preserve arbitrary nested keys. For objects that declare named properties, undeclared keys are rejected unless the schema allows them with `additionalProperties`.
182 +
183 +Schemas that use `patternProperties` or schema-valued `additionalProperties` validate dynamic keys before execution. The providers also preserve whether an optional argument was omitted or explicitly set to `None`. By default, declared defaults are included, while optional arguments without defaults stay absent. Set `schema_config={"skip_defaults": True}` when creating the provider to leave declared defaults absent too.
184 +
185 +When validation fails, the tool does not run. LangChain surfaces the failure as a tool error observation so the agent can correct its arguments and retry.
186 +
187 ## Next
188
189 <Card icon={<BookOpen />} title="What is a session?" href="/docs/how-composio-works" description="How sessions scope users, tools, and auth, and how to reuse them across requests." />