agent-nuvira 1.69.0 → 1.70.1

package/README.md

@@ -180,6 +180,37 @@ npm run build
 npm link
 ```
 
+### One-command setup for new users (recommended)
+
+If you're setting up on a **fresh machine** (or just don't want to deal with
+installing Node.js, Git, build tools, etc. by hand), use the platform setup
+script. Each one **checks for the required tools, installs anything missing
+for you, installs Agent-Nuvira, and then asks whether you want the optional
+performance upgrades** (native FAISS + local embeddings) — with plain-English
+prompts the whole way.
+
+| OS | Run this |
+|---|---|
+| **macOS** | `bash <(curl -fsSL https://raw.githubusercontent.com/imdheerajKube/agent-nuvira/main/scripts/setup/install-macos.sh)` |
+| **Linux** (Ubuntu/Debian/Fedora/RHEL/Arch/Alpine) | `bash <(curl -fsSL https://raw.githubusercontent.com/imdheerajKube/agent-nuvira/main/scripts/setup/install-linux.sh)` |
+| **Windows** (PowerShell) | `Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force; irm https://raw.githubusercontent.com/imdheerajKube/agent-nuvira/main/scripts/setup/install-windows.ps1 | iex` |
+
+What each script does:
+
+1. **Detects what's missing** — Node.js, npm, Git, build tools (and Homebrew on
+   macOS / `winget` on Windows), and installs them automatically (with your
+   confirmation) using the right installer for your OS.
+2. **Installs Agent-Nuvira** — `npm install -g agent-nuvira` (with npm 11's
+   install-script security gate handled automatically so native components build).
+3. **Asks about optional upgrades** (recommended, each a yes/no):
+   - **Native FAISS** → faster semantic search / memory recall
+   - **Local embeddings** → free, offline, private embeddings (no cloud call)
+4. **Verifies** the install and prints next steps.
+
+> The scripts are safe to re-run — they skip tools that are already present.
+> Manual install instructions for every step are below for those who prefer
+> full control.
+
 ### Native FAISS acceleration (optional, recommended)
 
 Agent-Nuvira includes an optional native FAISS backend for faster semantic retrieval. The runtime prefers this backend automatically when the native addon can build successfully; if that path is unavailable, it falls back to the pure-JS IVF implementation and then the exact JSON backend so your workflow stays reliable.
@@ -237,6 +268,26 @@ metadata filters don't miss results.
 
 If the native addon cannot be built on your machine, Agent-Nuvira will continue to work using the pure-JS fallback path.
 
+### Local embeddings (optional, recommended)
+
+Semantic search and memory recall use embeddings. Agent-Nuvira's embedder has a
+3-tier strategy and **always prefers the local tier when it works**:
+
+| Tier | Engine | Notes |
+|---|---|---|
+| **1 — Local** | `@huggingface/transformers` (`onnxruntime-node`) | Free, offline, private — `Xenova/all-MiniLM-L6-v2` (384-dim). **Default when available** |
+| **2 — Python** | `sentence-transformers` via subprocess | Used when Tier 1 is unavailable and Python is present |
+| **3 — LLM** | Any configured inference provider | Last-resort fallback; costs tokens |
+
+With `@huggingface/transformers` installed and its native binary present, no
+configuration is needed — local embeddings are used automatically, offline,
+with zero API cost. The one-command setup scripts above enable this for you.
+To verify which tier is active, run:
+
+```bash
+agent-nuvira memory backend --check
+```
+
 ### Verify
 
 ```bash

package/dist/agents/agents/planner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/agents/agents/planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAiB,MAAM,aAAa,CAAC;AACxF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAkH7C;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,8DAA8D;IAE5E,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAuQ9E;;;OAGG;IACH,OAAO,CAAC,SAAS;CAkClB"}
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/agents/agents/planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAiB,MAAM,aAAa,CAAC;AACxF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA0H7C;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,8DAA8D;IAE5E,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAuQ9E;;;OAGG;IACH,OAAO,CAAC,SAAS;CAkClB"}

package/dist/agents/agents/planner.js

@@ -35,6 +35,14 @@ const PLANNER_SYSTEM_PROMPT = [
     '   Use the description to specify the command: "Run: python hello.py" or "Run `node index.js`"',
     '   IMPORTANT: Only suggest "npm test" if the project already has a "test" script in its package.json!',
     '   Check the project structure above — if there\'s no test script, skip the test step.',
+    '   IMPORTANT — "deployable format" / packaging goals: when the goal asks for a',
+    '   deliverable that CANNOT RUN in this environment (an addon/plugin that needs',
+    '   its host app — e.g. an NVDA addon needs NVDA, an iOS app needs Xcode), do NOT',
+    '   plan a runner step that tries to execute it. Instead plan the runner step with',
+    '   the explicit PACKAGING command in backticks, e.g. "Run `zip -r myaddon.nvda-addon',
+    '   manifest.ini globalPlugins` to build the deployable addon", or a static check',
+    '   (e.g. "Run `python3 -m py_compile globalPlugins/*.py`"). The runner will build',
+    '   the artifact; it will not pretend the addon can execute outside its host.',
     '5. End with a "reviewer" step to validate the work',
     '6. Set dependsOn correctly so steps run in the right order',
     '7. Keep steps granular — each step should change at most 2-3 files',

