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(ar): open the public model + gallery reads to any origin so embedded studios work
nirholasabde4db6bdbe
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 47059636d..7b21abae3 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -12,6 +12,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Agents can now hold a spending allowance instead of your private key**: Handing an AI agent a wallet has always meant handing it a private key, which means handing it everything in that wallet. The new onchain-agent-wallets MCP server replaces that with an allowance. Your money stays in an account you own, and the agent gets permission to spend a slice of it that the Solana token program enforces on-chain: it cannot spend past the ceiling however it is prompted, every spend decrements what is left, and you can cancel the whole thing in one instruction or take the balance back without the agent's cooperation. On top of that you set the rules it runs under: a maximum per transaction, a maximum per day, which addresses it may pay, which APIs it may buy from, an expiry, and a pause switch that stops it instantly for free. It can pay x402 APIs out of the allowance, and the price is always read before any money moves. Every decision, including every refusal and the reason for it, is written to an audit log you can read. You never have to put a secret key on the machine: owner actions come back as an unsigned transaction for Phantom, Solflare, or a Ledger to sign. `[feature, sdk, security]`- **Deploying an agent on-chain now buys $THREE, and holders deploy free**: The Metaplex Agent Registry deployer (the browser page and the @three-ws/metaplex-agent-mcp server) now carries a flat 0.02 SOL deploy fee on mainnet, and that fee is paid to the wallet the $THREE buyback lane spends from. So every agent someone puts on-chain through us turns into buy pressure on $THREE instead of nothing. Holding $THREE is what makes it cheaper: 50,000 in the paying wallet halves the fee, 250,000 waives it entirely, and the balance is read live from the chain when the transaction is built, so nothing is staked, locked, or spent to earn it. Deploy a whole fleet and the waiver applies to every one. Devnet rehearsals stay free, the fee travels inside the same transaction that creates the agent (so a deploy that fails costs nothing), and both the amount and its destination are shown before anything is signed. A new three_status tool prices your next deploy against any wallet and returns the live $THREE market and buyback figures. (`/deploy-onchain`) `[feature, sdk]`- **Every three.ws package on npm is current again**: Our npm packages had drifted a long way behind the code: 73 of them, including the main SDK, the React components, the avatar and walk SDKs and most of the MCP servers, were sitting on npm at an older version than what we had actually built. Anyone installing from npm got stale code. All 73 are now published at their current version, and four packages that had never been released at all (the agent runtime, the sign language pack, the spatial MCP server and the VS Code extension) are on npm for the first time. The cause was our release script working from a hand written list, so any package added after that list was written was silently never published; it now discovers packages itself, so a new one cannot be forgotten again. `[sdk, fix]`+- **Our AR studio is now a package anyone can drop into their own site**: The multi-model AR surface behind three.ws is now a standalone open-source package: 3d-ar-studio on npm, and a hosted demo at nirholas.github.io/3D-AR-Studio. One script tag gives any web page a working augmented-reality studio: place any number of 3D models in your real room through the camera, drag, pinch and rotate them, generate new ones from a text prompt without leaving the camera view, then share the whole arrangement as a link or a QR code, or open a live room and build it with someone else. It carries the full rendering ladder we run here, WebXR placement with per-model anchors, real-world light estimation and depth occlusion on Android, camera passthrough with gyro world-lock on iOS, and a framed preview with a QR hand-off on desktop, plus the universal idle retarget so humanoid models animate instead of standing in a T-pose. Out of the box it pulls models and free keyless text-to-3D from three.ws, and a single option repoints it at anyone's own catalogue. It ships with an MCP server (published to the official registry) so an agent can generate a model, arrange a scene, and hand a person one link that opens it in their room, and a two-command CLI that puts a live AR page on GitHub Pages. `[feature, sdk]`- **Phone fixes: helper widgets no longer sit on top of the controls**: On a phone the floating language control and the Getting started pill landed directly on the page's own bottom controls: the language picker rendered inside the "Ask the agent" box and the pill covered the save row. Helper widgets now measure a page's bottom bar and float above it, and the language control shows a compact code (EN) instead of a full-width bar. Gallery cards show all three actions in full, so Animate is no longer clipped mid-word. In the AR Studio, the Add models sheet keeps its tabs at full height on short screens, and each model is labelled with a readable name instead of the whole generation prompt. On the viewer page a long email no longer pushes the account button off the edge of the screen. (`/gallery`) `[fix, improvement]`- **Put any agent on-chain from your AI assistant: the Metaplex Agent Registry MCP server**: A new npm package, @three-ws/metaplex-agent-mcp, lets any AI assistant deploy an agent on-chain on Solana the exact way the three.ws Genesis 333 shipped: it mints a Metaplex Core asset and registers its EIP-8004 agent identity, so the agent appears on metaplex.com/agents with its own built-in wallet. Agents can sign with their own key, and people can sign with Phantom, Solflare, or any Solana wallet, with a preview-first confirm step before anything is spent. Every royalty, creator, plugin, and metadata field is customizable, and devnet rehearsal is free. (`/deployments`) `[sdk, feature]`- **Shared avatar links now unfurl with the avatar itself, and profile views finally count**: Paste an avatar link into X, Discord, Telegram, or Slack and the preview now shows that avatar's rendered image, name, and description instead of the generic site card. The profile page also reports a view each time someone opens it, so the view counts that rank search and explore results reflect real traffic at last. Discover cards for agents without a coin no longer point at a dead address, and the sitemap hands search engines the current agent page URLs directly. `[improvement, fix]`diff --git a/STRUCTURE.md b/STRUCTURE.mdindex 86fd65182..148071eeb 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -75,7 +75,7 @@ bottom.| AR-ready exports ("View in your space") | Device-routing core [api/_lib/ar-launch.js](api/_lib/ar-launch.js), UA-branched launch endpoint [api/ar.js](api/ar.js) `→ /api/ar`, MCP tool [api/_mcp3d/tools/ar.js](api/_mcp3d/tools/ar.js) (`export_ar`, free), in-viewer AR button [public/viewer.html](public/viewer.html), docs [docs/ar.md](docs/ar.md). | Live · both stores | `GET /api/ar?src=<glb>` branches on the request User-Agent server-side: iOS → Apple Quick Look (USDZ generated from the GLB on the fly by model-viewer's three.js USDZExporter — real conversion, no server USD tooling), Android → 302 Google Scene Viewer ARCore intent with browser fallback, desktop → WebGL viewer. Bad input rejected at the boundary with a designed error page. `export_ar` returns the AR launch link + a conformant Spatial-MCP artifact; response is OpenAI-clean (no ids/coin surface). `kind=avatar` is the living-agent lane: the launch page leads with a "Bring it to life" handoff into `/irl?avatar=<glb>` (avatar-producing tools return `irlUrl` automatically), and Android serves the launch page instead of the blind Scene Viewer redirect so the living path stays visible. Shared links unfurl: the launch page's `og:image` points at `GET /api/render/glb?glbUrl=` ([api/render/glb.js](api/render/glb.js), server-side PNG of the actual model, CDN-cached a day) and the page carries "Create your own" → `/ar` conversion CTAs. Tests: [tests/ar-export.test.js](tests/ar-export.test.js). Evidence: [prompts/store-submissions/_generated/ar/](prompts/store-submissions/_generated/ar/). Store-submission prompt 21. || AR Forge (prompt → model → your room) | [public/ar-forge.html](public/ar-forge.html) `→ /ar` (self-contained page, CDN model-viewer + local meshopt decoder, no Vite registration needed; vercel route sets `xr-spatial-tracking` permissions-policy) | Live | Mobile-first app: one prompt hits the free NVIDIA lane (`POST /api/forge {backend:"nvidia"}`, poll `?job=`), the result renders in an AR-capable `<model-viewer>` with "View in your space" (WebXR / Scene Viewer / Quick Look). Non-AR devices get a QR handoff to `GET /api/ar?src=` (server-side UA routing) plus a copyable `/viewer?src=` share link. Deep link `/ar?src=<glb>&title=` reopens any shared model; recent forges persist in localStorage. Designed idle/working/failed/result states; https-only GLB guard. || Daily Forge (daily challenge + creator streak) | [pages/daily.html](pages/daily.html) `→ /daily` + [src/daily.js](src/daily.js), deterministic theme rotation [src/daily/daily-theme.js](src/daily/daily-theme.js), streak state machine [src/daily/creator-streak.js](src/daily/creator-streak.js) | Live | The **anonymous-first retention loop** the platform lacked: the logged-in streak system ([api/_lib/streaks.js](api/_lib/streaks.js)) needs an account, so the no-sign-up forge majority had no reason to return. Every UTC day resolves to one curated creative theme (the same for everyone, hashed from the date — no backend, no randomness) with a running "Day N" counter; forging today's theme on the free lane lights a localStorage streak (consecutive-day state machine: extend / reset-on-gap / never-double-count, `best` preserved, at-risk vs lapsed display), and milestones (3/7/14/30/50/100/365) fire a celebration. The generation lands in the shared recents so it's one tap from `/ar` and `/ar/studio`; a "Fresh from the community" strip reads `/api/forge-gallery?scope=community`. `changefreq: daily` in the sitemap. Tests: [tests/daily-theme.test.js](tests/daily-theme.test.js), [tests/creator-streak.test.js](tests/creator-streak.test.js). |-| AR Studio (multi-model live camera scene) | [pages/ar-studio.html](pages/ar-studio.html) `→ /ar/studio` + [src/ar-studio.js](src/ar-studio.js), multi-anchor WebXR session [src/ar/multi-place.js](src/ar/multi-place.js), pure scene math [src/ar/studio-scene.js](src/ar/studio-scene.js) | Live | The standalone multi-model AR surface: place ANY number of models/avatars into one live camera view (every earlier AR lane was single-model). Model sources: in-view forge (`POST /api/forge {backend:"nvidia"}` runs behind the live camera, result drops into the room), the forge gallery (`/api/forge-gallery` — yours + community tabs), recent forges (localStorage, shared with `/ar`), the CC0 Object Library (`/api/objects/library`, an Objects tray tab with client-side name/category search), a pasted GLB link, or repeatable `?src=` deep links (https/relative only). Rendering ladder: WebXR immersive-ar with one XRAnchor per placed model + always-armed reticle (Android), getUserMedia passthrough + gyro world-lock (iOS/everywhere), grid preview + drag-look + QR handoff (desktop). Gestures: tap select, drag move, pinch resize, two-finger twist rotate; per-model duplicate/rotate/remove, clear-with-undo. Humanoids with no baked clips idle via the universal retarget ([src/irl/pin-idle.js](src/irl/pin-idle.js)); scene persists in localStorage and the whole ARRANGEMENT (models + transforms) round-trips through a base64url `#s=` hash on the share/QR URL, so a composed scene reopens exactly on any device. **Presence realism:** WebXR placements are lit by the real room via lighting-estimation ([src/ar/estimated-lighting.js](src/ar/estimated-lighting.js), three's `XREstimatedLight` — real primary-light direction/colour + a live environment cube map so metal/glass reflect the actual room, reverting to baked lights when the device isn't estimating) and occluded by real geometry via depth-sensing ([src/ar/depth-occlusion.js](src/ar/depth-occlusion.js)); the passthrough path matches room brightness AND colour by sampling the camera feed. Desktop keyboard controls (arrows nudge / R rotate / D duplicate / Delete). Photo capture composites camera + WebGL ([src/irl/share-frame.js](src/irl/share-frame.js)). Reachable from `/ar`, the forge AR panel, and the `/viewer` action sheet. **Shared rooms (build together, live):** "Share live" opens a room with a 6-char code; anyone who opens `/ar/studio?room=CODE` joins the same scene and every add / move / scale / rotate / remove delta-syncs in real time, with a live "N here" presence pill. New Colyseus room [multiplayer/src/rooms/StudioRoom.js](multiplayer/src/rooms/StudioRoom.js) + schema [multiplayer/src/studio-schemas.js](multiplayer/src/studio-schemas.js) (owner-gated edits, per-room/per-owner caps, per-client rate limit, https-only src validation — same discipline as WalkRoom's object channel), client wrapper [src/ar/studio-net.js](src/ar/studio-net.js), and a shared logical coordinate frame [src/ar/studio-coords.js](src/ar/studio-coords.js) (relEast/relNorth/yawDeg) so every device agrees on placement; QR-marker colocalization ([src/irl/marker-anchor.js](src/irl/marker-anchor.js)) is the co-located "same physical table" upgrade. Runs on the same Colyseus host as /walk and /irl (a new room, not a new process). Tests: [tests/ar-studio-scene.test.js](tests/ar-studio-scene.test.js), [tests/ar-studio-coords.test.js](tests/ar-studio-coords.test.js), [tests/ar-estimated-lighting.test.js](tests/ar-estimated-lighting.test.js), [tests/studio-room.test.js](tests/studio-room.test.js). |+| AR Studio (multi-model live camera scene) | [pages/ar-studio.html](pages/ar-studio.html) `→ /ar/studio` + [src/ar-studio.js](src/ar-studio.js), multi-anchor WebXR session [src/ar/multi-place.js](src/ar/multi-place.js), pure scene math [src/ar/studio-scene.js](src/ar/studio-scene.js) | Live | The standalone multi-model AR surface: place ANY number of models/avatars into one live camera view (every earlier AR lane was single-model). Model sources: in-view forge (`POST /api/forge {backend:"nvidia"}` runs behind the live camera, result drops into the room), the forge gallery (`/api/forge-gallery`, yours + community tabs), recent forges (localStorage, shared with `/ar`), the CC0 Object Library (`/api/objects/library`, an Objects tray tab with client-side name/category search), a pasted GLB link, or repeatable `?src=` deep links (https/relative only). Rendering ladder: WebXR immersive-ar with one XRAnchor per placed model + always-armed reticle (Android), getUserMedia passthrough + gyro world-lock (iOS/everywhere), grid preview + drag-look + QR handoff (desktop). Gestures: tap select, drag move, pinch resize, two-finger twist rotate; per-model duplicate/rotate/remove, clear-with-undo. Humanoids with no baked clips idle via the universal retarget ([src/irl/pin-idle.js](src/irl/pin-idle.js)); scene persists in localStorage and the whole ARRANGEMENT (models + transforms) round-trips through a base64url `#s=` hash on the share/QR URL, so a composed scene reopens exactly on any device. **Presence realism:** WebXR placements are lit by the real room via lighting-estimation ([src/ar/estimated-lighting.js](src/ar/estimated-lighting.js), three's `XREstimatedLight`, real primary-light direction/colour + a live environment cube map so metal/glass reflect the actual room, reverting to baked lights when the device isn't estimating) and occluded by real geometry via depth-sensing ([src/ar/depth-occlusion.js](src/ar/depth-occlusion.js)); the passthrough path matches room brightness AND colour by sampling the camera feed. Desktop keyboard controls (arrows nudge / R rotate / D duplicate / Delete). Photo capture composites camera + WebGL ([src/irl/share-frame.js](src/irl/share-frame.js)). Reachable from `/ar`, the forge AR panel, and the `/viewer` action sheet. **Shared rooms (build together, live):** "Share live" opens a room with a 6-char code; anyone who opens `/ar/studio?room=CODE` joins the same scene and every add / move / scale / rotate / remove delta-syncs in real time, with a live "N here" presence pill. New Colyseus room [multiplayer/src/rooms/StudioRoom.js](multiplayer/src/rooms/StudioRoom.js) + schema [multiplayer/src/studio-schemas.js](multiplayer/src/studio-schemas.js) (owner-gated edits, per-room/per-owner caps, per-client rate limit, https-only src validation, the same discipline as WalkRoom's object channel), client wrapper [src/ar/studio-net.js](src/ar/studio-net.js), and a shared logical coordinate frame [src/ar/studio-coords.js](src/ar/studio-coords.js) (relEast/relNorth/yawDeg) so every device agrees on placement; QR-marker colocalization ([src/irl/marker-anchor.js](src/irl/marker-anchor.js)) is the co-located "same physical table" upgrade. Runs on the same Colyseus host as /walk and /irl (a new room, not a new process). Tests: [tests/ar-studio-scene.test.js](tests/ar-studio-scene.test.js), [tests/ar-studio-coords.test.js](tests/ar-studio-coords.test.js), [tests/ar-estimated-lighting.test.js](tests/ar-estimated-lighting.test.js), [tests/studio-room.test.js](tests/studio-room.test.js). **Shipped as open source:** the same surface is extracted, generalized and published as [3d-ar-studio](https://www.npmjs.com/package/3d-ar-studio) (repo [nirholas/3D-AR-Studio](https://github.com/nirholas/3D-AR-Studio), demo https://nirholas.github.io/3D-AR-Studio/, MCP server `io.github.nirholas/3d-ar-studio`), so any site can embed a multi-model AR studio with one script tag. It defaults to OUR catalogue and generation lane (`/cdn/objects/library/manifest.json`, `/api/mcp-studio`, `/animations/manifest.json`, `/hdri/*`, `/api/ar`), which is why those surfaces answer open CORS. || IRL (agents in the real world) | [pages/irl.html](pages/irl.html) `→ /irl` + [src/irl.js](src/irl.js), WebXR placement [src/ar/webxr.js](src/ar/webxr.js) + pinch [src/ar/pinch-scale.js](src/ar/pinch-scale.js), animated Quick Look bake [src/usdz-animated.js](src/usdz-animated.js) (static fallback [src/usdz-pipeline.js](src/usdz-pipeline.js)), backend [api/irl/](api/irl) | Live | Pin an agent at a real GPS spot; discovery is presence-proof-gated ([docs/irl/THREAT-MODEL.md](docs/irl/THREAT-MODEL.md)). **Place in AR** leads the dock on AR-capable devices: WebXR hit-test anchoring on Android with two-finger pinch resize (25%..400%) persisted to the pin (`anchor_scale`; the pinch lands as a follow-up `PATCH /api/irl/pins {id, scale}` after the placement tap), and ARKit Quick Look on iOS with the idle clip baked into the USDZ so the agent moves instead of standing in a T-pose. Discovered pins are equally alive in the in-page camera view: every mounted humanoid GLB plays the retargeted idle clip via a per-pin mixer ([src/irl/pin-idle.js](src/irl/pin-idle.js), phase-randomized, LOD-bounded), camera-aware gaze composes on top of the running animation, and the scene renders with ACES tone mapping + IBL + soft shadows (e2e: [tests/e2e/irl-pin-idle.spec.js](tests/e2e/irl-pin-idle.spec.js)). Inbound `/irl?avatar=<glb>` is the living-agent handoff from `GET /api/ar?…&kind=avatar` (explicit `?avatar=` wins over a saved session). Money Drops and World Lines: [docs/irl.md](docs/irl.md). SDK: [packages/irl/](packages/irl). **Share** ([src/irl/share-frame.js](src/irl/share-frame.js), [api/irl/share.js](api/irl/share.js), [api/irl/share/[token].js](api/irl/share/%5Btoken%5D.js)) mints a permanent, unfurlable `/irl/s/:token` link from the captured AR photo for the pin you just placed - never a coordinate, owner-gated, falls back to the plain native share sheet with no active pin. **Analytics** ([api/_lib/irl-analytics.js](api/_lib/irl-analytics.js), [api/irl/analytics.js](api/irl/analytics.js)) is the first site-wide usage rollup for the feature - pins placed, nearby reads, placement method, shares, drop claims - aged out by the existing hourly reaper. || Verifiable 3D provenance (content credentials) | Spec [specs/PROVENANCE_3D.md](specs/PROVENANCE_3D.md), pure core [api/_lib/provenance-3d.js](api/_lib/provenance-3d.js), Solana anchor [api/_lib/provenance-anchor.js](api/_lib/provenance-anchor.js), MCP tools [api/_mcp3d/tools/provenance.js](api/_mcp3d/tools/provenance.js) (`verify_provenance` free, `anchor_provenance` paid $0.05), free REST verify [api/provenance.js](api/provenance.js) `→ /api/provenance`, viewer badge [public/viewer.html](public/viewer.html), docs [docs/provenance.md](docs/provenance.md). | Live (verify) · anchor gated on issuer key + devnet funds | C2PA-style signed content credentials for AI 3D: creator, prompt, model/provider, lineage, timestamp, and the GLB's sha256, ed25519-signed by the three.ws issuer with the credential hash anchored on Solana. Free public `verify_provenance` / `GET /api/provenance?src=…` recompute the hash and return `verified | tampered | unknown` (a single changed byte → tampered); the verify path and response are coin-clean (both stores). `anchor_provenance` signs + writes the SPL Memo anchor + stores the credential in R2. Tests: [tests/provenance-3d.test.js](tests/provenance-3d.test.js). Evidence: [prompts/store-submissions/_generated/provenance/](prompts/store-submissions/_generated/provenance/). Store-submission prompt 19. || OpenAI Select Partner (partner surface + announcement pack) | [pages/openai/index.html](pages/openai/index.html) `→ /openai`, badge assets [public/partners/openai/](public/partners/openai), announcement [blog/three-ws-openai-select-partner.html](blog/three-ws-openai-select-partner.html) `→ /blog/three-ws-openai-select-partner`, directory card in [pages/partners.html](pages/partners.html) `→ /partners`, press/social pack [marketing/openai-select-partner/](marketing/openai-select-partner/README.md), original OpenAI-supplied badge files + press-release template [OAI Select Tier Assets/](OAI%20Select%20Tier%20Assets/README.md) | Live | three.ws's OpenAI Partner Network Select-tier surface. `/openai` is the partner landing: the supplied badge (used unmodified, on a white plate), the four live OpenAI surfaces (the free keyless [3D Studio MCP connector](docs/mcp-studio.md) `→ /api/mcp-studio`, the custom-GPT Actions twin `→ /api/3d/studio`, [Spatial MCP](specs/SPATIAL_MCP.md), and [AR in ChatGPT](docs/chatgpt-ar.md)), the connect table, and the nine-tool list. The marketing pack holds badge-usage rules and the press-release draft, which is gated on OpenAI's written approval before publishing (see its README). |diff --git a/api/forge-gallery.js b/api/forge-gallery.jsindex 2d5465f2d..ba8096efd 100644--- a/api/forge-gallery.js+++ b/api/forge-gallery.js@@ -23,7 +23,11 @@ import { limits, clientIp } from './_lib/rate-limit.js';import { hashClient, listCreations, listShowcase, countShowcase, forgeStoreEnabled } from './_lib/forge-store.js';export default wrap(async (req, res) => {- if (cors(req, res, { methods: 'GET,OPTIONS' })) return;+ // Open CORS: this is a public, keyless, read-only feed of models people chose+ // to publish, and it is the catalogue the standalone AR studio+ // (npm: 3d-ar-studio) offers as its Community tab from whatever origin a+ // developer embedded it on. Rate limiting below is the real control here.+ if (cors(req, res, { origins: '*', methods: 'GET,OPTIONS' })) return;if (!method(req, res, ['GET'])) return;const rl = await limits.publicIp(clientIp(req));diff --git a/api/objects/library.js b/api/objects/library.jsindex 260a97162..b65156963 100644--- a/api/objects/library.js+++ b/api/objects/library.js@@ -35,7 +35,10 @@ function parseCursor(raw) {}export default wrap(async (req, res) => {- if (cors(req, res, { methods: 'GET,OPTIONS' })) return;+ // Open CORS: a CC0 manifest with no caller data in it, served to whoever asks.+ // The same objects already load cross-origin through /cdn/<key>, so pinning+ // the index to our own origin only broke the tray in embeds that render it.+ if (cors(req, res, { origins: '*', methods: 'GET,OPTIONS' })) return;if (!method(req, res, ['GET'])) return;// Cursors are validated BEFORE the manifest fetch. A request that is going todiff --git a/data/changelog.json b/data/changelog.jsonindex 15dd3a461..bbd08d3ec 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,15 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-08-19",+ "title": "Our AR studio is now a package anyone can drop into their own site",+ "summary": "The multi-model AR surface behind three.ws is now a standalone open-source package: 3d-ar-studio on npm, and a hosted demo at nirholas.github.io/3D-AR-Studio. One script tag gives any web page a working augmented-reality studio: place any number of 3D models in your real room through the camera, drag, pinch and rotate them, generate new ones from a text prompt without leaving the camera view, then share the whole arrangement as a link or a QR code, or open a live room and build it with someone else. It carries the full rendering ladder we run here, WebXR placement with per-model anchors, real-world light estimation and depth occlusion on Android, camera passthrough with gyro world-lock on iOS, and a framed preview with a QR hand-off on desktop, plus the universal idle retarget so humanoid models animate instead of standing in a T-pose. Out of the box it pulls models and free keyless text-to-3D from three.ws, and a single option repoints it at anyone's own catalogue. It ships with an MCP server (published to the official registry) so an agent can generate a model, arrange a scene, and hand a person one link that opens it in their room, and a two-command CLI that puts a live AR page on GitHub Pages.",+ "tags": [+ "feature",+ "sdk"+ ]+ },{"date": "2026-08-19","title": "Deploying an agent on-chain now buys $THREE, and holders deploy free",diff --git a/docs/ar.md b/docs/ar.mdindex c23f40663..0bd36268a 100644--- a/docs/ar.md+++ b/docs/ar.md@@ -459,6 +459,36 @@ How this link ships through ChatGPT end to end (the app connector, the custom GP---+## Put this AR studio on your own site++The multi-model studio at [/ar/studio](/ar/studio) is published as a standalone open-source+package, so any site can embed the same thing:++```html+<script type="module" src="https://unpkg.com/3d-ar-studio/dist/ar-studio.min.js"></script>+<ar-studio></ar-studio>+```++- npm: [`3d-ar-studio`](https://www.npmjs.com/package/3d-ar-studio)+- Source and docs: [github.com/nirholas/3D-AR-Studio](https://github.com/nirholas/3D-AR-Studio)+- Hosted demo: [nirholas.github.io/3D-AR-Studio](https://nirholas.github.io/3D-AR-Studio/)+- MCP server: `npx 3d-ar-studio-mcp` (registry name `io.github.nirholas/3d-ar-studio`)++With no configuration it pulls models from our CC0 object library and generates new ones+through the free, keyless `/api/mcp-studio` connector documented above, so an embedder needs+no key and no account. One option repoints it at their own catalogue:++```js+createArStudio('#stage', { assets: 'https://their.cdn/models.json' })+```++Those surfaces answer open CORS on purpose: `/cdn/<key>` (models and thumbnails),+`/cdn/objects/library/manifest.json`, `/api/mcp-studio`, `/animations/manifest.json`,+`/hdri/*.hdr`, and `GET /api/ar`. Changing any of them changes what every embedded studio in+the wild can load.++---+## See also- [AR on the homepage](https://three.ws/#home-ar) — live demo with real Forge modelsdiff --git a/public/changelog.json b/public/changelog.jsonindex 95f39d0a7..f900deefa 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-19T21:17:27.214Z",+ "generated_at": "2026-08-19T21:24:49.110Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -72,6 +72,17 @@"fix"]},+ {+ "date": "2026-08-19",+ "type": "update",+ "title": "Our AR studio is now a package anyone can drop into their own site",+ "summary": "The multi-model AR surface behind three.ws is now a standalone open-source package: 3d-ar-studio on npm, and a hosted demo at nirholas.github.io/3D-AR-Studio. One script tag gives any web page a working augmented-reality studio: place any number of 3D models in your real room through the camera, drag, pinch and rotate them, generate new ones from a text prompt without leaving the camera view, then share the whole arrangement as a link or a QR code, or open a live room and build it with someone else. It carries the full rendering ladder we run here, WebXR placement with per-model anchors, real-world light estimation and depth occlusion on Android, camera passthrough with gyro world-lock on iOS, and a framed preview with a QR hand-off on desktop, plus the universal idle retarget so humanoid models animate instead of standing in a T-pose. Out of the box it pulls models and free keyless text-to-3D from three.ws, and a single option repoints it at anyone's own catalogue. It ships with an MCP server (published to the official registry) so an agent can generate a model, arrange a scene, and hand a person one link that opens it in their room, and a two-command CLI that puts a live AR page on GitHub Pages.",+ "link": null,+ "tags": [+ "feature",+ "sdk"+ ]+ },{"date": "2026-08-19","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex 664aab1e0..ed41ae6e0 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -54,6 +54,14 @@<category>sdk</category><description>Our npm packages had drifted a long way behind the code: 73 of them, including the main SDK, the React components, the avatar and walk SDKs and most of the MCP servers, were sitting on npm at an older version than what we had actually built. Anyone installing from npm got stale code. All 73 are now published at their current version, and four packages that had never been released at all (the agent runtime, the sign language pack, the spatial MCP server and the VS Code extension) are on npm for the first time. The cause was our release script working from a hand written list, so any package added after that list was written was silently never published; it now discovers packages itself, so a new one cannot be forgotten again.</description></item>+ <item>+ <title>Our AR studio is now a package anyone can drop into their own site</title>+ <link>https://three.ws/changelog</link>+ <guid isPermaLink="false">2026-08-19:Our AR studio is now a package anyone can drop into their own site</guid>+ <pubDate>Wed, 19 Aug 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>The multi-model AR surface behind three.ws is now a standalone open-source package: 3d-ar-studio on npm, and a hosted demo at nirholas.github.io/3D-AR-Studio. One script tag gives any web page a working augmented-reality studio: place any number of 3D models in your real room through the camera, drag, pinch and rotate them, generate new ones from a text prompt without leaving the camera view, then share the whole arrangement as a link or a QR code, or open a live room and build it with someone else. It carries the full rendering ladder we run here, WebXR placement with per-model anchors, real-world light estimation and depth occlusion on Android, camera passthrough with gyro world-lock on iOS, and a framed preview with a QR hand-off on desktop, plus the universal idle retarget so humanoid models animate instead of standing in a T-pose. Out of the box it pulls models and free keyless text-to-3D from three.ws, and a single option repoints it at anyone's own catalogue. It ships with an MCP server (published to the official registry) so an agent can generate a model, arrange a scene, and hand a person one link that opens it in their room, and a two-command CLI that puts a live AR page on GitHub Pages.</description>+ </item><item><title>Phone fixes: helper widgets no longer sit on top of the controls</title><link>https://three.ws/gallery</link>