daemora 1.0.0-alpha.0

package/dist/crew/CrewRegistry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CrewRegistry — in-memory lookup for loaded crews. The host never
+ * builds or spawns crews directly; it looks them up here, then hands
+ * off to CrewAgentRunner for execution.
+ *
+ * Crews can come from two sources:
+ *   - Filesystem: scanned at startup by CrewLoader.
+ *   - Runtime: integrations register their crew when the user connects
+ *     the integration, then unregister on disconnect. The "change"
+ *     event lets AgentLoop invalidate its cached system prompt so the
+ *     main agent's `use_crew` list stays in sync.
+ */
+import { EventEmitter } from "node:events";
+import type { LoadedCrew } from "./types.js";
+export declare class CrewRegistry extends EventEmitter {
+    private readonly byId;
+    constructor(crews: readonly LoadedCrew[]);
+    /** Add or replace a crew at runtime. Fires "change". */
+    register(crew: LoadedCrew): void;
+    /** Remove a crew at runtime. No-op if not present. Fires "change" when it was. */
+    unregister(id: string): boolean;
+    get size(): number;
+    has(id: string): boolean;
+    get(id: string): LoadedCrew;
+    tryGet(id: string): LoadedCrew | undefined;
+    list(): readonly LoadedCrew[];
+    /** Compact one-liner list the main agent's system prompt can render. */
+    summaryLines(): readonly string[];
+}
+//# sourceMappingURL=CrewRegistry.d.ts.map

package/dist/crew/CrewRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrewRegistry.d.ts","sourceRoot":"","sources":["../../src/crew/CrewRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;gBAEnC,KAAK,EAAE,SAAS,UAAU,EAAE;IAKxC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAKhC,kFAAkF;IAClF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAM/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU;IAM3B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI1C,IAAI,IAAI,SAAS,UAAU,EAAE;IAI7B,wEAAwE;IACxE,YAAY,IAAI,SAAS,MAAM,EAAE;CAGlC"}

package/dist/crew/CrewRegistry.js

@@ -0,0 +1,56 @@
+/**
+ * CrewRegistry — in-memory lookup for loaded crews. The host never
+ * builds or spawns crews directly; it looks them up here, then hands
+ * off to CrewAgentRunner for execution.
+ *
+ * Crews can come from two sources:
+ *   - Filesystem: scanned at startup by CrewLoader.
+ *   - Runtime: integrations register their crew when the user connects
+ *     the integration, then unregister on disconnect. The "change"
+ *     event lets AgentLoop invalidate its cached system prompt so the
+ *     main agent's `use_crew` list stays in sync.
+ */
+import { EventEmitter } from "node:events";
+import { NotFoundError } from "../util/errors.js";
+export class CrewRegistry extends EventEmitter {
+    byId;
+    constructor(crews) {
+        super();
+        this.byId = new Map(crews.map((c) => [c.manifest.id, c]));
+    }
+    /** Add or replace a crew at runtime. Fires "change". */
+    register(crew) {
+        this.byId.set(crew.manifest.id, crew);
+        this.emit("change", { op: "register", id: crew.manifest.id });
+    }
+    /** Remove a crew at runtime. No-op if not present. Fires "change" when it was. */
+    unregister(id) {
+        const existed = this.byId.delete(id);
+        if (existed)
+            this.emit("change", { op: "unregister", id });
+        return existed;
+    }
+    get size() {
+        return this.byId.size;
+    }
+    has(id) {
+        return this.byId.has(id);
+    }
+    get(id) {
+        const c = this.byId.get(id);
+        if (!c)
+            throw new NotFoundError(`Crew not found: ${id}`, { knownCrews: Array.from(this.byId.keys()) });
+        return c;
+    }
+    tryGet(id) {
+        return this.byId.get(id);
+    }
+    list() {
+        return Array.from(this.byId.values());
+    }
+    /** Compact one-liner list the main agent's system prompt can render. */
+    summaryLines() {
+        return this.list().map((c) => `- ${c.manifest.id}: ${c.manifest.description}`);
+    }
+}
+//# sourceMappingURL=CrewRegistry.js.map

package/dist/crew/CrewRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrewRegistry.js","sourceRoot":"","sources":["../../src/crew/CrewRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,OAAO,YAAa,SAAQ,YAAY;IAC3B,IAAI,CAA0B;IAE/C,YAAY,KAA4B;QACtC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,wDAAwD;IACxD,QAAQ,CAAC,IAAgB;QACvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,kFAAkF;IAClF,UAAU,CAAC,EAAU;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3D,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,aAAa,CAAC,mBAAmB,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACvG,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,wEAAwE;IACxE,YAAY;QACV,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACjF,CAAC;CACF"}

