scoutline 0.1.0

package/dist/commands/search.js

@@ -0,0 +1,235 @@
+/**
+ * Web search command using Z.AI WebSearchPrime MCP
+ */
+import { ZaiMcpClient } from "../lib/mcp-client.js";
+import { outputSuccess, getOutputMode } from "../lib/output.js";
+import { formatErrorOutput } from "../lib/errors.js";
+import { silenceConsole, restoreConsole } from "../lib/silence.js";
+import { formatSearchResultsPretty } from "../lib/tty.js";
+function truncate(text, max) {
+    if (!text)
+        return "";
+    if (!max || max <= 0 || text.length <= max)
+        return text;
+    return text.slice(0, max - 1).trimEnd() + "…";
+}
+function filterFields(result, fields) {
+    if (!fields || fields.length === 0)
+        return result;
+    const allowed = new Set(fields);
+    const filtered = {};
+    for (const [key, value] of Object.entries(result)) {
+        if (allowed.has(key)) {
+            filtered[key] = value;
+        }
+    }
+    return filtered;
+}
+/**
+ * Merge results from N parallel sub-queries: dedupe by URL, rank by
+ * (occurrence count desc, then best position asc). First sub-query's
+ * title/summary wins for each URL (highest-priority query).
+ */
+function mergeResults(byQuery) {
+    const map = new Map();
+    for (const [qIdx, results] of byQuery.entries()) {
+        for (const r of results) {
+            const existing = map.get(r.url);
+            if (existing) {
+                existing.occurrences += 1;
+                existing.bestPos = Math.min(existing.bestPos, r.rank);
+            }
+            else {
+                map.set(r.url, {
+                    ...r,
+                    occurrences: 1,
+                    bestPos: r.rank,
+                    // Keep title/summary from the EARLIEST sub-query that surfaced it.
+                    // r already has those since we're iterating in order.
+                });
+            }
+            // Suppress unused-var warning
+            void qIdx;
+        }
+    }
+    const merged = Array.from(map.values());
+    merged.sort((a, b) => {
+        if (b.occurrences !== a.occurrences)
+            return b.occurrences - a.occurrences;
+        return a.bestPos - b.bestPos;
+    });
+    // Re-rank
+    return merged.map((r, i) => {
+        const { bestPos: _bp, ...rest } = r;
+        void _bp;
+        return { ...rest, rank: i + 1 };
+    });
+}
+function renderTextFormat(results, mode) {
+    if (results.length === 0)
+        return "";
+    const lines = [];
+    for (const r of results) {
+        const occBadge = r.occurrences && r.occurrences > 1 ? ` ×${r.occurrences}` : "";
+        if (mode === "compact") {
+            lines.push(`${r.title}${occBadge} — ${r.url}`);
+        }
+        else if (mode === "markdown") {
+            lines.push(`${r.rank}. [${r.title}](${r.url})${occBadge}`);
+            if (r.summary)
+                lines.push(`   ${r.summary}`);
+        }
+        else if (mode === "refs") {
+            lines.push(`[${r.rank}]${occBadge} ${r.title} — ${r.url}`);
+        }
+    }
+    return lines.join("\n");
+}
+export async function search(query, options = {}) {
+    silenceConsole();
+    // Split query on `|` if --merge is set. Empty fragments are dropped.
+    // A literal pipe in a single query can be escaped as `\|` (won't split).
+    let subQueries = [query];
+    if (options.merge) {
+        subQueries = query
+            .split(/(?<!\\)\|/)
+            .map((q) => q.replace(/\\\|/g, "|").trim())
+            .filter((q) => q.length > 0);
+        if (subQueries.length === 0) {
+            restoreConsole();
+            console.error(formatErrorOutput(new Error("--merge requires at least one non-empty query (split with '|')")));
+            process.exit(1);
+        }
+    }
+    const isMerge = subQueries.length > 1;
+    try {
+        try {
+            // For merge, spawn one client per sub-query — the UTCP client isn't
+            // concurrency-safe so sharing one client across parallel calls corrupts
+            // responses. Single-query path keeps the cheaper shared-client flow.
+            let allResults;
+            if (isMerge) {
+                const clients = subQueries.map(() => new ZaiMcpClient({ enableVision: false, noCache: options.noCache }));
+                try {
+                    allResults = await Promise.all(subQueries.map((q, i) => clients[i].webSearch({
+                        query: q,
+                        count: options.count,
+                        domainFilter: options.domain,
+                        recencyFilter: options.recency,
+                        contentSize: options.contentSize,
+                        location: options.location,
+                    })));
+                }
+                finally {
+                    await Promise.all(clients.map((c) => c.close().catch(() => { })));
+                }
+            }
+            else {
+                const client = new ZaiMcpClient({ enableVision: false, noCache: options.noCache });
+                try {
+                    allResults = [
+                        await client.webSearch({
+                            query: subQueries[0],
+                            count: options.count,
+                            domainFilter: options.domain,
+                            recencyFilter: options.recency,
+                            contentSize: options.contentSize,
+                            location: options.location,
+                        }),
+                    ];
+                }
+                finally {
+                    await client.close().catch(() => { });
+                }
+            }
+            // Format each sub-query's results, then merge if needed.
+            const perQueryFormatted = allResults.map((results) => Array.isArray(results)
+                ? results.map((r, i) => ({
+                    rank: i + 1,
+                    title: r.title,
+                    url: r.link,
+                    summary: truncate(r.content, options.maxSummary),
+                    ...(r.media ? { source: r.media } : {}),
+                    ...(r.publish_date ? { date: r.publish_date } : {}),
+                }))
+                : []);
+            const formattedResults = isMerge
+                ? mergeResults(perQueryFormatted)
+                : perQueryFormatted[0] || [];
+            if (isMerge) {
+                process.stderr.write(`ℹ️  merged ${subQueries.length} queries → ${formattedResults.length} unique results\n`);
+            }
+            restoreConsole();
+            const mode = getOutputMode();
+            if (mode === "tty") {
+                outputSuccess(formatSearchResultsPretty(formattedResults));
+            }
+            else if (mode === "compact" || mode === "markdown" || mode === "refs") {
+                outputSuccess(renderTextFormat(formattedResults, mode));
+            }
+            else if (options.fields && options.fields.length > 0) {
+                outputSuccess(formattedResults.map((r) => filterFields(r, options.fields)));
+            }
+            else {
+                outputSuccess(formattedResults);
+            }
+        }
+        finally {
+            restoreConsole();
+        }
+    }
+    catch (error) {
+        restoreConsole();
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+// Help text
+export const SEARCH_HELP = `
+Search Command - Real-time web search using Z.AI WebSearchPrime MCP
+
+Usage: scoutline search <query> [options]
+
+Options:
+  --domain <d>        Limit to specific domain (e.g., github.com)
+  --recency <r>       Filter by time: oneDay, oneWeek, oneMonth, oneYear, noLimit
+  --content-size <s>  Content size: medium, high
+  --location <l>      Location hint: cn, us
+  --count <n>         Limit number of results
+  --max-summary <n>   Truncate each result summary to <n> chars (JSON modes only)
+  --fields <a,b,c>    Field allowlist for JSON output (e.g. title,url)
+  --merge             Treat the query as multiple sub-queries split on '|'.
+                      Runs them in parallel, dedupes by URL, ranks by how many
+                      sub-queries surfaced each result. Escapes: '\\|' for literal pipe.
+
+Output formats (--output-format / -O):
+  data       JSON array (default, token-efficient)
+  json       Envelope-wrapped JSON {success, data, timestamp}
+  pretty     Pretty-printed json
+  compact    "title — url" per line (no summaries)
+  markdown   Numbered markdown list with summaries
+  refs       "[N] title — url" per line (citation style)
+
+Examples:
+  scoutline search "React 19 new features"
+  scoutline search "Node.js security" --domain nodejs.org
+  scoutline search "AI news" --recency oneWeek
+  scoutline search "x" -O compact                    # ultra-compact
+  scoutline search "x" -O markdown --max-summary 80  # chat-ready
+  scoutline search "x" --fields title,url            # field-filtered JSON
+  scoutline search --merge "rust async|rust tokio|rust runtime"  # multi-query merge
+
+Default JSON shape:
+  [
+    {
+      "rank": 1,
+      "title": "Page title",
+      "url": "https://...",
+      "summary": "Page summary",
+      "source": "example.com",
+      "date": "2024-01-15",
+      "occurrences": 2   // only present with --merge when >1
+    }
+  ]
+`.trim();
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"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"}

package/dist/commands/tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Meta commands: tool discovery, schema inspection, and raw calls
+ */
+export interface ToolsOptions {
+    filter?: string;
+    full?: boolean;
+    typescript?: boolean;
+    enableVision?: boolean;
+}
+export declare function listTools(options?: ToolsOptions): Promise<void>;
+export declare function showTool(name: string, options?: ToolsOptions): Promise<void>;
+export interface CallToolOptions {
+    json?: string;
+    file?: string;
+    stdin?: boolean;
+    dryRun?: boolean;
+    enableVision?: boolean;
+}
+export declare function callTool(toolName: string, options?: CallToolOptions): Promise<void>;
+export declare const TOOLS_HELP: string;
+export declare const CALL_HELP: string;
+//# sourceMappingURL=tools.d.ts.map

package/dist/commands/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/commands/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoBH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,SAAS,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCzE;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtF;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAyBD,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC7F;AAGD,eAAO,MAAM,UAAU,QAmBf,CAAC;AAET,eAAO,MAAM,SAAS,QAgBd,CAAC"}

package/dist/commands/tools.js

@@ -0,0 +1,173 @@
+/**
+ * Meta commands: tool discovery, schema inspection, and raw calls
+ */
+import * as fs from "node:fs/promises";
+import { ZaiMcpClient } from "../lib/mcp-client.js";
+import { ZaiCodeModeClient } from "../lib/code-mode.js";
+import { outputSuccess } from "../lib/output.js";
+import { formatErrorOutput, ValidationError } from "../lib/errors.js";
+import { silenceConsole, restoreConsole } from "../lib/silence.js";
+import { redactTool } from "../lib/redact.js";
+async function readStdin() {
+    return new Promise((resolve, reject) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", reject);
+    });
+}
+export async function listTools(options = {}) {
+    if (options.typescript) {
+        silenceConsole();
+        const codeClient = new ZaiCodeModeClient();
+        try {
+            const interfaces = await codeClient.getAllInterfaces();
+            outputSuccess(interfaces);
+        }
+        catch (error) {
+            restoreConsole();
+            console.error(formatErrorOutput(error));
+            process.exit(1);
+        }
+        finally {
+            await codeClient.close().catch(() => { });
+            restoreConsole();
+        }
+        return;
+    }
+    silenceConsole();
+    const client = new ZaiMcpClient({ enableVision: options.enableVision });
+    try {
+        const tools = await client.listTools();
+        const filtered = options.filter
+            ? tools.filter((tool) => tool.name.toLowerCase().includes(options.filter.toLowerCase()))
+            : tools;
+        if (options.full) {
+            outputSuccess(filtered.map((tool) => redactTool(tool)));
+            return;
+        }
+        outputSuccess(filtered.map((tool) => tool.name));
+    }
+    catch (error) {
+        restoreConsole();
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+    finally {
+        await client.close().catch(() => { });
+        restoreConsole();
+    }
+}
+export async function showTool(name, options = {}) {
+    silenceConsole();
+    const client = new ZaiMcpClient({ enableVision: options.enableVision });
+    try {
+        const tool = await client.getTool(name);
+        if (!tool) {
+            restoreConsole();
+            throw new ValidationError(`Unknown tool: ${name}`);
+        }
+        outputSuccess(redactTool(tool));
+    }
+    catch (error) {
+        restoreConsole();
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+    finally {
+        await client.close().catch(() => { });
+        restoreConsole();
+    }
+}
+async function parseToolArgs(options) {
+    if (options.json) {
+        const raw = options.json.trim();
+        const value = raw.startsWith("@") ? await fs.readFile(raw.slice(1), "utf8") : raw;
+        return JSON.parse(value);
+    }
+    if (options.file) {
+        const value = await fs.readFile(options.file, "utf8");
+        return JSON.parse(value);
+    }
+    if (options.stdin || !process.stdin.isTTY) {
+        const value = await readStdin();
+        if (value.trim().length === 0) {
+            return {};
+        }
+        return JSON.parse(value);
+    }
+    return {};
+}
+export async function callTool(toolName, options = {}) {
+    let args;
+    try {
+        args = await parseToolArgs(options);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            console.error(formatErrorOutput(new ValidationError(`Invalid JSON: ${error.message}`)));
+            process.exit(1);
+        }
+        throw error;
+    }
+    silenceConsole();
+    const client = new ZaiMcpClient({ enableVision: options.enableVision });
+    try {
+        const resolved = await client.resolveToolName(toolName);
+        if (options.dryRun) {
+            outputSuccess({ tool: resolved, args });
+            return;
+        }
+        const result = await client.callToolRaw(resolved, args);
+        outputSuccess(result);
+    }
+    catch (error) {
+        restoreConsole();
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+    finally {
+        await client.close().catch(() => { });
+        restoreConsole();
+    }
+}
+// Help text
+export const TOOLS_HELP = `
+Tools - Discover MCP tools and schemas
+
+Usage:
+  scoutline tools [options]
+  scoutline tool <name>
+
+Options:
+  --filter <text>   Filter tools by name
+  --full            Return full tool schemas
+  --typescript      Output TypeScript interfaces (Code Mode)
+  --no-vision       Skip vision MCP server (faster startup)
+
+Examples:
+  scoutline tools
+  scoutline tools --filter vision
+  scoutline tools --full
+  scoutline tools --typescript
+  scoutline tool scoutline.zai.vision.analyze_image
+`.trim();
+export const CALL_HELP = `
+Call - Invoke a tool by name with JSON arguments
+
+Usage: scoutline call <tool> [options]
+
+Options:
+  --json <json>     Inline JSON args (prefix with @file to load)
+  --file <path>     Read JSON args from file
+  --stdin           Read JSON args from stdin
+  --dry-run         Print resolved tool name + args without calling
+  --no-vision       Skip vision MCP server (faster startup)
+
+Examples:
+  scoutline call scoutline.zai.search.webSearchPrime --json '{"search_query":"LLM tools"}'
+  scoutline call scoutline.zai.reader.webReader --file ./args.json
+  echo '{"repo_name":"owner/repo"}' | scoutline call scoutline.zai.zread.get_repo_structure --stdin
+`.trim();
+//# sourceMappingURL=tools.js.map

package/dist/commands/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/commands/tools.ts"],"names":[],"mappings":"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"}

package/dist/commands/vision.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Vision commands using Z.AI Vision MCP server
+ */
+type OutputType = "code" | "prompt" | "spec" | "description";
+export declare function analyze(imageSource: string, prompt?: string): Promise<void>;
+export declare function uiToCode(imageSource: string, prompt?: string, outputType?: OutputType): Promise<void>;
+export declare function extractText(imageSource: string, prompt?: string, language?: string): Promise<void>;
+export declare function diagnoseError(imageSource: string, prompt?: string, context?: string): Promise<void>;
+export declare function diagram(imageSource: string, prompt?: string, diagramType?: string): Promise<void>;
+export declare function chart(imageSource: string, prompt?: string, focus?: string): Promise<void>;
+export declare function diff(expectedSource: string, actualSource: string, prompt?: string): Promise<void>;
+export declare function video(videoSource: string, prompt?: string): Promise<void>;
+export declare const VISION_HELP: string;
+export {};
+//# sourceMappingURL=vision.d.ts.map

package/dist/commands/vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../../src/commands/vision.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,KAAK,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC;AA4B7D,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAgC,GACvC,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAiC,EACzC,UAAU,GAAE,UAAmB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAoC,EAC5C,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAsC,EAC9C,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAgC,EACxC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,KAAK,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAA8B,EACtC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,IAAI,CACxB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,MAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,KAAK,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAA8B,GACrC,OAAO,CAAC,IAAI,CAAC,CAWf;AAGD,eAAO,MAAM,WAAW,QAkChB,CAAC"}

package/dist/commands/vision.js

@@ -0,0 +1,168 @@
+/**
+ * Vision commands using Z.AI Vision MCP server
+ */
+import { ZaiMcpClient } from "../lib/mcp-client.js";
+import { resolveImageSource, resolveVideoSource } from "../lib/image.js";
+import { outputSuccess } from "../lib/output.js";
+import { formatErrorOutput } from "../lib/errors.js";
+import { silenceConsole, restoreConsole } from "../lib/silence.js";
+const DEFAULT_PROMPTS = {
+    analyze: "Describe this image in detail.",
+    uiToCode: "Convert this UI to production-ready code.",
+    extractText: "Extract all text from this image.",
+    diagnoseError: "Diagnose this error and suggest fixes.",
+    diagram: "Explain this technical diagram.",
+    chart: "Analyze this data visualization.",
+    diff: "Compare these two UI screenshots and identify differences.",
+    video: "Analyze this video content.",
+};
+async function withClient(fn) {
+    silenceConsole();
+    const client = new ZaiMcpClient();
+    try {
+        const result = await fn(client);
+        return result;
+    }
+    catch (error) {
+        restoreConsole();
+        throw error;
+    }
+    finally {
+        await client.close().catch(() => { });
+        restoreConsole();
+    }
+}
+export async function analyze(imageSource, prompt = DEFAULT_PROMPTS.analyze) {
+    try {
+        const image = resolveImageSource(imageSource);
+        const result = await withClient((client) => client.visionAnalyze({ imageSource: image, prompt }));
+        outputSuccess(result);
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+export async function uiToCode(imageSource, prompt = DEFAULT_PROMPTS.uiToCode, outputType = "code") {
+    try {
+        const image = resolveImageSource(imageSource);
+        const result = await withClient((client) => client.visionUiToArtifact({ imageSource: image, outputType, prompt }));
+        outputSuccess(result);
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+export async function extractText(imageSource, prompt = DEFAULT_PROMPTS.extractText, language) {
+    try {
+        const image = resolveImageSource(imageSource);
+        const result = await withClient((client) => client.visionExtractText({
+            imageSource: image,
+            prompt,
+            programmingLanguage: language,
+        }));
+        outputSuccess(result);
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+export async function diagnoseError(imageSource, prompt = DEFAULT_PROMPTS.diagnoseError, context) {
+    try {
+        const image = resolveImageSource(imageSource);
+        const result = await withClient((client) => client.visionDiagnoseError({ imageSource: image, prompt, context }));
+        outputSuccess(result);
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+export async function diagram(imageSource, prompt = DEFAULT_PROMPTS.diagram, diagramType) {
+    try {
+        const image = resolveImageSource(imageSource);
+        const result = await withClient((client) => client.visionDiagram({ imageSource: image, prompt, diagramType }));
+        outputSuccess(result);
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+export async function chart(imageSource, prompt = DEFAULT_PROMPTS.chart, focus) {
+    try {
+        const image = resolveImageSource(imageSource);
+        const result = await withClient((client) => client.visionChart({ imageSource: image, prompt, focus }));
+        outputSuccess(result);
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+export async function diff(expectedSource, actualSource, prompt = DEFAULT_PROMPTS.diff) {
+    try {
+        const expectedImage = resolveImageSource(expectedSource);
+        const actualImage = resolveImageSource(actualSource);
+        const result = await withClient((client) => client.visionDiff({
+            expectedImageSource: expectedImage,
+            actualImageSource: actualImage,
+            prompt,
+        }));
+        outputSuccess(result);
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+export async function video(videoSource, prompt = DEFAULT_PROMPTS.video) {
+    try {
+        const videoPath = resolveVideoSource(videoSource);
+        const result = await withClient((client) => client.visionVideo({ videoSource: videoPath, prompt }));
+        outputSuccess(result);
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+// Help text
+export const VISION_HELP = `
+Vision Commands - Analyze images and videos via Z.AI Vision MCP
+
+Usage: scoutline vision <command> <source> [prompt] [options]
+
+Commands:
+  analyze <image> [prompt]           General image analysis
+  ui-to-code <image> [prompt]        Convert UI screenshot to code
+  extract-text <image> [prompt]      OCR for code, terminals, documents
+  diagnose-error <image> [prompt]    Analyze error screenshots
+  diagram <image> [prompt]           Interpret technical diagrams
+  chart <image> [prompt]             Analyze data visualizations
+  diff <expected> <actual> [prompt]  Compare two UI screenshots
+  video <video> [prompt]             Analyze video content
+
+Options:
+  --language <lang>  Programming language hint (extract-text)
+  --context <ctx>    Error context (diagnose-error)
+  --type <type>      Diagram type hint (diagram)
+  --focus <focus>    Analysis focus (chart)
+  --output <type>    Output type for ui-to-code: code, prompt, spec, description
+
+Constraints:
+  Images: ≤5MB, JPG/PNG/JPEG
+  Videos: ≤8MB, MP4/MOV/M4V (URLs supported)
+
+Examples:
+  scoutline vision analyze ./screenshot.png "What's in this image?"
+  scoutline vision ui-to-code ./design.png --output code
+  scoutline vision extract-text ./code.png --language python
+  scoutline vision diagnose-error ./error.png --context "during npm install"
+  scoutline vision diagram ./arch.png --type architecture
+  scoutline vision diff ./expected.png ./actual.png "Check alignment"
+  scoutline vision video ./demo.mp4 "Summarize the key steps"
+`.trim();
+//# sourceMappingURL=vision.js.map

package/dist/commands/vision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.js","sourceRoot":"","sources":["../../src/commands/vision.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * scoutline - CLI for Z.AI capabilities
+ */
+export declare function main(args: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8eH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoExD"}