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

package/dist/lifeops/signal-runtime-config.js

@@ -0,0 +1,44 @@
+function readSignalConfig(config) {
+  const raw = config.connectors?.signal;
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    return null;
+  }
+  return raw;
+}
+function upsertSignalConnectorConfig(config, args) {
+  const current = readSignalConfig(config);
+  const next = {
+    ...current ?? {},
+    authDir: args.authDir,
+    account: args.account,
+    enabled: true
+  };
+  const changed = !current || current.authDir !== next.authDir || current.account !== next.account || current.enabled !== true;
+  if (!changed) {
+    return false;
+  }
+  if (!config.connectors) {
+    config.connectors = {};
+  }
+  config.connectors.signal = next;
+  return true;
+}
+function removeSignalConnectorConfig(config, args = {}) {
+  const current = readSignalConfig(config);
+  if (!current) {
+    return false;
+  }
+  if (args.authDir && current.authDir && current.authDir !== args.authDir) {
+    return false;
+  }
+  if (args.account && current.account && current.account !== args.account) {
+    return false;
+  }
+  delete config.connectors?.signal;
+  return true;
+}
+export {
+  removeSignalConnectorConfig,
+  upsertSignalConnectorConfig
+};
+//# sourceMappingURL=signal-runtime-config.js.map

package/dist/lifeops/signal-runtime-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/signal-runtime-config.ts"],"sourcesContent":["type ConfigRecord = Record<string, unknown> & {\n  connectors?: Record<string, unknown>;\n};\n\ntype SignalConnectorConfig = Record<string, unknown> & {\n  authDir?: string;\n  account?: string;\n  enabled?: boolean;\n};\n\nfunction readSignalConfig(config: ConfigRecord): SignalConnectorConfig | null {\n  const raw = config.connectors?.signal;\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n    return null;\n  }\n  return raw as SignalConnectorConfig;\n}\n\nexport function upsertSignalConnectorConfig(\n  config: ConfigRecord,\n  args: {\n    authDir: string;\n    account: string;\n  },\n): boolean {\n  const current = readSignalConfig(config);\n  const next: SignalConnectorConfig = {\n    ...(current ?? {}),\n    authDir: args.authDir,\n    account: args.account,\n    enabled: true,\n  };\n\n  const changed =\n    !current ||\n    current.authDir !== next.authDir ||\n    current.account !== next.account ||\n    current.enabled !== true;\n\n  if (!changed) {\n    return false;\n  }\n\n  if (!config.connectors) {\n    config.connectors = {};\n  }\n  config.connectors.signal = next;\n  return true;\n}\n\nexport function removeSignalConnectorConfig(\n  config: ConfigRecord,\n  args: {\n    authDir?: string | null;\n    account?: string | null;\n  } = {},\n): boolean {\n  const current = readSignalConfig(config);\n  if (!current) {\n    return false;\n  }\n\n  if (args.authDir && current.authDir && current.authDir !== args.authDir) {\n    return false;\n  }\n\n  if (args.account && current.account && current.account !== args.account) {\n    return false;\n  }\n\n  delete config.connectors?.signal;\n  return true;\n}\n"],"mappings":"AAUA,SAAS,iBAAiB,QAAoD;AAC5E,QAAM,MAAM,OAAO,YAAY;AAC/B,MAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACzD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,SAAS,4BACd,QACA,MAIS;AACT,QAAM,UAAU,iBAAiB,MAAM;AACvC,QAAM,OAA8B;AAAA,IAClC,GAAI,WAAW,CAAC;AAAA,IAChB,SAAS,KAAK;AAAA,IACd,SAAS,KAAK;AAAA,IACd,SAAS;AAAA,EACX;AAEA,QAAM,UACJ,CAAC,WACD,QAAQ,YAAY,KAAK,WACzB,QAAQ,YAAY,KAAK,WACzB,QAAQ,YAAY;AAEtB,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,OAAO,YAAY;AACtB,WAAO,aAAa,CAAC;AAAA,EACvB;AACA,SAAO,WAAW,SAAS;AAC3B,SAAO;AACT;AAEO,SAAS,4BACd,QACA,OAGI,CAAC,GACI;AACT,QAAM,UAAU,iBAAiB,MAAM;AACvC,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,MAAI,KAAK,WAAW,QAAQ,WAAW,QAAQ,YAAY,KAAK,SAAS;AACvE,WAAO;AAAA,EACT;AAEA,MAAI,KAAK,WAAW,QAAQ,WAAW,QAAQ,YAAY,KAAK,SAAS;AACvE,WAAO;AAAA,EACT;AAEA,SAAO,OAAO,YAAY;AAC1B,SAAO;AACT;","names":[]}

package/dist/lifeops/signals/bus.d.ts

