@remnic/core 9.48.0 → 9.49.0

package/dist/corpus-read-cancellation.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Cancellation contract for the shared full-corpus read primitives (issue #2307).
+ *
+ * `readAllArtifactsCached`, `readAllEntityFiles`, `readAllMemories`, and the
+ * artifact source-status snapshot each walk and parse an entire memory tree. Issue
+ * #2291 bounded the recall providers that call them, so a timed-out recall returns
+ * on time — but the scan underneath kept running, and for the primitives without
+ * in-flight coalescing every abandoned request started another one. On a large or
+ * network-mounted store those pile up into sustained I/O no live request needs.
+ *
+ * The mechanism is a plain optional parameter, not ambient async context: these
+ * primitives have dozens of callers across extraction, maintenance, wearables, and
+ * coding surfaces, and an ambient signal would silently attach a request's
+ * cancellation to background work that merely shares its async context. An
+ * explicit parameter is greppable, and a caller that does not opt in behaves
+ * exactly as before.
+ *
+ * Two invariants bind every implementation:
+ *
+ *  1. **Checked before the cache lookup.** A caller that has already given up gets
+ *     an `AbortError`, warm cache or not — the same contract the recall providers
+ *     follow, so cancellation never depends on cache state.
+ *  2. **A cancelled read never publishes.** Every checkpoint throws, so control
+ *     leaves before the cache write. A partial corpus must never be cached, or
+ *     served, as if it were complete.
+ */
+interface CorpusReadOptions {
+    /**
+     * Stops the read at its next directory, batch, or attempt boundary. A single
+     * in-flight file read is not interrupted; the boundaries are what bound the
+     * work, and on a tree large enough to matter there are thousands of them.
+     */
+    abortSignal?: AbortSignal;
+}
+/** Stop a corpus read at a scan boundary when its caller has given up. */
+declare function checkCorpusReadAbort(options?: CorpusReadOptions): void;
+
+export { type CorpusReadOptions, checkCorpusReadAbort };

package/dist/corpus-read-cancellation.js

@@ -0,0 +1,9 @@
+import {
+  checkCorpusReadAbort
+} from "./chunk-5GINB5LC.js";
+import "./chunk-BTTPKDIL.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  checkCorpusReadAbort
+};
+//# sourceMappingURL=corpus-read-cancellation.js.map

package/dist/corpus-read-cancellation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/corpus-watermark.js

@@ -9,34 +9,34 @@ import {
   computeServiceCorpusWatermarks,
   digestPartitionCensus,
   resolveCorpusNamespaceRoots
-} from "./chunk-JYPO7L3G.js";
-import "./chunk-PELT6ADC.js";
-import "./chunk-PRVJH7CY.js";
-import "./chunk-FJ2ND6CZ.js";
-import "./chunk-XL3TATMJ.js";
-import "./chunk-VANZKHTN.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-YLHM5BQQ.js";
+} from "./chunk-CNQQMB67.js";
+import "./chunk-5AGR7SAI.js";
+import "./chunk-BMCHFWGX.js";
+import "./chunk-5JRC6BYS.js";
 import "./chunk-VYISFWVX.js";
-import "./chunk-W7IGLX4G.js";
 import "./chunk-GWFSVJ4P.js";
+import "./chunk-JHMAYABJ.js";
+import "./chunk-G5OB4XZX.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-OLX2HJFW.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-ANCC3JJH.js";
+import "./chunk-W7IGLX4G.js";
+import "./chunk-C3KVFJH5.js";
 import "./chunk-227UFSEQ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-3ONXXHQO.js";
-import "./chunk-PLCZD3LG.js";
+import "./chunk-EY64JLOM.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-ENTCVTQR.js";
 import "./chunk-SXIMQLGV.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-3S63QIFQ.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-JYIJNNN3.js";
@@ -46,10 +46,11 @@ import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-YXZG5TVN.js";
+import "./chunk-5GINB5LC.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-7YKVM5H3.js";
-import "./chunk-IJ7HK452.js";
-import "./chunk-PDJTHRAW.js";
+import "./chunk-RHTO4HTL.js";
+import "./chunk-KMAP7SNQ.js";
+import "./chunk-RBOJCG4T.js";
 import "./chunk-NZBZ7IS2.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";

