@elizaos/plugin-health 2.0.0-beta.1

package/README.md

@@ -0,0 +1,107 @@
+# `@elizaos/plugin-health`
+
+Owns the health, sleep, circadian-regularity, and screen-time domain for
+elizaOS. Extracted from `@elizaos/app-lifeops` so the same domain can serve
+other apps without bringing the LifeOps runtime along.
+
+## What this plugin owns
+
+### Connectors
+
+Six connector contributions registered against the LifeOps
+`ConnectorRegistry`:
+
+- `apple_health`
+- `google_fit`
+- `strava`
+- `fitbit`
+- `withings`
+- `oura`
+
+Each pair-and-disconnect flow, dispatch surface, and credential boundary
+lives under `src/connectors/`. Connectors return typed `DispatchResult` —
+not booleans.
+
+### Anchors
+
+Four anchors registered against the `AnchorRegistry`:
+
+- `wake.observed`
+- `wake.confirmed`
+- `bedtime.target`
+- `nap.start`
+
+Anchors back the `relative_to_anchor` trigger on
+`ScheduledTask`s — for example, `morning-brief` fires `relative_to_anchor`
+on `wake.confirmed` with a small offset.
+
+### Bus families
+
+Eight families registered against the `FamilyRegistry` and published on the
+`ActivitySignalBus`:
+
+- `health.sleep.detected`
+- `health.sleep.ended`
+- `health.wake.observed`
+- `health.wake.confirmed`
+- `health.nap.detected`
+- `health.bedtime.imminent`
+- `health.regularity.changed`
+- `health.workout.completed`
+
+### Default packs
+
+- `bedtime` — fires before the user's target bedtime.
+- `wake-up` — fires when wake is observed/confirmed.
+- `sleep-recap` — recap after sleep ends.
+
+Each pack is a `ScheduledTask` (or set thereof) consuming the LifeOps spine.
+The plugin registers them lazily — only when at least one health connector
+pairs.
+
+### Domain logic
+
+- `src/sleep/` — sleep / circadian / regularity engines.
+- `src/screen-time/` — screen-time aggregation.
+- `src/health-bridge/` — proxied surfaces consumed by LifeOps
+  (`/api/lifeops/health/summary`, `/api/lifeops/health/sync`).
+
+## How LifeOps consumes plugin-health
+
+LifeOps does not import internal modules. Consumption goes through:
+
+1. **Connector contributions** — registered into LifeOps's
+   `ConnectorRegistry` at boot via `registerHealthConnectors(runtime)`.
+2. **Anchor contributions** — registered via `registerHealthAnchors(runtime)`
+   into the `AnchorRegistry`.
+3. **Bus families** — registered via `registerHealthBusFamilies(runtime)`
+   into `FamilyRegistry`.
+4. **Default packs** — registered via `registerHealthDefaultPacks(runtime)`.
+5. **Public exports** — `detectHealthBackend`, sleep utilities, screen-time
+   helpers exported from `@elizaos/plugin-health` and re-exported by
+   `app-lifeops` only where the surface is part of the LifeOps public API.
+
+If the LifeOps runtime registries are not available at boot, the plugin
+logs a single skip line and contributes nothing. This is the soft-dependency
+posture.
+
+## Soft-dependency posture
+
+`plugin-health` does not require `app-lifeops`. Other apps can consume the
+plugin by registering their own implementations of:
+
+- `ConnectorRegistry` (with `register` / `get` / `list`)
+- `AnchorRegistry` (with `register` / `resolve`)
+- `FamilyRegistry` (with `register`)
+- A `ScheduledTaskRunner` that accepts the default packs
+
+The contracts the plugin builds against live in `src/contracts/health.ts`
+and `plugins/app-lifeops/docs/audit/wave1-interfaces.md` §1, §3.
+
+## Where to look next
+
+- Plugin entry: `src/index.ts`.
+- LifeOps consumption: `plugins/app-lifeops/README.md`.
+- Frozen contracts: `plugins/app-lifeops/docs/audit/wave1-interfaces.md`
+  §5 (this plugin's contributions) and §3 (the connector / channel /
+  transport contracts the plugin implements).

package/dist/actions/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Health-related agent actions exposed by plugin-health.
+ *
+ * Wave-1 (W1-B) move: `actions/health.ts` and `actions/screen-time.ts` are
+ * still owned by app-lifeops because they instantiate `LifeOpsService`
+ * directly (`new LifeOpsService(runtime)`) — moving the construction surface
+ * into plugin-health would create a circular package dependency since
+ * `LifeOpsService` lives in app-lifeops.
+ *
+ * The pure-domain helpers those actions delegate to (`health-bridge.ts`,
+ * `health-connectors.ts`, sleep / circadian / awake-probability inference)
+ * have been moved into plugin-health. Wave-2 (W2-A: scenario-named action
+ * migration onto `ScheduledTask`) is responsible for the action move +
+ * `LifeOpsService` decoupling.
+ *
+ * For now, app-lifeops continues to register both actions on its own plugin
+ * surface. plugin-health exposes no actions of its own at Wave-1.
+ */
+export declare const HEALTH_ACTIONS_DEFERRED_TO_WAVE_2: true;
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,iCAAiC,EAAG,IAAa,CAAC"}

