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

package/dist/lifeops/cross-channel-search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/cross-channel-search.ts"],"sourcesContent":["/**\n * Cross-channel search (WS1).\n *\n * Fans a single semantic query across:\n *   - Gmail (via LifeOpsService.getGmailSearch)\n *   - Agent memory (runtime.searchMemories with embedding)\n *   - WS3 RelationshipsGraphService.getMemoriesForCluster (when a personRef\n *     resolves to a canonical cluster)\n *\n * Connectors that lack first-class search emit a typed `unsupported`\n * result. We never fabricate hits.\n *\n * Architecture note: this file is the orchestrator. The action\n * (search-across-channels.ts) handles LLM param extraction and result\n * formatting. The provider (cross-channel-context.ts) consumes\n * runCrossChannelSearch() to inject context for named persons/topics.\n */\n\n// Graph types live in @elizaos/core's relationships-graph-builder. That\n// module is internal to core and not part of its public exports map, so we\n// can't import its runtime helpers from here. We type-shape the parts we\n// touch and provide a local fallback for cluster memory lookup.\nimport type { IAgentRuntime, Memory, Room, Service, UUID } from \"@elizaos/core\";\nimport { logger, ModelType, runWithTrajectoryContext } from \"@elizaos/core\";\n\ntype RelationshipsPersonSummary = {\n  groupId: UUID;\n  primaryEntityId: UUID;\n  memberEntityIds: UUID[];\n  displayName: string;\n  aliases: string[];\n  platforms: string[];\n  identities: unknown[];\n  emails: string[];\n  phones: string[];\n  websites: string[];\n  preferredCommunicationChannel: string | null;\n  categories: string[];\n  tags: string[];\n  factCount: number;\n  relationshipCount: number;\n  isOwner: boolean;\n  profiles: unknown[];\n  lastInteractionAt?: string;\n};\n\ntype RelationshipsGraphService = {\n  getGraphSnapshot: (query?: {\n    search?: string | null;\n    limit?: number;\n  }) => Promise<{ people: RelationshipsPersonSummary[] }>;\n  getPersonDetail: (\n    primaryEntityId: UUID,\n  ) => Promise<RelationshipsPersonSummary | null>;\n};\n\n// Local fallback used when the registered RelationshipsGraphService doesn't\n// implement getMemoriesForCluster — degrades to a single-entity query.\nasync function getClusterMemories(\n  runtime: IAgentRuntime,\n  primaryEntityId: UUID,\n  params: { tableName: string; worldId?: UUID; count?: number },\n): Promise<Memory[]> {\n  return runtime.getMemories({\n    tableName: params.tableName,\n    worldId: params.worldId,\n    count: params.count,\n    entityId: primaryEntityId,\n  });\n}\n\nimport type {\n  LifeOpsCalendarEvent,\n  LifeOpsGmailMessageSummary,\n  LifeOpsXDm,\n  LifeOpsXFeedItem,\n} from \"@elizaos/shared\";\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\nexport const CROSS_CHANNEL_SEARCH_CHANNELS = [\n  \"gmail\",\n  \"memory\",\n  \"telegram\",\n  \"discord\",\n  \"imessage\",\n  \"whatsapp\",\n  \"signal\",\n  \"x\",\n  \"x-dm\",\n  \"calendly\",\n  \"calendar\",\n] as const;\n\nexport type CrossChannelSearchChannel =\n  (typeof CROSS_CHANNEL_SEARCH_CHANNELS)[number];\n\nexport type CrossChannelSearchTimeWindow = {\n  /** ISO timestamp lower bound (inclusive). */\n  startIso?: string;\n  /** ISO timestamp upper bound (inclusive). */\n  endIso?: string;\n};\n\nexport type CrossChannelSearchPersonRef = {\n  /** Canonical cluster primary entity id (preferred). */\n  primaryEntityId?: UUID;\n  /** Free-form display name from LLM extraction (fallback). */\n  displayName?: string;\n};\n\nexport type CrossChannelSearchQuery = {\n  /** Free-form semantic query — required, no fallback default. */\n  query: string;\n  /** Optional named person to focus the search on. */\n  personRef?: CrossChannelSearchPersonRef;\n  /** Optional ISO time window to bound results. */\n  timeWindow?: CrossChannelSearchTimeWindow;\n  /** Optional explicit channel allowlist; default = all known channels. */\n  channels?: CrossChannelSearchChannel[];\n  /** Optional worldId scope for memory search. */\n  worldId?: UUID;\n  /** Per-channel hit cap (default 10). */\n  limit?: number;\n};\n\nexport type CrossChannelSearchHit = {\n  channel: CrossChannelSearchChannel;\n  /** Stable id for dedup + citation. */\n  id: string;\n  /** Source room id for memory hits, gmail message id for gmail, etc. */\n  sourceRef: string;\n  /** ISO timestamp. */\n  timestamp: string;\n  /** Sender / from. */\n  speaker: string;\n  /** Free-form text body (already trimmed). */\n  text: string;\n  /** Optional subject (gmail). */\n  subject?: string;\n  /** Provenance for the citation. */\n  citation: {\n    platform: string;\n    label: string;\n    url?: string;\n  };\n};\n\nexport type CrossChannelSearchUnsupported = {\n  channel: CrossChannelSearchChannel;\n  reason: string;\n};\n\nexport type CrossChannelSearchDegraded = {\n  channel: CrossChannelSearchChannel;\n  reason: string;\n};\n\nexport type CrossChannelSearchResult = {\n  query: string;\n  hits: CrossChannelSearchHit[];\n  unsupported: CrossChannelSearchUnsupported[];\n  degraded: CrossChannelSearchDegraded[];\n  /** Channels that produced at least one hit. */\n  channelsWithHits: CrossChannelSearchChannel[];\n  /** Resolved canonical person, when available from WS3. */\n  resolvedPerson: RelationshipsPersonSummary | null;\n};\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_PER_CHANNEL_LIMIT = 10;\nconst MEMORY_MATCH_THRESHOLD = 0.55;\n\nconst KNOWN_PLATFORM_FOR_CHANNEL: Record<CrossChannelSearchChannel, string> = {\n  gmail: \"gmail\",\n  memory: \"memory\",\n  telegram: \"telegram\",\n  discord: \"discord\",\n  imessage: \"imessage\",\n  whatsapp: \"whatsapp\",\n  signal: \"signal\",\n  x: \"x\",\n  \"x-dm\": \"x\",\n  calendly: \"calendly\",\n  calendar: \"calendar\",\n};\n\nfunction withinTimeWindow(\n  iso: string | undefined,\n  window: CrossChannelSearchTimeWindow | undefined,\n): boolean {\n  if (!window || (!window.startIso && !window.endIso)) {\n    return true;\n  }\n  if (!iso) {\n    return false;\n  }\n  const t = Date.parse(iso);\n  if (Number.isNaN(t)) {\n    return false;\n  }\n  if (window.startIso) {\n    const start = Date.parse(window.startIso);\n    if (!Number.isNaN(start) && t < start) {\n      return false;\n    }\n  }\n  if (window.endIso) {\n    const end = Date.parse(window.endIso);\n    if (!Number.isNaN(end) && t > end) {\n      return false;\n    }\n  }\n  return true;\n}\n\nfunction normalizeIsoFromMs(ms: number | undefined): string {\n  if (typeof ms !== \"number\" || !Number.isFinite(ms)) {\n    return new Date(0).toISOString();\n  }\n  return new Date(ms).toISOString();\n}\n\nfunction classifyMemoryChannel(\n  source: string | undefined,\n): CrossChannelSearchChannel {\n  const normalized = (source ?? \"\").trim().toLowerCase();\n  switch (normalized) {\n    case \"telegram\":\n      return \"telegram\";\n    case \"discord\":\n      return \"discord\";\n    case \"imessage\":\n    case \"messages\":\n      return \"imessage\";\n    case \"whatsapp\":\n      return \"whatsapp\";\n    case \"signal\":\n      return \"signal\";\n    case \"x\":\n    case \"twitter\":\n      return \"x\";\n    case \"x-dm\":\n      return \"x-dm\";\n    case \"calendly\":\n      return \"calendly\";\n    case \"calendar\":\n    case \"google-calendar\":\n      return \"calendar\";\n    case \"gmail\":\n    case \"google-gmail\":\n    case \"email\":\n      return \"gmail\";\n    default:\n      return \"memory\";\n  }\n}\n\nfunction isChannelEnabled(\n  channel: CrossChannelSearchChannel,\n  channels: CrossChannelSearchChannel[] | undefined,\n): boolean {\n  if (!channels || channels.length === 0) {\n    return true;\n  }\n  return channels.includes(channel);\n}\n\n// ---------------------------------------------------------------------------\n// Per-channel adapters\n// ---------------------------------------------------------------------------\n\ntype GmailSearchService = {\n  getGmailSearch: (\n    requestUrl: URL,\n    request: { query: string; maxResults?: number },\n  ) => Promise<{ messages: LifeOpsGmailMessageSummary[] }>;\n};\n\ntype TelegramMessageSearchResult = {\n  id: string | null;\n  dialogId: string | null;\n  dialogTitle: string | null;\n  username: string | null;\n  content: string;\n  timestamp: string | null;\n  outgoing: boolean;\n};\n\ntype DiscordMessageSearchResult = {\n  id: string | null;\n  content: string;\n  authorName: string | null;\n  channelId: string | null;\n  timestamp: string | null;\n};\n\ntype IMessageSearchResult = {\n  id: string;\n  fromHandle: string;\n  toHandles: string[];\n  text: string;\n  isFromMe: boolean;\n  sentAt: string;\n  chatId?: string;\n};\n\ntype CrossChannelNativeSearchService = GmailSearchService & {\n  searchTelegramMessages?: (request: {\n    query: string;\n    scope?: string;\n    limit?: number;\n  }) => Promise<TelegramMessageSearchResult[]>;\n  searchDiscordMessages?: (request: {\n    query: string;\n    channelId?: string;\n  }) => Promise<DiscordMessageSearchResult[]>;\n  searchIMessages?: (request: {\n    query: string;\n    chatId?: string;\n    limit?: number;\n  }) => Promise<IMessageSearchResult[]>;\n  readSignalInbound?: (limit?: number) => Promise<\n    Array<{\n      id: string;\n      threadId?: string | null;\n      roomName?: string | null;\n      speakerName?: string | null;\n      senderNumber?: string | null;\n      createdAt: number;\n      text: string;\n    }>\n  >;\n  pullWhatsAppRecent?: (limit?: number) => Promise<{\n    count: number;\n    messages: Array<{\n      id: string;\n      from: string;\n      channelId: string;\n      timestamp: string;\n      text?: string;\n      metadata?: { contactName?: string };\n    }>;\n  }>;\n  getCalendarFeed?: (\n    requestUrl: URL,\n    request: {\n      timeMin?: string;\n      timeMax?: string;\n      includeHiddenCalendars?: boolean;\n    },\n  ) => Promise<{ events: LifeOpsCalendarEvent[] }>;\n  searchXPosts?: (\n    query: string,\n    opts?: { limit?: number },\n  ) => Promise<LifeOpsXFeedItem[]>;\n  getXDms?: (opts?: {\n    conversationId?: string;\n    limit?: number;\n  }) => Promise<LifeOpsXDm[]>;\n};\n\nfunction isObjectService(value: unknown): value is object {\n  return Boolean(value) && typeof value === \"object\";\n}\n\nfunction getLifeOpsSearchService(\n  runtime: IAgentRuntime,\n): CrossChannelNativeSearchService | null {\n  const service = runtime.getService(\"lifeops\");\n  // CrossChannelNativeSearchService = GmailSearchService & optional search\n  // methods. Validate the required getGmailSearch surface at this runtime\n  // boundary and narrow, rather than asserting across non-overlapping types.\n  if (!isObjectService(service)) {\n    return null;\n  }\n  const candidate = service as { getGmailSearch?: unknown };\n  return typeof candidate.getGmailSearch === \"function\"\n    ? (service as Service & CrossChannelNativeSearchService)\n    : null;\n}\n\nasync function searchGmail(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  unsupported: CrossChannelSearchUnsupported[];\n  degraded: CrossChannelSearchDegraded[];\n}> {\n  const limit = query.limit ?? DEFAULT_PER_CHANNEL_LIMIT;\n  const lifeOps = getLifeOpsSearchService(runtime);\n  if (!lifeOps || typeof lifeOps.getGmailSearch !== \"function\") {\n    return {\n      hits: [],\n      unsupported: [\n        {\n          channel: \"gmail\",\n          reason: \"LifeOpsService not registered on runtime\",\n        },\n      ],\n      degraded: [],\n    };\n  }\n\n  const requestUrl = new URL(\"http://127.0.0.1/api/lifeops/gmail/search\");\n  const feed = await lifeOps.getGmailSearch(requestUrl, {\n    query: query.query,\n    maxResults: limit,\n  });\n\n  const hits: CrossChannelSearchHit[] = [];\n  for (const msg of feed.messages) {\n    if (!withinTimeWindow(msg.receivedAt, query.timeWindow)) {\n      continue;\n    }\n    hits.push({\n      channel: \"gmail\",\n      id: `gmail:${msg.id}`,\n      sourceRef: msg.id,\n      timestamp: msg.receivedAt,\n      speaker: msg.from,\n      subject: msg.subject,\n      text: msg.snippet,\n      citation: {\n        platform: \"gmail\",\n        label: msg.subject || msg.snippet.slice(0, 80),\n        url: msg.htmlLink ?? undefined,\n      },\n    });\n  }\n  return { hits, unsupported: [], degraded: [] };\n}\n\nasync function searchTelegram(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  unsupported: CrossChannelSearchUnsupported[];\n}> {\n  const lifeOps = getLifeOpsSearchService(runtime);\n  if (!lifeOps || typeof lifeOps.searchTelegramMessages !== \"function\") {\n    return {\n      hits: [],\n      unsupported: [\n        {\n          channel: \"telegram\",\n          reason: \"Telegram search is not available on LifeOpsService\",\n        },\n      ],\n    };\n  }\n\n  const limit = query.limit ?? DEFAULT_PER_CHANNEL_LIMIT;\n  const messages = await lifeOps.searchTelegramMessages({\n    query: query.query,\n    limit,\n  });\n  const hits: CrossChannelSearchHit[] = [];\n  for (const msg of messages) {\n    if (!withinTimeWindow(msg.timestamp ?? undefined, query.timeWindow)) {\n      continue;\n    }\n    const sourceRef = msg.id ?? msg.dialogId ?? msg.content.slice(0, 48);\n    hits.push({\n      channel: \"telegram\",\n      id: `telegram:${sourceRef}`,\n      sourceRef,\n      timestamp: msg.timestamp ?? new Date(0).toISOString(),\n      speaker: msg.outgoing ? \"me\" : (msg.username ?? \"unknown\"),\n      text: msg.content,\n      citation: {\n        platform: \"telegram\",\n        label: msg.dialogTitle ?? msg.username ?? \"Telegram\",\n      },\n    });\n  }\n  return { hits, unsupported: [] };\n}\n\nasync function searchDiscord(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  unsupported: CrossChannelSearchUnsupported[];\n}> {\n  const lifeOps = getLifeOpsSearchService(runtime);\n  if (!lifeOps || typeof lifeOps.searchDiscordMessages !== \"function\") {\n    return {\n      hits: [],\n      unsupported: [\n        {\n          channel: \"discord\",\n          reason: \"Discord search is not available on LifeOpsService\",\n        },\n      ],\n    };\n  }\n\n  const messages = await lifeOps.searchDiscordMessages({ query: query.query });\n  const hits: CrossChannelSearchHit[] = [];\n  for (const msg of messages) {\n    if (!withinTimeWindow(msg.timestamp ?? undefined, query.timeWindow)) {\n      continue;\n    }\n    const sourceRef = msg.id ?? msg.channelId ?? msg.content.slice(0, 48);\n    hits.push({\n      channel: \"discord\",\n      id: `discord:${sourceRef}`,\n      sourceRef,\n      timestamp: msg.timestamp ?? new Date(0).toISOString(),\n      speaker: msg.authorName ?? \"unknown\",\n      text: msg.content,\n      citation: {\n        platform: \"discord\",\n        label: msg.channelId ? `channel:${msg.channelId}` : \"Discord\",\n      },\n    });\n  }\n  return { hits, unsupported: [] };\n}\n\nasync function searchIMessages(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  unsupported: CrossChannelSearchUnsupported[];\n}> {\n  const lifeOps = getLifeOpsSearchService(runtime);\n  if (!lifeOps || typeof lifeOps.searchIMessages !== \"function\") {\n    return {\n      hits: [],\n      unsupported: [\n        {\n          channel: \"imessage\",\n          reason: \"iMessage search is not available on LifeOpsService\",\n        },\n      ],\n    };\n  }\n\n  const limit = query.limit ?? DEFAULT_PER_CHANNEL_LIMIT;\n  const messages = await lifeOps.searchIMessages({\n    query: query.query,\n    limit,\n  });\n  const hits: CrossChannelSearchHit[] = [];\n  for (const msg of messages) {\n    if (!withinTimeWindow(msg.sentAt, query.timeWindow)) {\n      continue;\n    }\n    hits.push({\n      channel: \"imessage\",\n      id: `imessage:${msg.id}`,\n      sourceRef: msg.id,\n      timestamp: msg.sentAt,\n      speaker: msg.isFromMe ? \"me\" : msg.fromHandle,\n      text: msg.text,\n      citation: {\n        platform: \"imessage\",\n        label: msg.chatId ?? msg.fromHandle,\n      },\n    });\n  }\n  return { hits, unsupported: [] };\n}\n\nasync function searchSignal(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  unsupported: CrossChannelSearchUnsupported[];\n}> {\n  const lifeOps = getLifeOpsSearchService(runtime);\n  if (!lifeOps || typeof lifeOps.readSignalInbound !== \"function\") {\n    return {\n      hits: [],\n      unsupported: [\n        {\n          channel: \"signal\",\n          reason: \"Signal passive read is not available on LifeOpsService\",\n        },\n      ],\n    };\n  }\n\n  const limit = query.limit ?? DEFAULT_PER_CHANNEL_LIMIT;\n  const needle = query.query.trim().toLowerCase();\n  const messages = await lifeOps.readSignalInbound(limit + 25);\n  const hits: CrossChannelSearchHit[] = [];\n  for (const msg of messages) {\n    const timestamp = normalizeIsoFromMs(msg.createdAt);\n    if (!withinTimeWindow(timestamp, query.timeWindow)) {\n      continue;\n    }\n    if (needle && !msg.text.toLowerCase().includes(needle)) {\n      continue;\n    }\n    hits.push({\n      channel: \"signal\",\n      id: `signal:${msg.id}`,\n      sourceRef: msg.id,\n      timestamp,\n      speaker: msg.speakerName ?? msg.senderNumber ?? \"unknown\",\n      text: msg.text,\n      citation: {\n        platform: \"signal\",\n        label: msg.roomName ?? msg.threadId ?? \"Signal\",\n      },\n    });\n  }\n  return { hits: hits.slice(0, limit), unsupported: [] };\n}\n\nasync function searchWhatsApp(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  unsupported: CrossChannelSearchUnsupported[];\n}> {\n  const lifeOps = getLifeOpsSearchService(runtime);\n  if (!lifeOps || typeof lifeOps.pullWhatsAppRecent !== \"function\") {\n    return {\n      hits: [],\n      unsupported: [\n        {\n          channel: \"whatsapp\",\n          reason: \"WhatsApp passive read is not available on LifeOpsService\",\n        },\n      ],\n    };\n  }\n\n  const limit = query.limit ?? DEFAULT_PER_CHANNEL_LIMIT;\n  const needle = query.query.trim().toLowerCase();\n  const recent = await lifeOps.pullWhatsAppRecent(limit + 25);\n  const hits: CrossChannelSearchHit[] = [];\n  for (const msg of recent.messages) {\n    const text = msg.text?.trim();\n    if (!text) {\n      continue;\n    }\n    if (!withinTimeWindow(msg.timestamp, query.timeWindow)) {\n      continue;\n    }\n    if (needle && !text.toLowerCase().includes(needle)) {\n      continue;\n    }\n    hits.push({\n      channel: \"whatsapp\",\n      id: `whatsapp:${msg.id}`,\n      sourceRef: msg.id,\n      timestamp: msg.timestamp,\n      speaker: msg.metadata?.contactName ?? msg.from,\n      text,\n      citation: {\n        platform: \"whatsapp\",\n        label: msg.metadata?.contactName ?? msg.channelId,\n      },\n    });\n  }\n  return { hits: hits.slice(0, limit), unsupported: [] };\n}\n\nfunction searchableCalendarText(event: LifeOpsCalendarEvent): string {\n  return [\n    event.title,\n    event.description,\n    event.location,\n    event.organizer && typeof event.organizer === \"object\"\n      ? JSON.stringify(event.organizer)\n      : \"\",\n    ...event.attendees.map((attendee) =>\n      [attendee.displayName, attendee.email].filter(Boolean).join(\" \"),\n    ),\n  ]\n    .filter(Boolean)\n    .join(\" \")\n    .toLowerCase();\n}\n\nasync function searchCalendar(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  unsupported: CrossChannelSearchUnsupported[];\n}> {\n  const lifeOps = getLifeOpsSearchService(runtime);\n  if (!lifeOps || typeof lifeOps.getCalendarFeed !== \"function\") {\n    return {\n      hits: [],\n      unsupported: [\n        {\n          channel: \"calendar\",\n          reason: \"Calendar feed is not available on LifeOpsService\",\n        },\n      ],\n    };\n  }\n\n  const feed = await lifeOps.getCalendarFeed(\n    new URL(\"http://127.0.0.1/api/lifeops/calendar/feed\"),\n    {\n      timeMin: query.timeWindow?.startIso,\n      timeMax: query.timeWindow?.endIso,\n      includeHiddenCalendars: true,\n    },\n  );\n  const needle = query.query.trim().toLowerCase();\n  const hits: CrossChannelSearchHit[] = [];\n  for (const event of feed.events) {\n    if (!withinTimeWindow(event.startAt, query.timeWindow)) {\n      continue;\n    }\n    if (needle && !searchableCalendarText(event).includes(needle)) {\n      continue;\n    }\n    const organizer =\n      event.organizer && typeof event.organizer === \"object\"\n        ? (event.organizer as { displayName?: unknown; email?: unknown })\n        : null;\n    hits.push({\n      channel: \"calendar\",\n      id: `calendar:${event.id}`,\n      sourceRef: event.id,\n      timestamp: event.startAt,\n      speaker:\n        typeof organizer?.displayName === \"string\"\n          ? organizer.displayName\n          : typeof organizer?.email === \"string\"\n            ? organizer.email\n            : \"calendar\",\n      subject: event.title,\n      text: [event.title, event.description, event.location]\n        .filter(Boolean)\n        .join(\" — \"),\n      citation: {\n        platform: \"calendar\",\n        label: event.title,\n        url: event.htmlLink ?? event.conferenceLink ?? undefined,\n      },\n    });\n  }\n  return { hits, unsupported: [] };\n}\n\nfunction xStatusUrl(item: LifeOpsXFeedItem): string | undefined {\n  const tweetId = item.externalTweetId.trim();\n  if (!tweetId) return undefined;\n  const handle = item.authorHandle.replace(/^@/, \"\").trim();\n  return handle\n    ? `https://x.com/${encodeURIComponent(handle)}/status/${encodeURIComponent(tweetId)}`\n    : `https://x.com/i/web/status/${encodeURIComponent(tweetId)}`;\n}\n\nasync function searchXPostsChannel(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  unsupported: CrossChannelSearchUnsupported[];\n}> {\n  const lifeOps = getLifeOpsSearchService(runtime);\n  if (!lifeOps || typeof lifeOps.searchXPosts !== \"function\") {\n    return {\n      hits: [],\n      unsupported: [\n        {\n          channel: \"x\",\n          reason: \"X post search is not available on LifeOpsService\",\n        },\n      ],\n    };\n  }\n\n  const limit = query.limit ?? DEFAULT_PER_CHANNEL_LIMIT;\n  const posts = await lifeOps.searchXPosts(query.query, { limit });\n  const hits: CrossChannelSearchHit[] = [];\n  for (const post of posts) {\n    if (!withinTimeWindow(post.createdAtSource, query.timeWindow)) {\n      continue;\n    }\n    hits.push({\n      channel: \"x\",\n      id: `x:${post.externalTweetId || post.id}`,\n      sourceRef: post.id,\n      timestamp: post.createdAtSource,\n      speaker: post.authorHandle,\n      text: post.text,\n      citation: {\n        platform: \"x\",\n        label: post.authorHandle,\n        url: xStatusUrl(post),\n      },\n    });\n  }\n  return { hits, unsupported: [] };\n}\n\nasync function searchXDms(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  unsupported: CrossChannelSearchUnsupported[];\n}> {\n  const lifeOps = getLifeOpsSearchService(runtime);\n  if (!lifeOps || typeof lifeOps.getXDms !== \"function\") {\n    return {\n      hits: [],\n      unsupported: [\n        {\n          channel: \"x-dm\",\n          reason: \"X DM search is not available on LifeOpsService\",\n        },\n      ],\n    };\n  }\n\n  const limit = query.limit ?? DEFAULT_PER_CHANNEL_LIMIT;\n  const needle = query.query.trim().toLowerCase();\n  const dms = await lifeOps.getXDms({ limit: limit + 10 });\n  const hits: CrossChannelSearchHit[] = [];\n  for (const dm of dms) {\n    if (!withinTimeWindow(dm.receivedAt, query.timeWindow)) {\n      continue;\n    }\n    if (needle && !dm.text.toLowerCase().includes(needle)) {\n      continue;\n    }\n    hits.push({\n      channel: \"x-dm\",\n      id: `x-dm:${dm.id}`,\n      sourceRef: dm.id,\n      timestamp: dm.receivedAt,\n      speaker: dm.isInbound ? dm.senderHandle : \"me\",\n      text: dm.text,\n      citation: {\n        platform: \"x\",\n        label: dm.senderHandle || dm.conversationId,\n      },\n    });\n  }\n  return { hits: hits.slice(0, limit), unsupported: [] };\n}\n\nasync function embedQuery(\n  runtime: IAgentRuntime,\n  text: string,\n): Promise<number[] | null> {\n  const result = await runWithTrajectoryContext(\n    { purpose: \"lifeops-cross-channel-search-embedding\" },\n    () => runtime.useModel(ModelType.TEXT_EMBEDDING, { text }),\n  );\n  if (Array.isArray(result)) {\n    return result;\n  }\n  if (\n    result &&\n    typeof result === \"object\" &&\n    Array.isArray((result as { embedding?: unknown }).embedding)\n  ) {\n    return (result as { embedding: number[] }).embedding;\n  }\n  return null;\n}\n\nasync function searchAgentMemory(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  degraded: CrossChannelSearchDegraded[];\n}> {\n  const embedding = await embedQuery(runtime, query.query);\n  if (!embedding) {\n    return {\n      hits: [],\n      degraded: [\n        {\n          channel: \"memory\",\n          reason: \"Embedding generation returned no vector\",\n        },\n      ],\n    };\n  }\n\n  const limit = query.limit ?? DEFAULT_PER_CHANNEL_LIMIT;\n  const searchParams: Parameters<IAgentRuntime[\"searchMemories\"]>[0] = {\n    embedding,\n    tableName: \"messages\",\n    match_threshold: MEMORY_MATCH_THRESHOLD,\n    limit: limit + 10,\n    worldId: query.worldId,\n  };\n\n  const memories = await runtime.searchMemories(searchParams);\n  const hits = await memoriesToHits(runtime, memories, query);\n  return { hits, degraded: [] };\n}\n\nasync function memoriesToHits(\n  runtime: IAgentRuntime,\n  memories: Memory[],\n  query: CrossChannelSearchQuery,\n): Promise<CrossChannelSearchHit[]> {\n  const roomCache = new Map<string, Room | null>();\n  const results: CrossChannelSearchHit[] = [];\n\n  for (const mem of memories) {\n    const text = (mem.content.text ?? \"\").trim();\n    if (!text) continue;\n\n    const iso = normalizeIsoFromMs(mem.createdAt);\n    if (!withinTimeWindow(iso, query.timeWindow)) {\n      continue;\n    }\n\n    const roomId = mem.roomId as UUID | undefined;\n    let room: Room | null = null;\n    if (roomId) {\n      if (!roomCache.has(roomId)) {\n        const fetched = await runtime.getRoom(roomId);\n        roomCache.set(roomId, fetched ?? null);\n      }\n      room = roomCache.get(roomId) ?? null;\n    }\n\n    const roomRecord = room as\n      | (Room & { name?: string; source?: string })\n      | null;\n    const platformSource = roomRecord?.source ?? roomRecord?.type;\n    const channel = classifyMemoryChannel(platformSource);\n\n    if (!isChannelEnabled(channel, query.channels)) {\n      continue;\n    }\n\n    const speakerEntity = mem.entityId as string | undefined;\n    const memId =\n      (mem.id as string | undefined) ?? `${roomId}:${mem.createdAt}`;\n\n    results.push({\n      channel,\n      id: `${channel}:${memId}`,\n      sourceRef: memId,\n      timestamp: iso,\n      speaker: speakerEntity ?? \"unknown\",\n      text: text.slice(0, 600),\n      citation: {\n        platform: KNOWN_PLATFORM_FOR_CHANNEL[channel],\n        label: roomRecord?.name ?? `room:${(roomId ?? \"\").slice(0, 8)}`,\n      },\n    });\n  }\n\n  return results;\n}\n\n// ---------------------------------------------------------------------------\n// WS3 cluster fan-out\n// ---------------------------------------------------------------------------\n\n// WS3 plans to publish this on RelationshipsGraphService. Until the type is\n// committed upstream we encode the expected signature locally.\ntype GetMemoriesForClusterFn = (args: {\n  primaryEntityId: UUID;\n  count?: number;\n  worldId?: UUID;\n}) => Promise<Memory[]>;\n\ntype RelationshipsGraphServiceWithCluster = RelationshipsGraphService & {\n  getMemoriesForCluster?: GetMemoriesForClusterFn;\n};\n\nfunction isRelationshipsGraphServiceWithCluster(\n  service: unknown,\n): service is RelationshipsGraphServiceWithCluster {\n  if (!isObjectService(service)) return false;\n  const candidate = service as Partial<RelationshipsGraphServiceWithCluster>;\n  return (\n    typeof candidate.getGraphSnapshot === \"function\" &&\n    typeof candidate.getPersonDetail === \"function\"\n  );\n}\n\nasync function resolvePerson(\n  runtime: IAgentRuntime,\n  ref: CrossChannelSearchPersonRef | undefined,\n): Promise<{\n  service: RelationshipsGraphServiceWithCluster | null;\n  person: RelationshipsPersonSummary | null;\n  degraded: CrossChannelSearchDegraded[];\n}> {\n  if (!ref) {\n    return { service: null, person: null, degraded: [] };\n  }\n\n  const candidateService = runtime.getService(\"relationships\");\n  const baseService = isRelationshipsGraphServiceWithCluster(candidateService)\n    ? candidateService\n    : null;\n  const service = baseService\n    ? ({\n        ...baseService,\n        getMemoriesForCluster:\n          baseService.getMemoriesForCluster ??\n          ((args) =>\n            getClusterMemories(runtime, args.primaryEntityId, {\n              tableName: \"messages\",\n              worldId: args.worldId,\n              count: args.count,\n            })),\n      } satisfies RelationshipsGraphServiceWithCluster)\n    : null;\n  if (!service) {\n    return {\n      service: null,\n      person: null,\n      degraded: [\n        {\n          channel: \"memory\",\n          reason:\n            \"RelationshipsGraphService not registered — falling back to plain semantic search\",\n        },\n      ],\n    };\n  }\n\n  if (ref.primaryEntityId) {\n    const detail = await service.getPersonDetail(ref.primaryEntityId);\n    if (detail) {\n      return { service, person: detail, degraded: [] };\n    }\n  }\n\n  const search = ref.displayName?.trim();\n  if (!search) {\n    return { service, person: null, degraded: [] };\n  }\n\n  const snapshot = await service.getGraphSnapshot({ search, limit: 5 });\n  const person = snapshot.people[0] ?? null;\n  return { service, person, degraded: [] };\n}\n\nasync function searchClusterMemories(\n  runtime: IAgentRuntime,\n  service: RelationshipsGraphServiceWithCluster,\n  person: RelationshipsPersonSummary,\n  query: CrossChannelSearchQuery,\n): Promise<{\n  hits: CrossChannelSearchHit[];\n  degraded: CrossChannelSearchDegraded[];\n}> {\n  const fn = service.getMemoriesForCluster;\n  if (typeof fn !== \"function\") {\n    return {\n      hits: [],\n      degraded: [\n        {\n          channel: \"memory\",\n          reason:\n            \"RelationshipsGraphService.getMemoriesForCluster is unavailable on the registered service\",\n        },\n      ],\n    };\n  }\n\n  const memories = await fn({\n    primaryEntityId: person.primaryEntityId,\n    count: (query.limit ?? DEFAULT_PER_CHANNEL_LIMIT) * 2,\n    worldId: query.worldId,\n  });\n  const hits = await memoriesToHits(runtime, memories, query);\n  return { hits, degraded: [] };\n}\n\n// ---------------------------------------------------------------------------\n// Connector adapters that don't yet have first-class search\n// ---------------------------------------------------------------------------\n\nconst CONNECTORS_WITHOUT_NATIVE_SEARCH: ReadonlyArray<{\n  channel: CrossChannelSearchChannel;\n  reason: string;\n}> = [\n  {\n    channel: \"calendly\",\n    reason: \"Calendly search is not available on LifeOpsService\",\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Result merge\n// ---------------------------------------------------------------------------\n\nfunction dedupeHits(hits: CrossChannelSearchHit[]): CrossChannelSearchHit[] {\n  const seen = new Set<string>();\n  const out: CrossChannelSearchHit[] = [];\n  for (const hit of hits) {\n    if (seen.has(hit.id)) continue;\n    seen.add(hit.id);\n    out.push(hit);\n  }\n  return out;\n}\n\nfunction rankHits(hits: CrossChannelSearchHit[]): CrossChannelSearchHit[] {\n  return [...hits].sort((a, b) => {\n    const ta = Date.parse(a.timestamp);\n    const tb = Date.parse(b.timestamp);\n    if (Number.isNaN(ta) && Number.isNaN(tb)) return 0;\n    if (Number.isNaN(ta)) return 1;\n    if (Number.isNaN(tb)) return -1;\n    return tb - ta;\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Public entry point\n// ---------------------------------------------------------------------------\n\nexport async function runCrossChannelSearch(\n  runtime: IAgentRuntime,\n  query: CrossChannelSearchQuery,\n): Promise<CrossChannelSearchResult> {\n  if (query.query.trim().length === 0) {\n    throw new Error(\"runCrossChannelSearch: query.query is required\");\n  }\n\n  const channels = query.channels;\n  const unsupported: CrossChannelSearchUnsupported[] = [];\n  const degraded: CrossChannelSearchDegraded[] = [];\n  const allHits: CrossChannelSearchHit[] = [];\n\n  // 1. Resolve canonical person via WS3 (best-effort).\n  const personResolution = await resolvePerson(runtime, query.personRef);\n  degraded.push(...personResolution.degraded);\n\n  // 2. Fan out in parallel.\n  const tasks: Array<Promise<void>> = [];\n\n  if (isChannelEnabled(\"gmail\", channels)) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchGmail(runtime, query);\n          allHits.push(...r.hits);\n          unsupported.push(...r.unsupported);\n          degraded.push(...r.degraded);\n        } catch (err) {\n          degraded.push({\n            channel: \"gmail\",\n            reason: `Gmail search failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  if (isChannelEnabled(\"telegram\", channels)) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchTelegram(runtime, query);\n          allHits.push(...r.hits);\n          unsupported.push(...r.unsupported);\n        } catch (err) {\n          degraded.push({\n            channel: \"telegram\",\n            reason: `Telegram search failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  if (isChannelEnabled(\"discord\", channels)) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchDiscord(runtime, query);\n          allHits.push(...r.hits);\n          unsupported.push(...r.unsupported);\n        } catch (err) {\n          degraded.push({\n            channel: \"discord\",\n            reason: `Discord search failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  if (isChannelEnabled(\"imessage\", channels)) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchIMessages(runtime, query);\n          allHits.push(...r.hits);\n          unsupported.push(...r.unsupported);\n        } catch (err) {\n          degraded.push({\n            channel: \"imessage\",\n            reason: `iMessage search failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  if (isChannelEnabled(\"signal\", channels)) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchSignal(runtime, query);\n          allHits.push(...r.hits);\n          unsupported.push(...r.unsupported);\n        } catch (err) {\n          degraded.push({\n            channel: \"signal\",\n            reason: `Signal search failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  if (isChannelEnabled(\"whatsapp\", channels)) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchWhatsApp(runtime, query);\n          allHits.push(...r.hits);\n          unsupported.push(...r.unsupported);\n        } catch (err) {\n          degraded.push({\n            channel: \"whatsapp\",\n            reason: `WhatsApp search failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  if (isChannelEnabled(\"calendar\", channels)) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchCalendar(runtime, query);\n          allHits.push(...r.hits);\n          unsupported.push(...r.unsupported);\n        } catch (err) {\n          degraded.push({\n            channel: \"calendar\",\n            reason: `Calendar search failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  if (isChannelEnabled(\"x\", channels)) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchXPostsChannel(runtime, query);\n          allHits.push(...r.hits);\n          unsupported.push(...r.unsupported);\n        } catch (err) {\n          degraded.push({\n            channel: \"x\",\n            reason: `X post search failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  if (isChannelEnabled(\"x-dm\", channels)) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchXDms(runtime, query);\n          allHits.push(...r.hits);\n          unsupported.push(...r.unsupported);\n        } catch (err) {\n          degraded.push({\n            channel: \"x-dm\",\n            reason: `X DM search failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  if (isChannelEnabled(\"memory\", channels)) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchAgentMemory(runtime, query);\n          allHits.push(...r.hits);\n          degraded.push(...r.degraded);\n        } catch (err) {\n          degraded.push({\n            channel: \"memory\",\n            reason: `Memory search failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  if (personResolution.service && personResolution.person) {\n    tasks.push(\n      (async () => {\n        try {\n          const r = await searchClusterMemories(\n            runtime,\n            personResolution.service as RelationshipsGraphServiceWithCluster,\n            personResolution.person as RelationshipsPersonSummary,\n            query,\n          );\n          allHits.push(...r.hits);\n          degraded.push(...r.degraded);\n        } catch (err) {\n          degraded.push({\n            channel: \"memory\",\n            reason: `Cluster fan-out failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          });\n        }\n      })(),\n    );\n  }\n\n  await Promise.all(tasks);\n\n  // 3. Emit unsupported markers for connectors without native search, only\n  //    when the caller explicitly asked for that channel (so we don't spam\n  //    every result with the full list).\n  for (const entry of CONNECTORS_WITHOUT_NATIVE_SEARCH) {\n    if (channels?.includes(entry.channel)) {\n      unsupported.push(entry);\n    }\n  }\n\n  // 4. Dedupe + rank.\n  const merged = rankHits(dedupeHits(allHits));\n  const channelsWithHits = Array.from(\n    new Set(merged.map((h) => h.channel)),\n  ) as CrossChannelSearchChannel[];\n\n  const finalLimit =\n    (query.limit ?? DEFAULT_PER_CHANNEL_LIMIT) *\n    CROSS_CHANNEL_SEARCH_CHANNELS.length;\n  const limited = merged.slice(0, finalLimit);\n\n  logger.debug(\n    `[cross-channel-search] query=\"${query.query}\" hits=${limited.length} unsupported=${unsupported.length} degraded=${degraded.length}`,\n  );\n\n  return {\n    query: query.query,\n    hits: limited,\n    unsupported,\n    degraded,\n    channelsWithHits,\n    resolvedPerson: personResolution.person,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/lifeops/defaults.d.ts

