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

package/dist/actions/inbox.d.ts

@@ -0,0 +1,69 @@
+/**
+ * `INBOX` umbrella action — cross-channel inbox.
+ *
+ * The agent's `MESSAGE` umbrella triages per-channel inboxes; INBOX fans out to
+ * every connected platform (Gmail, Slack, Discord, Telegram, Signal, iMessage,
+ * WhatsApp) and produces a single merged feed for "show me my inbox" style
+ * intents.
+ *
+ * Subactions:
+ *   - `list`       — list recent messages across selected platforms
+ *   - `search`     — search across selected platforms by `query`
+ *   - `summarize`  — return a per-platform count + a single rolled-up summary
+ *
+ * Behavior: fan out to each platform's adapter via the injectable fetcher hook,
+ * dedupe by `id` and thread topic, merge into a single result list ordered by
+ * recency.
+ *
+ * Owner-only. Ported verbatim from the LifeOps INBOX action; the per-platform
+ * default fetchers read through the shared MESSAGE triage service, and tests
+ * inject deterministic fetchers via {@link setInboxFetchers}.
+ */
+import type { Action, IAgentRuntime } from "@elizaos/core";
+declare const SUBACTIONS: readonly ["list", "search", "summarize"];
+type Subaction = (typeof SUBACTIONS)[number];
+declare const PLATFORMS: readonly ["gmail", "slack", "discord", "telegram", "signal", "imessage", "whatsapp"];
+export type InboxPlatform = (typeof PLATFORMS)[number];
+export interface InboxItem {
+    readonly id: string;
+    readonly platform: InboxPlatform;
+    readonly channel: string;
+    readonly senderName: string;
+    readonly snippet: string;
+    readonly receivedAt: string;
+    readonly threadTopic?: string;
+    readonly deepLink?: string;
+    readonly unread?: boolean;
+}
+export interface InboxSummaryEntry {
+    readonly platform: InboxPlatform;
+    readonly count: number;
+    readonly latestAt: string | null;
+}
+export interface InboxResult {
+    readonly subaction: Subaction;
+    readonly platforms: readonly InboxPlatform[];
+    readonly items: readonly InboxItem[];
+    readonly summary?: readonly InboxSummaryEntry[];
+    readonly query?: string;
+    readonly since?: string;
+    readonly totalBeforeDedupe: number;
+}
+/**
+ * Per-platform fetcher hook. Defaults read through the shared MESSAGE triage
+ * service; tests can still inject deterministic scenario data.
+ */
+export type InboxFetcher = (args: {
+    runtime: IAgentRuntime;
+    since?: string;
+    limit: number;
+    query?: string;
+}) => Promise<readonly InboxItem[]>;
+export type InboxFetchers = Record<InboxPlatform, InboxFetcher>;
+export declare function setInboxFetchers(next: Partial<InboxFetchers>): void;
+export declare function __resetInboxFetchersForTests(): void;
+export declare const inboxAction: Action & {
+    suppressPostActionContinuation?: boolean;
+};
+export default inboxAction;
+//# sourceMappingURL=inbox.d.ts.map

package/dist/actions/inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../src/actions/inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EACV,MAAM,EAKN,aAAa,EAId,MAAM,eAAe,CAAC;AAKvB,QAAA,MAAM,UAAU,0CAA2C,CAAC;AAE5D,KAAK,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAS7C,QAAA,MAAM,SAAS,sFAQL,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAYD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,KAAK,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;AAEpC,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AAmFhE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAEnE;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAsJD,eAAO,MAAM,WAAW,EAAE,MAAM,GAAG;IACjC,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAuK1C,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/actions/inbox.js

