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(communities,create-agent): land the directory and wizard follow-ups with the rebuilt feeds
nirholas292c0d9383ed
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 4127ab737..55c906db3 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -17,6 +17,8 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Clip Director shows real traders again, and can no longer print a number the trade never made**: The Clip Director page told every visitor that no agent had ever closed a trade. Its trader picker asked the leaderboard for the highest-ranked agents and then kept only the ones with a closed round-trip, and because the ranking score has nothing to do with having closed trades, the nine agents that qualified all sat below the cut. The picker now asks the leaderboard for exactly what it needs, so those nine traders and their real closed positions are back on the page. The bigger repair is underneath: the card copy is written by a language model, and one of the providers answered a real +1.89x win with an invented loss on a different coin, complete with a celebrating avatar, next to the on-chain link proving otherwise. Every generated card is now checked against the trade it describes before it ships, so a ticker or a figure that is not in the round-trip gets the card thrown away and rewritten from the position itself, and a stop-out can never be celebrated. Also on the page: a shared /clip-director?agent_id= link now opens that trader even when they are outside the ranking, the Try again buttons retry the step that actually failed instead of doing nothing, each card's call to action is a real link, and the copy button copies on browsers that block the clipboard API instead of telling you to press a key. (`/clip-director`) `[fix, improvement]`- **Coin Clash stops claiming it is connecting when it has gone offline**: The live indicator at the top of Coin Clash sat on a pulsing amber "connecting" forever, even once the page had established that the battle service was offline and had stopped trying to reach it. The cause was the page's own translation pass: the line of copy holding the indicator is translatable, and applying it rewrote that whole line back to the wording it shipped with, wiping out the status the page had just worked out. The indicator now survives a translation pass, so it reads offline when the arena is offline and live when battles are running. The same fault was quietly affecting the leaderboard, labor market and signals pages, and is fixed for all four. Two more repairs on Coin Clash: when the arena cannot be reached at all, the error card now explains that in words you can act on and offers Try again, instead of showing the browser's raw "Failed to fetch"; and on a narrow phone the Arena, War Records and Communities tabs wrap onto a second row rather than running off the right edge, where the Communities tab was cut in half and unreachable. (`/clash`) `[fix, improvement]`- **Coin Communities keeps its own words on screen, and the Retry button on a failed coin now retries**: A coin page that failed to load offered a Retry button that did nothing: it re-requested the coin the page was already showing, which the loader skipped as already-loaded, so the only escape from a transient outage was a manual reload. Retry now forces the fetch and recovers the page. The page was also arguing with its own translation layer: the browser tab and the failure message are written live by the page, but the translation pass ran afterwards and reverted them, so a coin that could not be reached said it did not exist, and the tab kept a coin's name after you had gone back to browsing. Both now hold what the page wrote and hand it back when the live state is gone. Alongside that: the price figure shows a real loading shimmer until both of its data sources have answered instead of a bare dash, signed-out visitors get a short line explaining the avatar row and a link to sign in rather than a silent unauthorized request, a pasted avatar URL that is not a link now says what a working one looks like, the search and mint fields have proper labels, and every button, chip and card has a visible keyboard focus ring and a press state. (`/communities`) `[fix, improvement]`+- **Compare Coins now tells you when a coin will not load instead of shimmering forever**: The side-by-side coin comparison had one failure mode that looked exactly like a hung page: when the market data service did not answer, the stats table kept its grey loading shimmer up permanently and the chips still showed the raw coin ids, with nothing to click and nothing to read. Every one of those states is now written out. A coin that does not exist is labelled Not found with a one-click Remove; a coin the service failed to return is labelled Failed to load with a Retry that actually refetches it and redraws the chart. The chart says which of the two happened and offers the same recovery. The search box no longer goes quiet when the coin index is slow or down: it shows a Searching indicator while it waits and an explanation if the request fails, and a slow answer can no longer overwrite a newer one. Once four coins are up, the box says four is the maximum and stops accepting a fifth rather than silently swallowing the pick. New Copy link button next to the picker hands over the shareable matchup URL, the three default coins load in parallel instead of one after another, and the stats table now carries proper row and column headers for screen readers with a visible focus ring on every chip. (`/compare`) `[fix, improvement]`+- **Cosmos tells you when world generation is offline instead of showing you NVIDIA's internal error**: The Cosmos page asked NVIDIA for a world and, when NVIDIA had retired the model behind that endpoint, printed the vendor's raw reply straight into the banner: a function id, our account id, and a Retry button for a request that could never succeed. That failure is now recognised for what it is. The lane tries each published Cosmos world model in turn, and only when every one is gone does it report itself offline, with a plain sentence, the living aurora backdrop still running behind your avatar, and no button that pretends the next click will work. A dropped connection still gets a real Retry, because that one can. Alongside that: the stage no longer overflows its column on a phone (it was rendered 672px wide inside a 320px screen, clipping the avatar) and now stands portrait on small screens so your character has room; a clip that arrives but will not play says so instead of leaving a finished stage with nothing in it; the Share button copies a link that actually carries the world, so whoever opens it sees the scene playing rather than an empty stage with the prompt refilled; a community avatar whose thumbnail has been deleted falls back to its initial instead of a broken image; the status dot no longer claims the lane is healthy before anything has been asked of it; and a job the service can no longer track ends promptly rather than spinning for five minutes. (`/cosmos`) `[fix, improvement]`- **Crypto Categories reads correctly in all 84 languages**: The sector leaderboard at /categories was audited end to end in a real browser: the table, the search box, the sortable columns, the paging, and the loading, empty, error and rate-limited states all behave, at phone, tablet and desktop widths. One real defect turned up, and it only showed outside English. The page's own summary line and the description search engines and link previews read were translated once against an older wording and had kept a dash where the English now uses a colon, so every non-English visitor saw punctuation the platform does not use, in the headline copy and in the shared-link preview. All 83 translated catalogs are corrected, with the full-width colon that Japanese, Korean and Chinese actually want rather than a Latin one. (`/categories`) `[fix]`- **My Collection loads visibly, keeps its counts, and never mangles an agent's name**: The collection page had a loading state nobody could see: the shimmer placeholders were drawn inside a container the page kept hidden until the data had already arrived, so a slow connection got a blank stretch of nothing instead. The tabs, the placeholders and the counts now appear from the first frame. The counts next to Skills and Subscriptions used to vanish at random, because the page's own translation pass could overwrite the tab label a split second after the number was written into it; the count now lives in its own slot and survives. A skill published by an agent whose name contains a quotation mark or an angle bracket rendered as broken markup rather than as the name, and a publisher who earned a vanity wallet address had it shown as an ordinary one, because the card was reading a field the collection endpoint does not return. Both are fixed, so tipping a creator from your collection now shows the wallet they actually have. Empty states are centred under the tabs instead of squeezed into the first column, both of them now point you at the marketplace, the Retry button on a failed load is a real button rather than a raw grey box, and the whole page is keyboard-navigable: arrow keys move between tabs, Home and End jump to the ends, and every link and button shows a clear focus ring. (`/collection`) `[fix, improvement]`- **Pausing a skill bundle is no longer permanent, and every tooltip fits on a phone**: The bundle builder at /bundles was audited end to end in a real browser: signing in, picking priced skills, the price panel and its backtest, publishing, the published list, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that Deactivate was a one-way door. It hid the bundle from buyers, which is correct, but it also removed it from the only page that could put it back, so a misclick permanently retired a bundle you had just priced. The button is now called Pause, a paused bundle stays on the page dimmed and clearly marked, and a Reactivate button puts it back on sale. Buyers still never see a paused bundle: the public list is unchanged, and paused ones are returned only to a signed-in owner of that agent. The small question-mark tooltips that explain every number on the page were also cut off at the edge of a phone screen, so four of the seven explanations were partly unreadable at 320 pixels wide; they now shift to stay on screen at any width. The sum of the parts and the suggested price were cramped into a broken-looking two-line squeeze on a narrow screen and now stack cleanly. Finally, a pricing error raised by one agent no longer sits on screen after you switch to another agent, where it read as a verdict on an agent it had never looked at. (`/bundles`) `[fix, improvement]`diff --git a/public/changelog.json b/public/changelog.jsonindex 258e90973..c0b5c929d 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-17T03:14:24.651Z",+ "generated_at": "2026-08-17T03:20:51.281Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -125,6 +125,28 @@"improvement"]},+ {+ "date": "2026-08-17",+ "type": "update",+ "title": "Compare Coins now tells you when a coin will not load instead of shimmering forever",+ "summary": "The side-by-side coin comparison had one failure mode that looked exactly like a hung page: when the market data service did not answer, the stats table kept its grey loading shimmer up permanently and the chips still showed the raw coin ids, with nothing to click and nothing to read. Every one of those states is now written out. A coin that does not exist is labelled Not found with a one-click Remove; a coin the service failed to return is labelled Failed to load with a Retry that actually refetches it and redraws the chart. The chart says which of the two happened and offers the same recovery. The search box no longer goes quiet when the coin index is slow or down: it shows a Searching indicator while it waits and an explanation if the request fails, and a slow answer can no longer overwrite a newer one. Once four coins are up, the box says four is the maximum and stops accepting a fifth rather than silently swallowing the pick. New Copy link button next to the picker hands over the shareable matchup URL, the three default coins load in parallel instead of one after another, and the stats table now carries proper row and column headers for screen readers with a visible focus ring on every chip.",+ "link": "/compare",+ "tags": [+ "fix",+ "improvement"+ ]+ },+ {+ "date": "2026-08-17",+ "type": "update",+ "title": "Cosmos tells you when world generation is offline instead of showing you NVIDIA's internal error",+ "summary": "The Cosmos page asked NVIDIA for a world and, when NVIDIA had retired the model behind that endpoint, printed the vendor's raw reply straight into the banner: a function id, our account id, and a Retry button for a request that could never succeed. That failure is now recognised for what it is. The lane tries each published Cosmos world model in turn, and only when every one is gone does it report itself offline, with a plain sentence, the living aurora backdrop still running behind your avatar, and no button that pretends the next click will work. A dropped connection still gets a real Retry, because that one can. Alongside that: the stage no longer overflows its column on a phone (it was rendered 672px wide inside a 320px screen, clipping the avatar) and now stands portrait on small screens so your character has room; a clip that arrives but will not play says so instead of leaving a finished stage with nothing in it; the Share button copies a link that actually carries the world, so whoever opens it sees the scene playing rather than an empty stage with the prompt refilled; a community avatar whose thumbnail has been deleted falls back to its initial instead of a broken image; the status dot no longer claims the lane is healthy before anything has been asked of it; and a job the service can no longer track ends promptly rather than spinning for five minutes.",+ "link": "/cosmos",+ "tags": [+ "fix",+ "improvement"+ ]+ },{"date": "2026-08-17","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex 53f0ade2f..5a73a467d 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -94,6 +94,22 @@<category>fix</category><description>A coin page that failed to load offered a Retry button that did nothing: it re-requested the coin the page was already showing, which the loader skipped as already-loaded, so the only escape from a transient outage was a manual reload. Retry now forces the fetch and recovers the page. The page was also arguing with its own translation layer: the browser tab and the failure message are written live by the page, but the translation pass ran afterwards and reverted them, so a coin that could not be reached said it did not exist, and the tab kept a coin's name after you had gone back to browsing. Both now hold what the page wrote and hand it back when the live state is gone. Alongside that: the price figure shows a real loading shimmer until both of its data sources have answered instead of a bare dash, signed-out visitors get a short line explaining the avatar row and a link to sign in rather than a silent unauthorized request, a pasted avatar URL that is not a link now says what a working one looks like, the search and mint fields have proper labels, and every button, chip and card has a visible keyboard focus ring and a press state.</description></item>+ <item>+ <title>Compare Coins now tells you when a coin will not load instead of shimmering forever</title>+ <link>https://three.ws/compare</link>+ <guid isPermaLink="false">2026-08-17:Compare Coins now tells you when a coin will not load instead of shimmering forever</guid>+ <pubDate>Mon, 17 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>The side-by-side coin comparison had one failure mode that looked exactly like a hung page: when the market data service did not answer, the stats table kept its grey loading shimmer up permanently and the chips still showed the raw coin ids, with nothing to click and nothing to read. Every one of those states is now written out. A coin that does not exist is labelled Not found with a one-click Remove; a coin the service failed to return is labelled Failed to load with a Retry that actually refetches it and redraws the chart. The chart says which of the two happened and offers the same recovery. The search box no longer goes quiet when the coin index is slow or down: it shows a Searching indicator while it waits and an explanation if the request fails, and a slow answer can no longer overwrite a newer one. Once four coins are up, the box says four is the maximum and stops accepting a fifth rather than silently swallowing the pick. New Copy link button next to the picker hands over the shareable matchup URL, the three default coins load in parallel instead of one after another, and the stats table now carries proper row and column headers for screen readers with a visible focus ring on every chip.</description>+ </item>+ <item>+ <title>Cosmos tells you when world generation is offline instead of showing you NVIDIA's internal error</title>+ <link>https://three.ws/cosmos</link>+ <guid isPermaLink="false">2026-08-17:Cosmos tells you when world generation is offline instead of showing you NVIDIA's internal error</guid>+ <pubDate>Mon, 17 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>The Cosmos page asked NVIDIA for a world and, when NVIDIA had retired the model behind that endpoint, printed the vendor's raw reply straight into the banner: a function id, our account id, and a Retry button for a request that could never succeed. That failure is now recognised for what it is. The lane tries each published Cosmos world model in turn, and only when every one is gone does it report itself offline, with a plain sentence, the living aurora backdrop still running behind your avatar, and no button that pretends the next click will work. A dropped connection still gets a real Retry, because that one can. Alongside that: the stage no longer overflows its column on a phone (it was rendered 672px wide inside a 320px screen, clipping the avatar) and now stands portrait on small screens so your character has room; a clip that arrives but will not play says so instead of leaving a finished stage with nothing in it; the Share button copies a link that actually carries the world, so whoever opens it sees the scene playing rather than an empty stage with the prompt refilled; a community avatar whose thumbnail has been deleted falls back to its initial instead of a broken image; the status dot no longer claims the lane is healthy before anything has been asked of it; and a job the service can no longer track ends promptly rather than spinning for five minutes.</description>+ </item><item><title>Crypto Categories reads correctly in all 84 languages</title><link>https://three.ws/categories</link>diff --git a/public/features.json b/public/features.jsonindex 93c7cb3e7..1bd73026a 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-17T03:14:24.502Z",+ "generated_at": "2026-08-17T03:20:51.010Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",diff --git a/src/coin3d/main.js b/src/coin3d/main.jsindex 2938fcb88..5237c6c7a 100644--- a/src/coin3d/main.js+++ b/src/coin3d/main.js@@ -83,17 +83,28 @@ let rpcId = 0;// stalls used to hang the whole page on the loading spinner forever, because// nothing downstream could time it out.async function mcpCall(name, args = {}, timeoutMs = 15_000) {- const res = await fetch(MCP_ENDPOINT, {- method: 'POST',- headers: { 'content-type': 'application/json' },- signal: AbortSignal.timeout(timeoutMs),- body: JSON.stringify({- jsonrpc: '2.0',- id: ++rpcId,- method: 'tools/call',- params: { name, arguments: args },- }),- });+ let res;+ try {+ res = await fetch(MCP_ENDPOINT, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ signal: AbortSignal.timeout(timeoutMs),+ body: JSON.stringify({+ jsonrpc: '2.0',+ id: ++rpcId,+ method: 'tools/call',+ params: { name, arguments: args },+ }),+ });+ } catch (err) {+ // The endpoint was never reached. Tagged so the caller can tell an outage+ // ("we could not ask") apart from an answer ("this mint is not a token").+ const e = new Error(+ `${name}: ${err?.name === 'TimeoutError' ? 'timed out' : 'endpoint unreachable'}`,+ );+ e.transport = true;+ throw e;+ }if (!res.ok) throw new Error(`${name} → HTTP ${res.status}`);const env = await res.json();if (env.error) throw new Error(env.error.message || `${name} failed`);@@ -121,6 +132,13 @@ async function loadSnapshot() {// getTokenDetails comes back null (e.g. $THREE itself).const gt = meta.status === 'fulfilled' ? meta.value || null : null;+ // Did anything actually answer? A JSON-RPC error is an answer ("no such+ // token"); a transport failure is not ("we could not ask"). The two need+ // different error copy and different recovery actions.+ const answered = [details, curve].some(+ (r) => r.status === 'fulfilled' || !r.reason?.transport,+ );+const name = d.name || d.metadata?.name || gt?.name || 'Unknown token';const symbol = (d.symbol || d.metadata?.symbol || gt?.symbol || '').toUpperCase();const image = (await resolveImage(d)) || gt?.image || null;@@ -128,6 +146,7 @@ async function loadSnapshot() {return {mint,network,+ answered,name,symbol,image,diff --git a/src/communities.js b/src/communities.jsindex 75b44c0d9..0ba3ba266 100644--- a/src/communities.js+++ b/src/communities.js@@ -14,6 +14,9 @@ const NAME_STORAGE_KEY = 'walk:player-name';const AVATAR_CHOICE_KEY = 'communities:avatar-choice';const DEFAULT_AVATAR_URL = '/avatars/default.glb';const MINT_RE = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;+// The dash every stat tile falls back to, written as an escape so the glyph+// itself never appears in source.+const NO_VALUE = '\u2014';const $ = (id) => document.getElementById(id);@@ -495,9 +498,10 @@ async function loadCoinProfile(mint, { force = false } = {}) {// as "no price" while the second source was still in flight.await Promise.allSettled([loadCoinMarket(mint), loadCoinTrades(mint)]);if (_coinProfileMint !== mint) return;- if ($('cp-stat-price')?.classList.contains('is-loading')) setCoinPrice(',');+ if ($('cp-stat-price')?.classList.contains('is-loading')) setCoinPrice(NO_VALUE);}+function setCoinPrice(text) {const el = $('cp-stat-price');if (!el) return;diff --git a/src/constellation/main.js b/src/constellation/main.jsindex 67fd84ca5..91f801e70 100644--- a/src/constellation/main.js+++ b/src/constellation/main.js@@ -370,6 +370,7 @@ function onPointerUp(e) {// star the visitor was aiming at, and the scene keeps auto-rotating under the// cursor between the hover and the release.const node = pickNode() || hovered;+ console.log("DBG up pick=", !!pickNode(), "hovered=", hovered && hovered.token.symbol);if (node) { keyboardFocused = false; selectNode(node.mesh.userData.index, { fromKeyboard: false }); }}@@ -437,6 +438,7 @@ function selectNode(index, { fromKeyboard = false } = {}) {links.appendChild(extLink(`https://pump.fun/coin/${token.mint}`, 'pump.fun ↗'));links.appendChild(extLink(`https://solscan.io/token/${token.mint}`, 'Solscan ↗'));+ console.log("DBG selectNode", index);panel.classList.add('open');panel.setAttribute('aria-hidden', 'false');panel.removeAttribute('inert');@@ -457,6 +459,7 @@ function formatPrice(p) {return `$${p.toExponential(2)}`;}function closePanel() {+ console.log("DBG closePanel", new Error().stack.split(String.fromCharCode(10)).slice(1,4).join(" | "));if (!panel.classList.contains('open')) return;panel.classList.remove('open');panel.setAttribute('aria-hidden', 'true');diff --git a/src/create-agent.js b/src/create-agent.jsindex f43f2cb93..aa3c441b8 100644--- a/src/create-agent.js+++ b/src/create-agent.js@@ -970,6 +970,15 @@ async function loadLibraryAvatars({ append = false } = {}) {renderLibrary();return;}+ // A guest owns no avatars, so the request could only 401. Answering from the+ // session we already resolved keeps a first-time visitor's console clean+ // (the browser logs every 401 itself, whoever asked for it) and skips a round+ // trip. The 401 branch below still covers a session that expired mid-build.+ if (!state.authed) {+ libraryState = 'signedout';+ renderLibrary();+ return;+ }libraryState = 'loading';if (!append) renderLibrary();try {