@ai-devkit/agent-manager 0.36.0 → 0.38.0

package/dist/AgentManager.d.ts

@@ -4,11 +4,11 @@
  * Orchestrates agent detection across multiple adapter types.
  * Manages adapter registration and aggregates results from all adapters.
  */
-import type { AgentAdapter, AgentInfo, SessionSummary, ListSessionsOptions, ProcessInfo } from "./adapters/AgentAdapter.js";
+import type { AgentAdapter, AgentInfo, SessionSummary, ListSessionsOptions } from "./adapters/AgentAdapter.js";
 import { type AgentSortKey } from "./utils/sortAgents.js";
 import { AgentRegistry, type AgentRuntimeProvider } from "./utils/AgentRegistry.js";
+import { type ProcessSnapshotCapture } from "./utils/process.js";
 import { type HerdrAgentPane } from "./runtime/herdr/HerdrAgentDiscovery.js";
-type ProcessSnapshotCapture = (namePatterns: readonly string[]) => Promise<ProcessInfo[]>;
 export interface ListAgentsOptions {
     /**
      * Sort key for the returned list. Defaults to `status`, which orders
@@ -21,10 +21,6 @@ export interface AgentManagerOptions {
     fetchHerdrAgentPanes?: () => Promise<readonly HerdrAgentPane[]>;
     onRuntimeDiscoveryError?: (error: unknown) => void;
 }
-export declare class AgentNotRunningError extends Error {
-    agentName: string;
-    constructor(agentName: string);
-}
 /**
  * Agent Manager Class
  *
@@ -103,6 +99,12 @@ export declare class AgentManager {
      * ```
      */
     listAgents(options?: ListAgentsOptions): Promise<AgentInfo[]>;
+    /**
+     * Only processes some adapter would actually handle are worth enriching
+     * with cwd/start time. Broad matchers such as "node" otherwise pull in
+     * every Node process on the machine.
+     */
+    private isCandidateProcess;
     private resolveHerdrPanes;
     private resolveRuntimeProvider;
     private toRegistryEntry;
@@ -120,7 +122,7 @@ export declare class AgentManager {
      *   them through to each adapter unchanged.
      */
     listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
-    /** Resolve an exact historical session ID across the selected providers. */
+    /** Resolve an exact historical session ID across the selected harnesses. */
     findSessionsById(sessionId: string, opts?: Pick<ListSessionsOptions, "type">): Promise<SessionSummary[]>;
     /**
      * Get count of registered adapters
@@ -141,5 +143,4 @@ 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,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,WAAW,EACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EACL,aAAa,EAEb,KAAK,oBAAoB,EAE1B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,wCAAwC,CAAC;AAEhD,KAAK,sBAAsB,GAAG,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAE1F,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EACZ,oBAAoB,GACpB,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACjE,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAChE,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC1B,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAIrC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,QAAQ,CAAgB;gBAG9B,QAAQ,GAAE,aAAuC,EAChC,eAAe,GAAE,sBAA+C,EAChE,OAAO,GAAE,mBAAwB;IAKpD;;;;;;;;;;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;YAiFrD,iBAAiB;YAYjB,sBAAsB;IAKpC,OAAO,CAAC,eAAe;IAmCvB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAWrC;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAmCzE,4EAA4E;IACtE,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,GACvC,OAAO,CAAC,cAAc,EAAE,CAAC;IA8B5B;;;;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;CAwBjF"}
+{"version":3,"file":"AgentManager.d.ts","sourceRoot":"","sources":["../src/AgentManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EACL,aAAa,EAEb,KAAK,oBAAoB,EAE1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,wCAAwC,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EACZ,oBAAoB,GACpB,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACjE,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAChE,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AASD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,QAAQ,CAAgB;gBAG9B,QAAQ,GAAE,aAAuC,EAChC,eAAe,GAAE,sBAA+C,EAChE,OAAO,GAAE,mBAAwB;IAKpD;;;;;;;;;;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;IAmFnE;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;YAYZ,iBAAiB;YAYjB,sBAAsB;IAKpC,OAAO,CAAC,eAAe;IAmCvB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAWrC;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAmCzE,4EAA4E;IACtE,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,GACvC,OAAO,CAAC,cAAc,EAAE,CAAC;IA8B5B;;;;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;CAwBjF"}

package/dist/AgentManager.js

@@ -7,13 +7,13 @@
 import { AgentRegistry, parseTmuxRuntimeRef } from "./utils/AgentRegistry.js";
 import { captureProcessSnapshot, filterByProcessNames } from "./utils/process.js";
 import { findMatchingHerdrPane, fetchHerdrAgentPanes, herdrPaneToRuntimeRef } from "./runtime/herdr/HerdrAgentDiscovery.js";
-export class AgentNotRunningError extends Error {
+let AgentNotRunningError = class AgentNotRunningError extends Error {
     agentName;
     constructor(agentName){
         super(`Agent "${agentName}" is no longer running.`), this.agentName = agentName;
         this.name = "AgentNotRunningError";
     }
-}
+};
 /**
  * Agent Manager Class
  *
@@ -112,7 +112,9 @@ export class AgentNotRunningError extends Error {
         let processes = [];
         if (processNames.length > 0) {
             try {
-                processes = await this.captureSnapshot(processNames);
+                processes = await this.captureSnapshot(processNames, {
+                    isCandidate: (process)=>this.isCandidateProcess(adapters, process)
+                });
             } catch  {
                 processes = [];
             }
@@ -176,6 +178,23 @@ export class AgentNotRunningError extends Error {
         const sortKey = options?.sortBy ?? "status";
         return sortAgents(allAgents, sortKey);
     }
+    /**
+   * Only processes some adapter would actually handle are worth enriching
+   * with cwd/start time. Broad matchers such as "node" otherwise pull in
+   * every Node process on the machine.
+   */ isCandidateProcess(adapters, process) {
+        return adapters.some((adapter)=>{
+            if (!adapter.processNames) return false;
+            if (filterByProcessNames([
+                process
+            ], adapter.processNames).length === 0) return false;
+            try {
+                return adapter.canHandle(process);
+            } catch  {
+                return false;
+            }
+        });
+    }
     async resolveHerdrPanes() {
         const runtimeProvider = await this.resolveRuntimeProvider();
         if (runtimeProvider !== "herdr") return [];
@@ -266,7 +285,7 @@ export class AgentNotRunningError extends Error {
         merged.sort((a, b)=>b.lastActive.getTime() - a.lastActive.getTime());
         return merged;
     }
-    /** Resolve an exact historical session ID across the selected providers. */ async findSessionsById(sessionId, opts) {
+    /** Resolve an exact historical session ID across the selected harnesses. */ async findSessionsById(sessionId, opts) {
         const targetAdapters = Array.from(this.adapters.values()).filter((adapter)=>opts?.type === undefined || adapter.type === opts.type);
         const errors = [];
         const results = await Promise.all(targetAdapters.map(async (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 {\n  AgentRegistry,\n  parseTmuxRuntimeRef,\n  type AgentRuntimeProvider,\n  type RegistryEntry,\n} from \"./utils/AgentRegistry.js\";\nimport { captureProcessSnapshot, filterByProcessNames } from \"./utils/process.js\";\nimport {\n  findMatchingHerdrPane,\n  fetchHerdrAgentPanes,\n  herdrPaneToRuntimeRef,\n  type HerdrAgentPane,\n} from \"./runtime/herdr/HerdrAgentDiscovery.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 interface AgentManagerOptions {\n  runtimeProvider?:\n    | AgentRuntimeProvider\n    | (() => AgentRuntimeProvider | Promise<AgentRuntimeProvider>);\n  fetchHerdrAgentPanes?: () => Promise<readonly HerdrAgentPane[]>;\n  onRuntimeDiscoveryError?: (error: unknown) => void;\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    private readonly options: AgentManagerOptions = {},\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(\n      new Set(\n        adapters.flatMap((adapter) => (adapter.processNames ? [...adapter.processNames] : [])),\n      ),\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 herdrPanes = allAgents.length > 0 ? await this.resolveHerdrPanes() : [];\n    const entries = allAgents.map((agent) =>\n      this.toRegistryEntry(\n        agent,\n        preExistingByIdentity.get(identityKey(agent.type, agent.pid)),\n        herdrPanes,\n      ),\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 async resolveHerdrPanes(): Promise<readonly HerdrAgentPane[]> {\n    const runtimeProvider = await this.resolveRuntimeProvider();\n    if (runtimeProvider !== \"herdr\") return [];\n\n    try {\n      return await (this.options.fetchHerdrAgentPanes ?? fetchHerdrAgentPanes)();\n    } catch (error) {\n      this.options.onRuntimeDiscoveryError?.(error);\n      return [];\n    }\n  }\n\n  private async resolveRuntimeProvider(): Promise<AgentRuntimeProvider | undefined> {\n    const runtimeProvider = this.options.runtimeProvider;\n    return typeof runtimeProvider === \"function\" ? await runtimeProvider() : runtimeProvider;\n  }\n\n  private toRegistryEntry(\n    agent: AgentInfo,\n    existing?: RegistryEntry,\n    herdrPanes: readonly HerdrAgentPane[] = [],\n  ): RegistryEntry {\n    const name = existing?.name ?? agent.name;\n    const existingHasAuthoritativeRuntimeRef =\n      existing?.runtime === \"herdr\" || Boolean(parseTmuxRuntimeRef(existing?.runtimeRef));\n    const baseEntry: RegistryEntry = {\n      name,\n      type: agent.type,\n      pid: agent.pid,\n      runtime: existing?.runtime ?? \"tmux\",\n      runtimeRef: existing?.runtimeRef ?? null,\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    if (!existingHasAuthoritativeRuntimeRef) {\n      const herdrPane = findMatchingHerdrPane(agent, herdrPanes);\n      if (herdrPane) {\n        return {\n          ...baseEntry,\n          runtime: \"herdr\",\n          runtimeRef: herdrPaneToRuntimeRef(herdrPane, name),\n        };\n      }\n    }\n\n    return baseEntry;\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  /** Resolve an exact historical session ID across the selected providers. */\n  async findSessionsById(\n    sessionId: string,\n    opts?: Pick<ListSessionsOptions, \"type\">,\n  ): Promise<SessionSummary[]> {\n    const targetAdapters = Array.from(this.adapters.values()).filter(\n      (adapter) => opts?.type === undefined || adapter.type === opts.type,\n    );\n    const errors: Array<{ type: string; error: Error }> = [];\n\n    const results = await Promise.all(\n      targetAdapters.map(async (adapter) => {\n        try {\n          if (adapter.findSessionsById) return await adapter.findSessionsById(sessionId);\n          const sessions = await adapter.listSessions(opts);\n          return sessions.filter((session) => session.sessionId === sessionId);\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 find session by ID:`);\n      for (const { type, error } of errors) {\n        console.error(`  - ${type}: ${error.message}`);\n      }\n    }\n\n    return results.flat();\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","parseTmuxRuntimeRef","captureProcessSnapshot","filterByProcessNames","findMatchingHerdrPane","fetchHerdrAgentPanes","herdrPaneToRuntimeRef","AgentNotRunningError","Error","agentName","name","AgentManager","adapters","Map","registry","default","captureSnapshot","options","registerAdapter","adapter","adapterKey","type","has","set","unregisterAdapter","delete","getAdapters","Array","from","values","getAdapter","get","hasAdapter","listAgents","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","herdrPanes","resolveHerdrPanes","entries","agent","toRegistryEntry","registerBatch","pruneIfDue","pinned","updatedAt","lastActive","Date","sortKey","sortBy","runtimeProvider","resolveRuntimeProvider","onRuntimeDiscoveryError","existing","existingHasAuthoritativeRuntimeRef","runtime","Boolean","runtimeRef","baseEntry","cwd","projectPath","startedAt","toISOString","sessionId","sessionFilePath","herdrPane","togglePin","lookup","isAlive","prune","listSessions","opts","targetAdapters","filter","undefined","merged","sort","a","b","getTime","findSessionsById","sessions","session","flat","getAdapterCount","size","clear","resolveAgent","input","registryEntry","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 {\n  AgentRegistry,\n  parseTmuxRuntimeRef,\n  type AgentRuntimeProvider,\n  type RegistryEntry,\n} from \"./utils/AgentRegistry.js\";\nimport {\n  captureProcessSnapshot,\n  filterByProcessNames,\n  type ProcessSnapshotCapture,\n} from \"./utils/process.js\";\nimport {\n  findMatchingHerdrPane,\n  fetchHerdrAgentPanes,\n  herdrPaneToRuntimeRef,\n  type HerdrAgentPane,\n} from \"./runtime/herdr/HerdrAgentDiscovery.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\nexport interface AgentManagerOptions {\n  runtimeProvider?:\n    | AgentRuntimeProvider\n    | (() => AgentRuntimeProvider | Promise<AgentRuntimeProvider>);\n  fetchHerdrAgentPanes?: () => Promise<readonly HerdrAgentPane[]>;\n  onRuntimeDiscoveryError?: (error: unknown) => void;\n}\n\nclass 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    private readonly options: AgentManagerOptions = {},\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(\n      new Set(\n        adapters.flatMap((adapter) => (adapter.processNames ? [...adapter.processNames] : [])),\n      ),\n    );\n    let processes: readonly ProcessInfo[] = [];\n    if (processNames.length > 0) {\n      try {\n        processes = await this.captureSnapshot(processNames, {\n          isCandidate: (process) => this.isCandidateProcess(adapters, process),\n        });\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 herdrPanes = allAgents.length > 0 ? await this.resolveHerdrPanes() : [];\n    const entries = allAgents.map((agent) =>\n      this.toRegistryEntry(\n        agent,\n        preExistingByIdentity.get(identityKey(agent.type, agent.pid)),\n        herdrPanes,\n      ),\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  /**\n   * Only processes some adapter would actually handle are worth enriching\n   * with cwd/start time. Broad matchers such as \"node\" otherwise pull in\n   * every Node process on the machine.\n   */\n  private isCandidateProcess(adapters: readonly AgentAdapter[], process: ProcessInfo): boolean {\n    return adapters.some((adapter) => {\n      if (!adapter.processNames) return false;\n      if (filterByProcessNames([process], adapter.processNames).length === 0) return false;\n      try {\n        return adapter.canHandle(process);\n      } catch {\n        return false;\n      }\n    });\n  }\n\n  private async resolveHerdrPanes(): Promise<readonly HerdrAgentPane[]> {\n    const runtimeProvider = await this.resolveRuntimeProvider();\n    if (runtimeProvider !== \"herdr\") return [];\n\n    try {\n      return await (this.options.fetchHerdrAgentPanes ?? fetchHerdrAgentPanes)();\n    } catch (error) {\n      this.options.onRuntimeDiscoveryError?.(error);\n      return [];\n    }\n  }\n\n  private async resolveRuntimeProvider(): Promise<AgentRuntimeProvider | undefined> {\n    const runtimeProvider = this.options.runtimeProvider;\n    return typeof runtimeProvider === \"function\" ? await runtimeProvider() : runtimeProvider;\n  }\n\n  private toRegistryEntry(\n    agent: AgentInfo,\n    existing?: RegistryEntry,\n    herdrPanes: readonly HerdrAgentPane[] = [],\n  ): RegistryEntry {\n    const name = existing?.name ?? agent.name;\n    const existingHasAuthoritativeRuntimeRef =\n      existing?.runtime === \"herdr\" || Boolean(parseTmuxRuntimeRef(existing?.runtimeRef));\n    const baseEntry: RegistryEntry = {\n      name,\n      type: agent.type,\n      pid: agent.pid,\n      runtime: existing?.runtime ?? \"tmux\",\n      runtimeRef: existing?.runtimeRef ?? null,\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    if (!existingHasAuthoritativeRuntimeRef) {\n      const herdrPane = findMatchingHerdrPane(agent, herdrPanes);\n      if (herdrPane) {\n        return {\n          ...baseEntry,\n          runtime: \"herdr\",\n          runtimeRef: herdrPaneToRuntimeRef(herdrPane, name),\n        };\n      }\n    }\n\n    return baseEntry;\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  /** Resolve an exact historical session ID across the selected harnesses. */\n  async findSessionsById(\n    sessionId: string,\n    opts?: Pick<ListSessionsOptions, \"type\">,\n  ): Promise<SessionSummary[]> {\n    const targetAdapters = Array.from(this.adapters.values()).filter(\n      (adapter) => opts?.type === undefined || adapter.type === opts.type,\n    );\n    const errors: Array<{ type: string; error: Error }> = [];\n\n    const results = await Promise.all(\n      targetAdapters.map(async (adapter) => {\n        try {\n          if (adapter.findSessionsById) return await adapter.findSessionsById(sessionId);\n          const sessions = await adapter.listSessions(opts);\n          return sessions.filter((session) => session.sessionId === sessionId);\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 find session by ID:`);\n      for (const { type, error } of errors) {\n        console.error(`  - ${type}: ${error.message}`);\n      }\n    }\n\n    return results.flat();\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","parseTmuxRuntimeRef","captureProcessSnapshot","filterByProcessNames","findMatchingHerdrPane","fetchHerdrAgentPanes","herdrPaneToRuntimeRef","AgentNotRunningError","Error","agentName","name","AgentManager","adapters","Map","registry","default","captureSnapshot","options","registerAdapter","adapter","adapterKey","type","has","set","unregisterAdapter","delete","getAdapters","Array","from","values","getAdapter","get","hasAdapter","listAgents","allAgents","errors","processNames","Set","flatMap","processes","length","isCandidate","process","isCandidateProcess","adapterPromises","map","agents","detectAgents","error","err","String","push","results","Promise","all","result","console","forEach","message","identityKey","pid","preExistingByIdentity","list","entry","herdrPanes","resolveHerdrPanes","entries","agent","toRegistryEntry","registerBatch","pruneIfDue","pinned","updatedAt","lastActive","Date","sortKey","sortBy","some","canHandle","runtimeProvider","resolveRuntimeProvider","onRuntimeDiscoveryError","existing","existingHasAuthoritativeRuntimeRef","runtime","Boolean","runtimeRef","baseEntry","cwd","projectPath","startedAt","toISOString","sessionId","sessionFilePath","herdrPane","togglePin","lookup","isAlive","prune","listSessions","opts","targetAdapters","filter","undefined","merged","sort","a","b","getTime","findSessionsById","sessions","session","flat","getAdapterCount","size","clear","resolveAgent","input","registryEntry","registryAgent","find","lowerInput","toLowerCase","exactMatch","matches","includes"],"mappings":"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"}

package/dist/__tests__/AgentManager.test.js

@@ -6,6 +6,7 @@ import path from "path";
 import { AgentManager } from "../AgentManager.js";
 import { AgentStatus } from "../adapters/AgentAdapter.js";
 import { AgentRegistry } from "../utils/AgentRegistry.js";
+import { createProcessSnapshotCapture } from "../utils/process.js";
 // Mock adapter for testing
 let MockAdapter = class MockAdapter {
     type;
@@ -179,7 +180,9 @@ describe("AgentManager", ()=>{
                 "claude",
                 "pi",
                 "node"
-            ]);
+            ], {
+                isCandidate: expect.any(Function)
+            });
             expect(claude.detectAgents).toHaveBeenCalledWith({
                 processes: [
                     processes[0]
@@ -252,7 +255,9 @@ describe("AgentManager", ()=>{
                 "codex",
                 "pi",
                 "claude"
-            ]);
+            ], {
+                isCandidate: expect.any(Function)
+            });
             expect(gemini.detectAgents).toHaveBeenCalledWith({
                 processes: [
                     processes[0],
@@ -276,6 +281,149 @@ describe("AgentManager", ()=>{
                 ]
             });
         });
+        describe("candidate-only enrichment", ()=>{
+            const pidsArg = (args)=>args[args.indexOf("-p") + 1].split(",").map((pid)=>parseInt(pid, 10));
+            function createExec(psLines) {
+                const exec = vi.fn(async (file, args)=>{
+                    if (file === "ps" && args.includes("-axo")) return psLines.join("\n");
+                    if (file === "lsof") return pidsArg(args).map((pid)=>`p${pid}\nn/w/${pid}`).join("\n");
+                    if (file === "ps") {
+                        return pidsArg(args).map((pid)=>`${pid} Wed Mar 18 23:18:01 2026`).join("\n");
+                    }
+                    throw new Error(`unexpected command: ${file}`);
+                });
+                const enriched = (kind)=>exec.mock.calls.filter(([file, args])=>kind === "lsof" ? file === "lsof" : args.some((arg)=>arg.includes("lstart="))).map(([, args])=>pidsArg(args));
+                return {
+                    exec,
+                    enriched
+                };
+            }
+            const createAdapter = (type, processNames, canHandle)=>({
+                    type,
+                    processNames,
+                    detectAgents: vi.fn(async ()=>[]),
+                    canHandle,
+                    getConversation: ()=>[],
+                    listSessions: async ()=>[]
+                });
+            const unrelatedNode = Array.from({
+                length: 50
+            }, (_, index)=>`${1000 + index} 1 ?? node /Applications/Tool${index}.app/helper.js`);
+            it("runs lsof and ps lstart only for PIDs some adapter can handle", async ()=>{
+                const { exec, enriched } = createExec([
+                    ...unrelatedNode,
+                    "200 1 s001 node /usr/local/bin/gemini",
+                    "300 1 s002 node /usr/local/lib/pi.js",
+                    "400 1 s003 codex exec --cd /repos/gemini"
+                ]);
+                const gemini = createAdapter("gemini_cli", [
+                    "node"
+                ], (p)=>p.command.includes("gemini"));
+                const pi = createAdapter("pi", [
+                    "pi",
+                    "node"
+                ], (p)=>p.command.includes("pi.js"));
+                const codex = createAdapter("codex", [
+                    "codex"
+                ], ()=>false);
+                const snapshotManager = new AgentManager(new AgentRegistry(path.join(tmpDir, "candidate-agents.json")), createProcessSnapshotCapture({
+                    exec
+                }));
+                snapshotManager.registerAdapter(gemini);
+                snapshotManager.registerAdapter(pi);
+                snapshotManager.registerAdapter(codex);
+                await snapshotManager.listAgents();
+                expect(enriched("lsof")).toEqual([
+                    [
+                        200,
+                        300
+                    ]
+                ]);
+                expect(enriched("lstart")).toEqual([
+                    [
+                        200,
+                        300
+                    ]
+                ]);
+                const geminiProcesses = gemini.detectAgents.mock.calls[0][0].processes;
+                expect(geminiProcesses).toHaveLength(52);
+                expect(geminiProcesses.find((p)=>p.pid === 200)).toMatchObject({
+                    cwd: "/w/200"
+                });
+                expect(geminiProcesses.find((p)=>p.pid === 1000)).toMatchObject({
+                    cwd: ""
+                });
+            });
+            it("spawns only the base ps on a refresh with no candidate processes", async ()=>{
+                const { exec } = createExec(unrelatedNode);
+                const gemini = createAdapter("gemini_cli", [
+                    "node"
+                ], (p)=>p.command.includes("gemini"));
+                const snapshotManager = new AgentManager(new AgentRegistry(path.join(tmpDir, "no-candidate-agents.json")), createProcessSnapshotCapture({
+                    exec
+                }));
+                snapshotManager.registerAdapter(gemini);
+                await snapshotManager.listAgents();
+                await snapshotManager.listAgents();
+                expect(exec).toHaveBeenCalledTimes(2);
+                for (const [file, args] of exec.mock.calls){
+                    expect(file).toBe("ps");
+                    expect(args).toContain("-axo");
+                }
+            });
+            it("only checks canHandle for adapters whose executables match", async ()=>{
+                const { exec, enriched } = createExec([
+                    "200 1 s001 node /usr/local/bin/gemini"
+                ]);
+                const claude = createAdapter("claude", [
+                    "claude"
+                ], ()=>true);
+                const gemini = createAdapter("gemini_cli", [
+                    "node"
+                ], ()=>false);
+                const snapshotManager = new AgentManager(new AgentRegistry(path.join(tmpDir, "scoped-candidate-agents.json")), createProcessSnapshotCapture({
+                    exec
+                }));
+                snapshotManager.registerAdapter(claude);
+                snapshotManager.registerAdapter(gemini);
+                await snapshotManager.listAgents();
+                expect(enriched("lsof")).toEqual([]);
+            });
+            it("fetches start times once per PID across refreshes", async ()=>{
+                const { exec, enriched } = createExec([
+                    ...unrelatedNode,
+                    "200 1 s001 node /usr/local/bin/gemini"
+                ]);
+                const gemini = createAdapter("gemini_cli", [
+                    "node"
+                ], (p)=>p.command.includes("gemini"));
+                const snapshotManager = new AgentManager(new AgentRegistry(path.join(tmpDir, "cached-agents.json")), createProcessSnapshotCapture({
+                    exec
+                }));
+                snapshotManager.registerAdapter(gemini);
+                await snapshotManager.listAgents();
+                await snapshotManager.listAgents();
+                await snapshotManager.listAgents();
+                expect(enriched("lstart")).toEqual([
+                    [
+                        200
+                    ]
+                ]);
+                expect(enriched("lsof")).toEqual([
+                    [
+                        200
+                    ],
+                    [
+                        200
+                    ],
+                    [
+                        200
+                    ]
+                ]);
+                const lastCall = gemini.detectAgents.mock.calls[2][0].processes;
+                expect(lastCall.find((p)=>p.pid === 200)?.startTime).toEqual(new Date("Wed Mar 18 23:18:01 2026"));
+            });
+        });
         it("does not pass a snapshot context to legacy adapters", async ()=>{
             const captureSnapshot = vi.fn(async ()=>[]);
             const legacy = new MockAdapter("claude");
@@ -1185,7 +1333,7 @@ describe("AgentManager", ()=>{
             expect(claude.lastListSessionsOpts).toBeUndefined();
             expect(codex.lastListSessionsOpts).toBeUndefined();
         });
-        it("skips non-matching providers when type is supplied", async ()=>{
+        it("skips non-matching harnesses when type is supplied", async ()=>{
             const claude = new MockAdapter("claude", [], false, [
                 session("claude", "target")
             ]);