@dexto/tui 1.14.6 → 1.15.0-beta.1

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

@@ -0,0 +1,262 @@
+import { describe, expect, it } from "vitest";
+import { backgroundFailure, finishedToolStep, toolOutput, toolStep } from "./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
+  };
+}
+describe("toolStep", () => {
+  it.each([
+    ["pending", "queue"],
+    ["pending_approval", "wait"],
+    ["running", "run"],
+    ["finished", "ok"]
+  ])("maps tool status %s to step state %s", (toolStatus, state) => {
+    expect(toolStep(tool({ toolStatus })).state).toBe(state);
+  });
+  it("marks a failed, a denied and a stopped call", () => {
+    expect(toolStep(tool({ isError: true })).state).toBe("fail");
+    expect(toolStep(tool({ isError: true, toolOutcome: "denied" })).state).toBe("deny");
+    expect(toolStep(tool({ isError: true, toolOutcome: "cancelled" })).state).toBe("stop");
+  });
+  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) => {
+    expect(toolStep(tool({ toolName })).verb).toBe(verb);
+  });
+  it("falls back to the first word of an unknown tool, at most 7 cells", () => {
+    expect(toolStep(tool({ toolName: "summarize_everything" })).verb).toBe("SUMMARI");
+  });
+  it("names an MCP target by server and tool, then its arguments", () => {
+    const step = toolStep(
+      tool({
+        toolName: "mcp--github--create_pull_request",
+        content: "Create Pull Request(title=x) [MCP: github]\nOpening the PR",
+        toolArgs: "title=x"
+      })
+    );
+    expect(step.target).toBe("github.create_pull_request title=x");
+  });
+  it("shows file paths relative to the working directory", () => {
+    const step = toolStep(tool({ toolArgs: `${process.cwd()}/src/a.ts` }));
+    expect(step.target).toBe("src/a.ts");
+  });
+  it("reads a multi-line command on one row", () => {
+    const step = toolStep(tool({ toolName: "bash_exec", toolArgs: "echo a\n  echo $(b)" }));
+    expect(step.target).toBe("echo a echo $(b)");
+  });
+  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
+    };
+    expect(toolStep(tool({ toolDisplayData })).detail).toBe("+31 \u221212 \xB7 2 hunks");
+  });
+  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" };
+    expect(toolStep(tool({ toolDisplayData: { ...shell, exitCode: 0 } })).detail).toBe(
+      "2 lines"
+    );
+    expect(
+      toolStep(tool({ isError: true, toolDisplayData: { ...shell, exitCode: 3 } })).detail
+    ).toBe("exit 3");
+  });
+  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
+    };
+    expect(toolStep(tool({ toolDisplayData })).detail).toBe("3 hits \xB7 2 files");
+  });
+  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
+    };
+    expect(toolStep(tool({ toolDisplayData })).detail).toBe("1+ hits \xB7 1+ files");
+  });
+  it("sums up a file read and a created file", () => {
+    const file = { type: "file", path: "a", lineCount: 88 };
+    expect(toolStep(tool({ toolDisplayData: { ...file, operation: "read" } })).detail).toBe(
+      "88 lines"
+    );
+    expect(toolStep(tool({ toolDisplayData: { ...file, operation: "create" } })).detail).toBe(
+      "new \xB7 88 lines"
+    );
+  });
+  it("says a denied call was denied and counts a sub-agent while it runs", () => {
+    expect(toolStep(tool({ isError: true, toolOutcome: "denied" })).detail).toBe("you denied");
+    const subAgentProgress = {
+      task: "t",
+      agentId: "a",
+      toolsCalled: 3,
+      currentTool: "read_file"
+    };
+    expect(toolStep(tool({ toolStatus: "running", subAgentProgress })).detail).toBe(
+      "3 tools so far"
+    );
+  });
+  it("counts a command that exited nonzero as failed", () => {
+    const toolDisplayData = {
+      type: "shell",
+      command: "x",
+      duration: 5,
+      exitCode: 2
+    };
+    expect(toolStep(tool({ toolDisplayData })).state).toBe("fail");
+  });
+  it("times a shell run from its own duration, and no other tool", () => {
+    const toolDisplayData = {
+      type: "shell",
+      command: "x",
+      duration: 4200,
+      exitCode: 0
+    };
+    expect(toolStep(tool({ toolDisplayData })).time).toBe("4.2s");
+    expect(toolStep(tool({})).time).toBeNull();
+  });
+});
+describe("toolOutput", () => {
+  it("shows nothing for a call that worked", () => {
+    expect(toolOutput(tool({ toolResult: "all fine" }))).toEqual([]);
+  });
+  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 = toolOutput(
+      tool({
+        isError: true,
+        toolDisplayData: {
+          type: "shell",
+          command: "x",
+          exitCode: 1,
+          duration: 1,
+          stdout: "out",
+          stderr
+        }
+      })
+    );
+    expect(lines).toEqual(["line 4", "line 5", "line 6", "line 7", "line 8"]);
+  });
+  it("keeps the output of a command that exited nonzero", () => {
+    const lines = toolOutput(
+      tool({
+        toolDisplayData: {
+          type: "shell",
+          command: "x",
+          exitCode: 1,
+          duration: 1,
+          stdout: "expected 1, got 2"
+        }
+      })
+    );
+    expect(lines).toEqual(["expected 1, got 2"]);
+  });
+  it("shows the error text of any other failed call", () => {
+    expect(toolOutput(tool({ isError: true, toolResult: "ENOENT: a.ts\n" }))).toEqual([
+      "ENOENT: a.ts"
+    ]);
+  });
+  it('reads the message out of a stored {"error":\u2026} result', () => {
+    const toolResult = JSON.stringify({ error: "Command failed: exit 3\n" });
+    expect(toolOutput(tool({ isError: true, toolResult }))).toEqual(["Command failed: exit 3"]);
+  });
+  it("prefers the failure text from the live event", () => {
+    const message = tool({
+      isError: true,
+      toolResult: '{"error":"cut off',
+      toolFailureText: "Command failed: exit 3"
+    });
+    expect(toolOutput(message)).toEqual(["Command failed: exit 3"]);
+  });
+  it("stays quiet for a denied or stopped call", () => {
+    const cancelled = { isError: true, toolResult: "Cancelled" };
+    expect(toolOutput(tool({ ...cancelled, toolOutcome: "denied" }))).toEqual([]);
+    expect(toolOutput(tool({ ...cancelled, toolOutcome: "cancelled" }))).toEqual([]);
+  });
+});
+describe("backgroundFailure", () => {
+  it("reads a failed bash_output as a failed row with its output", () => {
+    const failure = backgroundFailure("bash_output", {
+      status: "failed",
+      stderr: "boom",
+      stdout: "out",
+      exit_code: 2
+    });
+    expect(failure).toEqual({ toolOutcome: "failed", toolFailureText: "boom" });
+    const message = tool({ toolName: "bash_output", ...failure });
+    expect(toolStep(message).state).toBe("fail");
+    expect(toolOutput(message)).toEqual(["boom"]);
+  });
+  it("falls back to the exit code when there is no output", () => {
+    expect(
+      backgroundFailure("bash_output", { status: "failed", stderr: "", exit_code: 2 })
+    ).toEqual({ toolOutcome: "failed", toolFailureText: "exit 2" });
+  });
+  it("ignores a running or completed process and any other tool", () => {
+    expect(backgroundFailure("bash_output", { status: "completed" })).toEqual({});
+    expect(backgroundFailure("read_file", { status: "failed" })).toEqual({});
+  });
+});
+describe("finishedToolStep", () => {
+  it("builds the row from the call itself", () => {
+    const { step, output } = finishedToolStep({
+      toolName: "bash_exec",
+      args: { command: "make" },
+      presentationSnapshot: {
+        version: 1,
+        source: { type: "local" },
+        header: { title: "Bash", argsText: "make" }
+      },
+      success: true
+    });
+    expect(step.verb).toBe("RUN");
+    expect(step.target).toBe("make");
+    expect(step.state).toBe("ok");
+    expect(output).toEqual([]);
+  });
+  it("carries why a call failed, including a failed background readback", () => {
+    const failed = finishedToolStep({
+      toolName: "read_file",
+      args: {},
+      success: false,
+      error: "ENOENT"
+    });
+    expect(failed.step.state).toBe("fail");
+    expect(failed.output).toEqual(["ENOENT"]);
+    const readback = finishedToolStep({
+      toolName: "bash_output",
+      args: {},
+      success: true,
+      rawResult: { status: "failed", stderr: "boom" }
+    });
+    expect(readback.step.state).toBe("fail");
+    expect(readback.output).toEqual(["boom"]);
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/tui",
-  "version": "1.14.6",
+  "version": "1.15.0-beta.1",
   "description": "Interactive terminal UI for Dexto CLI",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./tool-step": {
+      "types": "./dist/utils/tool-step.d.ts",
+      "import": "./dist/utils/tool-step.js"
     }
   },
   "files": [
@@ -28,10 +32,10 @@
     "string-width": "^8.1.0",
     "strip-ansi": "^7.1.2",
     "wrap-ansi": "^9.0.2",
-    "@dexto/agent-management": "1.14.6",
-    "@dexto/core": "1.14.6",
-    "@dexto/llm": "1.14.6",
-    "@dexto/registry": "1.14.6"
+    "@dexto/agent-management": "1.15.0-beta.1",
+    "@dexto/core": "1.14.4",
+    "@dexto/llm": "1.14.4",
+    "@dexto/registry": "1.14.4"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",

package/dist/components/BackgroundTasksPanel.cjs

@@ -1,117 +0,0 @@
-"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 BackgroundTasksPanel_exports = {};
-__export(BackgroundTasksPanel_exports, {
-  BackgroundTasksPanel: () => BackgroundTasksPanel
-});
-module.exports = __toCommonJS(BackgroundTasksPanel_exports);
-var import_jsx_runtime = require("react/jsx-runtime");
-var import_ink = require("ink");
-function padText(value, width) {
-  if (value.length >= width) return value.slice(0, width - 1) + "\u2026";
-  return value.padEnd(width, " ");
-}
-function formatStatus(status) {
-  switch (status) {
-    case "running":
-      return "running";
-    case "completed":
-      return "done";
-    case "failed":
-      return "failed";
-    case "cancelled":
-      return "cancelled";
-    default:
-      return status;
-  }
-}
-function BackgroundTasksPanel({
-  tasks,
-  isExpanded,
-  isProcessing = false
-}) {
-  if (!isExpanded) return null;
-  const sortedTasks = [...tasks].sort((a, b) => {
-    if (a.status === b.status) return 0;
-    if (a.status === "running") return -1;
-    if (b.status === "running") return 1;
-    return a.status.localeCompare(b.status);
-  });
-  const runningCount = tasks.filter((task) => task.status === "running").length;
-  const totalCount = tasks.length;
-  const headerText = `\u{1F9F5} Background Tasks (${runningCount}/${totalCount} running)`;
-  if (totalCount === 0) {
-    return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-      import_ink.Box,
-      {
-        flexDirection: "column",
-        borderStyle: isProcessing ? void 0 : "round",
-        borderColor: "gray",
-        paddingX: 1,
-        marginX: 1,
-        marginBottom: 1,
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ink.Text, { bold: true, color: "cyan", children: headerText }),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ink.Text, { color: "gray", dimColor: true, children: "No background tasks" })
-        ]
-      }
-    );
-  }
-  const statusWidth = 10;
-  const idWidth = 14;
-  const descWidth = 48;
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-    import_ink.Box,
-    {
-      flexDirection: "column",
-      borderStyle: isProcessing ? void 0 : "round",
-      borderColor: "gray",
-      paddingX: 1,
-      marginX: 1,
-      marginBottom: 1,
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_ink.Box, { children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ink.Text, { bold: true, color: "cyan", children: headerText }),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_ink.Text, { color: "gray", dimColor: true, children: [
-            " ",
-            "\xB7 ctrl+b to hide bg tasks"
-          ] })
-        ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ink.Box, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_ink.Text, { color: "gray", children: [
-          padText("status", statusWidth),
-          padText("task id", idWidth),
-          padText("description", descWidth)
-        ] }) }),
-        sortedTasks.map((task) => {
-          const status = formatStatus(task.status);
-          const desc = task.description ?? "";
-          return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ink.Box, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_ink.Text, { color: task.status === "running" ? "yellow" : "gray", children: [
-            padText(status, statusWidth),
-            padText(task.taskId, idWidth),
-            padText(desc, descWidth)
-          ] }) }, task.taskId);
-        })
-      ]
-    }
-  );
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  BackgroundTasksPanel
-});

