@elizaos/plugin-scheduling 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/scheduled-task/escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/escalation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAChD,IAAI,IAAI,gBAAgB,EAAE,CAAC;CAC5B;AAED,wBAAgB,8BAA8B,IAAI,wBAAwB,CAuBzE;AAED,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAC/C,qBAAqB,EACrB,MAAM,CAKP,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAC/C,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAehC,CAAC;AAEH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,wBAAwB,GAC5B,IAAI,CAMN;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,wBAAwB,GACjC,gBAAgB,CAkBlB;AAED,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,GACvB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAc3E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAK3E"}

package/dist/scheduled-task/escalation.js

@@ -0,0 +1,99 @@
+function createEscalationLadderRegistry() {
+  const map = /* @__PURE__ */ new Map();
+  return {
+    register(ladder, opts) {
+      if (!ladder.ladderKey || typeof ladder.ladderKey !== "string") {
+        throw new Error(
+          "EscalationLadderRegistry.register: ladderKey required"
+        );
+      }
+      if (map.has(ladder.ladderKey) && !opts?.override) {
+        throw new Error(
+          `EscalationLadderRegistry.register: duplicate ladderKey "${ladder.ladderKey}"`
+        );
+      }
+      map.set(ladder.ladderKey, ladder);
+    },
+    get(key) {
+      return map.get(key) ?? null;
+    },
+    list() {
+      return Array.from(map.values());
+    }
+  };
+}
+const PRIORITY_DEFAULT_LADDER_KEYS = {
+  low: "priority_low_default",
+  medium: "priority_medium_default",
+  high: "priority_high_default"
+};
+const DEFAULT_ESCALATION_LADDERS = Object.freeze({
+  priority_low_default: { ladderKey: "priority_low_default", steps: [] },
+  priority_medium_default: {
+    ladderKey: "priority_medium_default",
+    steps: [{ delayMinutes: 30, channelKey: "in_app", intensity: "normal" }]
+  },
+  priority_high_default: {
+    ladderKey: "priority_high_default",
+    steps: [
+      { delayMinutes: 0, channelKey: "in_app", intensity: "soft" },
+      { delayMinutes: 15, channelKey: "push", intensity: "normal" },
+      { delayMinutes: 45, channelKey: "imessage", intensity: "urgent" }
+    ]
+  }
+});
+function registerDefaultEscalationLadders(reg) {
+  for (const ladder of Object.values(DEFAULT_ESCALATION_LADDERS)) {
+    if (!reg.get(ladder.ladderKey)) {
+      reg.register(ladder);
+    }
+  }
+}
+function resolveEffectiveLadder(task, registry) {
+  const explicit = task.escalation;
+  if (explicit?.steps && explicit.steps.length > 0) {
+    return { ladderKey: explicit.ladderKey ?? "inline", steps: explicit.steps };
+  }
+  if (explicit?.ladderKey) {
+    const named = registry.get(explicit.ladderKey);
+    if (named) return named;
+  }
+  const fallbackKey = PRIORITY_DEFAULT_LADDER_KEYS[task.priority];
+  const fallback = registry.get(fallbackKey);
+  if (fallback) return fallback;
+  return DEFAULT_ESCALATION_LADDERS[fallbackKey] ?? {
+    ladderKey: fallbackKey,
+    steps: []
+  };
+}
+function nextEscalationStep(ladder, cursor) {
+  const nextIdx = cursor.stepIndex + 1;
+  if (nextIdx >= ladder.steps.length) {
+    return null;
+  }
+  const step = ladder.steps[nextIdx];
+  if (!step) return null;
+  const lastMs = new Date(cursor.lastDispatchedAt).getTime();
+  const fireAtMs = lastMs + step.delayMinutes * 6e4;
+  return {
+    step,
+    nextStepIndex: nextIdx,
+    fireAtIso: new Date(fireAtMs).toISOString()
+  };
+}
+function resetLadderForSnooze(newFireAtIso) {
+  return {
+    stepIndex: -1,
+    lastDispatchedAt: newFireAtIso
+  };
+}
+export {
+  DEFAULT_ESCALATION_LADDERS,
+  PRIORITY_DEFAULT_LADDER_KEYS,
+  createEscalationLadderRegistry,
+  nextEscalationStep,
+  registerDefaultEscalationLadders,
+  resetLadderForSnooze,
+  resolveEffectiveLadder
+};
+//# sourceMappingURL=escalation.js.map

