@ai-devkit/agent-manager 0.26.3 → 0.27.0

package/dist/AgentManager.d.ts

@@ -15,6 +15,10 @@ export interface ListAgentsOptions {
      */
     sortBy?: AgentSortKey;
 }
+export declare class AgentNotRunningError extends Error {
+    agentName: string;
+    constructor(agentName: string);
+}
 /**
  * Agent Manager Class
  *
@@ -93,6 +97,7 @@ export declare class AgentManager {
      */
     listAgents(options?: ListAgentsOptions): Promise<AgentInfo[]>;
     private toRegistryEntry;
+    togglePin(agentName: string): boolean;
     /**
      * List historical sessions across every registered adapter.
      *

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,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;IAqEnE,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,qBAAa,oBAAqB,SAAQ,KAAK;IACxB,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAIvC;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;IA0EnE,OAAO,CAAC,eAAe;IAcvB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAWrC;;;;;;;;;;;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

@@ -6,6 +6,13 @@
  */ import { sortAgents } from './utils/sortAgents.js';
 import { AgentRegistry } from './utils/AgentRegistry.js';
 import { captureProcessSnapshot, filterByProcessNames } from './utils/process.js';
+export class AgentNotRunningError extends Error {
+    agentName;
+    constructor(agentName){
+        super(`Agent "${agentName}" is no longer running.`), this.agentName = agentName;
+        this.name = 'AgentNotRunningError';
+    }
+}
 /**
  * Agent Manager Class
  * 
@@ -146,17 +153,20 @@ import { captureProcessSnapshot, filterByProcessNames } from './utils/process.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;
+                agent.pinned = entry.pinned;
+                if (entry.pinned && entry.updatedAt) agent.lastActive = new Date(entry.updatedAt);
             }
         }
         const sortKey = options?.sortBy ?? 'status';
@@ -171,9 +181,20 @@ import { captureProcessSnapshot, filterByProcessNames } from './utils/process.js
             cwd: agent.projectPath,
             startedAt: existing?.startedAt ?? new Date().toISOString(),
             sessionId: agent.sessionId,
-            sessionFilePath: agent.sessionFilePath ?? ''
+            sessionFilePath: agent.sessionFilePath ?? '',
+            pinned: existing?.pinned ?? agent.pinned ?? false
         };
     }
+    togglePin(agentName) {
+        const entry = this.registry.lookup(agentName);
+        if (!entry || !this.registry.isAlive(entry)) {
+            if (entry) this.registry.prune();
+            throw new AgentNotRunningError(agentName);
+        }
+        const pinned = this.registry.togglePin(entry.type, entry.pid);
+        if (pinned === null) throw new AgentNotRunningError(agentName);
+        return pinned;
+    }
     /**
      * List historical sessions across every registered adapter.
      *

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    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 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","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","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\nexport class AgentNotRunningError extends Error {\n    constructor(public agentName: string) {\n        super(`Agent \"${agentName}\" is no longer running.`);\n        this.name = 'AgentNotRunningError';\n    }\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                agent.pinned = entry.pinned;\n                if (entry.pinned && entry.updatedAt) agent.lastActive = new Date(entry.updatedAt);\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            pinned: existing?.pinned ?? agent.pinned ?? false,\n        };\n    }\n\n    togglePin(agentName: string): boolean {\n        const entry = this.registry.lookup(agentName);\n        if (!entry || !this.registry.isAlive(entry)) {\n            if (entry) this.registry.prune();\n            throw new AgentNotRunningError(agentName);\n        }\n        const pinned = this.registry.togglePin(entry.type, entry.pid);\n        if (pinned === null) throw new AgentNotRunningError(agentName);\n        return pinned;\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","AgentNotRunningError","Error","agentName","name","AgentManager","adapters","Map","registry","default","captureSnapshot","registerAdapter","adapter","adapterKey","type","has","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","pinned","updatedAt","lastActive","Date","sortKey","sortBy","existing","tmuxSession","cwd","projectPath","startedAt","toISOString","sessionId","sessionFilePath","togglePin","lookup","isAlive","prune","listSessions","opts","targetAdapters","filter","undefined","merged","sort","a","b","getTime","getAdapterCount","size","clear","resolveAgent","input","registryEntry","registryAgent","find","lowerInput","toLowerCase","exactMatch","matches","includes"],"mappings":"AAAA;;;;;CAKC,GASD,SAASA,UAAU,QAA2B,wBAAwB;AACtE,SAASC,aAAa,QAA4B,2BAA2B;AAC7E,SAASC,sBAAsB,EAAEC,oBAAoB,QAAQ,qBAAqB;AAYlF,OAAO,MAAMC,6BAA6BC;;IACtC,YAAY,AAAOC,SAAiB,CAAE;QAClC,KAAK,CAAC,CAAC,OAAO,EAAEA,UAAU,uBAAuB,CAAC,QADnCA,YAAAA;QAEf,IAAI,CAACC,IAAI,GAAG;IAChB;AACJ;AAEA;;;;;;;;;;;;;;CAcC,GACD,OAAO,MAAMC;;IACDC,WAAsC,IAAIC,MAAM;IAChDC,SAAwB;IAEhC,YACIA,WAA0BV,cAAcW,OAAO,EAAE,EACjD,AAAiBC,kBAA0CX,sBAAsB,CACnF;aADmBW,kBAAAA;QAEjB,IAAI,CAACF,QAAQ,GAAGA;IACpB;IAEA;;;;;;;;;;KAUC,GACDG,gBAAgBC,OAAqB,EAAQ;QACzC,MAAMC,aAAaD,QAAQE,IAAI;QAE/B,IAAI,IAAI,CAACR,QAAQ,CAACS,GAAG,CAACF,aAAa;YAC/B,MAAM,IAAIX,MAAM,CAAC,kBAAkB,EAAEW,WAAW,uBAAuB,CAAC;QAC5E;QAEA,IAAI,CAACP,QAAQ,CAACU,GAAG,CAACH,YAAYD;IAClC;IAEA;;;;;KAKC,GACDK,kBAAkBH,IAAY,EAAW;QACrC,OAAO,IAAI,CAACR,QAAQ,CAACY,MAAM,CAACJ;IAChC;IAEA;;;;KAIC,GACDK,cAA8B;QAC1B,OAAOC,MAAMC,IAAI,CAAC,IAAI,CAACf,QAAQ,CAACgB,MAAM;IAC1C;IAEA;;;;;KAKC,GACDC,WAAWT,IAAY,EAA4B;QAC/C,OAAO,IAAI,CAACR,QAAQ,CAACkB,GAAG,CAACV;IAC7B;IAEA;;;;;KAKC,GACDW,WAAWX,IAAY,EAAW;QAC9B,OAAO,IAAI,CAACR,QAAQ,CAACS,GAAG,CAACD;IAC7B;IAEA;;;;;;;;;;;;;;;;KAgBC,GACD,MAAMY,WAAWC,OAA2B,EAAwB;QAChE,MAAMC,YAAyB,EAAE;QACjC,MAAMC,SAAgD,EAAE;QAExD,MAAMvB,WAAWc,MAAMC,IAAI,CAAC,IAAI,CAACf,QAAQ,CAACgB,MAAM;QAChD,MAAMQ,eAAeV,MAAMC,IAAI,CAAC,IAAIU,IAAIzB,SAAS0B,OAAO,CACpD,CAACpB,UAAYA,QAAQkB,YAAY,GAAG;mBAAIlB,QAAQkB,YAAY;aAAC,GAAG,EAAE;QAEtE,IAAIG,YAAoC,EAAE;QAC1C,IAAIH,aAAaI,MAAM,GAAG,GAAG;YACzB,IAAI;gBACAD,YAAY,MAAM,IAAI,CAACvB,eAAe,CAACoB;YAC3C,EAAE,OAAM;gBACJG,YAAY,EAAE;YAClB;QACJ;QAEA,wFAAwF;QACxF,MAAME,kBAAkB7B,SAAS8B,GAAG,CAAC,OAAOxB;YACxC,IAAI;gBACA,MAAMyB,SAASzB,QAAQkB,YAAY,GAC7B,MAAMlB,QAAQ0B,YAAY,CAAC;oBACzBL,WAAWjC,qBAAqBiC,WAAWrB,QAAQkB,YAAY;gBACnE,KACE,MAAMlB,QAAQ0B,YAAY;gBAChC,OAAO;oBAAExB,MAAMF,QAAQE,IAAI;oBAAEuB;oBAAQE,OAAO;gBAAK;YACrD,EAAE,OAAOA,OAAO;gBACZ,mEAAmE;gBACnE,MAAMC,MAAMD,iBAAiBrC,QAAQqC,QAAQ,IAAIrC,MAAMuC,OAAOF;gBAC9DV,OAAOa,IAAI,CAAC;oBAAE5B,MAAMF,QAAQE,IAAI;oBAAEyB,OAAOC;gBAAI;gBAC7C,OAAO;oBAAE1B,MAAMF,QAAQE,IAAI;oBAAEuB,QAAQ,EAAE;oBAAEE,OAAOC;gBAAI;YACxD;QACJ;QAEA,MAAMG,UAAU,MAAMC,QAAQC,GAAG,CAACV;QAElC,mCAAmC;QACnC,KAAK,MAAMW,UAAUH,QAAS;YAC1B,IAAIG,OAAOP,KAAK,KAAK,MAAM;gBACvBX,UAAUc,IAAI,IAAII,OAAOT,MAAM;YACnC;QACJ;QAEA,mEAAmE;QACnE,IAAIR,OAAOK,MAAM,GAAG,GAAG;YACnBa,QAAQR,KAAK,CAAC,CAAC,SAAS,EAAEV,OAAOK,MAAM,CAAC,mBAAmB,CAAC;YAC5DL,OAAOmB,OAAO,CAAC,CAAC,EAAElC,IAAI,EAAEyB,KAAK,EAAE;gBAC3BQ,QAAQR,KAAK,CAAC,CAAC,IAAI,EAAEzB,KAAK,EAAE,EAAEyB,MAAMU,OAAO,EAAE;YACjD;QACJ;QAEA,MAAMC,cAAc,CAACpC,MAAcqC,MAAwB,GAAGrC,KAAK,CAAC,EAAEqC,KAAK;QAC3E,MAAMC,wBAAwB,IAAI7C,IAC9B,IAAI,CAACC,QAAQ,CAAC6C,IAAI,GAAGjB,GAAG,CAAC,CAACkB,QAAU;gBAACJ,YAAYI,MAAMxC,IAAI,EAAEwC,MAAMH,GAAG;gBAAGG;aAAM;QAEnF,MAAMC,UAAU3B,UAAUQ,GAAG,CAAC,CAACoB,QAC3B,IAAI,CAACC,eAAe,CAACD,OAAOJ,sBAAsB5B,GAAG,CAAC0B,YAAYM,MAAM1C,IAAI,EAAE0C,MAAML,GAAG;QAE3F,IAAII,QAAQrB,MAAM,GAAG,GAAG,IAAI,CAAC1B,QAAQ,CAACkD,aAAa,CAACH;QACpD,IAAI,CAAC/C,QAAQ,CAACmD,UAAU;QAExB,KAAK,MAAMH,SAAS5B,UAAW;YAC3B,MAAM0B,QAAQF,sBAAsB5B,GAAG,CAAC0B,YAAYM,MAAM1C,IAAI,EAAE0C,MAAML,GAAG;YACzE,IAAIG,OAAO;gBACPE,MAAMpD,IAAI,GAAGkD,MAAMlD,IAAI;gBACvBoD,MAAMI,MAAM,GAAGN,MAAMM,MAAM;gBAC3B,IAAIN,MAAMM,MAAM,IAAIN,MAAMO,SAAS,EAAEL,MAAMM,UAAU,GAAG,IAAIC,KAAKT,MAAMO,SAAS;YACpF;QACJ;QAEA,MAAMG,UAAwBrC,SAASsC,UAAU;QACjD,OAAOpE,WAAW+B,WAAWoC;IACjC;IAEQP,gBAAgBD,KAAgB,EAAEU,QAAwB,EAAiB;QAC/E,OAAO;YACH9D,MAAM8D,UAAU9D,QAAQoD,MAAMpD,IAAI;YAClCU,MAAM0C,MAAM1C,IAAI;YAChBqC,KAAKK,MAAML,GAAG;YACdgB,aAAaD,UAAUC,eAAe;YACtCC,KAAKZ,MAAMa,WAAW;YACtBC,WAAWJ,UAAUI,aAAa,IAAIP,OAAOQ,WAAW;YACxDC,WAAWhB,MAAMgB,SAAS;YAC1BC,iBAAiBjB,MAAMiB,eAAe,IAAI;YAC1Cb,QAAQM,UAAUN,UAAUJ,MAAMI,MAAM,IAAI;QAChD;IACJ;IAEAc,UAAUvE,SAAiB,EAAW;QAClC,MAAMmD,QAAQ,IAAI,CAAC9C,QAAQ,CAACmE,MAAM,CAACxE;QACnC,IAAI,CAACmD,SAAS,CAAC,IAAI,CAAC9C,QAAQ,CAACoE,OAAO,CAACtB,QAAQ;YACzC,IAAIA,OAAO,IAAI,CAAC9C,QAAQ,CAACqE,KAAK;YAC9B,MAAM,IAAI5E,qBAAqBE;QACnC;QACA,MAAMyD,SAAS,IAAI,CAACpD,QAAQ,CAACkE,SAAS,CAACpB,MAAMxC,IAAI,EAAEwC,MAAMH,GAAG;QAC5D,IAAIS,WAAW,MAAM,MAAM,IAAI3D,qBAAqBE;QACpD,OAAOyD;IACX;IAEA;;;;;;;;;;;KAWC,GACD,MAAMkB,aAAaC,IAA0B,EAA6B;QACtE,MAAMC,iBAAiB5D,MAAMC,IAAI,CAAC,IAAI,CAACf,QAAQ,CAACgB,MAAM,IAAI2D,MAAM,CAC5D,CAACrE,UAAYmE,MAAMjE,SAASoE,aAAatE,QAAQE,IAAI,KAAKiE,KAAKjE,IAAI;QAGvE,MAAMe,SAAgD,EAAE;QAExD,MAAMc,UAAU,MAAMC,QAAQC,GAAG,CAC7BmC,eAAe5C,GAAG,CAAC,OAAOxB;YACtB,IAAI;gBACA,OAAO,MAAMA,QAAQkE,YAAY,CAACC;YACtC,EAAE,OAAOxC,OAAO;gBACZ,MAAMC,MAAMD,iBAAiBrC,QAAQqC,QAAQ,IAAIrC,MAAMuC,OAAOF;gBAC9DV,OAAOa,IAAI,CAAC;oBAAE5B,MAAMF,QAAQE,IAAI;oBAAEyB,OAAOC;gBAAI;gBAC7C,OAAO,EAAE;YACb;QACJ;QAGJ,IAAIX,OAAOK,MAAM,GAAG,GAAG;YACnBa,QAAQR,KAAK,CAAC,CAAC,SAAS,EAAEV,OAAOK,MAAM,CAAC,oCAAoC,CAAC;YAC7E,KAAK,MAAM,EAAEpB,IAAI,EAAEyB,KAAK,EAAE,IAAIV,OAAQ;gBAClCkB,QAAQR,KAAK,CAAC,CAAC,IAAI,EAAEzB,KAAK,EAAE,EAAEyB,MAAMU,OAAO,EAAE;YACjD;QACJ;QAEA,MAAMkC,SAA2B,EAAE;QACnC,KAAK,MAAM9B,QAAQV,QAAS;YACxBwC,OAAOzC,IAAI,IAAIW;QACnB;QAEA8B,OAAOC,IAAI,CAAC,CAACC,GAAGC,IAAMA,EAAExB,UAAU,CAACyB,OAAO,KAAKF,EAAEvB,UAAU,CAACyB,OAAO;QACnE,OAAOJ;IACX;IAGA;;;;KAIC,GACDK,kBAA0B;QACtB,OAAO,IAAI,CAAClF,QAAQ,CAACmF,IAAI;IAC7B;IAEA;;KAEC,GACDC,QAAc;QACV,IAAI,CAACpF,QAAQ,CAACoF,KAAK;IACvB;IAEA;;;;;;KAMC,GACDC,aAAaC,KAAa,EAAEvD,MAAmB,EAAkC;QAC7E,IAAI,CAACuD,SAASvD,OAAOH,MAAM,KAAK,GAAG,OAAO;QAE1C,qFAAqF;QACrF,MAAM2D,gBAAgB,IAAI,CAACrF,QAAQ,CAACmE,MAAM,CAACiB;QAC3C,IAAIC,eAAe;YACf,MAAMC,gBAAgBzD,OAAO0D,IAAI,CAAC,CAACV,IAAMA,EAAElC,GAAG,KAAK0C,cAAc1C,GAAG;YACpE,IAAI2C,eAAe,OAAOA;QAC9B;QAEA,MAAME,aAAaJ,MAAMK,WAAW;QAEpC,oCAAoC;QACpC,MAAMC,aAAa7D,OAAO0D,IAAI,CAACV,CAAAA,IAAKA,EAAEjF,IAAI,CAAC6F,WAAW,OAAOD;QAC7D,IAAIE,YAAY,OAAOA;QAEvB,wCAAwC;QACxC,MAAMC,UAAU9D,OAAO4C,MAAM,CAACI,CAAAA,IAAKA,EAAEjF,IAAI,CAAC6F,WAAW,GAAGG,QAAQ,CAACJ;QAEjE,IAAIG,QAAQjE,MAAM,KAAK,GAAG,OAAOiE,OAAO,CAAC,EAAE;QAC3C,IAAIA,QAAQjE,MAAM,GAAG,GAAG,OAAOiE;QAE/B,OAAO;IACX;AACJ"}

package/dist/__tests__/AgentManager.test.js

@@ -376,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
@@ -458,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',
@@ -529,13 +570,222 @@ 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('exposes a persisted pin and preserves it across a changed poll refresh', async ()=>{
+            const adapter = new MockAdapter('claude', [
+                createMockAgent({
+                    name: 'pinned',
+                    pid: process.pid,
+                    sessionId: 'before'
+                })
+            ]);
+            scopedManager.registerAdapter(adapter);
+            await scopedManager.listAgents();
+            registry.togglePin('claude', process.pid);
+            adapter.setAgents([
+                createMockAgent({
+                    name: 'pinned',
+                    pid: process.pid,
+                    sessionId: 'after'
+                })
+            ]);
+            const agents = await scopedManager.listAgents();
+            expect(agents[0].pinned).toBe(true);
+            expect(registry.lookup('pinned')).toMatchObject({
+                sessionId: 'after',
+                pinned: true
+            });
+        });
+        it('uses registry updated_at as lastActive for pinned recency ordering', async ()=>{
+            const adapter = new MockAdapter('claude', [
+                createMockAgent({
+                    name: 'recently-pinned',
+                    pid: process.pid,
+                    lastActive: new Date('2026-01-01T00:00:00.000Z')
+                })
+            ]);
+            scopedManager.registerAdapter(adapter);
+            await scopedManager.listAgents();
+            nowMs += 60_000;
+            scopedManager.togglePin('recently-pinned');
+            const agents = await scopedManager.listAgents();
+            expect(agents[0].pinned).toBe(true);
+            expect(agents[0].lastActive.toISOString()).toBe('2026-08-14T10:01:00.000Z');
+        });
+        it('preserves adapter lastActive for unpinned agents', async ()=>{
+            scopedManager.registerAdapter(new MockAdapter('claude', [
+                createMockAgent({
+                    name: 'unpinned',
+                    pid: process.pid,
+                    lastActive: new Date('2026-01-01T00:00:00.000Z')
+                })
+            ]));
+            await scopedManager.listAgents();
+            const agents = await scopedManager.listAgents();
+            expect(agents[0].pinned).toBe(false);
+            expect(agents[0].lastActive.toISOString()).toBe('2026-01-01T00:00:00.000Z');
+        });
+        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('togglePin', ()=>{
+        it('resolves the agent name to its process identity and toggles the pin', ()=>{
+            const registry = new AgentRegistry(path.join(tmpDir, 'toggle.json'));
+            const scopedManager = new AgentManager(registry);
+            registry.register({
+                name: 'renamed-agent',
+                type: 'claude',
+                pid: process.pid,
+                tmuxSession: '',
+                cwd: '/tmp',
+                startedAt: '2026-08-16T00:00:00.000Z',
+                sessionId: 'session',
+                sessionFilePath: '',
+                pinned: false
+            });
+            expect(scopedManager.togglePin('renamed-agent')).toBe(true);
+            expect(registry.lookup('renamed-agent')?.pinned).toBe(true);
+        });
+        it('reports when the agent is no longer running', ()=>{
+            expect(()=>manager.togglePin('missing')).toThrow(/no longer running/i);
+        });
+        it('rejects a dead process and prunes its row', ()=>{
+            const registry = new AgentRegistry(path.join(tmpDir, 'dead-toggle.json'));
+            const scopedManager = new AgentManager(registry);
+            registry.register({
+                name: 'dead',
+                type: 'claude',
+                pid: 999999,
+                tmuxSession: '',
+                cwd: '/tmp',
+                startedAt: '2026-08-16T00:00:00.000Z',
+                sessionId: 'session',
+                sessionFilePath: '',
+                pinned: false
+            });
+            expect(()=>scopedManager.togglePin('dead')).toThrow(/no longer running/i);
+            expect(registry.lookup('dead')).toBeNull();
+        });
+        it('surfaces a clear readonly mutation error', ()=>{
+            const regPath = path.join(tmpDir, 'readonly-toggle.json');
+            const writable = new AgentRegistry(regPath);
+            writable.register({
+                name: 'readonly-agent',
+                type: 'claude',
+                pid: process.pid,
+                tmuxSession: '',
+                cwd: '/tmp',
+                startedAt: '2026-08-16T00:00:00.000Z',
+                sessionId: 'session',
+                sessionFilePath: '',
+                pinned: false
+            });
+            const readonlyManager = new AgentManager(new AgentRegistry(regPath, {
+                readonly: true
+            }));
+            expect(()=>readonlyManager.togglePin('readonly-agent')).toThrow('Agent registry is readonly; cannot toggle pin.');
         });
     });
     describe('clear', ()=>{