@@ -0,0 +1,78 @@
+/**
+ * ActivitySignalBus.
+ *
+ * Pub/sub fabric for `LifeOpsBusFamily` events. Producers (calendar
+ * watcher, plugin-health, time-window emitter, manual-override gateway)
+ * publish typed envelopes; consumers (the `ScheduledTaskRunner`'s
+ * `ActivitySignalBusView`, plugin-health's recap aggregator) subscribe by
+ * family and read recent events.
+ *
+ * The bus is intentionally narrow. It does NOT:
+ *   - Persist events (that is `LifeOpsRepository.insertTelemetryEvent`).
+ *   - Replay across restarts (subscribers re-attach on boot).
+ *   - Carry payload schemas (consult `FamilyRegistry` for that).
+ *
+ * It DOES:
+ *   - Validate the family against the registered `FamilyRegistry`.
+ *   - Buffer recent events per family (24h sliding window) so the read-side
+ *     `ActivitySignalBusView.hasSignalSince` works without a DB hit.
+ *   - Fan out synchronous subscribers (best-effort) so completion-checks see
+ *     events before the runner re-evaluates them.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { LifeOpsBusFamily, LifeOpsTelemetryFamily } from "@elizaos/shared";
+import type { FamilyRegistry } from "../registries/family-registry.js";
+import type { ActivitySignalBusView, ScheduledTaskSubject } from "@elizaos/plugin-scheduling";
+export interface ActivitySignalEnvelope {
+    family: LifeOpsBusFamily;
+    occurredAt: string;
+    /** Optional subject pointer (used by `hasSignalSince` subject filtering). */
+    subject?: ScheduledTaskSubject;
+    /**
+     * Producer-supplied payload. The bus does not interpret this; consumers
+     * that care consult the per-family schema in `FamilyRegistry`.
+     */
+    payload?: unknown;
+    /** Free-form metadata for diagnostics. */
+    metadata?: Record<string, unknown>;
+}
+export interface ActivitySignalBus extends ActivitySignalBusView {
+    /** Publish an event to the bus. Validates family membership. */
+    publish(envelope: ActivitySignalEnvelope): void;
+    /**
+     * Subscribe to events of a given family. Returns an unsubscribe fn.
+     * Subscribers run synchronously after `publish` and must not throw.
+     */
+    subscribe(family: LifeOpsBusFamily, handler: (envelope: ActivitySignalEnvelope) => void): () => void;
+    /**
+     * Read events that occurred since the given ISO instant. Optionally
+     * narrowed by family or subject.
+     */
+    recent(args: {
+        sinceIso: string;
+        family?: LifeOpsBusFamily;
+        subject?: ScheduledTaskSubject;
+    }): ActivitySignalEnvelope[];
+}
+export interface CreateActivitySignalBusOptions {
+    /**
+     * FamilyRegistry the bus consults to validate event families. When unset,
+     * the bus accepts any family (degraded mode used in unit tests).
+     */
+    familyRegistry?: FamilyRegistry;
+    /**
+     * Sliding-window retention. Older events are evicted on `publish`.
+     * Default: 24 hours.
+     */
+    retentionMs?: number;
+    /**
+     * Hard cap per family on the number of buffered events. Default: 256.
+     */
+    maxEventsPerFamily?: number;
+}
+export declare function createActivitySignalBus(options?: CreateActivitySignalBusOptions): ActivitySignalBus;
+export declare function registerActivitySignalBus(runtime: IAgentRuntime, bus: ActivitySignalBus): void;
+export declare function getActivitySignalBus(runtime: IAgentRuntime): ActivitySignalBus | null;
+export declare function __resetActivitySignalBusForTests(runtime: IAgentRuntime): void;
+export type { LifeOpsBusFamily, LifeOpsTelemetryFamily };
+//# sourceMappingURL=bus.d.ts.map

package/dist/lifeops/signals/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../../src/lifeops/signals/bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,gEAAgE;IAChE,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAChD;;;OAGG;IACH,SAAS,CACP,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,GAClD,MAAM,IAAI,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1B,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAChC,GAAG,sBAAsB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAoID,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,8BAAmC,GAC3C,iBAAiB,CAEnB;AAQD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,iBAAiB,GACrB,IAAI,CAEN;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,GACrB,iBAAiB,GAAG,IAAI,CAE1B;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE7E;AAMD,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/lifeops/signals/bus.js

@@ -0,0 +1,117 @@
+const DEFAULT_RETENTION_MS = 24 * 60 * 60 * 1e3;
+const DEFAULT_MAX_EVENTS_PER_FAMILY = 256;
+class InMemoryActivitySignalBus {
+  familyRegistry;
+  retentionMs;
+  maxEventsPerFamily;
+  buffers = /* @__PURE__ */ new Map();
+  subscribers = /* @__PURE__ */ new Map();
+  constructor(options) {
+    this.familyRegistry = options.familyRegistry ?? null;
+    this.retentionMs = options.retentionMs ?? DEFAULT_RETENTION_MS;
+    this.maxEventsPerFamily = options.maxEventsPerFamily ?? DEFAULT_MAX_EVENTS_PER_FAMILY;
+  }
+  publish(envelope) {
+    if (!envelope.family) {
+      throw new Error("ActivitySignalBus.publish: envelope.family required");
+    }
+    if (this.familyRegistry && !this.familyRegistry.has(envelope.family)) {
+      throw new Error(
+        `ActivitySignalBus.publish: family "${envelope.family}" is not registered in FamilyRegistry`
+      );
+    }
+    if (!envelope.occurredAt) {
+      throw new Error(
+        "ActivitySignalBus.publish: envelope.occurredAt required"
+      );
+    }
+    const buf = this.buffers.get(envelope.family) ?? [];
+    buf.push(envelope);
+    this.evictExpired(buf);
+    if (buf.length > this.maxEventsPerFamily) {
+      buf.splice(0, buf.length - this.maxEventsPerFamily);
+    }
+    this.buffers.set(envelope.family, buf);
+    const handlers = this.subscribers.get(envelope.family);
+    if (handlers) {
+      for (const handler of handlers) {
+        handler(envelope);
+      }
+    }
+  }
+  subscribe(family, handler) {
+    const set = this.subscribers.get(family) ?? /* @__PURE__ */ new Set();
+    set.add(handler);
+    this.subscribers.set(family, set);
+    return () => {
+      const live = this.subscribers.get(family);
+      if (!live) return;
+      live.delete(handler);
+      if (live.size === 0) this.subscribers.delete(family);
+    };
+  }
+  recent(args) {
+    const sinceMs = Date.parse(args.sinceIso);
+    if (!Number.isFinite(sinceMs)) {
+      throw new Error("ActivitySignalBus.recent: sinceIso must be ISO");
+    }
+    const buffers = args.family ? [this.buffers.get(args.family) ?? []] : Array.from(this.buffers.values());
+    const events = [];
+    for (const buf of buffers) {
+      for (const envelope of buf) {
+        if (Date.parse(envelope.occurredAt) < sinceMs) continue;
+        if (args.subject) {
+          if (envelope.subject?.kind !== args.subject.kind || envelope.subject.id !== args.subject.id) {
+            continue;
+          }
+        }
+        events.push(envelope);
+      }
+    }
+    return events.sort(
+      (a, b) => a.occurredAt < b.occurredAt ? -1 : a.occurredAt > b.occurredAt ? 1 : 0
+    );
+  }
+  /**
+   * Read-side adapter for `ActivitySignalBusView`. The runner uses this on
+   * every `completion-check` evaluation; the implementation is a buffer
+   * scan, not a DB query, so it stays fast.
+   */
+  hasSignalSince(args) {
+    const recent = this.recent({
+      sinceIso: args.sinceIso,
+      family: args.signalKind,
+      ...args.subject ? { subject: args.subject } : {}
+    });
+    return recent.length > 0;
+  }
+  evictExpired(buf) {
+    const cutoff = Date.now() - this.retentionMs;
+    while (buf.length > 0) {
+      const first = buf[0];
+      if (!first) break;
+      if (Date.parse(first.occurredAt) >= cutoff) break;
+      buf.shift();
+    }
+  }
+}
+function createActivitySignalBus(options = {}) {
+  return new InMemoryActivitySignalBus(options);
+}
+const buses = /* @__PURE__ */ new WeakMap();
+function registerActivitySignalBus(runtime, bus) {
+  buses.set(runtime, bus);
+}
+function getActivitySignalBus(runtime) {
+  return buses.get(runtime) ?? null;
+}
+function __resetActivitySignalBusForTests(runtime) {
+  buses.delete(runtime);
+}
+export {
+  __resetActivitySignalBusForTests,
+  createActivitySignalBus,
+  getActivitySignalBus,
+  registerActivitySignalBus
+};
+//# sourceMappingURL=bus.js.map

