@elizaos/shared 2.0.0-alpha.538 → 2.0.3-beta.2

package/contracts/permissions.js

@@ -1,5 +1,41 @@
 /**
  * Shared system permission contracts.
+ *
+ * `PermissionId` is the canonical union covering OS integrations across
+ * macOS / win32 / linux / iOS / Android / web.
  */
-export {};
+export const PERMISSION_IDS = [
+    "screen-recording",
+    "accessibility",
+    "reminders",
+    "calendar",
+    "health",
+    "screentime",
+    "contacts",
+    "notes",
+    "microphone",
+    "camera",
+    "location",
+    "shell",
+    "website-blocking",
+    "notifications",
+    "full-disk",
+    "automation",
+    "speech-recognition",
+    "photos",
+    "phone",
+    "messages",
+    "wifi",
+    "bluetooth",
+    "app-blocking",
+    "usage-access",
+    "overlay",
+    "write-settings",
+    "local-network",
+    "battery-optimization",
+];
+export function isPermissionId(value) {
+    return (typeof value === "string" &&
+        PERMISSION_IDS.includes(value));
+}
 //# sourceMappingURL=permissions.js.map

package/contracts/permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/contracts/permissions.ts"],"names":[],"mappings":"AAAA;;GAEG"}
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/contracts/permissions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0CH,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,kBAAkB;IAClB,eAAe;IACf,WAAW;IACX,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,OAAO;IACP,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,OAAO;IACP,kBAAkB;IAClB,eAAe;IACf,WAAW;IACX,YAAY;IACZ,oBAAoB;IACpB,QAAQ;IACR,OAAO;IACP,UAAU;IACV,MAAM;IACN,WAAW;IACX,cAAc;IACd,cAAc;IACd,SAAS;IACT,gBAAgB;IAChB,eAAe;IACf,sBAAsB;CACd,CAAC;AAEX,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CACtD,CAAC;AACJ,CAAC"}

package/contracts/{lifeops.d.ts → personal-assistant.d.ts}

@@ -1,4 +1,6 @@
+import type { GetLifeOpsCalendarFeedRequest, LifeOpsCalendarEventEndedFilters } from "./calendar.js";
 import type { LifeOpsConnectorDegradation } from "./lifeops-connector-degradation.js";
+export * from "./calendar.js";
 export type { LifeOpsConnectorDegradation, LifeOpsConnectorDegradationAxis, } from "./lifeops-connector-degradation.js";
 export { LIFEOPS_CONNECTOR_DEGRADATION_AXES } from "./lifeops-connector-degradation.js";
 export declare const LIFEOPS_TIME_WINDOW_NAMES: readonly ["morning", "afternoon", "evening", "night", "custom"];
@@ -29,16 +31,6 @@ export type LifeOpsWorkflowTriggerType = (typeof LIFEOPS_WORKFLOW_TRIGGER_TYPES)
  */
 export declare const LIFEOPS_EVENT_KINDS: readonly ["calendar.event.ended", "gmail.message.received", "gmail.thread.needs_response", "lifeops.sleep.onset_candidate", "lifeops.sleep.detected", "lifeops.sleep.ended", "lifeops.wake.observed", "lifeops.wake.confirmed", "lifeops.nap.detected", "lifeops.bedtime.imminent", "lifeops.regularity.changed"];
 export type LifeOpsEventKind = (typeof LIFEOPS_EVENT_KINDS)[number];