package/dist/dashboard-runtime.js

@@ -1,8 +1,8 @@
 import {
   GraphDashboardServer
-} from "./chunk-YNDLCWXS.js";
-import "./chunk-AUDJPF4N.js";
+} from "./chunk-EZ25VE3G.js";
 import "./chunk-44442YCH.js";
+import "./chunk-AUDJPF4N.js";
 import "./chunk-Y4Z4I6WK.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/entity-retrieval.d.ts

@@ -1,5 +1,6 @@
-import { S as StorageManager } from './storage-COL907QF.js';
+import { S as StorageManager } from './storage-D1apCiCS.js';
 import { P as PluginConfig, T as TranscriptEntry } from './types-D_Au9qJO.js';
+import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';

package/dist/entity-retrieval.js

@@ -3,20 +3,20 @@ import {
   entityIndexVersion,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-4WBGZYZZ.js";
+} from "./chunk-EYAIZBLM.js";
 import "./chunk-5AUY5Z5E.js";
 import "./chunk-SVH57F5Z.js";
 import "./chunk-2DQ2XREU.js";
-import "./chunk-PLCZD3LG.js";
+import "./chunk-EY64JLOM.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-ENTCVTQR.js";
 import "./chunk-SXIMQLGV.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-3S63QIFQ.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-JYIJNNN3.js";
@@ -26,10 +26,11 @@ import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-YXZG5TVN.js";
+import "./chunk-5GINB5LC.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-7YKVM5H3.js";
-import "./chunk-IJ7HK452.js";
-import "./chunk-PDJTHRAW.js";
+import "./chunk-RHTO4HTL.js";
+import "./chunk-KMAP7SNQ.js";
+import "./chunk-RBOJCG4T.js";
 import "./chunk-NZBZ7IS2.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";

package/dist/explicit-capture.d.ts

@@ -1,4 +1,4 @@
-import { O as Orchestrator } from './orchestrator-B7nLo4z1.js';
+import { O as Orchestrator } from './orchestrator-Haa9xVPV.js';
 import { w as MemoryCategory, x as CaptureMode, P as PluginConfig } from './types-D_Au9qJO.js';
 import './recall-state.js';
 import './utils/serialize-mutations.js';
@@ -9,7 +9,8 @@ import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './types-continuity.js';
 import './briefing.js';
-import './storage-COL907QF.js';
+import './storage-D1apCiCS.js';
+import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './entity-id-normalization.js';
 import './page-versioning.js';
@@ -29,7 +30,7 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-BfcuwfJS.js';
+import './maintenance-j7sfNQdK.js';
 import './catalog-Iwbk9h5E.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
@@ -79,7 +80,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-TddhF0y7.js';
 import './replay/types.js';
-import './service-B5W5IYCx.js';
+import './service-Da_BI4S8.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';

package/dist/external-wiki-access.d.ts

@@ -1,7 +1,7 @@
 import { BoundOperation } from './access-boundary.js';
 import { ExternalWikiSearchResult, ExternalWikiSearchInput } from './external-wiki-search.js';
 import 'zod';
-import './access-service-andNjwfD.js';
+import './access-service-DvXOzCrM.js';
 import './catalog-Iwbk9h5E.js';
 import './types-D_Au9qJO.js';
 import './message-parts/index.js';
@@ -13,7 +13,8 @@ import './access-namespace-preflight--H6HwN85.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './scope-profiles-APjhSe-w.js';
-import './storage-COL907QF.js';
+import './storage-D1apCiCS.js';
+import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './entity-id-normalization.js';
 import './page-versioning.js';
@@ -39,7 +40,7 @@ import './corpus-watermark.js';
 import './replica-divergence.js';
 import './recall-audit-anomaly.js';
 import './recall-audit.js';
-import './orchestrator-B7nLo4z1.js';
+import './orchestrator-Haa9xVPV.js';
 import './briefing.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
@@ -50,7 +51,7 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-BfcuwfJS.js';
+import './maintenance-j7sfNQdK.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -94,7 +95,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-TddhF0y7.js';
 import './replay/types.js';
