@elizaos/plugin-inbox 2.0.3-beta.6 → 2.0.3-beta.7

package/dist/providers/cross-channel-context.js

@@ -0,0 +1,96 @@
+import { hasOwnerAccess } from "@elizaos/agent/security/access";
+import { logger } from "@elizaos/core";
+import { InboxRepository } from "../inbox/repository.js";
+const EMPTY = { text: "", values: {}, data: {} };
+const MAX_ENTRIES = 8;
+async function resolveSenderLabel(runtime, message) {
+  const entityId = typeof message.entityId === "string" && message.entityId.length > 0 ? message.entityId : null;
+  let name = null;
+  if (entityId) {
+    try {
+      const entity = await runtime.getEntityById?.(entityId);
+      const metaName = entity?.metadata?.name;
+      name = entity?.names?.[0] ?? (typeof metaName === "string" ? metaName : null);
+    } catch {
+    }
+  }
+  return { entityId, name };
+}
+function matchesSender(entry, entityId, name, currentSource) {
+  if (entry.source === currentSource) return false;
+  if (entityId && entry.sourceEntityId === entityId) return true;
+  if (name && entry.senderName) {
+    const needle = name.toLowerCase();
+    const haystack = entry.senderName.toLowerCase();
+    return haystack.includes(needle) || needle.includes(haystack);
+  }
+  return false;
+}
+function escapeMarkdownText(value) {
+  return value.replaceAll("\\", "\\\\").replaceAll("`", "\\`").replaceAll("*", "\\*").replaceAll("_", "\\_").replaceAll("[", "\\[").replaceAll("]", "\\]").replaceAll("(", "\\(").replaceAll(")", "\\)").replaceAll("#", "\\#").replaceAll(">", "\\>").replaceAll("|", "\\|").replaceAll("\n", " ");
+}
+function formatEntry(entry) {
+  const when = entry.createdAt ? new Date(entry.createdAt).toISOString().slice(0, 10) : "recently";
+  const channelName = escapeMarkdownText(entry.channelName);
+  const source = escapeMarkdownText(entry.source);
+  const snippet = escapeMarkdownText(entry.snippet.slice(0, 80));
+  const tag = entry.classification === "urgent" ? " \u26A0\uFE0F" : "";
+  return `- **${channelName}** (${source}, ${when})${tag}: "${snippet}"`;
+}
+const crossChannelContextProvider = {
+  name: "inboxCrossChannelContext",
+  description: "Injects recent triage entries from the current message sender across other channels. Use when the owner asks about a person or thread \u2014 surfaces cross-channel history automatically.",
+  descriptionCompressed: "Current sender's cross-channel triage history (other channels).",
+  dynamic: true,
+  position: -3,
+  contexts: ["messaging", "email", "inbox"],
+  contextGate: { anyOf: ["messaging", "email", "inbox"] },
+  cacheScope: "turn",
+  roleGate: { minRole: "OWNER" },
+  async get(runtime, message, _state) {
+    if (!await hasOwnerAccess(runtime, message)) return EMPTY;
+    const { entityId, name } = await resolveSenderLabel(runtime, message);
+    if (!entityId && !name) return EMPTY;
+    const currentSource = typeof message.content?.source === "string" ? message.content.source : "";
+    let repo;
+    try {
+      repo = new InboxRepository(runtime);
+    } catch {
+      return EMPTY;
+    }
+    let entries;
+    try {
+      entries = await repo.getUnresolvedForSender({
+        sourceEntityId: entityId,
+        senderName: name,
+        excludeSource: currentSource,
+        limit: MAX_ENTRIES
+      });
+    } catch (error) {
+      logger.debug("[cross-channel-context] DB query failed:", String(error));
+      return EMPTY;
+    }
+    const matched = entries.filter(
+      (e) => matchesSender(e, entityId, name, currentSource)
+    );
+    if (matched.length === 0) return EMPTY;
+    const senderLabel = escapeMarkdownText(name ?? entityId ?? "this sender");
+    const lines = [
+      `# ${senderLabel} \u2014 cross-channel activity (${matched.length} threads)`
+    ];
+    for (const entry of matched) {
+      lines.push(formatEntry(entry));
+    }
+    return {
+      text: lines.join("\n"),
+      values: { crossChannelCount: matched.length },
+      data: { entries: matched }
+    };
+  }
+};
+var cross_channel_context_default = crossChannelContextProvider;
+export {
+  crossChannelContextProvider,
+  cross_channel_context_default as default
+};
+//# sourceMappingURL=cross-channel-context.js.map

