Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

chore: add changeset for v3.1 customs use/attach (minor)

Abir Taheer3ece424708cc
diff --git a/.changeset/v31-customs-use-attach.md b/.changeset/v31-customs-use-attach.md
new file mode 100644
index 000000000..a589ad5c9
--- /dev/null
+++ b/.changeset/v31-customs-use-attach.md
@@ -0,0 +1,11 @@
+---
+'@composio/core': minor
+---
+
+Add custom tools support to `composio.use()` and update `connectedAccounts` to array type.
+
+- **`composio.use(id, { customTools, customToolkits })`**: Attach custom tools to an existing session. Calls the v3.1 `/attach` endpoint to bind local tools for search and execution. Without customs, falls back to the standard session retrieve.
+- **Inline custom tools payload**: `use()` now correctly passes `inlineCustomToolsPayload` and `preloadedCustomToolSlugs` to the session, enabling custom tool execution and preloading on rehydrated sessions.
+- **`connectedAccounts` type change**: Updated from `Record<string, string>` to `Record<string, string[]>` to match the v3.1 API. Only one account per toolkit is allowed when multi-account mode is disabled.
+- **`CustomToolsMap.tools`**: The map now caches the raw `CustomTool[]` array for future inline re-injection on v3.1 search/execute requests.
+- **`@composio/client`**: Bumped to `0.1.0-alpha.70`.