@remnic/core 9.6.28 → 9.6.30

package/dist/access-operations.d.ts

@@ -1,11 +1,11 @@
 import { BoundOperation } from './access-boundary.js';
 import { MemoryStoreRequest } from './access-schema.js';
-import { p as ArchitectureSurfaceRequest, q as ArchitectureSurfaceResponse, D as DecisionSurfaceRequest, r as DecisionSurfaceResponse, s as DeltaSurfaceRequest, t as DeltaSurfaceResponse, u as EngramAccessMemoryResponse, m as EngramAccessWriteResponse, v as CodegraphSurfaceRequest, w as CodegraphSurfaceResponse } from './access-service-DK7s3wMj.js';
+import { p as ArchitectureSurfaceRequest, q as ArchitectureSurfaceResponse, D as DecisionSurfaceRequest, r as DecisionSurfaceResponse, s as DeltaSurfaceRequest, t as DeltaSurfaceResponse, u as EngramAccessMemoryResponse, m as EngramAccessWriteResponse, v as CodegraphSurfaceRequest, w as CodegraphSurfaceResponse } from './access-service-BofDzaPT.js';
 import 'zod';
 import './catalog-9WanSGtt.js';
 import './types-DDUDgd7T.js';
 import './message-parts/index.js';
-import './orchestrator-BzXGNHco.js';
+import './orchestrator-CAH5-PKN.js';
 import './briefing.js';
 import './storage-DxPDAiU9.js';
 import './page-versioning.js';

package/dist/access-operations.js

@@ -22,9 +22,9 @@ import {
   memoryGetOperation,
   memorySearchOperation,
   memoryStoreOperation
-} from "./chunk-ARDRBJHD.js";
+} from "./chunk-C6TKSI35.js";
 import "./chunk-2MR3MFQB.js";
-import "./chunk-GXLFDLX2.js";
+import "./chunk-PUQZIS6A.js";
 import "./chunk-HLTAPHZZ.js";
 import "./chunk-YF6FMLBT.js";
 import "./chunk-PRTA6444.js";
@@ -32,9 +32,9 @@ import "./chunk-KQDNAXOM.js";
 import "./chunk-35NN3ZFA.js";
 import "./chunk-FTYDWKO6.js";
 import "./chunk-T4WDJPEZ.js";
-import "./chunk-MRQN5Q3I.js";
+import "./chunk-GQURC4B7.js";
 import "./chunk-D7FOKIY5.js";
-import "./chunk-YDF4HL3W.js";
+import "./chunk-OXVKR5OU.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-M5QKGHCR.js";
@@ -80,6 +80,7 @@ import "./chunk-MTWKDOVO.js";
 import "./chunk-O75CRYGF.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-ZGPDSEKG.js";
+import "./chunk-C37ZRXX7.js";
 import "./chunk-3ONXXHQO.js";
 import "./chunk-ODPLEWB6.js";
 import "./chunk-ZY2MNJR6.js";

package/dist/access-recall-surface.d.ts

@@ -1,11 +1,11 @@
 import { AccessAuditAdapter } from './access-audit.js';
 import { CrossNamespaceBudget } from './cross-namespace-budget.js';
-import { O as Orchestrator } from './orchestrator-BzXGNHco.js';
+import { O as Orchestrator } from './orchestrator-CAH5-PKN.js';
 import { LastRecallSnapshot } from './recall-state.js';
 import { RecallXraySnapshot } from './recall-xray.js';
 import { R as RecallDisclosure, b as RecallPlanMode, M as MemoryFile } from './types-DDUDgd7T.js';
 import { S as StorageManager } from './storage-DxPDAiU9.js';
-import { x as EngramAccessRecallResponse, y as EngramAccessMemorySummary, z as EngramAccessSetCodingContextRequest, B as EngramAccessRecallRequest } from './access-service-DK7s3wMj.js';
+import { x as EngramAccessRecallResponse, y as EngramAccessMemorySummary, z as EngramAccessSetCodingContextRequest, B as EngramAccessRecallRequest } from './access-service-BofDzaPT.js';
 import './recall-audit.js';
 import './recall-audit-anomaly.js';
 import './briefing.js';
