p-spore 0.1.0

package/dist/automation/scheduler.js

@@ -0,0 +1,300 @@
+import { Cron } from "croner";
+export class Scheduler {
+    #options;
+    #jobs = new Map();
+    #crons = new Map();
+    #active = new Map();
+    #initialized = false;
+    #started = false;
+    #stopping = false;
+    constructor(options) {
+        this.#options = options;
+    }
+    async initialize() {
+        if (this.#initialized)
+            return;
+        const recovery = await this.#options.ledger.initialize();
+        for (const run of recovery.recoveredUnknown) {
+            this.#publish(run);
+            await this.#deliver(run);
+        }
+        const jobs = await this.#options.jobs.loadAll();
+        for (const job of jobs) {
+            if (this.#jobs.has(job.id))
+                throw new Error(`Duplicate job id: ${job.id}`);
+            this.#jobs.set(job.id, job);
+        }
+        this.#initialized = true;
+    }
+    async start() {
+        await this.initialize();
+        if (this.#started)
+            return;
+        this.#started = true;
+        for (const queued of this.#options.ledger.list().filter((run) => run.status === "queued")) {
+            void this.#launch(queued).catch((error) => this.#error(error));
+        }
+        for (const job of this.#jobs.values()) {
+            this.#scheduleJob(job);
+        }
+        void this.applyMisfires(this.#clock()).catch((error) => this.#error(error));
+    }
+    async applyMisfires(now) {
+        for (const job of this.#jobs.values()) {
+            if (!job.enabled)
+                continue;
+            const latest = this.#options.ledger.latestForJob(job.id);
+            if (!latest)
+                continue;
+            const cron = new Cron(job.schedule.cron, {
+                timezone: job.schedule.timezone,
+                mode: "5-part",
+                paused: true,
+            });
+            let previous;
+            try {
+                previous = cron.previousRuns(1, now)[0];
+            }
+            finally {
+                cron.stop();
+            }
+            if (!previous || previous.toISOString() <= latest.scheduledFor || previous.getTime() >= now.getTime())
+                continue;
+            if (job.misfire === "run_once") {
+                await this.triggerJob(job.id, previous, "recovery");
+            }
+            else {
+                const claim = await this.#options.ledger.claim(toTrigger(job, previous, now, "recovery"));
+                if (claim.claimed) {
+                    this.#publish(claim.record);
+                    const skipped = await this.#options.ledger.transition(claim.record.id, {
+                        status: "skipped",
+                        finishedAt: now.toISOString(),
+                        reason: "misfire policy is skip",
+                    });
+                    this.#publish(skipped);
+                    await this.#deliver(skipped);
+                }
+            }
+        }
+    }
+    async triggerJob(jobId, scheduledFor, source = "cron") {
+        const job = this.#jobs.get(jobId);
+        if (!job)
+            throw new Error(`Unknown job: ${jobId}`);
+        return this.trigger(toTrigger(job, scheduledFor, this.#clock(), source));
+    }
+    async trigger(spec) {
+        if (!this.#initialized)
+            throw new Error("Scheduler is not initialized");
+        if (this.#stopping)
+            throw new Error("Scheduler is stopping");
+        const claim = await this.#options.ledger.claim(spec);
+        if (!claim.claimed)
+            return claim.record;
+        this.#publish(claim.record);
+        return this.#launch(claim.record);
+    }
+    async cancel(runId, reason = "cancelled by user") {
+        const active = this.#active.get(runId);
+        if (active) {
+            active.controller.abort(new Error(reason));
+            return active.completion;
+        }
+        const record = this.#options.ledger.get(runId);
+        if (!record)
+            throw new Error(`Unknown run: ${runId}`);
+        if (record.status !== "queued")
+            return record;
+        const cancelled = await this.#options.ledger.transition(runId, {
+            status: "cancelled",
+            finishedAt: this.#clock().toISOString(),
+            reason,
+        });
+        this.#publish(cancelled);
+        await this.#deliver(cancelled);
+        return cancelled;
+    }
+    listRuns() {
+        return this.#options.ledger.list();
+    }
+    listJobs() {
+        return [...this.#jobs.values()].map((job) => structuredClone(job));
+    }
+    async putJob(value, expectedSha256) {
+        if (!this.#initialized)
+            throw new Error("Scheduler is not initialized");
+        if (this.#stopping)
+            throw new Error("Scheduler is stopping");
+        const job = await this.#options.jobs.put(value, expectedSha256);
+        this.#jobs.set(job.id, job);
+        this.#crons.get(job.id)?.stop();
+        this.#crons.delete(job.id);
+        if (this.#started)
+            this.#scheduleJob(job);
+        return structuredClone(job);
+    }
+    async stop() {
+        if (this.#stopping) {
+            await Promise.allSettled([...this.#active.values()].map((active) => active.completion));
+            return;
+        }
+        this.#stopping = true;
+        for (const cron of this.#crons.values())
+            cron.stop();
+        this.#crons.clear();
+        for (const active of this.#active.values())
+            active.controller.abort(new Error("scheduler shutdown"));
+        await Promise.allSettled([...this.#active.values()].map((active) => active.completion));
+    }
+    async #launch(record) {
+        const jobKey = record.jobId ?? record.slotKey;
+        const sameJob = [...this.#active.values()].filter((active) => (active.record.jobId ?? active.record.slotKey) === jobKey);
+        if (record.concurrency === "forbid" && sameJob.length > 0) {
+            return this.#skip(record, "concurrency policy forbid: another run is active");
+        }
+        if (record.concurrency === "replace" && sameJob.length > 0) {
+            for (const active of sameJob)
+                active.controller.abort(new Error(`replaced by run ${record.id}`));
+            const settled = await settlesWithin(Promise.allSettled(sameJob.map((active) => active.completion)), this.#options.replaceGraceMs ?? 5_000);
+            if (!settled)
+                return this.#skip(record, "replace cancellation did not settle before grace deadline");
+        }
+        if (this.#active.size >= this.#options.maxConcurrentRuns) {
+            return this.#skip(record, "global scheduler concurrency budget exhausted");
+        }
+        const running = await this.#options.ledger.transition(record.id, {
+            status: "running",
+            startedAt: this.#clock().toISOString(),
+        });
+        this.#publish(running);
+        const controller = new AbortController();
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            controller.abort(new Error(`run timeout after ${running.timeoutMs}ms`));
+        }, running.timeoutMs);
+        let completion;
+        completion = this.#execute(running, controller.signal, () => timedOut).finally(() => {
+            clearTimeout(timer);
+            const current = this.#active.get(running.id);
+            if (current?.completion === completion)
+                this.#active.delete(running.id);
+        });
+        this.#active.set(running.id, { record: running, controller, completion });
+        return completion;
+    }
+    async #execute(running, signal, timedOut) {
+        let status;
+        let reason;
+        let errorMessage;
+        try {
+            const result = await this.#options.executor.execute(running, signal);
+            status = result.status;
+            reason = result.reason;
+        }
+        catch (error) {
+            const normalized = toError(error);
+            if (signal.aborted) {
+                status = timedOut() ? "budget_exhausted" : "cancelled";
+                reason = normalized.message;
+            }
+            else {
+                status = "failed";
+                errorMessage = normalized.message;
+            }
+        }
+        const finished = await this.#options.ledger.transition(running.id, {
+            status,
+            finishedAt: this.#clock().toISOString(),
+            ...(reason === undefined ? {} : { reason }),
+            ...(errorMessage === undefined ? {} : { error: errorMessage }),
+        });
+        this.#publish(finished);
+        await this.#deliver(finished);
+        return finished;
+    }
+    async #skip(record, reason) {
+        const skipped = await this.#options.ledger.transition(record.id, {
+            status: "skipped",
+            finishedAt: this.#clock().toISOString(),
+            reason,
+        });
+        this.#publish(skipped);
+        await this.#deliver(skipped);
+        return skipped;
+    }
+    #publish(run) {
+        try {
+            this.#options.onRun?.(structuredClone(run));
+        }
+        catch {
+            // Observability cannot change run execution or ledger state.
+        }
+    }
+    #scheduleJob(job) {
+        if (!job.enabled)
+            return;
+        const cron = new Cron(job.schedule.cron, {
+            timezone: job.schedule.timezone,
+            mode: "5-part",
+            unref: true,
+            catch: (error) => this.#error(error),
+        }, async (self) => {
+            const scheduledFor = self.currentRun() ?? this.#clock();
+            await this.triggerJob(job.id, scheduledFor, "cron");
+        });
+        this.#crons.set(job.id, cron);
+    }
+    #error(error) {
+        try {
+            this.#options.onError?.(toError(error));
+        }
+        catch {
+            // Cron callback errors are already isolated from scheduling.
+        }
+    }
+    async #deliver(run) {
+        try {
+            await this.#options.deliverRun?.(structuredClone(run));
+        }
+        catch (error) {
+            this.#error(error);
+        }
+    }
+    #clock() {
+        return (this.#options.clock ?? (() => new Date()))();
+    }
+}
+function toTrigger(job, scheduledFor, receivedAt, source) {
+    const scheduled = scheduledFor.toISOString();
+    return {
+        slotKey: `${source === "user" ? "user" : "cron"}:${job.id}:${scheduled}`,
+        source,
+        jobId: job.id,
+        scheduledFor: scheduled,
+        receivedAt: receivedAt.toISOString(),
+        objective: job.activity.kind === "agent" ? job.activity.prompt : `Run scheduled command for job ${job.id}`,
+        activity: structuredClone(job.activity),
+        policyRef: job.policyRef,
+        concurrency: job.concurrency,
+        timeoutMs: job.timeoutMs,
+        budget: structuredClone(job.budget),
+        delivery: structuredClone(job.delivery),
+    };
+}
+async function settlesWithin(task, timeoutMs) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(false), timeoutMs);
+        timer.unref();
+    });
+    const result = await Promise.race([task.then(() => true), timeout]);
+    if (timer)
+        clearTimeout(timer);
+    return result;
+}
+function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/automation/scheduler.js.map

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

