autotel-terminal 17.0.5 → 17.0.7

package/dist/cli.cjs

@@ -10,6 +10,9 @@ var autotel = require('autotel');
 var tracerProvider = require('autotel/tracer-provider');
 var ai = require('ai');
 var zod = require('zod');
+var core = require('@json-render/core');
+var catalog = require('@json-render/ink/catalog');
+var ink$1 = require('@json-render/ink');
 require('autotel/exporters');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -828,17 +831,31 @@ You have tools to query the telemetry data precisely. Use them to answer questio
 - getTraceDetail: deep dive into a specific trace
 - searchSpans: search spans by name
 - searchLogs: search logs by message content
+- renderUI: display rich terminal UI (tables, charts, badges)
 
-Use tools first to gather data, then synthesize a concise answer.
-Keep responses under 300 words.
+## Workflow
+1. Use data tools first to gather data
+2. Use renderUI to display structured results as tables, charts, or cards
+3. Add a brief text explanation after the rendered UI
+
+## When to use renderUI
+Use renderUI for tables, comparisons, and metrics. Do NOT use it for short text answers.
+
+renderUI spec format: { root: "id", elements: { "id": { type: "ComponentName", props: {...}, children: [] } } }
+
+Components: Table (columns, rows), KeyValue (label, value), Badge (label, variant: success/error/warning/info), BarChart (data: [{label,value}]), Card (title, children), Heading (text), Divider, Text (text, color, bold), Box (flexDirection, children).
+
+Table example: { type: "Table", props: { columns: [{ header: "Name", key: "name" }], rows: [{ name: "api" }] }, children: [] }
+
+Keep text responses under 300 words.
 Use specific span names, durations, and attribute values from the data.
