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

package/dist/followup/followup-tracker.js

@@ -0,0 +1,311 @@
+import {
+  createUniqueUuid,
+  logger,
+  MemoryType,
+  stringToUuid
+} from "@elizaos/core";
+import { loadLifeOpsAppState } from "../lifeops/app-state.js";
+import {
+  BackgroundPlannerError,
+  planJob
+} from "../lifeops/background-planner.js";
+import { enqueueIfSensitive } from "../lifeops/background-planner-dispatch.js";
+function isRelationshipsServiceLike(service) {
+  if (!service || typeof service !== "object") return false;
+  const candidate = service;
+  return typeof candidate.searchContacts === "function" && typeof candidate.getContact === "function" && typeof candidate.updateContact === "function";
+}
+const FOLLOWUP_TRACKER_TASK_NAME = "FOLLOWUP_TRACKER_RECONCILE";
+const FOLLOWUP_TRACKER_TASK_TAGS = [
+  "queue",
+  "repeat",
+  "relationships",
+  "followup-tracker"
+];
+const FOLLOWUP_TRACKER_INTERVAL_MS = 60 * 60 * 1e3;
+const FOLLOWUP_DEFAULT_THRESHOLD_DAYS = 30;
+const FOLLOWUP_MEMORY_TABLE = "reminders";
+const DAY_MS = 24 * 60 * 60 * 1e3;
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function resolveTrackerNowMs(options = {}) {
+  const raw = options.now;
+  if (raw instanceof Date) {
+    return raw.getTime();
+  }
+  if (typeof raw === "number" && Number.isFinite(raw)) {
+    return raw;
+  }
+  if (typeof raw === "string" && raw.trim().length > 0) {
+    const parsed = new Date(raw).getTime();
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
+  }
+  return Date.now();
+}
+function isFollowupTrackerTask(task) {
+  return task.name === FOLLOWUP_TRACKER_TASK_NAME;
+}
+function buildFollowupTrackerMetadata(previous) {
+  const metadata = {
+    ...isRecord(previous) ? previous : {},
+    updateInterval: FOLLOWUP_TRACKER_INTERVAL_MS
+  };
+  return metadata;
+}
+function getRelationshipsServiceLike(runtime) {
+  const service = runtime.getService("relationships");
+  if (!service) return null;
+  return isRelationshipsServiceLike(service) ? service : null;
+}
+let degradedLogged = false;
+function getNumberField(contact, key) {
+  const value = contact.customFields[key];
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return null;
+}
+function getStringField(contact, key) {
+  const value = contact.customFields[key];
+  return typeof value === "string" && value.trim().length > 0 ? value : null;
+}
+function resolveLastContactedAtMs(contact) {
+  const raw = getStringField(contact, "lastContactedAt") ?? getStringField(contact, "lastInteractionAt");
+  if (!raw) return null;
+  const ms = new Date(raw).getTime();
+  return Number.isFinite(ms) ? ms : null;
+}
+function resolveThresholdDays(contact, defaultDays) {
+  const days = getNumberField(contact, "followupThresholdDays");
+  if (days !== null && days > 0) return days;
+  return defaultDays;
+}
+async function resolveDisplayName(runtime, contact) {
+  const explicit = getStringField(contact, "displayName");
+  if (explicit) return explicit;
+  const entity = await runtime.getEntityById(contact.entityId);
+  return entity?.names?.[0] ?? String(contact.entityId);
+}
+async function computeOverdueFollowups(runtime, now = Date.now(), defaultThresholdDays = FOLLOWUP_DEFAULT_THRESHOLD_DAYS) {
+  const service = getRelationshipsServiceLike(runtime);
+  if (!service) {
+    if (!degradedLogged) {
+      degradedLogged = true;
+      logger.info(
+        "[FollowupTracker] RelationshipsService unavailable; follow-up tracking is disabled until contacts exist"
+      );
+    }
+    return {
+      generatedAt: new Date(now).toISOString(),
+      thresholdDefaultDays: defaultThresholdDays,
+      overdue: []
+    };
+  }
+  const contacts = await service.searchContacts({});
+  const overdue = [];
+  for (const contact of contacts) {
+    const lastMs = resolveLastContactedAtMs(contact);
+    if (lastMs === null) continue;
+    const thresholdDays = resolveThresholdDays(contact, defaultThresholdDays);
+    const thresholdMs = thresholdDays * DAY_MS;
+    const ageMs = now - lastMs;
+    if (ageMs <= thresholdMs) continue;
+    const displayName = await resolveDisplayName(runtime, contact);
+    overdue.push({
+      entityId: contact.entityId,
+      displayName,
+      lastContactedAt: new Date(lastMs).toISOString(),
+      daysOverdue: Math.floor((ageMs - thresholdMs) / DAY_MS),
+      thresholdDays
+    });
+  }
+  overdue.sort((a, b) => b.daysOverdue - a.daysOverdue);
+  return {
+    generatedAt: new Date(now).toISOString(),
+    thresholdDefaultDays: defaultThresholdDays,
+    overdue
+  };
+}
+function followupDigestRoomId(agentId) {
+  return stringToUuid(`followup-tracker-${agentId}`);
+}
+function followupDigestWorldId(agentId) {
+  return stringToUuid(`followup-tracker-world-${agentId}`);
+}
+async function writeOverdueDigestMemory(runtime, digest) {
+  const worldId = followupDigestWorldId(runtime.agentId);
+  const roomId = followupDigestRoomId(runtime.agentId);
+  if (typeof runtime.ensureWorldExists === "function") {
+    await runtime.ensureWorldExists({
+      id: worldId,
+      name: "Follow-up Tracker",
+      agentId: runtime.agentId
+    });
+  }
+  if (typeof runtime.ensureRoomExists === "function") {
+    await runtime.ensureRoomExists({
+      id: roomId,
+      name: "Follow-up Tracker",
+      source: "followup-tracker",
+      type: "API",
+      channelId: `followup-tracker-${runtime.agentId}`,
+      worldId
+    });
+  }
+  const memory = {
+    id: createUniqueUuid(runtime, `followup-digest-${Date.now()}`),
+    entityId: runtime.agentId,
+    agentId: runtime.agentId,
+    roomId,
+    worldId,
+    content: {
+      text: digest.overdue.length === 0 ? "No overdue follow-ups." : `Overdue follow-ups (${digest.overdue.length}): ${digest.overdue.map((o) => `${o.displayName} (+${o.daysOverdue}d)`).join(", ")}`,
+      type: "followup_overdue_digest"
+    },
+    metadata: {
+      type: MemoryType.CUSTOM,
+      source: "followup-tracker",
+      generatedAt: digest.generatedAt,
+      thresholdDefaultDays: digest.thresholdDefaultDays,
+      overdue: digest.overdue.map((entry) => ({
+        entityId: String(entry.entityId),
+        displayName: entry.displayName,
+        lastContactedAt: entry.lastContactedAt,
+        daysOverdue: entry.daysOverdue,
+        thresholdDays: entry.thresholdDays
+      }))
+    },
+    createdAt: Date.now()
+  };
+  const memoryId = await runtime.createMemory(memory, FOLLOWUP_MEMORY_TABLE);
+  logger.info(
+    `[FollowupTracker] Wrote overdue digest memory ${memoryId} with ${digest.overdue.length} entries`
+  );
+  return memoryId;
+}
+async function reconcileFollowupsOnce(runtime, now = Date.now(), defaultThresholdDays = FOLLOWUP_DEFAULT_THRESHOLD_DAYS) {
+  const digest = await computeOverdueFollowups(
+    runtime,
+    now,
+    defaultThresholdDays
+  );
+  await writeOverdueDigestMemory(runtime, digest);
+  for (const entry of digest.overdue) {
+    const plannerContext = {
+      jobKind: "followup_watchdog",
+      subjectUserId: String(entry.entityId),
+      snapshot: {
+        entityId: String(entry.entityId),
+        displayName: entry.displayName,
+        lastContactedAt: entry.lastContactedAt,
+        daysOverdue: entry.daysOverdue,
+        thresholdDays: entry.thresholdDays,
+        generatedAt: digest.generatedAt
+      },
+      availableChannels: ["telegram", "imessage", "sms", "email", "internal"],
+      trigger: `followup_watchdog:${entry.daysOverdue}d_overdue`
+    };
+    try {
+      const plan = await planJob(runtime, plannerContext);
+      await enqueueIfSensitive(runtime, plannerContext, plan);
+    } catch (error) {
+      if (error instanceof BackgroundPlannerError) {
+        logger.warn(
+          `[FollowupTracker] background planner unavailable \u2014 ${error.message}`
+        );
+        break;
+      }
+      throw error;
+    }
+  }
+  return digest;
+}
+async function executeFollowupTrackerTick(runtime, options = {}) {
+  const defaultThresholdDays = typeof options.defaultThresholdDays === "number" && Number.isFinite(options.defaultThresholdDays) && options.defaultThresholdDays > 0 ? options.defaultThresholdDays : FOLLOWUP_DEFAULT_THRESHOLD_DAYS;
+  const digest = await reconcileFollowupsOnce(
+    runtime,
+    resolveTrackerNowMs(options),
+    defaultThresholdDays
+  );
+  return {
+    nextInterval: FOLLOWUP_TRACKER_INTERVAL_MS,
+    digest
+  };
+}
+async function ensureFollowupTrackerTask(runtime) {
+  const tasks = await runtime.getTasks({
+    agentIds: [runtime.agentId],
+    tags: [...FOLLOWUP_TRACKER_TASK_TAGS]
+  });
+  const existing = tasks.find(isFollowupTrackerTask);
+  const metadata = buildFollowupTrackerMetadata(
+    isRecord(existing?.metadata) ? existing.metadata : null
+  );
+  if (existing?.id) {
+    await runtime.updateTask(existing.id, {
+      description: "Reconcile overdue LifeOps follow-ups",
+      metadata
+    });
+    return existing.id;
+  }
+  const autonomy = runtime.getService("AUTONOMY");
+  const roomId = autonomy?.getAutonomousRoomId?.() ?? stringToUuid(`followup-tracker-room-${runtime.agentId}`);
+  return runtime.createTask({
+    name: FOLLOWUP_TRACKER_TASK_NAME,
+    description: "Reconcile overdue LifeOps follow-ups",
+    roomId,
+    tags: [...FOLLOWUP_TRACKER_TASK_TAGS],
+    metadata,
+    dueAt: Date.now()
+  });
+}
+function registerFollowupTrackerWorker(runtime) {
+  if (runtime.getTaskWorker(FOLLOWUP_TRACKER_TASK_NAME)) {
+    return;
+  }
+  runtime.registerTaskWorker({
+    name: FOLLOWUP_TRACKER_TASK_NAME,
+    // Skip execution when LifeOps is disabled via the UI. Cycles become
+    // cheap no-ops; re-enabling requires no restart.
+    shouldRun: async (rt) => {
+      try {
+        const state = await loadLifeOpsAppState(rt);
+        return state.enabled;
+      } catch (error) {
+        logger.warn(
+          `[followup-tracker] loadLifeOpsAppState failed; skipping follow-up tick because LifeOps toggle state is unknown: ${error instanceof Error ? error.message : String(error)}`
+        );
+        return false;
+      }
+    },
+    execute: (rt, options) => executeFollowupTrackerTick(rt, isRecord(options) ? options : {})
+  });
+}
+function getFollowupTrackerRoomId(runtime) {
+  return followupDigestRoomId(runtime.agentId);
+}
+function __resetFollowupTrackerForTests() {
+  degradedLogged = false;
+}
+export {
+  FOLLOWUP_DEFAULT_THRESHOLD_DAYS,
+  FOLLOWUP_MEMORY_TABLE,
+  FOLLOWUP_TRACKER_INTERVAL_MS,
+  FOLLOWUP_TRACKER_TASK_NAME,
+  FOLLOWUP_TRACKER_TASK_TAGS,
+  __resetFollowupTrackerForTests,
+  computeOverdueFollowups,
+  ensureFollowupTrackerTask,
+  executeFollowupTrackerTick,
+  getFollowupTrackerRoomId,
+  getRelationshipsServiceLike,
+  reconcileFollowupsOnce,
+  registerFollowupTrackerWorker,
+  writeOverdueDigestMemory
+};
+//# sourceMappingURL=followup-tracker.js.map

