@botbotgo/agent-harness 0.0.341 → 0.0.342

package/dist/cli/chat-stream.js

@@ -22,6 +22,8 @@ export async function streamChatMessage(input) {
     let liveRequestAnnotations = [];
     let persistedRequestTreeEventCount = 0;
     let persistedRequestTreeTodoSignature = "";
+    let previousTodoStatuses = new Map();
+    const renderedTodoTransitionLines = new Set();
     const requestTreeRenderThrottleMs = 75;
     let suppressRequestTreeRendering = false;
     let lastStableRequestTreeKey;
@@ -193,6 +195,46 @@ export async function streamChatMessage(input) {
         return true;
     };
     const formatAgentProgressLabel = (agentId) => agentId && agentId.trim().length > 0 ? ` agent:${agentId}` : "";
+    const buildTodoTransitionKey = (todo) => todo.key || todo.id || `content:${todo.content.trim().toLowerCase()}`;
+    const readTerminalTodoTransitionLabel = (status) => {
+        if (status === "completed") {
+            return "completed";
+        }
+        if (status === "failed") {
+            return "failed";
+        }
+        if (status === "cancelled") {
+            return "cancelled";
+        }
+        return null;
+    };
+    const writeTodoTransitionProgress = (snapshot) => {
+        const nextStatuses = new Map();
+        const lines = [];
+        for (const todo of snapshot.plan.items) {
+            const key = buildTodoTransitionKey(todo);
+            nextStatuses.set(key, todo.status);
+            const label = readTerminalTodoTransitionLabel(todo.status);
+            if (!label) {
+                continue;
+            }
+            const previousStatus = previousTodoStatuses.get(key);
+            if (!previousStatus || previousStatus === todo.status) {
+                continue;
+            }
+            const text = `TODO ${label}: ${todo.content}.`;
+            if (renderedTodoTransitionLines.has(text)) {
+                continue;
+            }
+            renderedTodoTransitionLines.add(text);
+            lines.push(`[${formatPerfClock(Date.now())} +${formatElapsed(Date.now())}]${formatAgentProgressLabel(snapshot.agentId)} ${text}\n`);
+        }
+        previousTodoStatuses = nextStatuses;
+        if (lines.length === 0) {
+            return;
+        }
+        writeChatStderr(lines.join(""));
+    };
     const renderContentBlocks = (contentBlocks, agentId) => {
         latestAgentId = agentId || latestAgentId;
         const rendered = contentBlocks
@@ -221,6 +263,9 @@ export async function streamChatMessage(input) {
             latestAgentId = snapshot.agentId || latestAgentId;
             latestSnapshot = snapshot;
             firstSnapshotAt ??= Date.now();
+            if (!input.requestEvents) {
+                writeTodoTransitionProgress(snapshot);
+            }
             if (input.requestEvents && !suppressRequestTreeRendering) {
                 const now = Date.now();
                 const nextTreeKey = buildRequestSnapshotRenderKey(snapshot);
@@ -283,6 +328,9 @@ export async function streamChatMessage(input) {
                 if (wroteContent || wroteRenderableBlocks) {
                     return;
                 }
+                if (renderedTodoTransitionLines.has(delta.text)) {
+                    return;
+                }
                 const progressLine = `[${formatPerfClock(Date.now())} +${formatElapsed(Date.now())}]${formatAgentProgressLabel(delta.agentId)} ${delta.text}\n`;
                 if (input.requestEvents && input.liveRequestTree && !suppressRequestTreeRendering && lastRenderedRequestTree) {
                     liveRequestAnnotations.push(progressLine);

package/dist/package-version.d.ts

@@ -1,2 +1,2 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.341";
+export declare const AGENT_HARNESS_VERSION = "0.0.342";
 export declare const AGENT_HARNESS_RELEASE_DATE = "2026-04-24";

package/dist/package-version.js

@@ -1,2 +1,2 @@
-export const AGENT_HARNESS_VERSION = "0.0.341";
+export const AGENT_HARNESS_VERSION = "0.0.342";
 export const AGENT_HARNESS_RELEASE_DATE = "2026-04-24";

package/dist/runtime/harness/run/stream-run.js

@@ -363,6 +363,32 @@ function summarizePlanState(planState) {
     const suffix = planState.items.length > items.length ? ` | +${planState.items.length - items.length} more` : "";
     return `TODO: ${items.join(" | ")}${suffix}`;
 }
+function summarizePlanStateTerminalTransitions(previousPlanState, nextPlanState) {
+    const previousByKey = new Map((previousPlanState?.items ?? []).map((item) => [normalizePlanItemKey(item), item]));
+    const terminalLabel = (status) => {
+        switch (status) {
+            case "completed":
+                return "completed";
+            case "failed":
+                return "failed";
+            case "cancelled":
+                return "cancelled";
+            default:
+                return null;
+        }
+    };
+    return nextPlanState.items.flatMap((item) => {
+        const label = terminalLabel(item.status);
+        if (!label) {
+            return [];
+        }
+        const previousStatus = previousByKey.get(normalizePlanItemKey(item))?.status;
+        if (previousStatus === item.status) {
+            return [];
+        }
+        return [`TODO ${label}: ${item.content}.`];
+    });
+}
 function createSurfaceCommentary(surfaceItem) {
     const name = normalizeCommentaryText(surfaceItem.name);
     if (!name) {
@@ -574,12 +600,16 @@ export async function* streamHarnessRun(options) {
                     const mergedPlanState = mergePartialPlanState(currentPlanState, upstreamPlanState);
                     const signature = buildPlanStateSignature(mergedPlanState);
                     if (signature !== lastPlanStateSignature && shouldEmitPlanState(currentPlanState, mergedPlanState)) {
+                        const previousPlanState = currentPlanState;
                         planStateVersion = mergedPlanState.version;
                         lastPlanStateSignature = signature;
                         currentPlanState = mergedPlanState;
                         for (const item of await emitPlanStateUpdate(options, currentAgentId, mergedPlanState)) {
                             yield item;
                         }
+                        for (const commentary of summarizePlanStateTerminalTransitions(previousPlanState, mergedPlanState)) {
+                            yield* emitCommentary(commentary);
+                        }
                         const commentary = summarizePlanState(mergedPlanState);
                         if (commentary) {
                             yield* emitCommentary(commentary);
@@ -733,11 +763,15 @@ export async function* streamHarnessRun(options) {
                     const mergedPlanState = mergePartialPlanState(currentPlanState, planState);
                     const signature = buildPlanStateSignature(mergedPlanState);
                     if (signature !== lastPlanStateSignature && shouldEmitPlanState(currentPlanState, mergedPlanState)) {
+                        const previousPlanState = currentPlanState;
                         lastPlanStateSignature = signature;
                         currentPlanState = mergedPlanState;
                         for (const item of await emitPlanStateUpdate(options, currentAgentId, mergedPlanState)) {
                             yield item;
                         }
+                        for (const commentary of summarizePlanStateTerminalTransitions(previousPlanState, mergedPlanState)) {
+                            yield* emitCommentary(commentary);
+                        }
                         const commentary = summarizePlanState(mergedPlanState);
                         if (commentary) {
                             yield* emitCommentary(commentary);
@@ -751,12 +785,16 @@ export async function* streamHarnessRun(options) {
                     const reconciledPlanState = reconcilePlanStateToTerminalStatus(currentPlanState, terminalStructuredStatus, new Date().toISOString());
                     const signature = buildPlanStateSignature(reconciledPlanState);
                     if (signature !== lastPlanStateSignature) {
+                        const previousPlanState = currentPlanState;
                         planStateVersion = reconciledPlanState.version;
                         lastPlanStateSignature = signature;
                         currentPlanState = reconciledPlanState;
                         for (const item of await emitPlanStateUpdate(options, currentAgentId, reconciledPlanState)) {
                             yield item;
                         }
+                        for (const commentary of summarizePlanStateTerminalTransitions(previousPlanState, reconciledPlanState)) {
+                            yield* emitCommentary(commentary);
+                        }
                         const commentary = summarizePlanState(reconciledPlanState);
                         if (commentary) {
                             yield* emitCommentary(commentary);
@@ -816,12 +854,16 @@ export async function* streamHarnessRun(options) {
                 const mergedPlanState = mergePartialPlanState(currentPlanState, finalPlanState);
                 const signature = buildPlanStateSignature(mergedPlanState);
                 if (signature !== lastPlanStateSignature && shouldEmitPlanState(currentPlanState, mergedPlanState)) {
+                    const previousPlanState = currentPlanState;
                     planStateVersion = mergedPlanState.version;
                     lastPlanStateSignature = signature;
                     currentPlanState = mergedPlanState;
                     for (const item of await emitPlanStateUpdate(options, currentAgentId, mergedPlanState)) {
                         yield item;
                     }
+                    for (const commentary of summarizePlanStateTerminalTransitions(previousPlanState, mergedPlanState)) {
+                        yield* emitCommentary(commentary);
+                    }
                     const commentary = summarizePlanState(mergedPlanState);
                     if (commentary) {
                         yield* emitCommentary(commentary);
@@ -834,12 +876,16 @@ export async function* streamHarnessRun(options) {
                 const reconciledPlanState = reconcilePlanStateToTerminalStatus(currentPlanState, terminalStructuredStatus, new Date().toISOString());
                 const signature = buildPlanStateSignature(reconciledPlanState);
                 if (signature !== lastPlanStateSignature) {
+                    const previousPlanState = currentPlanState;
                     planStateVersion = reconciledPlanState.version;
                     lastPlanStateSignature = signature;
                     currentPlanState = reconciledPlanState;
                     for (const item of await emitPlanStateUpdate(options, currentAgentId, reconciledPlanState)) {
                         yield item;
                     }
+                    for (const commentary of summarizePlanStateTerminalTransitions(previousPlanState, reconciledPlanState)) {
+                        yield* emitCommentary(commentary);
+                    }
                     const commentary = summarizePlanState(reconciledPlanState);
                     if (commentary) {
                         yield* emitCommentary(commentary);
@@ -852,12 +898,16 @@ export async function* streamHarnessRun(options) {
             const reconciledPlanState = reconcilePlanStateToTerminalStatus(currentPlanState, "completed", new Date().toISOString());
             const signature = buildPlanStateSignature(reconciledPlanState);
             if (signature !== lastPlanStateSignature) {
+                const previousPlanState = currentPlanState;
                 planStateVersion = reconciledPlanState.version;
                 lastPlanStateSignature = signature;
                 currentPlanState = reconciledPlanState;
                 for (const item of await emitPlanStateUpdate(options, currentAgentId, reconciledPlanState)) {
                     yield item;
                 }
+                for (const commentary of summarizePlanStateTerminalTransitions(previousPlanState, reconciledPlanState)) {
+                    yield* emitCommentary(commentary);
+                }
                 const commentary = summarizePlanState(reconciledPlanState);
                 if (commentary) {
                     yield* emitCommentary(commentary);
@@ -916,12 +966,16 @@ export async function* streamHarnessRun(options) {
                 const reconciledPlanState = reconcilePlanStateToTerminalStatus(currentPlanState, terminalStructuredStatus, new Date().toISOString());
                 const signature = buildPlanStateSignature(reconciledPlanState);
                 if (signature !== lastPlanStateSignature) {
+                    const previousPlanState = currentPlanState;
                     planStateVersion = reconciledPlanState.version;
                     lastPlanStateSignature = signature;
                     currentPlanState = reconciledPlanState;
                     for (const item of await emitPlanStateUpdate(options, currentAgentId, reconciledPlanState)) {
                         yield item;
                     }
+                    for (const commentary of summarizePlanStateTerminalTransitions(previousPlanState, reconciledPlanState)) {
+                        yield* emitCommentary(commentary);
+                    }
                     const commentary = summarizePlanState(reconciledPlanState);
                     if (commentary) {
                         yield* emitCommentary(commentary);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.341",
+  "version": "0.0.342",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",