@ai-devkit/agent-manager 0.4.0 → 0.6.0

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readJson = exports.fileExists = exports.readJsonLines = exports.readLastLines = exports.getProcessInfo = exports.isProcessRunning = exports.getProcessTty = exports.getProcessCwd = exports.listProcesses = exports.TtyWriter = exports.TerminalType = exports.TerminalFocusManager = exports.AgentStatus = exports.CodexAdapter = exports.ClaudeCodeAdapter = exports.AgentManager = void 0;
+exports.getProcessTty = exports.TtyWriter = exports.TerminalType = exports.TerminalFocusManager = exports.AgentStatus = exports.CodexAdapter = exports.ClaudeCodeAdapter = exports.AgentManager = void 0;
 var AgentManager_1 = require("./AgentManager");
 Object.defineProperty(exports, "AgentManager", { enumerable: true, get: function () { return AgentManager_1.AgentManager; } });
 var ClaudeCodeAdapter_1 = require("./adapters/ClaudeCodeAdapter");
@@ -15,14 +15,5 @@ Object.defineProperty(exports, "TerminalType", { enumerable: true, get: function
 var TtyWriter_1 = require("./terminal/TtyWriter");
 Object.defineProperty(exports, "TtyWriter", { enumerable: true, get: function () { return TtyWriter_1.TtyWriter; } });
 var process_1 = require("./utils/process");
-Object.defineProperty(exports, "listProcesses", { enumerable: true, get: function () { return process_1.listProcesses; } });
-Object.defineProperty(exports, "getProcessCwd", { enumerable: true, get: function () { return process_1.getProcessCwd; } });
 Object.defineProperty(exports, "getProcessTty", { enumerable: true, get: function () { return process_1.getProcessTty; } });
-Object.defineProperty(exports, "isProcessRunning", { enumerable: true, get: function () { return process_1.isProcessRunning; } });
-Object.defineProperty(exports, "getProcessInfo", { enumerable: true, get: function () { return process_1.getProcessInfo; } });
-var file_1 = require("./utils/file");
-Object.defineProperty(exports, "readLastLines", { enumerable: true, get: function () { return file_1.readLastLines; } });
-Object.defineProperty(exports, "readJsonLines", { enumerable: true, get: function () { return file_1.readJsonLines; } });
-Object.defineProperty(exports, "fileExists", { enumerable: true, get: function () { return file_1.fileExists; } });
-Object.defineProperty(exports, "readJson", { enumerable: true, get: function () { return file_1.readJson; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAC1B,wDAAuD;AAA9C,4GAAA,YAAY,OAAA;AACrB,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AAGpB,wEAAqF;AAA5E,4HAAA,oBAAoB,OAAA;AAAE,oHAAA,YAAY,OAAA;AAE3C,kDAAiD;AAAxC,sGAAA,SAAS,OAAA;AAElB,2CAAgH;AAAvG,wGAAA,aAAa,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,yGAAA,cAAc,OAAA;AAEtF,qCAAkF;AAAzE,qGAAA,aAAa,OAAA;AAAE,qGAAA,aAAa,OAAA;AAAE,kGAAA,UAAU,OAAA;AAAE,gGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAC1B,wDAAuD;AAA9C,4GAAA,YAAY,OAAA;AACrB,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AAGpB,wEAAqF;AAA5E,4HAAA,oBAAoB,OAAA;AAAE,oHAAA,YAAY,OAAA;AAE3C,kDAAiD;AAAxC,sGAAA,SAAS,OAAA;AAElB,2CAAgD;AAAvC,wGAAA,aAAa,OAAA"}

package/dist/utils/index.d.ts

@@ -1,4 +1,7 @@
-export { listProcesses, getProcessCwd, getProcessTty, isProcessRunning, getProcessInfo } from './process';
-export type { ListProcessesOptions } from './process';
-export { readLastLines, readJsonLines, fileExists, readJson } from './file';
+export { listAgentProcesses, batchGetProcessCwds, batchGetProcessStartTimes, enrichProcesses } from './process';
+export { getProcessTty } from './process';
+export { batchGetSessionFileBirthtimes } from './session';
+export type { SessionFile } from './session';
+export { matchProcessesToSessions, generateAgentName } from './matching';
+export type { MatchResult } from './matching';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1G,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAChH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/index.js

@@ -1,15 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readJson = exports.fileExists = exports.readJsonLines = exports.readLastLines = exports.getProcessInfo = exports.isProcessRunning = exports.getProcessTty = exports.getProcessCwd = exports.listProcesses = void 0;
+exports.generateAgentName = exports.matchProcessesToSessions = exports.batchGetSessionFileBirthtimes = exports.getProcessTty = exports.enrichProcesses = exports.batchGetProcessStartTimes = exports.batchGetProcessCwds = exports.listAgentProcesses = void 0;
 var process_1 = require("./process");
-Object.defineProperty(exports, "listProcesses", { enumerable: true, get: function () { return process_1.listProcesses; } });
-Object.defineProperty(exports, "getProcessCwd", { enumerable: true, get: function () { return process_1.getProcessCwd; } });
-Object.defineProperty(exports, "getProcessTty", { enumerable: true, get: function () { return process_1.getProcessTty; } });
-Object.defineProperty(exports, "isProcessRunning", { enumerable: true, get: function () { return process_1.isProcessRunning; } });
-Object.defineProperty(exports, "getProcessInfo", { enumerable: true, get: function () { return process_1.getProcessInfo; } });
-var file_1 = require("./file");
-Object.defineProperty(exports, "readLastLines", { enumerable: true, get: function () { return file_1.readLastLines; } });
-Object.defineProperty(exports, "readJsonLines", { enumerable: true, get: function () { return file_1.readJsonLines; } });
-Object.defineProperty(exports, "fileExists", { enumerable: true, get: function () { return file_1.fileExists; } });
-Object.defineProperty(exports, "readJson", { enumerable: true, get: function () { return file_1.readJson; } });
+Object.defineProperty(exports, "listAgentProcesses", { enumerable: true, get: function () { return process_1.listAgentProcesses; } });
+Object.defineProperty(exports, "batchGetProcessCwds", { enumerable: true, get: function () { return process_1.batchGetProcessCwds; } });
+Object.defineProperty(exports, "batchGetProcessStartTimes", { enumerable: true, get: function () { return process_1.batchGetProcessStartTimes; } });
+Object.defineProperty(exports, "enrichProcesses", { enumerable: true, get: function () { return process_1.enrichProcesses; } });
+var process_2 = require("./process");
+Object.defineProperty(exports, "getProcessTty", { enumerable: true, get: function () { return process_2.getProcessTty; } });
+var session_1 = require("./session");
+Object.defineProperty(exports, "batchGetSessionFileBirthtimes", { enumerable: true, get: function () { return session_1.batchGetSessionFileBirthtimes; } });
+var matching_1 = require("./matching");
+Object.defineProperty(exports, "matchProcessesToSessions", { enumerable: true, get: function () { return matching_1.matchProcessesToSessions; } });
+Object.defineProperty(exports, "generateAgentName", { enumerable: true, get: function () { return matching_1.generateAgentName; } });
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,qCAA0G;AAAjG,wGAAA,aAAa,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,yGAAA,cAAc,OAAA;AAEtF,+BAA4E;AAAnE,qGAAA,aAAa,OAAA;AAAE,qGAAA,aAAa,OAAA;AAAE,kGAAA,UAAU,OAAA;AAAE,gGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,qCAAgH;AAAvG,6GAAA,kBAAkB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,oHAAA,yBAAyB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAC5F,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,qCAA0D;AAAjD,wHAAA,6BAA6B,OAAA;AAEtC,uCAAyE;AAAhE,oHAAA,wBAAwB,OAAA;AAAE,6GAAA,iBAAiB,OAAA"}

package/dist/utils/matching.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Session Matching Utilities
+ *
+ * Shared 1:1 greedy matching algorithm that pairs running processes with session files
+ * based on CWD and birth-time proximity to process start time.
+ */
+import type { ProcessInfo } from '../adapters/AgentAdapter';
+import type { SessionFile } from './session';
+/**
+ * Result of matching a process to a session file.
+ */
+export interface MatchResult {
+    /** The matched process */
+    process: ProcessInfo;
+    /** The matched session file */
+    session: SessionFile;
+    /** Absolute time delta in ms between process start and session birth time */
+    deltaMs: number;
+}
+/**
+ * Match processes to session files using 1:1 greedy assignment.
+ *
+ * Algorithm:
+ * 1. Exclude processes without startTime (they become process-only fallback).
+ * 2. Build candidate pairs where process.cwd === session.resolvedCwd
+ *    and |process.startTime - session.birthtimeMs| <= 3 minutes.
+ * 3. Sort candidates by deltaMs ascending (best matches first).
+ * 4. Greedily assign: once a process or session is matched, skip it.
+ *
+ * Adapters must set session.resolvedCwd before calling this function.
+ */
+export declare function matchProcessesToSessions(processes: ProcessInfo[], sessions: SessionFile[]): MatchResult[];
+/**
+ * Generate a deterministic agent name from CWD and PID.
+ *
+ * Format: "folder-name-pid" (lowercase kebab-case)
+ */
+export declare function generateAgentName(cwd: string, pid: number): string;
+//# sourceMappingURL=matching.d.ts.map

package/dist/utils/matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.d.ts","sourceRoot":"","sources":["../../src/utils/matching.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAK7C;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,0BAA0B;IAC1B,OAAO,EAAE,WAAW,CAAC;IAErB,+BAA+B;IAC/B,OAAO,EAAE,WAAW,CAAC;IAErB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACpC,SAAS,EAAE,WAAW,EAAE,EACxB,QAAQ,EAAE,WAAW,EAAE,GACxB,WAAW,EAAE,CAsCf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAOlE"}

package/dist/utils/matching.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Session Matching Utilities
+ *
+ * Shared 1:1 greedy matching algorithm that pairs running processes with session files
+ * based on CWD and birth-time proximity to process start time.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchProcessesToSessions = matchProcessesToSessions;
+exports.generateAgentName = generateAgentName;
+const path = __importStar(require("path"));
+/** Maximum allowed delta between process start time and session file birth time. */
+const TOLERANCE_MS = 3 * 60 * 1000; // 3 minutes
+/**
+ * Match processes to session files using 1:1 greedy assignment.
+ *
+ * Algorithm:
+ * 1. Exclude processes without startTime (they become process-only fallback).
+ * 2. Build candidate pairs where process.cwd === session.resolvedCwd
+ *    and |process.startTime - session.birthtimeMs| <= 3 minutes.
+ * 3. Sort candidates by deltaMs ascending (best matches first).
+ * 4. Greedily assign: once a process or session is matched, skip it.
+ *
+ * Adapters must set session.resolvedCwd before calling this function.
+ */
+function matchProcessesToSessions(processes, sessions) {
+    // Build all candidate pairs
+    const candidates = [];
+    for (const proc of processes) {
+        if (!proc.startTime || !proc.cwd)
+            continue;
+        const processStartMs = proc.startTime.getTime();
+        for (const session of sessions) {
+            if (!session.resolvedCwd)
+                continue;
+            if (proc.cwd !== session.resolvedCwd)
+                continue;
+            const deltaMs = Math.abs(processStartMs - session.birthtimeMs);
+            if (deltaMs > TOLERANCE_MS)
+                continue;
+            candidates.push({ process: proc, session, deltaMs });
+        }
+    }
+    // Sort by smallest delta first
+    candidates.sort((a, b) => a.deltaMs - b.deltaMs);
+    // Greedy 1:1 assignment
+    const matchedPids = new Set();
+    const matchedSessionIds = new Set();
+    const results = [];
+    for (const candidate of candidates) {
+        if (matchedPids.has(candidate.process.pid))
+            continue;
+        if (matchedSessionIds.has(candidate.session.sessionId))
+            continue;
+        matchedPids.add(candidate.process.pid);
+        matchedSessionIds.add(candidate.session.sessionId);
+        results.push(candidate);
+    }
+    return results;
+}
+/**
+ * Generate a deterministic agent name from CWD and PID.
+ *
+ * Format: "folder-name-pid" (lowercase kebab-case)
+ */
+function generateAgentName(cwd, pid) {
+    const folderName = path.basename(cwd) || 'unknown';
+    const kebab = folderName
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return `${kebab || 'unknown'}-${pid}`;
+}
+//# sourceMappingURL=matching.js.map

package/dist/utils/matching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.js","sourceRoot":"","sources":["../../src/utils/matching.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCH,4DAyCC;AAOD,8CAOC;AAxFD,2CAA6B;AAI7B,oFAAoF;AACpF,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAgBhD;;;;;;;;;;;GAWG;AACH,SAAgB,wBAAwB,CACpC,SAAwB,EACxB,QAAuB;IAEvB,4BAA4B;IAC5B,MAAM,UAAU,GAA2E,EAAE,CAAC;IAE9F,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,SAAS;QAE3C,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAEhD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,WAAW;gBAAE,SAAS;YACnC,IAAI,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,WAAW;gBAAE,SAAS;YAE/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;YAC/D,IAAI,OAAO,GAAG,YAAY;gBAAE,SAAS;YAErC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;IAED,+BAA+B;IAC/B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IAEjD,wBAAwB;IACxB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,IAAI,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,SAAS;QACrD,IAAI,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,SAAS;QAEjE,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,GAAW,EAAE,GAAW;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;IACnD,MAAM,KAAK,GAAG,UAAU;SACnB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC7B,OAAO,GAAG,KAAK,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;AAC1C,CAAC"}

package/dist/utils/process.d.ts

@@ -1,61 +1,46 @@
 /**
  * Process Detection Utilities
  *
- * Utilities for detecting and inspecting running processes on the system.
- * Primarily focused on macOS/Unix-like systems using the `ps` command.
+ * Shared shell command wrappers for detecting and inspecting running processes.
+ * All execSync calls for process data live here — adapters must not call execSync directly.
  */
 import type { ProcessInfo } from '../adapters/AgentAdapter';
 /**
- * Options for listing processes
- */
-export interface ListProcessesOptions {
-    /** Filter processes by name pattern (case-insensitive) */
-    namePattern?: string;
-    /** Include only processes matching these PIDs */
-    pids?: number[];
-}
-/**
- * List running processes on the system
+ * List running processes matching an agent executable name.
  *
- * @param options Filtering options
- * @returns Array of process information
+ * Uses `ps aux | grep <pattern>` at shell level for performance, then post-filters
+ * by checking that the executable basename matches exactly (avoids matching
+ * `claude-helper`, `vscode-claude-extension`, or the grep process itself).
  *
- * @example
- * ```typescript
- * // List all Claude Code processes
- * const processes = listProcesses({ namePattern: 'claude' });
- *
- * // Get specific process info
- * const process = listProcesses({ pids: [12345] });
- * ```
+ * Returned ProcessInfo has pid, command, tty populated.
+ * cwd and startTime are NOT populated — call enrichProcesses() to fill them.
  */
-export declare function listProcesses(options?: ListProcessesOptions): ProcessInfo[];
+export declare function listAgentProcesses(namePattern: string): ProcessInfo[];
 /**
- * Get the current working directory for a specific process
+ * Batch-get current working directories for multiple PIDs.
  *
- * @param pid Process ID
- * @returns Working directory path, or empty string if unavailable
+ * Single `lsof -a -d cwd -Fn -p PID1,PID2,...` call.
+ * Returns partial results — if lsof fails for one PID, others still return.
  */
-export declare function getProcessCwd(pid: number): string;
+export declare function batchGetProcessCwds(pids: number[]): Map<number, string>;
 /**
- * Get the TTY device for a specific process
+ * Batch-get process start times for multiple PIDs.
  *
- * @param pid Process ID
- * @returns TTY device name (e.g., "ttys030"), or "?" if unavailable
+ * Single `ps -o pid=,lstart= -p PID1,PID2,...` call.
+ * Uses lstart format which gives full timestamp (e.g., "Thu Feb  5 16:00:57 2026").
+ * Returns partial results.
  */
-export declare function getProcessTty(pid: number): string;
+export declare function batchGetProcessStartTimes(pids: number[]): Map<number, Date>;
 /**
- * Check if a process with the given PID is running
+ * Enrich ProcessInfo array with cwd and startTime.
  *
- * @param pid Process ID
- * @returns True if process is running
+ * Calls batchGetProcessCwds and batchGetProcessStartTimes in batched shell calls,
+ * then populates each ProcessInfo in-place. Returns partial results —
+ * if a PID fails, that process keeps empty cwd / undefined startTime.
  */
-export declare function isProcessRunning(pid: number): boolean;
+export declare function enrichProcesses(processes: ProcessInfo[]): ProcessInfo[];
 /**
- * Get detailed information for a specific process
- *
- * @param pid Process ID
- * @returns Process information, or null if process not found
+ * Get the TTY device for a specific process
  */
-export declare function getProcessInfo(pid: number): ProcessInfo | null;
+export declare function getProcessTty(pid: number): string;
 //# sourceMappingURL=process.d.ts.map

package/dist/utils/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,WAAW,EAAE,CA2D/E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgCjD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYjD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASrD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAG9D"}
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAkDrE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoCvE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAkC3E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAavE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWjD"}