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
Revert "Release: custom tools alpha (0.7.0-alpha.0) (#2953)"
dhawaldacb61745209
diff --git a/.changeset/custom-tools-alpha-release.md b/.changeset/custom-tools-alpha-release.mddeleted file mode 100644index 7042fa250..000000000--- a/.changeset/custom-tools-alpha-release.md+++ /dev/null@@ -1,35 +0,0 @@-----"@composio/core": minor------feat(core): custom tools, custom toolkits, and proxy execute for tool router sessions (TypeScript only)--### Custom Tools--Define local tools that execute in-process alongside remote Composio tools:--- **Standalone tools** — no auth, run entirely locally-- **Extension tools** — inherit auth from a Composio toolkit (e.g. Gmail) via `extendsToolkit`-- **Custom toolkits** — group related tools under a namespace--### Proxy Execute--`session.proxyExecute()` and `ctx.proxyExecute()` for raw HTTP API calls through Composio's auth layer. Returns `{ status, data, headers }`.--### Session Creation--```typescript-const session = await composio.create("user_123", {- toolkits: ["gmail"],- experimental: {- customTools: [myTool, myExtensionTool],- customToolkits: [myToolkit],- },-});-```--### Other Changes--- Slug mapping uses backend response (`slug`/`original_slug`) instead of client-side prefix-- Uses official `@composio/[email protected]` types-- `proxyExecute` uses official client methoddiff --git a/.changeset/pre.json b/.changeset/pre.jsondeleted file mode 100644index a04dd3261..000000000--- a/.changeset/pre.json+++ /dev/null@@ -1,22 +0,0 @@-{- "mode": "pre",- "tag": "alpha",- "initialVersions": {- "@composio/cli": "0.2.4",- "@composio/core": "0.6.5",- "@composio/json-schema-to-zod": "0.1.20",- "@composio/anthropic": "0.6.5",- "@composio/claude-agent-sdk": "0.6.5",- "@composio/cloudflare": "0.6.5",- "@composio/google": "0.6.5",- "@composio/langchain": "0.6.5",- "@composio/llamaindex": "0.6.5",- "@composio/mastra": "0.6.5",- "@composio/openai": "0.6.5",- "@composio/openai-agents": "0.6.5",- "@composio/vercel": "0.6.5"- },- "changesets": [- "custom-tools-alpha-release"- ]-}diff --git a/ts/examples/tool-router/src/custom-tools.ts b/ts/examples/tool-router/src/custom-tools.tsindex c9424dc10..05975a661 100644--- a/ts/examples/tool-router/src/custom-tools.ts+++ b/ts/examples/tool-router/src/custom-tools.ts@@ -5,11 +5,6 @@* remote Composio tools. Includes a tool that calls the Gmail API* directly via ctx.proxyExecute().*- * Three tool types demonstrated:- * 1. Standalone — no auth, pure local logic- * 2. Extension — inherits auth from a Composio toolkit (Gmail)- * 3. Toolkit — groups related tools under a namespace- ** Usage:* COMPOSIO_API_KEY=... OPENAI_API_KEY=... bun src/custom-tools.ts*/@@ -19,16 +14,16 @@ import { OpenAIAgentsProvider } from "@composio/openai-agents";import { Agent, run } from "@openai/agents";import { z } from "zod/v3";-// ── 1. Standalone tool (no auth) ────────────────────────────────+// ── Custom tools ────────────────────────────────────────────────+/** Standalone tool (no auth needed) */const getUser = experimental_createTool("GET_USER", {name: "Get user",- description: "Look up an internal user by ID. Returns name, email, and role.",+ description: "Look up an internal user by ID",inputParams: z.object({- user_id: z.string().describe("User ID (e.g. user-1, user-2)"),+ user_id: z.string().describe("User ID (e.g. user-1)"),}),execute: async ({ user_id }) => {- // In a real app, this would query your databaseconst users: Record<string, Record<string, string>> = {"user-1": { name: "Alice Johnson", email: "[email protected]", role: "admin" },"user-2": { name: "Bob Smith", email: "[email protected]", role: "developer" },@@ -39,61 +34,46 @@ const getUser = experimental_createTool("GET_USER", {},});-// ── 2. Extension tool (inherits Gmail auth via proxy execute) ───--const sendCompanyEmail = experimental_createTool("SEND_COMPANY_EMAIL", {- name: "Send company formatted email",- description:- "Draft a company-branded email via Gmail. Adds a standard signature " +- "and formats the body with the company template. The draft appears " +- "in the authenticated user's Gmail drafts folder.",+/** Extension tool — inherits Gmail auth, calls the real API via proxy */+const createDraft = experimental_createTool("CREATE_DRAFT", {+ name: "Create Gmail draft",+ description: "Create a real Gmail draft via the Gmail API. Appears in the user's drafts folder.",extendsToolkit: "gmail",inputParams: z.object({to: z.string().describe("Recipient email address"),subject: z.string().describe("Email subject"),- body: z.string().describe("Email body content (plain text)"),+ body: z.string().describe("Email body (plain text)"),}),execute: async (input, ctx) => {- // Add company branding to the email- const branded = [- input.body,- "",- "---",- "Sent via Acme Corp Internal Tools",- `Drafted by: ${ctx.userId}`,- ].join("\r\n");-- // Build RFC 2822 email and base64url encode- const rawEmail = `To: ${input.to}\r\nSubject: ${input.subject}\r\nContent-Type: text/plain; charset=UTF-8\r\n\r\n${branded}`;- const encoded = Buffer.from(rawEmail)+ const raw = Buffer.from(+ `To: ${input.to}\r\nSubject: ${input.subject}\r\nContent-Type: text/plain; charset=UTF-8\r\n\r\n${input.body}`+ ).toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");- // Create draft via Gmail API using session's authconst res = await ctx.proxyExecute({toolkit: "gmail",endpoint: "https://gmail.googleapis.com/gmail/v1/users/me/drafts",method: "POST",- body: { message: { raw: encoded } },+ body: { message: { raw } },});if (res.status !== 200) throw new Error(`Gmail API error ${res.status}`);const data = res.data as { id: string; message: { id: string } };- return { draft_id: data.id, to: input.to, subject: input.subject };+ return { draft_id: data.id, message_id: data.message.id, to: input.to, subject: input.subject };},});-// ── 3. Custom toolkit (groups tools under a namespace) ──────────-+/** Custom toolkit — groups related tools under one namespace */const roleManager = experimental_createToolkit("ROLE_MANAGER", {name: "Role Manager",- description: "Manage internal user roles and permissions",+ description: "Manage user roles",tools: [experimental_createTool("SET_ROLE", {name: "Set role",- description: "Assign a new role to a user",+ description: "Set a user's role",inputParams: z.object({user_id: z.string().describe("User ID"),role: z.enum(["admin", "developer", "viewer"]).describe("New role"),@@ -103,24 +83,20 @@ const roleManager = experimental_createToolkit("ROLE_MANAGER", {],});-// ── Agent setup ─────────────────────────────────────────────────+// ── Agent ────────────────────────────────────────────────────────const composio = new Composio({provider: new OpenAIAgentsProvider(),});-const session = await composio.create(process.env.COMPOSIO_USER_ID ?? "default", {- toolkits: ["gmail", "weathermap"],+const session = await composio.create("default", {+ toolkits: ["gmail"],experimental: {- customTools: [getUser, sendCompanyEmail],+ customTools: [getUser, createDraft],customToolkits: [roleManager],},});-console.log(`Session: ${session.sessionId}`);-console.log("Custom tools:", session.customTools().map(t => t.slug).join(", "));-console.log();-const tools = await session.tools();const agent = new Agent({@@ -132,32 +108,8 @@ const agent = new Agent({tools,});-// Tool call logging-agent.on("agent_tool_start", (_ctx, tool, details: Record<string, unknown>) => {- const input = (details as { toolCall?: { arguments?: unknown } }).toolCall?.arguments ?? {};- const json = JSON.stringify(typeof input === "string" ? JSON.parse(input) : input, null, 2);- console.log(`\n ┌─ ${tool.name}`);- console.log(` │ INPUT: ${json.length > 500 ? json.slice(0, 500) + "..." : json}`);-});-agent.on("agent_tool_end", (_ctx, tool, result: unknown) => {- let output: unknown;- try { output = typeof result === "string" ? JSON.parse(result as string) : result; } catch { output = result; }- const json = JSON.stringify(output, null, 2);- console.log(` │ OUTPUT: ${json.length > 500 ? json.slice(0, 500) + "..." : json}`);- console.log(` └─ ${tool.name} done`);-});--// Multi-task prompt that exercises all tool types:-// - Standalone local tool (get user)-// - Toolkit local tool (set role)-// - Remote Composio tool (weather)-// - Extension local tool with proxy execute (company email)-const prompt = process.argv[2] ?? `Do all of these:-1. Look up user-1's profile-2. Promote user-2 to admin-3. What's the weather in Tokyo right now?-4. Send a company formatted email to myself summarizing the above results`;+const prompt = process.argv[2] ?? "Get user-1's info and draft an email to them saying hello";console.log(`> ${prompt}\n`);const result = await run(agent, prompt);-console.log(`\n${result.finalOutput}`);+console.log(result.finalOutput);diff --git a/ts/packages/cli/CHANGELOG.md b/ts/packages/cli/CHANGELOG.mdindex 4d6b7675f..aa1c1153c 100644--- a/ts/packages/cli/CHANGELOG.md+++ b/ts/packages/cli/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/cli-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.2.4### Patch Changesdiff --git a/ts/packages/cli/package.json b/ts/packages/cli/package.jsonindex 356a54a08..e02d3e3ba 100644--- a/ts/packages/cli/package.json+++ b/ts/packages/cli/package.json@@ -1,6 +1,6 @@{"name": "@composio/cli",- "version": "0.7.0-alpha.0",+ "version": "0.2.4","description": "Composio CLI","main": "./dist/bin.mjs","private": true,diff --git a/ts/packages/core/CHANGELOG.md b/ts/packages/core/CHANGELOG.mdindex d0af2cf23..fce0f4c21 100644--- a/ts/packages/core/CHANGELOG.md+++ b/ts/packages/core/CHANGELOG.md@@ -1,15 +1,5 @@# @composio/core-## 0.7.0-alpha.0--### Minor Changes--- Custom tools, custom toolkits, and proxy execute for tool router sessions (TypeScript only)- - `experimental_createTool()` — standalone (no auth), extension (inherits toolkit auth via `extendsToolkit`), or grouped in toolkits- - `experimental_createToolkit()` — group related tools under a namespace- - `session.proxyExecute()` / `ctx.proxyExecute()` — raw HTTP calls through Composio auth, returns `{ status, data, headers }`- - Bump `@composio/client` to `0.1.0-alpha.62`-## 0.6.5### Patch Changesdiff --git a/ts/packages/core/package.json b/ts/packages/core/package.jsonindex 2c8dbb6f9..50c803ea9 100644--- a/ts/packages/core/package.json+++ b/ts/packages/core/package.json@@ -1,7 +1,7 @@{"name": "@composio/core","type": "module",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "","main": "src/index.ts","publishConfig": {diff --git a/ts/packages/providers/anthropic/CHANGELOG.md b/ts/packages/providers/anthropic/CHANGELOG.mdindex 461f4445d..6fdf2d920 100644--- a/ts/packages/providers/anthropic/CHANGELOG.md+++ b/ts/packages/providers/anthropic/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/anthropic-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.6.5### Patch Changesdiff --git a/ts/packages/providers/anthropic/package.json b/ts/packages/providers/anthropic/package.jsonindex 218fe44e4..c2284464f 100644--- a/ts/packages/providers/anthropic/package.json+++ b/ts/packages/providers/anthropic/package.json@@ -1,6 +1,6 @@{"name": "@composio/anthropic",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "Non-Agentic Provider for Anthropic in Composio SDK","main": "src/index.ts","publishConfig": {@@ -43,7 +43,7 @@"packageManager": "[email protected]","peerDependencies": {"@anthropic-ai/sdk": "^0.52.0",- "@composio/core": "0.7.0-alpha.0",+ "@composio/core": "0.6.5","@mastra/mcp": "^0.12.0"},"devDependencies": {diff --git a/ts/packages/providers/claude-agent-sdk/CHANGELOG.md b/ts/packages/providers/claude-agent-sdk/CHANGELOG.mdindex 39d686445..b36a3d820 100644--- a/ts/packages/providers/claude-agent-sdk/CHANGELOG.md+++ b/ts/packages/providers/claude-agent-sdk/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/claude-code-agents-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.6.5### Patch Changesdiff --git a/ts/packages/providers/claude-agent-sdk/package.json b/ts/packages/providers/claude-agent-sdk/package.jsonindex 1ec6c2900..41df87701 100644--- a/ts/packages/providers/claude-agent-sdk/package.json+++ b/ts/packages/providers/claude-agent-sdk/package.json@@ -1,6 +1,6 @@{"name": "@composio/claude-agent-sdk",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "Composio provider for Claude Agent SDK","main": "src/index.ts","publishConfig": {@@ -48,7 +48,7 @@"zod": "^3.25.76"},"peerDependencies": {- "@composio/core": "0.7.0-alpha.0",+ "@composio/core": "0.6.5","@anthropic-ai/claude-agent-sdk": ">=0.1.0"},"devDependencies": {diff --git a/ts/packages/providers/cloudflare/CHANGELOG.md b/ts/packages/providers/cloudflare/CHANGELOG.mdindex 0be447289..e72b9a740 100644--- a/ts/packages/providers/cloudflare/CHANGELOG.md+++ b/ts/packages/providers/cloudflare/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/cloudflare-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.6.5### Patch Changesdiff --git a/ts/packages/providers/cloudflare/package.json b/ts/packages/providers/cloudflare/package.jsonindex e6be64a6b..6f7c9340a 100644--- a/ts/packages/providers/cloudflare/package.json+++ b/ts/packages/providers/cloudflare/package.json@@ -1,6 +1,6 @@{"name": "@composio/cloudflare",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "","main": "src/index.ts","publishConfig": {@@ -39,7 +39,7 @@"packageManager": "[email protected]","peerDependencies": {"@cloudflare/workers-types": "catalog:",- "@composio/core": "0.7.0-alpha.0"+ "@composio/core": "0.6.5"},"devDependencies": {"@composio/core": "workspace:*",diff --git a/ts/packages/providers/google/CHANGELOG.md b/ts/packages/providers/google/CHANGELOG.mdindex 8338906b1..a7589480b 100644--- a/ts/packages/providers/google/CHANGELOG.md+++ b/ts/packages/providers/google/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/google-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.6.5### Patch Changesdiff --git a/ts/packages/providers/google/package.json b/ts/packages/providers/google/package.jsonindex 53dc9f7d0..8038a4445 100644--- a/ts/packages/providers/google/package.json+++ b/ts/packages/providers/google/package.json@@ -1,6 +1,6 @@{"name": "@composio/google",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "Google GenAI Provider for Composio SDK","main": "src/index.ts","publishConfig": {@@ -44,7 +44,7 @@"license": "ISC","packageManager": "[email protected]","peerDependencies": {- "@composio/core": "0.7.0-alpha.0",+ "@composio/core": "0.6.5","@google/genai": "^1.1.0"},"devDependencies": {diff --git a/ts/packages/providers/langchain/CHANGELOG.md b/ts/packages/providers/langchain/CHANGELOG.mdindex 65ea0ca55..06dc0814f 100644--- a/ts/packages/providers/langchain/CHANGELOG.md+++ b/ts/packages/providers/langchain/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/langchain-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.6.5### Patch Changesdiff --git a/ts/packages/providers/langchain/package.json b/ts/packages/providers/langchain/package.jsonindex 646935034..e52af42aa 100644--- a/ts/packages/providers/langchain/package.json+++ b/ts/packages/providers/langchain/package.json@@ -1,6 +1,6 @@{"name": "@composio/langchain",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "","main": "dist/index.js","publishConfig": {@@ -38,7 +38,7 @@"license": "ISC","packageManager": "[email protected]","peerDependencies": {- "@composio/core": "0.7.0-alpha.0",+ "@composio/core": "0.6.5","@langchain/core": "^1.1.4"},"devDependencies": {diff --git a/ts/packages/providers/llamaindex/CHANGELOG.md b/ts/packages/providers/llamaindex/CHANGELOG.mdindex 8d6a60b3d..e8283e44e 100644--- a/ts/packages/providers/llamaindex/CHANGELOG.md+++ b/ts/packages/providers/llamaindex/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/llamaindex-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.6.5### Patch Changesdiff --git a/ts/packages/providers/llamaindex/package.json b/ts/packages/providers/llamaindex/package.jsonindex 4591bec94..c1579b5d5 100644--- a/ts/packages/providers/llamaindex/package.json+++ b/ts/packages/providers/llamaindex/package.json@@ -1,6 +1,6 @@{"name": "@composio/llamaindex",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "Agentic Provider for llamaindex in Composio SDK","main": "src/index.ts","publishConfig": {@@ -41,7 +41,7 @@"license": "ISC","packageManager": "[email protected]","peerDependencies": {- "@composio/core": "0.7.0-alpha.0",+ "@composio/core": "0.6.5","llamaindex": "^0.12.0"},"devDependencies": {diff --git a/ts/packages/providers/mastra/CHANGELOG.md b/ts/packages/providers/mastra/CHANGELOG.mdindex 66762c26f..c75386b87 100644--- a/ts/packages/providers/mastra/CHANGELOG.md+++ b/ts/packages/providers/mastra/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/mastra-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.6.5### Patch Changesdiff --git a/ts/packages/providers/mastra/package.json b/ts/packages/providers/mastra/package.jsonindex ad7db231d..5a1def989 100644--- a/ts/packages/providers/mastra/package.json+++ b/ts/packages/providers/mastra/package.json@@ -1,6 +1,6 @@{"name": "@composio/mastra",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "Agentic Provider for mastra in Composio SDK","main": "src/index.ts","publishConfig": {@@ -43,7 +43,7 @@"license": "ISC","packageManager": "[email protected]","peerDependencies": {- "@composio/core": "0.7.0-alpha.0",+ "@composio/core": "0.6.5","@mastra/core": "^1.0.4","zod": "^3.25 || ^4"},diff --git a/ts/packages/providers/openai-agents/CHANGELOG.md b/ts/packages/providers/openai-agents/CHANGELOG.mdindex 913fdc530..f05b9f1b7 100644--- a/ts/packages/providers/openai-agents/CHANGELOG.md+++ b/ts/packages/providers/openai-agents/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/openai-agents-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.6.5### Patch Changesdiff --git a/ts/packages/providers/openai-agents/package.json b/ts/packages/providers/openai-agents/package.jsonindex ac59c5a1b..70832a4ae 100644--- a/ts/packages/providers/openai-agents/package.json+++ b/ts/packages/providers/openai-agents/package.json@@ -1,6 +1,6 @@{"name": "@composio/openai-agents",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "","main": "src/index.ts","publishConfig": {@@ -38,7 +38,7 @@"license": "ISC","packageManager": "[email protected]","peerDependencies": {- "@composio/core": "0.7.0-alpha.0",+ "@composio/core": "0.6.5","@openai/agents": "^0.1.3","zod": "catalog:"},diff --git a/ts/packages/providers/openai/CHANGELOG.md b/ts/packages/providers/openai/CHANGELOG.mdindex 5af8283e4..8cad0c054 100644--- a/ts/packages/providers/openai/CHANGELOG.md+++ b/ts/packages/providers/openai/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/openai-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.6.5### Patch Changesdiff --git a/ts/packages/providers/openai/package.json b/ts/packages/providers/openai/package.jsonindex 87f1ae2ac..9cfb4c8f5 100644--- a/ts/packages/providers/openai/package.json+++ b/ts/packages/providers/openai/package.json@@ -1,6 +1,6 @@{"name": "@composio/openai",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "","main": "src/index.ts","publishConfig": {@@ -38,7 +38,7 @@"license": "ISC","packageManager": "[email protected]","peerDependencies": {- "@composio/core": "0.7.0-alpha.0",+ "@composio/core": "0.6.5","openai": "catalog:"},"devDependencies": {diff --git a/ts/packages/providers/vercel/CHANGELOG.md b/ts/packages/providers/vercel/CHANGELOG.mdindex d84dce55b..b30b8adf0 100644--- a/ts/packages/providers/vercel/CHANGELOG.md+++ b/ts/packages/providers/vercel/CHANGELOG.md@@ -1,12 +1,5 @@# @composio/vercel-## 0.7.0-alpha.0--### Patch Changes--- Updated dependencies- - @composio/[email protected]-## 0.6.5### Patch Changesdiff --git a/ts/packages/providers/vercel/package.json b/ts/packages/providers/vercel/package.jsonindex f415becc9..548a633b2 100644--- a/ts/packages/providers/vercel/package.json+++ b/ts/packages/providers/vercel/package.json@@ -1,6 +1,6 @@{"name": "@composio/vercel",- "version": "0.7.0-alpha.0",+ "version": "0.6.5","description": "","main": "src/index.ts","publishConfig": {@@ -38,7 +38,7 @@"license": "ISC","packageManager": "[email protected]","peerDependencies": {- "@composio/core": "0.7.0-alpha.0",+ "@composio/core": "0.6.5","ai": "^5.0.0 || ^6.0.0"},"devDependencies": {