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(changelog): record the new surfaces for holders and map them in STRUCTURE
nirholas6a123910ed9d
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 0464e995f..f5a695080 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -13,6 +13,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Docs · Companion** (`/docs/companion`): The personal companion: connect your own Telegram bot, calendar, inbox, or phone, give your contacts a face and a voice, and have a 3D character deliver what matters in person. Bridges, triage rules, the SDK, the CLI, the MCP server, and the desktop app.- **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.+- **Docs · Terminal renderer** (`/docs/tty`): curl three.ws/tty and a rigged 3D agent walks in your terminal. The hosted streaming endpoint and its parameters, plus @three-ws/tty-3d, the CLI and library that render any GLB in a terminal with a pure-CPU rasterizer: real skeletal animation, half-block pixels, no GPU and no browser.- **Docs · The Oracle model, and how to run it yourself** (`/docs/oracle-model`): How the three.ws conviction model is fitted, what its three heads predict, why the outcome labels had to be made independent of the SOL price, how the promotion gate decides which model ships, and how to score launches locally with @three-ws/oracle-model.- **Docs · Upstream resilience map** (`/docs/resilience`): Every third-party service this platform calls and what happens to a user when it goes down. Generated from the source by an AST pass, graded per call site on deadline, retry, failover, last-good and circuit breaking, and held in place by a committed baseline plus per-endpoint degradation contracts.- **Glance** (`/glance`): Your three.ws agent on every home screen: a live card for the Windows 11 widgets board, a README, Slack, or any page.@@ -33,6 +34,7 @@ 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]`- **We now prove our fallbacks work, instead of hoping they do**: Adding a backup for an outside service is easy; knowing it made things better is not. A new audit reads the whole codebase and grades every call we make to an outside service on five protections, publishes the result as a public map, and fails the build if a new unprotected call is added or an existing one gets worse. On top of it, each endpoint now declares what it is allowed to tell you when a service it depends on is down, and a test proves it by actually breaking the service and checking the answer. That immediately caught a real bug: a token lookup was telling people a token did not exist when the price indexer was simply unreachable. Related fixes stop stale data reaching a payment retry, a token security verdict and an access check, where an out-of-date answer costs money or grants access. (`/docs/resilience`) `[feature, improvement, infra]`+- **Your 3D agent now runs in a terminal, with nothing installed**: Type curl three.ws/tty into any terminal and a rigged 3D character walks, turns and animates in the window, drawn entirely out of coloured text. There is nothing to download and no graphics card involved on either end: the frames are drawn by a plain software renderer on our servers and streamed to your shell as they are made, so the animation starts before the model has finished loading. Point it at an agent you own with three.ws/tty/<id>, or at any public 3D file. The same renderer is published as a package, so you can run it against your own models offline, orbit the camera with the arrow keys, or capture a single still frame to paste into a README. It reads a real skeleton and plays the model's real animation, so the character actually moves its limbs rather than spinning in place. (`/tty`) `[feature, sdk]`- **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]`diff --git a/STRUCTURE.md b/STRUCTURE.mdindex d359df365..b575dfd25 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -73,6 +73,7 @@ bottom.| Receipt Vault: buyer-side proof of purchase | [pages/receipts.html](pages/receipts.html) `→ /receipts`, page module [src/receipts.js](src/receipts.js) + pure helpers [src/receipts-lib.js](src/receipts-lib.js), backend [api/x402/my-receipts.js](api/x402/my-receipts.js), storage [api/_lib/x402/receipt-storage.js](api/_lib/x402/receipt-storage.js), issuer [api/_lib/x402/offer-receipt-issuer.js](api/_lib/x402/offer-receipt-issuer.js), key publication [api/x402/did.js](api/x402/did.js) `→ /.well-known/did.json` | Live | What a given wallet **spent** on the platform's paid endpoints. Every settled x402 call issues a signed Offer & Receipt artifact (USE-17) and durably logs it; a buyer connects a Solana or EVM wallet, signs one read-only message (5-minute window, no transaction, no fee) and gets every receipt ever issued to that wallet: endpoint, settled amount, network, explorer-linked tx, the full signed artifact as JSON, plus search and CSV export. The signing message is a fixed four-line string that must stay byte-identical between `buildReceiptsMessage()` (client) and `buildExpectedMessage()` (server); [tests/receipts-lib.test.js](tests/receipts-lib.test.js) pins that contract against a verbatim copy of the server's function. The signed artifact carries no amount and omits the tx hash under the spec §5.2 privacy default, so the row records both separately as our own audit trail (migration [api/_lib/migrations/2026-07-28-x402-receipt-settlement.sql](api/_lib/migrations/2026-07-28-x402-receipt-settlement.sql)); receipts predating that capture report as "N of M priced" rather than under-reporting a total. Issuance requires `OFFER_RECEIPT_JWK` (jws) or `OFFER_RECEIPT_SIGNING_PRIVATE_KEY` (eip712); unset means no receipts are issued at all. Docs: [docs/x402-endpoints.md](docs/x402-endpoints.md) || Unified service catalog (one source, two storefronts) | [api/_lib/service-catalog/index.js](api/_lib/service-catalog/index.js), descriptors [api/_lib/service-catalog/services/](api/_lib/service-catalog/services/index.js) | Live | The canonical written-once record of every service (paid x402 + free crypto/3D bundles + OKX.AI rows). `toBazaarDiscovery()` generates every static `/api/x402/*` entry in the [api/wk.js](api/wk.js) discovery doc (replacing ~1,400 lines of hand-mirrored blocks); `toOkxCatalog()` reproduces the OKX `catalogIndex()` payload exactly, with an `include:'all'` projection ready for listing expansion. New paid service = drop `services/<slug>.js` + add its barrel import row. No-drift guards: [tests/service-catalog.test.js](tests/service-catalog.test.js). Spec: [specs/SERVICE_CATALOG.md](specs/SERVICE_CATALOG.md) || Conversational refinement + remix economy | Iterate: [api/_mcp-studio/tools.js](api/_mcp-studio/tools.js) `refine_model` (free, on `/api/mcp-studio`) + [mcp-server/src/tools/refine-model.js](mcp-server/src/tools/refine-model.js) (paid stdio, $0.25); shared lineage core [mcp-server/src/tools/_lineage.js](mcp-server/src/tools/_lineage.js). Remix (paid track): feed [api/remix-feed.js](api/remix-feed.js) `→ /api/remix-feed` (free browse/publish/lineage), settlement [api/x402/remix-asset.js](api/x402/remix-asset.js) `→ /api/x402/remix-asset` + core [api/_lib/remix-settlement.js](api/_lib/remix-settlement.js) + split math [api/_lib/remix-royalty.js](api/_lib/remix-royalty.js). Docs [docs/remix.md](docs/remix.md), [docs/mcp-studio.md](docs/mcp-studio.md). | Live | Talk to a model to iterate it ("make it metallic") — real anchored re-generation with a revertable/branchable version lineage rendered as a viewer version strip; free on both the OpenAI 3D Studio and the paid MCP server. Creators publish a finished model as remixable (provenance + license + royalty on the existing `forge_creations` rows — no parallel store); another agent pays $0.25 USDC to remix it and a creator-set royalty (≤20%, capped) routes on-chain to the original creator via the audited `transferSolanaUSDC` rail. Split/caps/payout unit-tested ([tests/remix-settlement.test.js](tests/remix-settlement.test.js), [tests/remix-royalty.test.js](tests/remix-royalty.test.js), [tests/refine-lineage.test.js](tests/refine-lineage.test.js)). Free track stays crypto-free. Prompt 09. |+| Terminal renderer (3D in a shell, no GPU) | Renderer core [packages/tty-3d/](packages/tty-3d) (`@three-ws/tty-3d`, CLI `three-tty`), hosted stream [api/tty.js](api/tty.js) `→ /tty`, `/tty/:id`, `/api/tty`, page [pages/tty.html](pages/tty.html) + [src/tty-page.js](src/tty-page.js) `→ /tty`. Docs: [docs/tty.md](docs/tty.md). Tests: [packages/tty-3d/tests/tty-3d.test.js](packages/tty-3d/tests/tty-3d.test.js), [tests/api-tty.test.js](tests/api-tty.test.js) | Live | `curl three.ws/tty` and a rigged agent walks in your terminal, with nothing installed on either side. A pure-CPU software rasterizer (z-buffer, per-vertex linear blend skinning off the glTF animation samplers, meshopt decode on the way in) draws into a framebuffer the size of the caller's terminal and encodes it as `▀` half-blocks, so one cell carries two independently coloured pixels and pixels come out square. The server streams paced frames as `text/plain`, so the HTTP response IS the animation. Sibling of [packages/tty-avatar/](packages/tty-avatar), which adds moods, avatar-id resolution and Claude Code hooks on top of a terminal renderer but deliberately does not do skeletal animation; this package owns the 3D. || Restyle Studio (material/PBR editor + AI restyle + variants) | [pages/restyle.html](pages/restyle.html) `→ /restyle`, [src/restyle.js](src/restyle.js). PBR preset/variant library [packages/viewer-presets/src/materials.js](packages/viewer-presets/src/materials.js) (`@three-ws/viewer-presets`). AI restyle + persistence core [api/_lib/material-studio-store.js](api/_lib/material-studio-store.js), free hosted endpoint [api/material-studio.js](api/material-studio.js) `→ /api/material-studio`; paid agent twin [mcp-server/src/tools/restyle-material.js](mcp-server/src/tools/restyle-material.js) (`restyle_material`, $0.05 stdio MCP), thin core [mcp-server/src/tools/_material-core.js](mcp-server/src/tools/_material-core.js). Shares the `refine_model` lineage core ([mcp-server/src/tools/_lineage.js](mcp-server/src/tools/_lineage.js)) so a restyle/variant is just another kind of version, feeding prompt 09 remix. Docs: [docs/mcp-tools.md](docs/mcp-tools.md). | Live | Re-skin any GLB without regenerating its mesh: live PBR editing (color/metalness/roughness/emissive/texture) with a one-click preset library (14 looks — chrome, gold, glass, wood…), seeded reproducible colorway variants (mulberry32 PRNG — same base+seed → same set), and free-text AI restyle ("make it chrome", "cyberpunk neon") via IBM Granite-proposed PBR factors applied + re-exported server-side. Every AI restyle / saved checkpoint mints a real, `gltf-validator`-checked, durably-stored GLB recorded in an immutable parent→child lineage — non-destructive in the durable sense, not just an in-browser Reset. Roadmap prompt 06. || Embodiment: a living agent body in the chat | Hosted embed [pages/embodiment/embed.html](pages/embodiment/embed.html) `→ /embodiment/embed` (Vite input + vercel route, `frame-ancestors *`); engine [apps-sdk/embodiment/embodiment-stage.js](apps-sdk/embodiment/embodiment-stage.js) (`EmbodimentStage`) + [overlay.js](apps-sdk/embodiment/overlay.js); persona tools (free) [api/_mcp-studio/persona-tools.js](api/_mcp-studio/persona-tools.js) → `/api/mcp-studio` (`create_agent_persona`, `get_agent_persona`, `persona_say`) and (paid) [api/_mcp3d/tools/studio.js](api/_mcp3d/tools/studio.js); shared inline-body artifact [api/_lib/embodiment-artifact.js](api/_lib/embodiment-artifact.js); identity store [api/_lib/persona-store.js](api/_lib/persona-store.js) (Postgres `agent_personas` + fs fallback + durable R2 GLB); reload route [api/mcp3d/persona.js](api/mcp3d/persona.js) `→ /api/mcp3d/persona`; live chain-state feed [api/mcp3d/persona-identity.js](api/mcp3d/persona-identity.js) `→ /api/mcp3d/persona-identity` (polled only when the embed is opened with `?wallet=1`). Emotion/rig/lip-sync cores under [src/embodiment/](src/embodiment) + [src/voice/](src/voice). | Live | A generated avatar becomes a persistent, named body that renders inline in ChatGPT/Claude: it lip-syncs each reply, blends the matching expression + gesture, idles between turns, and reloads by `persona_id` in a fresh session (the id is the capability, no sign-in). Rides the universal canonicalize/retarget clip library; a rig without face morphs animates the jaw, a non-humanoid GLB falls back to a gentle idle (`decideRigMode`/`supportsCanonicalClips`), never a bind-pose T-pose. Zero crypto/token surface. Tests: [tests/persona-store.test.js](tests/persona-store.test.js), [tests/api/persona-resolve-route.test.js](tests/api/persona-resolve-route.test.js), [tests/api/persona-identity-route.test.js](tests/api/persona-identity-route.test.js), [tests/mcp-studio.test.js](tests/mcp-studio.test.js), [tests/embodiment-rig-mode.test.js](tests/embodiment-rig-mode.test.js). Evidence: [prompts/store-submissions/_generated/embodiment/](prompts/store-submissions/_generated/embodiment/). Store-submission prompt 07. || Claude.ai artifact embed + builder | Endpoint [api/artifact.js](api/artifact.js) `→ /api/artifact`, prebuilt viewer [public/artifact-viewer.bundle.js](public/artifact-viewer.bundle.js) (source [scripts/artifact-viewer/src.js](scripts/artifact-viewer/src.js), `npm run build:artifact-viewer`), builder page [public/artifact/index.html](public/artifact/index.html) `→ /artifact` + [README](public/artifact/README.md), contract [specs/CLAUDE_ARTIFACT.md](specs/CLAUDE_ARTIFACT.md), vendored sandbox CSP [public/claude-artifact-csp.txt](public/claude-artifact-csp.txt) (refresh: [scripts/refresh-claude-csp.mjs](scripts/refresh-claude-csp.mjs)). | Live | `GET /api/artifact?agent=<uuid>` returns ONE self-contained HTML document with three.js, GLTFLoader, the viewer and the agent GLB all inlined, because Claude's artifact sandbox CSP blocks every external script and fetch. Paste the URL into a Claude conversation and the agent renders inline. The builder page is the pre-flight: it lists real public agents that carry an embeddable avatar (`/api/agents/public?avatar=1`), renders the response in a sandboxed iframe under the same CSP Claude applies, and reports payload size, fetch time, frame render time and sandbox compliance before you paste. Size is graded against the ceiling the endpoint can actually emit (a 6 MB model base64-inlines to 8 MB, plus the 565 KB viewer), not against the raw model cap, so a large-but-accepted artifact is not flagged as over budget. `?model=<glb url>` is the viewer-only lane (allowlisted https origins, SSRF-guarded, 6 MB cap). Tests: [tests/api/artifact.test.js](tests/api/artifact.test.js) pins the generated HTML against the vendored Claude CSP. |diff --git a/data/changelog.json b/data/changelog.jsonindex 42a9d0d88..9f206c68a 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-08-28",+ "title": "Your 3D agent now runs in a terminal, with nothing installed",+ "summary": "Type curl three.ws/tty into any terminal and a rigged 3D character walks, turns and animates in the window, drawn entirely out of coloured text. There is nothing to download and no graphics card involved on either end: the frames are drawn by a plain software renderer on our servers and streamed to your shell as they are made, so the animation starts before the model has finished loading. Point it at an agent you own with three.ws/tty/<id>, or at any public 3D file. The same renderer is published as a package, so you can run it against your own models offline, orbit the camera with the arrow keys, or capture a single still frame to paste into a README. It reads a real skeleton and plays the model's real animation, so the character actually moves its limbs rather than spinning in place.",+ "tags": [+ "feature",+ "sdk"+ ],+ "link": "/tty"+ },{"date": "2026-08-28","title": "We now prove our fallbacks work, instead of hoping they do",diff --git a/public/changelog.json b/public/changelog.jsonindex 8a2b58016..3fe8636d7 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-28T03:37:23.829Z",+ "generated_at": "2026-08-28T03:39:58.152Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -76,6 +76,16 @@"launch"]},+ {+ "date": "2026-08-28",+ "type": "launch",+ "title": "Docs · Terminal renderer",+ "summary": "curl three.ws/tty and a rigged 3D agent walks in your terminal. The hosted streaming endpoint and its parameters, plus @three-ws/tty-3d, the CLI and library that render any GLB in a terminal with a pure-CPU rasterizer: real skeletal animation, half-block pixels, no GPU and no browser.",+ "link": "/docs/tty",+ "tags": [+ "launch"+ ]+ },{"date": "2026-08-28","type": "launch",@@ -285,6 +295,17 @@"infra"]},+ {+ "date": "2026-08-28",+ "type": "update",+ "title": "Your 3D agent now runs in a terminal, with nothing installed",+ "summary": "Type curl three.ws/tty into any terminal and a rigged 3D character walks, turns and animates in the window, drawn entirely out of coloured text. There is nothing to download and no graphics card involved on either end: the frames are drawn by a plain software renderer on our servers and streamed to your shell as they are made, so the animation starts before the model has finished loading. Point it at an agent you own with three.ws/tty/<id>, or at any public 3D file. The same renderer is published as a package, so you can run it against your own models offline, orbit the camera with the arrow keys, or capture a single still frame to paste into a README. It reads a real skeleton and plays the model's real animation, so the character actually moves its limbs rather than spinning in place.",+ "link": "/tty",+ "tags": [+ "feature",+ "sdk"+ ]+ },{"date": "2026-08-28","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex ce4169603..aa29b0a56 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -62,6 +62,14 @@<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>Docs · Terminal renderer</title>+ <link>https://three.ws/docs/tty</link>+ <guid isPermaLink="false">2026-08-28:Docs · 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. The hosted streaming endpoint and its parameters, plus @three-ws/tty-3d, the CLI and library that render any GLB in a terminal with a pure-CPU rasterizer: real skeletal animation, half-block pixels, no GPU and no browser.</description>+ </item><item><title>Docs · The Oracle model, and how to run it yourself</title><link>https://three.ws/docs/oracle-model</link>@@ -222,6 +230,14 @@<category>feature</category><description>Adding a backup for an outside service is easy; knowing it made things better is not. A new audit reads the whole codebase and grades every call we make to an outside service on five protections, publishes the result as a public map, and fails the build if a new unprotected call is added or an existing one gets worse. On top of it, each endpoint now declares what it is allowed to tell you when a service it depends on is down, and a test proves it by actually breaking the service and checking the answer. That immediately caught a real bug: a token lookup was telling people a token did not exist when the price indexer was simply unreachable. Related fixes stop stale data reaching a payment retry, a token security verdict and an access check, where an out-of-date answer costs money or grants access.</description></item>+ <item>+ <title>Your 3D agent now runs in a terminal, with nothing installed</title>+ <link>https://three.ws/tty</link>+ <guid isPermaLink="false">2026-08-28:Your 3D agent now runs in a terminal, with nothing installed</guid>+ <pubDate>Fri, 28 Aug 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>Type curl three.ws/tty into any terminal and a rigged 3D character walks, turns and animates in the window, drawn entirely out of coloured text. There is nothing to download and no graphics card involved on either end: the frames are drawn by a plain software renderer on our servers and streamed to your shell as they are made, so the animation starts before the model has finished loading. Point it at an agent you own with three.ws/tty/<id>, or at any public 3D file. The same renderer is published as a package, so you can run it against your own models offline, orbit the camera with the arrow keys, or capture a single still frame to paste into a README. It reads a real skeleton and plays the model's real animation, so the character actually moves its limbs rather than spinning in place.</description>+ </item><item><title>Your agent now tells you the important things in person</title><link>https://three.ws/notifications</link>diff --git a/public/features.json b/public/features.jsonindex c08702566..c85cc16cc 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-28T03:37:23.815Z",+ "generated_at": "2026-08-28T03:39:58.125Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -6896,6 +6896,16 @@"indexable": true,"tags": [],"showcase": false+ },+ {+ "path": "/docs/tty",+ "title": "Docs · Terminal renderer",+ "description": "curl three.ws/tty and a rigged 3D agent walks in your terminal. The hosted streaming endpoint and its parameters, plus @three-ws/tty-3d, the CLI and library that render any GLB in a terminal with a pure-CPU rasterizer: real skeletal animation, half-block pixels, no GPU and no browser.",+ "added": "2026-08-28",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false}]},diff --git a/src/model-diff-stage.js b/src/model-diff-stage.jsindex bb9674d50..9ae4c44a9 100644--- a/src/model-diff-stage.js+++ b/src/model-diff-stage.js@@ -22,7 +22,6 @@ import {AmbientLight,AnimationMixer,Box3,- Clock,Color,DirectionalLight,Group,@@ -221,7 +220,10 @@ export async function createDiffStage(container) {visible: true,};- const clock = new Clock();+ // Frame delta from the loop's own timestamp. three.js deprecated Clock in+ // favour of Timer, and an addon import for one subtraction is not worth the+ // bytes on a page that already lazy-loads the whole renderer.+ let lastFrame = 0;const planeA = new Plane();const planeB = new Plane();const right = new Vector3();@@ -357,9 +359,13 @@ export async function createDiffStage(container) {// ── Loop ───────────────────────────────────────────────────────────────- renderer.setAnimationLoop(() => {- if (state.disposed || !state.visible) return;- const delta = clock.getDelta();+ renderer.setAnimationLoop((time) => {+ if (state.disposed || !state.visible) {+ lastFrame = time;+ return;+ }+ const delta = lastFrame ? Math.min((time - lastFrame) / 1000, 0.1) : 0;+ lastFrame = time;if (state.playing) {for (const side of Object.values(sides)) side.mixer?.update(delta);}