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

package/dist/lifeops/registries/app-blocker-contribution.d.ts

@@ -0,0 +1,13 @@
+/**
+ * App-blocker enforcer.
+ *
+ * Wraps the `app-blocker` engine (iOS Family Controls / Android Usage Access)
+ * as a {@link BlockerContribution}. BLOCK target=app dispatches through this
+ * entry instead of importing engine functions directly so a new
+ * mobile-blocker backend (e.g. a desktop screen-time tie-in) is a registration
+ * call.
+ */
+import { type BlockAppsOptions, type BlockAppsResult } from "@elizaos/plugin-blocker/services/app-blocker/index";
+import type { BlockerContribution } from "./blocker-registry.js";
+export declare const appBlockerContribution: BlockerContribution<BlockAppsOptions, BlockAppsResult>;
+//# sourceMappingURL=app-blocker-contribution.d.ts.map

package/dist/lifeops/registries/app-blocker-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-blocker-contribution.d.ts","sourceRoot":"","sources":["../../../src/lifeops/registries/app-blocker-contribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAIrB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,KAAK,EAEV,mBAAmB,EAEpB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,CACtD,gBAAgB,EAChB,eAAe,CAuEhB,CAAC"}

package/dist/lifeops/registries/app-blocker-contribution.js

@@ -0,0 +1,73 @@
+import {
+  getAppBlockerStatus,
+  startAppBlock,
+  stopAppBlock
+} from "@elizaos/plugin-blocker/services/app-blocker/index";
+const appBlockerContribution = {
+  kind: "app",
+  describe: {
+    label: "Phone-app blocker (iOS Family Controls / Android Usage Access)"
+  },
+  async verifyAvailable() {
+    const status = await getAppBlockerStatus();
+    if (!status.available) {
+      return {
+        available: false,
+        reason: status.reason ?? "App blocking is not available on this device.",
+        permission: "denied"
+      };
+    }
+    const permission = (() => {
+      switch (status.permissionStatus) {
+        case "granted":
+          return "granted";
+        case "denied":
+          return "denied";
+        default:
+          return "prompt";
+      }
+    })();
+    return {
+      available: true,
+      reason: null,
+      permission
+    };
+  },
+  async start(request) {
+    return startAppBlock(request);
+  },
+  async stop() {
+    const result = await stopAppBlock();
+    if (!result.success) {
+      throw new Error(result.error ?? "Failed to remove app block.");
+    }
+  },
+  async status() {
+    const status = await getAppBlockerStatus();
+    if (!status.available) {
+      return {
+        active: false,
+        endsAt: null,
+        text: status.reason ?? "App blocking is not available on this device."
+      };
+    }
+    if (!status.active) {
+      return {
+        active: false,
+        endsAt: null,
+        text: "No app block is active right now."
+      };
+    }
+    const countText = `${status.blockedCount} app${status.blockedCount !== 1 ? "s" : ""}`;
+    const untilText = status.endsAt ? `until ${status.endsAt}` : "until you remove it";
+    return {
+      active: true,
+      endsAt: status.endsAt,
+      text: `An app block is active for ${countText} ${untilText}.`
+    };
+  }
+};
+export {
+  appBlockerContribution
+};
+//# sourceMappingURL=app-blocker-contribution.js.map

package/dist/lifeops/registries/app-blocker-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/registries/app-blocker-contribution.ts"],"sourcesContent":["/**\n * App-blocker enforcer.\n *\n * Wraps the `app-blocker` engine (iOS Family Controls / Android Usage Access)\n * as a {@link BlockerContribution}. BLOCK target=app dispatches through this\n * entry instead of importing engine functions directly so a new\n * mobile-blocker backend (e.g. a desktop screen-time tie-in) is a registration\n * call.\n */\n\nimport {\n  type BlockAppsOptions,\n  type BlockAppsResult,\n  getAppBlockerStatus,\n  startAppBlock,\n  stopAppBlock,\n} from \"@elizaos/plugin-blocker/services/app-blocker/index\";\nimport type {\n  BlockerAvailability,\n  BlockerContribution,\n  BlockerStatusSummary,\n} from \"./blocker-registry.js\";\n\nexport const appBlockerContribution: BlockerContribution<\n  BlockAppsOptions,\n  BlockAppsResult\n> = {\n  kind: \"app\",\n  describe: {\n    label: \"Phone-app blocker (iOS Family Controls / Android Usage Access)\",\n  },\n\n  async verifyAvailable(): Promise<BlockerAvailability> {\n    const status = await getAppBlockerStatus();\n    if (!status.available) {\n      return {\n        available: false,\n        reason:\n          status.reason ?? \"App blocking is not available on this device.\",\n        permission: \"denied\",\n      };\n    }\n    const permission = ((): BlockerAvailability[\"permission\"] => {\n      switch (status.permissionStatus) {\n        case \"granted\":\n          return \"granted\";\n        case \"denied\":\n          return \"denied\";\n        default:\n          return \"prompt\";\n      }\n    })();\n    return {\n      available: true,\n      reason: null,\n      permission,\n    };\n  },\n\n  async start(request: BlockAppsOptions): Promise<BlockAppsResult> {\n    return startAppBlock(request);\n  },\n\n  async stop(): Promise<void> {\n    const result = await stopAppBlock();\n    if (!result.success) {\n      throw new Error(result.error ?? \"Failed to remove app block.\");\n    }\n  },\n\n  async status(): Promise<BlockerStatusSummary> {\n    const status = await getAppBlockerStatus();\n    if (!status.available) {\n      return {\n        active: false,\n        endsAt: null,\n        text: status.reason ?? \"App blocking is not available on this device.\",\n      };\n    }\n    if (!status.active) {\n      return {\n        active: false,\n        endsAt: null,\n        text: \"No app block is active right now.\",\n      };\n    }\n    const countText = `${status.blockedCount} app${status.blockedCount !== 1 ? \"s\" : \"\"}`;\n    const untilText = status.endsAt\n      ? `until ${status.endsAt}`\n      : \"until you remove it\";\n    return {\n      active: true,\n      endsAt: status.endsAt,\n      text: `An app block is active for ${countText} ${untilText}.`,\n    };\n  },\n};\n"],"mappings":"AAUA;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOA,MAAM,yBAGT;AAAA,EACF,MAAM;AAAA,EACN,UAAU;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EAEA,MAAM,kBAAgD;AACpD,UAAM,SAAS,MAAM,oBAAoB;AACzC,QAAI,CAAC,OAAO,WAAW;AACrB,aAAO;AAAA,QACL,WAAW;AAAA,QACX,QACE,OAAO,UAAU;AAAA,QACnB,YAAY;AAAA,MACd;AAAA,IACF;AACA,UAAM,cAAc,MAAyC;AAC3D,cAAQ,OAAO,kBAAkB;AAAA,QAC/B,KAAK;AACH,iBAAO;AAAA,QACT,KAAK;AACH,iBAAO;AAAA,QACT;AACE,iBAAO;AAAA,MACX;AAAA,IACF,GAAG;AACH,WAAO;AAAA,MACL,WAAW;AAAA,MACX,QAAQ;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,SAAqD;AAC/D,WAAO,cAAc,OAAO;AAAA,EAC9B;AAAA,EAEA,MAAM,OAAsB;AAC1B,UAAM,SAAS,MAAM,aAAa;AAClC,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,IAAI,MAAM,OAAO,SAAS,6BAA6B;AAAA,IAC/D;AAAA,EACF;AAAA,EAEA,MAAM,SAAwC;AAC5C,UAAM,SAAS,MAAM,oBAAoB;AACzC,QAAI,CAAC,OAAO,WAAW;AACrB,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,QAAQ;AAAA,QACR,MAAM,OAAO,UAAU;AAAA,MACzB;AAAA,IACF;AACA,QAAI,CAAC,OAAO,QAAQ;AAClB,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AACA,UAAM,YAAY,GAAG,OAAO,YAAY,OAAO,OAAO,iBAAiB,IAAI,MAAM,EAAE;AACnF,UAAM,YAAY,OAAO,SACrB,SAAS,OAAO,MAAM,KACtB;AACJ,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,QAAQ,OAAO;AAAA,MACf,MAAM,8BAA8B,SAAS,IAAI,SAAS;AAAA,IAC5D;AAAA,EACF;AACF;","names":[]}

