diff --git a/harness/server-reference/tests/recording_queries.rs b/harness/server-reference/tests/recording_queries.rs
index e9a59ed5..472565de 100644
--- a/harness/server-reference/tests/recording_queries.rs
+++ b/harness/server-reference/tests/recording_queries.rs
@@ -160,6 +160,7 @@ fn authorized_search_timeline_summaries_revocation_and_separate_database_outage(
},
);
let mut exec_sql = postgres::Client::connect(&execution, postgres::NoTls).unwrap();
+ exec_sql.batch_execute("SET ow.runtime_schema='6'").unwrap();
exec_sql.batch_execute(&format!("INSERT INTO {schema}.api_session_owners VALUES('s_alice','alice'),('s_empty','alice'),('s_bob','bob');UPDATE {schema}.submissions SET created='2026-01-01 00:00:00+00'" )).unwrap();
let recording = config
.observability
diff --git a/harness/service-ui/public/app.js b/harness/service-ui/public/app.js
index 253854a1..e622ddae 100644
--- a/harness/service-ui/public/app.js
+++ b/harness/service-ui/public/app.js
@@ -1,4 +1,5 @@
import {renderCompliance} from "./compliance.js";
+import {mountSessionTracing, serviceTracingAdapter} from "./tracing.js";
import { mountObservability } from "./observability.js";
let disposeObservability = null;
let safetyActivity = null;
@@ -559,12 +560,30 @@ async function render() {
main.innerHTML = empty("Loading…");
try {
if (page === "observability") {
- disposeObservability = mountObservability(main, {
- request: (path, signal) =>
- api(path, "GET", undefined, undefined, signal),
- isAdmin: can.admin(),
- children: true,
- });
+ const request = (path, signal) =>
+ api(path, "GET", undefined, undefined, signal);
+ const tracing = () => {
+ disposeObservability?.();
+ const view = mountSessionTracing(main, {
+ adapter: serviceTracingAdapter(request),
+ onOverview: overview,
+ });
+ disposeObservability = () => view.dispose();
+ };
+ const overview = () => {
+ disposeObservability?.();
+ disposeObservability = mountObservability(main, {
+ request,
+ isAdmin: can.admin(),
+ children: true,
+ });
+ const back = document.createElement("button");
+ back.className = "button";
+ back.textContent = "← Session tracing";
+ back.addEventListener("click", tracing);
+ main.prepend(back);
+ };
+ tracing();
return;
}
let html;
diff --git a/harness/service-ui/public/index.html b/harness/service-ui/public/index.html
index 4ba32120..d934f27d 100644
--- a/harness/service-ui/public/index.html
+++ b/harness/service-ui/public/index.html
@@ -6,6 +6,7 @@
OpenWorker · Management
+
diff --git a/harness/service-ui/public/tracing.css b/harness/service-ui/public/tracing.css
new file mode 100644
index 00000000..eaa15dce
--- /dev/null
+++ b/harness/service-ui/public/tracing.css
@@ -0,0 +1,522 @@
+/* Optional, scoped session tracing styles. No runtime dependencies or global reset. */
+.ow-session-tracing {
+ font:
+ 13px/1.5 -apple-system,
+ BlinkMacSystemFont,
+ "Segoe UI",
+ sans-serif;
+ color: #29313d;
+ max-width: 1760px;
+ margin: auto;
+ --tr-border: #e2e7ee;
+ --tr-muted: #8a96a6;
+ background: #fafbfd;
+ padding: 24px;
+}
+.ow-session-tracing * {
+ box-sizing: border-box;
+}
+.ow-session-tracing [hidden] {
+ display: none !important;
+}
+.ow-session-tracing button,
+.ow-session-tracing input {
+ font: inherit;
+}
+.ow-session-tracing button {
+ cursor: pointer;
+ color: inherit;
+ background: white;
+ border: 1px solid var(--tr-border);
+ border-radius: 6px;
+ padding: 6px 10px;
+}
+.ow-session-tracing button:hover {
+ background: #f1f5fa;
+}
+.ow-session-tracing button:focus-visible,
+.ow-session-tracing input:focus-visible {
+ outline: 2px solid #6a8cbb;
+ outline-offset: 2px;
+}
+.ow-session-tracing svg {
+ width: 14px;
+ height: 14px;
+ flex-shrink: 0;
+}
+.ow-session-tracing h1 {
+ font-size: 27px;
+ letter-spacing: -0.9px;
+ margin: 0;
+}
+.ow-session-tracing h2 {
+ font-size: 20px;
+ letter-spacing: -0.55px;
+ margin: 12px 0;
+}
+.ow-session-tracing p {
+ margin: 5px 0;
+ color: #8a96a6;
+}
+.tr-heading,
+.tr-heading > div:last-child {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 8px;
+}
+.tr-heading {
+ margin-bottom: 22px;
+}
+.tr-heading > div:first-child {
+ display: block;
+}
+.tr-toolbar {
+ display: flex;
+ align-items: center;
+ gap: 18px;
+ margin-bottom: 18px;
+}
+.tr-toolbar input {
+ background: #fff;
+ border: 1px solid var(--tr-border);
+ border-radius: 7px;
+ padding: 10px 14px;
+ flex: 1;
+ min-width: 160px;
+ color: inherit;
+}
+.tr-directory-state {
+ font-size: 10px;
+ color: var(--tr-muted);
+}
+.tr-workbench {
+ display: grid;
+ grid-template-columns: 230px minmax(360px, 1.15fr) minmax(300px, 1fr);
+ height: calc(100vh - 240px);
+ min-height: 610px;
+ border: 1px solid #dde4ed;
+ border-radius: 11px;
+ background: #fff;
+ overflow: hidden;
+ box-shadow: 0 4px 18px #243a5510;
+}
+.tr-workbench > aside,
+.tr-workbench > section {
+ min-width: 0;
+ overflow: auto;
+}
+.tr-workbench > section {
+ border-left: 1px solid var(--tr-border);
+}
+.tr-directory {
+ background: #f8fafd;
+}
+.tr-panehead {
+ position: sticky;
+ top: 0;
+ z-index: 2;
+ background: #fff;
+ height: 46px;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 0 18px;
+ border-bottom: 1px solid #edf0f4;
+ font-size: 9px;
+ letter-spacing: 1px;
+ text-transform: uppercase;
+ color: #8b97a7;
+}
+.tr-directory .tr-panehead {
+ background: #f8fafd;
+}
+.tr-results {
+ padding: 9px;
+}
+.ow-session-tracing .tr-session {
+ width: 100%;
+ text-align: left;
+ background: transparent;
+ padding: 13px 11px;
+ margin: 0 0 4px;
+ border: 1px solid transparent;
+ border-radius: 7px;
+}
+.ow-session-tracing .selected {
+ background: #edf3fa !important;
+ outline: 1px solid #dce6f2;
+ outline-offset: -1px;
+}
+.ow-session-tracing .tr-session.selected {
+ background: #fff !important;
+ border: 1px solid #dce5f1;
+ outline: 0;
+ box-shadow: 0 1px 5px #243a550a;
+}
+.tr-session strong {
+ display: block;
+ overflow-wrap: anywhere;
+ font-size: 12px;
+ font-weight: 600;
+ margin-bottom: 8px;
+}
+.tr-session > span {
+ display: flex;
+ justify-content: space-between;
+ gap: 8px;
+ font-size: 10px;
+ color: #8692a3;
+}
+.tr-status {
+ font-style: normal;
+}
+.tr-session code {
+ font-size: 9px;
+ color: #9aa6b6;
+ display: block;
+ overflow: hidden;
+ text-overflow: ellipsis;
+ margin-top: 7px;
+}
+.tr-directory-footer {
+ padding: 5px 18px;
+}
+.tr-directory-footer button {
+ font-size: 11px;
+}
+.tr-segment {
+ display: flex;
+ gap: 2px;
+ padding: 3px;
+ background: #f0f3f8;
+ border-radius: 6px;
+}
+.ow-session-tracing .tr-segment button {
+ border: 0;
+ background: none;
+ padding: 4px 8px;
+ font-size: 10px;
+ letter-spacing: 0;
+ text-transform: none;
+}
+.ow-session-tracing .tr-segment button[aria-pressed="true"] {
+ background: #fff;
+ box-shadow: 0 1px 4px #243a5515;
+}
+.tr-breadcrumb {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 7px;
+ padding: 16px 20px 0;
+ color: #9da7b5;
+ font-size: 10px;
+}
+.ow-session-tracing .tr-breadcrumb button {
+ border: 0;
+ background: none;
+ padding: 0;
+ color: #6f88aa;
+ font-size: 10px;
+}
+.tr-breadcrumb strong {
+ font-weight: 500;
+ color: #67758a;
+}
+.tr-context > h2 {
+ padding: 0 20px;
+}
+.tr-chips {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 6px;
+ padding: 0 20px 18px;
+ border-bottom: 1px solid #edf0f4;
+ align-items: center;
+}
+.tr-chips span {
+ font-size: 10px;
+ background: #f0f4f9;
+ border-radius: 4px;
+ padding: 4px 7px;
+ color: #708197;
+}
+.tr-chips code {
+ font-size: 9px;
+ color: #99a4b4;
+ overflow-wrap: anywhere;
+}
+.tr-turns {
+ padding: 12px 14px 24px;
+}
+.ow-session-tracing .tr-turn-heading {
+ display: flex;
+ align-items: center;
+ gap: 9px;
+ width: 100%;
+ text-align: left;
+ background: none;
+ border: 0;
+ padding: 13px 4px;
+}
+.tr-turn-heading b {
+ font-size: 11px;
+ font-weight: 600;
+ overflow-wrap: anywhere;
+}
+.tr-turn-heading small {
+ display: block;
+ font-size: 10px;
+ color: #9aa5b4;
+ margin-top: 3px;
+}
+.tr-chevron {
+ color: #98a6b8;
+ transition: transform 0.15s;
+}
+.tr-chevron.open {
+ transform: rotate(90deg);
+}
+.tr-calls {
+ padding: 4px 0 15px 24px;
+}
+.tr-turn-metrics {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 12px;
+ padding: 0 7px 12px;
+ font-size: 9px;
+ color: #99a5b5;
+}
+.ow-session-tracing .tr-step {
+ width: 100%;
+ min-height: 35px;
+ display: flex;
+ align-items: center;
+ gap: 8px;
+ border: 0;
+ border-radius: 5px;
+ background: none;
+ padding: 7px 6px;
+ font-size: 11px;
+ text-align: left;
+}
+.tr-step-name {
+ display: flex;
+ align-items: center;
+ gap: 7px;
+ flex: 1;
+ min-width: 0;
+ padding-left: calc(var(--indent) * 12px);
+}
+.tr-step-name > span {
+ overflow: hidden;
+ text-overflow: ellipsis;
+ white-space: nowrap;
+}
+.tr-step svg {
+ padding: 2px;
+ width: 18px;
+ height: 18px;
+ border-radius: 5px;
+ background: #edf2f9;
+ color: #7b98bc;
+}
+.tr-model svg {
+ background: #f1edf8;
+ color: #9b89bc;
+}
+.tr-tool svg {
+ background: #edf4ef;
+ color: #7d9e8a;
+}
+.tr-duration {
+ font-size: 10px;
+ color: #98a4b5;
+ flex-shrink: 0;
+}
+.tr-outcome {
+ font-size: 9px;
+ color: #8ba393;
+ min-width: 25px;
+ text-align: right;
+}
+.tr-axis {
+ display: flex;
+ justify-content: space-between;
+ margin-left: 165px;
+ font-size: 9px;
+ color: #9aa6b7;
+ padding: 5px 0 12px;
+}
+.tr-waterfall .tr-step-name {
+ flex: 0 0 165px;
+ width: 165px;
+ font-size: 10px;
+}
+.tr-track {
+ position: relative;
+ height: 22px;
+ flex: 1;
+ background: repeating-linear-gradient(
+ 90deg,
+ transparent,
+ transparent calc(25% - 1px),
+ #edf1f6 calc(25% - 1px),
+ #edf1f6 25%
+ );
+}
+.tr-track i {
+ position: absolute;
+ top: 5px;
+ height: 12px;
+ min-width: 3px;
+ border-radius: 3px;
+ background: #99b0cc;
+}
+.tr-model .tr-track i {
+ background: #b0a1ce;
+}
+.tr-tool .tr-track i {
+ background: #91ad9c;
+}
+.tr-track i.tr-failed {
+ background: #c08f86;
+}
+.tr-track small {
+ font-size: 8px;
+ color: #99a4b5;
+}
+.tr-children {
+ padding: 8px 4px;
+}
+.tr-children > div {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 10px;
+ margin: 7px 0;
+}
+.tr-children span {
+ display: flex;
+ align-items: center;
+ gap: 6px;
+ font-size: 11px;
+}
+.tr-children svg {
+ color: #8aa2c2;
+}
+.tr-children small {
+ font-size: 9px;
+ color: #99a5b4;
+}
+.tr-children button {
+ font-size: 10px;
+ color: #718caf;
+ background: #f6f9fc;
+}
+.tr-note,
+.tr-error {
+ font-size: 11px;
+ line-height: 1.7;
+ padding: 10px;
+}
+.ow-session-tracing .tr-error {
+ color: #b47c73;
+}
+.tr-detail-title {
+ padding: 23px 22px 0;
+ background: linear-gradient(145deg, #fff, #f9fbff);
+}
+.tr-detail-title > small {
+ font-size: 9px;
+ color: #8b99ad;
+ letter-spacing: 0.8px;
+}
+.tr-detail-title .tr-chips {
+ padding-left: 0;
+ padding-right: 0;
+ border: 0;
+}
+.tr-tabs {
+ display: flex;
+ gap: 22px;
+ padding: 0 22px;
+ border-bottom: 1px solid var(--tr-border);
+}
+.ow-session-tracing .tr-tabs button {
+ background: none;
+ border: 0;
+ border-radius: 0;
+ padding: 12px 0;
+ font-size: 11px;
+ color: #99a3b2;
+}
+.ow-session-tracing .tr-tabs button[aria-pressed="true"] {
+ border-bottom: 2px solid #6b8aad;
+ color: #4c6c95;
+}
+.tr-detail-body {
+ padding: 22px;
+}
+.tr-detail-body h3 {
+ font-size: 11px;
+ margin: 0 0 12px;
+ font-weight: 600;
+}
+.tr-empty,
+.tr-detail-body pre {
+ font-size: 11px;
+ line-height: 1.8;
+ background: #f8fafd;
+ padding: 15px;
+ border: 1px solid #e6ecf4;
+ border-radius: 6px;
+ margin: 0 0 24px;
+ color: #8998ad;
+}
+.tr-detail-body pre {
+ font:
+ 10px/1.9 ui-monospace,
+ SFMono-Regular,
+ monospace;
+ white-space: pre-wrap;
+ overflow-wrap: anywhere;
+ color: #557394;
+}
+.tr-detail-body dl {
+ display: grid;
+ grid-template-columns: 90px 1fr;
+ gap: 12px;
+ font-size: 10px;
+}
+.tr-detail-body dt {
+ color: #99a5b4;
+}
+.tr-detail-body dd {
+ margin: 0;
+ color: #72849b;
+ overflow-wrap: anywhere;
+}
+@media (max-width: 1100px) {
+ .tr-workbench {
+ grid-template-columns: 190px minmax(300px, 1fr);
+ height: auto;
+ }
+ .tr-inspector {
+ grid-column: 1/-1;
+ min-height: 300px;
+ border-top: 1px solid var(--tr-border);
+ }
+ .tr-execution {
+ min-height: 500px;
+ }
+ .tr-toolbar {
+ flex-wrap: wrap;
+ }
+}
+@media (prefers-reduced-motion: reduce) {
+ .tr-chevron {
+ transition: none;
+ }
+}
diff --git a/harness/service-ui/public/tracing.js b/harness/service-ui/public/tracing.js
new file mode 100644
index 00000000..82008d6b
--- /dev/null
+++ b/harness/service-ui/public/tracing.js
@@ -0,0 +1,540 @@
+import { esc, duration, count } from "./observability-data.js";
+const id = (s) => encodeURIComponent(s);
+const path = (q) =>
+ `/v1/sessions/${id(q.sessionId)}/observability/${id(q.turnId)}`;
+/** Transport stays in the trusted application; the component never stores credentials. */
+export function serviceTracingAdapter(request) {
+ const get = (p, signal) => request(p, signal);
+ return {
+ search: async (q, signal) =>
+ get(
+ "/v1/observability/runs?" +
+ new URLSearchParams({
+ q: q.q || "",
+ limit: "25",
+ ...(q.after ? { after: q.after } : {}),
+ }),
+ signal,
+ ),
+ // The existing run directory is authorized and cursor-bound. Exact matching is
+ // essential: its text search can also match another session's partial ID.
+ turns: async (q, signal) => {
+ const p = await get(
+ "/v1/observability/runs?" +
+ new URLSearchParams({
+ q: q.sessionId,
+ limit: "100",
+ ...(q.after ? { after: q.after } : {}),
+ }),
+ signal,
+ );
+ return {
+ turns: p.runs.filter((r) => r.session_id === q.sessionId),
+ next_cursor: p.next_cursor,
+ };
+ },
+ timeline: (q, signal) =>
+ get(
+ path(q) +
+ "/timeline?" +
+ new URLSearchParams({
+ limit: "100",
+ after: String(q.after ?? 0),
+ ...(q.through != null ? { through: String(q.through) } : {}),
+ }),
+ signal,
+ ),
+ summary: (q, signal) => get(path(q) + "/summary", signal),
+ children: (q, signal) => get(path(q) + "/children", signal),
+ };
+}
+const svg = (kind) => {
+ const shapes = {
+ model: '',
+ tool: '',
+ agent:
+ '',
+ chevron: '',
+ };
+ return ``;
+};
+const kind = (s) =>
+ s.operation.startsWith("model.")
+ ? "model"
+ : s.operation.startsWith("tool.")
+ ? "tool"
+ : "agent";
+const name = (s) =>
+ (s.tool && s.tool.replaceAll("__", " · ").replaceAll("_", " ")) ||
+ (s.model && s.operation === "model.attempt" && `Model · ${s.model}`) ||
+ {
+ "agent.execute": "Execution segment",
+ "model.requested": "Request started",
+ "policy.review": "Policy check",
+ "approval.wait": "Approval wait",
+ "question.wait": "Question wait",
+ "environment.operation": "Prepare environment",
+ }[s.operation] ||
+ s.operation;
+const key = (s) => s.trace_id + "/" + s.span_id;
+const reason = (e) =>
+ e?.status === 403
+ ? "You cannot read this session."
+ : e?.status === 404
+ ? "This recording is no longer available."
+ : e?.status === 503
+ ? "Recording is disabled or unavailable."
+ : e?.status === 429
+ ? "Recording readers are busy. Try Refresh."
+ : "Unable to load recording. Try Refresh.";
+const button = (action, text, extra = "") =>
+ ``;
+const scope = (r) => ({ sessionId: r.session_id, turnId: r.turn_id });
+/** Session-oriented trace browser. No evaluations or combined team view. */
+export function mountSessionTracing(
+ root,
+ { adapter, initialRun = null, onOverview } = {},
+) {
+ if (!adapter) throw Error("A tracing adapter is required");
+ const lifetime = new AbortController(),
+ signal = lifetime.signal;
+ let disposed = false,
+ searchGen = 0,
+ sessionGen = 0,
+ detailGen = 0,
+ timer;
+ let results = [],
+ nextSearch = null,
+ searchText = "",
+ session = null,
+ turns = [],
+ nextTurns = null,
+ history = [],
+ cache = new Map(),
+ selected = null,
+ details = null,
+ mode = "tree",
+ tab = "preview",
+ pending = false;
+ root.classList.add("ow-session-tracing");
+ root.innerHTML = `Tracing
Follow a session, one turn at a time.
${onOverview ? button("overview", "Usage overview ↗") : ""}${button("refresh", "Refresh")}
Execution${button("tree", "Tree", 'aria-pressed="true"')}${button("waterfall", "Waterfall", 'aria-pressed="false"')}
`;
+ const $ = (s) => root.querySelector(s);
+ const query = () => $(".tr-toolbar input").value;
+ function sessions() {
+ const map = new Map();
+ for (const r of results)
+ if (!map.has(r.session_id)) map.set(r.session_id, r);
+ return [...map.values()];
+ }
+ function directory() {
+ const rs = sessions();
+ $(".tr-results").innerHTML =
+ rs
+ .map(
+ (r) =>
+ ``,
+ )
+ .join("") ||
+ 'No matching sessions on this page.
';
+ $(".tr-directory-footer").innerHTML = nextSearch
+ ? button("more-search", "More sessions")
+ : "";
+ }
+ async function search(more = false) {
+ const gen = ++searchGen,
+ q = searchText;
+ $(".tr-directory-state").textContent = "Searching…";
+ try {
+ const page = await adapter.search(
+ { q, after: more ? nextSearch : undefined },
+ signal,
+ );
+ if (disposed || gen !== searchGen) return;
+ results = (more ? [...results, ...page.runs] : page.runs).slice(0, 1000);
+ nextSearch = results.length < 1000 ? page.next_cursor : null;
+ $(".tr-directory-state").textContent =
+ `${sessions().length} sessions loaded${nextSearch ? " · more available" : ""}`;
+ directory();
+ if (!session && results.length) await openSession(results[0]);
+ } catch (e) {
+ if (disposed || gen !== searchGen) return;
+ results = [];
+ nextSearch = null;
+ directory();
+ $(".tr-directory-state").textContent = reason(e);
+ }
+ }
+ function crumb() {
+ return `${button("home", "Sessions")}${history.length ? `›${button("back", esc(history.at(-1).session.name || history.at(-1).session.agent || "Parent agent"))}›${button("back", esc(history.at(-1).parentTurn))}` : ""}›${esc(session?.name || session?.agent || "Session")}
`;
+ }
+ function context() {
+ if (!session) return;
+ $(".tr-context").innerHTML =
+ crumb() +
+ `${esc(session.name || session.agent || session.session_id)}
${esc(session.status || "Unknown")}${turns.length} ${turns.length === 1 ? "turn" : "turns"} loaded${nextTurns ? " · more available" : ""}${esc(session.session_id)}
`;
+ }
+ const visibleSteps = (c) =>
+ (c.steps || []).filter((s) => s.operation !== "model.requested");
+ function body(t, c) {
+ if (c.error) return `${esc(c.error)}
`;
+ if (c.loading)
+ return 'Loading recording…
';
+ const ss = visibleSteps(c),
+ known = ss.filter(
+ (s) => Number.isFinite(s.started_ms) && Number.isFinite(s.duration_us),
+ ),
+ start = known.length ? Math.min(...known.map((s) => s.started_ms)) : 0,
+ end = known.length
+ ? Math.max(...known.map((s) => s.started_ms + s.duration_us / 1000))
+ : 1,
+ range = Math.max(1, end - start),
+ summary = c.summary;
+ const total = summary?.usage;
+ const tokens =
+ total?.input?.total != null && total?.output?.total != null
+ ? `${count(total.input.total + total.output.total)}${total.input.unknown || total.output.unknown ? " + unknown" : ""}`
+ : "Not reported";
+ let html = `${esc(duration(summary?.wall_elapsed_us))} elapsed${tokens} tokens${ss.length} steps loaded
`;
+ if (mode === "waterfall")
+ html += `${[0, 1, 2, 3, 4].map((i) => `${i ? esc(duration(((range * i) / 4) * 1000)) : "0 s"}`).join("")}
`;
+ // Indentation follows recorded parent IDs only. Missing parents are roots;
+ // cycles are bounded and labelled, never silently invented.
+ const map = new Map(ss.map((s) => [key(s), s]));
+ const depth = (s) => {
+ let n = 0,
+ p = s,
+ seen = new Set([key(s)]);
+ while (n < 6) {
+ const parent = map.get(p.parent_trace_id + "/" + p.parent_span_id);
+ if (!parent || seen.has(key(parent))) break;
+ seen.add(key(parent));
+ n++;
+ p = parent;
+ }
+ return n;
+ };
+ for (const s of ss) {
+ const d = depth(s),
+ k = kind(s),
+ timing =
+ Number.isFinite(s.started_ms) && Number.isFinite(s.duration_us);
+ html += ``;
+ }
+ if (c.next != null)
+ html +=
+ c.steps.length < 1000
+ ? button(
+ "more-steps",
+ "Load more steps",
+ `data-turn="${esc(t.turn_id)}"`,
+ )
+ : 'Showing 1,000 steps. Narrow the query through the SDK to inspect further records.
';
+ if (!ss.length)
+ html += 'No recorded steps for this turn.
';
+ html += `${(c.children || []).map((child, i) => `
${svg("agent")}${esc(child.agent_id)} ${esc(child.phase)}${child.child_turn_id ? button("child", `Open session ↗`, `data-turn="${esc(t.turn_id)}" data-child="${i}" aria-label="Open ${esc(child.agent_id)} session"`) : "Initial turn unavailable"}
`).join("")}
`;
+ if (c.childError)
+ html +=
+ 'Child links are unavailable for this turn.
';
+ const cov = summary?.coverage;
+ if (
+ cov?.scan_truncated ||
+ cov?.hierarchy_incomplete ||
+ cov?.unknown_outcome_steps ||
+ cov?.unknown_timing_steps
+ )
+ html +=
+ 'Partial coverage: some timing, hierarchy or outcomes are incomplete. Recording is best effort.
';
+ return html;
+ }
+ function render() {
+ context();
+ directory();
+ $(".tr-turns").innerHTML =
+ turns
+ .map((t) => {
+ const c = cache.get(t.turn_id);
+ return `${c?.open ? `${body(t, c)}
` : ""}`;
+ })
+ .join("") +
+ (nextTurns != null ? button("more-turns", "Load more turns") : "") +
+ (pending ? 'Loading turns…
' : "");
+ root
+ .querySelectorAll(".tr-segment button")
+ .forEach((b) =>
+ b.setAttribute("aria-pressed", String(b.dataset.tr === mode)),
+ );
+ for (const el of root.querySelectorAll("[data-depth]"))
+ el.style.setProperty("--indent", el.dataset.depth);
+ for (const el of root.querySelectorAll("[data-left]")) {
+ el.style.left = el.dataset.left + "%";
+ el.style.width = el.dataset.width + "%";
+ }
+ }
+ async function loadTurns(more = false, target) {
+ if (more && pending) return;
+ const gen = sessionGen,
+ sid = session.session_id;
+ pending = true;
+ render();
+ try {
+ const p = await adapter.turns(
+ { sessionId: sid, after: more ? nextTurns : undefined },
+ signal,
+ );
+ if (disposed || gen !== sessionGen) return;
+ const incoming = p.turns.filter((t) => t.session_id === sid);
+ if (!more && incoming[0])
+ session = { ...session, status: incoming[0].status };
+ const unique = new Map(
+ (more ? [...turns, ...incoming] : incoming).map((t) => [t.turn_id, t]),
+ );
+ turns = [...unique.values()];
+ turns = turns.slice(0, 1000);
+ nextTurns = turns.length < 1000 ? p.next_cursor : null;
+ pending = false;
+ if (target && !turns.some((t) => t.turn_id === target.turn_id))
+ turns.unshift({ ...target, session_id: sid });
+ render();
+ if (!more && turns.length) {
+ const t = turns.find((t) => t.turn_id === target?.turn_id) || turns[0];
+ await loadTurn(t);
+ }
+ } catch (e) {
+ if (disposed || gen !== sessionGen) return;
+ pending = false;
+ turns = [];
+ nextTurns = null;
+ render();
+ $(".tr-turns").innerHTML =
+ `${esc(reason(e))}
`;
+ }
+ }
+ async function openSession(r, target) {
+ sessionGen++;
+ detailGen++;
+ session = r;
+ turns = [];
+ cache = new Map();
+ selected = null;
+ details = null;
+ nextTurns = null;
+ $(".tr-details").innerHTML =
+ 'Select a model or tool call.
';
+ await loadTurns(false, target || r);
+ }
+ async function loadTurn(t, more = false) {
+ const gen = sessionGen,
+ old = cache.get(t.turn_id) || {},
+ q = scope(t);
+ const c = { ...old, open: true, loading: true };
+ cache.set(t.turn_id, c);
+ render();
+ try {
+ const [page, s, child] = await Promise.all([
+ adapter.timeline(
+ {
+ ...q,
+ after: more ? old.next : undefined,
+ through: more ? old.through : undefined,
+ limit: 100,
+ },
+ signal,
+ ),
+ more
+ ? Promise.resolve({ summary: old.summary })
+ : adapter.summary(q, signal),
+ more
+ ? Promise.resolve({ children: old.children })
+ : adapter.children
+ ? adapter
+ .children(q, signal)
+ .catch(() => ({ children: [], unavailable: true }))
+ : Promise.resolve({ children: [] }),
+ ]);
+ if (disposed || gen !== sessionGen || cache.get(t.turn_id) !== c) return;
+ const steps = [
+ ...(more ? old.steps || [] : []),
+ ...page.page.steps.map((x) => x.step),
+ ];
+ Object.assign(c, {
+ steps: steps.slice(0, 1000),
+ next: page.page.next,
+ through: page.page.through,
+ summary: s.summary,
+ children: child.children,
+ childError: child.unavailable,
+ loading: false,
+ error: null,
+ });
+ render();
+ } catch (e) {
+ if (disposed || gen !== sessionGen) return;
+ Object.assign(c, {
+ loading: false,
+ error: reason(e),
+ steps: [],
+ children: [],
+ });
+ if (selected?.turn.turn_id === t.turn_id) {
+ selected = null;
+ details = null;
+ detailGen++;
+ $(".tr-details").innerHTML =
+ 'Selected recording is unavailable.
';
+ }
+ render();
+ }
+ }
+ function inspector() {
+ const s = selected?.step;
+ if (!s) return;
+ const payload = (v) =>
+ v === undefined || v === null
+ ? 'Content was not captured or is not available to this viewer.
'
+ : `${esc(typeof v === "string" ? v : JSON.stringify(v, null, 2))}`;
+ $(".tr-details").innerHTML =
+ `${esc(s.operation)}${esc(name(s))}
${esc(s.outcome)}${esc(duration(s.duration_us))}
${["preview", "attributes", "json"].map((x) => button(x, x === "json" ? "JSON" : x[0].toUpperCase() + x.slice(1), `aria-pressed="${tab === x}"`)).join("")}
${
+ tab === "json"
+ ? `
${esc(JSON.stringify(s, null, 2))}`
+ : tab === "attributes"
+ ? `
${Object.entries(s)
+ .filter(([, v]) => v != null)
+ .map(
+ ([k, v]) =>
+ `- ${esc(k)}
- ${esc(typeof v === "object" ? JSON.stringify(v) : v)}
`,
+ )
+ .join("")}
`
+ : `
Input
${payload(details?.input)}
Output
${payload(details?.output)}${details?.error ? `
${esc(details.error)}
` : ""}
Execution
- Duration
- ${esc(duration(s.duration_us))}
- First output
- ${esc(duration(s.first_output_us))}
- Model
- ${esc(s.model || "—")}
- Token usage
- ${s.usage ? esc(JSON.stringify(s.usage)) : "Not reported"}
- Span
- ${esc(s.span_id)}
`
+ }
`;
+ }
+ async function select(t, s) {
+ selected = { turn: t, step: s };
+ details = null;
+ tab = "preview";
+ const gen = ++detailGen,
+ sessionVersion = sessionGen;
+ render();
+ inspector();
+ if (adapter.stepDetails) {
+ try {
+ const value = await adapter.stepDetails(
+ { ...scope(t), traceId: s.trace_id, spanId: s.span_id },
+ signal,
+ );
+ if (disposed || gen !== detailGen || sessionVersion !== sessionGen)
+ return;
+ details = value;
+ inspector();
+ } catch (e) {
+ if (!disposed && gen === detailGen) {
+ details = { error: reason(e) };
+ inspector();
+ }
+ }
+ }
+ }
+ async function click(e) {
+ const b = e.target.closest("button[data-tr]");
+ if (!b || !root.contains(b)) return;
+ const action = b.dataset.tr,
+ t = turns.find((t) => t.turn_id === b.dataset.turn);
+ if (action === "session") {
+ history = [];
+ await openSession(
+ results.find((r) => r.session_id === b.dataset.trSession),
+ );
+ } else if (action === "turn") {
+ const c = cache.get(t.turn_id);
+ if (c?.open) {
+ c.open = false;
+ render();
+ } else if (c?.steps) {
+ c.open = true;
+ render();
+ } else await loadTurn(t);
+ } else if (action === "more-steps") await loadTurn(t, true);
+ else if (action === "step") {
+ const s = cache
+ .get(t.turn_id)
+ ?.steps.find((s) => key(s) === b.dataset.step);
+ if (s) await select(t, s);
+ } else if (action === "child") {
+ const c = cache.get(t.turn_id).children[Number(b.dataset.child)];
+ history.push({
+ session,
+ turns,
+ nextTurns,
+ cache,
+ selected,
+ details,
+ tab,
+ mode,
+ parentTurn: t.label || "Turn · " + t.turn_id.slice(0, 14) + "…",
+ scroll: $(".tr-execution").scrollTop,
+ });
+ await openSession(
+ {
+ session_id: c.child_session_id,
+ turn_id: c.child_turn_id,
+ name: c.agent_id,
+ status: c.phase,
+ },
+ { session_id: c.child_session_id, turn_id: c.child_turn_id },
+ );
+ $(".tr-execution").scrollTop = 0;
+ } else if (action === "back") {
+ const h = history.pop();
+ if (h) {
+ sessionGen++;
+ detailGen++;
+ ({ session, turns, nextTurns, cache, selected, details, tab, mode } =
+ h);
+ pending = false;
+ render();
+ $(".tr-execution").scrollTop = h.scroll;
+ inspector();
+ }
+ } else if (action === "home") {
+ history = [];
+ if (results[0]) await openSession(results[0]);
+ } else if (["tree", "waterfall"].includes(action)) {
+ mode = action;
+ render();
+ } else if (["preview", "attributes", "json"].includes(action)) {
+ tab = action;
+ inspector();
+ } else if (action === "more-search") await search(true);
+ else if (action === "more-turns") await loadTurns(true);
+ else if (action === "refresh") {
+ if (session) await openSession(session, selected?.turn);
+ else await search();
+ } else if (action === "overview") onOverview?.();
+ }
+ root.addEventListener("click", click, { signal });
+ $(".tr-toolbar input").addEventListener(
+ "input",
+ () => {
+ clearTimeout(timer);
+ searchText = query();
+ searchGen++;
+ timer = setTimeout(() => search(), 250);
+ },
+ { signal },
+ );
+ if (initialRun) openSession(initialRun);
+ if (adapter.search) search();
+ else $(".tr-toolbar").hidden = true;
+ return {
+ refresh: () => (session ? openSession(session) : search()),
+ dispose() {
+ disposed = true;
+ searchGen++;
+ sessionGen++;
+ detailGen++;
+ clearTimeout(timer);
+ lifetime.abort();
+ root.replaceChildren();
+ root.classList.remove("ow-session-tracing");
+ },
+ };
+}
diff --git a/harness/service-ui/server.mjs b/harness/service-ui/server.mjs
index 92e6b2d9..e856024d 100644
--- a/harness/service-ui/server.mjs
+++ b/harness/service-ui/server.mjs
@@ -486,6 +486,8 @@ export async function start(config) {
"/index.html": ["index.html", "text/html"],
"/app.js": ["app.js", "text/javascript"],
"/compliance.js": ["compliance.js", "text/javascript"],
+ "/tracing.js": ["tracing.js", "text/javascript"],
+ "/tracing.css": ["tracing.css", "text/css"],
"/observability.js": ["observability.js", "text/javascript"],
"/observability-data.js": ["observability-data.js", "text/javascript"],
"/style.css": ["style.css", "text/css"],
diff --git a/harness/service-ui/test/observability-live.mjs b/harness/service-ui/test/observability-live.mjs
index a421a55e..80f87896 100644
--- a/harness/service-ui/test/observability-live.mjs
+++ b/harness/service-ui/test/observability-live.mjs
@@ -103,10 +103,33 @@ async function login(page, url, token) {
await page.goto(url + "/#observability");
await page.locator("#token").fill(token);
await page.getByRole("button", { name: "Sign in", exact: true }).click();
- await page.locator("#obs-run-search").waitFor();
+ await page.getByRole("searchbox", { name: "Search sessions" }).waitFor();
+ if (url === app.url) {
+ const search = page.getByRole("searchbox", { name: "Search sessions" });
+ await search.fill("s_alice");
+ await page
+ .locator(".tr-session")
+ .filter({ hasText: "s_alice" })
+ .first()
+ .click();
+ await page.waitForFunction(
+ () => document.querySelectorAll(".tr-turn").length === 2,
+ );
+ await page.locator(".tr-step").first().click();
+ await page.getByRole("button", { name: "Waterfall", exact: true }).click();
+ await page.locator(".tr-track").first().waitFor();
+ await capture(page, "session-tracing");
+ checks.push(
+ "actual service session search, two turns, step details and waterfall",
+ );
+ }
+ await page
+ .getByRole("button", { name: "Usage overview ↗", exact: true })
+ .click();
+ await page.locator("[id$='-obs-run-search']").waitFor();
}
async function choose(page, text) {
- const input = page.locator("#obs-run-search");
+ const input = page.locator("[id$='-obs-run-search']");
await input.fill(text);
const option = page
.locator(".obs-run-option")
@@ -165,12 +188,12 @@ try {
await login(page, app.url, process.env.OW_UI_USER);
await page.locator(".obs-stats").waitFor();
assert(
- (await page.locator("#obs-scope").innerText()).includes(
+ (await page.locator("[id$='-obs-scope']").innerText()).includes(
"25 recent authorized runs",
),
);
assert(!(await page.locator("#main").innerText()).includes("Beta Private"));
- assert.equal(await page.locator("#obs-health").count(), 0);
+ assert.equal(await page.locator("[id$='-obs-health']").count(), 0);
checks.push(
"real scoped recent-page summary, no foreign runs or process counters",
);
@@ -185,7 +208,7 @@ try {
.getByRole("button", { name: "Next 25 runs", exact: true })
.waitFor();
checks.push("summary page navigation preserves bounded selected-page scope");
- const input = page.locator("#obs-run-search");
+ const input = page.locator("[id$='-obs-run-search']");
await input.fill("Alpha % Game");
await page
.locator(".obs-run-option")
@@ -197,9 +220,9 @@ try {
await input.fill("No matching run 游");
await page.getByText("No matching runs.", { exact: true }).waitFor();
await input.fill("");
- await page.locator("#obs-search-more:not([hidden])").waitFor();
+ await page.locator("[id$='-obs-search-more']:not([hidden])").waitFor();
const firstCount = await page.locator(".obs-run-option").count();
- await page.locator("#obs-search-more").click();
+ await page.locator("[id$='-obs-search-more']").click();
await page.waitForFunction(
(n) => document.querySelectorAll(".obs-run-option").length > n,
firstCount,
@@ -346,11 +369,13 @@ try {
() =>
document.querySelectorAll(".obs-stats").length === 0 &&
/busy|Unable to/.test(
- document.querySelector("#obs-content").textContent,
+ document.querySelector("[id$='-obs-content']").textContent,
),
);
assert(
- !(await page.locator("#obs-content").innerText()).includes("12,500"),
+ !(await page.locator("[id$='-obs-content']").innerText()).includes(
+ "12,500",
+ ),
);
await page.unroute("**/api/v1/sessions/s_ui/observability/*/summary?**");
await page.getByRole("button", { name: "Refresh", exact: true }).click();
@@ -390,6 +415,9 @@ try {
await page.locator('[data-nav="activity"]').click();
await page.getByRole("heading", { name: "Sessions by day" }).waitFor();
await page.locator('[data-nav="observability"]').click();
+ await page
+ .getByRole("button", { name: "Usage overview ↗", exact: true })
+ .click();
await page.locator(".obs-stats").waitFor();
checks.push("Activity charts preserved; route return resets selection");
const emptyPage = await browser.newPage();
@@ -400,7 +428,7 @@ try {
{ exact: true },
)
.waitFor();
- await emptyPage.locator("#obs-run-search").fill("Deployment");
+ await emptyPage.locator("[id$='-obs-run-search']").fill("Deployment");
await emptyPage
.locator(".obs-run-option")
.filter({ hasText: "Deployment diagnosis" })
@@ -414,7 +442,7 @@ try {
const adminPage = await browser.newPage();
await login(adminPage, app.url, process.env.OW_UI_ADMIN);
await adminPage.locator(".obs-stats").waitFor();
- await adminPage.locator("#obs-health summary").click();
+ await adminPage.locator("[id$='-obs-health'] summary").click();
await adminPage
.getByText(
"Serving API instance only. Worker and other API counters are not aggregated here.",
@@ -442,7 +470,7 @@ try {
.getByRole("button", { name: "Refresh", exact: true })
.click();
await revokedPage.locator("#login:not([hidden])").waitFor();
- assert.equal(await revokedPage.locator("#obs-content").count(), 0);
+ assert.equal(await revokedPage.locator("[id$='-obs-content']").count(), 0);
await revokedPage.close();
checks.push("real service revocation signs out and erases metrics");
assert.equal(
diff --git a/harness/service-ui/test/observability.test.mjs b/harness/service-ui/test/observability.test.mjs
index 07aa1244..b1575c7c 100644
--- a/harness/service-ui/test/observability.test.mjs
+++ b/harness/service-ui/test/observability.test.mjs
@@ -111,3 +111,44 @@ test("timeline retains parallel intervals and unknown duration markers", () => {
}).some((s) => s.includes("4,096")),
);
});
+
+test("session tracing transport preserves authorized cursors and exact scope", async () => {
+ const { serviceTracingAdapter } = await import("../public/tracing.js");
+ const paths = [];
+ const controller = new AbortController();
+ const adapter = serviceTracingAdapter(async (path, signal) => {
+ paths.push(path);
+ assert.equal(signal, controller.signal);
+ return {
+ runs: [
+ { session_id: "s_one", turn_id: "t1" },
+ { session_id: "s_one_more", turn_id: "t2" },
+ ],
+ next_cursor: "bound_cursor",
+ };
+ });
+ const page = await adapter.turns(
+ { sessionId: "s_one", after: "prior" },
+ controller.signal,
+ );
+ assert.deepEqual(page.turns, [{ session_id: "s_one", turn_id: "t1" }]);
+ assert.equal(page.next_cursor, "bound_cursor");
+ const q = new URL(paths[0], "https://fixture").searchParams;
+ assert.equal(q.get("q"), "s_one");
+ assert.equal(q.get("after"), "prior");
+ await adapter.timeline(
+ { sessionId: "s_one", turnId: "t1", after: 100, through: 450 },
+ controller.signal,
+ );
+ const timeline = new URL(paths[1], "https://fixture");
+ assert.equal(
+ timeline.pathname,
+ "/v1/sessions/s_one/observability/t1/timeline",
+ );
+ assert.equal(timeline.searchParams.get("through"), "450");
+ await adapter.children(
+ { sessionId: "s_one", turnId: "t1" },
+ controller.signal,
+ );
+ assert.equal(paths[2], "/v1/sessions/s_one/observability/t1/children");
+});
diff --git a/harness/trace-viewer/README.md b/harness/trace-viewer/README.md
index 8ccb084d..5146213e 100644
--- a/harness/trace-viewer/README.md
+++ b/harness/trace-viewer/README.md
@@ -48,3 +48,64 @@ node test/browser.mjs http://127.0.0.1:59602 /absolute/path/to/playwright/index.
This checks keyboard tabs, exact child navigation, independent mounted instances,
HTML escaping, disposal, and the 1,000-record pagination limit.
+
+## Session tracing
+
+The optional session browser adds paged session search, expandable turn lists,
+recorded hierarchy, a per-turn waterfall and a step inspector. A child link opens
+that child's session in the same pane. The breadcrumb restores the parent view.
+The browser does not merge child tool calls into a parent's turn.
+
+```js
+import {mountSessionTracing, serviceTracingAdapter} from './src/index.js';
+import './src/tracing.css';
+
+const viewer = mountSessionTracing(document.querySelector('#traces'), {
+ adapter: serviceTracingAdapter(async (path, signal) => {
+ const response = await fetch('/api' + path, {signal});
+ if (!response.ok) throw Object.assign(new Error('Trace unavailable'), {
+ status: response.status,
+ });
+ return response.json();
+ }),
+});
+// On route change or logout: viewer.dispose().
+```
+
+Your backend must authorize every request. The management UI uses its existing
+session cookie and read-only proxy. Service session turns are paged through the
+existing authorized run directory and filtered by exact session ID. Search results
+are deduplicated into sessions; counts describe only loaded records. Turn headings
+use stable IDs rather than inventing chronological turn numbers for partial pages.
+
+For an embedded/managed SDK application, provide `adapter.turns` with
+`harness.observability.listTurns`, and the existing `timeline`, `summary` and
+`children` methods. Supply `initialRun` when your application already knows its
+session. Search is optional. Each mounted instance has independent state.
+
+Content stays unavailable unless the trusted application supplies `stepDetails`
+for an exact `(sessionId, turnId, traceId, spanId)`. That function must enforce
+ownership and capture/redaction policy before returning `{input, output}`. The
+viewer does not scrape raw journals or infer payloads by matching tool names.
+Provider-private reasoning and rejected output must not be supplied. Errors in
+this optional callback do not affect agent execution.
+
+Limits: 25 run rows per search page, 100 service run rows per turn-directory page,
+100 trace records per timeline page; 1,000 loaded search rows, turns and records
+per turn. Empty filtered pages can still have a next cursor. Waterfall bars use
+recorded timestamps, unknown durations remain unknown, and hierarchy depth is
+bounded. A session summary is not synthesized by adding overlapping child work.
+Evaluations and the combined team overview are outside this view.
+
+Replay selected local OpenShell qualification metadata for review:
+
+```sh
+node examples/serve-session.mjs /absolute/path/to/openshell-traces.json 59605
+node test/session-browser.mjs http://127.0.0.1:59605 /absolute/path/to/playwright/index.mjs /tmp/session-trace-screenshots
+```
+
+The replay server is loopback-only, GET-only, serves explicit assets and the selected
+fixture, and is not a production API. Browser tests distinguish recorded data from
+injected race/denial fixtures. The real API/browser qualification lives in
+`harness/service-ui/test/observability-live.mjs`, launched by the Rust
+`recording_queries` integration test with `OW_OBSERVABILITY_UI_BROWSER=1`.
diff --git a/harness/trace-viewer/examples/serve-session.mjs b/harness/trace-viewer/examples/serve-session.mjs
new file mode 100644
index 00000000..6073799b
--- /dev/null
+++ b/harness/trace-viewer/examples/serve-session.mjs
@@ -0,0 +1,111 @@
+// Replay explicitly selected, metadata-only qualification snapshots on loopback.
+// This is a review fixture, not a replacement for authenticated application APIs.
+import { createServer } from "node:http";
+import { readFile } from "node:fs/promises";
+const [file, port = "59605"] = process.argv.slice(2);
+if (!file)
+ throw Error(
+ "Usage: node examples/serve-session.mjs OPENSHELL_TRACE_JSON [PORT]",
+ );
+const data = JSON.parse(await readFile(file, "utf8"));
+const traces = [
+ {
+ timeline: data.timeline,
+ summary: data.summary,
+ children: data.children?.children || [],
+ },
+ ...(data.childTraces || []),
+];
+const records = traces.map((t) => ({ ...t.timeline.run, ...t.summary.run }));
+const assets = new Map([
+ ["/", new URL("session.html", import.meta.url)],
+ ...["tracing.js", "tracing.css", "observability-data.js"].map((f) => [
+ "/src/" + f,
+ new URL("../src/" + f, import.meta.url),
+ ]),
+]);
+const types = { js: "text/javascript", css: "text/css", html: "text/html" };
+createServer(async (req, res) => {
+ try {
+ const u = new URL(req.url, "http://loopback");
+ if (req.method !== "GET") {
+ res.writeHead(405);
+ res.end();
+ return;
+ }
+ res.setHeader("cache-control", "no-store");
+ if (assets.has(u.pathname)) {
+ res.setHeader(
+ "content-type",
+ types[u.pathname === "/" ? "html" : u.pathname.split(".").pop()],
+ );
+ res.end(await readFile(assets.get(u.pathname)));
+ return;
+ }
+ let value;
+ if (u.pathname === "/api/v1/observability/runs") {
+ const q = (u.searchParams.get("q") || "").toLowerCase();
+ const filtered = records.filter((r) =>
+ `${r.name} ${r.session_id} ${r.turn_id}`.toLowerCase().includes(q),
+ );
+ const offset = Number(u.searchParams.get("after") || 0),
+ limit = Number(u.searchParams.get("limit") || 25);
+ if (
+ !Number.isSafeInteger(offset) ||
+ offset < 0 ||
+ !Number.isInteger(limit) ||
+ limit < 1 ||
+ limit > 100
+ )
+ throw Error("Invalid page");
+ value = {
+ runs: filtered.slice(offset, offset + limit),
+ next_cursor:
+ offset + limit < filtered.length ? String(offset + limit) : null,
+ };
+ } else {
+ const m =
+ /^\/api\/v1\/sessions\/([^/]+)\/observability\/([^/]+)\/(timeline|summary|children)$/.exec(
+ u.pathname,
+ );
+ const t =
+ m &&
+ traces.find(
+ (t) =>
+ t.timeline.run.session_id === m[1] &&
+ t.timeline.run.turn_id === m[2],
+ );
+ if (!t) {
+ res.writeHead(404);
+ res.end();
+ return;
+ }
+ if (m[3] === "timeline") {
+ const after = Number(u.searchParams.get("after") || 0),
+ through = Number(
+ u.searchParams.get("through") || Number.MAX_SAFE_INTEGER,
+ );
+ const all = t.timeline.page.steps.filter(
+ (s) => s.cursor > after && s.cursor <= through,
+ );
+ value = {
+ ...t.timeline,
+ page: {
+ steps: all.slice(0, 100),
+ next: all.length > 100 ? all[99].cursor : null,
+ through: t.timeline.page.through,
+ },
+ };
+ } else
+ value =
+ m[3] === "children" ? { children: t.children || [] } : t.summary;
+ }
+ res.setHeader("content-type", "application/json");
+ res.end(JSON.stringify(value));
+ } catch {
+ res.writeHead(400);
+ res.end("Invalid fixture request");
+ }
+}).listen(Number(port), "127.0.0.1", () =>
+ console.log(`Session tracing: http://127.0.0.1:${port}/`),
+);
diff --git a/harness/trace-viewer/examples/serve.mjs b/harness/trace-viewer/examples/serve.mjs
index 49adec6b..a8c81fb0 100644
--- a/harness/trace-viewer/examples/serve.mjs
+++ b/harness/trace-viewer/examples/serve.mjs
@@ -3,7 +3,7 @@ import {createServer} from 'node:http';
import {readFile} from 'node:fs/promises';
const [evidence,port='59602']=process.argv.slice(2);
if(!evidence)throw Error('Usage: node examples/serve.mjs EVIDENCE_JSON [PORT]');
-const files=new Map([['/',new URL('index.html',import.meta.url)],...['index.js','observability.js','observability-data.js','style.css'].map(f=>[`/src/${f}`,new URL(`../src/${f}`,import.meta.url)])]);
+const files=new Map([['/',new URL('index.html',import.meta.url)],...['index.js','observability.js','observability-data.js','style.css','tracing.js','tracing.css'].map(f=>[`/src/${f}`,new URL(`../src/${f}`,import.meta.url)])]);
const types={js:'text/javascript',html:'text/html',css:'text/css',json:'application/json'};
createServer(async(req,res)=>{
try {const path=new URL(req.url,'http://local').pathname;const file=path==='/trace.json'?evidence:files.get(path);if(!file){res.writeHead(404);res.end();return;}const body=await readFile(file);res.writeHead(200,{'content-type':path==='/'?'text/html':types[path.split('.').pop()]??'text/plain','cache-control':'no-store'});res.end(body);}catch{res.writeHead(500);res.end('Unavailable');}
diff --git a/harness/trace-viewer/examples/session.html b/harness/trace-viewer/examples/session.html
new file mode 100644
index 00000000..4d6f6b08
--- /dev/null
+++ b/harness/trace-viewer/examples/session.html
@@ -0,0 +1,54 @@
+
+
+ OpenWorker · Session tracing
+
+ OpenWorkerSession tracingRecorded local OpenShell qualification · deterministic model
+
+
+
+
diff --git a/harness/trace-viewer/package.json b/harness/trace-viewer/package.json
index 785f5a03..bd398457 100644
--- a/harness/trace-viewer/package.json
+++ b/harness/trace-viewer/package.json
@@ -9,7 +9,8 @@
"types": "./src/index.d.ts",
"import": "./src/index.js"
},
- "./style.css": "./src/style.css"
+ "./style.css": "./src/style.css",
+ "./tracing.css": "./src/tracing.css"
},
"files": [
"src",
diff --git a/harness/trace-viewer/src/index.d.ts b/harness/trace-viewer/src/index.d.ts
index ef2b7af7..e413956b 100644
--- a/harness/trace-viewer/src/index.d.ts
+++ b/harness/trace-viewer/src/index.d.ts
@@ -1,10 +1,109 @@
export interface TraceAdapter {
- timeline(query: {sessionId:string;turnId:string;after?:number;through?:number;limit?:number}): Promise;
- summary(query: {sessionId:string;turnId:string;through?:number}): Promise;
- children?(query: {sessionId:string;turnId:string}): Promise;
- subtreeSummary?(query: {sessionId:string;turnId:string}): Promise;
- evaluations?(query: {sessionId:string;turnId:string;limit?:number}): Promise;
+ timeline(query: {
+ sessionId: string;
+ turnId: string;
+ after?: number;
+ through?: number;
+ limit?: number;
+ }): Promise;
+ summary(query: {
+ sessionId: string;
+ turnId: string;
+ through?: number;
+ }): Promise;
+ children?(query: { sessionId: string; turnId: string }): Promise;
+ subtreeSummary?(query: {
+ sessionId: string;
+ turnId: string;
+ }): Promise;
+ evaluations?(query: {
+ sessionId: string;
+ turnId: string;
+ limit?: number;
+ }): Promise;
}
-export interface ChildLink {child_session_id:string;child_turn_id:string|null;agent_id:string;phase:string}
-export function mountTurnTrace(root:HTMLElement, options:{adapter:TraceAdapter;sessionId:string;turnId:string;onChild?:(child:ChildLink)=>void}): {refresh():void;dispose():void};
-export function mountObservability(root:HTMLElement, options:{request:(path:string,signal?:AbortSignal)=>Promise;isAdmin?:boolean;initialRun?:{session_id:string;turn_id:string}|null;directory?:boolean;openSession?:boolean;children?:boolean}):()=>void;
+export interface ChildLink {
+ child_session_id: string;
+ child_turn_id: string | null;
+ agent_id: string;
+ phase: string;
+}
+export function mountTurnTrace(
+ root: HTMLElement,
+ options: {
+ adapter: TraceAdapter;
+ sessionId: string;
+ turnId: string;
+ onChild?: (child: ChildLink) => void;
+ },
+): { refresh(): void; dispose(): void };
+export function mountObservability(
+ root: HTMLElement,
+ options: {
+ request: (path: string, signal?: AbortSignal) => Promise;
+ isAdmin?: boolean;
+ initialRun?: { session_id: string; turn_id: string } | null;
+ directory?: boolean;
+ openSession?: boolean;
+ children?: boolean;
+ },
+): () => void;
+
+export interface SessionTracingAdapter {
+ search?(
+ query: { q?: string; after?: string },
+ signal?: AbortSignal,
+ ): Promise<{ runs: TraceRun[]; next_cursor: string | null }>;
+ turns(
+ query: { sessionId: string; after?: string | number },
+ signal?: AbortSignal,
+ ): Promise<{ turns: TraceRun[]; next_cursor: string | number | null }>;
+ timeline(
+ query: {
+ sessionId: string;
+ turnId: string;
+ after?: number;
+ through?: number;
+ limit?: number;
+ },
+ signal?: AbortSignal,
+ ): Promise;
+ summary(
+ query: { sessionId: string; turnId: string },
+ signal?: AbortSignal,
+ ): Promise;
+ children?(
+ query: { sessionId: string; turnId: string },
+ signal?: AbortSignal,
+ ): Promise<{ children: any[] }>;
+ /** Backend-authorized, explicitly captured payloads, correlated to this exact span. */
+ stepDetails?(
+ query: {
+ sessionId: string;
+ turnId: string;
+ traceId: string;
+ spanId: string;
+ },
+ signal?: AbortSignal,
+ ): Promise<{ input?: unknown; output?: unknown }>;
+}
+export interface TraceRun {
+ session_id: string;
+ turn_id: string;
+ name?: string;
+ agent?: string;
+ status?: string;
+ created_ms?: number;
+ label?: string;
+}
+export function mountSessionTracing(
+ root: HTMLElement,
+ options: {
+ adapter: SessionTracingAdapter;
+ initialRun?: TraceRun;
+ onOverview?: () => void;
+ },
+): { refresh(): Promise; dispose(): void };
+export function serviceTracingAdapter(
+ request: (path: string, signal?: AbortSignal) => Promise,
+): SessionTracingAdapter;
diff --git a/harness/trace-viewer/src/index.js b/harness/trace-viewer/src/index.js
index 968d61f2..e678d5f2 100644
--- a/harness/trace-viewer/src/index.js
+++ b/harness/trace-viewer/src/index.js
@@ -1,3 +1,4 @@
+export {mountSessionTracing, serviceTracingAdapter} from './tracing.js';
import {mountObservability} from './observability.js';
import {count, measurement} from './observability-data.js';
export {mountObservability};
diff --git a/harness/trace-viewer/src/tracing.css b/harness/trace-viewer/src/tracing.css
new file mode 100644
index 00000000..eaa15dce
--- /dev/null
+++ b/harness/trace-viewer/src/tracing.css
@@ -0,0 +1,522 @@
+/* Optional, scoped session tracing styles. No runtime dependencies or global reset. */
+.ow-session-tracing {
+ font:
+ 13px/1.5 -apple-system,
+ BlinkMacSystemFont,
+ "Segoe UI",
+ sans-serif;
+ color: #29313d;
+ max-width: 1760px;
+ margin: auto;
+ --tr-border: #e2e7ee;
+ --tr-muted: #8a96a6;
+ background: #fafbfd;
+ padding: 24px;
+}
+.ow-session-tracing * {
+ box-sizing: border-box;
+}
+.ow-session-tracing [hidden] {
+ display: none !important;
+}
+.ow-session-tracing button,
+.ow-session-tracing input {
+ font: inherit;
+}
+.ow-session-tracing button {
+ cursor: pointer;
+ color: inherit;
+ background: white;
+ border: 1px solid var(--tr-border);
+ border-radius: 6px;
+ padding: 6px 10px;
+}
+.ow-session-tracing button:hover {
+ background: #f1f5fa;
+}
+.ow-session-tracing button:focus-visible,
+.ow-session-tracing input:focus-visible {
+ outline: 2px solid #6a8cbb;
+ outline-offset: 2px;
+}
+.ow-session-tracing svg {
+ width: 14px;
+ height: 14px;
+ flex-shrink: 0;
+}
+.ow-session-tracing h1 {
+ font-size: 27px;
+ letter-spacing: -0.9px;
+ margin: 0;
+}
+.ow-session-tracing h2 {
+ font-size: 20px;
+ letter-spacing: -0.55px;
+ margin: 12px 0;
+}
+.ow-session-tracing p {
+ margin: 5px 0;
+ color: #8a96a6;
+}
+.tr-heading,
+.tr-heading > div:last-child {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 8px;
+}
+.tr-heading {
+ margin-bottom: 22px;
+}
+.tr-heading > div:first-child {
+ display: block;
+}
+.tr-toolbar {
+ display: flex;
+ align-items: center;
+ gap: 18px;
+ margin-bottom: 18px;
+}
+.tr-toolbar input {
+ background: #fff;
+ border: 1px solid var(--tr-border);
+ border-radius: 7px;
+ padding: 10px 14px;
+ flex: 1;
+ min-width: 160px;
+ color: inherit;
+}
+.tr-directory-state {
+ font-size: 10px;
+ color: var(--tr-muted);
+}
+.tr-workbench {
+ display: grid;
+ grid-template-columns: 230px minmax(360px, 1.15fr) minmax(300px, 1fr);
+ height: calc(100vh - 240px);
+ min-height: 610px;
+ border: 1px solid #dde4ed;
+ border-radius: 11px;
+ background: #fff;
+ overflow: hidden;
+ box-shadow: 0 4px 18px #243a5510;
+}
+.tr-workbench > aside,
+.tr-workbench > section {
+ min-width: 0;
+ overflow: auto;
+}
+.tr-workbench > section {
+ border-left: 1px solid var(--tr-border);
+}
+.tr-directory {
+ background: #f8fafd;
+}
+.tr-panehead {
+ position: sticky;
+ top: 0;
+ z-index: 2;
+ background: #fff;
+ height: 46px;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 0 18px;
+ border-bottom: 1px solid #edf0f4;
+ font-size: 9px;
+ letter-spacing: 1px;
+ text-transform: uppercase;
+ color: #8b97a7;
+}
+.tr-directory .tr-panehead {
+ background: #f8fafd;
+}
+.tr-results {
+ padding: 9px;
+}
+.ow-session-tracing .tr-session {
+ width: 100%;
+ text-align: left;
+ background: transparent;
+ padding: 13px 11px;
+ margin: 0 0 4px;
+ border: 1px solid transparent;
+ border-radius: 7px;
+}
+.ow-session-tracing .selected {
+ background: #edf3fa !important;
+ outline: 1px solid #dce6f2;
+ outline-offset: -1px;
+}
+.ow-session-tracing .tr-session.selected {
+ background: #fff !important;
+ border: 1px solid #dce5f1;
+ outline: 0;
+ box-shadow: 0 1px 5px #243a550a;
+}
+.tr-session strong {
+ display: block;
+ overflow-wrap: anywhere;
+ font-size: 12px;
+ font-weight: 600;
+ margin-bottom: 8px;
+}
+.tr-session > span {
+ display: flex;
+ justify-content: space-between;
+ gap: 8px;
+ font-size: 10px;
+ color: #8692a3;
+}
+.tr-status {
+ font-style: normal;
+}
+.tr-session code {
+ font-size: 9px;
+ color: #9aa6b6;
+ display: block;
+ overflow: hidden;
+ text-overflow: ellipsis;
+ margin-top: 7px;
+}
+.tr-directory-footer {
+ padding: 5px 18px;
+}
+.tr-directory-footer button {
+ font-size: 11px;
+}
+.tr-segment {
+ display: flex;
+ gap: 2px;
+ padding: 3px;
+ background: #f0f3f8;
+ border-radius: 6px;
+}
+.ow-session-tracing .tr-segment button {
+ border: 0;
+ background: none;
+ padding: 4px 8px;
+ font-size: 10px;
+ letter-spacing: 0;
+ text-transform: none;
+}
+.ow-session-tracing .tr-segment button[aria-pressed="true"] {
+ background: #fff;
+ box-shadow: 0 1px 4px #243a5515;
+}
+.tr-breadcrumb {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 7px;
+ padding: 16px 20px 0;
+ color: #9da7b5;
+ font-size: 10px;
+}
+.ow-session-tracing .tr-breadcrumb button {
+ border: 0;
+ background: none;
+ padding: 0;
+ color: #6f88aa;
+ font-size: 10px;
+}
+.tr-breadcrumb strong {
+ font-weight: 500;
+ color: #67758a;
+}
+.tr-context > h2 {
+ padding: 0 20px;
+}
+.tr-chips {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 6px;
+ padding: 0 20px 18px;
+ border-bottom: 1px solid #edf0f4;
+ align-items: center;
+}
+.tr-chips span {
+ font-size: 10px;
+ background: #f0f4f9;
+ border-radius: 4px;
+ padding: 4px 7px;
+ color: #708197;
+}
+.tr-chips code {
+ font-size: 9px;
+ color: #99a4b4;
+ overflow-wrap: anywhere;
+}
+.tr-turns {
+ padding: 12px 14px 24px;
+}
+.ow-session-tracing .tr-turn-heading {
+ display: flex;
+ align-items: center;
+ gap: 9px;
+ width: 100%;
+ text-align: left;
+ background: none;
+ border: 0;
+ padding: 13px 4px;
+}
+.tr-turn-heading b {
+ font-size: 11px;
+ font-weight: 600;
+ overflow-wrap: anywhere;
+}
+.tr-turn-heading small {
+ display: block;
+ font-size: 10px;
+ color: #9aa5b4;
+ margin-top: 3px;
+}
+.tr-chevron {
+ color: #98a6b8;
+ transition: transform 0.15s;
+}
+.tr-chevron.open {
+ transform: rotate(90deg);
+}
+.tr-calls {
+ padding: 4px 0 15px 24px;
+}
+.tr-turn-metrics {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 12px;
+ padding: 0 7px 12px;
+ font-size: 9px;
+ color: #99a5b5;
+}
+.ow-session-tracing .tr-step {
+ width: 100%;
+ min-height: 35px;
+ display: flex;
+ align-items: center;
+ gap: 8px;
+ border: 0;
+ border-radius: 5px;
+ background: none;
+ padding: 7px 6px;
+ font-size: 11px;
+ text-align: left;
+}
+.tr-step-name {
+ display: flex;
+ align-items: center;
+ gap: 7px;
+ flex: 1;
+ min-width: 0;
+ padding-left: calc(var(--indent) * 12px);
+}
+.tr-step-name > span {
+ overflow: hidden;
+ text-overflow: ellipsis;
+ white-space: nowrap;
+}
+.tr-step svg {
+ padding: 2px;
+ width: 18px;
+ height: 18px;
+ border-radius: 5px;
+ background: #edf2f9;
+ color: #7b98bc;
+}
+.tr-model svg {
+ background: #f1edf8;
+ color: #9b89bc;
+}
+.tr-tool svg {
+ background: #edf4ef;
+ color: #7d9e8a;
+}
+.tr-duration {
+ font-size: 10px;
+ color: #98a4b5;
+ flex-shrink: 0;
+}
+.tr-outcome {
+ font-size: 9px;
+ color: #8ba393;
+ min-width: 25px;
+ text-align: right;
+}
+.tr-axis {
+ display: flex;
+ justify-content: space-between;
+ margin-left: 165px;
+ font-size: 9px;
+ color: #9aa6b7;
+ padding: 5px 0 12px;
+}
+.tr-waterfall .tr-step-name {
+ flex: 0 0 165px;
+ width: 165px;
+ font-size: 10px;
+}
+.tr-track {
+ position: relative;
+ height: 22px;
+ flex: 1;
+ background: repeating-linear-gradient(
+ 90deg,
+ transparent,
+ transparent calc(25% - 1px),
+ #edf1f6 calc(25% - 1px),
+ #edf1f6 25%
+ );
+}
+.tr-track i {
+ position: absolute;
+ top: 5px;
+ height: 12px;
+ min-width: 3px;
+ border-radius: 3px;
+ background: #99b0cc;
+}
+.tr-model .tr-track i {
+ background: #b0a1ce;
+}
+.tr-tool .tr-track i {
+ background: #91ad9c;
+}
+.tr-track i.tr-failed {
+ background: #c08f86;
+}
+.tr-track small {
+ font-size: 8px;
+ color: #99a4b5;
+}
+.tr-children {
+ padding: 8px 4px;
+}
+.tr-children > div {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 10px;
+ margin: 7px 0;
+}
+.tr-children span {
+ display: flex;
+ align-items: center;
+ gap: 6px;
+ font-size: 11px;
+}
+.tr-children svg {
+ color: #8aa2c2;
+}
+.tr-children small {
+ font-size: 9px;
+ color: #99a5b4;
+}
+.tr-children button {
+ font-size: 10px;
+ color: #718caf;
+ background: #f6f9fc;
+}
+.tr-note,
+.tr-error {
+ font-size: 11px;
+ line-height: 1.7;
+ padding: 10px;
+}
+.ow-session-tracing .tr-error {
+ color: #b47c73;
+}
+.tr-detail-title {
+ padding: 23px 22px 0;
+ background: linear-gradient(145deg, #fff, #f9fbff);
+}
+.tr-detail-title > small {
+ font-size: 9px;
+ color: #8b99ad;
+ letter-spacing: 0.8px;
+}
+.tr-detail-title .tr-chips {
+ padding-left: 0;
+ padding-right: 0;
+ border: 0;
+}
+.tr-tabs {
+ display: flex;
+ gap: 22px;
+ padding: 0 22px;
+ border-bottom: 1px solid var(--tr-border);
+}
+.ow-session-tracing .tr-tabs button {
+ background: none;
+ border: 0;
+ border-radius: 0;
+ padding: 12px 0;
+ font-size: 11px;
+ color: #99a3b2;
+}
+.ow-session-tracing .tr-tabs button[aria-pressed="true"] {
+ border-bottom: 2px solid #6b8aad;
+ color: #4c6c95;
+}
+.tr-detail-body {
+ padding: 22px;
+}
+.tr-detail-body h3 {
+ font-size: 11px;
+ margin: 0 0 12px;
+ font-weight: 600;
+}
+.tr-empty,
+.tr-detail-body pre {
+ font-size: 11px;
+ line-height: 1.8;
+ background: #f8fafd;
+ padding: 15px;
+ border: 1px solid #e6ecf4;
+ border-radius: 6px;
+ margin: 0 0 24px;
+ color: #8998ad;
+}
+.tr-detail-body pre {
+ font:
+ 10px/1.9 ui-monospace,
+ SFMono-Regular,
+ monospace;
+ white-space: pre-wrap;
+ overflow-wrap: anywhere;
+ color: #557394;
+}
+.tr-detail-body dl {
+ display: grid;
+ grid-template-columns: 90px 1fr;
+ gap: 12px;
+ font-size: 10px;
+}
+.tr-detail-body dt {
+ color: #99a5b4;
+}
+.tr-detail-body dd {
+ margin: 0;
+ color: #72849b;
+ overflow-wrap: anywhere;
+}
+@media (max-width: 1100px) {
+ .tr-workbench {
+ grid-template-columns: 190px minmax(300px, 1fr);
+ height: auto;
+ }
+ .tr-inspector {
+ grid-column: 1/-1;
+ min-height: 300px;
+ border-top: 1px solid var(--tr-border);
+ }
+ .tr-execution {
+ min-height: 500px;
+ }
+ .tr-toolbar {
+ flex-wrap: wrap;
+ }
+}
+@media (prefers-reduced-motion: reduce) {
+ .tr-chevron {
+ transition: none;
+ }
+}
diff --git a/harness/trace-viewer/src/tracing.js b/harness/trace-viewer/src/tracing.js
new file mode 100644
index 00000000..82008d6b
--- /dev/null
+++ b/harness/trace-viewer/src/tracing.js
@@ -0,0 +1,540 @@
+import { esc, duration, count } from "./observability-data.js";
+const id = (s) => encodeURIComponent(s);
+const path = (q) =>
+ `/v1/sessions/${id(q.sessionId)}/observability/${id(q.turnId)}`;
+/** Transport stays in the trusted application; the component never stores credentials. */
+export function serviceTracingAdapter(request) {
+ const get = (p, signal) => request(p, signal);
+ return {
+ search: async (q, signal) =>
+ get(
+ "/v1/observability/runs?" +
+ new URLSearchParams({
+ q: q.q || "",
+ limit: "25",
+ ...(q.after ? { after: q.after } : {}),
+ }),
+ signal,
+ ),
+ // The existing run directory is authorized and cursor-bound. Exact matching is
+ // essential: its text search can also match another session's partial ID.
+ turns: async (q, signal) => {
+ const p = await get(
+ "/v1/observability/runs?" +
+ new URLSearchParams({
+ q: q.sessionId,
+ limit: "100",
+ ...(q.after ? { after: q.after } : {}),
+ }),
+ signal,
+ );
+ return {
+ turns: p.runs.filter((r) => r.session_id === q.sessionId),
+ next_cursor: p.next_cursor,
+ };
+ },
+ timeline: (q, signal) =>
+ get(
+ path(q) +
+ "/timeline?" +
+ new URLSearchParams({
+ limit: "100",
+ after: String(q.after ?? 0),
+ ...(q.through != null ? { through: String(q.through) } : {}),
+ }),
+ signal,
+ ),
+ summary: (q, signal) => get(path(q) + "/summary", signal),
+ children: (q, signal) => get(path(q) + "/children", signal),
+ };
+}
+const svg = (kind) => {
+ const shapes = {
+ model: '',
+ tool: '',
+ agent:
+ '',
+ chevron: '',
+ };
+ return ``;
+};
+const kind = (s) =>
+ s.operation.startsWith("model.")
+ ? "model"
+ : s.operation.startsWith("tool.")
+ ? "tool"
+ : "agent";
+const name = (s) =>
+ (s.tool && s.tool.replaceAll("__", " · ").replaceAll("_", " ")) ||
+ (s.model && s.operation === "model.attempt" && `Model · ${s.model}`) ||
+ {
+ "agent.execute": "Execution segment",
+ "model.requested": "Request started",
+ "policy.review": "Policy check",
+ "approval.wait": "Approval wait",
+ "question.wait": "Question wait",
+ "environment.operation": "Prepare environment",
+ }[s.operation] ||
+ s.operation;
+const key = (s) => s.trace_id + "/" + s.span_id;
+const reason = (e) =>
+ e?.status === 403
+ ? "You cannot read this session."
+ : e?.status === 404
+ ? "This recording is no longer available."
+ : e?.status === 503
+ ? "Recording is disabled or unavailable."
+ : e?.status === 429
+ ? "Recording readers are busy. Try Refresh."
+ : "Unable to load recording. Try Refresh.";
+const button = (action, text, extra = "") =>
+ ``;
+const scope = (r) => ({ sessionId: r.session_id, turnId: r.turn_id });
+/** Session-oriented trace browser. No evaluations or combined team view. */
+export function mountSessionTracing(
+ root,
+ { adapter, initialRun = null, onOverview } = {},
+) {
+ if (!adapter) throw Error("A tracing adapter is required");
+ const lifetime = new AbortController(),
+ signal = lifetime.signal;
+ let disposed = false,
+ searchGen = 0,
+ sessionGen = 0,
+ detailGen = 0,
+ timer;
+ let results = [],
+ nextSearch = null,
+ searchText = "",
+ session = null,
+ turns = [],
+ nextTurns = null,
+ history = [],
+ cache = new Map(),
+ selected = null,
+ details = null,
+ mode = "tree",
+ tab = "preview",
+ pending = false;
+ root.classList.add("ow-session-tracing");
+ root.innerHTML = `Tracing
Follow a session, one turn at a time.
${onOverview ? button("overview", "Usage overview ↗") : ""}${button("refresh", "Refresh")}
Execution${button("tree", "Tree", 'aria-pressed="true"')}${button("waterfall", "Waterfall", 'aria-pressed="false"')}
`;
+ const $ = (s) => root.querySelector(s);
+ const query = () => $(".tr-toolbar input").value;
+ function sessions() {
+ const map = new Map();
+ for (const r of results)
+ if (!map.has(r.session_id)) map.set(r.session_id, r);
+ return [...map.values()];
+ }
+ function directory() {
+ const rs = sessions();
+ $(".tr-results").innerHTML =
+ rs
+ .map(
+ (r) =>
+ ``,
+ )
+ .join("") ||
+ 'No matching sessions on this page.
';
+ $(".tr-directory-footer").innerHTML = nextSearch
+ ? button("more-search", "More sessions")
+ : "";
+ }
+ async function search(more = false) {
+ const gen = ++searchGen,
+ q = searchText;
+ $(".tr-directory-state").textContent = "Searching…";
+ try {
+ const page = await adapter.search(
+ { q, after: more ? nextSearch : undefined },
+ signal,
+ );
+ if (disposed || gen !== searchGen) return;
+ results = (more ? [...results, ...page.runs] : page.runs).slice(0, 1000);
+ nextSearch = results.length < 1000 ? page.next_cursor : null;
+ $(".tr-directory-state").textContent =
+ `${sessions().length} sessions loaded${nextSearch ? " · more available" : ""}`;
+ directory();
+ if (!session && results.length) await openSession(results[0]);
+ } catch (e) {
+ if (disposed || gen !== searchGen) return;
+ results = [];
+ nextSearch = null;
+ directory();
+ $(".tr-directory-state").textContent = reason(e);
+ }
+ }
+ function crumb() {
+ return `${button("home", "Sessions")}${history.length ? `›${button("back", esc(history.at(-1).session.name || history.at(-1).session.agent || "Parent agent"))}›${button("back", esc(history.at(-1).parentTurn))}` : ""}›${esc(session?.name || session?.agent || "Session")}
`;
+ }
+ function context() {
+ if (!session) return;
+ $(".tr-context").innerHTML =
+ crumb() +
+ `${esc(session.name || session.agent || session.session_id)}
${esc(session.status || "Unknown")}${turns.length} ${turns.length === 1 ? "turn" : "turns"} loaded${nextTurns ? " · more available" : ""}${esc(session.session_id)}
`;
+ }
+ const visibleSteps = (c) =>
+ (c.steps || []).filter((s) => s.operation !== "model.requested");
+ function body(t, c) {
+ if (c.error) return `${esc(c.error)}
`;
+ if (c.loading)
+ return 'Loading recording…
';
+ const ss = visibleSteps(c),
+ known = ss.filter(
+ (s) => Number.isFinite(s.started_ms) && Number.isFinite(s.duration_us),
+ ),
+ start = known.length ? Math.min(...known.map((s) => s.started_ms)) : 0,
+ end = known.length
+ ? Math.max(...known.map((s) => s.started_ms + s.duration_us / 1000))
+ : 1,
+ range = Math.max(1, end - start),
+ summary = c.summary;
+ const total = summary?.usage;
+ const tokens =
+ total?.input?.total != null && total?.output?.total != null
+ ? `${count(total.input.total + total.output.total)}${total.input.unknown || total.output.unknown ? " + unknown" : ""}`
+ : "Not reported";
+ let html = `${esc(duration(summary?.wall_elapsed_us))} elapsed${tokens} tokens${ss.length} steps loaded
`;
+ if (mode === "waterfall")
+ html += `${[0, 1, 2, 3, 4].map((i) => `${i ? esc(duration(((range * i) / 4) * 1000)) : "0 s"}`).join("")}
`;
+ // Indentation follows recorded parent IDs only. Missing parents are roots;
+ // cycles are bounded and labelled, never silently invented.
+ const map = new Map(ss.map((s) => [key(s), s]));
+ const depth = (s) => {
+ let n = 0,
+ p = s,
+ seen = new Set([key(s)]);
+ while (n < 6) {
+ const parent = map.get(p.parent_trace_id + "/" + p.parent_span_id);
+ if (!parent || seen.has(key(parent))) break;
+ seen.add(key(parent));
+ n++;
+ p = parent;
+ }
+ return n;
+ };
+ for (const s of ss) {
+ const d = depth(s),
+ k = kind(s),
+ timing =
+ Number.isFinite(s.started_ms) && Number.isFinite(s.duration_us);
+ html += ``;
+ }
+ if (c.next != null)
+ html +=
+ c.steps.length < 1000
+ ? button(
+ "more-steps",
+ "Load more steps",
+ `data-turn="${esc(t.turn_id)}"`,
+ )
+ : 'Showing 1,000 steps. Narrow the query through the SDK to inspect further records.
';
+ if (!ss.length)
+ html += 'No recorded steps for this turn.
';
+ html += `${(c.children || []).map((child, i) => `
${svg("agent")}${esc(child.agent_id)} ${esc(child.phase)}${child.child_turn_id ? button("child", `Open session ↗`, `data-turn="${esc(t.turn_id)}" data-child="${i}" aria-label="Open ${esc(child.agent_id)} session"`) : "Initial turn unavailable"}
`).join("")}
`;
+ if (c.childError)
+ html +=
+ 'Child links are unavailable for this turn.
';
+ const cov = summary?.coverage;
+ if (
+ cov?.scan_truncated ||
+ cov?.hierarchy_incomplete ||
+ cov?.unknown_outcome_steps ||
+ cov?.unknown_timing_steps
+ )
+ html +=
+ 'Partial coverage: some timing, hierarchy or outcomes are incomplete. Recording is best effort.
';
+ return html;
+ }
+ function render() {
+ context();
+ directory();
+ $(".tr-turns").innerHTML =
+ turns
+ .map((t) => {
+ const c = cache.get(t.turn_id);
+ return `${c?.open ? `${body(t, c)}
` : ""}`;
+ })
+ .join("") +
+ (nextTurns != null ? button("more-turns", "Load more turns") : "") +
+ (pending ? 'Loading turns…
' : "");
+ root
+ .querySelectorAll(".tr-segment button")
+ .forEach((b) =>
+ b.setAttribute("aria-pressed", String(b.dataset.tr === mode)),
+ );
+ for (const el of root.querySelectorAll("[data-depth]"))
+ el.style.setProperty("--indent", el.dataset.depth);
+ for (const el of root.querySelectorAll("[data-left]")) {
+ el.style.left = el.dataset.left + "%";
+ el.style.width = el.dataset.width + "%";
+ }
+ }
+ async function loadTurns(more = false, target) {
+ if (more && pending) return;
+ const gen = sessionGen,
+ sid = session.session_id;
+ pending = true;
+ render();
+ try {
+ const p = await adapter.turns(
+ { sessionId: sid, after: more ? nextTurns : undefined },
+ signal,
+ );
+ if (disposed || gen !== sessionGen) return;
+ const incoming = p.turns.filter((t) => t.session_id === sid);
+ if (!more && incoming[0])
+ session = { ...session, status: incoming[0].status };
+ const unique = new Map(
+ (more ? [...turns, ...incoming] : incoming).map((t) => [t.turn_id, t]),
+ );
+ turns = [...unique.values()];
+ turns = turns.slice(0, 1000);
+ nextTurns = turns.length < 1000 ? p.next_cursor : null;
+ pending = false;
+ if (target && !turns.some((t) => t.turn_id === target.turn_id))
+ turns.unshift({ ...target, session_id: sid });
+ render();
+ if (!more && turns.length) {
+ const t = turns.find((t) => t.turn_id === target?.turn_id) || turns[0];
+ await loadTurn(t);
+ }
+ } catch (e) {
+ if (disposed || gen !== sessionGen) return;
+ pending = false;
+ turns = [];
+ nextTurns = null;
+ render();
+ $(".tr-turns").innerHTML =
+ `${esc(reason(e))}
`;
+ }
+ }
+ async function openSession(r, target) {
+ sessionGen++;
+ detailGen++;
+ session = r;
+ turns = [];
+ cache = new Map();
+ selected = null;
+ details = null;
+ nextTurns = null;
+ $(".tr-details").innerHTML =
+ 'Select a model or tool call.
';
+ await loadTurns(false, target || r);
+ }
+ async function loadTurn(t, more = false) {
+ const gen = sessionGen,
+ old = cache.get(t.turn_id) || {},
+ q = scope(t);
+ const c = { ...old, open: true, loading: true };
+ cache.set(t.turn_id, c);
+ render();
+ try {
+ const [page, s, child] = await Promise.all([
+ adapter.timeline(
+ {
+ ...q,
+ after: more ? old.next : undefined,
+ through: more ? old.through : undefined,
+ limit: 100,
+ },
+ signal,
+ ),
+ more
+ ? Promise.resolve({ summary: old.summary })
+ : adapter.summary(q, signal),
+ more
+ ? Promise.resolve({ children: old.children })
+ : adapter.children
+ ? adapter
+ .children(q, signal)
+ .catch(() => ({ children: [], unavailable: true }))
+ : Promise.resolve({ children: [] }),
+ ]);
+ if (disposed || gen !== sessionGen || cache.get(t.turn_id) !== c) return;
+ const steps = [
+ ...(more ? old.steps || [] : []),
+ ...page.page.steps.map((x) => x.step),
+ ];
+ Object.assign(c, {
+ steps: steps.slice(0, 1000),
+ next: page.page.next,
+ through: page.page.through,
+ summary: s.summary,
+ children: child.children,
+ childError: child.unavailable,
+ loading: false,
+ error: null,
+ });
+ render();
+ } catch (e) {
+ if (disposed || gen !== sessionGen) return;
+ Object.assign(c, {
+ loading: false,
+ error: reason(e),
+ steps: [],
+ children: [],
+ });
+ if (selected?.turn.turn_id === t.turn_id) {
+ selected = null;
+ details = null;
+ detailGen++;
+ $(".tr-details").innerHTML =
+ 'Selected recording is unavailable.
';
+ }
+ render();
+ }
+ }
+ function inspector() {
+ const s = selected?.step;
+ if (!s) return;
+ const payload = (v) =>
+ v === undefined || v === null
+ ? 'Content was not captured or is not available to this viewer.
'
+ : `${esc(typeof v === "string" ? v : JSON.stringify(v, null, 2))}`;
+ $(".tr-details").innerHTML =
+ `${esc(s.operation)}${esc(name(s))}
${esc(s.outcome)}${esc(duration(s.duration_us))}
${["preview", "attributes", "json"].map((x) => button(x, x === "json" ? "JSON" : x[0].toUpperCase() + x.slice(1), `aria-pressed="${tab === x}"`)).join("")}
${
+ tab === "json"
+ ? `
${esc(JSON.stringify(s, null, 2))}`
+ : tab === "attributes"
+ ? `
${Object.entries(s)
+ .filter(([, v]) => v != null)
+ .map(
+ ([k, v]) =>
+ `- ${esc(k)}
- ${esc(typeof v === "object" ? JSON.stringify(v) : v)}
`,
+ )
+ .join("")}
`
+ : `
Input
${payload(details?.input)}
Output
${payload(details?.output)}${details?.error ? `
${esc(details.error)}
` : ""}
Execution
- Duration
- ${esc(duration(s.duration_us))}
- First output
- ${esc(duration(s.first_output_us))}
- Model
- ${esc(s.model || "—")}
- Token usage
- ${s.usage ? esc(JSON.stringify(s.usage)) : "Not reported"}
- Span
- ${esc(s.span_id)}
`
+ }
`;
+ }
+ async function select(t, s) {
+ selected = { turn: t, step: s };
+ details = null;
+ tab = "preview";
+ const gen = ++detailGen,
+ sessionVersion = sessionGen;
+ render();
+ inspector();
+ if (adapter.stepDetails) {
+ try {
+ const value = await adapter.stepDetails(
+ { ...scope(t), traceId: s.trace_id, spanId: s.span_id },
+ signal,
+ );
+ if (disposed || gen !== detailGen || sessionVersion !== sessionGen)
+ return;
+ details = value;
+ inspector();
+ } catch (e) {
+ if (!disposed && gen === detailGen) {
+ details = { error: reason(e) };
+ inspector();
+ }
+ }
+ }
+ }
+ async function click(e) {
+ const b = e.target.closest("button[data-tr]");
+ if (!b || !root.contains(b)) return;
+ const action = b.dataset.tr,
+ t = turns.find((t) => t.turn_id === b.dataset.turn);
+ if (action === "session") {
+ history = [];
+ await openSession(
+ results.find((r) => r.session_id === b.dataset.trSession),
+ );
+ } else if (action === "turn") {
+ const c = cache.get(t.turn_id);
+ if (c?.open) {
+ c.open = false;
+ render();
+ } else if (c?.steps) {
+ c.open = true;
+ render();
+ } else await loadTurn(t);
+ } else if (action === "more-steps") await loadTurn(t, true);
+ else if (action === "step") {
+ const s = cache
+ .get(t.turn_id)
+ ?.steps.find((s) => key(s) === b.dataset.step);
+ if (s) await select(t, s);
+ } else if (action === "child") {
+ const c = cache.get(t.turn_id).children[Number(b.dataset.child)];
+ history.push({
+ session,
+ turns,
+ nextTurns,
+ cache,
+ selected,
+ details,
+ tab,
+ mode,
+ parentTurn: t.label || "Turn · " + t.turn_id.slice(0, 14) + "…",
+ scroll: $(".tr-execution").scrollTop,
+ });
+ await openSession(
+ {
+ session_id: c.child_session_id,
+ turn_id: c.child_turn_id,
+ name: c.agent_id,
+ status: c.phase,
+ },
+ { session_id: c.child_session_id, turn_id: c.child_turn_id },
+ );
+ $(".tr-execution").scrollTop = 0;
+ } else if (action === "back") {
+ const h = history.pop();
+ if (h) {
+ sessionGen++;
+ detailGen++;
+ ({ session, turns, nextTurns, cache, selected, details, tab, mode } =
+ h);
+ pending = false;
+ render();
+ $(".tr-execution").scrollTop = h.scroll;
+ inspector();
+ }
+ } else if (action === "home") {
+ history = [];
+ if (results[0]) await openSession(results[0]);
+ } else if (["tree", "waterfall"].includes(action)) {
+ mode = action;
+ render();
+ } else if (["preview", "attributes", "json"].includes(action)) {
+ tab = action;
+ inspector();
+ } else if (action === "more-search") await search(true);
+ else if (action === "more-turns") await loadTurns(true);
+ else if (action === "refresh") {
+ if (session) await openSession(session, selected?.turn);
+ else await search();
+ } else if (action === "overview") onOverview?.();
+ }
+ root.addEventListener("click", click, { signal });
+ $(".tr-toolbar input").addEventListener(
+ "input",
+ () => {
+ clearTimeout(timer);
+ searchText = query();
+ searchGen++;
+ timer = setTimeout(() => search(), 250);
+ },
+ { signal },
+ );
+ if (initialRun) openSession(initialRun);
+ if (adapter.search) search();
+ else $(".tr-toolbar").hidden = true;
+ return {
+ refresh: () => (session ? openSession(session) : search()),
+ dispose() {
+ disposed = true;
+ searchGen++;
+ sessionGen++;
+ detailGen++;
+ clearTimeout(timer);
+ lifetime.abort();
+ root.replaceChildren();
+ root.classList.remove("ow-session-tracing");
+ },
+ };
+}
diff --git a/harness/trace-viewer/sync.mjs b/harness/trace-viewer/sync.mjs
index c2054ea9..147afa7c 100644
--- a/harness/trace-viewer/sync.mjs
+++ b/harness/trace-viewer/sync.mjs
@@ -1,7 +1,7 @@
// One authoritative viewer implementation, copied into the standalone UI image.
import {readFile,writeFile} from 'node:fs/promises';
import assert from 'node:assert/strict';
-for(const file of ['observability.js','observability-data.js']) {
+for(const file of ['observability.js','observability-data.js','tracing.js','tracing.css']) {
const source=await readFile(new URL(`src/${file}`,import.meta.url),'utf8');
const target=new URL(`../service-ui/public/${file}`,import.meta.url);
if(process.argv.includes('--check'))assert.equal(await readFile(target,'utf8'),source,`${file}: run npm run sync in trace-viewer`);
diff --git a/harness/trace-viewer/test/session-browser.mjs b/harness/trace-viewer/test/session-browser.mjs
new file mode 100644
index 00000000..fd25c83f
--- /dev/null
+++ b/harness/trace-viewer/test/session-browser.mjs
@@ -0,0 +1,173 @@
+// Real component + actual OpenShell metadata; fault injection is browser-local.
+import assert from "node:assert/strict";
+import { mkdir } from "node:fs/promises";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+const [url, modulePath, output] = process.argv.slice(2);
+assert(["127.0.0.1", "localhost"].includes(new URL(url).hostname));
+const { chromium } = await import(pathToFileURL(resolve(modulePath)).href);
+const browser = await chromium.launch({ headless: true });
+try {
+ const p = await browser.newPage({ viewport: { width: 1600, height: 1060 } }),
+ errors = [];
+ p.on("pageerror", (e) => errors.push(e.message));
+ await p.goto(url);
+ await p.locator(".tr-step").first().waitFor();
+ await mkdir(output, { recursive: true });
+ await p.locator(".tr-session").first().click();
+ await p.locator(".tr-step").first().waitFor();
+ const first = await p.locator(".tr-session.selected code").innerText();
+ await p.locator(".tr-step").first().click();
+ await p.getByRole("button", { name: "JSON", exact: true }).click();
+ assert(
+ (await p.locator(".tr-detail-body pre").innerText()).includes("span_id"),
+ );
+ await p.screenshot({
+ path: resolve(output, "session-tracing-real-tree.png"),
+ });
+ await p.getByRole("button", { name: "Waterfall", exact: true }).click();
+ assert((await p.locator(".tr-track").count()) > 0);
+ await p.screenshot({
+ path: resolve(output, "session-tracing-real-waterfall.png"),
+ });
+ const child = p.getByRole("button", { name: /Open .* session/ }).first();
+ await child.waitFor();
+ await child.focus();
+ await p.keyboard.press("Enter");
+ await p.locator('.tr-breadcrumb [data-tr="back"]').first().waitFor();
+ await p.locator(".tr-step").first().waitFor();
+ assert.notEqual(
+ await p.locator(".tr-session.selected code").innerText(),
+ first,
+ );
+ await p.locator(".tr-step").first().click();
+ await p.screenshot({
+ path: resolve(output, "session-tracing-real-child.png"),
+ });
+ await p.locator('.tr-breadcrumb [data-tr="back"]').first().click();
+ assert.equal(await p.locator(".tr-session.selected code").innerText(), first);
+ assert.equal(
+ await p
+ .getByRole("button", { name: "Waterfall", exact: true })
+ .getAttribute("aria-pressed"),
+ "true",
+ );
+ // Isolated mounted instance: paging, multiple turns, escaping, exact session match,
+ // delayed content, loss of permission, and teardown. No new provider call.
+ await p.evaluate(async () => {
+ const { mountSessionTracing } = await import("/src/tracing.js");
+ const records = await fetch("/api/v1/observability/runs?limit=25").then(
+ (r) => r.json(),
+ );
+ const r = records.runs[0];
+ const base = await fetch(
+ `/api/v1/sessions/${r.session_id}/observability/${r.turn_id}/timeline?limit=100`,
+ ).then((r) => r.json());
+ window.requests = [];
+ window.delayed = [];
+ window.denied = false;
+ window.moreReads = 0;
+ const root = document.createElement("div");
+ root.id = "isolated";
+ document.body.prepend(root);
+ const row = base.page.steps.find(
+ (x) => x.step.operation === "model.attempt",
+ ).step;
+ const adapter = {
+ search: async (q) => {
+ window.requests.push(q);
+ return {
+ runs: [
+ {
+ session_id: "safe",
+ turn_id: "t1",
+ name: "
",
+ },
+ ],
+ next_cursor: q.after ? null : "next",
+ };
+ },
+ turns: async (q) => ({
+ turns: q.after
+ ? [{ session_id: "safe", turn_id: "t2", name: "safe" }]
+ : [{ session_id: "safe", turn_id: "t1", name: "safe" }],
+ next_cursor: q.after ? null : "turn-next",
+ }),
+ timeline: async (q) => {
+ if (window.denied) throw Object.assign(Error(), { status: 403 });
+ if (q.after) window.moreReads++;
+ return {
+ page: {
+ steps: [
+ {
+ cursor: q.after ? 2 : 1,
+ step: { ...row, span_id: q.after ? "span2" : "span1" },
+ },
+ ],
+ through: 2,
+ next: q.after ? null : 1,
+ },
+ };
+ },
+ summary: async () => ({
+ summary: {
+ usage: { input: { total: 10 }, output: { total: 5 } },
+ coverage: {},
+ },
+ }),
+ stepDetails: () => new Promise((r) => window.delayed.push(r)),
+ };
+ window.testView = mountSessionTracing(root, { adapter });
+ });
+ const root = p.locator("#isolated");
+ await root.locator(".tr-step").waitFor();
+ await root.getByRole("button", { name: "Load more steps" }).click();
+ await p.waitForFunction(() => window.moreReads === 1);
+ assert.equal(await root.locator(".tr-step").count(), 2);
+ await root.locator(".tr-step").first().click();
+ await root.locator(".tr-step").last().click();
+ await p.evaluate(() => {
+ window.delayed[1]({ input: "new selection" });
+ window.delayed[0]({ input: "stale selection" });
+ });
+ await root.getByText("new selection", { exact: true }).waitFor();
+ assert.equal(
+ await root.getByText("stale selection", { exact: true }).count(),
+ 0,
+ );
+ await root.getByRole("button", { name: "Load more turns" }).click();
+ await p.waitForFunction(
+ () => document.querySelectorAll("#isolated .tr-turn").length === 2,
+ );
+ assert.equal(await root.locator("img").count(), 0);
+ await p.evaluate(() => (window.denied = true));
+ await root.getByRole("button", { name: "Refresh", exact: true }).click();
+ await root
+ .getByText("You cannot read this session.", { exact: true })
+ .waitFor();
+ assert.equal(
+ await root.getByText("new selection", { exact: true }).count(),
+ 0,
+ );
+ await p.evaluate(() => window.testView.dispose());
+ assert.equal(await root.locator("button").count(), 0);
+ // Transport must exact-filter session IDs even if authorized search matches a prefix.
+ assert.equal(
+ await p.evaluate(async () => {
+ const { serviceTracingAdapter } = await import("/src/tracing.js");
+ const a = serviceTracingAdapter(async () => ({
+ runs: [{ session_id: "a" }, { session_id: "ab" }],
+ next_cursor: "more",
+ }));
+ const result = await a.turns({ sessionId: "a" });
+ return result.turns.length;
+ }),
+ 1,
+ );
+ assert.deepEqual(errors, []);
+ console.log(
+ "Session browser passed: real trace/child navigation, parent restore, waterfall, paging, stale detail suppression, escaping, permission loss, exact scope and disposal.",
+ );
+} finally {
+ await browser.close();
+}