@av-pi-studio/server 0.0.1

package/dist/orchestration/index.js

@@ -0,0 +1,6 @@
+// Orchestration services: chat rooms, schedules/heartbeats, loops.
+export * from "./chat-service.js";
+export * from "./cron.js";
+export * from "./schedule-service.js";
+export * from "./loop-service.js";
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/orchestration/loop-service.d.ts

@@ -0,0 +1,129 @@
+import type { LoopRecord } from "../persistence/entity-schemas.js";
+/**
+ * Looping agent runs with shell + LLM verifiers ("Ralph loops") (features/loops.md). Each iteration
+ * runs a worker agent, then `verifyChecks` shell commands and an optional `verifyPrompt` verifier;
+ * an iteration succeeds only if ALL checks AND the prompt pass. First success ends the loop
+ * `succeeded`; exceeding `maxIterations`/`maxTimeMs` ends `failed`; stop ends `stopped` after the
+ * current step. On startup, `running` loops are recovered as `stopped` with an interruption log.
+ */
+export type WorkerOutcome = "completed" | "failed" | "canceled";
+export interface LoopVerifyCheckResult {
+    command: string;
+    exitCode: number;
+    passed: boolean;
+    stdout: string;
+    stderr: string;
+    startedAt: string;
+    completedAt: string;
+}
+export interface LoopVerifyPromptResult {
+    passed: boolean;
+    reason: string;
+    verifierAgentId?: string;
+    startedAt: string;
+    completedAt: string;
+}
+export interface LoopIteration {
+    index: number;
+    workerAgentId?: string;
+    workerStartedAt: string;
+    workerCompletedAt?: string;
+    verifierAgentId?: string;
+    status: "running" | "succeeded" | "failed";
+    workerOutcome?: WorkerOutcome;
+    failureReason?: string;
+    verifyChecks: LoopVerifyCheckResult[];
+    verifyPrompt?: LoopVerifyPromptResult;
+}
+export interface LoopLogEntry {
+    seq: number;
+    timestamp: string;
+    iteration?: number;
+    source: "loop" | "worker" | "verifier" | "verify-check";
+    level: "info" | "error";
+    text: string;
+}
+/** Routes loop steps to the agent subsystem + shell. */
+export interface LoopExecutor {
+    runWorker(input: {
+        provider: string;
+        model?: string;
+        modeId?: string;
+        cwd: string;
+        prompt: string;
+    }): Promise<{
+        agentId: string;
+        outcome: WorkerOutcome;
+        output?: string;
+    }>;
+    runShellCheck(command: string, cwd: string): Promise<{
+        exitCode: number;
+        stdout: string;
+        stderr: string;
+    }>;
+    runVerifier(input: {
+        provider: string;
+        model?: string;
+        modeId?: string;
+        cwd: string;
+    }, verifyPrompt: string, workerOutput: string | undefined): Promise<{
+        passed: boolean;
+        reason: string;
+        agentId?: string;
+    }>;
+    archiveAgent(agentId: string): Promise<void>;
+}
+export interface LoopServiceDeps {
+    home: string;
+    executor: LoopExecutor;
+    now?: () => Date;
+    idGen?: () => string;
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface LoopRunInput {
+    name?: string;
+    prompt: string;
+    cwd: string;
+    provider: string;
+    model?: string;
+    modeId?: string;
+    workerProvider?: string;
+    workerModel?: string;
+    verifierProvider?: string;
+    verifierModel?: string;
+    verifierModeId?: string;
+    verifyPrompt?: string;
+    verifyChecks?: string[];
+    archive?: boolean;
+    sleepMs?: number;
+    maxIterations?: number;
+    maxTimeMs?: number;
+}
+export declare class LoopService {
+    private readonly deps;
+    private readonly store;
+    private readonly now;
+    private readonly idGen;
+    private readonly sleep;
+    private loops;
+    private readonly stopRequested;
+    private loaded;
+    constructor(deps: LoopServiceDeps);
+    private nowIso;
+    private ensureLoaded;
+    private persist;
+    private appendLog;
+    list(): Promise<LoopRecord[]>;
+    inspect(id: string): Promise<LoopRecord | null>;
+    logs(id: string, sinceSeq?: number): Promise<LoopLogEntry[]>;
+    stop(id: string): Promise<void>;
+    /** Create + run a loop to completion (await the full run). Returns the final record. */
+    run(input: LoopRunInput): Promise<LoopRecord>;
+    private runLoop;
+    /**
+     * Boot recovery: loops left `running` (daemon crashed mid-run) → `stopped` with an interruption
+     * log entry. This is the recovery hook wired into AgentManager.recover (sprint-005).
+     */
+    recover(): Promise<number>;
+}
+//# sourceMappingURL=loop-service.d.ts.map

package/dist/orchestration/loop-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-service.d.ts","sourceRoot":"","sources":["../../src/orchestration/loop-service.ts"],"names":[],"mappings":"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"}

package/dist/orchestration/loop-service.js

@@ -0,0 +1,234 @@
+import { randomBytes } from "node:crypto";
+import { createLoopStore } from "../persistence/entity-stores.js";
+export class LoopService {
+    deps;
+    store;
+    now;
+    idGen;
+    sleep;
+    loops = new Map();
+    stopRequested = new Set();
+    loaded = false;
+    constructor(deps) {
+        this.deps = deps;
+        this.store = createLoopStore(deps.home);
+        this.now = deps.now ?? (() => new Date());
+        this.idGen = deps.idGen ?? (() => randomBytes(4).toString("hex"));
+        this.sleep = deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    }
+    nowIso() {
+        return this.now().toISOString();
+    }
+    async ensureLoaded() {
+        if (this.loaded)
+            return;
+        for (const rec of await this.store.load())
+            this.loops.set(rec.id, rec);
+        this.loaded = true;
+    }
+    async persist() {
+        await this.store.save([...this.loops.values()]);
+    }
+    appendLog(rec, entry) {
+        const seq = (rec.nextLogSeq ?? 0);
+        rec.logs.push({ seq, timestamp: this.nowIso(), ...entry });
+        rec.nextLogSeq = seq + 1;
+    }
+    async list() {
+        await this.ensureLoaded();
+        return [...this.loops.values()];
+    }
+    async inspect(id) {
+        await this.ensureLoaded();
+        return this.loops.get(id) ?? null;
+    }
+    async logs(id, sinceSeq = 0) {
+        await this.ensureLoaded();
+        const rec = this.loops.get(id);
+        if (!rec)
+            return [];
+        return rec.logs.filter((l) => l.seq >= sinceSeq);
+    }
+    async stop(id) {
+        await this.ensureLoaded();
+        const rec = this.loops.get(id);
+        if (!rec)
+            return;
+        this.stopRequested.add(id);
+        rec.stopRequestedAt = this.nowIso();
+        await this.persist();
+    }
+    /** Create + run a loop to completion (await the full run). Returns the final record. */
+    async run(input) {
+        await this.ensureLoaded();
+        const ts = this.nowIso();
+        const rec = {
+            id: this.idGen(),
+            name: input.name,
+            prompt: input.prompt,
+            cwd: input.cwd,
+            provider: input.provider,
+            model: input.model,
+            modeId: input.modeId,
+            workerProvider: input.workerProvider,
+            workerModel: input.workerModel,
+            verifierProvider: input.verifierProvider,
+            verifierModel: input.verifierModel,
+            verifierModeId: input.verifierModeId,
+            verifyPrompt: input.verifyPrompt,
+            verifyChecks: input.verifyChecks ?? [],
+            archive: input.archive ?? false,
+            sleepMs: input.sleepMs ?? 0,
+            maxIterations: input.maxIterations,
+            maxTimeMs: input.maxTimeMs,
+            status: "running",
+            createdAt: ts,
+            updatedAt: ts,
+            startedAt: ts,
+            iterations: [],
+            logs: [],
+            nextLogSeq: 0,
+        };
+        this.loops.set(rec.id, rec);
+        this.appendLog(rec, { source: "loop", level: "info", text: "loop started" });
+        await this.persist();
+        await this.runLoop(rec);
+        return rec;
+    }
+    async runLoop(rec) {
+        const startMs = this.now().getTime();
+        let succeeded = false;
+        let index = 0;
+        while (true) {
+            if (this.stopRequested.has(rec.id))
+                break;
+            if (rec.maxIterations !== undefined && index >= rec.maxIterations)
+                break;
+            if (rec.maxTimeMs !== undefined && this.now().getTime() - startMs >= rec.maxTimeMs)
+                break;
+            index += 1;
+            const iteration = {
+                index,
+                workerStartedAt: this.nowIso(),
+                status: "running",
+                verifyChecks: [],
+            };
+            rec.iterations.push(iteration);
+            // Worker step.
+            const worker = await this.deps.executor.runWorker({
+                provider: rec.workerProvider ?? rec.provider,
+                model: rec.workerModel ?? rec.model,
+                modeId: rec.modeId,
+                cwd: rec.cwd,
+                prompt: rec.prompt,
+            });
+            iteration.workerAgentId = worker.agentId;
+            iteration.workerOutcome = worker.outcome;
+            iteration.workerCompletedAt = this.nowIso();
+            this.appendLog(rec, {
+                source: "worker",
+                level: worker.outcome === "completed" ? "info" : "error",
+                iteration: index,
+                text: `worker ${worker.agentId} ${worker.outcome}`,
+            });
+            if (rec.archive)
+                await this.deps.executor.archiveAgent(worker.agentId);
+            // Verify checks (shell).
+            let passed = worker.outcome === "completed";
+            for (const command of rec.verifyChecks) {
+                const startedAt = this.nowIso();
+                const result = await this.deps.executor.runShellCheck(command, rec.cwd);
+                const checkPassed = result.exitCode === 0;
+                iteration.verifyChecks.push({
+                    command,
+                    exitCode: result.exitCode,
+                    passed: checkPassed,
+                    stdout: result.stdout,
+                    stderr: result.stderr,
+                    startedAt,
+                    completedAt: this.nowIso(),
+                });
+                this.appendLog(rec, {
+                    source: "verify-check",
+                    level: checkPassed ? "info" : "error",
+                    iteration: index,
+                    text: `check \`${command}\` → exit ${result.exitCode}`,
+                });
+                passed &&= checkPassed;
+            }
+            // Verifier prompt (LLM).
+            if (rec.verifyPrompt) {
+                const startedAt = this.nowIso();
+                const verdict = await this.deps.executor.runVerifier({
+                    provider: rec.verifierProvider ?? rec.provider,
+                    model: rec.verifierModel ?? rec.model,
+                    modeId: rec.verifierModeId,
+                    cwd: rec.cwd,
+                }, rec.verifyPrompt, worker.output);
+                iteration.verifierAgentId = verdict.agentId;
+                iteration.verifyPrompt = {
+                    passed: verdict.passed,
+                    reason: verdict.reason,
+                    verifierAgentId: verdict.agentId,
+                    startedAt,
+                    completedAt: this.nowIso(),
+                };
+                this.appendLog(rec, {
+                    source: "verifier",
+                    level: verdict.passed ? "info" : "error",
+                    iteration: index,
+                    text: `verifier: ${verdict.passed ? "pass" : "fail"} — ${verdict.reason}`,
+                });
+                passed &&= verdict.passed;
+            }
+            iteration.status = passed ? "succeeded" : "failed";
+            await this.persist();
+            if (passed) {
+                succeeded = true;
+                break;
+            }
+            await this.sleep(rec.sleepMs ?? 0);
+        }
+        if (this.stopRequested.has(rec.id)) {
+            rec.status = "stopped";
+            this.appendLog(rec, { source: "loop", level: "info", text: "loop stopped" });
+        }
+        else if (succeeded) {
+            rec.status = "succeeded";
+            this.appendLog(rec, { source: "loop", level: "info", text: "loop succeeded" });
+        }
+        else {
+            rec.status = "failed";
+            this.appendLog(rec, { source: "loop", level: "error", text: "loop failed (cap reached)" });
+        }
+        rec.completedAt = this.nowIso();
+        rec.updatedAt = rec.completedAt;
+        this.stopRequested.delete(rec.id);
+        await this.persist();
+    }
+    /**
+     * Boot recovery: loops left `running` (daemon crashed mid-run) → `stopped` with an interruption
+     * log entry. This is the recovery hook wired into AgentManager.recover (sprint-005).
+     */
+    async recover() {
+        await this.ensureLoaded();
+        let recovered = 0;
+        for (const rec of this.loops.values()) {
+            if (rec.status === "running") {
+                rec.status = "stopped";
+                rec.completedAt = this.nowIso();
+                rec.updatedAt = rec.completedAt;
+                this.appendLog(rec, {
+                    source: "loop",
+                    level: "error",
+                    text: "loop interrupted by daemon restart; recovered as stopped",
+                });
+                recovered += 1;
+            }
+        }
+        if (recovered > 0)
+            await this.persist();
+        return recovered;
+    }
+}
+//# sourceMappingURL=loop-service.js.map

package/dist/orchestration/loop-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-service.js","sourceRoot":"","sources":["../../src/orchestration/loop-service.ts"],"names":[],"mappings":"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"}

package/dist/orchestration/schedule-service.d.ts

@@ -0,0 +1,65 @@
+import type { Schedule } from "../persistence/entity-schemas.js";
+/**
+ * Cron/interval schedules + heartbeats (features/schedules-heartbeats.md). A schedule fires a prompt
+ * either into a new agent (`new-agent`) or an existing one (`agent`, heartbeat-style). The scheduler
+ * loop computes `nextRunAt`, records each `ScheduleRun`, and completes on `maxRuns`/`expiresAt`.
+ */
+export type Cadence = Schedule["cadence"];
+export type ScheduleTarget = Schedule["target"];
+export type ScheduleRun = Schedule["runs"][number];
+/** Routes a schedule fire to the agent subsystem. */
+export interface ScheduleExecutor {
+    /** `new-agent` target: create an agent with config + send the prompt. */
+    createAndPrompt(config: Record<string, unknown>, prompt: string): Promise<{
+        agentId: string;
+        output?: unknown;
+    }>;
+    /** `agent` target (heartbeat): prompt an existing agent. */
+    promptExisting(agentId: string, prompt: string): Promise<{
+        output?: unknown;
+    }>;
+}
+export interface ScheduleServiceDeps {
+    home: string;
+    executor: ScheduleExecutor;
+    now?: () => Date;
+    idGen?: () => string;
+}
+export interface CreateScheduleInput {
+    name?: string;
+    prompt: string;
+    cadence: Cadence;
+    target: ScheduleTarget;
+    expiresAt?: string;
+    maxRuns?: number;
+}
+export declare class ScheduleService {
+    private readonly deps;
+    private readonly now;
+    private readonly idGen;
+    private schedules;
+    private loaded;
+    constructor(deps: ScheduleServiceDeps);
+    private nowIso;
+    private ensureLoaded;
+    private persist;
+    /** Compute the next fire time strictly after `from` for a cadence. */
+    private computeNextRunAt;
+    create(input: CreateScheduleInput): Promise<Schedule>;
+    list(): Promise<Schedule[]>;
+    inspect(id: string): Promise<Schedule | null>;
+    logs(id: string): Promise<ScheduleRun[]>;
+    pause(id: string): Promise<Schedule | null>;
+    resume(id: string): Promise<Schedule | null>;
+    update(id: string, patch: Partial<CreateScheduleInput>): Promise<Schedule | null>;
+    delete(id: string): Promise<boolean>;
+    /** Execute immediately without altering the regular cadence. */
+    runOnce(id: string): Promise<ScheduleRun | null>;
+    /**
+     * Scheduler tick: fire every active schedule whose `nextRunAt <= now`. Records a run, updates
+     * `lastRunAt`, recomputes `nextRunAt`, and completes on `maxRuns`/`expiresAt`.
+     */
+    tick(now?: Date): Promise<void>;
+    private executeRun;
+}
+//# sourceMappingURL=schedule-service.d.ts.map

package/dist/orchestration/schedule-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-service.d.ts","sourceRoot":"","sources":["../../src/orchestration/schedule-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAQjE;;;;GAIG;AAEH,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC1C,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,eAAe,CACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClD,4DAA4D;IAC5D,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAMd,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAS;gBAEM,IAAI,EAAE,mBAAmB;IAKtD,OAAO,CAAC,MAAM;YAIA,YAAY;YAQZ,OAAO;IAMrB,sEAAsE;IACtE,OAAO,CAAC,gBAAgB;IAMlB,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuBrD,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK3B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAK7C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKxC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAW3C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAW5C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAoBjF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM1C,gEAAgE;IAC1D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAStD;;;OAGG;IACG,IAAI,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAsCnC,UAAU;CA+BzB"}

package/dist/orchestration/schedule-service.js

@@ -0,0 +1,201 @@
+import { randomBytes, randomUUID } from "node:crypto";
+import { deleteSchedule as deleteScheduleFile, loadAllSchedules, saveSchedule, } from "../persistence/entity-stores.js";
+import { assertValidCron, nextCronTime, nextEveryTime } from "./cron.js";
+export class ScheduleService {
+    deps;
+    now;
+    idGen;
+    schedules = new Map();
+    loaded = false;
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? (() => new Date());
+        this.idGen = deps.idGen ?? (() => randomBytes(4).toString("hex"));
+    }
+    nowIso() {
+        return this.now().toISOString();
+    }
+    async ensureLoaded() {
+        if (this.loaded)
+            return;
+        for (const schedule of await loadAllSchedules(this.deps.home)) {
+            this.schedules.set(schedule.id, schedule);
+        }
+        this.loaded = true;
+    }
+    async persist(schedule) {
+        schedule.updatedAt = this.nowIso();
+        this.schedules.set(schedule.id, schedule);
+        await saveSchedule(this.deps.home, schedule);
+    }
+    /** Compute the next fire time strictly after `from` for a cadence. */
+    computeNextRunAt(cadence, from) {
+        if (cadence.type === "every")
+            return nextEveryTime(cadence.everyMs, from).toISOString();
+        const next = nextCronTime(cadence.expression, from, cadence.timezone);
+        return next?.toISOString();
+    }
+    async create(input) {
+        await this.ensureLoaded();
+        if (input.cadence.type === "cron")
+            assertValidCron(input.cadence.expression);
+        const ts = this.nowIso();
+        const schedule = {
+            id: this.idGen(),
+            name: input.name,
+            prompt: input.prompt,
+            cadence: input.cadence,
+            target: input.target,
+            status: "active",
+            createdAt: ts,
+            updatedAt: ts,
+            nextRunAt: this.computeNextRunAt(input.cadence, this.now()),
+            expiresAt: input.expiresAt,
+            maxRuns: input.maxRuns,
+            runs: [],
+        };
+        await this.persist(schedule);
+        return schedule;
+    }
+    async list() {
+        await this.ensureLoaded();
+        return [...this.schedules.values()];
+    }
+    async inspect(id) {
+        await this.ensureLoaded();
+        return this.schedules.get(id) ?? null;
+    }
+    async logs(id) {
+        await this.ensureLoaded();
+        return this.schedules.get(id)?.runs ?? [];
+    }
+    async pause(id) {
+        await this.ensureLoaded();
+        const schedule = this.schedules.get(id);
+        if (!schedule || schedule.status === "completed")
+            return schedule ?? null;
+        schedule.status = "paused";
+        schedule.pausedAt = this.nowIso();
+        schedule.nextRunAt = undefined;
+        await this.persist(schedule);
+        return schedule;
+    }
+    async resume(id) {
+        await this.ensureLoaded();
+        const schedule = this.schedules.get(id);
+        if (!schedule || schedule.status === "completed")
+            return schedule ?? null;
+        schedule.status = "active";
+        schedule.pausedAt = undefined;
+        schedule.nextRunAt = this.computeNextRunAt(schedule.cadence, this.now());
+        await this.persist(schedule);
+        return schedule;
+    }
+    async update(id, patch) {
+        await this.ensureLoaded();
+        const schedule = this.schedules.get(id);
+        if (!schedule)
+            return null;
+        if (patch.cadence?.type === "cron")
+            assertValidCron(patch.cadence.expression);
+        if (patch.name !== undefined)
+            schedule.name = patch.name;
+        if (patch.prompt !== undefined)
+            schedule.prompt = patch.prompt;
+        if (patch.target !== undefined)
+            schedule.target = patch.target;
+        if (patch.expiresAt !== undefined)
+            schedule.expiresAt = patch.expiresAt;
+        if (patch.maxRuns !== undefined)
+            schedule.maxRuns = patch.maxRuns;
+        if (patch.cadence !== undefined) {
+            schedule.cadence = patch.cadence;
+            if (schedule.status === "active") {
+                schedule.nextRunAt = this.computeNextRunAt(patch.cadence, this.now());
+            }
+        }
+        await this.persist(schedule);
+        return schedule;
+    }
+    async delete(id) {
+        await this.ensureLoaded();
+        this.schedules.delete(id);
+        return deleteScheduleFile(this.deps.home, id);
+    }
+    /** Execute immediately without altering the regular cadence. */
+    async runOnce(id) {
+        await this.ensureLoaded();
+        const schedule = this.schedules.get(id);
+        if (!schedule)
+            return null;
+        const run = await this.executeRun(schedule, this.now());
+        await this.persist(schedule);
+        return run;
+    }
+    /**
+     * Scheduler tick: fire every active schedule whose `nextRunAt <= now`. Records a run, updates
+     * `lastRunAt`, recomputes `nextRunAt`, and completes on `maxRuns`/`expiresAt`.
+     */
+    async tick(now = this.now()) {
+        await this.ensureLoaded();
+        for (const schedule of this.schedules.values()) {
+            if (schedule.status !== "active")
+                continue;
+            // Expiry check first.
+            if (schedule.expiresAt && now.getTime() >= new Date(schedule.expiresAt).getTime()) {
+                schedule.status = "completed";
+                schedule.nextRunAt = undefined;
+                await this.persist(schedule);
+                continue;
+            }
+            if (!schedule.nextRunAt || now.getTime() < new Date(schedule.nextRunAt).getTime())
+                continue;
+            const scheduledFor = new Date(schedule.nextRunAt);
+            await this.executeRun(schedule, scheduledFor);
+            schedule.lastRunAt = scheduledFor.toISOString();
+            // Complete on maxRuns, else recompute the next fire from this fire time.
+            if (schedule.maxRuns !== undefined && schedule.runs.length >= schedule.maxRuns) {
+                schedule.status = "completed";
+                schedule.nextRunAt = undefined;
+            }
+            else {
+                schedule.nextRunAt = this.computeNextRunAt(schedule.cadence, scheduledFor);
+                if (schedule.expiresAt &&
+                    schedule.nextRunAt &&
+                    new Date(schedule.nextRunAt).getTime() >= new Date(schedule.expiresAt).getTime()) {
+                    schedule.status = "completed";
+                    schedule.nextRunAt = undefined;
+                }
+            }
+            await this.persist(schedule);
+        }
+    }
+    async executeRun(schedule, scheduledFor) {
+        const run = {
+            id: randomUUID(),
+            scheduledFor: scheduledFor.toISOString(),
+            startedAt: this.nowIso(),
+            status: "running",
+        };
+        schedule.runs.push(run);
+        try {
+            if (schedule.target.type === "new-agent") {
+                const { agentId, output } = await this.deps.executor.createAndPrompt(schedule.target.config, schedule.prompt);
+                run.agentId = agentId;
+                run.output = output;
+            }
+            else {
+                const { output } = await this.deps.executor.promptExisting(schedule.target.agentId, schedule.prompt);
+                run.output = output;
+            }
+            run.status = "succeeded";
+        }
+        catch (error) {
+            run.status = "failed";
+            run.error = error instanceof Error ? error.message : String(error);
+        }
+        run.endedAt = this.nowIso();
+        return run;
+    }
+}
+//# sourceMappingURL=schedule-service.js.map