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

package/dist/lifeops/feature-flags.types.js

@@ -0,0 +1,129 @@
+const BASE_FEATURE_DEFAULTS = {
+  "travel.search_flight": {
+    enabled: true,
+    label: "Search flights",
+    description: "Search flight inventory through the configured travel provider (read-only). Required for itinerary planning.",
+    costsMoney: false
+  },
+  "travel.search_hotel": {
+    enabled: true,
+    label: "Search hotels",
+    description: "Search hotel inventory through the configured travel provider (read-only). Required for trip planning.",
+    costsMoney: false
+  },
+  "travel.book_flight": {
+    enabled: false,
+    label: "Book flights",
+    description: "Place real flight bookings through the configured travel provider. Each booking still requires explicit approval.",
+    costsMoney: true
+  },
+  "travel.book_hotel": {
+    enabled: false,
+    label: "Book hotels",
+    description: "Place real hotel bookings through the configured travel provider. Each booking still requires explicit approval.",
+    costsMoney: true
+  },
+  "notifications.push": {
+    enabled: false,
+    label: "Push notifications",
+    description: "Send push notifications via Ntfy. Requires NTFY_BASE_URL configuration.",
+    costsMoney: false
+  },
+  "cross_channel.escalate": {
+    enabled: false,
+    label: "Cross-channel escalation",
+    description: "Escalate unanswered messages across channels (e.g. Telegram \u2192 SMS \u2192 call).",
+    costsMoney: true
+  },
+  "browser.automation": {
+    enabled: false,
+    label: "Browser automation",
+    description: "Allow Eliza to drive the browser extension (form fills, navigation, clicks).",
+    costsMoney: false
+  },
+  "email.draft": {
+    enabled: true,
+    label: "Draft emails",
+    description: "Draft email replies in your inbox without sending them.",
+    costsMoney: false
+  },
+  "email.send": {
+    enabled: false,
+    label: "Send emails",
+    description: "Send drafted emails on your behalf (still gated by approval queue).",
+    costsMoney: false
+  },
+  "cloud.duffel": {
+    enabled: false,
+    label: "Cloud travel billing",
+    description: "Use Eliza Cloud's managed travel-provider billing instead of bringing your own provider API credentials.",
+    costsMoney: true
+  }
+};
+const CLOUD_LINKED_DEFAULT_ON = /* @__PURE__ */ new Set([
+  "travel.search_flight",
+  "travel.search_hotel",
+  "travel.book_flight",
+  "travel.book_hotel",
+  "cloud.duffel"
+]);
+function isCloudLinkedDefaultOnFeatureKey(key) {
+  return CLOUD_LINKED_DEFAULT_ON.has(key);
+}
+function resolveFeatureDefaults(args) {
+  if (!args.cloudLinked) {
+    return BASE_FEATURE_DEFAULTS;
+  }
+  const resolved = {
+    ...BASE_FEATURE_DEFAULTS
+  };
+  for (const key of CLOUD_LINKED_DEFAULT_ON) {
+    const base = BASE_FEATURE_DEFAULTS[key];
+    if (base.enabled) continue;
+    resolved[key] = { ...base, enabled: true };
+  }
+  return resolved;
+}
+const ALL_FEATURE_KEYS = Object.keys(
+  BASE_FEATURE_DEFAULTS
+);
+function isLifeOpsFeatureKey(value) {
+  return typeof value === "string" && value in BASE_FEATURE_DEFAULTS;
+}
+class FeatureNotEnabledError extends Error {
+  code = "FEATURE_NOT_ENABLED";
+  featureKey;
+  cloudOptIn;
+  cloudLinked;
+  constructor(featureKey, args) {
+    const builtinCostsMoney = isLifeOpsFeatureKey(featureKey) ? BASE_FEATURE_DEFAULTS[featureKey].costsMoney : null;
+    const cloudOptIn = builtinCostsMoney ?? args?.costsMoney ?? false;
+    const cloudLinked = args?.cloudLinked === true;
+    const text = args?.message ?? buildFeatureDisabledMessage(featureKey, { cloudOptIn, cloudLinked });
+    super(text);
+    this.name = "FeatureNotEnabledError";
+    this.featureKey = featureKey;
+    this.cloudOptIn = cloudOptIn;
+    this.cloudLinked = cloudLinked;
+  }
+}
+function buildFeatureDisabledMessage(featureKey, args) {
+  const base = `Feature '${featureKey}' is off.`;
+  if (!args.cloudOptIn) {
+    return `${base} Enable it via Settings \u2192 Features.`;
+  }
+  if (!args.cloudLinked) {
+    return `${base} The simplest path is to sign in to Eliza Cloud so managed travel billing turns on automatically. Or enable it locally via Settings \u2192 Features (requires your own travel-provider API credentials).`;
+  }
+  return `${base} Enable it via Settings \u2192 Features or sign up for the matching Eliza Cloud package.`;
+}
+export {
+  ALL_FEATURE_KEYS,
+  BASE_FEATURE_DEFAULTS,
+  CLOUD_LINKED_DEFAULT_ON,
+  FeatureNotEnabledError,
+  isCloudLinkedDefaultOnFeatureKey,
+  isLifeOpsFeatureKey,
+  resolveFeatureDefaults
+};
+//# sourceMappingURL=feature-flags.types.js.map

