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

package/dist/anchors/anchor-registry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Canonical AnchorRegistry binding for app-lifeops.
+ *
+ * The `AnchorRegistry` interface itself + the in-memory factory live in
+ * `../scheduled-task/consolidation-policy.ts`. This module:
+ *   1. Re-exports the canonical type + factory so app-lifeops has a single
+ *      `registries/anchor-registry.ts` import surface.
+ *   2. Adds per-runtime registration (mirrors `connectorRegistry`) so
+ *      consumers like `plugin-health` can call
+ *      `getAnchorRegistry(runtime).register(...)`.
+ *   3. Registers the built-in calendar / time-window anchors
+ *      (`meeting.ended`, `morning.start`, `lunch.start`, `night.start`).
+ *
+ * `wake.observed`, `wake.confirmed`, `bedtime.target`, `nap.start` are
+ * registered by `@elizaos/plugin-health` against this same registry through
+ * its `registerHealthAnchors(runtime)` entry point.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { AnchorRegistry } from "../scheduled-task/consolidation-policy.js";
+import type { AnchorContribution } from "../scheduled-task/types.js";
+export type { AnchorRegistry } from "../scheduled-task/consolidation-policy.js";
+export { createAnchorRegistry } from "../scheduled-task/consolidation-policy.js";
+export type { AnchorContext, AnchorContribution, } from "../scheduled-task/types.js";
+export declare const APP_LIFEOPS_ANCHORS: readonly AnchorContribution[];
+/**
+ * Register the built-in calendar / time-window anchors. Idempotent via
+ * `override: true` so repeated calls (e.g. test setup) don't throw.
+ */
+export declare function registerAppLifeOpsAnchors(registry: AnchorRegistry): void;
+export declare function registerAnchorRegistry(runtime: IAgentRuntime, registry: AnchorRegistry): void;
+export declare function getAnchorRegistry(runtime: IAgentRuntime): AnchorRegistry | null;
+export declare function __resetAnchorRegistryForTests(runtime: IAgentRuntime): void;
+//# sourceMappingURL=anchor-registry.d.ts.map

package/dist/anchors/anchor-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-registry.d.ts","sourceRoot":"","sources":["../../src/anchors/anchor-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,YAAY,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAmIpC,eAAO,MAAM,mBAAmB,EAAE,SAAS,kBAAkB,EAK5D,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAIxE;AAQD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,GACvB,IAAI,CAEN;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,GACrB,cAAc,GAAG,IAAI,CAEvB;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE1E"}

package/dist/anchors/anchor-registry.js

