@labelbox/recursion-sdk 0.0.166 → 0.0.167

package/dist/generated/sdk.gen.d.ts

@@ -37,7 +37,7 @@ export declare class ManagedAgents extends HeyApiClient {
     /**
      * Create an agent and immutable version
      *
-     * Creates an agent and its first immutable version, and returns the agent resolved to that version. Exactly one of model or model_ref_id is required alongside name and system. The body is also accepted as application/x-yaml with the same schema. Any vault named in default_vault_ids must already exist.
+     * Creates an agent and its first immutable version, and returns the agent resolved to that version. Exactly one of model or model_ref_id is required alongside name and system. The body is also accepted as application/x-yaml with the same schema. Any vault named in default_vault_ids must already exist. Invalid model_config and unsupported reasoning_effort values return 400, including when a reachable gateway model publishes no exact options; an unconfigured or unreachable gateway that prevents verification returns 503.
      */
     createAgent<ThrowOnError extends boolean = false>(parameters?: {
         body?: ManagedAgentsCreateAgentRequest;
@@ -61,7 +61,7 @@ export declare class ManagedAgents extends HeyApiClient {
     /**
      * Update agent and create a new immutable version
      *
-     * Applies a partial update and returns the agent resolved to the new version. Agent versions are immutable, so every accepted update mints a new one rather than editing history; omitted fields keep their current values. Running sessions keep the version they started with.
+     * Applies a partial update and returns the agent resolved to the new version. Agent versions are immutable, so every accepted update mints a new one rather than editing history; omitted fields keep their current values. Running sessions keep the version they started with. Invalid model_config and unsupported new or changed reasoning_effort values return 400, including when a reachable gateway model publishes no exact options; an unconfigured or unreachable gateway that prevents verification returns 503.
      */
     updateAgent<ThrowOnError extends boolean = false>(parameters: {
         agent_id: string;
@@ -488,7 +488,7 @@ export declare class ManagedAgents extends HeyApiClient {
     /**
      * Start a managed session
      *
-     * Starts a managed agent session and returns 202 with its session_id and status_path; the agent runs asynchronously, so poll getSession or subscribe with streamSessionEvents to follow it. Sandbox compute is provisioned here, which is where a session begins costing money. Send an Idempotency-Key header to make retries safe: the same key with the same body returns the original session, and with a different body is rejected.
+     * Starts a managed agent session and returns 202 with its session_id and status_path; the agent runs asynchronously, so poll getSession or subscribe with streamSessionEvents to follow it. Sandbox compute is provisioned here, which is where a session begins costing money. Send an Idempotency-Key header to make retries safe: the same key with the same body returns the original session, and with a different body is rejected. A reasoning_effort incompatible with the selected model or its frozen output capacity returns 400 before provisioning; a temporarily unavailable model reference or catalog dependency returns 503.
      */
     startSession<ThrowOnError extends boolean = false>(parameters?: {
         'Idempotency-Key'?: string;

package/dist/generated/sdk.gen.js

@@ -40,7 +40,7 @@ export class ManagedAgents extends HeyApiClient {
     /**
      * Create an agent and immutable version
      *
-     * Creates an agent and its first immutable version, and returns the agent resolved to that version. Exactly one of model or model_ref_id is required alongside name and system. The body is also accepted as application/x-yaml with the same schema. Any vault named in default_vault_ids must already exist.
+     * Creates an agent and its first immutable version, and returns the agent resolved to that version. Exactly one of model or model_ref_id is required alongside name and system. The body is also accepted as application/x-yaml with the same schema. Any vault named in default_vault_ids must already exist. Invalid model_config and unsupported reasoning_effort values return 400, including when a reachable gateway model publishes no exact options; an unconfigured or unreachable gateway that prevents verification returns 503.
      */
     createAgent(parameters, options) {
         const params = buildClientParams([parameters], [{ args: [{ key: 'body', map: 'body' }] }]);
@@ -90,7 +90,7 @@ export class ManagedAgents extends HeyApiClient {
     /**
      * Update agent and create a new immutable version
      *
-     * Applies a partial update and returns the agent resolved to the new version. Agent versions are immutable, so every accepted update mints a new one rather than editing history; omitted fields keep their current values. Running sessions keep the version they started with.
+     * Applies a partial update and returns the agent resolved to the new version. Agent versions are immutable, so every accepted update mints a new one rather than editing history; omitted fields keep their current values. Running sessions keep the version they started with. Invalid model_config and unsupported new or changed reasoning_effort values return 400, including when a reachable gateway model publishes no exact options; an unconfigured or unreachable gateway that prevents verification returns 503.
      */
     updateAgent(parameters, options) {
         const params = buildClientParams([parameters], [{ args: [{ in: 'path', key: 'agent_id' }, { key: 'body', map: 'body' }] }]);
@@ -929,7 +929,7 @@ export class ManagedAgents extends HeyApiClient {
     /**
      * Start a managed session
      *
-     * Starts a managed agent session and returns 202 with its session_id and status_path; the agent runs asynchronously, so poll getSession or subscribe with streamSessionEvents to follow it. Sandbox compute is provisioned here, which is where a session begins costing money. Send an Idempotency-Key header to make retries safe: the same key with the same body returns the original session, and with a different body is rejected.
+     * Starts a managed agent session and returns 202 with its session_id and status_path; the agent runs asynchronously, so poll getSession or subscribe with streamSessionEvents to follow it. Sandbox compute is provisioned here, which is where a session begins costing money. Send an Idempotency-Key header to make retries safe: the same key with the same body returns the original session, and with a different body is rejected. A reasoning_effort incompatible with the selected model or its frozen output capacity returns 400 before provisioning; a temporarily unavailable model reference or catalog dependency returns 503.
      */
     startSession(parameters, options) {
         const params = buildClientParams([parameters], [{ args: [{ in: 'headers', key: 'Idempotency-Key' }, { key: 'body', map: 'body' }] }]);

package/dist/generated/types.gen.d.ts

@@ -8982,6 +8982,10 @@ export type ManagedAgentsGatewayModel = {
      * Whether the gateway can stream responses for this model. False means turns are only available as a single complete response.
      */
     streaming?: boolean;
+    /**
+     * Exact reasoning_effort strings LiteLLM reports for this model group. Omitted means unknown; [] means no explicit effort is supported; a non-empty list is exhaustive. Omit reasoning_effort to use the provider's current default.
+     */
+    supported_reasoning_efforts?: unknown;
     /**
      * Whether the gateway reports that this exact model accepts user image content on its configured wire.
      */
@@ -9015,7 +9019,7 @@ export type ManagedAgentsInferenceConfig = {
         [key: string]: unknown;
     };
     /**
-     * Thinking-budget hint for reasoning-capable models, e.g. low, medium, or high. Ignored by models that do not support reasoning.
+     * Provider-native reasoning depth value. For gateway models, use one of supported_reasoning_efforts from the models catalog; omit it to follow the provider's current default.
      */
     reasoning_effort?: string;
     /**

package/dist/reference/resources-reference.generated.js

@@ -2671,7 +2671,7 @@ export const RESOURCE_REFERENCE = {
                             name: 'reasoning_effort',
                             required: false,
                             type: 'string',
-                            description: 'Thinking-budget hint for reasoning-capable models, e.g. low, medium, or high. Ignored by models that do not support reasoning.',
+                            description: "Provider-native reasoning depth value. For gateway models, use one of supported_reasoning_efforts from the models catalog; omit it to follow the provider's current default.",
                         },
                         {
                             name: 'response_format',

package/dist/reference/sdk-reference.generated.js

@@ -44872,7 +44872,7 @@ export const SDK_REFERENCE = {
         cliExample: "rl managed-agents create-agent \\\n  --name 'example-name' \\\n  --system 'example' \\\n  --from-json body.json",
         curlExample: 'curl -X POST \'https://api.recursion.labelbox.com/managed-agents/v1/agents\' \\\n  -H \'Authorization: Bearer $LABELBOX_API_KEY\' \\\n  -H \'Content-Type: application/json\' \\\n  -d \'{\n    "custom_tools": [\n      {\n        "config": {\n          "key": "example"\n        },\n        "name": "example-name",\n        "type": "example"\n      }\n    ],\n    "default_credential_refs": [\n      {\n        "credential_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n        "vault_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"\n      }\n    ],\n    "default_rubric": "example",\n    "default_vault_ids": [\n      "example"\n    ],\n    "description": "example",\n    "mcp_servers": [\n      {\n        "key": "example"\n      }\n    ],\n    "metadata": {\n      "key": "example"\n    },\n    "model": "example",\n    "model_config": {\n      "max_tokens": 1,\n      "provider_params": {\n        "key": "example"\n      },\n      "reasoning_effort": "example",\n      "response_format": "example",\n      "temperature": 1.5,\n      "tool_choice": "example",\n      "top_p": 1.5\n    },\n    "model_ref_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n    "multiagent": {\n      "key": "example"\n    },\n    "name": "example-name",\n    "runtime_adapters": [\n      {\n        "key": "example"\n      }\n    ],\n    "skills": [\n      {\n        "key": "example"\n      }\n    ],\n    "system": "example",\n    "tools": [\n      {\n        "config": {\n          "key": "example"\n        },\n        "name": "example-name",\n        "type": "example"\n      }\n    ],\n    "toolsets": [\n      {\n        "config": {\n          "key": "example"\n        },\n        "name": "example-name",\n        "type": "example"\n      }\n    ],\n    "web_search_enabled": true\n  }\'',
         summary: 'Create an agent and immutable version',
-        description: 'Creates an agent and its first immutable version, and returns the agent resolved to that version. Exactly one of model or model_ref_id is required alongside name and system. The body is also accepted as application/x-yaml with the same schema. Any vault named in default_vault_ids must already exist.',
+        description: 'Creates an agent and its first immutable version, and returns the agent resolved to that version. Exactly one of model or model_ref_id is required alongside name and system. The body is also accepted as application/x-yaml with the same schema. Any vault named in default_vault_ids must already exist. Invalid model_config and unsupported reasoning_effort values return 400, including when a reachable gateway model publishes no exact options; an unconfigured or unreachable gateway that prevents verification returns 503.',
         httpMethod: 'post',
         path: '/managed-agents/v1/agents',
         requiredPermissions: ['managed-agents:create'],
@@ -44980,7 +44980,7 @@ export const SDK_REFERENCE = {
                 in: 'body',
                 required: false,
                 type: 'ManagedAgentsInferenceConfig',
-                description: 'Default inference config applied to sessions started from this agent.',
+                description: "Default inference config applied to sessions started from this agent. Omit model_config or send {} to use provider defaults; null is invalid. reasoning_effort is normalized and validated for direct providers, and must exactly match the selected gateway model's published options. An unsupported value, including a reachable gateway model that publishes no exact options, returns 400; an unconfigured or unreachable gateway that prevents verification returns 503.",
                 fields: [
                     {
                         name: 'max_tokens',
@@ -44999,7 +44999,7 @@ export const SDK_REFERENCE = {
                         name: 'reasoning_effort',
                         required: false,
                         type: 'string',
-                        description: 'Thinking-budget hint for reasoning-capable models, e.g. low, medium, or high. Ignored by models that do not support reasoning.',
+                        description: "Provider-native reasoning depth value. For gateway models, use one of supported_reasoning_efforts from the models catalog; omit it to follow the provider's current default.",
                     },
                     {
                         name: 'response_format',
@@ -45234,7 +45234,7 @@ export const SDK_REFERENCE = {
                             name: 'reasoning_effort',
                             required: false,
                             type: 'string',
-                            description: 'Thinking-budget hint for reasoning-capable models, e.g. low, medium, or high. Ignored by models that do not support reasoning.',
+                            description: "Provider-native reasoning depth value. For gateway models, use one of supported_reasoning_efforts from the models catalog; omit it to follow the provider's current default.",
                         },
                         {
                             name: 'response_format',
@@ -48639,7 +48639,7 @@ export const SDK_REFERENCE = {
                             name: 'reasoning_effort',
                             required: false,
                             type: 'string',
-                            description: 'Thinking-budget hint for reasoning-capable models, e.g. low, medium, or high. Ignored by models that do not support reasoning.',
+                            description: "Provider-native reasoning depth value. For gateway models, use one of supported_reasoning_efforts from the models catalog; omit it to follow the provider's current default.",
                         },
                         {
                             name: 'response_format',
@@ -49025,7 +49025,7 @@ export const SDK_REFERENCE = {
                             name: 'reasoning_effort',
                             required: false,
                             type: 'string',
-                            description: 'Thinking-budget hint for reasoning-capable models, e.g. low, medium, or high. Ignored by models that do not support reasoning.',
+                            description: "Provider-native reasoning depth value. For gateway models, use one of supported_reasoning_efforts from the models catalog; omit it to follow the provider's current default.",
                         },
                         {
                             name: 'response_format',
@@ -55184,7 +55184,7 @@ export const SDK_REFERENCE = {
         cliExample: "rl managed-agents start-session \\\n  --agent_id '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d' \\\n  --environment_id '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d' \\\n  --from-json body.json",
         curlExample: 'curl -X POST \'https://api.recursion.labelbox.com/managed-agents/v1/sessions\' \\\n  -H \'Authorization: Bearer $LABELBOX_API_KEY\' \\\n  -H \'Content-Type: application/json\' \\\n  -d \'{\n    "agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n    "credential_refs": [\n      {\n        "credential_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n        "vault_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"\n      }\n    ],\n    "environment_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n    "external_source_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n    "external_source_type": "example",\n    "idempotency_key": "example",\n    "message": "example",\n    "metadata": {\n      "key": "example"\n    },\n    "outcome": {\n      "description": "example",\n      "grader_model_ref_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n      "max_iterations": 1,\n      "rubric": "example"\n    },\n    "project_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n    "skip_default_outcome": true,\n    "vault_ids": [\n      "example"\n    ]\n  }\'',
         summary: 'Start a managed session',
-        description: 'Starts a managed agent session and returns 202 with its session_id and status_path; the agent runs asynchronously, so poll getSession or subscribe with streamSessionEvents to follow it. Sandbox compute is provisioned here, which is where a session begins costing money. Send an Idempotency-Key header to make retries safe: the same key with the same body returns the original session, and with a different body is rejected.',
+        description: 'Starts a managed agent session and returns 202 with its session_id and status_path; the agent runs asynchronously, so poll getSession or subscribe with streamSessionEvents to follow it. Sandbox compute is provisioned here, which is where a session begins costing money. Send an Idempotency-Key header to make retries safe: the same key with the same body returns the original session, and with a different body is rejected. A reasoning_effort incompatible with the selected model or its frozen output capacity returns 400 before provisioning; a temporarily unavailable model reference or catalog dependency returns 503.',
         httpMethod: 'post',
         path: '/managed-agents/v1/sessions',
         requiredPermissions: ['managed-agents:create'],
@@ -55351,7 +55351,7 @@ export const SDK_REFERENCE = {
         cliExample: 'rl managed-agents update-agent \\\n  --agent_id <agent_id> \\\n  --from-json body.json',
         curlExample: 'curl -X PATCH \'https://api.recursion.labelbox.com/managed-agents/v1/agents/<agent_id>\' \\\n  -H \'Authorization: Bearer $LABELBOX_API_KEY\' \\\n  -H \'Content-Type: application/json\' \\\n  -d \'{\n    "agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n    "created_at": "2026-02-18T09:30:00Z",\n    "custom_tools": [\n      {\n        "config": {\n          "key": "example"\n        },\n        "name": "example-name",\n        "type": "example"\n      }\n    ],\n    "default_credential_refs": [\n      {\n        "credential_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n        "vault_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"\n      }\n    ],\n    "default_rubric": "example",\n    "default_vault_ids": [\n      "example"\n    ],\n    "description": "example",\n    "latest_agent_version_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n    "mcp_servers": [\n      {\n        "key": "example"\n      }\n    ],\n    "metadata": {\n      "key": "example"\n    },\n    "model": "example",\n    "model_config": {\n      "max_tokens": 1,\n      "provider_params": {\n        "key": "example"\n      },\n      "reasoning_effort": "example",\n      "response_format": "example",\n      "temperature": 1.5,\n      "tool_choice": "example",\n      "top_p": 1.5\n    },\n    "model_ref_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n    "multiagent": {\n      "key": "example"\n    },\n    "name": "example-name",\n    "organization_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n    "runtime_adapters": [\n      {\n        "key": "example"\n      }\n    ],\n    "skills": [\n      {\n        "key": "example"\n      }\n    ],\n    "system": "example",\n    "toolsets": [\n      {\n        "config": {\n          "key": "example"\n        },\n        "name": "example-name",\n        "type": "example"\n      }\n    ],\n    "updated_at": "2026-02-18T09:30:00Z",\n    "web_search_enabled": true\n  }\'',
         summary: 'Update agent and create a new immutable version',
-        description: 'Applies a partial update and returns the agent resolved to the new version. Agent versions are immutable, so every accepted update mints a new one rather than editing history; omitted fields keep their current values. Running sessions keep the version they started with.',
+        description: 'Applies a partial update and returns the agent resolved to the new version. Agent versions are immutable, so every accepted update mints a new one rather than editing history; omitted fields keep their current values. Running sessions keep the version they started with. Invalid model_config and unsupported new or changed reasoning_effort values return 400, including when a reachable gateway model publishes no exact options; an unconfigured or unreachable gateway that prevents verification returns 503.',
         httpMethod: 'patch',
         path: '/managed-agents/v1/agents/{agent_id}',
         requiredPermissions: ['managed-agents:update'],
@@ -55447,7 +55447,7 @@ export const SDK_REFERENCE = {
                 in: 'body',
                 required: false,
                 type: 'ManagedAgentsInferenceConfig',
-                description: 'Default inference settings applied to every turn unless a session overrides them.',
+                description: "Default inference config for the new version. Omit model_config to preserve the current config; send {} to clear the entire config and use provider defaults; null is invalid. reasoning_effort is normalized and validated for direct providers, and must exactly match the selected gateway model's published options. An unsupported new or changed value, including a reachable gateway model that publishes no exact options, returns 400; an unconfigured or unreachable gateway that prevents verification returns 503.",
                 fields: [
                     {
                         name: 'max_tokens',
@@ -55466,7 +55466,7 @@ export const SDK_REFERENCE = {
                         name: 'reasoning_effort',
                         required: false,
                         type: 'string',
-                        description: 'Thinking-budget hint for reasoning-capable models, e.g. low, medium, or high. Ignored by models that do not support reasoning.',
+                        description: "Provider-native reasoning depth value. For gateway models, use one of supported_reasoning_efforts from the models catalog; omit it to follow the provider's current default.",
                     },
                     {
                         name: 'response_format',
@@ -55661,7 +55661,7 @@ export const SDK_REFERENCE = {
                             name: 'reasoning_effort',
                             required: false,
                             type: 'string',
-                            description: 'Thinking-budget hint for reasoning-capable models, e.g. low, medium, or high. Ignored by models that do not support reasoning.',
+                            description: "Provider-native reasoning depth value. For gateway models, use one of supported_reasoning_efforts from the models catalog; omit it to follow the provider's current default.",
                         },
                         {
                             name: 'response_format',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@labelbox/recursion-sdk",
-  "version": "0.0.166",
+  "version": "0.0.167",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",