scoutline 0.1.0 → 0.2.0

package/dist/commands/vision.d.ts

@@ -1,15 +1,41 @@
 /**
- * Vision commands using Z.AI Vision MCP server
+ * Vision commands.
+ *
+ * P3-04: the command no longer constructs a Provider client or validates
+ * media directly. It receives the effective Provider's VisionCapability
+ * through the dispatch dependency object (same pattern as Search in
+ * P2-05), builds the discriminated `VisionRequest`, and invokes through
+ * shared execution (`executeProviderOperation("vision", ...)`). The
+ * support check — not a command branch on a Provider ID — decides
+ * availability; Provider selection and capability gating live in the
+ * dispatcher (`index.ts`).
+ *
+ * Default prompts and command presentation meaning stay here. Source
+ * limits stay in the Adapter media Modules. Vision never uses the
+ * response cache (FR-022).
  */
+import type { CommandContext, CommandResult } from "../command-invocation.js";
+import type { VisionCapability } from "../capabilities/vision.js";
 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;
+/**
+ * Shared Vision execution dependencies. The Capability is the selected
+ * Provider's `VisionCapability`; `sleep`/`random` drive retry backoff
+ * deterministically under test. Vision bypasses the response cache, so
+ * no cache dependency is threaded here.
+ */
+export interface VisionExecutionDependencies {
+    readonly capability: VisionCapability;
+    readonly sleep: (ms: number) => Promise<void>;
+    readonly random: () => number;
+}
+export declare function analyze(imageSource: string, prompt: string, deps: VisionExecutionDependencies, context?: CommandContext): Promise<CommandResult>;
+export declare function uiToCode(imageSource: string, prompt: string, outputType: OutputType, deps: VisionExecutionDependencies, context?: CommandContext): Promise<CommandResult>;
+export declare function extractText(imageSource: string, prompt: string, language: string | undefined, deps: VisionExecutionDependencies, context?: CommandContext): Promise<CommandResult>;
+export declare function diagnoseError(imageSource: string, prompt: string, contextFlag: string | undefined, deps: VisionExecutionDependencies, context?: CommandContext): Promise<CommandResult>;
+export declare function diagram(imageSource: string, prompt: string, diagramType: string | undefined, deps: VisionExecutionDependencies, context?: CommandContext): Promise<CommandResult>;
+export declare function chart(imageSource: string, prompt: string, focus: string | undefined, deps: VisionExecutionDependencies, context?: CommandContext): Promise<CommandResult>;
+export declare function diff(expectedSource: string, actualSource: string, prompt: string, deps: VisionExecutionDependencies, context?: CommandContext): Promise<CommandResult>;
+export declare function video(videoSource: string, prompt: string, deps: VisionExecutionDependencies, context?: CommandContext): Promise<CommandResult>;
 export {};
 //# sourceMappingURL=vision.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../../src/commands/vision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAkC,MAAM,2BAA2B,CAAC;AASlG,KAAK,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC;AA2F7D,eAAO,MAAM,WAAW,QAAoB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;CAC/B;AAcD,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,2BAA2B,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAcxB;AAED,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,2BAA2B,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAmBxB;AAED,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,2BAA2B,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAmBxB;AAED,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,2BAA2B,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAmBxB;AAED,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,2BAA2B,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAmBxB;AAED,wBAAsB,KAAK,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,2BAA2B,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAmBxB;AAED,wBAAsB,IAAI,CACxB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,2BAA2B,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAmBxB;AAED,wBAAsB,KAAK,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,2BAA2B,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAWxB"}

package/dist/commands/vision.js