package/dist/providers/cross-channel-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/cross-channel-context.ts"],"sourcesContent":["/**\n * CROSS_CHANNEL_CONTEXT provider.\n *\n * When the owner is in a conversation, this injects any recent triage entries\n * from the same sender across *other* channels — so if someone DM'd on Discord\n * and also emailed, both threads surface in the same planner turn.\n *\n * Resolution order:\n *   1. Match triage entries by entityId (most precise — UUID identity).\n *   2. Fall back to case-insensitive senderName substring match.\n *\n * Owner-only (same gate as inboxTriage). Silently returns empty when:\n *   - the caller is not the owner,\n *   - the runtime DB is unavailable,\n *   - no sender can be resolved from the current message,\n *   - or no cross-channel entries exist for that sender.\n */\n\nimport { hasOwnerAccess } from \"@elizaos/agent/security/access\";\nimport type {\n  IAgentRuntime,\n  Memory,\n  Provider,\n  ProviderResult,\n  State,\n} from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport { InboxRepository } from \"../inbox/repository.js\";\nimport type { TriageEntry } from \"../inbox/types.js\";\n\nconst EMPTY: ProviderResult = { text: \"\", values: {}, data: {} };\n\nconst MAX_ENTRIES = 8;\n\nasync function resolveSenderLabel(\n  runtime: IAgentRuntime,\n  message: Memory,\n): Promise<{ entityId: string | null; name: string | null }> {\n  const entityId =\n    typeof message.entityId === \"string\" && message.entityId.length > 0\n      ? message.entityId\n      : null;\n\n  let name: string | null = null;\n  if (entityId) {\n    try {\n      const entity = await runtime.getEntityById?.(entityId);\n      const metaName = entity?.metadata?.name;\n      name =\n        entity?.names?.[0] ?? (typeof metaName === \"string\" ? metaName : null);\n    } catch {\n      // entity lookup is best-effort\n    }\n  }\n\n  return { entityId, name };\n}\n\nfunction matchesSender(\n  entry: TriageEntry,\n  entityId: string | null,\n  name: string | null,\n  currentSource: string,\n): boolean {\n  // Skip entries from the same source — the planner already sees this channel.\n  if (entry.source === currentSource) return false;\n\n  if (entityId && entry.sourceEntityId === entityId) return true;\n\n  if (name && entry.senderName) {\n    const needle = name.toLowerCase();\n    const haystack = entry.senderName.toLowerCase();\n    return haystack.includes(needle) || needle.includes(haystack);\n  }\n\n  return false;\n}\n\nfunction escapeMarkdownText(value: string): string {\n  return value\n    .replaceAll(\"\\\\\", \"\\\\\\\\\")\n    .replaceAll(\"`\", \"\\\\`\")\n    .replaceAll(\"*\", \"\\\\*\")\n    .replaceAll(\"_\", \"\\\\_\")\n    .replaceAll(\"[\", \"\\\\[\")\n    .replaceAll(\"]\", \"\\\\]\")\n    .replaceAll(\"(\", \"\\\\(\")\n    .replaceAll(\")\", \"\\\\)\")\n    .replaceAll(\"#\", \"\\\\#\")\n    .replaceAll(\">\", \"\\\\>\")\n    .replaceAll(\"|\", \"\\\\|\")\n    .replaceAll(\"\\n\", \" \");\n}\n\nfunction formatEntry(entry: TriageEntry): string {\n  const when = entry.createdAt\n    ? new Date(entry.createdAt).toISOString().slice(0, 10)\n    : \"recently\";\n  const channelName = escapeMarkdownText(entry.channelName);\n  const source = escapeMarkdownText(entry.source);\n  const snippet = escapeMarkdownText(entry.snippet.slice(0, 80));\n  const tag = entry.classification === \"urgent\" ? \" ⚠️\" : \"\";\n  return `- **${channelName}** (${source}, ${when})${tag}: \"${snippet}\"`;\n}\n\nexport const crossChannelContextProvider: Provider = {\n  name: \"inboxCrossChannelContext\",\n  description:\n    \"Injects recent triage entries from the current message sender across other channels. \" +\n    \"Use when the owner asks about a person or thread — surfaces cross-channel history automatically.\",\n  descriptionCompressed:\n    \"Current sender's cross-channel triage history (other channels).\",\n  dynamic: true,\n  position: -3,\n  contexts: [\"messaging\", \"email\", \"inbox\"],\n  contextGate: { anyOf: [\"messaging\", \"email\", \"inbox\"] },\n  cacheScope: \"turn\",\n  roleGate: { minRole: \"OWNER\" },\n\n  async get(\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state: State,\n  ): Promise<ProviderResult> {\n    if (!(await hasOwnerAccess(runtime, message))) return EMPTY;\n\n    const { entityId, name } = await resolveSenderLabel(runtime, message);\n    if (!entityId && !name) return EMPTY;\n\n    const currentSource =\n      typeof (message.content as { source?: string })?.source === \"string\"\n        ? (message.content as { source: string }).source\n        : \"\";\n\n    let repo: InboxRepository;\n    try {\n      repo = new InboxRepository(runtime);\n    } catch {\n      return EMPTY;\n    }\n\n    let entries: TriageEntry[];\n    try {\n      entries = await repo.getUnresolvedForSender({\n        sourceEntityId: entityId,\n        senderName: name,\n        excludeSource: currentSource,\n        limit: MAX_ENTRIES,\n      });\n    } catch (error) {\n      logger.debug(\"[cross-channel-context] DB query failed:\", String(error));\n      return EMPTY;\n    }\n\n    const matched = entries.filter((e) =>\n      matchesSender(e, entityId, name, currentSource),\n    );\n\n    if (matched.length === 0) return EMPTY;\n\n    const senderLabel = escapeMarkdownText(name ?? entityId ?? \"this sender\");\n    const lines: string[] = [\n      `# ${senderLabel} — cross-channel activity (${matched.length} threads)`,\n    ];\n    for (const entry of matched) {\n      lines.push(formatEntry(entry));\n    }\n\n    return {\n      text: lines.join(\"\\n\"),\n      values: { crossChannelCount: matched.length },\n      data: { entries: matched },\n    };\n  },\n};\n\nexport default crossChannelContextProvider;\n"],"mappings":"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","names":[]}

