@remnic/core 9.57.5 → 9.58.0

package/dist/{chunk-LIF6DO6U.js → chunk-MG7GI4TT.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-YTZA7U6Q.js";
+} from "./chunk-2VHCLHZ5.js";
 import {
   keyring_exports,
   secureStoreDir
@@ -412,4 +412,4 @@ export {
   resolveNamespaceStorageRoot,
   NamespaceStorageRouter
 };
-//# sourceMappingURL=chunk-LIF6DO6U.js.map
+//# sourceMappingURL=chunk-MG7GI4TT.js.map

package/dist/{chunk-RUZM6Z52.js → chunk-MMZK2DWN.js}

@@ -279,4 +279,4 @@ async function searchHarmonicRetrieval(options) {
 export {
   searchHarmonicRetrieval
 };
-//# sourceMappingURL=chunk-RUZM6Z52.js.map
+//# sourceMappingURL=chunk-MMZK2DWN.js.map

package/dist/{chunk-NTJ6TY44.js → chunk-ODAE36PG.js}

@@ -49,7 +49,7 @@ import {
   buildExtensionsFooterForSummary,
   formatDaySummaryMemories,
   loadDaySummaryPrompt
-} from "./chunk-BPWZDHFM.js";
+} from "./chunk-J6QIAYNR.js";
 import {
   delinearize
 } from "./chunk-VEWZZM3H.js";
@@ -65,7 +65,7 @@ import {
 } from "./chunk-NLE6TSLG.js";
 import {
   LocalLlmClient
-} from "./chunk-5ZIWRMZM.js";
+} from "./chunk-IVKIODHO.js";
 import {
   normalizeProcedureSteps
 } from "./chunk-QDW3E4RD.js";
@@ -2442,4 +2442,4 @@ export {
   shouldEnableLocalExtractionThinking,
   ExtractionEngine
 };
-//# sourceMappingURL=chunk-NTJ6TY44.js.map
+//# sourceMappingURL=chunk-ODAE36PG.js.map

package/dist/{chunk-QFN4U7AG.js → chunk-ODZKV2F7.js}

