@absolutejs/rag 0.24.0 → 0.24.2

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.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
+
+- **Mark empty extractions complete and retain retrieval cursors across review continuation without repeating searches or reads.** (`createResearch`, `ResearchReviewCheckpoint`)
+
 ## 0.24.0 — 2026-11-03
 
 ### Added

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,34 @@
 	"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": [
+				{
+					"kind": "fixed",
+					"summary": "Mark empty extractions complete and retain retrieval cursors across review continuation without repeating searches or reads.",
+					"symbols": [
+						"createResearch",
+						"ResearchReviewCheckpoint"
+					]
+				}
+			],
+			"date": "2026-11-03",
+			"version": "0.24.1"
+		},
 		{
 			"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,10 +122318,14 @@ var createResearch = (config) => {
         pass,
         stage,
         nextField,
+        nextBatchSize,
         pending,
         finished,
         draft: structuredClone(draft),
-        result: structuredClone(snapshot)
+        result: structuredClone(snapshot),
+        searched: [...queries],
+        read: [...urls],
+        links: [...discoveredLinks.values()]
       };
       try {
         await input.onReviewCheckpoint?.(checkpoint);
@@ -122432,8 +122438,12 @@ Correct the previous schema-invalid response using the validation diagnostics. T
       document2.url,
       document2.text
     ]));
-    for (const prior of result.searches)
-      queries.add(prior.query);
+    for (const prior of resumed?.searched ?? result.searches.map((search) => search.query))
+      queries.add(prior);
+    for (const prior of resumed?.read ?? [])
+      urls.add(prior);
+    for (const link of resumed?.links ?? [])
+      discoveredLinks.set(link.url, link);
     for (const prior of result.sources)
       if (prior.contentFetchedAt)
         urls.add(prior.url);
@@ -122684,17 +122694,18 @@ Correct the previous schema-invalid response using the validation diagnostics. T
         if (!leaves.length) {
           result.data = data;
           result.status = result.limitations.length ? "partial" : "empty";
+          await persistReview(pass, 0, false, data, true);
           return result;
         }
         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 {
@@ -122711,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;
           }
@@ -123526,5 +123539,5 @@ export {
   selectResearchMonitorEvents
 };
 
-//# debugId=DA8131B431BAFF9764756E2164756E21
+//# debugId=8B8DD9C3BFAE701F64756E2164756E21
 //# sourceMappingURL=index.js.map