@elizaos/shared 2.0.0-alpha.223 → 2.0.0-alpha.334

package/contracts/lifeops.d.ts

@@ -24,7 +24,7 @@ export type LifeOpsWorkflowTriggerType = (typeof LIFEOPS_WORKFLOW_TRIGGER_TYPES)
  * publishes matching occurrences to `runDueEventWorkflows`, and — optionally —
  * a filter shape under {@link LifeOpsEventFilters}.
  */
-export declare const LIFEOPS_EVENT_KINDS: readonly ["calendar.event.ended"];
+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"). */
@@ -36,9 +36,80 @@ export interface LifeOpsCalendarEventEndedFilters {
     /** 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[];
+    /** Only fire when the sender email/display contains one of these substrings. */
+    fromIncludesAny?: string[];
+    /** Only fire when the subject contains one of these case-insensitive substrings. */
+    subjectIncludesAny?: string[];
+    /** Only fire when at least one Gmail label id is present. */
+    labelIds?: string[];
+    /** Only fire when LifeOps classified the message/thread as needing a reply. */
+    requiresReplyNeeded?: boolean;
+}
+export interface LifeOpsSleepOnsetCandidateFilters {
+    minConfidence?: number;
+}
+export interface LifeOpsSleepDetectedFilters {
+    minConfidence?: number;
+}
+export interface LifeOpsSleepEndedFilters {
+    minConfidence?: number;
+}
+export interface LifeOpsWakeObservedFilters {
+    offsetMinutes?: number;
+    minConfidence?: number;
+}
+export interface LifeOpsWakeConfirmedFilters {
+    offsetMinutes?: number;
+    minConfidence?: number;
+}
+export interface LifeOpsNapDetectedFilters {
+    minConfidence?: number;
+    maxDurationMinutes?: number;
+}
+export interface LifeOpsBedtimeImminentFilters {
+    minutesBefore?: number;
+    minConfidence?: number;
+}
+export interface LifeOpsRegularityChangedFilters {
+    /** Fires when regularity class transitions into this value. */
+    becomes?: LifeOpsRegularityClass;
+}
 export type LifeOpsEventFilters = {
     kind: "calendar.event.ended";
     filters?: LifeOpsCalendarEventEndedFilters;
+} | {
+    kind: "gmail.message.received";
+    filters?: LifeOpsGmailEventFilters;
+} | {
+    kind: "gmail.thread.needs_response";
+    filters?: LifeOpsGmailEventFilters;
+} | {
+    kind: "lifeops.sleep.onset_candidate";
+    filters?: LifeOpsSleepOnsetCandidateFilters;
+} | {
+    kind: "lifeops.sleep.detected";
+    filters?: LifeOpsSleepDetectedFilters;
+} | {
+    kind: "lifeops.sleep.ended";
+    filters?: LifeOpsSleepEndedFilters;
+} | {
+    kind: "lifeops.wake.observed";
+    filters?: LifeOpsWakeObservedFilters;
+} | {
+    kind: "lifeops.wake.confirmed";
+    filters?: LifeOpsWakeConfirmedFilters;
+} | {
+    kind: "lifeops.nap.detected";
+    filters?: LifeOpsNapDetectedFilters;
+} | {
+    kind: "lifeops.bedtime.imminent";
+    filters?: LifeOpsBedtimeImminentFilters;
+} | {
+    kind: "lifeops.regularity.changed";
+    filters?: LifeOpsRegularityChangedFilters;
 };
 export declare const LIFEOPS_NEGOTIATION_STATES: readonly ["initiated", "proposals_sent", "awaiting_response", "confirmed", "cancelled"];
 export type LifeOpsNegotiationState = (typeof LIFEOPS_NEGOTIATION_STATES)[number];
@@ -85,7 +156,7 @@ export declare const LIFEOPS_CONNECTOR_SOURCES_OF_TRUTH: readonly ["local_storag
 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];
-export declare const LIFEOPS_X_CAPABILITIES: readonly ["x.read", "x.write"];
+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_SIGNAL_CAPABILITIES: readonly ["signal.read", "signal.send"];
 export type LifeOpsSignalCapability = (typeof LIFEOPS_SIGNAL_CAPABILITIES)[number];
