agent-nuvira 3.3.1 → 3.3.4

package/dist/tools/vision-tools.d.ts

@@ -1,64 +1,60 @@
 /**
- * Vision Tools — Image analysis, OCR, and visual understanding.
+ * Vision Tools — image analysis backed by a REAL engine, or a typed refusal.
  *
- * Hermes equivalent: vision_tools.py
+ * What is real here, and what is not:
  *
- * Provides:
- * - Image analysis and description
- * - OCR (Optical Character Recognition)
- * - UI element detection
- * - Screenshot analysis
+ * - `analyze` reports the image's actual format and pixel dimensions (parsed from
+ *   the PNG/JPEG/GIF/BMP headers) and, when a vision backend is configured,
+ *   a genuine description from it.
+ * - `ocr` transcribes an image through the configured vision model
+ *   (`./modality/vision.js` — a local Ollama vision model such as llava /
+ *   llama3.2-vision, or Gemini when a key is set). A vision-model transcription
+ *   is not a confidence-scored OCR engine, so the result says which engine ran
+ *   and never invents a `confidence` number.
+ * - `detect-elements`, `find-element` and `compare` have **no backend** and refuse
+ *   with `not_configured`. They previously returned `[]` / `{similarity: 0}` —
+ *   empty-but-valid payloads that read as "ran, found nothing", which is the same
+ *   class of defect as the `read_extract` PDF stub.
+ *
+ * The registry's `vision` tool ("analyze images, extract text via OCR, detect UI
+ * elements") pointed at this file while `describe_image` pointed at the real
+ * engine — two tools for one capability, one of them a stub. See
+ * TOOL_TRUTHFULNESS_TRACKER.md finding #6.
  */
