@michael-joseph-miller/ant-bot 0.1.0

package/dist/scheduler-Q7OHNGP6.js

@@ -0,0 +1,274 @@
+import { createRequire as __antbotCreateRequire } from 'node:module';
+const require = __antbotCreateRequire(import.meta.url);
+import {
+  logger
+} from "./chunk-AHAON6J7.js";
+
+// packages/server/src/scheduler/scheduler.ts
+import cron from "node-cron";
+var log = logger("scheduler");
+function parseCronFieldPart(field, min, max) {
+  const trimmed = field.trim();
+  if (trimmed === "*") {
+    const values2 = /* @__PURE__ */ new Set();
+    for (let v = min; v <= max; v++) values2.add(v);
+    return { values: values2, wildcard: true };
+  }
+  const values = /* @__PURE__ */ new Set();
+  for (const part of trimmed.split(",")) {
+    const m = part.match(/^(\*|\d+)(?:-(\d+))?(?:\/(\d+))?$/);
+    if (!m) throw new Error(`Invalid cron field: "${part}"`);
+    const [, startStr, endStr, stepStr] = m;
+    const step = stepStr ? parseInt(stepStr, 10) : 1;
+    let start;
+    let end;
+    if (startStr === "*") {
+      start = min;
+      end = max;
+    } else {
+      start = parseInt(startStr, 10);
+      end = endStr !== void 0 ? parseInt(endStr, 10) : stepStr ? max : start;
+    }
+    for (let v = start; v <= end; v += step) values.add(v);
+  }
+  return { values, wildcard: false };
+}
+function parseCronExpr(expr) {
+  const parts = expr.trim().split(/\s+/);
+  if (parts.length !== 5) throw new Error(`Cron expression must have 5 fields: "${expr}"`);
+  const [minute, hour, dayOfMonth, month, dayOfWeekRaw] = parts;
+  const dayOfWeek = parseCronFieldPart(dayOfWeekRaw, 0, 7);
+  if (dayOfWeek.values.has(7)) {
+    dayOfWeek.values.delete(7);
+    dayOfWeek.values.add(0);
+  }
+  return {
+    minute: parseCronFieldPart(minute, 0, 59),
+    hour: parseCronFieldPart(hour, 0, 23),
+    dayOfMonth: parseCronFieldPart(dayOfMonth, 1, 31),
+    month: parseCronFieldPart(month, 1, 12),
+    dayOfWeek
+  };
+}
+var WEEKDAY_INDEX = { Sun: 0, Mon: 1, Tue: 2, Wed: 3, Thu: 4, Fri: 5, Sat: 6 };
+function makeTzFormatter(timeZone) {
+  return new Intl.DateTimeFormat("en-US", {
+    timeZone,
+    hour12: false,
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    weekday: "short"
+  });
+}
+function tzParts(dtf, ms) {
+  const parts = dtf.formatToParts(new Date(ms));
+  const map = {};
+  for (const p of parts) map[p.type] = p.value;
+  let hour = parseInt(map.hour ?? "0", 10);
+  if (hour === 24) hour = 0;
+  return {
+    month: parseInt(map.month ?? "1", 10),
+    day: parseInt(map.day ?? "1", 10),
+    hour,
+    minute: parseInt(map.minute ?? "0", 10),
+    weekday: WEEKDAY_INDEX[map.weekday ?? "Sun"] ?? 0
+  };
+}
+var MAX_LOOKAHEAD_MINUTES = 366 * 24 * 60;
+function nextRunAt(cronExpr, timezone, fromMs) {
+  const fields = parseCronExpr(cronExpr);
+  const dtf = makeTzFormatter(timezone);
+  const bothWildcard = fields.dayOfMonth.wildcard && fields.dayOfWeek.wildcard;
+  let t = Math.floor(fromMs / 6e4) * 6e4 + 6e4;
+  for (let i = 0; i < MAX_LOOKAHEAD_MINUTES; i++, t += 6e4) {
+    const p = tzParts(dtf, t);
+    if (!fields.minute.values.has(p.minute)) continue;
+    if (!fields.hour.values.has(p.hour)) continue;
+    if (!fields.month.values.has(p.month)) continue;
+    const domMatch = fields.dayOfMonth.values.has(p.day);
+    const dowMatch = fields.dayOfWeek.values.has(p.weekday);
+    const dayOk = bothWildcard ? true : fields.dayOfMonth.wildcard ? dowMatch : fields.dayOfWeek.wildcard ? domMatch : domMatch || dowMatch;
+    if (!dayOk) continue;
+    return t;
+  }
+  return null;
+}
+var DOW_NAMES = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+function cronToHuman(expr) {
+  const parts = expr.trim().split(/\s+/);
+  if (parts.length !== 5) return expr;
+  const [min, hour, dom, month, dow] = parts;
+  const pad = (n) => n.padStart(2, "0");
+  if (min.startsWith("*/") && hour === "*" && dom === "*" && month === "*" && dow === "*") {
+    return `Every ${min.slice(2)} minutes`;
+  }
+  if (hour.startsWith("*/") && min === "0" && dom === "*" && month === "*" && dow === "*") {
+    return `Every ${hour.slice(2)} hours`;
+  }
+  if (/^\d+$/.test(min) && /^\d+$/.test(hour)) {
+    const time = `${pad(hour)}:${pad(min)}`;
+    if (dom === "*" && month === "*") {
+      if (dow === "*") return `Every day at ${time}`;
+      if (dow === "1-5") return `Every weekday at ${time}`;
+      if (dow === "0,6" || dow === "6,0") return `Every weekend day at ${time}`;
+      if (/^\d$/.test(dow)) return `Every ${DOW_NAMES[parseInt(dow, 10)]} at ${time}`;
+    }
+    if (/^\d+$/.test(dom) && month === "*" && dow === "*") {
+      return `Monthly on day ${dom} at ${time}`;
+    }
+  }
+  return expr;
+}
+var DAY_MS = 24 * 60 * 60 * 1e3;
+function checkAwayGuard(lastUserActivityMs, nowMs) {
+  const gap = nowMs - lastUserActivityMs;
+  if (gap > 14 * DAY_MS) return "pause";
+  if (gap > 7 * DAY_MS) return "ask";
+  return "ok";
+}
+function buildRoutinePrompt(routine, isTest) {
+  const header = isTest ? `This is a **test run** of your routine "${routine.name}". Test runs perform real work \u2014 treat it like a live run, and flag anything before doing something irreversible.` : `This is a **scheduled run** of your routine "${routine.name}" (${routine.cronExpr}, ${routine.timezone}).`;
+  return [
+    header,
+    "",
+    "If the source data is unavailable, report the failure instead of using old data.",
+    "",
+    "---",
+    "",
+    routine.instructionMd
+  ].join("\n");
+}
+var Scheduler = class {
+  constructor(deps) {
+    this.deps = deps;
+  }
+  deps;
+  tasks = /* @__PURE__ */ new Map();
+  paused = false;
+  /** Load every enabled routine and schedule it with node-cron. */
+  start() {
+    for (const routine of this.deps.store.listRoutines()) {
+      if (routine.enabled) this.scheduleRoutine(routine);
+    }
+  }
+  /** Cancel all scheduled tasks and release their timers. */
+  stop() {
+    for (const task of this.tasks.values()) {
+      task.stop();
+      void task.destroy();
+    }
+    this.tasks.clear();
+  }
+  /** Re-sync a single routine (call after create/update/delete/enable-toggle). */
+  reload(routineId) {
+    this.unschedule(routineId);
+    const routine = this.deps.store.getRoutine(routineId);
+    if (routine?.enabled && !this.paused) this.scheduleRoutine(routine);
+  }
+  /** Re-sync every routine from scratch. */
+  syncAll() {
+    this.stop();
+    this.start();
+  }
+  /** Pause every scheduled routine without forgetting its schedule (outline §8 away-guard). */
+  pauseAll() {
+    this.paused = true;
+    for (const task of this.tasks.values()) task.stop();
+  }
+  /** Resume every scheduled routine after a pause. */
+  resumeAll() {
+    this.paused = false;
+    for (const task of this.tasks.values()) task.start();
+  }
+  unschedule(routineId) {
+    const task = this.tasks.get(routineId);
+    if (!task) return;
+    task.stop();
+    void task.destroy();
+    this.tasks.delete(routineId);
+  }
+  scheduleRoutine(routine) {
+    if (!cron.validate(routine.cronExpr)) {
+      log.warn(`routine ${routine.id} has an invalid cron expression: "${routine.cronExpr}"`);
+      return;
+    }
+    const task = cron.schedule(
+      routine.cronExpr,
+      () => {
+        this.fire(routine.id, false);
+      },
+      { timezone: routine.timezone, unref: true }
+    );
+    if (this.paused) task.stop();
+    this.tasks.set(routine.id, task);
+    this.updateNextRunAt(routine);
+  }
+  updateNextRunAt(routine) {
+    const next = nextRunAt(routine.cronExpr, routine.timezone, Date.now());
+    this.deps.store.updateRoutine(routine.id, { nextRunAt: next });
+  }
+  /** Fire a routine now: starts a run record, publishes events, and enqueues the turn. */
+  fire(routineId, isTest) {
+    const { store, bus, manager } = this.deps;
+    const routine = store.getRoutine(routineId);
+    if (!routine) throw new Error(`Unknown routine: ${routineId}`);
+    const bot = store.getBot(routine.botId);
+    const run = store.startRun(routineId, isTest, bot?.threadId ?? void 0);
+    bus.publish({ type: "routine.run", threadId: bot?.threadId ?? null, botId: routine.botId, run });
+    const next = isTest ? routine.nextRunAt : nextRunAt(routine.cronExpr, routine.timezone, Date.now());
+    store.updateRoutine(routineId, { lastRunAt: run.startedAt, nextRunAt: next });
+    if (!bot || !bot.threadId) {
+      const failed = store.finishRun(run.id, "failed", "Owning bot no longer exists.");
+      if (failed) bus.publish({ type: "routine.run", threadId: null, botId: routine.botId, run: failed });
+      return run.id;
+    }
+    manager.enqueue({
+      botId: bot.id,
+      threadId: bot.threadId,
+      prompt: buildRoutinePrompt(routine, isTest),
+      origin: "routine",
+      hops: 0,
+      priority: 10,
+      onDone: (summary, ok) => {
+        const finished = store.finishRun(run.id, ok ? "ok" : "failed", summary);
+        if (finished) bus.publish({ type: "routine.run", threadId: bot.threadId, botId: routine.botId, run: finished });
+      }
+    });
+    return run.id;
+  }
+  /** Fire a routine immediately as a test run (real work, marked `isTest`). Returns the run id. */
+  testRun(routineId) {
+    return this.fire(routineId, true);
+  }
+  /**
+   * Apply the outline §8 away-guard: pause all routines beyond 14 days of inactivity, or notify
+   * asking whether to keep them running between 7 and 14 days.
+   */
+  checkAndApplyAwayGuard(lastUserActivityMs, nowMs = Date.now()) {
+    const result = checkAwayGuard(lastUserActivityMs, nowMs);
+    if (result === "pause") {
+      this.pauseAll();
+    } else if (result === "ask") {
+      this.deps.bus.publish({
+        type: "notify",
+        threadId: null,
+        botId: null,
+        title: "Still away?",
+        body: "It's been a while since you were last active. Keep routines running, or pause them?",
+        level: "warn"
+      });
+    }
+    return result;
+  }
+};
+export {
+  Scheduler,
+  buildRoutinePrompt,
+  checkAwayGuard,
+  cronToHuman,
+  nextRunAt,
+  parseCronExpr
+};
+//# sourceMappingURL=scheduler-Q7OHNGP6.js.map

