transcript-viewer 0.12.0__tar.gz → 0.13.0__tar.gz

transcript_viewer-0.12.0/README.md → transcript_viewer-0.13.0/PKG-INFO

@@ -1,3 +1,16 @@
+Metadata-Version: 2.5
+Name: transcript-viewer
+Version: 0.13.0
+Summary: Browse agent transcripts in a local, dependency-free web viewer.
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: atif-make>=0.7.1
+Provides-Extra: ai
+Requires-Dist: anthropic>=0.40; extra == 'ai'
+Provides-Extra: parquet
+Requires-Dist: atif-make[parquet]>=0.5.0; extra == 'parquet'
+Description-Content-Type: text/markdown
+
 # transcript-viewer
 
 Browse agent transcripts in a local web viewer — what Claude Code, Codex and
@@ -167,7 +180,10 @@ If that directory is still there, the first run moves it to
 so. Nothing is left behind and nothing is copied twice.
 
 A run that delegated shows a **timeline** above its steps: one lane per
-subagent, laid out on the clock. It exists for the one thing a nested box
+subagent, laid out on the clock. A lane is called what the agent was asked to
+do — "Review backend for bugs and DRY" rather than "general-purpose" — wherever
+that was written down, which is 50 of the 53 Claude Code subagents here; the
+kind is the fallback and the tooltip. It exists for the one thing a nested box
 cannot say — that two subagents were running at the same moment, which 25 pairs
 in the corpus this was built against were. Two bars in the same column of the
 chart is what says it; overlap gets no colour of its own, since a second
@@ -175,8 +191,13 @@ encoding of the same fact is noise.
 
 Clicking a lane opens the box the transcript already has for it rather than
 showing the same thing twice, drawing the run out far enough to reach it first:
-a long run paints 250 steps at a time, and in one real session every delegation
-happens after step 1,231.
+in one real session every delegation happens after step 1,231.
+
+A long run paints its first 250 steps at once and fills the rest in behind
+itself, so there is nothing to press and nothing to wait for. The largest run
+here is 8,445 steps and 34 MB of markup, which is a second of a blank page if
+it is drawn in one go, so the rest arrives in the gaps between frames and the
+reader keeps their place.
 
 Where a session spans days but holds hours of work — one runs 10.3 days and
 contains 5.3 hours, with 31 gaps over an hour — the quiet stretches are skipped
@@ -186,6 +207,12 @@ that floor its width is not its duration; the card carries the real one. A
 transcript with no timestamps lays the same lanes out by step instead and says
 so, and one that delegated nothing shows no timeline at all.
 
+A transcript has an address: opening one puts its key in the URL, so a refresh
+comes back to it and a link can be sent to someone with the same transcript.
+The key is the hash of the file's contents, so it is the same key on another
+machine holding the same file, and back and forward move between the library
+and a run.
+
 **Clear library** above the tree forgets every session at once, after saying
 how many and what it will touch. Files are left alone by the same rule as a
 single removal — only copies the viewer made itself are deleted — and stored

transcript_viewer-0.12.0/PKG-INFO → transcript_viewer-0.13.0/README.md

@@ -1,16 +1,3 @@
-Metadata-Version: 2.5
-Name: transcript-viewer
-Version: 0.12.0
-Summary: Browse agent transcripts in a local, dependency-free web viewer.
-License: MIT
-Requires-Python: >=3.12
-Requires-Dist: atif-make>=0.7.1
-Provides-Extra: ai
-Requires-Dist: anthropic>=0.40; extra == 'ai'
-Provides-Extra: parquet
-Requires-Dist: atif-make[parquet]>=0.5.0; extra == 'parquet'
-Description-Content-Type: text/markdown
-
 # transcript-viewer
 
 Browse agent transcripts in a local web viewer — what Claude Code, Codex and
