@labelbox/recursion-sdk 0.0.161 → 0.0.163

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

@@ -17816,12 +17816,12 @@ export const SDK_REFERENCE = {
         namespace: 'jobsV2',
         method: 'getEventLogForOrganization',
         signature: 'rl.jobsV2.getEventLogForOrganization({ organizationId, jobV2Id })',
-        example: "const result = await rl.jobsV2.getEventLogForOrganization({\n  organizationId: '<organizationId>',\n  jobV2Id: '<jobV2Id>',\n});",
+        example: "const result = await rl.jobsV2.getEventLogForOrganization({\n  organizationId: '<organizationId>',\n  jobV2Id: '<jobV2Id>',\n  // optional: after, envelope\n});",
         cliInvocation: 'rl jobs-v2 get-event-log-for-organization',
         cliExample: 'rl jobs-v2 get-event-log-for-organization \\\n  --organization-id <organizationId> \\\n  --job-v2-id <jobV2Id>',
         curlExample: "curl -X GET 'https://api.recursion.labelbox.com/v1/organizations/<organizationId>/jobs-v2/<jobV2Id>/event-log' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
         summary: 'Read the raw agent-service event log for an org-scoped jobs_v2 row',
-        description: "Returns this job's own agent-service run event replay verbatim (lifecycle markers, stdout/stderr, and contract-event envelopes alike), oldest to newest, capped to a bounded recent window with a truncated flag. Empty when the job has no agent-service run yet.",
+        description: "Returns this job's own agent-service run event replay verbatim (lifecycle markers, stdout/stderr, and contract-event envelopes alike), oldest to newest, capped to a bounded recent window with a truncated flag; with the after cursor only newer events are returned, still capped to the window. Empty when the job has no agent-service run yet.",
         httpMethod: 'get',
         path: '/v1/organizations/{organizationId}/jobs-v2/{jobV2Id}/event-log',
         requiredPermissions: ['jobs:read'],
@@ -17842,6 +17842,22 @@ export const SDK_REFERENCE = {
                 description: 'Stable jobs_v2 identifier (UUID). One row per background-work unit in the generic, strategy-driven job framework.',
                 format: 'uuid',
             },
+            {
+                name: 'after',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'Return only events whose sequence is greater than this value. Omit to read the whole transcript.',
+                pattern: '^\\d+$',
+            },
+            {
+                name: 'envelope',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'When true, wrap the events in an object that also carries the generation token of the run they came from. Omit for the bare event array.',
+                enum: ['true', 'false'],
+            },
         ],
         response: {
             type: 'RolloutTraceResponseDto',
@@ -17904,6 +17920,13 @@ export const SDK_REFERENCE = {
                     type: 'boolean',
                     description: 'True when the event stream was trimmed to the most recent window.',
                 },
+                {
+                    name: 'generation',
+                    required: false,
+                    type: 'string',
+                    description: 'Opaque token identifying the run the events came from. It changes when the run is resubmitted and sequences restart, so a client holding an after cursor should discard what it holds and re-read; null while the job has no run yet.',
+                    nullable: true,
+                },
             ],
         },
     },
