@ai-devkit/agent-manager 0.4.0 → 0.6.0

package/dist/utils/process.js

@@ -2,165 +2,211 @@
 /**
  * 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.
  */
+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.listProcesses = listProcesses;
-exports.getProcessCwd = getProcessCwd;
+exports.listAgentProcesses = listAgentProcesses;
+exports.batchGetProcessCwds = batchGetProcessCwds;
+exports.batchGetProcessStartTimes = batchGetProcessStartTimes;
+exports.enrichProcesses = enrichProcesses;
 exports.getProcessTty = getProcessTty;
-exports.isProcessRunning = isProcessRunning;
-exports.getProcessInfo = getProcessInfo;
+const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
 /**
- * List running processes on the system
- *
- * @param options Filtering options
- * @returns Array of process information
+ * List running processes matching an agent executable name.
  *
- * @example
- * ```typescript
- * // List all Claude Code processes
- * const processes = listProcesses({ namePattern: 'claude' });
+ * 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).
  *
- * // 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.
  */
-function listProcesses(options = {}) {
+function listAgentProcesses(namePattern) {
+    // Validate pattern contains only safe characters (alphanumeric, dash, underscore)
+    if (!namePattern || !/^[a-zA-Z0-9_-]+$/.test(namePattern)) {
+        return [];
+    }
     try {
-        // Get all processes with full details
-        // Format: user pid command
-        const psOutput = (0, child_process_1.execSync)('ps aux', { encoding: 'utf-8' });
-        const lines = psOutput.trim().split('\n');
-        // Skip header line
-        const processLines = lines.slice(1);
+        // Use [c]laude trick to avoid matching the grep process itself
+        const escapedPattern = `[${namePattern[0]}]${namePattern.slice(1)}`;
+        const output = (0, child_process_1.execSync)(`ps aux | grep -i '${escapedPattern}'`, { encoding: 'utf-8' });
         const processes = [];
-        for (const line of processLines) {
-            // Parse ps aux output
-            // Format: USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND
+        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 (isNaN(pid))
+            if (Number.isNaN(pid))
                 continue;
             const tty = parts[6];
             const command = parts.slice(10).join(' ');
-            // Apply PID filter
-            if (options.pids && !options.pids.includes(pid)) {
+            // Post-filter: check that the executable basename matches exactly
+            const executable = command.trim().split(/\s+/)[0] || '';
+            const base = path.basename(executable).toLowerCase();
+            if (base !== namePattern.toLowerCase() && base !== `${namePattern.toLowerCase()}.exe`) {
                 continue;
             }
-            // Apply name pattern filter (case-insensitive)
-            if (options.namePattern) {
-                const pattern = options.namePattern.toLowerCase();
-                const commandLower = command.toLowerCase();
-                if (!commandLower.includes(pattern)) {
-                    continue;
-                }
-            }
-            // Get working directory for this process
-            const cwd = getProcessCwd(pid);
-            // Get TTY in short format (remove /dev/ prefix if present)
             const ttyShort = tty.startsWith('/dev/') ? tty.slice(5) : tty;
             processes.push({
                 pid,
                 command,
-                cwd,
+                cwd: '',
                 tty: ttyShort,
             });
         }
         return processes;
     }
-    catch (error) {
-        // If ps command fails, return empty array
-        console.error('Failed to list processes:', error);
+    catch {
         return [];
     }
 }
 /**
- * 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.
  */
-function getProcessCwd(pid) {
+function batchGetProcessCwds(pids) {
+    const result = new Map();
+    if (pids.length === 0)
+        return result;
     try {
-        // Use lsof to get the current working directory
-        // -a: AND the selections, -d cwd: get cwd only, -Fn: output format (file names only)
-        const output = (0, child_process_1.execSync)(`lsof -a -p ${pid} -d cwd -Fn 2>/dev/null`, {
-            encoding: 'utf-8',
-        });
-        // Parse lsof output
-        // Format: p{PID}\nn{path}
-        const lines = output.trim().split('\n');
-        for (const line of lines) {
-            if (line.startsWith('n')) {
-                return line.slice(1); // Remove 'n' prefix
+        const output = (0, child_process_1.execSync)(`lsof -a -d cwd -Fn -p ${pids.join(',')} 2>/dev/null`, { encoding: 'utf-8' });
+        // lsof output format: p{PID}\nn{path}\np{PID}\nn{path}...
+        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 '';
     }
-    catch (error) {
-        // If lsof fails, try alternative method using pwdx (Linux)
-        try {
-            const output = (0, child_process_1.execSync)(`pwdx ${pid} 2>/dev/null`, {
-                encoding: 'utf-8',
-            });
-            // Format: {PID}: {path}
-            const match = output.match(/^\d+:\s*(.+)$/);
-            return match ? match[1].trim() : '';
-        }
-        catch {
-            // Both methods failed
-            return '';
+    catch {
+        // Try per-PID fallback with pwdx (Linux)
+        for (const pid of pids) {
+            try {
+                const output = (0, child_process_1.execSync)(`pwdx ${pid} 2>/dev/null`, { encoding: 'utf-8' });
+                const match = output.match(/^\d+:\s*(.+)$/);
+                if (match) {
+                    result.set(pid, match[1].trim());
+                }
+            }
+            catch {
+                // Skip this PID
+            }
         }
     }
+    return result;
 }
 /**
- * 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.
  */
-function getProcessTty(pid) {
+function batchGetProcessStartTimes(pids) {
+    const result = new Map();
+    if (pids.length === 0)
+        return result;
     try {
-        const output = (0, child_process_1.execSync)(`ps -p ${pid} -o tty=`, {
-            encoding: 'utf-8',
-        });
-        const tty = output.trim();
-        // Remove /dev/ prefix if present
-        return tty.startsWith('/dev/') ? tty.slice(5) : tty;
+        const output = (0, child_process_1.execSync)(`ps -o pid=,lstart= -p ${pids.join(',')}`, { encoding: 'utf-8' });
+        for (const rawLine of output.split('\n')) {
+            const line = rawLine.trim();
+            if (!line)
+                continue;
+            // Format: "  PID  DAY MON DD HH:MM:SS YYYY"
+            // e.g., " 78070 Wed Mar 18 23:18:01 2026"
+            const match = line.match(/^\s*(\d+)\s+(.+)$/);
+            if (!match)
+                continue;
+            const pid = parseInt(match[1], 10);
+            const dateStr = match[2].trim();
+            if (!Number.isFinite(pid))
+                continue;
+            const date = new Date(dateStr);
+            if (!Number.isNaN(date.getTime())) {
+                result.set(pid, date);
+            }
+        }
     }
-    catch (error) {
-        return '?';
+    catch {
+        // Return whatever we have
     }
+    return result;
 }
 /**
- * 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.
  */
-function isProcessRunning(pid) {
-    try {
-        // Send signal 0 to check if process exists
-        // This doesn't actually send a signal, just checks if we can
-        (0, child_process_1.execSync)(`kill -0 ${pid} 2>/dev/null`);
-        return true;
-    }
-    catch {
-        return false;
+function enrichProcesses(processes) {
+    if (processes.length === 0)
+        return processes;
+    const pids = processes.map(p => p.pid);
+    const cwdMap = batchGetProcessCwds(pids);
+    const startTimeMap = batchGetProcessStartTimes(pids);
+    for (const proc of processes) {
+        proc.cwd = cwdMap.get(proc.pid) || '';
+        proc.startTime = startTimeMap.get(proc.pid);
     }
+    return processes;
 }
 /**
- * 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
  */
-function getProcessInfo(pid) {
-    const processes = listProcesses({ pids: [pid] });
-    return processes.length > 0 ? processes[0] : null;
+function getProcessTty(pid) {
+    try {
+        const output = (0, child_process_1.execSync)(`ps -p ${pid} -o tty=`, {
+            encoding: 'utf-8',
+        });
+        const tty = output.trim();
+        return tty.startsWith('/dev/') ? tty.slice(5) : tty;
+    }
+    catch {
+        return '?';
+    }
 }
 //# sourceMappingURL=process.js.map

package/dist/utils/process.js.map

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

package/dist/utils/session.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Session File Utilities
+ *
+ * Shell command wrappers for discovering session files and their birth times.
+ * Uses `stat` to get exact epoch-second birth timestamps without reading file contents.
+ */
+/**
+ * Represents a session file with its birth time metadata.
+ */
+export interface SessionFile {
+    /** Session identifier (filename without .jsonl extension) */
+    sessionId: string;
+    /** Full path to the session file */
+    filePath: string;
+    /** Parent directory of the session file */
+    projectDir: string;
+    /** File creation time in milliseconds since epoch */
+    birthtimeMs: number;
+    /** CWD this session maps to — set by the adapter after calling batchGetSessionFileBirthtimes() */
+    resolvedCwd: string;
+}
+/**
+ * Get birth times for .jsonl session files across multiple directories in a single shell call.
+ *
+ * Combines all directory globs into one `stat` command to avoid per-directory exec overhead.
+ * Returns empty array if no directories have .jsonl files or command fails.
+ * resolvedCwd is left empty — the adapter must set it.
+ */
+export declare function batchGetSessionFileBirthtimes(dirs: string[]): SessionFile[];
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/utils/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IAEpB,kGAAkG;IAClG,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAiB3E"}

package/dist/utils/session.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Session File Utilities
+ *
+ * Shell command wrappers for discovering session files and their birth times.
+ * Uses `stat` to get exact epoch-second birth timestamps without reading file contents.
+ */
+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.batchGetSessionFileBirthtimes = batchGetSessionFileBirthtimes;
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+/**
+ * Get birth times for .jsonl session files across multiple directories in a single shell call.
+ *
+ * Combines all directory globs into one `stat` command to avoid per-directory exec overhead.
+ * Returns empty array if no directories have .jsonl files or command fails.
+ * resolvedCwd is left empty — the adapter must set it.
+ */
+function batchGetSessionFileBirthtimes(dirs) {
+    if (dirs.length === 0)
+        return [];
+    try {
+        const isMacOS = process.platform === 'darwin';
+        const globs = dirs.map((d) => `"${d}"/*.jsonl`).join(' ');
+        // || true prevents non-zero exit when some globs have no .jsonl matches
+        const command = isMacOS
+            ? `stat -f '%B %N' ${globs} 2>/dev/null || true`
+            : `stat --format='%W %n' ${globs} 2>/dev/null || true`;
+        const output = (0, child_process_1.execSync)(command, { encoding: 'utf-8' });
+        return parseStatOutput(output);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Parse stat output lines into SessionFile entries.
+ */
+function parseStatOutput(output) {
+    const results = [];
+    for (const rawLine of output.trim().split('\n')) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        // Format: "<epoch_seconds> <filepath>"
+        const spaceIdx = line.indexOf(' ');
+        if (spaceIdx === -1)
+            continue;
+        const epochStr = line.slice(0, spaceIdx);
+        const filePath = line.slice(spaceIdx + 1).trim();
+        const epochSeconds = parseInt(epochStr, 10);
+        if (!Number.isFinite(epochSeconds) || epochSeconds <= 0)
+            continue;
+        const fileName = path.basename(filePath);
+        if (!fileName.endsWith('.jsonl'))
+            continue;
+        const sessionId = fileName.replace(/\.jsonl$/, '');
+        results.push({
+            sessionId,
+            filePath,
+            projectDir: path.dirname(filePath),
+            birthtimeMs: epochSeconds * 1000,
+            resolvedCwd: '',
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=session.js.map

package/dist/utils/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/utils/session.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCH,sEAiBC;AA/CD,2CAA6B;AAC7B,iDAAyC;AAsBzC;;;;;;GAMG;AACH,SAAgB,6BAA6B,CAAC,IAAc;IACxD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1D,wEAAwE;QACxE,MAAM,OAAO,GAAG,OAAO;YACnB,CAAC,CAAC,mBAAmB,KAAK,sBAAsB;YAChD,CAAC,CAAC,yBAAyB,KAAK,sBAAsB,CAAC;QAE3D,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAExD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,MAAc;IACnC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,uCAAuC;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,SAAS;QAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEjD,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC;YAAE,SAAS;QAElE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,SAAS;QAE3C,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAEnD,OAAO,CAAC,IAAI,CAAC;YACT,SAAS;YACT,QAAQ;YACR,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YAClC,WAAW,EAAE,YAAY,GAAG,IAAI;YAChC,WAAW,EAAE,EAAE;SAClB,CAAC,CAAC;IACP,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-devkit/agent-manager",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Standalone agent detection and management utilities for AI DevKit",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/__tests__/AgentManager.test.ts

@@ -4,7 +4,7 @@
 
 import { describe, it, expect, beforeEach } from '@jest/globals';
 import { AgentManager } from '../AgentManager';
-import type { AgentAdapter, AgentInfo, AgentType } from '../adapters/AgentAdapter';
+import type { AgentAdapter, AgentInfo, AgentType, ConversationMessage } from '../adapters/AgentAdapter';
 import { AgentStatus } from '../adapters/AgentAdapter';
 
 // Mock adapter for testing
@@ -26,6 +26,10 @@ class MockAdapter implements AgentAdapter {
         return true;
     }
 
+    getConversation(): ConversationMessage[] {
+        return [];
+    }
+
     setAgents(agents: AgentInfo[]): void {
         this.mockAgents = agents;
     }
@@ -45,7 +49,6 @@ function createMockAgent(overrides: Partial<AgentInfo> = {}): AgentInfo {
         pid: 12345,
         projectPath: '/test/path',
         sessionId: 'test-session-id',
-        slug: 'test-slug',
         lastActive: new Date(),
         ...overrides,
     };
@@ -130,17 +133,6 @@ describe('AgentManager', () => {
         });
     });
 
-    describe('hasAdapter', () => {
-        it('should return true for registered adapter', () => {
-            manager.registerAdapter(new MockAdapter('claude'));
-            expect(manager.hasAdapter('claude')).toBe(true);
-        });
-
-        it('should return false for non-registered adapter', () => {
-            expect(manager.hasAdapter('claude')).toBe(false);
-        });
-    });
-
     describe('listAgents', () => {
         it('should return empty array when no adapters registered', async () => {
             const agents = await manager.listAgents();
@@ -222,20 +214,6 @@ describe('AgentManager', () => {
         });
     });
 
-    describe('getAdapterCount', () => {
-        it('should return 0 when no adapters registered', () => {
-            expect(manager.getAdapterCount()).toBe(0);
-        });
-
-        it('should return correct count', () => {
-            manager.registerAdapter(new MockAdapter('claude'));
-            expect(manager.getAdapterCount()).toBe(1);
-
-            manager.registerAdapter(new MockAdapter('gemini_cli'));
-            expect(manager.getAdapterCount()).toBe(2);
-        });
-    });
-
     describe('clear', () => {
         it('should remove all adapters', () => {
             manager.registerAdapter(new MockAdapter('claude'));