@@ -0,0 +1,345 @@
+import { hasOwnerAccess } from "@elizaos/agent/security/access";
+import { getDefaultTriageService, logger } from "@elizaos/core";
+const ACTION_NAME = "INBOX";
+const SUBACTIONS = ["list", "search", "summarize"];
+const SIMILE_NAMES = [
+  "INBOX",
+  "CROSS_CHANNEL_INBOX",
+  "ALL_MESSAGES",
+  "INBOX_TRIAGE_PRIORITY"
+];
+const PLATFORMS = [
+  "gmail",
+  "slack",
+  "discord",
+  "telegram",
+  "signal",
+  "imessage",
+  "whatsapp"
+];
+const noopFetcher = async () => [];
+const PLATFORM_TO_MESSAGE_SOURCE = {
+  gmail: "gmail",
+  discord: "discord",
+  telegram: "telegram",
+  signal: "signal",
+  imessage: "imessage",
+  whatsapp: "whatsapp"
+};
+function mapMessageRefToInboxItem(ref) {
+  const platform = normalizePlatform(ref.source);
+  if (!platform) return null;
+  return {
+    id: ref.id,
+    platform,
+    channel: ref.channelId ?? ref.worldId ?? "default",
+    senderName: ref.from.displayName ?? ref.from.identifier,
+    snippet: ref.snippet,
+    receivedAt: new Date(ref.receivedAtMs).toISOString(),
+    ...ref.subject ? { threadTopic: ref.subject } : {},
+    ...typeof ref.metadata?.htmlLink === "string" ? { deepLink: ref.metadata.htmlLink } : {},
+    unread: !ref.isRead
+  };
+}
+function parseSinceMs(since) {
+  if (!since) return void 0;
+  const parsed = Date.parse(since);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function createDefaultPlatformFetcher(platform) {
+  const source = PLATFORM_TO_MESSAGE_SOURCE[platform];
+  if (!source) return noopFetcher;
+  return async ({ runtime, since, limit, query }) => {
+    if (typeof runtime.getService !== "function") return [];
+    try {
+      const service = getDefaultTriageService();
+      const refs = query ? await service.search(runtime, {
+        sources: [source],
+        content: query,
+        sinceMs: parseSinceMs(since),
+        limit
+      }) : await service.triage(runtime, {
+        sources: [source],
+        sinceMs: parseSinceMs(since),
+        limit
+      });
+      return refs.flatMap((ref) => {
+        const item = mapMessageRefToInboxItem(ref);
+        return item ? [item] : [];
+      });
+    } catch (error) {
+      logger.warn(
+        `[INBOX] ${platform} fetch failed: ${error instanceof Error ? error.message : String(error)}`
+      );
+      return [];
+    }
+  };
+}
+const defaultFetchers = {
+  gmail: createDefaultPlatformFetcher("gmail"),
+  slack: noopFetcher,
+  discord: createDefaultPlatformFetcher("discord"),
+  telegram: createDefaultPlatformFetcher("telegram"),
+  signal: createDefaultPlatformFetcher("signal"),
+  imessage: createDefaultPlatformFetcher("imessage"),
+  whatsapp: createDefaultPlatformFetcher("whatsapp")
+};
+let activeFetchers = { ...defaultFetchers };
+function setInboxFetchers(next) {
+  activeFetchers = { ...activeFetchers, ...next };
+}
+function __resetInboxFetchersForTests() {
+  activeFetchers = { ...defaultFetchers };
+}
+function getParams(options) {
+  const raw = options?.parameters;
+  if (raw && typeof raw === "object") {
+    return raw;
+  }
+  return {};
+}
+function normalizeSubaction(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return null;
+  const lower = trimmed.toLowerCase();
+  return SUBACTIONS.includes(lower) ? lower : null;
+}
+function resolveSubaction(params) {
+  return normalizeSubaction(params.subaction) ?? normalizeSubaction(params.action) ?? normalizeSubaction(params.op);
+}
+function normalizePlatform(value) {
+  if (typeof value !== "string") return null;
+  const lower = value.trim().toLowerCase();
+  return PLATFORMS.includes(lower) ? lower : null;
+}
+function resolvePlatforms(input) {
+  if (!input || input.length === 0) {
+    return [...PLATFORMS];
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const raw of input) {
+    const normalized = normalizePlatform(raw);
+    if (normalized) seen.add(normalized);
+  }
+  return [...seen];
+}
+function dedupeKey(item) {
+  if (item.threadTopic && item.threadTopic.length > 0) {
+    return `topic:${item.threadTopic.toLowerCase()}::${item.platform}::${item.channel}`;
+  }
+  return `id:${item.platform}::${item.id}`;
+}
+function dedupeAndOrder(items) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const key = dedupeKey(item);
+    const existing = seen.get(key);
+    if (!existing) {
+      seen.set(key, item);
+      continue;
+    }
+    const a = Date.parse(item.receivedAt);
+    const b = Date.parse(existing.receivedAt);
+    if (Number.isNaN(a)) continue;
+    if (Number.isNaN(b) || a > b) {
+      seen.set(key, item);
+    }
+  }
+  return [...seen.values()].sort((a, b) => {
+    const aTime = Date.parse(a.receivedAt);
+    const bTime = Date.parse(b.receivedAt);
+    if (Number.isNaN(aTime) && Number.isNaN(bTime)) return 0;
+    if (Number.isNaN(aTime)) return 1;
+    if (Number.isNaN(bTime)) return -1;
+    return bTime - aTime;
+  });
+}
+function buildSummary(items, platforms) {
+  return platforms.map((platform) => {
+    const platformItems = items.filter((item) => item.platform === platform);
+    let latestAt = null;
+    for (const item of platformItems) {
+      if (!latestAt || Date.parse(item.receivedAt) > Date.parse(latestAt)) {
+        latestAt = item.receivedAt;
+      }
+    }
+    return {
+      platform,
+      count: platformItems.length,
+      latestAt
+    };
+  });
+}
+async function hasInboxAccess(runtime, message) {
+  if (!runtime || typeof runtime.agentId !== "string" || !message || typeof message.entityId !== "string" || message.entityId.length === 0) {
+    return false;
+  }
+  return hasOwnerAccess(runtime, message);
+}
+const examples = [
+  [
+    { name: "{{name1}}", content: { text: "Show me my inbox." } },
+    {
+      name: "{{agentName}}",
+      content: {
+        text: "Pulled your inbox.",
+        action: ACTION_NAME
+      }
+    }
+  ],
+  [
+    {
+      name: "{{name1}}",
+      content: { text: "Search every channel for messages about the launch." }
+    },
+    {
+      name: "{{agentName}}",
+      content: {
+        text: "Searched every connected inbox.",
+        action: ACTION_NAME
+      }
+    }
+  ]
+];
+const inboxAction = {
+  name: ACTION_NAME,
+  similes: SIMILE_NAMES.slice(),
+  tags: [
+    "domain:inbox",
+    "capability:read",
+    "capability:search",
+    "capability:summarize",
+    "surface:internal"
+  ],
+  description: "Inbox: Gmail, Slack, Discord, Telegram, Signal, iMessage, WhatsApp. Merge recency feed. Subactions: list, search, summarize.",
+  descriptionCompressed: "INBOX list|search|summarize gmail|slack|discord|telegram|signal|imessage|whatsapp",
+  routingHint: 'cross-channel inbox ("show inbox", "all messages", "search every channel", "summarize inboxes") -> INBOX; per-channel -> MESSAGE',
+  contexts: ["inbox", "messaging", "cross-channel"],
+  roleGate: { minRole: "OWNER" },
+  suppressPostActionContinuation: true,
+  validate: async (runtime, message) => hasInboxAccess(runtime, message),
+  parameters: [
+    {
+      name: "action",
+      description: "Inbox op: list | search | summarize.",
+      schema: { type: "string", enum: [...SUBACTIONS] }
+    },
+    {
+      name: "platforms",
+      description: "Optional platform filter: gmail | slack | discord | telegram | signal | imessage | whatsapp. Default all.",
+      schema: { type: "array", items: { type: "string" } }
+    },
+    {
+      name: "since",
+      description: "receivedAt lower bound. ISO-8601.",
+      schema: { type: "string" }
+    },
+    {
+      name: "limit",
+      description: "Limit per platform. Default 50.",
+      schema: { type: "number" }
+    },
+    {
+      name: "query",
+      description: "Required for search. Free-form query.",
+      schema: { type: "string" }
+    }
+  ],
+  examples,
+  handler: async (runtime, message, _state, options, callback) => {
+    if (!await hasInboxAccess(runtime, message)) {
+      const text2 = "The inbox is restricted to the owner.";
+      await callback?.({ text: text2 });
+      return { text: text2, success: false, data: { error: "PERMISSION_DENIED" } };
+    }
+    const params = getParams(options);
+    const subaction = resolveSubaction(params);
+    if (!subaction) {
+      return {
+        success: false,
+        text: "Tell me which operation: list, search, or summarize.",
+        data: { error: "MISSING_SUBACTION" }
+      };
+    }
+    const platforms = resolvePlatforms(params.platforms);
+    if (platforms.length === 0) {
+      return {
+        success: false,
+        text: "No supported platforms were specified.",
+        data: { subaction, error: "NO_PLATFORMS" }
+      };
+    }
+    const limit = typeof params.limit === "number" && params.limit > 0 ? Math.floor(params.limit) : 50;
+    let query;
+    if (subaction === "search") {
+      const trimmed = typeof params.query === "string" ? params.query.trim() : "";
+      if (trimmed.length === 0) {
+        return {
+          success: false,
+          text: "I need a non-empty query to search.",
+          data: { subaction, error: "MISSING_QUERY" }
+        };
+      }
+      query = trimmed;
+    }
+    const since = typeof params.since === "string" && params.since.trim().length > 0 ? params.since.trim() : void 0;
+    const fetched = await Promise.all(
+      platforms.map(async (platform) => {
+        const fetcher = activeFetchers[platform];
+        const items2 = await fetcher({
+          runtime,
+          ...since ? { since } : {},
+          limit,
+          ...query ? { query } : {}
+        });
+        return items2;
+      })
+    );
+    const flat = fetched.flat();
+    const merged = dedupeAndOrder(flat);
+    const items = subaction === "summarize" ? [] : merged;
+    const summary = subaction === "summarize" ? buildSummary(merged, platforms) : void 0;
+    logger.info(
+      `[INBOX] ${subaction} platforms=${platforms.join(",")} pre=${flat.length} post=${merged.length}`
+    );
+    let text;
+    switch (subaction) {
+      case "list":
+        text = merged.length === 0 ? "Your inbox is empty for this window." : `Pulled ${merged.length} messages across ${platforms.length} platforms.`;
+        break;
+      case "search":
+        text = merged.length === 0 ? `No matches for "${query}".` : `Found ${merged.length} matches for "${query}".`;
+        break;
+      case "summarize":
+        text = `Summarized ${platforms.length} platforms (${merged.length} unique messages).`;
+        break;
+    }
+    await callback?.({
+      text,
+      source: "action",
+      action: ACTION_NAME
+    });
+    return {
+      success: true,
+      text,
+      data: {
+        subaction,
+        platforms,
+        items,
+        ...summary ? { summary } : {},
+        ...query ? { query } : {},
+        ...since ? { since } : {},
+        totalBeforeDedupe: flat.length
+      }
+    };
+  }
+};
+var inbox_default = inboxAction;
+export {
+  __resetInboxFetchersForTests,
+  inbox_default as default,
+  inboxAction,
+  setInboxFetchers
+};
+//# sourceMappingURL=inbox.js.map