package/dist/lifeops/registries/blocker-registry.d.ts

@@ -0,0 +1,76 @@
+/**
+ * BlockerRegistry. Blockers (hosts-file website blocker on macOS, iOS Family
+ * Controls / Android Usage Access for app blocking) are registry-driven so the
+ * BLOCK action targets dispatch through one canonical surface instead of
+ * branching on `kind` inline.
+ *
+ * The registry is dispatcher-internal. Adding a new blocker (e.g. a
+ * router-level DNS blocker, a Bluetooth-tether blocker) is a registration
+ * call, not a new action.
+ *
+ * Outbound contract (one entry per enforcer):
+ *   - `kind`: stable enforcer key — `"website"` for the macOS hosts-file
+ *     blocker, `"app"` for the iOS/Android phone-app blocker.
+ *   - `start(request)` / `stop()` / `status()`: enforcement primitives the
+ *     umbrella action calls. Result types are blocker-specific (websites
+ *     return host lists; apps return blocked package counts) so the
+ *     registry surfaces them without a forced common shape.
+ *   - `verifyAvailable()`: unified availability probe used at first-run and
+ *     before every dispatch. Returns reason text on failure so the action
+ *     can surface it to the user verbatim.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+export type BlockerKind = "website" | "app";
+export interface BlockerAvailability {
+    available: boolean;
+    /** Free-form reason text. Required when `available === false`. */
+    reason: string | null;
+    /**
+     * `granted` means the OS has handed the blocker the permission it needs;
+     * `prompt` means we can ask; `denied` means we cannot ask without manual
+     * user intervention; `not-applicable` means the blocker has no permission
+     * model on this platform.
+     */
+    permission: "granted" | "prompt" | "denied" | "not-applicable";
+}
+export interface BlockerStatusSummary {
+    /** Whether an enforcement is currently active. */
+    active: boolean;
+    /** ISO timestamp; `null` for indefinite blocks. */
+    endsAt: string | null;
+    /** Free-form summary text the umbrella action surfaces verbatim. */
+    text: string;
+}
+/**
+ * One registered enforcer. The shape is intentionally minimal — the umbrella
+ * actions own the LLM extraction, draft/confirm flow, and chat replies; the
+ * enforcer only owns the OS-level start/stop/status primitives.
+ *
+ * Generic over the `start` request type because hosts-file websites and
+ * phone-app blocks have different inputs and forcing a union here would
+ * push runtime branching back into callers.
+ */
+export interface BlockerContribution<StartRequest, StartResult> {
+    kind: BlockerKind;
+    /** Short human label, surfaces in pack-detail UI / debug logs. */
+    describe: {
+        label: string;
+    };
+    verifyAvailable(): Promise<BlockerAvailability>;
+    /** Start enforcement. The umbrella action passes through pre-validated input. */
+    start(request: StartRequest): Promise<StartResult>;
+    /** Stop the active enforcement. */
+    stop(): Promise<void>;
+    /** Compact summary for status reads. */
+    status(): Promise<BlockerStatusSummary>;
+}
+export interface BlockerRegistry {
+    register<StartRequest, StartResult>(contribution: BlockerContribution<StartRequest, StartResult>): void;
+    list(): BlockerContribution<unknown, unknown>[];
+    get(kind: BlockerKind): BlockerContribution<unknown, unknown> | null;
+}
+export declare function createBlockerRegistry(): BlockerRegistry;
+export declare function registerBlockerRegistry(runtime: IAgentRuntime, registry: BlockerRegistry): void;
+export declare function getBlockerRegistry(runtime: IAgentRuntime): BlockerRegistry | null;
+export declare function __resetBlockerRegistryForTests(runtime: IAgentRuntime): void;
+//# sourceMappingURL=blocker-registry.d.ts.map

package/dist/lifeops/registries/blocker-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocker-registry.d.ts","sourceRoot":"","sources":["../../../src/lifeops/registries/blocker-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;;;OAKG;IACH,UAAU,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,CAAC;CAChE;AAED,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB,mDAAmD;IACnD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB,CAAC,YAAY,EAAE,WAAW;IAC5D,IAAI,EAAE,WAAW,CAAC;IAElB,kEAAkE;IAClE,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAE5B,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhD,iFAAiF;IACjF,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnD,mCAAmC;IACnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,wCAAwC;IACxC,MAAM,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,WAAW,EAChC,YAAY,EAAE,mBAAmB,CAAC,YAAY,EAAE,WAAW,CAAC,GAC3D,IAAI,CAAC;IACR,IAAI,IAAI,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;IAChD,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACtE;AA+BD,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD;AASD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,eAAe,GACxB,IAAI,CAEN;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,GACrB,eAAe,GAAG,IAAI,CAExB;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE3E"}

package/dist/lifeops/registries/blocker-registry.js

