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

package/dist/activity-profile/presence-signal-bridge-service.js

@@ -0,0 +1,159 @@
+import {
+  EventType,
+  Service
+} from "@elizaos/core";
+import { getDeviceId } from "../lifeops/device-identity.js";
+import {
+  createLifeOpsActivitySignal,
+  LifeOpsRepository
+} from "../lifeops/repository.js";
+const DEDUPE_WINDOW_MS = 5e3;
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readMessageEntityId(payload) {
+  const record = isRecord(payload.message) ? payload.message : null;
+  const entityId = record?.entityId;
+  return typeof entityId === "string" && entityId.length > 0 ? entityId : null;
+}
+function readMessageTimestamp(payload) {
+  const record = isRecord(payload.message) ? payload.message : null;
+  const createdAt = record?.createdAt;
+  if (typeof createdAt === "number" && Number.isFinite(createdAt)) {
+    return new Date(createdAt).toISOString();
+  }
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function readPlatform(payload) {
+  const messageRecord = isRecord(payload.message) ? payload.message : null;
+  const content = isRecord(messageRecord?.content) ? messageRecord.content : null;
+  const candidates = [
+    content?.channelType,
+    content?.source,
+    messageRecord?.source,
+    payload.source
+  ];
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.trim().length > 0) {
+      return candidate;
+    }
+  }
+  return "runtime_event";
+}
+class PresenceSignalBridgeService extends Service {
+  static serviceType = "presence_signal_bridge";
+  capabilityDescription = "Bridges runtime message activity into LifeOps activity signals for wake detection.";
+  recentFingerprints = /* @__PURE__ */ new Map();
+  messageReceivedHandler = async (payload) => {
+    await this.captureActivityFromMessage(EventType.MESSAGE_RECEIVED, payload);
+  };
+  messageSentHandler = async (payload) => {
+    await this.captureActivityFromMessage(EventType.MESSAGE_SENT, payload);
+  };
+  actionStartedHandler = async (payload) => {
+    await this.captureActivityFromAction(payload);
+  };
+  static async start(runtime) {
+    const service = new PresenceSignalBridgeService(runtime);
+    runtime.registerEvent(
+      EventType.MESSAGE_RECEIVED,
+      service.messageReceivedHandler
+    );
+    runtime.registerEvent(EventType.MESSAGE_SENT, service.messageSentHandler);
+    runtime.registerEvent(
+      EventType.ACTION_STARTED,
+      service.actionStartedHandler
+    );
+    return service;
+  }
+  async stop() {
+    this.runtime.unregisterEvent(
+      EventType.MESSAGE_RECEIVED,
+      this.messageReceivedHandler
+    );
+    this.runtime.unregisterEvent(
+      EventType.MESSAGE_SENT,
+      this.messageSentHandler
+    );
+    this.runtime.unregisterEvent(
+      EventType.ACTION_STARTED,
+      this.actionStartedHandler
+    );
+  }
+  async captureActivityFromAction(payload) {
+    if (payload.content.source !== "client_chat") {
+      return;
+    }
+    const actionName = payload.content.actions?.[0] ?? "unknown";
+    const messageId = typeof payload.messageId === "string" ? payload.messageId : "unknown";
+    const observedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const fingerprint = `action:${messageId}`;
+    const observedMs = Date.parse(observedAt);
+    const existing = this.recentFingerprints.get(fingerprint);
+    if (existing !== void 0 && Number.isFinite(observedMs) && observedMs - existing < DEDUPE_WINDOW_MS) {
+      return;
+    }
+    if (Number.isFinite(observedMs)) {
+      this.recentFingerprints.set(fingerprint, observedMs);
+    }
+    const repository = new LifeOpsRepository(this.runtime);
+    await repository.createActivitySignal(
+      createLifeOpsActivitySignal({
+        agentId: String(this.runtime.agentId),
+        source: "app_lifecycle",
+        platform: "agent_action",
+        state: "active",
+        observedAt,
+        idleState: "active",
+        idleTimeSeconds: 0,
+        onBattery: null,
+        health: null,
+        metadata: {
+          eventType: "ACTION_STARTED",
+          actionName,
+          messageId,
+          deviceId: getDeviceId()
+        }
+      })
+    );
+  }
+  async captureActivityFromMessage(eventType, payload) {
+    const entityId = readMessageEntityId(payload);
+    if (!entityId || entityId === String(this.runtime.agentId)) {
+      return;
+    }
+    const observedAt = readMessageTimestamp(payload);
+    const fingerprint = `${eventType}:${entityId}:${observedAt}`;
+    const observedMs = Date.parse(observedAt);
+    const existing = this.recentFingerprints.get(fingerprint);
+    if (existing !== void 0 && Number.isFinite(observedMs) && observedMs - existing < DEDUPE_WINDOW_MS) {
+      return;
+    }
+    if (Number.isFinite(observedMs)) {
+      this.recentFingerprints.set(fingerprint, observedMs);
+    }
+    const repository = new LifeOpsRepository(this.runtime);
+    await repository.createActivitySignal(
+      createLifeOpsActivitySignal({
+        agentId: String(this.runtime.agentId),
+        source: "connector_activity",
+        platform: readPlatform(payload),
+        state: "active",
+        observedAt,
+        idleState: null,
+        idleTimeSeconds: 0,
+        onBattery: null,
+        health: null,
+        metadata: {
+          eventType,
+          entityId,
+          deviceId: getDeviceId()
+        }
+      })
+    );
+  }
+}
+export {
+  PresenceSignalBridgeService
+};
+//# sourceMappingURL=presence-signal-bridge-service.js.map