package/dist/followup/followup-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/followup/followup-tracker.ts"],"sourcesContent":["import type {\n  IAgentRuntime,\n  JsonValue,\n  Memory,\n  Task,\n  TaskMetadata,\n  UUID,\n} from \"@elizaos/core\";\nimport {\n  createUniqueUuid,\n  logger,\n  MemoryType,\n  stringToUuid,\n} from \"@elizaos/core\";\nimport { loadLifeOpsAppState } from \"../lifeops/app-state.js\";\nimport {\n  type BackgroundJobContext,\n  BackgroundPlannerError,\n  planJob,\n} from \"../lifeops/background-planner.js\";\nimport { enqueueIfSensitive } from \"../lifeops/background-planner-dispatch.js\";\n\n/**\n * Periodically scans known contacts managed by the RelationshipsService and\n * identifies contacts whose `lastContactedAt` has exceeded the configured\n * threshold. Overdue entries are written as a single consolidated memory per\n * tick (`followup_overdue_digest`) so the morning check-in + the\n * `LIST_OVERDUE_FOLLOWUPS` action can pull from a canonical location.\n *\n * If `RelationshipsService` is not registered on the runtime, the tracker logs\n * once at info level and returns an empty digest.\n */\n\n/**\n * Structural view of the RelationshipsService shape we depend on. Kept local\n * so this module doesn't force a compile-time dependency on the core service\n * type, and so it degrades gracefully when the service isn't registered.\n */\nexport interface ContactInfo {\n  entityId: UUID;\n  categories: string[];\n  tags: string[];\n  customFields: Record<string, JsonValue>;\n}\n\nexport interface RelationshipsServiceLike {\n  searchContacts(criteria: Record<string, unknown>): Promise<ContactInfo[]>;\n  getContact(entityId: UUID): Promise<ContactInfo | null>;\n  updateContact(\n    entityId: UUID,\n    updates: { customFields?: Record<string, JsonValue> },\n  ): Promise<ContactInfo | null>;\n}\n\nfunction isRelationshipsServiceLike(\n  service: unknown,\n): service is RelationshipsServiceLike {\n  if (!service || typeof service !== \"object\") return false;\n  const candidate = service as Partial<RelationshipsServiceLike>;\n  return (\n    typeof candidate.searchContacts === \"function\" &&\n    typeof candidate.getContact === \"function\" &&\n    typeof candidate.updateContact === \"function\"\n  );\n}\n\nexport const FOLLOWUP_TRACKER_TASK_NAME = \"FOLLOWUP_TRACKER_RECONCILE\" as const;\nexport const FOLLOWUP_TRACKER_TASK_TAGS = [\n  \"queue\",\n  \"repeat\",\n  \"relationships\",\n  \"followup-tracker\",\n] as const;\nexport const FOLLOWUP_TRACKER_INTERVAL_MS = 60 * 60 * 1000; // 60 minutes\nexport const FOLLOWUP_DEFAULT_THRESHOLD_DAYS = 30;\nexport const FOLLOWUP_MEMORY_TABLE = \"reminders\" as const;\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction resolveTrackerNowMs(options: Record<string, unknown> = {}): number {\n  const raw = options.now;\n  if (raw instanceof Date) {\n    return raw.getTime();\n  }\n  if (typeof raw === \"number\" && Number.isFinite(raw)) {\n    return raw;\n  }\n  if (typeof raw === \"string\" && raw.trim().length > 0) {\n    const parsed = new Date(raw).getTime();\n    if (Number.isFinite(parsed)) {\n      return parsed;\n    }\n  }\n  return Date.now();\n}\n\nfunction isFollowupTrackerTask(task: Task): boolean {\n  return task.name === FOLLOWUP_TRACKER_TASK_NAME;\n}\n\nfunction buildFollowupTrackerMetadata(\n  previous?: TaskMetadata | null,\n): TaskMetadata {\n  const metadata: TaskMetadata = {\n    ...(isRecord(previous) ? previous : {}),\n    updateInterval: FOLLOWUP_TRACKER_INTERVAL_MS,\n  };\n  return metadata;\n}\n\nexport interface OverdueFollowup {\n  entityId: UUID;\n  displayName: string;\n  lastContactedAt: string;\n  daysOverdue: number;\n  thresholdDays: number;\n}\n\nexport interface OverdueDigest {\n  generatedAt: string;\n  thresholdDefaultDays: number;\n  overdue: OverdueFollowup[];\n}\n\nexport function getRelationshipsServiceLike(\n  runtime: IAgentRuntime,\n): RelationshipsServiceLike | null {\n  const service = runtime.getService(\"relationships\");\n  if (!service) return null;\n  return isRelationshipsServiceLike(service) ? service : null;\n}\n\nlet degradedLogged = false;\n\nfunction getNumberField(contact: ContactInfo, key: string): number | null {\n  const value = contact.customFields[key];\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed)) return parsed;\n  }\n  return null;\n}\n\nfunction getStringField(contact: ContactInfo, key: string): string | null {\n  const value = contact.customFields[key];\n  return typeof value === \"string\" && value.trim().length > 0 ? value : null;\n}\n\nfunction resolveLastContactedAtMs(contact: ContactInfo): number | null {\n  const raw =\n    getStringField(contact, \"lastContactedAt\") ??\n    getStringField(contact, \"lastInteractionAt\");\n  if (!raw) return null;\n  const ms = new Date(raw).getTime();\n  return Number.isFinite(ms) ? ms : null;\n}\n\nfunction resolveThresholdDays(\n  contact: ContactInfo,\n  defaultDays: number,\n): number {\n  const days = getNumberField(contact, \"followupThresholdDays\");\n  if (days !== null && days > 0) return days;\n  return defaultDays;\n}\n\nasync function resolveDisplayName(\n  runtime: IAgentRuntime,\n  contact: ContactInfo,\n): Promise<string> {\n  const explicit = getStringField(contact, \"displayName\");\n  if (explicit) return explicit;\n  const entity = await runtime.getEntityById(contact.entityId);\n  return entity?.names?.[0] ?? String(contact.entityId);\n}\n\n/**\n * One tick of the tracker. Pure async fn — safe to call from tests.\n */\nexport async function computeOverdueFollowups(\n  runtime: IAgentRuntime,\n  now: number = Date.now(),\n  defaultThresholdDays: number = FOLLOWUP_DEFAULT_THRESHOLD_DAYS,\n): Promise<OverdueDigest> {\n  const service = getRelationshipsServiceLike(runtime);\n  if (!service) {\n    if (!degradedLogged) {\n      degradedLogged = true;\n      logger.info(\n        \"[FollowupTracker] RelationshipsService unavailable; follow-up tracking is disabled until contacts exist\",\n      );\n    }\n    return {\n      generatedAt: new Date(now).toISOString(),\n      thresholdDefaultDays: defaultThresholdDays,\n      overdue: [],\n    };\n  }\n\n  const contacts = await service.searchContacts({});\n  const overdue: OverdueFollowup[] = [];\n\n  for (const contact of contacts) {\n    const lastMs = resolveLastContactedAtMs(contact);\n    if (lastMs === null) continue;\n\n    const thresholdDays = resolveThresholdDays(contact, defaultThresholdDays);\n    const thresholdMs = thresholdDays * DAY_MS;\n    const ageMs = now - lastMs;\n    if (ageMs <= thresholdMs) continue;\n\n    const displayName = await resolveDisplayName(runtime, contact);\n    overdue.push({\n      entityId: contact.entityId,\n      displayName,\n      lastContactedAt: new Date(lastMs).toISOString(),\n      daysOverdue: Math.floor((ageMs - thresholdMs) / DAY_MS),\n      thresholdDays,\n    });\n  }\n\n  overdue.sort((a, b) => b.daysOverdue - a.daysOverdue);\n\n  return {\n    generatedAt: new Date(now).toISOString(),\n    thresholdDefaultDays: defaultThresholdDays,\n    overdue,\n  };\n}\n\nfunction followupDigestRoomId(agentId: UUID): UUID {\n  return stringToUuid(`followup-tracker-${agentId}`);\n}\n\nfunction followupDigestWorldId(agentId: UUID): UUID {\n  return stringToUuid(`followup-tracker-world-${agentId}`);\n}\n\n/**\n * Persist the digest as a memory so morning check-in + actions can retrieve\n * it. One memory per tick; callers querying the most recent\n * `followup_overdue_digest` memory in the followup room get the latest view.\n */\nexport async function writeOverdueDigestMemory(\n  runtime: IAgentRuntime,\n  digest: OverdueDigest,\n): Promise<UUID> {\n  const worldId = followupDigestWorldId(runtime.agentId);\n  const roomId = followupDigestRoomId(runtime.agentId);\n\n  if (typeof runtime.ensureWorldExists === \"function\") {\n    await runtime.ensureWorldExists({\n      id: worldId,\n      name: \"Follow-up Tracker\",\n      agentId: runtime.agentId,\n    } as Parameters<typeof runtime.ensureWorldExists>[0]);\n  }\n  if (typeof runtime.ensureRoomExists === \"function\") {\n    await runtime.ensureRoomExists({\n      id: roomId,\n      name: \"Follow-up Tracker\",\n      source: \"followup-tracker\",\n      type: \"API\",\n      channelId: `followup-tracker-${runtime.agentId}`,\n      worldId,\n    } as Parameters<typeof runtime.ensureRoomExists>[0]);\n  }\n\n  const memory: Memory = {\n    id: createUniqueUuid(runtime, `followup-digest-${Date.now()}`),\n    entityId: runtime.agentId,\n    agentId: runtime.agentId,\n    roomId,\n    worldId,\n    content: {\n      text:\n        digest.overdue.length === 0\n          ? \"No overdue follow-ups.\"\n          : `Overdue follow-ups (${digest.overdue.length}): ${digest.overdue\n              .map((o) => `${o.displayName} (+${o.daysOverdue}d)`)\n              .join(\", \")}`,\n      type: \"followup_overdue_digest\",\n    },\n    metadata: {\n      type: MemoryType.CUSTOM,\n      source: \"followup-tracker\",\n      generatedAt: digest.generatedAt,\n      thresholdDefaultDays: digest.thresholdDefaultDays,\n      overdue: digest.overdue.map((entry) => ({\n        entityId: String(entry.entityId),\n        displayName: entry.displayName,\n        lastContactedAt: entry.lastContactedAt,\n        daysOverdue: entry.daysOverdue,\n        thresholdDays: entry.thresholdDays,\n      })),\n    },\n    createdAt: Date.now(),\n  };\n\n  const memoryId = await runtime.createMemory(memory, FOLLOWUP_MEMORY_TABLE);\n  logger.info(\n    `[FollowupTracker] Wrote overdue digest memory ${memoryId} with ${digest.overdue.length} entries`,\n  );\n  return memoryId;\n}\n\n/**\n * One reconciler tick. Compute + persist. Returns the digest for testability.\n */\nexport async function reconcileFollowupsOnce(\n  runtime: IAgentRuntime,\n  now: number = Date.now(),\n  defaultThresholdDays: number = FOLLOWUP_DEFAULT_THRESHOLD_DAYS,\n): Promise<OverdueDigest> {\n  const digest = await computeOverdueFollowups(\n    runtime,\n    now,\n    defaultThresholdDays,\n  );\n  await writeOverdueDigestMemory(runtime, digest);\n\n  // Route each overdue contact through the shared LLM planner. Sensitive\n  // actions are enqueued into the approval queue; the tracker never auto-sends.\n  for (const entry of digest.overdue) {\n    const plannerContext: BackgroundJobContext = {\n      jobKind: \"followup_watchdog\",\n      subjectUserId: String(entry.entityId),\n      snapshot: {\n        entityId: String(entry.entityId),\n        displayName: entry.displayName,\n        lastContactedAt: entry.lastContactedAt,\n        daysOverdue: entry.daysOverdue,\n        thresholdDays: entry.thresholdDays,\n        generatedAt: digest.generatedAt,\n      },\n      availableChannels: [\"telegram\", \"imessage\", \"sms\", \"email\", \"internal\"],\n      trigger: `followup_watchdog:${entry.daysOverdue}d_overdue`,\n    };\n    try {\n      const plan = await planJob(runtime, plannerContext);\n      await enqueueIfSensitive(runtime, plannerContext, plan);\n    } catch (error) {\n      if (error instanceof BackgroundPlannerError) {\n        logger.warn(\n          `[FollowupTracker] background planner unavailable — ${error.message}`,\n        );\n        break;\n      }\n      throw error;\n    }\n  }\n\n  return digest;\n}\n\nexport async function executeFollowupTrackerTick(\n  runtime: IAgentRuntime,\n  options: Record<string, unknown> = {},\n): Promise<{ nextInterval: number; digest: OverdueDigest }> {\n  const defaultThresholdDays =\n    typeof options.defaultThresholdDays === \"number\" &&\n    Number.isFinite(options.defaultThresholdDays) &&\n    options.defaultThresholdDays > 0\n      ? options.defaultThresholdDays\n      : FOLLOWUP_DEFAULT_THRESHOLD_DAYS;\n  const digest = await reconcileFollowupsOnce(\n    runtime,\n    resolveTrackerNowMs(options),\n    defaultThresholdDays,\n  );\n  return {\n    nextInterval: FOLLOWUP_TRACKER_INTERVAL_MS,\n    digest,\n  };\n}\n\ntype AutonomyServiceLike = {\n  getAutonomousRoomId?: () => UUID;\n};\n\nexport async function ensureFollowupTrackerTask(\n  runtime: IAgentRuntime,\n): Promise<UUID> {\n  const tasks = await runtime.getTasks({\n    agentIds: [runtime.agentId],\n    tags: [...FOLLOWUP_TRACKER_TASK_TAGS],\n  });\n  const existing = tasks.find(isFollowupTrackerTask);\n  const metadata = buildFollowupTrackerMetadata(\n    isRecord(existing?.metadata) ? existing.metadata : null,\n  );\n  if (existing?.id) {\n    await runtime.updateTask(existing.id, {\n      description: \"Reconcile overdue LifeOps follow-ups\",\n      metadata,\n    });\n    return existing.id;\n  }\n\n  const autonomy = runtime.getService(\"AUTONOMY\") as AutonomyServiceLike | null;\n  const roomId =\n    autonomy?.getAutonomousRoomId?.() ??\n    stringToUuid(`followup-tracker-room-${runtime.agentId}`);\n\n  return runtime.createTask({\n    name: FOLLOWUP_TRACKER_TASK_NAME,\n    description: \"Reconcile overdue LifeOps follow-ups\",\n    roomId,\n    tags: [...FOLLOWUP_TRACKER_TASK_TAGS],\n    metadata,\n    dueAt: Date.now(),\n  });\n}\n\n/**\n * Register the tracker as a periodic task worker. Mirrors the\n * BlockRuleReconciler pattern so it integrates with the agent scheduler.\n */\nexport function registerFollowupTrackerWorker(runtime: IAgentRuntime): void {\n  if (runtime.getTaskWorker(FOLLOWUP_TRACKER_TASK_NAME)) {\n    return;\n  }\n  runtime.registerTaskWorker({\n    name: FOLLOWUP_TRACKER_TASK_NAME,\n    // Skip execution when LifeOps is disabled via the UI. Cycles become\n    // cheap no-ops; re-enabling requires no restart.\n    shouldRun: async (rt) => {\n      try {\n        const state = await loadLifeOpsAppState(rt as IAgentRuntime);\n        return state.enabled;\n      } catch (error) {\n        logger.warn(\n          `[followup-tracker] loadLifeOpsAppState failed; skipping follow-up tick because LifeOps toggle state is unknown: ${\n            error instanceof Error ? error.message : String(error)\n          }`,\n        );\n        return false;\n      }\n    },\n    execute: (rt, options) =>\n      executeFollowupTrackerTick(rt, isRecord(options) ? options : {}),\n  });\n}\n\n/**\n * Resolve the room used to store follow-up tracker memories. Exposed for\n * callers (e.g. LIST_OVERDUE_FOLLOWUPS action or morning check-in) that need\n * to query the digest.\n */\nexport function getFollowupTrackerRoomId(runtime: IAgentRuntime): UUID {\n  return followupDigestRoomId(runtime.agentId);\n}\n\n/**\n * Test-only: reset the one-time degraded-mode log so unit tests can observe\n * the log path repeatedly.\n */\nexport function __resetFollowupTrackerForTests(): void {\n  degradedLogged = false;\n}\n"],"mappings":"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","names":[]}

