@opensearch-project/agent-health 0.3.0 → 0.5.2

package/lib/dist/services/traces/flowTransform.js

@@ -0,0 +1,228 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Flow Transform Service
+ *
+ * Converts span trees to React Flow nodes and edges for DAG visualization.
+ * Uses dagre for automatic layout positioning.
+ *
+ * Supports two modes:
+ * - 'hierarchy': Traditional parent-child edges (legacy)
+ * - 'execution-order': Sibling execution-order edges like AWS Step Functions (default)
+ */
+import dagre from 'dagre';
+import { MarkerType } from '@xyflow/react';
+import { spansToExecutionFlow } from './executionOrderTransform.js';
+const DEFAULT_OPTIONS = {
+    direction: 'TB',
+    mode: 'execution-order',
+    nodeWidth: 200,
+    nodeHeight: 70,
+    nodeSpacingX: 50,
+    nodeSpacingY: 80,
+};
+/**
+ * Convert a categorized span tree to React Flow nodes and edges.
+ *
+ * @param spanTree - Categorized span tree to transform
+ * @param totalDuration - Total trace duration for relative sizing
+ * @param options - Transform options including mode
+ * @returns Flow nodes and edges for React Flow
+ */
+export function spansToFlow(spanTree, totalDuration, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    // Use execution-order mode by default (Step Functions style)
+    if (opts.mode === 'execution-order') {
+        return spansToExecutionFlow(spanTree, totalDuration, opts);
+    }
+    // Legacy hierarchy mode (parent-child edges)
+    return spansToHierarchyFlow(spanTree, totalDuration, opts);
+}
+/**
+ * Legacy hierarchy mode: parent-child edges
+ */
+function spansToHierarchyFlow(spanTree, totalDuration, opts) {
+    const nodes = [];
+    const edges = [];
+    // Build nodes and edges from span tree
+    const processSpan = (span, parentId) => {
+        // Create node
+        const node = {
+            id: span.spanId,
+            type: span.category.toLowerCase(),
+            data: {
+                span,
+                totalDuration,
+            },
+            position: { x: 0, y: 0 }, // Will be set by layout
+            style: {
+                width: opts.nodeWidth,
+                height: opts.nodeHeight,
+            },
+        };
+        nodes.push(node);
+        // Create edge from parent
+        if (parentId) {
+            const isParallel = false; // Will be determined later
+            edges.push(createEdge(parentId, span.spanId, isParallel));
+        }
+        // Process children
+        if (span.children && span.children.length > 0) {
+            const children = span.children;
+            // Detect parallel execution among siblings
+            const parallelGroups = detectParallelExecution(children);
+            const parallelSpanIds = new Set(parallelGroups.flatMap(g => g.spans.map(s => s.spanId)));
+            // Update edges for parallel spans
+            children.forEach(child => {
+                processSpan(child, span.spanId);
+                // Mark edge as parallel if span is in a parallel group
+                if (parallelSpanIds.has(child.spanId)) {
+                    const edge = edges.find(e => e.source === span.spanId && e.target === child.spanId);
+                    if (edge) {
+                        edge.animated = true;
+                        edge.style = {
+                            ...edge.style,
+                            stroke: '#f59e0b',
+                            strokeDasharray: '5,5',
+                        };
+                    }
+                }
+            });
+        }
+    };
+    // Process all root spans
+    spanTree.forEach(span => processSpan(span));
+    // Apply layout
+    const layoutedResult = applyDagreLayout(nodes, edges, opts);
+    return layoutedResult;
+}
+/**
+ * Create an edge between two nodes
+ */
+function createEdge(sourceId, targetId, isParallel) {
+    return {
+        id: `${sourceId}-${targetId}`,
+        source: sourceId,
+        target: targetId,
+        type: 'smoothstep',
+        animated: isParallel,
+        style: {
+            stroke: isParallel ? '#f59e0b' : '#64748b',
+            strokeWidth: 2,
+            strokeDasharray: isParallel ? '5,5' : undefined,
+        },
+        markerEnd: {
+            type: MarkerType.ArrowClosed,
+            width: 12,
+            height: 12,
+            color: isParallel ? '#f59e0b' : '#64748b',
+        },
+    };
+}
+/**
+ * Detect parallel execution among sibling spans by checking time overlap
+ */
+export function detectParallelExecution(spans) {
+    if (spans.length < 2)
+        return [];
+    // Sort by start time
+    const sorted = [...spans].sort((a, b) => new Date(a.startTime).getTime() - new Date(b.startTime).getTime());
+    const groups = [];
+    let currentGroup = [sorted[0]];
+    let groupEndTime = new Date(sorted[0].endTime).getTime();
+    for (let i = 1; i < sorted.length; i++) {
+        const span = sorted[i];
+        const spanStart = new Date(span.startTime).getTime();
+        const spanEnd = new Date(span.endTime).getTime();
+        // Check if this span overlaps with the current group
+        // Using a threshold of 10% of the span's duration to account for minor timing differences
+        const overlapThreshold = Math.min((groupEndTime - new Date(currentGroup[0].startTime).getTime()) * 0.1, 100 // Max 100ms threshold
+        );
+        if (spanStart < groupEndTime + overlapThreshold) {
+            // Overlaps - add to current group
+            currentGroup.push(span);
+            groupEndTime = Math.max(groupEndTime, spanEnd);
+        }
+        else {
+            // No overlap - save current group if it has multiple spans
+            if (currentGroup.length > 1) {
+                groups.push({
+                    spans: currentGroup,
+                    startTime: new Date(currentGroup[0].startTime).getTime(),
+                    endTime: groupEndTime,
+                });
+            }
+            // Start new group
+            currentGroup = [span];
+            groupEndTime = spanEnd;
+        }
+    }
+    // Don't forget the last group
+    if (currentGroup.length > 1) {
+        groups.push({
+            spans: currentGroup,
+            startTime: new Date(currentGroup[0].startTime).getTime(),
+            endTime: groupEndTime,
+        });
+    }
+    return groups;
+}
+/**
+ * Apply dagre layout algorithm to position nodes
+ */
+export function applyDagreLayout(nodes, edges, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const dagreGraph = new dagre.graphlib.Graph();
+    dagreGraph.setDefaultEdgeLabel(() => ({}));
+    dagreGraph.setGraph({
+        rankdir: opts.direction,
+        nodesep: opts.nodeSpacingX,
+        ranksep: opts.nodeSpacingY,
+        marginx: 20,
+        marginy: 20,
+    });
+    // Add nodes to dagre
+    nodes.forEach(node => {
+        dagreGraph.setNode(node.id, {
+            width: opts.nodeWidth,
+            height: opts.nodeHeight,
+        });
+    });
+    // Add edges to dagre
+    edges.forEach(edge => {
+        dagreGraph.setEdge(edge.source, edge.target);
+    });
+    // Run layout algorithm
+    dagre.layout(dagreGraph);
+    // Apply calculated positions to nodes
+    const layoutedNodes = nodes.map(node => {
+        const nodeWithPosition = dagreGraph.node(node.id);
+        return {
+            ...node,
+            position: {
+                x: nodeWithPosition.x - opts.nodeWidth / 2,
+                y: nodeWithPosition.y - opts.nodeHeight / 2,
+            },
+        };
+    });
+    return { nodes: layoutedNodes, edges };
+}
+/**
+ * Get total span count from a tree (for stats display)
+ */
+export function countSpansInTree(spans) {
+    let count = 0;
+    const countRecursive = (nodes) => {
+        for (const node of nodes) {
+            count++;
+            if (node.children) {
+                countRecursive(node.children);
+            }
+        }
+    };
+    countRecursive(spans);
+    return count;
+}
+//# sourceMappingURL=flowTransform.js.map

