@ai-devkit/agent-manager 0.26.2 → 0.26.4

package/dist/AgentManager.d.ts

@@ -4,9 +4,10 @@
  * Orchestrates agent detection across multiple adapter types.
  * Manages adapter registration and aggregates results from all adapters.
  */
-import type { AgentAdapter, AgentInfo, SessionSummary, ListSessionsOptions } from './adapters/AgentAdapter.js';
+import type { AgentAdapter, AgentInfo, SessionSummary, ListSessionsOptions, ProcessInfo } from './adapters/AgentAdapter.js';
 import { type AgentSortKey } from './utils/sortAgents.js';
 import { AgentRegistry } from './utils/AgentRegistry.js';
+type ProcessSnapshotCapture = (namePatterns: readonly string[]) => Promise<ProcessInfo[]>;
 export interface ListAgentsOptions {
     /**
      * Sort key for the returned list. Defaults to `status`, which orders
@@ -30,9 +31,10 @@ export interface ListAgentsOptions {
  * ```
  */
 export declare class AgentManager {
+    private readonly captureSnapshot;
     private adapters;
     private registry;
-    constructor(registry?: AgentRegistry);
+    constructor(registry?: AgentRegistry, captureSnapshot?: ProcessSnapshotCapture);
     /**
      * Register an adapter for a specific agent type
      *
@@ -123,4 +125,5 @@ export declare class AgentManager {
      */
     resolveAgent(input: string, agents: AgentInfo[]): AgentInfo | AgentInfo[] | null;
 }
+export {};
 //# sourceMappingURL=AgentManager.d.ts.map

package/dist/AgentManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentManager.d.ts","sourceRoot":"","sources":["../src/AgentManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,YAAY,EACZ,SAAS,EACT,cAAc,EACd,mBAAmB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAE7E,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,QAAQ,GAAE,aAAuC;IAI7D;;;;;;;;;;OAUG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAU5C;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;OAIG;IACH,WAAW,IAAI,YAAY,EAAE;IAI7B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIlD;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoDnE,OAAO,CAAC,eAAe;IAavB;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoCzE;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,GAAG,IAAI;CAwBnF"}
+{"version":3,"file":"AgentManager.d.ts","sourceRoot":"","sources":["../src/AgentManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,YAAY,EACZ,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,WAAW,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAG7E,KAAK,sBAAsB,GAAG,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAE1F,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IAMjB,OAAO,CAAC,QAAQ,CAAC,eAAe;IALpC,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,QAAQ,CAAgB;gBAG5B,QAAQ,GAAE,aAAuC,EAChC,eAAe,GAAE,sBAA+C;IAKrF;;;;;;;;;;OAUG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAU5C;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;OAIG;IACH,WAAW,IAAI,YAAY,EAAE;IAI7B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIlD;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAwEnE,OAAO,CAAC,eAAe;IAavB;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoCzE;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,GAAG,IAAI;CAwBnF"}

package/dist/AgentManager.js

@@ -5,6 +5,7 @@
  * Manages adapter registration and aggregates results from all adapters.
  */ import { sortAgents } from './utils/sortAgents.js';
 import { AgentRegistry } from './utils/AgentRegistry.js';
+import { captureProcessSnapshot, filterByProcessNames } from './utils/process.js';
 /**
  * Agent Manager Class
  * 
@@ -20,9 +21,11 @@ import { AgentRegistry } from './utils/AgentRegistry.js';
  * console.log(`Found ${agents.length} agents`);
  * ```
  */ export class AgentManager {
+    captureSnapshot;
     adapters = new Map();
     registry;
-    constructor(registry = AgentRegistry.default()){
+    constructor(registry = AgentRegistry.default(), captureSnapshot = captureProcessSnapshot){
+        this.captureSnapshot = captureSnapshot;
         this.registry = registry;
     }
     /**
@@ -92,10 +95,24 @@ import { AgentRegistry } from './utils/AgentRegistry.js';
      */ async listAgents(options) {
         const allAgents = [];
         const errors = [];
-        // 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 = [];
+        if (processNames.length > 0) {
             try {
-                const agents = await adapter.detectAgents();
+                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 = adapter.processNames ? await adapter.detectAgents({
+                    processes: filterByProcessNames(processes, adapter.processNames)
+                }) : await adapter.detectAgents();
                 return {
                     type: adapter.type,
                     agents,
@@ -129,15 +146,16 @@ import { AgentRegistry } from './utils/AgentRegistry.js';
                 console.error(`  - ${type}: ${error.message}`);
             });
         }
-        const preExistingByPid = new Map(this.registry.list().map((e)=>[
-                e.pid,
-                e
+        const identityKey = (type, pid)=>`${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)));
+        const entries = allAgents.map((agent)=>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/dist/AgentManager.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/AgentManager.ts"],"sourcesContent":["/**\n * Agent Manager\n * \n * Orchestrates agent detection across multiple adapter types.\n * Manages adapter registration and aggregates results from all adapters.\n */\n\nimport type {\n    AgentAdapter,\n    AgentInfo,\n    SessionSummary,\n    ListSessionsOptions,\n} from './adapters/AgentAdapter.js';\nimport { sortAgents, type AgentSortKey } from './utils/sortAgents.js';\nimport { AgentRegistry, type RegistryEntry } from './utils/AgentRegistry.js';\n\nexport interface ListAgentsOptions {\n    /**\n     * Sort key for the returned list. Defaults to `status`, which orders\n     * waiting → running → idle → unknown, then by name for stability.\n     */\n    sortBy?: AgentSortKey;\n}\n\n/**\n * Agent Manager Class\n * \n * Central manager for detecting AI agents across different types.\n * Supports multiple adapters (Claude Code, Gemini CLI, etc.)\n * \n * @example\n * ```typescript\n * const manager = new AgentManager();\n * manager.registerAdapter(new ClaudeCodeAdapter());\n * \n * const agents = await manager.listAgents();\n * console.log(`Found ${agents.length} agents`);\n * ```\n */\nexport class AgentManager {\n    private adapters: Map<string, AgentAdapter> = new Map();\n    private registry: AgentRegistry;\n\n    constructor(registry: AgentRegistry = AgentRegistry.default()) {\n        this.registry = registry;\n    }\n\n    /**\n     * Register an adapter for a specific agent type\n     * \n     * @param adapter Agent adapter to register\n     * @throws Error if an adapter for this type is already registered\n     * \n     * @example\n     * ```typescript\n     * manager.registerAdapter(new ClaudeCodeAdapter());\n     * ```\n     */\n    registerAdapter(adapter: AgentAdapter): void {\n        const adapterKey = adapter.type;\n\n        if (this.adapters.has(adapterKey)) {\n            throw new Error(`Adapter for type \"${adapterKey}\" is already registered`);\n        }\n\n        this.adapters.set(adapterKey, adapter);\n    }\n\n    /**\n     * Unregister an adapter by type\n     * \n     * @param type Agent type to unregister\n     * @returns True if adapter was removed, false if not found\n     */\n    unregisterAdapter(type: string): boolean {\n        return this.adapters.delete(type);\n    }\n\n    /**\n     * Get all registered adapters\n     * \n     * @returns Array of registered adapters\n     */\n    getAdapters(): AgentAdapter[] {\n        return Array.from(this.adapters.values());\n    }\n\n    /**\n     * Get a registered adapter by type\n     *\n     * @param type Agent type to look up\n     * @returns The adapter, or undefined if not registered\n     */\n    getAdapter(type: string): AgentAdapter | undefined {\n        return this.adapters.get(type);\n    }\n\n    /**\n     * Check if an adapter is registered for a specific type\n     *\n     * @param type Agent type to check\n     * @returns True if adapter is registered\n     */\n    hasAdapter(type: string): boolean {\n        return this.adapters.has(type);\n    }\n\n    /**\n     * List all running AI agents detected by registered adapters\n     * \n     * Queries all registered adapters and aggregates results.\n     * Handles errors gracefully - if one adapter fails, others still run.\n     * \n     * @returns Array of detected agents from all adapters\n     * \n     * @example\n     * ```typescript\n     * const agents = await manager.listAgents();\n     * \n     * agents.forEach(agent => {\n     *   console.log(`${agent.name}: ${agent.status}`);\n     * });\n     * ```\n     */\n    async listAgents(options?: ListAgentsOptions): Promise<AgentInfo[]> {\n        const allAgents: AgentInfo[] = [];\n        const errors: Array<{ type: string; error: Error }> = [];\n\n        // Query all adapters in parallel\n        const adapterPromises = Array.from(this.adapters.values()).map(async (adapter) => {\n            try {\n                const agents = await adapter.detectAgents();\n                return { type: adapter.type, agents, error: null };\n            } catch (error) {\n                // Capture error but don't throw - allow other adapters to continue\n                const err = error instanceof Error ? error : new Error(String(error));\n                errors.push({ type: adapter.type, error: err });\n                return { type: adapter.type, agents: [], error: err };\n            }\n        });\n\n        const results = await Promise.all(adapterPromises);\n\n        // Aggregate all successful results\n        for (const result of results) {\n            if (result.error === null) {\n                allAgents.push(...result.agents);\n            }\n        }\n\n        // Log errors if any (but don't throw - partial results are useful)\n        if (errors.length > 0) {\n            console.error(`Warning: ${errors.length} adapter(s) failed:`);\n            errors.forEach(({ type, error }) => {\n                console.error(`  - ${type}: ${error.message}`);\n            });\n        }\n\n        const preExistingByPid = new Map(this.registry.list().map((e) => [e.pid, e]));\n        const entries = allAgents.map((agent) =>\n            this.toRegistryEntry(agent, preExistingByPid.get(agent.pid)),\n        );\n        if (entries.length > 0) this.registry.registerBatch(entries);\n        this.registry.prune();\n\n        for (const agent of allAgents) {\n            const entry = preExistingByPid.get(agent.pid);\n            if (entry) {\n                agent.name = entry.name;\n            }\n        }\n\n        const sortKey: AgentSortKey = options?.sortBy ?? 'status';\n        return sortAgents(allAgents, sortKey);\n    }\n\n    private toRegistryEntry(agent: AgentInfo, existing?: RegistryEntry): RegistryEntry {\n        return {\n            name: existing?.name ?? agent.name,\n            type: agent.type,\n            pid: agent.pid,\n            tmuxSession: existing?.tmuxSession ?? '',\n            cwd: agent.projectPath,\n            startedAt: existing?.startedAt ?? new Date().toISOString(),\n            sessionId: agent.sessionId,\n            sessionFilePath: agent.sessionFilePath ?? '',\n        };\n    }\n\n    /**\n     * List historical sessions across every registered adapter.\n     *\n     * When `opts.type` is set, adapters whose `type` doesn't match are\n     * skipped without being called. The remaining adapters' results are\n     * merged and sorted by `lastActive` descending. Adapter failures are\n     * caught (one-line stderr warning) so one broken adapter doesn't hide\n     * the others.\n     *\n     * @param opts Filter options computed by the CLI; the manager passes\n     *   them through to each adapter unchanged.\n     */\n    async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {\n        const targetAdapters = Array.from(this.adapters.values()).filter(\n            (adapter) => opts?.type === undefined || adapter.type === opts.type,\n        );\n\n        const errors: Array<{ type: string; error: Error }> = [];\n\n        const results = await Promise.all(\n            targetAdapters.map(async (adapter) => {\n                try {\n                    return await adapter.listSessions(opts);\n                } catch (error) {\n                    const err = error instanceof Error ? error : new Error(String(error));\n                    errors.push({ type: adapter.type, error: err });\n                    return [];\n                }\n            }),\n        );\n\n        if (errors.length > 0) {\n            console.error(`Warning: ${errors.length} adapter(s) failed to list sessions:`);\n            for (const { type, error } of errors) {\n                console.error(`  - ${type}: ${error.message}`);\n            }\n        }\n\n        const merged: SessionSummary[] = [];\n        for (const list of results) {\n            merged.push(...list);\n        }\n\n        merged.sort((a, b) => b.lastActive.getTime() - a.lastActive.getTime());\n        return merged;\n    }\n\n\n    /**\n     * Get count of registered adapters\n     * \n     * @returns Number of registered adapters\n     */\n    getAdapterCount(): number {\n        return this.adapters.size;\n    }\n\n    /**\n     * Clear all registered adapters\n     */\n    clear(): void {\n        this.adapters.clear();\n    }\n\n    /**\n     * Resolve an agent by name (exact or partial match)\n     * \n     * @param input Name to search for\n     * @param agents List of agents to search within\n     * @returns Matched agent (unique), array of agents (ambiguous), or null (none)\n     */\n    resolveAgent(input: string, agents: AgentInfo[]): AgentInfo | AgentInfo[] | null {\n        if (!input || agents.length === 0) return null;\n\n        // Registry-first: if name is in registry and its PID is in the agent list, return it\n        const registryEntry = this.registry.lookup(input);\n        if (registryEntry) {\n            const registryAgent = agents.find((a) => a.pid === registryEntry.pid);\n            if (registryAgent) return registryAgent;\n        }\n\n        const lowerInput = input.toLowerCase();\n\n        // 1. Exact match (case-insensitive)\n        const exactMatch = agents.find(a => a.name.toLowerCase() === lowerInput);\n        if (exactMatch) return exactMatch;\n\n        // 2. Partial match (prefix or contains)\n        const matches = agents.filter(a => a.name.toLowerCase().includes(lowerInput));\n\n        if (matches.length === 1) return matches[0];\n        if (matches.length > 1) return matches;\n\n        return null;\n    }\n}\n"],"names":["sortAgents","AgentRegistry","AgentManager","adapters","Map","registry","default","registerAdapter","adapter","adapterKey","type","has","Error","set","unregisterAdapter","delete","getAdapters","Array","from","values","getAdapter","get","hasAdapter","listAgents","options","allAgents","errors","adapterPromises","map","agents","detectAgents","error","err","String","push","results","Promise","all","result","length","console","forEach","message","preExistingByPid","list","e","pid","entries","agent","toRegistryEntry","registerBatch","prune","entry","name","sortKey","sortBy","existing","tmuxSession","cwd","projectPath","startedAt","Date","toISOString","sessionId","sessionFilePath","listSessions","opts","targetAdapters","filter","undefined","merged","sort","a","b","lastActive","getTime","getAdapterCount","size","clear","resolveAgent","input","registryEntry","lookup","registryAgent","find","lowerInput","toLowerCase","exactMatch","matches","includes"],"mappings":"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"}
+{"version":3,"sources":["../src/AgentManager.ts"],"sourcesContent":["/**\n * Agent Manager\n * \n * Orchestrates agent detection across multiple adapter types.\n * Manages adapter registration and aggregates results from all adapters.\n */\n\nimport type {\n    AgentAdapter,\n    AgentInfo,\n    SessionSummary,\n    ListSessionsOptions,\n    ProcessInfo,\n} from './adapters/AgentAdapter.js';\nimport { sortAgents, type AgentSortKey } from './utils/sortAgents.js';\nimport { AgentRegistry, type RegistryEntry } from './utils/AgentRegistry.js';\nimport { captureProcessSnapshot, filterByProcessNames } from './utils/process.js';\n\ntype ProcessSnapshotCapture = (namePatterns: readonly string[]) => Promise<ProcessInfo[]>;\n\nexport interface ListAgentsOptions {\n    /**\n     * Sort key for the returned list. Defaults to `status`, which orders\n     * waiting → running → idle → unknown, then by name for stability.\n     */\n    sortBy?: AgentSortKey;\n}\n\n/**\n * Agent Manager Class\n * \n * Central manager for detecting AI agents across different types.\n * Supports multiple adapters (Claude Code, Gemini CLI, etc.)\n * \n * @example\n * ```typescript\n * const manager = new AgentManager();\n * manager.registerAdapter(new ClaudeCodeAdapter());\n * \n * const agents = await manager.listAgents();\n * console.log(`Found ${agents.length} agents`);\n * ```\n */\nexport class AgentManager {\n    private adapters: Map<string, AgentAdapter> = new Map();\n    private registry: AgentRegistry;\n\n    constructor(\n        registry: AgentRegistry = AgentRegistry.default(),\n        private readonly captureSnapshot: ProcessSnapshotCapture = captureProcessSnapshot,\n    ) {\n        this.registry = registry;\n    }\n\n    /**\n     * Register an adapter for a specific agent type\n     * \n     * @param adapter Agent adapter to register\n     * @throws Error if an adapter for this type is already registered\n     * \n     * @example\n     * ```typescript\n     * manager.registerAdapter(new ClaudeCodeAdapter());\n     * ```\n     */\n    registerAdapter(adapter: AgentAdapter): void {\n        const adapterKey = adapter.type;\n\n        if (this.adapters.has(adapterKey)) {\n            throw new Error(`Adapter for type \"${adapterKey}\" is already registered`);\n        }\n\n        this.adapters.set(adapterKey, adapter);\n    }\n\n    /**\n     * Unregister an adapter by type\n     * \n     * @param type Agent type to unregister\n     * @returns True if adapter was removed, false if not found\n     */\n    unregisterAdapter(type: string): boolean {\n        return this.adapters.delete(type);\n    }\n\n    /**\n     * Get all registered adapters\n     * \n     * @returns Array of registered adapters\n     */\n    getAdapters(): AgentAdapter[] {\n        return Array.from(this.adapters.values());\n    }\n\n    /**\n     * Get a registered adapter by type\n     *\n     * @param type Agent type to look up\n     * @returns The adapter, or undefined if not registered\n     */\n    getAdapter(type: string): AgentAdapter | undefined {\n        return this.adapters.get(type);\n    }\n\n    /**\n     * Check if an adapter is registered for a specific type\n     *\n     * @param type Agent type to check\n     * @returns True if adapter is registered\n     */\n    hasAdapter(type: string): boolean {\n        return this.adapters.has(type);\n    }\n\n    /**\n     * List all running AI agents detected by registered adapters\n     * \n     * Queries all registered adapters and aggregates results.\n     * Handles errors gracefully - if one adapter fails, others still run.\n     * \n     * @returns Array of detected agents from all adapters\n     * \n     * @example\n     * ```typescript\n     * const agents = await manager.listAgents();\n     * \n     * agents.forEach(agent => {\n     *   console.log(`${agent.name}: ${agent.status}`);\n     * });\n     * ```\n     */\n    async listAgents(options?: ListAgentsOptions): Promise<AgentInfo[]> {\n        const allAgents: AgentInfo[] = [];\n        const errors: Array<{ type: string; error: Error }> = [];\n\n        const adapters = Array.from(this.adapters.values());\n        const processNames = Array.from(new Set(adapters.flatMap(\n            (adapter) => adapter.processNames ? [...adapter.processNames] : [],\n        )));\n        let processes: readonly ProcessInfo[] = [];\n        if (processNames.length > 0) {\n            try {\n                processes = await this.captureSnapshot(processNames);\n            } catch {\n                processes = [];\n            }\n        }\n\n        // Query all adapters in parallel using executable-scoped slices of the shared snapshot.\n        const adapterPromises = adapters.map(async (adapter) => {\n            try {\n                const agents = adapter.processNames\n                    ? await adapter.detectAgents({\n                        processes: filterByProcessNames(processes, adapter.processNames),\n                    })\n                    : await adapter.detectAgents();\n                return { type: adapter.type, agents, error: null };\n            } catch (error) {\n                // Capture error but don't throw - allow other adapters to continue\n                const err = error instanceof Error ? error : new Error(String(error));\n                errors.push({ type: adapter.type, error: err });\n                return { type: adapter.type, agents: [], error: err };\n            }\n        });\n\n        const results = await Promise.all(adapterPromises);\n\n        // Aggregate all successful results\n        for (const result of results) {\n            if (result.error === null) {\n                allAgents.push(...result.agents);\n            }\n        }\n\n        // Log errors if any (but don't throw - partial results are useful)\n        if (errors.length > 0) {\n            console.error(`Warning: ${errors.length} adapter(s) failed:`);\n            errors.forEach(({ type, error }) => {\n                console.error(`  - ${type}: ${error.message}`);\n            });\n        }\n\n        const identityKey = (type: string, pid: number): string => `${type}:${pid}`;\n        const preExistingByIdentity = new Map(\n            this.registry.list().map((entry) => [identityKey(entry.type, entry.pid), entry]),\n        );\n        const entries = allAgents.map((agent) =>\n            this.toRegistryEntry(agent, preExistingByIdentity.get(identityKey(agent.type, agent.pid))),\n        );\n        if (entries.length > 0) this.registry.registerBatch(entries);\n        this.registry.pruneIfDue();\n\n        for (const agent of allAgents) {\n            const entry = preExistingByIdentity.get(identityKey(agent.type, agent.pid));\n            if (entry) {\n                agent.name = entry.name;\n            }\n        }\n\n        const sortKey: AgentSortKey = options?.sortBy ?? 'status';\n        return sortAgents(allAgents, sortKey);\n    }\n\n    private toRegistryEntry(agent: AgentInfo, existing?: RegistryEntry): RegistryEntry {\n        return {\n            name: existing?.name ?? agent.name,\n            type: agent.type,\n            pid: agent.pid,\n            tmuxSession: existing?.tmuxSession ?? '',\n            cwd: agent.projectPath,\n            startedAt: existing?.startedAt ?? new Date().toISOString(),\n            sessionId: agent.sessionId,\n            sessionFilePath: agent.sessionFilePath ?? '',\n        };\n    }\n\n    /**\n     * List historical sessions across every registered adapter.\n     *\n     * When `opts.type` is set, adapters whose `type` doesn't match are\n     * skipped without being called. The remaining adapters' results are\n     * merged and sorted by `lastActive` descending. Adapter failures are\n     * caught (one-line stderr warning) so one broken adapter doesn't hide\n     * the others.\n     *\n     * @param opts Filter options computed by the CLI; the manager passes\n     *   them through to each adapter unchanged.\n     */\n    async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {\n        const targetAdapters = Array.from(this.adapters.values()).filter(\n            (adapter) => opts?.type === undefined || adapter.type === opts.type,\n        );\n\n        const errors: Array<{ type: string; error: Error }> = [];\n\n        const results = await Promise.all(\n            targetAdapters.map(async (adapter) => {\n                try {\n                    return await adapter.listSessions(opts);\n                } catch (error) {\n                    const err = error instanceof Error ? error : new Error(String(error));\n                    errors.push({ type: adapter.type, error: err });\n                    return [];\n                }\n            }),\n        );\n\n        if (errors.length > 0) {\n            console.error(`Warning: ${errors.length} adapter(s) failed to list sessions:`);\n            for (const { type, error } of errors) {\n                console.error(`  - ${type}: ${error.message}`);\n            }\n        }\n\n        const merged: SessionSummary[] = [];\n        for (const list of results) {\n            merged.push(...list);\n        }\n\n        merged.sort((a, b) => b.lastActive.getTime() - a.lastActive.getTime());\n        return merged;\n    }\n\n\n    /**\n     * Get count of registered adapters\n     * \n     * @returns Number of registered adapters\n     */\n    getAdapterCount(): number {\n        return this.adapters.size;\n    }\n\n    /**\n     * Clear all registered adapters\n     */\n    clear(): void {\n        this.adapters.clear();\n    }\n\n    /**\n     * Resolve an agent by name (exact or partial match)\n     * \n     * @param input Name to search for\n     * @param agents List of agents to search within\n     * @returns Matched agent (unique), array of agents (ambiguous), or null (none)\n     */\n    resolveAgent(input: string, agents: AgentInfo[]): AgentInfo | AgentInfo[] | null {\n        if (!input || agents.length === 0) return null;\n\n        // Registry-first: if name is in registry and its PID is in the agent list, return it\n        const registryEntry = this.registry.lookup(input);\n        if (registryEntry) {\n            const registryAgent = agents.find((a) => a.pid === registryEntry.pid);\n            if (registryAgent) return registryAgent;\n        }\n\n        const lowerInput = input.toLowerCase();\n\n        // 1. Exact match (case-insensitive)\n        const exactMatch = agents.find(a => a.name.toLowerCase() === lowerInput);\n        if (exactMatch) return exactMatch;\n\n        // 2. Partial match (prefix or contains)\n        const matches = agents.filter(a => a.name.toLowerCase().includes(lowerInput));\n\n        if (matches.length === 1) return matches[0];\n        if (matches.length > 1) return matches;\n\n        return null;\n    }\n}\n"],"names":["sortAgents","AgentRegistry","captureProcessSnapshot","filterByProcessNames","AgentManager","adapters","Map","registry","default","captureSnapshot","registerAdapter","adapter","adapterKey","type","has","Error","set","unregisterAdapter","delete","getAdapters","Array","from","values","getAdapter","get","hasAdapter","listAgents","options","allAgents","errors","processNames","Set","flatMap","processes","length","adapterPromises","map","agents","detectAgents","error","err","String","push","results","Promise","all","result","console","forEach","message","identityKey","pid","preExistingByIdentity","list","entry","entries","agent","toRegistryEntry","registerBatch","pruneIfDue","name","sortKey","sortBy","existing","tmuxSession","cwd","projectPath","startedAt","Date","toISOString","sessionId","sessionFilePath","listSessions","opts","targetAdapters","filter","undefined","merged","sort","a","b","lastActive","getTime","getAdapterCount","size","clear","resolveAgent","input","registryEntry","lookup","registryAgent","find","lowerInput","toLowerCase","exactMatch","matches","includes"],"mappings":"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"}

package/dist/__tests__/AgentManager.test.js

@@ -134,6 +134,153 @@ describe('AgentManager', ()=>{
         });
     });
     describe('listAgents', ()=>{
+        it('shares one process capture while giving each adapter only its declared executables', async ()=>{
+            const processes = [
+                {
+                    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, processNames)=>({
+                    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);
+            snapshotManager.registerAdapter(pi);
+            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 = [
+                {
+                    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, processNames)=>({
+                    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);
+            snapshotManager.registerAdapter(codex);
+            snapshotManager.registerAdapter(pi);
+            snapshotManager.registerAdapter(claude);
+            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([]);
@@ -229,13 +376,23 @@ describe('AgentManager', ()=>{
         let regPath;
         let registry;
         let scopedManager;
+        let nowMs;
+        let databaseOperations;
         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
@@ -311,6 +468,37 @@ describe('AgentManager', ()=>{
             expect(registry.list()[0].tmuxSession).toBe('merry');
             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',
@@ -382,13 +570,110 @@ describe('AgentManager', ()=>{
                 '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);
         });
     });
     describe('clear', ()=>{