@@ -0,0 +1,30 @@
+import type { ActivityProfile } from "../activity-profile/types";
+import type { LifeOpsReminderStep, LifeOpsTimeWindowDefinition, LifeOpsWindowPolicy } from "../contracts/index.js";
+export { isValidTimeZone, normalizeTimeZone, resolveDefaultTimeZone, } from "@elizaos/shared";
+export declare const DEFAULT_TIME_WINDOWS: LifeOpsTimeWindowDefinition[];
+export declare const DEFAULT_REMINDER_STEPS: LifeOpsReminderStep[];
+export declare function resolveDefaultWindowPolicy(timeZone?: string | null): LifeOpsWindowPolicy;
+/**
+ * Returns true when the given window policy's windows match the static
+ * `DEFAULT_TIME_WINDOWS` by name and minute boundaries — i.e. the user
+ * has not customized them.
+ */
+export declare function windowPolicyMatchesDefaults(policy: LifeOpsWindowPolicy | null | undefined): boolean;
+/**
+ * Compute a `LifeOpsWindowPolicy` whose boundaries are shifted to match
+ * the user's actual rhythm as captured by the activity profile.
+ *
+ * Pure function — no runtime dependency.  If the profile has no usable
+ * rhythm data the returned policy equals `DEFAULT_TIME_WINDOWS`.
+ */
+export declare function computeAdaptiveWindowPolicy(profile: Pick<ActivityProfile, "typicalWakeHour" | "typicalFirstActiveHour" | "typicalLastActiveHour" | "typicalSleepHour">, timezone?: string | null): LifeOpsWindowPolicy;
+export declare function normalizeWindowPolicy(policy: LifeOpsWindowPolicy | null | undefined, timeZone?: string | null): LifeOpsWindowPolicy;
+/**
+ * Resolve the number of recent conversation lines to include in
+ * LifeOps extraction prompts.
+ *
+ * Reads `ELIZA_LIFEOPS_CONTEXT_WINDOW` from the environment. Falls
+ * back to {@link DEFAULT_LIFEOPS_CONTEXT_WINDOW} (16) when unset or invalid.
+ */
+export declare function resolveContextWindow(): number;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/lifeops/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/lifeops/defaults.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,oBAAoB,EAAE,2BAA2B,EAyB7D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,EAMvD,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,mBAAmB,CAMrB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAC7C,OAAO,CAkBT;AAiBD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,IAAI,CACX,eAAe,EACb,iBAAiB,GACjB,wBAAwB,GACxB,uBAAuB,GACvB,kBAAkB,CACrB,EACD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,mBAAmB,CAiGrB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EAC9C,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,mBAAmB,CAwCrB;AASD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAS7C"}