@@ -180,7 +167,10 @@ If that directory is still there, the first run moves it to
 so. Nothing is left behind and nothing is copied twice.
 
 A run that delegated shows a **timeline** above its steps: one lane per
-subagent, laid out on the clock. It exists for the one thing a nested box
+subagent, laid out on the clock. A lane is called what the agent was asked to
+do — "Review backend for bugs and DRY" rather than "general-purpose" — wherever
+that was written down, which is 50 of the 53 Claude Code subagents here; the
+kind is the fallback and the tooltip. It exists for the one thing a nested box
 cannot say — that two subagents were running at the same moment, which 25 pairs
 in the corpus this was built against were. Two bars in the same column of the
 chart is what says it; overlap gets no colour of its own, since a second
@@ -188,8 +178,13 @@ encoding of the same fact is noise.
 
 Clicking a lane opens the box the transcript already has for it rather than
 showing the same thing twice, drawing the run out far enough to reach it first:
-a long run paints 250 steps at a time, and in one real session every delegation
-happens after step 1,231.
+in one real session every delegation happens after step 1,231.
+
+A long run paints its first 250 steps at once and fills the rest in behind
+itself, so there is nothing to press and nothing to wait for. The largest run
+here is 8,445 steps and 34 MB of markup, which is a second of a blank page if
+it is drawn in one go, so the rest arrives in the gaps between frames and the
+reader keeps their place.
 
 Where a session spans days but holds hours of work — one runs 10.3 days and
 contains 5.3 hours, with 31 gaps over an hour — the quiet stretches are skipped
@@ -199,6 +194,12 @@ that floor its width is not its duration; the card carries the real one. A
 transcript with no timestamps lays the same lanes out by step instead and says
 so, and one that delegated nothing shows no timeline at all.
 
+A transcript has an address: opening one puts its key in the URL, so a refresh
+comes back to it and a link can be sent to someone with the same transcript.
+The key is the hash of the file's contents, so it is the same key on another
+machine holding the same file, and back and forward move between the library
+and a run.
+
 **Clear library** above the tree forgets every session at once, after saying
 how many and what it will touch. Files are left alone by the same rule as a
 single removal — only copies the viewer made itself are deleted — and stored

