@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/automations/service.d.ts

@@ -0,0 +1,777 @@
+import type { z } from 'zod';
+import { type AutomationListQuery, type OnceStatus } from '../contract/index.js';
+import { automationCreateSchema, automationUpdateSchema } from '../contract/index.js';
+import { type HostDiscovery } from '../discovery/catalog.ts';
+import type { RunStore } from '../runs/store.ts';
+import type { ForgeAvailability } from '../server/forge/index.ts';
+import type { RunManager } from '../workflows/run.ts';
+import { type ScheduleRunnerHandle } from './schedule-runner.ts';
+import type { AutomationStore } from './store.ts';
+import { type AutomationDefinition, type AutomationRuntimeState } from './types.ts';
+/**
+ * Shared automation create/edit/toggle behavior for HTTP, CLI and tools. One-time writes take
+ * the project lease, heal archive state and reject invalid past due times.
+ */
+export declare const ONCE_PAST_DUE = "the due time has passed; choose a later time or use Run now";
+export declare const ONCE_ARCHIVED = "this one-time schedule is archived";
+export declare const ONCE_LAUNCH_IN_PROGRESS = "a launch of this schedule is in progress; try again in a moment";
+export declare const ONCE_ONLY_CANCEL = "only a one-time schedule can be cancelled; pause or delete it instead";
+/** What a project offers the service: its stores, its manager and where it lives. */
+export interface AutomationServiceProject {
+    id: string;
+    root: string;
+    automationStore: AutomationStore;
+    store: RunStore;
+    manager: RunManager;
+}
+export interface AutomationServiceDeps {
+    /** The zone the repeating schedules run in: the server's own. */
+    timeZone: () => string;
+    /** Host model discovery; absent = explicit models are never refused at save. */
+    discovery?: HostDiscovery;
+    scheduleHandle: (project: AutomationServiceProject) => ScheduleRunnerHandle;
+    emitChange: (project: AutomationServiceProject, automationId: string, revision: number, deleted?: boolean) => void;
+    changed: () => void;
+    /** The forge's settled availability for the list; never throws. */
+    githubAvailability: (root: string) => Promise<ForgeAvailability>;
+    /** Whether a GitHub automation could poll this project at all. */
+    hasGithubRemote: (root: string) => Promise<boolean>;
+    now?: () => number;
+}
+export type ServiceFailure = {
+    ok: false;
+    status: 400 | 404 | 409;
+    error: string;
+};
+export type ServiceSuccess<T, S extends 200 | 201 | 202 | 204> = {
+    ok: true;
+    status: S;
+    body: T;
+};
+/** Where a one-time schedule stands; `undefined` for any other automation. */
+export declare function onceStatus(definition: AutomationDefinition, state: AutomationRuntimeState | undefined): OnceStatus | undefined;
+export declare function createAutomationService(deps: AutomationServiceDeps): {
+    list(project: AutomationServiceProject, query: AutomationListQuery): Promise<{
+        available: boolean;
+        reason?: string;
+        timeZone: string;
+        scheduler: {
+            state: "idle" | "scheduled";
+            nextDue?: string;
+        };
+        automations: {
+            id: string;
+            revision: number;
+            name: string;
+            description?: string | undefined;
+            enabled: boolean;
+            kind: "github" | "schedule";
+            events?: ("issue.labeled" | "issue.opened" | "issue.unlabeled" | "pull_request.opened")[] | undefined;
+            intervalSeconds?: number | undefined;
+            filters?: {
+                [x: string]: unknown;
+                includeExisting?: boolean | undefined;
+                requireCurrentLabels?: boolean | undefined;
+                authors?: string[] | undefined;
+                assignees?: string[] | undefined;
+                allLabels?: string[] | undefined;
+                anyLabels?: string[] | undefined;
+                excludeLabels?: string[] | undefined;
+                changedLabels?: string[] | undefined;
+                lookbackDays: number;
+                maxRecords: number;
+            } | undefined;
+            schedule?: {
+                [x: string]: unknown;
+                type: "daily" | "hours" | "once" | "weekdays" | "weekly";
+                hour?: number | undefined;
+                minute?: number | undefined;
+                day?: number | undefined;
+                every?: 1 | 2 | 3 | 4 | 6 | 8 | 12 | undefined;
+                at?: string | undefined;
+                timeZone?: string | undefined;
+                latestStartMinutes?: number | undefined;
+            } | undefined;
+            task: {
+                [x: string]: unknown;
+                prompt: string;
+                workflow?: string | undefined;
+                steps?: {
+                    id: string;
+                    name?: string | undefined;
+                    prompt?: string | undefined;
+                    skill?: string | undefined;
+                    model?: string | undefined;
+                    effort?: string | undefined;
+                    timeoutMs?: number | undefined;
+                    runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                    agentProfile?: string | undefined;
+                    allowedTools?: string[] | undefined;
+                    bashAllowlist?: string[] | undefined;
+                    command?: string | undefined;
+                    onFail?: {
+                        retry: string;
+                        max: number;
+                    } | undefined;
+                }[] | undefined;
+                runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                model?: string | undefined;
+                effort?: string | undefined;
+                variants?: 1 | 2 | 3 | undefined;
+                worktree?: boolean | undefined;
+                autonomous?: boolean | undefined;
+                archiveWhenDone?: boolean | undefined;
+                autoMergePr?: boolean | undefined;
+                systemPrompt?: string | undefined;
+            };
+            archived?: {
+                [x: string]: unknown;
+                at: string;
+                outcome: "cancelled" | "launched";
+                runId?: string | undefined;
+                receiptId?: string | undefined;
+                trigger?: "late" | "manual" | "retry" | "schedule" | undefined;
+            } | undefined;
+            createdAt: string;
+            updatedAt: string;
+            state?: {
+                [x: string]: unknown;
+                revision?: number | undefined;
+                baselineAt?: string | undefined;
+                armedAt?: string | undefined;
+                historyScan?: {
+                    since: string;
+                    until: string;
+                    source: number;
+                    page: number;
+                    item: number;
+                    event: number;
+                    cursor?: {
+                        [x: string]: unknown;
+                        timestamp: string;
+                        tieBreaker?: string | undefined;
+                    } | undefined;
+                } | undefined;
+                cursor?: {
+                    [x: string]: unknown;
+                    timestamp: string;
+                    tieBreaker?: string | undefined;
+                } | undefined;
+                frozenHighWatermark?: {
+                    [x: string]: unknown;
+                    timestamp: string;
+                    tieBreaker: string;
+                } | undefined;
+                backlogAfter?: {
+                    [x: string]: unknown;
+                    timestamp: string;
+                    tieBreaker: string;
+                } | undefined;
+                nextCheckAt?: string | undefined;
+                lastSuccessAt?: string | undefined;
+                nextRunAt?: string | undefined;
+                lastRunAt?: string | undefined;
+                etags?: Record<string, string> | undefined;
+                backoffUntil?: string | undefined;
+                consecutiveFailures?: number | undefined;
+                onceOutcome?: "failed" | "missed" | undefined;
+            };
+            latestLog?: {
+                [x: string]: unknown;
+                seq: number;
+                ts: string;
+                automationId: string;
+                revision: number;
+                event?: "issue.labeled" | "issue.opened" | "issue.unlabeled" | "pull_request.opened" | undefined;
+                result: "baseline" | "catch-up" | "duplicate" | "error" | "failed" | "launched" | "manual" | "missed" | "no-match" | "preview" | "rate-limited" | "skipped";
+                reason?: string | undefined;
+                durationMs?: number | undefined;
+                receiptId?: string | undefined;
+                runId?: string | undefined;
+                githubNumber?: number | undefined;
+                githubTitle?: string | undefined;
+                githubUrl?: string | undefined;
+                rateLimit?: {
+                    [x: string]: unknown;
+                    bucket: "core" | "search";
+                    remaining?: number | undefined;
+                    resetAt?: string | undefined;
+                } | undefined;
+            };
+            nextRunAt?: string;
+            onceStatus?: "archived" | "failed" | "missed" | "paused" | "waiting";
+            counts: {
+                matches: number;
+                launched: number;
+                duplicates: number;
+                errors: number;
+            };
+        }[];
+    }>;
+    get(project: AutomationServiceProject, id: string): ServiceFailure | {
+        ok: true;
+        body: {
+            automation: {
+                [x: string]: unknown;
+                id: string;
+                revision: number;
+                name: string;
+                description?: string | undefined;
+                enabled: boolean;
+                kind: "github" | "schedule";
+                events?: ("issue.labeled" | "issue.opened" | "issue.unlabeled" | "pull_request.opened")[] | undefined;
+                intervalSeconds?: number | undefined;
+                filters?: {
+                    [x: string]: unknown;
+                    includeExisting?: boolean | undefined;
+                    requireCurrentLabels?: boolean | undefined;
+                    authors?: string[] | undefined;
+                    assignees?: string[] | undefined;
+                    allLabels?: string[] | undefined;
+                    anyLabels?: string[] | undefined;
+                    excludeLabels?: string[] | undefined;
+                    changedLabels?: string[] | undefined;
+                    lookbackDays: number;
+                    maxRecords: number;
+                } | undefined;
+                schedule?: {
+                    [x: string]: unknown;
+                    type: "daily" | "hours" | "once" | "weekdays" | "weekly";
+                    hour?: number | undefined;
+                    minute?: number | undefined;
+                    day?: number | undefined;
+                    every?: 1 | 2 | 3 | 4 | 6 | 8 | 12 | undefined;
+                    at?: string | undefined;
+                    timeZone?: string | undefined;
+                    latestStartMinutes?: number | undefined;
+                } | undefined;
+                task: {
+                    [x: string]: unknown;
+                    prompt: string;
+                    workflow?: string | undefined;
+                    steps?: {
+                        id: string;
+                        name?: string | undefined;
+                        prompt?: string | undefined;
+                        skill?: string | undefined;
+                        model?: string | undefined;
+                        effort?: string | undefined;
+                        timeoutMs?: number | undefined;
+                        runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                        agentProfile?: string | undefined;
+                        allowedTools?: string[] | undefined;
+                        bashAllowlist?: string[] | undefined;
+                        command?: string | undefined;
+                        onFail?: {
+                            retry: string;
+                            max: number;
+                        } | undefined;
+                    }[] | undefined;
+                    runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                    model?: string | undefined;
+                    effort?: string | undefined;
+                    variants?: 1 | 2 | 3 | undefined;
+                    worktree?: boolean | undefined;
+                    autonomous?: boolean | undefined;
+                    archiveWhenDone?: boolean | undefined;
+                    autoMergePr?: boolean | undefined;
+                    systemPrompt?: string | undefined;
+                };
+                archived?: {
+                    [x: string]: unknown;
+                    at: string;
+                    outcome: "cancelled" | "launched";
+                    runId?: string | undefined;
+                    receiptId?: string | undefined;
+                    trigger?: "late" | "manual" | "retry" | "schedule" | undefined;
+                } | undefined;
+                createdAt: string;
+                updatedAt: string;
+            };
+            state?: {
+                [x: string]: unknown;
+                revision?: number | undefined;
+                baselineAt?: string | undefined;
+                armedAt?: string | undefined;
+                historyScan?: {
+                    since: string;
+                    until: string;
+                    source: number;
+                    page: number;
+                    item: number;
+                    event: number;
+                    cursor?: {
+                        [x: string]: unknown;
+                        timestamp: string;
+                        tieBreaker?: string | undefined;
+                    } | undefined;
+                } | undefined;
+                cursor?: {
+                    [x: string]: unknown;
+                    timestamp: string;
+                    tieBreaker?: string | undefined;
+                } | undefined;
+                frozenHighWatermark?: {
+                    [x: string]: unknown;
+                    timestamp: string;
+                    tieBreaker: string;
+                } | undefined;
+                backlogAfter?: {
+                    [x: string]: unknown;
+                    timestamp: string;
+                    tieBreaker: string;
+                } | undefined;
+                nextCheckAt?: string | undefined;
+                lastSuccessAt?: string | undefined;
+                nextRunAt?: string | undefined;
+                lastRunAt?: string | undefined;
+                etags?: Record<string, string> | undefined;
+                backoffUntil?: string | undefined;
+                consecutiveFailures?: number | undefined;
+                onceOutcome?: "failed" | "missed" | undefined;
+            };
+            latestLog?: {
+                [x: string]: unknown;
+                seq: number;
+                ts: string;
+                automationId: string;
+                revision: number;
+                event?: "issue.labeled" | "issue.opened" | "issue.unlabeled" | "pull_request.opened" | undefined;
+                result: "baseline" | "catch-up" | "duplicate" | "error" | "failed" | "launched" | "manual" | "missed" | "no-match" | "preview" | "rate-limited" | "skipped";
+                reason?: string | undefined;
+                durationMs?: number | undefined;
+                receiptId?: string | undefined;
+                runId?: string | undefined;
+                githubNumber?: number | undefined;
+                githubTitle?: string | undefined;
+                githubUrl?: string | undefined;
+                rateLimit?: {
+                    [x: string]: unknown;
+                    bucket: "core" | "search";
+                    remaining?: number | undefined;
+                    resetAt?: string | undefined;
+                } | undefined;
+            };
+            onceStatus?: "archived" | "failed" | "missed" | "paused" | "waiting";
+        };
+    };
+    create(project: AutomationServiceProject, body: z.infer<typeof automationCreateSchema>): Promise<ServiceFailure | {
+        ok: true;
+        automation: {
+            [x: string]: unknown;
+            id: string;
+            revision: number;
+            name: string;
+            description?: string | undefined;
+            enabled: boolean;
+            kind: "github" | "schedule";
+            events?: ("issue.labeled" | "issue.opened" | "issue.unlabeled" | "pull_request.opened")[] | undefined;
+            intervalSeconds?: number | undefined;
+            filters?: {
+                [x: string]: unknown;
+                includeExisting?: boolean | undefined;
+                requireCurrentLabels?: boolean | undefined;
+                authors?: string[] | undefined;
+                assignees?: string[] | undefined;
+                allLabels?: string[] | undefined;
+                anyLabels?: string[] | undefined;
+                excludeLabels?: string[] | undefined;
+                changedLabels?: string[] | undefined;
+                lookbackDays: number;
+                maxRecords: number;
+            } | undefined;
+            schedule?: {
+                [x: string]: unknown;
+                type: "daily" | "hours" | "once" | "weekdays" | "weekly";
+                hour?: number | undefined;
+                minute?: number | undefined;
+                day?: number | undefined;
+                every?: 1 | 2 | 3 | 4 | 6 | 8 | 12 | undefined;
+                at?: string | undefined;
+                timeZone?: string | undefined;
+                latestStartMinutes?: number | undefined;
+            } | undefined;
+            task: {
+                [x: string]: unknown;
+                prompt: string;
+                workflow?: string | undefined;
+                steps?: {
+                    id: string;
+                    name?: string | undefined;
+                    prompt?: string | undefined;
+                    skill?: string | undefined;
+                    model?: string | undefined;
+                    effort?: string | undefined;
+                    timeoutMs?: number | undefined;
+                    runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                    agentProfile?: string | undefined;
+                    allowedTools?: string[] | undefined;
+                    bashAllowlist?: string[] | undefined;
+                    command?: string | undefined;
+                    onFail?: {
+                        retry: string;
+                        max: number;
+                    } | undefined;
+                }[] | undefined;
+                runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                model?: string | undefined;
+                effort?: string | undefined;
+                variants?: 1 | 2 | 3 | undefined;
+                worktree?: boolean | undefined;
+                autonomous?: boolean | undefined;
+                archiveWhenDone?: boolean | undefined;
+                autoMergePr?: boolean | undefined;
+                systemPrompt?: string | undefined;
+            };
+            archived?: {
+                [x: string]: unknown;
+                at: string;
+                outcome: "cancelled" | "launched";
+                runId?: string | undefined;
+                receiptId?: string | undefined;
+                trigger?: "late" | "manual" | "retry" | "schedule" | undefined;
+            } | undefined;
+            createdAt: string;
+            updatedAt: string;
+        };
+    }>;
+    update(project: AutomationServiceProject, id: string, body: z.infer<typeof automationUpdateSchema>): Promise<ServiceFailure | {
+        ok: true;
+        automation: {
+            [x: string]: unknown;
+            id: string;
+            revision: number;
+            name: string;
+            description?: string | undefined;
+            enabled: boolean;
+            kind: "github" | "schedule";
+            events?: ("issue.labeled" | "issue.opened" | "issue.unlabeled" | "pull_request.opened")[] | undefined;
+            intervalSeconds?: number | undefined;
+            filters?: {
+                [x: string]: unknown;
+                includeExisting?: boolean | undefined;
+                requireCurrentLabels?: boolean | undefined;
+                authors?: string[] | undefined;
+                assignees?: string[] | undefined;
+                allLabels?: string[] | undefined;
+                anyLabels?: string[] | undefined;
+                excludeLabels?: string[] | undefined;
+                changedLabels?: string[] | undefined;
+                lookbackDays: number;
+                maxRecords: number;
+            } | undefined;
+            schedule?: {
+                [x: string]: unknown;
+                type: "daily" | "hours" | "once" | "weekdays" | "weekly";
+                hour?: number | undefined;
+                minute?: number | undefined;
+                day?: number | undefined;
+                every?: 1 | 2 | 3 | 4 | 6 | 8 | 12 | undefined;
+                at?: string | undefined;
+                timeZone?: string | undefined;
+                latestStartMinutes?: number | undefined;
+            } | undefined;
+            task: {
+                [x: string]: unknown;
+                prompt: string;
+                workflow?: string | undefined;
+                steps?: {
+                    id: string;
+                    name?: string | undefined;
+                    prompt?: string | undefined;
+                    skill?: string | undefined;
+                    model?: string | undefined;
+                    effort?: string | undefined;
+                    timeoutMs?: number | undefined;
+                    runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                    agentProfile?: string | undefined;
+                    allowedTools?: string[] | undefined;
+                    bashAllowlist?: string[] | undefined;
+                    command?: string | undefined;
+                    onFail?: {
+                        retry: string;
+                        max: number;
+                    } | undefined;
+                }[] | undefined;
+                runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                model?: string | undefined;
+                effort?: string | undefined;
+                variants?: 1 | 2 | 3 | undefined;
+                worktree?: boolean | undefined;
+                autonomous?: boolean | undefined;
+                archiveWhenDone?: boolean | undefined;
+                autoMergePr?: boolean | undefined;
+                systemPrompt?: string | undefined;
+            };
+            archived?: {
+                [x: string]: unknown;
+                at: string;
+                outcome: "cancelled" | "launched";
+                runId?: string | undefined;
+                receiptId?: string | undefined;
+                trigger?: "late" | "manual" | "retry" | "schedule" | undefined;
+            } | undefined;
+            createdAt: string;
+            updatedAt: string;
+        };
+    }>;
+    remove(project: AutomationServiceProject, id: string): Promise<ServiceFailure | {
+        ok: true;
+    }> | ServiceFailure | {
+        ok: true;
+    };
+    enable(project: AutomationServiceProject, id: string): Promise<ServiceFailure | {
+        ok: true;
+        automation: {
+            [x: string]: unknown;
+            id: string;
+            revision: number;
+            name: string;
+            description?: string | undefined;
+            enabled: boolean;
+            kind: "github" | "schedule";
+            events?: ("issue.labeled" | "issue.opened" | "issue.unlabeled" | "pull_request.opened")[] | undefined;
+            intervalSeconds?: number | undefined;
+            filters?: {
+                [x: string]: unknown;
+                includeExisting?: boolean | undefined;
+                requireCurrentLabels?: boolean | undefined;
+                authors?: string[] | undefined;
+                assignees?: string[] | undefined;
+                allLabels?: string[] | undefined;
+                anyLabels?: string[] | undefined;
+                excludeLabels?: string[] | undefined;
+                changedLabels?: string[] | undefined;
+                lookbackDays: number;
+                maxRecords: number;
+            } | undefined;
+            schedule?: {
+                [x: string]: unknown;
+                type: "daily" | "hours" | "once" | "weekdays" | "weekly";
+                hour?: number | undefined;
+                minute?: number | undefined;
+                day?: number | undefined;
+                every?: 1 | 2 | 3 | 4 | 6 | 8 | 12 | undefined;
+                at?: string | undefined;
+                timeZone?: string | undefined;
+                latestStartMinutes?: number | undefined;
+            } | undefined;
+            task: {
+                [x: string]: unknown;
+                prompt: string;
+                workflow?: string | undefined;
+                steps?: {
+                    id: string;
+                    name?: string | undefined;
+                    prompt?: string | undefined;
+                    skill?: string | undefined;
+                    model?: string | undefined;
+                    effort?: string | undefined;
+                    timeoutMs?: number | undefined;
+                    runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                    agentProfile?: string | undefined;
+                    allowedTools?: string[] | undefined;
+                    bashAllowlist?: string[] | undefined;
+                    command?: string | undefined;
+                    onFail?: {
+                        retry: string;
+                        max: number;
+                    } | undefined;
+                }[] | undefined;
+                runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                model?: string | undefined;
+                effort?: string | undefined;
+                variants?: 1 | 2 | 3 | undefined;
+                worktree?: boolean | undefined;
+                autonomous?: boolean | undefined;
+                archiveWhenDone?: boolean | undefined;
+                autoMergePr?: boolean | undefined;
+                systemPrompt?: string | undefined;
+            };
+            archived?: {
+                [x: string]: unknown;
+                at: string;
+                outcome: "cancelled" | "launched";
+                runId?: string | undefined;
+                receiptId?: string | undefined;
+                trigger?: "late" | "manual" | "retry" | "schedule" | undefined;
+            } | undefined;
+            createdAt: string;
+            updatedAt: string;
+        };
+    }>;
+    pause(project: AutomationServiceProject, id: string): Promise<ServiceFailure | {
+        ok: true;
+        automation: {
+            [x: string]: unknown;
+            id: string;
+            revision: number;
+            name: string;
+            description?: string | undefined;
+            enabled: boolean;
+            kind: "github" | "schedule";
+            events?: ("issue.labeled" | "issue.opened" | "issue.unlabeled" | "pull_request.opened")[] | undefined;
+            intervalSeconds?: number | undefined;
+            filters?: {
+                [x: string]: unknown;
+                includeExisting?: boolean | undefined;
+                requireCurrentLabels?: boolean | undefined;
+                authors?: string[] | undefined;
+                assignees?: string[] | undefined;
+                allLabels?: string[] | undefined;
+                anyLabels?: string[] | undefined;
+                excludeLabels?: string[] | undefined;
+                changedLabels?: string[] | undefined;
+                lookbackDays: number;
+                maxRecords: number;
+            } | undefined;
+            schedule?: {
+                [x: string]: unknown;
+                type: "daily" | "hours" | "once" | "weekdays" | "weekly";
+                hour?: number | undefined;
+                minute?: number | undefined;
+                day?: number | undefined;
+                every?: 1 | 2 | 3 | 4 | 6 | 8 | 12 | undefined;
+                at?: string | undefined;
+                timeZone?: string | undefined;
+                latestStartMinutes?: number | undefined;
+            } | undefined;
+            task: {
+                [x: string]: unknown;
+                prompt: string;
+                workflow?: string | undefined;
+                steps?: {
+                    id: string;
+                    name?: string | undefined;
+                    prompt?: string | undefined;
+                    skill?: string | undefined;
+                    model?: string | undefined;
+                    effort?: string | undefined;
+                    timeoutMs?: number | undefined;
+                    runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                    agentProfile?: string | undefined;
+                    allowedTools?: string[] | undefined;
+                    bashAllowlist?: string[] | undefined;
+                    command?: string | undefined;
+                    onFail?: {
+                        retry: string;
+                        max: number;
+                    } | undefined;
+                }[] | undefined;
+                runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                model?: string | undefined;
+                effort?: string | undefined;
+                variants?: 1 | 2 | 3 | undefined;
+                worktree?: boolean | undefined;
+                autonomous?: boolean | undefined;
+                archiveWhenDone?: boolean | undefined;
+                autoMergePr?: boolean | undefined;
+                systemPrompt?: string | undefined;
+            };
+            archived?: {
+                [x: string]: unknown;
+                at: string;
+                outcome: "cancelled" | "launched";
+                runId?: string | undefined;
+                receiptId?: string | undefined;
+                trigger?: "late" | "manual" | "retry" | "schedule" | undefined;
+            } | undefined;
+            createdAt: string;
+            updatedAt: string;
+        };
+    }>;
+    /** One-time schedules only: archive without a task. Cancelled always means no task was created. */
+    cancel(project: AutomationServiceProject, id: string): Promise<ServiceFailure | {
+        ok: true;
+        automation: {
+            [x: string]: unknown;
+            id: string;
+            revision: number;
+            name: string;
+            description?: string | undefined;
+            enabled: boolean;
+            kind: "github" | "schedule";
+            events?: ("issue.labeled" | "issue.opened" | "issue.unlabeled" | "pull_request.opened")[] | undefined;
+            intervalSeconds?: number | undefined;
+            filters?: {
+                [x: string]: unknown;
+                includeExisting?: boolean | undefined;
+                requireCurrentLabels?: boolean | undefined;
+                authors?: string[] | undefined;
+                assignees?: string[] | undefined;
+                allLabels?: string[] | undefined;
+                anyLabels?: string[] | undefined;
+                excludeLabels?: string[] | undefined;
+                changedLabels?: string[] | undefined;
+                lookbackDays: number;
+                maxRecords: number;
+            } | undefined;
+            schedule?: {
+                [x: string]: unknown;
+                type: "daily" | "hours" | "once" | "weekdays" | "weekly";
+                hour?: number | undefined;
+                minute?: number | undefined;
+                day?: number | undefined;
+                every?: 1 | 2 | 3 | 4 | 6 | 8 | 12 | undefined;
+                at?: string | undefined;
+                timeZone?: string | undefined;
+                latestStartMinutes?: number | undefined;
+            } | undefined;
+            task: {
+                [x: string]: unknown;
+                prompt: string;
+                workflow?: string | undefined;
+                steps?: {
+                    id: string;
+                    name?: string | undefined;
+                    prompt?: string | undefined;
+                    skill?: string | undefined;
+                    model?: string | undefined;
+                    effort?: string | undefined;
+                    timeoutMs?: number | undefined;
+                    runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                    agentProfile?: string | undefined;
+                    allowedTools?: string[] | undefined;
+                    bashAllowlist?: string[] | undefined;
+                    command?: string | undefined;
+                    onFail?: {
+                        retry: string;
+                        max: number;
+                    } | undefined;
+                }[] | undefined;
+                runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                model?: string | undefined;
+                effort?: string | undefined;
+                variants?: 1 | 2 | 3 | undefined;
+                worktree?: boolean | undefined;
+                autonomous?: boolean | undefined;
+                archiveWhenDone?: boolean | undefined;
+                autoMergePr?: boolean | undefined;
+                systemPrompt?: string | undefined;
+            };
+            archived?: {
+                [x: string]: unknown;
+                at: string;
+                outcome: "cancelled" | "launched";
+                runId?: string | undefined;
+                receiptId?: string | undefined;
+                trigger?: "late" | "manual" | "retry" | "schedule" | undefined;
+            } | undefined;
+            createdAt: string;
+            updatedAt: string;
+        };
+    }>;
+    /** Run now: a schedule fired once by hand, paused or not, outside the timer and under the same lease. */
+    runNow(project: AutomationServiceProject, id: string): Promise<ServiceFailure | {
+        ok: true;
+        runId: string;
+    }>;
+};
+export type AutomationService = ReturnType<typeof createAutomationService>;
+/** A one-time schedule's create answer beyond its definition (#1465): what every create surface reports. */
+export declare function onceCreateAnswer(automation: AutomationDefinition): {
+    dueAt: string;
+    timeZone: string;
+    resolvedInstant: string;
+    note: string;
+} | undefined;