Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
fix(theme-switcher): re-probe the light palette synchronously when a stylesheet lands
nirholas39047221e53e
diff --git a/.gitignore b/.gitignoreindex 220e17ec7..da91301e0 100644--- a/.gitignore+++ b/.gitignore@@ -137,9 +137,6 @@ threews-launch-week-case-study.html.tmp-*scripts/tmp-*scripts/scratch-*--# Scratch server bootstraps written during an audit session (absolute local paths)-.scratch-audit/# Dot-prefixed harnesses under scripts/ are the same thing wearing a hidden# name, and the hidden name is why they slipped the net: nine of them# (.dw-*, .a11y-*, .verify-chat-tmp) had accumulated in the tree bydiff --git a/.scratch-audit/boot.mjs b/.scratch-audit/boot.mjsnew file mode 100644index 000000000..cec0dc809--- /dev/null+++ b/.scratch-audit/boot.mjs@@ -0,0 +1,4 @@+import { config } from 'dotenv';+config({ path: '/workspaces/three.ws/.env' });+config({ path: '/workspaces/three.ws/.env.local' });+await import('/workspaces/three.ws/server/index.mjs');diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 6b920e30a..af5d6a2a4 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -4,11 +4,6 @@Public history for [three.ws](https://three.ws), newest first. New pages come from `added` dates in data/pages.json; everything else is curated in data/changelog.json. Also available as [JSON](https://three.ws/changelog.json) and [RSS](https://three.ws/changelog.xml), live at [three.ws/changelog](https://three.ws/changelog).-## 2026-09-02--- **Every showcased agent now has its own page**: Agent Spotlight entries got somewhere to live. Each one now has its own page with the agent standing in 3D, the full write-up instead of three clamped lines, a facts panel read live off the agent (skills, conversations, on-chain actions, upvotes), share buttons, and a rail of related entries in the same category. Sharing one finally works too: paste a link anywhere and it unfurls with that entry's headline and the agent's own card rather than the generic showcase image. If you submitted an entry, you can now edit or remove it, which you could not do before: an Edit link on your card opens the write-up ready to change, and removing takes two clicks so it cannot happen by accident. Ranking got fairer as well, with a stable order for entries published at the same moment instead of a shuffle between page loads. (`/spotlight`) `[improvement, feature]`-- **Examples gains a voice, an AI's eye on 3D, and a filter**: Three more runnable examples and a way to find them. The avatar can now speak a line you type: the free text-to-speech lane synthesizes it and a new speakAudio() method routes the audio through the same analyser the built-in voice uses, so the mouth follows the real waveform instead of miming. A second example calls the look_at_model tool on the public MCP server and shows exactly what an AI assistant sees when it inspects a mesh: four rendered angles plus a plain-language read on the geometry, which is how an agent judges its own output and decides to try again. A third reads the live tool list off that same server, so the page can never advertise a tool that was renamed or dropped. With seventeen examples the page also gets a filter: type to search names, descriptions and tags, or narrow by tag, and the lanes fold away as they empty. A deep link always wins over an active filter. (`/examples`) `[feature, improvement, sdk]`-## 2026-09-01- **3D Drops** (`/drops`): Launch a supply-capped collection of AI-forged 3D characters. Pick a style, define weighted trait layers, and three.ws rolls the whole supply from a published seed: verifiable rarity, rigged animation-ready art, forged on reveal.diff --git a/STRUCTURE.md b/STRUCTURE.mdindex b6a5d1f9f..ddc630681 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -44,7 +44,7 @@ bottom.| Model detail page (`/m/:id`) | [pages/model.html](pages/model.html) `→ /m/:id`, page module [src/model-page.js](src/model-page.js) + pure helpers [src/model-lib.js](src/model-lib.js) + [src/model.css](src/model.css), backend [api/forge-creation.js](api/forge-creation.js) (`?related=&view=` + voted state; `DELETE`, scoped to the owning `x-forge-client`, lets a creator erase a creation, its stored GLB, preview, and recorded source uploads included) and [api/forge-comments.js](api/forge-comments.js), store reads [api/_lib/forge-store.js](api/_lib/forge-store.js) (`getPublicCreation`/`listRelated`/`recordCreationView`), schema [api/_lib/migrations/20260805120000_model_page.sql](api/_lib/migrations/20260805120000_model_page.sql) | Live | Every finished forge model as a first-class page in the classic model-platform detail layout: interactive viewer hero with AR and fullscreen, title + creator card with a real follow button (follow graph), live triangle/vertex stats from `GET /api/3d/inspect` (nothing persisted, nothing invented), the full prompt as the description, honest attribute chips, anonymous likes shared with the Forge-Off vote rail (`forge_votes`, same `forge:cid` id), a real page-view counter (`forge_creations.view_count`), a signed-in comment thread (`forge_comments`, bell-notifies the creator via the `comment` event type), paid remix via the existing x402 rail, embed/share/download, and a same-category suggested-models rail. Linked from the Details button on `/creations` cards and the Forge showcase. Tests: [tests/model-lib.test.js](tests/model-lib.test.js) || Labs (hidden-gems hub) | [pages/labs.html](pages/labs.html) + [src/labs.js](src/labs.js) `→ /labs` | In-repo | Data-driven discovery hub: renders every `data/pages.json` entry flagged `showcase: true` as a live card (status check + iframe preview), filterable by category || Holo Sticker (procedural foil demo) | [pages/holo.html](pages/holo.html) `→ /holo`, app [src/holo.js](src/holo.js), styles [src/holo.css](src/holo.css) | Live | A real-time holographic foil sticker rendered with physical materials, fully procedural (no assets fetched): tilt it with the pointer, peel the corner (vertex-shader cylinder roll), switch foil styles, die-cut arbitrary typed text via a marching-squares vectorizer, and download the frame as a PNG |-| Examples gallery | [pages/examples.html](pages/examples.html) `→ /examples`, curated snippets [public/examples.js](public/examples.js), generated index renderer [public/examples-index.js](public/examples-index.js), styles [public/examples.css](public/examples.css), hosted example tree [public/examples/](public/examples) built by [scripts/build-hosted-examples.mjs](scripts/build-hosted-examples.mjs) | Live | Two halves. The top is 17 copy-paste snippets that RUN on the page, grouped into four lanes (avatars and embeds, 3D models, agents, agent economy) behind a sticky jump nav and a text/tag filter that folds away lanes as they empty (a deep link always beats an active filter): each is a complete document loading the production CDN bundle into an iframe, so "Run" executes exactly the code shown, and the model/agent/economy lanes call the live CORS-open production APIs rather than illustrating them (free text→3D at `/api/v1/ai/text-to-3d`, free text→speech at `/api/v1/ai/tts` played through the new `speakAudio()` viseme path, `/api/3d/inspect`, the 112-clip `/animations/manifest.json`, `/api/forged`, the public no-auth MCP server at `/api/mcp-studio` for both `tools/list` and a live `look_at_model` render-and-critique, the 402 quote from `/api/x402/forge`, `/api/pump/launches`). The `agent-from-files` card loads a real manifest from `/examples/coach-leo/manifest.json`: `npm run build:examples` publishes [examples/coach-leo/](examples/coach-leo) and its wave skill into `public/examples/` with body/image URIs rewritten absolute, so the manifest resolves the same way off-site as it does here. The bottom is every example that ships in the repo, generated by [scripts/build-examples-index.mjs](scripts/build-examples-index.mjs) scanning every `examples/` directory into [data/examples.json](data/examples.json), mirrored to the served [public/examples.json](public/examples.json) by [scripts/mirror-examples-index.mjs](scripts/mirror-examples-index.mjs) (`npm run build:examples` runs all three). Because it is scanned, the page cannot advertise a deleted example or miss an added one; each card carries the files it contains and the command that runs it. Tests: [tests/examples-page.test.js](tests/examples-page.test.js), [tests/examples-index.test.js](tests/examples-index.test.js) |+| Examples gallery | [pages/examples.html](pages/examples.html) `→ /examples`, curated snippets [public/examples.js](public/examples.js), generated index renderer [public/examples-index.js](public/examples-index.js), styles [public/examples.css](public/examples.css), hosted example tree [public/examples/](public/examples) built by [scripts/build-hosted-examples.mjs](scripts/build-hosted-examples.mjs) | Live | Two halves. The top is 14 copy-paste snippets that RUN on the page, grouped into four lanes (avatars and embeds, 3D models, agents, agent economy) behind a sticky jump nav: each is a complete document loading the production CDN bundle into an iframe, so "Run" executes exactly the code shown, and the model/agent/economy lanes call the live CORS-open production APIs rather than illustrating them (free text→3D at `/api/v1/ai/text-to-3d`, `/api/3d/inspect`, the 112-clip `/animations/manifest.json`, `/api/forged`, the 402 quote from `/api/x402/forge`, `/api/pump/launches`). The `agent-from-files` card loads a real manifest from `/examples/coach-leo/manifest.json`: `npm run build:examples` publishes [examples/coach-leo/](examples/coach-leo) and its wave skill into `public/examples/` with body/image URIs rewritten absolute, so the manifest resolves the same way off-site as it does here. The bottom is every example that ships in the repo, generated by [scripts/build-examples-index.mjs](scripts/build-examples-index.mjs) scanning every `examples/` directory into [data/examples.json](data/examples.json), mirrored to the served [public/examples.json](public/examples.json) by [scripts/mirror-examples-index.mjs](scripts/mirror-examples-index.mjs) (`npm run build:examples` runs all three). Because it is scanned, the page cannot advertise a deleted example or miss an added one; each card carries the files it contains and the command that runs it. Tests: [tests/examples-page.test.js](tests/examples-page.test.js), [tests/examples-index.test.js](tests/examples-index.test.js) || Cookbook (runnable recipes) | Index [pages/cookbook.html](pages/cookbook.html) `-> /cookbook`, recipe viewer [pages/recipe.html](pages/recipe.html) `-> /cookbook/<slug>`, manifest [public/cookbook-manifest.js](public/cookbook-manifest.js), styles [public/cookbook.css](public/cookbook.css), recipe prose [docs/cookbook/](docs/cookbook), runnable files [public/cookbook/recipes/](public/cookbook/recipes), notebook export [public/cookbook/self-correcting-3d/](public/cookbook/self-correcting-3d) | Live | The sibling of the Examples gallery, and deliberately a different thing: an example is a snippet you read on the page, a recipe is a file you download and run. Five recipes, each one executed against the live API before it was published: a standard-library text-to-3D CLI, a parallel asset-pack builder that emits a manifest plus a gallery, an MCP server that hands Claude Code or Cursor a 3D tool, a CI budget gate over [api/3d/inspect.js](api/3d/inspect.js), and the function-calling-plus-vision notebook also submitted to the OpenAI Cookbook. The manifest is the single source of truth for both surfaces; recipe prose is markdown under `docs/cookbook/` fetched by the viewer, so adding a recipe is a manifest entry plus a `.md` plus the file itself. Route order is load-bearing in both [vercel.json](vercel.json) and the dev middleware: the notebook's static export must be matched before the generic `/cookbook/<slug>` rule or the viewer shadows it. Docs: [public/cookbook/recipes/README.md](public/cookbook/recipes/README.md). Tests: [tests/cookbook.test.js](tests/cookbook.test.js) || Walkthroughs (interactive product tours from real frames) | Index [pages/walkthroughs.html](pages/walkthroughs.html) + [src/walkthroughs-index.js](src/walkthroughs-index.js) `→ /walkthroughs`, player [pages/walkthrough.html](pages/walkthrough.html) + [src/walkthrough.js](src/walkthrough.js) `→ /walkthroughs/<slug>` (routed in [vercel.json](vercel.json), mirrored by the Vite dev middleware in [vite.config.js](vite.config.js)), pure step geometry [src/walkthrough-geometry.js](src/walkthrough-geometry.js), generated manifest + screenshot sets [public/walkthroughs/](public/walkthroughs) captured by [scripts/capture-walkthroughs.mjs](scripts/capture-walkthroughs.mjs) | Live | Step-by-step guided tours (forge a 3D model, build an agent, embed an avatar, find an agent worth using) built from real frames captured on the live product: each step zooms and pans to the element it describes, cuts a spotlight around it, and anchors a callout, so it reads like a screen recording but is a handful of deep-linkable, keyboard-operable JPEGs that degrade to annotated stills under reduced motion. Index and player read the same generated manifest, so a walkthrough that did not capture cleanly cannot be advertised. Registered in [data/pages.json](data/pages.json). || Cross-entity search | [pages/search.html](pages/search.html) `→ /search`, backend [api/search.js](api/search.js) + query layer [api/_lib/cross-search.js](api/_lib/cross-search.js) | Live | The one search across every creation type — avatars, on-chain/Solana agents, forged 3D models, worlds, and coins. Federates (not one SQL UNION — the stores are genuinely heterogeneous, two of five aren't even in the same database) five parallel queries, normalizes into one card shape, and ranks by recency plus real signals (follower count via `user_follows`, remix count, view count) — see the file header in `api/search.js` for the full unify-vs-federate writeup. Model results carry a working "Remix — $0.25" action against the existing paid rail ([api/x402/remix-asset.js](api/x402/remix-asset.js)), reused from [pages/creations.html](pages/creations.html) rather than re-derived. Coin search checks three.ws's own launch directory (`pump_agent_mints`) first, then falls back to market-wide pump.fun/Birdeye search for broader coverage (those external matches carry no verified timestamp or creator profile, and are ranked/labelled accordingly). Linked from the Discover nav menu. |diff --git a/api/spotlight-og.js b/api/spotlight-og.jsindex 019289293..51c3b72ca 100644--- a/api/spotlight-og.js+++ b/api/spotlight-og.js@@ -88,7 +88,7 @@ function renderHtml({ entryId, title, desc, agentName, pageUrl, ogImage, origin<html lang="en"><head><meta charset="utf-8">- <title>${t} | Agent Spotlight | three.ws</title>+ <title>${t} — Agent Spotlight — three.ws</title><meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover"><meta name="description" content="${d}"><meta name="theme-color" content="#06070a">diff --git a/data/changelog.json b/data/changelog.jsonindex 132052e3b..772df63ff 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,16 +1,6 @@{"$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-09-02",- "title": "Every showcased agent now has its own page",- "summary": "Agent Spotlight entries got somewhere to live. Each one now has its own page with the agent standing in 3D, the full write-up instead of three clamped lines, a facts panel read live off the agent (skills, conversations, on-chain actions, upvotes), share buttons, and a rail of related entries in the same category. Sharing one finally works too: paste a link anywhere and it unfurls with that entry's headline and the agent's own card rather than the generic showcase image. If you submitted an entry, you can now edit or remove it, which you could not do before: an Edit link on your card opens the write-up ready to change, and removing takes two clicks so it cannot happen by accident. Ranking got fairer as well, with a stable order for entries published at the same moment instead of a shuffle between page loads.",- "tags": [- "improvement",- "feature"- ],- "link": "/spotlight"- },{"date": "2026-09-01","title": "The community showcase is open",@@ -25590,17 +25580,6 @@"fix"],"link": "/examples"- },- {- "date": "2026-09-02",- "title": "Examples gains a voice, an AI's eye on 3D, and a filter",- "summary": "Three more runnable examples and a way to find them. The avatar can now speak a line you type: the free text-to-speech lane synthesizes it and a new speakAudio() method routes the audio through the same analyser the built-in voice uses, so the mouth follows the real waveform instead of miming. A second example calls the look_at_model tool on the public MCP server and shows exactly what an AI assistant sees when it inspects a mesh: four rendered angles plus a plain-language read on the geometry, which is how an agent judges its own output and decides to try again. A third reads the live tool list off that same server, so the page can never advertise a tool that was renamed or dropped. With seventeen examples the page also gets a filter: type to search names, descriptions and tags, or narrow by tag, and the lanes fold away as they empty. A deep link always wins over an active filter.",- "tags": [- "feature",- "improvement",- "sdk"- ],- "link": "/examples"}]}diff --git a/pages/examples.html b/pages/examples.htmlindex 4bade1732..f18ba385a 100644--- a/pages/examples.html+++ b/pages/examples.html@@ -72,10 +72,7 @@</script><meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1" /><meta property="og:locale" content="en_US" />- <meta- property="og:image:alt"- content="Runnable three.ws examples for avatars, 3D models, agents, and the agent economy"- />+ <meta property="og:image:alt" content="Runnable three.ws examples for avatars, 3D models, agents, and the agent economy" /></head><body><header><div id="nav-container"></div></header>@@ -89,16 +86,15 @@</p><h1 class="exg-title">Everything an agent <em>can do</em></h1><p class="exg-sub">- <span id="exg-count">17</span> runnable examples across+ <span id="exg-count">14</span> runnable examples across<span id="exg-lane-count">4</span> lanes: embedding a 3D body, generating andmeasuring the models themselves, defining an agent as files, and reading themachine-payable economy those agents trade in. Each one is a complete HTMLdocument that loads the production<a href="https://three.ws/agent-3d/latest/agent-3d.js">CDN bundle</a> and callsthe production APIs. Press <strong>Run</strong> and the exact code shown- executes in a frame on this page against live data; press- <strong>Copy</strong> and paste it into any HTML page on any domain. Filter by- name or tag to find one. Deeper walkthroughs live in the+ executes in a frame on this page against live data; press <strong>Copy</strong>+ and paste it into any HTML page on any domain. Deeper walkthroughs live in the<a href="/tutorials">tutorials</a>, recipes for the 3D API in the<a href="/cookbook">cookbook</a>, and interactive lab pages in<a href="/demos">demos</a>.@@ -118,27 +114,9 @@was added. Each card shows the files it contains and the command that runs it.</p>- <div- class="exi-toolbar"- role="toolbar"- aria-label="Search and filter repository examples"- >+ <div class="exi-toolbar" role="toolbar" aria-label="Search and filter repository examples"><div class="exi-search-wrap">- <svg- class="exi-search-icon"- width="14"- height="14"- viewBox="0 0 24 24"- fill="none"- stroke="currentColor"- stroke-width="2"- stroke-linecap="round"- stroke-linejoin="round"- aria-hidden="true"- >- <circle cx="11" cy="11" r="8" />- <line x1="21" y1="21" x2="16.65" y2="16.65" />- </svg>+ <svg class="exi-search-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="11" cy="11" r="8" /><line x1="21" y1="21" x2="16.65" y2="16.65" /></svg><inputtype="search"class="exi-search"@@ -151,12 +129,7 @@<span class="exi-count" data-role="ex-count" aria-live="polite"></span></div>- <div- class="exi-chips"- data-role="ex-chips"- role="tablist"- aria-label="Filter examples by kind"- ></div>+ <div class="exi-chips" data-role="ex-chips" role="tablist" aria-label="Filter examples by kind"></div><p class="exi-sr" data-role="ex-live" aria-live="polite"></p><div class="exi-grid" data-role="ex-loading" aria-label="Loading examples">@@ -173,17 +146,13 @@<div class="exi-state" data-role="ex-empty-search" hidden><h3>No matches</h3><p>No examples match your search or the selected kind.</p>- <button type="button" class="exi-btn exi-btn--ghost" data-role="ex-clear">- Clear filters- </button>+ <button type="button" class="exi-btn exi-btn--ghost" data-role="ex-clear">Clear filters</button></div><div class="exi-state" data-role="ex-error" hidden><h3>Couldn't load the example index</h3><p data-role="ex-error-msg">Something went wrong loading the example index.</p>- <button type="button" class="exi-btn exi-btn--ghost" data-role="ex-retry">- Try again- </button>+ <button type="button" class="exi-btn exi-btn--ghost" data-role="ex-retry">Try again</button></div><h3 class="exi-subhead">Start with these</h3>@@ -196,8 +165,8 @@><strong>coach-leo</strong><span- >The smallest complete agent defined as files: manifest, system prompt,- one skill. The template to copy.</span+ >The smallest complete agent defined as files: manifest, system prompt, one+ skill. The template to copy.</span></a><a@@ -232,8 +201,8 @@><strong>agent-native-3d</strong><span- >A Node script that generates a mesh, rigs it, saves it as an agent- persona, and speaks through it via MCP.</span+ >A Node script that generates a mesh, rigs it, saves it as an agent persona,+ and speaks through it via MCP.</span></a><a@@ -244,15 +213,15 @@><strong>monicas-apartment</strong><span- >A walkable first-person Three.js scene in one self-contained HTML file.- No server at all.</span+ >A walkable first-person Three.js scene in one self-contained HTML file. No+ server at all.</span></a><a class="exg-more-card" href="/docs/examples"><strong>Examples doc</strong><span- >The written companion: every example annotated with what it- demonstrates and where the pieces live.</span+ >The written companion: every example annotated with what it demonstrates+ and where the pieces live.</span></a></div>diff --git a/public/changelog.json b/public/changelog.jsonindex 7c7467f7b..ca67158da 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,34 +1,11 @@{- "generated_at": "2026-09-02T05:18:19.516Z",+ "generated_at": "2026-09-01T18:36:39.158Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},"entries": [- {- "date": "2026-09-02",- "type": "update",- "title": "Every showcased agent now has its own page",- "summary": "Agent Spotlight entries got somewhere to live. Each one now has its own page with the agent standing in 3D, the full write-up instead of three clamped lines, a facts panel read live off the agent (skills, conversations, on-chain actions, upvotes), share buttons, and a rail of related entries in the same category. Sharing one finally works too: paste a link anywhere and it unfurls with that entry's headline and the agent's own card rather than the generic showcase image. If you submitted an entry, you can now edit or remove it, which you could not do before: an Edit link on your card opens the write-up ready to change, and removing takes two clicks so it cannot happen by accident. Ranking got fairer as well, with a stable order for entries published at the same moment instead of a shuffle between page loads.",- "link": "/spotlight",- "tags": [- "improvement",- "feature"- ]- },- {- "date": "2026-09-02",- "type": "update",- "title": "Examples gains a voice, an AI's eye on 3D, and a filter",- "summary": "Three more runnable examples and a way to find them. The avatar can now speak a line you type: the free text-to-speech lane synthesizes it and a new speakAudio() method routes the audio through the same analyser the built-in voice uses, so the mouth follows the real waveform instead of miming. A second example calls the look_at_model tool on the public MCP server and shows exactly what an AI assistant sees when it inspects a mesh: four rendered angles plus a plain-language read on the geometry, which is how an agent judges its own output and decides to try again. A third reads the live tool list off that same server, so the page can never advertise a tool that was renamed or dropped. With seventeen examples the page also gets a filter: type to search names, descriptions and tags, or narrow by tag, and the lanes fold away as they empty. A deep link always wins over an active filter.",- "link": "/examples",- "tags": [- "feature",- "improvement",- "sdk"- ]- },{"date": "2026-09-01","type": "launch",diff --git a/public/changelog.xml b/public/changelog.xmlindex a685a6813..c2421d7b0 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -6,22 +6,6 @@<atom:link href="https://three.ws/changelog.xml" rel="self" type="application/rss+xml"/><description>What's new on three.ws: features, improvements, and releases, newest first.</description><language>en</language>- <item>- <title>Every showcased agent now has its own page</title>- <link>https://three.ws/spotlight</link>- <guid isPermaLink="false">2026-09-02:Every showcased agent now has its own page</guid>- <pubDate>Wed, 02 Sep 2026 12:00:00 GMT</pubDate>- <category>improvement</category>- <description>Agent Spotlight entries got somewhere to live. Each one now has its own page with the agent standing in 3D, the full write-up instead of three clamped lines, a facts panel read live off the agent (skills, conversations, on-chain actions, upvotes), share buttons, and a rail of related entries in the same category. Sharing one finally works too: paste a link anywhere and it unfurls with that entry's headline and the agent's own card rather than the generic showcase image. If you submitted an entry, you can now edit or remove it, which you could not do before: an Edit link on your card opens the write-up ready to change, and removing takes two clicks so it cannot happen by accident. Ranking got fairer as well, with a stable order for entries published at the same moment instead of a shuffle between page loads.</description>- </item>- <item>- <title>Examples gains a voice, an AI's eye on 3D, and a filter</title>- <link>https://three.ws/examples</link>- <guid isPermaLink="false">2026-09-02:Examples gains a voice, an AI's eye on 3D, and a filter</guid>- <pubDate>Wed, 02 Sep 2026 12:00:00 GMT</pubDate>- <category>feature</category>- <description>Three more runnable examples and a way to find them. The avatar can now speak a line you type: the free text-to-speech lane synthesizes it and a new speakAudio() method routes the audio through the same analyser the built-in voice uses, so the mouth follows the real waveform instead of miming. A second example calls the look_at_model tool on the public MCP server and shows exactly what an AI assistant sees when it inspects a mesh: four rendered angles plus a plain-language read on the geometry, which is how an agent judges its own output and decides to try again. A third reads the live tool list off that same server, so the page can never advertise a tool that was renamed or dropped. With seventeen examples the page also gets a filter: type to search names, descriptions and tags, or narrow by tag, and the lanes fold away as they empty. A deep link always wins over an active filter.</description>- </item><item><title>3D Drops</title><link>https://three.ws/drops</link>diff --git a/public/features.json b/public/features.jsonindex 81709b46c..d79974a2e 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-09-02T05:18:19.486Z",+ "generated_at": "2026-09-01T18:36:39.145Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",diff --git a/public/theme-switcher.js b/public/theme-switcher.jsindex a0cf1de9b..8f462c5e7 100644--- a/public/theme-switcher.js+++ b/public/theme-switcher.js@@ -232,16 +232,15 @@// change the verdict, so only a stylesheet node (a <link rel=stylesheet>// finishing its load, or a <style> element landing or leaving) re-probes,// and a burst of them costs one probe per frame.- var probeQueued = false;+ // Synchronous on purpose. A stylesheet landing has to flip the page in the+ // same turn: nav.js injects its <link> long after boot, and a visitor who+ // chose light must not sit on dark until the next frame. Batching this+ // onto an animation frame also made the probe outlive boot, which is+ // exactly what the "own probe stylesheet re-triggers the watch" guard+ // exists to catch. The saving comes from the filter below, not from+ // deferring: only a stylesheet can change the verdict.var onSheet = function () {- if (probeQueued || (!sheetWatch && islandSettled)) return;- probeQueued = true;- var run = function () {- probeQueued = false;- if (reprobeCapability()) stopWatching();- };- if (typeof requestAnimationFrame === 'function') requestAnimationFrame(run);- else setTimeout(run, 16);+ if (reprobeCapability()) stopWatching();};var isSheetNode = function (node) {if (!node || node.nodeType !== 1 || isProbeNode(node)) return false;diff --git a/src/spotlight-entry.js b/src/spotlight-entry.jsindex c339996ba..ee8924ddb 100644--- a/src/spotlight-entry.js+++ b/src/spotlight-entry.js@@ -1,5 +1,5 @@/**- * /spotlight/:id renders one Agent Spotlight entry.+ * /spotlight/:id — one Agent Spotlight entry.** The reason this page exists: an entry's write-up runs to 4,000 characters and* the index could only ever show three clamped lines of it. A showcase whose@@ -96,14 +96,12 @@ function breadcrumb(e) {}function badges(e) {- // No category chip here: the breadcrumb directly above already names it, and- // printing it twice in two styles reads as a rendering bug.- const chips = [+ return el('div', { class: 'sp-detail-badges' }, [+ el('span', { class: 'sp-badge', text: categoryLabel(e.category) }),e.agent.is_registered ? el('span', { class: 'sp-badge sp-badge-onchain', text: 'On-chain' }) : null,e.featured ? el('span', { class: 'sp-badge', text: "Editor's pick" }) : null,e.source === 'curated' ? el('span', { class: 'sp-badge sp-badge-curated', text: 'Curated' }) : null,- ].filter(Boolean);- return chips.length ? el('div', { class: 'sp-detail-badges' }, chips) : null;+ ]);}// A curated entry says so in words, not just a badge. The badge tells you the@@ -186,7 +184,7 @@ function factsPanel(e) {function shareRow(e) {const url = `https://three.ws/spotlight/${e.id}`;- const shareText = `${e.title} (${e.agent.name} on three.ws)`;+ const shareText = `${e.title} — ${e.agent.name} on three.ws`;const copy = el('button', { type: 'button', class: 'sp-btn sp-btn-sm', text: 'Copy link' });copy.addEventListener('click', async () => {@@ -427,13 +425,10 @@ function render() {el('p', { class: 'sp-detail-nostory', text: 'No write-up yet, just the one-liner above.' }),]);- // Filtered, because replaceChildren() coerces a null argument to the literal- // string "null" and prints it on the page. Only el() filters its children;- // this call is the one place a section can legitimately be absent.- const sections = [+ root.replaceChildren(el('div', { class: 'sp-detail-hero' }, [stageFor(entry, { eager: true }), header]),ownerControls(entry),- entry.editable_by_me ? editorPanel() : null,+ editorPanel(),el('p', { class: 'sp-form-note', id: 'sp-detail-note', role: 'status', 'aria-live': 'polite' }),el('div', { class: 'sp-detail-body' }, [main, factsPanel(entry)]),el('section', { class: 'sp-related', id: 'sp-related', hidden: true }),@@ -441,8 +436,7 @@ function render() {el('a', { class: 'sp-btn', href: '/spotlight', text: 'Back to the showcase' }),el('a', { class: 'sp-btn', href: '/spotlight?submit=1', text: 'Showcase your own agent' }),]),- ].filter(Boolean);- root.replaceChildren(...sections);+ );root.setAttribute('aria-busy', 'false');editRefs = null;}diff --git a/src/spotlight.js b/src/spotlight.jsindex c0c0519a3..d00a9bd09 100644--- a/src/spotlight.js+++ b/src/spotlight.js@@ -1,5 +1,5 @@/**- * /spotlight: Agent Spotlight, the three.ws community showcase.+ * /spotlight — Agent Spotlight, the three.ws community showcase.** One controller, three jobs: browse (sort + category + search + paging), vote,* and submit. State is a single `view` object that the URL mirrors, so every