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

package/dist/lifeops/cross-channel-search.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Cross-channel search (WS1).
+ *
+ * Fans a single semantic query across:
+ *   - Gmail (via LifeOpsService.getGmailSearch)
+ *   - Agent memory (runtime.searchMemories with embedding)
+ *   - WS3 RelationshipsGraphService.getMemoriesForCluster (when a personRef
+ *     resolves to a canonical cluster)
+ *
+ * Connectors that lack first-class search emit a typed `unsupported`
+ * result. We never fabricate hits.
+ *
+ * Architecture note: this file is the orchestrator. The action
+ * (search-across-channels.ts) handles LLM param extraction and result
+ * formatting. The provider (cross-channel-context.ts) consumes
+ * runCrossChannelSearch() to inject context for named persons/topics.
+ */
+import type { IAgentRuntime, UUID } from "@elizaos/core";
+type RelationshipsPersonSummary = {
+    groupId: UUID;
+    primaryEntityId: UUID;
+    memberEntityIds: UUID[];
+    displayName: string;
+    aliases: string[];
+    platforms: string[];
+    identities: unknown[];
+    emails: string[];
+    phones: string[];
+    websites: string[];
+    preferredCommunicationChannel: string | null;
+    categories: string[];
+    tags: string[];
+    factCount: number;
+    relationshipCount: number;
+    isOwner: boolean;
+    profiles: unknown[];
+    lastInteractionAt?: string;
+};
+export declare const CROSS_CHANNEL_SEARCH_CHANNELS: readonly ["gmail", "memory", "telegram", "discord", "imessage", "whatsapp", "signal", "x", "x-dm", "calendly", "calendar"];
+export type CrossChannelSearchChannel = (typeof CROSS_CHANNEL_SEARCH_CHANNELS)[number];
+export type CrossChannelSearchTimeWindow = {
+    /** ISO timestamp lower bound (inclusive). */
+    startIso?: string;
+    /** ISO timestamp upper bound (inclusive). */
+    endIso?: string;
+};
+export type CrossChannelSearchPersonRef = {
+    /** Canonical cluster primary entity id (preferred). */
+    primaryEntityId?: UUID;
+    /** Free-form display name from LLM extraction (fallback). */
+    displayName?: string;
+};
+export type CrossChannelSearchQuery = {
+    /** Free-form semantic query — required, no fallback default. */
+    query: string;
+    /** Optional named person to focus the search on. */
+    personRef?: CrossChannelSearchPersonRef;
+    /** Optional ISO time window to bound results. */
+    timeWindow?: CrossChannelSearchTimeWindow;
+    /** Optional explicit channel allowlist; default = all known channels. */
+    channels?: CrossChannelSearchChannel[];
+    /** Optional worldId scope for memory search. */
+    worldId?: UUID;
+    /** Per-channel hit cap (default 10). */
+    limit?: number;
+};
+export type CrossChannelSearchHit = {
+    channel: CrossChannelSearchChannel;
+    /** Stable id for dedup + citation. */
+    id: string;
+    /** Source room id for memory hits, gmail message id for gmail, etc. */
+    sourceRef: string;
+    /** ISO timestamp. */
+    timestamp: string;
+    /** Sender / from. */
+    speaker: string;
+    /** Free-form text body (already trimmed). */
+    text: string;
+    /** Optional subject (gmail). */
+    subject?: string;
+    /** Provenance for the citation. */
+    citation: {
+        platform: string;
+        label: string;
+        url?: string;
+    };
+};
+export type CrossChannelSearchUnsupported = {
+    channel: CrossChannelSearchChannel;
+    reason: string;
+};
+export type CrossChannelSearchDegraded = {
+    channel: CrossChannelSearchChannel;
+    reason: string;
+};
+export type CrossChannelSearchResult = {
+    query: string;
+    hits: CrossChannelSearchHit[];
+    unsupported: CrossChannelSearchUnsupported[];
+    degraded: CrossChannelSearchDegraded[];
+    /** Channels that produced at least one hit. */
+    channelsWithHits: CrossChannelSearchChannel[];
+    /** Resolved canonical person, when available from WS3. */
+    resolvedPerson: RelationshipsPersonSummary | null;
+};
+export declare function runCrossChannelSearch(runtime: IAgentRuntime, query: CrossChannelSearchQuery): Promise<CrossChannelSearchResult>;
+export {};
+//# sourceMappingURL=cross-channel-search.d.ts.map

package/dist/lifeops/cross-channel-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-channel-search.d.ts","sourceRoot":"","sources":["../../src/lifeops/cross-channel-search.ts"],"names":[],"mappings":"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"}