@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/contract/delegation.d.ts

@@ -10,6 +10,8 @@ export declare const workerOperationSchema: z.ZodEnum<{
     wait: "wait";
 }>;
 export type WorkerOperation = z.infer<typeof workerOperationSchema>;
+/** 1–32 unique ids; the worker wait entry and `cezar_wait` reuse it for worker and request ids. */
+export declare const workerIdsSchema: z.ZodArray<z.ZodUUID>;
 export declare const workerWorkspaceSchema: z.ZodObject<{
     ownerRunId: z.ZodUUID;
     resourceId: z.ZodUUID;
@@ -50,6 +52,7 @@ export declare const workerWaitSchema: z.ZodObject<{
             failed: "failed";
             "human-fallback": "human-fallback";
             replied: "replied";
+            "replied-late": "replied-late";
             "sender-closed": "sender-closed";
             "timed-out": "timed-out";
         }>;
@@ -92,6 +95,48 @@ export declare const workerWaitSchema: z.ZodObject<{
     wakeId: z.ZodOptional<z.ZodUUID>;
 }, z.core.$strict>;
 export type WorkerWait = z.infer<typeof workerWaitSchema>;
+/** Cezar's completion wait as inspection and the relationships view show it: the `WorkerWait`
+ *  projection without a deadline, which that wait does not have, and the `via` that names it.
+ *  `WorkerWait` keeps requiring a deadline (hearsay-tools/cezarion#1301). */
+export declare const workerCompletionWaitSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    workerIds: z.ZodArray<z.ZodUUID>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        all: "all";
+        any: "any";
+        one: "one";
+    }>>;
+    revisions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        workerId: z.ZodUUID;
+        revision: z.ZodNumber;
+    }, z.core.$strict>>>;
+    reason: z.ZodOptional<z.ZodEnum<{
+        cancelled: "cancelled";
+        message: "message";
+        outcome: "outcome";
+        timeout: "timeout";
+    }>>;
+    phase: z.ZodEnum<{
+        parked: "parked";
+        registered: "registered";
+        "wake-pending": "wake-pending";
+    }>;
+    outcomes: z.ZodArray<z.ZodObject<{
+        workerId: z.ZodUUID;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            review: "review";
+        }>;
+        observedAt: z.ZodISODateTime;
+        summary: z.ZodOptional<z.ZodString>;
+        revision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    wakeId: z.ZodOptional<z.ZodUUID>;
+    via: z.ZodLiteral<"completion">;
+}, z.core.$strict>;
+export type WorkerCompletionWait = z.infer<typeof workerCompletionWaitSchema>;
 /** Automatic retries of a pending destroy (hearsay-tools/cezarion#879): how many scheduled
  * attempts ran since the last explicit request, when the next one is due, and whether they
  * reached the hourly cap with nothing changing, which the cockpit shows as needing attention.
@@ -166,12 +211,21 @@ export declare const workerBackendSchema: z.ZodEnum<{
     opencode: "opencode";
     pi: "pi";
 }>;
+/**
+ * Why a `parent-file` path may never be attached, or undefined. An attached `.gitignore` would
+ * rewrite the worker worktree's ignore rules and could re-include another attachment, which its
+ * diff and autosave would then carry (hearsay-tools/cezarion#1149). The schema and the server share it.
+ */
+export declare function parentFileRefusal(path: string): string | undefined;
 export declare const workerContextReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"baseline-file">;
     path: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"parent-attachment">;
     id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"parent-file">;
+    path: z.ZodString;
 }, z.core.$strict>], "kind">;
 export type WorkerContextReference = z.infer<typeof workerContextReferenceSchema>;
 export declare const workerContextSchema: z.ZodObject<{
@@ -182,6 +236,9 @@ export declare const workerContextSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"parent-attachment">;
         id: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"parent-file">;
+        path: z.ZodString;
     }, z.core.$strict>], "kind">>>;
 }, z.core.$strict>;
 export declare const workerInputSchema: z.ZodObject<{
@@ -191,6 +248,9 @@ export declare const workerInputSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"parent-attachment">;
         id: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"parent-file">;
+        path: z.ZodString;
     }, z.core.$strict>], "kind">;
     path: z.ZodString;
     sha256: z.ZodString;
