@labelbox/recursion-sdk 0.0.161 → 0.0.163

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

@@ -79,6 +79,29 @@ export type AdminStatsDto = {
         runs: number;
     }>;
 };
+/**
+ * Agent-service transcript events, ordered by sequence ascending.
+ */
+export type AgentRunEventListDto = Array<{
+    /**
+     * Monotonically increasing sequence number assigned by the agent-service.
+     */
+    sequence: number;
+    /**
+     * Category of the event: lifecycle markers (started, launched, done, error), stdio (stdout, stderr), structured event payloads (event), agent observations (observation), and setup/snapshot phases.
+     */
+    event_type: 'started' | 'stdout' | 'stderr' | 'event' | 'observation' | 'process_exited' | 'snapshotting' | 'launched' | 'setup_started' | 'setup_completed' | 'input_delivered' | 'done' | 'error';
+    /**
+     * Payload of the event; shape varies by event_type.
+     */
+    data: {
+        [key: string]: unknown;
+    };
+    /**
+     * Timestamp when the agent-service emitted the event (ISO-8601, UTC).
+     */
+    created_at: string;
+}>;
 /**
  * Skill detail: catalog metadata plus a signed URL for the current SKILL.md bundle contents.
  */
@@ -7131,6 +7154,38 @@ export type ListWorkspaceEntriesResponseDto = {
      */
     directoryTruncated: boolean;
 };
+/**
+ * Live transcript events together with the generation token of the run they came from.
+ */
+export type LiveTranscriptEnvelopeDto = {
+    /**
+     * Live transcript events, ordered by sequence ascending.
+     */
+    events: Array<{
+        /**
+         * Monotonically increasing sequence number assigned by the agent-service.
+         */
+        sequence: number;
+        /**
+         * Category of the event: lifecycle markers (started, launched, done, error), stdio (stdout, stderr), structured event payloads (event), agent observations (observation), and setup/snapshot phases.
+         */
+        event_type: 'started' | 'stdout' | 'stderr' | 'event' | 'observation' | 'process_exited' | 'snapshotting' | 'launched' | 'setup_started' | 'setup_completed' | 'input_delivered' | 'done' | 'error';
+        /**
+         * Payload of the event; shape varies by event_type.
+         */
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * Timestamp when the agent-service emitted the event (ISO-8601, UTC).
+         */
+        created_at: string;
+    }>;
+    /**
+     * 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.
+     */
+    generation: string | null;
+};
 /**
  * Optional request body for locking a problem version.
  */
@@ -10558,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.
      */
@@ -11150,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.
@@ -17546,6 +17613,10 @@ export type RolloutTraceResponseDto = {
      * True when the event stream was trimmed to the most recent window.
      */
     truncated: boolean;
+    /**
+     * 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.
+     */
+    generation?: string | null;
 };
 /**
  * Array of rubrics.
@@ -18164,10 +18235,6 @@ export type RunConfigProbeRunDto = {
          */
         runAt: string;
     } | null;
-    /**
-     * 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.
-     */
-    liveTranscript: string | null;
     /**
      * Timestamp when the probe-run row was created (ISO-8601, UTC).
      */
@@ -18234,10 +18301,6 @@ export type RunConfigProbeRunListDto = Array<{
          */
         runAt: string;
     } | null;
-    /**
-     * 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.
-     */
-    liveTranscript: string | null;
     /**
      * Timestamp when the probe-run row was created (ISO-8601, UTC).
      */
@@ -25911,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.
          */
@@ -31729,7 +31800,16 @@ export type GetV1EnvironmentsByEnvironmentIdQaJobsByQaJobIdTranscriptLiveData =
          */
         qaJobId: string;
     };