@@ -0,0 +1,129 @@
+import { createAnchorRegistry } from "../scheduled-task/consolidation-policy.js";
+function nullableTimeAnchor(args) {
+  const { anchorKey, label, windowKey, edge } = args;
+  return {
+    anchorKey,
+    describe: {
+      label,
+      provider: "@elizaos/plugin-personal-assistant:time-window"
+    },
+    resolve(context) {
+      const tz = context.ownerFacts.timezone ?? "UTC";
+      const window = context.ownerFacts[windowKey];
+      const value = edge === "start" ? window?.start : window?.end;
+      if (!value) return null;
+      return resolveLocalHHMM(context.nowIso, value, tz);
+    }
+  };
+}
+function resolveLocalHHMM(nowIso, hhmm, tz) {
+  const match = /^([01]\d|2[0-3]):([0-5]\d)$/.exec(hhmm);
+  if (!match) return null;
+  const hour = Number.parseInt(match[1] ?? "0", 10);
+  const minute = Number.parseInt(match[2] ?? "0", 10);
+  const formatter = new Intl.DateTimeFormat("en-CA", {
+    timeZone: tz,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  });
+  const parts = formatter.formatToParts(new Date(nowIso));
+  const y = Number.parseInt(
+    parts.find((p) => p.type === "year")?.value ?? "1970",
+    10
+  );
+  const mo = Number.parseInt(
+    parts.find((p) => p.type === "month")?.value ?? "01",
+    10
+  );
+  const d = Number.parseInt(
+    parts.find((p) => p.type === "day")?.value ?? "01",
+    10
+  );
+  const localDate = new Date(Date.UTC(y, mo - 1, d, hour, minute, 0));
+  const offsetFormatter = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    timeZoneName: "longOffset",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    hour12: false
+  });
+  const tzParts = offsetFormatter.formatToParts(localDate);
+  const offsetStr = tzParts.find((p) => p.type === "timeZoneName")?.value ?? "GMT";
+  const offsetMatch = /GMT([+-]\d{1,2})(?::?(\d{2}))?/.exec(offsetStr);
+  let offsetMinutes = 0;
+  if (offsetMatch) {
+    const sign = offsetMatch[1]?.startsWith("-") ? -1 : 1;
+    const oh = Math.abs(Number.parseInt(offsetMatch[1] ?? "0", 10));
+    const om = Number.parseInt(offsetMatch[2] ?? "0", 10);
+    offsetMinutes = sign * (oh * 60 + om);
+  }
+  const atMs = localDate.getTime() - offsetMinutes * 6e4;
+  return { atIso: new Date(atMs).toISOString() };
+}
+const morningStartAnchor = nullableTimeAnchor({
+  anchorKey: "morning.start",
+  label: "Owner morning window start (ownerFact.morningWindow.start)",
+  windowKey: "morningWindow",
+  edge: "start"
+});
+const nightStartAnchor = nullableTimeAnchor({
+  anchorKey: "night.start",
+  label: "Owner evening / wind-down window start (ownerFact.eveningWindow.start)",
+  windowKey: "eveningWindow",
+  edge: "start"
+});
+const lunchStartAnchor = {
+  anchorKey: "lunch.start",
+  describe: {
+    label: "Owner lunch window start (default 12:00 local)",
+    provider: "@elizaos/plugin-personal-assistant:time-window"
+  },
+  resolve(context) {
+    const tz = context.ownerFacts.timezone ?? "UTC";
+    return resolveLocalHHMM(context.nowIso, "12:00", tz);
+  }
+};
+const meetingEndedAnchor = {
+  anchorKey: "meeting.ended",
+  describe: {
+    label: "Calendar meeting ended (event-driven; resolves via bus)",
+    provider: "@elizaos/plugin-personal-assistant:calendar"
+  },
+  resolve() {
+    return null;
+  }
+};
+const APP_LIFEOPS_ANCHORS = [
+  morningStartAnchor,
+  lunchStartAnchor,
+  nightStartAnchor,
+  meetingEndedAnchor
+];
+function registerAppLifeOpsAnchors(registry) {
+  for (const anchor of APP_LIFEOPS_ANCHORS) {
+    registry.register(anchor, { override: true });
+  }
+}
+const registries = /* @__PURE__ */ new WeakMap();
+function registerAnchorRegistry(runtime, registry) {
+  registries.set(runtime, registry);
+}
+function getAnchorRegistry(runtime) {
+  return registries.get(runtime) ?? null;
+}
+function __resetAnchorRegistryForTests(runtime) {
+  registries.delete(runtime);
+}
+export {
+  APP_LIFEOPS_ANCHORS,
+  __resetAnchorRegistryForTests,
+  createAnchorRegistry,
+  getAnchorRegistry,
+  registerAnchorRegistry,
+  registerAppLifeOpsAnchors
+};
+//# sourceMappingURL=anchor-registry.js.map

