@elizaos/agent 2.0.0-alpha.173 → 2.0.0-alpha.192

package/apps/app-lifeops/src/activity-profile/activity-tracker-service.js

@@ -0,0 +1,84 @@
+/**
+ * T8d — Activity tracker service.
+ *
+ * Starts the macOS Swift collector (when available) and writes focus events
+ * to `life_activity_events`. On non-Darwin platforms the service is a no-op
+ * that logs "no events" once at startup and returns empty reports via the
+ * action layer.
+ *
+ * The service does not mutate any cached profile state; reporting runs on
+ * demand via {@link getActivityReport}.
+ */
+import { Service, logger } from "@elizaos/core";
+import { isSupportedPlatform, startActivityCollector, } from "@elizaos/native-activity-tracker";
+import { insertActivityEvent } from "./activity-tracker-repo.js";
+export class ActivityTrackerService extends Service {
+    static serviceType = "activity_tracker";
+    capabilityDescription = "T8d — macOS activity tracker. Records per-app focus transitions to life_activity_events for WakaTime-style reports.";
+    handle = null;
+    mode = "disabled-non-darwin";
+    writeFailures = 0;
+    static async start(runtime) {
+        const service = new ActivityTrackerService(runtime);
+        await service.startCollector();
+        return service;
+    }
+    async stop() {
+        if (this.handle) {
+            await this.handle.stop();
+            this.handle = null;
+        }
+    }
+    getMode() {
+        return this.mode;
+    }
+    async startCollector() {
+        if (!isSupportedPlatform()) {
+            this.mode = "disabled-non-darwin";
+            logger.info({ platform: process.platform }, "[activity-tracker] Non-Darwin platform — collector disabled; reports will be empty.");
+            return;
+        }
+        try {
+            this.handle = startActivityCollector({
+                onEvent: (event) => {
+                    void this.persistEvent(event);
+                },
+                onFatal: (reason) => {
+                    this.mode = "failed";
+                    logger.error({ reason }, "[activity-tracker] Collector terminated — events will stop flowing.");
+                },
+            });
+            this.mode = "running";
+            logger.info({ pid: this.handle.pid }, "[activity-tracker] macOS collector running.");
+        }
+        catch (err) {
+            this.mode = "failed";
+            const message = err instanceof Error ? err.message : String(err);
+            logger.warn({ err: message }, "[activity-tracker] Failed to start macOS collector; reports will be empty until resolved.");
+        }
+    }
+    async persistEvent(event) {
+        const runtime = this.runtime;
+        if (!runtime)
+            return;
+        const agentId = String(runtime.agentId);
+        const observedAt = new Date(event.ts).toISOString();
+        try {
+            await insertActivityEvent(runtime, {
+                agentId,
+                observedAt,
+                eventKind: event.event,
+                bundleId: event.bundleId,
+                appName: event.appName,
+                windowTitle: event.windowTitle ?? null,
+            });
+            this.writeFailures = 0;
+        }
+        catch (err) {
+            this.writeFailures += 1;
+            if (this.writeFailures <= 3) {
+                logger.error({ err: err instanceof Error ? err.message : String(err) }, "[activity-tracker] Failed to persist activity event.");
+            }
+        }
+    }
+}

package/apps/app-lifeops/src/activity-profile/analyzer.d.ts.map

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

package/apps/app-lifeops/src/activity-profile/analyzer.js

