@h-rig/contracts 0.0.6-alpha.78 → 0.0.6-alpha.79

package/dist/src/run-journal.d.ts

@@ -0,0 +1,763 @@
+import { Schema } from "effect";
+import { RunStatus } from "./runtime";
+/** Who caused a journal event. Operator ids come from the authenticated WS/HTTP principal. */
+export declare const RunActor: Schema.Struct<{
+    readonly kind: Schema.Literals<readonly ["operator", "agent", "server", "system"]>;
+    readonly id: Schema.optional<Schema.NullOr<Schema.Trim>>;
+}>;
+export type RunActor = typeof RunActor.Type;
+export declare const RunCloseoutPhase: Schema.Literals<readonly ["queued", "commit", "push", "pr-review-merge", "pr-opened", "merge", "close-source", "completed"]>;
+export type RunCloseoutPhase = typeof RunCloseoutPhase.Type;
+export declare const RunCloseoutPhaseOutcome: Schema.Literals<readonly ["started", "completed", "failed"]>;
+export type RunCloseoutPhaseOutcome = typeof RunCloseoutPhaseOutcome.Type;
+export declare const RunCloseoutStatus: Schema.Literals<readonly ["pending", "running", "completed", "needs-attention", "failed"]>;
+export type RunCloseoutStatus = typeof RunCloseoutStatus.Type;
+/**
+ * Persisted state of the server-owned PR closeout machine. Lives on the run
+ * record (`serverCloseout`) so a restarted server resumes the machine at the
+ * recorded phase instead of re-running completed work.
+ */
+export declare const RunCloseoutState: Schema.Struct<{
+    readonly phase: Schema.Literals<readonly ["queued", "commit", "push", "pr-review-merge", "pr-opened", "merge", "close-source", "completed"]>;
+    readonly status: Schema.Literals<readonly ["pending", "running", "completed", "needs-attention", "failed"]>;
+    readonly updatedAt: Schema.String;
+    readonly taskId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly runtimeWorkspace: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly branch: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly prUrl: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly artifactRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly iterations: Schema.optional<Schema.NullOr<Schema.Int>>;
+    readonly feedback: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly error: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly reason: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly merged: Schema.optional<Schema.Boolean>;
+    readonly resumedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly completedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+}>;
+export type RunCloseoutState = typeof RunCloseoutState.Type;
+export declare const ApprovalDecision: Schema.Literals<readonly ["approve", "reject"]>;
+export type ApprovalDecision = typeof ApprovalDecision.Type;
+export declare const RunJournalRecord: Schema.Struct<{
+    readonly status: Schema.Literals<readonly ["created", "queued", "preparing", "running", "waiting-approval", "waiting-user-input", "paused", "validating", "reviewing", "closing-out", "needs-attention", "completed", "failed", "stopped"]>;
+    readonly runId: Schema.Trim;
+    readonly workspaceId: Schema.Trim;
+    readonly taskId: Schema.NullOr<Schema.Trim>;
+    readonly threadId: Schema.NullOr<Schema.Trim>;
+    readonly mode: Schema.Literals<readonly ["local", "remote"]>;
+    readonly runtimeAdapter: Schema.Trim;
+    readonly createdAt: Schema.String;
+    readonly startedAt: Schema.NullOr<Schema.String>;
+    readonly completedAt: Schema.NullOr<Schema.String>;
+    readonly endpointId: Schema.NullOr<Schema.Trim>;
+    readonly hostId: Schema.NullOr<Schema.Trim>;
+    readonly worktreePath: Schema.NullOr<Schema.Trim>;
+    readonly artifactRoot: Schema.NullOr<Schema.Trim>;
+    readonly logRoot: Schema.NullOr<Schema.Trim>;
+    readonly sessionPath: Schema.NullOr<Schema.Trim>;
+    readonly sessionLogPath: Schema.NullOr<Schema.Trim>;
+    readonly pid: Schema.optional<Schema.NullOr<Schema.Int>>;
+    readonly piSession: Schema.optional<Schema.Unknown>;
+    readonly piSessionPrivate: Schema.optional<Schema.Unknown>;
+    readonly updatedAt: Schema.String;
+    readonly title: Schema.Trim;
+    readonly projectRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly errorText: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly latestMessageId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly prUrl: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly leaseId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly serverCloseout: Schema.optional<Schema.NullOr<Schema.Struct<{
+        readonly phase: Schema.Literals<readonly ["queued", "commit", "push", "pr-review-merge", "pr-opened", "merge", "close-source", "completed"]>;
+        readonly status: Schema.Literals<readonly ["pending", "running", "completed", "needs-attention", "failed"]>;
+        readonly updatedAt: Schema.String;
+        readonly taskId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly runtimeWorkspace: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly branch: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly prUrl: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly artifactRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly iterations: Schema.optional<Schema.NullOr<Schema.Int>>;
+        readonly feedback: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly error: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly reason: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly merged: Schema.optional<Schema.Boolean>;
+        readonly resumedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly completedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    }>>>;
+    readonly model: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly runtimeMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly interactionMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly runMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly initialPrompt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly baselineMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly prMode: Schema.optional<Schema.NullOr<Schema.Literals<readonly ["auto", "ask", "off"]>>>;
+    readonly initiatedBy: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly sourceTask: Schema.optional<Schema.Unknown>;
+    readonly serverPid: Schema.optional<Schema.NullOr<Schema.Int>>;
+    readonly latestSteeringAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly latestSteeringDeliveredAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly statusDetail: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly planning: Schema.optional<Schema.Unknown>;
+    readonly branch: Schema.optional<Schema.NullOr<Schema.Trim>>;
+}>;
+export type RunJournalRecord = typeof RunJournalRecord.Type;
+export declare const RunRecordPatch: Schema.Struct<{
+    readonly runId: Schema.optional<Schema.Trim>;
+    readonly workspaceId: Schema.optional<Schema.Trim>;
+    readonly taskId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly threadId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly mode: Schema.optional<Schema.Literals<readonly ["local", "remote"]>>;
+    readonly runtimeAdapter: Schema.optional<Schema.Trim>;
+    readonly createdAt: Schema.optional<Schema.String>;
+    readonly startedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly completedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly endpointId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly hostId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly worktreePath: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly artifactRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly logRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly sessionPath: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly sessionLogPath: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly pid: Schema.optional<Schema.NullOr<Schema.Int>>;
+    readonly piSession: Schema.optional<Schema.Unknown>;
+    readonly piSessionPrivate: Schema.optional<Schema.Unknown>;
+    readonly updatedAt: Schema.optional<Schema.String>;
+    readonly title: Schema.optional<Schema.Trim>;
+    readonly projectRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly errorText: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly latestMessageId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly prUrl: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly leaseId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly serverCloseout: Schema.optional<Schema.NullOr<Schema.Struct<{
+        readonly phase: Schema.Literals<readonly ["queued", "commit", "push", "pr-review-merge", "pr-opened", "merge", "close-source", "completed"]>;
+        readonly status: Schema.Literals<readonly ["pending", "running", "completed", "needs-attention", "failed"]>;
+        readonly updatedAt: Schema.String;
+        readonly taskId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly runtimeWorkspace: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly branch: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly prUrl: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly artifactRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly iterations: Schema.optional<Schema.NullOr<Schema.Int>>;
+        readonly feedback: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly error: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly reason: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly merged: Schema.optional<Schema.Boolean>;
+        readonly resumedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly completedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    }>>>;
+    readonly model: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly runtimeMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly interactionMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly runMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly initialPrompt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly baselineMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly prMode: Schema.optional<Schema.NullOr<Schema.Literals<readonly ["auto", "ask", "off"]>>>;
+    readonly initiatedBy: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly sourceTask: Schema.optional<Schema.Unknown>;
+    readonly serverPid: Schema.optional<Schema.NullOr<Schema.Int>>;
+    readonly latestSteeringAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly latestSteeringDeliveredAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly statusDetail: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly planning: Schema.optional<Schema.Unknown>;
+    readonly branch: Schema.optional<Schema.NullOr<Schema.Trim>>;
+}>;
+export type RunRecordPatch = typeof RunRecordPatch.Type;
+export declare const RunStatusChangedEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"status-changed">;
+    readonly from: Schema.NullOr<Schema.Literals<readonly ["created", "queued", "preparing", "running", "waiting-approval", "waiting-user-input", "paused", "validating", "reviewing", "closing-out", "needs-attention", "completed", "failed", "stopped"]>>;
+    readonly to: Schema.Literals<readonly ["created", "queued", "preparing", "running", "waiting-approval", "waiting-user-input", "paused", "validating", "reviewing", "closing-out", "needs-attention", "completed", "failed", "stopped"]>;
+    readonly reason: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly actor: Schema.optional<Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["operator", "agent", "server", "system"]>;
+        readonly id: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    }>>;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunStatusChangedEvent = typeof RunStatusChangedEvent.Type;
+export declare const RunRecordPatchEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"record-patch">;
+    readonly patch: Schema.Struct<{
+        readonly runId: Schema.optional<Schema.Trim>;
+        readonly workspaceId: Schema.optional<Schema.Trim>;
+        readonly taskId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly threadId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly mode: Schema.optional<Schema.Literals<readonly ["local", "remote"]>>;
+        readonly runtimeAdapter: Schema.optional<Schema.Trim>;
+        readonly createdAt: Schema.optional<Schema.String>;
+        readonly startedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly completedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly endpointId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly hostId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly worktreePath: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly artifactRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly logRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly sessionPath: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly sessionLogPath: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly pid: Schema.optional<Schema.NullOr<Schema.Int>>;
+        readonly piSession: Schema.optional<Schema.Unknown>;
+        readonly piSessionPrivate: Schema.optional<Schema.Unknown>;
+        readonly updatedAt: Schema.optional<Schema.String>;
+        readonly title: Schema.optional<Schema.Trim>;
+        readonly projectRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly errorText: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly latestMessageId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly prUrl: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly leaseId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly serverCloseout: Schema.optional<Schema.NullOr<Schema.Struct<{
+            readonly phase: Schema.Literals<readonly ["queued", "commit", "push", "pr-review-merge", "pr-opened", "merge", "close-source", "completed"]>;
+            readonly status: Schema.Literals<readonly ["pending", "running", "completed", "needs-attention", "failed"]>;
+            readonly updatedAt: Schema.String;
+            readonly taskId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+            readonly runtimeWorkspace: Schema.optional<Schema.NullOr<Schema.Trim>>;
+            readonly branch: Schema.optional<Schema.NullOr<Schema.Trim>>;
+            readonly prUrl: Schema.optional<Schema.NullOr<Schema.Trim>>;
+            readonly artifactRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+            readonly iterations: Schema.optional<Schema.NullOr<Schema.Int>>;
+            readonly feedback: Schema.optional<Schema.$Array<Schema.String>>;
+            readonly error: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly reason: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly merged: Schema.optional<Schema.Boolean>;
+            readonly resumedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly completedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        }>>>;
+        readonly model: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly runtimeMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly interactionMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly runMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly initialPrompt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly baselineMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly prMode: Schema.optional<Schema.NullOr<Schema.Literals<readonly ["auto", "ask", "off"]>>>;
+        readonly initiatedBy: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly sourceTask: Schema.optional<Schema.Unknown>;
+        readonly serverPid: Schema.optional<Schema.NullOr<Schema.Int>>;
+        readonly latestSteeringAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly latestSteeringDeliveredAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly statusDetail: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly planning: Schema.optional<Schema.Unknown>;
+        readonly branch: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    }>;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunRecordPatchEvent = typeof RunRecordPatchEvent.Type;
+export declare const RunTimelineEntryEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"timeline-entry">;
+    readonly payload: Schema.Unknown;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunTimelineEntryEvent = typeof RunTimelineEntryEvent.Type;
+export declare const RunLogEntryEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"log-entry">;
+    readonly payload: Schema.Unknown;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunLogEntryEvent = typeof RunLogEntryEvent.Type;
+export declare const RunApprovalRequestedEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"approval-requested">;
+    readonly requestId: Schema.Trim;
+    readonly requestKind: Schema.Trim;
+    readonly actionId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly payload: Schema.Unknown;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunApprovalRequestedEvent = typeof RunApprovalRequestedEvent.Type;
+export declare const RunApprovalResolvedEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"approval-resolved">;
+    readonly requestId: Schema.Trim;
+    readonly decision: Schema.Literals<readonly ["approve", "reject"]>;
+    readonly note: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly actor: Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["operator", "agent", "server", "system"]>;
+        readonly id: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    }>;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunApprovalResolvedEvent = typeof RunApprovalResolvedEvent.Type;
+export declare const RunInputRequestedEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"input-requested">;
+    readonly requestId: Schema.Trim;
+    readonly payload: Schema.Unknown;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunInputRequestedEvent = typeof RunInputRequestedEvent.Type;
+export declare const RunInputResolvedEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"input-resolved">;
+    readonly requestId: Schema.Trim;
+    readonly answers: Schema.$Record<Schema.String, Schema.String>;
+    readonly actor: Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["operator", "agent", "server", "system"]>;
+        readonly id: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    }>;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunInputResolvedEvent = typeof RunInputResolvedEvent.Type;
+export declare const RunSteeringEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"steering">;
+    readonly actor: Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["operator", "agent", "server", "system"]>;
+        readonly id: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    }>;
+    readonly text: Schema.String;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunSteeringEvent = typeof RunSteeringEvent.Type;
+export declare const RunAdoptedEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"adopted">;
+    readonly pid: Schema.NullOr<Schema.Int>;
+    readonly serverPid: Schema.Int;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunAdoptedEvent = typeof RunAdoptedEvent.Type;
+export declare const RunStallDetectedEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"stall-detected">;
+    readonly detail: Schema.String;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunStallDetectedEvent = typeof RunStallDetectedEvent.Type;
+export declare const RunCloseoutPhaseEvent: Schema.Struct<{
+    readonly type: Schema.Literal<"closeout-phase">;
+    readonly phase: Schema.Literals<readonly ["queued", "commit", "push", "pr-review-merge", "pr-opened", "merge", "close-source", "completed"]>;
+    readonly outcome: Schema.Literals<readonly ["started", "completed", "failed"]>;
+    readonly detail: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>;
+export type RunCloseoutPhaseEvent = typeof RunCloseoutPhaseEvent.Type;
+export declare const RunJournalEvent: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"status-changed">;
+    readonly from: Schema.NullOr<Schema.Literals<readonly ["created", "queued", "preparing", "running", "waiting-approval", "waiting-user-input", "paused", "validating", "reviewing", "closing-out", "needs-attention", "completed", "failed", "stopped"]>>;
+    readonly to: Schema.Literals<readonly ["created", "queued", "preparing", "running", "waiting-approval", "waiting-user-input", "paused", "validating", "reviewing", "closing-out", "needs-attention", "completed", "failed", "stopped"]>;
+    readonly reason: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly actor: Schema.optional<Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["operator", "agent", "server", "system"]>;
+        readonly id: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    }>>;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"record-patch">;
+    readonly patch: Schema.Struct<{
+        readonly runId: Schema.optional<Schema.Trim>;
+        readonly workspaceId: Schema.optional<Schema.Trim>;
+        readonly taskId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly threadId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly mode: Schema.optional<Schema.Literals<readonly ["local", "remote"]>>;
+        readonly runtimeAdapter: Schema.optional<Schema.Trim>;
+        readonly createdAt: Schema.optional<Schema.String>;
+        readonly startedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly completedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly endpointId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly hostId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly worktreePath: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly artifactRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly logRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly sessionPath: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly sessionLogPath: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly pid: Schema.optional<Schema.NullOr<Schema.Int>>;
+        readonly piSession: Schema.optional<Schema.Unknown>;
+        readonly piSessionPrivate: Schema.optional<Schema.Unknown>;
+        readonly updatedAt: Schema.optional<Schema.String>;
+        readonly title: Schema.optional<Schema.Trim>;
+        readonly projectRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly errorText: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly latestMessageId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly prUrl: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly leaseId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly serverCloseout: Schema.optional<Schema.NullOr<Schema.Struct<{
+            readonly phase: Schema.Literals<readonly ["queued", "commit", "push", "pr-review-merge", "pr-opened", "merge", "close-source", "completed"]>;
+            readonly status: Schema.Literals<readonly ["pending", "running", "completed", "needs-attention", "failed"]>;
+            readonly updatedAt: Schema.String;
+            readonly taskId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+            readonly runtimeWorkspace: Schema.optional<Schema.NullOr<Schema.Trim>>;
+            readonly branch: Schema.optional<Schema.NullOr<Schema.Trim>>;
+            readonly prUrl: Schema.optional<Schema.NullOr<Schema.Trim>>;
+            readonly artifactRoot: Schema.optional<Schema.NullOr<Schema.Trim>>;
+            readonly iterations: Schema.optional<Schema.NullOr<Schema.Int>>;
+            readonly feedback: Schema.optional<Schema.$Array<Schema.String>>;
+            readonly error: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly reason: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly merged: Schema.optional<Schema.Boolean>;
+            readonly resumedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly completedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        }>>>;
+        readonly model: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly runtimeMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly interactionMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly runMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly initialPrompt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly baselineMode: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly prMode: Schema.optional<Schema.NullOr<Schema.Literals<readonly ["auto", "ask", "off"]>>>;
+        readonly initiatedBy: Schema.optional<Schema.NullOr<Schema.Trim>>;
+        readonly sourceTask: Schema.optional<Schema.Unknown>;
+        readonly serverPid: Schema.optional<Schema.NullOr<Schema.Int>>;
+        readonly latestSteeringAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly latestSteeringDeliveredAt: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly statusDetail: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly planning: Schema.optional<Schema.Unknown>;
+        readonly branch: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    }>;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"timeline-entry">;
+    readonly payload: Schema.Unknown;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"log-entry">;
+    readonly payload: Schema.Unknown;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"approval-requested">;
+    readonly requestId: Schema.Trim;
+    readonly requestKind: Schema.Trim;
+    readonly actionId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly payload: Schema.Unknown;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"approval-resolved">;
+    readonly requestId: Schema.Trim;
+    readonly decision: Schema.Literals<readonly ["approve", "reject"]>;
+    readonly note: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly actor: Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["operator", "agent", "server", "system"]>;
+        readonly id: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    }>;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"input-requested">;
+    readonly requestId: Schema.Trim;
+    readonly payload: Schema.Unknown;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"input-resolved">;
+    readonly requestId: Schema.Trim;
+    readonly answers: Schema.$Record<Schema.String, Schema.String>;
+    readonly actor: Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["operator", "agent", "server", "system"]>;
+        readonly id: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    }>;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"steering">;
+    readonly actor: Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["operator", "agent", "server", "system"]>;
+        readonly id: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    }>;
+    readonly text: Schema.String;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"adopted">;
+    readonly pid: Schema.NullOr<Schema.Int>;
+    readonly serverPid: Schema.Int;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"stall-detected">;
+    readonly detail: Schema.String;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"closeout-phase">;
+    readonly phase: Schema.Literals<readonly ["queued", "commit", "push", "pr-review-merge", "pr-opened", "merge", "close-source", "completed"]>;
+    readonly outcome: Schema.Literals<readonly ["started", "completed", "failed"]>;
+    readonly detail: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly v: Schema.Literal<1>;
+    readonly seq: Schema.Int;
+    readonly at: Schema.String;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+}>]>;
+export type RunJournalEvent = typeof RunJournalEvent.Type;
+export declare const decodeRunJournalEvent: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly type: "status-changed";
+    readonly from: "running" | "completed" | "queued" | "failed" | "stopped" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention" | null;
+    readonly to: "running" | "completed" | "queued" | "failed" | "stopped" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention";
+    readonly seq: number;
+    readonly reason?: string | null | undefined;
+    readonly actor?: {
+        readonly kind: "server" | "system" | "operator" | "agent";
+        readonly id?: string | null | undefined;
+    } | undefined;
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly type: "record-patch";
+    readonly seq: number;
+    readonly patch: {
+        readonly taskId?: string | null | undefined;
+        readonly runId?: string | undefined;
+        readonly createdAt?: string | undefined;
+        readonly title?: string | undefined;
+        readonly mode?: "local" | "remote" | undefined;
+        readonly model?: string | null | undefined;
+        readonly planning?: unknown;
+        readonly updatedAt?: string | undefined;
+        readonly completedAt?: string | null | undefined;
+        readonly startedAt?: string | null | undefined;
+        readonly workspaceId?: string | undefined;
+        readonly runtimeMode?: string | null | undefined;
+        readonly threadId?: string | null | undefined;
+        readonly interactionMode?: string | null | undefined;
+        readonly branch?: string | null | undefined;
+        readonly worktreePath?: string | null | undefined;
+        readonly initialPrompt?: string | null | undefined;
+        readonly latestMessageId?: string | null | undefined;
+        readonly errorText?: string | null | undefined;
+        readonly runtimeAdapter?: string | undefined;
+        readonly sessionLogPath?: string | null | undefined;
+        readonly pid?: number | null | undefined;
+        readonly endpointId?: string | null | undefined;
+        readonly hostId?: string | null | undefined;
+        readonly leaseId?: string | null | undefined;
+        readonly runMode?: string | null | undefined;
+        readonly prUrl?: string | null | undefined;
+        readonly artifactRoot?: string | null | undefined;
+        readonly logRoot?: string | null | undefined;
+        readonly sessionPath?: string | null | undefined;
+        readonly piSession?: unknown;
+        readonly piSessionPrivate?: unknown;
+        readonly projectRoot?: string | null | undefined;
+        readonly serverCloseout?: {
+            readonly status: "running" | "completed" | "failed" | "pending" | "needs-attention";
+            readonly updatedAt: string;
+            readonly phase: "push" | "merge" | "completed" | "queued" | "commit" | "pr-review-merge" | "pr-opened" | "close-source";
+            readonly taskId?: string | null | undefined;
+            readonly completedAt?: string | null | undefined;
+            readonly error?: string | null | undefined;
+            readonly reason?: string | null | undefined;
+            readonly branch?: string | null | undefined;
+            readonly merged?: boolean | undefined;
+            readonly runtimeWorkspace?: string | null | undefined;
+            readonly prUrl?: string | null | undefined;
+            readonly artifactRoot?: string | null | undefined;
+            readonly iterations?: number | null | undefined;
+            readonly feedback?: readonly string[] | undefined;
+            readonly resumedAt?: string | null | undefined;
+        } | null | undefined;
+        readonly baselineMode?: string | null | undefined;
+        readonly prMode?: "auto" | "off" | "ask" | null | undefined;
+        readonly initiatedBy?: string | null | undefined;
+        readonly sourceTask?: unknown;
+        readonly serverPid?: number | null | undefined;
+        readonly latestSteeringAt?: string | null | undefined;
+        readonly latestSteeringDeliveredAt?: string | null | undefined;
+        readonly statusDetail?: string | null | undefined;
+    };
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly payload: unknown;
+    readonly type: "timeline-entry";
+    readonly seq: number;
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly payload: unknown;
+    readonly type: "log-entry";
+    readonly seq: number;
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly payload: unknown;
+    readonly type: "approval-requested";
+    readonly requestId: string;
+    readonly requestKind: string;
+    readonly seq: number;
+    readonly actionId?: string | null | undefined;
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly decision: "approve" | "reject";
+    readonly type: "approval-resolved";
+    readonly requestId: string;
+    readonly actor: {
+        readonly kind: "server" | "system" | "operator" | "agent";
+        readonly id?: string | null | undefined;
+    };
+    readonly seq: number;
+    readonly note?: string | null | undefined;
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly payload: unknown;
+    readonly type: "input-requested";
+    readonly requestId: string;
+    readonly seq: number;
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly type: "input-resolved";
+    readonly requestId: string;
+    readonly answers: {
+        readonly [x: string]: string;
+    };
+    readonly actor: {
+        readonly kind: "server" | "system" | "operator" | "agent";
+        readonly id?: string | null | undefined;
+    };
+    readonly seq: number;
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly text: string;
+    readonly type: "steering";
+    readonly actor: {
+        readonly kind: "server" | "system" | "operator" | "agent";
+        readonly id?: string | null | undefined;
+    };
+    readonly seq: number;
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly type: "adopted";
+    readonly pid: number | null;
+    readonly serverPid: number;
+    readonly seq: number;
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly detail: string;
+    readonly type: "stall-detected";
+    readonly seq: number;
+} | {
+    readonly at: string;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly v: 1;
+    readonly type: "closeout-phase";
+    readonly phase: "push" | "merge" | "completed" | "queued" | "commit" | "pr-review-merge" | "pr-opened" | "close-source";
+    readonly seq: number;
+    readonly outcome: "completed" | "failed" | "started";
+    readonly detail?: string | null | undefined;
+};
+export declare const RUN_STATUS_TRANSITIONS: Readonly<Record<RunStatus, readonly RunStatus[]>>;
+export declare const TERMINAL_RUN_STATUSES: readonly RunStatus[];
+export declare const ACTIVE_RUN_STATUSES: readonly RunStatus[];
+export declare function isTerminalRunStatus(status: RunStatus): boolean;
+export declare function isActiveRunStatus(status: RunStatus): boolean;
+export declare function canTransitionRunStatus(from: RunStatus | null, to: RunStatus): boolean;
+/** Writer-side guard: throws on an illegal transition so bugs fail loudly at the source. */
+export declare function assertRunStatusTransition(from: RunStatus | null, to: RunStatus): void;
+export type RunJournalAnomaly = {
+    seq: number;
+    kind: "illegal-transition" | "duplicate-resolution" | "unknown-request";
+    detail: string;
+};
+export type RunJournalPendingRequest = {
+    requestId: string;
+    requestKind: string;
+    actionId: string | null;
+    payload: unknown;
+    requestedAt: string;
+};
+export type RunJournalResolvedApproval = RunJournalPendingRequest & {
+    decision: ApprovalDecision;
+    note: string | null;
+    actor: RunActor;
+    resolvedAt: string;
+};
+export type RunJournalResolvedInput = RunJournalPendingRequest & {
+    answers: Readonly<Record<string, string>>;
+    actor: RunActor;
+    resolvedAt: string;
+};
+export type RunJournalProjection = {
+    record: Partial<RunJournalRecord>;
+    status: RunStatus | null;
+    statusHistory: ReadonlyArray<{
+        seq: number;
+        at: string;
+        from: RunStatus | null;
+        to: RunStatus;
+        reason: string | null;
+    }>;
+    pendingApprovals: ReadonlyArray<RunJournalPendingRequest>;
+    resolvedApprovals: ReadonlyArray<RunJournalResolvedApproval>;
+    pendingUserInputs: ReadonlyArray<RunJournalPendingRequest>;
+    resolvedUserInputs: ReadonlyArray<RunJournalResolvedInput>;
+    steeringCount: number;
+    stallCount: number;
+    closeoutPhases: ReadonlyArray<{
+        seq: number;
+        at: string;
+        phase: RunCloseoutPhase;
+        outcome: RunCloseoutPhaseOutcome;
+        detail: string | null;
+    }>;
+    lastSeq: number;
+    lastEventAt: string | null;
+    anomalies: ReadonlyArray<RunJournalAnomaly>;
+};
+export declare function reduceRunJournal(events: ReadonlyArray<RunJournalEvent>): RunJournalProjection;