package/dist/anchors/anchor-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/anchors/anchor-registry.ts"],"sourcesContent":["/**\n * Canonical AnchorRegistry binding for app-lifeops.\n *\n * The `AnchorRegistry` interface itself + the in-memory factory live in\n * `../scheduled-task/consolidation-policy.ts`. This module:\n *   1. Re-exports the canonical type + factory so app-lifeops has a single\n *      `registries/anchor-registry.ts` import surface.\n *   2. Adds per-runtime registration (mirrors `connectorRegistry`) so\n *      consumers like `plugin-health` can call\n *      `getAnchorRegistry(runtime).register(...)`.\n *   3. Registers the built-in calendar / time-window anchors\n *      (`meeting.ended`, `morning.start`, `lunch.start`, `night.start`).\n *\n * `wake.observed`, `wake.confirmed`, `bedtime.target`, `nap.start` are\n * registered by `@elizaos/plugin-health` against this same registry through\n * its `registerHealthAnchors(runtime)` entry point.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport type { AnchorRegistry } from \"../scheduled-task/consolidation-policy.js\";\nimport type {\n  AnchorContext,\n  AnchorContribution,\n} from \"../scheduled-task/types.js\";\n\nexport type { AnchorRegistry } from \"../scheduled-task/consolidation-policy.js\";\nexport { createAnchorRegistry } from \"../scheduled-task/consolidation-policy.js\";\nexport type {\n  AnchorContext,\n  AnchorContribution,\n} from \"../scheduled-task/types.js\";\n\n// Built-in anchor contributions (calendar + time windows).\n\nfunction nullableTimeAnchor(args: {\n  anchorKey: string;\n  label: string;\n  windowKey: \"morningWindow\" | \"eveningWindow\";\n  edge: \"start\" | \"end\";\n}): AnchorContribution {\n  const { anchorKey, label, windowKey, edge } = args;\n  return {\n    anchorKey,\n    describe: {\n      label,\n      provider: \"@elizaos/plugin-personal-assistant:time-window\",\n    },\n    resolve(context: AnchorContext) {\n      const tz = context.ownerFacts.timezone ?? \"UTC\";\n      const window = context.ownerFacts[windowKey];\n      const value = edge === \"start\" ? window?.start : window?.end;\n      if (!value) return null;\n      return resolveLocalHHMM(context.nowIso, value, tz);\n    },\n  };\n}\n\nfunction resolveLocalHHMM(\n  nowIso: string,\n  hhmm: string,\n  tz: string,\n): { atIso: string } | null {\n  const match = /^([01]\\d|2[0-3]):([0-5]\\d)$/.exec(hhmm);\n  if (!match) return null;\n  const hour = Number.parseInt(match[1] ?? \"0\", 10);\n  const minute = Number.parseInt(match[2] ?? \"0\", 10);\n  const formatter = new Intl.DateTimeFormat(\"en-CA\", {\n    timeZone: tz,\n    year: \"numeric\",\n    month: \"2-digit\",\n    day: \"2-digit\",\n  });\n  const parts = formatter.formatToParts(new Date(nowIso));\n  const y = Number.parseInt(\n    parts.find((p) => p.type === \"year\")?.value ?? \"1970\",\n    10,\n  );\n  const mo = Number.parseInt(\n    parts.find((p) => p.type === \"month\")?.value ?? \"01\",\n    10,\n  );\n  const d = Number.parseInt(\n    parts.find((p) => p.type === \"day\")?.value ?? \"01\",\n    10,\n  );\n  const localDate = new Date(Date.UTC(y, mo - 1, d, hour, minute, 0));\n  const offsetFormatter = new Intl.DateTimeFormat(\"en-US\", {\n    timeZone: tz,\n    timeZoneName: \"longOffset\",\n    year: \"numeric\",\n    month: \"2-digit\",\n    day: \"2-digit\",\n    hour: \"2-digit\",\n    minute: \"2-digit\",\n    hour12: false,\n  });\n  const tzParts = offsetFormatter.formatToParts(localDate);\n  const offsetStr =\n    tzParts.find((p) => p.type === \"timeZoneName\")?.value ?? \"GMT\";\n  const offsetMatch = /GMT([+-]\\d{1,2})(?::?(\\d{2}))?/.exec(offsetStr);\n  let offsetMinutes = 0;\n  if (offsetMatch) {\n    const sign = offsetMatch[1]?.startsWith(\"-\") ? -1 : 1;\n    const oh = Math.abs(Number.parseInt(offsetMatch[1] ?? \"0\", 10));\n    const om = Number.parseInt(offsetMatch[2] ?? \"0\", 10);\n    offsetMinutes = sign * (oh * 60 + om);\n  }\n  const atMs = localDate.getTime() - offsetMinutes * 60_000;\n  return { atIso: new Date(atMs).toISOString() };\n}\n\nconst morningStartAnchor: AnchorContribution = nullableTimeAnchor({\n  anchorKey: \"morning.start\",\n  label: \"Owner morning window start (ownerFact.morningWindow.start)\",\n  windowKey: \"morningWindow\",\n  edge: \"start\",\n});\n\nconst nightStartAnchor: AnchorContribution = nullableTimeAnchor({\n  anchorKey: \"night.start\",\n  label:\n    \"Owner evening / wind-down window start (ownerFact.eveningWindow.start)\",\n  windowKey: \"eveningWindow\",\n  edge: \"start\",\n});\n\n/**\n * `lunch.start` — local 12:00 in the owner's timezone. There is no\n * `lunchWindow` field on `OwnerFactsView`; this default approximates what\n * the planner currently assumes when scheduling lunch-time prompts.\n */\nconst lunchStartAnchor: AnchorContribution = {\n  anchorKey: \"lunch.start\",\n  describe: {\n    label: \"Owner lunch window start (default 12:00 local)\",\n    provider: \"@elizaos/plugin-personal-assistant:time-window\",\n  },\n  resolve(context) {\n    const tz = context.ownerFacts.timezone ?? \"UTC\";\n    return resolveLocalHHMM(context.nowIso, \"12:00\", tz);\n  },\n};\n\n/**\n * `meeting.ended` — the next concrete resolution time isn't known until a\n * meeting fires (event-driven, not time-driven). The anchor returns `null`\n * here; the calendar emitter publishes a bus event that the runner picks up\n * via `trigger.kind = \"event\"`. The anchor entry exists so the registry\n * lists `meeting.ended` as a known anchor for diagnostics + plan validation.\n */\nconst meetingEndedAnchor: AnchorContribution = {\n  anchorKey: \"meeting.ended\",\n  describe: {\n    label: \"Calendar meeting ended (event-driven; resolves via bus)\",\n    provider: \"@elizaos/plugin-personal-assistant:calendar\",\n  },\n  resolve() {\n    return null;\n  },\n};\n\nexport const APP_LIFEOPS_ANCHORS: readonly AnchorContribution[] = [\n  morningStartAnchor,\n  lunchStartAnchor,\n  nightStartAnchor,\n  meetingEndedAnchor,\n];\n\n/**\n * Register the built-in calendar / time-window anchors. Idempotent via\n * `override: true` so repeated calls (e.g. test setup) don't throw.\n */\nexport function registerAppLifeOpsAnchors(registry: AnchorRegistry): void {\n  for (const anchor of APP_LIFEOPS_ANCHORS) {\n    registry.register(anchor, { override: true });\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Per-runtime registration\n// ---------------------------------------------------------------------------\n\nconst registries = new WeakMap<IAgentRuntime, AnchorRegistry>();\n\nexport function registerAnchorRegistry(\n  runtime: IAgentRuntime,\n  registry: AnchorRegistry,\n): void {\n  registries.set(runtime, registry);\n}\n\nexport function getAnchorRegistry(\n  runtime: IAgentRuntime,\n): AnchorRegistry | null {\n  return registries.get(runtime) ?? null;\n}\n\nexport function __resetAnchorRegistryForTests(runtime: IAgentRuntime): void {\n  registries.delete(runtime);\n}\n"],"mappings":"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","names":[]}

