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
docs(deploy): record the avatar-sdk build step in the runbook and publish this batch
nirholasaf3d35b605bc
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 45b43c4a7..058969d11 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,6 +7,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr## 2026-08-17- **Docs · Cars in /play: traffic and the drivable fleet** (`/docs/play-vehicles`): The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.+- **A failed X seed no longer costs you six hours, and can no longer wipe a good one**: Seeding an agent from your X posts is allowed once every six hours per agent, and until now that window was spent the moment we started reading, whatever happened next. If X was throttling us, if X had stopped accepting the connection, or if your sign-in could not be renewed, you got a bare failure and a six-hour lockout for something that was never yours to fix. Every one of those now hands the window straight back and says what actually happened: reconnect X, or wait the number of minutes X itself told us to wait. Worse was the run that read your account fine and found nothing usable in it, which is what a timeline of only replies and reposts looks like. That run deleted the batch of facts your agent already had and put nothing in its place. It now stops before the deletion, keeps the memories you had, gives the window back, and tells you what to post or add to your profile so the next seed has something to work with. Nothing else about the lane changes: nothing is read until you consent on a screen that lists what is read and stored, and revoking still deletes every memory the seeding produced. (`/settings`) `[fix]`- **A shared ASL letter link now opens on that letter, not on A**: The manual alphabet at /asl-alphabet was audited end to end in a real browser, and six repairs came out of it. Sharing a letter was the worst of them: a /asl-alphabet?letter=W link built the whole page around the letter A and only corrected itself once the 3D avatar had finished downloading, so anyone on a slow connection read A's description, saw A's key lit and A's look-alike note for the entire wait, on a link that promised W. The page now reads the link before it builds anything, so the right letter is on the card from the first paint and the avatar simply catches up. The Spell anything box had the opposite problem: it reported an empty or unspellable word only in the small caption pinned to the avatar, which on a phone sits a full screen above the box you just typed in, so pressing Spell it with a word full of punctuation looked like a dead button. It now answers in its own line, right under the input, and while the hand is spelling it lays the word out letter by letter and lights each one as the hand reaches it, so a long word can be followed without scrolling back up to the A-to-Z grid. That caption itself was white text on a scrim too faint to read over a pale avatar or in light mode, and is now a proper legible chip. Opening the avatar picker no longer lets a keystroke through to sign a letter behind the dialog. Switching avatars used to leave 'Loading avatar…' on screen forever once the new one had arrived, which also meant screen readers were never told the load had finished. And the Spell panel is no longer stretched to the height of the drill beside it, which left a large empty box on desktop. (`/asl-alphabet`) `[fix, improvement]`- **Avatar Studio now shows your whole avatar, and its Save button fits on a phone**: The studio camera was framing the base body from the shoulders to the knees: the face you were sculpting and the shoes you were picking were both outside the picture, and the only way to see them was to orbit the camera yourself every time the page loaded. The framing is now solved from the lens rather than guessed at, so a full-body shot really does hold the avatar head to toe, arms included, on any window shape, and the half-body and headshot views stay as tight as their names promise. On a 320px phone the top bar had been running past the edge of the screen and taking the Save avatar button with it, so a look built on a phone could not be saved at all; the bar now fits, with the Back and title labels standing down to make room. The tab strip on that same narrow layout had been hiding its labels without putting anything in their place, leaving six blank buttons, and now shows an icon per tab. The Parametric body badge that read 120+ sliders was white text on a white pill and invisible everywhere. A failed save now says the connection could not be reached and that your look is still there, instead of repeating the browser phrase Failed to fetch, and every accessory search box, every tab and the Back link now carry names a screen reader can read. Opening avatar-studio in local development also serves the same page production does, which it previously did not. (`/avatar-studio`) `[fix, improvement]`- **Avatar Studio survives an accessory outage, and tells you when it is putting a hat on**: The studio at /avatar-studio was audited end to end in a real browser: loading the base body, all six tabs, the colour swatches, the sculpt sliders, the motion library, undo and redo, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that a single failed request for the accessory catalogue took the entire studio down. The hats, glasses and earrings lists come from one file, and if that file did not load, the page replaced everything with a Retry screen, throwing away the 3D avatar it had already finished loading. Colours, sculpting, animation and saving need nothing from that catalogue, so they all now keep working, and only the three accessory tabs show a message explaining what is missing, with a Retry button that reloads just the catalogue. The Save, Reset, Randomise and Undo buttons were also on screen but not yet connected until that same request finished, so pressing them early did nothing at all and the tab strip sat empty; they are live from the first paint now. Putting on a hat downloads and fits a 3D model, which takes a few seconds, and until now the studio gave no sign it was working: the tile click looked ignored, and a hat that failed to download failed in complete silence. Every accessory change now shows what it is doing and says so plainly if it could not finish. Randomise no longer lists an accessory you are not actually wearing when its model fails to load. Pressing Undo then Redo quickly could leave the avatar and the list of what it is wearing disagreeing with each other; each step now settles correctly. Spinners also finally stop for people who have asked their device to reduce motion. (`/avatar-studio`) `[fix, improvement]`@@ -15,6 +16,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Choreographer share links are readable again, and the studio fits a phone**: The gesture composer at /choreograph was audited end to end in a real browser: loading a starter routine, adding and reordering beats, retiming and repointing a step, previewing the whole performance on a live avatar, scrubbing the timeline, sharing a link, and saving to a real agent, at phone, tablet and desktop widths. Copy share link used to hand you a link with the routine name escaped twice, so a routine called The pitch travelled as The%2520pitch: it worked, but it looked broken, and it invited people to tidy it up and break it for real. Links now carry the routine as you can read it, and every link shared before today still opens. A routine whose name ended in the loop marker came back from a link under the wrong name and looping when it should not. On a 320 pixel phone, opening either of the two code panels pushed the whole page sideways; the code block now scrolls on its own instead. Pressing the transport a second time while the first play was still loading its clips said Pause but started a second load; it now stops the one in progress, and deleting the last beat mid-load can no longer bring an avatar back onto a stage the routine has left. Signed-out visitors also no longer see a failed request in the browser console on first paint. (`/choreograph`) `[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]`- **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]`+- **The avatar SDK bundle we ship is now built from the code we deploy**: The <agent-3d> runtime that sites load from three.ws is a single bundled file, and the production build never rebuilt it. It was copied from whatever the build machine happened to have on disk, which could be days older than the code being deployed, so a fix to the avatar element could ship everywhere else on the site and quietly not reach the SDK. The deploy now rebuilds that bundle from the same commit as the rest of the release, every time. Nothing to change on your side: existing embeds keep working and simply pick up the current runtime. (`/avatar-sdk`) `[fix, sdk, infra]`- **The Characters gallery pages past the first screen, and stops fighting dark mode**: The character gallery at /characters was audited end to end in a real browser: loading the feed, both sort orders, search, Load more, following a card through to its character page, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that the Top sort was quietly broken. Sorting by most-chatted read the right first screen, but pressing Load more asked the server to continue from the wrong place, so the feed ended after eight characters out of more than two thousand. It now pages all the way through, in order. The page also ignored the site theme: it painted a fixed light-blue background under the dark header no matter what you had chosen, which is now fixed in both directions, and wallet addresses on the cards were nearly invisible on a light background everywhere they appear on the site. The gallery filled only a narrow strip down the middle of a desktop screen and now uses the full width, up to four cards across. If the feed failed to load you got one line of grey text and no way to retry; there is now a proper message with a Try again button, a failed Load more keeps the characters you already had, and searching for something with no matches offers to clear the search rather than leaving you at a dead end. Pressing Top while the first screen was still loading used to light up the button and change nothing, so you were left reading New results under a Top heading. The search box had no label for screen readers, the sort buttons never showed which was selected, and neither they nor Load more showed a focus outline for anyone navigating by keyboard. Keyboard users can also now skip the header and land in the gallery. Finally, the feed itself is several times faster to answer on a cold request, because it no longer counts every conversation of every published character just to show you twenty-four of them. (`/characters`) `[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]`@@ -1186,7 +1188,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr## 2026-07-19- **Agent Sniper: Autonomous On-Chain Trading** (`/docs/agent-sniper`): How three.ws agents trade autonomously: the new-mint trigger, entry gates, the simulate-the-sell trade firewall, the hash-chained decision ledger, the exit ladder, and the case study of the first live +42% trade.-- **Character Library** (`/character-library`): 106 professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer in one click.+- **Character Library** (`/character-library`): Professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer.- **Daily Match** (`/daily-match`): Which agent ships the most real output today? Live daily standings over real agent activity: actions, trades, skill sales, and coin launches. Resets at 00:00 UTC.- **Docs · Assistant widget** (`/docs/assistant-widget`): Add a 3D avatar assistant to any website: the one-tag script, the @three-ws/assistant npm package, and the assistant-widget MCP server for AI agents.- **Docs · Publisher rights in the news reader** (`/docs/news-rights`): What three.ws shows from a publisher's article and what it never shows: the enforced lead-excerpt limit, how a withdrawn story is removed (410, deindex, purge), and how publishers can ask us to take something down.diff --git a/CLAUDE.md b/CLAUDE.mdindex 9d433e70f..63b03f588 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -289,9 +289,9 @@ Remember stop-and-ask gate 2: production deploys need owner approval unless the1. **Prepare a CLEAN worktree: `npm run prep:worktree -- --apply`.** That is the whole step; it encodes everything below, and running it beats staging by hand. Plan first with a bare `npm run prep:worktree` (writes nothing), `--path <dir>` to stage your own tree instead of colliding with a concurrent agent on the default `/workspaces/.deploy-wt`, `--force` to replace an existing tree (refused if it holds uncommitted work). What it does: `git worktree add --detach <path> HEAD`, then hardlinks THREE artifacts with `cp -al` on the same filesystem (not just the first): `node_modules`, `chat/node_modules`, and `character-studio/build`, plus copies BOTH `.env` and `.env.local`. Omitting either nested one kills the build minutes in: an OOM exit 144 on the avatar-studio rebuild, or `Cannot find package '@sveltejs/vite-plugin-svelte'` on the chat build. A nested artifact that is missing from the source tree is BUILT first (`deps:chat`, `build:avatar-studio`) rather than skipped, which is the failure a hand-run `cp -al` produces on a machine that has never deployed. `.env.local` is the one that carries `DATABASE_URL`, and without it step 3's migration gate cannot read the schema state and refuses to submit. **Remove it when the deploy lands** (`git worktree remove --force <path>`); that is what step 0 exists to clean up after. See `docs/ops/gcp-production.md`.2. **Build: `npm run build:gcp`.** ORDER IS LOAD-BEARING and `build:gcp` already encodes it. Never hand-run the steps in a different order. The full chain, in order:- `check:conflicts` → `check:browser-graph` → `ensure:avatar-studio` → `build:info:snapshot` → `build:chat` → `build` (the frontend `vite build`) → `build:lib:full` (the UMD lib) → `publish:lib` → `build:info` → `check:dist` → `check:pages`+ `check:conflicts` → `check:browser-graph` → `ensure:avatar-studio` → `build:info:snapshot` → `build:lib:full` (the UMD lib) → `build:avatar-sdk` → `build:chat` → `build` (the frontend `vite build`) → `publish:lib` → `build:info` → `check:dist` → `check:pages`- Why the order is load-bearing: `check:conflicts` runs first so an unresolved merge-conflict marker fails in seconds instead of after a full build. Then the frontend `vite build` runs with `emptyOutDir`, so it WIPES `dist/` and everything that writes into `dist/` must come after it. `publish:lib` mirrors the UMD lib into `dist/`, so it must follow `build:lib:full`, and `check:dist` fails without that bundle present. The first two steps are exactly why step 1 stages worktree artifacts: `ensure:avatar-studio` consumes `character-studio/build` and `build:chat` consumes `chat/node_modules`. Do NOT hand-run `build:vercel` as the frontend build: it builds the SDK/lib sub-artifacts, NOT the static HTML pages, so `dist/` ends up without `/`, `/create`, etc. and `check:dist` fails.+ Why the order is load-bearing: `check:conflicts` runs first so an unresolved merge-conflict marker fails in seconds instead of after a full build. `build:lib:full` writes `dist-lib/agent-3d.js`, `build:avatar-sdk` copies that bundle into `avatar-sdk/dist/index.mjs`, and the frontend `vite build` resolves `avatar-sdk/src/agent.js` against it, so both must come BEFORE `build`; skipping them shipped whatever stale `avatar-sdk/dist` the build machine happened to hold, and in a fresh worktree failed the build outright with `Could not resolve "../dist/index.mjs"` (2026-08-17). The frontend `vite build` runs with `emptyOutDir`, so it WIPES `dist/` and everything that writes into `dist/` must come after it: that is why `publish:lib`, which mirrors the UMD lib into `dist/`, follows `build` rather than sitting next to `build:lib:full`, and `check:dist` fails without that bundle present. `ensure:avatar-studio` consumes `character-studio/build` and `build:chat` consumes `chat/node_modules`, which is exactly why step 1 stages worktree artifacts. Do NOT hand-run `build:vercel` as the frontend build: it builds the SDK/lib sub-artifacts, NOT the static HTML pages, so `dist/` ends up without `/`, `/create`, etc. and `check:dist` fails.3. **Submit: `npm run deploy:gcp:submit`.** That is `db:check` (exit 4 if any migration is pending) followed by the same `gcloud builds submit --config server/cloudbuild.yaml --region us-central1 --project aerial-vehicle-466722-p5`. Do NOT hand-run the bare `gcloud builds submit`: it is the only step that would have caught new code shipping over an old schema, and skipping it is how production ended up serving handlers that query columns their migration never applied (`column "blocks_behind" does not exist`, live on 2026-08-14). If the gate says migrations are pending, apply them first (`npm run db:status`, then `npm run db:migrate`); if it says `DATABASE_URL is not set`, step 1 did not copy `.env.local`. EVERY cloudbuild config must pin `serviceAccount: .../three-ws-build@...` (the default compute SA was deleted), and manual submits need `--substitutions=SHORT_SHA=manual$(date +%s)` when the config tags images with `$SHORT_SHA`.4. **Purge CDN: `npm run deploy:gcp:purge-cdn`.** The purge is synchronous on purpose. Do not re-add `--async`, or post-deploy checks read stale edge content and report phantom failures.5. **Verify the deploy landed.** `curl -s https://three.ws/api/version` returns the live commit SHA + Cloud Run revision, and `npm run smoke:prod` sweeps every page declared in `data/pages.json` against the live site (`deploy:gcp` runs it automatically after the purge).diff --git a/data/changelog.json b/data/changelog.jsonindex bf1ba08b3..afd935e28 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,26 @@{"$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": "A failed X seed no longer costs you six hours, and can no longer wipe a good one",+ "summary": "Seeding an agent from your X posts is allowed once every six hours per agent, and until now that window was spent the moment we started reading, whatever happened next. If X was throttling us, if X had stopped accepting the connection, or if your sign-in could not be renewed, you got a bare failure and a six-hour lockout for something that was never yours to fix. Every one of those now hands the window straight back and says what actually happened: reconnect X, or wait the number of minutes X itself told us to wait. Worse was the run that read your account fine and found nothing usable in it, which is what a timeline of only replies and reposts looks like. That run deleted the batch of facts your agent already had and put nothing in its place. It now stops before the deletion, keeps the memories you had, gives the window back, and tells you what to post or add to your profile so the next seed has something to work with. Nothing else about the lane changes: nothing is read until you consent on a screen that lists what is read and stored, and revoking still deletes every memory the seeding produced.",+ "tags": [+ "fix"+ ],+ "link": "/settings"+ },+ {+ "date": "2026-08-17",+ "title": "The avatar SDK bundle we ship is now built from the code we deploy",+ "summary": "The <agent-3d> runtime that sites load from three.ws is a single bundled file, and the production build never rebuilt it. It was copied from whatever the build machine happened to have on disk, which could be days older than the code being deployed, so a fix to the avatar element could ship everywhere else on the site and quietly not reach the SDK. The deploy now rebuilds that bundle from the same commit as the rest of the release, every time. Nothing to change on your side: existing embeds keep working and simply pick up the current runtime.",+ "tags": [+ "fix",+ "sdk",+ "infra"+ ],+ "link": "/avatar-sdk"+ },{"date": "2026-08-17","title": "Chat stops hiding two nav links, and says something useful when a reply fails",diff --git a/data/pages.json b/data/pages.jsonindex 58a39ce7c..cb0e76f65 100644--- a/data/pages.json+++ b/data/pages.json@@ -66,7 +66,7 @@{"path": "/character-library","title": "Character Library",- "description": "106 professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer in one click.",+ "description": "Professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer.","priority": 0.8,"changefreq": "weekly","added": "2026-07-19",diff --git a/docs/x-memory-seeding.md b/docs/x-memory-seeding.mdindex cc669b6a0..fcde4870c 100644--- a/docs/x-memory-seeding.md+++ b/docs/x-memory-seeding.md@@ -228,6 +228,35 @@ distilled posts behind on an agent you forgot about.| `consent_required` | 403 | No live grant; the response carries the disclosure to show || `account_mismatch` | 409 | The consent was granted for a different X account || rate limited | 429 | One seed per agent per 6 hours |+| `x_token_expired` | 502 | The stored access token would not refresh; reconnect X |+| `x_read_denied` | 502 | X answered the read with 401/403, so the connection was revoked or narrowed on X's side |+| `x_rate_limited` | 503 | X is throttling us; `retry_at` carries X's own reset time when it sent one |+| `x_unavailable` | 502 | X answered with something else; `x_status` carries what |+| `seed_empty` | 502 | Nothing usable came back, so nothing was written and the previous batch was left alone |++### A run that stores nothing costs no window++The six-hour budget is charged once a request is authorized, connected and+consented, immediately before the first read. Every exit after that point which+writes no rows (the five codes above, plus `account_mismatch`) hands the window+straight back, and the response says which happened:++```json+{+ "error": "x_rate_limited",+ "error_description": "X is rate limiting us and returned no posts. X should accept the read again in about 9 minutes. Your memories are unchanged and this attempt did not use up your six-hour window, so you can seed again as soon as it is fixed",+ "x_status": 429,+ "retry_at": "2026-08-17T02:49:00.000Z",+ "window_refunded": true+}+```++`window_refunded` is `false` only when the refund itself could not be recorded+(a Redis outage); the wording drops the "did not use up" clause to match. Two+guarantees hold on all of these paths: the agent's existing memories are+untouched, and no partial batch is ever written. In particular a re-seed that+yields no usable fact returns `seed_empty` rather than deleting a good batch and+replacing it with nothing.## Enabling it on a deploymentdiff --git a/public/changelog.json b/public/changelog.jsonindex 69f296827..b5d7aa948 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-17T02:26:07.798Z",+ "generated_at": "2026-08-17T02:41:59.362Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -16,6 +16,16 @@"launch"]},+ {+ "date": "2026-08-17",+ "type": "update",+ "title": "A failed X seed no longer costs you six hours, and can no longer wipe a good one",+ "summary": "Seeding an agent from your X posts is allowed once every six hours per agent, and until now that window was spent the moment we started reading, whatever happened next. If X was throttling us, if X had stopped accepting the connection, or if your sign-in could not be renewed, you got a bare failure and a six-hour lockout for something that was never yours to fix. Every one of those now hands the window straight back and says what actually happened: reconnect X, or wait the number of minutes X itself told us to wait. Worse was the run that read your account fine and found nothing usable in it, which is what a timeline of only replies and reposts looks like. That run deleted the batch of facts your agent already had and put nothing in its place. It now stops before the deletion, keeps the memories you had, gives the window back, and tells you what to post or add to your profile so the next seed has something to work with. Nothing else about the lane changes: nothing is read until you consent on a screen that lists what is read and stored, and revoking still deletes every memory the seeding produced.",+ "link": "/settings",+ "tags": [+ "fix"+ ]+ },{"date": "2026-08-17","type": "update",@@ -103,6 +113,18 @@"improvement"]},+ {+ "date": "2026-08-17",+ "type": "update",+ "title": "The avatar SDK bundle we ship is now built from the code we deploy",+ "summary": "The <agent-3d> runtime that sites load from three.ws is a single bundled file, and the production build never rebuilt it. It was copied from whatever the build machine happened to have on disk, which could be days older than the code being deployed, so a fix to the avatar element could ship everywhere else on the site and quietly not reach the SDK. The deploy now rebuilds that bundle from the same commit as the rest of the release, every time. Nothing to change on your side: existing embeds keep working and simply pick up the current runtime.",+ "link": "/avatar-sdk",+ "tags": [+ "fix",+ "sdk",+ "infra"+ ]+ },{"date": "2026-08-17","type": "update",@@ -11661,7 +11683,7 @@"date": "2026-07-19","type": "launch","title": "Character Library",- "summary": "106 professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer in one click.",+ "summary": "Professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer.","link": "/character-library","tags": ["launch"diff --git a/public/changelog.xml b/public/changelog.xmlindex 3a8e05679..37d987459 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -14,6 +14,14 @@<category>launch</category><description>The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.</description></item>+ <item>+ <title>A failed X seed no longer costs you six hours, and can no longer wipe a good one</title>+ <link>https://three.ws/settings</link>+ <guid isPermaLink="false">2026-08-17:A failed X seed no longer costs you six hours, and can no longer wipe a good one</guid>+ <pubDate>Mon, 17 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>Seeding an agent from your X posts is allowed once every six hours per agent, and until now that window was spent the moment we started reading, whatever happened next. If X was throttling us, if X had stopped accepting the connection, or if your sign-in could not be renewed, you got a bare failure and a six-hour lockout for something that was never yours to fix. Every one of those now hands the window straight back and says what actually happened: reconnect X, or wait the number of minutes X itself told us to wait. Worse was the run that read your account fine and found nothing usable in it, which is what a timeline of only replies and reposts looks like. That run deleted the batch of facts your agent already had and put nothing in its place. It now stops before the deletion, keeps the memories you had, gives the window back, and tells you what to post or add to your profile so the next seed has something to work with. Nothing else about the lane changes: nothing is read until you consent on a screen that lists what is read and stored, and revoking still deletes every memory the seeding produced.</description>+ </item><item><title>A shared ASL letter link now opens on that letter, not on A</title><link>https://three.ws/asl-alphabet</link>@@ -78,6 +86,14 @@<category>fix</category><description>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.</description></item>+ <item>+ <title>The avatar SDK bundle we ship is now built from the code we deploy</title>+ <link>https://three.ws/avatar-sdk</link>+ <guid isPermaLink="false">2026-08-17:The avatar SDK bundle we ship is now built from the code we deploy</guid>+ <pubDate>Mon, 17 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>The <agent-3d> runtime that sites load from three.ws is a single bundled file, and the production build never rebuilt it. It was copied from whatever the build machine happened to have on disk, which could be days older than the code being deployed, so a fix to the avatar element could ship everywhere else on the site and quietly not reach the SDK. The deploy now rebuilds that bundle from the same commit as the rest of the release, every time. Nothing to change on your side: existing embeds keep working and simply pick up the current runtime.</description>+ </item><item><title>The Characters gallery pages past the first screen, and stops fighting dark mode</title><link>https://three.ws/characters</link>@@ -8780,7 +8796,7 @@<guid isPermaLink="false">2026-07-19:Character Library</guid><pubDate>Sun, 19 Jul 2026 12:00:00 GMT</pubDate><category>launch</category>- <description>106 professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer in one click.</description>+ <description>Professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer.</description></item><item><title>Daily Match</title>diff --git a/public/features.json b/public/features.jsonindex c8e663143..7741ab85f 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-17T02:26:07.777Z",+ "generated_at": "2026-08-17T02:41:59.288Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -78,7 +78,7 @@{"path": "/character-library","title": "Character Library",- "description": "106 professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer in one click.",+ "description": "Professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer.","added": "2026-07-19","auth": null,"indexable": true,diff --git a/public/llms-full.txt b/public/llms-full.txtindex 675f670ff..fde761460 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -53,7 +53,7 @@ Compose agent gestures into a timed routine on a real timeline, preview the wholURL: https://three.ws/character-library-106 professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer in one click.+Professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer.### Sign Language Avatarsdiff --git a/public/llms.txt b/public/llms.txtindex 16877cd84..e4682950b 100644--- a/public/llms.txt+++ b/public/llms.txt@@ -36,7 +36,7 @@ Entry points into the product.- [Animation Gallery](https://three.ws/animations): Browse and preview public animations authored by the three.ws community. Apply any clip to your avatar in the Animation Studio.- [Agent Gestures](https://three.ws/gestures): The three.ws agent gesture vocabulary: every animation slot, the clip it plays, the skills that trigger it, and a builder for overriding any slot on your own agent. Previewed live on a real avatar.- [Choreographer](https://three.ws/choreograph): Compose agent gestures into a timed routine on a real timeline, preview the whole performance on a live 3D avatar, then save it to your agent and play it by name from any embed.-- [Character Library](https://three.ws/character-library): 106 professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer in one click.+- [Character Library](https://three.ws/character-library): Professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer.- [Sign Language Avatars](https://three.ws/sign-language): three.ws avatars sign in American Sign Language: fingerspell any word or number, get signed chat replies, and sign back with your webcam. The whole loop, live in 3D.- [ASL Alphabet](https://three.ws/asl-alphabet): The American manual alphabet on a live 3D avatar: every letter and number, what to look for, the look-alikes it is confused with, spell any word, and a drill for reading fingerspelling.- [Sign Mirror](https://three.ws/sign-mirror): Learn the ASL alphabet by making it: the avatar forms the letter, your camera watches your hand, and the page grades the handshape live, naming the finger that is off. Fully on-device; no video ever uploaded.diff --git a/public/locales/en.json b/public/locales/en.jsonindex 9e2bb00df..0156f3055 100644--- a/public/locales/en.json+++ b/public/locales/en.json@@ -2366,8 +2366,7 @@"meta_title": "Character — three.ws"},"character_library": {- "106_rigged_characters_ready_to_animate": "106 rigged characters, ready to animate",- "a_curated_library_of_professionally_rigged_h": "A curated library of professionally rigged humanoid characters. Every one ships with a skeleton and skin weights, so it drives the full three.ws animation library out of the box — idle, walk, run, wave, dance. Preview any character live, send it to the Animation Studio, or drop it straight into the Widget Studio.",+ "a_curated_library_of_professionally_rigged_h": "A curated library of professionally rigged humanoid characters. Every one ships with a skeleton and skin weights, so it drives the full three.ws animation library out of the box: idle, walk, run, wave, dance. Preview any character live, send it to the Animation Studio, or drop it straight into the Widget Studio.","a_z": "A → Z","avatar_gallery": "Avatar Gallery","browse_the_animation_library": "Browse the animation library",@@ -2377,14 +2376,15 @@"couldn_t_load_characters": "Couldn't load characters","generate_a_character": "Generate a character","largest_first": "Largest first",- "meta_description": "106 professionally rigged 3D characters, free to use on three.ws. Every one drives the full animation library — idle, walk, run, wave, dance. Preview, animate, or drop into the Widget Studio in one click.",- "meta_og_description": "106 rigged 3D characters, ready to animate. Preview, animate, or use in the Studio.",+ "meta_description": "Professionally rigged 3D characters, free to use on three.ws. Every one drives the full animation library: idle, walk, run, wave, dance. Preview, animate, or drop into the Widget Studio in one click.",+ "meta_og_description": "Rigged 3D characters, ready to animate. Preview, animate, or use in the Studio.","meta_og_title": "Character Library · three.ws","meta_title": "Character Library · three.ws",- "meta_twitter_description": "106 rigged 3D characters, ready to animate.",+ "meta_twitter_description": "Rigged 3D characters, ready to animate.","meta_twitter_title": "Character Library · three.ws","no_characters_match_your_search": "No characters match your search.","no_matches": "No matches",+ "rigged_characters_ready_to_animate": "Rigged characters, ready to animate","smallest_first": "Smallest first","something_went_wrong_loading_the_character_l": "Something went wrong loading the character library.","the_rigged_character_library_is_being_staged": "The rigged character library is being staged. Check back in a moment, or generate your own from a text prompt.",@@ -17572,7 +17572,7 @@"ca_x402_ca2x402_paste_any_token_contract": "<a href=\"/ca2x402\"> <span class=\"sm-title\">CA → x402</span> <span class=\"sm-path\">/ca2x402</span> <span class=\"sm-desc\">Paste any token contract address and get a live, agent-payable x402 endpoint for its market intel — price, momentum, and a bullish/bearish signal — for $0.01 USDC, discoverable in the x402 bazaar.</span> </a>","capabilities_alpha_hunt_launcher_auto_claim": "<a href=\"/dashboard/capabilities\"> <span class=\"sm-title\">Capabilities — Alpha Hunt, Launcher, Auto-Claim & Market Maker</span> <span class=\"sm-path\">/dashboard/capabilities</span> <span class=\"sm-desc\">Live command center for all 4 autonomous agent capabilities: Alpha Hunt smart-money scoring, autonomous Coin Launcher on schedule, Creator Auto-Claim for fee harvesting, and Market Maker with Jito execution.</span> </a>","changelog_changelog_what_is_new_on_three": "<a href=\"/changelog\"> <span class=\"sm-title\">Changelog</span> <span class=\"sm-path\">/changelog</span> <span class=\"sm-desc\">What is new on three.ws: features, improvements, and releases, newest first.</span> </a>",- "character_library_character_library_106_prof": "<a href=\"/character-library\"> <span class=\"sm-title\">Character Library</span> <span class=\"sm-path\">/character-library</span> <span class=\"sm-desc\">106 professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer in one click.</span> </a>",+ "character_library_character_library_106_prof": "<a href=\"/character-library\"> <span class=\"sm-title\">Character Library</span> <span class=\"sm-path\">/character-library</span> <span class=\"sm-desc\">Professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer.</span> </a>","characters_characters_discover_ai_characters": "<a href=\"/characters\"> <span class=\"sm-title\">Characters</span> <span class=\"sm-path\">/characters</span> <span class=\"sm-desc\">Discover AI characters on three.ws. Chat, trade, and create.</span> </a>","chat_chat_talk_to_your_agent_voice": "<a href=\"/chat\"> <span class=\"sm-title\">Chat</span> <span class=\"sm-path\">/chat</span> <span class=\"sm-desc\">Talk to your agent. Voice, text, and tool-use in one interface.</span> </a>","check_out_our_pulsemcp_page_three_ws": "<a href=\"/news/2052791935585407403\"> <span class=\"sm-title\">Check out our @PulseMCP page — three.ws is listed in the official MCP server directory.</span> <span class=\"sm-path\">/news/2052791935585407403</span> <span class=\"sm-desc\">Check out our @PulseMCP page — three.ws is listed in the official MCP server directory. pulsemcp.com — the leading community hub for the MCP ecosystem. three.ws gives Claude and any MCP client the ability to spawn 3D agents, mint on-chain identity, and attach x402 payment endp…</span> </a>",diff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex a13fb2e26..ee6b733df 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -242,7 +242,7 @@<a href="/character-library"><span class="sm-title">Character Library</span><span class="sm-path">/character-library</span>- <span class="sm-desc">106 professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer in one click.</span>+ <span class="sm-desc">Professionally rigged 3D characters, free to use. Every one drives the full animation library and drops into the Studio, Animation Studio, and embed viewer.</span></a></li><li>