@jaypie/llm 1.3.0 → 1.3.1

package/dist/cjs/providers/{gemini → google}/utils.d.ts

@@ -1,7 +1,7 @@
 import type { GoogleGenAI } from "@google/genai";
 import { LlmMessageOptions } from "../../types/LlmProvider.interface.js";
 export declare function loadSdk(): Promise<typeof import("@google/genai")>;
-export declare const getLogger: () => any;
+export declare const getLogger: () => import("@jaypie/logger/dist/esm/JaypieLogger.js").default;
 export declare function initializeClient({ apiKey, }?: {
     apiKey?: string;
 }): Promise<GoogleGenAI>;

package/dist/cjs/providers/openai/utils.d.ts

@@ -2,7 +2,7 @@ import { JsonObject, NaturalSchema } from "@jaypie/types";
 import { OpenAI } from "openai";
 import { z } from "zod/v4";
 import { LlmMessageOptions } from "../../types/LlmProvider.interface.js";
-export declare const getLogger: () => any;
+export declare const getLogger: () => import("@jaypie/logger/dist/esm/JaypieLogger.js").default;
 export declare function initializeClient({ apiKey, }?: {
     apiKey?: string;
 }): Promise<OpenAI>;

package/dist/cjs/providers/openrouter/utils.d.ts

@@ -1,7 +1,7 @@
 import type { OpenRouter } from "@openrouter/sdk";
 import { LlmMessageOptions } from "../../types/LlmProvider.interface.js";
 export declare function loadSdk(): Promise<typeof import("@openrouter/sdk")>;
-export declare const getLogger: () => any;
+export declare const getLogger: () => import("@jaypie/logger/dist/esm/JaypieLogger.js").default;
 export declare function initializeClient({ apiKey, }?: {
     apiKey?: string;
 }): Promise<OpenRouter>;

package/dist/{esm/providers/gemini/GeminiProvider.class.d.ts → cjs/providers/xai/XaiProvider.class.d.ts}

@@ -1,7 +1,7 @@
 import { JsonObject } from "@jaypie/types";
 import { LlmHistory, LlmInputMessage, LlmMessageOptions, LlmOperateOptions, LlmOperateResponse, LlmProvider } from "../../types/LlmProvider.interface.js";
 import { LlmStreamChunk } from "../../types/LlmStreamChunk.interface.js";
