agent-bober 0.6.1 → 0.7.0

package/dist/providers/google.js

@@ -0,0 +1,195 @@
+/**
+ * Google Gemini provider adapter.
+ *
+ * Uses a dynamic import so the `@google/generative-ai` package is an optional
+ * peer dependency. If the package is not installed, a clear installation error
+ * is thrown at call-time rather than at module load time.
+ *
+ * All Gemini SDK types are inlined below so this file compiles without the
+ * `@google/generative-ai` package present in node_modules.
+ */
+// ── Conversion helpers ───────────────────────────────────────────────
+/**
+ * Convert a provider-agnostic ToolDef to Gemini functionDeclarations format.
+ */
+function toGeminiTool(tools) {
+    return {
+        functionDeclarations: tools.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.input_schema,
+        })),
+    };
+}
+/**
+ * Normalize a Gemini finishReason to our StopReason type.
+ */
+function normalizeStopReason(finishReason) {
+    switch (finishReason) {
+        case "STOP":
+            return "end";
+        case "MAX_TOKENS":
+            return "max_tokens";
+        default:
+            return "end";
+    }
+}
+/**
+ * Convert a provider-agnostic Message to Gemini content format.
+ *
+ * Returns an array because ToolResultMessage may need special handling —
+ * Gemini uses role "function" with functionResponse parts for tool results.
+ */
+function toGeminiContents(message) {
+    // ToolResultMessage → role:"function" with functionResponse parts
+    if ("toolResults" in message) {
+        return message.toolResults.map((tr) => ({
+            role: "function",
+            parts: [
+                {
+                    functionResponse: {
+                        name: tr.toolUseId,
+                        response: { content: tr.content },
+                    },
+                },
+            ],
+        }));
+    }
+    // AssistantMessage (with tool calls) → role:"model" with functionCall parts
+    if ("toolCalls" in message && message.toolCalls.length > 0) {
+        const parts = [];
+        if (message.content) {
+            parts.push({ text: message.content });
+        }
+        for (const tc of message.toolCalls) {
+            parts.push({
+                functionCall: {
+                    name: tc.name,
+                    args: tc.input,
+                },
+            });
+        }
+        return [{ role: "model", parts }];
+    }
+    // TextMessage — map "user" → "user", "assistant" → "model"
+    const textMsg = message;
+    const geminiRole = textMsg.role === "assistant" ? "model" : "user";
+    return [{ role: geminiRole, parts: [{ text: textMsg.content }] }];
+}
+/**
+ * Extract normalized text and tool calls from Gemini response parts.
+ */
+function normalizeResponseParts(parts) {
+    let text = "";
+    const toolCalls = [];
+    for (const part of parts) {
+        if ("text" in part && typeof part.text === "string") {
+            text += part.text;
+        }
+        else if ("functionCall" in part) {
+            // Gemini does not provide a stable call ID — synthesize one from index
+            const callId = `gemini-call-${toolCalls.length}-${part.functionCall.name}`;
+            toolCalls.push({
+                id: callId,
+                name: part.functionCall.name,
+                input: part.functionCall.args ?? {},
+            });
+        }
+    }
+    return { text, toolCalls };
+}
+// ── GoogleAdapter ────────────────────────────────────────────────────
+/**
+ * LLMClient implementation that wraps the Google Gemini API.
+ *
+ * The `@google/generative-ai` npm package is dynamically imported so it
+ * remains an optional peer dependency. If the package is absent a descriptive
+ * install error is thrown on the first call.
+ *
+ * Supports:
+ * - Function/tool calling via functionDeclarations format
+ * - System instruction passed via model config
+ * - Message history with user/model/function roles
+ */
+export class GoogleAdapter {
+    model;
+    apiKey;
+    /** Lazily initialised after the dynamic import succeeds. */
+    genAI = null;
+    constructor(model, apiKey) {
+        this.model = model;
+        this.apiKey = apiKey;
+    }
+    /**
+     * Lazily import the `@google/generative-ai` package and return the
+     * initialised GoogleGenerativeAI client.
+     *
+     * @throws If the `@google/generative-ai` package is not installed.
+     */
+    async getGenAI() {
+        if (this.genAI) {
+            return this.genAI;
+        }
+        let GoogleGenerativeAI;
+        try {
+            // Construct the specifier at runtime so TypeScript does not attempt
+            // to statically resolve the optional peer dependency at compile time.
+            const specifier = "@google/generative-ai";
+            const mod = (await import(/* @vite-ignore */ specifier));
+            // Handle both ESM default export and CommonJS-style .default wrapping
+            GoogleGenerativeAI = (mod["GoogleGenerativeAI"] ?? mod["default"]);
+        }
+        catch {
+            throw new Error('Google provider requires the "@google/generative-ai" package. Run: npm install @google/generative-ai');
+        }
+        const apiKey = this.apiKey ??
+            process.env["GOOGLE_API_KEY"] ??
+            process.env["GEMINI_API_KEY"];
+        if (!apiKey) {
+            throw new Error("Google provider requires an API key. Set GOOGLE_API_KEY or GEMINI_API_KEY environment variable.");
+        }
+        this.genAI = new GoogleGenerativeAI(apiKey);
+        return this.genAI;
+    }
+    async chat(params) {
+        const { model, system, messages, tools, maxTokens: _maxTokens = 16384 } = params;
+        const genAI = await this.getGenAI();
+        // Get the generative model — system instruction set at model config level
+        const generativeModel = genAI.getGenerativeModel({
+            model: model || this.model,
+            ...(system ? { systemInstruction: system } : {}),
+        });
+        // Convert provider-agnostic Message[] to Gemini contents format
+        const contents = messages.flatMap(toGeminiContents);
+        // Convert ToolDef[] to Gemini tools format (all declarations in one tool)
+        const geminiTools = tools && tools.length > 0 ? [toGeminiTool(tools)] : undefined;
+        const result = await generativeModel.generateContent({
+            contents,
+            ...(geminiTools ? { tools: geminiTools } : {}),
+        });
+        const candidate = result.response.candidates?.[0];
+        if (!candidate) {
+            return {
+                text: "",
+                toolCalls: [],
+                stopReason: "error",
+                usage: { inputTokens: 0, outputTokens: 0 },
+            };
+        }
+        const parts = candidate.content?.parts ?? [];
+        const { text, toolCalls } = normalizeResponseParts(parts);
+        const stopReason = normalizeStopReason(candidate.finishReason);
+        // Determine stopReason based on whether there are tool calls
+        const finalStopReason = toolCalls.length > 0 ? "tool_use" : stopReason;
+        return {
+            text,
+            toolCalls,
+            stopReason: finalStopReason,
+            usage: {
+                inputTokens: result.response.usageMetadata?.promptTokenCount ?? 0,
+                outputTokens: result.response.usageMetadata?.candidatesTokenCount ?? 0,
+            },
+        };
+    }
+}
+//# sourceMappingURL=google.js.map

