@n-dx/core 0.1.0

package/packages/llm-client/dist/exec.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Centralized process execution abstraction.
+ *
+ * Generic child-process helpers that any n-dx package can use instead of
+ * importing `execFile` / `execFileSync` directly from `node:child_process`.
+ *
+ * By centralizing execution here — in the foundation layer — domain packages
+ * (rex, sourcevision) and execution packages (hench, web) get consistent
+ * timeout, buffer, and error-handling behaviour without duplicating the
+ * same `execFile` callback boilerplate.
+ *
+ * ## Scope
+ *
+ * Two complementary patterns:
+ *
+ * 1. **Fire-and-collect** (`exec`, `execStdout`, `execShellCmd`) — run a
+ *    command, wait for it to finish, return structured output.
+ * 2. **Spawn-and-delegate** (`spawnTool`) — spawn a Node script with
+ *    inherited stdio (or piped output), wait for its exit code.
+ *
+ * Both patterns return structured results and never reject unexpectedly.
+ * For fully **streaming** use-cases (e.g. spawning Claude CLI and parsing
+ * events as they arrive), use `spawn` directly.
+ *
+ * @module @n-dx/llm-client/exec
+ */
+/** Result from a command execution with full output details. */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    /** null when the process was killed (e.g. timeout). */
+    exitCode: number | null;
+    error: Error | null;
+}
+/** Options shared by all exec helpers. */
+export interface ExecOptions {
+    /** Working directory for the child process. */
+    cwd: string;
+    /** Timeout in milliseconds. */
+    timeout: number;
+    /** Maximum output buffer in bytes. Defaults to 1 MiB. */
+    maxBuffer?: number;
+    /** Environment variables for the child process. Defaults to inheriting parent env. */
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Execute a command and return structured output.
+ *
+ * This is the primary abstraction — all other helpers build on it.
+ * Resolves (never rejects) so callers can inspect exitCode/error directly.
+ */
+export declare function exec(cmd: string, args: string[], opts: ExecOptions): Promise<ExecResult>;
+/**
+ * Execute a command and return stdout only (stderr and errors are silently ignored).
+ *
+ * Useful for git commands where you only care about the output text.
+ */
+export declare function execStdout(cmd: string, args: string[], opts: ExecOptions): Promise<string>;
+/**
+ * Execute a shell command string (via `sh -c`).
+ *
+ * Wraps the command in a shell for glob expansion, pipes, etc.
+ */
+export declare function execShellCmd(command: string, opts: ExecOptions): Promise<ExecResult>;
+/**
+ * Synchronous git helper — get the current HEAD commit hash.
+ *
+ * Returns undefined if git fails (e.g. not a git repo).
+ */
+export declare function getCurrentHead(cwd: string): string | undefined;
+/**
+ * Synchronous git helper — get the current branch name.
+ *
+ * Returns undefined if git fails (e.g. not a git repo or detached HEAD).
+ */
+export declare function getCurrentBranch(cwd: string): string | undefined;
+/**
+ * Synchronous helper — check whether an executable is on PATH.
+ *
+ * Uses `which` to locate the binary. Returns true if found, false otherwise.
+ */
+export declare function isExecutableOnPath(name: string): boolean;
+/** Options for {@link spawnTool}. */
+export interface SpawnToolOptions {
+    /** Working directory for the child process. */
+    cwd?: string;
+    /** Environment variables. Defaults to inheriting parent env. */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * How to wire stdio.
+     *
+     * - `"inherit"` — child shares the parent's stdin/stdout/stderr (default).
+     * - `"pipe"` — capture stdout and stderr; return them in the result.
+     */
+    stdio?: "inherit" | "pipe";
+    /**
+     * When true, spawn the process detached and un-ref it so the parent
+     * can exit without waiting. Implies `stdio: "ignore"` (overrides
+     * the `stdio` option). Returns immediately with `exitCode: 0`.
+     */
+    detached?: boolean;
+    /**
+     * Timeout in milliseconds. When elapsed, the child is killed (SIGTERM,
+     * then SIGKILL after 5 s) and the result resolves with `exitCode: null`.
+     *
+     * 0 or undefined = no timeout (wait indefinitely).
+     */
+    timeout?: number;
+}
+/** Result from {@link spawnTool}. */
+export interface SpawnToolResult {
+    exitCode: number | null;
+    /** Populated only when `stdio: "pipe"`. */
+    stdout: string;
+    /** Populated only when `stdio: "pipe"`. */
+    stderr: string;
+}
+/**
+ * Handle returned by {@link spawnManaged}.
+ *
+ * Unlike {@link spawnTool} (which returns a bare `Promise`), this gives
+ * callers a reference to the underlying process so they can send signals
+ * (e.g. `handle.kill("SIGINT")`) while still awaiting the completion
+ * promise.
+ */
+export interface ManagedChild {
+    /** Resolves when the child exits. */
+    readonly done: Promise<SpawnToolResult>;
+    /** Send a signal to the child process. Returns `true` if the signal was sent. */
+    kill(signal?: NodeJS.Signals): boolean;
+    /** The child's PID (undefined if the process failed to spawn). */
+    readonly pid: number | undefined;
+}
+/**
+ * Spawn a Node script (or other executable) as a child process.
+ *
+ * Covers the **spawn-and-delegate** pattern used by orchestration and
+ * delegation code: start a tool, optionally inherit stdio, wait for it
+ * to finish.
+ *
+ * Unlike {@link exec}, this uses `spawn` (not `execFile`) so it supports
+ * long-running processes without buffer limits when stdio is inherited.
+ *
+ * @param cmd  The executable to run (e.g. `process.execPath` for Node).
+ * @param args Command-line arguments.
+ * @param opts Options controlling cwd, env, and stdio wiring.
+ */
+export declare function spawnTool(cmd: string, args: string[], opts?: SpawnToolOptions): Promise<SpawnToolResult>;
+/**
+ * Spawn a long-running child process and return a managed handle.
+ *
+ * Like {@link spawnTool}, but returns a {@link ManagedChild} handle that
+ * exposes both a completion promise (`done`) **and** the ability to send
+ * signals to the child (via `kill()`).  This is the correct abstraction
+ * when the caller needs to cancel or pause the child — e.g. the web
+ * dashboard pausing a hench execution.
+ *
+ * Never use raw `spawn` from `node:child_process` for this pattern.
+ *
+ * @param cmd  The executable to run.
+ * @param args Command-line arguments.
+ * @param opts Options controlling cwd, env, and stdio wiring.
+ */
+export declare function spawnManaged(cmd: string, args: string[], opts?: SpawnToolOptions): ManagedChild;
+/**
+ * Gracefully terminate a managed child process, escalating to SIGKILL if needed.
+ *
+ * 1. Sends `SIGTERM` to the child.
+ * 2. Waits up to `gracePeriodMs` for the child to exit naturally.
+ * 3. If the child is still alive after the grace period, sends `SIGKILL`.
+ * 4. Waits up to {@link SHUTDOWN_KILL_ESCALATION_MS} for SIGKILL to take effect.
+ *
+ * Resolves once the child has exited or all signals have been delivered.
+ * Never rejects — errors during kill are silently swallowed.
+ *
+ * @param handle       Managed child handle returned by {@link spawnManaged}.
+ * @param gracePeriodMs  How long to wait for graceful exit before SIGKILL.
+ *                       Defaults to 5 seconds.
+ */
+export declare function killWithFallback(handle: ManagedChild, gracePeriodMs?: number): Promise<void>;
+/**
+ * Error thrown when a {@link ProcessPool} rejects a spawn because the
+ * concurrency limit has been reached.
+ */
+export declare class ProcessLimitError extends Error {
+    constructor(limit: number);
+}
+/**
+ * Bounded pool that limits how many child processes can run concurrently.
+ *
+ * Wraps {@link spawnTool} and {@link spawnManaged} so callers keep their
+ * familiar API while the pool enforces a ceiling on parallel processes.
+ * When the limit is reached, new spawns are rejected immediately with a
+ * {@link ProcessLimitError} (fail-fast, no queuing — an autonomous agent
+ * should not silently block).
+ *
+ * @example
+ * ```ts
+ * const pool = new ProcessPool(4);
+ *
+ * // Each spawn counts against the limit and auto-releases on exit.
+ * const result = await pool.spawn("node", ["script.js"], { cwd: "/tmp" });
+ *
+ * // For managed processes, the handle still exposes kill/pid/done.
+ * const handle = pool.spawnManaged("node", ["server.js"], { stdio: "pipe" });
+ * // ... handle.kill("SIGTERM") when done
+ * ```
+ */
+export declare class ProcessPool {
+    private readonly _limit;
+    private _active;
+    constructor(limit: number);
+    /** Maximum concurrent processes allowed. */
+    get limit(): number;
+    /** Number of processes currently tracked by the pool. */
+    get active(): number;
+    /**
+     * Spawn a child process through the pool.
+     *
+     * Same signature as {@link spawnTool}. Throws {@link ProcessLimitError}
+     * if the pool is full.
+     */
+    spawn(cmd: string, args: string[], opts?: SpawnToolOptions): Promise<SpawnToolResult>;
+    /**
+     * Spawn a managed child process through the pool.
+     *
+     * Same signature as {@link spawnManaged}. Throws {@link ProcessLimitError}
+     * if the pool is full. The slot is released when the child exits.
+     */
+    spawnManaged(cmd: string, args: string[], opts?: SpawnToolOptions): ManagedChild;
+}

package/packages/llm-client/dist/exec.js

@@ -0,0 +1,440 @@
+/**
+ * Centralized process execution abstraction.
+ *
+ * Generic child-process helpers that any n-dx package can use instead of
+ * importing `execFile` / `execFileSync` directly from `node:child_process`.
+ *
+ * By centralizing execution here — in the foundation layer — domain packages
+ * (rex, sourcevision) and execution packages (hench, web) get consistent
+ * timeout, buffer, and error-handling behaviour without duplicating the
+ * same `execFile` callback boilerplate.
+ *
+ * ## Scope
+ *
+ * Two complementary patterns:
+ *
+ * 1. **Fire-and-collect** (`exec`, `execStdout`, `execShellCmd`) — run a
+ *    command, wait for it to finish, return structured output.
+ * 2. **Spawn-and-delegate** (`spawnTool`) — spawn a Node script with
+ *    inherited stdio (or piped output), wait for its exit code.
+ *
+ * Both patterns return structured results and never reject unexpectedly.
+ * For fully **streaming** use-cases (e.g. spawning Claude CLI and parsing
+ * events as they arrive), use `spawn` directly.
+ *
+ * @module @n-dx/llm-client/exec
+ */
+import { execFile, execFileSync, spawn } from "node:child_process";
+// ---------------------------------------------------------------------------
+// Default
+// ---------------------------------------------------------------------------
+const DEFAULT_MAX_BUFFER = 1024 * 1024; // 1 MiB
+// ---------------------------------------------------------------------------
+// Core exec
+// ---------------------------------------------------------------------------
+/**
+ * Execute a command and return structured output.
+ *
+ * This is the primary abstraction — all other helpers build on it.
+ * Resolves (never rejects) so callers can inspect exitCode/error directly.
+ */
+export function exec(cmd, args, opts) {
+    const { cwd, timeout, maxBuffer = DEFAULT_MAX_BUFFER, env } = opts;
+    return new Promise((resolve) => {
+        execFile(cmd, args, { cwd, timeout, maxBuffer, env }, (error, stdout, stderr) => {
+            const isTimeout = error
+                ? error.code === "ETIMEDOUT" ||
+                    error.killed === true
+                : false;
+            resolve({
+                stdout: (stdout ?? "").toString(),
+                stderr: (stderr ?? "").toString(),
+                exitCode: error
+                    ? (isTimeout
+                        ? null
+                        : typeof error.code === "number"
+                            ? (error.code ?? 1)
+                            : 1)
+                    : 0,
+                error: error,
+            });
+        });
+    });
+}
+/**
+ * Execute a command and return stdout only (stderr and errors are silently ignored).
+ *
+ * Useful for git commands where you only care about the output text.
+ */
+export function execStdout(cmd, args, opts) {
+    const { cwd, timeout, maxBuffer = DEFAULT_MAX_BUFFER, env } = opts;
+    return new Promise((resolve) => {
+        execFile(cmd, args, { cwd, timeout, maxBuffer, env }, (_error, stdout) => {
+            resolve((stdout ?? "").toString());
+        });
+    });
+}
+/**
+ * Execute a shell command string (via `sh -c`).
+ *
+ * Wraps the command in a shell for glob expansion, pipes, etc.
+ */
+export function execShellCmd(command, opts) {
+    return exec("sh", ["-c", command], opts);
+}
+/**
+ * Synchronous git helper — get the current HEAD commit hash.
+ *
+ * Returns undefined if git fails (e.g. not a git repo).
+ */
+export function getCurrentHead(cwd) {
+    try {
+        return execFileSync("git", ["rev-parse", "HEAD"], {
+            cwd,
+            encoding: "utf-8",
+        }).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Synchronous git helper — get the current branch name.
+ *
+ * Returns undefined if git fails (e.g. not a git repo or detached HEAD).
+ */
+export function getCurrentBranch(cwd) {
+    try {
+        const branch = execFileSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+            cwd,
+            encoding: "utf-8",
+        }).trim();
+        return branch || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Synchronous helper — check whether an executable is on PATH.
+ *
+ * Uses `which` to locate the binary. Returns true if found, false otherwise.
+ */
+export function isExecutableOnPath(name) {
+    try {
+        const cmd = process.platform === "win32" ? "where" : "which";
+        execFileSync(cmd, [name], { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Spawn-and-delegate
+// ---------------------------------------------------------------------------
+/** Grace period before escalating SIGTERM → SIGKILL on timeout. */
+const KILL_ESCALATION_MS = 5_000;
+/**
+ * Spawn a Node script (or other executable) as a child process.
+ *
+ * Covers the **spawn-and-delegate** pattern used by orchestration and
+ * delegation code: start a tool, optionally inherit stdio, wait for it
+ * to finish.
+ *
+ * Unlike {@link exec}, this uses `spawn` (not `execFile`) so it supports
+ * long-running processes without buffer limits when stdio is inherited.
+ *
+ * @param cmd  The executable to run (e.g. `process.execPath` for Node).
+ * @param args Command-line arguments.
+ * @param opts Options controlling cwd, env, and stdio wiring.
+ */
+export function spawnTool(cmd, args, opts = {}) {
+    const { cwd, env, detached = false, timeout } = opts;
+    // Detached mode: fire and forget
+    if (detached) {
+        const child = spawn(cmd, args, {
+            cwd,
+            env,
+            stdio: "ignore",
+            detached: true,
+        });
+        child.unref();
+        return Promise.resolve({
+            exitCode: 0,
+            stdout: "",
+            stderr: "",
+        });
+    }
+    const stdio = opts.stdio ?? "inherit";
+    return new Promise((resolve) => {
+        const child = spawn(cmd, args, {
+            cwd,
+            env,
+            stdio: stdio === "pipe" ? ["ignore", "pipe", "pipe"] : "inherit",
+        });
+        let stdout = "";
+        let stderr = "";
+        let resolved = false;
+        let timer;
+        let killTimer;
+        const finish = (exitCode) => {
+            if (resolved)
+                return;
+            resolved = true;
+            if (timer)
+                clearTimeout(timer);
+            if (killTimer)
+                clearTimeout(killTimer);
+            resolve({ exitCode, stdout, stderr });
+        };
+        if (timeout && timeout > 0) {
+            timer = setTimeout(() => {
+                timer = undefined;
+                child.kill("SIGTERM");
+                // Escalate to SIGKILL after grace period if still alive
+                killTimer = setTimeout(() => child.kill("SIGKILL"), KILL_ESCALATION_MS);
+                // Resolve immediately — caller sees timeout (exitCode: null).
+                // killTimer stays active as a cleanup safety net until the child
+                // actually exits (handled by the "close" listener clearing it).
+                resolved = true;
+                resolve({ exitCode: null, stdout, stderr });
+            }, timeout);
+        }
+        if (stdio === "pipe") {
+            child.stdout.on("data", (chunk) => {
+                stdout += chunk.toString();
+            });
+            child.stderr.on("data", (chunk) => {
+                stderr += chunk.toString();
+            });
+        }
+        child.on("error", () => {
+            finish(1);
+        });
+        child.on("close", (code) => {
+            finish(code ?? 1);
+        });
+    });
+}
+/**
+ * Spawn a long-running child process and return a managed handle.
+ *
+ * Like {@link spawnTool}, but returns a {@link ManagedChild} handle that
+ * exposes both a completion promise (`done`) **and** the ability to send
+ * signals to the child (via `kill()`).  This is the correct abstraction
+ * when the caller needs to cancel or pause the child — e.g. the web
+ * dashboard pausing a hench execution.
+ *
+ * Never use raw `spawn` from `node:child_process` for this pattern.
+ *
+ * @param cmd  The executable to run.
+ * @param args Command-line arguments.
+ * @param opts Options controlling cwd, env, and stdio wiring.
+ */
+export function spawnManaged(cmd, args, opts = {}) {
+    const { cwd, env, timeout } = opts;
+    const stdio = opts.stdio ?? "inherit";
+    const child = spawn(cmd, args, {
+        cwd,
+        env,
+        stdio: stdio === "pipe" ? ["ignore", "pipe", "pipe"] : "inherit",
+    });
+    const done = new Promise((resolve) => {
+        let stdout = "";
+        let stderr = "";
+        let resolved = false;
+        let timer;
+        let killTimer;
+        const finish = (exitCode) => {
+            if (resolved)
+                return;
+            resolved = true;
+            if (timer)
+                clearTimeout(timer);
+            if (killTimer)
+                clearTimeout(killTimer);
+            resolve({ exitCode, stdout, stderr });
+        };
+        if (timeout && timeout > 0) {
+            timer = setTimeout(() => {
+                timer = undefined;
+                child.kill("SIGTERM");
+                // Escalate to SIGKILL after grace period if still alive
+                killTimer = setTimeout(() => child.kill("SIGKILL"), KILL_ESCALATION_MS);
+                // Resolve immediately — caller sees timeout (exitCode: null).
+                // killTimer stays active as a cleanup safety net until the child
+                // actually exits (handled by the "close" listener clearing it).
+                resolved = true;
+                resolve({ exitCode: null, stdout, stderr });
+            }, timeout);
+        }
+        if (stdio === "pipe") {
+            child.stdout.on("data", (chunk) => {
+                stdout += chunk.toString();
+            });
+            child.stderr.on("data", (chunk) => {
+                stderr += chunk.toString();
+            });
+        }
+        child.on("error", () => {
+            finish(1);
+        });
+        child.on("close", (code) => {
+            finish(code);
+        });
+    });
+    return {
+        done,
+        kill(signal) {
+            try {
+                return child.kill(signal);
+            }
+            catch {
+                return false;
+            }
+        },
+        get pid() {
+            return child.pid;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Graceful termination with force-kill fallback
+// ---------------------------------------------------------------------------
+/** Grace period before escalating SIGTERM → SIGKILL during graceful shutdown. */
+const SHUTDOWN_KILL_ESCALATION_MS = 1_000;
+/**
+ * Gracefully terminate a managed child process, escalating to SIGKILL if needed.
+ *
+ * 1. Sends `SIGTERM` to the child.
+ * 2. Waits up to `gracePeriodMs` for the child to exit naturally.
+ * 3. If the child is still alive after the grace period, sends `SIGKILL`.
+ * 4. Waits up to {@link SHUTDOWN_KILL_ESCALATION_MS} for SIGKILL to take effect.
+ *
+ * Resolves once the child has exited or all signals have been delivered.
+ * Never rejects — errors during kill are silently swallowed.
+ *
+ * @param handle       Managed child handle returned by {@link spawnManaged}.
+ * @param gracePeriodMs  How long to wait for graceful exit before SIGKILL.
+ *                       Defaults to 5 seconds.
+ */
+export async function killWithFallback(handle, gracePeriodMs = 5_000) {
+    if (handle.pid === undefined)
+        return;
+    // Send graceful signal — catch in case the process has already exited and
+    // the underlying `child.kill()` throws ESRCH.
+    try {
+        handle.kill("SIGTERM");
+    }
+    catch {
+        return; // already gone
+    }
+    let timedOut = false;
+    await Promise.race([
+        handle.done.then(() => { }),
+        new Promise((resolve) => {
+            setTimeout(() => {
+                timedOut = true;
+                resolve();
+            }, gracePeriodMs);
+        }),
+    ]);
+    if (timedOut) {
+        // Force-kill the unresponsive process
+        try {
+            handle.kill("SIGKILL");
+        }
+        catch {
+            // Ignore — process may have exited between the timeout check and the kill
+        }
+        // Give SIGKILL a moment to take effect before returning
+        await Promise.race([
+            handle.done.then(() => { }),
+            new Promise((resolve) => setTimeout(resolve, SHUTDOWN_KILL_ESCALATION_MS)),
+        ]);
+    }
+}
+// ---------------------------------------------------------------------------
+// Concurrent process limiting
+// ---------------------------------------------------------------------------
+/**
+ * Error thrown when a {@link ProcessPool} rejects a spawn because the
+ * concurrency limit has been reached.
+ */
+export class ProcessLimitError extends Error {
+    constructor(limit) {
+        super(`Concurrent process limit reached (max ${limit})`);
+        this.name = "ProcessLimitError";
+    }
+}
+/**
+ * Bounded pool that limits how many child processes can run concurrently.
+ *
+ * Wraps {@link spawnTool} and {@link spawnManaged} so callers keep their
+ * familiar API while the pool enforces a ceiling on parallel processes.
+ * When the limit is reached, new spawns are rejected immediately with a
+ * {@link ProcessLimitError} (fail-fast, no queuing — an autonomous agent
+ * should not silently block).
+ *
+ * @example
+ * ```ts
+ * const pool = new ProcessPool(4);
+ *
+ * // Each spawn counts against the limit and auto-releases on exit.
+ * const result = await pool.spawn("node", ["script.js"], { cwd: "/tmp" });
+ *
+ * // For managed processes, the handle still exposes kill/pid/done.
+ * const handle = pool.spawnManaged("node", ["server.js"], { stdio: "pipe" });
+ * // ... handle.kill("SIGTERM") when done
+ * ```
+ */
+export class ProcessPool {
+    _limit;
+    _active = 0;
+    constructor(limit) {
+        if (limit < 1)
+            throw new RangeError("ProcessPool limit must be ≥ 1");
+        this._limit = limit;
+    }
+    /** Maximum concurrent processes allowed. */
+    get limit() {
+        return this._limit;
+    }
+    /** Number of processes currently tracked by the pool. */
+    get active() {
+        return this._active;
+    }
+    /**
+     * Spawn a child process through the pool.
+     *
+     * Same signature as {@link spawnTool}. Throws {@link ProcessLimitError}
+     * if the pool is full.
+     */
+    spawn(cmd, args, opts = {}) {
+        if (this._active >= this._limit) {
+            throw new ProcessLimitError(this._limit);
+        }
+        this._active++;
+        return spawnTool(cmd, args, opts).finally(() => {
+            this._active--;
+        });
+    }
+    /**
+     * Spawn a managed child process through the pool.
+     *
+     * Same signature as {@link spawnManaged}. Throws {@link ProcessLimitError}
+     * if the pool is full. The slot is released when the child exits.
+     */
+    spawnManaged(cmd, args, opts = {}) {
+        if (this._active >= this._limit) {
+            throw new ProcessLimitError(this._limit);
+        }
+        this._active++;
+        const handle = spawnManaged(cmd, args, opts);
+        // Release slot on completion (regardless of outcome)
+        handle.done.then(() => { this._active--; }, () => { this._active--; });
+        return handle;
+    }
+}
+//# sourceMappingURL=exec.js.map

package/packages/llm-client/dist/exec.js.map

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