package/dist/followup/index.d.ts

@@ -0,0 +1,5 @@
+export { listOverdueFollowupsAction } from "./actions/listOverdueFollowups.js";
+export { markFollowupDoneAction } from "./actions/markFollowupDone.js";
+export { setFollowupThresholdAction } from "./actions/setFollowupThreshold.js";
+export { __resetFollowupTrackerForTests, type ContactInfo, computeOverdueFollowups, ensureFollowupTrackerTask, executeFollowupTrackerTick, FOLLOWUP_DEFAULT_THRESHOLD_DAYS, FOLLOWUP_MEMORY_TABLE, FOLLOWUP_TRACKER_INTERVAL_MS, FOLLOWUP_TRACKER_TASK_NAME, FOLLOWUP_TRACKER_TASK_TAGS, getFollowupTrackerRoomId, getRelationshipsServiceLike, type OverdueDigest, type OverdueFollowup, type RelationshipsServiceLike, reconcileFollowupsOnce, registerFollowupTrackerWorker, writeOverdueDigestMemory, } from "./followup-tracker.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/followup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/followup/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EACL,8BAA8B,EAC9B,KAAK,WAAW,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,qBAAqB,EACrB,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,sBAAsB,EACtB,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/followup/index.js

@@ -0,0 +1,39 @@
+import { listOverdueFollowupsAction } from "./actions/listOverdueFollowups.js";
+import { markFollowupDoneAction } from "./actions/markFollowupDone.js";
+import { setFollowupThresholdAction } from "./actions/setFollowupThreshold.js";
+import {
+  __resetFollowupTrackerForTests,
+  computeOverdueFollowups,
+  ensureFollowupTrackerTask,
+  executeFollowupTrackerTick,
+  FOLLOWUP_DEFAULT_THRESHOLD_DAYS,
+  FOLLOWUP_MEMORY_TABLE,
+  FOLLOWUP_TRACKER_INTERVAL_MS,
+  FOLLOWUP_TRACKER_TASK_NAME,
+  FOLLOWUP_TRACKER_TASK_TAGS,
+  getFollowupTrackerRoomId,
+  getRelationshipsServiceLike,
+  reconcileFollowupsOnce,
+  registerFollowupTrackerWorker,
+  writeOverdueDigestMemory
+} from "./followup-tracker.js";
+export {
+  FOLLOWUP_DEFAULT_THRESHOLD_DAYS,
+  FOLLOWUP_MEMORY_TABLE,
+  FOLLOWUP_TRACKER_INTERVAL_MS,
+  FOLLOWUP_TRACKER_TASK_NAME,
+  FOLLOWUP_TRACKER_TASK_TAGS,
+  __resetFollowupTrackerForTests,
+  computeOverdueFollowups,
+  ensureFollowupTrackerTask,
+  executeFollowupTrackerTick,
+  getFollowupTrackerRoomId,
+  getRelationshipsServiceLike,
+  listOverdueFollowupsAction,
+  markFollowupDoneAction,
+  reconcileFollowupsOnce,
+  registerFollowupTrackerWorker,
+  setFollowupThresholdAction,
+  writeOverdueDigestMemory
+};
+//# sourceMappingURL=index.js.map