package/dist/actions/index.js

@@ -0,0 +1,5 @@
+const HEALTH_ACTIONS_DEFERRED_TO_WAVE_2 = true;
+export {
+  HEALTH_ACTIONS_DEFERRED_TO_WAVE_2
+};
+//# sourceMappingURL=index.js.map

package/dist/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/index.ts"],"sourcesContent":["/**\n * Health-related agent actions exposed by plugin-health.\n *\n * Wave-1 (W1-B) move: `actions/health.ts` and `actions/screen-time.ts` are\n * still owned by app-lifeops because they instantiate `LifeOpsService`\n * directly (`new LifeOpsService(runtime)`) — moving the construction surface\n * into plugin-health would create a circular package dependency since\n * `LifeOpsService` lives in app-lifeops.\n *\n * The pure-domain helpers those actions delegate to (`health-bridge.ts`,\n * `health-connectors.ts`, sleep / circadian / awake-probability inference)\n * have been moved into plugin-health. Wave-2 (W2-A: scenario-named action\n * migration onto `ScheduledTask`) is responsible for the action move +\n * `LifeOpsService` decoupling.\n *\n * For now, app-lifeops continues to register both actions on its own plugin\n * surface. plugin-health exposes no actions of its own at Wave-1.\n */\n\nexport const HEALTH_ACTIONS_DEFERRED_TO_WAVE_2 = true as const;\n"],"mappings":"AAmBO,MAAM,oCAAoC;","names":[]}

package/dist/anchors/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Anchor contributions exposed by plugin-health.
+ *
+ * The actual `registerHealthAnchors` implementation + the `HEALTH_ANCHORS`
+ * tuple live in `../connectors/index.ts` (alongside the connector / bus-
+ * family registration entry points so a single registry-detection pass
+ * runs all three at boot). This file re-exports them so external callers
+ * can import from `@elizaos/plugin-health/anchors`.
+ *
+ * Per `IMPLEMENTATION_PLAN.md` §3.2: BOTH `wake.observed` AND `wake.confirmed`
+ * are registered as separate anchors — `observed` = first signal that fits
+ * a wake pattern, `confirmed` = sustained signal that survives the
+ * `WAKE_CONFIRM_WINDOW_MS` hysteresis window in `circadian-rules.ts`.
+ *
+ * Per `wave1-interfaces.md` §5.2: the anchor set is
+ *   `["wake.observed", "wake.confirmed", "bedtime.target", "nap.start"]`.
+ */
+export { type AnchorContribution, type AnchorRegistry, HEALTH_ANCHORS, registerHealthAnchors, } from "../connectors/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/anchors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/anchors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,cAAc,EACd,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/anchors/index.js

@@ -0,0 +1,9 @@
+import {
+  HEALTH_ANCHORS,
+  registerHealthAnchors
+} from "../connectors/index.js";
+export {
+  HEALTH_ANCHORS,
+  registerHealthAnchors
+};
+//# sourceMappingURL=index.js.map

