Skip to content

Commit 8482b7c

Browse files
author
liuzeming
committed
feat(tui): add CallTraceBar component for real-time trace visualization
Add a new CallTraceBar component to the TUI session view that displays real-time call traces from OC, OMO, and LLM sources. The component shows trace details including duration, timing, and expandable input/output summaries. Key changes: - Add CallTraceProvider context for managing trace state - Add CallTraceBar component with expandable trace details - Add calltrace_toggle keybind (<leader>v) to show/hide the bar - Add trace start/end event handling in the session processor - Add model snapshot support for trace metadata - Update SDK types to include call-trace events Closes anomalyco#20168
1 parent a898c2e commit 8482b7c

11 files changed

Lines changed: 1095 additions & 21 deletions

File tree

‎packages/opencode/src/cli/cmd/tui/app.tsx‎

Lines changed: 24 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ import { SDKProvider, useSDK } from "@tui/context/sdk"
2727
import { StartupLoading } from "@tui/component/startup-loading"
2828
import { SyncProvider, useSync } from "@tui/context/sync"
2929
import { LocalProvider, useLocal } from "@tui/context/local"
30+
import { CallTraceProvider } from "@tui/context/call-trace"
3031
import { DialogModel, useConnected } from "@tui/component/dialog-model"
3132
import { DialogMcp } from "@tui/component/dialog-mcp"
3233
import { DialogStatus } from "@tui/component/dialog-status"
@@ -211,27 +212,29 @@ export function tui(input: {
211212
headers={input.headers}
212213
events={input.events}
213214
>
214-
<SyncProvider>
215-
<ThemeProvider mode={mode}>
216-
<LocalProvider>
217-
<KeybindProvider>
218-
<PromptStashProvider>
219-
<DialogProvider>
220-
<CommandProvider>
221-
<FrecencyProvider>
222-
<PromptHistoryProvider>
223-
<PromptRefProvider>
224-
<App onSnapshot={input.onSnapshot} />
225-
</PromptRefProvider>
226-
</PromptHistoryProvider>
227-
</FrecencyProvider>
228-
</CommandProvider>
229-
</DialogProvider>
230-
</PromptStashProvider>
231-
</KeybindProvider>
232-
</LocalProvider>
233-
</ThemeProvider>
234-
</SyncProvider>
215+
<CallTraceProvider>
216+
<SyncProvider>
217+
<ThemeProvider mode={mode}>
218+
<LocalProvider>
219+
<KeybindProvider>
220+
<PromptStashProvider>
221+
<DialogProvider>
222+
<CommandProvider>
223+
<FrecencyProvider>
224+
<PromptHistoryProvider>
225+
<PromptRefProvider>
226+
<App onSnapshot={input.onSnapshot} />
227+
</PromptRefProvider>
228+
</PromptHistoryProvider>
229+
</FrecencyProvider>
230+
</CommandProvider>
231+
</DialogProvider>
232+
</PromptStashProvider>
233+
</KeybindProvider>
234+
</LocalProvider>
235+
</ThemeProvider>
236+
</SyncProvider>
237+
</CallTraceProvider>
235238
</SDKProvider>
236239
</TuiConfigProvider>
237240
</RouteProvider>
Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
import type { CallTraceItem, TraceSource } from "../context/call-trace"
2+
3+
export function formatDuration(ms: number): string {
4+
return ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(1)}s`
5+
}
6+
7+
export function formatTime(ts: number): string {
8+
return new Date(ts).toTimeString().slice(0, 8)
9+
}
10+
11+
export function truncate(s: string | undefined, max: number): string {
12+
if (!s) return ""
13+
return s.length <= max ? s : s.slice(0, max - 1) + "…"
14+
}
15+
16+
export function formatTokens(tokens?: { input: number; output: number }): string {
17+
return tokens ? `${tokens.input}→${tokens.output}` : ""
18+
}
19+
20+
export function formatCost(cost?: number): string {
21+
return cost !== undefined ? `$${cost.toFixed(4)}` : ""
22+
}
23+
24+
export function formatInput(trace: CallTraceItem): string {
25+
if (trace.inputSummary) return trace.inputSummary
26+
if (trace.type === "llm") {
27+
const parts = []
28+
if (trace.providerID) parts.push(trace.providerID)
29+
if (trace.modelID) parts.push(trace.modelID)
30+
if (trace.tokens) parts.push(`tokens: ${trace.tokens.input}`)
31+
return parts.join(" | ") || "LLM call"
32+
}
33+
if (trace.type === "tool") {
34+
const params = trace.input ? Object.keys(trace.input).join(", ") : ""
35+
return trace.toolName ? `${trace.toolName}(${params})` : "Tool call"
36+
}
37+
if (trace.type === "omo") {
38+
return trace.agentName || trace.description || "OMO agent"
39+
}
40+
return ""
41+
}
42+
43+
export function formatOutput(trace: CallTraceItem): string {
44+
if (trace.outputSummary) return trace.outputSummary
45+
if (trace.type === "llm") {
46+
const parts = []
47+
if (trace.tokens) parts.push(`tokens: ${trace.tokens.output}`)
48+
if (trace.cost !== undefined) parts.push(formatCost(trace.cost))
49+
return parts.join(" | ") || ""
50+
}
51+
if (trace.type === "tool") {
52+
return trace.output ? truncate(trace.output, 100) : ""
53+
}
54+
if (trace.type === "omo") {
55+
return trace.sessionID ? `session: ${trace.sessionID}` : ""
56+
}
57+
return ""
58+
}
59+
60+
export const SOURCE_COLORS: Record<TraceSource, string> = {
61+
OC: "info",
62+
OMO: "warning",
63+
LLM: "success",
64+
}
Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
import { createStore } from "solid-js/store"
2+
import { createSimpleContext } from "./helper"
3+
import { useSDK } from "./sdk"
4+
import { Log } from "@/util/log"
5+
6+
export type TraceSource = "OC" | "OMO" | "LLM"
7+
export type TraceStatus = "running" | "completed" | "error"
8+
9+
export interface CallTraceItem {
10+
id: string
11+
type: string
12+
source: TraceSource
13+
name: string
14+
component: string
15+
startTime: number
16+
endTime?: number
17+
duration?: number
18+
status: TraceStatus
19+
metadata?: Record<string, unknown>
20+
inputSummary?: string
21+
outputSummary?: string
22+
providerID?: string
23+
modelID?: string
24+
tokens?: { input: number; output: number }
25+
cost?: number
26+
toolName?: string
27+
input?: Record<string, unknown>
28+
output?: string
29+
agentName?: string
30+
description?: string
31+
sessionID?: string
32+
}
33+
34+
type CallTraceState = {
35+
[messageID: string]: CallTraceItem[]
36+
}
37+
38+
export const { use: useCallTrace, provider: CallTraceProvider } = createSimpleContext({
39+
name: "CallTrace",
40+
init: () => {
41+
const log = Log.create({ service: "call-trace-tui" })
42+
const sdk = useSDK()
43+
const [traces, setTraces] = createStore<CallTraceState>({})
44+
45+
log.info("CallTraceProvider initialized")
46+
47+
sdk.event.listen((e: any) => {
48+
const event = e?.details
49+
const eventType = event?.type
50+
const eventProperties = event?.properties
51+
52+
if (eventType === "call-trace.start" && eventProperties) {
53+
log.info("call-trace.start received", { messageID: eventProperties.messageID })
54+
const { messageID, trace } = eventProperties
55+
setTraces(messageID, (prev) => {
56+
const items = prev ?? []
57+
const idx = items.findIndex((t) => t.id === trace.id)
58+
if (idx >= 0) {
59+
return [...items.slice(0, idx), trace, ...items.slice(idx + 1)]
60+
}
61+
return [...items, trace]
62+
})
63+
} else if (eventType === "call-trace.end" && eventProperties) {
64+
log.info("call-trace.end received", { messageID: eventProperties.messageID })
65+
const { messageID, traceID, endTime, duration, status, tokens, cost, output, outputSummary, metadata } =
66+
eventProperties
67+
setTraces(messageID, (prev) => {
68+
if (!prev) return prev
69+
return prev.map((t) => {
70+
if (t.id !== traceID) return t
71+
return {
72+
...t,
73+
endTime,
74+
duration,
75+
status,
76+
...(tokens && { tokens }),
77+
...(cost !== undefined && { cost }),
78+
...(output !== undefined && { output }),
79+
...(outputSummary !== undefined && { outputSummary }),
80+
...(metadata && { metadata: { ...t.metadata, ...metadata } }),
81+
}
82+
})
83+
})
84+
}
85+
})
86+
87+
return {
88+
getTraces(messageID: string): CallTraceItem[] {
89+
return traces[messageID] ?? []
90+
},
91+
}
92+
},
93+
})

‎packages/opencode/src/cli/cmd/tui/routes/session/index.tsx‎

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,15 @@ import { DialogExportOptions } from "../../ui/dialog-export-options"
8080
import { formatTranscript } from "../../util/transcript"
8181
import { UI } from "@/cli/ui.ts"
8282
import { useTuiConfig } from "../../context/tui-config"
83+
import { useCallTrace, type CallTraceItem, type TraceSource } from "../../context/call-trace"
84+
import {
85+
formatDuration,
86+
formatTime,
87+
truncate,
88+
formatInput,
89+
formatOutput,
90+
SOURCE_COLORS,
91+
} from "../../component/call-trace-helpers"
8392

8493
addDefaultParsers(parsers.parsers)
8594

@@ -153,6 +162,7 @@ export function Session() {
153162
const [timestamps, setTimestamps] = kv.signal<"hide" | "show">("timestamps", "hide")
154163
const [showDetails, setShowDetails] = kv.signal("tool_details_visibility", true)
155164
const [showAssistantMetadata, setShowAssistantMetadata] = kv.signal("assistant_metadata_visibility", true)
165+
const [showCallTrace, setShowCallTrace] = createSignal(true)
156166
const [showScrollbar, setShowScrollbar] = kv.signal("scrollbar_visible", true)
157167
const [diffWrapMode] = kv.signal<"word" | "none">("diff_wrap_mode", "word")
158168
const [animationsEnabled, setAnimationsEnabled] = kv.signal("animations_enabled", true)
@@ -577,6 +587,16 @@ export function Session() {
577587
dialog.clear()
578588
},
579589
},
590+
{
591+
title: showCallTrace() ? "Hide CallTraceBar" : "Show CallTraceBar",
592+
value: "session.calltrace.toggle",
593+
keybind: "calltrace_toggle",
594+
category: "Session",
595+
onSelect: (dialog) => {
596+
setShowCallTrace(() => !showCallTrace())
597+
dialog.clear()
598+
},
599+
},
580600
{
581601
title: conceal() ? "Disable code concealment" : "Enable code concealment",
582602
value: "session.toggle.conceal",
@@ -1152,6 +1172,9 @@ export function Session() {
11521172
)}
11531173
</For>
11541174
</scrollbox>
1175+
<Show when={showCallTrace()}>
1176+
<CallTraceBar />
1177+
</Show>
11551178
<box flexShrink={0}>
11561179
<Show when={permissions().length > 0}>
11571180
<PermissionPrompt request={permissions()[0]} />
@@ -1217,6 +1240,120 @@ const MIME_BADGE: Record<string, string> = {
12171240
"application/x-directory": "dir",
12181241
}
12191242

1243+
function CallTraceBar() {
1244+
const callTrace = useCallTrace()
1245+
const sync = useSync()
1246+
const route = useRouteData("session")
1247+
const { theme } = useTheme()
1248+
const [expanded, setExpanded] = createSignal<Record<string, { in: boolean; out: boolean }>>({})
1249+
const messages = createMemo(() => sync.data.message[route.sessionID] ?? [])
1250+
const allTraces = createMemo(() => messages().flatMap((msg) => callTrace.getTraces(msg.id)))
1251+
const hasTraces = createMemo(() => allTraces().length > 0)
1252+
const isExpanded = (id: string, field: "in" | "out") => expanded()[id]?.[field] ?? false
1253+
const toggle = (id: string, field: "in" | "out") =>
1254+
setExpanded((prev) => ({ ...prev, [id]: { ...prev[id], [field]: !prev[id]?.[field] } }))
1255+
const sourceColor: Record<string, any> = { OC: theme.info, OMO: theme.warning, LLM: theme.success }
1256+
1257+
return (
1258+
<box flexShrink={0}>
1259+
<Show
1260+
when={hasTraces()}
1261+
fallback={
1262+
<box
1263+
border={["left"]}
1264+
backgroundColor={theme.backgroundPanel}
1265+
customBorderChars={SplitBorder.customBorderChars}
1266+
borderColor={theme.warning}
1267+
paddingTop={1}
1268+
paddingBottom={1}
1269+
paddingLeft={2}
1270+
>
1271+
<text>
1272+
<span style={{ fg: theme.warning, attributes: TextAttributes.BOLD }}>◈ CallTraceBar</span>
1273+
<span style={{ fg: theme.textMuted }}> (no traces)</span>
1274+
</text>
1275+
</box>
1276+
}
1277+
>
1278+
<box
1279+
border={["left"]}
1280+
backgroundColor={theme.backgroundPanel}
1281+
customBorderChars={SplitBorder.customBorderChars}
1282+
borderColor={theme.warning}
1283+
paddingTop={1}
1284+
paddingBottom={1}
1285+
paddingLeft={2}
1286+
gap={1}
1287+
>
1288+
<text>
1289+
<span style={{ fg: theme.warning, attributes: TextAttributes.BOLD }}>◈ CallTraceBar</span>
1290+
<span style={{ fg: theme.textMuted }}>
1291+
{" "}
1292+
({formatDuration(allTraces().reduce((sum, t) => sum + (t.duration ?? 0), 0))})
1293+
</span>
1294+
<span style={{ fg: theme.textMuted }}> [{allTraces().length}]</span>
1295+
</text>
1296+
<scrollbox
1297+
height={8}
1298+
stickyScroll={true}
1299+
stickyStart="bottom"
1300+
viewportOptions={{ paddingRight: 1 }}
1301+
verticalScrollbarOptions={{
1302+
paddingLeft: 1,
1303+
visible: true,
1304+
trackOptions: { backgroundColor: theme.backgroundPanel, foregroundColor: theme.textMuted },
1305+
}}
1306+
>
1307+
<For each={allTraces()}>
1308+
{(trace) => (
1309+
<box flexDirection="column" paddingBottom={1}>
1310+
<text>
1311+
<span> </span>
1312+
<span style={{ fg: sourceColor[trace.source] }}>[{trace.source}]</span>
1313+
<span style={{ fg: theme.text }}> {trace.name}</span>
1314+
<Show when={trace.duration !== undefined}>
1315+
<span style={{ fg: theme.textMuted }}> {formatDuration(trace.duration!)}</span>
1316+
</Show>
1317+
<span style={{ fg: theme.textMuted }}> {formatTime(trace.startTime)}</span>
1318+
</text>
1319+
<Show when={formatInput(trace)}>
1320+
<box onMouseUp={() => toggle(trace.id, "in")}>
1321+
<text paddingLeft={3}>
1322+
<span style={{ fg: theme.textMuted }}>in: </span>
1323+
<Show
1324+
when={isExpanded(trace.id, "in")}
1325+
fallback={<span style={{ fg: theme.text }}>{truncate(formatInput(trace), 50)}</span>}
1326+
>
1327+
<span style={{ fg: theme.text }}>{formatInput(trace)}</span>
1328+
</Show>
1329+
<span style={{ fg: theme.textMuted }}>{isExpanded(trace.id, "in") ? " [-]" : " [+]"}</span>
1330+
</text>
1331+
</box>
1332+
</Show>
1333+
<Show when={formatOutput(trace)}>
1334+
<box onMouseUp={() => toggle(trace.id, "out")}>
1335+
<text paddingLeft={3}>
1336+
<span style={{ fg: theme.textMuted }}>out: </span>
1337+
<Show
1338+
when={isExpanded(trace.id, "out")}
1339+
fallback={<span style={{ fg: theme.text }}>{truncate(formatOutput(trace), 50)}</span>}
1340+
>
1341+
<span style={{ fg: theme.text }}>{formatOutput(trace)}</span>
1342+
</Show>
1343+
<span style={{ fg: theme.textMuted }}>{isExpanded(trace.id, "out") ? " [-]" : " [+]"}</span>
1344+
</text>
1345+
</box>
1346+
</Show>
1347+
</box>
1348+
)}
1349+
</For>
1350+
</scrollbox>
1351+
</box>
1352+
</Show>
1353+
</box>
1354+
)
1355+
}
1356+
12201357
function UserMessage(props: {
12211358
message: UserMessage
12221359
parts: Part[]

‎packages/opencode/src/config/config.ts‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -650,6 +650,7 @@ export namespace Config {
650650
editor_open: z.string().optional().default("<leader>e").describe("Open external editor"),
651651
theme_list: z.string().optional().default("<leader>t").describe("List available themes"),
652652
sidebar_toggle: z.string().optional().default("<leader>b").describe("Toggle sidebar"),
653+
calltrace_toggle: z.string().optional().default("<leader>v").describe("Toggle CallTraceBar"),
653654
scrollbar_toggle: z.string().optional().default("none").describe("Toggle session scrollbar"),
654655
username_toggle: z.string().optional().default("none").describe("Toggle username visibility"),
655656
status_view: z.string().optional().default("<leader>s").describe("View status"),

‎packages/opencode/src/provider/models-snapshot.ts‎

Lines changed: 2 additions & 0 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)