package/dist/lifeops/signals/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/signals/bus.ts"],"sourcesContent":["/**\n * ActivitySignalBus.\n *\n * Pub/sub fabric for `LifeOpsBusFamily` events. Producers (calendar\n * watcher, plugin-health, time-window emitter, manual-override gateway)\n * publish typed envelopes; consumers (the `ScheduledTaskRunner`'s\n * `ActivitySignalBusView`, plugin-health's recap aggregator) subscribe by\n * family and read recent events.\n *\n * The bus is intentionally narrow. It does NOT:\n *   - Persist events (that is `LifeOpsRepository.insertTelemetryEvent`).\n *   - Replay across restarts (subscribers re-attach on boot).\n *   - Carry payload schemas (consult `FamilyRegistry` for that).\n *\n * It DOES:\n *   - Validate the family against the registered `FamilyRegistry`.\n *   - Buffer recent events per family (24h sliding window) so the read-side\n *     `ActivitySignalBusView.hasSignalSince` works without a DB hit.\n *   - Fan out synchronous subscribers (best-effort) so completion-checks see\n *     events before the runner re-evaluates them.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport type { LifeOpsBusFamily, LifeOpsTelemetryFamily } from \"@elizaos/shared\";\nimport type { FamilyRegistry } from \"../registries/family-registry.js\";\nimport type {\n  ActivitySignalBusView,\n  ScheduledTaskSubject,\n} from \"@elizaos/plugin-scheduling\";\n\nexport interface ActivitySignalEnvelope {\n  family: LifeOpsBusFamily;\n  occurredAt: string;\n  /** Optional subject pointer (used by `hasSignalSince` subject filtering). */\n  subject?: ScheduledTaskSubject;\n  /**\n   * Producer-supplied payload. The bus does not interpret this; consumers\n   * that care consult the per-family schema in `FamilyRegistry`.\n   */\n  payload?: unknown;\n  /** Free-form metadata for diagnostics. */\n  metadata?: Record<string, unknown>;\n}\n\nexport interface ActivitySignalBus extends ActivitySignalBusView {\n  /** Publish an event to the bus. Validates family membership. */\n  publish(envelope: ActivitySignalEnvelope): void;\n  /**\n   * Subscribe to events of a given family. Returns an unsubscribe fn.\n   * Subscribers run synchronously after `publish` and must not throw.\n   */\n  subscribe(\n    family: LifeOpsBusFamily,\n    handler: (envelope: ActivitySignalEnvelope) => void,\n  ): () => void;\n  /**\n   * Read events that occurred since the given ISO instant. Optionally\n   * narrowed by family or subject.\n   */\n  recent(args: {\n    sinceIso: string;\n    family?: LifeOpsBusFamily;\n    subject?: ScheduledTaskSubject;\n  }): ActivitySignalEnvelope[];\n}\n\nexport interface CreateActivitySignalBusOptions {\n  /**\n   * FamilyRegistry the bus consults to validate event families. When unset,\n   * the bus accepts any family (degraded mode used in unit tests).\n   */\n  familyRegistry?: FamilyRegistry;\n  /**\n   * Sliding-window retention. Older events are evicted on `publish`.\n   * Default: 24 hours.\n   */\n  retentionMs?: number;\n  /**\n   * Hard cap per family on the number of buffered events. Default: 256.\n   */\n  maxEventsPerFamily?: number;\n}\n\nconst DEFAULT_RETENTION_MS = 24 * 60 * 60 * 1000;\nconst DEFAULT_MAX_EVENTS_PER_FAMILY = 256;\n\nclass InMemoryActivitySignalBus implements ActivitySignalBus {\n  private readonly familyRegistry: FamilyRegistry | null;\n  private readonly retentionMs: number;\n  private readonly maxEventsPerFamily: number;\n  private readonly buffers = new Map<\n    LifeOpsBusFamily,\n    ActivitySignalEnvelope[]\n  >();\n  private readonly subscribers = new Map<\n    LifeOpsBusFamily,\n    Set<(e: ActivitySignalEnvelope) => void>\n  >();\n\n  constructor(options: CreateActivitySignalBusOptions) {\n    this.familyRegistry = options.familyRegistry ?? null;\n    this.retentionMs = options.retentionMs ?? DEFAULT_RETENTION_MS;\n    this.maxEventsPerFamily =\n      options.maxEventsPerFamily ?? DEFAULT_MAX_EVENTS_PER_FAMILY;\n  }\n\n  publish(envelope: ActivitySignalEnvelope): void {\n    if (!envelope.family) {\n      throw new Error(\"ActivitySignalBus.publish: envelope.family required\");\n    }\n    if (this.familyRegistry && !this.familyRegistry.has(envelope.family)) {\n      throw new Error(\n        `ActivitySignalBus.publish: family \"${envelope.family}\" is not registered in FamilyRegistry`,\n      );\n    }\n    if (!envelope.occurredAt) {\n      throw new Error(\n        \"ActivitySignalBus.publish: envelope.occurredAt required\",\n      );\n    }\n\n    const buf = this.buffers.get(envelope.family) ?? [];\n    buf.push(envelope);\n    this.evictExpired(buf);\n    if (buf.length > this.maxEventsPerFamily) {\n      buf.splice(0, buf.length - this.maxEventsPerFamily);\n    }\n    this.buffers.set(envelope.family, buf);\n\n    const handlers = this.subscribers.get(envelope.family);\n    if (handlers) {\n      for (const handler of handlers) {\n        handler(envelope);\n      }\n    }\n  }\n\n  subscribe(\n    family: LifeOpsBusFamily,\n    handler: (envelope: ActivitySignalEnvelope) => void,\n  ): () => void {\n    const set = this.subscribers.get(family) ?? new Set();\n    set.add(handler);\n    this.subscribers.set(family, set);\n    return () => {\n      const live = this.subscribers.get(family);\n      if (!live) return;\n      live.delete(handler);\n      if (live.size === 0) this.subscribers.delete(family);\n    };\n  }\n\n  recent(args: {\n    sinceIso: string;\n    family?: LifeOpsBusFamily;\n    subject?: ScheduledTaskSubject;\n  }): ActivitySignalEnvelope[] {\n    const sinceMs = Date.parse(args.sinceIso);\n    if (!Number.isFinite(sinceMs)) {\n      throw new Error(\"ActivitySignalBus.recent: sinceIso must be ISO\");\n    }\n    const buffers = args.family\n      ? [this.buffers.get(args.family) ?? []]\n      : Array.from(this.buffers.values());\n    const events: ActivitySignalEnvelope[] = [];\n    for (const buf of buffers) {\n      for (const envelope of buf) {\n        if (Date.parse(envelope.occurredAt) < sinceMs) continue;\n        if (args.subject) {\n          if (\n            envelope.subject?.kind !== args.subject.kind ||\n            envelope.subject.id !== args.subject.id\n          ) {\n            continue;\n          }\n        }\n        events.push(envelope);\n      }\n    }\n    return events.sort((a, b) =>\n      a.occurredAt < b.occurredAt ? -1 : a.occurredAt > b.occurredAt ? 1 : 0,\n    );\n  }\n\n  /**\n   * Read-side adapter for `ActivitySignalBusView`. The runner uses this on\n   * every `completion-check` evaluation; the implementation is a buffer\n   * scan, not a DB query, so it stays fast.\n   */\n  hasSignalSince(args: {\n    signalKind: string;\n    sinceIso: string;\n    subject?: ScheduledTaskSubject;\n  }): boolean {\n    const recent = this.recent({\n      sinceIso: args.sinceIso,\n      family: args.signalKind,\n      ...(args.subject ? { subject: args.subject } : {}),\n    });\n    return recent.length > 0;\n  }\n\n  private evictExpired(buf: ActivitySignalEnvelope[]): void {\n    const cutoff = Date.now() - this.retentionMs;\n    while (buf.length > 0) {\n      const first = buf[0];\n      if (!first) break;\n      if (Date.parse(first.occurredAt) >= cutoff) break;\n      buf.shift();\n    }\n  }\n}\n\nexport function createActivitySignalBus(\n  options: CreateActivitySignalBusOptions = {},\n): ActivitySignalBus {\n  return new InMemoryActivitySignalBus(options);\n}\n\n// ---------------------------------------------------------------------------\n// Per-runtime binding\n// ---------------------------------------------------------------------------\n\nconst buses = new WeakMap<IAgentRuntime, ActivitySignalBus>();\n\nexport function registerActivitySignalBus(\n  runtime: IAgentRuntime,\n  bus: ActivitySignalBus,\n): void {\n  buses.set(runtime, bus);\n}\n\nexport function getActivitySignalBus(\n  runtime: IAgentRuntime,\n): ActivitySignalBus | null {\n  return buses.get(runtime) ?? null;\n}\n\nexport function __resetActivitySignalBusForTests(runtime: IAgentRuntime): void {\n  buses.delete(runtime);\n}\n\n// ---------------------------------------------------------------------------\n// Re-exports so callers import bus + family types from one place.\n// ---------------------------------------------------------------------------\n\nexport type { LifeOpsBusFamily, LifeOpsTelemetryFamily };\n"],"mappings":"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","names":[]}

package/dist/lifeops/sql.d.ts

@@ -0,0 +1,65 @@
+import type { IAgentRuntime } from "@elizaos/core";
+export type RawSqlQuery = {
+    queryChunks: Array<{
+        value?: unknown;
+    }>;
+};
+export type RuntimeDb = {
+    execute: (query: RawSqlQuery) => Promise<unknown>;
+};
+export declare function asObject(value: unknown): Record<string, unknown> | null;
+export declare function toText(value: unknown, fallback?: string): string;
+export declare function toNumber(value: unknown, fallback?: number): number;
+export declare function toBoolean(value: unknown, fallback?: boolean): boolean;
+export declare function parseJsonValue<T>(value: unknown, fallback: T): T;
+export declare function parseJsonRecord(value: unknown): Record<string, unknown>;
+export declare function parseJsonArray<T>(value: unknown): T[];
+export declare function extractRows(result: unknown): Array<Record<string, unknown>>;
+export declare function getRuntimeDb(runtime: IAgentRuntime): RuntimeDb;
+export declare function executeRawSql(runtime: IAgentRuntime, sqlText: string): Promise<Array<Record<string, unknown>>>;
+export type TransactionalDb = {
+    execute: (query: RawSqlQuery) => Promise<unknown>;
+};
+export declare class OptimisticLockError extends Error {
+    readonly code = "OPTIMISTIC_LOCK_ERROR";
+    readonly table: string;
+    readonly id: string;
+    readonly expectedVersion: number;
+    constructor(args: {
+        table: string;
+        id: string;
+        expectedVersion: number;
+    });
+}
+/**
+ * Run `fn` inside a database transaction. The handle passed to `fn` exposes
+ * the same `.execute(raw)` shape as the global runtime DB, but every call
+ * goes through the transaction. Throwing rolls back; returning commits.
+ *
+ * Drizzle's pg adapter supports `db.transaction(fn)` natively. If the adapter
+ * does not (e.g., a test fake), we fall back to running `fn` against the
+ * global DB and warn — atomicity is not guaranteed in that mode.
+ */
+export declare function withTransaction<T>(runtime: IAgentRuntime, fn: (tx: TransactionalDb) => Promise<T>): Promise<T>;
+/**
+ * Transactional analogue of `executeRawSql`. Pass the `tx` handed in by
+ * `withTransaction`'s callback — every statement participates in the same
+ * transaction and commits/rolls back together.
+ */
+export declare function executeRawSqlTx(tx: TransactionalDb, sqlText: string): Promise<Array<Record<string, unknown>>>;
+/**
+ * Retry policy for optimistic-lock conflicts. Default: 3 attempts with
+ * exponential backoff at 20ms / 50ms / 120ms. After 3 attempts the original
+ * `OptimisticLockError` is rethrown.
+ */
+export declare function withOptimisticRetry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+}): Promise<T>;
+export declare function sqlQuote(value: string): string;
+export declare function sqlText(value: string | null | undefined): string;
+export declare function sqlInteger(value: number | null | undefined): string;
+export declare function sqlNumber(value: number | null | undefined): string;
+export declare function sqlBoolean(value: boolean): string;
+export declare function sqlJson(value: unknown): string;
+//# sourceMappingURL=sql.d.ts.map