package/dist/providers/inbox-triage.d.ts

@@ -0,0 +1,12 @@
+import type { Provider } from "@elizaos/core";
+/**
+ * inboxTriage provider — injects pending inbox triage items into owner context.
+ *
+ * Owner-only (`roleGate.minRole: OWNER` + the `hasOwnerAccess` gate below).
+ * Because it only ever runs for the owner, the LifeOps egress redaction it used
+ * is always a pass-through, so the ported provider surfaces the owner's full
+ * triage snippets and deep links — observably identical to the LifeOps version.
+ */
+export declare const inboxTriageProvider: Provider;
+export default inboxTriageProvider;
+//# sourceMappingURL=inbox-triage.d.ts.map

package/dist/providers/inbox-triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-triage.d.ts","sourceRoot":"","sources":["../../src/providers/inbox-triage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,QAAQ,EAGT,MAAM,eAAe,CAAC;AAWvB;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAiGjC,CAAC;AASF,eAAe,mBAAmB,CAAC"}

package/dist/providers/inbox-triage.js

@@ -0,0 +1,98 @@
+import { hasOwnerAccess } from "@elizaos/agent/security/access";
+import { logger } from "@elizaos/core";
+import { InboxRepository } from "../inbox/repository.js";
+const EMPTY = {
+  text: "",
+  values: { inboxUnresolved: 0, inboxUrgent: 0 },
+  data: {}
+};
+const inboxTriageProvider = {
+  name: "inboxTriage",
+  description: "Injects pending inbox triage items into owner context. Shows urgent messages, items needing reply, and recent auto-replies across all channels including email. Use MESSAGE action=triage/list_inbox/search_inbox/respond/draft_reply/send_draft for cross-channel triage, digest, respond, Gmail search/read, and Gmail draft/send reply workflows. If the request is Gmail-only, MESSAGE should use source=gmail; if it is just 'my inbox', MESSAGE should use the cross-channel path.",
+  descriptionCompressed: "Pending inbox triage items across all channels incl email.",
+  dynamic: true,
+  position: 14,
+  // after lifeops (12), before escalation (15)
+  contexts: ["email", "messaging", "tasks"],
+  contextGate: { anyOf: ["email", "messaging", "tasks"] },
+  cacheScope: "turn",
+  roleGate: { minRole: "OWNER" },
+  async get(runtime, message, _state) {
+    if (!await hasOwnerAccess(runtime, message)) {
+      return EMPTY;
+    }
+    let repo;
+    try {
+      repo = new InboxRepository(runtime);
+    } catch {
+      return EMPTY;
+    }
+    let urgent;
+    let needsReply;
+    let recentAutoReplies;
+    try {
+      [urgent, needsReply, recentAutoReplies] = await Promise.all([
+        repo.getByClassification("urgent", { limit: 5 }),
+        repo.getByClassification("needs_reply", { limit: 10 }),
+        repo.getRecentAutoReplies(5)
+      ]);
+    } catch (error) {
+      logger.debug(
+        "[inbox-triage-provider] DB query failed (schema may not exist yet):",
+        String(error)
+      );
+      return EMPTY;
+    }
+    const unresolved = urgent.length + needsReply.length;
+    if (unresolved === 0 && recentAutoReplies.length === 0) {
+      return EMPTY;
+    }
+    const lines = [`# Inbox: ${unresolved} items pending`];
+    if (urgent.length > 0) {
+      lines.push("\n## Urgent");
+      for (const item of urgent.slice(0, 3)) {
+        lines.push(formatEntry(item));
+      }
+    }
+    if (needsReply.length > 0) {
+      lines.push("\n## Needs Reply");
+      for (const item of needsReply.slice(0, 5)) {
+        lines.push(formatEntry(item));
+      }
+    }
+    if (recentAutoReplies.length > 0) {
+      lines.push("\n## Recent Auto-Replies");
+      for (const item of recentAutoReplies) {
+        const draftPreview = item.draftResponse ? `"${item.draftResponse.slice(0, 60)}..."` : "(no draft)";
+        lines.push(`- Sent to ${item.channelName}: ${draftPreview}`);
+      }
+    }
+    lines.push("\nSay 'respond to [name/channel]' to draft and send replies.");
+    return {
+      text: lines.join("\n"),
+      values: {
+        inboxUnresolved: unresolved,
+        inboxUrgent: urgent.length,
+        inboxNeedsReply: needsReply.length
+      },
+      data: {
+        urgentItems: urgent,
+        needsReplyItems: needsReply,
+        recentAutoReplies
+      }
+    };
+  }
+};
+function formatEntry(entry) {
+  const senderInfo = entry.senderName ? ` from ${entry.senderName}` : "";
+  const link = entry.deepLink ? `
+  ${entry.deepLink}` : "";
+  const snippet = entry.snippet.slice(0, 80);
+  return `- **${entry.channelName}**${senderInfo} (${entry.source}): "${snippet}"${link}`;
+}
+var inbox_triage_default = inboxTriageProvider;
+export {
+  inbox_triage_default as default,
+  inboxTriageProvider
+};
+//# sourceMappingURL=inbox-triage.js.map

