Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
fix(timeline): ship the milestones file with the build so /timeline loads in production, and keep helper widgets off its controls
nirholas9ff3e931c3fe
diff --git a/data/changelog.json b/data/changelog.jsonindex a3898df3c..e274bdb61 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -25510,16 +25510,6 @@"fix"],"link": "/terminal"- },- {- "date": "2026-09-01",- "title": "Documentation sweep: 164 docs re-checked against the code they describe",- "summary": "Every doc the freshness gate flagged as describing code that had moved since it was written (174 of them, from the UX flow walkthroughs and the Oracle model write-up to the ops runbooks, tutorials, and the agent-abilities chapters) was re-read against the current code. 164 were corrected or extended: renamed routes now point at /agents/:id, retired model names and provider ladders are current, counts and thresholds match what ships, and the resilience work of the last month (last-good caches, typed 503s with Retry-After, the RPC read guards) is described where it applies. Along the way three things the docs promised were made true in the product: the Herald posting scope can now be minted from the dashboard key form, the translation script defaults to a Groq model that still exists, and the home page OpenAPI link opens the spec directly.",- "tags": [- "docs",- "fix"- ],- "link": "/docs/freshness"}]}diff --git a/data/timeline.json b/data/timeline.jsonindex cb169adea..931ab1e80 100644--- a/data/timeline.json+++ b/data/timeline.json@@ -58,6 +58,7 @@{ "id": "2026-07-10-nemotron-pipeline", "date": "2026-07-10", "title": "NVIDIA forum: Nemotron models power the text-to-3D pipeline", "category": "press", "summary": "An NVIDIA Developer Forums post explains how small Nemotron models act as validators and safety/reasoning layers in front of the Microsoft TRELLIS text-to-3D generator on NVIDIA NIM: 12-13 second generations, ~340ms content-safety latency.", "source_url": "https://forums.developer.nvidia.com/t/how-nemotron-made-three-ws-text-to-3d-pipeline-usable/376445", "importance": 3 },{ "id": "2026-07-11-ibm-community-corner", "date": "2026-07-11", "title": "IBM corner/community launch", "category": "partnership", "summary": "three.ws's dedicated corner/community space launches on IBM Community.", "source_url": "https://community.ibm.com/community/user/usergroup?CommunityKey=e71510cc-d953-408f-9a1c-019f5c0a7016", "importance": 3 },{ "id": "2026-07-13-huggingface", "date": "2026-07-13", "title": "Hugging Face PRO listing, #1 trending", "category": "listing", "summary": "three.ws lists on Hugging Face PRO and reaches #1 trending.", "source_url": null, "importance": 4 },+ { "id": "2026-07-13-huggingface-bodies-wallets", "date": "2026-07-13", "title": "First Hugging Face article: giving AI agents bodies and wallets", "category": "press", "summary": "three.ws publishes its first Hugging Face community article, Giving AI Agents Bodies and Wallets. It opens on the thesis the platform runs on: most AI agents are a chat window, and ours walk around and pay each other.", "source_url": "https://huggingface.co/blog/three-ws/giving-ai-agents-bodies-and-wallets", "importance": 3 },{ "id": "2026-07-14-ibm-user-group", "date": "2026-07-14", "title": "IBM launches the three.ws User Group", "category": "press", "summary": "IBM Community announces the three.ws User Group, a space for developers building 3D AI agents, covering generative 3D, spatial reasoning, and agentic pipelines.", "source_url": "https://community.ibm.com/community/user/blogs/jessica-swanson/2026/07/14/welcome-to-the-threews-user-group-building-ai-agen", "importance": 3 },{ "id": "2026-07-14-ibm-platform-tour", "date": "2026-07-14", "title": "IBM discussion: full platform tour", "category": "press", "summary": "An IBM Community post gives a full tour of three.ws: free text-to-3D at /forge, auto-rigging across Mixamo/VRM/Avaturn/MakeHuman, the <agent-3d> embed component, and a multiplayer world at /play.", "source_url": "https://community.ibm.com/community/user/discussion/welcome-to-the-threews-ibm-community-a-full-tour-of-the-platform-start-here", "importance": 2 },{ "id": "2026-07-15-openai-partner-network", "date": "2026-07-15", "title": "OpenAI Partner Network + ChatGPT 3D Studio", "category": "partnership", "summary": "three.ws joins the OpenAI Partner Network alongside its ChatGPT 3D Studio GPT presence.", "source_url": null, "importance": 4 },@@ -71,6 +72,13 @@{ "id": "2026-07-19-nvidia-i18n-pipeline", "date": "2026-07-19", "title": "NVIDIA forum: 100+ language i18n pipeline detailed", "category": "press", "summary": "An NVIDIA Developer Forums post details the localization pipeline behind the July 16 launch: NVIDIA NIM running Llama 3.3 70B Instruct with sentinel masking, incremental diffing, and explicit right-to-left handling.", "source_url": "https://forums.developer.nvidia.com/t/how-three-ws-translates-a-web-app-into-100-languages-with-nvidia-nim-an-llm-powered-i18n-pipeline/377379", "importance": 3 },{ "id": "2026-07-20-quicknode-followup", "date": "2026-07-20", "title": "QuickNode Startup Program (follow-up post)", "category": "product", "summary": "@trythreews posts a follow-up on the QuickNode Startup Program relationship first established June 9.", "source_url": null, "importance": 1 },{ "id": "2026-07-24-500-props", "date": "2026-07-24", "title": "500+ free 3D props library milestone", "category": "milestone", "summary": "three.ws's free 3D props library surpasses 500 items.", "source_url": null, "importance": 2 },- { "id": "2026-07-25-openai-select-partner", "date": "2026-07-25", "title": "Named an OpenAI Select Partner", "category": "partnership", "summary": "three.ws is named an OpenAI Select Partner within the OpenAI Partner Network, alongside the free 3D Studio MCP connector that brings keyless 3D generation into ChatGPT.", "source_url": "https://three.ws/openai", "importance": 3 }+ { "id": "2026-07-25-openai-select-partner", "date": "2026-07-25", "title": "Named an OpenAI Select Partner", "category": "partnership", "summary": "three.ws is named an OpenAI Select Partner within the OpenAI Partner Network, alongside the free 3D Studio MCP connector that brings keyless 3D generation into ChatGPT.", "source_url": "https://three.ws/openai", "importance": 3 },+ { "id": "2026-08-19-3d-ar-studio-package", "date": "2026-08-19", "title": "AR Studio ships as an open-source package", "category": "product", "summary": "The multi-model AR surface behind three.ws becomes a standalone open-source package, 3d-ar-studio on npm, with a hosted demo. One script tag gives any web page a working augmented-reality viewer.", "source_url": "https://github.com/nirholas/3D-AR-Studio", "importance": 3 },+ { "id": "2026-08-27-seeker-home-screen", "date": "2026-08-27", "title": "Seeker app gets its own home screen and a verified badge", "category": "product", "summary": "The three.ws app on Solana Seeker opens on a home screen of its own at /seeker: one tap signs you in with Seed Vault, your agents are right there, and Seeker owners can carry a verified badge.", "source_url": "https://three.ws/seeker", "importance": 2 },+ { "id": "2026-08-28-android-app", "date": "2026-08-28", "title": "three.ws ships as an Android app", "category": "launch", "summary": "The signed three.ws app (v1.0.0) is published on GitHub and installs on any phone from Android 6 up: one-tap Solana wallet sign-in (Seed Vault on a Seeker), selfie to rigged 3D avatar, share-sheet intake, and agent minting on Solana mainnet from the phone. The Solana dApp Store listing is submitted the same day.", "source_url": "https://github.com/nirholas/three.ws/releases", "importance": 4 },+ { "id": "2026-08-28-glance", "date": "2026-08-28", "title": "Glance: your agent as a home-screen card", "category": "product", "summary": "Every agent gets a live card with its name, what it did in the last 24 hours, and when it last acted. It pins to the Windows 11 widgets board, renders in a GitHub README, and prints in a terminal.", "source_url": "https://three.ws/glance", "importance": 3 },+ { "id": "2026-08-29-android-widget", "date": "2026-08-29", "title": "Android 1.1: the agent on the home screen", "category": "product", "summary": "The Android app ships a home-screen widget showing your agent, its name, and how many moves it made today, refreshing in the background about every half hour without opening the app.", "source_url": "https://github.com/nirholas/three.ws/releases", "importance": 2 },+ { "id": "2026-08-29-coinmarketcap-android", "date": "2026-08-29", "title": "CoinMarketCap article announces three.ws for Android", "category": "press", "summary": "A CoinMarketCap community article covers the Android launch: what the app does that the mobile site cannot, and how the Solana-native sign-in works.", "source_url": "https://coinmarketcap.com/community/articles/6a926390b8e239054a8f42e6/", "importance": 2 },+ { "id": "2026-08-29-huggingface-end-to-end", "date": "2026-08-29", "title": "Second Hugging Face article: Building 3D AI Agents End to End", "category": "press", "summary": "The whole stack in one piece, written to be checked: every 3D generation lane and where it runs, rigging and animation for any humanoid, the multi-model brain and its guard chain, agent payments, and every program and partner behind the platform, with a live rigged avatar embedded in the article.", "source_url": "https://huggingface.co/blog/three-ws/building-3d-ai-agents-end-to-end", "importance": 3 }]}diff --git a/pages/timeline.html b/pages/timeline.htmlindex 2609c0c44..051d4bd70 100644--- a/pages/timeline.html+++ b/pages/timeline.html@@ -43,7 +43,7 @@.tl-header .sub { font-size: 0.72rem; color: rgba(255, 255, 255, 0.45); margin-left: auto; display: none; }@media (min-width: 720px) { .tl-header .sub { display: inline; } }- #timeline-root { flex: 1; min-height: 0; position: relative; }+ #timeline-root { flex: 1; min-height: 0; position: relative; overflow: hidden; }.tl-boot {position: absolute; inset: 0; display: flex; flex-direction: column; align-items: center; justify-content: center;diff --git a/prompts/swarm-100/route-timeline.md b/prompts/swarm-100/route-timeline.mddeleted file mode 100644index 98c749181..000000000--- a/prompts/swarm-100/route-timeline.md+++ /dev/null@@ -1,119 +0,0 @@-# Route audit: /timeline (The Story So Far)--How to run: paste this file's repo path into a fresh Claude Code chat in this-repository and say "run this work order". This file is fully self-contained:-it depends on no other prompt file anywhere. If neighboring files in-prompts/swarm-100/ are gone, that work is done; if present, ignore them.-Every claim below rots; step 0 re-measures, and what you measure wins.--## Operating clause (binding)--- Read CLAUDE.md first. Its rules override everything, including this file.-- Finish 100% in this session. Never end the turn with a question, an option- list, or an unexecuted plan. A judgment call goes in one line of the final- report; it never becomes a question that halts work.-- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real- funds or any irreversible on-chain write, git push or a production deploy,- committing content that references a crypto project other than $THREE, and- destroying unrecoverable data.-- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no- commented-out code. Real APIs and real integrations only.-- The em-dash and en-dash characters are banned in everything you write.-- Concurrent agents share this worktree: stage explicit paths only (never a- bare add-everything), and commit finished work promptly.-- Before committing, run: npm run check:rules -- --paths <files you touched>.- It must exit 0.--## Step 0: re-derive the current state--1. This route's declared entry (path, description, added date):-- node -e "const p=require('./data/pages.json');for(const s of p.sections)for(const g of s.pages)if(g.path==='/timeline')console.log(JSON.stringify(g,null,2))"--2. Find the serving implementation: grep "/timeline" in vercel.json (the live- route table server/index.mjs boots from), then list matching files in- pages/ and src/. STRUCTURE.md maps every surface to its directory if the- grep is ambiguous.-3. Production right now:-- curl -so /dev/null -w '%{http_code}\n' https://three.ws/timeline--4. Start (or reuse) the local dev server: npm run dev (vite, port 3000).--## Task: audit this one route end to end, then fix everything found--Route: /timeline ("The Story So Far", section "main").-Declared purpose: three.ws's history as an explorable 3D scene: every launch, partnership, listing, and milestone laid out along a path you can orbit in 360° or walk end to end, with a synced scrubber and source links.--Drive the page in a real headless browser. Playwright is already a dev-dependency; keep your probe script in the session scratchpad, never in the-repo.--1. Load http://localhost:3000/timeline. Record the HTTP status, every console- error and warning, and every failed network request.-2. Exercise it like a first-time user: click the primary actions, run the- primary flow if one exists, follow the page's internal links. Every button- must do something real; every link must resolve. If the page renders data,- prove in the network log that it came from a live endpoint, not a baked-in- fallback array.-3. States: verify populated, empty, loading, and error states are designed and- reachable. Block the page's primary fetch in Playwright and confirm an- actionable error state appears, not a blank void or a raw exception.-4. Responsive: render at 320, 768, and 1440 px. No horizontal page scroll, no- overlapping or clipped controls.-5. Accessibility basics: one h1; interactive elements are real buttons or- links with visible focus states; images carry alt text; form fields have- labels.-6. Head: a specific title tag and meta description that match the declared- purpose above.-7. Fix every defect at its root in the page's real source files and re-run the- probe until clean. Defects in shared modules are in scope when this route- exercises them.--## Definition of done--- [ ] Local load of /timeline: HTTP 200, zero console errors, zero unhandled- failed requests (a third-party outage must land in a designed fallback,- not a broken page).-- [ ] No dead interactive element on the page: no stub href="#", no button- without a handler, no link to a missing path.-- [ ] Empty, loading, error, and populated states verified.-- [ ] 320 / 768 / 1440 px renders verified clean.-- [ ] Title and meta description present and specific.-- [ ] npm test passes; npm run check:rules -- --paths <touched files> exits 0.-- [ ] Production status from step 0 recorded in the report; if production- needs a deploy to pick up a fix, the report says so (deploys stay- owner-gated).--## Never blocked--| Blocker | Resolution (act, do not ask) |-|---|---|-| Missing env var or credential | Check .env and .env.local, then the Cloud Run service env, then Secret Manager (the CLAUDE.md self-unblock playbook has the exact commands). If it truly exists nowhere, wire the code fully behind the env var, prove the wiring with a dry run, and name the single missing var in the report. |-| gcloud not on PATH | Run: export PATH="$HOME/google-cloud-sdk/bin:$PATH" |-| Dev server port 3000 busy | Another agent may be serving this repo; probe it and reuse if so. Otherwise start your own on a free port: npx vite --port 3101 |-| Playwright browser missing | npx playwright install chromium |-| A surface needs a signed-in user | Register a fresh account through the real /register flow against the real API and use it. Never mock the session. |-| A defect sits in code you did not touch | Fix it if it blocks a Definition of done line (root cause it, never mask it). Otherwise note it in the report and continue. |-| An unrelated test is red | Same rule. Never pipe npm test through tail; it masks exit codes. |--## Close out (required)--1. Verify every Definition of done line with the actual command output in- front of you. Never claim a line you did not verify.-2. Commit with explicit paths and a subject that describes the diff (house- style: type(scope): what changed and why a reader cares).-3. Delete this prompt file in that same commit:-- git rm prompts/swarm-100/route-timeline.md-- The shrinking directory is this campaign's only progress ledger; there is- no progress log to update.-4. Final report: what step 0 measured, what changed (file list), evidence per- Definition of done line, and any one-line judgment calls. No trailing- questions, no unexecuted plans.--If a line genuinely cannot pass inside this session (an external party must-respond, or an owner-gated action is the final step), finish everything else,-leave this file in place, and state exactly which line remains and who owns-it. Never delete this file on a partial.diff --git a/public/nav.js b/public/nav.jsindex afb1b0bfc..9423767a2 100644--- a/public/nav.js+++ b/public/nav.js@@ -840,7 +840,7 @@ const WALK_AUTO_KEY = 'walk:companion:auto';// second WebGL avatar there hurts more than it helps. (walk-sdk keeps its own// exclusion list too; this is the conservative outer gate.)const WALK_AUTO_SKIP =- /^\/(play|walk|club|tour|world|scan|arena|pose|splat|capture)(\/|$)|^\/create\/(selfie|video)/;+ /^\/(play|walk|club|tour|world|scan|arena|pose|splat|capture|timeline)(\/|$)|^\/create\/(selfie|video)/;function initCompanionAutoStart() {// Every check lives inside the deferred callback: boot() can run while thisdiff --git a/scripts/check-dist.mjs b/scripts/check-dist.mjsindex 8dc974f56..4607ccaf2 100644--- a/scripts/check-dist.mjs+++ b/scripts/check-dist.mjs@@ -9,6 +9,10 @@ const required = ['dist/agent-3d/latest/agent-3d.js','dist/agent-3d/latest/agent-3d.umd.cjs','dist/agent-3d/versions.json',+ // The one runtime fetch behind /timeline (copied by vite.config.js's+ // copy-timeline-data hook). It was missing from every production build+ // until 2026-09-01, which left the page on its error state.+ 'dist/data/timeline.json',];let ok = true;diff --git a/src/timeline.js b/src/timeline.jsindex b0b9fad14..661dd2e14 100644--- a/src/timeline.js+++ b/src/timeline.js@@ -15,7 +15,6 @@ import {BufferGeometry,CanvasTexture,CatmullRomCurve3,- Clock,Color,CylinderGeometry,DirectionalLight,@@ -36,6 +35,7 @@ import {ACESFilmicToneMapping,Sprite,SpriteMaterial,+ Timer,Vector2,Vector3,WebGLRenderer,@@ -61,8 +61,14 @@ const boot = document.getElementById('timeline-boot');// ── Styles (injected once; keeps pages/timeline.html to a plain shell) ─────function injectStyles() {+ if (document.getElementById('tl-styles')) return;const css = `.tl-canvas { position: absolute; inset: 0; display: block; width: 100%; height: 100%; touch-action: none; outline: none; }+ .tl-canvas:focus-visible { outline: 2px solid rgba(154, 208, 255, 0.7); outline-offset: -3px; }+ .tl-mode-btn:focus-visible, .tl-filter-chip:focus-visible, .tl-nav-btn:focus-visible, .tl-tick:focus-visible,+ .tl-panel-close:focus-visible, .tl-panel-src:focus-visible, .tl-error button:focus-visible {+ outline: 2px solid #9ad0ff; outline-offset: 2px;+ }.tl-topbar {position: absolute; top: 0.85rem; left: 50%; transform: translateX(-50%);@@ -90,7 +96,16 @@ function injectStyles() {z-index: 20; display: flex; flex-direction: column; padding: 1.3rem 1.25rem;color: #eef2fa; overflow-y: auto;}- .tl-panel.is-open { transform: translateX(0); }+ /* Open, the panel is a surface the visitor asked for, so it sits above+ the ambient bottom-right helper stack (language pill, discovery card)+ on the ladder public/corner-stack.js publishes; on a phone that stack+ otherwise lands squarely on the milestone text in the sheet. */+ .tl-panel.is-open { transform: translateX(0); z-index: var(--z-overlay-modal, 2147483600); }+ /* The open panel owns the right edge, so the scrubber bar (a later+ sibling) gives up that column: Next and Play stay clickable while a+ milestone is being read instead of sitting under the panel. */+ .tl-panel.is-open ~ .tl-bottombar { right: min(380px, 100%); }+ .tl-panel.is-open ~ .tl-hint { display: none; }.tl-panel-close {position: absolute; top: 0.8rem; right: 0.8rem; width: 30px; height: 30px; border-radius: 50%;background: rgba(255,255,255,0.08); border: none; color: #fff; font-size: 1rem; cursor: pointer;@@ -109,6 +124,7 @@ function injectStyles() {font: 600 0.84rem system-ui, sans-serif; margin-top: auto; padding-top: 0.6rem;}.tl-panel-src:hover { text-decoration: underline; }+ .tl-panel-src[hidden] { display: none; }.tl-panel-counter { font: 600 0.72rem system-ui, sans-serif; color: rgba(255,255,255,0.4); margin-top: 0.4rem; }.tl-bottombar {@@ -133,7 +149,7 @@ function injectStyles() {}.tl-tick:hover { opacity: 0.9; }.tl-tick.is-active { height: 30px; opacity: 1; transform: translateY(-4px); }- .tl-tick.is-dim { opacity: 0.12; }+ .tl-tick.is-dim { opacity: 0.12; cursor: default; }.tl-scrub-label { text-align: center; font: 600 0.7rem system-ui, sans-serif; color: rgba(255,255,255,0.5); }.tl-hint {@@ -145,14 +161,20 @@ function injectStyles() {.tl-error button { font: 650 0.82rem system-ui, sans-serif; background: #7aa2ff; color: #06080f; border: none; border-radius: 999px; padding: 0.55rem 1.2rem; cursor: pointer; }@media (max-width: 640px) {- .tl-panel { width: 100%; height: min(62vh, 420px); top: auto; bottom: 0; right: 0;- transform: translateY(100%); border-left: none; border-top: 1px solid rgba(255,255,255,0.1); border-radius: 16px 16px 0 0; }+ /* Bottom sheet, parked ABOVE the scrubber bar (its measured height is+ published as --tl-bar-h) so prev / next / play stay reachable while+ a milestone is open, and the bar keeps its full width. */+ .tl-panel { width: 100%; height: min(56vh, 400px); top: auto; bottom: var(--tl-bar-h, 108px); right: 0;+ background: rgba(8, 10, 18, 0.97);+ transform: translateY(calc(100% + var(--tl-bar-h, 108px))); border-left: none; border-top: 1px solid rgba(255,255,255,0.1); border-radius: 16px 16px 0 0; }.tl-panel.is-open { transform: translateY(0); }+ .tl-panel.is-open ~ .tl-bottombar { right: 0; }.tl-bottombar { padding-bottom: 0.7rem; }.tl-hint { display: none; }}`;const tag = document.createElement('style');+ tag.id = 'tl-styles';tag.textContent = css;document.head.appendChild(tag);}@@ -263,24 +285,35 @@ function showError(message, onRetry) {root.appendChild(wrap);}+const EMPTY_MESSAGE = 'No milestones have been published yet. Check back soon.';+const OFFLINE_MESSAGE = 'Could not load the timeline. Check your connection and try again.';+async function loadData() {- const res = await fetch(DATA_URL, { cache: 'force-cache' });+ // Default HTTP caching, not force-cache: the file changes with every+ // deploy and the server already sets a bounded max-age on it.+ const res = await fetch(DATA_URL);if (!res.ok) throw new Error(`HTTP ${res.status} loading timeline data`);const json = await res.json();if (!json || !Array.isArray(json.events) || json.events.length === 0) {- throw new Error('Timeline data is empty');+ const err = new Error('Timeline data is empty');+ err.code = 'EMPTY';+ throw err;}return json;}+function loadErrorMessage(err) {+ return err?.code === 'EMPTY' ? EMPTY_MESSAGE : OFFLINE_MESSAGE;+}+async function boot_() {injectStyles();if (!supportsWebGL()) {try {const data = await loadData();renderFallback(data.events, 'Your browser can’t run the 3D scene.');- } catch {- showError('Could not load the timeline. Check your connection and try again.', () => location.reload());+ } catch (err) {+ showError(loadErrorMessage(err), () => location.reload());}return;}@@ -290,7 +323,7 @@ async function boot_() {mountTimeline(root, data);} catch (err) {log.warn('[timeline] load failed:', err?.message);- showError('Could not load the timeline. Check your connection and try again.', boot_);+ showError(loadErrorMessage(err), boot_);}}@@ -521,7 +554,10 @@ function mountTimeline(container, data) {m.beam.material.opacity = dim ? 0.06 : 0.35;m.label.material.opacity = dim ? 0.15 : 1;const tick = scrubTicks[m.index];- if (tick) tick.classList.toggle('is-dim', dim);+ if (tick) {+ tick.classList.toggle('is-dim', dim);+ tick.setAttribute('aria-disabled', String(dim));+ }});}@@ -539,9 +575,10 @@ function mountTimeline(container, data) {<div class="tl-panel-date" id="tl-panel-date"></div><h2 class="tl-panel-title" id="tl-panel-title"></h2><p class="tl-panel-summary" id="tl-panel-summary"></p>- <a class="tl-panel-src" id="tl-panel-src" target="_blank" rel="noopener noreferrer" style="display:none">Read the source ↗</a>+ <a class="tl-panel-src" id="tl-panel-src" target="_blank" rel="noopener noreferrer" hidden>Read the source ↗</a><div class="tl-panel-counter" id="tl-panel-counter"></div>`;+ panel.inert = true;container.appendChild(panel);panel.querySelector('.tl-panel-close').addEventListener('click', () => setPanelOpen(false));@@ -549,6 +586,9 @@ function mountTimeline(container, data) {state.panelOpen = open;panel.classList.toggle('is-open', open);panel.setAttribute('aria-hidden', open ? 'false' : 'true');+ // A closed panel is off-screen; keep its close button and source link+ // out of the tab order so keyboard users never focus something invisible.+ panel.inert = !open;if (open && state.mode === 'orbit') controls.autoRotate = false;}@@ -577,8 +617,11 @@ function mountTimeline(container, data) {const tick = document.createElement('button');tick.className = 'tl-tick';tick.style.background = categories[m.event.category]?.color || '#7aa2ff';- tick.setAttribute('aria-label', `${m.event.date} — ${m.event.title}`);+ tick.setAttribute('aria-label', `${m.event.date}: ${m.event.title}`);tick.addEventListener('click', () => {+ // Same rule as clicking a marker: a filtered-out milestone is not a+ // destination until its category is switched back on.+ if (!state.visibleCategories.has(m.event.category)) return;togglePlay(false);focusEvent(m.index, { fly: true });});@@ -659,9 +702,10 @@ function mountTimeline(container, data) {const srcLink = panel.querySelector('#tl-panel-src');if (m.event.source_url) {srcLink.href = m.event.source_url;- srcLink.style.display = 'inline-flex';+ srcLink.hidden = false;} else {- srcLink.style.display = 'none';+ srcLink.removeAttribute('href');+ srcLink.hidden = true;}panel.querySelector('#tl-panel-counter').textContent = `Milestone ${index + 1} of ${events.length}`;setPanelOpen(true);@@ -730,12 +774,37 @@ function mountTimeline(container, data) {ro.observe(container);resize();+ // ── keep the shared bottom-right helper stack off the scrubber ──+ // public/corner-stack.js lifts itself over a page's own bottom chrome by+ // probing for position:fixed boxes. This bar is absolute inside the scene+ // root, so it is invisible to that probe and the "Getting started" pill+ // landed on the auto-play button. Reserve the bar's live footprint the way+ // the concierge demo does, and re-measure whenever the bar changes size.+ const CORNER_KEY = 'timeline-scrubber';+ function syncCornerReserve() {+ if (state.destroyed) return;+ const r = bottombar.getBoundingClientRect();+ container.style.setProperty('--tl-bar-h', `${Math.ceil(r.height)}px`);+ const stack = window.twsCornerStack;+ if (!stack?.reserve) return;+ if (!r.height) {+ stack.release(CORNER_KEY);+ return;+ }+ stack.reserve(CORNER_KEY, { height: Math.max(0, Math.ceil(window.innerHeight - r.top)) });+ }+ const barRo = new ResizeObserver(syncCornerReserve);+ barRo.observe(bottombar);+ window.addEventListener('tws-corner-stack:ready', syncCornerReserve);+ syncCornerReserve();+// ── render loop ──- const clock = new Clock();+ const timer = new Timer();let raf = 0;function tick() {if (state.destroyed) return;- guideAnim?.update(clock.getDelta());+ timer.update();+ guideAnim?.update(timer.getDelta());if (state.mode === 'walk') {const t = currentWalkT();@@ -787,6 +856,9 @@ function mountTimeline(container, data) {cancelAnimationFrame(raf);clearTimeout(state.playTimer);ro.disconnect();+ barRo.disconnect();+ window.removeEventListener('tws-corner-stack:ready', syncCornerReserve);+ window.twsCornerStack?.release?.(CORNER_KEY);canvas.removeEventListener('pointerdown', onPointerDown);window.removeEventListener('keydown', onKeydown);controls.dispose();diff --git a/src/walk-companion.js b/src/walk-companion.jsindex c59eb8a8d..cfe0fac01 100644--- a/src/walk-companion.js+++ b/src/walk-companion.js@@ -39,7 +39,10 @@ const walk = createWalkCompanion({// is a persistent live stage of THIS user's agent, so the corner mascot is a// second copy of the same body, and its 218px corner reservation pushed the// stack's chips into the middle of the editing panel at 320px.- excludedRoutes: [...DEFAULT_EXCLUDED_PREFIXES, '/concierge', '/agent-studio'],+ // /timeline is a full-screen 3D scene with its own idle-animated guide+ // walking the path, and its bottom-right corner is the auto-play button:+ // the corner mascot sat exactly on top of it and swallowed the click.+ excludedRoutes: [...DEFAULT_EXCLUDED_PREFIXES, '/concierge', '/agent-studio', '/timeline'],});// public/nav.js drives the companion through this global (toggle from the navdiff --git a/tests/timeline-data.test.js b/tests/timeline-data.test.jsnew file mode 100644index 000000000..9840a5696--- /dev/null+++ b/tests/timeline-data.test.js@@ -0,0 +1,81 @@+/**+ * /timeline dataset integrity tests.+ *+ * The 3D history timeline (src/timeline.js) renders straight from+ * data/timeline.json, so the data IS the product: marker order, color,+ * scale, and every "Read the source" link come from these fields. These+ * tests guard the invariants the page relies on and the production wiring+ * that once silently broke it (the file must reach dist/, see vite.config.js+ * and scripts/check-dist.mjs).+ */++import { readFileSync } from 'node:fs';+import { resolve } from 'node:path';+import { describe, it, expect } from 'vitest';++const root = resolve(import.meta.dirname, '..');+const data = JSON.parse(readFileSync(resolve(root, 'data/timeline.json'), 'utf8'));+const ISO_DAY = /^\d{4}-\d{2}-\d{2}$/;+const HEX_COLOR = /^#[0-9a-f]{6}$/i;++describe('timeline dataset', () => {+ it('declares categories with a label and a hex color', () => {+ const entries = Object.entries(data.categories);+ expect(entries.length).toBeGreaterThan(0);+ for (const [key, meta] of entries) {+ expect(key, 'category key').toMatch(/^[a-z]+$/);+ expect(meta.label.trim().length, `${key} label`).toBeGreaterThan(0);+ expect(meta.color, `${key} color`).toMatch(HEX_COLOR);+ }+ });++ it('has a non-empty, chronologically ordered event list', () => {+ expect(Array.isArray(data.events)).toBe(true);+ expect(data.events.length).toBeGreaterThan(0);+ for (let i = 1; i < data.events.length; i++) {+ const prev = data.events[i - 1];+ const cur = data.events[i];+ expect(cur.date >= prev.date, `${cur.id} (${cur.date}) sorts before ${prev.id} (${prev.date})`).toBe(true);+ }+ });++ it('gives every event a unique id, an ISO date, copy, a known category, and a 1-5 importance', () => {+ const seen = new Set();+ for (const e of data.events) {+ expect(typeof e.id, 'id').toBe('string');+ expect(seen.has(e.id), `duplicate id ${e.id}`).toBe(false);+ seen.add(e.id);+ expect(e.date, `${e.id} date`).toMatch(ISO_DAY);+ expect(e.id.startsWith(e.date), `${e.id} should be prefixed by its date`).toBe(true);+ expect(e.title.trim().length, `${e.id} title`).toBeGreaterThan(0);+ expect(e.summary.trim().length, `${e.id} summary`).toBeGreaterThan(0);+ expect(data.categories[e.category], `${e.id} category ${e.category}`).toBeDefined();+ expect(Number.isInteger(e.importance) && e.importance >= 1 && e.importance <= 5, `${e.id} importance`).toBe(true);+ }+ });++ it('links sources over https or explicitly declares none', () => {+ for (const e of data.events) {+ expect('source_url' in e, `${e.id} must declare source_url`).toBe(true);+ if (e.source_url !== null) {+ expect(e.source_url, `${e.id} source_url`).toMatch(/^https:\/\/[^\s"]+$/);+ }+ }+ });++ it('never carries the banned dash characters into the page', () => {+ for (const e of data.events) {+ for (const field of ['title', 'summary']) {+ expect(/[\u2013\u2014]/.test(e[field]), `${e.id} ${field} uses a banned dash`).toBe(false);+ }+ }+ });++ it('is copied into dist/ by the build and required by check:dist', () => {+ const vite = readFileSync(resolve(root, 'vite.config.js'), 'utf8');+ const checkDist = readFileSync(resolve(root, 'scripts/check-dist.mjs'), 'utf8');+ expect(vite).toContain("name: 'copy-timeline-data'");+ expect(vite).toContain("'dist/data/timeline.json'");+ expect(checkDist).toContain("'dist/data/timeline.json'");+ });+});diff --git a/vite.config.js b/vite.config.jsindex b7ab22f74..fed226822 100644--- a/vite.config.js+++ b/vite.config.js@@ -3,9 +3,11 @@ import { resolve } from 'path';import {readFileSync,readdirSync,+ copyFileSync,cpSync,createReadStream,existsSync,+ mkdirSync,statSync,rmSync,} from 'fs';@@ -2853,6 +2855,19 @@ const appConfig = {}},},+ {+ // /timeline fetches its milestones from /data/timeline.json at runtime.+ // The dev server resolves that against the repo root, but production+ // serves dist/ alone, so without this copy the page shipped for weeks+ // with a working shell and a 404 behind its one fetch: every visitor+ // landed on the "Could not load the timeline" state. check:dist now+ // refuses a build that lacks the copy.+ name: 'copy-timeline-data',+ closeBundle() {+ mkdirSync(resolve(__dirname, 'dist/data'), { recursive: true });+ copyFileSync(resolve(__dirname, 'data/timeline.json'), resolve(__dirname, 'dist/data/timeline.json'));+ },+ },{// The IBM × three.ws x402 demo (pages/ibm/x402-demo.html) is a hand-// authored, self-contained partner artifact — inline CSS+JS, self-hosted