-import './service-B5W5IYCx.js';
+import './service-Da_BI4S8.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';

package/dist/external-wiki-access.js

@@ -1,12 +1,12 @@
 import {
   externalWikiSearchOperation
-} from "./chunk-NXUJRXSF.js";
+} from "./chunk-B6KGGRUL.js";
 import "./chunk-7T4TOGMS.js";
 import "./chunk-7YQ6ESEA.js";
-import "./chunk-45OTV7FZ.js";
+import "./chunk-IXPKESVP.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
-import "./chunk-A4JMGKCD.js";
+import "./chunk-R5IGA2NH.js";
 import "./chunk-VQ7B2Q6M.js";
 import "./chunk-PJSK6OJM.js";
 import "./chunk-GNVZQ5JN.js";
@@ -19,13 +19,13 @@ import "./chunk-H7XKCNR6.js";
 import "./chunk-SXWHN7GC.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-P2OTGMTR.js";
-import "./chunk-RSPSHRZA.js";
+import "./chunk-MZZR3J6M.js";
 import "./chunk-CVILPI77.js";
 import "./chunk-ICP53SKG.js";
 import "./chunk-AQEJKOKI.js";
 import "./chunk-6HMYUWXR.js";
-import "./chunk-EIR5VLIH.js";
 import "./chunk-IISBCCWR.js";
+import "./chunk-EIR5VLIH.js";
 import "./chunk-JYIFGGEM.js";
 import "./chunk-EI6V5UXY.js";
 import "./chunk-X4IDNPOS.js";
@@ -36,44 +36,44 @@ import "./chunk-QDW3E4RD.js";
 import "./chunk-LTHVM4XN.js";
 import "./chunk-S5NZBKKQ.js";
 import "./chunk-C37ZRXX7.js";
-import "./chunk-JYPO7L3G.js";
-import "./chunk-PELT6ADC.js";
-import "./chunk-PRVJH7CY.js";
-import "./chunk-FJ2ND6CZ.js";
-import "./chunk-XL3TATMJ.js";
-import "./chunk-VANZKHTN.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-YLHM5BQQ.js";
+import "./chunk-CNQQMB67.js";
+import "./chunk-5AGR7SAI.js";
+import "./chunk-BMCHFWGX.js";
+import "./chunk-5JRC6BYS.js";
 import "./chunk-VYISFWVX.js";
-import "./chunk-W7IGLX4G.js";
 import "./chunk-GWFSVJ4P.js";
+import "./chunk-JHMAYABJ.js";
+import "./chunk-G5OB4XZX.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-OLX2HJFW.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-ANCC3JJH.js";
+import "./chunk-W7IGLX4G.js";
+import "./chunk-C3KVFJH5.js";
 import "./chunk-227UFSEQ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-3ONXXHQO.js";
 import "./chunk-UFGFMWAD.js";
-import "./chunk-WOEVJKKQ.js";
+import "./chunk-SMPVHGHG.js";
 import "./chunk-ZY2MNJR6.js";
-import "./chunk-G2RBWVFQ.js";
+import "./chunk-Z4U6U3M3.js";
 import "./chunk-KSXJOC4F.js";
 import "./chunk-L2DPF4DF.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
 import "./chunk-W4FBGYGK.js";
-import "./chunk-3NDN5P55.js";
-import "./chunk-PLCZD3LG.js";
+import "./chunk-MXPB6PJQ.js";
+import "./chunk-EY64JLOM.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-ENTCVTQR.js";
 import "./chunk-SXIMQLGV.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-3S63QIFQ.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-JYIJNNN3.js";
@@ -83,10 +83,11 @@ import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-YXZG5TVN.js";
+import "./chunk-5GINB5LC.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-7YKVM5H3.js";
-import "./chunk-IJ7HK452.js";
-import "./chunk-PDJTHRAW.js";
+import "./chunk-RHTO4HTL.js";
+import "./chunk-KMAP7SNQ.js";
+import "./chunk-RBOJCG4T.js";
 import "./chunk-NZBZ7IS2.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";
@@ -121,9 +122,9 @@ import "./chunk-Z7L72ZHL.js";
 import "./chunk-4O4TKIXQ.js";
 import "./chunk-ZBJMUXZH.js";
 import "./chunk-TBBDFYXW.js";