package/dist/actions/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/inbox.ts"],"sourcesContent":["/**\n * `INBOX` umbrella action — cross-channel inbox.\n *\n * The agent's `MESSAGE` umbrella triages per-channel inboxes; INBOX fans out to\n * every connected platform (Gmail, Slack, Discord, Telegram, Signal, iMessage,\n * WhatsApp) and produces a single merged feed for \"show me my inbox\" style\n * intents.\n *\n * Subactions:\n *   - `list`       — list recent messages across selected platforms\n *   - `search`     — search across selected platforms by `query`\n *   - `summarize`  — return a per-platform count + a single rolled-up summary\n *\n * Behavior: fan out to each platform's adapter via the injectable fetcher hook,\n * dedupe by `id` and thread topic, merge into a single result list ordered by\n * recency.\n *\n * Owner-only. Ported verbatim from the LifeOps INBOX action; the per-platform\n * default fetchers read through the shared MESSAGE triage service, and tests\n * inject deterministic fetchers via {@link setInboxFetchers}.\n */\n\nimport { hasOwnerAccess } from \"@elizaos/agent/security/access\";\nimport type {\n  Action,\n  ActionExample,\n  ActionResult,\n  HandlerCallback,\n  HandlerOptions,\n  IAgentRuntime,\n  Memory,\n  MessageRef,\n  MessageSource,\n} from \"@elizaos/core\";\nimport { getDefaultTriageService, logger } from \"@elizaos/core\";\n\nconst ACTION_NAME = \"INBOX\";\n\nconst SUBACTIONS = [\"list\", \"search\", \"summarize\"] as const;\n\ntype Subaction = (typeof SUBACTIONS)[number];\n\nconst SIMILE_NAMES: readonly string[] = [\n  \"INBOX\",\n  \"CROSS_CHANNEL_INBOX\",\n  \"ALL_MESSAGES\",\n  \"INBOX_TRIAGE_PRIORITY\",\n];\n\nconst PLATFORMS = [\n  \"gmail\",\n  \"slack\",\n  \"discord\",\n  \"telegram\",\n  \"signal\",\n  \"imessage\",\n  \"whatsapp\",\n] as const;\n\nexport type InboxPlatform = (typeof PLATFORMS)[number];\n\nexport interface InboxItem {\n  readonly id: string;\n  readonly platform: InboxPlatform;\n  readonly channel: string;\n  readonly senderName: string;\n  readonly snippet: string;\n  readonly receivedAt: string;\n  readonly threadTopic?: string;\n  readonly deepLink?: string;\n  readonly unread?: boolean;\n}\n\ninterface InboxActionParameters {\n  subaction?: Subaction | string;\n  action?: Subaction | string;\n  op?: Subaction | string;\n  platforms?: readonly string[];\n  since?: string;\n  limit?: number;\n  query?: string;\n}\n\nexport interface InboxSummaryEntry {\n  readonly platform: InboxPlatform;\n  readonly count: number;\n  readonly latestAt: string | null;\n}\n\nexport interface InboxResult {\n  readonly subaction: Subaction;\n  readonly platforms: readonly InboxPlatform[];\n  readonly items: readonly InboxItem[];\n  readonly summary?: readonly InboxSummaryEntry[];\n  readonly query?: string;\n  readonly since?: string;\n  readonly totalBeforeDedupe: number;\n}\n\n/**\n * Per-platform fetcher hook. Defaults read through the shared MESSAGE triage\n * service; tests can still inject deterministic scenario data.\n */\nexport type InboxFetcher = (args: {\n  runtime: IAgentRuntime;\n  since?: string;\n  limit: number;\n  query?: string;\n}) => Promise<readonly InboxItem[]>;\n\nexport type InboxFetchers = Record<InboxPlatform, InboxFetcher>;\n\nconst noopFetcher: InboxFetcher = async () => [];\n\nconst PLATFORM_TO_MESSAGE_SOURCE: Partial<\n  Record<InboxPlatform, MessageSource>\n> = {\n  gmail: \"gmail\",\n  discord: \"discord\",\n  telegram: \"telegram\",\n  signal: \"signal\",\n  imessage: \"imessage\",\n  whatsapp: \"whatsapp\",\n};\n\nfunction mapMessageRefToInboxItem(ref: MessageRef): InboxItem | null {\n  const platform = normalizePlatform(ref.source);\n  if (!platform) return null;\n  return {\n    id: ref.id,\n    platform,\n    channel: ref.channelId ?? ref.worldId ?? \"default\",\n    senderName: ref.from.displayName ?? ref.from.identifier,\n    snippet: ref.snippet,\n    receivedAt: new Date(ref.receivedAtMs).toISOString(),\n    ...(ref.subject ? { threadTopic: ref.subject } : {}),\n    ...(typeof ref.metadata?.htmlLink === \"string\"\n      ? { deepLink: ref.metadata.htmlLink }\n      : {}),\n    unread: !ref.isRead,\n  };\n}\n\nfunction parseSinceMs(since: string | undefined): number | undefined {\n  if (!since) return undefined;\n  const parsed = Date.parse(since);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction createDefaultPlatformFetcher(platform: InboxPlatform): InboxFetcher {\n  const source = PLATFORM_TO_MESSAGE_SOURCE[platform];\n  if (!source) return noopFetcher;\n  return async ({ runtime, since, limit, query }) => {\n    if (typeof runtime.getService !== \"function\") return [];\n    try {\n      const service = getDefaultTriageService();\n      const refs = query\n        ? await service.search(runtime, {\n            sources: [source],\n            content: query,\n            sinceMs: parseSinceMs(since),\n            limit,\n          })\n        : await service.triage(runtime, {\n            sources: [source],\n            sinceMs: parseSinceMs(since),\n            limit,\n          });\n      return refs.flatMap((ref) => {\n        const item = mapMessageRefToInboxItem(ref);\n        return item ? [item] : [];\n      });\n    } catch (error) {\n      logger.warn(\n        `[INBOX] ${platform} fetch failed: ${error instanceof Error ? error.message : String(error)}`,\n      );\n      return [];\n    }\n  };\n}\n\nconst defaultFetchers: InboxFetchers = {\n  gmail: createDefaultPlatformFetcher(\"gmail\"),\n  slack: noopFetcher,\n  discord: createDefaultPlatformFetcher(\"discord\"),\n  telegram: createDefaultPlatformFetcher(\"telegram\"),\n  signal: createDefaultPlatformFetcher(\"signal\"),\n  imessage: createDefaultPlatformFetcher(\"imessage\"),\n  whatsapp: createDefaultPlatformFetcher(\"whatsapp\"),\n};\n\nlet activeFetchers: InboxFetchers = { ...defaultFetchers };\n\nexport function setInboxFetchers(next: Partial<InboxFetchers>): void {\n  activeFetchers = { ...activeFetchers, ...next };\n}\n\nexport function __resetInboxFetchersForTests(): void {\n  activeFetchers = { ...defaultFetchers };\n}\n\nfunction getParams(options: HandlerOptions | undefined): InboxActionParameters {\n  const raw = (options as HandlerOptions | undefined)?.parameters;\n  if (raw && typeof raw === \"object\") {\n    return raw as InboxActionParameters;\n  }\n  return {};\n}\n\nfunction normalizeSubaction(value: unknown): Subaction | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (trimmed.length === 0) return null;\n  const lower = trimmed.toLowerCase();\n  return (SUBACTIONS as readonly string[]).includes(lower)\n    ? (lower as Subaction)\n    : null;\n}\n\nfunction resolveSubaction(params: InboxActionParameters): Subaction | null {\n  return (\n    normalizeSubaction(params.subaction) ??\n    normalizeSubaction(params.action) ??\n    normalizeSubaction(params.op)\n  );\n}\n\nfunction normalizePlatform(value: unknown): InboxPlatform | null {\n  if (typeof value !== \"string\") return null;\n  const lower = value.trim().toLowerCase();\n  return (PLATFORMS as readonly string[]).includes(lower)\n    ? (lower as InboxPlatform)\n    : null;\n}\n\nfunction resolvePlatforms(\n  input: readonly string[] | undefined,\n): readonly InboxPlatform[] {\n  if (!input || input.length === 0) {\n    return [...PLATFORMS];\n  }\n  const seen = new Set<InboxPlatform>();\n  for (const raw of input) {\n    const normalized = normalizePlatform(raw);\n    if (normalized) seen.add(normalized);\n  }\n  return [...seen];\n}\n\nfunction dedupeKey(item: InboxItem): string {\n  if (item.threadTopic && item.threadTopic.length > 0) {\n    return `topic:${item.threadTopic.toLowerCase()}::${item.platform}::${item.channel}`;\n  }\n  return `id:${item.platform}::${item.id}`;\n}\n\nfunction dedupeAndOrder(items: readonly InboxItem[]): readonly InboxItem[] {\n  const seen = new Map<string, InboxItem>();\n  for (const item of items) {\n    const key = dedupeKey(item);\n    const existing = seen.get(key);\n    if (!existing) {\n      seen.set(key, item);\n      continue;\n    }\n    const a = Date.parse(item.receivedAt);\n    const b = Date.parse(existing.receivedAt);\n    if (Number.isNaN(a)) continue;\n    if (Number.isNaN(b) || a > b) {\n      seen.set(key, item);\n    }\n  }\n  return [...seen.values()].sort((a, b) => {\n    const aTime = Date.parse(a.receivedAt);\n    const bTime = Date.parse(b.receivedAt);\n    if (Number.isNaN(aTime) && Number.isNaN(bTime)) return 0;\n    if (Number.isNaN(aTime)) return 1;\n    if (Number.isNaN(bTime)) return -1;\n    return bTime - aTime;\n  });\n}\n\nfunction buildSummary(\n  items: readonly InboxItem[],\n  platforms: readonly InboxPlatform[],\n): readonly InboxSummaryEntry[] {\n  return platforms.map<InboxSummaryEntry>((platform) => {\n    const platformItems = items.filter((item) => item.platform === platform);\n    let latestAt: string | null = null;\n    for (const item of platformItems) {\n      if (!latestAt || Date.parse(item.receivedAt) > Date.parse(latestAt)) {\n        latestAt = item.receivedAt;\n      }\n    }\n    return {\n      platform,\n      count: platformItems.length,\n      latestAt,\n    };\n  });\n}\n\n/**\n * Owner-access guard for INBOX. Mirrors the LifeOps `hasLifeOpsAccess`\n * predicate exactly: reject when the runtime agent id or the message entity id\n * is missing/empty, then defer to the shared owner-access check.\n */\nasync function hasInboxAccess(\n  runtime: IAgentRuntime,\n  message: Memory,\n): Promise<boolean> {\n  if (\n    !runtime ||\n    typeof runtime.agentId !== \"string\" ||\n    !message ||\n    typeof message.entityId !== \"string\" ||\n    message.entityId.length === 0\n  ) {\n    return false;\n  }\n  return hasOwnerAccess(runtime, message);\n}\n\nconst examples: ActionExample[][] = [\n  [\n    { name: \"{{name1}}\", content: { text: \"Show me my inbox.\" } },\n    {\n      name: \"{{agentName}}\",\n      content: {\n        text: \"Pulled your inbox.\",\n        action: ACTION_NAME,\n      },\n    },\n  ],\n  [\n    {\n      name: \"{{name1}}\",\n      content: { text: \"Search every channel for messages about the launch.\" },\n    },\n    {\n      name: \"{{agentName}}\",\n      content: {\n        text: \"Searched every connected inbox.\",\n        action: ACTION_NAME,\n      },\n    },\n  ],\n];\n\nexport const inboxAction: Action & {\n  suppressPostActionContinuation?: boolean;\n} = {\n  name: ACTION_NAME,\n  similes: SIMILE_NAMES.slice(),\n  tags: [\n    \"domain:inbox\",\n    \"capability:read\",\n    \"capability:search\",\n    \"capability:summarize\",\n    \"surface:internal\",\n  ],\n  description:\n    \"Inbox: Gmail, Slack, Discord, Telegram, Signal, iMessage, WhatsApp. Merge recency feed. Subactions: list, search, summarize.\",\n  descriptionCompressed:\n    \"INBOX list|search|summarize gmail|slack|discord|telegram|signal|imessage|whatsapp\",\n  routingHint:\n    'cross-channel inbox (\"show inbox\", \"all messages\", \"search every channel\", \"summarize inboxes\") -> INBOX; per-channel -> MESSAGE',\n  contexts: [\"inbox\", \"messaging\", \"cross-channel\"],\n  roleGate: { minRole: \"OWNER\" },\n  suppressPostActionContinuation: true,\n  validate: async (runtime, message) => hasInboxAccess(runtime, message),\n  parameters: [\n    {\n      name: \"action\",\n      description: \"Inbox op: list | search | summarize.\",\n      schema: { type: \"string\" as const, enum: [...SUBACTIONS] },\n    },\n    {\n      name: \"platforms\",\n      description:\n        \"Optional platform filter: gmail | slack | discord | telegram | signal | imessage | whatsapp. Default all.\",\n      schema: { type: \"array\" as const, items: { type: \"string\" as const } },\n    },\n    {\n      name: \"since\",\n      description: \"receivedAt lower bound. ISO-8601.\",\n      schema: { type: \"string\" as const },\n    },\n    {\n      name: \"limit\",\n      description: \"Limit per platform. Default 50.\",\n      schema: { type: \"number\" as const },\n    },\n    {\n      name: \"query\",\n      description: \"Required for search. Free-form query.\",\n      schema: { type: \"string\" as const },\n    },\n  ],\n  examples,\n  handler: async (\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state,\n    options,\n    callback: HandlerCallback | undefined,\n  ): Promise<ActionResult> => {\n    if (!(await hasInboxAccess(runtime, message))) {\n      const text = \"The inbox is restricted to the owner.\";\n      await callback?.({ text });\n      return { text, success: false, data: { error: \"PERMISSION_DENIED\" } };\n    }\n\n    const params = getParams(options);\n    const subaction = resolveSubaction(params);\n    if (!subaction) {\n      return {\n        success: false,\n        text: \"Tell me which operation: list, search, or summarize.\",\n        data: { error: \"MISSING_SUBACTION\" },\n      };\n    }\n\n    const platforms = resolvePlatforms(params.platforms);\n    if (platforms.length === 0) {\n      return {\n        success: false,\n        text: \"No supported platforms were specified.\",\n        data: { subaction, error: \"NO_PLATFORMS\" },\n      };\n    }\n\n    const limit =\n      typeof params.limit === \"number\" && params.limit > 0\n        ? Math.floor(params.limit)\n        : 50;\n\n    let query: string | undefined;\n    if (subaction === \"search\") {\n      const trimmed =\n        typeof params.query === \"string\" ? params.query.trim() : \"\";\n      if (trimmed.length === 0) {\n        return {\n          success: false,\n          text: \"I need a non-empty query to search.\",\n          data: { subaction, error: \"MISSING_QUERY\" },\n        };\n      }\n      query = trimmed;\n    }\n\n    const since =\n      typeof params.since === \"string\" && params.since.trim().length > 0\n        ? params.since.trim()\n        : undefined;\n\n    const fetched = await Promise.all(\n      platforms.map(async (platform) => {\n        const fetcher = activeFetchers[platform];\n        const items = await fetcher({\n          runtime,\n          ...(since ? { since } : {}),\n          limit,\n          ...(query ? { query } : {}),\n        });\n        return items;\n      }),\n    );\n    const flat = fetched.flat();\n    const merged = dedupeAndOrder(flat);\n    const items: readonly InboxItem[] = subaction === \"summarize\" ? [] : merged;\n    const summary: readonly InboxSummaryEntry[] | undefined =\n      subaction === \"summarize\" ? buildSummary(merged, platforms) : undefined;\n\n    logger.info(\n      `[INBOX] ${subaction} platforms=${platforms.join(\",\")} pre=${flat.length} post=${merged.length}`,\n    );\n\n    let text: string;\n    switch (subaction) {\n      case \"list\":\n        text =\n          merged.length === 0\n            ? \"Your inbox is empty for this window.\"\n            : `Pulled ${merged.length} messages across ${platforms.length} platforms.`;\n        break;\n      case \"search\":\n        text =\n          merged.length === 0\n            ? `No matches for \"${query}\".`\n            : `Found ${merged.length} matches for \"${query}\".`;\n        break;\n      case \"summarize\":\n        text = `Summarized ${platforms.length} platforms (${merged.length} unique messages).`;\n        break;\n    }\n\n    await callback?.({\n      text,\n      source: \"action\",\n      action: ACTION_NAME,\n    });\n\n    return {\n      success: true,\n      text,\n      data: {\n        subaction,\n        platforms,\n        items,\n        ...(summary ? { summary } : {}),\n        ...(query ? { query } : {}),\n        ...(since ? { since } : {}),\n        totalBeforeDedupe: flat.length,\n      },\n    };\n  },\n};\n\nexport default inboxAction;\n"],"mappings":"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","names":["text","items"]}

