@elizaos/agent 2.0.0-alpha.173 → 2.0.0-alpha.192

package/apps/app-lifeops/src/activity-profile/service.js

@@ -0,0 +1,229 @@
+import { logger } from "@elizaos/core";
+import { resolveDefaultTimeZone } from "../lifeops/defaults.js";
+import { LifeOpsScreenContextSampler, } from "../lifeops/screen-context.js";
+import { LifeOpsService } from "../lifeops/service.js";
+export { resolveOwnerEntityId } from "@elizaos/agent/runtime/owner-entity";
+import { analyzeMessages, enrichWithCalendar, resolveCurrentActivityState, SUSTAINED_INACTIVITY_GAP_MS, } from "./analyzer.js";
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+// ── Constants ─────────────────────────────────────────
+const PROFILE_MAX_AGE_MS = 60 * 60 * 1000; // 60 min full rebuild threshold
+const MESSAGES_WINDOW_DAYS = 7;
+const MESSAGES_LIMIT = 500;
+const MAX_ROOMS = 50;
+const ACTIVITY_SIGNALS_WINDOW_LIMIT = 500;
+const CURRENT_ACTIVITY_SIGNAL_LIMIT = 32;
+let screenContextSampler = null;
+export function setScreenContextSamplerForTesting(sampler) {
+    screenContextSampler = sampler;
+}
+function getScreenContextSampler() {
+    if (!screenContextSampler) {
+        screenContextSampler = new LifeOpsScreenContextSampler();
+    }
+    return screenContextSampler;
+}
+async function sampleScreenContext(currentTime) {
+    return await getScreenContextSampler().sample(currentTime.getTime());
+}
+function mapActivitySignalRecord(signal) {
+    return {
+        source: signal.source,
+        platform: signal.platform,
+        state: signal.state,
+        observedAt: Date.parse(signal.observedAt),
+        idleState: signal.idleState,
+        idleTimeSeconds: signal.idleTimeSeconds,
+        onBattery: signal.onBattery,
+        health: signal.health,
+        metadata: signal.metadata,
+    };
+}
+async function loadWindowActivitySignals(runtime, currentTime) {
+    const lifeOpsService = new LifeOpsService(runtime);
+    const sinceAt = new Date(currentTime.getTime() - MESSAGES_WINDOW_DAYS * 24 * 60 * 60 * 1000).toISOString();
+    const signals = await lifeOpsService.listActivitySignals({
+        sinceAt,
+        limit: ACTIVITY_SIGNALS_WINDOW_LIMIT,
+    });
+    return signals
+        .map(mapActivitySignalRecord)
+        .filter((signal) => Number.isFinite(signal.observedAt));
+}
+async function loadRecentActivitySignals(runtime) {
+    const lifeOpsService = new LifeOpsService(runtime);
+    const signals = await lifeOpsService.listActivitySignals({
+        limit: CURRENT_ACTIVITY_SIGNAL_LIMIT,
+    });
+    return signals
+        .map(mapActivitySignalRecord)
+        .filter((signal) => Number.isFinite(signal.observedAt));
+}
+function mergeScreenContext(profile, screenContext, now) {
+    const updatedProfile = {
+        ...profile,
+        screenContextFocus: screenContext?.focus ?? null,
+        screenContextSource: screenContext?.source ?? null,
+        screenContextSampledAt: screenContext?.sampledAtMs ?? null,
+        screenContextConfidence: screenContext?.confidence ?? null,
+        screenContextBusy: screenContext?.busy ?? false,
+        screenContextAvailable: screenContext?.available ?? false,
+        screenContextStale: screenContext?.stale ?? false,
+    };
+    const activityState = resolveCurrentActivityState(updatedProfile, now);
+    return {
+        ...updatedProfile,
+        ...activityState,
+        effectiveDayKey: activityState.effectiveDayKey,
+    };
+}
+// ── Profile building ──────────────────────────────────
+export async function buildActivityProfile(runtime, ownerEntityId, timezone, now) {
+    const tz = timezone ?? resolveDefaultTimeZone();
+    const currentTime = now ?? new Date();
+    const activitySignals = await loadWindowActivitySignals(runtime, currentTime);
+    // 1. Get all rooms the owner participates in
+    const roomIds = await runtime.getRoomsForParticipant(ownerEntityId);
+    const limitedRoomIds = roomIds.slice(0, MAX_ROOMS);
+    // 2. Build room → source map
+    const roomSourceMap = new Map();
+    await Promise.all(limitedRoomIds.map(async (roomId) => {
+        try {
+            const room = await runtime.getRoom(roomId);
+            if (room?.source) {
+                roomSourceMap.set(roomId, room.source);
+            }
+        }
+        catch (cause) {
+            // Room read can fail for deleted/migrated rooms during batch fetch.
+            // Missing source is non-fatal for the profile build; log so repeated
+            // misses surface in telemetry.
+            logger.debug({ err: cause, roomId }, "[ActivityProfile] room source lookup failed");
+        }
+    }));
+    // 3. Fetch messages
+    const messages = [];
+    if (limitedRoomIds.length > 0) {
+        const memories = await runtime.getMemoriesByRoomIds({
+            tableName: "messages",
+            roomIds: limitedRoomIds,
+            limit: MESSAGES_LIMIT,
+        });
+        for (const mem of memories) {
+            messages.push({
+                entityId: mem.entityId,
+                roomId: mem.roomId,
+                createdAt: mem.createdAt ?? 0,
+            });
+        }
+    }
+    // 4. Analyze messages
+    const baseProfile = analyzeMessages(messages, roomSourceMap, ownerEntityId, tz, MESSAGES_WINDOW_DAYS, activitySignals, currentTime);
+    // 5. Enrich with calendar if available
+    let calendarEvents = [];
+    try {
+        const lifeOpsService = new LifeOpsService(runtime);
+        const feed = await lifeOpsService.getCalendarFeed(new URL("http://localhost/api/lifeops/calendar"), {}, currentTime);
+        calendarEvents = feed.events.map((e) => ({
+            startAt: e.startAt,
+            endAt: e.endAt,
+            isAllDay: e.isAllDay,
+        }));
+    }
+    catch (err) {
+        logger.debug({
+            boundary: "activity_profile",
+            operation: "calendar_enrichment",
+            err: err instanceof Error ? err : undefined,
+        }, "[activity-profile] Calendar not available for profile enrichment; proceeding without calendar data.");
+    }
+    const withCalendar = enrichWithCalendar(baseProfile, calendarEvents, tz);
+    const screenContext = await sampleScreenContext(currentTime);
+    return mergeScreenContext(withCalendar, screenContext, currentTime);
+}
+// ── Lightweight current-state refresh ─────────────────
+export async function refreshCurrentState(runtime, ownerEntityId, profile, now) {
+    const currentTime = now ?? new Date();
+    const roomIds = await runtime.getRoomsForParticipant(ownerEntityId);
+    const limitedRoomIds = roomIds.slice(0, MAX_ROOMS);
+    const screenContext = await sampleScreenContext(currentTime);
+    const activitySignals = await loadRecentActivitySignals(runtime);
+    const roomSourceMap = new Map();
+    if (limitedRoomIds.length > 0) {
+        await Promise.all(limitedRoomIds.map(async (roomId) => {
+            try {
+                const room = await runtime.getRoom(roomId);
+                if (room?.source) {
+                    roomSourceMap.set(roomId, room.source);
+                }
+            }
+            catch (cause) {
+                logger.debug({ err: cause, roomId }, "[ActivityProfile] room source lookup failed during refresh");
+            }
+        }));
+    }
+    let lastSeenAt = profile.lastSeenAt;
+    let lastSeenPlatform = profile.lastSeenPlatform;
+    if (limitedRoomIds.length > 0) {
+        const memories = await runtime.getMemoriesByRoomIds({
+            tableName: "messages",
+            roomIds: limitedRoomIds,
+            limit: 10,
+        });
+        for (const memory of memories) {
+            const createdAt = memory.createdAt ?? 0;
+            if (createdAt > currentTime.getTime()) {
+                continue;
+            }
+            const source = roomSourceMap.get(memory.roomId) ?? "unknown";
+            const isOwnerMessage = memory.entityId === ownerEntityId;
+            const isClientChatSignal = source === "client_chat";
+            if (!isOwnerMessage && !isClientChatSignal) {
+                continue;
+            }
+            if (createdAt >= lastSeenAt) {
+                lastSeenAt = createdAt;
+                lastSeenPlatform = isClientChatSignal ? "client_chat" : source;
+            }
+        }
+    }
+    for (const signal of activitySignals) {
+        if (signal.state !== "active" ||
+            signal.observedAt > currentTime.getTime()) {
+            continue;
+        }
+        if (signal.observedAt >= lastSeenAt) {
+            lastSeenAt = signal.observedAt;
+            lastSeenPlatform = signal.platform;
+        }
+    }
+    return mergeScreenContext({
+        ...profile,
+        lastSeenAt,
+        lastSeenPlatform,
+        sustainedInactivityThresholdMinutes: profile.sustainedInactivityThresholdMinutes ||
+            SUSTAINED_INACTIVITY_GAP_MS / 60_000,
+    }, screenContext, currentTime);
+}
+// ── Metadata persistence helpers ──────────────────────
+// Re-export from dedicated module to preserve public API while breaking the
+// circular dependency between activity-profile/service and lifeops/service.
+export { readProfileFromMetadata } from "./profile-metadata.js";
+export function readFiredLogFromMetadata(metadata, todayDateStr) {
+    if (!metadata?.firedActionsLog)
+        return null;
+    const log = metadata.firedActionsLog;
+    if (!isRecord(log))
+        return null;
+    if (typeof log.date !== "string" || log.date !== todayDateStr)
+        return null;
+    if (!Array.isArray(log.nudgedOccurrenceIds))
+        return null;
+    return log;
+}
+export function profileNeedsRebuild(profile, now) {
+    if (!profile)
+        return true;
+    return now.getTime() - profile.analyzedAt > PROFILE_MAX_AGE_MS;
+}