@@ -0,0 +1,544 @@
+import { getLocalDateKey, getZonedDateParts } from "../lifeops/time.js";
+import { ALL_TIME_BUCKETS, emptyBucketCounts, } from "./types.js";
+// ── Time bucket classification ─────────────────────────
+const BUCKET_RANGES = [
+    { bucket: "EARLY_MORNING", start: 5, end: 7 },
+    { bucket: "MORNING", start: 7, end: 10 },
+    { bucket: "MIDDAY", start: 10, end: 14 },
+    { bucket: "AFTERNOON", start: 14, end: 17 },
+    { bucket: "EVENING", start: 17, end: 21 },
+    { bucket: "NIGHT", start: 21, end: 24 },
+    // LATE_NIGHT wraps: 0-5
+];
+export function classifyTimeBucket(hour) {
+    if (hour >= 0 && hour < 5)
+        return "LATE_NIGHT";
+    for (const { bucket, start, end } of BUCKET_RANGES) {
+        if (hour >= start && hour < end)
+            return bucket;
+    }
+    // hour === 24 shouldn't happen but treat as LATE_NIGHT
+    return "LATE_NIGHT";
+}
+export function resolveCurrentBucket(timezone, now) {
+    const date = now ?? new Date();
+    const parts = getZonedDateParts(date, timezone);
+    return classifyTimeBucket(parts.hour);
+}
+export const SUSTAINED_INACTIVITY_GAP_MS = 3 * 60 * 60 * 1000; // 3 hours
+const ACTIVE_THRESHOLD_MS = 15 * 60 * 1000; // 15 minutes
+const SIGNIFICANT_BUCKET_SHARE = 0.1; // 10% of total messages
+const SCREEN_ACTIVE_FOCUS = new Set(["work", "leisure", "transition"]);
+const SCREEN_ACTIVITY_CONFIDENCE_FLOOR = 0.35;
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function localDateKeyForTimestamp(timestamp, timezone) {
+    return getLocalDateKey(getZonedDateParts(new Date(timestamp), timezone));
+}
+function parseTimestamp(value) {
+    if (!value) {
+        return null;
+    }
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function parseHealthSnapshot(signal) {
+    if (signal.source !== "mobile_health") {
+        return null;
+    }
+    const health = signal.health ??
+        (isRecord(signal.metadata.health) ? signal.metadata.health : null);
+    if (!health) {
+        return null;
+    }
+    const sleep = isRecord(health.sleep) ? health.sleep : null;
+    const biometrics = isRecord(health.biometrics) ? health.biometrics : null;
+    const isSleeping = Boolean(sleep?.isSleeping);
+    const sleepStartedAt = parseTimestamp(typeof sleep?.asleepAt === "string" ? sleep.asleepAt : null);
+    const sleepEndedAt = parseTimestamp(typeof sleep?.awakeAt === "string" ? sleep.awakeAt : null);
+    const biometricsSampleAt = parseTimestamp(typeof biometrics?.sampleAt === "string" ? biometrics.sampleAt : null);
+    return {
+        observedAt: signal.observedAt,
+        platform: signal.platform,
+        source: typeof health.source === "string" ? health.source : "healthkit",
+        isSleeping,
+        sleepStartedAt,
+        sleepEndedAt,
+        durationMinutes: typeof sleep?.durationMinutes === "number" &&
+            Number.isFinite(sleep.durationMinutes)
+            ? sleep.durationMinutes
+            : null,
+        biometricsSampleAt,
+    };
+}
+function buildActivitySession(startAt, endAt, timezone) {
+    const startParts = getZonedDateParts(new Date(startAt), timezone);
+    const endParts = getZonedDateParts(new Date(endAt), timezone);
+    const startDayKey = getLocalDateKey(startParts);
+    const startDayOrdinal = Math.floor(Date.UTC(startParts.year, startParts.month - 1, startParts.day) /
+        86_400_000);
+    const endDayOrdinal = Math.floor(Date.UTC(endParts.year, endParts.month - 1, endParts.day) / 86_400_000);
+    return {
+        startAt,
+        endAt,
+        startHour: startParts.hour,
+        normalizedEndHour: endParts.hour + (endDayOrdinal - startDayOrdinal) * 24,
+        startDayKey,
+    };
+}
+function buildActivitySessionsFromTimestamps(timestamps, timezone) {
+    if (timestamps.length === 0) {
+        return [];
+    }
+    const sorted = [...timestamps].sort((left, right) => left - right);
+    const sessions = [];
+    let sessionStartAt = sorted[0] ?? 0;
+    let sessionEndAt = sorted[0] ?? 0;
+    for (let index = 1; index < sorted.length; index += 1) {
+        const current = sorted[index] ?? 0;
+        if (current - sessionEndAt > SUSTAINED_INACTIVITY_GAP_MS) {
+            sessions.push(buildActivitySession(sessionStartAt, sessionEndAt, timezone));
+            sessionStartAt = current;
+        }
+        sessionEndAt = current;
+    }
+    sessions.push(buildActivitySession(sessionStartAt, sessionEndAt, timezone));
+    return sessions;
+}
+function isActiveSignal(signal, nowMs) {
+    return signal.state === "active" && signal.observedAt <= nowMs;
+}
+function resolveLatestInteractionSnapshot(messages, ownerEntityId, roomSourceMap, currentTime, activitySignals) {
+    let latestOwnerSeenAt = 0;
+    let latestOwnerPlatform = null;
+    let latestClientChatSeenAt = 0;
+    let latestSignalSeenAt = 0;
+    let latestSignalPlatform = null;
+    for (const msg of messages) {
+        if (msg.createdAt > currentTime.getTime()) {
+            continue;
+        }
+        const source = roomSourceMap.get(msg.roomId) ?? "unknown";
+        if (source === "client_chat" && msg.createdAt > latestClientChatSeenAt) {
+            latestClientChatSeenAt = msg.createdAt;
+        }
+        if (msg.entityId === ownerEntityId && msg.createdAt > latestOwnerSeenAt) {
+            latestOwnerSeenAt = msg.createdAt;
+            latestOwnerPlatform = source;
+        }
+    }
+    if (latestClientChatSeenAt > latestOwnerSeenAt) {
+        latestOwnerSeenAt = latestClientChatSeenAt;
+        latestOwnerPlatform = "client_chat";
+    }
+    for (const signal of activitySignals) {
+        if (!isActiveSignal(signal, currentTime.getTime())) {
+            continue;
+        }
+        if (signal.observedAt > latestSignalSeenAt) {
+            latestSignalSeenAt = signal.observedAt;
+            latestSignalPlatform = signal.platform;
+        }
+    }
+    if (latestSignalSeenAt > latestOwnerSeenAt) {
+        return {
+            lastSeenAt: latestSignalSeenAt,
+            lastSeenPlatform: latestSignalPlatform,
+        };
+    }
+    return {
+        lastSeenAt: latestOwnerSeenAt,
+        lastSeenPlatform: latestOwnerPlatform,
+    };
+}
+function resolveScreenHeartbeatAt(profile) {
+    if (!profile.screenContextAvailable || profile.screenContextStale) {
+        return 0;
+    }
+    if (!profile.screenContextSampledAt || profile.screenContextSampledAt <= 0) {
+        return 0;
+    }
+    if (!SCREEN_ACTIVE_FOCUS.has(profile.screenContextFocus ?? "unknown")) {
+        return 0;
+    }
+    if (profile.screenContextConfidence !== null &&
+        profile.screenContextConfidence < SCREEN_ACTIVITY_CONFIDENCE_FLOOR) {
+        return 0;
+    }
+    return profile.screenContextSampledAt;
+}
+export function resolveCurrentActivityState(profile, now) {
+    const currentTime = now.getTime();
+    const thresholdMs = profile.sustainedInactivityThresholdMinutes * 60 * 1000;
+    const screenHeartbeatAt = resolveScreenHeartbeatAt(profile);
+    const sleeping = profile.isCurrentlySleeping === true;
+    const sleepBoundaryAt = profile.lastSleepSignalAt ?? profile.lastWakeSignalAt ?? profile.lastSeenAt;
+    const mostRecentActivityAt = sleeping
+        ? sleepBoundaryAt
+        : Math.max(profile.lastSeenAt, screenHeartbeatAt);
+    const hasOpenActivityCycle = !sleeping &&
+        mostRecentActivityAt > 0 &&
+        currentTime - mostRecentActivityAt <= thresholdMs;
+    const cycleStart = !sleeping &&
+        profile.currentActivityCycleStartedAt &&
+        (profile.hasOpenActivityCycle ||
+            mostRecentActivityAt - profile.currentActivityCycleStartedAt <=
+                thresholdMs)
+        ? profile.currentActivityCycleStartedAt
+        : hasOpenActivityCycle
+            ? mostRecentActivityAt
+            : profile.currentActivityCycleStartedAt;
+    const currentActivityCycleLocalDate = cycleStart
+        ? localDateKeyForTimestamp(cycleStart, profile.timezone)
+        : sleeping
+            ? sleepBoundaryAt > 0
+                ? localDateKeyForTimestamp(sleepBoundaryAt, profile.timezone)
+                : profile.currentActivityCycleLocalDate
+            : profile.currentActivityCycleLocalDate;
+    const effectiveDayKey = hasOpenActivityCycle
+        ? (currentActivityCycleLocalDate ??
+            localDateKeyForTimestamp(currentTime, profile.timezone))
+        : sleeping
+            ? (currentActivityCycleLocalDate ??
+                localDateKeyForTimestamp(currentTime, profile.timezone))
+            : localDateKeyForTimestamp(currentTime, profile.timezone);
+    return {
+        lastSeenAt: mostRecentActivityAt,
+        lastSeenPlatform: profile.lastSeenPlatform,
+        isCurrentlyActive: !sleeping &&
+            mostRecentActivityAt > 0 &&
+            currentTime - mostRecentActivityAt < ACTIVE_THRESHOLD_MS,
+        hasOpenActivityCycle,
+        currentActivityCycleStartedAt: sleeping ? null : (cycleStart ?? null),
+        currentActivityCycleLocalDate,
+        effectiveDayKey,
+    };
+}
+export function resolveEffectiveDayKey(profile, timezone, now) {
+    return resolveCurrentActivityState({
+        ...profile,
+        timezone,
+    }, now).effectiveDayKey;
+}
+function resolveLatestActivityDayKey(profile, timezone, now) {
+    const heartbeatAt = Math.max(profile.lastSeenAt, resolveScreenHeartbeatAt(profile));
+    if (heartbeatAt <= 0) {
+        return null;
+    }
+    const thresholdMs = profile.sustainedInactivityThresholdMinutes * 60 * 1000;
+    if (now.getTime() - heartbeatAt <= thresholdMs) {
+        if (profile.hasOpenActivityCycle && profile.currentActivityCycleStartedAt) {
+            return (profile.currentActivityCycleLocalDate ??
+                localDateKeyForTimestamp(profile.currentActivityCycleStartedAt, timezone));
+        }
+        return localDateKeyForTimestamp(heartbeatAt, timezone);
+    }
+    return localDateKeyForTimestamp(heartbeatAt, timezone);
+}
+export function analyzeMessages(messages, roomSourceMap, ownerEntityId, timezone, windowDays, firstOptionalArg, secondOptionalArg) {
+    const currentTime = firstOptionalArg instanceof Date
+        ? firstOptionalArg
+        : secondOptionalArg instanceof Date
+            ? secondOptionalArg
+            : new Date();
+    const activitySignals = Array.isArray(firstOptionalArg)
+        ? firstOptionalArg
+        : Array.isArray(secondOptionalArg)
+            ? secondOptionalArg
+            : [];
+    const windowStart = currentTime.getTime() - windowDays * 24 * 60 * 60 * 1000;
+    // Filter to owner messages within window
+    const ownerMessages = messages.filter((m) => m.entityId === ownerEntityId &&
+        m.createdAt >= windowStart &&
+        m.createdAt <= currentTime.getTime());
+    const activeSignals = activitySignals.filter((signal) => signal.observedAt >= windowStart &&
+        isActiveSignal(signal, currentTime.getTime()));
+    const healthSnapshots = activitySignals
+        .map((signal) => parseHealthSnapshot(signal))
+        .filter((snapshot) => snapshot !== null);
+    // Group by platform
+    const platformMap = new Map();
+    const aggregateBuckets = emptyBucketCounts();
+    for (const msg of ownerMessages) {
+        const source = roomSourceMap.get(msg.roomId) ?? "unknown";
+        let entry = platformMap.get(source);
+        if (!entry) {
+            entry = { count: 0, buckets: emptyBucketCounts(), lastAt: 0 };
+            platformMap.set(source, entry);
+        }
+        entry.count++;
+        if (msg.createdAt > entry.lastAt)
+            entry.lastAt = msg.createdAt;
+        const parts = getZonedDateParts(new Date(msg.createdAt), timezone);
+        const bucket = classifyTimeBucket(parts.hour);
+        entry.buckets[bucket]++;
+        aggregateBuckets[bucket]++;
+    }
+    for (const signal of activeSignals) {
+        const source = signal.platform.trim().length > 0 ? signal.platform : "client_chat";
+        let entry = platformMap.get(source);
+        if (!entry) {
+            entry = { count: 0, buckets: emptyBucketCounts(), lastAt: 0 };
+            platformMap.set(source, entry);
+        }
+        entry.count++;
+        if (signal.observedAt > entry.lastAt)
+            entry.lastAt = signal.observedAt;
+        const parts = getZonedDateParts(new Date(signal.observedAt), timezone);
+        const bucket = classifyTimeBucket(parts.hour);
+        entry.buckets[bucket]++;
+        aggregateBuckets[bucket]++;
+    }
+    // Build sorted platform list
+    const platforms = Array.from(platformMap.entries())
+        .map(([source, data]) => ({
+        source,
+        messageCount: data.count,
+        bucketCounts: data.buckets,
+        lastMessageAt: data.lastAt,
+        averageMessagesPerDay: windowDays > 0 ? data.count / windowDays : 0,
+    }))
+        .sort((a, b) => b.messageCount - a.messageCount);
+    // Derive typical active hours from aggregate histogram
+    const totalMessages = ownerMessages.length;
+    const activityPointCount = totalMessages + activeSignals.length;
+    const threshold = activityPointCount > 0
+        ? Math.max(activityPointCount * SIGNIFICANT_BUCKET_SHARE, 1)
+        : Infinity;
+    let typicalFirstActiveHour = null;
+    let typicalLastActiveHour = null;
+    // Walk buckets in chronological order (EARLY_MORNING first)
+    for (const bucket of ALL_TIME_BUCKETS) {
+        if (aggregateBuckets[bucket] >= threshold) {
+            const midHour = bucketMidpointHour(bucket);
+            if (typicalFirstActiveHour === null)
+                typicalFirstActiveHour = midHour;
+            typicalLastActiveHour = midHour;
+        }
+    }
+    const sessions = buildActivitySessionsFromTimestamps([
+        ...ownerMessages.map((message) => message.createdAt),
+        ...activeSignals.map((signal) => signal.observedAt),
+    ], timezone);
+    const sleepHoursFromHealth = healthSnapshots
+        .filter((snapshot) => snapshot.sleepStartedAt !== null)
+        .map((snapshot) => getZonedDateParts(new Date(snapshot.sleepStartedAt ?? 0), timezone)
+        .hour);
+    const wakeHoursFromHealth = healthSnapshots
+        .filter((snapshot) => snapshot.sleepEndedAt !== null)
+        .map((snapshot) => getZonedDateParts(new Date(snapshot.sleepEndedAt ?? 0), timezone).hour);
+    const wakeHours = sessions
+        .map((session) => session.startHour)
+        .concat(wakeHoursFromHealth)
+        .sort((left, right) => left - right);
+    const sleepHours = sessions
+        .map((session) => session.normalizedEndHour)
+        .concat(sleepHoursFromHealth)
+        .sort((left, right) => left - right);
+    const typicalWakeHour = wakeHours.length > 0 ? median(wakeHours) : null;
+    const typicalSleepHour = sleepHours.length > 0 ? median(sleepHours) : null;
+    const sleepDurations = healthSnapshots
+        .map((snapshot) => snapshot.durationMinutes)
+        .filter((value) => typeof value === "number");
+    const typicalSleepDurationMinutes = sleepDurations.length > 0
+        ? Math.round(sleepDurations.reduce((sum, value) => sum + value, 0) /
+            sleepDurations.length)
+        : null;
+    const latestHealthSnapshot = healthSnapshots.length > 0
+        ? ([...healthSnapshots].sort((left, right) => right.observedAt - left.observedAt)[0] ?? null)
+        : null;
+    const latestSleepingHealthSnapshot = [...healthSnapshots]
+        .filter((snapshot) => snapshot.isSleeping)
+        .sort((left, right) => right.observedAt - left.observedAt)[0] ?? null;
+    const latestWakeHealthSnapshot = [...healthSnapshots]
+        .filter((snapshot) => !snapshot.isSleeping)
+        .sort((left, right) => right.observedAt - left.observedAt)[0] ?? null;
+    // Current state
+    const latestInteraction = resolveLatestInteractionSnapshot(messages, ownerEntityId, roomSourceMap, currentTime, activeSignals);
+    let lastSeenAt = latestInteraction.lastSeenAt;
+    let lastSeenPlatform = latestInteraction.lastSeenPlatform;
+    if (latestHealthSnapshot) {
+        const healthBoundaryAt = latestHealthSnapshot.isSleeping
+            ? (latestHealthSnapshot.sleepStartedAt ?? latestHealthSnapshot.observedAt)
+            : (latestHealthSnapshot.sleepEndedAt ?? latestHealthSnapshot.observedAt);
+        if (healthBoundaryAt > lastSeenAt) {
+            lastSeenAt = healthBoundaryAt;
+            lastSeenPlatform = latestHealthSnapshot.platform;
+        }
+    }
+    const isCurrentlySleeping = latestHealthSnapshot?.isSleeping === true;
+    const hasSleepData = healthSnapshots.length > 0;
+    const lastSleepSignalAt = latestSleepingHealthSnapshot?.sleepStartedAt ??
+        latestSleepingHealthSnapshot?.observedAt ??
+        null;
+    const lastWakeSignalAt = latestWakeHealthSnapshot?.sleepEndedAt ??
+        latestWakeHealthSnapshot?.observedAt ??
+        null;
+    const hasOpenActivityCycle = !isCurrentlySleeping &&
+        lastSeenAt > 0 &&
+        currentTime.getTime() - lastSeenAt <= SUSTAINED_INACTIVITY_GAP_MS;
+    const currentActivityCycle = sessions.length > 0 ? sessions[sessions.length - 1] : null;
+    const latestInteractionStartsNewCycle = !isCurrentlySleeping &&
+        lastSeenAt > 0 &&
+        (!currentActivityCycle || lastSeenAt > currentActivityCycle.endAt);
+    const currentActivityCycleStartedAt = latestInteractionStartsNewCycle
+        ? lastSeenAt
+        : isCurrentlySleeping
+            ? null
+            : (currentActivityCycle?.startAt ?? lastSeenAt);
+    const currentActivityCycleLocalDate = latestInteractionStartsNewCycle
+        ? localDateKeyForTimestamp(lastSeenAt, timezone)
+        : isCurrentlySleeping
+            ? lastSleepSignalAt !== null
+                ? localDateKeyForTimestamp(lastSleepSignalAt, timezone)
+                : localDateKeyForTimestamp(currentTime.getTime(), timezone)
+            : (currentActivityCycle?.startDayKey ??
+                localDateKeyForTimestamp(lastSeenAt, timezone));
+    return {
+        ownerEntityId,
+        analyzedAt: currentTime.getTime(),
+        analysisWindowDays: windowDays,
+        timezone,
+        totalMessages,
+        sustainedInactivityThresholdMinutes: SUSTAINED_INACTIVITY_GAP_MS / 60_000,
+        platforms,
+        primaryPlatform: platforms[0]?.source ?? null,
+        secondaryPlatform: platforms[1]?.source ?? null,
+        bucketCounts: aggregateBuckets,
+        typicalFirstActiveHour,
+        typicalLastActiveHour,
+        typicalWakeHour,
+        typicalSleepHour,
+        hasSleepData,
+        isCurrentlySleeping,
+        lastSleepSignalAt,
+        lastWakeSignalAt,
+        sleepSourcePlatform: latestHealthSnapshot?.platform ?? null,
+        sleepSource: latestHealthSnapshot?.source ?? null,
+        typicalSleepDurationMinutes,
+        lastSeenAt,
+        lastSeenPlatform,
+        isCurrentlyActive: !isCurrentlySleeping &&
+            currentTime.getTime() - lastSeenAt < ACTIVE_THRESHOLD_MS,
+        hasOpenActivityCycle,
+        currentActivityCycleStartedAt,
+        currentActivityCycleLocalDate,
+        effectiveDayKey: hasOpenActivityCycle
+            ? (currentActivityCycleLocalDate ??
+                localDateKeyForTimestamp(currentTime.getTime(), timezone))
+            : isCurrentlySleeping
+                ? (currentActivityCycleLocalDate ??
+                    (lastSleepSignalAt !== null
+                        ? localDateKeyForTimestamp(lastSleepSignalAt, timezone)
+                        : localDateKeyForTimestamp(currentTime.getTime(), timezone)))
+                : localDateKeyForTimestamp(currentTime.getTime(), timezone),
+        screenContextFocus: null,
+        screenContextSource: null,
+        screenContextSampledAt: null,
+        screenContextConfidence: null,
+        screenContextBusy: false,
+        screenContextAvailable: false,
+        screenContextStale: false,
+    };
+}
+// ── Calendar enrichment ────────────────────────────────
+export function enrichWithCalendar(profile, calendarEvents, timezone) {
+    if (calendarEvents.length === 0) {
+        return {
+            ...profile,
+            hasCalendarData: false,
+            typicalFirstEventHour: null,
+            typicalLastEventHour: null,
+            avgWeekdayMeetings: null,
+        };
+    }
+    // Filter to non-all-day events and extract local hours
+    const eventHours = [];
+    for (const event of calendarEvents) {
+        if (event.isAllDay)
+            continue;
+        const start = new Date(event.startAt);
+        const end = new Date(event.endAt);
+        const startParts = getZonedDateParts(start, timezone);
+        const endParts = getZonedDateParts(end, timezone);
+        const date = new Date(start);
+        eventHours.push({
+            startHour: startParts.hour,
+            endHour: endParts.hour,
+            dayOfWeek: date.getDay(), // 0=Sun, 1=Mon, ...
+        });
+    }
+    if (eventHours.length === 0) {
+        return {
+            ...profile,
+            hasCalendarData: true,
+            typicalFirstEventHour: null,
+            typicalLastEventHour: null,
+            avgWeekdayMeetings: null,
+        };
+    }
+    // Weekday events only (Mon-Fri)
+    const weekdayEvents = eventHours.filter((e) => e.dayOfWeek >= 1 && e.dayOfWeek <= 5);
+    // Compute median first event hour on weekdays
+    const firstHours = weekdayEvents
+        .map((e) => e.startHour)
+        .sort((a, b) => a - b);
+    const lastHours = weekdayEvents.map((e) => e.endHour).sort((a, b) => a - b);
+    const typicalFirstEventHour = firstHours.length > 0 ? median(firstHours) : null;
+    const typicalLastEventHour = lastHours.length > 0 ? median(lastHours) : null;
+    // Average weekday meetings: count unique weekdays, divide total by that
+    const weekdaySet = new Set(weekdayEvents.map((e) => e.dayOfWeek));
+    const avgWeekdayMeetings = weekdaySet.size > 0
+        ? Math.round((weekdayEvents.length / weekdaySet.size) * 10) / 10
+        : null;
+    return {
+        ...profile,
+        hasCalendarData: true,
+        typicalFirstEventHour,
+        typicalLastEventHour,
+        avgWeekdayMeetings,
+    };
+}
+// ── Helpers ────────────────────────────────────────────
+function bucketMidpointHour(bucket) {
+    switch (bucket) {
+        case "EARLY_MORNING":
+            return 6;
+        case "MORNING":
+            return 8;
+        case "MIDDAY":
+            return 12;
+        case "AFTERNOON":
+            return 15;
+        case "EVENING":
+            return 19;
+        case "NIGHT":
+            return 22;
+        case "LATE_NIGHT":
+            return 3;
+    }
+}
+function median(sorted) {
+    if (sorted.length === 0) {
+        throw new Error("[activity-profile] median requires at least one value");
+    }
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 !== 0) {
+        const medianValue = sorted[mid];
+        if (medianValue === undefined) {
+            throw new Error("[activity-profile] median index out of bounds");
+        }
+        return medianValue;
+    }
+    const left = sorted[mid - 1];
+    const right = sorted[mid];
+    if (left === undefined || right === undefined) {
+        throw new Error("[activity-profile] median pair is incomplete");
+    }
+    return Math.round((left + right) / 2);
+}
+export function wasActiveToday(profile, timezone, now) {
+    return (resolveLatestActivityDayKey(profile, timezone, now) ===
+        resolveEffectiveDayKey(profile, timezone, now));
+}