@@ -94,9 +165,9 @@ export type LifeOpsDiscordCapability = (typeof LIFEOPS_DISCORD_CAPABILITIES)[num
 export declare const LIFEOPS_TELEGRAM_CAPABILITIES: readonly ["telegram.read", "telegram.send"];
 export type LifeOpsTelegramCapability = (typeof LIFEOPS_TELEGRAM_CAPABILITIES)[number];
 export declare function capabilitiesForSide<T extends string>(allCapabilities: readonly T[], side: LifeOpsConnectorSide): T[];
-export declare const LIFEOPS_REMINDER_CHANNELS: readonly ["in_app", "sms", "voice", "telegram", "discord", "signal", "whatsapp", "imessage"];
+export declare const LIFEOPS_REMINDER_CHANNELS: readonly ["in_app", "sms", "voice", "telegram", "discord", "signal", "whatsapp", "imessage", "email", "push"];
 export type LifeOpsReminderChannel = (typeof LIFEOPS_REMINDER_CHANNELS)[number];
-export declare const LIFEOPS_CHANNEL_TYPES: readonly ["in_app", "sms", "voice", "telegram", "discord", "signal", "whatsapp", "imessage", "x", "browser"];
+export declare const LIFEOPS_CHANNEL_TYPES: readonly ["in_app", "sms", "voice", "telegram", "discord", "signal", "whatsapp", "imessage", "x", "browser", "email", "push"];
 export type LifeOpsChannelType = (typeof LIFEOPS_CHANNEL_TYPES)[number];
 export declare const LIFEOPS_PRIVACY_CLASSES: readonly ["private", "shared", "public"];
 export type LifeOpsPrivacyClass = (typeof LIFEOPS_PRIVACY_CLASSES)[number];
@@ -117,9 +188,9 @@ export type LifeOpsReminderIntensityCompatibility = (typeof LIFEOPS_REMINDER_INT
 export type LifeOpsReminderIntensityInput = LifeOpsReminderIntensity | LifeOpsReminderIntensityCompatibility;
 export declare const LIFEOPS_REMINDER_PREFERENCE_SOURCES: readonly ["default", "global_policy", "definition_metadata"];
 export type LifeOpsReminderPreferenceSource = (typeof LIFEOPS_REMINDER_PREFERENCE_SOURCES)[number];
-export declare const LIFEOPS_OWNER_TYPES: readonly ["definition", "occurrence", "goal", "workflow", "calendar_event", "gmail_message", "connector", "channel_policy", "browser_session"];
+export declare const LIFEOPS_OWNER_TYPES: readonly ["definition", "occurrence", "goal", "workflow", "calendar_event", "gmail_message", "connector", "channel_policy", "browser_session", "circadian_state"];
 export type LifeOpsOwnerType = (typeof LIFEOPS_OWNER_TYPES)[number];
-export declare const LIFEOPS_AUDIT_EVENT_TYPES: readonly ["definition_created", "definition_updated", "definition_deleted", "occurrence_generated", "occurrence_completed", "occurrence_skipped", "occurrence_snoozed", "goal_created", "goal_updated", "goal_deleted", "goal_reviewed", "calendar_event_created", "calendar_event_updated", "calendar_event_deleted", "gmail_triage_synced", "gmail_reply_drafted", "gmail_reply_sent", "gmail_message_sent", "reminder_due", "reminder_delivered", "reminder_blocked", "reminder_escalation_started", "reminder_escalation_resolved", "workflow_created", "workflow_updated", "workflow_run", "connector_grant_updated", "channel_policy_updated", "browser_session_created", "browser_session_updated", "x_post_sent", "seeding_offered"];
+export declare const LIFEOPS_AUDIT_EVENT_TYPES: readonly ["definition_created", "definition_updated", "definition_deleted", "occurrence_generated", "occurrence_completed", "occurrence_skipped", "occurrence_snoozed", "goal_created", "goal_updated", "goal_deleted", "goal_reviewed", "calendar_event_created", "calendar_event_updated", "calendar_event_deleted", "gmail_triage_synced", "gmail_reply_drafted", "gmail_reply_sent", "gmail_message_sent", "reminder_due", "reminder_delivered", "reminder_blocked", "reminder_escalation_started", "reminder_escalation_resolved", "workflow_created", "workflow_updated", "workflow_run", "connector_grant_updated", "channel_policy_updated", "browser_session_created", "browser_session_updated", "x_post_sent", "seeding_offered", "circadian_event_emitted", "manual_override_accepted"];
 export type LifeOpsAuditEventType = (typeof LIFEOPS_AUDIT_EVENT_TYPES)[number];
 export declare const LIFEOPS_ACTORS: readonly ["agent", "user", "workflow", "connector"];
 export type LifeOpsActor = (typeof LIFEOPS_ACTORS)[number];
@@ -356,6 +427,50 @@ export type LifeOpsWorkflowSchedule = {
     kind: "cron";
     cronExpression: string;
     timezone: string;
+} | {
+    kind: "relative_to_wake";
+    /** Minutes offset from wake anchor (wake.confirmed). Negative = before. */
+    offsetMinutes: number;
+    timezone: string;
+    onDays?: number[];
+    /** Minimum regularity required before projecting an anchor. Default: `regular`. */
+    requireRegularityAtLeast?: LifeOpsRegularityClass;
+    /**
+     * Minutes of sustained awake state after `wake.observed` required before
+     * the workflow fires. When set, the resolver waits for a `wake.confirmed`
+     * event rather than using the raw wake anchor.
+     */
+    stabilityWindowMinutes?: number;
+} | {
+    kind: "relative_to_bedtime";
+    offsetMinutes: number;
+    timezone: string;
+    onDays?: number[];
+    requireRegularityAtLeast?: LifeOpsRegularityClass;
+} | {
+    /**
+     * Fires during the canonical "morning" window anchored on the latest
+     * wake.confirmed. The window starts at `wakeConfirmedAt` and ends
+     * `windowMinutesFromWake` later (default 240). Workflow scheduler emits
+     * exactly once per morning window when the workflow becomes eligible.
+     */
+    kind: "during_morning";
+    timezone: string;
+    windowMinutesFromWake?: number;
+    onDays?: number[];
+    requireRegularityAtLeast?: LifeOpsRegularityClass;
+} | {
+    /**
+     * Fires during the canonical "night" window anchored on the projected
+     * bedtime target. The window starts `windowMinutesBeforeSleepTarget`
+     * before the bedtime target and ends at `sleep.detected`. Fires exactly
+     * once per night window when the workflow becomes eligible.
+     */
+    kind: "during_night";
+    timezone: string;
+    windowMinutesBeforeSleepTarget?: number;
+    onDays?: number[];
+    requireRegularityAtLeast?: LifeOpsRegularityClass;
 } | {
     kind: "event";
     eventKind: LifeOpsEventKind;
@@ -371,12 +486,6 @@ export interface LifeOpsWorkflowPermissionPolicy {
 }
 export declare const LIFEOPS_BROWSER_KINDS: readonly ["chrome", "safari"];
 export type LifeOpsBrowserKind = (typeof LIFEOPS_BROWSER_KINDS)[number];
-export declare const LIFEOPS_BROWSER_TRACKING_MODES: readonly ["off", "current_tab", "active_tabs"];
-export type LifeOpsBrowserTrackingMode = (typeof LIFEOPS_BROWSER_TRACKING_MODES)[number];
-export declare const LIFEOPS_BROWSER_SITE_ACCESS_MODES: readonly ["current_site_only", "granted_sites", "all_sites"];
-export type LifeOpsBrowserSiteAccessMode = (typeof LIFEOPS_BROWSER_SITE_ACCESS_MODES)[number];
-export declare const LIFEOPS_BROWSER_COMPANION_CONNECTION_STATES: readonly ["disconnected", "connected", "paused", "permission_blocked"];
-export type LifeOpsBrowserCompanionConnectionState = (typeof LIFEOPS_BROWSER_COMPANION_CONNECTION_STATES)[number];
 export declare const LIFEOPS_BROWSER_ACTION_KINDS: readonly ["open", "navigate", "focus_tab", "back", "forward", "reload", "click", "type", "submit", "read_page", "extract_links", "extract_forms"];
 export type LifeOpsBrowserActionKind = (typeof LIFEOPS_BROWSER_ACTION_KINDS)[number];
 export interface LifeOpsBrowserAction {
@@ -393,244 +502,6 @@ export interface LifeOpsBrowserAction {
     requiresConfirmation: boolean;
     metadata: Record<string, unknown>;
 }
-export interface LifeOpsBrowserPermissionState {
-    tabs: boolean;
-    scripting: boolean;
-    activeTab: boolean;
-    allOrigins: boolean;
-    grantedOrigins: string[];
-    incognitoEnabled: boolean;
-}
-export interface LifeOpsBrowserSettings {
-    enabled: boolean;
-    trackingMode: LifeOpsBrowserTrackingMode;
-    allowBrowserControl: boolean;
-    requireConfirmationForAccountAffecting: boolean;
-    incognitoEnabled: boolean;
-    siteAccessMode: LifeOpsBrowserSiteAccessMode;
-    grantedOrigins: string[];
-    blockedOrigins: string[];
-    maxRememberedTabs: number;
-    pauseUntil: string | null;
-    metadata: Record<string, unknown>;
-    updatedAt: string | null;
-}
-export interface UpdateLifeOpsBrowserSettingsRequest {
-    enabled?: boolean;
-    trackingMode?: LifeOpsBrowserTrackingMode;
-    allowBrowserControl?: boolean;
-    requireConfirmationForAccountAffecting?: boolean;
-    incognitoEnabled?: boolean;
-    siteAccessMode?: LifeOpsBrowserSiteAccessMode;
-    grantedOrigins?: string[];
-    blockedOrigins?: string[];
-    maxRememberedTabs?: number;
-    pauseUntil?: string | null;
-    metadata?: Record<string, unknown>;
-}
-export interface LifeOpsBrowserCompanionStatus {
-    id: string;
-    agentId: string;
-    browser: LifeOpsBrowserKind;
-    profileId: string;
-    profileLabel: string;
-    label: string;
-    extensionVersion: string | null;
-    connectionState: LifeOpsBrowserCompanionConnectionState;
-    permissions: LifeOpsBrowserPermissionState;
-    lastSeenAt: string | null;
-    pairedAt: string | null;
-    metadata: Record<string, unknown>;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface LifeOpsBrowserTabSummary {
-    id: string;
-    agentId: string;
-    companionId: string | null;
-    browser: LifeOpsBrowserKind;
-    profileId: string;
-    windowId: string;
-    tabId: string;
-    url: string;
-    title: string;
-    activeInWindow: boolean;
-    focusedWindow: boolean;
-    focusedActive: boolean;
-    incognito: boolean;
-    faviconUrl: string | null;
-    lastSeenAt: string;
-    lastFocusedAt: string | null;
-    metadata: Record<string, unknown>;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface LifeOpsBrowserPageContext {
-    id: string;
-    agentId: string;
-    browser: LifeOpsBrowserKind;
-    profileId: string;
-    windowId: string;
-    tabId: string;
-    url: string;
-    title: string;
-    selectionText: string | null;
-    mainText: string | null;
-    headings: string[];
-    links: Array<{
-        text: string;
-        href: string;
-    }>;
-    forms: Array<{
-        action: string | null;
-        fields: string[];
-    }>;
-    capturedAt: string;
-    metadata: Record<string, unknown>;
-}
-export interface UpsertLifeOpsBrowserCompanionRequest {
-    browser: LifeOpsBrowserKind;
-    profileId: string;
-    profileLabel?: string | null;
-    label: string;
-    extensionVersion?: string | null;
-    connectionState?: LifeOpsBrowserCompanionConnectionState;
-    permissions?: Partial<LifeOpsBrowserPermissionState>;
-    lastSeenAt?: string | null;
-    metadata?: Record<string, unknown>;
-}
-export interface SyncLifeOpsBrowserStateRequest {
-    companion: UpsertLifeOpsBrowserCompanionRequest;
-    tabs: Array<{
-        browser: LifeOpsBrowserKind;
-        profileId: string;
-        windowId: string;
-        tabId: string;
-        url: string;
-        title: string;
-        activeInWindow: boolean;
-        focusedWindow: boolean;
-        focusedActive: boolean;
-        incognito?: boolean;
-        faviconUrl?: string | null;
-        lastSeenAt?: string;
-        lastFocusedAt?: string | null;
-        metadata?: Record<string, unknown>;
-    }>;
-    pageContexts?: Array<{
-        browser: LifeOpsBrowserKind;
-        profileId: string;
-        windowId: string;
-        tabId: string;
-        url: string;
-        title: string;
-        selectionText?: string | null;
-        mainText?: string | null;
-        headings?: string[];
-        links?: Array<{
-            text: string;
-            href: string;
-        }>;
-        forms?: Array<{
-            action: string | null;
-            fields: string[];
-        }>;
-        capturedAt?: string;
-        metadata?: Record<string, unknown>;
-    }>;
-}
-export interface CreateLifeOpsBrowserCompanionPairingRequest {
-    browser: LifeOpsBrowserKind;
-    profileId: string;
-    profileLabel?: string | null;
-    label?: string | null;
-    extensionVersion?: string | null;
-    metadata?: Record<string, unknown>;
-}
-export interface LifeOpsBrowserCompanionPairingResponse {
-    companion: LifeOpsBrowserCompanionStatus;
-    pairingToken: string;
-}
-export interface LifeOpsBrowserCompanionConfig {
-    apiBaseUrl: string;
-    companionId: string;
-    pairingToken: string;
-    browser: LifeOpsBrowserKind;
-    profileId: string;
-    profileLabel: string;
-    label: string;
-}
-export interface CreateLifeOpsBrowserCompanionAutoPairRequest {
-    browser: LifeOpsBrowserKind;
-    profileId?: string | null;
-    profileLabel?: string | null;
-    label?: string | null;
-    extensionVersion?: string | null;
-    metadata?: Record<string, unknown>;
-}
-export interface LifeOpsBrowserCompanionAutoPairResponse {
-    companion: LifeOpsBrowserCompanionStatus;
-    config: LifeOpsBrowserCompanionConfig;
-}
-export interface UpdateLifeOpsBrowserSessionProgressRequest {
-    currentActionIndex?: number;
-    result?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-}
-export interface LifeOpsBrowserCompanionSyncResponse {
-    companion: LifeOpsBrowserCompanionStatus;
-    tabs: LifeOpsBrowserTabSummary[];
-    currentPage: LifeOpsBrowserPageContext | null;
-    settings: LifeOpsBrowserSettings;
-    session: LifeOpsBrowserSession | null;
-}
-export declare const LIFEOPS_BROWSER_PACKAGE_PATH_TARGETS: readonly ["extension_root", "chrome_build", "chrome_package", "safari_web_extension", "safari_app", "safari_package"];
-export type LifeOpsBrowserPackagePathTarget = (typeof LIFEOPS_BROWSER_PACKAGE_PATH_TARGETS)[number];
-export interface LifeOpsBrowserCompanionPackageStatus {
-    extensionPath: string | null;
-    chromeBuildPath: string | null;
-    chromePackagePath: string | null;
-    safariWebExtensionPath: string | null;
-    safariAppPath: string | null;
-    safariPackagePath: string | null;
-    releaseManifest: LifeOpsBrowserCompanionReleaseManifest | null;
-}
-export interface LifeOpsBrowserCompanionReleaseAsset {
-    fileName: string;
-    downloadUrl: string | null;
-}
-export interface LifeOpsBrowserCompanionReleaseTarget {
-    installKind: "chrome_web_store" | "apple_app_store" | "github_release" | "local_download";
-    installUrl: string | null;
-    storeListingUrl: string | null;
-    asset: LifeOpsBrowserCompanionReleaseAsset;
-}
-export interface LifeOpsBrowserCompanionReleaseManifest {
-    schema: "lifeops_browser_release_v2";
-    releaseTag: string;
-    releaseVersion: string;
-    repository: string | null;
-    releasePageUrl: string | null;
-    chromeVersion: string;
-    chromeVersionName: string;
-    safariMarketingVersion: string;
-    safariBuildVersion: string;
-    chrome: LifeOpsBrowserCompanionReleaseTarget;
-    safari: LifeOpsBrowserCompanionReleaseTarget;
-    generatedAt: string;
-}
-export interface OpenLifeOpsBrowserCompanionPackagePathRequest {
-    target: LifeOpsBrowserPackagePathTarget;
-    revealOnly?: boolean;
-}
-export interface OpenLifeOpsBrowserCompanionPackagePathResponse {
-    target: LifeOpsBrowserPackagePathTarget;
-    path: string;
-    revealOnly: boolean;
-}
-export interface OpenLifeOpsBrowserCompanionManagerResponse {
-    browser: LifeOpsBrowserKind;
-}
 export interface LifeOpsWorkflowActionBase {
     id?: string;
     resultKey?: string;
@@ -654,6 +525,13 @@ export type LifeOpsWorkflowAction = (LifeOpsWorkflowActionBase & {
 }) | (LifeOpsWorkflowActionBase & {
     kind: "get_gmail_triage";
     request?: GetLifeOpsGmailTriageRequest;
+}) | (LifeOpsWorkflowActionBase & {
+    kind: "get_gmail_unresponded";
+    request?: GetLifeOpsGmailUnrespondedRequest;
+}) | (LifeOpsWorkflowActionBase & {
+    kind: "dispatch_n8n_workflow";
+    workflowId: string;
+    payload?: Record<string, unknown>;
 }) | (LifeOpsWorkflowActionBase & {
     kind: "summarize";
     sourceKey?: string;
@@ -716,7 +594,7 @@ export interface LifeOpsChannelPolicy {
     createdAt: string;
     updatedAt: string;
 }
-export declare const LIFEOPS_ACTIVITY_SIGNAL_SOURCES: readonly ["app_lifecycle", "page_visibility", "desktop_power", "mobile_device", "mobile_health"];
+export declare const LIFEOPS_ACTIVITY_SIGNAL_SOURCES: readonly ["app_lifecycle", "page_visibility", "desktop_power", "desktop_interaction", "connector_activity", "imessage_outbound", "mobile_device", "mobile_health"];
 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];
@@ -762,6 +640,113 @@ export interface LifeOpsActivitySignal {
     metadata: Record<string, unknown>;
     createdAt: string;
 }
+export type LifeOpsDevicePlatform = "macos_desktop" | "macos_electrobun" | "ios_capacitor" | "ipados_capacitor" | "browser_web";
+export interface LifeOpsDevicePresencePayload {
+    family: "device_presence_event";
+    platform: LifeOpsDevicePlatform;
+    state: LifeOpsActivitySignalState;
+    deviceId: string;
+    isTransition: boolean;
+    sequence: number;
+}
+export type LifeOpsDesktopPowerEventKind = "system_wake" | "system_sleep" | "screen_wake" | "screen_sleep" | "session_lock" | "session_unlock" | "ac_plug" | "ac_unplug";
+export interface LifeOpsDesktopPowerPayload {
+    family: "desktop_power_event";
+    platform: "macos_desktop" | "macos_electrobun";
+    kind: LifeOpsDesktopPowerEventKind;
+    batteryPercent: number | null;
+}
+export interface LifeOpsDesktopIdleSamplePayload {
+    family: "desktop_idle_sample";
+    platform: "macos_desktop" | "macos_electrobun";
+    idleSeconds: number;
+    source: "iokit_hid" | "cgevent" | "collector_synthesized";
+    isThresholdCrossing: boolean;
+}
+export interface LifeOpsBrowserFocusPayload {
+    family: "browser_focus_window";
+    platform: "browser_web" | "macos_electrobun";
+    startAt: string;
+    endAt: string;
+    domain: string;
+    tabId: string;
+    focusedSeconds: number;
+}
+export interface LifeOpsMobileHealthPayload {
+    family: "mobile_health_snapshot";
+    platform: "ios_capacitor" | "ipados_capacitor";
+    signal: LifeOpsHealthSignal;
+    sampleId: string | null;
+}
+export type LifeOpsMobileDeviceTelemetrySource = "capacitor_mobile_signals" | "macos_continuity_probe";
+export interface LifeOpsMobileDevicePayload {
+    family: "mobile_device_snapshot";
+    platform: "ios_capacitor" | "ipados_capacitor" | "macos_desktop";
+    source: LifeOpsMobileDeviceTelemetrySource;
+    locked: boolean;
+    idleTimeSeconds: number | null;
+    onBattery: boolean | null;
+    batteryPercent: number | null;
+    pairedDeviceId: string | null;
+}
+export type LifeOpsTelemetryMessageChannel = "gmail" | "x_dm" | "discord" | "telegram" | "signal" | "imessage" | "whatsapp" | "sms" | "milady_chat";
+export type LifeOpsMessageDirection = "inbound" | "outbound_by_owner";
+export interface LifeOpsMessageActivityPayload {
+    family: "message_activity_event";
+    platform: LifeOpsDevicePlatform;
+    channel: LifeOpsTelemetryMessageChannel;
+    direction: LifeOpsMessageDirection;
+    externalMessageId: string;
+    senderHash: string;
+    conversationHash: string;
+}
+export type LifeOpsStatusPlatform = "slack" | "discord" | "telegram" | "x";
+export type LifeOpsStatusTransition = "online" | "offline" | "away" | "do_not_disturb" | "custom_set" | "custom_cleared";
+export interface LifeOpsStatusActivityPayload {
+    family: "status_activity_event";
+    platform: LifeOpsStatusPlatform;
+    transition: LifeOpsStatusTransition;
+}
+export interface LifeOpsChargingPayload {
+    family: "charging_event";
+    platform: LifeOpsDevicePlatform;
+    connected: boolean;
+    batteryPercent: number;
+}
+export interface LifeOpsScreenTimePerAppUsage {
+    appBundleId: string;
+    minutesUsed: number;
+}
+export interface LifeOpsScreenTimeSummaryPayload {
+    family: "screen_time_summary";
+    platform: "ios_capacitor" | "ipados_capacitor" | "macos_desktop";
+    intervalStartAt: string;
+    intervalEndAt: string;
+    totalMinutesUsed: number;
+    apps: LifeOpsScreenTimePerAppUsage[];
+}
+export type LifeOpsManualOverrideTelemetryKind = "going_to_bed" | "just_woke_up";
+export interface LifeOpsManualOverridePayload {
+    family: "manual_override_event";
+    platform: LifeOpsDevicePlatform;
+    kind: LifeOpsManualOverrideTelemetryKind;
+    note: string | null;
+}
+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[];
+export interface LifeOpsTelemetryEnvelope {
+    id: string;
+    agentId: string;
+    family: LifeOpsTelemetryFamily;
+    occurredAt: string;
+    ingestedAt: string;
+    dedupeKey: string;
+    sourceReliability: number;
+}
+export type LifeOpsTelemetryEvent = LifeOpsTelemetryEnvelope & {
+    payload: LifeOpsTelemetryPayload;
+};
 export interface LifeOpsReminderPreferenceSetting {
     intensity: LifeOpsReminderIntensity;
     source: LifeOpsReminderPreferenceSource;
@@ -813,8 +798,108 @@ export interface LifeOpsOverviewSummary {
     activeReminderCount: number;
     activeGoalCount: number;
 }
-export type LifeOpsSchedulePhase = "sleeping" | "waking" | "morning" | "afternoon" | "evening" | "winding_down" | "offline";
+export declare const LIFEOPS_CIRCADIAN_STATES: readonly ["awake", "winding_down", "sleeping", "waking", "napping", "unclear"];
+export type LifeOpsCircadianState = (typeof LIFEOPS_CIRCADIAN_STATES)[number];
+export declare const LIFEOPS_UNCLEAR_REASONS: readonly ["no_signals", "contradictory_signals", "insufficient_history", "permission_blocked", "signal_outage", "boot_cold_start", "stale_state"];
+export type LifeOpsUnclearReason = (typeof LIFEOPS_UNCLEAR_REASONS)[number];
 export type LifeOpsScheduleSleepStatus = "sleeping_now" | "slept" | "likely_missed" | "unknown";
+export type LifeOpsSleepCycleEvidenceSource = "health" | "activity_gap";
+export type LifeOpsSleepCycleType = "nap" | "overnight" | "unknown";
+export type LifeOpsRegularityClass = "very_regular" | "regular" | "irregular" | "very_irregular" | "insufficient_data";
+export interface LifeOpsScheduleRegularity {
+    sri: number;
+    bedtimeStddevMin: number;
+    wakeStddevMin: number;
+    midSleepStddevMin: number;
+    regularityClass: LifeOpsRegularityClass;
+    sampleCount: number;
+    windowDays: number;
+}
+/**
+ * Personal baseline derived from persisted sleep episodes over `windowDays`.
+ * Medians are computed via circular mean (sin/cos projection) so bedtimes
+ * crossing midnight produce correct answers. Returned as `null` on
+ * `LifeOpsScheduleInsight` when `sampleCount < 5` — the scalar typical hours
+ * that previously existed are deleted from the contract.
+ */
+export interface LifeOpsPersonalBaseline {
+    /** Local wake hour in [0, 24). Circular mean over episode end instants. */
+    medianWakeLocalHour: number;
+    /** Local bedtime hour in [12, 36) (normalized so evening hours are next-day). Circular mean. */
+    medianBedtimeLocalHour: number;
+    /** Median sleep episode duration in minutes. */
+    medianSleepDurationMin: number;
+    /** Circular stddev of bedtime in minutes. */
+    bedtimeStddevMin: number;
+    /** Circular stddev of wake time in minutes. */
+    wakeStddevMin: number;
+    /** Number of persisted episodes that fed the computation. */
+    sampleCount: number;
+    /** Size of the look-back window in days (default 28). */
+    windowDays: number;
+}
+export type LifeOpsAwakeProbabilitySource = LifeOpsActivitySignalSource | "prior" | "health" | "activity_gap";
+export interface LifeOpsAwakeProbabilityContributor {
+    source: LifeOpsAwakeProbabilitySource;
+    logLikelihoodRatio: number;
+}
+export interface LifeOpsAwakeProbability {
+    pAwake: number;
+    pAsleep: number;
+    pUnknown: number;
+    contributingSources: LifeOpsAwakeProbabilityContributor[];
+    computedAt: string;
+}
+export interface LifeOpsSleepCycleEvidence {
+    startAt: string;
+    endAt: string | null;
+    source: LifeOpsSleepCycleEvidenceSource;
+    confidence: number;
+}
+export interface LifeOpsSleepCycle {
+    cycleType: LifeOpsSleepCycleType;
+    sleepStatus: LifeOpsScheduleSleepStatus;
+    isProbablySleeping: boolean;
+    sleepConfidence: number;
+    currentSleepStartedAt: string | null;
+    lastSleepStartedAt: string | null;
+    lastSleepEndedAt: string | null;
+    lastSleepDurationMinutes: number | null;
+    evidence: LifeOpsSleepCycleEvidence[];
+}
+export type LifeOpsDayBoundaryAnchor = "start_of_day" | "end_of_day" | "before_sleep";
+export interface LifeOpsDayBoundary {
+    effectiveDayKey: string;
+    localDate: string;
+    timezone: string;
+    anchor: LifeOpsDayBoundaryAnchor;
+    startOfDayAt: string;
+    endOfDayAt: string;
+    beforeSleepAt: string | null;
+    confidence: number;
+}
+export type LifeOpsRelativeTimeAnchorSource = "sleep_cycle" | "activity" | "typical_sleep" | "day_boundary";
+export interface LifeOpsRelativeTime {
+    computedAt: string;
+    localNowAt: string;
+    circadianState: LifeOpsCircadianState;
+    stateConfidence: number;
+    uncertaintyReason: LifeOpsUnclearReason | null;
+    awakeProbability: LifeOpsAwakeProbability;
+    wakeAnchorAt: string | null;
+    wakeAnchorSource: LifeOpsRelativeTimeAnchorSource | null;
+    minutesSinceWake: number | null;
+    minutesAwake: number | null;
+    bedtimeTargetAt: string | null;
+    bedtimeTargetSource: LifeOpsRelativeTimeAnchorSource | null;
+    minutesUntilBedtimeTarget: number | null;
+    minutesSinceBedtimeTarget: number | null;
+    dayBoundaryStartAt: string;
+    dayBoundaryEndAt: string;
+    minutesSinceDayBoundaryStart: number;
+    minutesUntilDayBoundaryEnd: number;
+    confidence: number;
+}
 export type LifeOpsScheduleMealLabel = "breakfast" | "lunch" | "dinner";
 export type LifeOpsScheduleMealSource = "activity_gap" | "expected_window" | "health";
 export interface LifeOpsScheduleMealInsight {
@@ -823,21 +908,41 @@ export interface LifeOpsScheduleMealInsight {
     confidence: number;
     source: LifeOpsScheduleMealSource;
 }
+/**
+ * A single rule firing from `scoreCircadianRules`. Persisted on the schedule
+ * insight so the inspection UI can explain *why* the state machine landed
+ * where it did without re-running inference.
+ */
+export interface LifeOpsCircadianRuleFiring {
+    name: string;
+    contributes: LifeOpsCircadianState;
+    weight: number;
+    observedAt: string;
+    reason: string;
+}
 export interface LifeOpsScheduleInsight {
     effectiveDayKey: string;
     localDate: string;
     timezone: string;
     inferredAt: string;
-    phase: LifeOpsSchedulePhase;
+    circadianState: LifeOpsCircadianState;
+    stateConfidence: number;
+    uncertaintyReason: LifeOpsUnclearReason | null;
+    relativeTime: LifeOpsRelativeTime;
+    awakeProbability: LifeOpsAwakeProbability;
+    regularity: LifeOpsScheduleRegularity;
+    baseline: LifeOpsPersonalBaseline | null;
+    /**
+     * Named-rules evidence from the circadian scorer. Ordered by descending
+     * weight. Empty when `circadianState === "unclear"` and no rules fired.
+     */
+    circadianRuleFirings: LifeOpsCircadianRuleFiring[];
     sleepStatus: LifeOpsScheduleSleepStatus;
-    isProbablySleeping: boolean;
     sleepConfidence: number;
     currentSleepStartedAt: string | null;
     lastSleepStartedAt: string | null;
     lastSleepEndedAt: string | null;
     lastSleepDurationMinutes: number | null;
-    typicalWakeHour: number | null;
-    typicalSleepHour: number | null;
     wakeAt: string | null;
     firstActiveAt: string | null;
     lastActiveAt: string | null;
@@ -848,6 +953,38 @@ export interface LifeOpsScheduleInsight {
     nextMealWindowEndAt: string | null;
     nextMealConfidence: number;
 }
+export type LifeOpsCapabilityDomain = "core" | "schedule" | "reminders" | "activity" | "connectors" | "profile";
+export type LifeOpsCapabilityState = "working" | "degraded" | "blocked" | "not_configured";
+export interface LifeOpsCapabilityEvidence {
+    label: string;
+    state: LifeOpsCapabilityState;
+    detail: string | null;
+    observedAt: string | null;
+}
+export interface LifeOpsCapabilityStatus {
+    id: string;
+    domain: LifeOpsCapabilityDomain;
+    label: string;
+    state: LifeOpsCapabilityState;
+    summary: string;
+    confidence: number;
+    lastCheckedAt: string;
+    evidence: LifeOpsCapabilityEvidence[];
+}
+export interface LifeOpsCapabilitiesSummary {
+    totalCount: number;
+    workingCount: number;
+    degradedCount: number;
+    blockedCount: number;
+    notConfiguredCount: number;
+}
+export interface LifeOpsCapabilitiesStatus {
+    generatedAt: string;
+    appEnabled: boolean;
+    relativeTime: LifeOpsRelativeTime | null;
+    capabilities: LifeOpsCapabilityStatus[];
+    summary: LifeOpsCapabilitiesSummary;
+}
 export interface LifeOpsOverviewSection {
     occurrences: LifeOpsOccurrenceView[];
     goals: LifeOpsGoalDefinition[];
@@ -984,6 +1121,7 @@ export interface GetLifeOpsGmailSearchRequest {
     maxResults?: number;
     query: string;
     replyNeededOnly?: boolean;
+    includeSpamTrash?: boolean;
     grantId?: string;
 }
 export interface LifeOpsGmailSearchSummary {
@@ -999,6 +1137,176 @@ export interface LifeOpsGmailSearchFeed {
     syncedAt: string | null;
     summary: LifeOpsGmailSearchSummary;
 }
+export declare const LIFEOPS_GMAIL_RECOMMENDATION_KINDS: readonly ["reply", "archive", "mark_read", "review_spam"];
+export type LifeOpsGmailRecommendationKind = (typeof LIFEOPS_GMAIL_RECOMMENDATION_KINDS)[number];
+export declare const LIFEOPS_GMAIL_BULK_OPERATIONS: readonly ["archive", "trash", "delete", "report_spam", "mark_read", "mark_unread", "apply_label", "remove_label"];
+export type LifeOpsGmailBulkOperation = (typeof LIFEOPS_GMAIL_BULK_OPERATIONS)[number];
+export interface ManageLifeOpsGmailMessagesRequest {
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+    grantId?: string;
+    operation: LifeOpsGmailBulkOperation;
+    messageIds?: string[];
+    query?: string;
+    maxResults?: number;
+    labelIds?: string[];
+    confirmDestructive?: boolean;
+}
+export interface LifeOpsGmailManageResult {
+    ok: true;
+    operation: LifeOpsGmailBulkOperation;
+    messageIds: string[];
+    affectedCount: number;
+    labelIds: string[];
+    destructive: boolean;
+    grantId?: string;
+    accountEmail?: string;
+}
+export interface LifeOpsGmailRecommendationMessage {
+    messageId: string;
+    subject: string;
+    from: string;
+    fromEmail: string | null;
+    receivedAt: string;
+    snippet: string;
+    labels: string[];
+}
+export interface LifeOpsGmailRecommendation {
+    id: string;
+    kind: LifeOpsGmailRecommendationKind;
+    title: string;
+    rationale: string;
+    operation: LifeOpsGmailBulkOperation | null;
+    messageIds: string[];
+    query: string | null;
+    labelIds: string[];
+    affectedCount: number;
+    destructive: boolean;
+    requiresConfirmation: boolean;
+    confidence: number;
+    sampleMessages: LifeOpsGmailRecommendationMessage[];
+}
+export interface LifeOpsGmailRecommendationsSummary {
+    totalCount: number;
+    replyCount: number;
+    archiveCount: number;
+    markReadCount: number;
+    spamReviewCount: number;
+    destructiveCount: number;
+}
+export interface LifeOpsGmailRecommendationsFeed {
+    recommendations: LifeOpsGmailRecommendation[];
+    source: "cache" | "synced";
+    syncedAt: string | null;
+    summary: LifeOpsGmailRecommendationsSummary;
+}
+export interface GetLifeOpsGmailRecommendationsRequest {
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+    grantId?: string;
+    forceSync?: boolean;
+    maxResults?: number;
+    query?: string;
+    replyNeededOnly?: boolean;
+    includeSpamTrash?: boolean;
+}
+export declare const LIFEOPS_GMAIL_SPAM_REVIEW_STATUSES: readonly ["pending", "confirmed_spam", "not_spam", "dismissed"];
+export type LifeOpsGmailSpamReviewStatus = (typeof LIFEOPS_GMAIL_SPAM_REVIEW_STATUSES)[number];
+export interface LifeOpsGmailSpamReviewItem {
+    id: string;
+    agentId: string;
+    provider: "google";
+    side: LifeOpsConnectorSide;
+    grantId: string;
+    accountEmail: string | null;
+    messageId: string;
+    externalMessageId: string;
+    threadId: string;
+    subject: string;
+    from: string;
+    fromEmail: string | null;
+    receivedAt: string;
+    snippet: string;
+    labels: string[];
+    rationale: string;
+    confidence: number;
+    status: LifeOpsGmailSpamReviewStatus;
+    createdAt: string;
+    updatedAt: string;
+    reviewedAt: string | null;
+}
+export interface LifeOpsGmailSpamReviewSummary {
+    totalCount: number;
+    pendingCount: number;
+    confirmedSpamCount: number;
+    notSpamCount: number;
+    dismissedCount: number;
+}
+export interface LifeOpsGmailSpamReviewFeed {
+    items: LifeOpsGmailSpamReviewItem[];
+    summary: LifeOpsGmailSpamReviewSummary;
+}
+export interface GetLifeOpsGmailSpamReviewRequest {
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+    grantId?: string;
+    status?: LifeOpsGmailSpamReviewStatus;
+    maxResults?: number;
+}
+export interface UpdateLifeOpsGmailSpamReviewItemRequest {
+    status: LifeOpsGmailSpamReviewStatus;
+}
+export interface LifeOpsGmailUnrespondedThread {
+    threadId: string;
+    messageId: string;
+    subject: string;
+    to: string[];
+    cc: string[];
+    lastOutboundAt: string;
+    lastInboundAt: string | null;
+    daysWaiting: number;
+    snippet: string;
+    labels: string[];
+    htmlLink: string | null;
+    grantId?: string;
+    accountEmail?: string;
+}
+export interface LifeOpsGmailUnrespondedSummary {
+    totalCount: number;
+    oldestDaysWaiting: number | null;
+}
+export interface LifeOpsGmailUnrespondedFeed {
+    threads: LifeOpsGmailUnrespondedThread[];
+    source: "synced";
+    syncedAt: string;
+    summary: LifeOpsGmailUnrespondedSummary;
+}
+export interface GetLifeOpsGmailUnrespondedRequest {
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+    grantId?: string;
+    olderThanDays?: number;
+    maxResults?: number;
+}
+export interface IngestLifeOpsGmailEventRequest {
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+    grantId?: string;
+    messageId: string;
+    eventKind?: "gmail.message.received" | "gmail.thread.needs_response";
+    occurredAt?: string;
+    maxWorkflowRuns?: number;
+}
+export interface LifeOpsGmailEventIngestResult {
+    ok: true;
+    event: {
+        id: string;
+        kind: "gmail.message.received" | "gmail.thread.needs_response";
+        occurredAt: string;
+        payload: Record<string, unknown>;
+    };
+    workflowRunIds: string[];
+}
 export declare const LIFEOPS_GMAIL_DRAFT_TONES: readonly ["brief", "neutral", "warm"];
 export type LifeOpsGmailDraftTone = (typeof LIFEOPS_GMAIL_DRAFT_TONES)[number];
 export interface CreateLifeOpsGmailReplyDraftRequest {
@@ -1128,6 +1436,59 @@ export interface LifeOpsNextCalendarEventContext {
     linkedMailError: string | null;
     linkedMail: Array<Pick<LifeOpsGmailMessageSummary, "id" | "subject" | "from" | "receivedAt" | "snippet" | "htmlLink">>;
 }
+export interface LifeOpsCalendarEventReminderOverride {
+    minutesBefore: number;
+}
+export interface LifeOpsCalendarEventUpdate {
+    title?: string;
+    startAt?: string;
+    endAt?: string;
+    notes?: string;
+    reminders?: LifeOpsCalendarEventReminderOverride[];
+}
+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 {
+    id: string;
+    displayName: string;
+    avatarUrl: string | null;
+}
+export interface LifeOpsInboxMessageSourceRef {
+    channel: LifeOpsInboxChannel;
+    externalId: string;
+}
+export interface LifeOpsInboxMessage {
+    /** Channel-prefixed, globally unique identifier. */
+    id: string;
+    channel: LifeOpsInboxChannel;
+    sender: LifeOpsInboxMessageSender;
+    /** Gmail-style subject; `null` for chat channels. */
+    subject: string | null;
+    snippet: string;
+    /** ISO-8601 timestamp. */
+    receivedAt: string;
+    unread: boolean;
+    deepLink: string | null;
+    sourceRef: LifeOpsInboxMessageSourceRef;
+}
+export interface LifeOpsInboxChannelCount {
+    total: number;
+    unread: number;
+}
+export interface LifeOpsInbox {
+    messages: LifeOpsInboxMessage[];
+    channelCounts: Record<LifeOpsInboxChannel, LifeOpsInboxChannelCount>;
+    fetchedAt: string;
+}
+export interface GetLifeOpsInboxRequest {
+    /** Cap on the total number of messages returned. Defaults to 100. */
+    limit?: number;
+    /** If omitted, all connected channels are included. */
+    channels?: LifeOpsInboxChannel[];
+}
 export declare const LIFEOPS_GOOGLE_CONNECTOR_REASONS: readonly ["connected", "disconnected", "config_missing", "token_missing", "needs_reauth"];
 export type LifeOpsGoogleConnectorReason = (typeof LIFEOPS_GOOGLE_CONNECTOR_REASONS)[number];
 export declare const LIFEOPS_CONNECTOR_DEGRADATION_AXES: readonly ["missing-scope", "rate-limited", "disconnected", "auth-expired", "session-revoked", "delivery-degraded", "helper-disconnected", "retry-idempotent", "hold-expired", "transport-offline", "blocked-resume"];
@@ -1161,17 +1522,30 @@ export interface LifeOpsGoogleConnectorStatus {
 }
 export interface LifeOpsXConnectorStatus {
     provider: "x";
+    side?: LifeOpsConnectorSide;
     mode: LifeOpsConnectorMode;
+    defaultMode?: LifeOpsConnectorMode;
+    availableModes?: LifeOpsConnectorMode[];
+    executionTarget?: LifeOpsConnectorExecutionTarget;
+    sourceOfTruth?: LifeOpsConnectorSourceOfTruth;
+    configured?: boolean;
     connected: boolean;
+    reason?: "connected" | "disconnected" | "config_missing" | "needs_reauth";
+    preferredByAgent?: boolean;
+    cloudConnectionId?: string | null;
     grantedCapabilities: LifeOpsXCapability[];
     grantedScopes: string[];
     identity: Record<string, unknown> | null;
     hasCredentials: boolean;
+    feedRead: boolean;
+    feedWrite: boolean;
+    dmRead: boolean;
+    dmWrite: boolean;
     /**
-     * DM inbound read is supported when `x.read` capability is granted.
+     * DM inbound read is supported when `x.dm.read` capability is granted.
      * Use `syncXDms()` to pull and persist, then `getXDms()` or
      * `readXInboundDms()` to retrieve.
-    */
+     */
     dmInbound: boolean;
     grant: LifeOpsConnectorGrant | null;
     degradations?: LifeOpsConnectorDegradation[];
@@ -1414,13 +1788,32 @@ export interface DisconnectLifeOpsGoogleConnectorRequest {
     mode?: LifeOpsConnectorMode;
 }
 export interface UpsertLifeOpsXConnectorRequest {
+    side?: LifeOpsConnectorSide;
     mode?: LifeOpsConnectorMode;
     capabilities: LifeOpsXCapability[];
     grantedScopes?: string[];
     identity?: Record<string, unknown>;
     metadata?: Record<string, unknown>;
 }
+export interface StartLifeOpsXConnectorRequest {
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+    redirectUrl?: string;
+}
+export interface StartLifeOpsXConnectorResponse {
+    provider: "x";
+    side: LifeOpsConnectorSide;
+    mode: LifeOpsConnectorMode;
+    requestedCapabilities: LifeOpsXCapability[];
+    redirectUri: string;
+    authUrl: string;
+}
+export interface DisconnectLifeOpsXConnectorRequest {
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+}
 export interface CreateLifeOpsXPostRequest {
+    side?: LifeOpsConnectorSide;
     mode?: LifeOpsConnectorMode;
     text: string;
     confirmPost?: boolean;
@@ -1430,7 +1823,7 @@ export interface LifeOpsXPostResponse {
     status: number | null;
     postId?: string;
     error?: string;
-    category: "success" | "auth" | "rate_limit" | "network" | "unknown";
+    category: "success" | "auth" | "rate_limit" | "network" | "invalid" | "unknown";
 }
 export interface CreateLifeOpsDefinitionRequest {
     ownership?: LifeOpsOwnershipInput;
@@ -1539,6 +1932,47 @@ export interface LifeOpsGoalReview {
         semanticReviewedAt?: string | null;
     };
 }
+export interface LifeOpsGoalExperienceLoopSuggestion {
+    sourceGoalId: string;
+    definitionId: string | null;
+    title: string;
+    detail: string;
+}
+export interface LifeOpsGoalExperienceLoopMatch {
+    goalId: string;
+    title: string;
+    description: string;
+    score: number;
+    status: LifeOpsGoalStatus;
+    reviewState: LifeOpsGoalReviewState;
+    linkedDefinitionCount: number;
+    completedLast7Days: number;
+    lastActivityAt: string | null;
+    explanation: string;
+    carryForwardSuggestions: LifeOpsGoalExperienceLoopSuggestion[];
+}
+export interface LifeOpsGoalExperienceLoop {
+    referenceGoalId: string | null;
+    referenceTitle: string;
+    similarGoals: LifeOpsGoalExperienceLoopMatch[];
+    suggestedCarryForward: LifeOpsGoalExperienceLoopSuggestion[];
+    summary: string | null;
+}
+export interface LifeOpsWeeklyGoalReview {
+    generatedAt: string;
+    reviewWindow: "this_week";
+    summary: {
+        totalGoals: number;
+        onTrackCount: number;
+        atRiskCount: number;
+        needsAttentionCount: number;
+        idleCount: number;
+    };
+    onTrack: LifeOpsGoalReview[];
+    atRisk: LifeOpsGoalReview[];
+    needsAttention: LifeOpsGoalReview[];
+    idle: LifeOpsGoalReview[];
+}
 export interface LifeOpsDefinitionPerformanceWindow {
     scheduledCount: number;
     completedCount: number;
@@ -1622,6 +2056,26 @@ export interface CaptureLifeOpsActivitySignalRequest {
     health?: LifeOpsHealthSignal | null;
     metadata?: Record<string, unknown>;
 }
+/**
+ * User-attested circadian override. Emitted with maximum reliability weight;
+ * force-transitions the state machine. See `sleep-wake-spec.md` §2 (manual
+ * override row in the transition table).
+ */
+export declare const LIFEOPS_MANUAL_OVERRIDE_KINDS: readonly ["going_to_bed", "just_woke_up"];
+export type LifeOpsManualOverrideKind = (typeof LIFEOPS_MANUAL_OVERRIDE_KINDS)[number];
+export interface CaptureLifeOpsManualOverrideRequest {
+    kind: LifeOpsManualOverrideKind;
+    occurredAt?: string;
+    /** Optional user note capped at 500 chars. */
+    note?: string;
+}
+export interface LifeOpsManualOverrideResult {
+    accepted: true;
+    kind: LifeOpsManualOverrideKind;
+    occurredAt: string;
+    circadianState: LifeOpsCircadianState;
+    stateConfidence: number;
+}
 export interface ProcessLifeOpsRemindersRequest {
     now?: string;
     limit?: number;
@@ -1719,6 +2173,11 @@ export interface CreateLifeOpsBrowserSessionRequest {
 export interface ConfirmLifeOpsBrowserSessionRequest {
     confirmed: boolean;
 }
+export interface UpdateLifeOpsBrowserSessionProgressRequest {
+    currentActionIndex?: number;
+    result?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
 export interface CompleteLifeOpsBrowserSessionRequest {
     status?: Extract<LifeOpsBrowserSessionStatus, "done" | "failed">;
     result?: Record<string, unknown>;