package/dist/dispatch-types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Dispatch result contract for the scheduling spine.
+ *
+ * The runner is storage- and transport-agnostic: it only needs the *shape* of a
+ * dispatch outcome to drive its dispatch policy (advance-escalation /
+ * retry-with-backoff / fail-loud / queue-for-recovery) without inspecting the
+ * concrete error. The connector layer that actually sends (owned by the host,
+ * e.g. `@elizaos/plugin-personal-assistant`) produces values of this type.
+ *
+ * Reason taxonomy:
+ * - `disconnected` — connector currently has no live session.
+ * - `rate_limited` — transport refused due to per-window throttle; SHOULD also
+ *   populate `retryAfterMinutes`.
+ * - `auth_expired` — credentials expired; the user must re-authorize.
+ * - `unknown_recipient` — the target identity does not resolve.
+ * - `transport_error` — generic infrastructure failure (network, 5xx, timeout).
+ */
+export type DispatchResult = {
+    ok: true;
+    messageId?: string;
+} | {
+    ok: false;
+    reason: "disconnected" | "rate_limited" | "auth_expired" | "unknown_recipient" | "transport_error";
+    retryAfterMinutes?: number;
+    userActionable: boolean;
+    message?: string;
+};
+//# sourceMappingURL=dispatch-types.d.ts.map

package/dist/dispatch-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-types.d.ts","sourceRoot":"","sources":["../src/dispatch-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EACF,cAAc,GACd,cAAc,GACd,cAAc,GACd,mBAAmB,GACnB,iBAAiB,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/dispatch-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=dispatch-types.js.map

