@remnic/core 9.3.726 → 9.3.727

package/dist/{chunk-PLG6JHQS.js → chunk-MJIHJ7OG.js}

@@ -7,35 +7,30 @@ import {
 import {
   openclawReplayNormalizer
 } from "./chunk-7F7Z6MOS.js";
+import {
+  exportSqlite
+} from "./chunk-7VFZTJ7K.js";
 import {
   importMarkdownBundle
 } from "./chunk-HDDRVXX4.js";
 import {
   importSqlite
 } from "./chunk-AGNBY3VG.js";
-import {
-  backupMemoryDir
-} from "./chunk-OWHERGF2.js";
-import {
-  exportJsonBundle
-} from "./chunk-UP6MOYCB.js";
-import {
-  exportSqlite
-} from "./chunk-7VFZTJ7K.js";
 import {
   detectImportFormat
 } from "./chunk-OZKVVUJB.js";
 import {
   importJsonBundle
 } from "./chunk-2DL3OFLD.js";
+import {
+  backupMemoryDir
+} from "./chunk-2NLLXCJG.js";
+import {
+  exportJsonBundle
+} from "./chunk-UP6MOYCB.js";
 import {
   exportMarkdownBundle
 } from "./chunk-765K3SAT.js";
-import {
-  buildReplayNormalizerRegistry,
-  clampBatchSize,
-  runReplay
-} from "./chunk-HOJZMQ4J.js";
 import {
   TailscaleHelper
 } from "./chunk-EEC4PCG5.js";
@@ -43,22 +38,27 @@ import {
   WebDavServer
 } from "./chunk-PYIFUBRK.js";
 import {
-  migrateObservations
-} from "./chunk-D6RIFG4O.js";
-import {
-  rebuildMemoryLifecycleLedger
-} from "./chunk-6WAJQKBS.js";
+  buildReplayNormalizerRegistry,
+  clampBatchSize,
+  runReplay
+} from "./chunk-HOJZMQ4J.js";
 import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "./chunk-V7CMKMHM.js";
+} from "./chunk-Y4YD5TYW.js";
 import {
   rebuildObservations
 } from "./chunk-LZZNTPLR.js";
 import {
   archiveObservations
 } from "./chunk-WMWVO45V.js";
+import {
+  migrateObservations
+} from "./chunk-D6RIFG4O.js";
+import {
+  rebuildMemoryLifecycleLedger
+} from "./chunk-JYLFZWUX.js";
 import {
   getBulkImportSource,
   listBulkImportSources,
@@ -70,18 +70,18 @@ import {
 } from "./chunk-GQL52GQ5.js";
 import {
   promoteSemanticRuleFromMemory
-} from "./chunk-FO3HO52S.js";
+} from "./chunk-4H4F3BFL.js";
 import {
   buildResumeBundleFromState,
   getResumeBundleStatus,
   recordResumeBundle
-} from "./chunk-5NWYQUQC.js";
+} from "./chunk-HOHVIVDR.js";
 import {
   resolveAgentAccessAuthToken
 } from "./chunk-TGQ2NTWH.js";
 import {
   parseXrayCliOptions
-} from "./chunk-ZOHMPFOB.js";
+} from "./chunk-CKFLLAIS.js";
 import {
   collectPatternMemories,
   explainPatternMemory,
@@ -98,12 +98,12 @@ import {
   runOperatorInventory,
   runOperatorRepair,
   runOperatorSetup
-} from "./chunk-UKTDXTWX.js";
+} from "./chunk-NSA5ZRUL.js";
 import {
   listNamespaces,
   runNamespaceMigration,
   verifyNamespaces
-} from "./chunk-7NS7AWMZ.js";
+} from "./chunk-DKJCRGWM.js";
 import {
   GraphDashboardServer
 } from "./chunk-EZ25VE3G.js";
@@ -116,7 +116,7 @@ import {
 } from "./chunk-WIWPSQYU.js";
 import {
   searchVerifiedEpisodes
-} from "./chunk-NPL7VDM6.js";
+} from "./chunk-ASKXIAHD.js";
 import {
   getUtilityLearningStatus,
   learnUtilityPromotionWeights
@@ -130,7 +130,7 @@ import {
 } from "./chunk-QRDOSYOR.js";
 import {
   searchVerifiedSemanticRules
-} from "./chunk-BB57OZWC.js";
+} from "./chunk-UVPL565C.js";
 import {
   getWorkProductLedgerStatus,
   recordWorkProductLedgerEntry,
@@ -145,7 +145,7 @@ import {
 } from "./chunk-33JBK2XP.js";
 import {
   formatNamespaceMaintenanceHealthText
-} from "./chunk-K4ZNARDO.js";
+} from "./chunk-CBWI22JN.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -209,13 +209,13 @@ import {
 } from "./chunk-UQ7RN5HK.js";
 import {
   parseConfig
-} from "./chunk-BIA7ELIB.js";
+} from "./chunk-36SEDFAU.js";
 import {
   getAbstractionNodeStoreStatus
 } from "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-2NBP25BG.js";