@@ -1,11 +1,22 @@
 /**
- * Vision commands using Z.AI Vision MCP server
+ * Vision commands.
+ *
+ * P3-04: the command no longer constructs a Provider client or validates
+ * media directly. It receives the effective Provider's VisionCapability
+ * through the dispatch dependency object (same pattern as Search in
+ * P2-05), builds the discriminated `VisionRequest`, and invokes through
+ * shared execution (`executeProviderOperation("vision", ...)`). The
+ * support check — not a command branch on a Provider ID — decides
+ * availability; Provider selection and capability gating live in the
+ * dispatcher (`index.ts`).
+ *
+ * Default prompts and command presentation meaning stay here. Source
+ * limits stay in the Adapter media Modules. Vision never uses the
+ * response cache (FR-022).
  */
-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";
+import { executeProviderOperation } from "../lib/execution.js";
+import { ValidationError } from "../lib/errors.js";
+import { isMiniMaxVisionOperationSupported, SPECIALIZED_VISION_OPERATION_SET, } from "../providers/minimax/vision-conformance.js";
 const DEFAULT_PROMPTS = {
     analyze: "Describe this image in detail.",
     uiToCode: "Convert this UI to production-ready code.",
@@ -16,134 +27,60 @@ const DEFAULT_PROMPTS = {
     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);
-    }
+/**
+ * Render the MiniMax support suffix for a Vision operation's help line.
+ * Derives from the conformance registry so help, doctor, and the
+ * Adapter descriptor agree on a single source of truth (DESIGN.md §15).
+ *
+ *   - Specialized ops pending/fail/missing attestation: " (Z.AI; MiniMax gated)"
+ *   - Specialized ops supported: " (Z.AI + MiniMax)"
+ *   - `interpret-image`: no suffix (the help line already calls out
+ *     the shared Provider surface).
+ *   - `diff` and `video`: " (Z.AI only)" — never supported by MiniMax.
+ */
+function miniMaxSupportSuffix(operation) {
+    if (operation === "interpret-image")
+        return "";
+    if (operation === "diff" || operation === "video")
+        return " (Z.AI only)";
+    if (SPECIALIZED_VISION_OPERATION_SET.has(operation)) {
+        return isMiniMaxVisionOperationSupported(operation)
+            ? " (Z.AI + MiniMax)"
+            : " (Z.AI; MiniMax gated)";
+    }
+    return "";
 }
-// Help text
-export const VISION_HELP = `
-Vision Commands - Analyze images and videos via Z.AI Vision MCP
+/**
+ * Build the Vision help text. Specialized-operation support derives
+ * from the conformance registry, so P5-03's attested mappings flip
+ * their help lines automatically without editing this template.
+ */
+function buildVisionHelp() {
+    const uiSuffix = miniMaxSupportSuffix("ui-artifact");
+    const extractSuffix = miniMaxSupportSuffix("extract-text");
+    const diagnoseSuffix = miniMaxSupportSuffix("diagnose-error");
+    const diagramSuffix = miniMaxSupportSuffix("diagram");
+    const chartSuffix = miniMaxSupportSuffix("chart");
+    const diffSuffix = miniMaxSupportSuffix("diff");
+    const videoSuffix = miniMaxSupportSuffix("video");
+    return `
+Vision Commands - Analyze images and video (Z.AI + MiniMax)
 
 Usage: scoutline vision <command> <source> [prompt] [options]
 
+Provider selection (precedence: explicit flag, then SCOUTLINE_PROVIDER, then zai):
+  --provider <zai|minimax>   Select the vision provider (default: zai)
+  SCOUTLINE_PROVIDER=<id>    Fallback when --provider is not passed
+
 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
+  analyze <image> [prompt]            General image interpretation (shared: Z.AI + MiniMax)
+  ui-to-code <image> [prompt]         Convert UI screenshot to code${uiSuffix}
+  extract-text <image> [prompt]       OCR for code, terminals, documents${extractSuffix}
+  diagnose-error <image> [prompt]     Analyze error screenshots${diagnoseSuffix}
+  diagram <image> [prompt]            Interpret technical diagrams${diagramSuffix}
+  chart <image> [prompt]              Analyze data visualizations${chartSuffix}
+  diff <expected> <actual> [prompt]   Compare two UI screenshots${diffSuffix}
+  video <video> [prompt]              Analyze video content${videoSuffix}
 
 Options:
   --language <lang>  Programming language hint (extract-text)
