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(watch): say "sculpting" the moment the concept art lands, and keep corner widgets off the CTA row
nirholas3f1abb54a7db
diff --git a/docs/generation-watch.md b/docs/generation-watch.mdindex 7e0b3cbc6..6710b9214 100644--- a/docs/generation-watch.md+++ b/docs/generation-watch.md@@ -36,7 +36,7 @@ does) lands on the designed empty state, which points to## What the page shows-The page polls `GET /api/3d/studio?job=<id>` and moves through four states:+The page polls `GET /api/3d/studio?job=<id>` and moves through five states:- **Waiting.** A countdown ring with the estimated time remaining, updatedlocally at 4 Hz between polls so the timer never freezes. Until the API@@ -59,6 +59,13 @@ The page polls `GET /api/3d/studio?job=<id>` and moves through four states:link (HTTP 400), or a job that produces no viewer link shows an honest errorwith a one-click "Forge it again" path. Generation is free, so retryingcosts nothing.+- **Offline.** Four consecutive failed polls (a dropped connection, a captive+ portal, a tab woken on a dead network) stop the countdown and say so, rather+ than animating a timer against a server nobody is talking to. This state is+ resumable, not terminal: it offers a "Keep watching" button that picks the+ poll loop back up where it left off, and the page resumes on its own as soon+ as the browser fires `online`. The copy is explicit that the generation is+ still running server-side, because it is.Polling is adaptive: the interval scales with the remaining estimate (clampedbetween 4 and 10 seconds), a 429 respects the server's `retry_after`, and a@@ -66,6 +73,22 @@ network blip just retries after 6 seconds. If nothing has finished after 40minutes the page stops itself and says so, rather than spinning forever in aforgotten tab.+The redirect target is checked before it is followed: `viewerUrl` is honoured+only when it resolves to this origin or to `three.ws`, so the hand-off can+never be pointed off-platform.++## Accessibility and presentation++The page carries one `<h1>` (the generation's title, or "Watching your 3D+generation" when the link has no `title`), and each state's heading is an+`<h2>` beneath it. State changes are announced through a single visually+hidden `role="status"` region rather than by wrapping the countdown in a live+region, which would otherwise read the 4 Hz timer aloud continuously. It+follows the site theme in both light and dark, and reserves its footer bar's+height with the shared corner stack+([public/corner-stack.js](../public/corner-stack.js)) so the site-wide Cmd+K+hint and language switcher stack above the CTA row instead of covering it.+## Relation to background generationThe watch page is a viewport, not the tracker. All job state livesdiff --git a/prompts/swarm-100/route-watch.md b/prompts/swarm-100/route-watch.mddeleted file mode 100644index 5108a265f..000000000--- a/prompts/swarm-100/route-watch.md+++ /dev/null@@ -1,119 +0,0 @@-# Route audit: /watch (Generation Watch)--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==='/watch')console.log(JSON.stringify(g,null,2))"--2. Find the serving implementation: grep "/watch" 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/watch--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: /watch ("Generation Watch", section "labs").-Declared purpose: Live progress page for a running text-to-3D generation: real countdown, the painted concept art, and an automatic hand-off into the interactive viewer the moment the model is ready.--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/watch. 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 /watch: 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-watch.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/watch.html b/public/watch.htmlindex 229ec5a6b..2c3948a1c 100644--- a/public/watch.html+++ b/public/watch.html@@ -290,6 +290,10 @@function stopTicker() { if (ticker) { clearInterval(ticker); ticker = null; } }var tierNames = { draft: 'draft quality', standard: 'standard quality', high: 'maximum detail' };+ // The pipeline is past the painting step the moment a preview URL exists, which+ // is a poll earlier than the image finishes decoding. Read the phase off the+ // URL, not off the fade-in class, or the header contradicts the picture below it.+ var painted = false;function applyState(d) {if (Number.isFinite(d.etaSeconds) && d.etaSeconds > 0) {eta = d.etaSeconds;@@ -299,10 +303,11 @@if (d.previewImageUrl && /^https:\/\//.test(d.previewImageUrl) && concept.src !== d.previewImageUrl) {concept.onload = function () { concept.hidden = false; requestAnimationFrame(function () { concept.classList.add('shown'); }); conceptCap.classList.add('shown'); };concept.onerror = function () { concept.hidden = true; concept.classList.remove('shown'); conceptCap.classList.remove('shown'); };+ painted = true;concept.src = d.previewImageUrl;}var tier = tierNames[d.tier] || '';- var next = concept.classList.contains('shown')+ var next = painted? 'Sculpting the 3D mesh' + (tier ? ' at ' + tier : '') + '…': 'Painting the concept' + (tier ? ' at ' + tier : '') + '…';if (phaseEl.textContent !== next) phaseEl.textContent = next;@@ -411,7 +416,23 @@if (!stopped) failWith('This is taking far longer than it should. The job may have been lost upstream, so start a fresh one: it is free.');}, 40 * 60 * 1000);})();++// This page pins a footer bar to the bottom edge, which is exactly where the+// site-wide corner widgets (the Cmd+K hint, the language switcher) park+// themselves. Reserve the bar's height with the shared corner stack so they+// stack above the CTA row instead of covering it.+(function () {+ var bar = document.querySelector('footer.bar');+ if (!bar) return;+ function claim() {+ if (window.twsCornerStack) window.twsCornerStack.reserve('watch-footer', { height: bar.offsetHeight + 12 });+ }+ window.addEventListener('tws-corner-stack:ready', claim);+ window.addEventListener('resize', claim);+ claim();+})();</script>+<script src="/corner-stack.js" defer></script><!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. --><script type="module" src="/i18n.js"></script></body>