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
test: stop route, asset-host and X queue checks depending on local builds or expired reviews
nirholas6c546e91b700
diff --git a/data/x-content/queue.json b/data/x-content/queue.jsonindex ba35783e4..06a9f91cb 100644--- a/data/x-content/queue.json+++ b/data/x-content/queue.json@@ -802,7 +802,7 @@{"type": "page","url": "https://three.ws/api/catalog?limit=1",- "contains": "\"total\":3531"+ "contains": "\"total\":3961"}]},@@ -874,6 +874,17 @@"contains": "ArmChair_01"}},+ {+ "type": "api",+ "name": "the free catalog still holds 3,500+ assets",+ "url": "https://three.ws/api/catalog?limit=1",+ "expect": {+ "json": {+ "path": "total",+ "min": 3500+ }+ }+ },{"type": "api","name": "the skills doc is live",@@ -1667,7 +1678,8 @@},{"id": "galaxy",- "status": "approved",+ "status": "review",+ "note": "Returned to review 2026-10-08: the 2026-09-20 review expired, and the re-review (data/x-content/reviews/galaxy.json) blocks on the attached frame, which shows the /galaxy badge 'Positioned by IBM Granite embeddings on watsonx.ai' while the live map reports model nvidia/nemotron-3-embed-1b, the fallback lane. The badge in pages/galaxy.html is static. Make it follow the live model, deploy, recapture galaxy-hero with npm run announce:media -- --only galaxy-hero, then review and approve again.","kind": "post","tier": 1,"lane": "labs",diff --git a/data/x-content/reviews/ai-3d-skills.json b/data/x-content/reviews/ai-3d-skills.jsonindex bd752563d..c0c15a16e 100644--- a/data/x-content/reviews/ai-3d-skills.json+++ b/data/x-content/reviews/ai-3d-skills.json@@ -1,7 +1,7 @@{"id": "ai-3d-skills",- "contentHash": "aa6e3ef6a34a5650a638dc0a5edcdbf2289c74b7894e0bcfcb15096d7ff7f7de",- "reviewedAt": "2026-09-18T17:43:24.161Z",+ "contentHash": "fd4e2ce28b18656c5dbaf27f2faac52affde51ecaf75b6e0670d50523c4e89aa",+ "reviewedAt": "2026-10-08T20:01:41.774Z","passed": true,"blockers": [],"texts": [@@ -16,7 +16,7 @@"kind": "evidence:page","target": "https://three.ws/api/catalog?limit=1","ok": true,- "detail": "live page shows \"\"total\":3531\""+ "detail": "live page shows \"\"total\":3961\""},{"claim": "free 3D skills for Claude",@@ -72,6 +72,12 @@"ok": true,"detail": "HTTP 200, expectations met"},+ {+ "kind": "probe:api",+ "target": "the free catalog still holds 3,500+ assets",+ "ok": true,+ "detail": "HTTP 200, expectations met"+ },{"kind": "probe:api","target": "the skills doc is live",@@ -92,19 +98,11 @@"accuracy": 5,"clarity": 5,"specificity": 5,- "voice": 4,+ "voice": 5,"professionalism": 5,"visual": 5},- "issues": [- {- "severity": "minor",- "area": "voice",- "quote": "No account. No API key.",- "problem": "Two clipped fragments back to back drift toward the banned one-word-sentence drumbeat pattern, though both statements are verified in the skill files and the effect here is mild.",- "fix": "Optional merge: 'No account or API key needed.' Not required to ship."- }- ],+ "issues": [],"rewrite": {"posts": ["Your AI can make 3D now.\n\nInstall our free 3D skills for Claude, then ask it for a chair.\n\nIt checks 3,500+ free 3D assets first. If nothing fits, it makes a new model from your words.\n\nNo account. No API key.\n\nthree.ws/docs/agent-skills"@@ -113,10 +111,10 @@"A three.ws card reading 'Your AI can make 3D now.' beside a browser window showing the free three.ws object library: a grid of CC0 3D models including an alarm clock, a ceramic vase, an American football and an arm chair, each with Preview, AR and Download buttons"]},- "summary": "Every claim passes verification against live pages and skill files, the image shows the real catalog and matches the copy, and the post fits the length band with a mechanism-led opener. The only note is a minor stylistic drumbeat in the final short lines, which does not block publication.",+ "summary": "Every claim passed verification against live pages and skill files, including the 3,500+ catalog figure backed by the live total of 3,961. The card image matches the copy, the alt text is accurate, and the post follows the voice contract exactly. Ship it.","model": "nvidia:moonshotai/kimi-k3","fallbacks": [- "No GCP credentials found. Set GCP_SERVICE_ACCOUNT_JSON, run `gcloud auth application-default login`, or run on GCE/Cloud Run.",+ "Vertex 403: {\n \"error\": {\n \"code\": 403,\n \"message\": \"Request had insufficient authentication scopes.\",\n \"status\": \"PERMISSION_DENIED\",\n \"details\": [\n {\n \"@type\": \"type.googleapis.com/goog","openrouter 402: {\"error\":{\"message\":\"Insufficient credits. Add more using https://openrouter.ai/settings/credits\",\"code\":402,\"metadata\":{\"limit_source\":\"openrouter_credits\",\"remedy_hint\":\"Add credits at https://openr","openai 429: {\n \"error\": {\n \"message\": \"Your account is not active, please check your billing details on our website.\",\n \"type\": \"billing_not_active\",\n \"param\": null,\n \"code\": \"billi"],diff --git a/data/x-content/reviews/galaxy.json b/data/x-content/reviews/galaxy.jsonindex 7cb742b7d..3abe181e4 100644--- a/data/x-content/reviews/galaxy.json+++ b/data/x-content/reviews/galaxy.json@@ -1,9 +1,12 @@{"id": "galaxy","contentHash": "baa1b95fe120e328eee1b2f2312d14182c0eafd8e3c31da69e14f72daa68e896",- "reviewedAt": "2026-09-20T07:15:37.315Z",- "passed": true,- "blockers": [],+ "reviewedAt": "2026-10-08T20:03:47.569Z",+ "passed": false,+ "blockers": [+ "editor (visual): The pack states the embedding provider is deliberately not named because the live map is currently built by the fallback lane, not the preferred one. The attached frame displays an IBM Granite on watsonx.ai badge, which contradicts that note. Per policy, when the screenshot disagrees with the live product state the screenshot is stale: it must be recaptured, and the copy must never be adjusted to match a stale image.",+ "editor verdict is revise"+ ],"texts": ["Agent Galaxy is a 3D star-map of every published agent, placed by meaning. Type what you want in plain language and the map flies to the closest ones. three.ws/galaxy","Proximity is similarity: agents that do similar things sit near each other, so browsing the map is browsing by meaning rather than by keyword.",@@ -62,34 +65,58 @@]},"editor": {- "verdict": "publish",+ "verdict": "revise","scores": {- "accuracy": 5,- "clarity": 5,- "specificity": 5,+ "accuracy": 4,+ "clarity": 4,+ "specificity": 4,"voice": 5,"professionalism": 5,- "visual": 5+ "visual": 2},- "issues": [],+ "issues": [+ {+ "severity": "blocking",+ "area": "visual",+ "quote": "Positioned by IBM Granite embeddings on watsonx.ai (badge visible in the screenshot)",+ "problem": "The pack states the embedding provider is deliberately not named because the live map is currently built by the fallback lane, not the preferred one. The attached frame displays an IBM Granite on watsonx.ai badge, which contradicts that note. Per policy, when the screenshot disagrees with the live product state the screenshot is stale: it must be recaptured, and the copy must never be adjusted to match a stale image.",+ "fix": "Re-run npm run announce:media -- --only galaxy-hero against the live route and replace the attachment with a frame that reflects the current build. If the live page still shows the IBM Granite badge, then the pack note is outdated and the badge claim must be verified with a passing check before shipping."+ },+ {+ "severity": "major",+ "area": "visual",+ "quote": "Alt text: \"hundreds of labelled agent stars\"",+ "problem": "The frame shows 600 agents and 8 constellations per the in-image counters, and most stars are unlabelled; only constellation names and one agent card carry labels. The alt text overstates labelling.",+ "fix": "Use: A dark 3D star map on the Agent Galaxy page with colored clusters of agent stars, a search-by-meaning box on the left, and a constellations panel listing eight groups on the right."+ },+ {+ "severity": "minor",+ "area": "specificity",+ "quote": "Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones.",+ "problem": "Post 3 restates post 1's mechanism almost verbatim (plain language, closest agents), so the thread's final beat adds little new information. The verified docs also support the stronger, more specific framing already used in post 2.",+ "fix": "Keep post 3 but differentiate it, e.g.: The same embedding model that placed the stars also ranks your query, so search and layout agree on what closest means."+ }+ ],"rewrite": {"posts": ["Agent Galaxy is a 3D star-map of every published agent, placed by meaning. Type what you want in plain language and the map flies to the closest ones. three.ws/galaxy","Proximity is similarity: agents that do similar things sit near each other, so browsing the map is browsing by meaning rather than by keyword.",- "Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones."+ "The same embedding model that placed the stars also ranks your query, so search and the layout agree on what closest means."],"altText": [- "The Agent Galaxy page with hundreds of labelled agent stars clustered in 3D space and the natural-language search box over them."+ "A dark 3D star map on the Agent Galaxy page with colored clusters of agent stars, a search-by-meaning box on the left, and a constellations panel listing eight groups on the right."]},- "summary": "All four claims are verified word-for-word against docs/galaxy.md, both API probes pass, the link returns 200, and the screenshot matches the copy (600 agents, no contradicted numbers). Voice, length, alt text, and visual all comply with the house contract; ship as is.",+ "summary": "All copy claims pass verification and the voice is clean. The blocker is the attachment: it shows an IBM Granite on watsonx.ai badge that the pack explicitly says is not the current live build, so the frame must be recaptured before this ships.","model": "nvidia:moonshotai/kimi-k3","fallbacks": [- "No GCP credentials found. Set GCP_SERVICE_ACCOUNT_JSON, run `gcloud auth application-default login`, or run on GCE/Cloud Run.",+ "Vertex 403: {\n \"error\": {\n \"code\": 403,\n \"message\": \"Request had insufficient authentication scopes.\",\n \"status\": \"PERMISSION_DENIED\",\n \"details\": [\n {\n \"@type\": \"type.googleapis.com/goog","openrouter 402: {\"error\":{\"message\":\"Insufficient credits. Add more using https://openrouter.ai/settings/credits\",\"code\":402,\"metadata\":{\"limit_source\":\"openrouter_credits\",\"remedy_hint\":\"Add credits at https://openr","openai 429: {\n \"error\": {\n \"message\": \"Your account is not active, please check your billing details on our website.\",\n \"type\": \"billing_not_active\",\n \"param\": null,\n \"code\": \"billi"],- "rewriteFindings": []+ "rewriteFindings": [+ "claims: claim \"Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones.\" does not appear in the copy; claims must quote the post"+ ]},"editorError": null}diff --git a/tests/agent-earnings-board.test.js b/tests/agent-earnings-board.test.jsindex 29c6d4e82..c7f4c625b 100644--- a/tests/agent-earnings-board.test.js+++ b/tests/agent-earnings-board.test.js@@ -29,7 +29,7 @@ vi.mock('../api/_lib/rate-limit.js', async (importActual) => {return { ...actual, limits: new Proxy({}, { get: () => ok }) };});vi.mock('../api/_lib/sol-price.js', () => ({ solPriceUsd: async () => 100 }));-vi.mock('../api/_lib/r2.js', () => ({ publicUrl: (k) => `https://cdn.three.ws.test/${k}` }));+vi.mock('../api/_lib/r2.js', () => ({ publicUrl: (k) => `https://three.ws/cdn/${k}` }));process.env.DATABASE_URL ||= 'postgres://pglite.test/db';diff --git a/tests/route-build-inputs.test.js b/tests/route-build-inputs.test.jsindex 75d75811e..62183344e 100644--- a/tests/route-build-inputs.test.js+++ b/tests/route-build-inputs.test.js@@ -22,6 +22,14 @@ const INPUT_DIRS = [...vite.matchAll(/resolve\(__dirname,\s*'(pages\/[a-z0-9-]+)// the blog, news, events and demo pages are generated into dist/ by their own// builders, and a capture-group destination ($1) names no single file.const GENERATED = /^(docs|blog|news|events|demos)\/|\$\d/;+// Separate Vite apps whose output is a gitignored build artifact under public/,+// so the page exists only after its builder has run. Each one is accepted only+// while that builder still writes there and still runs in the deploy build+// ahead of the frontend build, which is what the second test pins.+const SUB_APPS = {+ 'chat/': { builder: 'build:chat', config: 'chat/vite.config.js', outDir: '../public/chat' },+};+const pkg = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8'));function unbuiltDestinations() {const missing = new Set();@@ -29,6 +37,7 @@ function unbuiltDestinations() {if (!route.dest || !/\.html(\?|$)/.test(route.dest)) continue;const dest = route.dest.replace(/^\//, '').replace(/\?.*$/, '');if (GENERATED.test(dest)) continue;+ if (Object.keys(SUB_APPS).some((dir) => dest.startsWith(dir))) continue; // built by its own appif (existsSync(resolve(root, 'public', dest))) continue; // copied verbatimconst source = `pages/${dest}`;if (INPUTS.has(source)) continue;@@ -46,4 +55,13 @@ describe('vercel.json routes and the production build', () => {it('every routed static page is emitted by the build', () => {expect(unbuiltDestinations()).toEqual([]);});++ it.each(Object.entries(SUB_APPS))('the %s sub-app is built into public/ before the frontend build', (dir, app) => {+ const config = readFileSync(resolve(root, app.config), 'utf8');+ expect(config, `${app.config} no longer writes to ${app.outDir}`).toContain(`outDir: '${app.outDir}'`);+ const chain = (pkg.scripts['build:gcp'] || '').split(/\s*&&\s*/);+ const builder = chain.indexOf(`npm run ${app.builder}`);+ expect(builder, `build:gcp never runs ${app.builder}, so /${dir} would 404 in production`).toBeGreaterThanOrEqual(0);+ expect(builder).toBeLessThan(chain.indexOf('npm run build'));+ });});