@devries-cameron20 / composio Mirror · read-only
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 21, 06:00 UTC

next
mdx 64 lines 2.3 KB
Raw
1 ---
2 title: 'SDKs add sandbox compute tier for Tool Router workbench'
3 description: 'TypeScript and Python SDKs gain `workbench.sandboxSize` / `workbench.sandbox_size` to pick the workbench sandbox tier (standard, medium, large, xlarge). Patch releases.'
4 date: '2026-04-28'
5 ---
6
7 The Composio SDKs now let you pick the compute tier of the [sandbox](/docs/sandbox/remote) when creating a Tool Router session. Heavier code execution and larger in-memory data benefit from a bigger sandbox.
8
9 | Tier | vCPU | RAM |
10 | ---------- | ---- | ----- |
11 | `standard` | 1 | 1 GB |
12 | `medium` | 2 | 2 GB |
13 | `large` | 4 | 4 GB |
14 | `xlarge` | 8 | 8 GB |
15
16 The field is optional and defaults to `standard` server-side when omitted, so existing code keeps working unchanged.
17
18 <Callout type="info">
19 **Pricing:** Sandboxes are not billed today. Composio plans to begin billing for sandbox usage soon (metered by tier and runtime). Pick a tier that matches your workload — but expect future pricing to track actual usage.
20 </Callout>
21
22 ### SDK versions (patch releases)
23
24 | Package | Previous | This release |
25 | ------- | -------- | ------------ |
26 | TypeScript `@composio/core` | v0.8.0 | **v0.8.1** |
27 | Python `composio` | v0.12.0 | **v0.12.1** |
28
29 ### Usage
30
31 **TypeScript** (camelCase on the SDK surface):
32
33 ```typescript
34 import { Composio } from '@composio/core';
35 const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY! });
36
37 const session = await composio.create('user_123', {
38 workbench: {
39 enable: true,
40 sandboxSize: 'large',
41 },
42 });
43 ```
44
45 The `SandboxSize` literal type and `SandboxSizeSchema` zod enum are exported from `@composio/core`.
46
47 **Python** (snake_case throughout):
48
49 ```python
50 session = composio.create(
51 user_id="user_123",
52 workbench={
53 "sandbox_size": "large",
54 },
55 )
56 ```
57
58 The `SandboxSize` literal alias is available at `composio.core.models.tool_router.SandboxSize`.
59
60 ### Updating an existing session
61
62 Calling `session.update()` (or the equivalent `PATCH /api/v3/tool_router/sessions/{id}`) with a different `sandbox_size` recreates the sandbox on next access. The sandbox's in-memory filesystem state is lost, but the persistent `/mnt/files/` mount survives the restart.
63
64 See [Configuring Sessions → Sandbox compute tier](/docs/configuring-sessions#sandbox-compute-tier) for the full reference.