@labelbox/recursion-sdk 0.0.161 → 0.0.162

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.
  */
@@ -17546,6 +17601,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 +18223,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 +18289,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).
      */
@@ -31729,7 +31780,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 +31821,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 +35270,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 +35430,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 +36995,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 +37036,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 +38419,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 +40806,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 +40847,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',