@@ -85,7 +85,7 @@ var SessionObserverState = class {
     try {
       const raw = await readFile(this.statePath, "utf-8");
       const parsed = JSON.parse(raw);
-      if (parsed?.version !== 1 || !parsed.sessions || typeof parsed.sessions !== "object") {
+      if (parsed?.version !== 2 || !parsed.sessions || typeof parsed.sessions !== "object") {
         return null;
       }
       return parsed;
@@ -183,7 +183,7 @@ var SessionObserverState = class {
     for (const [key, value] of sessionsMap.entries()) {
       sessions[key] = value;
     }
-    const payload = { version: 1, sessions };
+    const payload = { version: 2, sessions };
     await mkdir(path.dirname(this.statePath), { recursive: true });
     await writeFile(this.statePath, JSON.stringify(payload, null, 2), "utf-8");
   }
@@ -323,4 +323,4 @@ export {
   normalizeObserverBands,
   SessionObserverState
 };
-//# sourceMappingURL=chunk-QFN4U7AG.js.map
+//# sourceMappingURL=chunk-ODZKV2F7.js.map

package/dist/{chunk-QFN4U7AG.js.map → chunk-ODZKV2F7.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/session-observer-state.ts"],"sourcesContent":["import path from \"node:path\";\nimport { mkdir, open, readFile, stat, unlink, writeFile } from \"node:fs/promises\";\nimport { log } from \"./logger.js\";\nimport type { SessionObserverBandConfig } from \"./types.js\";\nimport { cloneDefaultSessionObserverBands } from \"./session-observer-bands.js\";\n\ninterface SessionObserverCursor {\n  sessionKey: string;\n  cursorBytes: number;\n  cursorTokens: number;\n  lastObservedAt: string;\n  lastTriggeredAt?: string;\n  lastResetAt?: string;\n}\n\ninterface SessionObserverPersistedState {\n  version: 1;\n  sessions: Record<string, SessionObserverCursor>;\n}\n\nexport interface SessionObservationInput {\n  sessionKey: string;\n  totalBytes: number;\n  totalTokens: number;\n  observedAt?: string;\n}\n\nexport interface SessionObservationDecision {\n  triggered: boolean;\n  deltaBytes: number;\n  deltaTokens: number;\n  band: SessionObserverBandConfig;\n  reason?: \"threshold\" | \"debounced\" | \"baseline\";\n}\n\nfunction sanitizeNonNegativeInt(value: number): number {\n  if (!Number.isFinite(value)) return 0;\n  return Math.max(0, Math.floor(value));\n}\n\nfunction parseIsoMs(value?: string): number {\n  if (!value) return 0;\n  const ms = Date.parse(value);\n  return Number.isFinite(ms) ? ms : 0;\n}\n\nfunction mergeSessionCursor(\n  existing: SessionObserverCursor,\n  incoming: SessionObserverCursor,\n): SessionObserverCursor {\n  const existingObservedMs = parseIsoMs(existing.lastObservedAt);\n  const incomingObservedMs = parseIsoMs(incoming.lastObservedAt);\n  const existingTriggeredMs = parseIsoMs(existing.lastTriggeredAt);\n  const incomingTriggeredMs = parseIsoMs(incoming.lastTriggeredAt);\n  const existingResetMs = parseIsoMs(existing.lastResetAt);\n  const incomingResetMs = parseIsoMs(incoming.lastResetAt);\n\n  const observedAt =\n    incomingObservedMs >= existingObservedMs ? incoming.lastObservedAt : existing.lastObservedAt;\n  const triggeredAt =\n    incomingTriggeredMs >= existingTriggeredMs ? incoming.lastTriggeredAt : existing.lastTriggeredAt;\n\n  // Preserve monotonic cursor progression except for explicit reset observations.\n  const incomingIsNewer = incomingObservedMs >= existingObservedMs;\n  const incomingHasNewerReset = incomingResetMs > existingResetMs;\n  const allowIncomingReset = incomingIsNewer && incomingHasNewerReset;\n  const keepExistingReset =\n    existingResetMs > incomingResetMs && existingObservedMs >= incomingObservedMs;\n\n  let cursorBytes = Math.max(\n    sanitizeNonNegativeInt(existing.cursorBytes),\n    sanitizeNonNegativeInt(incoming.cursorBytes),\n  );\n  let cursorTokens = Math.max(\n    sanitizeNonNegativeInt(existing.cursorTokens),\n    sanitizeNonNegativeInt(incoming.cursorTokens),\n  );\n  if (keepExistingReset) {\n    cursorBytes = sanitizeNonNegativeInt(existing.cursorBytes);\n    cursorTokens = sanitizeNonNegativeInt(existing.cursorTokens);\n  } else if (allowIncomingReset) {\n    cursorBytes = sanitizeNonNegativeInt(incoming.cursorBytes);\n    cursorTokens = sanitizeNonNegativeInt(incoming.cursorTokens);\n  }\n\n  return {\n    sessionKey: existing.sessionKey,\n    cursorBytes,\n    cursorTokens,\n    lastObservedAt: observedAt,\n    lastTriggeredAt: triggeredAt,\n    lastResetAt:\n      incomingResetMs >= existingResetMs ? incoming.lastResetAt : existing.lastResetAt,\n  };\n}\n\nexport function normalizeObserverBands(\n  bands: SessionObserverBandConfig[],\n): SessionObserverBandConfig[] {\n  const normalized = bands\n    .map((band) => ({\n      maxBytes: sanitizeNonNegativeInt(band.maxBytes),\n      triggerDeltaBytes: sanitizeNonNegativeInt(band.triggerDeltaBytes),\n      triggerDeltaTokens: sanitizeNonNegativeInt(band.triggerDeltaTokens),\n    }))\n    .filter((band) => band.maxBytes > 0)\n    .sort((a, b) => a.maxBytes - b.maxBytes);\n\n  if (normalized.length === 0) {\n    return cloneDefaultSessionObserverBands();\n  }\n\n  const last = normalized[normalized.length - 1];\n  if (last && last.maxBytes < 1_000_000_000) {\n    normalized.push({\n      maxBytes: 1_000_000_000,\n      triggerDeltaBytes: last.triggerDeltaBytes,\n      triggerDeltaTokens: last.triggerDeltaTokens,\n    });\n  }\n  return normalized;\n}\n\nexport class SessionObserverState {\n  private readonly statePath: string;\n  private readonly lockPath: string;\n  private readonly lockStaleMs = 120_000;\n  private readonly debounceMs: number;\n  private readonly bands: SessionObserverBandConfig[];\n  private sessions = new Map<string, SessionObserverCursor>();\n  private saveQueue: Promise<void> = Promise.resolve();\n\n  private async readPersistedState(): Promise<SessionObserverPersistedState | null> {\n    try {\n      const raw = await readFile(this.statePath, \"utf-8\");\n      const parsed = JSON.parse(raw) as SessionObserverPersistedState;\n      if (parsed?.version !== 1 || !parsed.sessions || typeof parsed.sessions !== \"object\") {\n        return null;\n      }\n      return parsed;\n    } catch {\n      return null;\n    }\n  }\n\n  private normalizePersistedSessions(\n    sessions: Record<string, SessionObserverCursor>,\n  ): Map<string, SessionObserverCursor> {\n    const next = new Map<string, SessionObserverCursor>();\n    for (const [sessionKey, value] of Object.entries(sessions)) {\n      if (!value || typeof value !== \"object\") continue;\n      next.set(sessionKey, {\n        sessionKey,\n        cursorBytes: sanitizeNonNegativeInt(value.cursorBytes),\n        cursorTokens: sanitizeNonNegativeInt(value.cursorTokens),\n        lastObservedAt:\n          typeof value.lastObservedAt === \"string\" ? value.lastObservedAt : new Date(0).toISOString(),\n        lastTriggeredAt: typeof value.lastTriggeredAt === \"string\" ? value.lastTriggeredAt : undefined,\n        lastResetAt: typeof value.lastResetAt === \"string\" ? value.lastResetAt : undefined,\n      });\n    }\n    return next;\n  }\n\n  constructor(opts: {\n    memoryDir: string;\n    debounceMs: number;\n    bands: SessionObserverBandConfig[];\n  }) {\n    this.statePath = path.join(opts.memoryDir, \"state\", \"session-observer-state.json\");\n    this.lockPath = path.join(opts.memoryDir, \"state\", \"session-observer-state.lock\");\n    this.debounceMs = Math.max(0, Math.floor(opts.debounceMs));\n    this.bands = normalizeObserverBands(opts.bands);\n  }\n\n  private async withSaveLock(fn: () => Promise<void>): Promise<void> {\n    await mkdir(path.dirname(this.lockPath), { recursive: true });\n    for (let attempt = 0; attempt < 80; attempt++) {\n      try {\n        const handle = await open(this.lockPath, \"wx\");\n        try {\n          await fn();\n        } finally {\n          await handle.close();\n          await unlink(this.lockPath).catch(() => {});\n        }\n        return;\n      } catch (err: any) {\n        if (err?.code !== \"EEXIST\") throw err;\n        try {\n          const lockInfo = await stat(this.lockPath);\n          if (Date.now() - lockInfo.mtimeMs > this.lockStaleMs) {\n            await unlink(this.lockPath).catch(() => {});\n            continue;\n          }\n        } catch {\n          // Lock might have been released between EEXIST and stat/read.\n        }\n        await new Promise((resolve) => setTimeout(resolve, 25));\n      }\n    }\n    const error = new Error(\"session observer save lock timeout\");\n    log.debug(error.message);\n    throw error;\n  }\n\n  async load(): Promise<void> {\n    const parsed = await this.readPersistedState();\n    if (!parsed) {\n      this.sessions.clear();\n      return;\n    }\n    this.sessions = this.normalizePersistedSessions(parsed.sessions);\n  }\n\n  async save(): Promise<void> {\n    await this.withSaveLock(async () => {\n      const merged = await this.readMergedSessions();\n      this.sessions = merged;\n\n      await this.writeSessions(merged);\n    });\n  }\n\n  private async readMergedSessions(): Promise<Map<string, SessionObserverCursor>> {\n    const merged = new Map<string, SessionObserverCursor>();\n    const persisted = await this.readPersistedState();\n    if (persisted) {\n      for (const [key, value] of this.normalizePersistedSessions(persisted.sessions).entries()) {\n        merged.set(key, value);\n      }\n    }\n    for (const [key, current] of this.sessions.entries()) {\n      const existing = merged.get(key);\n      if (!existing) {\n        merged.set(key, current);\n        continue;\n      }\n      merged.set(key, mergeSessionCursor(existing, current));\n    }\n    return merged;\n  }\n\n  private async writeSessions(sessionsMap: Map<string, SessionObserverCursor>): Promise<void> {\n    const sessions = Object.create(null) as Record<string, SessionObserverCursor>;\n    for (const [key, value] of sessionsMap.entries()) {\n      sessions[key] = value;\n    }\n    const payload: SessionObserverPersistedState = { version: 1, sessions };\n    await mkdir(path.dirname(this.statePath), { recursive: true });\n    await writeFile(this.statePath, JSON.stringify(payload, null, 2), \"utf-8\");\n  }\n\n  private enqueueObservation(\n    input: SessionObservationInput,\n  ): Promise<SessionObservationDecision> {\n    const operation = this.saveQueue\n      .catch(() => undefined)\n      .then(() => this.observeWithSaveLock(input));\n    this.saveQueue = operation.then(\n      () => undefined,\n      () => undefined,\n    );\n    return operation;\n  }\n\n  private bandForTotalBytes(totalBytes: number): SessionObserverBandConfig {\n    const bytes = sanitizeNonNegativeInt(totalBytes);\n    for (const band of this.bands) {\n      if (bytes <= band.maxBytes) return band;\n    }\n    return this.bands[this.bands.length - 1];\n  }\n\n  async observe(input: SessionObservationInput): Promise<SessionObservationDecision> {\n    return this.enqueueObservation(input);\n  }\n\n  private async observeWithSaveLock(\n    input: SessionObservationInput,\n  ): Promise<SessionObservationDecision> {\n    let decision: SessionObservationDecision | undefined;\n    await this.withSaveLock(async () => {\n      const localExisting = this.sessions.get(input.sessionKey);\n      const sessions = await this.readMergedSessions();\n      decision = await this.observeMerged(\n        input,\n        sessions,\n        localExisting ? { ...localExisting } : undefined,\n      );\n    });\n    if (!decision) {\n      throw new Error(\"session observer decision was not computed\");\n    }\n    return decision;\n  }\n\n  private async observeMerged(\n    input: SessionObservationInput,\n    sessions: Map<string, SessionObserverCursor>,\n    localExisting?: SessionObserverCursor,\n  ): Promise<SessionObservationDecision> {\n    const nowIso = input.observedAt ?? new Date().toISOString();\n    const totalBytes = sanitizeNonNegativeInt(input.totalBytes);\n    const totalTokens = sanitizeNonNegativeInt(input.totalTokens);\n    const band = this.bandForTotalBytes(totalBytes);\n\n    const existing = sessions.get(input.sessionKey);\n    if (!existing) {\n      sessions.set(input.sessionKey, {\n        sessionKey: input.sessionKey,\n        cursorBytes: totalBytes,\n        cursorTokens: totalTokens,\n        lastObservedAt: nowIso,\n      });\n      this.sessions = sessions;\n      await this.writeSessions(sessions);\n      return {\n        triggered: false,\n        deltaBytes: 0,\n        deltaTokens: 0,\n        band,\n        reason: \"baseline\",\n      };\n    }\n\n    const session = { ...existing };\n    const observedMs = parseIsoMs(nowIso);\n    const existingObservedMs = parseIsoMs(session.lastObservedAt);\n    const existingResetMs = parseIsoMs(session.lastResetAt);\n    if (existingResetMs > 0 && observedMs < existingResetMs) {\n      this.sessions = sessions;\n      return { triggered: false, deltaBytes: 0, deltaTokens: 0, band, reason: \"baseline\" };\n    }\n\n    if (totalBytes < session.cursorBytes || totalTokens < session.cursorTokens) {\n      const localSawReset =\n        localExisting !== undefined\n        && (totalBytes < sanitizeNonNegativeInt(localExisting.cursorBytes)\n          || totalTokens < sanitizeNonNegativeInt(localExisting.cursorTokens));\n      const canApplyReset = localSawReset && observedMs >= existingObservedMs;\n\n      if (canApplyReset) {\n        session.cursorBytes = totalBytes;\n        session.cursorTokens = totalTokens;\n        session.lastObservedAt = nowIso;\n        session.lastResetAt = nowIso;\n      } else if (observedMs >= existingObservedMs) {\n        session.lastObservedAt = nowIso;\n      }\n      sessions.set(input.sessionKey, session);\n      this.sessions = sessions;\n      await this.writeSessions(sessions);\n      return { triggered: false, deltaBytes: 0, deltaTokens: 0, band, reason: \"baseline\" };\n    }\n\n    const deltaBytes = totalBytes - session.cursorBytes;\n    const deltaTokens = totalTokens - session.cursorTokens;\n    const crossedThreshold =\n      (band.triggerDeltaBytes > 0 && deltaBytes >= band.triggerDeltaBytes)\n      || (band.triggerDeltaTokens > 0 && deltaTokens >= band.triggerDeltaTokens);\n    session.lastObservedAt = nowIso;\n\n    if (!crossedThreshold) {\n      const unchanged = deltaBytes === 0 && deltaTokens === 0;\n      if (!unchanged) {\n        sessions.set(input.sessionKey, session);\n        this.sessions = sessions;\n        await this.writeSessions(sessions);\n      } else {\n        this.sessions = sessions;\n      }\n      return {\n        triggered: false,\n        deltaBytes,\n        deltaTokens,\n        band,\n      };\n    }\n\n    const nowMs = Date.parse(nowIso);\n    const lastTriggeredMs = session.lastTriggeredAt ? Date.parse(session.lastTriggeredAt) : NaN;\n    const withinDebounce =\n      Number.isFinite(lastTriggeredMs) && nowMs - lastTriggeredMs < this.debounceMs;\n\n    if (withinDebounce) {\n      sessions.set(input.sessionKey, session);\n      this.sessions = sessions;\n      await this.writeSessions(sessions);\n      return {\n        triggered: false,\n        deltaBytes,\n        deltaTokens,\n        band,\n        reason: \"debounced\",\n      };\n    }\n\n    session.lastTriggeredAt = nowIso;\n    session.cursorBytes = totalBytes;\n    session.cursorTokens = totalTokens;\n    sessions.set(input.sessionKey, session);\n    this.sessions = sessions;\n    await this.writeSessions(sessions);\n    return {\n      triggered: true,\n      deltaBytes,\n      deltaTokens,\n      band,\n      reason: \"threshold\",\n    };\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/session-observer-state.ts"],"sourcesContent":["import path from \"node:path\";\nimport { mkdir, open, readFile, stat, unlink, writeFile } from \"node:fs/promises\";\nimport { log } from \"./logger.js\";\nimport type { SessionObserverBandConfig } from \"./types.js\";\nimport { cloneDefaultSessionObserverBands } from \"./session-observer-bands.js\";\n\ninterface SessionObserverCursor {\n  sessionKey: string;\n  cursorBytes: number;\n  cursorTokens: number;\n  lastObservedAt: string;\n  lastTriggeredAt?: string;\n  lastResetAt?: string;\n}\n\ninterface SessionObserverPersistedState {\n  version: 2;\n  sessions: Record<string, SessionObserverCursor>;\n}\n\nexport interface SessionObservationInput {\n  sessionKey: string;\n  totalBytes: number;\n  totalTokens: number;\n  observedAt?: string;\n}\n\nexport interface SessionObservationDecision {\n  triggered: boolean;\n  deltaBytes: number;\n  deltaTokens: number;\n  band: SessionObserverBandConfig;\n  reason?: \"threshold\" | \"debounced\" | \"baseline\";\n}\n\nfunction sanitizeNonNegativeInt(value: number): number {\n  if (!Number.isFinite(value)) return 0;\n  return Math.max(0, Math.floor(value));\n}\n\nfunction parseIsoMs(value?: string): number {\n  if (!value) return 0;\n  const ms = Date.parse(value);\n  return Number.isFinite(ms) ? ms : 0;\n}\n\nfunction mergeSessionCursor(\n  existing: SessionObserverCursor,\n  incoming: SessionObserverCursor,\n): SessionObserverCursor {\n  const existingObservedMs = parseIsoMs(existing.lastObservedAt);\n  const incomingObservedMs = parseIsoMs(incoming.lastObservedAt);\n  const existingTriggeredMs = parseIsoMs(existing.lastTriggeredAt);\n  const incomingTriggeredMs = parseIsoMs(incoming.lastTriggeredAt);\n  const existingResetMs = parseIsoMs(existing.lastResetAt);\n  const incomingResetMs = parseIsoMs(incoming.lastResetAt);\n\n  const observedAt =\n    incomingObservedMs >= existingObservedMs ? incoming.lastObservedAt : existing.lastObservedAt;\n  const triggeredAt =\n    incomingTriggeredMs >= existingTriggeredMs ? incoming.lastTriggeredAt : existing.lastTriggeredAt;\n\n  // Preserve monotonic cursor progression except for explicit reset observations.\n  const incomingIsNewer = incomingObservedMs >= existingObservedMs;\n  const incomingHasNewerReset = incomingResetMs > existingResetMs;\n  const allowIncomingReset = incomingIsNewer && incomingHasNewerReset;\n  const keepExistingReset =\n    existingResetMs > incomingResetMs && existingObservedMs >= incomingObservedMs;\n\n  let cursorBytes = Math.max(\n    sanitizeNonNegativeInt(existing.cursorBytes),\n    sanitizeNonNegativeInt(incoming.cursorBytes),\n  );\n  let cursorTokens = Math.max(\n    sanitizeNonNegativeInt(existing.cursorTokens),\n    sanitizeNonNegativeInt(incoming.cursorTokens),\n  );\n  if (keepExistingReset) {\n    cursorBytes = sanitizeNonNegativeInt(existing.cursorBytes);\n    cursorTokens = sanitizeNonNegativeInt(existing.cursorTokens);\n  } else if (allowIncomingReset) {\n    cursorBytes = sanitizeNonNegativeInt(incoming.cursorBytes);\n    cursorTokens = sanitizeNonNegativeInt(incoming.cursorTokens);\n  }\n\n  return {\n    sessionKey: existing.sessionKey,\n    cursorBytes,\n    cursorTokens,\n    lastObservedAt: observedAt,\n    lastTriggeredAt: triggeredAt,\n    lastResetAt:\n      incomingResetMs >= existingResetMs ? incoming.lastResetAt : existing.lastResetAt,\n  };\n}\n\nexport function normalizeObserverBands(\n  bands: SessionObserverBandConfig[],\n): SessionObserverBandConfig[] {\n  const normalized = bands\n    .map((band) => ({\n      maxBytes: sanitizeNonNegativeInt(band.maxBytes),\n      triggerDeltaBytes: sanitizeNonNegativeInt(band.triggerDeltaBytes),\n      triggerDeltaTokens: sanitizeNonNegativeInt(band.triggerDeltaTokens),\n    }))\n    .filter((band) => band.maxBytes > 0)\n    .sort((a, b) => a.maxBytes - b.maxBytes);\n\n  if (normalized.length === 0) {\n    return cloneDefaultSessionObserverBands();\n  }\n\n  const last = normalized[normalized.length - 1];\n  if (last && last.maxBytes < 1_000_000_000) {\n    normalized.push({\n      maxBytes: 1_000_000_000,\n      triggerDeltaBytes: last.triggerDeltaBytes,\n      triggerDeltaTokens: last.triggerDeltaTokens,\n    });\n  }\n  return normalized;\n}\n\nexport class SessionObserverState {\n  private readonly statePath: string;\n  private readonly lockPath: string;\n  private readonly lockStaleMs = 120_000;\n  private readonly debounceMs: number;\n  private readonly bands: SessionObserverBandConfig[];\n  private sessions = new Map<string, SessionObserverCursor>();\n  private saveQueue: Promise<void> = Promise.resolve();\n\n  private async readPersistedState(): Promise<SessionObserverPersistedState | null> {\n    try {\n      const raw = await readFile(this.statePath, \"utf-8\");\n      const parsed = JSON.parse(raw) as SessionObserverPersistedState;\n      if (parsed?.version !== 2 || !parsed.sessions || typeof parsed.sessions !== \"object\") {\n        return null;\n      }\n      return parsed;\n    } catch {\n      return null;\n    }\n  }\n\n  private normalizePersistedSessions(\n    sessions: Record<string, SessionObserverCursor>,\n  ): Map<string, SessionObserverCursor> {\n    const next = new Map<string, SessionObserverCursor>();\n    for (const [sessionKey, value] of Object.entries(sessions)) {\n      if (!value || typeof value !== \"object\") continue;\n      next.set(sessionKey, {\n        sessionKey,\n        cursorBytes: sanitizeNonNegativeInt(value.cursorBytes),\n        cursorTokens: sanitizeNonNegativeInt(value.cursorTokens),\n        lastObservedAt:\n          typeof value.lastObservedAt === \"string\" ? value.lastObservedAt : new Date(0).toISOString(),\n        lastTriggeredAt: typeof value.lastTriggeredAt === \"string\" ? value.lastTriggeredAt : undefined,\n        lastResetAt: typeof value.lastResetAt === \"string\" ? value.lastResetAt : undefined,\n      });\n    }\n    return next;\n  }\n\n  constructor(opts: {\n    memoryDir: string;\n    debounceMs: number;\n    bands: SessionObserverBandConfig[];\n  }) {\n    this.statePath = path.join(opts.memoryDir, \"state\", \"session-observer-state.json\");\n    this.lockPath = path.join(opts.memoryDir, \"state\", \"session-observer-state.lock\");\n    this.debounceMs = Math.max(0, Math.floor(opts.debounceMs));\n    this.bands = normalizeObserverBands(opts.bands);\n  }\n\n  private async withSaveLock(fn: () => Promise<void>): Promise<void> {\n    await mkdir(path.dirname(this.lockPath), { recursive: true });\n    for (let attempt = 0; attempt < 80; attempt++) {\n      try {\n        const handle = await open(this.lockPath, \"wx\");\n        try {\n          await fn();\n        } finally {\n          await handle.close();\n          await unlink(this.lockPath).catch(() => {});\n        }\n        return;\n      } catch (err: any) {\n        if (err?.code !== \"EEXIST\") throw err;\n        try {\n          const lockInfo = await stat(this.lockPath);\n          if (Date.now() - lockInfo.mtimeMs > this.lockStaleMs) {\n            await unlink(this.lockPath).catch(() => {});\n            continue;\n          }\n        } catch {\n          // Lock might have been released between EEXIST and stat/read.\n        }\n        await new Promise((resolve) => setTimeout(resolve, 25));\n      }\n    }\n    const error = new Error(\"session observer save lock timeout\");\n    log.debug(error.message);\n    throw error;\n  }\n\n  async load(): Promise<void> {\n    const parsed = await this.readPersistedState();\n    if (!parsed) {\n      this.sessions.clear();\n      return;\n    }\n    this.sessions = this.normalizePersistedSessions(parsed.sessions);\n  }\n\n  async save(): Promise<void> {\n    await this.withSaveLock(async () => {\n      const merged = await this.readMergedSessions();\n      this.sessions = merged;\n\n      await this.writeSessions(merged);\n    });\n  }\n\n  private async readMergedSessions(): Promise<Map<string, SessionObserverCursor>> {\n    const merged = new Map<string, SessionObserverCursor>();\n    const persisted = await this.readPersistedState();\n    if (persisted) {\n      for (const [key, value] of this.normalizePersistedSessions(persisted.sessions).entries()) {\n        merged.set(key, value);\n      }\n    }\n    for (const [key, current] of this.sessions.entries()) {\n      const existing = merged.get(key);\n      if (!existing) {\n        merged.set(key, current);\n        continue;\n      }\n      merged.set(key, mergeSessionCursor(existing, current));\n    }\n    return merged;\n  }\n\n  private async writeSessions(sessionsMap: Map<string, SessionObserverCursor>): Promise<void> {\n    const sessions = Object.create(null) as Record<string, SessionObserverCursor>;\n    for (const [key, value] of sessionsMap.entries()) {\n      sessions[key] = value;\n    }\n    const payload: SessionObserverPersistedState = { version: 2, sessions };\n    await mkdir(path.dirname(this.statePath), { recursive: true });\n    await writeFile(this.statePath, JSON.stringify(payload, null, 2), \"utf-8\");\n  }\n\n  private enqueueObservation(\n    input: SessionObservationInput,\n  ): Promise<SessionObservationDecision> {\n    const operation = this.saveQueue\n      .catch(() => undefined)\n      .then(() => this.observeWithSaveLock(input));\n    this.saveQueue = operation.then(\n      () => undefined,\n      () => undefined,\n    );\n    return operation;\n  }\n\n  private bandForTotalBytes(totalBytes: number): SessionObserverBandConfig {\n    const bytes = sanitizeNonNegativeInt(totalBytes);\n    for (const band of this.bands) {\n      if (bytes <= band.maxBytes) return band;\n    }\n    return this.bands[this.bands.length - 1];\n  }\n\n  async observe(input: SessionObservationInput): Promise<SessionObservationDecision> {\n    return this.enqueueObservation(input);\n  }\n\n  private async observeWithSaveLock(\n    input: SessionObservationInput,\n  ): Promise<SessionObservationDecision> {\n    let decision: SessionObservationDecision | undefined;\n    await this.withSaveLock(async () => {\n      const localExisting = this.sessions.get(input.sessionKey);\n      const sessions = await this.readMergedSessions();\n      decision = await this.observeMerged(\n        input,\n        sessions,\n        localExisting ? { ...localExisting } : undefined,\n      );\n    });\n    if (!decision) {\n      throw new Error(\"session observer decision was not computed\");\n    }\n    return decision;\n  }\n\n  private async observeMerged(\n    input: SessionObservationInput,\n    sessions: Map<string, SessionObserverCursor>,\n    localExisting?: SessionObserverCursor,\n  ): Promise<SessionObservationDecision> {\n    const nowIso = input.observedAt ?? new Date().toISOString();\n    const totalBytes = sanitizeNonNegativeInt(input.totalBytes);\n    const totalTokens = sanitizeNonNegativeInt(input.totalTokens);\n    const band = this.bandForTotalBytes(totalBytes);\n\n    const existing = sessions.get(input.sessionKey);\n    if (!existing) {\n      sessions.set(input.sessionKey, {\n        sessionKey: input.sessionKey,\n        cursorBytes: totalBytes,\n        cursorTokens: totalTokens,\n        lastObservedAt: nowIso,\n      });\n      this.sessions = sessions;\n      await this.writeSessions(sessions);\n      return {\n        triggered: false,\n        deltaBytes: 0,\n        deltaTokens: 0,\n        band,\n        reason: \"baseline\",\n      };\n    }\n\n    const session = { ...existing };\n    const observedMs = parseIsoMs(nowIso);\n    const existingObservedMs = parseIsoMs(session.lastObservedAt);\n    const existingResetMs = parseIsoMs(session.lastResetAt);\n    if (existingResetMs > 0 && observedMs < existingResetMs) {\n      this.sessions = sessions;\n      return { triggered: false, deltaBytes: 0, deltaTokens: 0, band, reason: \"baseline\" };\n    }\n\n    if (totalBytes < session.cursorBytes || totalTokens < session.cursorTokens) {\n      const localSawReset =\n        localExisting !== undefined\n        && (totalBytes < sanitizeNonNegativeInt(localExisting.cursorBytes)\n          || totalTokens < sanitizeNonNegativeInt(localExisting.cursorTokens));\n      const canApplyReset = localSawReset && observedMs >= existingObservedMs;\n\n      if (canApplyReset) {\n        session.cursorBytes = totalBytes;\n        session.cursorTokens = totalTokens;\n        session.lastObservedAt = nowIso;\n        session.lastResetAt = nowIso;\n      } else if (observedMs >= existingObservedMs) {\n        session.lastObservedAt = nowIso;\n      }\n      sessions.set(input.sessionKey, session);\n      this.sessions = sessions;\n      await this.writeSessions(sessions);\n      return { triggered: false, deltaBytes: 0, deltaTokens: 0, band, reason: \"baseline\" };\n    }\n\n    const deltaBytes = totalBytes - session.cursorBytes;\n    const deltaTokens = totalTokens - session.cursorTokens;\n    const crossedThreshold =\n      (band.triggerDeltaBytes > 0 && deltaBytes >= band.triggerDeltaBytes)\n      || (band.triggerDeltaTokens > 0 && deltaTokens >= band.triggerDeltaTokens);\n    session.lastObservedAt = nowIso;\n\n    if (!crossedThreshold) {\n      const unchanged = deltaBytes === 0 && deltaTokens === 0;\n      if (!unchanged) {\n        sessions.set(input.sessionKey, session);\n        this.sessions = sessions;\n        await this.writeSessions(sessions);\n      } else {\n        this.sessions = sessions;\n      }\n      return {\n        triggered: false,\n        deltaBytes,\n        deltaTokens,\n        band,\n      };\n    }\n\n    const nowMs = Date.parse(nowIso);\n    const lastTriggeredMs = session.lastTriggeredAt ? Date.parse(session.lastTriggeredAt) : NaN;\n    const withinDebounce =\n      Number.isFinite(lastTriggeredMs) && nowMs - lastTriggeredMs < this.debounceMs;\n\n    if (withinDebounce) {\n      sessions.set(input.sessionKey, session);\n      this.sessions = sessions;\n      await this.writeSessions(sessions);\n      return {\n        triggered: false,\n        deltaBytes,\n        deltaTokens,\n        band,\n        reason: \"debounced\",\n      };\n    }\n\n    session.lastTriggeredAt = nowIso;\n    session.cursorBytes = totalBytes;\n    session.cursorTokens = totalTokens;\n    sessions.set(input.sessionKey, session);\n    this.sessions = sessions;\n    await this.writeSessions(sessions);\n    return {\n      triggered: true,\n      deltaBytes,\n      deltaTokens,\n      band,\n      reason: \"threshold\",\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-YLHM5BQQ.js → chunk-OLX2HJFW.js}

@@ -1,10 +1,10 @@
-import {
-  scanMemoryDir
-} from "./chunk-W7IGLX4G.js";
 import {
   isSearchAborted,
   throwIfSearchAborted
 } from "./chunk-GUMZC2BO.js";
+import {
+  scanMemoryDir
+} from "./chunk-W7IGLX4G.js";
 import {
   reportSearchDegradation,
   resolveEnsureCollectionArgs
@@ -613,4 +613,4 @@ export {
   resolveOramaCollectionDbFilePath,
   OramaBackend
 };
-//# sourceMappingURL=chunk-YLHM5BQQ.js.map
+//# sourceMappingURL=chunk-OLX2HJFW.js.map

package/dist/{chunk-DNC4A7RS.js → chunk-OU7RWWW6.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-KJTKLXTH.js";
 import {
   StorageManager
-} from "./chunk-YTZA7U6Q.js";
+} from "./chunk-2VHCLHZ5.js";
 import {
   copyExistingFileToBackup,
   writeFileAtomically
@@ -260,4 +260,4 @@ export {
   backupExistingLedger,
   rebuildMemoryLifecycleLedger
 };
-//# sourceMappingURL=chunk-DNC4A7RS.js.map
+//# sourceMappingURL=chunk-OU7RWWW6.js.map

package/dist/{chunk-L3LRWDJW.js → chunk-OV36CROW.js}

@@ -1,9 +1,9 @@
 import {
   NamespaceStorageRouter
-} from "./chunk-LIF6DO6U.js";
+} from "./chunk-MG7GI4TT.js";
 import {
   namespaceCollectionName
-} from "./chunk-SNW3YRO6.js";
+} from "./chunk-P6GOYLHN.js";
 import {
   isSafeRouteNamespace
 } from "./chunk-PCXDUHQH.js";
@@ -213,4 +213,4 @@ export {
   verifyNamespaces,
   runNamespaceMigration
 };
-//# sourceMappingURL=chunk-L3LRWDJW.js.map
+//# sourceMappingURL=chunk-OV36CROW.js.map

package/dist/{chunk-BXLOS5AJ.js → chunk-OWHERGF2.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-765K3SAT.js";
 import {
   encryptCapsuleFile
-} from "./chunk-DQEMWVMT.js";
+} from "./chunk-UVYI6VIX.js";
 import {
   computeTransferOutputRel,
   isTransferPathExcluded
@@ -109,4 +109,4 @@ async function enforceRetention(outDirAbs, retentionDays) {
 export {
   backupMemoryDir
 };
-//# sourceMappingURL=chunk-BXLOS5AJ.js.map
+//# sourceMappingURL=chunk-OWHERGF2.js.map

package/dist/{chunk-CSV34HIW.js → chunk-P5OYNV7B.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-YTZA7U6Q.js";
+} from "./chunk-2VHCLHZ5.js";
 import {
   normalizeEntityName
 } from "./chunk-YXZG5TVN.js";
@@ -956,4 +956,4 @@ export {
   resolveBriefingSaveDir,
   briefingFilename
 };
-//# sourceMappingURL=chunk-CSV34HIW.js.map
+//# sourceMappingURL=chunk-P5OYNV7B.js.map

package/dist/{chunk-SNW3YRO6.js → chunk-P6GOYLHN.js}

@@ -1,6 +1,6 @@
 import {
   createSearchBackend
-} from "./chunk-F7M36OG2.js";
+} from "./chunk-JNWISMYG.js";
 import {
   namespaceIdentityToken,
   normalizeNamespaceIdentity
@@ -470,4 +470,4 @@ export {
   NamespaceSearchRouter,
   normalizeQmdResultPath
 };
-//# sourceMappingURL=chunk-SNW3YRO6.js.map
+//# sourceMappingURL=chunk-P6GOYLHN.js.map