-export declare class GeminiProvider implements LlmProvider {
+export declare class XaiProvider implements LlmProvider {
     private model;
     private _client?;
     private _operateLoop?;

package/dist/cjs/providers/xai/index.d.ts

@@ -0,0 +1 @@
+export { XaiProvider } from "./XaiProvider.class.js";

package/dist/cjs/providers/xai/utils.d.ts

@@ -0,0 +1,5 @@
+import { OpenAI } from "openai";
+export declare const getLogger: () => import("@jaypie/logger/dist/esm/JaypieLogger.js").default;
+export declare function initializeClient({ apiKey, }?: {
+    apiKey?: string;
+}): Promise<OpenAI>;

package/dist/cjs/types/LlmProvider.interface.d.ts

@@ -149,7 +149,7 @@ export type LlmHistory = LlmHistoryItem[];
  * Used when the primary provider fails with an unrecoverable error.
  */
 export interface LlmFallbackConfig {
-    /** Provider name (e.g., "openai", "anthropic", "gemini") */
+    /** Provider name (e.g., "openai", "anthropic", "google") */
     provider: string;
     /** Model to use with this provider (optional, uses provider default if not specified) */
     model?: string;

package/dist/cjs/types/LlmStreamChunk.interface.d.ts

@@ -16,6 +16,8 @@ export interface LlmStreamChunkToolCall {
         id: string;
         name: string;
         arguments: string;
+        /** Provider-specific metadata preserved through tool-call roundtrip */
+        metadata?: Record<string, unknown>;
     };
 }
 export interface LlmStreamChunkToolResult {

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

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+import { JsonObject, NaturalSchema } from "@jaypie/types";
+type Format = JsonObject | NaturalSchema | z.ZodType;
+/**
+ * Ensure every array field declared in `format` is present in `content` as an
+ * array. A declared `format` is a schema contract: an empty list should surface
+ * as `[]`, not be dropped from the response. Some providers/models omit empty
+ * array fields entirely, leaving consumers to read `.length` on `undefined`.
+ *
+ * Only mutates a (cloned) structured object; strings and non-objects pass
+ * through untouched.
+ */
+export declare function fillFormatArrays({ content, format, }: {
+    content: JsonObject;
+    format: Format;
+}): JsonObject;
+export {};

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

@@ -1,7 +1,9 @@
 export * from "./determineModelProvider.js";
 export * from "./extractReasoning.js";
+export * from "./fillFormatArrays.js";
 export * from "./formatOperateInput.js";
 export * from "./formatOperateMessage.js";
+export * from "./jsonSchemaToOpenApi3.js";
 export * from "./logger.js";
 export * from "./maxTurnsFromOptions.js";
 export * from "./naturalZodSchema.js";

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

@@ -0,0 +1,10 @@
+import { JsonObject } from "@jaypie/types";
+/**
+ * Converts a JSON Schema (Draft 2020-12) object to the OpenAPI 3.0 schema subset
+ * that Gemini's `responseSchema` accepts. This constrains generation (not just validation)
+ * and avoids the `items`-keyword leakage bug in `responseJsonSchema`.
+ *
+ * Strips: $schema, additionalProperties, $defs, $ref (inlines where possible), const
+ * Preserves: type, properties, required, items, enum, description, nullable
+ */
+export declare function jsonSchemaToOpenApi3(schema: JsonObject): JsonObject;

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

@@ -1,2 +1 @@
-export declare const getLogger: () => any;
-export declare const log: any;
+export declare const getLogger: () => import("@jaypie/logger/dist/esm/JaypieLogger").default;

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

@@ -1,6 +1,6 @@
 import { LlmOperateOptions } from "../types/LlmProvider.interface.js";
 export declare const MAX_TURNS_ABSOLUTE_LIMIT = 72;
-export declare const MAX_TURNS_DEFAULT_LIMIT = 12;
+export declare const MAX_TURNS_DEFAULT_LIMIT = 24;
 /**
  * Determines the maximum number of turns based on the provided options
  *

package/dist/esm/constants.d.ts

@@ -1,12 +1,37 @@
+export declare const MODEL: {
+    OPUS: string;
+    SONNET: string;
+    HAIKU: string;
+    FABLE: string;
+    MYTHOS: string;
+    GEMINI_FLASH: string;
+    GEMINI_FLASH_LITE: string;
+    GEMINI_PRO: string;
+    GPT: string;
+    GPT_MINI: string;
+    GPT_NANO: string;
+    GROK: string;
+};
 export declare const PROVIDER: {
+    readonly BEDROCK: {
+        readonly MODEL: {
+            readonly DEFAULT: "amazon.nova-lite-v1:0";
+            readonly LARGE: "amazon.nova-pro-v1:0";
+            readonly SMALL: "amazon.nova-lite-v1:0";
+            readonly TINY: "amazon.nova-micro-v1:0";
+        };
+        readonly MODEL_MATCH_WORDS: readonly ["amazon.nova", "amazon.titan", "anthropic.claude", "cohere.command", "meta.llama", "mistral.mistral", "ai21."];
+        readonly NAME: "bedrock";
+        readonly REGION: "AWS_REGION";
+    };
     readonly ANTHROPIC: {
         readonly MAX_TOKENS: {
             readonly DEFAULT: 4096;
         };
         readonly MODEL: {
-            readonly DEFAULT: "claude-sonnet-4-5";
-            readonly LARGE: "claude-opus-4-5";
-            readonly SMALL: "claude-sonnet-4-5";
+            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"];
@@ -24,15 +49,30 @@ export declare const PROVIDER: {
             readonly SCHEMA_VERSION: "v2";
         };
     };
+    /** @deprecated Use PROVIDER.GOOGLE — "Google" is the provider; Gemini is the model family */
     readonly GEMINI: {
         readonly MODEL: {
-            readonly DEFAULT: "gemini-3-pro-preview";
-            readonly LARGE: "gemini-3-pro-preview";
-            readonly SMALL: "gemini-3-flash-preview";
-            readonly TINY: "gemini-3-flash-preview";
+            readonly DEFAULT: "gemini-3.1-pro-preview";
+            readonly LARGE: "gemini-3.1-pro-preview";
+            readonly SMALL: "gemini-3.5-flash";
+            readonly TINY: "gemini-3.1-flash-lite";
         };
         readonly MODEL_MATCH_WORDS: readonly ["gemini", "google"];
-        readonly NAME: "gemini";
+        readonly NAME: "google";
+        readonly ROLE: {
+            readonly MODEL: "model";
+            readonly USER: "user";
+        };
+    };
+    readonly GOOGLE: {
+        readonly MODEL: {
+            readonly DEFAULT: "gemini-3.1-pro-preview";
+            readonly LARGE: "gemini-3.1-pro-preview";
+            readonly SMALL: "gemini-3.5-flash";
+            readonly TINY: "gemini-3.1-flash-lite";
+        };
+        readonly MODEL_MATCH_WORDS: readonly ["gemini", "google"];
+        readonly NAME: "google";
         readonly ROLE: {
             readonly MODEL: "model";
             readonly USER: "user";
@@ -40,20 +80,20 @@ export declare const PROVIDER: {
     };
     readonly OPENAI: {
         readonly MODEL: {
-            readonly DEFAULT: "gpt-5.2";
-            readonly LARGE: "gpt-5.2-pro";
-            readonly SMALL: "gpt-5-mini";
-            readonly TINY: "gpt-5-nano";
+            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 NAME: "openai";
     };
     readonly OPENROUTER: {
         readonly MODEL: {
-            readonly DEFAULT: "z-ai/glm-4.7";
-            readonly LARGE: "z-ai/glm-4.7";
-            readonly SMALL: "z-ai/glm-4.7";
-            readonly TINY: "z-ai/glm-4.7";
+            readonly DEFAULT: "anthropic/claude-sonnet-4-6";
+            readonly LARGE: "anthropic/claude-opus-4-8";
+            readonly SMALL: "anthropic/claude-sonnet-4-6";
+            readonly TINY: "anthropic/claude-haiku-4-5";
         };
         readonly MODEL_MATCH_WORDS: readonly ["openrouter"];
         readonly NAME: "openrouter";
@@ -64,30 +104,42 @@ export declare const PROVIDER: {
             readonly USER: "user";
         };
     };
+    readonly XAI: {
+        readonly API_KEY: "XAI_API_KEY";
+        readonly BASE_URL: "https://api.x.ai/v1";
+        readonly MODEL: {
+            readonly DEFAULT: "grok-latest";
+            readonly LARGE: "grok-4.3-latest";
+            readonly SMALL: "grok-4-1-fast-reasoning";
+            readonly TINY: "grok-4-1-fast-non-reasoning";
+        };
+        readonly MODEL_MATCH_WORDS: readonly ["grok", "xai"];
+        readonly NAME: "xai";
+    };
 };
-export type LlmProviderName = typeof PROVIDER.ANTHROPIC.NAME | typeof PROVIDER.GEMINI.NAME | typeof PROVIDER.OPENAI.NAME | typeof PROVIDER.OPENROUTER.NAME;
+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: {
     readonly MODEL: {
-        readonly BASE: "gpt-5.2";
-        readonly LARGE: "gpt-5.2-pro";
-        readonly SMALL: "gpt-5-mini";
-        readonly TINY: "gpt-5-nano";
+        readonly BASE: "gpt-5.4";
+        readonly LARGE: "gpt-5.5";
+        readonly SMALL: "gpt-5.4-mini";
+        readonly TINY: "gpt-5.4-nano";
     };
     readonly PROVIDER: {
         readonly MODEL: {
-            readonly DEFAULT: "gpt-5.2";
-            readonly LARGE: "gpt-5.2-pro";
-            readonly SMALL: "gpt-5-mini";
-            readonly TINY: "gpt-5-nano";
+            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 NAME: "openai";
     };
 };
 export declare const ALL: {
-    readonly BASE: readonly ["claude-sonnet-4-5", "gemini-3-pro-preview", "gpt-5.2"];
-    readonly COMBINED: readonly ["claude-sonnet-4-5", "claude-opus-4-5", "claude-sonnet-4-5", "claude-haiku-4-5", "gemini-3-pro-preview", "gemini-3-pro-preview", "gemini-3-flash-preview", "gemini-3-flash-preview", "gpt-5.2", "gpt-5.2-pro", "gpt-5-mini", "gpt-5-nano"];
-    readonly LARGE: readonly ["claude-opus-4-5", "gemini-3-pro-preview", "gpt-5.2-pro"];
-    readonly SMALL: readonly ["claude-sonnet-4-5", "gemini-3-flash-preview", "gpt-5-mini"];
-    readonly TINY: readonly ["claude-haiku-4-5", "gemini-3-flash-preview", "gpt-5-nano"];
+    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 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"];
 };

package/dist/esm/index.d.ts

@@ -8,5 +8,9 @@ export type { LlmStreamChunk, LlmStreamChunkDone, LlmStreamChunkError, LlmStream
 export { LlmStreamChunkType } from "./types/LlmStreamChunk.interface.js";
 export { JaypieToolkit, toolkit, Toolkit, tools } from "./tools/index.js";
 export { extractReasoning } from "./util/extractReasoning.js";
-export { GeminiProvider } from "./providers/gemini/index.js";
+export { BedrockProvider } from "./providers/bedrock/index.js";
+/** @deprecated Use GoogleProvider — "Google" is the provider; Gemini is the model family */
+export { GoogleProvider as GeminiProvider } from "./providers/google/index.js";
+export { GoogleProvider } from "./providers/google/index.js";
 export { OpenRouterProvider } from "./providers/openrouter/index.js";
+export { XaiProvider } from "./providers/xai/index.js";