@remnic/core 10.0.59 → 10.0.61

package/dist/operator-toolkit.js

@@ -14,23 +14,23 @@ import {
   summarizeProvenanceCoverage,
   summarizeTierDistribution,
   summarizeTombstoneStatus
-} from "./chunk-FXWX7VD3.js";
-import "./chunk-EJFOGYF3.js";
+} from "./chunk-PRYDNBCO.js";
+import "./chunk-DTQJ7BRN.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-CMTINOFS.js";
-import "./chunk-YZNTAOPZ.js";
+import "./chunk-FKNNWH7P.js";
 import "./chunk-I6ORDT54.js";
 import "./chunk-OZKOPQCM.js";
 import "./chunk-JKMIGCK6.js";
 import "./chunk-2DQ2XREU.js";
 import "./chunk-XL2EE5W3.js";
 import "./chunk-YBPYIAA5.js";
-import "./chunk-Y77FXULH.js";
+import "./chunk-XWXBXBOX.js";
 import "./chunk-ZKOPY4WW.js";
 import "./chunk-62OKGIJA.js";
 import "./chunk-J5WI4QRP.js";
 import "./chunk-QNJQCLI6.js";
-import "./chunk-2M36PR7R.js";
+import "./chunk-Z2T5BPOZ.js";
 import "./chunk-QNIYL5SK.js";
 import "./chunk-LI4APB6M.js";
 import "./chunk-Z5LAYHGJ.js";
@@ -54,19 +54,19 @@ import "./chunk-G2XTGEGL.js";
 import "./chunk-27NO2KVB.js";
 import "./chunk-KFZY2OFH.js";
 import "./chunk-B32WYRXX.js";
-import "./chunk-ZE5N4JSY.js";
-import "./chunk-R4BR62UO.js";
+import "./chunk-TKCJI7WA.js";
+import "./chunk-HWMGQDZI.js";
 import "./chunk-B6SPPYGJ.js";
-import "./chunk-MLUPSZFK.js";
-import "./chunk-5U2BBF7E.js";
-import "./chunk-PM4PKC3Y.js";
-import "./chunk-AMKIIRLL.js";
-import "./chunk-KRAMCBIW.js";
+import "./chunk-46U6L5DM.js";
+import "./chunk-PNVQNAJM.js";
+import "./chunk-TBFAQHQZ.js";
+import "./chunk-DZL5PBEJ.js";
+import "./chunk-QKXPOLQD.js";
 import "./chunk-YXW4KXCV.js";
+import "./chunk-GKCXTSFF.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
 import "./chunk-LXY5VVGM.js";
-import "./chunk-GKCXTSFF.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-ETSJD5IV.js";
 import "./chunk-FEHIOYML.js";
@@ -84,22 +84,23 @@ import "./chunk-AJG2TAMR.js";
 import "./chunk-236PXYG7.js";
 import "./chunk-ZCUTSMR2.js";
 import "./chunk-QDW3E4RD.js";
-import "./chunk-NRGQ5HJO.js";
+import "./chunk-4P4VLPGB.js";
 import "./chunk-ZJP66Q4I.js";
-import "./chunk-WXBVGKS6.js";
+import "./chunk-N7RAABFM.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-DM5QZ3YU.js";
-import "./chunk-G6A3SGCE.js";
+import "./chunk-WVEEVYMH.js";
+import "./chunk-JCL7RO2G.js";
 import "./chunk-G6OFEGUR.js";
-import "./chunk-JEX2JL3U.js";
-import "./chunk-U2A56LLF.js";
-import "./chunk-DOJBV6WR.js";
-import "./chunk-PFUXPTBT.js";
+import "./chunk-OH55F76C.js";
+import "./chunk-L334PSLW.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-DLZGSZVC.js";
 import "./chunk-OVZIYLBZ.js";
-import "./chunk-WNEVEMJ3.js";
 import "./chunk-EXYT52NR.js";