+} from "./chunk-N3VNUM4Z.js";
 import {
   WearablesInputError
 } from "./chunk-7WV3F5DQ.js";
@@ -228,10 +228,10 @@ import {
   createProductionChatLlmAdapter,
   loadChatSession,
   sessionBelongsToPrincipal
-} from "./chunk-TQQH2FTX.js";
+} from "./chunk-6PY5YJAV.js";
 import {
   EngramAccessService
-} from "./chunk-Q6D75LVH.js";
+} from "./chunk-27QQC7ZX.js";
 import {
   WorkStorage
 } from "./chunk-GDB4J2H3.js";
@@ -243,13 +243,13 @@ import {
   parseRecallExplainFormat,
   renderRecallExplain,
   renderXray
-} from "./chunk-6SQQOJ4U.js";
+} from "./chunk-GKRLPHPU.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   restoreMemoryGovernanceRun,
   runMemoryGovernance
-} from "./chunk-BEUCACTV.js";
+} from "./chunk-4NOI577P.js";
 import {
   getTrustZoneStoreStatus,
   promoteTrustZoneRecord,
@@ -274,7 +274,7 @@ import {
 import {
   RECALL_DISCLOSURE_LEVELS,
   isRecallDisclosure
-} from "./chunk-7AG54AF3.js";
+} from "./chunk-PUR2CKX2.js";
 import {
   RECALL_FALLBACK_DIRS
 } from "./chunk-VS2IYZRU.js";
@@ -4133,7 +4133,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
           }
         }
         if (sourceArchive.endsWith(".enc")) {
-          const { isEncryptedCapsuleFile } = await import("./capsule-crypto-GWVG7LGC.js");
+          const { isEncryptedCapsuleFile } = await import("./capsule-crypto-7FJQINUR.js");
           const encDetected = await isEncryptedCapsuleFile(sourceArchive).catch(() => true);
           if (encDetected) {
             throw new Error(
@@ -4296,7 +4296,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
           const { parseExportBundle } = await import("./transfer/types.js");
           let decryptedBuf;
           try {
-            const { decryptCapsuleFileInMemory } = await import("./capsule-crypto-GWVG7LGC.js");
+            const { decryptCapsuleFileInMemory } = await import("./capsule-crypto-7FJQINUR.js");
             decryptedBuf = await decryptCapsuleFileInMemory(archivePath, memoryDir);
           } catch (decErr) {
             const msg = decErr instanceof Error ? decErr.message : String(decErr);
@@ -7505,4 +7505,4 @@ export {
   listMemoryMarkdownFilePaths,
   registerCli
 };
-//# sourceMappingURL=chunk-PLG6JHQS.js.map
+//# sourceMappingURL=chunk-MJIHJ7OG.js.map

package/dist/{chunk-TA3Y6GEX.js → chunk-MLKWJOAJ.js}

@@ -10,7 +10,7 @@ import {
 import {
   planNamespaceMaintenance,
   runNamespaceMaintenanceBatchPlan
-} from "./chunk-YTZ3VGC7.js";
+} from "./chunk-M4V2JVSZ.js";
 import {
   resolveHomeDir
 } from "./chunk-JUC24CTX.js";
@@ -441,4 +441,4 @@ var MaintenanceScheduler = class {
 export {
   MaintenanceScheduler
 };
-//# sourceMappingURL=chunk-TA3Y6GEX.js.map
+//# sourceMappingURL=chunk-MLKWJOAJ.js.map

package/dist/{chunk-2NBP25BG.js → chunk-N3VNUM4Z.js}

@@ -5,31 +5,25 @@ import {
   WearablesInputError
 } from "./chunk-7WV3F5DQ.js";
 import {
-  ChatEngine,
   EngramMcpServer,
-  appendTranscriptEntry,
-  createChatExecutor,
-  createChatSession,
-  createProductionChatLlmAdapter,
+  cleanupExpiredChatSessions,
   loadChatSession,
-  markPendingPlan,
-  markPendingPromotion,
-  markPlanResolved,
-  markPromotionResolved,
-  sessionBelongsToPrincipal
-} from "./chunk-TQQH2FTX.js";
+  processChatMessage,
+  sessionBelongsToPrincipal,
+  subscribeChatTranscript
+} from "./chunk-6PY5YJAV.js";
 import {
   validateRequest
-} from "./chunk-3TUT4PWB.js";
+} from "./chunk-FVZ2ISIX.js";
 import {
   getOperation
-} from "./chunk-5OOA7SGX.js";
+} from "./chunk-R7IYU5DZ.js";
 import {
   EngramAccessInputError
-} from "./chunk-Q6D75LVH.js";
+} from "./chunk-27QQC7ZX.js";
 import {
   CorrectionContractError
-} from "./chunk-EZNDNMRH.js";
+} from "./chunk-AQLOP5F4.js";
 import {
   isTrustZoneName
 } from "./chunk-JGSKJHF7.js";
