@node-llm/core 1.5.2 → 1.6.0

package/dist/chat/Tool.d.ts

@@ -1,49 +1,49 @@
 import { z } from "zod";
 export interface ToolCall {
     id: string;
-    type: 'function';
+    type: "function";
     function: {
         name: string;
         arguments: string;
     };
 }
 export interface ToolDefinition {
-    type: 'function';
+    type: "function";
     function: {
         name: string;
         description?: string;
-        parameters: Record<string, any>;
+        parameters: Record<string, unknown>;
     };
-    handler?: (args: any) => Promise<string>;
+    handler?: (args: unknown) => Promise<string>;
 }
 /**
  * Anything that can be resolved into a ToolDefinition.
  */
 export type ToolResolvable = Tool | {
     new (): Tool;
-} | ToolDefinition | any;
+} | ToolDefinition;
 /**
  * Subclass this to create tools with auto-generated schemas and type safety.
  */
-export declare abstract class Tool<T = any> {
+export declare abstract class Tool<T = Record<string, unknown>> {
     /**
-     * The name of the tool (must match [a-zA-Z0-9_-]+).
-     */
+      * The name of the tool (must match [a-zA-Z0-9_-]+).
+      */
     abstract name: string;
     /**
-     * A clear description of what the tool does, used by the LLM to decide when to call it.
-     */
+      * A clear description of what the tool does, used by the LLM to decide when to call it.
+      */
     abstract description: string;
     /**
-     * Parameters the tool accepts.
-     * Can be a Zod object (for auto-schema + type safety) or a raw JSON Schema.
-     */
-    abstract schema: z.ZodObject<any> | Record<string, any>;
+      * Parameters the tool accepts.
+      * Can be a Zod object (for auto-schema + type safety) or a raw JSON Schema.
+      */
+    abstract schema: z.ZodObject<z.ZodRawShape> | Record<string, unknown>;
     /**
      * The core logic for the tool.
      * 'args' will be parsed and validated based on 'schema'.
      */
-    abstract execute(args: T): Promise<any>;
+    abstract execute(args: T): Promise<unknown>;
     /**
      * Internal handler to bridge with LLM providers.
      * Converts any result to a string (usually JSON).

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

@@ -1 +1 @@
-{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../src/chat/Tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG;IAAE,QAAO,IAAI,CAAA;CAAE,GAAG,cAAc,GAAG,GAAG,CAAC;AAE3E;;GAEG;AACH,8BAAsB,IAAI,CAAC,CAAC,GAAG,GAAG;IAChC;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC;;;OAGG;IACH,SAAgB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/D;;;OAGG;aACa,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAE9C;;;OAGG;IACU,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAM9C;;;OAGG;IACI,SAAS,IAAI,cAAc;CAoBnC"}
+{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../src/chat/Tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG;IAAE,QAAQ,IAAI,CAAA;CAAE,GAAG,cAAc,CAAC;AAEtE;;GAEG;AACH,8BAAsB,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD;;QAEI;IACJ,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;QAEI;IACJ,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC;;;QAGI;IACJ,SAAgB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7E;;;OAGG;aACa,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAElD;;;OAGG;IACU,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAM9C;;;OAGG;IACI,SAAS,IAAI,cAAc;CAuBnC"}

package/dist/chat/Tool.js

@@ -20,19 +20,21 @@ export class Tool {
     toLLMTool() {
         const rawSchema = toJsonSchema(this.schema);
         // We want the 'properties' and 'required' parts, not the full JSON Schema wrapper if present
-        const parameters = rawSchema.type === "object" ? rawSchema : {
-            type: "object",
-            properties: rawSchema.properties || {},
-            required: rawSchema.required || []
-        };
+        const parameters = rawSchema.type === "object"
+            ? rawSchema
+            : {
+                type: "object",
+                properties: rawSchema.properties || {},
+                required: rawSchema.required || []
+            };
         return {
             type: "function",
             function: {
                 name: this.name,
                 description: this.description,
-                parameters: parameters,
+                parameters: parameters
             },
-            handler: this.handler.bind(this),
+            handler: (args) => this.handler(args)
         };
     }
 }

package/dist/chat/ToolHandler.d.ts

@@ -1,8 +1,9 @@
 import { ToolExecutionMode } from "../constants.js";
+import { ToolCall, ToolDefinition } from "./Tool.js";
 export declare class ToolHandler {
-    static shouldExecuteTools(toolCalls: any[] | undefined, mode?: ToolExecutionMode): boolean;
-    static requestToolConfirmation(toolCall: any, onConfirm?: (call: any) => Promise<boolean> | boolean): Promise<boolean>;
-    static execute(toolCall: any, tools: any[] | undefined, onStart?: (call: any) => void, onEnd?: (call: any, result: any) => void): Promise<{
+    static shouldExecuteTools(toolCalls: ToolCall[] | undefined, mode?: ToolExecutionMode): boolean;
+    static requestToolConfirmation(toolCall: ToolCall, onConfirm?: (call: ToolCall) => Promise<boolean> | boolean): Promise<boolean>;
+    static execute(toolCall: ToolCall, tools: ToolDefinition[] | undefined, onStart?: (call: ToolCall) => void, onEnd?: (call: ToolCall, result: unknown) => void): Promise<{
         role: "tool";
         tool_call_id: string;
         content: string;

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

@@ -1 +1 @@
-{"version":3,"file":"ToolHandler.d.ts","sourceRoot":"","sources":["../../src/chat/ToolHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,qBAAa,WAAW;IACtB,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO;WAM7E,uBAAuB,CAClC,QAAQ,EAAE,GAAG,EACb,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GACpD,OAAO,CAAC,OAAO,CAAC;WAMN,OAAO,CAClB,QAAQ,EAAE,GAAG,EACb,KAAK,EAAE,GAAG,EAAE,GAAG,SAAS,EACxB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,EAC7B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,GACvC,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAwBpE"}
+{"version":3,"file":"ToolHandler.d.ts","sourceRoot":"","sources":["../../src/chat/ToolHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAErD,qBAAa,WAAW;IACtB,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO;WAMlF,uBAAuB,CAClC,QAAQ,EAAE,QAAQ,EAClB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GACzD,OAAO,CAAC,OAAO,CAAC;WAMN,OAAO,CAClB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,cAAc,EAAE,GAAG,SAAS,EACnC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,EAClC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAChD,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAwBpE"}

package/dist/chat/ToolHandler.js

@@ -19,20 +19,16 @@ export class ToolHandler {
             onStart(toolCall);
         const tool = tools?.find((t) => t.function.name === toolCall.function.name);
         if (tool?.handler) {
-            try {
-                const args = JSON.parse(toolCall.function.arguments);
-                const result = await tool.handler(args);
-                if (onEnd)
-                    onEnd(toolCall, result);
-                return {
-                    role: "tool",
-                    tool_call_id: toolCall.id,
-                    content: result,
-                };
-            }
-            catch (error) {
-                throw error;
-            }
+            const args = JSON.parse(toolCall.function.arguments);
+            const result = await tool.handler(args);
+            const safeResult = typeof result === "string" ? result : JSON.stringify(result);
+            if (onEnd)
+                onEnd(toolCall, result);
+            return {
+                role: "tool",
+                tool_call_id: toolCall.id,
+                content: safeResult
+            };
         }
         else {
             throw new ToolError("Tool not found or no handler provided", toolCall.function?.name ?? "unknown");

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

@@ -1 +1 @@
-{"version":3,"file":"Validation.d.ts","sourceRoot":"","sources":["../../src/chat/Validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB;IAYvG,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB;IAYrG,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB;CAWlH"}
+{"version":3,"file":"Validation.d.ts","sourceRoot":"","sources":["../../src/chat/Validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,cAAc,CACnB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,iBAAiB;IAiB5B,MAAM,CAAC,aAAa,CAClB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,iBAAiB;IAiB5B,MAAM,CAAC,wBAAwB,CAC7B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,iBAAiB;CAgB7B"}

package/dist/chat/Validation.js

@@ -1,32 +1,39 @@
+import { logger } from "../utils/logger.js";
 export class ChatValidator {
     static validateVision(provider, model, hasBinary, options) {
         if (!hasBinary)
             return;
-        if (!options.assumeModelExists && provider.capabilities && !provider.capabilities.supportsVision(model)) {
+        if (!options.assumeModelExists &&
+            provider.capabilities &&
+            !provider.capabilities.supportsVision(model)) {
             throw new Error(`Model ${model} does not support vision/binary files.`);
         }
         if (options.assumeModelExists) {
-            console.warn(`[NodeLLM] Skipping vision capability validation for model ${model}`);
+            logger.warn(`Skipping vision capability validation for model ${model}`);
         }
     }
     static validateTools(provider, model, hasTools, options) {
         if (!hasTools)
             return;
-        if (!options.assumeModelExists && provider.capabilities && !provider.capabilities.supportsTools(model)) {
+        if (!options.assumeModelExists &&
+            provider.capabilities &&
+            !provider.capabilities.supportsTools(model)) {
             throw new Error(`Model ${model} does not support tool calling.`);
         }
         if (options.assumeModelExists) {
-            console.warn(`[NodeLLM] Skipping tool capability validation for model ${model}`);
+            logger.warn(`Skipping tool capability validation for model ${model}`);
         }
     }
     static validateStructuredOutput(provider, model, hasSchema, options) {
         if (!hasSchema)
             return;
-        if (!options.assumeModelExists && provider.capabilities && !provider.capabilities.supportsStructuredOutput(model)) {
+        if (!options.assumeModelExists &&
+            provider.capabilities &&
+            !provider.capabilities.supportsStructuredOutput(model)) {
             throw new Error(`Model ${model} does not support structured output.`);
         }
         if (options.assumeModelExists) {
-            console.warn(`[NodeLLM] Skipping structured output capability validation for model ${model}`);
+            logger.warn(`Skipping structured output capability validation for model ${model}`);
         }
     }
 }

package/dist/config.d.ts

@@ -20,6 +20,7 @@ export interface NodeLLMConfig {
     requestTimeout?: number;
     maxTokens?: number;
     toolExecution?: ToolExecutionMode;
+    provider?: string;
 }
 import { ToolExecutionMode } from "./constants.js";
 export declare class Configuration implements NodeLLMConfig {
@@ -35,6 +36,7 @@ export declare class Configuration implements NodeLLMConfig {
     private _openrouterApiKey?;
     private _openrouterApiBase?;
     private _debug?;
+    private _provider?;
     get openaiApiKey(): string | undefined;
     set openaiApiKey(v: string | undefined);
     get openaiApiBase(): string | undefined;
@@ -59,6 +61,8 @@ export declare class Configuration implements NodeLLMConfig {
     set openrouterApiBase(v: string | undefined);
     get debug(): boolean | undefined;
     set debug(v: boolean | undefined);
+    get provider(): string | undefined;
+    set provider(v: string | undefined);
     maxToolCalls: number;
     maxRetries: number;
     requestTimeout: number;

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -12,30 +12,85 @@ export class Configuration {
     _openrouterApiKey;
     _openrouterApiBase;
     _debug;
-    get openaiApiKey() { return this._openaiApiKey ?? process.env.OPENAI_API_KEY?.trim(); }
-    set openaiApiKey(v) { this._openaiApiKey = v; }
-    get openaiApiBase() { return this._openaiApiBase ?? process.env.OPENAI_API_BASE?.trim(); }
-    set openaiApiBase(v) { this._openaiApiBase = v; }
-    get anthropicApiKey() { return this._anthropicApiKey ?? process.env.ANTHROPIC_API_KEY?.trim(); }
-    set anthropicApiKey(v) { this._anthropicApiKey = v; }
-    get anthropicApiBase() { return this._anthropicApiBase ?? process.env.ANTHROPIC_API_BASE?.trim(); }
-    set anthropicApiBase(v) { this._anthropicApiBase = v; }
-    get geminiApiKey() { return this._geminiApiKey ?? process.env.GEMINI_API_KEY?.trim(); }
-    set geminiApiKey(v) { this._geminiApiKey = v; }
-    get geminiApiBase() { return this._geminiApiBase ?? process.env.GEMINI_API_BASE?.trim(); }
-    set geminiApiBase(v) { this._geminiApiBase = v; }
-    get deepseekApiKey() { return this._deepseekApiKey ?? process.env.DEEPSEEK_API_KEY?.trim(); }
-    set deepseekApiKey(v) { this._deepseekApiKey = v; }
-    get deepseekApiBase() { return this._deepseekApiBase ?? process.env.DEEPSEEK_API_BASE?.trim(); }
-    set deepseekApiBase(v) { this._deepseekApiBase = v; }
-    get ollamaApiBase() { return this._ollamaApiBase ?? process.env.OLLAMA_API_BASE?.trim() ?? DEFAULT_OLLAMA_BASE_URL; }
-    set ollamaApiBase(v) { this._ollamaApiBase = v; }
-    get openrouterApiKey() { return this._openrouterApiKey ?? process.env.OPENROUTER_API_KEY?.trim(); }
-    set openrouterApiKey(v) { this._openrouterApiKey = v; }
-    get openrouterApiBase() { return this._openrouterApiBase ?? process.env.OPENROUTER_API_BASE?.trim(); }
-    set openrouterApiBase(v) { this._openrouterApiBase = v; }
-    get debug() { return this._debug ?? process.env.NODELLM_DEBUG === "true"; }
-    set debug(v) { this._debug = v; }
+    _provider;
+    get openaiApiKey() {
+        return this._openaiApiKey ?? process.env.OPENAI_API_KEY?.trim();
+    }
+    set openaiApiKey(v) {
+        this._openaiApiKey = v;
+    }
+    get openaiApiBase() {
+        return this._openaiApiBase ?? process.env.OPENAI_API_BASE?.trim();
+    }
+    set openaiApiBase(v) {
+        this._openaiApiBase = v;
+    }
+    get anthropicApiKey() {
+        return this._anthropicApiKey ?? process.env.ANTHROPIC_API_KEY?.trim();
+    }
+    set anthropicApiKey(v) {
+        this._anthropicApiKey = v;
+    }
+    get anthropicApiBase() {
+        return this._anthropicApiBase ?? process.env.ANTHROPIC_API_BASE?.trim();
+    }
+    set anthropicApiBase(v) {
+        this._anthropicApiBase = v;
+    }
+    get geminiApiKey() {
+        return this._geminiApiKey ?? process.env.GEMINI_API_KEY?.trim();
+    }
+    set geminiApiKey(v) {
+        this._geminiApiKey = v;
+    }
+    get geminiApiBase() {
+        return this._geminiApiBase ?? process.env.GEMINI_API_BASE?.trim();
+    }
+    set geminiApiBase(v) {
+        this._geminiApiBase = v;
+    }
+    get deepseekApiKey() {
+        return this._deepseekApiKey ?? process.env.DEEPSEEK_API_KEY?.trim();
+    }
+    set deepseekApiKey(v) {
+        this._deepseekApiKey = v;
+    }
+    get deepseekApiBase() {
+        return this._deepseekApiBase ?? process.env.DEEPSEEK_API_BASE?.trim();
+    }
+    set deepseekApiBase(v) {
+        this._deepseekApiBase = v;
+    }
+    get ollamaApiBase() {
+        return this._ollamaApiBase ?? process.env.OLLAMA_API_BASE?.trim() ?? DEFAULT_OLLAMA_BASE_URL;
+    }
+    set ollamaApiBase(v) {
+        this._ollamaApiBase = v;
+    }
+    get openrouterApiKey() {
+        return this._openrouterApiKey ?? process.env.OPENROUTER_API_KEY?.trim();
+    }
+    set openrouterApiKey(v) {
+        this._openrouterApiKey = v;
+    }
+    get openrouterApiBase() {
+        return this._openrouterApiBase ?? process.env.OPENROUTER_API_BASE?.trim();
+    }
+    set openrouterApiBase(v) {
+        this._openrouterApiBase = v;
+    }
+    get debug() {
+        return this._debug ?? process.env.NODELLM_DEBUG === "true";
+    }
+    set debug(v) {
+        this._debug = v;
+    }
+    get provider() {
+        return this._provider ?? process.env.NODELLM_PROVIDER?.trim();
+    }
+    set provider(v) {
+        this._provider = v;
+    }
     maxToolCalls = DEFAULT_MAX_TOOL_CALLS;
     maxRetries = DEFAULT_MAX_RETRIES;
     requestTimeout = DEFAULT_REQUEST_TIMEOUT;
@@ -57,7 +112,7 @@ export class Configuration {
             const descriptor = Object.getOwnPropertyDescriptor(prototype, name);
             if (descriptor && descriptor.get) {
                 // Trigger the getter to snapshot the live value (including env fallbacks)
-                plain[name] = this[name];
+                plain[name] = Reflect.get(this, name);
             }
         }
         return plain;

package/dist/constants.js

@@ -14,5 +14,5 @@ export const DEFAULT_MODELS = {
     TRANSCRIPTION: "whisper-1",
     MODERATION: "omni-moderation-latest",
     EMBEDDING: "text-embedding-3-small",
-    IMAGE: "dall-e-3",
+    IMAGE: "dall-e-3"
 };

package/dist/errors/index.d.ts

@@ -1,3 +1,17 @@
+/**
+ * NodeLLM Error Hierarchy
+ *
+ * **Stability Contract**: These error types and their semantics are part of the
+ * public API and will not change without a major version bump.
+ *
+ * - Error names are stable
+ * - Error codes are stable
+ * - Error semantics (when they're thrown) are stable
+ * - New errors may be added (non-breaking)
+ * - Existing error meanings will not change
+ *
+ * @see ARCHITECTURE.md for error contract details
+ */
 /**
  * Base class for all NodeLLM errors
  */
@@ -10,40 +24,40 @@ export declare class LLMError extends Error {
  */
 export declare class APIError extends LLMError {
     readonly status: number;
-    readonly body: any;
+    readonly body: unknown;
     readonly provider?: string | undefined;
     readonly model?: string | undefined;
-    constructor(message: string, status: number, body: any, provider?: string | undefined, model?: string | undefined);
+    constructor(message: string, status: number, body: unknown, provider?: string | undefined, model?: string | undefined);
 }
 /**
  * 400 - Invalid request parameters
  */
 export declare class BadRequestError extends APIError {
-    constructor(message: string, body: any, provider?: string, model?: string);
+    constructor(message: string, body: unknown, provider?: string, model?: string);
 }
 /**
  * 401/403 - API key or permission issues
  */
 export declare class AuthenticationError extends APIError {
-    constructor(message: string, status: number, body: any, provider?: string);
+    constructor(message: string, status: number, body: unknown, provider?: string);
 }
 /**
  * 429 - Rate limit exceeded
  */
 export declare class RateLimitError extends APIError {
-    constructor(message: string, body: any, provider?: string, model?: string);
+    constructor(message: string, body: unknown, provider?: string, model?: string);
 }
 /**
  * 500+ - Provider server error
  */
 export declare class ServerError extends APIError {
-    constructor(message: string, status: number, body: any, provider?: string, model?: string);
+    constructor(message: string, status: number, body: unknown, provider?: string, model?: string);
 }
 /**
  * 502/503/529 - Service overloaded/unavailable
  */
 export declare class ServiceUnavailableError extends ServerError {
-    constructor(message: string, status: number, body: any, provider?: string, model?: string);
+    constructor(message: string, status: number, body: unknown, provider?: string, model?: string);
 }
 /**
  * Misconfiguration (e.g. missing API key)

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aACY,IAAI,CAAC,EAAE,MAAM;gBAA9C,OAAO,EAAE,MAAM,EAAkB,IAAI,CAAC,EAAE,MAAM,YAAA;CAK3D;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,QAAQ;aAGlB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,GAAG;aACT,QAAQ,CAAC,EAAE,MAAM;aACjB,KAAK,CAAC,EAAE,MAAM;gBAJ9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG,EACT,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,KAAK,CAAC,EAAE,MAAM,YAAA;CAIjC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI1E;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM;CAI1E;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI1E;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI1F;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI1F;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,QAAQ;;CAIvD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;aAEjC,QAAQ,EAAE,MAAM;aAChB,OAAO,EAAE,MAAM;gBADf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM;CAIlC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;aAE9B,KAAK,EAAE,MAAM;aACb,UAAU,EAAE,MAAM;gBADlB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM;CAIrC;AACD;;GAEG;AACH,qBAAa,SAAU,SAAQ,QAAQ;aAGnB,QAAQ,CAAC,EAAE,MAAM;aACjB,KAAK,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,KAAK,GAAE,OAAe;CAKzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,IAAI,CAAC,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAMhC;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,QAAQ;aAGlB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,OAAO;aACb,QAAQ,CAAC,EAAE,MAAM;aACjB,KAAK,CAAC,EAAE,MAAM;gBAJ9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,KAAK,CAAC,EAAE,MAAM,YAAA;CAIjC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI9E;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM;CAI9E;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI9E;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI9F;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI9F;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,QAAQ;;CAIvD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;aAEjC,QAAQ,EAAE,MAAM;aAChB,OAAO,EAAE,MAAM;gBADf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM;CAIlC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;aAE9B,KAAK,EAAE,MAAM;aACb,UAAU,EAAE,MAAM;gBADlB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM;CAIrC;AACD;;GAEG;AACH,qBAAa,SAAU,SAAQ,QAAQ;aAGnB,QAAQ,CAAC,EAAE,MAAM;aACjB,KAAK,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,KAAK,GAAE,OAAe;CAKzC"}

package/dist/errors/index.js

@@ -1,3 +1,17 @@
+/**
+ * NodeLLM Error Hierarchy
+ *
+ * **Stability Contract**: These error types and their semantics are part of the
+ * public API and will not change without a major version bump.
+ *
+ * - Error names are stable
+ * - Error codes are stable
+ * - Error semantics (when they're thrown) are stable
+ * - New errors may be added (non-breaking)
+ * - Existing error meanings will not change
+ *
+ * @see ARCHITECTURE.md for error contract details
+ */
 /**
  * Base class for all NodeLLM errors
  */

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export * from "./chat/Chat.js";
 export * from "./chat/ChatStream.js";
 export * from "./streaming/Stream.js";
 export { z } from "zod";
-export { NodeLLM, Transcription, Moderation, Embedding } from "./llm.js";
+export { NodeLLM, LegacyNodeLLM, createLLM, NodeLLMCore, Transcription, Moderation, Embedding, ModelRegistry, PricingRegistry } from "./llm.js";
 export { config } from "./config.js";
 export type { NodeLLMConfig } from "./config.js";
 export { providerRegistry } from "./providers/registry.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACf,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,OAAO,EACP,aAAa,EACb,SAAS,EACT,WAAW,EACX,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,eAAe,EAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACf,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -7,7 +7,7 @@ export * from "./chat/Chat.js";
 export * from "./chat/ChatStream.js";
 export * from "./streaming/Stream.js";
 export { z } from "zod";
-export { NodeLLM, Transcription, Moderation, Embedding } from "./llm.js";
+export { NodeLLM, LegacyNodeLLM, createLLM, NodeLLMCore, Transcription, Moderation, Embedding, ModelRegistry, PricingRegistry } from "./llm.js";
 export { config } from "./config.js";
 export { providerRegistry } from "./providers/registry.js";
 export { Schema } from "./schema/Schema.js";

package/dist/llm.d.ts

@@ -3,6 +3,7 @@ import { ChatOptions } from "./chat/ChatOptions.js";
 import { Provider, ModelInfo } from "./providers/Provider.js";
 import { GeneratedImage } from "./image/GeneratedImage.js";
 import { ModelRegistry } from "./models/ModelRegistry.js";
+import { PricingRegistry } from "./models/PricingRegistry.js";
 import { Transcription } from "./transcription/Transcription.js";
 import { Moderation } from "./moderation/Moderation.js";
 import { Embedding } from "./embedding/Embedding.js";
@@ -18,57 +19,35 @@ type LLMConfig = {
     defaultTranscriptionModel?: string;
     defaultModerationModel?: string;
     defaultEmbeddingModel?: string;
-} & Partial<NodeLLMConfig>;
+} & Omit<Partial<NodeLLMConfig>, "provider">;
 export declare class NodeLLMCore {
-    readonly models: typeof ModelRegistry;
     readonly config: NodeLLMConfig;
-    private provider?;
-    private defaultChatModelId?;
-    private defaultTranscriptionModelId?;
-    private defaultModerationModelId?;
-    private defaultEmbeddingModelId?;
-    private retry;
-    /**
-     * Create a new LLM instance. Defaults to the global config.
-     */
-    constructor(customConfig?: NodeLLMConfig);
+    readonly provider?: Provider | undefined;
+    readonly retry: Required<RetryOptions>;
+    private readonly defaults;
+    readonly models: typeof ModelRegistry;
+    readonly pricing: typeof PricingRegistry;
+    constructor(config: NodeLLMConfig, provider?: Provider | undefined, retry?: Required<RetryOptions>, defaults?: {
+        chat?: string;
+        transcription?: string;
+        moderation?: string;
+        embedding?: string;
+    });
+    get defaultChatModel(): string | undefined;
+    get defaultTranscriptionModel(): string | undefined;
+    get defaultModerationModel(): string | undefined;
+    get defaultEmbeddingModel(): string | undefined;
     /**
      * Returns a scoped LLM instance configured for a specific provider.
-     * This respects the current global configuration but avoids side effects
-     * on the main NodeLLM singleton.
-     *
-     * @param providerName - The provider to use (e.g., "openai", "anthropic")
-     * @param scopedConfig - Optional configuration overrides for this scoped instance
-     *
-     * @example
-     * ```ts
-     * const openai = NodeLLM.withProvider("openai");
-     * const anthropic = NodeLLM.withProvider("anthropic");
-     *
-     * // These can now run in parallel without race conditions
-     * await Promise.all([
-     *   openai.chat("gpt-4o").ask(prompt),
-     *   anthropic.chat("claude-3-5-sonnet").ask(prompt),
-     * ]);
-     * ```
-     *
-     * @example With scoped credentials
-     * ```ts
-     * const customAnthropic = NodeLLM.withProvider("anthropic", {
-     *   anthropicApiKey: "sk-ant-custom-key"
-     * });
-     * ```
+     * This returns a NEW immutable instance.
      */
     withProvider(providerName: string, scopedConfig?: Partial<NodeLLMConfig>): NodeLLMCore;
     /**
      * Register a custom LLM provider.
-     * This allows you to extend NodeLLM with your own logic at runtime.
-     *
-     * @param name - Unique identifier for the provider
-     * @param factory - A function that returns a Provider instance
+     * Note: This modifies the global provider registry.
      */
     registerProvider(name: string, factory: () => Provider): void;
-    configure(configOrCallback: LLMConfig | ((config: NodeLLMConfig) => void)): void;
+    getRetryConfig(): Required<RetryOptions>;
     private ensureProviderSupport;
     chat(model?: string, options?: ChatOptions): Chat;
     listModels(): Promise<ModelInfo[]>;
@@ -88,10 +67,6 @@ export declare class NodeLLMCore {
         assumeModelExists?: boolean;
         requestTimeout?: number;
     }): Promise<Transcription>;
-    get defaultTranscriptionModel(): string | undefined;
-    get defaultModerationModel(): string | undefined;
-    get defaultEmbeddingModel(): string | undefined;
-    getRetryConfig(): Required<RetryOptions>;
     moderate(input: string | string[], options?: {
         model?: string;
         assumeModelExists?: boolean;
@@ -104,6 +79,29 @@ export declare class NodeLLMCore {
         requestTimeout?: number;
     }): Promise<Embedding>;
 }
-export { Transcription, Moderation, Embedding };
+export { Transcription, Moderation, Embedding, ModelRegistry, PricingRegistry };
+/**
+ * Creates a new immutable LLM instance.
+ */
+export declare function createLLM(options?: LLMConfig): NodeLLMCore;
+/**
+ * The global, immutable NodeLLM instance.
+ *
+ * DESIGN: Lazy Initialization
+ * To support 'import "dotenv/config"' patterns in ESM, this instance
+ * does NOT snapshot the environment until its first property access.
+ * Once accessed, it is frozen and becomes a stable, immutable contract.
+ *
+ * @see ARCHITECTURE.md for full contract details
+ */
 export declare const NodeLLM: NodeLLMCore;
+/**
+ * LEGACY BOOTSTRAPPER (DEPRECATED)
+ *
+ * Provided to ease migration from the mutable singleton pattern.
+ * configure() will warn and no-op, as the global instance is now immutable.
+ */
+export declare const LegacyNodeLLM: {
+    configure(_options: LLMConfig | ((config: NodeLLMConfig) => void)): void;
+};
 //# sourceMappingURL=llm.d.ts.map