package/apps/app-lifeops/src/activity-profile/proactive-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proactive-planner.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/activity-profile/proactive-planner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAyBpB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gDAAgD;IAChD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uEAAuE;IACvE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAID,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9C,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;KAClE,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAID,wBAAgB,MAAM,CACpB,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,cAAc,EAAE,EAC7B,cAAc,EAAE,iBAAiB,EAAE,EACnC,UAAU,EAAE,eAAe,GAAG,IAAI,EAClC,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,IAAI,GACT,eAAe,GAAG,IAAI,CAgFxB;AAID,wBAAgB,MAAM,CACpB,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,eAAe,GAAG,IAAI,EAClC,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,IAAI,GACT,eAAe,GAAG,IAAI,CA4BxB;AAID,wBAAgB,UAAU,CACxB,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,cAAc,EAAE,EAC7B,cAAc,EAAE,iBAAiB,EAAE,EACnC,UAAU,EAAE,eAAe,GAAG,IAAI,EAClC,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,IAAI,GACT,eAAe,EAAE,CAsEnB;AAID,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,cAAc,EAAE,EAC7B,cAAc,EAAE,iBAAiB,EAAE,EACnC,UAAU,EAAE,eAAe,GAAG,IAAI,EAClC,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,IAAI,GACT,eAAe,EAAE,CA2DnB;AAID,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,eAAe,GAAG,IAAI,EAClC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,IAAI,GACT,eAAe,EAAE,CAmEnB;AAID,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,aAAa,EAAE,OAAO,GACrB,MAAM,CAKR"}