@@ -206,6 +266,9 @@ export declare const workerInputRecipeSchema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"parent-attachment">;
             id: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"parent-file">;
+            path: z.ZodString;
         }, z.core.$strict>], "kind">;
         path: z.ZodString;
         sha256: z.ZodString;
@@ -580,14 +643,15 @@ export declare const delegationStateSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             resumed: z.ZodOptional<z.ZodLiteral<true>>;
             instruction: z.ZodOptional<z.ZodString>;
             question: z.ZodOptional<z.ZodObject<{
+                context: z.ZodOptional<z.ZodString>;
                 questions: z.ZodArray<z.ZodObject<{
                     id: z.ZodOptional<z.ZodString>;
                     header: z.ZodString;
                     question: z.ZodString;
-                    options: z.ZodArray<z.ZodObject<{
+                    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         label: z.ZodString;
                         description: z.ZodOptional<z.ZodString>;
-                    }, z.core.$strict>>;
+                    }, z.core.$strict>>>;
                     multiSelect: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
@@ -601,6 +665,7 @@ export declare const delegationStateSchema: z.ZodDiscriminatedUnion<[z.ZodObject
                 failed: "failed";
                 "human-fallback": "human-fallback";
                 replied: "replied";
+                "replied-late": "replied-late";
                 "sender-closed": "sender-closed";
                 "timed-out": "timed-out";
             }>;
@@ -644,6 +709,7 @@ export declare const delegationStateSchema: z.ZodDiscriminatedUnion<[z.ZodObject
                 failed: "failed";
                 "human-fallback": "human-fallback";
                 replied: "replied";
+                "replied-late": "replied-late";
                 "sender-closed": "sender-closed";
                 "timed-out": "timed-out";
             }>;
@@ -698,6 +764,7 @@ export declare const delegationStateSchema: z.ZodDiscriminatedUnion<[z.ZodObject
                 failed: "failed";
                 "human-fallback": "human-fallback";
                 replied: "replied";
+                "replied-late": "replied-late";
                 "sender-closed": "sender-closed";
                 "timed-out": "timed-out";
             }>;
@@ -787,6 +854,7 @@ export declare const delegationStateSchema: z.ZodDiscriminatedUnion<[z.ZodObject
                 failed: "failed";
                 "human-fallback": "human-fallback";
                 replied: "replied";
+                "replied-late": "replied-late";
                 "sender-closed": "sender-closed";
                 "timed-out": "timed-out";
             }>;
@@ -841,6 +909,7 @@ export declare const delegationStateSchema: z.ZodDiscriminatedUnion<[z.ZodObject
                 failed: "failed";
                 "human-fallback": "human-fallback";
                 replied: "replied";
+                "replied-late": "replied-late";
                 "sender-closed": "sender-closed";
                 "timed-out": "timed-out";
             }>;
@@ -925,6 +994,9 @@ export declare const delegationStateSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             }, z.core.$strict>, z.ZodObject<{
                 kind: z.ZodLiteral<"parent-attachment">;
                 id: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"parent-file">;
+                path: z.ZodString;
             }, z.core.$strict>], "kind">;
             path: z.ZodString;
             sha256: z.ZodString;
@@ -979,6 +1051,9 @@ export declare const workerSpawnRequestSchema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"parent-attachment">;
             id: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"parent-file">;
