kagent-ts 0.1.4 → 0.1.5

package/dist/llm/anthropic-provider.js

@@ -0,0 +1,486 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicProvider = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const interface_1 = require("./interface");
+const types_1 = require("../messages/types");
+const token_counter_1 = require("../utils/token-counter");
+const retry_1 = require("./retry");
+// ─── Anthropic-specific network error helpers ────────────────────────────────
+/**
+ * Check whether an error is network-related and thus retryable.
+ * Anthropic-provider specific: checks `Anthropic.APIError` status codes.
+ */
+function isNetworkError(error) {
+    if (error instanceof Error && error.name === "LLMNetworkError")
+        return true;
+    if (error instanceof sdk_1.default.APIError) {
+        // 429 (rate-limit) and 5xx (server) are retryable
+        if (error.status === 429)
+            return true;
+        if (error.status !== undefined && error.status >= 500 && error.status < 600)
+            return true;
+        return false;
+    }
+    if (error instanceof Error) {
+        const msg = error.message.toLowerCase();
+        return (msg.includes("timeout") ||
+            msg.includes("econnrefused") ||
+            msg.includes("econnreset") ||
+            msg.includes("econnaborted") ||
+            msg.includes("enotfound") ||
+            msg.includes("fetch failed") ||
+            msg.includes("network") ||
+            msg.includes("socket hang up"));
+    }
+    return false;
+}
+/**
+ * Map a raw error to its NetworkErrorCause category.
+ * Anthropic-provider specific: checks `Anthropic.APIError` status codes.
+ */
+function classifyError(error) {
+    if (error instanceof sdk_1.default.APIError) {
+        if (error.status === 429)
+            return "rate_limit";
+        if (error.status !== undefined && error.status >= 500)
+            return "server_error";
+    }
+    if (error instanceof Error) {
+        const msg = error.message.toLowerCase();
+        if (msg.includes("abort"))
+            return "aborted";
+        if (msg.includes("timeout"))
+            return "timeout";
+        if (msg.includes("econnrefused"))
+            return "connection_refused";
+        if (msg.includes("econnreset"))
+            return "connection_reset";
+        if (msg.includes("enotfound") || msg.includes("dns"))
+            return "dns_error";
+    }
+    return "unknown_network";
+}
+// ─── AnthropicConfig ─────────────────────────────────────────────────────────
+/**
+ * Maximum output tokens for Anthropic models.
+ * Claude 4.x models support up to 16384. Default is 8192 to balance
+ * output capacity with token cost.
+ */
+const DEFAULT_MAX_TOKENS = 8192;
+/** Retry callbacks shared by all AnthropicProvider instances. */
+const anthropicRetryCallbacks = {
+    isRetryable: isNetworkError,
+    classifyError,
+};
+// ─── AnthropicProvider ───────────────────────────────────────────────────────
+/**
+ * Anthropic implementation of the LLMProvider interface.
+ * Uses the official `@anthropic-ai/sdk` npm package.
+ *
+ * Features:
+ * - Tool/function calling support
+ * - Network error retry with exponential backoff (chat only)
+ * - Configurable timeout
+ * - Token counting via tiktoken (with model-aware encoding, falls back for Claude models)
+ *
+ * Message format conversion:
+ * The internal `MessageData[]` format (OpenAI-compatible) is converted to
+ * Anthropic's native format transparently:
+ * - System messages are extracted and passed as the top-level `system` parameter.
+ * - Tool messages (role "tool") become user messages with `tool_result` content blocks.
+ * - Assistant messages with tool_calls become content-block arrays with `tool_use` blocks.
+ */
+class AnthropicProvider {
+    model;
+    client;
+    temperature;
+    maxTokens;
+    retryConfig;
+    timeout;
+    cacheSystemPrompt;
+    constructor(config) {
+        this.client = new sdk_1.default({
+            apiKey: config.apiKey,
+            baseURL: config.baseURL,
+            timeout: config.timeout,
+            maxRetries: 0, // We handle retries ourselves via withRetry
+        });
+        if (!config.model) {
+            throw new Error("AnthropicProvider: `model` is required. " +
+                "Provide a model name (e.g. \"claude-sonnet-4-6\", \"claude-opus-4-8\") " +
+                "when constructing the provider.");
+        }
+        this.model = config.model;
+        this.temperature = config.temperature ?? 0.7;
+        this.maxTokens = config.maxTokens ?? DEFAULT_MAX_TOKENS;
+        this.timeout = config.timeout;
+        this.cacheSystemPrompt = config.cacheSystemPrompt ?? false;
+        this.retryConfig = {
+            maxRetries: config.retry?.maxRetries ?? 3,
+            baseDelayMs: config.retry?.baseDelayMs ?? 1000,
+            maxDelayMs: config.retry?.maxDelayMs ?? 30000,
+        };
+    }
+    // ─── LLMProvider Implementation ─────────────────────────────────────────
+    /**
+     * Build the `system` parameter for the Anthropic API.
+     * When `cacheSystemPrompt` is enabled and the system prompt is non-empty,
+     * wraps it in a content block with `cache_control` so Anthropic caches it.
+     */
+    buildSystemParam(systemPrompt) {
+        if (!systemPrompt)
+            return undefined;
+        if (!this.cacheSystemPrompt)
+            return systemPrompt;
+        return [
+            {
+                type: "text",
+                text: systemPrompt,
+                cache_control: { type: "ephemeral" },
+            },
+        ];
+    }
+    async chat(messages, tools, signal) {
+        const { systemPrompt, formattedMessages } = AnthropicProvider.convertMessages(messages);
+        const anthropicTools = tools?.length ? AnthropicProvider.convertTools(tools) : undefined;
+        const response = await (0, retry_1.withRetry)(() => this.client.messages.create({
+            model: this.model,
+            system: this.buildSystemParam(systemPrompt),
+            messages: formattedMessages,
+            tools: anthropicTools,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+        }, { signal }), this.retryConfig, anthropicRetryCallbacks);
+        return AnthropicProvider.convertResponse(response);
+    }
+    async *chatStream(messages, tools, signal) {
+        const { systemPrompt, formattedMessages } = AnthropicProvider.convertMessages(messages);
+        const anthropicTools = tools?.length ? AnthropicProvider.convertTools(tools) : undefined;
+        // The Anthropic SDK's stream() is synchronous — it returns a MessageStream
+        // without initiating a network request. The actual connection happens on
+        // first iteration. We retry the initial stream setup only (which may fail
+        // for auth/config errors), but NOT mid-stream drops — those are handled
+        // by the agent's outer loop, same as the OpenAI provider.
+        const stream = await (0, retry_1.withRetry)(async () => this.client.messages.stream({
+            model: this.model,
+            system: this.buildSystemParam(systemPrompt),
+            messages: formattedMessages,
+            tools: anthropicTools,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+        }, { signal }), this.retryConfig, anthropicRetryCallbacks);
+        let emittedDone = false;
+        for await (const event of stream) {
+            switch (event.type) {
+                case "content_block_start":
+                    if (event.content_block.type === "tool_use") {
+                        yield {
+                            type: "chunk",
+                            tool_calls: [
+                                {
+                                    index: event.index,
+                                    id: event.content_block.id,
+                                    function: { name: event.content_block.name },
+                                },
+                            ],
+                        };
+                    }
+                    break;
+                case "content_block_delta":
+                    if (event.delta.type === "text_delta") {
+                        yield { type: "chunk", content: event.delta.text };
+                    }
+                    else if (event.delta.type === "input_json_delta") {
+                        yield {
+                            type: "chunk",
+                            tool_calls: [
+                                {
+                                    index: event.index,
+                                    function: { arguments: event.delta.partial_json },
+                                },
+                            ],
+                        };
+                    }
+                    break;
+            }
+        }
+        // Retrieve usage from the final message. If the stream was aborted or
+        // the network dropped, finalMessage() throws — we catch and still emit
+        // a terminal "done" event so consumers don't hang.
+        try {
+            const finalMessage = await stream.finalMessage();
+            if (finalMessage.usage) {
+                emittedDone = true;
+                yield {
+                    type: "done",
+                    usage: {
+                        prompt_tokens: finalMessage.usage.input_tokens,
+                        completion_tokens: finalMessage.usage.output_tokens,
+                        total_tokens: finalMessage.usage.input_tokens + finalMessage.usage.output_tokens,
+                    },
+                };
+            }
+        }
+        catch {
+            // Stream terminated abnormally — usage stats unavailable.
+        }
+        if (!emittedDone) {
+            yield { type: "done" };
+        }
+    }
+    /**
+     * Count tokens using tiktoken (with model-aware encoding) when available.
+     * Falls back to character-based estimation if tiktoken is not installed.
+     *
+     * Note: Claude models are not recognized by tiktoken's `encoding_for_model()`,
+     * so it falls through to the generic `o200k_base` encoding, which is a
+     * reasonable approximation for Claude's tokenizer.
+     *
+     * @param text  The text to tokenize.
+     * @param model Optional model override. Defaults to this provider's model.
+     */
+    getTokenCount(text, model) {
+        return (0, token_counter_1.countTokens)(text, model ?? this.model);
+    }
+    // ─── Private Helpers ────────────────────────────────────────────────────
+    // ─── Static Converters ──────────────────────────────────────────────────
+    /**
+     * Validate and convert internal Tool definitions to Anthropic tool format.
+     *
+     * Internal format: `{ name, description, parameters }` (JSON Schema)
+     * Anthropic format: `{ name, description, input_schema }`
+     *
+     * If `parameters` is missing the required `type` field, we wrap it in
+     * an object schema as a best-effort fallback.
+     */
+    /**
+     * Build a valid Anthropic `input_schema` from a tool's raw parameters.
+     *
+     * Anthropic requires `{type: "object", properties: {...}}` at the top
+     * level. If the tool's parameters already provide this shape (i.e. it
+     * has `type: "object"`), we use `satisfies` to verify compatibility at
+     * compile time without runtime casting. Otherwise we wrap the params in
+     * an object schema.
+     */
+    static buildInputSchema(params) {
+        if (params &&
+            params.type === "object" &&
+            params.properties &&
+            typeof params.properties === "object") {
+            return {
+                type: "object",
+                properties: params.properties,
+                ...(params.required
+                    ? { required: params.required }
+                    : {}),
+            };
+        }
+        // Wrap in a minimal object schema.
+        return {
+            type: "object",
+            properties: params && Object.keys(params).length > 0 ? params : {},
+        };
+    }
+    static convertTools(tools) {
+        return tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            input_schema: AnthropicProvider.buildInputSchema(t.parameters),
+        }));
+    }
+    /**
+     * Convert an Anthropic API response to the internal `LLMResponse` format.
+     *
+     * - Text blocks → `content`
+     * - Tool use blocks → `tool_calls` with `JSON.stringify(input)`
+     * - Thinking blocks → merged into `content` (Claude extended thinking)
+     * - Usage → mapped from Anthropic's input_tokens/output_tokens
+     * - Stop reason → preserved for agents to detect truncation / tool-use
+     */
+    static convertResponse(response) {
+        const textBlocks = response.content.filter((b) => b.type === "text");
+        const toolUseBlocks = response.content.filter((b) => b.type === "tool_use");
+        // Claude extended thinking returns `type: "thinking"` blocks. These
+        // contain the model's internal reasoning and should be included in the
+        // content so the agent has full context.
+        const thinkingBlocks = response.content.filter((b) => b.type === "thinking");
+        // Build content from text + thinking blocks.
+        const parts = [];
+        parts.push(textBlocks.map((b) => b.text).join(""));
+        if (thinkingBlocks.length > 0) {
+            parts.push(thinkingBlocks.map((b) => b.thinking).join(""));
+        }
+        const content = parts.filter((p) => p.length > 0).join("");
+        const result = {
+            content,
+            tool_calls: toolUseBlocks.length > 0
+                ? toolUseBlocks.map((b) => ({
+                    id: b.id,
+                    type: "function",
+                    function: {
+                        name: b.name,
+                        arguments: JSON.stringify(b.input),
+                    },
+                }))
+                : undefined,
+            usage: response.usage
+                ? {
+                    prompt_tokens: response.usage.input_tokens,
+                    completion_tokens: response.usage.output_tokens,
+                    total_tokens: response.usage.input_tokens + response.usage.output_tokens,
+                }
+                : undefined,
+            stop_reason: response.stop_reason ?? undefined,
+        };
+        // Flag response-level quality issues
+        if (response.stop_reason === "max_tokens") {
+            result.responseError = {
+                code: interface_1.LLMResponseErrorCode.MAX_TOKENS,
+                message: "Response truncated: max_tokens reached. " +
+                    "Content or tool call arguments may be incomplete.",
+            };
+        }
+        return result;
+    }
+    /**
+     * Convert the internal `MessageData[]` format (OpenAI-compatible) to
+     * Anthropic's native message format.
+     *
+     * Conversion rules:
+     * 1. `role: "system"` messages are extracted, concatenated, and returned as
+     *    the top-level `systemPrompt`.
+     * 2. `role: "user"` → `{ role: "user", content: string }`
+     * 3. `role: "assistant"` without tool_calls → `{ role: "assistant", content: string }`
+     * 4. `role: "assistant"` with tool_calls → content-block array with text + tool_use blocks
+     * 5. `role: "tool"` → `{ role: "user", content: [{ type: "tool_result", ... }] }`
+     * 6. Consecutive same-role messages are merged with synthetic separators
+     *    to satisfy Anthropic's user/assistant alternation requirement.
+     * 7. If no non-system messages remain, a placeholder user message is inserted
+     *    to satisfy Anthropic's requirement of at least one user/assistant message.
+     */
+    static convertMessages(messages) {
+        // Extract system messages
+        const systemMessages = messages.filter((m) => m.role === types_1.Role.System);
+        const systemPrompt = systemMessages.length > 0
+            ? systemMessages.map((m) => m.content).join("\n")
+            : undefined;
+        // Convert non-system messages
+        const nonSystem = messages.filter((m) => m.role !== types_1.Role.System);
+        const formattedMessages = [];
+        for (const msg of nonSystem) {
+            const converted = AnthropicProvider.convertSingleMessage(msg);
+            // An empty result means the message was skipped (e.g. empty content).
+            if (!converted)
+                continue;
+            // Ensure user/assistant alternation.
+            // If the converted message has the same role as the last one in the array,
+            // insert a synthetic message to break the consecutive sequence.
+            if (formattedMessages.length > 0) {
+                const lastRole = formattedMessages[formattedMessages.length - 1].role;
+                if (lastRole === converted.role) {
+                    formattedMessages.push({
+                        role: lastRole === "user" ? "assistant" : "user",
+                        content: "(continued)",
+                    });
+                }
+            }
+            formattedMessages.push(converted);
+        }
+        // Anthropic requires at least one user or assistant message.
+        // If all messages were system-level, insert a placeholder.
+        if (formattedMessages.length === 0) {
+            formattedMessages.push({
+                role: "user",
+                content: "(start)",
+            });
+        }
+        return { systemPrompt, formattedMessages };
+    }
+    /** Counter for generating unique synthetic tool_use_ids. */
+    static toolUseIdCounter = 0;
+    /**
+     * Convert a single internal `MessageData` to an Anthropic `MessageParam`.
+     * Returns `null` if the message should be skipped.
+     */
+    static convertSingleMessage(msg) {
+        switch (msg.role) {
+            case types_1.Role.User:
+                return {
+                    role: "user",
+                    content: msg.content || "(empty)",
+                };
+            case types_1.Role.Assistant: {
+                const hasToolCalls = msg.tool_calls && msg.tool_calls.length > 0;
+                if (!hasToolCalls) {
+                    return {
+                        role: "assistant",
+                        content: msg.content || "(empty)",
+                    };
+                }
+                // Assistant message with tool calls → content-block array.
+                const contentBlocks = [];
+                // Add text block if there's non-empty content.
+                if (msg.content) {
+                    contentBlocks.push({ type: "text", text: msg.content });
+                }
+                // Add tool_use blocks for each tool call.
+                for (const tc of msg.tool_calls) {
+                    let input = {};
+                    if (tc.function.arguments) {
+                        try {
+                            input = JSON.parse(tc.function.arguments);
+                        }
+                        catch {
+                            // Unparseable arguments — use empty object as fallback.
+                            input = {};
+                        }
+                    }
+                    contentBlocks.push({
+                        type: "tool_use",
+                        id: tc.id,
+                        name: tc.function.name,
+                        input,
+                    });
+                }
+                return {
+                    role: "assistant",
+                    content: contentBlocks,
+                };
+            }
+            case types_1.Role.Tool: {
+                // Tool messages become user messages with tool_result content blocks.
+                // Generate a unique fallback ID when tool_call_id is missing to avoid
+                // collisions (Anthropic requires unique tool_use_ids across the conversation).
+                let toolUseId = msg.tool_call_id;
+                if (!toolUseId) {
+                    AnthropicProvider.toolUseIdCounter++;
+                    toolUseId = msg.name
+                        ? `${msg.name}_${AnthropicProvider.toolUseIdCounter}`
+                        : `tool_${AnthropicProvider.toolUseIdCounter}`;
+                }
+                return {
+                    role: "user",
+                    content: [
+                        {
+                            type: "tool_result",
+                            tool_use_id: toolUseId,
+                            content: msg.content || "",
+                        },
+                    ],
+                };
+            }
+            default:
+                // Unknown roles are treated as user messages.
+                return {
+                    role: "user",
+                    content: msg.content || "(empty)",
+                };
+        }
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+//# sourceMappingURL=anthropic-provider.js.map

package/dist/llm/anthropic-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.js","sourceRoot":"","sources":["../../src/llm/anthropic-provider.ts"],"names":[],"mappings":"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"}

package/dist/llm/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Categories of network-related LLM failures.
+ * Used by both OpenAI and Anthropic providers.
+ */
+export type NetworkErrorCause = "timeout" | "connection_refused" | "connection_reset" | "dns_error" | "rate_limit" | "server_error" | "aborted" | "unknown_network";
+/**
+ * Thrown by an LLM provider when all retry attempts for a network-related
+ * failure have been exhausted. The agent catches this to save a checkpoint
+ * and guide the user to resume their session.
+ */
+export declare class LLMNetworkError extends Error {
+    readonly cause: NetworkErrorCause;
+    constructor(message: string, cause: NetworkErrorCause);
+}
+/**
+ * Retry configuration shared by all LLM providers.
+ */
+export interface RetryConfig {
+    /** Max retry attempts for network errors (default: 3). */
+    maxRetries?: number;
+    /** Initial backoff delay in ms (default: 1000). */
+    baseDelayMs?: number;
+    /** Maximum backoff delay in ms (default: 30000). */
+    maxDelayMs?: number;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/llm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/llm/errors.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,oBAAoB,GACpB,kBAAkB,GAClB,WAAW,GACX,YAAY,GACZ,cAAc,GACd,SAAS,GACT,iBAAiB,CAAC;AAEtB;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,KAAK,EAAE,iBAAiB,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB;CAKtD;AAID;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/llm/errors.js

@@ -0,0 +1,19 @@
+"use strict";
+// ─── Shared LLM Error Types ─────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMNetworkError = void 0;
+/**
+ * Thrown by an LLM provider when all retry attempts for a network-related
+ * failure have been exhausted. The agent catches this to save a checkpoint
+ * and guide the user to resume their session.
+ */
+class LLMNetworkError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = "LLMNetworkError";
+        this.cause = cause;
+    }
+}
+exports.LLMNetworkError = LLMNetworkError;
+//# sourceMappingURL=errors.js.map