package/dist/lifeops/feature-flags.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/feature-flags.types.ts"],"sourcesContent":["/**\n * LifeOps feature opt-in framework — closed enums + typed envelope.\n *\n * Source of truth (Commandment 7):\n *  - The literal union `LifeOpsFeatureKey` enumerates every gateable\n *    capability.\n *  - `BASE_FEATURE_DEFAULTS` declares the compile-time baseline. The DB\n *    table only stores *overrides* — never used to discover new keys.\n *  - The actions/services that gate on these keys must throw\n *    `FeatureNotEnabledError` before they touch the network or spend\n *    money. Silent fallbacks are not allowed (Commandment 8).\n *\n * Source rules:\n *  - `default` — the row is absent in the DB; `enabled` reflects the\n *    resolved compile-time default for the current Cloud-link context.\n *    The runtime never *writes* a `default` row.\n *  - `local`   — toggled from the desktop UI / chat command.\n *  - `cloud`   — auto-provisioned by an Eliza Cloud package sync.\n *\n * Cloud rows are read-only from the local UI: a Cloud-managed enable\n * cannot be revoked locally, only by removing the Cloud package.\n *\n * Cloud-default policy:\n *  - When the user is signed into Eliza Cloud, travel features and the\n *    cloud-managed travel-billing flag flip ON by default. Cost is\n *    metered Cloud-side; the local code never recomputes that markup\n *    (Commandment 2).\n *  - Without Cloud, paid features stay OFF until the user opts in\n *    locally (which then requires them to bring their own travel-provider\n *    API credentials via `ELIZA_DUFFEL_DIRECT=1` + `DUFFEL_API_KEY`).\n */\n\nexport type LifeOpsFeatureKey =\n  | \"travel.search_flight\"\n  | \"travel.search_hotel\"\n  | \"travel.book_flight\"\n  | \"travel.book_hotel\"\n  | \"notifications.push\"\n  | \"cross_channel.escalate\"\n  | \"browser.automation\"\n  | \"email.draft\"\n  | \"email.send\"\n  | \"cloud.duffel\";\n\n/**\n * Open-key sibling of `LifeOpsFeatureKey`. The closed union remains the\n * compile-time authority for the built-in 10 flags (Cloud-default policy,\n * `BASE_FEATURE_DEFAULTS`, typed gate calls). The runtime\n * `FeatureFlagRegistry` is the source of truth for what flags exist —\n * including 3rd-party plugin contributions — so anywhere that ingests a\n * key from outside (chat input, REST routes, dev-registries view) uses\n * `LifeOpsFeatureFlagKey`. Parallel to\n * `LifeOpsBusFamily = LifeOpsTelemetryFamily | string`.\n */\nexport type LifeOpsFeatureFlagKey = LifeOpsFeatureKey | string;\n\nexport type FeatureFlagSource = \"default\" | \"local\" | \"cloud\";\n\nexport interface FeatureFlagDefault {\n  /** Compile-time baseline — applies until a row overrides it. May be\n   *  flipped by `resolveFeatureDefaults` based on Cloud-link state. */\n  readonly enabled: boolean;\n  /** Short user-facing label shown in settings and confirmations. */\n  readonly label: string;\n  /** One-line user-facing description shown in the settings UI. */\n  readonly description: string;\n  /**\n   * True when toggling the feature on commits the user to recurring spend\n   * or external billing (e.g. live flight booking, paid SMS). Surfaced in\n   * the UI so the user understands the implication.\n   */\n  readonly costsMoney: boolean;\n}\n\n/**\n * Compile-time baseline. Conservative — assumes no Cloud account.\n *\n * `resolveFeatureDefaults({cloudLinked})` is the only function callers\n * should use to read effective defaults. Direct reads of this constant\n * skip the Cloud-aware policy and will under-report enablement for\n * Cloud-linked users.\n */\nexport const BASE_FEATURE_DEFAULTS: Readonly<\n  Record<LifeOpsFeatureKey, FeatureFlagDefault>\n> = {\n  \"travel.search_flight\": {\n    enabled: true,\n    label: \"Search flights\",\n    description:\n      \"Search flight inventory through the configured travel provider (read-only). Required for itinerary planning.\",\n    costsMoney: false,\n  },\n  \"travel.search_hotel\": {\n    enabled: true,\n    label: \"Search hotels\",\n    description:\n      \"Search hotel inventory through the configured travel provider (read-only). Required for trip planning.\",\n    costsMoney: false,\n  },\n  \"travel.book_flight\": {\n    enabled: false,\n    label: \"Book flights\",\n    description:\n      \"Place real flight bookings through the configured travel provider. Each booking still requires explicit approval.\",\n    costsMoney: true,\n  },\n  \"travel.book_hotel\": {\n    enabled: false,\n    label: \"Book hotels\",\n    description:\n      \"Place real hotel bookings through the configured travel provider. Each booking still requires explicit approval.\",\n    costsMoney: true,\n  },\n  \"notifications.push\": {\n    enabled: false,\n    label: \"Push notifications\",\n    description:\n      \"Send push notifications via Ntfy. Requires NTFY_BASE_URL configuration.\",\n    costsMoney: false,\n  },\n  \"cross_channel.escalate\": {\n    enabled: false,\n    label: \"Cross-channel escalation\",\n    description:\n      \"Escalate unanswered messages across channels (e.g. Telegram → SMS → call).\",\n    costsMoney: true,\n  },\n  \"browser.automation\": {\n    enabled: false,\n    label: \"Browser automation\",\n    description:\n      \"Allow Eliza to drive the browser extension (form fills, navigation, clicks).\",\n    costsMoney: false,\n  },\n  \"email.draft\": {\n    enabled: true,\n    label: \"Draft emails\",\n    description: \"Draft email replies in your inbox without sending them.\",\n    costsMoney: false,\n  },\n  \"email.send\": {\n    enabled: false,\n    label: \"Send emails\",\n    description:\n      \"Send drafted emails on your behalf (still gated by approval queue).\",\n    costsMoney: false,\n  },\n  \"cloud.duffel\": {\n    enabled: false,\n    label: \"Cloud travel billing\",\n    description:\n      \"Use Eliza Cloud's managed travel-provider billing instead of bringing your own provider API credentials.\",\n    costsMoney: true,\n  },\n};\n\n/**\n * Feature keys that default to ON when the user is signed into Eliza\n * Cloud. Service fees are applied Cloud-side (Commandment 2/4 — no client\n * math), so flipping these on locally is purely a default-policy decision:\n * it does not change billing.\n */\nexport const CLOUD_LINKED_DEFAULT_ON: ReadonlySet<LifeOpsFeatureKey> = new Set([\n  \"travel.search_flight\",\n  \"travel.search_hotel\",\n  \"travel.book_flight\",\n  \"travel.book_hotel\",\n  \"cloud.duffel\",\n]);\n\nexport function isCloudLinkedDefaultOnFeatureKey(\n  key: LifeOpsFeatureKey,\n): boolean {\n  return CLOUD_LINKED_DEFAULT_ON.has(key);\n}\n\nexport interface ResolveFeatureDefaultsArgs {\n  readonly cloudLinked: boolean;\n}\n\n/**\n * Resolve effective compile-time defaults for the given Cloud-link state.\n *\n *  - `cloudLinked: true`  → travel + `cloud.duffel` ON, billed via\n *    Eliza Cloud's managed travel-provider billing.\n *  - `cloudLinked: false` → baseline (paid features OFF) until the user\n *    opts in locally and supplies their own travel-provider credentials.\n */\nexport function resolveFeatureDefaults(\n  args: ResolveFeatureDefaultsArgs,\n): Readonly<Record<LifeOpsFeatureKey, FeatureFlagDefault>> {\n  if (!args.cloudLinked) {\n    return BASE_FEATURE_DEFAULTS;\n  }\n  const resolved: Record<LifeOpsFeatureKey, FeatureFlagDefault> = {\n    ...BASE_FEATURE_DEFAULTS,\n  };\n  for (const key of CLOUD_LINKED_DEFAULT_ON) {\n    const base = BASE_FEATURE_DEFAULTS[key];\n    if (base.enabled) continue;\n    resolved[key] = { ...base, enabled: true };\n  }\n  return resolved;\n}\n\nexport const ALL_FEATURE_KEYS: ReadonlyArray<LifeOpsFeatureKey> = Object.keys(\n  BASE_FEATURE_DEFAULTS,\n) as LifeOpsFeatureKey[];\n\nexport function isLifeOpsFeatureKey(\n  value: unknown,\n): value is LifeOpsFeatureKey {\n  return typeof value === \"string\" && value in BASE_FEATURE_DEFAULTS;\n}\n\nexport interface FeatureFlagState {\n  readonly featureKey: LifeOpsFeatureFlagKey;\n  readonly enabled: boolean;\n  readonly source: FeatureFlagSource;\n  readonly enabledAt: Date | null;\n  readonly enabledBy: string | null;\n  readonly label: string;\n  readonly description: string;\n  readonly costsMoney: boolean;\n  readonly metadata: Readonly<Record<string, unknown>>;\n}\n\nexport interface LifeOpsFeatureFlagRowDto {\n  readonly featureKey: LifeOpsFeatureFlagKey;\n  readonly enabled: boolean;\n  readonly source: FeatureFlagSource;\n  readonly label: string;\n  readonly description: string;\n  readonly costsMoney: boolean;\n  readonly enabledAt: string | null;\n  readonly enabledBy: string | null;\n  readonly packageId: string | null;\n  readonly cloudDefaultOn: boolean;\n}\n\nexport interface LifeOpsFeatureFlagsResponse {\n  readonly features: ReadonlyArray<LifeOpsFeatureFlagRowDto>;\n}\n\nexport interface LifeOpsFeatureFlagsSyncResponse\n  extends LifeOpsFeatureFlagsResponse {\n  readonly synced: number;\n}\n\nexport interface LifeOpsFeatureToggleResponse {\n  readonly feature: LifeOpsFeatureFlagRowDto;\n}\n\nexport interface FeatureToggleRequest {\n  readonly featureKey: LifeOpsFeatureFlagKey;\n  readonly enabled: boolean;\n  readonly source: FeatureFlagSource;\n  readonly enabledBy: string | null;\n  readonly metadata?: Readonly<Record<string, unknown>>;\n}\n\nexport type FeatureFlagChangeListener = (state: FeatureFlagState) => void;\n\nexport interface FeatureFlagService {\n  isEnabled(key: LifeOpsFeatureFlagKey): Promise<boolean>;\n  get(key: LifeOpsFeatureFlagKey): Promise<FeatureFlagState>;\n  list(): Promise<ReadonlyArray<FeatureFlagState>>;\n  enable(\n    key: LifeOpsFeatureFlagKey,\n    source: FeatureFlagSource,\n    enabledBy: string | null,\n    metadata?: Readonly<Record<string, unknown>>,\n  ): Promise<FeatureFlagState>;\n  disable(\n    key: LifeOpsFeatureFlagKey,\n    source: FeatureFlagSource,\n    enabledBy: string | null,\n  ): Promise<FeatureFlagState>;\n  subscribeChanges(handler: FeatureFlagChangeListener): () => void;\n}\n\n/**\n * Thrown by gated actions before they perform any side effect when the\n * required feature key is disabled. Carries enough context for the LLM\n * planner to surface a useful \"enable this\" message back to the owner —\n * including a Cloud-aware suggestion when the user is not signed in.\n */\nexport class FeatureNotEnabledError extends Error {\n  readonly code = \"FEATURE_NOT_ENABLED\" as const;\n  readonly featureKey: LifeOpsFeatureFlagKey;\n  readonly cloudOptIn: boolean;\n  readonly cloudLinked: boolean;\n\n  constructor(\n    featureKey: LifeOpsFeatureFlagKey,\n    args?: { cloudLinked?: boolean; message?: string; costsMoney?: boolean },\n  ) {\n    // Built-in: pull `costsMoney` from `BASE_FEATURE_DEFAULTS`. Otherwise the\n    // caller supplies it from the registry contribution metadata so the\n    // Cloud opt-in suggestion stays accurate for 3rd-party flags.\n    const builtinCostsMoney = isLifeOpsFeatureKey(featureKey)\n      ? BASE_FEATURE_DEFAULTS[featureKey].costsMoney\n      : null;\n    const cloudOptIn = builtinCostsMoney ?? args?.costsMoney ?? false;\n    const cloudLinked = args?.cloudLinked === true;\n    const text =\n      args?.message ??\n      buildFeatureDisabledMessage(featureKey, { cloudOptIn, cloudLinked });\n    super(text);\n    this.name = \"FeatureNotEnabledError\";\n    this.featureKey = featureKey;\n    this.cloudOptIn = cloudOptIn;\n    this.cloudLinked = cloudLinked;\n  }\n}\n\nfunction buildFeatureDisabledMessage(\n  featureKey: LifeOpsFeatureFlagKey,\n  args: { cloudOptIn: boolean; cloudLinked: boolean },\n): string {\n  const base = `Feature '${featureKey}' is off.`;\n  if (!args.cloudOptIn) {\n    return `${base} Enable it via Settings → Features.`;\n  }\n  if (!args.cloudLinked) {\n    return `${base} The simplest path is to sign in to Eliza Cloud so managed travel billing turns on automatically. Or enable it locally via Settings → Features (requires your own travel-provider API credentials).`;\n  }\n  return `${base} Enable it via Settings → Features or sign up for the matching Eliza Cloud package.`;\n}\n"],"mappings":"AAkFO,MAAM,wBAET;AAAA,EACF,wBAAwB;AAAA,IACtB,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,EACd;AAAA,EACA,uBAAuB;AAAA,IACrB,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,EACd;AAAA,EACA,sBAAsB;AAAA,IACpB,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,EACd;AAAA,EACA,qBAAqB;AAAA,IACnB,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,EACd;AAAA,EACA,sBAAsB;AAAA,IACpB,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,EACd;AAAA,EACA,0BAA0B;AAAA,IACxB,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,EACd;AAAA,EACA,sBAAsB;AAAA,IACpB,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,EACd;AAAA,EACA,eAAe;AAAA,IACb,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aAAa;AAAA,IACb,YAAY;AAAA,EACd;AAAA,EACA,cAAc;AAAA,IACZ,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,EACd;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aACE;AAAA,IACF,YAAY;AAAA,EACd;AACF;AAQO,MAAM,0BAA0D,oBAAI,IAAI;AAAA,EAC7E;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,SAAS,iCACd,KACS;AACT,SAAO,wBAAwB,IAAI,GAAG;AACxC;AAcO,SAAS,uBACd,MACyD;AACzD,MAAI,CAAC,KAAK,aAAa;AACrB,WAAO;AAAA,EACT;AACA,QAAM,WAA0D;AAAA,IAC9D,GAAG;AAAA,EACL;AACA,aAAW,OAAO,yBAAyB;AACzC,UAAM,OAAO,sBAAsB,GAAG;AACtC,QAAI,KAAK,QAAS;AAClB,aAAS,GAAG,IAAI,EAAE,GAAG,MAAM,SAAS,KAAK;AAAA,EAC3C;AACA,SAAO;AACT;AAEO,MAAM,mBAAqD,OAAO;AAAA,EACvE;AACF;AAEO,SAAS,oBACd,OAC4B;AAC5B,SAAO,OAAO,UAAU,YAAY,SAAS;AAC/C;AA0EO,MAAM,+BAA+B,MAAM;AAAA,EACvC,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EAET,YACE,YACA,MACA;AAIA,UAAM,oBAAoB,oBAAoB,UAAU,IACpD,sBAAsB,UAAU,EAAE,aAClC;AACJ,UAAM,aAAa,qBAAqB,MAAM,cAAc;AAC5D,UAAM,cAAc,MAAM,gBAAgB;AAC1C,UAAM,OACJ,MAAM,WACN,4BAA4B,YAAY,EAAE,YAAY,YAAY,CAAC;AACrE,UAAM,IAAI;AACV,SAAK,OAAO;AACZ,SAAK,aAAa;AAClB,SAAK,aAAa;AAClB,SAAK,cAAc;AAAA,EACrB;AACF;AAEA,SAAS,4BACP,YACA,MACQ;AACR,QAAM,OAAO,YAAY,UAAU;AACnC,MAAI,CAAC,KAAK,YAAY;AACpB,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,MAAI,CAAC,KAAK,aAAa;AACrB,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO,GAAG,IAAI;AAChB;","names":[]}

