@remnic/core 10.0.59 → 10.0.61

package/dist/search/factory.js

@@ -3,26 +3,26 @@ import {
   createConversationSearchBackend,
   createSearchBackend,
   isSearchBackendEnabled
-} from "../chunk-U2A56LLF.js";
-import "../chunk-DOJBV6WR.js";
-import "../chunk-PFUXPTBT.js";
+} from "../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";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
 import "../chunk-3ONXXHQO.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-C64XATK7.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-YCVB7X56.js";

package/dist/search/index.js

@@ -2,13 +2,7 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-U2A56LLF.js";
-import {
-  LanceDbBackend
-} from "../chunk-DOJBV6WR.js";
-import {
-  MeilisearchBackend
-} from "../chunk-PFUXPTBT.js";
+} from "../chunk-L334PSLW.js";
 import {
   NoopSearchBackend
 } from "../chunk-CYEPCZN5.js";
@@ -18,24 +12,30 @@ import {
 import {
   RemoteSearchBackend
 } from "../chunk-OVZIYLBZ.js";
-import {
-  scanMemoryDir
-} from "../chunk-WNEVEMJ3.js";
 import {
   EmbedHelper
 } from "../chunk-EXYT52NR.js";
+import {
+  LanceDbBackend
+} from "../chunk-DOJBV6WR.js";
+import {
+  MeilisearchBackend
+} from "../chunk-PFUXPTBT.js";
+import {
+  scanMemoryDir
+} from "../chunk-WNEVEMJ3.js";
 import "../chunk-Y5NLBXPV.js";
 import "../chunk-TFA6HPOA.js";
 import "../chunk-F4TWWUMP.js";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
 import "../chunk-3ONXXHQO.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-C64XATK7.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-YCVB7X56.js";

package/dist/semantic-consolidation.js

@@ -7,31 +7,32 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-6BO27AWQ.js";
+} from "./chunk-MPJ7VHHA.js";
 import {
   resolveExtensionsRoot
 } from "./chunk-5JMAGU26.js";
-import "./chunk-OL7A7NKH.js";
+import "./chunk-GNP4BV4Z.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-AL3TCNSJ.js";
 import "./chunk-TOTT6S2V.js";
 import "./chunk-236PXYG7.js";
 import "./chunk-ZCUTSMR2.js";
 import "./chunk-QDW3E4RD.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";
@@ -40,8 +41,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";
@@ -49,12 +50,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";
@@ -70,15 +73,16 @@ import {
 } from "./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";

package/dist/semantic-rule-promotion.js

@@ -1,21 +1,22 @@
 import {
   promoteSemanticRuleFromMemory,
   setSemanticRulePromotionTestHooks
-} from "./chunk-37VTMUAL.js";
-import "./chunk-WXBVGKS6.js";
+} from "./chunk-OUJ4DVR5.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";
@@ -24,8 +25,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";
@@ -33,12 +34,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";
@@ -49,15 +52,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";

package/dist/semantic-rule-verifier.js

@@ -1,21 +1,22 @@
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-VCLNU6MY.js";
-import "./chunk-WXBVGKS6.js";
+} from "./chunk-L2HSSVVD.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";
@@ -24,8 +25,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";
@@ -33,12 +34,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";
@@ -49,15 +52,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";

package/dist/source-agent-qualifier.js

@@ -3,7 +3,7 @@ import {
   headerConnector,
   renderExtractionConversation,
   resolveSourceConnector
-} from "./chunk-OMWQO7H6.js";
+} from "./chunk-UEDC2VGP.js";
 import "./chunk-CIIHIAJ2.js";
 import "./chunk-D5SSBCYY.js";
 import "./chunk-77R7BQZ2.js";
@@ -12,11 +12,11 @@ import "./chunk-VEWZZM3H.js";
 import "./chunk-JX3E4XCW.js";
 import "./chunk-QA3Y2O6H.js";
 import "./chunk-V27FK6D6.js";
-import "./chunk-OL7A7NKH.js";
+import "./chunk-GNP4BV4Z.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-AL3TCNSJ.js";
-import "./chunk-XDKEHZUC.js";
-import "./chunk-YDT3OEYF.js";
+import "./chunk-264B57GV.js";
+import "./chunk-R4ZHF4K2.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";
@@ -27,20 +27,21 @@ import "./chunk-236PXYG7.js";
 import "./chunk-ZCUTSMR2.js";
 import "./chunk-QDW3E4RD.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";
