@elizaos/plugin-personal-assistant 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/providers/pending-prompts.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `pendingPromptsProvider` — surfaces open prompts for the current room so
+ * the planner can route an inbound to an open task's `complete` /
+ * `acknowledge` verb instead of treating it as a fresh request.
+ *
+ * Frozen contract (`wave1-interfaces.md` §4.3 + `GAP_ASSESSMENT.md` §3.11):
+ *
+ *   list(roomId): Promise<PendingPrompt[]>
+ *
+ * Where `PendingPrompt = { taskId, promptSnippet, firedAt, expectedReplyKind, expiresAt? }`.
+ *
+ * Resolution policy (planner-side):
+ *   - exactly one open prompt → planner correlates by default
+ *   - multiple → planner asks the user OR uses an LLM classifier
+ *   - zero → message routes as fresh
+ *
+ * Open prompts retained `expiresAt + reopenWindowHours` (default 24h).
+ */
+import type { IAgentRuntime, Provider } from "@elizaos/core";
+import { type PendingPrompt } from "../lifeops/pending-prompts/store.js";
+export type { PendingPrompt };
+export interface PendingPromptsProvider {
+    list(roomId: string, opts?: {
+        lookbackMinutes?: number;
+    }): Promise<PendingPrompt[]>;
+}
+/**
+ * Build the planner-text rendering of the prompt list. Used both by the
+ * provider and externally by integration tests.
+ */
+export declare function renderPendingPromptsText(prompts: PendingPrompt[]): string;
+/**
+ * Wraps the underlying store in the frozen `PendingPromptsProvider` shape
+ * for non-provider callers (the planner correlation step uses this).
+ */
+export declare function createPendingPromptsProvider(runtime: IAgentRuntime): PendingPromptsProvider;
+export declare const pendingPromptsProvider: Provider;
+//# sourceMappingURL=pending-prompts.d.ts.map

package/dist/providers/pending-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-prompts.d.ts","sourceRoot":"","sources":["../../src/providers/pending-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EACV,aAAa,EAEb,QAAQ,EAGT,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,qCAAqC,CAAC;AAE7C,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,sBAAsB;IACrC,IAAI,CACF,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAClC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAC7B;AAeD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAYzE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,aAAa,GACrB,sBAAsB,CAKxB;AAED,eAAO,MAAM,sBAAsB,EAAE,QAqDpC,CAAC"}

package/dist/providers/pending-prompts.js

@@ -0,0 +1,81 @@
+import { hasOwnerAccess } from "@elizaos/agent";
+import { logger } from "@elizaos/core";
+import {
+  resolvePendingPromptsStore
+} from "../lifeops/pending-prompts/store.js";
+const EMPTY = {
+  text: "",
+  values: { pendingPromptCount: 0 },
+  data: { pendingPrompts: [] }
+};
+const PROMPT_LINES_MAX = 5;
+function formatPromptLine(prompt) {
+  const expires = prompt.expiresAt ? ` (expires ${prompt.expiresAt})` : "";
+  return `- task ${prompt.taskId}: ${prompt.promptSnippet} [reply=${prompt.expectedReplyKind}]${expires}`;
+}
+function renderPendingPromptsText(prompts) {
+  if (prompts.length === 0) return "";
+  const lines = prompts.slice(0, PROMPT_LINES_MAX).map((prompt) => formatPromptLine(prompt));
+  if (prompts.length > PROMPT_LINES_MAX) {
+    lines.push(`(+${prompts.length - PROMPT_LINES_MAX} more)`);
+  }
+  return [
+    "Open prompts in this room (route inbound to .complete/.acknowledge):",
+    ...lines
+  ].join("\n");
+}
+function createPendingPromptsProvider(runtime) {
+  const store = resolvePendingPromptsStore(runtime);
+  return {
+    list: (roomId, opts) => store.list(roomId, opts)
+  };
+}
+const pendingPromptsProvider = {
+  name: "pendingPrompts",
+  description: "Surfaces open prompts (fired ScheduledTasks awaiting the user's reply) for the current room. Lets the planner correlate the next inbound to an open task's complete/acknowledge verb.",
+  descriptionCompressed: "Open prompts per room \u2014 correlate inbound to open task verb.",
+  dynamic: true,
+  // Sit ahead of the lifeops capability provider so correlation runs first.
+  position: 11,
+  cacheScope: "turn",
+  contexts: ["messaging", "tasks"],
+  async get(runtime, message, _state) {
+    if (!await hasOwnerAccess(runtime, message)) {
+      return EMPTY;
+    }
+    const roomId = typeof message.roomId === "string" ? message.roomId : null;
+    if (!roomId) return EMPTY;
+    let store;
+    try {
+      store = resolvePendingPromptsStore(runtime);
+    } catch (error) {
+      logger.debug(
+        "[pending-prompts-provider] store unavailable:",
+        String(error)
+      );
+      return EMPTY;
+    }
+    let prompts;
+    try {
+      prompts = await store.list(roomId);
+    } catch (error) {
+      logger.debug("[pending-prompts-provider] list failed:", String(error));
+      return EMPTY;
+    }
+    if (prompts.length === 0) return EMPTY;
+    return {
+      text: renderPendingPromptsText(prompts),
+      values: {
+        pendingPromptCount: prompts.length,
+        pendingPromptTaskIds: prompts.map((p) => p.taskId)
+      },
+      data: { pendingPrompts: prompts }
+    };
+  }
+};
+export {
+  createPendingPromptsProvider,
+  pendingPromptsProvider,
+  renderPendingPromptsText
+};
+//# sourceMappingURL=pending-prompts.js.map