package/dist/lifeops/first-run/defaults.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Defaults-path spec for first-run.
+ *
+ * **One question only:** "what time do you usually wake up?" The answer is
+ * parsed into an `OwnerFactWindow` (start = the wake time; end = wake + 5h)
+ * and persisted as `morningWindow` on `OwnerFactStore`. After that the
+ * defaults pack is materialized as a set of `ScheduledTask` records and
+ * scheduled through the `ScheduledTaskRunner`.
+ *
+ * Pack contents (all `respectsGlobalPause: true` so vacation mode pauses
+ * them; `source: "first_run"`):
+ *   - **gm reminder** — fires at the start of `morningWindow` daily; low
+ *     priority; no completion check.
+ *   - **gn reminder** — fires at 22:00 local daily; low priority.
+ *   - **daily check-in** — `kind: "checkin"`, `priority: "medium"`, fires
+ *     at 09:00 local; `completionCheck.kind = "user_replied_within"`.
+ *   - **morning brief opt-in watcher** — `kind: "watcher"` triggered on the
+ *     `wake.confirmed` anchor; `priority: "medium"`. The actual brief
+ *     assembler lives in the morning-brief default pack — this entry signals
+ *     "the user opted into a morning brief" so the morning brief pack does not
+ *     double-schedule.
+ *
+ * This module emits the spec; the action calls `ScheduledTaskRunner.schedule`
+ * for each entry. When the runner is not wired in (e.g. during integration
+ * tests), the action falls back to an in-memory recorder so the contract
+ * remains testable.
+ */
+import type { ScheduledTaskInput } from "../wave1-types.js";
+import type { OwnerFactWindow } from "./state.js";
+/**
+ * Parse free-text wake time into an HH:MM string. Accepts "6", "06:00",
+ * "6:30am", "5:45 am", "noon", etc. Returns null if no plausible parse.
+ */
+export declare function parseWakeTime(input: string): string | null;
+/**
+ * Derive a five-hour morning window from the wake time. End is clamped to
+ * 23:59 if the wake time is so late that +5h would wrap.
+ */
+export declare function deriveMorningWindow(wakeHHMM: string): OwnerFactWindow;
+export interface DefaultsPackContext {
+    morningWindow: OwnerFactWindow;
+    timezone: string;
+    agentId: string;
+    channel?: string;
+}
+/**
+ * Stable idempotency keys. Replay keeps existing tasks intact; the runner is
+ * expected to upsert by idempotencyKey if the same key is presented twice.
+ */
+export declare const DEFAULT_PACK_IDEMPOTENCY_KEYS: {
+    readonly gm: "lifeops:first-run:default:gm";
+    readonly gn: "lifeops:first-run:default:gn";
+    readonly checkin: "lifeops:first-run:default:checkin";
+    readonly morningBrief: "lifeops:first-run:default:morning-brief";
+};
+export declare function buildDefaultsPack(context: DefaultsPackContext): ScheduledTaskInput[];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/lifeops/first-run/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/lifeops/first-run/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoC1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAerE;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,eAAe,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;;;CAKhC,CAAC;AAWX,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,EAAE,CA8FtB"}

