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(changelog): record the npm republish and the docs header fix
nirholaseead93937537
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 4458f28c1..06d6a23ce 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -9,9 +9,11 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Deploy On-chain** (`/deploy-onchain`): Mint your agent into the Metaplex Agent Registry on Solana, in the exact shape the Genesis 333 shipped: a Metaplex Core asset with its own wallet, EIP-8004 identity, verified creator, royalties, and immutable metadata. Phantom, Solflare, or any Solana wallet signs; keys never leave the browser, and devnet rehearsal is free.- **A page that fails to load now tells you which thing went wrong**: When an avatar or agent page could not load, it always said the same thing: not found, followed by whatever internal message the browser happened to throw. A stale link and a temporary server hiccup looked identical, and the explanation was often developer jargon rather than English. The two cases are now told apart. A link to something that no longer exists says exactly that and points you at the marketplace or the agent directory. A genuine failure on our side says so, offers a Try again button, and keeps the technical detail as a small footnote instead of presenting it as the reason. `[improvement, fix]`- **Agent pages show what an agent can actually do, and what it charges**: The studio page every agent link opens now carries the agent's real substance. Its Capabilities tab lists the skills it genuinely exposes with the real per-call price of each, and a summary line telling you the cheapest paid call up front (or that everything is free). Skill names read as words instead of raw slugs, with the exact slug shown underneath for anyone wiring an integration. Under the title there is now a row of real counters: skills, conversations, wallet, whether the identity is on-chain, and how long the agent has been around. Below the fold, an agent recommends similar agents rather than unrelated avatars, each rendered as a live 3D card. The page also loads better: a skeleton in the real layout instead of a line of text, cards that show a picture while their 3D model downloads, and full keyboard support on the section tabs with a shareable link per tab. (`/agents`) `[improvement, feature]`+- **Every three.ws package on npm is current again**: Our npm packages had drifted a long way behind the code: 73 of them, including the main SDK, the React components, the avatar and walk SDKs and most of the MCP servers, were sitting on npm at an older version than what we had actually built. Anyone installing from npm got stale code. All 73 are now published at their current version, and four packages that had never been released at all (the agent runtime, the sign language pack, the spatial MCP server and the VS Code extension) are on npm for the first time. The cause was our release script working from a hand written list, so any package added after that list was written was silently never published; it now discovers packages itself, so a new one cannot be forgotten again. `[sdk, fix]`- **Phone fixes: helper widgets no longer sit on top of the controls**: On a phone the floating language control and the Getting started pill landed directly on the page's own bottom controls: the language picker rendered inside the "Ask the agent" box and the pill covered the save row. Helper widgets now measure a page's bottom bar and float above it, and the language control shows a compact code (EN) instead of a full-width bar. Gallery cards show all three actions in full, so Animate is no longer clipped mid-word. In the AR Studio, the Add models sheet keeps its tabs at full height on short screens, and each model is labelled with a readable name instead of the whole generation prompt. On the viewer page a long email no longer pushes the account button off the edge of the screen. (`/gallery`) `[fix, improvement]`- **Put any agent on-chain from your AI assistant: the Metaplex Agent Registry MCP server**: A new npm package, @three-ws/metaplex-agent-mcp, lets any AI assistant deploy an agent on-chain on Solana the exact way the three.ws Genesis 333 shipped: it mints a Metaplex Core asset and registers its EIP-8004 agent identity, so the agent appears on metaplex.com/agents with its own built-in wallet. Agents can sign with their own key, and people can sign with Phantom, Solflare, or any Solana wallet, with a preview-first confirm step before anything is spent. Every royalty, creator, plugin, and metadata field is customizable, and devnet rehearsal is free. (`/deployments`) `[sdk, feature]`- **Shared avatar links now unfurl with the avatar itself, and profile views finally count**: Paste an avatar link into X, Discord, Telegram, or Slack and the preview now shows that avatar's rendered image, name, and description instead of the generic site card. The profile page also reports a view each time someone opens it, so the view counts that rank search and explore results reflect real traffic at last. Discover cards for agents without a coin no longer point at a dead address, and the sitemap hands search engines the current agent page URLs directly. `[improvement, fix]`+- **The docs header no longer cuts links off on a phone**: On a narrow phone screen the docs header packed five site links beside the logo, so the last ones ran off the right edge: Discover showed as a lone D and Launch app was gone entirely, with no way to scroll to them. The header now keeps the logo, the 3D world button and Studio, and moves Widgets, Discover and Launch app into the navigation drawer, right under the docs search, where they are reachable with a thumb. Nothing was removed: the full header returns on wider screens. (`/docs`) `[fix]`## 2026-08-18diff --git a/data/changelog.json b/data/changelog.jsonindex 41cb4edd3..99d866502 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,24 @@{"$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-19",+ "title": "Every three.ws package on npm is current again",+ "summary": "Our npm packages had drifted a long way behind the code: 73 of them, including the main SDK, the React components, the avatar and walk SDKs and most of the MCP servers, were sitting on npm at an older version than what we had actually built. Anyone installing from npm got stale code. All 73 are now published at their current version, and four packages that had never been released at all (the agent runtime, the sign language pack, the spatial MCP server and the VS Code extension) are on npm for the first time. The cause was our release script working from a hand written list, so any package added after that list was written was silently never published; it now discovers packages itself, so a new one cannot be forgotten again.",+ "tags": [+ "sdk",+ "fix"+ ]+ },+ {+ "date": "2026-08-19",+ "title": "The docs header no longer cuts links off on a phone",+ "summary": "On a narrow phone screen the docs header packed five site links beside the logo, so the last ones ran off the right edge: Discover showed as a lone D and Launch app was gone entirely, with no way to scroll to them. The header now keeps the logo, the 3D world button and Studio, and moves Widgets, Discover and Launch app into the navigation drawer, right under the docs search, where they are reachable with a thumb. Nothing was removed: the full header returns on wider screens.",+ "tags": [+ "fix"+ ],+ "link": "/docs"+ },{"date": "2026-08-19","title": "A page that fails to load now tells you which thing went wrong",diff --git a/docs/index.html b/docs/index.htmlindex 296612f92..4fa02bdac 100644--- a/docs/index.html+++ b/docs/index.html@@ -193,11 +193,10 @@.docs-header-right .docs-header-more {display: none;}- .sidebar-site {- display: block;- }}- @media (max-width: 400px) {+ /* Last resort for the narrowest devices (Fold-class outer screens):+ drop the "Docs" label rather than let the logo and the nav collide. */+ @media (max-width: 340px) {.docs-header-sep,.docs-header-label {display: none;@@ -438,12 +437,39 @@}/* The site links the header drops on narrow screens. Hidden wherever- the header still shows them. */+ the header still shows them. Chips rather than four more rows,+ because they sit above a list of 200+ doc links and must not push+ the docs themselves off the first screen. */.sidebar-site {display: none;- margin-top: var(--space-md);- padding-top: var(--space-md);- border-top: 1px solid var(--border);+ flex-wrap: wrap;+ gap: 6px;+ margin: 0 var(--space-sm) var(--space-md);+ padding-bottom: var(--space-md);+ border-bottom: 1px solid var(--border);+ }+ .sidebar-site a {+ display: inline-flex;+ align-items: center;+ min-height: 44px;+ padding: 4px 10px;+ font-size: var(--text-sm);+ color: rgba(255, 255, 255, 0.62);+ text-decoration: none;+ border: 1px solid var(--border);+ border-radius: var(--radius-md);+ background: rgba(255, 255, 255, 0.03);+ transition: color 0.15s, background 0.15s, border-color 0.15s;+ }+ .sidebar-site a:hover,+ .sidebar-site a:focus-visible {+ color: #fff;+ background: rgba(255, 255, 255, 0.07);+ }+ @media (max-width: 760px) {+ .sidebar-site {+ display: flex;+ }}/* ── Main ────────────────────────────────────── */@@ -998,7 +1024,7 @@<span class="docs-header-sep"></span><span class="docs-header-label">Docs</span><nav class="docs-header-right">- <a href="/docs/world" class="docs-world-link" id="world-link" title="Read these docs inside a walkable 3D world">+ <a href="/docs/world" class="docs-world-link" id="world-link" aria-label="3D world" title="Read these docs inside a walkable 3D world"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><circle cx="12" cy="12" r="9"/><ellipse cx="12" cy="12" rx="9" ry="3.6"/><path d="M12 3v18"/></svg><span>3D world</span></a>@@ -1044,14 +1070,12 @@aria-label="Documentation content matches"hidden></div>- <nav id="sidebar-nav"></nav>- <nav class="sidebar-site" aria-label="three.ws">- <span class="sidebar-section-title">three.ws</span>- <a class="sidebar-link" href="/widgets">Widgets</a>- <a class="sidebar-link" href="/discover">Discover</a>- <a class="sidebar-link" href="/app">Launch app</a>- <a class="sidebar-link" href="/studio">Studio</a>+ <nav class="sidebar-site" aria-label="three.ws site">+ <a href="/widgets">Widgets</a>+ <a href="/discover">Discover</a>+ <a href="/app">Launch app</a></nav>+ <nav id="sidebar-nav"></nav></aside><main class="docs-main">diff --git a/public/changelog.json b/public/changelog.jsonindex 8391ee8f7..dad2b16e1 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-19T01:50:37.339Z",+ "generated_at": "2026-08-19T03:49:12.341Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -38,6 +38,17 @@"feature"]},+ {+ "date": "2026-08-19",+ "type": "update",+ "title": "Every three.ws package on npm is current again",+ "summary": "Our npm packages had drifted a long way behind the code: 73 of them, including the main SDK, the React components, the avatar and walk SDKs and most of the MCP servers, were sitting on npm at an older version than what we had actually built. Anyone installing from npm got stale code. All 73 are now published at their current version, and four packages that had never been released at all (the agent runtime, the sign language pack, the spatial MCP server and the VS Code extension) are on npm for the first time. The cause was our release script working from a hand written list, so any package added after that list was written was silently never published; it now discovers packages itself, so a new one cannot be forgotten again.",+ "link": null,+ "tags": [+ "sdk",+ "fix"+ ]+ },{"date": "2026-08-19","type": "update",@@ -71,6 +82,16 @@"fix"]},+ {+ "date": "2026-08-19",+ "type": "update",+ "title": "The docs header no longer cuts links off on a phone",+ "summary": "On a narrow phone screen the docs header packed five site links beside the logo, so the last ones ran off the right edge: Discover showed as a lone D and Launch app was gone entirely, with no way to scroll to them. The header now keeps the logo, the 3D world button and Studio, and moves Widgets, Discover and Launch app into the navigation drawer, right under the docs search, where they are reachable with a thumb. Nothing was removed: the full header returns on wider screens.",+ "link": "/docs",+ "tags": [+ "fix"+ ]+ },{"date": "2026-08-18","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex 7c14600e2..ab8717f1f 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -30,6 +30,14 @@<category>improvement</category><description>The studio page every agent link opens now carries the agent's real substance. Its Capabilities tab lists the skills it genuinely exposes with the real per-call price of each, and a summary line telling you the cheapest paid call up front (or that everything is free). Skill names read as words instead of raw slugs, with the exact slug shown underneath for anyone wiring an integration. Under the title there is now a row of real counters: skills, conversations, wallet, whether the identity is on-chain, and how long the agent has been around. Below the fold, an agent recommends similar agents rather than unrelated avatars, each rendered as a live 3D card. The page also loads better: a skeleton in the real layout instead of a line of text, cards that show a picture while their 3D model downloads, and full keyboard support on the section tabs with a shareable link per tab.</description></item>+ <item>+ <title>Every three.ws package on npm is current again</title>+ <link>https://three.ws/changelog</link>+ <guid isPermaLink="false">2026-08-19:Every three.ws package on npm is current again</guid>+ <pubDate>Wed, 19 Aug 2026 12:00:00 GMT</pubDate>+ <category>sdk</category>+ <description>Our npm packages had drifted a long way behind the code: 73 of them, including the main SDK, the React components, the avatar and walk SDKs and most of the MCP servers, were sitting on npm at an older version than what we had actually built. Anyone installing from npm got stale code. All 73 are now published at their current version, and four packages that had never been released at all (the agent runtime, the sign language pack, the spatial MCP server and the VS Code extension) are on npm for the first time. The cause was our release script working from a hand written list, so any package added after that list was written was silently never published; it now discovers packages itself, so a new one cannot be forgotten again.</description>+ </item><item><title>Phone fixes: helper widgets no longer sit on top of the controls</title><link>https://three.ws/gallery</link>@@ -54,6 +62,14 @@<category>improvement</category><description>Paste an avatar link into X, Discord, Telegram, or Slack and the preview now shows that avatar's rendered image, name, and description instead of the generic site card. The profile page also reports a view each time someone opens it, so the view counts that rank search and explore results reflect real traffic at last. Discover cards for agents without a coin no longer point at a dead address, and the sitemap hands search engines the current agent page URLs directly.</description></item>+ <item>+ <title>The docs header no longer cuts links off on a phone</title>+ <link>https://three.ws/docs</link>+ <guid isPermaLink="false">2026-08-19:The docs header no longer cuts links off on a phone</guid>+ <pubDate>Wed, 19 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>On a narrow phone screen the docs header packed five site links beside the logo, so the last ones ran off the right edge: Discover showed as a lone D and Launch app was gone entirely, with no way to scroll to them. The header now keeps the logo, the 3D world button and Studio, and moves Widgets, Discover and Launch app into the navigation drawer, right under the docs search, where they are reachable with a thumb. Nothing was removed: the full header returns on wider screens.</description>+ </item><item><title>Agents and avatars now open in the same studio page</title><link>https://three.ws/agents</link>diff --git a/public/features.json b/public/features.jsonindex 4755fa2a7..1d0144896 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-19T01:50:37.319Z",+ "generated_at": "2026-08-19T03:49:12.324Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",