-    query?: never;
+    query?: {
+        /**
+         * Return only events whose sequence is greater than this value. Omit to read the whole transcript.
+         */
+        after?: string;
+        /**
+         * 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.
+         */
+        envelope?: 'true' | 'false';
+    };
     url: '/v1/environments/{environmentId}/qa-jobs/{qaJobId}/transcript/live';
 };
 export type GetV1EnvironmentsByEnvironmentIdQaJobsByQaJobIdTranscriptLiveErrors = {
@@ -31761,7 +31841,7 @@ export type GetV1EnvironmentsByEnvironmentIdQaJobsByQaJobIdTranscriptLiveErrors
 export type GetV1EnvironmentsByEnvironmentIdQaJobsByQaJobIdTranscriptLiveError = GetV1EnvironmentsByEnvironmentIdQaJobsByQaJobIdTranscriptLiveErrors[keyof GetV1EnvironmentsByEnvironmentIdQaJobsByQaJobIdTranscriptLiveErrors];
 export type GetV1EnvironmentsByEnvironmentIdQaJobsByQaJobIdTranscriptLiveResponses = {
     /**
-     * Live transcript events as a JSON-encoded array
+     * 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
      */
     200: string;
 };
@@ -35210,7 +35290,16 @@ export type GetV1OrganizationsByOrganizationIdJobsV2ByJobV2IdEventLogData = {
          */
         jobV2Id: string;
     };
-    query?: never;
+    query?: {
+        /**
+         * Return only events whose sequence is greater than this value. Omit to read the whole transcript.
+         */
+        after?: string;
+        /**
+         * 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.
+         */
+        envelope?: 'true' | 'false';
+    };
     url: '/v1/organizations/{organizationId}/jobs-v2/{jobV2Id}/event-log';
 };
 export type GetV1OrganizationsByOrganizationIdJobsV2ByJobV2IdEventLogErrors = {
@@ -35361,7 +35450,16 @@ export type GetV1OrganizationsByOrganizationIdJobsV2ByJobV2IdRolloutsByRolloutRu
          */
         rolloutRunId: string;
     };
