@juspay/neurolink 9.15.0 → 9.17.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [9.17.0](https://github.com/juspay/neurolink/compare/v9.16.0...v9.17.0) (2026-03-06)
+
+### Features
+
+- **(landing):** nervous-system landing page redesign, docs overhaul, and SDK fixes ([fe756b3](https://github.com/juspay/neurolink/commit/fe756b393c0376f6c37fbab6c59ec2b31330a59f))
+
+## [9.16.0](https://github.com/juspay/neurolink/compare/v9.15.0...v9.16.0) (2026-03-02)
+
+### Features
+
+- **(sdk):** add models, observability, RAG enhancements, landing overhaul, and 45 review fixes ([eb79a1f](https://github.com/juspay/neurolink/commit/eb79a1f51dfd789da49130b6a05fa40ed38fd668))
+
 ## [9.15.0](https://github.com/juspay/neurolink/compare/v9.14.0...v9.15.0) (2026-03-01)
 
 ### Features

package/README.md

@@ -1,23 +1,25 @@
-<div align="center">
-  <h1>🧠 NeuroLink</h1>
-  <p><strong>The Enterprise AI SDK for Production Applications</strong></p>
-  <p>13 Providers | 58+ MCP Tools | HITL Security | Redis Persistence</p>
-</div>
-
-<div align="center">
-
-[![npm version](https://badge.fury.io/js/%40juspay%2Fneurolink.svg)](https://www.npmjs.com/package/@juspay/neurolink)
-[![npm downloads](https://img.shields.io/npm/dw/@juspay/neurolink)](https://www.npmjs.com/package/@juspay/neurolink)
-[![Build Status](https://github.com/juspay/neurolink/actions/workflows/ci.yml/badge.svg)](https://github.com/juspay/neurolink/actions/workflows/ci.yml)
-[![Coverage Status](https://coveralls.io/repos/github/juspay/neurolink/badge.svg?branch=main)](https://coveralls.io/github/juspay/neurolink?branch=main)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
-[![GitHub Stars](https://img.shields.io/github/stars/juspay/neurolink)](https://github.com/juspay/neurolink/stargazers)
-[![Discord](https://img.shields.io/discord/DISCORD_SERVER_ID?label=Discord&logo=discord)](https://discord.gg/neurolink)
-
-</div>
-
-Enterprise AI development platform with unified provider access, production-ready tooling, and an opinionated factory architecture. NeuroLink ships as both a TypeScript SDK and a professional CLI so teams can build, operate, and iterate on AI features quickly.
+# NeuroLink
+
+**The pipe layer for the AI nervous system.**
+
+AI intelligence flows as streams — tokens, tool calls, memory, voice, documents.
+NeuroLink is the vascular layer that carries these streams from where they are
+generated (LLM providers: the neurons) to where they are needed (connectors: the organs).
+
+```typescript
+import { NeuroLink } from "@juspay/neurolink";
+
+const pipe = new NeuroLink({ defaultProvider: "anthropic" });
+
+// Everything is a stream
+for await (const token of pipe.stream({ prompt: "Hello" })) {
+  process.stdout.write(token);
+}
+```
+
+**[→ Docs](https://docs.neurolink.ink) · [→ Quick Start](https://docs.neurolink.ink/docs/getting-started/quick-start) · [→ npm](https://www.npmjs.com/package/@juspay/neurolink)**
+
+---
 
 ## 🧠 What is NeuroLink?
 

package/dist/adapters/video/videoAnalyzer.d.ts

@@ -1,7 +1,7 @@
 /**
  * Video Analysis Handler
  *
- * Provides video analysis using Google's Gemini 2.0 Flash model.
+ * Provides video analysis using Google's Gemini 2.5 Flash model.
  * Supports both Vertex AI and Gemini API providers.
  *
  * @module adapters/video/geminiVideoAnalyzer

package/dist/adapters/video/videoAnalyzer.js

@@ -1,7 +1,7 @@
 /**
  * Video Analysis Handler
  *
- * Provides video analysis using Google's Gemini 2.0 Flash model.
+ * Provides video analysis using Google's Gemini 2.5 Flash model.
  * Supports both Vertex AI and Gemini API providers.
  *
  * @module adapters/video/geminiVideoAnalyzer
@@ -13,7 +13,7 @@ import { NeuroLinkError, ErrorFactory } from "../../utils/errorHandling.js";
 // ---------------------------------------------------------------------------
 // Shared config
 // ---------------------------------------------------------------------------
-const DEFAULT_MODEL = "gemini-2.0-flash";
+const DEFAULT_MODEL = "gemini-2.5-flash";
 const DEFAULT_LOCATION = "us-central1";
 /**
  * Extract content items from user messages
@@ -223,14 +223,16 @@ async function getVertexConfig() {
 }
 export async function analyzeVideo(messages, options = {}) {
     const provider = options.provider || AIProviderName.AUTO;
-    // Vertex — only when GOOGLE_VERTEX_PROJECT is explicitly set
-    if (provider === AIProviderName.VERTEX || provider === AIProviderName.AUTO) {
+    // Vertex — only when Vertex credentials are configured
+    if (provider === AIProviderName.VERTEX ||
+        (provider === AIProviderName.AUTO &&
+            (process.env.GOOGLE_VERTEX_PROJECT || process.env.GOOGLE_CLOUD_PROJECT))) {
         return analyzeVideoWithVertexAI(messages, options);
     }
-    // Gemini API — when GOOGLE_AI_API_KEY is set
-    if (provider === AIProviderName.GOOGLE_AI && process.env.GOOGLE_AI_API_KEY) {
+    // Gemini API — when Google AI API key is available
+    if (provider === AIProviderName.GOOGLE_AI ||
+        (provider === AIProviderName.AUTO && process.env.GOOGLE_AI_API_KEY)) {
         return analyzeVideoWithGeminiAPI(messages, options);
     }
-    throw new Error("No valid provider configuration found. " +
-        "Set GOOGLE_VERTEX_PROJECT for Vertex AI or GOOGLE_AI_API_KEY for Gemini API.");
+    throw ErrorFactory.invalidConfiguration("video analysis provider", "No valid provider configuration found. Set GOOGLE_VERTEX_PROJECT for Vertex AI or GOOGLE_AI_API_KEY for Gemini API.");
 }

package/dist/cli/commands/setup-anthropic.js

@@ -16,6 +16,7 @@ import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
 import { AIProviderName } from "../../lib/types/index.js";
+import { maskCredential } from "../utils/maskCredential.js";
 export async function handleAnthropicSetup(argv) {
     try {
         const options = {
@@ -365,20 +366,6 @@ async function updateEnvFile(config) {
         throw error;
     }
 }
-/**
- * Mask API key for display
- */
-function maskCredential(credential) {
-    if (!credential || credential.length < 8) {
-        return "****";
-    }
-    const knownPrefixes = ["sk-ant-"];
-    const prefix = knownPrefixes.find((p) => credential.startsWith(p)) ??
-        credential.slice(0, 3);
-    const end = credential.slice(-4);
-    const stars = "*".repeat(Math.max(4, credential.length - prefix.length - 4));
-    return `${prefix}${stars}${end}`;
-}
 /**
  * Show usage example
  */

package/dist/cli/commands/setup-azure.js

@@ -16,6 +16,7 @@ import { logger } from "../../lib/utils/logger.js";
 import { updateEnvFile as updateEnvFileShared, displayEnvUpdateSummary, } from "../utils/envManager.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
 import { AIProviderName } from "../../lib/types/index.js";
+import { maskCredential } from "../utils/maskCredential.js";
 export async function handleAzureSetup(argv) {
     try {
         const options = {
@@ -372,18 +373,6 @@ async function updateEnvFileWithConfig(config) {
         throw error;
     }
 }
-/**
- * Mask API key for display
- */
-function maskCredential(credential) {
-    if (!credential || credential.length < 8) {
-        return "****";
-    }
-    const start = credential.slice(0, 4);
-    const end = credential.slice(-4);
-    const middle = "*".repeat(Math.max(4, credential.length - 8));
-    return `${start}${middle}${end}`;
-}
 /**
  * Show usage example
  */

package/dist/cli/commands/setup-bedrock.js

@@ -15,6 +15,7 @@ import { logger } from "../../lib/utils/logger.js";
 import { updateEnvFile as envUpdate } from "../utils/envManager.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
 import { AIProviderName } from "../../lib/types/index.js";
+import { maskCredential } from "../utils/maskCredential.js";
 export async function handleBedrockSetup(argv) {
     try {
         const options = {
@@ -453,13 +454,4 @@ function displayUsageExample() {
     logger.always(chalk.green("🚀 You can now use AWS Bedrock with the NeuroLink CLI:"));
     logger.always(chalk.cyan("   pnpm cli generate 'Hello from Bedrock!' --provider bedrock"));
 }
-function maskCredential(credential) {
-    if (!credential || credential.length < 8) {
-        return "****";
-    }
-    const start = credential.slice(0, 4);
-    const end = credential.slice(-4);
-    const middle = "*".repeat(Math.max(4, credential.length - 8));
-    return `${start}${middle}${end}`;
-}
 //# sourceMappingURL=setup-bedrock.js.map

package/dist/cli/commands/setup-google-ai.js

@@ -17,6 +17,7 @@ import { GoogleAIModels } from "../../lib/constants/enums.js";
 import { updateEnvFile as updateEnvFileManager, displayEnvUpdateSummary, } from "../utils/envManager.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
 import { AIProviderName } from "../../lib/types/index.js";
+import { maskCredential } from "../utils/maskCredential.js";
 /**
  * Get the runtime default model that matches the provider implementation
  */
@@ -326,18 +327,6 @@ async function updateEnvFile(config) {
         throw error;
     }
 }
-/**
- * Mask API key for display
- */
-function maskCredential(credential) {
-    if (!credential || credential.length < 8) {
-        return "****";
-    }
-    const start = credential.slice(0, 7); // Show 'AIza' plus a few chars
-    const end = credential.slice(-4);
-    const middle = "*".repeat(Math.max(4, credential.length - 11));
-    return `${start}${middle}${end}`;
-}
 /**
  * Show usage example
  */

package/dist/cli/commands/setup-openai.js

@@ -16,6 +16,7 @@ import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
 import { AIProviderName } from "../../lib/types/index.js";
+import { maskCredential } from "../utils/maskCredential.js";
 export async function handleOpenAISetup(argv) {
     try {
         const options = {
@@ -358,20 +359,6 @@ async function updateEnvFile(config) {
         throw error;
     }
 }
-/**
- * Mask API key for display
- */
-function maskCredential(credential) {
-    if (!credential || credential.length < 8) {
-        return "****";
-    }
-    const knownPrefixes = ["sk-"];
-    const prefix = knownPrefixes.find((p) => credential.startsWith(p)) ??
-        credential.slice(0, 3);
-    const end = credential.slice(-4);
-    const stars = "*".repeat(Math.max(4, credential.length - prefix.length - 4));
-    return `${prefix}${stars}${end}`;
-}
 /**
  * Show usage example
  */

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

@@ -0,0 +1,27 @@
+/**
+ * Workflow CLI Commands for NeuroLink
+ *
+ * Implements commands for workflow management and execution:
+ * - neurolink workflow list     - List available predefined workflows
+ * - neurolink workflow info <name> - Show details of a workflow
+ * - neurolink workflow execute <name> <prompt> - Execute a workflow
+ */
+import type { CommandModule } from "yargs";
+/**
+ * Workflow CLI command factory
+ */
+export declare class WorkflowCommandFactory {
+    static createWorkflowCommands(): CommandModule;
+    /**
+     * List all predefined workflows
+     */
+    private static executeList;
+    /**
+     * Show details of a specific workflow
+     */
+    private static executeInfo;
+    /**
+     * Execute a workflow
+     */
+    private static executeWorkflow;
+}

package/dist/cli/commands/workflow.js

@@ -0,0 +1,216 @@
+/**
+ * Workflow CLI Commands for NeuroLink
+ *
+ * Implements commands for workflow management and execution:
+ * - neurolink workflow list     - List available predefined workflows
+ * - neurolink workflow info <name> - Show details of a workflow
+ * - neurolink workflow execute <name> <prompt> - Execute a workflow
+ */
+import chalk from "chalk";
+import ora from "ora";
+/**
+ * All predefined workflow configs keyed by their id.
+ * Loaded lazily via dynamic import to avoid circular deps.
+ */
+async function loadPredefinedWorkflows() {
+    const [consensus, fallback, adaptive, multiJudge] = await Promise.all([
+        import("../../lib/workflow/workflows/consensusWorkflow.js"),
+        import("../../lib/workflow/workflows/fallbackWorkflow.js"),
+        import("../../lib/workflow/workflows/adaptiveWorkflow.js"),
+        import("../../lib/workflow/workflows/multiJudgeWorkflow.js"),
+    ]);
+    const configs = [
+        consensus.CONSENSUS_3_WORKFLOW,
+        consensus.CONSENSUS_3_FAST_WORKFLOW,
+        fallback.FAST_FALLBACK_WORKFLOW,
+        fallback.AGGRESSIVE_FALLBACK_WORKFLOW,
+        adaptive.QUALITY_MAX_WORKFLOW,
+        adaptive.SPEED_FIRST_WORKFLOW,
+        adaptive.BALANCED_ADAPTIVE_WORKFLOW,
+        multiJudge.MULTI_JUDGE_5_WORKFLOW,
+        multiJudge.MULTI_JUDGE_3_WORKFLOW,
+    ];
+    const map = {};
+    for (const cfg of configs) {
+        map[cfg.id] = cfg;
+    }
+    return map;
+}
+/**
+ * Workflow CLI command factory
+ */
+export class WorkflowCommandFactory {
+    static createWorkflowCommands() {
+        return {
+            command: "workflow <subcommand>",
+            describe: "Manage and execute AI workflows",
+            builder: (yargs) => {
+                return yargs
+                    .command("list", "List available predefined workflows", (y) => y, async () => {
+                    await WorkflowCommandFactory.executeList();
+                })
+                    .command("info <name>", "Show details of a workflow", (y) => y.positional("name", {
+                    type: "string",
+                    description: "Workflow name/id",
+                    demandOption: true,
+                }), async (argv) => {
+                    await WorkflowCommandFactory.executeInfo(argv);
+                })
+                    .command("execute <name> <prompt>", "Execute a workflow with a prompt", (y) => y
+                    .positional("name", {
+                    type: "string",
+                    description: "Workflow name/id",
+                    demandOption: true,
+                })
+                    .positional("prompt", {
+                    type: "string",
+                    description: "Prompt to send to the workflow",
+                    demandOption: true,
+                })
+                    .option("provider", {
+                    type: "string",
+                    description: "Override AI provider",
+                })
+                    .option("model", {
+                    type: "string",
+                    description: "Override model name",
+                })
+                    .option("timeout", {
+                    type: "number",
+                    description: "Execution timeout in milliseconds",
+                })
+                    .option("verbose", {
+                    type: "boolean",
+                    description: "Enable verbose output",
+                    default: false,
+                }), async (argv) => {
+                    await WorkflowCommandFactory.executeWorkflow(argv);
+                })
+                    .demandCommand(1, "Please specify a workflow subcommand");
+            },
+            handler: () => { },
+        };
+    }
+    /**
+     * List all predefined workflows
+     */
+    static async executeList() {
+        const workflows = await loadPredefinedWorkflows();
+        const configs = Object.values(workflows);
+        console.info(chalk.bold("\nAvailable Workflows:\n"));
+        for (const cfg of configs) {
+            const tags = cfg.tags?.join(", ") || "";
+            console.info(`  ${chalk.cyan(cfg.id.padEnd(24))} ${chalk.white(cfg.name)}`);
+            console.info(`  ${"".padEnd(24)} ${chalk.gray(cfg.description || "")}`);
+            if (tags) {
+                console.info(`  ${"".padEnd(24)} ${chalk.gray(`Tags: ${tags}`)}`);
+            }
+            console.info();
+        }
+        console.info(chalk.gray(`Total: ${configs.length} workflows`));
+    }
+    /**
+     * Show details of a specific workflow
+     */
+    static async executeInfo(argv) {
+        const workflows = await loadPredefinedWorkflows();
+        const cfg = workflows[argv.name];
+        if (!cfg) {
+            console.error(chalk.red(`Workflow "${argv.name}" not found.`));
+            console.info(chalk.gray(`Available: ${Object.keys(workflows).join(", ")}`));
+            process.exitCode = 1;
+            return;
+        }
+        console.info(chalk.bold(`\nWorkflow: ${cfg.name}\n`));
+        console.info(`  ID:          ${cfg.id}`);
+        console.info(`  Type:        ${cfg.type}`);
+        console.info(`  Version:     ${cfg.version || "n/a"}`);
+        console.info(`  Description: ${cfg.description || "n/a"}`);
+        if (cfg.models && cfg.models.length > 0) {
+            console.info(`\n  Models:`);
+            for (const m of cfg.models) {
+                console.info(`    - ${chalk.cyan(m.label || m.model)} (${m.provider})`);
+            }
+        }
+        if (cfg.modelGroups && cfg.modelGroups.length > 0) {
+            console.info(`\n  Model Groups:`);
+            for (const group of cfg.modelGroups) {
+                console.info(`    ${chalk.cyan(group.id)}:`);
+                for (const m of group.models) {
+                    console.info(`      - ${m.label || m.model} (${m.provider})`);
+                }
+            }
+        }
+        if (cfg.judge) {
+            console.info(`\n  Judge: ${cfg.judge.model} (${cfg.judge.provider})`);
+            if (cfg.judge.criteria) {
+                console.info(`  Criteria: ${cfg.judge.criteria.join(", ")}`);
+            }
+        }
+        if (cfg.execution) {
+            console.info(`\n  Execution:`);
+            if (cfg.execution.timeout) {
+                console.info(`    Timeout:     ${cfg.execution.timeout}ms`);
+            }
+            if (cfg.execution.parallelism) {
+                console.info(`    Parallelism: ${cfg.execution.parallelism}`);
+            }
+            if (cfg.execution.minResponses) {
+                console.info(`    Min Responses: ${cfg.execution.minResponses}`);
+            }
+        }
+        if (cfg.tags && cfg.tags.length > 0) {
+            console.info(`\n  Tags: ${cfg.tags.join(", ")}`);
+        }
+    }
+    /**
+     * Execute a workflow
+     */
+    static async executeWorkflow(argv) {
+        const workflows = await loadPredefinedWorkflows();
+        let cfg = workflows[argv.name];
+        if (!cfg) {
+            console.error(chalk.red(`Workflow "${argv.name}" not found.`));
+            console.info(chalk.gray(`Available: ${Object.keys(workflows).join(", ")}`));
+            process.exitCode = 1;
+            return;
+        }
+        // Apply provider/model overrides if specified
+        if (argv.provider || argv.model) {
+            cfg = {
+                ...cfg,
+                models: cfg.models?.map((m) => ({
+                    ...m,
+                    provider: argv.provider || m.provider,
+                    model: argv.model || m.model,
+                })),
+            };
+        }
+        const spinner = ora("Executing workflow...").start();
+        try {
+            const { runWorkflow } = await import("../../lib/workflow/core/workflowRunner.js");
+            const result = await runWorkflow(cfg, {
+                prompt: argv.prompt,
+                timeout: argv.timeout,
+                verbose: argv.verbose,
+            });
+            spinner.stop();
+            if (result.content) {
+                console.info(result.content);
+            }
+            else {
+                console.info(chalk.yellow("Workflow completed but produced no content."));
+                if (result.reasoning) {
+                    console.info(chalk.gray(`Reasoning: ${result.reasoning}`));
+                }
+            }
+        }
+        catch (error) {
+            spinner.stop();
+            const msg = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(`Workflow execution failed: ${msg}`));
+            process.exitCode = 1;
+        }
+    }
+}
+//# sourceMappingURL=workflow.js.map

package/dist/cli/factories/commandFactory.js

@@ -335,7 +335,7 @@ export class CLICommandFactory {
         },
         thinkingLevel: {
             type: "string",
-            description: "Thinking level for Gemini 3 models: minimal, low, medium, high",
+            description: "Thinking level for extended reasoning (Anthropic Claude, Gemini 2.5+, Gemini 3): minimal, low, medium, high",
             choices: ["minimal", "low", "medium", "high"],
         },
         region: {
@@ -609,17 +609,10 @@ export class CLICommandFactory {
                     try {
                         // Use custom path or default
                         let imagePath;
-                        const cwd = process.cwd();
                         if (options.imageOutput) {
-                            imagePath = options.imageOutput;
-                            // Validate path is within current working directory for security
-                            const resolvedPath = path.resolve(imagePath);
-                            if (!resolvedPath.startsWith(cwd + path.sep) &&
-                                resolvedPath !== cwd) {
-                                throw new Error(`Image output path must be within current directory: ${cwd}`);
-                            }
+                            imagePath = path.resolve(options.imageOutput);
                             // Create parent directory if needed (cross-platform)
-                            const dir = path.dirname(resolvedPath);
+                            const dir = path.dirname(imagePath);
                             if (dir && dir !== "." && !fs.existsSync(dir)) {
                                 fs.mkdirSync(dir, { recursive: true });
                             }
@@ -1648,6 +1641,20 @@ export class CLICommandFactory {
                         topK: argv.ragTopK,
                     }
                     : undefined,
+                // TTS configuration
+                tts: enhancedOptions.tts
+                    ? {
+                        enabled: true,
+                        useAiResponse: true,
+                        voice: enhancedOptions.ttsVoice,
+                        format: enhancedOptions.ttsFormat ||
+                            undefined,
+                        speed: enhancedOptions.ttsSpeed,
+                        quality: enhancedOptions.ttsQuality,
+                        output: enhancedOptions.ttsOutput,
+                        play: enhancedOptions.ttsPlay,
+                    }
+                    : undefined,
             });
             if (spinner) {
                 if (isVideoMode) {
@@ -1865,16 +1872,59 @@ export class CLICommandFactory {
                     topK: argv.ragTopK,
                 }
                 : undefined,
+            // TTS configuration
+            tts: enhancedOptions.tts
+                ? {
+                    enabled: true,
+                    useAiResponse: true,
+                    voice: enhancedOptions.ttsVoice,
+                    format: enhancedOptions.ttsFormat ||
+                        undefined,
+                    speed: enhancedOptions.ttsSpeed,
+                    quality: enhancedOptions.ttsQuality,
+                    output: enhancedOptions.ttsOutput,
+                    play: enhancedOptions.ttsPlay,
+                }
+                : undefined,
         });
-        const fullContent = await CLICommandFactory.processStreamWithTimeout(stream, options);
-        await CLICommandFactory.displayStreamResults(stream, fullContent, options);
-        return fullContent;
+        const streamResult = await CLICommandFactory.processStreamWithTimeout(stream, options);
+        await CLICommandFactory.displayStreamResults(stream, streamResult.content, options);
+        // Handle image output from stream (image models emit image events)
+        if (streamResult.imageBase64) {
+            try {
+                let imagePath;
+                if (options.imageOutput) {
+                    imagePath = path.resolve(options.imageOutput);
+                    const dir = path.dirname(imagePath);
+                    if (dir && dir !== "." && !fs.existsSync(dir)) {
+                        fs.mkdirSync(dir, { recursive: true });
+                    }
+                }
+                else {
+                    const imageDir = "generated-images";
+                    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+                    imagePath = path.join(imageDir, `image-${timestamp}.png`);
+                    if (!fs.existsSync(imageDir)) {
+                        fs.mkdirSync(imageDir, { recursive: true });
+                    }
+                }
+                const imageBuffer = Buffer.from(streamResult.imageBase64, "base64");
+                fs.writeFileSync(imagePath, imageBuffer);
+                logger.always(`\n📸 Generated image saved to: ${imagePath}`);
+                logger.always(`   Image size: ${(imageBuffer.length / 1024).toFixed(2)} KB`);
+            }
+            catch (error) {
+                handleError(error, "Failed to save streamed image");
+            }
+        }
+        return streamResult.content;
     }
     /**
      * Process stream with timeout handling
      */
     static async processStreamWithTimeout(stream, options) {
         let fullContent = "";
+        let lastImageBase64;
         let contentReceived = false;
         const abortController = new AbortController();
         // Create timeout promise for stream consumption (default: 30 seconds, respects user-provided timeout)
@@ -1934,10 +1984,20 @@ export class CLICommandFactory {
                 const isAudio = (o) => !!o &&
                     typeof o === "object" &&
                     o.type === "audio";
-                const isImage = (o) => !!o &&
-                    typeof o === "object" &&
-                    o.type === "image" &&
-                    typeof o.imageOutput === "object";
+                const isImage = (o) => {
+                    if (!o || typeof o !== "object") {
+                        return false;
+                    }
+                    const record = o;
+                    if (record.type !== "image") {
+                        return false;
+                    }
+                    if (!record.imageOutput || typeof record.imageOutput !== "object") {
+                        return false;
+                    }
+                    return (typeof record.imageOutput.base64 ===
+                        "string");
+                };
                 if (isText(evt)) {
                     process.stdout.write(evt.content);
                     fullContent += evt.content;
@@ -1948,8 +2008,7 @@ export class CLICommandFactory {
                     }
                 }
                 else if (isImage(evt)) {
-                    // Image events are handled after stream completes (in generate flow)
-                    // This handler ensures they're not silently dropped
+                    lastImageBase64 = evt.imageOutput.base64;
                     if (options.debug && !options.quiet) {
                         process.stdout.write("[image-received]");
                     }
@@ -1967,7 +2026,7 @@ export class CLICommandFactory {
         if (!options.quiet) {
             process.stdout.write("\n");
         }
-        return fullContent;
+        return { content: fullContent, imageBase64: lastImageBase64 };
     }
     /**
      * Display analytics and evaluation results

package/dist/cli/index.js

@@ -26,7 +26,6 @@ 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 () => {