package/lib/dist/services/traces/flowTransform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowTransform.js","sourceRoot":"","sources":["../../../../services/traces/flowTransform.ts"],"names":[],"mappings":"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"}

package/lib/dist/services/traces/index.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Traces Service - Fetch and process trace data from OpenSearch
+ */
+import { Span, TimeRange, TraceQueryParams, TraceSearchResult } from '../../types/index.js';
+export { groupSpansByTrace, getSpansForTrace } from './traceGrouping.js';
+export { extractMessagesFromSpans } from './messageExtraction.js';
+/**
+ * Fetch traces from the backend API
+ * Backend handles config resolution (file or env vars) - no headers needed from frontend
+ */
+export declare function fetchTraces(params: TraceQueryParams): Promise<TraceSearchResult>;
+/**
+ * Fetch traces by trace ID
+ */
+export declare function fetchTraceById(traceId: string): Promise<TraceSearchResult>;
+/**
+ * Fetch traces by run IDs
+ */
+export declare function fetchTracesByRunIds(runIds: string[]): Promise<TraceSearchResult>;
+/**
+ * Fetch traces correlated with a single test-case run, using all available
+ * correlation strategies (see AGENTS.md → Trace correlation conventions):
+ *
+ *   A. traceId  — W3C-propagated agents share traceId with the eval span
+ *   B. runId    — agents tag spans with `agent_health.run.id == runId` (or the
+ *                 OTEL-standard `gen_ai.conversation.id`); the server query
+ *                 unions both. NOT `gen_ai.request.id` — that is not a
+ *                 registered Gen AI semconv attribute. See AGENTS.md → Strategy B.
+ *   C. agents   — service.name + time-window fallback (opt-in / `includeWindowFallback`)
+ *
+ * Strategies A and B are always safe (no false positives). Strategy C is
+ * opt-in because it can surface concurrent runs of the same agent and
+ * cross-team noise on a shared cluster.
+ */
+export declare function fetchTracesForRun(params: {
+    /**
+     * Agent run id (Strategy B correlation). Optional — runs persisted via the
+     * deferred trace-mode path may not carry one; in that case correlation
+     * falls back to the time-window `windowAgents` clause (Strategy C).
+     */
+    runId?: string;
+    evalTraceId?: string;
+    /**
+     * Strategy A (direct): the report's own `traceId`. Agents that emit their
+     * own OTel trace (e.g. pi) carry it on every span but NOT our connector
+     * `runId`, so a direct `traceId` lookup returns the run's spans immediately
+     * — independent of the deep-dive's window hints.
+     */
+    traceId?: string;
+    /**
+     * Strategy D (direct): the report's `session.id`. Claude Code stamps it on
+     * every span; a direct `sessionId` lookup correlates without needing a
+     * window. (Server matches both the analyzed field and its `.keyword`.)
+     */
+    sessionId?: string;
+    includeWindowFallback?: boolean;
+    windowAgents?: Array<{
+        serviceName: string;
+        startedAt: number;
+        endedAt: number;
+        sessionId?: string;
+    }>;
+    size?: number;
+}): Promise<TraceSearchResult>;
+/**
+ * Fetch recent traces for live tailing
+ */
+export declare function fetchRecentTraces(options: {
+    minutesAgo?: number;
+    sessionId?: string;
+    serviceName?: string;
+    textSearch?: string;
+    size?: number;
+    cursor?: string;
+}): Promise<TraceSearchResult>;
+/**
+ * Fetch all traces for a Claude Code session by session ID
+ */
+export declare function fetchTracesBySessionId(sessionId: string): Promise<TraceSearchResult>;
+/**
+ * Check traces API health
+ * Backend handles config resolution (file or env vars) - no headers needed from frontend
+ */
+export declare function checkTracesHealth(): Promise<{
+    status: string;
+    index?: string;
+    error?: string;
+}>;
+/**
+ * Process flat spans into a hierarchical tree structure
+ */
+export declare function processSpansIntoTree(flatSpans: Span[]): Span[];
+/**
+ * Calculate global time range across all spans
+ */
+export declare function calculateTimeRange(spans: Span[]): TimeRange;
+/**
+ * Get color for a span based on its type/name
+ */
+export declare function getSpanColor(span: Span): string;
+/**
+ * Compute the initial expanded-spans set for a trace: every root, plus
+ * every ancestor of any ERROR-status span so the failing span is visible
+ * on load instead of hidden behind collapsed parents (TraceTree and
+ * Timeline both key off this set).
+ */
+export declare function getInitialExpandedSpans(spanTree: Span[]): Set<string>;
+/**
+ * Flatten tree into visible spans based on expanded state
+ */
+export declare function flattenVisibleSpans(spans: Span[], expandedSpans: Set<string>, depth?: number): Span[];
+export { categorizeSpan, categorizeSpans, categorizeSpanTree, getSpanCategory, getCategoryMeta, filterSpansByCategory, filterSpanTreeByCategory, countByCategory, buildDisplayName, checkOTelCompliance, hasAnyWarnings, } from './spanCategorization.js';
+export { extractCommonArgKeys, groupToolSpans, calculateToolSimilarity, getToolGroupStats, } from './toolSimilarity.js';
+export { calculateSpanSimilarity, compareTraces, flattenAlignedTree, getComparisonTypeInfo, } from './traceComparison.js';
+export { spansToFlow, applyDagreLayout, detectParallelExecution, countSpansInTree, } from './flowTransform.js';
+export { spansToExecutionFlow, isContainerSpan, findMainFlowSpans, sortByStartTime, } from './executionOrderTransform.js';
+export { spansToIntentNodes, getRootContainerSpan, } from './intentTransform.js';
+export { CATEGORY_COLORS, getCategoryColors, type CategoryColorConfig, } from './categoryStyles.js';
+export { flattenSpans, calculateCategoryStats, extractToolName, extractToolStats, type CategoryStats, type ToolInfo, } from './traceStats.js';
+export { computeTraceSummary, isEmptyTraceSummary, type TraceSummary, } from './traceSummary.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/dist/services/traces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../services/traces/index.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAK/E,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAiB/D;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAetF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEtF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtG,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkB7B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmB7B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE1F;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAGrG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAkC9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,SAAS,CAoB3D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAa/C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAerE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,EAAE,EACb,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAC1B,KAAK,SAAI,GACR,IAAI,EAAE,CAaR;AAGD,OAAO,EACL,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,QAAQ,GACd,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC"}