@@ -19990,12 +20013,12 @@ export const SDK_REFERENCE = {
         namespace: 'jobsV2',
         method: 'getRolloutEventsForOrganization',
         signature: 'rl.jobsV2.getRolloutEventsForOrganization({ organizationId, jobV2Id, rolloutRunId })',
-        example: "const result = await rl.jobsV2.getRolloutEventsForOrganization({\n  organizationId: '<organizationId>',\n  jobV2Id: '<jobV2Id>',\n  rolloutRunId: '<rolloutRunId>',\n});",
+        example: "const result = await rl.jobsV2.getRolloutEventsForOrganization({\n  organizationId: '<organizationId>',\n  jobV2Id: '<jobV2Id>',\n  rolloutRunId: '<rolloutRunId>',\n  // optional: after, envelope\n});",
         cliInvocation: 'rl jobs-v2 get-rollout-events-for-organization',
         cliExample: 'rl jobs-v2 get-rollout-events-for-organization \\\n  --organization-id <organizationId> \\\n  --job-v2-id <jobV2Id> \\\n  --rollout-run-id <rolloutRunId>',
         curlExample: "curl -X GET 'https://api.recursion.labelbox.com/v1/organizations/<organizationId>/jobs-v2/<jobV2Id>/rollouts/<rolloutRunId>/events' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
         summary: "Read a rollout's trace events for an org-scoped jobs_v2 row",
-        description: "Verifies rolloutRunId was reported by this job's own ingested telemetry before proxying agent-service, and bounds the returned event window.",
+        description: "Verifies rolloutRunId was reported by this job's own ingested telemetry before proxying agent-service, and bounds the returned event window; with the after cursor only newer events are returned, still capped to the window.",
         httpMethod: 'get',
         path: '/v1/organizations/{organizationId}/jobs-v2/{jobV2Id}/rollouts/{rolloutRunId}/events',
         requiredPermissions: ['jobs:read'],
@@ -20024,6 +20047,22 @@ export const SDK_REFERENCE = {
                 description: 'Opaque agent-service run id of the rollout to trace.',
                 minLength: 1,
             },
+            {
+                name: 'after',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'Return only events whose sequence is greater than this value. Omit to read the whole transcript.',
+                pattern: '^\\d+$',
+            },
+            {
+                name: 'envelope',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'When true, wrap the events in an object that also carries the generation token of the run they came from. Omit for the bare event array.',
+                enum: ['true', 'false'],
+            },
         ],
         response: {
             type: 'RolloutTraceResponseDto',
@@ -20086,6 +20125,13 @@ export const SDK_REFERENCE = {
                     type: 'boolean',
                     description: 'True when the event stream was trimmed to the most recent window.',
                 },
+                {
+                    name: 'generation',
+                    required: false,
+                    type: 'string',
+                    description: 'Opaque token identifying the run the events came from. It changes when the run is resubmitted and sequences restart, so a client holding an after cursor should discard what it holds and re-read; null while the job has no run yet.',
+                    nullable: true,
+                },
             ],
         },
     },
@@ -20161,12 +20207,12 @@ export const SDK_REFERENCE = {
         namespace: 'qa',
         method: 'getLiveJobTranscript',
         signature: 'rl.qa.getLiveJobTranscript({ environmentId, qaJobId })',
-        example: "const result = await rl.qa.getLiveJobTranscript({\n  environmentId: '<environmentId>',\n  qaJobId: '<qaJobId>',\n});",
+        example: "const result = await rl.qa.getLiveJobTranscript({\n  environmentId: '<environmentId>',\n  qaJobId: '<qaJobId>',\n  // optional: after, envelope\n});",
         cliInvocation: 'rl qa get-live-job-transcript',
         cliExample: 'rl qa get-live-job-transcript \\\n  --environment-id <environmentId> \\\n  --qa-job-id <qaJobId>',
         curlExample: "curl -X GET 'https://api.recursion.labelbox.com/v1/environments/<environmentId>/qa-jobs/<qaJobId>/transcript/live' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
         summary: 'Proxy live transcript from agent service for active QA jobs',
-        description: 'Proxies the in-memory event stream from the agent service for an active job, serialized as a JSON array of events. Only available while the job is pending, submitting, or running.',
+        description: 'Proxies the event stream from the agent service for an active job, serialized as a JSON array of events; with the after cursor only newer events are returned. Only available while the job is pending, submitting, or running.',
         httpMethod: 'get',
         path: '/v1/environments/{environmentId}/qa-jobs/{qaJobId}/transcript/live',
         requiredPermissions: ['qa:read', 'transcripts:read'],
@@ -20187,13 +20233,193 @@ export const SDK_REFERENCE = {
                 description: 'Stable QA-job identifier (UUID).',
                 format: 'uuid',
             },
+            {
+                name: 'after',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'Return only events whose sequence is greater than this value. Omit to read the whole transcript.',
+                pattern: '^\\d+$',
+            },
+            {
+                name: 'envelope',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'When true, wrap the events in an object that also carries the generation token of the run they came from. Omit for the bare event array.',
+                enum: ['true', 'false'],
+            },
         ],
         response: {
             type: 'string',
-            description: 'Live transcript events as a JSON-encoded array (text/plain)',
+            description: 'Live transcript events as a JSON-encoded array, or a JSON-encoded object with the events and the run generation when the envelope flag is set (text/plain)',
         },
         responseMediaType: 'text/plain',
     },
