agentfootprint-lens 0.42.0 → 0.43.0

package/README.md

@@ -111,6 +111,20 @@ Lens watches agentfootprint's typed event stream — `agentfootprint.agent.*`,
 of the 65-type registry. You never wire events yourself; `recorder.observe()`
 subscribes to all of them.
 
+**A long tool call is no longer a silence.** When a tool reports from inside
+its own `execute` with `ctx.progress(payload)` (agentfootprint 9.52+), each
+report lands in the stream between that call's start and its end:
+
+```
+`walk_graph` reported progress (iteration 1): {"hop":1,"of":3,"node":"svc-a"}
+```
+
+The three identity fields are stamped by the framework, so the line states them
+as facts. The payload is the tool author's own data — the Lens shows a preview
+of it rather than guessing at a shape it was never promised, and says so when
+it had to cut one short. A tool that never calls `ctx.progress` files nothing,
+and nothing here invents a report it did not make.
+
 ---
 
 ## Multiple watchers, one agent

package/dist/{chunk-YQXVXNXK.js → chunk-CWKOGPOJ.js}

@@ -9,7 +9,7 @@ import {
   selectHops,
   selectToolChoiceCall,
   structureGraphFromRunner
-} from "./chunk-JE37MDVV.js";
+} from "./chunk-VBMVWQUO.js";
 import {
   MODE_PALETTES,
   T,
@@ -4172,4 +4172,4 @@ export {
   WhereFrom,
   Lens
 };
-//# sourceMappingURL=chunk-YQXVXNXK.js.map
+//# sourceMappingURL=chunk-CWKOGPOJ.js.map

package/dist/{chunk-VKBQYD6I.js → chunk-UWN5VKQ2.js}

@@ -1,7 +1,7 @@
 import {
   formatBytes,
   structureGraphFromRunner
-} from "./chunk-JE37MDVV.js";
+} from "./chunk-VBMVWQUO.js";
 
 // src/core/buildStepGraphFromSnapshot.ts
 function buildStepGraphFromSnapshot(snapshot) {
@@ -1189,4 +1189,4 @@ export {
   decisionSentence,
   isConsentDecision
 };
-//# sourceMappingURL=chunk-VKBQYD6I.js.map
+//# sourceMappingURL=chunk-UWN5VKQ2.js.map

package/dist/{chunk-JE37MDVV.js → chunk-VBMVWQUO.js}

@@ -1464,6 +1464,36 @@ function humanizeEvidenceChecked(p) {
   }
 }
 
+// src/core/humanizeToolProgress.ts
+var PREVIEW_LIMIT = 120;
+function previewProgressPayload(payload) {
+  if (payload === void 0) return null;
+  let text;
+  if (typeof payload === "string") {
+    text = payload;
+  } else {
+    try {
+      const json = JSON.stringify(payload);
+      if (json === void 0) return null;
+      text = json;
+    } catch {
+      return "(payload could not be shown)";
+    }
+  }
+  if (text.length <= PREVIEW_LIMIT) return text;
+  return `${text.slice(0, PREVIEW_LIMIT)}\u2026 (truncated; ${text.length - PREVIEW_LIMIT} more chars)`;
+}
+function humanizeToolProgress(payload) {
+  const tool = payload.toolName !== void 0 ? `\`${payload.toolName}\`` : "A tool";
+  const iter = typeof payload.iteration === "number" && payload.iteration > 0 ? ` (iteration ${payload.iteration})` : "";
+  const preview = previewProgressPayload(payload.payload);
+  return preview === null ? `${tool} reported progress${iter}.` : `${tool} reported progress${iter}: ${preview}`;
+}
+function humanizeToolProgressTeaching(payload) {
+  const tool = payload.toolName !== void 0 ? `The \`${payload.toolName}\` tool` : "A tool";
+  return `${tool} reported progress while it was still running.`;
+}
+
 // src/core/humanizeArtifacts.ts
 var ticket = (ref, kind, bytes) => `${ref ?? "art_?"} [${kind ?? "?"} \xB7 ${formatBytes(bytes ?? 0)}]`;
 function humanizeArtifactMinted(p) {
@@ -1552,6 +1582,12 @@ var defaultHumanizer = (event) => {
       return `Model replied in ${event.payload.durationMs}ms (${event.payload.usage.input}+${event.payload.usage.output} tokens, ${event.payload.toolCallCount} tool calls, stop: ${event.payload.stopReason}).`;
     case "agentfootprint.stream.tool_start":
       return `Calling tool "${event.payload.toolName}" with ${JSON.stringify(event.payload.args)}.`;
+    // One report from INSIDE a still-running tool call (agentfootprint
+    // 9.52.0). It arrives between this call's tool_start and its tool_end, so
+    // the stream reads as the call speaking mid-flight. See humanizeToolProgress
+    // for why the author's payload is previewed rather than interpreted.
+    case "agentfootprint.stream.tool_progress":
+      return humanizeToolProgress(event.payload);
     case "agentfootprint.stream.tool_end":
       return `Tool "${event.payload.toolCallId}" returned in ${event.payload.durationMs}ms${event.payload.error === true ? " (error)" : ""}.`;
     case "agentfootprint.stream.token":
@@ -1626,6 +1662,9 @@ function makeTeachingHumanizer(options = {}) {
   const templates = options.commentaryTemplates ? { ...defaultCommentaryTemplates, ...options.commentaryTemplates } : defaultCommentaryTemplates;
   const ctx = { appName, getToolDescription };
   return (event) => {
+    if (event.type === "agentfootprint.stream.tool_progress") {
+      return humanizeToolProgressTeaching(event.payload);
+    }
     const key = selectCommentaryKey(event);
     if (key === null) return null;
     if (key === void 0) return defaultHumanizer(event);
@@ -2765,4 +2804,4 @@ export {
   structureGraphFromSpec,
   cursorProvenance
 };
-//# sourceMappingURL=chunk-JE37MDVV.js.map
+//# sourceMappingURL=chunk-VBMVWQUO.js.map