package/dist/providers/pending-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/pending-prompts.ts"],"sourcesContent":["/**\n * `pendingPromptsProvider` — surfaces open prompts for the current room so\n * the planner can route an inbound to an open task's `complete` /\n * `acknowledge` verb instead of treating it as a fresh request.\n *\n * Frozen contract (`wave1-interfaces.md` §4.3 + `GAP_ASSESSMENT.md` §3.11):\n *\n *   list(roomId): Promise<PendingPrompt[]>\n *\n * Where `PendingPrompt = { taskId, promptSnippet, firedAt, expectedReplyKind, expiresAt? }`.\n *\n * Resolution policy (planner-side):\n *   - exactly one open prompt → planner correlates by default\n *   - multiple → planner asks the user OR uses an LLM classifier\n *   - zero → message routes as fresh\n *\n * Open prompts retained `expiresAt + reopenWindowHours` (default 24h).\n */\n\nimport { hasOwnerAccess } from \"@elizaos/agent\";\nimport type {\n  IAgentRuntime,\n  Memory,\n  Provider,\n  ProviderResult,\n  State,\n} from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport {\n  type PendingPrompt,\n  type PendingPromptsStore,\n  resolvePendingPromptsStore,\n} from \"../lifeops/pending-prompts/store.js\";\n\nexport type { PendingPrompt };\n\nexport interface PendingPromptsProvider {\n  list(\n    roomId: string,\n    opts?: { lookbackMinutes?: number },\n  ): Promise<PendingPrompt[]>;\n}\n\nconst EMPTY: ProviderResult = {\n  text: \"\",\n  values: { pendingPromptCount: 0 },\n  data: { pendingPrompts: [] },\n};\n\nconst PROMPT_LINES_MAX = 5;\n\nfunction formatPromptLine(prompt: PendingPrompt): string {\n  const expires = prompt.expiresAt ? ` (expires ${prompt.expiresAt})` : \"\";\n  return `- task ${prompt.taskId}: ${prompt.promptSnippet} [reply=${prompt.expectedReplyKind}]${expires}`;\n}\n\n/**\n * Build the planner-text rendering of the prompt list. Used both by the\n * provider and externally by integration tests.\n */\nexport function renderPendingPromptsText(prompts: PendingPrompt[]): string {\n  if (prompts.length === 0) return \"\";\n  const lines = prompts\n    .slice(0, PROMPT_LINES_MAX)\n    .map((prompt) => formatPromptLine(prompt));\n  if (prompts.length > PROMPT_LINES_MAX) {\n    lines.push(`(+${prompts.length - PROMPT_LINES_MAX} more)`);\n  }\n  return [\n    \"Open prompts in this room (route inbound to .complete/.acknowledge):\",\n    ...lines,\n  ].join(\"\\n\");\n}\n\n/**\n * Wraps the underlying store in the frozen `PendingPromptsProvider` shape\n * for non-provider callers (the planner correlation step uses this).\n */\nexport function createPendingPromptsProvider(\n  runtime: IAgentRuntime,\n): PendingPromptsProvider {\n  const store: PendingPromptsStore = resolvePendingPromptsStore(runtime);\n  return {\n    list: (roomId: string, opts) => store.list(roomId, opts),\n  };\n}\n\nexport const pendingPromptsProvider: Provider = {\n  name: \"pendingPrompts\",\n  description:\n    \"Surfaces open prompts (fired ScheduledTasks awaiting the user's reply) \" +\n    \"for the current room. Lets the planner correlate the next inbound to an open task's complete/acknowledge verb.\",\n  descriptionCompressed:\n    \"Open prompts per room — correlate inbound to open task verb.\",\n  dynamic: true,\n  // Sit ahead of the lifeops capability provider so correlation runs first.\n  position: 11,\n  cacheScope: \"turn\",\n  contexts: [\"messaging\", \"tasks\"],\n\n  async get(\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state: State,\n  ): Promise<ProviderResult> {\n    if (!(await hasOwnerAccess(runtime, message))) {\n      return EMPTY;\n    }\n    const roomId = typeof message.roomId === \"string\" ? message.roomId : null;\n    if (!roomId) return EMPTY;\n\n    let store: PendingPromptsStore;\n    try {\n      store = resolvePendingPromptsStore(runtime);\n    } catch (error) {\n      logger.debug(\n        \"[pending-prompts-provider] store unavailable:\",\n        String(error),\n      );\n      return EMPTY;\n    }\n\n    let prompts: PendingPrompt[];\n    try {\n      prompts = await store.list(roomId);\n    } catch (error) {\n      logger.debug(\"[pending-prompts-provider] list failed:\", String(error));\n      return EMPTY;\n    }\n    if (prompts.length === 0) return EMPTY;\n\n    return {\n      text: renderPendingPromptsText(prompts),\n      values: {\n        pendingPromptCount: prompts.length,\n        pendingPromptTaskIds: prompts.map((p) => p.taskId),\n      },\n      data: { pendingPrompts: prompts },\n    };\n  },\n};\n"],"mappings":"AAmBA,SAAS,sBAAsB;AAQ/B,SAAS,cAAc;AACvB;AAAA,EAGE;AAAA,OACK;AAWP,MAAM,QAAwB;AAAA,EAC5B,MAAM;AAAA,EACN,QAAQ,EAAE,oBAAoB,EAAE;AAAA,EAChC,MAAM,EAAE,gBAAgB,CAAC,EAAE;AAC7B;AAEA,MAAM,mBAAmB;AAEzB,SAAS,iBAAiB,QAA+B;AACvD,QAAM,UAAU,OAAO,YAAY,aAAa,OAAO,SAAS,MAAM;AACtE,SAAO,UAAU,OAAO,MAAM,KAAK,OAAO,aAAa,WAAW,OAAO,iBAAiB,IAAI,OAAO;AACvG;AAMO,SAAS,yBAAyB,SAAkC;AACzE,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,QAAQ,QACX,MAAM,GAAG,gBAAgB,EACzB,IAAI,CAAC,WAAW,iBAAiB,MAAM,CAAC;AAC3C,MAAI,QAAQ,SAAS,kBAAkB;AACrC,UAAM,KAAK,KAAK,QAAQ,SAAS,gBAAgB,QAAQ;AAAA,EAC3D;AACA,SAAO;AAAA,IACL;AAAA,IACA,GAAG;AAAA,EACL,EAAE,KAAK,IAAI;AACb;AAMO,SAAS,6BACd,SACwB;AACxB,QAAM,QAA6B,2BAA2B,OAAO;AACrE,SAAO;AAAA,IACL,MAAM,CAAC,QAAgB,SAAS,MAAM,KAAK,QAAQ,IAAI;AAAA,EACzD;AACF;AAEO,MAAM,yBAAmC;AAAA,EAC9C,MAAM;AAAA,EACN,aACE;AAAA,EAEF,uBACE;AAAA,EACF,SAAS;AAAA;AAAA,EAET,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,UAAU,CAAC,aAAa,OAAO;AAAA,EAE/B,MAAM,IACJ,SACA,SACA,QACyB;AACzB,QAAI,CAAE,MAAM,eAAe,SAAS,OAAO,GAAI;AAC7C,aAAO;AAAA,IACT;AACA,UAAM,SAAS,OAAO,QAAQ,WAAW,WAAW,QAAQ,SAAS;AACrE,QAAI,CAAC,OAAQ,QAAO;AAEpB,QAAI;AACJ,QAAI;AACF,cAAQ,2BAA2B,OAAO;AAAA,IAC5C,SAAS,OAAO;AACd,aAAO;AAAA,QACL;AAAA,QACA,OAAO,KAAK;AAAA,MACd;AACA,aAAO;AAAA,IACT;AAEA,QAAI;AACJ,QAAI;AACF,gBAAU,MAAM,MAAM,KAAK,MAAM;AAAA,IACnC,SAAS,OAAO;AACd,aAAO,MAAM,2CAA2C,OAAO,KAAK,CAAC;AACrE,aAAO;AAAA,IACT;AACA,QAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,WAAO;AAAA,MACL,MAAM,yBAAyB,OAAO;AAAA,MACtC,QAAQ;AAAA,QACN,oBAAoB,QAAQ;AAAA,QAC5B,sBAAsB,QAAQ,IAAI,CAAC,MAAM,EAAE,MAAM;AAAA,MACnD;AAAA,MACA,MAAM,EAAE,gBAAgB,QAAQ;AAAA,IAClC;AAAA,EACF;AACF;","names":[]}