package/dist/providers/inbox-triage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/inbox-triage.ts"],"sourcesContent":["import { hasOwnerAccess } from \"@elizaos/agent/security/access\";\nimport type {\n  IAgentRuntime,\n  Memory,\n  Provider,\n  ProviderResult,\n  State,\n} from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport { InboxRepository } from \"../inbox/repository.js\";\nimport type { TriageEntry } from \"../inbox/types.js\";\n\nconst EMPTY: ProviderResult = {\n  text: \"\",\n  values: { inboxUnresolved: 0, inboxUrgent: 0 },\n  data: {},\n};\n\n/**\n * inboxTriage provider — injects pending inbox triage items into owner context.\n *\n * Owner-only (`roleGate.minRole: OWNER` + the `hasOwnerAccess` gate below).\n * Because it only ever runs for the owner, the LifeOps egress redaction it used\n * is always a pass-through, so the ported provider surfaces the owner's full\n * triage snippets and deep links — observably identical to the LifeOps version.\n */\nexport const inboxTriageProvider: Provider = {\n  name: \"inboxTriage\",\n  description:\n    \"Injects pending inbox triage items into owner context. Shows urgent messages, \" +\n    \"items needing reply, and recent auto-replies across all channels including email. \" +\n    \"Use MESSAGE action=triage/list_inbox/search_inbox/respond/draft_reply/send_draft for cross-channel triage, digest, respond, Gmail search/read, and Gmail draft/send reply workflows. \" +\n    \"If the request is Gmail-only, MESSAGE should use source=gmail; if it is just 'my inbox', MESSAGE should use the cross-channel path.\",\n  descriptionCompressed:\n    \"Pending inbox triage items across all channels incl email.\",\n  dynamic: true,\n  position: 14, // after lifeops (12), before escalation (15)\n  contexts: [\"email\", \"messaging\", \"tasks\"],\n  contextGate: { anyOf: [\"email\", \"messaging\", \"tasks\"] },\n  cacheScope: \"turn\",\n  roleGate: { minRole: \"OWNER\" },\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\n    let repo: InboxRepository;\n    try {\n      repo = new InboxRepository(runtime);\n    } catch {\n      return EMPTY;\n    }\n\n    let urgent: TriageEntry[];\n    let needsReply: TriageEntry[];\n    let recentAutoReplies: TriageEntry[];\n\n    try {\n      [urgent, needsReply, recentAutoReplies] = await Promise.all([\n        repo.getByClassification(\"urgent\", { limit: 5 }),\n        repo.getByClassification(\"needs_reply\", { limit: 10 }),\n        repo.getRecentAutoReplies(5),\n      ]);\n    } catch (error) {\n      logger.debug(\n        \"[inbox-triage-provider] DB query failed (schema may not exist yet):\",\n        String(error),\n      );\n      return EMPTY;\n    }\n\n    const unresolved = urgent.length + needsReply.length;\n    if (unresolved === 0 && recentAutoReplies.length === 0) {\n      return EMPTY;\n    }\n\n    const lines: string[] = [`# Inbox: ${unresolved} items pending`];\n\n    if (urgent.length > 0) {\n      lines.push(\"\\n## Urgent\");\n      for (const item of urgent.slice(0, 3)) {\n        lines.push(formatEntry(item));\n      }\n    }\n\n    if (needsReply.length > 0) {\n      lines.push(\"\\n## Needs Reply\");\n      for (const item of needsReply.slice(0, 5)) {\n        lines.push(formatEntry(item));\n      }\n    }\n\n    if (recentAutoReplies.length > 0) {\n      lines.push(\"\\n## Recent Auto-Replies\");\n      for (const item of recentAutoReplies) {\n        const draftPreview = item.draftResponse\n          ? `\"${item.draftResponse.slice(0, 60)}...\"`\n          : \"(no draft)\";\n        lines.push(`- Sent to ${item.channelName}: ${draftPreview}`);\n      }\n    }\n\n    lines.push(\"\\nSay 'respond to [name/channel]' to draft and send replies.\");\n\n    return {\n      text: lines.join(\"\\n\"),\n      values: {\n        inboxUnresolved: unresolved,\n        inboxUrgent: urgent.length,\n        inboxNeedsReply: needsReply.length,\n      },\n      data: {\n        urgentItems: urgent,\n        needsReplyItems: needsReply,\n        recentAutoReplies,\n      },\n    };\n  },\n};\n\nfunction formatEntry(entry: TriageEntry): string {\n  const senderInfo = entry.senderName ? ` from ${entry.senderName}` : \"\";\n  const link = entry.deepLink ? `\\n  ${entry.deepLink}` : \"\";\n  const snippet = entry.snippet.slice(0, 80);\n  return `- **${entry.channelName}**${senderInfo} (${entry.source}): \"${snippet}\"${link}`;\n}\n\nexport default inboxTriageProvider;\n"],"mappings":"AAAA,SAAS,sBAAsB;AAQ/B,SAAS,cAAc;AACvB,SAAS,uBAAuB;AAGhC,MAAM,QAAwB;AAAA,EAC5B,MAAM;AAAA,EACN,QAAQ,EAAE,iBAAiB,GAAG,aAAa,EAAE;AAAA,EAC7C,MAAM,CAAC;AACT;AAUO,MAAM,sBAAgC;AAAA,EAC3C,MAAM;AAAA,EACN,aACE;AAAA,EAIF,uBACE;AAAA,EACF,SAAS;AAAA,EACT,UAAU;AAAA;AAAA,EACV,UAAU,CAAC,SAAS,aAAa,OAAO;AAAA,EACxC,aAAa,EAAE,OAAO,CAAC,SAAS,aAAa,OAAO,EAAE;AAAA,EACtD,YAAY;AAAA,EACZ,UAAU,EAAE,SAAS,QAAQ;AAAA,EAE7B,MAAM,IACJ,SACA,SACA,QACyB;AACzB,QAAI,CAAE,MAAM,eAAe,SAAS,OAAO,GAAI;AAC7C,aAAO;AAAA,IACT;AAEA,QAAI;AACJ,QAAI;AACF,aAAO,IAAI,gBAAgB,OAAO;AAAA,IACpC,QAAQ;AACN,aAAO;AAAA,IACT;AAEA,QAAI;AACJ,QAAI;AACJ,QAAI;AAEJ,QAAI;AACF,OAAC,QAAQ,YAAY,iBAAiB,IAAI,MAAM,QAAQ,IAAI;AAAA,QAC1D,KAAK,oBAAoB,UAAU,EAAE,OAAO,EAAE,CAAC;AAAA,QAC/C,KAAK,oBAAoB,eAAe,EAAE,OAAO,GAAG,CAAC;AAAA,QACrD,KAAK,qBAAqB,CAAC;AAAA,MAC7B,CAAC;AAAA,IACH,SAAS,OAAO;AACd,aAAO;AAAA,QACL;AAAA,QACA,OAAO,KAAK;AAAA,MACd;AACA,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,OAAO,SAAS,WAAW;AAC9C,QAAI,eAAe,KAAK,kBAAkB,WAAW,GAAG;AACtD,aAAO;AAAA,IACT;AAEA,UAAM,QAAkB,CAAC,YAAY,UAAU,gBAAgB;AAE/D,QAAI,OAAO,SAAS,GAAG;AACrB,YAAM,KAAK,aAAa;AACxB,iBAAW,QAAQ,OAAO,MAAM,GAAG,CAAC,GAAG;AACrC,cAAM,KAAK,YAAY,IAAI,CAAC;AAAA,MAC9B;AAAA,IACF;AAEA,QAAI,WAAW,SAAS,GAAG;AACzB,YAAM,KAAK,kBAAkB;AAC7B,iBAAW,QAAQ,WAAW,MAAM,GAAG,CAAC,GAAG;AACzC,cAAM,KAAK,YAAY,IAAI,CAAC;AAAA,MAC9B;AAAA,IACF;AAEA,QAAI,kBAAkB,SAAS,GAAG;AAChC,YAAM,KAAK,0BAA0B;AACrC,iBAAW,QAAQ,mBAAmB;AACpC,cAAM,eAAe,KAAK,gBACtB,IAAI,KAAK,cAAc,MAAM,GAAG,EAAE,CAAC,SACnC;AACJ,cAAM,KAAK,aAAa,KAAK,WAAW,KAAK,YAAY,EAAE;AAAA,MAC7D;AAAA,IACF;AAEA,UAAM,KAAK,8DAA8D;AAEzE,WAAO;AAAA,MACL,MAAM,MAAM,KAAK,IAAI;AAAA,MACrB,QAAQ;AAAA,QACN,iBAAiB;AAAA,QACjB,aAAa,OAAO;AAAA,QACpB,iBAAiB,WAAW;AAAA,MAC9B;AAAA,MACA,MAAM;AAAA,QACJ,aAAa;AAAA,QACb,iBAAiB;AAAA,QACjB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,YAAY,OAA4B;AAC/C,QAAM,aAAa,MAAM,aAAa,SAAS,MAAM,UAAU,KAAK;AACpE,QAAM,OAAO,MAAM,WAAW;AAAA,IAAO,MAAM,QAAQ,KAAK;AACxD,QAAM,UAAU,MAAM,QAAQ,MAAM,GAAG,EAAE;AACzC,SAAO,OAAO,MAAM,WAAW,KAAK,UAAU,KAAK,MAAM,MAAM,OAAO,OAAO,IAAI,IAAI;AACvF;AAEA,IAAO,uBAAQ;","names":[]}

