@n-dx/core 0.1.0

package/packages/hench/dist/process/concurrent-execution-metrics.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Concurrent execution metrics collection and resource utilization tracking.
+ *
+ * Collects time-series snapshots of concurrent process counts, total memory
+ * utilization across all hench processes, and per-task resource metrics.
+ * Snapshots are stored in bounded ring buffers and aggregated into patterns
+ * (peak, average, percentiles) for dashboard consumption.
+ *
+ * Key differences from sibling modules:
+ * - **ProcessMemoryTracker** — per-process memory history + leak detection
+ * - **SystemMemoryMonitor** — system-wide memory gating for pre-spawn checks
+ * - **ConcurrentExecutionMetrics** — cross-process aggregate metrics over time
+ *
+ * Integration points:
+ * - Web server calls {@link ConcurrentExecutionMetrics.recordSnapshot} during
+ *   periodic broadcasts to accumulate metrics history
+ * - API endpoints expose metrics via {@link getSnapshot} and {@link getSummary}
+ * - Per-task lifecycle hooks via {@link taskStarted} and {@link taskCompleted}
+ *
+ * @module hench/process/concurrent-execution-metrics
+ */
+/**
+ * Configuration for the concurrent execution metrics collector.
+ */
+export interface ConcurrentExecutionMetricsConfig {
+    /** Maximum time-series snapshots in the ring buffer. */
+    maxSnapshots: number;
+    /** Maximum completed task metrics retained. */
+    maxCompletedTasks: number;
+}
+/** Default concurrent execution metrics configuration. */
+export declare const DEFAULT_CONCURRENT_EXECUTION_METRICS_CONFIG: ConcurrentExecutionMetricsConfig;
+/**
+ * A single point-in-time snapshot of concurrent execution state.
+ */
+export interface ExecutionMetricsSnapshot {
+    /** Number of concurrently running hench processes. */
+    concurrentCount: number;
+    /** Total RSS across all tracked hench processes (bytes). */
+    totalRssBytes: number;
+    /** System memory usage percentage at snapshot time (0–100). */
+    systemMemoryPercent: number;
+    /** System load average (1-minute). */
+    loadAvg1m: number;
+    /** ISO timestamp of the snapshot. */
+    timestamp: string;
+    /** Epoch milliseconds (for efficient calculations). */
+    epochMs: number;
+}
+/**
+ * Resource utilization metrics for a single task execution.
+ */
+export interface TaskResourceMetrics {
+    /** Task identifier. */
+    taskId: string;
+    /** Human-readable task title. */
+    taskTitle: string;
+    /** Process ID (last known). */
+    pid: number;
+    /** When the task started. */
+    startedAt: string;
+    /** When the task completed (undefined if still running). */
+    completedAt?: string;
+    /** Duration in milliseconds (computed from start to now or completion). */
+    durationMs: number;
+    /** Peak RSS observed during execution (bytes). */
+    peakRssBytes: number;
+    /** Average RSS across all samples (bytes). */
+    avgRssBytes: number;
+    /** Most recent RSS (bytes). */
+    currentRssBytes: number;
+    /** Number of RSS samples collected. */
+    sampleCount: number;
+    /** Average concurrent task count while this task was running. */
+    avgConcurrentDuringExecution: number;
+}
+/**
+ * Aggregated utilization patterns derived from time-series data.
+ */
+export interface UtilizationPatterns {
+    /** Peak concurrent process count observed. */
+    peakConcurrent: number;
+    /** Average concurrent process count. */
+    avgConcurrent: number;
+    /** Peak total RSS across all processes (bytes). */
+    peakTotalRssBytes: number;
+    /** Average total RSS across all processes (bytes). */
+    avgTotalRssBytes: number;
+    /** Average system memory usage percentage. */
+    avgSystemMemoryPercent: number;
+    /** Peak system memory usage percentage. */
+    peakSystemMemoryPercent: number;
+    /** Average system load (1-minute). */
+    avgLoadAvg1m: number;
+    /** Peak system load (1-minute). */
+    peakLoadAvg1m: number;
+    /** Duration of the observation window (milliseconds). */
+    windowDurationMs: number;
+    /** Number of snapshots in the window. */
+    snapshotCount: number;
+}
+/**
+ * Full metrics summary for API response.
+ */
+export interface ExecutionMetricsSummary {
+    /** Current real-time snapshot. */
+    current: ExecutionMetricsSnapshot;
+    /** Aggregated utilization patterns over the observation window. */
+    patterns: UtilizationPatterns;
+    /** Resource metrics for actively running tasks. */
+    activeTasks: TaskResourceMetrics[];
+    /** Resource metrics for recently completed tasks. */
+    completedTasks: TaskResourceMetrics[];
+    /** ISO timestamp of this summary. */
+    timestamp: string;
+}
+/**
+ * Collects and aggregates concurrent execution metrics across hench processes.
+ *
+ * Records periodic snapshots of concurrent process counts and memory utilization,
+ * tracks per-task resource usage, and computes utilization patterns.
+ *
+ * @example
+ * ```ts
+ * const metrics = new ConcurrentExecutionMetrics();
+ *
+ * // When a task starts
+ * metrics.taskStarted("task-1", "Fix bug", 12345);
+ *
+ * // During periodic monitoring (e.g. every 10s)
+ * metrics.recordSnapshot({
+ *   concurrentCount: 2,
+ *   totalRssBytes: 200_000_000,
+ *   systemMemoryPercent: 45,
+ *   loadAvg1m: 1.5,
+ *   perTaskRss: [
+ *     { taskId: "task-1", rssBytes: 100_000_000 },
+ *     { taskId: "task-2", rssBytes: 100_000_000 },
+ *   ],
+ * });
+ *
+ * // When a task completes
+ * metrics.taskCompleted("task-1");
+ *
+ * // Get full summary for API
+ * const summary = metrics.getSummary();
+ * ```
+ */
+export declare class ConcurrentExecutionMetrics {
+    private readonly _config;
+    /** Time-series ring buffer of execution snapshots. */
+    private readonly _snapshots;
+    /** Active task metrics keyed by taskId. */
+    private readonly _activeTasks;
+    /** Completed task metrics (FIFO, bounded). */
+    private readonly _completedTasks;
+    /** Clock function, injectable for deterministic testing. */
+    private readonly _now;
+    constructor(config?: Partial<ConcurrentExecutionMetricsConfig>, overrides?: {
+        now?: () => number;
+    });
+    /** Current configuration (read-only copy). */
+    get config(): Readonly<ConcurrentExecutionMetricsConfig>;
+    /** Number of time-series snapshots recorded. */
+    get snapshotCount(): number;
+    /** Number of actively tracked tasks. */
+    get activeTaskCount(): number;
+    /** Number of completed task metrics retained. */
+    get completedTaskCount(): number;
+    /**
+     * Register a new task execution.
+     *
+     * Call when a hench process starts executing a task.
+     *
+     * @param taskId   Task identifier from the PRD.
+     * @param taskTitle Human-readable task title.
+     * @param pid      OS process ID.
+     */
+    taskStarted(taskId: string, taskTitle: string, pid: number): void;
+    /**
+     * Mark a task as completed and move to completed metrics.
+     *
+     * @param taskId Task identifier to mark as completed.
+     */
+    taskCompleted(taskId: string): void;
+    /**
+     * Record a point-in-time snapshot of concurrent execution state.
+     *
+     * Call this during each periodic monitoring cycle (e.g. every 10 seconds).
+     * Updates both the time-series ring buffer and per-task resource metrics.
+     *
+     * @param input Snapshot data from the current monitoring cycle.
+     */
+    recordSnapshot(input: {
+        concurrentCount: number;
+        totalRssBytes: number;
+        systemMemoryPercent: number;
+        loadAvg1m: number;
+        perTaskRss: Array<{
+            taskId: string;
+            rssBytes: number;
+        }>;
+    }): void;
+    /**
+     * Get the most recent snapshot, or a synthetic zero-state if no
+     * snapshots have been recorded.
+     */
+    getLatestSnapshot(): ExecutionMetricsSnapshot;
+    /**
+     * Get all recorded snapshots (copy of the ring buffer).
+     */
+    getSnapshots(): ExecutionMetricsSnapshot[];
+    /**
+     * Compute utilization patterns from the recorded time-series.
+     *
+     * Aggregates across all snapshots in the ring buffer to produce
+     * peak, average, and other summary statistics.
+     */
+    computePatterns(): UtilizationPatterns;
+    /**
+     * Get resource metrics for all active tasks.
+     */
+    getActiveTaskMetrics(): TaskResourceMetrics[];
+    /**
+     * Get resource metrics for completed tasks.
+     */
+    getCompletedTaskMetrics(): TaskResourceMetrics[];
+    /**
+     * Get the full metrics summary for API responses.
+     *
+     * Combines the latest snapshot, utilization patterns, and per-task
+     * metrics into a single response object.
+     */
+    getSummary(): ExecutionMetricsSummary;
+    /**
+     * Clear all metrics data (snapshots + task metrics).
+     */
+    reset(): void;
+    /**
+     * Build a TaskResourceMetrics from internal tracked state.
+     */
+    private _buildTaskMetrics;
+}