package/dist/agents/agents/planner.js.map

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

package/dist/agents/agents/runner.d.ts

@@ -174,15 +174,60 @@ export declare class RunnerAgent extends Agent {
     /**
      * Ask the LLM for the NEXT command after a previous command failed.
      * This is what makes the repair loop ADAPT instead of re-running the same
-     * failing command: the LLM sees the task, the previous command, and its
-     * captured stdout/stderr, and proposes a corrected command (e.g. create the
-     * Cloudflare Pages project before deploying).
+     * failing command: the LLM sees the task, the previous command, its captured
+     * stdout/stderr, AND the full project context (written files + reference
+     * docs), and proposes a corrected command (e.g. create the Cloudflare Pages
+     * project before deploying, or — when the deliverable CANNOT run in this
+     * environment — the PACKAGING command that produces the deployable artifact).
      */
     private askLLMForRepairCommand;
     /**
      * Fallback: ask the LLM what command to run based on the project context.
-     * Includes project's package.json metadata so the LLM can make an informed choice.
+     * Includes the written file contents, package.json metadata, and curated
+     * reference docs (referenceDocsFor) so the LLM can choose a CORRECT action —
+     * including recognizing when the deliverable CANNOT run in this environment
+     * (a plugin/addon that needs its host app) and proposing the PACKAGING
+     * command that produces the deployable artifact instead of a useless run.
      */
     private askLLMForCommand;
+    /**
+     * Deterministic "cannot run here → package it" detection.
+     *
+     * When the project written for this task is a known addon/package whose
+     * runtime is NOT this machine (NVDA addon = manifest.ini + globalPlugins/
+     * needs the NVDA screen reader), running it can never succeed — the correct
+     * build action is to PACKAGE the source tree into the deployable artifact.
+     * This returns that packaging command, or null when no deterministic target
+     * exists (falls through to the LLM).
+     *
+     * Currently supports: NVDA addons (manifest.ini + globalPlugins/ → zip into
+     * a .nvda-addon archive, the real distribution format per the reference doc).
+     */
+    private detectPackagingCommand;
+    /**
+     * Detect a missing system tool referenced by a command (enterprise parity).
+     *
+     * Scans every token of the command (so compound commands like
+     * `cd addon && zip -r …` are covered), checks each against the known-tool
+     * recipes, and returns the FIRST missing tool name — or null when nothing
+     * is missing / unknown. Only the bare tool name is checked (paths like
+     * /usr/bin/zip are unwrapped to zip).
+     */
+    private detectMissingSystemTool;
+    /**
+     * Ensure every known system tool referenced by a command is installed.
+     *
+     * Enterprise flow (parity with a human agent):
+     * - Tool present → null (continue).
+     * - Tool missing + interactive TTY → ask the user with the OS-appropriate
+     *   install command. On 'install': execute it, verify, and continue. On
+     *   'manual'/'skip': return the manual steps as the error (the user takes
+     *   over the manual task — e.g. installing brew, generating a token).
+     * - Tool missing + non-interactive (piped/CI) → never block; return the
+     *   recommended install command as the error so the user can run it.
+     *
+     * Returns null to proceed, or an error string that fails the step.
+     */
+    private ensureSystemTool;
 }
 //# sourceMappingURL=runner.d.ts.map