@@ -0,0 +1,40 @@
+class InMemoryBlockerRegistry {
+  byKind = /* @__PURE__ */ new Map();
+  register(contribution) {
+    if (this.byKind.has(contribution.kind)) {
+      throw new Error(
+        `[BlockerRegistry] kind "${contribution.kind}" already registered`
+      );
+    }
+    this.byKind.set(
+      contribution.kind,
+      contribution
+    );
+  }
+  list() {
+    return Array.from(this.byKind.values());
+  }
+  get(kind) {
+    return this.byKind.get(kind) ?? null;
+  }
+}
+function createBlockerRegistry() {
+  return new InMemoryBlockerRegistry();
+}
+const registries = /* @__PURE__ */ new WeakMap();
+function registerBlockerRegistry(runtime, registry) {
+  registries.set(runtime, registry);
+}
+function getBlockerRegistry(runtime) {
+  return registries.get(runtime) ?? null;
+}
+function __resetBlockerRegistryForTests(runtime) {
+  registries.delete(runtime);
+}
+export {
+  __resetBlockerRegistryForTests,
+  createBlockerRegistry,
+  getBlockerRegistry,
+  registerBlockerRegistry
+};
+//# sourceMappingURL=blocker-registry.js.map

package/dist/lifeops/registries/blocker-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/registries/blocker-registry.ts"],"sourcesContent":["/**\n * BlockerRegistry. Blockers (hosts-file website blocker on macOS, iOS Family\n * Controls / Android Usage Access for app blocking) are registry-driven so the\n * BLOCK action targets dispatch through one canonical surface instead of\n * branching on `kind` inline.\n *\n * The registry is dispatcher-internal. Adding a new blocker (e.g. a\n * router-level DNS blocker, a Bluetooth-tether blocker) is a registration\n * call, not a new action.\n *\n * Outbound contract (one entry per enforcer):\n *   - `kind`: stable enforcer key — `\"website\"` for the macOS hosts-file\n *     blocker, `\"app\"` for the iOS/Android phone-app blocker.\n *   - `start(request)` / `stop()` / `status()`: enforcement primitives the\n *     umbrella action calls. Result types are blocker-specific (websites\n *     return host lists; apps return blocked package counts) so the\n *     registry surfaces them without a forced common shape.\n *   - `verifyAvailable()`: unified availability probe used at first-run and\n *     before every dispatch. Returns reason text on failure so the action\n *     can surface it to the user verbatim.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\n\nexport type BlockerKind = \"website\" | \"app\";\n\nexport interface BlockerAvailability {\n  available: boolean;\n  /** Free-form reason text. Required when `available === false`. */\n  reason: string | null;\n  /**\n   * `granted` means the OS has handed the blocker the permission it needs;\n   * `prompt` means we can ask; `denied` means we cannot ask without manual\n   * user intervention; `not-applicable` means the blocker has no permission\n   * model on this platform.\n   */\n  permission: \"granted\" | \"prompt\" | \"denied\" | \"not-applicable\";\n}\n\nexport interface BlockerStatusSummary {\n  /** Whether an enforcement is currently active. */\n  active: boolean;\n  /** ISO timestamp; `null` for indefinite blocks. */\n  endsAt: string | null;\n  /** Free-form summary text the umbrella action surfaces verbatim. */\n  text: string;\n}\n\n/**\n * One registered enforcer. The shape is intentionally minimal — the umbrella\n * actions own the LLM extraction, draft/confirm flow, and chat replies; the\n * enforcer only owns the OS-level start/stop/status primitives.\n *\n * Generic over the `start` request type because hosts-file websites and\n * phone-app blocks have different inputs and forcing a union here would\n * push runtime branching back into callers.\n */\nexport interface BlockerContribution<StartRequest, StartResult> {\n  kind: BlockerKind;\n\n  /** Short human label, surfaces in pack-detail UI / debug logs. */\n  describe: { label: string };\n\n  verifyAvailable(): Promise<BlockerAvailability>;\n\n  /** Start enforcement. The umbrella action passes through pre-validated input. */\n  start(request: StartRequest): Promise<StartResult>;\n\n  /** Stop the active enforcement. */\n  stop(): Promise<void>;\n\n  /** Compact summary for status reads. */\n  status(): Promise<BlockerStatusSummary>;\n}\n\nexport interface BlockerRegistry {\n  register<StartRequest, StartResult>(\n    contribution: BlockerContribution<StartRequest, StartResult>,\n  ): void;\n  list(): BlockerContribution<unknown, unknown>[];\n  get(kind: BlockerKind): BlockerContribution<unknown, unknown> | null;\n}\n\nclass InMemoryBlockerRegistry implements BlockerRegistry {\n  private readonly byKind = new Map<\n    BlockerKind,\n    BlockerContribution<unknown, unknown>\n  >();\n\n  register<StartRequest, StartResult>(\n    contribution: BlockerContribution<StartRequest, StartResult>,\n  ): void {\n    if (this.byKind.has(contribution.kind)) {\n      throw new Error(\n        `[BlockerRegistry] kind \"${contribution.kind}\" already registered`,\n      );\n    }\n    this.byKind.set(\n      contribution.kind,\n      contribution as BlockerContribution<unknown, unknown>,\n    );\n  }\n\n  list(): BlockerContribution<unknown, unknown>[] {\n    return Array.from(this.byKind.values());\n  }\n\n  get(kind: BlockerKind): BlockerContribution<unknown, unknown> | null {\n    return this.byKind.get(kind) ?? null;\n  }\n}\n\nexport function createBlockerRegistry(): BlockerRegistry {\n  return new InMemoryBlockerRegistry();\n}\n\n/**\n * Per-runtime registration. Mirrors `registerConnectorRegistry` /\n * `registerSendPolicy` — `WeakMap` keyed by runtime so the registry lifetime\n * tracks the runtime and tests don't leak registrations across each other.\n */\nconst registries = new WeakMap<IAgentRuntime, BlockerRegistry>();\n\nexport function registerBlockerRegistry(\n  runtime: IAgentRuntime,\n  registry: BlockerRegistry,\n): void {\n  registries.set(runtime, registry);\n}\n\nexport function getBlockerRegistry(\n  runtime: IAgentRuntime,\n): BlockerRegistry | null {\n  return registries.get(runtime) ?? null;\n}\n\nexport function __resetBlockerRegistryForTests(runtime: IAgentRuntime): void {\n  registries.delete(runtime);\n}\n"],"mappings":"AAmFA,MAAM,wBAAmD;AAAA,EACtC,SAAS,oBAAI,IAG5B;AAAA,EAEF,SACE,cACM;AACN,QAAI,KAAK,OAAO,IAAI,aAAa,IAAI,GAAG;AACtC,YAAM,IAAI;AAAA,QACR,2BAA2B,aAAa,IAAI;AAAA,MAC9C;AAAA,IACF;AACA,SAAK,OAAO;AAAA,MACV,aAAa;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAgD;AAC9C,WAAO,MAAM,KAAK,KAAK,OAAO,OAAO,CAAC;AAAA,EACxC;AAAA,EAEA,IAAI,MAAiE;AACnE,WAAO,KAAK,OAAO,IAAI,IAAI,KAAK;AAAA,EAClC;AACF;AAEO,SAAS,wBAAyC;AACvD,SAAO,IAAI,wBAAwB;AACrC;AAOA,MAAM,aAAa,oBAAI,QAAwC;AAExD,SAAS,wBACd,SACA,UACM;AACN,aAAW,IAAI,SAAS,QAAQ;AAClC;AAEO,SAAS,mBACd,SACwB;AACxB,SAAO,WAAW,IAAI,OAAO,KAAK;AACpC;AAEO,SAAS,+BAA+B,SAA8B;AAC3E,aAAW,OAAO,OAAO;AAC3B;","names":[]}

