llmist 3.0.0 → 4.0.0

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import "./chunk-NBPKLSXJ.js";
+import "./chunk-Q6NQRMYD.js";
 import {
   AbstractGadget,
   AgentBuilder,
@@ -34,7 +34,7 @@ import {
   schemaToJSONSchema,
   text,
   validateGadgetSchema
-} from "./chunk-67MMSOAT.js";
+} from "./chunk-RHR2M6T6.js";
 
 // src/cli/constants.ts
 var CLI_NAME = "llmist";
@@ -123,7 +123,7 @@ import { Command, InvalidArgumentError as InvalidArgumentError2 } from "commande
 // package.json
 var package_default = {
   name: "llmist",
-  version: "3.0.0",
+  version: "3.1.0",
   description: "TypeScript LLM client with streaming tool execution. Tools fire mid-stream. Built-in function calling works with any model\u2014no structured outputs or native tool support required.",
   type: "module",
   main: "dist/index.cjs",
@@ -3063,20 +3063,53 @@ function renderOverallSummary(metadata) {
   }
   return parts.join(chalk3.dim(" | "));
 }
-function formatParametersInline(params) {
+function getRawValue(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "boolean" || typeof value === "number") {
+    return String(value);
+  }
+  return JSON.stringify(value);
+}
+function truncateValue(str, maxLen) {
+  if (maxLen <= 0) return "";
+  if (str.length <= maxLen) return str;
+  return `${str.slice(0, maxLen)}\u2026`;
+}
+function formatParametersInline(params, maxWidth) {
   if (!params || Object.keys(params).length === 0) {
     return "";
   }
-  return Object.entries(params).map(([key, value]) => {
-    let formatted;
-    if (typeof value === "string") {
-      formatted = value.length > 30 ? `${value.slice(0, 30)}\u2026` : value;
-    } else if (typeof value === "boolean" || typeof value === "number") {
-      formatted = String(value);
+  const entries = Object.entries(params);
+  const defaultLimit = 30;
+  const rawValues = entries.map(([, value]) => getRawValue(value));
+  const overhead = entries.reduce((sum, [key], i) => {
+    return sum + key.length + 1 + (i > 0 ? 2 : 0);
+  }, 0);
+  let limits;
+  if (maxWidth && maxWidth > overhead) {
+    const availableForValues = maxWidth - overhead;
+    const totalRawLength = rawValues.reduce((sum, v) => sum + v.length, 0);
+    if (totalRawLength <= availableForValues) {
+      limits = rawValues.map(() => Infinity);
     } else {
-      const json = JSON.stringify(value);
-      formatted = json.length > 30 ? `${json.slice(0, 30)}\u2026` : json;
+      const minPerValue = 10;
+      const minTotal = entries.length * minPerValue;
+      if (availableForValues <= minTotal) {
+        limits = rawValues.map(() => Math.max(1, Math.floor(availableForValues / entries.length)));
+      } else {
+        limits = rawValues.map((v) => {
+          const proportion = v.length / totalRawLength;
+          return Math.max(minPerValue, Math.floor(proportion * availableForValues));
+        });
+      }
     }
+  } else {
+    limits = rawValues.map(() => defaultLimit);
+  }
+  return entries.map(([key, _], i) => {
+    const formatted = truncateValue(rawValues[i], limits[i]);
     return `${chalk3.dim(key)}${chalk3.dim("=")}${chalk3.cyan(formatted)}`;
   }).join(chalk3.dim(", "));
 }
@@ -3112,23 +3145,28 @@ function formatMediaLine(media) {
   return `${chalk3.dim("[")}${icon} ${id} ${mimeType} ${size}${chalk3.dim("]")} ${chalk3.dim("\u2192")} ${path6}`;
 }
 function formatGadgetSummary2(result) {
+  const terminalWidth = process.stdout.columns || 80;
   const gadgetLabel = chalk3.magenta.bold(result.gadgetName);
-  const timeLabel = chalk3.dim(`${Math.round(result.executionTimeMs)}ms`);
-  const paramsStr = formatParametersInline(result.parameters);
-  const paramsLabel = paramsStr ? `${chalk3.dim("(")}${paramsStr}${chalk3.dim(")")}` : "";
-  if (result.error) {
-    const errorMsg = result.error.length > 50 ? `${result.error.slice(0, 50)}\u2026` : result.error;
-    return `${chalk3.red("\u2717")} ${gadgetLabel}${paramsLabel} ${chalk3.red("error:")} ${errorMsg} ${timeLabel}`;
-  }
-  let outputLabel;
+  const timeStr = result.executionTimeMs >= 1e3 ? `${(result.executionTimeMs / 1e3).toFixed(1)}s` : `${Math.round(result.executionTimeMs)}ms`;
+  const timeLabel = chalk3.dim(timeStr);
+  let outputStr;
   if (result.tokenCount !== void 0 && result.tokenCount > 0) {
-    outputLabel = chalk3.green(`${formatTokens(result.tokenCount)} tokens`);
+    outputStr = `${formatTokens(result.tokenCount)} tokens`;
   } else if (result.result) {
     const outputBytes = Buffer.byteLength(result.result, "utf-8");
-    outputLabel = outputBytes > 0 ? chalk3.green(formatBytes(outputBytes)) : chalk3.dim("no output");
+    outputStr = outputBytes > 0 ? formatBytes(outputBytes) : "no output";
   } else {
-    outputLabel = chalk3.dim("no output");
+    outputStr = "no output";
   }
+  const fixedLength = 2 + result.gadgetName.length + 2 + 3 + outputStr.length + 1 + timeStr.length;
+  const availableForParams = Math.max(40, terminalWidth - fixedLength - 2);
+  const paramsStr = formatParametersInline(result.parameters, availableForParams);
+  const paramsLabel = paramsStr ? `${chalk3.dim("(")}${paramsStr}${chalk3.dim(")")}` : "";
+  if (result.error) {
+    const errorMsg = result.error.length > 50 ? `${result.error.slice(0, 50)}\u2026` : result.error;
+    return `${chalk3.red("\u2717")} ${gadgetLabel}${paramsLabel} ${chalk3.red("error:")} ${errorMsg} ${timeLabel}`;
+  }
+  const outputLabel = outputStr === "no output" ? chalk3.dim(outputStr) : chalk3.green(outputStr);
   const icon = result.breaksLoop ? chalk3.yellow("\u23F9") : chalk3.green("\u2713");
   let summaryLine = `${icon} ${gadgetLabel}${paramsLabel} ${chalk3.dim("\u2192")} ${outputLabel} ${timeLabel}`;
   if (result.media && result.media.length > 0) {
@@ -3281,6 +3319,8 @@ var StreamProgress = class {
   delayTimeout = null;
   isRunning = false;
   hasRendered = false;
+  lastRenderLineCount = 0;
+  // Track lines rendered for multi-line clearing
   // Current call stats (streaming mode)
   mode = "cumulative";
   model = "";
@@ -3300,6 +3340,111 @@ var StreamProgress = class {
   totalCost = 0;
   iterations = 0;
   currentIteration = 0;
+  // In-flight gadget tracking for concurrent status display
+  inFlightGadgets = /* @__PURE__ */ new Map();
+  // Nested agent tracking for hierarchical subagent display
+  nestedAgents = /* @__PURE__ */ new Map();
+  // Nested gadget tracking for hierarchical subagent display
+  nestedGadgets = /* @__PURE__ */ new Map();
+  /**
+   * Add a gadget to the in-flight tracking (called when gadget_call event received).
+   * Triggers re-render to show the gadget in the status display.
+   */
+  addGadget(invocationId, name, params) {
+    this.inFlightGadgets.set(invocationId, { name, params, startTime: Date.now() });
+    if (this.isRunning && this.isTTY) {
+      this.render();
+    }
+  }
+  /**
+   * Remove a gadget from in-flight tracking (called when gadget_result event received).
+   * Triggers re-render to update the status display.
+   */
+  removeGadget(invocationId) {
+    this.inFlightGadgets.delete(invocationId);
+    if (this.isRunning && this.isTTY) {
+      this.render();
+    }
+  }
+  /**
+   * Check if there are any gadgets currently in flight.
+   */
+  hasInFlightGadgets() {
+    return this.inFlightGadgets.size > 0;
+  }
+  /**
+   * Add a nested agent LLM call (called when nested llm_call_start event received).
+   * Used to display hierarchical progress for subagent gadgets.
+   */
+  addNestedAgent(id, parentInvocationId, depth, model, iteration, inputTokens) {
+    this.nestedAgents.set(id, {
+      parentInvocationId,
+      depth,
+      model,
+      iteration,
+      startTime: Date.now(),
+      inputTokens
+    });
+    if (this.isRunning && this.isTTY) {
+      this.render();
+    }
+  }
+  /**
+   * Update a nested agent with completion info (called when nested llm_call_end event received).
+   */
+  updateNestedAgent(id, outputTokens) {
+    const agent = this.nestedAgents.get(id);
+    if (agent) {
+      agent.outputTokens = outputTokens;
+      if (this.isRunning && this.isTTY) {
+        this.render();
+      }
+    }
+  }
+  /**
+   * Remove a nested agent (called when the nested LLM call completes).
+   */
+  removeNestedAgent(id) {
+    this.nestedAgents.delete(id);
+    if (this.isRunning && this.isTTY) {
+      this.render();
+    }
+  }
+  /**
+   * Add a nested gadget call (called when nested gadget_call event received).
+   */
+  addNestedGadget(id, depth, parentInvocationId, name) {
+    this.nestedGadgets.set(id, {
+      depth,
+      parentInvocationId,
+      name,
+      startTime: Date.now()
+    });
+    if (this.isRunning && this.isTTY) {
+      this.render();
+    }
+  }
+  /**
+   * Remove a nested gadget (called when nested gadget_result event received).
+   */
+  removeNestedGadget(id) {
+    this.nestedGadgets.delete(id);
+    if (this.isRunning && this.isTTY) {
+      this.render();
+    }
+  }
+  /**
+   * Mark a nested gadget as completed (keeps it visible with ✓ indicator).
+   */
+  completeNestedGadget(id) {
+    const gadget = this.nestedGadgets.get(id);
+    if (gadget) {
+      gadget.completed = true;
+      if (this.isRunning && this.isTTY) {
+        this.render();
+      }
+    }
+  }
   /**
    * Starts a new LLM call. Switches to streaming mode.
    * @param model - Model name being used
@@ -3426,15 +3571,58 @@ var StreamProgress = class {
     this.isStreaming = true;
   }
   render() {
+    this.clearRenderedLines();
     const spinner = SPINNER_FRAMES[this.frameIndex++ % SPINNER_FRAMES.length];
+    const lines = [];
     if (this.mode === "streaming") {
-      this.renderStreamingMode(spinner);
+      lines.push(this.formatStreamingLine(spinner));
     } else {
-      this.renderCumulativeMode(spinner);
+      lines.push(this.formatCumulativeLine(spinner));
+    }
+    if (this.isTTY) {
+      for (const [gadgetId, gadget] of this.inFlightGadgets) {
+        const elapsed = ((Date.now() - gadget.startTime) / 1e3).toFixed(1);
+        const gadgetLine = `  ${chalk4.blue("\u23F5")} ${chalk4.magenta.bold(gadget.name)}${chalk4.dim("(...)")} ${chalk4.dim(elapsed + "s")}`;
+        lines.push(gadgetLine);
+        for (const [_agentId, nested] of this.nestedAgents) {
+          if (nested.parentInvocationId !== gadgetId) continue;
+          const indent = "  ".repeat(nested.depth + 1);
+          const nestedElapsed = ((Date.now() - nested.startTime) / 1e3).toFixed(1);
+          const tokens = nested.inputTokens ? ` ${chalk4.dim("\u2191")}${chalk4.yellow(formatTokens(nested.inputTokens))}` : "";
+          const outTokens = nested.outputTokens ? ` ${chalk4.dim("\u2193")}${chalk4.green(formatTokens(nested.outputTokens))}` : "";
+          const nestedLine = `${indent}${chalk4.cyan(`#${nested.iteration}`)} ${chalk4.dim(nested.model)}${tokens}${outTokens} ${chalk4.dim(nestedElapsed + "s")} ${chalk4.cyan(spinner)}`;
+          lines.push(nestedLine);
+        }
+        for (const [nestedId, nestedGadget] of this.nestedGadgets) {
+          if (nestedGadget.parentInvocationId === gadgetId) {
+            const indent = "  ".repeat(nestedGadget.depth + 1);
+            const nestedElapsed = ((Date.now() - nestedGadget.startTime) / 1e3).toFixed(1);
+            const icon = nestedGadget.completed ? chalk4.green("\u2713") : chalk4.blue("\u23F5");
+            const nestedGadgetLine = `${indent}${icon} ${chalk4.dim(nestedGadget.name + "(...)")} ${chalk4.dim(nestedElapsed + "s")}`;
+            lines.push(nestedGadgetLine);
+          }
+        }
+      }
     }
+    this.lastRenderLineCount = lines.length;
+    this.target.write("\r" + lines.join("\n"));
     this.hasRendered = true;
   }
-  renderStreamingMode(spinner) {
+  /**
+   * Clears the previously rendered lines (for multi-line status display).
+   */
+  clearRenderedLines() {
+    if (!this.hasRendered || this.lastRenderLineCount === 0) return;
+    this.target.write("\r\x1B[K");
+    for (let i = 1; i < this.lastRenderLineCount; i++) {
+      this.target.write("\x1B[1A\x1B[K");
+    }
+    this.target.write("\r");
+  }
+  /**
+   * Format the streaming mode progress line (returns string, doesn't write).
+   */
+  formatStreamingLine(spinner) {
     const elapsed = ((Date.now() - this.callStartTime) / 1e3).toFixed(1);
     const outTokens = this.callOutputTokensEstimated ? Math.round(this.callOutputChars / FALLBACK_CHARS_PER_TOKEN) : this.callOutputTokens;
     const parts = [];
@@ -3468,7 +3656,7 @@ var StreamProgress = class {
     if (callCost > 0) {
       parts.push(chalk4.cyan(`$${formatCost(callCost)}`));
     }
-    this.target.write(`\r${parts.join(chalk4.dim(" | "))} ${chalk4.cyan(spinner)}`);
+    return `${parts.join(chalk4.dim(" | "))} ${chalk4.cyan(spinner)}`;
   }
   /**
    * Calculates live cost estimate for the current streaming call.
@@ -3505,7 +3693,10 @@ var StreamProgress = class {
     }
     return this.callInputTokens / limits.contextWindow * 100;
   }
-  renderCumulativeMode(spinner) {
+  /**
+   * Format the cumulative mode progress line (returns string, doesn't write).
+   */
+  formatCumulativeLine(spinner) {
     const elapsed = ((Date.now() - this.totalStartTime) / 1e3).toFixed(1);
     const parts = [];
     if (this.model) {
@@ -3521,10 +3712,10 @@ var StreamProgress = class {
       parts.push(chalk4.dim("cost:") + chalk4.cyan(` $${formatCost(this.totalCost)}`));
     }
     parts.push(chalk4.dim(`${elapsed}s`));
-    this.target.write(`\r${parts.join(chalk4.dim(" | "))} ${chalk4.cyan(spinner)}`);
+    return `${parts.join(chalk4.dim(" | "))} ${chalk4.cyan(spinner)}`;
   }
   /**
-   * Pauses the progress indicator and clears the line.
+   * Pauses the progress indicator and clears all rendered lines.
    * Can be resumed with start().
    */
   pause() {
@@ -3538,10 +3729,9 @@ var StreamProgress = class {
       this.interval = null;
     }
     this.isRunning = false;
-    if (this.hasRendered) {
-      this.target.write("\r\x1B[K\x1B[0G");
-      this.hasRendered = false;
-    }
+    this.clearRenderedLines();
+    this.hasRendered = false;
+    this.lastRenderLineCount = 0;
   }
   /**
    * Completes the progress indicator and clears the line.
@@ -4118,6 +4308,38 @@ Denied: ${result.reason ?? "by user"}`
       "Maximize efficiency by batching independent operations in a single response."
     ].join(" ")
   );
+  if (!options.quiet) {
+    builder.withSubagentEventCallback((subagentEvent) => {
+      if (subagentEvent.type === "llm_call_start") {
+        const info = subagentEvent.event;
+        const subagentId = `${subagentEvent.gadgetInvocationId}:${info.iteration}`;
+        progress.addNestedAgent(
+          subagentId,
+          subagentEvent.gadgetInvocationId,
+          subagentEvent.depth,
+          info.model,
+          info.iteration,
+          info.inputTokens
+        );
+      } else if (subagentEvent.type === "llm_call_end") {
+        const info = subagentEvent.event;
+        const subagentId = `${subagentEvent.gadgetInvocationId}:${info.iteration}`;
+        progress.updateNestedAgent(subagentId, info.outputTokens);
+        setTimeout(() => progress.removeNestedAgent(subagentId), 100);
+      } else if (subagentEvent.type === "gadget_call") {
+        const gadgetEvent = subagentEvent.event;
+        progress.addNestedGadget(
+          gadgetEvent.call.invocationId,
+          subagentEvent.depth,
+          subagentEvent.gadgetInvocationId,
+          gadgetEvent.call.gadgetName
+        );
+      } else if (subagentEvent.type === "gadget_result") {
+        const resultEvent = subagentEvent.event;
+        progress.completeNestedGadget(resultEvent.result.invocationId);
+      }
+    });
+  }
   let agent;
   if (options.image || options.audio) {
     const parts = [text(prompt)];
@@ -4142,10 +4364,22 @@ Denied: ${result.reason ?? "by user"}`
   try {
     for await (const event of agent.run()) {
       if (event.type === "text") {
-        progress.pause();
         textBuffer += event.content;
+      } else if (event.type === "gadget_call") {
+        flushTextBuffer();
+        if (!options.quiet) {
+          progress.addGadget(
+            event.call.invocationId,
+            event.call.gadgetName,
+            event.call.parameters
+          );
+          progress.start();
+        }
       } else if (event.type === "gadget_result") {
         flushTextBuffer();
+        if (!options.quiet) {
+          progress.removeGadget(event.result.invocationId);
+        }
         progress.pause();
         if (options.quiet) {
           if (event.result.gadgetName === "TellUser" && event.result.parameters?.message) {
@@ -4160,6 +4394,10 @@ Denied: ${result.reason ?? "by user"}`
 `
           );
         }
+        if (progress.hasInFlightGadgets()) {
+          progress.start();
+        }
+      } else if (event.type === "subagent_event") {
       }
     }
   } catch (error) {