@remnic/core 9.3.712 → 9.3.714

package/dist/{chunk-A2R5NV6O.js → chunk-CTAHKIG6.js}

@@ -1,22 +1,33 @@
 import {
   AdapterRegistry
-} from "./chunk-JBPKEARU.js";
+} from "./chunk-AU7Q3LSC.js";
 import {
   WearablesInputError
 } from "./chunk-7WV3F5DQ.js";
 import {
-  EngramMcpServer
-} from "./chunk-I3BT2IDW.js";
+  ChatEngine,
+  EngramMcpServer,
+  appendTranscriptEntry,
+  createChatExecutor,
+  createChatSession,
+  createProductionChatLlmAdapter,
+  loadChatSession,
+  markPendingPlan,
+  markPendingPromotion,
+  markPlanResolved,
+  markPromotionResolved,
+  sessionBelongsToPrincipal
+} from "./chunk-SYDHFFAW.js";
 import {
   validateRequest
-} from "./chunk-NUWZFSKC.js";
+} from "./chunk-FVZ2ISIX.js";
 import {
   getOperation
-} from "./chunk-ZVDRL6SK.js";
+} from "./chunk-HHLWSWWF.js";
 import {
   CorrectionContractError,
   EngramAccessInputError
-} from "./chunk-YVWZW37D.js";
+} from "./chunk-BNOAB5HH.js";
 import {
   projectTagProjectId
 } from "./chunk-SHRRWOVY.js";
@@ -28,7 +39,7 @@ import {
 } from "./chunk-DEUNUKTD.js";
 import {
   isRecallDisclosure
-} from "./chunk-BOGENF7P.js";
+} from "./chunk-MSVSP5VO.js";
 import {
   OFFLINE_SYNC_APPLY_MAX_BODY_BYTES,
   OFFLINE_SYNC_FILE_CONTENT_MAX_CHUNK_BYTES,
@@ -50,6 +61,130 @@ import { readFile } from "fs/promises";
 import path from "path";
 import { fileURLToPath, URL } from "url";
 import { gunzipSync } from "zlib";
+
+// src/chat/chat-http.ts
+async function handleChatMessage(req, res, body, opts, principal) {
+  if (!opts.config?.enabled) {
+    respondJson(res, 404, { error: "chat_disabled", code: "chat_disabled" });
+    return;
+  }
+  const message = typeof body.message === "string" ? body.message : "";
+  if (!message) {
+    respondJson(res, 400, { error: "message is required", code: "input_error" });
+    return;
+  }
+  const llm = opts.service.fallbackLlmRef ?? opts.service.localLlmRef;
+  if (!llm) {
+    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) {
+      respondJson(res, 404, { error: "chat_session_not_found", code: "chat_session_not_found" });
+      return;
+    }
+    if (!sessionBelongsToPrincipal(session, principal)) {
+      respondJson(res, 403, { error: "access_denied", code: "access_denied" });
+      return;
+    }
+  } 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);
+  }
+  const wireResult = result.error ? { reply: result.reply, chatSessionId: result.chatSessionId, ...result.pendingPlan ? { pendingPlan: result.pendingPlan } : {} } : result;
+  respondJson(res, 200, wireResult);
+}
+async function handleChatEventsSSE(req, res, chatSessionId, opts, principal) {
+  if (!opts.config?.enabled) {
+    respondJson(res, 404, { error: "chat_disabled", code: "chat_disabled" });
+    return;
+  }
+  const session = await loadChatSession(opts.memoryDir, chatSessionId);
+  if (!session) {
+    respondJson(res, 404, { error: "chat_session_not_found", code: "chat_session_not_found" });
+    return;
+  }
+  if (!sessionBelongsToPrincipal(session, principal)) {
+    respondJson(res, 403, { error: "access_denied", code: "access_denied" });
+    return;
+  }
+  res.writeHead(200, {
+    "content-type": "text/event-stream",
+    "cache-control": "no-cache",
+    connection: "keep-alive"
+  });
+  for (const entry of session.transcript) {
+    res.write(`data: ${JSON.stringify(entry)}
+
+`);
+  }
+  const heartbeat = setInterval(() => {
+    try {
+      res.write(`data: ${JSON.stringify({ type: "heartbeat" })}
+
+`);
+    } catch {
+    }
+  }, 25e3);
+  heartbeat.unref();
+  req.on("close", () => {
+    clearInterval(heartbeat);
+    try {
+      res.end();
+    } catch {
+    }
+  });
+}
+function respondJson(res, status, body) {
+  const json = JSON.stringify(body);
+  res.writeHead(status, {
+    "content-type": "application/json; charset=utf-8",
+    "content-length": Buffer.byteLength(json, "utf8")
+  });
+  res.end(json);
+}
+
+// src/access-http.ts
 function resolveDefaultAdminConsolePublicDir() {
   const thisDir = path.dirname(fileURLToPath(import.meta.url));
   const candidates = [
@@ -211,6 +346,7 @@ var EngramAccessHttpServer = class {
       architectureCardVisible: this.service.architectureCardSurfaceVisible,
       codegraphVisible: this.service.codegraphSurfaceVisible,
       sessionDeltaVisible: this.service.sessionDeltaSurfaceVisible,
+      chatVisible: this.service.configRef?.chat?.enabled === true,
       correctionVisible: this.service.correctionSurfaceVisible
     });
   }