package/dist/lifeops/defaults.js

@@ -0,0 +1,206 @@
+import {
+  normalizeTimeZone
+} from "@elizaos/shared";
+import {
+  isValidTimeZone as isValidTimeZone2,
+  normalizeTimeZone as normalizeTimeZone2,
+  resolveDefaultTimeZone as resolveDefaultTimeZone2
+} from "@elizaos/shared";
+const DEFAULT_TIME_WINDOWS = [
+  {
+    name: "morning",
+    label: "Morning",
+    startMinute: 5 * 60,
+    endMinute: 12 * 60
+  },
+  {
+    name: "afternoon",
+    label: "Afternoon",
+    startMinute: 12 * 60,
+    endMinute: 17 * 60
+  },
+  {
+    name: "evening",
+    label: "Evening",
+    startMinute: 17 * 60,
+    endMinute: 22 * 60
+  },
+  {
+    name: "night",
+    label: "Night",
+    startMinute: 22 * 60,
+    endMinute: 28 * 60
+  }
+];
+const DEFAULT_REMINDER_STEPS = [
+  {
+    channel: "in_app",
+    offsetMinutes: 0,
+    label: "In-app reminder"
+  }
+];
+function resolveDefaultWindowPolicy(timeZone) {
+  const timezone = normalizeTimeZone(timeZone);
+  return {
+    timezone,
+    windows: DEFAULT_TIME_WINDOWS.map((window) => ({ ...window }))
+  };
+}
+function windowPolicyMatchesDefaults(policy) {
+  if (!policy || !Array.isArray(policy.windows)) return false;
+  if (policy.windows.length !== DEFAULT_TIME_WINDOWS.length) return false;
+  for (let i = 0; i < DEFAULT_TIME_WINDOWS.length; i++) {
+    const def = DEFAULT_TIME_WINDOWS[i];
+    const win = policy.windows[i];
+    if (!def || !win) {
+      return false;
+    }
+    if (win.name !== def.name || win.startMinute !== def.startMinute || win.endMinute !== def.endMinute) {
+      return false;
+    }
+  }
+  return true;
+}
+const ADAPTIVE_MORNING_FLOOR_MINUTES = 4 * 60;
+const ADAPTIVE_MORNING_END_CAP_MINUTES = 14 * 60;
+const ADAPTIVE_AFTERNOON_END_CAP_MINUTES = 20 * 60;
+const ADAPTIVE_EVENING_END_CAP_MINUTES = 28 * 60;
+const ADAPTIVE_LEAD_HOURS = 0.5;
+const ADAPTIVE_WINDOW_SPAN_HOURS = 5;
+const ADAPTIVE_LAST_ACTIVE_LAG_HOURS = 1;
+function computeAdaptiveWindowPolicy(profile, timezone) {
+  const tz = normalizeTimeZone(timezone);
+  const wakeSource = profile.typicalWakeHour ?? profile.typicalFirstActiveHour;
+  if (wakeSource === null || wakeSource === void 0) {
+    return {
+      timezone: tz,
+      windows: DEFAULT_TIME_WINDOWS.map((w) => ({ ...w }))
+    };
+  }
+  const morningStartMinute = Math.max(
+    Math.round((wakeSource - ADAPTIVE_LEAD_HOURS) * 60),
+    ADAPTIVE_MORNING_FLOOR_MINUTES
+  );
+  const morningEndMinute = Math.min(
+    morningStartMinute + ADAPTIVE_WINDOW_SPAN_HOURS * 60,
+    ADAPTIVE_MORNING_END_CAP_MINUTES
+  );
+  const afternoonStartMinute = morningEndMinute;
+  const afternoonEndMinute = Math.min(
+    afternoonStartMinute + ADAPTIVE_WINDOW_SPAN_HOURS * 60,
+    ADAPTIVE_AFTERNOON_END_CAP_MINUTES
+  );
+  const eveningStartMinute = afternoonEndMinute;
+  let eveningEndMinute;
+  if (profile.typicalSleepHour !== null && profile.typicalSleepHour !== void 0) {
+    eveningEndMinute = Math.min(
+      Math.round(profile.typicalSleepHour * 60),
+      ADAPTIVE_EVENING_END_CAP_MINUTES
+    );
+  } else if (profile.typicalLastActiveHour !== null && profile.typicalLastActiveHour !== void 0) {
+    eveningEndMinute = Math.min(
+      Math.round(
+        (profile.typicalLastActiveHour + ADAPTIVE_LAST_ACTIVE_LAG_HOURS) * 60
+      ),
+      ADAPTIVE_EVENING_END_CAP_MINUTES
+    );
+  } else {
+    const defaultEveningWindow = DEFAULT_TIME_WINDOWS[2];
+    if (!defaultEveningWindow) {
+      throw new Error("[lifeops-defaults] missing default evening window");
+    }
+    eveningEndMinute = defaultEveningWindow.endMinute;
+  }
+  if (eveningEndMinute <= eveningStartMinute) {
+    eveningEndMinute = eveningStartMinute + 60;
+  }
+  const nightStartMinute = eveningEndMinute;
+  const nightEndMinute = morningStartMinute + 24 * 60;
+  return {
+    timezone: tz,
+    windows: [
+      {
+        name: "morning",
+        label: "Morning",
+        startMinute: morningStartMinute,
+        endMinute: morningEndMinute
+      },
+      {
+        name: "afternoon",
+        label: "Afternoon",
+        startMinute: afternoonStartMinute,
+        endMinute: afternoonEndMinute
+      },
+      {
+        name: "evening",
+        label: "Evening",
+        startMinute: eveningStartMinute,
+        endMinute: eveningEndMinute
+      },
+      {
+        name: "night",
+        label: "Night",
+        startMinute: nightStartMinute,
+        endMinute: nightEndMinute
+      }
+    ]
+  };
+}
+function normalizeWindowPolicy(policy, timeZone) {
+  const fallback = resolveDefaultWindowPolicy(timeZone);
+  if (!policy) return fallback;
+  const timezone = normalizeTimeZone(
+    policy.timezone || timeZone || fallback.timezone
+  );
+  const windows = Array.isArray(policy.windows) ? policy.windows.map((window) => {
+    const name = window.name;
+    const label = typeof window.label === "string" && window.label.trim().length > 0 ? window.label.trim() : name;
+    const startMinute = Number(window.startMinute);
+    const endMinute = Number(window.endMinute);
+    if (!Number.isFinite(startMinute) || !Number.isFinite(endMinute)) {
+      return null;
+    }
+    if (endMinute <= startMinute) {
+      return null;
+    }
+    return {
+      name,
+      label,
+      startMinute,
+      endMinute
+    };
+  }).filter(
+    (window) => window !== null
+  ) : [];
+  if (windows.length === 0) {
+    return fallback;
+  }
+  return {
+    timezone,
+    windows
+  };
+}
+const DEFAULT_LIFEOPS_CONTEXT_WINDOW = 16;
+function resolveContextWindow() {
+  const envValue = process.env.ELIZA_LIFEOPS_CONTEXT_WINDOW;
+  if (envValue) {
+    const parsed = parseInt(envValue, 10);
+    if (Number.isFinite(parsed) && parsed > 0) {
+      return parsed;
+    }
+  }
+  return DEFAULT_LIFEOPS_CONTEXT_WINDOW;
+}
+export {
+  DEFAULT_REMINDER_STEPS,
+  DEFAULT_TIME_WINDOWS,
+  computeAdaptiveWindowPolicy,
+  isValidTimeZone2 as isValidTimeZone,
+  normalizeTimeZone2 as normalizeTimeZone,
+  normalizeWindowPolicy,
+  resolveContextWindow,
+  resolveDefaultTimeZone2 as resolveDefaultTimeZone,
+  resolveDefaultWindowPolicy,
+  windowPolicyMatchesDefaults
+};
+//# sourceMappingURL=defaults.js.map

