@remnic/core 9.3.712 → 9.3.714

package/dist/{chunk-YVWZW37D.js → chunk-BNOAB5HH.js}

@@ -22,7 +22,7 @@ import {
 } from "./chunk-H7XKCNR6.js";
 import {
   toRecallExplainJson
-} from "./chunk-5QUS24F7.js";
+} from "./chunk-I56LKMF7.js";
 import {
   buildProposedActions,
   buildQualityScore,
@@ -30,7 +30,7 @@ import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   runMemoryGovernance
-} from "./chunk-XKU4YE6Z.js";
+} from "./chunk-XZTUMWKQ.js";
 import {
   clusterByKey,
   combineNamespaces,
@@ -58,10 +58,10 @@ import {
 } from "./chunk-FF4KLI5W.js";
 import {
   estimateRecallTokens
-} from "./chunk-OWOKOFXK.js";
+} from "./chunk-AJOIM6UR.js";
 import {
   namespaceCollectionName
-} from "./chunk-K22IJO4R.js";
+} from "./chunk-CTOQEZSN.js";
 import {
   namespaceIdentityFromToken
 } from "./chunk-ZFXCQPNO.js";
@@ -91,7 +91,7 @@ import {
   persistExplicitCapture,
   queueExplicitCaptureForReview,
   validateExplicitCaptureInput
-} from "./chunk-HV57RHMD.js";
+} from "./chunk-EH5ED3C6.js";
 import {
   CrossNamespaceBudget
 } from "./chunk-ODPLEWB6.js";
@@ -107,10 +107,10 @@ import {
   buildBriefing,
   parseBriefingFocus,
   parseBriefingWindow
-} from "./chunk-35YJ6KCV.js";
+} from "./chunk-JEIROMLX.js";
 import {
   parseEntityFile
-} from "./chunk-JSDZMOT7.js";
+} from "./chunk-OC56UWV5.js";
 import {
   stripAttributesSuffix
 } from "./chunk-SVOZFLIQ.js";
@@ -120,7 +120,7 @@ import {
 import {
   DEFAULT_RECALL_DISCLOSURE,
   isRecallDisclosure
-} from "./chunk-BOGENF7P.js";
+} from "./chunk-MSVSP5VO.js";
 import {
   inferMemoryStatus,
   toMemoryPathRel
@@ -170,6 +170,9 @@ import {
 import {
   log
 } from "./chunk-NU3CSQ4H.js";
+import {
+  isHandleToken
+} from "./chunk-JAKIDQB2.js";
 import {
   AccessAuditAdapter
 } from "./chunk-TVVEYCNW.js";
@@ -6463,10 +6466,11 @@ var EngramAccessService = class {
       throw new EngramAccessInputError(message);
     }
   }
-  async memoryGet(memoryId, namespace, principal) {
+  async memoryGet(memoryId, namespace, principal, sessionKey) {
+    const resolvedId = this.resolveMemoryIdOrHandleInput(memoryId, sessionKey);
     const resolvedNamespace = this.resolveReadableNamespace(namespace, principal);
     const storage = await this.orchestrator.getStorage(resolvedNamespace);
-    const memory = await storage.getMemoryById(memoryId);
+    const memory = await storage.getMemoryById(resolvedId);
     if (!memory) {
       return { found: false, namespace: resolvedNamespace };
     }
@@ -6718,7 +6722,30 @@ var EngramAccessService = class {
     this._correctionService = service;
     return service;
   }
+  /**
+   * Issue #1582 — resolve a single memoryId-or-handle reference to a concrete
+   * memory id. Handles resolve against the session's recall history via the
+   * orchestrator's shared helper (rule 22); raw ids pass through unchanged. A
+   * handle that misses or is ambiguous becomes an EngramAccessInputError so the
+   * boundary maps it to a 400 (rule 34/51 — list candidates, never guess).
+   */
+  resolveMemoryIdOrHandleInput(ref, sessionKey) {
+    if (!isHandleToken(ref)) return ref;
+    try {
+      return this.orchestrator.resolveMemoryIdOrHandle(ref, sessionKey);
+    } catch (err) {
+      throw new EngramAccessInputError(
+        err instanceof Error ? err.message : String(err)
+      );
+    }
+  }
   async correctionPlan(request) {
+    if (request.targetIds?.some((id) => isHandleToken(id))) {
+      const targetIds = request.targetIds.map(
+        (id) => this.resolveMemoryIdOrHandleInput(id, request.sessionKey)
+      );
+      return this.correctionService().plan({ ...request, targetIds });
+    }
     return this.correctionService().plan(request);
   }
   async correctionApply(planId, opts) {
@@ -7439,7 +7466,30 @@ var EngramAccessService = class {
   serializeMemorySummary(memory, baseDir, disclosure, rawExcerpts) {
     return shapeMemorySummary(memory, baseDir, disclosure, rawExcerpts);
   }
-  async observe(request) {
+  async observe(request, hooks) {
+    const idempotencyKey = request.idempotencyKey?.trim();
+    let effectiveCodingContext;
+    if (idempotencyKey && !(typeof request.namespace === "string" && request.namespace.trim().length > 0)) {
+      effectiveCodingContext = (typeof this.orchestrator.getCodingContextForSession === "function" ? this.orchestrator.getCodingContextForSession(request.sessionKey) : null) ?? await this.resolveCodingContextFromOptions(request);
+    }
+    return this.handleIdempotentWrite({
+      operation: "observe",
+      idempotencyKey: request.idempotencyKey,
+      requestFingerprint: {
+        sessionKey: request.sessionKey,
+        messages: request.messages,
+        namespace: request.namespace,
+        skipExtraction: request.skipExtraction,
+        authenticatedPrincipal: request.authenticatedPrincipal,
+        cwd: request.cwd,
+        projectTag: request.projectTag,
+        effectiveCodingContext: effectiveCodingContext ?? null
+      },
+      beforeExecute: hooks?.enforceWriteQuota,
+      execute: () => this.runObserve(request)
+    });
+  }
+  async runObserve(request) {
     if (!request.sessionKey || typeof request.sessionKey !== "string" || request.sessionKey.trim().length === 0) {
       throw new EngramAccessInputError("sessionKey is required and must be a non-empty string");
     }
@@ -9701,4 +9751,4 @@ export {
   shapeMemorySummary,
   EngramAccessService
 };
-//# sourceMappingURL=chunk-YVWZW37D.js.map
+//# sourceMappingURL=chunk-BNOAB5HH.js.map