@ai-devkit/agent-manager 0.19.0 → 0.19.1

package/dist/utils/process.js

@@ -8,10 +8,10 @@ import { execFileSync } from 'child_process';
 /**
  * List running processes matching an agent executable name.
  *
- * Uses `ps aux` then filters in JS for exact executable basename match.
+ * Uses `ps -axo` then filters in JS for exact executable basename match.
  * This avoids shell pipelines and string interpolation.
  *
- * Returned ProcessInfo has pid, command, tty populated.
+ * Returned ProcessInfo has pid, ppid, command, tty populated.
  * cwd and startTime are NOT populated — call enrichProcesses() to fill them.
  */ export function listAgentProcesses(namePattern) {
     // Validate pattern contains only safe characters (alphanumeric, dash, underscore)
@@ -20,7 +20,8 @@ import { execFileSync } from 'child_process';
     }
     try {
         const output = execFileSync('ps', [
-            'aux'
+            '-axo',
+            'pid=,ppid=,tty=,command='
         ], {
             encoding: 'utf-8'
         });
@@ -28,12 +29,13 @@ import { execFileSync } from 'child_process';
         const processes = [];
         for (const line of output.trim().split('\n')){
             if (!line.trim()) continue;
-            const parts = line.trim().split(/\s+/);
-            if (parts.length < 11) continue;
-            const pid = parseInt(parts[1], 10);
-            if (Number.isNaN(pid)) continue;
-            const tty = parts[6];
-            const command = parts.slice(10).join(' ');
+            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];
             // Check that the executable basename matches exactly
             const executable = command.trim().split(/\s+/)[0] || '';
             const base = path.basename(executable).toLowerCase();
@@ -43,6 +45,7 @@ import { execFileSync } from 'child_process';
             const ttyShort = tty.startsWith('/dev/') ? tty.slice(5) : tty;
             processes.push({
                 pid,
+                ppid,
                 command,
                 cwd: '',
                 tty: ttyShort
@@ -167,6 +170,38 @@ import { execFileSync } from 'child_process';
     }
     return processes;
 }
+function isSameTerminalProcess(proc, matched) {
+    const sameTty = proc.tty !== '' && proc.tty !== '?' && proc.tty === matched.tty;
+    const sameCwd = proc.cwd !== '' && proc.cwd === matched.cwd;
+    return sameTty && (sameCwd || proc.cwd === '' || matched.cwd === '');
+}
+function matchesProcessIdentity(proc, matched) {
+    return proc.pid === matched.pid || isSameTerminalProcess(proc, matched);
+}
+export function findWrapperProcess(processes, child) {
+    return processes.find((proc)=>proc.pid !== child.pid && child.ppid === proc.pid && matchesProcessIdentity(proc, child));
+}
+/**
+ * Find parent wrapper processes that should not be reported as separate agents.
+ *
+ * A process is considered a wrapper when it is the parent of another candidate
+ * agent process in the same terminal/worktree, or when it points at the same
+ * terminal/worktree as an already session-matched process.
+ */ export function findWrapperProcessPids(processes, matchedProcesses = []) {
+    const wrappers = new Set();
+    for (const child of processes){
+        const wrapper = findWrapperProcess(processes, child);
+        if (wrapper) {
+            wrappers.add(wrapper.pid);
+        }
+    }
+    for (const proc of processes){
+        if (matchedProcesses.some((matched)=>proc.pid !== matched.pid && isSameTerminalProcess(proc, matched))) {
+            wrappers.add(proc.pid);
+        }
+    }
+    return wrappers;
+}
 /**
  * Get the TTY device for a specific process
  */ export function getProcessTty(pid) {

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 aux` then filters in JS for exact executable basename match.\n * This avoids shell pipelines and string interpolation.\n *\n * Returned ProcessInfo has pid, 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', ['aux'], { 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 parts = line.trim().split(/\\s+/);\n            if (parts.length < 11) continue;\n\n            const pid = parseInt(parts[1], 10);\n            if (Number.isNaN(pid)) continue;\n\n            const tty = parts[6];\n            const command = parts.slice(10).join(' ');\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                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\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","parts","length","pid","parseInt","Number","isNaN","tty","command","slice","join","executable","base","basename","ttyShort","startsWith","push","cwd","batchGetProcessCwds","pids","result","Map","stdio","currentPid","set","String","match","batchGetProcessStartTimes","rawLine","dateStr","isFinite","date","Date","getTime","enrichProcesses","map","p","cwdMap","startTimeMap","proc","get","startTime","getProcessTty"],"mappings":"AAAA;;;;;CAKC,GAED,YAAYA,UAAU,OAAO;AAC7B,SAASC,YAAY,QAAQ,gBAAgB;AAG7C;;;;;;;;CAQC,GACD,OAAO,SAASC,mBAAmBC,WAAmB;IAClD,kFAAkF;IAClF,IAAI,CAACA,eAAe,CAAC,mBAAmBC,IAAI,CAACD,cAAc;QACvD,OAAO,EAAE;IACb;IAEA,IAAI;QACA,MAAME,SAASJ,aAAa,MAAM;YAAC;SAAM,EAAE;YAAEK,UAAU;QAAQ;QAE/D,MAAMC,eAAeJ,YAAYK,WAAW;QAC5C,MAAMC,YAA2B,EAAE;QAEnC,KAAK,MAAMC,QAAQL,OAAOM,IAAI,GAAGC,KAAK,CAAC,MAAO;YAC1C,IAAI,CAACF,KAAKC,IAAI,IAAI;YAElB,MAAME,QAAQH,KAAKC,IAAI,GAAGC,KAAK,CAAC;YAChC,IAAIC,MAAMC,MAAM,GAAG,IAAI;YAEvB,MAAMC,MAAMC,SAASH,KAAK,CAAC,EAAE,EAAE;YAC/B,IAAII,OAAOC,KAAK,CAACH,MAAM;YAEvB,MAAMI,MAAMN,KAAK,CAAC,EAAE;YACpB,MAAMO,UAAUP,MAAMQ,KAAK,CAAC,IAAIC,IAAI,CAAC;YAErC,qDAAqD;YACrD,MAAMC,aAAaH,QAAQT,IAAI,GAAGC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI;YACrD,MAAMY,OAAOxB,KAAKyB,QAAQ,CAACF,YAAYf,WAAW;YAClD,IAAIgB,SAASjB,gBAAgBiB,SAAS,GAAGjB,aAAa,IAAI,CAAC,EAAE;gBACzD;YACJ;YAEA,MAAMmB,WAAWP,IAAIQ,UAAU,CAAC,WAAWR,IAAIE,KAAK,CAAC,KAAKF;YAE1DV,UAAUmB,IAAI,CAAC;gBACXb;gBACAK;gBACAS,KAAK;gBACLV,KAAKO;YACT;QACJ;QAEA,OAAOjB;IACX,EAAE,OAAM;QACJ,OAAO,EAAE;IACb;AACJ;AAEA;;;;;CAKC,GACD,OAAO,SAASqB,oBAAoBC,IAAc;IAC9C,MAAMC,SAAS,IAAIC;IACnB,IAAIF,KAAKjB,MAAM,KAAK,GAAG,OAAOkB;IAE9B,IAAI;QACA,MAAM3B,SAASJ,aACX,QAAQ;YAAC;YAAM;YAAM;YAAO;YAAO;YAAM8B,KAAKT,IAAI,CAAC;SAAK,EACxD;YAAEhB,UAAU;YAAS4B,OAAO;gBAAC;gBAAQ;gBAAQ;aAAS;QAAC;QAG3D,0DAA0D;QAC1D,IAAIC,aAA4B;QAChC,KAAK,MAAMzB,QAAQL,OAAOM,IAAI,GAAGC,KAAK,CAAC,MAAO;YAC1C,IAAIF,KAAKiB,UAAU,CAAC,MAAM;gBACtBQ,aAAanB,SAASN,KAAKW,KAAK,CAAC,IAAI;YACzC,OAAO,IAAIX,KAAKiB,UAAU,CAAC,QAAQQ,eAAe,MAAM;gBACpDH,OAAOI,GAAG,CAACD,YAAYzB,KAAKW,KAAK,CAAC;gBAClCc,aAAa;YACjB;QACJ;IACJ,EAAE,OAAM;QACJ,yCAAyC;QACzC,KAAK,MAAMpB,OAAOgB,KAAM;YACpB,IAAI;gBACA,MAAM1B,SAASJ,aACX,QAAQ;oBAACoC,OAAOtB;iBAAK,EACrB;oBAAET,UAAU;oBAAS4B,OAAO;wBAAC;wBAAQ;wBAAQ;qBAAS;gBAAC;gBAE3D,MAAMI,QAAQjC,OAAOiC,KAAK,CAAC;gBAC3B,IAAIA,OAAO;oBACPN,OAAOI,GAAG,CAACrB,KAAKuB,KAAK,CAAC,EAAE,CAAC3B,IAAI;gBACjC;YACJ,EAAE,OAAM;YACJ,gBAAgB;YACpB;QACJ;IACJ;IAEA,OAAOqB;AACX;AAEA;;;;;;CAMC,GACD,OAAO,SAASO,0BAA0BR,IAAc;IACpD,MAAMC,SAAS,IAAIC;IACnB,IAAIF,KAAKjB,MAAM,KAAK,GAAG,OAAOkB;IAE9B,IAAI;QACA,MAAM3B,SAASJ,aACX,MAAM;YAAC;YAAM;YAAgB;YAAM8B,KAAKT,IAAI,CAAC;SAAK,EAClD;YAAEhB,UAAU;QAAQ;QAGxB,KAAK,MAAMkC,WAAWnC,OAAOO,KAAK,CAAC,MAAO;YACtC,MAAMF,OAAO8B,QAAQ7B,IAAI;YACzB,IAAI,CAACD,MAAM;YAEX,4CAA4C;YAC5C,0CAA0C;YAC1C,MAAM4B,QAAQ5B,KAAK4B,KAAK,CAAC;YACzB,IAAI,CAACA,OAAO;YAEZ,MAAMvB,MAAMC,SAASsB,KAAK,CAAC,EAAE,EAAE;YAC/B,MAAMG,UAAUH,KAAK,CAAC,EAAE,CAAC3B,IAAI;YAE7B,IAAI,CAACM,OAAOyB,QAAQ,CAAC3B,MAAM;YAE3B,MAAM4B,OAAO,IAAIC,KAAKH;YACtB,IAAI,CAACxB,OAAOC,KAAK,CAACyB,KAAKE,OAAO,KAAK;gBAC/Bb,OAAOI,GAAG,CAACrB,KAAK4B;YACpB;QACJ;IACJ,EAAE,OAAM;IACJ,0BAA0B;IAC9B;IAEA,OAAOX;AACX;AAEA;;;;;;CAMC,GACD,OAAO,SAASc,gBAAgBrC,SAAwB;IACpD,IAAIA,UAAUK,MAAM,KAAK,GAAG,OAAOL;IAEnC,MAAMsB,OAAOtB,UAAUsC,GAAG,CAACC,CAAAA,IAAKA,EAAEjC,GAAG;IACrC,MAAMkC,SAASnB,oBAAoBC;IACnC,MAAMmB,eAAeX,0BAA0BR;IAE/C,KAAK,MAAMoB,QAAQ1C,UAAW;QAC1B0C,KAAKtB,GAAG,GAAGoB,OAAOG,GAAG,CAACD,KAAKpC,GAAG,KAAK;QACnCoC,KAAKE,SAAS,GAAGH,aAAaE,GAAG,CAACD,KAAKpC,GAAG;IAC9C;IAEA,OAAON;AACX;AAEA;;CAEC,GACD,OAAO,SAAS6C,cAAcvC,GAAW;IACrC,IAAI;QACA,MAAMV,SAASJ,aACX,MAAM;YAAC;YAAMoC,OAAOtB;YAAM;YAAM;SAAO,EACvC;YAAET,UAAU;QAAQ;QAGxB,MAAMa,MAAMd,OAAOM,IAAI;QACvB,OAAOQ,IAAIQ,UAAU,CAAC,WAAWR,IAAIE,KAAK,CAAC,KAAKF;IACpD,EAAE,OAAM;QACJ,OAAO;IACX;AACJ"}
+{"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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"}

package/package.json

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

package/src/__tests__/adapters/CopilotAdapter.test.ts

@@ -12,11 +12,16 @@ import type { ProcessInfo } from '../../adapters/AgentAdapter.js';
 import { AgentStatus } from '../../adapters/AgentAdapter.js';
 import { listAgentProcesses, enrichProcesses } from '../../utils/process.js';
 import { generateAgentName } from '../../utils/matching.js';
-
-vi.mock('../../utils/process.js', () => ({
-    listAgentProcesses: vi.fn(),
-    enrichProcesses: vi.fn(),
-}));
+import { AgentRegistry } from '../../utils/AgentRegistry.js';
+
+vi.mock('../../utils/process.js', async (importOriginal) => {
+    const actual = await importOriginal() as typeof import('../../utils/process.js');
+    return {
+        ...actual,
+        listAgentProcesses: vi.fn(),
+        enrichProcesses: vi.fn(),
+    };
+});
 
 vi.mock('../../utils/matching.js', () => ({
     generateAgentName: vi.fn(),
@@ -220,6 +225,55 @@ describe('CopilotAdapter', () => {
             });
         });
 
+        it('suppresses wrapper process-only agents before the session lock exists', async () => {
+            const processes: ProcessInfo[] = [
+                { pid: 86800, command: 'copilot', cwd: '/repo', tty: 'ttys001', ppid: 84174 },
+                { pid: 86810, command: '/custom/install/copilot', cwd: '/repo', tty: 'ttys001', ppid: 86800 },
+            ];
+            mockedListAgentProcesses.mockReturnValue(processes);
+            mockedEnrichProcesses.mockReturnValue(processes);
+
+            const agents = await adapter.detectAgents();
+
+            expect(agents).toHaveLength(1);
+            expect(agents[0]).toMatchObject({
+                pid: 86810,
+                sessionId: 'pid-86810',
+                summary: 'Copilot process running',
+            });
+        });
+
+        it('carries the managed wrapper name to a process-only child before the session lock exists', async () => {
+            const registry = new AgentRegistry(path.join(tmpDir, 'agents.json'));
+            adapter = new CopilotAdapter(registry);
+            (adapter as any).sessionStateDir = sessionStateDir;
+            const processes: ProcessInfo[] = [
+                { pid: 86800, command: 'copilot', cwd: '/repo', tty: 'ttys001', ppid: 84174 },
+                { pid: 86810, command: '/custom/install/copilot', cwd: '/repo', tty: 'ttys001', ppid: 86800 },
+            ];
+            registry.register({
+                name: 'copilot-started',
+                type: 'copilot',
+                pid: 86800,
+                tmuxSession: 'copilot-started',
+                cwd: '/repo',
+                startedAt: '2026-06-13T19:15:16.211Z',
+                sessionId: 'pid-86800',
+                sessionFilePath: '',
+            });
+            mockedListAgentProcesses.mockReturnValue(processes);
+            mockedEnrichProcesses.mockReturnValue(processes);
+
+            const agents = await adapter.detectAgents();
+
+            expect(agents).toHaveLength(1);
+            expect(agents[0]).toMatchObject({
+                name: 'copilot-started',
+                pid: 86810,
+                sessionId: 'pid-86810',
+            });
+        });
+
         it('does not add duplicate process-only agent for wrapper process in the same terminal', async () => {
             const processes: ProcessInfo[] = [
                 { pid: 14095, command: 'copilot', cwd: '/repo', tty: 'ttys001' },
@@ -244,6 +298,44 @@ describe('CopilotAdapter', () => {
             });
         });
 
+        it('carries the managed wrapper name to a lock-backed child process', async () => {
+            const registry = new AgentRegistry(path.join(tmpDir, 'agents.json'));
+            adapter = new CopilotAdapter(registry);
+            (adapter as any).sessionStateDir = sessionStateDir;
+            const processes: ProcessInfo[] = [
+                { pid: 14095, command: 'copilot', cwd: '/repo', tty: 'ttys001', ppid: 84174 },
+                { pid: 14096, command: '/opt/homebrew/Caskroom/copilot-cli/1.0.60/copilot', cwd: '/repo', tty: 'ttys001', ppid: 14095 },
+            ];
+            registry.register({
+                name: 'copilot-started',
+                type: 'copilot',
+                pid: 14095,
+                tmuxSession: 'copilot-started',
+                cwd: '/repo',
+                startedAt: '2026-06-13T19:15:16.211Z',
+                sessionId: 'pid-14095',
+                sessionFilePath: '',
+            });
+            mockedListAgentProcesses.mockReturnValue(processes);
+            mockedEnrichProcesses.mockReturnValue(processes);
+            writeSession('sess-wrapper', {
+                lockPid: 14096,
+                events: [
+                    sessionStart('sess-wrapper', '/repo', '2026-06-09T09:50:00.000Z'),
+                    { type: 'user.message', data: { content: 'hello' }, timestamp: new Date().toISOString() },
+                ],
+            });
+
+            const agents = await adapter.detectAgents();
+
+            expect(agents).toHaveLength(1);
+            expect(agents[0]).toMatchObject({
+                name: 'copilot-started',
+                pid: 14096,
+                sessionId: 'sess-wrapper',
+            });
+        });
+
         it('uses workspace metadata when events are missing', async () => {
             const processes: ProcessInfo[] = [
                 { pid: 300, command: 'copilot', cwd: '/proc-cwd', tty: 'ttys003' },

package/src/__tests__/adapters/GeminiCliAdapter.test.ts

@@ -15,10 +15,14 @@ import { listAgentProcesses, enrichProcesses } from '../../utils/process.js';
 import { matchProcessesToSessions, generateAgentName } from '../../utils/matching.js';
 import * as crypto from 'crypto';
 
-vi.mock('../../utils/process.js', () => ({
-    listAgentProcesses: vi.fn(),
-    enrichProcesses: vi.fn(),
-}));
+vi.mock('../../utils/process.js', async (importOriginal) => {
+    const actual = await importOriginal() as typeof import('../../utils/process.js');
+    return {
+        ...actual,
+        listAgentProcesses: vi.fn(),
+        enrichProcesses: vi.fn(),
+    };
+});
 
 vi.mock('../../utils/matching.js', () => ({
     matchProcessesToSessions: vi.fn(),
@@ -158,6 +162,77 @@ describe('GeminiCliAdapter', () => {
             });
         });
 
+        it('should suppress Gemini wrapper process-only agents before a session file exists', async () => {
+            const wrapperProc: ProcessInfo = {
+                pid: 20452,
+                ppid: 17530,
+                command: '/opt/homebrew/opt/node/bin/node /opt/homebrew/bin/gemini',
+                cwd: '/repo',
+                tty: 'ttys007',
+                startTime: new Date('2026-06-13T08:25:21Z'),
+            };
+            const childProc: ProcessInfo = {
+                pid: 21373,
+                ppid: 20452,
+                command: '/opt/homebrew/Cellar/node/26.0.0/bin/node --max-old-space-size=8192 /opt/homebrew/bin/gemini',
+                cwd: '/repo',
+                tty: 'ttys007',
+                startTime: new Date('2026-06-13T08:25:26Z'),
+            };
+            mockedListAgentProcesses.mockReturnValue([wrapperProc, childProc]);
+
+            const agents = await adapter.detectAgents();
+
+            expect(agents).toHaveLength(1);
+            expect(agents[0]).toMatchObject({
+                pid: 21373,
+                sessionId: 'pid-21373',
+                summary: 'Gemini CLI process running',
+            });
+        });
+
+        it('should carry the managed wrapper name to a process-only child before a session file exists', async () => {
+            const regPath = path.join(tmpHome, 'agents.json');
+            const registry = new AgentRegistry(regPath);
+            const namedAdapter = new GeminiCliAdapter(registry);
+            const wrapperProc: ProcessInfo = {
+                pid: 35792,
+                ppid: 33068,
+                command: '/opt/homebrew/opt/node/bin/node /opt/homebrew/bin/gemini',
+                cwd: '/repo',
+                tty: 'ttys002',
+                startTime: new Date('2026-06-13T19:15:16Z'),
+            };
+            const childProc: ProcessInfo = {
+                pid: 36514,
+                ppid: 35792,
+                command: '/opt/homebrew/Cellar/node/26.0.0/bin/node --max-old-space-size=8192 /opt/homebrew/bin/gemini',
+                cwd: '/repo',
+                tty: 'ttys002',
+                startTime: new Date('2026-06-13T19:15:18Z'),
+            };
+            registry.register({
+                name: 'cli-mqcqj469',
+                type: 'gemini_cli',
+                pid: wrapperProc.pid,
+                tmuxSession: 'cli-mqcqj469',
+                cwd: wrapperProc.cwd,
+                startedAt: '2026-06-13T19:15:16.211Z',
+                sessionId: `pid-${wrapperProc.pid}`,
+                sessionFilePath: '',
+            });
+            mockedListAgentProcesses.mockReturnValue([wrapperProc, childProc]);
+
+            const agents = await namedAdapter.detectAgents();
+
+            expect(agents).toHaveLength(1);
+            expect(agents[0]).toMatchObject({
+                name: 'cli-mqcqj469',
+                pid: childProc.pid,
+                sessionId: `pid-${childProc.pid}`,
+            });
+        });
+
         it('should map a process to its matching session file via projectHash', async () => {
             const cwd = '/repo/project-a';
             const projectHash = hashProjectRoot(cwd);
@@ -433,6 +508,66 @@ describe('GeminiCliAdapter', () => {
 
             expect(agents[0].sessionId).toBe('pid-100');
         });
+
+        it('carries the managed wrapper name to the detected child process', async () => {
+            const wrapperProc: ProcessInfo = {
+                pid: 20339,
+                ppid: 17570,
+                command: '/opt/homebrew/opt/node/bin/node /opt/homebrew/bin/gemini',
+                cwd: '/repo-a',
+                tty: 'ttys002',
+                startTime: new Date('2026-06-13T19:00:53Z'),
+            };
+            const childProc: ProcessInfo = {
+                pid: 21038,
+                ppid: 20339,
+                command: '/opt/homebrew/Cellar/node/26.0.0/bin/node --max-old-space-size=8192 /opt/homebrew/bin/gemini',
+                cwd: '/repo-a',
+                tty: 'ttys002',
+                startTime: new Date('2026-06-13T19:00:57Z'),
+            };
+            const now = new Date().toISOString();
+            sessionFilePath = writeSession(tmpHome, 'cli-2', 'session-2026-06-13T19-00-s-cached', {
+                sessionId: 's-cached',
+                projectHash: hashProjectRoot('/repo-a'),
+                startTime: now,
+                lastUpdated: now,
+                directories: ['/repo-a'],
+                messages: [
+                    { id: 'm1', timestamp: now, type: 'user', content: 'Hello from child process' },
+                ],
+            });
+            registerEntry({
+                name: 'cli-mqcq0mg5',
+                pid: wrapperProc.pid,
+                tmuxSession: 'cli-mqcq0mg5',
+                sessionId: 's-cached',
+                sessionFilePath,
+            });
+            mockedListAgentProcesses.mockReturnValue([wrapperProc, childProc]);
+            mockedMatchProcessesToSessions.mockReturnValue([
+                {
+                    process: childProc,
+                    session: {
+                        sessionId: 's-cached',
+                        filePath: sessionFilePath,
+                        projectDir: path.dirname(sessionFilePath),
+                        birthtimeMs: Date.now(),
+                        resolvedCwd: '/repo-a',
+                    },
+                    deltaMs: 0,
+                },
+            ]);
+
+            const agents = await cachedAdapter.detectAgents();
+
+            expect(agents).toHaveLength(1);
+            expect(agents[0]).toMatchObject({
+                name: 'cli-mqcq0mg5',
+                pid: childProc.pid,
+                sessionId: 's-cached',
+            });
+        });
     });
 
     describe('discoverSessions', () => {

package/src/__tests__/utils/process.test.ts

@@ -10,6 +10,8 @@ import {
     batchGetProcessCwds,
     batchGetProcessStartTimes,
     enrichProcesses,
+    findWrapperProcess,
+    findWrapperProcessPids,
 } from '../../utils/process.js';
 
 vi.mock('child_process', () => ({
@@ -23,26 +25,28 @@ describe('listAgentProcesses', () => {
         mockedExecFileSync.mockReset();
     });
 
-    it('should parse ps aux | grep output and post-filter by executable name', () => {
+    it('should parse ps output and post-filter by executable name', () => {
         mockedExecFileSync.mockReturnValue(
-            'user  78070  1.0  0.5 485636016 245952 s018  S+   11:18PM   1:55.14 claude\n' +
-            'user  55106  0.1  0.4 485620368  72496 s015  S+    9Mar26   8:06.36 claude\n',
+            '78070     1 s018     claude\n' +
+            '55106 55100 s015     claude\n',
         );
 
         const processes = listAgentProcesses('claude');
         expect(processes).toHaveLength(2);
         expect(processes[0].pid).toBe(78070);
+        expect(processes[0].ppid).toBe(1);
         expect(processes[0].command).toBe('claude');
         expect(processes[0].tty).toBe('s018');
         expect(processes[0].cwd).toBe(''); // not populated yet
         expect(processes[1].pid).toBe(55106);
+        expect(processes[1].ppid).toBe(55100);
     });
 
     it('should filter out non-matching executables', () => {
         mockedExecFileSync.mockReturnValue(
-            'user  100  0.0  0.0 0 0 s001  S  1:00PM  0:00 claude\n' +
-            'user  200  0.0  0.0 0 0 s002  S  1:00PM  0:00 claude-helper --pid 100\n' +
-            'user  300  0.0  0.0 0 0 s003  S  1:00PM  0:00 /usr/bin/claude\n',
+            '100 1 s001 claude\n' +
+            '200 1 s002 claude-helper --pid 100\n' +
+            '300 1 s003 /usr/bin/claude\n',
         );
 
         const processes = listAgentProcesses('claude');
@@ -75,7 +79,11 @@ describe('listAgentProcesses', () => {
     it('should accept valid patterns with dashes and underscores', () => {
         mockedExecFileSync.mockReturnValue('');
         listAgentProcesses('claude-code');
-        expect(mockedExecFileSync).toHaveBeenCalled();
+        expect(mockedExecFileSync).toHaveBeenCalledWith(
+            'ps',
+            ['-axo', 'pid=,ppid=,tty=,command='],
+            { encoding: 'utf-8' },
+        );
 
         mockedExecFileSync.mockReset();
         mockedExecFileSync.mockReturnValue('');
@@ -201,3 +209,19 @@ describe('enrichProcesses', () => {
         expect(enriched[0].startTime).toBeUndefined();
     });
 });
+
+describe('wrapper process detection', () => {
+    it('finds the parent wrapper process for a child in the same terminal and cwd', () => {
+        const wrapper = { pid: 100, ppid: 1, command: 'node /bin/gemini', cwd: '/repo', tty: 'ttys001' };
+        const child = { pid: 200, ppid: 100, command: 'node --max-old-space-size=8192 /bin/gemini', cwd: '/repo', tty: 'ttys001' };
+
+        expect(findWrapperProcess([wrapper, child], child)).toBe(wrapper);
+        expect(findWrapperProcessPids([wrapper, child])).toEqual(new Set([100]));
+    });
+
+    it('does not mark a matched child process as its own wrapper', () => {
+        const child = { pid: 200, ppid: 100, command: 'node --max-old-space-size=8192 /bin/gemini', cwd: '/repo', tty: 'ttys001' };
+
+        expect(findWrapperProcessPids([child], [child])).toEqual(new Set());
+    });
+});

package/src/adapters/AgentAdapter.ts

@@ -59,6 +59,9 @@ export interface ProcessInfo {
     /** Process ID */
     pid: number;
 
+    /** Parent process ID, populated by listAgentProcesses when available */
+    ppid?: number;
+
     /** Process command */
     command: string;
 

package/src/adapters/CopilotAdapter.ts

@@ -19,9 +19,10 @@ import type {
     SessionSummary,
 } from './AgentAdapter.js';
 import { AgentStatus } from './AgentAdapter.js';
-import { enrichProcesses, listAgentProcesses } from '../utils/process.js';
+import { enrichProcesses, findWrapperProcess, findWrapperProcessPids, listAgentProcesses } from '../utils/process.js';
 import { generateAgentName } from '../utils/matching.js';
 import { isDirectory, safeReadFile, safeReaddir, safeStat } from '../utils/session.js';
+import { AgentRegistry, type RegistryEntry } from '../utils/AgentRegistry.js';
 
 interface CopilotEventEntry {
     type?: string;
@@ -107,10 +108,12 @@ export class CopilotAdapter implements AgentAdapter {
     ]);
 
     private sessionStateDir: string;
+    private registry: AgentRegistry;
 
-    constructor() {
+    constructor(registry: AgentRegistry = AgentRegistry.default()) {
         const homeDir = process.env.HOME || process.env.USERPROFILE || '';
         this.sessionStateDir = path.join(homeDir, '.copilot', 'session-state');
+        this.registry = registry;
     }
 
     canHandle(processInfo: ProcessInfo): boolean {
@@ -122,6 +125,7 @@ export class CopilotAdapter implements AgentAdapter {
         if (processes.length === 0) return [];
 
         const processByPid = new Map(processes.map((proc) => [proc.pid, proc]));
+        const registryEntriesByPid = new Map(this.registry.list().map((entry) => [entry.pid, entry]));
         const matchedPids = new Set<number>();
         const matchedProcesses: ProcessInfo[] = [];
         const agents: AgentInfo[] = [];
@@ -133,29 +137,36 @@ export class CopilotAdapter implements AgentAdapter {
             const session = this.readSessionDir(lock.sessionDir, lock.sessionId);
             if (!session) continue;
 
-            agents.push(this.mapSessionToAgent(session, proc));
+            const agent = this.mapSessionToAgent(session, proc);
+            this.applyWrapperRegistryName(agent, proc, processes, registryEntriesByPid);
+            agents.push(agent);
             matchedPids.add(proc.pid);
             matchedProcesses.push(proc);
         }
 
+        const wrapperPids = findWrapperProcessPids(processes, matchedProcesses);
         for (const proc of processes) {
-            if (!matchedPids.has(proc.pid) && !this.isDuplicateProcess(proc, matchedProcesses)) {
-                agents.push(this.mapProcessOnlyAgent(proc));
+            if (!matchedPids.has(proc.pid) && !wrapperPids.has(proc.pid)) {
+                const agent = this.mapProcessOnlyAgent(proc);
+                this.applyWrapperRegistryName(agent, proc, processes, registryEntriesByPid);
+                agents.push(agent);
             }
         }
 
         return agents;
     }
 
-    private isDuplicateProcess(proc: ProcessInfo, matchedProcesses: ProcessInfo[]): boolean {
-        return matchedProcesses.some((matched) => {
-            if (proc.pid === matched.pid) return true;
-
-            const sameTty = proc.tty !== '' && proc.tty !== '?' && proc.tty === matched.tty;
-            const sameCwd = proc.cwd !== '' && proc.cwd === matched.cwd;
-
-            return sameTty && (sameCwd || proc.cwd === '' || matched.cwd === '');
-        });
+    private applyWrapperRegistryName(
+        agent: AgentInfo,
+        processInfo: ProcessInfo,
+        processes: ProcessInfo[],
+        registryEntriesByPid: Map<number, RegistryEntry>,
+    ): void {
+        const wrapper = findWrapperProcess(processes, processInfo);
+        const wrapperEntry = wrapper ? registryEntriesByPid.get(wrapper.pid) : undefined;
+        if (wrapperEntry?.type === this.type) {
+            agent.name = wrapperEntry.name;
+        }
     }
 
     getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[] {