@@ -153,11 +90,12 @@ Options:
   --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)
+  Z.AI images: <=5MB, JPG/PNG/JPEG ; Z.AI videos: <=8MB, MP4/MOV/M4V (URLs supported)
+  MiniMax images: <=50MB, JPG/JPEG/PNG/WebP
 
 Examples:
   scoutline vision analyze ./screenshot.png "What's in this image?"
+  scoutline --provider minimax vision analyze ./shot.png
   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"
@@ -165,4 +103,119 @@ Examples:
   scoutline vision diff ./expected.png ./actual.png "Check alignment"
   scoutline vision video ./demo.mp4 "Summarize the key steps"
 `.trim();
+}
+export const VISION_HELP = buildVisionHelp();
+/**
+ * Invoke a Vision request through shared execution. Vision allows two
+ * retries (DESIGN.md §10); the default policy is applied by
+ * `executeProviderOperation`. No cache lookup, no fallback Provider.
+ */
+function runVision(request, deps) {
+    return executeProviderOperation("vision", () => deps.capability.invoke(request), {
+        sleep: deps.sleep,
+        random: deps.random,
+    });
+}
+export async function analyze(imageSource, prompt, deps, context) {
+    void context;
+    if (!imageSource) {
+        throw new ValidationError("Missing image source", "Usage: scoutline vision analyze <image> [prompt]");
+    }
+    const instruction = prompt ?? DEFAULT_PROMPTS.analyze;
+    const result = await runVision({ operation: "interpret-image", source: imageSource, instruction }, deps);
+    return { kind: "data", data: result };
+}
+export async function uiToCode(imageSource, prompt, outputType, deps, context) {
+    void context;
+    if (!imageSource) {
+        throw new ValidationError("Missing image source", "Usage: scoutline vision ui-to-code <image> [prompt]");
+    }
+    const instruction = prompt ?? DEFAULT_PROMPTS.uiToCode;
+    const result = await runVision({
+        operation: "ui-artifact",
+        source: imageSource,
+        instruction,
+        outputType: outputType ?? "code",
+    }, deps);
+    return { kind: "data", data: result };
+}
+export async function extractText(imageSource, prompt, language, deps, context) {
+    void context;
+    if (!imageSource) {
+        throw new ValidationError("Missing image source", "Usage: scoutline vision extract-text <image> [prompt] [--language <lang>]");
+    }
+    const instruction = prompt ?? DEFAULT_PROMPTS.extractText;
+    const result = await runVision({
+        operation: "extract-text",
+        source: imageSource,
+        instruction,
+        programmingLanguage: language,
+    }, deps);
+    return { kind: "data", data: result };
+}
+export async function diagnoseError(imageSource, prompt, contextFlag, deps, context) {
+    void context;
+    if (!imageSource) {
+        throw new ValidationError("Missing image source", "Usage: scoutline vision diagnose-error <image> [prompt] [--context <ctx>]");
+    }
+    const instruction = prompt ?? DEFAULT_PROMPTS.diagnoseError;
+    const result = await runVision({
+        operation: "diagnose-error",
+        source: imageSource,
+        instruction,
+        context: contextFlag,
+    }, deps);
+    return { kind: "data", data: result };
+}
+export async function diagram(imageSource, prompt, diagramType, deps, context) {
+    void context;
+    if (!imageSource) {
+        throw new ValidationError("Missing image source", "Usage: scoutline vision diagram <image> [prompt] [--type <type>]");
+    }
+    const instruction = prompt ?? DEFAULT_PROMPTS.diagram;
+    const result = await runVision({
+        operation: "diagram",
+        source: imageSource,
+        instruction,
+        diagramType,
+    }, deps);
+    return { kind: "data", data: result };
+}
+export async function chart(imageSource, prompt, focus, deps, context) {
+    void context;
+    if (!imageSource) {
+        throw new ValidationError("Missing image source", "Usage: scoutline vision chart <image> [prompt] [--focus <focus>]");
+    }
+    const instruction = prompt ?? DEFAULT_PROMPTS.chart;
+    const result = await runVision({
+        operation: "chart",
+        source: imageSource,
+        instruction,
+        focus,
+    }, deps);
+    return { kind: "data", data: result };
+}
+export async function diff(expectedSource, actualSource, prompt, deps, context) {
+    void context;
+    if (!expectedSource || !actualSource) {
+        throw new ValidationError("Missing image sources", "Usage: scoutline vision diff <expected> <actual> [prompt]");
+    }
+    const instruction = prompt ?? DEFAULT_PROMPTS.diff;
+    const result = await runVision({
+        operation: "diff",
+        expectedSource,
+        actualSource,
+        instruction,
+    }, deps);
+    return { kind: "data", data: result };
+}
+export async function video(videoSource, prompt, deps, context) {
+    void context;
+    if (!videoSource) {
+        throw new ValidationError("Missing video source", "Usage: scoutline vision video <video> [prompt]");
+    }
+    const instruction = prompt ?? DEFAULT_PROMPTS.video;
+    const result = await runVision({ operation: "video", source: videoSource, instruction }, deps);
+    return { kind: "data", data: result };
+}
 //# sourceMappingURL=vision.js.map

package/dist/commands/vision.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,46 @@
 /**
  * scoutline - CLI for Z.AI capabilities
  */
-export declare function main(args: string[]): Promise<void>;
+import { type CommandInvocationAdapter } from "./command-invocation.js";
+import { type ResponseCache } from "./lib/cache.js";
+import type { ProviderDescriptor } from "./providers/types.js";
+/**
+ * Parse and validate the `--count` flag value (Fixup C — B11, Fixup D). Per
+ * DESIGN.md §7, count must be a safe integer >= 0. Invalid values (NaN,
+ * negative, non-integer, Infinity, values above Number.MAX_SAFE_INTEGER)
+ * throw `ValidationError` BEFORE any Provider resolution or invocation.
+ *
+ * Fixup D hardens two gaps:
+ *   - `--count` without a value parses to `true`; that is a user error,
+ *     not an absent flag, and now throws VALIDATION_ERROR instead of being
+ *     silently treated as absent.
+ *   - Uses `Number.isSafeInteger` instead of `Number.isFinite` +
+ *     `Number.isInteger` so values above 2^53-1 are rejected rather than
+ *     silently rounded.
+ *
+ * Exported for testing so the validation can be exercised without going
+ * through the CLI parser (which does not deliver negative numbers as flag
+ * values today).
+ */
+export declare function parseAndValidateCount(raw: unknown): number | undefined;
+export interface MainDependencies {
+    readonly invocation: CommandInvocationAdapter;
+    readonly env: NodeJS.ProcessEnv;
+    readonly now?: () => number;
+    /**
+     * Injectable Provider registry. Production defaults to the static
+     * built-in descriptors; tests pass doubles to route Search through a
+     * fake Adapter without touching real transports.
+     */
+    readonly providerDescriptors?: readonly ProviderDescriptor[];
+    /**
+     * Injectable shared-Search execution dependencies. Production defaults
+     * to the on-disk cache and real sleep/random; tests inject in-memory
+     * doubles for deterministic, offline behaviour.
+     */
+    readonly searchCache?: ResponseCache;
+    readonly searchSleep?: (ms: number) => Promise<void>;
+    readonly searchRandom?: () => number;
+}
+export declare function main(args: readonly string[], dependencies: MainDependencies): Promise<number>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0BH,OAAO,EAAiB,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI1E,OAAO,KAAK,EAAE,kBAAkB,EAAc,MAAM,sBAAsB,CAAC;AA8X3E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAuBtE;AA6cD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC7D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;CACtC;AAID,wBAAsB,IAAI,CACxB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,YAAY,EAAE,gBAAgB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAuGjB"}