package/dist/components/BackgroundTasksPanel.d.ts

@@ -1,18 +0,0 @@
-/**
- * BackgroundTasksPanel Component
- *
- * Displays background task status in a compact table.
- */
-interface BackgroundTaskItem {
-    taskId: string;
-    status: 'running' | 'completed' | 'failed' | 'cancelled';
-    description?: string;
-}
-interface BackgroundTasksPanelProps {
-    tasks: BackgroundTaskItem[];
-    isExpanded: boolean;
-    isProcessing?: boolean;
-}
-export declare function BackgroundTasksPanel({ tasks, isExpanded, isProcessing, }: BackgroundTasksPanelProps): import("react/jsx-runtime").JSX.Element | null;
-export {};
-//# sourceMappingURL=BackgroundTasksPanel.d.ts.map

package/dist/components/BackgroundTasksPanel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BackgroundTasksPanel.d.ts","sourceRoot":"","sources":["../../src/components/BackgroundTasksPanel.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,UAAU,kBAAkB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,yBAAyB;IAC/B,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAsBD,wBAAgB,oBAAoB,CAAC,EACjC,KAAK,EACL,UAAU,EACV,YAAoB,GACvB,EAAE,yBAAyB,kDA+E3B"}

package/dist/components/BackgroundTasksPanel.js

