@mtharrison/loupe 1.2.0 → 1.4.0

package/dist/client/app.js

@@ -21048,7 +21048,7 @@ function resolveSessionTreeSelection(sessionNodes, selectedNodeId, selectedTrace
     selectedTraceId: nextSelectedTraceId
   };
 }
-function getDefaultExpandedSessionTreeNodeIds(sessionNodes, activeSessionId, selectedNodeId) {
+function getDefaultExpandedSessionTreeNodeIds(sessionNodes, activeSessionId, selectedNodeId, selectedTraceId = null) {
   const expanded = /* @__PURE__ */ new Set();
   const activeSession = (activeSessionId ? sessionNodes.find((node) => node.id === activeSessionId) ?? null : null) ?? sessionNodes[0] ?? null;
   if (!activeSession) {
@@ -21069,6 +21069,16 @@ function getDefaultExpandedSessionTreeNodeIds(sessionNodes, activeSessionId, sel
       }
     }
   }
+  if (selectedTraceId) {
+    for (const node of findSessionNodePath(
+      [activeSession],
+      `trace:${selectedTraceId}`
+    )) {
+      if (node.children.length) {
+        expanded.add(node.id);
+      }
+    }
+  }
   return expanded;
 }
 function deriveSessionNavItem(node, traceById) {
@@ -21395,34 +21405,36 @@ function App() {
   });
   const handleSseMessage = (0, import_react3.useEffectEvent)((data2) => {
     const payload = parseEvent(data2);
+    const nextTrace = payload?.span;
+    const nextTraceId = payload?.spanId;
     if (payload?.type === "ui:reload") {
       window.location.reload();
       return;
     }
-    if (payload?.trace && selectedTraceId && payload.traceId === selectedTraceId) {
-      (0, import_react3.startTransition)(() => setDetail(payload.trace));
+    if (nextTrace && selectedTraceId && nextTraceId === selectedTraceId) {
+      (0, import_react3.startTransition)(() => setDetail(nextTrace));
     }
     if (!queryString) {
-      if (payload?.type === "trace:update" && payload.trace) {
-        applyIncrementalTraceUpdate(payload.trace);
+      if ((payload?.type === "span:update" || payload?.type === "span:end") && nextTrace) {
+        applyIncrementalTraceUpdate(nextTrace);
         return;
       }
-      if (payload?.type === "trace:add" && payload.trace) {
-        applyIncrementalTraceAdd(payload.trace);
+      if (payload?.type === "span:start" && nextTrace) {
+        applyIncrementalTraceAdd(nextTrace);
         scheduleRefresh(180);
         return;
       }
-      if (payload?.type === "trace:evict") {
-        applyIncrementalTraceEvict(payload.traceId);
+      if (payload?.type === "span:evict") {
+        applyIncrementalTraceEvict(nextTraceId);
         scheduleRefresh(180);
         return;
       }
-      if (payload?.type === "trace:clear") {
+      if (payload?.type === "span:clear") {
         clearIncrementalState();
         return;
       }
     }
-    scheduleRefresh(payload?.type === "trace:update" ? 700 : 180);
+    scheduleRefresh(payload?.type === "span:update" || payload?.type === "span:end" ? 700 : 180);
   });
   (0, import_react3.useEffect)(() => {
     const events = new EventSource("/api/events");
@@ -21457,7 +21469,7 @@ function App() {
     () => deriveSessionNavItems(sessionNodes, traceById),
     [sessionNodes, traceById]
   );
-  const sessionNavById = (0, import_react3.useMemo)(
+  const sessionNavById2 = (0, import_react3.useMemo)(
     () => new Map(sessionNavItems.map((item) => [item.id, item])),
     [sessionNavItems]
   );
@@ -21476,8 +21488,10 @@ function App() {
     [sessionNodes, selectedTraceId]
   );
   const selectedPathIds = (0, import_react3.useMemo)(
-    () => new Set(selectedNodePath.map((node) => node.id)),
-    [selectedNodePath]
+    () => new Set(
+      [...selectedNodePath, ...selectedTracePath].map((node) => node.id)
+    ),
+    [selectedNodePath, selectedTracePath]
   );
   const selectedSessionNode = (0, import_react3.useMemo)(
     () => (selectedNodePath[0]?.type === "session" ? selectedNodePath[0] : null) ?? (selectedTracePath[0]?.type === "session" ? selectedTracePath[0] : null) ?? sessionNodes[0] ?? null,
@@ -21530,9 +21544,10 @@ function App() {
     () => getDefaultExpandedSessionTreeNodeIds(
       sessionNodes,
       selectedSessionNode?.id ?? null,
-      selectedNodeId
+      selectedNodeId,
+      selectedTraceId
     ),
-    [selectedNodeId, selectedSessionNode, sessionNodes]
+    [selectedNodeId, selectedSessionNode, selectedTraceId, sessionNodes]
   );
   const activeTabJsonMode = tabModes[detailTab] ?? "formatted";
   const activeTagFilterCount = countTagFilters(filters.tags);
@@ -21625,7 +21640,7 @@ function App() {
     if (!node) {
       return;
     }
-    const nextTraceId = selectedTraceId && node.traceIds.includes(selectedTraceId) ? selectedTraceId : getNewestTraceIdForNode(node);
+    const nextTraceId = node.type === "trace" ? node.meta.traceId ?? node.traceIds[0] ?? null : selectedTraceId && node.traceIds.includes(selectedTraceId) ? selectedTraceId : getNewestTraceIdForNode(node);
     (0, import_react3.startTransition)(() => {
       setSelectedNodeId(nodeId);
       if (nextTraceId !== selectedTraceId) {
@@ -21777,7 +21792,7 @@ function App() {
                 selectedNodeId,
                 selectedPathIds,
                 selectedTraceId,
-                sessionNavById,
+                sessionNavById: sessionNavById2,
                 totalCount: allSessionCount,
                 traceById
               }
@@ -21807,6 +21822,7 @@ function App() {
               {
                 activeTab,
                 detail,
+                detailPath: selectedTracePath.length ? selectedTracePath : selectedNodePath,
                 detailTabs,
                 fallbackTrace: selectedTraceSummary,
                 jsonMode: activeTabJsonMode,
@@ -21819,7 +21835,8 @@ function App() {
                     ...current,
                     [tabId]: (current[tabId] ?? "formatted") === "formatted" ? "raw" : "formatted"
                   }));
-                })
+                }),
+                traceById
               }
             ) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CardContent, { className: "content-scroll", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
               EmptyState,
@@ -21890,7 +21907,7 @@ function SessionTreeNavigator({
   selectedNodeId,
   selectedPathIds,
   selectedTraceId,
-  sessionNavById,
+  sessionNavById: sessionNavById2,
   totalCount,
   traceById
 }) {
@@ -21919,7 +21936,7 @@ function SessionTreeNavigator({
         selectedNodeId,
         selectedPathIds,
         selectedTraceId,
-        sessionNavById,
+        sessionNavById: sessionNavById2,
         traceById
       }
     ) })
@@ -21954,7 +21971,7 @@ function HierarchyTree({
   selectedNodeId,
   selectedPathIds,
   selectedTraceId,
-  sessionNavById,
+  sessionNavById: sessionNavById2,
   traceById
 }) {
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "tree-root", children: nodes.map((node) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
@@ -21970,7 +21987,7 @@ function HierarchyTree({
       selectedNodeId,
       selectedPathIds,
       selectedTraceId,
-      sessionNavById,
+      sessionNavById: sessionNavById2,
       traceById
     },
     node.id
@@ -21987,7 +22004,7 @@ function HierarchyTreeNode({
   selectedNodeId,
   selectedPathIds,
   selectedTraceId,
-  sessionNavById,
+  sessionNavById: sessionNavById2,
   traceById
 }) {
   const isExpandable = node.children.length > 0;
@@ -21997,20 +22014,28 @@ function HierarchyTreeNode({
   const isInPath = selectedPathIds.has(node.id);
   const nodeCopy = getHierarchyNodeCopy(node, traceById);
   const trace = node.meta.traceId ? traceById.get(node.meta.traceId) ?? null : null;
-  const sessionNavItem = node.type === "session" ? sessionNavById.get(node.id) ?? null : null;
+  const sessionNavItem = node.type === "session" ? sessionNavById2.get(node.id) ?? null : null;
   if (node.type === "trace" && trace) {
     return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-      TraceHierarchyLeaf,
+      TraceHierarchyNode,
       {
+        defaultExpandedNodeIds,
         depth,
+        expandedNodeOverrides,
         maxDurationMs,
         node,
         nodeCopy,
         onSelect,
+        onToggle,
         inPath: isInPath,
+        isExpanded,
         selected: selectedNodeId === node.id,
+        selectedNodeId,
+        selectedPathIds,
         selectedTrace: selectedTraceId === trace.id,
-        trace
+        selectedTraceId,
+        trace,
+        traceById
       }
     );
   }
@@ -22031,7 +22056,7 @@ function HierarchyTreeNode({
         selectedNodeId,
         selectedPathIds,
         selectedTraceId,
-        sessionNavById,
+        sessionNavById: sessionNavById2,
         traceById
       }
     );
@@ -22106,7 +22131,7 @@ function HierarchyTreeNode({
             selectedNodeId,
             selectedPathIds,
             selectedTraceId,
-            sessionNavById,
+            sessionNavById: sessionNavById2,
             traceById
           },
           child.id
@@ -22129,7 +22154,7 @@ function SessionHierarchyBranch({
   selectedNodeId,
   selectedPathIds,
   selectedTraceId,
-  sessionNavById,
+  sessionNavById: sessionNavById2,
   traceById
 }) {
   const detailLabel = formatList([
@@ -22247,7 +22272,7 @@ function SessionHierarchyBranch({
             selectedNodeId,
             selectedPathIds,
             selectedTraceId,
-            sessionNavById,
+            sessionNavById: sessionNavById2,
             traceById
           },
           child.id
@@ -22256,59 +22281,105 @@ function SessionHierarchyBranch({
     }
   );
 }
-function TraceHierarchyLeaf({
+function TraceHierarchyNode({
+  defaultExpandedNodeIds,
   depth,
+  expandedNodeOverrides,
   inPath,
+  isExpanded,
   maxDurationMs,
   node,
   nodeCopy,
   onSelect,
+  onToggle,
   selected,
+  selectedNodeId,
+  selectedPathIds,
   selectedTrace,
-  trace
+  selectedTraceId,
+  trace,
+  traceById
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+  const isExpandable = node.children.length > 0;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
     "div",
     {
       className: "tree-node-wrap tree-trace-wrap",
       style: { "--depth": String(depth) },
-      children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-        "div",
-        {
-          className: clsx_default(
-            "tree-node-card is-trace",
-            inPath && "is-in-path",
-            selected && "is-active",
-            selectedTrace && "is-detail-trace"
-          ),
-          children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-            "button",
-            {
-              type: "button",
-              className: "tree-node-select tree-trace-select",
-              onClick: () => onSelect(node),
-              children: [
-                /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { className: "tree-node-copy", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "trace-nav-kicker", children: getTraceActorLabel(trace) }),
-                  /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "tree-node-label", children: nodeCopy.label }),
-                  /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "tree-node-meta", children: formatList([
-                    formatTimelineTimestamp(trace.startedAt),
-                    nodeCopy.meta
-                  ]) })
-                ] }),
-                /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-                  TraceElapsedBar,
-                  {
-                    compact: true,
-                    durationMs: trace.durationMs,
-                    maxDurationMs
-                  }
-                )
-              ]
-            }
-          )
-        }
-      )
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+          "div",
+          {
+            className: clsx_default(
+              "tree-node-card is-trace",
+              inPath && "is-in-path",
+              selected && "is-active",
+              selectedTrace && "is-detail-trace"
+            ),
+            children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                "button",
+                {
+                  type: "button",
+                  className: clsx_default("tree-node-toggle", !isExpandable && "is-static"),
+                  disabled: !isExpandable,
+                  onClick: () => {
+                    if (isExpandable) {
+                      onToggle(node.id);
+                    }
+                  },
+                  "aria-label": isExpandable ? `${isExpanded ? "Collapse" : "Expand"} ${nodeCopy.label}` : void 0,
+                  children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ChevronRight, { className: clsx_default(isExpanded && "is-open") })
+                }
+              ),
+              /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+                "button",
+                {
+                  type: "button",
+                  className: "tree-node-select tree-trace-select",
+                  onClick: () => onSelect(node),
+                  children: [
+                    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { className: "tree-node-copy", children: [
+                      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "trace-nav-kicker", children: getTraceActorLabel(trace) }),
+                      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "tree-node-label", children: nodeCopy.label }),
+                      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "tree-node-meta", children: formatList([
+                        formatTimelineTimestamp(trace.startedAt),
+                        nodeCopy.meta
+                      ]) })
+                    ] }),
+                    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                      TraceElapsedBar,
+                      {
+                        compact: true,
+                        durationMs: trace.durationMs,
+                        maxDurationMs
+                      }
+                    )
+                  ]
+                }
+              )
+            ]
+          }
+        ),
+        isExpanded ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "tree-node-children", children: node.children.map((child) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          HierarchyTreeNode,
+          {
+            defaultExpandedNodeIds,
+            depth: depth + 1,
+            expandedNodeOverrides,
+            maxDurationMs,
+            node: child,
+            onSelect,
+            onToggle,
+            selectedNodeId,
+            selectedPathIds,
+            selectedTraceId,
+            sessionNavById,
+            traceById
+          },
+          child.id
+        )) }) : null
+      ]
     }
   );
 }