@@ -49,8 +50,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";
@@ -58,12 +59,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";
@@ -74,15 +77,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";

package/dist/standup/build.js

@@ -3,21 +3,22 @@ import {
   parseStandupDate,
   previousActiveDate,
   standupHelp
-} from "../chunk-2IVK5IDY.js";
-import "../chunk-WXBVGKS6.js";
+} from "../chunk-P5F7ISLV.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";
@@ -26,8 +27,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";
@@ -35,12 +36,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";
@@ -51,15 +54,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";

package/dist/storage/buffer-drain-claims.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Durable drain claims for the extraction buffer (`remnic buffer drain`).
+ *
+ * A claim is the atomic handover of one session's buffered turns from the
+ * live buffer (daemon or CLI process) to a drain worker, so extraction can
+ * run out of process without a live buffer owner resurrecting or losing the
+ * turns. Files under `<stateDir>/buffer/drain/`:
+ *
+ *   s-<sha256(key)>.json        claim content: { key, entry, claimedAt }
+ *                               — the turns NOT yet extracted. Renamed into
+ *                               place from the session file (atomic on one
+ *                               filesystem), rewritten atomically as chunks
+ *                               drain.
+ *   s-<sha256(key)>.lease.json  { ownerId, pid, acquiredAt, heartbeatAt,
+ *                               leaseMs } — created with exclusive-create so
+ *                               exactly one drainer holds a key.
+ *
+ * Invariants (see the buffer-drain PR for the full protocol):
+ *   - At every instant the claim content file holds exactly the turns whose
+ *     extraction is not durably finished, so a kill at any point loses
+ *     nothing and the next run resumes.
+ *   - A live buffer owner that must persist a claimed session hands its
+ *     in-memory entry INTO the claim (merge, identity-deduped) instead of
+ *     writing a session file — it can never resurrect claimed turns.
+ *   - Claims are idempotent: re-claiming, double-draining, and two
+ *     concurrent drainers are all safe (per-key mutation lock + exclusive
+ *     lease; the lock also fences lease takeover and progress writes).
+ *
+ * All content reads/writes go through the storage's secure file I/O
+ * (`BufferFileIo`); only lease/existence checks touch raw paths, and claim
+ * rewrites serialize on a cross-process held file lock.
+ */
+import { type BufferFileIo } from "./buffer-session-files.js";
+import type { BufferEntryState, BufferTurn } from "../types.js";
+/** Result of persisting one session's entry. */
+export interface BufferSessionSaveOutcome {
+    /** "saved": the session file holds the entry. "handed_over": the entry moved into a drain claim. */
+    status: "saved" | "handed_over";
+    /** Turns a drain already extracted (claim tombstone): the owner subtracts them from its copy. */
+    drainedTurns?: BufferTurn[];
+}
+export interface DrainLease {
+    ownerId: string;
+    pid: number;
+    /** Host the owner runs on: a takeover may only judge liveness on that host. */
+    host: string;
+    acquiredAt: string;
+    heartbeatAt: string;
+    leaseMs: number;
+}
+export interface DrainClaimFile {
+    key: string;
+    entry: BufferEntryState;
+    claimedAt: string;
+    /**
+     * Turns the drain already extracted. Non-empty means the session was
+     * drained and the claim is a TOMBSTONE: a live buffer owner subtracts
+     * these from its (possibly stale) copy instead of writing them back, so
+     * drained turns can never be resurrected.
+     */
+    drained?: BufferTurn[];
+    /** Same tombstone for turns the drain extracted from `retainedTurns`. */
+    drainedRetained?: BufferTurn[];
+}
+export type ClaimFromSessionOutcome = "claimed" | "empty" | "already_claimed";
+export type AdoptOutcome = "adopted" | "busy";
+export type AckOutcome = "acked" | "not_empty" | "busy";
+export interface DrainClaimListing {
+    key: string;
+    turnCount: number;
+    leased: boolean;
+    leaseExpired: boolean;
+}
+export declare class BufferDrainClaims {
+    private readonly stateDir;
+    private readonly io;
+    constructor(stateDir: string, io: BufferFileIo);
+    private get dir();
+    private fileFor;
+    private leaseFileFor;
+    private lockFileFor;
+    /** Sync existence check for hot-path gates (`SmartBuffer.isSessionClaimed`). */
+    isClaimed(key: string): boolean;
+    /** Test + CLI seam: the lease file path for direct inspection. */
+    leasePathForTest(key: string): string;
+    private readClaimBody;
+    /** The claim content for `key`, or null when the key is not claimed. */
+    load(key: string): Promise<DrainClaimFile | null>;
+    private writeClaimBody;
+    private readLease;
+    private writeLease;
+    /**
+     * Atomically move a session's persisted file into a claim. The rename is
+     * the handover: after it settles the turns exist ONLY as a claim, so no
+     * crash window can lose them or leave them in both places. Callers that
+     * lose the race (`already_claimed`) simply skip the key.
+     *
+     * The whole handover runs under the claim's mutation lock, so a claim
+     * create can never land on top of an existing claim (POSIX rename would
+     * silently replace it) and the lease write cannot race an adopter.
+     */
+    claimFromSessionFile(key: string, lease: DrainLease): Promise<ClaimFromSessionOutcome>;
+    /**
+     * Take over a claim whose lease is missing, expired, or whose owner died.
+     * The whole judgement runs under the claim's mutation lock and re-reads
+     * the lease inside it, so exactly one concurrent adopter wins: the loser
+     * re-reads the winner's fresh lease and reports "busy" instead of
+     * unlinking it. A lease whose owner died is taken over in the same call.
+     */
+    adopt(key: string, lease: DrainLease): Promise<AdoptOutcome>;
+    /**
+     * Merge a live owner's in-memory entry INTO the claim (the handover path a
+     * buffer owner takes instead of persisting a claimed session). Serialized
+     * against drainer progress writes on the same lock.
+     */
+    mergeIntoClaim(key: string, incoming: BufferEntryState): Promise<void>;
+    /** Drainer progress: replace the claim content with what is left to do.
+     *
+     * Fenced: `ownerId` must still match the claim's lease (checked under the
+     * same lock), so a drainer that lost its lease cannot write progress that
+     * would restore turns the new owner already extracted.
+     *
+     * `seen` is the entry the drainer LOADED (its snapshot of the claim). Only
+     * turns that were in that snapshot and are absent from BOTH of the
+     * drainer's lists were actually extracted and move to the tombstones — a
+     * turn the drainer moved into `entry.retainedTurns` is retained for retry,
+     * not extracted. Turns a live owner merged into the claim afterwards stay
+     * pending. Without `seen` the pre-existing behavior is kept (every claim
+     * turn missing from `entry` counts as extracted).
+     */
+    writeEntry(key: string, ownerId: string, entry: BufferEntryState, seen?: BufferEntryState): Promise<void>;
+    /** Extend the lease. "lost" means another drainer took the claim over.
+     * Serialized on the claim lock so a stale heartbeat can never overwrite a
+     * new owner's lease mid-takeover; a contended lock just skips this tick
+     * (usually the drainer's own progress write holds it). */
+    heartbeat(key: string, ownerId: string, leaseMs: number): Promise<"ok" | "lost">;
+    /** Give the key back (content stays; the next run resumes it). */
+    releaseLease(key: string, ownerId: string): Promise<void>;
+    /**
+     * Finish a claim: only its owner may ack, and only when nothing is left to
+     * extract. Non-empty claims stay (deferred content is never dropped here).
+     */
+    ack(key: string, ownerId: string): Promise<AckOutcome>;
+    /** The turns a drain already extracted for `key` (tombstone content). */
+    drainedTurns(key: string): Promise<BufferTurn[]>;
+    /**
+     * Is the drain for `key` FINISHED (acked): the claim holds extracted turns
+     * and nothing pending, and the drainer dropped its lease. A claim with
+     * partial progress or a live lease is still being drained — its owner must
+     * merge into it, never release it.
+     */
+    isDrained(key: string): Promise<boolean>;
+    /** Drop the claim file entirely (its owner consumed the tombstone). */
+    release(key: string): Promise<void>;
+    /** Every claim with its lease state (CLI scan + summaries). */
+    list(): Promise<DrainClaimListing[]>;
+    private readClaimBodyByKey;
+}
+//# sourceMappingURL=buffer-drain-claims.d.ts.map

package/dist/storage/buffer-drain-claims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-drain-claims.d.ts","sourceRoot":"","sources":["../../src/storage/buffer-drain-claims.ts"],"names":[],"mappings":"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"}