@wjarka/cezarion 0.14.8 → 0.14.9-dev.1004

package/dist/contract/projects.d.ts

@@ -38,6 +38,10 @@ export declare const projectListEntrySchema: z.ZodObject<{
     repoUrl: z.ZodOptional<z.ZodString>;
     maxParallel: z.ZodOptional<z.ZodNumber>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    webhook: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        tokenSet: z.ZodBoolean;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ProjectListEntry = z.infer<typeof projectListEntrySchema>;
 /** `GET /api/v1/projects` — the workspace registry. Workspace-level: never 404s, never scoped.
@@ -64,6 +68,10 @@ export declare const projectsResponseSchema: z.ZodObject<{
         repoUrl: z.ZodOptional<z.ZodString>;
         maxParallel: z.ZodOptional<z.ZodNumber>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        webhook: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            tokenSet: z.ZodBoolean;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     bootProject: z.ZodString;
     projectsDir: z.ZodString;
@@ -95,6 +103,10 @@ export declare const registerProjectResponseSchema: z.ZodObject<{
         repoUrl: z.ZodOptional<z.ZodString>;
         maxParallel: z.ZodOptional<z.ZodNumber>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        webhook: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            tokenSet: z.ZodBoolean;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -134,6 +146,10 @@ export declare const updateProjectResponseSchema: z.ZodObject<{
         repoUrl: z.ZodOptional<z.ZodString>;
         maxParallel: z.ZodOptional<z.ZodNumber>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        webhook: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            tokenSet: z.ZodBoolean;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type UpdateProjectResponse = z.infer<typeof updateProjectResponseSchema>;
@@ -142,6 +158,26 @@ export type UpdateProjectResponse = z.infer<typeof updateProjectResponseSchema>;
  *  (`workspaceProjectSchema` in the service), and the settings editor that refuses input early. */
 export declare const PROJECT_TAG_MAX_LENGTH = 32;
 export declare const PROJECT_TAGS_MAX = 20;
+/** Bounds shared by the PATCH body and the registry schema, so a stored value can never be
+ *  degraded away by the next load's `.catch`. */
+export declare const PROJECT_WEBHOOK_URL_MAX_LENGTH = 2048;
+export declare const PROJECT_WEBHOOK_TOKEN_MAX_LENGTH = 1024;
+/** An `http(s)` URL. Anything else (`file:`, `javascript:`) is refused before it is stored. */
+export declare const projectWebhookUrlSchema: z.ZodPipe<z.ZodString, z.ZodURL>;
+export declare const projectWebhookInputSchema: z.ZodObject<{
+    url: z.ZodPipe<z.ZodString, z.ZodURL>;
+    token: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProjectWebhookInput = z.infer<typeof projectWebhookInputSchema>;
+/** `POST /api/v1/projects/:projectId/webhook/test` (#589) — one `task.test` delivery, sent now
+ *  with the same timeout the real deliveries use. `status` is the endpoint's HTTP status. */
+export declare const testProjectWebhookResponseSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    status: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TestProjectWebhookResponse = z.infer<typeof testProjectWebhookResponseSchema>;
 /**
  * `PATCH /api/v1/projects/:projectId` body — the two per-project registry fields the cockpit
  * edits. Each key is optional and a body may carry either or both: a PATCH names the fields it
@@ -165,6 +201,10 @@ export declare const PROJECT_TAGS_MAX = 20;
 export declare const updateProjectInputSchema: z.ZodObject<{
     maxParallel: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    webhook: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        url: z.ZodPipe<z.ZodString, z.ZodURL>;
+        token: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type UpdateProjectInput = z.infer<typeof updateProjectInputSchema>;
 /**

package/dist/contract/runs.d.ts

@@ -126,6 +126,13 @@ export declare const processUsageSchema: z.ZodObject<{
     procCount: z.ZodNumber;
 }, z.core.$strip>;
 export type ProcessUsage = z.infer<typeof processUsageSchema>;
+/** What the last task-webhook delivery did (#589). A success clears `lastError`; a failure after
+ *  every attempt keeps `lastDeliveredAt` from the last one that worked. */
+export declare const runWebhookOutcomeSchema: z.ZodObject<{
+    lastDeliveredAt: z.ZodOptional<z.ZodString>;
+    lastError: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RunWebhookOutcome = z.infer<typeof runWebhookOutcomeSchema>;
 /**
  * The stored run record, as `runs.json` holds it (`src/runs/store.ts`).
  *
@@ -190,6 +197,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 +217,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 +260,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 +314,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 +403,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 +457,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 +575,15 @@ 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;
+            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;
@@ -663,6 +696,11 @@ export declare const runRecordSchema: z.ZodObject<{
         event: z.ZodString;
         githubUrl: z.ZodString;
     }, z.core.$strip>>;
+    notify: z.ZodOptional<z.ZodBoolean>;
+    webhook: z.ZodOptional<z.ZodObject<{
+        lastDeliveredAt: z.ZodOptional<z.ZodString>;
+        lastError: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     status: z.ZodEnum<{
         cancelled: "cancelled";
         done: "done";
@@ -711,6 +749,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;
@@ -859,6 +899,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;
@@ -867,6 +919,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";
@@ -909,6 +962,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";
@@ -962,6 +1016,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";
@@ -1050,6 +1105,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";
@@ -1103,6 +1159,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";
@@ -1220,6 +1277,15 @@ 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;
+            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;
@@ -1332,6 +1398,11 @@ export declare const apiRunSchema: z.ZodObject<{
         event: z.ZodString;
         githubUrl: z.ZodString;
     }, z.core.$strip>>;
+    notify: z.ZodOptional<z.ZodBoolean>;
+    webhook: z.ZodOptional<z.ZodObject<{
+        lastDeliveredAt: z.ZodOptional<z.ZodString>;
+        lastError: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     status: z.ZodEnum<{
         cancelled: "cancelled";
         done: "done";
@@ -1380,6 +1451,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;
@@ -1775,6 +1848,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;
@@ -1783,6 +1868,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";
@@ -1825,6 +1911,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";
@@ -1878,6 +1965,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";
@@ -1966,6 +2054,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";
@@ -2019,6 +2108,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";
@@ -2136,6 +2226,15 @@ 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;
+            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;
@@ -2248,6 +2347,11 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
         event: z.ZodString;
         githubUrl: z.ZodString;
     }, z.core.$strip>>;
+    notify: z.ZodOptional<z.ZodBoolean>;
+    webhook: z.ZodOptional<z.ZodObject<{
+        lastDeliveredAt: z.ZodOptional<z.ZodString>;
+        lastError: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     status: z.ZodEnum<{
         cancelled: "cancelled";
         done: "done";
@@ -2296,6 +2400,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;
@@ -2437,6 +2543,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;
@@ -2445,6 +2563,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";
@@ -2487,6 +2606,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";
@@ -2540,6 +2660,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";
@@ -2628,6 +2749,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";
@@ -2681,6 +2803,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";
@@ -2798,6 +2921,15 @@ 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;
+                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;
@@ -2910,6 +3042,11 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
             event: z.ZodString;
             githubUrl: z.ZodString;
         }, z.core.$strip>>;
+        notify: z.ZodOptional<z.ZodBoolean>;
+        webhook: z.ZodOptional<z.ZodObject<{
+            lastDeliveredAt: z.ZodOptional<z.ZodString>;
+            lastError: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         status: z.ZodEnum<{
             cancelled: "cancelled";
             done: "done";
@@ -2958,6 +3095,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;
@@ -3306,6 +3445,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;
@@ -3314,6 +3465,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";
@@ -3356,6 +3508,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";
@@ -3409,6 +3562,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";
@@ -3497,6 +3651,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";
@@ -3550,6 +3705,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";
@@ -3667,6 +3823,15 @@ 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;
+                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;
@@ -3779,6 +3944,11 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
             event: z.ZodString;
             githubUrl: z.ZodString;
         }, z.core.$strip>>;
+        notify: z.ZodOptional<z.ZodBoolean>;
+        webhook: z.ZodOptional<z.ZodObject<{
+            lastDeliveredAt: z.ZodOptional<z.ZodString>;
+            lastError: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         status: z.ZodEnum<{
             cancelled: "cancelled";
             done: "done";
@@ -3827,6 +3997,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;
@@ -3968,6 +4140,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.
  *
@@ -4075,6 +4249,8 @@ export declare const createRunInputSchema: z.ZodObject<{
         data: z.ZodString;
     }, z.core.$strip>>>;
     todoId: z.ZodOptional<z.ZodString>;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+    notify: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type CreateRunInput = z.input<typeof createRunInputSchema>;
 /**
@@ -4106,3 +4282,13 @@ export declare const pinRunInputSchema: z.ZodObject<{
     pinned: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type PinRunInput = z.infer<typeof pinRunInputSchema>;
+/**
+ * `POST /runs/:id/notify` (#589) — turn the task webhook on or off for one run, in any state.
+ * `message` is the hand-off note: it goes to the webhook only (never into the agent session)
+ * and is recorded as a `handoff` thread event. Bounded like a session message.
+ */
+export declare const notifyRunInputSchema: z.ZodObject<{
+    notify: z.ZodBoolean;
+    message: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+}, z.core.$strip>;
+export type NotifyRunInput = z.input<typeof notifyRunInputSchema>;