@@ -913,24 +1049,37 @@ var EngramAccessHttpServer = class {
     if (req.method === "POST" && pathname === "/engram/v1/observe") {
       void getOperation("observe");
       const body = await this.readValidatedBody(req, "observe");
-      this.ensureWriteRateLimitAvailable();
-      const response = await this.service.observe({
-        sessionKey: body.sessionKey,
-        messages: body.messages.map((message) => ({
-          role: message.role,
-          content: message.content,
-          sourceFormat: message.sourceFormat ?? void 0,
-          rawContent: message.rawContent ?? void 0,
-          parts: message.parts ?? void 0
-        })),
-        namespace: this.resolveNamespace(req, body.namespace),
-        authenticatedPrincipal: this.resolveRequestPrincipal(req),
-        skipExtraction: body.skipExtraction === true,
-        // Forward cwd/projectTag for auto git-context resolution (issue #569).
-        cwd: body.cwd,
-        projectTag: body.projectTag
-      });
-      this.recordWriteRateLimitHit();
+      const response = await this.service.observe(
+        {
+          sessionKey: body.sessionKey,
+          messages: body.messages.map((message) => ({
+            role: message.role,
+            content: message.content,
+            sourceFormat: message.sourceFormat ?? void 0,
+            rawContent: message.rawContent ?? void 0,
+            parts: message.parts ?? void 0
+          })),
+          namespace: this.resolveNamespace(req, body.namespace),
+          authenticatedPrincipal: this.resolveRequestPrincipal(req),
+          skipExtraction: body.skipExtraction === true,
+          // Issue #1649: optional server-side dedup key for retried POSTs.
+          idempotencyKey: body.idempotencyKey,
+          // Forward cwd/projectTag for auto git-context resolution (issue #569).
+          cwd: body.cwd,
+          projectTag: body.projectTag
+        },
+        // Enforce the write-quota INSIDE the service's idempotency lock
+        // (beforeExecute, only on a real miss). A retried observe that hits the
+        // replay path must NOT be rejected with 429 — that is exactly the
+        // response-lost-after-process case the dedup exists for. The original
+        // attempt may have consumed the last quota slot; the retry returns the
+        // cached response without requiring another. Matches memory_store's
+        // hook-in-the-lock pattern (#1434 invariant).
+        { enforceWriteQuota: () => this.ensureWriteRateLimitAvailable() }
+      );
+      if (this.shouldCountWriteRateLimit(response)) {
+        this.recordWriteRateLimitHit();
+      }
       this.respondJson(res, 202, response);
       return;
     }
@@ -1148,12 +1297,13 @@ var EngramAccessHttpServer = class {
     if (req.method === "GET" && memoryMatch) {
       const memoryId = decodeURIComponent(memoryMatch[1] ?? "");
       const namespace = parsed.searchParams.get("namespace") ?? void 0;
+      const sessionKey = this.resolveRequestIdentity(req).sessionKey ?? parsed.searchParams.get("session") ?? parsed.searchParams.get("sessionKey") ?? void 0;
       const op = getOperation("memory_get");
       if (!op) {
         throw new EngramAccessInputError("access-boundary: operation not registered: memory_get");
       }
       const output = await op.run(
-        { memoryId, namespace: namespace ?? null },
+        { memoryId, namespace: namespace ?? null, sessionKey: sessionKey ?? null },
         { service: this.service, authenticatedPrincipal: this.resolveRequestPrincipal(req) }
       );
       const response = output.result;
@@ -1551,6 +1701,30 @@ var EngramAccessHttpServer = class {
       await this.handleGraphEventsSSE(req, res);
       return;
     }
+    if (req.method === "POST" && pathname === "/engram/v1/chat/message") {
+      void getOperation("chat_message");
+      const body = await this.readJsonBody(req);
+      await handleChatMessage(
+        req,
+        res,
+        body,
+        { service: this.service, config: this.service.configRef?.chat, memoryDir: this.service.memoryDir },
+        this.resolveRequestPrincipal(req)
+      );
+      return;
+    }
+    const chatEventsMatch = /^\/engram\/v1\/chat\/events\/([^/]+)$/.exec(pathname);
+    if (req.method === "GET" && chatEventsMatch) {
+      void getOperation("chat_events");
+      await handleChatEventsSSE(
+        req,
+        res,
+        chatEventsMatch[1] ?? "",
+        { service: this.service, config: this.service.configRef?.chat, memoryDir: this.service.memoryDir },
+        this.resolveRequestPrincipal(req)
+      );
+      return;
+    }
     if (req.method === "GET" && pathname === "/engram/v1/console/state") {
       void getOperation("console_state");
       const namespace = parsed.searchParams.get("namespace") ?? void 0;
@@ -1961,7 +2135,8 @@ var EngramAccessHttpServer = class {
     const isCodegraphManageAdr = toolName === "engram.codegraph_manage_adr" || toolName === "remnic.codegraph_manage_adr";
     const codegraphWrite = CODEGRAPH_WRITE_TOOLS.has(toolName) || isCodegraphManageAdr && (toolArgsSubcommand === "record" || toolArgsSubcommand === "supersede");
     const isMcpWrite = request.method === "tools/call" && (toolName === "engram.memory_store" || toolName === "remnic.memory_store" || toolName === "engram.suggestion_submit" || toolName === "remnic.suggestion_submit" || toolName === "engram.observe" || toolName === "remnic.observe" || toolName === "engram.lcm_compaction_flush" || toolName === "remnic.lcm_compaction_flush" || toolName === "engram.lcm_compaction_record" || toolName === "remnic.lcm_compaction_record" || toolName === "engram.capsule_export" || toolName === "remnic.capsule_export" || toolName === "engram.capsule_import" || toolName === "remnic.capsule_import" || !dreamsRunDryRun && (toolName === "engram.dreams_run" || toolName === "remnic.dreams_run") || !memoryActionApplyDryRun && (toolName === "engram.memory_action_apply" || toolName === "remnic.memory_action_apply") || (toolName === "engram.memory_correct_apply" || toolName === "remnic.memory_correct_apply" || toolName === "engram.memory_correct_plan" || toolName === "remnic.memory_correct_plan") || codingDecisionWrite || codingArchitectureWrite || codegraphWrite);
-    if (isMcpWrite) {
+    const observeSelfEnforcesQuota = toolName === "engram.observe" || toolName === "remnic.observe";
+    if (isMcpWrite && !observeSelfEnforcesQuota) {
       this.ensureWriteRateLimitAvailable();
     }
     const sessionId = (() => {
@@ -1975,7 +2150,8 @@ var EngramAccessHttpServer = class {
       namespaceOverride: requestIdentity.namespace,
       sessionKeyOverride: requestIdentity.sessionKey,
       sessionId,
-      correlationId: mcpCorrelationId
+      correlationId: mcpCorrelationId,
+      enforceWriteQuota: observeSelfEnforcesQuota ? () => this.ensureWriteRateLimitAvailable() : void 0
     });
     if (isMcpWrite && response !== null) {
       const result = response.result;
@@ -2350,4 +2526,4 @@ function positiveIntQueryParam(value, label) {
 export {
   EngramAccessHttpServer
 };
-//# sourceMappingURL=chunk-A2R5NV6O.js.map
+//# sourceMappingURL=chunk-CTAHKIG6.js.map