agent-decoder 0.3.5__tar.gz → 0.3.6__tar.gz

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/.gitignore

@@ -52,5 +52,9 @@ demo-reel/
 # Keep the built static assets — they ship with the package
 !src/agent_decoder/static/
 
-# Local scratch/handoff docs — never published
+# Local scratch/handoff docs and agent config — never published
 docs/archive/
+/.handoff/
+/.internal-archive/
+/.claude/
+/CLAUDE.md

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/ARCHITECTURE.md

@@ -164,3 +164,55 @@ See [`SECURITY.md`](SECURITY.md) for the disclosure process and full scope.
   pre-warmed in the background after first paint.
 - **GZip middleware.** FastAPI compresses JSON responses over a few hundred
   bytes, which keeps session-detail payloads small on large conversations.
+
+### Shared interactive execution
+
+`ExecutionManager` is the single server owner of Claude and Codex terminals.
+It shares the session lock table, active Native terminal, sizing configuration,
+and shutdown lifecycle. `pty_runner.PtyManager` supplies Claude's established
+input policy (ownership, input acknowledgments/watchdog, `/model`, permissions,
+and ephemeral `/btw` capture); `driver_manager.DriverSessionPolicy` supplies
+Codex's launch/resume, state polling, and rollout adoption. Neither policy is
+instantiated as another manager. The former `DriverManager` import resolves to
+`ExecutionManager` for compatibility. Native input, resize, snapshot, status,
+and termination routes all use the same owner. Provider capability checks still
+run before focus/submit; read-only providers cannot acquire a terminal.
+
+Both providers use the isolated `agent-decoder` tmux socket by default.
+`AGENT_DECODER_TMUX_SOCKET` overrides it for isolated installations/tests.
+Claude falls back to direct PTY when tmux is absent; internal consumers can
+explicitly request `terminal_backend="direct"`. Codex requires tmux and retains
+its runtime capability gate. Claude launch environments use a private temporary
+file consumed and unlinked before exec; secrets do not appear in launch argv or
+tmux metadata.
+
+Normal server shutdown **detaches** attach clients, stops local watchdogs and
+capture readers, releases server-owned Claude sidecars, and leaves tmux harnesses
+running. Browser disconnect/idle does not reap tmux harnesses. Explicit kill
+**terminates** the harness; kill also resolves a persistent terminal after a
+server restart without spawning or first focusing it. Direct PTY cannot detach
+and therefore terminates on shutdown. Claude reattachment checks session/cwd
+metadata against the pane PID plus the OS process start identity and executable.
+A changed process or a fresh foreign sidecar prevents adoption. Binary,
+permission, or model configuration changes require a verified owned respawn;
+live `/model` updates the persisted launch configuration. These checks coordinate
+same-user processes, not mutually untrusted users sharing a tmux server.
+
+Tmux redraws terminal output, which is suitable for Native hydration but changes
+the escape sequences Claude's `/btw` parser needs. Claude therefore also uses
+`pipe-pane` into a private Unix datagram receiver for the original byte stream.
+The relay drains without waiting for the application; datagrams and receiver
+work per loop turn are bounded. Sequence gaps or capture-buffer overflow fail
+the pending ephemeral response instead of persisting partial text. A capture
+owner token prevents an old client from stopping a replacement relay. Detach
+removes the local socket and stops its relay; after a crash an orphaned relay
+keeps draining/dropping until reattachment replaces it.
+
+Limitations: pending ephemeral `/btw` output is not recovered across a server
+crash/restart, and output during detach is not retained as a raw byte history;
+reattachment hydrates the tmux screen while JSONL remains the content source.
+A crashed process may leave a private temporary socket directory until OS temp
+cleanup. Deliberately replacing/execing a managed pane into a different executable
+requires explicit recovery rather than automatic ownership adoption. Real
+provider auth/network smoke tests remain opt-in; behavioral tests use synthetic
+CLIs and unique tmux sockets.

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/CHANGELOG.md