package/dist/providers/recent-task-states.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `recentTaskStatesProvider` — summarizes recent `ScheduledTask` outcomes so
+ * the planner can (a) bring patterns up proactively (the "quiet-user
+ * watcher" reads this), and (b) answer "did I check in yesterday?" without
+ * scanning rows.
+ *
+ * Contract: summarize(opts?): Promise<{ summary, streaks, notable }>
+ *
+ * Reads the cache-backed task log maintained by the scheduled-task runner
+ * via `readScheduledTaskLog`.
+ */
+import type { IAgentRuntime, Provider } from "@elizaos/core";
+import type { ScheduledTaskKind, TerminalState } from "../lifeops/scheduled-task/index.js";
+export interface RecentTaskStateEntry {
+    taskId: string;
+    kind: ScheduledTaskKind;
+    outcome: TerminalState | "fired" | "acknowledged";
+    recordedAt: string;
+    subjectId?: string;
+    notable?: string;
+}
+export interface RecentTaskStatesSummary {
+    summary: string;
+    streaks: Array<{
+        kind: ScheduledTaskKind;
+        outcome: TerminalState;
+        consecutive: number;
+    }>;
+    notable: Array<{
+        taskId: string;
+        observation: string;
+    }>;
+}
+export interface RecentTaskStatesProvider {
+    summarize(opts?: {
+        kinds?: ScheduledTaskKind[];
+        subjectIds?: string[];
+        lookbackDays?: number;
+    }): Promise<RecentTaskStatesSummary>;
+}
+/**
+ * Read the scheduled-task log from the cache-backed list maintained alongside
+ * the in-memory runner. Entries surface in **chronological order (oldest first)**.
+ */
+export declare function readScheduledTaskLog(runtime: IAgentRuntime): Promise<RecentTaskStateEntry[]>;
+/**
+ * Test/integration helper — append an entry to the log.
+ */
+export declare function appendScheduledTaskLogEntry(runtime: IAgentRuntime, entry: RecentTaskStateEntry): Promise<void>;
+export declare function createRecentTaskStatesProvider(runtime: IAgentRuntime): RecentTaskStatesProvider;
+export declare const recentTaskStatesProvider: Provider;
+//# sourceMappingURL=recent-task-states.d.ts.map

package/dist/providers/recent-task-states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent-task-states.d.ts","sourceRoot":"","sources":["../../src/providers/recent-task-states.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EACV,aAAa,EAEb,QAAQ,EAGT,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,aAAa,GAAG,OAAO,GAAG,cAAc,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,iBAAiB,CAAC;QACxB,OAAO,EAAE,aAAa,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,IAAI,CAAC,EAAE;QACf,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACtC;AAKD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAcjC;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAMf;AAgGD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,aAAa,GACrB,wBAAwB,CA8B1B;AAQD,eAAO,MAAM,wBAAwB,EAAE,QA8CtC,CAAC"}

package/dist/providers/recent-task-states.js

@@ -0,0 +1,166 @@
+import { hasOwnerAccess } from "@elizaos/agent";
+import { logger } from "@elizaos/core";
+import { asCacheRuntime } from "../lifeops/runtime-cache.js";
+const TASK_LOG_CACHE_KEY = "eliza:lifeops:scheduled-task-log:v1";
+const DEFAULT_LOOKBACK_DAYS = 7;
+async function readScheduledTaskLog(runtime) {
+  const cache = asCacheRuntime(runtime);
+  const stored = await cache.getCache(TASK_LOG_CACHE_KEY);
+  if (!Array.isArray(stored)) return [];
+  return stored.filter(
+    (entry) => Boolean(entry) && typeof entry.taskId === "string" && typeof entry.recordedAt === "string"
+  ).slice().sort((a, b) => Date.parse(a.recordedAt) - Date.parse(b.recordedAt));
+}
+async function appendScheduledTaskLogEntry(runtime, entry) {
+  const cache = asCacheRuntime(runtime);
+  const existing = await cache.getCache(TASK_LOG_CACHE_KEY) ?? [];
+  existing.push(entry);
+  await cache.setCache(TASK_LOG_CACHE_KEY, existing);
+}
+const TERMINAL_OUTCOMES = /* @__PURE__ */ new Set([
+  "completed",
+  "skipped",
+  "expired",
+  "failed",
+  "dismissed"
+]);
+function isTerminal(outcome) {
+  return TERMINAL_OUTCOMES.has(outcome);
+}
+function summarizeEntries(entries) {
+  const acc = {
+    byKind: /* @__PURE__ */ new Map(),
+    trail: /* @__PURE__ */ new Map(),
+    notable: []
+  };
+  for (const entry of entries) {
+    const bucket = acc.byKind.get(entry.kind) ?? {
+      fires: 0,
+      outcomes: /* @__PURE__ */ new Map()
+    };
+    bucket.fires += 1;
+    bucket.outcomes.set(
+      entry.outcome,
+      (bucket.outcomes.get(entry.outcome) ?? 0) + 1
+    );
+    acc.byKind.set(entry.kind, bucket);
+    if (isTerminal(entry.outcome)) {
+      const trail = acc.trail.get(entry.kind) ?? [];
+      trail.push(entry.outcome);
+      acc.trail.set(entry.kind, trail);
+    }
+    if (entry.notable) {
+      acc.notable.push({ taskId: entry.taskId, observation: entry.notable });
+    }
+  }
+  const streaks = [];
+  for (const [kind, trail] of acc.trail) {
+    if (trail.length === 0) continue;
+    const tail = trail[trail.length - 1];
+    let consecutive = 1;
+    for (let i = trail.length - 2; i >= 0; i -= 1) {
+      if (trail[i] === tail) consecutive += 1;
+      else break;
+    }
+    if (consecutive >= 2) {
+      streaks.push({ kind, outcome: tail, consecutive });
+    }
+  }
+  const summaryLines = [];
+  for (const [kind, bucket] of acc.byKind) {
+    const completed = bucket.outcomes.get("completed") ?? 0;
+    const skipped = bucket.outcomes.get("skipped") ?? 0;
+    const expired = bucket.outcomes.get("expired") ?? 0;
+    const dismissed = bucket.outcomes.get("dismissed") ?? 0;
+    summaryLines.push(
+      `${kind}: ${completed} done / ${skipped} skipped / ${expired} expired / ${dismissed} dismissed (over ${bucket.fires} fires)`
+    );
+  }
+  for (const streak of streaks) {
+    if (streak.consecutive >= 3) {
+      summaryLines.push(
+        `${streak.kind} ${streak.outcome} streak: ${streak.consecutive} in a row`
+      );
+    }
+  }
+  if (summaryLines.length === 0) {
+    summaryLines.push(
+      "No recent scheduled-task activity in the lookback window."
+    );
+  }
+  return {
+    summary: summaryLines.join("\n"),
+    streaks,
+    notable: acc.notable.slice(0, 10)
+  };
+}
+function createRecentTaskStatesProvider(runtime) {
+  return {
+    async summarize(opts = {}) {
+      const lookbackDays = opts.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;
+      const cutoffMs = Date.now() - lookbackDays * 864e5;
+      const log = await readScheduledTaskLog(runtime);
+      const filtered = log.filter((entry) => {
+        const recordedMs = Date.parse(entry.recordedAt);
+        if (!Number.isFinite(recordedMs) || recordedMs < cutoffMs) {
+          return false;
+        }
+        if (opts.kinds && opts.kinds.length > 0 && !opts.kinds.includes(entry.kind)) {
+          return false;
+        }
+        if (opts.subjectIds && opts.subjectIds.length > 0 && (!entry.subjectId || !opts.subjectIds.includes(entry.subjectId))) {
+          return false;
+        }
+        return true;
+      });
+      return summarizeEntries(filtered);
+    }
+  };
+}
+const EMPTY = {
+  text: "",
+  values: { recentTaskStateCount: 0 },
+  data: {}
+};
+const recentTaskStatesProvider = {
+  name: "recentTaskStates",
+  description: "Summarizes recent ScheduledTask outcomes (streaks, missed check-ins, completion counts) so the planner can answer 'did I check in yesterday?' and the quiet-user watcher can flag silence.",
+  descriptionCompressed: "Recent ScheduledTask outcomes \u2014 streaks + summary text.",
+  dynamic: true,
+  position: 13,
+  cacheScope: "turn",
+  contexts: ["tasks", "automation"],
+  async get(runtime, message, _state) {
+    if (!await hasOwnerAccess(runtime, message)) {
+      return EMPTY;
+    }
+    let summary;
+    try {
+      summary = await createRecentTaskStatesProvider(runtime).summarize();
+    } catch (error) {
+      logger.debug(
+        "[recent-task-states-provider] summarize failed:",
+        String(error)
+      );
+      return EMPTY;
+    }
+    if (!summary.summary || summary.summary.startsWith("No recent scheduled-task activity")) {
+      return EMPTY;
+    }
+    return {
+      text: summary.summary,
+      values: {
+        recentTaskStateCount: summary.streaks.length,
+        notableCount: summary.notable.length
+      },
+      data: { recentTaskStates: summary }
+    };
+  }
+};
+export {
+  appendScheduledTaskLogEntry,
+  createRecentTaskStatesProvider,
+  readScheduledTaskLog,
+  recentTaskStatesProvider
+};
+//# sourceMappingURL=recent-task-states.js.map

package/dist/providers/recent-task-states.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/recent-task-states.ts"],"sourcesContent":["/**\n * `recentTaskStatesProvider` — summarizes recent `ScheduledTask` outcomes so\n * the planner can (a) bring patterns up proactively (the \"quiet-user\n * watcher\" reads this), and (b) answer \"did I check in yesterday?\" without\n * scanning rows.\n *\n * Contract: summarize(opts?): Promise<{ summary, streaks, notable }>\n *\n * Reads the cache-backed task log maintained by the scheduled-task runner\n * via `readScheduledTaskLog`.\n */\n\nimport { hasOwnerAccess } from \"@elizaos/agent\";\nimport type {\n  IAgentRuntime,\n  Memory,\n  Provider,\n  ProviderResult,\n  State,\n} from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport { asCacheRuntime } from \"../lifeops/runtime-cache.js\";\nimport type {\n  ScheduledTaskKind,\n  TerminalState,\n} from \"../lifeops/scheduled-task/index.js\";\n\nexport interface RecentTaskStateEntry {\n  taskId: string;\n  kind: ScheduledTaskKind;\n  outcome: TerminalState | \"fired\" | \"acknowledged\";\n  recordedAt: string;\n  subjectId?: string;\n  notable?: string;\n}\n\nexport interface RecentTaskStatesSummary {\n  summary: string;\n  streaks: Array<{\n    kind: ScheduledTaskKind;\n    outcome: TerminalState;\n    consecutive: number;\n  }>;\n  notable: Array<{ taskId: string; observation: string }>;\n}\n\nexport interface RecentTaskStatesProvider {\n  summarize(opts?: {\n    kinds?: ScheduledTaskKind[];\n    subjectIds?: string[];\n    lookbackDays?: number;\n  }): Promise<RecentTaskStatesSummary>;\n}\n\nconst TASK_LOG_CACHE_KEY = \"eliza:lifeops:scheduled-task-log:v1\";\nconst DEFAULT_LOOKBACK_DAYS = 7;\n\n/**\n * Read the scheduled-task log from the cache-backed list maintained alongside\n * the in-memory runner. Entries surface in **chronological order (oldest first)**.\n */\nexport async function readScheduledTaskLog(\n  runtime: IAgentRuntime,\n): Promise<RecentTaskStateEntry[]> {\n  const cache = asCacheRuntime(runtime);\n  const stored =\n    await cache.getCache<RecentTaskStateEntry[]>(TASK_LOG_CACHE_KEY);\n  if (!Array.isArray(stored)) return [];\n  return stored\n    .filter(\n      (entry): entry is RecentTaskStateEntry =>\n        Boolean(entry) &&\n        typeof entry.taskId === \"string\" &&\n        typeof entry.recordedAt === \"string\",\n    )\n    .slice()\n    .sort((a, b) => Date.parse(a.recordedAt) - Date.parse(b.recordedAt));\n}\n\n/**\n * Test/integration helper — append an entry to the log.\n */\nexport async function appendScheduledTaskLogEntry(\n  runtime: IAgentRuntime,\n  entry: RecentTaskStateEntry,\n): Promise<void> {\n  const cache = asCacheRuntime(runtime);\n  const existing =\n    (await cache.getCache<RecentTaskStateEntry[]>(TASK_LOG_CACHE_KEY)) ?? [];\n  existing.push(entry);\n  await cache.setCache<RecentTaskStateEntry[]>(TASK_LOG_CACHE_KEY, existing);\n}\n\nconst TERMINAL_OUTCOMES: ReadonlySet<TerminalState> = new Set<TerminalState>([\n  \"completed\",\n  \"skipped\",\n  \"expired\",\n  \"failed\",\n  \"dismissed\",\n]);\n\nfunction isTerminal(outcome: string): outcome is TerminalState {\n  return TERMINAL_OUTCOMES.has(outcome as TerminalState);\n}\n\ninterface SummaryAccumulator {\n  byKind: Map<\n    ScheduledTaskKind,\n    { fires: number; outcomes: Map<string, number> }\n  >;\n  /** kind → ordered terminal outcomes (chronological) */\n  trail: Map<ScheduledTaskKind, TerminalState[]>;\n  notable: Array<{ taskId: string; observation: string }>;\n}\n\nfunction summarizeEntries(\n  entries: RecentTaskStateEntry[],\n): RecentTaskStatesSummary {\n  const acc: SummaryAccumulator = {\n    byKind: new Map(),\n    trail: new Map(),\n    notable: [],\n  };\n  for (const entry of entries) {\n    const bucket = acc.byKind.get(entry.kind) ?? {\n      fires: 0,\n      outcomes: new Map<string, number>(),\n    };\n    bucket.fires += 1;\n    bucket.outcomes.set(\n      entry.outcome,\n      (bucket.outcomes.get(entry.outcome) ?? 0) + 1,\n    );\n    acc.byKind.set(entry.kind, bucket);\n    if (isTerminal(entry.outcome)) {\n      const trail = acc.trail.get(entry.kind) ?? [];\n      trail.push(entry.outcome);\n      acc.trail.set(entry.kind, trail);\n    }\n    if (entry.notable) {\n      acc.notable.push({ taskId: entry.taskId, observation: entry.notable });\n    }\n  }\n\n  const streaks: RecentTaskStatesSummary[\"streaks\"] = [];\n  for (const [kind, trail] of acc.trail) {\n    if (trail.length === 0) continue;\n    const tail = trail[trail.length - 1];\n    let consecutive = 1;\n    for (let i = trail.length - 2; i >= 0; i -= 1) {\n      if (trail[i] === tail) consecutive += 1;\n      else break;\n    }\n    if (consecutive >= 2) {\n      streaks.push({ kind, outcome: tail, consecutive });\n    }\n  }\n\n  const summaryLines: string[] = [];\n  for (const [kind, bucket] of acc.byKind) {\n    const completed = bucket.outcomes.get(\"completed\") ?? 0;\n    const skipped = bucket.outcomes.get(\"skipped\") ?? 0;\n    const expired = bucket.outcomes.get(\"expired\") ?? 0;\n    const dismissed = bucket.outcomes.get(\"dismissed\") ?? 0;\n    summaryLines.push(\n      `${kind}: ${completed} done / ${skipped} skipped / ${expired} expired / ${dismissed} dismissed (over ${bucket.fires} fires)`,\n    );\n  }\n  for (const streak of streaks) {\n    if (streak.consecutive >= 3) {\n      summaryLines.push(\n        `${streak.kind} ${streak.outcome} streak: ${streak.consecutive} in a row`,\n      );\n    }\n  }\n  if (summaryLines.length === 0) {\n    summaryLines.push(\n      \"No recent scheduled-task activity in the lookback window.\",\n    );\n  }\n  return {\n    summary: summaryLines.join(\"\\n\"),\n    streaks,\n    notable: acc.notable.slice(0, 10),\n  };\n}\n\nexport function createRecentTaskStatesProvider(\n  runtime: IAgentRuntime,\n): RecentTaskStatesProvider {\n  return {\n    async summarize(opts = {}) {\n      const lookbackDays = opts.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;\n      const cutoffMs = Date.now() - lookbackDays * 86_400_000;\n      const log = await readScheduledTaskLog(runtime);\n      const filtered = log.filter((entry) => {\n        const recordedMs = Date.parse(entry.recordedAt);\n        if (!Number.isFinite(recordedMs) || recordedMs < cutoffMs) {\n          return false;\n        }\n        if (\n          opts.kinds &&\n          opts.kinds.length > 0 &&\n          !opts.kinds.includes(entry.kind)\n        ) {\n          return false;\n        }\n        if (\n          opts.subjectIds &&\n          opts.subjectIds.length > 0 &&\n          (!entry.subjectId || !opts.subjectIds.includes(entry.subjectId))\n        ) {\n          return false;\n        }\n        return true;\n      });\n      return summarizeEntries(filtered);\n    },\n  };\n}\n\nconst EMPTY: ProviderResult = {\n  text: \"\",\n  values: { recentTaskStateCount: 0 },\n  data: {},\n};\n\nexport const recentTaskStatesProvider: Provider = {\n  name: \"recentTaskStates\",\n  description:\n    \"Summarizes recent ScheduledTask outcomes (streaks, missed check-ins, \" +\n    \"completion counts) so the planner can answer 'did I check in yesterday?' \" +\n    \"and the quiet-user watcher can flag silence.\",\n  descriptionCompressed:\n    \"Recent ScheduledTask outcomes — streaks + summary text.\",\n  dynamic: true,\n  position: 13,\n  cacheScope: \"turn\",\n  contexts: [\"tasks\", \"automation\"],\n\n  async get(\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state: State,\n  ): Promise<ProviderResult> {\n    if (!(await hasOwnerAccess(runtime, message))) {\n      return EMPTY;\n    }\n    let summary: RecentTaskStatesSummary;\n    try {\n      summary = await createRecentTaskStatesProvider(runtime).summarize();\n    } catch (error) {\n      logger.debug(\n        \"[recent-task-states-provider] summarize failed:\",\n        String(error),\n      );\n      return EMPTY;\n    }\n    if (\n      !summary.summary ||\n      summary.summary.startsWith(\"No recent scheduled-task activity\")\n    ) {\n      return EMPTY;\n    }\n    return {\n      text: summary.summary,\n      values: {\n        recentTaskStateCount: summary.streaks.length,\n        notableCount: summary.notable.length,\n      },\n      data: { recentTaskStates: summary },\n    };\n  },\n};\n"],"mappings":"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","names":[]}