package/packages/hench/dist/process/concurrent-execution-metrics.js

@@ -0,0 +1,352 @@
+/**
+ * Concurrent execution metrics collection and resource utilization tracking.
+ *
+ * Collects time-series snapshots of concurrent process counts, total memory
+ * utilization across all hench processes, and per-task resource metrics.
+ * Snapshots are stored in bounded ring buffers and aggregated into patterns
+ * (peak, average, percentiles) for dashboard consumption.
+ *
+ * Key differences from sibling modules:
+ * - **ProcessMemoryTracker** — per-process memory history + leak detection
+ * - **SystemMemoryMonitor** — system-wide memory gating for pre-spawn checks
+ * - **ConcurrentExecutionMetrics** — cross-process aggregate metrics over time
+ *
+ * Integration points:
+ * - Web server calls {@link ConcurrentExecutionMetrics.recordSnapshot} during
+ *   periodic broadcasts to accumulate metrics history
+ * - API endpoints expose metrics via {@link getSnapshot} and {@link getSummary}
+ * - Per-task lifecycle hooks via {@link taskStarted} and {@link taskCompleted}
+ *
+ * @module hench/process/concurrent-execution-metrics
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum time-series snapshots retained (ring buffer size). */
+const DEFAULT_MAX_SNAPSHOTS = 360;
+/** Maximum completed task metrics retained for post-mortem analysis. */
+const DEFAULT_MAX_COMPLETED_TASKS = 50;
+/** Default concurrent execution metrics configuration. */
+export const DEFAULT_CONCURRENT_EXECUTION_METRICS_CONFIG = {
+    maxSnapshots: DEFAULT_MAX_SNAPSHOTS,
+    maxCompletedTasks: DEFAULT_MAX_COMPLETED_TASKS,
+};
+// ---------------------------------------------------------------------------
+// ConcurrentExecutionMetrics
+// ---------------------------------------------------------------------------
+/**
+ * Collects and aggregates concurrent execution metrics across hench processes.
+ *
+ * Records periodic snapshots of concurrent process counts and memory utilization,
+ * tracks per-task resource usage, and computes utilization patterns.
+ *
+ * @example
+ * ```ts
+ * const metrics = new ConcurrentExecutionMetrics();
+ *
+ * // When a task starts
+ * metrics.taskStarted("task-1", "Fix bug", 12345);
+ *
+ * // During periodic monitoring (e.g. every 10s)
+ * metrics.recordSnapshot({
+ *   concurrentCount: 2,
+ *   totalRssBytes: 200_000_000,
+ *   systemMemoryPercent: 45,
+ *   loadAvg1m: 1.5,
+ *   perTaskRss: [
+ *     { taskId: "task-1", rssBytes: 100_000_000 },
+ *     { taskId: "task-2", rssBytes: 100_000_000 },
+ *   ],
+ * });
+ *
+ * // When a task completes
+ * metrics.taskCompleted("task-1");
+ *
+ * // Get full summary for API
+ * const summary = metrics.getSummary();
+ * ```
+ */
+export class ConcurrentExecutionMetrics {
+    _config;
+    /** Time-series ring buffer of execution snapshots. */
+    _snapshots = [];
+    /** Active task metrics keyed by taskId. */
+    _activeTasks = new Map();
+    /** Completed task metrics (FIFO, bounded). */
+    _completedTasks = [];
+    /** Clock function, injectable for deterministic testing. */
+    _now;
+    constructor(config, overrides) {
+        this._config = { ...DEFAULT_CONCURRENT_EXECUTION_METRICS_CONFIG, ...config };
+        this._now = overrides?.now ?? Date.now;
+    }
+    /** Current configuration (read-only copy). */
+    get config() {
+        return { ...this._config };
+    }
+    /** Number of time-series snapshots recorded. */
+    get snapshotCount() {
+        return this._snapshots.length;
+    }
+    /** Number of actively tracked tasks. */
+    get activeTaskCount() {
+        return this._activeTasks.size;
+    }
+    /** Number of completed task metrics retained. */
+    get completedTaskCount() {
+        return this._completedTasks.length;
+    }
+    // -----------------------------------------------------------------------
+    // Task lifecycle
+    // -----------------------------------------------------------------------
+    /**
+     * Register a new task execution.
+     *
+     * Call when a hench process starts executing a task.
+     *
+     * @param taskId   Task identifier from the PRD.
+     * @param taskTitle Human-readable task title.
+     * @param pid      OS process ID.
+     */
+    taskStarted(taskId, taskTitle, pid) {
+        const now = this._now();
+        this._activeTasks.set(taskId, {
+            taskId,
+            taskTitle,
+            pid,
+            startedAt: new Date(now).toISOString(),
+            startedEpochMs: now,
+            rssSumBytes: 0,
+            rssSampleCount: 0,
+            peakRssBytes: 0,
+            currentRssBytes: 0,
+            concurrentSum: 0,
+            concurrentSampleCount: 0,
+            active: true,
+        });
+    }
+    /**
+     * Mark a task as completed and move to completed metrics.
+     *
+     * @param taskId Task identifier to mark as completed.
+     */
+    taskCompleted(taskId) {
+        const tracked = this._activeTasks.get(taskId);
+        if (!tracked)
+            return;
+        const now = this._now();
+        tracked.active = false;
+        tracked.completedAt = new Date(now).toISOString();
+        tracked.completedEpochMs = now;
+        this._activeTasks.delete(taskId);
+        // Add to completed list, evict oldest if over limit
+        this._completedTasks.push(tracked);
+        while (this._completedTasks.length > this._config.maxCompletedTasks) {
+            this._completedTasks.shift();
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Snapshot recording
+    // -----------------------------------------------------------------------
+    /**
+     * Record a point-in-time snapshot of concurrent execution state.
+     *
+     * Call this during each periodic monitoring cycle (e.g. every 10 seconds).
+     * Updates both the time-series ring buffer and per-task resource metrics.
+     *
+     * @param input Snapshot data from the current monitoring cycle.
+     */
+    recordSnapshot(input) {
+        const now = this._now();
+        const snapshot = {
+            concurrentCount: input.concurrentCount,
+            totalRssBytes: input.totalRssBytes,
+            systemMemoryPercent: input.systemMemoryPercent,
+            loadAvg1m: input.loadAvg1m,
+            timestamp: new Date(now).toISOString(),
+            epochMs: now,
+        };
+        // Ring buffer: evict oldest when full
+        if (this._snapshots.length >= this._config.maxSnapshots) {
+            this._snapshots.shift();
+        }
+        this._snapshots.push(snapshot);
+        // Update per-task metrics with this cycle's data
+        for (const { taskId, rssBytes } of input.perTaskRss) {
+            const tracked = this._activeTasks.get(taskId);
+            if (!tracked)
+                continue;
+            tracked.rssSumBytes += rssBytes;
+            tracked.rssSampleCount += 1;
+            tracked.currentRssBytes = rssBytes;
+            if (rssBytes > tracked.peakRssBytes) {
+                tracked.peakRssBytes = rssBytes;
+            }
+            // Track concurrent count during this task's execution
+            tracked.concurrentSum += input.concurrentCount;
+            tracked.concurrentSampleCount += 1;
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Queries
+    // -----------------------------------------------------------------------
+    /**
+     * Get the most recent snapshot, or a synthetic zero-state if no
+     * snapshots have been recorded.
+     */
+    getLatestSnapshot() {
+        const last = this._snapshots[this._snapshots.length - 1];
+        if (last)
+            return { ...last };
+        const now = this._now();
+        return {
+            concurrentCount: 0,
+            totalRssBytes: 0,
+            systemMemoryPercent: 0,
+            loadAvg1m: 0,
+            timestamp: new Date(now).toISOString(),
+            epochMs: now,
+        };
+    }
+    /**
+     * Get all recorded snapshots (copy of the ring buffer).
+     */
+    getSnapshots() {
+        return this._snapshots.map((s) => ({ ...s }));
+    }
+    /**
+     * Compute utilization patterns from the recorded time-series.
+     *
+     * Aggregates across all snapshots in the ring buffer to produce
+     * peak, average, and other summary statistics.
+     */
+    computePatterns() {
+        const n = this._snapshots.length;
+        if (n === 0) {
+            return {
+                peakConcurrent: 0,
+                avgConcurrent: 0,
+                peakTotalRssBytes: 0,
+                avgTotalRssBytes: 0,
+                avgSystemMemoryPercent: 0,
+                peakSystemMemoryPercent: 0,
+                avgLoadAvg1m: 0,
+                peakLoadAvg1m: 0,
+                windowDurationMs: 0,
+                snapshotCount: 0,
+            };
+        }
+        let sumConcurrent = 0;
+        let peakConcurrent = 0;
+        let sumRss = 0;
+        let peakRss = 0;
+        let sumMemPercent = 0;
+        let peakMemPercent = 0;
+        let sumLoad = 0;
+        let peakLoad = 0;
+        for (const s of this._snapshots) {
+            sumConcurrent += s.concurrentCount;
+            if (s.concurrentCount > peakConcurrent)
+                peakConcurrent = s.concurrentCount;
+            sumRss += s.totalRssBytes;
+            if (s.totalRssBytes > peakRss)
+                peakRss = s.totalRssBytes;
+            sumMemPercent += s.systemMemoryPercent;
+            if (s.systemMemoryPercent > peakMemPercent)
+                peakMemPercent = s.systemMemoryPercent;
+            sumLoad += s.loadAvg1m;
+            if (s.loadAvg1m > peakLoad)
+                peakLoad = s.loadAvg1m;
+        }
+        const first = this._snapshots[0];
+        const last = this._snapshots[n - 1];
+        const windowDurationMs = last.epochMs - first.epochMs;
+        return {
+            peakConcurrent,
+            avgConcurrent: Math.round((sumConcurrent / n) * 100) / 100,
+            peakTotalRssBytes: peakRss,
+            avgTotalRssBytes: Math.round(sumRss / n),
+            avgSystemMemoryPercent: Math.round((sumMemPercent / n) * 100) / 100,
+            peakSystemMemoryPercent: peakMemPercent,
+            avgLoadAvg1m: Math.round((sumLoad / n) * 100) / 100,
+            peakLoadAvg1m: Math.round(peakLoad * 100) / 100,
+            windowDurationMs,
+            snapshotCount: n,
+        };
+    }
+    /**
+     * Get resource metrics for all active tasks.
+     */
+    getActiveTaskMetrics() {
+        const now = this._now();
+        const result = [];
+        for (const t of this._activeTasks.values()) {
+            result.push(this._buildTaskMetrics(t, now));
+        }
+        return result;
+    }
+    /**
+     * Get resource metrics for completed tasks.
+     */
+    getCompletedTaskMetrics() {
+        const now = this._now();
+        return this._completedTasks.map((t) => this._buildTaskMetrics(t, now));
+    }
+    /**
+     * Get the full metrics summary for API responses.
+     *
+     * Combines the latest snapshot, utilization patterns, and per-task
+     * metrics into a single response object.
+     */
+    getSummary() {
+        const now = this._now();
+        return {
+            current: this.getLatestSnapshot(),
+            patterns: this.computePatterns(),
+            activeTasks: this.getActiveTaskMetrics(),
+            completedTasks: this.getCompletedTaskMetrics(),
+            timestamp: new Date(now).toISOString(),
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Reset
+    // -----------------------------------------------------------------------
+    /**
+     * Clear all metrics data (snapshots + task metrics).
+     */
+    reset() {
+        this._snapshots.length = 0;
+        this._activeTasks.clear();
+        this._completedTasks.length = 0;
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Build a TaskResourceMetrics from internal tracked state.
+     */
+    _buildTaskMetrics(tracked, now) {
+        const endTime = tracked.completedEpochMs ?? now;
+        const durationMs = endTime - tracked.startedEpochMs;
+        const avgRss = tracked.rssSampleCount > 0
+            ? Math.round(tracked.rssSumBytes / tracked.rssSampleCount)
+            : 0;
+        const avgConcurrent = tracked.concurrentSampleCount > 0
+            ? Math.round((tracked.concurrentSum / tracked.concurrentSampleCount) * 100) / 100
+            : 0;
+        return {
+            taskId: tracked.taskId,
+            taskTitle: tracked.taskTitle,
+            pid: tracked.pid,
+            startedAt: tracked.startedAt,
+            completedAt: tracked.completedAt,
+            durationMs,
+            peakRssBytes: tracked.peakRssBytes,
+            avgRssBytes: avgRss,
+            currentRssBytes: tracked.currentRssBytes,
+            sampleCount: tracked.rssSampleCount,
+            avgConcurrentDuringExecution: avgConcurrent,
+        };
+    }
+}
+//# sourceMappingURL=concurrent-execution-metrics.js.map

package/packages/hench/dist/process/concurrent-execution-metrics.js.map

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

package/packages/hench/dist/process/exec-shell.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Backward-compatibility re-export.
+ *
+ * `execShell` now lives in `tools/exec-shell.ts` so tool implementations
+ * do not need to back-import from `process`.
+ */
+export { execShell } from "../tools/exec-shell.js";
+export type { ExecShellOptions } from "../tools/exec-shell.js";

package/packages/hench/dist/process/exec-shell.js

@@ -0,0 +1,8 @@
+/**
+ * Backward-compatibility re-export.
+ *
+ * `execShell` now lives in `tools/exec-shell.ts` so tool implementations
+ * do not need to back-import from `process`.
+ */
+export { execShell } from "../tools/exec-shell.js";
+//# sourceMappingURL=exec-shell.js.map

package/packages/hench/dist/process/exec-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-shell.js","sourceRoot":"","sources":["../../src/process/exec-shell.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC"}

package/packages/hench/dist/process/exec.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Centralized process execution abstraction.
+ *
+ * All child-process spawning within hench routes through this module.
+ * The actual implementation lives in @n-dx/llm-client (foundation layer);
+ * this file re-exports those helpers so existing hench consumers continue
+ * to import from their familiar `../process/exec.js` path.
+ *
+ * @module hench/process/exec
+ */
+export { exec, execStdout, execShellCmd, getCurrentHead, getCurrentBranch, isExecutableOnPath, spawnTool, spawnManaged, ProcessPool, ProcessLimitError, } from "../prd/llm-gateway.js";
+export type { ExecResult, ExecOptions, SpawnToolOptions, SpawnToolResult, ManagedChild, } from "../prd/llm-gateway.js";

package/packages/hench/dist/process/exec.js

@@ -0,0 +1,12 @@
+/**
+ * Centralized process execution abstraction.
+ *
+ * All child-process spawning within hench routes through this module.
+ * The actual implementation lives in @n-dx/llm-client (foundation layer);
+ * this file re-exports those helpers so existing hench consumers continue
+ * to import from their familiar `../process/exec.js` path.
+ *
+ * @module hench/process/exec
+ */
+export { exec, execStdout, execShellCmd, getCurrentHead, getCurrentBranch, isExecutableOnPath, spawnTool, spawnManaged, ProcessPool, ProcessLimitError, } from "../prd/llm-gateway.js";
+//# sourceMappingURL=exec.js.map

package/packages/hench/dist/process/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/process/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,uBAAuB,CAAC"}