package/dist/scheduler-Q7OHNGP6.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../packages/server/src/scheduler/scheduler.ts"],
+  "sourcesContent": ["import cron, { type ScheduledTask } from 'node-cron';\nimport type { Store } from '../db/store.js';\nimport type { EventBus } from '../util/bus.js';\nimport { logger } from '../util/log.js';\nimport type { Routine, Settings, TurnOrigin } from '@antbot/shared';\n\nconst log = logger('scheduler');\n\n/**\n * The subset of BotManager.enqueue the scheduler needs. Kept minimal and structural (rather than\n * importing BotManager directly) so tests can inject a fake manager without spawning real turns.\n */\nexport interface SchedulerEnqueueArgs {\n  botId: string;\n  threadId: string;\n  prompt: string;\n  origin: TurnOrigin;\n  hops: number;\n  priority?: number;\n  onDone?: (summary: string, ok: boolean) => void;\n}\nexport interface SchedulerManager {\n  enqueue(job: SchedulerEnqueueArgs): { id: string };\n}\n\nexport interface SchedulerDeps {\n  store: Store;\n  bus: EventBus;\n  manager: SchedulerManager;\n  getSettings: () => Settings;\n}\n\n/* ------------------------------- cron parsing ------------------------------- */\n\ninterface CronField {\n  values: Set<number>;\n  wildcard: boolean;\n}\n\ninterface ParsedCron {\n  minute: CronField;\n  hour: CronField;\n  dayOfMonth: CronField;\n  month: CronField;\n  dayOfWeek: CronField;\n}\n\nfunction parseCronFieldPart(field: string, min: number, max: number): CronField {\n  const trimmed = field.trim();\n  if (trimmed === '*') {\n    const values = new Set<number>();\n    for (let v = min; v <= max; v++) values.add(v);\n    return { values, wildcard: true };\n  }\n  const values = new Set<number>();\n  for (const part of trimmed.split(',')) {\n    const m = part.match(/^(\\*|\\d+)(?:-(\\d+))?(?:\\/(\\d+))?$/);\n    if (!m) throw new Error(`Invalid cron field: \"${part}\"`);\n    const [, startStr, endStr, stepStr] = m;\n    const step = stepStr ? parseInt(stepStr, 10) : 1;\n    let start: number;\n    let end: number;\n    if (startStr === '*') {\n      start = min;\n      end = max;\n    } else {\n      start = parseInt(startStr!, 10);\n      end = endStr !== undefined ? parseInt(endStr, 10) : stepStr ? max : start;\n    }\n    for (let v = start; v <= end; v += step) values.add(v);\n  }\n  return { values, wildcard: false };\n}\n\n/** Parse a standard 5-field cron expression (minute hour dom month dow). Pure, no I/O. */\nexport function parseCronExpr(expr: string): ParsedCron {\n  const parts = expr.trim().split(/\\s+/);\n  if (parts.length !== 5) throw new Error(`Cron expression must have 5 fields: \"${expr}\"`);\n  const [minute, hour, dayOfMonth, month, dayOfWeekRaw] = parts as [string, string, string, string, string];\n  const dayOfWeek = parseCronFieldPart(dayOfWeekRaw, 0, 7);\n  // normalize 7 (alt-Sunday) into 0\n  if (dayOfWeek.values.has(7)) {\n    dayOfWeek.values.delete(7);\n    dayOfWeek.values.add(0);\n  }\n  return {\n    minute: parseCronFieldPart(minute, 0, 59),\n    hour: parseCronFieldPart(hour, 0, 23),\n    dayOfMonth: parseCronFieldPart(dayOfMonth, 1, 31),\n    month: parseCronFieldPart(month, 1, 12),\n    dayOfWeek,\n  };\n}\n\ninterface TzParts {\n  month: number;\n  day: number;\n  hour: number;\n  minute: number;\n  weekday: number;\n}\n\nconst WEEKDAY_INDEX: Record<string, number> = { Sun: 0, Mon: 1, Tue: 2, Wed: 3, Thu: 4, Fri: 5, Sat: 6 };\n\nfunction makeTzFormatter(timeZone: string): Intl.DateTimeFormat {\n  return new Intl.DateTimeFormat('en-US', {\n    timeZone,\n    hour12: false,\n    month: '2-digit',\n    day: '2-digit',\n    hour: '2-digit',\n    minute: '2-digit',\n    weekday: 'short',\n  });\n}\n\nfunction tzParts(dtf: Intl.DateTimeFormat, ms: number): TzParts {\n  const parts = dtf.formatToParts(new Date(ms));\n  const map: Record<string, string> = {};\n  for (const p of parts) map[p.type] = p.value;\n  let hour = parseInt(map.hour ?? '0', 10);\n  if (hour === 24) hour = 0; // some ICU builds report midnight as \"24\" under hour12:false\n  return {\n    month: parseInt(map.month ?? '1', 10),\n    day: parseInt(map.day ?? '1', 10),\n    hour,\n    minute: parseInt(map.minute ?? '0', 10),\n    weekday: WEEKDAY_INDEX[map.weekday ?? 'Sun'] ?? 0,\n  };\n}\n\nconst MAX_LOOKAHEAD_MINUTES = 366 * 24 * 60;\n\n/**\n * Compute the next fire time (ms, strictly after `fromMs`) for a 5-field cron expression in a\n * given IANA timezone. Implemented by iterating minute-by-minute over a bounded window \u2014 no\n * dependency on node-cron internals. Returns null if nothing matches within 366 days.\n */\nexport function nextRunAt(cronExpr: string, timezone: string, fromMs: number): number | null {\n  const fields = parseCronExpr(cronExpr);\n  const dtf = makeTzFormatter(timezone);\n  const bothWildcard = fields.dayOfMonth.wildcard && fields.dayOfWeek.wildcard;\n\n  let t = Math.floor(fromMs / 60000) * 60000 + 60000;\n  for (let i = 0; i < MAX_LOOKAHEAD_MINUTES; i++, t += 60000) {\n    const p = tzParts(dtf, t);\n    if (!fields.minute.values.has(p.minute)) continue;\n    if (!fields.hour.values.has(p.hour)) continue;\n    if (!fields.month.values.has(p.month)) continue;\n    const domMatch = fields.dayOfMonth.values.has(p.day);\n    const dowMatch = fields.dayOfWeek.values.has(p.weekday);\n    const dayOk = bothWildcard\n      ? true\n      : fields.dayOfMonth.wildcard\n        ? dowMatch\n        : fields.dayOfWeek.wildcard\n          ? domMatch\n          : domMatch || dowMatch;\n    if (!dayOk) continue;\n    return t;\n  }\n  return null;\n}\n\n/* ------------------------------- human summary ------------------------------- */\n\nconst DOW_NAMES = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];\n\n/** Render a short human string for common cron shapes; falls back to the raw expression. */\nexport function cronToHuman(expr: string): string {\n  const parts = expr.trim().split(/\\s+/);\n  if (parts.length !== 5) return expr;\n  const [min, hour, dom, month, dow] = parts as [string, string, string, string, string];\n  const pad = (n: string): string => n.padStart(2, '0');\n\n  if (min.startsWith('*/') && hour === '*' && dom === '*' && month === '*' && dow === '*') {\n    return `Every ${min.slice(2)} minutes`;\n  }\n  if (hour.startsWith('*/') && min === '0' && dom === '*' && month === '*' && dow === '*') {\n    return `Every ${hour.slice(2)} hours`;\n  }\n  if (/^\\d+$/.test(min) && /^\\d+$/.test(hour)) {\n    const time = `${pad(hour)}:${pad(min)}`;\n    if (dom === '*' && month === '*') {\n      if (dow === '*') return `Every day at ${time}`;\n      if (dow === '1-5') return `Every weekday at ${time}`;\n      if (dow === '0,6' || dow === '6,0') return `Every weekend day at ${time}`;\n      if (/^\\d$/.test(dow)) return `Every ${DOW_NAMES[parseInt(dow, 10)]} at ${time}`;\n    }\n    if (/^\\d+$/.test(dom) && month === '*' && dow === '*') {\n      return `Monthly on day ${dom} at ${time}`;\n    }\n  }\n  return expr;\n}\n\n/* --------------------------------- away guard --------------------------------- */\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/**\n * Outline \u00A78: after a long absence, ask whether to keep routines running, and pause if there's\n * no response. `ok` under 7 days away, `ask` between 7 and 14 days, `pause` beyond 14 days.\n */\nexport function checkAwayGuard(lastUserActivityMs: number, nowMs: number): 'ok' | 'ask' | 'pause' {\n  const gap = nowMs - lastUserActivityMs;\n  if (gap > 14 * DAY_MS) return 'pause';\n  if (gap > 7 * DAY_MS) return 'ask';\n  return 'ok';\n}\n\n/* --------------------------------- prompt shape --------------------------------- */\n\n/** Build the turn prompt for a routine fire, per outline \u00A78 (naming + stale-data doctrine). */\nexport function buildRoutinePrompt(routine: Routine, isTest: boolean): string {\n  const header = isTest\n    ? `This is a **test run** of your routine \"${routine.name}\". Test runs perform real work \u2014 treat it like a live run, and flag anything before doing something irreversible.`\n    : `This is a **scheduled run** of your routine \"${routine.name}\" (${routine.cronExpr}, ${routine.timezone}).`;\n  return [\n    header,\n    '',\n    'If the source data is unavailable, report the failure instead of using old data.',\n    '',\n    '---',\n    '',\n    routine.instructionMd,\n  ].join('\\n');\n}\n\n/* ---------------------------------- scheduler ---------------------------------- */\n\nexport class Scheduler {\n  private tasks = new Map<string, ScheduledTask>();\n  private paused = false;\n\n  constructor(private deps: SchedulerDeps) {}\n\n  /** Load every enabled routine and schedule it with node-cron. */\n  start(): void {\n    for (const routine of this.deps.store.listRoutines()) {\n      if (routine.enabled) this.scheduleRoutine(routine);\n    }\n  }\n\n  /** Cancel all scheduled tasks and release their timers. */\n  stop(): void {\n    for (const task of this.tasks.values()) {\n      task.stop();\n      void task.destroy();\n    }\n    this.tasks.clear();\n  }\n\n  /** Re-sync a single routine (call after create/update/delete/enable-toggle). */\n  reload(routineId: string): void {\n    this.unschedule(routineId);\n    const routine = this.deps.store.getRoutine(routineId);\n    if (routine?.enabled && !this.paused) this.scheduleRoutine(routine);\n  }\n\n  /** Re-sync every routine from scratch. */\n  syncAll(): void {\n    this.stop();\n    this.start();\n  }\n\n  /** Pause every scheduled routine without forgetting its schedule (outline \u00A78 away-guard). */\n  pauseAll(): void {\n    this.paused = true;\n    for (const task of this.tasks.values()) task.stop();\n  }\n\n  /** Resume every scheduled routine after a pause. */\n  resumeAll(): void {\n    this.paused = false;\n    for (const task of this.tasks.values()) task.start();\n  }\n\n  private unschedule(routineId: string): void {\n    const task = this.tasks.get(routineId);\n    if (!task) return;\n    task.stop();\n    void task.destroy();\n    this.tasks.delete(routineId);\n  }\n\n  private scheduleRoutine(routine: Routine): void {\n    if (!cron.validate(routine.cronExpr)) {\n      log.warn(`routine ${routine.id} has an invalid cron expression: \"${routine.cronExpr}\"`);\n      return;\n    }\n    const task = cron.schedule(\n      routine.cronExpr,\n      () => {\n        this.fire(routine.id, false);\n      },\n      { timezone: routine.timezone, unref: true },\n    );\n    if (this.paused) task.stop();\n    this.tasks.set(routine.id, task);\n    this.updateNextRunAt(routine);\n  }\n\n  private updateNextRunAt(routine: Routine): void {\n    const next = nextRunAt(routine.cronExpr, routine.timezone, Date.now());\n    this.deps.store.updateRoutine(routine.id, { nextRunAt: next });\n  }\n\n  /** Fire a routine now: starts a run record, publishes events, and enqueues the turn. */\n  private fire(routineId: string, isTest: boolean): string {\n    const { store, bus, manager } = this.deps;\n    const routine = store.getRoutine(routineId);\n    if (!routine) throw new Error(`Unknown routine: ${routineId}`);\n\n    const bot = store.getBot(routine.botId);\n    const run = store.startRun(routineId, isTest, bot?.threadId ?? undefined);\n    bus.publish({ type: 'routine.run', threadId: bot?.threadId ?? null, botId: routine.botId, run });\n\n    const next = isTest ? routine.nextRunAt : nextRunAt(routine.cronExpr, routine.timezone, Date.now());\n    store.updateRoutine(routineId, { lastRunAt: run.startedAt, nextRunAt: next });\n\n    if (!bot || !bot.threadId) {\n      const failed = store.finishRun(run.id, 'failed', 'Owning bot no longer exists.');\n      if (failed) bus.publish({ type: 'routine.run', threadId: null, botId: routine.botId, run: failed });\n      return run.id;\n    }\n\n    manager.enqueue({\n      botId: bot.id,\n      threadId: bot.threadId,\n      prompt: buildRoutinePrompt(routine, isTest),\n      origin: 'routine',\n      hops: 0,\n      priority: 10,\n      onDone: (summary, ok) => {\n        const finished = store.finishRun(run.id, ok ? 'ok' : 'failed', summary);\n        if (finished) bus.publish({ type: 'routine.run', threadId: bot.threadId, botId: routine.botId, run: finished });\n      },\n    });\n\n    return run.id;\n  }\n\n  /** Fire a routine immediately as a test run (real work, marked `isTest`). Returns the run id. */\n  testRun(routineId: string): string {\n    return this.fire(routineId, true);\n  }\n\n  /**\n   * Apply the outline \u00A78 away-guard: pause all routines beyond 14 days of inactivity, or notify\n   * asking whether to keep them running between 7 and 14 days.\n   */\n  checkAndApplyAwayGuard(lastUserActivityMs: number, nowMs = Date.now()): 'ok' | 'ask' | 'pause' {\n    const result = checkAwayGuard(lastUserActivityMs, nowMs);\n    if (result === 'pause') {\n      this.pauseAll();\n    } else if (result === 'ask') {\n      this.deps.bus.publish({\n        type: 'notify',\n        threadId: null,\n        botId: null,\n        title: 'Still away?',\n        body: \"It's been a while since you were last active. Keep routines running, or pause them?\",\n        level: 'warn',\n      });\n    }\n    return result;\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["values"]
+}