@agentionai/agents 0.12.0 → 0.14.0

package/dist/agents/openai-compatible/OpenAICompatibleAgent.js

@@ -0,0 +1,249 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAICompatibleAgent = void 0;
+const openai_1 = __importDefault(require("openai"));
+const BaseAgent_1 = require("../BaseAgent");
+const AgentEvent_1 = require("../AgentEvent");
+const AgentError_1 = require("../errors/AgentError");
+const transformers_1 = require("../../history/transformers");
+const VizReporter_1 = require("../../viz/VizReporter");
+const VizConfig_1 = require("../../viz/VizConfig");
+/**
+ * Abstract base class for agents that talk to any OpenAI-compatible
+ * `/v1/chat/completions` endpoint (llama.cpp, vLLM, LM Studio, etc.).
+ *
+ * Subclasses must implement:
+ * - `getVendorName()` — human-readable name used in error messages (e.g. `"llama.cpp"`)
+ *
+ * Subclasses may override:
+ * - `buildExtraRequestParams()` — extra fields merged into the completions request
+ */
+class OpenAICompatibleAgent extends BaseAgent_1.BaseAgent {
+    constructor(config, history) {
+        super(config, history);
+        this.currentToolCallCount = 0;
+        this.client = new openai_1.default({
+            apiKey: config.apiKey || "not-needed",
+            baseURL: config.baseURL,
+        });
+        this.config = {
+            model: config.model,
+            baseURL: config.baseURL,
+            maxTokens: config.maxTokens,
+            temperature: config.temperature,
+            topP: config.topP,
+            stopSequences: config.stopSequences,
+            seed: config.seed,
+            presencePenalty: config.presencePenalty,
+            frequencyPenalty: config.frequencyPenalty,
+            apiKey: config.apiKey,
+        };
+        this.addSystemMessage(this.getSystemMessage());
+    }
+    /** Extra fields to merge into the chat completions request. Override for vendor-specific params. */
+    buildExtraRequestParams() {
+        return {};
+    }
+    /**
+     * List the models available on the server via the `/v1/models` endpoint.
+     */
+    async listModels() {
+        try {
+            const page = await this.client.models.list();
+            return page.data;
+        }
+        catch (error) {
+            throw new AgentError_1.ExecutionError(`Failed to list ${this.getVendorName()} models: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    getToolDefinitions() {
+        return Array.from(this.tools.values()).map((tool) => {
+            const prompt = tool.getPrompt();
+            return {
+                type: "function",
+                function: {
+                    name: prompt.name,
+                    description: prompt.description,
+                    parameters: prompt.input_schema,
+                },
+            };
+        });
+    }
+    async process(_input) {
+        return "";
+    }
+    async execute(input) {
+        this.emit(AgentEvent_1.AgentEvent.BEFORE_EXECUTE, input);
+        this.lastTokenUsage = undefined;
+        this.currentToolCallCount = 0;
+        const inputPreview = typeof input === "string" ? input : JSON.stringify(input);
+        if (VizConfig_1.vizConfig.isEnabled()) {
+            this.vizEventId = VizReporter_1.vizReporter.agentStart(this.id, this.name, this.config.model, this.vendor, inputPreview);
+        }
+        if (this.history.transient) {
+            this.history.clear();
+            this.addSystemMessage(this.getSystemMessage());
+        }
+        if (typeof input === "string") {
+            this.addTextToHistory("user", input);
+        }
+        else {
+            this.addMessageToHistory("user", input);
+        }
+        this.history.setSessionAnchor();
+        this.history.beginExecution();
+        try {
+            const response = await this.callProvider();
+            this.emit(AgentEvent_1.AgentEvent.AFTER_EXECUTE, response);
+            return await this.handleResponse(response);
+        }
+        catch (error) {
+            if (error instanceof openai_1.default.APIError) {
+                const apiError = new AgentError_1.ApiError(`${this.getVendorName()} API error: ${error.message}`, error.status, error);
+                this.emit(AgentEvent_1.AgentEvent.ERROR, apiError);
+                if (this.vizEventId) {
+                    VizReporter_1.vizReporter.agentError(this.vizEventId, "ApiError", apiError.message, error.status === 429);
+                    this.vizEventId = undefined;
+                }
+                throw apiError;
+            }
+            if (error instanceof AgentError_1.AgentError) {
+                this.emit(AgentEvent_1.AgentEvent.ERROR, error);
+                if (this.vizEventId) {
+                    VizReporter_1.vizReporter.agentError(this.vizEventId, error.constructor.name, error.message, false);
+                    this.vizEventId = undefined;
+                }
+                throw error;
+            }
+            const executionError = new AgentError_1.ExecutionError(`${this.getVendorName()} error: ${error instanceof Error ? error.message : "Unknown error"}`);
+            this.emit(AgentEvent_1.AgentEvent.ERROR, executionError);
+            if (this.vizEventId) {
+                VizReporter_1.vizReporter.agentError(this.vizEventId, "ExecutionError", executionError.message, false);
+                this.vizEventId = undefined;
+            }
+            throw executionError;
+        }
+        finally {
+            this.history.endExecution();
+        }
+    }
+    async callProvider() {
+        const messages = transformers_1.chatCompletionsTransformer.toProvider(this.history.getEntries());
+        const tools = this.tools.size > 0 ? this.getToolDefinitions() : undefined;
+        return this.client.chat.completions.create({
+            model: this.config.model,
+            messages,
+            tools,
+            stream: false,
+            max_tokens: this.config.maxTokens,
+            temperature: this.config.temperature,
+            top_p: this.config.topP,
+            stop: this.config.stopSequences,
+            seed: this.config.seed,
+            presence_penalty: this.config.presencePenalty,
+            frequency_penalty: this.config.frequencyPenalty,
+            ...this.buildExtraRequestParams(),
+        });
+    }
+    async handleResponse(response) {
+        const usage = this.parseUsage(response);
+        if (this.lastTokenUsage) {
+            this.lastTokenUsage.input_tokens += usage.input_tokens;
+            this.lastTokenUsage.output_tokens += usage.output_tokens;
+            this.lastTokenUsage.total_tokens += usage.total_tokens;
+        }
+        else {
+            this.lastTokenUsage = { ...usage };
+        }
+        const choice = response.choices[0];
+        const message = choice.message;
+        if (choice.finish_reason === "length") {
+            const error = new AgentError_1.MaxTokensExceededError("Response exceeded maximum token limit", this.config.maxTokens || 1024);
+            this.emit(AgentEvent_1.AgentEvent.MAX_TOKENS_EXCEEDED, error);
+            this.emit(AgentEvent_1.AgentEvent.ERROR, error);
+            if (this.vizEventId) {
+                VizReporter_1.vizReporter.agentError(this.vizEventId, "MaxTokensExceededError", error.message, false);
+                this.vizEventId = undefined;
+            }
+            throw error;
+        }
+        const hasToolCalls = message.tool_calls && message.tool_calls.length > 0;
+        if (!hasToolCalls) {
+            const textContent = message.content || "";
+            const entry = transformers_1.chatCompletionsTransformer.fromProviderMessage(message);
+            this.addToHistory(entry);
+            this.emit(AgentEvent_1.AgentEvent.DONE, message, usage);
+            if (this.vizEventId) {
+                VizReporter_1.vizReporter.agentComplete(this.vizEventId, {
+                    input: this.lastTokenUsage?.input_tokens || 0,
+                    output: this.lastTokenUsage?.output_tokens || 0,
+                    total: this.lastTokenUsage?.total_tokens || 0,
+                }, "end_turn", this.currentToolCallCount > 0, this.currentToolCallCount, textContent);
+                this.vizEventId = undefined;
+            }
+            return textContent;
+        }
+        const toolCalls = message.tool_calls;
+        this.emit(AgentEvent_1.AgentEvent.TOOL_USE, toolCalls);
+        this.currentToolCallCount += toolCalls.length;
+        const assistantEntry = transformers_1.chatCompletionsTransformer.fromProviderMessage(message);
+        this.addToHistory(assistantEntry);
+        const toolResults = await this.handleToolCalls(toolCalls);
+        for (const result of toolResults) {
+            const resultEntry = transformers_1.chatCompletionsTransformer.toolResultEntry(result.toolCallId, result.content);
+            this.addToHistory(resultEntry);
+        }
+        try {
+            const newResponse = await this.callProvider();
+            this.emit(AgentEvent_1.AgentEvent.AFTER_EXECUTE, newResponse);
+            return this.handleResponse(newResponse);
+        }
+        catch (error) {
+            const executionError = new AgentError_1.ExecutionError(`${this.getVendorName()} error during tool response: ${error instanceof Error ? error.message : "Unknown error"}`);
+            this.emit(AgentEvent_1.AgentEvent.ERROR, executionError);
+            throw executionError;
+        }
+    }
+    async handleToolCalls(toolCalls) {
+        return Promise.all(toolCalls.map(async (toolCall) => {
+            const toolName = toolCall.type === "function" ? toolCall.function.name : "";
+            const tool = this.tools.get(toolName);
+            const toolCallId = toolCall.id;
+            if (toolCall.type !== "function" || !tool) {
+                const errorMessage = `Tool '${toolName}' not found`;
+                const error = new AgentError_1.ToolExecutionError(errorMessage, toolName, toolCall.type === "function"
+                    ? toolCall.function.arguments
+                    : undefined);
+                this.emit(AgentEvent_1.AgentEvent.TOOL_ERROR, error);
+                return { toolCallId, content: errorMessage };
+            }
+            try {
+                const args = JSON.parse(toolCall.function.arguments || "{}");
+                const result = await tool.execute(this.getId(), this.getName(), args, toolCallId, this.config.model, this.vendor);
+                return { toolCallId, content: JSON.stringify(result) };
+            }
+            catch (error) {
+                const errorMessage = `Error executing tool '${toolName}': ${error instanceof Error ? error.message : "Unknown error"}`;
+                if (this.debug) {
+                    console.error(errorMessage);
+                }
+                const toolError = new AgentError_1.ToolExecutionError(errorMessage, toolName, toolCall.function.arguments);
+                this.emit(AgentEvent_1.AgentEvent.TOOL_ERROR, toolError);
+                return { toolCallId, content: errorMessage };
+            }
+        }));
+    }
+    parseUsage(response) {
+        const usage = response.usage;
+        return {
+            input_tokens: usage?.prompt_tokens ?? 0,
+            output_tokens: usage?.completion_tokens ?? 0,
+            total_tokens: usage?.total_tokens ?? 0,
+        };
+    }
+}
+exports.OpenAICompatibleAgent = OpenAICompatibleAgent;
+//# sourceMappingURL=OpenAICompatibleAgent.js.map

package/dist/core.d.ts

@@ -7,6 +7,7 @@ export * from "./history/History";
 export * from "./history/types";
 export * from "./graph/AgentGraph";
 export * from "./tools/Tool";
+export * from "./tools/BuiltInTool";
 export * from "./mcp";
 export * from "./viz";
 export * from "./embeddings";

package/dist/core.js

@@ -29,6 +29,7 @@ __exportStar(require("./history/types"), exports);
 __exportStar(require("./graph/AgentGraph"), exports);
 // Tools
 __exportStar(require("./tools/Tool"), exports);
+__exportStar(require("./tools/BuiltInTool"), exports);
 // MCP (Model Context Protocol)
 __exportStar(require("./mcp"), exports);
 // Visualization

package/dist/history/transformers.d.ts

@@ -134,5 +134,69 @@ export declare const ollamaTransformer: {
      */
     toolResultEntry(tool_call_id: string, output: string): HistoryEntry;
 };
+/**
+ * Convert normalized entries to/from the OpenAI Chat Completions message format
+ * (`/v1/chat/completions`). Used by `LlamaCppAgent` and any other agent that
+ * targets an OpenAI-compatible chat-completions endpoint.
+ */
+export declare const chatCompletionsTransformer: {
+    /**
+     * Convert normalized entries to Chat Completions message format.
+     * Tool results become role:"tool" messages; tool calls are embedded in assistant messages.
+     */
+    toProvider(entries: HistoryEntry[]): ChatCompletionMessage[];
+    /**
+     * Convert a Chat Completions response message to a normalized HistoryEntry.
+     */
+    fromProviderMessage(message: ChatCompletionResponseMessage): HistoryEntry;
+    /**
+     * Create a normalized tool result entry for a Chat Completions tool call
+     */
+    toolResultEntry(tool_call_id: string, output: string): HistoryEntry;
+};
+type ChatCompletionToolCallParam = {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+};
+type ChatCompletionContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "auto" | "low" | "high";
+    };
+};
+type ChatCompletionMessage = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: string | ChatCompletionContentPart[];
+} | {
+    role: "assistant";
+    content: string | null;
+    tool_calls?: ChatCompletionToolCallParam[];
+} | {
+    role: "tool";
+    tool_call_id: string;
+    content: string;
+};
+type ChatCompletionResponseMessage = {
+    role: string;
+    content: string | null;
+    tool_calls?: Array<{
+        id: string;
+        function?: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+};
 export {};
 //# sourceMappingURL=transformers.d.ts.map

package/dist/history/transformers.js

@@ -5,7 +5,7 @@
  * Transform between normalized HistoryEntry format and provider-specific formats.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ollamaTransformer = exports.geminiTransformer = exports.mistralTransformer = exports.openAiTransformer = exports.anthropicTransformer = void 0;
+exports.chatCompletionsTransformer = exports.ollamaTransformer = exports.geminiTransformer = exports.mistralTransformer = exports.openAiTransformer = exports.anthropicTransformer = void 0;
 const types_1 = require("./types");
 // =============================================================================
 // Anthropic Transformer
@@ -576,4 +576,121 @@ exports.ollamaTransformer = {
         };
     },
 };
+// =============================================================================
+// Chat Completions Transformer (OpenAI-compatible servers, e.g. llama.cpp)
+// =============================================================================
+/**
+ * Convert normalized entries to/from the OpenAI Chat Completions message format
+ * (`/v1/chat/completions`). Used by `LlamaCppAgent` and any other agent that
+ * targets an OpenAI-compatible chat-completions endpoint.
+ */
+exports.chatCompletionsTransformer = {
+    /**
+     * Convert normalized entries to Chat Completions message format.
+     * Tool results become role:"tool" messages; tool calls are embedded in assistant messages.
+     */
+    toProvider(entries) {
+        const messages = [];
+        for (const entry of entries) {
+            const textBlocks = entry.content.filter(types_1.isTextContent);
+            const toolUseBlocks = entry.content.filter(types_1.isToolUseContent);
+            const toolResultBlocks = entry.content.filter(types_1.isToolResultContent);
+            const imageUrlBlocks = entry.content.filter(types_1.isImageUrlContent);
+            const imageBase64Blocks = entry.content.filter(types_1.isImageBase64Content);
+            const hasImages = imageUrlBlocks.length > 0 || imageBase64Blocks.length > 0;
+            if (entry.role === "system") {
+                messages.push({ role: "system", content: textBlocks.map((c) => c.text).join("\n") });
+                continue;
+            }
+            if (entry.role === "assistant") {
+                const msg = {
+                    role: "assistant",
+                    content: textBlocks.map((c) => c.text).join("\n") || null,
+                };
+                if (toolUseBlocks.length > 0) {
+                    msg.tool_calls = toolUseBlocks.map((block) => ({
+                        id: block.id,
+                        type: "function",
+                        function: {
+                            name: block.name,
+                            arguments: JSON.stringify(block.input),
+                        },
+                    }));
+                }
+                messages.push(msg);
+                continue;
+            }
+            // User role — could be text, images, or tool results
+            if (toolResultBlocks.length > 0) {
+                for (const result of toolResultBlocks) {
+                    messages.push({
+                        role: "tool",
+                        tool_call_id: result.tool_use_id,
+                        content: result.content,
+                    });
+                }
+            }
+            else if (hasImages) {
+                const parts = [];
+                for (const block of entry.content) {
+                    if ((0, types_1.isTextContent)(block)) {
+                        parts.push({ type: "text", text: block.text });
+                    }
+                    else if ((0, types_1.isImageUrlContent)(block)) {
+                        parts.push({
+                            type: "image_url",
+                            image_url: {
+                                url: block.url,
+                                ...(block.detail ? { detail: block.detail } : {}),
+                            },
+                        });
+                    }
+                    else if ((0, types_1.isImageBase64Content)(block)) {
+                        parts.push({
+                            type: "image_url",
+                            image_url: { url: `data:${block.mimeType};base64,${block.data}` },
+                        });
+                    }
+                }
+                messages.push({ role: "user", content: parts });
+            }
+            else if (textBlocks.length > 0) {
+                messages.push({ role: "user", content: textBlocks.map((c) => c.text).join("\n") });
+            }
+        }
+        return messages;
+    },
+    /**
+     * Convert a Chat Completions response message to a normalized HistoryEntry.
+     */
+    fromProviderMessage(message) {
+        const content = [];
+        if (typeof message.content === "string" && message.content) {
+            content.push((0, types_1.text)(message.content));
+        }
+        if (message.tool_calls) {
+            message.tool_calls.forEach((call) => {
+                if (!call.function)
+                    return;
+                const args = JSON.parse(call.function.arguments || "{}");
+                content.push((0, types_1.toolUse)(call.id, call.function.name, args));
+            });
+        }
+        return {
+            role: "assistant",
+            content,
+            meta: { provider: "llamacpp" },
+        };
+    },
+    /**
+     * Create a normalized tool result entry for a Chat Completions tool call
+     */
+    toolResultEntry(tool_call_id, output) {
+        return {
+            role: "user",
+            content: [(0, types_1.toolResult)(tool_call_id, output)],
+            meta: { provider: "llamacpp", tool_call_id },
+        };
+    },
+};
 //# sourceMappingURL=transformers.js.map

package/dist/history/types.d.ts

@@ -94,10 +94,17 @@ export type OllamaMeta = {
     provider: "ollama";
     tool_call_id?: string;
 };
+/**
+ * llama.cpp-specific metadata
+ */
+export type LlamaCppMeta = {
+    provider: "llamacpp";
+    tool_call_id?: string;
+};
 /**
  * Union of all provider metadata types
  */
-export type ProviderMeta = AnthropicMeta | OpenAiMeta | MistralMeta | GeminiMeta | OllamaMeta;
+export type ProviderMeta = AnthropicMeta | OpenAiMeta | MistralMeta | GeminiMeta | OllamaMeta | LlamaCppMeta;
 /**
  * Valid roles for history entries
  */

package/dist/index.d.ts

@@ -4,15 +4,19 @@ export { OpenAiAgent } from "./agents/openai/OpenAiAgent";
 export { MistralAgent } from "./agents/mistral/MistralAgent";
 export { GeminiAgent } from "./agents/google/GeminiAgent";
 export { OllamaAgent } from "./agents/ollama/OllamaAgent";
+export { LlamaCppAgent } from "./agents/llamacpp/LlamaCppAgent";
+export { OpenAICompatibleAgent } from "./agents/openai-compatible/OpenAICompatibleAgent";
+export type { OpenAICompatibleConfig } from "./agents/openai-compatible/OpenAICompatibleAgent";
 export * from "./agents/model-types";
 export * from "./agents/AgentConfig";
 export * from "./agents/AgentEvent";
 export * from "./agents/errors/AgentError";
 export * from "./history/History";
 export * from "./history/types";
-export { anthropicTransformer, openAiTransformer, mistralTransformer, geminiTransformer, ollamaTransformer, } from "./history/transformers";
+export { anthropicTransformer, openAiTransformer, mistralTransformer, geminiTransformer, ollamaTransformer, chatCompletionsTransformer, } from "./history/transformers";
 export * from "./graph/AgentGraph";
 export * from "./tools/Tool";
+export * from "./tools/BuiltInTool";
 export * from "./mcp";
 export * from "./viz";
 export * from "./vectorstore";

package/dist/index.js

@@ -22,7 +22,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ollamaTransformer = exports.geminiTransformer = exports.mistralTransformer = exports.openAiTransformer = exports.anthropicTransformer = exports.OllamaAgent = exports.GeminiAgent = exports.MistralAgent = exports.OpenAiAgent = void 0;
+exports.chatCompletionsTransformer = exports.ollamaTransformer = exports.geminiTransformer = exports.mistralTransformer = exports.openAiTransformer = exports.anthropicTransformer = exports.OpenAICompatibleAgent = exports.LlamaCppAgent = exports.OllamaAgent = exports.GeminiAgent = exports.MistralAgent = exports.OpenAiAgent = void 0;
 // Agents
 __exportStar(require("./agents/BaseAgent"), exports);
 __exportStar(require("./agents/anthropic/ClaudeAgent"), exports);
@@ -34,6 +34,10 @@ var GeminiAgent_1 = require("./agents/google/GeminiAgent");
 Object.defineProperty(exports, "GeminiAgent", { enumerable: true, get: function () { return GeminiAgent_1.GeminiAgent; } });
 var OllamaAgent_1 = require("./agents/ollama/OllamaAgent");
 Object.defineProperty(exports, "OllamaAgent", { enumerable: true, get: function () { return OllamaAgent_1.OllamaAgent; } });
+var LlamaCppAgent_1 = require("./agents/llamacpp/LlamaCppAgent");
+Object.defineProperty(exports, "LlamaCppAgent", { enumerable: true, get: function () { return LlamaCppAgent_1.LlamaCppAgent; } });
+var OpenAICompatibleAgent_1 = require("./agents/openai-compatible/OpenAICompatibleAgent");
+Object.defineProperty(exports, "OpenAICompatibleAgent", { enumerable: true, get: function () { return OpenAICompatibleAgent_1.OpenAICompatibleAgent; } });
 __exportStar(require("./agents/model-types"), exports);
 __exportStar(require("./agents/AgentConfig"), exports);
 __exportStar(require("./agents/AgentEvent"), exports);
@@ -47,10 +51,12 @@ Object.defineProperty(exports, "openAiTransformer", { enumerable: true, get: fun
 Object.defineProperty(exports, "mistralTransformer", { enumerable: true, get: function () { return transformers_1.mistralTransformer; } });
 Object.defineProperty(exports, "geminiTransformer", { enumerable: true, get: function () { return transformers_1.geminiTransformer; } });
 Object.defineProperty(exports, "ollamaTransformer", { enumerable: true, get: function () { return transformers_1.ollamaTransformer; } });
+Object.defineProperty(exports, "chatCompletionsTransformer", { enumerable: true, get: function () { return transformers_1.chatCompletionsTransformer; } });
 // Graph
 __exportStar(require("./graph/AgentGraph"), exports);
 // Tools
 __exportStar(require("./tools/Tool"), exports);
+__exportStar(require("./tools/BuiltInTool"), exports);
 // MCP (Model Context Protocol)
 __exportStar(require("./mcp"), exports);
 // Visualization

package/dist/llamacpp.d.ts

@@ -0,0 +1,6 @@
+export * from "./core";
+export { LlamaCppAgent } from "./agents/llamacpp/LlamaCppAgent";
+export { OpenAICompatibleAgent } from "./agents/openai-compatible/OpenAICompatibleAgent";
+export type { OpenAICompatibleConfig } from "./agents/openai-compatible/OpenAICompatibleAgent";
+export { chatCompletionsTransformer } from "./history/transformers";
+//# sourceMappingURL=llamacpp.d.ts.map

package/dist/llamacpp.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatCompletionsTransformer = exports.OpenAICompatibleAgent = exports.LlamaCppAgent = void 0;
+// llama.cpp / OpenAI-compatible Agent Entry Point
+__exportStar(require("./core"), exports);
+var LlamaCppAgent_1 = require("./agents/llamacpp/LlamaCppAgent");
+Object.defineProperty(exports, "LlamaCppAgent", { enumerable: true, get: function () { return LlamaCppAgent_1.LlamaCppAgent; } });
+var OpenAICompatibleAgent_1 = require("./agents/openai-compatible/OpenAICompatibleAgent");
+Object.defineProperty(exports, "OpenAICompatibleAgent", { enumerable: true, get: function () { return OpenAICompatibleAgent_1.OpenAICompatibleAgent; } });
+var transformers_1 = require("./history/transformers");
+Object.defineProperty(exports, "chatCompletionsTransformer", { enumerable: true, get: function () { return transformers_1.chatCompletionsTransformer; } });
+//# sourceMappingURL=llamacpp.js.map

package/dist/tools/BuiltInTool.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Provider-defined ("built-in" / server-side) tools.
+ *
+ * Unlike `Tool`, these are not executed locally — the provider runs them as
+ * part of generating its response (e.g. Anthropic's web search, bash, and
+ * text editor tools). They carry no `execute` function or input schema; the
+ * agent simply forwards their definition to the provider's API.
+ *
+ * Pass arbitrary built-in tool definitions straight through — only `type`
+ * and `name` are required, any other provider-specific fields are allowed:
+ *
+ * @example
+ * ```typescript
+ * const agent = new ClaudeAgent({
+ *   ...,
+ *   builtInTools: [
+ *     { type: "web_search_20250305", name: "web_search", max_uses: 5 },
+ *   ],
+ * });
+ * ```
+ *
+ * Or use one of the helpers below for the well-known Anthropic tools.
+ */
+export interface BuiltInTool {
+    /** Provider-specific tool type identifier, e.g. `"web_search_20250305"` */
+    type: string;
+    /** Name the model will use to refer to the tool, e.g. `"web_search"` */
+    name: string;
+    /** Any additional provider-specific configuration for this tool */
+    [key: string]: unknown;
+}
+/**
+ * Options for Anthropic's web search tool (`web_search_20250305`).
+ * @see https://docs.anthropic.com/en/docs/build-with-claude/tool-use/web-search-tool
+ */
+export interface WebSearchToolOptions {
+    /** Maximum number of searches Claude can perform during the request */
+    maxUses?: number;
+    /** Only include results from these domains (mutually exclusive with `blockedDomains`) */
+    allowedDomains?: string[];
+    /** Never include results from these domains (mutually exclusive with `allowedDomains`) */
+    blockedDomains?: string[];
+    /** Approximate user location, used to localize search results */
+    userLocation?: {
+        type?: "approximate";
+        city?: string;
+        region?: string;
+        country?: string;
+        timezone?: string;
+    };
+}
+/**
+ * Anthropic's server-side web search tool.
+ * Claude decides when to search and the results are fetched and processed by Anthropic.
+ */
+export declare function webSearchTool(options?: WebSearchToolOptions): BuiltInTool;
+/**
+ * Anthropic's server-side bash tool — gives Claude a persistent shell session.
+ * Requires a compatible model (e.g. Claude 4 / 3.7 Sonnet) and beta header support.
+ */
+export declare function bashTool(): BuiltInTool;
+/**
+ * Anthropic's server-side text editor tool — lets Claude view and edit text files.
+ */
+export declare function textEditorTool(version?: "20250124" | "20250429" | "20250728"): BuiltInTool;
+/**
+ * Define an arbitrary provider-defined / built-in tool by its raw definition.
+ * Use this to pass through tools not covered by the helpers above (or for
+ * other providers that support server-side tools).
+ */
+export declare function builtInTool(definition: BuiltInTool): BuiltInTool;
+//# sourceMappingURL=BuiltInTool.d.ts.map