@jaypie/llm 1.2.23 → 1.2.25

package/dist/cjs/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var errors = require('@jaypie/errors');
-var log$2 = require('@jaypie/logger');
+var log$1 = require('@jaypie/logger');
 var v4 = require('zod/v4');
 var kit = require('@jaypie/kit');
 var RandomLib = require('random');
@@ -554,8 +554,51 @@ function formatOperateInput(input, options) {
     return [input];
 }
 
-const getLogger$5 = () => log$2.log.lib({ lib: kit.JAYPIE.LIB.LLM });
-const log$1 = getLogger$5();
+/**
+ * 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
+ */
+function jsonSchemaToOpenApi3(schema) {
+    if (typeof schema !== "object" || schema === null || Array.isArray(schema)) {
+        return schema;
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(schema)) {
+        // Strip JSON Schema keywords not in OpenAPI 3.0 subset
+        if (key === "$schema" ||
+            key === "$defs" ||
+            key === "additionalProperties" ||
+            key === "const" ||
+            key === "$ref") {
+            continue;
+        }
+        if (key === "properties" &&
+            typeof value === "object" &&
+            value !== null &&
+            !Array.isArray(value)) {
+            const convertedProps = {};
+            for (const [propKey, propValue] of Object.entries(value)) {
+                convertedProps[propKey] = jsonSchemaToOpenApi3(propValue);
+            }
+            result[key] = convertedProps;
+        }
+        else if (key === "items" &&
+            typeof value === "object" &&
+            value !== null) {
+            result[key] = jsonSchemaToOpenApi3(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+
+const getLogger$5 = () => log$1.log.lib({ lib: kit.JAYPIE.LIB.LLM });
 
 // Turn policy constants
 const MAX_TURNS_ABSOLUTE_LIMIT = 72;
@@ -1541,11 +1584,21 @@ class GeminiAdapter extends BaseProviderAdapter {
         // Gemini doesn't support combining function calling with responseMimeType: 'application/json'
         // When tools are present, structured output is handled via the structured_output tool
         if (request.format && !(request.tools && request.tools.length > 0)) {
-            geminiRequest.config = {
-                ...geminiRequest.config,
-                responseMimeType: "application/json",
-                responseJsonSchema: request.format,
-            };
+            const useJsonSchema = request.providerOptions?.useJsonSchema === true;
+            if (useJsonSchema) {
+                geminiRequest.config = {
+                    ...geminiRequest.config,
+                    responseMimeType: "application/json",
+                    responseJsonSchema: request.format,
+                };
+            }
+            else {
+                geminiRequest.config = {
+                    ...geminiRequest.config,
+                    responseMimeType: "application/json",
+                    responseSchema: jsonSchemaToOpenApi3(request.format),
+                };
+            }
         }
         // When format is specified with tools, add instruction to use structured_output tool
         if (request.format && request.tools && request.tools.length > 0) {
@@ -1613,11 +1666,7 @@ class GeminiAdapter extends BaseProviderAdapter {
                 : naturalZodSchema(schema);
             jsonSchema = v4.z.toJSONSchema(zodSchema);
         }
-        // Remove $schema property (Gemini doesn't need it)
-        if (jsonSchema.$schema) {
-            delete jsonSchema.$schema;
-        }
-        return jsonSchema;
+        return jsonSchemaToOpenApi3(jsonSchema);
     }
     //
     // API Execution
@@ -2662,16 +2711,16 @@ function convertContentToOpenRouter(content) {
         }
         // Image content - warn and discard
         if (item.type === exports.LlmMessageType.InputImage) {
-            log$2.log.warn("OpenRouter does not support image uploads; image discarded");
+            log$1.log.warn("OpenRouter does not support image uploads; image discarded");
             continue;
         }
         // File/Document content - warn and discard
         if (item.type === exports.LlmMessageType.InputFile) {
-            log$2.log.warn({ filename: item.filename }, "OpenRouter does not support file uploads; file discarded");
+            log$1.log.warn({ filename: item.filename }, "OpenRouter does not support file uploads; file discarded");
             continue;
         }
         // Unknown type - warn and skip
-        log$2.log.warn({ item }, "Unknown content type for OpenRouter; discarded");
+        log$1.log.warn({ item }, "Unknown content type for OpenRouter; discarded");
     }
     // If no text parts remain, return empty string to avoid empty array
     if (parts.length === 0) {
@@ -3249,7 +3298,7 @@ class XaiAdapter extends OpenAiAdapter {
 const xaiAdapter = new XaiAdapter();
 
 const DEFAULT_TOOL_TYPE = "function";
-const log = log$2.log.lib({ lib: kit.JAYPIE.LIB.LLM });
+const log = log$1.log.lib({ lib: kit.JAYPIE.LIB.LLM });
 function logToolMessage(message, context) {
     log.trace.var({ [context.name]: message });
 }
@@ -4055,6 +4104,7 @@ class RetryExecutor {
      * @throws BadGatewayError if all retries are exhausted or error is not retryable
      */
     async execute(operation, options) {
+        const log = getLogger$5();
         let attempt = 0;
         // Persistent guard against stale socket errors (TypeError: terminated).
         // Installed after the first abort and kept alive through subsequent attempts
@@ -4066,7 +4116,7 @@ class RetryExecutor {
                 return;
             staleGuard = (reason) => {
                 if (isTransientNetworkError(reason)) {
-                    log$1.trace("Suppressed stale socket error during retry");
+                    log.trace("Suppressed stale socket error during retry");
                 }
             };
             process.on("unhandledRejection", staleGuard);
@@ -4083,7 +4133,7 @@ class RetryExecutor {
                 try {
                     const result = await operation(controller.signal);
                     if (attempt > 0) {
-                        log$1.debug(`API call succeeded after ${attempt} retries`);
+                        log.debug(`API call succeeded after ${attempt} retries`);
                     }
                     return result;
                 }
@@ -4096,8 +4146,8 @@ class RetryExecutor {
                     installGuard();
                     // Check if we've exhausted retries
                     if (!this.policy.shouldRetry(attempt)) {
-                        log$1.error(`API call failed after ${this.policy.maxRetries} retries`);
-                        log$1.var({ error });
+                        log.error(`API call failed after ${this.policy.maxRetries} retries`);
+                        log.var({ error });
                         await this.hookRunner.runOnUnrecoverableError(options.hooks, {
                             input: options.context.input,
                             options: options.context.options,
@@ -4109,8 +4159,8 @@ class RetryExecutor {
                     }
                     // Check if error is not retryable
                     if (!this.errorClassifier.isRetryable(error)) {
-                        log$1.error("API call failed with non-retryable error");
-                        log$1.var({ error });
+                        log.error("API call failed with non-retryable error");
+                        log.var({ error });
                         await this.hookRunner.runOnUnrecoverableError(options.hooks, {
                             input: options.context.input,
                             options: options.context.options,
@@ -4122,11 +4172,11 @@ class RetryExecutor {
                     }
                     // Warn if this is an unknown error type
                     if (!this.errorClassifier.isKnownError(error)) {
-                        log$1.warn("API returned unknown error type, will retry");
-                        log$1.var({ error });
+                        log.warn("API returned unknown error type, will retry");
+                        log.var({ error });
                     }
                     const delay = this.policy.getDelayForAttempt(attempt);
-                    log$1.warn(`API call failed. Retrying in ${delay}ms...`);
+                    log.warn(`API call failed. Retrying in ${delay}ms...`);
                     await this.hookRunner.runOnRetryableError(options.hooks, {
                         input: options.context.input,
                         options: options.context.options,
@@ -4192,10 +4242,11 @@ class OperateLoop {
      * Execute the operate loop for multi-turn conversations with tool calling.
      */
     async execute(input, options = {}) {
+        const log = getLogger$5();
         // Log what was passed to operate
-        log$1.trace("[operate] Starting operate loop");
-        log$1.var({ "operate.input": input });
-        log$1.var({ "operate.options": options });
+        log.trace("[operate] Starting operate loop");
+        log.var({ "operate.input": input });
+        log.var({ "operate.options": options });
         // Initialize state
         const state = await this.initializeState(input, options);
         const context = this.createContext(options);
@@ -4304,6 +4355,7 @@ class OperateLoop {
         };
     }
     async executeOneTurn(request, state, context, options) {
+        const log = getLogger$5();
         // Create error classifier from adapter
         const errorClassifier = createErrorClassifier(this.adapter);
         // Create retry executor for this turn
@@ -4315,8 +4367,8 @@ class OperateLoop {
         // Build provider-specific request
         const providerRequest = this.adapter.buildRequest(request);
         // Log what was passed to the model
-        log$1.trace("[operate] Calling model");
-        log$1.var({ "operate.request": providerRequest });
+        log.trace("[operate] Calling model");
+        log.var({ "operate.request": providerRequest });
         // Execute beforeEachModelRequest hook
         await this.hookRunnerInstance.runBeforeModelRequest(context.hooks, {
             input: state.currentInput,
@@ -4333,8 +4385,8 @@ class OperateLoop {
             hooks: context.hooks,
         });
         // Log what was returned from the model
-        log$1.trace("[operate] Model response received");
-        log$1.var({ "operate.response": response });
+        log.trace("[operate] Model response received");
+        log.var({ "operate.response": response });
         // Parse response
         const parsed = this.adapter.parseResponse(response, options);
         // Track usage
@@ -4382,7 +4434,7 @@ class OperateLoop {
                             toolName: toolCall.name,
                         });
                         // Call the tool
-                        log$1.trace(`[operate] Calling tool - ${toolCall.name}`);
+                        log.trace(`[operate] Calling tool - ${toolCall.name}`);
                         const result = await state.toolkit.call({
                             arguments: toolCall.arguments,
                             name: toolCall.name,
@@ -4440,13 +4492,13 @@ class OperateLoop {
                         };
                         const toolResultFormatted = this.adapter.formatToolResult(toolCall, errorResult);
                         state.responseBuilder.appendToHistory(toolResultFormatted);
-                        log$1.error(`Error executing function call ${toolCall.name}`);
-                        log$1.var({ error });
+                        log.error(`Error executing function call ${toolCall.name}`);
+                        log.var({ error });
                         // Track consecutive errors and stop if threshold reached
                         state.consecutiveToolErrors++;
                         if (state.consecutiveToolErrors >= MAX_CONSECUTIVE_TOOL_ERRORS) {
                             const detail = `Stopped after ${MAX_CONSECUTIVE_TOOL_ERRORS} consecutive tool errors`;
-                            log$1.warn(detail);
+                            log.warn(detail);
                             state.responseBuilder.setError({
                                 detail,
                                 status: 502,
@@ -4461,7 +4513,7 @@ class OperateLoop {
                 if (state.currentTurn >= state.maxTurns) {
                     const error = new errors.TooManyRequestsError();
                     const detail = `Model requested function call but exceeded ${state.maxTurns} turns`;
-                    log$1.warn(detail);
+                    log.warn(detail);
                     state.responseBuilder.setError({
                         detail,
                         status: error.status,
@@ -4615,6 +4667,7 @@ class StreamLoop {
      * Yields stream chunks as they become available.
      */
     async *execute(input, options = {}) {
+        const log = getLogger$5();
         // Verify adapter supports streaming
         if (!this.adapter.executeStreamRequest) {
             throw new errors.BadGatewayError(`Provider ${this.adapter.name} does not support streaming`);
@@ -4639,7 +4692,7 @@ class StreamLoop {
                 if (state.currentTurn >= state.maxTurns) {
                     const error = new errors.TooManyRequestsError();
                     const detail = `Model requested function call but exceeded ${state.maxTurns} turns`;
-                    log$1.warn(detail);
+                    log.warn(detail);
                     yield {
                         type: exports.LlmStreamChunkType.Error,
                         error: {
@@ -4732,6 +4785,7 @@ class StreamLoop {
         };
     }
     async *executeOneStreamingTurn(request, state, context, options) {
+        const log = getLogger$5();
         // Build provider-specific request
         const providerRequest = this.adapter.buildRequest(request);
         // Execute beforeEachModelRequest hook
@@ -4753,7 +4807,7 @@ class StreamLoop {
                 return;
             staleGuard = (reason) => {
                 if (isTransientNetworkError(reason)) {
-                    log$1.trace("Suppressed stale socket error during retry");
+                    log.trace("Suppressed stale socket error during retry");
                 }
             };
             process.on("unhandledRejection", staleGuard);
@@ -4799,7 +4853,7 @@ class StreamLoop {
                     }
                     // Stream completed successfully
                     if (attempt > 0) {
-                        log$1.debug(`Stream request succeeded after ${attempt} retries`);
+                        log.debug(`Stream request succeeded after ${attempt} retries`);
                     }
                     break;
                 }
@@ -4811,8 +4865,8 @@ class StreamLoop {
                     // If chunks were already yielded, we can't transparently retry
                     if (chunksYielded) {
                         const errorMessage = error instanceof Error ? error.message : String(error);
-                        log$1.error("Stream failed after partial data was delivered");
-                        log$1.var({ error });
+                        log.error("Stream failed after partial data was delivered");
+                        log.var({ error });
                         yield {
                             type: exports.LlmStreamChunkType.Error,
                             error: {
@@ -4826,14 +4880,14 @@ class StreamLoop {
                     // Check if we've exhausted retries or error is not retryable
                     if (!this.retryPolicy.shouldRetry(attempt) ||
                         !this.adapter.isRetryableError(error)) {
-                        log$1.error(`Stream request failed after ${this.retryPolicy.maxRetries} retries`);
-                        log$1.var({ error });
+                        log.error(`Stream request failed after ${this.retryPolicy.maxRetries} retries`);
+                        log.var({ error });
                         const errorMessage = error instanceof Error ? error.message : String(error);
                         throw new errors.BadGatewayError(errorMessage);
                     }
                     const delay = this.retryPolicy.getDelayForAttempt(attempt);
-                    log$1.warn(`Stream request failed. Retrying in ${delay}ms...`);
-                    log$1.var({ error });
+                    log.warn(`Stream request failed. Retrying in ${delay}ms...`);
+                    log.var({ error });
                     await kit.sleep(delay);
                     attempt++;
                 }
@@ -4877,6 +4931,7 @@ class StreamLoop {
         return { shouldContinue: false };
     }
     async *processToolCalls(toolCalls, state, context, _options) {
+        const log = getLogger$5();
         for (const toolCall of toolCalls) {
             try {
                 // Execute beforeEachTool hook
@@ -4885,7 +4940,7 @@ class StreamLoop {
                     toolName: toolCall.name,
                 });
                 // Call the tool
-                log$1.trace(`[stream] Calling tool - ${toolCall.name}`);
+                log.trace(`[stream] Calling tool - ${toolCall.name}`);
                 const result = await state.toolkit.call({
                     arguments: toolCall.arguments,
                     name: toolCall.name,
@@ -4948,13 +5003,13 @@ class StreamLoop {
                     call_id: toolCall.callId,
                     name: toolCall.name,
                 });
-                log$1.error(`Error executing function call ${toolCall.name}`);
-                log$1.var({ error });
+                log.error(`Error executing function call ${toolCall.name}`);
+                log.var({ error });
                 // Track consecutive errors and stop if threshold reached
                 state.consecutiveToolErrors++;
                 if (state.consecutiveToolErrors >= MAX_CONSECUTIVE_TOOL_ERRORS) {
                     const stopDetail = `Stopped after ${MAX_CONSECUTIVE_TOOL_ERRORS} consecutive tool errors`;
-                    log$1.warn(stopDetail);
+                    log.warn(stopDetail);
                     yield {
                         type: exports.LlmStreamChunkType.Error,
                         error: {
@@ -5035,7 +5090,7 @@ async function loadSdk$2() {
     }
 }
 // Logger
-const getLogger$4 = () => log$2.log.lib({ lib: kit.JAYPIE.LIB.LLM });
+const getLogger$4 = () => log$1.log.lib({ lib: kit.JAYPIE.LIB.LLM });
 // Client initialization
 async function initializeClient$4({ apiKey, } = {}) {
     const logger = getLogger$4();
@@ -5074,7 +5129,7 @@ function prepareMessages$3(message, { data, placeholders } = {}) {
 }
 // Basic text completion
 async function createTextCompletion$1(client, messages, model, systemMessage) {
-    log$2.log.trace("Using text output (unstructured)");
+    log$1.log.trace("Using text output (unstructured)");
     const params = {
         model,
         messages,
@@ -5083,17 +5138,17 @@ async function createTextCompletion$1(client, messages, model, systemMessage) {
     // Add system instruction if provided
     if (systemMessage) {
         params.system = systemMessage;
-        log$2.log.trace(`System message: ${systemMessage.length} characters`);
+        log$1.log.trace(`System message: ${systemMessage.length} characters`);
     }
     const response = await client.messages.create(params);
     const firstContent = response.content[0];
     const text = firstContent && "text" in firstContent ? firstContent.text : "";
-    log$2.log.trace(`Assistant reply: ${text.length} characters`);
+    log$1.log.trace(`Assistant reply: ${text.length} characters`);
     return text;
 }
 // Structured output completion
 async function createStructuredCompletion$1(client, messages, model, responseSchema, systemMessage) {
-    log$2.log.trace("Using structured output");
+    log$1.log.trace("Using structured output");
     // Get the JSON schema for the response
     const schema = responseSchema instanceof v4.z.ZodType
         ? responseSchema
@@ -5126,7 +5181,7 @@ async function createStructuredCompletion$1(client, messages, model, responseSch
                 if (!schema.parse(result)) {
                     throw new Error(`JSON response from Anthropic does not match schema: ${responseText}`);
                 }
-                log$2.log.trace("Received structured response", { result });
+                log$1.log.trace("Received structured response", { result });
                 return result;
             }
             catch {
@@ -5137,7 +5192,7 @@ async function createStructuredCompletion$1(client, messages, model, responseSch
         throw new Error("Failed to parse structured response from Anthropic");
     }
     catch (error) {
-        log$2.log.error("Error creating structured completion", { error });
+        log$1.log.error("Error creating structured completion", { error });
         throw error;
     }
 }
@@ -5251,7 +5306,7 @@ async function loadSdk$1() {
     }
 }
 // Logger
-const getLogger$3 = () => log$2.log.lib({ lib: kit.JAYPIE.LIB.LLM });
+const getLogger$3 = () => log$1.log.lib({ lib: kit.JAYPIE.LIB.LLM });
 // Client initialization
 async function initializeClient$3({ apiKey, } = {}) {
     const logger = getLogger$3();
@@ -5402,7 +5457,7 @@ class GeminiProvider {
 }
 
 // Logger
-const getLogger$2 = () => log$2.log.lib({ lib: kit.JAYPIE.LIB.LLM });
+const getLogger$2 = () => log$1.log.lib({ lib: kit.JAYPIE.LIB.LLM });
 // Client initialization
 async function initializeClient$2({ apiKey, } = {}) {
     const logger = getLogger$2();
@@ -5586,7 +5641,7 @@ async function loadSdk() {
     }
 }
 // Logger
-const getLogger$1 = () => log$2.log.lib({ lib: kit.JAYPIE.LIB.LLM });
+const getLogger$1 = () => log$1.log.lib({ lib: kit.JAYPIE.LIB.LLM });
 // Client initialization
 async function initializeClient$1({ apiKey, } = {}) {
     const logger = getLogger$1();
@@ -5735,7 +5790,7 @@ class OpenRouterProvider {
 }
 
 // Logger
-const getLogger = () => log$2.log.lib({ lib: kit.JAYPIE.LIB.LLM });
+const getLogger = () => log$1.log.lib({ lib: kit.JAYPIE.LIB.LLM });
 // Client initialization
 async function initializeClient({ apiKey, } = {}) {
     const logger = getLogger();
@@ -5842,7 +5897,7 @@ class Llm {
         let finalModel = model;
         // Legacy: accept "gemini" but warn
         if (providerName === "gemini") {
-            log$2.warn(`Provider "gemini" is deprecated, use "${PROVIDER.GEMINI.NAME}" instead`);
+            log$1.warn(`Provider "gemini" is deprecated, use "${PROVIDER.GEMINI.NAME}" instead`);
         }
         if (model) {
             const modelDetermined = determineModelProvider(model);
@@ -5954,7 +6009,7 @@ class Llm {
         }
         catch (error) {
             lastError = error;
-            log$2.warn(`Provider ${this._provider} failed`, {
+            log$1.warn(`Provider ${this._provider} failed`, {
                 error: lastError.message,
                 fallbacksRemaining: fallbackChain.length,
             });
@@ -5974,7 +6029,7 @@ class Llm {
             }
             catch (error) {
                 lastError = error;
-                log$2.warn(`Fallback provider ${fallbackConfig.provider} failed`, {
+                log$1.warn(`Fallback provider ${fallbackConfig.provider} failed`, {
                     error: lastError.message,
                     fallbacksRemaining: fallbackChain.length - attempts + 1,
                 });
@@ -6143,16 +6198,17 @@ const roll = {
     },
     type: "function",
     call: ({ number = 1, sides = 6 } = {}) => {
+        const log = getLogger$5();
         const rng = random$1();
         const rolls = [];
         let total = 0;
         const parsedNumber = tryParseNumber(number, {
             defaultValue: 1,
-            warnFunction: log$1.warn,
+            warnFunction: log.warn,
         });
         const parsedSides = tryParseNumber(sides, {
             defaultValue: 6,
-            warnFunction: log$1.warn,
+            warnFunction: log.warn,
         });
         for (let i = 0; i < parsedNumber; i++) {
             const rollValue = rng({ min: 1, max: parsedSides, integer: true });