@dreki-gg/pi-subagent 0.8.3 → 0.8.4

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @dreki-gg/pi-subagent
 
+## 0.8.4
+
+### Patch Changes
+
+- [`376864c`](https://github.com/dreki-gg/pi-extensions/commit/376864c37cefa47530363b47055311269c1724a8) Thanks [@jalbarrang](https://github.com/jalbarrang)! - feat(subagent): show live tool-aware status in working message during /run-agent
+
+  Previously `/run-agent` only showed a transient notification, leaving users with no visibility into what the background agent was doing (especially after a fork-at session switch that visually looks like a reload). Now the working message updates in real-time as the agent works:
+
+  - `scout · starting...`
+  - `scout · reading …/src/utils.ts`
+  - `scout · $ bun test --filter...`
+  - `scout · editing …/config.json`
+  - `scout · thinking...`
+
+  Added `onToolExecutionStart` callback to `spawnPiAgent` and `runAgent` to surface `tool_execution_start` events from the JSON stream.
+
 ## 0.8.3
 
 ### Patch Changes

package/extensions/subagent/agent-runner.ts

@@ -1,7 +1,7 @@
 import type { ResolvedPaths } from '@earendil-works/pi-coding-agent';
 import { discoverAgents, type AgentScope } from './agents.js';
 import type { AgentResult } from './agent-runner-types.js';
-import { emptyUsage, spawnPiAgent } from './spawn-utils.js';
+import { emptyUsage, spawnPiAgent, type ToolExecutionStartEvent } from './spawn-utils.js';
 
 export type OnPhaseUpdate = (phaseName: string, agentName: string, result: AgentResult) => void;
 
@@ -11,6 +11,7 @@ export interface RunAgentOptions {
   model?: string;
   thinking?: string;
   onUpdate?: OnPhaseUpdate;
+  onToolExecutionStart?: (event: ToolExecutionStartEvent) => void;
   phaseName?: string;
   signal?: AbortSignal;
   resolvedPaths?: ResolvedPaths;
@@ -76,6 +77,7 @@ export async function runAgent(
         options.onUpdate(options.phaseName ?? 'unknown', agentName, { ...result });
       }
     },
+    onToolExecutionStart: options.onToolExecutionStart,
   });
 
   result.exitCode = spawnResult.exitCode;

package/extensions/subagent/index.ts

@@ -43,12 +43,61 @@ import { extractRecentConversation } from './synthesis.js';
 import type { AgentResult } from './agent-runner-types.js';
 import { getFinalText } from './agent-result-utils.js';
 import { buildHandoffFromResult, renderHandoffForPrompt } from './handoffs.js';
-import { emptyUsage, spawnPiAgent } from './spawn-utils.js';
+import { emptyUsage, spawnPiAgent, type ToolExecutionStartEvent } from './spawn-utils.js';
 
 const MAX_PARALLEL_TASKS = 8;
 const MAX_CONCURRENCY = 4;
 const COLLAPSED_ITEM_COUNT = 10;
 
