- Add first-class `composio.sessions.create()` API while keeping `composio.create()` as an alias
- Expose shared-connection ACL patch helper as `connectedAccounts.updateAcl()` while keeping `experimental.updateAcl()` as an alias
- Include SDK docs and source in the published package
- Add `triggers.parse()` to parse and optionally verify incoming webhook requests
- Add `triggers.setWebhookSubscription()` to create or update the project webhook subscription from the TypeScript SDK
- Make MCP opt-in; sessions return native tools by default and the hosted MCP endpoint is only surfaced when creating with `{ mcp: true }`
- Sessions now return `SessionWithoutMcp` type by default instead of including MCP in the type
- Surface the resolved workbench config on Tool Router sessions via `Session.workbench` populated from the API response
- Prefer `sandbox` for session code-execution configuration while continuing to accept the existing `workbench` alias
Minor Changes
-
d17a268: Add the first-class
composio.sessions.create()API while keepingcomposio.create()as an alias, expose the experimental shared-connection ACL patch helper asconnectedAccounts.updateAcl()while keepingexperimental.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 defaultcreate()/use()now returnSessionWithoutMcp(the runtime object is unchanged —session.mcpstill exists at runtime — but it is no longer in the type).Migration: read
session.mcponly after creating with{ mcp: true }. -
d17a268: Surface the resolved workbench config on Tool Router sessions.
Session.workbenchis now populated from the API response (on create/retrieve/attach/update). It exposes the resolved workbench config, e.g.session.workbench?.enable(defaults totrueserver-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/workbenchhelpers.
Patch Changes
- d17a268: Prefer
sandboxfor session code-execution configuration while continuing to accept the existingworkbenchalias. - 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.