package/dist/activity-profile/presence-signal-bridge-service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/activity-profile/presence-signal-bridge-service.ts"],"sourcesContent":["import {\n  type ActionEventPayload,\n  EventType,\n  type IAgentRuntime,\n  type MessagePayload,\n  Service,\n} from \"@elizaos/core\";\nimport { getDeviceId } from \"../lifeops/device-identity.js\";\nimport {\n  createLifeOpsActivitySignal,\n  LifeOpsRepository,\n} from \"../lifeops/repository.js\";\n\nconst DEDUPE_WINDOW_MS = 5_000;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction readMessageEntityId(payload: MessagePayload): string | null {\n  const record = isRecord(payload.message) ? payload.message : null;\n  const entityId = record?.entityId;\n  return typeof entityId === \"string\" && entityId.length > 0 ? entityId : null;\n}\n\nfunction readMessageTimestamp(payload: MessagePayload): string {\n  const record = isRecord(payload.message) ? payload.message : null;\n  const createdAt = record?.createdAt;\n  if (typeof createdAt === \"number\" && Number.isFinite(createdAt)) {\n    return new Date(createdAt).toISOString();\n  }\n  return new Date().toISOString();\n}\n\nfunction readPlatform(payload: MessagePayload): string {\n  const messageRecord = isRecord(payload.message) ? payload.message : null;\n  const content = isRecord(messageRecord?.content)\n    ? messageRecord.content\n    : null;\n  const candidates = [\n    content?.channelType,\n    content?.source,\n    messageRecord?.source,\n    payload.source,\n  ];\n  for (const candidate of candidates) {\n    if (typeof candidate === \"string\" && candidate.trim().length > 0) {\n      return candidate;\n    }\n  }\n  return \"runtime_event\";\n}\n\nexport class PresenceSignalBridgeService extends Service {\n  static override readonly serviceType = \"presence_signal_bridge\";\n\n  override capabilityDescription =\n    \"Bridges runtime message activity into LifeOps activity signals for wake detection.\";\n\n  private readonly recentFingerprints = new Map<string, number>();\n\n  private readonly messageReceivedHandler = async (\n    payload: MessagePayload,\n  ): Promise<void> => {\n    await this.captureActivityFromMessage(EventType.MESSAGE_RECEIVED, payload);\n  };\n\n  private readonly messageSentHandler = async (\n    payload: MessagePayload,\n  ): Promise<void> => {\n    await this.captureActivityFromMessage(EventType.MESSAGE_SENT, payload);\n  };\n\n  private readonly actionStartedHandler = async (\n    payload: ActionEventPayload,\n  ): Promise<void> => {\n    await this.captureActivityFromAction(payload);\n  };\n\n  static override async start(\n    runtime: IAgentRuntime,\n  ): Promise<PresenceSignalBridgeService> {\n    const service = new PresenceSignalBridgeService(runtime);\n    runtime.registerEvent(\n      EventType.MESSAGE_RECEIVED,\n      service.messageReceivedHandler,\n    );\n    runtime.registerEvent(EventType.MESSAGE_SENT, service.messageSentHandler);\n    runtime.registerEvent(\n      EventType.ACTION_STARTED,\n      service.actionStartedHandler,\n    );\n    return service;\n  }\n\n  override async stop(): Promise<void> {\n    this.runtime.unregisterEvent(\n      EventType.MESSAGE_RECEIVED,\n      this.messageReceivedHandler,\n    );\n    this.runtime.unregisterEvent(\n      EventType.MESSAGE_SENT,\n      this.messageSentHandler,\n    );\n    this.runtime.unregisterEvent(\n      EventType.ACTION_STARTED,\n      this.actionStartedHandler,\n    );\n  }\n\n  private async captureActivityFromAction(\n    payload: ActionEventPayload,\n  ): Promise<void> {\n    if (payload.content.source !== \"client_chat\") {\n      return;\n    }\n    const actionName = payload.content.actions?.[0] ?? \"unknown\";\n    const messageId =\n      typeof payload.messageId === \"string\" ? payload.messageId : \"unknown\";\n    const observedAt = new Date().toISOString();\n    const fingerprint = `action:${messageId}`;\n    const observedMs = Date.parse(observedAt);\n    const existing = this.recentFingerprints.get(fingerprint);\n    if (\n      existing !== undefined &&\n      Number.isFinite(observedMs) &&\n      observedMs - existing < DEDUPE_WINDOW_MS\n    ) {\n      return;\n    }\n    if (Number.isFinite(observedMs)) {\n      this.recentFingerprints.set(fingerprint, observedMs);\n    }\n    const repository = new LifeOpsRepository(this.runtime);\n    await repository.createActivitySignal(\n      createLifeOpsActivitySignal({\n        agentId: String(this.runtime.agentId),\n        source: \"app_lifecycle\",\n        platform: \"agent_action\",\n        state: \"active\",\n        observedAt,\n        idleState: \"active\",\n        idleTimeSeconds: 0,\n        onBattery: null,\n        health: null,\n        metadata: {\n          eventType: \"ACTION_STARTED\",\n          actionName,\n          messageId,\n          deviceId: getDeviceId(),\n        },\n      }),\n    );\n  }\n\n  private async captureActivityFromMessage(\n    eventType: EventType.MESSAGE_RECEIVED | EventType.MESSAGE_SENT,\n    payload: MessagePayload,\n  ): Promise<void> {\n    const entityId = readMessageEntityId(payload);\n    if (!entityId || entityId === String(this.runtime.agentId)) {\n      return;\n    }\n    const observedAt = readMessageTimestamp(payload);\n    const fingerprint = `${eventType}:${entityId}:${observedAt}`;\n    const observedMs = Date.parse(observedAt);\n    const existing = this.recentFingerprints.get(fingerprint);\n    if (\n      existing !== undefined &&\n      Number.isFinite(observedMs) &&\n      observedMs - existing < DEDUPE_WINDOW_MS\n    ) {\n      return;\n    }\n    if (Number.isFinite(observedMs)) {\n      this.recentFingerprints.set(fingerprint, observedMs);\n    }\n    const repository = new LifeOpsRepository(this.runtime);\n    await repository.createActivitySignal(\n      createLifeOpsActivitySignal({\n        agentId: String(this.runtime.agentId),\n        source: \"connector_activity\",\n        platform: readPlatform(payload),\n        state: \"active\",\n        observedAt,\n        idleState: null,\n        idleTimeSeconds: 0,\n        onBattery: null,\n        health: null,\n        metadata: {\n          eventType,\n          entityId,\n          deviceId: getDeviceId(),\n        },\n      }),\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/activity-profile/proactive-inbox-digest.d.ts