+function describeToolExecution(event: ToolExecutionStartEvent): string {
+  const shortenPath = (p: string) => {
+    const home = os.homedir();
+    const shortened = p.startsWith(home) ? `~${p.slice(home.length)}` : p;
+    // Show only the last 2 path segments for brevity
+    const parts = shortened.split('/');
+    return parts.length > 3 ? `…/${parts.slice(-2).join('/')}` : shortened;
+  };
+
+  const args = event.args;
+  switch (event.toolName) {
+    case 'bash': {
+      const cmd = (args.command as string) || '';
+      const preview = cmd.length > 50 ? `${cmd.slice(0, 50)}…` : cmd;
+      return `$ ${preview}`;
+    }
+    case 'read': {
+      const p = ((args.file_path || args.path) as string) || '';
+      return `reading ${shortenPath(p)}`;
+    }
+    case 'write': {
+      const p = ((args.file_path || args.path) as string) || '';
+      return `writing ${shortenPath(p)}`;
+    }
+    case 'edit': {
+      const p = ((args.file_path || args.path) as string) || '';
+      return `editing ${shortenPath(p)}`;
+    }
+    case 'grep': {
+      const pattern = (args.pattern as string) || '';
+      return `grep /${pattern}/`;
+    }
+    case 'find': {
+      const pattern = (args.pattern as string) || '*';
+      return `find ${pattern}`;
+    }
+    case 'ls':
+      return `ls ${shortenPath((args.path as string) || '.')}`;
+    case 'web_search':
+      return `searching: ${(args.query as string)?.slice(0, 40) || '…'}`;
+    case 'web_visit':
+      return 'visiting page';
+    case 'subagent':
+      return `spawning ${(args.agent as string) || 'subagent'}`;
+    default:
+      return event.toolName;
+  }
+}
+
 function formatTokens(count: number): string {
   if (count < 1000) return count.toString();
   if (count < 10000) return `${(count / 1000).toFixed(1)}k`;
@@ -1439,13 +1488,29 @@ export default function (pi: ExtensionAPI) {
           `Running agent: ${agent.name} [${agent.source}${forked ? ', forked' : ', inline'}${selectedModel ? `, model=${selectedModel}` : ''}${selectedThinking ? `, thinking=${selectedThinking}` : ''}]`,
           'info',
         );
+        let lastToolDescription = '';
+        const updateWorkingStatus = (toolDesc?: string) => {
+          if (toolDesc) lastToolDescription = toolDesc;
+          const parts = [agent.name];
+          if (lastToolDescription) parts.push(lastToolDescription);
+          commandUi.setWorkingMessage(parts.join(' · '));
+        };
+        updateWorkingStatus('starting...');
 
         const result = await runAgent(commandCwd, agent.name, task, {
           agentScope,
           resolvedPaths,
           model,
           thinking,
+          onUpdate: () => {
+            // When a turn completes and the agent is thinking about next steps
+            updateWorkingStatus('thinking...');
+          },
+          onToolExecutionStart: (event) => {
+            updateWorkingStatus(describeToolExecution(event));
+          },
         });
+        commandUi.setWorkingMessage();
         const failed = result.exitCode !== 0 || result.stopReason === 'error';
         const output = getFinalText(result).trim();
 

package/extensions/subagent/spawn-utils.ts

@@ -57,6 +57,12 @@ function cleanupTempFiles(
   if (tmpPromptDir) try { fs.rmdirSync(tmpPromptDir); } catch { /* ignore */ }
 }
 
+export interface ToolExecutionStartEvent {
+  toolCallId: string;
+  toolName: string;
+  args: Record<string, unknown>;
+}
+
 export interface SpawnPiAgentOptions {
   cwd: string;
   agentName: string;
@@ -68,6 +74,7 @@ export interface SpawnPiAgentOptions {
   signal?: AbortSignal;
   onMessage?: (msg: Message) => void;
   onToolResult?: (msg: Message) => void;
+  onToolExecutionStart?: (event: ToolExecutionStartEvent) => void;
 }
 
 export interface SpawnPiAgentResult {
@@ -158,6 +165,14 @@ export async function spawnPiAgent(options: SpawnPiAgentOptions): Promise<SpawnP
           result.messages.push(event.message as Message);
           options.onToolResult?.(event.message as Message);
         }
+
+        if (event.type === 'tool_execution_start' && event.toolName) {
+          options.onToolExecutionStart?.({
+            toolCallId: event.toolCallId ?? '',
+            toolName: event.toolName,
+            args: event.args ?? {},
+          });
+        }
       };
 
       proc.stdout.on('data', (data: Buffer) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreki-gg/pi-subagent",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "Subagent tool and direct agent runs for pi — isolated agents, parallel scouts, manager workflows, and bundled prompts",
   "keywords": [
     "pi-package"