@absolutejs/rag 0.8.0 → 0.10.0

package/dist/src/angular/ai-rag-stream.service.d.ts

@@ -24,6 +24,7 @@ export declare class RAGStreamService extends AIStreamService {
         workflow: import("@angular/core").Signal<import("..").RAGAnswerWorkflowState>;
         branch: (messageId: string, content: string) => void;
         cancel: () => void;
+        edit: (messageId: string, content: string) => void;
         error: import("@angular/core").Signal<string | null>;
         isStreaming: import("@angular/core").Signal<boolean>;
         messages: import("@angular/core").Signal<import("@absolutejs/ai").AIMessage[]>;

package/dist/src/angular/ai-rag-workflow.service.d.ts

@@ -25,6 +25,7 @@ export declare class RAGWorkflowService extends RAGStreamService {
         workflow: import("@angular/core").Signal<import("..").RAGAnswerWorkflowState>;
         branch: (messageId: string, content: string) => void;
         cancel: () => void;
+        edit: (messageId: string, content: string) => void;
         error: import("@angular/core").Signal<string | null>;
         isStreaming: import("@angular/core").Signal<boolean>;
         messages: import("@angular/core").Signal<import("@absolutejs/ai").AIMessage[]>;

package/dist/src/client/createRAGAnswerWorkflow.d.ts

@@ -24,6 +24,7 @@ export declare const createRAGAnswerWorkflow: (path: string, conversationId?: st
     branch: (messageId: string, content: string) => void;
     cancel: () => void;
     destroy: () => void;
+    edit: (messageId: string, content: string) => void;
     send: (content: string, attachments?: AIAttachment[]) => void;
     subscribe: (callback: () => void) => () => void;
     error: string | null;

package/dist/src/index.d.ts

@@ -32,3 +32,6 @@ export type * from "@absolutejs/ai";
 export type * from "../types/engine";
 export { corpusTextHash, planRAGCorpus, reconcileRAGCorpus, } from "./retrieval/corpus";
 export type { RAGCorpusApply, RAGCorpusDocument, RAGCorpusPlan, RAGCorpusRecord, RAGCorpusResult, RAGCorpusStore, } from "./retrieval/corpus";
+export { chunkRAGOriginalText, readRAGOriginalText, type RAGOriginalText, type RAGOriginalTextLocator, } from "./ingestion/originalText";
+export { createRAGOriginalTextTools, type RAGOriginalTextToolsOptions } from "./retrieval/originalTextTools";
+export { createRAGQuoteReferences } from "./retrieval/quoteReferences";

package/dist/src/ingestion/originalText.d.ts

@@ -0,0 +1,29 @@
+import type { RAGDocumentChunk } from "../../types/engine";
+/** Offsets are UTF-16 code units, as used by JavaScript String.slice. */
+export type RAGOriginalTextLocator = {
+    sourceId: string;
+    version: string;
+    start: number;
+    end: number;
+};
+export type RAGOriginalText = {
+    sourceId: string;
+    version: string;
+    text: string;
+    title?: string;
+};
+/** Verifies identity/version and returns verbatim evidence; never normalizes it.
+ * The caller must authorize the source before loading it. Rejects invalid ranges
+ * instead of silently returning evidence with a different locator.
+ */
+export declare const readRAGOriginalText: (source: RAGOriginalText, locator: RAGOriginalTextLocator, maxCharacters?: number) => string;
+/** An opt-in ingestion path for citable text originals. Unlike format extraction,
+ * this preserves whitespace, repeated paragraphs and Unicode exactly. Prefer
+ * paragraph/line boundaries while retaining exact offsets and bounded overlap.
+ * Chunk size is an indexing choice, not a model context capacity limit.
+ */
+export declare const chunkRAGOriginalText: (source: RAGOriginalText, options?: {
+    maxCharacters?: number;
+    overlapCharacters?: number;
+    metadata?: Record<string, unknown>;
+}) => RAGDocumentChunk[];

package/dist/src/react/useRAG.d.ts

@@ -290,6 +290,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         workflow: import("..").RAGAnswerWorkflowState;
         branch: (messageId: string, content: string) => void;
         cancel: () => void;
+        edit: (messageId: string, content: string) => void;
         error: string | null;
         isStreaming: boolean;
         messages: import("@absolutejs/ai").AIMessage[];
@@ -344,6 +345,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         workflow: import("..").RAGAnswerWorkflowState;
         branch: (messageId: string, content: string) => void;
         cancel: () => void;
+        edit: (messageId: string, content: string) => void;
         error: string | null;
         isStreaming: boolean;
         messages: import("@absolutejs/ai").AIMessage[];

package/dist/src/react/useRAGStream.d.ts

@@ -47,6 +47,7 @@ export declare const useRAGStream: (path?: string, conversationId?: string) => {
     workflow: import("..").RAGAnswerWorkflowState;
     branch: (messageId: string, content: string) => void;
     cancel: () => void;
+    edit: (messageId: string, content: string) => void;
     error: string | null;
     isStreaming: boolean;
     messages: import("@absolutejs/ai").AIMessage[];

package/dist/src/react/useRAGWorkflow.d.ts

@@ -47,6 +47,7 @@ export declare const useRAGWorkflow: (path?: string, conversationId?: string) =>
     workflow: import("..").RAGAnswerWorkflowState;
     branch: (messageId: string, content: string) => void;
     cancel: () => void;
+    edit: (messageId: string, content: string) => void;
     error: string | null;
     isStreaming: boolean;
     messages: import("@absolutejs/ai").AIMessage[];

package/dist/src/retrieval/originalTextTools.d.ts

@@ -0,0 +1,23 @@
+import type { AIToolMap } from "@absolutejs/ai";
+import type { RAGCollection, RAGCollectionSearchResult } from "../../types/engine";
+import { type RAGOriginalText } from "../ingestion/originalText";
+export type RAGOriginalTextToolsOptions = {
+    collection: Pick<RAGCollection, "searchWithTrace">;
+    /** Server-owned authorization/version constraints. Tool input cannot replace them. */
+    filter: Record<string, unknown>;
+    /** Must reauthorize every read and return null for deleted/inaccessible versions. */
+    loadSource: (sourceId: string, version: string) => Promise<RAGOriginalText | null>;
+    /** Use the chosen model's tokenizer and a budget reserved by the AI context policy. */
+    budget: {
+        maxTokens: number;
+        countTokens: (serializedResult: string) => Promise<number>;
+    };
+    /** Server-selected result count; candidates are still ranked before budgeting. */
+    searchTopK?: number;
+    signal?: AbortSignal;
+    onTrace?: (trace: RAGCollectionSearchResult["trace"]) => void;
+};
+/** Hybrid retrieval plus independently authorized, verbatim source verification.
+ * Index text is never returned as evidence without resolving its original range.
+ */
+export declare const createRAGOriginalTextTools: (options: RAGOriginalTextToolsOptions) => AIToolMap;

package/dist/src/retrieval/quoteReferences.d.ts

@@ -0,0 +1,13 @@
+/** A request-scoped, reversible encoding of already-retrieved verbatim quotes.
+ * This is not an authorization mechanism: encode only server-owned tool results,
+ * and reauthorize/revalidate resolved quotes against originals before committing.
+ * Keep one registry across prefetch, subsequent lookups and completion. */
+export declare const createRAGQuoteReferences: () => {
+    /** Accepts the JSON envelopes returned by original-text search/read tools.
+     * Unrecognized results and tool errors pass through unchanged. Source text
+     * is not interpreted as JSON or instructions. Caller retains the originals. */
+    encodeToolResult: (serialized: string) => string;
+    /** Resolve only a reference issued by this registry. A reference from another
+     * request is never loaded from a global cache or used to fetch a source. */
+    resolve: (reference: string) => string;
+};

package/dist/src/svelte/createRAG.d.ts

@@ -256,6 +256,7 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
         branch: (messageId: string, content: string) => void;
         cancel: () => void;
         destroy: () => void;
+        edit: (messageId: string, content: string) => void;
         send: (content: string, attachments?: import("@absolutejs/ai").AIAttachment[]) => void;
         subscribe: (callback: () => void) => () => void;
     };
@@ -285,6 +286,7 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
         branch: (messageId: string, content: string) => void;
         cancel: () => void;
         destroy: () => void;
+        edit: (messageId: string, content: string) => void;
         send: (content: string, attachments?: import("@absolutejs/ai").AIAttachment[]) => void;
         subscribe: (callback: () => void) => () => void;
     };

package/dist/src/svelte/createRAGStream.d.ts

@@ -24,6 +24,7 @@ export declare const createRAGStream: (path: string, conversationId?: string) =>
     branch: (messageId: string, content: string) => void;
     cancel: () => void;
     destroy: () => void;
+    edit: (messageId: string, content: string) => void;
     send: (content: string, attachments?: AIAttachment[]) => void;
     subscribe: (callback: () => void) => () => void;
 };

package/dist/src/svelte/createRAGWorkflow.d.ts

@@ -24,6 +24,7 @@ export declare const createRAGWorkflow: (path: string, conversationId?: string)
     branch: (messageId: string, content: string) => void;
     cancel: () => void;
     destroy: () => void;
+    edit: (messageId: string, content: string) => void;
     send: (content: string, attachments?: import("@absolutejs/ai").AIAttachment[]) => void;
     subscribe: (callback: () => void) => () => void;
 };