package/dist/register-terminal-view.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Register the inbox view for terminal rendering.
+ *
+ * The agent terminal mounts plugin views by id from the `@elizaos/tui` terminal
+ * registry. This makes the inbox `tui` modality render for real in the terminal
+ * (the unified {@link InboxSpatialView}) rather than only navigating a GUI
+ * shell. A module-level snapshot lets a host push live inbox data; on a host
+ * with no inbox data it defaults to the loading snapshot.
+ */
+import { type InboxSnapshot } from "./components/inbox/InboxSpatialView.js";
+/** Update the snapshot the registered terminal view renders from. */
+export declare function setInboxTerminalSnapshot(next: InboxSnapshot): void;
+/** Register the inbox terminal view; returns an unregister function. */
+export declare function registerInboxTerminalView(): () => void;
+//# sourceMappingURL=register-terminal-view.d.ts.map

package/dist/register-terminal-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-terminal-view.d.ts","sourceRoot":"","sources":["../src/register-terminal-view.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,yCAAyC,CAAC;AAIjD,qEAAqE;AACrE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAElE;AAED,wEAAwE;AACxE,wBAAgB,yBAAyB,IAAI,MAAM,IAAI,CAItD"}

package/dist/register-terminal-view.js

@@ -0,0 +1,21 @@
+import { registerSpatialTerminalView } from "@elizaos/ui/spatial/tui";
+import { createElement } from "react";
+import {
+  EMPTY_INBOX_SNAPSHOT,
+  InboxSpatialView
+} from "./components/inbox/InboxSpatialView.js";
+let current = EMPTY_INBOX_SNAPSHOT;
+function setInboxTerminalSnapshot(next) {
+  current = next;
+}
+function registerInboxTerminalView() {
+  return registerSpatialTerminalView(
+    "inbox",
+    () => createElement(InboxSpatialView, { snapshot: current })
+  );
+}
+export {
+  registerInboxTerminalView,
+  setInboxTerminalSnapshot
+};
+//# sourceMappingURL=register-terminal-view.js.map

