@gobing-ai/ts-ai-runner 0.3.1 → 0.3.3

package/dist/ai-runner.d.ts

@@ -1,5 +1,7 @@
-import { type ProcessExecutor } from '@gobing-ai/ts-runtime';
-import { type AgentName, type PromptOptions } from './agents/shims';
+import { type EventBus, type Logger } from '@gobing-ai/ts-infra';
+import { type ProcessExecutor, type TracerPort } from '@gobing-ai/ts-runtime';
+import { type AgentName, type PromptOptions, type ShimCommand } from './agents/shims';
+import type { AgentEvents, AiRunnerProcessEvents } from './events';
 /** Result returned by every AI runner dispatch method. */
 export interface AgentRunResult {
     /** Process exit code; null indicates signal or timeout termination. */
@@ -28,12 +30,22 @@ export interface AiRunnerOptions {
     defaultCwd?: string;
     /** Default timeout in milliseconds. */
     defaultTimeout?: number;
+    /** Logger for invocation diagnostics. Defaults to `getLogger('ai-runner')`. */
+    logger?: Logger;
+    /** Event bus receiving process-level observability from the default executor. */
+    processEvents?: EventBus<AiRunnerProcessEvents>;
+    /** Event bus receiving agent-level invocation observability. */
+    events?: EventBus<AgentEvents>;
+    /** Tracer adapter for the default executor. Defaults to `ts-infra` traceAsync. */
+    tracer?: TracerPort;
 }
 /** Dispatches coding-agent CLI commands through pure command shims. */
 export declare class AiRunner {
     private readonly processExecutor;
     private readonly defaultCwd;
     private readonly defaultTimeout;
+    private readonly logger;
+    private readonly events;
     constructor(options?: AiRunnerOptions);
     /** Run an agent help command. */
     runHelpCommand(agent: AgentName, options?: AgentRunOptions): Promise<AgentRunResult>;
@@ -41,6 +53,10 @@ export declare class AiRunner {
     runVersionCommand(agent: AgentName, options?: AgentRunOptions): Promise<AgentRunResult>;
     /** Run an agent prompt command. */
     runPromptCommand(agent: AgentName, promptOptions: PromptOptions, options?: AgentRunOptions): Promise<AgentRunResult>;
+    /** Translate a Claude-style slash command and run it as a prompt command. */
+    runSlashCommand(agent: AgentName, input: string, promptOptions: PromptOptions, options?: AgentRunOptions): Promise<AgentRunResult>;
+    /** Build an agent prompt command without executing it. */
+    buildPromptCommand(agent: AgentName, promptOptions: PromptOptions, options?: AgentRunOptions): ShimCommand;
     /** Run an agent authentication command, or return null when unsupported. */
     runAuthCommand(agent: AgentName, options?: AgentRunOptions): Promise<AgentRunResult> | null;
     private invoke;

package/dist/ai-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-runner.d.ts","sourceRoot":"","sources":["../src/ai-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,eAAe,EAAsB,MAAM,uBAAuB,CAAC;AACtG,OAAO,EAAE,KAAK,SAAS,EAAgB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGlF,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC3B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC5B,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC5B,4DAA4D;IAC5D,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,uEAAuE;AACvE,qBAAa,QAAQ;IACjB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,OAAO,GAAE,eAAoB;IAMzC,iCAAiC;IACjC,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxF,oCAAoC;IACpC,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI3F,mCAAmC;IACnC,gBAAgB,CACZ,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,aAAa,EAC5B,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,cAAc,CAAC;IAW1B,4EAA4E;IAC5E,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;YAKjF,MAAM;IAyBpB,OAAO,CAAC,oBAAoB;CAmB/B"}
+{"version":3,"file":"ai-runner.d.ts","sourceRoot":"","sources":["../src/ai-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAa,KAAK,MAAM,EAAc,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAGH,KAAK,eAAe,EAEpB,KAAK,UAAU,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,SAAS,EAAgB,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAInE,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC3B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC5B,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC5B,4DAA4D;IAC5D,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,aAAa,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAChD,gEAAgE;IAChE,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/B,kFAAkF;IAClF,MAAM,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,uEAAuE;AACvE,qBAAa,QAAQ;IACjB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;gBAE/C,OAAO,GAAE,eAAoB;IAuBzC,iCAAiC;IACjC,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxF,oCAAoC;IACpC,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI3F,mCAAmC;IACnC,gBAAgB,CACZ,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,aAAa,EAC5B,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,cAAc,CAAC;IAI1B,6EAA6E;IAC7E,eAAe,CACX,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,aAAa,EAC5B,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,cAAc,CAAC;IAI1B,0DAA0D;IAC1D,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,GAAE,eAAoB,GAAG,WAAW;IAI9G,4EAA4E;IAC5E,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;YAKjF,MAAM;IA2CpB,OAAO,CAAC,oBAAoB;CAmB/B"}

package/dist/ai-runner.js

@@ -1,15 +1,36 @@
-import { NodeProcessExecutor } from '@gobing-ai/ts-runtime';
+import { getLogger, traceAsync } from '@gobing-ai/ts-infra';
+import { getProcessCwd, NodeProcessExecutor, } from '@gobing-ai/ts-runtime';
 import { getAgentShim } from './agents/shims.js';
 import { buildIdentityPreamble } from './identity.js';
+import { translateSlashCommand } from './slash-command.js';
 /** Dispatches coding-agent CLI commands through pure command shims. */
 export class AiRunner {
     processExecutor;
     defaultCwd;
     defaultTimeout;
+    logger;
+    events;
     constructor(options = {}) {
-        this.processExecutor = options.processExecutor ?? new NodeProcessExecutor();
+        this.processExecutor =
+            options.processExecutor ??
+                new NodeProcessExecutor({
+                    ...(options.processEvents !== undefined
+                        ? {
+                            events: {
+                                emit: (event, detail) => {
+                                    void options.processEvents?.emit(event, detail);
+                                },
+                            },
+                        }
+                        : {}),
+                    tracer: options.tracer ?? {
+                        traceAsync: async (name, fn) => await traceAsync(name, (span) => fn(span)),
+                    },
+                });
         this.defaultCwd = options.defaultCwd;
         this.defaultTimeout = options.defaultTimeout;
+        this.logger = options.logger ?? getLogger('ai-runner');
+        this.events = options.events;
     }
     /** Run an agent help command. */
     runHelpCommand(agent, options = {}) {
@@ -21,8 +42,15 @@ export class AiRunner {
     }
     /** Run an agent prompt command. */
     runPromptCommand(agent, promptOptions, options = {}) {
-        const enrichedPromptOptions = this.withIdentityPreamble(agent, promptOptions, options);
-        return this.invoke(agent, 'prompt', getAgentShim(agent).getPromptCommand(enrichedPromptOptions), options, false);
+        return this.invoke(agent, 'prompt', this.buildPromptCommand(agent, promptOptions, options), options, false);
+    }
+    /** Translate a Claude-style slash command and run it as a prompt command. */
+    runSlashCommand(agent, input, promptOptions, options = {}) {
+        return this.runPromptCommand(agent, { ...promptOptions, input: translateSlashCommand(agent, input) }, options);
+    }
+    /** Build an agent prompt command without executing it. */
+    buildPromptCommand(agent, promptOptions, options = {}) {
+        return getAgentShim(agent).getPromptCommand(this.withIdentityPreamble(agent, promptOptions, options));
     }
     /** Run an agent authentication command, or return null when unsupported. */
     runAuthCommand(agent, options = {}) {
@@ -30,15 +58,33 @@ export class AiRunner {
         return command === null ? null : this.invoke(agent, 'auth', command, options, true);
     }
     async invoke(agent, operation, command, options, forceBuffered) {
+        const label = `ai-runner.${agent}.${operation}`;
+        this.logger.debug('invoke', { label, command: command.command, args: command.args.join(' ') });
+        void this.events?.emit('agent.invoke.start', { agent, operation, label });
         const result = await this.processExecutor.run({
             command: command.command,
             args: command.args,
-            label: `ai-runner.${agent}.${operation}`,
+            label,
             rejectOnError: false,
             forceBuffered,
             cwd: options.cwd ?? this.defaultCwd,
             timeout: options.timeout ?? this.defaultTimeout,
         });
+        if (result.exitCode !== 0) {
+            this.logger.error('invoke exited non-zero', {
+                label,
+                exitCode: result.exitCode,
+                signal: result.signal,
+            });
+        }
+        void this.events?.emit('agent.invoke.exit', {
+            agent,
+            operation,
+            label,
+            exitCode: result.exitCode,
+            ...(result.signal !== undefined ? { signal: result.signal } : {}),
+            durationMs: result.durationMs,
+        });
         return {
             exitCode: result.exitCode,
             stdout: result.stdout,
@@ -50,7 +96,7 @@ export class AiRunner {
     withIdentityPreamble(agent, promptOptions, options) {
         if (!hasIdentityOptions(promptOptions))
             return promptOptions;
-        const workspace = options.cwd ?? this.defaultCwd ?? process.cwd();
+        const workspace = options.cwd ?? this.defaultCwd ?? getProcessCwd();
         const preamble = buildIdentityPreamble({
             agentId: agent,
             agentType: agent,

package/dist/doctor-runner.d.ts

@@ -1,3 +1,4 @@
+import { type Logger } from '@gobing-ai/ts-infra';
 import { AgentDetector } from './agent-detector';
 import { AiRunner } from './ai-runner';
 /** Health-check result for one coding agent. */
@@ -29,6 +30,8 @@ export interface DoctorRunnerOptions {
     timeout?: number;
     /** Environment map for file/env auth checks. */
     env?: Record<string, string | undefined>;
+    /** Logger for health-check diagnostics. Defaults to `getLogger('doctor')`. */
+    logger?: Logger;
 }
 /** Runs installation and auth health checks for supported coding agents. */
 export declare class DoctorRunner {
@@ -37,6 +40,7 @@ export declare class DoctorRunner {
     private readonly timeout;
     private readonly env;
     private readonly fs;
+    private readonly logger;
     constructor(options?: DoctorRunnerOptions);
     /** Run a health check on all supported agents. */
     runAll(): Promise<DoctorResult[]>;
@@ -44,6 +48,9 @@ export declare class DoctorRunner {
     runOne(agent: string): Promise<DoctorResult>;
     private buildResult;
     private checkAuth;
+    private checkCodexAuth;
+    private geminiSettingsContainCredentials;
+    private probeAuthOutput;
     /** True when the path exists and has a non-zero size. */
     private hasNonEmptyFile;
 }

package/dist/doctor-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor-runner.d.ts","sourceRoot":"","sources":["../src/doctor-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAsB,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,gDAAgD;AAChD,MAAM,WAAW,YAAY;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+CAA+C;IAC/C,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACZ,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oCAAoC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAChC,uBAAuB;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,qBAAqB;IACrB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5C;AASD,4EAA4E;AAC5E,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IACzD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAwB;gBAE/B,OAAO,GAAE,mBAAwB;IAO7C,kDAAkD;IAC5C,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKvC,uCAAuC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAIpC,WAAW;YAgBX,SAAS;IAmBvB,yDAAyD;YAC3C,eAAe;CAKhC"}
+{"version":3,"file":"doctor-runner.d.ts","sourceRoot":"","sources":["../src/doctor-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAsB,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAuB,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D,gDAAgD;AAChD,MAAM,WAAW,YAAY;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+CAA+C;IAC/C,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACZ,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oCAAoC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAChC,uBAAuB;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,qBAAqB;IACrB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAgCD,4EAA4E;AAC5E,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IACzD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAwB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,mBAAwB;IAQ7C,kDAAkD;IAC5C,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAkBvC,uCAAuC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAIpC,WAAW;YAiBX,SAAS;YAWT,cAAc;YASd,gCAAgC;YAQhC,eAAe;IAY7B,yDAAyD;YAC3C,eAAe;CAKhC"}

package/dist/doctor-runner.js

@@ -1,10 +1,31 @@
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { getProcessEnv, NodeFileSystem } from '@gobing-ai/ts-runtime';
+import { getLogger } from '@gobing-ai/ts-infra';
+import { getProcessEnv, joinPath, NodeFileSystem } from '@gobing-ai/ts-runtime';
 import { AgentDetector } from './agent-detector.js';
-import { isAgentName, TIER2_AGENTS } from './agents/shims.js';
+import { DISPLAY_ORDER, isAgentName, TIER2_AGENTS } from './agents/shims.js';
 import { AiRunner } from './ai-runner.js';
 const DEFAULT_TIMEOUT_MS = 5_000;
+const AUTH_PATTERNS = {
+    claude: {
+        positive: /authenticated|logged[\s_-]*in|"loggedIn"\s*:\s*true/i,
+        negative: /not[\s_-]*authenticated|not[\s_-]*logged[\s_-]*in|logged[\s_-]*out|unauthenticated|"loggedIn"\s*:\s*false/i,
+    },
+    codex: {
+        positive: /logged[\s_-]*in|authenticated/i,
+        negative: /not[\s_-]*authenticated|not[\s_-]*logged[\s_-]*in|logged[\s_-]*out|unauthenticated/i,
+    },
+    opencode: {
+        positive: /configured|available/i,
+        negative: /not[\s_-]*configured|no[\s_-]+providers?[\s_-]+available|unavailable/i,
+    },
+    openclaw: {
+        positive: /(^|[^a-z])ok([^a-z]|$)|healthy/i,
+        negative: /not[\s_-]*healthy|unhealthy|not[\s_-]*ok/i,
+    },
+    pi: {
+        positive: /\S/,
+        negative: /not[\s_-]*authenticated|not[\s_-]*logged[\s_-]*in|unauthenticated|no[\s_-]+providers?/i,
+    },
+};
 /** True when a value is a defined, non-blank string. */
 function isNonEmpty(value) {
     return value !== undefined && value.trim().length > 0;
@@ -16,16 +37,25 @@ export class DoctorRunner {
     timeout;
     env;
     fs = new NodeFileSystem();
+    logger;
     constructor(options = {}) {
         this.runner = options.runner ?? new AiRunner();
         this.detector = options.agentDetector ?? new AgentDetector({ runner: this.runner });
         this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
         this.env = options.env ?? getProcessEnv();
+        this.logger = options.logger ?? getLogger('doctor');
     }
     /** Run a health check on all supported agents. */
     async runAll() {
         const detected = await this.detector.detectAll();
-        return await Promise.all(detected.map((agent) => this.buildResult(agent)));
+        const byName = new Map(detected.map((agent) => [agent.name, agent]));
+        return await Promise.all(DISPLAY_ORDER.map((agent) => this.buildResult(byName.get(agent) ?? {
+            name: agent,
+            installed: false,
+            version: null,
+            channels: [],
+            error: `Unknown agent: ${agent}`,
+        })));
     }
     /** Run a health check on one agent. */
     async runOne(agent) {
@@ -33,6 +63,7 @@ export class DoctorRunner {
     }
     async buildResult(detected) {
         const tier = TIER2_AGENTS.has(detected.name) ? 2 : 1;
+        this.logger.debug('checking agent', { agent: detected.name, installed: detected.installed, tier });
         const authenticated = detected.installed && isAgentName(detected.name) ? await this.checkAuth(detected.name) : false;
         return {
             agent: detected.name,
@@ -46,23 +77,46 @@ export class DoctorRunner {
         };
     }
     async checkAuth(agent) {
-        // gemini/codex expose no auth-status command; treat a non-empty credential
-        // file as authenticated. An empty/zero-byte file is a stale-credential
-        // false positive, so existence alone is insufficient.
+        const home = this.env.HOME || this.env.USERPROFILE || '';
         if (agent === 'gemini')
-            return this.hasNonEmptyFile(join(homedir(), '.gemini', 'settings.json'));
-        if (agent === 'codex' && (await this.hasNonEmptyFile(join(homedir(), '.codex', 'auth.json'))))
-            return true;
+            return this.geminiSettingsContainCredentials(home);
+        if (agent === 'codex')
+            return this.checkCodexAuth(home);
         // pi reads provider keys from the environment; require a non-empty value
         // rather than mere presence (an empty export is not a usable credential).
         if (agent === 'pi' && (isNonEmpty(this.env.GOOGLE_API_KEY) || isNonEmpty(this.env.ANTHROPIC_API_KEY)))
             return true;
-        const command = this.runner.runAuthCommand(agent, { timeout: this.timeout });
-        if (command === null)
+        return (await this.probeAuthOutput(agent)) === true;
+    }
+    async checkCodexAuth(home) {
+        const probeStatus = await this.probeAuthOutput('codex');
+        if (probeStatus !== null)
+            return probeStatus;
+        return ((await this.hasNonEmptyFile(joinPath(home, '.codex', 'auth.json'))) ||
+            (await this.hasNonEmptyFile(joinPath(home, '.codex', 'auth'))));
+    }
+    async geminiSettingsContainCredentials(home) {
+        try {
+            return /auth|token|key/i.test(await this.fs.readFile(joinPath(home, '.gemini', 'settings.json')));
+        }
+        catch {
             return false;
+        }
+    }
+    async probeAuthOutput(agent) {
+        const command = this.runner.runAuthCommand(agent, { timeout: this.timeout });
+        const patterns = AUTH_PATTERNS[agent];
+        if (command === null || patterns === undefined)
+            return null;
         const result = await command;
-        return (result.exitCode === 0 &&
-            !/not authenticated|not logged|unauthenticated/i.test(`${result.stdout}\n${result.stderr}`));
+        if (result.exitCode !== 0)
+            return false;
+        const output = `${result.stdout}\n${result.stderr}`;
+        if (patterns.negative.test(output))
+            return false;
+        if (patterns.positive.test(output))
+            return true;
+        return null;
     }
     /** True when the path exists and has a non-zero size. */
     async hasNonEmptyFile(path) {

package/dist/events.d.ts

@@ -0,0 +1,38 @@
+import type { ProcessEvents } from '@gobing-ai/ts-runtime';
+/** Typed event map for agent-runner observability. All events prefixed `agent.`. */
+export type AgentEvents = {
+    /** Emitted immediately before an agent CLI invocation starts. */
+    'agent.invoke.start': (data: {
+        agent: string;
+        operation: string;
+        label: string;
+    }) => void;
+    /** Emitted after an agent CLI invocation exits. */
+    'agent.invoke.exit': (data: {
+        agent: string;
+        operation: string;
+        label: string;
+        exitCode: number | null;
+        signal?: string;
+        durationMs: number;
+    }) => void;
+    /** Emitted when a long-running team agent process starts. */
+    'agent.started': (data: {
+        agentId: string;
+        agentType: string;
+        pid: number | null;
+    }) => void;
+    /** Emitted when a long-running team agent process stops. */
+    'agent.stopped': (data: {
+        agentId: string;
+        exitCode: number | null;
+    }) => void;
+    /** Emitted when a message is sent to a team agent process. */
+    'agent.message.sent': (data: {
+        agentId: string;
+        ok: boolean;
+    }) => void;
+};
+/** Event map for process-level observability emitted by AiRunner-owned executors. */
+export type AiRunnerProcessEvents = ProcessEvents;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,oFAAoF;AACpF,MAAM,MAAM,WAAW,GAAG;IACtB,iEAAiE;IACjE,oBAAoB,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1F,mDAAmD;IACnD,mBAAmB,EAAE,CAAC,IAAI,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACtB,KAAK,IAAI,CAAC;IACX,6DAA6D;IAC7D,eAAe,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5F,4DAA4D;IAC5D,eAAe,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9E,8DAA8D;IAC9D,oBAAoB,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC1E,CAAC;AAEF,qFAAqF;AACrF,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC"}

package/dist/identity.d.ts

@@ -1,4 +1,5 @@
 import { type SyncProcessExecutor } from '@gobing-ai/ts-runtime';
+/** Context used to construct the identity preamble injected into agent prompts. */
 export interface IdentityContext {
     agentId: string;
     agentType: string;
@@ -16,6 +17,8 @@ export interface IdentityContext {
     gitDirty?: boolean;
     guardrails?: string[];
 }
+/** Build a human-readable identity preamble string that describes the agent, its task, peers, guardrails, and git context. */
 export declare function buildIdentityPreamble(ctx: IdentityContext): string;
+/** Query git for the current branch name and dirty file count in `workspacePath`. Returns a pre-formatted "Git context" block, or `null` if git is unavailable or the directory is not a repo. */
 export declare function getGitContext(workspacePath: string, executor?: SyncProcessExecutor): string | null;
 //# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEzF,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA8ClE;AAED,wBAAgB,aAAa,CACzB,aAAa,EAAE,MAAM,EACrB,QAAQ,GAAE,mBAAkD,GAC7D,MAAM,GAAG,IAAI,CAYf"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEzF,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,8HAA8H;AAC9H,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA8ClE;AAED,kMAAkM;AAClM,wBAAgB,aAAa,CACzB,aAAa,EAAE,MAAM,EACrB,QAAQ,GAAE,mBAAkD,GAC7D,MAAM,GAAG,IAAI,CAYf"}

package/dist/identity.js

@@ -1,4 +1,5 @@
 import { BunSyncProcessExecutor } from '@gobing-ai/ts-runtime';
+/** Build a human-readable identity preamble string that describes the agent, its task, peers, guardrails, and git context. */
 export function buildIdentityPreamble(ctx) {
     const sections = [
         `You are agent \`${ctx.agentId}\` (${ctx.agentType}) in workspace \`${ctx.workspace}\`.`,
@@ -31,6 +32,7 @@ export function buildIdentityPreamble(ctx) {
     }
     return `${sections.join('\n\n')}\n`;
 }
+/** Query git for the current branch name and dirty file count in `workspacePath`. Returns a pre-formatted "Git context" block, or `null` if git is unavailable or the directory is not a repo. */
 export function getGitContext(workspacePath, executor = new BunSyncProcessExecutor()) {
     const git = Bun.which('git');
     if (git === null)

package/dist/index.d.ts

@@ -3,8 +3,9 @@ export * from './agent-spec';
 export * from './agents/shims';
 export * from './ai-runner';
 export * from './doctor-runner';
+export * from './events';
 export * from './identity';
-export * from './message-service';
+export * from './messages';
 export * from './slash-command';
 export * from './team-agent-process';
 export * from './team-orchestrator';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -3,8 +3,9 @@ export * from './agent-spec.js';
 export * from './agents/shims.js';
 export * from './ai-runner.js';
 export * from './doctor-runner.js';
+export * from './events.js';
 export * from './identity.js';
-export * from './message-service.js';
+export * from './messages.js';
 export * from './slash-command.js';
 export * from './team-agent-process.js';
 export * from './team-orchestrator.js';

package/dist/messages.d.ts

@@ -0,0 +1,4 @@
+import type { InboxMessage } from '@gobing-ai/ts-db/inbox';
+/** Renders an inbox message into the line injected into an agent's stdin. */
+export declare function formatMessage(msg: InboxMessage): string;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAEvD"}

package/dist/messages.js

@@ -0,0 +1,4 @@
+/** Renders an inbox message into the line injected into an agent's stdin. */
+export function formatMessage(msg) {
+    return `[task from=${msg.fromId ?? 'operator'} id=${msg.id}] ${msg.body}`;
+}

package/dist/team-agent-process.d.ts

@@ -1,21 +1,28 @@
 import { Buffer } from 'node:buffer';
-import { type PipeProcessSpawner } from '@gobing-ai/ts-runtime';
+import { type Logger } from '@gobing-ai/ts-infra';
+import { ProcessExecutor } from '@gobing-ai/ts-runtime';
 import type { AgentSpec } from './agent-spec';
+/** Options for spawning a team agent subprocess. */
 export interface AgentProcessOptions {
     spec: AgentSpec;
     command: string[];
     env?: Record<string, string>;
     cwd?: string;
-    processSpawner?: PipeProcessSpawner;
+    processExecutor?: ProcessExecutor;
+    logger?: Logger;
 }
 type ProcessStatus = 'running' | 'stopped' | 'errored';
+/**
+ * Manages the lifecycle of a single agent subprocess — start, stop, message send, and stdout/stderr subscription.
+ * The identity preamble is built by `TeamOrchestrator` and baked into `command` before the process is constructed.
+ */
 export declare class TeamAgentProcess {
     readonly agentId: string;
-    readonly identityPreamble: string;
     private readonly command;
     private readonly env;
     private readonly cwd;
-    private readonly processSpawner;
+    private readonly processExecutor;
+    private readonly logger;
     private subprocess;
     private status;
     private exitCode;
@@ -31,6 +38,7 @@ export declare class TeamAgentProcess {
     getPid(): number | null;
     getExitCode(): number | null;
     private pipe;
+    private warn;
 }
 export {};
 //# sourceMappingURL=team-agent-process.d.ts.map

package/dist/team-agent-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"team-agent-process.d.ts","sourceRoot":"","sources":["../src/team-agent-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAA2C,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACzG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACvC;AAED,KAAK,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD,qBAAa,gBAAgB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;gBAErD,OAAO,EAAE,mBAAmB;IAgBlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAWrD,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAOvD,SAAS,IAAI,aAAa;IAI1B,MAAM,IAAI,MAAM,GAAG,IAAI;IAIvB,WAAW,IAAI,MAAM,GAAG,IAAI;YAId,IAAI;CAerB"}
+{"version":3,"file":"team-agent-process.d.ts","sourceRoot":"","sources":["../src/team-agent-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAoB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;gBAErD,OAAO,EAAE,mBAAmB;IASlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAerD,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAOvD,SAAS,IAAI,aAAa;IAI1B,MAAM,IAAI,MAAM,GAAG,IAAI;IAIvB,WAAW,IAAI,MAAM,GAAG,IAAI;YAId,IAAI;IAiBlB,OAAO,CAAC,IAAI;CAOf"}

package/dist/team-agent-process.js

@@ -1,30 +1,28 @@
 import { Buffer } from 'node:buffer';
-import { BunPipeProcessSpawner } from '@gobing-ai/ts-runtime';
-import { buildIdentityPreamble } from './identity.js';
+import { getLogger } from '@gobing-ai/ts-infra';
+import { ProcessExecutor } from '@gobing-ai/ts-runtime';
+/**
+ * Manages the lifecycle of a single agent subprocess — start, stop, message send, and stdout/stderr subscription.
+ * The identity preamble is built by `TeamOrchestrator` and baked into `command` before the process is constructed.
+ */
 export class TeamAgentProcess {
     agentId;
-    identityPreamble;
     command;
     env;
     cwd;
-    processSpawner;
+    processExecutor;
+    logger;
     subprocess = null;
     status = 'stopped';
     exitCode = null;
     subscribers = new Set();
     constructor(options) {
         this.agentId = options.spec.id;
-        this.identityPreamble = buildIdentityPreamble({
-            agentId: options.spec.id,
-            agentType: options.spec.type,
-            workspace: options.spec.workspace,
-            purpose: options.spec.purpose,
-            systemPrompt: typeof options.spec.config.systemPrompt === 'string' ? options.spec.config.systemPrompt : undefined,
-        });
         this.command = options.command;
         this.env = options.env;
         this.cwd = options.cwd ?? options.spec.workspace;
-        this.processSpawner = options.processSpawner ?? new BunPipeProcessSpawner();
+        this.processExecutor = options.processExecutor ?? new ProcessExecutor();
+        this.logger = options.logger ?? getLogger('team-agent');
     }
     async start() {
         if (this.status === 'running')
@@ -32,9 +30,10 @@ export class TeamAgentProcess {
         const [command, ...args] = this.command;
         if (command === undefined)
             throw new Error(`${this.agentId}: command must not be empty`);
-        this.subprocess = this.processSpawner.spawn({
+        this.subprocess = this.processExecutor.runStreaming({
             command,
             args,
+            label: `team-agent.${this.agentId}`,
             ...(this.cwd !== undefined ? { cwd: this.cwd } : {}),
             ...(this.env !== undefined ? { env: this.env } : {}),
         });
@@ -59,11 +58,13 @@ export class TeamAgentProcess {
         try {
             process.endStdin();
         }
-        catch {
-            // Process may have already closed stdin.
+        catch (error) {
+            this.warn('stdin close failed', 'stop.endStdin', error);
         }
         process.kill('SIGTERM');
-        const timeout = Bun.sleep(5000).then(() => 'timeout');
+        const timeout = new Promise((resolve) => {
+            setTimeout(() => resolve('timeout'), 5000);
+        });
         const result = await Promise.race([process.exited, timeout]);
         if (result === 'timeout') {
             process.kill('SIGKILL');
@@ -76,13 +77,16 @@ export class TeamAgentProcess {
         this.subprocess = null;
     }
     async send(message) {
-        if (this.status !== 'running' || this.subprocess === null)
+        if (this.status !== 'running' || this.subprocess === null) {
+            this.warn('send skipped because process is not running', 'send.notRunning');
             return { ok: false };
+        }
         try {
             this.subprocess.writeStdin(`${message}\n`);
             return { ok: true };
         }
-        catch {
+        catch (error) {
+            this.warn('stdin write failed', 'send.writeStdin', error);
             this.status = 'errored';
             return { ok: false };
         }
@@ -114,7 +118,8 @@ export class TeamAgentProcess {
                     subscriber(buffer);
             }
         }
-        catch {
+        catch (error) {
+            this.warn('stream pipe failed', 'pipe', error);
             if (this.status === 'running')
                 this.status = 'errored';
         }
@@ -122,4 +127,11 @@ export class TeamAgentProcess {
             reader.releaseLock();
         }
     }
+    warn(message, op, error) {
+        this.logger.warn(message, {
+            agentId: this.agentId,
+            op,
+            ...(error !== undefined ? { error: error instanceof Error ? error.message : String(error) } : {}),
+        });
+    }
 }