@@ -0,0 +1,3 @@
+import type { GetLifeOpsInboxRequest } from "@elizaos/shared";
+export declare function proactiveInboxDigestRequest(): GetLifeOpsInboxRequest;
+//# sourceMappingURL=proactive-inbox-digest.d.ts.map

package/dist/activity-profile/proactive-inbox-digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proactive-inbox-digest.d.ts","sourceRoot":"","sources":["../../src/activity-profile/proactive-inbox-digest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAc9D,wBAAgB,2BAA2B,IAAI,sBAAsB,CAKpE"}

package/dist/activity-profile/proactive-inbox-digest.js

@@ -0,0 +1,21 @@
+const PROACTIVE_INBOX_DIGEST_REQUEST = {
+  limit: 24,
+  // Chat connector memories do not carry reliable per-owner read state yet;
+  // the inbox layer conservatively marks them unread so explicit inbox views
+  // can still triage them. Proactive digests should only summarize channels
+  // with personal inbox semantics until chat read/mention state is grounded.
+  channels: ["gmail", "x_dm", "imessage", "whatsapp", "sms"],
+  groupByThread: true,
+  missedOnly: true,
+  sortByPriority: true
+};
+function proactiveInboxDigestRequest() {
+  return {
+    ...PROACTIVE_INBOX_DIGEST_REQUEST,
+    channels: [...PROACTIVE_INBOX_DIGEST_REQUEST.channels ?? []]
+  };
+}
+export {
+  proactiveInboxDigestRequest
+};
+//# sourceMappingURL=proactive-inbox-digest.js.map