-export interface LifeOpsCalendarEventEndedFilters {
-    /** Only fire for events on these calendar ids (e.g. "primary"). */
-    calendarIds?: string[];
-    /** Only fire when event title matches one of these case-insensitive substrings. */
-    titleIncludesAny?: string[];
-    /** Only fire when the event lasted at least this many minutes. */
-    minDurationMinutes?: number;
-    /** Only fire when one attendee email contains one of these substrings. */
-    attendeeEmailIncludesAny?: string[];
-}
 export interface LifeOpsGmailEventFilters {
     /** Only fire for these Google connector grant ids. */
     grantIds?: string[];
@@ -147,7 +139,7 @@ export interface LifeOpsSchedulingProposal {
     createdAt: string;
     updatedAt: string;
 }
-export declare const LIFEOPS_CONNECTOR_PROVIDERS: readonly ["google", "x", "telegram", "discord", "twilio", "signal", "whatsapp", "imessage", "strava", "fitbit", "withings", "oura"];
+export declare const LIFEOPS_CONNECTOR_PROVIDERS: readonly ["google", "x", "telegram", "discord", "twilio", "signal", "whatsapp", "imessage", "apple_calendar", "strava", "fitbit", "withings", "oura"];
 export type LifeOpsConnectorProvider = (typeof LIFEOPS_CONNECTOR_PROVIDERS)[number];
 export declare const LIFEOPS_CONNECTOR_MODES: readonly ["local", "remote", "cloud_managed"];
 export type LifeOpsConnectorMode = (typeof LIFEOPS_CONNECTOR_MODES)[number];
@@ -155,7 +147,7 @@ export declare const LIFEOPS_CONNECTOR_SIDES: readonly ["owner", "agent"];
 export type LifeOpsConnectorSide = (typeof LIFEOPS_CONNECTOR_SIDES)[number];
 export declare const LIFEOPS_CONNECTOR_EXECUTION_TARGETS: readonly ["local", "cloud"];
 export type LifeOpsConnectorExecutionTarget = (typeof LIFEOPS_CONNECTOR_EXECUTION_TARGETS)[number];
-export declare const LIFEOPS_CONNECTOR_SOURCES_OF_TRUTH: readonly ["local_storage", "cloud_connection"];
+export declare const LIFEOPS_CONNECTOR_SOURCES_OF_TRUTH: readonly ["local_storage", "cloud_connection", "connector_account"];
 export type LifeOpsConnectorSourceOfTruth = (typeof LIFEOPS_CONNECTOR_SOURCES_OF_TRUTH)[number];
 export declare const LIFEOPS_GOOGLE_CAPABILITIES: readonly ["google.basic_identity", "google.calendar.read", "google.calendar.write", "google.gmail.triage", "google.gmail.send", "google.gmail.manage"];
 export type LifeOpsGoogleCapability = (typeof LIFEOPS_GOOGLE_CAPABILITIES)[number];
@@ -541,7 +533,7 @@ export type LifeOpsWorkflowAction = (LifeOpsWorkflowActionBase & {
     kind: "get_health_summary";
     request?: GetLifeOpsHealthSummaryRequest;
 }) | (LifeOpsWorkflowActionBase & {
-    kind: "dispatch_n8n_workflow";
+    kind: "dispatch_workflow";
     workflowId: string;
     payload?: Record<string, unknown>;
 }) | (LifeOpsWorkflowActionBase & {
@@ -580,6 +572,8 @@ export interface LifeOpsConnectorGrant {
     id: string;
     agentId: string;
     provider: LifeOpsConnectorProvider;
+    /** LifeOps-owned stable account key; grant id remains legacy credential state. */
+    connectorAccountId?: string | null;
     side: LifeOpsConnectorSide;
     identity: Record<string, unknown>;
     identityEmail?: string | null;
@@ -926,6 +920,23 @@ export interface LifeOpsManualOverridePayload {
 export type LifeOpsTelemetryPayload = LifeOpsDevicePresencePayload | LifeOpsDesktopPowerPayload | LifeOpsDesktopIdleSamplePayload | LifeOpsBrowserFocusPayload | LifeOpsMobileHealthPayload | LifeOpsMobileDevicePayload | LifeOpsMessageActivityPayload | LifeOpsStatusActivityPayload | LifeOpsChargingPayload | LifeOpsScreenTimeSummaryPayload | LifeOpsManualOverridePayload;
 export type LifeOpsTelemetryFamily = LifeOpsTelemetryPayload["family"];
 export declare const LIFEOPS_TELEMETRY_FAMILIES: readonly LifeOpsTelemetryFamily[];
+/**
+ * Open-string bus-family identifier (W2-D).
+ *
+ * The closed `LifeOpsTelemetryFamily` union above retains the schema
+ * discriminant for the 11 built-in telemetry payloads. The bus layer surfaces
+ * additional namespaced families contributed by other plugins (e.g.
+ * `health.sleep.detected` from `@elizaos/plugin-health`,
+ * `calendar.meeting.ended` from app-lifeops calendar). Those families are
+ * validated at runtime via the FamilyRegistry rather than statically through
+ * a closed union — the union would otherwise need to grow every time a
+ * plugin contributes a new event family.
+ *
+ * Convention:
+ *   - built-ins: lower-snake-case (`device_presence_event`).
+ *   - namespaced contributions: dotted, lower-case (`health.sleep.detected`).
+ */
+export type LifeOpsBusFamily = LifeOpsTelemetryFamily | string;
 export interface LifeOpsTelemetryEnvelope {
     id: string;
     agentId: string;
@@ -1192,108 +1203,6 @@ export interface LifeOpsOverview {
     agentOps: LifeOpsOverviewSection;
     schedule: LifeOpsScheduleInsight | null;
 }
-export interface LifeOpsCalendarEventAttendee {
-    email: string | null;
-    displayName: string | null;
-    responseStatus: string | null;
-    self: boolean;
-    organizer: boolean;
-    optional: boolean;
-}
-export interface LifeOpsCalendarEvent {
-    id: string;
-    externalId: string;
-    agentId: string;
-    provider: "google";
-    side: LifeOpsConnectorSide;
-    calendarId: string;
-    title: string;
-    description: string;
-    location: string;
-    status: string;
-    startAt: string;
-    endAt: string;
-    isAllDay: boolean;
-    timezone: string | null;
-    htmlLink: string | null;
-    conferenceLink: string | null;
-    organizer: Record<string, unknown> | null;
-    attendees: LifeOpsCalendarEventAttendee[];
-    metadata: Record<string, unknown>;
-    syncedAt: string;
-    updatedAt: string;
-    /** Set on merged feeds so the UI can show which calendar an event came from. */
-    calendarSummary?: string;
-    /** Google grant that owns this Gmail message cache row. */
-    grantId?: string;
-    /** Email address for the owning Google account when known. */
-    accountEmail?: string;
-}
-export interface LifeOpsCalendarFeed {
-    calendarId: string;
-    events: LifeOpsCalendarEvent[];
-    source: "cache" | "synced";
-    timeMin: string;
-    timeMax: string;
-    syncedAt: string | null;
-}
-/**
- * Summary of one Google Calendar the user has access to (from calendarList.list).
- * `includeInFeed` reflects whether the user has opted this calendar into the
- * aggregated sidebar feed / briefing. Defaults to true for every calendar the
- * user can see — opt-out, never opt-in, so new calendars are not silently
- * hidden from the agent's picture of the user's life.
- */
-export interface LifeOpsCalendarSummary {
-    provider: "google";
-    side: LifeOpsConnectorSide;
-    grantId: string;
-    accountEmail: string | null;
-    calendarId: string;
-    summary: string;
-    description: string | null;
-    primary: boolean;
-    accessRole: string;
-    backgroundColor: string | null;
-    foregroundColor: string | null;
-    timeZone: string | null;
-    selected: boolean;
-    includeInFeed: boolean;
-}
-export interface ListLifeOpsCalendarsRequest {
-    side?: LifeOpsConnectorSide;
-    mode?: LifeOpsConnectorMode;
-    grantId?: string;
-}
-export interface ListLifeOpsCalendarsResponse {
-    calendars: LifeOpsCalendarSummary[];
-}
-export interface SetLifeOpsCalendarIncludedRequest {
-    calendarId: string;
-    includeInFeed: boolean;
-    side?: LifeOpsConnectorSide;
-    mode?: LifeOpsConnectorMode;
-    grantId?: string;
-}
-export interface SetLifeOpsCalendarIncludedResponse {
-    calendar: LifeOpsCalendarSummary;
-}
-export interface GetLifeOpsCalendarFeedRequest {
-    side?: LifeOpsConnectorSide;
-    mode?: LifeOpsConnectorMode;
-    /** Target a specific Google account by grant ID (multi-account). */
-    grantId?: string;
-    calendarId?: string;
-    /**
-     * Internal/agent override: when no calendarId is specified, include every
-     * authorized calendar instead of only the user's feed-enabled subset.
-     */
-    includeHiddenCalendars?: boolean;
-    timeMin?: string;
-    timeMax?: string;
-    timeZone?: string;
-    forceSync?: boolean;
-}
 export interface LifeOpsGmailMessageSummary {
     id: string;
     externalId: string;
@@ -1319,6 +1228,8 @@ export interface LifeOpsGmailMessageSummary {
     metadata: Record<string, unknown>;
     syncedAt: string;
     updatedAt: string;
+    /** LifeOps-owned account key for privacy egress; legacy cache rows may omit it until purge/resync. */
+    connectorAccountId?: string;
     /** Set when aggregating across multiple Google accounts. */
     grantId?: string;
     /** Set when aggregating across multiple Google accounts. */
@@ -1730,57 +1641,6 @@ export interface LifeOpsGmailBatchReplySendResult {
     ok: true;
     sentCount: number;
 }
-export declare const LIFEOPS_CALENDAR_WINDOW_PRESETS: readonly ["tomorrow_morning", "tomorrow_afternoon", "tomorrow_evening"];
-export type LifeOpsCalendarWindowPreset = (typeof LIFEOPS_CALENDAR_WINDOW_PRESETS)[number];
-export interface CreateLifeOpsCalendarEventAttendee {
-    email: string;
-    displayName?: string;
-    optional?: boolean;
-}
-export interface CreateLifeOpsCalendarEventRequest {
-    side?: LifeOpsConnectorSide;
-    mode?: LifeOpsConnectorMode;
-    calendarId?: string;
-    grantId?: string;
-    title: string;
-    description?: string;
-    location?: string;
-    startAt?: string;
-    endAt?: string;
-    timeZone?: string;
-    durationMinutes?: number;
-    windowPreset?: LifeOpsCalendarWindowPreset;
-    attendees?: CreateLifeOpsCalendarEventAttendee[];
-}
-export interface LifeOpsNextCalendarEventContext {
-    event: LifeOpsCalendarEvent | null;
-    startsAt: string | null;
-    startsInMinutes: number | null;
-    attendeeCount: number;
-    attendeeNames: string[];
-    location: string | null;
-    conferenceLink: string | null;
-    preparationChecklist: string[];
-    linkedMailState: "unavailable" | "cache" | "synced" | "error";
-    linkedMailError: string | null;
-    linkedMail: Array<Pick<LifeOpsGmailMessageSummary, "id" | "subject" | "from" | "receivedAt" | "snippet" | "htmlLink">>;
-}
-export interface LifeOpsCalendarEventUpdate {
-    side?: LifeOpsConnectorSide;
-    mode?: LifeOpsConnectorMode;
-    grantId?: string;
-    calendarId?: string;
-    title?: string;
-    startAt?: string;
-    endAt?: string;
-    timeZone?: string;
-    notes?: string;
-    location?: string;
-    attendees?: CreateLifeOpsCalendarEventAttendee[];
-}
-export interface LifeOpsCalendarEventMutationResult {
-    event: LifeOpsCalendarEvent;
-}
 export declare const LIFEOPS_INBOX_CHANNELS: readonly ["gmail", "x_dm", "discord", "telegram", "signal", "imessage", "whatsapp", "sms"];
 export type LifeOpsInboxChannel = (typeof LIFEOPS_INBOX_CHANNELS)[number];
 export interface LifeOpsInboxMessageSender {
@@ -1792,6 +1652,12 @@ export interface LifeOpsInboxMessageSender {
 export interface LifeOpsInboxMessageSourceRef {
     channel: LifeOpsInboxChannel;
     externalId: string;
+    /** Local messaging identity that received/sent this item, when known. */
+    phoneAccountId?: string;
+    /** Human-readable label for the local phone identity. */
+    phoneAccountLabel?: string;
+    /** E.164-ish phone number for the local identity, when known. */
+    phoneNumber?: string;
 }
 export interface LifeOpsInboxMessage {
     /** Channel-prefixed, globally unique identifier. */
@@ -1810,6 +1676,14 @@ export interface LifeOpsInboxMessage {
     threadId?: string;
     /** Present on Gmail messages when multiple accounts exist; identifies which Google grant the message came from. */
     gmailAccountId?: string;
+    /** Present on phone-backed messages when the local connector can identify which phone identity handled it. */
+    phoneAccountId?: string;
+    /** Display label for the local phone identity, e.g. `Gateway (+1...)`. */
+    phoneAccountLabel?: string;
+    /** Local phone number that handled the message, when known. */
+    phoneNumber?: string;
+    /** LifeOps-owned account key for privacy egress. */
+    connectorAccountId?: string;
     /** Display label for the Gmail account (e.g., `work@example.com`). */
     gmailAccountEmail?: string;
     /** ISO timestamp of when the user last viewed this thread (UI updates on open). */
@@ -1873,6 +1747,8 @@ export interface GetLifeOpsInboxRequest {
     maxParticipants?: number;
     /** Filter to a specific Google grant. */
     gmailAccountId?: string;
+    /** Filter phone-backed channels to one or more local phone identities. */
+    phoneAccountIds?: string[];
     /**
      * When true, only return messages where the user has not replied for >24h
      * and the priority score is at least 50. Applies at both the message and
@@ -1977,8 +1853,8 @@ export interface SendLifeOpsSignalMessageResponse {
     timestamp: number;
 }
 /**
- * A single inbound Signal message as returned by {@link readSignalInbound} and
- * the signal-local-client reader.
+ * A single inbound Signal message as returned by {@link readSignalInbound} or
+ * the plugin-signal local client.
  */
 export interface LifeOpsSignalInboundMessage {
     /** Stable message ID (from the Signal service memory store or signal-cli). */
@@ -2729,5 +2605,327 @@ export interface LifeOpsPersonalBaselineResponse {
     sampleSize: number;
     windowDays: number;
 }
-export * from "./lifeops-extensions.js";
-//# sourceMappingURL=lifeops.d.ts.map
+export declare const LIFEOPS_MESSAGE_CHANNELS: readonly ["email", "telegram", "discord", "signal", "sms", "twilio_voice", "imessage", "whatsapp", "x_dm"];
+export type LifeOpsMessageChannel = (typeof LIFEOPS_MESSAGE_CHANNELS)[number];
+export declare const LIFEOPS_FOLLOW_UP_STATUSES: readonly ["pending", "completed", "snoozed", "cancelled"];
+export type LifeOpsFollowUpStatus = (typeof LIFEOPS_FOLLOW_UP_STATUSES)[number];
+export declare const LIFEOPS_X_FEED_TYPES: readonly ["home_timeline", "mentions", "search"];
+export type LifeOpsXFeedType = (typeof LIFEOPS_X_FEED_TYPES)[number];
+export interface LifeOpsRelationship {
+    id: string;
+    agentId: string;
+    name: string;
+    primaryChannel: string;
+    primaryHandle: string;
+    email: string | null;
+    phone: string | null;
+    notes: string;
+    tags: string[];
+    relationshipType: string;
+    lastContactedAt: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LifeOpsRelationshipInteraction {
+    id: string;
+    agentId: string;
+    relationshipId: string;
+    channel: string;
+    direction: "inbound" | "outbound";
+    summary: string;
+    occurredAt: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+export interface LifeOpsFollowUp {
+    id: string;
+    agentId: string;
+    relationshipId: string;
+    dueAt: string;
+    reason: string;
+    status: LifeOpsFollowUpStatus;
+    priority: number;
+    draft: LifeOpsCrossChannelDraft | null;
+    completedAt: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LifeOpsCrossChannelDraft {
+    channel: LifeOpsMessageChannel;
+    target: string;
+    subject: string | null;
+    body: string;
+    metadata: Record<string, unknown>;
+}
+export interface LifeOpsCrossChannelSendRequest {
+    draft: LifeOpsCrossChannelDraft;
+    confirmed: boolean;
+}
+export interface LifeOpsXDm {
+    id: string;
+    agentId: string;
+    externalDmId: string;
+    conversationId: string;
+    senderHandle: string;
+    senderId: string;
+    isInbound: boolean;
+    text: string;
+    receivedAt: string;
+    readAt: string | null;
+    repliedAt: string | null;
+    metadata: Record<string, unknown>;
+    syncedAt: string;
+    updatedAt: string;
+}
+export interface LifeOpsXFeedItem {
+    id: string;
+    agentId: string;
+    externalTweetId: string;
+    authorHandle: string;
+    authorId: string;
+    text: string;
+    createdAtSource: string;
+    feedType: LifeOpsXFeedType;
+    metadata: Record<string, unknown>;
+    syncedAt: string;
+    updatedAt: string;
+}
+export interface LifeOpsXSyncState {
+    id: string;
+    agentId: string;
+    feedType: LifeOpsXFeedType;
+    lastCursor: string | null;
+    syncedAt: string;
+    updatedAt: string;
+}
+export interface LifeOpsScreenTimeSession {
+    id: string;
+    agentId: string;
+    source: "app" | "website";
+    identifier: string;
+    displayName: string;
+    startAt: string;
+    endAt: string | null;
+    durationSeconds: number;
+    isActive: boolean;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LifeOpsScreenTimeDaily {
+    id: string;
+    agentId: string;
+    source: "app" | "website";
+    identifier: string;
+    date: string;
+    totalSeconds: number;
+    sessionCount: number;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export type LifeOpsScreenTimeSource = "app" | "website";
+export type LifeOpsScreenTimeRangeKey = "today" | "this-week" | "7d" | "30d";
+export declare const LIFEOPS_SCREEN_TIME_RANGES: readonly ["today", "this-week", "7d", "30d"];
+export interface LifeOpsScreenTimeSummaryRequest {
+    since: string;
+    until: string;
+    source?: LifeOpsScreenTimeSource;
+    identifier?: string;
+    topN?: number;
+}
+export interface LifeOpsScreenTimeSummaryItem {
+    source: LifeOpsScreenTimeSource;
+    identifier: string;
+    displayName: string;
+    totalSeconds: number;
+}
+export interface LifeOpsScreenTimeSummary {
+    items: LifeOpsScreenTimeSummaryItem[];
+    totalSeconds: number;
+}
+export type LifeOpsHabitCategory = "browser" | "communication" | "social" | "system" | "video" | "work" | "other";
+export type LifeOpsHabitDevice = "browser" | "computer" | "phone" | "tablet" | "unknown";
+export interface LifeOpsScreenTimeBucket {
+    key: string;
+    label: string;
+    totalSeconds: number;
+}
+export interface LifeOpsScreenTimeBreakdownItem extends LifeOpsScreenTimeSummaryItem {
+    sessionCount: number;
+    category: LifeOpsHabitCategory;
+    device: LifeOpsHabitDevice;
+    service: string | null;
+    serviceLabel: string | null;
+    browser: string | null;
+}
+export interface LifeOpsScreenTimeBreakdown {
+    items: LifeOpsScreenTimeBreakdownItem[];
+    totalSeconds: number;
+    bySource: LifeOpsScreenTimeBucket[];
+    byCategory: LifeOpsScreenTimeBucket[];
+    byDevice: LifeOpsScreenTimeBucket[];
+    byService: LifeOpsScreenTimeBucket[];
+    byBrowser: LifeOpsScreenTimeBucket[];
+    fetchedAt: string;
+}
+export interface LifeOpsSocialMessageChannel {
+    channel: "x_dm";
+    label: string;
+    inbound: number;
+    outbound: number;
+    opened: number;
+    replied: number;
+}
+export type LifeOpsSocialHabitDataSourceState = "live" | "partial" | "unwired";
+export interface LifeOpsSocialHabitDataSource {
+    id: string;
+    label: string;
+    state: LifeOpsSocialHabitDataSourceState;
+    statusLabel: string;
+    detail: string;
+}
+export interface LifeOpsSocialHabitSummary {
+    since: string;
+    until: string;
+    totalSeconds: number;
+    services: LifeOpsScreenTimeBucket[];
+    devices: LifeOpsScreenTimeBucket[];
+    surfaces: LifeOpsScreenTimeBucket[];
+    browsers: LifeOpsScreenTimeBucket[];
+    sessions: LifeOpsScreenTimeBreakdownItem[];
+    messages: {
+        channels: LifeOpsSocialMessageChannel[];
+        inbound: number;
+        outbound: number;
+        opened: number;
+        replied: number;
+    };
+    dataSources: LifeOpsSocialHabitDataSource[];
+    fetchedAt: string;
+}
+export interface LifeOpsScreenTimeWindow {
+    since: string;
+    until: string;
+}
+export interface LifeOpsScreenTimeHistoryPoint extends LifeOpsScreenTimeWindow {
+    date: string;
+    label: string;
+    totalSeconds: number;
+}
+export interface LifeOpsScreenTimeDeltaMetrics {
+    totalPercent: number | null;
+    appPercent: number | null;
+    webPercent: number | null;
+    phonePercent: number | null;
+    socialPercent: number | null;
+    youtubePercent: number | null;
+    xPercent: number | null;
+    messageOpenedPercent: number | null;
+}
+export interface LifeOpsScreenTimeMetrics {
+    totalSeconds: number;
+    appSeconds: number;
+    webSeconds: number;
+    phoneSeconds: number;
+    socialSeconds: number;
+    youtubeSeconds: number;
+    xSeconds: number;
+    messageOpened: number;
+    messageOutbound: number;
+    messageInbound: number;
+    deltas: LifeOpsScreenTimeDeltaMetrics | null;
+}
+export interface LifeOpsScreenTimeTargetBucket extends LifeOpsScreenTimeBucket {
+    source: LifeOpsScreenTimeSource;
+    identifier: string;
+}
+export interface LifeOpsScreenTimeSessionBucket extends LifeOpsScreenTimeBucket {
+    source: LifeOpsScreenTimeSource;
+    identifier: string;
+}
+export interface LifeOpsScreenTimeVisibleBuckets {
+    categories: LifeOpsScreenTimeBucket[];
+    devices: LifeOpsScreenTimeBucket[];
+    browsers: LifeOpsScreenTimeBucket[];
+    services: LifeOpsScreenTimeBucket[];
+    surfaces: LifeOpsScreenTimeBucket[];
+    topTargets: LifeOpsScreenTimeTargetBucket[];
+    sessionBuckets: LifeOpsScreenTimeSessionBucket[];
+    channels: LifeOpsSocialMessageChannel[];
+    setupSources: LifeOpsSocialHabitDataSource[];
+    hasMessageActivity: boolean;
+    hasUsage: boolean;
+}
+export interface LifeOpsScreenTimeHistoryResponse {
+    range: LifeOpsScreenTimeRangeKey;
+    label: string;
+    window: LifeOpsScreenTimeWindow;
+    priorWindow: LifeOpsScreenTimeWindow | null;
+    breakdown: LifeOpsScreenTimeBreakdown;
+    social: LifeOpsSocialHabitSummary;
+    history: LifeOpsScreenTimeHistoryPoint[];
+    metrics: LifeOpsScreenTimeMetrics;
+    visible: LifeOpsScreenTimeVisibleBuckets;
+    fetchedAt: string;
+}
+export type LifeOpsIMessageHostPlatform = "darwin" | "linux" | "win32" | "unknown";
+export interface LifeOpsIMessageConnectorStatus {
+    available: boolean;
+    connected: boolean;
+    bridgeType: "native" | "imsg" | "bluebubbles" | "none";
+    hostPlatform: LifeOpsIMessageHostPlatform;
+    accountHandle: string | null;
+    sendMode: "cli" | "private-api" | "apple-script" | "none";
+    helperConnected: boolean | null;
+    privateApiEnabled: boolean | null;
+    diagnostics: string[];
+    lastSyncAt: string | null;
+    lastCheckedAt: string | null;
+    error: string | null;
+    chatDbAvailable?: boolean;
+    sendOnly?: boolean;
+    chatDbPath?: string;
+    reason?: string | null;
+    permissionAction?: {
+        type: "full_disk_access";
+        label: string;
+        url: string;
+        instructions: string[];
+    } | null;
+    degradations?: LifeOpsConnectorDegradation[];
+}
+export interface LifeOpsIMessageChat {
+    id: string;
+    name: string;
+    participants: string[];
+    lastMessageAt?: string;
+}
+export interface LifeOpsIMessageMessage {
+    id: string;
+    fromHandle: string;
+    toHandles: string[];
+    text: string;
+    isFromMe: boolean;
+    sentAt: string;
+    chatId?: string;
+    attachments?: Array<{
+        name: string;
+        mimeType?: string;
+        path?: string;
+    }>;
+}
+export interface GetLifeOpsIMessageMessagesRequest {
+    chatId?: string;
+    since?: string;
+    limit?: number;
+}
+export interface SendLifeOpsIMessageRequest {
+    to: string;
+    text: string;
+    attachmentPaths?: string[];
+}
+export type { Entity as LifeOpsEntity, EntityAttribute as LifeOpsEntityAttribute, EntityIdentity as LifeOpsEntityIdentity, EntityIdentityAddedVia as LifeOpsEntityIdentityAddedVia, EntityState as LifeOpsEntityState, EntityVisibility as LifeOpsEntityVisibility, Relationship as LifeOpsGraphRelationship, RelationshipSource as LifeOpsGraphRelationshipSource, RelationshipState as LifeOpsGraphRelationshipState, RelationshipStatus as LifeOpsGraphRelationshipStatus, } from "../knowledge-graph/index.js";
+//# sourceMappingURL=personal-assistant.d.ts.map