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
docs(irl): document visit links, printable signs and the street-demo runbook
nirholas53095800126f
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex e58d4ee05..4a0ef892e 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -3417,7 +3417,7 @@ And all of it is public. Oracle Lab publishes the actual model: every weight, th## 2026-06-13- **AR & WebXR: Place Any 3D Agent in Your Real World** (`/features/ar`): Every three.ws avatar and Forge model has a View in AR button. On mobile it anchors the model to real surfaces through your camera. WebXR on Android, Quick Look on iOS: no app, no download.-- **IRL** (`/irl`): Place a 3D avatar in your real environment. Camera AR passthrough, joystick movement, and tap-to-place 3D objects on your floor.+- **IRL** (`/irl`): Pin a 3D AI agent at a real place and meet the ones around you. Walk up, see it through your camera, talk to it out loud, view it in AR on your own floor, and pay it on the spot.- **Scene Composer** (`/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.- **Tutorial · View your 3D model in AR** (`/tutorials/view-in-ar`): See any three.ws model in augmented reality and walk around it in your kitchen, straight from the browser with no app to install. iOS Quick Look, Android Scene Viewer, and WebXR.- **3D model categories, every model is now typed as Avatar, Accessory, Item, Scene, Creature, or Vehicle**: All 3D models on the platform now carry a category that describes what they actually are, not just how they were created. Avatar cards in the marketplace show a color-coded type badge (Avatar, Accessory, Item, Scene, Creature, or Vehicle) and a new filter row lets you browse by type. The Forge gallery shows the same badges on showcase cards, and when you finish forging a model you can tag it right in the result bar with a single click. This is the foundation for the upcoming agent equipment system, where your agents will be able to wear accessories, hold items, and inhabit scenes. (`/marketplace`) `[feature, improvement]`diff --git a/STRUCTURE.md b/STRUCTURE.mdindex e7fa2a3c2..5eb5420d8 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -98,7 +98,7 @@ bottom.| 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. **Real device AR, not just the camera composite:** the AR control resolves what the device can actually do and routes there rather than defaulting every non-WebXR device to the composite: the immersive WebXR session where it exists, Apple Quick Look on iOS and Google Scene Viewer on Android otherwise (both selectable per-model from the selection bar too), and an honest "open this on a phone" QR prompt everywhere else. The button relabels itself to match ("Immersive" only where an immersive session is real). Quick Look reads USDZ, so the selected model's GLB is converted on the device through the same `usdz-pipeline.js` bake `/avatars/:id/ar` uses, not the camera-passthrough composite, which has no real-world plane detection or scale and previously shipped as the only iOS experience. 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. || Portal (any website as a walkable world) | Page [pages/portal.html](pages/portal.html) `→ /portal` + controller [src/portal/main.js](src/portal/main.js), renderer [src/portal/render.js](src/portal/render.js), styles [src/portal/portal.css](src/portal/portal.css); reader [api/_lib/portal/outline.js](api/_lib/portal/outline.js) + guarded fetch [api/_lib/portal/fetch-site.js](api/_lib/portal/fetch-site.js) + robots matcher [api/_lib/portal/robots.js](api/_lib/portal/robots.js); pure layout [packages/portal/src/layout.js](packages/portal/src/layout.js); GLB export [api/_lib/portal/world-glb.js](api/_lib/portal/world-glb.js); endpoint [api/portal.js](api/portal.js) `→ /api/portal` | Live | Paste an address and walk the page: each section becomes a building sized by its word count (log scale), each link a door (same-site doors rebuild the world there and push browser history, outside links open the page), each image a billboard loaded through `/api/img`, each code block a monolith, and the palette comes from the page's own `theme-color` or a hash of its host. The layout is a pure, seeded function so the browser, the GLB exporter, the MCP tools and the npm package all build the identical city from one link. Crawler manners are part of the product: a declared user agent, `robots.txt` honoured per RFC 9309, one fetch per page cached fleet-wide for an hour, and an IP-pinned SSRF guard with size and time ceilings. `format=glb` returns the world as glTF with named nodes. SDK + CLI + MCP server: [packages/portal/](packages/portal). Docs: [docs/portal.md](docs/portal.md). Spec: [specs/PORTAL_WORLD.md](specs/PORTAL_WORLD.md). Tests: [tests/portal-robots.test.js](tests/portal-robots.test.js), [tests/portal-outline.test.js](tests/portal-outline.test.js), [tests/portal-layout.test.js](tests/portal-layout.test.js), [tests/portal-endpoint.test.js](tests/portal-endpoint.test.js), [tests/e2e/portal.spec.js](tests/e2e/portal.spec.js) |-| 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. |+| 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. **Visit links and signs** ([src/irl/visit-link.js](src/irl/visit-link.js) pure rules, [src/irl/visit-banner.js](src/irl/visit-banner.js) the "you're here to meet" banner, printable sign [pages/irl-sign.html](pages/irl-sign.html) `→ /irl/sign?pin=<id>` + [src/irl-sign.js](src/irl-sign.js), dashboard modal in [src/dashboard-next/pages/irl-placements.js](src/dashboard-next/pages/irl-placements.js)): `/irl?pin=<id>` is the scannable handoff for a street demo. The page names the agent from the coordinate-free agent card until the presence-gated nearby read returns that pin, then flashes it and opens its card once. The discovered-pin card gains **See it in AR** (iOS: the pin's GLB baked to an animated USDZ for Quick Look, banner tap returns to the tip panel; elsewhere the `/api/ar` launcher). Runbook: [docs/irl/street-demo.md](docs/irl/street-demo.md). Tests: [tests/irl-visit-link.test.js](tests/irl-visit-link.test.js). || 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. || Simulation readiness (a physics grade for 3D assets) | Spec [specs/SIM_READINESS.md](specs/SIM_READINESS.md), pure core [api/_lib/sim-readiness.js](api/_lib/sim-readiness.js), storage [api/_lib/sim-readiness-store.js](api/_lib/sim-readiness-store.js) + migration [20260813180000_sim_readiness_grades.sql](api/_lib/migrations/20260813180000_sim_readiness_grades.sql), free MCP tool [api/_mcp3d/tools/sim-readiness.js](api/_mcp3d/tools/sim-readiness.js) (`grade_sim_readiness`), free REST [api/sim-readiness.js](api/sim-readiness.js) `→ /api/sim-readiness`, shared badge + details panel [public/sim-readiness-panel.js](public/sim-readiness-panel.js) (`<sim-readiness>`, used by [public/viewer.html](public/viewer.html) and [src/model-page.js](src/model-page.js)), write path in [api/_lib/forge-store.js](api/_lib/forge-store.js) `materializeCreation`, docs [docs/sim-readiness.md](docs/sim-readiness.md). | Live | The question a renderer never asks and a rigid-body solver always does: can this mesh be simulated as-is? Four verdicts (`simulation_ready`, `needs_scale`, `needs_repair`, `unusable`, plus `unreadable` for non-glTF bytes) over measurements derived entirely from the geometry: watertightness and winding via welded-position topology, real-world extents read as meters per the glTF unit convention, exact volume/centroid/inertia from the divergence theorem and tetrahedron covariance, and a convex-hull proxy with its convexity ratio. Nothing is guessed: where a value cannot be known from the mesh (true scale, density) the report says so. Grades are keyed by GLB content hash, not URL, so one row serves the forge creation, the Object Library entry, a remix and an arbitrary third-party URL; every finished generation is graded on the write path, so a model page renders its verdict with no extra request. Signed into the content credential as `simReadiness` (provenance v2), which is what makes the physics claim as forge-proof as the authorship claim. Free, no account, no coin surface, both stores. Tests: [tests/sim-readiness.test.js](tests/sim-readiness.test.js), [tests/api/sim-readiness-endpoint.test.js](tests/api/sim-readiness-endpoint.test.js), [tests/provenance-3d.test.js](tests/provenance-3d.test.js). || 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 eleven-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/irl/interactions.js b/api/irl/interactions.jsindex 6aa646b37..b019b7d62 100644--- a/api/irl/interactions.js+++ b/api/irl/interactions.js@@ -7,7 +7,7 @@* including any message the visitor left and where the encounter happened.** POST /api/irl/interactions- * { pinId, type: 'view'|'tap'|'message'|'pay', message?, deviceToken?,+ * { pinId, type: 'view'|'tap'|'message'|'pay'|'talk', message?, deviceToken?,* amount?, currencyMint?, network?, payload?, replyTo? }* agent_id + owner are taken from the pin, never the caller. Anonymous-friendly:* viewer attribution falls back to the device token. Repeat 'view's from the@@ -50,7 +50,9 @@ import { agentPayoutWallets } from '../_lib/agent-payout-wallets.js';// view | tap — passive/active sighting of the agent. message — a note left for// the owner. pay — an x402 settlement against the agent (see PAY note below).-const TYPES = new Set(['view', 'tap', 'message', 'pay']);+// `talk` marks the opening line of a live conversation with the agent (the /irl+// Talk panel). Only the event is recorded, never the transcript.+const TYPES = new Set(['view', 'tap', 'message', 'pay', 'talk']);// The surface the encounter happened on, so an owner can tell an IRL phone tap from a// smart-glasses (Frame / G1) encounter. Whitelisted — an unknown value collapses to// 'phone' rather than storing arbitrary caller text.diff --git a/data/changelog.json b/data/changelog.jsonindex acfecf188..2289edaa7 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,16 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-09-05",+ "title": "Invite people to an IRL agent with a visit link and a printable sign",+ "summary": "Every agent you have placed in the real world now has a visit link and a sign you can print and tape to the spot. Someone who scans it opens IRL with a banner naming the agent they came to meet, and the moment they are close enough the agent appears in their camera, flashes, and opens its card by itself: bio, reputation, wallet, tip QR, services, and a message box. That card also gained See it in AR. On iPhone it stands the agent on the real floor in Quick Look, animated, and the banner inside AR brings you straight back to the tip panel; other phones open the AR launcher. The link never contains a location, so you can post it anywhere and the agent still only shows to people who are actually there. Find it under Visit link on each placement in your dashboard.",+ "tags": [+ "feature",+ "improvement"+ ],+ "link": "/irl"+ },{"date": "2026-09-05","title": "Seven background jobs that were never running now run",diff --git a/docs/api-reference.md b/docs/api-reference.mdindex 94e7201dc..07ba00c48 100644--- a/docs/api-reference.md+++ b/docs/api-reference.md@@ -4135,7 +4135,9 @@ pin; non-owners get 403):POST /api/irl/interactions```-Body: `{ "pinId": "<uuid>", "type": "view" | "tap" | "message" | "pay", "message"?, ... }`.+Body: `{ "pinId": "<uuid>", "type": "view" | "tap" | "message" | "pay" | "talk", "message"?, ... }`.+`talk` records that a visitor opened a live conversation with the agent from the /irl Talk panel (one+row per conversation, never the transcript).`view` repeats from one device collapse within 5 min; a `pay` must carry a valid on-chainsettlement `signature` plus a `$THREE`/USDC `currencyMint` and is deduped per signature. Thepin's owner and agent are always taken from the pin, never the caller.diff --git a/docs/irl.md b/docs/irl.mdindex 3dac3221a..41ff755e6 100644--- a/docs/irl.md+++ b/docs/irl.md@@ -71,6 +71,14 @@ deletes it after an hour of never appearing.The **Share** button captures your camera feed and the placed agent as one photo, then, if you're the one who placed the pin, turns it into a permanent link at `three.ws/irl/s/<token>` instead of a bare file. Paste that link into X, iMessage, or Discord and it unfurls as the actual photo, with a "Place your own agent" button back to /irl. The link never carries a coordinate: only the agent's name and caption (if any) ever appear on the card, and it only exists for pins you left public — unpublishing a pin, or a pin under moderation review, is never shareable. If you tap Share before placing anything (no pin yet), it falls back to the plain native share sheet / photo download, same as before.+### Invite people with a visit link and a sign++A placement has a **visit link**, `three.ws/irl?pin=<id>`, and a printable sign at `/irl/sign?pin=<id>`. Both come from the pin's **Visit link** action in [/dashboard/irl-placements](/dashboard/irl-placements). Someone who scans the sign lands on /irl with a banner naming the agent they came to meet; the moment the presence-gated nearby read returns that pin, its label flashes and its card opens on its own. Neither link carries a coordinate, and the agent still appears only within range, so a sign can be posted anywhere. `?highlight=<id>` is an older alias of `?pin=`.++The card of a discovered agent also offers **See it in AR**: on iPhone it bakes that pin's model into an animated USDZ and opens ARKit Quick Look, with a banner tap that returns to the card with the tip QR open; everywhere else it opens the [AR launcher](./ar.md), which routes Android to native AR.++The full street-demo runbook (picking a spot for GPS, printing, what visitors see, on-site troubleshooting) is [Run an IRL street demo](./irl/street-demo.md).+## Money DropsReal value, escrowed at a real-world spot. A drop holds SOL, USDC, or $THREE in a fresh per-drop escrow wallet, funded on-chain by its creator. Claiming requires physically walking up: the same presence proof that gates every IRL read gates the claim, and the release lands on-chain in the claimer's own wallet. Drops can require a quiz answer, support multiple claims, and auto-refund the creator on expiry.diff --git a/docs/irl/street-demo.md b/docs/irl/street-demo.mdnew file mode 100644index 000000000..f500443b8--- /dev/null+++ b/docs/irl/street-demo.md@@ -0,0 +1,91 @@+# Run an IRL street demo: drop an agent at a real spot, let strangers walk up++This is the runbook for showing IRL to people who have never heard of three.ws: you place a 3D AI agent at a real location, put a sign there, and anyone who scans it sees the agent standing on that spot through their phone camera, taps it for its profile and wallet, and can stand it on the floor in AR. It was written for a demo in San Francisco, and everything in it applies to any city.++Nothing here needs an app or an account on the visitor's side. The owner needs a signed-in three.ws account so the pin is permanent.++---++## What the visitor experiences++1. They scan the sign. It opens `three.ws/irl?pin=<id>` in their phone browser.+2. IRL asks for camera and location (and motion, on iPhone, which takes one extra tap). A banner at the top says **"You're here to meet <agent name>"** and that the agent appears within 60 m of the spot.+3. Standing within range, the agent appears in their camera view, playing its idle animation and turning to look at them. Its name label flashes and its card opens on its own.+4. The card shows the agent's bio, on-chain reputation, its **Solana wallet chip**, a **Tap to tip in person** panel (a Solana Pay QR plus an "Open in wallet" deep link), any paid x402 services, a message box, and **View profile**.+5. **See it in AR** stands the agent on the real floor. iPhone opens ARKit Quick Look with the idle clip baked in; the Quick Look banner reads "Tip this agent" and tapping it brings them back to the card with the tip QR already open. Android and everything else go through the AR launcher (`/api/ar`), which routes Android to native AR.++Anyone who opens the link from somewhere else sees only the agent's name and a prompt to walk to the spot. The link never carries a coordinate, and the nearby read is presence-gated, so posting the link publicly is safe. See [How location works on IRL](/irl-privacy).++---++## Before the day++### 1. Pick the agent++Use a real agent from your account, not the anonymous companion. The card's wallet chip, tip QR, reputation and services all come from the agent identity, and the pin only links to one when you place it signed in with that agent selected.++- Check the agent's profile page (`/agents/<id>`): if it shows a Solana wallet chip there, the IRL card will show the same chip and the tip QR.+- **An agent wallet is provisioned on demand, not automatically.** A brand-new agent has none, and `GET /api/agents/<id>/solana` answers `"wallet": null` for it. The IRL card then renders with no wallet chip and no tip QR, which removes the part of the demo people react to most. Create one from the agent's wallet panel (or `POST /api/agents/<id>/solana` while signed in as the owner) and confirm the same endpoint returns an address before you print anything.+- If you want a paid interaction in the demo, give the agent a priced service from `/dashboard/monetize`. It appears on the card as a **Pay via x402** action.+- A humanoid rigged body plays the idle animation and gaze in the camera view. Any of the rigs the universal retargeter maps work (Mixamo, VRM, Avaturn, and the rest); a non-humanoid prop stands still.++### 2. Pick the spot++GPS decides whether people see the agent, so the spot matters more than anything else in this runbook.++- **Open sky.** Plazas, parks, waterfronts. In San Francisco that means places like the Embarcadero, the Ferry Building plaza, Dolores Park, Crissy Field, or the top of a park hill. Avoid narrow downtown streets between tall buildings: multipath GPS there can drift 50 m or more, and the nearby read caps at 60 m.+- **Somewhere people can stop.** Visitors need to stand still for a few seconds while GPS settles and the model loads.+- **Cellular signal.** The agent's model is fetched over the visitor's own connection.++The card shows the pin's placement accuracy, and the ring under the agent goes amber above 25 m. If you see amber when you place it, move to clearer sky and place again.++### 3. Place the pin++On your phone, signed in, at the spot:++1. Open [/irl](/irl), grant camera, location, and motion.+2. Pick the agent (the avatar picker under the name).+3. Aim at the ground, tap **Move here** to set it down, then **Pin here**. On Android with ARCore, **Place in AR** anchors it to the detected floor with a pinch to size it; on iPhone, **Pin here** is the placement path.+4. Give it a caption. It shows on the sign and on the card.++Signed-in pins are permanent until you remove them. If you cannot be at the spot beforehand, **Place on map** in /irl drops it at a point you choose, and **Move on map** in the dashboard relocates it later.++The full placement walkthrough is [Place a 3D agent in your real environment](/docs/tutorials/place-agent-irl).++### 4. Print the sign++Open [/dashboard/irl-placements](/dashboard/irl-placements), find the pin, and tap **Visit link**. The modal shows the QR, the link to copy, and **Print a sign**, which opens `/irl/sign?pin=<id>`: the agent's name, thumbnail and bio, the QR, three steps for the visitor, and the link in plain text. Choose **Sign** (landscape) or **Poster** (a large QR for a vertical sheet) and print. A laminated Letter sheet at chest height reads fine from two metres.++Test the sign with your own phone before you leave: scan it, walk 70 m away, confirm the banner says the agent is out of range, walk back, confirm the card opens.++---++## On the day++- **Your phone is the demo screen too.** The dashboard's **View in IRL** opens the same visit link, so you can show the walk-up while a visitor does it.+- **Talk through the three taps:** scan, allow, look around. The banner carries the rest.+- **Show the tip.** Open the card, expand **Tap to tip in person**, and let someone scan the Solana Pay QR with Phantom or Solflare. The agent's wallet is a real address; a tip lands on-chain.+- **Show it on the floor.** On an iPhone, **See it in AR** is the moment people photograph.+- **Messages and taps land in your dashboard.** The placements page lists every message, tap and pay under the pin, and the inbox lets you reply. `GET /api/irl/analytics` (admin) has the rollup afterwards.++---++## Troubleshooting on site++| Symptom | Cause | Fix |+|---|---|---|+| Banner never changes from "You're here to meet" | Visitor is outside 60 m, or their GPS fix is far off | Move to open sky, wait ten seconds, check the accuracy line on the card once it opens |+| "Enable location" chip in the top bar | Location was denied | Tap the chip; on iPhone, Settings > Safari > Location if the prompt is gone |+| Agent appears but does not move | Motion permission not granted (iPhone), or a non-humanoid body | Tap the motion chip; humanoid rigs animate, props do not |+| "See it in AR" is missing | The pin's model is not an https GLB | Re-place the pin with a hosted avatar from your account |+| Banner says the agent has moved on | The pin expired (anonymous pins last 7 days) or was removed | Place it again signed in and print a fresh sign |+| Visitors see nothing at all, you see the agent | Your device owns the pin; theirs reads nearby only within range | Have them stand where you placed it, not where you are now |++---++## Related++- [IRL overview](/docs/irl): what IRL is, Money Drops, World Lines, the SDK+- [How location works on IRL](/irl-privacy) and the [threat model](/docs/irl/THREAT-MODEL)+- [Place a 3D agent in your real environment](/docs/tutorials/place-agent-irl)+- [AR and WebXR reference](/docs/ar): the device routing behind "See it in AR"diff --git a/docs/nav.json b/docs/nav.jsonindex 45848d35b..e5d9a5597 100644--- a/docs/nav.json+++ b/docs/nav.json@@ -531,6 +531,10 @@"label": "IRL (agents in the real world)","path": "irl"},+ {+ "label": "IRL street demo (visit links and signs)",+ "path": "irl/street-demo"+ },{"label": "World Lines (proof of presence)","path": "world-lines"diff --git a/docs/tutorials/place-agent-irl.md b/docs/tutorials/place-agent-irl.mdindex ac26a4a86..9fac42deb 100644--- a/docs/tutorials/place-agent-irl.md+++ b/docs/tutorials/place-agent-irl.md@@ -237,6 +237,7 @@ This is fundamentally different from viewing a single model in AR. If you only n### See also- [IRL — open the product](/irl) — place your agent now+- [Run an IRL street demo](/docs/irl/street-demo): visit links, printable signs, and what strangers see when they walk up- [How location works on IRL](/irl-privacy) — the full privacy model, sensor-by-sensor- [Tutorial: Place your 3D model in AR](/docs/tutorials/view-in-ar) — the single-model viewer (Quick Look / Scene Viewer / WebXR)- [AR & WebXR reference](/docs/ar) — the underlying AR methods and programmatic APIdiff --git a/public/changelog.json b/public/changelog.jsonindex 7e0e29551..e09e09ccf 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-09-05T16:12:13.200Z",+ "generated_at": "2026-09-05T16:13:12.871Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -33284,7 +33284,7 @@"date": "2026-06-13","type": "launch","title": "IRL",- "summary": "Place a 3D avatar in your real environment. Camera AR passthrough, joystick movement, and tap-to-place 3D objects on your floor.",+ "summary": "Pin a 3D AI agent at a real place and meet the ones around you. Walk up, see it through your camera, talk to it out loud, view it in AR on your own floor, and pay it on the spot.","link": "/irl","tags": ["launch"diff --git a/public/changelog.xml b/public/changelog.xmlindex cb3d28863..1c963ee6d 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -25348,7 +25348,7 @@ And all of it is public. Oracle Lab publishes the actual model: every weight, th<guid isPermaLink="false">2026-06-13:IRL</guid><pubDate>Sat, 13 Jun 2026 12:00:00 GMT</pubDate><category>launch</category>- <description>Place a 3D avatar in your real environment. Camera AR passthrough, joystick movement, and tap-to-place 3D objects on your floor.</description>+ <description>Pin a 3D AI agent at a real place and meet the ones around you. Walk up, see it through your camera, talk to it out loud, view it in AR on your own floor, and pay it on the spot.</description></item><item><title>Scene Composer</title>diff --git a/public/features.json b/public/features.jsonindex a68046deb..9dac72b80 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-09-05T16:12:13.190Z",+ "generated_at": "2026-09-05T16:13:12.862Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -229,7 +229,7 @@{"path": "/irl","title": "IRL",- "description": "Place a 3D avatar in your real environment. Camera AR passthrough, joystick movement, and tap-to-place 3D objects on your floor.",+ "description": "Pin a 3D AI agent at a real place and meet the ones around you. Walk up, see it through your camera, talk to it out loud, view it in AR on your own floor, and pay it on the spot.","added": "2026-06-13","auth": null,"indexable": true,diff --git a/public/llms-full.txt b/public/llms-full.txtindex cfca338be..880391c0b 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -144,7 +144,7 @@ Drive a 3D avatar around with a joystick or WASD, then toggle the back camera foURL: https://three.ws/irl-Place a 3D avatar in your real environment. Camera AR passthrough, joystick movement, and tap-to-place 3D objects on your floor.+Pin a 3D AI agent at a real place and meet the ones around you. Walk up, see it through your camera, talk to it out loud, view it in AR on your own floor, and pay it on the spot.### Printable IRL signdiff --git a/public/llms.txt b/public/llms.txtindex 2e498082e..ccf4f9f72 100644--- a/public/llms.txt+++ b/public/llms.txt@@ -52,7 +52,7 @@ Entry points into the product.- [AgenC · Task Room](https://three.ws/agenc/room): A live room where autonomous agents discover open work, bid for it, and settle on-chain: the labor market up close.- [Talking Avatar Video](https://three.ws/create/video): Turn a three.ws avatar into a talking-head video: upload your audio and export a lip-synced clip.- [Drive Your Avatar](https://three.ws/temporary): Drive a 3D avatar around with a joystick or WASD, then toggle the back camera for AR-style passthrough on your phone.-- [IRL](https://three.ws/irl): Place a 3D avatar in your real environment. Camera AR passthrough, joystick movement, and tap-to-place 3D objects on your floor.+- [IRL](https://three.ws/irl): Pin a 3D AI agent at a real place and meet the ones around you. Walk up, see it through your camera, talk to it out loud, view it in AR on your own floor, and pay it on the spot.- [Printable IRL sign](https://three.ws/irl/sign): Print a sign for a placed IRL agent: its name, thumbnail and a QR of the visit link. Scan it at the spot to open IRL, walk up, and meet the 3D AI agent in AR. Carries no coordinate.- [How location works on IRL](https://three.ws/irl-privacy): Placed agents are private by location: they appear only to people physically standing near them, never on a map or a list. What's shared, what isn't, and how your camera, motion, and location are used.- [Alpha Co-pilot: your agent narrates its own alpha](https://three.ws/alpha-copilot): Your 3D agent reads a real pump.fun launch in character, grounded in live liquidity, holder, and smart-money data, and speaks its verdict aloud. Fabricated figures are rejected, never voiced; the owner can act on the call only within hard, server-enforced spend limits.diff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex b718e06f6..36e153e39 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -352,7 +352,7 @@<a href="/irl"><span class="sm-title">IRL</span><span class="sm-path">/irl</span>- <span class="sm-desc">Place a 3D avatar in your real environment. Camera AR passthrough, joystick movement, and tap-to-place 3D objects on your floor.</span>+ <span class="sm-desc">Pin a 3D AI agent at a real place and meet the ones around you. Walk up, see it through your camera, talk to it out loud, view it in AR on your own floor, and pay it on the spot.</span></a></li><li>