@@ -6,6 +6,25 @@ The format is based on [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.
 
 ## [Unreleased]
 
+## [0.3.6] - 2026-11-06
+
+### Added
+
+- **Durable agent runs and a cross-provider Runs screen** (#52). Each managed execution attempt is recorded in an `agent_runs` table that is independent of the rebuildable session index; no screen or exit code is treated as proof of completion. Read it at `GET /api/runs` and `GET /api/runs/{id}`.
+- **Unified Claude and Codex execution ownership** with persistent tmux terminals (#51), so both providers share one execution manager.
+- **Artifacts panel** listing a session's images and written files.
+
+### Changed
+
+- Share one syntax highlighter and cache rendered markdown, and toggle the artifacts panel without re-rendering the chat.
+- Local agent and handoff files (`.handoff/`, `.claude/`, `CLAUDE.md`, ...) are excluded from sdist builds and gitignored.
+
+### Fixed
+
+- **Periodic rescan no longer re-parses every Codex transcript each minute.** Codex rollouts are named `rollout-<timestamp>-<uuid>` but indexed under the session id inside the file, so the "has this file changed?" lookup by file name missed most of them and the server re-parsed gigabytes of unchanged transcripts on every pass (a ~14 s CPU spike every 60 s, plus `message_count` reset to 0 on large rollouts). Unchanged files are now skipped by path, including rollouts that share a session id.
+- Dangling symlinks under `~/.claude/projects` are skipped quietly instead of logging a "No such file" warning on every rescan.
+- Native terminal no longer snaps back to the bottom and wipes scrollback when a full-screen clear (`ESC[3J`) arrives while you are scrolled up. A real `/clear` at the bottom still clears. An ignored sequence is logged to the browser console (`agent-decoder: ignored ESC[3J …`) so the cause can be confirmed in real use.
+
 ## [0.3.5] - 2026-10-24
 
 ### Changed
@@ -253,7 +272,8 @@ Initial public release.
 
 - License changed from MIT to [FSL-1.1-Apache-2.0](LICENSE). All prior unreleased history was developed under MIT; the 0.1.0 release and everything after it ship under FSL-1.1-Apache-2.0, which converts to Apache 2.0 two years after each release.
 
-[Unreleased]: https://github.com/Comradery64/Agent-Decoder/compare/v0.3.5...HEAD
+[Unreleased]: https://github.com/Comradery64/Agent-Decoder/compare/v0.3.6...HEAD
+[0.3.6]: https://github.com/Comradery64/Agent-Decoder/compare/v0.3.5...v0.3.6
 [0.3.5]: https://github.com/Comradery64/Agent-Decoder/compare/v0.3.2...v0.3.5
 [0.3.2]: https://github.com/Comradery64/Agent-Decoder/compare/v0.3.1.3...v0.3.2
 [0.3.1.2]: https://github.com/Comradery64/Agent-Decoder/compare/v0.3.1.1...v0.3.1.2

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-decoder
-Version: 0.3.5
+Version: 0.3.6
 Summary: A local web UI for browsing and analyzing AI coding assistant chat history
 Project-URL: Homepage, https://github.com/Comradery64/Agent-Decoder
 Project-URL: Repository, https://github.com/Comradery64/Agent-Decoder

agent_decoder-0.3.6/docs/agent-runs.md

@@ -0,0 +1,15 @@
+# Managed runs
+
+Open **Runs** in the sidebar (`#/runs`) to inspect managed Claude and Codex execution attempts. Search across session ID, directory, project, model and branch; filter by provider, state or exact project ID. Results use pages of 50. A run detail URL loads independently of the current page. Source links open the existing chat with its Decoded / Native controls; missing indexed chats retain their run history and show an unavailable-source explanation.
+
+A run represents **one managed process attempt**, spanning multiple prompts. It is not a task or an individual conversation turn. Historical indexed sessions do not become runs until managed execution is requested. Native rollout adoption changes the session ID while keeping the attempt ID. Reattaching to a verified surviving tmux process also keeps the attempt ID. A replaced or confirmed-absent process closes the old attempt with an unknown outcome (`blocked`, with `ended_at`) and creates a fresh attempt. Terminal records cannot be updated by later observations.
+
+States are `queued`, `starting`, `running`, `awaiting_input`, `blocked`, `completed`, `failed`, and `canceled`. Launch begins at `starting`; an attached transport remains `blocked` pending screen evidence. Successful decoded submission or native Enter records `running` with explicit input provenance. Native Enter does not prove what command was entered. Provider screen observations may indicate `awaiting_input`, `running`, or `blocked`, but are advisory: Claude's classifier defaults to idle, and native prompts are not reliable completion signals. Last-observed timestamps reflect real attach, input or screen observations, not a fabricated heartbeat. Old observations can be stale even if a transport remains attached.
+
+Explicit termination records `canceled` after the termination operation returns. Confirmed launch failure records `failed`. A capture/attach failure with a verified surviving pane leaves an active, recoverable `blocked` attempt. Disconnect or server restart marks an attempt `blocked` with an unobserved/detached explanation. Shutdown detaches tmux attempts; direct PTY shutdown closes an unknown-outcome attempt because its process is terminated. No prompt, idle screen, process exit (including exit 0), or disconnect records successful completion. There is deliberately no “finish” operation: this slice does not infer or automate task outcomes. `completed` and `queued` are contract foundations for later explicit outcome/queue features.
+
+The `agent_runs` SQLite table is independent of the rebuildable session index and has no cascading foreign key. Source indexing fills missing metadata while preserving recorded execution model/context. `task_id` and `parent_run_id` are explicitly nullable foundations; no task management, queue launch, or approval automation is implemented.
+
+`GET /api/runs` returns typed `AgentRun[]`; optional `provider`, `state`, `project`, and `q` filters apply before `limit` (1–500, default 200) and `offset`. `GET /api/runs/{run_id}` returns one record or 404. Both endpoints only inspect durable records and indexed metadata; they never start providers or claim execution locks.
+
+The execution manager writes lifecycle records before publishing `runs_changed` SSE notifications. Screen observations enter a manager-owned buffer directly from provider policy, rather than through a lossy SSE subscriber; the latest advisory observation is persisted every two seconds. The UI refreshes on confirmed-write notifications/reconnect and every 15 seconds to recover missed notifications. This is current-state history, not a complete event audit log. A partial unique index and immediate SQLite transaction prevent duplicate active attempts for a provider/session across independent store instances. Execution lifecycle operations and observation writes are serialized by the shared manager.

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/frontend/src/App.tsx

@@ -34,12 +34,14 @@ const settingsModalImport = () => import("./components/Settings/SettingsModal");
 // render a reload prompt in-place instead of crashing the whole ErrorBoundary.
 const Sidebar = lazyWithRetry(() => import("./components/Sidebar/Sidebar"));
 const ChatView = lazyWithRetry(chatViewImport);
+const Runs = lazyWithRetry(() => import("./components/Runs"));
 const Dashboard = lazyWithRetry(() => import("./components/Dashboard/Dashboard"));
 const SettingsModal = lazyWithRetry(settingsModalImport);
 const SearchOverlay = lazyWithRetry(searchOverlayImport);
 const HelpPopup = lazyWithRetry(() => import("./components/Sidebar/HelpPopup"));
 const ShortcutsPopup = lazyWithRetry(() => import("./components/Sidebar/ShortcutsPopup"));
 const FileViewer = lazyWithRetry(() => import("./components/FileViewer/FileViewer"));
+const ArtifactsPanel = lazyWithRetry(() => import("./components/ArtifactsPanel/ArtifactsPanel"));
 
 export default function App() {
   // Five individual selectors instead of `useAppStore()` without a selector —
@@ -275,6 +277,9 @@ export default function App() {
       } else if (e.key.toLowerCase() === "e" && e.metaKey) {
         e.preventDefault();
         useAppStore.getState().toggleResultsExpanded();
+      } else if (e.key.toLowerCase() === "a" && e.metaKey && e.shiftKey) {
+        e.preventDefault();
+        useAppStore.getState().toggleArtifacts();
       } else if (e.key.toLowerCase() === "b" && e.metaKey) {
         e.preventDefault();
         useAppStore.getState().toggleSidebar();
@@ -328,9 +333,16 @@ export default function App() {
         <Sidebar />
         <div style={{ flex: 1, display: "flex", minWidth: 200, overflow: "hidden" }}>
           <ErrorBoundary>
-            {chatIdFromUrl ? <ChatView /> : <Dashboard />}
+            {route.startsWith("/runs") ? <Runs /> : chatIdFromUrl ? <ChatView /> : <Dashboard />}
           </ErrorBoundary>
         </div>
+        {chatIdFromUrl && (
+          <ErrorBoundary>
+            <React.Suspense fallback={null}>
+              <ArtifactsPanel />
+            </React.Suspense>
+          </ErrorBoundary>
+        )}
         {viewingFilePath && (
           <ErrorBoundary>
             <React.Suspense fallback={<DelayedSkeleton />}>

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/frontend/src/api/client.ts

@@ -137,6 +137,8 @@ function patch<T>(path: string, body: unknown): Promise<T> {
 }
 
 export const api = {
+  getRuns: (params = "") => get<import("./types").AgentRun[]>(`/api/runs${params}`),
+  getRun: (id: string) => get<import("./types").AgentRun>(`/api/runs/${encodeURIComponent(id)}`),
   getProjects: () => get<Project[]>("/api/projects"),
   getProjectSessions: (projectId: string) =>
     get<Session[]>(`/api/projects/${encodeURIComponent(projectId)}/sessions`),

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/frontend/src/api/types.ts

@@ -591,3 +591,25 @@ export interface DashboardData {
   total_messages: number;
   tips: DashboardTip[];
 }
+
+/** A managed execution attempt; independent of indexed session lifetime. */
+export interface AgentRun {
+  id: string;
+  provider: string;
+  native_session_id: string;
+  model: string | null;
+  project_id: string | null;
+  cwd: string | null;
+  git_branch: string | null;
+  is_worktree: boolean;
+  task_id: string | null;
+  parent_run_id: string | null;
+  state: "queued" | "starting" | "running" | "awaiting_input" | "blocked" | "completed" | "failed" | "canceled";
+  reason: string;
+  provenance: string;
+  created_at: string;
+  updated_at: string;
+  last_observed_at: string | null;
+  ended_at: string | null;
+  source_available: boolean;
+}

agent_decoder-0.3.6/frontend/src/components/ArtifactsPanel/ArtifactsPanel.tsx

@@ -0,0 +1,191 @@
+import { useMemo, useState } from "react";
+import { useAppStore } from "../../store";
+import { useSessionDetail } from "../Messages/hooks/useSessionDetail";
+import { ScrollContainer } from "../ScrollContainer";
+import { type Artifact, type ArtifactGroup, extractArtifacts } from "../../utils/artifacts";
+import { blobUrl } from "../../utils/fileType";
+
+const WIDTH = 320;
+
+const FILTERS: Array<{ id: ArtifactGroup | "all"; label: string }> = [
+  { id: "all", label: "All" },
+  { id: "images", label: "Images" },
+  { id: "docs", label: "Docs" },
+  { id: "media", label: "Media" },
+  { id: "code", label: "Code" },
+];
+
+function basename(path: string): string {
+  return path.slice(path.lastIndexOf("/") + 1) || path;
+}
+
+function IconFile() {
+  return (
+    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
+      <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z" />
+      <polyline points="14 2 14 8 20 8" />
+    </svg>
+  );
+}
+
+function ArtifactCard({ artifact }: { artifact: Artifact }) {
+  const setViewingFilePath = useAppStore((s) => s.setViewingFilePath);
+  const setPendingScrollMessageId = useAppStore((s) => s.setPendingScrollMessageId);
+  const jump = () => setPendingScrollMessageId(artifact.messageId);
+  // File artifacts open in the file viewer; message images jump to their turn.
+  const open = artifact.kind === "file" ? () => setViewingFilePath(artifact.path) : jump;
+  const thumb =
+    artifact.kind === "image" ? artifact.src
+    : artifact.category === "image" ? blobUrl(artifact.path)
+    : null;
+  const label = artifact.kind === "file" ? basename(artifact.path) : "Image";
+
+  return (
+    <div
+      style={{
+        border: "1px solid var(--border-subtle)",
+        borderRadius: "var(--radius-md)",
+        overflow: "hidden",
+        background: "var(--bg-tool-block)",
+      }}
+    >
+      <button
+        type="button"
+        onClick={open}
+        title={artifact.kind === "file" ? artifact.path : "Jump to message"}
+        style={{
+          display: "flex",
+          alignItems: "center",
+          gap: "8px",
+          width: "100%",
+          padding: thumb ? 0 : "10px 12px",
+          background: "none",
+          border: "none",
+          cursor: "pointer",
+          color: "var(--text-secondary)",
+          textAlign: "left",
+        }}
+      >
+        {thumb ? (
+          <img
+            src={thumb}
+            alt={label}
+            loading="lazy"
+            style={{ display: "block", width: "100%", maxHeight: 360, objectFit: "contain", background: "var(--bg-base)" }}
+          />
+        ) : (
+          <>
+            <IconFile />
+            <span style={{ fontFamily: "var(--font-mono)", fontSize: "12px", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }}>
+              {label}
+            </span>
+          </>
+        )}
+      </button>
+      <div
+        style={{
+          display: "flex",
+          alignItems: "center",
+          justifyContent: "space-between",
+          gap: "8px",
+          padding: "4px 8px 4px 12px",
+          borderTop: "1px solid var(--border-subtle)",
+          fontSize: "11px",
+          color: "var(--text-tertiary)",
+        }}
+      >
+        <span style={{ overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }}>
+          {thumb ? label : artifact.group}
+        </span>
+        <button
+          type="button"
+          onClick={jump}
+          title="Jump to message"
+          style={{ background: "none", border: "none", cursor: "pointer", color: "inherit", fontSize: "11px", padding: "2px 4px", flexShrink: 0 }}
+        >
+          Show in chat ↗
+        </button>
+      </div>
+    </div>
+  );
+}
+
+export default function ArtifactsPanel() {
+  // Open state is read here, not in App, so toggling re-renders only this
+  // panel instead of the whole chat.
+  const open = useAppStore((s) => s.artifactsOpen);
+  const sessionId = useAppStore((s) => s.selectedSessionId);
+  // Re-key per session so the filter resets when switching chats.
+  return open && sessionId ? <ArtifactsList key={sessionId} sessionId={sessionId} /> : null;
+}
+
+function ArtifactsList({ sessionId }: { sessionId: string }) {
+  const { detail } = useSessionDetail(sessionId);
+  const toggleArtifacts = useAppStore((s) => s.toggleArtifacts);
+  const [filter, setFilter] = useState<ArtifactGroup | "all">("all");
+  const artifacts = useMemo(() => extractArtifacts(detail?.messages ?? []), [detail?.messages]);
+  const present = new Set(artifacts.map((a) => a.group));
+  const shown = filter === "all" ? artifacts : artifacts.filter((a) => a.group === filter);
+
+  return (
+    <aside
+      aria-label="Artifacts"
+      style={{
+        width: WIDTH,
+        flexShrink: 0,
+        display: "flex",
+        flexDirection: "column",
+        borderLeft: "1px solid var(--border-subtle)",
+        background: "var(--bg-base)",
+        minHeight: 0,
+      }}
+    >
+      <div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", padding: "12px 12px 8px 16px" }}>
+        <span style={{ fontSize: "13px", fontWeight: 600, color: "var(--text-primary)" }}>
+          Artifacts <span style={{ color: "var(--text-tertiary)", fontWeight: 400 }}>{artifacts.length}</span>
+        </span>
+        <button
+          type="button"
+          onClick={toggleArtifacts}
+          aria-label="Close artifacts"
+          title="Close artifacts"
+          style={{ background: "none", border: "none", cursor: "pointer", color: "var(--text-tertiary)", fontSize: "16px", padding: "0 4px" }}
+        >
+          ×
+        </button>
+      </div>
+      <div style={{ display: "flex", flexWrap: "wrap", gap: "4px", padding: "0 12px 8px 16px" }}>
+        {FILTERS.filter((f) => f.id === "all" || present.has(f.id)).map((f) => (
+          <button
+            key={f.id}
+            type="button"
+            onClick={() => setFilter(f.id)}
+            aria-pressed={filter === f.id}
+            style={{
+              fontSize: "11px",
+              padding: "3px 8px",
+              borderRadius: "999px",
+              border: "1px solid var(--border-subtle)",
+              cursor: "pointer",
+              background: filter === f.id ? "var(--bg-sidebar-hover)" : "none",
+              color: filter === f.id ? "var(--text-primary)" : "var(--text-tertiary)",
+            }}
+          >
+            {f.label}
+          </button>
+        ))}
+      </div>
+      <ScrollContainer style={{ flex: 1, minHeight: 0 }}>
+        <div style={{ display: "flex", flexDirection: "column", gap: "10px", padding: "4px 12px 16px 16px" }}>
+          {shown.length === 0 ? (
+            <div style={{ fontSize: "12px", color: "var(--text-tertiary)", padding: "24px 0", textAlign: "center" }}>
+              {detail ? "No artifacts in this session yet." : "Loading…"}
+            </div>
+          ) : (
+            shown.map((a) => <ArtifactCard key={a.key} artifact={a} />)
+          )}
+        </div>
+      </ScrollContainer>
+    </aside>
+  );
+}

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/frontend/src/components/ChatView/ConversationHeader.tsx

@@ -3,7 +3,7 @@ import type { PtyOwnership, Session } from "../../api/types";
 import { api } from "../../api/client";
 import { useAppStore } from "../../store";
 import { emit } from "../../utils/events";
-import { IconTerminal } from "../ui/icons";
+import { IconGallery, IconTerminal } from "../ui/icons";
 
 // Small status dot for the Phase-0 ownership badge. Inline-rendered
 // next to the model label so it doesn't disturb existing header layout.
@@ -98,6 +98,8 @@ export function ConversationHeader({
   const dropdownRef = useRef<HTMLDivElement>(null);
   const remoteClient = useAppStore((s) => s.hostInfo?.is_remote_client === true);
   const terminalDisabled = !session || session.is_fork || remoteClient;
+  const artifactsOpen = useAppStore((s) => s.artifactsOpen);
+  const toggleArtifacts = useAppStore((s) => s.toggleArtifacts);
   const terminalTitle = session?.is_fork
     ? "Open in terminal (fork — not resumable)"
     : remoteClient
@@ -286,6 +288,24 @@ export function ConversationHeader({
             </span>
           )}
 
+          <button
+            onClick={toggleArtifacts}
+            title="Artifacts (⇧⌘A)"
+            aria-label="Toggle artifacts panel"
+            aria-pressed={artifactsOpen}
+            style={{ ...btnBase, color: artifactsOpen ? "var(--text-primary)" : "var(--text-tertiary)" }}
+            onMouseEnter={(e) => {
+              (e.currentTarget as HTMLButtonElement).style.color = "var(--text-primary)";
+              (e.currentTarget as HTMLButtonElement).style.background = "var(--bg-sidebar-hover)";
+            }}
+            onMouseLeave={(e) => {
+              (e.currentTarget as HTMLButtonElement).style.color = artifactsOpen ? "var(--text-primary)" : "var(--text-tertiary)";
+              (e.currentTarget as HTMLButtonElement).style.background = "none";
+            }}
+          >
+            <IconGallery />
+          </button>
+
           {/* Export dropdown */}
           {session && (
             <div ref={dropdownRef} style={{ position: "relative" }}>

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/frontend/src/components/ChatView/__tests__/NativeTerminalView.test.tsx

@@ -74,6 +74,8 @@ const { fitDimensions, configSource, fitAddonInstances, terminalInstances, MockF
     // xterm exposes a unicode service; xtermTerminal.ts sets activeVersion and
     // the Unicode11 addon registers a provider against it.
     unicode = { activeVersion: "6", register: vi.fn() };
+    // createNativeTerminal registers a CSI handler (ESC[3J guard) on the parser.
+    parser = { registerCsiHandler: vi.fn() };
 
     constructor(options: Record<string, unknown>) {
       this.options = options;

agent_decoder-0.3.6/frontend/src/components/ChatView/nativeTerminal/__tests__/eraseScrollback.test.ts

@@ -0,0 +1,64 @@
+// @vitest-environment node
+import { describe, it, expect } from "vitest";
+import { createNativeTerminal, type NativeTerminalOptions } from "../xtermTerminal";
+
+const w = (t: ReturnType<typeof createNativeTerminal>, d: string) =>
+  new Promise<void>((r) => t.write(d, () => r()));
+
+async function scrolledTerminal() {
+  const t = createNativeTerminal({
+    cols: 120,
+    rows: 30,
+    scrollback: 5000,
+    allowProposedApi: true,
+  } as NativeTerminalOptions);
+  let s = "";
+  for (let i = 0; i < 400; i++) s += `line ${i}\r\n`;
+  await w(t, s);
+  return t;
+}
+const pos = (t: ReturnType<typeof createNativeTerminal>) => {
+  const b = t.buffer.active;
+  return { y: b.viewportY, base: b.baseY, scrollback: b.length - t.rows };
+};
+
+// Regression: xterm honors ESC[3J (erase scrollback) by wiping history AND
+// resetting the viewport to the bottom. A TUI that emits a full clear on a tall
+// repaint therefore yanks a reader who scrolled up back down "a few moments"
+// later and destroys what they were reading.
+describe("ESC[3J (erase scrollback) while the reader is scrolled up", () => {
+  it("is ignored: position and scrollback are preserved", async () => {
+    const t = await scrolledTerminal();
+    t.scrollLines(-100);
+    const before = pos(t);
+    await w(t, "\x1b[2J\x1b[3J\x1b[Hrepaint");
+    const after = pos(t);
+    expect(after.y).toBe(before.y);
+    expect(after.scrollback).toBeGreaterThanOrEqual(before.scrollback);
+    expect(after.y).toBeLessThan(after.base); // still not at the bottom
+  });
+
+  it("is ignored even when the sequence is split across two writes", async () => {
+    const t = await scrolledTerminal();
+    t.scrollLines(-100);
+    const before = pos(t);
+    await w(t, "\x1b[3");
+    await w(t, "Jrepaint");
+    expect(pos(t).y).toBe(before.y);
+    expect(pos(t).scrollback).toBeGreaterThanOrEqual(before.scrollback);
+  });
+
+  it("still clears scrollback when the reader is at the bottom (faithful /clear)", async () => {
+    const t = await scrolledTerminal(); // at the bottom: never scrolled up
+    await w(t, "\x1b[2J\x1b[3J\x1b[Hfresh");
+    expect(pos(t).scrollback).toBe(0);
+  });
+
+  it("does not affect other erase sequences", async () => {
+    const t = await scrolledTerminal();
+    t.scrollLines(-100);
+    const before = pos(t);
+    await w(t, "\x1b[2J\x1b[Hrepaint");
+    expect(pos(t).y).toBe(before.y);
+  });
+});

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/frontend/src/components/ChatView/nativeTerminal/xtermTerminal.ts

@@ -10,7 +10,23 @@ export type NativeTerminalOptions = ITerminalOptions;
 export type { ITheme };
 
 export function createNativeTerminal(options: NativeTerminalOptions): NativeTerminal {
-  return new Terminal(options);
+  const terminal = new Terminal(options);
+  // ESC[3J ("erase scrollback") makes xterm wipe the history AND reset the
+  // viewport to the bottom. A TUI that does a full clear on a tall repaint
+  // would otherwise yank a reader who scrolled up back down a few moments
+  // later and destroy what they were reading. Swallow it only while scrolled
+  // up; at the bottom it passes through, so a real /clear still clears. Using
+  // the parser hook (not a byte filter) means sequences split across PTY
+  // chunks are handled by xterm itself.
+  terminal.parser.registerCsiHandler({ final: "J" }, (params) => {
+    if (params[0] !== 3) return false;
+    const b = terminal.buffer.active;
+    const scrolledUp = b.viewportY < b.baseY;
+    // Diagnostic (no content): confirms in DevTools that the TUI really sends it.
+    if (scrolledUp) console.info("agent-decoder: ignored ESC[3J (erase scrollback) while scrolled up");
+    return scrolledUp; // true = handled (swallowed)
+  });
+  return terminal;
 }
 
 export function createNativeFitAddon(): NativeFitAddon {

{agent_decoder-0.3.5 → agent_decoder-0.3.6}/frontend/src/components/Messages/TextBlock.tsx

@@ -226,19 +226,41 @@ interface TextBlockProps {
   style?: CSSProperties;
 }
 
+// One highlighter shared by every block. rehype-highlight builds a lowlight
+// instance (registering ~37 languages) each time its attacher runs, and
+// react-markdown runs attachers on every render — that alone cost ~0.5s per
+// session switch on long chats.
+const highlight = rehypeHighlight({ detect: true });
+const remarkPlugins = [remarkGfm];
+const rehypePlugins = [() => highlight];
+
+// Rendered markdown keyed by source text, so re-renders and switching back to
+// a session skip parsing + highlighting. ReactMarkdown (sync) is a pure
+// function, so its output is safe to reuse. Map order gives LRU eviction.
+const MAX_CACHED = 3000;
+const renderedByText = new Map<string, ReactElement>();
+
+function renderMarkdown(text: string): ReactElement {
+  let el = renderedByText.get(text);
+  if (el) {
+    renderedByText.delete(text);
+  } else {
+    el = ReactMarkdown({ remarkPlugins, rehypePlugins, components, children: text });
+    if (renderedByText.size >= MAX_CACHED) {
+      renderedByText.delete(renderedByText.keys().next().value!);
+    }
+  }
+  renderedByText.set(text, el);
+  return el;
+}
+
 export function TextBlock({ text, className, style }: TextBlockProps) {
   return (
     <div
       className={["prose-content", className].filter(Boolean).join(" ")}
       style={style}
     >
-      <ReactMarkdown
-        remarkPlugins={[remarkGfm]}
-        rehypePlugins={[[rehypeHighlight, { detect: true, ignoreMissing: true }]]}
-        components={components}
-      >
-        {text}
-      </ReactMarkdown>
+      {renderMarkdown(text)}
     </div>
   );
 }

agent_decoder-0.3.6/frontend/src/components/Runs.css

@@ -0,0 +1,26 @@
+.runs-page { padding: 28px; overflow: auto; flex: 1; min-width: 0; color: var(--text-primary); font-family: var(--font-ui); }
+.runs-page header, .runs-filters, .runs-list, .runs-pagination, .run-detail { max-width: 1100px; margin-inline: auto; }
+.runs-page header p, .run-muted, .runs-page small, .run-detail dt { color: var(--text-secondary); }
+.runs-page h1 { font-size: 26px; margin-top: 0; }
+.runs-page h2 { font-size: 18px; margin: 0; }
+.runs-page p { line-height: 1.5; }
+.runs-page a { color: var(--text-accent); text-underline-offset: 3px; }
+.runs-filters { display: flex; align-items: end; gap: 12px; flex-wrap: wrap; margin-block: 24px; }
+.runs-filters label { display: grid; gap: 6px; flex: 1 1 140px; font-size: 12px; }
+.runs-page input, .runs-page select, .runs-page button { font: inherit; color: var(--text-primary); background: var(--bg-input); border: 1px solid var(--border-default); border-radius: var(--radius-sm); padding: 8px 10px; min-height: 36px; min-width: 0; }
+.runs-page input, .runs-page select { width: 100%; box-sizing: border-box; }
+.runs-page button { cursor: pointer; }
+.runs-page button:hover:not(:disabled) { background: var(--bg-sidebar-hover); }
+.runs-page button:disabled { opacity: .45; cursor: default; }
+.runs-page :focus-visible { outline: 2px solid var(--border-accent); outline-offset: 2px; }
+.runs-list { display: grid; gap: 12px; }
+.run-card { border: 1px solid var(--border-default); border-radius: var(--radius-md); padding: 18px; overflow-wrap: anywhere; background: var(--bg-base); }
+.run-card-title { display: flex; justify-content: space-between; align-items: center; flex-wrap: wrap; gap: 10px; }
+.run-state { font-size: 12px; border: 1px solid var(--border-default); padding: 3px 8px; border-radius: 20px; }
+.run-state-blocked, .run-state-failed { color: var(--tool-error-text); }
+.run-detail { box-sizing: border-box; margin-bottom: 20px; }
+.run-detail dl { display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 14px 24px; }
+.run-detail dt { font-size: 12px; margin-bottom: 4px; }
+.run-detail dd { margin: 0; font-size: 13px; }
+.runs-pagination { display: flex; align-items: center; justify-content: center; gap: 16px; padding-block: 20px; }
+@media (max-width: 600px) { .runs-page { padding: 16px; } .run-card { padding: 14px; } .run-detail dl { grid-template-columns: 1fr; } }