@juspay/neurolink 8.5.0 → 8.5.1

package/dist/lib/providers/googleAiStudio.d.ts

@@ -6,6 +6,33 @@ import { BaseProvider } from "../core/baseProvider.js";
 /**
  * Google AI Studio provider implementation using BaseProvider
  * Migrated from original GoogleAIStudio class to new factory pattern
+ *
+ * @important Structured Output Limitation
+ * Google Gemini models cannot combine function calling (tools) with structured
+ * output (JSON schema). When using schemas with output.format: "json", you MUST
+ * set disableTools: true.
+ *
+ * Error without disableTools:
+ * "Function calling with a response mime type: 'application/json' is unsupported"
+ *
+ * This is a Google API limitation documented at:
+ * https://ai.google.dev/gemini-api/docs/function-calling
+ *
+ * @example
+ * ```typescript
+ * // ✅ Correct usage with schemas
+ * const provider = new GoogleAIStudioProvider("gemini-2.5-flash");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" },
+ *   disableTools: true  // Required
+ * });
+ * ```
+ *
+ * @note Gemini 3 Pro Preview (November 2025) will support combining tools + schemas
+ * @note "Too many states for serving" errors can occur with complex schemas + tools.
+ *       Solution: Simplify schema or use disableTools: true
  */
 export declare class GoogleAIStudioProvider extends BaseProvider {
     constructor(modelName?: string, sdk?: unknown);

package/dist/lib/providers/googleAiStudio.js

@@ -27,6 +27,33 @@ if (!process.env.GOOGLE_GENERATIVE_AI_API_KEY &&
 /**
  * Google AI Studio provider implementation using BaseProvider
  * Migrated from original GoogleAIStudio class to new factory pattern
+ *
+ * @important Structured Output Limitation
+ * Google Gemini models cannot combine function calling (tools) with structured
+ * output (JSON schema). When using schemas with output.format: "json", you MUST
+ * set disableTools: true.
+ *
+ * Error without disableTools:
+ * "Function calling with a response mime type: 'application/json' is unsupported"
+ *
+ * This is a Google API limitation documented at:
+ * https://ai.google.dev/gemini-api/docs/function-calling
+ *
+ * @example
+ * ```typescript
+ * // ✅ Correct usage with schemas
+ * const provider = new GoogleAIStudioProvider("gemini-2.5-flash");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" },
+ *   disableTools: true  // Required
+ * });
+ * ```
+ *
+ * @note Gemini 3 Pro Preview (November 2025) will support combining tools + schemas
+ * @note "Too many states for serving" errors can occur with complex schemas + tools.
+ *       Solution: Simplify schema or use disableTools: true
  */
 export class GoogleAIStudioProvider extends BaseProvider {
     constructor(modelName, sdk) {

package/dist/lib/providers/googleVertex.d.ts

@@ -13,6 +13,41 @@ import { BaseProvider } from "../core/baseProvider.js";
  * - Fresh model creation for each request
  * - Enhanced error handling with setup guidance
  * - Tool registration and context management
+ *
+ * @important Structured Output Limitation (Gemini Models Only)
+ * Google Gemini models on Vertex AI cannot combine function calling (tools) with
+ * structured output (JSON schema). When using schemas, you MUST set disableTools: true.
+ *
+ * Error without disableTools:
+ * "Function calling with a response mime type: 'application/json' is unsupported"
+ *
+ * This limitation ONLY affects Gemini models. Anthropic Claude models via Vertex
+ * AI do NOT have this limitation and support both tools + schemas simultaneously.
+ *
+ * @example Gemini models with schemas
+ * ```typescript
+ * const provider = new GoogleVertexProvider("gemini-2.5-flash");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" },
+ *   disableTools: true  // Required for Gemini models
+ * });
+ * ```
+ *
+ * @example Claude models (no limitation)
+ * ```typescript
+ * const provider = new GoogleVertexProvider("claude-3-5-sonnet-20241022");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" }
+ *   // No disableTools needed - Claude supports both
+ * });
+ * ```
+ *
+ * @note Gemini 3 Pro Preview (November 2025) will support combining tools + schemas
+ * @see https://cloud.google.com/vertex-ai/docs/generative-ai/learn/models
  */
 export declare class GoogleVertexProvider extends BaseProvider {
     private projectId;

package/dist/lib/providers/googleVertex.js

@@ -234,6 +234,41 @@ const isAnthropicModel = (modelName) => {
  * - Fresh model creation for each request
  * - Enhanced error handling with setup guidance
  * - Tool registration and context management
+ *
+ * @important Structured Output Limitation (Gemini Models Only)
+ * Google Gemini models on Vertex AI cannot combine function calling (tools) with
+ * structured output (JSON schema). When using schemas, you MUST set disableTools: true.
+ *
+ * Error without disableTools:
+ * "Function calling with a response mime type: 'application/json' is unsupported"
+ *
+ * This limitation ONLY affects Gemini models. Anthropic Claude models via Vertex
+ * AI do NOT have this limitation and support both tools + schemas simultaneously.
+ *
+ * @example Gemini models with schemas
+ * ```typescript
+ * const provider = new GoogleVertexProvider("gemini-2.5-flash");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" },
+ *   disableTools: true  // Required for Gemini models
+ * });
+ * ```
+ *
+ * @example Claude models (no limitation)
+ * ```typescript
+ * const provider = new GoogleVertexProvider("claude-3-5-sonnet-20241022");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" }
+ *   // No disableTools needed - Claude supports both
+ * });
+ * ```
+ *
+ * @note Gemini 3 Pro Preview (November 2025) will support combining tools + schemas
+ * @see https://cloud.google.com/vertex-ai/docs/generative-ai/learn/models
  */
 export class GoogleVertexProvider extends BaseProvider {
     projectId;
@@ -1363,11 +1398,14 @@ export class GoogleVertexProvider extends BaseProvider {
     getModelSuggestions(requestedModel) {
         const availableModels = {
             google: [
+                "gemini-3-pro-preview-11-2025",
+                "gemini-3-pro-latest",
                 "gemini-3-pro-preview",
                 "gemini-2.5-pro",
                 "gemini-2.5-flash",
                 "gemini-2.5-flash-lite",
                 "gemini-2.0-flash-001",
+                "gemini-2.0-flash-lite",
                 "gemini-1.5-pro",
                 "gemini-1.5-flash",
             ],

package/dist/lib/types/generateTypes.d.ts

@@ -34,9 +34,58 @@ export type GenerateOptions = {
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;
+    /**
+     * Zod schema for structured output validation
+     *
+     * @important Google Gemini Limitation
+     * Google Vertex AI and Google AI Studio cannot combine function calling with
+     * structured output. You MUST use `disableTools: true` when using schemas with
+     * Google providers.
+     *
+     * Error without disableTools: "Function calling with a response mime type:
+     * 'application/json' is unsupported"
+     *
+     * This is a documented Google API limitation, not a NeuroLink bug.
+     * All frameworks (LangChain, Vercel AI SDK, Agno, Instructor) use this approach.
+     *
+     * @example
+     * ```typescript
+     * // ✅ Correct for Google providers
+     * const result = await neurolink.generate({
+     *   schema: MySchema,
+     *   provider: "vertex",
+     *   disableTools: true  // Required for Google
+     * });
+     *
+     * // ✅ No restriction for other providers
+     * const result = await neurolink.generate({
+     *   schema: MySchema,
+     *   provider: "openai"  // Works without disableTools
+     * });
+     * ```
+     *
+     * @see https://ai.google.dev/gemini-api/docs/function-calling
+     */
     schema?: ValidationSchema;
     tools?: Record<string, Tool>;
     timeout?: number | string;
+    /**
+     * Disable tool execution (including built-in tools)
+     *
+     * @required For Google Gemini providers when using schemas
+     * Google Vertex AI and Google AI Studio require this flag when using
+     * structured output (schemas) due to Google API limitations.
+     *
+     * @example
+     * ```typescript
+     * // Required for Google providers with schemas
+     * await neurolink.generate({
+     *   schema: MySchema,
+     *   provider: "vertex",
+     *   disableTools: true
+     * });
+     * ```
+     */
     disableTools?: boolean;
     enableEvaluation?: boolean;
     enableAnalytics?: boolean;

package/dist/lib/utils/messageBuilder.js

@@ -3,7 +3,7 @@
  * Centralized logic for building message arrays from TextGenerationOptions
  * Enhanced with multimodal support for images
  */
-import { CONVERSATION_INSTRUCTIONS } from "../config/conversationMemory.js";
+import { CONVERSATION_INSTRUCTIONS, STRUCTURED_OUTPUT_INSTRUCTIONS, } from "../config/conversationMemory.js";
 import { ProviderImageAdapter, MultimodalLogger, } from "../adapters/providerImageAdapter.js";
 import { logger } from "./logger.js";
 import { FileDetector } from "./fileDetector.js";
@@ -199,6 +199,15 @@ function formatCSVMetadata(metadata) {
     }
     return parts.length > 0 ? `**Metadata**: ${parts.join(" | ")}` : "";
 }
+/**
+ * Check if structured output mode should be enabled
+ * Structured output is used when a schema is provided with json/structured format
+ */
+function shouldUseStructuredOutput(options) {
+    return (!!options.schema &&
+        (options.output?.format === "json" ||
+            options.output?.format === "structured"));
+}
 /**
  * Build a properly formatted message array for AI providers
  * Combines system prompt, conversation history, and current user prompt
@@ -215,6 +224,10 @@ export async function buildMessagesArray(options) {
     if (hasConversationHistory) {
         systemPrompt = `${systemPrompt.trim()}${CONVERSATION_INSTRUCTIONS}`;
     }
+    // Add structured output instructions when schema is provided with json/structured format
+    if (shouldUseStructuredOutput(options)) {
+        systemPrompt = `${systemPrompt.trim()}${STRUCTURED_OUTPUT_INSTRUCTIONS}`;
+    }
     // Add system message if we have one
     if (systemPrompt.trim()) {
         messages.push({
@@ -473,6 +486,10 @@ export async function buildMultimodalMessagesArray(options, provider, model) {
     if (hasConversationHistory) {
         systemPrompt = `${systemPrompt.trim()}${CONVERSATION_INSTRUCTIONS}`;
     }
+    // Add structured output instructions when schema is provided with json/structured format
+    if (shouldUseStructuredOutput(options)) {
+        systemPrompt = `${systemPrompt.trim()}${STRUCTURED_OUTPUT_INSTRUCTIONS}`;
+    }
     // Add file handling guidance when multimodal files are present
     const hasCSVFiles = (options.input.csvFiles && options.input.csvFiles.length > 0) ||
         (options.input.files &&

package/dist/models/modelRegistry.js

@@ -188,6 +188,99 @@ export const MODEL_REGISTRY = {
         category: "general",
     },
     // Anthropic Models
+    [AnthropicModels.CLAUDE_OPUS_4_5]: {
+        id: AnthropicModels.CLAUDE_OPUS_4_5,
+        name: "Claude Opus 4.5",
+        provider: AIProviderName.ANTHROPIC,
+        description: "Anthropic's most capable model with exceptional reasoning, coding, and multimodal capabilities",
+        capabilities: {
+            vision: true,
+            functionCalling: true,
+            codeGeneration: true,
+            reasoning: true,
+            multimodal: true,
+            streaming: true,
+            jsonMode: false,
+        },
+        pricing: {
+            inputCostPer1K: 0.015,
+            outputCostPer1K: 0.075,
+            currency: "USD",
+        },
+        performance: {
+            speed: "medium",
+            quality: "high",
+            accuracy: "high",
+        },
+        limits: {
+            maxContextTokens: 200000,
+            maxOutputTokens: 64000,
+            maxRequestsPerMinute: 50,
+        },
+        useCases: {
+            coding: 10,
+            creative: 10,
+            analysis: 10,
+            conversation: 9,
+            reasoning: 10,
+            translation: 9,
+            summarization: 9,
+        },
+        aliases: [
+            "claude-4.5-opus",
+            "claude-opus-latest",
+            "opus-4.5",
+            "anthropic-flagship",
+        ],
+        deprecated: false,
+        isLocal: false,
+        releaseDate: "2025-11-24",
+        category: "reasoning",
+    },
+    [AnthropicModels.CLAUDE_SONNET_4_5]: {
+        id: AnthropicModels.CLAUDE_SONNET_4_5,
+        name: "Claude Sonnet 4.5",
+        provider: AIProviderName.ANTHROPIC,
+        description: "Balanced Claude model with excellent performance across all tasks including vision and reasoning",
+        capabilities: {
+            vision: true,
+            functionCalling: true,
+            codeGeneration: true,
+            reasoning: true,
+            multimodal: true,
+            streaming: true,
+            jsonMode: false,
+        },
+        pricing: {
+            inputCostPer1K: 0.003,
+            outputCostPer1K: 0.015,
+            currency: "USD",
+        },
+        performance: {
+            speed: "medium",
+            quality: "high",
+            accuracy: "high",
+        },
+        limits: {
+            maxContextTokens: 200000,
+            maxOutputTokens: 64000,
+            maxRequestsPerMinute: 100,
+        },
+        useCases: {
+            coding: 10,
+            creative: 9,
+            analysis: 9,
+            conversation: 9,
+            reasoning: 10,
+            translation: 8,
+            summarization: 8,
+        },
+        aliases: ["claude-4.5-sonnet", "claude-sonnet-latest", "sonnet-4.5"],
+        deprecated: false,
+        isLocal: false,
+        releaseDate: "2025-09-29",
+        category: "coding",
+    },
     [AnthropicModels.CLAUDE_4_5_HAIKU]: {
         id: AnthropicModels.CLAUDE_4_5_HAIKU,
         name: "Claude 4.5 Haiku",

package/dist/providers/googleAiStudio.d.ts

@@ -6,6 +6,33 @@ import { BaseProvider } from "../core/baseProvider.js";
 /**
  * Google AI Studio provider implementation using BaseProvider
  * Migrated from original GoogleAIStudio class to new factory pattern
+ *
+ * @important Structured Output Limitation
+ * Google Gemini models cannot combine function calling (tools) with structured
+ * output (JSON schema). When using schemas with output.format: "json", you MUST
+ * set disableTools: true.
+ *
+ * Error without disableTools:
+ * "Function calling with a response mime type: 'application/json' is unsupported"
+ *
+ * This is a Google API limitation documented at:
+ * https://ai.google.dev/gemini-api/docs/function-calling
+ *
+ * @example
+ * ```typescript
+ * // ✅ Correct usage with schemas
+ * const provider = new GoogleAIStudioProvider("gemini-2.5-flash");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" },
+ *   disableTools: true  // Required
+ * });
+ * ```
+ *
+ * @note Gemini 3 Pro Preview (November 2025) will support combining tools + schemas
+ * @note "Too many states for serving" errors can occur with complex schemas + tools.
+ *       Solution: Simplify schema or use disableTools: true
  */
 export declare class GoogleAIStudioProvider extends BaseProvider {
     constructor(modelName?: string, sdk?: unknown);

package/dist/providers/googleAiStudio.js

@@ -27,6 +27,33 @@ if (!process.env.GOOGLE_GENERATIVE_AI_API_KEY &&
 /**
  * Google AI Studio provider implementation using BaseProvider
  * Migrated from original GoogleAIStudio class to new factory pattern
+ *
+ * @important Structured Output Limitation
+ * Google Gemini models cannot combine function calling (tools) with structured
+ * output (JSON schema). When using schemas with output.format: "json", you MUST
+ * set disableTools: true.
+ *
+ * Error without disableTools:
+ * "Function calling with a response mime type: 'application/json' is unsupported"
+ *
+ * This is a Google API limitation documented at:
+ * https://ai.google.dev/gemini-api/docs/function-calling
+ *
+ * @example
+ * ```typescript
+ * // ✅ Correct usage with schemas
+ * const provider = new GoogleAIStudioProvider("gemini-2.5-flash");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" },
+ *   disableTools: true  // Required
+ * });
+ * ```
+ *
+ * @note Gemini 3 Pro Preview (November 2025) will support combining tools + schemas
+ * @note "Too many states for serving" errors can occur with complex schemas + tools.
+ *       Solution: Simplify schema or use disableTools: true
  */
 export class GoogleAIStudioProvider extends BaseProvider {
     constructor(modelName, sdk) {

package/dist/providers/googleVertex.d.ts

@@ -13,6 +13,41 @@ import { BaseProvider } from "../core/baseProvider.js";
  * - Fresh model creation for each request
  * - Enhanced error handling with setup guidance
  * - Tool registration and context management
+ *
+ * @important Structured Output Limitation (Gemini Models Only)
+ * Google Gemini models on Vertex AI cannot combine function calling (tools) with
+ * structured output (JSON schema). When using schemas, you MUST set disableTools: true.
+ *
+ * Error without disableTools:
+ * "Function calling with a response mime type: 'application/json' is unsupported"
+ *
+ * This limitation ONLY affects Gemini models. Anthropic Claude models via Vertex
+ * AI do NOT have this limitation and support both tools + schemas simultaneously.
+ *
+ * @example Gemini models with schemas
+ * ```typescript
+ * const provider = new GoogleVertexProvider("gemini-2.5-flash");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" },
+ *   disableTools: true  // Required for Gemini models
+ * });
+ * ```
+ *
+ * @example Claude models (no limitation)
+ * ```typescript
+ * const provider = new GoogleVertexProvider("claude-3-5-sonnet-20241022");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" }
+ *   // No disableTools needed - Claude supports both
+ * });
+ * ```
+ *
+ * @note Gemini 3 Pro Preview (November 2025) will support combining tools + schemas
+ * @see https://cloud.google.com/vertex-ai/docs/generative-ai/learn/models
  */
 export declare class GoogleVertexProvider extends BaseProvider {
     private projectId;

package/dist/providers/googleVertex.js

@@ -234,6 +234,41 @@ const isAnthropicModel = (modelName) => {
  * - Fresh model creation for each request
  * - Enhanced error handling with setup guidance
  * - Tool registration and context management
+ *
+ * @important Structured Output Limitation (Gemini Models Only)
+ * Google Gemini models on Vertex AI cannot combine function calling (tools) with
+ * structured output (JSON schema). When using schemas, you MUST set disableTools: true.
+ *
+ * Error without disableTools:
+ * "Function calling with a response mime type: 'application/json' is unsupported"
+ *
+ * This limitation ONLY affects Gemini models. Anthropic Claude models via Vertex
+ * AI do NOT have this limitation and support both tools + schemas simultaneously.
+ *
+ * @example Gemini models with schemas
+ * ```typescript
+ * const provider = new GoogleVertexProvider("gemini-2.5-flash");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" },
+ *   disableTools: true  // Required for Gemini models
+ * });
+ * ```
+ *
+ * @example Claude models (no limitation)
+ * ```typescript
+ * const provider = new GoogleVertexProvider("claude-3-5-sonnet-20241022");
+ * const result = await provider.generate({
+ *   input: { text: "Analyze data" },
+ *   schema: MySchema,
+ *   output: { format: "json" }
+ *   // No disableTools needed - Claude supports both
+ * });
+ * ```
+ *
+ * @note Gemini 3 Pro Preview (November 2025) will support combining tools + schemas
+ * @see https://cloud.google.com/vertex-ai/docs/generative-ai/learn/models
  */
 export class GoogleVertexProvider extends BaseProvider {
     projectId;
@@ -1363,11 +1398,14 @@ export class GoogleVertexProvider extends BaseProvider {
     getModelSuggestions(requestedModel) {
         const availableModels = {
             google: [
+                "gemini-3-pro-preview-11-2025",
+                "gemini-3-pro-latest",
                 "gemini-3-pro-preview",
                 "gemini-2.5-pro",
                 "gemini-2.5-flash",
                 "gemini-2.5-flash-lite",
                 "gemini-2.0-flash-001",
+                "gemini-2.0-flash-lite",
                 "gemini-1.5-pro",
                 "gemini-1.5-flash",
             ],

package/dist/types/generateTypes.d.ts

@@ -34,9 +34,58 @@ export type GenerateOptions = {
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;
+    /**
+     * Zod schema for structured output validation
+     *
+     * @important Google Gemini Limitation
+     * Google Vertex AI and Google AI Studio cannot combine function calling with
+     * structured output. You MUST use `disableTools: true` when using schemas with
+     * Google providers.
+     *
+     * Error without disableTools: "Function calling with a response mime type:
+     * 'application/json' is unsupported"
+     *
+     * This is a documented Google API limitation, not a NeuroLink bug.
+     * All frameworks (LangChain, Vercel AI SDK, Agno, Instructor) use this approach.
+     *
+     * @example
+     * ```typescript
+     * // ✅ Correct for Google providers
+     * const result = await neurolink.generate({
+     *   schema: MySchema,
+     *   provider: "vertex",
+     *   disableTools: true  // Required for Google
+     * });
+     *
+     * // ✅ No restriction for other providers
+     * const result = await neurolink.generate({
+     *   schema: MySchema,
+     *   provider: "openai"  // Works without disableTools
+     * });
+     * ```
+     *
+     * @see https://ai.google.dev/gemini-api/docs/function-calling
+     */
     schema?: ValidationSchema;
     tools?: Record<string, Tool>;
     timeout?: number | string;
+    /**
+     * Disable tool execution (including built-in tools)
+     *
+     * @required For Google Gemini providers when using schemas
+     * Google Vertex AI and Google AI Studio require this flag when using
+     * structured output (schemas) due to Google API limitations.
+     *
+     * @example
+     * ```typescript
+     * // Required for Google providers with schemas
+     * await neurolink.generate({
+     *   schema: MySchema,
+     *   provider: "vertex",
+     *   disableTools: true
+     * });
+     * ```
+     */
     disableTools?: boolean;
     enableEvaluation?: boolean;
     enableAnalytics?: boolean;

package/dist/utils/messageBuilder.js

@@ -3,7 +3,7 @@
  * Centralized logic for building message arrays from TextGenerationOptions
  * Enhanced with multimodal support for images
  */
-import { CONVERSATION_INSTRUCTIONS } from "../config/conversationMemory.js";
+import { CONVERSATION_INSTRUCTIONS, STRUCTURED_OUTPUT_INSTRUCTIONS, } from "../config/conversationMemory.js";
 import { ProviderImageAdapter, MultimodalLogger, } from "../adapters/providerImageAdapter.js";
 import { logger } from "./logger.js";
 import { FileDetector } from "./fileDetector.js";
@@ -199,6 +199,15 @@ function formatCSVMetadata(metadata) {
     }
     return parts.length > 0 ? `**Metadata**: ${parts.join(" | ")}` : "";
 }
+/**
+ * Check if structured output mode should be enabled
+ * Structured output is used when a schema is provided with json/structured format
+ */
+function shouldUseStructuredOutput(options) {
+    return (!!options.schema &&
+        (options.output?.format === "json" ||
+            options.output?.format === "structured"));
+}
 /**
  * Build a properly formatted message array for AI providers
  * Combines system prompt, conversation history, and current user prompt
@@ -215,6 +224,10 @@ export async function buildMessagesArray(options) {
     if (hasConversationHistory) {
         systemPrompt = `${systemPrompt.trim()}${CONVERSATION_INSTRUCTIONS}`;
     }
+    // Add structured output instructions when schema is provided with json/structured format
+    if (shouldUseStructuredOutput(options)) {
+        systemPrompt = `${systemPrompt.trim()}${STRUCTURED_OUTPUT_INSTRUCTIONS}`;
+    }
     // Add system message if we have one
     if (systemPrompt.trim()) {
         messages.push({
@@ -473,6 +486,10 @@ export async function buildMultimodalMessagesArray(options, provider, model) {
     if (hasConversationHistory) {
         systemPrompt = `${systemPrompt.trim()}${CONVERSATION_INSTRUCTIONS}`;
     }
+    // Add structured output instructions when schema is provided with json/structured format
+    if (shouldUseStructuredOutput(options)) {
+        systemPrompt = `${systemPrompt.trim()}${STRUCTURED_OUTPUT_INSTRUCTIONS}`;
+    }
     // Add file handling guidance when multimodal files are present
     const hasCSVFiles = (options.input.csvFiles && options.input.csvFiles.length > 0) ||
         (options.input.files &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "8.5.0",
+  "version": "8.5.1",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 9 major providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",