+    getLiveRunConfigProbeRunTranscript: {
+        operationId: 'getLiveRunConfigProbeRunTranscript',
+        tag: 'run-configs',
+        callPath: ['probeRuns', 'getLiveTranscript'],
+        namespace: 'probeRuns',
+        method: 'getLiveTranscript',
+        signature: 'rl.probeRuns.getLiveTranscript({ runConfigProbeRunId })',
+        example: "const result = await rl.probeRuns.getLiveTranscript({\n  runConfigProbeRunId: '<runConfigProbeRunId>',\n  // optional: after, envelope\n});",
+        cliInvocation: 'rl probe-runs get-live-transcript',
+        cliExample: 'rl probe-runs get-live-transcript \\\n  --run-config-probe-run-id <runConfigProbeRunId>',
+        curlExample: "curl -X GET 'https://api.recursion.labelbox.com/v1/run-config-probe-runs/<runConfigProbeRunId>/transcript/live' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
+        summary: 'Read the in-flight transcript of a probe-run',
+        description: 'Proxies agent-service transcript events while the probe-run is pending or running; with the after cursor only newer events are returned.',
+        httpMethod: 'get',
+        path: '/v1/run-config-probe-runs/{runConfigProbeRunId}/transcript/live',
+        requiredPermissions: ['run-configs:read'],
+        params: [
+            {
+                name: 'runConfigProbeRunId',
+                in: 'path',
+                required: true,
+                type: 'string',
+                description: 'Stable probe-run identifier (UUID). Probe runs validate a run-config version before locking.',
+                format: 'uuid',
+            },
+            {
+                name: 'after',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'Return only events whose sequence is greater than this value. Omit to read the whole transcript.',
+                pattern: '^\\d+$',
+            },
+            {
+                name: 'envelope',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'When true, wrap the events in an object that also carries the generation token of the run they came from. Omit for the bare event array.',
+                enum: ['true', 'false'],
+            },
+        ],
+        response: {
+            type: 'AgentRunEventListDto | LiveTranscriptEnvelopeDto',
+            variants: [
+                {
+                    name: 'variant 1',
+                    type: 'AgentRunEventListDto',
+                    description: 'Agent-service transcript events, ordered by sequence ascending.',
+                    items: {
+                        type: 'object',
+                        description: 'Single event emitted by the agent-service while running a solver or grader.',
+                        fields: [
+                            {
+                                name: 'sequence',
+                                required: true,
+                                type: 'number',
+                                description: 'Monotonically increasing sequence number assigned by the agent-service.',
+                            },
+                            {
+                                name: 'event_type',
+                                required: true,
+                                type: 'string',
+                                description: 'Category of the event: lifecycle markers (started, launched, done, error), stdio (stdout, stderr), structured event payloads (event), agent observations (observation), and setup/snapshot phases.',
+                                enum: [
+                                    'started',
+                                    'stdout',
+                                    'stderr',
+                                    'event',
+                                    'observation',
+                                    'process_exited',
+                                    'snapshotting',
+                                    'launched',
+                                    'setup_started',
+                                    'setup_completed',
+                                    'input_delivered',
+                                    'done',
+                                    'error',
+                                ],
+                            },
+                            {
+                                name: 'data',
+                                required: true,
+                                type: 'object',
+                                description: 'Payload of the event; shape varies by event_type.',
+                            },
+                            {
+                                name: 'created_at',
+                                required: true,
+                                type: 'string',
+                                description: 'Timestamp when the agent-service emitted the event (ISO-8601, UTC).',
+                            },
+                        ],
+                    },
+                },
+                {
+                    name: 'variant 2',
+                    type: 'LiveTranscriptEnvelopeDto',
+                    description: 'Live transcript events together with the generation token of the run they came from.',
+                    fields: [
+                        {
+                            name: 'events',
+                            required: true,
+                            type: 'object[]',
+                            description: 'Live transcript events, ordered by sequence ascending.',
+                            items: {
+                                type: 'object',
+                                description: 'Single event emitted by the agent-service while running a solver or grader.',
+                                fields: [
+                                    {
+                                        name: 'sequence',
+                                        required: true,
+                                        type: 'number',
+                                        description: 'Monotonically increasing sequence number assigned by the agent-service.',
+                                    },
+                                    {
+                                        name: 'event_type',
+                                        required: true,
+                                        type: 'string',
+                                        description: 'Category of the event: lifecycle markers (started, launched, done, error), stdio (stdout, stderr), structured event payloads (event), agent observations (observation), and setup/snapshot phases.',
+                                        enum: [
+                                            'started',
+                                            'stdout',
+                                            'stderr',
+                                            'event',
+                                            'observation',
+                                            'process_exited',
+                                            'snapshotting',
+                                            'launched',
+                                            'setup_started',
+                                            'setup_completed',
+                                            'input_delivered',
+                                            'done',
+                                            'error',
+                                        ],
+                                    },
+                                    {
+                                        name: 'data',
+                                        required: true,
+                                        type: 'object',
+                                        description: 'Payload of the event; shape varies by event_type.',
+                                    },
+                                    {
+                                        name: 'created_at',
+                                        required: true,
+                                        type: 'string',
+                                        description: 'Timestamp when the agent-service emitted the event (ISO-8601, UTC).',
+                                    },
+                                ],
+                            },
+                        },
+                        {
+                            name: 'generation',
+                            required: true,
+                            type: 'string',
+                            description: 'Opaque token identifying the run the events came from. It changes when the run is resubmitted and sequences restart, so a client holding an after cursor should discard what it holds and re-read; null while the job has no run yet.',
+                            nullable: true,
+                        },
+                    ],
+                },
+            ],
+            description: 'Live transcript events, or wrapped with the run generation when the envelope flag is set',
+        },
+    },
     getLiveSynthesizerRunTranscript: {
         operationId: 'getLiveSynthesizerRunTranscript',
         tag: 'synthesizer',
@@ -20201,12 +20427,12 @@ export const SDK_REFERENCE = {
         namespace: 'synthesizerRuns',
         method: 'getLiveTranscript',
         signature: 'rl.synthesizerRuns.getLiveTranscript({ problemVersionId, synthesizerRunId })',
-        example: "const result = await rl.synthesizerRuns.getLiveTranscript({\n  problemVersionId: '<problemVersionId>',\n  synthesizerRunId: '<synthesizerRunId>',\n});",
+        example: "const result = await rl.synthesizerRuns.getLiveTranscript({\n  problemVersionId: '<problemVersionId>',\n  synthesizerRunId: '<synthesizerRunId>',\n  // optional: after, envelope\n});",
         cliInvocation: 'rl synthesizer-runs get-live-transcript',
         cliExample: 'rl synthesizer-runs get-live-transcript \\\n  --problem-version-id <problemVersionId> \\\n  --synthesizer-run-id <synthesizerRunId>',
         curlExample: "curl -X GET 'https://api.recursion.labelbox.com/v1/versions/<problemVersionId>/synthesizer-runs/<synthesizerRunId>/transcript/live' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
         summary: 'Proxy live transcript from agent service for active synthesizer runs',
-        description: 'Proxies the in-memory event stream from the agent service for an active run, serialized as a JSON array of events. Only available while the run is pending or running.',
+        description: 'Proxies the event stream from the agent service for an active run, serialized as a JSON array of events; with the after cursor only newer events are returned. Only available while the run is pending or running.',
         httpMethod: 'get',
         path: '/v1/versions/{problemVersionId}/synthesizer-runs/{synthesizerRunId}/transcript/live',
         requiredPermissions: ['versions:read', 'transcripts:read'],
@@ -20227,10 +20453,26 @@ export const SDK_REFERENCE = {
                 description: 'Stable synthesizer-run identifier (UUID). One execution of a synthesizer job.',
                 format: 'uuid',
             },
+            {
+                name: 'after',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'Return only events whose sequence is greater than this value. Omit to read the whole transcript.',
+                pattern: '^\\d+$',
+            },
+            {
+                name: 'envelope',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'When true, wrap the events in an object that also carries the generation token of the run they came from. Omit for the bare event array.',
+                enum: ['true', 'false'],
+            },
         ],
         response: {
             type: 'string',
-            description: 'Live transcript events as a JSON-encoded array (text/plain)',
+            description: 'Live transcript events as a JSON-encoded array, or a JSON-encoded object with the events and the run generation when the envelope flag is set (text/plain)',
         },
         responseMediaType: 'text/plain',
     },
