Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

feat(agenc): link the task room from the embodied demo and list it in the examples index

nirholasab55648b71e3
diff --git a/data/examples.json b/data/examples.json
index 0fabd0ce6..2ea6f44ed 100644
--- a/data/examples.json
+++ b/data/examples.json
@@ -2,10 +2,10 @@
"$comment": "Generated by scripts/build-examples-index.mjs from what is on disk. Do not edit by hand; run npm run build:examples.",
"generated_by": "scripts/build-examples-index.mjs",
"counts": {
- "total": 42,
+ "total": 43,
"html_demos": 11,
"projects": 10,
- "packages": 21
+ "packages": 22
},
"examples": [
{
@@ -388,6 +388,21 @@
"readme": "packages/vision-mcp/examples/README.md",
"owner": "packages/vision-mcp"
},
+ {
+ "id": "package:packages/voice",
+ "kind": "package",
+ "group": "Package examples",
+ "title": "@three-ws/voice",
+ "description": "Run it from the package directory:",
+ "path": "packages/voice/examples",
+ "files": [
+ "voice-loop.mjs"
+ ],
+ "run": "node packages/voice/examples/voice-loop.mjs",
+ "runKind": "command",
+ "readme": "packages/voice/examples/README.md",
+ "owner": "packages/voice"
+ },
{
"id": "package:packages/x402-fetch",
"kind": "package",
diff --git a/docs/examples.md b/docs/examples.md
index 80def323b..320a6d7e1 100644
--- a/docs/examples.md
+++ b/docs/examples.md
@@ -735,7 +735,7 @@ genuinely invested in the user's progress.
## Every runnable example in the repo
-The repo ships 42 examples: 11 web component demos, 10 end-to-end projects, and 21 package example sets. This table is generated from what is on disk, so it cannot list one that was deleted or miss one that was added. The machine-readable version is [data/examples.json](../data/examples.json).
+The repo ships 43 examples: 11 web component demos, 10 end-to-end projects, and 22 package example sets. This table is generated from what is on disk, so it cannot list one that was deleted or miss one that was added. The machine-readable version is [data/examples.json](../data/examples.json).
### Example projects
@@ -771,6 +771,7 @@ The repo ships 42 examples: 11 web component demos, 10 end-to-end projects, and
| [`tour-sdk/examples`](../tour-sdk/examples) | The guide walks from feature to feature across your real pages. | `npm run dev, then open /tour-sdk/examples/shopify-storefront.html` |
| [`packages/vanity-mcp/examples`](../packages/vanity-mcp/examples) | Two runnable examples. Both spawn this package's own MCP server over stdio (the same node src/index.js entry point the README documents), speak real MCP JSON-RPC to it, and read the live grind-bounty market. | `node packages/vanity-mcp/examples/list-tools.mjs` |
| [`packages/vision-mcp/examples`](../packages/vision-mcp/examples) | Two runnable examples. Both spawn this package's own MCP server over stdio (the same node src/index.js entry point the README documents), speak real MCP JSON-RPC to it, and hit the live three.ws vision pipeline. | `node packages/vision-mcp/examples/list-tools.mjs` |
+| [`packages/voice/examples`](../packages/voice/examples) | Run it from the package directory: | `node packages/voice/examples/voice-loop.mjs` |
| [`packages/x402-fetch/examples`](../packages/x402-fetch/examples) | Two runnable scripts against the live three.ws x402 Market Data API. Node 20+ is the only requirement; the package has zero production dependencies. | `node packages/x402-fetch/examples/discover.mjs` |
| [`packages/x402-mcp/examples`](../packages/x402-mcp/examples) | Two runnable examples. Both spawn this package's own MCP server over stdio (the same node src/index.js entry point the README documents), speak real MCP JSON-RPC to it, and hit live data. Neither one pays for anything. | `node packages/x402-mcp/examples/inspect-price.mjs` |
| [`x402-modal-sdk/examples`](../x402-modal-sdk/examples) | A drop-in payment modal for any x402 paid endpoint. | `node x402-modal-sdk/examples/server.mjs` |
diff --git a/pages/agenc/room.html b/pages/agenc/room.html
index 908f02513..58bcf277a 100644
--- a/pages/agenc/room.html
+++ b/pages/agenc/room.html
@@ -626,7 +626,14 @@
return localize(el);
}
+ // The poll keeps running behind an empty or upstream-error state, so the
+ // same notice would otherwise be rebuilt every few seconds, stealing focus
+ // from its own Retry button and re-announcing itself to a screen reader.
+ // Re-render only when what it says actually changes.
function showNotice(config) {
+ const signature = `${config.tone || 'info'}|${config.title}|${config.body}`;
+ if (room.dataset.notice === signature && room.querySelector('.notice')) return;
+ room.dataset.notice = signature;
cards.clear();
resetAvatars();
room.replaceChildren(notice(config));
@@ -634,6 +641,7 @@
function showSkeleton() {
room.setAttribute('aria-busy', 'true');
+ delete room.dataset.notice;
resetAvatars();
const frag = document.createDocumentFragment();
for (let i = 0; i < 6; i++) {
@@ -746,6 +754,7 @@
if (room.querySelector('.notice, .skeleton')) {
room.replaceChildren();
+ delete room.dataset.notice;
cards.clear();
resetAvatars();
}
diff --git a/public/examples.json b/public/examples.json
index 8b536da90..ddd90a2cc 100644
--- a/public/examples.json
+++ b/public/examples.json
@@ -2,10 +2,10 @@
"$comment": "GENERATED by scripts/mirror-examples-index.mjs from data/examples.json. Do not edit; run `npm run build:examples`.",
"generated_by": "scripts/build-examples-index.mjs",
"counts": {
- "total": 42,
+ "total": 43,
"html_demos": 11,
"projects": 10,
- "packages": 21
+ "packages": 22
},
"examples": [
{
@@ -388,6 +388,21 @@
"readme": "packages/vision-mcp/examples/README.md",
"owner": "packages/vision-mcp"
},
+ {
+ "id": "package:packages/voice",
+ "kind": "package",
+ "group": "Package examples",
+ "title": "@three-ws/voice",
+ "description": "Run it from the package directory:",
+ "path": "packages/voice/examples",
+ "files": [
+ "voice-loop.mjs"
+ ],
+ "run": "node packages/voice/examples/voice-loop.mjs",
+ "runKind": "command",
+ "readme": "packages/voice/examples/README.md",
+ "owner": "packages/voice"
+ },
{
"id": "package:packages/x402-fetch",
"kind": "package",