@absolutejs/ai 0.0.57 → 0.0.58

package/dist/src/ai/index.d.ts

@@ -41,3 +41,6 @@ export { AIInputError, inspectAIInput } from "./inputCapacity";
 export type { AIModelLimits, AIInputCapacity } from "./inputCapacity";
 export { prepareAITextInput } from "./prepareTextInput";
 export type { PreparedAITextInput, PrepareAITextInputOptions, } from "./prepareTextInput";
+export { createAITextSource } from "./textSource";
+export type { AITextPassage, AITextSource } from "./textSource";
+export type { AITextPreparationCheckpoint } from "./prepareTextInput";

package/dist/src/ai/prepareTextInput.d.ts

@@ -1,10 +1,22 @@
 import type { AIProviderConfig, AIProviderStreamParams, AIUsage } from "../../types/ai";
+export type AITextPreparationCheckpoint = {
+    version: 1;
+    taskHash: string;
+    prefixHash: string;
+    processedCharacters: number;
+    sectionsProcessed: number;
+    notes: string;
+};
 export type PreparedAITextInput = {
     params: AIProviderStreamParams;
     compacted: boolean;
     sectionsProcessed: number;
 };
 export type PrepareAITextInputOptions = {
+    /** Reuse only a server-owned checkpoint. Originals and task fingerprints are validated. */
+    checkpoint?: AITextPreparationCheckpoint;
+    /** Save after each finished section, before the next model call. Never accept client-supplied notes. */
+    onCheckpoint?: (checkpoint: AITextPreparationCheckpoint) => void | Promise<void>;
     /** Persist originals BEFORE calling. Returned notes are not a replacement for source storage. */
     onProgress?: (progress: {
         processedCharacters: number;

package/dist/src/ai/streamAIWithTools.d.ts

@@ -3,6 +3,10 @@ import { type GenerateAIOptions, type GenerateAIToolCall } from "./generateAI";
 export type StreamAIWithToolsOptions = Omit<GenerateAIOptions, "tools" | "toolChoice"> & {
     /** Tools the model may call — each with a `handler` the loop runs on its behalf. */
     tools: AIToolMap;
+    /** Stop immediately after one of these tools executes successfully; do not generate an extra reply. */
+    stopAfterTools?: string[];
+    /** Count every model request, including added tool results, against provider capacity. */
+    validateInput?: boolean;
     /** Max model⇄tool round-trips before forcing a final answer. Default 8. */
     maxTurns?: number;
     toolChoice?: AIProviderToolChoice;

package/dist/src/ai/textSource.d.ts

@@ -0,0 +1,19 @@
+import type { AIProviderMessage, AIToolMap } from "../../types/ai";
+export type AITextPassage = {
+    sourceId: string;
+    role: AIProviderMessage["role"];
+    start: number;
+    end: number;
+    totalCharacters: number;
+    text: string;
+};
+/** Session-scoped, read-only access to original text. No network or model calls.
+ * IDs/UTF-16 offsets stay stable when later messages are appended. Results carry
+ * verbatim source, not generated summaries. Persist originals separately.
+ */
+export declare const createAITextSource: (messages: readonly AIProviderMessage[]) => {
+    search: (query: string, sourceId?: string) => AITextPassage[];
+    read: (sourceId: string, start?: number, length?: number) => AITextPassage;
+    tools: AIToolMap;
+};
+export type AITextSource = ReturnType<typeof createAITextSource>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/ai",
-  "version": "0.0.57",
+  "version": "0.0.58",
   "homepage": "https://github.com/absolutejs/ai",
   "bugs": {
     "url": "https://github.com/absolutejs/ai/issues"