package/dist/providers/google.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,7 @@
+export type { JsonSchemaProperty, JsonSchemaObject, ToolDef, ToolCall, ToolResult, TextMessage, AssistantMessage, ToolResultMessage, Message, ChatParams, ChatResponse, StopReason, LLMClient, } from "./types.js";
+export { AnthropicAdapter } from "./anthropic.js";
+export { OpenAIAdapter } from "./openai.js";
+export { GoogleAdapter } from "./google.js";
+export { OpenAICompatAdapter } from "./openai-compat.js";
+export { createClient, type ProviderName } from "./factory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,UAAU,EACV,YAAY,EACZ,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,6 @@
+export { AnthropicAdapter } from "./anthropic.js";
+export { OpenAIAdapter } from "./openai.js";
+export { GoogleAdapter } from "./google.js";
+export { OpenAICompatAdapter } from "./openai-compat.js";
+export { createClient } from "./factory.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAqB,MAAM,cAAc,CAAC"}

package/dist/providers/openai-compat.d.ts

@@ -0,0 +1,39 @@
+/**
+ * OpenAI-compatible provider adapter.
+ *
+ * Creates an OpenAI client pointed at a custom base URL, enabling use with
+ * any OpenAI-compatible API server (e.g. Ollama, LM Studio, vLLM, Together AI).
+ *
+ * Reuses all tool conversion, message conversion, and response normalisation
+ * logic from OpenAIAdapter by extending it with a custom base URL and a
+ * default API key of "not-needed" (required by the openai SDK but ignored
+ * by servers like Ollama that don't require authentication).
+ */
+import { OpenAIAdapter } from "./openai.js";
+import type { LLMClient } from "./types.js";
+/**
+ * LLMClient implementation for OpenAI-compatible endpoints.
+ *
+ * Extends OpenAIAdapter with a required `endpoint` (baseURL) parameter.
+ * All tool conversion and response normalisation is inherited from
+ * OpenAIAdapter — only the client configuration differs.
+ *
+ * Usage example (Ollama):
+ * ```ts
+ * const client = new OpenAICompatAdapter(
+ *   "http://localhost:11434/v1",
+ *   "llama3",
+ * );
+ * ```
+ */
+export declare class OpenAICompatAdapter extends OpenAIAdapter implements LLMClient {
+    /**
+     * @param endpoint - Required base URL of the OpenAI-compatible server
+     *   (e.g. "http://localhost:11434/v1" for Ollama).
+     * @param model - Model identifier to use with this server.
+     * @param apiKey - Optional API key. Defaults to "not-needed" for servers
+     *   that do not require authentication (e.g. Ollama).
+     */
+    constructor(endpoint: string, model: string, apiKey?: string);
+}
+//# sourceMappingURL=openai-compat.d.ts.map