package/lib/dist/services/traces/index.js

@@ -0,0 +1,255 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getSpanCategory } from './spanCategorization.js';
+import { getBackendUrl } from '../../lib/portConfig.js';
+// Re-export trace grouping utilities
+export { groupSpansByTrace, getSpansForTrace } from './traceGrouping.js';
+// Re-export message extraction
+export { extractMessagesFromSpans } from './messageExtraction.js';
+/**
+ * Get API base URL dynamically
+ * Server-side (Node.js): Use localhost with AH_PORT env var (legacy: AGENT_HEALTH_PORT)
+ * Client-side (browser): Use relative URLs
+ */
+function getApiBaseUrl() {
+    const isServerSide = typeof window === 'undefined';
+    if (isServerSide) {
+        // Server-side self-call — use the canonical backend URL (AH_PORT is kept
+        // in lockstep with the actual bound port; see server lifecycle).
+        return getBackendUrl();
+    }
+    return ''; // Relative URLs in browser
+}
+/**
+ * Fetch traces from the backend API
+ * Backend handles config resolution (file or env vars) - no headers needed from frontend
+ */
+export async function fetchTraces(params) {
+    const response = await fetch(`${getApiBaseUrl()}/api/traces`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(params)
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+        throw new Error(error.error || `HTTP ${response.status}`);
+    }
+    return response.json();
+}
+/**
+ * Fetch traces by trace ID
+ */
+export async function fetchTraceById(traceId) {
+    return fetchTraces({ traceId });
+}
+/**
+ * Fetch traces by run IDs
+ */
+export async function fetchTracesByRunIds(runIds) {
+    return fetchTraces({ runIds });
+}
+/**
+ * Fetch traces correlated with a single test-case run, using all available
+ * correlation strategies (see AGENTS.md → Trace correlation conventions):
+ *
+ *   A. traceId  — W3C-propagated agents share traceId with the eval span
+ *   B. runId    — agents tag spans with `agent_health.run.id == runId` (or the
+ *                 OTEL-standard `gen_ai.conversation.id`); the server query
+ *                 unions both. NOT `gen_ai.request.id` — that is not a
+ *                 registered Gen AI semconv attribute. See AGENTS.md → Strategy B.
+ *   C. agents   — service.name + time-window fallback (opt-in / `includeWindowFallback`)
+ *
+ * Strategies A and B are always safe (no false positives). Strategy C is
+ * opt-in because it can surface concurrent runs of the same agent and
+ * cross-team noise on a shared cluster.
+ */
+export async function fetchTracesForRun(params) {
+    const { runId, evalTraceId, traceId, sessionId, includeWindowFallback, windowAgents, size = 1000 } = params;
+    // Only include the runIds clause when runId is a non-empty string. A
+    // `[undefined]` array makes the server build a `terms: [null]` query that
+    // OpenSearch rejects wholesale (taking the Strategy C window fallback down
+    // with it). Runs persisted via the deferred trace-mode path may not carry
+    // a runId, so this guard is load-bearing for the Traces tab. See #264.
+    const query = { size };
+    if (typeof runId === 'string' && runId.length > 0) {
+        query.runIds = [runId];
+    }
+    // traceId: explicit param wins, else the eval-span traceId (both → query.traceId).
+    if (traceId || evalTraceId)
+        query.traceId = traceId || evalTraceId;
+    if (typeof sessionId === 'string' && sessionId.length > 0)
+        query.sessionId = sessionId;
+    if (includeWindowFallback && windowAgents && windowAgents.length > 0) {
+        query.agents = windowAgents;
+    }
+    return fetchTraces(query);
+}
+/**
+ * Fetch recent traces for live tailing
+ */
+export async function fetchRecentTraces(options) {
+    const { minutesAgo = 5, sessionId, serviceName, textSearch, size = 100, cursor } = options;
+    // Session queries don't need a time range — fetch all spans for the session
+    if (sessionId) {
+        return fetchTraces({ sessionId, serviceName, textSearch, size, cursor });
+    }
+    const now = Date.now();
+    const startTime = now - (minutesAgo * 60 * 1000);
+    return fetchTraces({
+        startTime,
+        endTime: now,
+        serviceName,
+        textSearch,
+        size,
+        cursor,
+    });
+}
+/**
+ * Fetch all traces for a Claude Code session by session ID
+ */
+export async function fetchTracesBySessionId(sessionId) {
+    return fetchTraces({ sessionId, size: 1000 });
+}
+/**
+ * Check traces API health
+ * Backend handles config resolution (file or env vars) - no headers needed from frontend
+ */
+export async function checkTracesHealth() {
+    const response = await fetch(`${getApiBaseUrl()}/api/traces/health`);
+    return response.json();
+}
+/**
+ * Process flat spans into a hierarchical tree structure
+ */
+export function processSpansIntoTree(flatSpans) {
+    if (!flatSpans || flatSpans.length === 0)
+        return [];
+    const spanMap = new Map();
+    const roots = [];
+    // First pass: index all spans
+    flatSpans.forEach(span => {
+        spanMap.set(span.spanId, { ...span, children: [] });
+    });
+    // Second pass: build tree structure
+    spanMap.forEach(span => {
+        if (span.parentSpanId && spanMap.has(span.parentSpanId)) {
+            const parent = spanMap.get(span.parentSpanId);
+            parent.children = parent.children || [];
+            parent.children.push(span);
+        }
+        else {
+            roots.push(span);
+        }
+    });
+    // Sort children by startTime
+    const sortChildren = (spans) => {
+        spans.sort((a, b) => new Date(a.startTime).getTime() - new Date(b.startTime).getTime());
+        spans.forEach(span => {
+            if (span.children && span.children.length > 0) {
+                sortChildren(span.children);
+            }
+        });
+    };
+    sortChildren(roots);
+    return roots;
+}
+/**
+ * Calculate global time range across all spans
+ */
+export function calculateTimeRange(spans) {
+    if (!spans || spans.length === 0) {
+        return { startTime: 0, endTime: 0, duration: 0 };
+    }
+    let startTime = Infinity;
+    let endTime = -Infinity;
+    spans.forEach(span => {
+        const spanStart = new Date(span.startTime).getTime();
+        const spanEnd = new Date(span.endTime).getTime();
+        if (spanStart < startTime)
+            startTime = spanStart;
+        if (spanEnd > endTime)
+            endTime = spanEnd;
+    });
+    return {
+        startTime,
+        endTime,
+        duration: endTime - startTime
+    };
+}
+/**
+ * Get color for a span based on its type/name
+ */
+export function getSpanColor(span) {
+    const category = getSpanCategory(span);
+    const CATEGORY_HEX = {
+        AGENT: '#6366f1', // indigo
+        LLM: '#a855f7', // purple
+        TOOL: '#f59e0b', // amber
+        EVAL: '#10b981', // emerald
+        ERROR: '#ef4444', // red
+        OTHER: '#64748b', // slate
+    };
+    return CATEGORY_HEX[category] || CATEGORY_HEX.OTHER;
+}
+/**
+ * Compute the initial expanded-spans set for a trace: every root, plus
+ * every ancestor of any ERROR-status span so the failing span is visible
+ * on load instead of hidden behind collapsed parents (TraceTree and
+ * Timeline both key off this set).
+ */
+export function getInitialExpandedSpans(spanTree) {
+    const expanded = new Set();
+    const walk = (spans, ancestors) => {
+        for (const span of spans) {
+            if (!span.parentSpanId)
+                expanded.add(span.spanId);
+            if (span.status === 'ERROR') {
+                for (const id of ancestors)
+                    expanded.add(id);
+            }
+            if (span.children?.length) {
+                walk(span.children, [...ancestors, span.spanId]);
+            }
+        }
+    };
+    walk(spanTree, []);
+    return expanded;
+}
+/**
+ * Flatten tree into visible spans based on expanded state
+ */
+export function flattenVisibleSpans(spans, expandedSpans, depth = 0) {
+    const result = [];
+    for (const span of spans) {
+        const hasChildren = (span.children?.length || 0) > 0;
+        result.push({ ...span, depth, hasChildren });
+        if (hasChildren && expandedSpans.has(span.spanId)) {
+            result.push(...flattenVisibleSpans(span.children, expandedSpans, depth + 1));
+        }
+    }
+    return result;
+}
+// Re-export categorization functions
+export { categorizeSpan, categorizeSpans, categorizeSpanTree, getSpanCategory, getCategoryMeta, filterSpansByCategory, filterSpanTreeByCategory, countByCategory, buildDisplayName, checkOTelCompliance, hasAnyWarnings, } from './spanCategorization.js';
+// Re-export tool similarity functions
+export { extractCommonArgKeys, groupToolSpans, calculateToolSimilarity, getToolGroupStats, } from './toolSimilarity.js';
+// Re-export trace comparison functions
+export { calculateSpanSimilarity, compareTraces, flattenAlignedTree, getComparisonTypeInfo, } from './traceComparison.js';
+// Re-export flow transform functions
+export { spansToFlow, applyDagreLayout, detectParallelExecution, countSpansInTree, } from './flowTransform.js';
+// Re-export execution order transform functions
+export { spansToExecutionFlow, isContainerSpan, findMainFlowSpans, sortByStartTime, } from './executionOrderTransform.js';
+// Re-export intent transform functions
+export { spansToIntentNodes, getRootContainerSpan, } from './intentTransform.js';
+// Re-export category styles
+export { CATEGORY_COLORS, getCategoryColors, } from './categoryStyles.js';
+// Re-export trace stats utilities
+export { flattenSpans, calculateCategoryStats, extractToolName, extractToolStats, } from './traceStats.js';
+// Trace-level summary (category counts + tokens + models) reused by both
+// the inline expansion header and the fullscreen header.
+export { computeTraceSummary, isEmptyTraceSummary, } from './traceSummary.js';
+//# sourceMappingURL=index.js.map