package/dist/lifeops/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/defaults.ts"],"sourcesContent":["import {\n  isValidTimeZone,\n  normalizeTimeZone,\n  resolveDefaultTimeZone,\n} from \"@elizaos/shared\";\nimport type { ActivityProfile } from \"../activity-profile/types.js\";\nimport type {\n  LifeOpsReminderStep,\n  LifeOpsTimeWindowDefinition,\n  LifeOpsWindowPolicy,\n} from \"../contracts/index.js\";\n\n// The time-zone helpers are now runtime-level primitives in `@elizaos/shared`;\n// re-exported here so historical `./defaults.js` callers keep working.\nexport {\n  isValidTimeZone,\n  normalizeTimeZone,\n  resolveDefaultTimeZone,\n} from \"@elizaos/shared\";\n\nexport const DEFAULT_TIME_WINDOWS: LifeOpsTimeWindowDefinition[] = [\n  {\n    name: \"morning\",\n    label: \"Morning\",\n    startMinute: 5 * 60,\n    endMinute: 12 * 60,\n  },\n  {\n    name: \"afternoon\",\n    label: \"Afternoon\",\n    startMinute: 12 * 60,\n    endMinute: 17 * 60,\n  },\n  {\n    name: \"evening\",\n    label: \"Evening\",\n    startMinute: 17 * 60,\n    endMinute: 22 * 60,\n  },\n  {\n    name: \"night\",\n    label: \"Night\",\n    startMinute: 22 * 60,\n    endMinute: 28 * 60,\n  },\n];\n\nexport const DEFAULT_REMINDER_STEPS: LifeOpsReminderStep[] = [\n  {\n    channel: \"in_app\",\n    offsetMinutes: 0,\n    label: \"In-app reminder\",\n  },\n];\n\nexport function resolveDefaultWindowPolicy(\n  timeZone?: string | null,\n): LifeOpsWindowPolicy {\n  const timezone = normalizeTimeZone(timeZone);\n  return {\n    timezone,\n    windows: DEFAULT_TIME_WINDOWS.map((window) => ({ ...window })),\n  };\n}\n\n/**\n * Returns true when the given window policy's windows match the static\n * `DEFAULT_TIME_WINDOWS` by name and minute boundaries — i.e. the user\n * has not customized them.\n */\nexport function windowPolicyMatchesDefaults(\n  policy: LifeOpsWindowPolicy | null | undefined,\n): boolean {\n  if (!policy || !Array.isArray(policy.windows)) return false;\n  if (policy.windows.length !== DEFAULT_TIME_WINDOWS.length) return false;\n  for (let i = 0; i < DEFAULT_TIME_WINDOWS.length; i++) {\n    const def = DEFAULT_TIME_WINDOWS[i];\n    const win = policy.windows[i];\n    if (!def || !win) {\n      return false;\n    }\n    if (\n      win.name !== def.name ||\n      win.startMinute !== def.startMinute ||\n      win.endMinute !== def.endMinute\n    ) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/** Floor value for the morning window start (4:00 AM in minutes). */\nconst ADAPTIVE_MORNING_FLOOR_MINUTES = 4 * 60;\n/** Ceiling value for the morning window end (2:00 PM in minutes). */\nconst ADAPTIVE_MORNING_END_CAP_MINUTES = 14 * 60;\n/** Ceiling value for the afternoon window end (8:00 PM in minutes). */\nconst ADAPTIVE_AFTERNOON_END_CAP_MINUTES = 20 * 60;\n/** Ceiling value for the evening window end (4:00 AM next day in minutes). */\nconst ADAPTIVE_EVENING_END_CAP_MINUTES = 28 * 60;\n/** How long before typical wake/first-active to start the morning window. */\nconst ADAPTIVE_LEAD_HOURS = 0.5;\n/** Standard span of the morning and afternoon windows. */\nconst ADAPTIVE_WINDOW_SPAN_HOURS = 5;\n/** How long after typical last active to end the evening window. */\nconst ADAPTIVE_LAST_ACTIVE_LAG_HOURS = 1;\n\n/**\n * Compute a `LifeOpsWindowPolicy` whose boundaries are shifted to match\n * the user's actual rhythm as captured by the activity profile.\n *\n * Pure function — no runtime dependency.  If the profile has no usable\n * rhythm data the returned policy equals `DEFAULT_TIME_WINDOWS`.\n */\nexport function computeAdaptiveWindowPolicy(\n  profile: Pick<\n    ActivityProfile,\n    | \"typicalWakeHour\"\n    | \"typicalFirstActiveHour\"\n    | \"typicalLastActiveHour\"\n    | \"typicalSleepHour\"\n  >,\n  timezone?: string | null,\n): LifeOpsWindowPolicy {\n  const tz = normalizeTimeZone(timezone);\n\n  // Determine morning start from wake or first-active data.\n  const wakeSource = profile.typicalWakeHour ?? profile.typicalFirstActiveHour;\n  if (wakeSource === null || wakeSource === undefined) {\n    // No rhythm data — return defaults unchanged.\n    return {\n      timezone: tz,\n      windows: DEFAULT_TIME_WINDOWS.map((w) => ({ ...w })),\n    };\n  }\n\n  const morningStartMinute = Math.max(\n    Math.round((wakeSource - ADAPTIVE_LEAD_HOURS) * 60),\n    ADAPTIVE_MORNING_FLOOR_MINUTES,\n  );\n\n  const morningEndMinute = Math.min(\n    morningStartMinute + ADAPTIVE_WINDOW_SPAN_HOURS * 60,\n    ADAPTIVE_MORNING_END_CAP_MINUTES,\n  );\n\n  const afternoonStartMinute = morningEndMinute;\n  const afternoonEndMinute = Math.min(\n    afternoonStartMinute + ADAPTIVE_WINDOW_SPAN_HOURS * 60,\n    ADAPTIVE_AFTERNOON_END_CAP_MINUTES,\n  );\n\n  const eveningStartMinute = afternoonEndMinute;\n\n  let eveningEndMinute: number;\n  if (\n    profile.typicalSleepHour !== null &&\n    profile.typicalSleepHour !== undefined\n  ) {\n    // typicalSleepHour can exceed 24 (e.g. 25 = 1 AM next day).\n    eveningEndMinute = Math.min(\n      Math.round(profile.typicalSleepHour * 60),\n      ADAPTIVE_EVENING_END_CAP_MINUTES,\n    );\n  } else if (\n    profile.typicalLastActiveHour !== null &&\n    profile.typicalLastActiveHour !== undefined\n  ) {\n    eveningEndMinute = Math.min(\n      Math.round(\n        (profile.typicalLastActiveHour + ADAPTIVE_LAST_ACTIVE_LAG_HOURS) * 60,\n      ),\n      ADAPTIVE_EVENING_END_CAP_MINUTES,\n    );\n  } else {\n    const defaultEveningWindow = DEFAULT_TIME_WINDOWS[2];\n    if (!defaultEveningWindow) {\n      throw new Error(\"[lifeops-defaults] missing default evening window\");\n    }\n    eveningEndMinute = defaultEveningWindow.endMinute;\n  }\n\n  // Guard: evening end must be strictly after evening start.\n  if (eveningEndMinute <= eveningStartMinute) {\n    eveningEndMinute = eveningStartMinute + 60;\n  }\n\n  // Night wraps from evening end to morning start + 24.\n  const nightStartMinute = eveningEndMinute;\n  const nightEndMinute = morningStartMinute + 24 * 60;\n\n  return {\n    timezone: tz,\n    windows: [\n      {\n        name: \"morning\",\n        label: \"Morning\",\n        startMinute: morningStartMinute,\n        endMinute: morningEndMinute,\n      },\n      {\n        name: \"afternoon\",\n        label: \"Afternoon\",\n        startMinute: afternoonStartMinute,\n        endMinute: afternoonEndMinute,\n      },\n      {\n        name: \"evening\",\n        label: \"Evening\",\n        startMinute: eveningStartMinute,\n        endMinute: eveningEndMinute,\n      },\n      {\n        name: \"night\",\n        label: \"Night\",\n        startMinute: nightStartMinute,\n        endMinute: nightEndMinute,\n      },\n    ],\n  };\n}\n\nexport function normalizeWindowPolicy(\n  policy: LifeOpsWindowPolicy | null | undefined,\n  timeZone?: string | null,\n): LifeOpsWindowPolicy {\n  const fallback = resolveDefaultWindowPolicy(timeZone);\n  if (!policy) return fallback;\n  const timezone = normalizeTimeZone(\n    policy.timezone || timeZone || fallback.timezone,\n  );\n  const windows = Array.isArray(policy.windows)\n    ? policy.windows\n        .map((window) => {\n          const name = window.name;\n          const label =\n            typeof window.label === \"string\" && window.label.trim().length > 0\n              ? window.label.trim()\n              : name;\n          const startMinute = Number(window.startMinute);\n          const endMinute = Number(window.endMinute);\n          if (!Number.isFinite(startMinute) || !Number.isFinite(endMinute)) {\n            return null;\n          }\n          if (endMinute <= startMinute) {\n            return null;\n          }\n          return {\n            name,\n            label,\n            startMinute,\n            endMinute,\n          } satisfies LifeOpsTimeWindowDefinition;\n        })\n        .filter(\n          (window): window is LifeOpsTimeWindowDefinition => window !== null,\n        )\n    : [];\n  if (windows.length === 0) {\n    return fallback;\n  }\n  return {\n    timezone,\n    windows,\n  };\n}\n\n/**\n * Default number of recent conversation lines to include in\n * LifeOps extraction prompts. Override at runtime via\n * `ELIZA_LIFEOPS_CONTEXT_WINDOW`.\n */\nconst DEFAULT_LIFEOPS_CONTEXT_WINDOW = 16;\n\n/**\n * Resolve the number of recent conversation lines to include in\n * LifeOps extraction prompts.\n *\n * Reads `ELIZA_LIFEOPS_CONTEXT_WINDOW` from the environment. Falls\n * back to {@link DEFAULT_LIFEOPS_CONTEXT_WINDOW} (16) when unset or invalid.\n */\nexport function resolveContextWindow(): number {\n  const envValue = process.env.ELIZA_LIFEOPS_CONTEXT_WINDOW;\n  if (envValue) {\n    const parsed = parseInt(envValue, 10);\n    if (Number.isFinite(parsed) && parsed > 0) {\n      return parsed;\n    }\n  }\n  return DEFAULT_LIFEOPS_CONTEXT_WINDOW;\n}\n"],"mappings":"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","names":["isValidTimeZone","normalizeTimeZone","resolveDefaultTimeZone"]}

