@dexto/tui 1.15.0-beta.0 → 1.15.0-beta.1

package/dist/utils/tool-step.cjs

@@ -0,0 +1,183 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var tool_step_exports = {};
+__export(tool_step_exports, {
+  backgroundFailure: () => import_background_failure.backgroundFailure,
+  finishedToolStep: () => finishedToolStep,
+  toolOutput: () => toolOutput,
+  toolStep: () => toolStep
+});
+module.exports = __toCommonJS(tool_step_exports);
+var import_background_failure = require("./background-failure.js");
+var import_messageFormatting = require("./messageFormatting.js");
+const VERB_CELLS = 7;
+const OUTPUT_LINES = 5;
+const VERBS = {
+  read_file: "READ",
+  read_media_file: "READ",
+  write_file: "WRITE",
+  edit_file: "EDIT",
+  bash_exec: "RUN",
+  bash_output: "OUTPUT",
+  kill_process: "KILL",
+  grep_content: "SEARCH",
+  search_history: "SEARCH",
+  glob_files: "GLOB",
+  todo_write: "TODO",
+  spawn_agent: "TASK",
+  invoke_skill: "SKILL",
+  skill_load: "SKILL",
+  http_request: "FETCH",
+  view_logs: "LOGS",
+  plan_create: "PLAN",
+  plan_read: "PLAN",
+  plan_update: "PLAN",
+  plan_review: "PLAN"
+};
+const FILE_TOOLS = /* @__PURE__ */ new Set(["read_file", "read_media_file", "write_file", "edit_file"]);
+function stepState(message) {
+  switch (message.toolStatus) {
+    case "pending":
+      return "queue";
+    case "pending_approval":
+      return "wait";
+    case "running":
+      return "run";
+    default:
+      if (message.toolOutcome === "denied") return "deny";
+      if (message.toolOutcome === "cancelled") return "stop";
+      if (message.isError === true || message.toolOutcome === "failed") return "fail";
+      return message.toolDisplayData?.type === "shell" && message.toolDisplayData.exitCode !== 0 ? "fail" : "ok";
+  }
+}
+function stepVerb(toolName) {
+  if (toolName.startsWith("mcp--")) return "MCP";
+  const known = VERBS[toolName];
+  if (known !== void 0) return known;
+  const firstWord = toolName.split(/[_\-\s(]/)[0] ?? toolName;
+  return firstWord.toUpperCase().slice(0, VERB_CELLS);
+}
+function stepTarget(toolName, toolArgs) {
+  const args = toolArgs.replace(/\s*\n\s*/g, " ").trim();
+  if (toolName.startsWith("mcp--")) {
+    const [, server, ...name] = toolName.split("--");
+    return [`${server ?? ""}.${name.join("--")}`, args].filter((part) => part !== "").join(" ");
+  }
+  return FILE_TOOLS.has(toolName) ? (0, import_messageFormatting.makeRelativePath)(args) : args;
+}
+function countLines(text) {
+  return text === void 0 ? 0 : text.split("\n").filter((line) => line.length > 0).length;
+}
+function plural(count, noun) {
+  return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+function displayDetail(display) {
+  switch (display.type) {
+    case "diff": {
+      const hunks = display.unified.split("\n").filter((l) => l.startsWith("@@")).length;
+      const counts = `+${display.additions} \u2212${display.deletions}`;
+      return hunks > 1 ? `${counts} \xB7 ${hunks} hunks` : counts;
+    }
+    case "shell": {
+      if (display.exitCode !== 0) return `exit ${display.exitCode}`;
+      if (display.isBackground === true) return "background";
+      const lines = countLines(display.stdout);
+      return lines > 0 ? plural(lines, "line") : null;
+    }
+    case "search": {
+      const files = new Set(display.matches.map((match) => match.file)).size;
+      const more = display.truncated ? "+" : "";
+      return `${display.totalMatches}${more} hit${display.totalMatches === 1 && !more ? "" : "s"} \xB7 ${files}${more} file${files === 1 && !more ? "" : "s"}`;
+    }
+    case "file": {
+      const lines = display.lineCount === void 0 ? null : plural(display.lineCount, "line");
+      if (display.operation === "delete") return "deleted";
+      if (display.operation === "create") return lines === null ? "new" : `new \xB7 ${lines}`;
+      return lines;
+    }
+    default:
+      return null;
+  }
+}
+function stepDetail(message, state) {
+  if (state === "deny") return "you denied";
+  if (state === "run" && message.subAgentProgress !== void 0) {
+    return `${plural(message.subAgentProgress.toolsCalled, "tool")} so far`;
+  }
+  return message.toolDisplayData === void 0 ? null : displayDetail(message.toolDisplayData);
+}
+function toolStep(message) {
+  const toolName = message.toolName ?? "";
+  const state = stepState(message);
+  const display = message.toolDisplayData;
+  return {
+    state,
+    verb: stepVerb(toolName !== "" ? toolName : message.content),
+    target: stepTarget(toolName, message.toolArgs ?? ""),
+    detail: stepDetail(message, state),
+    time: display?.type === "shell" ? (0, import_messageFormatting.formatDuration)(display.duration) : null,
+    cloud: false
+  };
+}
+function readableFailure(text) {
+  try {
+    const parsed = JSON.parse(text);
+    if (typeof parsed === "object" && parsed !== null && "error" in parsed) {
+      return typeof parsed.error === "string" ? parsed.error : text;
+    }
+  } catch {
+  }
+  return text;
+}
+function toolOutput(message) {
+  if (stepState(message) !== "fail") return [];
+  const display = message.toolDisplayData;
+  const text = message.toolFailureText !== void 0 ? message.toolFailureText : display?.type === "shell" ? display.stderr?.trim() || display.stdout?.trim() || "" : readableFailure(message.toolResult ?? "");
+  return text.split("\n").filter((line) => line.trim().length > 0).slice(-OUTPUT_LINES);
+}
+function finishedToolStep(call) {
+  const { header, argsFormatted } = (0, import_messageFormatting.formatToolHeader)({
+    toolName: call.toolName,
+    args: call.args,
+    ...call.presentationSnapshot !== void 0 && {
+      presentationSnapshot: call.presentationSnapshot
+    }
+  });
+  const message = {
+    id: call.toolName,
+    role: "tool",
+    content: header,
+    timestamp: /* @__PURE__ */ new Date(0),
+    toolName: call.toolName,
+    toolArgs: argsFormatted,
+    toolStatus: "finished",
+    isError: !call.success,
+    ...call.error !== void 0 && { toolResult: call.error },
+    ...call.display !== void 0 && { toolDisplayData: call.display },
+    ...(0, import_background_failure.backgroundFailure)(call.toolName, call.rawResult)
+  };
+  return { step: toolStep(message), output: toolOutput(message) };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  backgroundFailure,
+  finishedToolStep,
+  toolOutput,
+  toolStep
+});

package/dist/utils/tool-step.d.ts

@@ -0,0 +1,28 @@
+/**
+ * What one tool call shows as a Signal step row, worked out from its message. Pure, so each rule
+ * is tested on its own.
+ */
+import type { ToolDisplayData, ToolPresentationSnapshotV1 } from '@dexto/core';
+import type { Step } from '../signal/index.js';
+export type { Step };
+import type { Message } from '../state/types.js';
+import { backgroundFailure } from './background-failure.js';
+export { backgroundFailure };
+export declare function toolStep(message: Message): Step;
+/** The lines under a failed call's row: why it failed. A call that worked stays one row. */
+export declare function toolOutput(message: Message): string[];
+export interface FinishedToolCall {
+    toolName: string;
+    args: Record<string, unknown>;
+    presentationSnapshot?: ToolPresentationSnapshotV1;
+    success: boolean;
+    error?: string;
+    rawResult?: unknown;
+    display?: ToolDisplayData;
+}
+/** A finished call seen outside the TUI: `dexto run` prints these as its log. */
+export declare function finishedToolStep(call: FinishedToolCall): {
+    step: Step;
+    output: string[];
+};
+//# sourceMappingURL=tool-step.d.ts.map

package/dist/utils/tool-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-step.d.ts","sourceRoot":"","sources":["../../src/utils/tool-step.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,IAAI,EAAa,MAAM,oBAAoB,CAAC;AAE1D,YAAY,EAAE,IAAI,EAAE,CAAC;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAmH7B,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAY/C;AAeD,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAarD;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAsBzF"}

package/dist/utils/tool-step.js

@@ -0,0 +1,156 @@
+import { backgroundFailure } from "./background-failure.js";
+import { formatDuration, formatToolHeader, makeRelativePath } from "./messageFormatting.js";
+const VERB_CELLS = 7;
+const OUTPUT_LINES = 5;
+const VERBS = {
+  read_file: "READ",
+  read_media_file: "READ",
+  write_file: "WRITE",
+  edit_file: "EDIT",
+  bash_exec: "RUN",
+  bash_output: "OUTPUT",
+  kill_process: "KILL",
+  grep_content: "SEARCH",
+  search_history: "SEARCH",
+  glob_files: "GLOB",
+  todo_write: "TODO",
+  spawn_agent: "TASK",
+  invoke_skill: "SKILL",
+  skill_load: "SKILL",
+  http_request: "FETCH",
+  view_logs: "LOGS",
+  plan_create: "PLAN",
+  plan_read: "PLAN",
+  plan_update: "PLAN",
+  plan_review: "PLAN"
+};
+const FILE_TOOLS = /* @__PURE__ */ new Set(["read_file", "read_media_file", "write_file", "edit_file"]);
+function stepState(message) {
+  switch (message.toolStatus) {
+    case "pending":
+      return "queue";
+    case "pending_approval":
+      return "wait";
+    case "running":
+      return "run";
+    default:
+      if (message.toolOutcome === "denied") return "deny";
+      if (message.toolOutcome === "cancelled") return "stop";
+      if (message.isError === true || message.toolOutcome === "failed") return "fail";
+      return message.toolDisplayData?.type === "shell" && message.toolDisplayData.exitCode !== 0 ? "fail" : "ok";
+  }
+}
+function stepVerb(toolName) {
+  if (toolName.startsWith("mcp--")) return "MCP";
+  const known = VERBS[toolName];
+  if (known !== void 0) return known;
+  const firstWord = toolName.split(/[_\-\s(]/)[0] ?? toolName;
+  return firstWord.toUpperCase().slice(0, VERB_CELLS);
+}
+function stepTarget(toolName, toolArgs) {
+  const args = toolArgs.replace(/\s*\n\s*/g, " ").trim();
+  if (toolName.startsWith("mcp--")) {
+    const [, server, ...name] = toolName.split("--");
+    return [`${server ?? ""}.${name.join("--")}`, args].filter((part) => part !== "").join(" ");
+  }
+  return FILE_TOOLS.has(toolName) ? makeRelativePath(args) : args;
+}
+function countLines(text) {
+  return text === void 0 ? 0 : text.split("\n").filter((line) => line.length > 0).length;
+}
+function plural(count, noun) {
+  return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+function displayDetail(display) {
+  switch (display.type) {
+    case "diff": {
+      const hunks = display.unified.split("\n").filter((l) => l.startsWith("@@")).length;
+      const counts = `+${display.additions} \u2212${display.deletions}`;
+      return hunks > 1 ? `${counts} \xB7 ${hunks} hunks` : counts;
+    }
+    case "shell": {
+      if (display.exitCode !== 0) return `exit ${display.exitCode}`;
+      if (display.isBackground === true) return "background";
+      const lines = countLines(display.stdout);
+      return lines > 0 ? plural(lines, "line") : null;
+    }
+    case "search": {
+      const files = new Set(display.matches.map((match) => match.file)).size;
+      const more = display.truncated ? "+" : "";
+      return `${display.totalMatches}${more} hit${display.totalMatches === 1 && !more ? "" : "s"} \xB7 ${files}${more} file${files === 1 && !more ? "" : "s"}`;
+    }
+    case "file": {
+      const lines = display.lineCount === void 0 ? null : plural(display.lineCount, "line");
+      if (display.operation === "delete") return "deleted";
+      if (display.operation === "create") return lines === null ? "new" : `new \xB7 ${lines}`;
+      return lines;
+    }
+    default:
+      return null;
+  }
+}
+function stepDetail(message, state) {
+  if (state === "deny") return "you denied";
+  if (state === "run" && message.subAgentProgress !== void 0) {
+    return `${plural(message.subAgentProgress.toolsCalled, "tool")} so far`;
+  }
+  return message.toolDisplayData === void 0 ? null : displayDetail(message.toolDisplayData);
+}
+function toolStep(message) {
+  const toolName = message.toolName ?? "";
+  const state = stepState(message);
+  const display = message.toolDisplayData;
+  return {
+    state,
+    verb: stepVerb(toolName !== "" ? toolName : message.content),
+    target: stepTarget(toolName, message.toolArgs ?? ""),
+    detail: stepDetail(message, state),
+    time: display?.type === "shell" ? formatDuration(display.duration) : null,
+    cloud: false
+  };
+}
+function readableFailure(text) {
+  try {
+    const parsed = JSON.parse(text);
+    if (typeof parsed === "object" && parsed !== null && "error" in parsed) {
+      return typeof parsed.error === "string" ? parsed.error : text;
+    }
+  } catch {
+  }
+  return text;
+}
+function toolOutput(message) {
+  if (stepState(message) !== "fail") return [];
+  const display = message.toolDisplayData;
+  const text = message.toolFailureText !== void 0 ? message.toolFailureText : display?.type === "shell" ? display.stderr?.trim() || display.stdout?.trim() || "" : readableFailure(message.toolResult ?? "");
+  return text.split("\n").filter((line) => line.trim().length > 0).slice(-OUTPUT_LINES);
+}
+function finishedToolStep(call) {
+  const { header, argsFormatted } = formatToolHeader({
+    toolName: call.toolName,
+    args: call.args,
+    ...call.presentationSnapshot !== void 0 && {
+      presentationSnapshot: call.presentationSnapshot
+    }
+  });
+  const message = {
+    id: call.toolName,
+    role: "tool",
+    content: header,
+    timestamp: /* @__PURE__ */ new Date(0),
+    toolName: call.toolName,
+    toolArgs: argsFormatted,
+    toolStatus: "finished",
+    isError: !call.success,
+    ...call.error !== void 0 && { toolResult: call.error },
+    ...call.display !== void 0 && { toolDisplayData: call.display },
+    ...backgroundFailure(call.toolName, call.rawResult)
+  };
+  return { step: toolStep(message), output: toolOutput(message) };
+}
+export {
+  backgroundFailure,
+  finishedToolStep,
+  toolOutput,
+  toolStep
+};

package/dist/utils/tool-step.test.cjs

@@ -0,0 +1,263 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_tool_step = require("./tool-step.js");
+function tool(overrides) {
+  return {
+    id: "tool-1",
+    role: "tool",
+    content: "Read(src/a.ts)",
+    timestamp: /* @__PURE__ */ new Date(0),
+    toolName: "read_file",
+    toolStatus: "finished",
+    ...overrides
+  };
+}
+(0, import_vitest.describe)("toolStep", () => {
+  import_vitest.it.each([
+    ["pending", "queue"],
+    ["pending_approval", "wait"],
+    ["running", "run"],
+    ["finished", "ok"]
+  ])("maps tool status %s to step state %s", (toolStatus, state) => {
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolStatus })).state).toBe(state);
+  });
+  (0, import_vitest.it)("marks a failed, a denied and a stopped call", () => {
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ isError: true })).state).toBe("fail");
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ isError: true, toolOutcome: "denied" })).state).toBe("deny");
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ isError: true, toolOutcome: "cancelled" })).state).toBe("stop");
+  });
+  import_vitest.it.each([
+    ["read_file", "READ"],
+    ["write_file", "WRITE"],
+    ["edit_file", "EDIT"],
+    ["bash_exec", "RUN"],
+    ["grep_content", "SEARCH"],
+    ["glob_files", "GLOB"],
+    ["spawn_agent", "TASK"],
+    ["mcp--github--create_pull_request", "MCP"]
+  ])("names %s as %s", (toolName, verb) => {
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolName })).verb).toBe(verb);
+  });
+  (0, import_vitest.it)("falls back to the first word of an unknown tool, at most 7 cells", () => {
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolName: "summarize_everything" })).verb).toBe("SUMMARI");
+  });
+  (0, import_vitest.it)("names an MCP target by server and tool, then its arguments", () => {
+    const step = (0, import_tool_step.toolStep)(
+      tool({
+        toolName: "mcp--github--create_pull_request",
+        content: "Create Pull Request(title=x) [MCP: github]\nOpening the PR",
+        toolArgs: "title=x"
+      })
+    );
+    (0, import_vitest.expect)(step.target).toBe("github.create_pull_request title=x");
+  });
+  (0, import_vitest.it)("shows file paths relative to the working directory", () => {
+    const step = (0, import_tool_step.toolStep)(tool({ toolArgs: `${process.cwd()}/src/a.ts` }));
+    (0, import_vitest.expect)(step.target).toBe("src/a.ts");
+  });
+  (0, import_vitest.it)("reads a multi-line command on one row", () => {
+    const step = (0, import_tool_step.toolStep)(tool({ toolName: "bash_exec", toolArgs: "echo a\n  echo $(b)" }));
+    (0, import_vitest.expect)(step.target).toBe("echo a echo $(b)");
+  });
+  (0, import_vitest.it)("sums up an edit, with hunks when there are several", () => {
+    const toolDisplayData = {
+      type: "diff",
+      unified: "@@ -1 +1 @@\n-a\n+b\n@@ -9 +9 @@\n-c\n+d",
+      filename: "a.ts",
+      additions: 31,
+      deletions: 12
+    };
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolDisplayData })).detail).toBe("+31 \u221212 \xB7 2 hunks");
+  });
+  (0, import_vitest.it)("sums up a shell run by lines of output and by exit code", () => {
+    const shell = { type: "shell", command: "x", duration: 5, stdout: "a\nb\n" };
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolDisplayData: { ...shell, exitCode: 0 } })).detail).toBe(
+      "2 lines"
+    );
+    (0, import_vitest.expect)(
+      (0, import_tool_step.toolStep)(tool({ isError: true, toolDisplayData: { ...shell, exitCode: 3 } })).detail
+    ).toBe("exit 3");
+  });
+  (0, import_vitest.it)("sums up a search by hits and files", () => {
+    const match = { line: 1, content: "x" };
+    const toolDisplayData = {
+      type: "search",
+      pattern: "x",
+      matches: [
+        { ...match, file: "a" },
+        { ...match, file: "a" },
+        { ...match, file: "b" }
+      ],
+      totalMatches: 3,
+      truncated: false
+    };
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolDisplayData })).detail).toBe("3 hits \xB7 2 files");
+  });
+  (0, import_vitest.it)("says when a capped search has more than it counted", () => {
+    const toolDisplayData = {
+      type: "search",
+      pattern: "x",
+      matches: [{ file: "a", line: 1, content: "x" }],
+      totalMatches: 1,
+      truncated: true
+    };
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolDisplayData })).detail).toBe("1+ hits \xB7 1+ files");
+  });
+  (0, import_vitest.it)("sums up a file read and a created file", () => {
+    const file = { type: "file", path: "a", lineCount: 88 };
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolDisplayData: { ...file, operation: "read" } })).detail).toBe(
+      "88 lines"
+    );
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolDisplayData: { ...file, operation: "create" } })).detail).toBe(
+      "new \xB7 88 lines"
+    );
+  });
+  (0, import_vitest.it)("says a denied call was denied and counts a sub-agent while it runs", () => {
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ isError: true, toolOutcome: "denied" })).detail).toBe("you denied");
+    const subAgentProgress = {
+      task: "t",
+      agentId: "a",
+      toolsCalled: 3,
+      currentTool: "read_file"
+    };
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolStatus: "running", subAgentProgress })).detail).toBe(
+      "3 tools so far"
+    );
+  });
+  (0, import_vitest.it)("counts a command that exited nonzero as failed", () => {
+    const toolDisplayData = {
+      type: "shell",
+      command: "x",
+      duration: 5,
+      exitCode: 2
+    };
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolDisplayData })).state).toBe("fail");
+  });
+  (0, import_vitest.it)("times a shell run from its own duration, and no other tool", () => {
+    const toolDisplayData = {
+      type: "shell",
+      command: "x",
+      duration: 4200,
+      exitCode: 0
+    };
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({ toolDisplayData })).time).toBe("4.2s");
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(tool({})).time).toBeNull();
+  });
+});
+(0, import_vitest.describe)("toolOutput", () => {
+  (0, import_vitest.it)("shows nothing for a call that worked", () => {
+    (0, import_vitest.expect)((0, import_tool_step.toolOutput)(tool({ toolResult: "all fine" }))).toEqual([]);
+  });
+  (0, import_vitest.it)("shows the last lines of a failed shell run, stderr first", () => {
+    const stderr = Array.from({ length: 9 }, (_, i) => `line ${i}`).join("\n");
+    const lines = (0, import_tool_step.toolOutput)(
+      tool({
+        isError: true,
+        toolDisplayData: {
+          type: "shell",
+          command: "x",
+          exitCode: 1,
+          duration: 1,
+          stdout: "out",
+          stderr
+        }
+      })
+    );
+    (0, import_vitest.expect)(lines).toEqual(["line 4", "line 5", "line 6", "line 7", "line 8"]);
+  });
+  (0, import_vitest.it)("keeps the output of a command that exited nonzero", () => {
+    const lines = (0, import_tool_step.toolOutput)(
+      tool({
+        toolDisplayData: {
+          type: "shell",
+          command: "x",
+          exitCode: 1,
+          duration: 1,
+          stdout: "expected 1, got 2"
+        }
+      })
+    );
+    (0, import_vitest.expect)(lines).toEqual(["expected 1, got 2"]);
+  });
+  (0, import_vitest.it)("shows the error text of any other failed call", () => {
+    (0, import_vitest.expect)((0, import_tool_step.toolOutput)(tool({ isError: true, toolResult: "ENOENT: a.ts\n" }))).toEqual([
+      "ENOENT: a.ts"
+    ]);
+  });
+  (0, import_vitest.it)('reads the message out of a stored {"error":\u2026} result', () => {
+    const toolResult = JSON.stringify({ error: "Command failed: exit 3\n" });
+    (0, import_vitest.expect)((0, import_tool_step.toolOutput)(tool({ isError: true, toolResult }))).toEqual(["Command failed: exit 3"]);
+  });
+  (0, import_vitest.it)("prefers the failure text from the live event", () => {
+    const message = tool({
+      isError: true,
+      toolResult: '{"error":"cut off',
+      toolFailureText: "Command failed: exit 3"
+    });
+    (0, import_vitest.expect)((0, import_tool_step.toolOutput)(message)).toEqual(["Command failed: exit 3"]);
+  });
+  (0, import_vitest.it)("stays quiet for a denied or stopped call", () => {
+    const cancelled = { isError: true, toolResult: "Cancelled" };
+    (0, import_vitest.expect)((0, import_tool_step.toolOutput)(tool({ ...cancelled, toolOutcome: "denied" }))).toEqual([]);
+    (0, import_vitest.expect)((0, import_tool_step.toolOutput)(tool({ ...cancelled, toolOutcome: "cancelled" }))).toEqual([]);
+  });
+});
+(0, import_vitest.describe)("backgroundFailure", () => {
+  (0, import_vitest.it)("reads a failed bash_output as a failed row with its output", () => {
+    const failure = (0, import_tool_step.backgroundFailure)("bash_output", {
+      status: "failed",
+      stderr: "boom",
+      stdout: "out",
+      exit_code: 2
+    });
+    (0, import_vitest.expect)(failure).toEqual({ toolOutcome: "failed", toolFailureText: "boom" });
+    const message = tool({ toolName: "bash_output", ...failure });
+    (0, import_vitest.expect)((0, import_tool_step.toolStep)(message).state).toBe("fail");
+    (0, import_vitest.expect)((0, import_tool_step.toolOutput)(message)).toEqual(["boom"]);
+  });
+  (0, import_vitest.it)("falls back to the exit code when there is no output", () => {
+    (0, import_vitest.expect)(
+      (0, import_tool_step.backgroundFailure)("bash_output", { status: "failed", stderr: "", exit_code: 2 })
+    ).toEqual({ toolOutcome: "failed", toolFailureText: "exit 2" });
+  });
+  (0, import_vitest.it)("ignores a running or completed process and any other tool", () => {
+    (0, import_vitest.expect)((0, import_tool_step.backgroundFailure)("bash_output", { status: "completed" })).toEqual({});
+    (0, import_vitest.expect)((0, import_tool_step.backgroundFailure)("read_file", { status: "failed" })).toEqual({});
+  });
+});
+(0, import_vitest.describe)("finishedToolStep", () => {
+  (0, import_vitest.it)("builds the row from the call itself", () => {
+    const { step, output } = (0, import_tool_step.finishedToolStep)({
+      toolName: "bash_exec",
+      args: { command: "make" },
+      presentationSnapshot: {
+        version: 1,
+        source: { type: "local" },
+        header: { title: "Bash", argsText: "make" }
+      },
+      success: true
+    });
+    (0, import_vitest.expect)(step.verb).toBe("RUN");
+    (0, import_vitest.expect)(step.target).toBe("make");
+    (0, import_vitest.expect)(step.state).toBe("ok");
+    (0, import_vitest.expect)(output).toEqual([]);
+  });
+  (0, import_vitest.it)("carries why a call failed, including a failed background readback", () => {
+    const failed = (0, import_tool_step.finishedToolStep)({
+      toolName: "read_file",
+      args: {},
+      success: false,
+      error: "ENOENT"
+    });
+    (0, import_vitest.expect)(failed.step.state).toBe("fail");
+    (0, import_vitest.expect)(failed.output).toEqual(["ENOENT"]);
+    const readback = (0, import_tool_step.finishedToolStep)({
+      toolName: "bash_output",
+      args: {},
+      success: true,
+      rawResult: { status: "failed", stderr: "boom" }
+    });
+    (0, import_vitest.expect)(readback.step.state).toBe("fail");
+    (0, import_vitest.expect)(readback.output).toEqual(["boom"]);
+  });
+});

package/dist/utils/tool-step.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-step.test.d.ts.map

package/dist/utils/tool-step.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-step.test.d.ts","sourceRoot":"","sources":["../../src/utils/tool-step.test.ts"],"names":[],"mappings":""}