@@ -204,7 +204,6 @@ interface AccessRecallSurfaceDeps {
         storage: StorageManager;
         dir: string;
     } | null>;
-    xrayQueue: Promise<void>;
 }
 declare class AccessRecallSurface {
     private readonly deps;
@@ -352,6 +351,8 @@ declare class AccessRecallSurface {
          * regular X-ray API/CLI/MCP surfaces keep their existing payload shape.
          */
         includeRecall?: boolean;
+        /** Cancel the capture before it starts and propagate cancellation to recall. */
+        abortSignal?: AbortSignal;
     }): Promise<{
         snapshotFound: boolean;
         snapshot?: RecallXraySnapshot;

package/dist/access-recall-surface.js

@@ -1,6 +1,6 @@
 import {
   AccessRecallSurface
-} from "./chunk-YDF4HL3W.js";
+} from "./chunk-OXVKR5OU.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-M5QKGHCR.js";
@@ -46,6 +46,7 @@ import "./chunk-MTWKDOVO.js";
 import "./chunk-O75CRYGF.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-ZGPDSEKG.js";
+import "./chunk-C37ZRXX7.js";
 import "./chunk-3ONXXHQO.js";
 import "./chunk-ODPLEWB6.js";
 import "./chunk-ZY2MNJR6.js";

package/dist/{access-service-DK7s3wMj.d.ts → access-service-BofDzaPT.d.ts}

@@ -1,6 +1,6 @@
 import { a as NamespaceRecord } from './catalog-9WanSGtt.js';
 import { P as PluginConfig, aF as CodingContext, u as MemoryCategory, J as DaySummaryResult, b as RecallPlanMode, R as RecallDisclosure, M as MemoryFile, x as MemoryLifecycleEvent, E as EntityFile, v as MemoryStatus, t as SourceConnectorProvenance, aG as DreamsStatusResult, D as DreamsPhase, a as DreamsRunResult } from './types-DDUDgd7T.js';
-import { R as ResolvedScopeProfilePlan, O as Orchestrator, I as IntentDebugSnapshot, G as GraphRecallSnapshot, P as PatternReinforcementResult, S as ScopeProfileLayerResolution, a as ScopeProfilePromotionResolution, W as WearablesService } from './orchestrator-BzXGNHco.js';
+import { R as ResolvedScopeProfilePlan, O as Orchestrator, I as IntentDebugSnapshot, G as GraphRecallSnapshot, P as PatternReinforcementResult, S as ScopeProfileLayerResolution, a as ScopeProfilePromotionResolution, W as WearablesService } from './orchestrator-CAH5-PKN.js';
 import { S as StorageManager } from './storage-DxPDAiU9.js';
 import { a as Peer, b as PeerProfile } from './types-B1VHaf2w.js';
 import { RecallExplainJsonPayload } from './recall-explain-renderer.js';
@@ -1907,12 +1907,13 @@ declare class EngramAccessService {
          * regular X-ray API/CLI/MCP surfaces keep their existing payload shape.
          */
         includeRecall?: boolean;
+        /** Cancel the capture before it starts and propagate cancellation to recall. */
+        abortSignal?: AbortSignal;
     }): Promise<{
         snapshotFound: boolean;
         snapshot?: RecallXraySnapshot;
         recall?: EngramAccessRecallResponse;
     }>;
-    private xrayQueue;
     memoryStore(request: EngramAccessMemoryStoreRequest, hooks?: {
         enforceWriteQuota?: () => void | Promise<void>;
     }): Promise<EngramAccessWriteResponse>;

package/dist/access-service.d.ts