package/dist/activity-profile/proactive-inbox-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/activity-profile/proactive-inbox-digest.ts"],"sourcesContent":["import type { GetLifeOpsInboxRequest } from \"@elizaos/shared\";\n\nconst PROACTIVE_INBOX_DIGEST_REQUEST = {\n  limit: 24,\n  // Chat connector memories do not carry reliable per-owner read state yet;\n  // the inbox layer conservatively marks them unread so explicit inbox views\n  // can still triage them. Proactive digests should only summarize channels\n  // with personal inbox semantics until chat read/mention state is grounded.\n  channels: [\"gmail\", \"x_dm\", \"imessage\", \"whatsapp\", \"sms\"],\n  groupByThread: true,\n  missedOnly: true,\n  sortByPriority: true,\n} satisfies GetLifeOpsInboxRequest;\n\nexport function proactiveInboxDigestRequest(): GetLifeOpsInboxRequest {\n  return {\n    ...PROACTIVE_INBOX_DIGEST_REQUEST,\n    channels: [...(PROACTIVE_INBOX_DIGEST_REQUEST.channels ?? [])],\n  };\n}\n"],"mappings":"AAEA,MAAM,iCAAiC;AAAA,EACrC,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA,EAKP,UAAU,CAAC,SAAS,QAAQ,YAAY,YAAY,KAAK;AAAA,EACzD,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,gBAAgB;AAClB;AAEO,SAAS,8BAAsD;AACpE,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU,CAAC,GAAI,+BAA+B,YAAY,CAAC,CAAE;AAAA,EAC/D;AACF;","names":[]}