+import "./chunk-DOJBV6WR.js";
+import "./chunk-PFUXPTBT.js";
+import "./chunk-WNEVEMJ3.js";
 import "./chunk-Y5NLBXPV.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
@@ -108,8 +109,8 @@ import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-PPUNC7UX.js";
 import "./chunk-X3724WL4.js";
-import "./chunk-S2HLHAZ4.js";
 import "./chunk-MRPOZBJC.js";
+import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-FF6N7BXC.js";
@@ -117,12 +118,14 @@ import "./chunk-WXPBDEMW.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-WJCXUE2J.js";
 import "./chunk-ZIKENA2C.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-3ONXXHQO.js";
-import "./chunk-YXZG5TVN.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-P4GUQSK3.js";
+import "./chunk-4LZ7SVKM.js";
+import "./chunk-YHTG64XV.js";
 import "./chunk-564YP3DW.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
@@ -133,15 +136,16 @@ import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-7VLBZKNB.js";
 import "./chunk-UUZ7KZAO.js";
-import "./chunk-WBN66HPI.js";
+import "./chunk-ELHJK7LM.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-NWA6IXR3.js";
 import "./chunk-VILPVT4S.js";
 import "./chunk-AF2XMJKD.js";
 import "./chunk-OR42ZI54.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
+import "./chunk-U7MIMS2Y.js";
 import "./chunk-AVVCPA7U.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
@@ -182,17 +186,17 @@ import "./chunk-BTNNL7ZW.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-TEH5MDX5.js";
+import "./chunk-YH7HJNWV.js";
 import "./chunk-UI3NYK34.js";
 import "./chunk-XXR4A33N.js";
-import "./chunk-UWMZT2TY.js";
-import "./chunk-JZCBMKR5.js";
-import "./chunk-6AEKSOWV.js";
+import "./chunk-TUCEP2LS.js";
+import "./chunk-6I6DFULH.js";
 import "./chunk-63LFM77Z.js";
-import "./chunk-LDWE7OZS.js";
+import "./chunk-UWMZT2TY.js";
 import "./chunk-GCGJW34D.js";
-import "./chunk-TRSKATZQ.js";
+import "./chunk-LDWE7OZS.js";
 import "./chunk-SWRRZNHM.js";
+import "./chunk-TRSKATZQ.js";
 import "./chunk-JNA7LFMQ.js";
 import "./chunk-LQWOFU6L.js";
 import "./chunk-EBRG7ZIK.js";

package/dist/orchestration/buffer-drain-gate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Extraction gate for sessions claimed by `remnic buffer drain`.
+ *
+ * A claimed session's turns belong to the drain: they live in a durable
+ * claim file and are extracted out of process. The live buffer owner hands
+ * its copy of such a session into the claim instead of writing it back, so
+ * extracting it here as well would persist the same content twice.
+ */
+import type { ExtractionRunResult } from "./extraction-run.js";
+/** The claim check a buffer owner exposes. Optional: buffers without a claim
+ * registry (older hosts, test doubles) simply never report a claim. */
+export interface ClaimAwareBuffer {
+    isSessionClaimed?(key: string): boolean;
+}
+/**
+ * Settle the extraction as skipped when `bufferKey` is claimed by a drain.
+ * Returns true when the caller must stop (the window stays in the claim).
+ * A missing buffer (deps without one) is never claimed.
+ */
+export declare function skipClaimedSession(buffer: ClaimAwareBuffer | undefined, bufferKey: string, settle: (result: ExtractionRunResult) => void): boolean;
+//# sourceMappingURL=buffer-drain-gate.d.ts.map

package/dist/orchestration/buffer-drain-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-drain-gate.d.ts","sourceRoot":"","sources":["../../src/orchestration/buffer-drain-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;uEACuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAC5C,OAAO,CAUT"}