package/dist/anchors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/anchors/index.ts"],"sourcesContent":["/**\n * Anchor contributions exposed by plugin-health.\n *\n * The actual `registerHealthAnchors` implementation + the `HEALTH_ANCHORS`\n * tuple live in `../connectors/index.ts` (alongside the connector / bus-\n * family registration entry points so a single registry-detection pass\n * runs all three at boot). This file re-exports them so external callers\n * can import from `@elizaos/plugin-health/anchors`.\n *\n * Per `IMPLEMENTATION_PLAN.md` §3.2: BOTH `wake.observed` AND `wake.confirmed`\n * are registered as separate anchors — `observed` = first signal that fits\n * a wake pattern, `confirmed` = sustained signal that survives the\n * `WAKE_CONFIRM_WINDOW_MS` hysteresis window in `circadian-rules.ts`.\n *\n * Per `wave1-interfaces.md` §5.2: the anchor set is\n *   `[\"wake.observed\", \"wake.confirmed\", \"bedtime.target\", \"nap.start\"]`.\n */\n\nexport {\n  type AnchorContribution,\n  type AnchorRegistry,\n  HEALTH_ANCHORS,\n  registerHealthAnchors,\n} from \"../connectors/index.js\";\n"],"mappings":"AAkBA;AAAA,EAGE;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/connectors/contract-stubs.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Wave-1 stubs for the W1-F connector / channel / signal-bus contracts.
+ *
+ * These mirror `wave1-interfaces.md` §3 byte-identically. When W1-F lands the
+ * concrete `ConnectorRegistry` / `AnchorRegistry` / `ActivitySignalBus` types
+ * in their owning module, every `import` from this file should be replaced
+ * with the real path; nothing else needs to change because the shapes here
+ * are the frozen contract.
+ *
+ * No runtime behaviour lives here — types only.
+ */
+export type ConnectorMode = "local" | "cloud";
+export interface ConnectorStatus {
+    state: "ok" | "degraded" | "disconnected";
+    message?: string;
+    observedAt: string;
+}
+export type DispatchResult = {
+    ok: true;
+    messageId?: string;
+} | {
+    ok: false;
+    reason: "disconnected" | "rate_limited" | "auth_expired" | "unknown_recipient" | "transport_error";
+    retryAfterMinutes?: number;
+    userActionable: boolean;
+    message?: string;
+};
+/**
+ * OAuth surface a connector contribution may advertise. URL provided by the
+ * connector contribution; the dispatcher does not hardcode. Health-bridge
+ * connectors (Strava, Fitbit, Withings, Oura) populate this so the OAuth
+ * driver iterates the registry — see `health-bridge/health-provider-registry.ts`.
+ */
+export interface ConnectorOAuthConfig {
+    readonly authorizeUrl: string;
+    readonly tokenUrl: string;
+    readonly revokeUrl?: string | null;
+    readonly scopes?: readonly string[];
+}
+export interface ConnectorContribution {
+    kind: string;
+    capabilities: string[];
+    modes: ConnectorMode[];
+    describe: {
+        label: string;
+    };
+    /** URL provided by the connector contribution; the dispatcher does not hardcode. */
+    oauth?: ConnectorOAuthConfig;
+    /** URL provided by the connector contribution; the dispatcher does not hardcode. */
+    apiBaseUrl?: string;
+    start(): Promise<void>;
+    disconnect(): Promise<void>;
+    verify(): Promise<boolean>;
+    status(): Promise<ConnectorStatus>;
+    send?(payload: unknown): Promise<DispatchResult>;
+    read?(query: unknown): Promise<unknown>;
+    requiresApproval?: boolean;
+}
+export interface ConnectorRegistry {
+    register(c: ConnectorContribution): void;
+    list(filter?: {
+        capability?: string;
+        mode?: ConnectorMode;
+    }): ConnectorContribution[];
+    get(kind: string): ConnectorContribution | null;
+    byCapability(capability: string): ConnectorContribution[];
+}
+/**
+ * Registry surface exposed by W1-A's `ScheduledTask` runner for anchor key
+ * registration. plugin-health contributes `wake.observed`, `wake.confirmed`,
+ * `bedtime.target`, `nap.start` per `wave1-interfaces.md` §5.2.
+ *
+ * `wake.observed` and `wake.confirmed` are intentionally separate (per
+ * `IMPLEMENTATION_PLAN.md` §3.2): `observed` = first signal that fits a wake
+ * pattern, `confirmed` = sustained signal that survives the
+ * `WAKE_CONFIRM_WINDOW_MS` hysteresis window in `circadian-rules.ts`.
+ */
+export interface AnchorRegistry {
+    register(anchor: AnchorContribution): void;
+    list(): AnchorContribution[];
+    get(anchorKey: string): AnchorContribution | null;
+}
+export interface AnchorContribution {
+    anchorKey: string;
+    description: string;
+    source: "plugin-health" | string;
+}
+/**
+ * Bus-family registry for `ActivitySignalBus`. plugin-health publishes the
+ * health-prefixed families documented in `wave1-interfaces.md` §5.3.
+ */
+export interface BusFamilyRegistry {
+    register(family: BusFamilyContribution): void;
+    list(): BusFamilyContribution[];
+}
+export interface BusFamilyContribution {
+    family: string;
+    description: string;
+    source: "plugin-health" | string;
+}
+/**
+ * The runtime surface plugin-health expects to find on `IAgentRuntime`. All
+ * four registries are optional (`undefined` when W1-A / W1-F have not landed
+ * yet); registration callers tolerate a missing registry by logging a one-
+ * line skip reason.
+ */
+export interface RuntimeWithHealthRegistries {
+    connectorRegistry?: ConnectorRegistry;
+    anchorRegistry?: AnchorRegistry;
+    busFamilyRegistry?: BusFamilyRegistry;
+}
+//# sourceMappingURL=contract-stubs.d.ts.map

package/dist/connectors/contract-stubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-stubs.d.ts","sourceRoot":"","sources":["../../src/connectors/contract-stubs.ts"],"names":[],"mappings":"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"}

package/dist/connectors/contract-stubs.js

@@ -0,0 +1 @@
+//# sourceMappingURL=contract-stubs.js.map