package/dist/lifeops/sql.d.ts.map

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

package/dist/lifeops/sql.js

@@ -0,0 +1,182 @@
+let cachedSqlRaw = null;
+function asObject(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value;
+}
+function toText(value, fallback = "") {
+  if (typeof value === "string") return value;
+  if (value === null || value === void 0) return fallback;
+  return String(value);
+}
+function toNumber(value, fallback = 0) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string") {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return fallback;
+}
+function toBoolean(value, fallback = false) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "number") return value !== 0;
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (["1", "true", "yes", "on"].includes(normalized)) return true;
+    if (["0", "false", "no", "off"].includes(normalized)) return false;
+  }
+  return fallback;
+}
+function isMissingJsonValue(value) {
+  return value === null || value === void 0 || value === "";
+}
+function parseJsonValue(value, fallback) {
+  if (isMissingJsonValue(value)) return fallback;
+  if (typeof value !== "string") {
+    if (typeof value === "object") return value;
+    throw new Error(
+      `[LifeOpsSql] Expected JSON string or object, received ${typeof value}`
+    );
+  }
+  try {
+    return JSON.parse(value);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`[LifeOpsSql] Invalid JSON value: ${message}`);
+  }
+}
+function parseJsonRecord(value) {
+  if (isMissingJsonValue(value)) return {};
+  const parsed = parseJsonValue(value, null);
+  const object = asObject(parsed);
+  if (object) return object;
+  throw new Error("[LifeOpsSql] Expected JSON object");
+}
+function parseJsonArray(value) {
+  if (isMissingJsonValue(value)) return [];
+  const parsed = parseJsonValue(value, null);
+  if (Array.isArray(parsed)) return parsed;
+  throw new Error("[LifeOpsSql] Expected JSON array");
+}
+function extractRows(result) {
+  if (Array.isArray(result)) {
+    return result.map((row) => asObject(row)).filter((row) => row !== null);
+  }
+  const object = asObject(result);
+  if (!object) return [];
+  const rows = object.rows;
+  if (!Array.isArray(rows)) return [];
+  return rows.map((row) => asObject(row)).filter((row) => row !== null);
+}
+async function getSqlRaw() {
+  if (cachedSqlRaw) return cachedSqlRaw;
+  const drizzle = await import("drizzle-orm");
+  cachedSqlRaw = drizzle.sql.raw;
+  return cachedSqlRaw;
+}
+function getRuntimeDb(runtime) {
+  const db = runtime.adapter.db;
+  if (!db || typeof db.execute !== "function") {
+    throw new Error("runtime database adapter unavailable");
+  }
+  return db;
+}
+async function executeRawSql(runtime, sqlText2) {
+  const raw = await getSqlRaw();
+  const db = getRuntimeDb(runtime);
+  const result = await db.execute(raw(sqlText2));
+  return extractRows(result);
+}
+class OptimisticLockError extends Error {
+  code = "OPTIMISTIC_LOCK_ERROR";
+  table;
+  id;
+  expectedVersion;
+  constructor(args) {
+    super(
+      `Optimistic lock conflict on ${args.table} id=${args.id} expectedVersion=${args.expectedVersion}`
+    );
+    this.table = args.table;
+    this.id = args.id;
+    this.expectedVersion = args.expectedVersion;
+  }
+}
+async function withTransaction(runtime, fn) {
+  const db = getRuntimeDb(runtime);
+  if (typeof db.transaction === "function") {
+    return await db.transaction(async (tx) => fn(tx));
+  }
+  return await fn({
+    execute: (query) => db.execute(query)
+  });
+}
+async function executeRawSqlTx(tx, sqlText2) {
+  const raw = await getSqlRaw();
+  const result = await tx.execute(raw(sqlText2));
+  return extractRows(result);
+}
+async function withOptimisticRetry(fn, options) {
+  const maxAttempts = Math.max(1, options?.maxAttempts ?? 3);
+  const baseDelay = Math.max(1, options?.baseDelayMs ?? 20);
+  let lastError;
+  for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+    try {
+      return await fn();
+    } catch (error) {
+      if (!(error instanceof OptimisticLockError)) {
+        throw error;
+      }
+      lastError = error;
+      if (attempt < maxAttempts - 1) {
+        const delay = baseDelay * 2 ** attempt + Math.floor(Math.random() * baseDelay);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+    }
+  }
+  throw lastError;
+}
+function sqlQuote(value) {
+  return `'${value.replace(/'/g, "''")}'`;
+}
+function sqlText(value) {
+  if (value === null || value === void 0) return "NULL";
+  return sqlQuote(value);
+}
+function sqlInteger(value) {
+  if (value === null || value === void 0) return "NULL";
+  if (!Number.isFinite(value)) throw new Error("invalid numeric SQL literal");
+  return String(Math.trunc(value));
+}
+function sqlNumber(value) {
+  if (value === null || value === void 0) return "NULL";
+  if (!Number.isFinite(value)) throw new Error("invalid numeric SQL literal");
+  return String(value);
+}
+function sqlBoolean(value) {
+  return value ? "TRUE" : "FALSE";
+}
+function sqlJson(value) {
+  return sqlQuote(JSON.stringify(value ?? null));
+}
+export {
+  OptimisticLockError,
+  asObject,
+  executeRawSql,
+  executeRawSqlTx,
+  extractRows,
+  getRuntimeDb,
+  parseJsonArray,
+  parseJsonRecord,
+  parseJsonValue,
+  sqlBoolean,
+  sqlInteger,
+  sqlJson,
+  sqlNumber,
+  sqlQuote,
+  sqlText,
+  toBoolean,
+  toNumber,
+  toText,
+  withOptimisticRetry,
+  withTransaction
+};
+//# sourceMappingURL=sql.js.map