@@ -22523,6 +22594,7 @@ function HierarchyTimelineRows({
 function TraceDetailPanel({
   activeTab,
   detail,
+  detailPath,
   detailTabs,
   fallbackTrace,
   jsonMode,
@@ -22531,11 +22603,12 @@ function TraceDetailPanel({
   onBack,
   onNavigateHierarchyNode,
   onTabChange,
-  onToggleJsonMode
+  onToggleJsonMode,
+  traceById
 }) {
   const traceDetailPrimaryRef = (0, import_react3.useRef)(null);
   const [showInlineContextRail, setShowInlineContextRail] = (0, import_react3.useState)(false);
-  const detailCopy = detail ? getTraceDisplayCopy(detail) : fallbackTrace ? getTraceDisplayCopy(fallbackTrace) : null;
+  const detailCopy = detailPath.length ? getHierarchyPathDisplayCopy(detailPath, traceById) : detail ? getTraceDisplayCopy(detail) : fallbackTrace ? getTraceDisplayCopy(fallbackTrace) : null;
   const detailStatus = detail?.status ?? fallbackTrace?.status ?? null;
   const detailDuration = detail ? formatTraceDuration(detail) : fallbackTrace ? fallbackTrace.durationMs == null ? "Running" : `${fallbackTrace.durationMs} ms` : null;
   const detailSubtitle = formatTraceProviderSummary(detail ?? fallbackTrace);
@@ -22846,6 +22919,24 @@ function renderTabContent(tab, detail, jsonMode, onApplyTagFilter, onApplyTraceF
           }
         ) : null
       ] });
+    case "otel":
+      return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        JsonCard,
+        {
+          title: "OTel span",
+          value: {
+            name: detail.name,
+            spanContext: detail.spanContext,
+            parentSpanId: detail.parentSpanId,
+            spanKind: detail.spanKind,
+            spanStatus: detail.spanStatus,
+            startTime: detail.startedAt,
+            endTime: detail.endedAt,
+            attributes: detail.attributes,
+            events: detail.events
+          }
+        }
+      );
     default:
       return null;
   }
