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 22, 02:00 UTC
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": {