package/dist/followup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/followup/index.ts"],"sourcesContent":["export { listOverdueFollowupsAction } from \"./actions/listOverdueFollowups.js\";\nexport { markFollowupDoneAction } from \"./actions/markFollowupDone.js\";\nexport { setFollowupThresholdAction } from \"./actions/setFollowupThreshold.js\";\nexport {\n  __resetFollowupTrackerForTests,\n  type ContactInfo,\n  computeOverdueFollowups,\n  ensureFollowupTrackerTask,\n  executeFollowupTrackerTick,\n  FOLLOWUP_DEFAULT_THRESHOLD_DAYS,\n  FOLLOWUP_MEMORY_TABLE,\n  FOLLOWUP_TRACKER_INTERVAL_MS,\n  FOLLOWUP_TRACKER_TASK_NAME,\n  FOLLOWUP_TRACKER_TASK_TAGS,\n  getFollowupTrackerRoomId,\n  getRelationshipsServiceLike,\n  type OverdueDigest,\n  type OverdueFollowup,\n  type RelationshipsServiceLike,\n  reconcileFollowupsOnce,\n  registerFollowupTrackerWorker,\n  writeOverdueDigestMemory,\n} from \"./followup-tracker.js\";\n"],"mappings":"AAAA,SAAS,kCAAkC;AAC3C,SAAS,8BAA8B;AACvC,SAAS,kCAAkC;AAC3C;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAIA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/hooks/connector-error.d.ts

