@composio/client 0.1.0-alpha.65 → 0.1.0-alpha.67

package/resources/tool-router/session/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/resources/tool-router/session/session.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,6DAAoC;AACpC,sCAUiB;AAGjB,0DAAoD;AAEpD;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAsM3D,CAAC;IApMC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO,CACL,SAAiB,EACjB,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,WAAW,CACT,SAAiB,EACjB,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,eAAe,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,SAAiB,EACjB,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CACV,SAAiB,EACjB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,gBAAgB,EAAE;YACrF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CACJ,SAAiB,EACjB,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,SAAiB,EACjB,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CACH,SAAiB,EACjB,KAA6C,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF;AAvMD,0BAuMC;AAs+ED,OAAO,CAAC,KAAK,GAAG,aAAK,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/resources/tool-router/session/session.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,6DAAoC;AACpC,sCAUiB;AAGjB,0DAAoD;AAEpD;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAyM3D,CAAC;IAvMC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CACL,SAAiB,EACjB,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,WAAW,CACT,SAAiB,EACjB,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,eAAe,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,SAAiB,EACjB,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CACV,SAAiB,EACjB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,gBAAgB,EAAE;YACrF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CACJ,SAAiB,EACjB,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,SAAiB,EACjB,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CACH,SAAiB,EACjB,KAA6C,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,+BAA+B,SAAS,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF;AA1MD,0BA0MC;AAmqFD,OAAO,CAAC,KAAK,GAAG,aAAK,CAAC"}

package/resources/tool-router/session/session.mjs

