@devries-cameron20 / composio-1 / commits / 5e291c6e9
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.

Release: custom tools alpha (0.7.0-alpha.0)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Dhawal Upadhyay committed Mar 18, 2026 at 14:36 UTC 5e291c6e955ae7111b8923d9dea9837e4a6a921f
26 files changed +190 -22
.changeset/custom-tools-alpha-release.md new
+35
@@ -0,0 +1,35 @@
1 +---
2 +"@composio/core": minor
3 +---
4 +
5 +feat(core): custom tools, custom toolkits, and proxy execute for tool router sessions (TypeScript only)
6 +
7 +### Custom Tools
8 +
9 +Define local tools that execute in-process alongside remote Composio tools:
10 +
11 +- **Standalone tools** — no auth, run entirely locally
12 +- **Extension tools** — inherit auth from a Composio toolkit (e.g. Gmail) via `extendsToolkit`
13 +- **Custom toolkits** — group related tools under a namespace
14 +
15 +### Proxy Execute
16 +
17 +`session.proxyExecute()` and `ctx.proxyExecute()` for raw HTTP API calls through Composio's auth layer. Returns `{ status, data, headers }`.
18 +
19 +### Session Creation
20 +
21 +```typescript
22 +const session = await composio.create("user_123", {
23 + toolkits: ["gmail"],
24 + experimental: {
25 + customTools: [myTool, myExtensionTool],
26 + customToolkits: [myToolkit],
27 + },
28 +});
29 +```
30 +
31 +### Other Changes
32 +
33 +- Slug mapping uses backend response (`slug`/`original_slug`) instead of client-side prefix
34 +- Uses official `@composio/client@0.1.0-alpha.62` types
35 +- `proxyExecute` uses official client method
.changeset/pre.json new
+22
@@ -0,0 +1,22 @@
1 +{
2 + "mode": "pre",
3 + "tag": "alpha",
4 + "initialVersions": {
5 + "@composio/cli": "0.2.4",
6 + "@composio/core": "0.6.5",
7 + "@composio/json-schema-to-zod": "0.1.20",
8 + "@composio/anthropic": "0.6.5",
9 + "@composio/claude-agent-sdk": "0.6.5",
10 + "@composio/cloudflare": "0.6.5",
11 + "@composio/google": "0.6.5",
12 + "@composio/langchain": "0.6.5",
13 + "@composio/llamaindex": "0.6.5",
14 + "@composio/mastra": "0.6.5",
15 + "@composio/openai": "0.6.5",
16 + "@composio/openai-agents": "0.6.5",
17 + "@composio/vercel": "0.6.5"
18 + },
19 + "changesets": [
20 + "custom-tools-alpha-release"
21 + ]
22 +}
ts/packages/cli/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/cli
2
3 +## 0.2.5-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.2.4
11
12 ### Patch Changes
ts/packages/cli/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/cli",
3 - "version": "0.2.4",
3 + "version": "0.2.5-alpha.0",
4 "description": "Composio CLI",
5 "main": "./dist/bin.mjs",
6 "private": true,
ts/packages/core/CHANGELOG.md
+34
@@ -1,5 +1,39 @@
1 # @composio/core
2
3 +## 0.7.0-alpha.0
4 +
5 +### Minor Changes
6 +
7 +- feat(core): custom tools, custom toolkits, and proxy execute for tool router sessions (TypeScript only)
8 +
9 + ### Custom Tools
10 +
11 + Define local tools that execute in-process alongside remote Composio tools:
12 + - **Standalone tools** — no auth, run entirely locally
13 + - **Extension tools** — inherit auth from a Composio toolkit (e.g. Gmail) via `extendsToolkit`
14 + - **Custom toolkits** — group related tools under a namespace
15 +
16 + ### Proxy Execute
17 +
18 + `session.proxyExecute()` and `ctx.proxyExecute()` for raw HTTP API calls through Composio's auth layer. Returns `{ status, data, headers }`.
19 +
20 + ### Session Creation
21 +
22 + ```typescript
23 + const session = await composio.create('user_123', {
24 + toolkits: ['gmail'],
25 + experimental: {
26 + customTools: [myTool, myExtensionTool],
27 + customToolkits: [myToolkit],
28 + },
29 + });
30 + ```
31 +
32 + ### Other Changes
33 + - Slug mapping uses backend response (`slug`/`original_slug`) instead of client-side prefix
34 + - Uses official `@composio/client@0.1.0-alpha.62` types
35 + - `proxyExecute` uses official client method
36 +
37 ## 0.6.5
38
39 ### Patch Changes
ts/packages/core/package.json
+1 -1
@@ -1,7 +1,7 @@
1 {
2 "name": "@composio/core",
3 "type": "module",
4 - "version": "0.6.5",
4 + "version": "0.7.0-alpha.0",
5 "description": "",
6 "main": "src/index.ts",
7 "publishConfig": {
ts/packages/providers/anthropic/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/anthropic
2
3 +## 1.0.0-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.6.5
11
12 ### Patch Changes
ts/packages/providers/anthropic/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/anthropic",
3 - "version": "0.6.5",
3 + "version": "1.0.0-alpha.0",
4 "description": "Non-Agentic Provider for Anthropic in Composio SDK",
5 "main": "src/index.ts",
6 "publishConfig": {
@@ -43,7 +43,7 @@
43 "packageManager": "pnpm@10.28.0",
44 "peerDependencies": {
45 "@anthropic-ai/sdk": "^0.52.0",
46 - "@composio/core": "0.6.5",
46 + "@composio/core": "0.7.0-alpha.0",
47 "@mastra/mcp": "^0.12.0"
48 },
49 "devDependencies": {
ts/packages/providers/claude-agent-sdk/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/claude-code-agents
2
3 +## 1.0.0-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.6.5
11
12 ### Patch Changes
ts/packages/providers/claude-agent-sdk/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/claude-agent-sdk",
3 - "version": "0.6.5",
3 + "version": "1.0.0-alpha.0",
4 "description": "Composio provider for Claude Agent SDK",
5 "main": "src/index.ts",
6 "publishConfig": {
@@ -48,7 +48,7 @@
48 "zod": "^3.25.76"
49 },
50 "peerDependencies": {
51 - "@composio/core": "0.6.5",
51 + "@composio/core": "0.7.0-alpha.0",
52 "@anthropic-ai/claude-agent-sdk": ">=0.1.0"
53 },
54 "devDependencies": {
ts/packages/providers/cloudflare/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/cloudflare
2
3 +## 1.0.0-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.6.5
11
12 ### Patch Changes
ts/packages/providers/cloudflare/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/cloudflare",
3 - "version": "0.6.5",
3 + "version": "1.0.0-alpha.0",
4 "description": "",
5 "main": "src/index.ts",
6 "publishConfig": {
@@ -39,7 +39,7 @@
39 "packageManager": "pnpm@10.28.0",
40 "peerDependencies": {
41 "@cloudflare/workers-types": "catalog:",
42 - "@composio/core": "0.6.5"
42 + "@composio/core": "0.7.0-alpha.0"
43 },
44 "devDependencies": {
45 "@composio/core": "workspace:*",
ts/packages/providers/google/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/google
2
3 +## 1.0.0-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.6.5
11
12 ### Patch Changes
ts/packages/providers/google/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/google",
3 - "version": "0.6.5",
3 + "version": "1.0.0-alpha.0",
4 "description": "Google GenAI Provider for Composio SDK",
5 "main": "src/index.ts",
6 "publishConfig": {
@@ -44,7 +44,7 @@
44 "license": "ISC",
45 "packageManager": "pnpm@10.28.0",
46 "peerDependencies": {
47 - "@composio/core": "0.6.5",
47 + "@composio/core": "0.7.0-alpha.0",
48 "@google/genai": "^1.1.0"
49 },
50 "devDependencies": {
ts/packages/providers/langchain/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/langchain
2
3 +## 1.0.0-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.6.5
11
12 ### Patch Changes
ts/packages/providers/langchain/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/langchain",
3 - "version": "0.6.5",
3 + "version": "1.0.0-alpha.0",
4 "description": "",
5 "main": "dist/index.js",
6 "publishConfig": {
@@ -38,7 +38,7 @@
38 "license": "ISC",
39 "packageManager": "pnpm@10.28.0",
40 "peerDependencies": {
41 - "@composio/core": "0.6.5",
41 + "@composio/core": "0.7.0-alpha.0",
42 "@langchain/core": "^1.1.4"
43 },
44 "devDependencies": {
ts/packages/providers/llamaindex/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/llamaindex
2
3 +## 1.0.0-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.6.5
11
12 ### Patch Changes
ts/packages/providers/llamaindex/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/llamaindex",
3 - "version": "0.6.5",
3 + "version": "1.0.0-alpha.0",
4 "description": "Agentic Provider for llamaindex in Composio SDK",
5 "main": "src/index.ts",
6 "publishConfig": {
@@ -41,7 +41,7 @@
41 "license": "ISC",
42 "packageManager": "pnpm@10.28.0",
43 "peerDependencies": {
44 - "@composio/core": "0.6.5",
44 + "@composio/core": "0.7.0-alpha.0",
45 "llamaindex": "^0.12.0"
46 },
47 "devDependencies": {
ts/packages/providers/mastra/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/mastra
2
3 +## 1.0.0-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.6.5
11
12 ### Patch Changes
ts/packages/providers/mastra/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/mastra",
3 - "version": "0.6.5",
3 + "version": "1.0.0-alpha.0",
4 "description": "Agentic Provider for mastra in Composio SDK",
5 "main": "src/index.ts",
6 "publishConfig": {
@@ -43,7 +43,7 @@
43 "license": "ISC",
44 "packageManager": "pnpm@10.28.0",
45 "peerDependencies": {
46 - "@composio/core": "0.6.5",
46 + "@composio/core": "0.7.0-alpha.0",
47 "@mastra/core": "^1.0.4",
48 "zod": "^3.25 || ^4"
49 },
ts/packages/providers/openai-agents/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/openai-agents
2
3 +## 1.0.0-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.6.5
11
12 ### Patch Changes
ts/packages/providers/openai-agents/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/openai-agents",
3 - "version": "0.6.5",
3 + "version": "1.0.0-alpha.0",
4 "description": "",
5 "main": "src/index.ts",
6 "publishConfig": {
@@ -38,7 +38,7 @@
38 "license": "ISC",
39 "packageManager": "pnpm@10.28.0",
40 "peerDependencies": {
41 - "@composio/core": "0.6.5",
41 + "@composio/core": "0.7.0-alpha.0",
42 "@openai/agents": "^0.1.3",
43 "zod": "catalog:"
44 },
ts/packages/providers/openai/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/openai
2
3 +## 1.0.0-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.6.5
11
12 ### Patch Changes
ts/packages/providers/openai/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/openai",
3 - "version": "0.6.5",
3 + "version": "1.0.0-alpha.0",
4 "description": "",
5 "main": "src/index.ts",
6 "publishConfig": {
@@ -38,7 +38,7 @@
38 "license": "ISC",
39 "packageManager": "pnpm@10.28.0",
40 "peerDependencies": {
41 - "@composio/core": "0.6.5",
41 + "@composio/core": "0.7.0-alpha.0",
42 "openai": "catalog:"
43 },
44 "devDependencies": {
ts/packages/providers/vercel/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/vercel
2
3 +## 1.0.0-alpha.0
4 +
5 +### Patch Changes
6 +
7 +- Updated dependencies
8 + - @composio/core@0.7.0-alpha.0
9 +
10 ## 0.6.5
11
12 ### Patch Changes
ts/packages/providers/vercel/package.json
+2 -2
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/vercel",
3 - "version": "0.6.5",
3 + "version": "1.0.0-alpha.0",
4 "description": "",
5 "main": "src/index.ts",
6 "publishConfig": {
@@ -38,7 +38,7 @@
38 "license": "ISC",
39 "packageManager": "pnpm@10.28.0",
40 "peerDependencies": {
41 - "@composio/core": "0.6.5",
41 + "@composio/core": "0.7.0-alpha.0",
42 "ai": "^5.0.0 || ^6.0.0"
43 },
44 "devDependencies": {