package/dist/dispatch-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { __resetAnchorRegistryForTests, APP_LIFEOPS_ANCHORS, getAnchorRegistry, registerAnchorRegistry, registerAppLifeOpsAnchors, } from "./anchors/anchor-registry.js";
+export type { DispatchResult } from "./dispatch-types.js";
+export { schedulingPlugin } from "./plugin.js";
+export * from "./scheduled-task/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+import {
+  __resetAnchorRegistryForTests,
+  APP_LIFEOPS_ANCHORS,
+  getAnchorRegistry,
+  registerAnchorRegistry,
+  registerAppLifeOpsAnchors
+} from "./anchors/anchor-registry.js";
+import { schedulingPlugin } from "./plugin.js";
+export * from "./scheduled-task/index.js";
+export {
+  APP_LIFEOPS_ANCHORS,
+  __resetAnchorRegistryForTests,
+  getAnchorRegistry,
+  registerAnchorRegistry,
+  registerAppLifeOpsAnchors,
+  schedulingPlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// The spine barrel (scheduled-task/index) already re-exports AnchorRegistry +\n// createAnchorRegistry from consolidation-policy, so surface only the\n// anchor-registry's own symbols here to avoid a duplicate-export collision.\nexport {\n  __resetAnchorRegistryForTests,\n  APP_LIFEOPS_ANCHORS,\n  getAnchorRegistry,\n  registerAnchorRegistry,\n  registerAppLifeOpsAnchors,\n} from \"./anchors/anchor-registry.js\";\nexport type { DispatchResult } from \"./dispatch-types.js\";\nexport { schedulingPlugin } from \"./plugin.js\";\nexport * from \"./scheduled-task/index.js\";\n"],"mappings":"AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,wBAAwB;AACjC,cAAc;","names":[]}

package/dist/plugin.d.ts

@@ -0,0 +1,17 @@
+import type { Plugin } from "@elizaos/core";
+/**
+ * `@elizaos/plugin-scheduling` — the scheduling spine.
+ *
+ * During the LifeOps decomposition this package owns the storage-agnostic
+ * ScheduledTask state machine (types, runner, registries, due/next-fire-at
+ * math, anchors) and the spine→reminders ports. Persistence and the
+ * owner/channel/connector dependencies are INJECTED by the host
+ * (`@elizaos/plugin-personal-assistant`), which remains the registrar of the
+ * runner service + the SCHEDULED_TASKS action during the decomposition. This
+ * Plugin object is exported for standalone use; the runtime first-wins dedup
+ * prevents double-registration when PA also registers the spine.
+ *
+ * See `plugins/plugin-personal-assistant/docs/lifeops-extraction-plan.md`.
+ */
+export declare const schedulingPlugin: Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAI9B,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,8 @@
+const schedulingPlugin = {
+  name: "@elizaos/plugin-scheduling",
+  description: "Scheduling spine: the storage-agnostic ScheduledTask state machine + registries + runner. Persistence and owner/channel deps are injected by the host."
+};
+export {
+  schedulingPlugin
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { Plugin } from \"@elizaos/core\";\n\n/**\n * `@elizaos/plugin-scheduling` — the scheduling spine.\n *\n * During the LifeOps decomposition this package owns the storage-agnostic\n * ScheduledTask state machine (types, runner, registries, due/next-fire-at\n * math, anchors) and the spine→reminders ports. Persistence and the\n * owner/channel/connector dependencies are INJECTED by the host\n * (`@elizaos/plugin-personal-assistant`), which remains the registrar of the\n * runner service + the SCHEDULED_TASKS action during the decomposition. This\n * Plugin object is exported for standalone use; the runtime first-wins dedup\n * prevents double-registration when PA also registers the spine.\n *\n * See `plugins/plugin-personal-assistant/docs/lifeops-extraction-plan.md`.\n */\nexport const schedulingPlugin: Plugin = {\n  name: \"@elizaos/plugin-scheduling\",\n  description:\n    \"Scheduling spine: the storage-agnostic ScheduledTask state machine + registries + runner. Persistence and owner/channel deps are injected by the host.\",\n};\n"],"mappings":"AAgBO,MAAM,mBAA2B;AAAA,EACtC,MAAM;AAAA,EACN,aACE;AACJ;","names":[]}

package/dist/scheduled-task/completion-check-registry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * CompletionCheckRegistry. Built-in kinds:
+ *   - `user_acknowledged`
+ *   - `user_replied_within { lookbackMinutes, requireSinceTaskFired }`
+ *   - `subject_updated`
+ *   - `health_signal_observed { signalKind, lookbackMinutes, requireSinceTaskFired }`
+ *
+ * Each check returns a boolean — `true` means the runner moves the task
+ * to `completed` (and fires `pipeline.onComplete`).
+ */
+import type { CompletionCheckContribution } from "./types.js";
+export interface CompletionCheckRegistry {
+    register(c: CompletionCheckContribution): void;
+    get(kind: string): CompletionCheckContribution | null;
+    list(): CompletionCheckContribution[];
+}
+export declare function createCompletionCheckRegistry(): CompletionCheckRegistry;
+export declare function registerBuiltInCompletionChecks(reg: CompletionCheckRegistry): void;
+//# sourceMappingURL=completion-check-registry.d.ts.map

