Skip to content

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.

docs(motion): record the 469-clip generated collection, its marketplace listing, and why the vision flip waits on billing

nirholas8758f4f44bf0
diff --git a/CHANGELOG.md b/CHANGELOG.md
index bfba35e17..88c5c28be 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,11 +6,13 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
## 2026-09-18
+- **469 generated animations in the library, and for sale as rigged GLBs**: The animation library now carries 469 clips generated on our own motion model, covering 175 prompts across walks, idles, gestures, dance, combat, sport, reactions and more. Every one passed the quality gate that checks for sliding feet, sudden jumps and broken loops, and fewer than three in ten takes were thrown away. While checking them on a real avatar we found that every generated clip, including the ones already live, played with the head thrown back and the arms raised, because the model describes its skeleton with the arms hanging and the head in front of the neck. That is fixed, walks now travel instead of skating in place, and a foot flicker is smoothed out. The same fix applies when you generate a motion from a prompt in the Animation Studio. Each clip is also listed in the marketplace as a GLB on the three.ws rig that opens in Blender, Unity or Unreal, for 0.01 USDC through the x402 download, and a rotating set of twelve is free each week. (`/animations`) `[feature, fix]`
- **Choose your chart everywhere a coin is charted, now including DEXTools**: Every place three.ws draws a coin's price chart now lets you switch to the chart you trust. The Trade Terminal at /trades and Mission Control used to show only the platform's own live candles; both now have a source bar with DexScreener, Birdeye, GMGN, DEXTools and GeckoTerminal one click away, the same choice already offered on coin pages and launch pages. DEXTools is new on all four. Your pick is remembered and follows you from coin to coin, the bar works from the keyboard with the arrow keys, and each chart comes with a link that opens the same market on the provider's own site. If a provider cannot draw a coin yet, or its chart is blocked by your browser or network, you get a plain explanation with a retry and a working alternative instead of an empty box. (`/trades`) `[feature, improvement]`
- **Granite Guardian now answers on three.ws, not just in the docs**: The governance check that screens what an agent is asked to do, and vetoes it when the request is a jailbreak, harmful, or fraudulent, runs on IBM Granite Guardian. It was built to call IBM's hosted watsonx.ai service, so on our live site it answered with a not-configured error, and the new agent identity check quietly skipped itself for the same reason. IBM publishes Granite Guardian's weights openly, so we now run the model ourselves on a dedicated GPU as a second lane: watsonx still leads wherever it is set up, and our own copy answers whenever it is not. Every verdict now says which model and which lane produced it. The identity check also compares a new agent against existing ones using the site's regular embedding service when Granite embeddings are unavailable; it lists the look-alikes it finds but only scores them on Granite, because that is what its thresholds were tuned on. (`/docs/ibm`) `[fix, infra]`
- **Paid endpoints now describe themselves the way marketplaces expect**: When an agent or a marketplace asks one of our paid endpoints what it costs, the answer also explains how to call it and what comes back. Around sixty endpoints were sending that explanation in an older layout, or in one that did not match its own rules, which is enough for a marketplace to skip the listing without saying why. Every paid endpoint now sends it in the current standard layout, checked against its own rules. We also added a tool that tests our endpoints with the same checklist a marketplace validator uses, so a listing problem shows up on our side first. (`/docs/x402-dev-tools`) `[improvement, fix]`
- **Paid x402 endpoints are answering again**: For several hours on September 18, nearly every paid endpoint on three.ws, the x402 discovery document at /.well-known/x402, the payment facilitator and the MCP server answered with a server error instead of a price. A routine update to the library behind wallet sign-in changed what it needs at startup, and our code tripped over it the moment it loaded, before any request could be served. Agents and marketplace validators that probed us saw a broken seller. The sign-in code now supplies what the library expects, returning buyers can sign back in to what they already paid for exactly as before, and the deploy checks now refuse to ship when the tested dependencies differ from the ones the live site will run, which is how this got past us. (`/docs/x402`) `[fix, infra]`
- **Standard Anthropic SDK clients can now use a three.ws agent's AI budget**: The AI proxy behind every embedded three.ws agent now answers at the address an Anthropic SDK or command-line tool builds for itself. Point a client at /api/llm/anthropic/agents/<your agent id> with one of your API keys and it runs on that agent's model, limits, and monthly budget. The proxy also stopped turning such clients away over their defaults: a system prompt sent as a list of text blocks is accepted, and an output limit above 16,000 tokens is lowered to 16,000 instead of rejected. (`/docs/api-reference`) `[feature, sdk]`
+- **Text avatars now wear what you describe**: Typing a description on /genesis (or sending a prompt to the avatar API) used to produce the same template body with a face pasted onto it, so an explorer in a teal flight jacket came back in someone else's clothes. Text avatars are now built from your words head to toe: the prompt is painted as a full-body character, sculpted into a textured 3D model on our own GPU, and given a skeleton so it animates immediately. Selfies still use the face pipeline, which is what a likeness needs. The free 3D generator behind the forge_avatar tool also stopped failing when the community GPU spaces were out of quota: it now moves the job onto our own worker instead of giving up. (`/genesis`) `[fix, improvement]`
- **The $THREE page now has a live DEXTools chart and the Social Boost wins**: The $THREE page shows a live candle chart of the three / SOL pair, drawn by DEXTools. Below the platform's own buybacks there is a new section for the community's: the three DEXTools Social Boost prizes $THREE has won so far, $11,382 of buybacks in total, each with a link to its receipt on DEXTools. Social Boost ranks tokens by visits to their DEXTools page, so the section also links straight there. Every visit counts toward the next win. (`/three-token`) `[feature, improvement]`
- **The embedded 3D agent is readable on light websites and quiet in the console**: Two fixes for anyone who has put a three.ws agent on their own site with the two-line embed. The floating widget had no background of its own, so on a light page its white button labels and name vanished into the page; it now has its own dark panel, and the suggestion buttons carry a solid ground, so it reads the same on any site. You can still ask for a transparent or light panel with the background attribute. The embed also made two background requests that browsers blocked on every site but ours, logging errors in the host page's console; those requests now succeed, and only the public, signed-out answer is ever shared across sites. (`/tutorials/embed-in-30-seconds`) `[fix, sdk]`
- **The Trade Terminal finally looks the way it was designed**: The Trade Terminal at /trades was written against a set of colors and fonts that the page itself never defined, so browsers quietly fell back to their defaults: Times New Roman text, oversized controls and missing panel colors. The page now defines its own palette, in both dark and light themes, and renders as the dense, monospaced trading terminal it was meant to be. (`/trades`) `[fix]`
diff --git a/data/changelog.json b/data/changelog.json
index ddd593cc9..da66c99fa 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -28400,6 +28400,16 @@
"improvement"
],
"link": "/genesis"
+ },
+ {
+ "date": "2026-09-18",
+ "title": "469 generated animations in the library, and for sale as rigged GLBs",
+ "summary": "The animation library now carries 469 clips generated on our own motion model, covering 175 prompts across walks, idles, gestures, dance, combat, sport, reactions and more. Every one passed the quality gate that checks for sliding feet, sudden jumps and broken loops, and fewer than three in ten takes were thrown away. While checking them on a real avatar we found that every generated clip, including the ones already live, played with the head thrown back and the arms raised, because the model describes its skeleton with the arms hanging and the head in front of the neck. That is fixed, walks now travel instead of skating in place, and a foot flicker is smoothed out. The same fix applies when you generate a motion from a prompt in the Animation Studio. Each clip is also listed in the marketplace as a GLB on the three.ws rig that opens in Blender, Unity or Unreal, for 0.01 USDC through the x402 download, and a rotating set of twelve is free each week.",
+ "tags": [
+ "feature",
+ "fix"
+ ],
+ "link": "/animations"
}
]
}
diff --git a/docs/animation-seeding.md b/docs/animation-seeding.md
index 3997b7f61..06eded013 100644
--- a/docs/animation-seeding.md
+++ b/docs/animation-seeding.md
@@ -12,11 +12,13 @@ that is easy to get catastrophically wrong.
| Piece | What it does |
|---|---|
-| `data/motion-prompts.json` | The prompt library: 137 prompts across 10 categories. Data, never a hardcoded list. |
+| `data/motion-prompts.json` | The prompt library: 180 prompts across 10 categories. Data, never a hardcoded list. |
| `workers/model-text2motion/` | The GPU worker. Samples a motion-diffusion model and returns a three.js `AnimationClip` JSON. |
| `api/forge-motion.js` | The public route: `POST` a prompt, poll for a clip. Rate limited per IP. |
-| `api/_lib/motion-seed.js` | The prompt loader, the quality gate, the publishing shape, the free-subset rotation. |
-| `scripts/gcp/seed-motion.mjs` | The resumable bulk runner. |
+| `api/_lib/motion-seed.js` | The prompt loader, the rest-shape conversion, the foot-flick and root-travel repairs, the quality gate, the publishing shape, the free-subset rotation. |
+| `api/_lib/motion-glb.js` | Bakes a clip onto the platform rig as one portable GLB, the artifact the marketplace sells. |
+| `api/_lib/generated-clip-market.js` | The generated collection as a marketplace product line: listing rows, price, and the weekly free rotation. |
+| `scripts/gcp/seed-motion.mjs` | The resumable bulk runner: generate, re-derive, publish, list for sale. |
| `api/animations/library.js` | Serves the clip manifest that generated clips are merged into. |
Generated clips are named `gen-<prompt id>-<hash>`, so they are distinguishable from
@@ -55,9 +57,64 @@ into the library's. It is `bindCorrections` with the source rest set to identity
Measured over the whole published set, head-above-feet goes from -0.26 m to
+1.38 m and 127 of 133 clear a 0.6 m upright bar. The six that do not are a
pushup, a squat, a swim stroke, a crouch, a sneak and a meditation, all correctly
-low-posture. Converted clips are stamped `userData.basis = "canonical-rest-v1"`
-(`CLIP_BASIS`), so `needsRebase()` can tell a converted clip from a legacy one and
-nothing is ever rebased twice.
+low-posture. Clips converted this way were stamped
+`userData.basis = "canonical-rest-v1"`. That conversion fixed the legs only; the
+next section replaces it, and `CLIP_BASIS` is now `canonical-rest-v2`, so
+`needsRebase()` can tell a current clip from a legacy one and nothing is ever
+rebased twice.
+
+## The rest shape: arms and head (fixed 2026-09-18)
+
+The conversion above assumed the generator's rest has the same SHAPE as `cz`,
+just with identity rotations. It does not, and the legs were the only place
+the two agreed. The worker's Kabsch fit measures every joint against
+HumanML3D's `paramUtil.t2m_raw_offsets`, which are directions, not a posed
+human: the upper arm, forearm and hand hang straight down, the collars point
+straight out, and the head sits straight FORWARD of the neck. `cz` rests in a
+T-pose with the head above the neck. Rendered on the default rig on
+2026-09-18, every generated clip, including all 39 the repair pass had
+published, played with the head thrown back about 90 degrees and the arms
+raised where they should hang.
+
+`rebaseToCanonicalRest` now aligns the two rest shapes per joint. For joint
+`j`, `A_j` carries the `cz` rest directions of `j`'s children onto the source
+rest directions of the same children (shortest arc onto the primary child, then
+the twist that best places the others). A source world rotation `G_s` maps onto
+the target as `G_s * A_j * Wt_j`, which puts every child exactly where the
+source put it:
+
+ q_t = (Wt_p^-1 * A_p^-1) * q_s * (A_j * Wt_j)
+
+With every `A` at identity this is exactly the old conversion. A leaf the
+22-joint source never measures (hand, head, toe) inherits its parent's `A`, so it
+holds its `cz` rest relative to its parent. Converted clips are stamped
+`canonical-rest-v2`; a clip stamped with the old `canonical-rest-v1` is carried
+back to the source basis and forward again, which is exact because both
+conversions are fixed rotations. The offsets were verified by running source
+forward kinematics over a live idle take (head above neck, arms hanging, toes
+forward) and by rendering baked GLBs of every category in a real browser.
+
+The fix raised the honest accept rate, not just the look: in the old basis the
+toe pointed 25 degrees off, which skewed foot contact, and the thrown-back head
+and raised hands moved the witness joints the continuity rule watches. Re-gating
+the same 882 takes in the new basis took the accept rate from 47% to 71%, and
+`frame_discontinuity` rejects from 86 to 10.
+
+The same conversion now runs for on-demand generation: the `/api/forge-motion`
+poll returns the converted clip as `clip` next to the raw `clip_url`, and the
+Animation Studio plays `clip`.
+
+## Foot flicks: a second Kabsch artifact
+
+A foot has one child in the source skeleton, so its fitted rotation can land on
+the other solution for a frame or two, swinging the toe 8.6 cm and back while
+the ankle holds still to under half a centimetre. On screen that is a foot
+flicking; in the gate it reads as a planted toe skating across the floor.
+`despikeFootFlicks` finds excursions of at most three frames where the toe,
+measured relative to its own ankle, leaves the line between the good frames on
+either side by more than 3 cm, and slerps the foot and toe rotations across them.
+It is judged in world space, never on rotations, for the reason given under
+"Judge positions" below.
## Root drift: a constant the lane welds onto every clip
@@ -77,15 +134,35 @@ average walking speed, which integration turns into a straight ramp.
`flattenRootDrift(clip)` fits the horizontal root track by least squares and
subtracts the fitted line, keeping the residual, which is where the real signal
lives (locomotion residual 0.0051 m against an emote's 0.0002 m), and never
-touching vertical travel. The library's convention is in-place clips: they play on
-an avatar standing where the page put it, and a game engine drives locomotion from
-its own character controller.
-
-**Run both before the gate, in this order: rebase, flatten, then close the seam.**
-The order is load-bearing. The foot-slide rule divides planted-foot slide by the
-stride the clip covers, and a fabricated one-metre stride makes that rule vacuous;
-the seam search hunts for the frame whose pose repeats frame 0, which a ramp
-guarantees no frame ever does.
+touching vertical travel.
+
+## Root travel from foot contact
+
+Flattening is right for a clip that stands still and wrong for one that walks.
+The authored library does NOT ship in-place locomotion (an earlier version of
+this doc said it did): measured on 2026-09-18, a Mixamo catwalk travels 1.23 m
+and a careful walk 1.32 m, with their planted feet sliding 0.09 m and 0.13 m. A
+generated walk with its root pinned is a treadmill whose planted foot is dragged
+under a body that goes nowhere, and every locomotion prompt in the first batch
+failed on exactly that.
+
+`lockRootToContacts` derives the travel from the one place the motion carries it,
+the feet: while a foot is planted it should stay put, so the body moves by the
+opposite of that foot's hips-relative motion. Gaps (a run's flight phase, a foot
+switch) are interpolated, and the velocity is smoothed over a third of a second,
+which keeps the gate honest: the root follows the average stride, so a foot that
+genuinely skates relative to a steady gait still reads as a skate. The derived
+root is only kept when at least 30% of frame pairs have a planted foot and the
+net speed reaches 0.2 m/s; below that a standing clip's centimetre of jitter would
+be integrated into a fake stride, so the flattened root stands.
+
+**The order is load-bearing: rebase, repair foot flicks, flatten, restore travel,
+close the seam, gate.** The foot-slide rule divides planted-foot slide by the
+stride the clip covers, so a fabricated stride makes it vacuous; a flick reads as
+a skating toe, so it is repaired before contact is measured; and the seam search
+hunts for the frame whose pose repeats frame 0, which a ramp guarantees no frame
+ever does. `deriveClip` in the runner and `libraryReadyClip` in `motion-seed.js`
+both apply this order.
## The gate
@@ -203,30 +280,71 @@ comparison too. That reading would have condemned a clip that was already fine.
## Running a batch
```bash
-# Measure quality without publishing. Needs no credentials.
-node scripts/gcp/seed-motion.mjs --count 20 --dry-run
+# Generate and gate, staging keepers locally. Publishes nothing.
+node scripts/gcp/seed-motion.mjs --limit=20
+
+# The 2026-09-18 run: up to six takes per prompt, stop a prompt at three keepers.
+node scripts/gcp/seed-motion.mjs --samples=6 --keep-per-prompt=3 --concurrency=4
-# A real run, where R2 and DATABASE_URL live.
-node scripts/gcp/seed-motion.mjs --count 200 --concurrency 6
+# Rebuild the generated manifest from the staged keepers, then list them for sale.
+node scripts/gcp/seed-motion.mjs --publish --keep-per-prompt=3
+node scripts/gcp/seed-motion.mjs --list --keep-per-prompt=3
+
+# Re-derive every staged clip from its source after the pipeline changes. No GPU.
+node scripts/gcp/seed-motion.mjs --regate
```
-Useful flags: `--categories locomotion,dance` to seed one slice, `--checkpoint PATH`
-to keep runs separate, `--price` and `--free-size` to set the listing terms.
+Useful flags: `--categories=locomotion,dance` to seed one slice, `--limit=N` for a
+smoke batch, `--retry-rejects` to re-roll past rejects, `--out=DIR` to keep a run's
+staging separate, `--price=<USDC>` to override the listing price, and `--report`
+to print the checkpoint's numbers. Staging lives in `animation-sources/.motion-clips/`
+(gitignored).
-**Use the in-process transport for anything bulk.** `/api/forge-motion` is a public
+**Use the direct transport for anything bulk.** `/api/forge-motion` is a public
endpoint rate limited per IP: a 40-clip run through it generates two clips and then
-takes a 429 with a 49 minute `retry_after`. With `GCP_TEXT2MOTION_URL` set the runner
-calls the provider directly and no limiter applies. `--origin` forces the HTTP path,
-which is worth doing on a handful of clips to prove the deployed route works.
+takes a 429 with a 49 minute `retry_after`. With `GCP_TEXT2MOTION_URL` and
+`GCP_RECONSTRUCTION_KEY` in the environment the runner calls the worker through
+the platform's own GCP provider and no limiter applies; both live on the
+`three-ws-api` Cloud Run service (`node scripts/read-service-env.mjs '^NAME$' --raw`).
+`--origin` forces the HTTP path, which is worth doing on a handful of clips to prove
+the deployed route works. Poll misses that land on the other worker instance (task
+records are per instance) are retried inside the poll budget, not recorded as
+failures.
The run is **resumable**: every prompt's outcome is written to the checkpoint as it
lands, and a re-run skips anything already terminal, so killing the process costs at
most the clips in flight.
The run is **lane-asserted**. `/api/forge-motion` and the provider both return a job
-id that names the worker the job was dispatched to, and the runner decodes it and
-aborts the entire batch unless the host is our own `model-text2motion` Cloud Run
-service. Bulk generation must never fall through to a paid third party.
+id that names the worker the job was dispatched to, and the runner decodes it
+(`assertSelfHostedLane`) and aborts the entire batch unless the host is our own
+`model-text2motion` Cloud Run service. Bulk generation must never fall through to a
+paid third party.
+
+## Measured 2026-09-18: the generated collection
+
+| | |
+|---|---|
+| Takes generated | 843 new, on `model-text2motion` only (lane-asserted, zero paid calls) |
+| Accepted by the gate | 596 of 843, **70.7%**, plus 33 of the 39 repaired legacy clips |
+| Published | **469** (at most three takes per prompt), covering 175 of 180 prompts |
+| Library total | 3,343 clips, 469 of them `gen-*` |
+| Listed for sale | 469, at 0.01 USDC each, 12 free per week |
+| GPU | 3,805 lane-seconds (sum of per-job wall time, about 4.5 s a take) inside 18 minutes of batch wall time on at most two instances |
+| Cost | \$0.73 (two instances for the batch window) to \$1.27 (every lane-second billed) at \$1.20/hr, so **\$0.002 to \$0.003 per accepted clip** |
+
+Rejects: 229 foot slide, 11 off the ordered duration, 10 frame discontinuity, 4
+open loop seams, 1 implausible root speed. By category the accept rate runs from
+emotes, idles and interactions (the easiest for this lane) down to dance and
+traversal, where the five prompts with no keeper after six takes all sit
+(celebration spin, laugh, running jump, forward roll, crawl).
+
+What the gate cannot judge is whether a clip does what its prompt says. That is a
+vision-model question, and the vision lane (Gemini on Vertex) was unavailable
+during this run because of a billing hold on the project. A rendered spot check of
+one keeper per category on the default rig showed anatomically sound motion
+(upright, arms hanging, feet planted) with prompt fidelity that varies, which is
+the honest state of a text-to-motion model at this size.
## Repairing the published library
@@ -245,6 +363,13 @@ passes simply stops being served. Publishing needs the R2 credentials that live
the `three-ws-api` Cloud Run service (`S3_ENDPOINT`, `S3_ACCESS_KEY_ID`,
`S3_SECRET_ACCESS_KEY`, `S3_BUCKET`, `S3_PUBLIC_DOMAIN`).
+The same shared pipeline now backs `--regate`, which re-derives every clip in
+the checkpoint from its source with no GPU time: a fresh take from the worker
+output it was built from (`clip_source_url`), a repaired clip from its staged
+copy, carried back to the source basis first. Names never change, so a following
+`--publish` replaces each clip in place and a clip that no longer passes stops
+being served.
+
**Measured 2026-09-09: 39 of 133 survive, 29%.** The 94 drops are 91 for foot
sliding and 7 for frame discontinuity. That number is the first honest accept rate
the generated library has had, and it is far below the "10 of 10" recorded on
@@ -257,17 +382,36 @@ calibrated and it is the lane's output that is failing it.
## Pricing and the rotating free subset
-**Not shipped, and deliberately so.** The pricing policy below is decided and its
-mechanism is written and tested, but nothing lists generated clips for sale yet:
-`api/marketplace/animations.js` serves creator listings out of `animation_clips`
-and no generated clip has a row. Wiring it is held until the repair pass above has
-run, because 94 of the 133 clips currently live do not meet the platform's own
-quality bar and selling them would be selling a defect. The order is repair,
-republish, then list.
-
-The policy, when it is wired: generated clips are listed under the platform
-creator and are paid by default, and a fixed-size subset is free for one epoch at
-a time.
+**Shipped 2026-09-18.** `seed-motion.mjs --list` bakes every published keeper and
+upserts one `animation_clips` row per clip, owned by the platform account
+(`[email protected]`, the same account that owns the platform's own
+agents) and tagged `generated`. The rows surface in
+`GET /api/marketplace/animations` and sell through the existing x402 route,
+`GET /api/x402/animation-download?id=<uuid>`. No migration was needed: the
+rotation is computed at read time, so the stored price never changes.
+
+- **Price:** the Animation Bazaar's advertised price, 0.01 USDC (10,000 atomic
+ units, `X402_PRICE_ANIMATION_DOWNLOAD` overrides it), which is the number the
+ route's 402 challenge and `/.well-known/x402.json` already quote. `--price`
+ overrides it per run.
+- **Free rotation:** a listing counts as generated only when it is owned by the
+ platform account AND tagged `generated`, so no creator listing and nothing the
+ platform lists by hand is ever given away. The feed reports a rotating listing
+ as `free: true` with `free_rotation: { regular_price, until }`, the `?price=`
+ filter and the price sorts treat it as free, the marketplace card reads "Free
+ this week", and the download route hands it over without payment. If the
+ rotation cannot be read, the feed shows stored prices and the download charges
+ them: failing closed on a paid product.
+- **Keys:** the object store serves its whole bucket on a public domain and every
+ clip name is in the free manifest, so each GLB is stored under a random key kept
+ in its row, never under the clip name.
+- **Idempotent:** a re-run re-bakes in place (purchase and play counts survive),
+ numbers repeat takes of one prompt ("Wave Hello (take 2)"), and delists a clip
+ that is no longer published rather than deleting its row, so a buyer's SIWX
+ re-download grant still resolves.
+
+The policy: generated clips are listed under the platform creator and are paid by
+default, and a fixed-size subset is free for one epoch at a time.
The sellable artifact is **not** the clip JSON. That is already public and free,
it drives every avatar on the site, and it is useless outside three.ws. It is the
diff --git a/docs/ops/gcp-credits.md b/docs/ops/gcp-credits.md
index 05c73146d..e780b436a 100644
--- a/docs/ops/gcp-credits.md
+++ b/docs/ops/gcp-credits.md
@@ -1767,7 +1767,9 @@ production spends:
- `SEED_CRON_VISION=1` (with `SEED_CRON_VISION_MS` to bound it, default 20,000)
turns the judge on inside the tick. Watch the cron's duration afterwards; the
- 70 s wall is the reason it is off.
+ 70 s wall is the reason it is off. As of 2026-09-18 the flip is blocked on
+ the Vertex billing hold: the judge is Gemini-only (see the motion library
+ section below).
The rigging half needed no flip: `SEED_CRON_RIG` is **on by default since
2026-09-09**. **Zero of the 17,349 seed avatars published before that had ever
been rigged**, so every one of them animates through the retarget fallback
@@ -1814,6 +1816,43 @@ figures in the "Cost per asset" section above (8 vCPU / 32 GiB + L4 = \$1.69/hr,
had expired again (`Reauthentication failed`). Lane seconds are measured, the rate
is the published list price, and the product of the two is what is quoted here.
+
+---
+
+## Motion library: 469 generated clips live and for sale (measured 2026-09-18)
+
+Supersedes the 2026-09-09 motion figures above. Full write-up, including the two
+new defects found and fixed on the way:
+[docs/animation-seeding.md](../animation-seeding.md).
+
+| | |
+|---|---|
+| Takes generated | 843, all on `model-text2motion` (lane-asserted per job, zero paid calls) |
+| Accept rate | **70.7%** (596 of 843) through the full motion gate, plus 33 of the 39 legacy clips |
+| Published | **469** clips (three takes per prompt at most), 175 of 180 prompts covered |
+| GPU | 3,805 lane-seconds in 18 minutes of batch wall time, at most two L4 instances |
+| Cost | **\$0.73 to \$1.27 in total, \$0.002 to \$0.003 per accepted clip** at \$1.20/hr |
+| Marketplace | all 469 listed at 0.01 USDC under the platform account, 12 free per week |
+
+Two defects the gate could not see were found by rendering the clips on the
+default rig, which is why every clip was re-derived (no GPU) before publishing:
+the lane's rest shape (arms hanging, head forward of the neck) had been treated as
+a T-pose, so every generated clip, the 39 already live included, played with the
+head thrown back and the arms raised; and the foot rotation flicked to its other
+Kabsch solution for a frame at a time. Both are fixed in
+`api/_lib/motion-seed.js`, and the same conversion now runs on the
+`/api/forge-motion` poll so on-demand clips play upright too. That route change
+ships with the next `three-ws-api` deploy.
+
+**`SEED_CRON_VISION` stays off, and it is not an env flip any more.** Its judge
+(`api/_lib/seed-quality.js`: `judgeOnce` and `rigReadinessVertex`) runs Gemini
+2.5 Pro on Vertex AI and has no other lane, and Vertex is denied project-wide by
+a billing hold ("Lightning dunning decision is deny") that only the owner can
+clear. Turning it on today would record a failed judge on every gated keeper.
+Order of operations: clear the billing hold, confirm one Vertex call succeeds,
+then flip `SEED_CRON_VISION=1` with `--update-env-vars` and read the verdicts
+back from `forge_seed_jobs`.
+
---
## Catalog scale: the four browse surfaces at 58k avatars (measured 2026-09-02)
diff --git a/prompts/finish/_context/gcp-credits-README.md b/prompts/finish/_context/gcp-credits-README.md
index 8f545f690..1d62e241b 100644
--- a/prompts/finish/_context/gcp-credits-README.md
+++ b/prompts/finish/_context/gcp-credits-README.md
@@ -13,7 +13,7 @@ the fleet and quota position live in `docs/ops/gcp-credits-plan.md`.
| 02 | Vertex Claude provider | Retired, shipped. Wired and **dormant, re-verified 2026-08-02**: flags are `0` on the service AND the project is unentitled (`rawPredict` 404s every Claude id in `global` and `us-east5`), so the lane could not serve even if flipped. Owner action: accept Anthropic terms in Model Garden. See [docs/ops/llm-lanes.md](../../docs/ops/llm-lanes.md). |
| 03 | Imagen activation | Retired, shipped |
| 04 | GPU worker deploys | Retired, shipped: six workers, flag-gated routing, cost docs. The rig lane shipped as `workers/rig` (`model-rig`), replacing the unirig stub. |
-| 05 | [05-catalog-animation-seeding.md](../904-gcp-credits-05-catalog-animation-seeding.md) | **OPEN, avatar half and scale half landed, motion republish blocked on credentials.** Catalog is at 68,971 avatars (10,370 in the last 7 days, ~844/day). The batch runner gates at 75% for \$0.139 per accepted asset; the live cron, which does the actual growing, runs the mesh stage only and accepts 98.6%, and **no seed avatar had ever been rigged**. Rigging is now on by default in code (2026-09-09) for the meshes a humanoid rig can drive, verified against the live rig lane and gated by `riggableShape` after a slab-bound mesh rigged perfectly and shredded on screen; `SEED_CRON_VISION` is still off on the service and is the one remaining owner env flip, see [docs/ops/gcp-credits.md](../../../docs/ops/gcp-credits.md). Since 2026-09-09 the cron records its verdict on keepers as well as rejects, so the live accept rate is measurable from `forge_seed_jobs`. Scale-proofing is DONE and verified in a browser at a synthetic 30,070-clip catalog: `?facets=1` and `?name=` landed on `/api/animations/library` and the `/animations` first paint went from 30 requests / 11.5 MB to 2 requests / 389 KB. The motion half is still the blocker: all 133 published generated clips are in the wrong rest basis and carry a fabricated 0.2577 m/s drift, `--repair` re-derives them with no GPU (re-verified 2026-09-09: 39 of 133 survive), but **publishing needs the R2 credentials on the Cloud Run service and gcloud in this workspace cannot authenticate** (`Reauthentication failed` on both the user credential and ADC). The marketplace listing (task B8) stays unwired until that republish lands. See [docs/animation-seeding.md](../../../docs/animation-seeding.md). |
+| 05 | Catalog and animation seeding (retired; full text in git history before `25c6683cf`) | **Done except one owner-gated step, updated 2026-09-18.** Avatar half and scale-proofing landed earlier (catalog at 68,971 on 2026-09-09; `/animations` first paint 2 requests / 389 KB at a synthetic 30,070 clips). **Motion half done:** 843 new takes on `model-text2motion` (lane-asserted, zero paid calls), **70.7% accepted** through the full motion gate, **469 generated clips published** (three takes per prompt at most, 175 of 180 prompts; the prompt library grew from 137 to 180), library now 3,343 clips, for \$0.73 to \$1.27 of GPU (\$0.002 to \$0.003 per accepted clip). Rendering clips on the default rig exposed two defects the gate could not see, both fixed and every clip re-derived before publishing: the lane's rest shape (arms hanging, head forward of the neck) had been treated as a T-pose, so every generated clip including the 39 already live played with the head thrown back (basis `canonical-rest-v2`), and single-frame foot flicks; walks now keep the root travel their feet imply. **Task B8 done:** all 469 are listed in `/api/marketplace/animations` under the platform account at 0.01 USDC and sell through `/api/x402/animation-download` (live 402 verified), GLBs under unguessable keys. The weekly free subset of 12 and the upright conversion on `/api/forge-motion` are committed and go live with the next `three-ws-api` deploy. **Remaining, owner:** `SEED_CRON_VISION` stays off because its judge is Gemini on Vertex only and Vertex is denied by the project billing hold; clear the hold, then flip it. See [docs/animation-seeding.md](../../../docs/animation-seeding.md) and [docs/ops/gcp-credits.md](../../../docs/ops/gcp-credits.md). |
| 06 | Vanity inventory | Retired, shipped (`scripts/gcp/vanity-*`) |
| 07 | Spend observability | Retired, shipped (`scripts/gcp/burn-report.mjs`, `create-budgets.mjs`) |
| 08 | Expiry and revert runbook | Retired, shipped (`scripts/gcp/revert-to-free.sh`, `emergency-stop.sh`, `teardown.sh`) |
diff --git a/public/changelog-recent.json b/public/changelog-recent.json
index ecdef9044..87ea6939b 100644
--- a/public/changelog-recent.json
+++ b/public/changelog-recent.json
@@ -1,14 +1,25 @@
{
- "generated_at": "2026-09-18T20:01:50.539Z",
+ "generated_at": "2026-09-18T22:08:45.183Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
"url": "https://three.ws"
},
- "total": 3709,
+ "total": 3711,
"complete": false,
"full_feed": "/changelog.json",
"entries": [
+ {
+ "date": "2026-09-18",
+ "type": "update",
+ "title": "469 generated animations in the library, and for sale as rigged GLBs",
+ "summary": "The animation library now carries 469 clips generated on our own motion model, covering 175 prompts across walks, idles, gestures, dance, combat, sport, reactions and more. Every one passed the quality gate that checks for sliding feet, sudden jumps and broken loops, and fewer than three in ten takes were thrown away. While checking them on a real avatar we found that every generated clip, including the ones already live, played with the head thrown back and the arms raised, because the model describes its skeleton with the arms hanging and the head in front of the neck. That is fixed, walks now travel instead of skating in place, and a foot flicker is smoothed out. The same fix applies when you generate a motion from a prompt in the Animation Studio. Each clip is also listed in the marketplace as a GLB on the three.ws rig that opens in Blender, Unity or Unreal, for 0.01 USDC through the x402 download, and a rotating set of twelve is free each week.",
+ "link": "/animations",
+ "tags": [
+ "feature",
+ "fix"
+ ]
+ },
{
"date": "2026-09-18",
"type": "update",
@@ -64,6 +75,17 @@
"sdk"
]
},
+ {
+ "date": "2026-09-18",
+ "type": "update",
+ "title": "Text avatars now wear what you describe",
+ "summary": "Typing a description on /genesis (or sending a prompt to the avatar API) used to produce the same template body with a face pasted onto it, so an explorer in a teal flight jacket came back in someone else's clothes. Text avatars are now built from your words head to toe: the prompt is painted as a full-body character, sculpted into a textured 3D model on our own GPU, and given a skeleton so it animates immediately. Selfies still use the face pipeline, which is what a likeness needs. The free 3D generator behind the forge_avatar tool also stopped failing when the community GPU spaces were out of quota: it now moves the job onto our own worker instead of giving up.",
+ "link": "/genesis",
+ "tags": [
+ "fix",
+ "improvement"
+ ]
+ },
{
"date": "2026-09-18",
"type": "update",
@@ -1597,28 +1619,6 @@
"tags": [
"fix"
]
- },
- {
- "date": "2026-09-08",
- "type": "update",
- "title": "Launch Studio reads in light mode, and a recipe's reward routing now reaches the launch",
- "summary": "Launch Studio, the catalog of 50 coin-launch recipes, was written entirely in white text and never flipped for the light theme, so on a light background its title, its recipe cards and its preview drawer were white on white with a dark strip painted across the top. The whole surface now draws from the site's colour system and reads in both themes. The bigger fix sits behind the Launch this coin button: every reward recipe promises that a coin's creator fees route to its subject, and that choice was being dropped the moment you left the studio, so the launch form opened with no recipient at all. The routing now travels with the coin, shows on the launch form before you mint, and opens the fee split pre-filled with that recipient the moment the coin is live, ready to review and sign. Two planner options no launch could ever apply were removed rather than left promising a payout. The preview drawer also behaves as a real dialog now: focus moves into it, Tab stays inside it, and closing it returns you to the card you opened.",
- "link": "/launch-studio",
- "tags": [
- "fix",
- "improvement"
- ]
- },
- {
- "date": "2026-09-08",
- "type": "update",
- "title": "Pages stop jumping around while they load",
- "summary": "Three separate things were shifting the layout under you. The marketplace hero rotates through featured avatars every few seconds and wrote each one's name and description into boxes sized to whatever the previous one had been, so the buttons, the dots and the entire grid below moved on every rotation, forever; both boxes now hold the same space whichever avatar is showing. The helper cards that float in the bottom-right corner slid themselves up and out of the way by animating their position, which the browser counts as the page moving even though nothing on the page did; they glide now instead. And the prompt tip under the forge box appeared a moment after the page did, pushing the quality options and the Generate button down; it is there from the first frame.",
- "link": "/marketplace",
- "tags": [
- "fix",
- "improvement"
- ]
}
]
}
diff --git a/public/changelog.json b/public/changelog.json
index dca4641cb..1b14bb19f 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,11 +1,22 @@
{
- "generated_at": "2026-09-18T20:01:50.447Z",
+ "generated_at": "2026-09-18T22:08:45.158Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
"url": "https://three.ws"
},
"entries": [
+ {
+ "date": "2026-09-18",
+ "type": "update",
+ "title": "469 generated animations in the library, and for sale as rigged GLBs",
+ "summary": "The animation library now carries 469 clips generated on our own motion model, covering 175 prompts across walks, idles, gestures, dance, combat, sport, reactions and more. Every one passed the quality gate that checks for sliding feet, sudden jumps and broken loops, and fewer than three in ten takes were thrown away. While checking them on a real avatar we found that every generated clip, including the ones already live, played with the head thrown back and the arms raised, because the model describes its skeleton with the arms hanging and the head in front of the neck. That is fixed, walks now travel instead of skating in place, and a foot flicker is smoothed out. The same fix applies when you generate a motion from a prompt in the Animation Studio. Each clip is also listed in the marketplace as a GLB on the three.ws rig that opens in Blender, Unity or Unreal, for 0.01 USDC through the x402 download, and a rotating set of twelve is free each week.",
+ "link": "/animations",
+ "tags": [
+ "feature",
+ "fix"
+ ]
+ },
{
"date": "2026-09-18",
"type": "update",
@@ -61,6 +72,17 @@
"sdk"
]
},
+ {
+ "date": "2026-09-18",
+ "type": "update",
+ "title": "Text avatars now wear what you describe",
+ "summary": "Typing a description on /genesis (or sending a prompt to the avatar API) used to produce the same template body with a face pasted onto it, so an explorer in a teal flight jacket came back in someone else's clothes. Text avatars are now built from your words head to toe: the prompt is painted as a full-body character, sculpted into a textured 3D model on our own GPU, and given a skeleton so it animates immediately. Selfies still use the face pipeline, which is what a likeness needs. The free 3D generator behind the forge_avatar tool also stopped failing when the community GPU spaces were out of quota: it now moves the job onto our own worker instead of giving up.",
+ "link": "/genesis",
+ "tags": [
+ "fix",
+ "improvement"
+ ]
+ },
{
"date": "2026-09-18",
"type": "update",
diff --git a/public/changelog.xml b/public/changelog.xml
index 4e11d1e59..e0919d7ef 100644
--- a/public/changelog.xml
+++ b/public/changelog.xml
@@ -6,6 +6,14 @@
<atom:link href="https://three.ws/changelog.xml" rel="self" type="application/rss+xml"/>
<description>What's new on three.ws: features, improvements, and releases, newest first.</description>
<language>en</language>
+ <item>
+ <title>469 generated animations in the library, and for sale as rigged GLBs</title>
+ <link>https://three.ws/animations</link>
+ <guid isPermaLink="false">2026-09-18:469 generated animations in the library, and for sale as rigged GLBs</guid>
+ <pubDate>Fri, 18 Sep 2026 12:00:00 GMT</pubDate>
+ <category>feature</category>
+ <description>The animation library now carries 469 clips generated on our own motion model, covering 175 prompts across walks, idles, gestures, dance, combat, sport, reactions and more. Every one passed the quality gate that checks for sliding feet, sudden jumps and broken loops, and fewer than three in ten takes were thrown away. While checking them on a real avatar we found that every generated clip, including the ones already live, played with the head thrown back and the arms raised, because the model describes its skeleton with the arms hanging and the head in front of the neck. That is fixed, walks now travel instead of skating in place, and a foot flicker is smoothed out. The same fix applies when you generate a motion from a prompt in the Animation Studio. Each clip is also listed in the marketplace as a GLB on the three.ws rig that opens in Blender, Unity or Unreal, for 0.01 USDC through the x402 download, and a rotating set of twelve is free each week.</description>
+ </item>
<item>
<title>Choose your chart everywhere a coin is charted, now including DEXTools</title>
<link>https://three.ws/trades</link>
@@ -46,6 +54,14 @@
<category>feature</category>
<description>The AI proxy behind every embedded three.ws agent now answers at the address an Anthropic SDK or command-line tool builds for itself. Point a client at /api/llm/anthropic/agents/&lt;your agent id&gt; with one of your API keys and it runs on that agent's model, limits, and monthly budget. The proxy also stopped turning such clients away over their defaults: a system prompt sent as a list of text blocks is accepted, and an output limit above 16,000 tokens is lowered to 16,000 instead of rejected.</description>
</item>
+ <item>
+ <title>Text avatars now wear what you describe</title>
+ <link>https://three.ws/genesis</link>
+ <guid isPermaLink="false">2026-09-18:Text avatars now wear what you describe</guid>
+ <pubDate>Fri, 18 Sep 2026 12:00:00 GMT</pubDate>
+ <category>fix</category>
+ <description>Typing a description on /genesis (or sending a prompt to the avatar API) used to produce the same template body with a face pasted onto it, so an explorer in a teal flight jacket came back in someone else's clothes. Text avatars are now built from your words head to toe: the prompt is painted as a full-body character, sculpted into a textured 3D model on our own GPU, and given a skeleton so it animates immediately. Selfies still use the face pipeline, which is what a likeness needs. The free 3D generator behind the forge_avatar tool also stopped failing when the community GPU spaces were out of quota: it now moves the job onto our own worker instead of giving up.</description>
+ </item>
<item>
<title>The $THREE page now has a live DEXTools chart and the Social Boost wins</title>
<link>https://three.ws/three-token</link>
diff --git a/public/features.json b/public/features.json
index 0682a0305..50d802cf3 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-09-18T20:01:50.366Z",
+ "generated_at": "2026-09-18T22:08:45.142Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",