package/dist/lifeops/first-run/defaults.js

@@ -0,0 +1,159 @@
+const TIME_OF_DAY_PATTERN = /^([01]\d|2[0-3]):[0-5]\d$/;
+const HOUR_OF_DAY_PATTERN = /^(?:[01]?\d|2[0-3])$/;
+function parseWakeTime(input) {
+  if (typeof input !== "string") return null;
+  const raw = input.trim().toLowerCase();
+  if (!raw) return null;
+  if (raw === "noon" || raw === "midday") return "12:00";
+  if (raw === "midnight") return "00:00";
+  if (TIME_OF_DAY_PATTERN.test(raw)) {
+    return raw;
+  }
+  const match = raw.match(/^(\d{1,2})(?::(\d{2}))?\s*(am|pm|a\.m\.|p\.m\.)?$/u);
+  if (!match) return null;
+  let hours = Number.parseInt(match[1], 10);
+  const minutes = match[2] ? Number.parseInt(match[2], 10) : 0;
+  const meridiem = match[3]?.replace(/\./g, "");
+  if (!Number.isFinite(hours) || !Number.isFinite(minutes)) return null;
+  if (minutes < 0 || minutes >= 60) return null;
+  if (meridiem === "am" || meridiem === "pm") {
+    if (hours < 1 || hours > 12) return null;
+    if (meridiem === "am") {
+      hours = hours === 12 ? 0 : hours;
+    } else {
+      hours = hours === 12 ? 12 : hours + 12;
+    }
+  } else {
+    if (!HOUR_OF_DAY_PATTERN.test(String(hours))) return null;
+  }
+  return `${String(hours).padStart(2, "0")}:${String(minutes).padStart(2, "0")}`;
+}
+function deriveMorningWindow(wakeHHMM) {
+  if (!TIME_OF_DAY_PATTERN.test(wakeHHMM)) {
+    throw new Error(`[first-run defaults] invalid wake time: ${wakeHHMM}`);
+  }
+  const [hStr, mStr] = wakeHHMM.split(":");
+  const startHours = Number.parseInt(hStr, 10);
+  const startMinutes = Number.parseInt(mStr, 10);
+  const totalMinutes = startHours * 60 + startMinutes;
+  const endTotalMinutes = Math.min(totalMinutes + 5 * 60, 23 * 60 + 59);
+  const endHours = Math.floor(endTotalMinutes / 60);
+  const endMinutes = endTotalMinutes % 60;
+  return {
+    startLocal: wakeHHMM,
+    endLocal: `${String(endHours).padStart(2, "0")}:${String(endMinutes).padStart(2, "0")}`
+  };
+}
+const DEFAULT_PACK_IDEMPOTENCY_KEYS = {
+  gm: "lifeops:first-run:default:gm",
+  gn: "lifeops:first-run:default:gn",
+  checkin: "lifeops:first-run:default:checkin",
+  morningBrief: "lifeops:first-run:default:morning-brief"
+};
+function cronAtLocal(hhmm, tz) {
+  const [h, m] = hhmm.split(":").map((part) => Number.parseInt(part, 10));
+  return {
+    kind: "cron",
+    expression: `${m} ${h} * * *`,
+    tz
+  };
+}
+function buildDefaultsPack(context) {
+  const { morningWindow, timezone, agentId } = context;
+  const channel = context.channel ?? "in_app";
+  return [
+    {
+      kind: "reminder",
+      promptInstructions: "Wish the owner a warm good morning and surface anything pressing for the day.",
+      trigger: cronAtLocal(morningWindow.startLocal, timezone),
+      priority: "low",
+      respectsGlobalPause: true,
+      source: "first_run",
+      createdBy: agentId,
+      ownerVisible: true,
+      idempotencyKey: DEFAULT_PACK_IDEMPOTENCY_KEYS.gm,
+      output: { destination: "channel", target: channel },
+      contextRequest: {
+        includeOwnerFacts: ["preferredName", "morningWindow", "timezone"]
+      },
+      metadata: {
+        firstRunPack: "defaults",
+        slot: "gm"
+      }
+    },
+    {
+      kind: "reminder",
+      promptInstructions: "Wish the owner good night before they wind down.",
+      trigger: cronAtLocal("22:00", timezone),
+      priority: "low",
+      respectsGlobalPause: true,
+      source: "first_run",
+      createdBy: agentId,
+      ownerVisible: true,
+      idempotencyKey: DEFAULT_PACK_IDEMPOTENCY_KEYS.gn,
+      output: { destination: "channel", target: channel },
+      contextRequest: {
+        includeOwnerFacts: ["preferredName", "eveningWindow", "timezone"]
+      },
+      metadata: {
+        firstRunPack: "defaults",
+        slot: "gn"
+      }
+    },
+    {
+      kind: "checkin",
+      promptInstructions: "Run the daily check-in: ask the owner how they're feeling and what's on their plate today.",
+      trigger: cronAtLocal("09:00", timezone),
+      priority: "medium",
+      respectsGlobalPause: true,
+      source: "first_run",
+      createdBy: agentId,
+      ownerVisible: true,
+      idempotencyKey: DEFAULT_PACK_IDEMPOTENCY_KEYS.checkin,
+      completionCheck: {
+        kind: "user_replied_within",
+        params: { lookbackMinutes: 60 },
+        followupAfterMinutes: 30
+      },
+      output: { destination: "channel", target: channel },
+      contextRequest: {
+        includeOwnerFacts: ["preferredName", "morningWindow", "timezone"],
+        includeRecentTaskStates: { kind: "checkin", lookbackHours: 48 }
+      },
+      metadata: {
+        firstRunPack: "defaults",
+        slot: "checkin"
+      }
+    },
+    {
+      kind: "watcher",
+      promptInstructions: "Render the morning brief at the wake.confirmed anchor.",
+      trigger: {
+        kind: "relative_to_anchor",
+        anchorKey: "wake.confirmed",
+        offsetMinutes: 0
+      },
+      priority: "medium",
+      respectsGlobalPause: true,
+      source: "first_run",
+      createdBy: agentId,
+      ownerVisible: true,
+      idempotencyKey: DEFAULT_PACK_IDEMPOTENCY_KEYS.morningBrief,
+      output: { destination: "channel", target: channel },
+      contextRequest: {
+        includeOwnerFacts: ["preferredName", "morningWindow", "timezone"]
+      },
+      metadata: {
+        firstRunPack: "defaults",
+        slot: "morningBrief"
+      }
+    }
+  ];
+}
+export {
+  DEFAULT_PACK_IDEMPOTENCY_KEYS,
+  buildDefaultsPack,
+  deriveMorningWindow,
+  parseWakeTime
+};
+//# sourceMappingURL=defaults.js.map