package/dist/activity-profile/proactive-planner.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Pure decision logic for proactive agent actions (GM, GN, nudges).
+ * No runtime dependencies — fully unit-testable.
+ *
+ * Given an ActivityProfile + occurrence/calendar context, returns
+ * ProactiveAction[] describing what to send, when, and where.
+ */
+import type { ActivityProfile, FiredActionsLog, ProactiveAction } from "./types.js";
+/**
+ * Trailing window the social-overuse planner looks back over. The worker
+ * fetches `getSocialHabitSummary` over `[now - SOCIAL_OVERUSE_WINDOW_MINUTES,
+ * now]` and the planner trips when the windowed total clears the threshold.
+ */
+export declare const SOCIAL_OVERUSE_WINDOW_MINUTES = 90;
+/**
+ * Minimum total social-app minutes inside the trailing window required to
+ * fire a social_overuse_check intent.
+ */
+export declare const SOCIAL_OVERUSE_THRESHOLD_MINUTES = 60;
+/**
+ * Minimum gap between two consecutive social_overuse_check deliveries. The
+ * worker writes `socialOveruseCheckedAt` on every fire; the planner refuses
+ * to emit again until this much time has passed since the last write.
+ */
+export declare const SOCIAL_OVERUSE_COOLDOWN_MS: number;
+export interface GoalSlim {
+    id: string;
+    title: string;
+    status: string;
+    linkedDefinitionCount: number;
+    /** 0-1 completion rate over the last 7 days. */
+    recentCompletionRate: number;
+    /** ISO datetime of the last goal review, or null if never reviewed. */
+    lastReviewedAt: string | null;
+}
+export interface OccurrenceSlim {
+    id: string;
+    title: string;
+    dueAt: string | null;
+    state: string;
+    definitionKind?: "task" | "habit" | "routine";
+    cadence?: {
+        kind: "once" | "daily" | "times_per_day" | "interval" | "weekly";
+    };
+    priority?: number;
+}
+export interface CalendarEventSlim {
+    id: string;
+    summary: string;
+    startAt: string;
+    endAt: string;
+    isAllDay: boolean;
+    description?: string;
+    location?: string;
+    attendeeCount?: number;
+    conferenceLink?: string | null;
+    proactiveCheckIn?: boolean | null;
+    proactiveCheckInReason?: string | null;
+}
+export interface ProactiveRelativeTimeSlim {
+    wakeAnchorAt: string | null;
+    bedtimeTargetAt: string | null;
+    minutesSinceWake: number | null;
+    minutesUntilBedtimeTarget: number | null;
+}
+export interface InboxDigestHighlightSlim {
+    channel: string;
+    sender: string;
+    subject: string | null;
+    snippet: string;
+    receivedAt: string;
+    unread: boolean;
+}
+export interface InboxDigestSlim {
+    unreadCount: number;
+    channelCounts: Array<{
+        channel: string;
+        unreadCount: number;
+    }>;
+    highlights: InboxDigestHighlightSlim[];
+}
+/**
+ * Per-service totals consumed by `planSocialOveruseCheck`. Maps directly
+ * onto `LifeOpsSocialHabitSummary.services`/`.sessions` entries: each entry
+ * is one labelled bucket of social-app dwell time inside the trailing
+ * window the worker fetched.
+ */
+export interface SocialServiceBucketSlim {
+    key: string;
+    label: string;
+    totalSeconds: number;
+}
+export interface SocialHabitSummarySlim {
+    /** Total social-bucket dwell seconds inside the trailing window. */
+    totalSeconds: number;
+    /** Per-service breakdown, sorted by `totalSeconds` descending. */
+    services: SocialServiceBucketSlim[];
+}
+export declare function planGm(profile: ActivityProfile, occurrences: OccurrenceSlim[], calendarEvents: CalendarEventSlim[], relativeTime: ProactiveRelativeTimeSlim | null, inboxDigest: InboxDigestSlim | null, firedToday: FiredActionsLog | null, timezone: string, now?: Date): ProactiveAction | null;
+/**
+ * Plan a "good night" proactive action — the activity-feed counterpart to the
+ * authoritative night summary.
+ *
+ * Division of responsibility (intentional, do NOT consolidate without a
+ * routing-layer design review):
+ *
+ * - **Chat surface (the user-visible night summary):** owned by
+ *   `processSleepCycleCheckins` →
+ *   `CheckinService.runNightCheckin` (`plugins/plugin-personal-assistant/src/lifeops/checkin/checkin-service.ts`).
+ *   That path collects briefing sections (X DMs, Gmail, GitHub, calendar,
+ *   contacts, promises, habit summaries, sleep recap), runs them through
+ *   `useModel(TEXT_LARGE, ...)`, and persists a `CheckinReport`. Anti-spam
+ *   is the once-per-local-day SQL gate against `life_checkin_reports`. The
+ *   resulting `lifeops-checkin` event is **not** in
+ *   `CHAT_SUPPRESSED_AUTONOMY_SOURCES`, so it lands in the active
+ *   conversation.
+ *
+ * - **Activity-feed surface (this function):** plans a `proactive-gn`
+ *   action with a compact deterministic message for the activity timeline.
+ *   The `proactive-gn` source **is** in `CHAT_SUPPRESSED_AUTONOMY_SOURCES`
+ *   (`packages/agent/src/api/server-helpers-swarm.ts`), so this never
+ *   posts to chat — it only powers the activity-feed widget. Anti-spam is
+ *   a separate 12h `firedRecently` timestamp gate (`firedToday.gnFiredAt`).
+ *
+ * Both paths are scheduled off the same `bedtimeTargetAt` source but
+ * diverge on window (3h vs 2h), gate (per-day SQL vs 12h timestamp),
+ * content (LLM briefing vs compact feed message), and chat-suppression. They
+ * are not redundant: the chat night summary is the user-visible artifact;
+ * this is feed-only telemetry. A unifying sweep needs a routing-layer redesign
+ * (collapse the two sources, then choose a single content path), not just a
+ * delete here.
+ */
+export declare function planGn(profile: ActivityProfile, relativeTime: ProactiveRelativeTimeSlim | null, inboxDigest: InboxDigestSlim | null, firedToday: FiredActionsLog | null, timezone: string, now?: Date): ProactiveAction | null;
+export declare function planNudges(profile: ActivityProfile, occurrences: OccurrenceSlim[], calendarEvents: CalendarEventSlim[], firedToday: FiredActionsLog | null, timezone: string, now?: Date): ProactiveAction[];
+export declare function planDowntimeNudges(profile: ActivityProfile, occurrences: OccurrenceSlim[], calendarEvents: CalendarEventSlim[], firedToday: FiredActionsLog | null, timezone: string, now?: Date): ProactiveAction[];
+export declare function planGoalCheckIns(profile: ActivityProfile, goals: GoalSlim[], firedToday: FiredActionsLog | null, _timezone: string, now?: Date): ProactiveAction[];
+/**
+ * Decide whether to interrupt the user with a "you've been on {app} for a
+ * while, you good?" intent. Pure: takes a slim social-habit summary scoped
+ * to the trailing `SOCIAL_OVERUSE_WINDOW_MINUTES` and returns a single
+ * pending action when the threshold + cooldown are both satisfied.
+ *
+ * Scope: emits the proactive check-in prompt only. Follow-up replies such as
+ * asking to block the app or suggest a task are normal user intents handled by
+ * LifeOps actions after the owner responds; they are deliberately outside this
+ * pure planner.
+ */
+export declare function planSocialOveruseCheck(profile: ActivityProfile, socialSummary: SocialHabitSummarySlim, firedToday: FiredActionsLog | null, _timezone: string, now?: Date): ProactiveAction | null;
+export declare function selectTargetPlatform(profile: ActivityProfile, preferCurrent: boolean): string;
+//# sourceMappingURL=proactive-planner.d.ts.map

package/dist/activity-profile/proactive-planner.d.ts.map

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