autotel-terminal 2.0.0

package/dist/index.cjs

@@ -0,0 +1,392 @@
+'use strict';
+
+var react = require('react');
+var ink = require('ink');
+var autotel = require('autotel');
+var tracerProvider = require('autotel/tracer-provider');
+var exporters = require('autotel/exporters');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/index.tsx
+
+// src/streaming-processor.ts
+var StreamingSpanProcessor = class {
+  wrappedProcessor;
+  subscribers = /* @__PURE__ */ new Set();
+  /**
+   * Create a new streaming span processor
+   *
+   * @param wrappedProcessor - The processor to wrap and forward spans to.
+   *                          If null, spans are only emitted to subscribers (no forwarding).
+   */
+  constructor(wrappedProcessor = null) {
+    this.wrappedProcessor = wrappedProcessor;
+  }
+  onStart(span, parentContext) {
+    if (this.wrappedProcessor) {
+      this.wrappedProcessor.onStart(span, parentContext);
+    }
+  }
+  onEnd(span) {
+    for (const subscriber of this.subscribers) {
+      try {
+        subscriber(span);
+      } catch (error) {
+        console.error("[autotel-terminal] Subscriber error:", error);
+      }
+    }
+    if (this.wrappedProcessor) {
+      this.wrappedProcessor.onEnd(span);
+    }
+  }
+  /**
+   * Subscribe to span end events
+   *
+   * @param callback - Function called when a span ends
+   * @returns Unsubscribe function
+   *
+   * @example
+   * ```typescript
+   * const unsubscribe = processor.subscribe((span) => {
+   *   console.log('Span ended:', span.name)
+   * })
+   *
+   * // Later, unsubscribe
+   * unsubscribe()
+   * ```
+   */
+  subscribe(callback) {
+    this.subscribers.add(callback);
+    return () => this.subscribers.delete(callback);
+  }
+  async forceFlush() {
+    if (this.wrappedProcessor) {
+      return this.wrappedProcessor.forceFlush();
+    }
+  }
+  async shutdown() {
+    this.subscribers.clear();
+    if (this.wrappedProcessor) {
+      return this.wrappedProcessor.shutdown();
+    }
+  }
+};
+function timeToMs([seconds, nanoseconds]) {
+  return seconds * 1e3 + nanoseconds / 1e6;
+}
+function mapStatus(code) {
+  if (code === autotel.SpanStatusCode.OK) {
+    return "OK";
+  }
+  if (code === autotel.SpanStatusCode.ERROR) {
+    return "ERROR";
+  }
+  return "UNSET";
+}
+function mapKind(kind) {
+  const kindMap = {
+    [autotel.SpanKind.INTERNAL]: "INTERNAL",
+    [autotel.SpanKind.SERVER]: "SERVER",
+    [autotel.SpanKind.CLIENT]: "CLIENT",
+    [autotel.SpanKind.PRODUCER]: "PRODUCER",
+    [autotel.SpanKind.CONSUMER]: "CONSUMER"
+  };
+  return kindMap[kind] ?? "UNKNOWN";
+}
+function createTerminalSpanStream(processor) {
+  return {
+    onSpanEnd(callback) {
+      return processor.subscribe((span) => {
+        const spanContext = span.spanContext();
+        const parentSpanId = "parentSpanId" in span && typeof span.parentSpanId === "string" ? span.parentSpanId : void 0;
+        const startTime = timeToMs(span.startTime);
+        const endTime = timeToMs(span.endTime);
+        const durationMs = endTime - startTime;
+        const event = {
+          name: span.name,
+          spanId: spanContext.spanId,
+          traceId: spanContext.traceId,
+          parentSpanId,
+          startTime,
+          endTime,
+          durationMs,
+          status: mapStatus(span.status.code),
+          kind: mapKind(span.kind),
+          attributes: span.attributes
+        };
+        callback(event);
+      });
+    }
+  };
+}
+function ms(n) {
+  if (n < 1e3) return `${n.toFixed(0)}ms`;
+  return `${(n / 1e3).toFixed(2)}s`;
+}
+function truncate(s, width) {
+  if (s.length <= width) return s;
+  return s.slice(0, Math.max(0, width - 1)) + "\u2026";
+}
+function Dashboard({
+  title,
+  showStats,
+  maxSpans,
+  colors,
+  stream
+}) {
+  const [paused, setPaused] = react.useState(false);
+  const [spans, setSpans] = react.useState([]);
+  const [selected, setSelected] = react.useState(0);
+  const [filterErrorsOnly, setFilterErrorsOnly] = react.useState(false);
+  react.useEffect(() => {
+    const unsubscribe = stream.onSpanEnd((span) => {
+      if (paused) return;
+      setSpans((prev) => {
+        const next = [span, ...prev];
+        return next.slice(0, maxSpans);
+      });
+      setSelected(0);
+    });
+    return unsubscribe;
+  }, [stream, paused, maxSpans]);
+  const filtered = react.useMemo(() => {
+    const list = filterErrorsOnly ? spans.filter((s) => s.status === "ERROR") : spans;
+    return list;
+  }, [spans, filterErrorsOnly]);
+  const stats = react.useMemo(() => {
+    const total = spans.length;
+    const errors = spans.filter((s) => s.status === "ERROR").length;
+    const avg = total ? spans.reduce((a, s) => a + s.durationMs, 0) / total : 0;
+    const p95 = total ? (() => {
+      const sorted = spans.map((s) => s.durationMs).toSorted((a, b) => a - b);
+      return sorted[Math.floor(sorted.length * 0.95)] ?? 0;
+    })() : 0;
+    return { total, errors, avg, p95 };
+  }, [spans]);
+  const current = filtered[selected];
+  ink.useInput((input, key) => {
+    if (key.upArrow) setSelected((i) => Math.max(0, i - 1));
+    if (key.downArrow)
+      setSelected((i) => Math.min(filtered.length - 1, i + 1));
+    if (input === "p") setPaused((p) => !p);
+    if (input === "e") setFilterErrorsOnly((v) => !v);
+    if (input === "c") {
+      setSpans([]);
+      setSelected(0);
+    }
+  });
+  const headerRight = paused ? "[Paused]" : "[Live]";
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    ink.Box,
+    {
+      flexDirection: "column",
+      borderStyle: "round",
+      padding: 1,
+      borderColor: colors ? "cyan" : void 0,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { justifyContent: "space-between", marginBottom: 1, children: [
+          /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { bold: true, children: [
+            "\u{1F52D} ",
+            title
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { color: paused ? "yellow" : "green", children: headerRight })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { marginBottom: 1, flexDirection: "row", justifyContent: "space-between", children: [
+          /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "\u2191/\u2193 select \u2022 p pause \u2022 e errors-only \u2022 c clear \u2022 Ctrl+C exit" }),
+          /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { dimColor: true, children: [
+            "showing ",
+            filtered.length,
+            "/",
+            spans.length
+          ] })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "row", gap: 2, children: [
+          /* @__PURE__ */ jsxRuntime.jsxs(
+            ink.Box,
+            {
+              flexDirection: "column",
+              width: "55%",
+              borderStyle: "single",
+              borderColor: "gray",
+              paddingX: 1,
+              paddingY: 0,
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { marginTop: 0, marginBottom: 1, children: [
+                  /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { bold: true, children: "Recent spans" }),
+                  filterErrorsOnly && /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { color: "red", children: " (errors only)" })
+                ] }),
+                filtered.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "No spans yet. Generate some traffic\u2026" }) : filtered.slice(0, 20).map((s, i) => {
+                  const isSel = i === selected;
+                  const statusColor = s.status === "ERROR" ? "red" : s.durationMs > 500 ? "yellow" : "green";
+                  return /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { flexDirection: "row", children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { color: isSel ? "cyan" : void 0, children: isSel ? "\u203A " : "  " }),
+                    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { color: colors ? statusColor : void 0, children: truncate(s.name, 26) }),
+                    /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { dimColor: true, children: [
+                      " ",
+                      ms(s.durationMs)
+                    ] }),
+                    /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { dimColor: true, children: [
+                      " ",
+                      truncate(s.traceId, 10)
+                    ] })
+                  ] }, s.spanId);
+                })
+              ]
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsxs(
+            ink.Box,
+            {
+              flexDirection: "column",
+              width: "45%",
+              borderStyle: "single",
+              borderColor: "gray",
+              paddingX: 1,
+              paddingY: 0,
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx(ink.Box, { marginBottom: 1, children: /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { bold: true, children: "Details" }) }),
+                current ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+                  /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Name: " }),
+                    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { children: current.name })
+                  ] }),
+                  /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Status: " }),
+                    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { color: current.status === "ERROR" ? "red" : "green", children: current.status })
+                  ] }),
+                  /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Duration: " }),
+                    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { children: ms(current.durationMs) })
+                  ] }),
+                  /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { dimColor: true, children: [
+                    "Trace: ",
+                    current.traceId
+                  ] }),
+                  /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { dimColor: true, children: [
+                    "Span: ",
+                    current.spanId
+                  ] }),
+                  current.parentSpanId && /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { dimColor: true, children: [
+                    "Parent: ",
+                    current.parentSpanId
+                  ] }),
+                  current.kind && /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { dimColor: true, children: [
+                    "Kind: ",
+                    current.kind
+                  ] }),
+                  /* @__PURE__ */ jsxRuntime.jsxs(ink.Box, { marginTop: 1, flexDirection: "column", children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { bold: true, children: "Attributes" }),
+                    current.attributes && Object.keys(current.attributes).length > 0 ? Object.entries(current.attributes).slice(0, 12).map(([k, v]) => /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { dimColor: true, children: [
+                      truncate(k, 22),
+                      ": ",
+                      truncate(String(v), 34)
+                    ] }, k)) : /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "(none)" })
+                  ] })
+                ] }) : /* @__PURE__ */ jsxRuntime.jsx(ink.Text, { dimColor: true, children: "Select a span to view details." })
+              ]
+            }
+          )
+        ] }),
+        showStats && /* @__PURE__ */ jsxRuntime.jsx(ink.Box, { marginTop: 1, borderStyle: "single", borderColor: "gray", paddingX: 1, children: /* @__PURE__ */ jsxRuntime.jsxs(ink.Text, { dimColor: true, children: [
+          "Spans: ",
+          stats.total,
+          " | Errors: ",
+          stats.errors,
+          " | Avg: ",
+          ms(stats.avg),
+          " ",
+          "| P95: ",
+          ms(stats.p95)
+        ] }) })
+      ]
+    }
+  );
+}
+var globalStreamingProcessor = null;
+function canAddSpanProcessor(provider) {
+  return typeof provider === "object" && provider !== null && "addSpanProcessor" in provider && typeof provider.addSpanProcessor === "function";
+}
+function renderTerminal(options = {}, stream) {
+  const title = options.title ?? "Autotel Trace Inspector";
+  const showStats = options.showStats !== false;
+  const maxSpans = options.maxSpans ?? 100;
+  const colors = options.colors ?? Boolean(process.stdout.isTTY);
+  if (stream) {
+    try {
+      ink.render(
+        /* @__PURE__ */ jsxRuntime.jsx(
+          Dashboard,
+          {
+            title,
+            showStats,
+            maxSpans,
+            colors,
+            stream
+          }
+        )
+      );
+    } catch (error) {
+      console.error("[autotel-terminal] Failed to render dashboard:", error);
+    }
+    return;
+  }
+  let provider;
+  try {
+    provider = tracerProvider.getAutotelTracerProvider();
+  } catch (error) {
+    console.error(
+      "[autotel-terminal] Failed to get tracer provider. Call init() first or provide a stream.",
+      error
+    );
+    return;
+  }
+  if (!provider) {
+    console.error(
+      "[autotel-terminal] No tracer provider found. Call init() first or provide a stream."
+    );
+    return;
+  }
+  if (!canAddSpanProcessor(provider)) {
+    console.error(
+      "[autotel-terminal] TracerProvider does not support addSpanProcessor. Provide a stream manually."
+    );
+    return;
+  }
+  globalStreamingProcessor = new StreamingSpanProcessor(null);
+  const terminalStream = createTerminalSpanStream(globalStreamingProcessor);
+  provider.addSpanProcessor(globalStreamingProcessor);
+  try {
+    ink.render(
+      /* @__PURE__ */ jsxRuntime.jsx(
+        Dashboard,
+        {
+          title,
+          showStats,
+          maxSpans,
+          colors,
+          stream: terminalStream
+        }
+      )
+    );
+  } catch (error) {
+    console.error("[autotel-terminal] Failed to render dashboard:", error);
+  }
+}
+
+Object.defineProperty(exports, "SpanKind", {
+  enumerable: true,
+  get: function () { return autotel.SpanKind; }
+});
+Object.defineProperty(exports, "SpanStatusCode", {
+  enumerable: true,
+  get: function () { return autotel.SpanStatusCode; }
+});
+Object.defineProperty(exports, "PrettyConsoleExporter", {
+  enumerable: true,
+  get: function () { return exporters.PrettyConsoleExporter; }
+});
+exports.StreamingSpanProcessor = StreamingSpanProcessor;
+exports.createTerminalSpanStream = createTerminalSpanStream;
+exports.renderTerminal = renderTerminal;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/streaming-processor.ts","../src/span-stream.ts","../src/index.tsx"],"names":["SpanStatusCode","SpanKind","useState","useEffect","useMemo","useInput","jsxs","Box","Text","jsx","Fragment","render","getAutotelTracerProvider"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Streaming Span Processor\n *\n * A span processor that emits ReadableSpan objects to subscribers.\n * This allows real-time streaming of spans to terminal dashboards and other consumers.\n *\n * @example Basic usage\n * ```typescript\n * import { StreamingSpanProcessor } from 'autotel-terminal'\n * import { BatchSpanProcessor } from 'autotel/processors'\n * import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http'\n *\n * const exporter = new OTLPTraceExporter({ url: 'http://localhost:4318/v1/traces' })\n * const baseProcessor = new BatchSpanProcessor(exporter)\n * const streamingProcessor = new StreamingSpanProcessor(baseProcessor)\n *\n * // Subscribe to spans\n * const unsubscribe = streamingProcessor.subscribe((span) => {\n *   console.log('Span ended:', span.name)\n * })\n *\n * // Later, unsubscribe\n * unsubscribe()\n * ```\n */\n\nimport type {\n  SpanProcessor,\n  ReadableSpan,\n} from '@opentelemetry/sdk-trace-base';\nimport type { Context } from '@opentelemetry/api';\nimport type { Span } from '@opentelemetry/sdk-trace-base';\n\n/**\n * Span processor that wraps another processor and emits spans to subscribers\n *\n * This processor forwards all span operations to a wrapped processor while\n * also emitting completed spans to registered subscribers. This enables\n * real-time streaming of spans to terminal dashboards, loggers, or other\n * consumers without interfering with normal span processing.\n */\nexport class StreamingSpanProcessor implements SpanProcessor {\n  private wrappedProcessor: SpanProcessor | null;\n  private subscribers = new Set<(span: ReadableSpan) => void>();\n\n  /**\n   * Create a new streaming span processor\n   *\n   * @param wrappedProcessor - The processor to wrap and forward spans to.\n   *                          If null, spans are only emitted to subscribers (no forwarding).\n   */\n  constructor(wrappedProcessor: SpanProcessor | null = null) {\n    this.wrappedProcessor = wrappedProcessor;\n  }\n\n  onStart(span: Span, parentContext: Context): void {\n    if (this.wrappedProcessor) {\n      this.wrappedProcessor.onStart(span, parentContext);\n    }\n  }\n\n  onEnd(span: ReadableSpan): void {\n    // Emit to all subscribers first\n    for (const subscriber of this.subscribers) {\n      try {\n        subscriber(span);\n      } catch (error) {\n        // Don't let subscriber errors break span processing\n        console.error('[autotel-terminal] Subscriber error:', error);\n      }\n    }\n\n    // Forward to wrapped processor\n    if (this.wrappedProcessor) {\n      this.wrappedProcessor.onEnd(span);\n    }\n  }\n\n  /**\n   * Subscribe to span end events\n   *\n   * @param callback - Function called when a span ends\n   * @returns Unsubscribe function\n   *\n   * @example\n   * ```typescript\n   * const unsubscribe = processor.subscribe((span) => {\n   *   console.log('Span ended:', span.name)\n   * })\n   *\n   * // Later, unsubscribe\n   * unsubscribe()\n   * ```\n   */\n  subscribe(callback: (span: ReadableSpan) => void): () => void {\n    this.subscribers.add(callback);\n    return () => this.subscribers.delete(callback);\n  }\n\n  async forceFlush(): Promise<void> {\n    if (this.wrappedProcessor) {\n      return this.wrappedProcessor.forceFlush();\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    // Clear subscribers\n    this.subscribers.clear();\n    if (this.wrappedProcessor) {\n      return this.wrappedProcessor.shutdown();\n    }\n  }\n}\n","/**\n * Terminal Span Stream\n *\n * Converts OpenTelemetry ReadableSpan objects to TerminalSpanEvent format\n * for consumption by the terminal dashboard.\n */\n\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { SpanStatusCode, SpanKind } from 'autotel';\nimport type { StreamingSpanProcessor } from './streaming-processor';\n\n/**\n * Span event format for terminal dashboard consumption\n */\nexport interface TerminalSpanEvent {\n  /** Span name */\n  name: string;\n  /** Span ID (hex string) */\n  spanId: string;\n  /** Trace ID (hex string) */\n  traceId: string;\n  /** Parent span ID (hex string, optional) */\n  parentSpanId?: string;\n  /** Start time in milliseconds since epoch */\n  startTime: number;\n  /** End time in milliseconds since epoch */\n  endTime: number;\n  /** Duration in milliseconds */\n  durationMs: number;\n  /** Span status */\n  status: 'OK' | 'ERROR' | 'UNSET';\n  /** Span kind (INTERNAL, SERVER, CLIENT, etc.) */\n  kind?: string;\n  /** Span attributes */\n  attributes?: Record<string, unknown>;\n}\n\n/**\n * Stream interface for terminal dashboard\n */\nexport interface TerminalSpanStream {\n  /**\n   * Subscribe to span end events\n   *\n   * @param callback - Called when a span ends\n   * @returns Unsubscribe function\n   */\n  onSpanEnd(callback: (event: TerminalSpanEvent) => void): () => void;\n}\n\n/**\n * Convert OpenTelemetry time tuple to milliseconds\n */\nfunction timeToMs([seconds, nanoseconds]: [number, number]): number {\n  return seconds * 1000 + nanoseconds / 1_000_000;\n}\n\n/**\n * Map SpanStatusCode to string\n */\nfunction mapStatus(code: SpanStatusCode): 'OK' | 'ERROR' | 'UNSET' {\n  if (code === SpanStatusCode.OK) {\n    return 'OK';\n  }\n  if (code === SpanStatusCode.ERROR) {\n    return 'ERROR';\n  }\n  return 'UNSET';\n}\n\n/**\n * Map SpanKind number to string\n */\nfunction mapKind(kind: SpanKind): string {\n  const kindMap: Record<number, string> = {\n    [SpanKind.INTERNAL]: 'INTERNAL',\n    [SpanKind.SERVER]: 'SERVER',\n    [SpanKind.CLIENT]: 'CLIENT',\n    [SpanKind.PRODUCER]: 'PRODUCER',\n    [SpanKind.CONSUMER]: 'CONSUMER',\n  };\n  return kindMap[kind] ?? 'UNKNOWN';\n}\n\n/**\n * Create a terminal span stream from a streaming processor\n *\n * @param processor - The streaming span processor to subscribe to\n * @returns Terminal span stream interface\n *\n * @example\n * ```typescript\n * import { StreamingSpanProcessor } from 'autotel-terminal'\n * import { createTerminalSpanStream } from 'autotel-terminal'\n *\n * const processor = new StreamingSpanProcessor(baseProcessor)\n * const stream = createTerminalSpanStream(processor)\n *\n * stream.onSpanEnd((event) => {\n *   console.log('Span:', event.name, event.durationMs + 'ms')\n * })\n * ```\n */\nexport function createTerminalSpanStream(\n  processor: StreamingSpanProcessor,\n): TerminalSpanStream {\n  return {\n    onSpanEnd(callback) {\n      return processor.subscribe((span: ReadableSpan) => {\n        const spanContext = span.spanContext();\n        // parentSpanId is not part of the standard ReadableSpan interface\n        // but some implementations (like Node.js SDK) include it\n        const parentSpanId =\n          'parentSpanId' in span && typeof span.parentSpanId === 'string'\n            ? span.parentSpanId\n            : undefined;\n\n        // Convert time tuples to milliseconds\n        const startTime = timeToMs(span.startTime);\n        const endTime = timeToMs(span.endTime);\n        const durationMs = endTime - startTime;\n\n        // Create terminal event\n        const event: TerminalSpanEvent = {\n          name: span.name,\n          spanId: spanContext.spanId,\n          traceId: spanContext.traceId,\n          parentSpanId,\n          startTime,\n          endTime,\n          durationMs,\n          status: mapStatus(span.status.code),\n          kind: mapKind(span.kind),\n          attributes: span.attributes as Record<string, unknown>,\n        };\n\n        callback(event);\n      });\n    },\n  };\n}\n","/**\n * Terminal Dashboard for Autotel\n *\n * Beautiful react-ink powered dashboard for viewing traces in real-time.\n *\n * @example Basic usage (auto-wire)\n * ```typescript\n * import { init } from 'autotel'\n * import { renderTerminal } from 'autotel-terminal'\n *\n * init({ service: 'my-app' })\n * renderTerminal() // Automatically creates stream from current tracer provider\n * ```\n *\n * @example With options\n * ```typescript\n * renderTerminal({\n *   title: 'My App Traces',\n *   showStats: true,\n *   maxSpans: 200,\n * })\n * ```\n *\n * @example Manual stream (advanced)\n * ```typescript\n * import { StreamingSpanProcessor } from 'autotel-terminal'\n * import { createTerminalSpanStream } from 'autotel-terminal'\n * import { BatchSpanProcessor } from 'autotel/processors'\n *\n * const processor = new StreamingSpanProcessor(new BatchSpanProcessor(exporter))\n * const stream = createTerminalSpanStream(processor)\n * renderTerminal({}, stream)\n * ```\n *\n * @module autotel-terminal\n */\n\nimport React, { useEffect, useMemo, useState } from 'react';\nimport { render, Box, Text, useInput } from 'ink';\nimport type { TerminalSpanEvent, TerminalSpanStream } from './span-stream';\nimport { StreamingSpanProcessor } from './streaming-processor';\nimport { createTerminalSpanStream } from './span-stream';\nimport { getAutotelTracerProvider } from 'autotel/tracer-provider';\nimport type { TracerProvider } from '@opentelemetry/api';\n\n/**\n * Terminal dashboard options\n */\nexport interface TerminalOptions {\n  /**\n   * Dashboard title\n   * @default 'Autotel Trace Inspector'\n   */\n  title?: string;\n\n  /**\n   * Show statistics bar (span count, error rate, avg duration)\n   * @default true\n   */\n  showStats?: boolean;\n\n  /**\n   * Maximum number of spans to display\n   * @default 100\n   */\n  maxSpans?: number;\n\n  /**\n   * Enable colors (auto-detect by default)\n   * @default true if TTY\n   */\n  colors?: boolean;\n}\n\n// Helper for rendering duration\nfunction ms(n: number): string {\n  if (n < 1000) return `${n.toFixed(0)}ms`;\n  return `${(n / 1000).toFixed(2)}s`;\n}\n\n// Helper for truncating strings\nfunction truncate(s: string, width: number): string {\n  if (s.length <= width) return s;\n  return s.slice(0, Math.max(0, width - 1)) + '…';\n}\n\ninterface DashboardProps {\n  title: string;\n  showStats: boolean;\n  maxSpans: number;\n  colors: boolean;\n  stream: TerminalSpanStream;\n}\n\nfunction Dashboard({\n  title,\n  showStats,\n  maxSpans,\n  colors,\n  stream,\n}: DashboardProps): React.ReactElement {\n  const [paused, setPaused] = useState(false);\n  const [spans, setSpans] = useState<TerminalSpanEvent[]>([]);\n  const [selected, setSelected] = useState(0);\n  const [filterErrorsOnly, setFilterErrorsOnly] = useState(false);\n\n  useEffect(() => {\n    const unsubscribe = stream.onSpanEnd((span) => {\n      if (paused) return;\n      setSpans((prev) => {\n        const next = [span, ...prev];\n        return next.slice(0, maxSpans);\n      });\n      setSelected(0);\n    });\n    return unsubscribe;\n  }, [stream, paused, maxSpans]);\n\n  const filtered = useMemo(() => {\n    const list = filterErrorsOnly\n      ? spans.filter((s) => s.status === 'ERROR')\n      : spans;\n    return list;\n  }, [spans, filterErrorsOnly]);\n\n  const stats = useMemo(() => {\n    const total = spans.length;\n    const errors = spans.filter((s) => s.status === 'ERROR').length;\n    const avg = total\n      ? spans.reduce((a, s) => a + s.durationMs, 0) / total\n      : 0;\n    const p95 = total\n      ? (() => {\n          const sorted = spans.map((s) => s.durationMs).toSorted((a, b) => a - b);\n          return sorted[Math.floor(sorted.length * 0.95)] ?? 0;\n        })()\n      : 0;\n    return { total, errors, avg, p95 };\n  }, [spans]);\n\n  const current = filtered[selected];\n\n  useInput((input, key) => {\n    if (key.upArrow) setSelected((i) => Math.max(0, i - 1));\n    if (key.downArrow)\n      setSelected((i) => Math.min(filtered.length - 1, i + 1));\n\n    if (input === 'p') setPaused((p) => !p);\n    if (input === 'e') setFilterErrorsOnly((v) => !v);\n\n    if (input === 'c') {\n      setSpans([]);\n      setSelected(0);\n    }\n  });\n\n  const headerRight = paused ? '[Paused]' : '[Live]';\n\n  return (\n    <Box\n      flexDirection=\"column\"\n      borderStyle=\"round\"\n      padding={1}\n      borderColor={colors ? 'cyan' : undefined}\n    >\n      {/* Header */}\n      <Box justifyContent=\"space-between\" marginBottom={1}>\n        <Text bold>🔭 {title}</Text>\n        <Text color={paused ? 'yellow' : 'green'}>{headerRight}</Text>\n      </Box>\n\n      {/* Help / controls */}\n      <Box marginBottom={1} flexDirection=\"row\" justifyContent=\"space-between\">\n        <Text dimColor>\n          ↑/↓ select • p pause • e errors-only • c clear • Ctrl+C exit\n        </Text>\n        <Text dimColor>\n          showing {filtered.length}/{spans.length}\n        </Text>\n      </Box>\n\n      {/* Main content: list + details */}\n      <Box flexDirection=\"row\" gap={2}>\n        {/* List */}\n        <Box\n          flexDirection=\"column\"\n          width=\"55%\"\n          borderStyle=\"single\"\n          borderColor=\"gray\"\n          paddingX={1}\n          paddingY={0}\n        >\n          <Box marginTop={0} marginBottom={1}>\n            <Text bold>Recent spans</Text>\n            {filterErrorsOnly && <Text color=\"red\"> (errors only)</Text>}\n          </Box>\n\n          {filtered.length === 0 ? (\n            <Text dimColor>No spans yet. Generate some traffic…</Text>\n          ) : (\n            filtered.slice(0, 20).map((s, i) => {\n              const isSel = i === selected;\n              const statusColor =\n                s.status === 'ERROR'\n                  ? 'red'\n                  : s.durationMs > 500\n                    ? 'yellow'\n                    : 'green';\n\n              return (\n                <Box key={s.spanId} flexDirection=\"row\">\n                  <Text color={isSel ? 'cyan' : undefined}>\n                    {isSel ? '› ' : '  '}\n                  </Text>\n                  <Text color={colors ? statusColor : undefined}>\n                    {truncate(s.name, 26)}\n                  </Text>\n                  <Text dimColor> {ms(s.durationMs)}</Text>\n                  <Text dimColor> {truncate(s.traceId, 10)}</Text>\n                </Box>\n              );\n            })\n          )}\n        </Box>\n\n        {/* Details */}\n        <Box\n          flexDirection=\"column\"\n          width=\"45%\"\n          borderStyle=\"single\"\n          borderColor=\"gray\"\n          paddingX={1}\n          paddingY={0}\n        >\n          <Box marginBottom={1}>\n            <Text bold>Details</Text>\n          </Box>\n\n          {current ? (\n            <>\n              <Text>\n                <Text dimColor>Name: </Text>\n                <Text>{current.name}</Text>\n              </Text>\n              <Text>\n                <Text dimColor>Status: </Text>\n                <Text color={current.status === 'ERROR' ? 'red' : 'green'}>\n                  {current.status}\n                </Text>\n              </Text>\n              <Text>\n                <Text dimColor>Duration: </Text>\n                <Text>{ms(current.durationMs)}</Text>\n              </Text>\n              <Text dimColor>Trace: {current.traceId}</Text>\n              <Text dimColor>Span: {current.spanId}</Text>\n              {current.parentSpanId && (\n                <Text dimColor>Parent: {current.parentSpanId}</Text>\n              )}\n              {current.kind && <Text dimColor>Kind: {current.kind}</Text>}\n\n              <Box marginTop={1} flexDirection=\"column\">\n                <Text bold>Attributes</Text>\n                {current.attributes &&\n                Object.keys(current.attributes).length > 0 ? (\n                  Object.entries(current.attributes)\n                    .slice(0, 12)\n                    .map(([k, v]) => (\n                      <Text key={k} dimColor>\n                        {truncate(k, 22)}: {truncate(String(v), 34)}\n                      </Text>\n                    ))\n                ) : (\n                  <Text dimColor>(none)</Text>\n                )}\n              </Box>\n            </>\n          ) : (\n            <Text dimColor>Select a span to view details.</Text>\n          )}\n        </Box>\n      </Box>\n\n      {/* Stats bar */}\n      {showStats && (\n        <Box marginTop={1} borderStyle=\"single\" borderColor=\"gray\" paddingX={1}>\n          <Text dimColor>\n            Spans: {stats.total} | Errors: {stats.errors} | Avg: {ms(stats.avg)}{' '}\n            | P95: {ms(stats.p95)}\n          </Text>\n        </Box>\n      )}\n    </Box>\n  );\n}\n\n// Global streaming processor for auto-wiring\nlet globalStreamingProcessor: StreamingSpanProcessor | null = null;\n\n/**\n * Check if a TracerProvider has an addSpanProcessor method\n * (Node.js SDK providers have this, but API-level providers don't)\n */\nfunction canAddSpanProcessor(\n  provider: TracerProvider,\n): provider is TracerProvider & {\n  addSpanProcessor: (processor: unknown) => void;\n} {\n  return (\n    typeof provider === 'object' &&\n    provider !== null &&\n    'addSpanProcessor' in provider &&\n    typeof (provider as { addSpanProcessor?: unknown }).addSpanProcessor ===\n      'function'\n  );\n}\n\n/**\n * Render the terminal dashboard\n *\n * Automatically wires up a streaming processor from the current tracer provider\n * if no stream is provided. Otherwise uses the provided stream.\n *\n * @param options - Dashboard configuration options\n * @param stream - Optional manual stream (for advanced use cases)\n *\n * @example Auto-wire (recommended)\n * ```typescript\n * import { init } from 'autotel'\n * import { renderTerminal } from 'autotel-terminal'\n *\n * init({ service: 'my-app' })\n * renderTerminal() // Automatically creates stream from current tracer provider\n * ```\n *\n * @example Manual stream\n * ```typescript\n * import { StreamingSpanProcessor } from 'autotel-terminal'\n * import { createTerminalSpanStream } from 'autotel-terminal'\n *\n * const processor = new StreamingSpanProcessor(baseProcessor)\n * const stream = createTerminalSpanStream(processor)\n * renderTerminal({}, stream)\n * ```\n */\nexport function renderTerminal(\n  options: TerminalOptions = {},\n  stream?: TerminalSpanStream,\n): void {\n  const title = options.title ?? 'Autotel Trace Inspector';\n  const showStats = options.showStats !== false;\n  const maxSpans = options.maxSpans ?? 100;\n  const colors = options.colors ?? Boolean(process.stdout.isTTY);\n\n  // If stream provided, use it directly\n  if (stream) {\n    try {\n      render(\n        <Dashboard\n          title={title}\n          showStats={showStats}\n          maxSpans={maxSpans}\n          colors={colors}\n          stream={stream}\n        />,\n      );\n    } catch (error) {\n      console.error('[autotel-terminal] Failed to render dashboard:', error);\n    }\n    return;\n  }\n\n  // Otherwise, auto-wire from current tracer provider\n  let provider: TracerProvider;\n  try {\n    provider = getAutotelTracerProvider();\n  } catch (error) {\n    console.error(\n      '[autotel-terminal] Failed to get tracer provider. Call init() first or provide a stream.',\n      error,\n    );\n    return;\n  }\n\n  if (!provider) {\n    console.error(\n      '[autotel-terminal] No tracer provider found. Call init() first or provide a stream.',\n    );\n    return;\n  }\n\n  // Check if provider supports addSpanProcessor (Node.js SDK providers do)\n  if (!canAddSpanProcessor(provider)) {\n    console.error(\n      '[autotel-terminal] TracerProvider does not support addSpanProcessor. Provide a stream manually.',\n    );\n    return;\n  }\n\n  // Create streaming processor that doesn't wrap anything (just streams)\n  // This way it doesn't interfere with existing processors\n  globalStreamingProcessor = new StreamingSpanProcessor(null);\n  const terminalStream = createTerminalSpanStream(globalStreamingProcessor);\n\n  // Add streaming processor to provider\n  provider.addSpanProcessor(globalStreamingProcessor);\n\n  try {\n    render(\n      <Dashboard\n        title={title}\n        showStats={showStats}\n        maxSpans={maxSpans}\n        colors={colors}\n        stream={terminalStream}\n      />,\n    );\n  } catch (error) {\n    console.error('[autotel-terminal] Failed to render dashboard:', error);\n  }\n}\n\n// Re-export types and utilities\nexport type { TerminalSpanEvent, TerminalSpanStream } from './span-stream';\nexport { StreamingSpanProcessor } from './streaming-processor';\nexport { createTerminalSpanStream } from './span-stream';\n\n// Re-export OpenTelemetry types for advanced users\nexport type { ReadableSpan } from '@opentelemetry/sdk-trace-base';\nexport { SpanStatusCode, SpanKind } from 'autotel';\n\n// Re-export PrettyConsoleExporter for convenience\nexport {\n  PrettyConsoleExporter,\n  type PrettyConsoleExporterOptions,\n} from 'autotel/exporters';\n"]}