samagotchi 0.22.0 → 0.24.0

data/lib/samagotchi/tools/task_runtime.rb

@@ -44,7 +44,8 @@ module Samagotchi
 
         FileUtils.mkdir_p(task_dir)
 
-        output_io = File.open(output_path, "a")
+        # The child writes to it; the ensure below closes the parent's copy.
+        output_io = File.open(output_path, "a") # rubocop:disable Style/FileOpen
         output_io.sync = true
 
         wrapped_command = wrapped_shell_command(normalized_command, exit_code_path)
@@ -80,7 +81,7 @@ module Samagotchi
 
         write_record(record)
         [record, nil]
-      rescue => e
+      rescue StandardError => e
         [nil, "Error: #{e.message}"]
       ensure
         output_io&.close
@@ -124,7 +125,7 @@ module Samagotchi
         return [nil, "Error: task not found: #{task_id}"] unless record
 
         [refresh_record(record), nil]
-      rescue => e
+      rescue StandardError => e
         [nil, "Error: #{e.message}"]
       end
 
@@ -157,9 +158,7 @@ module Samagotchi
         end
 
         deadline = monotonic_time + STOP_GRACE_SEC
-        while process_alive?(pid) && monotonic_time < deadline
-          sleep(STOP_POLL_INTERVAL_SEC)
-        end
+        sleep(STOP_POLL_INTERVAL_SEC) while process_alive?(pid) && monotonic_time < deadline
 
         if process_alive?(pid)
           begin
@@ -176,7 +175,7 @@ module Samagotchi
         write_record(updated)
 
         [updated, nil]
-      rescue => e
+      rescue StandardError => e
         [nil, "Error: #{e.message}"]
       end
 
@@ -278,7 +277,7 @@ module Samagotchi
         return nil if rubyopt.empty?
 
         filtered = rubyopt.split(/\s+/).reject do |arg|
-          arg == "-rbundler/setup" || arg.match?(/\A-r.*bundler\/setup\z/)
+          arg == "-rbundler/setup" || arg.match?(%r{\A-r.*bundler/setup\z})
         end
         return nil if filtered.empty?
 
@@ -318,7 +317,7 @@ module Samagotchi
         return nil if path.to_s.empty? || !File.exist?(path)
 
         Integer(File.read(path).strip, exception: false)
-      rescue => _e
+      rescue StandardError => _e
         nil
       end
 

data/lib/samagotchi/tools/task_stop.rb

@@ -21,7 +21,7 @@ module Samagotchi
           "stop_reason: #{record["stop_reason"]}",
           "output_path: #{record.fetch("output_path")}"
         ].join("\n")
-      rescue => e
+      rescue StandardError => e
         "Error: #{e.message}"
       end
     end

data/lib/samagotchi/tools/task_wait.rb

@@ -1,4 +1,3 @@
-
 # frozen_string_literal: true
 
 require_relative "task_runtime"
@@ -48,16 +47,17 @@ module Samagotchi
           return cancelled_response(task_id, tail_lines, started) if cancelled.call
 
           break if monotonic_time > deadline
+
           sleep(POLL_INTERVAL)
         end
 
         # Timeout reached — do one final refresh to capture the latest status
-        refreshed, _ = TaskRuntime.get_record(task_id)
+        refreshed, = TaskRuntime.get_record(task_id)
         return format_response(refreshed) unless refreshed.fetch("status") == "running"
 
         output_tail = TaskRuntime.output_tail_lines(refreshed.fetch("output_path"), tail_lines)
         format_response(refreshed, wait_result: "timeout", output_tail: output_tail)
-      rescue => e
+      rescue StandardError => e
         "Error: #{e.message}"
       end
 
@@ -125,4 +125,3 @@ module Samagotchi
     end
   end
 end
-

data/lib/samagotchi/tools/web_fetch.rb

@@ -1,4 +1,3 @@
-
 # frozen_string_literal: true
 
 require "net/http"
@@ -42,7 +41,7 @@ module Samagotchi
         "Error: could not resolve hostname"
       rescue Timeout::Error
         "Error: request timed out after #{TIMEOUT_SEC}s"
-      rescue => e
+      rescue StandardError => e
         "Error: #{e.message}"
       end
 
@@ -59,7 +58,7 @@ module Samagotchi
           IPAddr.new("::1/128"),
           IPAddr.new("fc00::/7"),
           IPAddr.new("fe80::/10"),
