agent-nuvira 1.37.2 → 1.38.1

package/README.md

@@ -52,6 +52,10 @@ agent-nuvira config list
 - **MCP (Model Context Protocol) integration** — connect to databases, APIs, and file systems via MCP servers with SSE transport support
 - **AST-aware code editing** — structural analysis engine understands functions, classes, methods across JS/TS/Python/Go/Rust
 - **Auto error-repair engine** — automatic diagnosis and repair of test failures with configurable retry budgets
+- **Cross-platform dependency installer (Runner)** — auto-detects 11 manifest types (npm/pnpm/yarn with
+  lockfile-first priority, pip, bundler, cargo, go, composer, dart pub), installs missing project dependencies
+  on failed commands, and bootstrap-installs missing package managers (npm, pip, bundler, cargo, go, composer,
+  dart, Homebrew) via brew/apt/dnf/yum/winget/choco/rustup — no manual setup required
 - **A2A (Agent-to-Agent) Protocol** — inter-agent communication standard for multi-machine collaboration
 - **CI/CD headless mode** — `buff ci` for automated pipelines with GitHub Actions integration
 - **npm publishing & one-line install** — `npx agent-nuvira` and `npx buff` for zero-setup onboarding

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

@@ -40,6 +40,36 @@ export interface RunResult {
     duration: number;
     /** Error message if execSync threw */
     error?: string;
+    /** Whether dependencies were auto-installed before a retry */
+    dependencyInstallAttempted?: boolean;
+    /** Whether the dependency install succeeded */
+    dependencyInstallSucceeded?: boolean;
+    /** Package manager / tool used for the install (e.g. 'npm', 'brew', 'winget') */
+    dependencyInstallTool?: string;
+    /** Whether the tool itself had to be installed first (e.g. Homebrew) */
+    dependencyInstallToolInstalled?: boolean;
+}
+/** A detected dependency-install plan for a project */
+export interface InstallPlan {
+    /** The package-manager tool to run (e.g. 'npm', 'pip', 'brew', 'cargo') */
+    tool: string;
+    /** The full install command to execute */
+    command: string;
+    /** The manifest file that triggered the plan */
+    manifest: string;
+}
+/** Result of a dependency-install attempt (including tool bootstrapping) */
+export interface DependencyInstallResult {
+    /** Whether the install succeeded */
+    success: boolean;
+    /** The install command that was attempted */
+    command: string;
+    /** The package-manager tool used */
+    tool?: string;
+    /** Whether the tool itself was installed first */
+    toolInstalled?: boolean;
+    /** Human-readable detail for logs */
+    message?: string;
 }
 /**
  * RunnerAgent — Executes shell commands and captures output.
@@ -73,6 +103,58 @@ export declare class RunnerAgent extends Agent {
      * Execute a command directly on the host machine.
      * Validates the command first, and falls back to LLM suggestion if the command is not available.
      */
+    /**
+     * Heuristic: does this failure look like a missing dependency?
+     * Matches common "Cannot find module", "command not found", and ENOENT errors.
+     */
+    private looksLikeMissingDependency;
+    /**
+     * Detect which package manager a project needs based on its manifest files.
+     * Supports npm/yarn/pnpm, pip (requirements/setup/pyproject), bundler,
+     * cargo, go, composer, and dart pub.
+     */
+    private detectInstallPlan;
+    /**
+     * Check whether a CLI tool is available on PATH (cross-platform).
+     */
+    private commandExists;
+    /**
+     * Bootstrap-install a missing package-manager tool so that the project's
+     * dependencies can be installed. Handles Homebrew, winget, choco, npm,
+     * pip, cargo, and more — installing the tool itself if it is missing.
+     */
+    private installTool;
+    /** Install Node.js (which bundles npm) via the platform package manager. */
+    private installNodeViaPlatform;
+    /** Install Python via the platform package manager (so pip can be bootstrapped). */
+    private installPythonViaPlatform;
+    /** Install Ruby via the platform package manager. */
+    private installRubyViaPlatform;
+    /** Install PHP via the platform package manager. */
+    private installPhpViaPlatform;
+    /** Install Go via the platform package manager. */
+    private installGoViaPlatform;
+    /**
+     * Run an install command and return its outcome.
+     */
+    private runInstallCommand;
+    /**
+     * When no manifest exists, detect a missing interpreter/tool from the failed
+     * command itself (e.g. "python3 script.py" → python3 → install Python).
+     * This lets the runner install bare tools even in manifest-less directories.
+     */
+    private detectToolFromCommand;
+    /**
+     * Install dependencies for the project using the appropriate package manager
+     * (npm, pip, brew, cargo, etc.). If the package manager itself is missing,
+     * it is bootstrap-installed first (e.g. Homebrew on macOS, winget on Windows).
+     * When no manifest is present, falls back to installing the missing
+     * interpreter/tool referenced by the failed command.
+     *
+     * Controlled by context.metadata.autoInstallTools !== false — set to false
+     * to only attempt the install command without installing missing tools.
+     */
+    private installDependencies;
     private executeOnHost;
     /**
      * Fallback: ask the LLM what command to run based on the project context.

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;AAMH,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgB7C;;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;CAChB;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;IAoC9E;;;;;;OAMG;YACW,gBAAgB;IAyB9B;;;OAGG;YACW,iBAAiB;IAmG/B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;;OAGG;YACW,aAAa;IA+G3B;;;OAGG;YACW,gBAAgB;CAqE/B"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/agents/agents/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,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;IAoC9E;;;;;;OAMG;YACW,gBAAgB;IAyB9B;;;OAGG;YACW,iBAAiB;IAmG/B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;;OAGG;IACH;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAyBlC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAoDzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;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;IAgBzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAkC7B;;;;;;;;;OASG;IACH,OAAO,CAAC,mBAAmB;YAwEb,aAAa;IA4J3B;;;OAGG;YACW,gBAAgB;CAqE/B"}