-Format for a narrow terminal column \u2014 use short paragraphs, not wide tables.
 
 Current dashboard summary:
 ${contextJson}`;
 }
+var COMPONENT_NAMES = Object.keys(catalog.standardComponentDefinitions);
 var t = ai.tool;
-function createTelemetryTools(ctx) {
+function createTelemetryTools(ctx, onRenderUI) {
   return {
     getOverviewStats: t({
       description: "Get high-level stats: total spans, error count, average duration, p95 duration, and service count.",
@@ -1006,6 +1023,33 @@ function createTelemetryTools(ctx) {
           attrs: l.attributes
         }));
       }
+    }),
+    renderUI: t({
+      description: "Render rich terminal UI (tables, charts, badges) to display structured data. Use this when showing tabular data, comparisons, or metrics \u2014 not for short text answers. Available components: Table (columns + rows), KeyValue (key-value pairs), Badge (status labels: default/info/success/warning/error), BarChart (horizontal bars with labels), Card (grouped content with title), Heading (section title), Divider (separator), Text (styled text), Box (layout container).",
+      parameters: zod.z.object({
+        spec: zod.z.object({
+          root: zod.z.string().describe("ID of the root element"),
+          elements: zod.z.record(
+            zod.z.string(),
+            zod.z.object({
+              type: zod.z.enum(COMPONENT_NAMES).describe("Component name"),
+              props: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+              children: zod.z.array(zod.z.string()).describe("Child element keys")
+            })
+          ).describe("Map of element ID to component definition")
+        }).describe("json-render spec defining the UI to display")
+      }),
+      execute: async ({ spec }) => {
+        const validation = core.validateSpec(spec);
+        if (!validation.valid) {
+          return {
+            rendered: false,
+            error: validation.issues.map((i) => i.message).join("; ")
+          };
+        }
+        onRenderUI?.(spec);
+        return { rendered: true };
+      }
     })
   };
 }
@@ -1072,11 +1116,11 @@ function Dashboard({
   const throttleRef = react.useRef(null);
   const pendingSpansRef = react.useRef([]);
   const [logs, setLogs] = react.useState([]);
-  const [aiActive, setAiActive] = react.useState(false);
   const [aiMessages, setAiMessages] = react.useState([]);
   const [aiInput, setAiInput] = react.useState("");
   const [aiState, setAiState] = react.useState({ status: "unconfigured" });
   const [aiInputMode, setAiInputMode] = react.useState(false);
+  const [aiSpec, setAiSpec] = react.useState(null);
   const aiModelRef = react.useRef(null);
   const aiAbortRef = react.useRef(null);
   react.useEffect(() => {
@@ -1289,6 +1333,7 @@ function Dashboard({
     setAiInput("");
     const abort = new AbortController();
     aiAbortRef.current = abort;
+    setAiSpec(null);
     setAiState({ status: "streaming", abortController: abort });
     const toolCtx = {
       spans,
@@ -1298,7 +1343,7 @@ function Dashboard({
       serviceStats,
       errorSummaries
     };
-    const tools = createTelemetryTools(toolCtx);
+    const tools = createTelemetryTools(toolCtx, (spec) => setAiSpec(spec));
     const statsContext = JSON.stringify({
       viewMode,
       stats: {
@@ -1344,15 +1389,31 @@ Currently viewing trace ${drilldownTraceId}. This trace has ${drilldownSpans.len
           return updated;
         });
       }
+      if (!fullText.trim()) {
+        setAiMessages((prev) => {
+          const updated = [...prev];
+          const lastMsg = updated.at(-1);
+          if (lastMsg?.role === "assistant" && !lastMsg.content.trim()) {
+            updated[updated.length - 1] = {
+              role: "assistant",
+              content: "(No response from model \u2014 try a simpler question or a larger model)"
+            };
+          }
+          return updated;
+        });
+      }
       setAiState({ status: "idle" });
     } catch (error) {
       if (abort.signal.aborted) {
         setAiState({ status: "idle" });
         return;
       }
+      const errorMsg = error instanceof Error ? error.message : String(error);
+      process.stderr.write(`[autotel-terminal] AI error: ${errorMsg}
+`);
       setAiState({
         status: "error",
-        message: error instanceof Error ? error.message : String(error)
+        message: errorMsg
       });
     } finally {
       aiAbortRef.current = null;
@@ -1437,7 +1498,7 @@ Currently viewing trace ${drilldownTraceId}. This trace has ${drilldownSpans.len
             aiAbortRef.current?.abort();
           } else {
             setAiInputMode(false);
-            setAiActive(false);
+            setViewMode("trace");
           }
           return;
         }
@@ -1457,14 +1518,19 @@ Currently viewing trace ${drilldownTraceId}. This trace has ${drilldownSpans.len
         return;
       }
       if (input === "a") {
-        setAiActive((v) => !v);
-        if (aiActive) {
+        if (viewMode === "ai") {
+          setViewMode("trace");
           setAiInputMode(false);
         } else {
+          setViewMode("ai");
           if (aiState.status !== "unconfigured") {
             setAiInputMode(true);
           }
         }
+        setSelected(0);
+        setDrilldownTraceId(null);
+        setDrilldownSelectedIndex(0);
+        setDrilldownScrollOffset(0);
         return;
       }
       if (key.escape) {
@@ -1772,7 +1838,7 @@ ${json}
     { isActive: isRawModeSupported }
   );
   const headerRight = recording ? "[Recording]" : paused ? "[Paused]" : "[Live]";
-  const headerModeLabel = viewMode === "trace" ? "traces" : viewMode === "span" ? "spans" : viewMode === "log" ? "logs" : viewMode === "service-summary" ? "services" : viewMode === "topology" ? "topology" : "errors";
+  const headerModeLabel = viewMode === "trace" ? "traces" : viewMode === "span" ? "spans" : viewMode === "log" ? "logs" : viewMode === "service-summary" ? "services" : viewMode === "topology" ? "topology" : viewMode === "ai" ? "AI" : "errors";
   const showNewError = newErrorCount > 0;
   function renderTreeRow(node, index) {
     const isSel = drilldownTraceId != null && index === drilldownSelectedIndex;
@@ -1853,10 +1919,10 @@ ${json}
               "\u2026"
             ] })
           ] }) : /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "row", justifyContent: "space-between", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: drilldownTraceId == null ? "\u2191/\u2193 select \u2022 Enter open \u2022 Tab cycle tabs \u2022 Esc back \u2022 T trace \u2022 L logs \u2022 a AI \u2022 ? help" : "\u2191/\u2193 select \u2022 Tab cycle tabs \u2022 Esc back \u2022 T trace \u2022 L logs \u2022 a AI \u2022 ? help" }),
-            /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: viewMode === "trace" ? `traces ${filteredSummaries.length}/${traceSummaries.length}` : viewMode === "span" ? `spans ${filteredSpans.length}/${spans.length}` : viewMode === "service-summary" ? `services ${serviceStats.length}` : viewMode === "errors" ? `errors ${filteredErrorSummaries.length}/${errorSummaries.length}` : viewMode === "topology" ? `services ${serviceGraph.services.length} \xB7 edges ${serviceGraph.edges.length}` : `logs ${filteredLogs.length}/${logs.length}` })
+            /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: drilldownTraceId == null ? "\u2191/\u2193 select \u2022 Enter open \u2022 Tab cycle tabs \u2022 Esc back \u2022 t trace \u2022 l logs \u2022 a AI \u2022 ? help" : "\u2191/\u2193 select \u2022 Tab cycle tabs \u2022 Esc back \u2022 t trace \u2022 l logs \u2022 a AI \u2022 ? help" }),
+            /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: viewMode === "trace" ? `traces ${filteredSummaries.length}/${traceSummaries.length}` : viewMode === "span" ? `spans ${filteredSpans.length}/${spans.length}` : viewMode === "service-summary" ? `services ${serviceStats.length}` : viewMode === "errors" ? `errors ${filteredErrorSummaries.length}/${errorSummaries.length}` : viewMode === "topology" ? `services ${serviceGraph.services.length} \xB7 edges ${serviceGraph.edges.length}` : viewMode === "ai" ? `messages ${aiMessages.length}` : `logs ${filteredLogs.length}/${logs.length}` })
           ] }),
-          showHelp && /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Views: t/l/v/E/G \u2022 Search: / \u2022 Filters: e/S/R/H/f/x \u2022 Capture: p/r/J \u2022 AI: a \u2022 Clear: c" })
+          showHelp && /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Views: t/l/v/E/G/a \u2022 Search: / \u2022 Filters: e/S/R/H/f/x \u2022 Capture: p/r/J \u2022 Clear: c" })
         ] }),
         /* @__PURE__ */ jsxRuntime.jsx(ink.Box, { marginBottom: 0, children: /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: spanFilters.serviceName || spanFilters.route || spanFilters.statusGroup !== "all" || spanFilters.traceId ? `filters:${spanFilters.serviceName ? ` service=${spanFilters.serviceName}` : ""}${spanFilters.route ? ` route=${spanFilters.route}` : ""}${spanFilters.statusGroup && spanFilters.statusGroup !== "all" ? ` status=${spanFilters.statusGroup}` : ""}${spanFilters.traceId ? ` trace=${spanFilters.traceId.slice(0, 8)}\u2026` : ""}` : "filters: none" }) }),
         viewMode === "topology" && /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [
@@ -1867,7 +1933,34 @@ ${json}
             return /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { color: hasErr ? "red" : void 0, children: line }, `topo-${i}`);
           }) })
         ] }),
-        viewMode !== "topology" && (drilldownTraceId != null ? /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, paddingY: 0, children: [
+        viewMode === "ai" && /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, paddingY: 0, children: [
+          /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { marginBottom: 1, justifyContent: "space-between", children: [
+            /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { bold: true, children: "AI Assistant" }),
+            /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: aiState.status === "streaming" ? "(streaming...)" : aiState.status === "unconfigured" ? "(no provider)" : aiState.status === "error" ? "(error)" : "" })
+          ] }),
+          aiState.status === "unconfigured" ? /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "column", children: [
+            /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "No AI provider configured." }),
+            /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Set AI_PROVIDER and AI_MODEL env vars, or start Ollama locally." }),
+            /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Press a to close this view." })
+          ] }) : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+            aiMessages.length === 0 && aiState.status !== "error" && /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Ask a question about your telemetry data. Press Enter to send." }),
+            aiMessages.slice(-10).map((msg, i) => /* @__PURE__ */ jsxRuntime.jsx(ink.Box, { flexDirection: "column", marginBottom: msg.role === "assistant" ? 1 : 0, children: /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { color: msg.role === "user" ? "cyan" : void 0, children: [
+              msg.role === "user" ? "> " : "",
+              msg.content.slice(0, 1e3),
+              msg.content.length > 1e3 ? "..." : ""
+            ] }) }, `ai-msg-${i}`)),
+            aiSpec && /* @__PURE__ */ jsxRuntime.jsx(ink.Box, { flexDirection: "column", marginBottom: 1, borderStyle: "single", borderColor: "gray", paddingX: 1, children: /* @__PURE__ */ jsxRuntime.jsx(ink$1.Renderer, { spec: aiSpec }) }),
+            aiState.status === "error" && /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { color: "red", children: [
+              "Error: ",
+              aiState.message
+            ] }),
+            /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { marginTop: 1, borderStyle: "single", borderColor: "cyan", paddingX: 1, children: [
+              /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { color: "cyan", children: "> " }),
+              /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { children: aiInput || (aiInputMode ? "(type your question)" : "(press a to focus)") })
+            ] })
+          ] })
+        ] }),
+        viewMode !== "topology" && viewMode !== "ai" && (drilldownTraceId != null ? /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, paddingY: 0, children: [
           /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { marginBottom: 0, flexDirection: "column", children: [
             /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { bold: true, children: [
               "Trace ",
@@ -2346,49 +2439,7 @@ ${json}
               borderColor: "gray",
               paddingX: 1,
               paddingY: 0,
-              children: aiActive ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-                /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { marginBottom: 1, justifyContent: "space-between", children: [
-                  /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { bold: true, children: "AI Assistant" }),
-                  /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: aiState.status === "streaming" ? "(streaming...)" : aiState.status === "unconfigured" ? "(no provider)" : aiState.status === "error" ? "(error)" : "" })
-                ] }),
-                aiState.status === "unconfigured" ? /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "column", children: [
-                  /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "No AI provider configured." }),
-                  /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Set AI_PROVIDER and AI_MODEL env vars, or start Ollama locally." }),
-                  /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Press 'a' to close this panel." })
-                ] }) : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-                  aiMessages.length === 0 && aiState.status !== "error" && /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Ask a question about your telemetry data. Press Enter to send." }),
-                  aiMessages.slice(-10).map((msg, i) => /* @__PURE__ */ jsxRuntime.jsx(
-                    ink.Box,
-                    {
-                      flexDirection: "column",
-                      marginBottom: msg.role === "assistant" ? 1 : 0,
-                      children: /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { color: msg.role === "user" ? "cyan" : void 0, children: [
-                        msg.role === "user" ? "> " : "",
-                        msg.content.slice(0, 500),
-                        msg.content.length > 500 ? "..." : ""
-                      ] })
-                    },
-                    i
-                  )),
-                  aiState.status === "error" && /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { color: "red", children: [
-                    "Error: ",
-                    aiState.message
-                  ] }),
-                  /* @__PURE__ */ jsxRuntime.jsxs(
-                    ink.Box,
-                    {
-                      marginTop: 1,
-                      borderStyle: "single",
-                      borderColor: "cyan",
-                      paddingX: 1,
-                      children: [
-                        /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { color: "cyan", children: "> " }),
-                        /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { children: aiInput || (aiInputMode ? "(type your question)" : "(press a to focus)") })
-                      ]
-                    }
-                  )
-                ] })
-              ] }) : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+              children: /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
                 /* @__PURE__ */ jsxRuntime.jsx(ink.Box, { marginBottom: 1, children: /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { bold: true, children: "Details" }) }),
                 viewMode === "errors" ? (() => {
                   const e = filteredErrorSummaries[selected] ?? null;