agent-nuvira 3.3.3 → 3.3.4

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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"}

package/dist/tools/worktree.d.ts

@@ -0,0 +1,210 @@
+/**
+ * WS5 (#27) — a turn's own git worktree, and the diff it leaves behind.
+ *
+ * WHY A WORKTREE AT ALL. The ask is "try this and show me what changed". Running
+ * that in the operator's own tree makes the answer inseparable from the damage: a
+ * turn that edits twelve files to test one hypothesis has changed the tree the
+ * operator is working in, and the only record of it is whatever they notice. A
+ * second checkout of the SAME repository (a `git worktree`) gives the turn a real
+ * tree — same code, same test runner, same `node_modules` — that can be thrown
+ * away, and turns "what changed" into a diff against the commit it started from.
+ *
+ * WHY THE BASE IS `HEAD`, AND WHY THE NOTICE SAYS SO. `git worktree add … HEAD`
+ * checks out a commit, so UNCOMMITTED work in the operator's tree is not visible
+ * inside the copy. That is a real trap — a run that "did not see my edit" — so the
+ * number of dirty files in the source tree is MEASURED at creation and reported,
+ * rather than left to be discovered. A clean tree reports nothing.
+ *
+ * WHY IT REFUSES INSTEAD OF DEGRADING. Not every directory can be isolated: not a
+ * repository, no commit yet, no `git` at all. The tempting behaviour — run in the
+ * real tree and report the turn normally — is the one outcome this feature exists
+ * to prevent, because the caller acts on a diff that describes a tree nobody ran
+ * in. So isolation either happens or the turn STOPS, and the refusal says why.
+ *
+ * WHY THE DIFF IS MEASURED BEFORE TEARDOWN. Removing the worktree is what
+ * destroys the evidence, so the order is not a detail: measure, then remove. A
+ * teardown that fails (a git lock, a file handle) is reported as "not removed"
+ * rather than assumed, since the directory is left in the operator's profile with
+ * a branch pointing at it.
+ *
+ * GIT'S OWN STDOUT IS KEPT SEPARATE FROM THE MESSAGE. One helper here returns a
+ * never-empty `out` (git printing nothing is a fact worth a sentence), and a
+ * second field `raw` holding exactly what git wrote. Counting or parsing `out` is
+ * how a PRISTINE repository came to be reported as having one uncommitted change:
+ * `git status --porcelain` prints nothing, the fallback sentence has one line, and
+ * the count was taken from the sentence (see TOOL_TRUTHFULNESS_TRACKER).
+ */
+/** The environment key a deployment asks for isolation through. */
+export declare const WORKTREE_ENABLE_ENV = "NUVIRA_ISOLATE";
+/** The environment keys a forked child reads to learn which worktree it is in. */
+export declare const WORKTREE_DIR_ENV = "NUVIRA_WORKTREE_DIR";
+export declare const WORKTREE_BASE_ENV = "NUVIRA_WORKTREE_BASE";
+/** How long `git worktree add` may take — a big repository is still a checkout. */
+export declare const WORKTREE_CREATE_TIMEOUT_MS = 20000;
+/** Bound on one file's diff body, so a huge change cannot be handed over whole. */
+export declare const WORKTREE_PATCH_CHARS = 120000;
+/** ─── Requests ─────────────────────────────────────────────────────────────── */
+/**
+ * What an isolation request resolved to.
+ *
+ * Exactly two fields, and no more: the parity suite asserts the shape of a
+ * default request (`{asked: false, keep: false}`), so a third field added here
+ * would be a silent change to a documented value. `asked` and `keep` are kept
+ * apart because asking to be isolated and asking to KEEP the result are separate
+ * decisions, and a plain `--worktree` must not leave a directory behind.
+ */
+export interface IsolationRequest {
+    asked: boolean;
+    keep: boolean;
+}
+/**
+ * Resolve an isolation request from a caller's options, with the environment as
+ * the fallback — not the other way round.
+ *
+ * `undefined` means "nobody said anything", and only then does `NUVIRA_ISOLATE`
+ * decide. An explicit `false` is a DECISION (a surface that offers an off switch
+ * must be able to turn a deployment's `NUVIRA_ISOLATE=1` off for one turn), and
+ * it outranks the environment. This is the distinction a commander-style `false`
+ * default destroys: with one, every CLI turn carries an explicit decline and the
+ * documented `NUVIRA_ISOLATE=1` is unreachable from the command line.
+ */
+export declare function resolveIsolationRequest(input: {
+    worktree?: boolean;
+    keepWorktree?: boolean;
+}): IsolationRequest;
+/**
+ * Why `repoCwd` cannot be isolated, or null when it can.
+ *
+ * Shared by the refusal path and by the parity harness, which uses it to assert
+ * that the checkout it is about to drive CAN be isolated — a harness that
+ * silently proved nothing because it ran somewhere unisolatable would be worse
+ * than a failure.
+ */
+export declare function worktreeRefusal(repoCwd: string): string | null;
+/** The refusal, as the operator reads it. A failure, not a degradation. */
+export declare function isolationRefusalText(why: string): string;
+/** ─── The worktree ─────────────────────────────────────────────────────────── */
+/** A live worktree: where it is, and the commit everything is measured against. */
+export interface IsolatedWorktree {
+    /** The checkout the turn runs in. */
+    dir: string;
+    /** The commit the diff is against (full sha). */
+    base: string;
+    /** The branch the worktree is checked out on, created with it. */
+    branch: string;
+    /** The repository it was created from. */
+    repoCwd: string;
+    /** Uncommitted paths in the SOURCE tree, which the copy cannot see. */
+    sourceDirty: number;
+}
+/**
+ * Make a worktree of `repoCwd`, or return null when that is impossible.
+ *
+ * `node_modules` is LINKED rather than installed: a worktree has no dependencies
+ * of its own, and an isolated turn that could not run a test would measure
+ * nothing. The link is best-effort — a filesystem that cannot symlink still gets
+ * an isolated tree, just one without dependencies.
+ */
+export declare function createIsolatedWorktree(input: {
+    repoCwd: string;
+    label: string;
+    timeoutMs?: number;
+}): IsolatedWorktree | null;
+/** ─── The diff ─────────────────────────────────────────────────────────────── */
+/**
+ * What an isolated turn changed.
+ *
+ * NOTE THE TWO HALVES OF `diff`, because they are not the same list and reading
+ * the wrong one renders an empty card: `files` is the changed PATHS (one string
+ * per file — what a reader scans), and `payload.files[].body` is the unified diff
+ * of each. `payload` deliberately has the shape the `git:diff` event already
+ * carries, so an isolated change renders with the diff card that is already
+ * there instead of a second renderer that could drift from it.
+ */
+export interface WorktreeDiff {
+    /** Changed paths, sorted as git reports them. */
+    files: string[];
+    summary: string;
+    /** True when the run changed nothing — a fact, not a failure. */
+    unchanged: boolean;
+    payload: {
+        files: Array<{
+            path: string;
+            body: string;
+        }>;
+        summary: string;
+    };
+}
+/**
+ * Measure the diff against the worktree's base commit.
+ *
+ * UNTRACKED FILES COUNT, and that is why the index is staged first: a run that
+ * CREATES a file has changed the tree, and `git diff` alone would report nothing
+ * for it. Staging inside a worktree that is about to be thrown away is free, and
+ * a worktree that is KEPT has its new files staged — which is what `git diff
+ * --cached` reads on the next measurement.
+ */
+export declare function worktreeDiff(handle: IsolatedWorktree, opts?: {
+    timeoutMs?: number;
+}): WorktreeDiff;
+/**
+ * Remove a worktree and the branch that was made with it.
+ *
+ * Returns whether the directory is GONE, not whether git was happy: a removal
+ * that succeeded but left the directory (a file handle, a lock) has still left a
+ * directory in the operator's profile, and "removed: true" is the claim the
+ * console prints.
+ */
+export declare function discardWorktree(handle: IsolatedWorktree, opts?: {
+    timeoutMs?: number;
+}): boolean;
+/** ─── Lifecycle ────────────────────────────────────────────────────────────── */
+/** A started isolation: the worktree, or the refusal that replaced it. */
+export type IsolationStart = {
+    ok: true;
+    worktree: IsolatedWorktree;
+} | {
+    ok: false;
+    refusal: string;
+};
+/**
+ * Start isolation for a turn, or return null when nobody asked for one.
+ *
+ * Null and a refusal are different answers and both are load-bearing: null means
+ * the turn runs where it always did, and a refusal means the turn DOES NOT RUN.
+ */
+export declare function beginIsolation(input: {
+    request: IsolationRequest;
+    repoCwd: string;
+    label: string;
+}): IsolationStart | null;
+/** The environment a forked child reads, so a tool can say where it is running. */
+export declare function worktreeEnv(handle: IsolatedWorktree): Record<string, string>;
+/**
+ * Where the turn is running, said when it starts.
+ *
+ * The base commit is named as a commit AND as a branch, and the dirty count is
+ * reported when it is non-zero — the two facts that decide whether the diff at
+ * the end describes what the operator expected.
+ */
+export declare function worktreeNotice(handle: IsolatedWorktree): string;
+/** What the turn changed, what happened to the directory, and the diff itself. */
+export interface IsolationOutcome {
+    dir: string;
+    base: string;
+    diff: WorktreeDiff;
+    /** False when the directory was KEPT (`--keep-worktree`). */
+    removed: boolean;
+    /** The operator-facing line (see `worktreeNotice` / this module's `notice`). */
+    notice: string;
+}
+/**
+ * Finish isolation: measure the diff, then tear the worktree down (unless kept).
+ *
+ * Never throws — the caller attaches this to the turn's own result, and a git
+ * error must not replace an answer with a message about a directory.
+ */
+export declare function endIsolation(handle: IsolatedWorktree, opts: {
+    keep: boolean;
+}): IsolationOutcome;
+//# sourceMappingURL=worktree.d.ts.map

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

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