package/dist/llm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/llm/errors.ts"],"names":[],"mappings":";AAAA,+EAA+E;;;AAgB/E;;;;GAIG;AACH,MAAa,eAAgB,SAAQ,KAAK;IACxB,KAAK,CAAoB;IAEzC,YAAY,OAAe,EAAE,KAAwB;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AARD,0CAQC"}

package/dist/llm/factory.d.ts

@@ -0,0 +1,73 @@
+import { LLMProvider } from "./interface";
+import { RetryConfig } from "./errors";
+/**
+ * Explicit provider selection for the factory.
+ * - `"openai"`: Always use OpenAI.
+ * - `"anthropic"`: Always use Anthropic.
+ * - `"auto"`: Detect from `baseURL` (default).
+ */
+export type ProviderType = "openai" | "anthropic" | "auto";
+/**
+ * Unified configuration accepted by `createLLMProvider`.
+ * Pass this instead of provider-specific configs (`OpenAIConfig`, `AnthropicConfig`)
+ * to enable automatic provider detection.
+ */
+export interface LLMProviderConfig {
+    /** API key for the LLM service. */
+    apiKey: string;
+    /** Model identifier (e.g. "gpt-4o", "claude-sonnet-4-6"). */
+    model: string;
+    /** Sampling temperature (default: 0.7). */
+    temperature?: number;
+    /**
+     * Maximum output tokens.
+     * Per-provider defaults: OpenAI 4096, Anthropic 8192.
+     */
+    maxTokens?: number;
+    /**
+     * Base URL for the LLM API endpoint.
+     * Used to auto-detect the provider when `provider` is `"auto"`.
+     * Examples:
+     * - `"https://api.openai.com/v1"` → OpenAI
+     * - `"https://api.anthropic.com"` → Anthropic
+     * - `undefined` → defaults to OpenAI (backward compatible)
+     */
+    baseURL?: string;
+    /** Retry configuration for network resilience. */
+    retry?: RetryConfig;
+    /** Request timeout in ms. */
+    timeout?: number;
+    /**
+     * Explicitly choose the provider. When `"auto"` or omitted,
+     * the factory detects the provider from `baseURL`.
+     */
+    provider?: ProviderType;
+}
+/**
+ * Create an LLM provider instance, auto-detecting the backend from `baseURL`.
+ *
+ * @example
+ * ```ts
+ * // Auto-detect: baseURL contains "anthropic" → AnthropicProvider
+ * const llm = createLLMProvider({
+ *   apiKey: process.env.ANTHROPIC_API_KEY!,
+ *   model: "claude-sonnet-4-6",
+ *   baseURL: "https://api.anthropic.com",
+ * });
+ *
+ * // Explicit provider selection
+ * const llm = createLLMProvider({
+ *   apiKey: process.env.OPENAI_API_KEY!,
+ *   model: "gpt-4o",
+ *   provider: "openai",
+ * });
+ *
+ * // Backward-compatible: no baseURL → OpenAI
+ * const llm = createLLMProvider({
+ *   apiKey: process.env.OPENAI_API_KEY!,
+ *   model: "gpt-4o",
+ * });
+ * ```
+ */
+export declare function createLLMProvider(config: LLMProviderConfig): LLMProvider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/llm/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/llm/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAIvC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAI3D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAwBxE"}