Skip to content

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.

chore(gitignore): keep stray dev-server logs out of the worktree

nirholas429bdd0aaed7
diff --git a/.gitignore b/.gitignore
index 64bfcebbf..0fb1e19c1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -487,3 +487,6 @@ contracts/program-tests/target/
# Downloaded ONNX weights cached by the node-operator self-test (23 MB+, fetched on demand)
packages/node-operator/models/
+
+# Dev-server logs from `npm run dev` on an alternate port (.vite<port>.log).
+.vite*.log
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f9884c7be..48751cadc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -18,6 +18,7 @@ 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]`
+- **Coin Intelligence fits a phone screen, and a search no longer snaps back to the previous results**: Five fixes to the Coin Intelligence dashboard. On a narrow phone the page was sized against its own tab strip rather than the screen, pushing the layout about 170px wider than the viewport; because the site clips sideways overflow, the right-hand third of the headline, the counters and every coin card was cut off with no way to scroll to it. The page now fits the screen and the tab strip scrolls inside its own row. Changing a filter or typing a search could also snap back to the previous set of coins a second later, because the older request was still open and whichever answer arrived last won; only the newest request can now paint the radar. The leaderboard used to greet an empty day with the radar's message about loosening filters, next to a Reset filters button that did nothing at all, since the leaderboard has no filters; it now explains that nothing has cleared observation in the last 24 hours. When the feed is down, the counters in the header stay in place instead of vanishing, the Confirmed winners rail and the Outcomes and Coverage panels say so instead of standing over empty boxes, and every one of those messages now carries a Retry that actually reloads. Smart Money shows shimmering placeholder rows while its cross-coin wallet aggregate is computed, and that aggregate plus the learning stats are now cached for minutes at the edge rather than seconds, so repeat visits are immediate. (`/coin-intel`) `[fix, improvement]`
- **Coins explains a failed market feed and gives you a button that actually retries it**: The Coins index had three ways to leave you stuck with no explanation. Load more coins swallowed a failed request silently, so a click that fetched nothing looked like a broken button, and it kept offering more rows forever even after the feed had run out. A market table that failed to load said only that data was temporarily unavailable, with nothing to press. The global stats strip across the top vanished entirely when its request failed, so the page looked like it simply had no market cap, dominance or Fear and Greed to show. All three now say what happened and hand you a working retry: the table and the stats strip each get a Try again that refetches in place, a load-more failure keeps the rows you already have and explains itself, and once the feed is exhausted the button retires with a line telling you how many coins it ranked. Being rate limited is now told apart from an outage, so you are asked to wait a minute rather than to keep hammering a feed that will refuse you. The coin search box shows a Searching indicator while it waits instead of staying shut, explains a failed lookup instead of closing as if nothing happened, keeps its previous results readable while the next query resolves, and can no longer let a slow answer overwrite a newer one. Screen readers now follow the highlighted search result, and an empty feed no longer wears the wording of a failure. (`/coins`) `[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]`
@@ -35,6 +36,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
- **The security agent in the world no longer opens its scanner in your face**: zauth, the security agent standing in the town plaza, used to throw its RepoScan panel over the screen the moment you walked within a few metres of it, interrupting whatever you were doing and hiding the world behind a modal you never asked for. Walking up now only gets you the agent's line and the usual E prompt above its head. The scanner opens when you choose to open it: press E, click the agent, or click its nameplate. Nothing else changed about the scan itself, and the price is still fetched live from zauth in the background as you approach, so the panel shows the real cost the instant it opens instead of a loading shimmer. (`/play`) `[fix, improvement]`
- **The viewer's backdrop picker stops vanishing while you read it, and sharing no longer posts "Meet Agent"**: Five fixes to the 3D model viewer at /app. Opening the Backdrop picker and taking a few seconds to read the six choices used to make the picker fade out from under the cursor: the viewer hides its controls after five seconds of stillness, and the picker was not on the list of surfaces that keep them awake, so an open picker went invisible and unclickable while still counting as open. It now stays put until you choose a backdrop or close it, and the controls resume fading once it is shut. Typing in the animation search while the clips were still loading stacked a second, contradictory message under the first, so the panel read "Loading clips" and "No clips matching" at the same time, and clearing the box left behind the nonsense line "No clips matching" with nothing in the quotes; the search now stays quiet until there are clips to search. Sharing the viewer to X, Farcaster or Telegram published "Meet Agent", an internal placeholder name, for anyone who had not loaded an agent of their own, and now uses the generic line instead. The page also shipped a sign-in panel and a welcome card that its own stylesheet blanked unconditionally, four links nobody could ever reach, and the preview card shown when the page is shared described the platform instead of the viewer. The avatar gallery behind the Avatar button is now announced to screen readers as a named dialog. (`/app`) `[fix, improvement]`
- **There is a real car in every coin world now, and you can get in and drive it**: The cars in a coin world used to be boxes: a box on wheels driving the ring road, and a slightly different box parked for you to drive. Both are now the Trench Car, a real community model published to the three.ws avatar gallery, so the car that drives past you on the road is the same car parked at the plaza that you can get into. Walk within a few metres of one, press F (or tap the car on a phone) and drive it with WASD and the on-screen pedals, with a working speedometer, brake lights and a handbrake. Your driver now actually sits in the seat: every car in the world had been placing its driver standing on the roof, and other players saw them there too, because the seat was measured from the wrong point. Drivers are now seated inside the car in a seated pose for themselves and for everyone else in the world. Parked cars had also been sitting with their wheels a few centimetres into the asphalt, and snapping up the moment someone took the wheel; they now rest on their wheels whether or not anyone is driving. The model is optimized on the way in, from 16 MB down to 1.4 MB with a third of the triangles, one download shared by every car on screen, and if it ever fails to load the old box still drives so the delivery jobs keep working. (`/play`) `[feature, improvement, fix]`
+- **Token in 3D paints in seconds instead of waiting on the slowest lookup, and the trade tape stops reporting every swap as $0**: The /coin3d page renders any pump.fun or Solana token as a live 3D scene, and it was audited end to end in a real browser: the landing search, a loaded token, and every loading, empty and error state at phone, tablet and desktop widths. The biggest finding was that the whole page waited on the top-holder scan before showing anything. That scan walks every token account and takes around ten seconds on a large holder set, so the page sat on a spinner the entire time, and if the scan stalled outright there was no timeout at all and the spinner never went away. The coin, the price, the stats and the live tape now paint as soon as the token identity resolves, and the holder galaxy grows into the scene when the scan lands, with the holder share showing as pending until then. Every lookup is now bounded, so a stalled data source degrades one number instead of freezing the page. The live trade tape had been rounding every trade to the nearest dollar, which printed real swaps as $0 and 0.000 SOL; it now shows cents and fractional SOL. When a data source is genuinely unreachable the page says that, with a retry, instead of claiming the token does not exist. On a 320px screen the landing card no longer runs off the right edge with the search button and a third of the launch grid cut off, and it scrolls instead of clipping its own footer. The page also had no top-level heading in any state but one, the browser tab title reverted to the generic page name once translations loaded, and the price chart and holder share showed placeholder boxes that could pulse forever; all three are fixed. (`/coin3d`) `[fix, improvement]`
- **Wallet Intelligence stops reporting win rates like 570% and 9790%**: The pump.fun track record at /claim-wallet was audited end to end in a real browser, and the headline numbers were wrong. Lifetime win rate, early-entry win rate and dump rate are stored as percentages, but the page multiplied them by a hundred a second time, so a wallet that wins 5.7% of its trades was shown as '570% lifetime' and a 97.9% dump rate read '9790%'. The meters beside them were pinned full for the same reason, and the colour that flags a heavy dumper was triggered by anything above 0.3%. All three now read the real figure. Four other repairs came out of the same pass. A wallet the reputation brain has graded but whose per-coin rows are still indexing used to show an empty ledger captioned 'No coins match these filters', blaming filters that were not the cause; it now explains that the ledger is still filling in. When filters genuinely do hide everything, the table says how many coins were hidden and offers one click to clear them. The ledger header no longer claims 60 coins while showing 52, since dust is hidden by default. A dropped connection used to blank the report and print the browser's raw 'Failed to fetch' beside the search box with no way forward, and now shows a proper panel naming the cause with a Try again button. The Analyze button's 'Analyzing…' label was being overwritten by the translation pass and never appeared. Keyboard and screen-reader users can now sort the ledger and open any coin: the column sorters are real buttons that announce their sort direction, every row carries a real link to that coin's dashboard, the time-window and filter controls report whether they are on, and every control on the page shows a visible focus ring. (`/claim-wallet`) `[fix, improvement]`
## 2026-08-16
diff --git a/data/changelog.json b/data/changelog.json
index 153c3408c..b76720559 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-17",
+ "title": "Coin Intelligence fits a phone screen, and a search no longer snaps back to the previous results",
+ "summary": "Five fixes to the Coin Intelligence dashboard. On a narrow phone the page was sized against its own tab strip rather than the screen, pushing the layout about 170px wider than the viewport; because the site clips sideways overflow, the right-hand third of the headline, the counters and every coin card was cut off with no way to scroll to it. The page now fits the screen and the tab strip scrolls inside its own row. Changing a filter or typing a search could also snap back to the previous set of coins a second later, because the older request was still open and whichever answer arrived last won; only the newest request can now paint the radar. The leaderboard used to greet an empty day with the radar's message about loosening filters, next to a Reset filters button that did nothing at all, since the leaderboard has no filters; it now explains that nothing has cleared observation in the last 24 hours. When the feed is down, the counters in the header stay in place instead of vanishing, the Confirmed winners rail and the Outcomes and Coverage panels say so instead of standing over empty boxes, and every one of those messages now carries a Retry that actually reloads. Smart Money shows shimmering placeholder rows while its cross-coin wallet aggregate is computed, and that aggregate plus the learning stats are now cached for minutes at the edge rather than seconds, so repeat visits are immediate.",
+ "tags": [
+ "fix",
+ "improvement"
+ ],
+ "link": "/coin-intel"
+ },
{
"date": "2026-08-17",
"title": "The Concierge page stops cutting itself off on a phone, and its install tabs work from the keyboard",
diff --git a/public/changelog.json b/public/changelog.json
index c41134156..e447d16e7 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-08-17T04:29:52.560Z",
+ "generated_at": "2026-08-17T04:31:23.562Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
@@ -136,6 +136,17 @@
"improvement"
]
},
+ {
+ "date": "2026-08-17",
+ "type": "update",
+ "title": "Coin Intelligence fits a phone screen, and a search no longer snaps back to the previous results",
+ "summary": "Five fixes to the Coin Intelligence dashboard. On a narrow phone the page was sized against its own tab strip rather than the screen, pushing the layout about 170px wider than the viewport; because the site clips sideways overflow, the right-hand third of the headline, the counters and every coin card was cut off with no way to scroll to it. The page now fits the screen and the tab strip scrolls inside its own row. Changing a filter or typing a search could also snap back to the previous set of coins a second later, because the older request was still open and whichever answer arrived last won; only the newest request can now paint the radar. The leaderboard used to greet an empty day with the radar's message about loosening filters, next to a Reset filters button that did nothing at all, since the leaderboard has no filters; it now explains that nothing has cleared observation in the last 24 hours. When the feed is down, the counters in the header stay in place instead of vanishing, the Confirmed winners rail and the Outcomes and Coverage panels say so instead of standing over empty boxes, and every one of those messages now carries a Retry that actually reloads. Smart Money shows shimmering placeholder rows while its cross-coin wallet aggregate is computed, and that aggregate plus the learning stats are now cached for minutes at the edge rather than seconds, so repeat visits are immediate.",
+ "link": "/coin-intel",
+ "tags": [
+ "fix",
+ "improvement"
+ ]
+ },
{
"date": "2026-08-17",
"type": "update",
diff --git a/public/changelog.xml b/public/changelog.xml
index 476934500..566e65643 100644
--- a/public/changelog.xml
+++ b/public/changelog.xml
@@ -102,6 +102,14 @@
<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>Coin Intelligence fits a phone screen, and a search no longer snaps back to the previous results</title>
+ <link>https://three.ws/coin-intel</link>
+ <guid isPermaLink="false">2026-08-17:Coin Intelligence fits a phone screen, and a search no longer snaps back to the previous results</guid>
+ <pubDate>Mon, 17 Aug 2026 12:00:00 GMT</pubDate>
+ <category>fix</category>
+ <description>Five fixes to the Coin Intelligence dashboard. On a narrow phone the page was sized against its own tab strip rather than the screen, pushing the layout about 170px wider than the viewport; because the site clips sideways overflow, the right-hand third of the headline, the counters and every coin card was cut off with no way to scroll to it. The page now fits the screen and the tab strip scrolls inside its own row. Changing a filter or typing a search could also snap back to the previous set of coins a second later, because the older request was still open and whichever answer arrived last won; only the newest request can now paint the radar. The leaderboard used to greet an empty day with the radar's message about loosening filters, next to a Reset filters button that did nothing at all, since the leaderboard has no filters; it now explains that nothing has cleared observation in the last 24 hours. When the feed is down, the counters in the header stay in place instead of vanishing, the Confirmed winners rail and the Outcomes and Coverage panels say so instead of standing over empty boxes, and every one of those messages now carries a Retry that actually reloads. Smart Money shows shimmering placeholder rows while its cross-coin wallet aggregate is computed, and that aggregate plus the learning stats are now cached for minutes at the edge rather than seconds, so repeat visits are immediate.</description>
+ </item>
<item>
<title>Coins explains a failed market feed and gives you a button that actually retries it</title>
<link>https://three.ws/coins</link>
diff --git a/public/features.json b/public/features.json
index d9c7704de..72e1df542 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-08-17T04:29:52.262Z",
+ "generated_at": "2026-08-17T04:31:23.357Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
diff --git a/tests/x402-runway-sim.test.js b/tests/x402-runway-sim.test.js
index a531e594a..75907fcbf 100644
--- a/tests/x402-runway-sim.test.js
+++ b/tests/x402-runway-sim.test.js
@@ -230,7 +230,45 @@ describe('simulateRunway — input hardening', () => {
it('survives a fully empty input without throwing', () => {
const { summary } = simulateRunway({});
expect(summary.admitted).toBe(0);
- expect(summary.verdict).toBe('healthy');
+ // Not 'healthy': nothing was attempted, so nothing was proved.
+ expect(summary.verdict).toBe('idle');
+ });
+
+ it('calls a projection with no demand idle, not healthy', () => {
+ // The live shape that exposed this: a fee wallet UNDER its hard floor, so
+ // not one settle could land, on a rail nobody sent traffic to that day. The
+ // old contract reported verdict 'healthy' and a 100% admission rate for it,
+ // which is the exact misdiagnosis /economy-lab exists to prevent.
+ const { summary } = simulateRunway({
+ startLamports: 899_107,
+ floorLamports: 2_000_000,
+ runwayDays: 1,
+ minBudgetLamports: 10_000_000,
+ feeLamports: 5_000,
+ demandPerHour: 0,
+ hours: 72,
+ });
+ expect(summary.demanded).toBe(0);
+ expect(summary.verdict).toBe('idle');
+ expect(summary.admissionRate).toBeNull();
+ expect(summary.limiter).toBe('none');
+ });
+
+ it('reports the same wallet as starved the moment any demand arrives', () => {
+ const { summary } = simulateRunway({
+ startLamports: 899_107,
+ floorLamports: 2_000_000,
+ runwayDays: 1,
+ minBudgetLamports: 10_000_000,
+ feeLamports: 5_000,
+ demandPerHour: 60,
+ hours: 72,
+ });
+ expect(summary.admitted).toBe(0);
+ expect(summary.refusedFloor).toBe(60 * 72);
+ expect(summary.verdict).toBe('starved');
+ expect(summary.limiter).toBe('floor');
+ expect(summary.admissionRate).toBe(0);
});
it('never lets the balance go negative', () => {