@@ -0,0 +1,2 @@
+export declare function formatConnectorError(cause: unknown, fallback: string): string;
+//# sourceMappingURL=connector-error.d.ts.map

package/dist/hooks/connector-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-error.d.ts","sourceRoot":"","sources":["../../src/hooks/connector-error.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ7E"}

package/dist/hooks/connector-error.js

@@ -0,0 +1,13 @@
+function formatConnectorError(cause, fallback) {
+  if (cause instanceof Error) {
+    const message = cause.message.trim();
+    if (message.length > 0) {
+      return message;
+    }
+  }
+  return fallback;
+}
+export {
+  formatConnectorError
+};
+//# sourceMappingURL=connector-error.js.map

package/dist/hooks/connector-error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/connector-error.ts"],"sourcesContent":["export function formatConnectorError(cause: unknown, fallback: string): string {\n  if (cause instanceof Error) {\n    const message = cause.message.trim();\n    if (message.length > 0) {\n      return message;\n    }\n  }\n  return fallback;\n}\n"],"mappings":"AAAO,SAAS,qBAAqB,OAAgB,UAA0B;AAC7E,MAAI,iBAAiB,OAAO;AAC1B,UAAM,UAAU,MAAM,QAAQ,KAAK;AACnC,QAAI,QAAQ,SAAS,GAAG;AACtB,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/hooks/useDiscordConnector.d.ts