package/dist/crew/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Crew — a named specialist sub-agent. The main agent delegates work
+ * via `useCrew(crewId, task)`; each crew runs its own AgentLoop with
+ * a scoped tool allowlist and persona system prompt.
+ *
+ * Crew manifests live under `<project>/crew/<id>/plugin.json`. The
+ * schema below is the single source of truth — everything else (loader,
+ * registry, runner) treats manifests as opaque post-validation.
+ */
+import { z } from "zod";
+export declare const crewManifestSchema: z.ZodObject<{
+    /** Stable id. Kebab or snake case. Used in useCrew(crewId, …). */
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodDefault<z.ZodString>;
+    profile: z.ZodObject<{
+        systemPrompt: z.ZodString;
+        /** 0-2. Lower = more deterministic. */
+        temperature: z.ZodDefault<z.ZodNumber>;
+        /** Optional model override; falls back to the caller's resolved model. */
+        model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        systemPrompt: string;
+        temperature: number;
+        model?: string | null | undefined;
+    }, {
+        systemPrompt: string;
+        model?: string | null | undefined;
+        temperature?: number | undefined;
+    }>;
+    /**
+     * Tool allowlist. Names must match registered tool names in the
+     * ToolRegistry. Names missing from the registry are dropped at load
+     * time with a warning — keeps the manifest declarative even as the
+     * available-tools set evolves.
+     */
+    tools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Skill IDs this crew specialises in. Empty = inherit all skills. */
+    skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Skill IDs explicitly excluded from this crew's context. */
+    skillsExclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    description: string;
+    id: string;
+    name: string;
+    profile: {
+        systemPrompt: string;
+        temperature: number;
+        model?: string | null | undefined;
+    };
+    tools: string[];
+    skills: string[];
+    skillsExclude: string[];
+}, {
+    description: string;
+    id: string;
+    name: string;
+    profile: {
+        systemPrompt: string;
+        model?: string | null | undefined;
+        temperature?: number | undefined;
+    };
+    version?: string | undefined;
+    tools?: string[] | undefined;
+    skills?: string[] | undefined;
+    skillsExclude?: string[] | undefined;
+}>;
+export type CrewManifest = z.infer<typeof crewManifestSchema>;
+export interface LoadedCrew {
+    readonly manifest: CrewManifest;
+    readonly dir: string;
+    /** Tool names resolved to the ToolRegistry — always a subset of manifest.tools. */
+    readonly resolvedTools: readonly string[];
+    /** Names the manifest asked for that didn't exist — logged, not fatal. */
+    readonly droppedTools: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/crew/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;IAC7B,kEAAkE;;;;;;;QAOhE,uCAAuC;;QAEvC,0EAA0E;;;;;;;;;;;IAG5E;;;;;OAKG;;IAEH,sEAAsE;;IAEtE,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9D,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C"}

package/dist/crew/types.js

@@ -0,0 +1,36 @@
+/**
+ * Crew — a named specialist sub-agent. The main agent delegates work
+ * via `useCrew(crewId, task)`; each crew runs its own AgentLoop with
+ * a scoped tool allowlist and persona system prompt.
+ *
+ * Crew manifests live under `<project>/crew/<id>/plugin.json`. The
+ * schema below is the single source of truth — everything else (loader,
+ * registry, runner) treats manifests as opaque post-validation.
+ */
+import { z } from "zod";
+export const crewManifestSchema = z.object({
+    /** Stable id. Kebab or snake case. Used in useCrew(crewId, …). */
+    id: z.string().regex(/^[a-z0-9][a-z0-9_-]*$/, "id must be kebab/snake-case"),
+    name: z.string().min(1).max(80),
+    description: z.string().min(1).max(2000).describe("Shown to the main agent for delegation decisions."),
+    version: z.string().default("1.0.0"),
+    profile: z.object({
+        systemPrompt: z.string().min(10),
+        /** 0-2. Lower = more deterministic. */
+        temperature: z.number().min(0).max(2).default(0.3),
+        /** Optional model override; falls back to the caller's resolved model. */
+        model: z.string().nullable().optional(),
+    }),
+    /**
+     * Tool allowlist. Names must match registered tool names in the
+     * ToolRegistry. Names missing from the registry are dropped at load
+     * time with a warning — keeps the manifest declarative even as the
+     * available-tools set evolves.
+     */
+    tools: z.array(z.string()).default([]),
+    /** Skill IDs this crew specialises in. Empty = inherit all skills. */
+    skills: z.array(z.string()).default([]),
+    /** Skill IDs explicitly excluded from this crew's context. */
+    skillsExclude: z.array(z.string()).default([]),
+});
+//# sourceMappingURL=types.js.map

package/dist/crew/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/crew/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,kEAAkE;IAClE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,EAAE,6BAA6B,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACtG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,uCAAuC;QACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QAClD,0EAA0E;QAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KACxC,CAAC;IACF;;;;;OAKG;IACH,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,sEAAsE;IACtE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACvC,8DAA8D;IAC9D,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC/C,CAAC,CAAC"}

package/dist/cron/CronScheduler.d.ts

@@ -0,0 +1,40 @@
+/**
+ * CronScheduler — in-memory timer that polls CronStore every 30 s
+ * for due jobs and fires a callback for each.
+ *
+ * Lifecycle:
+ *   const sched = new CronScheduler(store, async (job) => { ... });
+ *   sched.start();
+ *   // later
+ *   sched.stop();
+ *
+ * The callback receives the CronJob and is responsible for execution.
+ * CronScheduler records runs (started / success / error) automatically.
+ */
+import { CronStore, type CronJob } from "./CronStore.js";
+export type CronCallback = (job: CronJob) => Promise<string | void>;
+export declare class CronScheduler {
+    private readonly store;
+    private readonly onDue;
+    private timer;
+    private running;
+    /** Track in-flight jobs to avoid double-firing within the same tick. */
+    private readonly inflight;
+    constructor(store: CronStore, onDue: CronCallback);
+    /** Start the polling loop. Idempotent. */
+    start(): void;
+    /** Stop the polling loop. In-flight jobs are awaited on the next tick. */
+    stop(): void;
+    get isRunning(): boolean;
+    /** Number of jobs currently executing. Useful for status tooling. */
+    get inflightCount(): number;
+    /**
+     * Run a specific job now, out-of-band with the normal tick.
+     * Used by the `cron` tool's `run` action. Respects in-flight
+     * tracking so it can't double-fire alongside the polling loop.
+     */
+    forceRun(jobId: string): Promise<void>;
+    private tick;
+    private execute;
+}
+//# sourceMappingURL=CronScheduler.d.ts.map

package/dist/cron/CronScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CronScheduler.d.ts","sourceRoot":"","sources":["../../src/cron/CronScheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAMzD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAEpE,qBAAa,aAAa;IAOtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAPxB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;IACxB,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAG3B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,YAAY;IAGtC,0CAA0C;IAC1C,KAAK,IAAI,IAAI;IAeb,0EAA0E;IAC1E,IAAI,IAAI,IAAI;IAQZ,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,qEAAqE;IACrE,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;OAIG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAW9B,IAAI;YA0BJ,OAAO;CA2BtB"}

package/dist/cron/CronScheduler.js

@@ -0,0 +1,119 @@
+/**
+ * CronScheduler — in-memory timer that polls CronStore every 30 s
+ * for due jobs and fires a callback for each.
+ *
+ * Lifecycle:
+ *   const sched = new CronScheduler(store, async (job) => { ... });
+ *   sched.start();
+ *   // later
+ *   sched.stop();
+ *
+ * The callback receives the CronJob and is responsible for execution.
+ * CronScheduler records runs (started / success / error) automatically.
+ */
+import { createLogger } from "../util/logger.js";
+const log = createLogger("cron-scheduler");
+const TICK_INTERVAL_MS = 30_000;
+export class CronScheduler {
+    store;
+    onDue;
+    timer = null;
+    running = false;
+    /** Track in-flight jobs to avoid double-firing within the same tick. */
+    inflight = new Set();
+    constructor(store, onDue) {
+        this.store = store;
+        this.onDue = onDue;
+    }
+    /** Start the polling loop. Idempotent. */
+    start() {
+        if (this.timer)
+            return;
+        this.running = true;
+        log.info({ intervalMs: TICK_INTERVAL_MS }, "scheduler started");
+        // Fire immediately on start, then every TICK_INTERVAL_MS.
+        void this.tick();
+        this.timer = setInterval(() => void this.tick(), TICK_INTERVAL_MS);
+        // Don't keep the process alive just for cron.
+        if (typeof this.timer === "object" && "unref" in this.timer) {
+            this.timer.unref();
+        }
+    }
+    /** Stop the polling loop. In-flight jobs are awaited on the next tick. */
+    stop() {
+        if (!this.timer)
+            return;
+        clearInterval(this.timer);
+        this.timer = null;
+        this.running = false;
+        log.info("scheduler stopped");
+    }
+    get isRunning() {
+        return this.running;
+    }
+    /** Number of jobs currently executing. Useful for status tooling. */
+    get inflightCount() {
+        return this.inflight.size;
+    }
+    /**
+     * Run a specific job now, out-of-band with the normal tick.
+     * Used by the `cron` tool's `run` action. Respects in-flight
+     * tracking so it can't double-fire alongside the polling loop.
+     */
+    async forceRun(jobId) {
+        const job = this.store.getJob(jobId);
+        if (!job)
+            throw new Error(`Cron job not found: ${jobId}`);
+        if (this.inflight.has(jobId)) {
+            throw new Error(`Cron job ${jobId} is already running`);
+        }
+        await this.execute(job);
+    }
+    // ── Internal ────────────────────────────────────────────────────
+    async tick() {
+        if (!this.running)
+            return;
+        const now = Date.now();
+        let dueJobs;
+        try {
+            dueJobs = this.store.dueJobs(now);
+        }
+        catch (err) {
+            log.error({ err }, "failed to query due jobs");
+            return;
+        }
+        if (dueJobs.length === 0)
+            return;
+        log.debug({ count: dueJobs.length }, "due jobs found");
+        for (const job of dueJobs) {
+            // Skip if already executing from a previous tick.
+            if (this.inflight.has(job.id)) {
+                log.debug({ jobId: job.id }, "skipping — still in-flight");
+                continue;
+            }
+            void this.execute(job);
+        }
+    }
+    async execute(job) {
+        this.inflight.add(job.id);
+        const runStart = Date.now();
+        log.info({ jobId: job.id, name: job.name }, "executing cron job");
+        // Record a "running" entry so the UI can show in-progress state.
+        this.store.recordRun(job.id, "running");
+        try {
+            const result = await this.onDue(job);
+            const resultStr = result ?? "ok";
+            this.store.recordRun(job.id, "success", resultStr);
+            log.info({ jobId: job.id, name: job.name, durationMs: Date.now() - runStart }, "cron job completed");
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            this.store.recordRun(job.id, "error", undefined, errorMsg);
+            log.error({ jobId: job.id, name: job.name, err, durationMs: Date.now() - runStart }, "cron job failed");
+        }
+        finally {
+            this.inflight.delete(job.id);
+        }
+    }
+}
+//# sourceMappingURL=CronScheduler.js.map

package/dist/cron/CronScheduler.js.map

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

package/dist/cron/CronStore.d.ts

@@ -0,0 +1,73 @@
+/**
+ * CronStore — SQLite-backed cron job persistence.
+ *
+ * Stores job definitions and run history. The actual scheduling loop
+ * lives in CronScheduler, which consumes this store.
+ *
+ * Tables:
+ *   cron_jobs  — job definitions (expression, task, timezone, etc.)
+ *   cron_runs  — execution log per job (status, result, error)
+ */
+import type Database from "better-sqlite3";
+export interface CronJob {
+    readonly id: string;
+    readonly name: string;
+    readonly expression: string;
+    readonly task: string;
+    readonly enabled: boolean;
+    readonly timezone: string;
+    readonly delivery: Record<string, unknown> | null;
+    readonly lastRunAt: number | null;
+    readonly nextRunAt: number | null;
+    readonly createdAt: number;
+}
+export interface CronRun {
+    readonly id: string;
+    readonly jobId: string;
+    readonly startedAt: number;
+    readonly completedAt: number | null;
+    readonly status: "success" | "error" | "running";
+    readonly result: string | null;
+    readonly error: string | null;
+}
+export interface AddJobOpts {
+    readonly name: string;
+    readonly expression: string;
+    readonly task: string;
+    readonly enabled?: boolean;
+    readonly timezone?: string;
+    readonly delivery?: Record<string, unknown>;
+}
+export interface UpdateJobOpts {
+    readonly name?: string;
+    readonly expression?: string;
+    readonly task?: string;
+    readonly enabled?: boolean;
+    readonly timezone?: string;
+    readonly delivery?: Record<string, unknown> | null;
+}
+export declare class CronStore {
+    private readonly db;
+    private readonly stmts;
+    constructor(db: Database.Database);
+    addJob(opts: AddJobOpts): CronJob;
+    listJobs(): readonly CronJob[];
+    getJob(id: string): CronJob | undefined;
+    updateJob(id: string, updates: UpdateJobOpts): CronJob;
+    deleteJob(id: string): boolean;
+    getJobRuns(jobId: string, limit?: number): readonly CronRun[];
+    recordRun(jobId: string, status: CronRun["status"], result?: string, error?: string): CronRun;
+    /**
+     * Recent runs for a given job, newest first. Used by Heartbeat to
+     * detect consecutive-error patterns that suggest a broken job.
+     */
+    listRuns(jobId: string, limit?: number): readonly CronRun[];
+    /**
+     * Return all enabled jobs whose next_run_at <= the given epoch.
+     * CronScheduler calls this every tick.
+     */
+    dueJobs(now: number): readonly CronJob[];
+    private createTables;
+    private prepareStatements;
+}
+//# sourceMappingURL=CronStore.d.ts.map

package/dist/cron/CronStore.d.ts.map

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