@node-llm/core 1.4.2 → 1.4.3

package/README.md

@@ -1,18 +1,17 @@
 <p align="left">
-  <img src="https://github.com/eshaiju/node-llm/raw/main/docs/assets/images/logo.jpg" alt="NodeLLMlogo" width="300" />
+  <a href="https://node-llm.eshaiju.com/">
+    <img src="https://github.com/node-llm/node-llm/raw/main/docs/assets/images/logo.jpg" alt="NodeLLM logo" width="300" />
+  </a>
 </p>
 
 # NodeLLM
 
-
 **An opinionated architectural layer for integrating Large Language Models in Node.js.**
 
 **Provider-agnostic by design.**
 
 Most LLM SDKs **tightly couple** your application to vendors, APIs, and churn. NodeLLM provides a unified, production-oriented API for interacting with over 540+ models across multiple providers (OpenAI, Gemini, Anthropic, DeepSeek, OpenRouter, Ollama, etc.) without the SDK fatigue.
 
-<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" />
@@ -88,7 +87,7 @@ for await (const chunk of chat.stream("Explain event-driven architecture")) {
 
 ## 🔧 Strategic Configuration
 
-NodeLLMprovides a flexible configuration system designed for enterprise usage:
+NodeLLM provides a flexible configuration system designed for enterprise usage:
 
 ```ts
 // Recommended for multi-provider pipelines
@@ -108,7 +107,7 @@ NodeLLM.configure({
 });
 ```
 
-**[Full Configuration Guide →](docs/getting_started/configuration.md)**
+**[Full Configuration Guide →](https://node-llm.eshaiju.com/getting-started/configuration)**
 
 ---
 
@@ -135,19 +134,21 @@ await chat.ask("Analyze this interface", {
 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
+import { Tool, z } from "@node-llm/core";
+
 // 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]);
+  async handler({ location }) { 
+    return `Sunny in ${location}`; 
+  }
+}
 
 // Now the model can use it automatically
-await chat.ask("What's the weather in Tokyo?");
+await chat.withTool(WeatherTool).ask("What's the weather in Tokyo?");
 ```
 **[Full Tool Calling Guide →](https://node-llm.eshaiju.com/core-features/tool-calling)**
 
@@ -186,17 +187,15 @@ 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.
-
+Run multiple providers in parallel safely without global configuration side effects using isolated contexts.
 ```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),
+  NodeLLM.withProvider("anthropic").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
@@ -208,7 +207,7 @@ console.log(res.reasoning); // Chain-of-thought
 
 ## 🚀 Why use this over official SDKs?
 
-| Feature |`NodeLLM` | Official SDKs | Architectural Impact |
+| 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** |
@@ -242,6 +241,12 @@ npm install @node-llm/core
 
 ---
 
+## 🤝 Contributing
+
+We welcome contributions! Please see our **[Contributing Guide](https://github.com/node-llm/node-llm/blob/main/CONTRIBUTING.md)** for more details on how to get started.
+
+---
+
 ## 🫶 Credits
 
 Heavily inspired by the elegant design of [RubyLLM](https://rubyllm.com/).
@@ -250,4 +255,4 @@ Heavily inspired by the elegant design of [RubyLLM](https://rubyllm.com/).
 
 ## 📄 License
 
-MIT © [NodeLLMcontributors]
+MIT © [NodeLLM contributors]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-llm/core",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -37,12 +37,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/eshaiju/node-llm",
+    "url": "https://github.com/node-llm/node-llm",
     "directory": "packages/core"
   },
   "homepage": "https://node-llm.eshaiju.com",
   "bugs": {
-    "url": "https://github.com/eshaiju/node-llm/issues"
+    "url": "https://github.com/node-llm/node-llm/issues"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -52,14 +52,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsc -w",
-    "lint": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "npm run build"
-  },
   "dependencies": {
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.25.1"
@@ -69,5 +61,12 @@
     "@pollyjs/adapter-node-http": "^6.0.6",
     "@pollyjs/core": "^6.0.6",
     "@pollyjs/persister-fs": "^6.0.6"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -w",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}

package/dist/aliases.json

@@ -1,132 +0,0 @@
-{
-    "chatgpt-4o": {
-        "openai": "chatgpt-4o-latest",
-        "openrouter": "openai/chatgpt-4o-latest"
-    },
-    "claude-3-5-haiku": {
-        "anthropic": "claude-3-5-haiku-20241022",
-        "openrouter": "anthropic/claude-3.5-haiku",
-        "bedrock": "anthropic.claude-3-5-haiku-20241022-v1:0"
-    },
-    "claude-3-5-sonnet": {
-        "anthropic": "claude-3-5-sonnet-20240620",
-        "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",
-        "bedrock": "us.anthropic.claude-3-7-sonnet-20250219-v1:0"
-    },
-    "claude-3-haiku": {
-        "anthropic": "claude-3-haiku-20240307",
-        "openrouter": "anthropic/claude-3-haiku",
-        "bedrock": "anthropic.claude-3-haiku-20240307-v1:0:200k"
-    },
-    "claude-3-opus": {
-        "anthropic": "claude-3-opus-20240229",
-        "openrouter": "anthropic/claude-3-opus",
-        "bedrock": "anthropic.claude-3-opus-20240229-v1:0:200k"
-    },
-    "claude-3-sonnet": {
-        "bedrock": "anthropic.claude-3-sonnet-20240229-v1:0"
-    },
-    "deepseek-chat": {
-        "deepseek": "deepseek-chat",
-        "openrouter": "deepseek/deepseek-chat"
-    },
-    "gemini-flash": {
-        "gemini": "gemini-flash-latest",
-        "vertexai": "gemini-flash-latest",
-        "openrouter": "google/gemini-flash-latest"
-    },
-    "gemini-pro": {
-        "gemini": "gemini-1.5-pro-001",
-        "vertexai": "gemini-1.5-pro-001",
-        "openrouter": "google/gemini-1.5-pro-001"
-    },
-    "gemini-1.5-flash": {
-        "gemini": "gemini-1.5-flash-001",
-        "vertexai": "gemini-1.5-flash-001",
-        "openrouter": "google/gemini-1.5-flash-001"
-    },
-    "gemini-1.5-pro": {
-        "gemini": "gemini-1.5-pro-001",
-        "vertexai": "gemini-1.5-pro-001",
-        "openrouter": "google/gemini-1.5-pro-001"
-    },
-    "gemini-2.0-flash": {
-        "gemini": "gemini-2.0-flash",
-        "vertexai": "gemini-2.0-flash"
-    },
-    "gemini-2.0-flash-001": {
-        "gemini": "gemini-2.0-flash-001",
-        "openrouter": "google/gemini-2.0-flash-001",
-        "vertexai": "gemini-2.0-flash-001"
-    },
-    "gpt-3.5-turbo": {
-        "openai": "gpt-3.5-turbo",
-        "openrouter": "openai/gpt-3.5-turbo"
-    },
-    "gpt-4": {
-        "openai": "gpt-4",
-        "openrouter": "openai/gpt-4"
-    },
-    "gpt-4-turbo": {
-        "openai": "gpt-4-turbo",
-        "openrouter": "openai/gpt-4-turbo"
-    },
-    "gpt-4o": {
-        "openai": "gpt-4o",
-        "openrouter": "openai/gpt-4o"
-    },
-    "gpt-4o-mini": {
-        "openai": "gpt-4o-mini",
-        "openrouter": "openai/gpt-4o-mini"
-    },
-    "llama-3-1-405b": {
-        "openrouter": "meta-llama/llama-3.1-405b"
-    },
-    "llama-3-1-405b-instruct": {
-        "openrouter": "meta-llama/llama-3.1-405b-instruct"
-    },
-    "llama-3-1-70b": {
-        "openrouter": "meta-llama/llama-3.1-70b"
-    },
-    "llama-3-1-70b-instruct": {
-        "openrouter": "meta-llama/llama-3.1-70b-instruct"
-    },
-    "llama-3-1-8b": {
-        "openrouter": "meta-llama/llama-3.1-8b"
-    },
-    "llama-3-1-8b-instruct": {
-        "openrouter": "meta-llama/llama-3.1-8b-instruct"
-    },
-    "llama-3-2-1b-instruct": {
-        "openrouter": "meta-llama/llama-3.2-1b-instruct"
-    },
-    "llama-3-2-3b-instruct": {
-        "openrouter": "meta-llama/llama-3.2-3b-instruct"
-    },
-    "llama-3-3-70b-instruct": {
-        "openrouter": "meta-llama/llama-3.3-70b-instruct"
-    },
-    "mistral-large": {
-        "mistral": "mistral-large-latest",
-        "openrouter": "mistralai/mistral-large"
-    },
-    "mistral-medium": {
-        "mistral": "mistral-medium-latest",
-        "openrouter": "mistralai/mistral-medium"
-    },
-    "mistral-small": {
-        "mistral": "mistral-small-latest",
-        "openrouter": "mistralai/mistral-small"
-    }
-}

package/dist/utils/sanitize.d.ts

@@ -1,21 +0,0 @@
-/**
- * Utility functions for sanitizing sensitive data from error messages and objects
- */
-/**
- * Sanitizes API keys and other sensitive data from strings
- * @param text - The text to sanitize
- * @returns Sanitized text with sensitive data redacted
- */
-export declare function sanitizeText(text: string): string;
-/**
- * Sanitizes an error object by redacting sensitive data
- * @param error - The error object to sanitize
- * @returns Sanitized error object
- */
-export declare function sanitizeError(error: any): any;
-/**
- * Logs an error with sanitized output
- * @param error - The error to log
- */
-export declare function logSanitizedError(error: any): void;
-//# sourceMappingURL=sanitize.d.ts.map

package/dist/utils/sanitize.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiCjD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CA+B7C;AAiBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAGlD"}

package/dist/utils/sanitize.js

@@ -1,76 +0,0 @@
-/**
- * Utility functions for sanitizing sensitive data from error messages and objects
- */
-/**
- * Sanitizes API keys and other sensitive data from strings
- * @param text - The text to sanitize
- * @returns Sanitized text with sensitive data redacted
- */
-export function sanitizeText(text) {
-    if (!text)
-        return text;
-    // Sanitize API keys (various formats)
-    // OpenAI: sk-...
-    // Anthropic: sk-ant-...
-    // Generic patterns
-    let sanitized = text;
-    // Pattern: sk-ant-api03-... or sk-...
-    sanitized = sanitized.replace(/sk-ant-[a-zA-Z0-9_-]{8,}/g, (match) => `sk-ant-***${match.slice(-4)}`);
-    sanitized = sanitized.replace(/sk-[a-zA-Z0-9_-]{20,}/g, (match) => `sk-***${match.slice(-4)}`);
-    // Pattern: Bearer tokens
-    sanitized = sanitized.replace(/Bearer\s+[a-zA-Z0-9_-]{20,}/gi, (match) => `Bearer ***${match.slice(-4)}`);
-    // Pattern: API keys in error messages like "Incorrect API key provided: 8TAXX2TT***..."
-    sanitized = sanitized.replace(/API key[^:]*:\s*[a-zA-Z0-9]{4,}\**/gi, 'API key: [REDACTED]');
-    return sanitized;
-}
-/**
- * Sanitizes an error object by redacting sensitive data
- * @param error - The error object to sanitize
- * @returns Sanitized error object
- */
-export function sanitizeError(error) {
-    if (!error)
-        return error;
-    // Handle Error instances
-    if (error instanceof Error) {
-        const sanitized = new Error(sanitizeText(error.message));
-        sanitized.name = error.name;
-        sanitized.stack = error.stack ? sanitizeText(error.stack) : undefined;
-        // Copy other properties
-        Object.keys(error).forEach(key => {
-            if (key !== 'message' && key !== 'stack' && key !== 'name') {
-                sanitized[key] = sanitizeErrorValue(error[key]);
-            }
-        });
-        return sanitized;
-    }
-    // Handle plain objects
-    if (typeof error === 'object') {
-        const sanitized = Array.isArray(error) ? [] : {};
-        for (const key in error) {
-            sanitized[key] = sanitizeErrorValue(error[key]);
-        }
-        return sanitized;
-    }
-    return error;
-}
-/**
- * Sanitizes a single value (recursive helper)
- */
-function sanitizeErrorValue(value) {
-    if (typeof value === 'string') {
-        return sanitizeText(value);
-    }
-    if (typeof value === 'object' && value !== null) {
-        return sanitizeError(value);
-    }
-    return value;
-}
-/**
- * Logs an error with sanitized output
- * @param error - The error to log
- */
-export function logSanitizedError(error) {
-    const sanitized = sanitizeError(error);
-    console.error('[NodeLLM Error]', sanitized);
-}