package/dist/components/inbox/InboxSpatialView.d.ts

@@ -0,0 +1,54 @@
+/**
+ * InboxSpatialView — the cross-channel inbox authored once with the spatial
+ * vocabulary so it renders correctly wherever it is displayed:
+ *
+ *   - GUI / XR — mounted in `<SpatialSurface>` (DOM; XR scales up).
+ *   - TUI      — rendered to real terminal lines by the agent terminal, via
+ *                `registerSpatialTerminalView` (see `register-terminal-view.tsx`).
+ *
+ * It is purely presentational (a snapshot + an action callback in, primitives
+ * out) and imports ONLY the cross-modality primitives plus the view's local
+ * display types, so it is safe to render in the Node agent process where the
+ * terminal lives (no `@elizaos/ui` renderer barrel, no fetch).
+ *
+ * The live data wrapper {@link InboxView} owns the `/api/lifeops/inbox` fetch,
+ * the background poll, and the channel-filter state; it builds an
+ * {@link InboxSnapshot} and dispatches user intent back through `onAction`.
+ */
+import { type InboxChannel, type InboxItem } from "../../types.js";
+/** Which fetch state the inbox surface is currently in. */
+export type InboxStatus = "loading" | "error" | "empty" | "ready";
+/** One channel chip's display state in the filter row. */
+export interface InboxChannelFilter {
+    channel: InboxChannel;
+    label: string;
+    active: boolean;
+}
+export interface InboxSnapshot {
+    /** Current fetch state. */
+    status: InboxStatus;
+    /** Triage items (already filtered to the active channel selection). */
+    items: InboxItem[];
+    /** Channel filter chips in display order. */
+    filters: InboxChannelFilter[];
+    /** Number of active channel filters (drives the empty-state copy). */
+    activeFilterCount: number;
+    /** True when at least one channel reported messages in the payload. */
+    hasConnectedChannels: boolean;
+    /** Proactive one-liner ("N threads still need a reply"); absent when zero. */
+    nudge?: string | null;
+    /** Error text for the error state. */
+    error?: string | null;
+}
+/** A snapshot every surface can render before live data arrives. */
+export declare const EMPTY_INBOX_SNAPSHOT: InboxSnapshot;
+export interface InboxSpatialViewProps {
+    snapshot: InboxSnapshot;
+    /**
+     * Dispatch by agent id: `retry`, `connect`, `channel:<id>` (toggle a channel
+     * filter), and `open:<messageId>` (open a triage item).
+     */
+    onAction?: (action: string) => void;
+}
+export declare function InboxSpatialView({ snapshot, onAction, }: InboxSpatialViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=InboxSpatialView.d.ts.map

package/dist/components/inbox/InboxSpatialView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboxSpatialView.d.ts","sourceRoot":"","sources":["../../../src/components/inbox/InboxSpatialView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAWH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAElE,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,uEAAuE;IACvE,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,sEAAsE;IACtE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,oBAAoB,EAAE,OAAO,CAAC;IAC9B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAQD,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,EAAE,aAQlC,CAAC;AAkCF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,aAAa,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,QAAQ,GACT,EAAE,qBAAqB,2CASvB"}