@@ -1,10 +1,10 @@
-export { A as AccessProfilingReportRequest, a as AccessProfilingReportResponse, C as CodingScopedWriteInput, N as ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, O as EngramAccessActionConfidenceRequest, Q as EngramAccessActionConfidenceResponse, k as EngramAccessBriefingRequest, l as EngramAccessBriefingResponse, b as EngramAccessCapsuleListResponse, R as EngramAccessDaySummaryRequest, S as EngramAccessEntityListResponse, T as EngramAccessEntityResponse, U as EngramAccessEntitySummary, V as EngramAccessHealthResponse, G as EngramAccessInputError, W as EngramAccessLcmCompactionFlushRequest, X as EngramAccessLcmCompactionFlushResponse, Y as EngramAccessLcmCompactionRecordRequest, Z as EngramAccessLcmCompactionRecordResponse, d as EngramAccessLcmSearchRequest, e as EngramAccessLcmSearchResponse, _ as EngramAccessLcmStatusResponse, $ as EngramAccessMaintenanceResponse, a0 as EngramAccessMemoryBrowseRequest, a1 as EngramAccessMemoryBrowseResponse, a2 as EngramAccessMemoryRecord, u as EngramAccessMemoryResponse, i as EngramAccessMemoryStoreRequest, y as EngramAccessMemorySummary, a3 as EngramAccessObserveMessage, n as EngramAccessObserveRequest, o as EngramAccessObserveResponse, a4 as EngramAccessOfflineSyncApplyFileContentRequest, a5 as EngramAccessOfflineSyncApplyFileContentResponse, a6 as EngramAccessOfflineSyncApplyRequest, a7 as EngramAccessOfflineSyncApplyResponse, a8 as EngramAccessOfflineSyncFileContentRequest, a9 as EngramAccessOfflineSyncFileContentResponse, aa as EngramAccessOfflineSyncFilesRequest, ab as EngramAccessOfflineSyncFilesResponse, ac as EngramAccessOfflineSyncSnapshotRequest, ad as EngramAccessOfflineSyncSnapshotResponse, ae as EngramAccessOfflineSyncSnapshotStreamResponse, h as EngramAccessQmdCollectionState, g as EngramAccessQmdHealthResponse, af as EngramAccessQualityResponse, ag as EngramAccessRecallExplainRequest, ah as EngramAccessRecallExplainResponse, B as EngramAccessRecallRequest, x as EngramAccessRecallResponse, ai as EngramAccessReviewDispositionRequest, aj as EngramAccessReviewDispositionResponse, E as EngramAccessReviewQueueResponse, ak as EngramAccessScopeDebug, F as EngramAccessService, z as EngramAccessSetCodingContextRequest, j as EngramAccessSuggestionSubmitRequest, al as EngramAccessTimelineResponse, am as EngramAccessTrustZoneBrowseRequest, an as EngramAccessTrustZoneBrowseResponse, ao as EngramAccessTrustZoneDemoSeedRequest, ap as EngramAccessTrustZoneDemoSeedResponse, aq as EngramAccessTrustZonePromoteRequest, ar as EngramAccessTrustZonePromoteResponse, as as EngramAccessTrustZoneRecordSummary, at as EngramAccessTrustZoneStatusResponse, au as EngramAccessWriteEnvelope, m as EngramAccessWriteResponse, f as MemoryScopePlan, av as buildProjectedGovernanceProposedActions, aw as hasGroupedGovernanceActions, ax as shapeMemorySummary } from './access-service-DK7s3wMj.js';
+export { A as AccessProfilingReportRequest, a as AccessProfilingReportResponse, C as CodingScopedWriteInput, N as ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, O as EngramAccessActionConfidenceRequest, Q as EngramAccessActionConfidenceResponse, k as EngramAccessBriefingRequest, l as EngramAccessBriefingResponse, b as EngramAccessCapsuleListResponse, R as EngramAccessDaySummaryRequest, S as EngramAccessEntityListResponse, T as EngramAccessEntityResponse, U as EngramAccessEntitySummary, V as EngramAccessHealthResponse, G as EngramAccessInputError, W as EngramAccessLcmCompactionFlushRequest, X as EngramAccessLcmCompactionFlushResponse, Y as EngramAccessLcmCompactionRecordRequest, Z as EngramAccessLcmCompactionRecordResponse, d as EngramAccessLcmSearchRequest, e as EngramAccessLcmSearchResponse, _ as EngramAccessLcmStatusResponse, $ as EngramAccessMaintenanceResponse, a0 as EngramAccessMemoryBrowseRequest, a1 as EngramAccessMemoryBrowseResponse, a2 as EngramAccessMemoryRecord, u as EngramAccessMemoryResponse, i as EngramAccessMemoryStoreRequest, y as EngramAccessMemorySummary, a3 as EngramAccessObserveMessage, n as EngramAccessObserveRequest, o as EngramAccessObserveResponse, a4 as EngramAccessOfflineSyncApplyFileContentRequest, a5 as EngramAccessOfflineSyncApplyFileContentResponse, a6 as EngramAccessOfflineSyncApplyRequest, a7 as EngramAccessOfflineSyncApplyResponse, a8 as EngramAccessOfflineSyncFileContentRequest, a9 as EngramAccessOfflineSyncFileContentResponse, aa as EngramAccessOfflineSyncFilesRequest, ab as EngramAccessOfflineSyncFilesResponse, ac as EngramAccessOfflineSyncSnapshotRequest, ad as EngramAccessOfflineSyncSnapshotResponse, ae as EngramAccessOfflineSyncSnapshotStreamResponse, h as EngramAccessQmdCollectionState, g as EngramAccessQmdHealthResponse, af as EngramAccessQualityResponse, ag as EngramAccessRecallExplainRequest, ah as EngramAccessRecallExplainResponse, B as EngramAccessRecallRequest, x as EngramAccessRecallResponse, ai as EngramAccessReviewDispositionRequest, aj as EngramAccessReviewDispositionResponse, E as EngramAccessReviewQueueResponse, ak as EngramAccessScopeDebug, F as EngramAccessService, z as EngramAccessSetCodingContextRequest, j as EngramAccessSuggestionSubmitRequest, al as EngramAccessTimelineResponse, am as EngramAccessTrustZoneBrowseRequest, an as EngramAccessTrustZoneBrowseResponse, ao as EngramAccessTrustZoneDemoSeedRequest, ap as EngramAccessTrustZoneDemoSeedResponse, aq as EngramAccessTrustZonePromoteRequest, ar as EngramAccessTrustZonePromoteResponse, as as EngramAccessTrustZoneRecordSummary, at as EngramAccessTrustZoneStatusResponse, au as EngramAccessWriteEnvelope, m as EngramAccessWriteResponse, f as MemoryScopePlan, av as buildProjectedGovernanceProposedActions, aw as hasGroupedGovernanceActions, ax as shapeMemorySummary } from './access-service-BofDzaPT.js';
 import './storage-DxPDAiU9.js';
 import './types-B1VHaf2w.js';
 import './recall-explain-renderer.js';
 import './types-DDUDgd7T.js';
 import './recall-audit-anomaly.js';
