@spinabot/brigade 0.1.1 → 1.0.0

package/dist/cron/service/ops.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Public API for the Brigade cron service.
+ *
+ * Everything CLI commands, the agent-callable `cron` tool, and gateway RPC
+ * handlers depend on goes through this file. Each public function:
+ *   - Holds the per-instance lock (`withPerInstanceLock`) for any mutation.
+ *   - Reloads the store from disk before deciding what to write, so a
+ *     concurrent edit by another process can't be silently clobbered.
+ *   - Emits a lifecycle event (added/updated/removed) on changes.
+ *   - Persists synchronously inside the lock, so callers can rely on the
+ *     write being durable before the function resolves.
+ *
+ * Two execution modes:
+ *   - `run(state, id, mode)` — INLINE execution, returns the outcome.
+ *   - `enqueueRun(state, id, mode)` — QUEUED for the next tick; returns
+ *     immediately. Useful when the caller doesn't want to block (RPC
+ *     handlers, the agent tool).
+ */
+import { computeJobNextRunAtMs } from "./jobs.js";
+import { type ReadCronRunLogOpts } from "../run-log.js";
+import type { CronJob, CronJobCreate, CronJobPatch, CronRunLogEntry, CronWakeMode } from "../types.js";
+import type { CronServiceState } from "./state.js";
+/** Boot the scheduler — load store, replay missed runs (bounded), arm timer. */
+export declare function start(state: CronServiceState): Promise<void>;
+/** Disarm the timer. In-flight jobs continue to completion. */
+export declare function stop(state: CronServiceState): void;
+/** Read-only diagnostic snapshot. */
+export interface CronServiceStatus {
+    enabled: boolean;
+    storePath: string;
+    jobCount: number;
+    enabledJobCount: number;
+    runningJobCount: number;
+    nextWakeAtMs: number | undefined;
+}
+export declare function status(state: CronServiceState): Promise<CronServiceStatus>;
+export interface ListJobsOpts {
+    includeDisabled?: boolean;
+}
+/** Simple list. For pagination/filtering use `listPage`. */
+export declare function list(state: CronServiceState, opts?: ListJobsOpts): Promise<CronJob[]>;
+export interface ListPageOpts {
+    limit?: number;
+    offset?: number;
+    query?: string;
+    enabled?: "all" | "enabled" | "disabled";
+    sortBy?: "nextRunAtMs" | "updatedAtMs" | "name";
+    sortDir?: "asc" | "desc";
+}
+export interface ListPageResult {
+    jobs: CronJob[];
+    total: number;
+    offset: number;
+    limit: number;
+    hasMore: boolean;
+}
+/** Paginated + filtered + sorted list. */
+export declare function listPage(state: CronServiceState, opts?: ListPageOpts): Promise<ListPageResult>;
+/** Fetch one job by id. Throws if not found. */
+export declare function getJob(state: CronServiceState, jobId: string): Promise<CronJob>;
+/**
+ * Optional context the caller can thread into `add` so the normalizer can
+ * resolve `sessionTarget: "current"` into a concrete `session:<sessionKey>`
+ * value. Agent tool / RPC callers supply it; CLI / tests omit it (and the
+ * "current" alias falls back to `"isolated"` per the normalizer).
+ */
+export interface CronAddOpts {
+    sessionContext?: {
+        sessionKey?: string;
+    };
+}
+/** Create + persist + rearm timer. Returns the created job (with id). */
+export declare function add(state: CronServiceState, input: CronJobCreate, opts?: CronAddOpts): Promise<CronJob>;
+/** Patch + persist + rearm. Returns the updated job. */
+export declare function update(state: CronServiceState, jobId: string, patch: CronJobPatch): Promise<CronJob>;
+/** Delete + persist + rearm. Returns true if removed, false if not found. */
+export declare function remove(state: CronServiceState, jobId: string): Promise<boolean>;
+/** Quick-set the enabled flag without going through the full patch path. */
+export declare function setEnabled(state: CronServiceState, jobId: string, enabled: boolean): Promise<CronJob>;
+/**
+ * Trigger a job now. Two modes:
+ *   - `"due"`   — only fire if the job's `nextRunAtMs` has actually arrived.
+ *   - `"force"` — fire regardless of schedule.
+ *
+ * Runs INLINE (returns when the job completes). For non-blocking trigger,
+ * use `enqueueRun`. Bypasses the concurrency limit — the caller is
+ * explicitly asking for this run.
+ */
+export declare function run(state: CronServiceState, jobId: string, mode?: "due" | "force"): Promise<void>;
+/**
+ * Non-blocking variant of `run`: stamps the job as due-now and rearms the
+ * timer; returns immediately. The next tick (within MIN_REFIRE_GAP_MS at
+ * latest) picks it up.
+ */
+export declare function enqueueRun(state: CronServiceState, jobId: string, mode?: "due" | "force"): Promise<void>;
+/**
+ * Read run log entries for a job.
+ *
+ * Bypasses the per-instance lock — the run log is a separate file and
+ * doesn't share state with the store.
+ */
+export declare function runs(state: CronServiceState, jobId: string, opts?: ReadCronRunLogOpts): Promise<CronRunLogEntry[]>;
+/** Optional routing for a manual `wake` — when set, the system event +
+ *  forced heartbeat target this agent's session rather than the gateway's
+ *  boot default. Defaults to undefined for legacy single-agent installs. */
+export interface CronWakeOpts {
+    /** Target agent id (defaults to boot agent when omitted). */
+    agentId?: string;
+    /** Explicit session key override (defaults to that agent's main session). */
+    sessionKey?: string;
+}
+/**
+ * Inject a system event into the operator's main session. Mode controls
+ * urgency:
+ *   - `"now"`            — force a heartbeat tick to deliver immediately.
+ *   - `"next-heartbeat"` — queue and let the natural heartbeat pick it up.
+ *
+ * `opts.agentId` / `opts.sessionKey` route both the system-event enqueue and
+ * the forced heartbeat to a specific agent's session (multi-agent installs).
+ */
+export declare function wake(state: CronServiceState, text: string, mode?: CronWakeMode, opts?: CronWakeOpts): void;
+/** Re-export so callers don't have to grab it separately. */
+export { computeJobNextRunAtMs };
+//# sourceMappingURL=ops.d.ts.map