package/dist/lifeops/registries/event-kind-registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * EventKindRegistry.
+ *
+ * `ScheduledTask.trigger.kind = "event"` carries an `eventKind: string` and
+ * an opaque `filter: EventFilter`. The registry types each `eventKind` per
+ * contribution: producers register `{ eventKind, filterSchema, describe }`
+ * and the runner asks the registry to validate / parse the filter before
+ * subscribing to bus events.
+ *
+ * The registry is per-runtime (mirrors `connectorRegistry`), validates
+ * uniqueness, and deliberately keeps the `filterSchema` opaque (`unknown`)
+ * so different producers can use different schema formats (JSON Schema,
+ * Zod, or plain shape descriptors) without a forced common-schema
+ * abstraction.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+export interface EventKindContribution {
+    /** Stable event-kind identifier — `"calendar.meeting.ended"`, `"health.wake.confirmed"`, etc. */
+    eventKind: string;
+    /**
+     * Opaque schema descriptor for the trigger's `filter` payload. The runner
+     * does not interpret the schema; downstream gate code consults the
+     * registered contribution if it needs to validate filter shape.
+     */
+    filterSchema?: unknown;
+    /** Human-readable diagnostics. */
+    describe: {
+        label: string;
+        provider: string;
+    };
+    /**
+     * Optional payload-shape descriptor for the bus event itself (when
+     * routed through `signals/bus.ts`). Unused by the runner; surfaced for
+     * tooling.
+     */
+    payloadSchema?: unknown;
+}
+export interface EventKindRegistry {
+    register(contribution: EventKindContribution): void;
+    list(filter?: {
+        provider?: string;
+    }): EventKindContribution[];
+    get(eventKind: string): EventKindContribution | null;
+    has(eventKind: string): boolean;
+}
+export declare function createEventKindRegistry(): EventKindRegistry;
+/**
+ * Default app-lifeops event-kind contributions: calendar + time-window
+ * events emitted by the calendar / anchor surfaces. plugin-health registers
+ * its own `health.*` event kinds via its registration entry point.
+ */
+export declare const APP_LIFEOPS_EVENT_KINDS: readonly EventKindContribution[];
+export declare function registerAppLifeOpsEventKinds(registry: EventKindRegistry): void;
+export declare function registerEventKindRegistry(runtime: IAgentRuntime, registry: EventKindRegistry): void;
+export declare function getEventKindRegistry(runtime: IAgentRuntime): EventKindRegistry | null;
+export declare function __resetEventKindRegistryForTests(runtime: IAgentRuntime): void;
+//# sourceMappingURL=event-kind-registry.d.ts.map

package/dist/lifeops/registries/event-kind-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-kind-registry.d.ts","sourceRoot":"","sources":["../../../src/lifeops/registries/event-kind-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,iGAAiG;IACjG,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kCAAkC;IAClC,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,qBAAqB,EAAE,CAAC;IAC9D,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAAC;IACrD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAgCD,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,qBAAqB,EA6BnE,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,iBAAiB,GAC1B,IAAI,CAIN;AAID,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,GACrB,iBAAiB,GAAG,IAAI,CAE1B;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE7E"}

package/dist/lifeops/registries/event-kind-registry.js

@@ -0,0 +1,82 @@
+class InMemoryEventKindRegistry {
+  byKind = /* @__PURE__ */ new Map();
+  register(contribution) {
+    if (!contribution.eventKind) {
+      throw new Error("EventKindRegistry.register: eventKind is required");
+    }
+    if (this.byKind.has(contribution.eventKind)) {
+      throw new Error(
+        `EventKindRegistry.register: eventKind "${contribution.eventKind}" already registered`
+      );
+    }
+    this.byKind.set(contribution.eventKind, contribution);
+  }
+  list(filter) {
+    const all = Array.from(this.byKind.values());
+    if (!filter?.provider) return all;
+    return all.filter((c) => c.describe.provider === filter.provider);
+  }
+  get(eventKind) {
+    return this.byKind.get(eventKind) ?? null;
+  }
+  has(eventKind) {
+    return this.byKind.has(eventKind);
+  }
+}
+function createEventKindRegistry() {
+  return new InMemoryEventKindRegistry();
+}
+const APP_LIFEOPS_EVENT_KINDS = [
+  {
+    eventKind: "calendar.meeting.ended",
+    describe: {
+      label: "Calendar meeting end-edge",
+      provider: "app-lifeops:calendar"
+    }
+  },
+  {
+    eventKind: "time.morning.start",
+    describe: {
+      label: "Owner morning window opened",
+      provider: "app-lifeops:time-window"
+    }
+  },
+  {
+    eventKind: "time.lunch.start",
+    describe: {
+      label: "Owner lunch window opened",
+      provider: "app-lifeops:time-window"
+    }
+  },
+  {
+    eventKind: "time.night.start",
+    describe: {
+      label: "Owner evening / wind-down window opened",
+      provider: "app-lifeops:time-window"
+    }
+  }
+];
+function registerAppLifeOpsEventKinds(registry) {
+  for (const contribution of APP_LIFEOPS_EVENT_KINDS) {
+    registry.register(contribution);
+  }
+}
+const registries = /* @__PURE__ */ new WeakMap();
+function registerEventKindRegistry(runtime, registry) {
+  registries.set(runtime, registry);
+}
+function getEventKindRegistry(runtime) {
+  return registries.get(runtime) ?? null;
+}
+function __resetEventKindRegistryForTests(runtime) {
+  registries.delete(runtime);
+}
+export {
+  APP_LIFEOPS_EVENT_KINDS,
+  __resetEventKindRegistryForTests,
+  createEventKindRegistry,
+  getEventKindRegistry,
+  registerAppLifeOpsEventKinds,
+  registerEventKindRegistry
+};
+//# sourceMappingURL=event-kind-registry.js.map

