@crouton-kit/crouter 0.3.27 → 0.3.28

package/dist/pi-extensions/canvas-stophook.js

@@ -36,13 +36,24 @@ import { personaDrift, commitPersonaAck } from '../core/runtime/persona.js';
 import { reviveInPlace } from '../core/runtime/revive.js';
 import { handleNewSession, markCleanExitDone } from '../core/runtime/reset.js';
 import { focusOf, handFocusToManager, tearDownNode, closeFocusToShell } from '../core/runtime/placement.js';
+/** Condense a tool call into one short line for the activity cue. Picks the most
+ *  identifying arg (command / path / pattern / description), collapses whitespace,
+ *  and hard-caps the length so a giant bash command can't bloat telemetry.json. */
+const ACTIVITY_CAP = 80;
+function summarizeActivity(toolName, args) {
+    const a = (args ?? {});
+    const pick = (v) => (typeof v === 'string' ? v : '');
+    const detail = pick(a['command']) || pick(a['path']) || pick(a['file_path']) || pick(a['pattern']) || pick(a['description']) || pick(a['prompt']);
+    const line = (detail !== '' ? `${toolName}: ${detail}` : toolName).replace(/\s+/g, ' ').trim();
+    return line.length > ACTIVITY_CAP ? line.slice(0, ACTIVITY_CAP) : line;
+}
 /**
  * Merge accumulated token counts into nodes/<nodeId>/job/telemetry.json.
  * Creates the directory when it doesn't yet exist. Best-effort; never throws.
  * `contextTokens` is the live window gauge for THIS turn; when null (pi can't
  * size the window yet) the last recorded value is preserved.
  */
-function flushTelemetry(jobDirPath, tokensIn, tokensOut, model, contextTokens) {
+function flushTelemetry(jobDirPath, tokensIn, tokensOut, model, contextTokens, activity) {
     try {
         if (!existsSync(jobDirPath))
             mkdirSync(jobDirPath, { recursive: true });
@@ -62,6 +73,7 @@ function flushTelemetry(jobDirPath, tokensIn, tokensOut, model, contextTokens) {
             tokens_in: tokensIn,
             tokens_out: tokensOut,
             context_tokens: contextTokens ?? existing.context_tokens,
+            last_activity: activity ?? existing.last_activity,
             model: model !== '' ? model : (existing.model ?? ''),
             updated_at: new Date().toISOString(),
         };
@@ -205,6 +217,10 @@ export function registerCanvasStophook(pi) {
     let totalIn = 0;
     let totalOut = 0;
     let model = '';
+    // Last live context-window gauge + last tool summary, tracked across handlers so
+    // a tool_execution_start flush (activity-only) preserves the latest token figure.
+    let lastContext = null;
+    let lastActivity = null;
     // Context-size steering. As input context grows we nudge the node once per
     // band on an escalating, persona-specific schedule (see steerBand/steerNote).
     // The node's (lifecycle, mode) persona is read at fire time, since a terminal
@@ -294,6 +310,18 @@ export function registerCanvasStophook(pi) {
         catch { /* best-effort */ }
     });
     // ---------------------------------------------------------------------------
+    // tool_execution_start — capture the live "what is it doing" cue. Writes the
+    // one-line tool summary to telemetry.json so out-of-process readers (the nav
+    // chrome) show it inline without a second file or any extra read on their side.
+    // ---------------------------------------------------------------------------
+    pi.on('tool_execution_start', (event) => {
+        try {
+            lastActivity = summarizeActivity(String(event?.toolName ?? ''), event?.args);
+            flushTelemetry(jobDirPath, totalIn, totalOut, model, lastContext, lastActivity);
+        }
+        catch { /* best-effort */ }
+    });
+    // ---------------------------------------------------------------------------
     // session_shutdown — clean exit → done.
     //
     // pi hands us a reason as a session tears down. Only 'quit' is a node-ending
@@ -347,8 +375,10 @@ export function registerCanvasStophook(pi) {
                 contextTokens = t;
         }
         catch { /* gauge unavailable this turn */ }
+        if (contextTokens !== null)
+            lastContext = contextTokens;
         // Fire-and-forget: flushTelemetry uses synchronous fs writes and never throws.
-        flushTelemetry(jobDirPath, totalIn, totalOut, model, contextTokens);
+        flushTelemetry(jobDirPath, totalIn, totalOut, model, contextTokens, lastActivity);
         // Context-size steering: fire the current band once, with lifecycle-specific
         // guidance (lifecycle is read live — a terminal worker may have promoted to
         // resident since launch).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/crouter",
-  "version": "0.3.27",
+  "version": "0.3.28",
   "description": "crtr — fast access to skills, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",