@sealant/api-contracts-next 0.0.0-next.0 → 0.39.0-next.682

package/dist/core-api/runs.d.ts

@@ -0,0 +1,516 @@
+/**
+ * Run + execution-record wire contracts.
+ *
+ * A `run` is one harness execution; it owns the execution record (the telemetry log). These
+ * endpoints are the network face of the run-detail read path (RunRepo -> THIS contract -> apps/api ->
+ * SDK): register a run, read its metadata, list runs, update its terminal status, and read its
+ * record — timeline, byte-exact scrollback, and the provenance-honest loss report.
+ *
+ * Wire note: per-runtime monotonic uint64 sequences are carried as DECIMAL STRINGS (not JSON numbers)
+ * so values past 2^53 survive; the SDK and API layer convert to/from `bigint`.
+ */
+import { Schema } from "effect";
+import { HttpApiEndpoint, HttpApiGroup } from "effect/unstable/httpapi";
+import { BudgetExceededError } from "./budgets.js";
+export declare const runStatusSchema: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
+export type RunStatusWire = typeof runStatusSchema.Type;
+export declare const runModeSchema: Schema.Literals<readonly ["one-shot", "interactive"]>;
+export type RunModeWire = typeof runModeSchema.Type;
+export declare const ioStreamSchema: Schema.Literals<readonly ["stdout", "stderr", "pty"]>;
+export type IoStreamWire = typeof ioStreamSchema.Type;
+/** The one-shot harness invocation the control plane execs in the workspace. */
+export declare const runCommandSchema: Schema.Struct<{
+    readonly executable: Schema.String;
+    readonly args: Schema.$Array<Schema.String>;
+    readonly cwd: Schema.optional<Schema.String>;
+}>;
+export type RunCommandWire = typeof runCommandSchema.Type;
+export declare const runSchema: Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly attemptId: Schema.optional<Schema.String>;
+    readonly ownerUserId: Schema.String;
+    readonly harnessId: Schema.String;
+    readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
+    readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
+    readonly prompt: Schema.optional<Schema.String>;
+    /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
+    readonly command: Schema.optional<Schema.Struct<{
+        readonly executable: Schema.String;
+        readonly args: Schema.$Array<Schema.String>;
+        readonly cwd: Schema.optional<Schema.String>;
+    }>>;
+    /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly exitCode: Schema.optional<Schema.Number>;
+    readonly errorMessage: Schema.optional<Schema.String>;
+    readonly startedAt: Schema.optional<Schema.String>;
+    readonly finishedAt: Schema.optional<Schema.String>;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+}>;
+export type Run = typeof runSchema.Type;
+export declare const runFileChangeSchema: Schema.Struct<{
+    readonly path: Schema.String;
+    readonly change: Schema.Literals<readonly ["added", "modified", "deleted", "renamed"]>;
+    readonly oldPath: Schema.optional<Schema.String>;
+}>;
+export type RunFileChangeWire = typeof runFileChangeSchema.Type;
+export declare const createRunRequestSchema: Schema.Struct<{
+    readonly workspaceId: Schema.String;
+    readonly harnessId: Schema.String;
+    readonly ownerUserId: Schema.String;
+    readonly mode: Schema.optional<Schema.Literals<readonly ["one-shot", "interactive"]>>;
+    readonly prompt: Schema.optional<Schema.String>;
+    readonly attemptId: Schema.optional<Schema.String>;
+    readonly command: Schema.optional<Schema.Struct<{
+        readonly executable: Schema.String;
+        readonly args: Schema.$Array<Schema.String>;
+        readonly cwd: Schema.optional<Schema.String>;
+    }>>;
+    /** Opaque caller correlation bag ({ projectId, sessionId, ... }): stored + echoed, no semantics. */
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+}>;
+export type CreateRunRequest = typeof createRunRequestSchema.Type;
+export declare const updateRunRequestSchema: Schema.Struct<{
+    /** The run's owner. Required by the control plane: an update that names no owner finds no run. */
+    readonly ownerUserId: Schema.optional<Schema.String>;
+    readonly status: Schema.optional<Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>>;
+    readonly exitCode: Schema.optional<Schema.Number>;
+    readonly errorMessage: Schema.optional<Schema.String>;
+    readonly diff: Schema.optional<Schema.String>;
+    readonly changedFiles: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly path: Schema.String;
+        readonly change: Schema.Literals<readonly ["added", "modified", "deleted", "renamed"]>;
+        readonly oldPath: Schema.optional<Schema.String>;
+    }>>>;
+    /** The caller read the run's changes and the reading failed: nothing is known of them. */
+    readonly changesReadFailed: Schema.optional<Schema.Boolean>;
+}>;
+export type UpdateRunRequest = typeof updateRunRequestSchema.Type;
+export declare const listRunsQuerySchema: Schema.Struct<{
+    readonly workspaceId: Schema.optional<Schema.String>;
+    readonly ownerUserId: Schema.optional<Schema.String>;
+    readonly status: Schema.optional<Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>>;
+    readonly limit: Schema.optional<Schema.String>;
+}>;
+export type ListRunsQuery = typeof listRunsQuerySchema.Type;
+export declare const listRunsResponseSchema: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly workspaceId: Schema.String;
+        readonly attemptId: Schema.optional<Schema.String>;
+        readonly ownerUserId: Schema.String;
+        readonly harnessId: Schema.String;
+        readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
+        readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
+        readonly prompt: Schema.optional<Schema.String>;
+        /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
+        readonly command: Schema.optional<Schema.Struct<{
+            readonly executable: Schema.String;
+            readonly args: Schema.$Array<Schema.String>;
+            readonly cwd: Schema.optional<Schema.String>;
+        }>>;
+        /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
+        readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+        readonly exitCode: Schema.optional<Schema.Number>;
+        readonly errorMessage: Schema.optional<Schema.String>;
+        readonly startedAt: Schema.optional<Schema.String>;
+        readonly finishedAt: Schema.optional<Schema.String>;
+        readonly createdAt: Schema.String;
+        readonly updatedAt: Schema.String;
+    }>>;
+}>;
+export type ListRunsResponse = typeof listRunsResponseSchema.Type;
+export declare const timelineEntrySchema: Schema.Struct<{
+    readonly eventId: Schema.String;
+    readonly sequence: Schema.String;
+    readonly kind: Schema.String;
+    readonly occurredAt: Schema.String;
+    readonly summary: Schema.String;
+    readonly ref: Schema.optional<Schema.Unknown>;
+    /** Correlation id of the producing process (attribution key for record views). */
+    readonly processId: Schema.optional<Schema.String>;
+    /** Numeric CaptureMethod / Confidence enums — how the fact was captured, per envelope. */
+    readonly captureMethod: Schema.Number;
+    readonly confidence: Schema.Number;
+}>;
+export type TimelineEntry = typeof timelineEntrySchema.Type;
+/**
+ * Owner scoping on reads: the run must belong to `ownerUserId` (uniform 404 otherwise). The field
+ * stays optional on the wire for older callers, but the control plane requires it: a read that
+ * names no owner finds no run.
+ */
+export declare const runOwnerQuerySchema: Schema.Struct<{
+    readonly ownerUserId: Schema.optional<Schema.String>;
+}>;
+export type RunOwnerQuery = typeof runOwnerQuerySchema.Type;
+export declare const getRunTimelineQuerySchema: Schema.Struct<{
+    readonly ownerUserId: Schema.optional<Schema.String>;
+    readonly fromSequence: Schema.optional<Schema.String>;
+    readonly toSequence: Schema.optional<Schema.String>;
+    readonly limit: Schema.optional<Schema.String>;
+    /**
+     * Comma-separated payload cases (e.g. `processStarted,processExited,fileChange`). Filters the
+     * timeline to those event kinds server-side — the read path for record views that must not pay
+     * for the ioChunk-dominated full log.
+     */
+    readonly kinds: Schema.optional<Schema.String>;
+}>;
+export type GetRunTimelineQuery = typeof getRunTimelineQuerySchema.Type;
+export declare const runTimelineResponseSchema: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly eventId: Schema.String;
+        readonly sequence: Schema.String;
+        readonly kind: Schema.String;
+        readonly occurredAt: Schema.String;
+        readonly summary: Schema.String;
+        readonly ref: Schema.optional<Schema.Unknown>;
+        /** Correlation id of the producing process (attribution key for record views). */
+        readonly processId: Schema.optional<Schema.String>;
+        /** Numeric CaptureMethod / Confidence enums — how the fact was captured, per envelope. */
+        readonly captureMethod: Schema.Number;
+        readonly confidence: Schema.Number;
+    }>>;
+}>;
+export type RunTimelineResponse = typeof runTimelineResponseSchema.Type;
+/**
+ * One stored EventEnvelope, verbatim: correlation ids, both clocks, capture provenance, and the
+ * jsonb payload (bigints stringified at ingest). This is the drill-down read behind a timeline
+ * entry — the timeline carries the summary + ref, this carries the whole record.
+ */
+export declare const runEventSchema: Schema.Struct<{
+    readonly eventId: Schema.String;
+    readonly runId: Schema.String;
+    readonly runtimeId: Schema.String;
+    readonly executionId: Schema.optional<Schema.String>;
+    readonly sessionId: Schema.optional<Schema.String>;
+    readonly processId: Schema.optional<Schema.String>;
+    readonly requestId: Schema.optional<Schema.String>;
+    readonly schemaVersion: Schema.Number;
+    readonly sequence: Schema.String;
+    readonly observedAt: Schema.String;
+    readonly monotonicTimestamp: Schema.String;
+    readonly captureMethod: Schema.Number;
+    readonly confidence: Schema.Number;
+    readonly payloadCase: Schema.String;
+    readonly payload: Schema.Unknown;
+    readonly ingestedAt: Schema.String;
+}>;
+export type RunEvent = typeof runEventSchema.Type;
+export declare const getRunScrollbackQuerySchema: Schema.Struct<{
+    readonly ownerUserId: Schema.optional<Schema.String>;
+    readonly processId: Schema.String;
+    readonly stream: Schema.Literals<readonly ["stdout", "stderr", "pty"]>;
+    readonly atSequence: Schema.optional<Schema.String>;
+    /** Inclusive lower sequence bound — with `atSequence` this selects a sequence RANGE. */
+    readonly fromSequence: Schema.optional<Schema.String>;
+    /** Maximum chunks to reconstruct (server default 5000). */
+    readonly limit: Schema.optional<Schema.String>;
+}>;
+export type GetRunScrollbackQuery = typeof getRunScrollbackQuerySchema.Type;
+export declare const runScrollbackResponseSchema: Schema.Struct<{
+    readonly processId: Schema.String;
+    readonly stream: Schema.Literals<readonly ["stdout", "stderr", "pty"]>;
+    readonly byteCount: Schema.Number;
+    /** Base64-encoded reconstructed bytes (byte-exact as recorded; redaction happens upstream). */
+    readonly contentBase64: Schema.String;
+}>;
+export type RunScrollbackResponse = typeof runScrollbackResponseSchema.Type;
+export declare const lossSpanSchema: Schema.Struct<{
+    readonly kind: Schema.Literals<readonly ["dropped_event", "sequence_gap", "watch_overflow", "early_close"]>;
+    readonly fromSequence: Schema.optional<Schema.String>;
+    readonly toSequence: Schema.optional<Schema.String>;
+    readonly droppedCount: Schema.optional<Schema.String>;
+    readonly detectedVia: Schema.Literals<readonly ["marker", "gap"]>;
+    readonly reason: Schema.optional<Schema.String>;
+}>;
+export type LossSpan = typeof lossSpanSchema.Type;
+export declare const runLossReportSchema: Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly droppedEventCount: Schema.String;
+    readonly sequenceGapCount: Schema.Number;
+    readonly watchOverflowCount: Schema.Number;
+    readonly earlyClose: Schema.Boolean;
+    readonly spans: Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["dropped_event", "sequence_gap", "watch_overflow", "early_close"]>;
+        readonly fromSequence: Schema.optional<Schema.String>;
+        readonly toSequence: Schema.optional<Schema.String>;
+        readonly droppedCount: Schema.optional<Schema.String>;
+        readonly detectedVia: Schema.Literals<readonly ["marker", "gap"]>;
+        readonly reason: Schema.optional<Schema.String>;
+    }>>;
+}>;
+export type RunLossReport = typeof runLossReportSchema.Type;
+export declare const runChangesResponseSchema: Schema.Struct<{
+    readonly files: Schema.$Array<Schema.Struct<{
+        readonly path: Schema.String;
+        readonly change: Schema.Literals<readonly ["added", "modified", "deleted", "renamed"]>;
+        readonly oldPath: Schema.optional<Schema.String>;
+    }>>;
+    /** Unified diff of everything that changed (empty until the run has produced changes). */
+    readonly diff: Schema.String;
+    /**
+     * Whether the run's changes were read. `false`: they were not (the run has not ended, no
+     * reading ran for it, or the reading failed), and the empty `files` and `diff` say nothing
+     * about what changed. Absent from a control plane older than the field: read as `true`.
+     */
+    readonly available: Schema.optional<Schema.Boolean>;
+    /** Why the changes are not available, when `available` is `false`. */
+    readonly unavailableReason: Schema.optional<Schema.String>;
+}>;
+export type RunChangesResponse = typeof runChangesResponseSchema.Type;
+declare const RunBadRequestError_base: Schema.Class<RunBadRequestError, Schema.TaggedStruct<"RunBadRequestError", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class RunBadRequestError extends RunBadRequestError_base {
+}
+declare const RunNotFoundError_base: Schema.Class<RunNotFoundError, Schema.TaggedStruct<"RunNotFoundError", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class RunNotFoundError extends RunNotFoundError_base {
+}
+declare const RunInternalServerError_base: Schema.Class<RunInternalServerError, Schema.TaggedStruct<"RunInternalServerError", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class RunInternalServerError extends RunInternalServerError_base {
+}
+export declare const RunsGroup: HttpApiGroup.HttpApiGroup<"runs", HttpApiEndpoint.HttpApiEndpoint<"createRun", "POST", "/", HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly workspaceId: Schema.String;
+    readonly harnessId: Schema.String;
+    readonly ownerUserId: Schema.String;
+    readonly mode: Schema.optional<Schema.Literals<readonly ["one-shot", "interactive"]>>;
+    readonly prompt: Schema.optional<Schema.String>;
+    readonly attemptId: Schema.optional<Schema.String>;
+    readonly command: Schema.optional<Schema.Struct<{
+        readonly executable: Schema.String;
+        readonly args: Schema.$Array<Schema.String>;
+        readonly cwd: Schema.optional<Schema.String>;
+    }>>;
+    /** Opaque caller correlation bag ({ projectId, sessionId, ... }): stored + echoed, no semantics. */
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly attemptId: Schema.optional<Schema.String>;
+    readonly ownerUserId: Schema.String;
+    readonly harnessId: Schema.String;
+    readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
+    readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
+    readonly prompt: Schema.optional<Schema.String>;
+    /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
+    readonly command: Schema.optional<Schema.Struct<{
+        readonly executable: Schema.String;
+        readonly args: Schema.$Array<Schema.String>;
+        readonly cwd: Schema.optional<Schema.String>;
+    }>>;
+    /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly exitCode: Schema.optional<Schema.Number>;
+    readonly errorMessage: Schema.optional<Schema.String>;
+    readonly startedAt: Schema.optional<Schema.String>;
+    readonly finishedAt: Schema.optional<Schema.String>;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+}>>, HttpApiEndpoint.Json<typeof BudgetExceededError | typeof RunBadRequestError | typeof RunNotFoundError | typeof RunInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getRun", "GET", "/:runId", HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly runId: Schema.String;
+}>>, HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly ownerUserId: Schema.optional<Schema.String>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly attemptId: Schema.optional<Schema.String>;
+    readonly ownerUserId: Schema.String;
+    readonly harnessId: Schema.String;
+    readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
+    readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
+    readonly prompt: Schema.optional<Schema.String>;
+    /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
+    readonly command: Schema.optional<Schema.Struct<{
+        readonly executable: Schema.String;
+        readonly args: Schema.$Array<Schema.String>;
+        readonly cwd: Schema.optional<Schema.String>;
+    }>>;
+    /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly exitCode: Schema.optional<Schema.Number>;
+    readonly errorMessage: Schema.optional<Schema.String>;
+    readonly startedAt: Schema.optional<Schema.String>;
+    readonly finishedAt: Schema.optional<Schema.String>;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+}>>, HttpApiEndpoint.Json<typeof RunNotFoundError | typeof RunInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getRunChanges", "GET", "/:runId/changes", HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly runId: Schema.String;
+}>>, HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly ownerUserId: Schema.optional<Schema.String>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly files: Schema.$Array<Schema.Struct<{
+        readonly path: Schema.String;
+        readonly change: Schema.Literals<readonly ["added", "modified", "deleted", "renamed"]>;
+        readonly oldPath: Schema.optional<Schema.String>;
+    }>>;
+    /** Unified diff of everything that changed (empty until the run has produced changes). */
+    readonly diff: Schema.String;
+    /**
+     * Whether the run's changes were read. `false`: they were not (the run has not ended, no
+     * reading ran for it, or the reading failed), and the empty `files` and `diff` say nothing
+     * about what changed. Absent from a control plane older than the field: read as `true`.
+     */
+    readonly available: Schema.optional<Schema.Boolean>;
+    /** Why the changes are not available, when `available` is `false`. */
+    readonly unavailableReason: Schema.optional<Schema.String>;
+}>>, HttpApiEndpoint.Json<typeof RunNotFoundError | typeof RunInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getRunEvent", "GET", "/:runId/events/:sequence", HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly sequence: Schema.String;
+}>>, HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly ownerUserId: Schema.optional<Schema.String>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly eventId: Schema.String;
+    readonly runId: Schema.String;
+    readonly runtimeId: Schema.String;
+    readonly executionId: Schema.optional<Schema.String>;
+    readonly sessionId: Schema.optional<Schema.String>;
+    readonly processId: Schema.optional<Schema.String>;
+    readonly requestId: Schema.optional<Schema.String>;
+    readonly schemaVersion: Schema.Number;
+    readonly sequence: Schema.String;
+    readonly observedAt: Schema.String;
+    readonly monotonicTimestamp: Schema.String;
+    readonly captureMethod: Schema.Number;
+    readonly confidence: Schema.Number;
+    readonly payloadCase: Schema.String;
+    readonly payload: Schema.Unknown;
+    readonly ingestedAt: Schema.String;
+}>>, HttpApiEndpoint.Json<typeof RunBadRequestError | typeof RunNotFoundError | typeof RunInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getRunLoss", "GET", "/:runId/loss", HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly runId: Schema.String;
+}>>, HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly ownerUserId: Schema.optional<Schema.String>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly droppedEventCount: Schema.String;
+    readonly sequenceGapCount: Schema.Number;
+    readonly watchOverflowCount: Schema.Number;
+    readonly earlyClose: Schema.Boolean;
+    readonly spans: Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["dropped_event", "sequence_gap", "watch_overflow", "early_close"]>;
+        readonly fromSequence: Schema.optional<Schema.String>;
+        readonly toSequence: Schema.optional<Schema.String>;
+        readonly droppedCount: Schema.optional<Schema.String>;
+        readonly detectedVia: Schema.Literals<readonly ["marker", "gap"]>;
+        readonly reason: Schema.optional<Schema.String>;
+    }>>;
+}>>, HttpApiEndpoint.Json<typeof RunNotFoundError | typeof RunInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getRunScrollback", "GET", "/:runId/scrollback", HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly runId: Schema.String;
+}>>, HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly ownerUserId: Schema.optional<Schema.String>;
+    readonly processId: Schema.String;
+    readonly stream: Schema.Literals<readonly ["stdout", "stderr", "pty"]>;
+    readonly atSequence: Schema.optional<Schema.String>;
+    /** Inclusive lower sequence bound — with `atSequence` this selects a sequence RANGE. */
+    readonly fromSequence: Schema.optional<Schema.String>;
+    /** Maximum chunks to reconstruct (server default 5000). */
+    readonly limit: Schema.optional<Schema.String>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly processId: Schema.String;
+    readonly stream: Schema.Literals<readonly ["stdout", "stderr", "pty"]>;
+    readonly byteCount: Schema.Number;
+    /** Base64-encoded reconstructed bytes (byte-exact as recorded; redaction happens upstream). */
+    readonly contentBase64: Schema.String;
+}>>, HttpApiEndpoint.Json<typeof RunBadRequestError | typeof RunNotFoundError | typeof RunInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getRunTimeline", "GET", "/:runId/timeline", HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly runId: Schema.String;
+}>>, HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly ownerUserId: Schema.optional<Schema.String>;
+    readonly fromSequence: Schema.optional<Schema.String>;
+    readonly toSequence: Schema.optional<Schema.String>;
+    readonly limit: Schema.optional<Schema.String>;
+    /**
+     * Comma-separated payload cases (e.g. `processStarted,processExited,fileChange`). Filters the
+     * timeline to those event kinds server-side — the read path for record views that must not pay
+     * for the ioChunk-dominated full log.
+     */
+    readonly kinds: Schema.optional<Schema.String>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly eventId: Schema.String;
+        readonly sequence: Schema.String;
+        readonly kind: Schema.String;
+        readonly occurredAt: Schema.String;
+        readonly summary: Schema.String;
+        readonly ref: Schema.optional<Schema.Unknown>;
+        /** Correlation id of the producing process (attribution key for record views). */
+        readonly processId: Schema.optional<Schema.String>;
+        /** Numeric CaptureMethod / Confidence enums — how the fact was captured, per envelope. */
+        readonly captureMethod: Schema.Number;
+        readonly confidence: Schema.Number;
+    }>>;
+}>>, HttpApiEndpoint.Json<typeof RunBadRequestError | typeof RunNotFoundError | typeof RunInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"listRuns", "GET", "/", HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly workspaceId: Schema.optional<Schema.String>;
+    readonly ownerUserId: Schema.optional<Schema.String>;
+    readonly status: Schema.optional<Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>>;
+    readonly limit: Schema.optional<Schema.String>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly workspaceId: Schema.String;
+        readonly attemptId: Schema.optional<Schema.String>;
+        readonly ownerUserId: Schema.String;
+        readonly harnessId: Schema.String;
+        readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
+        readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
+        readonly prompt: Schema.optional<Schema.String>;
+        /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
+        readonly command: Schema.optional<Schema.Struct<{
+            readonly executable: Schema.String;
+            readonly args: Schema.$Array<Schema.String>;
+            readonly cwd: Schema.optional<Schema.String>;
+        }>>;
+        /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
+        readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+        readonly exitCode: Schema.optional<Schema.Number>;
+        readonly errorMessage: Schema.optional<Schema.String>;
+        readonly startedAt: Schema.optional<Schema.String>;
+        readonly finishedAt: Schema.optional<Schema.String>;
+        readonly createdAt: Schema.String;
+        readonly updatedAt: Schema.String;
+    }>>;
+}>>, HttpApiEndpoint.Json<typeof RunBadRequestError | typeof RunInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"updateRun", "PATCH", "/:runId", HttpApiEndpoint.StringTree<Schema.Struct<{
+    readonly runId: Schema.String;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    /** The run's owner. Required by the control plane: an update that names no owner finds no run. */
+    readonly ownerUserId: Schema.optional<Schema.String>;
+    readonly status: Schema.optional<Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>>;
+    readonly exitCode: Schema.optional<Schema.Number>;
+    readonly errorMessage: Schema.optional<Schema.String>;
+    readonly diff: Schema.optional<Schema.String>;
+    readonly changedFiles: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly path: Schema.String;
+        readonly change: Schema.Literals<readonly ["added", "modified", "deleted", "renamed"]>;
+        readonly oldPath: Schema.optional<Schema.String>;
+    }>>>;
+    /** The caller read the run's changes and the reading failed: nothing is known of them. */
+    readonly changesReadFailed: Schema.optional<Schema.Boolean>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly attemptId: Schema.optional<Schema.String>;
+    readonly ownerUserId: Schema.String;
+    readonly harnessId: Schema.String;
+    readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
+    readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
+    readonly prompt: Schema.optional<Schema.String>;
+    /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
+    readonly command: Schema.optional<Schema.Struct<{
+        readonly executable: Schema.String;
+        readonly args: Schema.$Array<Schema.String>;
+        readonly cwd: Schema.optional<Schema.String>;
+    }>>;
+    /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly exitCode: Schema.optional<Schema.Number>;
+    readonly errorMessage: Schema.optional<Schema.String>;
+    readonly startedAt: Schema.optional<Schema.String>;
+    readonly finishedAt: Schema.optional<Schema.String>;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+}>>, HttpApiEndpoint.Json<typeof RunBadRequestError | typeof RunNotFoundError | typeof RunInternalServerError>, never, never>, false>;
+export {};