-import './orchestrator-BzXGNHco.js';
+import './orchestrator-CAH5-PKN.js';
 import './explicit-capture.js';
 import './cross-namespace-budget.js';
 import './maintenance/memory-governance.js';

package/dist/access-service.js

@@ -5,7 +5,7 @@ import {
   buildProjectedGovernanceProposedActions,
   hasGroupedGovernanceActions,
   shapeMemorySummary
-} from "./chunk-YDF4HL3W.js";
+} from "./chunk-OXVKR5OU.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-M5QKGHCR.js";
@@ -51,6 +51,7 @@ import "./chunk-MTWKDOVO.js";
 import "./chunk-O75CRYGF.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-ZGPDSEKG.js";
+import "./chunk-C37ZRXX7.js";
 import "./chunk-3ONXXHQO.js";
 import "./chunk-ODPLEWB6.js";
 import "./chunk-ZY2MNJR6.js";

package/dist/access-surface-catalog.d.ts

@@ -1,10 +1,10 @@
 import { OperationName } from './access-boundary.js';
 import 'zod';
-import './access-service-DK7s3wMj.js';
+import './access-service-BofDzaPT.js';
 import './catalog-9WanSGtt.js';
 import './types-DDUDgd7T.js';
 import './message-parts/index.js';
-import './orchestrator-BzXGNHco.js';
+import './orchestrator-CAH5-PKN.js';
 import './briefing.js';
 import './storage-DxPDAiU9.js';
 import './page-versioning.js';

