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): record wallet accessibility and suggested-skills entries, refresh generated pages
nirholas8d29b0958c00
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 6d07eef03..f2b4059dd 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -10,6 +10,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Docs · Flappin UFO** (`/docs/play-ufo`): How Flappin UFO runs are recorded, replayed and verified on the server, how the leaderboard ranks players, and how the ghost of the top run works.- **Docs · MCP registry sentinel, daily gap report** (`/docs/mcp-registry-sentinel`): The daily cron that diffs every MCP server three.ws ships against the official registry and npm, and raises one ops alert when the set of gaps changes. What it reads and what it reports.- **Docs · Owner-Funded Agent Budgets** (`/docs/agent-allowance-budgets`): Keep funds in your own wallet and give an agent a capped, expiring allowance enforced by the Solana Subscriptions and Allowances program. How the budget is created, pulled, guarded and revoked, and how to prove it on devnet.+- **Docs · Suggested skills** (`/docs/skill-candidates`): Agents draft a skill bundle from a run that verifiably worked, with argument values never stored. You review the bundle and evidence, then install it on that agent only, publish it, or dismiss it. Includes the API and the MCP tool.- **Docs · X post reader and free video tool** (`/docs/x-video`): One keyless reader for public X posts, shared by the price-impact tools and the free X video page: how it fetches, what it returns and where it is used.- **Docs: Agent self-onboarding** (`/docs/agent-self-onboarding`): An agent signs itself up with a Solana key and no email, gets an account, a wallet and an API key, and buys a paid plan with one x402 payment. Challenge format, errors, limits and the CLI.- **install.md** (`/install.md`): How to install three.ws in any MCP client: one command, per-client settings, and every hosted endpoint. Generated from the MCP directory.@@ -19,6 +20,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Agent memory now learns from trade results, and the decision trail has a verify endpoint**: When a snipe closes, its realized P&L, win or loss and hold time are written back onto the memories the agent recalled when it opened the trade. Recall then ranks those memories by a bounded outcome weight (0.65 to 1.35, halving every 45 days, never zero), so lessons from winners rise while memories tied to losses sink but still come back as warnings. Every recall hit now reports its rankScore and an outcome block with the weight, wins, losses and net USD so you can see why it ranked. The hash-chained decision trail can be re-walked at GET /api/agents/:id/decision-trail/verify, which returns ok, the head hash and the zero-based index of the first broken row after any edit. The reasoning ledger page now fetches it and links to it from the verified badge. (`/reasoning-ledger`) `[feature, improvement]`- **Agents answer mentions of their own X account, in their own persona**: An agent with its own connected X account and mention replies switched on is now polled by the mention bot. It replies in its own persona, attaches a render of its own avatar to conversational replies, and only acts on the intents its owner allowed, up to a daily cap. Dry run stays the default: nothing posts until the owner turns dry run off and the operator enables live mode. A connection missing the posting scope is reported as missing_scope instead of being polled. (`/agents`) `[feature]`- **Agents can sign up to services: inbox codes and sign-in links**: An agent's own address can now receive verification emails and hand back the one-time code or sign-in link. New inbox_list, inbox_read and inbox_wait_for_code tools read the code with a confidence score, only from services the owner lists under Code senders, only from authentic non-spam mail. Email bodies stay untrusted data and links are never fetched for the agent. (`/agent-mail`) `[feature]`+- **Agents suggest skills from runs that worked**: After a run that verifiably worked (several tools with no error, a passed labor-escrow job, or a closed profitable trade), an agent now drafts a real skill bundle from it and lists it under Suggested skills on the agent dashboard. Argument values from the run are never stored, only their shapes. You read the bundle and the evidence run, then install it on that agent only, publish it to the marketplace, or dismiss it. Nothing installs or publishes without your click, and a draft that fails the marketplace checks can never be installed. When an installed skill is used again and the run does better, the agent proposes a revision you can accept instead of changing the skill. (`/docs/skill-candidates`) `[feature]`- **An agent can sign itself up and pay for its plan**: An autonomous agent now signs up with a Solana key and no email: it signs a single-use server challenge, receives an account, a custodial wallet and an API key, and can then buy the Builder or Scale plan with one USDC x402 payment on Solana. The CLI does the whole thing with `three-ws signup --agent`. Replayed or badly signed challenges are rejected, each key gets one account, and signups are rate limited and capped per day. (`/docs/agent-self-onboarding`) `[feature, sdk]`- **AR Studio source now lives in the monorepo**: The 3d-ar-studio npm package and the /ar/studio page now run the same code: the package source moved into packages/ar-studio and the page imports its scene math, multi-anchor WebXR session, room client and lighting modules directly, so fixes land once instead of in two diverging copies. (`/ar/studio`) `[sdk, improvement]`- **Chain turnover on /chains**: The chains leaderboard now has a sortable Turnover column (24h DEX volume divided by TVL) that shows which chains have capital actively trading rather than parked. Chains with no TVL or no reported volume show n/a. (`/chains`) `[feature]`@@ -44,6 +46,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **three-ws pay: settle x402 and MPP challenges from the terminal with a key you hold**: The CLI can now pay a 402 itself. `three-ws pay <url>` reads an x402 v2, x402 v1 or MPP Solana challenge, prefers Solana, signs with a wallet kept in the OS keychain (or an encrypted file behind a passphrase), retries once and prints the body. `--dry-run` shows the payee, exact amount and network and signs nothing. A permissions file sets allowed origins, networks, assets and payees, per-call and per-day maximums and a confirm-above threshold, and a refused challenge exits with a stable code (10) and a reason string. `three-ws pay mcp` serves the same under the same permissions as a stdio MCP server with pay_quote and pay_fetch. `[feature, sdk]`- **Trust grades for every MCP server**: /mcp-tools now grades each of the 51 MCP servers from A to F on a 0-100 score built from facts the build checks: tools declared and described, safety annotations, an installable package or mounted endpoint, a registry manifest, a README, a license, tests, prompts, resources and the Glama claim. Hover or focus a grade for the full breakdown, and click the Trust column to sort. The rubric and weights are documented. (`/docs/mcp`) `[feature]`- **Turn a Solana program's Anchor IDL into an agent skill**: POST /api/skills/import now accepts idl_url or program_id. Each account type becomes a read tool that decodes it by address, each instruction a preview tool that builds the unsigned instruction with a plain summary, and a destructive send tool that hands it to the wallet confirm flow. A risk panel flags token movement, SOL spend, account closure and authority changes. Nothing the skill generates can sign. (`/skills/import`) `[feature, sdk]`+- **Wallet and payment screens now work with a keyboard and a screen reader**: Addresses read as short text on screen and as the full value in groups of four to a screen reader, from one shared formatter that replaced more than a hundred copies. The connect picker, payment modal, vault dialogs and add-funds sheet trap focus, make the page behind inert, close on Escape and return focus to the button that opened them. Payment steps now say completed, current or failed in text, not only by color, and low-contrast labels in the payment modal and the vaults page were fixed. /wallet, /agent-wallet, /claim-wallet and /vaults joined the accessibility gate. (`/wallet`) `[improvement]`- **x402 pay-for-what-you-use on Solana (upto)**: A paid route can now advertise an upto offer beside its fixed price: the buyer authorizes a cap, the seller measures the work and settles only that amount, and the rest of the escrowed deposit returns to the buyer. A handler that fails settles nothing. The LLM proxy is the first route converted (5 atomics per token, capped at 5x the flat price). Agent payers refuse a cap above their per-call limit before signing, and the unused part of the cap is released from their budget. Existing exact clients are unaffected. (`/docs/x402-upto`) `[feature, improvement]`## 2026-10-15diff --git a/STRUCTURE.md b/STRUCTURE.mdindex 9b3d16c84..a463b38b6 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -598,6 +598,7 @@ array. Runbook: [docs/contributing.md](docs/contributing.md#publishing-packages-| `@three-ws/agents` | [packages/agents-sdk/](packages/agents-sdk) | `/api/v1`, route logic in [api/_lib/agents-v1/](api/_lib/agents-v1) | Typed TypeScript client for the v1 Agents API (agents, chat, runs with SSE streaming, skills, automations, wallet, swap) with retries, idempotency keys, typed errors and a client-side confirm gate on fund-moving calls. tsup build, zero runtime dependencies. Not published yet, and most routes it calls are not mounted under `/api/v1` yet; its README lists which answer || `@three-ws/mcp-policy` | [packages/mcp-policy/](packages/mcp-policy) | [api/_mcp/policy.js](api/_mcp/policy.js), [api/mcp-policy.js](api/mcp-policy.js) | The tool policy table every MCP server enforces: each tool's group and tier, financial tools off by default and gated on a named confirm flag plus a fresh preview id. `./stdio` wires a stdio server in one call. Workspace package, not published yet || `@three-ws/agent` | [packages/agent-cli/](packages/agent-cli) | `@three-ws/agent-runtime`, `/api/mcp-agent`, `/api/mcp`, `/api/v1` | Local agent runtime: the agent loop on your own machine with workspace file tools, a resource-limited shell sandbox, the three.ws MCP tools, per-class approvals (financial always asks) and SQLite sessions with full-text search. The runtime core is in tree; the `three-ws-agent` CLI and TUI entry points it declares are not yet |+| Wallet and payment accessibility (W3AG) | Address formatter [src/shared/address.js](src/shared/address.js), modal focus trap [src/shared/focus-trap.js](src/shared/focus-trap.js), used by [src/payment-modal.js](src/payment-modal.js), [src/wallet/connect-button.js](src/wallet/connect-button.js), [src/vaults.js](src/vaults.js) | Live | One formatter draws the short address and announces the full one in groups of four; one trap gives every wallet dialog an inert background, Tab cycling, Escape and focus return. Docs: [docs/accessibility.md](docs/accessibility.md). Tests: [tests/e2e/w3ag-wallet.spec.js](tests/e2e/w3ag-wallet.spec.js), [tests/shared-address.test.js](tests/shared-address.test.js) |## Where things actually livediff --git a/data/changelog.json b/data/changelog.jsonindex 134456a62..132825a2d 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,13 @@{"$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, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-10-23",+ "title": "Wallet and payment screens now work with a keyboard and a screen reader",+ "summary": "Addresses read as short text on screen and as the full value in groups of four to a screen reader, from one shared formatter that replaced more than a hundred copies. The connect picker, payment modal, vault dialogs and add-funds sheet trap focus, make the page behind inert, close on Escape and return focus to the button that opened them. Payment steps now say completed, current or failed in text, not only by color, and low-contrast labels in the payment modal and the vaults page were fixed. /wallet, /agent-wallet, /claim-wallet and /vaults joined the accessibility gate.",+ "tags": ["improvement"],+ "link": "/wallet"+ },{"date": "2026-10-23","title": "Agents suggest skills from runs that worked",diff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex 4ca2051e5..2c4904dc8 100644--- a/public/changelog-recent.json+++ b/public/changelog-recent.json@@ -1,11 +1,11 @@{- "generated_at": "2026-10-23T22:44:01.654Z",+ "generated_at": "2026-10-23T22:57:53.795Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},- "total": 4148,+ "total": 4149,"complete": false,"full_feed": "/changelog.json","entries": [@@ -416,6 +416,16 @@"sdk"]},+ {+ "date": "2026-10-23",+ "type": "update",+ "title": "Wallet and payment screens now work with a keyboard and a screen reader",+ "summary": "Addresses read as short text on screen and as the full value in groups of four to a screen reader, from one shared formatter that replaced more than a hundred copies. The connect picker, payment modal, vault dialogs and add-funds sheet trap focus, make the page behind inert, close on Escape and return focus to the button that opened them. Payment steps now say completed, current or failed in text, not only by color, and low-contrast labels in the payment modal and the vaults page were fixed. /wallet, /agent-wallet, /claim-wallet and /vaults joined the accessibility gate.",+ "link": "/wallet",+ "tags": [+ "improvement"+ ]+ },{"date": "2026-10-23","type": "update",@@ -1549,16 +1559,6 @@"tags": ["feature"]- },- {- "date": "2026-10-11",- "type": "update",- "title": "Rig Doctor now diagnoses non-humanoid rigs too, not just naming mismatches",- "summary": "Rig Doctor's canonical-joint coverage score has nothing to say about a creature, prop, or vehicle rig: it has no Mixamo-shaped skeleton to map and always reads as \"will not animate\" by design. A new Skin weights stat answers the question that actually applies to a rig like that: how many joints influence the single heaviest-weighted vertex, and how many of the mesh's vertices came back with no joint influence at all. Zero unweighted vertices means the skin is sound even though the clip library will never retarget onto it; a nonzero count means part of the mesh will not move under any skeleton.",- "link": "/rig-doctor",- "tags": [- "feature"- ]}]}diff --git a/public/changelog.json b/public/changelog.jsonindex 9618d59d4..fa97b069e 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-23T22:44:01.591Z",+ "generated_at": "2026-10-23T22:57:53.772Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -413,6 +413,16 @@"sdk"]},+ {+ "date": "2026-10-23",+ "type": "update",+ "title": "Wallet and payment screens now work with a keyboard and a screen reader",+ "summary": "Addresses read as short text on screen and as the full value in groups of four to a screen reader, from one shared formatter that replaced more than a hundred copies. The connect picker, payment modal, vault dialogs and add-funds sheet trap focus, make the page behind inert, close on Escape and return focus to the button that opened them. Payment steps now say completed, current or failed in text, not only by color, and low-contrast labels in the payment modal and the vaults page were fixed. /wallet, /agent-wallet, /claim-wallet and /vaults joined the accessibility gate.",+ "link": "/wallet",+ "tags": [+ "improvement"+ ]+ },{"date": "2026-10-23","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex 32359e145..f9b0f19de 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -326,6 +326,14 @@<category>feature</category><description>POST /api/skills/import now accepts idl_url or program_id. Each account type becomes a read tool that decodes it by address, each instruction a preview tool that builds the unsigned instruction with a plain summary, and a destructive send tool that hands it to the wallet confirm flow. A risk panel flags token movement, SOL spend, account closure and authority changes. Nothing the skill generates can sign.</description></item>+ <item>+ <title>Wallet and payment screens now work with a keyboard and a screen reader</title>+ <link>https://three.ws/wallet</link>+ <guid isPermaLink="false">2026-10-23:Wallet and payment screens now work with a keyboard and a screen reader</guid>+ <pubDate>Fri, 23 Oct 2026 12:00:00 GMT</pubDate>+ <category>improvement</category>+ <description>Addresses read as short text on screen and as the full value in groups of four to a screen reader, from one shared formatter that replaced more than a hundred copies. The connect picker, payment modal, vault dialogs and add-funds sheet trap focus, make the page behind inert, close on Escape and return focus to the button that opened them. Payment steps now say completed, current or failed in text, not only by color, and low-contrast labels in the payment modal and the vaults page were fixed. /wallet, /agent-wallet, /claim-wallet and /vaults joined the accessibility gate.</description>+ </item><item><title>x402 pay-for-what-you-use on Solana (upto)</title><link>https://three.ws/docs/x402-upto</link>diff --git a/public/features.json b/public/features.jsonindex c6d667cd9..3d555243a 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-23T22:44:01.535Z",+ "generated_at": "2026-10-23T22:57:53.758Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",