package/dist/scheduled-task/escalation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/scheduled-task/escalation.ts"],"sourcesContent":["/**\n * Escalation evaluator.\n *\n * Snooze policy: snooze RESETS the ladder to step 0 at the new fire time.\n * Default ladders by priority (when `escalation` is undefined):\n *   - low    → no ladder (single attempt)\n *   - medium → 1 retry @ 30 min\n *   - high   → 3-step cross-channel\n *\n * Callers may register additional named ladders that override\n * `priority_<level>_default` keys.\n */\n\nimport type {\n  EscalationStep,\n  ScheduledTask,\n  ScheduledTaskEscalation,\n  ScheduledTaskPriority,\n} from \"./types.js\";\n\nexport interface EscalationLadder {\n  ladderKey: string;\n  steps: EscalationStep[];\n}\n\nexport interface EscalationLadderRegistry {\n  register(ladder: EscalationLadder, opts?: { override?: boolean }): void;\n  get(ladderKey: string): EscalationLadder | null;\n  list(): EscalationLadder[];\n}\n\nexport function createEscalationLadderRegistry(): EscalationLadderRegistry {\n  const map = new Map<string, EscalationLadder>();\n  return {\n    register(ladder, opts) {\n      if (!ladder.ladderKey || typeof ladder.ladderKey !== \"string\") {\n        throw new Error(\n          \"EscalationLadderRegistry.register: ladderKey required\",\n        );\n      }\n      if (map.has(ladder.ladderKey) && !opts?.override) {\n        throw new Error(\n          `EscalationLadderRegistry.register: duplicate ladderKey \"${ladder.ladderKey}\"`,\n        );\n      }\n      map.set(ladder.ladderKey, ladder);\n    },\n    get(key) {\n      return map.get(key) ?? null;\n    },\n    list() {\n      return Array.from(map.values());\n    },\n  };\n}\n\nexport const PRIORITY_DEFAULT_LADDER_KEYS: Record<\n  ScheduledTaskPriority,\n  string\n> = {\n  low: \"priority_low_default\",\n  medium: \"priority_medium_default\",\n  high: \"priority_high_default\",\n};\n\nexport const DEFAULT_ESCALATION_LADDERS: Readonly<\n  Record<string, EscalationLadder>\n> = Object.freeze({\n  priority_low_default: { ladderKey: \"priority_low_default\", steps: [] },\n  priority_medium_default: {\n    ladderKey: \"priority_medium_default\",\n    steps: [{ delayMinutes: 30, channelKey: \"in_app\", intensity: \"normal\" }],\n  },\n  priority_high_default: {\n    ladderKey: \"priority_high_default\",\n    steps: [\n      { delayMinutes: 0, channelKey: \"in_app\", intensity: \"soft\" },\n      { delayMinutes: 15, channelKey: \"push\", intensity: \"normal\" },\n      { delayMinutes: 45, channelKey: \"imessage\", intensity: \"urgent\" },\n    ],\n  },\n});\n\nexport function registerDefaultEscalationLadders(\n  reg: EscalationLadderRegistry,\n): void {\n  for (const ladder of Object.values(DEFAULT_ESCALATION_LADDERS)) {\n    if (!reg.get(ladder.ladderKey)) {\n      reg.register(ladder);\n    }\n  }\n}\n\n/**\n * Resolve the effective ladder for a task. Inline `escalation.steps` win\n * over `escalation.ladderKey` resolution. If neither is set, the\n * priority-default ladder is returned.\n */\nexport function resolveEffectiveLadder(\n  task: ScheduledTask,\n  registry: EscalationLadderRegistry,\n): EscalationLadder {\n  const explicit: ScheduledTaskEscalation | undefined = task.escalation;\n  if (explicit?.steps && explicit.steps.length > 0) {\n    return { ladderKey: explicit.ladderKey ?? \"inline\", steps: explicit.steps };\n  }\n  if (explicit?.ladderKey) {\n    const named = registry.get(explicit.ladderKey);\n    if (named) return named;\n  }\n  const fallbackKey = PRIORITY_DEFAULT_LADDER_KEYS[task.priority];\n  const fallback = registry.get(fallbackKey);\n  if (fallback) return fallback;\n  return (\n    DEFAULT_ESCALATION_LADDERS[fallbackKey] ?? {\n      ladderKey: fallbackKey,\n      steps: [],\n    }\n  );\n}\n\nexport interface EscalationCursor {\n  /** Current step index. -1 = escalation has not started. */\n  stepIndex: number;\n  /** ISO of the most recent dispatch (or task fire for step -1). */\n  lastDispatchedAt: string;\n}\n\n/**\n * Compute the next escalation step (returns `null` when ladder exhausted).\n * `lastDispatchedAt` is the anchor for the next delay calculation.\n */\nexport function nextEscalationStep(\n  ladder: EscalationLadder,\n  cursor: EscalationCursor,\n): { step: EscalationStep; nextStepIndex: number; fireAtIso: string } | null {\n  const nextIdx = cursor.stepIndex + 1;\n  if (nextIdx >= ladder.steps.length) {\n    return null;\n  }\n  const step = ladder.steps[nextIdx];\n  if (!step) return null;\n  const lastMs = new Date(cursor.lastDispatchedAt).getTime();\n  const fireAtMs = lastMs + step.delayMinutes * 60_000;\n  return {\n    step,\n    nextStepIndex: nextIdx,\n    fireAtIso: new Date(fireAtMs).toISOString(),\n  };\n}\n\n/**\n * Snooze resets the ladder to step 0 at the new fire time.\n * Returns the cursor the runner should persist post-snooze.\n */\nexport function resetLadderForSnooze(newFireAtIso: string): EscalationCursor {\n  return {\n    stepIndex: -1,\n    lastDispatchedAt: newFireAtIso,\n  };\n}\n"],"mappings":"AA+BO,SAAS,iCAA2D;AACzE,QAAM,MAAM,oBAAI,IAA8B;AAC9C,SAAO;AAAA,IACL,SAAS,QAAQ,MAAM;AACrB,UAAI,CAAC,OAAO,aAAa,OAAO,OAAO,cAAc,UAAU;AAC7D,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AACA,UAAI,IAAI,IAAI,OAAO,SAAS,KAAK,CAAC,MAAM,UAAU;AAChD,cAAM,IAAI;AAAA,UACR,2DAA2D,OAAO,SAAS;AAAA,QAC7E;AAAA,MACF;AACA,UAAI,IAAI,OAAO,WAAW,MAAM;AAAA,IAClC;AAAA,IACA,IAAI,KAAK;AACP,aAAO,IAAI,IAAI,GAAG,KAAK;AAAA,IACzB;AAAA,IACA,OAAO;AACL,aAAO,MAAM,KAAK,IAAI,OAAO,CAAC;AAAA,IAChC;AAAA,EACF;AACF;AAEO,MAAM,+BAGT;AAAA,EACF,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AACR;AAEO,MAAM,6BAET,OAAO,OAAO;AAAA,EAChB,sBAAsB,EAAE,WAAW,wBAAwB,OAAO,CAAC,EAAE;AAAA,EACrE,yBAAyB;AAAA,IACvB,WAAW;AAAA,IACX,OAAO,CAAC,EAAE,cAAc,IAAI,YAAY,UAAU,WAAW,SAAS,CAAC;AAAA,EACzE;AAAA,EACA,uBAAuB;AAAA,IACrB,WAAW;AAAA,IACX,OAAO;AAAA,MACL,EAAE,cAAc,GAAG,YAAY,UAAU,WAAW,OAAO;AAAA,MAC3D,EAAE,cAAc,IAAI,YAAY,QAAQ,WAAW,SAAS;AAAA,MAC5D,EAAE,cAAc,IAAI,YAAY,YAAY,WAAW,SAAS;AAAA,IAClE;AAAA,EACF;AACF,CAAC;AAEM,SAAS,iCACd,KACM;AACN,aAAW,UAAU,OAAO,OAAO,0BAA0B,GAAG;AAC9D,QAAI,CAAC,IAAI,IAAI,OAAO,SAAS,GAAG;AAC9B,UAAI,SAAS,MAAM;AAAA,IACrB;AAAA,EACF;AACF;AAOO,SAAS,uBACd,MACA,UACkB;AAClB,QAAM,WAAgD,KAAK;AAC3D,MAAI,UAAU,SAAS,SAAS,MAAM,SAAS,GAAG;AAChD,WAAO,EAAE,WAAW,SAAS,aAAa,UAAU,OAAO,SAAS,MAAM;AAAA,EAC5E;AACA,MAAI,UAAU,WAAW;AACvB,UAAM,QAAQ,SAAS,IAAI,SAAS,SAAS;AAC7C,QAAI,MAAO,QAAO;AAAA,EACpB;AACA,QAAM,cAAc,6BAA6B,KAAK,QAAQ;AAC9D,QAAM,WAAW,SAAS,IAAI,WAAW;AACzC,MAAI,SAAU,QAAO;AACrB,SACE,2BAA2B,WAAW,KAAK;AAAA,IACzC,WAAW;AAAA,IACX,OAAO,CAAC;AAAA,EACV;AAEJ;AAaO,SAAS,mBACd,QACA,QAC2E;AAC3E,QAAM,UAAU,OAAO,YAAY;AACnC,MAAI,WAAW,OAAO,MAAM,QAAQ;AAClC,WAAO;AAAA,EACT;AACA,QAAM,OAAO,OAAO,MAAM,OAAO;AACjC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,SAAS,IAAI,KAAK,OAAO,gBAAgB,EAAE,QAAQ;AACzD,QAAM,WAAW,SAAS,KAAK,eAAe;AAC9C,SAAO;AAAA,IACL;AAAA,IACA,eAAe;AAAA,IACf,WAAW,IAAI,KAAK,QAAQ,EAAE,YAAY;AAAA,EAC5C;AACF;AAMO,SAAS,qBAAqB,cAAwC;AAC3E,SAAO;AAAA,IACL,WAAW;AAAA,IACX,kBAAkB;AAAA,EACpB;AACF;","names":[]}