package/lib/dist/services/traces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../services/traces/index.ts"],"names":[],"mappings":"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"}

package/lib/dist/services/traces/intentTransform.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Intent Transform Service
+ *
+ * Transforms span trees into time-series compressed nodes for Intent view.
+ * Groups only CONSECUTIVE same-category spans, preserving execution order.
+ *
+ * Example: LLM, TOOL, LLM, TOOL, TOOL, LLM
+ * Result:  [LLM], [TOOL], [LLM], [TOOL ×2], [LLM]
+ */
+import { CategorizedSpan, IntentNode } from '../../types/index.js';
+/**
+ * Transform a categorized span tree into IntentNodes for the Intent view.
+ * Groups only consecutive same-category spans, preserving execution order.
+ */
+export declare function spansToIntentNodes(spanTree: CategorizedSpan[]): IntentNode[];
+/**
+ * Get the root/container span for display as header (if exists)
+ */
+export declare function getRootContainerSpan(spanTree: CategorizedSpan[]): CategorizedSpan | null;
+//# sourceMappingURL=intentTransform.d.ts.map

package/lib/dist/services/traces/intentTransform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intentTransform.d.ts","sourceRoot":"","sources":["../../../../services/traces/intentTransform.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAC;AA0HpE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,UAAU,EAAE,CAM5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,eAAe,GAAG,IAAI,CAYxF"}