@labelbox/recursion-sdk 0.0.166 → 0.0.168

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',
@@ -51421,6 +51421,69 @@ export const SDK_REFERENCE = {
             ],
         },
     },
+    managedAgentsGetSessionBudget: {
+        operationId: 'managedAgentsGetSessionBudget',
+        tag: 'managed-agents',
+        callPath: ['managedAgents', 'getSessionBudget'],
+        namespace: 'managedAgents',
+        method: 'getSessionBudget',
+        signature: 'rl.managedAgents.getSessionBudget({ session_id })',
+        example: "const result = await rl.managedAgents.getSessionBudget({\n  session_id: '<session_id>',\n});",
+        cliInvocation: 'rl managed-agents get-session-budget',
+        cliExample: 'rl managed-agents get-session-budget \\\n  --session_id <session_id>',
+        curlExample: "curl -X GET 'https://api.recursion.labelbox.com/managed-agents/v1/sessions/<session_id>/budget' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
+        summary: "Get the session tree's model-cost cap",
+        description: "Returns the cost cap the session's tree runs under and how much of it is spent. Any session in the tree may be named; the cap belongs to the root. A tree whose agent declared no multiagent.limits.max_tree_cost_usd and was never given a cap here has no budget and answers 404.",
+        httpMethod: 'get',
+        path: '/managed-agents/v1/sessions/{session_id}/budget',
+        requiredPermissions: ['managed-agents:read'],
+        params: [
+            {
+                name: 'session_id',
+                in: 'path',
+                required: true,
+                type: 'string',
+                description: 'Session id (UUID) as returned by startSession or listSessions.',
+                format: 'uuid',
+            },
+        ],
+        response: {
+            type: 'ManagedAgentsSessionBudgetResponse',
+            description: 'The model-cost cap of one session tree and how much of it is spent. The cap is enforced between model requests, never mid-request, so the overshoot is bounded by one request per running session.',
+            fields: [
+                {
+                    name: 'consumed_cost_usd',
+                    required: false,
+                    type: 'string',
+                    description: 'Model cost the tree has been charged so far, as a decimal USD string, maintained as charges land.',
+                },
+                {
+                    name: 'exhausted',
+                    required: false,
+                    type: 'boolean',
+                    description: 'True when consumed cost has reached the cap. Sessions in the tree stop with stop_reason budget_reached at their next turn boundary and stay idle until the cap is raised.',
+                },
+                {
+                    name: 'max_tree_cost_usd',
+                    required: false,
+                    type: 'string',
+                    description: 'The cap as a decimal USD string. Absent when the budget row carries no cost cap.',
+                },
+                {
+                    name: 'resumed_session_ids',
+                    required: false,
+                    type: 'string[]',
+                    description: 'On a write, the sessions that had stopped at the old cap and were sent a resume message because the new cap leaves room. Absent on a read, and when nothing was waiting.',
+                },
+                {
+                    name: 'root_session_id',
+                    required: false,
+                    type: 'string',
+                    description: 'Root session the cap belongs to (UUID). Every session in the tree draws on the same amount.',
+                },
+            ],
+        },
+    },
     managedAgentsGetSessionEventContent: {
         operationId: 'managedAgentsGetSessionEventContent',
         tag: 'managed-agents',
@@ -55018,6 +55081,77 @@ export const SDK_REFERENCE = {
             },
         ],
     },
+    managedAgentsSetSessionBudget: {
+        operationId: 'managedAgentsSetSessionBudget',
+        tag: 'managed-agents',
+        callPath: ['managedAgents', 'setSessionBudget'],
+        namespace: 'managedAgents',
+        method: 'setSessionBudget',
+        bodyKey: 'body',
+        signature: 'rl.managedAgents.setSessionBudget({ session_id, body })',
+        example: 'const result = await rl.managedAgents.setSessionBudget({\n  session_id: \'<session_id>\',\n  body: {\n    max_tree_cost_usd: "example"\n  },\n});',
+        cliInvocation: 'rl managed-agents set-session-budget',
+        cliExample: 'rl managed-agents set-session-budget \\\n  --session_id <session_id> \\\n  --from-json body.json',
+        curlExample: "curl -X PUT 'https://api.recursion.labelbox.com/managed-agents/v1/sessions/<session_id>/budget' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"max_tree_cost_usd\": \"example\"\n  }'",
+        summary: "Set or raise the session tree's model-cost cap",
+        description: 'Sets the model-cost cap for the whole session tree; any session in the tree may be named. A tree that stopped with stop_reason budget_reached resumes when the new cap leaves room: every stopped session in the tree is sent a message saying so and takes its next turn, and resumed_session_ids lists them. A cap below what is already spent stops the tree at its next turn boundary. The cap is checked between model requests, so one in-flight request per running session may still complete after it is reached.',
+        httpMethod: 'put',
+        path: '/managed-agents/v1/sessions/{session_id}/budget',
+        requiredPermissions: ['managed-agents:update'],
+        params: [
+            {
+                name: 'session_id',
+                in: 'path',
+                required: true,
+                type: 'string',
+                description: 'Session id (UUID) as returned by startSession or listSessions.',
+                format: 'uuid',
+            },
+            {
+                name: 'max_tree_cost_usd',
+                in: 'body',
+                required: false,
+                type: 'string',
+                description: 'New model-cost cap for the whole session tree, as a decimal USD string such as "25" or "12.50". Must be positive. Lower than what is already spent stops the tree at its next turn boundary; higher than what is spent wakes every session that had stopped at the old cap.',
+            },
+        ],
+        response: {
+            type: 'ManagedAgentsSessionBudgetResponse',
+            description: 'The model-cost cap of one session tree and how much of it is spent. The cap is enforced between model requests, never mid-request, so the overshoot is bounded by one request per running session.',
+            fields: [
+                {
+                    name: 'consumed_cost_usd',
+                    required: false,
+                    type: 'string',
+                    description: 'Model cost the tree has been charged so far, as a decimal USD string, maintained as charges land.',
+                },
+                {
+                    name: 'exhausted',
+                    required: false,
+                    type: 'boolean',
+                    description: 'True when consumed cost has reached the cap. Sessions in the tree stop with stop_reason budget_reached at their next turn boundary and stay idle until the cap is raised.',
+                },
+                {
+                    name: 'max_tree_cost_usd',
+                    required: false,
+                    type: 'string',
+                    description: 'The cap as a decimal USD string. Absent when the budget row carries no cost cap.',
+                },
+                {
+                    name: 'resumed_session_ids',
+                    required: false,
+                    type: 'string[]',
+                    description: 'On a write, the sessions that had stopped at the old cap and were sent a resume message because the new cap leaves room. Absent on a read, and when nothing was waiting.',
+                },
+                {
+                    name: 'root_session_id',
+                    required: false,
+                    type: 'string',
+                    description: 'Root session the cap belongs to (UUID). Every session in the tree draws on the same amount.',
+                },
+            ],
+        },
+    },
     managedAgentsStartAgentReflection: {
         operationId: 'managedAgentsStartAgentReflection',
         tag: 'managed-agents',
@@ -55184,7 +55318,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 +55485,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 +55581,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 +55600,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 +55795,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.168",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",