package/dist/scheduled-task/gate-registry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * TaskGateRegistry. Built-in kinds: `weekend_skip`, `weekend_only`,
+ * `weekday_only`, `late_evening_skip`, `quiet_hours`, `during_travel`,
+ * `circadian_state_in`, `no_recent_user_message_in`,
+ * `personal_baseline_sufficient`.
+ *
+ * The runner uses these gates in `shouldFire.gates`; composition is
+ * the responsibility of the runner (`compose: "all" | "any" | "first_deny"`).
+ */
+import type { TaskGateContribution } from "./types.js";
+export interface TaskGateRegistry {
+    register(c: TaskGateContribution): void;
+    get(kind: string): TaskGateContribution | null;
+    list(): TaskGateContribution[];
+}
+export declare function createTaskGateRegistry(): TaskGateRegistry;
+export declare function registerBuiltInGates(reg: TaskGateRegistry): void;
+//# sourceMappingURL=gate-registry.d.ts.map

package/dist/scheduled-task/gate-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-registry.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/gate-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAGV,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAiSpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAAC;IAC/C,IAAI,IAAI,oBAAoB,EAAE,CAAC;CAChC;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAwBzD;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAUhE"}

package/dist/scheduled-task/gate-registry.js

@@ -0,0 +1,244 @@
+import { logger } from "@elizaos/core";
+const HHMM_PATTERN = /^([01]\d|2[0-3]):([0-5]\d)$/;
+function parseHHMM(value) {
+  if (typeof value !== "string") return null;
+  const match = HHMM_PATTERN.exec(value);
+  if (!match) return null;
+  return {
+    hours: Number.parseInt(match[1] ?? "0", 10),
+    minutes: Number.parseInt(match[2] ?? "0", 10)
+  };
+}
+function intInRange(value, min, max) {
+  return Number.isFinite(value) && value >= min && value <= max;
+}
+function localPartsAtTz(iso, tz) {
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return null;
+  try {
+    const formatter = new Intl.DateTimeFormat("en-US", {
+      timeZone: tz,
+      hour12: false,
+      hour: "2-digit",
+      minute: "2-digit",
+      weekday: "short"
+    });
+    const parts = formatter.formatToParts(date);
+    let hours = 0;
+    let minutes = 0;
+    let weekday = "Sun";
+    for (const part of parts) {
+      if (part.type === "hour") hours = Number.parseInt(part.value, 10) % 24;
+      else if (part.type === "minute")
+        minutes = Number.parseInt(part.value, 10);
+      else if (part.type === "weekday") weekday = part.value;
+    }
+    const map = {
+      Sun: 0,
+      Mon: 1,
+      Tue: 2,
+      Wed: 3,
+      Thu: 4,
+      Fri: 5,
+      Sat: 6
+    };
+    const dayOfWeek = map[weekday] ?? 0;
+    if (!intInRange(hours, 0, 23) || !intInRange(minutes, 0, 59)) return null;
+    return { hours, minutes, dayOfWeek };
+  } catch {
+    return null;
+  }
+}
+function localPartsForContext(context) {
+  const tz = context.ownerFacts.timezone ?? "UTC";
+  return localPartsAtTz(context.nowIso, tz) ?? localPartsAtTz(context.nowIso, "UTC") ?? {
+    hours: 0,
+    minutes: 0,
+    dayOfWeek: 0
+  };
+}
+function isWeekend(dayOfWeek) {
+  return dayOfWeek === 0 || dayOfWeek === 6;
+}
+const weekendSkipGate = {
+  kind: "weekend_skip",
+  evaluate(_task, context) {
+    const { dayOfWeek } = localPartsForContext(context);
+    if (!isWeekend(dayOfWeek)) {
+      return { kind: "allow" };
+    }
+    return { kind: "deny", reason: "weekend_skip: today is a weekend" };
+  }
+};
+const weekendOnlyGate = {
+  kind: "weekend_only",
+  evaluate(_task, context) {
+    const { dayOfWeek } = localPartsForContext(context);
+    if (isWeekend(dayOfWeek)) {
+      return { kind: "allow" };
+    }
+    return { kind: "deny", reason: "weekend_only: today is a weekday" };
+  }
+};
+const weekdayOnlyGate = {
+  kind: "weekday_only",
+  evaluate(_task, context) {
+    const { dayOfWeek } = localPartsForContext(context);
+    if (!isWeekend(dayOfWeek)) {
+      return { kind: "allow" };
+    }
+    return { kind: "deny", reason: "weekday_only: today is a weekend" };
+  }
+};
+const lateEveningSkipGate = {
+  kind: "late_evening_skip",
+  evaluate(_task, context) {
+    const params = context.task.shouldFire?.gates.find(
+      (g) => g.kind === "late_evening_skip"
+    )?.params ?? {};
+    const afterHour = intInRange(params.afterHour ?? -1, 0, 23) ? params.afterHour : 21;
+    const { hours } = localPartsForContext(context);
+    if (hours < afterHour) {
+      return { kind: "allow" };
+    }
+    return {
+      kind: "deny",
+      reason: `late_evening_skip: hour ${hours} >= ${afterHour}`
+    };
+  }
+};
+const quietHoursGate = {
+  kind: "quiet_hours",
+  evaluate(task, context) {
+    const params = context.task.shouldFire?.gates.find(
+      (g) => g.kind === "quiet_hours"
+    )?.params ?? {};
+    const highBypass = params.highPriorityBypass !== false;
+    if (highBypass && task.priority === "high") {
+      return { kind: "allow" };
+    }
+    const quietHours = context.ownerFacts.quietHours;
+    if (!quietHours) {
+      return { kind: "allow" };
+    }
+    const start = parseHHMM(quietHours.start);
+    const end = parseHHMM(quietHours.end);
+    if (!start || !end) {
+      return { kind: "allow" };
+    }
+    const local = localPartsAtTz(context.nowIso, quietHours.tz) ?? localPartsForContext(context);
+    const nowMinutes = local.hours * 60 + local.minutes;
+    const startMinutes = start.hours * 60 + start.minutes;
+    const endMinutes = end.hours * 60 + end.minutes;
+    let inWindow;
+    if (startMinutes <= endMinutes) {
+      inWindow = nowMinutes >= startMinutes && nowMinutes < endMinutes;
+    } else {
+      inWindow = nowMinutes >= startMinutes || nowMinutes < endMinutes;
+    }
+    if (!inWindow) {
+      return { kind: "allow" };
+    }
+    const minutesUntilEnd = startMinutes <= endMinutes ? endMinutes - nowMinutes : nowMinutes >= startMinutes ? 24 * 60 - nowMinutes + endMinutes : endMinutes - nowMinutes;
+    return {
+      kind: "defer",
+      until: { offsetMinutes: Math.max(1, minutesUntilEnd) },
+      reason: `quiet_hours: deferring ${minutesUntilEnd}m until ${quietHours.end}`
+    };
+  }
+};
+const duringTravelGate = {
+  kind: "during_travel",
+  evaluate(_task, context) {
+    if (context.ownerFacts.travelActive === true) {
+      return { kind: "allow" };
+    }
+    return { kind: "deny", reason: "during_travel: no active travel" };
+  }
+};
+function makeWarnOnceFallthroughGate(kind, remediation) {
+  let warned = false;
+  return {
+    kind,
+    evaluate() {
+      if (!warned) {
+        warned = true;
+        logger.warn(
+          { src: "lifeops:scheduled-task:gate-registry", gateKind: kind },
+          `Gate "${kind}" has no production reader registered; falling through to allow. ${remediation}`
+        );
+      }
+      return { kind: "allow" };
+    }
+  };
+}
+const circadianStateInGate = makeWarnOnceFallthroughGate(
+  "circadian_state_in",
+  "Register a circadian-state-aware contribution via TaskGateRegistry.register before plugin-health default packs load, or remove this gate from those packs."
+);
+const noRecentUserMessageInGate = makeWarnOnceFallthroughGate(
+  "no_recent_user_message_in",
+  "Register a message-activity-aware contribution via TaskGateRegistry.register, or remove this gate from default packs."
+);
+const personalBaselineSufficientGate = {
+  kind: "personal_baseline_sufficient",
+  evaluate(_task, context) {
+    const params = context.task.shouldFire?.gates.find(
+      (g) => g.kind === "personal_baseline_sufficient"
+    )?.params ?? {};
+    const minSamples = intInRange(params.minSamples ?? 1, 1, 1e4) ? params.minSamples ?? 1 : 1;
+    const sampleCount = context.ownerFacts.personalBaseline?.sampleCount;
+    if (typeof sampleCount !== "number" || !Number.isFinite(sampleCount)) {
+      return {
+        kind: "deny",
+        reason: "personal_baseline_sufficient: sample count unavailable"
+      };
+    }
+    if (sampleCount >= minSamples) {
+      return { kind: "allow" };
+    }
+    return {
+      kind: "deny",
+      reason: `personal_baseline_sufficient: sample count ${sampleCount} < ${minSamples}`
+    };
+  }
+};
+function createTaskGateRegistry() {
+  const map = /* @__PURE__ */ new Map();
+  const reg = {
+    register(c) {
+      if (!c.kind || typeof c.kind !== "string") {
+        throw new Error("TaskGateRegistry.register: kind required");
+      }
+      if (map.has(c.kind)) {
+        throw new Error(
+          `TaskGateRegistry.register: duplicate kind "${c.kind}"`
+        );
+      }
+      map.set(c.kind, c);
+    },
+    get(kind) {
+      return map.get(kind) ?? null;
+    },
+    list() {
+      return Array.from(map.values());
+    }
+  };
+  return reg;
+}
+function registerBuiltInGates(reg) {
+  reg.register(weekendSkipGate);
+  reg.register(weekendOnlyGate);
+  reg.register(weekdayOnlyGate);
+  reg.register(lateEveningSkipGate);
+  reg.register(quietHoursGate);
+  reg.register(duringTravelGate);
+  reg.register(circadianStateInGate);
+  reg.register(noRecentUserMessageInGate);
+  reg.register(personalBaselineSufficientGate);
+}
+export {
+  createTaskGateRegistry,
+  registerBuiltInGates
+};
+//# sourceMappingURL=gate-registry.js.map

