@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/contract/automations.d.ts

@@ -1,21 +1,8 @@
 import { z } from 'zod';
 /**
- * The AUTOMATIONS family of `/api/v1` (#694) — the per-project GitHub triggers, their runtime
- * state, the manual "test filter" checks and the execution log.
- *
- * These shapes exist twice on purpose and only once as a DEFINITION of what the wire carries.
- * `packages/cezar/src/automations/types.ts` owns the STORAGE schemas: they are `.passthrough()`,
- * because a definitions/state/log file written by a newer cezar must survive a round trip through
- * an older one rather than lose keys it has never heard of. The schemas here are the CLOSED wire
- * half of those files — every key the routes actually answer with, and no index signature, so a
- * consumer compiles against a shape rather than against `unknown`. `src/server/
- * contract-parity.automations.test.ts` checks each response schema against the route that serves
- * it, in both directions.
- *
- * What that guard can and cannot see is worth knowing: a named key whose type drifts fails, and a
- * key this file makes required that the route does not send fails — but an EXTRA key arriving
- * through the storage schemas' catchall cannot, since the route's own type admits any key. That is
- * the same limit `contract-parity.workspace.test.ts` documents for the open GUI-pref bags.
+ * Closed automation wire schemas. Storage schemas preserve unknown keys separately. Parity
+ * checks compare named response fields in both directions; open storage catchalls limit
+ * extra-key detection.
  */
 /** The GitHub activity an automation reacts to. Four events, all bounded polls — never a webhook. */
 export declare const automationEventSchema: z.ZodEnum<{
@@ -33,8 +20,10 @@ export type AutomationEvent = z.infer<typeof automationEventSchema>;
  * caller that omits them in a request body still gets them back materialized.
  */
 export declare const automationFiltersSchema: z.ZodObject<{
+    includeExisting: z.ZodOptional<z.ZodBoolean>;
     authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
     assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requireCurrentLabels: z.ZodOptional<z.ZodBoolean>;
     allLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     anyLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
     excludeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -53,15 +42,14 @@ export declare const automationKindSchema: z.ZodEnum<{
 }>;
 export type AutomationKind = z.infer<typeof automationKindSchema>;
 /**
- * The task a match launches: `POST /runs`' own body minus the three keys an automation owns
- * itself — `task` (the rendered prompt), `images` and `todoId` — plus the prompt TEMPLATE.
+ * The task a match launches: `POST /runs`' own body minus the two keys an automation owns
+ * itself — `task` (the rendered prompt) and `images` — plus the prompt TEMPLATE.
  *
  * Two keys are re-spelled rather than inherited, because the automation schema really does differ
  * from the composer's and the contract has to describe the automation route:
  *
- *  - `variants` is the literal union the server's own automation schema accepts (`1 | 2 | 3`),
- *    not the composer's `z.number().int().min(1).max(3)`. Identical values, but only the literal
- *    spelling is assignable to the route's parameter;
+ *  - `variants` retains `1 | 2 | 3` in stored definitions and read responses. New writes use
+ *    `singleRunVariantsSchema`; a saved count above one is readable but cannot launch;
  *  - `systemPrompt` carries no `.transform()` here. The composer's trims-to-absent on the way in,
  *    which makes the key REQUIRED (`string | undefined`) on the output side; the automation route
  *    stores and answers it plainly, so it stays optional.
@@ -106,12 +94,43 @@ export declare const automationTaskSchema: z.ZodObject<{
     agentProfile: z.ZodOptional<z.ZodString>;
     worktree: z.ZodOptional<z.ZodBoolean>;
     autonomous: z.ZodOptional<z.ZodBoolean>;
-    generateFollowups: z.ZodOptional<z.ZodBoolean>;
+    archiveWhenDone: z.ZodOptional<z.ZodBoolean>;
+    autoMergePr: z.ZodOptional<z.ZodBoolean>;
     prompt: z.ZodString;
     variants: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
     systemPrompt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type AutomationTask = z.infer<typeof automationTaskSchema>;
+/**
+ * A one-time schedule's archive record (hearsay-tools/cezarion#1465): written after its task
+ * exists (`launched`, with the run and receipt) or when it was cancelled. An archived definition
+ * is always paused and never fires again; only `once` schedules are archived.
+ */
+export declare const automationArchiveSchema: z.ZodObject<{
+    at: z.ZodString;
+    outcome: z.ZodEnum<{
+        cancelled: "cancelled";
+        launched: "launched";
+    }>;
+    runId: z.ZodOptional<z.ZodString>;
+    receiptId: z.ZodOptional<z.ZodString>;
+    trigger: z.ZodOptional<z.ZodEnum<{
+        late: "late";
+        manual: "manual";
+        retry: "retry";
+        schedule: "schedule";
+    }>>;
+}, z.core.$strip>;
+export type AutomationArchive = z.infer<typeof automationArchiveSchema>;
+/** Where a one-time schedule stands, derived by the server so clients never re-derive it. */
+export declare const onceStatusSchema: z.ZodEnum<{
+    archived: "archived";
+    failed: "failed";
+    missed: "missed";
+    paused: "paused";
+    waiting: "waiting";
+}>;
+export type OnceStatus = z.infer<typeof onceStatusSchema>;
 /** One stored automation, as every route that answers a single definition serves it. */
 export declare const automationDefinitionSchema: z.ZodObject<{
     id: z.ZodString;
@@ -131,8 +150,10 @@ export declare const automationDefinitionSchema: z.ZodObject<{
     }>>>;
     intervalSeconds: z.ZodOptional<z.ZodNumber>;
     filters: z.ZodOptional<z.ZodObject<{
+        includeExisting: z.ZodOptional<z.ZodBoolean>;
         authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
         assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requireCurrentLabels: z.ZodOptional<z.ZodBoolean>;
         allLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
         anyLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
         excludeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -144,6 +165,7 @@ export declare const automationDefinitionSchema: z.ZodObject<{
         type: z.ZodEnum<{
             daily: "daily";
             hours: "hours";
+            once: "once";
             weekdays: "weekdays";
             weekly: "weekly";
         }>;
@@ -151,6 +173,9 @@ export declare const automationDefinitionSchema: z.ZodObject<{
         minute: z.ZodOptional<z.ZodNumber>;
         day: z.ZodOptional<z.ZodNumber>;
         every: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<6>, z.ZodLiteral<8>, z.ZodLiteral<12>]>>;
+        at: z.ZodOptional<z.ZodString>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        latestStartMinutes: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     task: z.ZodObject<{
         workflow: z.ZodOptional<z.ZodString>;
@@ -192,11 +217,27 @@ export declare const automationDefinitionSchema: z.ZodObject<{
         agentProfile: z.ZodOptional<z.ZodString>;
         worktree: z.ZodOptional<z.ZodBoolean>;
         autonomous: z.ZodOptional<z.ZodBoolean>;
-        generateFollowups: z.ZodOptional<z.ZodBoolean>;
+        archiveWhenDone: z.ZodOptional<z.ZodBoolean>;
+        autoMergePr: z.ZodOptional<z.ZodBoolean>;
         prompt: z.ZodString;
         variants: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
         systemPrompt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
+    archived: z.ZodOptional<z.ZodObject<{
+        at: z.ZodString;
+        outcome: z.ZodEnum<{
+            cancelled: "cancelled";
+            launched: "launched";
+        }>;
+        runId: z.ZodOptional<z.ZodString>;
+        receiptId: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodOptional<z.ZodEnum<{
+            late: "late";
+            manual: "manual";
+            retry: "retry";
+            schedule: "schedule";
+        }>>;
+    }, z.core.$strip>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
@@ -211,9 +252,35 @@ export type AutomationCursor = z.infer<typeof automationCursorSchema>;
  * The scheduler's own bookkeeping for one automation. Every key is optional — a definition that
  * has never run has no state at all, and the keys appear as the poller reaches each stage.
  */
+/** Durable position inside a bounded GitHub scan, including live overlap and historical searches. */
+export declare const automationHistoryScanSchema: z.ZodObject<{
+    since: z.ZodString;
+    until: z.ZodString;
+    source: z.ZodNumber;
+    page: z.ZodNumber;
+    item: z.ZodNumber;
+    event: z.ZodNumber;
+    cursor: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        tieBreaker: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const automationRuntimeStateSchema: z.ZodObject<{
     revision: z.ZodOptional<z.ZodNumber>;
     baselineAt: z.ZodOptional<z.ZodString>;
+    armedAt: z.ZodOptional<z.ZodString>;
+    historyScan: z.ZodOptional<z.ZodObject<{
+        since: z.ZodString;
+        until: z.ZodString;
+        source: z.ZodNumber;
+        page: z.ZodNumber;
+        item: z.ZodNumber;
+        event: z.ZodNumber;
+        cursor: z.ZodOptional<z.ZodObject<{
+            timestamp: z.ZodString;
+            tieBreaker: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     cursor: z.ZodOptional<z.ZodObject<{
         timestamp: z.ZodString;
         tieBreaker: z.ZodOptional<z.ZodString>;
@@ -233,6 +300,10 @@ export declare const automationRuntimeStateSchema: z.ZodObject<{
     etags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     backoffUntil: z.ZodOptional<z.ZodString>;
     consecutiveFailures: z.ZodOptional<z.ZodNumber>;
+    onceOutcome: z.ZodOptional<z.ZodEnum<{
+        failed: "failed";
+        missed: "missed";
+    }>>;
 }, z.core.$strip>;
 export type AutomationRuntimeState = z.infer<typeof automationRuntimeStateSchema>;
 /** What one poll decided about one candidate. `baseline` and `preview` are bookkeeping rows: no
@@ -245,6 +316,7 @@ export declare const automationLogResultSchema: z.ZodEnum<{
     failed: "failed";
     launched: "launched";
     manual: "manual";
+    missed: "missed";
     "no-match": "no-match";
     preview: "preview";
     "rate-limited": "rate-limited";
@@ -271,6 +343,7 @@ export declare const automationLogRecordSchema: z.ZodObject<{
         failed: "failed";
         launched: "launched";
         manual: "manual";
+        missed: "missed";
         "no-match": "no-match";
         preview: "preview";
         "rate-limited": "rate-limited";
@@ -293,7 +366,7 @@ export declare const automationLogRecordSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AutomationLogRecord = z.infer<typeof automationLogRecordSchema>;
-/** The list view's per-automation tallies, counted over that automation's last 100 log rows. */
+/** Launches count all retained tasks; activity tallies use the automation's latest 100 log rows. */
 export declare const automationCountsSchema: z.ZodObject<{
     matches: z.ZodNumber;
     launched: z.ZodNumber;
@@ -320,8 +393,10 @@ export declare const automationListEntrySchema: z.ZodObject<{
     }>>>;
     intervalSeconds: z.ZodOptional<z.ZodNumber>;
     filters: z.ZodOptional<z.ZodObject<{
+        includeExisting: z.ZodOptional<z.ZodBoolean>;
         authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
         assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requireCurrentLabels: z.ZodOptional<z.ZodBoolean>;
         allLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
         anyLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
         excludeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -333,6 +408,7 @@ export declare const automationListEntrySchema: z.ZodObject<{
         type: z.ZodEnum<{
             daily: "daily";
             hours: "hours";
+            once: "once";
             weekdays: "weekdays";
             weekly: "weekly";
         }>;
@@ -340,6 +416,9 @@ export declare const automationListEntrySchema: z.ZodObject<{
         minute: z.ZodOptional<z.ZodNumber>;
         day: z.ZodOptional<z.ZodNumber>;
         every: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<6>, z.ZodLiteral<8>, z.ZodLiteral<12>]>>;
+        at: z.ZodOptional<z.ZodString>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        latestStartMinutes: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     task: z.ZodObject<{
         workflow: z.ZodOptional<z.ZodString>;
@@ -381,16 +460,45 @@ export declare const automationListEntrySchema: z.ZodObject<{
         agentProfile: z.ZodOptional<z.ZodString>;
         worktree: z.ZodOptional<z.ZodBoolean>;
         autonomous: z.ZodOptional<z.ZodBoolean>;
-        generateFollowups: z.ZodOptional<z.ZodBoolean>;
+        archiveWhenDone: z.ZodOptional<z.ZodBoolean>;
+        autoMergePr: z.ZodOptional<z.ZodBoolean>;
         prompt: z.ZodString;
         variants: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
         systemPrompt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
+    archived: z.ZodOptional<z.ZodObject<{
+        at: z.ZodString;
+        outcome: z.ZodEnum<{
+            cancelled: "cancelled";
+            launched: "launched";
+        }>;
+        runId: z.ZodOptional<z.ZodString>;
+        receiptId: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodOptional<z.ZodEnum<{
+            late: "late";
+            manual: "manual";
+            retry: "retry";
+            schedule: "schedule";
+        }>>;
+    }, z.core.$strip>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     state: z.ZodOptional<z.ZodObject<{
         revision: z.ZodOptional<z.ZodNumber>;
         baselineAt: z.ZodOptional<z.ZodString>;
+        armedAt: z.ZodOptional<z.ZodString>;
+        historyScan: z.ZodOptional<z.ZodObject<{
+            since: z.ZodString;
+            until: z.ZodString;
+            source: z.ZodNumber;
+            page: z.ZodNumber;
+            item: z.ZodNumber;
+            event: z.ZodNumber;
+            cursor: z.ZodOptional<z.ZodObject<{
+                timestamp: z.ZodString;
+                tieBreaker: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         cursor: z.ZodOptional<z.ZodObject<{
             timestamp: z.ZodString;
             tieBreaker: z.ZodOptional<z.ZodString>;
@@ -410,6 +518,10 @@ export declare const automationListEntrySchema: z.ZodObject<{
         etags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         backoffUntil: z.ZodOptional<z.ZodString>;
         consecutiveFailures: z.ZodOptional<z.ZodNumber>;
+        onceOutcome: z.ZodOptional<z.ZodEnum<{
+            failed: "failed";
+            missed: "missed";
+        }>>;
     }, z.core.$strip>>;
     latestLog: z.ZodOptional<z.ZodObject<{
         seq: z.ZodNumber;
@@ -430,6 +542,7 @@ export declare const automationListEntrySchema: z.ZodObject<{
             failed: "failed";
             launched: "launched";
             manual: "manual";
+            missed: "missed";
             "no-match": "no-match";
             preview: "preview";
             "rate-limited": "rate-limited";
@@ -458,6 +571,13 @@ export declare const automationListEntrySchema: z.ZodObject<{
         errors: z.ZodNumber;
     }, z.core.$strip>;
     nextRunAt: z.ZodOptional<z.ZodString>;
+    onceStatus: z.ZodOptional<z.ZodEnum<{
+        archived: "archived";
+        failed: "failed";
+        missed: "missed";
+        paused: "paused";
+        waiting: "waiting";
+    }>>;
 }, z.core.$strip>;
 export type AutomationListEntry = z.infer<typeof automationListEntrySchema>;
 /**
@@ -498,8 +618,10 @@ export declare const automationsResponseSchema: z.ZodObject<{
         }>>>;
         intervalSeconds: z.ZodOptional<z.ZodNumber>;
         filters: z.ZodOptional<z.ZodObject<{
+            includeExisting: z.ZodOptional<z.ZodBoolean>;
             authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
             assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requireCurrentLabels: z.ZodOptional<z.ZodBoolean>;
             allLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
             anyLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
             excludeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -511,6 +633,7 @@ export declare const automationsResponseSchema: z.ZodObject<{
             type: z.ZodEnum<{
                 daily: "daily";
                 hours: "hours";
+                once: "once";
                 weekdays: "weekdays";
                 weekly: "weekly";
             }>;
@@ -518,6 +641,9 @@ export declare const automationsResponseSchema: z.ZodObject<{
             minute: z.ZodOptional<z.ZodNumber>;
             day: z.ZodOptional<z.ZodNumber>;
             every: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<6>, z.ZodLiteral<8>, z.ZodLiteral<12>]>>;
+            at: z.ZodOptional<z.ZodString>;
+            timeZone: z.ZodOptional<z.ZodString>;
+            latestStartMinutes: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         task: z.ZodObject<{
             workflow: z.ZodOptional<z.ZodString>;
@@ -559,16 +685,45 @@ export declare const automationsResponseSchema: z.ZodObject<{
             agentProfile: z.ZodOptional<z.ZodString>;
             worktree: z.ZodOptional<z.ZodBoolean>;
             autonomous: z.ZodOptional<z.ZodBoolean>;
-            generateFollowups: z.ZodOptional<z.ZodBoolean>;
+            archiveWhenDone: z.ZodOptional<z.ZodBoolean>;
+            autoMergePr: z.ZodOptional<z.ZodBoolean>;
             prompt: z.ZodString;
             variants: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
             systemPrompt: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
+        archived: z.ZodOptional<z.ZodObject<{
+            at: z.ZodString;
+            outcome: z.ZodEnum<{
+                cancelled: "cancelled";
+                launched: "launched";
+            }>;
+            runId: z.ZodOptional<z.ZodString>;
+            receiptId: z.ZodOptional<z.ZodString>;
+            trigger: z.ZodOptional<z.ZodEnum<{
+                late: "late";
+                manual: "manual";
+                retry: "retry";
+                schedule: "schedule";
+            }>>;
+        }, z.core.$strip>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         state: z.ZodOptional<z.ZodObject<{
             revision: z.ZodOptional<z.ZodNumber>;
             baselineAt: z.ZodOptional<z.ZodString>;
+            armedAt: z.ZodOptional<z.ZodString>;
+            historyScan: z.ZodOptional<z.ZodObject<{
+                since: z.ZodString;
+                until: z.ZodString;
+                source: z.ZodNumber;
+                page: z.ZodNumber;
+                item: z.ZodNumber;
+                event: z.ZodNumber;
+                cursor: z.ZodOptional<z.ZodObject<{
+                    timestamp: z.ZodString;
+                    tieBreaker: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
             cursor: z.ZodOptional<z.ZodObject<{
                 timestamp: z.ZodString;
                 tieBreaker: z.ZodOptional<z.ZodString>;
@@ -588,6 +743,10 @@ export declare const automationsResponseSchema: z.ZodObject<{
             etags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             backoffUntil: z.ZodOptional<z.ZodString>;
             consecutiveFailures: z.ZodOptional<z.ZodNumber>;
+            onceOutcome: z.ZodOptional<z.ZodEnum<{
+                failed: "failed";
+                missed: "missed";
+            }>>;
         }, z.core.$strip>>;
         latestLog: z.ZodOptional<z.ZodObject<{
             seq: z.ZodNumber;
@@ -608,6 +767,7 @@ export declare const automationsResponseSchema: z.ZodObject<{
                 failed: "failed";
                 launched: "launched";
                 manual: "manual";
+                missed: "missed";
                 "no-match": "no-match";
                 preview: "preview";
                 "rate-limited": "rate-limited";
@@ -636,6 +796,13 @@ export declare const automationsResponseSchema: z.ZodObject<{
             errors: z.ZodNumber;
         }, z.core.$strip>;
         nextRunAt: z.ZodOptional<z.ZodString>;
+        onceStatus: z.ZodOptional<z.ZodEnum<{
+            archived: "archived";
+            failed: "failed";
+            missed: "missed";
+            paused: "paused";
+            waiting: "waiting";
+        }>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AutomationsResponse = z.infer<typeof automationsResponseSchema>;
@@ -659,8 +826,10 @@ export declare const automationResponseSchema: z.ZodObject<{
         }>>>;
         intervalSeconds: z.ZodOptional<z.ZodNumber>;
         filters: z.ZodOptional<z.ZodObject<{
+            includeExisting: z.ZodOptional<z.ZodBoolean>;
             authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
             assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requireCurrentLabels: z.ZodOptional<z.ZodBoolean>;
             allLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
             anyLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
             excludeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -672,6 +841,7 @@ export declare const automationResponseSchema: z.ZodObject<{
             type: z.ZodEnum<{
                 daily: "daily";
                 hours: "hours";
+                once: "once";
                 weekdays: "weekdays";
                 weekly: "weekly";
             }>;
@@ -679,6 +849,9 @@ export declare const automationResponseSchema: z.ZodObject<{
             minute: z.ZodOptional<z.ZodNumber>;
             day: z.ZodOptional<z.ZodNumber>;
             every: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<6>, z.ZodLiteral<8>, z.ZodLiteral<12>]>>;
+            at: z.ZodOptional<z.ZodString>;
+            timeZone: z.ZodOptional<z.ZodString>;
+            latestStartMinutes: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         task: z.ZodObject<{
             workflow: z.ZodOptional<z.ZodString>;
@@ -720,16 +893,154 @@ export declare const automationResponseSchema: z.ZodObject<{
             agentProfile: z.ZodOptional<z.ZodString>;
             worktree: z.ZodOptional<z.ZodBoolean>;
             autonomous: z.ZodOptional<z.ZodBoolean>;
-            generateFollowups: z.ZodOptional<z.ZodBoolean>;
+            archiveWhenDone: z.ZodOptional<z.ZodBoolean>;
+            autoMergePr: z.ZodOptional<z.ZodBoolean>;
             prompt: z.ZodString;
             variants: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
             systemPrompt: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
+        archived: z.ZodOptional<z.ZodObject<{
+            at: z.ZodString;
+            outcome: z.ZodEnum<{
+                cancelled: "cancelled";
+                launched: "launched";
+            }>;
+            runId: z.ZodOptional<z.ZodString>;
+            receiptId: z.ZodOptional<z.ZodString>;
+            trigger: z.ZodOptional<z.ZodEnum<{
+                late: "late";
+                manual: "manual";
+                retry: "retry";
+                schedule: "schedule";
+            }>>;
+        }, z.core.$strip>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type AutomationResponse = z.infer<typeof automationResponseSchema>;
+/**
+ * `POST /automations`. A one-time schedule's answer adds `once`: the due wall time and zone as
+ * stored, the instant they resolve to, and the downtime note (hearsay-tools/cezarion#1465).
+ */
+export declare const automationCreateResponseSchema: z.ZodObject<{
+    automation: z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodBoolean;
+        kind: z.ZodEnum<{
+            github: "github";
+            schedule: "schedule";
+        }>;
+        events: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "issue.labeled": "issue.labeled";
+            "issue.opened": "issue.opened";
+            "issue.unlabeled": "issue.unlabeled";
+            "pull_request.opened": "pull_request.opened";
+        }>>>;
+        intervalSeconds: z.ZodOptional<z.ZodNumber>;
+        filters: z.ZodOptional<z.ZodObject<{
+            includeExisting: z.ZodOptional<z.ZodBoolean>;
+            authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requireCurrentLabels: z.ZodOptional<z.ZodBoolean>;
+            allLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            anyLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            excludeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            changedLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            lookbackDays: z.ZodNumber;
+            maxRecords: z.ZodNumber;
+        }, z.core.$strip>>;
+        schedule: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<{
+                daily: "daily";
+                hours: "hours";
+                once: "once";
+                weekdays: "weekdays";
+                weekly: "weekly";
+            }>;
+            hour: z.ZodOptional<z.ZodNumber>;
+            minute: z.ZodOptional<z.ZodNumber>;
+            day: z.ZodOptional<z.ZodNumber>;
+            every: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<6>, z.ZodLiteral<8>, z.ZodLiteral<12>]>>;
+            at: z.ZodOptional<z.ZodString>;
+            timeZone: z.ZodOptional<z.ZodString>;
+            latestStartMinutes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        task: z.ZodObject<{
+            workflow: z.ZodOptional<z.ZodString>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                prompt: z.ZodOptional<z.ZodString>;
+                skill: z.ZodOptional<z.ZodString>;
+                model: z.ZodOptional<z.ZodString>;
+                effort: z.ZodOptional<z.ZodString>;
+                timeoutMs: z.ZodOptional<z.ZodNumber>;
+                runner: z.ZodOptional<z.ZodEnum<{
+                    claude: "claude";
+                    codex: "codex";
+                    cursor: "cursor";
+                    omp: "omp";
+                    opencode: "opencode";
+                    pi: "pi";
+                }>>;
+                agentProfile: z.ZodOptional<z.ZodString>;
+                allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                command: z.ZodOptional<z.ZodString>;
+                onFail: z.ZodOptional<z.ZodObject<{
+                    retry: z.ZodString;
+                    max: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
+            runner: z.ZodOptional<z.ZodEnum<{
+                claude: "claude";
+                codex: "codex";
+                cursor: "cursor";
+                omp: "omp";
+                opencode: "opencode";
+                pi: "pi";
+            }>>;
+            agentProfile: z.ZodOptional<z.ZodString>;
+            worktree: z.ZodOptional<z.ZodBoolean>;
+            autonomous: z.ZodOptional<z.ZodBoolean>;
+            archiveWhenDone: z.ZodOptional<z.ZodBoolean>;
+            autoMergePr: z.ZodOptional<z.ZodBoolean>;
+            prompt: z.ZodString;
+            variants: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+            systemPrompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        archived: z.ZodOptional<z.ZodObject<{
+            at: z.ZodString;
+            outcome: z.ZodEnum<{
+                cancelled: "cancelled";
+                launched: "launched";
+            }>;
+            runId: z.ZodOptional<z.ZodString>;
+            receiptId: z.ZodOptional<z.ZodString>;
+            trigger: z.ZodOptional<z.ZodEnum<{
+                late: "late";
+                manual: "manual";
+                retry: "retry";
+                schedule: "schedule";
+            }>>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    once: z.ZodOptional<z.ZodObject<{
+        dueAt: z.ZodString;
+        timeZone: z.ZodString;
+        resolvedInstant: z.ZodString;
+        note: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AutomationCreateResponse = z.infer<typeof automationCreateResponseSchema>;
 /** `GET /automations/:id` — one definition with its state and the most recent log row. */
 export declare const automationDetailResponseSchema: z.ZodObject<{
     automation: z.ZodObject<{
@@ -750,8 +1061,10 @@ export declare const automationDetailResponseSchema: z.ZodObject<{
         }>>>;
         intervalSeconds: z.ZodOptional<z.ZodNumber>;
         filters: z.ZodOptional<z.ZodObject<{
+            includeExisting: z.ZodOptional<z.ZodBoolean>;
             authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
             assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requireCurrentLabels: z.ZodOptional<z.ZodBoolean>;
             allLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
             anyLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
             excludeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -763,6 +1076,7 @@ export declare const automationDetailResponseSchema: z.ZodObject<{
             type: z.ZodEnum<{
                 daily: "daily";
                 hours: "hours";
+                once: "once";
                 weekdays: "weekdays";
                 weekly: "weekly";
             }>;
@@ -770,6 +1084,9 @@ export declare const automationDetailResponseSchema: z.ZodObject<{
             minute: z.ZodOptional<z.ZodNumber>;
             day: z.ZodOptional<z.ZodNumber>;
             every: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<6>, z.ZodLiteral<8>, z.ZodLiteral<12>]>>;
+            at: z.ZodOptional<z.ZodString>;
+            timeZone: z.ZodOptional<z.ZodString>;
+            latestStartMinutes: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         task: z.ZodObject<{
             workflow: z.ZodOptional<z.ZodString>;
@@ -811,17 +1128,46 @@ export declare const automationDetailResponseSchema: z.ZodObject<{
             agentProfile: z.ZodOptional<z.ZodString>;
             worktree: z.ZodOptional<z.ZodBoolean>;
             autonomous: z.ZodOptional<z.ZodBoolean>;
-            generateFollowups: z.ZodOptional<z.ZodBoolean>;
+            archiveWhenDone: z.ZodOptional<z.ZodBoolean>;
+            autoMergePr: z.ZodOptional<z.ZodBoolean>;
             prompt: z.ZodString;
             variants: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
             systemPrompt: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
+        archived: z.ZodOptional<z.ZodObject<{
+            at: z.ZodString;
+            outcome: z.ZodEnum<{
+                cancelled: "cancelled";
+                launched: "launched";
+            }>;
+            runId: z.ZodOptional<z.ZodString>;
+            receiptId: z.ZodOptional<z.ZodString>;
+            trigger: z.ZodOptional<z.ZodEnum<{
+                late: "late";
+                manual: "manual";
+                retry: "retry";
+                schedule: "schedule";
+            }>>;
+        }, z.core.$strip>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, z.core.$strip>;
     state: z.ZodOptional<z.ZodObject<{
         revision: z.ZodOptional<z.ZodNumber>;
         baselineAt: z.ZodOptional<z.ZodString>;
+        armedAt: z.ZodOptional<z.ZodString>;
+        historyScan: z.ZodOptional<z.ZodObject<{
+            since: z.ZodString;
+            until: z.ZodString;
+            source: z.ZodNumber;
+            page: z.ZodNumber;
+            item: z.ZodNumber;
+            event: z.ZodNumber;
+            cursor: z.ZodOptional<z.ZodObject<{
+                timestamp: z.ZodString;
+                tieBreaker: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         cursor: z.ZodOptional<z.ZodObject<{
             timestamp: z.ZodString;
             tieBreaker: z.ZodOptional<z.ZodString>;
@@ -841,6 +1187,10 @@ export declare const automationDetailResponseSchema: z.ZodObject<{
         etags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         backoffUntil: z.ZodOptional<z.ZodString>;
         consecutiveFailures: z.ZodOptional<z.ZodNumber>;
+        onceOutcome: z.ZodOptional<z.ZodEnum<{
+            failed: "failed";
+            missed: "missed";
+        }>>;
     }, z.core.$strip>>;
     latestLog: z.ZodOptional<z.ZodObject<{
         seq: z.ZodNumber;
@@ -861,6 +1211,7 @@ export declare const automationDetailResponseSchema: z.ZodObject<{
             failed: "failed";
             launched: "launched";
             manual: "manual";
+            missed: "missed";
             "no-match": "no-match";
             preview: "preview";
             "rate-limited": "rate-limited";
@@ -882,6 +1233,13 @@ export declare const automationDetailResponseSchema: z.ZodObject<{
             resetAt: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    onceStatus: z.ZodOptional<z.ZodEnum<{
+        archived: "archived";
+        failed: "failed";
+        missed: "missed";
+        paused: "paused";
+        waiting: "waiting";
+    }>>;
 }, z.core.$strip>;
 export type AutomationDetailResponse = z.infer<typeof automationDetailResponseSchema>;
 /**
@@ -938,6 +1296,7 @@ export declare const automationLogResponseSchema: z.ZodObject<{
             failed: "failed";
             launched: "launched";
             manual: "manual";
+            missed: "missed";
             "no-match": "no-match";
             preview: "preview";
             "rate-limited": "rate-limited";
@@ -988,8 +1347,10 @@ export declare const createAutomationInputSchema: z.ZodObject<{
     }>>>;
     intervalSeconds: z.ZodOptional<z.ZodNumber>;
     filters: z.ZodOptional<z.ZodObject<{
+        includeExisting: z.ZodOptional<z.ZodBoolean>;
         authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
         assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requireCurrentLabels: z.ZodOptional<z.ZodBoolean>;
         allLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
         anyLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
         excludeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1001,6 +1362,7 @@ export declare const createAutomationInputSchema: z.ZodObject<{
         type: z.ZodEnum<{
             daily: "daily";
             hours: "hours";
+            once: "once";
             weekdays: "weekdays";
             weekly: "weekly";
         }>;
@@ -1008,7 +1370,14 @@ export declare const createAutomationInputSchema: z.ZodObject<{
         minute: z.ZodOptional<z.ZodNumber>;
         day: z.ZodOptional<z.ZodNumber>;
         every: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<6>, z.ZodLiteral<8>, z.ZodLiteral<12>]>>;
+        at: z.ZodOptional<z.ZodString>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        latestStartMinutes: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        github: "github";
+        schedule: "schedule";
+    }>>;
     task: z.ZodObject<{
         workflow: z.ZodOptional<z.ZodString>;
         steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1049,15 +1418,12 @@ export declare const createAutomationInputSchema: z.ZodObject<{
         agentProfile: z.ZodOptional<z.ZodString>;
         worktree: z.ZodOptional<z.ZodBoolean>;
         autonomous: z.ZodOptional<z.ZodBoolean>;
-        generateFollowups: z.ZodOptional<z.ZodBoolean>;
+        archiveWhenDone: z.ZodOptional<z.ZodBoolean>;
+        autoMergePr: z.ZodOptional<z.ZodBoolean>;
         prompt: z.ZodString;
-        variants: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
         systemPrompt: z.ZodOptional<z.ZodString>;
+        variants: z.ZodOptional<z.ZodLiteral<1>>;
     }, z.core.$strip>;
-    kind: z.ZodOptional<z.ZodEnum<{
-        github: "github";
-        schedule: "schedule";
-    }>>;
     enable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type CreateAutomationInput = z.input<typeof createAutomationInputSchema>;
@@ -1077,8 +1443,10 @@ export declare const updateAutomationInputSchema: z.ZodObject<{
     }>>>;
     intervalSeconds: z.ZodOptional<z.ZodNumber>;
     filters: z.ZodOptional<z.ZodObject<{
+        includeExisting: z.ZodOptional<z.ZodBoolean>;
         authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
         assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requireCurrentLabels: z.ZodOptional<z.ZodBoolean>;
         allLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
         anyLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
         excludeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1090,6 +1458,7 @@ export declare const updateAutomationInputSchema: z.ZodObject<{
         type: z.ZodEnum<{
             daily: "daily";
             hours: "hours";
+            once: "once";
             weekdays: "weekdays";
             weekly: "weekly";
         }>;
@@ -1097,7 +1466,14 @@ export declare const updateAutomationInputSchema: z.ZodObject<{
         minute: z.ZodOptional<z.ZodNumber>;
         day: z.ZodOptional<z.ZodNumber>;
         every: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<6>, z.ZodLiteral<8>, z.ZodLiteral<12>]>>;
+        at: z.ZodOptional<z.ZodString>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        latestStartMinutes: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        github: "github";
+        schedule: "schedule";
+    }>>;
     task: z.ZodObject<{
         workflow: z.ZodOptional<z.ZodString>;
         steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1138,19 +1514,24 @@ export declare const updateAutomationInputSchema: z.ZodObject<{
         agentProfile: z.ZodOptional<z.ZodString>;
         worktree: z.ZodOptional<z.ZodBoolean>;
         autonomous: z.ZodOptional<z.ZodBoolean>;
-        generateFollowups: z.ZodOptional<z.ZodBoolean>;
+        archiveWhenDone: z.ZodOptional<z.ZodBoolean>;
+        autoMergePr: z.ZodOptional<z.ZodBoolean>;
         prompt: z.ZodString;
-        variants: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
         systemPrompt: z.ZodOptional<z.ZodString>;
+        variants: z.ZodOptional<z.ZodLiteral<1>>;
     }, z.core.$strip>;
-    kind: z.ZodOptional<z.ZodEnum<{
-        github: "github";
-        schedule: "schedule";
-    }>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     expectedRevision: z.ZodNumber;
 }, z.core.$strip>;
 export type UpdateAutomationInput = z.input<typeof updateAutomationInputSchema>;
+/** `GET /automations` — archived one-time schedules are left out unless asked for. */
+export declare const automationListQuerySchema: z.ZodObject<{
+    archived: z.ZodOptional<z.ZodEnum<{
+        include: "include";
+        only: "only";
+    }>>;
+}, z.core.$strip>;
+export type AutomationListQuery = z.input<typeof automationListQuerySchema>;
 /** `POST /automations/:id/check` — which of the two manual checks to run. */
 export declare const automationCheckInputSchema: z.ZodObject<{
     mode: z.ZodEnum<{