@@ -0,0 +1,11 @@
+import type { LifeOpsConnectorSide, LifeOpsDiscordConnectorStatus } from "@elizaos/shared";
+export interface UseDiscordConnectorOptions {
+    side?: LifeOpsConnectorSide;
+}
+export declare function useDiscordConnector(options?: UseDiscordConnectorOptions): {
+    readonly status: LifeOpsDiscordConnectorStatus | null;
+    readonly loading: boolean;
+    readonly error: string | null;
+    readonly refresh: () => Promise<void>;
+};
+//# sourceMappingURL=useDiscordConnector.d.ts.map

package/dist/hooks/useDiscordConnector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDiscordConnector.d.ts","sourceRoot":"","sources":["../../src/hooks/useDiscordConnector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,iBAAiB,CAAC;AAKzB,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B;AAID,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B;;;;;EA6F3E"}

package/dist/hooks/useDiscordConnector.js

@@ -0,0 +1,95 @@
+import { client } from "@elizaos/ui";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { formatConnectorError } from "./connector-error.js";
+const LOGIN_POLL_INTERVAL_MS = 3e3;
+function useDiscordConnector(options = {}) {
+  const side = options.side ?? "owner";
+  const [status, setStatus] = useState(
+    null
+  );
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const pollRef = useRef(null);
+  const clearPoll = useCallback(() => {
+    if (pollRef.current) {
+      clearInterval(pollRef.current);
+      pollRef.current = null;
+    }
+  }, []);
+  const refresh = useCallback(async () => {
+    setLoading(true);
+    try {
+      const nextStatus = await client.getDiscordConnectorStatus(side);
+      setStatus(nextStatus);
+      setError(null);
+    } catch (cause) {
+      setError(
+        formatConnectorError(cause, "Discord connector status failed to load.")
+      );
+    } finally {
+      setLoading(false);
+    }
+  }, [side]);
+  useEffect(() => {
+    let cancelled = false;
+    void (async () => {
+      setLoading(true);
+      try {
+        const nextStatus = await client.getDiscordConnectorStatus(side);
+        if (cancelled) return;
+        setStatus(nextStatus);
+        setError(null);
+      } catch (cause) {
+        if (cancelled) return;
+        setError(
+          formatConnectorError(
+            cause,
+            "Discord connector status failed to load."
+          )
+        );
+      } finally {
+        if (!cancelled) setLoading(false);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [side]);
+  useEffect(() => () => clearPoll(), [clearPoll]);
+  useEffect(() => {
+    const shouldPoll = status?.reason === "pairing" || status?.reason === "auth_pending";
+    if (shouldPoll && !pollRef.current) {
+      pollRef.current = setInterval(() => {
+        void (async () => {
+          try {
+            const next = await client.getDiscordConnectorStatus(side);
+            setStatus(next);
+            if (next.reason !== "pairing" && next.reason !== "auth_pending") {
+              clearPoll();
+            }
+            setError(null);
+          } catch (cause) {
+            setError(
+              formatConnectorError(
+                cause,
+                "Discord connector status poll failed."
+              )
+            );
+          }
+        })();
+      }, LOGIN_POLL_INTERVAL_MS);
+    } else if (!shouldPoll) {
+      clearPoll();
+    }
+  }, [status?.reason, side, clearPoll]);
+  return {
+    status,
+    loading,
+    error,
+    refresh
+  };
+}
+export {
+  useDiscordConnector
+};
+//# sourceMappingURL=useDiscordConnector.js.map

package/dist/hooks/useDiscordConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useDiscordConnector.ts"],"sourcesContent":["import type {\n  LifeOpsConnectorSide,\n  LifeOpsDiscordConnectorStatus,\n} from \"@elizaos/shared\";\nimport { client } from \"@elizaos/ui\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { formatConnectorError } from \"./connector-error.js\";\n\nexport interface UseDiscordConnectorOptions {\n  side?: LifeOpsConnectorSide;\n}\n\nconst LOGIN_POLL_INTERVAL_MS = 3_000;\n\nexport function useDiscordConnector(options: UseDiscordConnectorOptions = {}) {\n  const side = options.side ?? \"owner\";\n  const [status, setStatus] = useState<LifeOpsDiscordConnectorStatus | null>(\n    null,\n  );\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<string | null>(null);\n  const pollRef = useRef<ReturnType<typeof setInterval> | null>(null);\n\n  const clearPoll = useCallback(() => {\n    if (pollRef.current) {\n      clearInterval(pollRef.current);\n      pollRef.current = null;\n    }\n  }, []);\n\n  const refresh = useCallback(async () => {\n    setLoading(true);\n    try {\n      const nextStatus = await client.getDiscordConnectorStatus(side);\n      setStatus(nextStatus);\n      setError(null);\n    } catch (cause) {\n      setError(\n        formatConnectorError(cause, \"Discord connector status failed to load.\"),\n      );\n    } finally {\n      setLoading(false);\n    }\n  }, [side]);\n\n  useEffect(() => {\n    let cancelled = false;\n    void (async () => {\n      setLoading(true);\n      try {\n        const nextStatus = await client.getDiscordConnectorStatus(side);\n        if (cancelled) return;\n        setStatus(nextStatus);\n        setError(null);\n      } catch (cause) {\n        if (cancelled) return;\n        setError(\n          formatConnectorError(\n            cause,\n            \"Discord connector status failed to load.\",\n          ),\n        );\n      } finally {\n        if (!cancelled) setLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [side]);\n\n  useEffect(() => () => clearPoll(), [clearPoll]);\n\n  useEffect(() => {\n    const shouldPoll =\n      status?.reason === \"pairing\" || status?.reason === \"auth_pending\";\n    if (shouldPoll && !pollRef.current) {\n      pollRef.current = setInterval(() => {\n        void (async () => {\n          try {\n            const next = await client.getDiscordConnectorStatus(side);\n            setStatus(next);\n            if (next.reason !== \"pairing\" && next.reason !== \"auth_pending\") {\n              clearPoll();\n            }\n            setError(null);\n          } catch (cause) {\n            setError(\n              formatConnectorError(\n                cause,\n                \"Discord connector status poll failed.\",\n              ),\n            );\n          }\n        })();\n      }, LOGIN_POLL_INTERVAL_MS);\n    } else if (!shouldPoll) {\n      clearPoll();\n    }\n  }, [status?.reason, side, clearPoll]);\n\n  return {\n    status,\n    loading,\n    error,\n    refresh,\n  } as const;\n}\n"],"mappings":"AAIA,SAAS,cAAc;AACvB,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AACzD,SAAS,4BAA4B;AAMrC,MAAM,yBAAyB;AAExB,SAAS,oBAAoB,UAAsC,CAAC,GAAG;AAC5E,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,CAAC,QAAQ,SAAS,IAAI;AAAA,IAC1B;AAAA,EACF;AACA,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,IAAI;AAC3C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AACtD,QAAM,UAAU,OAA8C,IAAI;AAElE,QAAM,YAAY,YAAY,MAAM;AAClC,QAAI,QAAQ,SAAS;AACnB,oBAAc,QAAQ,OAAO;AAC7B,cAAQ,UAAU;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,QAAM,UAAU,YAAY,YAAY;AACtC,eAAW,IAAI;AACf,QAAI;AACF,YAAM,aAAa,MAAM,OAAO,0BAA0B,IAAI;AAC9D,gBAAU,UAAU;AACpB,eAAS,IAAI;AAAA,IACf,SAAS,OAAO;AACd;AAAA,QACE,qBAAqB,OAAO,0CAA0C;AAAA,MACxE;AAAA,IACF,UAAE;AACA,iBAAW,KAAK;AAAA,IAClB;AAAA,EACF,GAAG,CAAC,IAAI,CAAC;AAET,YAAU,MAAM;AACd,QAAI,YAAY;AAChB,UAAM,YAAY;AAChB,iBAAW,IAAI;AACf,UAAI;AACF,cAAM,aAAa,MAAM,OAAO,0BAA0B,IAAI;AAC9D,YAAI,UAAW;AACf,kBAAU,UAAU;AACpB,iBAAS,IAAI;AAAA,MACf,SAAS,OAAO;AACd,YAAI,UAAW;AACf;AAAA,UACE;AAAA,YACE;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,MACF,UAAE;AACA,YAAI,CAAC,UAAW,YAAW,KAAK;AAAA,MAClC;AAAA,IACF,GAAG;AACH,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,IAAI,CAAC;AAET,YAAU,MAAM,MAAM,UAAU,GAAG,CAAC,SAAS,CAAC;AAE9C,YAAU,MAAM;AACd,UAAM,aACJ,QAAQ,WAAW,aAAa,QAAQ,WAAW;AACrD,QAAI,cAAc,CAAC,QAAQ,SAAS;AAClC,cAAQ,UAAU,YAAY,MAAM;AAClC,cAAM,YAAY;AAChB,cAAI;AACF,kBAAM,OAAO,MAAM,OAAO,0BAA0B,IAAI;AACxD,sBAAU,IAAI;AACd,gBAAI,KAAK,WAAW,aAAa,KAAK,WAAW,gBAAgB;AAC/D,wBAAU;AAAA,YACZ;AACA,qBAAS,IAAI;AAAA,UACf,SAAS,OAAO;AACd;AAAA,cACE;AAAA,gBACE;AAAA,gBACA;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,QACF,GAAG;AAAA,MACL,GAAG,sBAAsB;AAAA,IAC3B,WAAW,CAAC,YAAY;AACtB,gBAAU;AAAA,IACZ;AAAA,EACF,GAAG,CAAC,QAAQ,QAAQ,MAAM,SAAS,CAAC;AAEpC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/hooks/useGoogleLifeOpsConnector.d.ts

@@ -0,0 +1,23 @@
+import type { LifeOpsConnectorMode, LifeOpsConnectorSide, LifeOpsGoogleConnectorStatus } from "../contracts/index.js";
+export interface UseGoogleLifeOpsConnectorOptions {
+    includeAccounts?: boolean;
+    pollIntervalMs?: number;
+    pollWhileDisconnected?: boolean;
+    side?: LifeOpsConnectorSide;
+}
+export declare function useGoogleLifeOpsConnector(options?: UseGoogleLifeOpsConnectorOptions): {
+    readonly accounts: LifeOpsGoogleConnectorStatus[];
+    readonly activeMode: "local" | "remote" | "cloud_managed";
+    readonly error: string | null;
+    readonly loading: boolean;
+    readonly modeOptions: ("local" | "remote" | "cloud_managed")[];
+    readonly refresh: ({ silent, mode, }?: {
+        silent?: boolean;
+        mode?: LifeOpsConnectorMode | null;
+    }) => Promise<void>;
+    readonly selectMode: (mode: LifeOpsConnectorMode) => Promise<void>;
+    readonly selectedMode: "local" | "remote" | "cloud_managed" | null;
+    readonly side: "owner" | "agent";
+    readonly status: LifeOpsGoogleConnectorStatus | null;
+};
+//# sourceMappingURL=useGoogleLifeOpsConnector.d.ts.map

package/dist/hooks/useGoogleLifeOpsConnector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGoogleLifeOpsConnector.d.ts","sourceRoot":"","sources":["../../src/hooks/useGoogleLifeOpsConnector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,oBAAoB,EACpB,oBAAoB,EAEpB,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AA6e/B,MAAM,WAAW,gCAAgC;IAC/C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B;AAED,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,gCAAqC;;;;;;2CAwCzC;QACD,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;KACpC;gCA2OY,oBAAoB;;;;EA0CpC"}