-          IPAddr.new("::ffff:0:0/96"),
+          IPAddr.new("::ffff:0:0/96")
         ]
 
         # Try to parse host as IP directly
@@ -160,4 +159,3 @@ module Samagotchi
     end
   end
 end
-

data/lib/samagotchi/tools/write.rb

@@ -22,7 +22,7 @@ module Samagotchi
         FileUtils.mkdir_p(File.dirname(path))
         File.write(path, content)
         "Written #{content.bytesize} bytes to #{path}"
-      rescue => e
+      rescue StandardError => e
         "Error: #{e.message}"
       end
     end

data/lib/samagotchi/turn_flow.rb

@@ -27,10 +27,10 @@ module Samagotchi
       return [:resume, nil] if normalized.empty?
 
       lowered = normalized.downcase
-      return [:resume, nil] if lowered == CONTINUE_COMMAND || lowered == "yes" || lowered == "y"
-      return [:abort, nil] if lowered == "no" || lowered == "n"
+      return [:resume, nil] if [CONTINUE_COMMAND, "yes", "y"].include?(lowered)
+      return [:abort, nil] if %w[no n].include?(lowered)
 
-      reason_match = normalized.match(/\A(?:no|n)\s*[,:\-]\s*(.+)\z/i)
+      reason_match = normalized.match(/\A(?:no|n)\s*[,:-]\s*(.+)\z/i)
       if reason_match
         reason = reason_match[1].to_s.strip
         return [:abort, nil] if reason.empty?
@@ -220,11 +220,11 @@ module Samagotchi
       lines << "- original_prompt: #{original_prompt.to_s.empty? ? "(unavailable)" : original_prompt}"
 
       tool_trace = context ? Array(context[:tool_trace]) : []
-      if tool_trace.empty?
-        lines << "- interrupted_tools: (none)"
-      else
-        lines << "- interrupted_tools: #{tool_trace.join("; ")}"
-      end
+      lines << if tool_trace.empty?
+                 "- interrupted_tools: (none)"
+               else
+                 "- interrupted_tools: #{tool_trace.join("; ")}"
+               end
 
       model_intent = context && context[:last_model_intent]
       lines << "- last_model_intent: #{model_intent.to_s.empty? ? "(unavailable)" : model_intent}"

data/lib/samagotchi/turn_note.rb

@@ -98,7 +98,11 @@ module Samagotchi
     # emptyAnswerLine words it the same).
     def empty_answer_line(retries)
       count = retries.to_i
-      after = count.positive? ? " (after #{count} #{count == 1 ? "retry" : "retries"})" : ""
+      after = if count.positive?
+                " (after #{count} #{count == 1 ? "retry" : "retries"})"
+              else
+                ""
+              end
       "no answer: the model returned nothing#{after}"
     end
 

data/lib/samagotchi/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Samagotchi
-  VERSION = "0.22.0"
+  VERSION = "0.24.0"
   # Sent as the User-Agent of every HTTP request chi makes.
   USER_AGENT = "chi/#{VERSION}"
 end

data/lib/samagotchi/vision_support.rb

@@ -45,7 +45,7 @@ module Samagotchi
       marker.is_a?(String) && !marker.empty? ? marker : nil
     end
 
-    def self.configured(target, entry, models, names)
+    def self.configured(_target, entry, models, names)
       models ||= begin
         ConfigFile.model_settings
       rescue StandardError
@@ -58,7 +58,7 @@ module Samagotchi
       Answer.new(value: entry.vision, reason: entry.vision ? nil : "hosts.#{entry.name} sets vision: false")
     end
 
-    def self.native(target, entry, profile, trust_config:)
+    def self.native(target, _entry, profile, trust_config:)
       client = target.client
       transport = client.transport.name
       return no("#{transport} hosts take no images (only llama.cpp does)") unless transport == :llama_cpp