@@ -20241,12 +20483,12 @@ export const SDK_REFERENCE = {
         namespace: 'problemRuns',
         method: 'getLiveTranscript',
         signature: 'rl.problemRuns.getLiveTranscript({ problemRunId })',
-        example: "const result = await rl.problemRuns.getLiveTranscript({\n  problemRunId: '<problemRunId>',\n});",
+        example: "const result = await rl.problemRuns.getLiveTranscript({\n  problemRunId: '<problemRunId>',\n  // optional: after, envelope\n});",
         cliInvocation: 'rl problem-runs get-live-transcript',
         cliExample: 'rl problem-runs get-live-transcript \\\n  --problem-run-id <problemRunId>',
         curlExample: "curl -X GET 'https://api.recursion.labelbox.com/v1/problem-runs/<problemRunId>/transcript/live' \\\n  -H 'Authorization: Bearer $LABELBOX_API_KEY'",
         summary: 'Stream the in-flight transcript for an active run',
-        description: 'Returns a JSON array of AgentRunEvent objects — proxied from agent-service for native runs (pending/running) and from Taiga for taiga-provenance runs (pending/running/grading). The active-status set widens for taiga rows because the task transcript on Taiga is fully written by the time the run is in grading.',
+        description: 'Returns a JSON array of AgentRunEvent objects — proxied from agent-service for native runs (pending/running) and from Taiga for taiga-provenance runs (pending/running/grading). The active-status set widens for taiga rows because the task transcript on Taiga is fully written by the time the run is in grading. Native runs honour the after cursor and return only newer events; Taiga runs always return the whole transcript.',
         httpMethod: 'get',
         path: '/v1/problem-runs/{problemRunId}/transcript/live',
         requiredPermissions: ['transcripts:read'],
@@ -20259,10 +20501,143 @@ export const SDK_REFERENCE = {
                 description: 'Stable problem-run identifier (UUID). One solver attempt at one problem version.',
                 format: 'uuid',
             },
+            {
+                name: 'after',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'Return only events whose sequence is greater than this value. Omit to read the whole transcript.',
+                pattern: '^\\d+$',
+            },
+            {
+                name: 'envelope',
+                in: 'query',
+                required: false,
+                type: 'string',
+                description: 'When true, wrap the events in an object that also carries the generation token of the run they came from. Omit for the bare event array.',
+                enum: ['true', 'false'],
+            },
         ],
         response: {
-            type: 'object[]',
-            description: 'Live transcript events as a JSON array',
+            type: 'AgentRunEventListDto | LiveTranscriptEnvelopeDto',
+            variants: [
+                {
+                    name: 'variant 1',
+                    type: 'AgentRunEventListDto',
+                    description: 'Agent-service transcript events, ordered by sequence ascending.',
+                    items: {
+                        type: 'object',
+                        description: 'Single event emitted by the agent-service while running a solver or grader.',
+                        fields: [
+                            {
+                                name: 'sequence',
+                                required: true,
+                                type: 'number',
+                                description: 'Monotonically increasing sequence number assigned by the agent-service.',
+                            },
+                            {
+                                name: 'event_type',
+                                required: true,
+                                type: 'string',
+                                description: 'Category of the event: lifecycle markers (started, launched, done, error), stdio (stdout, stderr), structured event payloads (event), agent observations (observation), and setup/snapshot phases.',
+                                enum: [
+                                    'started',
+                                    'stdout',
+                                    'stderr',
+                                    'event',
+                                    'observation',
+                                    'process_exited',
+                                    'snapshotting',
+                                    'launched',
+                                    'setup_started',
+                                    'setup_completed',
+                                    'input_delivered',
+                                    'done',
+                                    'error',
+                                ],
+                            },
+                            {
+                                name: 'data',
+                                required: true,
+                                type: 'object',
+                                description: 'Payload of the event; shape varies by event_type.',
+                            },
+                            {
+                                name: 'created_at',
+                                required: true,
+                                type: 'string',
+                                description: 'Timestamp when the agent-service emitted the event (ISO-8601, UTC).',
+                            },
+                        ],
+                    },
+                },
+                {
+                    name: 'variant 2',
+                    type: 'LiveTranscriptEnvelopeDto',
+                    description: 'Live transcript events together with the generation token of the run they came from.',
+                    fields: [
+                        {
+                            name: 'events',
+                            required: true,
+                            type: 'object[]',
+                            description: 'Live transcript events, ordered by sequence ascending.',
+                            items: {
+                                type: 'object',
+                                description: 'Single event emitted by the agent-service while running a solver or grader.',
+                                fields: [
+                                    {
+                                        name: 'sequence',
+                                        required: true,
+                                        type: 'number',
+                                        description: 'Monotonically increasing sequence number assigned by the agent-service.',
+                                    },
+                                    {
+                                        name: 'event_type',
+                                        required: true,
+                                        type: 'string',
+                                        description: 'Category of the event: lifecycle markers (started, launched, done, error), stdio (stdout, stderr), structured event payloads (event), agent observations (observation), and setup/snapshot phases.',
+                                        enum: [
+                                            'started',
+                                            'stdout',
+                                            'stderr',
+                                            'event',
+                                            'observation',
+                                            'process_exited',
+                                            'snapshotting',
+                                            'launched',
+                                            'setup_started',
+                                            'setup_completed',
+                                            'input_delivered',
+                                            'done',
+                                            'error',
+                                        ],
+                                    },
+                                    {
+                                        name: 'data',
+                                        required: true,
+                                        type: 'object',
+                                        description: 'Payload of the event; shape varies by event_type.',
+                                    },
+                                    {
+                                        name: 'created_at',
+                                        required: true,
+                                        type: 'string',
+                                        description: 'Timestamp when the agent-service emitted the event (ISO-8601, UTC).',
+                                    },
+                                ],
+                            },
+                        },
+                        {
+                            name: 'generation',
+                            required: true,
+                            type: 'string',
+                            description: 'Opaque token identifying the run the events came from. It changes when the run is resubmitted and sequences restart, so a client holding an after cursor should discard what it holds and re-read; null while the job has no run yet.',
+                            nullable: true,
+                        },
+                    ],
+                },
+            ],
+            description: 'Live transcript events as a JSON array, or wrapped with the run generation when the envelope flag is set',
         },
     },
     getMarketplaceImage: {
@@ -25233,13 +25608,6 @@ export const SDK_REFERENCE = {
                         },
                     ],
                 },
-                {
-                    name: 'liveTranscript',
-                    required: true,
-                    type: 'string',
-                    description: 'JSON-encoded array of agent-service events observed so far while the probe is in flight. Null when no live events are available or the probe is terminal.',
-                    nullable: true,
-                },
                 {
                     name: 'createdAt',
                     required: true,
@@ -37679,13 +38047,6 @@ export const SDK_REFERENCE = {
                             },
                         ],
                     },
-                    {
-                        name: 'liveTranscript',
-                        required: true,
-                        type: 'string',
-                        description: 'JSON-encoded array of agent-service events observed so far while the probe is in flight. Null when no live events are available or the probe is terminal.',
-                        nullable: true,
-                    },
                     {
                         name: 'createdAt',
                         required: true,
@@ -50934,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,
@@ -53360,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'",
@@ -53410,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',
@@ -54655,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',
@@ -54732,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.161",
+  "version": "0.0.163",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",