@absolutejs/rag 0.24.1 → 0.24.3

package/CHANGELOG.md

@@ -6,6 +6,18 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.24.3 — 2026-11-03
+
+### Fixed
+
+- **Resume persisted review drafts by JSON pointer and value across database key reordering, preserving completed verdicts and rejecting changed identities.** (`createResearch`)
+
+## 0.24.2 — 2026-11-03
+
+### Fixed
+
+- **Shrink settled failed review batches on explicit continuation, preserving prior verdicts and legacy checkpoints without automatic retries.** (`createResearch`, `ResearchReviewCheckpoint`)
+
 ## 0.24.1 — 2026-11-03
 
 ### Fixed

package/RESEARCH.md

@@ -346,3 +346,5 @@ review processing finished, not that every claim was supported. Reopening a
 finished checkpoint performs no provider work. Checkpoints during evidence
 correction remain pending until the new extraction is safely retained, preventing
 replay of uncertain correction calls.
+
+Settled failed review batches retain a reduced `nextBatchSize` in the private checkpoint. Explicit continuation halves the failed batch down to one field while retaining completed verdicts; it does not increase output limits or automatically repeat calls. Safe checkpoints written before this hint was introduced remain resumable. Unknown or pending calls still require reconciliation.

package/changelog.json

@@ -2,6 +2,33 @@
 	"contract": 1,
 	"name": "@absolutejs/rag",
 	"releases": [
+		{
+			"changes": [
+				{
+					"kind": "fixed",
+					"summary": "Resume persisted review drafts by JSON pointer and value across database key reordering, preserving completed verdicts and rejecting changed identities.",
+					"symbols": [
+						"createResearch"
+					]
+				}
+			],
+			"date": "2026-11-03",
+			"version": "0.24.3"
+		},
+		{
+			"changes": [
+				{
+					"kind": "fixed",
+					"summary": "Shrink settled failed review batches on explicit continuation, preserving prior verdicts and legacy checkpoints without automatic retries.",
+					"symbols": [
+						"createResearch",
+						"ResearchReviewCheckpoint"
+					]
+				}
+			],
+			"date": "2026-11-03",
+			"version": "0.24.2"
+		},
 		{
 			"changes": [
 				{

package/dist/research/index.js

@@ -122280,8 +122280,10 @@ var createResearch = (config) => {
       reviewBatchSize
     });
     const resumed = input.resumeReview;
-    if (resumed && (resumed.version !== 1 || resumed.fingerprint !== fingerprint || resumed.pending || !Number.isSafeInteger(resumed.nextField) || resumed.nextField < 0 || !Number.isSafeInteger(resumed.pass) || resumed.pass < 0 || resumed.pass > evidenceRepairs))
+    if (resumed && (resumed.version !== 1 || resumed.fingerprint !== fingerprint || resumed.pending || resumed.nextBatchSize !== undefined && (!Number.isSafeInteger(resumed.nextBatchSize) || resumed.nextBatchSize < 1 || resumed.nextBatchSize > reviewBatchSize) || !Number.isSafeInteger(resumed.nextField) || resumed.nextField < 0 || !Number.isSafeInteger(resumed.pass) || resumed.pass < 0 || resumed.pass > evidenceRepairs))
       throw new Error("Review checkpoint requires reconciliation or does not match this task");
+    const legacyFailedReview = resumed && !resumed.pending && resumed.result.operations.at(-1)?.kind === "review" && resumed.result.operations.at(-1)?.status === "unknown";
+    let nextBatchSize = resumed?.nextBatchSize ?? (legacyFailedReview ? Math.max(1, Math.floor(reviewBatchSize / 2)) : reviewBatchSize);
     const result = resumed ? structuredClone(resumed.result) : {
       id: crypto.randomUUID(),
       status: "unavailable",
@@ -122316,6 +122318,7 @@ var createResearch = (config) => {
         pass,
         stage,
         nextField,
+        nextBatchSize,
         pending,
         finished,
         draft: structuredClone(draft),
@@ -122685,9 +122688,17 @@ Correct the previous schema-invalid response using the validation diagnostics. T
         if (!continuing)
           result.fields = [];
         await persistReview(pass, continuing ? resumed.nextField : 0, false, data);
-        const leaves = researchLeaves(data, Number.MAX_SAFE_INTEGER);
-        if (continuing && (resumed.nextField > leaves.length || result.fields.length !== resumed.nextField || result.fields.some((field, index) => field.path !== leaves[index]?.path || field.value !== leaves[index]?.value)))
-          throw new Error("Review checkpoint fields do not match draft");
+        let leaves = researchLeaves(data, Number.MAX_SAFE_INTEGER);
+        if (continuing) {
+          const byPath = new Map(leaves.map((field) => [field.path, field]));
+          const completedPaths = new Set(result.fields.map((field) => field.path));
+          if (resumed.nextField > leaves.length || result.fields.length !== resumed.nextField || completedPaths.size !== result.fields.length || result.fields.some((field) => !byPath.has(field.path) || byPath.get(field.path).value !== field.value))
+            throw new Error("Review checkpoint fields do not match draft");
+          leaves = [
+            ...result.fields.map(({ path, value }) => ({ path, value })),
+            ...leaves.filter((field) => !completedPaths.has(field.path))
+          ];
+        }
         if (!leaves.length) {
           result.data = data;
           result.status = result.limitations.length ? "partial" : "empty";
@@ -122696,13 +122707,13 @@ Correct the previous schema-invalid response using the validation diagnostics. T
         }
         const reviewSources = researchPassages(result.sources);
         const reviewStart = continuing ? resumed.nextField : 0;
-        for (let offset = reviewStart;offset < leaves.length; offset += Math.min(reviewBatchSize, limits.fields - (offset - reviewStart))) {
+        for (let offset = reviewStart;offset < leaves.length; offset += Math.min(nextBatchSize, limits.fields - (offset - reviewStart))) {
           if (offset - reviewStart >= limits.fields) {
             result.status = "partial";
             result.limitations.push("Review field allowance reached; remaining fields are saved for explicit continuation");
             return result;
           }
-          const batch = leaves.slice(offset, offset + Math.min(reviewBatchSize, limits.fields - (offset - reviewStart)));
+          const batch = leaves.slice(offset, offset + Math.min(nextBatchSize, limits.fields - (offset - reviewStart)));
           await persistReview(pass, offset, true, data);
           let reviewed;
           try {
@@ -122719,6 +122730,8 @@ Correct the previous schema-invalid response using the validation diagnostics. T
             });
           } catch (error) {
             const known = error instanceof Error && error.message === "Research budget denied" || !admit && await config.isReviewFailureSettled?.(error) === true;
+            if (known && !(error instanceof Error && error.message === "Research budget denied"))
+              nextBatchSize = Math.max(1, Math.floor(batch.length / 2));
             await persistReview(pass, offset, !known, data);
             throw error;
           }
@@ -123534,5 +123547,5 @@ export {
   selectResearchMonitorEvents
 };
 
-//# debugId=447572534D5D532364756E2164756E21
+//# debugId=98A9BACE966FD2EB64756E2164756E21
 //# sourceMappingURL=index.js.map