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
build(pages): register the new surfaces in routes, pages, nav, docs index and regenerated feeds
nirholas2ec465224eba
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 6fdc70892..f7fea442f 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -8,8 +8,13 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Companion** (`/companion`): A 3D companion that delivers your important messages in person. Connect your own Telegram bot, calendar, inbox, or phone, give each contact their own avatar and voice, and hear only what clears your bar.- **Docs · 3D Vision: let an agent see the model** (`/docs/3d-vision`): Every text-to-3D API answers with a link to a binary an AI agent cannot open, so the agent that made the model cannot check its own work. This surface renders any GLB from several angles and hands the frames back as images a vision model actually sees, over MCP, REST or the @three-ws/see SDK.+- **Docs · Agent vitals: can it act?** (`/docs/agent-vitals`): Every liveness check was green while ten of twelve autonomous agents had not acted in weeks. Capability attestation models an agent's preconditions as a causal graph and returns the root blocker plus the command that fixes it, instead of a checklist of symptoms.- **Docs · Feedback** (`/docs/feedback`): Telling the corner companion what broke: the proactive ask at the moment of failure, the route, build SHA, and console errors captured for you, the severity and clustering rules, the report API, and the boundary that keeps untrusted visitor text from ever reaching anything with write access.+- **Docs · Terminal avatar** (`/docs/tty-avatar`): The @three-ws/tty-avatar package: any three.ws avatar or agent body rendered live in a terminal by a software rasterizer (truecolor half-blocks, braille, or plain ASCII), procedural moods, and Claude Code hooks that turn it into your coding agent's face.+- **Herald** (`/herald`): Deliver a message in person: a 3D character walks onto your page and tells the user what happened. Open SDK, one line of code, an accessible fallback, and a CLI that announces when your build finishes.+- **Portal** (`/portal`): Paste any web address and walk through it in 3D. Portal reads the page's real structure and builds a place from it: sections become buildings sized by what they say, links become doors you step into, images become billboards. Download the world as a GLB or embed it in your own site.- **Publishing to the Solana dApp Store** (`/docs/seeker-publishing`): The release runbook for the three.ws Seeker app: Publisher Portal setup, the release keystore, building and verifying a signed APK, and submitting it for review.+- **Terminal renderer** (`/tty`): curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.- **three.ws on iOS** (`/docs/ios-app`): What the App Store app adds on top of the website: the native share sheet, universal links, wallet deep links back to the page you left, real permission prompts, and an offline screen that recovers on its own.- **Agent history catches up on fast chains in days instead of weeks**: The cross-chain index read one window of blocks per chain every 15 minutes. That is enough to keep pace with a slow chain but not to close a gap on a fast one: Arbitrum was 18.4 million blocks behind and would have taken about six weeks to catch up, while most runs finished early with most of their time budget unused. Runs now spend that spare time on whichever chain is furthest behind, and do nothing extra when every chain is current. `[improvement]`- **Agent history on Base, Ethereum and Gnosis is moving again**: The cross-chain agent index had stopped advancing on three networks. A single unprintable byte inside an on-chain metadata string was rejected by the database, and because the index only records its position after a successful write, every following run re-read the same block and hit the same byte. Base had been frozen for 13 days, Gnosis for 15 and Ethereum for 4. Those bytes are now stripped on the way in, so the event is kept and the crawl moves past it. Registrations, ownership transfers, metadata edits and reputation attestations on those chains flow into agent profiles again. `[fix]`@@ -21,6 +26,8 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **The iOS app now exists in the repo, and the web half of it ships today**: three.ws is being packaged for the App Store as a native iOS app. The container and its Xcode project are in the repo, and the part that runs inside the website went live with this deploy: on iPhone the app will get a working share sheet, links that open the app instead of Safari, wallet sign-ins that return to the exact page you left, and a real offline screen. Nothing changes on the web. What is still outstanding is an Apple Developer organization account, app icons, and push notifications. (`/docs/ios-app`) `[feature, infra]`- **The Seeker app now runs full-screen, and its release process is written down**: The three.ws app on Solana Seeker verifies against the site and opens full-screen on its own home screen, with no browser address bar. Two bugs found while testing it on a real Android build are fixed: the app only recognised your Seed Vault wallet on the first page you opened, so signing in from the login page said no wallet was found, and the login page never loaded the wallet at all. A new guide documents exactly how a release reaches the Solana dApp Store, from the publisher account through building and submitting the app. (`/docs/seeker-publishing`) `[fix, docs]`- **Your agent now tells you the important things in person**: Notifications no longer wait behind a badge. When something worth stopping for lands while you are on the site (a sale, money in, a 3D generation finishing, anything touching your account), your corner companion turns to you, plays a gesture, and says it out loud with a link straight to it. If the companion is switched off it is summoned for that one message and walks off again, without turning itself back on. It is a real delivery channel next to in-app, push, email and Telegram: toggle it per category in Settings, and there is a Turn off control in the bubble that silences it in that browser instantly. It only ever announces unread notifications under fifteen minutes old, says each one exactly once, caps itself at two per visit, and never speaks into a background tab. Nothing is spoken aloud unless you already turned on the companion's voice; otherwise it is text in the bubble, which screen readers announce too. (`/notifications`) `[feature]`+- **Your agents can now tell you why they are not doing anything**: An audit found ten of twelve autonomous trading agents had not acted in weeks while every health check reported them perfectly fine: the container was up, the feed was streaming, every strategy was armed. Liveness measures the process, but acting needs a whole chain of preconditions the process knows nothing about. A new open-source package, @three-ws/agent-vitals, models those preconditions as a causal graph and answers the real question: can this agent act right now, and if not, what is the one thing to fix. It reports root causes instead of symptoms, so a stale deployment that killed a model chain that starved a decision queue reads as one item with one command, not three red rows to guess between. Run npm run agent:vitals for the fleet, or GET /api/agents/vitals. (`/docs/agent-vitals`) `[feature, sdk, infra]`+- **Your avatar now runs in a terminal, and it can be your coding agent's face**: A new package, @three-ws/tty-avatar, draws any three.ws avatar or agent body live in a terminal window: one npx command, no browser, no GPU, 24 frames a second in colour. It has moods (thinking, working, happy, error, asleep) that work on any model without a rig, and one command wires it to Claude Code so the avatar thinks while the agent reads your prompt, nods while it edits files, shakes when a tool fails and bounces when it finishes, with a caption naming what it is doing. Every avatar and agent page now has the command in its Embed tab. (`/docs/tty-avatar`) `[feature, sdk]`## 2026-08-27diff --git a/STRUCTURE.md b/STRUCTURE.mdindex 07c4467fe..3b9979d45 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -24,6 +24,7 @@ bottom.| Docs World (immersive 3D docs) | [pages/docs-world.html](pages/docs-world.html) `→ /docs/world`, app [src/docs-world/](src/docs-world) (world/player/controls/overlays), styles [public/docs-world.css](public/docs-world.css), shared manifest [docs/nav.json](docs/nav.json) | Live | The documentation as a walkable place: each section of the docs sidebar is a glowing pavilion on a ring; walk up (WASD / touch joystick, four shared camera modes via [src/game/camera-modes.js](src/game/camera-modes.js)) or tap one to list its pages, and read the live markdown in an in-world DOM reader ([src/shared/markdown.js](src/shared/markdown.js)). One content source: both surfaces read `docs/nav.json` + `/docs/<slug>.md`, so classic and immersive docs cannot drift. Deep links mirror the classic hash routes (`/docs/world#forge`); the classic header's "3D world" button carries the open page across. Avatar is the platform's default rigged body (the same one `/walk` uses, since the agent mannequin ships unskinned and cannot be clip-driven) or any rigged GLB via `?avatar=`, animated by the canonical clip library. No-WebGL devices get a designed fallback routing to `/docs`. Docs: [docs/docs-world.md](docs/docs-world.md). Tests: [tests/docs-world.test.js](tests/docs-world.test.js) || React avatar creator | [avatar-sdk/](avatar-sdk) `→ /react` `/creator` | Published as `@three-ws/avatar` | Same package, React subpath || Avatar CLI (manifests in the build pipeline) | [packages/avatar-cli/](packages/avatar-cli), landing [pages/avatar-cli.html](pages/avatar-cli.html) `→ /avatar-cli`, styles [public/avatar-cli.css](public/avatar-cli.css), page runtime [src/avatar-cli-page.js](src/avatar-cli-page.js) | Published as `@three-ws/avatar-cli` | The terminal half of the avatar story, and the half that makes an avatar auditable. Four commands over one file: `init` scaffolds a schema-valid manifest from a wallet plus a mesh (reading the GLB once to compute its SHA-256 and size, so the document cannot disagree with the bytes it was built from), `validate` checks it against [packages/avatar-schema/](packages/avatar-schema) and exits non-zero so it works as a build gate, `hash` prints a bare digest that composes in a shell, and `preview` emits a resolver URL, an `<agent-3d>` snippet paired with the loader that registers it, and a zero-install iframe. Offline and deterministic throughout: no account, no API key, no network call, which is what makes it safe in a release script. `preview` warns instead of printing a dead snippet when `mesh.uri` is still a local `file://` path. The landing page proves the emitted markup by rendering it live rather than screenshotting it. Docs: [docs/avatar-cli.md](docs/avatar-cli.md) `→ /docs/avatar-cli`, tutorial [docs/tutorials/ship-an-avatar-manifest.md](docs/tutorials/ship-an-avatar-manifest.md). Tests: [packages/avatar-cli/test/](packages/avatar-cli/test) |+| Terminal avatar (any avatar or agent body, live in a terminal) | [packages/tty-avatar/](packages/tty-avatar) | Published as `@three-ws/tty-avatar` | `npx @three-ws/tty-avatar <avatar id>` draws the avatar in colour at 24 fps in any terminal: a software rasterizer ([packages/tty-avatar/src/raster.js](packages/tty-avatar/src/raster.js), z-buffered scanline fill, key + fill + rim lighting) over a subpixel grid that three encoders turn into truecolor half-blocks, braille, or plain ASCII ([packages/tty-avatar/src/encode.js](packages/tty-avatar/src/encode.js)). Sources: a `.glb` path, a URL, an avatar id (`/api/avatars/:id`), `agent:<id>` (the agent's bound body via `/api/agents/:id`), or a three.ws page URL. Moods are procedural whole-body motion ([packages/tty-avatar/src/moods.js](packages/tty-avatar/src/moods.js)), so a rigless prop animates too, and they cross-fade. The point of it: `install-hooks --write` merges nine Claude Code hooks whose command is a bare `cat > ~/.three-ws/tty-avatar/event.json` (zero startup cost per tool call), the viewer polls that file and maps each payload to a mood and a caption ([packages/tty-avatar/src/state.js](packages/tty-avatar/src/state.js)), so the avatar thinks, works, errors, asks and celebrates in step with the agent. Every avatar and agent page's Embed tab prints the command ([src/avatar-page.js](src/avatar-page.js)). Docs: [docs/tty-avatar.md](docs/tty-avatar.md) `→ /docs/tty-avatar`. Tests: [packages/tty-avatar/test/](packages/tty-avatar/test) (builds a real GLB in memory and exercises loader, rasterizer, encoders, moods, state bridge, hook installer and CLI) || Rig Doctor (will this GLB animate?) | [pages/rig-doctor.html](pages/rig-doctor.html) `→ /rig-doctor`, analysis [src/rig-report.js](src/rig-report.js), page runtime [src/rig-doctor-page.js](src/rig-doctor-page.js), styles [public/rig-doctor.css](public/rig-doctor.css) | Live | The answer to the most expensive silent failure on the platform: a rig loads, renders, and never moves, because clips address bones by name and this skeleton calls them something else. Drop a `.glb` and the page reads its glTF JSON chunk in the browser, names the authoring convention (twelve fingerprints, from Mixamo and Ready Player Me to Unreal, VRM, MMD, Biped, Rigify, and HumanIK), and scores four limb groups independently against the 52-joint canonical set, because "62% covered" is not actionable and "your legs will not move" is. The verdict mirrors the runtime gate in [src/animation-manager.js](src/animation-manager.js) exactly (a skinned mesh plus 8 mapped joints), so it predicts rather than approximates. It then does two things a report cannot: mounts the real [src/avatar-pose.js](src/avatar-pose.js) stage on a blob URL of the file so the user watches their own rig perform the actual clip library, and runs [src/glb-canonicalize.js](src/glb-canonicalize.js) in-browser to hand back a repaired GLB with canonical joint names. Nothing is uploaded: the only network calls are for the clip library and the sample rigs. Also emits a schema-v1 manifest, an `<agent-3d>` snippet, and the matching [packages/avatar-cli/](packages/avatar-cli) commands. Docs: [docs/rig-doctor.md](docs/rig-doctor.md) `→ /docs/rig-doctor`. Tests: [tests/rig-report.test.js](tests/rig-report.test.js) || The pump.fun pill (`/pill`) | [pages/pill.html](pages/pill.html) `→ /pill` + [src/pill.js](src/pill.js) + [src/pill.css](src/pill.css), rigger [scripts/rig-pill-mascot.py](scripts/rig-pill-mascot.py), decimator [scripts/decimate-glb.mjs](scripts/decimate-glb.mjs), assets [public/avatars/pumpfun-pill-cupsey.glb](public/avatars/pumpfun-pill-cupsey.glb) (rigged) + `pumpfun-pill-cupsey-static.glb` (the rigger's input) | Live | pump.fun verified $THREE as officially ours, and this is the thank-you: their pill mascot rigged, animated, and drivable in the browser. WASD or a touch joystick walks it, Shift runs, Space jumps, drag orbits, and the toolbar fires wave/jump/dance. The stage plays the model's own six embedded clips, so it needs no retargeting at load and no clip fetch. The model could not go through [workers/rig](workers/rig): a capsule with four stubby nubs has no neck, no separate head and no long limbs for a humanoid predictor to find, so it got its own pipeline. That pipeline is general to capsule-with-nubs mascots, not to this character: limbs discovered from the mesh's distance transform, medial curves traced with a minimum-cost path, skin weights decided by walking each vertex inward to the medial axis of the part it is skin for (straight-line and geodesic distance both weld the raised hand to the cheek it rests against), and the neutral standing pose baked into the shipped geometry so bind and rest coincide. Canonical bone names mean the whole clip library retargets onto it at 100% coverage. Docs: [docs/pill-mascot.md](docs/pill-mascot.md) `→ /docs/pill-mascot`. Tests: [tests/pill-rig.test.js](tests/pill-rig.test.js) || Talking page guide | [page-agent-sdk/](page-agent-sdk) | Published as `@three-ws/page-agent` | Drop-in rigged 3D agent that narrates any page + visitor avatar picker. `<page-agent>` web component. Rigged-only catalog. `preset="…"` resolves one of 5 personas (greeting/role/suggested-prompt chips/tool allowlist) — see [page-agent-sdk/README.md#persona-presets](page-agent-sdk/README.md#persona-presets). See [page-agent-sdk/PUBLISHING.md](page-agent-sdk/PUBLISHING.md) |@@ -375,6 +376,7 @@ npm).| `@three-ws/guardian` | [packages/guardian/](packages/guardian) | `api/guardian/`, Granite Guardian | Content safety / moderation for agents || `@three-ws/glb-tools` | [packages/glb-tools/](packages/glb-tools) | `_lib/glb-inspect.js`, `glb-themer.js`, `bake.js` | Inspect, re-theme, and bake GLBs from CLI/CI || `@three-ws/agent-guards` | [packages/agent-guards/](packages/agent-guards) | `_lib/agent-spend-policy.js`, `agent-trade-guards.js` | Spend + trade guardrails for autonomous agents |+| `@three-ws/agent-vitals` | [packages/agent-vitals/](packages/agent-vitals) | `_lib/agent-vitals/`, `api/agents/vitals.js`, `npm run agent:vitals` | Capability attestation for autonomous agents: not "is it up" but "can it act". Models an agent's preconditions as a causal graph and returns the ROOT blocker plus the command that fixes it, instead of a checklist of symptoms. Docs: [docs/agent-vitals.md](docs/agent-vitals.md) || `@three-ws/agent-runtime` | [packages/agent-runtime/](packages/agent-runtime) | `api/agent/guard.js`, `api/agent/run.js`, `chat/src/guard.js` | Agent decision loop + seven-layer GuardChain (blacklist, intervention, capability, permission, trade, spend, x402), hash-chained action ledger, tx pipeline; server agent loop with read-only tools || `@three-ws/skill-license` | [packages/skill-license/](packages/skill-license) | `contracts/skill-license/`, `api/skills/` | On-chain skill licenses (SPL NFT + PDA) mint/verify || `@three-ws/mocap` | [packages/mocap/](packages/mocap) | `api/mocap/` | Motion-capture clips → avatar animation |diff --git a/data/changelog.json b/data/changelog.jsonindex 402519bd9..ea1ea230f 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -25158,6 +25158,27 @@"infra"],"link": "/docs/ios-app"+ },+ {+ "date": "2026-08-28",+ "title": "Your avatar now runs in a terminal, and it can be your coding agent's face",+ "summary": "A new package, @three-ws/tty-avatar, draws any three.ws avatar or agent body live in a terminal window: one npx command, no browser, no GPU, 24 frames a second in colour. It has moods (thinking, working, happy, error, asleep) that work on any model without a rig, and one command wires it to Claude Code so the avatar thinks while the agent reads your prompt, nods while it edits files, shakes when a tool fails and bounces when it finishes, with a caption naming what it is doing. Every avatar and agent page now has the command in its Embed tab.",+ "tags": [+ "feature",+ "sdk"+ ],+ "link": "/docs/tty-avatar"+ },+ {+ "date": "2026-08-28",+ "title": "Your agents can now tell you why they are not doing anything",+ "summary": "An audit found ten of twelve autonomous trading agents had not acted in weeks while every health check reported them perfectly fine: the container was up, the feed was streaming, every strategy was armed. Liveness measures the process, but acting needs a whole chain of preconditions the process knows nothing about. A new open-source package, @three-ws/agent-vitals, models those preconditions as a causal graph and answers the real question: can this agent act right now, and if not, what is the one thing to fix. It reports root causes instead of symptoms, so a stale deployment that killed a model chain that starved a decision queue reads as one item with one command, not three red rows to guess between. Run npm run agent:vitals for the fleet, or GET /api/agents/vitals.",+ "tags": [+ "feature",+ "sdk",+ "infra"+ ],+ "link": "/docs/agent-vitals"}]}diff --git a/data/pages.json b/data/pages.jsonindex 012cae35c..553f6a2af 100644--- a/data/pages.json+++ b/data/pages.json@@ -250,6 +250,15 @@"changefreq": "weekly","added": "2026-06-17"},+ {+ "path": "/portal",+ "title": "Portal",+ "description": "Paste any web address and walk through it in 3D. Portal reads the page's real structure and builds a place from it: sections become buildings sized by what they say, links become doors you step into, images become billboards. Download the world as a GLB or embed it in your own site.",+ "priority": 0.8,+ "changefreq": "weekly",+ "added": "2026-08-28",+ "showcase": true+ },{"path": "/companion","title": "Companion",@@ -259,6 +268,15 @@"added": "2026-08-28","showcase": true},+ {+ "path": "/herald",+ "title": "Herald",+ "description": "Deliver a message in person: a 3D character walks onto your page and tells the user what happened. Open SDK, one line of code, an accessible fallback, and a CLI that announces when your build finishes.",+ "priority": 0.7,+ "changefreq": "weekly",+ "added": "2026-08-28",+ "showcase": true+ },{"path": "/notifications","title": "Notifications",@@ -941,6 +959,14 @@"priority": 0.6,"changefreq": "weekly","added": "2026-07-31"+ },+ {+ "path": "/tty",+ "title": "Terminal renderer",+ "description": "curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.",+ "priority": 0.6,+ "changefreq": "monthly",+ "added": "2026-08-28"}]},@@ -2448,6 +2474,14 @@"changefreq": "monthly","added": "2026-08-16"},+ {+ "path": "/docs/tty-avatar",+ "title": "Docs · Terminal avatar",+ "description": "The @three-ws/tty-avatar package: any three.ws avatar or agent body rendered live in a terminal by a software rasterizer (truecolor half-blocks, braille, or plain ASCII), procedural moods, and Claude Code hooks that turn it into your coding agent's face.",+ "priority": 0.6,+ "changefreq": "monthly",+ "added": "2026-08-28"+ },{"path": "/docs/site-performance","title": "Docs · Site load performance",@@ -4052,7 +4086,7 @@},{"path": "/docs/3d-vision",- "title": "Docs \u00b7 3D Vision: let an agent see the model",+ "title": "Docs · 3D Vision: let an agent see the model","description": "Every text-to-3D API answers with a link to a binary an AI agent cannot open, so the agent that made the model cannot check its own work. This surface renders any GLB from several angles and hands the frames back as images a vision model actually sees, over MCP, REST or the @three-ws/see SDK.","priority": 0.6,"changefreq": "monthly",@@ -5231,7 +5265,15 @@"priority": 0.5,"changefreq": "monthly","added": "2026-08-24"- }+ },+ {+ "path": "/docs/agent-vitals",+ "title": "Docs \u00b7 Agent vitals: can it act?",+ "description": "Every liveness check was green while ten of twelve autonomous agents had not acted in weeks. Capability attestation models an agent's preconditions as a causal graph and returns the root blocker plus the command that fixes it, instead of a checklist of symptoms.",+ "priority": 0.6,+ "changefreq": "monthly",+ "added": "2026-08-28"+ }]},{diff --git a/docs/nav.json b/docs/nav.jsonindex 7e903b80c..3360b3ead 100644--- a/docs/nav.json+++ b/docs/nav.json@@ -885,6 +885,10 @@"label": "Avatar CLI","path": "avatar-cli"},+ {+ "label": "Terminal avatar (tty)",+ "path": "tty-avatar"+ },{"label": "Rig Doctor (will my GLB animate?)","path": "rig-doctor"diff --git a/docs/start-here.md b/docs/start-here.mdindex 5a599f0f3..97a707012 100644--- a/docs/start-here.md+++ b/docs/start-here.md@@ -114,6 +114,7 @@ Curious what happens between the prompt and the model? [How the Forge works](./h- **Browsing what the agents bought?** → [The Agent-Forged Gallery](./forged.md): 3D props purchased by autonomous agents with real USDC over x402, each carrying its paying wallet, price, and on-chain settlement receipt- **Need a ready-made character or prop?** → The [Character Library](./character-library.md) has 106 rigged characters (one click into the Studio, Animation Studio, or an embed) and the [Object Library](./object-library.md) has hundreds of CC0 props with live preview, AR placement, and direct GLB download- **Rendering avatars outside the viewer?** → [Media and render API](./media-api.md): avatar PNG renders for `<img>` tags, posed clip renders, the runtime GLB optimizer, the CORS-open model proxy, and the free vision and speech-to-text endpoints; companion to the [3D API](./3d-api.md)+- **Want the avatar in your terminal, or as your coding agent's face?** → [Terminal avatar](./tty-avatar.md): `npx @three-ws/tty-avatar <avatar id>` draws any avatar or agent body live in a terminal (truecolor half-blocks, braille, or plain ASCII, no browser or GPU), and `install-hooks --write` ties its moods to Claude Code so it thinks while the agent reads, works while it edits, and celebrates when it finishes- **Putting avatars in your build pipeline?** → [Avatar CLI](./avatar-cli.md): four offline commands that scaffold a hash-anchored avatar manifest from a wallet and a GLB, validate it against the published schema, and print an embed snippet that renders. Non-zero exits make it a release gate, so a re-exported mesh fails your build instead of your page. [Ship an avatar manifest](./tutorials/ship-an-avatar-manifest.md) is the guided walkthrough- **Uploaded an avatar that loads but never moves?** → [Rig Doctor](./rig-doctor.md): drop the `.glb` and find out in a second why. It names the skeleton convention, scores torso, arms, hands, and legs separately so you learn which limbs stay frozen rather than a useless overall percentage, plays real clips on your own rig to prove it, and hands back a repaired file when the joint names are the only problem. Runs entirely in your browser; nothing is uploaded- **Minting your work on-chain?** → [Minted 3D assets](./minted.md): the /minted gallery of avatars minted as Metaplex Core NFTs, the opt-in mint flow, baked provenance, and enforced remix royaltiesdiff --git a/package-lock.json b/package-lock.jsonindex f158287ca..4b5e400fd 100644--- a/package-lock.json+++ b/package-lock.json@@ -57,12 +57,15 @@"packages/clash-mcp","packages/tutor-mcp","packages/loom-mcp",+ "packages/companion-sdk","walk-sdk","tour-sdk","packages/alibaba-cloud-mcp","packages/tool-sdk","packages/spatial-mcp",- "packages/agent-runtime"+ "packages/agent-runtime",+ "packages/glb-diff",+ "packages/tty-avatar"],"dependencies": {"@0xsplits/splits-sdk": "^6.5.0",@@ -128,6 +131,7 @@"@sparticuz/chromium-min": "^148.0.0","@tetsuo-ai/protocol": "^0.2.0","@tetsuo-ai/sdk": "^1.4.0",+ "@three-ws/companion": "*","@three-ws/solana-agent": "file:solana-agent-sdk","@upstash/qstash": "^2.11.0","@upstash/ratelimit": "^2.0.5",@@ -16650,6 +16654,10 @@"resolved": "packages/clash-mcp","link": true},+ "node_modules/@three-ws/companion": {+ "resolved": "packages/companion-sdk",+ "link": true+ },"node_modules/@three-ws/copy-mcp": {"resolved": "packages/copy-mcp","link": true@@ -16658,6 +16666,10 @@"resolved": "packages/defi-utils","link": true},+ "node_modules/@three-ws/glb-diff": {+ "resolved": "packages/glb-diff",+ "link": true+ },"node_modules/@three-ws/ibm-watsonx-mcp": {"resolved": "packages/ibm-watsonx-mcp","link": true@@ -16754,6 +16766,10 @@"resolved": "tour-sdk","link": true},+ "node_modules/@three-ws/tty-avatar": {+ "resolved": "packages/tty-avatar",+ "link": true+ },"node_modules/@three-ws/tutor-mcp": {"resolved": "packages/tutor-mcp","link": true@@ -40171,6 +40187,29 @@"node": ">=20"}},+ "packages/companion-sdk": {+ "name": "@three-ws/companion",+ "version": "0.1.0",+ "license": "Apache-2.0",+ "bin": {+ "companion": "src/cli.mjs"+ },+ "engines": {+ "node": ">=18"+ },+ "peerDependencies": {+ "@modelcontextprotocol/sdk": ">=1.0.0",+ "imapflow": ">=1.0.0"+ },+ "peerDependenciesMeta": {+ "@modelcontextprotocol/sdk": {+ "optional": true+ },+ "imapflow": {+ "optional": true+ }+ }+ },"packages/copy-mcp": {"name": "@three-ws/copy-mcp","version": "0.1.2",@@ -40197,6 +40236,29 @@"node": ">=18"}},+ "packages/glb-diff": {+ "name": "@three-ws/glb-diff",+ "version": "0.1.0",+ "license": "Apache-2.0",+ "dependencies": {+ "@gltf-transform/core": "^4.4.0",+ "@gltf-transform/extensions": "^4.4.0"+ },+ "bin": {+ "glb-diff": "src/cli.js"+ },+ "engines": {+ "node": ">=18"+ },+ "peerDependencies": {+ "meshoptimizer": "^1.1.1"+ },+ "peerDependenciesMeta": {+ "meshoptimizer": {+ "optional": true+ }+ }+ },"packages/ibm-watsonx-mcp": {"name": "@three-ws/ibm-watsonx-mcp","version": "0.2.1",@@ -40507,6 +40569,22 @@"node": ">=18"}},+ "packages/tty-avatar": {+ "name": "@three-ws/tty-avatar",+ "version": "0.1.0",+ "license": "Apache-2.0",+ "dependencies": {+ "@gltf-transform/core": "^4.4.0",+ "@gltf-transform/extensions": "^4.4.0",+ "meshoptimizer": "^1.1.1"+ },+ "bin": {+ "tty-avatar": "bin/tty-avatar.js"+ },+ "engines": {+ "node": ">=18"+ }+ },"packages/tutor-mcp": {"name": "@three-ws/tutor-mcp","version": "0.1.1",diff --git a/package.json b/package.jsonindex 42cfc8594..42cba0e70 100644--- a/package.json+++ b/package.json@@ -113,12 +113,15 @@"packages/clash-mcp","packages/tutor-mcp","packages/loom-mcp",+ "packages/companion-sdk","walk-sdk","tour-sdk","packages/alibaba-cloud-mcp","packages/tool-sdk","packages/spatial-mcp",- "packages/agent-runtime"+ "packages/agent-runtime",+ "packages/glb-diff",+ "packages/tty-avatar"],"main": "src/app.js","browserslist": [@@ -232,6 +235,7 @@"audit:web:provision": "node scripts/provision-audit-account.mjs","snapshot:authed": "node scripts/page-snapshot.mjs --authed","ui:review": "node scripts/ui-review.mjs",+ "agent:vitals": "node scripts/agent-vitals.mjs","bots:report": "node scripts/trading-bot-report.mjs","logs": "node scripts/gcp-logs.mjs","logs:tail": "node scripts/gcp-logs.mjs --follow",@@ -341,6 +345,9 @@"event:capacity": "node scripts/play-capacity-smoke.mjs","event:failover": "node --env-file=.env scripts/event-dependency-failover.mjs","deploy": "npm run build:all && npm run check:dist && vercel --local-config vercel.json --prod",+ "feedback:repro": "node --env-file-if-exists=.env.local scripts/feedback-repro.mjs",+ "test:agent-vitals": "node --test packages/agent-vitals/test/*.test.js",+ "test:witness": "node --test packages/witness/test/*.test.js","build:info": "node scripts/write-build-info.mjs","build:info:snapshot": "node scripts/write-build-info.mjs --snapshot","build:gcp": "npm run check:conflicts && npm run check:browser-graph && npm run check:tdz-bootstrap && npm run ensure:avatar-studio && npm run build:info:snapshot && npm run build:lib:full && npm run build:avatar-sdk && npm run build:chat && npm run build && npm run publish:lib && npm run build:info && npm run check:dist && npm run check:pages",@@ -460,6 +467,7 @@"@sparticuz/chromium-min": "^148.0.0","@tetsuo-ai/protocol": "^0.2.0","@tetsuo-ai/sdk": "^1.4.0",+ "@three-ws/companion": "*","@three-ws/solana-agent": "file:solana-agent-sdk","@upstash/qstash": "^2.11.0","@upstash/ratelimit": "^2.0.5",diff --git a/packages/README.md b/packages/README.mdindex ed29a39cb..7035aa1ce 100644--- a/packages/README.md+++ b/packages/README.md@@ -58,6 +58,7 @@ Publishable npm packages for the three.ws platform: client SDKs, agent tooling,| [three-token-mcp](three-token-mcp/README.md) | MCP server that lets agents price, hold, and burn $THREE on-chain via the live token rail. || [threews-avatar-mcp](threews-avatar-mcp/README.md) | MCP server that renders a live rotatable avatar inline, plus embed iframe and metadata. || [tool-sdk](tool-sdk/README.md) | Typed tool authoring for three.ws MCP servers, with per-tool permission manifests. |+| [tty-avatar](tty-avatar/README.md) | A live 3D avatar in the terminal: any GLB or three.ws avatar/agent rendered to truecolor half-blocks or braille, with moods, and Claude Code hooks that make it your coding agent's face. || [tutor-mcp](tutor-mcp/README.md) | MCP server for the Pay-As-You-Learn tutor ledger: itemized running tab and attested invoice. || [vanity](vanity/README.md) | WASM-accelerated Solana vanity address mining in the browser or Node, with a paid x402 fallback. || [vanity-mcp](vanity-mcp/README.md) | Read-only MCP server for the vanity grind-bounty market and proof-of-grind rarity gallery. |diff --git a/public/changelog.json b/public/changelog.jsonindex c604cf947..0a331003c 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-28T03:26:00.152Z",+ "generated_at": "2026-08-28T03:32:47.846Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -26,6 +26,16 @@"launch"]},+ {+ "date": "2026-08-28",+ "type": "launch",+ "title": "Docs · Agent vitals: can it act?",+ "summary": "Every liveness check was green while ten of twelve autonomous agents had not acted in weeks. Capability attestation models an agent's preconditions as a causal graph and returns the root blocker plus the command that fixes it, instead of a checklist of symptoms.",+ "link": "/docs/agent-vitals",+ "tags": [+ "launch"+ ]+ },{"date": "2026-08-28","type": "launch",@@ -36,6 +46,36 @@"launch"]},+ {+ "date": "2026-08-28",+ "type": "launch",+ "title": "Docs · Terminal avatar",+ "summary": "The @three-ws/tty-avatar package: any three.ws avatar or agent body rendered live in a terminal by a software rasterizer (truecolor half-blocks, braille, or plain ASCII), procedural moods, and Claude Code hooks that turn it into your coding agent's face.",+ "link": "/docs/tty-avatar",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-08-28",+ "type": "launch",+ "title": "Herald",+ "summary": "Deliver a message in person: a 3D character walks onto your page and tells the user what happened. Open SDK, one line of code, an accessible fallback, and a CLI that announces when your build finishes.",+ "link": "/herald",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-08-28",+ "type": "launch",+ "title": "Portal",+ "summary": "Paste any web address and walk through it in 3D. Portal reads the page's real structure and builds a place from it: sections become buildings sized by what they say, links become doors you step into, images become billboards. Download the world as a GLB or embed it in your own site.",+ "link": "/portal",+ "tags": [+ "launch"+ ]+ },{"date": "2026-08-28","type": "launch",@@ -46,6 +86,16 @@"launch"]},+ {+ "date": "2026-08-28",+ "type": "launch",+ "title": "Terminal renderer",+ "summary": "curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.",+ "link": "/tty",+ "tags": [+ "launch"+ ]+ },{"date": "2026-08-28","type": "launch",@@ -163,6 +213,29 @@"feature"]},+ {+ "date": "2026-08-28",+ "type": "update",+ "title": "Your agents can now tell you why they are not doing anything",+ "summary": "An audit found ten of twelve autonomous trading agents had not acted in weeks while every health check reported them perfectly fine: the container was up, the feed was streaming, every strategy was armed. Liveness measures the process, but acting needs a whole chain of preconditions the process knows nothing about. A new open-source package, @three-ws/agent-vitals, models those preconditions as a causal graph and answers the real question: can this agent act right now, and if not, what is the one thing to fix. It reports root causes instead of symptoms, so a stale deployment that killed a model chain that starved a decision queue reads as one item with one command, not three red rows to guess between. Run npm run agent:vitals for the fleet, or GET /api/agents/vitals.",+ "link": "/docs/agent-vitals",+ "tags": [+ "feature",+ "sdk",+ "infra"+ ]+ },+ {+ "date": "2026-08-28",+ "type": "update",+ "title": "Your avatar now runs in a terminal, and it can be your coding agent's face",+ "summary": "A new package, @three-ws/tty-avatar, draws any three.ws avatar or agent body live in a terminal window: one npx command, no browser, no GPU, 24 frames a second in colour. It has moods (thinking, working, happy, error, asleep) that work on any model without a rig, and one command wires it to Claude Code so the avatar thinks while the agent reads your prompt, nods while it edits files, shakes when a tool fails and bounces when it finishes, with a caption naming what it is doing. Every avatar and agent page now has the command in its Embed tab.",+ "link": "/docs/tty-avatar",+ "tags": [+ "feature",+ "sdk"+ ]+ },{"date": "2026-08-27","type": "launch",diff --git a/public/changelog.xml b/public/changelog.xmlindex 5a6725e8c..c44bcb21c 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -22,6 +22,14 @@<category>launch</category><description>Every text-to-3D API answers with a link to a binary an AI agent cannot open, so the agent that made the model cannot check its own work. This surface renders any GLB from several angles and hands the frames back as images a vision model actually sees, over MCP, REST or the @three-ws/see SDK.</description></item>+ <item>+ <title>Docs · Agent vitals: can it act?</title>+ <link>https://three.ws/docs/agent-vitals</link>+ <guid isPermaLink="false">2026-08-28:Docs · Agent vitals: can it act?</guid>+ <pubDate>Fri, 28 Aug 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>Every liveness check was green while ten of twelve autonomous agents had not acted in weeks. Capability attestation models an agent's preconditions as a causal graph and returns the root blocker plus the command that fixes it, instead of a checklist of symptoms.</description>+ </item><item><title>Docs · Feedback</title><link>https://three.ws/docs/feedback</link>@@ -30,6 +38,30 @@<category>launch</category><description>Telling the corner companion what broke: the proactive ask at the moment of failure, the route, build SHA, and console errors captured for you, the severity and clustering rules, the report API, and the boundary that keeps untrusted visitor text from ever reaching anything with write access.</description></item>+ <item>+ <title>Docs · Terminal avatar</title>+ <link>https://three.ws/docs/tty-avatar</link>+ <guid isPermaLink="false">2026-08-28:Docs · Terminal avatar</guid>+ <pubDate>Fri, 28 Aug 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>The @three-ws/tty-avatar package: any three.ws avatar or agent body rendered live in a terminal by a software rasterizer (truecolor half-blocks, braille, or plain ASCII), procedural moods, and Claude Code hooks that turn it into your coding agent's face.</description>+ </item>+ <item>+ <title>Herald</title>+ <link>https://three.ws/herald</link>+ <guid isPermaLink="false">2026-08-28:Herald</guid>+ <pubDate>Fri, 28 Aug 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>Deliver a message in person: a 3D character walks onto your page and tells the user what happened. Open SDK, one line of code, an accessible fallback, and a CLI that announces when your build finishes.</description>+ </item>+ <item>+ <title>Portal</title>+ <link>https://three.ws/portal</link>+ <guid isPermaLink="false">2026-08-28:Portal</guid>+ <pubDate>Fri, 28 Aug 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>Paste any web address and walk through it in 3D. Portal reads the page's real structure and builds a place from it: sections become buildings sized by what they say, links become doors you step into, images become billboards. Download the world as a GLB or embed it in your own site.</description>+ </item><item><title>Publishing to the Solana dApp Store</title><link>https://three.ws/docs/seeker-publishing</link>@@ -38,6 +70,14 @@<category>launch</category><description>The release runbook for the three.ws Seeker app: Publisher Portal setup, the release keystore, building and verifying a signed APK, and submitting it for review.</description></item>+ <item>+ <title>Terminal renderer</title>+ <link>https://three.ws/tty</link>+ <guid isPermaLink="false">2026-08-28:Terminal renderer</guid>+ <pubDate>Fri, 28 Aug 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.</description>+ </item><item><title>three.ws on iOS</title><link>https://three.ws/docs/ios-app</link>@@ -126,6 +166,22 @@<category>feature</category><description>Notifications no longer wait behind a badge. When something worth stopping for lands while you are on the site (a sale, money in, a 3D generation finishing, anything touching your account), your corner companion turns to you, plays a gesture, and says it out loud with a link straight to it. If the companion is switched off it is summoned for that one message and walks off again, without turning itself back on. It is a real delivery channel next to in-app, push, email and Telegram: toggle it per category in Settings, and there is a Turn off control in the bubble that silences it in that browser instantly. It only ever announces unread notifications under fifteen minutes old, says each one exactly once, caps itself at two per visit, and never speaks into a background tab. Nothing is spoken aloud unless you already turned on the companion's voice; otherwise it is text in the bubble, which screen readers announce too.</description></item>+ <item>+ <title>Your agents can now tell you why they are not doing anything</title>+ <link>https://three.ws/docs/agent-vitals</link>+ <guid isPermaLink="false">2026-08-28:Your agents can now tell you why they are not doing anything</guid>+ <pubDate>Fri, 28 Aug 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>An audit found ten of twelve autonomous trading agents had not acted in weeks while every health check reported them perfectly fine: the container was up, the feed was streaming, every strategy was armed. Liveness measures the process, but acting needs a whole chain of preconditions the process knows nothing about. A new open-source package, @three-ws/agent-vitals, models those preconditions as a causal graph and answers the real question: can this agent act right now, and if not, what is the one thing to fix. It reports root causes instead of symptoms, so a stale deployment that killed a model chain that starved a decision queue reads as one item with one command, not three red rows to guess between. Run npm run agent:vitals for the fleet, or GET /api/agents/vitals.</description>+ </item>+ <item>+ <title>Your avatar now runs in a terminal, and it can be your coding agent's face</title>+ <link>https://three.ws/docs/tty-avatar</link>+ <guid isPermaLink="false">2026-08-28:Your avatar now runs in a terminal, and it can be your coding agent's face</guid>+ <pubDate>Fri, 28 Aug 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>A new package, @three-ws/tty-avatar, draws any three.ws avatar or agent body live in a terminal window: one npx command, no browser, no GPU, 24 frames a second in colour. It has moods (thinking, working, happy, error, asleep) that work on any model without a rig, and one command wires it to Claude Code so the avatar thinks while the agent reads your prompt, nods while it edits files, shakes when a tool fails and bounces when it finishes, with a caption naming what it is doing. Every avatar and agent page now has the command in its Embed tab.</description>+ </item><item><title>three.ws for Seeker</title><link>https://three.ws/seeker</link>diff --git a/public/features.json b/public/features.jsonindex 2932537de..810f47edf 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-28T03:26:00.137Z",+ "generated_at": "2026-08-28T03:32:47.833Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -295,6 +295,16 @@"tags": [],"showcase": false},+ {+ "path": "/portal",+ "title": "Portal",+ "description": "Paste any web address and walk through it in 3D. Portal reads the page's real structure and builds a place from it: sections become buildings sized by what they say, links become doors you step into, images become billboards. Download the world as a GLB or embed it in your own site.",+ "added": "2026-08-28",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": true+ },{"path": "/companion","title": "Companion",@@ -305,6 +315,16 @@"tags": [],"showcase": true},+ {+ "path": "/herald",+ "title": "Herald",+ "description": "Deliver a message in person: a 3D character walks onto your page and tells the user what happened. Open SDK, one line of code, an accessible fallback, and a CLI that announces when your build finishes.",+ "added": "2026-08-28",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": true+ },{"path": "/notifications","title": "Notifications",@@ -1151,6 +1171,16 @@"indexable": true,"tags": [],"showcase": false+ },+ {+ "path": "/tty",+ "title": "Terminal renderer",+ "description": "curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.",+ "added": "2026-08-28",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false}]},@@ -2997,6 +3027,16 @@"tags": [],"showcase": false},+ {+ "path": "/docs/tty-avatar",+ "title": "Docs · Terminal avatar",+ "description": "The @three-ws/tty-avatar package: any three.ws avatar or agent body rendered live in a terminal by a software rasterizer (truecolor half-blocks, braille, or plain ASCII), procedural moods, and Claude Code hooks that turn it into your coding agent's face.",+ "added": "2026-08-28",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false+ },{"path": "/docs/site-performance","title": "Docs · Site load performance",@@ -6776,6 +6816,16 @@"indexable": true,"tags": [],"showcase": false+ },+ {+ "path": "/docs/agent-vitals",+ "title": "Docs · Agent vitals: can it act?",+ "description": "Every liveness check was green while ten of twelve autonomous agents had not acted in weeks. Capability attestation models an agent's preconditions as a causal graph and returns the root blocker plus the command that fixes it, instead of a checklist of symptoms.",+ "added": "2026-08-28",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false}]},diff --git a/public/llms-full.txt b/public/llms-full.txtindex 916356eae..5dddf5c20 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -181,12 +181,24 @@ URL: https://three.ws/collectionView all the skills and subscriptions you've unlocked on three.ws.+### Portal++URL: https://three.ws/portal++Paste any web address and walk through it in 3D. Portal reads the page's real structure and builds a place from it: sections become buildings sized by what they say, links become doors you step into, images become billboards. Download the world as a GLB or embed it in your own site.+### CompanionURL: https://three.ws/companionA 3D companion that delivers your important messages in person. Connect your own Telegram bot, calendar, inbox, or phone, give each contact their own avatar and voice, and hear only what clears your bar.+### Herald++URL: https://three.ws/herald++Deliver a message in person: a 3D character walks onto your page and tells the user what happened. Open SDK, one line of code, an accessible fallback, and a CLI that announces when your build finishes.+### NotificationsURL: https://three.ws/notifications@@ -702,6 +714,12 @@ URL: https://three.ws/bundlesSell several of an agent's skills as one purchase, priced from your own sales instead of a rule of thumb. three.ws finds the buyers who already bought two or more of those skills separately and backtests any price against what they really paid, so you see what the bundle would have earned before you publish it.+### Terminal renderer++URL: https://three.ws/tty++curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.+## LabsExperimental features actively shipping. Expect fast iteration.@@ -1827,6 +1845,12 @@ URL: https://three.ws/docs/avatar-artifactThe standalone avatar viewer you paste into any site as a one-line iframe: its ?agent= and ?model= parameters, the hosts a model may come from, how a clip-less rig still comes to life, and the sentence the page shows for every way it can fail.+### Docs · Terminal avatar++URL: https://three.ws/docs/tty-avatar++The @three-ws/tty-avatar package: any three.ws avatar or agent body rendered live in a terminal by a software rasterizer (truecolor half-blocks, braille, or plain ASCII), procedural moods, and Claude Code hooks that turn it into your coding agent's face.+### Docs · Site load performanceURL: https://three.ws/docs/site-performance@@ -4095,6 +4119,12 @@ URL: https://three.ws/docs/pill-mascotHow a static capsule mascot with four nubs became a 52-bone, six-clip avatar: limb discovery from a distance transform, medial-axis skinning, and a bind pose that differs from the rest pose on purpose.+### Docs · Agent vitals: can it act?++URL: https://three.ws/docs/agent-vitals++Every liveness check was green while ten of twelve autonomous agents had not acted in weeks. Capability attestation models an agent's preconditions as a causal graph and returns the root blocker plus the command that fixes it, instead of a checklist of symptoms.+## BlogLong-form announcements, launches, and writing from three.ws.diff --git a/public/llms.txt b/public/llms.txtindex a138b0a78..f953c64f3 100644--- a/public/llms.txt+++ b/public/llms.txt@@ -58,7 +58,9 @@ Entry points into the product.- [Marketplace Analytics](https://three.ws/marketplace/analytics): Real-time stats on the three.ws skill marketplace: top skills, top agents, and sales volume.- [Trial Conversions](https://three.ws/conversions): Both sides of the moment a metered free trial runs out: the trials you are holding with the runs you have left and the price to keep them, and the trials running on skills you sell with the revenue waiting in the queue.- [My Collection](https://three.ws/collection): View all the skills and subscriptions you've unlocked on three.ws.+- [Portal](https://three.ws/portal): Paste any web address and walk through it in 3D. Portal reads the page's real structure and builds a place from it: sections become buildings sized by what they say, links become doors you step into, images become billboards. Download the world as a GLB or embed it in your own site.- [Companion](https://three.ws/companion): A 3D companion that delivers your important messages in person. Connect your own Telegram bot, calendar, inbox, or phone, give each contact their own avatar and voice, and hear only what clears your bar.+- [Herald](https://three.ws/herald): Deliver a message in person: a 3D character walks onto your page and tells the user what happened. Open SDK, one line of code, an accessible fallback, and a CLI that announces when your build finishes.- [Notifications](https://three.ws/notifications): Every payment, sale, remix, follow, quest, and royalty notification on three.ws: all in one place, filterable by category.- [Community](https://three.ws/community): Live platform activity plus where to follow, contribute, and connect with three.ws creators.- [Crew HQ](https://three.ws/crews): Found a crew, invite your people, and watch the whole roster stand in one 3D headquarters. Every member appears as their own agent, lit when they are live in the world.@@ -143,6 +145,7 @@ Create and customize an agent.- [Render Lab](https://three.ws/render-lab): Compose a real avatar render in the browser and copy the exact API call. Reads each model first (ARKit morph targets, canonical-skeleton coverage, geometry) and only offers controls that model will actually honor, so nothing you build here silently fails in production. Contact-sheet mode renders every framing, pose, or expression at once.- [Rig Doctor](https://three.ws/rig-doctor): Drop a .glb and find out in one second whether it will animate on three.ws. Names your skeleton convention, scores every limb group against the 52-joint canonical skeleton, repairs non-standard bone names in the browser, and previews the result. Nothing is uploaded.- [Skill Bundles](https://three.ws/bundles): Sell several of an agent's skills as one purchase, priced from your own sales instead of a rule of thumb. three.ws finds the buyers who already bought two or more of those skills separately and backtests any price against what they really paid, so you see what the bundle would have earned before you publish it.+- [Terminal renderer](https://three.ws/tty): curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.## Labs@@ -340,6 +343,7 @@ Docs, tutorials, and reference.- [Docs](https://three.ws/docs): Full documentation: SDKs, API reference, embedding, agent system, smart contracts.- [Docs · Skill bundles](https://three.ws/docs/skill-bundles): How a bundle of an agent's skills is priced from that agent's own sales rather than a rule of thumb: the median-basket and flat-discount bases, the public pricing and backtest endpoint, the owner endpoints that publish and retire a bundle, and the on-chain checkout that unlocks every skill in one payment.- [Docs · Avatar Artifact viewer](https://three.ws/docs/avatar-artifact): The standalone avatar viewer you paste into any site as a one-line iframe: its ?agent= and ?model= parameters, the hosts a model may come from, how a clip-less rig still comes to life, and the sentence the page shows for every way it can fail.+- [Docs · Terminal avatar](https://three.ws/docs/tty-avatar): The @three-ws/tty-avatar package: any three.ws avatar or agent body rendered live in a terminal by a software rasterizer (truecolor half-blocks, braille, or plain ASCII), procedural moods, and Claude Code hooks that turn it into your coding agent's face.- [Docs · Site load performance](https://three.ws/docs/site-performance): The load-cost rules behind every page that is not /play, each with the Lighthouse measurement that produced it: catalogue grids skip the rows nobody can see, analytics waits for the first idle moment, the CDN bundle ships minified, below-the-fold sections load below the fold, and thumbnails decode off the critical path.- [Docs · Farcaster memory seeding](https://three.ws/docs/farcaster-memory-seeding): Give an agent your Farcaster voice with explicit consent: ownership is proved by signing a challenge with a wallet the fid itself verified on the protocol (Solana first), only your public profile and casts are read, and revoking the grant deletes every memory it produced.- [Docs · Likeness evaluation](https://three.ws/docs/likeness-eval): How three.ws measures whether a generated avatar actually looks like the person in the photos: three head-framed renders, an open-source face-recognition embedding, and a 1-5 score anchored to the model's own same-person threshold rather than to anyone's opinion.@@ -559,6 +563,7 @@ Docs, tutorials, and reference.- [Tutorial · Render Avatars as Images](https://three.ws/tutorials/render-avatar-images): Put a live 3D avatar in an image tag: four camera framings, 28 poses, ARKit facial morphs, social cards, turntables, and a CORS-open GLB proxy. No 3D engine anywhere in your stack.- [Tutorial · Character Library to a Live Embed](https://three.ws/tutorials/character-library-to-embed): Pick a rigged character from the free library of 107, prove its skeleton drives the animation clip library, and embed it on your own site with one script tag and a gesture button. No modeling, no cost, ten minutes.- [Tutorial · Sell a Skill With a Free Trial That Converts](https://three.ws/tutorials/sell-a-skill-with-a-trial): List an agent skill for sale in $THREE, give buyers a metered free trial, and watch it expire into a real on-chain purchase. Covers choosing a trial length and the missing decrement that quietly makes a trialled skill impossible to sell.+- [Docs · 3D Vision: let an agent see the model](https://three.ws/docs/3d-vision): Every text-to-3D API answers with a link to a binary an AI agent cannot open, so the agent that made the model cannot check its own work. This surface renders any GLB from several angles and hands the frames back as images a vision model actually sees, over MCP, REST or the @three-ws/see SDK.- [Docs · The three.ws 3D API](https://three.ws/docs/3d-api): Free, keyless 3D for AI agents. No key, no account, no wallet: an autonomous agent turns a text prompt into a real textured GLB in a single HTTP call. Endpoints, request shapes, and the response contract.- [Docs · Design tokens](https://three.ws/docs/DESIGN-TOKENS): The canonical design vocabulary every three.ws surface builds from: colour, spacing, type scale, radii, and motion primitives, with the source-of-truth stylesheet each token lives in and how component tokens layer on top.- [Docs · Liquid glass, the visual direction](https://three.ws/docs/liquid-glass): The design brief for the liquid-glass look on three.ws grids and panels: real refraction instead of blur, the squircle and material recipe, the two lanes (CSS glass for chrome, three.js transmission for tiles), the open-source references, and the performance and accessibility budget.@@ -717,6 +722,7 @@ Docs, tutorials, and reference.- [Docs · Your first contribution](https://three.ws/docs/first-contribution): Clone to open pull request in about 15 minutes, with a complete worked example: teaching the avatar retargeter a bone-naming convention it did not know, plus the test that proves it.- [Docs · Triage](https://three.ws/docs/triage): How incoming issues and pull requests get sorted, what every label means, how to claim work, and the response times contributors can expect.- [Docs · Rigging the pump.fun pill mascot](https://three.ws/docs/pill-mascot): How a static capsule mascot with four nubs became a 52-bone, six-clip avatar: limb discovery from a distance transform, medial-axis skinning, and a bind pose that differs from the rest pose on purpose.+- [Docs · Agent vitals: can it act?](https://three.ws/docs/agent-vitals): Every liveness check was green while ten of twelve autonomous agents had not acted in weeks. Capability attestation models an agent's preconditions as a causal graph and returns the root blocker plus the command that fixes it, instead of a checklist of symptoms.## Blogdiff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex a9392f23f..8ca25439f 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -83,7 +83,7 @@<main class="sm-wrap"><div class="sm-hero"><h1>Sitemap</h1>- <p>All 843 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>+ <p>All 848 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p><div class="sm-formats"><a href="/sitemap.xml"><code>sitemap.xml</code> · for search engines</a><a href="/llms.txt"><code>llms.txt</code> · for AI agents</a>@@ -95,7 +95,7 @@</div><div class="sm-filter"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m21 21-4.3-4.3"/></svg>- <input id="sm-filter-input" type="search" placeholder="Filter 843 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />+ <input id="sm-filter-input" type="search" placeholder="Filter 848 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" /><kbd aria-hidden="true">/</kbd></div><p class="sm-filter-count" id="sm-filter-count" role="status" aria-live="polite"></p>@@ -103,6 +103,14 @@<h2 id="sm-new-title">Newest<a class="sm-new-more" href="/changelog">full changelog →</a></h2><p class="sm-section-desc">The 9 most recently launched pages, straight to the live surface.</p><ul class="sm-list">+ <li>+ <a href="/portal">+ <span class="sm-new-date">Aug 28, 2026</span>+ <span class="sm-title">Portal</span>+ <span class="sm-path">/portal</span>+ <span class="sm-desc">Paste any web address and walk through it in 3D. Portal reads the page's real structure and builds a place from it: sections become buildings sized by what they say, links become doors you step into, images become billboards. Download the world as a GLB or embed it in your own site.</span>+ </a>+ </li><li><a href="/companion"><span class="sm-new-date">Aug 28, 2026</span>@@ -111,6 +119,30 @@<span class="sm-desc">A 3D companion that delivers your important messages in person. Connect your own Telegram bot, calendar, inbox, or phone, give each contact their own avatar and voice, and hear only what clears your bar.</span></a></li>+ <li>+ <a href="/herald">+ <span class="sm-new-date">Aug 28, 2026</span>+ <span class="sm-title">Herald</span>+ <span class="sm-path">/herald</span>+ <span class="sm-desc">Deliver a message in person: a 3D character walks onto your page and tells the user what happened. Open SDK, one line of code, an accessible fallback, and a CLI that announces when your build finishes.</span>+ </a>+ </li>+ <li>+ <a href="/tty">+ <span class="sm-new-date">Aug 28, 2026</span>+ <span class="sm-title">Terminal renderer</span>+ <span class="sm-path">/tty</span>+ <span class="sm-desc">curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.</span>+ </a>+ </li>+ <li>+ <a href="/docs/tty-avatar">+ <span class="sm-new-date">Aug 28, 2026</span>+ <span class="sm-title">Docs · Terminal avatar</span>+ <span class="sm-path">/docs/tty-avatar</span>+ <span class="sm-desc">The @three-ws/tty-avatar package: any three.ws avatar or agent body rendered live in a terminal by a software rasterizer (truecolor half-blocks, braille, or plain ASCII), procedural moods, and Claude Code hooks that turn it into your coding agent's face.</span>+ </a>+ </li><li><a href="/docs/seeker-publishing"><span class="sm-new-date">Aug 28, 2026</span>@@ -143,38 +175,6 @@<span class="sm-desc">Every text-to-3D API answers with a link to a binary an AI agent cannot open, so the agent that made the model cannot check its own work. This surface renders any GLB from several angles and hands the frames back as images a vision model actually sees, over MCP, REST or the @three-ws/see SDK.</span></a></li>- <li>- <a href="/seeker">- <span class="sm-new-date">Aug 27, 2026</span>- <span class="sm-title">three.ws for Seeker</span>- <span class="sm-path">/seeker</span>- <span class="sm-desc">The home screen of the three.ws app on Solana Seeker: one-tap Seed Vault sign-in, selfie to avatar, your agents, the marketplace, and Seeker Genesis Token verification.</span>- </a>- </li>- <li>- <a href="/docs/seeker-app">- <span class="sm-new-date">Aug 27, 2026</span>- <span class="sm-title">three.ws on Solana Seeker</span>- <span class="sm-path">/docs/seeker-app</span>- <span class="sm-desc">What the Seeker app adds on top of the website: Seed Vault sign-in, share-sheet capture, an offline shell, home-screen shortcuts, and Seeker Genesis Token verification.</span>- </a>- </li>- <li>- <a href="/docs/open-source-footprint">- <span class="sm-new-date">Aug 25, 2026</span>- <span class="sm-title">Docs · Open-Source Footprint</span>- <span class="sm-path">/docs/open-source-footprint</span>- <span class="sm-desc">Every registry, marketplace, community, and directory where three.ws code and listings live, with live links and the number behind each one.</span>- </a>- </li>- <li>- <a href="/docs/open-source-ecosystem">- <span class="sm-new-date">Aug 25, 2026</span>- <span class="sm-title">Docs · The Open-Source Ecosystem</span>- <span class="sm-path">/docs/open-source-ecosystem</span>- <span class="sm-desc">100 stars on GitHub, and the complete map of the three.ws open-source developer ecosystem: every npm package, MCP server, contract, worker, skill, spec, integration, and registry where the code lives, with the number behind each.</span>- </a>- </li></ul></section><nav class="sm-toc" aria-label="Sections">@@ -192,7 +192,7 @@</nav><section class="sm-section" id="main"><header>- <h2>Main<span class="sm-count" data-count>53</span></h2>+ <h2>Main<span class="sm-count" data-count>55</span></h2><p class="sm-section-desc">Entry points into the product.</p></header><ul class="sm-list">@@ -392,6 +392,13 @@<span class="sm-desc">View all the skills and subscriptions you've unlocked on three.ws.</span></a></li>+ <li>+ <a href="/portal">+ <span class="sm-title">Portal</span>+ <span class="sm-path">/portal</span>+ <span class="sm-desc">Paste any web address and walk through it in 3D. Portal reads the page's real structure and builds a place from it: sections become buildings sized by what they say, links become doors you step into, images become billboards. Download the world as a GLB or embed it in your own site.</span>+ </a>+ </li><li><a href="/companion"><span class="sm-title">Companion</span>@@ -399,6 +406,13 @@<span class="sm-desc">A 3D companion that delivers your important messages in person. Connect your own Telegram bot, calendar, inbox, or phone, give each contact their own avatar and voice, and hear only what clears your bar.</span></a></li>+ <li>+ <a href="/herald">+ <span class="sm-title">Herald</span>+ <span class="sm-path">/herald</span>+ <span class="sm-desc">Deliver a message in person: a 3D character walks onto your page and tells the user what happened. Open SDK, one line of code, an accessible fallback, and a CLI that announces when your build finishes.</span>+ </a>+ </li><li><a href="/notifications"><span class="sm-title">Notifications</span>@@ -572,7 +586,7 @@<section class="sm-section" id="build"><header>- <h2>Build<span class="sm-count" data-count>60</span></h2>+ <h2>Build<span class="sm-count" data-count>61</span></h2><p class="sm-section-desc">Create and customize an agent.</p></header><ul class="sm-list">@@ -996,6 +1010,13 @@<span class="sm-desc">Sell several of an agent's skills as one purchase, priced from your own sales instead of a rule of thumb. three.ws finds the buyers who already bought two or more of those skills separately and backtests any price against what they really paid, so you see what the bundle would have earned before you publish it.</span></a></li>+ <li>+ <a href="/tty">+ <span class="sm-title">Terminal renderer</span>+ <span class="sm-path">/tty</span>+ <span class="sm-desc">curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.</span>+ </a>+ </li></ul></section>@@ -2283,7 +2304,7 @@<section class="sm-section" id="learn"><header>- <h2>Learn<span class="sm-count" data-count>381</span></h2>+ <h2>Learn<span class="sm-count" data-count>383</span></h2><p class="sm-section-desc">Docs, tutorials, and reference.</p></header><ul class="sm-list">@@ -2308,6 +2329,13 @@<span class="sm-desc">The standalone avatar viewer you paste into any site as a one-line iframe: its ?agent= and ?model= parameters, the hosts a model may come from, how a clip-less rig still comes to life, and the sentence the page shows for every way it can fail.</span></a></li>+ <li>+ <a href="/docs/tty-avatar">+ <span class="sm-title">Docs · Terminal avatar</span>+ <span class="sm-path">/docs/tty-avatar</span>+ <span class="sm-desc">The @three-ws/tty-avatar package: any three.ws avatar or agent body rendered live in a terminal by a software rasterizer (truecolor half-blocks, braille, or plain ASCII), procedural moods, and Claude Code hooks that turn it into your coding agent's face.</span>+ </a>+ </li><li><a href="/docs/site-performance"><span class="sm-title">Docs · Site load performance</span>@@ -4954,6 +4982,13 @@<span class="sm-desc">How a static capsule mascot with four nubs became a 52-bone, six-clip avatar: limb discovery from a distance transform, medial-axis skinning, and a bind pose that differs from the rest pose on purpose.</span></a></li>+ <li>+ <a href="/docs/agent-vitals">+ <span class="sm-title">Docs · Agent vitals: can it act?</span>+ <span class="sm-path">/docs/agent-vitals</span>+ <span class="sm-desc">Every liveness check was green while ten of twelve autonomous agents had not acted in weeks. Capability attestation models an agent's preconditions as a causal graph and returns the root blocker plus the command that fixes it, instead of a checklist of symptoms.</span>+ </a>+ </li></ul></section>diff --git a/scripts/publish-packages.mjs b/scripts/publish-packages.mjsindex 5bf445726..a71442443 100644--- a/scripts/publish-packages.mjs+++ b/scripts/publish-packages.mjs@@ -47,6 +47,7 @@ const PACKAGES = [{ key: 'strategies', dir: 'packages/strategies' },{ key: 'pumpfun-skills', dir: 'packages/pumpfun-skills' },{ key: 'irl', dir: 'packages/irl' },+ { key: 'tty-avatar', dir: 'packages/tty-avatar' },// Assistant widget SDK — the one-tag / npm loader for the 3D avatar// assistant. Has a real build (build.mjs, run via prepublishOnly) that also// mirrors the one-tag bundle to public/assistant/v1.js. Standalone dir, likediff --git a/vercel.json b/vercel.jsonindex 28f24b48c..ac73b93b8 100644--- a/vercel.json+++ b/vercel.json@@ -453,6 +453,14 @@"src": "/api/platform/stats","dest": "/api/platform/stats"},+ {+ "src": "/ship",+ "dest": "/ship/index.html"+ },+ {+ "src": "/ship/",+ "dest": "/ship/index.html"+ },{"src": "/changelog","dest": "/changelog/index.html"@@ -493,6 +501,14 @@"src": "/\\.well-known/x402\\.json","dest": "/api/wk?name=x402-discovery"},+ {+ "src": "/\\.well-known/x402-preflight",+ "dest": "/api/x402/preflight"+ },+ {+ "src": "/preflight/?$",+ "dest": "/pages/preflight.html"+ },{"src": "/\\.well-known/x402","dest": "/api/wk?name=x402"@@ -1061,6 +1077,10 @@"src": "/coin-intel/?","dest": "/coin-intel.html"},+ {+ "src": "/oracle-lab/?",+ "dest": "/oracle-lab.html"+ },{"src": "/coins/?","dest": "/coins.html"@@ -1217,6 +1237,25 @@"src": "/activity/?","dest": "/activity.html"},+ {+ "src": "/tty/?",+ "has": [+ {+ "type": "header",+ "key": "accept",+ "value": "(?i).*text/html.*"+ }+ ],+ "dest": "/tty.html"+ },+ {+ "src": "/tty/?",+ "dest": "/api/tty"+ },+ {+ "src": "/tty/([^/]+)/?",+ "dest": "/api/tty?avatar=$1"+ },{"src": "/tour/atlas/?","dest": "/tour-atlas.html"@@ -2616,6 +2655,14 @@"src": "/feedback/","dest": "/feedback.html"},+ {+ "src": "/portal",+ "dest": "/portal.html"+ },+ {+ "src": "/portal/",+ "dest": "/portal.html"+ },{"src": "/companion","dest": "/companion.html"@@ -2624,6 +2671,14 @@"src": "/companion/","dest": "/companion.html"},+ {+ "src": "/herald",+ "dest": "/herald.html"+ },+ {+ "src": "/herald/",+ "dest": "/herald.html"+ },{"src": "/notifications","dest": "/notifications.html"@@ -3206,6 +3261,10 @@"src": "/api/oracle/stats","dest": "/api/oracle/stats.js"},+ {+ "src": "/api/oracle/model",+ "dest": "/api/oracle/model.js"+ },{"src": "/api/oracle/test-alert","dest": "/api/oracle/test-alert.js"@@ -4898,6 +4957,17 @@"src": "/api/agent-3d/versions","dest": "/api/agent-3d/versions"},+ {+ "src": "/herald\\.js",+ "headers": {+ "cache-control": "public, max-age=3600, s-maxage=300, stale-while-revalidate=86400",+ "access-control-allow-origin": "*",+ "access-control-allow-methods": "GET, HEAD, OPTIONS",+ "cross-origin-resource-policy": "cross-origin",+ "timing-allow-origin": "*"+ },+ "dest": "/herald.js"+ },{"src": "/agent-3d/versions\\.json","headers": {diff --git a/vite.config.js b/vite.config.jsindex 0c5e457f0..eb1535441 100644--- a/vite.config.js+++ b/vite.config.js@@ -514,6 +514,7 @@ const appConfig = {chunk.name === 'walk-playground' ||chunk.name === 'feature-tour' ||chunk.name === 'notifications' ||+ chunk.name === 'herald' ||chunk.name === 'nav-tier-badge' ||chunk.name === 'agent-bus' ||chunk.name === 'i18n'@@ -527,10 +528,14 @@ const appConfig = {'walk-playground': resolve(__dirname, 'src/walk-playground.js'),'feature-tour': resolve(__dirname, 'src/feature-tour.js'),notifications: resolve(__dirname, 'src/notifications.js'),+ // /herald.js: the CDN build of @three-ws/herald, imported by+ // third-party pages and by /herald's own playground.+ herald: resolve(__dirname, 'src/herald-embed.js'),'nav-tier-badge': resolve(__dirname, 'src/nav-tier-badge.js'),i18n: resolve(__dirname, 'src/i18n.js'),app: resolve(__dirname, 'pages/app.html'),proof: resolve(__dirname, 'pages/proof.html'),+ preflight: resolve(__dirname, 'pages/preflight.html'),'app-next': resolve(__dirname, 'pages/app-next.html'),home: resolve(__dirname, 'pages/home.html'),'what-is': resolve(__dirname, 'pages/what-is.html'),@@ -625,7 +630,12 @@ const appConfig = {// transitively. HTML output paths come from the source file path,// not the input key, so the page still emits dist/notifications.html.'notifications-page': resolve(__dirname, 'pages/notifications.html'),+ // The @three-ws/herald playground. Key must NOT be `herald`: that is+ // the CDN module entry above, and a duplicate key would silently+ // replace it.+ 'herald-page': resolve(__dirname, 'pages/herald.html'),companion: resolve(__dirname, 'pages/companion.html'),+ portal: resolve(__dirname, 'pages/portal.html'),feedback: resolve(__dirname, 'pages/feedback.html'),'agent-edit': resolve(__dirname, 'pages/agent-edit.html'),'agent-mind': resolve(__dirname, 'pages/agent-mind.html'),@@ -717,9 +727,11 @@ const appConfig = {arm: resolve(__dirname, 'pages/arm.html'),ca2x402: resolve(__dirname, 'pages/ca2x402.html'),activity: resolve(__dirname, 'pages/activity.html'),+ tty: resolve(__dirname, 'pages/tty.html'),guards: resolve(__dirname, 'pages/guards.html'),pipeline: resolve(__dirname, 'pages/pipeline.html'),'coin-intel': resolve(__dirname, 'pages/coin-intel.html'),+ 'oracle-lab': resolve(__dirname, 'pages/oracle-lab.html'),coins: resolve(__dirname, 'pages/coins.html'),coin: resolve(__dirname, 'pages/coin.html'),drop: resolve(__dirname, 'pages/drop.html'),@@ -1466,6 +1478,8 @@ const appConfig = {'/ca2x402/': resolve(root, 'pages/ca2x402.html'),'/activity': resolve(root, 'pages/activity.html'),'/activity/': resolve(root, 'pages/activity.html'),+ '/tty': resolve(root, 'pages/tty.html'),+ '/tty/': resolve(root, 'pages/tty.html'),'/tour/atlas': resolve(root, 'pages/tour-atlas.html'),'/tour/atlas/': resolve(root, 'pages/tour-atlas.html'),'/guards': resolve(root, 'pages/guards.html'),@@ -1476,6 +1490,8 @@ const appConfig = {'/trending/': resolve(root, 'pages/trending.html'),'/coin-intel': resolve(root, 'pages/coin-intel.html'),'/coin-intel/': resolve(root, 'pages/coin-intel.html'),+ '/oracle-lab': resolve(root, 'pages/oracle-lab.html'),+ '/oracle-lab/': resolve(root, 'pages/oracle-lab.html'),'/coins': resolve(root, 'pages/coins.html'),'/coins/': resolve(root, 'pages/coins.html'),'/markets': resolve(root, 'pages/markets.html'),@@ -2068,6 +2084,9 @@ const appConfig = {// /changelog → public changelog page (mirrors vercel.json rewrite)else if (!filePath && /^\/changelog\/?$/.test(path))filePath = resolve(root, 'public/changelog/index.html');+ // /ship → ship log: releases joined to their commits (mirrors vercel.json rewrite)+ else if (!filePath && /^\/ship\/?$/.test(path))+ filePath = resolve(root, 'public/ship/index.html');// /town → communities (alias; mirrors vercel.json rewrite)else if (!filePath && /^\/town\/?$/.test(path))filePath = resolve(root, 'pages/communities.html');@@ -2297,6 +2316,12 @@ const appConfig = {req.url = '/src/notifications.js';return next();}+ // /herald.js: the @three-ws/herald CDN build, served from src in+ // dev at the stable, unhashed name it ships under in production.+ if (path === '/herald.js') {+ req.url = '/src/herald-embed.js';+ return next();+ }// /nav-tier-badge.js — nav.js loads this module for the $THREE// holder tier chip (built to a stable, unhashed name in prod).if (path === '/nav-tier-badge.js') {@@ -3230,6 +3255,35 @@ const appConfig = {],},},+ // Windows 11 widgets board. The host fetches the Adaptive Card+ // template once from /api/glance/template and then asks the service+ // worker (public/glance-sw.js) for data, which comes from+ // /api/glance/mine. `auth: false` keeps the widget installable while+ // signed out: the card itself renders a sign-in state rather than+ // letting the host block the install behind an account.+ widgets: [+ {+ name: 'Agent glance',+ short_name: 'Agent',+ description:+ 'Your three.ws agent at a glance: what it did today, and one tap back into it.',+ tag: 'agent-glance',+ template: 'agent-glance',+ ms_ac_template: '/api/glance/template',+ data: '/api/glance/mine',+ type: 'application/json',+ auth: false,+ update: 900,+ icons: [{ src: 'pwa-192x192.png', sizes: '192x192' }],+ screenshots: [+ {+ src: 'screenshots/glance-widget.png',+ sizes: '480x200',+ label: 'The Agent glance widget on the Windows 11 widgets board',+ },+ ],+ },+ ],shortcuts: [{name: 'Create Avatar',@@ -3299,7 +3353,7 @@ const appConfig = {// Pull in the Web Push handlers (push + notificationclick). Kept in// public/push-sw.js as a classic script so the generated Workbox SW// importScripts it without switching to an injectManifest build.- importScripts: ['/push-sw.js', '/share-target-sw.js'],+ importScripts: ['/push-sw.js', '/share-target-sw.js', '/glance-sw.js'],// MPA: every route is a separate HTML file served by the server.// No navigation fallback — uncached navigations go to the network.// HTML is intentionally excluded from globPatterns so it is never