package/dist/lifeops/first-run/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/first-run/defaults.ts"],"sourcesContent":["/**\n * Defaults-path spec for first-run.\n *\n * **One question only:** \"what time do you usually wake up?\" The answer is\n * parsed into an `OwnerFactWindow` (start = the wake time; end = wake + 5h)\n * and persisted as `morningWindow` on `OwnerFactStore`. After that the\n * defaults pack is materialized as a set of `ScheduledTask` records and\n * scheduled through the `ScheduledTaskRunner`.\n *\n * Pack contents (all `respectsGlobalPause: true` so vacation mode pauses\n * them; `source: \"first_run\"`):\n *   - **gm reminder** — fires at the start of `morningWindow` daily; low\n *     priority; no completion check.\n *   - **gn reminder** — fires at 22:00 local daily; low priority.\n *   - **daily check-in** — `kind: \"checkin\"`, `priority: \"medium\"`, fires\n *     at 09:00 local; `completionCheck.kind = \"user_replied_within\"`.\n *   - **morning brief opt-in watcher** — `kind: \"watcher\"` triggered on the\n *     `wake.confirmed` anchor; `priority: \"medium\"`. The actual brief\n *     assembler lives in the morning-brief default pack — this entry signals\n *     \"the user opted into a morning brief\" so the morning brief pack does not\n *     double-schedule.\n *\n * This module emits the spec; the action calls `ScheduledTaskRunner.schedule`\n * for each entry. When the runner is not wired in (e.g. during integration\n * tests), the action falls back to an in-memory recorder so the contract\n * remains testable.\n */\n\nimport type { ScheduledTaskTrigger } from \"../scheduled-task/index.js\";\nimport type { ScheduledTaskInput } from \"../wave1-types.js\";\nimport type { OwnerFactWindow } from \"./state.js\";\n\nconst TIME_OF_DAY_PATTERN = /^([01]\\d|2[0-3]):[0-5]\\d$/;\n\nconst HOUR_OF_DAY_PATTERN = /^(?:[01]?\\d|2[0-3])$/;\n\n/**\n * Parse free-text wake time into an HH:MM string. Accepts \"6\", \"06:00\",\n * \"6:30am\", \"5:45 am\", \"noon\", etc. Returns null if no plausible parse.\n */\nexport function parseWakeTime(input: string): string | null {\n  if (typeof input !== \"string\") return null;\n  const raw = input.trim().toLowerCase();\n  if (!raw) return null;\n\n  if (raw === \"noon\" || raw === \"midday\") return \"12:00\";\n  if (raw === \"midnight\") return \"00:00\";\n\n  // Already HH:MM 24h?\n  if (TIME_OF_DAY_PATTERN.test(raw)) {\n    return raw;\n  }\n\n  // Match `H[:MM][am|pm]` with optional whitespace.\n  const match = raw.match(/^(\\d{1,2})(?::(\\d{2}))?\\s*(am|pm|a\\.m\\.|p\\.m\\.)?$/u);\n  if (!match) return null;\n\n  let hours = Number.parseInt(match[1], 10);\n  const minutes = match[2] ? Number.parseInt(match[2], 10) : 0;\n  const meridiem = match[3]?.replace(/\\./g, \"\");\n\n  if (!Number.isFinite(hours) || !Number.isFinite(minutes)) return null;\n  if (minutes < 0 || minutes >= 60) return null;\n\n  if (meridiem === \"am\" || meridiem === \"pm\") {\n    if (hours < 1 || hours > 12) return null;\n    if (meridiem === \"am\") {\n      hours = hours === 12 ? 0 : hours;\n    } else {\n      hours = hours === 12 ? 12 : hours + 12;\n    }\n  } else {\n    if (!HOUR_OF_DAY_PATTERN.test(String(hours))) return null;\n  }\n\n  return `${String(hours).padStart(2, \"0\")}:${String(minutes).padStart(2, \"0\")}`;\n}\n\n/**\n * Derive a five-hour morning window from the wake time. End is clamped to\n * 23:59 if the wake time is so late that +5h would wrap.\n */\nexport function deriveMorningWindow(wakeHHMM: string): OwnerFactWindow {\n  if (!TIME_OF_DAY_PATTERN.test(wakeHHMM)) {\n    throw new Error(`[first-run defaults] invalid wake time: ${wakeHHMM}`);\n  }\n  const [hStr, mStr] = wakeHHMM.split(\":\");\n  const startHours = Number.parseInt(hStr, 10);\n  const startMinutes = Number.parseInt(mStr, 10);\n  const totalMinutes = startHours * 60 + startMinutes;\n  const endTotalMinutes = Math.min(totalMinutes + 5 * 60, 23 * 60 + 59);\n  const endHours = Math.floor(endTotalMinutes / 60);\n  const endMinutes = endTotalMinutes % 60;\n  return {\n    startLocal: wakeHHMM,\n    endLocal: `${String(endHours).padStart(2, \"0\")}:${String(endMinutes).padStart(2, \"0\")}`,\n  };\n}\n\nexport interface DefaultsPackContext {\n  morningWindow: OwnerFactWindow;\n  timezone: string;\n  agentId: string;\n  channel?: string;\n}\n\n/**\n * Stable idempotency keys. Replay keeps existing tasks intact; the runner is\n * expected to upsert by idempotencyKey if the same key is presented twice.\n */\nexport const DEFAULT_PACK_IDEMPOTENCY_KEYS = {\n  gm: \"lifeops:first-run:default:gm\",\n  gn: \"lifeops:first-run:default:gn\",\n  checkin: \"lifeops:first-run:default:checkin\",\n  morningBrief: \"lifeops:first-run:default:morning-brief\",\n} as const;\n\nfunction cronAtLocal(hhmm: string, tz: string): ScheduledTaskTrigger {\n  const [h, m] = hhmm.split(\":\").map((part) => Number.parseInt(part, 10));\n  return {\n    kind: \"cron\",\n    expression: `${m} ${h} * * *`,\n    tz,\n  };\n}\n\nexport function buildDefaultsPack(\n  context: DefaultsPackContext,\n): ScheduledTaskInput[] {\n  const { morningWindow, timezone, agentId } = context;\n  const channel = context.channel ?? \"in_app\";\n  return [\n    {\n      kind: \"reminder\",\n      promptInstructions:\n        \"Wish the owner a warm good morning and surface anything pressing for the day.\",\n      trigger: cronAtLocal(morningWindow.startLocal, timezone),\n      priority: \"low\",\n      respectsGlobalPause: true,\n      source: \"first_run\",\n      createdBy: agentId,\n      ownerVisible: true,\n      idempotencyKey: DEFAULT_PACK_IDEMPOTENCY_KEYS.gm,\n      output: { destination: \"channel\", target: channel },\n      contextRequest: {\n        includeOwnerFacts: [\"preferredName\", \"morningWindow\", \"timezone\"],\n      },\n      metadata: {\n        firstRunPack: \"defaults\",\n        slot: \"gm\",\n      },\n    },\n    {\n      kind: \"reminder\",\n      promptInstructions: \"Wish the owner good night before they wind down.\",\n      trigger: cronAtLocal(\"22:00\", timezone),\n      priority: \"low\",\n      respectsGlobalPause: true,\n      source: \"first_run\",\n      createdBy: agentId,\n      ownerVisible: true,\n      idempotencyKey: DEFAULT_PACK_IDEMPOTENCY_KEYS.gn,\n      output: { destination: \"channel\", target: channel },\n      contextRequest: {\n        includeOwnerFacts: [\"preferredName\", \"eveningWindow\", \"timezone\"],\n      },\n      metadata: {\n        firstRunPack: \"defaults\",\n        slot: \"gn\",\n      },\n    },\n    {\n      kind: \"checkin\",\n      promptInstructions:\n        \"Run the daily check-in: ask the owner how they're feeling and what's on their plate today.\",\n      trigger: cronAtLocal(\"09:00\", timezone),\n      priority: \"medium\",\n      respectsGlobalPause: true,\n      source: \"first_run\",\n      createdBy: agentId,\n      ownerVisible: true,\n      idempotencyKey: DEFAULT_PACK_IDEMPOTENCY_KEYS.checkin,\n      completionCheck: {\n        kind: \"user_replied_within\",\n        params: { lookbackMinutes: 60 },\n        followupAfterMinutes: 30,\n      },\n      output: { destination: \"channel\", target: channel },\n      contextRequest: {\n        includeOwnerFacts: [\"preferredName\", \"morningWindow\", \"timezone\"],\n        includeRecentTaskStates: { kind: \"checkin\", lookbackHours: 48 },\n      },\n      metadata: {\n        firstRunPack: \"defaults\",\n        slot: \"checkin\",\n      },\n    },\n    {\n      kind: \"watcher\",\n      promptInstructions:\n        \"Render the morning brief at the wake.confirmed anchor.\",\n      trigger: {\n        kind: \"relative_to_anchor\",\n        anchorKey: \"wake.confirmed\",\n        offsetMinutes: 0,\n      },\n      priority: \"medium\",\n      respectsGlobalPause: true,\n      source: \"first_run\",\n      createdBy: agentId,\n      ownerVisible: true,\n      idempotencyKey: DEFAULT_PACK_IDEMPOTENCY_KEYS.morningBrief,\n      output: { destination: \"channel\", target: channel },\n      contextRequest: {\n        includeOwnerFacts: [\"preferredName\", \"morningWindow\", \"timezone\"],\n      },\n      metadata: {\n        firstRunPack: \"defaults\",\n        slot: \"morningBrief\",\n      },\n    },\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/lifeops/first-run/questions.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Customize-path question set for first-run.
+ *
+ * Five questions: Q1/Q2/Q4 always asked; Q3/Q5 conditional. Partial answers
+ * are persisted Q-by-Q via `FirstRunStateStore.recordAnswer` so a user can
+ * abandon mid-flow and resume without losing progress.
+ *
+ * Channel-validation for Q4: the chosen channel must be registered AND have
+ * a connected dispatcher. If neither is the case the answer is recorded with
+ * `fallbackToInApp: true` and a warning surfaces back through the action
+ * result. The `ChannelRegistry` is the eventual checker; the local inspector
+ * below leans on `getDefaultTriageService` adapter registration as a
+ * connectivity proxy.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { OwnerFactWindow } from "./state.js";
+export type FirstRunQuestionId = "preferredName" | "timezoneAndWindows" | "categories" | "channel" | "relationships";
+export interface FirstRunQuestionDefinition {
+    id: FirstRunQuestionId;
+    prompt: string;
+    /** Whether the question should be asked given the current answers. */
+    shouldAsk(answers: Record<string, unknown>): boolean;
+}
+/**
+ * Canonical question text. The action's prompt-rendering layer (planner) is
+ * responsible for actually asking the user; these strings are the contract
+ * the planner reads from.
+ */
+export declare const FIRST_RUN_QUESTIONS: readonly FirstRunQuestionDefinition[];
+export type CustomizeCategory = "sleep tracking" | "reminder packs" | "inbox triage" | "blockers/focus" | "follow-ups";
+export declare const CUSTOMIZE_CATEGORIES: readonly CustomizeCategory[];
+export interface RelationshipAnswerEntry {
+    name: string;
+    cadenceDays: number;
+}
+export interface CustomizeAnswers {
+    preferredName: string;
+    timezone: string;
+    morningWindow: OwnerFactWindow;
+    eveningWindow: OwnerFactWindow;
+    categories: CustomizeCategory[];
+    channel: string;
+    channelFallbackToInApp: boolean;
+    channelWarning?: string;
+    relationships?: RelationshipAnswerEntry[];
+}
+export declare const DEFAULT_MORNING_WINDOW: OwnerFactWindow;
+export declare const DEFAULT_EVENING_WINDOW: OwnerFactWindow;
+export declare const SUPPORTED_NOTIFICATION_CHANNELS: readonly ["in_app", "push", "imessage", "discord", "telegram"];
+export type SupportedNotificationChannel = (typeof SUPPORTED_NOTIFICATION_CHANNELS)[number];
+export declare function nextUnansweredQuestion(answers: Record<string, unknown>): FirstRunQuestionDefinition | null;
+export declare function parsePreferredName(value: unknown): string | null;
+export declare function parseTimeWindow(value: unknown): OwnerFactWindow | null;
+export declare function parseTimezone(value: unknown): string | null;
+export declare function parseCategories(value: unknown): CustomizeCategory[] | null;
+export declare function parseRelationships(value: unknown): RelationshipAnswerEntry[] | null;
+export interface ChannelValidationResult {
+    channel: string;
+    registered: boolean;
+    connected: boolean;
+    fallbackToInApp: boolean;
+    warning?: string;
+}
+/**
+ * Inspector contract — pluggable so the `ChannelRegistry` can replace the
+ * default implementation without touching this module.
+ */
+export interface ChannelInspector {
+    isRegistered(channel: string): boolean;
+    isConnected(channel: string): boolean;
+}
+export declare function setChannelInspector(inspector: ChannelInspector | null): void;
+export declare function validateChannel(rawChannel: unknown, _runtime: IAgentRuntime): ChannelValidationResult;
+//# sourceMappingURL=questions.d.ts.map

package/dist/lifeops/first-run/questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../../src/lifeops/first-run/questions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,oBAAoB,GACpB,YAAY,GACZ,SAAS,GACT,eAAe,CAAC;AAEpB,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,kBAAkB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CACtD;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,0BAA0B,EAoC3D,CAAC;AAEX,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,YAAY,CAAC;AAEjB,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAM5D,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,eAAe,CAAC;IAC/B,aAAa,EAAE,eAAe,CAAC;IAC/B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,EAAE,OAAO,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,uBAAuB,EAAE,CAAC;CAC3C;AAED,eAAO,MAAM,sBAAsB,EAAE,eAGpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAGpC,CAAC;AAEF,eAAO,MAAM,+BAA+B,gEAMlC,CAAC;AAEX,MAAM,MAAM,4BAA4B,GACtC,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,0BAA0B,GAAG,IAAI,CAMnC;AAMD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKhE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAatE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ3D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,EAAE,GAAG,IAAI,CAY1E;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,GACb,uBAAuB,EAAE,GAAG,IAAI,CAgBlC;AAID,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC;AAqBD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAE5E;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,OAAO,EACnB,QAAQ,EAAE,aAAa,GACtB,uBAAuB,CAsCzB"}