@ai-devkit/agent-manager 0.26.2 → 0.26.4

package/dist/utils/process.js

@@ -2,9 +2,28 @@
  * Process Detection Utilities
  *
  * Shared shell command wrappers for detecting and inspecting running processes.
- * All execFileSync calls for process data live here — adapters must not call execFileSync directly.
+ * Built-in refresh discovery uses captureProcessSnapshot(); synchronous helpers
+ * remain exported for compatibility with existing consumers.
  */ import * as path from 'path';
-import { execFileSync } from 'child_process';
+import { execFile, execFileSync } from 'child_process';
+const PROCESS_EXEC_MAX_BUFFER = 10 * 1024 * 1024;
+const VALID_EXECUTABLE_NAME = /^[a-zA-Z0-9_-]+$/;
+export function executableBasename(command) {
+    const executable = command.trim().split(/\s+/)[0] || '';
+    return path.basename(executable.replace(/\\/g, '/')).toLowerCase();
+}
+function normalizeExecutableName(name) {
+    const lower = name.toLowerCase();
+    return lower.endsWith('.exe') ? lower.slice(0, -4) : lower;
+}
+function normalizedProcessNames(namePatterns) {
+    return new Set(namePatterns.filter(Boolean).map(normalizeExecutableName));
+}
+export function filterByProcessNames(processes, namePatterns) {
+    const names = normalizedProcessNames(namePatterns);
+    if (names.size === 0) return [];
+    return processes.filter((process)=>names.has(normalizeExecutableName(executableBasename(process.command))));
+}
 /**
  * List running processes matching an agent executable name.
  *
@@ -15,7 +34,7 @@ import { execFileSync } from 'child_process';
  * cwd and startTime are NOT populated — call enrichProcesses() to fill them.
  */ export function listAgentProcesses(namePattern) {
     // Validate pattern contains only safe characters (alphanumeric, dash, underscore)
-    if (!namePattern || !/^[a-zA-Z0-9_-]+$/.test(namePattern)) {
+    if (!namePattern || !VALID_EXECUTABLE_NAME.test(namePattern)) {
         return [];
     }
     try {
@@ -25,7 +44,9 @@ import { execFileSync } from 'child_process';
         ], {
             encoding: 'utf-8'
         });
-        const lowerPattern = namePattern.toLowerCase();
+        const names = normalizedProcessNames([
+            namePattern
+        ]);
         const processes = [];
         for (const line of output.trim().split('\n')){
             if (!line.trim()) continue;
@@ -36,12 +57,7 @@ import { execFileSync } from 'child_process';
             if (Number.isNaN(pid) || Number.isNaN(ppid)) continue;
             const tty = match[3];
             const command = match[4];
-            // Check that the executable basename matches exactly
-            const executable = command.trim().split(/\s+/)[0] || '';
-            const base = path.basename(executable).toLowerCase();
-            if (base !== lowerPattern && base !== `${lowerPattern}.exe`) {
-                continue;
-            }
+            if (!names.has(normalizeExecutableName(executableBasename(command)))) continue;
             const ttyShort = tty.startsWith('/dev/') ? tty.slice(5) : tty;
             processes.push({
                 pid,
@@ -56,6 +72,135 @@ import { execFileSync } from 'child_process';
         return [];
     }
 }
+function execFileText(file, args) {
+    return new Promise((resolve, reject)=>{
+        execFile(file, args, {
+            encoding: 'utf-8',
+            maxBuffer: PROCESS_EXEC_MAX_BUFFER
+        }, (error, stdout)=>{
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+function parseProcessList(output, namePatterns) {
+    const processes = [];
+    for (const line of output.trim().split('\n')){
+        if (!line.trim()) continue;
+        const match = line.match(/^\s*(\d+)\s+(\d+)\s+(\S+)\s+(.+)$/);
+        if (!match) continue;
+        const pid = parseInt(match[1], 10);
+        const ppid = parseInt(match[2], 10);
+        if (Number.isNaN(pid) || Number.isNaN(ppid)) continue;
+        const tty = match[3];
+        const command = match[4];
+        const base = executableBasename(command);
+        const normalizedBase = normalizeExecutableName(base);
+        if (!namePatterns.has(normalizedBase)) continue;
+        processes.push({
+            pid,
+            ppid,
+            command,
+            cwd: '',
+            tty: tty.startsWith('/dev/') ? tty.slice(5) : tty
+        });
+    }
+    return processes;
+}
+async function batchGetProcessCwdsAsync(pids) {
+    const result = new Map();
+    if (pids.length === 0) return result;
+    try {
+        const output = await execFileText('lsof', [
+            '-a',
+            '-d',
+            'cwd',
+            '-Fn',
+            '-p',
+            pids.join(',')
+        ]);
+        let currentPid = null;
+        for (const line of output.trim().split('\n')){
+            if (line.startsWith('p')) {
+                currentPid = parseInt(line.slice(1), 10);
+            } else if (line.startsWith('n') && currentPid !== null) {
+                result.set(currentPid, line.slice(1));
+                currentPid = null;
+            }
+        }
+        return result;
+    } catch  {
+        const entries = await Promise.all(pids.map(async (pid)=>{
+            try {
+                const output = await execFileText('pwdx', [
+                    String(pid)
+                ]);
+                const match = output.match(/^\d+:\s*(.+)$/);
+                return match ? [
+                    pid,
+                    match[1].trim()
+                ] : null;
+            } catch  {
+                return null;
+            }
+        }));
+        for (const entry of entries){
+            if (entry) result.set(entry[0], entry[1]);
+        }
+        return result;
+    }
+}
+async function batchGetProcessStartTimesAsync(pids) {
+    const result = new Map();
+    if (pids.length === 0) return result;
+    try {
+        const output = await execFileText('ps', [
+            '-o',
+            'pid=,lstart=',
+            '-p',
+            pids.join(',')
+        ]);
+        for (const rawLine of output.split('\n')){
+            const match = rawLine.trim().match(/^(\d+)\s+(.+)$/);
+            if (!match) continue;
+            const pid = parseInt(match[1], 10);
+            const date = new Date(match[2].trim());
+            if (Number.isFinite(pid) && !Number.isNaN(date.getTime())) result.set(pid, date);
+        }
+    } catch  {
+    // Return partial/empty data, matching the synchronous helper.
+    }
+    return result;
+}
+/**
+ * Capture and enrich relevant processes without blocking the event loop.
+ * One base process listing is shared by every requested executable name.
+ */ export async function captureProcessSnapshot(namePatterns) {
+    const names = normalizedProcessNames(namePatterns.filter((name)=>Boolean(name) && VALID_EXECUTABLE_NAME.test(name)));
+    if (names.size === 0) return [];
+    try {
+        const output = await execFileText('ps', [
+            '-axo',
+            'pid=,ppid=,tty=,command='
+        ]);
+        const processes = parseProcessList(output, names);
+        const pids = processes.map((process)=>process.pid);
+        const [cwdMap, startTimeMap] = await Promise.all([
+            batchGetProcessCwdsAsync(pids),
+            batchGetProcessStartTimesAsync(pids)
+        ]);
+        return processes.map((process)=>({
+                ...process,
+                cwd: cwdMap.get(process.pid) || '',
+                startTime: startTimeMap.get(process.pid)
+            }));
+    } catch  {
+        return [];
+    }
+}
 /**
  * Batch-get current working directories for multiple PIDs.
  *

package/dist/utils/process.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/process.ts"],"sourcesContent":["/**\n * Process Detection Utilities\n *\n * Shared shell command wrappers for detecting and inspecting running processes.\n * All execFileSync calls for process data live here — adapters must not call execFileSync directly.\n */\n\nimport * as path from 'path';\nimport { execFileSync } from 'child_process';\nimport type { ProcessInfo } from '../adapters/AgentAdapter.js';\n\n/**\n * List running processes matching an agent executable name.\n *\n * Uses `ps -axo` then filters in JS for exact executable basename match.\n * This avoids shell pipelines and string interpolation.\n *\n * Returned ProcessInfo has pid, ppid, command, tty populated.\n * cwd and startTime are NOT populated — call enrichProcesses() to fill them.\n */\nexport function listAgentProcesses(namePattern: string): ProcessInfo[] {\n    // Validate pattern contains only safe characters (alphanumeric, dash, underscore)\n    if (!namePattern || !/^[a-zA-Z0-9_-]+$/.test(namePattern)) {\n        return [];\n    }\n\n    try {\n        const output = execFileSync('ps', ['-axo', 'pid=,ppid=,tty=,command='], { encoding: 'utf-8' });\n\n        const lowerPattern = namePattern.toLowerCase();\n        const processes: ProcessInfo[] = [];\n\n        for (const line of output.trim().split('\\n')) {\n            if (!line.trim()) continue;\n\n            const match = line.match(/^\\s*(\\d+)\\s+(\\d+)\\s+(\\S+)\\s+(.+)$/);\n            if (!match) continue;\n\n            const pid = parseInt(match[1], 10);\n            const ppid = parseInt(match[2], 10);\n            if (Number.isNaN(pid) || Number.isNaN(ppid)) continue;\n\n            const tty = match[3];\n            const command = match[4];\n\n            // Check that the executable basename matches exactly\n            const executable = command.trim().split(/\\s+/)[0] || '';\n            const base = path.basename(executable).toLowerCase();\n            if (base !== lowerPattern && base !== `${lowerPattern}.exe`) {\n                continue;\n            }\n\n            const ttyShort = tty.startsWith('/dev/') ? tty.slice(5) : tty;\n\n            processes.push({\n                pid,\n                ppid,\n                command,\n                cwd: '',\n                tty: ttyShort,\n            });\n        }\n\n        return processes;\n    } catch {\n        return [];\n    }\n}\n\n/**\n * Batch-get current working directories for multiple PIDs.\n *\n * Single `lsof -a -d cwd -Fn -p PID1,PID2,...` call.\n * Returns partial results — if lsof fails for one PID, others still return.\n */\nexport function batchGetProcessCwds(pids: number[]): Map<number, string> {\n    const result = new Map<number, string>();\n    if (pids.length === 0) return result;\n\n    try {\n        const output = execFileSync(\n            'lsof', ['-a', '-d', 'cwd', '-Fn', '-p', pids.join(',')],\n            { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] },\n        );\n\n        // lsof output format: p{PID}\\nn{path}\\np{PID}\\nn{path}...\n        let currentPid: number | null = null;\n        for (const line of output.trim().split('\\n')) {\n            if (line.startsWith('p')) {\n                currentPid = parseInt(line.slice(1), 10);\n            } else if (line.startsWith('n') && currentPid !== null) {\n                result.set(currentPid, line.slice(1));\n                currentPid = null;\n            }\n        }\n    } catch {\n        // Try per-PID fallback with pwdx (Linux)\n        for (const pid of pids) {\n            try {\n                const output = execFileSync(\n                    'pwdx', [String(pid)],\n                    { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] },\n                );\n                const match = output.match(/^\\d+:\\s*(.+)$/);\n                if (match) {\n                    result.set(pid, match[1].trim());\n                }\n            } catch {\n                // Skip this PID\n            }\n        }\n    }\n\n    return result;\n}\n\n/**\n * Batch-get process start times for multiple PIDs.\n *\n * Single `ps -o pid=,lstart= -p PID1,PID2,...` call.\n * Uses lstart format which gives full timestamp (e.g., \"Thu Feb  5 16:00:57 2026\").\n * Returns partial results.\n */\nexport function batchGetProcessStartTimes(pids: number[]): Map<number, Date> {\n    const result = new Map<number, Date>();\n    if (pids.length === 0) return result;\n\n    try {\n        const output = execFileSync(\n            'ps', ['-o', 'pid=,lstart=', '-p', pids.join(',')],\n            { encoding: 'utf-8' },\n        );\n\n        for (const rawLine of output.split('\\n')) {\n            const line = rawLine.trim();\n            if (!line) continue;\n\n            // Format: \"  PID  DAY MON DD HH:MM:SS YYYY\"\n            // e.g., \" 78070 Wed Mar 18 23:18:01 2026\"\n            const match = line.match(/^\\s*(\\d+)\\s+(.+)$/);\n            if (!match) continue;\n\n            const pid = parseInt(match[1], 10);\n            const dateStr = match[2].trim();\n\n            if (!Number.isFinite(pid)) continue;\n\n            const date = new Date(dateStr);\n            if (!Number.isNaN(date.getTime())) {\n                result.set(pid, date);\n            }\n        }\n    } catch {\n        // Return whatever we have\n    }\n\n    return result;\n}\n\n/**\n * Enrich ProcessInfo array with cwd and startTime.\n *\n * Calls batchGetProcessCwds and batchGetProcessStartTimes in batched shell calls,\n * then populates each ProcessInfo in-place. Returns partial results —\n * if a PID fails, that process keeps empty cwd / undefined startTime.\n */\nexport function enrichProcesses(processes: ProcessInfo[]): ProcessInfo[] {\n    if (processes.length === 0) return processes;\n\n    const pids = processes.map(p => p.pid);\n    const cwdMap = batchGetProcessCwds(pids);\n    const startTimeMap = batchGetProcessStartTimes(pids);\n\n    for (const proc of processes) {\n        proc.cwd = cwdMap.get(proc.pid) || '';\n        proc.startTime = startTimeMap.get(proc.pid);\n    }\n\n    return processes;\n}\n\nfunction isSameTerminalProcess(proc: ProcessInfo, matched: ProcessInfo): boolean {\n    const sameTty = proc.tty !== '' && proc.tty !== '?' && proc.tty === matched.tty;\n    const sameCwd = proc.cwd !== '' && proc.cwd === matched.cwd;\n\n    return sameTty && (sameCwd || proc.cwd === '' || matched.cwd === '');\n}\n\nfunction matchesProcessIdentity(proc: ProcessInfo, matched: ProcessInfo): boolean {\n    return proc.pid === matched.pid || isSameTerminalProcess(proc, matched);\n}\n\nexport function findWrapperProcess(\n    processes: ProcessInfo[],\n    child: ProcessInfo,\n): ProcessInfo | undefined {\n    return processes.find((proc) => (\n        proc.pid !== child.pid &&\n        child.ppid === proc.pid &&\n        matchesProcessIdentity(proc, child)\n    ));\n}\n\n/**\n * Find parent wrapper processes that should not be reported as separate agents.\n *\n * A process is considered a wrapper when it is the parent of another candidate\n * agent process in the same terminal/worktree, or when it points at the same\n * terminal/worktree as an already session-matched process.\n */\nexport function findWrapperProcessPids(\n    processes: ProcessInfo[],\n    matchedProcesses: ProcessInfo[] = [],\n): Set<number> {\n    const wrappers = new Set<number>();\n\n    for (const child of processes) {\n        const wrapper = findWrapperProcess(processes, child);\n        if (wrapper) {\n            wrappers.add(wrapper.pid);\n        }\n    }\n\n    for (const proc of processes) {\n        if (matchedProcesses.some((matched) => (\n            proc.pid !== matched.pid && isSameTerminalProcess(proc, matched)\n        ))) {\n            wrappers.add(proc.pid);\n        }\n    }\n\n    return wrappers;\n}\n\n/**\n * Get the TTY device for a specific process\n */\nexport function getProcessTty(pid: number): string {\n    try {\n        const output = execFileSync(\n            'ps', ['-p', String(pid), '-o', 'tty='],\n            { encoding: 'utf-8' },\n        );\n\n        const tty = output.trim();\n        return tty.startsWith('/dev/') ? tty.slice(5) : tty;\n    } catch {\n        return '?';\n    }\n}\n"],"names":["path","execFileSync","listAgentProcesses","namePattern","test","output","encoding","lowerPattern","toLowerCase","processes","line","trim","split","match","pid","parseInt","ppid","Number","isNaN","tty","command","executable","base","basename","ttyShort","startsWith","slice","push","cwd","batchGetProcessCwds","pids","result","Map","length","join","stdio","currentPid","set","String","batchGetProcessStartTimes","rawLine","dateStr","isFinite","date","Date","getTime","enrichProcesses","map","p","cwdMap","startTimeMap","proc","get","startTime","isSameTerminalProcess","matched","sameTty","sameCwd","matchesProcessIdentity","findWrapperProcess","child","find","findWrapperProcessPids","matchedProcesses","wrappers","Set","wrapper","add","some","getProcessTty"],"mappings":"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"}
+{"version":3,"sources":["../../src/utils/process.ts"],"sourcesContent":["/**\n * Process Detection Utilities\n *\n * Shared shell command wrappers for detecting and inspecting running processes.\n * Built-in refresh discovery uses captureProcessSnapshot(); synchronous helpers\n * remain exported for compatibility with existing consumers.\n */\n\nimport * as path from 'path';\nimport { execFile, execFileSync } from 'child_process';\nimport type { ProcessInfo } from '../adapters/AgentAdapter.js';\n\nconst PROCESS_EXEC_MAX_BUFFER = 10 * 1024 * 1024;\nconst VALID_EXECUTABLE_NAME = /^[a-zA-Z0-9_-]+$/;\n\nexport function executableBasename(command: string): string {\n    const executable = command.trim().split(/\\s+/)[0] || '';\n    return path.basename(executable.replace(/\\\\/g, '/')).toLowerCase();\n}\n\nfunction normalizeExecutableName(name: string): string {\n    const lower = name.toLowerCase();\n    return lower.endsWith('.exe') ? lower.slice(0, -4) : lower;\n}\n\nfunction normalizedProcessNames(namePatterns: readonly string[]): Set<string> {\n    return new Set(namePatterns.filter(Boolean).map(normalizeExecutableName));\n}\n\nexport function filterByProcessNames(\n    processes: readonly ProcessInfo[],\n    namePatterns: readonly string[],\n): ProcessInfo[] {\n    const names = normalizedProcessNames(namePatterns);\n    if (names.size === 0) return [];\n    return processes.filter((process) => (\n        names.has(normalizeExecutableName(executableBasename(process.command)))\n    ));\n}\n\n/**\n * List running processes matching an agent executable name.\n *\n * Uses `ps -axo` then filters in JS for exact executable basename match.\n * This avoids shell pipelines and string interpolation.\n *\n * Returned ProcessInfo has pid, ppid, command, tty populated.\n * cwd and startTime are NOT populated — call enrichProcesses() to fill them.\n */\nexport function listAgentProcesses(namePattern: string): ProcessInfo[] {\n    // Validate pattern contains only safe characters (alphanumeric, dash, underscore)\n    if (!namePattern || !VALID_EXECUTABLE_NAME.test(namePattern)) {\n        return [];\n    }\n\n    try {\n        const output = execFileSync('ps', ['-axo', 'pid=,ppid=,tty=,command='], { encoding: 'utf-8' });\n\n        const names = normalizedProcessNames([namePattern]);\n        const processes: ProcessInfo[] = [];\n\n        for (const line of output.trim().split('\\n')) {\n            if (!line.trim()) continue;\n\n            const match = line.match(/^\\s*(\\d+)\\s+(\\d+)\\s+(\\S+)\\s+(.+)$/);\n            if (!match) continue;\n\n            const pid = parseInt(match[1], 10);\n            const ppid = parseInt(match[2], 10);\n            if (Number.isNaN(pid) || Number.isNaN(ppid)) continue;\n\n            const tty = match[3];\n            const command = match[4];\n\n            if (!names.has(normalizeExecutableName(executableBasename(command)))) continue;\n\n            const ttyShort = tty.startsWith('/dev/') ? tty.slice(5) : tty;\n\n            processes.push({\n                pid,\n                ppid,\n                command,\n                cwd: '',\n                tty: ttyShort,\n            });\n        }\n\n        return processes;\n    } catch {\n        return [];\n    }\n}\n\nfunction execFileText(\n    file: string,\n    args: readonly string[],\n): Promise<string> {\n    return new Promise((resolve, reject) => {\n        execFile(file, args, { encoding: 'utf-8', maxBuffer: PROCESS_EXEC_MAX_BUFFER }, (error, stdout) => {\n            if (error) {\n                reject(error);\n                return;\n            }\n            resolve(stdout);\n        });\n    });\n}\n\nfunction parseProcessList(output: string, namePatterns: ReadonlySet<string>): ProcessInfo[] {\n    const processes: ProcessInfo[] = [];\n\n    for (const line of output.trim().split('\\n')) {\n        if (!line.trim()) continue;\n\n        const match = line.match(/^\\s*(\\d+)\\s+(\\d+)\\s+(\\S+)\\s+(.+)$/);\n        if (!match) continue;\n\n        const pid = parseInt(match[1], 10);\n        const ppid = parseInt(match[2], 10);\n        if (Number.isNaN(pid) || Number.isNaN(ppid)) continue;\n\n        const tty = match[3];\n        const command = match[4];\n        const base = executableBasename(command);\n        const normalizedBase = normalizeExecutableName(base);\n        if (!namePatterns.has(normalizedBase)) continue;\n\n        processes.push({\n            pid,\n            ppid,\n            command,\n            cwd: '',\n            tty: tty.startsWith('/dev/') ? tty.slice(5) : tty,\n        });\n    }\n\n    return processes;\n}\n\nasync function batchGetProcessCwdsAsync(pids: number[]): Promise<Map<number, string>> {\n    const result = new Map<number, string>();\n    if (pids.length === 0) return result;\n\n    try {\n        const output = await execFileText('lsof', ['-a', '-d', 'cwd', '-Fn', '-p', pids.join(',')]);\n        let currentPid: number | null = null;\n        for (const line of output.trim().split('\\n')) {\n            if (line.startsWith('p')) {\n                currentPid = parseInt(line.slice(1), 10);\n            } else if (line.startsWith('n') && currentPid !== null) {\n                result.set(currentPid, line.slice(1));\n                currentPid = null;\n            }\n        }\n        return result;\n    } catch {\n        const entries = await Promise.all(pids.map(async (pid) => {\n            try {\n                const output = await execFileText('pwdx', [String(pid)]);\n                const match = output.match(/^\\d+:\\s*(.+)$/);\n                return match ? [pid, match[1].trim()] as const : null;\n            } catch {\n                return null;\n            }\n        }));\n        for (const entry of entries) {\n            if (entry) result.set(entry[0], entry[1]);\n        }\n        return result;\n    }\n}\n\nasync function batchGetProcessStartTimesAsync(pids: number[]): Promise<Map<number, Date>> {\n    const result = new Map<number, Date>();\n    if (pids.length === 0) return result;\n\n    try {\n        const output = await execFileText('ps', ['-o', 'pid=,lstart=', '-p', pids.join(',')]);\n        for (const rawLine of output.split('\\n')) {\n            const match = rawLine.trim().match(/^(\\d+)\\s+(.+)$/);\n            if (!match) continue;\n            const pid = parseInt(match[1], 10);\n            const date = new Date(match[2].trim());\n            if (Number.isFinite(pid) && !Number.isNaN(date.getTime())) result.set(pid, date);\n        }\n    } catch {\n        // Return partial/empty data, matching the synchronous helper.\n    }\n    return result;\n}\n\n/**\n * Capture and enrich relevant processes without blocking the event loop.\n * One base process listing is shared by every requested executable name.\n */\nexport async function captureProcessSnapshot(namePatterns: readonly string[]): Promise<ProcessInfo[]> {\n    const names = normalizedProcessNames(\n        namePatterns.filter((name) => Boolean(name) && VALID_EXECUTABLE_NAME.test(name)),\n    );\n    if (names.size === 0) return [];\n\n    try {\n        const output = await execFileText('ps', ['-axo', 'pid=,ppid=,tty=,command=']);\n        const processes = parseProcessList(output, names);\n        const pids = processes.map((process) => process.pid);\n        const [cwdMap, startTimeMap] = await Promise.all([\n            batchGetProcessCwdsAsync(pids),\n            batchGetProcessStartTimesAsync(pids),\n        ]);\n        return processes.map((process) => ({\n            ...process,\n            cwd: cwdMap.get(process.pid) || '',\n            startTime: startTimeMap.get(process.pid),\n        }));\n    } catch {\n        return [];\n    }\n}\n\n/**\n * Batch-get current working directories for multiple PIDs.\n *\n * Single `lsof -a -d cwd -Fn -p PID1,PID2,...` call.\n * Returns partial results — if lsof fails for one PID, others still return.\n */\nexport function batchGetProcessCwds(pids: number[]): Map<number, string> {\n    const result = new Map<number, string>();\n    if (pids.length === 0) return result;\n\n    try {\n        const output = execFileSync(\n            'lsof', ['-a', '-d', 'cwd', '-Fn', '-p', pids.join(',')],\n            { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] },\n        );\n\n        // lsof output format: p{PID}\\nn{path}\\np{PID}\\nn{path}...\n        let currentPid: number | null = null;\n        for (const line of output.trim().split('\\n')) {\n            if (line.startsWith('p')) {\n                currentPid = parseInt(line.slice(1), 10);\n            } else if (line.startsWith('n') && currentPid !== null) {\n                result.set(currentPid, line.slice(1));\n                currentPid = null;\n            }\n        }\n    } catch {\n        // Try per-PID fallback with pwdx (Linux)\n        for (const pid of pids) {\n            try {\n                const output = execFileSync(\n                    'pwdx', [String(pid)],\n                    { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] },\n                );\n                const match = output.match(/^\\d+:\\s*(.+)$/);\n                if (match) {\n                    result.set(pid, match[1].trim());\n                }\n            } catch {\n                // Skip this PID\n            }\n        }\n    }\n\n    return result;\n}\n\n/**\n * Batch-get process start times for multiple PIDs.\n *\n * Single `ps -o pid=,lstart= -p PID1,PID2,...` call.\n * Uses lstart format which gives full timestamp (e.g., \"Thu Feb  5 16:00:57 2026\").\n * Returns partial results.\n */\nexport function batchGetProcessStartTimes(pids: number[]): Map<number, Date> {\n    const result = new Map<number, Date>();\n    if (pids.length === 0) return result;\n\n    try {\n        const output = execFileSync(\n            'ps', ['-o', 'pid=,lstart=', '-p', pids.join(',')],\n            { encoding: 'utf-8' },\n        );\n\n        for (const rawLine of output.split('\\n')) {\n            const line = rawLine.trim();\n            if (!line) continue;\n\n            // Format: \"  PID  DAY MON DD HH:MM:SS YYYY\"\n            // e.g., \" 78070 Wed Mar 18 23:18:01 2026\"\n            const match = line.match(/^\\s*(\\d+)\\s+(.+)$/);\n            if (!match) continue;\n\n            const pid = parseInt(match[1], 10);\n            const dateStr = match[2].trim();\n\n            if (!Number.isFinite(pid)) continue;\n\n            const date = new Date(dateStr);\n            if (!Number.isNaN(date.getTime())) {\n                result.set(pid, date);\n            }\n        }\n    } catch {\n        // Return whatever we have\n    }\n\n    return result;\n}\n\n/**\n * Enrich ProcessInfo array with cwd and startTime.\n *\n * Calls batchGetProcessCwds and batchGetProcessStartTimes in batched shell calls,\n * then populates each ProcessInfo in-place. Returns partial results —\n * if a PID fails, that process keeps empty cwd / undefined startTime.\n */\nexport function enrichProcesses(processes: ProcessInfo[]): ProcessInfo[] {\n    if (processes.length === 0) return processes;\n\n    const pids = processes.map(p => p.pid);\n    const cwdMap = batchGetProcessCwds(pids);\n    const startTimeMap = batchGetProcessStartTimes(pids);\n\n    for (const proc of processes) {\n        proc.cwd = cwdMap.get(proc.pid) || '';\n        proc.startTime = startTimeMap.get(proc.pid);\n    }\n\n    return processes;\n}\n\nfunction isSameTerminalProcess(proc: ProcessInfo, matched: ProcessInfo): boolean {\n    const sameTty = proc.tty !== '' && proc.tty !== '?' && proc.tty === matched.tty;\n    const sameCwd = proc.cwd !== '' && proc.cwd === matched.cwd;\n\n    return sameTty && (sameCwd || proc.cwd === '' || matched.cwd === '');\n}\n\nfunction matchesProcessIdentity(proc: ProcessInfo, matched: ProcessInfo): boolean {\n    return proc.pid === matched.pid || isSameTerminalProcess(proc, matched);\n}\n\nexport function findWrapperProcess(\n    processes: ProcessInfo[],\n    child: ProcessInfo,\n): ProcessInfo | undefined {\n    return processes.find((proc) => (\n        proc.pid !== child.pid &&\n        child.ppid === proc.pid &&\n        matchesProcessIdentity(proc, child)\n    ));\n}\n\n/**\n * Find parent wrapper processes that should not be reported as separate agents.\n *\n * A process is considered a wrapper when it is the parent of another candidate\n * agent process in the same terminal/worktree, or when it points at the same\n * terminal/worktree as an already session-matched process.\n */\nexport function findWrapperProcessPids(\n    processes: ProcessInfo[],\n    matchedProcesses: ProcessInfo[] = [],\n): Set<number> {\n    const wrappers = new Set<number>();\n\n    for (const child of processes) {\n        const wrapper = findWrapperProcess(processes, child);\n        if (wrapper) {\n            wrappers.add(wrapper.pid);\n        }\n    }\n\n    for (const proc of processes) {\n        if (matchedProcesses.some((matched) => (\n            proc.pid !== matched.pid && isSameTerminalProcess(proc, matched)\n        ))) {\n            wrappers.add(proc.pid);\n        }\n    }\n\n    return wrappers;\n}\n\n/**\n * Get the TTY device for a specific process\n */\nexport function getProcessTty(pid: number): string {\n    try {\n        const output = execFileSync(\n            'ps', ['-p', String(pid), '-o', 'tty='],\n            { encoding: 'utf-8' },\n        );\n\n        const tty = output.trim();\n        return tty.startsWith('/dev/') ? tty.slice(5) : tty;\n    } catch {\n        return '?';\n    }\n}\n"],"names":["path","execFile","execFileSync","PROCESS_EXEC_MAX_BUFFER","VALID_EXECUTABLE_NAME","executableBasename","command","executable","trim","split","basename","replace","toLowerCase","normalizeExecutableName","name","lower","endsWith","slice","normalizedProcessNames","namePatterns","Set","filter","Boolean","map","filterByProcessNames","processes","names","size","process","has","listAgentProcesses","namePattern","test","output","encoding","line","match","pid","parseInt","ppid","Number","isNaN","tty","ttyShort","startsWith","push","cwd","execFileText","file","args","Promise","resolve","reject","maxBuffer","error","stdout","parseProcessList","base","normalizedBase","batchGetProcessCwdsAsync","pids","result","Map","length","join","currentPid","set","entries","all","String","entry","batchGetProcessStartTimesAsync","rawLine","date","Date","isFinite","getTime","captureProcessSnapshot","cwdMap","startTimeMap","get","startTime","batchGetProcessCwds","stdio","batchGetProcessStartTimes","dateStr","enrichProcesses","p","proc","isSameTerminalProcess","matched","sameTty","sameCwd","matchesProcessIdentity","findWrapperProcess","child","find","findWrapperProcessPids","matchedProcesses","wrappers","wrapper","add","some","getProcessTty"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-devkit/agent-manager",
-  "version": "0.26.2",
+  "version": "0.26.4",
   "type": "module",
   "description": "Standalone agent detection and management utilities for AI DevKit",
   "main": "dist/index.js",

package/src/AgentManager.ts

@@ -10,9 +10,13 @@ import type {
     AgentInfo,
     SessionSummary,
     ListSessionsOptions,
+    ProcessInfo,
 } from './adapters/AgentAdapter.js';
 import { sortAgents, type AgentSortKey } from './utils/sortAgents.js';
 import { AgentRegistry, type RegistryEntry } from './utils/AgentRegistry.js';
+import { captureProcessSnapshot, filterByProcessNames } from './utils/process.js';
+
+type ProcessSnapshotCapture = (namePatterns: readonly string[]) => Promise<ProcessInfo[]>;
 
 export interface ListAgentsOptions {
     /**
@@ -41,7 +45,10 @@ export class AgentManager {
     private adapters: Map<string, AgentAdapter> = new Map();
     private registry: AgentRegistry;
 
-    constructor(registry: AgentRegistry = AgentRegistry.default()) {
+    constructor(
+        registry: AgentRegistry = AgentRegistry.default(),
+        private readonly captureSnapshot: ProcessSnapshotCapture = captureProcessSnapshot,
+    ) {
         this.registry = registry;
     }
 
@@ -126,10 +133,27 @@ export class AgentManager {
         const allAgents: AgentInfo[] = [];
         const errors: Array<{ type: string; error: Error }> = [];
 
-        // Query all adapters in parallel
-        const adapterPromises = Array.from(this.adapters.values()).map(async (adapter) => {
+        const adapters = Array.from(this.adapters.values());
+        const processNames = Array.from(new Set(adapters.flatMap(
+            (adapter) => adapter.processNames ? [...adapter.processNames] : [],
+        )));
+        let processes: readonly ProcessInfo[] = [];
+        if (processNames.length > 0) {
+            try {
+                processes = await this.captureSnapshot(processNames);
+            } catch {
+                processes = [];
+            }
+        }
+
+        // Query all adapters in parallel using executable-scoped slices of the shared snapshot.
+        const adapterPromises = adapters.map(async (adapter) => {
             try {
-                const agents = await adapter.detectAgents();
+                const agents = adapter.processNames
+                    ? await adapter.detectAgents({
+                        processes: filterByProcessNames(processes, adapter.processNames),
+                    })
+                    : await adapter.detectAgents();
                 return { type: adapter.type, agents, error: null };
             } catch (error) {
                 // Capture error but don't throw - allow other adapters to continue
@@ -156,15 +180,18 @@ export class AgentManager {
             });
         }
 
-        const preExistingByPid = new Map(this.registry.list().map((e) => [e.pid, e]));
+        const identityKey = (type: string, pid: number): string => `${type}:${pid}`;
+        const preExistingByIdentity = new Map(
+            this.registry.list().map((entry) => [identityKey(entry.type, entry.pid), entry]),
+        );
         const entries = allAgents.map((agent) =>
-            this.toRegistryEntry(agent, preExistingByPid.get(agent.pid)),
+            this.toRegistryEntry(agent, preExistingByIdentity.get(identityKey(agent.type, agent.pid))),
         );
         if (entries.length > 0) this.registry.registerBatch(entries);
-        this.registry.prune();
+        this.registry.pruneIfDue();
 
         for (const agent of allAgents) {
-            const entry = preExistingByPid.get(agent.pid);
+            const entry = preExistingByIdentity.get(identityKey(agent.type, agent.pid));
             if (entry) {
                 agent.name = entry.name;
             }

package/src/__tests__/AgentManager.test.ts

@@ -13,6 +13,7 @@ import type {
     AgentType,
     ConversationMessage,
     SessionSummary,
+    ProcessInfo,
 } from '../adapters/AgentAdapter.js';
 import { AgentStatus } from '../adapters/AgentAdapter.js';
 import { AgentRegistry, type RegistryEntry } from '../utils/AgentRegistry.js';
@@ -170,6 +171,94 @@ describe('AgentManager', () => {
     });
 
     describe('listAgents', () => {
+        it('shares one process capture while giving each adapter only its declared executables', async () => {
+            const processes: ProcessInfo[] = [
+                { pid: 101, command: 'claude', cwd: '/claude', tty: 's001' },
+                { pid: 202, command: 'node /bin/pi', cwd: '/pi', tty: 's002' },
+            ];
+            const captureSnapshot = vi.fn(async () => processes);
+            const createSnapshotAdapter = (type: AgentType, processNames: string[]) => ({
+                type,
+                processNames,
+                detectAgents: vi.fn(async () => []),
+                canHandle: () => true,
+                getConversation: () => [],
+                listSessions: async () => [],
+            });
+            const claude = createSnapshotAdapter('claude', ['claude']);
+            const pi = createSnapshotAdapter('pi', ['pi', 'node']);
+            const snapshotManager = new AgentManager(
+                new AgentRegistry(path.join(tmpDir, 'snapshot-agents.json')),
+                captureSnapshot,
+            );
+
+            snapshotManager.registerAdapter(claude as AgentAdapter);
+            snapshotManager.registerAdapter(pi as AgentAdapter);
+
+            await snapshotManager.listAgents();
+
+            expect(captureSnapshot).toHaveBeenCalledTimes(1);
+            expect(captureSnapshot).toHaveBeenCalledWith(['claude', 'pi', 'node']);
+            expect(claude.detectAgents).toHaveBeenCalledWith({ processes: [processes[0]] });
+            expect(pi.detectAgents).toHaveBeenCalledWith({ processes: [processes[1]] });
+        });
+
+        it('does not expose foreign command arguments to broad Pi and Gemini matchers', async () => {
+            const processes: ProcessInfo[] = [
+                { pid: 100, command: 'node /usr/local/lib/gemini.js', cwd: '/g', tty: 's001' },
+                { pid: 200, command: 'codex exec --cd /Users/x/repos/gemini', cwd: '/c', tty: 's002' },
+                { pid: 300, command: 'node /usr/local/lib/pi.js', cwd: '/p', tty: 's003' },
+                { pid: 400, command: 'claude --resume /Users/x/pi/session.jsonl', cwd: '/a', tty: 's004' },
+            ];
+            const captureSnapshot = vi.fn(async () => processes);
+            const createSnapshotAdapter = (type: AgentType, processNames: string[]) => ({
+                type,
+                processNames,
+                detectAgents: vi.fn(async () => []),
+                canHandle: () => true,
+                getConversation: () => [],
+                listSessions: async () => [],
+            });
+            const gemini = createSnapshotAdapter('gemini_cli', ['node']);
+            const codex = createSnapshotAdapter('codex', ['codex']);
+            const pi = createSnapshotAdapter('pi', ['pi', 'node']);
+            const claude = createSnapshotAdapter('claude', ['claude']);
+            const snapshotManager = new AgentManager(
+                new AgentRegistry(path.join(tmpDir, 'filtered-snapshot-agents.json')),
+                captureSnapshot,
+            );
+
+            snapshotManager.registerAdapter(gemini as AgentAdapter);
+            snapshotManager.registerAdapter(codex as AgentAdapter);
+            snapshotManager.registerAdapter(pi as AgentAdapter);
+            snapshotManager.registerAdapter(claude as AgentAdapter);
+
+            await snapshotManager.listAgents();
+
+            expect(captureSnapshot).toHaveBeenCalledTimes(1);
+            expect(captureSnapshot).toHaveBeenCalledWith(['node', 'codex', 'pi', 'claude']);
+            expect(gemini.detectAgents).toHaveBeenCalledWith({ processes: [processes[0], processes[2]] });
+            expect(codex.detectAgents).toHaveBeenCalledWith({ processes: [processes[1]] });
+            expect(pi.detectAgents).toHaveBeenCalledWith({ processes: [processes[0], processes[2]] });
+            expect(claude.detectAgents).toHaveBeenCalledWith({ processes: [processes[3]] });
+        });
+
+        it('does not pass a snapshot context to legacy adapters', async () => {
+            const captureSnapshot = vi.fn(async () => []);
+            const legacy = new MockAdapter('claude');
+            const detect = vi.spyOn(legacy, 'detectAgents');
+            const snapshotManager = new AgentManager(
+                new AgentRegistry(path.join(tmpDir, 'legacy-agents.json')),
+                captureSnapshot,
+            );
+            snapshotManager.registerAdapter(legacy);
+
+            await snapshotManager.listAgents();
+
+            expect(captureSnapshot).not.toHaveBeenCalled();
+            expect(detect).toHaveBeenCalledWith();
+        });
+
         it('should return empty array when no adapters registered', async () => {
             const agents = await manager.listAgents();
             expect(agents).toEqual([]);
@@ -255,15 +344,25 @@ describe('AgentManager', () => {
         let regPath: string;
         let registry: AgentRegistry;
         let scopedManager: AgentManager;
+        let nowMs: number;
+        let databaseOperations: string[];
 
         beforeEach(() => {
             tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-manager-'));
             regPath = path.join(tmpDir, 'agents.json');
-            registry = new AgentRegistry(regPath);
+            nowMs = Date.parse('2026-08-14T10:00:00.000Z');
+            databaseOperations = [];
+            registry = new AgentRegistry(regPath, {
+                now: () => new Date(nowMs),
+                pruneIntervalMs: 30_000,
+                onDatabaseOperation: (sql) => databaseOperations.push(sql),
+            });
             scopedManager = new AgentManager(registry);
+            databaseOperations = [];
         });
 
         afterEach(() => {
+            vi.restoreAllMocks();
             fs.rmSync(tmpDir, { recursive: true, force: true });
         });
 
@@ -340,6 +439,35 @@ describe('AgentManager', () => {
             expect(registry.list()[0].startedAt).toBe('2026-05-30T00:00:00.000Z');
         });
 
+        it('preserves custom name and tmux session across two EPERM refresh cycles', async () => {
+            registry.register({
+                name: 'merry',
+                type: 'claude',
+                pid: process.pid,
+                tmuxSession: 'merry-tmux',
+                cwd: '/cwd/merry',
+                startedAt: '2026-05-30T00:00:00.000Z',
+                sessionId: 'sid-merry',
+                sessionFilePath: '/path/merry.jsonl',
+            });
+            scopedManager.registerAdapter(new MockAdapter('claude', [
+                createMockAgent({ name: `ai-devkit-${process.pid}`, pid: process.pid }),
+            ]));
+            vi.spyOn(process, 'kill').mockImplementation(() => {
+                throw Object.assign(new Error('operation not permitted'), { code: 'EPERM' });
+            });
+
+            const firstRefresh = await scopedManager.listAgents();
+            const secondRefresh = await scopedManager.listAgents();
+
+            expect(firstRefresh[0].name).toBe('merry');
+            expect(secondRefresh[0].name).toBe('merry');
+            expect(registry.lookup('merry')).toMatchObject({
+                name: 'merry',
+                tmuxSession: 'merry-tmux',
+            });
+        });
+
         it('preserves a user-managed name when a fallback row was written later for the same pid', async () => {
             registry.register({
                 name: 'agent-list-debug',
@@ -406,15 +534,114 @@ describe('AgentManager', () => {
                 .toEqual(['a', 'b']);
         });
 
-        it('skips registerBatch when no agents detected (still calls prune)', async () => {
+        it('performs zero database writes on an unchanged refresh', async () => {
+            const adapter = new MockAdapter('claude', [
+                createMockAgent({
+                    name: 'stable',
+                    pid: process.pid,
+                    projectPath: '/cwd/stable',
+                    sessionId: 'stable-session',
+                    sessionFilePath: '/sessions/stable.jsonl',
+                }),
+            ]);
+            scopedManager.registerAdapter(adapter);
+            await scopedManager.listAgents();
+            databaseOperations = [];
+
+            await scopedManager.listAgents();
+
+            const writes = databaseOperations.filter((sql) => /^\s*(BEGIN|COMMIT|INSERT|UPDATE|DELETE)/i.test(sql));
+            expect(writes).toEqual([]);
+        });
+
+        it('persists changed fields once in one write transaction', async () => {
+            const adapter = new MockAdapter('claude', [
+                createMockAgent({ name: 'changing', pid: process.pid, projectPath: '/cwd/before' }),
+            ]);
+            scopedManager.registerAdapter(adapter);
+            await scopedManager.listAgents();
+            databaseOperations = [];
+            nowMs += 1_000;
+            adapter.setAgents([
+                createMockAgent({ name: 'changing', pid: process.pid, projectPath: '/cwd/after' }),
+            ]);
+
+            await scopedManager.listAgents();
+
+            const upserts = databaseOperations.filter((sql) => /^\s*INSERT INTO agents/i.test(sql));
+            const transactions = databaseOperations.filter((sql) => /^\s*(BEGIN|COMMIT)/i.test(sql));
+            expect(upserts).toHaveLength(1);
+            expect(upserts[0]).toContain("'2026-08-14T10:00:01.000Z'");
+            expect(transactions).toHaveLength(2);
+            expect(registry.lookup('changing')?.cwd).toBe('/cwd/after');
+        });
+
+        it('prunes newly dead entries only when the passive cadence is due', async () => {
+            registry.register({
+                name: 'cadenced',
+                type: 'claude',
+                pid: process.pid,
+                tmuxSession: '',
+                cwd: '/cwd/cadenced',
+                startedAt: '2026-05-30T00:00:00.000Z',
+                sessionId: 'sid-cadenced',
+                sessionFilePath: '',
+            });
+            const alive = vi.spyOn(registry, 'isAlive').mockReturnValue(true);
+
+            await scopedManager.listAgents();
+            expect(alive).toHaveBeenCalledTimes(1);
+            alive.mockReturnValue(false);
+            nowMs += 29_999;
+
+            await scopedManager.listAgents();
+            expect(alive).toHaveBeenCalledTimes(1);
+            expect(registry.lookup('cadenced')).not.toBeNull();
+
+            nowMs += 1;
+            await scopedManager.listAgents();
+            expect(alive).toHaveBeenCalledTimes(2);
+            expect(registry.lookup('cadenced')).toBeNull();
+        });
+
+        it('does not inherit a name when the same pid is reused by another agent type', async () => {
+            registry.register({
+                name: 'old-claude',
+                type: 'claude',
+                pid: process.pid,
+                tmuxSession: 'old-claude',
+                cwd: '/cwd/old',
+                startedAt: '2026-05-30T00:00:00.000Z',
+                sessionId: 'old-session',
+                sessionFilePath: '',
+            });
+            scopedManager.registerAdapter(new MockAdapter('codex', [
+                createMockAgent({
+                    name: 'new-codex',
+                    type: 'codex',
+                    pid: process.pid,
+                    projectPath: '/cwd/new',
+                    sessionId: 'new-session',
+                }),
+            ]));
+
+            const agents = await scopedManager.listAgents();
+
+            expect(agents[0].name).toBe('new-codex');
+            expect(registry.lookup('old-claude')).toBeNull();
+            expect(registry.lookup('new-codex')).toMatchObject({ type: 'codex', pid: process.pid });
+        });
+
+        it('skips registerBatch when no agents are detected and prune is not due', async () => {
             const writeSpy = vi.spyOn(registry, 'registerBatch');
-            const pruneSpy = vi.spyOn(registry, 'prune');
+            const pruneSpy = vi.spyOn(registry, 'pruneIfDue');
 
             scopedManager.registerAdapter(new MockAdapter('claude', []));
             await scopedManager.listAgents();
+            await scopedManager.listAgents();
 
             expect(writeSpy).not.toHaveBeenCalled();
-            expect(pruneSpy).toHaveBeenCalledTimes(1);
+            expect(pruneSpy).toHaveBeenCalledTimes(2);
         });
     });