Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

Keep one entry point for reading a conversation's Trace (#429)

Yaowei Zheng6e99e42186e7
diff --git a/changelog/unreleased/2026-08-23-trace-one-entry-point.md b/changelog/unreleased/2026-08-23-trace-one-entry-point.md
new file mode 100644
index 00000000..6d594621
--- /dev/null
+++ b/changelog/unreleased/2026-08-23-trace-one-entry-point.md
@@ -0,0 +1,37 @@
+# Web App: one entry point for reading a conversation's Trace
+
+- **Date:** 2026-08-23
+- **Type:** feature
+- **Scope:** `web`, `docs`
+- **PR:** [#429](https://github.com/Prism-Shadow/penguin-harness/pull/429)
+
+[中文版](2026-08-23-trace-one-entry-point.zh.md)
+
+Alongside the dock's Trace panel, which shows the Trace of the conversation on screen, the
+`/traces` page was deep-linked from three places: a Trace file row in the conversation's
+details card, an eye button on every row of the Agent list, and the Session column of the
+Benchmark page's per-run table. All three links were removed, leaving the dock's Trace panel
+as the only way into a Trace from the app. The `/traces` page itself, its data and its API
+are untouched.
+
+## Details
+
+- The details card behind the conversation's header stats no longer carries a Trace file
+ row: the file name, its full-path tooltip and the copy-full-path button went with it,
+ together with the single-session fetch that filled them when the card opened.
+- Rows of the Agent list lost their Traces button. New chat, Settings, Usage and Delete
+ are unchanged, and the row's remaining buttons keep their order.
+- `S.chat.traceFile` and `S.chat.copyTracePath` left both string dictionaries, the eye
+ glyph left the Agent list's icon table, and `pathFileName` — whose only caller was the
+ removed row — left `file-path.ts` along with its unit tests.
+- The Benchmark page's per-run Session column shows the Session id as plain text instead of
+ a link. `CaseRow` and `EvaluationRow` lost the `agentId` prop they carried only to build
+ that link, and the file's only `Link` import went with it.
+- The `/traces` route was kept even though nothing in the app now links to it: an existing
+ `?agentId=`/`?sessionId=` URL still resolves, which matters for links already shared, and
+ the page holds the Trace import/export controls, which exist nowhere else. Comments naming
+ the removed entry points were corrected rather than left to rot.
+
+## Docs
+
+- The Web App guide's details-card section dropped its Trace file bullet, in both languages.
diff --git a/changelog/unreleased/2026-08-23-trace-one-entry-point.zh.md b/changelog/unreleased/2026-08-23-trace-one-entry-point.zh.md
new file mode 100644
index 00000000..bf4a2cb6
--- /dev/null
+++ b/changelog/unreleased/2026-08-23-trace-one-entry-point.zh.md
@@ -0,0 +1,29 @@
+# Web App:会话轨迹只保留一个入口
+
+- **Date:** 2026-08-23
+- **Type:** feature
+- **Scope:** `web`, `docs`
+- **PR:** [#429](https://github.com/Prism-Shadow/penguin-harness/pull/429)
+
+[English](2026-08-23-trace-one-entry-point.md)
+
+除展示当前会话轨迹的停靠区 Trace 面板之外,`/traces` 页此前还被三处深链接指向:会话详情卡中的
+轨迹文件行、Agent 列表每一行上的眼睛按钮,以及 Benchmark 页按次运行表格的 Session 列。本次移除了
+这三处链接,应用内读取轨迹只经由停靠区的 Trace 面板。`/traces` 页本身及其数据与 API 均未改动。
+
+## 细节
+
+- 会话头部统计背后的详情卡不再包含轨迹文件行:文件名、完整路径的悬浮提示与复制完整路径按钮一并
+ 移除,打开详情卡时为其取数的单会话请求也随之移除。
+- Agent 列表的行去掉了轨迹观测按钮。新建对话、设置、用量与删除保持不变,行内其余按钮顺序不变。
+- `S.chat.traceFile` 与 `S.chat.copyTracePath` 从两份字典中移除,眼睛图标从 Agent 列表的图标表中
+ 移除,`pathFileName` 的唯一调用方即上述被移除的行,因此它与其单元测试一并从 `file-path.ts` 移除。
+- Benchmark 页按次运行的 Session 列改为纯文本展示 Session id,不再是链接。`CaseRow` 与
+ `EvaluationRow` 仅为拼接该链接而携带的 `agentId` 参数一并移除,该文件唯一的 `Link` 引入也随之移除。
+- `/traces` 路由在应用内已无任何链接指向的情况下仍予保留:既有的 `?agentId=`/`?sessionId=` URL
+ 仍可解析——这对已经分享出去的链接很重要——且该页承载着别处没有的轨迹导入/导出操作。注释中
+ 提及已移除入口的措辞一并更正,避免过时。
+
+## 文档
+
+- Web App 指南的详情卡一节以两种语言删去了轨迹文件条目。
diff --git a/packages/docs/content/web-app.en.md b/packages/docs/content/web-app.en.md
index 281a65a4..3d8ff426 100644
--- a/packages/docs/content/web-app.en.md
+++ b/packages/docs/content/web-app.en.md
@@ -62,7 +62,6 @@ Pinning is offered only in the active list — the archived, subagent and schedu
The toolbar's right edge shows the Session's cumulative stats (tokens, cost, elapsed time); clicking them opens the details card — model, Session id (with a copy button beside it), Workspace, creation time and per-line statistics. Below those:
- **Processes** — background processes the conversation started (`exec_command`s promoted past their yield window), one row each with the command, start time and pid — plus, on running rows, a link to the service the process serves when one was detected (the last local URL its output printed, else a listen-port probe of its process group). Running rows carry a **Stop** button (kills the whole process group and drops the row); exited rows keep their "exited" label and carry a **Remove** button that deletes the entry from the list. Removal is immediate and final: the entry leaves the runtime registry together with the output captured from that process, so afterwards the model can no longer be asked to read it — keep the row until you are done with its output.
-- **Trace file** — the Session's current Trace file, shown as its file name on a single line: clicking the name opens the Trace Browser focused on this session, and the button beside it copies the full path.
Copy buttons across the app confirm at the button itself: the copy icon flips to a check mark for a moment (no "Copied" text label).
diff --git a/packages/docs/content/web-app.zh.md b/packages/docs/content/web-app.zh.md
index 0c3bfe20..14fa72d2 100644
--- a/packages/docs/content/web-app.zh.md
+++ b/packages/docs/content/web-app.zh.md
@@ -59,10 +59,9 @@ penguin web
### 头部统计与详情卡
-工具行最右侧显示会话累计统计(Token、费用、用时),点击即打开详情卡——模型、Session id(旁附复制按钮)、Workspace、创建时间与逐行统计。其下还有两节:
+工具行最右侧显示会话累计统计(Token、费用、用时),点击即打开详情卡——模型、Session id(旁附复制按钮)、Workspace、创建时间与逐行统计。其下还有一节:
- **会话进程**——对话启动的后台进程(超过 yield 窗口转入后台的 `exec_command`),逐行显示命令、启动时间与 pid;运行中的行在检测到进程所服务的地址时,还会附上可点击的服务链接(取其输出打印的最后一个本机 URL,否则对其进程组做监听端口探测)。运行中的行带「停止」按钮(杀停整个进程组并把该行从列表移除);已退出的行保留「已退出」标注,并带「移除」按钮,可把该条目从列表删除。移除立即生效且不可撤销:条目连同该进程已捕获的输出一起离开运行时注册表,之后无法再让模型读取那段输出——输出还有用时请先留着这一行。
-- **轨迹文件**——会话当前的 Trace 文件,单行仅显示文件名:点击文件名跳转到聚焦本会话的轨迹观测页,旁边的按钮复制完整路径。
全站的复制按钮在按钮自身给出反馈:复制成功后图标短暂切换为对勾(不再显示「已复制」文字)。
diff --git a/packages/web/e2e/processes.spec.mjs b/packages/web/e2e/processes.spec.mjs
index 8b7ccbc2..4c111c61 100644
--- a/packages/web/e2e/processes.spec.mjs
+++ b/packages/web/e2e/processes.spec.mjs
@@ -3,8 +3,8 @@
* a task whose exec_command outlives its yield window becomes a background process —
* the header's stats trigger gains a running-services count, the details card lists the
* process (cmd + pid + start time) with a stop button, stopping it clears both, and the
- * card's other rows (model / workspace / created / per-line stats / trace file path)
- * render in their new layout. The mock's "background server test" branch drives it
+ * card's other rows (model / workspace / created / per-line stats) render in their
+ * new layout. The mock's "background server test" branch drives it
* (`sleep 600` with a 300ms yield — see mock-llm.mjs).
*/
import { test, expect } from "@playwright/test";
@@ -66,14 +66,9 @@ test("background process appears in the details card and can be stopped", async
// rate in parens (from the recorded usage row).
await expect(page.getByText(/总 Token/).first()).toBeVisible();
await expect(page.getByText(/缓存命中率 \d+%/).first()).toBeVisible();
- // Trace file row shows just the FILE NAME on one line (#312) — anchored match, a full
- // path would not match — with the copy-full-path button beside it (its own coverage
- // lives in the exited-process test below).
- await expect(page.getByText("轨迹文件")).toBeVisible();
- await expect(
- page.getByRole("button", { name: new RegExp(`^${sessionId}_\\d{3}\\.jsonl$`) }),
- ).toBeVisible();
- await expect(page.getByRole("button", { name: "复制完整路径" })).toBeVisible();
+ // The Trace file row is gone from the details card: the conversation's Trace is read
+ // in the dock's Trace panel now, and the card no longer carries a path to copy.
+ await expect(page.getByText("轨迹文件")).toHaveCount(0);
// The process list row: the command, its pid line, and a working stop button.
await expect(page.getByText("会话进程")).toBeVisible();
@@ -94,9 +89,7 @@ test("background process appears in the details card and can be stopped", async
expect(procs.processes).toEqual([]);
});
-test("an exited process can be removed from the list; the trace row copies the full path and deep-links", async ({
- page,
-}) => {
+test("an exited process can be removed from the list", async ({ page }) => {
await provisionAndLogin(page.request, U, P);
const projects = await (await page.request.get(`${BASE}/api/projects`)).json();
@@ -152,23 +145,4 @@ test("an exited process can be removed from the list; the trace row copies the f
await page.request.get(`${BASE}/api/sessions/${sessionId}/processes`)
).json();
expect(procs.processes).toEqual([]);
-
- // --- Trace file row actions (#312) ---
- // Copy puts the FULL absolute path on the clipboard while the row shows only the name…
- const traceName = page.getByRole("button", {
- name: new RegExp(`^${sessionId}_\\d{3}\\.jsonl$`),
- });
- await expect(traceName).toBeVisible();
- await page.getByRole("button", { name: "复制完整路径" }).click();
- const copied = await page.evaluate(() => navigator.clipboard.readText());
- expect(copied).toMatch(/\.jsonl$/);
- expect(copied).toContain(`${sessionId}_`);
- expect(copied.length).toBeGreaterThan((await traceName.textContent()).length);
- expect(copied.endsWith(await traceName.textContent())).toBe(true);
- // …and clicking the name deep-links into the Trace page focused on this session.
- await traceName.click();
- await expect(page).toHaveURL(new RegExp(`/traces\\?agentId=.*sessionId=`));
- await expect(page.locator("main").getByText("轨迹观测").first()).toBeVisible({
- timeout: 15_000,
- });
});
diff --git a/packages/web/src/components/layout/app-layout.tsx b/packages/web/src/components/layout/app-layout.tsx
index daa93c29..01fe9f26 100644
--- a/packages/web/src/components/layout/app-layout.tsx
+++ b/packages/web/src/components/layout/app-layout.tsx
@@ -79,7 +79,8 @@ function CollapsedRail({ onExpand }: { onExpand: () => void }) {
/** Page entries (rail positions 3-7): same routes, same labels as the pinned nav.
Traces is not among them: the Trace panel lives in the chat toolbar's panel switcher
- now, and the /traces browsing page stays reachable through its deep links. */
+ now, and the /traces browsing page stays addressable by URL (plus the Benchmark
+ page's per-run Session links). */
const pages: ReadonlyArray<{ to: string; label: string; icon: string }> = [
{ to: "/agents", label: S.nav.agents, icon: NAV_ICONS.agents },
{ to: "/skills", label: S.nav.skills, icon: NAV_ICONS.skills },
diff --git a/packages/web/src/features/agents/agents-page.tsx b/packages/web/src/features/agents/agents-page.tsx
index c6ea681b..e0e1661e 100644
--- a/packages/web/src/features/agents/agents-page.tsx
+++ b/packages/web/src/features/agents/agents-page.tsx
@@ -8,11 +8,10 @@
* tool / skill / memory / vault-key / schedule counts deep-link to the settings page's matching
* tab (?tab=tools|skills|memory|vault|schedules) and appear in the settings tabs' order.
* Buttons sit to the right of the sparkline: "New Chat" (draft state, same as sidebar group
- * header) and "Settings" (goes to settings page) show text labels; "Usage" / "Traces" (deep link
- * via ?agentId= to the usage center / trace observability; traces use an eye line icon =
- * observability) and "Delete" (with confirmation; built-in Agents show a non-interactive light
- * gray placeholder with an undeletable tooltip) are square icon buttons (tooltip shows the full
- * name); "Create Agent" only fills in name + description.
+ * header) and "Settings" (goes to settings page) show text labels; "Usage" (deep links via
+ * ?agentId= to the usage center) and "Delete" (with confirmation; built-in Agents show a
+ * non-interactive light gray placeholder with an undeletable tooltip) are square icon buttons
+ * (tooltip shows the full name); "Create Agent" only fills in name + description.
*/
import { useEffect, useState } from "react";
import { useLocation, useNavigate } from "react-router";
@@ -62,8 +61,6 @@ const CARD_ICONS = {
"M12 6.5C10.5 5 8 4.5 4 5v12c4-.5 6.5 0 8 1.5 1.5-1.5 4-2 8-1.5V5c-4-.5-6.5 0-8 1.5zm0 0V18",
/** Usage (bar chart, same as sidebar "Usage Center") */
usage: "M4 20V10m6 10V4m6 16v-7m4 7H2",
- /** Traces (eye line icon: observability; follows text color, no fill) */
- traces: "M2 12s3.6-7 10-7 10 7 10 7-3.6 7-10 7-10-7-10-7zM12 9a3 3 0 1 0 0 6 3 3 0 0 0 0-6z",
/** Memory (brain: two hemispheres + inner fold, lucide simplified), opens the settings tab */
memory:
"M12 5a3 3 0 1 0-5.997.125 4 4 0 0 0-2.526 5.77 4 4 0 0 0 .556 6.588A4 4 0 1 0 12 18ZM12 5a3 3 0 1 1 5.997.125 4 4 0 0 1 2.526 5.77 4 4 0 0 1-.556 6.588A4 4 0 1 1 12 18ZM15 13a4.5 4.5 0 0 1-3-4 4.5 4.5 0 0 1-3 4",
@@ -387,18 +384,6 @@ export function AgentsPage() {
className="text-gray-600 dark:text-gray-300"
/>
</Button>
- <Button
- size="icon"
- title={S.nav.traces}
- aria-label={S.nav.traces}
- onClick={() => navigate(`/traces?agentId=${encodeURIComponent(a.agentId)}`)}
- >
- <GlyphIcon
- d={CARD_ICONS.traces}
- size={15}
- className="text-gray-600 dark:text-gray-300"
- />
- </Button>
{/* Built-in Agents can't be deleted: shown as a non-button light gray
placeholder (no border/background, no hover response, disabled cursor,
explained via tooltip); the transparent border keeps the same box size as
diff --git a/packages/web/src/features/benchmark/benchmark-page.tsx b/packages/web/src/features/benchmark/benchmark-page.tsx
index 7d12fe7d..cf3704da 100644
--- a/packages/web/src/features/benchmark/benchmark-page.tsx
+++ b/packages/web/src/features/benchmark/benchmark-page.tsx
@@ -9,7 +9,7 @@
* With a ?agentId= deep link, only the target Agent is expanded by default.
*/
import { useEffect, useState } from "react";
-import { Link, useSearchParams } from "react-router";
+import { useSearchParams } from "react-router";
import type {
BenchmarkCaseScore,
BenchmarkCaseSummary,
@@ -263,13 +263,11 @@ const CELL = "px-3 py-2";
/** One evaluation record: main row + a sub-table of per-Case scores that expands on click. */
function EvaluationRow({
- agentId,
evaluation,
caseTitles,
onOpenCase,
currency,
}: {
- agentId: string;
evaluation: BenchmarkEvaluation;
caseTitles: ReadonlyMap<string, string>;
onOpenCase: (caseId: string) => void;
@@ -344,7 +342,6 @@ function EvaluationRow({
{evaluation.cases.map((c) => (
<CaseRow
key={c.case}
- agentId={agentId}
caseScore={c}
title={caseTitles.get(c.case)}
onOpenCase={caseTitles.has(c.case) ? onOpenCase : undefined}
@@ -360,17 +357,16 @@ function EvaluationRow({
);
}
-/** Session deep link: jumps straight to that Session's trace observability (?sessionId= auto-selects it, instead of stopping at the Agent group). */
-function SessionLink({ agentId, sessionId }: { agentId: string; sessionId?: string }) {
+/**
+ * Session id, for correlating a Run with what the side panel shows. It used to deep-link into the
+ * Traces page; reading a Trace is now the side panel's job alone, so this is identification only.
+ */
+function SessionCell({ sessionId }: { sessionId?: string }) {
if (!sessionId) return <span className="text-gray-400">—</span>;
return (
- <Link
- to={`/traces?agentId=${encodeURIComponent(agentId)}&sessionId=${encodeURIComponent(sessionId)}`}
- className="font-mono text-gray-600 underline decoration-gray-300 underline-offset-2 hover:text-gray-900 dark:text-gray-300 dark:decoration-gray-600 dark:hover:text-gray-100"
- title={sessionId}
- >
+ <span className="font-mono text-gray-600 dark:text-gray-300" title={sessionId}>
{sessionId}
- </Link>
+ </span>
);
}
@@ -379,13 +375,11 @@ function SessionLink({ agentId, sessionId }: { agentId: string; sessionId?: stri
* results; the UI never recomputes averages.
*/
function CaseRow({
- agentId,
caseScore: c,
title,
onOpenCase,
currency,
}: {
- agentId: string;
caseScore: BenchmarkCaseScore;
title?: string;
onOpenCase?: (caseId: string) => void;
@@ -449,10 +443,7 @@ function CaseRow({
{run.durationMs !== undefined ? humanizeDuration(run.durationMs) : "—"}
</td>
<td className="px-2 py-1">
- <SessionLink
- agentId={agentId}
- {...(run.sessionId ? { sessionId: run.sessionId } : {})}
- />
+ <SessionCell {...(run.sessionId ? { sessionId: run.sessionId } : {})} />
</td>
</tr>
))}
@@ -621,7 +612,6 @@ export function BenchmarkPage() {
{[...evaluations].reverse().map((ev, i) => (
<EvaluationRow
key={i}
- agentId={selection.agentId}
evaluation={ev}
caseTitles={caseTitles}
onOpenCase={setOpenCaseId}
diff --git a/packages/web/src/features/chat/chat-page.tsx b/packages/web/src/features/chat/chat-page.tsx
index bae01b8e..68c80226 100644
--- a/packages/web/src/features/chat/chat-page.tsx
+++ b/packages/web/src/features/chat/chat-page.tsx
@@ -34,7 +34,6 @@ import * as api from "../../api/endpoints";
import { ApiError } from "../../api/client";
import { S } from "../../lib/strings";
import { apiErrorText } from "../../lib/api-error";
-import { pathFileName } from "../../lib/file-path";
import { useDocumentTitle } from "../../lib/use-document-title";
import {
formatDateTime,
@@ -299,9 +298,6 @@ export function ChatPage() {
cacheWrite: number;
output: number;
} | null>(null);
- // Latest trace file path (single-session GET only — list rows don't carry it), fetched
- // when the details popover opens; null = none yet (brand-new session) or still loading.
- const [tracePath, setTracePath] = useState<string | null>(null);
// A mid-chat thinking-level pick staged behind the confirm dialog (issue #310): some
// providers key their prompt PREFIX on the thinking level, so switching with history in
// place invalidates the provider's prefix cache and the next request re-bills the whole
@@ -689,7 +685,7 @@ export function ChatPage() {
// Session switch: resets the usage-fetch marker, the file-card existence cache, any
// thinking-level switch staged behind its dialog (per-session UI state — a compaction
// that self-heals to a new session id routes through here too and drops the held pick),
- // and the popover's per-session data (process list / token buckets / trace path),
+ // and the popover's per-session data (process list / token buckets),
// avoiding stale data from the previous Session (the panel jump commands reset in their
// own effect above, and the cost hold re-keys itself inside advanceCostStat). The thinking level itself needs no reset — it is read off the
// selected Session row, so it changes with the session by construction.
@@ -699,7 +695,6 @@ export function ChatPage() {
statCacheRef.current = new Map();
setProcesses([]);
setUsageBuckets(null);
- setTracePath(null);
}, [routeSessionId]);
// Batched existence check for file summaries: cache stable positive results and share in-flight
@@ -868,23 +863,6 @@ export function ChatPage() {
[runProcessAction],
);
- // Trace file path for the popover's trace row: the single-session GET is the only
- // surface carrying it, so fetch lazily on open (and once per session — the path only
- // ever moves forward when a new trace file starts, which a reopen picks up).
- useEffect(() => {
- if (!infoOpen || !selectedSessionId) return;
- let cancelled = false;
- api
- .getSession(selectedSessionId)
- .then((res) => {
- if (!cancelled) setTracePath(res.session.tracePath ?? null);
- })
- .catch(() => undefined);
- return () => {
- cancelled = true;
- };
- }, [infoOpen, selectedSessionId]);
-
// Model config (context window + credential guide): fetched once per Project.
//
// The credential guide **only ever nags once per lifetime** (first entry after registration):
@@ -1907,49 +1885,6 @@ export function ChatPage() {
</ul>
</div>
)}
- {/* Trace file, same section anatomy as the rows above (label + mono value):
- the value is the file NAME on a single line (#312 — the full path wrapped
- over several lines; it now lives in the tooltip and the copy button, which
- copies the FULL path). The name itself is the click target and
- SPA-navigates to the Trace page deep-linked to the owning Agent AND this
- Session (?agentId= focuses/expands the Agent group, ?sessionId=
- auto-selects — a Session beyond the first loaded page resolves via the
- Trace page's full-fetch fallback). Hidden until a trace exists (a
- brand-new session has no file to open); only reachable for a real
- Session — this whole header renders behind the `selected` guard, so a
- draft never shows it. */}
- {tracePath !== null && (
- <div>
- <p className="text-xs font-medium text-gray-500 dark:text-gray-400">
- {S.chat.traceFile}
- </p>
- <div className="flex items-center gap-1.5">
- {/* Wrapper (not flex-1 on the button itself) keeps the click target no
- wider than the name while the copy button still sits at the row's
- right edge, mirroring the Session id row. */}
- <div className="min-w-0 flex-1">
- <button
- type="button"
- title={tracePath}
- onClick={() => {
- setInfoOpen(false);
- navigate(
- `/traces?agentId=${encodeURIComponent(selected.agentId)}&sessionId=${encodeURIComponent(selected.sessionId)}`,
- );
- }}
- className="max-w-full truncate text-left font-mono text-xs leading-5 text-gray-600 underline decoration-gray-300 underline-offset-2 transition-colors duration-150 hover:text-gray-900 dark:text-gray-300 dark:decoration-gray-600 dark:hover:text-gray-100"
- >
- {pathFileName(tracePath)}
- </button>
- </div>
- <CopyButton
- text={tracePath}
- label={S.chat.copyTracePath}
- className={ROW_COPY_CLASS}
- />
- </div>
- </div>
- )}
</div>
</Dropdown>
</div>
diff --git a/packages/web/src/features/traces/trace-panel.tsx b/packages/web/src/features/traces/trace-panel.tsx
index 2dacd101..4b166705 100644
--- a/packages/web/src/features/traces/trace-panel.tsx
+++ b/packages/web/src/features/traces/trace-panel.tsx
@@ -2,8 +2,9 @@
* Trace panel — the current conversation's Trace files as a dock tab, reusing the traces
* page's file view (performance timeline + event list) scoped to one Session. The file
* pills page newest-first; the export link downloads the selected file raw. Cross-Session
- * browsing stays on the /traces page (deep-linked from the Agents page and the details
- * popover) — this panel is the "what did this conversation do" view.
+ * browsing stays on the /traces page, which no longer has a UI entry point of its own —
+ * this panel is the only way in from the app, and is the "what did this conversation do"
+ * view. The page is still reachable by URL, for shared links and its import/export controls.
*
* Loading is gated on `active` (the dock keeps inactive tabs mounted): the listing is
* fetched on the first show and re-fetched on every re-show, so a Task that finished while
diff --git a/packages/web/src/features/traces/traces-page.tsx b/packages/web/src/features/traces/traces-page.tsx
index 6a977215..47343d73 100644
--- a/packages/web/src/features/traces/traces-page.tsx
+++ b/packages/web/src/features/traces/traces-page.tsx
@@ -99,13 +99,14 @@ export function TracesPage() {
const { byAgent, showCliSessions } = useSessions();
const projectId = currentProject?.projectId ?? null;
const tree = useTraceTree(projectId, showCliSessions);
- // ?agentId= deep link (from the Agents page's "traces" entry point): forces agent
- // grouping for this visit (the target must be a visible, expanded group) WITHOUT
- // overwriting the stored preference; only the target Agent defaults to expanded.
+ // ?agentId= deep link: forces agent grouping for this visit (the target must be a visible,
+ // expanded group) WITHOUT overwriting the stored preference; only the target Agent defaults to
+ // expanded. Nothing in the app produces these URLs any more — they arrive from links shared
+ // while the Agents page still had a Trace entry point, so they have to keep resolving.
const [searchParams] = useSearchParams();
const focusAgentId = searchParams.get("agentId");
- // ?sessionId= deep link (jumped to directly from the evaluation center's
- // runs): auto-selects once the target Agent's Session list is ready.
+ // ?sessionId= deep link: auto-selects once the target Agent's Session list is ready. The
+ // evaluation center's Run rows used to produce these; they now show the Session id as text.
const focusSessionId = searchParams.get("sessionId");
// Grouping mode: the same persisted preference as the chat sidebar
// (penguin.sidebarGroupMode) so the two surfaces always group alike, narrowed to the
diff --git a/packages/web/src/lib/file-path.ts b/packages/web/src/lib/file-path.ts
index e885d07f..909fb37c 100644
--- a/packages/web/src/lib/file-path.ts
+++ b/packages/web/src/lib/file-path.ts
@@ -95,22 +95,6 @@ export function joinWorkspacePath(base: string, name: string): string {
return base === "" ? name : `${base}/${name}`;
}
-/**
- * Final path segment, for showing a file's NAME where the full path would wrap (the
- * details card's Trace file row keeps the path in the tooltip / copy action instead).
- * Cuts at the last separator of EITHER kind: a Windows deployment reports `\`
- * (server-side path.join) while POSIX reports `/`. So a backslash inside a POSIX
- * directory name is harmless — a later `/` always wins the cut — while one inside the
- * file name itself would cut there too; that costs nothing for the server-generated
- * names this is used on (`<sessionId>_NNN.jsonl`). Falls back to the input when the
- * last segment is empty (trailing separator) so the result is never blank.
- */
-export function pathFileName(path: string): string {
- const cut = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
- const name = cut === -1 ? path : path.slice(cut + 1);
- return name === "" ? path : name;
-}
-
/** Max length for a single files/stat path (matches server-side validation). */
const MAX_PATH_LEN = 512;
diff --git a/packages/web/src/lib/nav-group-collapse.ts b/packages/web/src/lib/nav-group-collapse.ts
index 9fca3634..9460f79a 100644
--- a/packages/web/src/lib/nav-group-collapse.ts
+++ b/packages/web/src/lib/nav-group-collapse.ts
@@ -19,7 +19,7 @@
* its nav rows from this manifest, so the covered range is pinned here (and in the
* unit tests) rather than duplicated. Traces is deliberately absent: the Trace panel
* lives in the chat toolbar's panel switcher, and the /traces browsing page stays
- * reachable through its deep links (Agents page, session details).
+ * addressable by URL (the Benchmark page's per-run Session links still point at it).
*/
export const NAV_GROUP_KEYS = ["agents", "skills", "models", "usage", "benchmark"] as const;
export type NavGroupKey = (typeof NAV_GROUP_KEYS)[number];
diff --git a/packages/web/src/lib/strings-en.ts b/packages/web/src/lib/strings-en.ts
index c33e44e1..52c0e157 100644
--- a/packages/web/src/lib/strings-en.ts
+++ b/packages/web/src/lib/strings-en.ts
@@ -1483,9 +1483,6 @@ Scenarios:
/** Info-dropdown Session id row: the id itself is a click-to-copy button. */
sessionIdLabel: "Session id",
copySessionId: "Copy Session id",
- /** Info-dropdown trace row: labels the Session's trace file, shown as its NAME (clicking deep-links to the Trace page; the button beside it copies the full path). */
- traceFile: "Trace file",
- copyTracePath: "Copy full path",
/** Info-dropdown list of background processes the conversation started, and its per-row actions (Stop on running rows, Remove on exited ones). */
processList: "Processes",
processStop: "Stop",
diff --git a/packages/web/src/lib/strings.ts b/packages/web/src/lib/strings.ts
index bff72232..661142f1 100644
--- a/packages/web/src/lib/strings.ts
+++ b/packages/web/src/lib/strings.ts
@@ -1442,9 +1442,6 @@ Benchmark:
/** Info-dropdown Session id row: the id itself is a click-to-copy button. */
sessionIdLabel: "Session id",
copySessionId: "复制 Session id",
- /** Info-dropdown trace row: labels the Session's trace file, shown as its NAME (clicking deep-links to the Trace page; the button beside it copies the full path). */
- traceFile: "轨迹文件",
- copyTracePath: "复制完整路径",
/** Info-dropdown list of background processes the conversation started, and its per-row actions (Stop on running rows, Remove on exited ones). */
processList: "会话进程",
processStop: "停止",
diff --git a/packages/web/test/file-path.test.ts b/packages/web/test/file-path.test.ts
index d34304f8..a0e1ecdf 100644
--- a/packages/web/test/file-path.test.ts
+++ b/packages/web/test/file-path.test.ts
@@ -1,16 +1,10 @@
/**
* file-path.ts unit tests: whether inline code in message text looks like a file path,
* all branches of normalizing body paths to a Workspace-relative path (toWorkspaceRelative),
- * the directory-browser navigation join (joinWorkspacePath), and the display name of a
- * file path (pathFileName — the details card's Trace file row).
+ * and the directory-browser navigation join (joinWorkspacePath).
*/
import { describe, expect, it } from "vitest";
-import {
- isFilePathLike,
- joinWorkspacePath,
- pathFileName,
- toWorkspaceRelative,
-} from "../src/lib/file-path";
+import { isFilePathLike, joinWorkspacePath, toWorkspaceRelative } from "../src/lib/file-path";
describe("isFilePathLike", () => {
it("relative path + image extension → match", () => {
@@ -164,35 +158,3 @@ describe("joinWorkspacePath", () => {
expect(joinWorkspacePath(pathStateAfterFirstClick, "home")).toBe("home/home");
});
});
-
-describe("pathFileName", () => {
- it("POSIX absolute path → final segment", () => {
- expect(pathFileName("/home/user/PenguinHarness/traces/2026-08-18/s-1/001.jsonl")).toBe(
- "001.jsonl",
- );
- });
-
- it("Windows path (backslashes) → final segment", () => {
- expect(pathFileName("C:\\Users\\u\\PenguinHarness\\traces\\001.jsonl")).toBe("001.jsonl");
- });
-
- it("mixed separators → the last of either kind cuts", () => {
- expect(pathFileName("C:/Users/u\\traces\\001.jsonl")).toBe("001.jsonl");
- });
-
- it("bare filename → unchanged", () => {
- expect(pathFileName("001.jsonl")).toBe("001.jsonl");
- });
-
- it("a backslash inside a POSIX directory name is harmless — the later '/' wins the cut", () => {
- expect(pathFileName("/data/weird\\dir/traces/001.jsonl")).toBe("001.jsonl");
- });
-
- it("the cut is the last separator of either kind, so a backslash in the file name cuts too (no such trace name exists — pinning the rule, not endorsing it)", () => {
- expect(pathFileName("/data/traces/weird\\001.jsonl")).toBe("001.jsonl");
- });
-
- it("degenerate trailing separator falls back to the input (never blank)", () => {
- expect(pathFileName("/home/user/")).toBe("/home/user/");
- });
-});