package/dist/register-terminal-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register-terminal-view.tsx"],"sourcesContent":["/**\n * Register the inbox view for terminal rendering.\n *\n * The agent terminal mounts plugin views by id from the `@elizaos/tui` terminal\n * registry. This makes the inbox `tui` modality render for real in the terminal\n * (the unified {@link InboxSpatialView}) rather than only navigating a GUI\n * shell. A module-level snapshot lets a host push live inbox data; on a host\n * with no inbox data it defaults to the loading snapshot.\n */\n\nimport { registerSpatialTerminalView } from \"@elizaos/ui/spatial/tui\";\nimport { createElement } from \"react\";\nimport {\n  EMPTY_INBOX_SNAPSHOT,\n  type InboxSnapshot,\n  InboxSpatialView,\n} from \"./components/inbox/InboxSpatialView.js\";\n\nlet current: InboxSnapshot = EMPTY_INBOX_SNAPSHOT;\n\n/** Update the snapshot the registered terminal view renders from. */\nexport function setInboxTerminalSnapshot(next: InboxSnapshot): void {\n  current = next;\n}\n\n/** Register the inbox terminal view; returns an unregister function. */\nexport function registerInboxTerminalView(): () => void {\n  return registerSpatialTerminalView(\"inbox\", () =>\n    createElement(InboxSpatialView, { snapshot: current }),\n  );\n}\n"],"mappings":"AAUA,SAAS,mCAAmC;AAC5C,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EAEA;AAAA,OACK;AAEP,IAAI,UAAyB;AAGtB,SAAS,yBAAyB,MAA2B;AAClE,YAAU;AACZ;AAGO,SAAS,4BAAwC;AACtD,SAAO;AAAA,IAA4B;AAAA,IAAS,MAC1C,cAAc,kBAAkB,EAAE,UAAU,QAAQ,CAAC;AAAA,EACvD;AACF;","names":[]}

