@elizaos/shared 2.0.0-alpha.442 → 2.0.0-alpha.502

package/contracts/lifeops.d.ts

@@ -147,7 +147,7 @@ export interface LifeOpsSchedulingProposal {
     createdAt: string;
     updatedAt: string;
 }
-export declare const LIFEOPS_CONNECTOR_PROVIDERS: readonly ["google", "x", "telegram", "discord", "twilio", "signal", "whatsapp", "imessage"];
+export declare const LIFEOPS_CONNECTOR_PROVIDERS: readonly ["google", "x", "telegram", "discord", "twilio", "signal", "whatsapp", "imessage", "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];
@@ -161,6 +161,12 @@ export declare const LIFEOPS_GOOGLE_CAPABILITIES: readonly ["google.basic_identi
 export type LifeOpsGoogleCapability = (typeof LIFEOPS_GOOGLE_CAPABILITIES)[number];
 export declare const LIFEOPS_X_CAPABILITIES: readonly ["x.read", "x.write", "x.dm.read", "x.dm.write"];
 export type LifeOpsXCapability = (typeof LIFEOPS_X_CAPABILITIES)[number];
+export declare const LIFEOPS_HEALTH_CONNECTOR_PROVIDERS: readonly ["strava", "fitbit", "withings", "oura"];
+export type LifeOpsHealthConnectorProvider = (typeof LIFEOPS_HEALTH_CONNECTOR_PROVIDERS)[number];
+export declare const LIFEOPS_HEALTH_CONNECTOR_CAPABILITIES: readonly ["health.activity.read", "health.workouts.read", "health.sleep.read", "health.readiness.read", "health.body.read", "health.vitals.read"];
+export type LifeOpsHealthConnectorCapability = (typeof LIFEOPS_HEALTH_CONNECTOR_CAPABILITIES)[number];
+export declare const LIFEOPS_HEALTH_METRICS: readonly ["steps", "active_minutes", "sleep_hours", "sleep_score", "readiness_score", "heart_rate", "resting_heart_rate", "heart_rate_variability", "calories", "distance_meters", "weight_kg", "body_fat_percent", "blood_pressure_systolic", "blood_pressure_diastolic", "blood_oxygen_percent", "respiratory_rate", "body_temperature_celsius"];
+export type LifeOpsHealthMetric = (typeof LIFEOPS_HEALTH_METRICS)[number];
 export declare const LIFEOPS_SIGNAL_CAPABILITIES: readonly ["signal.read", "signal.send"];
 export type LifeOpsSignalCapability = (typeof LIFEOPS_SIGNAL_CAPABILITIES)[number];
 export declare const LIFEOPS_DISCORD_CAPABILITIES: readonly ["discord.read", "discord.send"];
@@ -531,6 +537,9 @@ export type LifeOpsWorkflowAction = (LifeOpsWorkflowActionBase & {
 }) | (LifeOpsWorkflowActionBase & {
     kind: "get_gmail_unresponded";
     request?: GetLifeOpsGmailUnrespondedRequest;
+}) | (LifeOpsWorkflowActionBase & {
+    kind: "get_health_summary";
+    request?: GetLifeOpsHealthSummaryRequest;
 }) | (LifeOpsWorkflowActionBase & {
     kind: "dispatch_n8n_workflow";
     workflowId: string;
@@ -570,6 +579,7 @@ export interface LifeOpsConnectorGrant {
     provider: LifeOpsConnectorProvider;
     side: LifeOpsConnectorSide;
     identity: Record<string, unknown>;
+    identityEmail?: string | null;
     grantedScopes: string[];
     capabilities: string[];
     tokenRef: string | null;
@@ -601,7 +611,7 @@ export declare const LIFEOPS_ACTIVITY_SIGNAL_SOURCES: readonly ["app_lifecycle",
 export type LifeOpsActivitySignalSource = (typeof LIFEOPS_ACTIVITY_SIGNAL_SOURCES)[number];
 export declare const LIFEOPS_ACTIVITY_SIGNAL_STATES: readonly ["active", "idle", "background", "locked", "sleeping"];
 export type LifeOpsActivitySignalState = (typeof LIFEOPS_ACTIVITY_SIGNAL_STATES)[number];
-export declare const LIFEOPS_HEALTH_SIGNAL_SOURCES: readonly ["healthkit", "health_connect"];
+export declare const LIFEOPS_HEALTH_SIGNAL_SOURCES: readonly ["healthkit", "health_connect", "strava", "fitbit", "withings", "oura"];
 export type LifeOpsHealthSignalSource = (typeof LIFEOPS_HEALTH_SIGNAL_SOURCES)[number];
 export interface LifeOpsHealthSignalSleepSummary {
     available: boolean;
@@ -629,6 +639,181 @@ export interface LifeOpsHealthSignal {
     biometrics: LifeOpsHealthSignalBiometrics;
     warnings: string[];
 }
+export declare const LIFEOPS_HEALTH_CONNECTOR_REASONS: readonly ["connected", "disconnected", "config_missing", "needs_reauth", "sync_failed"];
+export type LifeOpsHealthConnectorReason = (typeof LIFEOPS_HEALTH_CONNECTOR_REASONS)[number];
+export interface LifeOpsHealthConnectorStatus {
+    provider: LifeOpsHealthConnectorProvider;
+    side: LifeOpsConnectorSide;
+    mode: LifeOpsConnectorMode;
+    defaultMode: LifeOpsConnectorMode;
+    availableModes: LifeOpsConnectorMode[];
+    executionTarget: LifeOpsConnectorExecutionTarget;
+    sourceOfTruth: LifeOpsConnectorSourceOfTruth;
+    configured: boolean;
+    connected: boolean;
+    reason: LifeOpsHealthConnectorReason;
+    identity: Record<string, unknown> | null;
+    grantedCapabilities: LifeOpsHealthConnectorCapability[];
+    grantedScopes: string[];
+    expiresAt: string | null;
+    hasRefreshToken: boolean;
+    lastSyncAt: string | null;
+    grant: LifeOpsConnectorGrant | null;
+    degradations?: LifeOpsConnectorDegradation[];
+}
+export interface LifeOpsHealthMetricSample {
+    id: string;
+    agentId: string;
+    provider: LifeOpsHealthConnectorProvider;
+    grantId: string;
+    metric: LifeOpsHealthMetric;
+    value: number;
+    unit: string;
+    startAt: string;
+    endAt: string;
+    localDate: string;
+    sourceExternalId: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LifeOpsHealthWorkout {
+    id: string;
+    agentId: string;
+    provider: LifeOpsHealthConnectorProvider;
+    grantId: string;
+    sourceExternalId: string;
+    workoutType: string;
+    title: string;
+    startAt: string;
+    endAt: string | null;
+    durationSeconds: number;
+    distanceMeters: number | null;
+    calories: number | null;
+    averageHeartRate: number | null;
+    maxHeartRate: number | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LifeOpsHealthSyncState {
+    id: string;
+    agentId: string;
+    provider: LifeOpsHealthConnectorProvider;
+    grantId: string;
+    cursor: string | null;
+    lastSyncedAt: string | null;
+    lastSyncStartedAt: string | null;
+    lastSyncError: string | null;
+    metadata: Record<string, unknown>;
+    updatedAt: string;
+}
+export declare const LIFEOPS_HEALTH_SLEEP_STAGES: readonly ["awake", "light", "deep", "rem", "restless", "unknown"];
+export type LifeOpsHealthSleepStage = (typeof LIFEOPS_HEALTH_SLEEP_STAGES)[number];
+export interface LifeOpsHealthSleepStageSample {
+    stage: LifeOpsHealthSleepStage;
+    startAt: string;
+    endAt: string;
+    confidence: number | null;
+    providerCode: string | null;
+}
+export interface LifeOpsHealthSleepEpisode {
+    id: string;
+    agentId: string;
+    provider: LifeOpsHealthConnectorProvider;
+    grantId: string;
+    sourceExternalId: string;
+    localDate: string;
+    timezone: string | null;
+    startAt: string;
+    endAt: string;
+    isMainSleep: boolean;
+    sleepType: string | null;
+    durationSeconds: number;
+    timeInBedSeconds: number | null;
+    efficiency: number | null;
+    latencySeconds: number | null;
+    awakeSeconds: number | null;
+    lightSleepSeconds: number | null;
+    deepSleepSeconds: number | null;
+    remSleepSeconds: number | null;
+    sleepScore: number | null;
+    readinessScore: number | null;
+    averageHeartRate: number | null;
+    lowestHeartRate: number | null;
+    averageHrvMs: number | null;
+    respiratoryRate: number | null;
+    bloodOxygenPercent: number | null;
+    stageSamples: LifeOpsHealthSleepStageSample[];
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LifeOpsHealthDailySummary {
+    date: string;
+    provider: LifeOpsHealthConnectorProvider | "healthkit" | "google-fit";
+    steps: number;
+    activeMinutes: number;
+    sleepHours: number;
+    calories: number | null;
+    distanceMeters: number | null;
+    heartRateAvg: number | null;
+    restingHeartRate: number | null;
+    hrvMs: number | null;
+    sleepScore: number | null;
+    readinessScore: number | null;
+    weightKg: number | null;
+    bloodPressureSystolic: number | null;
+    bloodPressureDiastolic: number | null;
+    bloodOxygenPercent: number | null;
+}
+export interface GetLifeOpsHealthSummaryRequest {
+    provider?: LifeOpsHealthConnectorProvider | null;
+    mode?: LifeOpsConnectorMode;
+    side?: LifeOpsConnectorSide;
+    days?: number;
+    startDate?: string | null;
+    endDate?: string | null;
+    metrics?: LifeOpsHealthMetric[];
+    forceSync?: boolean;
+}
+export interface LifeOpsHealthSummaryResponse {
+    providers: LifeOpsHealthConnectorStatus[];
+    summaries: LifeOpsHealthDailySummary[];
+    samples: LifeOpsHealthMetricSample[];
+    workouts: LifeOpsHealthWorkout[];
+    sleepEpisodes: LifeOpsHealthSleepEpisode[];
+    syncedAt: string;
+}
+export interface StartLifeOpsHealthConnectorRequest {
+    provider: LifeOpsHealthConnectorProvider;
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+    redirectUrl?: string;
+    capabilities?: LifeOpsHealthConnectorCapability[];
+}
+export interface StartLifeOpsHealthConnectorResponse {
+    provider: LifeOpsHealthConnectorProvider;
+    side: LifeOpsConnectorSide;
+    mode: LifeOpsConnectorMode;
+    requestedCapabilities: LifeOpsHealthConnectorCapability[];
+    redirectUri: string;
+    authUrl: string | null;
+}
+export interface DisconnectLifeOpsHealthConnectorRequest {
+    provider: LifeOpsHealthConnectorProvider;
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+    grantId?: string;
+}
+export interface SyncLifeOpsHealthConnectorRequest {
+    provider?: LifeOpsHealthConnectorProvider | null;
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+    startDate?: string | null;
+    endDate?: string | null;
+    days?: number;
+}
 export interface LifeOpsActivitySignal {
     id: string;
     agentId: string;
@@ -1035,9 +1220,9 @@ export interface LifeOpsCalendarEvent {
     updatedAt: string;
     /** Set on merged feeds so the UI can show which calendar an event came from. */
     calendarSummary?: string;
-    /** Set when aggregating across multiple Google accounts. */
+    /** Google grant that owns this Gmail message cache row. */
     grantId?: string;
-    /** Set when aggregating across multiple Google accounts. */
+    /** Email address for the owning Google account when known. */
     accountEmail?: string;
 }
 export interface LifeOpsCalendarFeed {
@@ -1562,13 +1747,6 @@ export interface CreateLifeOpsCalendarEventRequest {
     durationMinutes?: number;
     windowPreset?: LifeOpsCalendarWindowPreset;
     attendees?: CreateLifeOpsCalendarEventAttendee[];
-    /**
-     * RFC 5545 RRULE strings (without the leading "RRULE:" prefix), e.g.
-     * `["FREQ=WEEKLY;BYDAY=MO"]`. Forwarded to Google Calendar's
-     * `recurrence` array when creating the event.
-     */
-    recurrence?: string[];
-    reminders?: LifeOpsCalendarEventReminderOverride[];
 }
 export interface LifeOpsNextCalendarEventContext {
     event: LifeOpsCalendarEvent | null;
@@ -1583,11 +1761,9 @@ export interface LifeOpsNextCalendarEventContext {
     linkedMailError: string | null;
     linkedMail: Array<Pick<LifeOpsGmailMessageSummary, "id" | "subject" | "from" | "receivedAt" | "snippet" | "htmlLink">>;
 }
-export interface LifeOpsCalendarEventReminderOverride {
-    minutesBefore: number;
-}
 export interface LifeOpsCalendarEventUpdate {
     side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
     grantId?: string;
     calendarId?: string;
     title?: string;
@@ -1597,12 +1773,6 @@ export interface LifeOpsCalendarEventUpdate {
     notes?: string;
     location?: string;
     attendees?: CreateLifeOpsCalendarEventAttendee[];
-    /**
-     * RFC 5545 RRULE strings (without the leading "RRULE:" prefix). Forwarded
-     * to Google Calendar's `recurrence` array on patch when supplied.
-     */
-    recurrence?: string[];
-    reminders?: LifeOpsCalendarEventReminderOverride[];
 }
 export interface LifeOpsCalendarEventMutationResult {
     event: LifeOpsCalendarEvent;
@@ -1790,6 +1960,18 @@ export interface LifeOpsSignalConnectorStatus {
     grant: LifeOpsConnectorGrant | null;
     degradations?: LifeOpsConnectorDegradation[];
 }
+export interface SendLifeOpsSignalMessageRequest {
+    side?: LifeOpsConnectorSide;
+    recipient: string;
+    text: string;
+}
+export interface SendLifeOpsSignalMessageResponse {
+    provider: "signal";
+    side: LifeOpsConnectorSide;
+    recipient: string;
+    ok: true;
+    timestamp: number;
+}
 /**
  * A single inbound Signal message as returned by {@link readSignalInbound} and
  * the signal-local-client reader.
@@ -1826,6 +2008,13 @@ export interface LifeOpsSignalInboundMessage {
     /** True when the message was received in a group conversation. */
     isGroup: boolean;
 }
+export interface GetLifeOpsSignalMessagesRequest {
+    limit?: number;
+}
+export interface GetLifeOpsSignalMessagesResponse {
+    count: number;
+    messages: LifeOpsSignalInboundMessage[];
+}
 export interface LifeOpsDiscordDmPreview {
     channelId: string | null;
     href: string | null;
@@ -1894,11 +2083,9 @@ export type LifeOpsTelegramAuthState = (typeof LIFEOPS_TELEGRAM_AUTH_STATES)[num
 export interface LifeOpsWhatsAppConnectorStatus {
     provider: "whatsapp";
     /**
-     * `connected` here means LifeOps can see either WhatsApp Business Cloud API
-     * credentials or a local QR-paired auth state. It does not imply a live
-     * network probe has been performed. A live send can still fail if the
-     * upstream token/session has been revoked. Callers that need true liveness
-     * must catch errors from the actual send/receive methods.
+     * `connected` means at least one WhatsApp transport is live enough for
+     * inbound or outbound work. A local auth file by itself is not connected until
+     * the Baileys runtime service is actually online.
      */
     connected: boolean;
     /**
@@ -1907,6 +2094,13 @@ export interface LifeOpsWhatsAppConnectorStatus {
      */
     inbound: true;
     phoneNumberId?: string;
+    phoneNumber?: string | null;
+    localAuthAvailable?: boolean;
+    localAuthRegistered?: boolean | null;
+    serviceConnected?: boolean;
+    outboundReady?: boolean;
+    inboundReady?: boolean;
+    transport?: "cloudapi" | "baileys" | "unconfigured";
     lastCheckedAt: string;
     degradations?: LifeOpsConnectorDegradation[];
 }
@@ -1980,6 +2174,41 @@ export interface StartLifeOpsDiscordConnectorRequest {
     side?: LifeOpsConnectorSide;
     source?: LifeOpsOwnerBrowserAccessSource;
 }
+export interface SendLifeOpsDiscordMessageRequest {
+    side?: LifeOpsConnectorSide;
+    channelId?: string;
+    text: string;
+}
+export interface SendLifeOpsDiscordMessageResponse {
+    provider: "discord";
+    side: LifeOpsConnectorSide;
+    channelId: string;
+    ok: true;
+    deliveryStatus: "sent" | "sending" | "failed" | "unknown";
+}
+export interface VerifyLifeOpsDiscordConnectorRequest {
+    side?: LifeOpsConnectorSide;
+    channelId?: string;
+    sendMessage?: string;
+}
+export interface VerifyLifeOpsDiscordConnectorResponse {
+    provider: "discord";
+    side: LifeOpsConnectorSide;
+    verifiedAt: string;
+    status: LifeOpsDiscordConnectorStatus;
+    send: {
+        ok: boolean;
+        error: string | null;
+        channelId: string | null;
+        message: string;
+        deliveryStatus: "sent" | "sending" | "failed" | "unknown" | null;
+    };
+}
+export interface SendLifeOpsWhatsAppMessageRequest {
+    to: string;
+    text: string;
+    replyToMessageId?: string;
+}
 export interface StartLifeOpsTelegramAuthRequest {
     side?: LifeOpsConnectorSide;
     phone: string;
@@ -2006,6 +2235,8 @@ export interface StartLifeOpsGoogleConnectorRequest {
     mode?: LifeOpsConnectorMode;
     /** Re-authenticate an existing account by grant ID (multi-account). */
     grantId?: string;
+    /** Create an additional account grant instead of reusing the side/mode grant. */
+    createNewGrant?: boolean;
     capabilities?: LifeOpsGoogleCapability[];
     redirectUrl?: string;
 }
@@ -2024,6 +2255,7 @@ export interface SelectLifeOpsGoogleConnectorPreferenceRequest {
 export interface DisconnectLifeOpsGoogleConnectorRequest {
     side?: LifeOpsConnectorSide;
     mode?: LifeOpsConnectorMode;
+    grantId?: string;
 }
 export interface UpsertLifeOpsXConnectorRequest {
     side?: LifeOpsConnectorSide;
@@ -2451,8 +2683,16 @@ export interface LifeOpsSleepHistoryEpisode {
     source: LifeOpsSleepCycleEvidenceSource | "manual";
     confidence: number;
 }
+export interface LifeOpsSleepHistorySummary {
+    cycleCount: number;
+    averageDurationMin: number | null;
+    overnightCount: number;
+    napCount: number;
+    openCount: number;
+}
 export interface LifeOpsSleepHistoryResponse {
     episodes: LifeOpsSleepHistoryEpisode[];
+    summary: LifeOpsSleepHistorySummary;
     windowDays: number;
     includeNaps: boolean;
 }