@mnemoai/core 1.1.0 → 1.1.1

package/dist/src/access-tracker.js

@@ -0,0 +1,184 @@
+const MIN_ACCESS_COUNT = 0;
+const MAX_ACCESS_COUNT = 1e4;
+const ACCESS_DECAY_HALF_LIFE_DAYS = 30;
+function clampAccessCount(value) {
+  if (!Number.isFinite(value)) return MIN_ACCESS_COUNT;
+  return Math.min(
+    MAX_ACCESS_COUNT,
+    Math.max(MIN_ACCESS_COUNT, Math.floor(value))
+  );
+}
+function parseAccessMetadata(metadata) {
+  if (metadata === void 0 || metadata === "") {
+    return { accessCount: 0, lastAccessedAt: 0 };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(metadata);
+  } catch {
+    return { accessCount: 0, lastAccessedAt: 0 };
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    return { accessCount: 0, lastAccessedAt: 0 };
+  }
+  const obj = parsed;
+  const rawCountAny = obj.accessCount ?? obj.access_count;
+  const rawCount = typeof rawCountAny === "number" ? rawCountAny : Number(rawCountAny ?? 0);
+  const rawLastAny = obj.lastAccessedAt ?? obj.last_accessed_at;
+  const rawLastAccessed = typeof rawLastAny === "number" ? rawLastAny : Number(rawLastAny ?? 0);
+  return {
+    accessCount: clampAccessCount(rawCount),
+    lastAccessedAt: Number.isFinite(rawLastAccessed) && rawLastAccessed >= 0 ? rawLastAccessed : 0
+  };
+}
+function buildUpdatedMetadata(existingMetadata, accessDelta) {
+  let existing = {};
+  if (existingMetadata !== void 0 && existingMetadata !== "") {
+    try {
+      const parsed = JSON.parse(existingMetadata);
+      if (typeof parsed === "object" && parsed !== null) {
+        existing = { ...parsed };
+      }
+    } catch {
+    }
+  }
+  const prev = parseAccessMetadata(existingMetadata);
+  const newCount = clampAccessCount(prev.accessCount + accessDelta);
+  const now = Date.now();
+  return JSON.stringify({
+    ...existing,
+    // Write both camelCase and snake_case for compatibility.
+    accessCount: newCount,
+    lastAccessedAt: now,
+    access_count: newCount,
+    last_accessed_at: now
+  });
+}
+function computeEffectiveHalfLife(baseHalfLife, accessCount, lastAccessedAt, reinforcementFactor, maxMultiplier) {
+  if (reinforcementFactor === 0 || accessCount <= 0) {
+    return baseHalfLife;
+  }
+  const now = Date.now();
+  const daysSinceLastAccess = Math.max(
+    0,
+    (now - lastAccessedAt) / (1e3 * 60 * 60 * 24)
+  );
+  const accessFreshness = Math.exp(
+    -daysSinceLastAccess * (Math.LN2 / ACCESS_DECAY_HALF_LIFE_DAYS)
+  );
+  const effectiveAccessCount = accessCount * accessFreshness;
+  const extension = baseHalfLife * reinforcementFactor * Math.log1p(effectiveAccessCount);
+  const result = baseHalfLife + extension;
+  const cap = baseHalfLife * maxMultiplier;
+  return Math.min(result, cap);
+}
+class AccessTracker {
+  pending = /* @__PURE__ */ new Map();
+  debounceTimer = null;
+  flushPromise = null;
+  debounceMs;
+  store;
+  logger;
+  constructor(options) {
+    this.store = options.store;
+    this.logger = options.logger;
+    this.debounceMs = options.debounceMs ?? 5e3;
+  }
+  /**
+   * Record one access for each of the given memory IDs.
+   * Synchronous — only updates the in-memory pending map.
+   */
+  recordAccess(ids) {
+    for (const id of ids) {
+      const current = this.pending.get(id) ?? 0;
+      this.pending.set(id, current + 1);
+    }
+    this.resetTimer();
+  }
+  /**
+   * Return a snapshot of all pending (id -> delta) entries.
+   */
+  getPendingUpdates() {
+    return new Map(this.pending);
+  }
+  /**
+   * Flush pending access deltas to the store.
+   *
+   * If a flush is already in progress, awaits the current flush to complete.
+   * If new pending data accumulated during the in-flight flush, a follow-up
+   * flush is automatically triggered.
+   */
+  async flush() {
+    this.clearTimer();
+    if (this.flushPromise) {
+      await this.flushPromise;
+      if (this.pending.size > 0) {
+        return this.flush();
+      }
+      return;
+    }
+    if (this.pending.size === 0) return;
+    this.flushPromise = this.doFlush();
+    try {
+      await this.flushPromise;
+    } finally {
+      this.flushPromise = null;
+    }
+    if (this.pending.size > 0) {
+      this.resetTimer();
+    }
+  }
+  /**
+   * Tear down the tracker — cancel timers and clear pending state.
+   */
+  destroy() {
+    this.clearTimer();
+    if (this.pending.size > 0) {
+      this.logger.warn(
+        `access-tracker: destroying with ${this.pending.size} pending writes`
+      );
+    }
+    this.pending.clear();
+  }
+  // --------------------------------------------------------------------------
+  // Internal helpers
+  // --------------------------------------------------------------------------
+  async doFlush() {
+    const batch = new Map(this.pending);
+    this.pending.clear();
+    for (const [id, delta] of batch) {
+      try {
+        const current = await this.store.getById(id);
+        if (!current) continue;
+        const updatedMeta = buildUpdatedMetadata(current.metadata, delta);
+        await this.store.update(id, { metadata: updatedMeta });
+      } catch (err) {
+        const existing = this.pending.get(id) ?? 0;
+        this.pending.set(id, existing + delta);
+        this.logger.warn(
+          `access-tracker: write-back failed for ${id.slice(0, 8)}:`,
+          err
+        );
+      }
+    }
+  }
+  resetTimer() {
+    this.clearTimer();
+    this.debounceTimer = setTimeout(() => {
+      void this.flush();
+    }, this.debounceMs);
+  }
+  clearTimer() {
+    if (this.debounceTimer !== null) {
+      clearTimeout(this.debounceTimer);
+      this.debounceTimer = null;
+    }
+  }
+}
+export {
+  AccessTracker,
+  buildUpdatedMetadata,
+  computeEffectiveHalfLife,
+  parseAccessMetadata
+};
+//# sourceMappingURL=access-tracker.js.map

