Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: clarify toolkit version defaults
Kshitij Jhunjhunwala84aea2674fd5
diff --git a/docs/content/docs/tools-direct/fetching-tools.mdx b/docs/content/docs/tools-direct/fetching-tools.mdxindex 3470ff1d5..0c2ee3f0a 100644--- a/docs/content/docs/tools-direct/fetching-tools.mdx+++ b/docs/content/docs/tools-direct/fetching-tools.mdx@@ -241,8 +241,8 @@ const toolkitSearchRaw = await composio.tools.getRawComposioTools({</Tab></Tabs>-<Callout type="warn">-When no toolkit version is specified, the API returns tools from the base version (`00000000_00`), which may be fewer than what's available. Pass `toolkit_versions="latest"` or a specific version to get all tools. Never use `latest` in production. See [toolkit versioning](/docs/tools-direct/toolkit-versioning).+<Callout type="info">+These SDK examples default to `latest` when `toolkit_versions` is omitted. For direct REST calls, omission depends on the API version: v3 defaults to the pinned base version (`00000000_00`), while v3.1 defaults to `latest`. Use `latest` when an LLM consumes tool output; pin a dated version when application code parses the output. See [toolkit versioning](/docs/tools-direct/toolkit-versioning).</Callout>## Nextdiff --git a/docs/tests/static/content.test.ts b/docs/tests/static/content.test.tsindex f525f348b..6d416693c 100644--- a/docs/tests/static/content.test.ts+++ b/docs/tests/static/content.test.ts@@ -12,6 +12,7 @@ const DOCS_DIR = join(import.meta.dir, "../../content/docs");const EXAMPLES_DIR = join(import.meta.dir, "../../content/examples");const CHANGELOG_DIR = join(import.meta.dir, "../../content/changelog");const GOOGLE_PROVIDER_DOC = join(DOCS_DIR, "providers/google.mdx");+const FETCHING_TOOLS_DOC = join(DOCS_DIR, "tools-direct/fetching-tools.mdx");/** Recursively find all .mdx files */async function findMdxFiles(dir: string): Promise<string[]> {@@ -135,6 +136,18 @@ describe("Content - Context7 ingest rules", () => {});});+describe("Content - toolkit version guidance", () => {+ test("the SDK fetching guide distinguishes SDK, REST v3, and REST v3.1 defaults", async () => {+ const content = await readFile(FETCHING_TOOLS_DOC, "utf-8");++ expect(content).toContain("These SDK examples default to `latest`");+ expect(content).toContain("v3 defaults to the pinned base version (`00000000_00`)");+ expect(content).toContain("v3.1 defaults to `latest`");+ expect(content).not.toMatch(/the API returns tools from the base version/i);+ expect(content).not.toContain("Never use `latest` in production");+ });+});+describe("Content - changelog validation", () => {test("changelog files use MM-DD-YY naming pattern", async () => {let entries;