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(changelog): publish this batch's entries with the cosmos provider coverage
nirholasd22576154624
diff --git a/data/changelog.json b/data/changelog.jsonindex be667217f..122738656 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-17",+ "title": "Clip Director shows real traders again, and can no longer print a number the trade never made",+ "summary": "The Clip Director page told every visitor that no agent had ever closed a trade. Its trader picker asked the leaderboard for the highest-ranked agents and then kept only the ones with a closed round-trip, and because the ranking score has nothing to do with having closed trades, the nine agents that qualified all sat below the cut. The picker now asks the leaderboard for exactly what it needs, so those nine traders and their real closed positions are back on the page. The bigger repair is underneath: the card copy is written by a language model, and one of the providers answered a real +1.89x win with an invented loss on a different coin, complete with a celebrating avatar, next to the on-chain link proving otherwise. Every generated card is now checked against the trade it describes before it ships, so a ticker or a figure that is not in the round-trip gets the card thrown away and rewritten from the position itself, and a stop-out can never be celebrated. Also on the page: a shared /clip-director?agent_id= link now opens that trader even when they are outside the ranking, the Try again buttons retry the step that actually failed instead of doing nothing, each card's call to action is a real link, and the copy button copies on browsers that block the clipboard API instead of telling you to press a key.",+ "tags": [+ "fix",+ "improvement"+ ],+ "link": "/clip-director"+ },{"date": "2026-08-17","title": "The Pole Club leaderboard now ranks the dancers who are actually on the poles",diff --git a/tests/api/providers-nvidia-cosmos.test.js b/tests/api/providers-nvidia-cosmos.test.jsindex a3141c8d0..9faca4011 100644--- a/tests/api/providers-nvidia-cosmos.test.js+++ b/tests/api/providers-nvidia-cosmos.test.js@@ -327,3 +327,65 @@ describe('nvidia-cosmos provider: 202-then-poll loop', () => {expect(globalThis.fetch).not.toHaveBeenCalled();});});++// NVIDIA retires a hosted preview function without retiring its gateway path, so+// the route keeps answering and only an authenticated submit reveals the model is+// gone ("Function '<uuid>': Not found for account '<id>'"). That is exactly what+// the live account hit on cosmos-predict1-7b, and it must not read as a transient+// failure the user should retry.+describe('nvidia-cosmos provider: a retired route falls over instead of killing the lane', () => {+ const RETIRED_BODY = { detail: "Function '01327741-a1cb-4bdb-a31e-5391c8ca48c2': Not found for account 'acct-1'" };+ const FALLBACK_INVOKE = 'https://ai.api.nvidia.com/v1/cosmos/nvidia/cosmos-predict1-5b';++ it('submits to the next published route when the first is retired for this account', async () => {+ vi.spyOn(console, 'warn').mockImplementation(() => {});+ const urls = [];+ globalThis.fetch = vi.fn(async (url) => {+ urls.push(String(url));+ if (String(url) === DEFAULT_INVOKE) return jsonResponse(RETIRED_BODY, 404);+ return jsonResponse({}, 202, { 'nvcf-reqid': 'req-fallback' });+ });++ const provider = createNvidiaCosmosProvider();+ expect(await provider.textToWorld({ prompt: 'a koi pond at dawn' })).toEqual({ taskId: 'req-fallback' });+ expect(urls).toEqual([DEFAULT_INVOKE, FALLBACK_INVOKE]);+ });++ it('reports lane_unavailable (503) once every published route is gone', async () => {+ vi.spyOn(console, 'warn').mockImplementation(() => {});+ globalThis.fetch = vi.fn(async () => jsonResponse(RETIRED_BODY, 404));+ const provider = createNvidiaCosmosProvider();+ await expect(provider.textToWorld({ prompt: 'x' })).rejects.toMatchObject({+ code: 'lane_unavailable',+ status: 503,+ });+ });++ it('classifies the retirement detail on a non-404 status too', async () => {+ vi.spyOn(console, 'warn').mockImplementation(() => {});+ globalThis.fetch = vi.fn(async () => jsonResponse(RETIRED_BODY, 400));+ const provider = createNvidiaCosmosProvider();+ await expect(provider.textToWorld({ prompt: 'x' })).rejects.toMatchObject({ code: 'lane_unavailable' });+ });++ it('does not walk the chain for a credential failure: the next rung would fail identically', async () => {+ globalThis.fetch = vi.fn(async () => jsonResponse({ detail: 'bad key' }, 401));+ const provider = createNvidiaCosmosProvider();+ await expect(provider.textToWorld({ prompt: 'x' })).rejects.toMatchObject({ code: 'invalid_key' });+ expect(globalThis.fetch).toHaveBeenCalledTimes(1);+ });++ it('uses an explicit NVIDIA_COSMOS_INVOKE_URL alone, with no sibling fallback', async () => {+ process.env.NVIDIA_COSMOS_INVOKE_URL = 'https://nim.internal.test/v1/cosmos';+ globalThis.fetch = vi.fn(async () => jsonResponse(RETIRED_BODY, 404));+ const provider = createNvidiaCosmosProvider();+ await expect(provider.textToWorld({ prompt: 'x' })).rejects.toMatchObject({ code: 'lane_unavailable' });+ expect(globalThis.fetch).toHaveBeenCalledTimes(1);+ });++ it('treats a 4xx poll as terminal so a dead handle is not polled for five minutes', async () => {+ globalThis.fetch = vi.fn(async () => new Response(null, { status: 400 }));+ const provider = createNvidiaCosmosProvider();+ expect((await provider.status({ taskId: 'bogus-handle' })).status).toBe('failed');+ });+});