@absolutejs/rag 0.24.2 → 0.24.4

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.4 — 2026-11-03
+
+### Fixed
+
+- **Bind each review tool response to the exact batch pointers and cardinality, with bounded reasons and citations, instead of permitting a full-draft response.** (`createResearch`)
+
+## 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

package/changelog.json

@@ -2,6 +2,32 @@
 	"contract": 1,
 	"name": "@absolutejs/rag",
 	"releases": [
+		{
+			"changes": [
+				{
+					"kind": "fixed",
+					"summary": "Bind each review tool response to the exact batch pointers and cardinality, with bounded reasons and citations, instead of permitting a full-draft response.",
+					"symbols": [
+						"createResearch"
+					]
+				}
+			],
+			"date": "2026-11-03",
+			"version": "0.24.4"
+		},
+		{
+			"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": [
 				{

package/dist/research/index.js

@@ -122125,6 +122125,16 @@ var ReviewSchema = Type.Object({
     })
   }), { maxItems: 256 })
 });
+var reviewSchemaForPaths = (paths) => Type.Object({
+  fields: Type.Array(Type.Object({
+    ...ReviewSchema.properties.fields.items.properties,
+    path: Type.Union(paths.map((path) => Type.Literal(path))),
+    reason: Type.String({ maxLength: 180 }),
+    citations: Type.Array(Type.Object({ passageId: Type.String() }), {
+      maxItems: 4
+    })
+  }, { additionalProperties: false }), { minItems: paths.length, maxItems: paths.length })
+}, { additionalProperties: false });
 var researchLeaves = (value, maxFields = 128) => {
   const fields = [];
   const visit = (item, path, depth) => {
@@ -122688,9 +122698,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";
@@ -122709,7 +122727,7 @@ Correct the previous schema-invalid response using the validation diagnostics. T
           await persistReview(pass, offset, true, data);
           let reviewed;
           try {
-            reviewed = await generate("review", ReviewSchema, "Independently review EVERY JSON pointer and its value. supported requires exact quotes establishing the entire fact for the correct entity and time. A name mention or publication date is insufficient to establish employment, event date, ownership, or buying intent. Check all sources for actual factual contradictions. Complementary details from different sources are not a conflict; a price from one source and a term from another can jointly support a claim. Use conflicting only when sources make incompatible factual statements, unsupported for contradicted claims, unknown for missing support. Match the requested event period: an August release is not a September event even when published in September. Quoted wording must be verbatim; a paraphrase cannot be placed in quotation marks. Vendor claims about first/best status and performance metrics must remain explicitly attributed in the answer itself, not just in your reason. Null is unknown. Cite only supplied passage IDs; their text will be copied verbatim by the runtime. For each field, explicitly check answersQuestion (directly answers query/schema/instructions, not background or a non-answer), correctEntity, correctTime, and preservesScope. Read surrounding context and headings, not only the matching quote. A benefit/trial condition is not a program-wide rule; customer conditions are not partner conditions; eligible is not approved or automatic. Preserve exceptions, qualifiers and marketing attribution. Every check must pass for supported. A leader\u2019s education or career history does not answer who currently leads a team. Keep each reason under 25 words. Cite only the minimum passages needed to establish the entire field, at most four. Do not invent passage IDs. Read adjacent passages for conditions and exceptions, even when citing only one. Return each pointer once. Never treat this review as independent real-world verification.", {
+            reviewed = await generate("review", reviewSchemaForPaths(batch.map((field) => field.path)), "Review ONLY the JSON pointers supplied in fields for this batch. The full answer schema is context, not a request to review other fields or reconstruct the extraction. Return exactly one verdict per supplied pointer and nothing else. supported requires exact quotes establishing the entire fact for the correct entity and time. A name mention or publication date is insufficient to establish employment, event date, ownership, or buying intent. Check all sources for actual factual contradictions. Complementary details from different sources are not a conflict; a price from one source and a term from another can jointly support a claim. Use conflicting only when sources make incompatible factual statements, unsupported for contradicted claims, unknown for missing support. Match the requested event period: an August release is not a September event even when published in September. Quoted wording must be verbatim; a paraphrase cannot be placed in quotation marks. Vendor claims about first/best status and performance metrics must remain explicitly attributed in the answer itself, not just in your reason. Null is unknown. Cite only supplied passage IDs; their text will be copied verbatim by the runtime. For each field, explicitly check answersQuestion (directly answers query/schema/instructions, not background or a non-answer), correctEntity, correctTime, and preservesScope. Read surrounding context and headings, not only the matching quote. A benefit/trial condition is not a program-wide rule; customer conditions are not partner conditions; eligible is not approved or automatic. Preserve exceptions, qualifiers and marketing attribution. Every check must pass for supported. A leader\u2019s education or career history does not answer who currently leads a team. Keep each reason under 25 words. Cite only the minimum passages needed to establish the entire field, at most four. Do not invent passage IDs. Read adjacent passages for conditions and exceptions, even when citing only one. Return each pointer once. Never treat this review as independent real-world verification.", {
               query: input.query,
               asOf: result.generatedAt,
               instructions: task.instructions,
@@ -123539,5 +123557,5 @@ export {
   selectResearchMonitorEvents
 };
 
-//# debugId=8B8DD9C3BFAE701F64756E2164756E21
+//# debugId=1ED45F4872733D3D64756E2164756E21
 //# sourceMappingURL=index.js.map