-import "./chunk-KQAFEZQX.js";
+import "./chunk-VDX2J7OX.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-X7Y7WX73.js";
+import "./chunk-DQEMWVMT.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
@@ -172,9 +173,9 @@ import "./chunk-2Z24E5W2.js";
 import "./chunk-BTTPKDIL.js";
 import "./chunk-A2IYSXDQ.js";
 import "./chunk-LPSF4OQH.js";
-import "./chunk-7K5Q6COX.js";
-import "./chunk-LBLXEFWK.js";
+import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
+import "./chunk-LBLXEFWK.js";
 import "./chunk-JIYDRBVZ.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-XQ3HXAQH.js";

package/dist/external-wiki-mcp-tools.d.ts

@@ -1,6 +1,6 @@
 import { McpTool } from './access-mcp.js';
 import 'node:stream';
-import './access-service-andNjwfD.js';
+import './access-service-DvXOzCrM.js';
 import './catalog-Iwbk9h5E.js';
 import './types-D_Au9qJO.js';
 import './message-parts/index.js';
@@ -12,7 +12,8 @@ import './access-namespace-preflight--H6HwN85.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './scope-profiles-APjhSe-w.js';
-import './storage-COL907QF.js';
+import './storage-D1apCiCS.js';
+import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './entity-id-normalization.js';
 import './page-versioning.js';
@@ -38,7 +39,7 @@ import './corpus-watermark.js';
 import './replica-divergence.js';
 import './recall-audit-anomaly.js';
 import './recall-audit.js';
-import './orchestrator-B7nLo4z1.js';
+import './orchestrator-Haa9xVPV.js';
 import './briefing.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
@@ -49,7 +50,7 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-BfcuwfJS.js';
+import './maintenance-j7sfNQdK.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -94,7 +95,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-TddhF0y7.js';
 import './replay/types.js';
-import './service-B5W5IYCx.js';
+import './service-Da_BI4S8.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';

package/dist/extraction.js

@@ -12,8 +12,8 @@ import "./chunk-L6CQ7WIW.js";
 import "./chunk-WKDFJXW5.js";
 import "./chunk-JUXOTY6J.js";
 import "./chunk-NK5RGJ65.js";
-import "./chunk-J7T4MX7P.js";
 import "./chunk-4POAMKV6.js";