@@ -41,7 +35,7 @@ import {
 } from "./chunk-DEUNUKTD.js";
 import {
   isRecallDisclosure
-} from "./chunk-7AG54AF3.js";
+} from "./chunk-PUR2CKX2.js";
 import {
   OFFLINE_SYNC_APPLY_MAX_BODY_BYTES,
   OFFLINE_SYNC_FILE_CONTENT_MAX_CHUNK_BYTES,
@@ -65,6 +59,28 @@ import { fileURLToPath, URL } from "url";
 import { gunzipSync } from "zlib";
 
 // src/chat/chat-http.ts
+import { createHash } from "crypto";
+var chatInFlight = /* @__PURE__ */ new Map();
+function principalFingerprintComponent(principal) {
+  return principal === void 0 ? "\0absent" : `
${principal}`;
+}
+function chatDedupFingerprint(memoryDir, chatSessionId, principal, message) {
+  const messageHash = createHash("sha256").update(message, "utf8").digest("hex").slice(0, 32);
+  return `${memoryDir}:${chatSessionId}:${principalFingerprintComponent(principal)}:${messageHash}`;
+}
+function processChatMessageDedup(opts) {
+  if (!opts.chatSessionId) {
+    return processChatMessage(opts);
+  }
+  const fp = chatDedupFingerprint(opts.memoryDir, opts.chatSessionId, opts.principal, opts.message);
+  const existing = chatInFlight.get(fp);
+  if (existing) return existing;
+  const pending = processChatMessage(opts).finally(() => {
+    chatInFlight.delete(fp);
+  });
+  chatInFlight.set(fp, pending);
+  return pending;
+}
 async function handleChatMessage(req, res, body, opts, principal) {
   if (!opts.config?.enabled) {
     respondJson(res, 404, { error: "chat_disabled", code: "chat_disabled" });
@@ -75,63 +91,43 @@ async function handleChatMessage(req, res, body, opts, principal) {
     respondJson(res, 400, { error: "message is required", code: "input_error" });
     return;
   }
-  const llm = opts.service.fallbackLlmRef ?? opts.service.localLlmRef;
-  if (!llm) {
+  if (!opts.service.fallbackLlmRef && !opts.service.localLlmRef) {
     respondJson(res, 503, {
       error: "No LLM model is available. Configure a local or cloud model.",
       code: "no_llm"
     });
     return;
   }
-  const adapter = createProductionChatLlmAdapter(llm);
-  const requestedSessionId = typeof body.chatSessionId === "string" ? body.chatSessionId : void 0;
-  let session;
-  if (requestedSessionId) {
-    session = await loadChatSession(opts.memoryDir, requestedSessionId);
-    if (!session) {
+  const chatSessionId = typeof body.chatSessionId === "string" ? body.chatSessionId : void 0;
+  let result;
+  try {
+    result = await processChatMessageDedup({
+      service: opts.service,
+      config: opts.config,
+      memoryDir: opts.memoryDir,
+      message,
+      ...chatSessionId ? { chatSessionId } : {},
+      ...principal ? { principal } : {}
+    });
+  } catch (err) {
+    const code = err instanceof Error ? err.message : String(err);
+    if (code === "chat_session_not_found") {
       respondJson(res, 404, { error: "chat_session_not_found", code: "chat_session_not_found" });
-      return;
-    }
-    if (!sessionBelongsToPrincipal(session, principal)) {
+    } else if (code === "access_denied") {
       respondJson(res, 403, { error: "access_denied", code: "access_denied" });
-      return;
+    } else if (code === "chat_session_expired") {
+      respondJson(res, 410, { error: "chat_session_expired", code: "chat_session_expired" });
+    } else if (code === "chat_disabled") {
+      respondJson(res, 404, { error: "chat_disabled", code: "chat_disabled" });
+    } else if (code === "no_llm_available" || code === "engine_unavailable") {
+      respondJson(res, 503, {
+        error: "No LLM model is available. Configure a local or cloud model.",
+        code: "no_llm"
+      });
+    } else {
+      respondJson(res, 500, { error: "internal_error", code: "internal_error" });
     }
-  } else {
-    session = await createChatSession(opts.memoryDir, { principal });
-  }
-  const executor = createChatExecutor({
-    service: opts.service,
-    principal,
-    ...session.namespace ? { namespace: session.namespace } : {},
-    ...session.sessionKey ? { sessionKey: session.sessionKey } : {}
-  });
-  const engine = new ChatEngine({
-    llm: adapter,
-    executor,
-    maxToolCallsPerTurn: opts.config.maxToolCallsPerTurn,
-    ...opts.config.model ? { model: opts.config.model } : {},
-    correctionAvailable: false,
-    scopeInspectAvailable: false
-  });
-  await appendTranscriptEntry(opts.memoryDir, session.id, {
-    role: "user",
-    content: message
-  });
-  const priorPendingPlanId = session.pendingPlanId;
-  const priorPendingPromotionId = session.pendingPromotionId;
-  const result = await engine.processMessage(message, session);
-  await appendTranscriptEntry(opts.memoryDir, session.id, {
-    role: "assistant",
-    content: result.reply
-  });
-  if (result.pendingPlan?.planId) {
-    await markPendingPlan(opts.memoryDir, session.id, result.pendingPlan.planId);
-  } else if (session.pendingPromotionId && !priorPendingPromotionId) {
-    await markPendingPromotion(opts.memoryDir, session.id, session.pendingPromotionId);
-  } else if (priorPendingPlanId && !session.pendingPlanId && !result.error) {
-    await markPlanResolved(opts.memoryDir, session.id, priorPendingPlanId);
-  } else if (priorPendingPromotionId && !session.pendingPromotionId && !result.error) {
-    await markPromotionResolved(opts.memoryDir, session.id, priorPendingPromotionId);
+    return;
   }
   const wireResult = result.error ? { reply: result.reply, chatSessionId: result.chatSessionId, ...result.pendingPlan ? { pendingPlan: result.pendingPlan } : {} } : result;
   respondJson(res, 200, wireResult);
@@ -141,12 +137,55 @@ async function handleChatEventsSSE(req, res, chatSessionId, opts, principal) {
     respondJson(res, 404, { error: "chat_disabled", code: "chat_disabled" });
     return;
   }
+  let heartbeat;
+  let closed = false;
+  const writeSse = (chunk) => {
+    if (closed) return false;
+    try {
+      res.write(chunk);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  const pending = [];
+  let bursting = true;
+  const unsubscribe = subscribeChatTranscript(opts.memoryDir, chatSessionId, (entry) => {
+    if (closed) return;
+    if (bursting) {
+      pending.push(entry);
+      return;
+    }
+    writeSse(`data: ${JSON.stringify(entry)}
+
+`);
+  });
+  const doCleanup = () => {
+    closed = true;
+    clearInterval(heartbeat);
+    unsubscribe();
+    try {
+      res.end();
+    } catch {
+    }
+  };
+  const unregisterServerCleanup = opts.registerSseCleanup?.(doCleanup) ?? (() => {
+  });
+  req.on("close", () => {
+    doCleanup();
+    unregisterServerCleanup();
+  });
   const session = await loadChatSession(opts.memoryDir, chatSessionId);
+  if (closed) return;
   if (!session) {
+    unsubscribe();
+    unregisterServerCleanup();
     respondJson(res, 404, { error: "chat_session_not_found", code: "chat_session_not_found" });
     return;
   }
   if (!sessionBelongsToPrincipal(session, principal)) {
+    unsubscribe();
+    unregisterServerCleanup();
     respondJson(res, 403, { error: "access_denied", code: "access_denied" });
     return;
   }
@@ -155,27 +194,29 @@ async function handleChatEventsSSE(req, res, chatSessionId, opts, principal) {
     "cache-control": "no-cache",
     connection: "keep-alive"
   });
+  writeSse("retry: 5000\n\n");
+  const deliveredSeqs = /* @__PURE__ */ new Set();
   for (const entry of session.transcript) {
-    res.write(`data: ${JSON.stringify(entry)}
+    writeSse(`data: ${JSON.stringify(entry)}
 
 `);
+    deliveredSeqs.add(entry.seq);
   }
-  const heartbeat = setInterval(() => {
-    try {
-      res.write(`data: ${JSON.stringify({ type: "heartbeat" })}
+  bursting = false;
+  for (const entry of pending) {
+    if (!deliveredSeqs.has(entry.seq)) {
+      writeSse(`data: ${JSON.stringify(entry)}
 
 `);
-    } catch {
     }
+  }
+  if (closed) return;
+  heartbeat = setInterval(() => {
+    writeSse(`data: ${JSON.stringify({ type: "heartbeat" })}
+
+`);
   }, 25e3);
-  heartbeat.unref();
-  req.on("close", () => {
-    clearInterval(heartbeat);
-    try {
-      res.end();
-    } catch {
-    }
-  });
+  heartbeat.unref?.();
 }
 function respondJson(res, status, body) {
   const json = JSON.stringify(body);
@@ -324,6 +365,12 @@ var EngramAccessHttpServer = class {
    * (Cursor review thread `access-http.ts:232`).
    */
   sseCleanupFns = /* @__PURE__ */ new Set();
+  /**
+   * Periodic chat-session TTL sweep handle (issue #1685 item 1 /
+   * #1687 Thread 21).  unref'd so it never blocks process exit
+   * (rule 47); cleared in `stop()`.
+   */
+  chatTtlTimer = null;
   constructor(options) {
     this.service = options.service;
     this.host = options.host?.trim() || "127.0.0.1";
@@ -409,10 +456,15 @@ var EngramAccessHttpServer = class {
     this.server = server;
     const address = server.address();
     this.boundPort = typeof address === "object" && address ? address.port : this.requestedPort;
+    this.scheduleChatSessionTtlSweep();
     return this.status();
   }
   async stop() {
     if (!this.server) return;
+    if (this.chatTtlTimer) {
+      clearInterval(this.chatTtlTimer);
+      this.chatTtlTimer = null;
+    }
     const server = this.server;
     this.server = null;
     this.boundPort = 0;
@@ -439,6 +491,31 @@ var EngramAccessHttpServer = class {
       server.close((err) => err ? reject(err) : resolve());
     });
   }
+  /**
+   * Schedule the chat-session TTL sweep: one immediate pass plus a
+   * recurring hourly pass (issue #1685 item 1 / #1687 Thread 21).  Both
+   * are skipped when chat is disabled.  The recurring timer is unref'd
+   * so it never keeps the event loop alive on its own (rule 47).  The
+   * sweep itself is best-effort — cleanup failures are swallowed inside
+   * `cleanupExpiredChatSessions`.
+   */
+  scheduleChatSessionTtlSweep() {
+    if (this.chatTtlTimer) {
+      clearInterval(this.chatTtlTimer);
+      this.chatTtlTimer = null;
+    }
+    const chat = this.service.configRef?.chat;
+    if (!chat?.enabled) return;
+    const ttlHours = typeof chat.sessionTtlHours === "number" && chat.sessionTtlHours > 0 ? chat.sessionTtlHours : 72;
+    void cleanupExpiredChatSessions(this.service.memoryDir, ttlHours).catch(() => {
+    });
+    const SWEEP_INTERVAL_MS = 60 * 60 * 1e3;
+    this.chatTtlTimer = setInterval(() => {
+      void cleanupExpiredChatSessions(this.service.memoryDir, ttlHours).catch(() => {
+      });
+    }, SWEEP_INTERVAL_MS);
+    this.chatTtlTimer.unref?.();
+  }
   status() {
     return {
       running: this.server !== null,
@@ -1731,7 +1808,22 @@ var EngramAccessHttpServer = class {
         req,
         res,
         chatEventsMatch[1] ?? "",
-        { service: this.service, config: this.service.configRef?.chat, memoryDir: this.service.memoryDir },
+        {
+          service: this.service,
+          config: this.service.configRef?.chat,
+          memoryDir: this.service.memoryDir,
+          // Register the chat-SSE disconnect cleanup with this server's
+          // stop() set so an HTTP shutdown forcibly releases the heartbeat
+          // and transcript subscription even when a lingering client never
+          // emits 'close' (cursor Medium review; mirrors handleGraphEventsSSE
+          // which registers in sseCleanupFns at access-http.ts:2604).
+          registerSseCleanup: (cleanup) => {
+            this.sseCleanupFns.add(cleanup);
+            return () => {
+              this.sseCleanupFns.delete(cleanup);
+            };
+          }
+        },
         this.resolveRequestPrincipal(req)
       );
       return;
@@ -2537,4 +2629,4 @@ function positiveIntQueryParam(value, label) {
 export {
   EngramAccessHttpServer
 };
-//# sourceMappingURL=chunk-2NBP25BG.js.map
+//# sourceMappingURL=chunk-N3VNUM4Z.js.map