@node-llm/core 1.2.0 → 1.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NodeLLM contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,245 @@
+<p align="left">
+  <img src="https://github.com/eshaiju/node-llm/raw/main/docs/assets/images/logo.jpg" alt="NodeLLMlogo" width="300" />
+</p>
+
+# NodeLLM
+**An opinionated architectural layer for using Large Language Models in Node.js.**
+
+Build chatbots, autonomous agents, and RAG pipelines without the SDK fatigue. NodeLLM provides a unified, production-oriented API for interacting with over **540+ models** across multiple providers (OpenAI, Gemini, Anthropic, DeepSeek, OpenRouter, Ollama, etc.) without coupling your application to any single SDK.
+
+<br/>
+
+<p align="left">
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/openai.svg" height="28" />
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/openai-text.svg" height="22" />
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/anthropic-text.svg" height="18" />
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/gemini-color.svg" height="28" />
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/gemini-text.svg" height="20" />
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/deepseek-color.svg" height="28" />
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/deepseek-text.svg" height="20" />
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/openrouter.svg" height="28" />
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/openrouter-text.svg" height="22" />
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/ollama.svg" height="28" />
+  <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/ollama-text.svg" height="18" />
+</p>
+
+<br/>
+
+[![npm version](https://img.shields.io/npm/v/@node-llm/core.svg)](https://www.npmjs.com/package/@node-llm/core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+
+---
+
+## ⚡ The Golden Path
+
+```ts
+import { NodeLLM } from "@node-llm/core";
+
+// 1. Configure once
+NodeLLM.configure({ provider: "openai" });
+
+// 2. Chat (High-level request/response)
+const chat = NodeLLM.chat("gpt-4o");
+const response = await chat.ask("Explain event-driven architecture");
+console.log(response.content);
+
+// 3. Streaming (Standard AsyncIterator)
+for await (const chunk of chat.stream("Explain event-driven architecture")) {
+  process.stdout.write(chunk.content);
+}
+```
+
+---
+
+## Why`NodeLLM`?
+
+Most AI integrations today are provider-specific, SDK-driven, and leaky at abstraction boundaries. This creates long-term architectural risk. Switching models should not mean a total rewrite of your business logic.
+
+NodeLLMexists to solve **architectural problems**, not just provide API access.
+
+### Strategic Goals
+
+- **Provider Isolation**: Your application logic never touches a provider-specific SDK.
+- **Unified Mental Model**: Chat, streaming, tools, and structured outputs feel identical across providers.
+- **Production-Ready**: Streaming, retries, and errors are first-class concerns. 
+- **The "Standard Library" Voice**: It provides a beautiful, native-feeling API for modern Node.js.
+
+### Non-Goals
+
+- It is **not** a thin wrapper that mirrors every provider's unique API knobs.
+- It is **not** a UI framework or a simple chatbot builder.
+- It prioritizes **architectural clarity** over raw SDK convenience.
+
+---
+
+## 🔧 Strategic Configuration
+
+NodeLLMprovides a flexible configuration system designed for enterprise usage:
+
+```ts
+// Recommended for multi-provider pipelines
+NodeLLM.configure((config) => {
+  config.openaiApiKey = process.env.OPENAI_API_KEY;
+  config.anthropicApiKey = process.env.ANTHROPIC_API_KEY;
+  config.ollamaApiBase = process.env.OLLAMA_API_BASE;
+});
+
+// Switch providers at the framework level
+NodeLLM.configure({ provider: "anthropic" });
+
+// Support for Custom Endpoints (e.g., Azure or LocalAI)
+NodeLLM.configure({
+  openaiApiKey: process.env.AZURE_KEY,
+  openaiApiBase: "https://your-resource.openai.azure.com/openai/deployments/...",
+});
+```
+
+**[Full Configuration Guide →](docs/getting_started/configuration.md)**
+
+---
+
+---
+
+## 🔮 Capabilities
+
+### 💬 Unified Chat
+Stop rewriting code for every provider. `NodeLLM` normalizes inputs and outputs into a single, predictable mental model.
+```ts
+const chat = NodeLLM.chat(); // Defaults to GPT-4o
+await chat.ask("Hello world");
+```
+
+### 👁️ Smart Vision & Files
+Pass images, PDFs, or audio files directly. We handle the heavy lifting: fetching remote URLs, base64 encoding, and MIME type mapping.
+```ts
+await chat.ask("Analyze this interface", { 
+  files: ["./screenshot.png", "https://example.com/spec.pdf"] 
+});
+```
+
+### 🛠️ Auto-Executing Tools
+Define tools once;`NodeLLM` manages the recursive execution loop for you, keeping your controller logic clean. **Works seamlessly with both regular chat and streaming!**
+
+```ts
+// Class-based DSL
+class WeatherTool extends Tool {
+  name = "get_weather";
+  description = "Get current weather";
+  schema = z.object({ location: z.string() });
+  async execute({ location }) { return `Sunny in ${location}`; }
+}
+
+// Register tools
+chat.withTools([WeatherTool]);
+
+// Now the model can use it automatically
+await chat.ask("What's the weather in Tokyo?");
+```
+**[Full Tool Calling Guide →](https://node-llm.eshaiju.com/core-features/tool-calling)**
+
+### 🔍 Comprehensive Debug Logging
+Enable detailed logging for all API requests and responses across every feature and provider:
+```ts
+// Set environment variable
+process.env.NODELLM_DEBUG = "true";
+
+// Now see detailed logs for every API call:
+// [NodeLLM] [OpenAI] Request: POST https://api.openai.com/v1/chat/completions
+// { "model": "gpt-4o", "messages": [...] }
+// [NodeLLM] [OpenAI] Response: 200 OK
+// { "id": "chatcmpl-123", ... }
+```
+**Covers:** Chat, Streaming, Images, Embeddings, Transcription, Moderation - across all providers!
+
+### ✨ Structured Output
+Get type-safe, validated JSON back using **Zod** schemas.
+```ts
+import { z } from "@node-llm/core";
+const Product = z.object({ name: z.string(), price: z.number() });
+
+const res = await chat.withSchema(Product).ask("Generate a gadget");
+console.log(res.parsed.name); // Full type-safety
+```
+
+### 🎨 Image Generation
+```ts
+await NodeLLM.paint("A cyberpunk city in rain");
+```
+
+### 🎤 Audio Transcription
+```ts
+await NodeLLM.transcribe("meeting-recording.wav");
+```
+
+### ⚡ Scoped Parallelism
+Run multiple providers in parallel safely without global configuration side effects using isolated contexts. You can also override credentials (API keys) for specific instances.
+
+```ts
+const [gpt, claude] = await Promise.all([
+  // Each call branch off into its own isolated context
+  NodeLLM.withProvider("openai").chat("gpt-4o").ask(prompt),
+  NodeLLM.withProvider("anthropic", { anthropicApiKey: "..." }).chat("claude-3.5-sonnet").ask(prompt),
+]);
+```
+
+
+### 🧠 Deep Reasoning
+Direct access to the thought process of models like **DeepSeek R1** or **OpenAI o1/o3** using the `.reasoning` field.
+```ts
+const res = await NodeLLM.chat("deepseek-reasoner").ask("Solve this logical puzzle");
+console.log(res.reasoning); // Chain-of-thought
+```
+
+---
+
+## 🚀 Why use this over official SDKs?
+
+| Feature |`NodeLLM` | Official SDKs | Architectural Impact |
+| :--- | :--- | :--- | :--- |
+| **Provider Logic** | Transparently Handled | Exposed to your code | **Low Coupling** |
+| **Streaming** | Standard `AsyncIterator` | Vendor-specific Events | **Predictable Data Flow** |
+| **Streaming + Tools** | Automated Execution | Manual implementation | **Seamless UX** |
+| **Tool Loops** | Automated Recursion | Manual implementation | **Reduced Boilerplate** |
+| **Files/Vision** | Intelligent Path/URL handling | Base64/Buffer management | **Cleaner Service Layer** |
+| **Configuration** | Centralized & Global | Per-instance initialization | **Easier Lifecycle Mgmt** |
+
+---
+
+## 📋 Supported Providers
+
+| Provider | Supported Features |
+| :--- | :--- |
+| <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/openai.svg" height="18"> **OpenAI** | Chat, **Streaming + Tools**, Vision, Audio, Images, Transcription, **Reasoning** |
+| <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/gemini-color.svg" height="18"> **Gemini** | Chat, **Streaming + Tools**, Vision, Audio, Video, Embeddings |
+| <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/anthropic-text.svg" height="12"> **Anthropic** | Chat, **Streaming + Tools**, Vision, PDF, Structured Output |
+| <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/deepseek-color.svg" height="18"> **DeepSeek** | Chat (V3), **Reasoning (R1)**, **Streaming + Tools** |
+| <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/openrouter.svg" height="18"> **OpenRouter** | **Aggregator**, Chat, Streaming, Tools, Vision, Embeddings, **Reasoning** |
+| <img src="https://registry.npmmirror.com/@lobehub/icons-static-svg/latest/files/icons/ollama.svg" height="18"> **Ollama** | **Local Inference**, Chat, Streaming, Tools, Vision, Embeddings |
+
+---
+
+## 📚 Documentation & Installation
+
+```bash
+npm install @node-llm/core
+```
+
+**[View Full Documentation ↗](https://node-llm.eshaiju.com/)**
+
+---
+
+## 🫶 Credits
+
+Heavily inspired by the elegant design of [RubyLLM](https://rubyllm.com/).
+
+---
+
+## 📄 License
+
+MIT © [NodeLLMcontributors]

package/dist/aliases.d.ts

@@ -0,0 +1,134 @@
+declare const _default: {
+    readonly "chatgpt-4o": {
+        readonly openai: "chatgpt-4o-latest";
+        readonly openrouter: "openai/chatgpt-4o-latest";
+    };
+    readonly "claude-3-5-haiku": {
+        readonly anthropic: "claude-3-5-haiku-20241022";
+        readonly openrouter: "anthropic/claude-3.5-haiku";
+        readonly bedrock: "anthropic.claude-3-5-haiku-20241022-v1:0";
+    };
+    readonly "claude-3-5-sonnet": {
+        readonly anthropic: "claude-3-5-sonnet-20240620";
+        readonly openrouter: "anthropic/claude-3.5-sonnet";
+        readonly bedrock: "anthropic.claude-3-5-sonnet-20240620-v1:0";
+    };
+    readonly "claude-sonnet-4-5": {
+        readonly anthropic: "claude-sonnet-4-5-20250929";
+    };
+    readonly "claude-sonnet-4": {
+        readonly anthropic: "claude-sonnet-4-20250514";
+    };
+    readonly "claude-3-7-sonnet": {
+        readonly anthropic: "claude-3-7-sonnet-20250219";
+        readonly openrouter: "anthropic/claude-3.7-sonnet";
+        readonly bedrock: "us.anthropic.claude-3-7-sonnet-20250219-v1:0";
+    };
+    readonly "claude-3-haiku": {
+        readonly anthropic: "claude-3-haiku-20240307";
+        readonly openrouter: "anthropic/claude-3-haiku";
+        readonly bedrock: "anthropic.claude-3-haiku-20240307-v1:0:200k";
+    };
+    readonly "claude-3-opus": {
+        readonly anthropic: "claude-3-opus-20240229";
+        readonly openrouter: "anthropic/claude-3-opus";
+        readonly bedrock: "anthropic.claude-3-opus-20240229-v1:0:200k";
+    };
+    readonly "claude-3-sonnet": {
+        readonly bedrock: "anthropic.claude-3-sonnet-20240229-v1:0";
+    };
+    readonly "deepseek-chat": {
+        readonly deepseek: "deepseek-chat";
+        readonly openrouter: "deepseek/deepseek-chat";
+    };
+    readonly "gemini-flash": {
+        readonly gemini: "gemini-flash-latest";
+        readonly vertexai: "gemini-flash-latest";
+        readonly openrouter: "google/gemini-flash-latest";
+    };
+    readonly "gemini-pro": {
+        readonly gemini: "gemini-1.5-pro-001";
+        readonly vertexai: "gemini-1.5-pro-001";
+        readonly openrouter: "google/gemini-1.5-pro-001";
+    };
+    readonly "gemini-1.5-flash": {
+        readonly gemini: "gemini-1.5-flash-001";
+        readonly vertexai: "gemini-1.5-flash-001";
+        readonly openrouter: "google/gemini-1.5-flash-001";
+    };
+    readonly "gemini-1.5-pro": {
+        readonly gemini: "gemini-1.5-pro-001";
+        readonly vertexai: "gemini-1.5-pro-001";
+        readonly openrouter: "google/gemini-1.5-pro-001";
+    };
+    readonly "gemini-2.0-flash": {
+        readonly gemini: "gemini-2.0-flash";
+        readonly vertexai: "gemini-2.0-flash";
+    };
+    readonly "gemini-2.0-flash-001": {
+        readonly gemini: "gemini-2.0-flash-001";
+        readonly openrouter: "google/gemini-2.0-flash-001";
+        readonly vertexai: "gemini-2.0-flash-001";
+    };
+    readonly "gpt-3.5-turbo": {
+        readonly openai: "gpt-3.5-turbo";
+        readonly openrouter: "openai/gpt-3.5-turbo";
+    };
+    readonly "gpt-4": {
+        readonly openai: "gpt-4";
+        readonly openrouter: "openai/gpt-4";
+    };
+    readonly "gpt-4-turbo": {
+        readonly openai: "gpt-4-turbo";
+        readonly openrouter: "openai/gpt-4-turbo";
+    };
+    readonly "gpt-4o": {
+        readonly openai: "gpt-4o";
+        readonly openrouter: "openai/gpt-4o";
+    };
+    readonly "gpt-4o-mini": {
+        readonly openai: "gpt-4o-mini";
+        readonly openrouter: "openai/gpt-4o-mini";
+    };
+    readonly "llama-3-1-405b": {
+        readonly openrouter: "meta-llama/llama-3.1-405b";
+    };
+    readonly "llama-3-1-405b-instruct": {
+        readonly openrouter: "meta-llama/llama-3.1-405b-instruct";
+    };
+    readonly "llama-3-1-70b": {
+        readonly openrouter: "meta-llama/llama-3.1-70b";
+    };
+    readonly "llama-3-1-70b-instruct": {
+        readonly openrouter: "meta-llama/llama-3.1-70b-instruct";
+    };
+    readonly "llama-3-1-8b": {
+        readonly openrouter: "meta-llama/llama-3.1-8b";
+    };
+    readonly "llama-3-1-8b-instruct": {
+        readonly openrouter: "meta-llama/llama-3.1-8b-instruct";
+    };
+    readonly "llama-3-2-1b-instruct": {
+        readonly openrouter: "meta-llama/llama-3.2-1b-instruct";
+    };
+    readonly "llama-3-2-3b-instruct": {
+        readonly openrouter: "meta-llama/llama-3.2-3b-instruct";
+    };
+    readonly "llama-3-3-70b-instruct": {
+        readonly openrouter: "meta-llama/llama-3.3-70b-instruct";
+    };
+    readonly "mistral-large": {
+        readonly mistral: "mistral-large-latest";
+        readonly openrouter: "mistralai/mistral-large";
+    };
+    readonly "mistral-medium": {
+        readonly mistral: "mistral-medium-latest";
+        readonly openrouter: "mistralai/mistral-medium";
+    };
+    readonly "mistral-small": {
+        readonly mistral: "mistral-small-latest";
+        readonly openrouter: "mistralai/mistral-small";
+    };
+};
+export default _default;
+//# sourceMappingURL=aliases.d.ts.map

package/dist/aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../src/aliases.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAmIW"}

package/dist/{aliases.json → aliases.js}

@@ -1,4 +1,4 @@
-{
+export default {
     "chatgpt-4o": {
         "openai": "chatgpt-4o-latest",
         "openrouter": "openai/chatgpt-4o-latest"
@@ -13,6 +13,12 @@
         "openrouter": "anthropic/claude-3.5-sonnet",
         "bedrock": "anthropic.claude-3-5-sonnet-20240620-v1:0"
     },
+    "claude-sonnet-4-5": {
+        "anthropic": "claude-sonnet-4-5-20250929"
+    },
+    "claude-sonnet-4": {
+        "anthropic": "claude-sonnet-4-20250514"
+    },
     "claude-3-7-sonnet": {
         "anthropic": "claude-3-7-sonnet-20250219",
         "openrouter": "anthropic/claude-3.7-sonnet",
@@ -123,4 +129,4 @@
         "mistral": "mistral-small-latest",
         "openrouter": "mistralai/mistral-small"
     }
-}
+};

package/dist/chat/Chat.d.ts

@@ -27,6 +27,7 @@ export declare class Chat {
      * Read-only access to message history
      */
     get history(): readonly Message[];
+    get modelId(): string;
     /**
      * Aggregate usage across the entire conversation
      */
@@ -37,14 +38,16 @@ export declare class Chat {
      */
     withTool(tool: any): this;
     /**
-     * Add multiple tools to the chat session.
-     * Supports passing tool instances or classes (which will be instantiated).
-     * Can replace existing tools if options.replace is true.
-     *
-     * @example
-     * chat.withTools([WeatherTool, new CalculatorTool()], { replace: true });
-     */
-    withTools(tools: (Tool | any)[], options?: {
+   * Add multiple tools to the chat session.
+   * Supports passing Tool classes (which will be instantiated) or instances.
+   * Can replace existing tools if options.replace is true.
+   *
+   * @example
+   * chat.withTools([WeatherTool, new CalculatorTool()], { replace: true });
+   */
+    withTools(tools: (Tool | {
+        new (): Tool;
+    } | any)[], options?: {
         replace?: boolean;
     }): this;
     /**

package/dist/chat/Chat.d.ts.map

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

package/dist/chat/Chat.js

@@ -32,6 +32,9 @@ export class Chat {
     get history() {
         return this.messages;
     }
+    get modelId() {
+        return this.model;
+    }
     /**
      * Aggregate usage across the entire conversation
      */
@@ -56,13 +59,13 @@ export class Chat {
         return this.withTools([tool]);
     }
     /**
-     * Add multiple tools to the chat session.
-     * Supports passing tool instances or classes (which will be instantiated).
-     * Can replace existing tools if options.replace is true.
-     *
-     * @example
-     * chat.withTools([WeatherTool, new CalculatorTool()], { replace: true });
-     */
+   * Add multiple tools to the chat session.
+   * Supports passing Tool classes (which will be instantiated) or instances.
+   * Can replace existing tools if options.replace is true.
+   *
+   * @example
+   * chat.withTools([WeatherTool, new CalculatorTool()], { replace: true });
+   */
     withTools(tools, options) {
         if (options?.replace) {
             this.options.tools = [];
@@ -71,20 +74,27 @@ export class Chat {
             this.options.tools = [];
         }
         for (const tool of tools) {
+            let toolInstance;
+            // Handle class constructor
             if (typeof tool === "function") {
                 try {
-                    // Attempt to instantiate if it's a class
-                    this.options.tools.push(new tool());
+                    toolInstance = new tool();
                 }
                 catch (e) {
-                    // If instantiation fails, it might be a function tool or require args? 
-                    // For now, assuming classes with no-arg constructors as per convention.
-                    console.warn("Attempted to instantiate tool class but failed, adding as-is", e);
-                    this.options.tools.push(tool);
+                    console.error(`[NodeLLM] Failed to instantiate tool class: ${tool.name}`, e);
+                    continue;
                 }
             }
             else {
-                this.options.tools.push(tool);
+                toolInstance = tool;
+            }
+            // Normalized to standard ToolDefinition interface if it's a Tool class instance
+            if (toolInstance && typeof toolInstance.toLLMTool === "function") {
+                this.options.tools.push(toolInstance.toLLMTool());
+            }
+            else {
+                // Fallback for legacy raw tool objects (defined as objects with type: 'function')
+                this.options.tools.push(toolInstance);
             }
         }
         return this;
@@ -286,7 +296,7 @@ export class Chat {
             this.options.onNewMessage();
         let response = await this.executor.executeChat(executeOptions);
         trackUsage(response.usage);
-        const firstAssistantMessage = new ChatResponseString(response.content ?? "", response.usage ?? { input_tokens: 0, output_tokens: 0, total_tokens: 0 }, this.model, response.reasoning);
+        const firstAssistantMessage = new ChatResponseString(response.content ?? "", response.usage ?? { input_tokens: 0, output_tokens: 0, total_tokens: 0 }, this.model, this.provider.id, response.reasoning);
         this.messages.push({
             role: "assistant",
             content: firstAssistantMessage,
@@ -336,7 +346,7 @@ export class Chat {
                 headers: this.options.headers,
             });
             trackUsage(response.usage);
-            const assistantMessage = new ChatResponseString(response.content ?? "", response.usage ?? { input_tokens: 0, output_tokens: 0, total_tokens: 0 }, this.model, response.reasoning);
+            const assistantMessage = new ChatResponseString(response.content ?? "", response.usage ?? { input_tokens: 0, output_tokens: 0, total_tokens: 0 }, this.model, this.provider.id, response.reasoning);
             this.messages.push({
                 role: "assistant",
                 content: assistantMessage,
@@ -349,7 +359,7 @@ export class Chat {
         }
         // For the final return, we might want to aggregate reasoning too if it happened in multiple turns? 
         // Usually reasoning only happens once or we just want the last one.
-        return new ChatResponseString(response.content ?? "", totalUsage, this.model, response.reasoning);
+        return new ChatResponseString(response.content ?? "", totalUsage, this.model, this.provider.id, response.reasoning);
     }
     /**
      * Streams the model's response to a user question.

package/dist/chat/ChatOptions.d.ts

@@ -1,10 +1,10 @@
 import { Message } from "./Message.js";
-import { Tool } from "./Tool.js";
+import { ToolDefinition } from "./Tool.js";
 import { Schema } from "../schema/Schema.js";
 export interface ChatOptions {
     systemPrompt?: string;
     messages?: Message[];
-    tools?: Tool[];
+    tools?: ToolDefinition[];
     temperature?: number;
     maxTokens?: number;
     onNewMessage?: () => void;

package/dist/chat/ChatOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatOptions.d.ts","sourceRoot":"","sources":["../../src/chat/ChatOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IACrC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAAA;KAAE,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"ChatOptions.d.ts","sourceRoot":"","sources":["../../src/chat/ChatOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IACrC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAAA;KAAE,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/chat/ChatResponse.d.ts

@@ -6,8 +6,9 @@ import { Usage } from "../providers/Provider.js";
 export declare class ChatResponseString extends String {
     readonly usage: Usage;
     readonly model: string;
+    readonly provider: string;
     readonly reasoning?: string | null | undefined;
-    constructor(content: string, usage: Usage, model: string, reasoning?: string | null | undefined);
+    constructor(content: string, usage: Usage, model: string, provider: string, reasoning?: string | null | undefined);
     get input_tokens(): number;
     get output_tokens(): number;
     get total_tokens(): number;

package/dist/chat/ChatResponse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatResponse.d.ts","sourceRoot":"","sources":["../../src/chat/ChatResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,MAAM;aAG1B,KAAK,EAAE,KAAK;aACZ,KAAK,EAAE,MAAM;aACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;gBAHzC,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,YAAA;IAK3C,IAAI,YAAY,WAAsC;IACtD,IAAI,aAAa,WAAuC;IACxD,IAAI,YAAY,WAAsC;IACtD,IAAI,aAAa,uBAAuC;IACxD,IAAI,IAAI,uBAA8B;IACtC,IAAI,UAAU,uBAAoC;IAClD,IAAI,WAAW,uBAAqC;IAEpD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,QAAQ;IAIR;;;OAGG;IACH,IAAI,MAAM,IAAI,GAAG,CAMhB;CACF"}
+{"version":3,"file":"ChatResponse.d.ts","sourceRoot":"","sources":["../../src/chat/ChatResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,MAAM;aAG1B,KAAK,EAAE,KAAK;aACZ,KAAK,EAAE,MAAM;aACb,QAAQ,EAAE,MAAM;aAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;gBAJzC,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,YAAA;IAK3C,IAAI,YAAY,WAAsC;IACtD,IAAI,aAAa,WAAuC;IACxD,IAAI,YAAY,WAAsC;IACtD,IAAI,aAAa,uBAAuC;IACxD,IAAI,IAAI,uBAA8B;IACtC,IAAI,UAAU,uBAAoC;IAClD,IAAI,WAAW,uBAAqC;IAEpD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,QAAQ;IAIR;;;OAGG;IACH,IAAI,MAAM,IAAI,GAAG,CAMhB;CACF"}

package/dist/chat/ChatResponse.js

@@ -5,11 +5,13 @@
 export class ChatResponseString extends String {
     usage;
     model;
+    provider;
     reasoning;
-    constructor(content, usage, model, reasoning) {
+    constructor(content, usage, model, provider, reasoning) {
         super(content);
         this.usage = usage;
         this.model = model;
+        this.provider = provider;
         this.reasoning = reasoning;
     }
     get input_tokens() { return this.usage.input_tokens; }

package/dist/chat/ChatStream.js

@@ -86,13 +86,12 @@ export class ChatStream {
                         role: "assistant",
                         content: fullContent || null,
                         tool_calls: toolCalls,
-                        // @ts-ignore
                         reasoning: fullReasoning || undefined
                     });
                     // If no tool calls, we're done
                     if (!toolCalls || toolCalls.length === 0) {
                         if (options.onEndMessage) {
-                            options.onEndMessage(new ChatResponseString(fullContent, { input_tokens: 0, output_tokens: 0, total_tokens: 0 }, model, fullReasoning || undefined));
+                            options.onEndMessage(new ChatResponseString(fullContent, { input_tokens: 0, output_tokens: 0, total_tokens: 0 }, model, provider.id, fullReasoning || undefined));
                         }
                         break;
                     }

package/dist/chat/Message.d.ts

@@ -9,5 +9,6 @@ export interface Message {
     tool_call_id?: string;
     name?: string;
     usage?: Usage;
+    reasoning?: string;
 }
 //# sourceMappingURL=Message.d.ts.map

package/dist/chat/Message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../src/chat/Message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;CACf"}
+{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../src/chat/Message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}