package/dist/providers/room-policy.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `roomPolicyProvider` — runs early in context assembly per
+ * `GAP_ASSESSMENT.md` §3.14. If `HandoffStore.status(roomId).active`, it
+ * injects "this room is in handoff mode — do not respond unless [resume
+ * condition]" into the planner context.
+ *
+ * Combined with the planner's standard discretion, this halts agent
+ * contributions cleanly until the resume condition fires.
+ *
+ * Position: `-9` so it lands ahead of capability providers but after the
+ * `firstRunProvider` (`-10`). The first-run affordance still wins on a
+ * fresh boot.
+ */
+import type { Provider } from "@elizaos/core";
+export declare const roomPolicyProvider: Provider;
+//# sourceMappingURL=room-policy.d.ts.map

package/dist/providers/room-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-policy.d.ts","sourceRoot":"","sources":["../../src/providers/room-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAGV,QAAQ,EAGT,MAAM,eAAe,CAAC;AAevB,eAAO,MAAM,kBAAkB,EAAE,QAyEhC,CAAC"}

package/dist/providers/room-policy.js

@@ -0,0 +1,71 @@
+import { logger } from "@elizaos/core";
+import {
+  describeResumeCondition,
+  resolveHandoffStore
+} from "../lifeops/handoff/store.js";
+const QUIET_RESULT = {
+  text: "",
+  values: { roomInHandoff: false },
+  data: {}
+};
+const ONE_LINE_MAX = 240;
+const roomPolicyProvider = {
+  name: "roomPolicy",
+  description: "Per-room policy gate. Surfaces `HandoffStore` state to the planner so the agent stops contributing in rooms that are in handoff mode until the registered resume condition fires.",
+  descriptionCompressed: "Handoff-mode gate; injects stay-quiet directive when room is handed off.",
+  dynamic: true,
+  position: -9,
+  cacheScope: "turn",
+  async get(runtime, message, _state) {
+    const roomId = typeof message.roomId === "string" && message.roomId.length > 0 ? message.roomId : null;
+    if (!roomId) {
+      return QUIET_RESULT;
+    }
+    let store;
+    try {
+      store = resolveHandoffStore(runtime);
+    } catch (error) {
+      logger.debug(
+        "[room-policy-provider] handoff store unavailable:",
+        String(error)
+      );
+      return QUIET_RESULT;
+    }
+    let status;
+    try {
+      status = await store.status(roomId);
+    } catch (error) {
+      logger.debug(
+        "[room-policy-provider] handoff status read failed:",
+        String(error)
+      );
+      return QUIET_RESULT;
+    }
+    if (!status.active) {
+      return QUIET_RESULT;
+    }
+    const resumePhrase = status.resumeOn ? describeResumeCondition(status.resumeOn) : "the resume condition fires";
+    const directive = `This room is in handoff mode (since ${status.enteredAt ?? "earlier"}; reason: ${status.reason ?? "n/a"}). Do not respond unless ${resumePhrase}. Stay silent \u2014 defer to the human participants.`;
+    const text = directive.slice(0, ONE_LINE_MAX);
+    return {
+      text,
+      values: {
+        roomInHandoff: true,
+        handoffEnteredAt: status.enteredAt ?? "",
+        handoffResumeKind: status.resumeOn?.kind ?? ""
+      },
+      data: {
+        handoff: {
+          active: true,
+          enteredAt: status.enteredAt,
+          reason: status.reason,
+          resumeOn: status.resumeOn
+        }
+      }
+    };
+  }
+};
+export {
+  roomPolicyProvider
+};
+//# sourceMappingURL=room-policy.js.map