package/dist/bootstrap.d.ts

@@ -1,5 +1,5 @@
 import { P as PluginConfig } from './types-DDUDgd7T.js';
-import { O as Orchestrator } from './orchestrator-BzXGNHco.js';
+import { O as Orchestrator } from './orchestrator-CAH5-PKN.js';
 import './message-parts/index.js';
 import './briefing.js';
 import './storage-DxPDAiU9.js';

package/dist/{chunk-4273YO6I.js → chunk-3VSTTB74.js}

@@ -61,7 +61,7 @@ import {
 import {
   buildTargetedFactRecallSection,
   shouldRecallTargetedFactEvidence
-} from "./chunk-4SBW47WK.js";
+} from "./chunk-IRMLYBMU.js";
 import {
   buildTemporalTimelineRecallSection
 } from "./chunk-I6WYQSX4.js";
@@ -87,7 +87,7 @@ import {
 import {
   buildResponseGuidanceRecallSection,
   shouldRecallResponseGuidance
-} from "./chunk-L6W77GWW.js";
+} from "./chunk-XGSOXFD4.js";
 import {
   mergeWithAgentResults,
   runDirectAgent,
@@ -177,18 +177,18 @@ import {
 import {
   buildFocusedListRecallSection,
   shouldRecallFocusedListEvidence
-} from "./chunk-LZTFCAKE.js";
+} from "./chunk-BFU7H32D.js";
 import {
   buildEventOrderRecallSection,
   shouldRecallEventOrderEvidence
-} from "./chunk-FV5FVO2J.js";
+} from "./chunk-7O2JL5RY.js";
 import {
   pickFactEventTimeAnchor,
   resolveFactEventTime
 } from "./chunk-IAIPNEHD.js";
 import {
   buildExplicitCueRecallSection
-} from "./chunk-4463LUIE.js";
+} from "./chunk-77UPM7P3.js";
 import {
   formatDaySummaryMemories
 } from "./chunk-I73G4UH7.js";
@@ -323,7 +323,7 @@ import {
   createCorrectionService,
   detectPassiveCorrections,
   qmdCollectionPathParts
-} from "./chunk-YDF4HL3W.js";
+} from "./chunk-OXVKR5OU.js";
 import {
   importCapsule
 } from "./chunk-M5QKGHCR.js";
@@ -15511,6 +15511,61 @@ async function drainRecallWrites(owner) {
   }
 }
 
+// src/orchestration/xray-capture-queue.ts
+var XrayCaptureQueue = class {
+  tail = Promise.resolve();
+  async run(operation, state, signal) {
+    throwIfAborted(signal, "x-ray capture aborted before queueing");
+    const previous = this.tail;
+    let release = () => {
+    };
+    this.tail = new Promise((resolve) => {
+      release = resolve;
+    });
+    try {
+      await this.waitForTurn(previous, signal);
+    } catch (error) {
+      void previous.then(release, release);
+      throw error;
+    }
+    let previousSnapshot = null;
+    let didReadPreviousSnapshot = false;
+    try {
+      previousSnapshot = state.read();
+      didReadPreviousSnapshot = true;
+      const recallStartedAt = Date.now();
+      state.clear();
+      const result = await operation();
+      const snapshot = state.read();
+      if (!snapshot) state.restore(previousSnapshot);
+      return { result, snapshot, recallStartedAt };
+    } catch (error) {
+      if (didReadPreviousSnapshot) state.restore(previousSnapshot);
+      throw error;
+    } finally {
+      release();
+    }
+  }
+  async waitForTurn(previous, signal) {
+    throwIfAborted(signal, "x-ray capture aborted while queued");
+    if (!signal) {
+      await previous;
+      return;
+    }
+    let onAbort;
+    const aborted = new Promise((_resolve, reject) => {
+      onAbort = () => reject(abortError("x-ray capture aborted while queued"));
+      signal.addEventListener("abort", onAbort, { once: true });
+    });
+    try {
+      await Promise.race([previous, aborted]);
+      throwIfAborted(signal, "x-ray capture aborted while queued");
+    } finally {
+      if (onAbort) signal.removeEventListener("abort", onAbort);
+    }
+  }
+};
+
 // src/orchestrator.ts
 var Orchestrator = class {
   storage;
@@ -15592,6 +15647,8 @@ var Orchestrator = class {
    * capturing caller can still read their snapshot back.
    */
   lastXraySnapshot = null;
+  /** Per-instance ordering domain for every writer of `lastXraySnapshot`. */
+  xrayCaptureQueue = new XrayCaptureQueue();
   embeddingFallback;
   conversationIndexDir;
   extraction;
@@ -16751,7 +16808,7 @@ ${doc.content}` : doc.content,
   async validateLocalLlmModel() {
     return this.workspaceOpsCoordinator.validateLocalLlmModel();
   }
-  async recall(prompt, sessionKey, options = {}) {
+  invokeRecall(prompt, sessionKey, options = {}) {
     return (this.recallEntryCoordinator ?? new RecallEntryCoordinator(
       selfDeps(this)
     )).recall(
@@ -16760,21 +16817,64 @@ ${doc.content}` : doc.content,
       options
     );
   }