package/dist/connectors/contract-stubs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/connectors/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Connector / anchor / bus-family registration entry point.
+ *
+ * Per `wave1-interfaces.md` §5.1 / §5.2 / §5.3, plugin-health contributes:
+ *
+ *   - 6 ConnectorContributions: apple_health, google_fit, strava, fitbit,
+ *     withings, oura
+ *   - 4 anchors: wake.observed, wake.confirmed, bedtime.target, nap.start
+ *   - 8 bus families: health.sleep.detected, health.sleep.ended,
+ *     health.wake.observed, health.wake.confirmed, health.nap.detected,
+ *     health.bedtime.imminent, health.regularity.changed,
+ *     health.workout.completed
+ *
+ * Registration is best-effort: if W1-A / W1-F's runtime registries have not
+ * landed yet, this module logs a one-line skip and continues. The connector
+ * / anchor / bus-family identifiers are still exported as constants so
+ * other Wave-1 agents can reference them.
+ */
+import type { RuntimeWithHealthRegistries } from "./contract-stubs.js";
+export * from "./contract-stubs.js";
+type RuntimeHealthRegistryHost = object & RuntimeWithHealthRegistries;
+export declare const HEALTH_CONNECTOR_KINDS: readonly ["apple_health", "google_fit", "strava", "fitbit", "withings", "oura"];
+export declare const HEALTH_ANCHORS: readonly ["wake.observed", "wake.confirmed", "bedtime.target", "nap.start"];
+export declare const HEALTH_BUS_FAMILIES: readonly ["health.sleep.detected", "health.sleep.ended", "health.wake.observed", "health.wake.confirmed", "health.nap.detected", "health.bedtime.imminent", "health.regularity.changed", "health.workout.completed"];
+export declare function registerHealthConnectors(runtime: RuntimeHealthRegistryHost): void;
+export declare function registerHealthAnchors(runtime: RuntimeHealthRegistryHost): void;
+export declare function registerHealthBusFamilies(runtime: RuntimeHealthRegistryHost): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAUV,2BAA2B,EAC5B,MAAM,qBAAqB,CAAC;AAE7B,cAAc,qBAAqB,CAAC;AAEpC,KAAK,yBAAyB,GAAG,MAAM,GAAG,2BAA2B,CAAC;AAEtE,eAAO,MAAM,sBAAsB,iFAOG,CAAC;AAEvC,eAAO,MAAM,cAAc,6EAKW,CAAC;AAEvC,eAAO,MAAM,mBAAmB,sNASM,CAAC;AA+JvC,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,IAAI,CAoBN;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,yBAAyB,GACjC,IAAI,CAuBN;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,yBAAyB,GACjC,IAAI,CAoBN"}

package/dist/connectors/index.js

