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(what-is,trending): refresh the landing hero and trending page with the regenerated feed
nirholas33e5bcdf0402
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 146372e77..c238da3a8 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -103,9 +103,10 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Two tutorials stop shipping code samples that quietly do nothing**: An audit of eight developer tutorials found two whose main code sample looked right and silently failed. The custom-skill weather handler split the weather API's reply on a plus sign, but the temperature field arrives with a leading plus of its own, so every field after the condition landed one slot off and the temperature always came back empty; it also mapped the fahrenheit option to a format code that means feels-like rather than Fahrenheit, so the celsius and fahrenheit paths returned the same units. Both are fixed and the sample was run against the live API in both unit modes. The gesture tutorial's AI lane read an emotion-breakdown field the Granite analysis tool has never returned, so the strength check never passed and the agent never played a single animation; it now reads the score and risk flags the tool actually returns, and grades the gesture across four bands instead of a binary. Separately, twelve tutorial hero buttons pointed at anchors on the docs hub that stopped existing when the hub split into per-topic pages, and now open the real pages; a placeholder URL in the Pump.fun tutorial was being parsed as HTML, which broke a link and injected stray elements into the page; and the self-host guide was corrected throughout, including storage variable names that no longer matched the code, a database step that left most tables uncreated, an audit-logging example importing a function that does not exist, a Cloudflare worker setup for a proxy the platform does not run, and a license claim that described the repository as open source when it is not. (`/tutorials/custom-skill`) `[docs, fix]`- **Viability now shows skeletons while it reads and says what broke when a read fails**: The Viability page (/viability) reports the two real money loops behind three.ws: $THREE marketplace GMV and take-rate, and guarded agent coin trades with realized P&L. Until now, a slow read left the page as a bare headline with nothing underneath, and a failed read quietly deleted both panels while the page still claimed it had just updated. Both panels now hold their shape with skeletons while the live read is in flight, so the numbers land without the page jumping. If a read fails, that panel says so in plain language, names the reason (offline, rate limited, the status the API returned, or a deploy still rolling out), and offers a Retry that re-runs only that panel, leaving a healthy one untouched. The freshness stamp is honest too: it reports a read in flight, a failed read, or how long ago the figures on screen were actually good. Section titles are now real headings, and the network toggle announces itself correctly to screen readers. (`/viability`) `[improvement, fix]`- **Voice and vision SDKs ship runnable examples, and the x402 seller SDK reads its Solana sponsor from the environment**: @three-ws/voice and @three-ws/vision-mcp now include example scripts you can run as-is against the live free lanes: the voice one speaks a sentence, animates a face from those exact bytes, and transcribes it back; the vision one probes the lane, writes alt text for an image, and reads the text off it. @three-ws/x402-server used to demand the Solana sponsor account as a code option even though its own error message told you to set X402_FEE_PAYER_SOLANA, so a correctly configured deployment still got missing_fee_payer; it now reads that environment variable when the option is omitted. The VS Code x402 extension's endpoint scaffolder was generating Base-only endpoints and now generates Solana-first ones, matching every paid route on the platform, and it ships with a test suite covering which payment requirement it selects. `[sdk, fix]`-- **Voice Lab: a dead voice provider now leaves the menu instead of failing on your first click**: 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. (`/voice`) `[fix, improvement]`+- **Voice Lab: a dead voice provider now leaves the menu instead of failing on your first click**: 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. (`/voice`) `[fix, improvement]`- **Walk Leaderboard: switching filters no longer strands the board, and an empty board tells you how to get on it**: Clicking through the leaderboard's filters faster than the board could load left it stuck: a second click while a request was open was dropped outright, so the board could sit on a loading skeleton that never resolved, or show one metric's rows under another metric's column header. Every request now supersedes the one before it, so whatever you clicked last is what you get. An empty board used to say the same thing whichever metric you were on, which was wrong for Sites: sites only count where your avatar walks away from three.ws, so that state now explains it and links to the walk companion, while distance and time point at the walk itself. Any narrow window that comes up empty also offers a jump to All Time rather than leaving you at a dead end, and a failed load offers a retry that says what went wrong. The board now lives up to "updates live": it refreshes itself while you are watching, shows how many walkers are ranked and when it last updated, and a refresh that fails quietly keeps the rows you are reading. For screen readers the board is a real table, the top three medals now announce their rank instead of reading as an empty cell, the momentum column speaks its direction, and the two filter groups are proper radio groups with arrow-key and Home/End navigation. (`/walk-leaderboard`) `[fix, improvement]`- **Watchlist: the portfolio summary stops reporting numbers it does not have**: The watchlist summary bar claimed $0 of 24h volume across every coin you watch. The pump.fun feed simply stops reporting 24h volume once a coin graduates, and the bar was treating each missing figure as a zero and adding them up, so a confident "$0" stood where the honest answer is "not reported". Every aggregate now counts only the coins that actually report it, shows a dash when none do, and says on hover how many of your watched coins it covers. The Oracle tier bar does the same: coins the Oracle has not scored get their own marked-off slice instead of quietly vanishing from the distribution, and each unscored card now carries an "unrated" badge that links to its coin page rather than leaving a blank corner. If the Oracle itself is unreachable, the page says so instead of labelling every coin unrated. Also fixed: at 320px wide the "Clear all" button was pushed off the edge of the screen with no way to reach it, the add-a-coin field had no visible keyboard focus ring, and the page description advertised a verdict the page does not show. (`/watchlist`) `[fix, improvement]`+- **What is three.ws: a living sample avatar, a fallback that still shows one, and a readable light mode**: The sample avatar in the hero stood in a rigid T-pose, because the character ships an idle animation that nothing was playing. It now idles, faces the reader, and is framed to fit the pane at every screen size. Before it loaded, the pane was simply an empty rectangle with a caption promising an avatar you could drag; it now shows a real still of that same character straight away, and if the 3D viewer never arrives (a blocked CDN, a device without 3D, a slow network that stalls) the still stays put and the caption says so instead of inviting you to drag nothing. In light mode the page was unreadable: the background stayed black while every word switched to near-black ink, so the headline sat at roughly 1.2 to 1 contrast. The whole page now follows the chosen theme, and the Start free button no longer prints black text on the light-mode blue. The Common questions section was rebuilt too: each question is now a real heading, its answer is announced with the question it belongs to, the four questions and answers are translated along with the rest of the page rather than staying English, the search-result markup finally lists the four questions actually on the page, and opening an answer eases in instead of snapping. (`/what-is`) `[fix, improvement]`- **Widget analytics can tell you where your visitors are again, and a shared widget link previews correctly everywhere**: The country column in your widget stats has been empty since the platform moved to its current host in July. A visitor's country was read from a header only the old host set, so once it was gone every view was recorded with no country at all and the top-countries panel stayed blank no matter how much traffic a widget got. Country is now read from the headers our current edge provides, and it is checked against the shape of a real two-letter country code before it is stored, so nobody can push junk into your analytics by editing a request. Chat sessions on talking-agent widgets get the same fix. Separately, the oEmbed endpoint that Slack, Discord, WordPress, Ghost and Notion call to unfurl a shared widget link now says plainly when a consumer asks for a format we do not publish, instead of returning JSON labelled as the format that was asked for and leaving the embed broken with nothing to explain why. (`/widgets`) `[fix, improvement]`- **World Lines: the AR encounter is finally offered, and the quest tabs answer the keyboard**: The page has always promised an AR challenge, and the immersive encounter was fully built, but nothing ever put a button in front of it: a phone that can run WebXR was quietly handed the flat panel instead. Devices that support immersive AR now see a "Meet the agent in AR" option next to "Begin the encounter", and if the headset session refuses to start, the panel ceremony picks up where it left off. The four tabs (Near me, Explore, My proofs, Create) now behave like a real tab strip: arrow keys and Home/End move between them, only the selected tab sits in the tab order, each tab writes its own address so a tab can be linked and the back button walks back through them. Opening a region on the Explore tab used to leave a heading over an empty space when every quest in it had expired or filled up, and a failure there was a single line of red text with no way to retry; both are now proper states. Focus rings are visible again across the page (they were being drawn in near-black on a black background), the opened region is highlighted, the encounter dialog now takes and holds keyboard focus and hands it back where you left it, and a proof whose date is missing says so rather than claiming it was earned in 1970. (`/world-lines`) `[fix, improvement]`- **Your master wallet: creating one no longer reports a failure, and your balances are real numbers again**: Two faults on the master wallet page are fixed. First, every account that pressed Create my master wallet was told the creation had failed. The wallet was in fact created every time; the page then showed an error, and the same fault sat on the send and fund-an-agent paths, where a transfer that had already settled on Solana was reported as "The transfer did not go through", inviting people to send the same money twice. Nothing about the money was ever wrong, only what the page said about it. Second, the SOL and Solana USDC figures, and the total value, read "unavailable" for everyone regardless of what the wallet held, because the balance reader and the page were describing balances in two different shapes. They now show live amounts, priced against the SOL rate, and an empty wallet reads a plain 0 instead of "unavailable". A balance the network genuinely could not answer for still says "unavailable" and is left out of the total rather than counted as zero. Alongside that: failures now explain themselves in plain words with a support reference instead of printing raw operator text, the explainer bubbles fit inside a phone screen, and each one names what it explains for screen-reader users. (`/wallet`) `[fix, improvement]`diff --git a/data/changelog.json b/data/changelog.jsonindex f908625e9..71a24864e 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,16 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-08-16",+ "title": "Trending: muted text on the board is readable, and the Tip button that only navigated is gone",+ "summary": "Ten pieces of text on the Trending board sat below the WCAG AA contrast floor: the subtitle, the two unselected tabs, the 7d and all-time buttons, the column headers, agent descriptions and the unit labels next to each number. They are all legible now, and the Oracle link in the footnote is underlined instead of being told apart by colour alone. The wallet chip on each row carried a Tip button and a hover card, but the whole row is a link, so the browser followed the row instead of running either one: pressing Tip took you to the agent's wallet page rather than opening a tip. Both controls are gone from the board and tipping stays where it works, on the agent page the row opens, while the chip keeps showing the wallet address and its live balance. An automated accessibility scan now reports zero violations on all three boards and on their loading, empty and error states.",+ "tags": [+ "fix",+ "improvement"+ ],+ "link": "/trending"+ },{"date": "2026-08-15","title": "glTF Validator: a file it cannot read now says why, and the page is usable from the keyboard",@@ -23148,6 +23158,16 @@"improvement"],"link": "/vanity-wallet"+ },+ {+ "date": "2026-08-15",+ "title": "What is three.ws: a living sample avatar, a fallback that still shows one, and a readable light mode",+ "summary": "The sample avatar in the hero stood in a rigid T-pose, because the character ships an idle animation that nothing was playing. It now idles, faces the reader, and is framed to fit the pane at every screen size. Before it loaded, the pane was simply an empty rectangle with a caption promising an avatar you could drag; it now shows a real still of that same character straight away, and if the 3D viewer never arrives (a blocked CDN, a device without 3D, a slow network that stalls) the still stays put and the caption says so instead of inviting you to drag nothing. In light mode the page was unreadable: the background stayed black while every word switched to near-black ink, so the headline sat at roughly 1.2 to 1 contrast. The whole page now follows the chosen theme, and the Start free button no longer prints black text on the light-mode blue. The Common questions section was rebuilt too: each question is now a real heading, its answer is announced with the question it belongs to, the four questions and answers are translated along with the rest of the page rather than staying English, the search-result markup finally lists the four questions actually on the page, and opening an answer eases in instead of snapping.",+ "tags": [+ "fix",+ "improvement"+ ],+ "link": "/what-is"}]}diff --git a/pages/trending.html b/pages/trending.htmlindex 309c7543f..c09d1ab73 100644--- a/pages/trending.html+++ b/pages/trending.html@@ -144,7 +144,7 @@/* ── head ── */.tr-head { margin-bottom: 28px; }.tr-h1 { font-size: clamp(1.6rem, 4vw, 2.2rem); font-weight: 800; color: #f9fafb; letter-spacing: -.02em; }- .tr-sub { margin-top: 6px; font-size: 14px; color: #6b7280; }+ .tr-sub { margin-top: 6px; font-size: 14px; color: #8b93a3; }/* ── controls ── */.tr-controls {@@ -155,7 +155,7 @@.tr-tabs { display: flex; gap: 2px; background: rgba(255,255,255,.05); border-radius: 10px; padding: 3px; }.tr-tab {padding: 7px 18px; border-radius: 8px; border: none; cursor: pointer;- font-size: 13px; font-weight: 600; background: transparent; color: #6b7280;+ font-size: 13px; font-weight: 600; background: transparent; color: #8b93a3;transition: background .15s, color .15s;}.tr-tab.active { background: rgba(99,102,241,.25); color: #a5b4fc; }@@ -165,7 +165,7 @@.tr-win {padding: 5px 12px; border-radius: 8px; border: 1px solid rgba(255,255,255,.1);font-size: 12px; font-weight: 600; cursor: pointer;- background: transparent; color: #6b7280;+ background: transparent; color: #8b93a3;transition: border-color .15s, color .15s, background .15s;}.tr-win.active { border-color: rgba(99,102,241,.6); color: #a5b4fc; background: rgba(99,102,241,.1); }@@ -178,7 +178,7 @@.tr-legend {display: flex; justify-content: space-between;font-size: 10px; font-weight: 700; letter-spacing: .1em; text-transform: uppercase;- color: #4b5563; padding: 0 16px 10px;+ color: #7d8595; padding: 0 16px 10px;}/* ── list rows ── */@@ -196,7 +196,7 @@.tr-rank {width: 22px; text-align: center; flex-shrink: 0;- font-size: 11px; font-weight: 700; color: #4b5563;+ font-size: 11px; font-weight: 700; color: #7d8595;}.tr-rank-1 { color: #f59e0b; }.tr-rank-2 { color: #9ca3af; }@@ -228,13 +228,13 @@}.tr-desc {margin-top: 2px;- font-size: 12px; color: #6b7280;+ font-size: 12px; color: #8b93a3;white-space: nowrap; overflow: hidden; text-overflow: ellipsis;}.tr-meta { text-align: right; flex-shrink: 0; }.tr-metric { font-size: 15px; font-weight: 700; color: #f3f4f6; }- .tr-metric-label { font-size: 10px; color: #6b7280; margin-top: 1px; }+ .tr-metric-label { font-size: 10px; color: #8b93a3; margin-top: 1px; }/* tier pill */.tr-tier {@@ -246,7 +246,7 @@.tr-tier-strong { color: #10b981; border-color: rgba(16,185,129,.3); background: rgba(16,185,129,.08); }.tr-tier-lean { color: #3b82f6; border-color: rgba(59,130,246,.3); background: rgba(59,130,246,.08); }.tr-tier-watch { color: #8b5cf6; border-color: rgba(139,92,246,.3); background: rgba(139,92,246,.08); }- .tr-tier-avoid { color: #6b7280; border-color: rgba(107,114,128,.2); background: rgba(107,114,128,.05); }+ .tr-tier-avoid { color: #8b93a3; border-color: rgba(107,114,128,.2); background: rgba(107,114,128,.05); }/* reputation tier pill (matches TIERS accents in wallet-reputation.js) */.tr-rt {@@ -261,7 +261,7 @@.tr-rt-elite { color: #fbbf24; border-color: rgba(251,191,36,.34); background: rgba(251,191,36,.09); }.tr-trust-num { color: #f3f4f6; }- .tr-trust-slash { color: #6b7280; font-weight: 600; }+ .tr-trust-slash { color: #8b93a3; font-weight: 600; }/* onchain badge */.tr-onchain {@@ -281,7 +281,7 @@.tr-empty, .tr-error {padding: 40px 20px; text-align: center;- font-size: 14px; color: #6b7280;+ font-size: 14px; color: #8b93a3;}.tr-empty {display: flex; flex-direction: column; align-items: center; gap: 7px;@@ -289,7 +289,7 @@background: rgba(255,255,255,.015);}.tr-empty-title { font-size: 14px; font-weight: 600; color: #d1d5db; }- .tr-empty-sub { font-size: 12.5px; color: #6b7280; max-width: 40ch; line-height: 1.55; }+ .tr-empty-sub { font-size: 12.5px; color: #8b93a3; max-width: 40ch; line-height: 1.55; }.tr-empty-sub a { color: #818cf8; text-decoration: none; border-bottom: 1px solid rgba(129,140,248,.35); }.tr-empty-sub a:hover { color: #a5b4fc; border-bottom-color: rgba(165,180,252,.7); }.tr-error {@@ -299,7 +299,7 @@}.tr-error-icon { font-size: 26px; opacity: .85; line-height: 1; }.tr-error-title { font-size: 14px; font-weight: 600; color: #e5e7eb; }- .tr-error-sub { font-size: 12.5px; color: #6b7280; }+ .tr-error-sub { font-size: 12.5px; color: #8b93a3; }.tr-retry {display: inline-flex; align-items: center; gap: 7px;padding: 9px 18px; border-radius: 10px; cursor: pointer;@@ -315,10 +315,12 @@.tr-footnote {margin-top: 32px;- font-size: 12px; color: #4b5563; line-height: 1.6;+ font-size: 12px; color: #7d8595; line-height: 1.6;border-top: 1px solid rgba(255,255,255,.06); padding-top: 16px;}- .tr-footnote a { color: #6366f1; text-decoration: none; }+ /* Underlined, not color-only: the link has to be distinguishable from the+ muted prose around it without relying on hue (WCAG 1.4.1). */+ .tr-footnote a { color: #818cf8; text-decoration: underline; text-underline-offset: 2px; }.tr-footnote a:hover { color: #a5b4fc; }/* ── focus ── */@@ -512,7 +514,7 @@<span class="tr-body"><span class="tr-name">${esc(a.name || 'Unnamed agent')}${onchainBadge}</span>${a.description ? `<span class="tr-desc">${esc(a.description)}</span>` : ''}- ${a.solana_address ? `<span class="tr-wallet" style="margin-top:4px;display:inline-flex">${walletChipHTML(a, { link: false, showPending: false })}</span>` : ''}+ ${a.solana_address ? `<span class="tr-wallet" style="margin-top:4px;display:inline-flex">${walletChipHTML(a, { link: false, showPending: false, tip: false, popover: false })}</span>` : ''}</span><span class="tr-meta"><span class="tr-metric">${fmt(count)}</span>@@ -522,9 +524,11 @@</li>`;}).join('');- // Wire the wallet chips' copy + Tip actions on the public feed. Viewers- // don't own these agents, so walletChipHTML defaults to isOwner:false and- // renders the ◎ Tip action — this hooks it up.+ // Hydrate each chip's live balance. The whole row is a link to the agent,+ // so the chip renders without its Tip button and without the popover+ // trigger: both are interactive controls, and nested inside an anchor the+ // browser followed the row instead of running them, which made Tip a+ // button that lied. Tipping lives on the agent page this row opens.wireWalletChips(list);}@@ -597,7 +601,7 @@const attrs = href? ` href="${esc(href)}" aria-label="Rank ${a.rank}: ${esc(name)}, trust score ${score} of 100, ${esc(tierLabel)}"`: ` role="group" aria-label="Rank ${a.rank}: ${esc(name)}, trust score ${score} of 100, ${esc(tierLabel)}"`;- // Wallet chip without its own rep badge here — the meta column is the+ // Wallet chip without its own rep badge here: the meta column is the// headline trust number on this surface, so the badge would be redundant.return `<li><${tag} class="tr-row"${attrs}>@@ -605,7 +609,7 @@<span class="tr-av">${avHtml}</span><span class="tr-body"><span class="tr-name">${esc(name)} <span class="tr-rt tr-rt-${esc(tier)}">${esc(tierLabel)}</span></span>- ${a.solana_address ? `<span class="tr-wallet" style="margin-top:4px;display:inline-flex">${walletChipHTML(a, { link: false, showPending: false, reputation: false })}</span>` : ''}+ ${a.solana_address ? `<span class="tr-wallet" style="margin-top:4px;display:inline-flex">${walletChipHTML(a, { link: false, showPending: false, reputation: false, tip: false, popover: false })}</span>` : ''}</span><span class="tr-meta"><span class="tr-metric"><span class="tr-trust-num">${score}</span><span class="tr-trust-slash">/100</span></span>diff --git a/pages/what-is.html b/pages/what-is.htmlindex 650d68c8c..a1be2e35d 100644--- a/pages/what-is.html+++ b/pages/what-is.html@@ -160,8 +160,7 @@auto-rotate-delay="1500"rotation-per-second="12deg"camera-controls- camera-orbit="180deg 82deg 105%"- field-of-view="26deg"+ camera-orbit="180deg 82deg auto"interaction-prompt="none"shadow-intensity="0.5"environment-image="neutral"diff --git a/public/changelog.json b/public/changelog.jsonindex a90685d78..e72aeb122 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-15T22:00:09.681Z",+ "generated_at": "2026-08-16T00:24:26.928Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -1064,7 +1064,7 @@"date": "2026-08-15","type": "update","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.","link": "/voice","tags": ["fix",@@ -1093,6 +1093,17 @@"improvement"]},+ {+ "date": "2026-08-15",+ "type": "update",+ "title": "What is three.ws: a living sample avatar, a fallback that still shows one, and a readable light mode",+ "summary": "The sample avatar in the hero stood in a rigid T-pose, because the character ships an idle animation that nothing was playing. It now idles, faces the reader, and is framed to fit the pane at every screen size. Before it loaded, the pane was simply an empty rectangle with a caption promising an avatar you could drag; it now shows a real still of that same character straight away, and if the 3D viewer never arrives (a blocked CDN, a device without 3D, a slow network that stalls) the still stays put and the caption says so instead of inviting you to drag nothing. In light mode the page was unreadable: the background stayed black while every word switched to near-black ink, so the headline sat at roughly 1.2 to 1 contrast. The whole page now follows the chosen theme, and the Start free button no longer prints black text on the light-mode blue. The Common questions section was rebuilt too: each question is now a real heading, its answer is announced with the question it belongs to, the four questions and answers are translated along with the rest of the page rather than staying English, the search-result markup finally lists the four questions actually on the page, and opening an answer eases in instead of snapping.",+ "link": "/what-is",+ "tags": [+ "fix",+ "improvement"+ ]+ },{"date": "2026-08-15","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex 876ed1729..ba4e6c84f 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -788,7 +788,7 @@<guid isPermaLink="false">2026-08-15:Voice Lab: a dead voice provider now leaves the menu instead of failing on your first click</guid><pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate><category>fix</category>- <description>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.</description>+ <description>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.</description></item><item><title>Walk Leaderboard: switching filters no longer strands the board, and an empty board tells you how to get on it</title>@@ -806,6 +806,14 @@<category>fix</category><description>The watchlist summary bar claimed $0 of 24h volume across every coin you watch. The pump.fun feed simply stops reporting 24h volume once a coin graduates, and the bar was treating each missing figure as a zero and adding them up, so a confident "$0" stood where the honest answer is "not reported". Every aggregate now counts only the coins that actually report it, shows a dash when none do, and says on hover how many of your watched coins it covers. The Oracle tier bar does the same: coins the Oracle has not scored get their own marked-off slice instead of quietly vanishing from the distribution, and each unscored card now carries an "unrated" badge that links to its coin page rather than leaving a blank corner. If the Oracle itself is unreachable, the page says so instead of labelling every coin unrated. Also fixed: at 320px wide the "Clear all" button was pushed off the edge of the screen with no way to reach it, the add-a-coin field had no visible keyboard focus ring, and the page description advertised a verdict the page does not show.</description></item>+ <item>+ <title>What is three.ws: a living sample avatar, a fallback that still shows one, and a readable light mode</title>+ <link>https://three.ws/what-is</link>+ <guid isPermaLink="false">2026-08-15:What is three.ws: a living sample avatar, a fallback that still shows one, and a readable light mode</guid>+ <pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>The sample avatar in the hero stood in a rigid T-pose, because the character ships an idle animation that nothing was playing. It now idles, faces the reader, and is framed to fit the pane at every screen size. Before it loaded, the pane was simply an empty rectangle with a caption promising an avatar you could drag; it now shows a real still of that same character straight away, and if the 3D viewer never arrives (a blocked CDN, a device without 3D, a slow network that stalls) the still stays put and the caption says so instead of inviting you to drag nothing. In light mode the page was unreadable: the background stayed black while every word switched to near-black ink, so the headline sat at roughly 1.2 to 1 contrast. The whole page now follows the chosen theme, and the Start free button no longer prints black text on the light-mode blue. The Common questions section was rebuilt too: each question is now a real heading, its answer is announced with the question it belongs to, the four questions and answers are translated along with the rest of the page rather than staying English, the search-result markup finally lists the four questions actually on the page, and opening an answer eases in instead of snapping.</description>+ </item><item><title>Widget analytics can tell you where your visitors are again, and a shared widget link previews correctly everywhere</title><link>https://three.ws/widgets</link>diff --git a/public/features-landing.css b/public/features-landing.cssindex a63777187..afff033b6 100644--- a/public/features-landing.css+++ b/public/features-landing.css@@ -3,11 +3,15 @@/* Pulls exclusively from the design tokens in style.css :root. *//* ── Layout shell ─────────────────────────────────────────────────────── */+/* The page canvas has to come from the same token body uses. A hardcoded #000+ here kept the background black while [data-theme="light"] flipped --ink to+ near-black ink, which left the whole page dark-on-dark and unreadable for+ anyone who picked the light theme. */.fl-page {display: flex;flex-direction: column;min-height: 100vh;- background: #000;+ background: var(--bg-0);color: var(--ink);}@@ -122,7 +126,9 @@align-items: center;gap: 0.4rem;background: var(--accent);- color: #000;+ /* Light theme remaps --accent to a real blue and --btn-primary-fg to white;+ a hardcoded black here dropped the CTA to 4.06:1 on that fill. */+ color: var(--btn-primary-fg, #0a0a0a);font-family: var(--font-body);font-size: var(--text-sm);font-weight: 700;@@ -216,9 +222,10 @@background: transparent;}+/* Captured at the shell's own 4/3 framing, so on a desktop pane the still and+ the live render line up and the crossfade holds the avatar in place. */.fl-preview-still {object-fit: contain;- padding: 4% 4% 8%;}.fl-hero-preview model-viewer {@@ -242,6 +249,15 @@display: none;}+/* camera-controls puts a tab stop inside model-viewer's shadow root, where it+ picks up only the UA's near-black 1px outline: invisible on this surface, and+ unreachable from here because a selector cannot cross the shadow boundary.+ :focus-within does see that focus, so the ring goes on the pane instead. */+.fl-hero-preview:focus-within {+ outline: 2px solid var(--focus-ring-color);+ outline-offset: 2px;+}+.fl-preview-label {position: absolute;bottom: var(--space-sm);diff --git a/public/features.json b/public/features.jsonindex 26b31c161..9dcc48040 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-15T22:00:09.484Z",+ "generated_at": "2026-08-16T00:24:26.714Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",diff --git a/public/media/what-is/hero-avatar.webp b/public/media/what-is/hero-avatar.webpindex 7cee03dd6..c63e49052 100644Binary files a/public/media/what-is/hero-avatar.webp and b/public/media/what-is/hero-avatar.webp differdiff --git a/tests/trending-endpoint.test.js b/tests/trending-endpoint.test.jsnew file mode 100644index 000000000..d470fee77--- /dev/null+++ b/tests/trending-endpoint.test.js@@ -0,0 +1,204 @@+/**+ * HTTP-level tests for GET /api/trending, the feed behind the public /trending+ * leaderboard (agents by real chat activity, coins by Oracle conviction).+ *+ * These pin the two failures the coin half of the endpoint shipped with:+ *+ * 1. The `window` parameter only ever reached the agent ranking. The coin+ * query hardcoded a 36 hour floor, so 24h, 7d and all-time answered with+ * the same board while the page told the visitor it was filtering.+ * 2. That query ordered by `score desc` alone. Conviction saturates at 100,+ * so Postgres was free to return a different slice of the tie on every+ * request and the board reshuffled between two identical reads.+ *+ * Only the impure edges are stubbed (database, CDN URL builder, the reputation+ * enrichment, the rate limiter). The handler, its validation, its window+ * mapping, and its wire shape are the real module.+ */++import { describe, it, expect, vi, beforeEach } from 'vitest';++// Every sql`` call, as its raw template text plus the values interpolated into+// it, so the window contract is assertable rather than inferred from row counts.+const queries = [];+let agentRows = [];+let coinRows = [];++vi.mock('../api/_lib/db.js', () => ({+ sql: Object.assign(+ vi.fn(async (strings, ...values) => {+ const text = strings.join(' ? ');+ queries.push({ text, values });+ return /from oracle_conviction/.test(text) ? coinRows : agentRows;+ }),+ { transaction: vi.fn() },+ ),+ isDbUnavailableError: () => false,+ isDbCapacityError: () => false,+ isStoragePressured: async () => ({ pressured: false, sizeMb: 1, highWaterMb: 470 }),+}));++vi.mock('../api/_lib/r2.js', () => ({ thumbnailUrl: (key) => `https://cdn.test/${key}` }));++const scoreAgentsLite = vi.fn(async () => new Map());+vi.mock('../api/_lib/trust/wallet-reputation.js', () => ({+ scoreAgentsLite: (...a) => scoreAgentsLite(...a),+}));++const publicIp = vi.fn(async () => ({ success: true, limit: 60, remaining: 59, reset: Date.now() + 60_000 }));+vi.mock('../api/_lib/rate-limit.js', () => ({+ limits: { publicIp: (...a) => publicIp(...a) },+ clientIp: () => '127.0.0.1',+}));++const { default: handler } = await import('../api/trending.js');++function mockRes() {+ return {+ statusCode: 200,+ _headers: {},+ _body: '',+ _ended: false,+ setHeader(k, v) { this._headers[k.toLowerCase()] = v; },+ getHeader(k) { return this._headers[k.toLowerCase()]; },+ end(b) { this._body = b || ''; this._ended = true; },+ get json() {+ try { return JSON.parse(this._body); } catch { return null; }+ },+ };+}++const read = async (query = '') => {+ const res = mockRes();+ await handler(+ {+ method: 'GET',+ url: '/api/trending' + (query ? `?${query}` : ''),+ headers: { host: 'three.ws', origin: 'https://three.ws' },+ },+ res,+ );+ return res;+};++const coinQuery = () => queries.find((q) => /from oracle_conviction/.test(q.text));++const COINS = [+ {+ mint: 'FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump',+ symbol: 'THREE', name: 'three.ws',+ score: 100, tier: 'prime', momentum: 97, pedigree: 65, structure: 76, narrative: 48,+ smart_wallet_count: 12, scored_at: '2026-08-15T17:24:17.626Z',+ },+ {+ mint: 'THREEsynthetic1111111111111111111111111111',+ symbol: 'SYNTH', name: 'Synthetic',+ score: 100, tier: 'prime', momentum: 40, pedigree: 20, structure: 30, narrative: 10,+ smart_wallet_count: 0, scored_at: '2026-08-14T09:00:00.000Z',+ },+];++const AGENTS = [+ {+ id: '4339aafa-e5ed-496f-a8dd-9e6c4bff914d',+ name: 'Harbor #21',+ description: 'A friendly starter agent.',+ meta: { solana_address: '4Nex4B1MiquVWMF1FuDPHwBWQZWhQZTirichyBFwtxBV' },+ avatar_thumbnail_key: 'thumb/harbor.png',+ avatar_visibility: 'public',+ window_chats: 9,+ chat_count: 41,+ },+ {+ id: '845e4464-1d17-4cac-8990-be3f72bbc38d',+ name: 'Private avatar',+ description: null,+ meta: {},+ avatar_thumbnail_key: 'thumb/secret.png',+ avatar_visibility: 'private',+ window_chats: 2,+ chat_count: 3,+ },+];++beforeEach(() => {+ queries.length = 0;+ agentRows = AGENTS;+ coinRows = COINS;+ scoreAgentsLite.mockClear();+});++describe('GET /api/trending window', () => {+ it('filters the coin board to the requested window, not a fixed floor', async () => {+ const day = await read('window=24h');+ expect(day.statusCode).toBe(200);+ expect(day.json.window).toBe('24h');+ expect(coinQuery().text).toMatch(/scored_at >= now\(\) -\s+\?\s+::interval/);+ expect(coinQuery().values).toContain('24 hours');+ expect(coinQuery().text).not.toMatch(/36 hours/);++ queries.length = 0;+ const week = await read('window=7d');+ expect(week.json.window).toBe('7d');+ expect(coinQuery().values).toContain('7 days');+ });++ it('drops the freshness floor entirely for all time', async () => {+ const res = await read('window=all');+ expect(res.json.window).toBe('all');+ expect(coinQuery().text).toMatch(/from oracle_conviction/);+ expect(coinQuery().text).not.toMatch(/scored_at >=/);+ });++ it('falls back to 24h for a window it does not serve', async () => {+ const res = await read('window=lifetime');+ expect(res.json.window).toBe('24h');+ expect(coinQuery().values).toContain('24 hours');+ });++ it('orders the coin board deterministically so two identical reads rank the same', async () => {+ for (const w of ['24h', '7d', 'all']) {+ queries.length = 0;+ await read(`window=${w}`);+ // Score saturates at 100; the tie-break is what keeps the board stable.+ expect(coinQuery().text).toMatch(+ /order by score desc, momentum desc, smart_wallet_count desc, scored_at desc, mint/,+ );+ }+ });+});++describe('GET /api/trending payload', () => {+ it('ranks and shapes both boards for the page', async () => {+ const res = await read('window=24h&limit=10');+ const { agents, coins } = res.json;++ expect(agents.map((a) => a.rank)).toEqual([1, 2]);+ expect(agents[0].agent_url).toBe('https://three.ws/agent/4339aafa-e5ed-496f-a8dd-9e6c4bff914d');+ expect(agents[0].avatar_thumbnail_url).toBe('https://cdn.test/thumb/harbor.png');+ // A private avatar's thumbnail never leaves the platform on a public feed.+ expect(agents[1].avatar_thumbnail_url).toBeNull();+ expect(agents[0].solana_address).toBe('4Nex4B1MiquVWMF1FuDPHwBWQZWhQZTirichyBFwtxBV');++ expect(coins.map((c) => c.rank)).toEqual([1, 2]);+ expect(coins[0].coin_url).toBe('https://three.ws/oracle/coin/FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump');+ expect(coins[0].score).toBe(100);+ expect(res.getHeader('cache-control')).toMatch(/max-age=120/);+ });++ it('caps limit at 20 and floors it at 1', async () => {+ await read('limit=500');+ expect(coinQuery().values).toContain(20);+ queries.length = 0;+ await read('limit=0');+ expect(coinQuery().values).toContain(1);+ });++ it('still answers with the activity board when reputation enrichment fails', async () => {+ scoreAgentsLite.mockRejectedValueOnce(new Error('scoring down'));+ const res = await read('window=24h');+ expect(res.statusCode).toBe(200);+ expect(res.json.agents).toHaveLength(2);+ expect(res.json.agents[0].reputation).toBeUndefined();+ });+});