package/dist/scheduled-task/completion-check-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-check-registry.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/completion-check-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAEV,2BAA2B,EAE5B,MAAM,YAAY,CAAC;AAqHpB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,GAAG,IAAI,CAAC;IACtD,IAAI,IAAI,2BAA2B,EAAE,CAAC;CACvC;AAED,wBAAgB,6BAA6B,IAAI,uBAAuB,CAqBvE;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,uBAAuB,GAC3B,IAAI,CAKN"}

package/dist/scheduled-task/completion-check-registry.js

@@ -0,0 +1,113 @@
+function paramsForCheck(task, kind) {
+  if (task.completionCheck?.kind === kind) {
+    return task.completionCheck.params;
+  }
+  return void 0;
+}
+function isoMinusMinutes(iso, minutes) {
+  const t = new Date(iso).getTime();
+  const safeMinutes = Number.isFinite(minutes) && minutes > 0 ? minutes : 0;
+  return new Date(t - safeMinutes * 6e4).toISOString();
+}
+function resolveSinceIso(context, lookbackMinutes, requireSinceTaskFired) {
+  const firedAt = context.task.state.firedAt;
+  if (requireSinceTaskFired && firedAt) {
+    return firedAt;
+  }
+  const minutes = Number.isFinite(lookbackMinutes) ? Number(lookbackMinutes) : 60;
+  return isoMinusMinutes(context.nowIso, minutes);
+}
+const userAcknowledgedCheck = {
+  kind: "user_acknowledged",
+  shouldComplete(_task, context) {
+    return context.acknowledged === true;
+  }
+};
+const userRepliedWithinCheck = {
+  kind: "user_replied_within",
+  shouldComplete(task, context) {
+    const params = paramsForCheck(
+      task,
+      "user_replied_within"
+    );
+    const lookback = params?.lookbackMinutes;
+    const requireSince = params?.requireSinceTaskFired !== false;
+    if (!context.repliedSinceFiredAt?.atIso) {
+      return false;
+    }
+    const sinceIso = resolveSinceIso(context, lookback, requireSince);
+    return new Date(context.repliedSinceFiredAt.atIso).getTime() >= new Date(sinceIso).getTime();
+  }
+};
+const subjectUpdatedCheck = {
+  kind: "subject_updated",
+  async shouldComplete(task, context) {
+    if (!task.subject) return false;
+    const params = paramsForCheck(task, "subject_updated");
+    const lookback = params?.lookbackMinutes;
+    const requireSince = params?.requireSinceTaskFired !== false;
+    const sinceIso = resolveSinceIso(context, lookback, requireSince);
+    const updated = await context.subjectStore.wasUpdatedSince({
+      subject: task.subject,
+      sinceIso
+    });
+    return updated === true;
+  }
+};
+const healthSignalObservedCheck = {
+  kind: "health_signal_observed",
+  async shouldComplete(task, context) {
+    const params = paramsForCheck(
+      task,
+      "health_signal_observed"
+    );
+    if (!params || typeof params.signalKind !== "string") {
+      return false;
+    }
+    const requireSince = params.requireSinceTaskFired !== false;
+    const sinceIso = resolveSinceIso(
+      context,
+      params.lookbackMinutes,
+      requireSince
+    );
+    const observed = await context.activity.hasSignalSince({
+      signalKind: params.signalKind,
+      sinceIso,
+      subject: task.subject
+    });
+    return observed === true;
+  }
+};
+function createCompletionCheckRegistry() {
+  const map = /* @__PURE__ */ new Map();
+  return {
+    register(c) {
+      if (!c.kind || typeof c.kind !== "string") {
+        throw new Error("CompletionCheckRegistry.register: kind required");
+      }
+      if (map.has(c.kind)) {
+        throw new Error(
+          `CompletionCheckRegistry.register: duplicate kind "${c.kind}"`
+        );
+      }
+      map.set(c.kind, c);
+    },
+    get(kind) {
+      return map.get(kind) ?? null;
+    },
+    list() {
+      return Array.from(map.values());
+    }
+  };
+}
+function registerBuiltInCompletionChecks(reg) {
+  reg.register(userAcknowledgedCheck);
+  reg.register(userRepliedWithinCheck);
+  reg.register(subjectUpdatedCheck);
+  reg.register(healthSignalObservedCheck);
+}
+export {
+  createCompletionCheckRegistry,
+  registerBuiltInCompletionChecks
+};
+//# sourceMappingURL=completion-check-registry.js.map