package/apps/app-lifeops/src/activity-profile/types.d.ts.map

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

package/apps/app-lifeops/src/app-blocker/access.d.ts

@@ -0,0 +1,8 @@
+import { type IAgentRuntime, type Memory } from "@elizaos/core";
+export declare const APP_BLOCKER_ACCESS_ERROR = "App blocking is restricted to OWNER and ADMIN users.";
+export declare function getAppBlockerAccess(runtime: IAgentRuntime, message: Memory): Promise<{
+    allowed: boolean;
+    role: string | null;
+    reason?: string;
+}>;
+//# sourceMappingURL=access.d.ts.map

package/apps/app-lifeops/src/app-blocker/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/app-blocker/access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAGxE,eAAO,MAAM,wBAAwB,yDACmB,CAAC;AAEzD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CA4BD"}

package/apps/app-lifeops/src/app-blocker/access.js

@@ -0,0 +1,28 @@
+import { logger } from "@elizaos/core";
+import { checkSenderRole } from "../website-blocker/roles.js";
+export const APP_BLOCKER_ACCESS_ERROR = "App blocking is restricted to OWNER and ADMIN users.";
+export async function getAppBlockerAccess(runtime, message) {
+    let roleCheck;
+    try {
+        roleCheck = await checkSenderRole(runtime, message);
+    }
+    catch (err) {
+        logger.error({ err, roomId: message.roomId, entityId: message.entityId }, "[app-blocker] Role check failed — world/room/entity setup is broken");
+        return {
+            allowed: false,
+            role: null,
+            reason: `App blocking is unavailable: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (!roleCheck.isAdmin) {
+        return {
+            allowed: false,
+            role: roleCheck.role,
+            reason: APP_BLOCKER_ACCESS_ERROR,
+        };
+    }
+    return {
+        allowed: true,
+        role: roleCheck.role,
+    };
+}

package/apps/app-lifeops/src/app-blocker/engine.d.ts

@@ -0,0 +1,10 @@
+import { type AppBlockerPermissionResult, type AppBlockerStatus, type BlockAppsOptions, type BlockAppsResult, type InstalledApp, type SelectAppsResult, type UnblockAppsResult } from "@elizaos/app-core/bridge/native-plugins";
+export declare function getAppBlockerStatus(): Promise<AppBlockerStatus>;
+export declare function getCachedAppBlockerStatus(): Promise<AppBlockerStatus>;
+export declare function getAppBlockerPermissionState(): Promise<AppBlockerPermissionResult>;
+export declare function requestAppBlockerPermission(): Promise<AppBlockerPermissionResult>;
+export declare function getInstalledApps(): Promise<InstalledApp[]>;
+export declare function selectAppsForBlocking(): Promise<SelectAppsResult>;
+export declare function startAppBlock(options: BlockAppsOptions): Promise<BlockAppsResult>;
+export declare function stopAppBlock(): Promise<UnblockAppsResult>;
+//# sourceMappingURL=engine.d.ts.map

package/apps/app-lifeops/src/app-blocker/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/app-blocker/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,yCAAyC,CAAC;AAejD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAErE;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAQ3E;AAED,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAExF;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAEvF;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAGhE;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAEvE;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAG/D"}

package/apps/app-lifeops/src/app-blocker/engine.js

@@ -0,0 +1,43 @@
+import { getAppBlockerPlugin, } from "@elizaos/app-core/bridge/native-plugins";
+const STATUS_CACHE_TTL_MS = 5_000;
+let statusCache = null;
+function getPlugin() {
+    const plugin = getAppBlockerPlugin();
+    if (!plugin || typeof plugin.getStatus !== "function") {
+        throw new Error("[app-blocker] AppBlocker Capacitor plugin is not available. App blocking is mobile-only.");
+    }
+    return plugin;
+}
+export async function getAppBlockerStatus() {
+    return getPlugin().getStatus();
+}
+export async function getCachedAppBlockerStatus() {
+    const now = Date.now();
+    if (statusCache && statusCache.expiresAt > now) {
+        return statusCache.value;
+    }
+    const status = await getAppBlockerStatus();
+    statusCache = { expiresAt: now + STATUS_CACHE_TTL_MS, value: status };
+    return status;
+}
+export async function getAppBlockerPermissionState() {
+    return getPlugin().checkPermissions();
+}
+export async function requestAppBlockerPermission() {
+    return getPlugin().requestPermissions();
+}
+export async function getInstalledApps() {
+    const result = await getPlugin().getInstalledApps();
+    return result.apps;
+}
+export async function selectAppsForBlocking() {
+    return getPlugin().selectApps();
+}
+export async function startAppBlock(options) {
+    statusCache = null;
+    return getPlugin().blockApps(options);
+}
+export async function stopAppBlock() {
+    statusCache = null;
+    return getPlugin().unblockApps();
+}

package/apps/app-lifeops/src/dossier/action.d.ts

@@ -0,0 +1,9 @@
+/**
+ * T7f — GENERATE_DOSSIER action.
+ *
+ * Thin transport adapter that resolves dependencies from the runtime and
+ * delegates to {@link DossierService}. The action owns no business logic.
+ */
+import type { Action } from "@elizaos/core";
+export declare const generateDossierAction: Action;
+//# sourceMappingURL=action.d.ts.map

package/apps/app-lifeops/src/dossier/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/dossier/action.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAgBvB,eAAO,MAAM,qBAAqB,EAAE,MA2FnC,CAAC"}

package/apps/app-lifeops/src/dossier/action.js

@@ -0,0 +1,87 @@
+/**
+ * T7f — GENERATE_DOSSIER action.
+ *
+ * Thin transport adapter that resolves dependencies from the runtime and
+ * delegates to {@link DossierService}. The action owns no business logic.
+ */
+import { hasOwnerAccess } from "@elizaos/agent/security/access";
+import { LifeOpsService } from "../lifeops/service.js";
+import { DossierService, getRelationshipsServiceLike, } from "./service.js";
+export const generateDossierAction = {
+    name: "GENERATE_DOSSIER",
+    similes: [
+        "MEETING_DOSSIER",
+        "PREMEETING_BRIEFING",
+        "BRIEF_ME_FOR_MEETING",
+        "PREPARE_FOR_MEETING",
+    ],
+    description: "Generate a structured pre-meeting dossier (attendee context, recent email threads, prior dossiers, meeting-link health) for an upcoming calendar event.",
+    validate: async (runtime, message) => hasOwnerAccess(runtime, message),
+    handler: async (runtime, _message, _state, options) => {
+        const params = (options?.parameters ??
+            {});
+        const needle = (params.eventId && params.eventId.trim()) ||
+            (params.eventTitleFuzzy && params.eventTitleFuzzy.trim()) ||
+            "";
+        if (!needle) {
+            return {
+                text: "GENERATE_DOSSIER requires eventId or eventTitleFuzzy.",
+                success: false,
+                values: { success: false, error: "MISSING_EVENT_REF" },
+                data: { actionName: "GENERATE_DOSSIER" },
+            };
+        }
+        const lifeOps = new LifeOpsService(runtime);
+        const calendar = {
+            getCalendarFeed: lifeOps.getCalendarFeed.bind(lifeOps),
+        };
+        const relationships = getRelationshipsServiceLike(runtime);
+        const service = new DossierService(runtime, {
+            calendar,
+            relationships,
+            gmail: null,
+        });
+        const result = await service.generateDossier(needle, params.windowDays);
+        return {
+            text: result.text,
+            success: true,
+            values: { success: true, eventId: result.data.eventId },
+            data: { actionName: "GENERATE_DOSSIER", ...result },
+        };
+    },
+    parameters: [
+        {
+            name: "eventId",
+            description: "Calendar event id. Mutually optional with eventTitleFuzzy.",
+            required: false,
+            schema: { type: "string" },
+        },
+        {
+            name: "eventTitleFuzzy",
+            description: "Fuzzy title match used when eventId is unknown (e.g. 'my 3pm').",
+            required: false,
+            schema: { type: "string" },
+        },
+        {
+            name: "windowDays",
+            description: "Context window in days (default 7).",
+            required: false,
+            schema: { type: "number" },
+        },
+    ],
+    examples: [
+        [
+            {
+                name: "{{name1}}",
+                content: { text: "Brief me for my 3pm meeting" },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: "# Meeting Dossier — 3pm with Alex\n...",
+                    action: "GENERATE_DOSSIER",
+                },
+            },
+        ],
+    ],
+};

package/apps/app-lifeops/src/dossier/service.d.ts

@@ -0,0 +1,145 @@
+/**
+ * T7f — Meeting dossier generator (plan §6.7).
+ *
+ * DossierService builds a briefing payload for an upcoming calendar event.
+ * It collects:
+ *   1. The resolved calendar event (by id or fuzzy title match).
+ *   2. Attendee enrichment via the RelationshipsService (structural).
+ *   3. Recent Gmail threads for attendees whose emails match (structural).
+ *   4. Prior dossiers for the same attendees (memories, tableName=reminders,
+ *      content.type === "meeting_dossier").
+ *   5. A well-formedness check on any meeting link (not a network fetch).
+ *
+ * Every external dependency is optional and the service degrades gracefully
+ * to an empty list when the dependency is not registered. The returned
+ * payload carries an explicit `degraded` map so downstream consumers can
+ * reason about partial data — no silent fallbacks that fake completeness.
+ */
+import type { IAgentRuntime, UUID } from "@elizaos/core";
+import type { LifeOpsCalendarFeed } from "@elizaos/shared/contracts/lifeops";
+export interface DossierAttendeeSummary {
+    email: string | null;
+    displayName: string | null;
+    contactId: UUID | null;
+    categories: string[];
+    tags: string[];
+    lastInteractionAt: string | null;
+    cadenceHealth: "on-track" | "due" | "overdue" | "never-contacted" | "no-goal" | null;
+    recentGmailThreads: DossierGmailThreadRef[];
+    priorDossierMemoryIds: UUID[];
+}
+export interface DossierGmailThreadRef {
+    threadId: string;
+    subject: string | null;
+    snippet: string | null;
+    lastMessageAt: string | null;
+}
+export interface DossierMeetingLinkCheck {
+    url: string;
+    wellFormed: boolean;
+    reason?: string;
+}
+export interface DossierPayload {
+    eventId: string;
+    eventTitle: string;
+    eventStartAt: string;
+    eventEndAt: string;
+    windowDays: number;
+    attendees: DossierAttendeeSummary[];
+    meetingLink: DossierMeetingLinkCheck | null;
+    priorDossiersCount: number;
+    degraded: {
+        relationships: boolean;
+        gmail: boolean;
+        memories: boolean;
+        /**
+         * True when we tried to resolve cross-platform identity clusters for
+         * attendees but the service was unavailable or threw. Consumers can
+         * surface "identity dedup not applied — list may include duplicates
+         * of the same person across platforms".
+         */
+        identityCluster: boolean;
+    };
+    generatedAt: string;
+}
+export interface DossierResult {
+    text: string;
+    data: DossierPayload;
+}
+/**
+ * Structural shape we depend on from the RelationshipsService. Kept local so
+ * this service degrades cleanly when the service isn't registered and so we
+ * don't create a circular dependency on `@elizaos/plugin-agent-skills`.
+ */
+export interface RelationshipsServiceLike {
+    findByHandle(platform: string, identifier: string): Promise<{
+        entityId: UUID;
+        categories: string[];
+        tags: string[];
+        customFields: Record<string, unknown>;
+        lastInteractionAt?: string;
+    } | null>;
+    getRelationshipProgress(contactId: UUID): Promise<{
+        contactId: UUID;
+        cadenceHealth: "on-track" | "due" | "overdue" | "never-contacted" | "no-goal";
+        lastInteractionAt: string | null;
+        daysSinceInteraction: number | null;
+        targetCadenceDays: number | null;
+    } | null>;
+    /** WS3: cross-platform identity-cluster lookup. Optional: older runtimes
+     * may not expose it. When absent, dedup degrades to email-only. */
+    resolvePrimaryEntityId?(entityId: UUID): Promise<UUID>;
+}
+/** Structural shape for a calendar feed provider. */
+export interface CalendarFeedProviderLike {
+    getCalendarFeed(requestUrl: URL, request: {
+        timeMin?: string;
+        timeMax?: string;
+    }, now?: Date): Promise<LifeOpsCalendarFeed>;
+}
+/** Structural shape for an optional Gmail search provider. */
+export interface GmailSearchProviderLike {
+    searchThreadsByParticipant(input: {
+        email: string;
+        windowDays: number;
+        maxResults?: number;
+    }): Promise<DossierGmailThreadRef[]>;
+}
+export interface DossierServiceDeps {
+    relationships?: RelationshipsServiceLike | null;
+    calendar: CalendarFeedProviderLike;
+    gmail?: GmailSearchProviderLike | null;
+}
+export interface GenerateDossierInput {
+    eventId?: string;
+    eventTitleFuzzy?: string;
+    windowDays?: number;
+}
+export declare const DOSSIER_MEMORY_TABLE: "reminders";
+export declare const DOSSIER_MEMORY_TYPE: "meeting_dossier";
+export declare class DossierService {
+    private readonly runtime;
+    private readonly deps;
+    constructor(runtime: IAgentRuntime, deps: DossierServiceDeps);
+    generateDossier(eventIdOrTitleFuzzy: string, windowDays?: number): Promise<DossierResult>;
+    private resolveEvent;
+    private buildAttendeeSummary;
+    /**
+     * Collapse attendees that belong to the same cross-platform identity
+     * cluster. Two attendees with different emails may actually be the same
+     * person (jill@work.com and jill.personal@gmail.com linked via discord
+     * handle). Without this dedup, the dossier double-counts history and
+     * presents the same person twice.
+     *
+     * Only attendees with a resolved contactId participate — unknown
+     * attendees stay as-is.
+     *
+     * If the relationships service does not expose resolvePrimaryEntityId
+     * we leave the list unchanged and flag degraded.identityCluster so the
+     * consumer can tell the dedup was skipped.
+     */
+    private dedupeByIdentityCluster;
+    private findPriorDossierMemoryIds;
+}
+export declare function getRelationshipsServiceLike(runtime: IAgentRuntime): RelationshipsServiceLike | null;
+//# sourceMappingURL=service.d.ts.map

package/apps/app-lifeops/src/dossier/service.d.ts.map

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