Files
Codeman/src/web/public/story-mode.js
T
Codeman maintainer 2653db10b5 feat(story-mode): draw a Claude session's turns as comic pages, live
Story Mode is an opt-in header button (showStoryButton, per device, default
off, kept off phones) that opens the active Claude Code session as comic pages:
one page per prompt, panels for reading code, planning, helpers, edits, tests
(POW/KRAK), questions and saving, each with a plain story caption and a
Director's cut caption naming the tools. Files open in the existing file
preview, the code page opens the exact diff, a test board opens the output,
and a running turn redraws as Claude works.

Server: GET /api/sessions/:id/story (experimental) reads a bounded tail of the
session's own transcript. A pure core (src/story-mode.ts) reduces lines,
joins tool calls with their results, splits turns at prompts and
turn_duration, and groups events into at most 12 panels; Bash calls are
sorted by what the command does. The reader (src/story-reader.ts) caches
reduced entries and reads only appended bytes while the file grows.

Frontend: story-mode.js (canvas frame engine, live refresh from transcript and
hook SSE events plus a poll while a turn runs, details drawer, the wire) and
story-mode.css, with two self-hosted OFL comic fonts.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-18 09:22:06 +02:00

2390 lines
83 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* @fileoverview Story Mode: the active Claude Code session's turns drawn as comic pages, live.
*
* Opt-in header button (`showStoryButton`, per-device, default OFF; hidden on phones by mobile.css).
* The overlay asks `GET /api/sessions/:id/story` for one turn as a page of panels (server:
* src/story-mode.ts + src/web/routes/story-routes.ts) and redraws when the session shows activity:
* the transcript tool events and the stop / prompt-submitted hooks (app.js connectSSE registers
* them and calls `_storyOnActivity`), plus a slow poll while the turn is still running, since a
* transcript line can land without any of those events. One request in flight at a time, debounced.
*
* Every panel is a canvas drawn by a small frame engine in the style of Remotion: a scene is a pure
* function of its frame number, with `interpolate` and `spring` helpers. New panels animate in from
* frame 0; panels that were already there keep their clock, so a live refresh never restarts them.
* Under `prefers-reduced-motion` every panel is drawn once, at its finished frame.
*
* ⚠️ Everything on the page comes from the agent's transcript and is untrusted: it is written with
* `textContent` only, and the containers carry `data-i18n-skip`. A file path opens through the
* existing `openFilePreview()` (workspace confinement, attachment routes for outside paths, remote
* hosts), never a new file route; editing goes through the file viewer's own edit mode.
* ⚠️ The overlay owns Escape while it is open (a window capture listener runs before app.js's
* document listener): the drawer closes first, then the overlay, and nothing closes while the file
* preview or folder grid is open on top of it.
*
* @mixin Extends CodemanApp.prototype via Object.assign
* @dependency app.js (this.activeSessionId, this.sessions, this.loadAppSettingsFromStorage, this.getDefaultSettings)
* @dependency api-client.js (_api), panels-ui.js (openFilePreview), constants.js (findFilePathLinks, resolveLinkedFilePath)
* @loadorder 12.58 of 16, after git-status-ui.js, before entrance-animations.js
*/
/** Activity bursts (one tool call fires start and end) collapse into one refresh. */
const STORY_REFRESH_DEBOUNCE_MS = 800;
/** While a turn runs, refresh this often even without events (text lines raise none). */
const STORY_POLL_MS = 4000;
/**
* The comic engine: drawing kit, the agent character and one scene per panel kind. Pure drawing;
* no DOM beyond the canvas it is handed. `hit()` records clickable regions in virtual units.
*/
const StoryArt = (() => {
const FPS = 30;
const HERO = 72;
const VH = 260;
const TAU = Math.PI * 2;
const DISPLAY = "'Codeman Story Display', Impact, 'Arial Black', sans-serif";
const LETTER = "'Codeman Story Letter', 'Comic Sans MS', 'Chalkboard SE', cursive";
const MONO = "'JetBrains Mono', ui-monospace, Menlo, monospace";
const C = {};
const clamp = (v, a, b) => Math.min(b, Math.max(a, v));
const easeOut = (t) => 1 - Math.pow(1 - t, 3);
function interpolate(x, [a, b], [c, d], ease) {
let t = clamp((x - a) / (b - a), 0, 1);
if (ease) t = ease(t);
return c + (d - c) * t;
}
function spring(f, { damping = 10, stiffness = 100, mass = 1 } = {}) {
if (f <= 0) return 0;
const w0 = Math.sqrt(stiffness / mass);
const z = damping / (2 * Math.sqrt(stiffness * mass));
const t = f / FPS;
if (z < 1) {
const wd = w0 * Math.sqrt(1 - z * z);
return 1 - Math.exp(-z * w0 * t) * (Math.cos(wd * t) + ((z * w0) / wd) * Math.sin(wd * t));
}
return 1 - Math.exp(-w0 * t) * (1 + w0 * t);
}
const rnd = (i) => {
const x = Math.sin(i * 127.1 + 311.7) * 43758.5453;
return x - Math.floor(x);
};
const TOKENS = ['panel', 'ink', 'line', 'cyan', 'magenta', 'yellow', 'go', 'balloon', 'balloon-ink'];
function readColors(root) {
const cs = getComputedStyle(root);
for (const t of TOKENS)
C[t.replace(/-(\w)/g, (_, c) => c.toUpperCase())] = cs.getPropertyValue(`--story-${t}`).trim();
C.key = TOKENS.map((t) => cs.getPropertyValue(`--story-${t}`).trim()).join('|');
}
// ── Drawing kit ──
function rr(ctx, x, y, w, h, r) {
ctx.beginPath();
if (ctx.roundRect) {
ctx.roundRect(x, y, w, h, r);
return;
}
r = Math.min(r, w / 2, h / 2);
ctx.moveTo(x + r, y);
ctx.arcTo(x + w, y, x + w, y + h, r);
ctx.arcTo(x + w, y + h, x, y + h, r);
ctx.arcTo(x, y + h, x, y, r);
ctx.arcTo(x, y, x + w, y, r);
ctx.closePath();
}
function inked(ctx, fill, lw = 3) {
if (fill) {
ctx.fillStyle = fill;
ctx.fill();
}
ctx.lineWidth = lw;
ctx.strokeStyle = C.line;
ctx.stroke();
}
function base(ctx, W, H) {
ctx.fillStyle = C.panel;
ctx.fillRect(0, 0, W, H);
}
function halftone(ctx, W, H, color, fx, fy, { cell = 9, rmax = 3.6, reach = 1, alpha = 1 } = {}) {
const diag = Math.hypot(W, H) * reach;
const R = Math.hypot(W, H) / 2 + cell;
const k = Math.SQRT1_2;
ctx.save();
ctx.globalAlpha = alpha;
ctx.fillStyle = color;
ctx.beginPath();
for (let gy = -R; gy <= R; gy += cell) {
for (let gx = -R; gx <= R; gx += cell) {
const ux = gx * k - gy * k + W / 2;
const uy = gx * k + gy * k + H / 2;
if (ux < -cell || uy < -cell || ux > W + cell || uy > H + cell) continue;
const r = rmax * (1 - Math.hypot(ux - fx, uy - fy) / diag);
if (r < 0.4) continue;
ctx.moveTo(ux + r, uy);
ctx.arc(ux, uy, r, 0, TAU);
}
}
ctx.fill();
ctx.restore();
}
function rays(ctx, W, H, cx, cy, n, color, alpha = 1, rot = 0) {
const R = Math.hypot(W, H) * 1.2;
ctx.save();
ctx.globalAlpha = alpha;
ctx.fillStyle = color;
ctx.beginPath();
for (let i = 0; i < n; i++) {
const a0 = rot + (i / n) * TAU;
const a1 = rot + ((i + 0.5) / n) * TAU;
ctx.moveTo(cx, cy);
ctx.lineTo(cx + R * Math.cos(a0), cy + R * Math.sin(a0));
ctx.lineTo(cx + R * Math.cos(a1), cy + R * Math.sin(a1));
ctx.closePath();
}
ctx.fill();
ctx.restore();
}
function focusLines(ctx, W, H, cx, cy, n, color, alpha) {
const R = Math.hypot(W, H);
ctx.save();
ctx.globalAlpha = alpha;
ctx.strokeStyle = color;
for (let i = 0; i < n; i++) {
const a = (i / n) * TAU + rnd(i) * 0.05;
const r0 = 104 + rnd(i + 50) * 70;
ctx.lineWidth = 0.6 + rnd(i + 20) * 1.8;
ctx.beginPath();
ctx.moveTo(cx + Math.cos(a) * r0, cy + Math.sin(a) * r0);
ctx.lineTo(cx + Math.cos(a) * R, cy + Math.sin(a) * R);
ctx.stroke();
}
ctx.restore();
}
function burst(ctx, cx, cy, ro, ri, n, fill, rot = 0, seed = 1) {
ctx.beginPath();
for (let i = 0; i < n * 2; i++) {
const a = rot + (i / (n * 2)) * TAU;
const r = i % 2 ? ri : ro * (0.82 + rnd(i + seed) * 0.3);
const px = cx + Math.cos(a) * r;
const py = cy + Math.sin(a) * r;
if (i) ctx.lineTo(px, py);
else ctx.moveTo(px, py);
}
ctx.closePath();
ctx.lineJoin = 'miter';
inked(ctx, fill, 3.5);
ctx.lineJoin = 'round';
}
function fitSize(ctx, text, maxW, maxSize) {
ctx.font = `100px ${DISPLAY}`;
return Math.min(maxSize, (maxW / Math.max(1, ctx.measureText(text).width)) * 100);
}
function sfx(ctx, text, x, y, size, fill, rot = 0, scale = 1) {
if (scale <= 0.01) return;
ctx.save();
ctx.translate(x, y);
ctx.rotate(rot);
ctx.scale(scale, scale);
ctx.font = `${size}px ${DISPLAY}`;
ctx.textAlign = 'center';
ctx.textBaseline = 'middle';
ctx.lineJoin = 'round';
ctx.fillStyle = C.line;
ctx.fillText(text, size * 0.08, size * 0.08);
ctx.lineWidth = size * 0.14;
ctx.strokeStyle = C.line;
ctx.strokeText(text, 0, 0);
ctx.fillStyle = fill;
ctx.fillText(text, 0, 0);
ctx.restore();
}
/** Text cut to fit a width, with an ellipsis. Canvas only: the DOM never sees it. */
function fitText(ctx, text, maxW) {
if (ctx.measureText(text).width <= maxW) return text;
let lo = 0;
let hi = text.length;
while (lo < hi) {
const mid = Math.ceil((lo + hi) / 2);
if (ctx.measureText(`${text.slice(0, mid)}…`).width <= maxW) lo = mid;
else hi = mid - 1;
}
return `${text.slice(0, lo)}…`;
}
function limb(ctx, a, b, color, w, bend = 0) {
const dx = b[0] - a[0];
const dy = b[1] - a[1];
const len = Math.hypot(dx, dy) || 1;
const cx = (a[0] + b[0]) / 2 - (dy / len) * bend;
const cy = (a[1] + b[1]) / 2 + (dx / len) * bend;
ctx.beginPath();
ctx.moveTo(a[0], a[1]);
ctx.quadraticCurveTo(cx, cy, b[0], b[1]);
ctx.lineCap = 'round';
ctx.strokeStyle = C.line;
ctx.lineWidth = w + 5;
ctx.stroke();
ctx.strokeStyle = color;
ctx.lineWidth = w;
ctx.stroke();
}
function hand(ctx, p, r = 6.5) {
ctx.beginPath();
ctx.arc(p[0], p[1], r, 0, TAU);
inked(ctx, C.balloon, 2.5);
}
function face(ctx, hy, f, mood) {
const ey = hy - 3;
ctx.fillStyle = C.balloonInk;
ctx.strokeStyle = C.balloonInk;
ctx.lineCap = 'round';
ctx.lineWidth = 3;
if (mood === 'happy') {
for (const ex of [-12, 12]) {
ctx.beginPath();
ctx.arc(ex, ey + 4, 6, Math.PI * 1.1, Math.PI * 1.9);
ctx.stroke();
}
} else if (mood === 'shock') {
for (const ex of [-12, 12]) {
ctx.beginPath();
ctx.arc(ex, ey, 6.5, 0, TAU);
ctx.lineWidth = 2.5;
ctx.stroke();
ctx.beginPath();
ctx.arc(ex, ey, 2.4, 0, TAU);
ctx.fill();
}
} else {
const h = f % 117 > 112 ? 2 : mood === 'focus' ? 9 : 14;
for (const ex of [-12, 12]) {
rr(ctx, ex - 3, ey - h / 2, 6, h, 3);
ctx.fill();
}
}
if (mood !== 'happy' && mood !== 'neutral') {
ctx.lineWidth = 2.6;
const up = mood === 'shock' ? 4 : 0;
for (const s of [-1, 1]) {
ctx.beginPath();
if (mood === 'focus') {
ctx.moveTo(s * 6, hy - 13);
ctx.lineTo(s * 17, hy - 16);
} else {
ctx.moveTo(s * 7, hy - 16 - up);
ctx.lineTo(s * 17, hy - 19 - up);
}
ctx.stroke();
}
}
ctx.lineWidth = 3;
ctx.beginPath();
if (mood === 'happy' || mood === 'eager') {
ctx.moveTo(-9, hy + 11);
ctx.quadraticCurveTo(0, hy + 23, 9, hy + 11);
ctx.closePath();
ctx.fill();
} else if (mood === 'shock') {
ctx.ellipse(0, hy + 15, 4.5, 5.5, 0, 0, TAU);
ctx.fill();
} else if (mood === 'focus') {
ctx.moveTo(-6, hy + 15);
ctx.lineTo(6, hy + 13);
ctx.stroke();
} else {
ctx.arc(0, hy + 9, 6, Math.PI * 0.2, Math.PI * 0.8);
ctx.stroke();
}
}
/** The agent: a terminal-headed character. (x, y) is the point between its feet. */
function agent(ctx, x, y, o = {}) {
const s = o.scale ?? 1;
const body = o.body ?? C.cyan;
const L = o.l ?? [-32, -44];
const R = o.r ?? [32, -44];
const hy = -120 + (o.headBob ?? 0);
ctx.save();
ctx.translate(x, y);
ctx.rotate(o.tilt ?? 0);
ctx.scale(s, s);
ctx.lineJoin = 'round';
if (!o.noShadow) {
ctx.save();
ctx.globalAlpha = 0.18;
ctx.fillStyle = C.line;
ctx.beginPath();
ctx.ellipse(0, 2, 30, 6, 0, 0, TAU);
ctx.fill();
ctx.restore();
}
limb(ctx, [-11, -38], [-14, -4], body, 10);
limb(ctx, [11, -38], [14, -4], body, 10);
for (const fx of [-16, 16]) {
ctx.beginPath();
ctx.ellipse(fx, -2, 9, 5, 0, 0, TAU);
inked(ctx, body, 2.5);
}
rr(ctx, -24, -88, 48, 54, 15);
inked(ctx, body, 3);
rr(ctx, -13, -76, 26, 17, 4);
inked(ctx, C.balloon, 2);
ctx.fillStyle = C.balloonInk;
ctx.font = `600 10px ${MONO}`;
ctx.textAlign = 'center';
ctx.textBaseline = 'middle';
ctx.fillText('>_', 0, -67.5);
limb(ctx, [-19, -78], L, body, 9, o.bendL ?? -10);
limb(ctx, [19, -78], R, body, 9, o.bendR ?? 10);
hand(ctx, L);
hand(ctx, R);
ctx.beginPath();
ctx.moveTo(0, hy - 27);
ctx.lineTo(0, hy - 41);
ctx.strokeStyle = C.line;
ctx.lineWidth = 3;
ctx.stroke();
ctx.beginPath();
ctx.arc(0, hy - 45, 6, 0, TAU);
inked(ctx, C.yellow, 2.5);
rr(ctx, -33, hy - 27, 66, 56, 17);
inked(ctx, C.balloon, 3.2);
face(ctx, hy, o.frame ?? 0, o.mood ?? 'neutral');
ctx.restore();
const at = (p) => [x + p[0] * s, y + p[1] * s];
return { l: at(L), r: at(R), head: at([0, hy]) };
}
function labelLines(name) {
const dot = name.lastIndexOf('.');
const stem = dot > 0 ? name.slice(0, dot) : name;
const ext = dot > 0 ? name.slice(dot) : '';
const words = stem
.replace(/([a-z])([A-Z])/g, '$1 $2')
.split(/[\s_-]+/)
.filter(Boolean);
const lines = [];
let cur = '';
for (const w of words) {
if ((cur + w).length > 9 && cur) {
lines.push(cur);
cur = w;
} else cur += w;
}
if ((cur + ext).length > 11) lines.push(cur, ext);
else lines.push(cur + ext);
return lines.filter(Boolean).slice(0, 3);
}
function card(ctx, x, y, w, h, rot, label, hi) {
ctx.save();
ctx.translate(x + w / 2, y + h / 2);
ctx.rotate(rot);
rr(ctx, -w / 2, -h / 2, w, h, 4);
inked(ctx, C.balloon, 2.5);
const lines = labelLines(label);
ctx.fillStyle = C.balloonInk;
ctx.font = `600 8px ${MONO}`;
ctx.textAlign = 'left';
ctx.textBaseline = 'top';
lines.forEach((l, i) => ctx.fillText(fitText(ctx, l, w - 9), -w / 2 + 5, -h / 2 + 6 + i * 9));
ctx.globalAlpha = 0.28;
for (let i = 0, yy = -h / 2 + 12 + lines.length * 9; yy < h / 2 - 7; i++, yy += 8) {
ctx.fillRect(-w / 2 + 5 + (i % 3 === 1 ? 6 : 0), yy, (w - 14) * (0.4 + rnd(i + label.length) * 0.5), 3.2);
}
ctx.globalAlpha = 1;
if (hi > 0) {
ctx.globalAlpha = hi;
rr(ctx, -w / 2 - 5, -h / 2 - 5, w + 10, h + 10, 8);
ctx.strokeStyle = C.magenta;
ctx.lineWidth = 3.5;
ctx.stroke();
ctx.globalAlpha = 1;
}
ctx.restore();
}
function magnifier(ctx, cx, cy, r, h) {
const dx = h[0] - cx;
const dy = h[1] - cy;
const d = Math.hypot(dx, dy) || 1;
ctx.lineCap = 'round';
ctx.beginPath();
ctx.moveTo(cx + (dx / d) * r, cy + (dy / d) * r);
ctx.lineTo(h[0] + (dx / d) * 6, h[1] + (dy / d) * 6);
ctx.strokeStyle = C.line;
ctx.lineWidth = 10;
ctx.stroke();
ctx.strokeStyle = C.yellow;
ctx.lineWidth = 5;
ctx.stroke();
ctx.beginPath();
ctx.arc(cx, cy, r, 0, TAU);
ctx.save();
ctx.globalAlpha = 0.3;
ctx.fillStyle = C.cyan;
ctx.fill();
ctx.restore();
ctx.lineWidth = 5;
ctx.strokeStyle = C.line;
ctx.stroke();
ctx.beginPath();
ctx.arc(cx, cy, r * 0.62, Math.PI * 1.1, Math.PI * 1.45);
ctx.strokeStyle = C.balloon;
ctx.lineWidth = 3;
ctx.stroke();
}
function cloud(ctx, cx, cy, w, h) {
const pts = [];
for (let i = 0; i < 11; i++) {
const a = (i / 11) * TAU;
pts.push([cx + Math.cos(a) * w * 0.42, cy + Math.sin(a) * h * 0.4, (w + h) * 0.1 * (0.85 + rnd(i + 3) * 0.3)]);
}
for (const [fill, pad] of [
[C.line, 3],
[C.balloon, 0],
]) {
ctx.fillStyle = fill;
for (const [x, y, r] of pts) {
ctx.beginPath();
ctx.arc(x, y, r + pad, 0, TAU);
ctx.fill();
}
ctx.beginPath();
ctx.ellipse(cx, cy, w * 0.42 + pad, h * 0.4 + pad, 0, 0, TAU);
ctx.fill();
}
}
function tag(ctx, x, y, text, director, alpha) {
ctx.save();
ctx.globalAlpha = clamp(alpha, 0, 1);
ctx.font = director ? `600 10px ${MONO}` : `16px ${LETTER}`;
const shown = fitText(ctx, text, 110);
const w = ctx.measureText(shown).width;
rr(ctx, x - w / 2 - 7, y, w + 14, 19, 5);
inked(ctx, C.balloon, 2);
ctx.fillStyle = C.balloonInk;
ctx.textAlign = 'center';
ctx.textBaseline = 'middle';
ctx.fillText(shown, x, y + 10.5);
ctx.restore();
}
function pencil(ctx, h, t) {
const dx = t[0] - h[0];
const dy = t[1] - h[1];
const d = Math.hypot(dx, dy) || 1;
const ux = dx / d;
const uy = dy / d;
const back = [h[0] - ux * 16, h[1] - uy * 16];
const neck = [t[0] - ux * 12, t[1] - uy * 12];
ctx.lineCap = 'butt';
ctx.beginPath();
ctx.moveTo(back[0], back[1]);
ctx.lineTo(neck[0], neck[1]);
ctx.strokeStyle = C.line;
ctx.lineWidth = 12;
ctx.stroke();
ctx.strokeStyle = C.yellow;
ctx.lineWidth = 7;
ctx.stroke();
ctx.lineCap = 'round';
ctx.beginPath();
ctx.moveTo(neck[0] - uy * 6, neck[1] + ux * 6);
ctx.lineTo(t[0], t[1]);
ctx.lineTo(neck[0] + uy * 6, neck[1] - ux * 6);
ctx.closePath();
inked(ctx, C.balloon, 2);
ctx.beginPath();
ctx.arc(t[0] - ux * 2, t[1] - uy * 2, 2.2, 0, TAU);
ctx.fillStyle = C.line;
ctx.fill();
}
/** A page of code showing real diff lines (`lines` keep their ' '/'+'/'-' prefix). */
function codePage(ctx, x, y, w, h, f, title, lines, stack) {
for (let k = Math.min(stack, 2); k > 0; k--) {
rr(ctx, x + k * 6, y - k * 6, w, h, 5);
inked(ctx, C.balloon, 2);
}
rr(ctx, x, y, w, h, 5);
inked(ctx, C.balloon, 2.5);
ctx.fillStyle = C.balloonInk;
ctx.font = `600 9px ${MONO}`;
ctx.textAlign = 'left';
ctx.textBaseline = 'alphabetic';
ctx.fillText(fitText(ctx, title, w - 16), x + 8, y + 14);
ctx.font = `500 8px ${MONO}`;
const rows = Math.max(1, Math.floor((h - 26) / 11.5));
if (!lines.length) {
// The edit is still running: rough lines and a blinking caret.
ctx.globalAlpha = 0.28;
for (let i = 0; i < Math.min(rows, 6); i++) {
ctx.fillRect(x + 10 + (i % 3 === 1 ? 10 : 0), y + 26 + i * 11.5, (w - 30) * (0.4 + rnd(i + 5) * 0.5), 4);
}
ctx.globalAlpha = 1;
if (f % 30 < 15) {
ctx.fillStyle = C.magenta;
ctx.fillRect(x + 10, y + 26 + Math.min(rows, 6) * 11.5, 6, 10);
}
return;
}
let k = 0;
lines.slice(0, rows).forEach((raw, i) => {
const ly = y + 30 + i * 11.5;
const mark = raw[0] === '+' ? '+ ' : raw[0] === '-' ? '− ' : ' ';
const text = fitText(ctx, mark + raw.slice(1).trim(), w - 16);
if (raw[0] !== '+' && raw[0] !== '-') {
ctx.globalAlpha = 0.62;
ctx.fillStyle = C.balloonInk;
ctx.fillText(text, x + 8, ly);
ctx.globalAlpha = 1;
return;
}
const p = interpolate(f, [18 + k * 6, 28 + k * 6], [0, 1], easeOut);
k++;
ctx.save();
ctx.globalAlpha = 0.42;
ctx.fillStyle = raw[0] === '+' ? C.go : C.magenta;
ctx.fillRect(x + 3, ly - 8.5, (w - 6) * p, 11);
ctx.restore();
ctx.save();
ctx.beginPath();
ctx.rect(x + 3, ly - 9, (w - 6) * p, 12);
ctx.clip();
ctx.fillStyle = C.balloonInk;
ctx.fillText(text, x + 8, ly);
ctx.restore();
});
}
/** A board of check dots. `fail` dots are drawn red with a crack; `fill` is how many are in yet. */
function board(ctx, x, y, label, dots, fail, fill) {
const cols = 7;
const g = 16;
const r = 5.5;
const rows = Math.ceil(dots / cols);
const w = 127;
const h = 30 + rows * g;
rr(ctx, x, y, w, h, 8);
inked(ctx, C.balloon, 2.5);
ctx.fillStyle = C.balloonInk;
ctx.font = `15px ${LETTER}`;
ctx.textAlign = 'center';
ctx.textBaseline = 'middle';
ctx.fillText(fitText(ctx, label, w - 12), x + w / 2, y + 14);
for (let k = 0; k < dots; k++) {
const cx = x + 10 + (k % cols) * g + r;
const cy = y + 26 + Math.floor(k / cols) * g + r;
const on = k < fill;
const bad = on && k >= dots - fail;
ctx.beginPath();
ctx.arc(cx, cy, r, 0, TAU);
inked(ctx, on ? (bad ? C.magenta : C.go) : C.balloon, 2);
if (bad) {
ctx.beginPath();
ctx.moveTo(cx - r - 4, cy - r - 2);
ctx.lineTo(cx - 2, cy - 1);
ctx.lineTo(cx + 2, cy - 6);
ctx.lineTo(cx + r + 5, cy + 3);
ctx.strokeStyle = C.line;
ctx.lineWidth = 2;
ctx.stroke();
}
}
return { w, h };
}
function terminal(ctx, x, y, w, h, lines, f) {
rr(ctx, x, y, w, h, 7);
inked(ctx, C.line, 2.5);
ctx.fillStyle = C.balloonInk;
for (const [i, color] of [C.magenta, C.yellow, C.go].entries()) {
ctx.beginPath();
ctx.arc(x + 11 + i * 10, y + 9, 3, 0, TAU);
ctx.fillStyle = color;
ctx.fill();
}
ctx.font = `500 9px ${MONO}`;
ctx.textAlign = 'left';
ctx.textBaseline = 'alphabetic';
const rows = Math.max(1, Math.floor((h - 24) / 14));
lines.slice(0, rows).forEach((line, i) => {
const text = fitText(ctx, `› ${line}`, w - 18);
const shown = Math.floor(interpolate(f, [8 + i * 12, 20 + i * 12], [0, text.length]));
ctx.fillStyle = i === Math.min(rows, lines.length) - 1 ? C.yellow : C.balloon;
ctx.fillText(text.slice(0, shown), x + 9, y + 30 + i * 14);
});
if (f % 30 < 15) {
const n = Math.min(rows, lines.length);
ctx.fillStyle = C.balloon;
ctx.fillRect(x + 9, y + 22 + n * 14, 6, 10);
}
}
function globe(ctx, cx, cy, r, f) {
ctx.beginPath();
ctx.arc(cx, cy, r, 0, TAU);
inked(ctx, C.cyan, 3);
ctx.save();
ctx.beginPath();
ctx.arc(cx, cy, r, 0, TAU);
ctx.clip();
ctx.strokeStyle = C.line;
ctx.lineWidth = 2;
for (let k = -2; k <= 2; k++) {
ctx.beginPath();
ctx.ellipse(cx, cy + k * r * 0.38, r, r * 0.12, 0, 0, TAU);
ctx.stroke();
}
const spin = (f / 40) % 1;
for (let k = 0; k < 3; k++) {
const p = ((k / 3 + spin) % 1) * 2 - 1;
ctx.beginPath();
ctx.ellipse(cx, cy, Math.abs(p) * r, r, 0, 0, TAU);
ctx.stroke();
}
ctx.restore();
}
function star4(ctx, x, y, r, fill) {
ctx.beginPath();
for (let i = 0; i < 8; i++) {
const a = (i / 8) * TAU - Math.PI / 2;
const rad = i % 2 ? r * 0.32 : r;
const px = x + Math.cos(a) * rad;
const py = y + Math.sin(a) * rad;
if (i) ctx.lineTo(px, py);
else ctx.moveTo(px, py);
}
ctx.closePath();
inked(ctx, fill, 2);
}
function baseName(path) {
const s = String(path || '').replace(/\/+$/, '');
return s.slice(s.lastIndexOf('/') + 1) || s;
}
// ── Scenes. `p` = { panel, page, director }, `hit(id, x, y, w, h, label)` registers a click target. ──
const SCENES = {
mission: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.cyan, W, H, { rmax: 4.4, reach: 0.9 });
},
draw(ctx, W, H, f) {
const ax = Math.max(W * 0.78, W - 104);
const a = agent(ctx, ax, 244, {
frame: f,
mood: 'listen',
headBob: Math.sin(f / 16) * 1.6,
l: [-30, -42],
r: [30, -42],
});
sfx(
ctx,
'!',
a.head[0] + 46,
a.head[1] - 34,
46,
C.yellow,
0.2,
spring(f - 16, { damping: 8, stiffness: 160 })
);
},
},
investigate: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.yellow, 0, H, { rmax: 4.6 });
},
draw(ctx, W, H, f, p, hit) {
const files = p.panel.files || [];
const ax = W - 58;
if (!files.length) {
terminal(
ctx,
14,
92,
Math.min(W * 0.58, 220),
130,
p.panel.notes?.length ? p.panel.notes : ['looking around'],
f
);
hit('list', 14, 92, Math.min(W * 0.58, 220), 130, 'See what Claude looked at');
} else {
const shown = files.length > 8 ? files.slice(0, 7) : files;
const extra = files.length - shown.length;
const labels = shown.map(baseName).concat(extra ? [`+${extra} more`] : []);
const cw = 60;
const ch = 78;
const n = labels.length;
const step = n > 1 ? Math.min(70, Math.max(8, (ax - 70 - 14 - cw) / (n - 1))) : 0;
for (let i = 0; i < n; i++) {
const pr = spring(f - 4 - i * 5, { damping: 11, stiffness: 150 });
if (pr <= 0.001) continue;
const cx = 14 + i * step;
const cy = 128 + (i % 2) * 14 + Math.sin(i * 1.7) * 4 - (1 - pr) * 70;
ctx.save();
ctx.globalAlpha = clamp(pr * 1.5, 0, 1);
card(ctx, cx, cy, cw, ch, (i - n / 2 + 0.5) * 0.06, labels[i], 0);
ctx.restore();
if (extra && i === n - 1) hit('list', cx, cy, cw, ch, `See all ${files.length} files`);
else hit(`file:${i}`, cx, cy, cw, ch, `Open ${labels[i]}`);
}
}
const a = agent(ctx, ax, 246, {
frame: f,
mood: 'focus',
l: [-64 + Math.sin(f / 22) * 9, -74 + Math.cos(f / 17) * 6],
r: [28, -40],
});
magnifier(ctx, a.l[0] - 24, a.l[1] - 16, 22, a.l);
},
},
research: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.cyan, 0, 0, { rmax: 3.6 });
},
draw(ctx, W, H, f, p, hit) {
const gx = Math.min(W * 0.32, 130);
const pr = spring(f - 2, { damping: 12, stiffness: 140 });
globe(ctx, gx, 160, 58 * pr + 0.1, f);
hit('list', gx - 60, 100, 120, 120, 'See what Claude looked up');
const notes = p.panel.notes || [];
ctx.font = `600 8.5px ${MONO}`;
notes.slice(0, 3).forEach((note, i) => {
const tp = spring(f - 20 - i * 6, { damping: 12, stiffness: 140 });
if (tp <= 0.01) return;
const tx = gx + 60;
const ty = 100 + i * 34;
const tw = Math.max(40, Math.min(W - tx - 70, 190));
ctx.save();
ctx.globalAlpha = clamp(tp, 0, 1);
rr(ctx, tx, ty, tw, 24, 5);
inked(ctx, C.balloon, 2);
ctx.fillStyle = C.balloonInk;
ctx.textAlign = 'left';
ctx.textBaseline = 'middle';
ctx.fillText(fitText(ctx, note, tw - 12), tx + 6, ty + 12.5);
ctx.restore();
});
agent(ctx, W - 44, 252, { frame: f, scale: 0.62, mood: 'focus', l: [-34, -70], r: [30, -44] });
},
},
plan: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.magenta, W, 0, { rmax: 3.4, reach: 1.1, alpha: 0.9 });
},
draw(ctx, W, H, f, p, hit) {
const cx = W * 0.44;
const cy = 168;
const cw = Math.min(W * 0.66, 300);
const chh = 132;
const pc = spring(f - 2, { damping: 12, stiffness: 140 });
if (pc > 0.01) {
ctx.save();
ctx.translate(cx, cy);
ctx.scale(pc, pc);
cloud(ctx, 0, 0, cw, chh);
const items = p.panel.todos?.length
? p.panel.todos.map((t) => ({ text: t.text, done: t.done, box: true }))
: (p.panel.notes || []).map((t) => ({ text: t, done: false, box: false }));
ctx.font = `14px ${LETTER}`;
ctx.textAlign = 'left';
ctx.textBaseline = 'middle';
const shown = items.slice(0, 4);
shown.forEach((item, i) => {
const ly = -((shown.length - 1) * 19) / 2 + i * 19;
const lx = -cw * 0.36;
if (item.box) {
ctx.strokeStyle = C.balloonInk;
ctx.lineWidth = 1.8;
ctx.strokeRect(lx, ly - 6, 12, 12);
if (item.done) {
ctx.beginPath();
ctx.moveTo(lx + 2, ly);
ctx.lineTo(lx + 5, ly + 4);
ctx.lineTo(lx + 11, ly - 5);
ctx.strokeStyle = C.go;
ctx.lineWidth = 2.5;
ctx.stroke();
}
}
ctx.fillStyle = C.balloonInk;
ctx.fillText(fitText(ctx, item.text, cw * 0.66), lx + (item.box ? 18 : 0), ly + 1);
});
if (items.length > shown.length) {
ctx.fillText(`+${items.length - shown.length} more`, -cw * 0.36 + 18, ((shown.length + 1) * 19) / 2);
}
ctx.restore();
hit('plan', cx - cw * 0.45 * pc, cy - chh * 0.45 * pc, cw * 0.9 * pc, chh * 0.9 * pc, 'See the plan');
}
const a = agent(ctx, W - 38, 256, { frame: f, scale: 0.52, mood: 'focus', l: [-26, -60], r: [30, -44] });
const from = [a.head[0] - 22, a.head[1] - 18];
const to = [cx + cw * 0.36, cy + chh * 0.38];
[4, 6, 8].forEach((r, k) => {
const t = (k + 1) / 4;
const pp = clamp((pc - 0.6) / 0.4, 0, 1);
if (pp <= 0) return;
ctx.beginPath();
ctx.arc(from[0] + (to[0] - from[0]) * t, from[1] + (to[1] - from[1]) * t, r * pp, 0, TAU);
inked(ctx, C.balloon, 2);
});
},
},
backup: {
bg(ctx, W, H) {
base(ctx, W, H);
rays(ctx, W, H, W / 2, 190, 28, C.yellow, 0.55, 0.05);
halftone(ctx, W, H, C.cyan, W / 2, H, { cell: 10, rmax: 3, reach: 0.8, alpha: 0.7 });
},
draw(ctx, W, H, f, p, hit) {
const mx = W / 2;
agent(ctx, mx, 248, {
frame: f,
mood: 'eager',
l: [-44, -118 + Math.sin(f / 9) * 3],
r: [44, -118 + Math.cos(f / 9) * 3],
bendL: 12,
bendR: -12,
});
const helpers = (p.panel.helpers || []).slice(0, 4);
const spots = [0.16, 0.84, 0.31, 0.69];
const colors = [C.magenta, C.yellow, C.go, C.cyan];
if (!helpers.length) {
// A message to another session: an envelope flies off.
const pr = spring(f - 8, { damping: 13, stiffness: 80 });
const x = mx + (W * 0.84 - mx) * pr;
const y = 150 - Math.sin(clamp(pr, 0, 1) * Math.PI) * 50;
rr(ctx, x - 22, y - 14, 44, 28, 3);
inked(ctx, C.balloon, 2.5);
ctx.beginPath();
ctx.moveTo(x - 22, y - 14);
ctx.lineTo(x, y + 2);
ctx.lineTo(x + 22, y - 14);
ctx.strokeStyle = C.line;
ctx.lineWidth = 2;
ctx.stroke();
hit('list', x - 26, y - 18, 52, 36, 'See the message');
return;
}
helpers.forEach((h, k) => {
const delay = 8 + k * 6;
const pr = spring(f - delay, { damping: 13, stiffness: 80 });
if (pr <= 0.001) return;
const tx = W * spots[k];
const dir = Math.sign(tx - mx) || 1;
const x = mx + (tx - mx) * pr;
const y = 150 + (224 - 150) * pr - Math.sin(clamp(pr, 0, 1) * Math.PI) * 60;
if (pr < 0.97) {
ctx.save();
ctx.globalAlpha = clamp(1 - pr, 0, 1);
ctx.strokeStyle = C.ink;
ctx.lineWidth = 2.5;
ctx.lineCap = 'round';
for (let s = 0; s < 3; s++) {
ctx.beginPath();
ctx.moveTo(x - dir * (24 + s * 6), y - 64 + s * 14);
ctx.lineTo(x - dir * (74 + s * 14), y - 70 + s * 14);
ctx.stroke();
}
ctx.restore();
}
agent(ctx, x, y, {
frame: f + delay * 7,
scale: 0.62,
body: colors[k],
mood: 'happy',
tilt: dir * 0.35 * (1 - clamp(pr, 0, 1)),
l: [-30, -50],
r: [30, -50],
});
if (pr > 0.85)
tag(
ctx,
clamp(x, 64, W - 64),
y + 9,
p.director ? h.type : h.task || h.name,
p.director,
(pr - 0.85) / 0.15
);
hit(`helper:${h.event}`, x - 30, y - 112, 60, 142, `See what ${h.name} did`);
});
},
},
fix: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.cyan, 0, H, { rmax: 3.6 });
},
draw(ctx, W, H, f, p, hit) {
const edits = p.panel.events.map((i) => p.page.events[i]).filter((e) => e && e.edit);
const first = edits[0]?.edit;
const lines = first?.hunks?.[0]?.lines || [];
const pw = Math.min(W * 0.56, 196);
const ph = 128;
const x0 = 12 - (1 - spring(f, { damping: 14, stiffness: 120 })) * 70;
const y0 = 104;
const files = p.panel.files || [];
codePage(ctx, x0, y0, pw, ph, f, baseName(first?.file || files[0] || 'file'), lines, files.length - 1);
hit('diff', x0, y0, pw, ph, "See Claude's changes");
const ax = W - 50;
const tip = [x0 + pw - 14, y0 + ph * 0.5];
const hp = [tip[0] + 20 + Math.sin(f / 2.6) * 3, tip[1] - 28 + Math.cos(f / 3.1) * 2.5];
const a = agent(ctx, ax, 248, { frame: f, mood: 'focus', l: [hp[0] - ax, hp[1] - 248], r: [30, -42] });
pencil(ctx, a.l, [tip[0] + Math.sin(f / 2.6) * 3, tip[1] + Math.cos(f / 3.1) * 2.5]);
if (p.panel.added)
sfx(
ctx,
`+${p.panel.added}`,
x0 + pw * 0.32,
y0 + ph + 2,
26,
C.go,
-0.18,
spring(f - 44, { damping: 9, stiffness: 170 })
);
if (p.panel.removed)
sfx(
ctx,
`−${p.panel.removed}`,
x0 + pw * 0.74,
y0 + ph + 6,
24,
C.magenta,
0.12,
spring(f - 50, { damping: 9, stiffness: 170 })
);
},
},
check: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.yellow, W * 0.7, H * 0.5, { cell: 8, rmax: 4.2, reach: 0.9 });
},
draw(ctx, W, H, f, p, hit) {
const t = p.panel.tests;
const total = t ? t.passed + t.failed : 0;
const dots = total ? Math.min(42, Math.max(7, total)) : 21;
const fail = p.panel.ok === false ? (t && total ? Math.max(1, Math.round((t.failed / total) * dots)) : 1) : 0;
const running = p.panel.ok === undefined;
const fill = running ? (f * 0.6) % (dots + 6) : Math.min(dots, (f - 4) * 1.6);
const label = total ? `${total} checks` : 'checks';
const b = board(ctx, 16, 106, label, dots, fail, fill);
hit('output', 16, 106, b.w, b.h, 'See the output');
const cx = Math.min(W * 0.62, W - 100);
const cy = 150;
const bp = running ? 0 : spring(f - 30, { damping: 9, stiffness: 150 });
if (bp > 0.01) {
ctx.save();
ctx.translate(cx, cy);
ctx.scale(bp, bp);
burst(ctx, 0, 0, 60, 36, 13, p.panel.ok ? C.cyan : C.yellow, 0.1, p.panel.ok ? 9 : 3);
ctx.restore();
const word = p.panel.ok ? 'POW!' : 'KRAK!';
sfx(ctx, word, cx, cy, fitSize(ctx, word, 96, 30), p.panel.ok ? C.yellow : C.magenta, -0.1, bp);
}
if (p.panel.ok && f > 34) {
[
[14, 100],
[142, 112],
[10, 230],
].forEach(([x, y], k) => star4(ctx, x, y, 7 + Math.sin(f / 5 + k * 1.7) * 3, C.yellow));
}
const mood = running ? 'focus' : p.panel.ok ? 'happy' : 'shock';
const jump = p.panel.ok && f > 30 ? Math.abs(Math.sin((f - 30) / 7)) * 12 : 0;
agent(ctx, W - 40, 254 - jump, {
frame: f,
scale: 0.66,
mood,
tilt: p.panel.ok === false ? interpolate(f, [28, 36], [0, 0.14]) : 0,
l: p.panel.ok ? [-32, -58] : [-36, -98],
r: p.panel.ok ? [22, -152] : [32, -102],
});
},
},
loop: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.magenta, W, 0, { cell: 8, rmax: 3.6 });
},
draw(ctx, W, H, f, p, hit) {
const edits = p.panel.events.map((i) => p.page.events[i]).filter((e) => e && e.edit);
const last = edits[edits.length - 1]?.edit;
const pw = Math.min(W * 0.36, 150);
codePage(ctx, 12, 108, pw, 112, f, baseName(last?.file || 'file'), last?.hunks?.[0]?.lines || [], 0);
hit('diff', 12, 108, pw, 112, "See Claude's changes");
const bx = 12 + pw + 34;
if (bx + 127 < W - 10) {
const dots = 14;
const b = board(ctx, bx, 116, 'checks', dots, p.panel.ok === false ? 2 : 0, Math.min(dots, (f - 4) * 1.6));
hit('output', bx, 116, b.w, b.h, 'See the test output');
}
// The cycle arrow between the page and the board.
const ax = 12 + pw + 17;
const spin = (f / 20) % TAU;
ctx.save();
ctx.translate(ax, 164);
ctx.rotate(spin);
ctx.beginPath();
ctx.arc(0, 0, 14, 0.3, TAU - 0.6);
ctx.strokeStyle = C.line;
ctx.lineWidth = 6;
ctx.stroke();
ctx.strokeStyle = C.yellow;
ctx.lineWidth = 3;
ctx.stroke();
ctx.restore();
sfx(
ctx,
`×${p.panel.rounds || 1}`,
W - 60,
96,
30,
C.yellow,
-0.1,
spring(f - 20, { damping: 9, stiffness: 160 })
);
if (p.panel.ok !== undefined) {
const word = p.panel.ok ? 'POW!' : 'KRAK!';
sfx(
ctx,
word,
W - 60,
150,
fitSize(ctx, word, 90, 26),
p.panel.ok ? C.yellow : C.magenta,
0.08,
spring(f - 40, { damping: 9, stiffness: 150 })
);
}
},
},
run: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.cyan, 0, H, { rmax: 3.4 });
},
draw(ctx, W, H, f, p, hit) {
const tw = Math.min(W * 0.62, 260);
const notes = p.panel.notes?.length ? p.panel.notes : ['…'];
terminal(ctx, 14, 92, tw, 140, notes, f);
hit('output', 14, 92, tw, 140, 'See the commands and their output');
agent(ctx, W - 48, 250, {
frame: f,
mood: 'focus',
scale: 0.8,
l: [-40, -60 + Math.sin(f / 2) * 3],
r: [-20, -58 + Math.cos(f / 2) * 3],
});
},
},
save: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.go, W, H, { rmax: 3.6, alpha: 0.7 });
},
draw(ctx, W, H, f, p, hit) {
const pr = spring(f - 4, { damping: 12, stiffness: 140 });
const bx = 24;
const by = 120 + (1 - pr) * 40;
rr(ctx, bx, by, 120, 90, 6);
inked(ctx, C.yellow, 3);
rr(ctx, bx - 6, by - 14, 132, 22, 5);
inked(ctx, C.yellow, 3);
ctx.fillStyle = C.line;
ctx.fillRect(bx + 44, by + 18, 32, 8);
hit('output', bx - 6, by - 14, 132, 104, 'See what was saved');
const sp = spring(f - 28, { damping: 8, stiffness: 160 });
if (sp > 0.01) {
ctx.save();
ctx.translate(bx + 60, by + 56);
ctx.rotate(-0.18);
ctx.scale(sp, sp);
ctx.font = `20px ${DISPLAY}`;
ctx.textAlign = 'center';
ctx.textBaseline = 'middle';
const w = ctx.measureText('SAVED').width + 18;
rr(ctx, -w / 2, -15, w, 30, 4);
ctx.strokeStyle = C.magenta;
ctx.lineWidth = 3;
ctx.stroke();
ctx.fillStyle = C.magenta;
ctx.fillText('SAVED', 0, 1);
ctx.restore();
}
agent(ctx, W - 50, 250, { frame: f, mood: 'happy', scale: 0.8, l: [-30, -52], r: [26, -128] });
},
},
ask: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.yellow, 0, H, { cell: 10, rmax: 3, alpha: 0.8 });
focusLines(ctx, W, H, W * 0.64, 136, 84, C.ink, 0.45);
},
draw(ctx, W, H, f, p, hit) {
const ax = W * 0.64;
const s = 1.7;
const yb = 338;
const hp = [ax - 46 + Math.sin(f / 7) * 1.5, 212];
agent(ctx, ax, yb, {
frame: f,
scale: s,
mood: 'eager',
noShadow: true,
l: [(hp[0] - ax) / s, (hp[1] - yb) / s],
r: [28, -46],
});
ctx.beginPath();
ctx.arc(hp[0], hp[1], 17, 0, TAU);
inked(ctx, C.balloon, 3);
ctx.beginPath();
ctx.arc(hp[0] - 2, hp[1] - 1, 8, 0, TAU);
inked(ctx, C.balloon, 2.5);
hit('ask', ax - 60, 80, 120, 150, 'See the question');
},
},
compact: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.magenta, 0, 0, { rmax: 3.2, alpha: 0.7 });
},
draw(ctx, W, H, f) {
const squeeze = interpolate(f, [10, 50], [1, 0.35], easeOut);
for (let k = 0; k < 6; k++) {
ctx.save();
ctx.translate(40 + k * 4, 200 - k * 14 * squeeze);
ctx.rotate((rnd(k) - 0.5) * 0.2);
rr(ctx, 0, 0, 90, 12, 2);
inked(ctx, C.balloon, 2);
ctx.restore();
}
rr(ctx, 30, 206, 120, 30, 5);
inked(ctx, C.yellow, 3);
agent(ctx, W - 50, 250, { frame: f, mood: 'focus', scale: 0.8, l: [-60, -90 + squeeze * 20], r: [24, -50] });
},
},
montage: {
bg(ctx, W, H) {
base(ctx, W, H);
halftone(ctx, W, H, C.yellow, W / 2, H / 2, { rmax: 3.4 });
},
draw(ctx, W, H, f, p, hit) {
const cells = [
{ icon: 'look', label: 'reads' },
{ icon: 'run', label: 'runs' },
{ icon: 'edit', label: 'edits' },
{ icon: 'check', label: 'checks' },
];
const size = Math.min(70, (W - 120) / 2);
const x0 = 16;
const y0 = 92;
cells.forEach((c, k) => {
const pr = spring(f - k * 5, { damping: 12, stiffness: 150 });
if (pr <= 0.01) return;
const x = x0 + (k % 2) * (size + 10);
const y = y0 + Math.floor(k / 2) * (size + 10);
ctx.save();
ctx.globalAlpha = clamp(pr, 0, 1);
rr(ctx, x, y, size, size, 6);
inked(ctx, C.panel, 2.5);
const cx = x + size / 2;
const cy = y + size / 2;
if (c.icon === 'look') magnifier(ctx, cx - 4, cy - 4, size * 0.2, [cx + size * 0.28, cy + size * 0.28]);
else if (c.icon === 'run') terminal(ctx, x + 8, y + 12, size - 16, size - 24, ['…'], HERO);
else if (c.icon === 'edit')
pencil(ctx, [cx + size * 0.3, cy - size * 0.3], [cx - size * 0.2, cy + size * 0.2]);
else star4(ctx, cx, cy, size * 0.3, C.go);
ctx.restore();
});
hit('list', x0, y0, size * 2 + 10, size * 2 + 10, 'See every step');
agent(ctx, W - 46, 252, { frame: f, mood: 'eager', scale: 0.62, l: [-30, -60], r: [26, -120] });
},
},
complete: {
bg(ctx, W, H) {
base(ctx, W, H);
rays(ctx, W, H, W > 420 ? W * 0.72 : W / 2, 200, 30, C.cyan, 0.32);
halftone(ctx, W, H, C.magenta, W, 0, { rmax: 3.4, reach: 0.85, alpha: 0.75 });
},
draw(ctx, W, H, f, p) {
const wide = W > 420;
const ax = wide ? W * 0.72 : W / 2;
const sc = wide ? 0.9 : 0.55;
if (p.page.interrupted) {
agent(ctx, ax, 250, { frame: f, scale: sc, mood: 'shock', l: [-40, -60], r: [40, -60] });
const sp = spring(f - 10, { damping: 9, stiffness: 150 });
if (sp > 0.01) {
ctx.save();
ctx.translate(ax + 70 * sc + 30, 120);
ctx.scale(sp, sp);
ctx.beginPath();
for (let i = 0; i < 8; i++) {
const a = (i / 8) * TAU + Math.PI / 8;
ctx[i ? 'lineTo' : 'moveTo'](Math.cos(a) * 30, Math.sin(a) * 30);
}
ctx.closePath();
inked(ctx, C.magenta, 3);
ctx.fillStyle = C.balloon;
ctx.font = `13px ${DISPLAY}`;
ctx.textAlign = 'center';
ctx.textBaseline = 'middle';
ctx.fillText('STOP', 0, 1);
ctx.restore();
}
return;
}
const colors = [C.cyan, C.magenta, C.yellow, C.go];
for (let i = 0; i < 42; i++) {
const x = rnd(i) * W;
const y = ((rnd(i + 99) * (H + 40) + f * (0.7 + rnd(i + 7) * 0.9)) % (H + 40)) - 20;
ctx.save();
ctx.translate(x, y);
ctx.rotate(i + f * 0.05 * (rnd(i + 3) - 0.5) * 4);
ctx.fillStyle = colors[i % 4];
ctx.fillRect(-4, -2.5, 8, 5);
ctx.restore();
}
const j = Math.abs(Math.sin(f / 8)) * 8;
if (p.page.helpers) {
const spread = wide ? 108 : 74;
const hs = wide ? 0.55 : 0.4;
agent(ctx, ax - spread, 250, {
frame: f + 30,
scale: hs,
body: C.magenta,
mood: 'happy',
l: [-30, -60],
r: [30, -104 + Math.sin(f / 6) * 8],
});
if (p.page.helpers > 1)
agent(ctx, ax + spread, 250, {
frame: f + 60,
scale: hs,
body: C.yellow,
mood: 'happy',
l: [-30, -104 + Math.cos(f / 6) * 8],
r: [30, -60],
});
}
agent(ctx, ax, 250 - j, {
frame: f,
scale: sc,
mood: 'happy',
l: [-40, -122],
r: [40, -122],
bendL: 12,
bendR: -12,
});
},
},
};
return { FPS, HERO, VH, C, readColors, spring, SCENES };
})();
/** Panel kinds as the wire's group headings name them. */
const STORY_KIND_NAMES = {
mission: 'The mission',
investigate: 'Investigating',
research: 'Looking it up',
plan: 'The plan',
backup: 'Calling backup',
fix: 'The fix',
check: 'The check',
loop: 'Fix and test',
run: 'In the terminal',
save: 'Saving',
ask: 'Your call',
compact: 'Packing up',
montage: 'Montage',
complete: 'The end',
};
/** How wide a panel wants to be on the 6-column page. Rows are then filled exactly. */
function storyPreferredSpan(panel) {
if (panel.kind === 'complete') return 6;
if (panel.kind === 'mission' || panel.kind === 'fix' || panel.kind === 'loop' || panel.kind === 'plan') return 3;
if (panel.kind === 'backup') return (panel.helpers?.length || 0) >= 2 ? 4 : 3;
return 2;
}
/** Spans for a row width of `cols`: the last panel of a row stretches to fill it. */
function storyLayoutSpans(prefs, cols) {
const spans = [];
let left = cols;
prefs.forEach((pref, i) => {
const want = Math.min(cols, Math.max(1, pref));
if (want > left && left < cols) {
spans[i - 1] += left;
left = cols;
}
spans.push(want);
left -= want;
if (left === 0) left = cols;
});
if (left !== cols && spans.length) spans[spans.length - 1] += left;
return spans;
}
Object.assign(CodemanApp.prototype, {
/** Per-device setting, default OFF. */
isStoryButtonEnabled() {
const settings = this.loadAppSettingsFromStorage();
const defaults = this.getDefaultSettings();
return (settings.showStoryButton ?? defaults.showStoryButton ?? false) === true;
},
/** Called from applyHeaderVisibilitySettings() on boot and after every settings save. */
applyStoryButtonVisibility() {
const on = this.isStoryButtonEnabled();
document.querySelector('.btn-story-header')?.classList.toggle('btn-story-header--hidden', !on);
if (!on) this.closeStoryMode();
},
toggleStoryMode() {
if (this._story?.open) this.closeStoryMode();
else this.openStoryMode();
},
openStoryMode(sessionId = this.activeSessionId) {
if (!sessionId) {
this.showToast?.('Open a session first, then Story Mode draws what it does.', 'info');
return;
}
const st = this._storyState();
st.returnFocus = document.activeElement;
st.open = true;
st.sessionId = sessionId;
st.turnId = null;
st.data = null;
st.error = null;
st.epoch++;
st.first = true;
st.drawer = null;
st.root.hidden = false;
document.body.classList.add('story-open');
this._storyApplyTheme();
const session = this.sessions?.get(sessionId);
st.sessionLabel.textContent = session?.name || sessionId.slice(0, 8);
this._storyRender();
this._storyStartRuntime();
this._storyRefresh();
st.closeBtn.focus({ preventScroll: true });
},
/** Hides the overlay and stops everything it runs. Safe to call when it is not open. */
closeStoryMode() {
const st = this._story;
if (!st?.open) return;
st.open = false;
st.epoch++;
st.root.hidden = true;
document.body.classList.remove('story-open');
this._storyStopRuntime();
this._storyCloseDrawer({ refocus: false });
for (const rt of st.panels) this._storyDropPanel(rt);
st.panels = [];
st.pageEl.replaceChildren();
st.wireList.replaceChildren();
st.data = null;
const back = st.returnFocus;
st.returnFocus = null;
if (back && document.contains(back)) back.focus({ preventScroll: true });
},
/** SSE activity (transcript tool events, stop and prompt hooks) for any session. */
_storyOnActivity(e) {
const st = this._story;
if (!st?.open) return;
let data = {};
try {
data = e?.data ? JSON.parse(e.data) : {};
} catch {
return;
}
if (data.sessionId !== st.sessionId || st.turnId) return;
this._storyScheduleRefresh();
},
// ── State and DOM ──
_storyState() {
if (this._story) return this._story;
const el = (tag, cls, text) => {
const n = document.createElement(tag);
if (cls) n.className = cls;
if (text != null) n.textContent = text;
return n;
};
const btn = (cls, text, label) => {
const b = el('button', cls, text);
b.type = 'button';
if (label) b.setAttribute('aria-label', label);
return b;
};
const root = el('div', 'story-overlay');
root.id = 'storyOverlay';
root.hidden = true;
root.setAttribute('role', 'dialog');
root.setAttribute('aria-modal', 'true');
root.setAttribute('aria-labelledby', 'storyTitle');
const bar = el('div', 'story-bar');
const brand = el('div', 'story-brand');
const title = el('span', 'story-title', 'Story');
title.id = 'storyTitle';
const sessionLabel = el('span', 'story-session');
sessionLabel.dataset.i18nSkip = '';
brand.append(title, sessionLabel);
const nav = el('div', 'story-nav');
const prev = btn('story-btn story-prev', '‹', 'Previous turn');
const turnSelect = el('select', 'story-turns');
turnSelect.setAttribute('aria-label', 'Turn');
turnSelect.dataset.i18nSkip = '';
const next = btn('story-btn story-next', '›', 'Next turn');
nav.append(prev, turnSelect, next);
const seg = el('div', 'story-seg');
seg.setAttribute('role', 'group');
seg.setAttribute('aria-label', 'Reading level');
const storyBtn = btn('story-seg-btn', 'Story');
const dirBtn = btn('story-seg-btn', "Director's cut");
seg.append(storyBtn, dirBtn);
const live = el('span', 'story-live');
live.append(el('i'), el('span', null, 'LIVE'));
live.hidden = true;
const closeBtn = btn('story-btn story-close', '×', 'Close Story Mode');
bar.append(brand, nav, seg, live, closeBtn);
const main = el('div', 'story-main');
const note = el('p', 'story-note');
note.hidden = true;
note.dataset.i18nSkip = '';
const stage = el('div', 'story-stage');
const sheet = el('div', 'story-sheet');
const pageEl = el('section', 'story-page');
pageEl.dataset.i18nSkip = '';
sheet.append(pageEl);
const wire = el('aside', 'story-wire');
wire.setAttribute('aria-label', 'Every event behind this page');
const wireHead = el('header', 'story-wire-head');
const wireCount = el('p', 'story-wire-sub');
wireHead.append(el('p', 'story-wire-title', 'The wire'), wireCount);
const wireList = el('ol', 'story-wire-list');
wireList.dataset.i18nSkip = '';
wire.append(wireHead, wireList);
stage.append(sheet, wire);
main.append(note, stage);
const drawer = el('aside', 'story-drawer');
drawer.hidden = true;
drawer.setAttribute('aria-label', 'Details');
const drawerHead = el('header', 'story-drawer-head');
const drawerKind = el('span', 'story-drawer-kind');
const drawerLive = el('span', 'story-live story-drawer-live');
drawerLive.append(el('i'), el('span', null, 'LIVE'));
drawerLive.hidden = true;
const drawerMeta = el('div', 'story-drawer-meta');
drawerMeta.append(drawerKind, drawerLive);
const drawerTitle = el('p', 'story-drawer-title');
const drawerSub = el('p', 'story-drawer-sub');
drawerTitle.dataset.i18nSkip = '';
drawerSub.dataset.i18nSkip = '';
const drawerClose = btn('story-btn story-drawer-close', '×', 'Close details');
drawerHead.append(drawerMeta, drawerTitle, drawerSub, drawerClose);
const drawerBody = el('div', 'story-drawer-body');
drawerBody.dataset.i18nSkip = '';
drawer.append(drawerHead, drawerBody);
root.append(bar, main, drawer);
document.body.appendChild(root);
const st = {
open: false,
epoch: 0,
sessionId: null,
turnId: null,
data: null,
error: null,
director: false,
first: true,
panels: [],
drawer: null,
drawerSeen: new Set(),
inFlight: false,
again: false,
refreshTimer: null,
pollTimer: null,
raf: 0,
returnFocus: null,
root,
bar,
sessionLabel,
turnSelect,
prev,
next,
storyBtn,
dirBtn,
live,
closeBtn,
note,
stage,
pageEl,
wire,
wireCount,
wireList,
drawerEl: drawer,
drawerKind,
drawerLive,
drawerTitle,
drawerSub,
drawerBody,
};
this._story = st;
closeBtn.addEventListener('click', () => this.closeStoryMode());
drawerClose.addEventListener('click', () => this._storyCloseDrawer());
storyBtn.addEventListener('click', () => this._storySetDirector(false));
dirBtn.addEventListener('click', () => this._storySetDirector(true));
turnSelect.addEventListener('change', () => this._storyPickTurn(turnSelect.value));
prev.addEventListener('click', () => this._storyStepTurn(-1));
next.addEventListener('click', () => this._storyStepTurn(1));
// One delegate for every clickable thing on the page and in the drawer.
root.addEventListener('click', (e) => {
const t = e.target.closest?.('[data-story-open]');
if (t && root.contains(t)) {
e.preventDefault();
this._storyOpenTarget(t.dataset.storyOpen, t);
}
});
this._storySetDirector(false);
return st;
},
_storyApplyTheme() {
const st = this._story;
const scheme = getComputedStyle(document.documentElement).colorScheme || '';
st.root.classList.toggle('story-paper', /light/.test(scheme) && !/dark/.test(scheme));
StoryArt.readColors(st.root);
for (const rt of st.panels) rt.bgKey = '';
},
_storySetDirector(on) {
const st = this._story;
st.director = on;
st.root.classList.toggle('is-director', on);
st.storyBtn.setAttribute('aria-pressed', String(!on));
st.dirBtn.setAttribute('aria-pressed', String(on));
st.wire.hidden = !on;
if (on) this._storyRenderWire();
for (const rt of st.panels) this._storyDrawPanel(rt);
},
_storyPickTurn(id) {
const st = this._story;
const turns = st.data?.turns || [];
st.turnId = id && id !== turns[turns.length - 1]?.id ? id : null;
st.first = true;
st.epoch++;
this._storyCloseDrawer({ refocus: false });
this._storyRefresh();
},
_storyStepTurn(delta) {
const st = this._story;
const turns = st.data?.turns || [];
const current = st.data?.page?.id;
const idx = turns.findIndex((t) => t.id === current);
const target = turns[idx + delta];
if (target) this._storyPickTurn(target.id);
},
// ── Fetching ──
_storyScheduleRefresh(delay = STORY_REFRESH_DEBOUNCE_MS) {
const st = this._story;
if (!st?.open) return;
clearTimeout(st.refreshTimer);
st.refreshTimer = setTimeout(() => this._storyRefresh(), delay);
},
async _storyRefresh() {
const st = this._story;
if (!st?.open) return;
if (st.inFlight) {
st.again = true;
return;
}
st.inFlight = true;
const epoch = st.epoch;
try {
const qs = st.turnId ? `?turn=${encodeURIComponent(st.turnId)}` : '';
const res = await this._api(`/api/sessions/${encodeURIComponent(st.sessionId)}/story${qs}`);
if (epoch !== st.epoch || !st.open) return;
let body = null;
try {
body = res ? await res.json() : null;
} catch {
body = null;
}
if (epoch !== st.epoch || !st.open) return;
if (!res || !res.ok || !body?.success) {
st.error =
body?.error || (res?.status === 404 ? 'This session is gone.' : 'Story Mode could not read this session.');
} else {
st.error = null;
st.data = body.data;
}
this._storyRender();
} finally {
st.inFlight = false;
if (st.again) {
st.again = false;
this._storyScheduleRefresh(250);
}
}
},
// ── Runtime: frame loop, observers, poll, Escape ──
_storyStartRuntime() {
const st = this._story;
st.ro = new ResizeObserver((entries) => {
for (const entry of entries) {
const rt = st.panels.find((p) => p.el === entry.target);
if (rt) this._storySizePanel(rt);
}
});
st.io = new IntersectionObserver((entries) => {
for (const entry of entries) {
const rt = st.panels.find((p) => p.el === entry.target);
if (rt) rt.visible = entry.isIntersecting;
}
});
for (const rt of st.panels) {
st.ro.observe(rt.el);
st.io.observe(rt.el);
}
let last = 0;
const reduced = matchMedia('(prefers-reduced-motion: reduce)');
const loop = (t) => {
if (!st.open) return;
const dt = last ? Math.min(100, t - last) : 16;
last = t;
if (!reduced.matches && !document.hidden) {
for (const rt of st.panels) {
if (!rt.visible) continue;
rt.clock += (dt / 1000) * StoryArt.FPS;
this._storyDrawPanel(rt);
}
}
st.raf = requestAnimationFrame(loop);
};
st.raf = requestAnimationFrame(loop);
st.pollTimer = setInterval(() => {
const page = st.data?.page;
if (!st.open || document.hidden || st.turnId) return;
if (!page || !page.complete) this._storyRefresh();
}, STORY_POLL_MS);
st.keyHandler = (e) => {
if (e.key !== 'Escape' || !st.open) return;
// The file preview or folder grid opened from a panel is on top: its own Escape closes it.
if (document.getElementById('filePreviewOverlay')?.classList.contains('visible')) return;
if (document.getElementById('folderGridOverlay')?.classList.contains('visible')) return;
e.preventDefault();
e.stopPropagation();
if (st.drawer) this._storyCloseDrawer();
else this.closeStoryMode();
};
window.addEventListener('keydown', st.keyHandler, true);
st.skinObserver = new MutationObserver(() => {
this._storyApplyTheme();
for (const rt of st.panels) this._storyDrawPanel(rt);
});
st.skinObserver.observe(document.documentElement, { attributes: true, attributeFilter: ['data-skin', 'class'] });
document.fonts?.ready?.then(() => {
if (!st.open) return;
for (const rt of st.panels) {
rt.bgKey = '';
this._storyDrawPanel(rt);
}
});
},
_storyStopRuntime() {
const st = this._story;
cancelAnimationFrame(st.raf);
st.raf = 0;
clearTimeout(st.refreshTimer);
clearInterval(st.pollTimer);
st.refreshTimer = null;
st.pollTimer = null;
st.ro?.disconnect();
st.io?.disconnect();
st.skinObserver?.disconnect();
st.ro = st.io = st.skinObserver = null;
if (st.keyHandler) window.removeEventListener('keydown', st.keyHandler, true);
st.keyHandler = null;
},
// ── Rendering ──
_storyRender() {
const st = this._story;
if (!st?.open) return;
const data = st.data;
const page = data?.supported ? data.page : null;
const turns = data?.supported ? data.turns : [];
// Bar: turn picker, prev/next, LIVE.
const sel = st.turnSelect;
sel.replaceChildren(
...turns.map((t, i) => {
const o = document.createElement('option');
o.value = t.id;
o.textContent = `${i + 1}. ${t.prompt || (t.origin === 'task' ? 'Background task' : 'Earlier work')}`;
return o;
})
);
if (page) sel.value = page.id;
sel.disabled = turns.length < 2;
const idx = page ? turns.findIndex((t) => t.id === page.id) : -1;
st.prev.disabled = idx <= 0;
st.next.disabled = idx < 0 || idx >= turns.length - 1;
st.live.hidden = !(page && !page.complete && !page.interrupted && !st.turnId);
// Note line: errors, unsupported sessions, empty sessions, cut pages.
let note = '';
if (st.error) note = st.error;
else if (!data) note = 'Reading the session…';
else if (!data.supported) note = data.reason;
else if (!page) note = 'Nothing to draw yet. The page fills in as soon as Claude starts working in this session.';
else if (page.partial)
note = 'This turn started before the part of the transcript Story Mode reads, so its first panels are missing.';
else if (page.truncated) note = 'A long turn: the oldest outputs were left out to keep the page fast.';
st.note.textContent = note;
st.note.hidden = !note;
this._storyRenderPanels(page);
if (st.director) this._storyRenderWire();
if (st.drawer) this._storyRenderDrawer(false);
// Panels on screen when a page first loads are drawn finished; only later arrivals animate in.
if (data) st.first = false;
},
_storyRenderPanels(page) {
const st = this._story;
const want = page ? page.panels : [];
const working = !!page && !page.complete && !page.interrupted;
// While the turn runs, the pencils placeholder takes the next slot, so the newest panel keeps
// its own width instead of stretching to the end of the row.
const prefs = want.map(storyPreferredSpan).concat(working ? [2] : []);
const spans6 = storyLayoutSpans(prefs, 6);
const spans2 = storyLayoutSpans(
prefs.map((p) => (p >= 4 ? 2 : 1)),
2
);
const fresh = !st.first;
want.forEach((panel, i) => {
let rt = st.panels[i];
if (rt && rt.kind !== panel.kind) {
this._storyDropPanel(rt);
rt = null;
}
if (!rt) {
rt = this._storyCreatePanel(panel.kind, fresh);
const after = st.panels[i - 1]?.el;
if (after) after.after(rt.el);
else st.pageEl.prepend(rt.el);
st.panels[i] = rt;
st.ro?.observe(rt.el);
st.io?.observe(rt.el);
}
rt.panel = panel;
rt.el.style.setProperty('--story-span6', String(spans6[i]));
rt.el.style.setProperty('--story-span2', String(spans2[i]));
this._storyFillPanelText(rt, page, i);
this._storyDrawPanel(rt);
});
for (const rt of st.panels.splice(want.length)) this._storyDropPanel(rt);
// While the turn runs, a blue-pencil rough stands where the next panel will be inked.
let pencils = st.pageEl.querySelector('.story-pencils');
if (working && !pencils) {
pencils = document.createElement('div');
pencils.className = 'story-pencils';
const word = document.createElement('span');
word.textContent = 'Pencils';
const small = document.createElement('small');
small.textContent = 'Claude is working…';
pencils.append(word, small);
}
if (working) {
pencils.style.setProperty('--story-span6', String(spans6[want.length]));
pencils.style.setProperty('--story-span2', String(spans2[want.length]));
st.pageEl.append(pencils);
} else pencils?.remove();
},
_storyCreatePanel(kind, fresh) {
const fig = document.createElement('figure');
fig.className = `story-panel${fresh ? ' story-fresh' : ''}`;
fig.dataset.kind = kind;
const canvas = document.createElement('canvas');
canvas.setAttribute('aria-hidden', 'true');
const cap = document.createElement('p');
cap.className = 'story-cap';
const capStory = document.createElement('span');
capStory.className = 'story-cap-story';
const capDir = document.createElement('span');
capDir.className = 'story-cap-dir';
cap.append(capStory, capDir);
const balloon = document.createElement('p');
balloon.className = 'story-balloon';
balloon.hidden = true;
const liveTag = document.createElement('span');
liveTag.className = 'story-live-tag';
liveTag.textContent = 'LIVE';
liveTag.hidden = true;
fig.append(canvas, cap, balloon, liveTag);
let splash = null;
if (kind === 'complete') {
splash = document.createElement('div');
splash.className = 'story-splash';
const titleEl = document.createElement('p');
titleEl.className = 'story-splash-title';
const chips = document.createElement('ul');
chips.className = 'story-chips';
splash.append(titleEl, cap, balloon, chips);
fig.append(splash);
}
let answer = null;
if (kind === 'ask') {
answer = document.createElement('p');
answer.className = 'story-answer';
answer.hidden = true;
fig.append(answer);
}
return {
el: fig,
canvas,
ctx: canvas.getContext('2d'),
kind,
panel: null,
capStory,
capDir,
balloon,
liveTag,
splash,
answer,
clock: fresh && !matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : StoryArt.HERO,
w: 0,
h: 0,
dpr: 1,
bg: null,
bgKey: '',
hitEls: new Map(),
visible: true,
};
},
_storyDropPanel(rt) {
this._story?.ro?.unobserve(rt.el);
this._story?.io?.unobserve(rt.el);
rt.el.remove();
rt.bg = null;
},
_storyFillPanelText(rt, page, index) {
const p = rt.panel;
rt.capStory.textContent = p.caption.story;
rt.capDir.textContent = p.caption.director || p.caption.story;
const balloonText = p.kind === 'ask' && p.question?.text ? p.question.text : p.balloon?.text;
rt.balloon.hidden = !balloonText;
rt.balloon.textContent = balloonText || '';
rt.balloon.className = `story-balloon ${p.kind === 'mission' || p.balloon?.who === 'you' ? 'story-balloon--you' : 'story-balloon--claude'}`;
rt.liveTag.hidden = !p.live;
rt.el.classList.toggle('is-live', !!p.live);
rt.el.setAttribute('aria-label', `Panel ${index + 1}: ${p.caption.story}`);
if (rt.answer) {
rt.answer.hidden = !p.question?.answer;
rt.answer.textContent = p.question?.answer ? `You chose: ${p.question.answer}` : '';
}
if (rt.splash) {
rt.splash.querySelector('.story-splash-title').textContent = page.interrupted ? 'Stopped!' : 'Mission complete!';
const chips = rt.splash.querySelector('.story-chips');
const items = [];
if (page.durationMs !== undefined) items.push({ text: this._storyDuration(page.durationMs) });
if (page.filesChanged)
items.push({
text: `${page.filesChanged} file${page.filesChanged === 1 ? '' : 's'} changed`,
open: 'diff:page',
});
items.push({ text: `${page.toolCalls} tool call${page.toolCalls === 1 ? '' : 's'}`, open: 'list:page' });
if (page.helpers) items.push({ text: `${page.helpers} helper${page.helpers === 1 ? '' : 's'}` });
chips.replaceChildren(
...items.map((item) => {
const li = document.createElement('li');
const inner = document.createElement(item.open ? 'button' : 'span');
if (item.open) {
inner.type = 'button';
inner.dataset.storyOpen = item.open;
}
inner.textContent = item.text;
li.append(inner);
return li;
})
);
}
},
_storyDuration(ms) {
const s = Math.round(ms / 1000);
if (s < 60) return `${s} s`;
const m = Math.floor(s / 60);
return m < 60 ? `${m} min ${s % 60} s` : `${Math.floor(m / 60)} h ${m % 60} min`;
},
_storySizePanel(rt) {
const w = rt.el.clientWidth;
const h = rt.el.clientHeight;
const dpr = Math.min(window.devicePixelRatio || 1, 2);
if (w === rt.w && h === rt.h && dpr === rt.dpr) return;
rt.w = w;
rt.h = h;
rt.dpr = dpr;
rt.canvas.width = Math.max(1, Math.round(w * dpr));
rt.canvas.height = Math.max(1, Math.round(h * dpr));
rt.bgKey = '';
this._storyDrawPanel(rt);
},
_storyDrawPanel(rt) {
const st = this._story;
if (!rt.panel || !rt.w || !rt.h) return;
const scene = StoryArt.SCENES[rt.kind];
if (!scene) return;
const s = rt.h / StoryArt.VH;
const W = rt.w / s;
const k = rt.dpr * s;
const key = `${rt.canvas.width}x${rt.canvas.height}|${StoryArt.C.key}`;
if (rt.bgKey !== key) {
rt.bg ??= document.createElement('canvas');
rt.bg.width = rt.canvas.width;
rt.bg.height = rt.canvas.height;
const b = rt.bg.getContext('2d');
b.setTransform(k, 0, 0, k, 0, 0);
scene.bg(b, W, StoryArt.VH);
rt.bgKey = key;
}
const ctx = rt.ctx;
ctx.setTransform(1, 0, 0, 1, 0, 0);
ctx.clearRect(0, 0, rt.canvas.width, rt.canvas.height);
ctx.drawImage(rt.bg, 0, 0);
ctx.setTransform(k, 0, 0, k, 0, 0);
const hits = [];
const hit = (id, x, y, w, h, label) => hits.push({ id, x, y, w, h, label });
scene.draw(ctx, W, StoryArt.VH, rt.clock, { panel: rt.panel, page: st.data?.page, director: st.director }, hit);
this._storySyncHits(rt, hits, s);
},
/** Canvas click regions become real buttons: focusable, labelled, keyboard-reachable. */
_storySyncHits(rt, hits, s) {
const seen = new Set();
for (const h of hits) {
seen.add(h.id);
let b = rt.hitEls.get(h.id);
if (!b) {
b = document.createElement('button');
b.type = 'button';
b.className = 'story-hit';
b.setAttribute('aria-label', h.label);
b.title = h.label;
rt.el.appendChild(b);
rt.hitEls.set(h.id, b);
}
b.dataset.storyOpen = `${h.id}@${rt.el.dataset.kind}:${this._story.panels.indexOf(rt)}`;
const L = Math.round(h.x * s);
const T = Math.round(h.y * s);
const Wd = Math.round(h.w * s);
const Ht = Math.round(h.h * s);
const k = `${L},${T},${Wd},${Ht}`;
if (b._k !== k) {
b._k = k;
b.style.cssText = `left:${L}px;top:${T}px;width:${Wd}px;height:${Ht}px`;
}
}
for (const [id, b] of rt.hitEls) {
if (!seen.has(id)) {
b.remove();
rt.hitEls.delete(id);
}
}
},
// ── The wire ──
_storyRenderWire() {
const st = this._story;
const page = st.data?.supported ? st.data.page : null;
const list = st.wireList;
if (!page) {
list.replaceChildren();
st.wireCount.textContent = '';
return;
}
const panelOf = new Map();
page.panels.forEach((p, i) => p.events.forEach((e) => panelOf.set(e, i)));
const rows = [];
let lastPanel = -2;
page.events.forEach((ev, i) => {
const pi = panelOf.has(i) ? panelOf.get(i) : lastPanel;
if (pi !== lastPanel && pi >= 0) {
const g = document.createElement('li');
g.className = 'story-wire-group';
g.textContent = `Panel ${pi + 1} · ${STORY_KIND_NAMES[page.panels[pi].kind] || page.panels[pi].kind}`;
rows.push(g);
lastPanel = pi;
}
rows.push(this._storyEventRow(ev, i));
});
list.replaceChildren(...rows);
st.wireCount.textContent = `${page.toolCalls} tool call${page.toolCalls === 1 ? '' : 's'}, ${page.events.length} events. Underlined parts open.`;
},
_storyEventRow(ev, index) {
const li = document.createElement('li');
li.className = 'story-ev';
li.dataset.actor = ev.actor;
const t = document.createElement('span');
t.className = 'story-ev-time';
const d = new Date(ev.at);
t.textContent = Number.isNaN(d.getTime())
? ''
: d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: false });
const body = document.createElement('span');
body.className = 'story-ev-body';
const who = document.createElement('span');
who.className = 'story-ev-who';
who.textContent = ev.actor;
const tool = document.createElement('b');
tool.textContent = ev.tool;
const target = this._storyEventTarget(ev, index);
let label;
if (target) {
label = document.createElement('button');
label.type = 'button';
label.className = 'story-link';
label.dataset.storyOpen = target;
} else {
label = document.createElement('span');
}
label.textContent = ev.label;
const tag = document.createElement('i');
tag.className = `story-tag story-tag--${ev.ok === false ? 'bad' : ev.pending ? 'pending' : ev.intent}`;
tag.textContent = ev.ok === false ? 'error' : ev.pending ? 'running' : ev.intent;
body.append(who, ' ', tool, ' ', label, ' ', tag);
li.append(t, body);
return li;
},
/** What a click on an event opens, as a `data-story-open` target, or null. */
_storyEventTarget(ev, index) {
if (ev.edit) return `diff:event:${index}`;
if (ev.helper) return `helper:event:${index}`;
if (ev.output !== undefined || ev.outputTruncated) return `output:event:${index}`;
if (ev.file) return `file:event:${index}`;
if (ev.question) return `ask:event:${index}`;
if (ev.todos) return `plan:event:${index}`;
return null;
},
// ── Click targets and the drawer ──
/**
* Targets: `<what>@<kind>:<panel>` from a canvas hit, `<what>:event:<i>` from the wire or the
* drawer, `<what>:page` from the final panel's chips.
*/
_storyOpenTarget(target, trigger) {
const st = this._story;
const page = st.data?.page;
if (!page) return;
const at = target.indexOf('@');
if (at >= 0) {
const what = target.slice(0, at);
const panelIndex = Number(target.slice(target.lastIndexOf(':') + 1));
const panel = page.panels[panelIndex];
if (!panel) return;
if (what.startsWith('file:')) {
const file = panel.files?.[Number(what.slice(5))];
if (file) this.openFilePreview?.(file, st.sessionId);
return;
}
const [view, arg] = what.split(':');
if (view === 'helper') {
this._storyOpenDrawer({ view: 'helper', event: page.events[Number(arg)]?.id }, trigger);
return;
}
this._storyOpenDrawer({ view, panel: panelIndex, kind: panel.kind }, trigger);
return;
}
const [view, scope, arg] = target.split(':');
if (scope === 'page') {
this._storyOpenDrawer({ view, page: true }, trigger);
return;
}
const ev = page.events[Number(arg)];
if (!ev) return;
if (view === 'file') {
this.openFilePreview?.(ev.file, st.sessionId);
return;
}
this._storyOpenDrawer({ view, event: ev.id }, trigger);
},
_storyOpenDrawer(source, trigger) {
const st = this._story;
if (!st.drawer) st.drawerReturn = trigger || null;
st.drawer = source;
st.drawerSeen = new Set();
st.drawerEl.hidden = false;
st.root.classList.add('has-drawer');
this._storyRenderDrawer(true);
st.drawerEl.querySelector('.story-drawer-close')?.focus({ preventScroll: true });
},
_storyCloseDrawer({ refocus = true } = {}) {
const st = this._story;
if (!st?.drawer) return;
st.drawer = null;
st.drawerEl.hidden = true;
st.root.classList.remove('has-drawer');
st.drawerBody.replaceChildren();
const back = st.drawerReturn;
st.drawerReturn = null;
if (refocus && back && document.contains(back)) back.focus({ preventScroll: true });
},
/** The events a drawer shows, recomputed from the newest page so a live view keeps up. */
_storyDrawerEvents(source, page) {
if (source.event) {
const i = page.events.findIndex((e) => e.id === source.event);
return i >= 0 ? [{ ev: page.events[i], i }] : [];
}
let indices;
if (source.page) indices = page.events.map((_, i) => i);
else {
const panel = page.panels[source.panel];
// A refresh can regroup panels; follow the panel by kind if the index moved.
const match = panel && panel.kind === source.kind ? panel : page.panels.find((p) => p.kind === source.kind);
indices = match ? match.events : [];
}
return indices.map((i) => ({ ev: page.events[i], i })).filter((x) => x.ev);
},
_storyRenderDrawer(first) {
const st = this._story;
const source = st.drawer;
const page = st.data?.page;
if (!source || !page) return;
const items = this._storyDrawerEvents(source, page);
const body = st.drawerBody;
const prevScroll = body.scrollTop;
const el = (tag, cls, text) => {
const n = document.createElement(tag);
if (cls) n.className = cls;
if (text != null) n.textContent = text;
return n;
};
const live = !page.complete && !page.interrupted && !st.turnId;
st.drawerLive.hidden = !live;
let kind = '';
let title = '';
let sub = '';
const out = [];
let firstNew = null;
const isNew = (id) => !first && !st.drawerSeen.has(id);
if (source.view === 'diff') {
const edits = items.filter((x) => x.ev.edit);
kind = live ? 'Live diff' : 'Diff';
const added = edits.reduce((n, x) => n + x.ev.edit.added, 0);
const removed = edits.reduce((n, x) => n + x.ev.edit.removed, 0);
const files = new Set(edits.map((x) => x.ev.edit.file)).size;
title = files === 1 ? edits[0].ev.edit.file : `${files} files`;
sub = `${edits.length} edit${edits.length === 1 ? '' : 's'} · +${added} −${removed}${live ? ' · new edits slide in as Claude makes them' : ''}`;
if (!edits.length) out.push(el('p', 'story-empty', 'No changes in this part of the turn yet.'));
for (const { ev } of edits) {
const section = this._storyDiffSection(ev, el);
if (isNew(ev.id)) {
section.classList.add('story-arrive');
firstNew ??= section;
}
out.push(section);
}
} else if (source.view === 'output' || source.view === 'list') {
const withOutput = items.filter((x) => x.ev.tool !== 'Text' && x.ev.intent !== 'prompt');
kind = source.view === 'list' ? 'Steps' : 'Output';
title = source.page ? 'Every step of this turn' : STORY_KIND_NAMES[source.kind] || 'Steps';
sub = `${withOutput.length} step${withOutput.length === 1 ? '' : 's'}`;
if (!withOutput.length) out.push(el('p', 'story-empty', 'Nothing here yet.'));
for (const { ev, i } of withOutput) {
const section = this._storyOutputSection(ev, i, el);
if (isNew(ev.id)) {
section.classList.add('story-arrive');
firstNew ??= section;
}
out.push(section);
}
} else if (source.view === 'helper') {
const ev = items[0]?.ev;
kind = 'Helper';
title = ev?.helper ? `${ev.helper.name} (${ev.helper.type})` : 'Helper';
const h = ev?.helper;
sub = h
? [
h.toolUses !== undefined ? `${h.toolUses} tool calls` : '',
h.durationMs !== undefined ? this._storyDuration(h.durationMs) : '',
ev.pending ? 'still working' : '',
]
.filter(Boolean)
.join(' · ')
: '';
if (h) {
out.push(el('h4', 'story-h', 'Claude asked'), el('pre', 'story-pre', h.prompt || '(no prompt)'));
out.push(
el('h4', 'story-h', 'The helper answered'),
this._storyLinkifiedPre(h.result || (ev.pending ? 'Still working…' : '(no answer)'))
);
}
} else if (source.view === 'plan') {
const ev = [...items].reverse().find((x) => x.ev.todos)?.ev;
kind = 'Plan';
title = 'The plan';
const ul = el('ul', 'story-todos');
for (const t of ev?.todos || []) {
const li = el('li', t.done ? 'is-done' : '', t.text);
ul.append(li);
}
if (!ev) for (const x of items) ul.append(el('li', '', x.ev.label));
out.push(ul);
} else if (source.view === 'ask') {
const ev = items.find((x) => x.ev.question)?.ev;
kind = 'Your call';
title = ev?.question?.text || 'Question';
if (ev?.question?.options?.length) {
const ul = el('ul', 'story-todos');
for (const o of ev.question.options) ul.append(el('li', o === ev.question.answer ? 'is-done' : '', o));
out.push(ul);
}
out.push(
el(
'p',
'story-answer-line',
ev?.question?.answer ? `You chose: ${ev.question.answer}` : 'Waiting for your answer in the terminal.'
)
);
}
st.drawerKind.textContent = kind;
st.drawerTitle.textContent = title;
st.drawerSub.textContent = sub;
body.replaceChildren(...out);
for (const { ev } of items) st.drawerSeen.add(ev.id);
if (first) body.scrollTop = 0;
else if (firstNew) body.scrollTop = Math.max(0, firstNew.offsetTop - 12);
else body.scrollTop = prevScroll;
},
_storyDiffSection(ev, el) {
const edit = ev.edit;
const section = el('section', 'story-df');
const head = el('div', 'story-df-head');
const name = el('span', 'story-df-path', edit.file);
const cnt = el('span', 'story-cnt');
cnt.append(
el('span', 'story-cnt-a', edit.added ? `+${edit.added}` : ''),
' ',
el('span', 'story-cnt-d', edit.removed ? `−${edit.removed}` : '')
);
const open = document.createElement('button');
open.type = 'button';
open.className = 'story-btn-s';
open.textContent = 'Open file';
open.addEventListener('click', () => this.openFilePreview?.(edit.file, this._story.sessionId));
head.append(name, cnt, open);
section.append(head);
const code = el('div', 'story-code');
for (const h of edit.hunks || []) {
code.append(
el('div', 'story-ln story-ln--hunk', `@@ -${h.oldStart},${h.oldLines} +${h.newStart},${h.newLines} @@`)
);
let o = h.oldStart;
let n = h.newStart;
for (const line of h.lines) {
const mark = line[0];
const row = el('div', `story-ln${mark === '+' ? ' story-ln--add' : mark === '-' ? ' story-ln--del' : ''}`);
row.append(
el('span', 'story-ln-no', mark === '+' ? '' : String(o)),
el('span', 'story-ln-no', mark === '-' ? '' : String(n)),
el('span', 'story-ln-mk', mark === '+' ? '+' : mark === '-' ? '−' : ''),
el('span', 'story-ln-tx', line.slice(1) || ' ')
);
if (mark !== '+') o++;
if (mark !== '-') n++;
code.append(row);
}
}
section.append(code);
if (edit.truncated)
section.append(el('p', 'story-empty', 'Some lines of this edit were left out. Open the file to see all of it.'));
return section;
},
_storyOutputSection(ev, index, el) {
const section = el('section', 'story-out');
const head = el('div', 'story-out-head');
const cmd = el('span', 'story-out-cmd', `${ev.tool === 'Bash' ? '$ ' : `${ev.tool} `}${ev.label}`);
const status = el(
'span',
`story-tag story-tag--${ev.ok === false ? 'bad' : ev.pending ? 'pending' : 'ok'}`,
ev.ok === false ? 'error' : ev.pending ? 'running' : 'ok'
);
head.append(cmd, status);
section.append(head);
if (ev.description) section.append(el('p', 'story-out-desc', ev.description));
const target = this._storyEventTarget(ev, index);
if (ev.output !== undefined) {
section.append(this._storyLinkifiedPre(ev.output));
if (ev.outputTruncated) section.append(el('p', 'story-empty', 'Only the end of this output is kept.'));
} else if (ev.outputTruncated) {
section.append(el('p', 'story-empty', 'This output was left out to keep a long turn fast.'));
} else if (target && !target.startsWith('output:')) {
const b = el('button', 'story-btn-s', ev.edit ? 'See the change' : ev.file ? 'Open file' : 'Open');
b.type = 'button';
b.dataset.storyOpen = target;
section.append(b);
}
return section;
},
/** Output text with every file path as a link into the file preview (the terminal's own matcher). */
_storyLinkifiedPre(text) {
const pre = document.createElement('pre');
pre.className = 'story-pre';
const value = String(text || '');
const links = typeof findFilePathLinks === 'function' ? findFilePathLinks(value).filter((l) => !l.folder) : [];
const workingDir = this.sessions?.get(this._story.sessionId)?.workingDir;
let last = 0;
for (const link of links) {
pre.append(document.createTextNode(value.slice(last, link.index)));
const b = document.createElement('button');
b.type = 'button';
b.className = 'story-link';
b.textContent = link.path;
const resolved =
typeof resolveLinkedFilePath === 'function' ? resolveLinkedFilePath(link.path, workingDir) : link.path;
b.addEventListener('click', () => this.openFilePreview?.(resolved, this._story.sessionId));
pre.append(b);
last = link.index + link.path.length;
}
pre.append(document.createTextNode(value.slice(last)));
return pre;
},
});