@composio/client 2.0.0-rc.10 → 2.0.0-rc.11

package/dist/{session-configs-DBYUrVm-.d.mts → session-configs-CipRvstF.d.mts}

@@ -281,18 +281,18 @@ type ToolRouterSessionV31ConfigHistoryListResponse = {
       toolkits?: {
         enabled: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<string>;
       } | {
         disabled: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<string>;
       } | {
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval: Array<string>;
       };
@@ -357,13 +357,13 @@ type ToolRouterSessionV31ConfigHistoryListResponse = {
         [key: string]: {
           enabled: Array<string>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
           disabled: Array<string>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
@@ -377,17 +377,17 @@ type ToolRouterSessionV31ConfigHistoryListResponse = {
              */
             disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
             /**
-             * Experimental: tool calls matched here pause until the user approves them.
+             * Tool calls matched here pause until the user approves them.
              */
             require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
           };
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval: Array<string>;
         };
@@ -405,7 +405,7 @@ type ToolRouterSessionV31ConfigHistoryListResponse = {
          */
         disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
       };
@@ -498,7 +498,11 @@ type ToolRouterSessionV31ConfigHistoryListResponse = {
   current_page: number;
   total_items: number;
 };
-type ToolRouterSessionExecuteCompleted = {
+type ExecuteCompleted = {
+  /**
+   * The tool ran and succeeded
+   */
+  result_type: 'completed';
   /**
    * Returned only when the session enables instant.return_instant_charge and a charge is available. Failed individual tool calls omit it. Multi-execute returns one aggregate of reported charges from eligible successful calls, even if another call fails.
    */
@@ -530,12 +534,12 @@ type ToolRouterSessionExecuteCompleted = {
    * Unique identifier for the execution log
    */
   log_id: string;
+};
+type ExecuteFailed = {
   /**
-   * The tool ran and succeeded
+   * The tool ran and failed, or the user did not approve it
    */
-  result_type: 'completed';
-};
-type ToolRouterSessionExecuteFailed = {
+  result_type: 'failed';
   /**
    * Returned only when the session enables instant.return_instant_charge and a charge is available. Failed individual tool calls omit it. Multi-execute returns one aggregate of reported charges from eligible successful calls, even if another call fails.
    */
@@ -567,44 +571,64 @@ type ToolRouterSessionExecuteFailed = {
    * Unique identifier for the execution log
    */
   log_id: string;
-  /**
-   * The tool ran and failed
-   */
-  result_type: 'failed';
 };
-type ToolRouterInputRequest = {
+/**
+ * A question for the user, in the shape of an MCP `elicitation/create` request in form mode (https://modelcontextprotocol.io/specification/2026-07-28/client/elicitation). Show `message` to the user and collect an answer that matches `requested_schema`.
+ */
+type UserInputRequest = {
   /**
-   * Kind of input requested
+   * Always `elicitation`
    */
   type: 'elicitation';
   /**
-   * How the client collects the input
+   * Always `form`: collect the answer with a form built from `requested_schema`
    */
   mode: 'form';
   /**
-   * Message to show the user
+   * Text to show the user
    */
   message: string;
   /**
-   * JSON Schema for the answer: a flat object with string, number, boolean or enum fields
+   * JSON Schema for the answer. As in MCP form mode, it is a flat object whose fields are strings, numbers, booleans, or single- or multi-select enums.
    */
   requested_schema: {
     [key: string]: unknown;
   };
 };
-type ToolRouterInputRequiredResponse = {
+/**
+ * The call needs the user's input before it runs. Returned only when the session is configured to ask for user approval before tool execution. Show each question in `input_requests` to the user, then repeat the same call with their answers in `input_responses`, along with this `request_state` if present.
+ */
+type ExecuteRequiresUserInput = {
+  /**
+   * The call needs the user's input before it runs
+   */
   result_type: 'input_required';
   /**
    * Questions for the user, keyed by an ID the answers must reuse
    */
   input_requests: {
-    [key: string]: ToolRouterInputRequest;
+    [key: string]: UserInputRequest;
   };
   /**
-   * Opaque state. If present, send it back unchanged with the answers
+   * Send this back unchanged in `request_state` with the answers
    */
   request_state?: string;
 };
+/**
+ * The user's answer to one question, in the shape of an MCP elicitation result (https://modelcontextprotocol.io/specification/2026-07-28/client/elicitation).
+ */
+type UserInputResponse = {
+  /**
+   * `accept` when the user submitted the form, `decline` when they said no, `cancel` when they dismissed it
+   */
+  action: 'accept' | 'decline' | 'cancel';
+  /**
+   * With `accept`, the user's answer: fields matching the question's `requested_schema`
+   */
+  content?: {
+    [key: string]: unknown;
+  };
+};
 type ComposioManagedAuthConfigCreate = {
   type: 'use_composio_managed_auth';
   /**
@@ -897,7 +921,11 @@ type PatchConnectedAccountBody = {
 type DeprecatedToolkitInfo = {
   toolkitId: string;
 };
-type ProxyExecuteForSessionCompleted = {
+type ProxyExecuteCompleted = {
+  /**
+   * The request was sent and the proxied API responded
+   */
+  result_type: 'completed';
   /**
    * The response data returned from the proxied API
    */
@@ -933,10 +961,6 @@ type ProxyExecuteForSessionCompleted = {
   headers?: {
     [key: string]: string;
   };
-  /**
-   * The request was sent and the proxied API responded
-   */
-  result_type: 'completed';
 };
 type ToolRouterToolkitsListResponse = {
   items: Array<{
@@ -2820,7 +2844,7 @@ type PostApiV31ToolRouterSessionData = {
        */
       enable: Array<string>;
       /**
-       * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+       * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
        */
       require_approval?: Array<string>;
     } | {
@@ -2829,12 +2853,12 @@ type PostApiV31ToolRouterSessionData = {
        */
       disable: Array<string>;
       /**
-       * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+       * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
        */
       require_approval?: Array<string>;
     } | {
       /**
-       * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+       * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
        */
       require_approval: Array<string>;
     };
@@ -2920,7 +2944,7 @@ type PostApiV31ToolRouterSessionData = {
          */
         enable: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+         * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
          */
         require_approval?: Array<string>;
       } | {
@@ -2929,7 +2953,7 @@ type PostApiV31ToolRouterSessionData = {
          */
         disable: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+         * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
          */
         require_approval?: Array<string>;
       } | {
@@ -2940,17 +2964,17 @@ type PostApiV31ToolRouterSessionData = {
           enable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
           disable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+           * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
            */
           require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
         };
         /**
-         * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+         * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
          */
         require_approval?: Array<string>;
       } | {
         /**
-         * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+         * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
          */
         require_approval: Array<string>;
       };
@@ -2962,7 +2986,7 @@ type PostApiV31ToolRouterSessionData = {
       enable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
       disable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
       /**
-       * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+       * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
        */
       require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
     };
@@ -3151,7 +3175,7 @@ type PostApiV31ToolRouterSessionData = {
         enable?: boolean;
       };
       /**
-       * Experimental: what session MCP does with a tool call that needs approval when the MCP client can't ask the user. deny (default) rejects the call; allow runs it without approval.
+       * What session MCP does with a tool call that needs approval when the MCP client can't ask the user. deny (default) rejects the call; allow runs it without approval.
        */
       no_elicitation_support_fallback?: 'deny' | 'allow';
       /**
@@ -3216,18 +3240,18 @@ type PostApiV31ToolRouterSessionResponses = {
       toolkits?: {
         enabled: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<string>;
       } | {
         disabled: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<string>;
       } | {
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval: Array<string>;
       };
@@ -3292,13 +3316,13 @@ type PostApiV31ToolRouterSessionResponses = {
         [key: string]: {
           enabled: Array<string>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
           disabled: Array<string>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
@@ -3312,17 +3336,17 @@ type PostApiV31ToolRouterSessionResponses = {
              */
             disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
             /**
-             * Experimental: tool calls matched here pause until the user approves them.
+             * Tool calls matched here pause until the user approves them.
              */
             require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
           };
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval: Array<string>;
         };
@@ -3340,7 +3364,7 @@ type PostApiV31ToolRouterSessionResponses = {
          */
         disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
       };
@@ -3573,18 +3597,18 @@ type GetApiV31ToolRouterSessionBySessionIdResponses = {
       toolkits?: {
         enabled: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<string>;
       } | {
         disabled: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<string>;
       } | {
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval: Array<string>;
       };
@@ -3649,13 +3673,13 @@ type GetApiV31ToolRouterSessionBySessionIdResponses = {
         [key: string]: {
           enabled: Array<string>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
           disabled: Array<string>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
@@ -3669,17 +3693,17 @@ type GetApiV31ToolRouterSessionBySessionIdResponses = {
              */
             disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
             /**
-             * Experimental: tool calls matched here pause until the user approves them.
+             * Tool calls matched here pause until the user approves them.
              */
             require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
           };
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval: Array<string>;
         };
@@ -3697,7 +3721,7 @@ type GetApiV31ToolRouterSessionBySessionIdResponses = {
          */
         disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
       };
@@ -3889,7 +3913,7 @@ type PatchApiV31ToolRouterSessionBySessionIdData = {
        */
       enable: Array<string>;
       /**
-       * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+       * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
        */
       require_approval?: Array<string>;
     } | {
@@ -3898,12 +3922,12 @@ type PatchApiV31ToolRouterSessionBySessionIdData = {
        */
       disable: Array<string>;
       /**
-       * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+       * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
        */
       require_approval?: Array<string>;
     } | {
       /**
-       * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+       * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
        */
       require_approval: Array<string>;
     };
@@ -3986,7 +4010,7 @@ type PatchApiV31ToolRouterSessionBySessionIdData = {
          */
         enable: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+         * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
          */
         require_approval?: Array<string>;
       } | {
@@ -3995,7 +4019,7 @@ type PatchApiV31ToolRouterSessionBySessionIdData = {
          */
         disable: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+         * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
          */
         require_approval?: Array<string>;
       } | {
@@ -4006,17 +4030,17 @@ type PatchApiV31ToolRouterSessionBySessionIdData = {
           enable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
           disable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+           * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
            */
           require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
         };
         /**
-         * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+         * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
          */
         require_approval?: Array<string>;
       } | {
         /**
-         * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+         * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
          */
         require_approval: Array<string>;
       };
@@ -4028,7 +4052,7 @@ type PatchApiV31ToolRouterSessionBySessionIdData = {
       enable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
       disable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
       /**
-       * Experimental: tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
+       * Tool calls matched here pause until the user approves them. A tool needs approval if its toolkit, the tool itself or any of its tags is listed.
        */
       require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
     };
@@ -4123,7 +4147,7 @@ type PatchApiV31ToolRouterSessionBySessionIdData = {
         enable: boolean;
       };
       /**
-       * Experimental: what session MCP does with a tool call that needs approval when the MCP client can't ask the user. deny (default) rejects the call; allow runs it without approval.
+       * What session MCP does with a tool call that needs approval when the MCP client can't ask the user. deny (default) rejects the call; allow runs it without approval.
        */
       no_elicitation_support_fallback?: 'deny' | 'allow';
       /**
@@ -4178,18 +4202,18 @@ type PatchApiV31ToolRouterSessionBySessionIdResponses = {
       toolkits?: {
         enabled: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<string>;
       } | {
         disabled: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<string>;
       } | {
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval: Array<string>;
       };
@@ -4254,13 +4278,13 @@ type PatchApiV31ToolRouterSessionBySessionIdResponses = {
         [key: string]: {
           enabled: Array<string>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
           disabled: Array<string>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
@@ -4274,17 +4298,17 @@ type PatchApiV31ToolRouterSessionBySessionIdResponses = {
              */
             disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
             /**
-             * Experimental: tool calls matched here pause until the user approves them.
+             * Tool calls matched here pause until the user approves them.
              */
             require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
           };
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval: Array<string>;
         };
@@ -4302,7 +4326,7 @@ type PatchApiV31ToolRouterSessionBySessionIdResponses = {
          */
         disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
       };
@@ -4628,18 +4652,18 @@ type PostApiV31ToolRouterSessionBySessionIdAttachResponses = {
       toolkits?: {
         enabled: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<string>;
       } | {
         disabled: Array<string>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<string>;
       } | {
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval: Array<string>;
       };
@@ -4704,13 +4728,13 @@ type PostApiV31ToolRouterSessionBySessionIdAttachResponses = {
         [key: string]: {
           enabled: Array<string>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
           disabled: Array<string>;
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
@@ -4724,17 +4748,17 @@ type PostApiV31ToolRouterSessionBySessionIdAttachResponses = {
              */
             disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
             /**
-             * Experimental: tool calls matched here pause until the user approves them.
+             * Tool calls matched here pause until the user approves them.
              */
             require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
           };
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval?: Array<string>;
         } | {
           /**
-           * Experimental: tool calls matched here pause until the user approves them.
+           * Tool calls matched here pause until the user approves them.
            */
           require_approval: Array<string>;
         };
@@ -4752,7 +4776,7 @@ type PostApiV31ToolRouterSessionBySessionIdAttachResponses = {
          */
         disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
         /**
-         * Experimental: tool calls matched here pause until the user approves them.
+         * Tool calls matched here pause until the user approves them.
          */
         require_approval?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
       };
@@ -5402,13 +5426,13 @@ type PostApiV31ToolRouterSessionBySessionIdExecuteData = {
      */
     enable_auto_workbench_offload?: boolean;
     /**
-     * Experimental: the user's answers to the questions an earlier response asked, keyed by the same ids. Send them with the same tool call to continue it.
+     * The user's answers to an `input_required` response, keyed by the ids in its `input_requests`. Send them by repeating the same call (same tool and arguments) with this field added, along with the response's `request_state` if present. An approved call runs; a denied or declined one returns `failed`.
      */
     input_responses?: {
-      [key: string]: unknown;
+      [key: string]: UserInputResponse;
     };
     /**
-     * Experimental: state from an earlier response that asked the user for input, sent back unchanged.
+     * The `request_state` from the `input_required` response, sent back unchanged with `input_responses`.
      */
     request_state?: string;
     /**
@@ -5519,15 +5543,15 @@ type PostApiV31ToolRouterSessionBySessionIdExecuteData = {
 };
 type PostApiV31ToolRouterSessionBySessionIdExecuteResponses = {
   /**
-   * Successfully executed the tool. Returns execution result, logs, and status.
+   * The tool call completed, failed, or needs the user's input before it can run. The `result_type` field says which of these happened.
    */
   200: ({
     result_type: 'completed';
-  } & ToolRouterSessionExecuteCompleted) | ({
+  } & ExecuteCompleted) | ({
     result_type: 'failed';
-  } & ToolRouterSessionExecuteFailed) | ({
+  } & ExecuteFailed) | ({
     result_type: 'input_required';
-  } & ToolRouterInputRequiredResponse);
+  } & ExecuteRequiresUserInput);
 };
 type PostApiV31ToolRouterSessionBySessionIdExecuteMetaData = {
   body?: {
@@ -5542,13 +5566,13 @@ type PostApiV31ToolRouterSessionBySessionIdExecuteMetaData = {
       [key: string]: unknown;
     };
     /**
-     * Experimental: the user's answers to the questions an earlier response asked, keyed by the same ids. Send them with the same tool call to continue it.
+     * The user's answers to an `input_required` response, keyed by the ids in its `input_requests`. Send them by repeating the same call (same tool and arguments) with this field added, along with the response's `request_state` if present. An approved call runs; a denied or declined one returns `failed`.
      */
     input_responses?: {
-      [key: string]: unknown;
+      [key: string]: UserInputResponse;
     };
     /**
-     * Experimental: state from an earlier response that asked the user for input, sent back unchanged.
+     * The `request_state` from the `input_required` response, sent back unchanged with `input_responses`.
      */
     request_state?: string;
     /**
@@ -5659,15 +5683,15 @@ type PostApiV31ToolRouterSessionBySessionIdExecuteMetaData = {
 };
 type PostApiV31ToolRouterSessionBySessionIdExecuteMetaResponses = {
   /**
-   * Successfully executed the meta tool. Returns execution result, logs, and status.
+   * The tool call completed, failed, or needs the user's input before it can run. The `result_type` field says which of these happened.
    */
   200: ({
     result_type: 'completed';
-  } & ToolRouterSessionExecuteCompleted) | ({
+  } & ExecuteCompleted) | ({
     result_type: 'failed';
-  } & ToolRouterSessionExecuteFailed) | ({
+  } & ExecuteFailed) | ({
     result_type: 'input_required';
-  } & ToolRouterInputRequiredResponse);
+  } & ExecuteRequiresUserInput);
 };
 type PostApiV31OrgUsageSummaryData = {
   body?: {
@@ -21091,6 +21115,17 @@ type PostApiV31OrgOwnerProjectNewData = {
      * Whether to create an API key for the project. If true, the API key will be created and returned in the response.
      */
     should_create_api_key?: boolean;
+    /**
+     * IPv4 or IPv6 addresses allowed to use the project API key. Requires should_create_api_key to be true. Omit to allow requests from any IP address.
+     */
+    api_key_allowed_ips?: Array<string>;
+    /**
+     * Permission levels for the project API key. Requires should_create_api_key to be true. Omit to create a full-access API key.
+     */
+    api_key_permissions?: Array<{
+      preset: 'tools' | 'tool_execution' | 'proxy_execute' | 'session_management' | 'session_tool_execution' | 'legacy_mcp' | 'connected_accounts' | 'auth_configs' | 'toolkits' | 'triggers' | 'webhooks' | 'observability' | 'sessions';
+      access: 'none' | 'read' | 'write' | 'read_write';
+    }>;
     /**
      * Configuration for the project. Use zdr_enabled for Zero Data Retention; log_visibility_setting remains supported for existing clients. Do not send both fields.
      */
@@ -24721,9 +24756,9 @@ type PostApiV31ToolRouterSessionBySessionIdProxyExecuteResponses = {
    */
   200: ({
     result_type: 'completed';
-  } & ProxyExecuteForSessionCompleted) | ({
+  } & ProxyExecuteCompleted) | ({
     result_type: 'input_required';
-  } & ToolRouterInputRequiredResponse);
+  } & ExecuteRequiresUserInput);
 };
 type GetApiV31ToolRouterSessionBySessionIdToolkitsData = {
   body?: never;
@@ -25248,6 +25283,7 @@ declare namespace SessionExecuteParams {
       type Tool = CustomToolkit['tools'][number];
     }
   }
+  type InputResponses = NonNullable<SessionExecuteParamsGen['input_responses']>[string];
 }
 type SessionExecuteMetaParamsGen = NonNullable<PostApiV31ToolRouterSessionBySessionIdExecuteMetaData['body']>;
 interface SessionExecuteMetaParams extends SessionExecuteMetaParamsGen {}
@@ -25260,6 +25296,7 @@ declare namespace SessionExecuteMetaParams {
       type Tool = CustomToolkit['tools'][number];
     }
   }
+  type InputResponses = NonNullable<SessionExecuteMetaParamsGen['input_responses']>[string];
 }
 type SessionLinkParamsGen = NonNullable<PostApiV31ToolRouterSessionBySessionIdLinkData['body']>;
 interface SessionLinkParams extends SessionLinkParamsGen {}
@@ -26614,6 +26651,7 @@ declare namespace WebhookEndpoints {
 type ProjectCreateParamsGen = NonNullable<PostApiV31OrgOwnerProjectNewData['body']>;
 interface ProjectCreateParams extends ProjectCreateParamsGen {}
 declare namespace ProjectCreateParams {
+  type ApiKeyPermission = NonNullable<ProjectCreateParamsGen['api_key_permissions']>[number];
   type Config = NonNullable<ProjectCreateParamsGen['config']>;
 }
 type ProjectListParamsGen$1 = NonNullable<GetApiV31OrgOwnerProjectListData['query']>;