@@ -0,0 +1,202 @@
+import { logger } from "@elizaos/core";
+import { getHealthProviderSpec } from "../health-bridge/health-provider-registry.js";
+export * from "./contract-stubs.js";
+const HEALTH_CONNECTOR_KINDS = [
+  "apple_health",
+  "google_fit",
+  "strava",
+  "fitbit",
+  "withings",
+  "oura"
+];
+const HEALTH_ANCHORS = [
+  "wake.observed",
+  "wake.confirmed",
+  "bedtime.target",
+  "nap.start"
+];
+const HEALTH_BUS_FAMILIES = [
+  "health.sleep.detected",
+  "health.sleep.ended",
+  "health.wake.observed",
+  "health.wake.confirmed",
+  "health.nap.detected",
+  "health.bedtime.imminent",
+  "health.regularity.changed",
+  "health.workout.completed"
+];
+const HEALTH_CONNECTOR_CAPABILITIES = {
+  apple_health: [
+    "health.sleep.read",
+    "health.activity.read",
+    "health.workouts.read",
+    "health.body.read",
+    "health.vitals.read"
+  ],
+  google_fit: [
+    "health.sleep.read",
+    "health.activity.read",
+    "health.workouts.read",
+    "health.body.read",
+    "health.vitals.read"
+  ],
+  strava: ["health.activity.read", "health.workouts.read"],
+  fitbit: [
+    "health.sleep.read",
+    "health.activity.read",
+    "health.workouts.read",
+    "health.body.read",
+    "health.vitals.read",
+    "health.readiness.read"
+  ],
+  withings: ["health.sleep.read", "health.body.read", "health.vitals.read"],
+  oura: [
+    "health.sleep.read",
+    "health.activity.read",
+    "health.workouts.read",
+    "health.readiness.read"
+  ]
+};
+const CONNECTOR_LABELS = {
+  apple_health: "Apple Health (HealthKit)",
+  google_fit: "Google Fit",
+  strava: "Strava",
+  fitbit: "Fitbit",
+  withings: "Withings",
+  oura: "Oura"
+};
+function buildConnectorContribution(kind) {
+  const stubStatus = async () => ({
+    state: "disconnected",
+    message: "plugin-health Wave-1 stub: full dispatcher wiring lands when W1-F's runtime context shape is finalised.",
+    observedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  const stubSend = async () => ({
+    ok: false,
+    reason: "transport_error",
+    userActionable: true,
+    message: "plugin-health Wave-1 stub: connector send is not yet wired; configure via the legacy lifeops health-connectors path."
+  });
+  const providerSpec = getHealthProviderSpec(kind);
+  const oauth = providerSpec ? {
+    authorizeUrl: providerSpec.oauth.authorizeUrl,
+    tokenUrl: providerSpec.oauth.tokenUrl,
+    revokeUrl: providerSpec.oauth.revokeUrl,
+    scopes: providerSpec.oauth.defaultScopes
+  } : void 0;
+  const apiBaseUrl = providerSpec?.apiBaseUrl;
+  return {
+    kind,
+    capabilities: [...HEALTH_CONNECTOR_CAPABILITIES[kind]],
+    modes: kind === "apple_health" ? ["local"] : kind === "google_fit" ? ["local", "cloud"] : ["cloud"],
+    describe: { label: CONNECTOR_LABELS[kind] },
+    oauth,
+    apiBaseUrl,
+    start: async () => {
+    },
+    disconnect: async () => {
+    },
+    verify: async () => false,
+    status: stubStatus,
+    send: stubSend,
+    read: async () => null
+  };
+}
+function buildAnchorContribution(anchorKey) {
+  return {
+    anchorKey,
+    description: `plugin-health anchor: ${anchorKey}`,
+    source: "plugin-health"
+  };
+}
+function buildBusFamilyContribution(family) {
+  return {
+    family,
+    description: `plugin-health bus family: ${family}`,
+    source: "plugin-health"
+  };
+}
+function getConnectorRegistry(runtime) {
+  return runtime.connectorRegistry;
+}
+function getAnchorRegistry(runtime) {
+  return runtime.anchorRegistry;
+}
+function getBusFamilyRegistry(runtime) {
+  return runtime.busFamilyRegistry;
+}
+function registerHealthConnectors(runtime) {
+  const registry = getConnectorRegistry(runtime);
+  if (!registry) {
+    logger.info(
+      { src: "plugin:health", waiting_on: "W1-F connectorRegistry" },
+      "Skipping plugin-health connector registration (registry not yet available)"
+    );
+    return;
+  }
+  for (const kind of HEALTH_CONNECTOR_KINDS) {
+    registry.register(buildConnectorContribution(kind));
+  }
+  logger.info(
+    {
+      src: "plugin:health",
+      registered: HEALTH_CONNECTOR_KINDS.length,
+      kinds: HEALTH_CONNECTOR_KINDS
+    },
+    "Registered plugin-health connectors"
+  );
+}
+function registerHealthAnchors(runtime) {
+  const registry = getAnchorRegistry(runtime);
+  if (!registry) {
+    logger.info(
+      { src: "plugin:health", waiting_on: "W1-A anchorRegistry" },
+      "Skipping plugin-health anchor registration (registry not yet available)"
+    );
+    return;
+  }
+  for (const anchorKey of HEALTH_ANCHORS) {
+    if (registry.get(anchorKey)) {
+      continue;
+    }
+    registry.register(buildAnchorContribution(anchorKey));
+  }
+  logger.info(
+    {
+      src: "plugin:health",
+      registered: HEALTH_ANCHORS.length,
+      anchors: HEALTH_ANCHORS
+    },
+    "Registered plugin-health anchors"
+  );
+}
+function registerHealthBusFamilies(runtime) {
+  const registry = getBusFamilyRegistry(runtime);
+  if (!registry) {
+    logger.info(
+      { src: "plugin:health", waiting_on: "W1-A or W2-D busFamilyRegistry" },
+      "Skipping plugin-health bus-family registration (registry not yet available)"
+    );
+    return;
+  }
+  for (const family of HEALTH_BUS_FAMILIES) {
+    registry.register(buildBusFamilyContribution(family));
+  }
+  logger.info(
+    {
+      src: "plugin:health",
+      registered: HEALTH_BUS_FAMILIES.length,
+      families: HEALTH_BUS_FAMILIES
+    },
+    "Registered plugin-health bus families"
+  );
+}
+export {
+  HEALTH_ANCHORS,
+  HEALTH_BUS_FAMILIES,
+  HEALTH_CONNECTOR_KINDS,
+  registerHealthAnchors,
+  registerHealthBusFamilies,
+  registerHealthConnectors
+};
+//# sourceMappingURL=index.js.map

package/dist/connectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/connectors/index.ts"],"sourcesContent":["/**\n * Connector / anchor / bus-family registration entry point.\n *\n * Per `wave1-interfaces.md` §5.1 / §5.2 / §5.3, plugin-health contributes:\n *\n *   - 6 ConnectorContributions: apple_health, google_fit, strava, fitbit,\n *     withings, oura\n *   - 4 anchors: wake.observed, wake.confirmed, bedtime.target, nap.start\n *   - 8 bus families: health.sleep.detected, health.sleep.ended,\n *     health.wake.observed, health.wake.confirmed, health.nap.detected,\n *     health.bedtime.imminent, health.regularity.changed,\n *     health.workout.completed\n *\n * Registration is best-effort: if W1-A / W1-F's runtime registries have not\n * landed yet, this module logs a one-line skip and continues. The connector\n * / anchor / bus-family identifiers are still exported as constants so\n * other Wave-1 agents can reference them.\n */\n\nimport { logger } from \"@elizaos/core\";\nimport { getHealthProviderSpec } from \"../health-bridge/health-provider-registry.js\";\nimport type {\n  AnchorContribution,\n  AnchorRegistry,\n  BusFamilyContribution,\n  BusFamilyRegistry,\n  ConnectorContribution,\n  ConnectorOAuthConfig,\n  ConnectorRegistry,\n  ConnectorStatus,\n  DispatchResult,\n  RuntimeWithHealthRegistries,\n} from \"./contract-stubs.js\";\n\nexport * from \"./contract-stubs.js\";\n\ntype RuntimeHealthRegistryHost = object & RuntimeWithHealthRegistries;\n\nexport const HEALTH_CONNECTOR_KINDS = [\n  \"apple_health\",\n  \"google_fit\",\n  \"strava\",\n  \"fitbit\",\n  \"withings\",\n  \"oura\",\n] as const satisfies readonly string[];\n\nexport const HEALTH_ANCHORS = [\n  \"wake.observed\",\n  \"wake.confirmed\",\n  \"bedtime.target\",\n  \"nap.start\",\n] as const satisfies readonly string[];\n\nexport const HEALTH_BUS_FAMILIES = [\n  \"health.sleep.detected\",\n  \"health.sleep.ended\",\n  \"health.wake.observed\",\n  \"health.wake.confirmed\",\n  \"health.nap.detected\",\n  \"health.bedtime.imminent\",\n  \"health.regularity.changed\",\n  \"health.workout.completed\",\n] as const satisfies readonly string[];\n\n/**\n * Capability strings published by plugin-health connectors. Matches the\n * `LIFEOPS_HEALTH_CONNECTOR_CAPABILITIES` set in `../contracts/health.js` so a\n * planner querying `connectorRegistry.byCapability(\"health.sleep.read\")`\n * resolves the correct contributors.\n */\nconst HEALTH_CONNECTOR_CAPABILITIES: Record<\n  (typeof HEALTH_CONNECTOR_KINDS)[number],\n  readonly string[]\n> = {\n  apple_health: [\n    \"health.sleep.read\",\n    \"health.activity.read\",\n    \"health.workouts.read\",\n    \"health.body.read\",\n    \"health.vitals.read\",\n  ],\n  google_fit: [\n    \"health.sleep.read\",\n    \"health.activity.read\",\n    \"health.workouts.read\",\n    \"health.body.read\",\n    \"health.vitals.read\",\n  ],\n  strava: [\"health.activity.read\", \"health.workouts.read\"],\n  fitbit: [\n    \"health.sleep.read\",\n    \"health.activity.read\",\n    \"health.workouts.read\",\n    \"health.body.read\",\n    \"health.vitals.read\",\n    \"health.readiness.read\",\n  ],\n  withings: [\"health.sleep.read\", \"health.body.read\", \"health.vitals.read\"],\n  oura: [\n    \"health.sleep.read\",\n    \"health.activity.read\",\n    \"health.workouts.read\",\n    \"health.readiness.read\",\n  ],\n};\n\nconst CONNECTOR_LABELS: Record<\n  (typeof HEALTH_CONNECTOR_KINDS)[number],\n  string\n> = {\n  apple_health: \"Apple Health (HealthKit)\",\n  google_fit: \"Google Fit\",\n  strava: \"Strava\",\n  fitbit: \"Fitbit\",\n  withings: \"Withings\",\n  oura: \"Oura\",\n};\n\n/**\n * Wave-1 placeholder dispatcher. The actual `start` / `verify` / `status` /\n * `read` implementations live in `health-bridge.ts` + `health-connectors.ts`\n * and require a fully-wired runtime context (credentials store, OAuth\n * sessions, repository factory) that the W1-F generic ConnectorRegistry\n * hasn't standardised yet.\n *\n * Until W1-F publishes the runtime context shape, the contribution emits\n * `disconnected` for status checks and `transport_error` for send/read so\n * downstream task scheduling treats the connector as unavailable rather\n * than silently no-op'ing.\n */\nfunction buildConnectorContribution(\n  kind: (typeof HEALTH_CONNECTOR_KINDS)[number],\n): ConnectorContribution {\n  const stubStatus = async (): Promise<ConnectorStatus> => ({\n    state: \"disconnected\",\n    message:\n      \"plugin-health Wave-1 stub: full dispatcher wiring lands when W1-F's runtime context shape is finalised.\",\n    observedAt: new Date().toISOString(),\n  });\n  const stubSend = async (): Promise<DispatchResult> => ({\n    ok: false,\n    reason: \"transport_error\",\n    userActionable: true,\n    message:\n      \"plugin-health Wave-1 stub: connector send is not yet wired; configure via the legacy lifeops health-connectors path.\",\n  });\n  // URL provided by the connector contribution; the dispatcher does not\n  // hardcode. The OAuth-bridged providers (strava / fitbit / withings / oura)\n  // surface their authorize / token / api-base URLs from the canonical\n  // health-provider registry.\n  const providerSpec = getHealthProviderSpec(kind);\n  const oauth: ConnectorOAuthConfig | undefined = providerSpec\n    ? {\n        authorizeUrl: providerSpec.oauth.authorizeUrl,\n        tokenUrl: providerSpec.oauth.tokenUrl,\n        revokeUrl: providerSpec.oauth.revokeUrl,\n        scopes: providerSpec.oauth.defaultScopes,\n      }\n    : undefined;\n  const apiBaseUrl = providerSpec?.apiBaseUrl;\n  return {\n    kind,\n    capabilities: [...HEALTH_CONNECTOR_CAPABILITIES[kind]],\n    modes:\n      kind === \"apple_health\"\n        ? [\"local\"]\n        : kind === \"google_fit\"\n          ? [\"local\", \"cloud\"]\n          : [\"cloud\"],\n    describe: { label: CONNECTOR_LABELS[kind] },\n    oauth,\n    apiBaseUrl,\n    start: async () => {\n      // Wave-1 stub — concrete start lives in `health-bridge.ts` /\n      // `health-connectors.ts` and is invoked through the legacy\n      // app-lifeops mixin path until W1-F's generic dispatcher lands.\n    },\n    disconnect: async () => {\n      // Wave-1 stub — concrete disconnect lives in `health-oauth.ts`.\n    },\n    verify: async () => false,\n    status: stubStatus,\n    send: stubSend,\n    read: async () => null,\n  };\n}\n\nfunction buildAnchorContribution(anchorKey: string): AnchorContribution {\n  return {\n    anchorKey,\n    description: `plugin-health anchor: ${anchorKey}`,\n    source: \"plugin-health\",\n  };\n}\n\nfunction buildBusFamilyContribution(family: string): BusFamilyContribution {\n  return {\n    family,\n    description: `plugin-health bus family: ${family}`,\n    source: \"plugin-health\",\n  };\n}\n\nfunction getConnectorRegistry(\n  runtime: RuntimeHealthRegistryHost,\n): ConnectorRegistry | undefined {\n  return runtime.connectorRegistry;\n}\n\nfunction getAnchorRegistry(\n  runtime: RuntimeHealthRegistryHost,\n): AnchorRegistry | undefined {\n  return runtime.anchorRegistry;\n}\n\nfunction getBusFamilyRegistry(\n  runtime: RuntimeHealthRegistryHost,\n): BusFamilyRegistry | undefined {\n  return runtime.busFamilyRegistry;\n}\n\nexport function registerHealthConnectors(\n  runtime: RuntimeHealthRegistryHost,\n): void {\n  const registry = getConnectorRegistry(runtime);\n  if (!registry) {\n    logger.info(\n      { src: \"plugin:health\", waiting_on: \"W1-F connectorRegistry\" },\n      \"Skipping plugin-health connector registration (registry not yet available)\",\n    );\n    return;\n  }\n  for (const kind of HEALTH_CONNECTOR_KINDS) {\n    registry.register(buildConnectorContribution(kind));\n  }\n  logger.info(\n    {\n      src: \"plugin:health\",\n      registered: HEALTH_CONNECTOR_KINDS.length,\n      kinds: HEALTH_CONNECTOR_KINDS,\n    },\n    \"Registered plugin-health connectors\",\n  );\n}\n\nexport function registerHealthAnchors(\n  runtime: RuntimeHealthRegistryHost,\n): void {\n  const registry = getAnchorRegistry(runtime);\n  if (!registry) {\n    logger.info(\n      { src: \"plugin:health\", waiting_on: \"W1-A anchorRegistry\" },\n      \"Skipping plugin-health anchor registration (registry not yet available)\",\n    );\n    return;\n  }\n  for (const anchorKey of HEALTH_ANCHORS) {\n    if (registry.get(anchorKey)) {\n      continue;\n    }\n    registry.register(buildAnchorContribution(anchorKey));\n  }\n  logger.info(\n    {\n      src: \"plugin:health\",\n      registered: HEALTH_ANCHORS.length,\n      anchors: HEALTH_ANCHORS,\n    },\n    \"Registered plugin-health anchors\",\n  );\n}\n\nexport function registerHealthBusFamilies(\n  runtime: RuntimeHealthRegistryHost,\n): void {\n  const registry = getBusFamilyRegistry(runtime);\n  if (!registry) {\n    logger.info(\n      { src: \"plugin:health\", waiting_on: \"W1-A or W2-D busFamilyRegistry\" },\n      \"Skipping plugin-health bus-family registration (registry not yet available)\",\n    );\n    return;\n  }\n  for (const family of HEALTH_BUS_FAMILIES) {\n    registry.register(buildBusFamilyContribution(family));\n  }\n  logger.info(\n    {\n      src: \"plugin:health\",\n      registered: HEALTH_BUS_FAMILIES.length,\n      families: HEALTH_BUS_FAMILIES,\n    },\n    \"Registered plugin-health bus families\",\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/contracts/circadian-default.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default `CircadianInsightContract` registered by `plugin-health` during
+ * `init`. Consumers (e.g. `app-lifeops` SCHEDULE / SCHEDULED_TASK) read
+ * through this contract instead of importing plugin-health internals.
+ *
+ * The default implementation is intentionally conservative: it returns
+ * `state=null` / `recommendedAtIso=null` until a richer impl is registered
+ * (e.g. by app-lifeops once its scheduler tick produces a fresh insight).
+ * This keeps the contract honest — callers can always tell whether
+ * inference is calibrated, and never mistake an uninitialized field for a
+ * meaningful zero.
+ */
+import type { CircadianInsightContract } from "./circadian.js";
+export declare function createDefaultCircadianInsightContract(): CircadianInsightContract;
+//# sourceMappingURL=circadian-default.d.ts.map

package/dist/contracts/circadian-default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circadian-default.d.ts","sourceRoot":"","sources":["../../src/contracts/circadian-default.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,wBAAwB,EAGzB,MAAM,gBAAgB,CAAC;AAExB,wBAAgB,qCAAqC,IAAI,wBAAwB,CAyBhF"}

package/dist/contracts/circadian-default.js

@@ -0,0 +1,30 @@
+function createDefaultCircadianInsightContract() {
+  return {
+    async getCurrentSleepWindow() {
+      return {
+        state: null,
+        confidence: 0,
+        lastWakeAtIso: null,
+        currentSleepStartedAtIso: null,
+        bedtimeTargetAtIso: null
+      };
+    },
+    async inferOptimalSchedulingWindow() {
+      return {
+        recommendedAtIso: null,
+        nextMealLabel: null,
+        windowStartIso: null,
+        windowEndIso: null,
+        confidence: 0,
+        reason: "circadian inference not calibrated"
+      };
+    },
+    async getLatestInsight() {
+      return null;
+    }
+  };
+}
+export {
+  createDefaultCircadianInsightContract
+};
+//# sourceMappingURL=circadian-default.js.map

package/dist/contracts/circadian-default.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts/circadian-default.ts"],"sourcesContent":["/**\n * Default `CircadianInsightContract` registered by `plugin-health` during\n * `init`. Consumers (e.g. `app-lifeops` SCHEDULE / SCHEDULED_TASK) read\n * through this contract instead of importing plugin-health internals.\n *\n * The default implementation is intentionally conservative: it returns\n * `state=null` / `recommendedAtIso=null` until a richer impl is registered\n * (e.g. by app-lifeops once its scheduler tick produces a fresh insight).\n * This keeps the contract honest — callers can always tell whether\n * inference is calibrated, and never mistake an uninitialized field for a\n * meaningful zero.\n */\n\nimport type {\n  CircadianInsightContract,\n  SchedulingWindow,\n  SleepWindow,\n} from \"./circadian.js\";\n\nexport function createDefaultCircadianInsightContract(): CircadianInsightContract {\n  return {\n    async getCurrentSleepWindow(): Promise<SleepWindow> {\n      return {\n        state: null,\n        confidence: 0,\n        lastWakeAtIso: null,\n        currentSleepStartedAtIso: null,\n        bedtimeTargetAtIso: null,\n      };\n    },\n    async inferOptimalSchedulingWindow(): Promise<SchedulingWindow> {\n      return {\n        recommendedAtIso: null,\n        nextMealLabel: null,\n        windowStartIso: null,\n        windowEndIso: null,\n        confidence: 0,\n        reason: \"circadian inference not calibrated\",\n      };\n    },\n    async getLatestInsight() {\n      return null;\n    },\n  };\n}\n"],"mappings":"AAmBO,SAAS,wCAAkE;AAChF,SAAO;AAAA,IACL,MAAM,wBAA8C;AAClD,aAAO;AAAA,QACL,OAAO;AAAA,QACP,YAAY;AAAA,QACZ,eAAe;AAAA,QACf,0BAA0B;AAAA,QAC1B,oBAAoB;AAAA,MACtB;AAAA,IACF;AAAA,IACA,MAAM,+BAA0D;AAC9D,aAAO;AAAA,QACL,kBAAkB;AAAA,QAClB,eAAe;AAAA,QACf,gBAAgB;AAAA,QAChB,cAAc;AAAA,QACd,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,IACA,MAAM,mBAAmB;AACvB,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}