@absolutejs/ai 0.0.18 → 0.0.20

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

@@ -1,4 +1,4 @@
-import type { AIProviderConfig, AIProviderMessage, AIProviderResponseFormat, AIProviderToolChoice, AIProviderToolDefinition, AIUsage, ReasoningConfig } from "../../types/ai";
+import type { AIProviderConfig, AIProviderMessage, AIProviderResponseFormat, AIProviderToolChoice, AIProviderToolDefinition, AIToolMap, AIUsage, ReasoningConfig } from "../../types/ai";
 export type GenerateAIToolCall = {
     id: string;
     name: string;
@@ -33,6 +33,28 @@ export type GenerateAIResult = {
  * JSON-parsed by the provider), and final token usage.
  */
 export declare const generateAI: (options: GenerateAIOptions) => Promise<GenerateAIResult>;
+export type GenerateAIWithToolsOptions = Omit<GenerateAIOptions, "tools" | "toolChoice"> & {
+    /** Tools the model may call — each with a `handler` the loop runs on its behalf. */
+    tools: AIToolMap;
+    /** Max model⇄tool round-trips before forcing a final answer. Default 6. */
+    maxTurns?: number;
+    /** Observe each executed tool call (name, parsed input, string result). */
+    onToolUse?: (name: string, input: unknown, result: string) => void;
+};
+export type GenerateAIWithToolsResult = {
+    text: string;
+    toolCalls: GenerateAIToolCall[];
+    usage?: AIUsage;
+    /** The full message thread incl. assistant tool_use + tool_result turns. */
+    messages: AIProviderMessage[];
+};
+/**
+ * Agentic, non-streaming generation: the model may call the provided handler tools, this
+ * runs them, feeds the results back, and loops until the model answers (or `maxTurns`).
+ * Transport-agnostic — usable from HTTP/SSE/generator paths, unlike the WebSocket `streamAI`.
+ * Returns the final text, every tool call made, summed usage, and the full message thread.
+ */
+export declare const generateAIWithTools: (options: GenerateAIWithToolsOptions) => Promise<GenerateAIWithToolsResult>;
 export type GenerateObjectAIOptions<T> = {
     provider: AIProviderConfig;
     model: string;

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

@@ -1,8 +1,8 @@
 export { aiChat } from "../plugins/aiChat";
 export { streamAI } from "./streamAI";
 export { streamAIToSSE } from "./streamAIToSSE";
-export { generateAI, generateObjectAI } from "./generateAI";
-export type { GenerateAIOptions, GenerateAIResult, GenerateAIToolCall, GenerateObjectAIOptions, GenerateObjectAIResult, } from "./generateAI";
+export { generateAI, generateAIWithTools, generateObjectAI, } from "./generateAI";
+export type { GenerateAIOptions, GenerateAIResult, GenerateAIToolCall, GenerateAIWithToolsOptions, GenerateAIWithToolsResult, GenerateObjectAIOptions, GenerateObjectAIResult, } from "./generateAI";
 export { createConversationManager } from "./conversationManager";
 export { resolveRenderers } from "./htmxRenderers";
 export { createMemoryStore } from "./memoryStore";