package/dist/orchestration/buffer-drain-runner.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Out-of-process extraction-buffer drain (`remnic buffer drain`).
+ *
+ * The runner owns ONE claimed session at a time and drives it through the
+ * SAME extraction pipeline the daemon uses — the same chunking
+ * (`chunkExtractionWindow` + the model's input budget), the same retry /
+ * provider-circuit semantics, the same dropped-chunk side-file recovery. It
+ * adds no extraction logic of its own.
+ *
+ * The difference is ownership: the claimed session's turns live in a drain
+ * claim (a durable file), not in a live buffer. So the runner wires a
+ * claim-backed `SmartBuffer` into the extraction queue instead of the live
+ * one. Every chunk that extracts successfully is removed from the claim
+ * immediately, which makes the drain resumable: a kill at any instant
+ * leaves the un-extracted turns in the claim, and the next run continues
+ * from there.
+ *
+ * Concurrency lives in the CLI (worker processes, one session each at a
+ * time): the in-process extraction queue is serial by design, so a single
+ * runner never runs two sessions' extractions at once.
+ */
+import { BufferDrainClaims } from "../storage/buffer-drain-claims.js";
+import type { Orchestrator } from "../orchestrator.js";
+export type DrainSessionStatus = "drained" | "deferred" | "failed" | "skipped";
+export interface DrainSessionOutcome {
+    key: string;
+    status: DrainSessionStatus;
+    /** Turns the claim held when the drain started. */
+    turnsAtStart: number;
+    /** Turns still in the claim when the drain stopped. */
+    turnsRemaining: number;
+    /** Facts the extraction persisted during this run. */
+    persistedCount: number;
+    /** Durable outputs (memories + entities) the extraction wrote. */
+    durableOutputCount: number;
+    /** Why the session was skipped or deferred (machine-readable). */
+    reason?: string;
+}
+export interface BufferDrainRunnerOptions {
+    /** Identity of this drainer; owns the lease it takes. */
+    ownerId: string;
+    /** Lease lifetime in ms. The heartbeat keeps it alive while draining. */
+    leaseMs?: number;
+    /** Cancels the run at the next chunk boundary. */
+    signal?: AbortSignal;
+    /** Progress callback (per session, and per claim transition). */
+    onEvent?: (event: DrainRunnerEvent) => void;
+}
+/** A failed drain run: the reason a chunk or the session could not finish. */
+export type DrainExtractionError = Error;
+export type DrainRunnerEvent = {
+    type: "session_started";
+    key: string;
+    turns: number;
+} | {
+    type: "session_finished";
+    key: string;
+    outcome: DrainSessionOutcome;
+};
+export declare class BufferDrainRunner {
+    private readonly orchestrator;
+    constructor(orchestrator: Orchestrator);
+    /** The claim store of this orchestrator's memory root. */
+    get claims(): BufferDrainClaims;
+    /**
+     * Drain one claimed session. The caller owns the lease (it may have taken
+     * it already); this method verifies ownership before touching content.
+     */
+    drainSession(key: string, options: BufferDrainRunnerOptions): Promise<DrainSessionOutcome>;
+    /** Claim a session file for the drain. Returns false when it is not claimable. */
+    claim(key: string, ownerId: string, leaseMs?: number): Promise<boolean>;
+    /** Sessions with buffered turns, claimed or not (CLI scan). */
+    scan(): Promise<{
+        key: string;
+        turns: number;
+        claimed: boolean;
+    }[]>;
+}
+//# sourceMappingURL=buffer-drain-runner.d.ts.map

package/dist/orchestration/buffer-drain-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-drain-runner.d.ts","sourceRoot":"","sources":["../../src/orchestration/buffer-drain-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,iBAAiB,EAAmB,MAAM,mCAAmC,CAAC;AAQvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,kBAAkB,CAAC;IAC3B,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iEAAiE;IACjE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC7C;AAED,8EAA8E;AAC9E,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAiD5E,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAEvD,0DAA0D;IAC1D,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAED;;;OAGG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqJhG,kFAAkF;IAC5E,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,SAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAYvF,+DAA+D;IACzD,IAAI,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CAqB1E"}