package/dist/scheduled-task/gate-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/scheduled-task/gate-registry.ts"],"sourcesContent":["/**\n * TaskGateRegistry. Built-in kinds: `weekend_skip`, `weekend_only`,\n * `weekday_only`, `late_evening_skip`, `quiet_hours`, `during_travel`,\n * `circadian_state_in`, `no_recent_user_message_in`,\n * `personal_baseline_sufficient`.\n *\n * The runner uses these gates in `shouldFire.gates`; composition is\n * the responsibility of the runner (`compose: \"all\" | \"any\" | \"first_deny\"`).\n */\n\nimport { logger } from \"@elizaos/core\";\n\nimport type {\n  GateDecision,\n  GateEvaluationContext,\n  TaskGateContribution,\n} from \"./types.js\";\n\nconst HHMM_PATTERN = /^([01]\\d|2[0-3]):([0-5]\\d)$/;\n\nfunction parseHHMM(value: unknown): { hours: number; minutes: number } | null {\n  if (typeof value !== \"string\") return null;\n  const match = HHMM_PATTERN.exec(value);\n  if (!match) return null;\n  return {\n    hours: Number.parseInt(match[1] ?? \"0\", 10),\n    minutes: Number.parseInt(match[2] ?? \"0\", 10),\n  };\n}\n\nfunction intInRange(value: number, min: number, max: number): boolean {\n  return Number.isFinite(value) && value >= min && value <= max;\n}\n\n/**\n * Resolve the local hour/minute/dayOfWeek for the given iso instant in the\n * given IANA tz. Returns `null` if the timezone is invalid (caller falls\n * back to UTC reading).\n *\n * `dayOfWeek`: 0 = Sunday, 6 = Saturday.\n */\nfunction localPartsAtTz(\n  iso: string,\n  tz: string,\n): { hours: number; minutes: number; dayOfWeek: number } | null {\n  const date = new Date(iso);\n  if (Number.isNaN(date.getTime())) return null;\n  try {\n    const formatter = new Intl.DateTimeFormat(\"en-US\", {\n      timeZone: tz,\n      hour12: false,\n      hour: \"2-digit\",\n      minute: \"2-digit\",\n      weekday: \"short\",\n    });\n    const parts = formatter.formatToParts(date);\n    let hours = 0;\n    let minutes = 0;\n    let weekday = \"Sun\";\n    for (const part of parts) {\n      if (part.type === \"hour\") hours = Number.parseInt(part.value, 10) % 24;\n      else if (part.type === \"minute\")\n        minutes = Number.parseInt(part.value, 10);\n      else if (part.type === \"weekday\") weekday = part.value;\n    }\n    const map: Record<string, number> = {\n      Sun: 0,\n      Mon: 1,\n      Tue: 2,\n      Wed: 3,\n      Thu: 4,\n      Fri: 5,\n      Sat: 6,\n    };\n    const dayOfWeek = map[weekday] ?? 0;\n    if (!intInRange(hours, 0, 23) || !intInRange(minutes, 0, 59)) return null;\n    return { hours, minutes, dayOfWeek };\n  } catch {\n    return null;\n  }\n}\n\nfunction localPartsForContext(context: GateEvaluationContext): {\n  hours: number;\n  minutes: number;\n  dayOfWeek: number;\n} {\n  const tz = context.ownerFacts.timezone ?? \"UTC\";\n  return (\n    localPartsAtTz(context.nowIso, tz) ??\n    localPartsAtTz(context.nowIso, \"UTC\") ?? {\n      hours: 0,\n      minutes: 0,\n      dayOfWeek: 0,\n    }\n  );\n}\n\nfunction isWeekend(dayOfWeek: number): boolean {\n  return dayOfWeek === 0 || dayOfWeek === 6;\n}\n\n// ---------------------------------------------------------------------------\n// Built-in gate kinds\n// ---------------------------------------------------------------------------\n\n// Gates return `deny` to mark \"skipped\" — the runner translates that\n// into `state.status = \"skipped\"`. A `defer` would reschedule; weekend_skip\n// is meant to silently drop the fire.\nconst weekendSkipGate: TaskGateContribution = {\n  kind: \"weekend_skip\",\n  evaluate(_task, context): GateDecision {\n    const { dayOfWeek } = localPartsForContext(context);\n    if (!isWeekend(dayOfWeek)) {\n      return { kind: \"allow\" };\n    }\n    return { kind: \"deny\", reason: \"weekend_skip: today is a weekend\" };\n  },\n};\n\nconst weekendOnlyGate: TaskGateContribution = {\n  kind: \"weekend_only\",\n  evaluate(_task, context): GateDecision {\n    const { dayOfWeek } = localPartsForContext(context);\n    if (isWeekend(dayOfWeek)) {\n      return { kind: \"allow\" };\n    }\n    return { kind: \"deny\", reason: \"weekend_only: today is a weekday\" };\n  },\n};\n\nconst weekdayOnlyGate: TaskGateContribution = {\n  kind: \"weekday_only\",\n  evaluate(_task, context): GateDecision {\n    const { dayOfWeek } = localPartsForContext(context);\n    if (!isWeekend(dayOfWeek)) {\n      return { kind: \"allow\" };\n    }\n    return { kind: \"deny\", reason: \"weekday_only: today is a weekend\" };\n  },\n};\n\ninterface LateEveningSkipParams {\n  /** Hour-of-day (0-23) in owner timezone. Default 21 (9pm). */\n  afterHour?: number;\n}\n\nconst lateEveningSkipGate: TaskGateContribution = {\n  kind: \"late_evening_skip\",\n  evaluate(_task, context): GateDecision {\n    const params = (context.task.shouldFire?.gates.find(\n      (g) => g.kind === \"late_evening_skip\",\n    )?.params ?? {}) as LateEveningSkipParams;\n    const afterHour = intInRange(params.afterHour ?? -1, 0, 23)\n      ? (params.afterHour as number)\n      : 21;\n    const { hours } = localPartsForContext(context);\n    if (hours < afterHour) {\n      return { kind: \"allow\" };\n    }\n    return {\n      kind: \"deny\",\n      reason: `late_evening_skip: hour ${hours} >= ${afterHour}`,\n    };\n  },\n};\n\ninterface QuietHoursParams {\n  /** When true, `high` priority tasks bypass this gate. Default true. */\n  highPriorityBypass?: boolean;\n}\n\nconst quietHoursGate: TaskGateContribution = {\n  kind: \"quiet_hours\",\n  evaluate(task, context): GateDecision {\n    const params = (context.task.shouldFire?.gates.find(\n      (g) => g.kind === \"quiet_hours\",\n    )?.params ?? {}) as QuietHoursParams;\n    const highBypass = params.highPriorityBypass !== false;\n    if (highBypass && task.priority === \"high\") {\n      return { kind: \"allow\" };\n    }\n    const quietHours = context.ownerFacts.quietHours;\n    if (!quietHours) {\n      return { kind: \"allow\" };\n    }\n    const start = parseHHMM(quietHours.start);\n    const end = parseHHMM(quietHours.end);\n    if (!start || !end) {\n      return { kind: \"allow\" };\n    }\n    const local =\n      localPartsAtTz(context.nowIso, quietHours.tz) ??\n      localPartsForContext(context);\n    const nowMinutes = local.hours * 60 + local.minutes;\n    const startMinutes = start.hours * 60 + start.minutes;\n    const endMinutes = end.hours * 60 + end.minutes;\n\n    let inWindow: boolean;\n    if (startMinutes <= endMinutes) {\n      inWindow = nowMinutes >= startMinutes && nowMinutes < endMinutes;\n    } else {\n      // wraps midnight\n      inWindow = nowMinutes >= startMinutes || nowMinutes < endMinutes;\n    }\n    if (!inWindow) {\n      return { kind: \"allow\" };\n    }\n    // Defer to the next allowed window for low/medium tasks.\n    const minutesUntilEnd =\n      startMinutes <= endMinutes\n        ? endMinutes - nowMinutes\n        : nowMinutes >= startMinutes\n          ? 24 * 60 - nowMinutes + endMinutes\n          : endMinutes - nowMinutes;\n    return {\n      kind: \"defer\",\n      until: { offsetMinutes: Math.max(1, minutesUntilEnd) },\n      reason: `quiet_hours: deferring ${minutesUntilEnd}m until ${quietHours.end}`,\n    };\n  },\n};\n\nconst duringTravelGate: TaskGateContribution = {\n  kind: \"during_travel\",\n  evaluate(_task, context): GateDecision {\n    if (context.ownerFacts.travelActive === true) {\n      return { kind: \"allow\" };\n    }\n    return { kind: \"deny\", reason: \"during_travel: no active travel\" };\n  },\n};\n\n/**\n * `circadian_state_in` and `no_recent_user_message_in` are referenced by\n * plugin-health default packs but the concrete data readers (circadian state,\n * recent-user-message lookup) are not wired into the runner today. Until a\n * caller registers a real contribution (overwriting these), the gate falls\n * through to `allow` and logs a warning once per process so the operator can\n * see that the gate isn't doing what its name suggests. Loud > silent.\n */\nfunction makeWarnOnceFallthroughGate(\n  kind: string,\n  remediation: string,\n): TaskGateContribution {\n  let warned = false;\n  return {\n    kind,\n    evaluate(): GateDecision {\n      if (!warned) {\n        warned = true;\n        logger.warn(\n          { src: \"lifeops:scheduled-task:gate-registry\", gateKind: kind },\n          `Gate \"${kind}\" has no production reader registered; falling through to allow. ${remediation}`,\n        );\n      }\n      return { kind: \"allow\" };\n    },\n  };\n}\n\nconst circadianStateInGate = makeWarnOnceFallthroughGate(\n  \"circadian_state_in\",\n  \"Register a circadian-state-aware contribution via TaskGateRegistry.register before plugin-health default packs load, or remove this gate from those packs.\",\n);\n\nconst noRecentUserMessageInGate = makeWarnOnceFallthroughGate(\n  \"no_recent_user_message_in\",\n  \"Register a message-activity-aware contribution via TaskGateRegistry.register, or remove this gate from default packs.\",\n);\n\ninterface PersonalBaselineSufficientParams {\n  minSamples?: number;\n}\n\nconst personalBaselineSufficientGate: TaskGateContribution = {\n  kind: \"personal_baseline_sufficient\",\n  evaluate(_task, context): GateDecision {\n    const params = (context.task.shouldFire?.gates.find(\n      (g) => g.kind === \"personal_baseline_sufficient\",\n    )?.params ?? {}) as PersonalBaselineSufficientParams;\n    const minSamples = intInRange(params.minSamples ?? 1, 1, 10_000)\n      ? (params.minSamples ?? 1)\n      : 1;\n    const sampleCount = context.ownerFacts.personalBaseline?.sampleCount;\n    if (typeof sampleCount !== \"number\" || !Number.isFinite(sampleCount)) {\n      return {\n        kind: \"deny\",\n        reason: \"personal_baseline_sufficient: sample count unavailable\",\n      };\n    }\n    if (sampleCount >= minSamples) {\n      return { kind: \"allow\" };\n    }\n    return {\n      kind: \"deny\",\n      reason: `personal_baseline_sufficient: sample count ${sampleCount} < ${minSamples}`,\n    };\n  },\n};\n\n// ---------------------------------------------------------------------------\n// Registry\n// ---------------------------------------------------------------------------\n\nexport interface TaskGateRegistry {\n  register(c: TaskGateContribution): void;\n  get(kind: string): TaskGateContribution | null;\n  list(): TaskGateContribution[];\n}\n\nexport function createTaskGateRegistry(): TaskGateRegistry {\n  const map = new Map<string, TaskGateContribution>();\n  const reg: TaskGateRegistry = {\n    register(c) {\n      if (!c.kind || typeof c.kind !== \"string\") {\n        throw new Error(\"TaskGateRegistry.register: kind required\");\n      }\n      if (map.has(c.kind)) {\n        // Last-writer-wins is intentionally NOT allowed: prevents silent\n        // override. Callers should ensure no double-registration.\n        throw new Error(\n          `TaskGateRegistry.register: duplicate kind \"${c.kind}\"`,\n        );\n      }\n      map.set(c.kind, c);\n    },\n    get(kind) {\n      return map.get(kind) ?? null;\n    },\n    list() {\n      return Array.from(map.values());\n    },\n  };\n  return reg;\n}\n\nexport function registerBuiltInGates(reg: TaskGateRegistry): void {\n  reg.register(weekendSkipGate);\n  reg.register(weekendOnlyGate);\n  reg.register(weekdayOnlyGate);\n  reg.register(lateEveningSkipGate);\n  reg.register(quietHoursGate);\n  reg.register(duringTravelGate);\n  reg.register(circadianStateInGate);\n  reg.register(noRecentUserMessageInGate);\n  reg.register(personalBaselineSufficientGate);\n}\n"],"mappings":"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","names":[]}

