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(voice): make the Voice Lab's muted text and unavailable-lane chip readable
nirholas5755e48ffb41
diff --git a/data/changelog.json b/data/changelog.jsonindex 0545f88e9..f908625e9 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -115,7 +115,7 @@{"date": "2026-08-15","title": "Voice Lab: a dead voice provider now leaves the menu instead of failing on your first click",- "summary": "Google Gemini has been refusing every request on the platform's account, and Voice Lab had no way to know: it listed all 30 Gemini voices, put them first, and the first Preview a visitor pressed came back with a wall of raw error JSON quoting internal project numbers. Now the first refusal is the last one anybody sees. A provider that turns down the platform's credentials is withheld from the voice list for a few minutes with the reason written on its filter chip, its voices disappear from the grid the moment a preview hits it, and the free Microsoft Edge and NVIDIA lanes are named as the alternative. It restores itself the moment the provider works again, with nothing to switch back on by hand. Failure messages across the page are now single readable sentences rather than vendor dumps. The rest is the same page, checked end to end: the catalog error state offers a working Try again, a search that matches nothing offers Clear filters, a deployment with no provider at all says so instead of claiming no voices match, the Remove button next to your own ElevenLabs key is styled like a button again, every control shows a focus ring when you tab to it, and the text box in the playground has a label. The space bar no longer hijacks the button you are pressing: it starts a recording only when nothing on the page is focused.",+ "summary": "Google Gemini has been refusing every request on the platform's account, and Voice Lab had no way to know: it listed all 30 Gemini voices, put them first, and the first Preview a visitor pressed came back with a wall of raw error JSON quoting internal project numbers. Now the first refusal is the last one anybody sees. A provider that turns down the platform's credentials is withheld from the voice list for a few minutes with the reason written on its filter chip, its voices disappear from the grid the moment a preview hits it, and the free Microsoft Edge and NVIDIA lanes are named as the alternative. It restores itself the moment the provider works again, with nothing to switch back on by hand. Failure messages across the page are now single readable sentences rather than vendor dumps. The rest is the same page, checked end to end: the catalog error state offers a working Try again, a search that matches nothing offers Clear filters, a deployment with no provider at all says so instead of claiming no voices match, the Remove button next to your own ElevenLabs key is styled like a button again, every control shows a focus ring when you tab to it, and the text box in the playground has a label. The space bar no longer hijacks the button you are pressing: it starts a recording only when nothing on the page is focused. Muted text across the page was also too faint to read against the black background (grey on near-black, below the accessibility floor) and an unavailable provider was faded to the point of illegibility, which mattered because that chip is where the reason it is unavailable is written; both are legible now, and the chip tells a screen reader why it cannot be picked.","tags": ["fix","improvement"diff --git a/pages/voice.html b/pages/voice.htmlindex 66e0e3bac..1b2a591ac 100644--- a/pages/voice.html+++ b/pages/voice.html@@ -119,7 +119,7 @@.vl-recorder[data-state="recording"] .vl-timer { opacity: 1; }.vl-timer-sub {font-size: 12px;- color: #666666;+ color: #808080;margin-top: 4px;opacity: 0;transition: opacity 0.2s;@@ -303,7 +303,7 @@font-weight: 600;text-transform: uppercase;letter-spacing: 0.08em;- color: #666666;+ color: #808080;margin-bottom: 8px;}.vl-script-text {@@ -336,7 +336,7 @@.vl-script-next {background: none;border: none;- color: #666666;+ color: #808080;font: 600 12px system-ui, sans-serif;cursor: pointer;padding: 4px 8px;@@ -376,7 +376,7 @@font-weight: 600;text-transform: uppercase;letter-spacing: 0.06em;- color: #666666;+ color: #808080;margin-bottom: 6px;}.vl-review-field input {@@ -470,7 +470,7 @@.vl-status {padding: 10px 20px;font-size: 12px;- color: #666666;+ color: #808080;display: flex;align-items: center;gap: 8px;@@ -531,7 +531,7 @@}.vl-voice-meta {font-size: 11.5px;- color: #666666;+ color: #808080;display: flex;align-items: center;gap: 8px;@@ -553,7 +553,7 @@.vl-empty {text-align: center;padding: 32px 20px;- color: #666666;+ color: #808080;font-size: 14px;border: 1px dashed #1a1a1a;border-radius: 12px;@@ -588,7 +588,7 @@font-weight: 600;text-transform: uppercase;letter-spacing: 0.06em;- color: #666666;+ color: #808080;margin-bottom: 6px;}.vl-pg-field select {@@ -762,7 +762,21 @@border-color: #ffffff;color: #000000;}- .vb-pill.disabled { opacity: 0.4; cursor: not-allowed; }+ /* An unavailable lane still has to be readable: it is the row that+ explains WHY it is unavailable. Fading it to 40% dropped its label to+ 1.95:1, so the state is carried by colour and cursor instead. */+ .vb-pill.disabled {+ /* tokens.css fades anything aria-disabled to 40%, which drops this+ label to 1.95:1. This pill is the one place the reason a lane is+ unavailable is written, so it stays legible and says "not+ clickable" through colour and cursor instead. */+ opacity: 1;+ cursor: not-allowed;+ color: #8a8a8a;+ background: rgba(255,255,255,0.02);+ border-color: #171717;+ }+ .vb-pill.disabled:hover { transform: none; }.vb-pill-billing {font-size: 10px;font-weight: 600;@@ -825,7 +839,7 @@.vb-tags { display: flex; gap: 5px; flex-wrap: wrap; }.vb-tag {font-size: 11px;- color: #777777;+ color: #8a8a8a;background: rgba(255,255,255,0.05);border-radius: 4px;padding: 2px 7px;@@ -834,7 +848,7 @@margin: 0;font-size: 12px;line-height: 1.5;- color: #777777;+ color: #8a8a8a;display: -webkit-box;-webkit-line-clamp: 2;-webkit-box-orient: vertical;@@ -878,7 +892,7 @@.vl-pg-field input[type="range"] { width: 100%; accent-color: #ffffff; }.vl-pg-billing {font-size: 12px;- color: #777777;+ color: #8a8a8a;margin-top: 10px;}@@ -1013,7 +1027,7 @@<div class="vl-section" id="browserSection"><div class="vl-section-head"><h2 class="vl-section-title" data-i18n="voice.browse_voices">Browse voices</h2>- <span class="vl-pg-hint" id="vbStatus" role="status" aria-live="polite" style="font-size:12px;color:#777777;"></span>+ <span class="vl-pg-hint" id="vbStatus" role="status" aria-live="polite" style="font-size:12px;color:#8a8a8a;"></span></div><div class="vl-card"><div class="vl-card-body">@@ -1085,7 +1099,7 @@</div><div class="vl-pg-actions"><button class="vl-btn vl-btn-primary" id="pgSpeak" disabled data-i18n="voice.speak">Speak</button>- <span class="vl-pg-hint" id="pgHint" style="font-size:12px;color:#666666;"></span>+ <span class="vl-pg-hint" id="pgHint" style="font-size:12px;color:#808080;"></span></div><div class="vl-pg-output" id="pgOutput"><audio id="pgAudio" controls></audio>@@ -1118,7 +1132,7 @@<button class="vl-btn vl-btn-primary" id="byokSave" type="button">Save key</button><button class="vl-btn vl-btn-ghost" id="byokClear" type="button" hidden>Remove</button></div>- <span class="vl-pg-hint" id="byokStatus" role="status" style="font-size:12px;color:#666666;"></span>+ <span class="vl-pg-hint" id="byokStatus" role="status" style="font-size:12px;color:#808080;"></span></div></div></div>diff --git a/prompts/swarm-100/route-voice.md b/prompts/swarm-100/route-voice.mddeleted file mode 100644index 2c8d9bcae..000000000--- a/prompts/swarm-100/route-voice.md+++ /dev/null@@ -1,119 +0,0 @@-# Route audit: /voice (Voice Lab)--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==='/voice')console.log(JSON.stringify(g,null,2))"--2. Find the serving implementation: grep "/voice" 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/voice--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: /voice ("Voice Lab", section "build").-Declared purpose: Browse about 850 voices across Microsoft Edge, Gemini, NVIDIA, OpenAI and ElevenLabs, preview any of them, or clone your own from a short recording, then give it to your agent.--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/voice. 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 /voice: 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-voice.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/src/voice/voice-browser.js b/src/voice/voice-browser.jsindex 4992aa7a0..e6f6b329e 100644--- a/src/voice/voice-browser.js+++ b/src/voice/voice-browser.js@@ -148,6 +148,10 @@ export function mountVoiceBrowser({ root, onSelect, onCatalog }) {return (`<button class="vb-pill${activeProvider === p.id ? ' active' : ''}${disabled ? ' disabled' : ''}"` +` data-provider="${esc(p.id)}" aria-pressed="${activeProvider === p.id}"` ++ `${disabled ? ' aria-disabled="true"' : ''}` ++ // A title alone is announced inconsistently, and the reason is the+ // only thing that tells a visitor what to do about the lane.+ `${disabled ? ` aria-label="${esc(p.label)}, unavailable: ${esc(p.reason || 'this lane cannot serve right now')}"` : ''}` +`${disabled ? ` title="${esc(p.reason || 'Unavailable')}"` : ` title="${esc(p.tagline)}"`}>` +`${esc(p.label)}` +`<span class="vb-pill-billing" data-billing="${esc(p.billing)}">${esc(BILLING_COPY[p.billing]?.label || '')}</span>` +