@jaypie/llm 1.3.8 → 1.3.10

package/dist/cjs/index.d.cts

@@ -2,22 +2,52 @@ import * as _jaypie_types from '@jaypie/types';
 import { JsonObject, AnyValue, NaturalMap, NaturalSchema, JsonReturn } from '@jaypie/types';
 import { z } from 'zod/v4';
 
+/**
+ * Provider-neutral reasoning-effort levels — a five-point relative scale that
+ * deliberately borrows no provider's vocabulary. Each adapter translates these
+ * to its provider's native control (OpenAI `reasoning.effort`, Anthropic
+ * `output_config.effort`, Gemini `thinkingLevel`/`thinkingBudget`, Grok
+ * `reasoning_effort`, OpenRouter `reasoning.effort`), spreading the scale across
+ * the provider's available range. Omitting `effort` leaves the provider default
+ * untouched, so it is safe to set across a fallback chain.
+ */
+declare const EFFORT: {
+    readonly LOWEST: "lowest";
+    readonly LOW: "low";
+    readonly MEDIUM: "medium";
+    readonly HIGH: "high";
+    readonly HIGHEST: "highest";
+};
+type LlmEffort = (typeof EFFORT)[keyof typeof EFFORT];
 declare const MODEL: {
+    FABLE: string;
     OPUS: string;
     SONNET: string;
     HAIKU: string;
-    FABLE: string;
     MYTHOS: string;
     GEMINI_FLASH: string;
     GEMINI_FLASH_LITE: string;
     GEMINI_PRO: string;
+    SOL: string;
+    TERRA: string;
+    LUNA: string;
+    /** @deprecated use MODEL.SOL (gpt-5.6-sol) */
     GPT: string;
+    /** @deprecated use MODEL.TERRA (gpt-5.6-terra) */
     GPT_MINI: string;
+    /** @deprecated use MODEL.LUNA (gpt-5.6-luna) */
     GPT_NANO: string;
     GROK: string;
+    OPENROUTER: {
+        GLM: string;
+        LUNA: string;
+        SONNET: string;
+    };
 };
 declare const PROVIDER: {
     readonly BEDROCK: {
+        readonly DEFAULT: "amazon.nova-pro-v1:0";
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.BEDROCK.DEFAULT. */
         readonly MODEL: {
             readonly DEFAULT: "amazon.nova-lite-v1:0";
             readonly LARGE: "amazon.nova-pro-v1:0";
@@ -29,16 +59,18 @@ declare const PROVIDER: {
         readonly REGION: "AWS_REGION";
     };
     readonly ANTHROPIC: {
+        readonly DEFAULT: string;
         readonly MAX_TOKENS: {
             readonly DEFAULT: 16384;
         };
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.ANTHROPIC.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "claude-sonnet-4-6";
             readonly LARGE: "claude-opus-4-8";
             readonly SMALL: "claude-sonnet-4-6";
             readonly TINY: "claude-haiku-4-5";
         };
-        readonly MODEL_MATCH_WORDS: readonly ["anthropic", "claude", "haiku", "opus", "sonnet"];
+        readonly MODEL_MATCH_WORDS: readonly ["anthropic", "claude", "fable", "haiku", "mythos", "opus", "sonnet"];
         readonly NAME: "anthropic";
         readonly PROMPT: {
             readonly AI: "\n\nAssistant:";
@@ -55,6 +87,8 @@ declare const PROVIDER: {
     };
     /** @deprecated Use PROVIDER.GOOGLE — "Google" is the provider; Gemini is the model family */
     readonly GEMINI: {
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.GOOGLE.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "gemini-3.1-pro-preview";
             readonly LARGE: "gemini-3.1-pro-preview";
@@ -69,6 +103,8 @@ declare const PROVIDER: {
         };
     };
     readonly GOOGLE: {
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.GOOGLE.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "gemini-3.1-pro-preview";
             readonly LARGE: "gemini-3.1-pro-preview";
@@ -83,16 +119,20 @@ declare const PROVIDER: {
         };
     };
     readonly OPENAI: {
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.OPENAI.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "gpt-5.4";
             readonly LARGE: "gpt-5.5";
             readonly SMALL: "gpt-5.4-mini";
             readonly TINY: "gpt-5.4-nano";
         };
-        readonly MODEL_MATCH_WORDS: readonly ["openai", "gpt", RegExp];
+        readonly MODEL_MATCH_WORDS: readonly ["gpt", "luna", "openai", "sol", "terra", RegExp];
         readonly NAME: "openai";
     };
     readonly OPENROUTER: {
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.OPENROUTER.DEFAULT, or pick a specific route from MODEL.OPENROUTER.*. */
         readonly MODEL: {
             readonly DEFAULT: "anthropic/claude-sonnet-4-6";
             readonly LARGE: "anthropic/claude-opus-4-8";
@@ -111,9 +151,11 @@ declare const PROVIDER: {
     readonly XAI: {
         readonly API_KEY: "XAI_API_KEY";
         readonly BASE_URL: "https://api.x.ai/v1";
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.XAI.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "grok-latest";
-            readonly LARGE: "grok-4.3-latest";
+            readonly LARGE: "grok-latest";
             readonly SMALL: "grok-4-1-fast-reasoning";
             readonly TINY: "grok-4-1-fast-non-reasoning";
         };
@@ -123,6 +165,7 @@ declare const PROVIDER: {
 };
 type LlmProviderName = typeof PROVIDER.ANTHROPIC.NAME | typeof PROVIDER.BEDROCK.NAME | typeof PROVIDER.GOOGLE.NAME | typeof PROVIDER.OPENAI.NAME | typeof PROVIDER.OPENROUTER.NAME | typeof PROVIDER.XAI.NAME;
 declare const DEFAULT: {
+    /** @deprecated Size tiers are retired in 2.0. Use DEFAULT.PROVIDER.DEFAULT, or pick a specific model from MODEL.*. */
     readonly MODEL: {
         readonly BASE: "gpt-5.4";
         readonly LARGE: "gpt-5.5";
@@ -130,32 +173,40 @@ declare const DEFAULT: {
         readonly TINY: "gpt-5.4-nano";
     };
     readonly PROVIDER: {
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.OPENAI.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "gpt-5.4";
             readonly LARGE: "gpt-5.5";
             readonly SMALL: "gpt-5.4-mini";
             readonly TINY: "gpt-5.4-nano";
         };
-        readonly MODEL_MATCH_WORDS: readonly ["openai", "gpt", RegExp];
+        readonly MODEL_MATCH_WORDS: readonly ["gpt", "luna", "openai", "sol", "terra", RegExp];
         readonly NAME: "openai";
     };
 };
+/**
+ * @deprecated Size-tier catalogs are retired in 2.0. Pick specific models from
+ * MODEL.* (grouped by provider via MODEL_MATCH_WORDS / determineModelProvider).
+ */
 declare const ALL: {
     readonly BASE: readonly ["claude-sonnet-4-6", "gemini-3.1-pro-preview", "gpt-5.4", "grok-latest"];
-    readonly COMBINED: readonly ("claude-opus-4-8" | "claude-sonnet-4-6" | "claude-haiku-4-5" | "gemini-3.5-flash" | "gemini-3.1-flash-lite" | "gemini-3.1-pro-preview" | "gpt-5.5" | "gpt-5.4-mini" | "gpt-5.4-nano" | "grok-latest" | "gpt-5.4" | "grok-4.3-latest" | "grok-4-1-fast-reasoning" | "grok-4-1-fast-non-reasoning")[];
-    readonly LARGE: readonly ["claude-opus-4-8", "gemini-3.1-pro-preview", "gpt-5.5", "grok-4.3-latest"];
+    readonly COMBINED: readonly ("claude-opus-4-8" | "claude-haiku-4-5" | "gemini-3.5-flash" | "gemini-3.1-flash-lite" | "gemini-3.1-pro-preview" | "gpt-5.5" | "gpt-5.4-mini" | "gpt-5.4-nano" | "grok-latest" | "claude-sonnet-4-6" | "gpt-5.4" | "grok-4-1-fast-reasoning" | "grok-4-1-fast-non-reasoning")[];
+    readonly LARGE: readonly ["claude-opus-4-8", "gemini-3.1-pro-preview", "gpt-5.5", "grok-latest"];
     readonly SMALL: readonly ["claude-sonnet-4-6", "gemini-3.5-flash", "gpt-5.4-mini", "grok-4-1-fast-reasoning"];
     readonly TINY: readonly ["claude-haiku-4-5", "gemini-3.1-flash-lite", "gpt-5.4-nano", "grok-4-1-fast-non-reasoning"];
 };
 
 declare const constants_ALL: typeof ALL;
 declare const constants_DEFAULT: typeof DEFAULT;
+declare const constants_EFFORT: typeof EFFORT;
+type constants_LlmEffort = LlmEffort;
 type constants_LlmProviderName = LlmProviderName;
 declare const constants_MODEL: typeof MODEL;
 declare const constants_PROVIDER: typeof PROVIDER;
 declare namespace constants {
-  export { constants_ALL as ALL, constants_DEFAULT as DEFAULT, constants_MODEL as MODEL, constants_PROVIDER as PROVIDER };
-  export type { constants_LlmProviderName as LlmProviderName };
+  export { constants_ALL as ALL, constants_DEFAULT as DEFAULT, constants_EFFORT as EFFORT, constants_MODEL as MODEL, constants_PROVIDER as PROVIDER };
+  export type { constants_LlmEffort as LlmEffort, constants_LlmProviderName as LlmProviderName };
 }
 
 interface LlmTool {
@@ -461,6 +512,14 @@ interface LlmProgressEvent {
 type LlmProgressCallback = (event: LlmProgressEvent) => unknown | Promise<unknown>;
 interface LlmOperateOptions {
     data?: NaturalMap;
+    /**
+     * Provider-neutral reasoning effort (lowest | low | medium | high | highest).
+     * Each provider translates it to its native control, spreading the scale
+     * across the provider's range; omitting it leaves the provider default
+     * untouched, so it is safe across a fallback chain. Providers without
+     * reasoning control ignore it.
+     */
+    effort?: LlmEffort;
     explain?: boolean;
     /** Chain of fallback providers to try if primary fails. Set to false to disable instance-level fallback. */
     fallback?: LlmFallbackConfig[] | false;
@@ -740,4 +799,4 @@ declare class XaiProvider implements LlmProvider {
 }
 
 export { BedrockProvider, GoogleProvider as GeminiProvider, GoogleProvider, JaypieToolkit, constants as LLM, Llm, LlmMessageRole, LlmMessageType, LlmProgressEventType, LlmStreamChunkType, OpenRouterProvider, Toolkit, XaiProvider, extractReasoning, isLlmOperateInput, isLlmOperateInputContent, isLlmOperateInputFile, isLlmOperateInputImage, jsonSchemaToNaturalSchema, naturalSchemaToJsonSchema, toolkit, tools };
-export type { LlmFallbackConfig, LlmHistory, LlmInputContent, LlmInputContentFile, LlmInputContentImage, LlmInputContentText, LlmInputMessage, LlmMessageOptions, LlmOperateInput, LlmOperateInputContent, LlmOperateInputFile, LlmOperateInputImage, LlmOperateOptions, LlmOperateResponse, LlmOptions, LlmProgressCallback, LlmProgressEvent, LlmProgressToolCall, LlmProvider, LlmStreamChunk, LlmStreamChunkDone, LlmStreamChunkError, LlmStreamChunkText, LlmStreamChunkToolCall, LlmStreamChunkToolResult, LlmTool };
+export type { LlmEffort, LlmFallbackConfig, LlmHistory, LlmInputContent, LlmInputContentFile, LlmInputContentImage, LlmInputContentText, LlmInputMessage, LlmMessageOptions, LlmOperateInput, LlmOperateInputContent, LlmOperateInputFile, LlmOperateInputImage, LlmOperateOptions, LlmOperateResponse, LlmOptions, LlmProgressCallback, LlmProgressEvent, LlmProgressToolCall, LlmProvider, LlmStreamChunk, LlmStreamChunkDone, LlmStreamChunkError, LlmStreamChunkText, LlmStreamChunkToolCall, LlmStreamChunkToolResult, LlmTool };

package/dist/{esm/src → cjs}/index.d.ts

@@ -1,5 +1,6 @@
 export { default as Llm } from "./Llm.js";
 export * as LLM from "./constants.js";
+export type { LlmEffort } from "./constants.js";
 export type { LlmFallbackConfig, LlmHistory, LlmInputContent, LlmInputContentFile, LlmInputContentImage, LlmInputContentText, LlmInputMessage, LlmMessageOptions, LlmOperateInput, LlmOperateInputContent, LlmOperateInputFile, LlmOperateInputImage, LlmOperateOptions, LlmOperateResponse, LlmOptions, LlmProgressCallback, LlmProgressEvent, LlmProgressToolCall, LlmProvider, } from "./types/LlmProvider.interface.js";
 export { LlmMessageRole, LlmMessageType, LlmProgressEventType, } from "./types/LlmProvider.interface.js";
 export { isLlmOperateInput, isLlmOperateInputContent, isLlmOperateInputFile, isLlmOperateInputImage, } from "./types/LlmOperateInput.guards.js";

package/dist/cjs/{src/operate → operate}/adapters/AnthropicAdapter.d.ts

@@ -16,7 +16,8 @@ import { BaseProviderAdapter } from "./ProviderAdapter.interface.js";
  */
 type AnthropicRequestParams = Anthropic.MessageCreateParams & {
     output_config?: {
-        format: {
+        effort?: string;
+        format?: {
             type: "json_schema";
             schema: JsonObject;
         };
@@ -29,7 +30,7 @@ type AnthropicRequestParams = Anthropic.MessageCreateParams & {
  */
 export declare class AnthropicAdapter extends BaseProviderAdapter {
     readonly name: "anthropic";
-    readonly defaultModel: "claude-sonnet-4-6";
+    readonly defaultModel: string;
     private runtimeNoTemperatureModels;
     private runtimeNoStructuredOutputModels;
     rememberModelRejectsTemperature(model: string): void;

package/dist/{esm/src → cjs}/operate/adapters/BedrockAdapter.d.ts

@@ -49,7 +49,7 @@ type AnnotatedBedrockResponse = ConverseCommandOutput & {
 };
 export declare class BedrockAdapter extends BaseProviderAdapter {
     readonly name: "bedrock";
-    readonly defaultModel: "amazon.nova-lite-v1:0";
+    readonly defaultModel: "amazon.nova-pro-v1:0";
     private _modelsFallbackToStructuredOutputTool;
     private _modelsWithoutTemperature;
     private rememberModelRejectsOutputConfig;

package/dist/cjs/{src/operate → operate}/adapters/GoogleAdapter.d.ts

@@ -13,7 +13,7 @@ import { GeminiPart, GeminiRawResponse, GeminiRequest } from "../../providers/go
  */
 export declare class GoogleAdapter extends BaseProviderAdapter {
     readonly name: "google";
-    readonly defaultModel: "gemini-3.1-pro-preview";
+    readonly defaultModel: string;
     private runtimeNoStructuredOutputComboModels;
     rememberModelRejectsStructuredOutputCombo(model: string): void;
     clearRuntimeNoStructuredOutputComboModels(): void;

package/dist/{esm/src → cjs}/operate/adapters/OpenAiAdapter.d.ts

@@ -1,5 +1,7 @@
 import { JsonObject, NaturalSchema } from "@jaypie/types";
 import { z } from "zod/v4";
+import { type LlmEffort } from "../../constants.js";
+import { type LlmEffortMapping } from "../../util/effort.js";
 import { Toolkit } from "../../tools/Toolkit.class.js";
 import { LlmHistory, LlmOperateOptions, LlmToolResult, LlmUsageItem } from "../../types/LlmProvider.interface.js";
 import { LlmStreamChunk } from "../../types/LlmStreamChunk.interface.js";
@@ -12,11 +14,15 @@ import { BaseProviderAdapter } from "./ProviderAdapter.interface.js";
  */
 export declare class OpenAiAdapter extends BaseProviderAdapter {
     readonly name: "openai";
-    readonly defaultModel: "gpt-5.4";
+    readonly defaultModel: string;
     private runtimeNoTemperatureModels;
     rememberModelRejectsTemperature(model: string): void;
     clearRuntimeNoTemperatureModels(): void;
     private supportsTemperature;
+    /** Whether `reasoning.effort` may be sent for this model. Overridden by xAI. */
+    protected supportsReasoningEffort(model: string): boolean;
+    /** Translate a normalized effort to this provider's `reasoning.effort` value. */
+    protected mapReasoningEffort(effort: LlmEffort, model: string): LlmEffortMapping;
     buildRequest(request: OperateRequest): unknown;
     formatTools(toolkit: Toolkit, _outputSchema?: JsonObject): ProviderToolDefinition[];
     formatOutputSchema(schema: JsonObject | NaturalSchema | z.ZodType): JsonObject;

package/dist/{esm/src → cjs}/operate/adapters/OpenRouterAdapter.d.ts

@@ -79,6 +79,10 @@ interface OpenRouterRequest {
     tools?: OpenRouterTool[];
     tool_choice?: "auto" | "none" | "required";
     response_format?: OpenRouterResponseFormat;
+    reasoning?: {
+        effort?: string;
+        max_tokens?: number;
+    };
     user?: string;
 }
 /**
@@ -111,7 +115,7 @@ type OpenRouterContentPart = {
  */
 export declare class OpenRouterAdapter extends BaseProviderAdapter {
     readonly name: "openrouter";
-    readonly defaultModel: "anthropic/claude-sonnet-4-6";
+    readonly defaultModel: string;
     private runtimeNoStructuredOutputModels;
     rememberModelRejectsStructuredOutput(model: string): void;
     clearRuntimeNoStructuredOutputModels(): void;

package/dist/cjs/operate/adapters/XaiAdapter.d.ts

@@ -0,0 +1,24 @@
+import { type LlmEffort } from "../../constants.js";
+import { type LlmEffortMapping } from "../../util/effort.js";
+import { ClassifiedError } from "../types.js";
+import { OpenAiAdapter } from "./OpenAiAdapter.js";
+/**
+ * XaiAdapter extends OpenAiAdapter since xAI (Grok) uses an OpenAI-compatible API.
+ * Name, default model, and transient-ingest-error detection are overridden;
+ * all request building, response parsing, tool handling, and streaming are
+ * inherited.
+ */
+export declare class XaiAdapter extends OpenAiAdapter {
+    readonly name: "xai";
+    readonly defaultModel: string;
+    /**
+     * Grok gates reasoning effort by model, not by the OpenAI `gpt-*`/`o*`
+     * patterns. Only explicit `*-reasoning` models accept `reasoning_effort`;
+     * bare grok-4 reasons implicitly and rejects it, so we stay conservative and
+     * only opt in models whose name advertises reasoning.
+     */
+    protected supportsReasoningEffort(model: string): boolean;
+    protected mapReasoningEffort(effort: LlmEffort): LlmEffortMapping;
+    classifyError(error: unknown): ClassifiedError;
+}
+export declare const xaiAdapter: XaiAdapter;

package/dist/cjs/{src/operate → operate}/types.d.ts

@@ -1,4 +1,5 @@
 import { JsonObject } from "@jaypie/types";
+import { type LlmEffort } from "../constants.js";
 import { LlmHistory, LlmMessageType, LlmOperateOptions, LlmUsageItem } from "../types/LlmProvider.interface.js";
 import { Toolkit } from "../tools/Toolkit.class.js";
 /**
@@ -68,6 +69,8 @@ export interface OperateRequest {
     tools?: ProviderToolDefinition[];
     /** Structured output format */
     format?: JsonObject;
+    /** Normalized reasoning effort; adapters translate to provider-native control */
+    effort?: LlmEffort;
     /** Provider-specific options */
     providerOptions?: JsonObject;
     /** Whether the request will execute over a streaming transport */
@@ -133,6 +136,8 @@ export interface OperateLoopState {
     maxTurns: number;
     /** Response builder instance */
     responseBuilder: ResponseBuilder;
+    /** Names of tool calls executed across all turns (report tally) */
+    toolCallNames: string[];
     /** The toolkit for tool calls */
     toolkit?: Toolkit;
 }

package/dist/cjs/{src/providers → providers}/google/types.d.ts

@@ -73,6 +73,11 @@ export interface GeminiGenerateContentConfig {
     responseMimeType?: string;
     responseJsonSchema?: JsonObject;
     responseSchema?: JsonObject;
+    thinkingConfig?: {
+        thinkingLevel?: string;
+        thinkingBudget?: number;
+        includeThoughts?: boolean;
+    };
     temperature?: number;
     topP?: number;
     topK?: number;

package/dist/{esm/src → cjs}/types/LlmProvider.interface.d.ts

@@ -1,5 +1,6 @@
 import { AnyValue, JsonObject, JsonReturn, NaturalMap, NaturalSchema } from "@jaypie/types";
 import { z } from "zod/v4";
+import { type LlmEffort } from "../constants.js";
 import { LlmTool } from "./LlmTool.interface.js";
 import { LlmStreamChunk } from "./LlmStreamChunk.interface.js";
 import { Toolkit } from "../tools/Toolkit.class.js";
@@ -213,6 +214,14 @@ export interface LlmProgressEvent {
 export type LlmProgressCallback = (event: LlmProgressEvent) => unknown | Promise<unknown>;
 export interface LlmOperateOptions {
     data?: NaturalMap;
+    /**
+     * Provider-neutral reasoning effort (lowest | low | medium | high | highest).
+     * Each provider translates it to its native control, spreading the scale
+     * across the provider's range; omitting it leaves the provider default
+     * untouched, so it is safe across a fallback chain. Providers without
+     * reasoning control ignore it.
+     */
+    effort?: LlmEffort;
     explain?: boolean;
     /** Chain of fallback providers to try if primary fails. Set to false to disable instance-level fallback. */
     fallback?: LlmFallbackConfig[] | false;

package/dist/cjs/util/effort.d.ts

@@ -0,0 +1,42 @@
+import { type LlmEffort } from "../constants.js";
+/**
+ * Result of translating the provider-neutral {@link LlmEffort} scale to a
+ * provider's native reasoning control.
+ */
+export interface LlmEffortMapping<T extends string | number = string> {
+    /**
+     * True when the requested neutral level had no distinct native rung and was
+     * collapsed or clamped onto a neighbor (e.g. `highest` -> Grok `high`, or
+     * `highest` -> OpenAI `high` on a model predating `xhigh`). Adapters log
+     * these at debug so a papered-over request stays on the record.
+     */
+    papered: boolean;
+    /** Native effort value for the target provider. */
+    value: T;
+}
+/**
+ * Per-provider translation of the provider-neutral {@link LlmEffort} scale.
+ *
+ * The neutral enum (lowest → low → medium → high → highest) is a relative
+ * five-point scale. Each table below maps it onto the target provider's native
+ * effort control, keeping `medium`/`high` semantically aligned across providers
+ * and using each provider's extra bottom (`minimal`) or top (`xhigh`/`max`)
+ * rung where one exists. Providers with fewer levels collapse the ends and mark
+ * the result `papered`. A single `effort` value is therefore safe to reuse
+ * across providers and fallback chains.
+ */
+/** Consistent debug message for a papered-over effort level. */
+export declare function paperedEffortMessage({ model, provider, requested, value, }: {
+    model: string;
+    provider: string;
+    requested: LlmEffort;
+    value: string | number;
+}): string;
+export declare function toOpenAiEffort(effort: LlmEffort, { model }: {
+    model: string;
+}): LlmEffortMapping;
+export declare function toXaiEffort(effort: LlmEffort): LlmEffortMapping;
+export declare function toAnthropicEffort(effort: LlmEffort): LlmEffortMapping;
+export declare function toGeminiThinkingLevel(effort: LlmEffort): LlmEffortMapping;
+export declare function toGeminiThinkingBudget(effort: LlmEffort): LlmEffortMapping<number>;
+export declare function toOpenRouterEffort(effort: LlmEffort): LlmEffortMapping;

package/dist/cjs/{src/util → util}/index.d.ts

@@ -12,4 +12,5 @@ export * from "./naturalZodSchema.js";
 export * from "./random.js";
 export * from "./repairFormatKeys.js";
 export * from "./sse.js";
+export * from "./tallyOperate.js";
 export * from "./tryParseNumber.js";

package/dist/cjs/util/tallyOperate.d.ts

@@ -0,0 +1,14 @@
+import { LlmUsageItem } from "../types/LlmProvider.interface.js";
+interface TallyOperateOptions {
+    toolCallNames?: string[];
+    turns: number;
+    usage?: LlmUsageItem[];
+}
+/**
+ * Tally loop totals onto the root logger's report session so handlers
+ * (express, lambda) include llm activity in the report emitted at teardown.
+ * Silently no-ops outside an active session or when the logger predates
+ * tally support.
+ */
+export declare function tallyOperate({ toolCallNames, turns, usage, }: TallyOperateOptions): void;
+export {};

package/dist/esm/{src/constants.d.ts → constants.d.ts}

@@ -1,19 +1,49 @@
+/**
+ * Provider-neutral reasoning-effort levels — a five-point relative scale that
+ * deliberately borrows no provider's vocabulary. Each adapter translates these
+ * to its provider's native control (OpenAI `reasoning.effort`, Anthropic
+ * `output_config.effort`, Gemini `thinkingLevel`/`thinkingBudget`, Grok
+ * `reasoning_effort`, OpenRouter `reasoning.effort`), spreading the scale across
+ * the provider's available range. Omitting `effort` leaves the provider default
+ * untouched, so it is safe to set across a fallback chain.
+ */
+export declare const EFFORT: {
+    readonly LOWEST: "lowest";
+    readonly LOW: "low";
+    readonly MEDIUM: "medium";
+    readonly HIGH: "high";
+    readonly HIGHEST: "highest";
+};
+export type LlmEffort = (typeof EFFORT)[keyof typeof EFFORT];
 export declare const MODEL: {
+    FABLE: string;
     OPUS: string;
     SONNET: string;
     HAIKU: string;
-    FABLE: string;
     MYTHOS: string;
     GEMINI_FLASH: string;
     GEMINI_FLASH_LITE: string;
     GEMINI_PRO: string;
+    SOL: string;
+    TERRA: string;
+    LUNA: string;
+    /** @deprecated use MODEL.SOL (gpt-5.6-sol) */
     GPT: string;
+    /** @deprecated use MODEL.TERRA (gpt-5.6-terra) */
     GPT_MINI: string;
+    /** @deprecated use MODEL.LUNA (gpt-5.6-luna) */
     GPT_NANO: string;
     GROK: string;
+    OPENROUTER: {
+        GLM: string;
+        LUNA: string;
+        SONNET: string;
+    };
 };
 export declare const PROVIDER: {
     readonly BEDROCK: {
+        readonly DEFAULT: "amazon.nova-pro-v1:0";
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.BEDROCK.DEFAULT. */
         readonly MODEL: {
             readonly DEFAULT: "amazon.nova-lite-v1:0";
             readonly LARGE: "amazon.nova-pro-v1:0";
@@ -25,16 +55,18 @@ export declare const PROVIDER: {
         readonly REGION: "AWS_REGION";
     };
     readonly ANTHROPIC: {
+        readonly DEFAULT: string;
         readonly MAX_TOKENS: {
             readonly DEFAULT: 16384;
         };
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.ANTHROPIC.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "claude-sonnet-4-6";
             readonly LARGE: "claude-opus-4-8";
             readonly SMALL: "claude-sonnet-4-6";
             readonly TINY: "claude-haiku-4-5";
         };
-        readonly MODEL_MATCH_WORDS: readonly ["anthropic", "claude", "haiku", "opus", "sonnet"];
+        readonly MODEL_MATCH_WORDS: readonly ["anthropic", "claude", "fable", "haiku", "mythos", "opus", "sonnet"];
         readonly NAME: "anthropic";
         readonly PROMPT: {
             readonly AI: "\n\nAssistant:";
@@ -51,6 +83,8 @@ export declare const PROVIDER: {
     };
     /** @deprecated Use PROVIDER.GOOGLE — "Google" is the provider; Gemini is the model family */
     readonly GEMINI: {
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.GOOGLE.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "gemini-3.1-pro-preview";
             readonly LARGE: "gemini-3.1-pro-preview";
@@ -65,6 +99,8 @@ export declare const PROVIDER: {
         };
     };
     readonly GOOGLE: {
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.GOOGLE.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "gemini-3.1-pro-preview";
             readonly LARGE: "gemini-3.1-pro-preview";
@@ -79,16 +115,20 @@ export declare const PROVIDER: {
         };
     };
     readonly OPENAI: {
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.OPENAI.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "gpt-5.4";
             readonly LARGE: "gpt-5.5";
             readonly SMALL: "gpt-5.4-mini";
             readonly TINY: "gpt-5.4-nano";
         };
-        readonly MODEL_MATCH_WORDS: readonly ["openai", "gpt", RegExp];
+        readonly MODEL_MATCH_WORDS: readonly ["gpt", "luna", "openai", "sol", "terra", RegExp];
         readonly NAME: "openai";
     };
     readonly OPENROUTER: {
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.OPENROUTER.DEFAULT, or pick a specific route from MODEL.OPENROUTER.*. */
         readonly MODEL: {
             readonly DEFAULT: "anthropic/claude-sonnet-4-6";
             readonly LARGE: "anthropic/claude-opus-4-8";
@@ -107,9 +147,11 @@ export declare const PROVIDER: {
     readonly XAI: {
         readonly API_KEY: "XAI_API_KEY";
         readonly BASE_URL: "https://api.x.ai/v1";
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.XAI.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "grok-latest";
-            readonly LARGE: "grok-4.3-latest";
+            readonly LARGE: "grok-latest";
             readonly SMALL: "grok-4-1-fast-reasoning";
             readonly TINY: "grok-4-1-fast-non-reasoning";
         };
@@ -119,6 +161,7 @@ export declare const PROVIDER: {
 };
 export type LlmProviderName = typeof PROVIDER.ANTHROPIC.NAME | typeof PROVIDER.BEDROCK.NAME | typeof PROVIDER.GOOGLE.NAME | typeof PROVIDER.OPENAI.NAME | typeof PROVIDER.OPENROUTER.NAME | typeof PROVIDER.XAI.NAME;
 export declare const DEFAULT: {
+    /** @deprecated Size tiers are retired in 2.0. Use DEFAULT.PROVIDER.DEFAULT, or pick a specific model from MODEL.*. */
     readonly MODEL: {
         readonly BASE: "gpt-5.4";
         readonly LARGE: "gpt-5.5";
@@ -126,20 +169,26 @@ export declare const DEFAULT: {
         readonly TINY: "gpt-5.4-nano";
     };
     readonly PROVIDER: {
+        readonly DEFAULT: string;
+        /** @deprecated Size tiers are retired in 2.0. Use PROVIDER.OPENAI.DEFAULT, or pick a specific model from MODEL.*. */
         readonly MODEL: {
             readonly DEFAULT: "gpt-5.4";
             readonly LARGE: "gpt-5.5";
             readonly SMALL: "gpt-5.4-mini";
             readonly TINY: "gpt-5.4-nano";
         };
-        readonly MODEL_MATCH_WORDS: readonly ["openai", "gpt", RegExp];
+        readonly MODEL_MATCH_WORDS: readonly ["gpt", "luna", "openai", "sol", "terra", RegExp];
         readonly NAME: "openai";
     };
 };
+/**
+ * @deprecated Size-tier catalogs are retired in 2.0. Pick specific models from
+ * MODEL.* (grouped by provider via MODEL_MATCH_WORDS / determineModelProvider).
+ */
 export declare const ALL: {
     readonly BASE: readonly ["claude-sonnet-4-6", "gemini-3.1-pro-preview", "gpt-5.4", "grok-latest"];
-    readonly COMBINED: readonly ("claude-sonnet-4-6" | "claude-opus-4-8" | "claude-haiku-4-5" | "gemini-3.1-pro-preview" | "gemini-3.5-flash" | "gemini-3.1-flash-lite" | "gpt-5.4" | "gpt-5.5" | "gpt-5.4-mini" | "gpt-5.4-nano" | "grok-latest" | "grok-4.3-latest" | "grok-4-1-fast-reasoning" | "grok-4-1-fast-non-reasoning")[];
-    readonly LARGE: readonly ["claude-opus-4-8", "gemini-3.1-pro-preview", "gpt-5.5", "grok-4.3-latest"];
+    readonly COMBINED: readonly ("claude-opus-4-8" | "claude-haiku-4-5" | "gemini-3.5-flash" | "gemini-3.1-flash-lite" | "gemini-3.1-pro-preview" | "gpt-5.5" | "gpt-5.4-mini" | "gpt-5.4-nano" | "grok-latest" | "claude-sonnet-4-6" | "gpt-5.4" | "grok-4-1-fast-reasoning" | "grok-4-1-fast-non-reasoning")[];
+    readonly LARGE: readonly ["claude-opus-4-8", "gemini-3.1-pro-preview", "gpt-5.5", "grok-latest"];
     readonly SMALL: readonly ["claude-sonnet-4-6", "gemini-3.5-flash", "gpt-5.4-mini", "grok-4-1-fast-reasoning"];
     readonly TINY: readonly ["claude-haiku-4-5", "gemini-3.1-flash-lite", "gpt-5.4-nano", "grok-4-1-fast-non-reasoning"];
 };