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

package/dist/lifeops/schedule-state.js

@@ -0,0 +1,671 @@
+import crypto from "node:crypto";
+import {
+  asRecord
+} from "@elizaos/shared";
+import { resolveLifeOpsRelativeTime } from "./relative-time.js";
+import {
+  addDaysToLocalDate,
+  buildUtcDateFromLocalParts,
+  getLocalDateKey,
+  getZonedDateParts
+} from "./time.js";
+import { parseIsoMs, roundConfidence } from "./time-util.js";
+const SCHEDULE_OBSERVATION_BUCKET_MINUTES = 30;
+const SCHEDULE_OBSERVATION_LOOKBACK_MS = 48 * 60 * 60 * 1e3;
+const SCHEDULE_CLOUD_SYNC_TTL_MS = 15 * 60 * 1e3;
+const SCHEDULE_CLOUD_STATE_FRESH_MS = 45 * 60 * 1e3;
+const OBSERVATION_TTL_MS = {
+  awake: 4 * 60 * 60 * 1e3,
+  winding_down: 3 * 60 * 60 * 1e3,
+  sleeping: 8 * 60 * 60 * 1e3,
+  waking: 2 * 60 * 60 * 1e3,
+  napping: 2 * 60 * 60 * 1e3,
+  unclear: 60 * 60 * 1e3
+};
+const STATE_RANK = {
+  sleeping: 5,
+  napping: 4,
+  waking: 3,
+  winding_down: 2,
+  awake: 1,
+  unclear: 0
+};
+function defaultAwakeProbability(computedAt) {
+  return {
+    pAwake: 0,
+    pAsleep: 0,
+    pUnknown: 1,
+    contributingSources: [],
+    computedAt
+  };
+}
+function defaultScheduleRegularity() {
+  return {
+    sri: 0,
+    bedtimeStddevMin: 0,
+    wakeStddevMin: 0,
+    midSleepStddevMin: 0,
+    regularityClass: "insufficient_data",
+    sampleCount: 0,
+    windowDays: 28
+  };
+}
+function bucketIso(value, timezone, mode = "nearest") {
+  const parsed = parseIsoMs(value);
+  if (parsed === null) {
+    return null;
+  }
+  const date = new Date(parsed);
+  const parts = getZonedDateParts(date, timezone);
+  const totalMinutes = parts.hour * 60 + parts.minute;
+  const bucketSize = SCHEDULE_OBSERVATION_BUCKET_MINUTES;
+  const roundedMinutes = mode === "floor" ? Math.floor(totalMinutes / bucketSize) * bucketSize : mode === "ceil" ? Math.ceil(totalMinutes / bucketSize) * bucketSize : Math.round(totalMinutes / bucketSize) * bucketSize;
+  const dayDelta = Math.floor(roundedMinutes / (24 * 60));
+  const minutesOfDay = (roundedMinutes % (24 * 60) + 24 * 60) % (24 * 60);
+  const dateOnly = addDaysToLocalDate(parts, dayDelta);
+  const bucketed = buildUtcDateFromLocalParts(timezone, {
+    year: dateOnly.year,
+    month: dateOnly.month,
+    day: dateOnly.day,
+    hour: Math.floor(minutesOfDay / 60),
+    minute: minutesOfDay % 60,
+    second: 0
+  });
+  return bucketed.toISOString();
+}
+function isAsleepState(state) {
+  return state === "sleeping" || state === "napping";
+}
+function snapshotUncertainty(state, reason) {
+  return state === "unclear" ? reason ?? "no_signals" : null;
+}
+function toObservationSnapshot(insight) {
+  return {
+    effectiveDayKey: insight.effectiveDayKey,
+    localDate: insight.localDate,
+    phase: insight.circadianState,
+    circadianState: insight.circadianState,
+    stateConfidence: roundConfidence(insight.stateConfidence),
+    uncertaintyReason: insight.uncertaintyReason,
+    relativeTime: insight.relativeTime,
+    awakeProbability: insight.awakeProbability,
+    regularity: insight.regularity,
+    baseline: insight.baseline,
+    sleepStatus: insight.sleepStatus,
+    isProbablySleeping: isAsleepState(insight.circadianState),
+    sleepConfidence: roundConfidence(insight.sleepConfidence),
+    currentSleepStartedAt: insight.currentSleepStartedAt,
+    lastSleepStartedAt: insight.lastSleepStartedAt,
+    lastSleepEndedAt: insight.lastSleepEndedAt,
+    lastSleepDurationMinutes: insight.lastSleepDurationMinutes,
+    wakeAt: insight.wakeAt,
+    firstActiveAt: insight.firstActiveAt,
+    lastActiveAt: insight.lastActiveAt,
+    lastMealAt: insight.lastMealAt,
+    nextMealLabel: insight.nextMealLabel,
+    nextMealWindowStartAt: insight.nextMealWindowStartAt,
+    nextMealWindowEndAt: insight.nextMealWindowEndAt,
+    nextMealConfidence: roundConfidence(insight.nextMealConfidence)
+  };
+}
+function bucketSnapshot(snapshot, timezone) {
+  return {
+    ...snapshot,
+    stateConfidence: roundConfidence(snapshot.stateConfidence),
+    relativeTime: {
+      ...snapshot.relativeTime,
+      confidence: roundConfidence(snapshot.relativeTime.confidence)
+    },
+    sleepConfidence: roundConfidence(snapshot.sleepConfidence),
+    currentSleepStartedAt: bucketIso(
+      snapshot.currentSleepStartedAt,
+      timezone,
+      "floor"
+    ),
+    lastSleepStartedAt: bucketIso(
+      snapshot.lastSleepStartedAt,
+      timezone,
+      "floor"
+    ),
+    lastSleepEndedAt: bucketIso(snapshot.lastSleepEndedAt, timezone, "nearest"),
+    wakeAt: bucketIso(snapshot.wakeAt, timezone, "nearest"),
+    firstActiveAt: bucketIso(snapshot.firstActiveAt, timezone, "nearest"),
+    lastActiveAt: bucketIso(snapshot.lastActiveAt, timezone, "nearest"),
+    lastMealAt: bucketIso(snapshot.lastMealAt, timezone, "nearest"),
+    nextMealWindowStartAt: bucketIso(
+      snapshot.nextMealWindowStartAt,
+      timezone,
+      "floor"
+    ),
+    nextMealWindowEndAt: bucketIso(
+      snapshot.nextMealWindowEndAt,
+      timezone,
+      "ceil"
+    ),
+    nextMealConfidence: roundConfidence(snapshot.nextMealConfidence)
+  };
+}
+function observationMetadata(args) {
+  return {
+    source: args.source,
+    snapshot: args.snapshot,
+    ...args.extra ?? {}
+  };
+}
+function observationId(args) {
+  const digest = crypto.createHash("sha1").update(
+    [
+      args.agentId,
+      args.origin,
+      args.deviceId,
+      args.circadianState,
+      args.windowStartAt,
+      args.mealLabel ?? ""
+    ].join("|")
+  ).digest("hex").slice(0, 16);
+  return `lifeops-schedule-observation:${digest}`;
+}
+function buildObservationRecord(args) {
+  return {
+    id: observationId({
+      agentId: args.agentId,
+      origin: args.origin,
+      deviceId: args.deviceId,
+      circadianState: args.circadianState,
+      windowStartAt: args.windowStartAt,
+      mealLabel: args.mealLabel
+    }),
+    agentId: args.agentId,
+    origin: args.origin,
+    deviceId: args.deviceId,
+    deviceKind: args.deviceKind,
+    timezone: args.timezone,
+    observedAt: args.observedAt,
+    windowStartAt: args.windowStartAt,
+    windowEndAt: args.windowEndAt,
+    circadianState: args.circadianState,
+    stateConfidence: roundConfidence(args.stateConfidence),
+    uncertaintyReason: args.uncertaintyReason,
+    mealLabel: args.mealLabel,
+    metadata: args.metadata,
+    createdAt: args.observedAt,
+    updatedAt: args.observedAt
+  };
+}
+function normalizeDurationMinutes(value) {
+  if (value === null || value === void 0 || !Number.isFinite(value)) {
+    return null;
+  }
+  return Math.max(0, Math.round(value));
+}
+function resolveScheduleDeviceIdentity() {
+  const envDeviceId = process.env.ELIZA_DEVICE_ID?.trim() ?? process.env.HOSTNAME?.trim();
+  const deviceId = envDeviceId && envDeviceId.length > 0 ? envDeviceId : `${process.platform}-${crypto.createHash("sha1").update(process.cwd()).digest("hex").slice(0, 8)}`;
+  const envDeviceKind = process.env.ELIZA_DEVICE_KIND?.trim().toLowerCase() ?? "";
+  if (envDeviceKind === "iphone" || envDeviceKind === "ipad" || envDeviceKind === "mac" || envDeviceKind === "watch" || envDeviceKind === "cloud") {
+    return {
+      deviceId,
+      deviceKind: envDeviceKind
+    };
+  }
+  return {
+    deviceId,
+    deviceKind: process.platform === "darwin" ? "mac" : "unknown"
+  };
+}
+function deriveLocalScheduleObservations(args) {
+  const observedAt = args.observedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+  const snapshot = bucketSnapshot(
+    toObservationSnapshot(args.insight),
+    args.timezone
+  );
+  const windowStartAt = isAsleepState(snapshot.circadianState) ? snapshot.currentSleepStartedAt ?? snapshot.lastSleepStartedAt ?? bucketIso(observedAt, args.timezone, "floor") : snapshot.circadianState === "waking" ? snapshot.wakeAt ?? bucketIso(observedAt, args.timezone, "nearest") : snapshot.firstActiveAt ?? snapshot.wakeAt ?? snapshot.lastActiveAt ?? bucketIso(observedAt, args.timezone, "nearest");
+  const observations = [];
+  if (windowStartAt) {
+    observations.push(
+      buildObservationRecord({
+        agentId: args.agentId,
+        origin: "local_inference",
+        deviceId: args.deviceId,
+        deviceKind: args.deviceKind,
+        timezone: args.timezone,
+        observedAt,
+        circadianState: snapshot.circadianState,
+        stateConfidence: snapshot.stateConfidence,
+        uncertaintyReason: snapshot.uncertaintyReason,
+        mealLabel: null,
+        windowStartAt,
+        windowEndAt: isAsleepState(snapshot.circadianState) ? null : snapshot.lastActiveAt ?? bucketIso(observedAt, args.timezone, "nearest"),
+        metadata: observationMetadata({
+          snapshot,
+          source: "schedule_insight"
+        })
+      })
+    );
+  }
+  if (snapshot.nextMealLabel && snapshot.nextMealWindowStartAt && snapshot.nextMealConfidence >= 0.35) {
+    observations.push(
+      buildObservationRecord({
+        agentId: args.agentId,
+        origin: "local_inference",
+        deviceId: args.deviceId,
+        deviceKind: args.deviceKind,
+        timezone: args.timezone,
+        observedAt,
+        circadianState: "awake",
+        stateConfidence: snapshot.nextMealConfidence,
+        uncertaintyReason: null,
+        mealLabel: snapshot.nextMealLabel,
+        windowStartAt: snapshot.nextMealWindowStartAt,
+        windowEndAt: snapshot.nextMealWindowEndAt ?? snapshot.nextMealWindowStartAt,
+        metadata: observationMetadata({
+          snapshot,
+          source: "schedule_insight",
+          extra: { meal: true }
+        })
+      })
+    );
+  }
+  return observations;
+}
+function recordFromSyncInput(args) {
+  const snapshotSource = args.input.snapshot ?? {};
+  const bucketedWindowStartAt = bucketIso(args.input.windowStartAt, args.timezone, "floor") ?? args.input.windowStartAt;
+  const bucketedWindowEndAt = bucketIso(
+    args.input.windowEndAt ?? null,
+    args.timezone,
+    "ceil"
+  );
+  const circadianState = args.input.circadianState;
+  const uncertaintyReason = snapshotUncertainty(
+    circadianState,
+    args.input.uncertaintyReason
+  );
+  const snapshotBase = {
+    effectiveDayKey: typeof snapshotSource.effectiveDayKey === "string" ? snapshotSource.effectiveDayKey : getLocalDateKey(
+      getZonedDateParts(new Date(args.observedAt), args.timezone)
+    ),
+    localDate: typeof snapshotSource.localDate === "string" ? snapshotSource.localDate : getLocalDateKey(
+      getZonedDateParts(new Date(args.observedAt), args.timezone)
+    ),
+    phase: circadianState,
+    circadianState,
+    stateConfidence: roundConfidence(
+      snapshotSource.stateConfidence ?? args.input.stateConfidence
+    ),
+    uncertaintyReason,
+    awakeProbability: snapshotSource.awakeProbability ?? defaultAwakeProbability(args.observedAt),
+    regularity: snapshotSource.regularity ?? defaultScheduleRegularity(),
+    baseline: snapshotSource.baseline ?? null,
+    sleepStatus: snapshotSource.sleepStatus ?? "unknown",
+    isProbablySleeping: isAsleepState(circadianState),
+    sleepConfidence: roundConfidence(
+      snapshotSource.sleepConfidence ?? args.input.stateConfidence
+    ),
+    currentSleepStartedAt: bucketIso(snapshotSource.currentSleepStartedAt, args.timezone, "floor") ?? (isAsleepState(circadianState) ? bucketIso(args.input.windowStartAt, args.timezone, "floor") : null),
+    lastSleepStartedAt: bucketIso(
+      snapshotSource.lastSleepStartedAt,
+      args.timezone,
+      "floor"
+    ),
+    lastSleepEndedAt: bucketIso(
+      snapshotSource.lastSleepEndedAt,
+      args.timezone,
+      "nearest"
+    ),
+    lastSleepDurationMinutes: normalizeDurationMinutes(
+      snapshotSource.lastSleepDurationMinutes ?? null
+    ),
+    wakeAt: bucketIso(snapshotSource.wakeAt, args.timezone, "nearest") ?? (circadianState === "waking" ? bucketIso(args.input.windowStartAt, args.timezone, "nearest") : null),
+    firstActiveAt: bucketIso(
+      snapshotSource.firstActiveAt,
+      args.timezone,
+      "nearest"
+    ),
+    lastActiveAt: bucketIso(snapshotSource.lastActiveAt, args.timezone, "nearest") ?? (circadianState === "awake" ? bucketIso(args.input.windowStartAt, args.timezone, "nearest") : null),
+    lastMealAt: bucketIso(snapshotSource.lastMealAt, args.timezone, "nearest"),
+    nextMealLabel: snapshotSource.nextMealLabel ?? args.input.mealLabel ?? null,
+    nextMealWindowStartAt: bucketIso(snapshotSource.nextMealWindowStartAt, args.timezone, "floor") ?? (args.input.mealLabel ? bucketedWindowStartAt : null),
+    nextMealWindowEndAt: bucketIso(snapshotSource.nextMealWindowEndAt, args.timezone, "ceil") ?? (args.input.mealLabel ? bucketedWindowEndAt : null),
+    nextMealConfidence: roundConfidence(
+      snapshotSource.nextMealConfidence ?? (args.input.mealLabel ? args.input.stateConfidence : 0)
+    )
+  };
+  const snapshot = {
+    ...snapshotBase,
+    relativeTime: resolveLifeOpsRelativeTime({
+      nowMs: parseIsoMs(args.observedAt) ?? Date.now(),
+      timezone: args.timezone,
+      schedule: snapshotBase
+    })
+  };
+  return buildObservationRecord({
+    agentId: args.agentId,
+    origin: args.origin,
+    deviceId: args.deviceId,
+    deviceKind: args.deviceKind,
+    timezone: args.timezone,
+    observedAt: args.observedAt,
+    circadianState,
+    stateConfidence: args.input.stateConfidence,
+    uncertaintyReason,
+    mealLabel: args.input.mealLabel ?? snapshot.nextMealLabel ?? null,
+    windowStartAt: bucketedWindowStartAt,
+    windowEndAt: bucketedWindowEndAt,
+    metadata: observationMetadata({
+      snapshot,
+      source: "schedule_sync",
+      extra: args.input.metadata
+    })
+  });
+}
+function recordsFromSyncRequest(args) {
+  const observedAt = args.request.observedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+  return args.request.observations.map(
+    (input) => recordFromSyncInput({
+      agentId: args.agentId,
+      timezone: args.request.timezone,
+      observedAt,
+      origin: args.origin,
+      deviceId: args.request.deviceId,
+      deviceKind: args.request.deviceKind,
+      input
+    })
+  );
+}
+function observationSnapshot(observation) {
+  const metadata = asRecord(observation.metadata);
+  const snapshot = asRecord(metadata?.snapshot);
+  return snapshot;
+}
+function observationRelevant(observation, nowMs) {
+  const observedMs = parseIsoMs(observation.observedAt);
+  if (observedMs === null) {
+    return false;
+  }
+  const ttl = OBSERVATION_TTL_MS[observation.circadianState];
+  if (observedMs >= nowMs - ttl) {
+    return true;
+  }
+  const startMs = parseIsoMs(observation.windowStartAt);
+  const endMs = parseIsoMs(observation.windowEndAt);
+  if (startMs === null) {
+    return false;
+  }
+  return startMs <= nowMs && (endMs === null || endMs >= nowMs - ttl);
+}
+function latestSnapshotValue(observations, read) {
+  for (const observation of observations) {
+    const snapshot = observationSnapshot(observation);
+    const value = snapshot ? read(snapshot) : null;
+    if (value !== null && value !== void 0) {
+      return value;
+    }
+  }
+  return null;
+}
+function isFutureIsoAt(value, nowMs) {
+  const parsed = parseIsoMs(value);
+  return parsed !== null && parsed >= nowMs;
+}
+function pickFutureSnapshotValue(observations, read, nowMs) {
+  for (const observation of observations) {
+    const snapshot = observationSnapshot(observation);
+    const value = snapshot ? read(snapshot) : null;
+    if (value && isFutureIsoAt(value, nowMs)) {
+      return value;
+    }
+  }
+  return null;
+}
+function latestRelevantObservations(observations, nowMs) {
+  return observations.filter((observation) => observationRelevant(observation, nowMs)).sort((left, right) => {
+    const leftMs = parseIsoMs(left.observedAt) ?? 0;
+    const rightMs = parseIsoMs(right.observedAt) ?? 0;
+    return rightMs - leftMs;
+  });
+}
+function bestObservation(observations, predicate) {
+  const matches = observations.filter(predicate);
+  if (matches.length === 0) {
+    return null;
+  }
+  return matches.sort((left, right) => {
+    if (right.stateConfidence !== left.stateConfidence) {
+      return right.stateConfidence - left.stateConfidence;
+    }
+    const leftMs = parseIsoMs(left.observedAt) ?? 0;
+    const rightMs = parseIsoMs(right.observedAt) ?? 0;
+    return rightMs - leftMs;
+  })[0] ?? null;
+}
+function mergedMeals(observations) {
+  const meals = observations.filter((observation) => observation.mealLabel !== null).sort((left, right) => {
+    const leftMs = parseIsoMs(left.windowStartAt) ?? 0;
+    const rightMs = parseIsoMs(right.windowStartAt) ?? 0;
+    return leftMs - rightMs;
+  }).map((observation) => ({
+    label: observation.mealLabel,
+    detectedAt: observation.windowStartAt,
+    confidence: roundConfidence(observation.stateConfidence),
+    source: "expected_window"
+  }));
+  const unique = /* @__PURE__ */ new Map();
+  for (const meal of meals) {
+    const key = `${meal.label}:${meal.detectedAt}`;
+    unique.set(key, meal);
+  }
+  return [...unique.values()];
+}
+function resolveMergedCircadianState(relevant) {
+  const candidates = relevant.filter(
+    (observation) => observation.circadianState !== "unclear"
+  );
+  if (candidates.length === 0) {
+    const fallback = relevant[0];
+    return {
+      circadianState: fallback?.circadianState,
+      stateConfidence: fallback?.stateConfidence,
+      uncertaintyReason: fallback?.uncertaintyReason ?? (relevant.length === 0 ? "no_signals" : "contradictory_signals")
+    };
+  }
+  const [best] = candidates.sort((left, right) => {
+    const rankDelta = STATE_RANK[right.circadianState] - STATE_RANK[left.circadianState];
+    if (rankDelta !== 0) {
+      return rankDelta;
+    }
+    if (right.stateConfidence !== left.stateConfidence) {
+      return right.stateConfidence - left.stateConfidence;
+    }
+    const leftMs = parseIsoMs(left.observedAt) ?? 0;
+    const rightMs = parseIsoMs(right.observedAt) ?? 0;
+    return rightMs - leftMs;
+  });
+  if (!best) {
+    return {
+      circadianState: "unclear",
+      stateConfidence: 0,
+      uncertaintyReason: "no_signals"
+    };
+  }
+  return {
+    circadianState: best.circadianState,
+    stateConfidence: best.stateConfidence,
+    uncertaintyReason: best.uncertaintyReason
+  };
+}
+function mergeScheduleObservations(args) {
+  const now = args.now ?? /* @__PURE__ */ new Date();
+  const nowMs = now.getTime();
+  const relevant = latestRelevantObservations(args.observations, nowMs);
+  if (relevant.length === 0) {
+    return null;
+  }
+  const { circadianState, stateConfidence, uncertaintyReason } = resolveMergedCircadianState(relevant);
+  const currentSleep = bestObservation(
+    relevant,
+    (observation) => isAsleepState(observation.circadianState)
+  );
+  const recentWake = bestObservation(
+    relevant,
+    (observation) => observation.circadianState === "waking"
+  );
+  const mealWindow = bestObservation(
+    relevant,
+    (observation) => observation.mealLabel !== null
+  );
+  const currentSleepStartedAt = latestSnapshotValue(
+    relevant,
+    (snapshot) => snapshot.currentSleepStartedAt
+  ) ?? currentSleep?.windowStartAt ?? null;
+  const lastSleepStartedAt = latestSnapshotValue(relevant, (snapshot) => snapshot.lastSleepStartedAt) ?? currentSleepStartedAt;
+  const lastSleepEndedAt = latestSnapshotValue(relevant, (snapshot) => snapshot.lastSleepEndedAt) ?? null;
+  const wakeAt = latestSnapshotValue(relevant, (snapshot) => snapshot.wakeAt) ?? recentWake?.windowStartAt ?? null;
+  const firstActiveAt = latestSnapshotValue(relevant, (snapshot) => snapshot.firstActiveAt) ?? wakeAt;
+  const lastActiveAt = latestSnapshotValue(relevant, (snapshot) => snapshot.lastActiveAt) ?? bestObservation(
+    relevant,
+    (observation) => observation.circadianState === "awake"
+  )?.windowStartAt ?? null;
+  const sleepStatus = isAsleepState(circadianState) ? "sleeping_now" : lastSleepEndedAt ? "slept" : stateConfidence >= 0.55 ? "likely_missed" : "unknown";
+  const sleepConfidence = roundConfidence(
+    currentSleep?.stateConfidence ?? latestSnapshotValue(relevant, (snapshot) => snapshot.sleepConfidence) ?? 0
+  );
+  const meals = mergedMeals(relevant);
+  const lastMealAt = meals.length > 0 ? meals[meals.length - 1]?.detectedAt ?? null : null;
+  const mergedAt = now.toISOString();
+  const effectiveDayKey = latestSnapshotValue(relevant, (snapshot) => snapshot.effectiveDayKey) ?? getLocalDateKey(getZonedDateParts(now, args.timezone));
+  const localDate = latestSnapshotValue(relevant, (snapshot) => snapshot.localDate) ?? getLocalDateKey(getZonedDateParts(now, args.timezone));
+  const awakeProbability = latestSnapshotValue(relevant, (snapshot) => snapshot.awakeProbability) ?? defaultAwakeProbability(mergedAt);
+  const regularity = latestSnapshotValue(relevant, (snapshot) => snapshot.regularity) ?? defaultScheduleRegularity();
+  const baseline = latestSnapshotValue(
+    relevant,
+    (snapshot) => snapshot.baseline ?? null
+  );
+  const relativeTime = resolveLifeOpsRelativeTime({
+    nowMs,
+    timezone: args.timezone,
+    schedule: {
+      circadianState,
+      stateConfidence,
+      uncertaintyReason,
+      awakeProbability,
+      regularity,
+      baseline,
+      sleepConfidence,
+      currentSleepStartedAt,
+      lastSleepStartedAt,
+      lastSleepEndedAt,
+      wakeAt,
+      firstActiveAt
+    }
+  });
+  const mealWindowStartFromObservation = mealWindow && isFutureIsoAt(mealWindow.windowStartAt, nowMs) ? mealWindow.windowStartAt : null;
+  const mealWindowStartFromSnapshot = mealWindowStartFromObservation === null ? pickFutureSnapshotValue(
+    relevant,
+    (snapshot) => snapshot.nextMealWindowStartAt,
+    nowMs
+  ) : null;
+  const mealWindowSource = mealWindowStartFromObservation !== null ? "observation" : mealWindowStartFromSnapshot !== null ? "snapshot" : null;
+  const nextMealWindowStartAt = mealWindowStartFromObservation ?? mealWindowStartFromSnapshot ?? null;
+  const nextMealLabel = mealWindowSource === "observation" ? mealWindow?.mealLabel ?? null : mealWindowSource === "snapshot" ? latestSnapshotValue(
+    relevant,
+    (snapshot) => snapshot.nextMealLabel
+  ) ?? null : null;
+  const nextMealWindowEndAt = mealWindowSource === "observation" ? mealWindow?.windowEndAt ?? null : mealWindowSource === "snapshot" ? latestSnapshotValue(
+    relevant,
+    (snapshot) => snapshot.nextMealWindowEndAt
+  ) ?? null : null;
+  const nextMealConfidence = roundConfidence(
+    mealWindowSource === "observation" ? mealWindow?.stateConfidence ?? 0 : mealWindowSource === "snapshot" ? latestSnapshotValue(
+      relevant,
+      (snapshot) => snapshot.nextMealConfidence
+    ) ?? 0 : 0
+  );
+  const contributingDeviceKinds = [
+    ...new Set(relevant.map((observation) => observation.deviceKind))
+  ];
+  return {
+    id: `lifeops-schedule-merged:${args.agentId}:${args.scope}:${args.timezone}`,
+    agentId: args.agentId,
+    scope: args.scope,
+    mergedAt,
+    effectiveDayKey,
+    localDate,
+    timezone: args.timezone,
+    inferredAt: mergedAt,
+    circadianState,
+    stateConfidence: roundConfidence(stateConfidence),
+    uncertaintyReason,
+    relativeTime,
+    awakeProbability,
+    regularity,
+    baseline,
+    // Merged states do not preserve individual observation firings — the
+    // scorer runs per-device. Inspection UIs should read the latest local
+    // insight row when they need to enumerate contributing rules.
+    circadianRuleFirings: [],
+    sleepStatus,
+    sleepConfidence,
+    currentSleepStartedAt,
+    lastSleepStartedAt,
+    lastSleepEndedAt,
+    lastSleepDurationMinutes: latestSnapshotValue(
+      relevant,
+      (snapshot) => snapshot.lastSleepDurationMinutes
+    ) ?? null,
+    wakeAt,
+    firstActiveAt,
+    lastActiveAt,
+    meals,
+    lastMealAt,
+    nextMealLabel,
+    nextMealWindowStartAt,
+    nextMealWindowEndAt,
+    nextMealConfidence,
+    observationCount: relevant.length,
+    deviceCount: new Set(relevant.map((observation) => observation.deviceId)).size,
+    contributingDeviceKinds,
+    metadata: {
+      latestObservationAt: relevant[0]?.observedAt ?? mergedAt,
+      deviceIds: [
+        ...new Set(relevant.map((observation) => observation.deviceId))
+      ],
+      relativeTime
+    },
+    createdAt: mergedAt,
+    updatedAt: mergedAt
+  };
+}
+function freshnessMs(state, nowMs) {
+  const updatedMs = parseIsoMs(state.updatedAt);
+  if (updatedMs === null) {
+    return null;
+  }
+  return nowMs - updatedMs;
+}
+function isFreshCloudMergedState(state, now) {
+  if (!state || state.scope !== "cloud") {
+    return false;
+  }
+  const ageMs = freshnessMs(state, now.getTime());
+  return ageMs !== null && ageMs <= SCHEDULE_CLOUD_STATE_FRESH_MS;
+}
+function preferEffectiveMergedState(args) {
+  if (isFreshCloudMergedState(args.cloud, args.now)) {
+    return args.cloud;
+  }
+  return args.local ?? args.cloud ?? null;
+}
+export {
+  SCHEDULE_CLOUD_STATE_FRESH_MS,
+  SCHEDULE_CLOUD_SYNC_TTL_MS,
+  SCHEDULE_OBSERVATION_BUCKET_MINUTES,
+  SCHEDULE_OBSERVATION_LOOKBACK_MS,
+  deriveLocalScheduleObservations,
+  isFreshCloudMergedState,
+  mergeScheduleObservations,
+  preferEffectiveMergedState,
+  recordsFromSyncRequest,
+  resolveScheduleDeviceIdentity
+};
+//# sourceMappingURL=schedule-state.js.map