+import { type VisionOptions } from './modality/vision.js';
+import { type ToolRefusalCode } from './tool-refusal.js';
 export interface ImageAnalysis {
     /** Image path */
     path: string;
-    /** Image dimensions */
+    /** Real pixel dimensions, or {0,0} when the header could not be parsed */
     dimensions: {
         width: number;
         height: number;
     };
     /** Image format */
     format: string;
-    /** Detected elements */
-    elements: DetectedElement[];
-    /** OCR text */
-    ocrText?: string;
-    /** Description */
+    /** Description text — from the vision backend when one is configured, else the metadata line */
     description: string;
     /** Tags */
     tags: string[];
-}
-export interface DetectedElement {
-    /** Element type */
-    type: 'button' | 'text' | 'image' | 'link' | 'input' | 'icon' | 'container';
-    /** Bounding box */
-    bounds: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    /** Element text */
-    text?: string;
-    /** Confidence score */
-    confidence: number;
+    /** Whether the analysis ran (a failed read is `ok: false`, never an empty success) */
+    ok: boolean;
+    /** Which engine produced `description` */
+    via?: 'vision-model' | 'metadata';
+    /** Explains what was NOT done, when a capability is missing */
+    note?: string;
+    code?: ToolRefusalCode;
+    alternatives?: string[];
+    error?: string;
 }
 export interface OCRResult {
-    /** Extracted text */
     text: string;
-    /** Confidence score */
-    confidence: number;
-    /** Text regions */
-    regions: Array<{
-        text: string;
-        bounds: {
-            x: number;
-            y: number;
-            width: number;
-            height: number;
-        };
-        confidence: number;
-    }>;
+    ok: boolean;
+    /** The engine that produced the text — absent when nothing ran */
+    via?: 'vision-model';
+    code?: ToolRefusalCode;
+    alternatives?: string[];
+    error?: string;
 }
 export interface UIElement {
     /** Element type */
@@ -77,65 +73,74 @@ export interface UIElement {
     /** Is interactive */
     interactive: boolean;
 }
+export interface DetectElementsResult {
+    ok: boolean;
+    elements: UIElement[];
+    code?: ToolRefusalCode;
+    alternatives?: string[];
+    error?: string;
+}
+export interface CompareResult {
+    ok: boolean;
+    similarity?: number;
+    differences?: Array<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    code?: ToolRefusalCode;
+    alternatives?: string[];
+    error?: string;
+}
 export declare class VisionAnalyzer {
     /**
-     * Analyze an image.
+     * Analyze an image: real format + dimensions always, plus a real description
+     * when a vision backend is available.
      */
-    analyze(imagePath: string): Promise<ImageAnalysis>;
+    analyze(imagePath: string, opts?: VisionOptions): Promise<ImageAnalysis>;
     /**
-     * Perform OCR on an image.
+     * Transcribe the text in an image through the configured vision model.
+     *
+     * Refuses when no backend is configured — it never returns an empty string as
+     * if the image simply contained no text.
      */
-    ocr(imagePath: string): Promise<OCRResult>;
+    ocr(imagePath: string, opts?: VisionOptions): Promise<OCRResult>;
     /**
      * Detect UI elements in a screenshot.
+     *
+     * There is no detector backend (no ML model, no DOM access from a raster image),
+     * so this refuses rather than returning an empty element list.
      */
-    detectUIElements(imagePath: string): Promise<UIElement[]>;
+    detectUIElements(imagePath: string): Promise<DetectElementsResult>;
     /**
      * Compare two images.
+     *
+     * No pixel-diff or embedding backend is wired up, so this refuses. It used to
+     * return `{ similarity: 0, differences: [] }`, which reads as "identical images
+     * with no differences" — the opposite of what it knew.
      */
-    compare(imagePath1: string, imagePath2: string): Promise<{
-        similarity: number;
-        differences: Array<{
-            x: number;
-            y: number;
-            width: number;
-            height: number;
-        }>;
-    }>;
+    compare(imagePath1: string, imagePath2: string): Promise<CompareResult>;
     /**
-     * Extract text from a screenshot.
+     * Extract text from a screenshot (thin alias over `ocr`, kept for callers that
+     * expect a bare string). A refusal yields an empty string — prefer `ocr` when
+     * you need to tell "no text in the image" apart from "no backend configured".
      */
-    extractText(imagePath: string): Promise<string>;
+    extractText(imagePath: string, opts?: VisionOptions): Promise<string>;
     /**
-     * Find element by text in screenshot.
+     * Find an element whose text matches. Refuses for the same reason as
+     * `detectUIElements` — there is no detector to search.
      */
     findElementByText(imagePath: string, text: string): Promise<UIElement | null>;
     /**
-     * Get image dimensions (basic detection for common formats).
-     */
-    private getImageDimensions;
-}
-export declare class ScreenshotAnalyzer {
-    private analyzer;
-    constructor();
-    /**
-     * Analyze a browser screenshot.
+     * Get image dimensions from the format header (PNG / JPEG / GIF / BMP).
+     * Returns {0,0} when the header is not one of those — an unknown size, never a
+     * guessed one.
      */
-    analyzeBrowserScreenshot(screenshotPath: string): Promise<{
-        elements: UIElement[];
-        text: string;
-        layout: string;
-    }>;
-    /**
-     * Find clickable elements.
-     */
-    findClickableElements(screenshotPath: string): Promise<UIElement[]>;
-    /**
-     * Generate automation instructions.
-     */
-    generateAutomationInstructions(screenshotPath: string, goal: string): Promise<string[]>;
-    private inferLayout;
+    getImageDimensions(buffer: Buffer, format: string): {
+        width: number;
+        height: number;
+    };
 }
 export declare function getVisionAnalyzer(): VisionAnalyzer;
-export declare function getScreenshotAnalyzer(): ScreenshotAnalyzer;
 //# sourceMappingURL=vision-tools.d.ts.map

package/dist/tools/vision-tools.d.ts.map

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

package/dist/tools/vision-tools.js

@@ -1,22 +1,58 @@
 /**
- * Vision Tools — Image analysis, OCR, and visual understanding.
+ * Vision Tools — image analysis backed by a REAL engine, or a typed refusal.
  *
- * Hermes equivalent: vision_tools.py
+ * What is real here, and what is not:
  *
- * Provides:
- * - Image analysis and description
- * - OCR (Optical Character Recognition)
- * - UI element detection
- * - Screenshot analysis
+ * - `analyze` reports the image's actual format and pixel dimensions (parsed from
+ *   the PNG/JPEG/GIF/BMP headers) and, when a vision backend is configured,
+ *   a genuine description from it.
+ * - `ocr` transcribes an image through the configured vision model
+ *   (`./modality/vision.js` — a local Ollama vision model such as llava /
+ *   llama3.2-vision, or Gemini when a key is set). A vision-model transcription
+ *   is not a confidence-scored OCR engine, so the result says which engine ran
+ *   and never invents a `confidence` number.
+ * - `detect-elements`, `find-element` and `compare` have **no backend** and refuse
+ *   with `not_configured`. They previously returned `[]` / `{similarity: 0}` —
+ *   empty-but-valid payloads that read as "ran, found nothing", which is the same
+ *   class of defect as the `read_extract` PDF stub.
+ *
+ * The registry's `vision` tool ("analyze images, extract text via OCR, detect UI
+ * elements") pointed at this file while `describe_image` pointed at the real
+ * engine — two tools for one capability, one of them a stub. See
+ * TOOL_TRUTHFULNESS_TRACKER.md finding #6.
  */
 import { readFile } from 'node:fs/promises';
 import { extname } from 'node:path';
+import { describeImage, isVisionAvailable } from './modality/vision.js';
+import { refuse } from './tool-refusal.js';
+/**
+ * Render a `ToolRefusal` into this module's result shape — the message field here
+ * is named `error` rather than `reason`, so the mapping is explicit instead of
+ * spreading `refuse()` output and ending up with an undeclared `reason` key.
+ */
+function asVisionRefusal(r) {
+    return {
+        ok: false,
+        code: r.code,
+        error: r.reason,
+        ...(r.alternatives ? { alternatives: r.alternatives } : {}),
+    };
+}
+/** Prompt used for OCR-via-vision-model. Asks for the text ONLY, no commentary. */
+const OCR_PROMPT = 'Transcribe ALL visible text in this image exactly as it appears, preserving line breaks and any table '
+    + 'rows/columns. Output only the transcription, with no preamble and no commentary.';
+/** What a user can do when no vision backend is configured. */
+const VISION_SETUP_ALTERNATIVES = [
+    'Configure a vision backend: a local Ollama vision model (llava / llama3.2-vision) or a Gemini API key',
+    'Ask the user to paste the text instead',
+];
 // ─── Vision Analyzer ──────────────────────────────────────────────────────
 export class VisionAnalyzer {
     /**
-     * Analyze an image.
+     * Analyze an image: real format + dimensions always, plus a real description
+     * when a vision backend is available.
      */
-    async analyze(imagePath) {
+    async analyze(imagePath, opts = {}) {
         const ext = extname(imagePath).toLowerCase();
         const content = await readFile(imagePath).catch(() => null);
         if (!content) {
@@ -24,63 +60,128 @@ export class VisionAnalyzer {
                 path: imagePath,
                 dimensions: { width: 0, height: 0 },
                 format: ext.slice(1) || 'unknown',
-                elements: [],
-                description: 'Failed to read image',
+                description: `Could not read the image at ${imagePath}.`,
                 tags: [],
+                ok: false,
+                code: 'no_data',
+                error: `Could not read image: ${imagePath}`,
+                alternatives: ['Check the path and that the file is a readable image'],
             };
         }
-        // Basic image info
         const format = ext.slice(1) || 'unknown';
         const dimensions = this.getImageDimensions(content, format);
+        const metadataLine = `Image: ${format.toUpperCase()} (${dimensions.width}x${dimensions.height})`;
+        // Prefer a real description when a backend exists; otherwise report honestly
+        // that only the metadata was read.
+        if (await isVisionAvailable(opts)) {
+            const described = await describeImage(imagePath, undefined, opts);
+            if (described.ok && described.description) {
+                return {
+                    path: imagePath,
+                    dimensions,
+                    format,
+                    description: described.description,
+                    tags: [format],
+                    ok: true,
+                    via: 'vision-model',
+                };
+            }
+            return {
+                path: imagePath,
+                dimensions,
+                format,
+                description: metadataLine,
+                tags: [format],
+                ok: true,
+                via: 'metadata',
+                note: `The vision backend was configured but failed (${described.error ?? 'unknown error'}), so only image metadata was read.`,
+            };
+        }
         return {
             path: imagePath,
             dimensions,
             format,
-            elements: [],
-            description: `Image: ${format.toUpperCase()} (${dimensions.width}x${dimensions.height})`,
+            description: metadataLine,
             tags: [format],
+            ok: true,
+            via: 'metadata',
+            note: 'No vision backend is configured, so only image metadata was read — no description of the contents.',
+            alternatives: VISION_SETUP_ALTERNATIVES,
         };
     }
     /**
-     * Perform OCR on an image.
+     * Transcribe the text in an image through the configured vision model.
+     *
+     * Refuses when no backend is configured — it never returns an empty string as
+     * if the image simply contained no text.
      */
-    async ocr(imagePath) {
-        // In a real implementation, this would call an OCR service
-        return {
-            text: '',
-            confidence: 0,
-            regions: [],
-        };
+    async ocr(imagePath, opts = {}) {
+        if (!(await isVisionAvailable(opts))) {
+            return {
+                text: '',
+                ...asVisionRefusal(refuse('not_configured', 'No vision backend is configured (a local Ollama vision model such as llava/llama3.2-vision, or a Gemini API key), so no text could be read from the image.', VISION_SETUP_ALTERNATIVES)),
+            };
+        }
+        const described = await describeImage(imagePath, OCR_PROMPT, opts);
+        if (!described.ok || described.description === undefined) {
+            return {
+                text: '',
+                ...asVisionRefusal(refuse('unavailable', `The vision backend could not read ${imagePath}: ${described.error ?? 'no output'}`, ['Retry once — a local vision model can time out on a large image'])),
+            };
+        }
+        return { text: described.description.trim(), ok: true, via: 'vision-model' };
     }
     /**
      * Detect UI elements in a screenshot.
+     *
+     * There is no detector backend (no ML model, no DOM access from a raster image),
+     * so this refuses rather than returning an empty element list.
      */
     async detectUIElements(imagePath) {
-        // In a real implementation, this would use ML model
-        return [];
+        return {
+            elements: [],
+            ...asVisionRefusal(refuse('not_configured', `UI-element detection has no backend — it needs a DOM or an ML detector, and neither is wired up, so no elements were detected in ${imagePath}.`, [
+                'Use the browser tools (browser / browser_supervisor) to query the live DOM instead of a screenshot',
+                'Use describe_image to get a prose description of the screenshot',
+            ])),
+        };
     }
     /**
      * Compare two images.
+     *
+     * No pixel-diff or embedding backend is wired up, so this refuses. It used to
+     * return `{ similarity: 0, differences: [] }`, which reads as "identical images
+     * with no differences" — the opposite of what it knew.
      */
     async compare(imagePath1, imagePath2) {
-        return { similarity: 0, differences: [] };
+        return asVisionRefusal(refuse('not_configured', `Image comparison has no backend, so ${imagePath1} and ${imagePath2} were NOT compared.`, [
+            'Describe both images with describe_image and compare the descriptions',
+            'Compare the files byte-wise if you only need to know whether they differ',
+        ]));
     }
     /**
-     * Extract text from a screenshot.
+     * Extract text from a screenshot (thin alias over `ocr`, kept for callers that
+     * expect a bare string). A refusal yields an empty string — prefer `ocr` when
+     * you need to tell "no text in the image" apart from "no backend configured".
      */
-    async extractText(imagePath) {
-        const result = await this.ocr(imagePath);
+    async extractText(imagePath, opts = {}) {
+        const result = await this.ocr(imagePath, opts);
         return result.text;
     }
     /**
-     * Find element by text in screenshot.
+     * Find an element whose text matches. Refuses for the same reason as
+     * `detectUIElements` — there is no detector to search.
      */
     async findElementByText(imagePath, text) {
-        const elements = await this.detectUIElements(imagePath);
-        return elements.find((e) => e.text?.toLowerCase().includes(text.toLowerCase())) || null;
+        const result = await this.detectUIElements(imagePath);
+        if (!result.ok)
+            return null;
+        return result.elements.find((e) => e.text?.toLowerCase().includes(text.toLowerCase())) || null;
     }
     /**
-     * Get image dimensions (basic detection for common formats).
+     * Get image dimensions from the format header (PNG / JPEG / GIF / BMP).
+     * Returns {0,0} when the header is not one of those — an unknown size, never a
+     * guessed one.
      */
     getImageDimensions(buffer, format) {
         // PNG header
@@ -89,7 +190,7 @@ export class VisionAnalyzer {
             const height = buffer.readUInt32BE(20);
             return { width, height };
         }
-        // JPEG header (simplified)
+        // JPEG header (search the SOF marker)
         if (format === 'jpeg' || format === 'jpg') {
             let offset = 2;
             while (offset < buffer.length - 1) {
@@ -123,81 +224,11 @@ export class VisionAnalyzer {
         return { width: 0, height: 0 };
     }
 }
-// ─── Screenshot Analyzer ──────────────────────────────────────────────────
-export class ScreenshotAnalyzer {
-    analyzer;
-    constructor() {
-        this.analyzer = new VisionAnalyzer();
-    }
-    /**
-     * Analyze a browser screenshot.
-     */
-    async analyzeBrowserScreenshot(screenshotPath) {
-        const elements = await this.analyzer.detectUIElements(screenshotPath);
-        const text = await this.analyzer.extractText(screenshotPath);
-        return {
-            elements,
-            text,
-            layout: this.inferLayout(elements),
-        };
-    }
-    /**
-     * Find clickable elements.
-     */
-    async findClickableElements(screenshotPath) {
-        const elements = await this.analyzer.detectUIElements(screenshotPath);
-        return elements.filter((e) => e.interactive);
-    }
-    /**
-     * Generate automation instructions.
-     */
-    async generateAutomationInstructions(screenshotPath, goal) {
-        const elements = await this.analyzer.detectUIElements(screenshotPath);
-        const instructions = [];
-        // Simple heuristic-based instruction generation
-        const buttons = elements.filter((e) => e.type === 'button');
-        const inputs = elements.filter((e) => e.type === 'input');
-        const links = elements.filter((e) => e.type === 'link');
-        if (goal.toLowerCase().includes('click')) {
-            for (const btn of buttons) {
-                if (btn.text)
-                    instructions.push(`Click button "${btn.text}"`);
-            }
-        }
-        if (goal.toLowerCase().includes('type') || goal.toLowerCase().includes('enter')) {
-            for (const input of inputs) {
-                instructions.push(`Type in ${input.text || 'input field'}`);
-            }
-        }
-        if (goal.toLowerCase().includes('navigate')) {
-            for (const link of links) {
-                if (link.text)
-                    instructions.push(`Click link "${link.text}"`);
-            }
-        }
-        return instructions;
-    }
-    inferLayout(elements) {
-        if (elements.length === 0)
-            return 'empty';
-        if (elements.length > 20)
-            return 'dense';
-        if (elements.some((e) => e.type === 'container'))
-            return 'structured';
-        return 'simple';
-    }
-}
 // ─── Singletons ───────────────────────────────────────────────────────────
 let _visionAnalyzer = null;
-let _screenshotAnalyzer = null;
 export function getVisionAnalyzer() {
     if (!_visionAnalyzer)
         _visionAnalyzer = new VisionAnalyzer();
     return _visionAnalyzer;
 }
-export function getScreenshotAnalyzer() {
-    if (!_screenshotAnalyzer)
-        _screenshotAnalyzer = new ScreenshotAnalyzer();
-    return _screenshotAnalyzer;
-}
 //# sourceMappingURL=vision-tools.js.map

package/dist/tools/vision-tools.js.map

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