+  async recall(prompt, sessionKey, options = {}) {
+    if (options.xrayCapture === true) {
+      const { result } = await this.runRecallWithXrayCapture(
+        prompt,
+        sessionKey,
+        options
+      );
+      return result;
+    }
+    return this.invokeRecall(prompt, sessionKey, options);
+  }
   /**
-   * Return the most recent X-ray snapshot captured during a
-   * `recall()` call that passed `xrayCapture: true` (issue #570 PR 1).
+   * Return the most recent X-ray snapshot captured during a recall.
    * Returns `null` when no such capture has occurred on this
    * orchestrator instance.  Returned snapshot is a deep copy so
    * caller mutation cannot tear the stored value.
+   *
+   * @deprecated Reading this after a separate `recall()` is not atomic. Use
+   * `recallWithXrayCapture()` when the snapshot must belong to that call.
    */
   getLastXraySnapshot() {
     if (!this.lastXraySnapshot) return null;
     return structuredClone(this.lastXraySnapshot);
   }
-  /** Clear the captured X-ray snapshot.  Exposed for tests / explicit reset. */
+  /**
+   * Clear the captured X-ray snapshot. Exposed for tests / explicit reset.
+   *
+   * @deprecated A separate clear → recall → get sequence is not atomic. Use
+   * `recallWithXrayCapture()` for capture operations.
+   */
   clearLastXraySnapshot() {
     this.lastXraySnapshot = null;
   }
+  /** Atomically run recall and return the cloned X-ray snapshot it published. */
+  async recallWithXrayCapture(prompt, sessionKey, options = {}) {
+    return this.runRecallWithXrayCapture(
+      prompt,
+      sessionKey,
+      options,
+      options.abortSignal
+    );
+  }
+  async runRecallWithXrayCapture(prompt, sessionKey, options, queueAbortSignal) {
+    return this.xrayCaptureQueue.run(
+      () => this.invokeRecall(prompt, sessionKey, {
+        ...options,
+        xrayCapture: true
+      }),
+      {
+        read: () => this.getLastXraySnapshot(),
+        clear: () => this.clearLastXraySnapshot(),
+        restore: (snapshot) => {
+          this.lastXraySnapshot = snapshot;
+        }
+      },
+      queueAbortSignal
+    );
+  }
   async waitForDirectAnswerObservationIdle(timeoutMs = 6e4) {
     return this.recallIntrospection.waitForDirectAnswerObservationIdle(
       timeoutMs
@@ -22992,4 +23092,4 @@ export {
   blendGraphExpandedRecallScore,
   Orchestrator
 };
-//# sourceMappingURL=chunk-4273YO6I.js.map
+//# sourceMappingURL=chunk-3VSTTB74.js.map