package/dist/lifeops/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/sql.ts"],"sourcesContent":["import type { IAgentRuntime } from \"@elizaos/core\";\n\nexport type RawSqlQuery = {\n  queryChunks: Array<{ value?: unknown }>;\n};\n\nexport type RuntimeDb = {\n  execute: (query: RawSqlQuery) => Promise<unknown>;\n};\n\nlet cachedSqlRaw: ((query: string) => RawSqlQuery) | null = null;\n\nexport function asObject(value: unknown): Record<string, unknown> | null {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return null;\n  return value as Record<string, unknown>;\n}\n\nexport function toText(value: unknown, fallback = \"\"): string {\n  if (typeof value === \"string\") return value;\n  if (value === null || value === undefined) return fallback;\n  return String(value);\n}\n\nexport function toNumber(value: unknown, fallback = 0): number {\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (typeof value === \"string\") {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed)) return parsed;\n  }\n  return fallback;\n}\n\nexport function toBoolean(value: unknown, fallback = false): boolean {\n  if (typeof value === \"boolean\") return value;\n  if (typeof value === \"number\") return value !== 0;\n  if (typeof value === \"string\") {\n    const normalized = value.trim().toLowerCase();\n    if ([\"1\", \"true\", \"yes\", \"on\"].includes(normalized)) return true;\n    if ([\"0\", \"false\", \"no\", \"off\"].includes(normalized)) return false;\n  }\n  return fallback;\n}\n\nfunction isMissingJsonValue(value: unknown): boolean {\n  return value === null || value === undefined || value === \"\";\n}\n\nexport function parseJsonValue<T>(value: unknown, fallback: T): T {\n  if (isMissingJsonValue(value)) return fallback;\n  if (typeof value !== \"string\") {\n    if (typeof value === \"object\") return value as T;\n    throw new Error(\n      `[LifeOpsSql] Expected JSON string or object, received ${typeof value}`,\n    );\n  }\n  try {\n    return JSON.parse(value) as T;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    throw new Error(`[LifeOpsSql] Invalid JSON value: ${message}`);\n  }\n}\n\nexport function parseJsonRecord(value: unknown): Record<string, unknown> {\n  if (isMissingJsonValue(value)) return {};\n  const parsed = parseJsonValue<Record<string, unknown> | null>(value, null);\n  const object = asObject(parsed);\n  if (object) return object;\n  throw new Error(\"[LifeOpsSql] Expected JSON object\");\n}\n\nexport function parseJsonArray<T>(value: unknown): T[] {\n  if (isMissingJsonValue(value)) return [];\n  const parsed = parseJsonValue<T[] | null>(value, null);\n  if (Array.isArray(parsed)) return parsed;\n  throw new Error(\"[LifeOpsSql] Expected JSON array\");\n}\n\nexport function extractRows(result: unknown): Array<Record<string, unknown>> {\n  if (Array.isArray(result)) {\n    return result\n      .map((row) => asObject(row))\n      .filter((row): row is Record<string, unknown> => row !== null);\n  }\n  const object = asObject(result);\n  if (!object) return [];\n  const rows = object.rows;\n  if (!Array.isArray(rows)) return [];\n  return rows\n    .map((row) => asObject(row))\n    .filter((row): row is Record<string, unknown> => row !== null);\n}\n\nasync function getSqlRaw(): Promise<(query: string) => RawSqlQuery> {\n  if (cachedSqlRaw) return cachedSqlRaw;\n  const drizzle = (await import(\"drizzle-orm\")) as {\n    sql: { raw: (query: string) => RawSqlQuery };\n  };\n  cachedSqlRaw = drizzle.sql.raw;\n  return cachedSqlRaw;\n}\n\nexport function getRuntimeDb(runtime: IAgentRuntime): RuntimeDb {\n  const db = runtime.adapter.db as RuntimeDb | undefined;\n  if (!db || typeof db.execute !== \"function\") {\n    throw new Error(\"runtime database adapter unavailable\");\n  }\n  return db;\n}\n\nexport async function executeRawSql(\n  runtime: IAgentRuntime,\n  sqlText: string,\n): Promise<Array<Record<string, unknown>>> {\n  const raw = await getSqlRaw();\n  const db = getRuntimeDb(runtime);\n  const result = await db.execute(raw(sqlText));\n  return extractRows(result);\n}\n\n// ---------------------------------------------------------------------------\n// Transactions and optimistic concurrency\n//\n// Atomic multi-step operations (e.g., thread merge: update target + mark N\n// source threads stopped + append events) MUST run inside `withTransaction`.\n// Without it, a crash mid-loop leaves dangling state — half-merged threads,\n// scheduled tasks fired but not dispatched, etc.\n//\n// `withTransaction` opens a PostgreSQL transaction via the underlying drizzle\n// adapter and exposes a `TransactionalDb` handle with the same `.execute(raw)`\n// shape as the global runtime DB. Pass it into transaction-aware variants of\n// `executeRawSql`/repository methods (currently named `executeRawSqlTx`).\n//\n// `OptimisticLockError` is thrown when an UPDATE with a version check affects\n// 0 rows — caller catches once, re-reads fresh, retries (3x max, with\n// exponential backoff), then surfaces the conflict.\n// ---------------------------------------------------------------------------\n\nexport type TransactionalDb = {\n  execute: (query: RawSqlQuery) => Promise<unknown>;\n};\n\ntype DrizzleTransactionalDb = RuntimeDb & {\n  transaction?: <T>(fn: (tx: TransactionalDb) => Promise<T>) => Promise<T>;\n};\n\nexport class OptimisticLockError extends Error {\n  readonly code = \"OPTIMISTIC_LOCK_ERROR\";\n  readonly table: string;\n  readonly id: string;\n  readonly expectedVersion: number;\n  constructor(args: { table: string; id: string; expectedVersion: number }) {\n    super(\n      `Optimistic lock conflict on ${args.table} id=${args.id} expectedVersion=${args.expectedVersion}`,\n    );\n    this.table = args.table;\n    this.id = args.id;\n    this.expectedVersion = args.expectedVersion;\n  }\n}\n\n/**\n * Run `fn` inside a database transaction. The handle passed to `fn` exposes\n * the same `.execute(raw)` shape as the global runtime DB, but every call\n * goes through the transaction. Throwing rolls back; returning commits.\n *\n * Drizzle's pg adapter supports `db.transaction(fn)` natively. If the adapter\n * does not (e.g., a test fake), we fall back to running `fn` against the\n * global DB and warn — atomicity is not guaranteed in that mode.\n */\nexport async function withTransaction<T>(\n  runtime: IAgentRuntime,\n  fn: (tx: TransactionalDb) => Promise<T>,\n): Promise<T> {\n  const db = getRuntimeDb(runtime) as DrizzleTransactionalDb;\n  if (typeof db.transaction === \"function\") {\n    return await db.transaction(async (tx) => fn(tx));\n  }\n  // Adapter does not support transactions (likely a test fake). Run inline.\n  return await fn({\n    execute: (query) => db.execute(query),\n  });\n}\n\n/**\n * Transactional analogue of `executeRawSql`. Pass the `tx` handed in by\n * `withTransaction`'s callback — every statement participates in the same\n * transaction and commits/rolls back together.\n */\nexport async function executeRawSqlTx(\n  tx: TransactionalDb,\n  sqlText: string,\n): Promise<Array<Record<string, unknown>>> {\n  const raw = await getSqlRaw();\n  const result = await tx.execute(raw(sqlText));\n  return extractRows(result);\n}\n\n/**\n * Retry policy for optimistic-lock conflicts. Default: 3 attempts with\n * exponential backoff at 20ms / 50ms / 120ms. After 3 attempts the original\n * `OptimisticLockError` is rethrown.\n */\nexport async function withOptimisticRetry<T>(\n  fn: () => Promise<T>,\n  options?: { maxAttempts?: number; baseDelayMs?: number },\n): Promise<T> {\n  const maxAttempts = Math.max(1, options?.maxAttempts ?? 3);\n  const baseDelay = Math.max(1, options?.baseDelayMs ?? 20);\n  let lastError: unknown;\n  for (let attempt = 0; attempt < maxAttempts; attempt += 1) {\n    try {\n      return await fn();\n    } catch (error) {\n      if (!(error instanceof OptimisticLockError)) {\n        throw error;\n      }\n      lastError = error;\n      if (attempt < maxAttempts - 1) {\n        const delay =\n          baseDelay * 2 ** attempt + Math.floor(Math.random() * baseDelay);\n        await new Promise((resolve) => setTimeout(resolve, delay));\n      }\n    }\n  }\n  throw lastError;\n}\n\n// ---------------------------------------------------------------------------\n// SQL value encoders\n// ---------------------------------------------------------------------------\n\nexport function sqlQuote(value: string): string {\n  return `'${value.replace(/'/g, \"''\")}'`;\n}\n\nexport function sqlText(value: string | null | undefined): string {\n  if (value === null || value === undefined) return \"NULL\";\n  return sqlQuote(value);\n}\n\nexport function sqlInteger(value: number | null | undefined): string {\n  if (value === null || value === undefined) return \"NULL\";\n  if (!Number.isFinite(value)) throw new Error(\"invalid numeric SQL literal\");\n  return String(Math.trunc(value));\n}\n\nexport function sqlNumber(value: number | null | undefined): string {\n  if (value === null || value === undefined) return \"NULL\";\n  if (!Number.isFinite(value)) throw new Error(\"invalid numeric SQL literal\");\n  return String(value);\n}\n\nexport function sqlBoolean(value: boolean): string {\n  return value ? \"TRUE\" : \"FALSE\";\n}\n\nexport function sqlJson(value: unknown): string {\n  return sqlQuote(JSON.stringify(value ?? null));\n}\n"],"mappings":"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","names":["sqlText"]}