package/dist/src/vue/useRAG.d.ts

@@ -2889,6 +2889,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         branch: (messageId: string, content: string) => void;
         cancel: () => void;
         destroy: () => void;
+        edit: (messageId: string, content: string) => void;
         error: import("vue").Ref<string | null, string | null>;
         isStreaming: import("vue").Ref<boolean, boolean>;
         messages: import("vue").ShallowRef<import("@absolutejs/ai").AIMessage[], import("@absolutejs/ai").AIMessage[]>;
@@ -2923,6 +2924,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         branch: (messageId: string, content: string) => void;
         cancel: () => void;
         destroy: () => void;
+        edit: (messageId: string, content: string) => void;
         error: import("vue").Ref<string | null, string | null>;
         isStreaming: import("vue").Ref<boolean, boolean>;
         messages: import("vue").ShallowRef<import("@absolutejs/ai").AIMessage[], import("@absolutejs/ai").AIMessage[]>;

package/dist/src/vue/useRAGStream.d.ts

@@ -27,6 +27,7 @@ export declare const useRAGStream: (path: string, conversationId?: string) => {
     branch: (messageId: string, content: string) => void;
     cancel: () => void;
     destroy: () => void;
+    edit: (messageId: string, content: string) => void;
     error: import("vue").Ref<string | null, string | null>;
     isStreaming: import("vue").Ref<boolean, boolean>;
     messages: import("vue").ShallowRef<import("@absolutejs/ai").AIMessage[], import("@absolutejs/ai").AIMessage[]>;

package/dist/src/vue/useRAGWorkflow.d.ts

@@ -27,6 +27,7 @@ export declare const useRAGWorkflow: (path: string, conversationId?: string) =>
     branch: (messageId: string, content: string) => void;
     cancel: () => void;
     destroy: () => void;
+    edit: (messageId: string, content: string) => void;
     error: import("vue").Ref<string | null, string | null>;
     isStreaming: import("vue").Ref<boolean, boolean>;
     messages: import("vue").ShallowRef<import("@absolutejs/ai").AIMessage[], import("@absolutejs/ai").AIMessage[]>;

package/dist/svelte/index.js

@@ -4984,22 +4984,22 @@ var createRAG = (path, options = {}) => {
   };
 };
 export {
-  createRAGWorkflow,
-  createRAGStreamProgress,
-  createRAGStream,
-  createRAGStatus,
-  createRAGSources,
-  createRAGSearch,
-  createRAGOps,
-  createRAGIngest,
-  createRAGIndexAdmin,
-  createRAGGrounding,
-  createRAGEvaluate,
-  createRAGDocuments,
-  createRAGCitations,
+  createRAG,
   createRAGChunkPreview,
-  createRAG
+  createRAGCitations,
+  createRAGDocuments,
+  createRAGEvaluate,
+  createRAGGrounding,
+  createRAGIndexAdmin,
+  createRAGIngest,
+  createRAGOps,
+  createRAGSearch,
+  createRAGSources,
+  createRAGStatus,
+  createRAGStream,
+  createRAGStreamProgress,
+  createRAGWorkflow
 };
 
-//# debugId=0C820FFEEA16A64064756E2164756E21
+//# debugId=404BF31250240B0064756E2164756E21
 //# sourceMappingURL=index.js.map