package/dist/providers/room-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/room-policy.ts"],"sourcesContent":["/**\n * `roomPolicyProvider` — runs early in context assembly per\n * `GAP_ASSESSMENT.md` §3.14. If `HandoffStore.status(roomId).active`, it\n * injects \"this room is in handoff mode — do not respond unless [resume\n * condition]\" into the planner context.\n *\n * Combined with the planner's standard discretion, this halts agent\n * contributions cleanly until the resume condition fires.\n *\n * Position: `-9` so it lands ahead of capability providers but after the\n * `firstRunProvider` (`-10`). The first-run affordance still wins on a\n * fresh boot.\n */\n\nimport type {\n  IAgentRuntime,\n  Memory,\n  Provider,\n  ProviderResult,\n  State,\n} from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport {\n  describeResumeCondition,\n  resolveHandoffStore,\n} from \"../lifeops/handoff/store.js\";\n\nconst QUIET_RESULT: ProviderResult = {\n  text: \"\",\n  values: { roomInHandoff: false },\n  data: {},\n};\n\nconst ONE_LINE_MAX = 240;\n\nexport const roomPolicyProvider: Provider = {\n  name: \"roomPolicy\",\n  description:\n    \"Per-room policy gate. Surfaces `HandoffStore` state to the planner so the agent stops contributing in rooms that are in handoff mode until the registered resume condition fires.\",\n  descriptionCompressed:\n    \"Handoff-mode gate; injects stay-quiet directive when room is handed off.\",\n  dynamic: true,\n  position: -9,\n  cacheScope: \"turn\",\n\n  async get(\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state: State,\n  ): Promise<ProviderResult> {\n    const roomId =\n      typeof message.roomId === \"string\" && message.roomId.length > 0\n        ? message.roomId\n        : null;\n    if (!roomId) {\n      return QUIET_RESULT;\n    }\n\n    let store: ReturnType<typeof resolveHandoffStore>;\n    try {\n      store = resolveHandoffStore(runtime);\n    } catch (error) {\n      logger.debug(\n        \"[room-policy-provider] handoff store unavailable:\",\n        String(error),\n      );\n      return QUIET_RESULT;\n    }\n\n    let status: Awaited<ReturnType<typeof store.status>>;\n    try {\n      status = await store.status(roomId);\n    } catch (error) {\n      logger.debug(\n        \"[room-policy-provider] handoff status read failed:\",\n        String(error),\n      );\n      return QUIET_RESULT;\n    }\n\n    if (!status.active) {\n      return QUIET_RESULT;\n    }\n\n    const resumePhrase = status.resumeOn\n      ? describeResumeCondition(status.resumeOn)\n      : \"the resume condition fires\";\n    const directive =\n      `This room is in handoff mode (since ${status.enteredAt ?? \"earlier\"}; reason: ${status.reason ?? \"n/a\"}). ` +\n      `Do not respond unless ${resumePhrase}. Stay silent — defer to the human participants.`;\n    const text = directive.slice(0, ONE_LINE_MAX);\n    return {\n      text,\n      values: {\n        roomInHandoff: true,\n        handoffEnteredAt: status.enteredAt ?? \"\",\n        handoffResumeKind: status.resumeOn?.kind ?? \"\",\n      },\n      data: {\n        handoff: {\n          active: true,\n          enteredAt: status.enteredAt,\n          reason: status.reason,\n          resumeOn: status.resumeOn,\n        },\n      },\n    };\n  },\n};\n"],"mappings":"AAqBA,SAAS,cAAc;AACvB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP,MAAM,eAA+B;AAAA,EACnC,MAAM;AAAA,EACN,QAAQ,EAAE,eAAe,MAAM;AAAA,EAC/B,MAAM,CAAC;AACT;AAEA,MAAM,eAAe;AAEd,MAAM,qBAA+B;AAAA,EAC1C,MAAM;AAAA,EACN,aACE;AAAA,EACF,uBACE;AAAA,EACF,SAAS;AAAA,EACT,UAAU;AAAA,EACV,YAAY;AAAA,EAEZ,MAAM,IACJ,SACA,SACA,QACyB;AACzB,UAAM,SACJ,OAAO,QAAQ,WAAW,YAAY,QAAQ,OAAO,SAAS,IAC1D,QAAQ,SACR;AACN,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AAEA,QAAI;AACJ,QAAI;AACF,cAAQ,oBAAoB,OAAO;AAAA,IACrC,SAAS,OAAO;AACd,aAAO;AAAA,QACL;AAAA,QACA,OAAO,KAAK;AAAA,MACd;AACA,aAAO;AAAA,IACT;AAEA,QAAI;AACJ,QAAI;AACF,eAAS,MAAM,MAAM,OAAO,MAAM;AAAA,IACpC,SAAS,OAAO;AACd,aAAO;AAAA,QACL;AAAA,QACA,OAAO,KAAK;AAAA,MACd;AACA,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,OAAO,QAAQ;AAClB,aAAO;AAAA,IACT;AAEA,UAAM,eAAe,OAAO,WACxB,wBAAwB,OAAO,QAAQ,IACvC;AACJ,UAAM,YACJ,uCAAuC,OAAO,aAAa,SAAS,aAAa,OAAO,UAAU,KAAK,4BAC9E,YAAY;AACvC,UAAM,OAAO,UAAU,MAAM,GAAG,YAAY;AAC5C,WAAO;AAAA,MACL;AAAA,MACA,QAAQ;AAAA,QACN,eAAe;AAAA,QACf,kBAAkB,OAAO,aAAa;AAAA,QACtC,mBAAmB,OAAO,UAAU,QAAQ;AAAA,MAC9C;AAAA,MACA,MAAM;AAAA,QACJ,SAAS;AAAA,UACP,QAAQ;AAAA,UACR,WAAW,OAAO;AAAA,UAClB,QAAQ,OAAO;AAAA,UACf,UAAU,OAAO;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/providers/work-threads.d.ts