package/dist/agents/agents/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/agents/agents/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAsB7C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,+CAA+C;IAC/C,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wEAAwE;IACxE,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4EAA4E;AAC5E,MAAM,WAAW,uBAAuB;IACtC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,iDAAiD;IAErE,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,CAAY;IAEvB,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IA+C9E;;;;;;OAMG;YACW,gBAAgB;IA4C9B;;;OAGG;YACW,iBAAiB;IAmG/B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;;OAGG;IACH;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAyBlC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAoDzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IA+HnB,4EAA4E;IAC5E,OAAO,CAAC,sBAAsB;IAyC9B,oFAAoF;IACpF,OAAO,CAAC,wBAAwB;IA+BhC,qDAAqD;IACrD,OAAO,CAAC,sBAAsB;IA0B9B,oDAAoD;IACpD,OAAO,CAAC,qBAAqB;IA2B7B,mDAAmD;IACnD,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAkC7B;;;;;;;;;OASG;IACH,OAAO,CAAC,mBAAmB;YA2Eb,aAAa;IA0J3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAKvB;;;;;;OAMG;YACW,sBAAsB;IA2CpC;;;OAGG;YACW,gBAAgB;CAqE/B"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/agents/agents/runner.ts"],"names":[],"mappings":"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"}

package/dist/agents/agents/runner.js

@@ -28,6 +28,8 @@ import { runShell, runShellSync } from '../../utils/shell.js';
 import { SandboxManager } from '../../sandbox/manager.js';
 import { detectProjectImage } from '../../sandbox/images.js';
 import { getSandboxConfig } from '../../sandbox/types.js';
+import { referenceDocsFor } from '../reference-docs.js';
+import { isKnownSystemTool, manualInstallSteps, promptToolInstall, toolInstallCommand, } from '../../cli/tool-install-prompt.js';
 /** Maximum stdout/stderr length to store in context metadata */
 const MAX_OUTPUT_LENGTH = 10_000;
 /** Timeout per command in milliseconds (default: 2 minutes) */
