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
Release: update version (#3676)
sdkrelease[bot]d102ab03ca22
diff --git a/.changeset/add-slim-package.md b/.changeset/add-slim-package.mddeleted file mode 100644index 33c7f565d..000000000--- a/.changeset/add-slim-package.md+++ /dev/null@@ -1,5 +0,0 @@-----"@composio/slim": minor------Add a slim Composio core package that mirrors the built `@composio/core` runtime and types without publishing the packaged `docs/` or `src/` trees.diff --git a/.changeset/bright-lions-jam.md b/.changeset/bright-lions-jam.mddeleted file mode 100644index cb24d19b6..000000000--- a/.changeset/bright-lions-jam.md+++ /dev/null@@ -1,9 +0,0 @@-----'@composio/core': minor------Add the first-class `composio.sessions.create()` API while keeping `composio.create()` as an alias, expose the experimental shared-connection ACL patch helper as `connectedAccounts.updateAcl()` while keeping `experimental.updateAcl()` as an alias, and include SDK docs/source in the published package.--**MCP is now opt-in.** Sessions return native tools by default; the hosted MCP endpoint is only surfaced on the type when you create the session with `{ mcp: true }`. The default `create()` / `use()` now return `SessionWithoutMcp` (the runtime object is unchanged — `session.mcp` still exists at runtime — but it is no longer in the type).--Migration: read `session.mcp` only after creating with `{ mcp: true }`.diff --git a/.changeset/byos-local-workbench.md b/.changeset/byos-local-workbench.mddeleted file mode 100644index 91408cb9b..000000000--- a/.changeset/byos-local-workbench.md+++ /dev/null@@ -1,9 +0,0 @@-----'@composio/core': minor------Surface the resolved workbench config on Tool Router sessions.--- `Session.workbench` is now populated from the API response (on create/retrieve/attach/update). It exposes the resolved workbench config, e.g. `session.workbench?.enable` (defaults to `true` server-side).--This lets callers create a session with the remote workbench disabled (`workbench: { enable: false }`) and detect that state — the foundation for running code in a sandbox you own via the experimental `@composio/experimental/workbench` helpers.diff --git a/.changeset/config.json b/.changeset/config.jsonindex 031c72bff..23ff326c6 100644--- a/.changeset/config.json+++ b/.changeset/config.json@@ -14,5 +14,5 @@"___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {"onlyUpdatePeerDependentsWhenOutOfRange": true},- "ignore": []+ "ignore": ["@composio/cli", "@composio/cli-local-tools"]}diff --git a/.changeset/experimental-local-workbench.md b/.changeset/experimental-local-workbench.mddeleted file mode 100644index 7104a27e8..000000000--- a/.changeset/experimental-local-workbench.md+++ /dev/null@@ -1,15 +0,0 @@-----'@composio/experimental': minor------Add the experimental BYO local workbench helpers on the new `@composio/experimental/workbench` subpath.--These let you run a Composio Tool Router session in a sandbox you own instead of Composio's hosted remote sandbox:--- `experimental_createLocalWorkbenchSession(composio, session)` takes a caller-created session and returns `{ helperSource, env }`. It throws unless the session was created with `workbench: { enable: false }` (a local sandbox and the remote workbench cannot both run for one session).-- `experimental_createWorkbenchEnv(options)` builds the environment variables the in-sandbox helper needs to reach Composio.-- `experimental_createPythonWorkbenchHelperSource(options)` returns the Python helper source.--The local workbench assumes code runs in the developer's sandbox and exposes Apollo-parity Python helpers for `run_composio_tool`, `invoke_llm`, `web_search`, and `proxy_execute`.--> **Security caveat:** the helper authenticates with the developer's full *project* API key, injected into the sandbox env as `COMPOSIO_API_KEY`. Any code or tool output running in the sandbox can read and exfiltrate it — treat the sandbox as your security boundary and rotate the key. A session-scoped `x-session-access-key` (so the long-lived project key never enters the sandbox) is the planned follow-up.diff --git a/.changeset/experimental-pi-provider.md b/.changeset/experimental-pi-provider.mddeleted file mode 100644index bded657c0..000000000--- a/.changeset/experimental-pi-provider.md+++ /dev/null@@ -1,5 +0,0 @@-----"@composio/experimental": minor------Add an experimental package with a Pi coding-agent provider, static Composio tool wrapping, and dynamic Tool Router session helpers.diff --git a/.changeset/local-workbench-proxy-execute.md b/.changeset/local-workbench-proxy-execute.mddeleted file mode 100644index fdc7d5ba0..000000000--- a/.changeset/local-workbench-proxy-execute.md+++ /dev/null@@ -1,5 +0,0 @@-----'@composio/experimental': patch------Add `proxy_execute` to the experimental local workbench helper. The in-sandbox helper from `experimental_createLocalWorkbenchSession` (`@composio/experimental/workbench`) now exposes `proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None)` alongside `run_composio_tool`, `invoke_llm`, and `web_search`, so a local sandbox can make authenticated direct API calls to a connected toolkit when no pre-built tool exists. It posts to the public `…/session/{id}/proxy_execute` route with the session's project API key, and always returns a `(data, error)` tuple.diff --git a/.changeset/sdk-sandbox-alias.md b/.changeset/sdk-sandbox-alias.mddeleted file mode 100644index 176485472..000000000--- a/.changeset/sdk-sandbox-alias.md+++ /dev/null@@ -1,5 +0,0 @@-----'@composio/core': patch------Prefer `sandbox` for session code-execution configuration while continuing to accept the existing `workbench` alias.diff --git a/.changeset/triggers-parse-helper.md b/.changeset/triggers-parse-helper.mddeleted file mode 100644index 9d75ecce9..000000000--- a/.changeset/triggers-parse-helper.md+++ /dev/null@@ -1,5 +0,0 @@-----'@composio/core': patch------Add `triggers.parse()` to parse and optionally verify incoming webhook requests.diff --git a/.changeset/webhook-subscription-sdk.md b/.changeset/webhook-subscription-sdk.mddeleted file mode 100644index c2bb152d0..000000000--- a/.changeset/webhook-subscription-sdk.md+++ /dev/null@@ -1,5 +0,0 @@-----'@composio/core': patch------Add `triggers.setWebhookSubscription()` to create or update the project webhook subscription from the TypeScript SDK.diff --git a/ts/packages/core/CHANGELOG.md b/ts/packages/core/CHANGELOG.mdindex b94858dd4..18d585ca7 100644--- a/ts/packages/core/CHANGELOG.md+++ b/ts/packages/core/CHANGELOG.md@@ -1,5 +1,27 @@# @composio/core+## 0.13.0++### Minor Changes++- d17a268: Add the first-class `composio.sessions.create()` API while keeping `composio.create()` as an alias, expose the experimental shared-connection ACL patch helper as `connectedAccounts.updateAcl()` while keeping `experimental.updateAcl()` as an alias, and include SDK docs/source in the published package.++ **MCP is now opt-in.** Sessions return native tools by default; the hosted MCP endpoint is only surfaced on the type when you create the session with `{ mcp: true }`. The default `create()` / `use()` now return `SessionWithoutMcp` (the runtime object is unchanged — `session.mcp` still exists at runtime — but it is no longer in the type).++ Migration: read `session.mcp` only after creating with `{ mcp: true }`.++- d17a268: Surface the resolved workbench config on Tool Router sessions.++ - `Session.workbench` is now populated from the API response (on create/retrieve/attach/update). It exposes the resolved workbench config, e.g. `session.workbench?.enable` (defaults to `true` server-side).++ This lets callers create a session with the remote workbench disabled (`workbench: { enable: false }`) and detect that state — the foundation for running code in a sandbox you own via the experimental `@composio/experimental/workbench` helpers.++### Patch Changes++- d17a268: Prefer `sandbox` for session code-execution configuration while continuing to accept the existing `workbench` alias.+- d17a268: Add `triggers.parse()` to parse and optionally verify incoming webhook requests.+- d17a268: Add `triggers.setWebhookSubscription()` to create or update the project webhook subscription from the TypeScript SDK.+## 0.12.0### Minor Changesdiff --git a/ts/packages/core/package.json b/ts/packages/core/package.jsonindex f45c836cc..d46f3e046 100644--- a/ts/packages/core/package.json+++ b/ts/packages/core/package.json@@ -1,7 +1,7 @@{"name": "@composio/core","type": "module",- "version": "0.12.0",+ "version": "0.13.0","description": "","main": "src/index.ts","publishConfig": {diff --git a/ts/packages/experimental/CHANGELOG.md b/ts/packages/experimental/CHANGELOG.mdnew file mode 100644index 000000000..5fb4e21ed--- /dev/null+++ b/ts/packages/experimental/CHANGELOG.md@@ -0,0 +1,23 @@+# @composio/experimental++## 0.1.0++### Minor Changes++- d17a268: Add the experimental BYO local workbench helpers on the new `@composio/experimental/workbench` subpath.++ These let you run a Composio Tool Router session in a sandbox you own instead of Composio's hosted remote sandbox:++ - `experimental_createLocalWorkbenchSession(composio, session)` takes a caller-created session and returns `{ helperSource, env }`. It throws unless the session was created with `workbench: { enable: false }` (a local sandbox and the remote workbench cannot both run for one session).+ - `experimental_createWorkbenchEnv(options)` builds the environment variables the in-sandbox helper needs to reach Composio.+ - `experimental_createPythonWorkbenchHelperSource(options)` returns the Python helper source.++ The local workbench assumes code runs in the developer's sandbox and exposes Apollo-parity Python helpers for `run_composio_tool`, `invoke_llm`, `web_search`, and `proxy_execute`.++ > **Security caveat:** the helper authenticates with the developer's full _project_ API key, injected into the sandbox env as `COMPOSIO_API_KEY`. Any code or tool output running in the sandbox can read and exfiltrate it — treat the sandbox as your security boundary and rotate the key. A session-scoped `x-session-access-key` (so the long-lived project key never enters the sandbox) is the planned follow-up.++- d17a268: Add an experimental package with a Pi coding-agent provider, static Composio tool wrapping, and dynamic Tool Router session helpers.++### Patch Changes++- d17a268: Add `proxy_execute` to the experimental local workbench helper. The in-sandbox helper from `experimental_createLocalWorkbenchSession` (`@composio/experimental/workbench`) now exposes `proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None)` alongside `run_composio_tool`, `invoke_llm`, and `web_search`, so a local sandbox can make authenticated direct API calls to a connected toolkit when no pre-built tool exists. It posts to the public `…/session/{id}/proxy_execute` route with the session's project API key, and always returns a `(data, error)` tuple.diff --git a/ts/packages/experimental/package.json b/ts/packages/experimental/package.jsonindex bd95784b9..d50cc7590 100644--- a/ts/packages/experimental/package.json+++ b/ts/packages/experimental/package.json@@ -1,6 +1,6 @@{"name": "@composio/experimental",- "version": "0.0.1",+ "version": "0.1.0","description": "Experimental Composio integrations and helpers","main": "src/index.ts","type": "module",diff --git a/ts/packages/slim/CHANGELOG.md b/ts/packages/slim/CHANGELOG.mdnew file mode 100644index 000000000..a41f8c608--- /dev/null+++ b/ts/packages/slim/CHANGELOG.md@@ -0,0 +1,7 @@+# @composio/slim++## 0.13.0++### Minor Changes++- d17a268: Add a slim Composio core package that mirrors the built `@composio/core` runtime and types without publishing the packaged `docs/` or `src/` trees.diff --git a/ts/packages/slim/package.json b/ts/packages/slim/package.jsonindex dc12ec767..02556660d 100644--- a/ts/packages/slim/package.json+++ b/ts/packages/slim/package.json@@ -1,7 +1,7 @@{"name": "@composio/slim","type": "module",- "version": "0.0.1",+ "version": "0.13.0","description": "Slim Composio core package without packaged source or docs","main": "dist/index.mjs","publishConfig": {