package/dist/lifeops/device-bus-service.d.ts

@@ -0,0 +1,16 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import { type LifeOpsIntent, type LifeOpsIntentTargetDevice } from "./intent-sync.js";
+/**
+ * Service-layer wrappers around the local intent store. These helpers
+ * cover the management operations invoked directly by callers.
+ */
+export declare function acknowledgeDeviceIntent(runtime: IAgentRuntime, intentId: string, deviceId: string): Promise<void>;
+export declare function pruneExpiredDeviceIntents(runtime: IAgentRuntime): Promise<{
+    pruned: number;
+}>;
+export declare function listPendingDeviceIntents(runtime: IAgentRuntime, opts?: {
+    device?: LifeOpsIntentTargetDevice;
+    deviceId?: string;
+    limit?: number;
+}): Promise<LifeOpsIntent[]>;
+//# sourceMappingURL=device-bus-service.d.ts.map

package/dist/lifeops/device-bus-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-bus-service.d.ts","sourceRoot":"","sources":["../../src/lifeops/device-bus-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,yBAAyB,EAG/B,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AAEH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAE7B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,aAAa,EACtB,IAAI,CAAC,EAAE;IACL,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,aAAa,EAAE,CAAC,CAE1B"}

package/dist/lifeops/device-bus-service.js