data/lib/samagotchi/waiting_steer.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Samagotchi
+  # A message for the running turn that may cut its generation but came too
+  # early (the generation hadn't streamed only thinking for long enough):
+  # it waits here until the thinking passes steer.cut_after (the Engine
+  # checks on each thinking chunk), or until a drain hands the message to
+  # the model at a boundary, or the turn ends. One cut covers every waiting
+  # message: the first one's source names it.
+  #
+  # The epoch counts the drains that took input. A caller reads it before
+  # it queues its message; a drain after that may have taken the message
+  # already, so the message doesn't wait (it may be in the model's prompt).
+  # Written from the UIs' threads and the turn's; its own Mutex.
+  class WaitingSteer
+    def initialize
+      @mutex = Mutex.new
+      @source = nil
+      @epoch = 0
+    end
+
+    # @return [Integer] the drains that took input so far
+    def epoch
+      @mutex.synchronize { @epoch }
+    end
+
+    # +source+'s message waits for a cut, unless a drain took input since
+    # +epoch+. Returns whether it waits.
+    def wait!(source, epoch: nil)
+      @mutex.synchronize do
+        next false if epoch && epoch != @epoch
+
+        @source ||= source.to_s
+        true
+      end
+    end
+
+    def waiting?
+      @mutex.synchronize { !@source.nil? }
+    end
+
+    # The waiting source, taken (nil when none waits).
+    def take
+      @mutex.synchronize do
+        source = @source
+        @source = nil
+        source
+      end
+    end
+
+    # A drain took input: what waited is delivered.
+    def delivered!
+      @mutex.synchronize do
+        @epoch += 1
+        @source = nil
+      end
+    end
+
+    # The turn ended, or a cut happened: nothing waits.
+    def clear!
+      @mutex.synchronize { @source = nil }
+    end
+  end
+end

data/lib/samagotchi/web/app.rb

@@ -157,6 +157,7 @@ module Samagotchi
         req = Rack::Request.new(env)
         return forbidden unless local_host_header?(env)
         return cross_origin if cross_site?(env)
+
         if @lan && !LOOPBACK_PEERS.include?(env["REMOTE_ADDR"].to_s)
           denied = token_gate(req)
           return denied if denied
@@ -506,13 +507,16 @@ module Samagotchi
 
       def sanitize_limit(val)
         return nil if val.nil? || val.to_s.strip.empty?
+
         n = val.to_i
         return nil if n <= 0
+
         [n, 1000].min
       end
 
       def sanitize_offset(val)
         return 0 if val.nil? || val.to_s.strip.empty?
+
         n = val.to_i
         n.positive? ? n : 0
       end
@@ -522,6 +526,7 @@ module Samagotchi
         unless body.is_a?(Hash)
           return error_response(400, "invalid_json", "invalid JSON body")
         end
+
         prompt = body["prompt"] || body[:prompt]
         # idle: a session with no first turn, for a first message with
         # images (the page uploads them into it, then sends the turn).
@@ -529,6 +534,7 @@ module Samagotchi
         if prompt.to_s.strip.empty? && !idle
           return error_response(400, "missing_fields", "prompt is required")
         end
+
         # dir: the folder the chat starts in (the page's scope); without it,
         # the server's own cwd.
         dir, error = scope_dir(body["dir"])
@@ -891,11 +897,13 @@ module Samagotchi
         unless body.is_a?(Hash)
           return error_response(400, "invalid_json", "invalid JSON body")
         end
+
         prompt = body["prompt"] || body[:prompt]
         client_id = body["client_id"] || body[:client_id]
         if prompt.to_s.strip.empty?
           return error_response(400, "missing_fields", "prompt is required")
         end
+
         images = turn_images(id, body["images"])
         return error_response(400, "bad_images", images) if images.is_a?(String)
 
@@ -1173,7 +1181,7 @@ module Samagotchi
         lambda do |io|
           query = req.query_string.to_s.empty? ? "" : "?#{req.query_string}"
           body = ProxyStreamBody.new(host: DEFAULT_HOST, port: port, session_id: id, query: query, headers: req.env,
-                                    server_running: @server_running)
+                                     server_running: @server_running)
           body.each { |chunk| io.write(chunk) }
         rescue Errno::EPIPE, Errno::ECONNRESET, IOError
           nil # client went away — end the stream quietly
@@ -1249,7 +1257,7 @@ module Samagotchi
       def serve_static(req)
         # Serve files under public_dir for /assets/* and bare paths
         rel = req.path_info.sub(%r{\A/(assets|public)/}, "")
-        rel = req.path_info.sub(%r{\A/}, "") if rel == req.path_info
+        rel = req.path_info.delete_prefix("/") if rel == req.path_info
         # Prevent directory traversal
         rel = rel.split("/").reject { |p| p == ".." || p.empty? }.join("/")
         full = File.join(@public_dir, rel)
