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(create): finish the creation-surface merge so no redirect loses a capability
nirholasa82b69768909
diff --git a/README.md b/README.mdindex fca700113..7c187c306 100644--- a/README.md+++ b/README.md@@ -8609,7 +8609,7 @@ three.ws is production-ready and serves [three.ws](https://three.ws) live on Goo- `<agent-3d>` custom element — drop it anywhere with no framework dependency- Five widget variants: turntable, animation gallery, talking agent, ERC-8004 passport card, hotspot tour-- Widget Studio + WYSIWYG **Embed editor** at `/embed` — pick an avatar, embed mode, environment, and size, copy the snippet+- **Widget Studio** at `/studio`: pick an avatar (or paste your own model URL), pick a widget type, tune it live, copy the snippet; no account needed for the URL-baked types- **Launchpad** at `/launchpad` — hosted public launch pages at `/p/[slug]` for tokens, agents, and drops- Open Graph metadata and oEmbed support for rich social previews when links are shared- Versioned CDN bundles at `/agent-3d/x.y.z/agent-3d.js`@@ -8735,7 +8735,7 @@ A map of every user-facing route. [`STRUCTURE.md`](STRUCTURE.md) maps each produ| **Profile** | `/profile`, `/u/[username]`, `/avatars/[id]` | User and avatar public pages — SNS badge + pay-by-name modal when `[username].threews.sol` is claimed || **SNS Subdomain** | `/threews/claim` | Mint `[label].threews.sol`, set the URL record to your showcase, transfer ownership — single tx, platform pays || **Dashboard** | `/dashboard`, `/dashboard/actions`, `/dashboard/wallets`, `/dashboard/usage`, `/dashboard/x402` | Account management, settings, and x402 receipts/payouts |-| **Studio / Tools** | `/studio`, `/embed`, `/pose`, `/gestures`, `/choreograph`, `/voice`, `/mocap-studio`, `/hydrate`, `/validation`, `/strategy-lab` | Widget Studio, WYSIWYG embed editor, pose authoring, gesture vocabulary + override builder, routine choreographer, Voice Lab, Mocap Studio, on-chain import, glTF validator, DCA |+| **Studio / Tools** | `/studio`, `/avatar-studio`, `/pose`, `/gestures`, `/choreograph`, `/voice`, `/mocap-studio`, `/hydrate`, `/validation`, `/strategy-lab` | Widget Studio (the WYSIWYG embed builder), Avatar Studio, pose authoring, gesture vocabulary + override builder, routine choreographer, Voice Lab, Mocap Studio, on-chain import, glTF validator, DCA || **Widgets** | `/widgets`, `/w/[id]` | Widget gallery and public widget pages (OG + oEmbed) || **Launchpad** | `/launchpad`, `/p/[slug]` | Launchpad Studio + hosted launch pages (token, agent, drop campaigns) || **Club** | `/club` | Multiplayer 3D venue — tips, leaderboard, audio tracks, perf-aware renderer |@@ -9025,7 +9025,7 @@ For the absolute simplest way to embed an agent, use this snippet. It requires n<script type="module" src="https://three.ws/artifact.js"></script>```-The loader ([public/artifact.js](public/artifact.js)) mounts a rotatable 3D viewer into every `[data-agent-id]` element on the page. You can find your agent ID in the agent's settings page. This method is great for quick integrations on platforms like WordPress, Ghost, or any static HTML site — size it with the `style` attribute. For a configurable snippet (chat mode, environments, size presets), use the [Embed editor](#embed-editor) at `/embed`.+The loader ([public/artifact.js](public/artifact.js)) mounts a rotatable 3D viewer into every `[data-agent-id]` element on the page. You can find your agent ID in the agent's settings page. This method is great for quick integrations on platforms like WordPress, Ghost, or any static HTML site; size it with the `style` attribute. For a configurable snippet (chat mode, environments, size presets), use the [Widget Studio](#embed-editor) at `/studio`.---@@ -9563,19 +9563,20 @@ Widgets are stored as JSON config in Postgres, pointing at an avatar in R2.## Embed Editor-The **Embed editor** at [three.ws/embed](https://three.ws/embed) ([src/editor/embed-editor.js](src/editor/embed-editor.js)) is a WYSIWYG configurator for embedding a three.ws avatar or agent on any website. Pick an avatar from the gallery picker, choose an embed mode, tune the environment and size, and copy a ready-to-paste snippet.+The WYSIWYG embed editor lives in the **Widget Studio** at [three.ws/studio](https://three.ws/studio) ([public/studio/studio.js](public/studio/studio.js)). The standalone `/embed` page merged into it: the bare path 301s to `/studio`, and a parameter-carrying `/embed?…` link rewrites there, because the Studio reads the same parameter names.-[](https://three.ws/embed)+[](https://three.ws/studio)-| Feature | Description |-| -------------------- | ---------------------------------------------------------------------------------------- |-| **Four embed modes** | Static (idle pose), Idle (drifts on its own), Walking (joystick/keyboard), Chat (agent page iframe) |-| **Avatar picker** | Gallery modal (`src/avatar-gallery-picker.js`) — pick any avatar without leaving the page |-| **Live preview** | Renders the exact runtime the snippet ships — `/walk-embed` or `/a/<id>?embed=1` |-| **Environments** | Studio (transparent), Void, Beach, Sunset, Night, Grid |-| **Size presets** | S / M / L plus custom width × height |-| **Snippet UX** | Real clipboard copy of the iframe or script-tag form, with per-platform paste instructions (HTML, React, WordPress, Webflow, Shopify) |-| **Deep-linkable** | Every control reflects into the URL query, so a configured embed can be shared and re-opened |+| Feature | Description |+| --------------------- | ---------------------------------------------------------------------------------------- |+| **Embed modes** | Static (idle pose), Idle (drifts on its own), Walking (joystick/keyboard), Chat (an existing agent's page in an iframe), plus every other widget type |+| **Avatar picker** | Your library, a public-avatar search, or a model URL you host yourself (`.glb`, `.gltf`, `.vrm`) |+| **Live preview** | Renders the exact runtime the snippet ships: `/walk-embed`, `/a/<id>?embed=1`, or `/widget` |+| **Environments** | Studio (transparent), Void, Beach, Sunset, Night, Grid |+| **Size presets** | S / M / L plus custom width × height, and a responsive (fluid) snippet |+| **No account needed** | Walking-avatar and agent-chat bake their config into the embed URL, so the snippet works with no sign-in and no saved widget |+| **Snippet UX** | Real clipboard copy of the iframe or script-tag form, with per-platform paste instructions (HTML, React, WordPress, Webflow, Shopify) |+| **Deep-linkable** | Every control reflects into the URL query, so a configured embed can be shared and re-opened |---diff --git a/data/pages.json b/data/pages.jsonindex 747e002aa..3ceada0d1 100644--- a/data/pages.json+++ b/data/pages.json@@ -743,7 +743,7 @@{"path": "/studio","title": "Widget Studio",- "description": "Pick an avatar, configure embed options, copy a one-line snippet for your site.",+ "description": "Build an embeddable 3D widget: pick an avatar (or your own model URL), pick a widget type, tune it live, and copy the snippet. No account needed for the URL-based embeds.","priority": 0.8,"changefreq": "weekly","added": "2026-05-24"@@ -976,7 +976,7 @@{"path": "/avatar-studio","title": "Avatar Studio",- "description": "Build a custom 3D avatar from scratch. Choose body type, sculpt face and body, add outfits and accessories. No selfie required.",+ "description": "Build a custom 3D avatar from scratch. Sculpt the face and body, dress it from the closet, add accessories, and walk it around the stage. No selfie required.","priority": 0.7,"changefreq": "weekly"},diff --git a/docs/avatar-studio.md b/docs/avatar-studio.mdindex ac8949b33..0e670c462 100644--- a/docs/avatar-studio.md+++ b/docs/avatar-studio.md@@ -1,6 +1,6 @@# Avatar Studio: build a custom avatar from scratch, no selfie-Avatar Studio builds a fully rigged 3D avatar without a photo. You start from a base body and shape it into your own character: tint skin, hair, and outfit; sculpt the face and body with morph sliders; add hats, glasses, and earrings; hide or show garment layers to strip back to the base and build a look up; and drive the rig live with a library of emotes. When you save, the live scene is exported to a GLB exactly as you see it and stored to your account, ready to animate, dress, and use anywhere on the platform.+Avatar Studio builds a fully rigged 3D avatar without a photo. You start from a base body and shape it into your own character: tint skin, hair, and outfit; sculpt the face and body with morph sliders; put on catalog garments from a closet; add hats, glasses, and earrings; hide or show the body's own garment layers to strip back to the base and build a look up; drive the rig live with a library of emotes; and walk the finished avatar around the stage. When you save, the live scene is exported to a GLB exactly as you see it and stored to your account, ready to animate, dress, and use anywhere on the platform.Page: [/avatar-studio](https://three.ws/avatar-studio) (also reachable at [/create/studio](https://three.ws/create/studio))@@ -23,15 +23,21 @@ Every edit updates the live scene graph, and a working "appearance" object track- **Free sculpt.** Above everything else sits a brush for the shapes no catalogue has: a dent in one temple, a crooked bridge, a brow ridge that is simply yours. Turn **Brush on**, then drag on the avatar to pull the surface out or push it in; dragging the background still orbits the camera, so you never lose the view. Size and Strength are real world measurements (centimetres and millimetres per stroke), the on-screen ring shows the brush's actual footprint at the current zoom, and Symmetry mirrors each stroke across the body's own centre line until you turn it off. Playback pauses while the brush is on so the mesh holds still under your cursor. The edit is recorded as its own morph target, which means it adds to the library sliders instead of fighting them, exports with the mesh, and comes back untouched when you re-open the avatar. **Clear sculpt** returns the body to exactly the catalogue shape.- **Proportions.** Above the morph sliders sits a bone-level build panel: Height, Leg Length, Torso Length, Neck Length, Arm Length, Shoulder Width, Hip Width, Head Size, Hand Size, Foot Size. Morphs reshape a limb; these re-proportion the skeleton, which is the only way to actually lengthen one (a morph is a fixed set of vertex deltas, so pulling the hand further from the elbow would drag the skin off the bone driving it). Each slider is a ratio around the base body, shown as a signed percentage, and double-clicking resets it. Lengthen the legs and the hips ride up so the feet stay on the floor, and the animation library re-measures itself against the new hip height so the walk does not foot-slide. Only parameters the loaded rig has bones for are offered.- **Accessories.** Hats, glasses, and earrings load from a preset catalog (`/accessories/presets.json`). Hovering a tile previews it live on the avatar; clicking commits it. Hats and glasses are single-slot; earrings stack. A chip row shows everything applied, each removable.-- **Garment layers.** Outfit, glasses, and hair can be toggled visible/hidden, with bulk "Start minimal" and "Dress fully" actions, so you can strip to the base body and rebuild the look deliberately.+- **Wardrobe.** Two things stacked in one tab. The top half is the body's own garment layers (outfit, glasses, hair): recolour them, toggle each visible or hidden, or use the bulk "Start minimal" and "Dress fully" actions to strip to the base body and rebuild a look deliberately. The layers are resolved from whatever the loaded GLB actually contains rather than a hardcoded material list, so a third-party body still gets real controls. Beneath them is the **Closet**: catalog garments (tops, bottoms, footwear, outerwear, hair, headwear, glasses, accessories) that are downloaded and re-bound to *this* avatar's skeleton at runtime, so they move with every animation. Worn pieces occlude the skin underneath (pixel-exact on the Parametric base, which ships a baked UV region mask; bone-cull elsewhere), appear as removable chips beside the accessory chips, and are stored as `appearance.garments`. The garment contract is [specs/GARMENT_MANIFEST.md](../specs/GARMENT_MANIFEST.md).- **Animate.** Load the shared canonical clip library and drive the rig live with 17 emotes (idle, waiting, chill, wave, cheer, celebrate, flex, jump, pray, blow kiss, taunt, dance, shuffle, rumba, thriller, capoeira). A looping emote becomes the avatar's resting idle and is baked in on save; one-shots play once and settle back to the current idle. This doubles as proof the avatar is fully rigged.+- **Walk.** Take the avatar for a walk without leaving the editor. It auto-walks a circle around the stage and you can drive it with WASD or the arrow keys, in any of the runtime's environments. Every sculpt, colour, garment and accessory edit shows up in motion immediately, which is where foot-slide, clipping and a garment that does not follow the hips actually become visible. In edit mode, **Open in Walk page** stashes the *unsaved* look as a short-lived draft and opens the full [/walk](https://three.ws/walk) page on it, so you review exactly what is on the stage rather than the last save. In create mode there is no saved record to build that draft from, so the panel says so instead of offering a button that would fail.+- **Rig** (edit mode only). Rig status for the loaded avatar plus one-click auto-rigging for a static mesh that has no skeleton and therefore cannot walk, wave, or emote. Rigging is non-destructive: it mints a new sibling avatar and opens the studio on it, leaving the original mesh untouched.- **Randomize.** One button rolls a random swatch per color slot, a gentle draw on every proportion parameter, and a random hat and glasses, as a starting point. The proportion draw stays near neutral on purpose: two random avatars should read as different people, not different species.The studio has 50-deep undo/redo, a dirty-state indicator in the title bar, and a draft autosave to local storage that is offered back if you leave and return (in create mode).### Save-Saving does not ask a server to re-bake anything. The live Three.js scene, with colors, morphs, and accessories already applied to the scene graph, is exported via `GLTFExporter`, so the resulting GLB is exactly what you saw. It runs through the shared optimize-and-validate path (geometry compression, `gltf-validator`), uploads to your account, and creates or (in edit mode) updates the avatar record. The appearance JSON is stored alongside as metadata so the avatar stays re-editable.+Saving takes one of two paths, and which one it takes matters.++**Creating a new avatar** exports the live Three.js scene via `GLTFExporter`, with colors, morphs and accessories already applied to the scene graph, so the resulting GLB is exactly what you saw. It runs through the shared optimize-and-validate path (geometry compression, `gltf-validator`), uploads to your account, and creates the avatar record. The appearance JSON is stored alongside as metadata so the avatar stays re-editable. Closet garments are the one exception: they are taken off the rig for the duration of the export and put straight back afterwards, because the appearance record carries them and the server bake replays them onto the base. Exporting a dressed body would apply every garment twice, onto a base you could never get back.++**Editing a saved avatar** does not export geometry at all. The record keeps its original, pristine base model and the server bakes the appearance onto it, so this is a metadata-only `PATCH` of `{ name, appearance }`. That is also why the base body cannot be switched while editing: a saved avatar owns its base.## Walkthrough@@ -39,16 +45,18 @@ Saving does not ask a server to re-bake anything. The live Three.js scene, with2. On the Color tab, tap a Look (say, Cyber) for an instant coherent palette, then fine-tune skin, hair, and outfit with the swatches or the rainbow chip's full picker.3. Open the Face tab and sculpt: widen the jaw, adjust the nose, nudge body shape. Use the face-type wheel to blend archetypes.4. Add a hat and glasses from their tabs; hover to preview, click to keep. Add earrings if you want.-5. Use the Layers block to hide the outfit and rebuild it, or leave it dressed.+5. On the Wardrobe tab, hide the base outfit and put on a shirt and boots from the closet, or leave the avatar in what it came with.6. On the Animate tab, pick a looping emote (for example, Dance) to set the avatar's resting idle.-7. Name it and click Save. The studio exports, optimizes, uploads, and lands you with a saved avatar you can animate and dress elsewhere.+7. Open the Walk tab and drive the avatar around with WASD to check the outfit moves with it.+8. Name it and click Save. The studio exports, optimizes, uploads, and lands you with a saved avatar you can animate and dress elsewhere.## ExamplesAvatar Studio is an interactive builder; its examples are its entry points and the account API it saves through.- **Create a new avatar:** [https://three.ws/avatar-studio](https://three.ws/avatar-studio) or [https://three.ws/create/studio](https://three.ws/create/studio)-- **Edit a saved avatar:** `https://three.ws/avatar-studio?edit=<avatarId>`: reloads that avatar's appearance and updates the existing record on save.+- **Edit a saved avatar:** `https://three.ws/avatar-studio?edit=<avatarId>`: reloads that avatar's appearance and updates the existing record on save. Edit mode also adds the Rig tab and a **Play as this** button that saves and drops you into [/play](https://three.ws/play) wearing the avatar.+- **Arrive wearing something:** `https://three.ws/avatar-studio?edit=<avatarId>&equip-glb=<url>&equip-kind=hat&equip-name=Top%20hat` pre-applies an accessory GLB that is not in the preset catalog and marks the avatar unsaved, so a gallery "Equip" tile can hand off straight into the studio. `equip-kind` is `hat`, `glasses` or `earrings` (default `hat`); `equip-bone` overrides the attach bone (default `Head`). The avatar editor at `/avatars/<avatarId>/edit` accepts the identical parameters.Fetching an avatar record (the same call the studio makes to load edit mode):@@ -66,6 +74,8 @@ curl 'https://three.ws/api/avatars/<avatarId>' -H 'cookie: <session>'- **Sculpt depends on the base's morphs.** The face/body sliders render against whatever morph targets the base GLB exposes; a slot with no matching morph simply does not appear. Proportions are independent of morphs: they need only a canonical humanoid skeleton, so they work on a rig with no blendshapes at all. Height is the one parameter that needs an armature node above the hips, and is hidden on rigs whose hips sit directly in the scene.- **Save requires an account.** Export happens client-side, but persisting the avatar to your library needs sign-in. Optimization is best-effort: if compression fails, the original export is saved untouched so the save always completes.- **What you see is what you save.** Because the save exports the live scene graph, the stored GLB matches the viewport exactly, colors, morphs, accessories, and the chosen idle included.+- **The Rig and Play tabs need a saved avatar.** Auto-rigging posts the avatar's id to the regenerate backend and the /walk handoff presigns that avatar's private base GLB, so neither exists for an unsaved draft. The Rig tab is hidden in create mode and the Walk tab swaps its handoff button for the reason.+- **A garment needs a humanoid skeleton to bind to.** The closet refuses a piece it cannot rebind rather than attaching it mangled, and a retired catalog id degrades to "not worn" on load instead of failing the whole avatar. Re-dressing a saved outfit runs alongside the boot rather than blocking it, so the avatar is live and animating while the pieces land.- **Drafts are local.** Unsaved work autosaves to local storage in create mode and is offered back on return; edit mode does not autosave a draft over the saved avatar.## Relateddiff --git a/docs/build.md b/docs/build.mdindex f8256ff72..85c22ba52 100644--- a/docs/build.md+++ b/docs/build.md@@ -139,8 +139,8 @@ head -1 api/<route>.js # bundle if it starts with __defProp / createRequire /## Embed integrity-Embed surfaces (`/widget`, `/embed`, `/agent-embed`, `/a-embed`,-`/avatar-embed`, `/agent-token-page`, `/assistant-frame`) load inside third-party iframes. They must+Embed surfaces (`widget.html`, `embed.html`, `agent-embed.html`, `a-embed.html`,+`avatar-embed.html`, `agent-token-page.html`, `assistant-frame.html`) load inside third-party iframes. They must**not** register the service worker — an SW registered from an iframe is scopedto `https://three.ws/` and would intercept every other tab on the origin.diff --git a/docs/openai-community-3d-studio-post.md b/docs/openai-community-3d-studio-post.mdindex 6113493aa..62672366b 100644--- a/docs/openai-community-3d-studio-post.md+++ b/docs/openai-community-3d-studio-post.md@@ -198,7 +198,7 @@ A generated model is not a dead end. Each of these is a live page that consumes## 5. Distribution: the `<agent-3d>` web component and the SDKs-A generated avatar is not locked into the platform. `<agent-3d>` is a framework-free custom element that embeds a live, animated avatar in any page with one script tag; it lazy-boots on intersection so off-screen agents cost nothing, and animations, moods and speech are drivable from page JavaScript. Five widget variants (turntable, animation gallery, talking agent, passport card, hotspot tour), a WYSIWYG embed editor at `/embed`, Open Graph and oEmbed so world and creation links unfurl as interactive 3D in WordPress, Ghost, Discord, dev.to and Notion, and versioned CDN bundles at `/agent-3d/x.y.z/agent-3d.js`.+A generated avatar is not locked into the platform. `<agent-3d>` is a framework-free custom element that embeds a live, animated avatar in any page with one script tag; it lazy-boots on intersection so off-screen agents cost nothing, and animations, moods and speech are drivable from page JavaScript. Five widget variants (turntable, animation gallery, talking agent, passport card, hotspot tour), a WYSIWYG embed editor in the Widget Studio at `/studio`, Open Graph and oEmbed so world and creation links unfurl as interactive 3D in WordPress, Ghost, Discord, dev.to and Notion, and versioned CDN bundles at `/agent-3d/x.y.z/agent-3d.js`.The frontend philosophy is worth stating: vanilla JavaScript modules built with Vite, three.js for rendering, Rapier compiled to WebAssembly for physics, Draco/KTX2/Meshopt decoders, no heavyweight framework. That is what makes the embed story credible; the components carry no runtime tax onto host pages. The viewer targets every browser with WebGL 2.0 and refuses to boot without it rather than rendering a broken canvas.diff --git a/docs/ux-flows/04-embed-widget-studio.md b/docs/ux-flows/04-embed-widget-studio.mdindex b1026bb92..c8776df0b 100644--- a/docs/ux-flows/04-embed-widget-studio.md+++ b/docs/ux-flows/04-embed-widget-studio.md@@ -13,7 +13,8 @@ Routing recap (from `vercel.json`):| `/avatar-studio`, `/create/studio` | `pages/avatar-studio.html` (+ `src/avatar-studio.js`) — **Avatar Studio** (appearance builder; feeds the embed flows) || `/w/<id>` | saved widget page (live widget) || `/widget`, `/widget.html` | slim viewer shell (`/src/app.js`) used as Studio/gallery preview iframe + script-tag embed target |-| `/agents/<id>/embed` (the legacy `/agent/<id>/embed` still serves the same page), `/embed/avatar/<handle>`, `/embed`, `/a-embed.html` | embed iframe targets |+| `/agents/<id>/embed` (the legacy `/agent/<id>/embed` still serves the same page), `/embed/avatar/<handle>`, `/a-embed.html` | embed iframe targets |+| `/embed` | **retired.** The standalone embed editor merged into the Widget Studio. The bare path 301s to `/studio`; a parameter-carrying form (`?mode=`, `?avatar=`, `?id=`) rewrites into `/studio/index.html`, which reads the same parameter names, so every saved `/embed?…` URL still lands on the configuration it described. `/embed/v1.js`, `/embed/avatar`, `/embed/walk/` and the other `/embed/*` runtimes are unaffected. || `/embed.js`, `/embed-sdk.js`, `/artifact.js`, `/dist-lib/agent-3d.js` | embed loader / SDK / web-component scripts |> Naming note: the prompt's "avatar-studio embeddable AI widget builder" maps to the **Widget Studio** at `/studio` (the talking-agent widget type is the embeddable AI widget). `/avatar-studio` is the **appearance builder** — it produces the avatar that the Studio and embed panels then wrap. Both are documented below.@@ -22,19 +23,19 @@ Routing recap (from `vercel.json`):### Widget Studio — `/studio`- **Source:** `public/studio/index.html`, `public/studio/studio.js`, `public/studio/studio.css`, `public/studio/launch-panel.js`, `public/studio/knowledge-panel.js`. Preview iframe loads `/widget` (slim `src/app.js` shell). APIs: `/api/auth/me`, `/api/avatars`, `/api/avatars/public`, `/api/avatars/:id`, `/api/widgets`.-- **Entry point:** Direct nav to `/studio`; "Create yours" / "Open the Studio" CTAs on `/widgets`; "Open Studio →" on `/features/studio`; "Open in Studio" links from gallery cards (`/studio?template=<id>`); deep links `?edit=<id>`, `?type=<type>`, `?model=<url>`, `?avatar=<id>`.-- **Prerequisites / gates:** None to try: a built-in **demo avatar (CZ, `/avatars/cz.glb`)** is preloaded so an anonymous visitor can configure and preview. **Saving a draft / embedding a non-demo avatar requires sign-in** (`/login?next=/studio`) and an owned/public avatar. The demo avatar can generate an embed (pointing at a baked demo fixture, e.g. `wdgt_demo_talking`) but cannot save. No $THREE gate. ⚡ Launch tab can optionally launch the agent's coin via `launch-panel.js` (lane toggle: pump.fun or the three.ws curve; oversized token images are downscaled in-browser instead of rejected).+- **Entry point:** Direct nav to `/studio`; "Create yours" / "Open the Studio" CTAs on `/widgets`; "Open Studio →" on `/features/studio`; "Open in Studio" links from gallery cards (`/studio?template=<id>`); the "Configure in wizard" links on avatar/agent pages and the dashboard; deep links `?edit=<id>`, `?type=<type>`, `?model=<url>`, `?avatar=<id>`, plus the inherited embed-editor form `?mode=static|idle|walking|chat` with `?avatar=`, `?controls=`, `?env=`, `?bg=`, `?width=`, `?height=`, `?autoplay=`, `?speed=`, `?ground=`, `?gestures=`, `?badge=`. Those same names are written back into `location.search` as you edit a URL-baked widget, so a configured studio URL is itself a shareable artifact.+- **Prerequisites / gates:** None to try, and for two widget types, none to finish. A built-in **demo avatar (CZ, `/avatars/cz.glb`)** is preloaded so an anonymous visitor can configure and preview. The **walking-avatar** and **agent-chat** types bake their whole configuration into the embed URL, so a signed-out visitor can configure, generate and copy a working snippet with no account and no database row (the modal hides the `/w/<id>` share URL and the script-tag snippet, which do need one, and says what signing in adds). Every other type stores config server-side, so **saving a draft or embedding with them requires sign-in** (`/login?next=/studio`) and an owned/public avatar. The demo avatar can generate an embed (pointing at a baked demo fixture, e.g. `wdgt_demo_talking`) but cannot save. No $THREE gate. ⚡ Launch tab can optionally launch the agent's coin via `launch-panel.js` (lane toggle: pump.fun or the three.ws curve; oversized token images are downscaled in-browser instead of rejected).- **Steps (10):**1. Page boots → `fetchMe()` (`/api/auth/me`) resolves user; user menu renders (signed-out shows "Sign in"); 3-column layout unhides.- 2. System renders the **widget-type grid** (10 ready types: turntable, animation-gallery, talking-agent, passport, hotspot-tour, pumpfun-feed, kol-trades, live-trades-canvas, bonding-curve, walking-avatar) and **avatar list** (`loadAvatars()` → demo avatar + `/api/avatars?limit=100` for signed-in users, with skeleton cards while loading).- 3. **Pick avatar** (step-1 panel): click an avatar card → `selectAvatar()`; or `(optional)` search public avatars (`/api/avatars/public?q=`) and pick one; demo avatar is selected automatically if none chosen.+ 2. System renders the **widget-type grid** (11 ready types: turntable, animation-gallery, talking-agent, passport, hotspot-tour, pumpfun-feed, kol-trades, live-trades-canvas, bonding-curve, walking-avatar, agent-chat) and **avatar list** (`loadAvatars()` → demo avatar + `/api/avatars?limit=100` for signed-in users, with skeleton cards while loading).+ 3. **Pick avatar** (step-1 panel): click an avatar card → `selectAvatar()`; or `(optional)` search public avatars (`/api/avatars/public?q=`) and pick one; or `(optional)` paste a **model URL** you host yourself (`.glb`, `.gltf`, `.vrm`) and press Use, which previews it and points the snippet straight at that URL without uploading anything (if the URL happens to be one of your own stored models it is registered as a real avatar instead). Demo avatar is selected automatically if none chosen. The whole panel is hidden for **agent-chat**, which renders whatever avatar its agent already owns.4. **Pick widget type** (step-2 panel): click a type card → `selectType()` rebuilds the type-specific config fields, preserving brand settings.5. System loads the **live preview** in the `/widget` iframe (`updatePreview()` builds `#model=…&kiosk=true&type=…`), posts the config via `postMessage({type:'widget:config'})`; status flips to "Live preview".6. **Configure Brand** (step-3): name, background color, accent, optional caption, show-controls, auto-rotate, environment preset, public toggle — every input debounces (`schedulePreview`, 200 ms) and re-posts config to the preview.7. `(optional)` **Configure type fields**: e.g. talking-agent gets agent name/title, greeting, system prompt, LLM provider (Anthropic/OpenAI/watsonx/Groq/OpenRouter/custom proxy), skills, voice in/out, rate limits, and a **Knowledge panel** (RAG docs) once saved; passport gets chain/agentId/wallet; mint-based types get a Solana mint address.8. `(optional)` **Frame the camera**: drag in the preview, click "Use current view" → reads `previewIfr.contentWindow.VIEWER.viewer.activeCamera`, stores `cameraPosition`. `(optional)` switch device frame (desktop/tablet/mobile).9. `(optional)` **Save draft** → POST/PATCH `/api/widgets` (requires sign-in + name); URL gets `?edit=<id>`, "View live" (`/w/<id>`) + "Delete" actions appear.- 10. **Generate embed** → saves (or, for demo avatar, resolves the baked fixture) then opens the **embed modal**: shareable URL `/w/<id>`, width/height inputs, per-type include toggles (animations / chat / controls), **iframe snippet**, and a **script-tag snippet** (`<script async src="/embed.js" data-widget="<id>">`). Copy → paste on any site. Done.+ 10. **Generate embed** → saves (or, for the demo avatar, resolves the baked fixture; or, for a URL-baked type with no account, skips the save entirely) then opens the **embed modal**: shareable URL `/w/<id>`, width/height inputs, per-type include toggles (animations / chat / controls), **iframe snippet**, a **script-tag snippet** (`<script async src="/embed.js" data-widget="<id>">`), and **platform paste instructions** (HTML, React, WordPress, Webflow, Shopify). Copy → paste on any site. Done.- **Decision points / branches:**- Demo avatar → embed allowed (baked fixture, tweaks not saved, modal shows "upload your own" note) but save blocked.- Signed-out + non-demo save/generate → redirect to `/login?next=…`.@@ -114,7 +115,7 @@ Routing recap (from `vercel.json`):- **Prerequisites / gates:** Must be on an **existing agent** with a public GLB. No sign-in required to copy snippets; embedding is free (no wallet or on-chain deployment required). No $THREE gate. An owner who switched embedding off in the embed policy (`/api/agents/<id>/embed-policy`) hides the profile card (`data-embed-disabled`).- **Steps (4):**1. Open the agent's studio page → switch to the **Embed** view (or open the profile and scroll to "Embed").- 2. Read the intro ("Drop this <agent|avatar> on any website. Use the wizard for a live preview and platform instructions.") and, `(optional)`, click **Configure in wizard ↗** → `/embed?…` (the walk-through embed wizard) in a new tab.+ 2. Read the intro ("Drop this <agent|avatar> on any website. Use the wizard for a live preview and platform instructions.") and, `(optional)`, click **Configure in wizard ↗** → `/studio?…` in a new tab (an agent opens the Agent Chat widget type, an avatar opens the walking-avatar embed).3. Choose a snippet and **Copy** (button flips to "Copied ✓", reverting after ~1.8s): **Web component** (`<script type="module" src="https://three.ws/dist-lib/agent-3d.js">` + `<agent-3d src="<glb>" agent-id="…">`), **iframe** (studio page: `<iframe src="/agents/<id>?embed=1">`, the page hides its chrome in embed mode; profile card: `<iframe src="/agents/<id>/embed" width="480" height="640">`), the **page link**, or (studio page) the **Terminal** snippet that runs the avatar in any terminal with no browser or GPU (see `/docs/tty-avatar`).4. Paste the iframe or `<agent-3d>` snippet on any third-party site → the agent renders inline (`/agents/<id>/embed` runs `src/avatar-embed.js` / the element runtime, exposing the `v1.avatar.*` postMessage bridge). Done.- **Decision points / branches:**diff --git a/pages/assistant.html b/pages/assistant.htmlindex 8cd6dac25..261ac13aa 100644--- a/pages/assistant.html+++ b/pages/assistant.html@@ -420,7 +420,7 @@</section><p class="docs-link" data-i18n-html="assistant.docs_developer_docs_related_3d_embeds_walkin">- Docs: <a href="/docs">developer docs</a> · Related: <a href="/embed">3D embeds</a> ·+ Docs: <a href="/docs">developer docs</a> · Related: <a href="/studio">3D embeds</a> ·<a href="/walk-embed">walking avatar embed</a> · <a href="/widget">creator widgets</a></p></main>diff --git a/pages/create.html b/pages/create.htmlindex 91d57de22..30f9fa4e3 100644--- a/pages/create.html+++ b/pages/create.html@@ -1832,8 +1832,9 @@</div></div>- <p class="create-footnote" data-i18n-html="create.need_a_model_to_upload_build_one">- Need a model to upload? Build one in <a href="/studio">three.ws Studio</a>.+ <p class="create-footnote" data-i18n-html="create.need_a_model_to_upload_build_one_v2">+ Need a model to upload? Build one in <a href="/avatar-studio">Avatar Studio</a>+ or generate one in <a href="/forge">Forge</a>.Bringing an avatar from another platform?<a href="/import/rpm">import it here</a>.</p>diff --git a/pages/marketplace.html b/pages/marketplace.htmlindex c8d681474..0cc78f359 100644--- a/pages/marketplace.html+++ b/pages/marketplace.html@@ -3786,7 +3786,7 @@<div data-panel="embed" class="market-panel"><div style="display:flex;align-items:flex-start;justify-content:space-between;gap:12px;flex-wrap:wrap;margin-bottom:4px"><h2 style="margin:0" data-i18n="marketplace.embed_this_agent">Embed this Agent</h2>- <a id="d-embed-wizard-link" href="/embed" class="btn-secondary" style="font-size:12px;padding:5px 12px;white-space:nowrap" target="_blank" rel="noopener" data-i18n="marketplace.configure_in_wizard">+ <a id="d-embed-wizard-link" href="/studio" class="btn-secondary" style="font-size:12px;padding:5px 12px;white-space:nowrap" target="_blank" rel="noopener" data-i18n="marketplace.configure_in_wizard">Configure in wizard ↗</a></div>diff --git a/pages/walk-embed.html b/pages/walk-embed.htmlindex 0f68515f0..c91540627 100644--- a/pages/walk-embed.html+++ b/pages/walk-embed.html@@ -282,7 +282,7 @@<div id="walk-status">loading avatar…</div><!-- Attribution / made-with badge. Removed when ?badge=false. -->- <a id="walk-badge" href="https://three.ws/embed?ref=walk-embed" target="_blank" rel="noopener" title="Make your own — three.ws" data-i18n-html="walk_embed.three_ws" data-i18n-attr="title:walk_embed.make_your_own_three_ws_title">+ <a id="walk-badge" href="https://three.ws/studio?ref=walk-embed" target="_blank" rel="noopener" title="Make your own, at three.ws" data-i18n-html="walk_embed.three_ws" data-i18n-attr="title:walk_embed.make_your_own_three_ws_title"><span class="badge-dot" aria-hidden="true"></span><span>three.ws</span></a>diff --git a/prompts/finish/roadmap-00-README.md b/prompts/finish/roadmap-00-README.mdindex 9ed4f84bf..c78c639e5 100644--- a/prompts/finish/roadmap-00-README.md+++ b/prompts/finish/roadmap-00-README.md@@ -2,6 +2,21 @@> Retirement note (2026-07-28): work orders verified fully shipped were deleted from this pack per owner directive; their files remain in git history. Links below to missing files refer to retired, completed work orders. Remaining files are open or partial.+> **creation-consolidation closed 2026-09-03.** Both blocked redirects shipped once the capability+> gaps behind them were closed. Avatar Studio reached edit-mode parity with the avatar editor+> (wardrobe + closet, auto-rig, walk preview, "Play as this", `?equip-*`), and the Widget Studio+> absorbed the `/embed` editor (no-account snippets, an Agent Chat widget type, deep-linkable+> config on the same parameter names, raw GLB/VRM URLs, platform paste instructions), so `/embed`+> now 301s to `/studio` with `has`-gated rewrites for every parameter-carrying form. Two placement+> decisions were resolved in place: `/start` **stays** as guided onboarding (it is the onboarding+> tour's target and composes the canonical `/api/agents`; the alternative, retiring it, would have+> broken the tour, the `/features` CTAs, the sitemap and the localized page set), and `/pose`+> **stays in Build** under `tier: 'advanced'` (it already appeared exactly once in `public/nav-data.js`,+> and it is the most-linked authoring tool on the site; the alternative, Labs-only, would bury it).+> The bare `/avatar-edit` landing keeps its existing 301 to `/dashboard/avatars` rather than moving+> to `/avatar-studio`: a bare `/avatar-edit` means "edit one of my avatars", and Studio's create+> mode answers a different question. Route contract: `tests/creation-surface-redirects.test.js`.+Each file here is a **self-contained prompt** you paste into a fresh Claude Code chat in this repo. Each one improves an existing surface or adds a new 3D / crypto / AI capability — **additively, without breaking the current architecture.**Read this file once; every prompt assumes it.@@ -72,7 +87,6 @@ retired; they remain readable in git history| File | Owns | State ||---|---|---|| [generation-suite.md](roadmap-generation-suite.md) | Meshy and Tripo class parity, and production truth for every generation endpoint | Open. Step 0 and tasks 1 and 2 are done (2026-09-03): the truth table was rebuilt from live probes, and every row is green except the undeployed talking-avatar lane. That sweep found the default free image lane failing 44 of 49 generations for 12 hours while every status surface read green; it is restored and hardened, and `trellis_selfhost` now has a live health probe. Tasks 3 to 8 (pipeline tools in `/forge`, preview then refine, export formats, PBR controls, job webhooks, community gallery) are untouched. |-| [creation-consolidation.md](roadmap-creation-consolidation.md) | The last three creation-surface merges | Open. Two redirects are blocked behind real capability gaps, and closing those gaps is the work. || [developer-resources-repos.md](roadmap-developer-resources-repos.md) | The public examples satellite repo and its one-way export | Done, retired 2026-09-03. `npm run export:satellites` stages 72 files and passes all four smoke stages; the docs, `llms.txt` and `llms-full.txt` cross-links are live. Only the owner-gated publish remains (create the `three-ws` org, run the printed push), tracked as row 16 of [production-100-OWNER-ACTIONS.md](production-100-OWNER-ACTIONS.md). || [native-widgets.md](roadmap-native-widgets.md) | Native widgets on the Android, Windows, macOS and iOS home screens | Built, all four surfaces. Android and Windows are live in production; the Apple sources are in `apple/`. Open only on what code cannot do: an Apple Developer account to sign the two binaries (owner action 17) and a Windows 11 machine for the in-board check. |diff --git a/prompts/finish/roadmap-creation-consolidation.md b/prompts/finish/roadmap-creation-consolidation.mddeleted file mode 100644index 820e80a46..000000000--- a/prompts/finish/roadmap-creation-consolidation.md+++ /dev/null@@ -1,160 +0,0 @@-# RM-CONSOL: Creation surface consolidation, the remaining three--**How to run this:** paste this whole file into a fresh Claude Code chat opened in-`/workspaces/three.ws`, or say "execute `prompts/finish/roadmap-creation-consolidation.md`".-It is complete on its own. Also read `prompts/finish/roadmap-00-README.md` and `CLAUDE.md`.--## Binding operating clause--1. Finish 100%. Never end with a question, a plan you did not execute, or "should I proceed?".-2. These are live production routes with real traffic. Additive first, redirect last, and never- ship a redirect whose destination loses a capability the old route had. Two redirects were- deliberately NOT shipped for exactly that reason; the reasons are recorded below and they- are the work, not an excuse.-3. CLAUDE.md hard rules: no mocks, no TODO comments, no commented-out code, no em-dash or- en-dash characters. Stage explicit paths only.--## Where this stands (verified through 2026-07-29, re-verify before acting)--Shipped: `/create` is the intent hub, nav restructured, `/agent/new` 301s to `/create-agent`-(with `has`-gated rewrites preserving the `avatar_id` / `avatar_glb` handoff), `/scan` 301s to-`/create/selfie`, `/create/character` and `/create-character` 301 to `/play`, the standalone-`/avatar-edit` landing 301s to `/avatars`, `/bulk-launch` is admin-only, and every pipeline-handoff in the target IA is wired (photo to avatar to agent to voice, embed, world, token).--One mechanical fact that governs every remaining redirect: `server/index.mjs` matches-`vercel.json` `routes` against the pathname only and emits `Location` verbatim, so a-status-only route **drops the query string**. Any retired route carrying meaningful params-needs a `has`-gated rewrite for the param form plus a 301 for the bare form.--## Task 1: Avatar Studio edit-mode parity, then retire `/avatar-edit` for real--The redirect was unsafe because Avatar Studio's edit mode **lost data**, not merely features.-**Steps 1 and 2 shipped 2026-08-02; steps 3 and 4 remain, and the redirect stays unshipped-until they land.**--Ship, in this order:--1. **DONE (2026-08-02).** Appearance round-trip fidelity. `collapseAppearance` /- `hydrateAppearance` / `cloneAppearance` in `src/avatar-studio-utils.js` now carry `outfit`- and `garments` verbatim (garment entries deep-copied), so the wardrobe survives a Studio- save. `resetAll()` clears only what Studio controls and leaves the wardrobe alone; the- history stack round-trips both because it clones. Covered in- `tests/avatar-studio-save.test.js`: a dressed appearance round-trips to deep equality, a- dressed avatar equals its own clone (so loading one does not read as dirty), and losing the- garments registers as a real difference.-2. **DONE (2026-08-02).** Non-destructive save. Edit mode no longer exports the live scene:- `saveAvatar()` branches to `patchEditedAvatar()`, which PATCHes `{ name, appearance }` and- lets the server bake rebuild the dressed GLB from the pristine base, exactly like- `avatar-edit`. This also removed a double-application bug that predated the garment issue:- the old path uploaded an already-dressed scene export over the base and the appearance PATCH- that followed baked the same appearance onto it a second time (doubled colour multiplies,- duplicated accessories). `uploadEditedAvatar()` is deleted. The base body cannot be switched- in edit mode (`bindBaseSwitch` hides the control), so there was never new geometry to upload.- Two adjacent fixes fell out: a name-only edit now saves (the old dirty check compared- appearance only, and `handleGlbPatch` dropped the `name` field it was sent), and the- thumbnail snapshot is skipped when the avatar wears layers Studio does not draw, so a save- cannot replace a dressed thumbnail with an undressed one.-3. Port the missing panels: the wardrobe and closet (8 garment slots with occlusion masking,- resolved on arbitrary GLBs by `src/avatar-wardrobe.js`, not hardcoded material names), the- auto-rig tab, the walk preview and the "Play as this" handoff, and `?equip-*` support.-4. Only then: 301 the bare `/avatar-edit` path to the studio and keep a `has`-gated rewrite for- the legacy `?id=` form. Verify with `curl -I` and by opening a real dressed avatar, saving,- and confirming the garments survive.--## Task 2: `/embed` to `/studio`, the four structural gaps--The parity work already shipped (ground disc, gesture buttons, badge, responsive snippet on the-`walking-avatar` type), but `/studio` still cannot do `/embed`'s job. Close these, then redirect:--1. **No-account snippet generation.** `/embed` is fully client-side: configure, copy, leave.- `/studio` must persist a widget row before `openEmbedModal` can emit anything. Build a guest- mode so the snippet works with no sign-in.-2. **Chat mode.** `/embed`'s `chat` mode emits `<iframe src="/a/<agentId>?embed=1">`. Studio's- `talking-agent` is a different runtime and cannot produce that URL. Add a chat widget type.- `src/dashboard-next/pages/agents.js` links `/embed?avatar=...&mode=chat` today.-3. **Deep-linkable config.** `/embed` reflects every control into `location.search` and- rehydrates from it, so a configured editor URL is itself a shareable artifact. `/studio`- reads only `edit`, `template`, `type`, `model`, `avatar`. Add a config-URL layer that reads- and writes the same params `/embed` uses, so the `has`-gated rewrite can carry them.-4. **Raw GLB or VRM URL as the avatar**, plus the platform paste instructions (HTML, React,- WordPress, Webflow, Shopify), have no Studio equivalent. Port them.-5. Mechanical detail that must land in the same change: `walk-sdk/src/config.js` suppresses the- corner companion on paths prefixed `/embed`; moving the editor under `/studio` needs that- list updated or the companion appears inside the editor.--Only after all five: 301 the bare path, `has`-gated rewrite for the param-carrying form, and-verify every saved `/embed?...` URL shape still lands somewhere that reproduces its config.--## Task 3: the two open placement decisions--Decide both yourself using the most reversible option, implement it, and record the decision-plus the alternative in the report. Do not ask.--1. **`/start`**: keep it as guided onboarding that wraps the canonical `/create-agent` wizard- (never a parallel implementation), or retire it now that the hub exists. Check its real- traffic and inbound links first.-2. **`/pose`**: it currently appears in both Build and Labs in `public/nav-data.js`. It is a- tool, not an intent, so it belongs in Labs only unless the data says otherwise.--## Definition of done--- [ ] Every redirect you ship returns 301 to a live page (`curl -I`), and every param-carrying- form still works through its rewrite.-- [ ] A real dressed avatar survives an Avatar Studio edit and save with garments and outfit- intact, proven in a browser and by test.-- [ ] `/studio` produces a working snippet with no account, in chat mode, from a raw GLB URL,- and from a deep-linked config URL.-- [ ] `public/nav-data.js` has no link to a retired URL, and- `grep -rn "<retired-path>" pages/ public/ docs/ src/` finds nothing.-- [ ] `data/pages.json` updated; `npm run build:pages` green; `npm run audit:web` green on every- touched page; `npm run audit:links` clean.-- [ ] `data/changelog.json` entry for each user-visible merge.-- [ ] `npm run check:rules -- --paths <files you touched>` clean.--## Never blocked (pre-answered)--| Blocker | Do this |-|---|---|-| A redirect would lose a capability | Then it is not ready. Build the capability first, in the same session, and ship the redirect after. That is this whole work order. |-| Uncertain which surface wins a merge | Pick the one the code already favors (what users actually reach today), implement it, and record the alternative. |-| A page under `public/*.html` is not in the Vite graph | Test that it still renders after any change; the raw-`/src` import trap silently kills such pages. |-| Traffic data is unavailable | Use inbound-link count from `grep -rn` across `pages/`, `public/`, `docs/`, `src/` as the proxy and say so. |-| Another agent is editing a page you need | Re-read the file immediately before each edit; stage only your own paths. |--## Appendix: the target information architecture (unchanged)--```-/create-├── Build an AI agent -> /create-agent-├── Make a 3D avatar-│ ├── From a photo -> /create/selfie (camera + upload, canonical)-│ ├── From scratch -> Avatar Studio-│ ├── From a text prompt -> /forge (avatar preset)-│ └── From a file or URL -> upload (absorbs /import/rpm)-├── Generate a 3D model -> /forge-└── Launch a token world -> /launchpad (and /play for worlds)-```--Completion states hand off to the next stage: avatar to agent, agent to voice, embed, world and-token, voice to agent, studio snippet to playground, avatar detail to editor. All of those are-shipped; keep them working.--## Retire this prompt when it is done (required)--1. Verify every Definition of done line against actual command output in front- of you. Never claim a line you did not verify.-2. Record the outcome in this campaign's PROGRESS or INDEX file if it has one.-3. Commit with explicit paths and a subject that describes the diff (house- style: type(scope): what changed and why a reader cares), and delete this- prompt file in that same commit:-- git rm prompts/finish/roadmap-creation-consolidation.md-- A finished order left on disk reads as open work to the next agent, so the- shrinking directory is the campaign's progress ledger.--If a line genuinely cannot pass inside this session (an external party must-respond, or an owner-gated action is the final step), finish everything else,-leave this file in place, and state exactly which line remains and who owns it.-Never delete this file on a partial.diff --git a/public/examples.js b/public/examples.jsindex 6048b21a5..0ab273d2c 100644--- a/public/examples.js+++ b/public/examples.js@@ -248,7 +248,7 @@blurb: 'The loader mounts a rotatable 3D viewer into every [data-agent-id] element on the page. Great for WordPress, Ghost, or any static site.',tags: ['widget', 'no-build'],docs: [- { label: 'Embed editor', href: '/embed' },+ { label: 'Embed editor', href: '/studio' },{ label: 'Share your agent', href: '/tutorials/share-your-agent' },],github: 'https://github.com/nirholas/three.ws/blob/main/public/artifact.js',diff --git a/public/feature-discovery.js b/public/feature-discovery.jsindex 0b9b9beff..ce2d6e0e2 100644--- a/public/feature-discovery.js+++ b/public/feature-discovery.js@@ -54,8 +54,9 @@var FEATURES = {'/forge': { label: 'Forge', desc: 'Turn a text prompt into a textured 3D model.' },'/create/prompt': { label: 'Describe it to 3D', desc: 'Type a description → a rigged 3D avatar.' },- '/scan': { label: 'Scan', desc: 'Turn a selfie into a rigged 3D avatar.' },- '/studio': { label: 'Studio', desc: 'Customize your avatar and grab an embed for any site.' },+ '/create/selfie': { label: 'Selfie to avatar', desc: 'Turn a selfie into a rigged 3D avatar.' },+ '/studio': { label: 'Widget Studio', desc: 'Build an embeddable 3D widget and copy the snippet for any site.' },+ '/avatar-studio': { label: 'Avatar Studio', desc: 'Sculpt, dress and animate an avatar from scratch, no selfie.' },'/scene': { label: 'Scene Studio', desc: 'Import GLBs, compose full 3D scenes, and export.' },'/play': { label: 'Worlds', desc: 'Drop into a live 3D world and hang out.' },'/walk': { label: 'Walk', desc: 'Walk your avatar across any page on the site.' },@@ -68,8 +69,6 @@'/gmgn': { label: 'GMGN Smart Money', desc: 'Track what smart-money wallets are buying.' },'/skills': { label: 'Skills', desc: 'Browse tool packs your agents can equip.' },'/brain': { label: 'Brain', desc: 'Compare one prompt across Claude, GPT and more.' },- '/embed': { label: 'Embed', desc: 'Put your live agent on any website.' },- '/embed.html': { label: 'Embed Editor', desc: 'Tune mode, size, and position, then copy the snippet.' },'/docs': { label: 'Docs', desc: 'SDKs, API reference, and integration guides.' },'/launchpad': { label: 'Launchpad Studio', desc: 'Build a white-label 3D token launchpad and go live onchain.' },'/deploy': { label: 'Deploy Onchain', desc: 'Register your model as a permanent on-chain agent identity.' },@@ -78,7 +77,7 @@};// Under-used "hidden gems" — the pool the passive prompt draws from first.- var HIDDEN_GEMS = ['/forge', '/create/prompt', '/studio', '/embed.html', '/docs', '/launchpad', '/marketplace', '/lipsync', '/voice', '/brain', '/skills'];+ var HIDDEN_GEMS = ['/forge', '/create/prompt', '/create/selfie', '/studio', '/avatar-studio', '/docs', '/launchpad', '/marketplace', '/lipsync', '/voice', '/brain', '/skills'];// Cross-links shown when a feature finishes (`tws:feature-done`). Every target// is a confirmed live route; the adjacent action is the natural next step.@@ -94,7 +93,7 @@var CROSSLINKS = {forge: { kicker: 'Nice model. What now?', links: [{ route: '/scene', label: 'Open in Scene Studio', primary: true, modelParam: 'model', nameParam: 'name' },- { route: '/embed.html', label: 'Embed editor', modelParam: 'avatar' },+ { route: '/studio', label: 'Embed it on a site', modelParam: 'model' },{ route: '/deploy', label: 'Deploy onchain', idParam: 'avatar', modelParam: 'model', nameParam: 'name' },{ route: '/play', label: 'Drop it in a world', modelParam: 'avatar' },] },@@ -108,16 +107,16 @@{ route: '/studio', label: 'Open Studio', primary: true, idParam: 'avatar', modelParam: 'model' },{ route: '/create-agent', label: 'Make it an agent' },{ route: '/walk', label: 'Walk your avatar', idParam: 'avatar', modelParam: 'avatarUrl' },- { route: '/embed.html', label: 'Embed editor', idParam: 'avatar', modelParam: 'avatar' },+ { route: '/studio', label: 'Embed it on a site', idParam: 'avatar', modelParam: 'model' },] },scan: { kicker: 'Avatar ready. What now?', links: [{ route: '/studio', label: 'Open Studio', primary: true, idParam: 'avatar', modelParam: 'model' },{ route: '/walk', label: 'Walk your avatar', idParam: 'avatar', modelParam: 'avatarUrl' },- { route: '/embed.html', label: 'Embed editor', idParam: 'avatar', modelParam: 'avatar' },+ { route: '/studio', label: 'Embed it on a site', idParam: 'avatar', modelParam: 'model' },{ route: '/docs', label: 'Read the docs' },] },studio: { kicker: 'Widget ready. Share it?', links: [- { route: '/embed.html', label: 'Embed editor', primary: true },+ { route: '/widgets', label: 'See it in the gallery', primary: true },{ route: '/deploy', label: 'Deploy onchain', idParam: 'avatar', modelParam: 'model', nameParam: 'name' },{ route: '/docs', label: 'Integration guide' },] },diff --git a/public/features.json b/public/features.jsonindex 6def03384..be579e709 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-09-03T08:23:29.088Z",+ "generated_at": "2026-09-03T08:31:49.798Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",diff --git a/public/getting-started.js b/public/getting-started.jsindex 5ec874119..087407572 100644--- a/public/getting-started.js+++ b/public/getting-started.js@@ -66,7 +66,7 @@desc: 'Drop one line of HTML onto any site. It loads and animates itself.',href: '/studio',done: function (p) {- return p.indexOf('/studio') === 0 || p === '/embed' ||+ return p.indexOf('/studio') === 0 ||p.indexOf('/dashboard/widgets') === 0 || p.indexOf('/dashboard/api') === 0;},},diff --git a/public/llms-full.txt b/public/llms-full.txtindex 8c657441f..64711ee7e 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -551,7 +551,7 @@ Khronos-spec validator for glTF/GLB files. Paste a URL or upload a model.URL: https://three.ws/studio-Pick an avatar, configure embed options, copy a one-line snippet for your site.+Build an embeddable 3D widget: pick an avatar (or your own model URL), pick a widget type, tune it live, and copy the snippet. No account needed for the URL-based embeds.### Artifact Viewer@@ -725,7 +725,7 @@ Paste any token contract address and get a live, agent-payable x402 endpoint forURL: https://three.ws/avatar-studio-Build a custom 3D avatar from scratch. Choose body type, sculpt face and body, add outfits and accessories. No selfie required.+Build a custom 3D avatar from scratch. Sculpt the face and body, dress it from the closet, add accessories, and walk it around the stage. No selfie required.### TRELLIS NIM Forgediff --git a/public/llms.txt b/public/llms.txtindex 84e579039..15575f337 100644--- a/public/llms.txt+++ b/public/llms.txt@@ -118,7 +118,7 @@ Create and customize an agent.- [Scene Composer](https://three.ws/compose): Real-time 3D scene composer: forge items from text, attach them to your avatar's skeleton bones, arrange and scale freely, then export your creation or save it as an outfit.- [Animation Studio](https://three.ws/pose): Pose any three.ws avatar or the built-in mannequin with FK/IK, keyframe a timeline, and preview the motion live. Export an animated GLB or clip JSON, save animations to your account, play them back across the platform, and sell them for USDC.- [glTF Validator](https://three.ws/validation): Khronos-spec validator for glTF/GLB files. Paste a URL or upload a model.-- [Widget Studio](https://three.ws/studio): Pick an avatar, configure embed options, copy a one-line snippet for your site.+- [Widget Studio](https://three.ws/studio): Build an embeddable 3D widget: pick an avatar (or your own model URL), pick a widget type, tune it live, and copy the snippet. No account needed for the URL-based embeds.- [Artifact Viewer](https://three.ws/artifact): Renders Claude artifact bundles as standalone embeddable apps.- [create-agent: one command, one 3D character](https://three.ws/docs/create-agent): npm create @three-ws/agent turns a sentence into a rigged, downloadable 3D character with a working demo page. No account, no API key.- [Brownout: proven fallbacks, not promised ones](https://three.ws/docs/brownout): Every response says where its data came from and how fresh it is, and every fallback the API claims has been executed for real against a genuinely refusing provider, inside the request path a user hits.@@ -147,7 +147,7 @@ Create and customize an agent.- [Voice Lab](https://three.ws/voice): Browse hundreds of voices across Microsoft Edge, Gemini, NVIDIA, OpenAI and ElevenLabs, preview any of them, or clone your own from a short recording, then give it to your agent.- [Make Dad a 3D Avatar](https://three.ws/dad): Turn one photo of your dad into a recognizable, rigged, animated 3D avatar. It idles, walks, and waves, and you can share a permalink.- [CA → x402](https://three.ws/ca2x402): 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.-- [Avatar Studio](https://three.ws/avatar-studio): Build a custom 3D avatar from scratch. Choose body type, sculpt face and body, add outfits and accessories. No selfie required.+- [Avatar Studio](https://three.ws/avatar-studio): Build a custom 3D avatar from scratch. Sculpt the face and body, dress it from the closet, add accessories, and walk it around the stage. No selfie required.- [TRELLIS NIM Forge](https://three.ws/nim-forge): Drop in a photo, get a textured 3D model, reconstructed on a self-hosted Microsoft TRELLIS NIM. Single-hop image to GLB.- [Avatar SDK](https://three.ws/avatar-sdk): The @three-ws/avatar package: embed the platform 3D avatars in any site with a few lines of JavaScript.- [Materialize](https://three.ws/materialize): Turn any 3D model into a real printed object. Live printability analysis and automatic repair, a true-scale AR preview on your own desk, an itemized price from the mesh's own measured volume, and USDC checkout on Solana.diff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex 25fdc808a..adfbdb377 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -823,7 +823,7 @@<a href="/studio"><span class="sm-title">Widget Studio</span><span class="sm-path">/studio</span>- <span class="sm-desc">Pick an avatar, configure embed options, copy a one-line snippet for your site.</span>+ <span class="sm-desc">Build an embeddable 3D widget: pick an avatar (or your own model URL), pick a widget type, tune it live, and copy the snippet. No account needed for the URL-based embeds.</span></a></li><li>@@ -1026,7 +1026,7 @@<a href="/avatar-studio"><span class="sm-title">Avatar Studio</span><span class="sm-path">/avatar-studio</span>- <span class="sm-desc">Build a custom 3D avatar from scratch. Choose body type, sculpt face and body, add outfits and accessories. No selfie required.</span>+ <span class="sm-desc">Build a custom 3D avatar from scratch. Sculpt the face and body, dress it from the closet, add accessories, and walk it around the stage. No selfie required.</span></a></li><li>diff --git a/specs/EDITOR_SPEC.md b/specs/EDITOR_SPEC.mdindex a3b65897e..e21db2c24 100644--- a/specs/EDITOR_SPEC.md+++ b/specs/EDITOR_SPEC.md@@ -333,6 +333,8 @@ UI wrapper over `publishEditedGLB`. Manages three states: **working** (step progA separate "place, scale, preview, copy" UX. Mounted by calling `mountEmbedEditor(rootEl, { src, defaults })`. Renders a split view: a live iframe preview on the left, a control panel on the right.+> Route note: the standalone `/embed` page this module used to back is retired. That editor's job now belongs to the Widget Studio at `/studio` ([`public/studio/studio.js`](../public/studio/studio.js)), which reads the same query-parameter names, so `/embed?…` links rewrite there. This module stays as the embeddable, host-mountable form of the same UX (the `<agent-3d editor>` path described above); it is no longer served at a route of its own.+Controls exposed:- Mode selector (floating, inline, section, fullscreen)diff --git a/src/avatar-page.js b/src/avatar-page.jsindex ed94374c2..e8e2d8685 100644--- a/src/avatar-page.js+++ b/src/avatar-page.js@@ -1215,8 +1215,13 @@ function renderEmbedPanel(glbUrl) {// The terminal viewer resolves an agent to its bound body through// /api/agents/:id, so the agent id is the right handle in agent mode.const ttySnippet = `npx @three-ws/tty-avatar ${mode === 'agent' ? `agent:${entityId}` : avatarId}`;- const wizardUrl = `/embed?${new URLSearchParams(- mode === 'agent' ? { agent: entityId, ...(avatarId ? { avatar: avatarId } : {}) } : { avatar: avatarId },+ // The Widget Studio absorbed the standalone /embed editor and reads the same+ // parameter names. An agent lands on the Agent Chat widget type (mode=chat+ // takes the agent id); an avatar lands on the walking-avatar embed. The old+ // editor silently ignored the `agent` key it used to be handed here, so the+ // agent case landed on an avatar embed instead of a chat one.+ const wizardUrl = `/studio?${new URLSearchParams(+ mode === 'agent' ? { mode: 'chat', avatar: entityId } : { avatar: avatarId },)}`;return `<div style="display:flex;align-items:center;justify-content:space-between;gap:10px;flex-wrap:wrap;margin-bottom:14px">diff --git a/src/avatar-studio.js b/src/avatar-studio.jsindex fd3714b10..165946450 100644--- a/src/avatar-studio.js+++ b/src/avatar-studio.js@@ -761,11 +761,20 @@ async function bootScene(glbUrl, editAvatar) {},onChanged: () => renderChips(),});- // Racks render as soon as the closet exists: browsing the catalog must- // not wait behind re-downloading a saved outfit (hydrate below marks- // tiles worn as each piece lands, via the onChanged re-render).+ // Racks render as soon as the closet exists: browsing the catalog must not+ // wait behind re-downloading a saved outfit.if (activeTab === 'wardrobe') renderActivePanel();- await closet.hydrate(workingAppearance.garments);+ // Re-dressing a saved outfit is a catalog fetch plus a GLB download per+ // piece, which measured ~18s on a cold cache. Awaiting it here held the+ // whole boot tail behind it: the avatar stayed in its bind pose (the idle+ // clip loads below) and the status line still read like create mode. So+ // it runs alongside instead, and each piece repaints the racks and chips+ // as it lands through the closet's own onChanged. Every mutation the user+ // can make in the meantime is serialized behind the same queue.+ closet.hydrate(workingAppearance.garments).catch((err) => {+ log.warn('[avatar-studio] closet hydrate failed', err?.message);+ setStatus('err', 'Could not re-dress this avatar. Open Wardrobe to retry the closet.');+ });// Bring the rig to life: load the clip library and settle the avatar into// a looping idle so it leaves its bind T-pose. The clip drives the wholediff --git a/src/avatar-walk-panel.js b/src/avatar-walk-panel.jsindex 1181c89a9..8bbdef4aa 100644--- a/src/avatar-walk-panel.js+++ b/src/avatar-walk-panel.js@@ -102,7 +102,7 @@ export function createWalkPanel({const kbd = KEYS.map((k) => `<kbd>${k}</kbd>`).join('');const cta = openWalkUrl? `<button class="${esc(buttonClass)} primary ae-walk-open" type="button">Open in Walk page →</button>`- : `<p class="ae-walk-note ae-walk-hint">${esc(saveHint)}</p>`;+ : `<p class="ae-walk-note ae-walk-savehint">${esc(saveHint)}</p>`;panel.innerHTML = `<div class="ae-walk">@@ -207,7 +207,9 @@ function injectCss() {.ae-walk-select:focus-visible { border-color: var(--accent, #fafafa); }.ae-walk-open { align-self: flex-start; }.ae-walk-note { margin: 0; font-size: 12px; line-height: 1.5; color: var(--text-3, #71717a); min-height: 16px; }- .ae-walk-hint { color: var(--text-2, #a1a1aa); }+ /* Deliberately not .ae-walk-hint: AvatarWalkPreview already owns that+ class for the on-stage driving hint it overlays on the viewport. */+ .ae-walk-savehint { color: var(--text-2, #a1a1aa); }`;document.head.appendChild(style);}diff --git a/src/dashboard-next/pages/agents.js b/src/dashboard-next/pages/agents.jsindex 62e26f7d7..0d663592a 100644--- a/src/dashboard-next/pages/agents.js+++ b/src/dashboard-next/pages/agents.js@@ -548,7 +548,7 @@ function agentCard(a, avatars) {<div class="dn-agent-actions-primary">${a.avatar_id ? `<a class="dn-btn" href="/avatars/${encodeURIComponent(a.avatar_id)}" target="_blank" rel="noopener" style="padding:5px 10px;font-size:12px">Live page ↗</a>` : ''}<a class="dn-btn" href="/app?agent=${encodeURIComponent(a.id)}" target="_blank" rel="noopener" style="padding:5px 10px;font-size:12px">3D Studio ↗</a>- <a class="dn-btn" href="/embed?avatar=${encodeURIComponent(a.id)}&mode=chat" target="_blank" rel="noopener" style="padding:5px 10px;font-size:12px">Embed wizard ↗</a>+ <a class="dn-btn" href="/studio?avatar=${encodeURIComponent(a.id)}&mode=chat" target="_blank" rel="noopener" style="padding:5px 10px;font-size:12px">Embed wizard ↗</a></div><div class="dn-agent-actions-secondary"><button class="dn-btn ghost" data-action="edit-agent" data-id="${esc(a.id)}" style="padding:5px 10px;font-size:12px">Edit</button>diff --git a/src/editor/launchpad-studio.js b/src/editor/launchpad-studio.jsindex 48a386aae..f7d465bc3 100644--- a/src/editor/launchpad-studio.js+++ b/src/editor/launchpad-studio.js@@ -861,7 +861,7 @@ export function mountLaunchpadStudio(root, options = {}) {<div class="actions"><span class="save-state" data-save-state role="status" aria-live="polite"></span><a class="btn ghost" href="/launches" title="Public feed of every coin launched by a three.ws agent">See all launched coins →</a>- <a class="btn ghost" href="/embed" title="The original place-and-scale embed editor">Open classic editor</a>+ <a class="btn ghost" href="/studio" title="The Widget Studio, which absorbed the classic embed editor">Open Widget Studio</a><button class="btn" data-action="open-recent" aria-haspopup="true" aria-expanded="false">My launchpads ▾</button><button class="btn" data-action="new-draft" title="Start a new draft (current draft cleared)">New</button><button class="btn primary" data-action="publish">Publish</button>diff --git a/src/marketplace.js b/src/marketplace.jsindex d9b48700d..e14341527 100644--- a/src/marketplace.js+++ b/src/marketplace.js@@ -5442,11 +5442,14 @@ function renderEmbedTab(a) {if (iframe) iframe.textContent = iframeSnippet;if (link) link.textContent = embedPageUrl;- // "Configure in wizard" — pre-loads this agent into the full embed editor+ // "Configure in wizard": pre-loads this agent into the Widget Studio, which+ // absorbed the standalone /embed editor. `mode=chat` is the same parameter+ // name the old editor used, and the studio reads it to seed its Agent Chat+ // widget type, so old links keep working through the redirect too.const wizardLink = $('d-embed-wizard-link');if (wizardLink) {const p = new URLSearchParams({ avatar: agentId, mode: 'chat' });- wizardLink.href = `/embed?${p}`;+ wizardLink.href = `/studio?${p}`;}}diff --git a/vercel.json b/vercel.jsonindex 1779975e4..a0f765eb7 100644--- a/vercel.json+++ b/vercel.json@@ -1897,12 +1897,24 @@"dest": "/api/embed/resolve"},{- "src": "/embed",- "dest": "/embed.html"+ "src": "/embed/?",+ "has": [{ "type": "query", "key": "mode" }],+ "dest": "/studio/index.html"+ },+ {+ "src": "/embed/?",+ "has": [{ "type": "query", "key": "avatar" }],+ "dest": "/studio/index.html"},{- "src": "/embed/",- "dest": "/embed.html"+ "src": "/embed/?",+ "has": [{ "type": "query", "key": "id" }],+ "dest": "/studio/index.html"+ },+ {+ "src": "/embed/?",+ "status": 301,+ "headers": { "Location": "/studio" }},{"src": "/embodiment/embed/?",