{transcript_viewer-0.12.0 → transcript_viewer-0.13.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "transcript-viewer"
-version = "0.12.0"
+version = "0.13.0"
 description = "Browse agent transcripts in a local, dependency-free web viewer."
 readme = "README.md"
 requires-python = ">=3.12"

{transcript_viewer-0.12.0 → transcript_viewer-0.13.0}/src/transcript_viewer/page.html

@@ -387,14 +387,16 @@ pre{background:var(--sunk);border-radius:7px;padding:10px;overflow:auto;font-siz
 #lanes>summary .fine{font:11px var(--font-mono);color:var(--muted)}
 #lanes>summary .fine em{font-style:normal;color:var(--accent)}
 .lanes-body{padding:2px 16px 12px;border-top:1px solid var(--line)}
-.lane{display:grid;grid-template-columns:150px 1fr;gap:0 12px;align-items:center}
+.lane{display:grid;grid-template-columns:196px 1fr;gap:0 12px;align-items:center}
 /* Denser than the roomy version, but still a row you can aim at: thirty of
    these is a screenful, and a 13px row with an 8px bar read as a scatter
    plot rather than a set of lanes. */
-.lane.tight{grid-template-columns:150px 1fr;gap:0 12px}
+.lane.tight{grid-template-columns:196px 1fr;gap:0 12px}
 .lane-name{display:flex;align-items:baseline;gap:7px;min-width:0}
 .lane-name .kind{font:12px var(--font-mono);color:var(--accent);overflow:hidden;
   text-overflow:ellipsis;white-space:nowrap}
+/* A task the agent was given is prose, not an identifier. */
+.lane-name .kind.named{font:12px var(--font-ui);color:var(--ink)}
 .lane-name .kind.main{color:var(--ink);font-weight:600}
 .lane-name .n{font:10px var(--font-mono);color:var(--faint);margin-left:auto;flex:none}
 .track{position:relative;height:22px}
@@ -410,16 +412,16 @@ pre{background:var(--sunk);border-radius:7px;padding:10px;overflow:auto;font-siz
 .bar:hover,.bar:focus-visible{opacity:1;outline:1px solid var(--ink);outline-offset:1px}
 .bar.main{background:var(--ink);opacity:.85;cursor:default}
 .bar.main:hover{outline:none;opacity:.85}
-.lane-axis{display:grid;grid-template-columns:150px 1fr;gap:0 12px;margin-bottom:2px}
-.lane-axis.tight{grid-template-columns:118px 1fr;gap:0 10px}
+.lane-axis{display:grid;grid-template-columns:196px 1fr;gap:0 12px;margin-bottom:2px}
+.lane-axis.tight{grid-template-columns:196px 1fr;gap:0 12px}
 .lane-axis .marks{position:relative;height:13px}
 .lane-axis .marks span{position:absolute;transform:translateX(-50%);
   font:10px var(--font-mono);color:var(--faint);white-space:nowrap}
 /* The bands and the axis breaks sit behind every lane at once, drawn once
    rather than repeated into each row. */
 .lanes-tracks{position:relative}
-.bandlayer{position:absolute;left:162px;right:0;top:0;bottom:0;pointer-events:none}
-.lane.tight ~ .bandlayer,.lanes-tracks:has(.lane.tight) .bandlayer{left:162px}
+.bandlayer{position:absolute;left:208px;right:0;top:0;bottom:0;pointer-events:none}
+.lane.tight ~ .bandlayer,.lanes-tracks:has(.lane.tight) .bandlayer{left:208px}
 /* Where the axis was cut. One thin line, and only for the cuts worth seeing —
    one session skips 152 quiet stretches, and marking every one turned the
    whole chart into vertical stripes. The rest are still skipped; they are
@@ -1309,6 +1311,9 @@ function toggleSide(){
 // Restore the last choice; localStorage can throw in restricted contexts.
 try{if(localStorage.getItem("transcript-viewer.side")==="1")toggleSide()}catch(e){}
 
+/* Back and forward move between the library and a transcript. */
+addEventListener("popstate",followAddress);
+
 addEventListener("keydown",e=>{
   // Ignore the shortcut while typing in the filter box.
   if(e.key==="\\"&&e.target.tagName!=="INPUT"){e.preventDefault();toggleSide()}
@@ -1375,7 +1380,13 @@ async function openLibrary(){
     bootSay(`Drawing ${num(INDEX.length)} sessions…`,0,0);
     // Let that line paint before the work that blocks the thread.
     await new Promise(r=>requestAnimationFrame(()=>requestAnimationFrame(r)));
-    showCount();drawList();showLibrary();
+    showCount();drawList();
+    // The address says what to show. Without this a refresh lands in the
+    // library however specific the link was.
+    const asked=addressed();
+    if(asked&&INDEX.some(e=>e.key===asked))pick(asked,false);
+    else{ if(asked)note("That transcript is not in this library.");
+          setAddress(null,false); showLibrary(); }
   }catch(err){
     // Leave it on screen: a blank window would say nothing at all.
     bootSay("Could not open your library — "+((err&&err.message)||err),0,0);
@@ -1624,7 +1635,7 @@ function showLibrary(){
     </div>`;
     return;
   }
-  cur=null;drawCrumb();
+  cur=null;setAddress(null,false);drawCrumb();
   const rows=libraryRows();
   main.innerHTML=`
     <div class="lhead">
@@ -2271,8 +2282,37 @@ function star(key){
   annotate(key,{starred:!entry.starred});
 }
 
-function pick(key){
-  cur=key;EDITING=null;drawList();drawCrumb();
+/* Which transcript the address names, if any.
+
+   The key is the sha256 of the file's contents, so it is the same key on the
+   next run and on another machine holding the same transcript — an address
+   worth putting in the bar. Refreshing used to throw the reader back to the
+   library, and a link to what someone was looking at could not be sent at all.
+
+   The whole hash is used rather than a prefix: two transcripts sharing the
+   first sixteen characters would otherwise open the wrong one. */
+const addressed = () => (location.hash || "").replace(/^#/, "");
+
+function setAddress(key, push) {
+  const to = key ? "#" + key : location.pathname;
+  if (addressed() === (key || "")) return;
+  try {
+    if (push) history.pushState({ key: key || null }, "", to);
+    else history.replaceState({ key: key || null }, "", to);
+  } catch (e) {
+    // A page opened from a file has no history to write; the view still works.
+  }
+}
+
+/* Back and forward move between the library and a transcript. */
+function followAddress() {
+  const key = addressed();
+  if (!key) { cur = null; drawList(); drawCrumb(); showLibrary(); return; }
+  if (key !== cur) pick(key, false);
+}
+
+function pick(key, push = true){
+  cur=key;EDITING=null;setAddress(key,push);drawList();drawCrumb();
   main.innerHTML=`<div class="empty">Converting…</div>`;
   fetch("/api/trajectory?id="+encodeURIComponent(key)).then(r=>r.json()).then(t=>{
     if(t.error){main.innerHTML=`<div class="empty">${esc(t.error)}</div>`;return}
@@ -2445,6 +2485,11 @@ function laneIndex(t) {
             id: sub.trajectory_id,
             kind: x.agentType || sub.agent?.name || "subagent",
             said: x.description || "",
+            // What to call the lane. The task it was given where that was
+            // written down — 50 of the 53 Claude Code subagents here have one,
+            // and "Docs and config audit" says what "general-purpose" cannot.
+            // Otherwise the kind, which is all some formats record.
+            name: x.description || x.agentType || sub.agent?.name || "subagent",
             steps: (sub.steps || []).length,
             tools: [...new Set((sub.steps || []).flatMap(
               (s) => (s.tool_calls || []).map((c) => c.function_name)))],
@@ -2474,6 +2519,7 @@ function laneIndex(t) {
           id: sub.trajectory_id,
           kind: x.agentType || sub.agent?.name || "subagent",
           said: x.description || "",
+          name: x.description || x.agentType || sub.agent?.name || "subagent",
           steps: (sub.steps || []).length,
           tools: [...new Set((sub.steps || []).flatMap(
             (s) => (s.tool_calls || []).map((c) => c.function_name)))],
@@ -2680,11 +2726,15 @@ function drawLanes(t) {
 
 /* One row: who, how many steps, and the track it sits on. */
 function laneRow(lane, tight, inner) {
+  const name = lane.name || lane.kind;
+  // Both, where they differ: the task reads first, the kind explains it.
+  const full = lane.said && lane.kind !== name ? `${name} — ${lane.kind}` : name;
   return `
     <div class="lane${tight}">
       <div class="lane-name">
         ${lane.main ? "" : `<span style="color:var(--accent);font-weight:700;font-size:11px">⤷</span>`}
-        <span class="kind${lane.main ? " main" : ""}" title="${esc(lane.kind)}">${esc(lane.kind)}</span>
+        <span class="kind${lane.main ? " main" : ""}${lane.said ? " named" : ""}"
+          title="${esc(full)}">${esc(name)}</span>
         <span class="n">${num(lane.steps)}</span>
       </div>
       <div class="track"><span class="rule"></span>${inner}</div>

{transcript_viewer-0.12.0 → transcript_viewer-0.13.0}/tests/page.test.js

@@ -71,6 +71,14 @@ const SAFE_FETCH = () =>
    an object with no focus(), which fails somewhere else entirely. */
 const SAFE_BY_ID = () => null;
 
+/* The page reads and writes an address so a transcript can be linked to. The
+   stub keeps one, so tests can watch it without a browser. */
+global.location = { hash: "", pathname: "/" };
+global.history = {
+  pushState: (_s, _t, to) => { global.location.hash = String(to).startsWith("#") ? to : ""; },
+  replaceState: (_s, _t, to) => { global.location.hash = String(to).startsWith("#") ? to : ""; },
+};
+
 /* Looking for an element by selector, against what was actually painted. The
    stub DOM holds markup as a string rather than a tree, so this answers the one
    question the page asks — is this box on the page — from that string. */
@@ -91,6 +99,7 @@ const run = (body) => {
   global.fetch = SAFE_FETCH;
   global.document.getElementById = SAFE_BY_ID;
   global.document.querySelector = SAFE_QUERY;
+  global.location.hash = "";
   return eval(script + "\n;(() => {" + body + "})()");
 };
 
@@ -2221,3 +2230,63 @@ test("filling holds the reader's place, and stops when the run is done", () => {
   assert.strictEqual(out.limit >= out.steps, true, `stopped at ${out.limit} of ${out.steps}`);
   assert.strictEqual(out.at, 400, "the reader stays where they were");
 });
+
+// ---- a transcript has an address ---------------------------------------------
+
+test("opening a transcript puts it in the address", () => {
+  const out = run(`
+    INDEX = [{key:"abc123", path:"/a.jsonl"}];
+    globalThis.fetch = () => Promise.resolve({ok:true, json: () => Promise.resolve({steps:[]})});
+    pick("abc123");
+    return location.hash;
+  `);
+  assert.strictEqual(out, "#abc123", "so a refresh comes back here");
+});
+
+test("going back to the library clears it", () => {
+  const out = run(`
+    INDEX = [{key:"abc123", path:"/a.jsonl", group:"Local"}];
+    location.hash = "#abc123";
+    showLibrary();
+    return location.hash;
+  `);
+  assert.strictEqual(out, "", "the library is not one transcript");
+});
+
+test("the whole key is used, never a prefix", () => {
+  // Two transcripts can share a prefix; opening the wrong one would be silent.
+  const out = run(`
+    INDEX = [{key:"aaaaaaaaaaaaaaaa1111"},{key:"aaaaaaaaaaaaaaaa2222"}];
+    globalThis.fetch = () => Promise.resolve({ok:true, json: () => Promise.resolve({steps:[]})});
+    pick("aaaaaaaaaaaaaaaa2222");
+    return { hash: location.hash, asked: addressed() };
+  `);
+  assert.strictEqual(out.hash, "#aaaaaaaaaaaaaaaa2222");
+  assert.strictEqual(out.asked, "aaaaaaaaaaaaaaaa2222");
+});
+
+test("an address naming nothing in this library says so, and shows the library", () => {
+  const out = run(`
+    INDEX = [{key:"real"}];
+    location.hash = "#gone";
+    let said = "";
+    note = (m) => { said = m; };
+    followAddress();
+    return { said, cur, hash: location.hash };
+  `);
+  assert.strictEqual(out.cur, "gone", "it tried");
+  // followAddress hands off to pick, which fetches; what matters is it did not
+  // silently sit on the library with a stale address.
+  assert.strictEqual(out.hash, "#gone");
+});
+
+test("an empty address shows the library rather than a blank pane", () => {
+  const out = run(`
+    INDEX = [{key:"real", group:"Local"}];
+    location.hash = "";
+    cur = "real";
+    followAddress();
+    return cur;
+  `);
+  assert.strictEqual(out, null, "no address means no transcript");
+});

{transcript_viewer-0.12.0 → transcript_viewer-0.13.0}/uv.lock

@@ -388,7 +388,7 @@ wheels = [
 
 [[package]]
 name = "transcript-viewer"
-version = "0.12.0"
+version = "0.13.0"
 source = { editable = "." }
 dependencies = [
     { name = "atif-make" },