@@ -1483,7 +1491,7 @@ module Samagotchi
 
           norm_role = role == "model" ? "assistant" : role
           # normalize assistant vs model, keep user as is
-          norm_role = "assistant" if norm_role == "assistant" || norm_role == "model"
+          norm_role = "assistant" if %w[assistant model].include?(norm_role)
           norm_role = "user" if norm_role == "user"
           next unless %w[user assistant].include?(norm_role)
 
@@ -1644,7 +1652,6 @@ module Samagotchi
         json_response(status, { error: code, detail: detail })
       end
 
-
       def not_found(path:)
         error_response(404, "not_found", "not found: #{path}")
       end
@@ -1740,12 +1747,12 @@ module Samagotchi
           @server_running = server_running
         end
 
-        def each(&block)
+        def each(&)
           # Forward the browser's auto-reconnect cursor: the bridge prefers the
           # Last-Event-ID header over ?from_seq, and the reconnect URL carries a
           # stale initial cursor — without this the bridge would replay content
           # already delivered (duplicate bubbles).
-          @client.stream(query: @query, last_event_id: @headers["HTTP_LAST_EVENT_ID"], running: @server_running, &block)
+          @client.stream(query: @query, last_event_id: @headers["HTTP_LAST_EVENT_ID"], running: @server_running, &)
         end
       end
     end

data/lib/samagotchi/web/markdown_renderer.rb

@@ -34,7 +34,7 @@ module Samagotchi
 
         html = Commonmarker.to_html(markdown.to_s, options: {
           render: { escape: true }, # escape raw HTML from source; highlighter output is still emitted
-          extension: { header_ids: nil },
+          extension: { header_ids: nil }
         })
         return nil unless html
 
@@ -71,6 +71,7 @@ module Samagotchi
       def sanitize_attributes(node)
         node.attribute_nodes.each do |attribute|
           next if allowed_attribute?(node, attribute.name)
+
           node.remove_attribute(attribute.name)
         end
         return unless node.name == "a"

data/lib/samagotchi/web/message_parts.rb

@@ -3,6 +3,7 @@
 require_relative "../model_profile"
 require_relative "../tool_call_parser"
 require_relative "../tool_activity"
+require_relative "../tool_view"
 require_relative "../llm/native_tool_normalizer"
 require_relative "../tools/builtins"
 require_relative "../image_store"
@@ -158,6 +159,10 @@ module Samagotchi
         part = { tool: name, params: params.to_s }
         title = ToolActivity.tool_title(name, call, cwd: cwd)
         part[:title] = title if title
+        # Built from the saved call (never saved itself), so older sessions
+        # get it too.
+        view = ToolView.for(name, call)&.to_h
+        part[:view] = view if view
         part[:label] = label if label.is_a?(String) && !label.empty?
         unless output.nil?
           part[:output] = output.length > OUTPUT_MAX ? output[0, OUTPUT_MAX] : output

data/lib/samagotchi/web/public/activity.js

@@ -50,6 +50,7 @@ export function addStarted(model, event = {}) {
     row.label = event.label || row.label;
     row.params = event.params || row.params;
     row.title = event.title || row.title;
+    row.view = event.view || row.view;
     return { row, created: false };
   }
   row = {
@@ -63,6 +64,9 @@ export function addStarted(model, event = {}) {
     // project-relative path, a command without its "cd … &&"); rows show it
     // in place of the params when there is one.
     title: event.title || null,
+    // The call's full arguments for the expanded row and the hovers (the
+    // server's ToolView: an execute/task_create's command, its cwd).
+    view: event.view || null,
     status: ROW_STATUS.RUNNING,
     output: "",
     output_truncated: false,
@@ -87,6 +91,7 @@ export function addCompleted(model, event = {}) {
       label: event.label,
       params: event.activity?.params || "",
       title: event.activity?.title,
+      view: event.view,
     });
     row = synthesized.row;
   }

data/lib/samagotchi/web/public/app.js

@@ -45,7 +45,7 @@ import {
   appendAboveLiveTiming, cancelLineText, elapsedSince, formatDuration, mergeTiming, normalizeTiming, turnTimingText,
 } from "./timing.js";
 import { DONE_MS, applyInitEvent, dropDone, initRowHtml, newInitTasks, seedInitTasks } from "./init_row.js";