package/dist/lifeops/stretch-decider.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Pure decision helper for the stretch reminder dispatch loop.
+ *
+ * The runtime's reminder loop already handles channel selection, quiet
+ * hours, and activity gating. This helper layers in stretch-specific
+ * pacing rules so the dispatch site can ask one question — "should the
+ * stretch nudge fire right now?" — without re-deriving the same logic
+ * inline next to every other reminder type.
+ *
+ * The rules encoded here:
+ *   - Honor the configured cadence: don't fire twice inside the same
+ *     interval window. Default is 6 hours (matches `seed-routines.ts`).
+ *   - If the user went outside / took a walk after the last stretch,
+ *     reset the cooldown — the body movement covered what stretching
+ *     would have provided.
+ *   - Skip stretch nudges entirely on busy days. Stretch is soft
+ *     self-care; on packed days the user does not want a low-priority
+ *     ping competing with meeting traffic.
+ *   - Skip late-evening fires (>= 21:00 local) — by then the user is
+ *     winding down and another stretch ping is just noise.
+ *   - Skip weekends. Stretch nudges target sedentary work patterns;
+ *     weekends usually break that pattern naturally.
+ *
+ * This module deliberately takes plain primitives rather than the
+ * runtime's `LifeOpsAttentionContext` so the same logic can be unit
+ * tested without standing up the full reminder service.
+ */
+export interface ShouldStretchNowInput {
+    /** Current epoch milliseconds. */
+    nowMs: number;
+    /** Epoch ms of the last delivered stretch nudge, or null if never. */
+    lastStretchMs: number | null;
+    /**
+     * Epoch ms of the most recent "user went outside / took a walk"
+     * signal, or null if the activity profile cannot tell. When this is
+     * more recent than `lastStretchMs`, the stretch cooldown resets so we
+     * do not double-nudge a user who just got fresh body movement.
+     */
+    lastWalkOutMs: number | null;
+    /**
+     * Caller-computed busy-day verdict. Stretch is soft self-care and
+     * should never compete with calendar-busy or screen-busy days.
+     */
+    isBusyDay: boolean;
+    /** Local day-of-week, 0 (Sunday) through 6 (Saturday). */
+    dayOfWeek: number;
+    /** Local hour-of-day, 0–23. Used for the late-evening cutoff. */
+    hourOfDay: number;
+    /**
+     * Optional override of the inter-fire cooldown. Defaults to
+     * `DEFAULT_STRETCH_INTERVAL_MS` (6h) which matches the routine seed.
+     */
+    intervalMs?: number;
+}
+export interface ShouldStretchNowResult {
+    shouldFire: boolean;
+    reason: string;
+}
+export declare function shouldStretchNow(input: ShouldStretchNowInput): ShouldStretchNowResult;
+/**
+ * Natural-sounding stretch reminder copy variants. The dispatch site
+ * picks one deterministically (e.g. day-of-year mod count) so a given
+ * day always produces the same nudge — useful for tests and for not
+ * spamming the user with two visibly different copies in the same
+ * window if a backfill fires later.
+ */
+export declare const STRETCH_REMINDER_VARIANTS: readonly string[];
+export interface StretchReminderCopyInput {
+    /** Local day-of-year (1–366) used as the deterministic rotation key. */
+    dayOfYear: number;
+}
+export declare function pickStretchReminderCopy(input: StretchReminderCopyInput): string;
+//# sourceMappingURL=stretch-decider.d.ts.map

package/dist/lifeops/stretch-decider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stretch-decider.d.ts","sourceRoot":"","sources":["../../src/lifeops/stretch-decider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAOH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;;OAKG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,sBAAsB,CAsCxB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAMtD,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,wBAAwB,GAC9B,MAAM,CAYR"}