@devries-cameron20 / composio Mirror · read-only / commits / 35aaa071f
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, 08:30 UTC

docs: update documentation for new changelog entries (#4999)

## Summary Automated documentation updates triggered by new changelog entries merged to next. Generated by Codex via GitHub Actions. Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

sdkrelease[bot] committed Oct 20, 2026 at 19:35 UTC 35aaa071fd4935dff46b6670bcf7764bf3834392
3 files changed +22
docs/content/docs/providers/autogen.mdx
+10
@@ -84,6 +84,16 @@ Each tool comes back as an AutoGen `FunctionTool` with a generated `name`. AutoG
84 `register_tools` is unique to the AutoGen provider. Other providers pass tools straight into the agent constructor, so don't expect this method elsewhere.
85 </Callout>
86
87 +## Argument validation
88 +
89 +The Python AutoGen provider validates tool arguments against the tool's JSON schema on both the `autogen_core` and AG2 `register_tools` paths. It preserves every key the schema allows, including keys allowed by `additionalProperties` or `patternProperties`. If the model omits an optional argument, the schema's declared default applies; arguments without defaults stay absent. Invalid `patternProperties` or schema-valued `additionalProperties` raise an error when the tool is wrapped.
90 +
91 +<Callout type="warn">
92 +Invalid arguments return an error result to the agent: `{"successful": false, "error": "...", "data": null}`. Values must match their declared types: `"5"` is rejected for an integer argument. For schemas with named properties, unknown top-level keys are rejected unless the schema allows them.
93 +</Callout>
94 +
95 +The `autogen_core` tool declaration advertises an open top-level object when the source schema does. AG2's `register_tools` builds declarations from named parameters, so a wholly free-form argument object isn't advertised as open and the model may omit its keys. Free-form objects nested under a declared argument work on both paths.
96 +
97 ## Next
98
99 <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." />
docs/content/docs/providers/google.mdx
+10
@@ -207,6 +207,16 @@ for event in events:
207 </Step>
208 </Steps>
209
210 +### Argument validation
211 +
212 +The Python Google ADK provider validates tool arguments against the tool's JSON schema before execution. It preserves every key the schema allows, including keys allowed by `additionalProperties` or `patternProperties`. If the model omits an optional argument, the schema's declared default applies; arguments without defaults stay absent. Invalid `patternProperties` or schema-valued `additionalProperties` raise an error when the tool is wrapped.
213 +
214 +<Callout type="warn">
215 +Invalid arguments return an error result to the agent: `{"successful": false, "error": "...", "data": null}`. Values must match their declared types: `"5"` is rejected for an integer argument. For schemas with named properties, unknown top-level keys are rejected unless the schema allows them.
216 +</Callout>
217 +
218 +ADK builds tool declarations from named parameters, so a wholly free-form argument object isn't advertised as open and the model may omit its keys. Free-form objects nested under a declared argument work with ADK.
219 +
220 </IntegrationContent>
221
222 </IntegrationTabs>
docs/content/docs/providers/openai.mdx
+2
@@ -410,6 +410,8 @@ The OpenAI integration ships three providers, one per API surface:
410 `@composio/openai` no longer includes Assistants API helpers. Migrate Assistants integrations to the Responses API with `OpenAIResponsesProvider`, using the Responses example above.
411 </Callout>
412
413 +**Free-form arguments in Python Agents SDK tools.** `OpenAIAgentsProvider` preserves the source schema's top-level `additionalProperties` setting in the tool declaration sent to the model. A schema with no declared properties is advertised as open, so the model can supply arbitrary keys.
414 +
415 **Strict mode.** Pass `strict: true` or `strict=True` to `OpenAIResponsesProvider` or `OpenAIAgentsProvider` to normalize each tool's input schema for [structured outputs](https://platform.openai.com/docs/guides/structured-outputs). Every object lists all of its properties in `required` and is closed, while optional properties stay available but accept `null`. A `null` is dropped before the tool runs unless the tool's own schema accepts `null` for that parameter. Tools whose schema strict mode cannot express, such as objects that accept arbitrary keys, `allOf`, `prefixItems`, or unresolved `$ref`s, are sent without strict mode and log a warning.
416
417 <Tabs groupId="language" items={["Python", "TypeScript"]} persist>