@labelbox/recursion-sdk 0.0.163 → 0.0.165

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

@@ -2977,6 +2977,7 @@ export const RESOURCE_REFERENCE = {
             'managedAgentsListSessionModelCostNodes',
             'managedAgentsListSessionModelCosts',
             'managedAgentsListSessionOutcomes',
+            'managedAgentsListSessionResourceSamples',
             'managedAgentsListSessionThreads',
             'managedAgentsListSessionUsage',
             'managedAgentsListSessions',

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

@@ -51960,7 +51960,7 @@ export const SDK_REFERENCE = {
         namespace: 'managedAgents',
         method: 'getSessionTree',
         signature: 'rl.managedAgents.getSessionTree({ session_id })',
-        example: "const result = await rl.managedAgents.getSessionTree({\n  session_id: '<session_id>',\n  // optional: hydrate, payloads\n});",
+        example: "const result = await rl.managedAgents.getSessionTree({\n  session_id: '<session_id>',\n  // optional: hydrate, image_urls, payloads\n});",
         cliInvocation: 'rl managed-agents get-session-tree',
         cliExample: 'rl managed-agents get-session-tree \\\n  --session_id <session_id>',
         curlExample: "curl -X GET 'https://api.recursion.labelbox.com/managed-agents/v1/sessions/<session_id>/tree' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
@@ -51978,6 +51978,14 @@ export const SDK_REFERENCE = {
                 description: 'Opt-in compatibility mode. images rehydrates private image refs under strict response caps; omitted by default.',
                 enum: ['images'],
             },
+            {
+                name: 'image_urls',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'Set to signed to add a short-lived url (and url_expires_at) to every stored image block the caller may read. Omitted when the deployment has no URL signing configured; the authenticated /images proxy always works.',
+                enum: ['signed'],
+            },
             {
                 name: 'payloads',
                 in: 'query',
@@ -53397,7 +53405,7 @@ export const SDK_REFERENCE = {
         namespace: 'managedAgents',
         method: 'listSessionEvents',
         signature: 'rl.managedAgents.listSessionEvents({ session_id })',
-        example: "const result = await rl.managedAgents.listSessionEvents({\n  session_id: '<session_id>',\n  // optional: after_event_id, limit, hydrate, payloads\n});",
+        example: "const result = await rl.managedAgents.listSessionEvents({\n  session_id: '<session_id>',\n  // optional: after_event_id, limit, hydrate, image_urls, payloads\n});",
         cliInvocation: 'rl managed-agents list-session-events',
         cliExample: 'rl managed-agents list-session-events \\\n  --session_id <session_id>',
         curlExample: "curl -X GET 'https://api.recursion.labelbox.com/managed-agents/v1/sessions/<session_id>/events' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
@@ -53429,6 +53437,14 @@ export const SDK_REFERENCE = {
                 description: 'Opt-in compatibility mode. images rehydrates private image refs under strict response caps; omitted by default.',
                 enum: ['images'],
             },
+            {
+                name: 'image_urls',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'Set to signed to add a short-lived url (and url_expires_at) to every stored image block the caller may read. Omitted when the deployment has no URL signing configured; the authenticated /images proxy always works.',
+                enum: ['signed'],
+            },
             {
                 name: 'payloads',
                 in: 'query',
@@ -53643,6 +53659,131 @@ export const SDK_REFERENCE = {
             ],
         },
     },
+    managedAgentsListSessionResourceSamples: {
+        operationId: 'managedAgentsListSessionResourceSamples',
+        tag: 'managed-agents',
+        callPath: ['managedAgents', 'listSessionResourceSamples'],
+        namespace: 'managedAgents',
+        method: 'listSessionResourceSamples',
+        signature: 'rl.managedAgents.listSessionResourceSamples({ session_id })',
+        example: "const result = await rl.managedAgents.listSessionResourceSamples({\n  session_id: '<session_id>',\n  // optional: from, to, resolution, limit, page_token\n});",
+        cliInvocation: 'rl managed-agents list-session-resource-samples',
+        cliExample: 'rl managed-agents list-session-resource-samples \\\n  --session_id <session_id>',
+        curlExample: "curl -X GET 'https://api.recursion.labelbox.com/managed-agents/v1/sessions/<session_id>/resource-samples' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
+        summary: 'Read sandbox CPU, memory, and GPU usage for a session tree',
+        description: "Returns the tree's sandbox attachments and one page of per-minute resource usage buckets for them, ordered by attachment then time. Each bucket carries the minute's average and peak; resolution=raw adds the individual samples as parallel arrays indexed by offsets_ms. A tree whose compute was released and revived has several attachments; follow revived_from_sandbox_id to connect them. live reports whether a sandbox is still attached, which is the cue to keep polling. An empty sandboxes list means the tree never ran in a sandbox or sampling is disabled; an attachment with sampling_source=unsupported means the sandbox could not measure itself.",
+        httpMethod: 'get',
+        path: '/managed-agents/v1/sessions/{session_id}/resource-samples',
+        requiredPermissions: ['managed-agents:read'],
+        params: [
+            {
+                name: 'from',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'Inclusive lower bound on bucket_start, RFC 3339. Omit for the start of the tree.',
+                format: 'date-time',
+            },
+            {
+                name: 'to',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'Exclusive upper bound on bucket_start, RFC 3339. Omit for now.',
+                format: 'date-time',
+            },
+            {
+                name: 'resolution',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: "minute returns per-minute summaries only; raw also includes each bucket's per-sample arrays at the producer's cadence (five seconds by default). Use raw for the window on screen and minute for the overview.",
+                enum: ['minute', 'raw'],
+                default: 'minute',
+            },
+            {
+                name: 'limit',
+                in: 'query',
+                required: false,
+                type: 'integer',
+                description: "Maximum buckets per page, across all of the tree's sandbox attachments.",
+                default: 120,
+                minimum: 1,
+                maximum: 720,
+            },
+            {
+                name: 'page_token',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: "Signed continuation token from a previous page's next_page_token. Bound to the organization, session, and filters it was issued for.",
+            },
+            {
+                name: 'session_id',
+                in: 'path',
+                required: true,
+                type: 'string',
+                description: 'Any session id (UUID) in the tree. The sandbox is shared by the whole tree, so every id in it returns the same usage.',
+                format: 'uuid',
+            },
+        ],
+        response: {
+            type: 'ManagedAgentsSessionResourceSamplesResponse',
+            description: 'Sandbox CPU, memory, and accelerator usage for a session tree, as minute buckets per sandbox attachment. Samples are what the sandbox measured of itself, drained to the control plane on tool calls and on read.',
+            fields: [
+                {
+                    name: 'as_of',
+                    required: false,
+                    type: 'string',
+                    description: 'RFC 3339 server time at which the page was read.',
+                    format: 'date-time',
+                },
+                {
+                    name: 'buckets',
+                    required: false,
+                    type: 'unknown',
+                    description: 'One page of minute buckets ordered by (sandbox_id, bucket_start). Each bucket names its attachment; join on sandboxes to place it on a lane.',
+                },
+                {
+                    name: 'live',
+                    required: false,
+                    type: 'boolean',
+                    description: 'True while a sandbox that can be sampled is still attached to the tree. A client keeps polling while this is true and stops once it turns false; an attached sandbox that cannot measure itself does not keep it true.',
+                },
+                {
+                    name: 'next_page_token',
+                    required: false,
+                    type: 'string',
+                    description: 'Present when more buckets remain. Pass as page_token with the same query to continue.',
+                },
+                {
+                    name: 'resolution',
+                    required: false,
+                    type: 'string',
+                    description: 'Resolution the buckets were read at.',
+                    enum: ['minute', 'raw'],
+                },
+                {
+                    name: 'root_session_id',
+                    required: false,
+                    type: 'string',
+                    description: 'Root of the tree the usage belongs to.',
+                },
+                {
+                    name: 'sandboxes',
+                    required: false,
+                    type: 'unknown',
+                    description: 'Every sandbox attachment the tree has had, oldest first, including ones that have since been released or closed. Empty when the tree never had a sandbox or sampling is disabled. Complete on every page.',
+                },
+                {
+                    name: 'session_id',
+                    required: false,
+                    type: 'string',
+                    description: 'Session id named in the request.',
+                },
+            ],
+        },
+    },
     managedAgentsListSessionThreads: {
         operationId: 'managedAgentsListSessionThreads',
         tag: 'managed-agents',
@@ -54762,10 +54903,10 @@ export const SDK_REFERENCE = {
         method: 'sendSessionEvents',
         bodyKey: 'body',
         signature: 'rl.managedAgents.sendSessionEvents({ session_id, body })',
-        example: 'const result = await rl.managedAgents.sendSessionEvents({\n  session_id: \'<session_id>\',\n  body: {\n    actor: "human:api",\n    events: [\n      {\n        actor: "human:api",\n        content: [\n          {\n            byte_size: 1,\n            content: [],\n            data: "example",\n            encrypted_content: "example",\n            height: 1,\n            id: "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n            input: {\n              key: "example"\n            },\n            is_error: true,\n            media_type: "example",\n            name: "example-name",\n            omitted_bytes: 1,\n            payload: "example",\n            provider: "example",\n            provider_payload: "example",\n            redacted: true,\n            semantic_hint: "example",\n            sha256: "example",\n            signature: "example",\n            summary: [],\n            text: "example",\n            tool_use_id: "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n            type: "example",\n            uri: "example",\n            width: 1\n          }\n        ],\n        text: "example",\n        type: "user.message"\n      }\n    ],\n    message: "example"\n  },\n});',
+        example: 'const result = await rl.managedAgents.sendSessionEvents({\n  session_id: \'<session_id>\',\n  body: {\n    actor: "human:api",\n    events: [\n      {\n        actor: "human:api",\n        content: [\n          {\n            byte_size: 1,\n            content: [],\n            data: "example",\n            encrypted_content: "example",\n            height: 1,\n            id: "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n            input: {\n              key: "example"\n            },\n            is_error: true,\n            media_type: "example",\n            name: "example-name",\n            omitted_bytes: 1,\n            payload: "example",\n            provider: "example",\n            provider_payload: "example",\n            redacted: true,\n            semantic_hint: "example",\n            sha256: "example",\n            signature: "example",\n            summary: [],\n            text: "example",\n            tool_use_id: "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n            type: "example",\n            uri: "example",\n            url: "https://example.com",\n            url_expires_at: "2026-02-18T09:30:00Z",\n            width: 1\n          }\n        ],\n        text: "example",\n        type: "user.message"\n      }\n    ],\n    message: "example"\n  },\n});',
         cliInvocation: 'rl managed-agents send-session-events',
         cliExample: 'rl managed-agents send-session-events \\\n  --session_id <session_id> \\\n  --from-json body.json',
-        curlExample: 'curl -X POST \'https://api.recursion.labelbox.com/managed-agents/v1/sessions/<session_id>/events\' \\\n  -H \'Authorization: Bearer $LABELBOX_API_KEY\' \\\n  -H \'Content-Type: application/json\' \\\n  -d \'{\n    "actor": "human:api",\n    "events": [\n      {\n        "actor": "human:api",\n        "content": [\n          {\n            "byte_size": 1,\n            "content": [],\n            "data": "example",\n            "encrypted_content": "example",\n            "height": 1,\n            "id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n            "input": {\n              "key": "example"\n            },\n            "is_error": true,\n            "media_type": "example",\n            "name": "example-name",\n            "omitted_bytes": 1,\n            "payload": "example",\n            "provider": "example",\n            "provider_payload": "example",\n            "redacted": true,\n            "semantic_hint": "example",\n            "sha256": "example",\n            "signature": "example",\n            "summary": [],\n            "text": "example",\n            "tool_use_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n            "type": "example",\n            "uri": "example",\n            "width": 1\n          }\n        ],\n        "text": "example",\n        "type": "user.message"\n      }\n    ],\n    "message": "example"\n  }\'',
+        curlExample: 'curl -X POST \'https://api.recursion.labelbox.com/managed-agents/v1/sessions/<session_id>/events\' \\\n  -H \'Authorization: Bearer $LABELBOX_API_KEY\' \\\n  -H \'Content-Type: application/json\' \\\n  -d \'{\n    "actor": "human:api",\n    "events": [\n      {\n        "actor": "human:api",\n        "content": [\n          {\n            "byte_size": 1,\n            "content": [],\n            "data": "example",\n            "encrypted_content": "example",\n            "height": 1,\n            "id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n            "input": {\n              "key": "example"\n            },\n            "is_error": true,\n            "media_type": "example",\n            "name": "example-name",\n            "omitted_bytes": 1,\n            "payload": "example",\n            "provider": "example",\n            "provider_payload": "example",\n            "redacted": true,\n            "semantic_hint": "example",\n            "sha256": "example",\n            "signature": "example",\n            "summary": [],\n            "text": "example",\n            "tool_use_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",\n            "type": "example",\n            "uri": "example",\n            "url": "https://example.com",\n            "url_expires_at": "2026-02-18T09:30:00Z",\n            "width": 1\n          }\n        ],\n        "text": "example",\n        "type": "user.message"\n      }\n    ],\n    "message": "example"\n  }\'',
         summary: 'Append user/system events to a session',
         description: 'Appends user or system events to a session and returns how many were accepted. A running session is signalled so the agent wakes and sees them; once the workflow is gone the events are appended to the transcript instead, which the temporal_signaled field distinguishes. Events are appended in the order given. An omitted or empty events array yields exactly one user turn built from message; the request fails with 400 only when every entry sent was dropped, leaving nothing to append.',
         httpMethod: 'post',

package/package.json

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