package/dist/src/access-tracker.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/access-tracker.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\n/**\n * Access Tracker\n *\n * Tracks memory access patterns to support reinforcement-based decay.\n * Frequently accessed memories decay more slowly (longer effective half-life).\n *\n * Key exports:\n * - parseAccessMetadata   \u2014 extract accessCount/lastAccessedAt from metadata JSON\n * - buildUpdatedMetadata  \u2014 merge access fields into existing metadata JSON\n * - computeEffectiveHalfLife \u2014 compute reinforced half-life from access history\n * - AccessTracker         \u2014 debounced write-back tracker for batch metadata updates\n */\n\nimport type { MemoryStore } from \"./store.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface AccessMetadata {\n  readonly accessCount: number;\n  readonly lastAccessedAt: number;\n}\n\nexport interface AccessTrackerOptions {\n  readonly store: MemoryStore;\n  readonly logger: {\n    warn: (...args: unknown[]) => void;\n    info?: (...args: unknown[]) => void;\n  };\n  readonly debounceMs?: number;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst MIN_ACCESS_COUNT = 0;\nconst MAX_ACCESS_COUNT = 10_000;\n\n/** Access count itself decays with a 30-day half-life */\nconst ACCESS_DECAY_HALF_LIFE_DAYS = 30;\n\n// ============================================================================\n// Utility\n// ============================================================================\n\nfunction clampAccessCount(value: number): number {\n  if (!Number.isFinite(value)) return MIN_ACCESS_COUNT;\n  return Math.min(\n    MAX_ACCESS_COUNT,\n    Math.max(MIN_ACCESS_COUNT, Math.floor(value)),\n  );\n}\n\n// ============================================================================\n// Metadata Parsing\n// ============================================================================\n\n/**\n * Parse access-related fields from a metadata JSON string.\n *\n * Handles: undefined, empty string, malformed JSON, negative numbers,\n * numbers exceeding 10000. Always returns a valid AccessMetadata.\n */\nexport function parseAccessMetadata(\n  metadata: string | undefined,\n): AccessMetadata {\n  if (metadata === undefined || metadata === \"\") {\n    return { accessCount: 0, lastAccessedAt: 0 };\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(metadata);\n  } catch {\n    return { accessCount: 0, lastAccessedAt: 0 };\n  }\n\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return { accessCount: 0, lastAccessedAt: 0 };\n  }\n\n  const obj = parsed as Record<string, unknown>;\n\n  // Support both camelCase and snake_case keys (beta smart-memory uses snake_case).\n  const rawCountAny = obj.accessCount ?? obj.access_count;\n  const rawCount =\n    typeof rawCountAny === \"number\" ? rawCountAny : Number(rawCountAny ?? 0);\n\n  const rawLastAny = obj.lastAccessedAt ?? obj.last_accessed_at;\n  const rawLastAccessed =\n    typeof rawLastAny === \"number\" ? rawLastAny : Number(rawLastAny ?? 0);\n\n  return {\n    accessCount: clampAccessCount(rawCount),\n    lastAccessedAt:\n      Number.isFinite(rawLastAccessed) && rawLastAccessed >= 0\n        ? rawLastAccessed\n        : 0,\n  };\n}\n\n// ============================================================================\n// Metadata Building\n// ============================================================================\n\n/**\n * Merge an access-count increment into existing metadata JSON.\n *\n * Preserves ALL existing fields in the metadata object \u2014 only overwrites\n * `accessCount` and `lastAccessedAt`. Returns a new JSON string.\n */\nexport function buildUpdatedMetadata(\n  existingMetadata: string | undefined,\n  accessDelta: number,\n): string {\n  let existing: Record<string, unknown> = {};\n\n  if (existingMetadata !== undefined && existingMetadata !== \"\") {\n    try {\n      const parsed = JSON.parse(existingMetadata);\n      if (typeof parsed === \"object\" && parsed !== null) {\n        existing = { ...parsed };\n      }\n    } catch {\n      // malformed JSON \u2014 start fresh but preserve nothing\n    }\n  }\n\n  const prev = parseAccessMetadata(existingMetadata);\n  const newCount = clampAccessCount(prev.accessCount + accessDelta);\n\n  const now = Date.now();\n\n  return JSON.stringify({\n    ...existing,\n    // Write both camelCase and snake_case for compatibility.\n    accessCount: newCount,\n    lastAccessedAt: now,\n    access_count: newCount,\n    last_accessed_at: now,\n  });\n}\n\n// ============================================================================\n// Effective Half-Life Computation\n// ============================================================================\n\n/**\n * Compute the effective half-life for a memory based on its access history.\n *\n * The access count itself decays over time (30-day half-life for access\n * freshness), so stale accesses contribute less reinforcement. The extension\n * uses a logarithmic curve (`Math.log1p`) to provide diminishing returns.\n *\n * @param baseHalfLife        - Base half-life in days (e.g. 30)\n * @param accessCount         - Raw number of times the memory was accessed\n * @param lastAccessedAt      - Timestamp (ms) of last access\n * @param reinforcementFactor - Scaling factor for reinforcement (0 = disabled)\n * @param maxMultiplier       - Hard cap: result <= baseHalfLife * maxMultiplier\n * @returns Effective half-life in days\n */\nexport function computeEffectiveHalfLife(\n  baseHalfLife: number,\n  accessCount: number,\n  lastAccessedAt: number,\n  reinforcementFactor: number,\n  maxMultiplier: number,\n): number {\n  // Short-circuit: no reinforcement or no accesses\n  if (reinforcementFactor === 0 || accessCount <= 0) {\n    return baseHalfLife;\n  }\n\n  const now = Date.now();\n  const daysSinceLastAccess = Math.max(\n    0,\n    (now - lastAccessedAt) / (1000 * 60 * 60 * 24),\n  );\n\n  // Access freshness decays exponentially with 30-day half-life\n  const accessFreshness = Math.exp(\n    -daysSinceLastAccess * (Math.LN2 / ACCESS_DECAY_HALF_LIFE_DAYS),\n  );\n\n  // Effective access count after freshness decay\n  const effectiveAccessCount = accessCount * accessFreshness;\n\n  // Logarithmic extension for diminishing returns\n  const extension =\n    baseHalfLife * reinforcementFactor * Math.log1p(effectiveAccessCount);\n\n  const result = baseHalfLife + extension;\n\n  // Hard cap\n  const cap = baseHalfLife * maxMultiplier;\n  return Math.min(result, cap);\n}\n\n// ============================================================================\n// AccessTracker Class\n// ============================================================================\n\n/**\n * Debounced write-back tracker for memory access events.\n *\n * `recordAccess()` is synchronous (Map update only, no I/O). Pending deltas\n * accumulate until `flush()` is called (or by a future scheduled callback).\n * On flush, each pending entry is read via `store.getById()`, its metadata\n * is merged with the accumulated access delta, and written back via\n * `store.update()`.\n */\nexport class AccessTracker {\n  private readonly pending: Map<string, number> = new Map();\n  private debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  private flushPromise: Promise<void> | null = null;\n  private readonly debounceMs: number;\n  private readonly store: MemoryStore;\n  private readonly logger: {\n    warn: (...args: unknown[]) => void;\n    info?: (...args: unknown[]) => void;\n  };\n\n  constructor(options: AccessTrackerOptions) {\n    this.store = options.store;\n    this.logger = options.logger;\n    this.debounceMs = options.debounceMs ?? 5_000;\n  }\n\n  /**\n   * Record one access for each of the given memory IDs.\n   * Synchronous \u2014 only updates the in-memory pending map.\n   */\n  recordAccess(ids: readonly string[]): void {\n    for (const id of ids) {\n      const current = this.pending.get(id) ?? 0;\n      this.pending.set(id, current + 1);\n    }\n\n    // Reset debounce timer\n    this.resetTimer();\n  }\n\n  /**\n   * Return a snapshot of all pending (id -> delta) entries.\n   */\n  getPendingUpdates(): Map<string, number> {\n    return new Map(this.pending);\n  }\n\n  /**\n   * Flush pending access deltas to the store.\n   *\n   * If a flush is already in progress, awaits the current flush to complete.\n   * If new pending data accumulated during the in-flight flush, a follow-up\n   * flush is automatically triggered.\n   */\n  async flush(): Promise<void> {\n    this.clearTimer();\n\n    // If a flush is in progress, wait for it to finish\n    if (this.flushPromise) {\n      await this.flushPromise;\n      // After the in-flight flush completes, check if new data accumulated\n      if (this.pending.size > 0) {\n        return this.flush();\n      }\n      return;\n    }\n\n    if (this.pending.size === 0) return;\n\n    this.flushPromise = this.doFlush();\n    try {\n      await this.flushPromise;\n    } finally {\n      this.flushPromise = null;\n    }\n\n    // If new data accumulated during flush, schedule a follow-up\n    if (this.pending.size > 0) {\n      this.resetTimer();\n    }\n  }\n\n  /**\n   * Tear down the tracker \u2014 cancel timers and clear pending state.\n   */\n  destroy(): void {\n    this.clearTimer();\n    if (this.pending.size > 0) {\n      this.logger.warn(\n        `access-tracker: destroying with ${this.pending.size} pending writes`,\n      );\n    }\n    this.pending.clear();\n  }\n\n  // --------------------------------------------------------------------------\n  // Internal helpers\n  // --------------------------------------------------------------------------\n\n  private async doFlush(): Promise<void> {\n    const batch = new Map(this.pending);\n    this.pending.clear();\n\n    for (const [id, delta] of batch) {\n      try {\n        const current = await this.store.getById(id);\n        if (!current) continue;\n\n        const updatedMeta = buildUpdatedMetadata(current.metadata, delta);\n        await this.store.update(id, { metadata: updatedMeta });\n      } catch (err) {\n        // Requeue failed delta for retry on next flush\n        const existing = this.pending.get(id) ?? 0;\n        this.pending.set(id, existing + delta);\n        this.logger.warn(\n          `access-tracker: write-back failed for ${id.slice(0, 8)}:`,\n          err,\n        );\n      }\n    }\n  }\n\n  private resetTimer(): void {\n    this.clearTimer();\n    this.debounceTimer = setTimeout(() => {\n      void this.flush();\n    }, this.debounceMs);\n  }\n\n  private clearTimer(): void {\n    if (this.debounceTimer !== null) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = null;\n    }\n  }\n}\n"],
+  "mappings": "AAsCA,MAAM,mBAAmB;AACzB,MAAM,mBAAmB;AAGzB,MAAM,8BAA8B;AAMpC,SAAS,iBAAiB,OAAuB;AAC/C,MAAI,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO;AACpC,SAAO,KAAK;AAAA,IACV;AAAA,IACA,KAAK,IAAI,kBAAkB,KAAK,MAAM,KAAK,CAAC;AAAA,EAC9C;AACF;AAYO,SAAS,oBACd,UACgB;AAChB,MAAI,aAAa,UAAa,aAAa,IAAI;AAC7C,WAAO,EAAE,aAAa,GAAG,gBAAgB,EAAE;AAAA,EAC7C;AAEA,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,QAAQ;AAAA,EAC9B,QAAQ;AACN,WAAO,EAAE,aAAa,GAAG,gBAAgB,EAAE;AAAA,EAC7C;AAEA,MAAI,OAAO,WAAW,YAAY,WAAW,MAAM;AACjD,WAAO,EAAE,aAAa,GAAG,gBAAgB,EAAE;AAAA,EAC7C;AAEA,QAAM,MAAM;AAGZ,QAAM,cAAc,IAAI,eAAe,IAAI;AAC3C,QAAM,WACJ,OAAO,gBAAgB,WAAW,cAAc,OAAO,eAAe,CAAC;AAEzE,QAAM,aAAa,IAAI,kBAAkB,IAAI;AAC7C,QAAM,kBACJ,OAAO,eAAe,WAAW,aAAa,OAAO,cAAc,CAAC;AAEtE,SAAO;AAAA,IACL,aAAa,iBAAiB,QAAQ;AAAA,IACtC,gBACE,OAAO,SAAS,eAAe,KAAK,mBAAmB,IACnD,kBACA;AAAA,EACR;AACF;AAYO,SAAS,qBACd,kBACA,aACQ;AACR,MAAI,WAAoC,CAAC;AAEzC,MAAI,qBAAqB,UAAa,qBAAqB,IAAI;AAC7D,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,gBAAgB;AAC1C,UAAI,OAAO,WAAW,YAAY,WAAW,MAAM;AACjD,mBAAW,EAAE,GAAG,OAAO;AAAA,MACzB;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,QAAM,OAAO,oBAAoB,gBAAgB;AACjD,QAAM,WAAW,iBAAiB,KAAK,cAAc,WAAW;AAEhE,QAAM,MAAM,KAAK,IAAI;AAErB,SAAO,KAAK,UAAU;AAAA,IACpB,GAAG;AAAA;AAAA,IAEH,aAAa;AAAA,IACb,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,kBAAkB;AAAA,EACpB,CAAC;AACH;AAoBO,SAAS,yBACd,cACA,aACA,gBACA,qBACA,eACQ;AAER,MAAI,wBAAwB,KAAK,eAAe,GAAG;AACjD,WAAO;AAAA,EACT;AAEA,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,sBAAsB,KAAK;AAAA,IAC/B;AAAA,KACC,MAAM,mBAAmB,MAAO,KAAK,KAAK;AAAA,EAC7C;AAGA,QAAM,kBAAkB,KAAK;AAAA,IAC3B,CAAC,uBAAuB,KAAK,MAAM;AAAA,EACrC;AAGA,QAAM,uBAAuB,cAAc;AAG3C,QAAM,YACJ,eAAe,sBAAsB,KAAK,MAAM,oBAAoB;AAEtE,QAAM,SAAS,eAAe;AAG9B,QAAM,MAAM,eAAe;AAC3B,SAAO,KAAK,IAAI,QAAQ,GAAG;AAC7B;AAeO,MAAM,cAAc;AAAA,EACR,UAA+B,oBAAI,IAAI;AAAA,EAChD,gBAAsD;AAAA,EACtD,eAAqC;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EAKjB,YAAY,SAA+B;AACzC,SAAK,QAAQ,QAAQ;AACrB,SAAK,SAAS,QAAQ;AACtB,SAAK,aAAa,QAAQ,cAAc;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,KAA8B;AACzC,eAAW,MAAM,KAAK;AACpB,YAAM,UAAU,KAAK,QAAQ,IAAI,EAAE,KAAK;AACxC,WAAK,QAAQ,IAAI,IAAI,UAAU,CAAC;AAAA,IAClC;AAGA,SAAK,WAAW;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,oBAAyC;AACvC,WAAO,IAAI,IAAI,KAAK,OAAO;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QAAuB;AAC3B,SAAK,WAAW;AAGhB,QAAI,KAAK,cAAc;AACrB,YAAM,KAAK;AAEX,UAAI,KAAK,QAAQ,OAAO,GAAG;AACzB,eAAO,KAAK,MAAM;AAAA,MACpB;AACA;AAAA,IACF;AAEA,QAAI,KAAK,QAAQ,SAAS,EAAG;AAE7B,SAAK,eAAe,KAAK,QAAQ;AACjC,QAAI;AACF,YAAM,KAAK;AAAA,IACb,UAAE;AACA,WAAK,eAAe;AAAA,IACtB;AAGA,QAAI,KAAK,QAAQ,OAAO,GAAG;AACzB,WAAK,WAAW;AAAA,IAClB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,SAAK,WAAW;AAChB,QAAI,KAAK,QAAQ,OAAO,GAAG;AACzB,WAAK,OAAO;AAAA,QACV,mCAAmC,KAAK,QAAQ,IAAI;AAAA,MACtD;AAAA,IACF;AACA,SAAK,QAAQ,MAAM;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,UAAyB;AACrC,UAAM,QAAQ,IAAI,IAAI,KAAK,OAAO;AAClC,SAAK,QAAQ,MAAM;AAEnB,eAAW,CAAC,IAAI,KAAK,KAAK,OAAO;AAC/B,UAAI;AACF,cAAM,UAAU,MAAM,KAAK,MAAM,QAAQ,EAAE;AAC3C,YAAI,CAAC,QAAS;AAEd,cAAM,cAAc,qBAAqB,QAAQ,UAAU,KAAK;AAChE,cAAM,KAAK,MAAM,OAAO,IAAI,EAAE,UAAU,YAAY,CAAC;AAAA,MACvD,SAAS,KAAK;AAEZ,cAAM,WAAW,KAAK,QAAQ,IAAI,EAAE,KAAK;AACzC,aAAK,QAAQ,IAAI,IAAI,WAAW,KAAK;AACrC,aAAK,OAAO;AAAA,UACV,yCAAyC,GAAG,MAAM,GAAG,CAAC,CAAC;AAAA,UACvD;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,aAAmB;AACzB,SAAK,WAAW;AAChB,SAAK,gBAAgB,WAAW,MAAM;AACpC,WAAK,KAAK,MAAM;AAAA,IAClB,GAAG,KAAK,UAAU;AAAA,EACpB;AAAA,EAEQ,aAAmB;AACzB,QAAI,KAAK,kBAAkB,MAAM;AAC/B,mBAAa,KAAK,aAAa;AAC/B,WAAK,gBAAgB;AAAA,IACvB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/adapters/chroma.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Chroma Storage Adapter for Mnemo
+ *
+ * Requirements:
+ *   npm install chromadb
+ *
+ * Config:
+ *   storage: "chroma"
+ *   storageConfig: { url: "http://localhost:8000" } or { path: "./chroma-data" }
+ */
+import type { StorageAdapter, MemoryRecord, SearchResult, QueryOptions } from "../storage-adapter.js";
+export declare class ChromaAdapter implements StorageAdapter {
+    readonly name = "chroma";
+    private client;
+    private collection;
+    private config;
+    constructor(config?: Record<string, unknown>);
+    connect(dbPath: string): Promise<void>;
+    ensureTable(vectorDimensions: number): Promise<void>;
+    add(records: MemoryRecord[]): Promise<void>;
+    update(id: string, record: MemoryRecord): Promise<void>;
+    delete(filter: string): Promise<void>;
+    vectorSearch(vector: number[], limit: number, minScore?: number, scopeFilter?: string[]): Promise<SearchResult[]>;
+    fullTextSearch(query: string, limit: number, scopeFilter?: string[]): Promise<SearchResult[]>;
+    query(options: QueryOptions): Promise<MemoryRecord[]>;
+    count(): Promise<number>;
+    ensureFullTextIndex(): Promise<void>;
+    hasFullTextSearch(): boolean;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=chroma.d.ts.map

package/dist/src/adapters/chroma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chroma.d.ts","sourceRoot":"","sources":["../../../src/adapters/chroma.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,uBAAuB,CAAC;AAK/B,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAItC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtC,WAAW,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASrC,YAAY,CAChB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,SAAI,EACZ,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;IAqCpB,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;IAmCpB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAuBrD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1C,iBAAiB,IAAI,OAAO;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/{src/adapters/chroma.ts → dist/src/adapters/chroma.js}

@@ -1,58 +1,29 @@
-// SPDX-License-Identifier: MIT
-/**
- * Chroma Storage Adapter for Mnemo
- *
- * Requirements:
- *   npm install chromadb
- *
- * Config:
- *   storage: "chroma"
- *   storageConfig: { url: "http://localhost:8000" } or { path: "./chroma-data" }
- */
-
-import type {
-  StorageAdapter,
-  MemoryRecord,
-  SearchResult,
-  QueryOptions,
-} from "../storage-adapter.js";
 import { registerAdapter } from "../storage-adapter.js";
-
 const COLLECTION = "mnemo_memories";
-
-export class ChromaAdapter implements StorageAdapter {
-  readonly name = "chroma";
-
-  private client: any = null;
-  private collection: any = null;
-  private config: Record<string, unknown>;
-
-  constructor(config?: Record<string, unknown>) {
+class ChromaAdapter {
+  name = "chroma";
+  client = null;
+  collection = null;
+  config;
+  constructor(config) {
     this.config = config || {};
   }
-
-  async connect(dbPath: string): Promise<void> {
+  async connect(dbPath) {
     const chroma = await import("chromadb");
-
     if (this.config.url) {
-      // Remote Chroma server
-      this.client = new chroma.ChromaClient({ path: this.config.url as string });
+      this.client = new chroma.ChromaClient({ path: this.config.url });
     } else {
-      // Persistent local (Chroma supports persistent storage)
-      this.client = new chroma.ChromaClient({ path: dbPath || this.config.path as string });
+      this.client = new chroma.ChromaClient({ path: dbPath || this.config.path });
     }
   }
-
-  async ensureTable(vectorDimensions: number): Promise<void> {
+  async ensureTable(vectorDimensions) {
     this.collection = await this.client.getOrCreateCollection({
       name: COLLECTION,
-      metadata: { "hnsw:space": "cosine" },
+      metadata: { "hnsw:space": "cosine" }
     });
   }
-
-  async add(records: MemoryRecord[]): Promise<void> {
+  async add(records) {
     if (!this.collection) throw new Error("Collection not initialized");
-
     await this.collection.upsert({
       ids: records.map((r) => r.id),
       embeddings: records.map((r) => r.vector),
@@ -62,87 +33,59 @@ export class ChromaAdapter implements StorageAdapter {
         scope: r.scope,
         importance: r.importance,
         category: r.category,
-        metadata: r.metadata,
-      })),
+        metadata: r.metadata
+      }))
     });
   }
-
-  async update(id: string, record: MemoryRecord): Promise<void> {
+  async update(id, record) {
     await this.add([record]);
   }
-
-  async delete(filter: string): Promise<void> {
+  async delete(filter) {
     if (!this.collection) throw new Error("Collection not initialized");
-
     const idMatch = filter.match(/id\s*=\s*'([^']+)'/);
     if (idMatch) {
       await this.collection.delete({ ids: [idMatch[1]] });
     }
   }
-
-  async vectorSearch(
-    vector: number[],
-    limit: number,
-    minScore = 0,
-    scopeFilter?: string[],
-  ): Promise<SearchResult[]> {
+  async vectorSearch(vector, limit, minScore = 0, scopeFilter) {
     if (!this.collection) throw new Error("Collection not initialized");
-
-    const where = scopeFilter?.length
-      ? { scope: { $in: scopeFilter } }
-      : undefined;
-
+    const where = scopeFilter?.length ? { scope: { $in: scopeFilter } } : void 0;
     const results = await this.collection.query({
       queryEmbeddings: [vector],
       nResults: limit,
-      ...(where ? { where } : {}),
+      ...where ? { where } : {}
     });
-
     if (!results.ids?.[0]) return [];
-
-    return results.ids[0].map((id: string, i: number) => {
-      // Chroma returns distances, convert to similarity
+    return results.ids[0].map((id, i) => {
       const distance = results.distances?.[0]?.[i] ?? 1;
-      const score = 1 - distance; // cosine distance → similarity
+      const score = 1 - distance;
       const meta = results.metadatas?.[0]?.[i] || {};
-
       return {
         record: {
           id,
           text: results.documents?.[0]?.[i] ?? "",
-          vector: [], // Chroma doesn't return vectors by default
+          vector: [],
+          // Chroma doesn't return vectors by default
           timestamp: meta.timestamp ?? 0,
           scope: meta.scope ?? "global",
           importance: meta.importance ?? 0.5,
           category: meta.category ?? "other",
-          metadata: meta.metadata ?? "{}",
+          metadata: meta.metadata ?? "{}"
         },
-        score,
+        score
       };
-    }).filter((r: SearchResult) => r.score >= minScore);
+    }).filter((r) => r.score >= minScore);
   }
-
-  async fullTextSearch(
-    query: string,
-    limit: number,
-    scopeFilter?: string[],
-  ): Promise<SearchResult[]> {
+  async fullTextSearch(query, limit, scopeFilter) {
     if (!this.collection) return [];
-
-    const where = scopeFilter?.length
-      ? { scope: { $in: scopeFilter } }
-      : undefined;
-
-    // Chroma supports document search via where_document
+    const where = scopeFilter?.length ? { scope: { $in: scopeFilter } } : void 0;
     const results = await this.collection.query({
       queryTexts: [query],
       nResults: limit,
-      ...(where ? { where } : {}),
+      ...where ? { where } : {}
     });
-
     if (!results.ids?.[0]) return [];
-
-    return results.ids[0].map((id: string, i: number) => {
+    return results.ids[0].map((id, i) => {
       const distance = results.distances?.[0]?.[i] ?? 1;
       const meta = results.metadatas?.[0]?.[i] || {};
       return {
@@ -154,22 +97,19 @@ export class ChromaAdapter implements StorageAdapter {
           scope: meta.scope ?? "global",
           importance: meta.importance ?? 0.5,
           category: meta.category ?? "other",
-          metadata: meta.metadata ?? "{}",
+          metadata: meta.metadata ?? "{}"
         },
-        score: 1 - distance,
+        score: 1 - distance
       };
     });
   }
-
-  async query(options: QueryOptions): Promise<MemoryRecord[]> {
+  async query(options) {
     if (!this.collection) throw new Error("Collection not initialized");
-
     const result = await this.collection.get({
       limit: options.limit || 100,
-      include: ["documents", "metadatas", "embeddings"],
+      include: ["documents", "metadatas", "embeddings"]
     });
-
-    return (result.ids || []).map((id: string, i: number) => {
+    return (result.ids || []).map((id, i) => {
       const meta = result.metadatas?.[i] || {};
       return {
         id,
@@ -179,28 +119,26 @@ export class ChromaAdapter implements StorageAdapter {
         scope: meta.scope ?? "global",
         importance: meta.importance ?? 0.5,
         category: meta.category ?? "other",
-        metadata: meta.metadata ?? "{}",
+        metadata: meta.metadata ?? "{}"
       };
     });
   }
-
-  async count(): Promise<number> {
+  async count() {
     if (!this.collection) return 0;
     return await this.collection.count();
   }
-
-  async ensureFullTextIndex(): Promise<void> {
-    // Chroma handles text search natively via queryTexts
+  async ensureFullTextIndex() {
   }
-
-  hasFullTextSearch(): boolean {
-    return true; // Chroma supports document-level text search
+  hasFullTextSearch() {
+    return true;
   }
-
-  async close(): Promise<void> {
+  async close() {
     this.collection = null;
     this.client = null;
   }
 }
-
 registerAdapter("chroma", (config) => new ChromaAdapter(config));
+export {
+  ChromaAdapter
+};
+//# sourceMappingURL=chroma.js.map

package/dist/src/adapters/chroma.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/chroma.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * Chroma Storage Adapter for Mnemo\n *\n * Requirements:\n *   npm install chromadb\n *\n * Config:\n *   storage: \"chroma\"\n *   storageConfig: { url: \"http://localhost:8000\" } or { path: \"./chroma-data\" }\n */\n\nimport type {\n  StorageAdapter,\n  MemoryRecord,\n  SearchResult,\n  QueryOptions,\n} from \"../storage-adapter.js\";\nimport { registerAdapter } from \"../storage-adapter.js\";\n\nconst COLLECTION = \"mnemo_memories\";\n\nexport class ChromaAdapter implements StorageAdapter {\n  readonly name = \"chroma\";\n\n  private client: any = null;\n  private collection: any = null;\n  private config: Record<string, unknown>;\n\n  constructor(config?: Record<string, unknown>) {\n    this.config = config || {};\n  }\n\n  async connect(dbPath: string): Promise<void> {\n    const chroma = await import(\"chromadb\");\n\n    if (this.config.url) {\n      // Remote Chroma server\n      this.client = new chroma.ChromaClient({ path: this.config.url as string });\n    } else {\n      // Persistent local (Chroma supports persistent storage)\n      this.client = new chroma.ChromaClient({ path: dbPath || this.config.path as string });\n    }\n  }\n\n  async ensureTable(vectorDimensions: number): Promise<void> {\n    this.collection = await this.client.getOrCreateCollection({\n      name: COLLECTION,\n      metadata: { \"hnsw:space\": \"cosine\" },\n    });\n  }\n\n  async add(records: MemoryRecord[]): Promise<void> {\n    if (!this.collection) throw new Error(\"Collection not initialized\");\n\n    await this.collection.upsert({\n      ids: records.map((r) => r.id),\n      embeddings: records.map((r) => r.vector),\n      documents: records.map((r) => r.text),\n      metadatas: records.map((r) => ({\n        timestamp: r.timestamp,\n        scope: r.scope,\n        importance: r.importance,\n        category: r.category,\n        metadata: r.metadata,\n      })),\n    });\n  }\n\n  async update(id: string, record: MemoryRecord): Promise<void> {\n    await this.add([record]);\n  }\n\n  async delete(filter: string): Promise<void> {\n    if (!this.collection) throw new Error(\"Collection not initialized\");\n\n    const idMatch = filter.match(/id\\s*=\\s*'([^']+)'/);\n    if (idMatch) {\n      await this.collection.delete({ ids: [idMatch[1]] });\n    }\n  }\n\n  async vectorSearch(\n    vector: number[],\n    limit: number,\n    minScore = 0,\n    scopeFilter?: string[],\n  ): Promise<SearchResult[]> {\n    if (!this.collection) throw new Error(\"Collection not initialized\");\n\n    const where = scopeFilter?.length\n      ? { scope: { $in: scopeFilter } }\n      : undefined;\n\n    const results = await this.collection.query({\n      queryEmbeddings: [vector],\n      nResults: limit,\n      ...(where ? { where } : {}),\n    });\n\n    if (!results.ids?.[0]) return [];\n\n    return results.ids[0].map((id: string, i: number) => {\n      // Chroma returns distances, convert to similarity\n      const distance = results.distances?.[0]?.[i] ?? 1;\n      const score = 1 - distance; // cosine distance \u2192 similarity\n      const meta = results.metadatas?.[0]?.[i] || {};\n\n      return {\n        record: {\n          id,\n          text: results.documents?.[0]?.[i] ?? \"\",\n          vector: [], // Chroma doesn't return vectors by default\n          timestamp: meta.timestamp ?? 0,\n          scope: meta.scope ?? \"global\",\n          importance: meta.importance ?? 0.5,\n          category: meta.category ?? \"other\",\n          metadata: meta.metadata ?? \"{}\",\n        },\n        score,\n      };\n    }).filter((r: SearchResult) => r.score >= minScore);\n  }\n\n  async fullTextSearch(\n    query: string,\n    limit: number,\n    scopeFilter?: string[],\n  ): Promise<SearchResult[]> {\n    if (!this.collection) return [];\n\n    const where = scopeFilter?.length\n      ? { scope: { $in: scopeFilter } }\n      : undefined;\n\n    // Chroma supports document search via where_document\n    const results = await this.collection.query({\n      queryTexts: [query],\n      nResults: limit,\n      ...(where ? { where } : {}),\n    });\n\n    if (!results.ids?.[0]) return [];\n\n    return results.ids[0].map((id: string, i: number) => {\n      const distance = results.distances?.[0]?.[i] ?? 1;\n      const meta = results.metadatas?.[0]?.[i] || {};\n      return {\n        record: {\n          id,\n          text: results.documents?.[0]?.[i] ?? \"\",\n          vector: [],\n          timestamp: meta.timestamp ?? 0,\n          scope: meta.scope ?? \"global\",\n          importance: meta.importance ?? 0.5,\n          category: meta.category ?? \"other\",\n          metadata: meta.metadata ?? \"{}\",\n        },\n        score: 1 - distance,\n      };\n    });\n  }\n\n  async query(options: QueryOptions): Promise<MemoryRecord[]> {\n    if (!this.collection) throw new Error(\"Collection not initialized\");\n\n    const result = await this.collection.get({\n      limit: options.limit || 100,\n      include: [\"documents\", \"metadatas\", \"embeddings\"],\n    });\n\n    return (result.ids || []).map((id: string, i: number) => {\n      const meta = result.metadatas?.[i] || {};\n      return {\n        id,\n        text: result.documents?.[i] ?? \"\",\n        vector: result.embeddings?.[i] ?? [],\n        timestamp: meta.timestamp ?? 0,\n        scope: meta.scope ?? \"global\",\n        importance: meta.importance ?? 0.5,\n        category: meta.category ?? \"other\",\n        metadata: meta.metadata ?? \"{}\",\n      };\n    });\n  }\n\n  async count(): Promise<number> {\n    if (!this.collection) return 0;\n    return await this.collection.count();\n  }\n\n  async ensureFullTextIndex(): Promise<void> {\n    // Chroma handles text search natively via queryTexts\n  }\n\n  hasFullTextSearch(): boolean {\n    return true; // Chroma supports document-level text search\n  }\n\n  async close(): Promise<void> {\n    this.collection = null;\n    this.client = null;\n  }\n}\n\nregisterAdapter(\"chroma\", (config) => new ChromaAdapter(config));\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/adapters/lancedb.d.ts

@@ -0,0 +1,29 @@
+/**
+ * LanceDB Storage Adapter — Default backend for Mnemo.
+ *
+ * Implements StorageAdapter using @lancedb/lancedb.
+ * This is the reference implementation; other backends should
+ * produce equivalent behavior.
+ */
+import type { StorageAdapter, MemoryRecord, SearchResult, QueryOptions } from "../storage-adapter.js";
+export declare class LanceDBAdapter implements StorageAdapter {
+    readonly name = "lancedb";
+    private db;
+    private table;
+    private ftsReady;
+    private vectorDim;
+    connect(dbPath: string): Promise<void>;
+    ensureTable(vectorDimensions: number): Promise<void>;
+    add(records: MemoryRecord[]): Promise<void>;
+    update(id: string, record: MemoryRecord): Promise<void>;
+    delete(filter: string): Promise<void>;
+    vectorSearch(vector: number[], limit: number, minScore?: number, scopeFilter?: string[]): Promise<SearchResult[]>;
+    fullTextSearch(queryText: string, limit: number, scopeFilter?: string[]): Promise<SearchResult[]>;
+    query(options: QueryOptions): Promise<MemoryRecord[]>;
+    count(filter?: string): Promise<number>;
+    ensureFullTextIndex(): Promise<void>;
+    hasFullTextSearch(): boolean;
+    close(): Promise<void>;
+    private toRecord;
+}
+//# sourceMappingURL=lancedb.d.ts.map

package/dist/src/adapters/lancedb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lancedb.d.ts","sourceRoot":"","sources":["../../../src/adapters/lancedb.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,uBAAuB,CAAC;AAqB/B,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,IAAI,aAAa;IAE1B,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAK;IAEhB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtC,WAAW,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CpD,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrC,YAAY,CAChB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,SAAI,EACZ,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;IAsBpB,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;IAoBpB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmBrD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQvC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB1C,iBAAiB,IAAI,OAAO;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,QAAQ;CAajB"}