@labelbox/recursion-sdk 0.0.164 → 0.0.165

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

@@ -562,6 +562,7 @@ export declare class ManagedAgents extends HeyApiClient {
         after_event_id?: string;
         limit?: number;
         hydrate?: 'images';
+        image_urls?: 'signed';
         payloads?: 'refs';
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetManagedAgentsV1SessionsBySessionIdEventsResponses, GetManagedAgentsV1SessionsBySessionIdEventsErrors, ThrowOnError, "data">;
     /**
@@ -646,6 +647,7 @@ export declare class ManagedAgents extends HeyApiClient {
     getSessionTree<ThrowOnError extends boolean = false>(parameters: {
         session_id: string;
         hydrate?: 'images';
+        image_urls?: 'signed';
         payloads?: 'refs';
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetManagedAgentsV1SessionsBySessionIdTreeResponses, GetManagedAgentsV1SessionsBySessionIdTreeErrors, ThrowOnError, "data">;
     /**

package/dist/generated/sdk.gen.js

@@ -1068,6 +1068,7 @@ export class ManagedAgents extends HeyApiClient {
                     { in: 'query', key: 'after_event_id' },
                     { in: 'query', key: 'limit' },
                     { in: 'query', key: 'hydrate' },
+                    { in: 'query', key: 'image_urls' },
                     { in: 'query', key: 'payloads' }
                 ] }]);
         return (options?.client ?? this.client).get({
@@ -1229,6 +1230,7 @@ export class ManagedAgents extends HeyApiClient {
         const params = buildClientParams([parameters], [{ args: [
                     { in: 'path', key: 'session_id' },
                     { in: 'query', key: 'hydrate' },
+                    { in: 'query', key: 'image_urls' },
                     { in: 'query', key: 'payloads' }
                 ] }]);
         return (options?.client ?? this.client).get({

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

@@ -8130,6 +8130,14 @@ export type ManagedAgentsContentBlock = {
      * Private typed content reference. Fetch through the authenticated session image proxy; clients cannot read this gs:// URI directly.
      */
     uri?: string;
+    /**
+     * Short-lived HTTPS URL for the image bytes. Present only when the read asked for image_urls=signed and the deployment has signing configured. Never stored; fetch a fresh read after url_expires_at.
+     */
+    url?: string;
+    /**
+     * When url stops working. Absent whenever url is.
+     */
+    url_expires_at?: unknown;
     /**
      * Validated image width in pixels.
      */
@@ -26727,6 +26735,10 @@ export type GetManagedAgentsV1SessionsBySessionIdEventsData = {
          * Opt-in compatibility mode. images rehydrates private image refs under strict response caps; omitted by default.
          */
         hydrate?: 'images';
+        /**
+         * 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.
+         */
+        image_urls?: 'signed';
         /**
          * External event payloads hydrate by default. Set refs to return bounded stubs and private reference metadata only.
          */
@@ -27230,6 +27242,10 @@ export type GetManagedAgentsV1SessionsBySessionIdTreeData = {
          * Opt-in compatibility mode. images rehydrates private image refs under strict response caps; omitted by default.
          */
         hydrate?: 'images';
+        /**
+         * 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.
+         */
+        image_urls?: 'signed';
         /**
          * External event payloads hydrate by default. Set refs to return bounded stubs and private reference metadata only.
          */

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',
@@ -54887,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.164",
+  "version": "0.0.165",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",