p-spore 0.1.0

package/dist/automation/cron-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-adapter.d.ts","sourceRoot":"","sources":["../../src/automation/cron-adapter.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAa7E;AAED,qBAAa,YAAY;;gBAGX,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAK7C,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAI9B,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAInC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,EAAE;IAI5C,IAAI,IAAI,IAAI;CAGb;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOvD"}

package/dist/automation/cron-adapter.js

@@ -0,0 +1,48 @@
+import { Cron } from "croner";
+export function validateFiveFieldCron(pattern, timezone) {
+    const fields = pattern.trim().split(/\s+/);
+    if (fields.length !== 5)
+        throw new Error("Cron expression must contain exactly 5 fields (minute hour day month weekday)");
+    if (fields.some((field) => !/^[0-9*/?,A-Za-z-]+$/.test(field) || /[?LW#]/i.test(field))) {
+        throw new Error("Cron expression contains unsupported non-standard syntax");
+    }
+    validateTimeZone(timezone);
+    const cron = new Cron(pattern, { timezone, mode: "5-part", paused: true });
+    try {
+        if (!cron.nextRun(new Date()))
+            throw new Error("Cron expression has no future run");
+    }
+    finally {
+        cron.stop();
+    }
+}
+export class CronSchedule {
+    #cron;
+    constructor(pattern, timezone) {
+        validateFiveFieldCron(pattern, timezone);
+        this.#cron = new Cron(pattern, { timezone, mode: "5-part", paused: true });
+    }
+    next(after) {
+        return this.#cron.nextRun(after);
+    }
+    previous(before) {
+        return this.#cron.previousRuns(1, before)[0] ?? null;
+    }
+    nextMany(count, after) {
+        return this.#cron.nextRuns(count, after);
+    }
+    stop() {
+        this.#cron.stop();
+    }
+}
+export function validateTimeZone(timezone) {
+    if (!timezone.trim() || timezone.length > 128)
+        throw new Error("Timezone must be a non-empty IANA timezone");
+    try {
+        new Intl.DateTimeFormat("en", { timeZone: timezone }).format(new Date());
+    }
+    catch {
+        throw new Error(`Invalid IANA timezone: ${timezone}`);
+    }
+}
+//# sourceMappingURL=cron-adapter.js.map

package/dist/automation/cron-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-adapter.js","sourceRoot":"","sources":["../../src/automation/cron-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,QAAgB;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IAC1H,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACtF,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,OAAO,YAAY;IACd,KAAK,CAAO;IAErB,YAAY,OAAe,EAAE,QAAgB;QAC3C,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,CAAC,KAAW;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ,CAAC,MAAY;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACvD,CAAC;IAED,QAAQ,CAAC,KAAa,EAAE,KAAW;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI;QACF,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC7G,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/automation/daemon-run-executor.d.ts

@@ -0,0 +1,18 @@
+import { AgentApplication } from "../application/agent-application.js";
+import type { ToolGate } from "../domain/runtime.js";
+import { ShellService } from "../shell/shell-service.js";
+import type { RunExecutor, RunExecutionResult } from "./scheduler.js";
+import type { RunRecord } from "./types.js";
+export interface DaemonRunExecutorOptions {
+    application: AgentApplication;
+    shell: ShellService;
+    toolGate: ToolGate;
+    maxShellOutputBytes: number;
+    idFactory?: () => string;
+}
+export declare class DaemonRunExecutor implements RunExecutor {
+    #private;
+    constructor(options: DaemonRunExecutorOptions);
+    execute(run: RunRecord, signal: AbortSignal): Promise<RunExecutionResult>;
+}
+//# sourceMappingURL=daemon-run-executor.d.ts.map

package/dist/automation/daemon-run-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-run-executor.d.ts","sourceRoot":"","sources":["../../src/automation/daemon-run-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAuB,MAAM,qCAAqC,CAAC;AAC5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAED,qBAAa,iBAAkB,YAAW,WAAW;;gBAOvC,OAAO,EAAE,wBAAwB;IAQvC,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA2ChF"}

package/dist/automation/daemon-run-executor.js

@@ -0,0 +1,69 @@
+import { randomUUID } from "node:crypto";
+import { AgentApplication, AgentRunBudgetError } from "../application/agent-application.js";
+import { ShellService } from "../shell/shell-service.js";
+export class DaemonRunExecutor {
+    #application;
+    #shell;
+    #toolGate;
+    #maxShellOutputBytes;
+    #idFactory;
+    constructor(options) {
+        this.#application = options.application;
+        this.#shell = options.shell;
+        this.#toolGate = options.toolGate;
+        this.#maxShellOutputBytes = options.maxShellOutputBytes;
+        this.#idFactory = options.idFactory ?? randomUUID;
+    }
+    async execute(run, signal) {
+        if (run.activity.kind === "agent") {
+            try {
+                await this.#application.executeAgentRun(run, signal);
+                return { status: "succeeded" };
+            }
+            catch (error) {
+                if (error instanceof AgentRunBudgetError)
+                    return { status: "budget_exhausted", reason: error.message };
+                throw error;
+            }
+        }
+        const authorization = await this.#toolGate.authorize({
+            sessionId: `run:${run.id}`,
+            toolCallId: this.#idFactory(),
+            toolName: "shell",
+            input: { command: run.activity.command, cwd: run.activity.cwd },
+            agentPath: ["automation", run.jobId ?? run.source, run.id],
+            runId: run.id,
+            ...(run.jobId === undefined ? {} : { jobId: run.jobId }),
+            allowedApprovalScopes: run.jobId === undefined ? ["once", "session"] : ["once", "session", "job"],
+        });
+        if (authorization.decision === "deny")
+            return { status: "blocked", reason: authorization.reason };
+        if (signal.aborted)
+            throw signal.reason instanceof Error ? signal.reason : new Error("Run aborted");
+        const handle = await this.#shell.start({
+            command: run.activity.command,
+            cwd: run.activity.cwd,
+            mode: "pipe",
+            timeoutMs: run.timeoutMs,
+            maxOutputBytes: this.#maxShellOutputBytes,
+        });
+        const abort = () => handle.signal("SIGTERM");
+        signal.addEventListener("abort", abort, { once: true });
+        try {
+            const result = await handle.completion;
+            if (signal.aborted)
+                throw signal.reason instanceof Error ? signal.reason : new Error("Run aborted");
+            if (result.outputLimitExceeded)
+                return { status: "budget_exhausted", reason: "shell output limit exceeded" };
+            if (result.timedOut)
+                return { status: "budget_exhausted", reason: "shell timeout exceeded" };
+            if (result.exitCode !== 0)
+                throw new Error(`Scheduled command exited with code ${String(result.exitCode)}`);
+            return { status: "succeeded" };
+        }
+        finally {
+            signal.removeEventListener("abort", abort);
+        }
+    }
+}
+//# sourceMappingURL=daemon-run-executor.js.map