@@ -0,0 +1,20 @@
+import {
+  acknowledgeIntent,
+  pruneExpiredIntents,
+  receivePendingIntents
+} from "./intent-sync.js";
+async function acknowledgeDeviceIntent(runtime, intentId, deviceId) {
+  await acknowledgeIntent(runtime, intentId, deviceId);
+}
+async function pruneExpiredDeviceIntents(runtime) {
+  return pruneExpiredIntents(runtime);
+}
+async function listPendingDeviceIntents(runtime, opts) {
+  return receivePendingIntents(runtime, opts);
+}
+export {
+  acknowledgeDeviceIntent,
+  listPendingDeviceIntents,
+  pruneExpiredDeviceIntents
+};
+//# sourceMappingURL=device-bus-service.js.map

package/dist/lifeops/device-bus-service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/device-bus-service.ts"],"sourcesContent":["import type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  acknowledgeIntent,\n  type LifeOpsIntent,\n  type LifeOpsIntentTargetDevice,\n  pruneExpiredIntents,\n  receivePendingIntents,\n} from \"./intent-sync.js\";\n\n/**\n * Service-layer wrappers around the local intent store. These helpers\n * cover the management operations invoked directly by callers.\n */\n\nexport async function acknowledgeDeviceIntent(\n  runtime: IAgentRuntime,\n  intentId: string,\n  deviceId: string,\n): Promise<void> {\n  await acknowledgeIntent(runtime, intentId, deviceId);\n}\n\nexport async function pruneExpiredDeviceIntents(\n  runtime: IAgentRuntime,\n): Promise<{ pruned: number }> {\n  return pruneExpiredIntents(runtime);\n}\n\nexport async function listPendingDeviceIntents(\n  runtime: IAgentRuntime,\n  opts?: {\n    device?: LifeOpsIntentTargetDevice;\n    deviceId?: string;\n    limit?: number;\n  },\n): Promise<LifeOpsIntent[]> {\n  return receivePendingIntents(runtime, opts);\n}\n"],"mappings":"AACA;AAAA,EACE;AAAA,EAGA;AAAA,EACA;AAAA,OACK;AAOP,eAAsB,wBACpB,SACA,UACA,UACe;AACf,QAAM,kBAAkB,SAAS,UAAU,QAAQ;AACrD;AAEA,eAAsB,0BACpB,SAC6B;AAC7B,SAAO,oBAAoB,OAAO;AACpC;AAEA,eAAsB,yBACpB,SACA,MAK0B;AAC1B,SAAO,sBAAsB,SAAS,IAAI;AAC5C;","names":[]}

