@absolutejs/rag 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -6,6 +6,16 @@ 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.10.0 — 2026-09-16
+
+### Added
+
+- **Encode retrieved original-text passages as request-scoped quote references and restore exact quotes without rewriting source text** (`createRAGQuoteReferences`)
+
+### Changed
+
+- **Accept AI 0.2 alongside existing compatible AI releases; validate retrieval against AI 0.2.0** (`ragChat`, `createRAGWorkflow`)
+
 ## 0.9.0 — 2026-09-16
 
 ### Breaking

package/README.md

@@ -110,3 +110,18 @@ saved-source recovery callback when appropriate. Providers without capacity
 support require an explicit `contextPolicy: false` raw opt-out. Older supported
 AI peers retain their previous behavior; upgrading RAG alone does not add the AI
 0.1 capacity policy. No model-capacity numbers are defined in RAG.
+
+### Reversible quote references
+
+`createRAGQuoteReferences()` creates a request-scoped registry for compressing
+already-verified original-text tool results. `encodeToolResult(json)` replaces
+passage text with sentence entries `{ citation, text }`; `resolve(citation)`
+restores the exact registered sentence. Repeated sentences reuse a reference,
+and unknown references throw. Search and single-range read envelopes are
+supported; unrecognized tool results pass through unchanged.
+
+Keep the registry alive across prefetch, lookups and completion, then discard
+it. Only encode server-owned original-text tool results. References are not
+access controls or durable source IDs: reauthorize and validate restored quotes
+against the originals before saving a result. This is opt-in; it does not change
+the original-text tools, stored originals or their existing result format.

package/changelog.json

@@ -2,6 +2,27 @@
 	"contract": 1,
 	"name": "@absolutejs/rag",
 	"releases": [
+		{
+			"changes": [
+				{
+					"kind": "added",
+					"summary": "Encode retrieved original-text passages as request-scoped quote references and restore exact quotes without rewriting source text",
+					"symbols": [
+						"createRAGQuoteReferences"
+					]
+				},
+				{
+					"kind": "changed",
+					"summary": "Accept AI 0.2 alongside existing compatible AI releases; validate retrieval against AI 0.2.0",
+					"symbols": [
+						"ragChat",
+						"createRAGWorkflow"
+					]
+				}
+			],
+			"date": "2026-09-16",
+			"version": "0.10.0"
+		},
 		{
 			"changes": [
 				{

package/dist/index.js

@@ -36572,6 +36572,56 @@ var createRAGOriginalTextTools = (options) => {
     }
   };
 };
+// src/retrieval/quoteReferences.ts
+var createRAGQuoteReferences = () => {
+  const quotes = new Map;
+  const references = new Map;
+  const record2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+  const encodePassage = (passage) => {
+    if (!record2(passage) || typeof passage.text !== "string")
+      return passage;
+    const { text, ...metadata } = passage;
+    const sentences = text.split(/(?<=[.!?])\s+(?=[A-Z])|\n+/u).filter((sentence) => sentence.trim());
+    return {
+      ...metadata,
+      sentences: sentences.map((sentence) => {
+        let citation = references.get(sentence);
+        if (!citation) {
+          citation = `e${quotes.size + 1}`;
+          references.set(sentence, citation);
+          quotes.set(citation, sentence);
+        }
+        return { citation, text: sentence };
+      })
+    };
+  };
+  return {
+    encodeToolResult: (serialized) => {
+      let value;
+      try {
+        value = JSON.parse(serialized);
+      } catch {
+        return serialized;
+      }
+      if (!record2(value) || value.referenceOnly !== true)
+        return serialized;
+      if (Array.isArray(value.passages))
+        return JSON.stringify({
+          ...value,
+          passages: value.passages.map(encodePassage)
+        });
+      if (typeof value.text === "string")
+        return JSON.stringify(encodePassage(value));
+      return serialized;
+    },
+    resolve: (reference) => {
+      const quote = quotes.get(reference);
+      if (quote === undefined)
+        throw new Error("Unknown retrieved quote reference");
+      return quote;
+    }
+  };
+};
 export {
   addRAGEvaluationSuiteCase,
   addRAGEvaluationSuiteCaseHardNegative,
@@ -36732,6 +36782,7 @@ export {
   createRAGPresentationCueBenchmarkSnapshot,
   createRAGPresentationCueBenchmarkSuite,
   createRAGQueryTransform,
+  createRAGQuoteReferences,
   createRAGReranker,
   createRAGSQLiteAnswerGroundingEvaluationHistoryStore,
   createRAGSQLiteEvaluationHistoryStore,
@@ -36878,5 +36929,5 @@ export {
   xaiEmbeddings
 };
 
-//# debugId=24B2DCBF7983282F64756E2164756E21
+//# debugId=2522635E4551C85B64756E2164756E21
 //# sourceMappingURL=index.js.map