package/dist/automation/types.d.ts

@@ -0,0 +1,81 @@
+export interface RunBudget {
+    maxTurns: number;
+    maxToolCalls: number;
+    maxInputTokens: number;
+    maxOutputTokens: number;
+    maxChildren: number;
+    maxCostUsd?: number;
+}
+export type DeliveryTarget = {
+    kind: "session";
+    sessionId: string;
+} | {
+    kind: "local-notification";
+} | {
+    kind: "none";
+};
+export type RunActivity = {
+    kind: "agent";
+    prompt: string;
+    cwd: string;
+} | {
+    kind: "command";
+    command: string;
+    cwd: string;
+};
+export interface JobDefinition {
+    version: 1;
+    id: string;
+    enabled: boolean;
+    schedule: {
+        cron: string;
+        timezone: string;
+    };
+    policyRef: string;
+    concurrency: "forbid" | "replace" | "allow";
+    misfire: "skip" | "run_once";
+    timeoutMs: number;
+    budget: RunBudget;
+    delivery: DeliveryTarget;
+    activity: RunActivity;
+    sourceSha256?: string;
+}
+export type RunSource = "user" | "boot" | "cron" | "recovery";
+export type RunStatus = "queued" | "running" | "succeeded" | "failed" | "blocked" | "cancelled" | "budget_exhausted" | "unknown" | "skipped";
+export interface RunRecord {
+    version: 1;
+    revision: number;
+    id: string;
+    slotKey: string;
+    source: RunSource;
+    jobId?: string;
+    scheduledFor: string;
+    receivedAt: string;
+    objective: string;
+    activity: RunActivity;
+    policyRef: string;
+    concurrency: JobDefinition["concurrency"];
+    timeoutMs: number;
+    budget: RunBudget;
+    delivery: DeliveryTarget;
+    status: RunStatus;
+    startedAt?: string;
+    finishedAt?: string;
+    reason?: string;
+    error?: string;
+}
+export interface RunTriggerSpec {
+    slotKey: string;
+    source: RunSource;
+    jobId?: string;
+    scheduledFor: string;
+    receivedAt: string;
+    objective: string;
+    activity: RunActivity;
+    policyRef: string;
+    concurrency: JobDefinition["concurrency"];
+    timeoutMs: number;
+    budget: RunBudget;
+    delivery: DeliveryTarget;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/automation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/automation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/automation/types.ts"],"names":[],"mappings":""}

package/dist/cli/main.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+export declare function runCli(argv?: string[]): Promise<number>;
+export declare function isEntrypoint(argvPath: string | undefined, moduleUrl: string): boolean;
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAkCA,wBAAsB,MAAM,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsF1E;AAymBD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAOrF"}