+            path: z.ZodString;
         }, z.core.$strict>], "kind">>>;
     }, z.core.$strict>>;
     backend: z.ZodOptional<z.ZodEnum<{
@@ -1047,6 +1122,7 @@ export declare const agentInputSchema: z.ZodObject<{
         acknowledgedAt: z.ZodOptional<z.ZodISODateTime>;
         memberIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
     }, z.core.$strict>>;
+    purpose: z.ZodOptional<z.ZodLiteral<"completion-refusal">>;
 }, z.core.$strict>;
 export type AgentInput = z.infer<typeof agentInputSchema>;
 export declare const workerInspectionSchema: z.ZodObject<{
@@ -1062,9 +1138,6 @@ export declare const workerInspectionSchema: z.ZodObject<{
         waiting: "waiting";
     }>;
     currentStepId: z.ZodOptional<z.ZodString>;
-    activity: z.ZodOptional<z.ZodEnum<{
-        monitoring: "monitoring";
-    }>>;
     workspace: z.ZodObject<{
         ownerRunId: z.ZodUUID;
         resourceId: z.ZodUUID;
@@ -1089,6 +1162,9 @@ export declare const workerInspectionSchema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"parent-attachment">;
             id: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"parent-file">;
+            path: z.ZodString;
         }, z.core.$strict>], "kind">;
         path: z.ZodString;
         sha256: z.ZodString;
@@ -1107,6 +1183,7 @@ export declare const workerInspectionSchema: z.ZodObject<{
                 failed: "failed";
                 "human-fallback": "human-fallback";
                 replied: "replied";
+                "replied-late": "replied-late";
                 "sender-closed": "sender-closed";
                 "timed-out": "timed-out";
             }>;
@@ -1148,6 +1225,44 @@ export declare const workerInspectionSchema: z.ZodObject<{
         }, z.core.$strict>>;
         wakeId: z.ZodOptional<z.ZodUUID>;
     }, z.core.$strict>>;