@@ -1,93 +0,0 @@
-import { jsx, jsxs } from "react/jsx-runtime";
-import { Box, Text } from "ink";
-function padText(value, width) {
-  if (value.length >= width) return value.slice(0, width - 1) + "\u2026";
-  return value.padEnd(width, " ");
-}
-function formatStatus(status) {
-  switch (status) {
-    case "running":
-      return "running";
-    case "completed":
-      return "done";
-    case "failed":
-      return "failed";
-    case "cancelled":
-      return "cancelled";
-    default:
-      return status;
-  }
-}
-function BackgroundTasksPanel({
-  tasks,
-  isExpanded,
-  isProcessing = false
-}) {
-  if (!isExpanded) return null;
-  const sortedTasks = [...tasks].sort((a, b) => {
-    if (a.status === b.status) return 0;
-    if (a.status === "running") return -1;
-    if (b.status === "running") return 1;
-    return a.status.localeCompare(b.status);
-  });
-  const runningCount = tasks.filter((task) => task.status === "running").length;
-  const totalCount = tasks.length;
-  const headerText = `\u{1F9F5} Background Tasks (${runningCount}/${totalCount} running)`;
-  if (totalCount === 0) {
-    return /* @__PURE__ */ jsxs(
-      Box,
-      {
-        flexDirection: "column",
-        borderStyle: isProcessing ? void 0 : "round",
-        borderColor: "gray",
-        paddingX: 1,
-        marginX: 1,
-        marginBottom: 1,
-        children: [
-          /* @__PURE__ */ jsx(Text, { bold: true, color: "cyan", children: headerText }),
-          /* @__PURE__ */ jsx(Text, { color: "gray", dimColor: true, children: "No background tasks" })
-        ]
-      }
-    );
-  }
-  const statusWidth = 10;
-  const idWidth = 14;
-  const descWidth = 48;
-  return /* @__PURE__ */ jsxs(
-    Box,
-    {
-      flexDirection: "column",
-      borderStyle: isProcessing ? void 0 : "round",
-      borderColor: "gray",
-      paddingX: 1,
-      marginX: 1,
-      marginBottom: 1,
-      children: [
-        /* @__PURE__ */ jsxs(Box, { children: [
-          /* @__PURE__ */ jsx(Text, { bold: true, color: "cyan", children: headerText }),
-          /* @__PURE__ */ jsxs(Text, { color: "gray", dimColor: true, children: [
-            " ",
-            "\xB7 ctrl+b to hide bg tasks"
-          ] })
-        ] }),
-        /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
-          padText("status", statusWidth),
-          padText("task id", idWidth),
-          padText("description", descWidth)
-        ] }) }),
-        sortedTasks.map((task) => {
-          const status = formatStatus(task.status);
-          const desc = task.description ?? "";
-          return /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsxs(Text, { color: task.status === "running" ? "yellow" : "gray", children: [
-            padText(status, statusWidth),
-            padText(task.taskId, idWidth),
-            padText(desc, descWidth)
-          ] }) }, task.taskId);
-        })
-      ]
-    }
-  );
-}
-export {
-  BackgroundTasksPanel
-};