@absolutejs/rag 0.24.1 → 0.24.2

package/CHANGELOG.md

@@ -6,6 +6,12 @@ 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.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,20 @@
 	"contract": 1,
 	"name": "@absolutejs/rag",
 	"releases": [
+		{
+			"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),
@@ -122696,13 +122699,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 +122722,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 +123539,5 @@ export {
   selectResearchMonitorEvents
 };
 
-//# debugId=447572534D5D532364756E2164756E21
+//# debugId=8B8DD9C3BFAE701F64756E2164756E21
 //# sourceMappingURL=index.js.map