+import "./chunk-J7T4MX7P.js";
 import "./chunk-WAS4HV46.js";
 import {
   classifyExtractionThrownError,
@@ -30,18 +30,18 @@ import "./chunk-PNRA7FAD.js";
 import "./chunk-EMDLM3LW.js";
 import "./chunk-NLE6TSLG.js";
 import "./chunk-QDW3E4RD.js";
-import "./chunk-G2RBWVFQ.js";
+import "./chunk-Z4U6U3M3.js";
 import "./chunk-KSXJOC4F.js";
-import "./chunk-PLCZD3LG.js";
+import "./chunk-EY64JLOM.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-ENTCVTQR.js";
 import "./chunk-SXIMQLGV.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-3S63QIFQ.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-JYIJNNN3.js";
@@ -51,10 +51,11 @@ import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-YXZG5TVN.js";
+import "./chunk-5GINB5LC.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-7YKVM5H3.js";
-import "./chunk-IJ7HK452.js";
-import "./chunk-PDJTHRAW.js";
+import "./chunk-RHTO4HTL.js";
+import "./chunk-KMAP7SNQ.js";
+import "./chunk-RBOJCG4T.js";
 import "./chunk-NZBZ7IS2.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";

package/dist/in-flight-reads.d.ts

@@ -5,7 +5,51 @@ import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './types-continuity.js';
 
-declare function getInFlightRead(baseDir: string, keyId?: string): Promise<MemoryFile[]> | undefined;
+/**
+ * A reader's attachment to a shared scan. `leave()` is idempotent per reader and
+ * must be called when that reader stops waiting — because its own signal fired, or
+ * because the scan settled.
+ */
+interface CoalescedScanWaiter {
+    leave(): void;
+}
+/**
+ * Cancellation lifecycle for a coalesced corpus scan (issue #2307).
+ *
+ * The rule is reference counting, not ownership: **the scan is cancelled when its
+ * LAST waiter leaves, and never before.** One reader can therefore not cancel work
+ * another still needs, and two readers that both give up do not leave a full disk
+ * scan running for nobody — which was the abandoned I/O this whole change exists to
+ * remove.
+ *
+ * On the last leave the slot is withdrawn from the registry BEFORE the controller
+ * fires, so a reader arriving later cannot attach to a promise already doomed to
+ * reject with an `AbortError` it never asked for; it starts a fresh scan instead.
+ */
+interface CoalescedScan extends CoalescedScanWaiter {
+    /** The signal the shared scan itself observes. */
+    readonly scanSignal: AbortSignal;
+    /** Publish the scan to the registry and arm cancellation. */
+    arm(read: Promise<MemoryFile[]>): void;
+}
+/**
+ * Attach to an existing scan for (baseDir, keyId), or `undefined` when none is in
+ * flight. The caller MUST `leave()` once it stops awaiting the returned promise.
+ */
+declare function attachInFlightReader(baseDir: string, keyId?: string, callerSignal?: AbortSignal): {
+    read: Promise<MemoryFile[]>;
+    waiter: CoalescedScanWaiter;
+} | undefined;
+/** Start a cancellable coalesced scan as its first waiter. */
+declare function beginCoalescedScan(baseDir: string, keyId: string, callerSignal?: AbortSignal): CoalescedScan;
+/**
+ * Register a scan promise directly, with no cancellation attached.
+ *
+ * For callers that own a promise rather than a scan they can abort — tests that
+ * seed a stale in-flight read, and any future producer outside `beginCoalescedScan`.
+ * The entry has no `cancel`, so waiters leaving is a no-op: an externally-owned
+ * promise is not this module's to abort.
+ */
 declare function setInFlightRead(baseDir: string, keyId: string, read: Promise<MemoryFile[]>): void;
 /**
  * Delete the in-flight slot for one (baseDir, keyId). When `expected` is given,
@@ -20,4 +64,4 @@ declare function deleteInFlightRead(baseDir: string, keyId?: string, expected?:
 declare function deleteInFlightReadsForDir(baseDir: string): void;
 declare function clearInFlightReads(): void;
 
-export { clearInFlightReads, deleteInFlightRead, deleteInFlightReadsForDir, getInFlightRead, setInFlightRead };
+export { type CoalescedScan, type CoalescedScanWaiter, attachInFlightReader, beginCoalescedScan, clearInFlightReads, deleteInFlightRead, deleteInFlightReadsForDir, setInFlightRead };

package/dist/in-flight-reads.js

@@ -1,16 +1,18 @@
 import {
+  attachInFlightReader,
+  beginCoalescedScan,
   clearInFlightReads,
   deleteInFlightRead,
   deleteInFlightReadsForDir,
-  getInFlightRead,
   setInFlightRead
-} from "./chunk-PDJTHRAW.js";
+} from "./chunk-RBOJCG4T.js";
 import "./chunk-PZ5AY32C.js";
 export {
+  attachInFlightReader,
+  beginCoalescedScan,
   clearInFlightReads,
   deleteInFlightRead,
   deleteInFlightReadsForDir,
-  getInFlightRead,
   setInFlightRead
 };
 //# sourceMappingURL=in-flight-reads.js.map

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { resolveRemnicConfigRecord } from './config-record.js';
 export { ExternalWikiCatalog, ExternalWikiCatalogEntry, ExternalWikiCatalogLimits, ExternalWikiLayout, ExternalWikiPage, loadExternalWikiCatalog, parseExternalWikiCatalog, readExternalWikiPage, validateExternalWikiLayout } from './external-wiki.js';
 export { runExternalWikiCliCommand } from './external-wiki-cli.js';
 export { MigrationOptions, MigrationResult, RollbackResult, migrateFromEngram, rollbackFromEngramMigration } from './migrate/from-engram.js';
-export { O as Orchestrator, d as defaultWorkspaceDir, s as sanitizeSessionKeyForFilename } from './orchestrator-B7nLo4z1.js';
+export { O as Orchestrator, d as defaultWorkspaceDir, s as sanitizeSessionKeyForFilename } from './orchestrator-Haa9xVPV.js';
 export { normalizeProjectionPreview, normalizeProjectionTags } from './memory-projection-format.js';
 export { ModelCapabilities, ModelRegistry } from './model-registry.js';
 export { ACTIVE_STATUSES, ContradictionFilter, ContradictionJudgeBatchResult, ContradictionJudgeInput, ContradictionJudgeResult, ContradictionListResult, ContradictionVerdict, ResolutionResult, ResolutionVerb, ScanDependencies, ScanResult, computePairId, executeResolution, isCoolingDown, isValidResolutionVerb, judgeContradictionPairs, listPairs, readPair, resolvePair, runContradictionScan, writePair, writePairs } from './contradiction/index.js';
@@ -14,8 +14,8 @@ export { TargetedFactRecallOptions, buildTargetedFactRecallSection, shouldRecall
 export { FocusedListRecallOptions, buildFocusedListRecallSection, shouldRecallFocusedListEvidence } from './focused-list-recall.js';
 export { ResponseGuidanceRecallOptions, buildResponseGuidanceRecallSection, shouldRecallResponseGuidance } from './response-guidance-recall.js';
 export { EventOrderRecallOptions, buildEventOrderRecallSection, shouldRecallEventOrderEvidence } from './event-order-recall.js';
-import { S as StorageManager, a as MeetingRecordStore } from './storage-COL907QF.js';
-export { C as ContentHashIndex, c as FUSION_KIND, d as MEETINGS_DIR_NAME, e as MEETING_FORMAT_VERSION, f as MEETING_KIND, g as MeetingRecordBase, h as MeetingRecordFileIo, b as MeetingRecordSummary, i as MeetingSaveResult, M as MemoryWriteResult, j as composeFusionDayMeta, k as composeMeetingRecord, l as hashFusionBody, m as meetingIdDate, p as parseEntityFile, n as parseFusionDay, o as parseMeetingRecordSummary, s as serializeEntityFile, q as serializeFusionDay, r as serializeMeetingRecord } from './storage-COL907QF.js';
+import { S as StorageManager, a as MeetingRecordStore } from './storage-D1apCiCS.js';
+export { C as ContentHashIndex, c as FUSION_KIND, d as MEETINGS_DIR_NAME, e as MEETING_FORMAT_VERSION, f as MEETING_KIND, g as MeetingRecordBase, h as MeetingRecordFileIo, b as MeetingRecordSummary, i as MeetingSaveResult, M as MemoryWriteResult, j as composeFusionDayMeta, k as composeMeetingRecord, l as hashFusionBody, m as meetingIdDate, p as parseEntityFile, n as parseFusionDay, o as parseMeetingRecordSummary, s as serializeEntityFile, q as serializeFusionDay, r as serializeMeetingRecord } from './storage-D1apCiCS.js';
 import { SealedMemoryEnvelope } from './write-envelope.js';
 export { AccessWriteFingerprintParts, ComposeEnvelopeOptions, FINGERPRINT_EXEMPT_FIELDS, FINGERPRINT_SCOPE_FIELDS, FingerprintScope, MemoryWriteInput, ObserveFingerprintParts, STRUCTURED_ATTRIBUTE_LIMITS, TAG_LIMITS, WRITE_FINGERPRINT_FIELDS, WriteContext, buildAccessWriteRequestFingerprint, buildObserveRequestFingerprint, buildWriteIdempotencyPayload, composeMemoryEnvelope, isSealedMemoryEnvelope, sealedWriteToLegacyArgs } from './write-envelope.js';
 export { HostEmbeddingInputType, HostEmbeddingProvider, getHostEmbeddingProvider, normalizeHostEmbeddingVector, registerHostEmbeddingProvider } from './host-embedding-provider.js';
@@ -29,8 +29,8 @@ export { bx as ActivityExtractionMode, aH as ActivitySourceConfig, u as AgentAcc
 import { JudgeCandidate, JudgeVerdict } from './extraction-judge.js';
 export { JudgeBatchResult, JudgeVerdictKind, clearVerdictCache, createVerdictCache, getVerdictKind, isDurableVerdict, isValidCachedVerdict, judgeFactDurability, normalizeCachedVerdict, verdictCacheSize } from './extraction-judge.js';
 export { hasBroadGraphIntent, inferIntentFromText, intentCompatibilityScore, isTaskInitiationIntent, planRecallMode } from './intent.js';
-import { f as EngramAccessService } from './access-service-andNjwfD.js';
-export { P as ProcedureStatsConfigSnapshot, J as ProcedureStatsRecent, K as ProcedureStatsReport, L as ProcedureStatusCounts, N as computeProcedureStats, O as formatProcedureStatsText } from './access-service-andNjwfD.js';
+import { f as EngramAccessService } from './access-service-DvXOzCrM.js';
+export { P as ProcedureStatsConfigSnapshot, J as ProcedureStatsRecent, K as ProcedureStatsReport, L as ProcedureStatusCounts, N as computeProcedureStats, O as formatProcedureStatsText } from './access-service-DvXOzCrM.js';
 export { FILTER_LABELS as DIRECT_ANSWER_FILTER_LABELS, DirectAnswerCandidate, DirectAnswerConfig, DirectAnswerInput, DirectAnswerReason, DirectAnswerResult, isDirectAnswerEligible } from './direct-answer.js';
 export { MemoryTier, TierRoutingPolicy, TierTransitionDecision, computeTierValueScore, decideTierTransition } from './tier-routing.js';
 export { ApplyReasoningTraceBoostOptions, BoostableResult, DEFAULT_REASONING_TRACE_BOOST, applyReasoningTraceBoost, isReasoningTracePath, looksLikeProblemSolvingQuery } from './reasoning-trace-recall.js';
@@ -90,11 +90,11 @@ export { a as TaxonomyCategory } from './types-DJhqDJUV.js';
 export { EnrichmentAuditEntry, EnrichmentCandidate, EnrichmentCostTier, EnrichmentPipelineConfig, EnrichmentProvider, EnrichmentProviderConfig, EnrichmentProviderRegistry, EnrichmentResult, EntityEnrichmentInput, WebSearchFn, WebSearchProvider, WebSearchProviderOptions, appendAuditEntry, defaultEnrichmentPipelineConfig, readAuditLog, runEnrichmentPipeline } from './enrichment/index.js';
 export { clearBulkImportSources, getBulkImportSource, listBulkImportSources, registerBulkImportSource } from './bulk-import/index.js';
 export { a as ProcessBatchContext, P as ProcessBatchFn, b as ProcessBatchResult, f as formatBatchTranscript, r as resolveBulkImportContext, c as runBulkImportPipeline, v as validateBatchSize } from './pipeline-1h2GpiHP.js';
-export { B as BulkImportCliCommandOptions, p as parseStrictCliDate, r as runBulkImportCliCommand } from './cli-p_WmVo2h.js';
-import { S as SpeakerRegistry, W as WearablesService, d as MeetingMemoryWriter, e as MeetingMemoryGenerator, f as MeetingEpisodeGenResult, g as MeetingsBuilder, h as MeetingsDaySource, i as MeetingDayData } from './service-B5W5IYCx.js';
-export { D as DEFAULT_SELF_NAME, j as MeetingBuildOutcome, k as MeetingFusionOptions, l as MeetingMemoryOutcome, m as MeetingsBuilderHooks, a as MeetingsDayBuildSummary, n as MeetingsDayFactGenResult, b as MeetingsGetResult, o as MeetingsListDay, c as MeetingsListResult, M as MeetingsService, p as MeetingsServiceDeps, R as ResolvedSpeaker, q as SpeakerOverride, r as WEARABLE_SOURCE_PREFIX, s as WearableDayTranscriptView, t as WearableMemoryGenDeps, u as WearableMemoryGenResult, v as WearableMemorySearchResult, w as WearableMemoryWriter, x as WearableSearchBackend, y as WearableStorageIo, z as WearableSyncDeps, A as WearableSyncOptions, B as WearableTranscriptSearchResult, C as WearablesServiceDeps, E as buildExtractionTurns, F as buildMeetingRecordsForDay, G as dateInTimezone, H as defaultTimezone, I as distinctSpeakerLabels, J as emptySpeakerRegistry, K as fuseMeeting, L as generateWearableMemories, N as importNativeMemories, O as loadSpeakerRegistry, P as locateTranscriptPath, Q as memoryStatusForMode, T as resolveSpeaker, U as resolveSyncDates, V as saveSpeakerRegistry, X as speakerRegistryKey, Y as speakersFilePath, Z as syncWearableSource, _ as wearableDayTag, $ as wearableSourceLabel, a0 as writeDailyDigestMemory } from './service-B5W5IYCx.js';
-import { A as ActivityStore, a as ActivitySyncRunSummary } from './maintenance-BfcuwfJS.js';
-export { b as ActivitySourceRunItem, c as ActivitySyncRunOptions, d as activityDatabasePath, e as applyActivitySchema, f as ensureActivityStateDir, o as openActivityDatabase, r as resolveActivitySyncDates, g as runActivitySyncOnce } from './maintenance-BfcuwfJS.js';
+export { B as BulkImportCliCommandOptions, p as parseStrictCliDate, r as runBulkImportCliCommand } from './cli-PyAUaozE.js';
+import { S as SpeakerRegistry, W as WearablesService, d as MeetingMemoryWriter, e as MeetingMemoryGenerator, f as MeetingEpisodeGenResult, g as MeetingsBuilder, h as MeetingsDaySource, i as MeetingDayData } from './service-Da_BI4S8.js';
+export { D as DEFAULT_SELF_NAME, j as MeetingBuildOutcome, k as MeetingFusionOptions, l as MeetingMemoryOutcome, m as MeetingsBuilderHooks, a as MeetingsDayBuildSummary, n as MeetingsDayFactGenResult, b as MeetingsGetResult, o as MeetingsListDay, c as MeetingsListResult, M as MeetingsService, p as MeetingsServiceDeps, R as ResolvedSpeaker, q as SpeakerOverride, r as WEARABLE_SOURCE_PREFIX, s as WearableDayTranscriptView, t as WearableMemoryGenDeps, u as WearableMemoryGenResult, v as WearableMemorySearchResult, w as WearableMemoryWriter, x as WearableSearchBackend, y as WearableStorageIo, z as WearableSyncDeps, A as WearableSyncOptions, B as WearableTranscriptSearchResult, C as WearablesServiceDeps, E as buildExtractionTurns, F as buildMeetingRecordsForDay, G as dateInTimezone, H as defaultTimezone, I as distinctSpeakerLabels, J as emptySpeakerRegistry, K as fuseMeeting, L as generateWearableMemories, N as importNativeMemories, O as loadSpeakerRegistry, P as locateTranscriptPath, Q as memoryStatusForMode, T as resolveSpeaker, U as resolveSyncDates, V as saveSpeakerRegistry, X as speakerRegistryKey, Y as speakersFilePath, Z as syncWearableSource, _ as wearableDayTag, $ as wearableSourceLabel, a0 as writeDailyDigestMemory } from './service-Da_BI4S8.js';
+import { A as ActivityStore, a as ActivitySyncRunSummary } from './maintenance-j7sfNQdK.js';
+export { b as ActivitySourceRunItem, c as ActivitySyncRunOptions, d as activityDatabasePath, e as applyActivitySchema, f as ensureActivityStateDir, o as openActivityDatabase, r as resolveActivitySyncDates, g as runActivitySyncOnce } from './maintenance-j7sfNQdK.js';
 import { SearchExecutionOptions } from './search/port.js';
 export { DEFAULT_IMPORT_BATCH_SIZE, ImportProgress, ImportedMemory, ImporterAdapter, ImporterParseOptions, ImporterTransformOptions, ImporterWriteResult, ImporterWriteTarget, RunImportOptions, RunImporterResult, defaultWriteMemoriesToOrchestrator, importedMemoryToTurn, runImporter, validateImportBatchSize, validateImportRateLimit } from './importers/index.js';
 export { FallbackLlmClient, FallbackLlmOptions, FallbackLlmResponse, FallbackLlmRuntimeContext } from './fallback-llm.js';
@@ -131,6 +131,7 @@ import './summarizer.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
 import './capabilities.js';
+import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './entity-id-normalization.js';
 import './consolidation-operator.js';