@ai-devkit/agent-manager 0.26.4 → 0.28.0

package/README.md

@@ -24,19 +24,27 @@ ai-devkit agent send "run the tests and report back" --id <agent-name> --wait
 npm test 2>&1 | ai-devkit agent send --id <agent-name> --stdin
 ```
 
-Claude Code can also be registered as a durable print-mode agent. Registration
+Claude Code can also be registered as a durable agent. Registration
 does not launch Claude; each send starts one synchronous process and later sends
 resume the same Claude session:
 
 ```bash
-ai-devkit agent start --type claude --mode print --name reviewer --cwd /path/to/project
+ai-devkit agent start --type claude --mode durable --name reviewer --cwd /path/to/project
 ai-devkit agent send "review the current diff" --id reviewer
 ```
 
-Print mode inherits Claude Code's settings, permissions, hooks, MCP servers, and
+Durable mode inherits Claude Code's settings, permissions, hooks, MCP servers, and
 tool side effects for that working directory. AI DevKit adds no permission bypass
 or automatic retry, and prompts are delivered over stdin rather than command-line
-arguments. `--timeout` is not supported for print agents in this first release.
+arguments. `--timeout` is not supported for durable agents in this first release.
+
+Durable durable-agent state is stored in `~/.ai-devkit/agents.db`. This feature was
+not released with JSON persistence, so there is no legacy import or dual-write.
+
+For direct `DurableAgentRepository` consumers, `dbPath` selects the SQLite database. The
+`lockTimeoutMs`, `incompleteLockGraceMs`, and `mutationLockStaleMs` options are
+deprecated, accepted, and ignored because SQLite transactions replace the
+filesystem lock machinery.
 
 Use this package directly only when building custom tooling around AI DevKit's agent detection and control surface.
 

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;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"}
+{"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
  * 
@@ -158,6 +165,8 @@ import { captureProcessSnapshot, filterByProcessNames } from './utils/process.js
             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';
@@ -172,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 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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"}
+{"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":"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"}

package/dist/__tests__/AgentManager.test.js

@@ -587,6 +587,60 @@ describe('AgentManager', ()=>{
             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({
@@ -676,6 +730,64 @@ describe('AgentManager', ()=>{
             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', ()=>{
         it('should remove all adapters', ()=>{
             manager.registerAdapter(new MockAdapter('claude'));