@node-llm/core 1.8.0 → 1.10.0

package/README.md

@@ -104,6 +104,41 @@ const llm = createLLM({
 
 ---
 
+## 🔌 Middleware System
+
+NodeLLM 1.9.0 introduces a powerful lifecycle hook system for audit, security, and observability.
+
+```ts
+import { createLLM, PIIMaskMiddleware, UsageLoggerMiddleware } from "@node-llm/core";
+
+const llm = createLLM({
+  provider: "openai",
+  middlewares: [
+    new PIIMaskMiddleware(), // Redact emails/phone numbers automatically
+    new UsageLoggerMiddleware() // Log structured token usage & costs
+  ]
+});
+
+// All chats created from this instance inherit these middlewares
+const chat = llm.chat("gpt-4o");
+```
+
+### Decisive Tool Safety
+
+Middlewares can control the engine's recovery strategy during tool failures.
+
+```ts
+const safetyMiddleware = {
+  name: "Audit",
+  onToolCallError: async (ctx, tool, error) => {
+    if (tool.function.name === "delete_user") return "STOP"; // Kill the loop
+    return "RETRY"; // Attempt recovery
+  }
+};
+```
+
+---
+
 ## 💾 Ecosystem
 
 Looking for persistence? use **[@node-llm/orm](https://www.npmjs.com/package/@node-llm/orm)**.

package/dist/aliases.d.ts

@@ -213,6 +213,18 @@ declare const _default: {
     readonly "dolphin3.0-r1-mistral-24b": {
         readonly openrouter: "cognitivecomputations/dolphin3.0-r1-mistral-24b";
     };
+    readonly "flux.2-flex": {
+        readonly openrouter: "black-forest-labs/flux.2-flex";
+    };
+    readonly "flux.2-klein-4b": {
+        readonly openrouter: "black-forest-labs/flux.2-klein-4b";
+    };
+    readonly "flux.2-max": {
+        readonly openrouter: "black-forest-labs/flux.2-max";
+    };
+    readonly "flux.2-pro": {
+        readonly openrouter: "black-forest-labs/flux.2-pro";
+    };
     readonly "gemini-1.5-flash": {
         readonly gemini: "gemini-1.5-flash";
     };
@@ -305,24 +317,39 @@ declare const _default: {
     readonly "gemini-live-2.5-flash-preview-native-audio": {
         readonly gemini: "gemini-live-2.5-flash-preview-native-audio";
     };
-    readonly "gemma-2-9b-free": {
-        readonly openrouter: "google/gemma-2-9b-it:free";
+    readonly "gemma-2-9b": {
+        readonly openrouter: "google/gemma-2-9b-it";
     };
-    readonly "gemma-3-12b-it": {
+    readonly "gemma-3-12b": {
         readonly openrouter: "google/gemma-3-12b-it";
     };
-    readonly "gemma-3-27b-it": {
+    readonly "gemma-3-12b-free": {
+        readonly openrouter: "google/gemma-3-12b-it:free";
+    };
+    readonly "gemma-3-27b": {
         readonly openrouter: "google/gemma-3-27b-it";
     };
+    readonly "gemma-3-27b-free": {
+        readonly openrouter: "google/gemma-3-27b-it:free";
+    };
+    readonly "gemma-3-4b": {
+        readonly openrouter: "google/gemma-3-4b-it";
+    };
+    readonly "gemma-3-4b-free": {
+        readonly openrouter: "google/gemma-3-4b-it:free";
+    };
     readonly "gemma-3-4b-it": {
         readonly bedrock: "google.gemma-3-4b-it";
     };
-    readonly "gemma-3n-4b-free": {
-        readonly openrouter: "google/gemma-3n-e4b-it:free";
+    readonly "gemma-3n-2b-free": {
+        readonly openrouter: "google/gemma-3n-e2b-it:free";
     };
-    readonly "gemma-3n-e4b-it": {
+    readonly "gemma-3n-4b": {
         readonly openrouter: "google/gemma-3n-e4b-it";
     };
+    readonly "gemma-3n-4b-free": {
+        readonly openrouter: "google/gemma-3n-e4b-it:free";
+    };
     readonly "glm-4.5": {
         readonly openrouter: "z-ai/glm-4.5";
     };
@@ -343,7 +370,7 @@ declare const _default: {
     };
     readonly "glm-4.7": {
         readonly gemini: "zai-org/glm-4.7-maas";
-        readonly openrouter: "z-ai/glm-4.7";
+        readonly openrouter: "z-ai/glm-4.7-flash";
     };
     readonly "glm-z1-32b-free": {
         readonly openrouter: "thudm/glm-z1-32b:free";
@@ -444,7 +471,7 @@ declare const _default: {
     };
     readonly "gpt-5.2-chat": {
         readonly openai: "gpt-5.2-chat-latest";
-        readonly openrouter: "openai/gpt-5.2-chat-latest";
+        readonly openrouter: "openai/gpt-5.2-chat";
     };
     readonly "gpt-5.2-codex": {
         readonly openai: "gpt-5.2-codex";
@@ -462,11 +489,17 @@ declare const _default: {
     readonly "gpt-oss-120b-exacto": {
         readonly openrouter: "openai/gpt-oss-120b:exacto";
     };
+    readonly "gpt-oss-120b-free": {
+        readonly openrouter: "openai/gpt-oss-120b:free";
+    };
     readonly "gpt-oss-20b": {
         readonly gemini: "openai/gpt-oss-20b-maas";
         readonly openrouter: "openai/gpt-oss-20b";
         readonly bedrock: "openai.gpt-oss-20b-1:0";
     };
+    readonly "gpt-oss-20b-free": {
+        readonly openrouter: "openai/gpt-oss-20b:free";
+    };
     readonly "gpt-oss-safeguard-120b": {
         readonly bedrock: "openai.gpt-oss-safeguard-120b";
     };
@@ -498,6 +531,9 @@ declare const _default: {
     readonly "grok-code-fast-1": {
         readonly openrouter: "x-ai/grok-code-fast-1";
     };
+    readonly "hermes-3-405b-instruct-free": {
+        readonly openrouter: "nousresearch/hermes-3-llama-3.1-405b:free";
+    };
     readonly "hermes-4-405b": {
         readonly openrouter: "nousresearch/hermes-4-405b";
     };
@@ -532,6 +568,15 @@ declare const _default: {
         readonly openrouter: "moonshotai/kimi-k2-thinking";
         readonly bedrock: "moonshot.kimi-k2-thinking";
     };
+    readonly "kimi-k2.5": {
+        readonly openrouter: "moonshotai/kimi-k2.5";
+    };
+    readonly "lfm2.5-1.2b-instruct-free": {
+        readonly openrouter: "liquid/lfm-2.5-1.2b-instruct:free";
+    };
+    readonly "lfm2.5-1.2b-thinking-free": {
+        readonly openrouter: "liquid/lfm-2.5-1.2b-thinking:free";
+    };
     readonly "llama-3-1-70b": {
         readonly bedrock: "meta.llama3-1-70b-instruct-v1:0";
         readonly openrouter: "meta-llama/llama-3.1-70b-instruct";
@@ -566,6 +611,9 @@ declare const _default: {
     readonly "llama-3-8b-instruct": {
         readonly bedrock: "meta.llama3-8b-instruct-v1:0";
     };
+    readonly "llama-3.1-405b-instruct-free": {
+        readonly openrouter: "meta-llama/llama-3.1-405b-instruct:free";
+    };
     readonly "llama-3.1-70b-instruct": {
         readonly bedrock: "meta.llama3-1-70b-instruct-v1:0";
     };
@@ -584,6 +632,9 @@ declare const _default: {
     readonly "llama-3.2-3b-instruct": {
         readonly bedrock: "meta.llama3-2-3b-instruct-v1:0";
     };
+    readonly "llama-3.2-3b-instruct-free": {
+        readonly openrouter: "meta-llama/llama-3.2-3b-instruct:free";
+    };
     readonly "llama-3.2-90b-instruct": {
         readonly bedrock: "meta.llama3-2-90b-instruct-v1:0";
     };
@@ -664,6 +715,18 @@ declare const _default: {
     readonly "mixtral-8x7b-instruct-v0.1": {
         readonly bedrock: "mistral.mixtral-8x7b-instruct-v0:1";
     };
+    readonly "molmo2-8b-free": {
+        readonly openrouter: "allenai/molmo-2-8b:free";
+    };
+    readonly "nemotron-3-nano-30b-a3b-free": {
+        readonly openrouter: "nvidia/nemotron-3-nano-30b-a3b:free";
+    };
+    readonly "nemotron-nano-12b-2-vl-free": {
+        readonly openrouter: "nvidia/nemotron-nano-12b-v2-vl:free";
+    };
+    readonly "nemotron-nano-9b-v2-free": {
+        readonly openrouter: "nvidia/nemotron-nano-9b-v2:free";
+    };
     readonly "nova-2-lite": {
         readonly bedrock: "amazon.nova-2-lite-v1:0";
     };
@@ -728,6 +791,9 @@ declare const _default: {
     readonly "qwen2.5-vl-72b-instruct-free": {
         readonly openrouter: "qwen/qwen2.5-vl-72b-instruct:free";
     };
+    readonly "qwen2.5-vl-7b-instruct-free": {
+        readonly openrouter: "qwen/qwen-2.5-vl-7b-instruct:free";
+    };
     readonly "qwen3-14b-free": {
         readonly openrouter: "qwen/qwen3-14b:free";
     };
@@ -761,6 +827,9 @@ declare const _default: {
     readonly "qwen3-32b-free": {
         readonly openrouter: "qwen/qwen3-32b:free";
     };
+    readonly "qwen3-4b-free": {
+        readonly openrouter: "qwen/qwen3-4b:free";
+    };
     readonly "qwen3-8b-free": {
         readonly openrouter: "qwen/qwen3-8b:free";
     };
@@ -789,6 +858,9 @@ declare const _default: {
     readonly "qwen3-next-80b-a3b-instruct": {
         readonly openrouter: "qwen/qwen3-next-80b-a3b-instruct";
     };
+    readonly "qwen3-next-80b-a3b-instruct-free": {
+        readonly openrouter: "qwen/qwen3-next-80b-a3b-instruct:free";
+    };
     readonly "qwen3-next-80b-a3b-thinking": {
         readonly openrouter: "qwen/qwen3-next-80b-a3b-thinking";
     };
@@ -810,12 +882,27 @@ declare const _default: {
     readonly "r1-free": {
         readonly openrouter: "deepseek/deepseek-r1:free";
     };
+    readonly "r1t-chimera-free": {
+        readonly openrouter: "tngtech/tng-r1t-chimera:free";
+    };
     readonly "reka-flash-3": {
         readonly openrouter: "rekaai/reka-flash-3";
     };
+    readonly "riverflow-v2-fast-preview": {
+        readonly openrouter: "sourceful/riverflow-v2-fast-preview";
+    };
+    readonly "riverflow-v2-max-preview": {
+        readonly openrouter: "sourceful/riverflow-v2-max-preview";
+    };
+    readonly "riverflow-v2-standard-preview": {
+        readonly openrouter: "sourceful/riverflow-v2-standard-preview";
+    };
     readonly "sarvam-m-free": {
         readonly openrouter: "sarvamai/sarvam-m:free";
     };
+    readonly "seedream-4.5": {
+        readonly openrouter: "bytedance-seed/seedream-4.5";
+    };
     readonly "sherlock-dash-alpha": {
         readonly openrouter: "openrouter/sherlock-dash-alpha";
     };
@@ -834,6 +921,15 @@ declare const _default: {
     readonly "titan-text-g1---express": {
         readonly bedrock: "amazon.titan-text-express-v1";
     };
+    readonly "trinity-large-preview": {
+        readonly openrouter: "arcee-ai/trinity-large-preview:free";
+    };
+    readonly "trinity-mini": {
+        readonly openrouter: "arcee-ai/trinity-mini:free";
+    };
+    readonly "uncensored-free": {
+        readonly openrouter: "cognitivecomputations/dolphin-mistral-24b-venice-edition:free";
+    };
     readonly "voxtral-mini-3b-2507": {
         readonly bedrock: "mistral.voxtral-mini-3b-2507";
     };

package/dist/aliases.d.ts.map

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

package/dist/aliases.js

@@ -213,6 +213,18 @@ export default {
     "dolphin3.0-r1-mistral-24b": {
         "openrouter": "cognitivecomputations/dolphin3.0-r1-mistral-24b"
     },
+    "flux.2-flex": {
+        "openrouter": "black-forest-labs/flux.2-flex"
+    },
+    "flux.2-klein-4b": {
+        "openrouter": "black-forest-labs/flux.2-klein-4b"
+    },
+    "flux.2-max": {
+        "openrouter": "black-forest-labs/flux.2-max"
+    },
+    "flux.2-pro": {
+        "openrouter": "black-forest-labs/flux.2-pro"
+    },
     "gemini-1.5-flash": {
         "gemini": "gemini-1.5-flash"
     },
@@ -305,24 +317,39 @@ export default {
     "gemini-live-2.5-flash-preview-native-audio": {
         "gemini": "gemini-live-2.5-flash-preview-native-audio"
     },
-    "gemma-2-9b-free": {
-        "openrouter": "google/gemma-2-9b-it:free"
+    "gemma-2-9b": {
+        "openrouter": "google/gemma-2-9b-it"
     },
-    "gemma-3-12b-it": {
+    "gemma-3-12b": {
         "openrouter": "google/gemma-3-12b-it"
     },
-    "gemma-3-27b-it": {
+    "gemma-3-12b-free": {
+        "openrouter": "google/gemma-3-12b-it:free"
+    },
+    "gemma-3-27b": {
         "openrouter": "google/gemma-3-27b-it"
     },
+    "gemma-3-27b-free": {
+        "openrouter": "google/gemma-3-27b-it:free"
+    },
+    "gemma-3-4b": {
+        "openrouter": "google/gemma-3-4b-it"
+    },
+    "gemma-3-4b-free": {
+        "openrouter": "google/gemma-3-4b-it:free"
+    },
     "gemma-3-4b-it": {
         "bedrock": "google.gemma-3-4b-it"
     },
-    "gemma-3n-4b-free": {
-        "openrouter": "google/gemma-3n-e4b-it:free"
+    "gemma-3n-2b-free": {
+        "openrouter": "google/gemma-3n-e2b-it:free"
     },
-    "gemma-3n-e4b-it": {
+    "gemma-3n-4b": {
         "openrouter": "google/gemma-3n-e4b-it"
     },
+    "gemma-3n-4b-free": {
+        "openrouter": "google/gemma-3n-e4b-it:free"
+    },
     "glm-4.5": {
         "openrouter": "z-ai/glm-4.5"
     },
@@ -343,7 +370,7 @@ export default {
     },
     "glm-4.7": {
         "gemini": "zai-org/glm-4.7-maas",
-        "openrouter": "z-ai/glm-4.7"
+        "openrouter": "z-ai/glm-4.7-flash"
     },
     "glm-z1-32b-free": {
         "openrouter": "thudm/glm-z1-32b:free"
@@ -444,7 +471,7 @@ export default {
     },
     "gpt-5.2-chat": {
         "openai": "gpt-5.2-chat-latest",
-        "openrouter": "openai/gpt-5.2-chat-latest"
+        "openrouter": "openai/gpt-5.2-chat"
     },
     "gpt-5.2-codex": {
         "openai": "gpt-5.2-codex",
@@ -462,11 +489,17 @@ export default {
     "gpt-oss-120b-exacto": {
         "openrouter": "openai/gpt-oss-120b:exacto"
     },
+    "gpt-oss-120b-free": {
+        "openrouter": "openai/gpt-oss-120b:free"
+    },
     "gpt-oss-20b": {
         "gemini": "openai/gpt-oss-20b-maas",
         "openrouter": "openai/gpt-oss-20b",
         "bedrock": "openai.gpt-oss-20b-1:0"
     },
+    "gpt-oss-20b-free": {
+        "openrouter": "openai/gpt-oss-20b:free"
+    },
     "gpt-oss-safeguard-120b": {
         "bedrock": "openai.gpt-oss-safeguard-120b"
     },
@@ -498,6 +531,9 @@ export default {
     "grok-code-fast-1": {
         "openrouter": "x-ai/grok-code-fast-1"
     },
+    "hermes-3-405b-instruct-free": {
+        "openrouter": "nousresearch/hermes-3-llama-3.1-405b:free"
+    },
     "hermes-4-405b": {
         "openrouter": "nousresearch/hermes-4-405b"
     },
@@ -532,6 +568,15 @@ export default {
         "openrouter": "moonshotai/kimi-k2-thinking",
         "bedrock": "moonshot.kimi-k2-thinking"
     },
+    "kimi-k2.5": {
+        "openrouter": "moonshotai/kimi-k2.5"
+    },
+    "lfm2.5-1.2b-instruct-free": {
+        "openrouter": "liquid/lfm-2.5-1.2b-instruct:free"
+    },
+    "lfm2.5-1.2b-thinking-free": {
+        "openrouter": "liquid/lfm-2.5-1.2b-thinking:free"
+    },
     "llama-3-1-70b": {
         "bedrock": "meta.llama3-1-70b-instruct-v1:0",
         "openrouter": "meta-llama/llama-3.1-70b-instruct"
@@ -566,6 +611,9 @@ export default {
     "llama-3-8b-instruct": {
         "bedrock": "meta.llama3-8b-instruct-v1:0"
     },
+    "llama-3.1-405b-instruct-free": {
+        "openrouter": "meta-llama/llama-3.1-405b-instruct:free"
+    },
     "llama-3.1-70b-instruct": {
         "bedrock": "meta.llama3-1-70b-instruct-v1:0"
     },
@@ -584,6 +632,9 @@ export default {
     "llama-3.2-3b-instruct": {
         "bedrock": "meta.llama3-2-3b-instruct-v1:0"
     },
+    "llama-3.2-3b-instruct-free": {
+        "openrouter": "meta-llama/llama-3.2-3b-instruct:free"
+    },
     "llama-3.2-90b-instruct": {
         "bedrock": "meta.llama3-2-90b-instruct-v1:0"
     },
@@ -664,6 +715,18 @@ export default {
     "mixtral-8x7b-instruct-v0.1": {
         "bedrock": "mistral.mixtral-8x7b-instruct-v0:1"
     },
+    "molmo2-8b-free": {
+        "openrouter": "allenai/molmo-2-8b:free"
+    },
+    "nemotron-3-nano-30b-a3b-free": {
+        "openrouter": "nvidia/nemotron-3-nano-30b-a3b:free"
+    },
+    "nemotron-nano-12b-2-vl-free": {
+        "openrouter": "nvidia/nemotron-nano-12b-v2-vl:free"
+    },
+    "nemotron-nano-9b-v2-free": {
+        "openrouter": "nvidia/nemotron-nano-9b-v2:free"
+    },
     "nova-2-lite": {
         "bedrock": "amazon.nova-2-lite-v1:0"
     },
@@ -728,6 +791,9 @@ export default {
     "qwen2.5-vl-72b-instruct-free": {
         "openrouter": "qwen/qwen2.5-vl-72b-instruct:free"
     },
+    "qwen2.5-vl-7b-instruct-free": {
+        "openrouter": "qwen/qwen-2.5-vl-7b-instruct:free"
+    },
     "qwen3-14b-free": {
         "openrouter": "qwen/qwen3-14b:free"
     },
@@ -761,6 +827,9 @@ export default {
     "qwen3-32b-free": {
         "openrouter": "qwen/qwen3-32b:free"
     },
+    "qwen3-4b-free": {
+        "openrouter": "qwen/qwen3-4b:free"
+    },
     "qwen3-8b-free": {
         "openrouter": "qwen/qwen3-8b:free"
     },
@@ -789,6 +858,9 @@ export default {
     "qwen3-next-80b-a3b-instruct": {
         "openrouter": "qwen/qwen3-next-80b-a3b-instruct"
     },
+    "qwen3-next-80b-a3b-instruct-free": {
+        "openrouter": "qwen/qwen3-next-80b-a3b-instruct:free"
+    },
     "qwen3-next-80b-a3b-thinking": {
         "openrouter": "qwen/qwen3-next-80b-a3b-thinking"
     },
@@ -810,12 +882,27 @@ export default {
     "r1-free": {
         "openrouter": "deepseek/deepseek-r1:free"
     },
+    "r1t-chimera-free": {
+        "openrouter": "tngtech/tng-r1t-chimera:free"
+    },
     "reka-flash-3": {
         "openrouter": "rekaai/reka-flash-3"
     },
+    "riverflow-v2-fast-preview": {
+        "openrouter": "sourceful/riverflow-v2-fast-preview"
+    },
+    "riverflow-v2-max-preview": {
+        "openrouter": "sourceful/riverflow-v2-max-preview"
+    },
+    "riverflow-v2-standard-preview": {
+        "openrouter": "sourceful/riverflow-v2-standard-preview"
+    },
     "sarvam-m-free": {
         "openrouter": "sarvamai/sarvam-m:free"
     },
+    "seedream-4.5": {
+        "openrouter": "bytedance-seed/seedream-4.5"
+    },
     "sherlock-dash-alpha": {
         "openrouter": "openrouter/sherlock-dash-alpha"
     },
@@ -834,6 +921,15 @@ export default {
     "titan-text-g1---express": {
         "bedrock": "amazon.titan-text-express-v1"
     },
+    "trinity-large-preview": {
+        "openrouter": "arcee-ai/trinity-large-preview:free"
+    },
+    "trinity-mini": {
+        "openrouter": "arcee-ai/trinity-mini:free"
+    },
+    "uncensored-free": {
+        "openrouter": "cognitivecomputations/dolphin-mistral-24b-venice-edition:free"
+    },
     "voxtral-mini-3b-2507": {
         "bedrock": "mistral.voxtral-mini-3b-2507"
     },

package/dist/chat/Chat.d.ts

@@ -19,13 +19,14 @@ export interface AskOptions {
     signal?: AbortSignal;
 }
 import { ChatResponseString } from "./ChatResponse.js";
-export declare class Chat {
+export declare class Chat<S = unknown> {
     private readonly provider;
     private model;
     private readonly options;
     private messages;
     private systemMessages;
     private executor;
+    private middlewares;
     constructor(provider: Provider, model: string, options?: ChatOptions, retryConfig?: {
         attempts: number;
         delayMs: number;
@@ -79,7 +80,11 @@ export declare class Chat {
      * Add a message manually to the chat history.
      * Useful for rehydrating sessions from a database.
      */
-    add(role: "user" | "assistant" | "system" | "developer", content: string | MessageContent): this;
+    add(role: "user" | "assistant" | "system" | "developer" | "tool", content: string | MessageContent): this;
+    /**
+     * Add a raw Message object to the chat history.
+     */
+    addMessage(message: Message): this;
     /**
      * Set the temperature for the chat session.
      * Controls randomness: 0.0 (deterministic) to 1.0 (creative).
@@ -106,7 +111,7 @@ export declare class Chat {
      * Enforce a specific schema for the output.
      * Can accept a Schema object or a Zod schema/JSON Schema directly.
      */
-    withSchema(schema: Schema | z.ZodType<unknown> | Record<string, unknown> | null): this;
+    withSchema<T>(schema: Schema | z.ZodType<T> | Record<string, unknown> | null): Chat<T>;
     /**
      * Enable and configure extended thinking for reasoning models.
      */

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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"}