package/dist/automation/daemon-run-executor.js.map

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

package/dist/automation/job-store.d.ts

@@ -0,0 +1,12 @@
+import type { JobDefinition } from "./types.js";
+export declare class JobStore {
+    #private;
+    constructor(options: {
+        jobsDirectory: string;
+        workspaceRoot: string;
+    });
+    loadAll(): Promise<JobDefinition[]>;
+    put(value: unknown, expectedSha256: string | null): Promise<JobDefinition>;
+}
+export declare function parseJob(value: unknown, expectedId: string, workspaceRoot: string): Promise<JobDefinition>;
+//# sourceMappingURL=job-store.d.ts.map

package/dist/automation/job-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-store.d.ts","sourceRoot":"","sources":["../../src/automation/job-store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAkB,aAAa,EAA0B,MAAM,YAAY,CAAC;AAExF,qBAAa,QAAQ;;gBAKP,OAAO,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;IAK/D,OAAO,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAazC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;CAkC3E;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2ChH"}

package/dist/automation/job-store.js

@@ -0,0 +1,185 @@
+import { createHash } from "node:crypto";
+import { lstat, readdir, readFile, realpath, stat } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { atomicWriteFile } from "../storage/atomic.js";
+import { validateFiveFieldCron } from "./cron-adapter.js";
+export class JobStore {
+    #jobsDirectory;
+    #workspaceRoot;
+    #tail = Promise.resolve();
+    constructor(options) {
+        this.#jobsDirectory = options.jobsDirectory;
+        this.#workspaceRoot = options.workspaceRoot;
+    }
+    async loadAll() {
+        const entries = await readdir(this.#jobsDirectory, { withFileTypes: true });
+        const jobs = [];
+        for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+            if (!entry.isFile() || !entry.name.endsWith(".json"))
+                continue;
+            const expectedId = basename(entry.name, ".json");
+            const content = await readFile(join(this.#jobsDirectory, entry.name));
+            const value = JSON.parse(content.toString("utf8"));
+            jobs.push({ ...(await parseJob(value, expectedId, this.#workspaceRoot)), sourceSha256: sha256(content) });
+        }
+        return jobs;
+    }
+    put(value, expectedSha256) {
+        return this.#serialize(async () => {
+            const root = object(value, "job");
+            const id = identifier(root["id"], "job.id");
+            const parsed = await parseJob(value, id, this.#workspaceRoot);
+            const path = join(this.#jobsDirectory, `${id}.json`);
+            let current;
+            try {
+                const metadata = await lstat(path);
+                if (!metadata.isFile() || metadata.isSymbolicLink())
+                    throw new Error(`Job source must be a regular file: ${path}`);
+                current = await readFile(path);
+            }
+            catch (error) {
+                if (!isNodeError(error) || error.code !== "ENOENT")
+                    throw error;
+            }
+            const currentSha256 = current ? sha256(current) : null;
+            if (expectedSha256 !== currentSha256) {
+                throw new Error(`Job update conflict for ${id}: expected ${expectedSha256 ?? "missing"}, current ${currentSha256 ?? "missing"}`);
+            }
+            const content = Buffer.from(`${JSON.stringify(value, null, 2)}\n`, "utf8");
+            await atomicWriteFile(path, content, 0o600);
+            return { ...parsed, sourceSha256: sha256(content) };
+        });
+    }
+    #serialize(operation) {
+        const result = this.#tail.then(operation, operation);
+        this.#tail = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+export async function parseJob(value, expectedId, workspaceRoot) {
+    const job = object(value, "job");
+    exactKeys(job, ["version", "id", "enabled", "schedule", "cwd", "policyRef", "concurrency", "misfire", "timeoutMs", "budget", "delivery", "kind", "payload"], "job");
+    if (job["version"] !== 1)
+        throw new Error("job.version must be 1");
+    const id = identifier(job["id"], "job.id");
+    if (id !== expectedId)
+        throw new Error(`job.id ${id} must match filename ${expectedId}.json`);
+    const schedule = object(job["schedule"], "job.schedule");
+    exactKeys(schedule, ["cron", "timezone"], "job.schedule");
+    const cron = string(schedule["cron"], "job.schedule.cron");
+    const timezone = string(schedule["timezone"], "job.schedule.timezone");
+    validateFiveFieldCron(cron, timezone);
+    const cwdInput = string(job["cwd"], "job.cwd");
+    const cwd = await realpath(resolve(workspaceRoot, cwdInput));
+    if (!(await stat(cwd)).isDirectory())
+        throw new Error(`job.cwd must resolve to a directory: ${cwd}`);
+    const budget = parseBudget(job["budget"]);
+    const delivery = parseDelivery(job["delivery"]);
+    const kind = enumeration(job["kind"], ["agent", "command"], "job.kind");
+    const payload = object(job["payload"], "job.payload");
+    let activity;
+    if (kind === "agent") {
+        exactKeys(payload, ["prompt"], "job.payload");
+        activity = { kind, prompt: string(payload["prompt"], "job.payload.prompt"), cwd };
+    }
+    else {
+        exactKeys(payload, ["command"], "job.payload");
+        activity = { kind, command: string(payload["command"], "job.payload.command"), cwd };
+    }
+    return {
+        version: 1,
+        id,
+        enabled: boolean(job["enabled"], "job.enabled"),
+        schedule: { cron, timezone },
+        policyRef: string(job["policyRef"], "job.policyRef"),
+        concurrency: enumeration(job["concurrency"], ["forbid", "replace", "allow"], "job.concurrency"),
+        misfire: enumeration(job["misfire"], ["skip", "run_once"], "job.misfire"),
+        timeoutMs: positiveInteger(job["timeoutMs"], "job.timeoutMs", 86_400_000),
+        budget,
+        delivery,
+        activity,
+    };
+}
+function parseBudget(value) {
+    const budget = object(value, "job.budget");
+    exactKeys(budget, ["maxTurns", "maxToolCalls", "maxInputTokens", "maxOutputTokens", "maxCostUsd", "maxChildren"], "job.budget", ["maxCostUsd"]);
+    const maxCostUsd = budget["maxCostUsd"];
+    return {
+        maxTurns: positiveInteger(budget["maxTurns"], "job.budget.maxTurns", 10_000),
+        maxToolCalls: positiveInteger(budget["maxToolCalls"], "job.budget.maxToolCalls", 100_000),
+        maxInputTokens: positiveInteger(budget["maxInputTokens"], "job.budget.maxInputTokens", 100_000_000),
+        maxOutputTokens: positiveInteger(budget["maxOutputTokens"], "job.budget.maxOutputTokens", 100_000_000),
+        maxChildren: nonNegativeInteger(budget["maxChildren"], "job.budget.maxChildren", 1_000),
+        ...(maxCostUsd === undefined ? {} : { maxCostUsd: positiveNumber(maxCostUsd, "job.budget.maxCostUsd") }),
+    };
+}
+function parseDelivery(value) {
+    const delivery = object(value, "job.delivery");
+    const kind = enumeration(delivery["kind"], ["session", "local-notification", "none"], "job.delivery.kind");
+    if (kind === "session") {
+        exactKeys(delivery, ["kind", "sessionId"], "job.delivery");
+        return { kind, sessionId: identifier(delivery["sessionId"], "job.delivery.sessionId") };
+    }
+    exactKeys(delivery, ["kind"], "job.delivery");
+    return { kind };
+}
+function object(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        throw new Error(`${path} must be an object`);
+    return value;
+}
+function exactKeys(value, allowed, path, optional = []) {
+    const allowedSet = new Set(allowed);
+    const unknown = Object.keys(value).filter((key) => !allowedSet.has(key));
+    if (unknown.length > 0)
+        throw new Error(`${path} contains unknown keys: ${unknown.join(", ")}`);
+    const optionalSet = new Set(optional);
+    for (const key of allowed)
+        if (!optionalSet.has(key) && !(key in value))
+            throw new Error(`${path}.${key} is required`);
+}
+function string(value, path) {
+    if (typeof value !== "string" || !value.trim())
+        throw new Error(`${path} must be a non-empty string`);
+    return value;
+}
+function identifier(value, path) {
+    const result = string(value, path);
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(result))
+        throw new Error(`${path} is not a valid identifier`);
+    return result;
+}
+function boolean(value, path) {
+    if (typeof value !== "boolean")
+        throw new Error(`${path} must be boolean`);
+    return value;
+}
+function enumeration(value, allowed, path) {
+    if (typeof value !== "string" || !allowed.includes(value))
+        throw new Error(`${path} must be one of: ${allowed.join(", ")}`);
+    return value;
+}
+function positiveInteger(value, path, maximum) {
+    if (!Number.isSafeInteger(value) || Number(value) < 1 || Number(value) > maximum) {
+        throw new Error(`${path} must be an integer between 1 and ${maximum}`);
+    }
+    return Number(value);
+}
+function nonNegativeInteger(value, path, maximum) {
+    if (!Number.isSafeInteger(value) || Number(value) < 0 || Number(value) > maximum) {
+        throw new Error(`${path} must be an integer between 0 and ${maximum}`);
+    }
+    return Number(value);
+}
+function positiveNumber(value, path) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0)
+        throw new Error(`${path} must be positive`);
+    return value;
+}
+function sha256(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=job-store.js.map

package/dist/automation/job-store.js.map

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

package/dist/automation/run-ledger.d.ts

@@ -0,0 +1,25 @@
+import type { RunRecord, RunTriggerSpec } from "./types.js";
+export interface RunLedgerOptions {
+    root: string;
+    recoveryDirectory: string;
+    clock?: () => Date;
+    idFactory?: () => string;
+}
+export declare class RunLedger {
+    #private;
+    constructor(options: RunLedgerOptions);
+    initialize(): Promise<{
+        recoveredUnknown: RunRecord[];
+        queued: RunRecord[];
+    }>;
+    claim(spec: RunTriggerSpec): Promise<{
+        claimed: boolean;
+        record: RunRecord;
+    }>;
+    transition(id: string, patch: Pick<RunRecord, "status"> & Partial<Pick<RunRecord, "startedAt" | "finishedAt" | "reason" | "error">>): Promise<RunRecord>;
+    get(id: string): RunRecord | undefined;
+    findSlot(slotKey: string): RunRecord | undefined;
+    latestForJob(jobId: string): RunRecord | undefined;
+    list(): RunRecord[];
+}
+//# sourceMappingURL=run-ledger.d.ts.map

package/dist/automation/run-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-ledger.d.ts","sourceRoot":"","sources":["../../src/automation/run-ledger.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAa,cAAc,EAAE,MAAM,YAAY,CAAC;AAYvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAED,qBAAa,SAAS;;gBASR,OAAO,EAAE,gBAAgB;IAO/B,UAAU,IAAI,OAAO,CAAC;QAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC;QAAC,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IA6BnF,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IAsB7E,UAAU,CACR,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC,GAC3G,OAAO,CAAC,SAAS,CAAC;IAYrB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKtC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKhD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAMlD,IAAI,IAAI,SAAS,EAAE;CAqBpB"}

package/dist/automation/run-ledger.js

@@ -0,0 +1,148 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { appendJsonLine } from "../storage/atomic.js";
+import { readJsonLinesRecovering } from "../storage/jsonl.js";
+const TERMINAL = new Set([
+    "succeeded",
+    "failed",
+    "blocked",
+    "cancelled",
+    "budget_exhausted",
+    "unknown",
+    "skipped",
+]);
+export class RunLedger {
+    #root;
+    #recoveryDirectory;
+    #clock;
+    #idFactory;
+    #runs = new Map();
+    #slots = new Map();
+    #tail = Promise.resolve();
+    constructor(options) {
+        this.#root = options.root;
+        this.#recoveryDirectory = options.recoveryDirectory;
+        this.#clock = options.clock ?? (() => new Date());
+        this.#idFactory = options.idFactory ?? randomUUID;
+    }
+    async initialize() {
+        await mkdir(this.#root, { recursive: true, mode: 0o700 });
+        const files = (await readdir(this.#root, { withFileTypes: true }))
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".jsonl"))
+            .map((entry) => join(this.#root, entry.name))
+            .sort();
+        for (const path of files) {
+            const values = await readJsonLinesRecovering(path, this.#recoveryDirectory, this.#idFactory);
+            for (const value of values) {
+                if (!isRunRecord(value))
+                    throw new Error(`Invalid run record in ${path}`);
+                const previous = this.#runs.get(value.id);
+                if (!previous || value.revision > previous.revision)
+                    this.#runs.set(value.id, value);
+            }
+        }
+        for (const record of this.#runs.values())
+            this.#slots.set(record.slotKey, record.id);
+        const recoveredUnknown = [];
+        for (const record of this.list()) {
+            if (record.status !== "running")
+                continue;
+            recoveredUnknown.push(await this.transition(record.id, {
+                status: "unknown",
+                finishedAt: this.#clock().toISOString(),
+                reason: "daemon restarted while external side effects may have been in flight",
+            }));
+        }
+        return { recoveredUnknown, queued: this.list().filter((record) => record.status === "queued") };
+    }
+    claim(spec) {
+        return this.#serialize(async () => {
+            const existingId = this.#slots.get(spec.slotKey);
+            if (existingId) {
+                const existing = this.#runs.get(existingId);
+                if (!existing)
+                    throw new Error(`Run ledger slot points to missing run: ${spec.slotKey}`);
+                return { claimed: false, record: structuredClone(existing) };
+            }
+            const record = {
+                version: 1,
+                revision: 1,
+                id: this.#idFactory(),
+                ...structuredClone(spec),
+                status: "queued",
+            };
+            await this.#append(record);
+            this.#runs.set(record.id, record);
+            this.#slots.set(record.slotKey, record.id);
+            return { claimed: true, record: structuredClone(record) };
+        });
+    }
+    transition(id, patch) {
+        return this.#serialize(async () => {
+            const current = this.#runs.get(id);
+            if (!current)
+                throw new Error(`Unknown run: ${id}`);
+            assertTransition(current.status, patch.status);
+            const next = { ...current, ...structuredClone(patch), revision: current.revision + 1 };
+            await this.#append(next);
+            this.#runs.set(id, next);
+            return structuredClone(next);
+        });
+    }
+    get(id) {
+        const record = this.#runs.get(id);
+        return record ? structuredClone(record) : undefined;
+    }
+    findSlot(slotKey) {
+        const id = this.#slots.get(slotKey);
+        return id ? this.get(id) : undefined;
+    }
+    latestForJob(jobId) {
+        return this.list()
+            .filter((record) => record.jobId === jobId)
+            .sort((left, right) => right.scheduledFor.localeCompare(left.scheduledFor))[0];
+    }
+    list() {
+        return [...this.#runs.values()]
+            .sort((left, right) => left.receivedAt.localeCompare(right.receivedAt) || left.id.localeCompare(right.id))
+            .map((record) => structuredClone(record));
+    }
+    async #append(record) {
+        const date = new Date(record.scheduledFor);
+        if (Number.isNaN(date.getTime()))
+            throw new Error(`Invalid scheduledFor timestamp: ${record.scheduledFor}`);
+        const file = join(this.#root, `${date.getUTCFullYear()}-${String(date.getUTCMonth() + 1).padStart(2, "0")}.jsonl`);
+        await appendJsonLine(file, record, 0o600);
+    }
+    #serialize(operation) {
+        const result = this.#tail.then(operation, operation);
+        this.#tail = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+function assertTransition(from, to) {
+    if (TERMINAL.has(from))
+        throw new Error(`Run is already terminal: ${from}`);
+    if (from === "queued" && to !== "running" && !TERMINAL.has(to))
+        throw new Error(`Invalid run transition: ${from} -> ${to}`);
+    if (from === "running" && !TERMINAL.has(to))
+        throw new Error(`Invalid run transition: ${from} -> ${to}`);
+}
+function isRunRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const record = value;
+    return (record["version"] === 1 &&
+        typeof record["revision"] === "number" &&
+        typeof record["id"] === "string" &&
+        typeof record["slotKey"] === "string" &&
+        typeof record["source"] === "string" &&
+        typeof record["scheduledFor"] === "string" &&
+        typeof record["receivedAt"] === "string" &&
+        typeof record["objective"] === "string" &&
+        typeof record["status"] === "string" &&
+        typeof record["activity"] === "object" &&
+        record["activity"] !== null);
+}
+//# sourceMappingURL=run-ledger.js.map

package/dist/automation/run-ledger.js.map

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

package/dist/automation/scheduler.d.ts

@@ -0,0 +1,36 @@
+import type { JobStore } from "./job-store.js";
+import type { RunLedger } from "./run-ledger.js";
+import type { JobDefinition, RunRecord, RunTriggerSpec } from "./types.js";
+export interface RunExecutionResult {
+    status: "succeeded" | "blocked" | "budget_exhausted";
+    reason?: string;
+}
+export interface RunExecutor {
+    execute(run: RunRecord, signal: AbortSignal): Promise<RunExecutionResult>;
+}
+export interface SchedulerOptions {
+    jobs: Pick<JobStore, "loadAll" | "put">;
+    ledger: RunLedger;
+    executor: RunExecutor;
+    maxConcurrentRuns: number;
+    replaceGraceMs?: number;
+    clock?: () => Date;
+    onRun?: (run: RunRecord) => void;
+    deliverRun?: (run: RunRecord) => Promise<void>;
+    onError?: (error: Error) => void;
+}
+export declare class Scheduler {
+    #private;
+    constructor(options: SchedulerOptions);
+    initialize(): Promise<void>;
+    start(): Promise<void>;
+    applyMisfires(now: Date): Promise<void>;
+    triggerJob(jobId: string, scheduledFor: Date, source?: "cron" | "recovery" | "user"): Promise<RunRecord>;
+    trigger(spec: RunTriggerSpec): Promise<RunRecord>;
+    cancel(runId: string, reason?: string): Promise<RunRecord>;
+    listRuns(): RunRecord[];
+    listJobs(): JobDefinition[];
+    putJob(value: unknown, expectedSha256: string | null): Promise<JobDefinition>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/automation/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/automation/scheduler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAa,cAAc,EAAE,MAAM,YAAY,CAAC;AAEtF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,kBAAkB,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC;IACxC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAQD,qBAAa,SAAS;;gBASR,OAAO,EAAE,gBAAgB;IAI/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,aAAa,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAE,MAAM,GAAG,UAAU,GAAG,MAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAMhH,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IASjD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAsB,GAAG,OAAO,CAAC,SAAS,CAAC;IAmB7E,QAAQ,IAAI,SAAS,EAAE;IAIvB,QAAQ,IAAI,aAAa,EAAE;IAIrB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAW7E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAwI5B"}