package/dist/lifeops/registries/event-kind-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/registries/event-kind-registry.ts"],"sourcesContent":["/**\n * EventKindRegistry.\n *\n * `ScheduledTask.trigger.kind = \"event\"` carries an `eventKind: string` and\n * an opaque `filter: EventFilter`. The registry types each `eventKind` per\n * contribution: producers register `{ eventKind, filterSchema, describe }`\n * and the runner asks the registry to validate / parse the filter before\n * subscribing to bus events.\n *\n * The registry is per-runtime (mirrors `connectorRegistry`), validates\n * uniqueness, and deliberately keeps the `filterSchema` opaque (`unknown`)\n * so different producers can use different schema formats (JSON Schema,\n * Zod, or plain shape descriptors) without a forced common-schema\n * abstraction.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\n\nexport interface EventKindContribution {\n  /** Stable event-kind identifier — `\"calendar.meeting.ended\"`, `\"health.wake.confirmed\"`, etc. */\n  eventKind: string;\n  /**\n   * Opaque schema descriptor for the trigger's `filter` payload. The runner\n   * does not interpret the schema; downstream gate code consults the\n   * registered contribution if it needs to validate filter shape.\n   */\n  filterSchema?: unknown;\n  /** Human-readable diagnostics. */\n  describe: { label: string; provider: string };\n  /**\n   * Optional payload-shape descriptor for the bus event itself (when\n   * routed through `signals/bus.ts`). Unused by the runner; surfaced for\n   * tooling.\n   */\n  payloadSchema?: unknown;\n}\n\nexport interface EventKindRegistry {\n  register(contribution: EventKindContribution): void;\n  list(filter?: { provider?: string }): EventKindContribution[];\n  get(eventKind: string): EventKindContribution | null;\n  has(eventKind: string): boolean;\n}\n\nclass InMemoryEventKindRegistry implements EventKindRegistry {\n  private readonly byKind = new Map<string, EventKindContribution>();\n\n  register(contribution: EventKindContribution): void {\n    if (!contribution.eventKind) {\n      throw new Error(\"EventKindRegistry.register: eventKind is required\");\n    }\n    if (this.byKind.has(contribution.eventKind)) {\n      throw new Error(\n        `EventKindRegistry.register: eventKind \"${contribution.eventKind}\" already registered`,\n      );\n    }\n    this.byKind.set(contribution.eventKind, contribution);\n  }\n\n  list(filter?: { provider?: string }): EventKindContribution[] {\n    const all = Array.from(this.byKind.values());\n    if (!filter?.provider) return all;\n    return all.filter((c) => c.describe.provider === filter.provider);\n  }\n\n  get(eventKind: string): EventKindContribution | null {\n    return this.byKind.get(eventKind) ?? null;\n  }\n\n  has(eventKind: string): boolean {\n    return this.byKind.has(eventKind);\n  }\n}\n\nexport function createEventKindRegistry(): EventKindRegistry {\n  return new InMemoryEventKindRegistry();\n}\n\n/**\n * Default app-lifeops event-kind contributions: calendar + time-window\n * events emitted by the calendar / anchor surfaces. plugin-health registers\n * its own `health.*` event kinds via its registration entry point.\n */\nexport const APP_LIFEOPS_EVENT_KINDS: readonly EventKindContribution[] = [\n  {\n    eventKind: \"calendar.meeting.ended\",\n    describe: {\n      label: \"Calendar meeting end-edge\",\n      provider: \"app-lifeops:calendar\",\n    },\n  },\n  {\n    eventKind: \"time.morning.start\",\n    describe: {\n      label: \"Owner morning window opened\",\n      provider: \"app-lifeops:time-window\",\n    },\n  },\n  {\n    eventKind: \"time.lunch.start\",\n    describe: {\n      label: \"Owner lunch window opened\",\n      provider: \"app-lifeops:time-window\",\n    },\n  },\n  {\n    eventKind: \"time.night.start\",\n    describe: {\n      label: \"Owner evening / wind-down window opened\",\n      provider: \"app-lifeops:time-window\",\n    },\n  },\n];\n\nexport function registerAppLifeOpsEventKinds(\n  registry: EventKindRegistry,\n): void {\n  for (const contribution of APP_LIFEOPS_EVENT_KINDS) {\n    registry.register(contribution);\n  }\n}\n\nconst registries = new WeakMap<IAgentRuntime, EventKindRegistry>();\n\nexport function registerEventKindRegistry(\n  runtime: IAgentRuntime,\n  registry: EventKindRegistry,\n): void {\n  registries.set(runtime, registry);\n}\n\nexport function getEventKindRegistry(\n  runtime: IAgentRuntime,\n): EventKindRegistry | null {\n  return registries.get(runtime) ?? null;\n}\n\nexport function __resetEventKindRegistryForTests(runtime: IAgentRuntime): void {\n  registries.delete(runtime);\n}\n"],"mappings":"AA4CA,MAAM,0BAAuD;AAAA,EAC1C,SAAS,oBAAI,IAAmC;AAAA,EAEjE,SAAS,cAA2C;AAClD,QAAI,CAAC,aAAa,WAAW;AAC3B,YAAM,IAAI,MAAM,mDAAmD;AAAA,IACrE;AACA,QAAI,KAAK,OAAO,IAAI,aAAa,SAAS,GAAG;AAC3C,YAAM,IAAI;AAAA,QACR,0CAA0C,aAAa,SAAS;AAAA,MAClE;AAAA,IACF;AACA,SAAK,OAAO,IAAI,aAAa,WAAW,YAAY;AAAA,EACtD;AAAA,EAEA,KAAK,QAAyD;AAC5D,UAAM,MAAM,MAAM,KAAK,KAAK,OAAO,OAAO,CAAC;AAC3C,QAAI,CAAC,QAAQ,SAAU,QAAO;AAC9B,WAAO,IAAI,OAAO,CAAC,MAAM,EAAE,SAAS,aAAa,OAAO,QAAQ;AAAA,EAClE;AAAA,EAEA,IAAI,WAAiD;AACnD,WAAO,KAAK,OAAO,IAAI,SAAS,KAAK;AAAA,EACvC;AAAA,EAEA,IAAI,WAA4B;AAC9B,WAAO,KAAK,OAAO,IAAI,SAAS;AAAA,EAClC;AACF;AAEO,SAAS,0BAA6C;AAC3D,SAAO,IAAI,0BAA0B;AACvC;AAOO,MAAM,0BAA4D;AAAA,EACvE;AAAA,IACE,WAAW;AAAA,IACX,UAAU;AAAA,MACR,OAAO;AAAA,MACP,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA;AAAA,IACE,WAAW;AAAA,IACX,UAAU;AAAA,MACR,OAAO;AAAA,MACP,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA;AAAA,IACE,WAAW;AAAA,IACX,UAAU;AAAA,MACR,OAAO;AAAA,MACP,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA;AAAA,IACE,WAAW;AAAA,IACX,UAAU;AAAA,MACR,OAAO;AAAA,MACP,UAAU;AAAA,IACZ;AAAA,EACF;AACF;AAEO,SAAS,6BACd,UACM;AACN,aAAW,gBAAgB,yBAAyB;AAClD,aAAS,SAAS,YAAY;AAAA,EAChC;AACF;AAEA,MAAM,aAAa,oBAAI,QAA0C;AAE1D,SAAS,0BACd,SACA,UACM;AACN,aAAW,IAAI,SAAS,QAAQ;AAClC;AAEO,SAAS,qBACd,SAC0B;AAC1B,SAAO,WAAW,IAAI,OAAO,KAAK;AACpC;AAEO,SAAS,iCAAiC,SAA8B;AAC7E,aAAW,OAAO,OAAO;AAC3B;","names":[]}

package/dist/lifeops/registries/family-registry.d.ts

@@ -0,0 +1,72 @@
+/**
+ * FamilyRegistry.
+ *
+ * Lifts the closed `LIFEOPS_TELEMETRY_FAMILIES` discriminated union into an
+ * open registry of namespaced bus-family identifiers. The closed union still
+ * encodes the canonical telemetry payload schemas in
+ * `packages/shared/src/contracts/lifeops.ts` for the built-in 11 families;
+ * the registry tracks every family that flows through the activity-signal
+ * bus, including new namespaced contributions like `health.sleep.detected`,
+ * `calendar.meeting.ended`, etc.
+ *
+ * Family-name convention:
+ *   - built-ins: lower-snake-case (`device_presence_event`, `manual_override_event`).
+ *   - namespaced contributions: dotted, lower-case (`health.sleep.detected`,
+ *     `calendar.meeting.ended`, `time.morning.start`).
+ *
+ * The registry is per-runtime and validates membership at runtime; producers
+ * push events through `ActivitySignalBus` (see `signals/bus.ts`) which
+ * consults the registry.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import { type LifeOpsBusFamily, type LifeOpsTelemetryFamily } from "@elizaos/shared";
+export interface BusFamilyContribution {
+    /** Open-string family identifier (built-in or namespaced). */
+    family: LifeOpsBusFamily;
+    /** Human-readable description for diagnostics + the planner. */
+    description: string;
+    /**
+     * Producer of this family. `"plugin-health"`, `"app-lifeops"`,
+     * `"plugin-calendar"`, etc. Free-form because new plugins can register.
+     */
+    source: string;
+    /**
+     * Optional namespace prefix (e.g. `"health"`, `"calendar"`, `"time"`). When
+     * absent, the family is a built-in `LifeOpsTelemetryFamily`.
+     */
+    namespace?: string;
+}
+export interface FamilyRegistry {
+    register(contribution: BusFamilyContribution): void;
+    list(filter?: {
+        namespace?: string;
+        source?: string;
+    }): BusFamilyContribution[];
+    get(family: LifeOpsBusFamily): BusFamilyContribution | null;
+    has(family: LifeOpsBusFamily): boolean;
+    /**
+     * `true` when the family is the closed `LifeOpsTelemetryFamily` union from
+     * the shared contracts (i.e. it carries a typed payload schema). Used by
+     * the bus layer to decide whether to validate the payload shape.
+     */
+    isBuiltin(family: LifeOpsBusFamily): family is LifeOpsTelemetryFamily;
+}
+export declare function createFamilyRegistry(): FamilyRegistry;
+/**
+ * Register the 11 built-in `LIFEOPS_TELEMETRY_FAMILIES` so callers can rely
+ * on `registry.has(family)` for any family carried in
+ * `LifeOpsTelemetryEnvelope`.
+ */
+export declare function registerBuiltinTelemetryFamilies(registry: FamilyRegistry): void;
+/**
+ * App-lifeops contributes the calendar / time-window namespaced families
+ * (`meeting.ended`, `morning.start`, `lunch.start`, `night.start`).
+ * plugin-health contributes its `health.*` families through its own
+ * registration entry point.
+ */
+export declare const APP_LIFEOPS_BUS_FAMILIES: readonly BusFamilyContribution[];
+export declare function registerAppLifeOpsBusFamilies(registry: FamilyRegistry): void;
+export declare function registerFamilyRegistry(runtime: IAgentRuntime, registry: FamilyRegistry): void;
+export declare function getFamilyRegistry(runtime: IAgentRuntime): FamilyRegistry | null;
+export declare function __resetFamilyRegistryForTests(runtime: IAgentRuntime): void;
+//# sourceMappingURL=family-registry.d.ts.map

package/dist/lifeops/registries/family-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-registry.d.ts","sourceRoot":"","sources":["../../../src/lifeops/registries/family-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,MAAM,EAAE,gBAAgB,CAAC;IACzB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,EAAE;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,qBAAqB,EAAE,CAAC;IAC5B,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,qBAAqB,GAAG,IAAI,CAAC;IAC5D,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;IACvC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,IAAI,sBAAsB,CAAC;CACvE;AA8CD,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,cAAc,GACvB,IAAI,CAQN;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EA6BpE,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAI5E;AASD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,GACvB,IAAI,CAEN;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,GACrB,cAAc,GAAG,IAAI,CAEvB;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE1E"}

package/dist/lifeops/registries/family-registry.js

@@ -0,0 +1,98 @@
+import {
+  LIFEOPS_TELEMETRY_FAMILIES
+} from "@elizaos/shared";
+class InMemoryFamilyRegistry {
+  byFamily = /* @__PURE__ */ new Map();
+  register(contribution) {
+    if (!contribution.family) {
+      throw new Error("FamilyRegistry.register: family is required");
+    }
+    if (this.byFamily.has(contribution.family)) {
+      throw new Error(
+        `FamilyRegistry.register: family "${contribution.family}" already registered`
+      );
+    }
+    this.byFamily.set(contribution.family, contribution);
+  }
+  list(filter) {
+    const all = Array.from(this.byFamily.values());
+    if (!filter) return all;
+    return all.filter((c) => {
+      if (filter.namespace && c.namespace !== filter.namespace) return false;
+      if (filter.source && c.source !== filter.source) return false;
+      return true;
+    });
+  }
+  get(family) {
+    return this.byFamily.get(family) ?? null;
+  }
+  has(family) {
+    return this.byFamily.has(family);
+  }
+  isBuiltin(family) {
+    return LIFEOPS_TELEMETRY_FAMILIES.includes(family);
+  }
+}
+function createFamilyRegistry() {
+  return new InMemoryFamilyRegistry();
+}
+function registerBuiltinTelemetryFamilies(registry) {
+  for (const family of LIFEOPS_TELEMETRY_FAMILIES) {
+    registry.register({
+      family,
+      description: `LifeOps built-in telemetry family: ${family}`,
+      source: "app-lifeops"
+    });
+  }
+}
+const APP_LIFEOPS_BUS_FAMILIES = [
+  {
+    family: "calendar.meeting.ended",
+    description: "Calendar event end-edge \u2014 emitted when a calendar meeting transitions from in-progress to completed.",
+    source: "app-lifeops",
+    namespace: "calendar"
+  },
+  {
+    family: "time.morning.start",
+    description: "Local-time anchor: owner's configured morning window has just started.",
+    source: "app-lifeops",
+    namespace: "time"
+  },
+  {
+    family: "time.lunch.start",
+    description: "Local-time anchor: owner's configured lunch window has just started.",
+    source: "app-lifeops",
+    namespace: "time"
+  },
+  {
+    family: "time.night.start",
+    description: "Local-time anchor: owner's configured evening / wind-down window has just started.",
+    source: "app-lifeops",
+    namespace: "time"
+  }
+];
+function registerAppLifeOpsBusFamilies(registry) {
+  for (const contribution of APP_LIFEOPS_BUS_FAMILIES) {
+    registry.register(contribution);
+  }
+}
+const registries = /* @__PURE__ */ new WeakMap();
+function registerFamilyRegistry(runtime, registry) {
+  registries.set(runtime, registry);
+}
+function getFamilyRegistry(runtime) {
+  return registries.get(runtime) ?? null;
+}
+function __resetFamilyRegistryForTests(runtime) {
+  registries.delete(runtime);
+}
+export {
+  APP_LIFEOPS_BUS_FAMILIES,
+  __resetFamilyRegistryForTests,
+  createFamilyRegistry,
+  getFamilyRegistry,
+  registerAppLifeOpsBusFamilies,
+  registerBuiltinTelemetryFamilies,
+  registerFamilyRegistry
+};
+//# sourceMappingURL=family-registry.js.map

package/dist/lifeops/registries/family-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/registries/family-registry.ts"],"sourcesContent":["/**\n * FamilyRegistry.\n *\n * Lifts the closed `LIFEOPS_TELEMETRY_FAMILIES` discriminated union into an\n * open registry of namespaced bus-family identifiers. The closed union still\n * encodes the canonical telemetry payload schemas in\n * `packages/shared/src/contracts/lifeops.ts` for the built-in 11 families;\n * the registry tracks every family that flows through the activity-signal\n * bus, including new namespaced contributions like `health.sleep.detected`,\n * `calendar.meeting.ended`, etc.\n *\n * Family-name convention:\n *   - built-ins: lower-snake-case (`device_presence_event`, `manual_override_event`).\n *   - namespaced contributions: dotted, lower-case (`health.sleep.detected`,\n *     `calendar.meeting.ended`, `time.morning.start`).\n *\n * The registry is per-runtime and validates membership at runtime; producers\n * push events through `ActivitySignalBus` (see `signals/bus.ts`) which\n * consults the registry.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  LIFEOPS_TELEMETRY_FAMILIES,\n  type LifeOpsBusFamily,\n  type LifeOpsTelemetryFamily,\n} from \"@elizaos/shared\";\n\nexport interface BusFamilyContribution {\n  /** Open-string family identifier (built-in or namespaced). */\n  family: LifeOpsBusFamily;\n  /** Human-readable description for diagnostics + the planner. */\n  description: string;\n  /**\n   * Producer of this family. `\"plugin-health\"`, `\"app-lifeops\"`,\n   * `\"plugin-calendar\"`, etc. Free-form because new plugins can register.\n   */\n  source: string;\n  /**\n   * Optional namespace prefix (e.g. `\"health\"`, `\"calendar\"`, `\"time\"`). When\n   * absent, the family is a built-in `LifeOpsTelemetryFamily`.\n   */\n  namespace?: string;\n}\n\nexport interface FamilyRegistry {\n  register(contribution: BusFamilyContribution): void;\n  list(filter?: {\n    namespace?: string;\n    source?: string;\n  }): BusFamilyContribution[];\n  get(family: LifeOpsBusFamily): BusFamilyContribution | null;\n  has(family: LifeOpsBusFamily): boolean;\n  /**\n   * `true` when the family is the closed `LifeOpsTelemetryFamily` union from\n   * the shared contracts (i.e. it carries a typed payload schema). Used by\n   * the bus layer to decide whether to validate the payload shape.\n   */\n  isBuiltin(family: LifeOpsBusFamily): family is LifeOpsTelemetryFamily;\n}\n\nclass InMemoryFamilyRegistry implements FamilyRegistry {\n  private readonly byFamily = new Map<\n    LifeOpsBusFamily,\n    BusFamilyContribution\n  >();\n\n  register(contribution: BusFamilyContribution): void {\n    if (!contribution.family) {\n      throw new Error(\"FamilyRegistry.register: family is required\");\n    }\n    if (this.byFamily.has(contribution.family)) {\n      throw new Error(\n        `FamilyRegistry.register: family \"${contribution.family}\" already registered`,\n      );\n    }\n    this.byFamily.set(contribution.family, contribution);\n  }\n\n  list(filter?: {\n    namespace?: string;\n    source?: string;\n  }): BusFamilyContribution[] {\n    const all = Array.from(this.byFamily.values());\n    if (!filter) return all;\n    return all.filter((c) => {\n      if (filter.namespace && c.namespace !== filter.namespace) return false;\n      if (filter.source && c.source !== filter.source) return false;\n      return true;\n    });\n  }\n\n  get(family: LifeOpsBusFamily): BusFamilyContribution | null {\n    return this.byFamily.get(family) ?? null;\n  }\n\n  has(family: LifeOpsBusFamily): boolean {\n    return this.byFamily.has(family);\n  }\n\n  isBuiltin(family: LifeOpsBusFamily): family is LifeOpsTelemetryFamily {\n    return (LIFEOPS_TELEMETRY_FAMILIES as readonly string[]).includes(family);\n  }\n}\n\nexport function createFamilyRegistry(): FamilyRegistry {\n  return new InMemoryFamilyRegistry();\n}\n\n/**\n * Register the 11 built-in `LIFEOPS_TELEMETRY_FAMILIES` so callers can rely\n * on `registry.has(family)` for any family carried in\n * `LifeOpsTelemetryEnvelope`.\n */\nexport function registerBuiltinTelemetryFamilies(\n  registry: FamilyRegistry,\n): void {\n  for (const family of LIFEOPS_TELEMETRY_FAMILIES) {\n    registry.register({\n      family,\n      description: `LifeOps built-in telemetry family: ${family}`,\n      source: \"app-lifeops\",\n    });\n  }\n}\n\n/**\n * App-lifeops contributes the calendar / time-window namespaced families\n * (`meeting.ended`, `morning.start`, `lunch.start`, `night.start`).\n * plugin-health contributes its `health.*` families through its own\n * registration entry point.\n */\nexport const APP_LIFEOPS_BUS_FAMILIES: readonly BusFamilyContribution[] = [\n  {\n    family: \"calendar.meeting.ended\",\n    description:\n      \"Calendar event end-edge — emitted when a calendar meeting transitions from in-progress to completed.\",\n    source: \"app-lifeops\",\n    namespace: \"calendar\",\n  },\n  {\n    family: \"time.morning.start\",\n    description:\n      \"Local-time anchor: owner's configured morning window has just started.\",\n    source: \"app-lifeops\",\n    namespace: \"time\",\n  },\n  {\n    family: \"time.lunch.start\",\n    description:\n      \"Local-time anchor: owner's configured lunch window has just started.\",\n    source: \"app-lifeops\",\n    namespace: \"time\",\n  },\n  {\n    family: \"time.night.start\",\n    description:\n      \"Local-time anchor: owner's configured evening / wind-down window has just started.\",\n    source: \"app-lifeops\",\n    namespace: \"time\",\n  },\n];\n\nexport function registerAppLifeOpsBusFamilies(registry: FamilyRegistry): void {\n  for (const contribution of APP_LIFEOPS_BUS_FAMILIES) {\n    registry.register(contribution);\n  }\n}\n\n/**\n * Per-runtime registry registration. Mirrors `connectorRegistry` /\n * `channelRegistry` — `WeakMap` keyed by runtime so the lifetime tracks the\n * runtime and we don't leak across tests.\n */\nconst registries = new WeakMap<IAgentRuntime, FamilyRegistry>();\n\nexport function registerFamilyRegistry(\n  runtime: IAgentRuntime,\n  registry: FamilyRegistry,\n): void {\n  registries.set(runtime, registry);\n}\n\nexport function getFamilyRegistry(\n  runtime: IAgentRuntime,\n): FamilyRegistry | null {\n  return registries.get(runtime) ?? null;\n}\n\nexport function __resetFamilyRegistryForTests(runtime: IAgentRuntime): void {\n  registries.delete(runtime);\n}\n"],"mappings":"AAsBA;AAAA,EACE;AAAA,OAGK;AAmCP,MAAM,uBAAiD;AAAA,EACpC,WAAW,oBAAI,IAG9B;AAAA,EAEF,SAAS,cAA2C;AAClD,QAAI,CAAC,aAAa,QAAQ;AACxB,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AACA,QAAI,KAAK,SAAS,IAAI,aAAa,MAAM,GAAG;AAC1C,YAAM,IAAI;AAAA,QACR,oCAAoC,aAAa,MAAM;AAAA,MACzD;AAAA,IACF;AACA,SAAK,SAAS,IAAI,aAAa,QAAQ,YAAY;AAAA,EACrD;AAAA,EAEA,KAAK,QAGuB;AAC1B,UAAM,MAAM,MAAM,KAAK,KAAK,SAAS,OAAO,CAAC;AAC7C,QAAI,CAAC,OAAQ,QAAO;AACpB,WAAO,IAAI,OAAO,CAAC,MAAM;AACvB,UAAI,OAAO,aAAa,EAAE,cAAc,OAAO,UAAW,QAAO;AACjE,UAAI,OAAO,UAAU,EAAE,WAAW,OAAO,OAAQ,QAAO;AACxD,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,QAAwD;AAC1D,WAAO,KAAK,SAAS,IAAI,MAAM,KAAK;AAAA,EACtC;AAAA,EAEA,IAAI,QAAmC;AACrC,WAAO,KAAK,SAAS,IAAI,MAAM;AAAA,EACjC;AAAA,EAEA,UAAU,QAA4D;AACpE,WAAQ,2BAAiD,SAAS,MAAM;AAAA,EAC1E;AACF;AAEO,SAAS,uBAAuC;AACrD,SAAO,IAAI,uBAAuB;AACpC;AAOO,SAAS,iCACd,UACM;AACN,aAAW,UAAU,4BAA4B;AAC/C,aAAS,SAAS;AAAA,MAChB;AAAA,MACA,aAAa,sCAAsC,MAAM;AAAA,MACzD,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AACF;AAQO,MAAM,2BAA6D;AAAA,EACxE;AAAA,IACE,QAAQ;AAAA,IACR,aACE;AAAA,IACF,QAAQ;AAAA,IACR,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,QAAQ;AAAA,IACR,aACE;AAAA,IACF,QAAQ;AAAA,IACR,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,QAAQ;AAAA,IACR,aACE;AAAA,IACF,QAAQ;AAAA,IACR,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,QAAQ;AAAA,IACR,aACE;AAAA,IACF,QAAQ;AAAA,IACR,WAAW;AAAA,EACb;AACF;AAEO,SAAS,8BAA8B,UAAgC;AAC5E,aAAW,gBAAgB,0BAA0B;AACnD,aAAS,SAAS,YAAY;AAAA,EAChC;AACF;AAOA,MAAM,aAAa,oBAAI,QAAuC;AAEvD,SAAS,uBACd,SACA,UACM;AACN,aAAW,IAAI,SAAS,QAAQ;AAClC;AAEO,SAAS,kBACd,SACuB;AACvB,SAAO,WAAW,IAAI,OAAO,KAAK;AACpC;AAEO,SAAS,8BAA8B,SAA8B;AAC1E,aAAW,OAAO,OAAO;AAC3B;","names":[]}

package/dist/lifeops/registries/feature-flag-default-pack.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Default-pack of `FeatureFlagContribution`s for the closed
+ * `LifeOpsFeatureKey` built-ins.
+ *
+ * Source of truth for the built-in shape stays at `BASE_FEATURE_DEFAULTS`
+ * in `feature-flags.types.ts` (it carries the compile-time defaults that
+ * `resolveFeatureDefaults` uses for Cloud-aware policy). This pack mirrors
+ * those keys into the `FeatureFlagRegistry` so the registry is the single
+ * runtime source of truth for "what feature flags exist", while the closed
+ * union keeps its compile-time guarantees for typed callers like
+ * `requireFeatureEnabled(runtime, "travel.book_flight")`.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import { type LifeOpsFeatureKey } from "../feature-flags.types.js";
+import { type FeatureFlagContribution, type FeatureFlagRegistry } from "./feature-flag-registry.js";
+/**
+ * Set of compile-time built-in keys. Passed to the registry factory so
+ * `registry.isBuiltin(key)` answers without re-importing the closed union.
+ */
+export declare const LIFEOPS_BUILTIN_FEATURE_KEYS: ReadonlySet<LifeOpsFeatureKey>;
+/**
+ * Default contributions: one per `LifeOpsFeatureKey` built-in, mirroring
+ * the compile-time `BASE_FEATURE_DEFAULTS` baseline (Cloud-link policy is
+ * applied separately by `resolveFeatureDefaults`).
+ */
+export declare const DEFAULT_FEATURE_FLAG_PACK: readonly FeatureFlagContribution[];
+/**
+ * Create a registry, register every built-in `LifeOpsFeatureKey`, and bind
+ * it to the runtime. Plugin `init` calls this once during bootstrap.
+ */
+export declare function registerDefaultFeatureFlagPack(runtime: IAgentRuntime): FeatureFlagRegistry;
+//# sourceMappingURL=feature-flag-default-pack.d.ts.map

package/dist/lifeops/registries/feature-flag-default-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag-default-pack.d.ts","sourceRoot":"","sources":["../../../src/lifeops/registries/feature-flag-default-pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAEzB,MAAM,4BAA4B,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,iBAAiB,CAC1B,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,uBAAuB,EAWpE,CAAC;AAEL;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,aAAa,GACrB,mBAAmB,CASrB"}