package/dist/register.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Side-effect entry point — registers the inbox view for terminal rendering.
+ *
+ * In a terminal host (the Node agent, no DOM), register the inbox view so it
+ * renders inline in the terminal. Lazy + DOM-guarded so the terminal engine
+ * stays out of browser/mobile bundles. Web, iOS, desktop, and Android leave the
+ * import inert, so the same import is safe everywhere.
+ */
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/register.js

@@ -0,0 +1,5 @@
+if (typeof window === "undefined") {
+  void import("./register-terminal-view.js").then((m) => m.registerInboxTerminalView()).catch(() => {
+  });
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register.ts"],"sourcesContent":["/**\n * Side-effect entry point — registers the inbox view for terminal rendering.\n *\n * In a terminal host (the Node agent, no DOM), register the inbox view so it\n * renders inline in the terminal. Lazy + DOM-guarded so the terminal engine\n * stays out of browser/mobile bundles. Web, iOS, desktop, and Android leave the\n * import inert, so the same import is safe everywhere.\n */\n\nif (typeof window === \"undefined\") {\n  void import(\"./register-terminal-view.js\")\n    .then((m) => m.registerInboxTerminalView())\n    .catch(() => {\n      // Terminal rendering is best-effort; never block plugin load.\n    });\n}\n"],"mappings":"AASA,IAAI,OAAO,WAAW,aAAa;AACjC,OAAK,OAAO,6BAA6B,EACtC,KAAK,CAAC,MAAM,EAAE,0BAA0B,CAAC,EACzC,MAAM,MAAM;AAAA,EAEb,CAAC;AACL;","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * View-facing type surface for @elizaos/plugin-inbox.
+ *
+ * These are the display contract the `InboxView` renders against. The triage
+ * back-end types (TriageEntry, TriageClassification, InboundMessage, …) live in
+ * `./inbox/types.ts`; the INBOX action's fan-out types live in
+ * `./actions/inbox.ts`. This plugin must not import from
+ * @elizaos/plugin-personal-assistant.
+ */
+/**
+ * Channels the unified inbox aggregates. These mirror the wire channel ids the
+ * inbox route emits (`LIFEOPS_INBOX_CHANNELS` in @elizaos/shared) so the view
+ * can group the real payload without a translation table. Defined locally —
+ * this plugin must not import from @elizaos/plugin-personal-assistant.
+ */
+export declare const INBOX_CHANNELS: readonly ["gmail", "x_dm", "discord", "telegram", "signal", "imessage", "whatsapp", "sms"];
+export type InboxChannel = (typeof INBOX_CHANNELS)[number];
+/** Human-readable label per channel, in display order. */
+export declare const INBOX_CHANNEL_LABELS: Record<InboxChannel, string>;
+/**
+ * One triage item rendered by the InboxView. This is the view's local display
+ * DTO, mapped at the fetch boundary from a `LifeOpsInboxMessage` on the wire
+ * (`GET /api/lifeops/inbox`). It is intentionally a flat, display-only shape —
+ * the view reads these fields and formats them, it never computes.
+ */
+export interface InboxItem {
+    /** Channel-prefixed, globally unique message id. */
+    id: string;
+    channel: InboxChannel;
+    /** Display name of the sender. */
+    sender: string;
+    /** Gmail-style subject; null for chat channels. */
+    subject: string | null;
+    /** One-line preview of the latest message. */
+    preview: string;
+    /** ISO-8601 timestamp the message was received. */
+    receivedAt: string;
+    unread: boolean;
+    /** Stable per-conversation key, when the wire supplies one. */
+    threadId: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,4FASjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAS7D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB"}

package/dist/types.js

@@ -0,0 +1,25 @@
+const INBOX_CHANNELS = [
+  "gmail",
+  "x_dm",
+  "discord",
+  "telegram",
+  "signal",
+  "imessage",
+  "whatsapp",
+  "sms"
+];
+const INBOX_CHANNEL_LABELS = {
+  gmail: "Email",
+  x_dm: "X",
+  discord: "Discord",
+  telegram: "Telegram",
+  signal: "Signal",
+  imessage: "iMessage",
+  whatsapp: "WhatsApp",
+  sms: "SMS"
+};
+export {
+  INBOX_CHANNELS,
+  INBOX_CHANNEL_LABELS
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * View-facing type surface for @elizaos/plugin-inbox.\n *\n * These are the display contract the `InboxView` renders against. The triage\n * back-end types (TriageEntry, TriageClassification, InboundMessage, …) live in\n * `./inbox/types.ts`; the INBOX action's fan-out types live in\n * `./actions/inbox.ts`. This plugin must not import from\n * @elizaos/plugin-personal-assistant.\n */\n\n/**\n * Channels the unified inbox aggregates. These mirror the wire channel ids the\n * inbox route emits (`LIFEOPS_INBOX_CHANNELS` in @elizaos/shared) so the view\n * can group the real payload without a translation table. Defined locally —\n * this plugin must not import from @elizaos/plugin-personal-assistant.\n */\nexport const INBOX_CHANNELS = [\n  \"gmail\",\n  \"x_dm\",\n  \"discord\",\n  \"telegram\",\n  \"signal\",\n  \"imessage\",\n  \"whatsapp\",\n  \"sms\",\n] as const;\nexport type InboxChannel = (typeof INBOX_CHANNELS)[number];\n\n/** Human-readable label per channel, in display order. */\nexport const INBOX_CHANNEL_LABELS: Record<InboxChannel, string> = {\n  gmail: \"Email\",\n  x_dm: \"X\",\n  discord: \"Discord\",\n  telegram: \"Telegram\",\n  signal: \"Signal\",\n  imessage: \"iMessage\",\n  whatsapp: \"WhatsApp\",\n  sms: \"SMS\",\n};\n\n/**\n * One triage item rendered by the InboxView. This is the view's local display\n * DTO, mapped at the fetch boundary from a `LifeOpsInboxMessage` on the wire\n * (`GET /api/lifeops/inbox`). It is intentionally a flat, display-only shape —\n * the view reads these fields and formats them, it never computes.\n */\nexport interface InboxItem {\n  /** Channel-prefixed, globally unique message id. */\n  id: string;\n  channel: InboxChannel;\n  /** Display name of the sender. */\n  sender: string;\n  /** Gmail-style subject; null for chat channels. */\n  subject: string | null;\n  /** One-line preview of the latest message. */\n  preview: string;\n  /** ISO-8601 timestamp the message was received. */\n  receivedAt: string;\n  unread: boolean;\n  /** Stable per-conversation key, when the wire supplies one. */\n  threadId: string | null;\n}\n"],"mappings":"AAgBO,MAAM,iBAAiB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,MAAM,uBAAqD;AAAA,EAChE,OAAO;AAAA,EACP,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,UAAU;AAAA,EACV,KAAK;AACP;","names":[]}