@@ -34,7 +34,7 @@ export class Session extends APIResource {
      * @example
      * ```ts
      * const session = await client.toolRouter.session.retrieve(
-     *   'trs_123456789',
+     *   'trs_1a2b3c4d5e6f',
      * );
      * ```
      */
@@ -42,11 +42,12 @@ export class Session extends APIResource {
         return this._client.get(path `/api/v3/tool_router/session/${sessionID}`, options);
     }
     /**
-     * Executes a specific tool within a tool router session. The toolkit is
-     * automatically inferred from the tool slug. The tool must belong to an allowed
-     * toolkit and must not be disabled in the session configuration. This endpoint
-     * validates permissions, resolves connected accounts, and executes the tool with
-     * the session context.
+     * Executes a specific tool within a tool router session. This is the primary
+     * execution endpoint for both meta tools and app tools exposed by the session. The
+     * toolkit is automatically inferred from the tool slug. For app tools, the tool
+     * must belong to an allowed toolkit and must not be disabled in the session
+     * configuration. The endpoint validates permissions, resolves connected accounts
+     * when needed, and executes the tool with the session context.
      *
      * @example
      * ```ts
@@ -60,7 +61,9 @@ export class Session extends APIResource {
         return this._client.post(path `/api/v3/tool_router/session/${sessionID}/execute`, { body, ...options });
     }
     /**
-     * Executes a Composio meta tool (COMPOSIO\_\*) within a tool router session.
+     * Executes a Composio meta tool (COMPOSIO\_\*) within a tool router session. This
+     * endpoint is kept for meta-tool compatibility; clients can also use the primary
+     * /execute endpoint.
      *
      * @example
      * ```ts
@@ -149,7 +152,7 @@ export class Session extends APIResource {
      * @example
      * ```ts
      * const response = await client.toolRouter.session.toolkits(
-     *   'trs_123456789',
+     *   'trs_1a2b3c4d5e6f',
      * );
      * ```
      */
@@ -157,9 +160,9 @@ export class Session extends APIResource {
         return this._client.get(path `/api/v3/tool_router/session/${sessionID}/toolkits`, { query, ...options });
     }
     /**
-     * Returns the meta tools available in a tool router session with their complete
-     * schemas. This includes request and response schemas specific to the session
-     * context.
+     * Returns the tools available in a tool router session with their complete
+     * schemas. This includes both meta tools and any preloaded app tools exposed by
+     * the session.
      *
      * @example
      * ```ts

package/resources/tool-router/session/session.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"session.mjs","sourceRoot":"","sources":["../../../src/resources/tool-router/session/session.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,QAAQ;OACb,EASL,KAAK,GACN;OAGM,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAsM3D,CAAC;IApMC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,+BAA+B,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO,CACL,SAAiB,EACjB,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,+BAA+B,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,WAAW,CACT,SAAiB,EACjB,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,+BAA+B,SAAS,eAAe,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,SAAiB,EACjB,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,+BAA+B,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CACV,SAAiB,EACjB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,+BAA+B,SAAS,gBAAgB,EAAE;YACrF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CACJ,SAAiB,EACjB,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,+BAA+B,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,SAAiB,EACjB,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,+BAA+B,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CACH,SAAiB,EACjB,KAA6C,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,+BAA+B,SAAS,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF;AAs+ED,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC"}
+{"version":3,"file":"session.mjs","sourceRoot":"","sources":["../../../src/resources/tool-router/session/session.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,QAAQ;OACb,EASL,KAAK,GACN;OAGM,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAyM3D,CAAC;IAvMC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,+BAA+B,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CACL,SAAiB,EACjB,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,+BAA+B,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,WAAW,CACT,SAAiB,EACjB,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,+BAA+B,SAAS,eAAe,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,SAAiB,EACjB,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,+BAA+B,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CACV,SAAiB,EACjB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,+BAA+B,SAAS,gBAAgB,EAAE;YACrF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CACJ,SAAiB,EACjB,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,+BAA+B,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,SAAiB,EACjB,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,+BAA+B,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CACH,SAAiB,EACjB,KAA6C,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,+BAA+B,SAAS,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF;AAmqFD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC"}

package/resources/tool-router/tool-router.d.mts

@@ -42,7 +42,7 @@ export interface ToolRouterCreateSessionResponse {
      */
     chat_session_mcp_url: string;
     /**
-     * Generated session identifier
+     * Generated session identifier (prefixed with "trs\_")
      */
     session_id: string;
     /**

package/resources/tool-router/tool-router.d.ts

@@ -42,7 +42,7 @@ export interface ToolRouterCreateSessionResponse {
      */
     chat_session_mcp_url: string;
     /**
-     * Generated session identifier
+     * Generated session identifier (prefixed with "trs\_")
      */
     session_id: string;
     /**

package/src/client.ts

@@ -291,6 +291,18 @@ export class Composio {
     this.fetch = options.fetch ?? Shims.getDefaultFetch();
     this.#encoder = Opts.FallbackEncoder;
 
+    const customHeadersEnv = readEnv('COMPOSIO_CUSTOM_HEADERS');
+    if (customHeadersEnv) {
+      const parsed: Record<string, string> = {};
+      for (const line of customHeadersEnv.split('\n')) {
+        const colon = line.indexOf(':');
+        if (colon >= 0) {
+          parsed[line.substring(0, colon).trim()] = line.substring(colon + 1).trim();
+        }
+      }
+      options.defaultHeaders = { ...parsed, ...options.defaultHeaders };
+    }
+
     this._options = options;
 
     this.apiKey = apiKey;

package/src/resources/files.ts

@@ -98,7 +98,7 @@ export interface FileCreatePresignedURLResponse {
 
   /**
    * Object storage upload location. Example:
-   * "projects/prj_xyz789/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx"
+   * "projects/pr_1a2b3c4d5e6f/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx"
    */
   key: string;
 
@@ -106,14 +106,14 @@ export interface FileCreatePresignedURLResponse {
 
   /**
    * Presigned URL for upload. Example:
-   * "https://storage.composio.dev/projects/prj_xyz789/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."
+   * "https://storage.composio.dev/projects/pr_1a2b3c4d5e6f/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."
    */
   new_presigned_url: string;
 
   /**
    * @deprecated [DEPRECATED] Use new_presigned_url instead. Presigned URL for
    * upload. Example:
-   * "https://storage.composio.dev/projects/prj_xyz789/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."
+   * "https://storage.composio.dev/projects/pr_1a2b3c4d5e6f/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."
    */
   newPresignedUrl: string;
 

package/src/resources/mcp/generate.ts

@@ -17,7 +17,10 @@ export class Generate extends APIResource {
    * ```ts
    * const response = await client.mcp.generate.url({
    *   mcp_server_id: '550e8400-e29b-41d4-a716-446655440000',
-   *   connected_account_ids: ['account_1', 'account_2'],
+   *   connected_account_ids: [
+   *     'ca_1a2b3c4d5e6f',
+   *     'ca_7g8h9i0j1k2l',
+   *   ],
    *   user_ids: ['user_123456'],
    * });
    * ```

package/src/resources/tool-router/session/files.ts

@@ -18,7 +18,7 @@ export class Files extends APIResource {
    * ```ts
    * const files = await client.toolRouter.session.files.list(
    *   'files',
-   *   { session_id: 'trs_123456789' },
+   *   { session_id: 'trs_1a2b3c4d5e6f' },
    * );
    * ```
    */
@@ -39,7 +39,7 @@ export class Files extends APIResource {
    * const file = await client.toolRouter.session.files.delete(
    *   'files',
    *   {
-   *     session_id: 'trs_123456789',
+   *     session_id: 'trs_1a2b3c4d5e6f',
    *     mount_relative_path: 'report.pdf',
    *   },
    * );
@@ -67,7 +67,7 @@ export class Files extends APIResource {
    *   await client.toolRouter.session.files.createDownloadURL(
    *     'files',
    *     {
-   *       session_id: 'trs_123456789',
+   *       session_id: 'trs_1a2b3c4d5e6f',
    *       mount_relative_path: 'report.pdf',
    *     },
    *   );
@@ -95,7 +95,7 @@ export class Files extends APIResource {
    *   await client.toolRouter.session.files.createUploadURL(
    *     'files',
    *     {
-   *       session_id: 'trs_123456789',
+   *       session_id: 'trs_1a2b3c4d5e6f',
    *       mount_relative_path: 'report.pdf',
    *     },
    *   );

package/src/resources/tool-router/session/session.ts

@@ -47,7 +47,7 @@ export class Session extends APIResource {
    * @example
    * ```ts
    * const session = await client.toolRouter.session.retrieve(
-   *   'trs_123456789',
+   *   'trs_1a2b3c4d5e6f',
    * );
    * ```
    */
@@ -56,11 +56,12 @@ export class Session extends APIResource {
   }
 
   /**
-   * Executes a specific tool within a tool router session. The toolkit is
-   * automatically inferred from the tool slug. The tool must belong to an allowed
-   * toolkit and must not be disabled in the session configuration. This endpoint
-   * validates permissions, resolves connected accounts, and executes the tool with
-   * the session context.
+   * Executes a specific tool within a tool router session. This is the primary
+   * execution endpoint for both meta tools and app tools exposed by the session. The
+   * toolkit is automatically inferred from the tool slug. For app tools, the tool
+   * must belong to an allowed toolkit and must not be disabled in the session
+   * configuration. The endpoint validates permissions, resolves connected accounts
+   * when needed, and executes the tool with the session context.
    *
    * @example
    * ```ts
@@ -79,7 +80,9 @@ export class Session extends APIResource {
   }
 
   /**
-   * Executes a Composio meta tool (COMPOSIO\_\*) within a tool router session.
+   * Executes a Composio meta tool (COMPOSIO\_\*) within a tool router session. This
+   * endpoint is kept for meta-tool compatibility; clients can also use the primary
+   * /execute endpoint.
    *
    * @example
    * ```ts
@@ -188,7 +191,7 @@ export class Session extends APIResource {
    * @example
    * ```ts
    * const response = await client.toolRouter.session.toolkits(
-   *   'trs_123456789',
+   *   'trs_1a2b3c4d5e6f',
    * );
    * ```
    */
@@ -201,9 +204,9 @@ export class Session extends APIResource {
   }
 
   /**
-   * Returns the meta tools available in a tool router session with their complete
-   * schemas. This includes request and response schemas specific to the session
-   * context.
+   * Returns the tools available in a tool router session with their complete
+   * schemas. This includes both meta tools and any preloaded app tools exposed by
+   * the session.
    *
    * @example
    * ```ts
@@ -227,6 +230,12 @@ export interface SessionCreateResponse {
    */
   config: SessionCreateResponse.Config;
 
+  /**
+   * Monotonic version of the config. Incremented on each PATCH. Use for optimistic
+   * concurrency control.
+   */
+  config_version: number;
+
   mcp: SessionCreateResponse.Mcp;
 
   /**
@@ -244,6 +253,12 @@ export interface SessionCreateResponse {
    * session creation, not on GET.
    */
   experimental?: SessionCreateResponse.Experimental;
+
+  /**
+   * Advisory list — session was created, but the listed issues may warrant
+   * attention.
+   */
+  warnings?: Array<SessionCreateResponse.Warning>;
 }
 
 export namespace SessionCreateResponse {
@@ -251,6 +266,15 @@ export namespace SessionCreateResponse {
    * The session configuration including user, toolkits, and overrides
    */
   export interface Config {
+    /**
+     * Preload configuration. Controls which tools appear in `session.tools` and the
+     * MCP server tool list, callable directly without going through search. Each
+     * preloaded tool adds to the agent context — roughly ≤20 tools is recommended.
+     * Always present in the response (empty `tools: []` when the session was created
+     * without a preload config).
+     */
+    preload: Config.Preload;
+
     /**
      * User identifier for this session
      */
@@ -262,7 +286,8 @@ export namespace SessionCreateResponse {
     auth_configs?: { [key: string]: string };
 
     /**
-     * Connected account overrides per toolkit
+     * Connected account overrides per toolkit. Each connected account must belong to
+     * the same user_id as the session.
      */
     connected_accounts?: { [key: string]: string };
 
@@ -271,6 +296,11 @@ export namespace SessionCreateResponse {
      */
     manage_connections?: Config.ManageConnections;
 
+    /**
+     * Multi-account configuration for this session.
+     */
+    multi_account?: Config.MultiAccount;
+
     /**
      * MCP tool annotation hints for filtering tools with enabled/disabled support.
      * enabled: tags that the tool must have at least one of. disabled: tags that the
@@ -295,6 +325,22 @@ export namespace SessionCreateResponse {
   }
 
   export namespace Config {
+    /**
+     * Preload configuration. Controls which tools appear in `session.tools` and the
+     * MCP server tool list, callable directly without going through search. Each
+     * preloaded tool adds to the agent context — roughly ≤20 tools is recommended.
+     * Always present in the response (empty `tools: []` when the session was created
+     * without a preload config).
+     */
+    export interface Preload {
+      /**
+       * Tool slugs preloaded for this session. Appear in `session.tools` and the MCP
+       * server tool list, callable directly without going through search. Empty array
+       * when no preload was configured.
+       */
+      tools: Array<string>;
+    }
+
     /**
      * Manage connections configuration
      */
@@ -321,6 +367,29 @@ export namespace SessionCreateResponse {
       enabled?: boolean;
     }
 
+    /**
+     * Multi-account configuration for this session.
+     */
+    export interface MultiAccount {
+      /**
+       * When true, enables multi-account mode for this session. When not set, falls back
+       * to org/project-level configuration.
+       */
+      enable?: boolean;
+
+      /**
+       * Maximum number of connected accounts allowed per toolkit. Defaults to 5 when
+       * multi-account is enabled.
+       */
+      max_accounts_per_toolkit?: number;
+
+      /**
+       * When true, require explicit account selection when multiple accounts are
+       * connected. When false (default), use the first/default account.
+       */
+      require_explicit_selection?: boolean;
+    }
+
     /**
      * MCP tool annotation hints for filtering tools with enabled/disabled support.
      * enabled: tags that the tool must have at least one of. disabled: tags that the
@@ -392,6 +461,12 @@ export namespace SessionCreateResponse {
        * Whether proxy execution is enabled in the workbench
        */
       proxy_execution_enabled?: boolean;
+
+      /**
+       * Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4
+       * vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard.
+       */
+      sandbox_size?: 'standard' | 'medium' | 'large' | 'xlarge';
     }
   }
 
@@ -483,6 +558,19 @@ export namespace SessionCreateResponse {
       output_schema?: { [key: string]: unknown };
     }
   }
+
+  export interface Warning {
+    /**
+     * Stable machine code identifying the advisory. Safe to switch on in client code.
+     */
+    code: 'PRELOAD_TOOLS_HIGH_CONTEXT_USAGE';
+
+    /**
+     * Human-readable description of the advisory. Suitable for logging or surfacing to
+     * end users.
+     */
+    message: string;
+  }
 }
 
 export interface SessionRetrieveResponse {
@@ -491,6 +579,12 @@ export interface SessionRetrieveResponse {
    */
   config: SessionRetrieveResponse.Config;
 
+  /**
+   * Monotonic version of the config. Incremented on each PATCH. Use for optimistic
+   * concurrency control.
+   */
+  config_version: number;
+
   mcp: SessionRetrieveResponse.Mcp;
 
   /**
@@ -514,6 +608,15 @@ export namespace SessionRetrieveResponse {
    * The session configuration including user, toolkits, and overrides
    */
   export interface Config {
+    /**
+     * Preload configuration. Controls which tools appear in `session.tools` and the
+     * MCP server tool list, callable directly without going through search. Each
+     * preloaded tool adds to the agent context — roughly ≤20 tools is recommended.
+     * Always present in the response (empty `tools: []` when the session was created
+     * without a preload config).
+     */
+    preload: Config.Preload;
+
     /**
      * User identifier for this session
      */
@@ -525,7 +628,8 @@ export namespace SessionRetrieveResponse {
     auth_configs?: { [key: string]: string };
 
     /**
-     * Connected account overrides per toolkit
+     * Connected account overrides per toolkit. Each connected account must belong to
+     * the same user_id as the session.
      */
     connected_accounts?: { [key: string]: string };
 
@@ -534,6 +638,11 @@ export namespace SessionRetrieveResponse {
      */
     manage_connections?: Config.ManageConnections;
 
+    /**
+     * Multi-account configuration for this session.
+     */
+    multi_account?: Config.MultiAccount;
+
     /**
      * MCP tool annotation hints for filtering tools with enabled/disabled support.
      * enabled: tags that the tool must have at least one of. disabled: tags that the
@@ -558,6 +667,22 @@ export namespace SessionRetrieveResponse {
   }
 
   export namespace Config {
+    /**
+     * Preload configuration. Controls which tools appear in `session.tools` and the
+     * MCP server tool list, callable directly without going through search. Each
+     * preloaded tool adds to the agent context — roughly ≤20 tools is recommended.
+     * Always present in the response (empty `tools: []` when the session was created
+     * without a preload config).
+     */
+    export interface Preload {
+      /**
+       * Tool slugs preloaded for this session. Appear in `session.tools` and the MCP
+       * server tool list, callable directly without going through search. Empty array
+       * when no preload was configured.
+       */
+      tools: Array<string>;
+    }
+
     /**
      * Manage connections configuration
      */
@@ -584,6 +709,29 @@ export namespace SessionRetrieveResponse {
       enabled?: boolean;
     }
 
+    /**
+     * Multi-account configuration for this session.
+     */
+    export interface MultiAccount {
+      /**
+       * When true, enables multi-account mode for this session. When not set, falls back
+       * to org/project-level configuration.
+       */
+      enable?: boolean;
+
+      /**
+       * Maximum number of connected accounts allowed per toolkit. Defaults to 5 when
+       * multi-account is enabled.
+       */
+      max_accounts_per_toolkit?: number;
+
+      /**
+       * When true, require explicit account selection when multiple accounts are
+       * connected. When false (default), use the first/default account.
+       */
+      require_explicit_selection?: boolean;
+    }
+
     /**
      * MCP tool annotation hints for filtering tools with enabled/disabled support.
      * enabled: tags that the tool must have at least one of. disabled: tags that the
@@ -655,6 +803,12 @@ export namespace SessionRetrieveResponse {
        * Whether proxy execution is enabled in the workbench
        */
       proxy_execution_enabled?: boolean;
+
+      /**
+       * Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4
+       * vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard.
+       */
+      sandbox_size?: 'standard' | 'medium' | 'large' | 'xlarge';
     }
   }
 
@@ -1456,7 +1610,9 @@ export interface SessionCreateParams {
   /**
    * The connected accounts to use for the session. This will override the default
    * behaviour and use the given connected account when specific toolkits are being
-   * executed
+   * executed. Each connected account must exist (not deleted or disabled) and belong
+   * to the same `user_id` as the session — otherwise session creation fails with a
+   * clear error explaining which account didn't match.
    */
   connected_accounts?: { [key: string]: string };
 
@@ -1477,6 +1633,18 @@ export interface SessionCreateParams {
    */
   multi_account?: SessionCreateParams.MultiAccount;
 
+  /**
+   * Preload configuration. Controls which tools appear in `session.tools` and the
+   * MCP server tool list so the agent can call them directly without going through
+   * search first — useful for frequently used tools. Each slug must be allowed by
+   * the session filters (`toolkits`, `tools`, `tags`), otherwise session creation
+   * fails with a 400. Custom tools declared in `custom_tools` / `custom_toolkits`
+   * can also be preloaded. Not supported when multi-account is enabled. Each
+   * preloaded tool adds to the agent context window, so keep the list at or under
+   * ~20 tools.
+   */
+  preload?: SessionCreateParams.Preload;
+
   /**
    * Global MCP tool annotation hints for filtering. Array format is treated as
    * enabled list. Object format supports both enabled (tool must have at least one)
@@ -1494,8 +1662,11 @@ export interface SessionCreateParams {
   toolkits?: SessionCreateParams.Enable | SessionCreateParams.Disable;
 
   /**
-   * Tool-level configuration per toolkit - either specify enable tools (whitelist),
-   * disable tools (blacklist), or filter by MCP tags for each toolkit
+   * Tool-level configuration per toolkit. Allows you to enable, disable, or filter
+   * by tags for specific tools within each toolkit. Every slug passed in `enable` /
+   * `disable` must be a valid Composio tool slug for that toolkit — invalid or
+   * typo'd slugs fail session creation with a clear error listing which ones didn't
+   * match.
    */
   tools?: {
     [key: string]: SessionCreateParams.Enable | SessionCreateParams.Disable | SessionCreateParams.Tags;
@@ -1687,15 +1858,29 @@ export namespace SessionCreateParams {
     require_explicit_selection?: boolean;
   }
 
-  export interface UnionMember1 {
+  /**
+   * Preload configuration. Controls which tools appear in `session.tools` and the
+   * MCP server tool list so the agent can call them directly without going through
+   * search first — useful for frequently used tools. Each slug must be allowed by
+   * the session filters (`toolkits`, `tools`, `tags`), otherwise session creation
+   * fails with a 400. Custom tools declared in `custom_tools` / `custom_toolkits`
+   * can also be preloaded. Not supported when multi-account is enabled. Each
+   * preloaded tool adds to the agent context window, so keep the list at or under
+   * ~20 tools.
+   */
+  export interface Preload {
     /**
-     * Tags that the tool must NOT have any of
+     * Tool slugs to preload. Each slug must be allowed by the session filters
+     * (`toolkits`, `tools`, `tags`) and exist either in the Composio tool catalog or
+     * in `custom_tools` / `custom_toolkits` — unknown or blocked slugs return a 400 at
+     * session creation.
      */
+    tools?: Array<string>;
+  }
+
+  export interface UnionMember1 {
     disable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
 
-    /**
-     * Tags that the tool must have at least one of
-     */
     enable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
   }
 
@@ -1743,14 +1928,8 @@ export namespace SessionCreateParams {
 
   export namespace Tags {
     export interface UnionMember1 {
-      /**
-       * Tags that the tool must NOT have any of
-       */
       disable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
 
-      /**
-       * Tags that the tool must have at least one of
-       */
       enable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
     }
   }
@@ -1777,12 +1956,19 @@ export namespace SessionCreateParams {
      * APIs directly.
      */
     enable_proxy_execution?: boolean;
+
+    /**
+     * Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4
+     * vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard.
+     */
+    sandbox_size?: 'standard' | 'medium' | 'large' | 'xlarge';
   }
 }
 
 export interface SessionExecuteParams {
   /**
-   * The unique slug identifier of the tool to execute
+   * The unique slug identifier of the tool to execute. Supports both meta tools and
+   * app tools exposed by the session.
    */
   tool_slug: string;
 
@@ -1827,6 +2013,12 @@ export interface SessionLinkParams {
    */
   toolkit: string;
 
+  /**
+   * A human-readable alias for this connected account. Must be unique per entity and
+   * toolkit within the project.
+   */
+  alias?: string;
+
   /**
    * URL where users will be redirected after completing auth
    */
@@ -2707,13 +2899,13 @@ export namespace SessionSearchParams {
   export interface Query {
     /**
      * The task or use case to search tools for. Provide a detailed description to get
-     * the best results.
+     * the best results. Max 1024 characters.
      */
     use_case: string;
 
     /**
      * Known field hints as key:value pairs (e.g., "channel_name:general,
-     * user_email:john@example.com")
+     * user_email:john@example.com"). Max 500 characters.
      */
     known_fields?: string;
   }

package/src/resources/tool-router/tool-router.ts

@@ -72,7 +72,7 @@ export interface ToolRouterCreateSessionResponse {
   chat_session_mcp_url: string;
 
   /**
-   * Generated session identifier
+   * Generated session identifier (prefixed with "trs\_")
    */
   session_id: string;
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.65'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.67'; // x-release-please-version