package/dist/scheduled-task/completion-check-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/scheduled-task/completion-check-registry.ts"],"sourcesContent":["/**\n * CompletionCheckRegistry. Built-in kinds:\n *   - `user_acknowledged`\n *   - `user_replied_within { lookbackMinutes, requireSinceTaskFired }`\n *   - `subject_updated`\n *   - `health_signal_observed { signalKind, lookbackMinutes, requireSinceTaskFired }`\n *\n * Each check returns a boolean — `true` means the runner moves the task\n * to `completed` (and fires `pipeline.onComplete`).\n */\n\nimport type {\n  CompletionCheckContext,\n  CompletionCheckContribution,\n  ScheduledTask,\n} from \"./types.js\";\n\ninterface UserRepliedWithinParams {\n  lookbackMinutes?: number;\n  /** When true, only inbounds since the most recent fire count. Default true. */\n  requireSinceTaskFired?: boolean;\n}\n\ninterface HealthSignalObservedParams {\n  signalKind: string;\n  lookbackMinutes?: number;\n  requireSinceTaskFired?: boolean;\n}\n\nfunction paramsForCheck<T>(task: ScheduledTask, kind: string): T | undefined {\n  if (task.completionCheck?.kind === kind) {\n    return task.completionCheck.params as T | undefined;\n  }\n  return undefined;\n}\n\nfunction isoMinusMinutes(iso: string, minutes: number): string {\n  const t = new Date(iso).getTime();\n  const safeMinutes = Number.isFinite(minutes) && minutes > 0 ? minutes : 0;\n  return new Date(t - safeMinutes * 60_000).toISOString();\n}\n\nfunction resolveSinceIso(\n  context: CompletionCheckContext,\n  lookbackMinutes: number | undefined,\n  requireSinceTaskFired: boolean,\n): string {\n  const firedAt = context.task.state.firedAt;\n  if (requireSinceTaskFired && firedAt) {\n    return firedAt;\n  }\n  const minutes = Number.isFinite(lookbackMinutes)\n    ? Number(lookbackMinutes)\n    : 60;\n  return isoMinusMinutes(context.nowIso, minutes);\n}\n\nconst userAcknowledgedCheck: CompletionCheckContribution = {\n  kind: \"user_acknowledged\",\n  shouldComplete(_task, context): boolean {\n    return context.acknowledged === true;\n  },\n};\n\nconst userRepliedWithinCheck: CompletionCheckContribution = {\n  kind: \"user_replied_within\",\n  shouldComplete(task, context): boolean {\n    const params = paramsForCheck<UserRepliedWithinParams>(\n      task,\n      \"user_replied_within\",\n    );\n    const lookback = params?.lookbackMinutes;\n    const requireSince = params?.requireSinceTaskFired !== false;\n    if (!context.repliedSinceFiredAt?.atIso) {\n      return false;\n    }\n    const sinceIso = resolveSinceIso(context, lookback, requireSince);\n    return (\n      new Date(context.repliedSinceFiredAt.atIso).getTime() >=\n      new Date(sinceIso).getTime()\n    );\n  },\n};\n\nconst subjectUpdatedCheck: CompletionCheckContribution = {\n  kind: \"subject_updated\",\n  async shouldComplete(task, context): Promise<boolean> {\n    if (!task.subject) return false;\n    const params = paramsForCheck<{\n      lookbackMinutes?: number;\n      requireSinceTaskFired?: boolean;\n    }>(task, \"subject_updated\");\n    const lookback = params?.lookbackMinutes;\n    const requireSince = params?.requireSinceTaskFired !== false;\n    const sinceIso = resolveSinceIso(context, lookback, requireSince);\n    const updated = await context.subjectStore.wasUpdatedSince({\n      subject: task.subject,\n      sinceIso,\n    });\n    return updated === true;\n  },\n};\n\nconst healthSignalObservedCheck: CompletionCheckContribution = {\n  kind: \"health_signal_observed\",\n  async shouldComplete(task, context): Promise<boolean> {\n    const params = paramsForCheck<HealthSignalObservedParams>(\n      task,\n      \"health_signal_observed\",\n    );\n    if (!params || typeof params.signalKind !== \"string\") {\n      return false;\n    }\n    const requireSince = params.requireSinceTaskFired !== false;\n    const sinceIso = resolveSinceIso(\n      context,\n      params.lookbackMinutes,\n      requireSince,\n    );\n    const observed = await context.activity.hasSignalSince({\n      signalKind: params.signalKind,\n      sinceIso,\n      subject: task.subject,\n    });\n    return observed === true;\n  },\n};\n\n// ---------------------------------------------------------------------------\n// Registry\n// ---------------------------------------------------------------------------\n\nexport interface CompletionCheckRegistry {\n  register(c: CompletionCheckContribution): void;\n  get(kind: string): CompletionCheckContribution | null;\n  list(): CompletionCheckContribution[];\n}\n\nexport function createCompletionCheckRegistry(): CompletionCheckRegistry {\n  const map = new Map<string, CompletionCheckContribution>();\n  return {\n    register(c) {\n      if (!c.kind || typeof c.kind !== \"string\") {\n        throw new Error(\"CompletionCheckRegistry.register: kind required\");\n      }\n      if (map.has(c.kind)) {\n        throw new Error(\n          `CompletionCheckRegistry.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}\n\nexport function registerBuiltInCompletionChecks(\n  reg: CompletionCheckRegistry,\n): void {\n  reg.register(userAcknowledgedCheck);\n  reg.register(userRepliedWithinCheck);\n  reg.register(subjectUpdatedCheck);\n  reg.register(healthSignalObservedCheck);\n}\n"],"mappings":"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","names":[]}

