@juspay/neurolink 9.3.0 → 9.4.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [9.4.0](https://github.com/juspay/neurolink/compare/v9.3.0...v9.4.0) (2026-02-09)
+
+### Features
+
+- **(workflow):** implement comprehensive workflow engine for multi-model orchestration ([9257385](https://github.com/juspay/neurolink/commit/9257385e4b961dd14e21f85250b4947be9c0e7b6))
+
 ## [9.3.0](https://github.com/juspay/neurolink/compare/v9.2.0...v9.3.0) (2026-02-08)
 
 ### Features

package/README.md

@@ -178,14 +178,14 @@ NeuroLink is a comprehensive AI development platform. Every feature below is pro
 
 **6 Core Tools** (work across all providers, zero configuration):
 
-| Tool                 | Purpose                  | Auto-Available          | Documentation                                             |
-| -------------------- | ------------------------ | ----------------------- | --------------------------------------------------------- |
-| `getCurrentTime`     | Real-time clock access   | ✅                      | [Tool Reference](docs/sdk/custom-tools.md#getCurrentTime) |
-| `readFile`           | File system reading      | ✅                      | [Tool Reference](docs/sdk/custom-tools.md#readFile)       |
-| `writeFile`          | File system writing      | ✅                      | [Tool Reference](docs/sdk/custom-tools.md#writeFile)      |
-| `listDirectory`      | Directory listing        | ✅                      | [Tool Reference](docs/sdk/custom-tools.md#listDirectory)  |
-| `calculateMath`      | Mathematical operations  | ✅                      | [Tool Reference](docs/sdk/custom-tools.md#calculateMath)  |
-| `websearchGrounding` | Google Vertex web search | ⚠️ Requires credentials | [Tool Reference](docs/sdk/custom-tools.md#websearch)      |
+| Tool                 | Purpose                  | Auto-Available          | Documentation                              |
+| -------------------- | ------------------------ | ----------------------- | ------------------------------------------ |
+| `getCurrentTime`     | Real-time clock access   | ✅                      | [Tool Reference](docs/sdk/custom-tools.md) |
+| `readFile`           | File system reading      | ✅                      | [Tool Reference](docs/sdk/custom-tools.md) |
+| `writeFile`          | File system writing      | ✅                      | [Tool Reference](docs/sdk/custom-tools.md) |
+| `listDirectory`      | Directory listing        | ✅                      | [Tool Reference](docs/sdk/custom-tools.md) |
+| `calculateMath`      | Mathematical operations  | ✅                      | [Tool Reference](docs/sdk/custom-tools.md) |
+| `websearchGrounding` | Google Vertex web search | ⚠️ Requires credentials | [Tool Reference](docs/sdk/custom-tools.md) |
 
 **58+ External MCP Servers** supported (GitHub, PostgreSQL, Google Drive, Slack, and more):
 

package/dist/cli/commands/config.d.ts

@@ -61,8 +61,8 @@ declare const ConfigSchema: z.ZodObject<{
             model?: string | undefined;
             projectId?: string | undefined;
             credentials?: string | undefined;
-            location?: string | undefined;
             privateKey?: string | undefined;
+            location?: string | undefined;
             serviceAccountKey?: string | undefined;
             clientEmail?: string | undefined;
         }>>;
@@ -201,8 +201,8 @@ declare const ConfigSchema: z.ZodObject<{
             model?: string | undefined;
             projectId?: string | undefined;
             credentials?: string | undefined;
-            location?: string | undefined;
             privateKey?: string | undefined;
+            location?: string | undefined;
             serviceAccountKey?: string | undefined;
             clientEmail?: string | undefined;
         } | undefined;
@@ -570,8 +570,8 @@ declare const ConfigSchema: z.ZodObject<{
             model?: string | undefined;
             projectId?: string | undefined;
             credentials?: string | undefined;
-            location?: string | undefined;
             privateKey?: string | undefined;
+            location?: string | undefined;
             serviceAccountKey?: string | undefined;
             clientEmail?: string | undefined;
         } | undefined;

package/dist/cli/index.js

@@ -26,6 +26,7 @@ catch {
     // Environment variables should be set externally in production
 }
 // Enhanced CLI with Professional UX
+// Note: Workflow functionality is accessed via generate/stream commands with --workflow-config option
 const cli = initializeCliParser();
 // Execute CLI
 (async () => {

package/dist/index.d.ts

@@ -244,6 +244,41 @@ export type { AnalyticsData, EvaluationData, TextGenerationOptions, TextGenerati
  * @since 1.0.0
  */
 export declare function generateText(options: import("./types/index.js").TextGenerationOptions): Promise<import("./types/index.js").TextGenerationResult>;
+/**
+ * Workflow Engine for multi-model ensembles with judge-based evaluation
+ *
+ * Enables sophisticated AI orchestration patterns:
+ * - Ensemble execution (parallel multi-model)
+ * - Chain execution (sequential fallback)
+ * - Adaptive execution (tier-based quality/cost optimization)
+ * - Multi-judge voting for consensus
+ *
+ * @example
+ * ```typescript
+ * import { neurolink, CONSENSUS_3_WORKFLOW } from '@juspay/neurolink';
+ *
+ * // Use workflow via generate() with workflowConfig option
+ * const result = await neurolink.generate({
+ *   input: { text: 'Explain quantum computing' },
+ *   workflowConfig: CONSENSUS_3_WORKFLOW,
+ * });
+ *
+ * console.log('Best response:', result.content);
+ * console.log('Selected model:', result.workflow?.selectedModel);
+ * console.log('Total time:', result.workflow?.metrics?.totalTime);
+ * ```
+ */
+export type { WorkflowConfig, WorkflowResult, ModelConfig, JudgeConfig, ModelGroup, EnsembleResponse, JudgeScores, MultiJudgeScores, WorkflowType, ExecutionStrategy, WorkflowValidationResult, } from "./workflow/types.js";
+export { runWorkflow } from "./workflow/core/workflowRunner.js";
+export type { RunWorkflowOptions } from "./workflow/core/workflowRunner.js";
+export { registerWorkflow, getWorkflow, listWorkflows, clearRegistry as clearWorkflowRegistry, } from "./workflow/core/workflowRegistry.js";
+export { CONSENSUS_3_WORKFLOW, CONSENSUS_3_FAST_WORKFLOW, createConsensus3WithPrompt, } from "./workflow/workflows/consensusWorkflow.js";
+export { FAST_FALLBACK_WORKFLOW, AGGRESSIVE_FALLBACK_WORKFLOW, } from "./workflow/workflows/fallbackWorkflow.js";
+export { MULTI_JUDGE_5_WORKFLOW, MULTI_JUDGE_3_WORKFLOW, createMultiJudgeWorkflow, } from "./workflow/workflows/multiJudgeWorkflow.js";
+export { QUALITY_MAX_WORKFLOW, SPEED_FIRST_WORKFLOW, BALANCED_ADAPTIVE_WORKFLOW, createAdaptiveWorkflow, } from "./workflow/workflows/adaptiveWorkflow.js";
+export { validateWorkflow } from "./workflow/utils/workflowValidation.js";
+export { calculateModelMetrics, compareWorkflows, generateSummaryStats, } from "./workflow/utils/workflowMetrics.js";
+export { WORKFLOW_ENGINE_VERSION, DEFAULT_SCORE_SCALE, } from "./workflow/index.js";
 export type { AgentExecuteRequest, AgentExecuteResponse, AuthConfig, AuthenticatedUser, AuthResult, AuthStrategy, BodyParserConfig, CacheConfig, CacheEntry, CacheStore, CORSConfig, CreateRoutesOptions, DataEvent, DataStreamEvent, DataStreamEventType, DataStreamResponseConfig, DataStreamWriter, DataStreamWriterConfig, ErrorCategoryType, ErrorEvent, ErrorResponse, ErrorSeverityType, FinishEvent, HealthResponse, HttpMethod, LoggingConfig, MCPServerStatusResponse, MiddlewareDefinition, MiddlewareHandler, OpenAPIGeneratorConfig, OpenAPISpec, PropertySchema, RateLimitConfig as ServerRateLimitConfig, RateLimitMiddlewareConfig, RateLimitStore, ReadyResponse, RequiredServerAdapterConfig, RouteDefinition, RouteGroup, RouteHandler, ServerAdapterConfig, ServerAdapterErrorCodeType, ServerAdapterErrorContext, ServerAdapterEvents, ServerAdapterFactoryOptions, ServerContext, ServerFramework, ServerResponse, ServerStatus, SSEWriteOptions, StreamingConfig, TextDeltaEvent, TextEndEvent, TextStartEvent, ToolCallEvent, ToolExecuteRequest, ToolExecuteResponse, ToolResultEvent, ValidationConfig, ValidationResult, ValidationSchema, WebSocketAuthConfig, WebSocketConfig, WebSocketConnection, WebSocketHandler, WebSocketMessage, WebSocketMessageType, } from "./server/index.js";
 /**
  * Server Adapters for exposing NeuroLink as HTTP APIs

package/dist/index.js

@@ -289,6 +289,23 @@ export async function generateText(options) {
     const neurolink = new NeuroLink();
     return await neurolink.generateText(options);
 }
+// Workflow execution
+export { runWorkflow } from "./workflow/core/workflowRunner.js";
+// Workflow registry
+export { registerWorkflow, getWorkflow, listWorkflows, clearRegistry as clearWorkflowRegistry, } from "./workflow/core/workflowRegistry.js";
+// Pre-built workflows - Consensus
+export { CONSENSUS_3_WORKFLOW, CONSENSUS_3_FAST_WORKFLOW, createConsensus3WithPrompt, } from "./workflow/workflows/consensusWorkflow.js";
+// Pre-built workflows - Fallback
+export { FAST_FALLBACK_WORKFLOW, AGGRESSIVE_FALLBACK_WORKFLOW, } from "./workflow/workflows/fallbackWorkflow.js";
+// Pre-built workflows - Multi-judge
+export { MULTI_JUDGE_5_WORKFLOW, MULTI_JUDGE_3_WORKFLOW, createMultiJudgeWorkflow, } from "./workflow/workflows/multiJudgeWorkflow.js";
+// Pre-built workflows - Adaptive
+export { QUALITY_MAX_WORKFLOW, SPEED_FIRST_WORKFLOW, BALANCED_ADAPTIVE_WORKFLOW, createAdaptiveWorkflow, } from "./workflow/workflows/adaptiveWorkflow.js";
+// Validation and metrics
+export { validateWorkflow } from "./workflow/utils/workflowValidation.js";
+export { calculateModelMetrics, compareWorkflows, generateSummaryStats, } from "./workflow/utils/workflowMetrics.js";
+// Workflow constants
+export { WORKFLOW_ENGINE_VERSION, DEFAULT_SCORE_SCALE, } from "./workflow/index.js";
 /**
  * Server Adapters for exposing NeuroLink as HTTP APIs
  *

package/dist/lib/agent/directTools.d.ts

@@ -221,11 +221,11 @@ export declare const directAgentTools: {
     }, "strip", z.ZodTypeAny, {
         content: string;
         path: string;
-        mode: "create" | "append" | "overwrite";
+        mode: "create" | "overwrite" | "append";
     }, {
         content: string;
         path: string;
-        mode?: "create" | "append" | "overwrite" | undefined;
+        mode?: "create" | "overwrite" | "append" | undefined;
     }>, {
         success: boolean;
         error: string;
@@ -236,7 +236,7 @@ export declare const directAgentTools: {
     } | {
         success: boolean;
         path: string;
-        mode: "create" | "append" | "overwrite";
+        mode: "create" | "overwrite" | "append";
         size: number;
         written: number;
         error?: undefined;
@@ -251,7 +251,7 @@ export declare const directAgentTools: {
         execute: (args: {
             content: string;
             path: string;
-            mode: "create" | "append" | "overwrite";
+            mode: "create" | "overwrite" | "append";
         }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
             success: boolean;
             error: string;
@@ -262,7 +262,7 @@ export declare const directAgentTools: {
         } | {
             success: boolean;
             path: string;
-            mode: "create" | "append" | "overwrite";
+            mode: "create" | "overwrite" | "append";
             size: number;
             written: number;
             error?: undefined;

package/dist/lib/index.d.ts

@@ -244,6 +244,41 @@ export type { AnalyticsData, EvaluationData, TextGenerationOptions, TextGenerati
  * @since 1.0.0
  */
 export declare function generateText(options: import("./types/index.js").TextGenerationOptions): Promise<import("./types/index.js").TextGenerationResult>;
+/**
+ * Workflow Engine for multi-model ensembles with judge-based evaluation
+ *
+ * Enables sophisticated AI orchestration patterns:
+ * - Ensemble execution (parallel multi-model)
+ * - Chain execution (sequential fallback)
+ * - Adaptive execution (tier-based quality/cost optimization)
+ * - Multi-judge voting for consensus
+ *
+ * @example
+ * ```typescript
+ * import { neurolink, CONSENSUS_3_WORKFLOW } from '@juspay/neurolink';
+ *
+ * // Use workflow via generate() with workflowConfig option
+ * const result = await neurolink.generate({
+ *   input: { text: 'Explain quantum computing' },
+ *   workflowConfig: CONSENSUS_3_WORKFLOW,
+ * });
+ *
+ * console.log('Best response:', result.content);
+ * console.log('Selected model:', result.workflow?.selectedModel);
+ * console.log('Total time:', result.workflow?.metrics?.totalTime);
+ * ```
+ */
+export type { WorkflowConfig, WorkflowResult, ModelConfig, JudgeConfig, ModelGroup, EnsembleResponse, JudgeScores, MultiJudgeScores, WorkflowType, ExecutionStrategy, WorkflowValidationResult, } from "./workflow/types.js";
+export { runWorkflow } from "./workflow/core/workflowRunner.js";
+export type { RunWorkflowOptions } from "./workflow/core/workflowRunner.js";
+export { registerWorkflow, getWorkflow, listWorkflows, clearRegistry as clearWorkflowRegistry, } from "./workflow/core/workflowRegistry.js";
+export { CONSENSUS_3_WORKFLOW, CONSENSUS_3_FAST_WORKFLOW, createConsensus3WithPrompt, } from "./workflow/workflows/consensusWorkflow.js";
+export { FAST_FALLBACK_WORKFLOW, AGGRESSIVE_FALLBACK_WORKFLOW, } from "./workflow/workflows/fallbackWorkflow.js";
+export { MULTI_JUDGE_5_WORKFLOW, MULTI_JUDGE_3_WORKFLOW, createMultiJudgeWorkflow, } from "./workflow/workflows/multiJudgeWorkflow.js";
+export { QUALITY_MAX_WORKFLOW, SPEED_FIRST_WORKFLOW, BALANCED_ADAPTIVE_WORKFLOW, createAdaptiveWorkflow, } from "./workflow/workflows/adaptiveWorkflow.js";
+export { validateWorkflow } from "./workflow/utils/workflowValidation.js";
+export { calculateModelMetrics, compareWorkflows, generateSummaryStats, } from "./workflow/utils/workflowMetrics.js";
+export { WORKFLOW_ENGINE_VERSION, DEFAULT_SCORE_SCALE, } from "./workflow/index.js";
 export type { AgentExecuteRequest, AgentExecuteResponse, AuthConfig, AuthenticatedUser, AuthResult, AuthStrategy, BodyParserConfig, CacheConfig, CacheEntry, CacheStore, CORSConfig, CreateRoutesOptions, DataEvent, DataStreamEvent, DataStreamEventType, DataStreamResponseConfig, DataStreamWriter, DataStreamWriterConfig, ErrorCategoryType, ErrorEvent, ErrorResponse, ErrorSeverityType, FinishEvent, HealthResponse, HttpMethod, LoggingConfig, MCPServerStatusResponse, MiddlewareDefinition, MiddlewareHandler, OpenAPIGeneratorConfig, OpenAPISpec, PropertySchema, RateLimitConfig as ServerRateLimitConfig, RateLimitMiddlewareConfig, RateLimitStore, ReadyResponse, RequiredServerAdapterConfig, RouteDefinition, RouteGroup, RouteHandler, ServerAdapterConfig, ServerAdapterErrorCodeType, ServerAdapterErrorContext, ServerAdapterEvents, ServerAdapterFactoryOptions, ServerContext, ServerFramework, ServerResponse, ServerStatus, SSEWriteOptions, StreamingConfig, TextDeltaEvent, TextEndEvent, TextStartEvent, ToolCallEvent, ToolExecuteRequest, ToolExecuteResponse, ToolResultEvent, ValidationConfig, ValidationResult, ValidationSchema, WebSocketAuthConfig, WebSocketConfig, WebSocketConnection, WebSocketHandler, WebSocketMessage, WebSocketMessageType, } from "./server/index.js";
 /**
  * Server Adapters for exposing NeuroLink as HTTP APIs

package/dist/lib/index.js

@@ -289,6 +289,23 @@ export async function generateText(options) {
     const neurolink = new NeuroLink();
     return await neurolink.generateText(options);
 }
+// Workflow execution
+export { runWorkflow } from "./workflow/core/workflowRunner.js";
+// Workflow registry
+export { registerWorkflow, getWorkflow, listWorkflows, clearRegistry as clearWorkflowRegistry, } from "./workflow/core/workflowRegistry.js";
+// Pre-built workflows - Consensus
+export { CONSENSUS_3_WORKFLOW, CONSENSUS_3_FAST_WORKFLOW, createConsensus3WithPrompt, } from "./workflow/workflows/consensusWorkflow.js";
+// Pre-built workflows - Fallback
+export { FAST_FALLBACK_WORKFLOW, AGGRESSIVE_FALLBACK_WORKFLOW, } from "./workflow/workflows/fallbackWorkflow.js";
+// Pre-built workflows - Multi-judge
+export { MULTI_JUDGE_5_WORKFLOW, MULTI_JUDGE_3_WORKFLOW, createMultiJudgeWorkflow, } from "./workflow/workflows/multiJudgeWorkflow.js";
+// Pre-built workflows - Adaptive
+export { QUALITY_MAX_WORKFLOW, SPEED_FIRST_WORKFLOW, BALANCED_ADAPTIVE_WORKFLOW, createAdaptiveWorkflow, } from "./workflow/workflows/adaptiveWorkflow.js";
+// Validation and metrics
+export { validateWorkflow } from "./workflow/utils/workflowValidation.js";
+export { calculateModelMetrics, compareWorkflows, generateSummaryStats, } from "./workflow/utils/workflowMetrics.js";
+// Workflow constants
+export { WORKFLOW_ENGINE_VERSION, DEFAULT_SCORE_SCALE, } from "./workflow/index.js";
 /**
  * Server Adapters for exposing NeuroLink as HTTP APIs
  *

package/dist/lib/neurolink.d.ts

@@ -5,6 +5,7 @@
  * Enhanced AI provider system with natural MCP tool access.
  * Uses real MCP infrastructure for tool discovery and execution.
  */
+import type { TextGenerationOptions, TextGenerationResult } from "./types/index.js";
 import type { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
 import type { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
 import { ExternalServerManager } from "./mcp/externalServerManager.js";
@@ -14,7 +15,7 @@ import type { NeurolinkConstructorConfig } from "./types/configTypes.js";
 import type { ChatMessage } from "./types/conversation.js";
 import type { ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo } from "./types/externalMcp.js";
 import type { GenerateOptions, GenerateResult } from "./types/generateTypes.js";
-import type { ProviderStatus, TextGenerationOptions, TextGenerationResult } from "./types/index.js";
+import type { ProviderStatus } from "./types/index.js";
 import type { MCPExecutableTool, MCPServerInfo, MCPStatus } from "./types/mcpTypes.js";
 import type { ObservabilityConfig } from "./types/observability.js";
 import type { StreamOptions, StreamResult } from "./types/streamTypes.js";
@@ -454,6 +455,16 @@ export declare class NeuroLink {
      * @since 1.0.0
      */
     generate(optionsOrPrompt: GenerateOptions | string): Promise<GenerateResult>;
+    /**
+     * Generate with workflow engine integration
+     * Returns both original and processed responses for AB testing
+     */
+    private generateWithWorkflow;
+    /**
+     * Stream with workflow engine integration
+     * Progressive streaming: yields preliminary response (first model) then final synthesis
+     */
+    private streamWithWorkflow;
     /**
      * BACKWARD COMPATIBILITY: Legacy generateText method
      * Internally calls generate() and converts result format

package/dist/lib/neurolink.js

@@ -14,6 +14,7 @@ catch {
     // Environment variables should be set externally in production
 }
 import { EventEmitter } from "events";
+import { isNonNullObject } from "./utils/typeUtils.js";
 import pLimit from "p-limit";
 import { CIRCUIT_BREAKER, CIRCUIT_BREAKER_RESET_MS, MEMORY_THRESHOLDS, NANOSECOND_TO_MS_DIVISOR, PERFORMANCE_THRESHOLDS, PROVIDER_TIMEOUTS, RETRY_ATTEMPTS, RETRY_DELAYS, TOOL_TIMEOUTS, } from "./constants/index.js";
 import { SYSTEM_LIMITS } from "./core/constants.js";
@@ -41,7 +42,9 @@ import { BinaryTaskClassifier } from "./utils/taskClassifier.js";
 // Tool detection and execution imports
 // Transformation utilities
 import { extractToolNames, optimizeToolForCollection, transformAvailableTools, transformParamsForLogging, transformToolExecutions, transformToolExecutionsForMCP, transformToolsForMCP, transformToolsToDescriptions, transformToolsToExpectedFormat, } from "./utils/transformationUtils.js";
-import { isNonNullObject } from "./utils/typeUtils.js";
+import { runWorkflow } from "./workflow/core/workflowRunner.js";
+import { getWorkflow } from "./workflow/core/workflowRegistry.js";
+// Core types imported from core/types.js
 /**
  * NeuroLink - Universal AI Development Platform
  *
@@ -1148,9 +1151,19 @@ Current user's request: ${currentInput}`;
      * @returns The original prompt text as a string.
      */
     _extractOriginalPrompt(optionsOrPrompt) {
-        return typeof optionsOrPrompt === "string"
-            ? optionsOrPrompt
-            : optionsOrPrompt.input.text;
+        if (typeof optionsOrPrompt === "string") {
+            return optionsOrPrompt;
+        }
+        // Handle messages format (for workflow compatibility)
+        const anyOptions = optionsOrPrompt;
+        if (anyOptions.messages && anyOptions.messages.length > 0) {
+            const lastMessage = anyOptions.messages[anyOptions.messages.length - 1];
+            return typeof lastMessage.content === "string"
+                ? lastMessage.content
+                : JSON.stringify(lastMessage.content);
+        }
+        // Handle input.text format
+        return optionsOrPrompt.input?.text || "";
     }
     /**
      * Generate AI content using the best available provider with MCP tool integration.
@@ -1377,6 +1390,10 @@ Current user's request: ${currentInput}`;
         if (!options.input?.text || typeof options.input.text !== "string") {
             throw new Error("Input text is required and must be a non-empty string");
         }
+        // Check if workflow is requested
+        if (options.workflow || options.workflowConfig) {
+            return await this.generateWithWorkflow(options);
+        }
         // Set session and user IDs from context for Langfuse spans and execute with proper async scoping
         return await this.setLangfuseContextFromOptions(options, async () => {
             if (this.conversationMemoryConfig?.conversationMemory?.mem0Enabled &&
@@ -1602,6 +1619,246 @@ Current user's request: ${currentInput}`;
             return generateResult;
         });
     }
+    /**
+     * Generate with workflow engine integration
+     * Returns both original and processed responses for AB testing
+     */
+    async generateWithWorkflow(options) {
+        const workflowStartTime = Date.now();
+        logger.debug("[NeuroLink] Executing workflow generation", {
+            workflowId: options.workflow,
+            hasInlineConfig: !!options.workflowConfig,
+            prompt: options.input.text.substring(0, 100),
+            startTime: workflowStartTime,
+        });
+        // Determine workflow configuration
+        let workflowConfig;
+        if (options.workflowConfig) {
+            // Use inline config
+            workflowConfig = options.workflowConfig;
+        }
+        else if (options.workflow) {
+            // Look up predefined workflow
+            workflowConfig = getWorkflow(options.workflow);
+            if (!workflowConfig) {
+                throw new Error(`Workflow '${options.workflow}' not found in registry`);
+            }
+        }
+        else {
+            throw new Error("Either workflow or workflowConfig must be provided");
+        }
+        // Execute workflow
+        const workflowResult = await runWorkflow(workflowConfig, {
+            prompt: options.input.text,
+            conversationHistory: options.conversationHistory,
+            timeout: options.timeout,
+            verbose: false,
+            metadata: options.context,
+        });
+        // Build GenerateResult with workflow data
+        const generateResult = {
+            // Primary output (backward compatible) - use the original best response
+            content: workflowResult.content,
+            // Provider info from selected response
+            provider: workflowResult.selectedResponse?.provider ||
+                workflowConfig.models[0]?.provider,
+            model: workflowResult.selectedResponse?.model ||
+                workflowConfig.models[0]?.model,
+            // Basic usage info
+            usage: workflowResult.usage
+                ? {
+                    input: workflowResult.usage.totalInputTokens,
+                    output: workflowResult.usage.totalOutputTokens,
+                    total: workflowResult.usage.totalTokens,
+                }
+                : undefined,
+            // Performance
+            responseTime: workflowResult.totalTime,
+            // Workflow-specific data
+            workflow: {
+                originalResponse: workflowResult.originalContent || workflowResult.content, // Original unmodified best response
+                processedResponse: workflowResult.content, // After conditioning (with metadata)
+                ensembleResponses: workflowResult.ensembleResponses.map((r) => ({
+                    provider: r.provider,
+                    model: r.model,
+                    content: r.content,
+                    responseTime: r.responseTime,
+                    status: r.status,
+                    error: r.error,
+                })),
+                judgeScores: workflowResult.judgeScores
+                    ? {
+                        scores: workflowResult.judgeScores.scores,
+                        reasoning: workflowResult.reasoning,
+                        selectedModel: `${workflowResult.selectedResponse?.provider}-${workflowResult.selectedResponse?.model}`,
+                    }
+                    : undefined,
+                selectedModel: `${workflowResult.selectedResponse?.provider}-${workflowResult.selectedResponse?.model}`,
+                metrics: {
+                    totalTime: workflowResult.totalTime,
+                    ensembleTime: workflowResult.ensembleTime,
+                    judgeTime: workflowResult.judgeTime,
+                    conditioningTime: workflowResult.conditioningTime,
+                },
+                workflowId: workflowResult.workflow,
+                workflowName: workflowResult.workflowName,
+            },
+        };
+        logger.debug("[NeuroLink] Workflow generation complete", {
+            workflowId: workflowResult.workflow,
+            selectedModel: generateResult.workflow?.selectedModel,
+            score: workflowResult.score,
+            totalTime: workflowResult.totalTime,
+        });
+        return generateResult;
+    }
+    /**
+     * Stream with workflow engine integration
+     * Progressive streaming: yields preliminary response (first model) then final synthesis
+     */
+    async streamWithWorkflow(options, startTime) {
+        logger.debug("[NeuroLink] Executing workflow streaming (progressive)", {
+            workflowId: options.workflow,
+            hasInlineConfig: !!options.workflowConfig,
+            prompt: options.input.text.substring(0, 100),
+        });
+        // Determine workflow configuration
+        let workflowConfig;
+        if (options.workflowConfig) {
+            workflowConfig = options.workflowConfig;
+        }
+        else if (options.workflow) {
+            workflowConfig = getWorkflow(options.workflow);
+            if (!workflowConfig) {
+                throw new Error(`Workflow '${options.workflow}' not found in registry`);
+            }
+        }
+        else {
+            throw new Error("Either workflow or workflowConfig must be provided");
+        }
+        // Import streaming workflow runner
+        const { runWorkflowWithStreaming } = await import("./workflow/core/workflowRunner.js");
+        // Execute workflow with progressive streaming
+        const workflowStream = runWorkflowWithStreaming(workflowConfig, {
+            prompt: options.input.text,
+            conversationHistory: options.conversationHistory,
+            timeout: options.timeout,
+            verbose: false,
+            metadata: options.context,
+            streaming: true,
+        });
+        // Store final result for metadata
+        let finalResult = null;
+        let preliminaryTime = 0;
+        // Create a generator that yields progressive chunks
+        const stream = (async function* () {
+            for await (const chunk of workflowStream) {
+                if (chunk.type === "preliminary") {
+                    preliminaryTime = Date.now() - startTime;
+                    logger.debug("[NeuroLink] Streaming preliminary response", {
+                        responseTime: preliminaryTime,
+                        contentLength: chunk.content.length,
+                    });
+                    yield {
+                        content: chunk.content,
+                        type: "preliminary",
+                    };
+                }
+                else if (chunk.type === "final") {
+                    finalResult = chunk.partialResult ?? null;
+                    const finalTime = Date.now() - startTime;
+                    logger.debug("[NeuroLink] Streaming final synthesis", {
+                        responseTime: finalTime,
+                        contentLength: chunk.content.length,
+                    });
+                    yield {
+                        content: chunk.content,
+                        type: "final",
+                    };
+                }
+            }
+        })();
+        const streamResult = {
+            stream,
+            // Provider info (will be from final result)
+            provider: workflowConfig.models[0]?.provider,
+            model: workflowConfig.models[0]?.model,
+            // Metadata
+            metadata: {
+                streamId: `workflow-${workflowConfig.id}-${Date.now()}`,
+                startTime,
+                responseTime: 0, // Will be updated after stream completes
+            },
+            // Note: Workflow data will be populated after stream completes
+            // For now, return placeholder that will be updated via stream metadata
+        };
+        // Wrap stream to capture final result and populate metadata
+        const originalStream = streamResult.stream;
+        streamResult.stream = (async function* () {
+            for await (const chunk of originalStream) {
+                yield chunk;
+            }
+            // After stream completes, update result with final workflow data
+            if (finalResult) {
+                const result = finalResult;
+                const responseTime = Date.now() - startTime;
+                // Update usage if available
+                if (result.usage) {
+                    streamResult.usage = {
+                        input: result.usage.totalInputTokens,
+                        output: result.usage.totalOutputTokens,
+                        total: result.usage.totalTokens,
+                    };
+                }
+                // Update metadata
+                streamResult.metadata = {
+                    ...streamResult.metadata,
+                    totalChunks: 2, // Preliminary + final
+                    responseTime,
+                    preliminaryTime,
+                };
+                // Build workflow data with proper type safety
+                const ensembleResponses = result.ensembleResponses?.map((r) => ({
+                    provider: r.provider,
+                    model: r.model,
+                    content: r.content,
+                    responseTime: r.responseTime,
+                    status: r.status,
+                    error: r.error,
+                })) ?? [];
+                const judgeScores = result.judgeScores
+                    ? {
+                        scores: result.judgeScores.scores,
+                        reasoning: result.reasoning ?? "",
+                        selectedModel: result.selectedResponse
+                            ? `${result.selectedResponse.provider}-${result.selectedResponse.model}`
+                            : "unknown",
+                    }
+                    : undefined;
+                streamResult.workflow = {
+                    originalResponse: result.originalContent ?? result.content ?? "",
+                    processedResponse: result.content ?? "",
+                    ensembleResponses,
+                    judgeScores,
+                    selectedModel: result.selectedResponse
+                        ? `${result.selectedResponse.provider}-${result.selectedResponse.model}`
+                        : "unknown",
+                    metrics: {
+                        totalTime: result.totalTime ?? responseTime,
+                        ensembleTime: result.ensembleTime ?? 0,
+                        judgeTime: result.judgeTime,
+                        conditioningTime: result.conditioningTime,
+                    },
+                    workflowId: result.workflow ?? workflowConfig.id,
+                    workflowName: result.workflowName ?? workflowConfig.name,
+                };
+            }
+        })();
+        logger.debug("[NeuroLink] Workflow streaming initialized", {
+            workflowId: workflowConfig.id,
+        });
+        return streamResult;
+    }
     /**
      * BACKWARD COMPATIBILITY: Legacy generateText method
      * Internally calls generate() and converts result format
@@ -2135,6 +2392,10 @@ Current user's request: ${currentInput}`;
         const originalPrompt = options.input.text; // Store the original prompt for memory storage
         await this.validateStreamInput(options);
         this.emitStreamStartEvents(options, startTime);
+        // Check if workflow is requested
+        if (options.workflow || options.workflowConfig) {
+            return await this.streamWithWorkflow(options, startTime);
+        }
         // Set session and user IDs from context for Langfuse spans and execute with proper async scoping
         return await this.setLangfuseContextFromOptions(options, async () => {
             let enhancedOptions;