@juspay/neurolink 7.53.3 → 7.53.4

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [7.53.4](https://github.com/juspay/neurolink/compare/v7.53.3...v7.53.4) (2025-11-05)
+
+### Bug Fixes
+
+- **(sdk):** structured object response in generate function ([f16d597](https://github.com/juspay/neurolink/commit/f16d597f8e9a64f24a7a6ad5344c93add524c23d))
+
 ## [7.53.3](https://github.com/juspay/neurolink/compare/v7.53.2...v7.53.3) (2025-11-03)
 
 ## [7.53.2](https://github.com/juspay/neurolink/compare/v7.53.1...v7.53.2) (2025-10-28)

package/README.md

@@ -25,6 +25,7 @@ Extracted from production systems at Juspay and battle-tested at enterprise scal
 
 ## What's New (Q4 2025)
 
+- **Structured Output with Zod Schemas** – Type-safe JSON generation with automatic validation using `schema` + `output.format: "json"` in `generate()`. → [Structured Output Guide](docs/features/structured-output.md)
 - **CSV File Support** – Attach CSV files to prompts for AI-powered data analysis with auto-detection. → [CSV Guide](docs/features/multimodal-chat.md#csv-file-support)
 - **PDF File Support** – Process PDF documents with native visual analysis for Vertex AI, Anthropic, Bedrock, AI Studio. → [PDF Guide](docs/features/pdf-support.md)
 - **LiteLLM Integration** – Access 100+ AI models from all major providers through unified interface. → [Setup Guide](docs/LITELLM-INTEGRATION.md)

package/dist/cli/loop/optionsSchema.js

@@ -24,6 +24,11 @@ export const textGenerationOptionsSchema = {
         type: "number",
         description: "The maximum number of tokens to generate.",
     },
+    output: {
+        type: "string",
+        description: "AI response format - specify just the format value (e.g., 'json', 'structured'). Note: This is automatically transformed to { format: value } for the API.",
+        allowedValues: ["text", "json", "structured", "none"],
+    },
     systemPrompt: {
         type: "string",
         description: "The system prompt to guide the AI's behavior.",

package/dist/core/baseProvider.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { generateText, tool as createAISDKTool, jsonSchema } from "ai";
+import { generateText, tool as createAISDKTool, jsonSchema, Output } from "ai";
 import { AIProviderName } from "../constants/enums.js";
 import { MiddlewareFactory } from "../middleware/factory.js";
 import { logger } from "../utils/logger.js";
@@ -301,6 +301,9 @@ export class BaseProvider {
      */
     async executeGeneration(model, messages, tools, options) {
         const shouldUseTools = !options.disableTools && this.supportsTools();
+        const useStructuredOutput = !!options.schema &&
+            (options.output?.format === "json" ||
+                options.output?.format === "structured");
         return await generateText({
             model,
             messages,
@@ -309,6 +312,10 @@ export class BaseProvider {
             toolChoice: shouldUseTools ? "auto" : "none",
             temperature: options.temperature,
             maxTokens: options.maxTokens,
+            ...(useStructuredOutput &&
+                options.schema && {
+                experimental_output: Output.object({ schema: options.schema }),
+            }),
             experimental_telemetry: this.getStreamTelemetryConfig(options, "generate"),
             onStepFinish: ({ toolCalls, toolResults }) => {
                 logger.info("Tool execution completed", { toolResults, toolCalls });
@@ -439,9 +446,17 @@ export class BaseProvider {
     /**
      * Format the enhanced result
      */
-    formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions) {
+    formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions, options) {
+        // Only access experimental_output if we set a schema
+        // (accessing it when not set throws an error)
+        const useStructuredOutput = !!options.schema &&
+            (options.output?.format === "json" ||
+                options.output?.format === "structured");
+        const content = useStructuredOutput
+            ? JSON.stringify(generateResult.experimental_output)
+            : generateResult.text;
         return {
-            content: generateResult.text,
+            content,
             usage: {
                 input: generateResult.usage?.promptTokens || 0,
                 output: generateResult.usage?.completionTokens || 0,
@@ -579,7 +594,7 @@ export class BaseProvider {
             const responseTime = Date.now() - startTime;
             await this.recordPerformanceMetrics(generateResult.usage, responseTime);
             const { toolsUsed, toolExecutions } = this.extractToolInformation(generateResult);
-            const enhancedResult = this.formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions);
+            const enhancedResult = this.formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions, options);
             return await this.enhanceResult(enhancedResult, options, startTime);
         }
         catch (error) {

package/dist/lib/core/baseProvider.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { generateText, tool as createAISDKTool, jsonSchema } from "ai";
+import { generateText, tool as createAISDKTool, jsonSchema, Output } from "ai";
 import { AIProviderName } from "../constants/enums.js";
 import { MiddlewareFactory } from "../middleware/factory.js";
 import { logger } from "../utils/logger.js";
@@ -301,6 +301,9 @@ export class BaseProvider {
      */
     async executeGeneration(model, messages, tools, options) {
         const shouldUseTools = !options.disableTools && this.supportsTools();
+        const useStructuredOutput = !!options.schema &&
+            (options.output?.format === "json" ||
+                options.output?.format === "structured");
         return await generateText({
             model,
             messages,
@@ -309,6 +312,10 @@ export class BaseProvider {
             toolChoice: shouldUseTools ? "auto" : "none",
             temperature: options.temperature,
             maxTokens: options.maxTokens,
+            ...(useStructuredOutput &&
+                options.schema && {
+                experimental_output: Output.object({ schema: options.schema }),
+            }),
             experimental_telemetry: this.getStreamTelemetryConfig(options, "generate"),
             onStepFinish: ({ toolCalls, toolResults }) => {
                 logger.info("Tool execution completed", { toolResults, toolCalls });
@@ -439,9 +446,17 @@ export class BaseProvider {
     /**
      * Format the enhanced result
      */
-    formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions) {
+    formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions, options) {
+        // Only access experimental_output if we set a schema
+        // (accessing it when not set throws an error)
+        const useStructuredOutput = !!options.schema &&
+            (options.output?.format === "json" ||
+                options.output?.format === "structured");
+        const content = useStructuredOutput
+            ? JSON.stringify(generateResult.experimental_output)
+            : generateResult.text;
         return {
-            content: generateResult.text,
+            content,
             usage: {
                 input: generateResult.usage?.promptTokens || 0,
                 output: generateResult.usage?.completionTokens || 0,
@@ -579,7 +594,7 @@ export class BaseProvider {
             const responseTime = Date.now() - startTime;
             await this.recordPerformanceMetrics(generateResult.usage, responseTime);
             const { toolsUsed, toolExecutions } = this.extractToolInformation(generateResult);
-            const enhancedResult = this.formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions);
+            const enhancedResult = this.formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions, options);
             return await this.enhanceResult(enhancedResult, options, startTime);
         }
         catch (error) {

package/dist/lib/neurolink.js

@@ -1221,6 +1221,8 @@ export class NeuroLink {
             temperature: options.temperature,
             maxTokens: options.maxTokens,
             systemPrompt: options.systemPrompt,
+            schema: options.schema,
+            output: options.output,
             disableTools: options.disableTools,
             enableAnalytics: options.enableAnalytics,
             enableEvaluation: options.enableEvaluation,

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

@@ -157,6 +157,9 @@ export type TextGenerationOptions = {
     maxTokens?: number;
     systemPrompt?: string;
     schema?: ZodUnknownSchema | Schema<unknown>;
+    output?: {
+        format?: "text" | "structured" | "json";
+    };
     tools?: Record<string, Tool>;
     timeout?: number | string;
     disableTools?: boolean;

package/dist/neurolink.js

@@ -1221,6 +1221,8 @@ export class NeuroLink {
             temperature: options.temperature,
             maxTokens: options.maxTokens,
             systemPrompt: options.systemPrompt,
+            schema: options.schema,
+            output: options.output,
             disableTools: options.disableTools,
             enableAnalytics: options.enableAnalytics,
             enableEvaluation: options.enableEvaluation,

package/dist/types/generateTypes.d.ts

@@ -157,6 +157,9 @@ export type TextGenerationOptions = {
     maxTokens?: number;
     systemPrompt?: string;
     schema?: ZodUnknownSchema | Schema<unknown>;
+    output?: {
+        format?: "text" | "structured" | "json";
+    };
     tools?: Record<string, Tool>;
     timeout?: number | string;
     disableTools?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "7.53.3",
+  "version": "7.53.4",
   "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",