-import { clientLabel, commandView, displayWait, dropEarlyRestores, emptyAnswerLine, emptyRetryLine, hookNoticeLabel, initWaitLine, isOwn, sessionCommandLine, keepEarlyRestore, newClientId, noticeLine, promptOps, reminderText, restoreAction, composerAfterAck, restoreOnAck, replaysDrawnTurn, retryStatusLine, snapshotEvents, startPageReplyOrHint, turnOutput, unknownCommandHint, webLocalReply, workerGoneText } from "./turn_events.js";
+import { clientLabel, commandView, displayWait, dropEarlyRestores, emptyAnswerLine, emptyRetryLine, hookNoticeLabel, initWaitLine, isOwn, sessionCommandLine, keepEarlyRestore, newClientId, noticeLine, promptOps, reminderText, restoreAction, composerAfterAck, restoreOnAck, replaysDrawnTurn, retryStatusLine, snapshotEvents, steerCutLine, startPageReplyOrHint, turnOutput, unknownCommandHint, webLocalReply, workerGoneText } from "./turn_events.js";
 
 const $ = (s) => document.querySelector(s);
 const topStripEl = $("#topStrip");
@@ -1861,6 +1861,7 @@ const streamHandlers = {
   // The loop asks again after an empty answer: a row of the empty step
   // (a reload puts it back from the snapshot's cards).
   empty_answer_retry: (data) => { turnDom.notice({ line: emptyRetryLine(data) }); },
+  steer_cut: (data) => { turnDom.notice({ line: steerCutLine(data) }); },
   // The provider is asked again after an error, or the turn waits for
   // plugins' setup: a note on the live timing line until it streams.
   generation_retrying: (data) => setLiveTurnNote(retryStatusLine(data)),

data/lib/samagotchi/web/public/command_view.js

@@ -0,0 +1,28 @@
+// A tool call's full command in a richer UI than the TUI's params line:
+// the server's view (ToolView: an execute/task_create's command uncut up to
+// 8,000 chars, the call's cwd: argument). Pure HTML builders, shared by the
+// live row (turn_view.js fillActivityRow) and the reloaded one
+// (reloadRowHtml), so the two can't differ.
+import { copyButtonHtml } from "./copy.js";
+import { escapeHtml } from "./format.js";
+
+// What a row's title hovers: the full command when the call has one,
+// else the params line when the row shows a title in its place.
+export function rowHover(row) {
+  if (row?.view?.command) return row.view.command;
+  return row?.title && row?.params ? row.params : "";
+}
+
+// The expanded row's command block: "in <cwd>" when the call gave one (as
+// given: execute's may be relative to the project root), the command as
+// written (whitespace kept, its own scroll), a copy button, and a line
+// saying how much a cut command left out. "" for a call without a view.
+export function commandBlockHtml(view) {
+  const command = view?.command;
+  if (!command) return "";
+  const cwd = view.cwd ? `<div class="activity-command-cwd">in <span>${escapeHtml(view.cwd)}</span></div>` : "";
+  const cut = view.truncated
+    ? `<div class="activity-command-cut">… (${command.length.toLocaleString("en-US")} of ${Number(view.chars || 0).toLocaleString("en-US")} chars)</div>`
+    : "";
+  return `<div class="activity-command code-wrap">${cwd}<pre><code>${escapeHtml(command)}</code></pre>${copyButtonHtml("code")}${cut}</div>`;
+}

data/lib/samagotchi/web/public/copy.js

@@ -88,6 +88,13 @@ const ICON = '<svg viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"
 const BUBBLES = ".bubble.output:not(.streaming), .bubble.user";
 const CODE = ".bubble.output pre";
 
+// The button as markup, for a builder that returns HTML (a tool row's
+// command block, command_view.js); the same click handler answers it.
+export function copyButtonHtml(kind) {
+  const title = kind === "code" ? "Copy code" : "Copy";
+  return `<button type="button" class="copy-btn copy-${kind}" title="${title}" aria-label="${title}">${ICON}</button>`;
+}
+
 function makeButton(doc, kind) {
   const btn = doc.createElement("button");
   btn.type = "button";

data/lib/samagotchi/web/public/index.html

@@ -134,10 +134,18 @@ main{flex:1;display:flex;flex-direction:column;gap:16px;padding:16px;overflow:au
 .activity-diff>summary{cursor:pointer;font-size:12px;color:var(--text-muted);width:max-content;font-variant-numeric:tabular-nums}
 .activity-diff>summary:hover{color:var(--text-2)}
 .activity-diff[open]>summary{margin-bottom:4px}
+/* An execute/task_create's full command, above its output and lined up with it: as written, its own scroll. */
+.activity-row>.activity-command{flex:1 1 100%;min-width:0;margin:4px 0 2px 60px}
+.activity-command pre{margin:0;max-height:160px;overflow:auto;white-space:pre-wrap;word-break:break-word;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px;line-height:1.45;color:var(--text-2);background:var(--bg-inset);border:1px solid var(--border);border-radius:6px;padding:6px 34px 6px 8px}
+.activity-command-cwd,.activity-command-cut{font-size:11px;color:var(--text-faint)}
+.activity-command-cwd{margin-bottom:2px}
+.activity-command-cwd>span{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--text-muted)}
+.activity-command-cut{margin-top:2px}
 @media(max-width:600px){
   .activity-params{flex:1 1 0}
   .activity-output{margin-left:0}
   .activity-diff{margin-left:0}
+  .activity-row>.activity-command{margin-left:0}
 }
 .bubble.thinking{border-left:3px solid var(--think);background:color-mix(in srgb,var(--think) 6%,var(--bg-panel));padding:8px 12px}
 .bubble.thinking:not([open]),.bubble.activity:not([open]){padding:3px 10px;background:transparent;border-color:transparent;align-self:flex-start;border-radius:6px;transition:background .12s ease}

data/lib/samagotchi/web/public/stage_model.js

@@ -78,6 +78,12 @@ function rowTitle(row) {
   return row.title || row.params || "";
 }
 
+// A slot's full command (the row's view), for its hover; none for a tool
+// without one.
+function withCommand(slot, row) {
+  return row.view?.command ? { ...slot, command: row.view.command } : slot;
+}
+
 // While the first step has no thinking and no tool rows the turn is plain:
 // its text streams in the stage's answer slot, as the turn view's
 // chrome-less block streams like a bubble.
@@ -98,9 +104,10 @@ const NO_ANSWER = "no answer";
 //   headline the newest narration sentence (+narration+, the view's sentence
 //            feed), else the newest thinking one (+thinking+, its ticker),
 //            else "…";
-//   tool     the running call ({name, title, kind}) or null;
+//   tool     the running call ({name, title, kind}, and command: its full
+//            command when it has one) or null;
 //   trail    the last three finished calls, newest last (a file's title
-//            without its dir);
+//            without its dir; command as for tool);
 //   ticks    one per call: {kind, status, step (the gen's index)}.
 // +pending+: a card waits for the user; +ended+: the turn's end kind;
 // +emptyAnswer+: a completed turn ended with no answer
@@ -123,13 +130,13 @@ export function liveSlots(turn, { narration = "", thinking = "", pending = false
   else if (thinking) headline = { text: thinking, thinking: true };
   const trail = rows.filter(({ row }) => row.status !== "running").slice(-TRAIL).map(({ row }) => {
     const title = rowTitle(row);
-    return { name: toolName(row), title: FILE_TOOLS.has(row.tool) ? title.split("/").pop() : title, status: row.status };
+    return withCommand({ name: toolName(row), title: FILE_TOOLS.has(row.tool) ? title.split("/").pop() : title, status: row.status }, row);
   });
   return {
     phase,
     step: ended ? gens.filter((g) => !g.answer || g.thinking || g.tools.length).length : gens.length,
     headline,
-    tool: running ? { name: toolName(running), title: rowTitle(running), kind: toolKind(running.tool) } : null,
+    tool: running ? withCommand({ name: toolName(running), title: rowTitle(running), kind: toolKind(running.tool) }, running) : null,
     trail,
     ticks: rows.map(({ row, step }) => ({ kind: toolKind(row.tool), status: row.status, step })),
   };

data/lib/samagotchi/web/public/stage_view.js

@@ -195,6 +195,7 @@ export function createStageView({ historyEl, appendToHistory, isNearBottom: hist
     const elapsed = endKind ? formatDuration(endedAt - startedAt) : "";
     chipLabel.textContent = `${slots.step} step${slots.step === 1 ? "" : "s"} · ${calls} tool call${calls === 1 ? "" : "s"}${elapsed ? ` · ${elapsed}` : ""}`;
     miniTool.textContent = collapsed && slots.tool ? `${slots.tool.name} ${slots.tool.title}` : "";
+    miniTool.title = (collapsed && slots.tool?.command) || "";
 
     live.hidden = plain || !!endKind;
     cloud.hidden = !blockEl || blockEl.parentNode !== cloudBody;
@@ -222,7 +223,7 @@ export function createStageView({ historyEl, appendToHistory, isNearBottom: hist
 
   function drawNow(tool, gen) {
     const quiet = gen?.text && !gen.textDone ? "writing…" : "thinking…";
-    const key = tool ? `run|${tool.name}|${tool.title}` : `quiet|${quiet}`;
+    const key = tool ? `run|${tool.name}|${tool.title}|${tool.command || ""}` : `quiet|${quiet}`;
     if (shown.now === key) return;
     shown.now = key;
     now.replaceChildren();
@@ -233,7 +234,8 @@ export function createStageView({ historyEl, appendToHistory, isNearBottom: hist
       name.textContent = tool.name;
       const title = node("span", "ts-title", now);
       title.textContent = tool.title;
-      title.title = tool.title;
+      // The full command when the call has one (the title is its first line).
+      title.title = tool.command || tool.title;
     } else {
       const word = node("span", "ts-title quiet", now);
       word.textContent = quiet;
@@ -251,6 +253,7 @@ export function createStageView({ historyEl, appendToHistory, isNearBottom: hist
       const failed = item.status === "error";
       const el = node("span", `ts-trail-item${failed ? " error" : ""}`, trail);
       el.textContent = `${failed ? "✕" : "✓"} ${item.name} ${item.title}`.trim();
+      if (item.command) el.title = item.command;
     }
     if (!flashing && !items.length) node("span", "ts-trail-item none", trail).textContent = "no tool calls yet";
   }

data/lib/samagotchi/web/public/turn_events.js

@@ -123,6 +123,17 @@ export function emptyRetryLine({ attempt, of, stopped_by: stoppedBy } = {}) {
   return `↻ ${what}, asking again (${attempt}/${of})`;
 }
 
+// The row a step gets when a message for the running turn cut a generation
+// that was only thinking (steer_cut; source "" is the user's, as is an
+// unknown one). The TUI words it the same (spec/shared/labels_matrix.json).
+const STEER_CUT_FOR = {
+  chi_send: "a message sent with chi send",
+  parent_agent: "the parent agent's message",
+};
+export function steerCutLine({ source } = {}) {
+  return `↪ cut in for ${STEER_CUT_FOR[source] || "your message"}`;
+}
+
 // The one muted line for a turn that ended with no answer (turn_completed's
 // turn_summary.empty_answer, or a reloaded turn's marker): the TUI words
 // it the same (TurnNote.empty_answer_line; spec/shared/labels_matrix.json).
@@ -136,6 +147,7 @@ export function emptyAnswerLine({ retries = 0 } = {}) {
 // notice as "<label>: text", the loop's asking-again row as its line.
 export function noticeLine(entry = {}) {
   if (entry.type === "empty_answer_retry") return emptyRetryLine(entry);
+  if (entry.type === "steer_cut") return steerCutLine(entry);
   return `${hookNoticeLabel(entry.hook)}: ${entry.text || ""}`;
 }
 
@@ -451,7 +463,8 @@ export function snapshotEvents({ current_turn: turn = null, queued = [], started
           const call = { iteration: part.iteration, call_index: part.call_index, tool: part.tool };
           if (part.label) call.label = part.label;
           const title = part.title ? { title: part.title } : {};
-          events.push({ type: "tool_call_started", ...call, params: part.params, ...title });
+          const view = part.view ? { view: part.view } : {};
+          events.push({ type: "tool_call_started", ...call, params: part.params, ...title, ...view });
           if (part.status !== "running") {
             // The activity as the live event had it; action and duration_ms
             // only in snapshots from a worker that keeps them (the TUI's
@@ -463,6 +476,7 @@ export function snapshotEvents({ current_turn: turn = null, queued = [], started
             };
             if (part.duration_ms != null) completed.duration_ms = part.duration_ms;
             if (part.diff) completed.diff = part.diff;
+            if (part.view) completed.view = part.view;
             events.push(withImages(completed, part.images));
           }
           break;