+    completionWait: z.ZodOptional<z.ZodObject<{
+        id: z.ZodUUID;
+        workerIds: z.ZodArray<z.ZodUUID>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            any: "any";
+            one: "one";
+        }>>;
+        revisions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            workerId: z.ZodUUID;
+            revision: z.ZodNumber;
+        }, z.core.$strict>>>;
+        reason: z.ZodOptional<z.ZodEnum<{
+            cancelled: "cancelled";
+            message: "message";
+            outcome: "outcome";
+            timeout: "timeout";
+        }>>;
+        phase: z.ZodEnum<{
+            parked: "parked";
+            registered: "registered";
+            "wake-pending": "wake-pending";
+        }>;
+        outcomes: z.ZodArray<z.ZodObject<{
+            workerId: z.ZodUUID;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                review: "review";
+            }>;
+            observedAt: z.ZodISODateTime;
+            summary: z.ZodOptional<z.ZodString>;
+            revision: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        wakeId: z.ZodOptional<z.ZodUUID>;
+        via: z.ZodLiteral<"completion">;
+    }, z.core.$strict>>;
     destroy: z.ZodOptional<z.ZodObject<{
         requestedAt: z.ZodISODateTime;
         phase: z.ZodEnum<{
@@ -1183,6 +1298,154 @@ export declare const workerInspectionSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strip>;
 export type WorkerInspection = z.infer<typeof workerInspectionSchema>;
+/** Small summaries omit inspection inputs, wait payloads and assistant output. */
+export declare const workerListEntrySchema: z.ZodObject<{
+    workerId: z.ZodUUID;
+    parentRunId: z.ZodUUID;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        queued: "queued";
+        review: "review";
+        running: "running";
+        waiting: "waiting";
+    }>;
+    workspace: z.ZodObject<{
+        ownerRunId: z.ZodUUID;
+        resourceId: z.ZodUUID;
+        kind: z.ZodLiteral<"owned-isolated">;
+        path: z.ZodString;
+        branch: z.ZodString;
+        baselineSha: z.ZodString;
+    }, z.core.$strict>;
+    destroy: z.ZodOptional<z.ZodObject<{
+        requestedAt: z.ZodISODateTime;
+        phase: z.ZodEnum<{
+            cleaning: "cleaning";
+            complete: "complete";
+            incomplete: "incomplete";
+            requested: "requested";
+            terminating: "terminating";
+        }>;
+        remaining: z.ZodArray<z.ZodEnum<{
+            branch: "branch";
+            process: "process";
+            worktree: "worktree";
+        }>>;
+        error: z.ZodOptional<z.ZodString>;
+        retry: z.ZodOptional<z.ZodObject<{
+            attempts: z.ZodNumber;
+            nextAt: z.ZodISODateTime;
+            needsAttention: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    revision: z.ZodNumber;
+    settled: z.ZodBoolean;
+    destroyed: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const workerListResultSchema: z.ZodObject<{
+    workers: z.ZodArray<z.ZodObject<{
+        workerId: z.ZodUUID;
+        parentRunId: z.ZodUUID;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            queued: "queued";
+            review: "review";
+            running: "running";
+            waiting: "waiting";
+        }>;
+        workspace: z.ZodObject<{
+            ownerRunId: z.ZodUUID;
+            resourceId: z.ZodUUID;
+            kind: z.ZodLiteral<"owned-isolated">;
+            path: z.ZodString;
+            branch: z.ZodString;
+            baselineSha: z.ZodString;
+        }, z.core.$strict>;
+        destroy: z.ZodOptional<z.ZodObject<{
+            requestedAt: z.ZodISODateTime;
+            phase: z.ZodEnum<{
+                cleaning: "cleaning";
+                complete: "complete";
+                incomplete: "incomplete";
+                requested: "requested";
+                terminating: "terminating";
+            }>;
+            remaining: z.ZodArray<z.ZodEnum<{
+                branch: "branch";
+                process: "process";
+                worktree: "worktree";
+            }>>;
+            error: z.ZodOptional<z.ZodString>;
+            retry: z.ZodOptional<z.ZodObject<{
+                attempts: z.ZodNumber;
+                nextAt: z.ZodISODateTime;
+                needsAttention: z.ZodOptional<z.ZodLiteral<true>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        revision: z.ZodNumber;
+        settled: z.ZodBoolean;
+        destroyed: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkerListResult = z.infer<typeof workerListResultSchema>;
+/** Receipt offsets are scoped to the authenticated parent; each page examines at most 32. */
+export declare const workerListQuerySchema: z.ZodObject<{
+    offset: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type WorkerListQuery = z.infer<typeof workerListQuerySchema>;
+export declare const workerListPageSchema: z.ZodObject<{
+    workers: z.ZodArray<z.ZodObject<{
+        workerId: z.ZodUUID;
+        parentRunId: z.ZodUUID;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            queued: "queued";
+            review: "review";
+            running: "running";
+            waiting: "waiting";
+        }>;
+        workspace: z.ZodObject<{
+            ownerRunId: z.ZodUUID;
+            resourceId: z.ZodUUID;
+            kind: z.ZodLiteral<"owned-isolated">;
+            path: z.ZodString;
+            branch: z.ZodString;
+            baselineSha: z.ZodString;
+        }, z.core.$strict>;
+        destroy: z.ZodOptional<z.ZodObject<{
+            requestedAt: z.ZodISODateTime;
+            phase: z.ZodEnum<{
+                cleaning: "cleaning";
+                complete: "complete";
+                incomplete: "incomplete";
+                requested: "requested";
+                terminating: "terminating";
+            }>;
+            remaining: z.ZodArray<z.ZodEnum<{
+                branch: "branch";
+                process: "process";
+                worktree: "worktree";
+            }>>;
+            error: z.ZodOptional<z.ZodString>;
+            retry: z.ZodOptional<z.ZodObject<{
+                attempts: z.ZodNumber;
+                nextAt: z.ZodISODateTime;
+                needsAttention: z.ZodOptional<z.ZodLiteral<true>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        revision: z.ZodNumber;
+        settled: z.ZodBoolean;
+        destroyed: z.ZodBoolean;
+    }, z.core.$strict>>;
+    nextOffset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type WorkerListPage = z.infer<typeof workerListPageSchema>;
 export declare const workerDiffSchema: z.ZodObject<{
     workerId: z.ZodUUID;
     baselineSha: z.ZodString;
@@ -1255,9 +1518,6 @@ export declare const runRelationshipsSchema: z.ZodObject<{
             waiting: "waiting";
         }>;
         currentStepId: z.ZodOptional<z.ZodString>;
-        activity: z.ZodOptional<z.ZodEnum<{
-            monitoring: "monitoring";
-        }>>;
         workspace: z.ZodObject<{
             ownerRunId: z.ZodUUID;
             resourceId: z.ZodUUID;
@@ -1282,6 +1542,9 @@ export declare const runRelationshipsSchema: z.ZodObject<{
             }, z.core.$strict>, z.ZodObject<{
                 kind: z.ZodLiteral<"parent-attachment">;
                 id: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"parent-file">;
+                path: z.ZodString;
             }, z.core.$strict>], "kind">;
             path: z.ZodString;
             sha256: z.ZodString;
@@ -1300,6 +1563,7 @@ export declare const runRelationshipsSchema: z.ZodObject<{
                     failed: "failed";
                     "human-fallback": "human-fallback";
                     replied: "replied";
+                    "replied-late": "replied-late";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
                 }>;
@@ -1341,6 +1605,44 @@ export declare const runRelationshipsSchema: z.ZodObject<{
             }, z.core.$strict>>;
             wakeId: z.ZodOptional<z.ZodUUID>;
         }, z.core.$strict>>;
+        completionWait: z.ZodOptional<z.ZodObject<{
+            id: z.ZodUUID;
+            workerIds: z.ZodArray<z.ZodUUID>;
+            mode: z.ZodOptional<z.ZodEnum<{
+                all: "all";
+                any: "any";
+                one: "one";
+            }>>;
+            revisions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                workerId: z.ZodUUID;
+                revision: z.ZodNumber;
+            }, z.core.$strict>>>;
+            reason: z.ZodOptional<z.ZodEnum<{
+                cancelled: "cancelled";
+                message: "message";
+                outcome: "outcome";
+                timeout: "timeout";
+            }>>;
+            phase: z.ZodEnum<{
+                parked: "parked";
+                registered: "registered";
+                "wake-pending": "wake-pending";
+            }>;
+            outcomes: z.ZodArray<z.ZodObject<{
+                workerId: z.ZodUUID;
+                status: z.ZodEnum<{
+                    cancelled: "cancelled";
+                    done: "done";
+                    failed: "failed";
+                    review: "review";
+                }>;
+                observedAt: z.ZodISODateTime;
+                summary: z.ZodOptional<z.ZodString>;
+                revision: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+            wakeId: z.ZodOptional<z.ZodUUID>;
+            via: z.ZodLiteral<"completion">;
+        }, z.core.$strict>>;
         destroy: z.ZodOptional<z.ZodObject<{
             requestedAt: z.ZodISODateTime;
             phase: z.ZodEnum<{
@@ -1470,6 +1772,7 @@ export declare const workerWaitResultSchema: z.ZodObject<{
                 failed: "failed";
                 "human-fallback": "human-fallback";
                 replied: "replied";
+                "replied-late": "replied-late";
                 "sender-closed": "sender-closed";
                 "timed-out": "timed-out";
             }>;
@@ -1533,6 +1836,7 @@ export declare const workerCancelWaitResultSchema: z.ZodObject<{
                 failed: "failed";
                 "human-fallback": "human-fallback";
                 replied: "replied";
+                "replied-late": "replied-late";
                 "sender-closed": "sender-closed";
                 "timed-out": "timed-out";
             }>;

package/dist/contract/events.d.ts

@@ -54,14 +54,15 @@ export declare const conversationMessageEventSchema: z.ZodObject<{
         resumed: z.ZodOptional<z.ZodLiteral<true>>;
         instruction: z.ZodOptional<z.ZodString>;
         question: z.ZodOptional<z.ZodObject<{
+            context: z.ZodOptional<z.ZodString>;
             questions: z.ZodArray<z.ZodObject<{
                 id: z.ZodOptional<z.ZodString>;
                 header: z.ZodString;
                 question: z.ZodString;
-                options: z.ZodArray<z.ZodObject<{
+                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     label: z.ZodString;
                     description: z.ZodOptional<z.ZodString>;
-                }, z.core.$strict>>;
+                }, z.core.$strict>>>;
                 multiSelect: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
@@ -90,6 +91,7 @@ export declare const requestOutcomeEventSchema: z.ZodObject<{
             failed: "failed";
             "human-fallback": "human-fallback";
             replied: "replied";
+            "replied-late": "replied-late";
             "sender-closed": "sender-closed";
             "timed-out": "timed-out";
         }>;
@@ -133,6 +135,7 @@ export declare const agentInputEventSchema: z.ZodObject<{
             acknowledgedAt: z.ZodOptional<z.ZodISODateTime>;
             memberIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
         }, z.core.$strict>>;
+        purpose: z.ZodOptional<z.ZodLiteral<"completion-refusal">>;
     }, z.core.$strict>;
 }, z.core.$loose>;
 export type AgentInputEvent = z.infer<typeof agentInputEventSchema>;
@@ -150,6 +153,22 @@ export declare const humanInputDeliveredEventSchema: z.ZodObject<{
     }>>;
 }, z.core.$loose>;
 export type HumanInputDeliveredEvent = z.infer<typeof humanInputDeliveredEventSchema>;
+/** The question was retired unanswered: an accepted Finish ended the task (`finish`,
+ * hearsay-tools/cezarion#1260), or new input went to a worker whose only question was Cezar's own
+ * fallback question (`superseded`, hearsay-tools/cezarion#1301). It retires the question like a
+ * delivery does, but nobody answered it. */
+export declare const humanAskClosedEventSchema: z.ZodObject<{
+    seq: z.ZodNumber;
+    ts: z.ZodString;
+    stepId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"human-ask-closed">;
+    askSeq: z.ZodNumber;
+    reason: z.ZodEnum<{
+        finish: "finish";
+        superseded: "superseded";
+    }>;
+}, z.core.$loose>;
+export type HumanAskClosedEvent = z.infer<typeof humanAskClosedEventSchema>;
 /** A worker's ask was sent to its owning parent as a conversation request (#505). */
 export declare const workerQuestionRoutedEventSchema: z.ZodObject<{
     seq: z.ZodNumber;
@@ -255,7 +274,8 @@ export type RunHistoryContext = z.infer<typeof runHistoryContextSchema>;
  *
  * `cloning` carries a single line of `git clone` output; `done` and `error` are terminal. The
  * clone dialog renders `error` VERBATIM — a clone fails for reasons (auth, network, a mistyped
- * repo) that only the server can name.
+ * repo) that only the server can name. The new-project flow reuses this frame; its `done` may
+ * carry a `warning`.
  */
 export declare const checkoutProgressEventSchema: z.ZodObject<{
     checkoutId: z.ZodOptional<z.ZodString>;
@@ -267,5 +287,6 @@ export declare const checkoutProgressEventSchema: z.ZodObject<{
     }>;
     line: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
+    warning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CheckoutProgressEvent = z.infer<typeof checkoutProgressEventSchema>;

package/dist/contract/github-requests.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const mergeNumberParams: z.ZodObject<{
+    number: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+export declare const prChangesParams: z.ZodObject<{
+    number: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+export declare const prChangesQuery: z.ZodObject<{
+    refresh: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>]>> & z.ZodType<"1" | undefined, string | string[] | undefined, z.core.$ZodTypeInternals<"1" | undefined, string | string[] | undefined>>;
+}, z.core.$strip>;
+export declare const mergeBodySchema: z.ZodObject<{
+    method: z.ZodEnum<{
+        merge: "merge";
+        rebase: "rebase";
+        squash: "squash";
+    }>;
+    expectedHeadSha: z.ZodString;
+    overrideRules: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strict>;
+export declare const githubChecksQuerySchema: z.ZodObject<{
+    prs: z.ZodString;
+}, z.core.$strip>;
+export declare const githubRefsQuerySchema: z.ZodObject<{
+    prs: z.ZodOptional<z.ZodString>;
+    issues: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;