@node-llm/core 1.17.1 → 1.19.0

package/dist/config.js

@@ -1,4 +1,4 @@
-import { DEFAULT_MAX_TOOL_CALLS, DEFAULT_MAX_RETRIES, DEFAULT_REQUEST_TIMEOUT, DEFAULT_MAX_TOKENS, DEFAULT_TOOL_EXECUTION, DEFAULT_TOOL_CONCURRENCY, DEFAULT_OPENAI_BASE_URL, DEFAULT_ANTHROPIC_BASE_URL, DEFAULT_GEMINI_BASE_URL, DEFAULT_DEEPSEEK_BASE_URL, DEFAULT_OPENROUTER_BASE_URL, DEFAULT_OLLAMA_BASE_URL, DEFAULT_XAI_BASE_URL, DEFAULT_MISTRAL_BASE_URL, DEFAULT_BEDROCK_REGION } from "./constants.js";
+import { DEFAULT_MAX_TOOL_CALLS, DEFAULT_MAX_RETRIES, DEFAULT_REQUEST_TIMEOUT, DEFAULT_MAX_TOKENS, DEFAULT_TOOL_EXECUTION, DEFAULT_TOOL_CONCURRENCY, DEFAULT_OPENAI_BASE_URL, DEFAULT_ANTHROPIC_BASE_URL, DEFAULT_GEMINI_BASE_URL, DEFAULT_DEEPSEEK_BASE_URL, DEFAULT_OPENROUTER_BASE_URL, DEFAULT_OLLAMA_BASE_URL, DEFAULT_XAI_BASE_URL, DEFAULT_MISTRAL_BASE_URL, DEFAULT_TYPESAFE_BASE_URL, DEFAULT_BEDROCK_REGION } from "./constants.js";
 export class Configuration {
     _openaiApiKey;
     _openaiApiBase;
@@ -15,6 +15,12 @@ export class Configuration {
     _xaiApiBase;
     _mistralApiKey;
     _mistralApiBase;
+    _azureApiKey;
+    _azureApiBase;
+    _azureAuthToken;
+    _azureDeployments;
+    _typesafeApiKey;
+    _typesafeApiBase;
     _bedrockApiKey;
     _bedrockAccessKeyId;
     _bedrockSecretAccessKey;
@@ -25,147 +31,194 @@ export class Configuration {
     _bedrockGuardrailVersion;
     _debug;
     _provider;
+    _envFallback;
     get openaiApiKey() {
-        return this._openaiApiKey ?? process.env.OPENAI_API_KEY?.trim();
+        return this._openaiApiKey ?? this.fromEnv("OPENAI_API_KEY");
     }
     set openaiApiKey(v) {
         this._openaiApiKey = v;
     }
     get openaiApiBase() {
-        return this._openaiApiBase ?? process.env.OPENAI_API_BASE?.trim() ?? DEFAULT_OPENAI_BASE_URL;
+        return this._openaiApiBase ?? this.fromEnv("OPENAI_API_BASE") ?? DEFAULT_OPENAI_BASE_URL;
     }
     set openaiApiBase(v) {
         this._openaiApiBase = v;
     }
     get anthropicApiKey() {
-        return this._anthropicApiKey ?? process.env.ANTHROPIC_API_KEY?.trim();
+        return this._anthropicApiKey ?? this.fromEnv("ANTHROPIC_API_KEY");
     }
     set anthropicApiKey(v) {
         this._anthropicApiKey = v;
     }
     get anthropicApiBase() {
-        return (this._anthropicApiBase ?? process.env.ANTHROPIC_API_BASE?.trim() ?? DEFAULT_ANTHROPIC_BASE_URL);
+        return (this._anthropicApiBase ?? this.fromEnv("ANTHROPIC_API_BASE") ?? DEFAULT_ANTHROPIC_BASE_URL);
     }
     set anthropicApiBase(v) {
         this._anthropicApiBase = v;
     }
     get geminiApiKey() {
-        return this._geminiApiKey ?? process.env.GEMINI_API_KEY?.trim();
+        return this._geminiApiKey ?? this.fromEnv("GEMINI_API_KEY");
     }
     set geminiApiKey(v) {
         this._geminiApiKey = v;
     }
     get geminiApiBase() {
-        return this._geminiApiBase ?? process.env.GEMINI_API_BASE?.trim() ?? DEFAULT_GEMINI_BASE_URL;
+        return this._geminiApiBase ?? this.fromEnv("GEMINI_API_BASE") ?? DEFAULT_GEMINI_BASE_URL;
     }
     set geminiApiBase(v) {
         this._geminiApiBase = v;
     }
     get deepseekApiKey() {
-        return this._deepseekApiKey ?? process.env.DEEPSEEK_API_KEY?.trim();
+        return this._deepseekApiKey ?? this.fromEnv("DEEPSEEK_API_KEY");
     }
     set deepseekApiKey(v) {
         this._deepseekApiKey = v;
     }
     get deepseekApiBase() {
-        return (this._deepseekApiBase ?? process.env.DEEPSEEK_API_BASE?.trim() ?? DEFAULT_DEEPSEEK_BASE_URL);
+        return this._deepseekApiBase ?? this.fromEnv("DEEPSEEK_API_BASE") ?? DEFAULT_DEEPSEEK_BASE_URL;
     }
     set deepseekApiBase(v) {
         this._deepseekApiBase = v;
     }
     get ollamaApiBase() {
-        return this._ollamaApiBase ?? process.env.OLLAMA_API_BASE?.trim() ?? DEFAULT_OLLAMA_BASE_URL;
+        return this._ollamaApiBase ?? this.fromEnv("OLLAMA_API_BASE") ?? DEFAULT_OLLAMA_BASE_URL;
     }
     set ollamaApiBase(v) {
         this._ollamaApiBase = v;
     }
     get openrouterApiKey() {
-        return this._openrouterApiKey ?? process.env.OPENROUTER_API_KEY?.trim();
+        return this._openrouterApiKey ?? this.fromEnv("OPENROUTER_API_KEY");
     }
     set openrouterApiKey(v) {
         this._openrouterApiKey = v;
     }
     get openrouterApiBase() {
-        return (this._openrouterApiBase ??
-            process.env.OPENROUTER_API_BASE?.trim() ??
-            DEFAULT_OPENROUTER_BASE_URL);
+        return (this._openrouterApiBase ?? this.fromEnv("OPENROUTER_API_BASE") ?? DEFAULT_OPENROUTER_BASE_URL);
     }
     set openrouterApiBase(v) {
         this._openrouterApiBase = v;
     }
     get xaiApiKey() {
-        return this._xaiApiKey ?? process.env.XAI_API_KEY?.trim();
+        return this._xaiApiKey ?? this.fromEnv("XAI_API_KEY");
     }
     set xaiApiKey(v) {
         this._xaiApiKey = v;
     }
     get xaiApiBase() {
-        return this._xaiApiBase ?? process.env.XAI_API_BASE?.trim() ?? DEFAULT_XAI_BASE_URL;
+        return this._xaiApiBase ?? this.fromEnv("XAI_API_BASE") ?? DEFAULT_XAI_BASE_URL;
     }
     set xaiApiBase(v) {
         this._xaiApiBase = v;
     }
     get mistralApiKey() {
-        return this._mistralApiKey ?? process.env.MISTRAL_API_KEY?.trim();
+        return this._mistralApiKey ?? this.fromEnv("MISTRAL_API_KEY");
     }
     set mistralApiKey(v) {
         this._mistralApiKey = v;
     }
     get mistralApiBase() {
-        return this._mistralApiBase ?? process.env.MISTRAL_API_BASE?.trim() ?? DEFAULT_MISTRAL_BASE_URL;
+        return this._mistralApiBase ?? this.fromEnv("MISTRAL_API_BASE") ?? DEFAULT_MISTRAL_BASE_URL;
     }
     set mistralApiBase(v) {
         this._mistralApiBase = v;
     }
+    get azureApiKey() {
+        return this._azureApiKey ?? this.fromEnv("AZURE_API_KEY");
+    }
+    set azureApiKey(v) {
+        this._azureApiKey = v;
+    }
+    // No default: every Azure resource has its own address.
+    get azureApiBase() {
+        return this._azureApiBase ?? this.fromEnv("AZURE_API_BASE");
+    }
+    set azureApiBase(v) {
+        this._azureApiBase = v;
+    }
+    get azureAuthToken() {
+        return this._azureAuthToken ?? this.fromEnv("AZURE_AUTH_TOKEN");
+    }
+    set azureAuthToken(v) {
+        this._azureAuthToken = v;
+    }
+    get azureDeployments() {
+        return this._azureDeployments;
+    }
+    set azureDeployments(v) {
+        this._azureDeployments = v;
+    }
+    get typesafeApiKey() {
+        // TYPESAFE_API_KEY matches the provider's name; JEV_API_KEY is accepted too.
+        return this._typesafeApiKey ?? this.fromEnv("TYPESAFE_API_KEY") ?? this.fromEnv("JEV_API_KEY");
+    }
+    set typesafeApiKey(v) {
+        this._typesafeApiKey = v;
+    }
+    get typesafeApiBase() {
+        return this._typesafeApiBase ?? this.fromEnv("TYPESAFE_API_BASE") ?? DEFAULT_TYPESAFE_BASE_URL;
+    }
+    set typesafeApiBase(v) {
+        this._typesafeApiBase = v;
+    }
     // AWS Bedrock configuration
     get bedrockApiKey() {
-        return this._bedrockApiKey ?? process.env.AWS_BEARER_TOKEN_BEDROCK?.trim();
+        return this._bedrockApiKey ?? this.fromEnv("AWS_BEARER_TOKEN_BEDROCK");
     }
     set bedrockApiKey(v) {
         this._bedrockApiKey = v;
     }
     get bedrockAccessKeyId() {
-        return this._bedrockAccessKeyId ?? process.env.AWS_ACCESS_KEY_ID?.trim();
+        return this._bedrockAccessKeyId ?? this.fromEnv("AWS_ACCESS_KEY_ID");
     }
     set bedrockAccessKeyId(v) {
         this._bedrockAccessKeyId = v;
     }
     get bedrockSecretAccessKey() {
-        return this._bedrockSecretAccessKey ?? process.env.AWS_SECRET_ACCESS_KEY?.trim();
+        return this._bedrockSecretAccessKey ?? this.fromEnv("AWS_SECRET_ACCESS_KEY");
     }
     set bedrockSecretAccessKey(v) {
         this._bedrockSecretAccessKey = v;
     }
     get bedrockSessionToken() {
-        return this._bedrockSessionToken ?? process.env.AWS_SESSION_TOKEN?.trim();
+        return this._bedrockSessionToken ?? this.fromEnv("AWS_SESSION_TOKEN");
     }
     set bedrockSessionToken(v) {
         this._bedrockSessionToken = v;
     }
     get bedrockRegion() {
-        return this._bedrockRegion ?? process.env.AWS_REGION?.trim() ?? DEFAULT_BEDROCK_REGION;
+        return this._bedrockRegion ?? this.fromEnv("AWS_REGION") ?? DEFAULT_BEDROCK_REGION;
     }
     set bedrockRegion(v) {
         this._bedrockRegion = v;
     }
     get bedrockApiBase() {
-        return this._bedrockApiBase ?? process.env.BEDROCK_API_BASE?.trim();
+        return this._bedrockApiBase ?? this.fromEnv("BEDROCK_API_BASE");
     }
     set bedrockApiBase(v) {
         this._bedrockApiBase = v;
     }
     get bedrockGuardrailIdentifier() {
-        return this._bedrockGuardrailIdentifier ?? process.env.AWS_GUARDRAIL_ID?.trim();
+        return this._bedrockGuardrailIdentifier ?? this.fromEnv("AWS_GUARDRAIL_ID");
     }
     set bedrockGuardrailIdentifier(v) {
         this._bedrockGuardrailIdentifier = v;
     }
     get bedrockGuardrailVersion() {
-        return this._bedrockGuardrailVersion ?? process.env.AWS_GUARDRAIL_VERSION?.trim();
+        return this._bedrockGuardrailVersion ?? this.fromEnv("AWS_GUARDRAIL_VERSION");
     }
     set bedrockGuardrailVersion(v) {
         this._bedrockGuardrailVersion = v;
     }
+    get envFallback() {
+        return this._envFallback;
+    }
+    set envFallback(v) {
+        this._envFallback = v;
+    }
+    /** An environment variable, unless envFallback is false. */
+    fromEnv(name) {
+        return this._envFallback === false ? undefined : process.env[name]?.trim();
+    }
     get debug() {
         return this._debug ?? process.env.NODELLM_DEBUG === "true";
     }
@@ -173,7 +226,7 @@ export class Configuration {
         this._debug = v;
     }
     get provider() {
-        return this._provider ?? process.env.NODELLM_PROVIDER?.trim();
+        return this._provider ?? this.fromEnv("NODELLM_PROVIDER");
     }
     set provider(v) {
         this._provider = v;

package/dist/constants.d.ts

@@ -6,6 +6,11 @@ export declare enum ToolExecutionMode {
 export declare const DEFAULT_MAX_TOOL_CALLS = 5;
 export declare const DEFAULT_MAX_CORRECTIONS = 5;
 export declare const DEFAULT_MAX_RETRIES = 2;
+/**
+ * A tool execution mode as callers may pass it: the enum member or its string
+ * value, so `withToolExecution("confirm")` compiles as the docs write it.
+ */
+export type ToolExecutionModeInput = ToolExecutionMode | `${ToolExecutionMode}`;
 export declare const DEFAULT_TOOL_EXECUTION = ToolExecutionMode.AUTO;
 export declare const DEFAULT_TOOL_CONCURRENCY = false;
 export declare const DEFAULT_REQUEST_TIMEOUT = 30000;
@@ -18,11 +23,13 @@ export declare const DEFAULT_OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1
 export declare const DEFAULT_OLLAMA_BASE_URL = "http://localhost:11434/v1";
 export declare const DEFAULT_XAI_BASE_URL = "https://api.x.ai/v1";
 export declare const DEFAULT_MISTRAL_BASE_URL = "https://api.mistral.ai/v1";
+export declare const DEFAULT_TYPESAFE_BASE_URL = "https://api.typesafe.ai";
 export declare const DEFAULT_MODELS: {
     readonly TRANSCRIPTION: "whisper-1";
     readonly MODERATION: "omni-moderation-latest";
     readonly EMBEDDING: "text-embedding-3-small";
     readonly IMAGE: "dall-e-3";
+    readonly JUDGMENT: "jev-latest";
 };
 export declare const DEFAULT_BEDROCK_REGION = "us-east-1";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAGxC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAC7D,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAC9C,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AACnE,eAAO,MAAM,0BAA0B,iCAAiC,CAAC;AACzE,eAAO,MAAM,uBAAuB,qDAAqD,CAAC;AAC1F,eAAO,MAAM,yBAAyB,6BAA6B,CAAC;AACpE,eAAO,MAAM,2BAA2B,iCAAiC,CAAC;AAC1E,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AACnE,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAC1D,eAAO,MAAM,wBAAwB,8BAA8B,CAAC;AAEpE,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,eAAO,MAAM,sBAAsB,cAAc,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAGxC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG,GAAG,iBAAiB,EAAE,CAAC;AAEhF,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAC7D,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAC9C,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AACnE,eAAO,MAAM,0BAA0B,iCAAiC,CAAC;AACzE,eAAO,MAAM,uBAAuB,qDAAqD,CAAC;AAC1F,eAAO,MAAM,yBAAyB,6BAA6B,CAAC;AACpE,eAAO,MAAM,2BAA2B,iCAAiC,CAAC;AAC1E,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AACnE,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAC1D,eAAO,MAAM,wBAAwB,8BAA8B,CAAC;AAEpE,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AAEnE,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,eAAO,MAAM,sBAAsB,cAAc,CAAC"}

package/dist/constants.js

@@ -21,10 +21,12 @@ export const DEFAULT_OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
 export const DEFAULT_OLLAMA_BASE_URL = "http://localhost:11434/v1";
 export const DEFAULT_XAI_BASE_URL = "https://api.x.ai/v1";
 export const DEFAULT_MISTRAL_BASE_URL = "https://api.mistral.ai/v1";
+export const DEFAULT_TYPESAFE_BASE_URL = "https://api.typesafe.ai";
 export const DEFAULT_MODELS = {
     TRANSCRIPTION: "whisper-1",
     MODERATION: "omni-moderation-latest",
     EMBEDDING: "text-embedding-3-small",
-    IMAGE: "dall-e-3"
+    IMAGE: "dall-e-3",
+    JUDGMENT: "jev-latest"
 };
 export const DEFAULT_BEDROCK_REGION = "us-east-1";

package/dist/errors/billing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Whether a provider's error means the account can't pay for the request, whatever status it
+ * arrived with: providers report this as 402, 400, 403 or 429. Every provider's error handler
+ * asks this first, so the same problem is an InsufficientQuotaError everywhere.
+ */
+export declare function isBillingProblem(status: number, message: string, code?: string): boolean;
+//# sourceMappingURL=billing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/errors/billing.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAKxF"}

package/dist/errors/billing.js

@@ -0,0 +1,24 @@
+// Phrases providers use when an account is out of credit or its billing isn't set up. A plain
+// "quota" isn't one of them: providers also use it for per-minute rate limits, which pass on their
+// own and are worth retrying.
+const BILLING_PHRASES = [
+    "credit balance",
+    "insufficient balance",
+    "insufficient credit",
+    "insufficient funds",
+    "out of credits",
+    "exceeded your current quota",
+    "billing",
+    "payment required"
+];
+/**
+ * Whether a provider's error means the account can't pay for the request, whatever status it
+ * arrived with: providers report this as 402, 400, 403 or 429. Every provider's error handler
+ * asks this first, so the same problem is an InsufficientQuotaError everywhere.
+ */
+export function isBillingProblem(status, message, code) {
+    if (status === 402 || code === "insufficient_quota")
+        return true;
+    const text = message.toLowerCase();
+    return BILLING_PHRASES.some((phrase) => text.includes(phrase));
+}

package/dist/errors/index.d.ts

@@ -12,6 +12,7 @@
  *
  * @see ARCHITECTURE.md for error contract details
  */
+import type { Usage } from "../providers/Provider.js";
 /**
  * Base class for all NodeLLM errors
  */
@@ -146,4 +147,31 @@ export declare class ToolError extends LLMError {
     readonly fatal: boolean;
     constructor(message: string, toolName?: string | undefined, fatal?: boolean);
 }
+/**
+ * Thrown when the model still wants to call tools after `maxToolCalls` rounds of tool calls.
+ * Its pending calls are answered with an error result, so the chat can be asked again.
+ */
+/**
+ * An ask spent its `maxCost` before finishing its tool loop. The tool calls it stopped before
+ * running are answered in the history, so the chat can be asked again.
+ */
+export declare class CostLimitError extends LLMError {
+    /** The limit, in US dollars */
+    readonly limit: number;
+    /** Usage of every request in the ask that reached the limit */
+    readonly usage: Usage;
+    constructor(
+    /** The limit, in US dollars */
+    limit: number, 
+    /** Usage of every request in the ask that reached the limit */
+    usage: Usage);
+}
+export declare class ToolCallLimitError extends LLMError {
+    readonly limit: number;
+    /** Usage of every request in the ask that reached the limit */
+    readonly usage: Usage;
+    constructor(limit: number, 
+    /** Usage of every request in the ask that reached the limit */
+    usage: Usage);
+}
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/errors/index.js

@@ -213,3 +213,35 @@ export class ToolError extends LLMError {
         this.name = "ToolError";
     }
 }
+/**
+ * Thrown when the model still wants to call tools after `maxToolCalls` rounds of tool calls.
+ * Its pending calls are answered with an error result, so the chat can be asked again.
+ */
+/**
+ * An ask spent its `maxCost` before finishing its tool loop. The tool calls it stopped before
+ * running are answered in the history, so the chat can be asked again.
+ */
+export class CostLimitError extends LLMError {
+    limit;
+    usage;
+    constructor(
+    /** The limit, in US dollars */
+    limit, 
+    /** Usage of every request in the ask that reached the limit */
+    usage) {
+        super(`[NodeLLM] Cost limit ($${limit}) reached.`, "COST_LIMIT");
+        this.limit = limit;
+        this.usage = usage;
+    }
+}
+export class ToolCallLimitError extends LLMError {
+    limit;
+    usage;
+    constructor(limit, 
+    /** Usage of every request in the ask that reached the limit */
+    usage) {
+        super(`[NodeLLM] Maximum tool execution calls (${limit}) exceeded.`, "TOOL_CALL_LIMIT");
+        this.limit = limit;
+        this.usage = usage;
+    }
+}

package/dist/executor/Executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Executor.d.ts","sourceRoot":"","sources":["../../src/executor/Executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG/E,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAGzD,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA8B9D;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAYrB"}
+{"version":3,"file":"Executor.d.ts","sourceRoot":"","sources":["../../src/executor/Executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG/E,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAGzD,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAiC9D;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAYrB"}

package/dist/executor/Executor.js

@@ -1,4 +1,4 @@
-import { RateLimitError, ServerError } from "../errors/index.js";
+import { InsufficientQuotaError, RateLimitError, ServerError } from "../errors/index.js";
 export class Executor {
     provider;
     retry;
@@ -17,8 +17,10 @@ export class Executor {
             }
             catch (error) {
                 lastError = error;
-                // If it's a fatal error (BadRequest, Authentication), don't retry
-                const isRetryable = error instanceof RateLimitError || error instanceof ServerError;
+                // Fatal errors (bad request, authentication, an account out of credit) fail straight away:
+                // trying again can't help.
+                const isRetryable = (error instanceof RateLimitError && !(error instanceof InsufficientQuotaError)) ||
+                    error instanceof ServerError;
                 if (!isRetryable || attempt >= this.retry.attempts) {
                     throw error;
                 }

package/dist/index.d.ts

@@ -8,19 +8,28 @@ export * from "./chat/ChatStream.js";
 export * from "./streaming/Stream.js";
 export * from "./errors/index.js";
 export { Agent, defineAgent } from "./agent/Agent.js";
-export type { AgentConfig } from "./agent/Agent.js";
+export { Judge, defineJudge } from "./judge/Judge.js";
+export type { JudgeCallOptions, QuestionsOf } from "./judge/Judge.js";
+export { probability, choice, score } from "./judge/Question.js";
+export type { Description, JsonValue, ProbabilityCriteria, ProbabilityQuestion, ChoiceQuestion, ScoreQuestion, QuestionDefinition, QuestionMap } from "./judge/Question.js";
+export { Judgment, ProbabilityAnswer, ChoiceAnswer, ScoreAnswer } from "./judge/Judgment.js";
+export type { Answer, AnswerFor, AnswersOf, JudgmentResult } from "./judge/Judgment.js";
+export type { AgentConfig, DefinedAgent } from "./agent/Agent.js";
 export type { Middleware, MiddlewareContext } from "./types/Middleware.js";
 export * from "./middlewares/index.js";
-export { z } from "zod";
+export { z } from "zod/v3";
 export { NodeLLM, LegacyNodeLLM, createLLM, NodeLLMCore, Transcription, Moderation, Embedding, ModelRegistry, PricingRegistry } from "./llm.js";
+export type { LLMConfig } from "./llm.js";
 export { config } from "./config.js";
 export type { NodeLLMConfig } from "./config.js";
 export { providerRegistry, ProviderInterceptor } from "./providers/registry.js";
 export { Schema } from "./schema/Schema.js";
+export type { ZodSchema } from "./schema/zod.js";
 export { BaseProvider } from "./providers/BaseProvider.js";
-export { Provider, ProviderCapabilities, ChatRequest, ChatResponse, ChatChunk, ThinkingConfig, ThinkingResult, Usage, ImageRequest, ImageResponse, TranscriptionRequest, TranscriptionResponse, TranscriptionSegment, TranscriptionWord, ModerationRequest, ModerationResponse, ModerationResult, EmbeddingRequest, EmbeddingResponse, ToolChoice } from "./providers/Provider.js";
+export { Provider, ProviderCapabilities, ChatRequest, ChatResponse, ChatChunk, ThinkingConfig, ThinkingEffort, ThinkingResult, Usage, ImageRequest, ImageResponse, TranscriptionRequest, TranscriptionResponse, TranscriptionSegment, TranscriptionWord, ModerationRequest, ModerationResponse, ModerationResult, EmbeddingRequest, EmbeddingResponse, JudgmentRequest, JudgmentResponse, JudgmentInput, JudgmentAnswerData, ToolChoice } from "./providers/Provider.js";
 export { resolveModelAlias } from "./model_aliases.js";
 export { default as MODEL_ALIASES } from "./aliases.js";
+export type { ToolExecutionModeInput } from "./constants.js";
 export { ToolExecutionMode, DEFAULT_MAX_TOOL_CALLS, DEFAULT_MAX_RETRIES, DEFAULT_TOOL_EXECUTION, DEFAULT_OLLAMA_BASE_URL, DEFAULT_MODELS } from "./constants.js";
 export { fetchWithTimeout } from "./utils/fetch.js";
 //# sourceMappingURL=index.d.ts.map

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;AACtC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,cAAc,wBAAwB,CAAC;AAEvC,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,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,cAAc,EACd,cAAc,EACd,KAAK,EACL,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACX,MAAM,yBAAyB,CAAC;AACjC,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;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,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;AACtC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EACV,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,cAAc,wBAAwB,CAAC;AAEvC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EACL,OAAO,EACP,aAAa,EACb,SAAS,EACT,WAAW,EACX,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,eAAe,EAChB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,cAAc,EACd,cAAc,EACd,cAAc,EACd,KAAK,EACL,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -8,8 +8,11 @@ export * from "./chat/ChatStream.js";
 export * from "./streaming/Stream.js";
 export * from "./errors/index.js";
 export { Agent, defineAgent } from "./agent/Agent.js";
+export { Judge, defineJudge } from "./judge/Judge.js";
+export { probability, choice, score } from "./judge/Question.js";
+export { Judgment, ProbabilityAnswer, ChoiceAnswer, ScoreAnswer } from "./judge/Judgment.js";
 export * from "./middlewares/index.js";
-export { z } from "zod";
+export { z } from "zod/v3";
 export { NodeLLM, LegacyNodeLLM, createLLM, NodeLLMCore, Transcription, Moderation, Embedding, ModelRegistry, PricingRegistry } from "./llm.js";
 export { config } from "./config.js";
 export { providerRegistry } from "./providers/registry.js";

package/dist/judge/Judge.d.ts

@@ -0,0 +1,107 @@
+import { NodeLLMCore } from "../llm.js";
+import { JudgmentInput } from "../providers/Provider.js";
+import { LazyValue } from "../agent/Agent.js";
+import { QuestionMap } from "./Question.js";
+import { JudgmentResult } from "./Judgment.js";
+/** The questions a Judge class declares, once resolved. */
+export type QuestionsOf<T> = T extends {
+    questions: infer Q;
+} ? Q extends (...args: never[]) => infer R ? R extends QuestionMap ? R : never : Q extends QuestionMap ? Q : never : never;
+export interface JudgeCallOptions<I = Record<string, unknown>> {
+    /** Values for the inputs the judge declares; available to lazy settings. */
+    inputs?: I;
+    /** Overrides the judge's model for this call. */
+    model?: string;
+    /** Overrides the judge's provider for this call. */
+    provider?: string;
+    /** Merged over the judge's own providerOptions. */
+    providerOptions?: Record<string, unknown>;
+    requestTimeout?: number;
+    /** The NodeLLM instance to judge with. Defaults to the global NodeLLM. */
+    llm?: NodeLLMCore;
+}
+/**
+ * A reusable set of typed questions about your application data.
+ *
+ * Subclass it and declare `questions`; call `judge` with the input. Answers are
+ * typed from the declaration, so a choice's answer is a union of its options.
+ *
+ * @example
+ * class TicketTriage extends Judge {
+ *   static questions = {
+ *     urgent: probability("Does this need attention today?"),
+ *     department: choice("Which team should handle this?", {
+ *       billing: "Payments and refunds",
+ *       technical: "Bugs and integrations",
+ *       other: null
+ *     }),
+ *     frustration: score("How frustrated is the customer?", ["Calm", "Frustrated", "Angry"])
+ *   };
+ * }
+ *
+ * const judgment = await TicketTriage.judge("Please refund the duplicate charge today.");
+ * judgment.urgent.probability;  // number
+ * judgment.department.choice;   // "billing" | "technical" | "other"
+ *
+ * Settings can depend on runtime data. Declare the inputs a judge needs and
+ * pass them to `judge`; `questions`, `model` and `providerOptions` may be
+ * functions of those inputs, resolved once per judgment.
+ *
+ * @example
+ * class TeamRouter extends Judge {
+ *   static inputs = ["teams"] as const;
+ *   static questions = ({ teams }: { teams: Team[] }) => ({
+ *     team: choice("Which team should handle this?",
+ *       Object.fromEntries(teams.map((t) => [t.slug, t.description])))
+ *   });
+ * }
+ * await TeamRouter.judge(ticket.body, { inputs: { teams } });
+ */
+export declare abstract class Judge {
+    /** The judgment model. Defaults to the instance default, then `jev-latest`. */
+    static model?: LazyValue<string, never>;
+    /** Routes to a specific provider; normally inferred from the model. */
+    static provider?: string;
+    /** Names of the inputs `judge` must be given. */
+    static inputs?: readonly string[];
+    /** The questions, or a function of the declared inputs returning them. */
+    static questions: LazyValue<QuestionMap, never>;
+    /** Provider-specific request fields, or a function of the inputs. */
+    static providerOptions?: LazyValue<Record<string, unknown>, never>;
+    /**
+     * Judges the input and returns typed answers. The input is text, an object,
+     * or an array of JSON-compatible values - or a function of the inputs that
+     * returns one.
+     */
+    static judge<T extends typeof Judge, I extends Record<string, unknown> = Record<string, unknown>>(this: T, input: LazyValue<JudgmentInput, I>, options?: JudgeCallOptions<I>): Promise<JudgmentResult<QuestionsOf<T>>>;
+}
+/**
+ * Defines a judge without a class, mirroring `defineAgent`.
+ *
+ * @example
+ * const Urgency = defineJudge({
+ *   questions: { urgent: probability("Does this need attention today?") }
+ * });
+ * (await Urgency.judge("The site is down")).urgent.probability;
+ */
+export declare function defineJudge<const Q extends QuestionMap>(definition: {
+    questions: LazyValue<Q, never>;
+    model?: LazyValue<string, never>;
+    provider?: string;
+    inputs?: readonly string[];
+    providerOptions?: LazyValue<Record<string, unknown>, never>;
+}): {
+    new (): {};
+    questions: LazyValue<Q, never>;
+    model: LazyValue<string, never> | undefined;
+    provider: string | undefined;
+    inputs: readonly string[] | undefined;
+    providerOptions: LazyValue<Record<string, unknown>, never> | undefined;
+    /**
+     * Judges the input and returns typed answers. The input is text, an object,
+     * or an array of JSON-compatible values - or a function of the inputs that
+     * returns one.
+     */
+    judge<T extends typeof Judge, I extends Record<string, unknown> = Record<string, unknown>>(this: T, input: LazyValue<JudgmentInput, I>, options?: JudgeCallOptions<I>): Promise<JudgmentResult<QuestionsOf<T>>>;
+};
+//# sourceMappingURL=Judge.d.ts.map

package/dist/judge/Judge.d.ts.map

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