@wjarka/cezarion 0.14.6 → 0.14.7-pr488.741

package/dist/runs/store.d.ts

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'node:events';
 import { z } from 'zod';
-import type { ConversationState, AgentInput, DelegationState, WorkerCollectedResult } from '../contract/index.js';
+import type { CiWait, ConversationState, AgentInput, InboxClaim, DelegationState, WorkerCollectedResult } from '../contract/index.js';
 import { type WorkerExecutionIdentity } from '../delegation/execution-identity.ts';
 import { workflowDefSchema } from '../workflows/types.ts';
 import type { RunnerId } from '../core/agent-runner.ts';
@@ -96,6 +96,7 @@ export declare const runRecordSchema: z.ZodObject<{
             human: "human";
             lifecycle: "lifecycle";
         }>>;
+        agentInputId: z.ZodOptional<z.ZodUUID>;
     }, z.core.$strip>>;
     invalidAsk: z.ZodOptional<z.ZodBoolean>;
     delegation: z.ZodCatch<z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -122,6 +123,8 @@ export declare const runRecordSchema: z.ZodObject<{
                     destroyed: "destroyed";
                     late: "late";
                 }>;
+                resumed: z.ZodOptional<z.ZodLiteral<true>>;
+                instruction: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>>;
             outcomes: z.ZodArray<z.ZodObject<{
                 requestId: z.ZodUUID;
@@ -483,7 +486,103 @@ export declare const runRecordSchema: z.ZodObject<{
         text: z.ZodString;
         createdAt: z.ZodISODateTime;
         deliveredAt: z.ZodOptional<z.ZodISODateTime>;
+        inboxClaim: z.ZodOptional<z.ZodObject<{
+            receiptId: z.ZodUUID;
+            generation: z.ZodUUID;
+            expiresAt: z.ZodISODateTime;
+            acknowledgedAt: z.ZodOptional<z.ZodISODateTime>;
+            memberIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>>;
+    ciWait: z.ZodOptional<z.ZodObject<{
+        prUrl: z.ZodString;
+        repository: z.ZodString;
+        prNumber: z.ZodNumber;
+        headSha: z.ZodString;
+        id: z.ZodUUID;
+        generation: z.ZodString;
+        turnId: z.ZodString;
+        timeoutSeconds: z.ZodNumber;
+        registeredAt: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        phase: z.ZodEnum<{
+            delivered: "delivered";
+            parked: "parked";
+            registered: "registered";
+            "wake-pending": "wake-pending";
+            withdrawn: "withdrawn";
+        }>;
+        result: z.ZodOptional<z.ZodObject<{
+            outcome: z.ZodEnum<{
+                cancelled: "cancelled";
+                deadline: "deadline";
+                error: "error";
+                failed: "failed";
+                head_changed: "head_changed";
+                no_checks: "no_checks";
+                passed: "passed";
+                skipped: "skipped";
+            }>;
+            headSha: z.ZodString;
+            observedHeadSha: z.ZodOptional<z.ZodString>;
+            observedAt: z.ZodISODateTime;
+            checks: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                state: z.ZodString;
+                link: z.ZodString;
+            }, z.core.$strict>>;
+            totalChecks: z.ZodNumber;
+            truncated: z.ZodBoolean;
+            diagnostic: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        wakeId: z.ZodOptional<z.ZodString>;
+        deliveredAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    lastCiWait: z.ZodOptional<z.ZodObject<{
+        prUrl: z.ZodString;
+        repository: z.ZodString;
+        prNumber: z.ZodNumber;
+        headSha: z.ZodString;
+        id: z.ZodUUID;
+        generation: z.ZodString;
+        turnId: z.ZodString;
+        timeoutSeconds: z.ZodNumber;
+        registeredAt: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        phase: z.ZodEnum<{
+            delivered: "delivered";
+            parked: "parked";
+            registered: "registered";
+            "wake-pending": "wake-pending";
+            withdrawn: "withdrawn";
+        }>;
+        result: z.ZodOptional<z.ZodObject<{
+            outcome: z.ZodEnum<{
+                cancelled: "cancelled";
+                deadline: "deadline";
+                error: "error";
+                failed: "failed";
+                head_changed: "head_changed";
+                no_checks: "no_checks";
+                passed: "passed";
+                skipped: "skipped";
+            }>;
+            headSha: z.ZodString;
+            observedHeadSha: z.ZodOptional<z.ZodString>;
+            observedAt: z.ZodISODateTime;
+            checks: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                state: z.ZodString;
+                link: z.ZodString;
+            }, z.core.$strict>>;
+            totalChecks: z.ZodNumber;
+            truncated: z.ZodBoolean;
+            diagnostic: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        wakeId: z.ZodOptional<z.ZodString>;
+        deliveredAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    lastCiWaitError: z.ZodOptional<z.ZodString>;
     taskImages: z.ZodOptional<z.ZodArray<z.ZodString>>;
     model: z.ZodOptional<z.ZodString>;
     effort: z.ZodOptional<z.ZodString>;
@@ -641,6 +740,422 @@ export declare const runRecordSchema: z.ZodObject<{
         path: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+/** Salvage CI state identically for live stores and the read-only workspace index. */
+export declare function parseRunRecords(raw: unknown): z.ZodSafeParseResult<{
+    id: string;
+    title: string;
+    titleSummary?: string | undefined;
+    diffStat?: {
+        adds: number;
+        dels: number;
+        files: number;
+        repointed?: boolean | undefined;
+    } | undefined;
+    workflow: string;
+    task: string;
+    queuedMessages?: {
+        id: string;
+        text: string;
+        images?: string[] | undefined;
+        createdAt: string;
+    }[] | undefined;
+    continuationMessage?: {
+        id: string;
+        text: string;
+        images?: string[] | undefined;
+        createdAt: string;
+        origin?: "human" | "lifecycle" | undefined;
+        agentInputId?: string | undefined;
+    } | undefined;
+    invalidAsk?: boolean | undefined;
+    delegation?: {
+        role: "root";
+        conversation?: {
+            messages: {
+                senderRunId: string;
+                recipientRunId: string;
+                kind: "follow-up" | "progress" | "reply" | "request";
+                requestId?: string | undefined;
+                id: string;
+                text: string;
+                createdAt: string;
+                deadline?: string | undefined;
+                requestHash: string;
+                state: "accepted" | "continuation-required" | "destroyed" | "late";
+                resumed?: true | undefined;
+                instruction?: string | undefined;
+            }[];
+            outcomes: {
+                requestId: string;
+                status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                observedAt: string;
+                replyId?: string | undefined;
+            }[];
+        } | undefined;
+        permissions: ("destroy" | "diff" | "inspect" | "spawn" | "steer" | "stop" | "wait")[];
+        receipts: {
+            requestId: string;
+            workerId: string;
+            requestHash: string;
+            deletion?: {
+                phase: "complete" | "pending";
+                revision: number;
+                resourceId: string;
+                generation: string;
+            } | undefined;
+        }[];
+        wait?: {
+            id: string;
+            workerIds: string[];
+            requestIds?: string[] | undefined;
+            requestOutcomes?: {
+                requestId: string;
+                status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                observedAt: string;
+                replyId?: string | undefined;
+            }[] | undefined;
+            deadline: string;
+            mode?: "all" | "any" | "one" | undefined;
+            revisions?: {
+                workerId: string;
+                revision: number;
+            }[] | undefined;
+            reason?: "cancelled" | "message" | "outcome" | "timeout" | undefined;
+            phase: "parked" | "registered" | "wake-pending";
+            outcomes: {
+                workerId: string;
+                status: "cancelled" | "done" | "failed" | "review";
+                observedAt: string;
+                summary?: string | undefined;
+                revision?: number | undefined;
+            }[];
+            wakeId?: string | undefined;
+        } | undefined;
+        lastWait?: {
+            id: string;
+            workerIds: string[];
+            requestIds?: string[] | undefined;
+            requestOutcomes?: {
+                requestId: string;
+                status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                observedAt: string;
+                replyId?: string | undefined;
+            }[] | undefined;
+            deadline: string;
+            mode?: "all" | "any" | "one" | undefined;
+            revisions?: {
+                workerId: string;
+                revision: number;
+            }[] | undefined;
+            reason?: "cancelled" | "message" | "outcome" | "timeout" | undefined;
+            phase: "parked" | "registered" | "wake-pending";
+            outcomes: {
+                workerId: string;
+                status: "cancelled" | "done" | "failed" | "review";
+                observedAt: string;
+                summary?: string | undefined;
+                revision?: number | undefined;
+            }[];
+            wakeId?: string | undefined;
+        } | undefined;
+        results?: {
+            workerId: string;
+            revision: number;
+            snapshotId: string;
+            observedAt: string;
+            lastExecutionOutcome: "cancelled" | "completed" | "failed" | "review-ready" | "running";
+            previous?: {
+                revision: number;
+                observedAt: string;
+                lastExecutionOutcome: "cancelled" | "completed" | "failed" | "review-ready" | "running";
+            } | undefined;
+        }[] | undefined;
+        finishRequestedAt?: string | undefined;
+        historyDeletion?: "pending" | undefined;
+        completion?: {
+            phase: "attention" | "waiting";
+            waitId?: string | undefined;
+        } | undefined;
+    } | {
+        role: "worker";
+        wait?: {
+            id: string;
+            workerIds: string[];
+            requestIds?: string[] | undefined;
+            requestOutcomes?: {
+                requestId: string;
+                status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                observedAt: string;
+                replyId?: string | undefined;
+            }[] | undefined;
+            deadline: string;
+            mode?: "all" | "any" | "one" | undefined;
+            revisions?: {
+                workerId: string;
+                revision: number;
+            }[] | undefined;
+            reason?: "cancelled" | "message" | "outcome" | "timeout" | undefined;
+            phase: "parked" | "registered" | "wake-pending";
+            outcomes: {
+                workerId: string;
+                status: "cancelled" | "done" | "failed" | "review";
+                observedAt: string;
+                summary?: string | undefined;
+                revision?: number | undefined;
+            }[];
+            wakeId?: string | undefined;
+        } | undefined;
+        lastWait?: {
+            id: string;
+            workerIds: string[];
+            requestIds?: string[] | undefined;
+            requestOutcomes?: {
+                requestId: string;
+                status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                observedAt: string;
+                replyId?: string | undefined;
+            }[] | undefined;
+            deadline: string;
+            mode?: "all" | "any" | "one" | undefined;
+            revisions?: {
+                workerId: string;
+                revision: number;
+            }[] | undefined;
+            reason?: "cancelled" | "message" | "outcome" | "timeout" | undefined;
+            phase: "parked" | "registered" | "wake-pending";
+            outcomes: {
+                workerId: string;
+                status: "cancelled" | "done" | "failed" | "review";
+                observedAt: string;
+                summary?: string | undefined;
+                revision?: number | undefined;
+            }[];
+            wakeId?: string | undefined;
+        } | undefined;
+        permissions: ("destroy" | "diff" | "inspect" | "spawn" | "steer" | "stop" | "wait")[];
+        parentRunId: string;
+        workspace: {
+            ownerRunId: string;
+            resourceId: string;
+            kind: "owned-isolated";
+            path: string;
+            branch: string;
+            baselineSha: string;
+        };
+        destroy?: {
+            requestedAt: string;
+            phase: "cleaning" | "complete" | "incomplete" | "requested" | "terminating";
+            remaining: ("branch" | "process" | "worktree")[];
+            error?: string | undefined;
+        } | undefined;
+        context?: {
+            text?: string | undefined;
+            inputs: {
+                source: {
+                    kind: "baseline-file";
+                    path: string;
+                } | {
+                    kind: "parent-attachment";
+                    id: string;
+                };
+                path: string;
+                sha256: string;
+                bytes: number;
+            }[];
+        } | undefined;
+        executionRevision?: number | undefined;
+        executionStartSeq?: number | undefined;
+    } | {
+        role: "invalid";
+    } | undefined;
+    agentInputs?: {
+        conversation?: {
+            senderRunId: string;
+            recipientRunId: string;
+            kind: "follow-up" | "progress" | "reply" | "request";
+            requestId?: string | undefined;
+        } | undefined;
+        id: string;
+        source: "agent" | "lifecycle";
+        parentRunId: string;
+        text: string;
+        createdAt: string;
+        deliveredAt?: string | undefined;
+        inboxClaim?: {
+            receiptId: string;
+            generation: string;
+            expiresAt: string;
+            acknowledgedAt?: string | undefined;
+            memberIds?: string[] | undefined;
+        } | undefined;
+    }[] | undefined;
+    ciWait?: {
+        prUrl: string;
+        repository: string;
+        prNumber: number;
+        headSha: string;
+        id: string;
+        generation: string;
+        turnId: string;
+        timeoutSeconds: number;
+        registeredAt: string;
+        deadline: string;
+        phase: "delivered" | "parked" | "registered" | "wake-pending" | "withdrawn";
+        result?: {
+            outcome: "cancelled" | "deadline" | "error" | "failed" | "head_changed" | "no_checks" | "passed" | "skipped";
+            headSha: string;
+            observedHeadSha?: string | undefined;
+            observedAt: string;
+            checks: {
+                name: string;
+                state: string;
+                link: string;
+            }[];
+            totalChecks: number;
+            truncated: boolean;
+            diagnostic?: string | undefined;
+        } | undefined;
+        wakeId?: string | undefined;
+        deliveredAt?: string | undefined;
+    } | undefined;
+    lastCiWait?: {
+        prUrl: string;
+        repository: string;
+        prNumber: number;
+        headSha: string;
+        id: string;
+        generation: string;
+        turnId: string;
+        timeoutSeconds: number;
+        registeredAt: string;
+        deadline: string;
+        phase: "delivered" | "parked" | "registered" | "wake-pending" | "withdrawn";
+        result?: {
+            outcome: "cancelled" | "deadline" | "error" | "failed" | "head_changed" | "no_checks" | "passed" | "skipped";
+            headSha: string;
+            observedHeadSha?: string | undefined;
+            observedAt: string;
+            checks: {
+                name: string;
+                state: string;
+                link: string;
+            }[];
+            totalChecks: number;
+            truncated: boolean;
+            diagnostic?: string | undefined;
+        } | undefined;
+        wakeId?: string | undefined;
+        deliveredAt?: string | undefined;
+    } | undefined;
+    lastCiWaitError?: string | undefined;
+    taskImages?: string[] | undefined;
+    model?: string | undefined;
+    effort?: string | undefined;
+    modelIdentity?: string | undefined;
+    runner?: "claude" | "codex" | "cursor" | "opencode" | "pi" | undefined;
+    agentProfile?: string | undefined;
+    systemPrompt?: string | undefined;
+    generateFollowups?: boolean | undefined;
+    autonomous?: boolean | undefined;
+    automation?: {
+        automationId: string;
+        automationRevision: number;
+        receiptId: string;
+        event: string;
+        githubUrl: string;
+    } | undefined;
+    status: "cancelled" | "done" | "failed" | "queued" | "review" | "running" | "waiting";
+    stopping?: boolean | undefined;
+    activity?: "monitoring" | undefined;
+    hasPendingHumanAsk?: boolean | undefined;
+    monitoringWakeAt?: string | undefined;
+    monitoringWakeCapReached?: boolean | undefined;
+    autoResumeAt?: string | undefined;
+    autoResumeAttempts?: number | undefined;
+    createdAt: string;
+    startedAt?: string | undefined;
+    finishedAt?: string | undefined;
+    tokensUsed: number;
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+    costUsd?: number | undefined;
+    pullRequestUrl?: string | undefined;
+    referencedPullRequestUrl?: string | undefined;
+    prNumber?: number | undefined;
+    issueNumber?: number | undefined;
+    referencedIssueNumberSeeded?: boolean | undefined;
+    titleOrigin?: "auto" | "marker" | "user" | undefined;
+    markerRefs?: {
+        pr?: number | undefined;
+        issue?: number | undefined;
+    } | undefined;
+    referencedPrCandidates?: string[] | undefined;
+    referencedIssueUrl?: string | undefined;
+    referencedIssueCandidates?: string[] | undefined;
+    worktree?: false | undefined;
+    worktreePath?: string | undefined;
+    branch?: string | undefined;
+    baseBranch?: string | undefined;
+    worktreeReclaimedAt?: string | undefined;
+    groupId?: string | undefined;
+    variant?: string | undefined;
+    peakRssBytes?: number | undefined;
+    peakProcCount?: number | undefined;
+    archived: boolean;
+    archivedAt?: string | undefined;
+    pinned?: boolean | undefined;
+    pinnedAt?: string | undefined;
+    seenAt?: string | undefined;
+    currentStepId?: string | undefined;
+    error?: string | undefined;
+    steps: {
+        id: string;
+        name: string;
+        kind: "agent" | "check";
+        status: "cancelled" | "done" | "failed" | "pending" | "review" | "running" | "skipped" | "waiting";
+        iterations: number;
+        retriesUsed?: number | undefined;
+        tokensUsed: number;
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        usageInvocationsStarted?: number | undefined;
+        usageInvocationsObserved?: number | undefined;
+        usageTurnsStarted?: number | undefined;
+        usageTurnsRecorded?: number | undefined;
+        usageInvocationEpoch?: number | undefined;
+        startedAt?: string | undefined;
+        finishedAt?: string | undefined;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+        backend?: "claude" | "codex" | "cursor" | "opencode" | "pi" | undefined;
+        profileId?: string | undefined;
+        costUsd?: number | undefined;
+        synthetic?: "continuation" | undefined;
+    }[];
+    workflowDef?: {
+        name: string;
+        description?: string | undefined;
+        steps: {
+            id: string;
+            name?: string | undefined;
+            prompt?: string | undefined;
+            skill?: string | undefined;
+            model?: string | undefined;
+            effort?: string | undefined;
+            runner?: "claude" | "codex" | "cursor" | "opencode" | "pi" | undefined;
+            agentProfile?: string | undefined;
+            allowedTools?: string[] | undefined;
+            bashAllowlist?: string[] | undefined;
+            command?: string | undefined;
+            onFail?: {
+                retry: string;
+                max: number;
+            } | undefined;
+        }[];
+        source: "built-in" | "file";
+        path?: string | undefined;
+    } | undefined;
+}[]>;
 export type StepState = z.infer<typeof stepStateSchema>;
 export type QueuedMessage = z.infer<typeof queuedMessageSchema>;
 export type RunRecord = z.infer<typeof runRecordSchema>;
@@ -746,7 +1261,19 @@ export declare class RunStore extends EventEmitter {
         input: AgentInput;
     }): void;
     /** Observable atomic input checkpoint: a failed write publishes nothing. */
-    commitAgentInputs(id: string, inputs: readonly AgentInput[]): void;
+    commitAgentInputs(id: string, inputs: readonly AgentInput[], openingContinuationInputId?: string): void;
+    /** Reserve only unread conversation inputs in one durable index replacement. */
+    claimInboxInputs(runId: string, ids: readonly string[], claim: InboxClaim): void;
+    /** A receipt owns every matching input or none; exact ACK retries preserve the first timestamp. */
+    ackInboxInputs(runId: string, receiptId: string, generation: string, at: string): 'acknowledged' | 'already-acknowledged';
+    releaseInboxInputs(runId: string, receiptId: string, generation: string): 'released';
+    clearExpiredInboxClaims(runId: string, now: string): void;
+    /** CI intent and its wake entry share one atomic index replacement. */
+    commitCiWait(id: string, wait: CiWait, input?: AgentInput): void;
+    /** Retire the wait and precisely its pending wake, optionally accepting human input. */
+    commitCiWaitWithdrawal(id: string, acceptedHumanMessage?: QueuedMessage): void;
+    /** Provider acceptance and receipt retirement have one delivery checkpoint. */
+    commitCiWaitDelivery(id: string, inputId: string): void;
     /** Retain the settled receipt and retire exactly one wait together with any human message that superseded it. */
     commitWorkerWaitWithdrawal(id: string, waitId: string, acceptedHumanMessage?: QueuedMessage): void;
     /** Successful deferred human delivery consumes only its persisted queue ID.
@@ -766,7 +1293,11 @@ export declare class RunStore extends EventEmitter {
         delegation: DelegationState;
     }>): void;
     /** Accepted execution revision is public lifecycle identity, separate from process generations. */
-    commitWorkerContinuation(id: string, patch: Partial<Omit<RunRecord, 'id' | 'steps' | 'delegation'>>, step?: Pick<StepState, 'id' | 'name' | 'kind' | 'synthetic'>): void;
+    commitWorkerContinuation(id: string, patch: Partial<Omit<RunRecord, 'id' | 'steps' | 'delegation'>>, step?: Pick<StepState, 'id' | 'name' | 'kind' | 'synthetic'>, conversation?: {
+        rootId: string;
+        state: ConversationState;
+        input: AgentInput;
+    }): void;
     private workerResultsDir;
     workerResultSnapshotPath(parentId: string, workerId: string, snapshotId: string): string;
     private readWorkerResultFile;