@@ -67,6 +69,25 @@ export class RunnerAgent extends Agent {
             // fix — otherwise the exit-127 repair loop just re-runs the same broken
             // `python …` command until the budget is exhausted.
             command = this.normalizeInterpreter(command);
+            // ENTERPRISE TOOL HANDLING: if the command needs a system tool that is
+            // not installed (e.g. `zip` for packaging), detect it BEFORE running and
+            // ask the user to approve an OS-appropriate install (interactive TTY) or
+            // surface the manual steps (non-interactive) — never fail silently and
+            // never install OS software without consent. On approval the install
+            // runs, the tool is verified, and the original command proceeds.
+            const toolOutcome = await this.ensureSystemTool(context, command);
+            if (toolOutcome !== null) {
+                // Either the user declined/skipped (return its error) or the install
+                // failed — the command cannot run without the tool.
+                if (context.metadata.verboseLogging) {
+                    logger.warn(`     🛠️  Missing system tool handling: ${toolOutcome}`);
+                }
+                return {
+                    success: false,
+                    summary: `Required tool not available: ${toolOutcome}`,
+                    error: toolOutcome,
+                };
+            }
             this.report(context, 'running', `Executing \`${command}\` and capturing output…`);
             // Check if we should run inside a Docker sandbox
             const useDocker = context.metadata.useDockerSandbox === true ||
@@ -817,27 +838,54 @@ export class RunnerAgent extends Agent {
         let depInstallSucceeded = false;
         let depInstallTool;
         let depInstallToolInstalled = false;
+        // Holds the actionable tool-install message when a missing system tool
+        // blocked the run (surfaced in the result error instead of the raw
+        // "command not found" so the user sees exactly what to do).
+        let toolBlockError = null;
         if (exitCode !== 0 && depRetries < MAX_DEP_INSTALL_RETRIES && this.looksLikeMissingDependency(command, stdout, stderr, execError)) {
-            if (context.metadata.verboseLogging) {
-                logger.info('     📦 Command failed — missing dependency detected, installing...');
-            }
-            // autoInstallTools defaults to true; set metadata.autoInstallTools=false
-            // to only run the install command without bootstrapping missing tools.
-            const autoInstallTools = context.metadata.autoInstallTools !== false;
-            const installResult = this.installDependencies(context.workingDirectory, autoInstallTools, command);
-            depInstallAttempted = true;
-            depInstallSucceeded = installResult.success;
-            depInstallTool = installResult.tool;
-            depInstallToolInstalled = installResult.toolInstalled === true;
-            if (context.metadata.verboseLogging) {
-                if (installResult.toolInstalled) {
-                    logger.info(`     🛠️  Auto-installed missing tool '${installResult.tool}'`);
+            // ENTERPRISE TOOL PATH FIRST: a "command not found" for a KNOWN system
+            // tool (e.g. `zip`, `git`, `make`) is NOT a project-dependency problem —
+            // it needs an OS-level install with user consent. Handle it here too
+            // (covers tools invoked mid-command by scripts), then re-run.
+            const missingTool = this.detectMissingSystemTool(command);
+            if (missingTool) {
+                const toolOutcome = await this.ensureSystemTool(context, command);
+                if (toolOutcome === null) {
+                    // Installed — retry the original command once.
+                    return this.executeOnHost(context, command, fallbackAttempts, depRetries + 1);
+                }
+                // User declined / install failed / non-interactive: fall through to
+                // record the failed run with the actionable message.
+                if (context.metadata.verboseLogging) {
+                    logger.info(`     🛠️  Tool '${missingTool}' not available — ${toolOutcome}`);
                 }
-                logger.info(`     📦 Dependency install ${installResult.success ? 'succeeded' : 'failed'}: ${installResult.command || installResult.message}`);
+                depInstallAttempted = true;
+                depInstallSucceeded = false;
+                depInstallTool = missingTool;
+                toolBlockError = toolOutcome;
             }
-            if (installResult.success) {
-                // Retry the original command once after a successful install
-                return this.executeOnHost(context, command, fallbackAttempts, depRetries + 1);
+            else {
+                if (context.metadata.verboseLogging) {
+                    logger.info('     📦 Command failed — missing dependency detected, installing...');
+                }
+                // autoInstallTools defaults to true; set metadata.autoInstallTools=false
+                // to only run the install command without bootstrapping missing tools.
+                const autoInstallTools = context.metadata.autoInstallTools !== false;
+                const installResult = this.installDependencies(context.workingDirectory, autoInstallTools, command);
+                depInstallAttempted = true;
+                depInstallSucceeded = installResult.success;
+                depInstallTool = installResult.tool;
+                depInstallToolInstalled = installResult.toolInstalled === true;
+                if (context.metadata.verboseLogging) {
+                    if (installResult.toolInstalled) {
+                        logger.info(`     🛠️  Auto-installed missing tool '${installResult.tool}'`);
+                    }
+                    logger.info(`     📦 Dependency install ${installResult.success ? 'succeeded' : 'failed'}: ${installResult.command || installResult.message}`);
+                }
+                if (installResult.success) {
+                    // Retry the original command once after a successful install
+                    return this.executeOnHost(context, command, fallbackAttempts, depRetries + 1);
+                }
             }
         }
         const runResult = {
@@ -847,7 +895,7 @@ export class RunnerAgent extends Agent {
             stdout: stdout.slice(0, MAX_OUTPUT_LENGTH),
             stderr: stderr.slice(0, MAX_OUTPUT_LENGTH),
             duration,
-            error: execError,
+            error: toolBlockError || execError,
             dependencyInstallAttempted: depInstallAttempted,
             dependencyInstallSucceeded: depInstallSucceeded,
             dependencyInstallTool: depInstallTool,
@@ -857,7 +905,7 @@ export class RunnerAgent extends Agent {
         if (depInstallAttempted) {
             this.report(context, depInstallSucceeded ? 'installed' : 'failed', depInstallSucceeded
                 ? 'Installed missing dependencies — re-running the command'
-                : `Dependency install failed (${depInstallTool || 'unknown tool'})`);
+                : toolBlockError || `Dependency install failed (${depInstallTool || 'unknown tool'})`);
         }
         context.metadata['dependencyInstallAttempted'] = depInstallAttempted;
         context.metadata['dependencyInstallSucceeded'] = depInstallSucceeded;
@@ -885,9 +933,11 @@ export class RunnerAgent extends Agent {
             success: exitCode === 0,
             summary: exitCode === 0
                 ? `✅ Command succeeded: ${command}`
-                : `❌ Command failed (exit ${exitCode}): ${command}`,
+                : toolBlockError
+                    ? `❌ Required tool not available: ${command}`
+                    : `❌ Command failed (exit ${exitCode}): ${command}`,
             details: lines.join('\n'),
-            error: execError && exitCode !== 0 ? execError : undefined,
+            error: (toolBlockError || execError) && exitCode !== 0 ? (toolBlockError || execError) : undefined,
         };
     }
     /**
@@ -901,11 +951,28 @@ export class RunnerAgent extends Agent {
     /**
      * Ask the LLM for the NEXT command after a previous command failed.
      * This is what makes the repair loop ADAPT instead of re-running the same
-     * failing command: the LLM sees the task, the previous command, and its
-     * captured stdout/stderr, and proposes a corrected command (e.g. create the
-     * Cloudflare Pages project before deploying).
+     * failing command: the LLM sees the task, the previous command, its captured
+     * stdout/stderr, AND the full project context (written files + reference
+     * docs), and proposes a corrected command (e.g. create the Cloudflare Pages
+     * project before deploying, or — when the deliverable CANNOT run in this
+     * environment — the PACKAGING command that produces the deployable artifact).
      */
     async askLLMForRepairCommand(context, callLLM, taskDescription) {
+        // DETERMINISTIC FAST-PATH: when the project is a known addon/package that
+        // cannot execute in this environment (e.g. an NVDA addon needs NVDA, an
+        // iOS app needs Xcode), a previous RUN attempt can never succeed — the
+        // correct action is to PACKAGE it (zip the source tree into the deployable
+        // artifact). Detecting this deterministically avoids asking a weak model
+        // to re-guess a run command (the observed failure: 3+ useless `python3
+        // globalPlugins/addon_main.py` variants). Falls through to the LLM when no
+        // deterministic package target exists.
+        const packaging = this.detectPackagingCommand(context);
+        if (packaging) {
+            if (context.metadata.verboseLogging) {
+                logger.info(`     📦 Deliverable cannot run here — proposing packaging command: ${packaging}`);
+            }
+            return packaging;
+        }
         const prev = context.metadata.runResult;
         const prevLines = prev
             ? [
@@ -915,17 +982,35 @@ export class RunnerAgent extends Agent {
                 prev.stderr ? `stderr:\n${prev.stderr.slice(0, 1500)}` : '',
             ].filter(Boolean).join('\n')
             : 'No previous run recorded.';
+        const filesChanged = context.fileChanges
+            .map((c) => {
+            const head = (c.newContent || '').slice(0, 400);
+            return `  - ${c.path} (${c.status})${head ? `:\n${head}${head.length >= 400 ? '…' : ''}` : ''}`;
+        })
+            .join('\n');
+        const referenceSection = referenceDocsFor(`${taskDescription} ${context.goal}`);
         const prompt = [
             'A command failed during execution. Propose the NEXT command to run.',
             '',
             `Task: ${taskDescription}`,
             '',
+            'Files that were just written for this task:',
+            filesChanged || '  (no files recorded)',
+            '',
+            referenceSection,
+            '',
             'The previous attempt failed:',
             prevLines,
             '',
-            'Analyze the failure and propose a corrected command that addresses the error',
-            '(e.g. create a missing project/configuration first, use a different flag, or',
-            'skip a step that is already done). Do NOT repeat the failed command unchanged.',
+            'Analyze the failure. IMPORTANT — decide what KIND of action is correct:',
+            '- If the deliverable CANNOT RUN in this environment (a plugin/addon that needs',
+            '  its host app, e.g. an NVDA addon needs NVDA; an iOS app needs Xcode), do NOT',
+            '  try to execute it. Instead propose the PACKAGING command that produces the',
+            '  deployable artifact (e.g. `zip -r myaddon.nvda-addon manifest.ini globalPlugins`)',
+            '  or a static verification (e.g. `python3 -m py_compile`).',
+            '- If it CAN run, address the error (create a missing project/config first,',
+            '  use a different flag, or skip a step that is already done).',
+            'Do NOT repeat the failed command unchanged.',
             '',
             'Return ONLY the single shell command to run next, with no explanation or markdown.',
         ].join('\n');
@@ -945,11 +1030,29 @@ export class RunnerAgent extends Agent {
     }
     /**
      * Fallback: ask the LLM what command to run based on the project context.
-     * Includes project's package.json metadata so the LLM can make an informed choice.
+     * Includes the written file contents, package.json metadata, and curated
+     * reference docs (referenceDocsFor) so the LLM can choose a CORRECT action —
+     * including recognizing when the deliverable CANNOT run in this environment
+     * (a plugin/addon that needs its host app) and proposing the PACKAGING
+     * command that produces the deployable artifact instead of a useless run.
      */
     async askLLMForCommand(context, callLLM) {
+        // DETERMINISTIC FAST-PATH (same as the repair path): if the written project
+        // is a known addon/package that cannot execute here, return the packaging
+        // command directly — a weak model asked "what command runs this?" will
+        // otherwise guess `python3 globalPlugins/addon_main.py` (observed live).
+        const packaging = this.detectPackagingCommand(context);
+        if (packaging) {
+            if (context.metadata.verboseLogging) {
+                logger.info(`     📦 Deliverable cannot run here — proposing packaging command: ${packaging}`);
+            }
+            return packaging;
+        }
         const fileList = context.fileChanges
-            .map((c) => `  - ${c.path} (${c.status})`)
+            .map((c) => {
+            const head = (c.newContent || '').slice(0, 400);
+            return `  - ${c.path} (${c.status})${head ? `:\n${head}${head.length >= 400 ? '…' : ''}` : ''}`;
+        })
             .join('\n');
         const artifactList = context.artifacts
             .slice(0, 5)
@@ -972,16 +1075,17 @@ export class RunnerAgent extends Agent {
         catch {
             // Ignore — scriptsInfo stays empty
         }
+        const referenceSection = referenceDocsFor(context.goal);
         const prompt = [
             'You are a build-and-run expert. Given the context below, what single shell command should be executed',
-            'to verify the work that was done?',
+            'to verify — or, when the deliverable cannot run here, to BUILD/PACKAGE — the work that was done?',
             '',
             'IMPORTANT: Check if "npm test" is available. Only suggest it if the project',
             'actually has a test script defined in package.json.',
             '',
             `Goal: ${context.goal}`,
             '',
-            'Files changed:',
+            'Files written:',
             fileList || '  (no files changed)',
             '',
             'Relevant project files:',
@@ -989,6 +1093,17 @@ export class RunnerAgent extends Agent {
             '',
             scriptsInfo || 'No npm scripts available.',
             '',
+            referenceSection,
+            '',
+            'Decide what KIND of action is correct:',
+            '- If the deliverable is a plugin/addon that needs its host application (e.g. an NVDA',
+            '  addon needs NVDA; an iOS app needs Xcode), it CANNOT run in this environment.',
+            '  Do NOT try to execute it. Propose the PACKAGING command that produces the',
+            '  deployable artifact (e.g. `zip -r myaddon.nvda-addon manifest.ini globalPlugins`)',
+            '  or a static verification (e.g. `python3 -m py_compile`).',
+            '- Otherwise propose the command that runs/verifies the work (e.g. "python hello.py",',
+            '  "node index.js", "go run main.go").',
+            '',
             'Return ONLY the command to run. Examples: "python hello.py" or "node index.js" or "go run main.go".',
             'Rules:',
             '- Return a single line command only',
@@ -1012,5 +1127,121 @@ export class RunnerAgent extends Agent {
         }
         return null;
     }
+    /**
+     * Deterministic "cannot run here → package it" detection.
+     *
+     * When the project written for this task is a known addon/package whose
+     * runtime is NOT this machine (NVDA addon = manifest.ini + globalPlugins/
+     * needs the NVDA screen reader), running it can never succeed — the correct
+     * build action is to PACKAGE the source tree into the deployable artifact.
+     * This returns that packaging command, or null when no deterministic target
+     * exists (falls through to the LLM).
+     *
+     * Currently supports: NVDA addons (manifest.ini + globalPlugins/ → zip into
+     * a .nvda-addon archive, the real distribution format per the reference doc).
+     */
+    detectPackagingCommand(context) {
+        const cwd = context.workingDirectory;
+        const hasManifest = existsSync(join(cwd, 'manifest.ini'));
+        const hasPlugins = existsSync(join(cwd, 'globalPlugins'));
+        if (!hasManifest || !hasPlugins)
+            return null;
+        // Only trigger for NVDA-addon goals — manifest.ini alone is ambiguous.
+        const goalText = `${context.goal} ${(context.taskPlan || []).map((s) => s.description).join(' ')}`.toLowerCase();
+        if (!goalText.includes('nvda') && !goalText.includes('addon'))
+            return null;
+        // Addon name: read from manifest.ini ([addon] name = X) or fall back to
+        // the working-directory basename — sanitized for a safe zip target.
+        let addonName = '';
+        try {
+            const manifest = readFileSync(join(cwd, 'manifest.ini'), 'utf-8');
+            const nameMatch = manifest.match(/^\s*name\s*=\s*(.+?)\s*$/m);
+            if (nameMatch)
+                addonName = nameMatch[1].trim();
+        }
+        catch {
+            // Fall through to dir basename below.
+        }
+        if (!addonName)
+            addonName = cwd.split(/[\\/]/).pop() || 'addon';
+        const safe = addonName.replace(/[^a-zA-Z0-9._-]/g, '-').replace(/-+/g, '-');
+        return `zip -r ${safe}.nvda-addon manifest.ini globalPlugins`;
+    }
+    /**
+     * Detect a missing system tool referenced by a command (enterprise parity).
+     *
+     * Scans every token of the command (so compound commands like
+     * `cd addon && zip -r …` are covered), checks each against the known-tool
+     * recipes, and returns the FIRST missing tool name — or null when nothing
+     * is missing / unknown. Only the bare tool name is checked (paths like
+     * /usr/bin/zip are unwrapped to zip).
+     */
+    detectMissingSystemTool(command) {
+        if (!command)
+            return null;
+        const tokens = command.split(/[\s;&|]+/).filter(Boolean);
+        for (const token of tokens) {
+            if (token.startsWith('-') || token.startsWith('--'))
+                continue; // flags
+            const tool = token.split(/[\\/]/).pop() || token; // handle paths
+            if (!isKnownSystemTool(tool))
+                continue;
+            if (!this.commandExists(tool))
+                return tool;
+        }
+        return null;
+    }
+    /**
+     * Ensure every known system tool referenced by a command is installed.
+     *
+     * Enterprise flow (parity with a human agent):
+     * - Tool present → null (continue).
+     * - Tool missing + interactive TTY → ask the user with the OS-appropriate
+     *   install command. On 'install': execute it, verify, and continue. On
+     *   'manual'/'skip': return the manual steps as the error (the user takes
+     *   over the manual task — e.g. installing brew, generating a token).
+     * - Tool missing + non-interactive (piped/CI) → never block; return the
+     *   recommended install command as the error so the user can run it.
+     *
+     * Returns null to proceed, or an error string that fails the step.
+     */
+    async ensureSystemTool(context, command) {
+        const tool = this.detectMissingSystemTool(command);
+        if (!tool)
+            return null;
+        const installCmd = toolInstallCommand(tool, process.platform, (name) => this.commandExists(name));
+        const recommended = installCmd || `brew install ${tool}  # macOS  |  sudo apt-get install -y ${tool}  # Linux  |  winget install ${tool}  # Windows`;
+        if (context.metadata.verboseLogging) {
+            logger.warn(`     🛠️  Missing system tool: '${tool}' (recommended: ${recommended})`);
+        }
+        // Non-interactive — surface the manual steps, never block.
+        if (!process.stdin.isTTY) {
+            return manualInstallSteps(tool, recommended);
+        }
+        let choice;
+        try {
+            choice = await promptToolInstall(tool, recommended);
+        }
+        catch {
+            // Prompt failed (no TTY after all) — treat as manual.
+            return manualInstallSteps(tool, recommended);
+        }
+        if (choice === 'manual' || choice === 'skip') {
+            return choice === 'manual'
+                ? manualInstallSteps(tool, recommended)
+                : `Skipped installing '${tool}' — the step was not run. Install it manually (${recommended}) and re-run the task.`;
+        }
+        // 'install' — execute the recommended command, verify, continue.
+        logger.info(`     🛠️  Installing '${tool}' via: ${recommended}`);
+        const installResult = this.runInstallCommand(recommended, context.workingDirectory);
+        if (!installResult.success) {
+            return `Failed to auto-install '${tool}' (${installResult.message || 'install command failed'}).\n${manualInstallSteps(tool, recommended)}`;
+        }
+        if (!this.commandExists(tool)) {
+            return `Installed '${tool}' but it is not on PATH for this process yet — open a new terminal and re-run, or: ${recommended}`;
+        }
+        logger.success(`     ✅ Installed '${tool}' — continuing.`);
+        return null;
+    }
 }
 //# sourceMappingURL=runner.js.map