-    query?: never;
+    query?: {
+        /**
+         * Return only events whose sequence is greater than this value. Omit to read the whole transcript.
+         */
+        after?: string;
+        /**
+         * 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.
+         */
+        envelope?: 'true' | 'false';
+    };
     url: '/v1/organizations/{organizationId}/jobs-v2/{jobV2Id}/rollouts/{rolloutRunId}/events';
 };
 export type GetV1OrganizationsByOrganizationIdJobsV2ByJobV2IdRolloutsByRolloutRunIdEventsErrors = {
@@ -36917,7 +37015,16 @@ export type GetV1ProblemRunsByProblemRunIdTranscriptLiveData = {
          */
         problemRunId: string;
     };
-    query?: never;
+    query?: {
+        /**
+         * Return only events whose sequence is greater than this value. Omit to read the whole transcript.
+         */
+        after?: string;
+        /**
+         * 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.
+         */
+        envelope?: 'true' | 'false';
+    };
     url: '/v1/problem-runs/{problemRunId}/transcript/live';
 };
 export type GetV1ProblemRunsByProblemRunIdTranscriptLiveErrors = {
@@ -36949,11 +37056,9 @@ export type GetV1ProblemRunsByProblemRunIdTranscriptLiveErrors = {
 export type GetV1ProblemRunsByProblemRunIdTranscriptLiveError = GetV1ProblemRunsByProblemRunIdTranscriptLiveErrors[keyof GetV1ProblemRunsByProblemRunIdTranscriptLiveErrors];
 export type GetV1ProblemRunsByProblemRunIdTranscriptLiveResponses = {
     /**
-     * Live transcript events as a JSON array
+     * Live transcript events as a JSON array, or wrapped with the run generation when the envelope flag is set
      */
-    200: Array<{
-        [key: string]: unknown;
-    }>;
+    200: AgentRunEventListDto | LiveTranscriptEnvelopeDto;
 };
 export type GetV1ProblemRunsByProblemRunIdTranscriptLiveResponse = GetV1ProblemRunsByProblemRunIdTranscriptLiveResponses[keyof GetV1ProblemRunsByProblemRunIdTranscriptLiveResponses];
 export type GetV1ProblemRunsByProblemRunIdWorkspaceEntriesData = {
@@ -38334,6 +38439,60 @@ export type PostV1RunConfigProbeRunsByRunConfigProbeRunIdCancelResponses = {
     204: void;
 };
 export type PostV1RunConfigProbeRunsByRunConfigProbeRunIdCancelResponse = PostV1RunConfigProbeRunsByRunConfigProbeRunIdCancelResponses[keyof PostV1RunConfigProbeRunsByRunConfigProbeRunIdCancelResponses];
+export type GetV1RunConfigProbeRunsByRunConfigProbeRunIdTranscriptLiveData = {
+    body?: never;
+    path: {
+        /**
+         * Stable probe-run identifier (UUID). Probe runs validate a run-config version before locking.
+         */
+        runConfigProbeRunId: string;
+    };
+    query?: {
+        /**
+         * Return only events whose sequence is greater than this value. Omit to read the whole transcript.
+         */
+        after?: string;
+        /**
+         * 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.
+         */
+        envelope?: 'true' | 'false';
+    };
+    url: '/v1/run-config-probe-runs/{runConfigProbeRunId}/transcript/live';
+};
+export type GetV1RunConfigProbeRunsByRunConfigProbeRunIdTranscriptLiveErrors = {
+    /**
+     * Request body, path parameter, or query parameter failed schema validation. The `message` field carries the Zod field-error map.
+     */
+    400: ApiErrorResponse;
+    /**
+     * Missing, malformed, or unknown `X-User-External-Id` header (when supplied for an end-user call).
+     */
+    401: ApiErrorResponse | TargetApiErrorAuthHeaderMissing | TargetApiErrorOrgHeaderMissing;
+    /**
+     * Caller is missing a required permission, or the request scope (organization / environment / problem) does not resolve to the caller.
+     */
+    403: ApiErrorResponse;
+    /**
+     * Probe-run not found or not in flight
+     */
+    404: unknown;
+    /**
+     * Rate limit exceeded for the caller (per-user, per-environment, or per-IP tracker depending on auth context).
+     */
+    429: ApiErrorResponse;
+    /**
+     * Unexpected server error. The response body is the generic `{ statusCode, message }` shape for an unhandled error, or the target error envelope `{ error: { code, message } }` for a framework-owned invariant violation.
+     */
+    500: ApiErrorResponse | TargetApiErrorInvariantViolation;
+};
+export type GetV1RunConfigProbeRunsByRunConfigProbeRunIdTranscriptLiveError = GetV1RunConfigProbeRunsByRunConfigProbeRunIdTranscriptLiveErrors[keyof GetV1RunConfigProbeRunsByRunConfigProbeRunIdTranscriptLiveErrors];
+export type GetV1RunConfigProbeRunsByRunConfigProbeRunIdTranscriptLiveResponses = {
+    /**
+     * Live transcript events, or wrapped with the run generation when the envelope flag is set
+     */
+    200: AgentRunEventListDto | LiveTranscriptEnvelopeDto;
+};
+export type GetV1RunConfigProbeRunsByRunConfigProbeRunIdTranscriptLiveResponse = GetV1RunConfigProbeRunsByRunConfigProbeRunIdTranscriptLiveResponses[keyof GetV1RunConfigProbeRunsByRunConfigProbeRunIdTranscriptLiveResponses];
 export type DeleteV1RunConfigVersionsByRunConfigVersionIdData = {
     body?: never;
     path: {
@@ -40667,7 +40826,16 @@ export type GetV1VersionsByProblemVersionIdSynthesizerRunsBySynthesizerRunIdTran
          */
         synthesizerRunId: string;
     };
-    query?: never;
+    query?: {
+        /**
+         * Return only events whose sequence is greater than this value. Omit to read the whole transcript.
+         */
+        after?: string;
+        /**
+         * 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.
+         */
+        envelope?: 'true' | 'false';
+    };
     url: '/v1/versions/{problemVersionId}/synthesizer-runs/{synthesizerRunId}/transcript/live';
 };
 export type GetV1VersionsByProblemVersionIdSynthesizerRunsBySynthesizerRunIdTranscriptLiveErrors = {
@@ -40699,7 +40867,7 @@ export type GetV1VersionsByProblemVersionIdSynthesizerRunsBySynthesizerRunIdTran
 export type GetV1VersionsByProblemVersionIdSynthesizerRunsBySynthesizerRunIdTranscriptLiveError = GetV1VersionsByProblemVersionIdSynthesizerRunsBySynthesizerRunIdTranscriptLiveErrors[keyof GetV1VersionsByProblemVersionIdSynthesizerRunsBySynthesizerRunIdTranscriptLiveErrors];
 export type GetV1VersionsByProblemVersionIdSynthesizerRunsBySynthesizerRunIdTranscriptLiveResponses = {
     /**
-     * Live transcript events as a JSON-encoded array
+     * 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
      */
     200: string;
 };

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

@@ -6589,6 +6589,7 @@ export const RESOURCE_REFERENCE = {
             'discardRunConfigVersion',
             'discoverMcpToolsForRunConfigVersion',
             'getInheritedRunConfigDefaultForEnvironment',
+            'getLiveRunConfigProbeRunTranscript',
             'getRunConfig',
             'getRunConfigProbeRun',
             'getRunConfigVersion',