@@ -23764,6 +23855,7 @@ function buildDetailTabs(detail) {
   if (detail.stream) {
     tabs.push({ id: "stream", label: "Stream" });
   }
+  tabs.push({ id: "otel", label: "OTel" });
   return tabs;
 }
 function getHierarchyNodeCopy(node, traceById) {
@@ -23822,8 +23914,8 @@ function getHierarchyNodeCopy(node, traceById) {
           trace.provider,
           trace.model,
           formatCostSummaryLabel(
-            trace.costUsd ?? getHierarchyNodeCostUsd(node),
-            false
+            getHierarchyNodeCostUsd(node) ?? trace.costUsd,
+            node.count > 1
           )
         ]) : formatList([
           formatCountLabel(node.count, "call"),
@@ -23846,55 +23938,24 @@ function getHierarchyNodeCopy(node, traceById) {
   }
 }
 function getTraceDisplayCopy(trace) {
-  const actor = trace.hierarchy.childActorId || trace.hierarchy.rootActorId;
-  const breadcrumbs = getTraceBreadcrumbs(trace);
-  const pathParts = breadcrumbs.map((item) => item.label);
   return {
-    breadcrumbs,
-    path: pathParts.join(" / "),
-    subtitle: formatList([actor, trace.provider, trace.model]),
+    breadcrumbs: [],
+    path: "",
     title: getTraceTitle(trace)
   };
 }
-function getTraceBreadcrumbs(trace) {
-  const sessionId = trace.hierarchy.sessionId || "unknown-session";
-  const rootActorId = trace.hierarchy.rootActorId || "unknown-actor";
-  const breadcrumbs = [
-    {
-      label: `Session ${shortId2(sessionId)}`,
-      nodeId: `session:${sessionId}`
-    },
-    {
-      label: rootActorId,
-      nodeId: `actor:${sessionId}:${rootActorId}`
-    }
-  ];
-  if (trace.kind === "guardrail") {
-    const label = `${capitalize(trace.hierarchy.guardrailPhase || "guardrail")} guardrail`;
-    breadcrumbs.push({
-      label,
-      nodeId: `guardrail:${sessionId}:${rootActorId}:${trace.hierarchy.guardrailType || label.toLowerCase()}`
-    });
-  } else if (trace.kind === "child-actor" && trace.hierarchy.childActorId) {
-    breadcrumbs.push({
-      label: `Child actor: ${trace.hierarchy.childActorId}`,
-      nodeId: `child-actor:${sessionId}:${rootActorId}:${trace.hierarchy.childActorId}`
-    });
-  } else if (trace.kind === "stage") {
-    if (trace.hierarchy.childActorId) {
-      breadcrumbs.push({
-        label: `Child actor: ${trace.hierarchy.childActorId}`,
-        nodeId: `child-actor:${sessionId}:${rootActorId}:${trace.hierarchy.childActorId}`
-      });
-    }
-    if (trace.hierarchy.stage) {
-      breadcrumbs.push({
-        label: `Stage: ${trace.hierarchy.stage}`,
-        nodeId: `stage:${sessionId}:${rootActorId}:${trace.hierarchy.childActorId || "root"}:${trace.hierarchy.stage}`
-      });
-    }
-  }
-  return breadcrumbs;
+function getHierarchyPathDisplayCopy(path, traceById) {
+  const breadcrumbs = path.map((node) => ({
+    label: getHierarchyNodeCopy(node, traceById).label,
+    nodeId: node.id
+  }));
+  const lastNode = path[path.length - 1] ?? null;
+  const lastTrace = lastNode?.type === "trace" && lastNode.meta.traceId ? traceById.get(lastNode.meta.traceId) ?? null : null;
+  return {
+    breadcrumbs,
+    path: breadcrumbs.map((item) => item.label).join(" / "),
+    title: lastTrace ? getTraceTitle(lastTrace) : breadcrumbs.at(-1)?.label || "Trace"
+  };
 }
 function formatTraceProviderSummary(trace) {
   if (!trace) {
@@ -24045,12 +24106,12 @@ function patchHierarchyNode(node, traceId, previousSummary, nextSummary, costDel
   let nextLabel = node.label;
   if (containsTrace) {
     if (node.type === "trace" && node.meta.traceId === traceId) {
-      nextMeta.costUsd = nextSummary.costUsd;
       nextMeta.model = nextSummary.model;
       nextMeta.provider = nextSummary.provider;
       nextMeta.status = nextSummary.status;
       nextLabel = nextSummary.model ? `${nextSummary.model} ${nextSummary.mode}` : traceId;
-    } else if (costDelta !== 0 || previousSummary?.costUsd !== null || nextSummary.costUsd !== null) {
+    }
+    if (costDelta !== 0 || previousSummary?.costUsd !== null || nextSummary.costUsd !== null) {
       const currentCost = typeof nextMeta.costUsd === "number" && Number.isFinite(nextMeta.costUsd) ? nextMeta.costUsd : 0;
       nextMeta.costUsd = roundCostUsd2(currentCost + costDelta);
     }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { type ChatModelLike, type LocalLLMTracer, type OpenAIChatCompletionCreateParamsLike, type OpenAIClientLike, type TraceConfig, type TraceContext, type TraceRequest } from './types';
-export type { ChatModelLike, HierarchyNode, HierarchyResponse, LocalLLMTracer, NormalizedTraceContext, OpenAIChatCompletionCreateParamsLike, OpenAIChatCompletionStreamLike, OpenAIClientLike, TraceConfig, TraceContext, TraceEvent, TraceFilters, TraceHierarchy, TraceListResponse, TraceMode, TraceRecord, TraceRequest, TraceServer, TraceStatus, TraceSummary, TraceTags, UIReloadEvent, } from './types';
+import { type ChatModelLike, type LocalLLMTracer, type OpenAIChatCompletionCreateParamsLike, type OpenAIClientLike, type SpanEventInput, type SpanStartOptions, type TraceConfig, type TraceContext } from './types';
+export type { ChatModelLike, HierarchyNode, HierarchyResponse, LocalLLMTracer, NormalizedTraceContext, OpenAIChatCompletionCreateParamsLike, OpenAIChatCompletionStreamLike, OpenAIClientLike, SpanAttributes, SpanContext, SpanEvent, SpanEventInput, SpanKind, SpanStartOptions, SpanStatus, SpanStatusCode, TraceConfig, TraceContext, TraceEvent, TraceFilters, TraceHierarchy, TraceListResponse, TraceMode, TraceRecord, TraceRequest, TraceServer, TraceStatus, TraceSummary, TraceTags, UIReloadEvent, } from './types';
 export declare function isTraceEnabled(): boolean;
 export declare function getLocalLLMTracer(config?: TraceConfig): LocalLLMTracer;
 export declare function startTraceServer(config?: TraceConfig): Promise<{
@@ -7,12 +7,10 @@ export declare function startTraceServer(config?: TraceConfig): Promise<{
     port: number;
     url: string;
 }>;
-export declare function recordInvokeStart(context: TraceContext, request: TraceRequest, config?: TraceConfig): string;
-export declare function recordInvokeFinish(traceId: string, response: unknown, config?: TraceConfig): void;
-export declare function recordStreamStart(context: TraceContext, request: TraceRequest, config?: TraceConfig): string;
-export declare function recordStreamChunk(traceId: string, chunk: unknown, config?: TraceConfig): void;
-export declare function recordStreamFinish(traceId: string, chunk: unknown, config?: TraceConfig): void;
-export declare function recordError(traceId: string, error: unknown, config?: TraceConfig): void;
+export declare function startSpan(context: TraceContext, options?: SpanStartOptions, config?: TraceConfig): string;
+export declare function endSpan(spanId: string, response: unknown, config?: TraceConfig): void;
+export declare function addSpanEvent(spanId: string, event: SpanEventInput, config?: TraceConfig): void;
+export declare function recordException(spanId: string, error: unknown, config?: TraceConfig): void;
 export declare function __resetLocalLLMTracerForTests(): void;
 export declare function wrapChatModel<TModel extends ChatModelLike<TInput, TOptions, TValue, TChunk>, TInput = any, TOptions = any, TValue = any, TChunk = any>(model: TModel, getContext: () => TraceContext, config?: TraceConfig): TModel;
 export declare function wrapOpenAIClient<TClient extends OpenAIClientLike<TParams, TOptions, TResponse, TChunk>, TParams extends OpenAIChatCompletionCreateParamsLike = OpenAIChatCompletionCreateParamsLike, TOptions = Record<string, any>, TResponse = any, TChunk = any>(client: TClient, getContext: () => TraceContext, config?: TraceConfig): TClient;