@wjarka/cezarion 0.14.7-pr488.741 → 0.14.8-dev.817

package/dist/contract/runs.d.ts

@@ -190,6 +190,18 @@ export declare const runRecordSchema: z.ZodObject<{
                 }>;
                 resumed: z.ZodOptional<z.ZodLiteral<true>>;
                 instruction: z.ZodOptional<z.ZodString>;
+                question: z.ZodOptional<z.ZodObject<{
+                    questions: z.ZodArray<z.ZodObject<{
+                        id: z.ZodOptional<z.ZodString>;
+                        header: z.ZodString;
+                        question: z.ZodString;
+                        options: z.ZodArray<z.ZodObject<{
+                            label: z.ZodString;
+                            description: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>>;
+                        multiSelect: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
             }, z.core.$strict>>;
             outcomes: z.ZodArray<z.ZodObject<{
                 requestId: z.ZodUUID;
@@ -198,6 +210,7 @@ export declare const runRecordSchema: z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -240,6 +253,7 @@ export declare const runRecordSchema: z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -293,6 +307,7 @@ export declare const runRecordSchema: z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -381,6 +396,7 @@ export declare const runRecordSchema: z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -434,6 +450,7 @@ export declare const runRecordSchema: z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -551,6 +568,8 @@ export declare const runRecordSchema: z.ZodObject<{
         text: z.ZodString;
         createdAt: z.ZodISODateTime;
         deliveredAt: z.ZodOptional<z.ZodISODateTime>;
+        consumedAt: z.ZodOptional<z.ZodISODateTime>;
+        awaitingRead: z.ZodOptional<z.ZodLiteral<true>>;
         inboxClaim: z.ZodOptional<z.ZodObject<{
             receiptId: z.ZodUUID;
             generation: z.ZodUUID;
@@ -718,6 +737,8 @@ export declare const runRecordSchema: z.ZodObject<{
     worktreeReclaimedAt: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodString>;
     variant: z.ZodOptional<z.ZodString>;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+    clientRequestHash: z.ZodOptional<z.ZodString>;
     peakRssBytes: z.ZodOptional<z.ZodNumber>;
     peakProcCount: z.ZodOptional<z.ZodNumber>;
     archived: z.ZodBoolean;
@@ -866,6 +887,18 @@ export declare const apiRunSchema: z.ZodObject<{
                 }>;
                 resumed: z.ZodOptional<z.ZodLiteral<true>>;
                 instruction: z.ZodOptional<z.ZodString>;
+                question: z.ZodOptional<z.ZodObject<{
+                    questions: z.ZodArray<z.ZodObject<{
+                        id: z.ZodOptional<z.ZodString>;
+                        header: z.ZodString;
+                        question: z.ZodString;
+                        options: z.ZodArray<z.ZodObject<{
+                            label: z.ZodString;
+                            description: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>>;
+                        multiSelect: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
             }, z.core.$strict>>;
             outcomes: z.ZodArray<z.ZodObject<{
                 requestId: z.ZodUUID;
@@ -874,6 +907,7 @@ export declare const apiRunSchema: z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -916,6 +950,7 @@ export declare const apiRunSchema: z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -969,6 +1004,7 @@ export declare const apiRunSchema: z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -1057,6 +1093,7 @@ export declare const apiRunSchema: z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -1110,6 +1147,7 @@ export declare const apiRunSchema: z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -1227,6 +1265,8 @@ export declare const apiRunSchema: z.ZodObject<{
         text: z.ZodString;
         createdAt: z.ZodISODateTime;
         deliveredAt: z.ZodOptional<z.ZodISODateTime>;
+        consumedAt: z.ZodOptional<z.ZodISODateTime>;
+        awaitingRead: z.ZodOptional<z.ZodLiteral<true>>;
         inboxClaim: z.ZodOptional<z.ZodObject<{
             receiptId: z.ZodUUID;
             generation: z.ZodUUID;
@@ -1394,6 +1434,8 @@ export declare const apiRunSchema: z.ZodObject<{
     worktreeReclaimedAt: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodString>;
     variant: z.ZodOptional<z.ZodString>;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+    clientRequestHash: z.ZodOptional<z.ZodString>;
     peakRssBytes: z.ZodOptional<z.ZodNumber>;
     peakProcCount: z.ZodOptional<z.ZodNumber>;
     archived: z.ZodBoolean;
@@ -1789,6 +1831,18 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                 }>;
                 resumed: z.ZodOptional<z.ZodLiteral<true>>;
                 instruction: z.ZodOptional<z.ZodString>;
+                question: z.ZodOptional<z.ZodObject<{
+                    questions: z.ZodArray<z.ZodObject<{
+                        id: z.ZodOptional<z.ZodString>;
+                        header: z.ZodString;
+                        question: z.ZodString;
+                        options: z.ZodArray<z.ZodObject<{
+                            label: z.ZodString;
+                            description: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>>;
+                        multiSelect: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
             }, z.core.$strict>>;
             outcomes: z.ZodArray<z.ZodObject<{
                 requestId: z.ZodUUID;
@@ -1797,6 +1851,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -1839,6 +1894,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -1892,6 +1948,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -1980,6 +2037,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -2033,6 +2091,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                     "completed-without-reply": "completed-without-reply";
                     destroyed: "destroyed";
                     failed: "failed";
+                    "human-fallback": "human-fallback";
                     replied: "replied";
                     "sender-closed": "sender-closed";
                     "timed-out": "timed-out";
@@ -2150,6 +2209,8 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
         text: z.ZodString;
         createdAt: z.ZodISODateTime;
         deliveredAt: z.ZodOptional<z.ZodISODateTime>;
+        consumedAt: z.ZodOptional<z.ZodISODateTime>;
+        awaitingRead: z.ZodOptional<z.ZodLiteral<true>>;
         inboxClaim: z.ZodOptional<z.ZodObject<{
             receiptId: z.ZodUUID;
             generation: z.ZodUUID;
@@ -2317,6 +2378,8 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
     worktreeReclaimedAt: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodString>;
     variant: z.ZodOptional<z.ZodString>;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+    clientRequestHash: z.ZodOptional<z.ZodString>;
     peakRssBytes: z.ZodOptional<z.ZodNumber>;
     peakProcCount: z.ZodOptional<z.ZodNumber>;
     archived: z.ZodBoolean;
@@ -2458,6 +2521,18 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                     }>;
                     resumed: z.ZodOptional<z.ZodLiteral<true>>;
                     instruction: z.ZodOptional<z.ZodString>;
+                    question: z.ZodOptional<z.ZodObject<{
+                        questions: z.ZodArray<z.ZodObject<{
+                            id: z.ZodOptional<z.ZodString>;
+                            header: z.ZodString;
+                            question: z.ZodString;
+                            options: z.ZodArray<z.ZodObject<{
+                                label: z.ZodString;
+                                description: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strict>>;
+                            multiSelect: z.ZodOptional<z.ZodBoolean>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>>;
                 }, z.core.$strict>>;
                 outcomes: z.ZodArray<z.ZodObject<{
                     requestId: z.ZodUUID;
@@ -2466,6 +2541,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -2508,6 +2584,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -2561,6 +2638,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -2649,6 +2727,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -2702,6 +2781,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -2819,6 +2899,8 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
             text: z.ZodString;
             createdAt: z.ZodISODateTime;
             deliveredAt: z.ZodOptional<z.ZodISODateTime>;
+            consumedAt: z.ZodOptional<z.ZodISODateTime>;
+            awaitingRead: z.ZodOptional<z.ZodLiteral<true>>;
             inboxClaim: z.ZodOptional<z.ZodObject<{
                 receiptId: z.ZodUUID;
                 generation: z.ZodUUID;
@@ -2986,6 +3068,8 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
         worktreeReclaimedAt: z.ZodOptional<z.ZodString>;
         groupId: z.ZodOptional<z.ZodString>;
         variant: z.ZodOptional<z.ZodString>;
+        clientRequestId: z.ZodOptional<z.ZodString>;
+        clientRequestHash: z.ZodOptional<z.ZodString>;
         peakRssBytes: z.ZodOptional<z.ZodNumber>;
         peakProcCount: z.ZodOptional<z.ZodNumber>;
         archived: z.ZodBoolean;
@@ -3334,6 +3418,18 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
                     }>;
                     resumed: z.ZodOptional<z.ZodLiteral<true>>;
                     instruction: z.ZodOptional<z.ZodString>;
+                    question: z.ZodOptional<z.ZodObject<{
+                        questions: z.ZodArray<z.ZodObject<{
+                            id: z.ZodOptional<z.ZodString>;
+                            header: z.ZodString;
+                            question: z.ZodString;
+                            options: z.ZodArray<z.ZodObject<{
+                                label: z.ZodString;
+                                description: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strict>>;
+                            multiSelect: z.ZodOptional<z.ZodBoolean>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>>;
                 }, z.core.$strict>>;
                 outcomes: z.ZodArray<z.ZodObject<{
                     requestId: z.ZodUUID;
@@ -3342,6 +3438,7 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -3384,6 +3481,7 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -3437,6 +3535,7 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -3525,6 +3624,7 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -3578,6 +3678,7 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -3695,6 +3796,8 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
             text: z.ZodString;
             createdAt: z.ZodISODateTime;
             deliveredAt: z.ZodOptional<z.ZodISODateTime>;
+            consumedAt: z.ZodOptional<z.ZodISODateTime>;
+            awaitingRead: z.ZodOptional<z.ZodLiteral<true>>;
             inboxClaim: z.ZodOptional<z.ZodObject<{
                 receiptId: z.ZodUUID;
                 generation: z.ZodUUID;
@@ -3862,6 +3965,8 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
         worktreeReclaimedAt: z.ZodOptional<z.ZodString>;
         groupId: z.ZodOptional<z.ZodString>;
         variant: z.ZodOptional<z.ZodString>;
+        clientRequestId: z.ZodOptional<z.ZodString>;
+        clientRequestHash: z.ZodOptional<z.ZodString>;
         peakRssBytes: z.ZodOptional<z.ZodNumber>;
         peakProcCount: z.ZodOptional<z.ZodNumber>;
         archived: z.ZodBoolean;
@@ -4003,6 +4108,8 @@ export declare const imageInputSchema: z.ZodObject<{
     data: z.ZodString;
 }, z.core.$strip>;
 export type ImageInput = AttachmentInput;
+/** A request id names one run, so it cannot ask for ×2/×3. */
+export declare const CLIENT_REQUEST_VARIANTS_ERROR = "clientRequestId names one run; it cannot be combined with variants > 1";
 /**
  * The KEYS of `POST /runs`' body, before the XOR refinement that `createRunInputSchema` adds.
  *
@@ -4110,6 +4217,7 @@ export declare const createRunInputSchema: z.ZodObject<{
         data: z.ZodString;
     }, z.core.$strip>>>;
     todoId: z.ZodOptional<z.ZodString>;
+    clientRequestId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CreateRunInput = z.input<typeof createRunInputSchema>;
 /**

package/dist/contract/skills.d.ts

@@ -124,6 +124,18 @@ export declare const startTodoResponseSchema: z.ZodObject<{
                     }>;
                     resumed: z.ZodOptional<z.ZodLiteral<true>>;
                     instruction: z.ZodOptional<z.ZodString>;
+                    question: z.ZodOptional<z.ZodObject<{
+                        questions: z.ZodArray<z.ZodObject<{
+                            id: z.ZodOptional<z.ZodString>;
+                            header: z.ZodString;
+                            question: z.ZodString;
+                            options: z.ZodArray<z.ZodObject<{
+                                label: z.ZodString;
+                                description: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strict>>;
+                            multiSelect: z.ZodOptional<z.ZodBoolean>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>>;
                 }, z.core.$strict>>;
                 outcomes: z.ZodArray<z.ZodObject<{
                     requestId: z.ZodUUID;
@@ -132,6 +144,7 @@ export declare const startTodoResponseSchema: z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -174,6 +187,7 @@ export declare const startTodoResponseSchema: z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -227,6 +241,7 @@ export declare const startTodoResponseSchema: z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -315,6 +330,7 @@ export declare const startTodoResponseSchema: z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -368,6 +384,7 @@ export declare const startTodoResponseSchema: z.ZodObject<{
                         "completed-without-reply": "completed-without-reply";
                         destroyed: "destroyed";
                         failed: "failed";
+                        "human-fallback": "human-fallback";
                         replied: "replied";
                         "sender-closed": "sender-closed";
                         "timed-out": "timed-out";
@@ -485,6 +502,8 @@ export declare const startTodoResponseSchema: z.ZodObject<{
             text: z.ZodString;
             createdAt: z.ZodISODateTime;
             deliveredAt: z.ZodOptional<z.ZodISODateTime>;
+            consumedAt: z.ZodOptional<z.ZodISODateTime>;
+            awaitingRead: z.ZodOptional<z.ZodLiteral<true>>;
             inboxClaim: z.ZodOptional<z.ZodObject<{
                 receiptId: z.ZodUUID;
                 generation: z.ZodUUID;
@@ -652,6 +671,8 @@ export declare const startTodoResponseSchema: z.ZodObject<{
         worktreeReclaimedAt: z.ZodOptional<z.ZodString>;
         groupId: z.ZodOptional<z.ZodString>;
         variant: z.ZodOptional<z.ZodString>;
+        clientRequestId: z.ZodOptional<z.ZodString>;
+        clientRequestHash: z.ZodOptional<z.ZodString>;
         peakRssBytes: z.ZodOptional<z.ZodNumber>;
         peakProcCount: z.ZodOptional<z.ZodNumber>;
         archived: z.ZodBoolean;

package/dist/core/agent-runner.d.ts

@@ -186,8 +186,18 @@ export type AgentEvent = {
  | {
     type: 'session';
     sessionId: string;
-} | {
+}
+/** `unconsumedInputIds`: agent input accepted in this turn that the model never
+ *  read before the turn ended idle (#505). */
+ | {
     type: 'turn-end';
+    unconsumedInputIds?: readonly string[];
+}
+/** Accepted agent input the harness will not read without a new prompt, reported
+ *  outside a turn (an OpenCode lost wake) (#505). */
+ | {
+    type: 'input-unconsumed';
+    inputIds: readonly string[];
 } | {
     type: 'note';
     message: string;
@@ -226,6 +236,9 @@ export interface SessionOptions {
     /** Readiness hint only, not an acknowledgement or a turn completion. The
      * caller rechecks session identity, ask state and queue before retrying. */
     onAgentInputReady?: () => void;
+    /** The model received these inputs (replay echo, userMessage item, …). Fires at most
+     * once per ID and never from a transport acknowledgement (#505). */
+    onAgentInputConsumed?: (inputIds: readonly string[]) => void;
 }
 /**
  * A live agent session over one spawned backend process. The process stays
@@ -243,9 +256,11 @@ export interface AgentSession {
     /** Write a user message into the live session. False when it is closed. */
     sendMessage(content: ContentBlock[]): boolean;
     /** Synchronous non-human reservation: false refuses without writing; a Promise
-     * confirms transport acceptance, not turn completion. Reject retains caller
-     * ownership for replay. Never fall back to the human-answer seam. */
-    sendAgentMessage(content: ContentBlock[]): false | Promise<void>;
+     * confirms the HARNESS ACCEPTED the input — mid-turn on a `steer` runner — not that
+     * the model consumed it (#505). Reject retains caller ownership for replay.
+     * `inputIds` correlate `onAgentInputConsumed` and `turn-end.unconsumedInputIds`.
+     * Never fall back to the human-answer seam. */
+    sendAgentMessage(content: ContentBlock[], inputIds?: readonly string[]): false | Promise<void>;
     /**
      * Drop follow-ups queued while a turn was still in flight. A `CEZ:ASK` park
      * must call this so a mid-turn `sendMessage` cannot start a new turn after
@@ -260,10 +275,24 @@ export interface AgentSession {
     /** True while the session still accepts messages. */
     readonly open: boolean;
 }
+/** How a runner admits non-human input while a turn runs (#505). */
+export interface InputDelivery {
+    /** `steer`: accepted mid-turn, consumed inside the running turn. `boundary`: refused while busy. */
+    readonly mode: 'steer' | 'boundary';
+    /** Whether the wire tells us when the model actually received the input. */
+    readonly consumption: 'observable' | 'unobservable';
+    /** The native mechanism, for AGENT_PROTOCOL.md and the parity matrix. */
+    readonly via: string;
+}
+export declare const BOUNDARY_INPUT_DELIVERY: InputDelivery;
+/** Absent means the pre-#505 behavior every runner had. */
+export declare function inputDeliveryOf(runner: Pick<AgentRunner, 'inputDelivery'>): InputDelivery;
 export interface AgentRunner {
     readonly backend: AgentBackend;
     /** Which `AgentRunSpec` fields this runner honors, and how — see `AgentRunSpecSupport`. */
     readonly specSupport: AgentRunSpecSupport;
+    /** How non-human input is admitted while a turn runs; absent means `boundary` (#505). */
+    readonly inputDelivery?: InputDelivery;
     run(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void): Promise<AgentRunResult>;
     startSession(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void, opts?: SessionOptions): AgentSession;
     interrupt(): Promise<void>;

package/dist/core/agent-runner.js

@@ -88,4 +88,9 @@ export function trackChildExit(child) {
     });
     return () => exited;
 }
+export const BOUNDARY_INPUT_DELIVERY = { mode: 'boundary', consumption: 'unobservable', via: 'next idle turn' };
+/** Absent means the pre-#505 behavior every runner had. */
+export function inputDeliveryOf(runner) {
+    return runner.inputDelivery ?? BOUNDARY_INPUT_DELIVERY;
+}
 //# sourceMappingURL=agent-runner.js.map

package/dist/core/agent-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../src/core/agent-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAU,CAAC;AAQnF,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAQ,UAAgC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAiDD;;;;GAIG;AACH,MAAM,wBAAwB,GAA+C;IAC3E,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,IAAI;IACT,YAAY,EAAE,IAAI;IAClB,wBAAwB,EAAE,IAAI;IAC9B,aAAa,EAAE,IAAI;IACnB,qBAAqB,EAAE,IAAI;IAC3B,GAAG,EAAE,IAAI;IACT,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,IAAI;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAiC,CAAC;AAsB3G;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAgC,EAAE,UAAkB;IACtF,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,cAAc,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;AAC/E,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAuB;IAC7D,OAAO,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,GAAG,CAAC;AAClE,CAAC;AAUD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,IAAI,MAAM,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC;AACtB,CAAC"}
+{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../src/core/agent-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAU,CAAC;AAQnF,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAQ,UAAgC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAiDD;;;;GAIG;AACH,MAAM,wBAAwB,GAA+C;IAC3E,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,IAAI;IACT,YAAY,EAAE,IAAI;IAClB,wBAAwB,EAAE,IAAI;IAC9B,aAAa,EAAE,IAAI;IACnB,qBAAqB,EAAE,IAAI;IAC3B,GAAG,EAAE,IAAI;IACT,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,IAAI;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAiC,CAAC;AAsB3G;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAgC,EAAE,UAAkB;IACtF,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,cAAc,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;AAC/E,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAuB;IAC7D,OAAO,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,GAAG,CAAC;AAClE,CAAC;AAUD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,IAAI,MAAM,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC;AACtB,CAAC;AAiHD,MAAM,CAAC,MAAM,uBAAuB,GAAkB,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC;AAC/H,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,MAA0C;IACxE,OAAO,MAAM,CAAC,aAAa,IAAI,uBAAuB,CAAC;AACzD,CAAC"}

package/dist/core/claude-cli-runner.d.ts

@@ -1,4 +1,4 @@
-import type { AgentEvent, AgentRunResult, AgentRunSpec, AgentRunner, AgentSession, SessionOptions, AgentRunSpecSupport } from './agent-runner.ts';
+import type { AgentEvent, AgentRunResult, AgentRunSpec, AgentRunner, AgentSession, SessionOptions, AgentRunSpecSupport, InputDelivery } from './agent-runner.ts';
 export type { AgentSession, SessionOptions } from './agent-runner.ts';
 export interface ClaudeCliRunnerOptions {
     /** Override the binary name/path; defaults to `claude` on PATH. */
@@ -30,6 +30,7 @@ export declare const CLAUDE_SPEC_SUPPORT: AgentRunSpecSupport;
 export declare class ClaudeCliRunner implements AgentRunner {
     readonly backend: 'claude';
     readonly specSupport: Readonly<Record<keyof AgentRunSpec, import("./agent-runner.ts").SpecFieldSupport>>;
+    readonly inputDelivery: InputDelivery;
     private readonly bin;
     private readonly timeoutMs;
     private lastSession;
@@ -39,17 +40,10 @@ export declare class ClaudeCliRunner implements AgentRunner {
     interrupt(): Promise<void>;
     startSession(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void, opts?: SessionOptions): AgentSession;
 }
-/**
- * Build the headless argv. `--input-format stream-json` reads user messages
- * from stdin; `--output-format stream-json --verbose` gives per-event NDJSON;
- * `--permission-mode dontAsk` keeps headless runs non-interactive: tools in
- * `--allowedTools` proceed and everything else is denied instead of prompting.
- * `CEZ_CLAUDE_PERMISSION_MODE` selects `dontAsk` / `acceptEdits` / `bypass`
- * (`bypass` emits `--dangerously-skip-permissions` instead). Unset or unknown
- * keeps today's path: `CEZ_APPROVAL_GATE=1` opts into `acceptEdits` (#435).
- * `CEZ_CLAUDE_SETTING_SOURCES` optionally adds `--setting-sources`.
- */
-export declare function buildClaudeArgs(spec: AgentRunSpec, env?: NodeJS.ProcessEnv): string[];
+export declare function supportsReplayUserMessages(bin: string): boolean;
+export declare function buildClaudeArgs(spec: AgentRunSpec, env?: NodeJS.ProcessEnv, features?: {
+    replayUserMessages: boolean;
+}): string[];
 /**
  * Map `allowedTools` onto claude's `--allowedTools` syntax. `Bash` with a
  * `bashAllowlist` becomes one `Bash(<prefix>:*)` entry per allowed prefix;