@@ -0,0 +1,3 @@
+import type { Provider } from "@elizaos/core";
+export declare const workThreadsProvider: Provider;
+//# sourceMappingURL=work-threads.d.ts.map

package/dist/providers/work-threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-threads.d.ts","sourceRoot":"","sources":["../../src/providers/work-threads.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,QAAQ,EAGT,MAAM,eAAe,CAAC;AAyDvB,eAAO,MAAM,mBAAmB,EAAE,QAsEjC,CAAC"}

package/dist/providers/work-threads.js

@@ -0,0 +1,97 @@
+import { hasOwnerAccess } from "@elizaos/agent";
+import {
+  createWorkThreadStore
+} from "../lifeops/work-threads/index.js";
+const EMPTY = {
+  text: "",
+  values: { workThreadCount: 0 },
+  data: { workThreads: [] }
+};
+const MAX_THREADS = 8;
+function threadMutability(thread, roomId) {
+  const refs = [thread.primarySourceRef, ...thread.sourceRefs];
+  const currentRoomRef = roomId ? refs.find((ref) => ref.roomId === roomId) : void 0;
+  if (currentRoomRef?.canMutate) {
+    return "mutable-current-channel";
+  }
+  if (currentRoomRef?.canRead) {
+    return "read-only-current-channel";
+  }
+  return "read-only-cross-channel";
+}
+function renderWorkThreadsText(threads, roomId) {
+  if (threads.length === 0) {
+    return "";
+  }
+  const lines = threads.slice(0, MAX_THREADS).map((thread) => {
+    const source = thread.primarySourceRef;
+    const channel = source.channelName ?? source.roomId ?? source.externalThreadId ?? "unknown-channel";
+    const plan = thread.currentPlanSummary ? ` plan=${thread.currentPlanSummary}` : "";
+    return `- ${thread.id} [${thread.status}; ${threadMutability(thread, roomId)}; ${source.connector}/${channel}]: ${thread.title} - ${thread.summary}${plan}`;
+  });
+  if (threads.length > MAX_THREADS) {
+    lines.push(`(+${threads.length - MAX_THREADS} more)`);
+  }
+  return [
+    "Active LifeOps work threads:",
+    "Use lifeops_thread_control only for lifecycle/routing. Cross-channel entries are read-only unless current-channel mutability is shown.",
+    ...lines
+  ].join("\n");
+}
+const workThreadsProvider = {
+  name: "workThreads",
+  description: "Surfaces active LifeOps work threads for the current room and owner. Current-room mutable refs may be steered; cross-channel refs are read-only summaries.",
+  descriptionCompressed: "Active work threads: current-channel mutable, cross-channel read-only summaries.",
+  dynamic: true,
+  position: 12,
+  cacheScope: "turn",
+  contexts: ["tasks", "messaging", "automation"],
+  async get(runtime, message, _state) {
+    if (!await hasOwnerAccess(runtime, message)) {
+      return EMPTY;
+    }
+    const roomId = typeof message.roomId === "string" ? message.roomId : null;
+    const ownerEntityId = typeof message.entityId === "string" && message.entityId.length > 0 ? message.entityId : void 0;
+    const store = createWorkThreadStore(runtime);
+    const currentRoomThreads = roomId ? await store.list({
+      statuses: ["active", "waiting", "paused"],
+      roomId,
+      limit: MAX_THREADS
+    }) : [];
+    const ownerThreads = ownerEntityId ? await store.list({
+      statuses: ["active", "waiting", "paused"],
+      ownerEntityId,
+      includeCrossChannel: true,
+      limit: MAX_THREADS
+    }) : [];
+    const byId = /* @__PURE__ */ new Map();
+    for (const thread of [...currentRoomThreads, ...ownerThreads]) {
+      byId.set(thread.id, thread);
+    }
+    const currentRoomThreadIds = new Set(
+      currentRoomThreads.map((thread) => thread.id)
+    );
+    const threads = [...byId.values()].sort((a, b) => {
+      const currentRoomDelta = Number(currentRoomThreadIds.has(b.id)) - Number(currentRoomThreadIds.has(a.id));
+      if (currentRoomDelta !== 0) {
+        return currentRoomDelta;
+      }
+      return Date.parse(b.lastActivityAt) - Date.parse(a.lastActivityAt);
+    }).slice(0, MAX_THREADS);
+    if (threads.length === 0) {
+      return EMPTY;
+    }
+    return {
+      text: renderWorkThreadsText(threads, roomId),
+      values: {
+        workThreadCount: threads.length,
+        workThreadIds: threads.map((thread) => thread.id)
+      },
+      data: { workThreads: threads }
+    };
+  }
+};
+export {
+  workThreadsProvider
+};
+//# sourceMappingURL=work-threads.js.map