package/dist/providers/openai-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compat.d.ts","sourceRoot":"","sources":["../../src/providers/openai-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAoB,SAAQ,aAAc,YAAW,SAAS;IACzE;;;;;;OAMG;gBACS,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAK7D"}

package/dist/providers/openai-compat.js

@@ -0,0 +1,42 @@
+/**
+ * OpenAI-compatible provider adapter.
+ *
+ * Creates an OpenAI client pointed at a custom base URL, enabling use with
+ * any OpenAI-compatible API server (e.g. Ollama, LM Studio, vLLM, Together AI).
+ *
+ * Reuses all tool conversion, message conversion, and response normalisation
+ * logic from OpenAIAdapter by extending it with a custom base URL and a
+ * default API key of "not-needed" (required by the openai SDK but ignored
+ * by servers like Ollama that don't require authentication).
+ */
+import { OpenAIAdapter } from "./openai.js";
+/**
+ * LLMClient implementation for OpenAI-compatible endpoints.
+ *
+ * Extends OpenAIAdapter with a required `endpoint` (baseURL) parameter.
+ * All tool conversion and response normalisation is inherited from
+ * OpenAIAdapter — only the client configuration differs.
+ *
+ * Usage example (Ollama):
+ * ```ts
+ * const client = new OpenAICompatAdapter(
+ *   "http://localhost:11434/v1",
+ *   "llama3",
+ * );
+ * ```
+ */
+export class OpenAICompatAdapter extends OpenAIAdapter {
+    /**
+     * @param endpoint - Required base URL of the OpenAI-compatible server
+     *   (e.g. "http://localhost:11434/v1" for Ollama).
+     * @param model - Model identifier to use with this server.
+     * @param apiKey - Optional API key. Defaults to "not-needed" for servers
+     *   that do not require authentication (e.g. Ollama).
+     */
+    constructor(endpoint, model, apiKey) {
+        // Pass "not-needed" as apiKey default — the openai SDK requires a non-empty
+        // value but OpenAI-compat servers (like Ollama) typically ignore it.
+        super(model, apiKey ?? "not-needed", endpoint);
+    }
+}
+//# sourceMappingURL=openai-compat.js.map

