@devries-cameron20 / composio Mirror · read-only / commits / b132aad90
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 22, 13:15 UTC

Update client dependencies and add experimental assistive prompt (#2446)

Musthaq Ahamad committed Jan 23, 2026 at 16:57 UTC b132aad902082bfa0b8bdfb3090f856f26912e95
50 files changed +732 -136
.changeset/fifty-terms-cross.md new
+5
@@ -0,0 +1,5 @@
1 +---
2 +'@composio/core': patch
3 +---
4 +
5 +Update client dependencies and introduce experimentatl tool router features
fern/pages/src/changelog/01-22-26-experimental-assistive-prompts.md new
+113
@@ -0,0 +1,113 @@
1 +# Experimental Assistive Prompts and API Updates
2 +
3 +## Version Information
4 +
5 +### TypeScript/JavaScript
6 +- Package: `@composio/core`
7 +- Version: `0.5.5`+
8 +
9 +### Python
10 +- Package: `composio`
11 +- Version: `0.10.10`+
12 +
13 +## New Features
14 +
15 +### Experimental Assistive Prompt Configuration
16 +
17 +Tool Router sessions now support experimental configuration for timezone-aware assistive prompts. When you provide a user's timezone, the session returns a contextual assistive prompt that includes timezone-specific guidance.
18 +
19 +<Warning>
20 +This is an experimental feature. The API may change or be removed in future versions.
21 +</Warning>
22 +
23 +<CodeBlocks>
24 +```python title="Python SDK"
25 +from composio import Composio
26 +
27 +composio = Composio()
28 +
29 +session = composio.tool_router.create(
30 + user_id="user_123",
31 + toolkits=["github"],
32 + experimental={
33 + "assistive_prompt": {
34 + "user_timezone": "America/New_York",
35 + }
36 + },
37 +)
38 +
39 +# Access the generated assistive prompt
40 +if session.experimental:
41 + print(session.experimental.assistive_prompt)
42 +```
43 +
44 +```typescript title="TypeScript SDK"
45 +import { Composio } from "@composio/core";
46 +
47 +const composio = new Composio();
48 +
49 +const session = await composio.toolRouter.create("user_123", {
50 + toolkits: ["github"],
51 + experimental: {
52 + assistivePrompt: {
53 + userTimezone: "America/New_York",
54 + },
55 + },
56 +});
57 +
58 +// Access the generated assistive prompt
59 +if (session.experimental) {
60 + console.log(session.experimental.assistivePrompt);
61 +}
62 +```
63 +</CodeBlocks>
64 +
65 +<Note>
66 +The `experimental` field is only available on sessions created with `create()`. Sessions retrieved with `use()` do not include the experimental data.
67 +</Note>
68 +
69 +### Toolkit Endpoint Method
70 +
71 +The toolkit retrieve response now includes `getCurrentUserEndpointMethod` (TypeScript) / `get_current_user_endpoint_method` (Python) to indicate the HTTP method for the current user endpoint.
72 +
73 +## Breaking Changes
74 +
75 +### Trigger Pagination: `page` Replaced with `cursor`
76 +
77 +The `page` parameter in `listActive` / `list_active` for trigger instances has been replaced with `cursor` for cursor-based pagination. There was a bug in earlier APIs which caused `page` param to be ignored, going ahead for pagination please use `cursor` instead.
78 +
79 +<CodeBlocks>
80 +```python title="Python SDK"
81 +# Before (deprecated)
82 +triggers = composio.triggers.list_active(page=1, limit=10)
83 +
84 +# After
85 +triggers = composio.triggers.list_active(cursor="cursor_string", limit=10)
86 +# Use response.next_cursor for the next page
87 +```
88 +
89 +```typescript title="TypeScript SDK"
90 +// Before (deprecated)
91 +const triggers = await composio.triggers.listActive({ page: 1, limit: 10 });
92 +
93 +// After
94 +const triggers = await composio.triggers.listActive({ cursor: "cursor_string", limit: 10 });
95 +// Use response.nextCursor for the next page
96 +```
97 +</CodeBlocks>
98 +
99 +## Impact Summary
100 +
101 +| Change | Runtime Breaking | TypeScript Breaking | Migration Required |
102 +|--------|------------------|---------------------|-------------------|
103 +| Experimental assistive prompts | No | No | No |
104 +| `getCurrentUserEndpointMethod` field | No | No | No |
105 +| `page` → `cursor` in triggers | Yes | Yes | Yes (if using `page`) |
106 +
107 +## Migration Guide
108 +
109 +If you are using the `page` parameter in `listActive` / `list_active`:
110 +
111 +1. Replace `page` with `cursor`
112 +2. For the first request, omit the `cursor` parameter or pass `undefined`/`None`
113 +3. Use the `nextCursor` / `next_cursor` from the response for subsequent requests
fern/pyproject.toml
+1 -1
@@ -10,7 +10,7 @@ dependencies = [
10 "click>=8.1.7",
11 "ruamel-yaml>=0.18.10",
12 "typing-extensions>=4.13.0",
13 - "composio-client==1.26.0",
13 + "composio-client==1.27.0",
14 "openai>=1.79.0",
15 "composio==1.0.0rc5",
16 # Dependencies for SDK doc generation
pnpm-lock.yaml
+23 -59
@@ -16,8 +16,8 @@ catalogs:
16 specifier: ^4.20250917.0
17 version: 4.20250917.0
18 '@composio/client':
19 - specifier: 0.1.0-alpha.55
20 - version: 0.1.0-alpha.55
19 + specifier: 0.1.0-alpha.56
20 + version: 0.1.0-alpha.56
21 '@modelcontextprotocol/sdk':
22 specifier: ^1.25.2
23 version: 1.25.2
@@ -570,16 +570,16 @@ importers:
570 version: link:../../packages/providers/llamaindex
571 '@llamaindex/openai':
572 specifier: ^0.4.20
573 - version: 0.4.20(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(ws@8.18.2)(zod@3.25.76)
573 + version: 0.4.20(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(ws@8.18.2)(zod@4.3.5)
574 '@llamaindex/workflow':
575 specifier: ^1.1.24
576 - version: 1.1.24(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@3.25.76))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(zod@3.25.76)
576 + version: 1.1.24(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(zod@4.3.5)
577 dotenv:
578 specifier: ^16.4.1
579 version: 16.6.1
580 llamaindex:
581 specifier: ^0.12.0
582 - version: 0.12.0(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@3.25.76))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(tree-sitter@0.22.4)(web-tree-sitter@0.24.7)(zod@3.25.76)
582 + version: 0.12.0(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(tree-sitter@0.22.4)(web-tree-sitter@0.24.7)(zod@4.3.5)
583 devDependencies:
584 '@types/bun':
585 specifier: ^1.2.9
@@ -909,7 +909,7 @@ importers:
909 version: 1.0.0-alpha.1
910 '@composio/client':
911 specifier: 'catalog:'
912 - version: 0.1.0-alpha.55
912 + version: 0.1.0-alpha.56
913 '@composio/core':
914 specifier: workspace:*
915 version: link:../core
@@ -1003,7 +1003,7 @@ importers:
1003 dependencies:
1004 '@composio/client':
1005 specifier: 'catalog:'
1006 - version: 0.1.0-alpha.55
1006 + version: 0.1.0-alpha.56
1007 '@composio/json-schema-to-zod':
1008 specifier: workspace:*
1009 version: link:../json-schema-to-zod
@@ -1205,7 +1205,7 @@ importers:
1205 dependencies:
1206 llamaindex:
1207 specifier: ^0.12.0
1208 - version: 0.12.0(tree-sitter@0.22.4)(web-tree-sitter@0.24.7)(zod@4.3.5)
1208 + version: 0.12.0(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(tree-sitter@0.22.4)(web-tree-sitter@0.24.7)(zod@4.3.5)
1209 devDependencies:
1210 '@composio/core':
1211 specifier: workspace:*
@@ -1747,8 +1747,8 @@ packages:
1747 resolution: {integrity: sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==}
1748 engines: {node: '>=0.1.90'}
1749
1750 - '@composio/client@0.1.0-alpha.55':
1751 - resolution: {integrity: sha512-nINJ2bgqZi+eyNSPSd1p9hc7CryXqYonlhJqaw6U9gUeLYBq27ASpIM3ddi61j+6U6+ZKeaX1FmO3hcJwH4wCw==}
1750 + '@composio/client@0.1.0-alpha.56':
1751 + resolution: {integrity: sha512-hNgChB5uhdvT4QXNzzfUuvtG6vrfanQQFY2hPyKwbeR4x6mEmIGFiZ4y2qynErdUWldAZiB/7pY/MBMg6Q9E0g==}
1752
1753 '@composio/mcp@1.0.3-0':
1754 resolution: {integrity: sha512-IpbfST0SSs/CEv+PIf6+EL0feNuJhQyUrOHJLPge8NhyLLrCyVqvujRIPyRUUjy0NDsked/Mm5VpJmYM6OACbg==}
@@ -8456,7 +8456,7 @@ snapshots:
8456 '@colors/colors@1.5.0':
8457 optional: true
8458
8459 - '@composio/client@0.1.0-alpha.55': {}
8459 + '@composio/client@0.1.0-alpha.56': {}
8460
8461 '@composio/mcp@1.0.3-0': {}
8462
@@ -9435,15 +9435,6 @@ snapshots:
9435 tree-sitter: 0.22.4
9436 web-tree-sitter: 0.24.7
9437
9438 - '@llamaindex/openai@0.4.20(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(ws@8.18.2)(zod@3.25.76)':
9439 - dependencies:
9440 - '@llamaindex/core': 0.6.22
9441 - '@llamaindex/env': 0.1.30
9442 - openai: 5.20.3(ws@8.18.2)(zod@3.25.76)
9443 - transitivePeerDependencies:
9444 - - ws
9445 - - zod
9446 -
9438 '@llamaindex/openai@0.4.20(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(ws@8.18.2)(zod@4.3.5)':
9439 dependencies:
9440 '@llamaindex/core': 0.6.22
@@ -9453,27 +9444,27 @@ snapshots:
9444 - ws
9445 - zod
9446
9456 - '@llamaindex/workflow-core@1.3.3(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@3.25.76))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(zod@3.25.76)':
9447 + '@llamaindex/workflow-core@1.3.3(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@18.3.1))(react@18.3.1))(rxjs@7.8.2)(zod@4.3.5)':
9448 optionalDependencies:
9458 - '@modelcontextprotocol/sdk': 1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@3.25.76)
9449 + '@modelcontextprotocol/sdk': 1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5)
9450 hono: 4.11.4
9460 - next: 15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)
9451 + next: 15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@18.3.1))(react@18.3.1)
9452 rxjs: 7.8.2
9462 - zod: 3.25.76
9453 + zod: 4.3.5
9454
9464 - '@llamaindex/workflow-core@1.3.3(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@18.3.1))(react@18.3.1))(rxjs@7.8.2)(zod@4.3.5)':
9455 + '@llamaindex/workflow-core@1.3.3(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(zod@4.3.5)':
9456 optionalDependencies:
9457 '@modelcontextprotocol/sdk': 1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5)
9458 hono: 4.11.4
9468 - next: 15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@18.3.1))(react@18.3.1)
9459 + next: 15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)
9460 rxjs: 7.8.2
9461 zod: 4.3.5
9462
9472 - '@llamaindex/workflow@1.1.24(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@3.25.76))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(zod@3.25.76)':
9463 + '@llamaindex/workflow@1.1.24(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@18.3.1))(react@18.3.1))(rxjs@7.8.2)(zod@4.3.5)':
9464 dependencies:
9465 '@llamaindex/core': 0.6.22
9466 '@llamaindex/env': 0.1.30
9476 - '@llamaindex/workflow-core': 1.3.3(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@3.25.76))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(zod@3.25.76)
9467 + '@llamaindex/workflow-core': 1.3.3(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@18.3.1))(react@18.3.1))(rxjs@7.8.2)(zod@4.3.5)
9468 transitivePeerDependencies:
9469 - '@modelcontextprotocol/sdk'
9470 - hono
@@ -9482,11 +9473,11 @@ snapshots:
9473 - rxjs
9474 - zod
9475
9485 - '@llamaindex/workflow@1.1.24(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@18.3.1))(react@18.3.1))(rxjs@7.8.2)(zod@4.3.5)':
9476 + '@llamaindex/workflow@1.1.24(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(zod@4.3.5)':
9477 dependencies:
9478 '@llamaindex/core': 0.6.22
9479 '@llamaindex/env': 0.1.30
9489 - '@llamaindex/workflow-core': 1.3.3(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@18.3.1))(react@18.3.1))(rxjs@7.8.2)(zod@4.3.5)
9480 + '@llamaindex/workflow-core': 1.3.3(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(zod@4.3.5)
9481 transitivePeerDependencies:
9482 - '@modelcontextprotocol/sdk'
9483 - hono
@@ -13239,34 +13230,12 @@ snapshots:
13230 rfdc: 1.4.1
13231 wrap-ansi: 9.0.0
13232
13242 - llamaindex@0.12.0(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@3.25.76))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(tree-sitter@0.22.4)(web-tree-sitter@0.24.7)(zod@3.25.76):
13243 - dependencies:
13244 - '@llamaindex/core': 0.6.22
13245 - '@llamaindex/env': 0.1.30
13246 - '@llamaindex/node-parser': 2.0.22(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(tree-sitter@0.22.4)(web-tree-sitter@0.24.7)
13247 - '@llamaindex/workflow': 1.1.24(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@3.25.76))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(zod@3.25.76)
13248 - '@types/lodash': 4.17.20
13249 - '@types/node': 24.6.2
13250 - lodash: 4.17.21
13251 - magic-bytes.js: 1.12.1
13252 - transitivePeerDependencies:
13253 - - '@huggingface/transformers'
13254 - - '@modelcontextprotocol/sdk'
13255 - - gpt-tokenizer
13256 - - hono
13257 - - next
13258 - - p-retry
13259 - - rxjs
13260 - - tree-sitter
13261 - - web-tree-sitter
13262 - - zod
13263 -
13264 - llamaindex@0.12.0(tree-sitter@0.22.4)(web-tree-sitter@0.24.7)(zod@4.3.5):
13233 + llamaindex@0.12.0(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(tree-sitter@0.22.4)(web-tree-sitter@0.24.7)(zod@4.3.5):
13234 dependencies:
13235 '@llamaindex/core': 0.6.22
13236 '@llamaindex/env': 0.1.30
13237 '@llamaindex/node-parser': 2.0.22(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(tree-sitter@0.22.4)(web-tree-sitter@0.24.7)
13269 - '@llamaindex/workflow': 1.1.24(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@18.3.1))(react@18.3.1))(rxjs@7.8.2)(zod@4.3.5)
13238 + '@llamaindex/workflow': 1.1.24(@llamaindex/core@0.6.22)(@llamaindex/env@0.1.30)(@modelcontextprotocol/sdk@1.25.2(@cfworker/json-schema@4.1.1)(hono@4.11.4)(zod@4.3.5))(hono@4.11.4)(next@15.5.9(@opentelemetry/api@1.9.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(rxjs@7.8.2)(zod@4.3.5)
13239 '@types/lodash': 4.17.20
13240 '@types/node': 24.6.2
13241 lodash: 4.17.21
@@ -13639,11 +13608,6 @@ snapshots:
13608 transitivePeerDependencies:
13609 - encoding
13610
13642 - openai@5.20.3(ws@8.18.2)(zod@3.25.76):
13643 - optionalDependencies:
13644 - ws: 8.18.2
13645 - zod: 3.25.76
13646 -
13611 openai@5.20.3(ws@8.18.2)(zod@4.3.5):
13612 optionalDependencies:
13613 ws: 8.18.2
pnpm-workspace.yaml
+1 -1
@@ -18,7 +18,7 @@ catalog:
18 '@arethetypeswrong/cli': ^0.18.2
19 '@cloudflare/vitest-pool-workers': ^0.9.2
20 '@cloudflare/workers-types': ^4.20250917.0
21 - '@composio/client': 0.1.0-alpha.55
21 + '@composio/client': 0.1.0-alpha.56
22 '@modelcontextprotocol/sdk': ^1.25.2
23 ai: ^6.0.27
24 hono: ^4.11.4
python/composio/core/models/tool_router.py
+73
@@ -173,6 +173,29 @@ class ToolRouterManageConnectionsConfig(te.TypedDict, total=False):
173 wait_for_connections: bool
174
175
176 +class ToolRouterAssistivePromptConfig(te.TypedDict, total=False):
177 + """Configuration for assistive prompt generation.
178 +
179 + Attributes:
180 + user_timezone: IANA timezone identifier (e.g., "America/New_York", "Europe/London")
181 + for timezone-aware assistive prompts.
182 + """
183 +
184 + user_timezone: str
185 +
186 +
187 +class ToolRouterExperimentalConfig(te.TypedDict, total=False):
188 + """Experimental configuration for tool router session.
189 +
190 + Note: These features are experimental and may be modified or removed in future versions.
191 +
192 + Attributes:
193 + assistive_prompt: Configuration for assistive prompt generation.
194 + """
195 +
196 + assistive_prompt: ToolRouterAssistivePromptConfig
197 +
198 +
199 @dataclass
200 class ToolkitConnectionAuthConfig:
201 """Auth config information for a toolkit connection.
@@ -272,6 +295,19 @@ class ToolRouterMCPServerConfig:
295 headers: t.Optional[t.Dict[str, t.Optional[str]]] = None
296
297
298 +@dataclass
299 +class ToolRouterSessionExperimental:
300 + """Experimental features in session response.
301 +
302 + Note: These features are experimental and may be modified or removed in future versions.
303 +
304 + Attributes:
305 + assistive_prompt: The generated assistive system prompt based on the experimental config.
306 + """
307 +
308 + assistive_prompt: t.Optional[str] = None
309 +
310 +
311 @dataclass
312 class ToolRouterSession(t.Generic[TProvider]):
313 """
@@ -283,6 +319,7 @@ class ToolRouterSession(t.Generic[TProvider]):
319 tools: Function to get provider-wrapped tools
320 authorize: Function to authorize a toolkit
321 toolkits: Function to get toolkit connection states
322 + experimental: Optional experimental features data from the session response
323 """
324
325 session_id: str
@@ -290,6 +327,7 @@ class ToolRouterSession(t.Generic[TProvider]):
327 tools: ToolsFn
328 authorize: AuthorizeFn
329 toolkits: ToolkitsFn
330 + experimental: t.Optional[ToolRouterSessionExperimental] = None
331
332
333 class ToolRouter(Resource, t.Generic[TProvider]):
@@ -736,6 +774,7 @@ class ToolRouter(Resource, t.Generic[TProvider]):
774 auth_configs: t.Optional[t.Dict[str, str]] = None,
775 connected_accounts: t.Optional[t.Dict[str, str]] = None,
776 workbench: t.Optional[ToolRouterWorkbenchConfig] = None,
777 + experimental: t.Optional[ToolRouterExperimentalConfig] = None,
778 ) -> ToolRouterSession[TProvider]:
779 """
780 Create a new tool router session for a user.
@@ -798,6 +837,13 @@ class ToolRouter(Resource, t.Generic[TProvider]):
837 - 'auto_offload_threshold' (int): Maximum execution payload size to
838 offload to workbench.
839 Example: {'enable_proxy_execution': False, 'auto_offload_threshold': 300}
840 + :param experimental: Optional experimental configuration (ToolRouterExperimentalConfig).
841 + Note: These features are experimental and may change.
842 + Dict with:
843 + - 'assistive_prompt' (dict): Configuration for assistive prompt generation.
844 + - 'user_timezone' (str): IANA timezone identifier
845 + (e.g., "America/New_York", "Europe/London").
846 + Example: {'assistive_prompt': {'user_timezone': 'America/New_York'}}
847 :return: Tool router session object
848
849 Example:
@@ -986,9 +1032,32 @@ class ToolRouter(Resource, t.Generic[TProvider]):
1032 if execution_payload:
1033 create_params["workbench"] = execution_payload
1034
1035 + # Build experimental config
1036 + # Map SDK's experimental.assistive_prompt.user_timezone to API's
1037 + # experimental.assistive_prompt_config.user_timezone
1038 + if experimental is not None:
1039 + assistive_prompt_config = experimental.get("assistive_prompt")
1040 + if assistive_prompt_config is not None:
1041 + user_timezone = assistive_prompt_config.get("user_timezone")
1042 + # Only include if user_timezone is a non-empty string
1043 + if user_timezone:
1044 + create_params["experimental"] = {
1045 + "assistive_prompt_config": {
1046 + "user_timezone": user_timezone,
1047 + }
1048 + }
1049 +
1050 # Make API call to create session
1051 session = self._client.tool_router.session.create(**create_params)
1052
1053 + # Transform experimental response:
1054 + # API's assistive_prompt -> SDK's assistive_prompt
1055 + experimental_response: t.Optional[ToolRouterSessionExperimental] = None
1056 + if session.experimental is not None:
1057 + experimental_response = ToolRouterSessionExperimental(
1058 + assistive_prompt=session.experimental.assistive_prompt,
1059 + )
1060 +
1061 # Create and return the session
1062 return ToolRouterSession(
1063 session_id=session.session_id,
@@ -999,6 +1068,7 @@ class ToolRouter(Resource, t.Generic[TProvider]):
1068 tools=self._create_tools_fn(session.session_id),
1069 authorize=self._create_authorize_fn(session.session_id),
1070 toolkits=self._create_toolkits_fn(session.session_id),
1071 + experimental=experimental_response,
1072 )
1073
1074 def use(self, session_id: str) -> ToolRouterSession[TProvider]:
@@ -1043,6 +1113,7 @@ class ToolRouter(Resource, t.Generic[TProvider]):
1113 __all__ = [
1114 "ToolRouter",
1115 "ToolRouterSession",
1116 + "ToolRouterSessionExperimental",
1117 "ToolRouterToolkitsEnableConfig",
1118 "ToolRouterToolkitsDisableConfig",
1119 "ToolRouterToolsEnableConfig",
@@ -1054,6 +1125,8 @@ __all__ = [
1125 "ToolRouterConfigTags",
1126 "ToolRouterManageConnectionsConfig",
1127 "ToolRouterWorkbenchConfig",
1128 + "ToolRouterExperimentalConfig",
1129 + "ToolRouterAssistivePromptConfig",
1130 "ToolkitConnectionState",
1131 "ToolkitConnectionsDetails",
1132 "ToolRouterMCPServerConfig",
python/composio/core/models/triggers.py
+3 -3
@@ -739,7 +739,7 @@ class Triggers(Resource):
739 connected_account_ids: t.Optional[list[str]] = None,
740 show_disabled: t.Optional[bool] = None,
741 limit: t.Optional[int] = None,
742 - page: t.Optional[int] = None,
742 + cursor: t.Optional[str] = None,
743 ):
744 """
745 List all active triggers
@@ -750,7 +750,7 @@ class Triggers(Resource):
750 :param connected_account_ids: List of connected account IDs to filter by
751 :param show_disabled: Whether to show disabled triggers
752 :param limit: Limit the number of triggers to return
753 - :param page: Page number to return
753 + :param cursor: Cursor for pagination. Use the nextCursor from the response to get the next page.
754 :return: List of active triggers
755 """
756 return self._client.trigger_instances.list_active(
@@ -760,7 +760,7 @@ class Triggers(Resource):
760 query_connected_account_ids_1=connected_account_ids,
761 query_show_disabled_1=show_disabled,
762 limit=limit if limit is not None else omit,
763 - page=page if page is not None else omit,
763 + cursor=cursor if cursor is not None else omit,
764 )
765
766 def list(
python/providers/anthropic/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-anthropic"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get an array of tools with your Anthropic LLMs."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
python/providers/anthropic/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_anthropic",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Anthropic LLMs.",
python/providers/autogen/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-autogen"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get an array of tools with your autogen agent."
5 readme = "README.md"
6 requires-python = ">=3.9,<4"
python/providers/autogen/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_autogen",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Autogen agent.",
python/providers/claude_agent_sdk/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-claude-agent-sdk"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get an array of tools with Claude Code Agents SDK."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
python/providers/claude_agent_sdk/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
8
9 setup(
10 name="composio_claude_agent_sdk",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get array of tools for Claude Agent SDK",
python/providers/crewai/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-crewai"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get an array of tools with your CrewAI agent."
5 readme = "README.md"
6 requires-python = ">=3.9,<4"
python/providers/crewai/setup.py
+1 -1
@@ -6,7 +6,7 @@ from setuptools import setup
6
7 setup(
8 name="composio_crewai",
9 - version="0.10.9",
9 + version="0.10.10",
10 author="Composio",
11 author_email="tech@composio.dev",
12 description="Use Composio to get an array of tools with your CrewAI agent.",
python/providers/gemini/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-gemini"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get an array of tools with your Gemini agent."
5 readme = "README.md"
6 requires-python = ">=3.9,<4"
python/providers/gemini/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_gemini",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Gemini agent.",
python/providers/google/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-google"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
5 readme = "README.md"
6 requires-python = ">=3.9,<4"
python/providers/google/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_google",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
python/providers/google_adk/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-google-adk"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
5 readme = "README.md"
6 requires-python = ">=3.9,<4"
python/providers/google_adk/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_google_adk",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
python/providers/langchain/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-langchain"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get an array of tools with your Langchain agent."
5 readme = "README.md"
6 requires-python = ">=3.9,<4"
python/providers/langchain/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_langchain",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Langchain agent.",
python/providers/langgraph/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-langgraph"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get array of tools with LangGraph Agent Workflows."
5 readme = "README.md"
6 requires-python = ">=3.9,<4"
python/providers/langgraph/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_langgraph",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get array of tools with LangGraph Agent Workflows",
python/providers/llamaindex/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-llamaindex"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."
5 readme = "README.md"
6 requires-python = ">=3.9,<4"
python/providers/llamaindex/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_llamaindex",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get array of tools with LlamaIndex Agent Workflows",
python/providers/openai/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-openai"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get an array of tools with your OpenAI Function Call."
5 readme = "README.md"
6 requires-python = ">=3.9,<4"
python/providers/openai/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_openai",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your OpenAI Function Call.",
python/providers/openai_agents/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-openai-agents"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "Use Composio to get array of strongly typed tools for OpenAI Agents"
5 readme = "README.md"
6 requires-python = ">=3.9,<4"
python/providers/openai_agents/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
8
9 setup(
10 name="composio_openai_agents",
11 - version="0.10.9",
11 + version="0.10.10",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get array of strongly typed tools for OpenAI Agents",
python/pyproject.toml
+2 -2
@@ -1,13 +1,13 @@
1 [project]
2 name = "composio"
3 -version = "0.10.9"
3 +version = "0.10.10"
4 description = "SDK for integrating Composio with your applications."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
7 dependencies = [
8 "pysher>=1.0.8",
9 "pydantic>=2.6.4",
10 - "composio-client==1.26.0",
10 + "composio-client==1.27.0",
11 "typing-extensions>=4.0.0",
12 "openai",
13 ]
python/tests/test_tool_router.py
+150
@@ -10,6 +10,8 @@ from composio.core.models.tool_router import (
10 ToolRouterToolkitsEnableConfig,
11 ToolRouterToolkitsDisableConfig,
12 ToolRouterManageConnectionsConfig,
13 + ToolRouterExperimentalConfig,
14 + ToolRouterSessionExperimental,
15 ToolkitConnectionState,
16 ToolkitConnectionsDetails,
17 ToolRouterMCPServerType,
@@ -35,6 +37,7 @@ def mock_client():
37 ]
38 mock_session_response.config = MagicMock()
39 mock_session_response.config.user_id = "user_123"
40 + mock_session_response.experimental = None # Default to None
41
42 client.tool_router.session.create.return_value = mock_session_response
43 client.tool_router.session.retrieve.return_value = mock_session_response
@@ -541,6 +544,132 @@ class TestToolRouter:
544 assert "connected_accounts" in kwargs
545 assert "workbench" in kwargs
546
547 + def test_create_session_with_experimental_config(self, tool_router, mock_client):
548 + """Test creating a session with experimental configuration."""
549 + session = tool_router.create(
550 + user_id="user_123",
551 + experimental={
552 + "assistive_prompt": {
553 + "user_timezone": "America/New_York",
554 + }
555 + },
556 + )
557 +
558 + assert session.session_id == "session_123"
559 +
560 + # Verify the API was called with experimental config transformed correctly
561 + call_args = mock_client.tool_router.session.create.call_args
562 + kwargs = call_args.kwargs
563 + assert "experimental" in kwargs
564 + assert kwargs["experimental"] == {
565 + "assistive_prompt_config": {
566 + "user_timezone": "America/New_York",
567 + }
568 + }
569 +
570 + def test_create_session_with_experimental_empty_config(
571 + self, tool_router, mock_client
572 + ):
573 + """Test creating a session with empty experimental configuration."""
574 + session = tool_router.create(
575 + user_id="user_123",
576 + experimental={},
577 + )
578 +
579 + assert session.session_id == "session_123"
580 +
581 + # Verify experimental is not included when empty
582 + call_args = mock_client.tool_router.session.create.call_args
583 + kwargs = call_args.kwargs
584 + assert "experimental" not in kwargs
585 +
586 + def test_create_session_with_experimental_no_timezone(
587 + self, tool_router, mock_client
588 + ):
589 + """Test creating a session with experimental config but no timezone."""
590 + session = tool_router.create(
591 + user_id="user_123",
592 + experimental={
593 + "assistive_prompt": {},
594 + },
595 + )
596 +
597 + assert session.session_id == "session_123"
598 +
599 + # Verify experimental is not included when timezone is not set
600 + call_args = mock_client.tool_router.session.create.call_args
601 + kwargs = call_args.kwargs
602 + assert "experimental" not in kwargs
603 +
604 + def test_create_session_with_experimental_empty_string_timezone(
605 + self, tool_router, mock_client
606 + ):
607 + """Test creating a session with empty string timezone is excluded.
608 +
609 + This ensures consistency with TypeScript SDK which uses truthy check.
610 + """
611 + session = tool_router.create(
612 + user_id="user_123",
613 + experimental={
614 + "assistive_prompt": {
615 + "user_timezone": "", # Empty string should be excluded
616 + },
617 + },
618 + )
619 +
620 + assert session.session_id == "session_123"
621 +
622 + # Verify experimental is not included when timezone is empty string
623 + call_args = mock_client.tool_router.session.create.call_args
624 + kwargs = call_args.kwargs
625 + assert "experimental" not in kwargs
626 +
627 + def test_create_session_experimental_response_transformation(
628 + self, tool_router, mock_client
629 + ):
630 + """Test that experimental response is transformed correctly."""
631 + # Setup mock response with experimental
632 + mock_response_with_experimental = MagicMock()
633 + mock_response_with_experimental.session_id = "session_exp"
634 + mock_response_with_experimental.mcp = MagicMock()
635 + mock_response_with_experimental.mcp.type = "http"
636 + mock_response_with_experimental.mcp.url = "https://mcp.example.com/session_exp"
637 + mock_response_with_experimental.tool_router_tools = ["TOOL_1"]
638 + mock_response_with_experimental.experimental = MagicMock()
639 + mock_response_with_experimental.experimental.assistive_prompt = (
640 + "You are a helpful assistant working in the America/New_York timezone."
641 + )
642 +
643 + mock_client.tool_router.session.create.return_value = (
644 + mock_response_with_experimental
645 + )
646 +
647 + session = tool_router.create(
648 + user_id="user_123",
649 + experimental={
650 + "assistive_prompt": {
651 + "user_timezone": "America/New_York",
652 + }
653 + },
654 + )
655 +
656 + # Verify experimental response is transformed correctly
657 + assert session.experimental is not None
658 + assert isinstance(session.experimental, ToolRouterSessionExperimental)
659 + assert (
660 + session.experimental.assistive_prompt
661 + == "You are a helpful assistant working in the America/New_York timezone."
662 + )
663 +
664 + def test_create_session_without_experimental_response(
665 + self, tool_router, mock_client
666 + ):
667 + """Test that session without experimental response has None."""
668 + session = tool_router.create(user_id="user_123")
669 +
670 + # Verify experimental is None when not in response
671 + assert session.experimental is None
672 +
673 def test_create_session_raises_error_without_provider(self, mock_client):
674 """Test that creating a session without provider raises an error when calling tools()."""
675 tool_router = ToolRouter(client=mock_client, provider=None)
@@ -943,6 +1072,27 @@ class TestToolRouterTypes:
1072 assert config["enable"] is True
1073 assert config["callback_url"] == "https://example.com/callback"
1074
1075 + def test_experimental_config_type(self):
1076 + """Test ToolRouterExperimentalConfig type."""
1077 + config: ToolRouterExperimentalConfig = {
1078 + "assistive_prompt": {
1079 + "user_timezone": "America/New_York",
1080 + }
1081 + }
1082 + assert "assistive_prompt" in config
1083 + assert config["assistive_prompt"]["user_timezone"] == "America/New_York"
1084 +
1085 + def test_session_experimental_dataclass(self):
1086 + """Test ToolRouterSessionExperimental dataclass."""
1087 + experimental = ToolRouterSessionExperimental(
1088 + assistive_prompt="You are a helpful assistant."
1089 + )
1090 + assert experimental.assistive_prompt == "You are a helpful assistant."
1091 +
1092 + # Test with None
1093 + experimental_none = ToolRouterSessionExperimental()
1094 + assert experimental_none.assistive_prompt is None
1095 +
1096 def test_mcp_server_config(self):
1097 """Test ToolRouterMCPServerConfig dataclass."""
1098 mcp = ToolRouterMCPServerConfig(
python/tests/test_triggers.py
+2 -2
@@ -142,7 +142,7 @@ class TestTriggers:
142 connected_account_ids=["conn-123"],
143 show_disabled=False,
144 limit=10,
145 - page=1,
145 + cursor="cursor-abc",
146 )
147
148 mock_client.trigger_instances.list_active.assert_called_once()
@@ -153,7 +153,7 @@ class TestTriggers:
153 assert call_kwargs["query_connected_account_ids_1"] == ["conn-123"]
154 assert call_kwargs["query_show_disabled_1"] is False
155 assert call_kwargs["limit"] == 10
156 - assert call_kwargs["page"] == 1
156 + assert call_kwargs["cursor"] == "cursor-abc"
157 assert result == mock_trigger_instances
158
159 def test_list_trigger_types_without_filters(self, triggers, mock_client):
ts/docs/api/tool-router.md
+30
@@ -241,6 +241,28 @@ const session = await composio.create('user_123', {
241 });
242 ```
243
244 +### `experimental`
245 +
246 +Configure experimental features for the session. These features are not stable and may be modified or removed in future versions.
247 +
248 +```typescript
249 +const session = await composio.create('user_123', {
250 + toolkits: ['gmail'],
251 + experimental: {
252 + assistivePrompt: {
253 + userTimezone: 'America/New_York' // IANA timezone identifier for timezone-aware assistive prompts
254 + }
255 + }
256 +});
257 +
258 +// Access the generated assistive prompt from the session response
259 +if (session.experimental?.assistivePrompt) {
260 + console.log('Assistive prompt:', session.experimental.assistivePrompt);
261 +}
262 +```
263 +
264 +The `userTimezone` field accepts an IANA timezone identifier (e.g., 'America/New_York', 'Europe/London') which is used to generate a timezone-aware system prompt for optimal tool router usage.
265 +
266 ## Session Properties
267
268 A Tool Router session provides the following properties and methods:
@@ -753,6 +775,11 @@ interface ToolRouterCreateSessionConfig {
775 enableProxyExecution?: boolean;
776 autoOffloadThreshold?: number;
777 };
778 + experimental?: {
779 + assistivePrompt?: {
780 + userTimezone?: string; // IANA timezone identifier for timezone-aware assistive prompts
781 + };
782 + };
783 }
784 ```
785
@@ -773,6 +800,9 @@ interface ToolRouterSession {
800 nextCursor?: string; // Pagination cursor
801 limit?: number; // Number of items per page
802 }) => Promise<ToolkitConnectionsDetails>;
803 + experimental?: {
804 + assistivePrompt?: string; // Generated system prompt for optimal tool router usage
805 + };
806 }
807 ```
808
ts/docs/api/toolkits.md
+3
@@ -252,6 +252,9 @@ interface ToolkitRetrieveResponse {
252 baseUrl: string; // Base URL for proxied requests
253 };
254 }[];
255 + baseUrl?: string; // Base URL for the toolkit API
256 + getCurrentUserEndpoint?: string; // Endpoint to get the current user
257 + getCurrentUserEndpointMethod?: string; // HTTP method for get current user endpoint (e.g., GET, POST)
258 }
259 ```
260
ts/docs/api/triggers.md
+1 -1
@@ -24,7 +24,7 @@ const triggers = await composio.triggers.listActive({
24 authConfigIds: ['auth-config-id'],
25 connectedAccountIds: ['connected-account-id'],
26 limit: 10,
27 - page: 1,
27 + cursor: 'cursor-string', // Use cursor for pagination
28 showDisabled: false,
29 triggerIds: ['trigger-id'],
30 triggerNames: ['trigger-name'],
ts/examples/triggers/src/test.ts new
+17
@@ -0,0 +1,17 @@
1 +import { Composio } from '@composio/core';
2 +
3 +const composio = new Composio({
4 + apiKey: process.env.COMPOSIO_API_KEY,
5 +});
6 +
7 +const session = await composio.create('userId', {
8 + experimental: {
9 + assistivePrompt: {
10 + userTimezone: 'America/New_York',
11 + }
12 + }
13 +})
14 +
15 +const prompt = session.experimental?.assistivePrompt;
16 +
17 +console.log({ prompt })
\ No newline at end of file
ts/packages/core/src/composio.ts
+2
@@ -340,6 +340,8 @@ export class Composio<
340 * The new instance inherits all configuration from the parent instance (apiKey, baseURL, provider, etc.)
341 * but allows you to specify custom request options that will be used for all API calls made through this session.
342 *
343 + * @deprecated DEPRECATED: This method will be removed in a future version of the SDK.
344 + *
345 * @param {MergedRequestInit} fetchOptions - Custom request options to be used for all API calls in this session.
346 * This follows the Fetch API RequestInit interface with additional options.
347 * @returns {Composio<TProvider>} A new Composio instance with the custom request options applied.
ts/packages/core/src/models/ToolRouter.ts
+20 -1
@@ -26,6 +26,7 @@ import {
26 ToolRouterToolkitsFn,
27 ToolRouterCreateSessionConfig,
28 ToolRouterSession,
29 + ToolRouterSessionExperimental,
30 ToolkitConnectionStateSchema,
31 ToolRouterToolkitsOptions,
32 ToolRouterToolkitsOptionsSchema,
@@ -264,16 +265,32 @@ export class ToolRouter<
265 routerConfig.manageConnections
266 ),
267 workbench: transformToolRouterWorkbenchParams(routerConfig.workbench),
268 + // Map SDK's experimental.assistivePrompt.userTimezone to API's experimental.assistive_prompt_config.user_timezone
269 + experimental: routerConfig.experimental?.assistivePrompt?.userTimezone
270 + ? {
271 + assistive_prompt_config: {
272 + user_timezone: routerConfig.experimental.assistivePrompt.userTimezone,
273 + },
274 + }
275 + : undefined,
276 };
277
278 const session = await this.client.toolRouter.session.create(payload);
279
280 + // Transform experimental response: API's assistive_prompt -> SDK's assistivePrompt
281 + const experimental: ToolRouterSessionExperimental | undefined = session.experimental
282 + ? {
283 + assistivePrompt: session.experimental.assistive_prompt,
284 + }
285 + : undefined;
286 +
287 return {
288 sessionId: session.session_id,
289 mcp: this.createMCPServerConfig(session.mcp),
290 tools: this.createToolsFn(session.session_id),
291 authorize: this.createAuthorizeFn(session.session_id),
292 toolkits: this.createToolkitsFn(session.session_id),
293 + experimental,
294 };
295 }
296
@@ -294,7 +311,9 @@ export class ToolRouter<
311 * console.log(session.mcp.headers);
312 * ```
313 */
297 - async use(id: string): Promise<ToolRouterSession<TToolCollection, TTool, TProvider>> {
314 + async use(
315 + id: string
316 + ): Promise<Omit<ToolRouterSession<TToolCollection, TTool, TProvider>, 'experimental'>> {
317 const session = await this.client.toolRouter.session.retrieve(id);
318 return {
319 sessionId: session.session_id,
ts/packages/core/src/models/Triggers.ts
+2 -2
@@ -45,7 +45,7 @@ import {
45 transformTriggerTypeListResponse,
46 transformTriggerTypeRetrieveResponse,
47 } from '../utils/transformers/triggers';
48 -import { ToolkitVersion, ToolkitVersionParam } from '../types/tool.types';
48 +import { ToolkitVersionParam } from '../types/tool.types';
49 import { ComposioConfig } from '../composio';
50 import { BaseComposioProvider } from '../provider/BaseProvider';
51 /**
@@ -100,8 +100,8 @@ export class Triggers<TProvider extends BaseComposioProvider<unknown, unknown, u
100 ? {
101 auth_config_ids: parsedParams.data.authConfigIds,
102 connected_account_ids: parsedParams.data.connectedAccountIds,
103 + cursor: parsedParams.data.cursor,
104 limit: parsedParams.data.limit,
104 - page: parsedParams.data.page,
105 show_disabled: parsedParams.data.showDisabled,
106 trigger_ids: parsedParams.data.triggerIds,
107 trigger_names: parsedParams.data.triggerNames,
ts/packages/core/src/types/toolRouter.types.ts
+32
@@ -198,6 +198,22 @@ export const ToolRouterCreateSessionConfigSchema = z
198 })
199 .optional()
200 .describe('The execution config for the tool router session'),
201 + experimental: z
202 + .object({
203 + assistivePrompt: z
204 + .object({
205 + userTimezone: z
206 + .string()
207 + .optional()
208 + .describe(
209 + 'IANA timezone identifier (e.g., "America/New_York", "Europe/London") for timezone-aware assistive prompts'
210 + ),
211 + })
212 + .optional()
213 + .describe('Configuration for assistive prompt generation'),
214 + })
215 + .optional()
216 + .describe('Experimental features configuration - not stable, may be modified or removed'),
217 })
218 .partial()
219 .describe('The config for the tool router session');
@@ -289,6 +305,17 @@ export type ToolRouterToolkitsOptions = z.infer<typeof ToolRouterToolkitsOptions
305 export type ToolRouterToolkitsFn = (
306 options?: ToolRouterToolkitsOptions
307 ) => Promise<ToolkitConnectionsDetails>;
308 +/**
309 + * Experimental features response from session creation.
310 + * Only returned on session creation, not on GET.
311 + */
312 +export interface ToolRouterSessionExperimental {
313 + /**
314 + * The assistive system prompt to inject into your agent for optimal tool router usage.
315 + */
316 + assistivePrompt?: string;
317 +}
318 +
319 export interface ToolRouterSession<
320 TToolCollection,
321 TTool,
@@ -318,4 +345,9 @@ export interface ToolRouterSession<
345 * Supports pagination and filtering by toolkit slugs.
346 */
347 toolkits: ToolRouterToolkitsFn;
348 + /**
349 + * Experimental features including the generated system prompt.
350 + * Only returned on session creation, not on GET.
351 + */
352 + experimental?: ToolRouterSessionExperimental;
353 }
ts/packages/core/src/types/toolkit.types.ts
+1
@@ -96,6 +96,7 @@ export const ToolkitRetrieveResponseSchema = z.object({
96 authConfigDetails: z.array(ToolkitAuthConfigDetailsSchema).optional(),
97 baseUrl: z.string().optional(),
98 getCurrentUserEndpoint: z.string().optional(),
99 + getCurrentUserEndpointMethod: z.string().optional(),
100 });
101
102 export type ToolkitAuthField = z.infer<typeof ToolkitAuthFieldSchema>;
ts/packages/core/src/types/triggers.types.ts
+1 -1
@@ -22,7 +22,7 @@ export const TriggerInstanceListActiveParamsSchema = z.object({
22 authConfigIds: z.array(z.string()).nullable().optional(),
23 connectedAccountIds: z.array(z.string()).nullable().optional(),
24 limit: z.number().optional(),
25 - page: z.number().optional(),
25 + cursor: z.string().optional(),
26 showDisabled: z.boolean().nullable().optional(),
27 triggerIds: z.array(z.string()).nullable().optional(),
28 triggerNames: z.array(z.string()).nullable().optional(),
ts/packages/core/src/utils/fileUtils.ts
+18 -23
@@ -165,29 +165,24 @@ const uploadFileToS3 = async (
165 toolkit_slug: toolkitSlug,
166 });
167
168 - const { key, type } = response;
169 -
170 - if (type === 'new' || type === 'update') {
171 - logger.debug(`Uploading ${key} file to S3: ${key}`);
172 - const buffer = Buffer.from(content, 'base64');
173 - const signedURL =
174 - response.type === 'update' ? response.update_presigned_url : response.new_presigned_url;
175 -
176 - // Upload the file using the presigned URL
177 - const uploadResponse = await fetch(signedURL, {
178 - method: 'PUT',
179 - body: buffer,
180 - headers: {
181 - 'Content-Type': mimeType,
182 - 'Content-Length': buffer.length.toString(),
183 - },
184 - });
185 -
186 - if (!uploadResponse.ok) {
187 - throw new Error(`Failed to upload file to S3: ${uploadResponse.statusText}`);
188 - }
189 - } else {
190 - logger.debug(`File already exists in S3: ${key}`);
168 + const { key, new_presigned_url } = response;
169 +
170 + // Upload file using presigned URL
171 + // Note: API now always returns type: 'new' with new_presigned_url
172 + logger.debug(`Uploading ${key} file to S3: ${key}`);
173 + const buffer = Buffer.from(content, 'base64');
174 +
175 + const uploadResponse = await fetch(new_presigned_url, {
176 + method: 'PUT',
177 + body: buffer,
178 + headers: {
179 + 'Content-Type': mimeType,
180 + 'Content-Length': buffer.length.toString(),
181 + },
182 + });
183 +
184 + if (!uploadResponse.ok) {
185 + throw new Error(`Failed to upload file to S3: ${uploadResponse.statusText}`);
186 }
187
188 return key;
ts/packages/core/src/utils/transformers/toolkits.ts
+1
@@ -80,6 +80,7 @@ export const transformToolkitRetrieveResponse = (
80 })),
81 baseUrl: response.base_url,
82 getCurrentUserEndpoint: response.get_current_user_endpoint,
83 + getCurrentUserEndpointMethod: response.get_current_user_endpoint_method,
84 }));
85 };
86
ts/packages/core/test/models/toolRouter.test.ts
+143
@@ -1149,6 +1149,149 @@ describe('ToolRouter', () => {
1149 // });
1150 // });
1151
1152 + describe('experimental configuration', () => {
1153 + it('should create a session with experimental assistivePrompt userTimezone', async () => {
1154 + mockClient.toolRouter.session.create.mockResolvedValueOnce(mockSessionCreateResponse);
1155 +
1156 + const config: ToolRouterCreateSessionConfig = {
1157 + experimental: {
1158 + assistivePrompt: {
1159 + userTimezone: 'America/New_York',
1160 + },
1161 + },
1162 + };
1163 +
1164 + await toolRouter.create(userId, config);
1165 +
1166 + expect(mockClient.toolRouter.session.create).toHaveBeenCalledWith({
1167 + user_id: userId,
1168 + toolkits: undefined,
1169 + auth_configs: undefined,
1170 + connected_accounts: undefined,
1171 + tools: undefined,
1172 + tags: undefined,
1173 + manage_connections: createExpectedManageConnections(),
1174 + workbench: undefined,
1175 + experimental: {
1176 + assistive_prompt_config: {
1177 + user_timezone: 'America/New_York',
1178 + },
1179 + },
1180 + });
1181 + });
1182 +
1183 + it('should not include experimental in payload when assistivePrompt is not provided', async () => {
1184 + mockClient.toolRouter.session.create.mockResolvedValueOnce(mockSessionCreateResponse);
1185 +
1186 + const config: ToolRouterCreateSessionConfig = {
1187 + experimental: {},
1188 + };
1189 +
1190 + await toolRouter.create(userId, config);
1191 +
1192 + expect(mockClient.toolRouter.session.create).toHaveBeenCalledWith({
1193 + user_id: userId,
1194 + toolkits: undefined,
1195 + auth_configs: undefined,
1196 + connected_accounts: undefined,
1197 + tools: undefined,
1198 + tags: undefined,
1199 + manage_connections: createExpectedManageConnections(),
1200 + workbench: undefined,
1201 + experimental: undefined,
1202 + });
1203 + });
1204 +
1205 + it('should not include experimental in payload when userTimezone is not provided', async () => {
1206 + mockClient.toolRouter.session.create.mockResolvedValueOnce(mockSessionCreateResponse);
1207 +
1208 + const config: ToolRouterCreateSessionConfig = {
1209 + experimental: {
1210 + assistivePrompt: {},
1211 + },
1212 + };
1213 +
1214 + await toolRouter.create(userId, config);
1215 +
1216 + expect(mockClient.toolRouter.session.create).toHaveBeenCalledWith({
1217 + user_id: userId,
1218 + toolkits: undefined,
1219 + auth_configs: undefined,
1220 + connected_accounts: undefined,
1221 + tools: undefined,
1222 + tags: undefined,
1223 + manage_connections: createExpectedManageConnections(),
1224 + workbench: undefined,
1225 + experimental: undefined,
1226 + });
1227 + });
1228 +
1229 + it('should create a session with experimental config combined with other options', async () => {
1230 + mockClient.toolRouter.session.create.mockResolvedValueOnce(mockSessionCreateResponse);
1231 +
1232 + const config: ToolRouterCreateSessionConfig = {
1233 + toolkits: ['gmail', 'slack'],
1234 + experimental: {
1235 + assistivePrompt: {
1236 + userTimezone: 'Europe/London',
1237 + },
1238 + },
1239 + };
1240 +
1241 + await toolRouter.create(userId, config);
1242 +
1243 + expect(mockClient.toolRouter.session.create).toHaveBeenCalledWith({
1244 + user_id: userId,
1245 + toolkits: {
1246 + enable: ['gmail', 'slack'],
1247 + },
1248 + auth_configs: undefined,
1249 + connected_accounts: undefined,
1250 + tools: undefined,
1251 + tags: undefined,
1252 + manage_connections: createExpectedManageConnections(),
1253 + workbench: undefined,
1254 + experimental: {
1255 + assistive_prompt_config: {
1256 + user_timezone: 'Europe/London',
1257 + },
1258 + },
1259 + });
1260 + });
1261 +
1262 + it('should transform experimental assistive_prompt from API response to SDK format', async () => {
1263 + const responseWithExperimental = {
1264 + ...mockSessionCreateResponse,
1265 + experimental: {
1266 + assistive_prompt:
1267 + 'You are a helpful assistant working in the America/New_York timezone.',
1268 + },
1269 + };
1270 +
1271 + mockClient.toolRouter.session.create.mockResolvedValueOnce(responseWithExperimental);
1272 +
1273 + const session = await toolRouter.create(userId, {
1274 + experimental: {
1275 + assistivePrompt: {
1276 + userTimezone: 'America/New_York',
1277 + },
1278 + },
1279 + });
1280 +
1281 + expect(session.experimental).toEqual({
1282 + assistivePrompt: 'You are a helpful assistant working in the America/New_York timezone.',
1283 + });
1284 + });
1285 +
1286 + it('should handle API response without experimental field', async () => {
1287 + mockClient.toolRouter.session.create.mockResolvedValueOnce(mockSessionCreateResponse);
1288 +
1289 + const session = await toolRouter.create(userId);
1290 +
1291 + expect(session.experimental).toBeUndefined();
1292 + });
1293 + });
1294 +
1295 describe('error handling', () => {
1296 it('should throw error if API call fails', async () => {
1297 const apiError = new Error('API error: Invalid session configuration');
ts/packages/core/test/models/toolkits.test.ts
+48
@@ -86,6 +86,8 @@ const mockToolkitRetrieveResponse = {
86 },
87 },
88 ],
89 + get_current_user_endpoint: '/user',
90 + get_current_user_endpoint_method: 'GET',
91 };
92
93 describe('Toolkits', () => {
@@ -169,10 +171,56 @@ describe('Toolkits', () => {
171 },
172 },
173 ],
174 + getCurrentUserEndpoint: '/user',
175 + getCurrentUserEndpointMethod: 'GET',
176 });
177 expect(mockClient.toolkits.retrieve).toHaveBeenCalledWith('github');
178 });
179
180 + it('should handle toolkit without getCurrentUserEndpointMethod', async () => {
181 + const responseWithoutMethod = {
182 + ...mockToolkitRetrieveResponse,
183 + get_current_user_endpoint_method: undefined,
184 + };
185 + mockClient.toolkits.retrieve.mockResolvedValue(responseWithoutMethod);
186 +
187 + const result = await toolkits.get('github');
188 +
189 + expect(result).toEqual({
190 + name: 'GitHub',
191 + slug: 'github',
192 + meta: {
193 + createdAt: '2024-01-01',
194 + updatedAt: '2024-01-02',
195 + toolsCount: 10,
196 + triggersCount: 5,
197 + },
198 + isLocalToolkit: false,
199 + composioManagedAuthSchemes: ['oauth2'],
200 + authConfigDetails: [
201 + {
202 + name: 'oauth2',
203 + mode: 'oauth2',
204 + fields: {
205 + authConfigCreation: {
206 + optional: [],
207 + required: [],
208 + },
209 + connectedAccountInitiation: {
210 + optional: [],
211 + required: [],
212 + },
213 + },
214 + proxy: {
215 + baseUrl: 'https://api.github.com',
216 + },
217 + },
218 + ],
219 + getCurrentUserEndpoint: '/user',
220 + getCurrentUserEndpointMethod: undefined,
221 + });
222 + });
223 +
224 it('should throw ValidationError for invalid list query', async () => {
225 const promise = toolkits.get({ category: 123 } as any);
226 await expect(promise).rejects.toThrowError('Failed to fetch toolkits');
ts/packages/core/test/models/triggers.test.ts
+2 -2
@@ -267,7 +267,7 @@ describe('Triggers', () => {
267 authConfigIds: ['auth-1'],
268 connectedAccountIds: ['conn-1'],
269 limit: 5,
270 - page: 2,
270 + cursor: 'cursor-abc',
271 showDisabled: true,
272 triggerIds: ['trigger-1'],
273 triggerNames: ['github_webhook'],
@@ -281,7 +281,7 @@ describe('Triggers', () => {
281 auth_config_ids: query.authConfigIds,
282 connected_account_ids: query.connectedAccountIds,
283 limit: query.limit,
284 - page: query.page,
284 + cursor: query.cursor,
285 show_disabled: query.showDisabled,
286 trigger_ids: query.triggerIds,
287 trigger_names: query.triggerNames,
uv.lock
+14 -14
@@ -477,7 +477,7 @@ wheels = [
477
478 [[package]]
479 name = "composio"
480 -version = "0.10.8"
480 +version = "0.10.10"
481 source = { virtual = "python" }
482 dependencies = [
483 { name = "composio-client" },
@@ -506,7 +506,7 @@ dev = [
506
507 [package.metadata]
508 requires-dist = [
509 - { name = "composio-client", specifier = "==1.26.0" },
509 + { name = "composio-client", specifier = "==1.27.0" },
510 { name = "openai" },
511 { name = "pydantic", specifier = ">=2.6.4" },
512 { name = "pysher", specifier = ">=1.0.8" },
@@ -532,7 +532,7 @@ dev = [
532
533 [[package]]
534 name = "composio-anthropic"
535 -version = "0.10.8"
535 +version = "0.10.10"
536 source = { virtual = "python/providers/anthropic" }
537 dependencies = [
538 { name = "anthropic" },
@@ -547,7 +547,7 @@ requires-dist = [
547
548 [[package]]
549 name = "composio-client"
550 -version = "1.26.0"
550 +version = "1.27.0"
551 source = { registry = "https://pypi.org/simple" }
552 dependencies = [
553 { name = "anyio" },
@@ -557,14 +557,14 @@ dependencies = [
557 { name = "sniffio" },
558 { name = "typing-extensions" },
559 ]
560 -sdist = { url = "https://files.pythonhosted.org/packages/31/ea/e9abfe0a16b10358ea126fae9019808cde5d76fdf17b70cc1df48c7535b6/composio_client-1.26.0.tar.gz", hash = "sha256:8ab65d900025970760c522c8df4445a6a63aff9f78773682f7193928016fb0f7", size = 192874 }
560 +sdist = { url = "https://files.pythonhosted.org/packages/35/2d/5faddf107854a843137ee127946db3a738667948933e0903f1250e5e729a/composio_client-1.27.0.tar.gz", hash = "sha256:684d33a4e701f92d6d2cca1a66b638e509afb46263e9f13266673ee7c55efefe", size = 193444 }
561 wheels = [
562 - { url = "https://files.pythonhosted.org/packages/37/2b/ad19b251f0d2241da0227fce6aee5792a6bbf26c09ff1d43841b946e7557/composio_client-1.26.0-py3-none-any.whl", hash = "sha256:24b6b0ffba0b7a1c818da53a77b450bbddc26313f9c6abc1ef4472cfb348e450", size = 210074 },
562 + { url = "https://files.pythonhosted.org/packages/57/37/e121ef2986935d374e85ca74315a8bc7fd5208342cabbb6461a49be466a4/composio_client-1.27.0-py3-none-any.whl", hash = "sha256:45697bb0f8a29290271727d9c1a3233e859dc61c515e6669f59408843fa590f0", size = 210495 },
563 ]
564
565 [[package]]
566 name = "composio-crewai"
567 -version = "0.10.8"
567 +version = "0.10.10"
568 source = { virtual = "python/providers/crewai" }
569 dependencies = [
570 { name = "composio" },
@@ -579,7 +579,7 @@ requires-dist = [
579
580 [[package]]
581 name = "composio-gemini"
582 -version = "0.10.8"
582 +version = "0.10.10"
583 source = { virtual = "python/providers/gemini" }
584 dependencies = [
585 { name = "composio" },
@@ -594,7 +594,7 @@ requires-dist = [
594
595 [[package]]
596 name = "composio-google"
597 -version = "0.10.8"
597 +version = "0.10.10"
598 source = { virtual = "python/providers/google" }
599 dependencies = [
600 { name = "composio" },
@@ -609,7 +609,7 @@ requires-dist = [
609
610 [[package]]
611 name = "composio-google-adk"
612 -version = "0.10.8"
612 +version = "0.10.10"
613 source = { virtual = "python/providers/google_adk" }
614 dependencies = [
615 { name = "composio" },
@@ -624,7 +624,7 @@ requires-dist = [
624
625 [[package]]
626 name = "composio-langchain"
627 -version = "0.10.8"
627 +version = "0.10.10"
628 source = { virtual = "python/providers/langchain" }
629 dependencies = [
630 { name = "composio" },
@@ -639,7 +639,7 @@ requires-dist = [
639
640 [[package]]
641 name = "composio-openai"
642 -version = "0.10.8"
642 +version = "0.10.10"
643 source = { virtual = "python/providers/openai" }
644 dependencies = [
645 { name = "composio" },
@@ -654,7 +654,7 @@ requires-dist = [
654
655 [[package]]
656 name = "composio-openai-agents"
657 -version = "0.10.8"
657 +version = "0.10.10"
658 source = { virtual = "python/providers/openai_agents" }
659 dependencies = [
660 { name = "composio" },
@@ -892,7 +892,7 @@ dev = [
892 requires-dist = [
893 { name = "click", specifier = ">=8.1.7" },
894 { name = "composio", virtual = "python" },
895 - { name = "composio-client", specifier = "==1.26.0" },
895 + { name = "composio-client", specifier = "==1.27.0" },
896 { name = "composio-gemini", virtual = "python/providers/gemini" },
897 { name = "composio-langchain", virtual = "python/providers/langchain" },
898 { name = "composio-openai", virtual = "python/providers/openai" },