package/dist/lifeops/device-identity.d.ts

@@ -0,0 +1,31 @@
+export interface DeviceFingerprint {
+    id: string;
+    hostname: string;
+    platform: NodeJS.Platform;
+    primaryMacAddress: string | null;
+}
+/**
+ * Returns a stable, process-lifetime device identifier.
+ *
+ * Resolution order:
+ *   1. `ELIZA_DEVICE_ID` env var
+ *   2. `ELIZA_DEVICE_ID` env var
+ *   3. Cached value at `<state-dir>/device-id`
+ *   4. Newly generated `<hostname>-<6-char-hex>`, persisted to that file
+ *
+ * The result is memoized for the lifetime of the process so repeated calls
+ * are cheap and guaranteed to return the same value.
+ */
+export declare function getDeviceId(env?: NodeJS.ProcessEnv): string;
+/**
+ * Returns a coarse fingerprint of the current device suitable for logging
+ * and presence-signal aggregation. Does not include any user-identifying
+ * data beyond what `os.hostname()` / `os.networkInterfaces()` already expose.
+ */
+export declare function getDeviceFingerprint(env?: NodeJS.ProcessEnv): DeviceFingerprint;
+/**
+ * Test-only: drops the in-memory cache so the next `getDeviceId` call
+ * re-runs the env -> file -> generate resolution.
+ */
+export declare function resetCachedDeviceId(): void;
+//# sourceMappingURL=device-identity.d.ts.map

package/dist/lifeops/device-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-identity.d.ts","sourceRoot":"","sources":["../../src/lifeops/device-identity.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AA2CD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAsBxE;AAkBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,iBAAiB,CAOnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/lifeops/device-identity.js

@@ -0,0 +1,94 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { resolveStateDir } from "@elizaos/agent";
+const ENV_KEYS = ["ELIZA_DEVICE_ID", "ELIZA_DEVICE_ID"];
+const CACHE_FILE_NAME = "device-id";
+const RANDOM_SUFFIX_BYTES = 3;
+let cachedDeviceId = null;
+function readEnvDeviceId(env) {
+  for (const key of ENV_KEYS) {
+    const raw = env[key];
+    if (typeof raw !== "string") continue;
+    const trimmed = raw.trim();
+    if (trimmed.length > 0) {
+      return trimmed;
+    }
+  }
+  return null;
+}
+function readFileDeviceId(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+  const contents = fs.readFileSync(filePath, "utf8").trim();
+  return contents.length > 0 ? contents : null;
+}
+function sanitizeHostname(hostname) {
+  const cleaned = hostname.trim().replace(/[^A-Za-z0-9._-]/g, "-");
+  return cleaned.length > 0 ? cleaned : "host";
+}
+function generateDeviceId(hostname) {
+  const suffix = crypto.randomBytes(RANDOM_SUFFIX_BYTES).toString("hex");
+  return `${sanitizeHostname(hostname)}-${suffix}`;
+}
+function persistDeviceId(filePath, deviceId) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, deviceId, "utf8");
+}
+function deviceIdCachePath(env) {
+  return path.join(resolveStateDir(env), CACHE_FILE_NAME);
+}
+function getDeviceId(env = process.env) {
+  if (cachedDeviceId !== null) {
+    return cachedDeviceId;
+  }
+  const fromEnv = readEnvDeviceId(env);
+  if (fromEnv !== null) {
+    cachedDeviceId = fromEnv;
+    return cachedDeviceId;
+  }
+  const cachePath = deviceIdCachePath(env);
+  const fromFile = readFileDeviceId(cachePath);
+  if (fromFile !== null) {
+    cachedDeviceId = fromFile;
+    return cachedDeviceId;
+  }
+  const generated = generateDeviceId(os.hostname());
+  persistDeviceId(cachePath, generated);
+  cachedDeviceId = generated;
+  return cachedDeviceId;
+}
+function readPrimaryMacAddress() {
+  const interfaces = os.networkInterfaces();
+  for (const name of Object.keys(interfaces)) {
+    const addrs = interfaces[name];
+    if (!addrs) continue;
+    for (const addr of addrs) {
+      if (addr.internal) continue;
+      const mac = addr.mac;
+      if (typeof mac !== "string") continue;
+      if (mac.length === 0 || mac === "00:00:00:00:00:00") continue;
+      return mac;
+    }
+  }
+  return null;
+}
+function getDeviceFingerprint(env = process.env) {
+  return {
+    id: getDeviceId(env),
+    hostname: os.hostname(),
+    platform: os.platform(),
+    primaryMacAddress: readPrimaryMacAddress()
+  };
+}
+function resetCachedDeviceId() {
+  cachedDeviceId = null;
+}
+export {
+  getDeviceFingerprint,
+  getDeviceId,
+  resetCachedDeviceId
+};
+//# sourceMappingURL=device-identity.js.map