package/dist/cron/service/ops.d.ts.map

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

package/dist/cron/service/ops.js

@@ -0,0 +1,415 @@
+/**
+ * Public API for the Brigade cron service.
+ *
+ * Everything CLI commands, the agent-callable `cron` tool, and gateway RPC
+ * handlers depend on goes through this file. Each public function:
+ *   - Holds the per-instance lock (`withPerInstanceLock`) for any mutation.
+ *   - Reloads the store from disk before deciding what to write, so a
+ *     concurrent edit by another process can't be silently clobbered.
+ *   - Emits a lifecycle event (added/updated/removed) on changes.
+ *   - Persists synchronously inside the lock, so callers can rely on the
+ *     write being durable before the function resolves.
+ *
+ * Two execution modes:
+ *   - `run(state, id, mode)` — INLINE execution, returns the outcome.
+ *   - `enqueueRun(state, id, mode)` — QUEUED for the next tick; returns
+ *     immediately. Useful when the caller doesn't want to block (RPC
+ *     handlers, the agent tool).
+ */
+import { withPerInstanceLock } from "./locked.js";
+import { ensureLoaded, persist } from "./store.js";
+import { applyJobPatch, createJob, computeJobNextRunAtMs, } from "./jobs.js";
+import { defaultCronJobCreate } from "../normalize.js";
+import { armTimer, planStartupCatchup, runDueJob, stopTimer } from "./timer.js";
+import { readCronRunLogEntries } from "../run-log.js";
+/** Boot the scheduler — load store, replay missed runs (bounded), arm timer. */
+export async function start(state) {
+    await planStartupCatchup(state);
+    armTimer(state);
+}
+/** Disarm the timer. In-flight jobs continue to completion. */
+export function stop(state) {
+    stopTimer(state);
+}
+export async function status(state) {
+    return withPerInstanceLock(state.op, async () => {
+        await ensureLoaded(state);
+        let enabledCount = 0;
+        let runningCount = 0;
+        let earliest;
+        for (const job of state.store.jobs) {
+            if (job.enabled)
+                enabledCount++;
+            if (job.state.runningAtMs !== undefined)
+                runningCount++;
+            const next = job.state.nextRunAtMs;
+            if (next !== undefined && (earliest === undefined || next < earliest)) {
+                earliest = next;
+            }
+        }
+        return {
+            enabled: state.config.enabled !== false,
+            storePath: state.storePath,
+            jobCount: state.store.jobs.length,
+            enabledJobCount: enabledCount,
+            runningJobCount: runningCount,
+            ...(earliest !== undefined ? { nextWakeAtMs: earliest } : { nextWakeAtMs: undefined }),
+        };
+    });
+}
+/** Simple list. For pagination/filtering use `listPage`. */
+export async function list(state, opts = {}) {
+    return withPerInstanceLock(state.op, async () => {
+        await ensureLoaded(state);
+        const includeDisabled = opts.includeDisabled === true;
+        const filtered = state.store.jobs.filter((j) => includeDisabled || j.enabled);
+        return [...filtered].sort((a, b) => (a.state.nextRunAtMs ?? Infinity) - (b.state.nextRunAtMs ?? Infinity));
+    });
+}
+/** Paginated + filtered + sorted list. */
+export async function listPage(state, opts = {}) {
+    return withPerInstanceLock(state.op, async () => {
+        await ensureLoaded(state);
+        const limit = Math.max(1, Math.min(200, opts.limit ?? 50));
+        const offset = Math.max(0, opts.offset ?? 0);
+        const enabledFilter = opts.enabled ?? "all";
+        const queryLower = opts.query?.toLowerCase() ?? "";
+        const sortBy = opts.sortBy ?? "nextRunAtMs";
+        const sortDir = opts.sortDir ?? "asc";
+        const filtered = state.store.jobs.filter((job) => {
+            if (enabledFilter === "enabled" && !job.enabled)
+                return false;
+            if (enabledFilter === "disabled" && job.enabled)
+                return false;
+            if (queryLower.length === 0)
+                return true;
+            return (job.name.toLowerCase().includes(queryLower) ||
+                (job.description ?? "").toLowerCase().includes(queryLower) ||
+                (job.agentId ?? "").toLowerCase().includes(queryLower) ||
+                job.id.toLowerCase().includes(queryLower));
+        });
+        filtered.sort((a, b) => {
+            let cmp = 0;
+            switch (sortBy) {
+                case "name":
+                    cmp = a.name.localeCompare(b.name);
+                    break;
+                case "updatedAtMs":
+                    cmp = a.updatedAtMs - b.updatedAtMs;
+                    break;
+                default:
+                    cmp = (a.state.nextRunAtMs ?? Infinity) - (b.state.nextRunAtMs ?? Infinity);
+            }
+            return sortDir === "desc" ? -cmp : cmp;
+        });
+        const total = filtered.length;
+        const page = filtered.slice(offset, offset + limit);
+        return {
+            jobs: page,
+            total,
+            offset,
+            limit,
+            hasMore: offset + page.length < total,
+        };
+    });
+}
+/** Fetch one job by id. Throws if not found. */
+export async function getJob(state, jobId) {
+    return withPerInstanceLock(state.op, async () => {
+        await ensureLoaded(state);
+        const job = state.store.jobs.find((j) => j.id === jobId);
+        if (!job)
+            throw new Error(`cron job not found: ${jobId}`);
+        return job;
+    });
+}
+/** Create + persist + rearm timer. Returns the created job (with id). */
+export async function add(state, input, opts) {
+    // Thread the scheduler's virtual clock so `kind: "at"` future-time
+    // validation lines up with the same clock the timer uses (test harnesses
+    // inject `nowMs`; production calls back to `Date.now`).
+    const nowMs = state.deps.nowMs();
+    const defaulted = defaultCronJobCreate(input, {
+        ...(opts?.sessionContext ? { sessionContext: opts.sessionContext } : {}),
+        nowMs,
+    });
+    // Channel-target validation. When the operator (or the model on their
+    // behalf) sets `delivery.channel`, refuse the add if that channel id
+    // doesn't match a started adapter — typos like "whatapp" / "slak" would
+    // otherwise silently persist and fail every fire. Skipped when the
+    // channel registry isn't wired (tests / standalone CLI) so unit tests
+    // don't need to mock a manager just to add a cron.
+    assertDeliveryChannelIsKnown(state, defaulted.delivery);
+    const created = await withPerInstanceLock(state.op, async () => {
+        await ensureLoaded(state);
+        const now = state.deps.nowMs();
+        const job = createJob(defaulted, now);
+        state.store.jobs.push(job);
+        await persist(state);
+        const evt = {
+            action: "added",
+            jobId: job.id,
+            ...(job.state.nextRunAtMs !== undefined
+                ? { nextRunAtMs: job.state.nextRunAtMs }
+                : {}),
+        };
+        emit(state, evt);
+        return job;
+    });
+    armTimer(state);
+    return created;
+}
+/** Patch + persist + rearm. Returns the updated job. */
+export async function update(state, jobId, patch) {
+    // Same channel-target validation as `add` — applies to update too so an
+    // operator can't rename a job's delivery.channel to a typo'd value via
+    // the update path either.
+    if (patch.delivery !== undefined) {
+        assertDeliveryChannelIsKnown(state, patch.delivery);
+    }
+    const updated = await withPerInstanceLock(state.op, async () => {
+        await ensureLoaded(state);
+        const now = state.deps.nowMs();
+        const idx = state.store.jobs.findIndex((j) => j.id === jobId);
+        if (idx < 0)
+            throw new Error(`cron job not found: ${jobId}`);
+        const current = state.store.jobs[idx];
+        const next = applyJobPatch(current, patch, now);
+        state.store.jobs[idx] = next;
+        await persist(state);
+        const evt = {
+            action: "updated",
+            jobId: next.id,
+            ...(next.state.nextRunAtMs !== undefined
+                ? { nextRunAtMs: next.state.nextRunAtMs }
+                : {}),
+        };
+        emit(state, evt);
+        return next;
+    });
+    armTimer(state);
+    return updated;
+}
+/** Delete + persist + rearm. Returns true if removed, false if not found. */
+export async function remove(state, jobId) {
+    const removed = await withPerInstanceLock(state.op, async () => {
+        await ensureLoaded(state);
+        const before = state.store.jobs.length;
+        state.store.jobs = state.store.jobs.filter((j) => j.id !== jobId);
+        const wasRemoved = state.store.jobs.length < before;
+        if (wasRemoved) {
+            await persist(state);
+            emit(state, { action: "removed", jobId });
+        }
+        return wasRemoved;
+    });
+    if (removed)
+        armTimer(state);
+    return removed;
+}
+/** Quick-set the enabled flag without going through the full patch path. */
+export async function setEnabled(state, jobId, enabled) {
+    return update(state, jobId, { enabled });
+}
+/**
+ * Trigger a job now. Two modes:
+ *   - `"due"`   — only fire if the job's `nextRunAtMs` has actually arrived.
+ *   - `"force"` — fire regardless of schedule.
+ *
+ * Runs INLINE (returns when the job completes). For non-blocking trigger,
+ * use `enqueueRun`. Bypasses the concurrency limit — the caller is
+ * explicitly asking for this run.
+ */
+export async function run(state, jobId, mode = "force") {
+    const now = state.deps.nowMs();
+    // Phase A — under the lock: validate, due-check, reserve `runningAtMs`,
+    // persist the running marker so concurrent timer ticks force-reloading
+    // from disk cannot start the same job. Critically: do NOT trample
+    // `nextRunAtMs` — the canonical schedule anchor must survive a manual
+    // force-run untouched (Bug #1). Reserve-then-run pattern: stamp
+    // runningAtMs under lock, persist, then dispatch via the SAME runDueJob
+    // path the tick uses so observability + delivery + run-log fire once
+    // per execution.
+    const reservation = await withPerInstanceLock(state.op, async () => {
+        await ensureLoaded(state);
+        const idx = state.store.jobs.findIndex((j) => j.id === jobId);
+        if (idx < 0)
+            throw new Error(`cron job not found: ${jobId}`);
+        const job = state.store.jobs[idx];
+        if (mode === "due") {
+            const next = job.state.nextRunAtMs;
+            if (next === undefined || next > now) {
+                throw new Error(`cron job not due: ${jobId}`);
+            }
+        }
+        if (typeof job.state.runningAtMs === "number") {
+            return { ran: false };
+        }
+        state.store.jobs[idx] = {
+            ...job,
+            state: { ...job.state, runningAtMs: now },
+        };
+        await persist(state);
+        // Hand the worker a defensive clone so concurrent ops mutations
+        // can't race the in-flight execution view.
+        const executionJob = JSON.parse(JSON.stringify(state.store.jobs[idx]));
+        return { ran: true, executionJob };
+    });
+    if (!reservation.ran) {
+        // Job is already running — caller's force-run becomes a no-op so the
+        // existing run finishes first. The "already-running" reason simply
+        // returns without re-dispatching — the in-flight execution will
+        // emit `finished` on its own and recompute the schedule from there.
+        return;
+    }
+    // Phase B — OUTSIDE the lock: execute via the SAME runDueJob path the
+    // tick loop uses. runDueJob handles emit(started)/emit(finished),
+    // applyJobResult, run-log append, announce delivery, and failure
+    // alerting — every observability surface the tick path supports.
+    // applyJobResult recomputes `nextRunAtMs` from `endedAtMs` on success,
+    // preserving the recurring anchor without the prior broken
+    // `nextRunAtMs: now` write.
+    await runDueJob(state, reservation.executionJob, now);
+    // Re-arm so the canonical post-run `nextRunAtMs` drives the next tick.
+    armTimer(state);
+}
+/**
+ * Non-blocking variant of `run`: stamps the job as due-now and rearms the
+ * timer; returns immediately. The next tick (within MIN_REFIRE_GAP_MS at
+ * latest) picks it up.
+ */
+export async function enqueueRun(state, jobId, mode = "force") {
+    const now = state.deps.nowMs();
+    // Validate under the lock so the caller gets a clean refusal for
+    // not-found / not-due before we kick off the background run.
+    await withPerInstanceLock(state.op, async () => {
+        await ensureLoaded(state);
+        const idx = state.store.jobs.findIndex((j) => j.id === jobId);
+        if (idx < 0)
+            throw new Error(`cron job not found: ${jobId}`);
+        const job = state.store.jobs[idx];
+        if (mode === "due") {
+            const next = job.state.nextRunAtMs;
+            if (next === undefined || next > now) {
+                throw new Error(`cron job not due: ${jobId}`);
+            }
+        }
+        // Crucially: do NOT mutate `nextRunAtMs` here. The prior implementation
+        // stamped `nextRunAtMs: now` so the next tick would pick it up, but
+        // that corrupted the recurring "every" anchor (the tick's
+        // applyJobResult would compute the next slot relative to the trampled
+        // anchor) AND raced with concurrent ticks (Bug #1). The non-blocking
+        // trigger now schedules a microtask that runs the manual-run pipeline
+        // off the caller's promise chain — the canonical nextRunAtMs stays
+        // untouched until applyJobResult recomputes it after the run finishes.
+    });
+    // Fire-and-forget background run. Errors are swallowed (the run-log +
+    // failure-alert path inside `runDueJob` already records them) so the
+    // caller's enqueue-return contract stays clean.
+    void run(state, jobId, mode).catch((err) => {
+        state.deps.log.warn("cron enqueueRun background run threw", {
+            jobId,
+            mode,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    });
+}
+/**
+ * Read run log entries for a job.
+ *
+ * Bypasses the per-instance lock — the run log is a separate file and
+ * doesn't share state with the store.
+ */
+export async function runs(state, jobId, opts = {}) {
+    void state;
+    return readCronRunLogEntries(jobId, opts);
+}
+/**
+ * Inject a system event into the operator's main session. Mode controls
+ * urgency:
+ *   - `"now"`            — force a heartbeat tick to deliver immediately.
+ *   - `"next-heartbeat"` — queue and let the natural heartbeat pick it up.
+ *
+ * `opts.agentId` / `opts.sessionKey` route both the system-event enqueue and
+ * the forced heartbeat to a specific agent's session (multi-agent installs).
+ */
+export function wake(state, text, mode = "next-heartbeat", opts = {}) {
+    state.pendingSystemEvents.push({ text, mode });
+    const enqueue = state.deps.enqueueSystemEvent;
+    if (enqueue) {
+        try {
+            enqueue({
+                text,
+                ...(opts.agentId !== undefined ? { agentId: opts.agentId } : {}),
+                ...(opts.sessionKey !== undefined ? { sessionKey: opts.sessionKey } : {}),
+            });
+        }
+        catch (err) {
+            state.deps.log.warn("wake: enqueueSystemEvent threw", {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    if (mode === "now" && state.deps.requestHeartbeatNow) {
+        try {
+            state.deps.requestHeartbeatNow({
+                reason: "cron-wake",
+                ...(opts.agentId !== undefined ? { agentId: opts.agentId } : {}),
+                ...(opts.sessionKey !== undefined ? { sessionKey: opts.sessionKey } : {}),
+            });
+        }
+        catch (err) {
+            state.deps.log.warn("wake: requestHeartbeatNow threw", {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+}
+/** Re-export so callers don't have to grab it separately. */
+export { computeJobNextRunAtMs };
+function emit(state, event) {
+    const cb = state.deps.onEvent;
+    if (!cb)
+        return;
+    try {
+        cb(event);
+    }
+    catch (err) {
+        state.deps.log.warn("cron event listener threw", {
+            action: event.action,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+/**
+ * Refuse a `cron add`/`update` whose `delivery.channel` doesn't correspond
+ * to a started channel adapter. Catches typos ("whatapp", "slak") that
+ * would otherwise silently persist and produce a "channel not started"
+ * warning every fire — the operator never seeing the cron's reply and
+ * never understanding why.
+ *
+ * Skipped when:
+ *   - No `listKnownChannelIds` dep is wired (tests / standalone CLI).
+ *   - The returned list is empty (no channels active yet — don't block
+ *     adding a cron BEFORE the first channel adapter starts).
+ *   - `delivery` is unset / `delivery.channel` is unset / `delivery.mode`
+ *     isn't `"announce"`.
+ */
+function assertDeliveryChannelIsKnown(state, delivery) {
+    if (!delivery)
+        return;
+    if (delivery.mode !== "announce")
+        return;
+    const channelRaw = delivery.channel?.trim();
+    if (!channelRaw)
+        return;
+    const list = state.deps.listKnownChannelIds?.();
+    if (!list || list.length === 0)
+        return;
+    if (list.includes(channelRaw))
+        return;
+    throw new Error(`cron delivery.channel "${channelRaw}" is not a started channel adapter — ` +
+        `available channels: ${list.join(", ") || "(none)"}. ` +
+        `Either start the adapter first or change the channel id.`);
+}
+//# sourceMappingURL=ops.js.map

package/dist/cron/service/ops.js.map

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