@spinabot/brigade 0.1.2 → 1.0.1

package/dist/cron/normalize.js

@@ -0,0 +1,376 @@
+/**
+ * Normalization + defaulting layer.
+ *
+ * `ops.add` / `ops.update` take a partial `CronJobCreate` from the caller (CLI,
+ * RPC, or agent tool) and the store needs a fully-realised `CronJob` with
+ * every field decided. This file owns the defaulting rules so the timer
+ * loop, the run log, and the delivery dispatcher can all trust that
+ * downstream values are present.
+ *
+ * Defaulting rules locked from the reference architecture:
+ *   - `enabled` defaults to `true`.
+ *   - `wakeMode` defaults to `"next-heartbeat"` (less disruptive than `"now"`).
+ *   - `deleteAfterRun` defaults to `true` for `kind: "at"`, undefined otherwise.
+ *   - `sessionTarget` defaults to `"main"` for `systemEvent` payloads,
+ *     `"isolated"` for `agentTurn` payloads.
+ *   - `delivery.mode` defaults: `"none"` for `systemEvent`, `"announce"` for
+ *     `agentTurn` (so the operator sees the result by default).
+ *   - `delivery.bestEffort` defaults to `false`.
+ *   - Top-of-hour `cron` patterns get a 5-minute stagger window unless
+ *     explicit.
+ *
+ * Validation calls live in `service/jobs.ts:assertSupportedJobSpec`; this
+ * file only fills defaults + light coercion.
+ */
+import { parseAbsoluteTimeMs } from "./parse.js";
+import { assertSafeCronSessionTargetId } from "./session-target.js";
+import { defaultStaggerMsForCronExpression } from "./stagger.js";
+import { assertFutureAtTimestamp } from "./validate-timestamp.js";
+/** Default sessionTarget given a payload's kind. */
+export function defaultSessionTargetForPayload(payload) {
+    return payload.kind === "systemEvent" ? "main" : "isolated";
+}
+/** Default delivery mode given the payload's kind. */
+function defaultDeliveryModeForPayload(payload) {
+    return payload.kind === "systemEvent" ? "none" : "announce";
+}
+/**
+ * Relative-offset → absolute `at` resolver (input-only sugar).
+ *
+ * LLMs are unreliable at producing 13-digit epoch-millisecond timestamps: a
+ * "remind me in 5 minutes" turn has the model emit `Date.now() + 300_000`
+ * from its head, and it routinely lands minutes off (observed in production:
+ * a "5 minutes" reminder got scheduled ~14 minutes out, fired late, and the
+ * operator had already given up). The model has no real `Date.now()` — the
+ * runtime prompt carries only a wall-clock + ISO string — so it GUESSES the
+ * epoch, and the reminder fires at the wrong time.
+ *
+ * The fix: let the model express the OFFSET ("in N minutes") and resolve it
+ * to an absolute fire-time SERVER-SIDE against the real clock. This is an
+ * input-only alias — exactly like `sessionTarget: "current"` — that rewrites
+ * to the canonical `{kind: "at", at: <epoch ms>}` BEFORE validation, so
+ * nothing downstream (timer, schedule math, delivery) ever sees the relative
+ * form.
+ *
+ * Recognised when the schedule object carries `kind: "in"` OR any relative
+ * field while NO absolute `at`/`atMs` is present (an explicit `at` always
+ * wins, preserving back-compat). Multiple fields SUM, so
+ * `{inHours: 1, inMinutes: 30}` = 90 minutes. A few spelling variants are
+ * accepted so a non-frontier model's phrasing still lands.
+ *
+ *   {kind: "in", inMinutes: 5}   → at = now + 5 min
+ *   {inSeconds: 90}              → at = now + 90 s
+ *   {kind: "at", inMinutes: 5}   → at = now + 5 min (relative wins; no `at`)
+ *   {kind: "at", at: 1780…}      → unchanged (absolute `at` present)
+ */
+const RELATIVE_OFFSET_FIELDS = [
+    ["inms", 1],
+    ["inmillis", 1],
+    ["inmilliseconds", 1],
+    ["insec", 1000],
+    ["insecs", 1000],
+    ["insecond", 1000],
+    ["inseconds", 1000],
+    ["inmin", 60_000],
+    ["inmins", 60_000],
+    ["inminute", 60_000],
+    ["inminutes", 60_000],
+    ["inhour", 3_600_000],
+    ["inhours", 3_600_000],
+    ["inhr", 3_600_000],
+    ["inhrs", 3_600_000],
+    ["inday", 86_400_000],
+    ["indays", 86_400_000],
+];
+/** Sum every recognised relative-offset field (case-insensitive). Returns
+ *  `undefined` when none are present, so the caller can tell "no relative
+ *  signal" apart from "a zero offset". */
+function readRelativeOffsetMs(rec) {
+    const lowerKeyed = new Map();
+    for (const key of Object.keys(rec))
+        lowerKeyed.set(key.toLowerCase(), rec[key]);
+    let total = 0;
+    let found = false;
+    for (const [key, mult] of RELATIVE_OFFSET_FIELDS) {
+        const v = lowerKeyed.get(key);
+        if (typeof v === "number" && Number.isFinite(v)) {
+            total += v * mult;
+            found = true;
+        }
+    }
+    return found ? total : undefined;
+}
+/**
+ * Rewrite a relative-offset schedule input into the canonical
+ * `{kind: "at", at: <epoch ms>}` form using `nowMs`. Pass-through for any
+ * input that isn't a relative form (absolute `at`, `every`, `cron`, etc.).
+ * Throws a clear error for a `kind: "in"` with a missing / non-positive
+ * offset so the caller (agent tool / RPC) gets an actionable refusal.
+ */
+export function resolveRelativeScheduleInput(raw, nowMs) {
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
+        return raw;
+    const rec = raw;
+    const kind = typeof rec.kind === "string" ? rec.kind.toLowerCase() : undefined;
+    const hasAbsoluteAt = rec.at !== undefined || rec.atMs !== undefined;
+    const offsetMs = readRelativeOffsetMs(rec);
+    const isRelative = kind === "in" || (offsetMs !== undefined && !hasAbsoluteAt);
+    if (!isRelative)
+        return raw;
+    if (offsetMs === undefined) {
+        throw new Error('cron relative schedule (kind "in") requires a positive offset — ' +
+            "one of inSeconds / inMinutes / inHours / inDays / inMs");
+    }
+    if (offsetMs <= 0) {
+        throw new Error(`cron relative schedule offset must be positive (got ${offsetMs} ms)`);
+    }
+    return { kind: "at", at: nowMs + offsetMs };
+}
+/**
+ * Coerce a permissive caller-supplied schedule into a canonical `CronSchedule`.
+ *
+ * The agent tool's TypeBox shape is `Type.Any()` so the LLM can pass any of:
+ *   - a bare string  → `"0 9 * * *"` (treated as a cron expression)
+ *   - a record missing `kind` but carrying `expr` / `cron` / `everyMs` / `at`
+ *   - the canonical `{kind: "cron", expr: "..."}` shape
+ *
+ * Without this coercion a string slipped past `normalizeSchedule` unchanged,
+ * landed on disk with no `kind`, and `computeNextRunAtMs`'s switch returned
+ * `undefined` forever — the job never fired. Migration of already-stored
+ * bad-shape schedules happens in `store.ts:ensureLoaded` using this same
+ * helper, so an operator who hit the bug on an older build doesn't have to
+ * hand-edit `~/.brigade/cron.json`.
+ */
+export function coerceScheduleInput(raw) {
+    if (typeof raw === "string") {
+        const expr = raw.trim();
+        if (!expr)
+            throw new Error("cron schedule string is empty");
+        return { kind: "cron", expr };
+    }
+    if (raw === null || typeof raw !== "object") {
+        throw new Error("cron schedule must be a string (cron expr) or an object — got " + typeof raw);
+    }
+    const rec = raw;
+    const rawKind = typeof rec.kind === "string" ? rec.kind.toLowerCase() : undefined;
+    const validKinds = new Set(["at", "every", "cron"]);
+    const kind = rawKind && validKinds.has(rawKind) ? rawKind : undefined;
+    // Pull expression out of either `expr` or the legacy `cron` alias.
+    const rawExpr = typeof rec.expr === "string"
+        ? rec.expr
+        : typeof rec.cron === "string"
+            ? rec.cron
+            : undefined;
+    const expr = rawExpr?.trim() || undefined;
+    const everyMs = typeof rec.everyMs === "number" ? rec.everyMs : undefined;
+    // Accept `at` OR `atMs` as the absolute timestamp field. Per reference
+    // implementation parse.ts, BOTH channels accept (a) numeric epoch ms,
+    // (b) digit-string epoch ms, and (c) ISO-8601 string with UTC fallback
+    // (bare date → midnight Z; naive date-time → append Z; tz-suffixed
+    // preserved). Failure to parse a string → undefined (caller error
+    // surfaces below in the kind-"at" branch).
+    const atMsRaw = rec.atMs;
+    const atRaw = rec.at;
+    const atString = typeof atRaw === "string" ? atRaw.trim() : "";
+    const atMsString = typeof atMsRaw === "string" ? atMsRaw.trim() : "";
+    const at = typeof atMsRaw === "number" && Number.isFinite(atMsRaw)
+        ? Math.floor(atMsRaw)
+        : atMsString
+            ? (parseAbsoluteTimeMs(atMsString) ?? undefined)
+            : typeof atRaw === "number" && Number.isFinite(atRaw)
+                ? Math.floor(atRaw)
+                : atString
+                    ? (parseAbsoluteTimeMs(atString) ?? undefined)
+                    : undefined;
+    // A bare ISO string on `at` or `atMs` is enough to infer kind "at" — the
+    // reference normalizer auto-detects this even when `kind` is omitted.
+    const hasAtSignal = at !== undefined ||
+        atString.length > 0 ||
+        atMsString.length > 0 ||
+        typeof atMsRaw === "number";
+    // Infer kind from whichever discriminator field is present.
+    const inferredKind = kind ??
+        (hasAtSignal
+            ? "at"
+            : everyMs !== undefined
+                ? "every"
+                : expr
+                    ? "cron"
+                    : undefined);
+    if (!inferredKind) {
+        throw new Error("cron schedule object needs at least one of: kind, expr, everyMs, at");
+    }
+    switch (inferredKind) {
+        case "at": {
+            if (at === undefined) {
+                throw new Error('cron schedule kind "at" requires `at` as ISO-8601 string ' +
+                    "OR epoch ms (number, or numeric/atMs string)");
+            }
+            // Future-time validation runs at the `defaultCronJobCreate` layer
+            // (NOT here) so the bare coerce remains a pure shape-coercer that
+            // callers can use to canonicalise a stored / historical schedule
+            // without tripping the grace-window guard.
+            return { kind: "at", at };
+        }
+        case "every": {
+            if (everyMs === undefined) {
+                throw new Error('cron schedule kind "every" requires a numeric `everyMs`');
+            }
+            const anchorMs = typeof rec.anchorMs === "number" ? rec.anchorMs : undefined;
+            return {
+                kind: "every",
+                everyMs,
+                ...(anchorMs !== undefined ? { anchorMs } : {}),
+            };
+        }
+        case "cron": {
+            if (!expr) {
+                throw new Error('cron schedule kind "cron" requires `expr` (a cron expression)');
+            }
+            const tz = typeof rec.tz === "string" ? rec.tz : undefined;
+            const staggerMs = typeof rec.staggerMs === "number" ? rec.staggerMs : undefined;
+            return {
+                kind: "cron",
+                expr,
+                ...(tz !== undefined ? { tz } : {}),
+                ...(staggerMs !== undefined ? { staggerMs } : {}),
+            };
+        }
+    }
+    throw new Error(`cron schedule has unsupported kind: ${inferredKind}`);
+}
+/**
+ * Fill in a schedule's optional fields. For `cron` kind, applies the
+ * top-of-hour stagger default. Other kinds pass through unchanged.
+ *
+ * Always run AFTER `coerceScheduleInput` — accepts only canonical-shape
+ * schedules. Stale callers that pass a bare string slip past here unchanged
+ * (the type-guard `schedule.kind !== "cron"` is true for `undefined`), so
+ * make sure the entry point calls coerce first.
+ */
+export function normalizeSchedule(schedule) {
+    if (schedule.kind !== "cron")
+        return schedule;
+    if (schedule.staggerMs !== undefined)
+        return schedule;
+    const stagger = defaultStaggerMsForCronExpression(schedule.expr);
+    if (stagger <= 0)
+        return schedule;
+    return { ...schedule, staggerMs: stagger };
+}
+/**
+ * Fill in a delivery block's missing fields. Returns `undefined` only if the
+ * caller already opted out by omitting delivery AND the payload's natural
+ * default is also `none`.
+ */
+export function normalizeDelivery(delivery, payload) {
+    const mode = delivery?.mode ?? defaultDeliveryModeForPayload(payload);
+    if (mode === "none" && !delivery)
+        return undefined;
+    return {
+        mode,
+        ...(delivery?.channel !== undefined ? { channel: delivery.channel } : {}),
+        ...(delivery?.to !== undefined ? { to: delivery.to } : {}),
+        ...(delivery?.accountId !== undefined ? { accountId: delivery.accountId } : {}),
+        ...(delivery?.threadId !== undefined ? { threadId: delivery.threadId } : {}),
+        bestEffort: delivery?.bestEffort ?? false,
+        ...(delivery?.webhookUrl !== undefined ? { webhookUrl: delivery.webhookUrl } : {}),
+    };
+}
+/** Default wake mode for `wake` actions when the caller didn't specify. */
+export function defaultWakeMode() {
+    return "next-heartbeat";
+}
+/**
+ * Resolve `deleteAfterRun` for a schedule kind. Caller-supplied wins; else
+ * one-shot `at` jobs auto-delete on success, recurring jobs do not.
+ */
+export function resolveDeleteAfterRun(caller, schedule) {
+    if (caller !== undefined)
+        return caller;
+    return schedule.kind === "at" ? true : undefined;
+}
+/**
+ * Resolve a possibly-aliased `sessionTarget` into the persisted form.
+ *
+ *   - `"current"` + session context → `session:<sessionKey>` (safe-id guarded).
+ *   - `"current"` without context  → `"isolated"` (headless / CLI fallback).
+ *   - any other value              → returned unchanged.
+ *
+ * Mirrors the reference normalizer's create-time resolver — persisted
+ * `CronJob.sessionTarget` values are always one of
+ * `"main" | "isolated" | "session:<id>"` after this runs.
+ */
+function resolveSessionTargetAlias(target, opts) {
+    if (target !== "current")
+        return target;
+    const key = opts?.sessionContext?.sessionKey?.trim();
+    if (key) {
+        // `assertSafeCronSessionTargetId` throws on path-special / control
+        // characters; we re-throw with the original error to surface the
+        // invalid-spec to the caller (matches reference behaviour).
+        assertSafeCronSessionTargetId(key);
+        return `session:${key}`;
+    }
+    return "isolated";
+}
+/**
+ * Produce a fully-defaulted create input — every optional field decided.
+ * Doesn't validate; that's `assertSupportedJobSpec`'s job. Doesn't write to
+ * disk; the caller (ops.add) does that.
+ *
+ * Pass `opts.sessionContext.sessionKey` to resolve `sessionTarget: "current"`
+ * into the caller's session. Existing callers that omit `opts` keep the
+ * pre-existing single-agent behaviour (no "current" → no rewrite).
+ */
+export function defaultCronJobCreate(input, opts) {
+    // Resolve a relative offset ("in 5 minutes") to an absolute `at` against
+    // the scheduler clock FIRST — so the model never has to compute a 13-digit
+    // epoch in its head (it gets that wrong; see `resolveRelativeScheduleInput`).
+    // Pass-through for absolute / every / cron inputs. Use one clock reading for
+    // both the relative resolve and the future-time guard below so they agree.
+    const nowForSchedule = opts?.nowMs ?? Date.now();
+    const relativeResolved = resolveRelativeScheduleInput(input.schedule, nowForSchedule);
+    // Coerce permissive caller input (bare string / object-without-kind) into
+    // the canonical CronSchedule shape BEFORE we touch staggerMs etc. — see
+    // `coerceScheduleInput` for the supported shapes.
+    const coerced = coerceScheduleInput(relativeResolved);
+    const schedule = normalizeSchedule(coerced);
+    // Future-time validation on the create-path ONLY (not on the bare
+    // coercer, which is also used for shape-canonicalising stored / replayed
+    // schedules). Reject `at` jobs whose timestamp is past / current-minute
+    // / within the no-fire grace window so an AM/PM-ambiguous parse
+    // (e.g. "12:27 AM" at 12:27 PM) gets a clear retry signal instead of
+    // silently being persisted with `nextRunAtMs: undefined`. Threads
+    // `opts.nowMs` so simulated-clock tests use the scheduler's virtual
+    // time rather than wall-clock `Date.now()`.
+    if (schedule.kind === "at") {
+        assertFutureAtTimestamp(schedule.at, nowForSchedule);
+    }
+    const sessionTargetRaw = input.sessionTarget ?? defaultSessionTargetForPayload(input.payload);
+    // Resolve `"current"` → `session:<id>` (or `"isolated"` when no session
+    // context is available). Persisted value is never `"current"`.
+    const sessionTarget = resolveSessionTargetAlias(sessionTargetRaw, opts);
+    const wakeMode = input.wakeMode ?? defaultWakeMode();
+    const delivery = normalizeDelivery(input.delivery, input.payload);
+    const deleteAfterRun = resolveDeleteAfterRun(input.deleteAfterRun, schedule);
+    // Stamp `sessionKey` from the caller's input OR from the session context.
+    // Without this, an agent-tool call that resolves `sessionTarget: "current"`
+    // to `session:<key>` leaves `job.sessionKey` undefined — downstream
+    // failure-alert / announce-fallback routing then can't find the caller's
+    // session and routes back to default-agent's main session instead.
+    const resolvedSessionKey = typeof input.sessionKey === "string" && input.sessionKey.trim().length > 0
+        ? input.sessionKey.trim()
+        : opts?.sessionContext?.sessionKey?.trim();
+    return {
+        ...input,
+        schedule,
+        sessionTarget,
+        wakeMode,
+        enabled: input.enabled ?? true,
+        ...(delivery !== undefined ? { delivery } : {}),
+        ...(deleteAfterRun !== undefined ? { deleteAfterRun } : {}),
+        ...(resolvedSessionKey ? { sessionKey: resolvedSessionKey } : {}),
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/cron/normalize.js.map

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

package/dist/cron/parse.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Absolute-time string parser for cron schedules.
+ *
+ * Single decoder for two callers:
+ *   - `schedule.at`   — input layer (agent tool / RPC) accepts ISO-8601
+ *     strings; we convert here.
+ *   - `schedule.atMs` — legacy alias; accepts numeric ms OR digit-string ms.
+ *
+ * Three input shapes, one entry point:
+ *   1. Pure-digit string  → treated as epoch ms.
+ *   2. ISO with explicit tz suffix `Z` / `[+-]HH:MM` / `[+-]HHMM` → passed to
+ *      `Date.parse` as-is.
+ *   3. ISO without tz suffix → UTC fallback (deterministic, no local-time
+ *      surprises):
+ *        - bare `YYYY-MM-DD`  → suffix `T00:00:00Z`
+ *        - `YYYY-MM-DDT...`   → suffix `Z`
+ *
+ * Returns `null` for anything `Date.parse` rejects; caller decides whether
+ * to throw or fall back. Never throws itself.
+ *
+ * Mirrored from the upstream reference cron parser (parse.ts) so Brigade
+ * accepts the same caller surface — ISO-string `at` from agent tools while
+ * keeping the on-disk `at` field as epoch ms (Brigade's persisted shape;
+ * see `CronScheduleAt.at: number` in `types.ts`).
+ */
+export declare function parseAbsoluteTimeMs(input: string): number | null;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/cron/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAmBH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAahE"}

package/dist/cron/parse.js

@@ -0,0 +1,55 @@
+/**
+ * Absolute-time string parser for cron schedules.
+ *
+ * Single decoder for two callers:
+ *   - `schedule.at`   — input layer (agent tool / RPC) accepts ISO-8601
+ *     strings; we convert here.
+ *   - `schedule.atMs` — legacy alias; accepts numeric ms OR digit-string ms.
+ *
+ * Three input shapes, one entry point:
+ *   1. Pure-digit string  → treated as epoch ms.
+ *   2. ISO with explicit tz suffix `Z` / `[+-]HH:MM` / `[+-]HHMM` → passed to
+ *      `Date.parse` as-is.
+ *   3. ISO without tz suffix → UTC fallback (deterministic, no local-time
+ *      surprises):
+ *        - bare `YYYY-MM-DD`  → suffix `T00:00:00Z`
+ *        - `YYYY-MM-DDT...`   → suffix `Z`
+ *
+ * Returns `null` for anything `Date.parse` rejects; caller decides whether
+ * to throw or fall back. Never throws itself.
+ *
+ * Mirrored from the upstream reference cron parser (parse.ts) so Brigade
+ * accepts the same caller surface — ISO-string `at` from agent tools while
+ * keeping the on-disk `at` field as epoch ms (Brigade's persisted shape;
+ * see `CronScheduleAt.at: number` in `types.ts`).
+ */
+const ISO_TZ_RE = /(Z|[+-]\d{2}:?\d{2})$/i;
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const ISO_DATE_TIME_RE = /^\d{4}-\d{2}-\d{2}T/;
+function normalizeUtcIso(raw) {
+    if (ISO_TZ_RE.test(raw)) {
+        return raw;
+    }
+    if (ISO_DATE_RE.test(raw)) {
+        return `${raw}T00:00:00Z`;
+    }
+    if (ISO_DATE_TIME_RE.test(raw)) {
+        return `${raw}Z`;
+    }
+    return raw;
+}
+export function parseAbsoluteTimeMs(input) {
+    const raw = input.trim();
+    if (!raw) {
+        return null;
+    }
+    if (/^\d+$/.test(raw)) {
+        const n = Number(raw);
+        if (Number.isFinite(n) && n > 0) {
+            return Math.floor(n);
+        }
+    }
+    const parsed = Date.parse(normalizeUtcIso(raw));
+    return Number.isFinite(parsed) ? parsed : null;
+}
+//# sourceMappingURL=parse.js.map

package/dist/cron/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/cron/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,SAAS,GAAG,wBAAwB,CAAC;AAC3C,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAC1C,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAE/C,SAAS,eAAe,CAAC,GAAW;IACnC,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,GAAG,YAAY,CAAC;IAC3B,CAAC;IACD,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,GAAG,GAAG,GAAG,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC"}

package/dist/cron/reminder-context.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Reminder-context helper for cron `systemEvent` payloads.
+ *
+ * When the agent (via the cron tool) schedules a reminder with
+ * `contextMessages: N`, this module fetches the caller's last N messages from
+ * the gateway's session history and formats them into a compact
+ * `Recent context:` block appended to the reminder's text. The fire-time
+ * heartbeat consumer sees the operator's recent chat alongside the reminder
+ * so the reply can pick up on what they were just talking about.
+ *
+ * Constants are tuned for tight budgets — the reminder text itself is the
+ * primary signal; the context is a hint. Total context never exceeds 700
+ * chars across at most 10 lines of at most 220 chars each.
+ *
+ * Mirrored from the upstream cron-tool reminder-context block. Two small
+ * Brigade-side adjustments:
+ *   1. Calls `sessions.history` (Brigade's RPC) instead of `chat.history`.
+ *   2. Drops the public-alias → internal-key resolver step because Brigade
+ *      session keys are already in internal form. Caller passes the key as-
+ *      is; `handleSessionsHistory` accepts it directly.
+ */
+import { callGateway } from "../agents/gateway-call.js";
+export declare const REMINDER_CONTEXT_MESSAGES_MAX = 10;
+export declare const REMINDER_CONTEXT_PER_MESSAGE_MAX = 220;
+export declare const REMINDER_CONTEXT_TOTAL_MAX = 700;
+export declare const REMINDER_CONTEXT_MARKER = "\n\nRecent context:\n";
+/**
+ * Strip a previously-appended `Recent context:` block so a re-add (e.g.
+ * follow-up `cron update`) doesn't double-stack contexts. Idempotent.
+ */
+export declare function stripExistingContext(text: string): string;
+/** UTF-16-safe truncation with "..." suffix when over `maxLen`. */
+export declare function truncateText(input: string, maxLen: number): string;
+/**
+ * Pull `text` out of a chat message's `content` field. Handles both legacy
+ * string-content and the Anthropic-style array-of-blocks. Returns `null` for
+ * non-text content or whitespace-only text so the caller can drop the entry.
+ */
+export declare function extractTextFromChatContent(content: unknown): string | null;
+export interface BuildReminderContextLinesOpts {
+    /** Caller's session key — `sessions.history` is fetched against this. */
+    agentSessionKey?: string;
+    /** Requested count (0..MAX). Clamped. */
+    contextMessages: number;
+    /**
+     * Override for the gateway dispatcher — defaults to the in-process
+     * caller. Tests inject a stub to avoid wiring a real gateway.
+     */
+    callGateway?: typeof callGateway;
+}
+/**
+ * Build the `- Role: text` lines for the `Recent context:` block.
+ *
+ * Returns `[]` when:
+ *   - `contextMessages <= 0` after clamping.
+ *   - `agentSessionKey` is empty / whitespace (TUI / standalone CLI).
+ *   - The gateway call throws (any reason — silent degrade, the reminder
+ *     still fires without context).
+ *
+ * Respects both per-message (220 chars + "...") and total (700 chars) caps;
+ * the first line that would push total over budget is dropped (not
+ * partially included).
+ */
+export declare function buildReminderContextLines(opts: BuildReminderContextLinesOpts): Promise<string[]>;
+/**
+ * Mutate-or-passthrough helper used by the cron tool's `add` branch.
+ * When the input job's payload is a non-empty `systemEvent.text`, fetches
+ * recent context and appends it to the payload's text. Non-mutating: returns
+ * the original input when context can't be built.
+ */
+export declare function maybeAttachReminderContext(args: {
+    job: Record<string, unknown>;
+    contextMessages: number;
+    agentSessionKey?: string;
+    /** Override gateway dispatcher for tests. */
+    callGateway?: typeof callGateway;
+}): Promise<Record<string, unknown>>;
+//# sourceMappingURL=reminder-context.d.ts.map

package/dist/cron/reminder-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-context.d.ts","sourceRoot":"","sources":["../../src/cron/reminder-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAalE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkB1E;AAcD,MAAM,WAAW,6BAA6B;IAC7C,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAC9C,IAAI,EAAE,6BAA6B,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC,CAkCnB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACtD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;CACjC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoBnC"}