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
feat(announce): queue the assistant announcement and move four kits into review
ni3a7cdcc607a036
diff --git a/data/announce-media.json b/data/announce-media.jsonindex d178525ad..29ce73ddb 100644--- a/data/announce-media.json+++ b/data/announce-media.json@@ -153,7 +153,7 @@"id": "activity-mcp-hero","surface": "@three-ws/activity-mcp","viewport": "wide",- "alt": "A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom.",+ "alt": "A dark title card headed at three-ws slash activity-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming get_trending_agents, get_trending_coins, get_holder_leaderboard, get_tier_info and get_feed_events.","caption": "Title card for @three-ws/activity-mcp, typeset from its README and package.json.","card": {"dir": "packages/activity-mcp",@@ -177,14 +177,14 @@"id": "knock-hero","surface": "/knock","url": "/knock",- "alt": "The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it.",+ "alt": "The Knock page on three.ws: the headline and its description, three numbered cards reading Set your price, They pay it and You hear it in person, and the signed-out door panel below them.","caption": "Captured from the live /knock route for the knock announcement."},{"id": "avatar-mcp-hero","surface": "@three-ws/avatar-mcp","viewport": "wide",- "alt": "A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom.",+ "alt": "A dark title card headed at three-ws slash avatar-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming render_avatar, avatar_embed_code and get_avatar.","caption": "Title card for @three-ws/avatar-mcp, typeset from its README and package.json.","card": {"dir": "packages/threews-avatar-mcp",diff --git a/data/x-content/queue.json b/data/x-content/queue.jsonindex cafcda5bf..b507169a5 100644--- a/data/x-content/queue.json+++ b/data/x-content/queue.json@@ -1208,7 +1208,7 @@},{"id": "activity-mcp",- "status": "draft",+ "status": "review","kind": "post","tier": 3,"lane": "developer",@@ -1224,7 +1224,7 @@"media": [{"path": "public/announce/img/activity-mcp-hero.webp",- "alt": "A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom."+ "alt": "A dark title card headed at three-ws slash activity-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming get_trending_agents, get_trending_coins, get_holder_leaderboard, get_tier_info and get_feed_events."}]},@@ -1259,6 +1259,69 @@],"mentions": {}},+ {+ "id": "avatar-mcp",+ "status": "review",+ "kind": "post",+ "tier": 3,+ "lane": "developer",+ "pattern": "mechanism",+ "notBefore": "2026-09-21T04:00:00Z",+ "source": {+ "path": "docs/announcements/avatar-mcp.md"+ },+ "posts": [+ {+ "text": "Ask your assistant for an avatar and it renders in the chat: live, rotatable, idling, with a paste-anywhere embed beside it. npmjs.com/package/@three-ws/avatar-mcp",+ "textFrom": "docs/announcements/avatar-mcp.post.txt",+ "media": [+ {+ "path": "public/announce/img/avatar-mcp-hero.webp",+ "alt": "A dark title card headed at three-ws slash avatar-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming render_avatar, avatar_embed_code and get_avatar."+ }+ ]+ },+ {+ "text": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat. All three tools are free and read-only."+ },+ {+ "text": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."+ }+ ],+ "claims": [+ {+ "says": "All three tools are free and read-only",+ "evidence": [+ {+ "type": "file",+ "path": "packages/threews-avatar-mcp/README.md",+ "contains": "All three tools are free, read-only, and annotated (`readOnlyHint`, `idempotentHint`, `openWorldHint`) so hosts can run them without confirmation prompts."+ }+ ]+ },+ {+ "says": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat.",+ "evidence": [+ {+ "type": "file",+ "path": "packages/threews-avatar-mcp/README.md",+ "contains": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat."+ }+ ]+ },+ {+ "says": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere.",+ "evidence": [+ {+ "type": "file",+ "path": "packages/threews-avatar-mcp/README.md",+ "contains": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."+ }+ ]+ }+ ],+ "mentions": {}+ },{"id": "mocap-studio","status": "draft",@@ -1315,7 +1378,7 @@},{"id": "knock",- "status": "draft",+ "status": "review","kind": "post","tier": 1,"lane": "token",@@ -1332,7 +1395,7 @@"media": [{"path": "public/announce/img/knock-hero.webp",- "alt": "The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it."+ "alt": "The Knock page on three.ws: the headline and its description, three numbered cards reading Set your price, They pay it and You hear it in person, and the signed-out door panel below them."}]},@@ -1388,62 +1451,53 @@"mentions": {}},{- "id": "avatar-mcp",+ "id": "assistant","status": "draft","kind": "post",- "tier": 3,+ "tier": 2,"lane": "developer",- "pattern": "mechanism",- "notBefore": "2026-09-22T04:00:00Z",+ "pattern": "clip",+ "notBefore": "2026-09-22T12:00:00Z","source": {- "path": "docs/announcements/avatar-mcp.md"+ "path": "docs/announcements/assistant.md",+ "url": "https://three.ws/assistant"},"posts": [{- "text": "Ask your assistant for an avatar and it renders in the chat: live, rotatable, idling, with a paste-anywhere embed beside it. npmjs.com/package/@three-ws/avatar-mcp",- "textFrom": "docs/announcements/avatar-mcp.post.txt",+ "text": "One script tag puts a 3D avatar assistant in the corner of any site. Pick a body, a background, and what it knows about your page. three.ws/assistant",+ "textFrom": "docs/announcements/assistant.post.txt","media": [{- "path": "public/announce/img/avatar-mcp-hero.webp",- "alt": "A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom."+ "path": "public/announce/img/assistant-hero.webp",+ "alt": "The assistant configurator with the option columns on the left and the floating launcher open in the corner showing a 3D avatar over the live page preview."}]},{- "text": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat. All three tools are free and read-only."+ "text": "The live preview runs in the corner of the page while you configure it, and every change above re-mounts it."},{- "text": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."+ "text": "Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body. It answers in chat, or speaks what you type in a speech bubble."}],"claims": [{- "says": "All three tools are free and read-only",- "evidence": [- {- "type": "file",- "path": "packages/threews-avatar-mcp/README.md",- "contains": "All three tools are free, read-only, and annotated (`readOnlyHint`, `idempotentHint`, `openWorldHint`) so hosts can run them without confirmation prompts."- }- ]- },- {- "says": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat.",+ "says": "The live preview runs in the corner of the page while you configure it, and every change above re-mounts it.","evidence": [{- "type": "file",- "path": "packages/threews-avatar-mcp/README.md",- "contains": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat."+ "type": "page",+ "url": "https://three.ws/assistant",+ "contains": "Live preview running in the corner. Every change above re-mounts it."}]},{- "says": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere.",+ "says": "Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body.","evidence": [{- "type": "file",- "path": "packages/threews-avatar-mcp/README.md",- "contains": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."+ "type": "page",+ "url": "https://three.ws/assistant",+ "contains": "Use a built-in body, any three.ws avatar id (make one in Forge), a GLB URL, or an agent's body via data-agent."}]}diff --git a/docs/announcements/activity-mcp.md b/docs/announcements/activity-mcp.mdindex 31b896b7d..f56f410b7 100644--- a/docs/announcements/activity-mcp.md+++ b/docs/announcements/activity-mcp.md@@ -2,7 +2,7 @@**Surface:** [`@three-ws/activity-mcp`](https://three.ws) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never-Ranked 31 of 324 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/activity-mcp.json`](../../data/announce-plan/briefs/activity-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.+Ranked 33 of 329 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/activity-mcp.json`](../../data/announce-plan/briefs/activity-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.---@@ -55,7 +55,7 @@ Captured from the live route by `npm run announce:media`, which drives the real**Alt text, required on the post:**-> A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom.+> A dark title card headed at three-ws slash activity-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming get_trending_agents, get_trending_coins, get_holder_leaderboard, get_tier_info and get_feed_events.## The postdiff --git a/docs/announcements/assistant.md b/docs/announcements/assistant.mdnew file mode 100644index 000000000..1f4006c0b--- /dev/null+++ b/docs/announcements/assistant.md@@ -0,0 +1,106 @@+# Announcement pack: A 3D assistant on any site, from one script tag++**Surface:** [`/assistant`](https://three.ws/assistant) · **Stage:** drafted · **Slot:** 2026-09-22 · **Announced externally:** never++Ranked 46 of 324 never-announced surfaces by `npm run announce:rank` (score 66). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/assistant.json`](../../data/announce-plan/briefs/assistant.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.++---++## At a glance++| Field | Value |+|---|---|+| Pack id | `assistant` |+| Publish slot | 2026-09-22. The minute is decided at send time from the production schedule seed, so it is not knowable from this repository |+| Lane and pattern | developer / clip |+| Audience | Engineers who will read the code |+| Primary channel | X, @trythreews, through the reviewed content queue |+| Secondary channels | Telegram (@three_ws), the surface's own docs page |+| Proof | https://three.ws/assistant |+| Tracked links | Telegram `https://three.ws/assistant?utm_source=telegram&utm_medium=community&utm_campaign=announce-assistant&utm_content=announcement`. The X post links the bare URL on purpose: X wraps every link in t.co and the queue's own ledger records the send, so a tagged link buys nothing and reads like marketing. |+| The single CTA | Open /assistant and use it |+| Media | `assistant-hero`, motion loop |+| KPI | loop completions and profile visits, then route sessions on the day |++## Why this one, and why now++The ranker scored it on signals measured against our own archive, not on taste:++- **reach (16)**: sitemap priority 0.80, which is what we already decided this surface is worth+- **visual (25)**: a showcase surface, so its frame can be a motion loop+- **novelty (20)**: on the coverage audit's hand-picked shortlist of strongest candidates+- **depth (5)**: documented in the tree, so there is enough to write a mechanism about and link proof for++The coverage audit's note on it: The AI concierge and assistant widgets: the embeddable business story beyond avatars.++It shipped on 2026-07-18 and has never been posted about.++The changelog has 4 entries about it, the most recent from 2026-08-16: "The assistant widget now tells you the truth when its chat lane is busy".++## The claim, and where it is checked++> One script tag puts a 3D avatar assistant in the corner of any site. Pick a body, a background, and what it knows about your page. three.ws/assistant++Every checkable part of that is declared as a claim in the queue item, and the verifier re-checks each one against the live surface before the post can be approved:++| Claim | Checked against |+|---|---|+| The live preview runs in the corner of the page while you configure it, and every change above re-mounts it. | live page shows "Live preview running in the corner. Every change above re-mounts it." |+| Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body. | live page shows "Use a built-in body, any three.ws avatar id (make one in Forge), a GLB URL, or an agent's body via data-agent." |++## Media++Captured from the live route by `npm run announce:media`, which drives the real page in a real Chromium and writes provenance (route, commit, time, sha256) beside the pixels in [`public/announce/media-manifest.json`](../../public/announce/media-manifest.json).++| Shot | File | Notes |+|---|---|---|+| `assistant-hero` | `/announce/img/assistant-hero.webp` | Motion loop of the live route. |++**Alt text, required on the post:**++> The assistant configurator with the option columns on the left and the floating launcher open in the corner showing a 3D avatar over the live page preview.++## The post++Pattern: clip. **154 weighted characters**, inside the 100 to 179 band that measured a 3.0x lift. Postable file: [`assistant.post.txt`](./assistant.post.txt), which is the byte-for-byte source the queue item points at.++```text+One script tag puts a 3D avatar assistant in the corner of any site. Pick a body, a background, and what it knows about your page. three.ws/assistant+```++### Why it is written that way++The post leads on the first move a developer makes and what comes back: configure, watch the preview re-mount, copy one tag. That is the whole product, and it is the shortest path from reading to shipping an avatar on a real site.++### Thread++2/ (108)++```text+The live preview runs in the corner of the page while you configure it, and every change above re-mounts it.+```++3/ (154)++```text+Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body. It answers in chat, or speaks what you type in a speech bubble.+```++## Telegram (@three_ws)++The same facts in the channel's longer register. The changelog cron posts release notes there automatically; this is the announcement register, sent by hand or queued alongside the post.++```text+The assistant widget puts a talking 3D avatar on any website with one script tag. Pick a body, a background, and what the chatbot should know about your site, and the live preview in the corner re-mounts on every change. Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body, then copy the tag. three.ws/assistant+```++## Ship it++```bash+npm run announce:media -- --only assistant-hero # capture the frame from the live route+npm run x:content -- review assistant # lint, live fact checks, AI editor+npm run x:content -- run --dry-run --id assistant # exactly what would be sent to X+```++The queue item is `assistant` in [`data/x-content/queue.json`](../../data/x-content/queue.json), at status `draft`. It becomes eligible to publish when a passing review record exists and the owner sets its status to `approved`; the Cloud Scheduler tick then sends it at its slot. Nothing here posts on its own.+diff --git a/docs/announcements/assistant.post.txt b/docs/announcements/assistant.post.txtnew file mode 100644index 000000000..73bae9978--- /dev/null+++ b/docs/announcements/assistant.post.txt@@ -0,0 +1 @@+One script tag puts a 3D avatar assistant in the corner of any site. Pick a body, a background, and what it knows about your page. three.ws/assistantdiff --git a/docs/announcements/avatar-mcp.md b/docs/announcements/avatar-mcp.mdindex eb2948a3b..35eb7607f 100644--- a/docs/announcements/avatar-mcp.md+++ b/docs/announcements/avatar-mcp.md@@ -1,8 +1,8 @@# Announcement pack: A live 3D avatar rendered inside the chat-**Surface:** [`@three-ws/avatar-mcp`](https://three.ws) · **Stage:** drafted · **Slot:** 2026-09-22 · **Announced externally:** never+**Surface:** [`@three-ws/avatar-mcp`](https://three.ws) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never-Ranked 36 of 324 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/avatar-mcp.json`](../../data/announce-plan/briefs/avatar-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.+Ranked 38 of 329 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/avatar-mcp.json`](../../data/announce-plan/briefs/avatar-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.---@@ -11,7 +11,7 @@ Ranked 36 of 324 never-announced surfaces by `npm run announce:rank` (score 67).| Field | Value ||---|---|| Pack id | `avatar-mcp` |-| Publish slot | 2026-09-22. The minute is decided at send time from the production schedule seed, so it is not knowable from this repository |+| Publish slot | 2026-09-21. The minute is decided at send time from the production schedule seed, so it is not knowable from this repository || Lane and pattern | developer / mechanism || Audience | Engineers who will read the code || Primary channel | X, @trythreews, through the reviewed content queue |@@ -56,7 +56,7 @@ Captured from the live route by `npm run announce:media`, which drives the real**Alt text, required on the post:**-> A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom.+> A dark title card headed at three-ws slash avatar-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming render_avatar, avatar_embed_code and get_avatar.## The postdiff --git a/docs/announcements/knock.md b/docs/announcements/knock.mdindex 6bdbcbe3f..e46d1aa1b 100644--- a/docs/announcements/knock.md+++ b/docs/announcements/knock.md@@ -2,7 +2,7 @@**Surface:** [`/knock`](https://three.ws/knock) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never-Ranked 29 of 324 never-announced surfaces by `npm run announce:rank` (score 70). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/knock.json`](../../data/announce-plan/briefs/knock.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.+Ranked 31 of 329 never-announced surfaces by `npm run announce:rank` (score 70). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/knock.json`](../../data/announce-plan/briefs/knock.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.---@@ -58,7 +58,7 @@ Captured from the live route by `npm run announce:media`, which drives the real**Alt text, required on the post:**-> The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it.+> The Knock page on three.ws: the headline and its description, three numbered cards reading Set your price, They pay it and You hear it in person, and the signed-out door panel below them.## The postdiff --git a/public/announce/media-manifest.json b/public/announce/media-manifest.jsonindex 7e32d212c..f578d181a 100644--- a/public/announce/media-manifest.json+++ b/public/announce/media-manifest.json@@ -1,6 +1,6 @@{"generatedBy": "scripts/capture-doc-media.mjs",- "generatedAt": "2026-09-20T05:56:28.175Z",+ "generatedAt": "2026-09-20T06:09:35.981Z","shots": {"activity-hero": {"id": "activity-hero",@@ -41,7 +41,7 @@"activity-mcp-hero": {"id": "activity-mcp-hero","src": "/announce/img/activity-mcp-hero.webp",- "alt": "A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom.",+ "alt": "A dark title card headed at three-ws slash activity-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming get_trending_agents, get_trending_coins, get_holder_leaderboard, get_tier_info and get_feed_events.","caption": "Title card for @three-ws/activity-mcp, typeset from its README and package.json.","route": "card:packages/activity-mcp","viewport": "wide",@@ -58,7 +58,7 @@"avatar-mcp-hero": {"id": "avatar-mcp-hero","src": "/announce/img/avatar-mcp-hero.webp",- "alt": "A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom.",+ "alt": "A dark title card headed at three-ws slash avatar-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming render_avatar, avatar_embed_code and get_avatar.","caption": "Title card for @three-ws/avatar-mcp, typeset from its README and package.json.","route": "card:packages/threews-avatar-mcp","viewport": "wide",@@ -151,7 +151,7 @@"knock-hero": {"id": "knock-hero","src": "/announce/img/knock-hero.webp",- "alt": "The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it.",+ "alt": "The Knock page on three.ws: the headline and its description, three numbered cards reading Set your price, They pay it and You hear it in person, and the signed-out door panel below them.","caption": "Captured from the live /knock route for the knock announcement.","route": "/knock","viewport": "wide",