package/dist/lifeops/device-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/device-identity.ts"],"sourcesContent":["import crypto from \"node:crypto\";\nimport fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { resolveStateDir } from \"@elizaos/agent\";\n\nconst ENV_KEYS = [\"ELIZA_DEVICE_ID\", \"ELIZA_DEVICE_ID\"] as const;\nconst CACHE_FILE_NAME = \"device-id\";\nconst RANDOM_SUFFIX_BYTES = 3; // 3 bytes -> 6 hex chars\n\nexport interface DeviceFingerprint {\n  id: string;\n  hostname: string;\n  platform: NodeJS.Platform;\n  primaryMacAddress: string | null;\n}\n\nlet cachedDeviceId: string | null = null;\n\nfunction readEnvDeviceId(env: NodeJS.ProcessEnv): string | null {\n  for (const key of ENV_KEYS) {\n    const raw = env[key];\n    if (typeof raw !== \"string\") continue;\n    const trimmed = raw.trim();\n    if (trimmed.length > 0) {\n      return trimmed;\n    }\n  }\n  return null;\n}\n\nfunction readFileDeviceId(filePath: string): string | null {\n  if (!fs.existsSync(filePath)) {\n    return null;\n  }\n  const contents = fs.readFileSync(filePath, \"utf8\").trim();\n  return contents.length > 0 ? contents : null;\n}\n\nfunction sanitizeHostname(hostname: string): string {\n  const cleaned = hostname.trim().replace(/[^A-Za-z0-9._-]/g, \"-\");\n  return cleaned.length > 0 ? cleaned : \"host\";\n}\n\nfunction generateDeviceId(hostname: string): string {\n  const suffix = crypto.randomBytes(RANDOM_SUFFIX_BYTES).toString(\"hex\");\n  return `${sanitizeHostname(hostname)}-${suffix}`;\n}\n\nfunction persistDeviceId(filePath: string, deviceId: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true });\n  fs.writeFileSync(filePath, deviceId, \"utf8\");\n}\n\nfunction deviceIdCachePath(env: NodeJS.ProcessEnv): string {\n  return path.join(resolveStateDir(env), CACHE_FILE_NAME);\n}\n\n/**\n * Returns a stable, process-lifetime device identifier.\n *\n * Resolution order:\n *   1. `ELIZA_DEVICE_ID` env var\n *   2. `ELIZA_DEVICE_ID` env var\n *   3. Cached value at `<state-dir>/device-id`\n *   4. Newly generated `<hostname>-<6-char-hex>`, persisted to that file\n *\n * The result is memoized for the lifetime of the process so repeated calls\n * are cheap and guaranteed to return the same value.\n */\nexport function getDeviceId(env: NodeJS.ProcessEnv = process.env): string {\n  if (cachedDeviceId !== null) {\n    return cachedDeviceId;\n  }\n\n  const fromEnv = readEnvDeviceId(env);\n  if (fromEnv !== null) {\n    cachedDeviceId = fromEnv;\n    return cachedDeviceId;\n  }\n\n  const cachePath = deviceIdCachePath(env);\n  const fromFile = readFileDeviceId(cachePath);\n  if (fromFile !== null) {\n    cachedDeviceId = fromFile;\n    return cachedDeviceId;\n  }\n\n  const generated = generateDeviceId(os.hostname());\n  persistDeviceId(cachePath, generated);\n  cachedDeviceId = generated;\n  return cachedDeviceId;\n}\n\nfunction readPrimaryMacAddress(): string | null {\n  const interfaces = os.networkInterfaces();\n  for (const name of Object.keys(interfaces)) {\n    const addrs = interfaces[name];\n    if (!addrs) continue;\n    for (const addr of addrs) {\n      if (addr.internal) continue;\n      const mac = addr.mac;\n      if (typeof mac !== \"string\") continue;\n      if (mac.length === 0 || mac === \"00:00:00:00:00:00\") continue;\n      return mac;\n    }\n  }\n  return null;\n}\n\n/**\n * Returns a coarse fingerprint of the current device suitable for logging\n * and presence-signal aggregation. Does not include any user-identifying\n * data beyond what `os.hostname()` / `os.networkInterfaces()` already expose.\n */\nexport function getDeviceFingerprint(\n  env: NodeJS.ProcessEnv = process.env,\n): DeviceFingerprint {\n  return {\n    id: getDeviceId(env),\n    hostname: os.hostname(),\n    platform: os.platform(),\n    primaryMacAddress: readPrimaryMacAddress(),\n  };\n}\n\n/**\n * Test-only: drops the in-memory cache so the next `getDeviceId` call\n * re-runs the env -> file -> generate resolution.\n */\nexport function resetCachedDeviceId(): void {\n  cachedDeviceId = null;\n}\n"],"mappings":"AAAA,OAAO,YAAY;AACnB,OAAO,QAAQ;AACf,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,uBAAuB;AAEhC,MAAM,WAAW,CAAC,mBAAmB,iBAAiB;AACtD,MAAM,kBAAkB;AACxB,MAAM,sBAAsB;AAS5B,IAAI,iBAAgC;AAEpC,SAAS,gBAAgB,KAAuC;AAC9D,aAAW,OAAO,UAAU;AAC1B,UAAM,MAAM,IAAI,GAAG;AACnB,QAAI,OAAO,QAAQ,SAAU;AAC7B,UAAM,UAAU,IAAI,KAAK;AACzB,QAAI,QAAQ,SAAS,GAAG;AACtB,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,UAAiC;AACzD,MAAI,CAAC,GAAG,WAAW,QAAQ,GAAG;AAC5B,WAAO;AAAA,EACT;AACA,QAAM,WAAW,GAAG,aAAa,UAAU,MAAM,EAAE,KAAK;AACxD,SAAO,SAAS,SAAS,IAAI,WAAW;AAC1C;AAEA,SAAS,iBAAiB,UAA0B;AAClD,QAAM,UAAU,SAAS,KAAK,EAAE,QAAQ,oBAAoB,GAAG;AAC/D,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;AAEA,SAAS,iBAAiB,UAA0B;AAClD,QAAM,SAAS,OAAO,YAAY,mBAAmB,EAAE,SAAS,KAAK;AACrE,SAAO,GAAG,iBAAiB,QAAQ,CAAC,IAAI,MAAM;AAChD;AAEA,SAAS,gBAAgB,UAAkB,UAAwB;AACjE,KAAG,UAAU,KAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AACxD,KAAG,cAAc,UAAU,UAAU,MAAM;AAC7C;AAEA,SAAS,kBAAkB,KAAgC;AACzD,SAAO,KAAK,KAAK,gBAAgB,GAAG,GAAG,eAAe;AACxD;AAcO,SAAS,YAAY,MAAyB,QAAQ,KAAa;AACxE,MAAI,mBAAmB,MAAM;AAC3B,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,gBAAgB,GAAG;AACnC,MAAI,YAAY,MAAM;AACpB,qBAAiB;AACjB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,kBAAkB,GAAG;AACvC,QAAM,WAAW,iBAAiB,SAAS;AAC3C,MAAI,aAAa,MAAM;AACrB,qBAAiB;AACjB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,iBAAiB,GAAG,SAAS,CAAC;AAChD,kBAAgB,WAAW,SAAS;AACpC,mBAAiB;AACjB,SAAO;AACT;AAEA,SAAS,wBAAuC;AAC9C,QAAM,aAAa,GAAG,kBAAkB;AACxC,aAAW,QAAQ,OAAO,KAAK,UAAU,GAAG;AAC1C,UAAM,QAAQ,WAAW,IAAI;AAC7B,QAAI,CAAC,MAAO;AACZ,eAAW,QAAQ,OAAO;AACxB,UAAI,KAAK,SAAU;AACnB,YAAM,MAAM,KAAK;AACjB,UAAI,OAAO,QAAQ,SAAU;AAC7B,UAAI,IAAI,WAAW,KAAK,QAAQ,oBAAqB;AACrD,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,qBACd,MAAyB,QAAQ,KACd;AACnB,SAAO;AAAA,IACL,IAAI,YAAY,GAAG;AAAA,IACnB,UAAU,GAAG,SAAS;AAAA,IACtB,UAAU,GAAG,SAAS;AAAA,IACtB,mBAAmB,sBAAsB;AAAA,EAC3C;AACF;AAMO,SAAS,sBAA4B;AAC1C,mBAAiB;AACnB;","names":[]}