package/dist/providers/work-threads.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/work-threads.ts"],"sourcesContent":["import { hasOwnerAccess } from \"@elizaos/agent\";\nimport type {\n  IAgentRuntime,\n  Memory,\n  Provider,\n  ProviderResult,\n  State,\n} from \"@elizaos/core\";\nimport {\n  createWorkThreadStore,\n  type WorkThread,\n} from \"../lifeops/work-threads/index.js\";\n\nconst EMPTY: ProviderResult = {\n  text: \"\",\n  values: { workThreadCount: 0 },\n  data: { workThreads: [] },\n};\n\nconst MAX_THREADS = 8;\n\nfunction threadMutability(thread: WorkThread, roomId: string | null): string {\n  const refs = [thread.primarySourceRef, ...thread.sourceRefs];\n  const currentRoomRef = roomId\n    ? refs.find((ref) => ref.roomId === roomId)\n    : undefined;\n  if (currentRoomRef?.canMutate) {\n    return \"mutable-current-channel\";\n  }\n  if (currentRoomRef?.canRead) {\n    return \"read-only-current-channel\";\n  }\n  return \"read-only-cross-channel\";\n}\n\nfunction renderWorkThreadsText(\n  threads: WorkThread[],\n  roomId: string | null,\n): string {\n  if (threads.length === 0) {\n    return \"\";\n  }\n  const lines = threads.slice(0, MAX_THREADS).map((thread) => {\n    const source = thread.primarySourceRef;\n    const channel =\n      source.channelName ??\n      source.roomId ??\n      source.externalThreadId ??\n      \"unknown-channel\";\n    const plan = thread.currentPlanSummary\n      ? ` plan=${thread.currentPlanSummary}`\n      : \"\";\n    return `- ${thread.id} [${thread.status}; ${threadMutability(thread, roomId)}; ${source.connector}/${channel}]: ${thread.title} - ${thread.summary}${plan}`;\n  });\n  if (threads.length > MAX_THREADS) {\n    lines.push(`(+${threads.length - MAX_THREADS} more)`);\n  }\n  return [\n    \"Active LifeOps work threads:\",\n    \"Use lifeops_thread_control only for lifecycle/routing. Cross-channel entries are read-only unless current-channel mutability is shown.\",\n    ...lines,\n  ].join(\"\\n\");\n}\n\nexport const workThreadsProvider: Provider = {\n  name: \"workThreads\",\n  description:\n    \"Surfaces active LifeOps work threads for the current room and owner. Current-room mutable refs may be steered; cross-channel refs are read-only summaries.\",\n  descriptionCompressed:\n    \"Active work threads: current-channel mutable, cross-channel read-only summaries.\",\n  dynamic: true,\n  position: 12,\n  cacheScope: \"turn\",\n  contexts: [\"tasks\", \"messaging\", \"automation\"],\n\n  async get(\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state: State,\n  ): Promise<ProviderResult> {\n    if (!(await hasOwnerAccess(runtime, message))) {\n      return EMPTY;\n    }\n    const roomId = typeof message.roomId === \"string\" ? message.roomId : null;\n    const ownerEntityId =\n      typeof message.entityId === \"string\" && message.entityId.length > 0\n        ? message.entityId\n        : undefined;\n    const store = createWorkThreadStore(runtime);\n    const currentRoomThreads = roomId\n      ? await store.list({\n          statuses: [\"active\", \"waiting\", \"paused\"],\n          roomId,\n          limit: MAX_THREADS,\n        })\n      : [];\n    const ownerThreads = ownerEntityId\n      ? await store.list({\n          statuses: [\"active\", \"waiting\", \"paused\"],\n          ownerEntityId,\n          includeCrossChannel: true,\n          limit: MAX_THREADS,\n        })\n      : [];\n    const byId = new Map<string, WorkThread>();\n    for (const thread of [...currentRoomThreads, ...ownerThreads]) {\n      byId.set(thread.id, thread);\n    }\n    const currentRoomThreadIds = new Set(\n      currentRoomThreads.map((thread) => thread.id),\n    );\n    const threads = [...byId.values()]\n      .sort((a, b) => {\n        const currentRoomDelta =\n          Number(currentRoomThreadIds.has(b.id)) -\n          Number(currentRoomThreadIds.has(a.id));\n        if (currentRoomDelta !== 0) {\n          return currentRoomDelta;\n        }\n        return Date.parse(b.lastActivityAt) - Date.parse(a.lastActivityAt);\n      })\n      .slice(0, MAX_THREADS);\n    if (threads.length === 0) {\n      return EMPTY;\n    }\n    return {\n      text: renderWorkThreadsText(threads, roomId),\n      values: {\n        workThreadCount: threads.length,\n        workThreadIds: threads.map((thread) => thread.id),\n      },\n      data: { workThreads: threads },\n    };\n  },\n};\n"],"mappings":"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","names":[]}