package/dist/scheduled-task/consolidation-policy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AnchorContribution + AnchorConsolidationPolicy registry.
+ *
+ * Ships a fallback `wake.confirmed` anchor that resolves to
+ * `ownerFact.morningWindow.start`. `plugin-health` registers the richer
+ * `wake.observed` / `wake.confirmed` / `bedtime.target` / `nap.start`
+ * anchors and may overwrite the fallback at boot — so the fallback is only
+ * registered when the real one is absent.
+ *
+ * Consolidation policies are referenced by anchor key. The runner uses
+ * them when multiple `relative_to_anchor` tasks fire on the same anchor;
+ * `mode = "merge"` means the runner asks consumers to render one
+ * combined card; `sequential` staggers; `parallel` fires all at once.
+ */
+import type { AnchorConsolidationPolicy, AnchorContext, AnchorContribution, ScheduledTask } from "./types.js";
+export interface AnchorRegistry {
+    register(a: AnchorContribution, opts?: {
+        override?: boolean;
+    }): void;
+    get(anchorKey: string): AnchorContribution | null;
+    list(): AnchorContribution[];
+    resolve(anchorKey: string, context: AnchorContext): Promise<{
+        atIso: string;
+    } | null>;
+}
+export declare function createAnchorRegistry(): AnchorRegistry;
+declare function todayIsoWithLocalHHMM(nowIso: string, hhmm: string, tz: string): {
+    atIso: string;
+} | null;
+export declare function registerFallbackAnchors(reg: AnchorRegistry): void;
+export interface ConsolidationRegistry {
+    register(p: AnchorConsolidationPolicy): void;
+    get(anchorKey: string): AnchorConsolidationPolicy | null;
+    list(): AnchorConsolidationPolicy[];
+    /**
+     * Apply a policy to a fresh batch of tasks fired on the same anchor.
+     * Returns batches the runner should hand to its dispatcher; each batch
+     * is a list of tasks the consumer renders together (or sequentially —
+     * the policy mode tells the consumer how).
+     */
+    consolidate(anchorKey: string, tasks: ScheduledTask[]): {
+        policy: AnchorConsolidationPolicy | null;
+        batches: ScheduledTask[][];
+    };
+}
+export declare function createConsolidationRegistry(): ConsolidationRegistry;
+export declare const __anchorTestUtils: {
+    todayIsoWithLocalHHMM: typeof todayIsoWithLocalHHMM;
+};
+export {};
+//# sourceMappingURL=consolidation-policy.d.ts.map

package/dist/scheduled-task/consolidation-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation-policy.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/consolidation-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EAClB,aAAa,EAEd,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACrE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC;IAClD,IAAI,IAAI,kBAAkB,EAAE,CAAC;IAC7B,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CACtC;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CA2BrD;AAMD,iBAAS,qBAAqB,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA2D1B;AAgBD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAIjE;AAMD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC7C,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAAC;IACzD,IAAI,IAAI,yBAAyB,EAAE,CAAC;IACpC;;;;;OAKG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EAAE,GACrB;QAAE,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,aAAa,EAAE,EAAE,CAAA;KAAE,CAAC;CAC7E;AAQD,wBAAgB,2BAA2B,IAAI,qBAAqB,CAoDnE;AAED,eAAO,MAAM,iBAAiB;;CAA4B,CAAC"}