@labelbox/recursion-sdk 0.0.162 → 0.0.163

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

@@ -480,6 +480,8 @@ export declare class ManagedAgents extends HeyApiClient {
         tag_ids?: string;
         external_source_type?: string;
         external_source_id?: string;
+        metadata?: Array<string>;
+        metadata_key?: Array<string>;
         root_only?: boolean;
         limit?: number;
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetManagedAgentsV1SessionsResponses, GetManagedAgentsV1SessionsErrors, ThrowOnError, "data">;

package/dist/generated/sdk.gen.js

@@ -913,6 +913,8 @@ export class ManagedAgents extends HeyApiClient {
                     { in: 'query', key: 'tag_ids' },
                     { in: 'query', key: 'external_source_type' },
                     { in: 'query', key: 'external_source_id' },
+                    { in: 'query', key: 'metadata' },
+                    { in: 'query', key: 'metadata_key' },
                     { in: 'query', key: 'root_only' },
                     { in: 'query', key: 'limit' }
                 ] }]);

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

@@ -10613,6 +10613,12 @@ export type ManagedAgentsSession = {
      * RFC 3339 timestamp of when the agent loop last made progress. Distinct from updated_at, which any metadata write touches. Absent for sessions that run no loop.
      */
     last_activity_at?: unknown;
+    /**
+     * Caller-defined string key/value pairs supplied when the session was started, e.g. ids from your own system. Immutable, present on root sessions only, and filterable with metadata=key:value or metadata_key=key on GET /v1/sessions. At most 32 entries; keys use letters, digits, '_', '.', and '-' up to 64 characters; values are 1-512 characters.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
     /**
      * Model reference the session's turns run on (UUID), resolved at start from the agent version or the start request.
      */
@@ -11205,6 +11211,12 @@ export type ManagedAgentsStartSessionRequest = {
      * Opening user message for the session, and the context the agent works from. Send it alongside an outcome to supply facts the agent needs without making them part of what the grader measures; the grader never sees it. Kept in the session's system prompt for the whole run, so context compaction cannot summarize it away.
      */
     message?: string;
+    /**
+     * Caller-defined string key/value pairs stored on the session, e.g. ids that map it back to your own system. Write-once: they cannot be changed after start. At most 32 entries; keys use letters, digits, '_', '.', and '-' up to 64 characters; values are 1-512 characters without control characters. Returned as metadata on GET /v1/sessions and filterable with metadata=key:value (repeatable, AND) or metadata_key=key.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
     outcome?: ManagedAgentsDefineOutcomeRequest;
     /**
      * Labelbox project this session's work is attributed to, which the model gateway bills against. Required when the chosen model runs on an account restricted to customer projects, such as the Anthropic HDO models; the start is rejected without it.
@@ -25962,6 +25974,14 @@ export type GetManagedAgentsV1SessionsData = {
         tag_ids?: string;
         external_source_type?: string;
         external_source_id?: string;
+        /**
+         * Exact-match filter on caller-defined session metadata as key:value, split at the first colon. Repeat the parameter to require several pairs; a session's root must carry every one (AND semantics). Children of a matching root match too, so combine with root_only to list only the roots.
+         */
+        metadata?: Array<string>;
+        /**
+         * Require the root session to carry this caller-defined metadata key with any value. Repeatable; every listed key must be present.
+         */
+        metadata_key?: Array<string>;
         /**
          * Return only root sessions. Use this for model-cost list rows so children cannot consume the bounded page before their tree root.
          */

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

@@ -51295,6 +51295,12 @@ export const SDK_REFERENCE = {
                     description: 'RFC 3339 timestamp of when the agent loop last made progress. Distinct from updated_at, which any metadata write touches. Absent for sessions that run no loop.',
                     format: 'date-time',
                 },
+                {
+                    name: 'metadata',
+                    required: false,
+                    type: 'object',
+                    description: "Caller-defined string key/value pairs supplied when the session was started, e.g. ids from your own system. Immutable, present on root sessions only, and filterable with metadata=key:value or metadata_key=key on GET /v1/sessions. At most 32 entries; keys use letters, digits, '_', '.', and '-' up to 64 characters; values are 1-512 characters.",
+                },
                 {
                     name: 'model_ref_id',
                     required: false,
@@ -53721,7 +53727,7 @@ export const SDK_REFERENCE = {
         namespace: 'managedAgents',
         method: 'listSessions',
         signature: 'rl.managedAgents.listSessions()',
-        example: 'const result = await rl.managedAgents.listSessions({\n  // optional: status, kind, agent_id, tag_ids, external_source_type, external_source_id, root_only, limit\n});',
+        example: 'const result = await rl.managedAgents.listSessions({\n  // optional: status, kind, agent_id, tag_ids, external_source_type, external_source_id, metadata, metadata_key, root_only, limit\n});',
         cliInvocation: 'rl managed-agents list-sessions',
         cliExample: 'rl managed-agents list-sessions',
         curlExample: "curl -X GET 'https://api.recursion.labelbox.com/managed-agents/v1/sessions' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
@@ -53771,6 +53777,22 @@ export const SDK_REFERENCE = {
                 required: false,
                 type: 'string',
             },
+            {
+                name: 'metadata',
+                in: 'query',
+                required: false,
+                type: 'string[]',
+                description: "Exact-match filter on caller-defined session metadata as key:value, split at the first colon. Repeat the parameter to require several pairs; a session's root must carry every one (AND semantics). Children of a matching root match too, so combine with root_only to list only the roots.",
+                maxItems: 32,
+            },
+            {
+                name: 'metadata_key',
+                in: 'query',
+                required: false,
+                type: 'string[]',
+                description: 'Require the root session to carry this caller-defined metadata key with any value. Repeatable; every listed key must be present.',
+                maxItems: 32,
+            },
             {
                 name: 'root_only',
                 in: 'query',
@@ -55016,10 +55038,10 @@ export const SDK_REFERENCE = {
         method: 'startSession',
         bodyKey: 'body',
         signature: 'rl.managedAgents.startSession({ body })',
-        example: 'const result = await rl.managedAgents.startSession({\n  body: {\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    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  },\n});',
+        example: 'const result = await rl.managedAgents.startSession({\n  body: {\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  },\n});',
         cliInvocation: 'rl managed-agents start-session',
         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    "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  }\'',
+        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.',
         httpMethod: 'post',
@@ -55093,6 +55115,13 @@ export const SDK_REFERENCE = {
                 type: 'string',
                 description: "Opening user message for the session, and the context the agent works from. Send it alongside an outcome to supply facts the agent needs without making them part of what the grader measures; the grader never sees it. Kept in the session's system prompt for the whole run, so context compaction cannot summarize it away.",
             },
+            {
+                name: 'metadata',
+                in: 'body',
+                required: false,
+                type: 'object',
+                description: "Caller-defined string key/value pairs stored on the session, e.g. ids that map it back to your own system. Write-once: they cannot be changed after start. At most 32 entries; keys use letters, digits, '_', '.', and '-' up to 64 characters; values are 1-512 characters without control characters. Returned as metadata on GET /v1/sessions and filterable with metadata=key:value (repeatable, AND) or metadata_key=key.",
+            },
             {
                 name: 'outcome',
                 in: 'body',

package/package.json

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