Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs(ops): record what filming the product for the X queue found
nirholas979b44927506
diff --git a/docs/ops/README.md b/docs/ops/README.mdindex 276fd0952..32c5f3ea1 100644--- a/docs/ops/README.md+++ b/docs/ops/README.md@@ -24,6 +24,7 @@ Start with [gcp-production.md](gcp-production.md); it is the complete operationa| [solana-rpc-lanes.md](solana-rpc-lanes.md) | The Solana RPC tier end to end: one-sweep diagnosis, per-lane method capability, what must rotate vs fail, config traps, recovery. || [llm-lanes.md](llm-lanes.md) | The LLM provider chain end to end: which rungs serve, why the paid ones are dead, how spend is metered, the one-command Claude rollout, and per-lane probes. || [page-audit.md](page-audit.md) | `scripts/page-audit.mjs`: authed Chromium sweep of every public page, console-error gated. |+| [x-story-findings-2026-09-30.md](x-story-findings-2026-09-30.md) | What filming every feature for the X queue found: features that could not be announced because they do not work, and the defects seen on the ones that do. || [guard-wiring.md](guard-wiring.md) | Every `check:*` / `audit:*` script classified: what it checks, its measured exit code and runtime, and whether it runs in `gate`, on the deploy path, in the pre-push hook, or only by hand. || [swarm-100-audit.md](swarm-100-audit.md) | Reconciles the `prompts/swarm-100/` self-deleting work-order ledger against git history and measures every still-open order. || [avatar-asset-orphans.md](avatar-asset-orphans.md) | Avatar rows whose model or thumbnail is gone from the bucket: why they happened, how to find and repair them. |diff --git a/docs/ops/x-story-findings-2026-09-30.md b/docs/ops/x-story-findings-2026-09-30.mdnew file mode 100644index 000000000..2b58a2ff8--- /dev/null+++ b/docs/ops/x-story-findings-2026-09-30.md@@ -0,0 +1,52 @@+# What filming the product found: 2026-09-29 to 2026-09-30++Ten authors wrote stories for the @trythreews queue by using each feature end to end against+production and filming the run ([how that works](../x-story-authoring.md)). A story only exists+when the feature passed. The features that did not pass, and the defects seen along the way, are+listed here so they get fixed rather than announced. Every item was observed against the live site+on the dates above; re-check before acting, because some may have moved.++Third-party project names are left out on purpose; the pages named below carry them.++## Features that could not be announced because they do not work++| Surface | What happens | What was expected |+|---|---|---|+| `/capture` | Video to point cloud answers `503 unconfigured`: `GCP_VIDEO2SCENE_URL` is not set on the API service and no `model-video2scene` Cloud Run service exists. `docs/capture.md` says the worker is not deployed. | The page's headline feature. |+| `/cosmos` | `POST /api/cosmos` answers `503 lane_unavailable`. The stage avatar renders in a T-pose with its head out of frame. | A world generated behind the avatar. |+| `/tty` | The command on the page, `curl three.ws/tty`, prints nothing: the load balancer answers 301 to https with an empty body. After any browser visit, `curl https://three.ws/tty` gets the HTML page from the CDN for about half an hour, because the HTML variant is cached without `Vary: Accept`. In a browser the live panel never animates: the stream is brotli-compressed and fully buffered (time to first byte 5.66 s on a 5.68 s stream). The renderer itself works. | An avatar streamed into a terminal. |+| `/stream` | The progressive panel renders layer 0 correctly and then explodes into a spike ball after layer 1, for every avatar. The summary line reports "0.5x faster to first frame" when the stream is slower. The CLI on the page fails with `ERR_MODULE_NOT_FOUND` for an undeclared dependency in the published 0.1.0. | A progressively refined avatar. |+| `/validation` | The Inspect tab fails with "React is not defined". | The validator's inspect view. |+| `/concierge` | About one ask in five comes back empty ("I could not come up with an answer just now"): measured 7 of 36. In `api/concierge.js`, when the first model rung streams no content the handler sends `done` instead of falling to the next rung. The sentence splitter also speaks "[https://three." when an answer contains a link. | A grounded answer every time. |+| `/embed-doctor` | Four of four correct embeds are reported "Broken": the tutorial's canonical snippet is served a 404 page inside the sandbox, a plain GLB snippet is failed on a benign decoder abort, and live-page mode fails on the site's own pages. The findings also order a fix "above" that is printed below. | A Healthy verdict for a working embed. |+| `/nvidia` | The fleet table does not match production: one GPU service is not ready (startup probe timing out), one lane has failed every job for three days ("task orphaned: no progress within 30 minutes"), and three listed workers are not deployed as GPU services. | An accurate fleet page. |+| `/diorama`, `/world-lines`, `/crews` | Empty in production: no public dioramas, no active quests in any region, one test crew. | Something to show. |+| `/herald` (burst) | With the 3D body, five messages sent at once are all counted as delivered in 0.2 s and only the summary bubble is ever readable. The walk companion is persistent on every page and its `announce()` resolves as soon as the line is up, so Herald's one-at-a-time delivery never waits. Fix in `herald-sdk/src/presenters/avatar.js` (hold for `dwellMs` when the companion is persistent) or in the walk SDK (resolve after the hold). | One message at a time, each readable. |++## Defects on surfaces that were announced or are otherwise fine++- **`/herald`:** the documented import `import { createHerald, pollSource } from 'https://three.ws/herald.js'` has no exports in the served file; only `window.threeHerald` works. The page says the card presenter takes over under reduced motion; it does not (only without WebGL). The playground cannot show dedupe because each send gets a fresh id. The companion introduces itself with a random guest name about 9.6 s after load; the name list includes a word that reads as an exchange name.+- **`/docs/world`:** pressing `/` opens both the Docs World search and the site-wide command palette on top of it. "Shift+Enter has the world walk you there" lays a trail but the avatar does not move (the tour, the tooltip and `docs/docs-world.md` all overstate it). The social description says 14 sections; the index has 15. The Top Down camera shows only the hub, not the ring.+- **`/drive`:** `/api/tts/edge` answers 401 before the fallback succeeds, a console error on every turn. The model reply is uncontrolled and once volunteered a third-party launchpad; re-films need their frames checked.+- **`/glance`:** the SVG card in an `<img>` shows a broken-image icon where the agent thumbnail should be (an external image cannot load inside an SVG used as an image; it needs a data URI). The card prints a raw event name ("last: load-end 3d ago"). Of 600 published agents none has "Moves today" above 0, because chats do not count as moves. At 720 px the 480 px card overflows its panel. `/api/glance/token` returns 401 on every signed-out load. `?agent=` links leave the Agent dropdown on the featured agent.+- **`/3d`:** the live badge is stuck on "CHECKING…" (i18n rewrites `#liveBadge` after `setLive` runs). `footer.foot` renders `position:absolute` over the stats cards on the first screen.+- **`/inspect`:** "Non-collapsed bounds" reports raw quantized units for meshopt models, not world units.+- **`/render-lab`:** the default model is a crypto personality likeness; one model appears twice in the chips; the sheet button leaves a doubled tooltip.+- **`/avatar-sdk`:** the hero viewer shows a bind-pose T-pose, which the operating rules say never to ship, and the playground offers a real person's likeness.+- **`/avatar-engines`:** the sticky filter bar is translucent and family headings bleed through it while scrolling.+- **`/characters`:** user cards show wallet dollar values, launchpad descriptions, a public QA test account, and T-pose thumbnails.+- **`/widgets`, `/integrations`, `/timeline`:** name third-party coins, exchanges and launchpads in chips, cards and milestones, so none can be filmed under the coin gate.+- **`/wardrobe`:** the page's intro names a stablecoin above the fold; the reel starts below it.++## Pipeline defects found and fixed during the run++- The camera's clock pause had a 50 ms window that a busy WebGL page overran ("Cannot fast-forward to the past"); the margin is now generous with retries.+- The fact checker crashed on a page whose body had not mounted; it now reads an empty page and fails the check.+- The walk companion was hidden as chrome on every page, including the one whose subject it is; a scenario can now `show` it.+- A tap-only `press` could not walk a character; a key can now be held for a filmed stretch.+- A loose control-name match clicked "Clear search" for "Search"; exact names are matched first.+- The caption bar clamps at two lines; captions over about 90 characters were cut off, and the validator now refuses them.++## Surfaces judged not to be stories++`/login`, `/register`, `/pricing`, `/sitemap`, `/features/scan` (a marketing page with a stock sample), `/companion` (marketing when signed out), `/smart-home` and its subpages (sign-in walls with no demo house), `/voice/home` (needs a microphone), `/irl` (camera and location gates by design), `/app` (the viewer with "Sign in to save").