package/dist/public.d.ts

@@ -0,0 +1,3 @@
+export { personalAssistantRoutesPlugin } from "./routes/plugin.js";
+export { getSelfControlPermissionState, openSelfControlPermissionLocation, requestSelfControlPermission, websiteBlockAction, } from "./website-blocker/public.js";
+//# sourceMappingURL=public.d.ts.map

package/dist/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,6BAA6B,CAAC"}

package/dist/public.js

@@ -0,0 +1,17 @@
+import { registerLifeOpsAutomationNodeContributor } from "./automation-node-contributor.js";
+import { personalAssistantRoutesPlugin } from "./routes/plugin.js";
+import {
+  getSelfControlPermissionState,
+  openSelfControlPermissionLocation,
+  requestSelfControlPermission,
+  websiteBlockAction
+} from "./website-blocker/public.js";
+registerLifeOpsAutomationNodeContributor();
+export {
+  getSelfControlPermissionState,
+  openSelfControlPermissionLocation,
+  personalAssistantRoutesPlugin,
+  requestSelfControlPermission,
+  websiteBlockAction
+};
+//# sourceMappingURL=public.js.map

package/dist/public.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/public.ts"],"sourcesContent":["import { registerLifeOpsAutomationNodeContributor } from \"./automation-node-contributor.js\";\n\nexport { personalAssistantRoutesPlugin } from \"./routes/plugin.js\";\nexport {\n  getSelfControlPermissionState,\n  openSelfControlPermissionLocation,\n  requestSelfControlPermission,\n  websiteBlockAction,\n} from \"./website-blocker/public.js\";\n\nregisterLifeOpsAutomationNodeContributor();\n"],"mappings":"AAAA,SAAS,gDAAgD;AAEzD,SAAS,qCAAqC;AAC9C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,yCAAyC;","names":[]}