package/dist/scheduled-task/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@elizaos/plugin-scheduling` — ScheduledTask spine.
+ *
+ * Public exports for cross-module consumers; this barrel re-exports the typed
+ * runner surface other plugins build against. The tick driver
+ * (`processDueScheduledTasks`) and the runner Service stay in the host
+ * (`@elizaos/plugin-personal-assistant`) during the decomposition; they move
+ * here in a later slice.
+ */
+export { type CompletionCheckRegistry, createCompletionCheckRegistry, registerBuiltInCompletionChecks, } from "./completion-check-registry.js";
+export { __anchorTestUtils, type AnchorRegistry, type ConsolidationRegistry, createAnchorRegistry, createConsolidationRegistry, registerFallbackAnchors, } from "./consolidation-policy.js";
+export { expectedReplyKindForTask, isCompletionTimeoutDue, isRecurringTrigger, isScheduledTaskDue, markWindowFireIfNeeded, pendingPromptRoomIdForTask, type ScheduledTaskDueContext, type ScheduledTaskDueDecision, } from "./due.js";
+export { createEscalationLadderRegistry, DEFAULT_ESCALATION_LADDERS, type EscalationCursor, type EscalationLadder, type EscalationLadderRegistry, nextEscalationStep, PRIORITY_DEFAULT_LADDER_KEYS, registerDefaultEscalationLadders, resetLadderForSnooze, resolveEffectiveLadder, } from "./escalation.js";
+export { createTaskGateRegistry, registerBuiltInGates, type TaskGateRegistry, } from "./gate-registry.js";
+export { computeNextFireAt } from "./next-fire-at.js";
+export { ChannelKeyError, createInMemoryScheduledTaskStore, createScheduledTaskRunner, type ScheduledTaskClaimResult, type ScheduledTaskDispatcher, type ScheduledTaskDispatchRecord, type ScheduledTaskFireResult, type ScheduledTaskRunnerDeps, type ScheduledTaskRunnerExtras, type ScheduledTaskRunnerHandle, type ScheduledTaskStore, type ScheduledTaskUpsertOptions, TestNoopScheduledTaskDispatcher, } from "./runner.js";
+export { createInMemoryScheduledTaskLogStore, createStateLogger, type ScheduledTaskLogStore, STATE_LOG_DEFAULT_RETENTION_DAYS, } from "./state-log.js";
+export type { ActivitySignalBusView, AnchorConsolidationMode, AnchorConsolidationPolicy, AnchorContext, AnchorContribution, CompletionCheckContext, CompletionCheckContribution, CompletionCheckParams, EscalationStep, EventFilter, GateCompose, GateDecision, GateEvaluationContext, GateParams, GlobalPauseView, OwnerFactsView, ScheduledTask, ScheduledTaskCompletionCheck, ScheduledTaskContextRequest, ScheduledTaskEscalation, ScheduledTaskFilter, ScheduledTaskGateRef, ScheduledTaskKind, ScheduledTaskLogEntry, ScheduledTaskLogTransition, ScheduledTaskOutput, ScheduledTaskOutputDestination, ScheduledTaskPipeline, ScheduledTaskPriority, ScheduledTaskRef, ScheduledTaskRunner, ScheduledTaskShouldFire, ScheduledTaskSource, ScheduledTaskState, ScheduledTaskStatus, ScheduledTaskSubject, ScheduledTaskSubjectKind, ScheduledTaskTrigger, ScheduledTaskVerb, SubjectStoreView, TaskExecutionProfile, TaskGateContribution, TerminalState, } from "./types.js";
+export { APPROVAL_DEFAULT_FOLLOWUP_AFTER_MINUTES, DEFAULT_TASK_EXECUTION_PROFILE, TASK_EXECUTION_PROFILES, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/scheduled-task/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,4BAA4B,EAC5B,gCAAgC,EAChC,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,eAAe,EACf,gCAAgC,EAChC,yBAAyB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,+BAA+B,GAChC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mCAAmC,EACnC,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,UAAU,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,8BAA8B,EAC9B,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,uCAAuC,EACvC,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/scheduled-task/index.js

@@ -0,0 +1,83 @@
+import {
+  createCompletionCheckRegistry,
+  registerBuiltInCompletionChecks
+} from "./completion-check-registry.js";
+import {
+  __anchorTestUtils,
+  createAnchorRegistry,
+  createConsolidationRegistry,
+  registerFallbackAnchors
+} from "./consolidation-policy.js";
+import {
+  expectedReplyKindForTask,
+  isCompletionTimeoutDue,
+  isRecurringTrigger,
+  isScheduledTaskDue,
+  markWindowFireIfNeeded,
+  pendingPromptRoomIdForTask
+} from "./due.js";
+import {
+  createEscalationLadderRegistry,
+  DEFAULT_ESCALATION_LADDERS,
+  nextEscalationStep,
+  PRIORITY_DEFAULT_LADDER_KEYS,
+  registerDefaultEscalationLadders,
+  resetLadderForSnooze,
+  resolveEffectiveLadder
+} from "./escalation.js";
+import {
+  createTaskGateRegistry,
+  registerBuiltInGates
+} from "./gate-registry.js";
+import { computeNextFireAt } from "./next-fire-at.js";
+import {
+  ChannelKeyError,
+  createInMemoryScheduledTaskStore,
+  createScheduledTaskRunner,
+  TestNoopScheduledTaskDispatcher
+} from "./runner.js";
+import {
+  createInMemoryScheduledTaskLogStore,
+  createStateLogger,
+  STATE_LOG_DEFAULT_RETENTION_DAYS
+} from "./state-log.js";
+import {
+  APPROVAL_DEFAULT_FOLLOWUP_AFTER_MINUTES,
+  DEFAULT_TASK_EXECUTION_PROFILE,
+  TASK_EXECUTION_PROFILES
+} from "./types.js";
+export {
+  APPROVAL_DEFAULT_FOLLOWUP_AFTER_MINUTES,
+  ChannelKeyError,
+  DEFAULT_ESCALATION_LADDERS,
+  DEFAULT_TASK_EXECUTION_PROFILE,
+  PRIORITY_DEFAULT_LADDER_KEYS,
+  STATE_LOG_DEFAULT_RETENTION_DAYS,
+  TASK_EXECUTION_PROFILES,
+  TestNoopScheduledTaskDispatcher,
+  __anchorTestUtils,
+  computeNextFireAt,
+  createAnchorRegistry,
+  createCompletionCheckRegistry,
+  createConsolidationRegistry,
+  createEscalationLadderRegistry,
+  createInMemoryScheduledTaskLogStore,
+  createInMemoryScheduledTaskStore,
+  createScheduledTaskRunner,
+  createStateLogger,
+  createTaskGateRegistry,
+  expectedReplyKindForTask,
+  isCompletionTimeoutDue,
+  isRecurringTrigger,
+  isScheduledTaskDue,
+  markWindowFireIfNeeded,
+  nextEscalationStep,
+  pendingPromptRoomIdForTask,
+  registerBuiltInCompletionChecks,
+  registerBuiltInGates,
+  registerDefaultEscalationLadders,
+  registerFallbackAnchors,
+  resetLadderForSnooze,
+  resolveEffectiveLadder
+};
+//# sourceMappingURL=index.js.map

package/dist/scheduled-task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/scheduled-task/index.ts"],"sourcesContent":["/**\n * `@elizaos/plugin-scheduling` — ScheduledTask spine.\n *\n * Public exports for cross-module consumers; this barrel re-exports the typed\n * runner surface other plugins build against. The tick driver\n * (`processDueScheduledTasks`) and the runner Service stay in the host\n * (`@elizaos/plugin-personal-assistant`) during the decomposition; they move\n * here in a later slice.\n */\n\nexport {\n  type CompletionCheckRegistry,\n  createCompletionCheckRegistry,\n  registerBuiltInCompletionChecks,\n} from \"./completion-check-registry.js\";\nexport {\n  __anchorTestUtils,\n  type AnchorRegistry,\n  type ConsolidationRegistry,\n  createAnchorRegistry,\n  createConsolidationRegistry,\n  registerFallbackAnchors,\n} from \"./consolidation-policy.js\";\nexport {\n  expectedReplyKindForTask,\n  isCompletionTimeoutDue,\n  isRecurringTrigger,\n  isScheduledTaskDue,\n  markWindowFireIfNeeded,\n  pendingPromptRoomIdForTask,\n  type ScheduledTaskDueContext,\n  type ScheduledTaskDueDecision,\n} from \"./due.js\";\nexport {\n  createEscalationLadderRegistry,\n  DEFAULT_ESCALATION_LADDERS,\n  type EscalationCursor,\n  type EscalationLadder,\n  type EscalationLadderRegistry,\n  nextEscalationStep,\n  PRIORITY_DEFAULT_LADDER_KEYS,\n  registerDefaultEscalationLadders,\n  resetLadderForSnooze,\n  resolveEffectiveLadder,\n} from \"./escalation.js\";\nexport {\n  createTaskGateRegistry,\n  registerBuiltInGates,\n  type TaskGateRegistry,\n} from \"./gate-registry.js\";\nexport { computeNextFireAt } from \"./next-fire-at.js\";\nexport {\n  ChannelKeyError,\n  createInMemoryScheduledTaskStore,\n  createScheduledTaskRunner,\n  type ScheduledTaskClaimResult,\n  type ScheduledTaskDispatcher,\n  type ScheduledTaskDispatchRecord,\n  type ScheduledTaskFireResult,\n  type ScheduledTaskRunnerDeps,\n  type ScheduledTaskRunnerExtras,\n  type ScheduledTaskRunnerHandle,\n  type ScheduledTaskStore,\n  type ScheduledTaskUpsertOptions,\n  TestNoopScheduledTaskDispatcher,\n} from \"./runner.js\";\nexport {\n  createInMemoryScheduledTaskLogStore,\n  createStateLogger,\n  type ScheduledTaskLogStore,\n  STATE_LOG_DEFAULT_RETENTION_DAYS,\n} from \"./state-log.js\";\nexport type {\n  ActivitySignalBusView,\n  AnchorConsolidationMode,\n  AnchorConsolidationPolicy,\n  AnchorContext,\n  AnchorContribution,\n  CompletionCheckContext,\n  CompletionCheckContribution,\n  CompletionCheckParams,\n  EscalationStep,\n  EventFilter,\n  GateCompose,\n  GateDecision,\n  GateEvaluationContext,\n  GateParams,\n  GlobalPauseView,\n  OwnerFactsView,\n  ScheduledTask,\n  ScheduledTaskCompletionCheck,\n  ScheduledTaskContextRequest,\n  ScheduledTaskEscalation,\n  ScheduledTaskFilter,\n  ScheduledTaskGateRef,\n  ScheduledTaskKind,\n  ScheduledTaskLogEntry,\n  ScheduledTaskLogTransition,\n  ScheduledTaskOutput,\n  ScheduledTaskOutputDestination,\n  ScheduledTaskPipeline,\n  ScheduledTaskPriority,\n  ScheduledTaskRef,\n  ScheduledTaskRunner,\n  ScheduledTaskShouldFire,\n  ScheduledTaskSource,\n  ScheduledTaskState,\n  ScheduledTaskStatus,\n  ScheduledTaskSubject,\n  ScheduledTaskSubjectKind,\n  ScheduledTaskTrigger,\n  ScheduledTaskVerb,\n  SubjectStoreView,\n  TaskExecutionProfile,\n  TaskGateContribution,\n  TerminalState,\n} from \"./types.js\";\n// Value constants from types.ts (the type-only re-export block below cannot\n// carry runtime values).\nexport {\n  APPROVAL_DEFAULT_FOLLOWUP_AFTER_MINUTES,\n  DEFAULT_TASK_EXECUTION_PROFILE,\n  TASK_EXECUTION_PROFILES,\n} from \"./types.js\";\n"],"mappings":"AAUA;AAAA,EAEE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EAIA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,yBAAyB;AAClC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAUA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AAgDP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/scheduled-task/next-fire-at.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Computes the indexed `next_fire_at` timestamp for a `ScheduledTask`.
+ *
+ * The scheduler tick (`processDueScheduledTasks`) filters by this column to
+ * avoid scanning every row in `life_scheduled_tasks` once per minute. The
+ * value is approximate — it is a "next candidate fire time" that the
+ * authoritative `isScheduledTaskDue` re-evaluates per task. Triggers that
+ * wake on external signals (`event`, `manual`, `after_task`) leave it NULL.
+ *
+ * Computed for: `once`, `cron`, `interval`, `relative_to_anchor`,
+ * `during_window`.
+ *
+ * Computed by the runner on every state mutation that can change the
+ * upcoming fire time: `schedule()`, `apply("snooze")`, `apply("edit")`, and
+ * the post-fire/post-skip persistence in `fire()`.
+ */
+import type { AnchorRegistry } from "../anchors/anchor-registry.js";
+import type { OwnerFactsView, ScheduledTask } from "./types.js";
+export interface ComputeNextFireAtContext {
+    now: Date;
+    ownerFacts: OwnerFactsView;
+    anchors?: AnchorRegistry | null;
+}
+/**
+ * Compute the next-fire-at timestamp for a task. Returns null when the
+ * trigger does not have a wall-clock fire time (event/manual/after_task)
+ * or when the inputs cannot be resolved (e.g. unknown anchor key).
+ *
+ * The function is async because anchor resolution may consult the runtime
+ * anchor registry (e.g. `wake.confirmed` reads the latest activity signal).
+ *
+ * Inputs:
+ *  - `task`: must have its current `trigger` and (post-fire) `state.firedAt`.
+ *  - `context.now`: clock used for forward-projecting cron/interval/window.
+ *
+ * Outputs an ISO string, never a Date — the caller writes directly to a
+ * Postgres timestamp column.
+ */
+export declare function computeNextFireAt(task: Pick<ScheduledTask, "trigger" | "state" | "metadata">, context: ComputeNextFireAtContext): Promise<string | null>;
+//# sourceMappingURL=next-fire-at.d.ts.map

package/dist/scheduled-task/next-fire-at.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-fire-at.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/next-fire-at.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEd,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,IAAI,CAAC;IACV,UAAU,EAAE,cAAc,CAAC;IAC3B,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACjC;AAkMD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC,EAC3D,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiDxB"}