package/dist/providers/openai-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compat.js","sourceRoot":"","sources":["../../src/providers/openai-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD;;;;;;OAMG;IACH,YAAY,QAAgB,EAAE,KAAa,EAAE,MAAe;QAC1D,4EAA4E;QAC5E,qEAAqE;QACrE,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,YAAY,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,41 @@
+/**
+ * OpenAI provider adapter.
+ *
+ * Uses a dynamic import so the `openai` package is an optional peer dependency.
+ * If the package is not installed, a clear installation error is thrown at
+ * call-time rather than at module load time.
+ *
+ * All OpenAI SDK types are inlined below so this file compiles without the
+ * `openai` package present in node_modules.
+ */
+import type { LLMClient, ChatParams, ChatResponse } from "./types.js";
+/**
+ * LLMClient implementation that wraps the OpenAI chat completions API.
+ *
+ * The `openai` npm package is dynamically imported so it remains an optional
+ * peer dependency. If the package is absent a descriptive install error is
+ * thrown on the first call.
+ *
+ * Supports:
+ * - Function/tool calling via the tools array format
+ * - Parallel tool calls
+ * - Custom base URL for OpenAI-compatible endpoints
+ * - Optional provider-level configuration
+ */
+export declare class OpenAIAdapter implements LLMClient {
+    private readonly model;
+    private readonly apiKey;
+    private readonly baseURL;
+    private readonly providerConfig;
+    /** Lazily initialised after the dynamic import succeeds. */
+    private client;
+    constructor(model: string, apiKey?: string, endpoint?: string, providerConfig?: Record<string, unknown>);
+    /**
+     * Lazily import the `openai` package and return the initialised client.
+     *
+     * @throws If the `openai` package is not installed.
+     */
+    private getClient;
+    chat(params: ChatParams): Promise<ChatResponse>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAKb,MAAM,YAAY,CAAC;AA0MpB;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;IAErE,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAA8B;gBAG1C,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ1C;;;;OAIG;YACW,SAAS;IAqCjB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CA8CtD"}

package/dist/providers/openai.js

@@ -0,0 +1,205 @@
+/**
+ * OpenAI provider adapter.
+ *
+ * Uses a dynamic import so the `openai` package is an optional peer dependency.
+ * If the package is not installed, a clear installation error is thrown at
+ * call-time rather than at module load time.
+ *
+ * All OpenAI SDK types are inlined below so this file compiles without the
+ * `openai` package present in node_modules.
+ */
+// ── Conversion helpers ──────────────────────────────────────────────
+/**
+ * Convert a provider-agnostic ToolDef to OpenAI function calling format.
+ */
+function toOpenAITool(tool) {
+    return {
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            // input_schema is already a JSON Schema object; OpenAI uses `parameters`
+            parameters: tool.input_schema,
+        },
+    };
+}
+/**
+ * Normalize the OpenAI finish_reason to our StopReason type.
+ */
+function normalizeStopReason(finishReason) {
+    switch (finishReason) {
+        case "stop":
+            return "end";
+        case "tool_calls":
+            return "tool_use";
+        case "length":
+            return "max_tokens";
+        default:
+            return finishReason ?? "end";
+    }
+}
+/**
+ * Convert a provider-agnostic Message to one or more OpenAI request messages.
+ *
+ * Returns an array because ToolResultMessage expands into one OAI tool
+ * message per tool result (OpenAI requires separate messages per tool call).
+ */
+function toOpenAIMessages(message) {
+    // ToolResultMessage → one role:"tool" message per result
+    if ("toolResults" in message) {
+        return message.toolResults.map((tr) => ({
+            role: "tool",
+            tool_call_id: tr.toolUseId,
+            content: tr.content,
+        }));
+    }
+    // AssistantMessage → role:"assistant" with optional tool_calls
+    if ("toolCalls" in message && message.toolCalls.length > 0) {
+        const oaiMsg = {
+            role: "assistant",
+            content: message.content || null,
+            tool_calls: message.toolCalls.map((tc) => ({
+                id: tc.id,
+                type: "function",
+                function: {
+                    name: tc.name,
+                    arguments: JSON.stringify(tc.input),
+                },
+            })),
+        };
+        return [oaiMsg];
+    }
+    // TextMessage (user or assistant without tool calls)
+    const textMsg = message;
+    if (textMsg.role === "user") {
+        return [{ role: "user", content: textMsg.content }];
+    }
+    // Plain assistant text message (no tool calls)
+    return [{ role: "assistant", content: textMsg.content }];
+}
+/**
+ * Parse tool_calls from an OAI response message into ToolCall[].
+ *
+ * Guards against an empty array (treated as no tool calls) and handles
+ * JSON parse errors in arguments gracefully.
+ */
+function normalizeToolCalls(toolCalls) {
+    if (!toolCalls || toolCalls.length === 0) {
+        return [];
+    }
+    return toolCalls.map((tc) => {
+        let input = {};
+        try {
+            const parsed = JSON.parse(tc.function.arguments);
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                input = parsed;
+            }
+        }
+        catch {
+            // Malformed JSON from the model — fall back to empty input
+        }
+        return {
+            id: tc.id,
+            name: tc.function.name,
+            input,
+        };
+    });
+}
+// ── OpenAIAdapter ────────────────────────────────────────────────────
+/**
+ * LLMClient implementation that wraps the OpenAI chat completions API.
+ *
+ * The `openai` npm package is dynamically imported so it remains an optional
+ * peer dependency. If the package is absent a descriptive install error is
+ * thrown on the first call.
+ *
+ * Supports:
+ * - Function/tool calling via the tools array format
+ * - Parallel tool calls
+ * - Custom base URL for OpenAI-compatible endpoints
+ * - Optional provider-level configuration
+ */
+export class OpenAIAdapter {
+    model;
+    apiKey;
+    baseURL;
+    providerConfig;
+    /** Lazily initialised after the dynamic import succeeds. */
+    client = null;
+    constructor(model, apiKey, endpoint, providerConfig) {
+        this.model = model;
+        this.apiKey = apiKey;
+        this.baseURL = endpoint;
+        this.providerConfig = providerConfig;
+    }
+    /**
+     * Lazily import the `openai` package and return the initialised client.
+     *
+     * @throws If the `openai` package is not installed.
+     */
+    async getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        let OpenAI;
+        try {
+            // Construct the specifier at runtime so TypeScript does not attempt
+            // to statically resolve the optional peer dependency at compile time.
+            const specifier = "openai";
+            const mod = (await import(/* @vite-ignore */ specifier));
+            // Handle both ESM default export and CommonJS-style .default wrapping
+            OpenAI = (mod["default"] ?? mod);
+        }
+        catch {
+            throw new Error('OpenAI provider requires the "openai" package. Run: npm install openai');
+        }
+        const apiKey = this.apiKey ??
+            (typeof this.providerConfig?.["apiKey"] === "string"
+                ? this.providerConfig["apiKey"]
+                : process.env["OPENAI_API_KEY"]);
+        this.client = new OpenAI({
+            apiKey,
+            ...(this.baseURL ? { baseURL: this.baseURL } : {}),
+        });
+        return this.client;
+    }
+    async chat(params) {
+        const { model, system, messages, tools, maxTokens = 16384 } = params;
+        const client = await this.getClient();
+        // Build the messages array: system message first, then conversation
+        const oaiMessages = [
+            { role: "system", content: system },
+            ...messages.flatMap(toOpenAIMessages),
+        ];
+        // Convert ToolDef[] to OpenAI tools format
+        const oaiTools = tools && tools.length > 0 ? tools.map(toOpenAITool) : undefined;
+        const response = await client.chat.completions.create({
+            model: model || this.model,
+            messages: oaiMessages,
+            ...(oaiTools ? { tools: oaiTools } : {}),
+            max_tokens: maxTokens,
+        });
+        const choice = response.choices[0];
+        if (!choice) {
+            return {
+                text: "",
+                toolCalls: [],
+                stopReason: "error",
+                usage: { inputTokens: 0, outputTokens: 0 },
+            };
+        }
+        const text = choice.message.content ?? "";
+        const toolCalls = normalizeToolCalls(choice.message.tool_calls);
+        const stopReason = normalizeStopReason(choice.finish_reason);
+        return {
+            text,
+            toolCalls,
+            stopReason,
+            usage: {
+                inputTokens: response.usage?.prompt_tokens ?? 0,
+                outputTokens: response.usage?.completion_tokens ?? 0,
+            },
+        };
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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