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
fix(api,docs): harden the oracle, payments, play, SNS and MCP surfaces and refresh their docs
nirholasf9fbe131f5ad
diff --git a/.agents/skills/SKILLS.md b/.agents/skills/SKILLS.mdindex b20b645a5..6015c8f31 100644--- a/.agents/skills/SKILLS.md+++ b/.agents/skills/SKILLS.md@@ -45,7 +45,7 @@ Categories:| Skill | Origin | Trigger || --- | --- | --- |-| [`gcp-triage`](gcp-triage/SKILL.md) | three.ws | Monitor three.ws production on Google Cloud Run and fix what the sweep finds. Use when the user asks to check production, diagnose an outage or error, "what's wrong with three.ws", read production logs, or run the monitoring loop. Runs the triage monitor (healthz + all-service log sweep + known-signature classification), then applies the fixes each class allows. |+| [`gcp-triage`](gcp-triage/SKILL.md) | three.ws | Monitor three.ws production on Google Cloud Run and fix what the sweep finds. Use when the user asks to check production, diagnose an outage or error, "what's wrong with three.ws", read production logs, or run the monitoring loop. Broad questions get the deep sweep (healthz + all-service logs + version, TLS, fleet readiness, live pages, crons, DB migrations, wallets), then the fixes each class allows. |## wallet/paymentsdiff --git a/.agents/skills/skills-pack.json b/.agents/skills/skills-pack.jsonindex a6b091468..1b274124a 100644--- a/.agents/skills/skills-pack.json+++ b/.agents/skills/skills-pack.json@@ -158,7 +158,7 @@},{"name": "gcp-triage",- "description": "Monitor three.ws production on Google Cloud Run and fix what the sweep finds. Use when the user asks to check production, diagnose an outage or error, \"what's wrong with three.ws\", read production logs, or run the monitoring loop. Runs the triage monitor (healthz + all-service log sweep + known-signature classification), then applies the fixes each class allows.",+ "description": "Monitor three.ws production on Google Cloud Run and fix what the sweep finds. Use when the user asks to check production, diagnose an outage or error, \"what's wrong with three.ws\", read production logs, or run the monitoring loop. Broad questions get the deep sweep (healthz + all-service logs + version, TLS, fleet readiness, live pages, crons, DB migrations, wallets), then the fixes each class allows.","whenToUse": "Production health checks, log diagnosis, error triage, and the recurring monitor-and-fix loop. For a raw log view only, `npm run logs` is enough without this skill.","category": "ops/production","origin": "three.ws",diff --git a/CHANGELOG.md b/CHANGELOG.mdindex b3180e82a..8a9a9ade6 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -4,6 +4,18 @@Public history for [three.ws](https://three.ws), newest first. New pages come from `added` dates in data/pages.json; everything else is curated in data/changelog.json. Also available as [JSON](https://three.ws/changelog.json) and [RSS](https://three.ws/changelog.xml), live at [three.ws/changelog](https://three.ws/changelog).+## 2026-08-15++- **A broken paid endpoint is no longer reported as a free one**: Payment sessions let you hand an agent a budget instead of a key, and two parts of that path judged an endpoint by one rule: if it did not ask for payment, the call was free. That is only true when the endpoint actually succeeded. A paid API answering 404, 400, or 500 was being scored as a free call, and the consequences ran in the wrong direction in both places. The dry run at /pay/simulator, whose whole job is to tell you in advance whether a budget and an allowlist will carry a workload, reported a plan as feasible at a cost of nothing when in fact every endpoint in it was erroring: free calls are never priced, never allowlist-checked, and never counted, so a wall of failures looked like a clean run. And an agent spending through a session got back a success envelope saying no payment was needed for an endpoint that had just failed on it. Both now separate the two cases: a real success with no payment challenge is still free and still costs nothing, while an error status is reported as an endpoint failure carrying the status the endpoint actually returned. No session is charged either way. The simulator lists each failing endpoint by name in its problems list and no longer calls the plan feasible. (`/pay/simulator`) `[fix]`+- **A silent outage in the agent reasoning ledger now reports itself**: Every agent decision is committed to a hash chain, and that chain head is written to Solana on a schedule so anyone can check the history was never edited. The wallet that pays for those on-chain writes ran empty, and the scheduled job could not tell that apart from the harmless case where no signing key is set up at all: it answered a healthy 200 every ten minutes while re-sending the same doomed transaction for twelve agents in a row, and not one head reached the chain. A rejected write is now reported as a rejected write, the rest of the run stops instead of repeating a failure that cannot succeed, and it raises an alert so the wallet gets refilled. Verifying a ledger already worked without the on-chain leg and still does: the recomputed hash chain is the tamper proof, the on-chain write is the independent timestamp on top of it. Separately, the once-a-minute economy heartbeat now refuses to drive production from a machine that is not production, so a developer running it locally can no longer fire thirty-six live money engines at the real site. (`/docs/reasoning-ledger`) `[fix, infra]`+- **Docs pages stop opening with a wall of raw metadata, and the AWS pages say where the Marketplace listing actually stands**: Nine documentation pages are written as article drafts, so each one starts with a small block of publishing metadata: the title, where it is meant to run, its tags. That block is meant for the tooling, not for you, but the docs reader had no idea what it was and rendered it as an enormous heading at the very top of the article, above the actual writing. It is now recognised and hidden, on the page and in the Copy page text, so those articles begin where they should. Reading the same pages closely turned up claims that had drifted: several said three.ws was already live on AWS Marketplace and billing usage to your AWS invoice. The integration is built and deployed, but the listing itself has not been published yet and the pricing decision is a free subscription with no AWS metering, so the AWS pages now say exactly that and point at the page that tracks the status. The MCP article's vanity-address tool was also listed at a metered price of up to fifty cents; it is a flat five cents per grind, which is what the code has always charged. (`/docs/aws-marketplace`) `[docs, fix]`+- **Oracle stops answering "nothing is happening" when the database is the thing that is down**: Several Oracle reads shared a habit: if the database was unreachable for a few seconds, they answered normally with an empty result. The movers panel said nothing was moving, the stats hero said no coin had ever been scored and no agent was armed, a coin's conviction sparkline came back flat, and the machine-readable signal endpoint told autonomous agents there were no plays, which is exactly the cue for an agent to stand down. Every one of those answers was then cached at the edge for a minute or two, so a blip lasting seconds kept showing a dead market long after the database was back. Those endpoints now tell the difference between a connectivity failure and an ordinary query fault: the first is reported honestly as a temporary outage with a retry hint and is never cached, the second still degrades to the empty answer it always did. The social ingest got the sharper end of the same bug: it used to reply that a batch had been accepted while reporting zero mints written, a receipt for a write that never landed. It now fails loudly so the sender retries. Shared conviction cards behave too: one built during an outage is no longer pinned to a coin's link preview for 15 minutes. (`/oracle`) `[fix, improvement]`+- **Plan checkout: a paid upgrade can only ever settle on real mainnet, and a late payment is no longer stranded**: Paying for a plan creates a quote, you send the funds, then the server checks the chain before it upgrades you. Three things in that path were wrong. The checkout side has always refused test-network quotes in production, because test-network dollars are free from a faucet, but the confirm side still let a caller name the test network itself, and it is the confirm side that decides which chain it looks at and which dollar it accepts. Both ends now read the same setting, so a production upgrade can only ever be settled by real funds on mainnet. Second, an Ethereum-side payment has to wait twelve blocks before it counts, which meant funds sent near the end of a session could land on-chain and then be refused for arriving late, with the money already gone; that lane now honors the same one-hour grace window the Solana lane has, so an on-chain payment is always claimable. Third, confirming an Ethereum payment could reach a Solana quote and mark it expired, and asking to buy a skill from a malformed agent id answered a generic server error instead of telling you what was wrong with the request. (`/pricing`) `[fix, security]`+- **Self-hosting docs no longer hand you a command that wipes your environment**: The deployment guide told self-hosters to set Cloud Run environment variables with `gcloud run services update --set-env-vars`. That flag replaces the service environment wholesale, so following the instruction for a single key silently deletes every other variable the service had. The guide now uses `--update-env-vars` and says plainly why. Four more corrections landed in the same sweep across the deployment, configuration and contributing pages: the Avaturn signup link and the GitHub Discussions links were dead (Discussions are not enabled on the repository, so bug reports and design questions both go to Issues); the in-browser avatar builder was documented as needing its own hosted origin in production when the normal build already serves it same-origin at /avatar-studio; and three counts that had drifted from the code (cron jobs, MCP server packages, contract tests) were replaced with pointers to the files that hold the real numbers. (`/docs/deployment`) `[docs, fix]`+- **The Agent Economy demo works again when you just pick a service, and it fits a phone screen**: On the Agent Economy page, two 3D agents trade with each other for real SOL: Nova buys a market read, an on-chain insight, or a risk score from Oracle. Picking a service and typing nothing in the optional topic box, which is what almost everyone does, sent the request off in a shape the endpoint refused, so the demo answered with a validation error instead of a trade. It now sends the request correctly, and the endpoint accepts an empty topic besides. On a phone the page was worse than broken: the transaction feed and the status line, the entire output of the demo, were cut off the bottom of the screen with no way to scroll to them, and the floating language button sat on top of the footer links. The centre column now scrolls, the feed keeps a readable height, and the footer stays clickable. Three failure states also stopped lying: a payment that could not go through no longer ends on Transaction complete, a request that never reached the server now says so and offers to try again, and unreadable wallet balances now say they are unavailable and offer a retry instead of spinning forever. (`/agent-economy`) `[fix, improvement]`+- **The persona builder stops reporting a model outage as if you had been signed out**: The two routes behind the persona builder (the one that turns your interview answers or a sample of your own writing into a structured persona, and the one that replies to you in that persona's voice) used to hand you whatever status code the model provider returned. If a server-side key expired, the provider answered 401 and so did we, which reads to a browser as an expired session on a request where nothing was wrong with your sign-in. Both now report a provider failure as exactly what it is: a server-side fault, with a plain message and no implication that you need to log back in. Separately, when the platform's daily model-spend ceiling is reached, the builder now says so and tells you when it resets, instead of asking you to retry something that could not have succeeded for the rest of the day. Both routes also now record their model usage against your account, so the spend they generate is visible and capped rather than untracked, and the daily extraction budget now holds across every server instance instead of being counted separately on each one. `[fix, improvement]`+- **The plugin marketplace stops hiding a plugin when you page through it**: Browsing plugins a page at a time could show you the same plugin twice and never show another one at all. The catalogue was sorted by install count and publish date, and the built-in plugins were all published in the same instant with zero installs, so that sort left them tied and the database was free to order the tied rows differently on every request. One plugin therefore landed on two consecutive pages and one fell through the gap. The order is now decided all the way down, so paging through the catalogue returns every plugin exactly once. Searching also takes your text literally: typing a percent sign or an underscore used to act as a database wildcard and match rows it should not. Publishing got stricter at the same time, because a plugin manifest is handed to the model as a tool definition by whoever installs it: a tool name now has to be plain letters, digits, underscores, or hyphens, every tool needs a real description, and a manifest has to fit the same 64KB ceiling that importing one by URL already enforced. And pointing the importer at a repository web page instead of the raw manifest file now says exactly that, rather than showing a raw parser error. (`/marketplace`) `[fix, improvement]`+## 2026-08-14- **Agent Interaction Lab** (`/demos/agents`): Fourteen prototypes exploring how a 3D agent physically inhabits a web page: real gravity, page elements as the playground, and the agent reacting to scroll, clicks, and the cursor.@@ -621,7 +633,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Docs · The trading hub** (`/docs/trading-hub`): The front door to the autonomous trading system: live fleet vitals read off the running bots, the strategy arena and experiments board, and the smart-money radar, with the twenty pages behind them organised into one path.- **Docs · Trading swarms** (`/docs/swarms`): How a group of agents pools real SOL into one on-chain Solana treasury and trades it by weighted consensus: reputation-weighted voting, spend-guarded contribute and exit transfers, the shared kill switch, and why no balance is virtual.- **Docs · Tutorial: earn and spend in /play** (`/docs/tutorials/earn-and-spend-in-play`): Run the full economic loop in the open world: gather materials, sell them to the vendor, buy a better tool, bank what you cannot afford to lose, and spin the wheel. Explains why cooking triples fish value and why the bank is the only real decision.-- **Docs · Write a repository guard** (`/docs/tutorials/write-a-guard`): Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json, wire it into a stage, and cover it with a test that includes the false positive it must never report.+- **Docs · Write a repository guard** (`/docs/tutorials/write-a-guard`): Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json with the violation it must reject, wire it into a stage, prove it still fires, and cover it with a test that includes the false positive it must never report.- **Docs World (immersive 3D docs)** (`/docs/world`): The full three.ws documentation as a walkable 3D world: every docs section is a glowing pavilion, and the live pages render inside the scene.- **Docs: Avatar CLI** (`/docs/avatar-cli`): Command reference for @three-ws/avatar-cli: init, validate, hash, and preview, with every flag, exit code, and JSON shape, plus the two checks that gate a release on your avatar manifest.- **Examples** (`/examples`): Runnable three.ws examples: copy-paste snippets that execute on the page against the production CDN bundle, plus every example that ships in the repository, generated by scanning it. Each one lists the files it contains and the command that runs it.@@ -643,7 +655,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Tutorial · Render Avatars as Images** (`/tutorials/render-avatar-images`): Put a live 3D avatar in an image tag: four camera framings, 28 poses, ARKit facial morphs, social cards, turntables, and a CORS-open GLB proxy. No 3D engine anywhere in your stack.- **Tutorial · Sell a Skill With a Free Trial That Converts** (`/tutorials/sell-a-skill-with-a-trial`): List an agent skill for sale in $THREE, give buyers a metered free trial, and watch it expire into a real on-chain purchase. Covers choosing a trial length and the missing decrement that quietly makes a trialled skill impossible to sell.- **Tutorial · Ship an avatar manifest** (`/tutorials/ship-an-avatar-manifest`): Turn a raw GLB into a signed-off, hash-anchored manifest: one document that names the avatar, records the exact bytes of its mesh, declares its skeleton, and fails your build if the model ever silently changes.-- **Tutorial · Write a repository guard** (`/tutorials/write-a-guard`): This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when an API handler forgets its error boundary, wire it into the gate, cover it with tests, and register it.+- **Tutorial · Write a repository guard** (`/tutorials/write-a-guard`): This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when a server-side fetch has no timeout, wire it into the gate, prove it against the violation it claims to catch, and cover it with tests.- **Tutorial: build a 3D asset pipeline** (`/tutorials/build-a-3d-asset-pipeline`): Four stages from one prompt to a CI gate: generate a model on the command line, fan a prompt list out in parallel with a manifest and a gallery, refuse to ship anything over its triangle or size budget, then hand the whole pipeline to an AI assistant as an MCP tool. Standard library only, no API key.- **Tutorial: Make Your Avatar Sign (ASL)** (`/tutorials/sign-with-your-avatar`): Step-by-step tutorial for signing avatars: type a phrase and watch it signed in ASL, share it as a link, export a spelled word as an animated GLB, turn on signed chat replies, and fingerspell back with your webcam.- **Your master wallet** (`/wallet`): One custodial wallet for your account, separate from your agents'. Hold SOL and USDC across Solana and Base, top up any agent you own, send to any Solana address, and read every transaction straight from chain.diff --git a/STRUCTURE.md b/STRUCTURE.mdindex 2df6635da..cc9c98db4 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -55,7 +55,7 @@ bottom.| Crypto Data API docs / landing | [pages/crypto.html](pages/crypto.html) `→ /crypto` | In-repo · docs surface | Screenshot-worthy public docs + funnel-top for the free, keyless Crypto Data API (`/api/crypto/*`: token snapshot, security, holders, launches, bonding, whales, symbol, wallet, trending, portfolio, airdrops). Renders hero, endpoint table, tabbed quickstart (curl/JS/Python), per-endpoint request/response reference and a live "Try it" console. Probes production at runtime and marks each endpoint Live vs Coming soon (degrades gracefully while sibling endpoints roll out). CTAs funnel to paid uniques: [/launcher](pages/launcher.html), [/vanity-wallet](public/vanity-wallet.html), [/forge](pages/forge.html). Spec: x402-overhaul campaign (retired 2026-07-28; readable in git history) || Free Crypto Data API + discovery | [api/crypto/index.js](api/crypto/index.js) `→ /api/crypto`, [api/crypto/openapi.js](api/crypto/openapi.js) `→ /api/crypto/openapi.json`, docs [docs/crypto-api.md](docs/crypto-api.md) `→ /docs/crypto-api` | Live · docs surface | Front door + OpenAPI 3.1 for the free, keyless Crypto Data API. Catalog assembler [api/_lib/crypto-catalog/index.js](api/_lib/crypto-catalog/index.js) merges `api/_lib/crypto-catalog/*.js` self-describing descriptors (currently `airdrops`, `bonding`, `holders`, `launches`, `portfolio`, `security`, `symbol`, `token`, `trending`, `wallet`, `whales`) via a static import barrel (the production source of truth, since Vercel's bundler only ships what static imports reach) plus an additive dev-time directory glob; skips malformed/throwing entries, never throws, valid-empty when zero. New descriptor = drop the file AND add its import line to the barrel. OpenAPI built from the same catalog via [api/_lib/crypto-catalog/openapi.js](api/_lib/crypto-catalog/openapi.js). Index does HTML/JSON content negotiation. Endpoint handlers live in `api/crypto/*.js`. Spec: x402-overhaul campaign (retired 2026-07-28; readable in git history) || Unified Crypto API aggregator — storefront + OpenAPI | Registry [api/v1/_providers.js](api/v1/_providers.js) (`providerCatalog()`), front door [api/v1/x/[...slug].js](api/v1/x/%5B...slug%5D.js) `→ /api/v1/x/<provider>/<endpoint>`, discovery `→ GET /api/v1/x`, storefront [pages/crypto-api.html](pages/crypto-api.html) `→ /crypto-api`, OpenAPI 3.1 [api/openapi-json.js](api/openapi-json.js) `→ /openapi.json`, docs § in [docs/api-reference.md](docs/api-reference.md#unified-api--apiv1x-aggregator), dir guide [api/v1/README.md](api/v1/README.md) | Live | Third-party crypto/DeFi/on-chain APIs (CoinGecko, DefiLlama × 2, Jupiter, DexScreener, Solana RPC, OpenAI-compatible) re-offered as one bill: free per-IP tier → BYOK pass-through → three.ws plan → x402 pay-per-call, in that order. Everything (OpenAPI paths, the `/crypto-api` live table, the docs quota table) renders from `providerCatalog()` at request/page-load time — no hand-enumeration, so a new provider descriptor shows up everywhere with zero page edits. Test: [tests/openapi-aggregator.test.js](tests/openapi-aggregator.test.js). Not to be confused with the separate `/api/crypto/*` bundle below (different campaign, different registry). Spec: x402-catalog campaign (retired 2026-07-28; readable in git history) |-| Free 3D API + docs | [api/3d/index.js](api/3d/index.js) `→ /api/3d`, [api/3d/openapi.js](api/3d/openapi.js) `→ /api/3d/openapi.json`, docs [public/3d.html](public/3d.html) `→ /3d` (alias `/docs/3d-api`) | Live · docs surface | Front door + OpenAPI 3.1 for the free, keyless 3D API. Catalog assembler [api/_lib/3d-catalog/index.js](api/_lib/3d-catalog/index.js) merges `api/_lib/3d-catalog/*.js` descriptors (currently `generate`, `inspect`) via a static import barrel (production source of truth) plus an additive dev-time directory glob; new descriptor = drop the file AND add its barrel import line; skips malformed, never throws; OpenAPI built from the same catalog via [api/_lib/3d-catalog/openapi.js](api/_lib/3d-catalog/openapi.js). Index does HTML/JSON content negotiation and advertises the paid ladder (Forge Pro, Rigged Avatars). Docs page: hero, live endpoint table, runnable quickstart with a live "Run inspect" console, embedded `<model-viewer>` GLB preview, and the free→paid ladder. Free endpoints: [api/3d/generate.js](api/3d/generate.js) (prompt 12), [api/3d/inspect.js](api/3d/inspect.js) (prompt 13). GPT Store Actions surface: [api/3d/studio.js](api/3d/studio.js) `→ /api/3d/studio` — a store-compliant twin of `generate` that strips the x402/upgrade block, drops internal ids, and runs the [api/_mcp-studio/safety.js](api/_mcp-studio/safety.js) age-13+ content gate before any GPU work; backs the "three.ws 3D Studio" custom GPT ([prompts/store-submissions/_generated/openai-actions.yaml](prompts/store-submissions/_generated/openai-actions.yaml) + [openai-gpt-config.md](prompts/store-submissions/_generated/openai-gpt-config.md), store-submission prompt 12). Spec: x402-overhaul campaign (retired 2026-07-28; readable in git history) |+| Free 3D API + docs | [api/3d/index.js](api/3d/index.js) `→ /api/3d`, [api/3d/openapi.js](api/3d/openapi.js) `→ /api/3d/openapi.json`, landing page [public/3d.html](public/3d.html) `→ /3d`, reference doc [docs/3d-api.md](docs/3d-api.md) `→ /docs/3d-api` | Live · docs surface | Front door + OpenAPI 3.1 for the free, keyless 3D API. Catalog assembler [api/_lib/3d-catalog/index.js](api/_lib/3d-catalog/index.js) merges `api/_lib/3d-catalog/*.js` descriptors (currently `generate`, `inspect`) via a static import barrel (production source of truth) plus an additive dev-time directory glob; new descriptor = drop the file AND add its barrel import line; skips malformed, never throws; OpenAPI built from the same catalog via [api/_lib/3d-catalog/openapi.js](api/_lib/3d-catalog/openapi.js). Index does HTML/JSON content negotiation and advertises the paid ladder (Forge Pro, Rigged Avatars). Docs page: hero, live endpoint table, runnable quickstart with a live "Run inspect" console, embedded `<model-viewer>` GLB preview, and the free→paid ladder. Free endpoints: [api/3d/generate.js](api/3d/generate.js) (prompt 12), [api/3d/inspect.js](api/3d/inspect.js) (prompt 13). GPT Store Actions surface: [api/3d/studio.js](api/3d/studio.js) `→ /api/3d/studio` — a store-compliant twin of `generate` that strips the x402/upgrade block, drops internal ids, and runs the [api/_mcp-studio/safety.js](api/_mcp-studio/safety.js) age-13+ content gate before any GPU work; backs the "three.ws 3D Studio" custom GPT ([prompts/store-submissions/_generated/openai-actions.yaml](prompts/store-submissions/_generated/openai-actions.yaml) + [openai-gpt-config.md](prompts/store-submissions/_generated/openai-gpt-config.md), store-submission prompt 12). Spec: x402-overhaul campaign (retired 2026-07-28; readable in git history) || Paid Market Data API (x402, 17 endpoints) | Registry [api/_lib/market-data/registry.js](api/_lib/market-data/registry.js), fetchers [api/_lib/market-data/fetch.js](api/_lib/market-data/fetch.js), factory [api/_lib/market-data/endpoint.js](api/_lib/market-data/endpoint.js), routes `api/x402/market-*.js` `→ /api/x402/market-<category>`, free index [api/x402/market.js](api/x402/market.js) `→ /api/x402/market`, catalog projection [api/_lib/service-catalog/services/market-data.js](api/_lib/service-catalog/services/market-data.js), docs [docs/market-data-api.md](docs/market-data-api.md) `→ /docs/market-data-api` | Live | Every free /markets feed (coins, coin profile, price history, categories, exchanges, derivatives, global+Fear&Greed, ETH gas, trending, DeFi TVL, chains, ~15k yield pools, stablecoins, fees/revenue, DEX volumes, hacks) wrapped as pay-per-call x402 endpoints at $0.001 USDC (Solana/Base), plus the $0.005 one-call `market-pulse` bundle. One registry drives the live 402s, the discovery-doc listings, and the free index — zero drift by construction; the fetchers delegate to the SAME exported builders the free pages use (`api/coin/*`, `api/defi/*`), so paid data always matches the site. Params rejected pre-settle (422) and upstream outages (503) never charge the buyer. Tests: [tests/market-data-api.test.js](tests/market-data-api.test.js). || Datapoint fabric (x402, 480k+ endpoints) | Registry [api/_lib/market-data/datapoints.js](api/_lib/market-data/datapoints.js), dynamic route [api/x402/d/[...path].js](api/x402/d/%5B...path%5D.js) `→ /api/x402/d/<family>/<id>/<metric>`, free catalog [api/x402/d/index.js](api/x402/d/index.js) `→ /api/x402/d`, discovery slice `buildDatapointItems` in [api/wk.js](api/wk.js), docs § in [docs/market-data-api.md](docs/market-data-api.md#the-datapoint-fabric--480000-standalone-endpoints) | Live | Every individual market datapoint as its OWN standalone paid endpoint — one URL = one value = one $0.0005 USDC x402 micro-payment (override `X402_PRICE_DATAPOINT_<FAMILY>`). 9 families × 68 metrics × live id spaces ≈ 484k addressable endpoints (~17.5k coins × 20, ~15.5k pools × 7, ~6k protocols × 6, chains, stablecoins, exchanges, global/gas/fear-greed) served by ONE dynamic route reading the registry; ids are runtime values, nothing hardcodes a third-party asset. Path that cannot exist → 404/422 with NO 402 issued; unknown id/outage rejects pre-settle. Free catalog enumerates families, metrics, prices, and pages each family's full live id space (200/page) so crawlers can walk the universe; the .well-known discovery doc carries a curated runtime-derived slice (~83 concrete resources). Tests: [tests/market-datapoints.test.js](tests/market-datapoints.test.js). || Fits: the public cosmetics economy | [pages/fits.html](pages/fits.html) `→ /fits`, page module [src/fits.js](src/fits.js) + pure helpers [src/fits-lib.js](src/fits-lib.js), backends [api/cosmetics/leaderboard.js](api/cosmetics/leaderboard.js) + [api/cosmetics/earnings.js](api/cosmetics/earnings.js), engine [api/_lib/cosmetics-economy.js](api/_lib/cosmetics-economy.js) | Live | The settled-sale cosmetics ledger, promoted out of a panel inside `/play` into a public surface. Rarest premium fits ranked by how few wallets own them (owner count first, rarity as the tie-break, so a legendary never sorts under an equally-scarce rare), top collectors by rarity-weighted flex score, top creators by **actually settled** USDC, and a live sales drip; each fit deep-links to its coin world at `/play?coin=<mint>`. Plus a creator-earnings lookup any wallet can run without an account (lifetime + 30-day, paid vs pending, per-cosmetic and per-coin-world breakdowns), reachable in one click from each creator row rather than by copy-pasting an address. Coin mints are runtime ledger values, never hardcoded. Headline numbers are derived from the same rows rendered beneath them, so they cannot disagree; the volume tile is labelled as the returned sales window, not as an all-time total. Sub-cent sales keep their precision instead of collapsing to $0.00. Tests: [tests/fits-lib.test.js](tests/fits-lib.test.js) |diff --git a/api/_lib/agent-economy.js b/api/_lib/agent-economy.jsindex 963178918..48fa7a807 100644--- a/api/_lib/agent-economy.js+++ b/api/_lib/agent-economy.js@@ -459,11 +459,15 @@ export async function platformEconomyStats({ORDER BY 1 ASC`;+ // Both leaderboards compute `linkable` in SQL for the same reason the+ // settled-hire feed below does: a deleted agent leaves no `agent_identities`+ // row at all, so its `is_public` reads NULL, and treating NULL as "public"+ // handed every deleted earner a leaderboard link to a hollow /agent/<id>.const providerRows = await sql`SELECTh.provider_agent_id AS agent_id,COALESCE(ai.name, 'Agent') AS name,- ai.is_public AS is_public,+ (ai.id IS NOT NULL AND ai.is_public IS NOT FALSE) AS linkable,av.thumbnail_key AS thumb_key,av.visibility AS avatar_vis,COALESCE(SUM(h.usd), 0) AS earned_usd,@@ -475,7 +479,7 @@ export async function platformEconomyStats({WHERE h.status = 'completed'AND h.provider_agent_id IS NOT NULLAND h.completed_at > now() - (${win} || ' days')::interval- GROUP BY h.provider_agent_id, ai.name, ai.is_public, av.thumbnail_key, av.visibility+ GROUP BY h.provider_agent_id, ai.id, ai.name, ai.is_public, av.thumbnail_key, av.visibilityORDER BY earned_usd DESCLIMIT ${top}`;@@ -484,7 +488,7 @@ export async function platformEconomyStats({SELECTh.hirer_agent_id AS agent_id,COALESCE(ai.name, 'Agent') AS name,- ai.is_public AS is_public,+ (ai.id IS NOT NULL AND ai.is_public IS NOT FALSE) AS linkable,av.thumbnail_key AS thumb_key,av.visibility AS avatar_vis,COALESCE(SUM(h.usd), 0) AS spent_usd,@@ -494,7 +498,7 @@ export async function platformEconomyStats({LEFT JOIN avatars av ON av.id = ai.avatar_id AND av.deleted_at IS NULLWHERE h.status = 'completed'AND h.completed_at > now() - (${win} || ' days')::interval- GROUP BY h.hirer_agent_id, ai.name, ai.is_public, av.thumbnail_key, av.visibility+ GROUP BY h.hirer_agent_id, ai.id, ai.name, ai.is_public, av.thumbnail_key, av.visibilityORDER BY spent_usd DESCLIMIT ${top}`;@@ -540,7 +544,7 @@ export async function platformEconomyStats({top_providers: providerRows.map((r) => ({agent_id: r.agent_id,name: r.name || 'Agent',- url: r.is_public !== false ? `/agent/${r.agent_id}` : null,+ url: r.linkable && r.agent_id ? `/agent/${r.agent_id}` : null,avatar_thumbnail_url: avatarThumb(r.thumb_key, r.avatar_vis),earned_usd: Number(r.earned_usd || 0),hires: Number(r.hires || 0),@@ -549,7 +553,7 @@ export async function platformEconomyStats({top_hirers: hirerRows.map((r) => ({agent_id: r.agent_id,name: r.name || 'Agent',- url: r.is_public !== false ? `/agent/${r.agent_id}` : null,+ url: r.linkable && r.agent_id ? `/agent/${r.agent_id}` : null,avatar_thumbnail_url: avatarThumb(r.thumb_key, r.avatar_vis),spent_usd: Number(r.spent_usd || 0),hires: Number(r.hires || 0),diff --git a/api/_lib/gcp-billing.js b/api/_lib/gcp-billing.jsindex 0bf237753..944f4c461 100644--- a/api/_lib/gcp-billing.js+++ b/api/_lib/gcp-billing.js@@ -54,6 +54,21 @@ export class BillingUnavailableError extends Error {}}+// The export exists in config but not in BigQuery: the dataset is there and the+// table name resolves, yet the billing account was never pointed at it. This is+// a NOT-WIRED state awaiting a one-time owner console action (Billing → Billing+// export → BigQuery export), not a runtime fault, and callers must be able to+// tell the two apart: reported as a failure it pages ops every single day about+// a step no amount of retrying can complete. Subclasses BillingUnavailableError+// so every existing `instanceof` catch keeps working unchanged.+export class BillingExportMissingError extends BillingUnavailableError {+ constructor(message, cause) {+ super(message, cause);+ this.name = 'BillingExportMissingError';+ this.code = 'billing_export_missing';+ }+}+function readEnv(name) {return (typeof process !== 'undefined' && process.env?.[name]) || null;}@@ -76,7 +91,7 @@ export function resolveBillingConfig(env = process.env) {}if (!project || !dataset || !table) {throw new BillingUnavailableError(- 'BigQuery billing export not configured. Set GOOGLE_CLOUD_PROJECT, GCP_BILLING_DATASET, and GCP_BILLING_TABLE (or GCP_BILLING_ACCOUNT_ID). See docs/gcp-credits.md.',+ 'BigQuery billing export not configured. Set GOOGLE_CLOUD_PROJECT, GCP_BILLING_DATASET, and GCP_BILLING_TABLE (or GCP_BILLING_ACCOUNT_ID). See docs/ops/gcp-credits.md.',);}@@ -149,7 +164,7 @@ export async function queryBilling(query, { project, tokenFn = getGcpAccessTokenconst msg = data?.error?.message || `BigQuery returned ${res.status}`;// A missing dataset/table is the "not wired yet" case, not a hard fault.if (res.status === 404 || /Not found|does not exist/i.test(msg)) {- throw new BillingUnavailableError(`Billing export table not found: ${msg}`);+ throw new BillingExportMissingError(`Billing export table not found: ${msg}`);}throw new BillingUnavailableError(`BigQuery query failed: ${msg}`);}diff --git a/api/_lib/ledger-anchor.js b/api/_lib/ledger-anchor.jsindex 0c0e208ec..e41b84691 100644--- a/api/_lib/ledger-anchor.js+++ b/api/_lib/ledger-anchor.js@@ -47,7 +47,12 @@ function withTimeout(promise, ms) {* @param {number} p.throughSeq seq of the head entry* @param {number} p.entryCount total entries committed* @param {number} [p.now]- * @returns {Promise<{status:'anchored'|'deduped'|'pending', signature:string|null, detail?:string}>}+ * @returns {Promise<{status:'anchored'|'deduped'|'pending'|'failed', signature:string|null, detail?:string}>}+ *+ * `pending` means the commitment was recorded locally because no attester key is+ * configured (a documented degraded mode). `failed` means the broadcast itself+ * was rejected, which is a real outage of the on-chain leg: same value in the+ * `ledger_anchors` row, so the caller can tell the two apart and alert on one.*/export async function anchorLedgerHead({ agentId, network = 'mainnet', headHash, throughSeq, entryCount, now = Date.now() }) {if (!agentId || !headHash) throw new Error('anchorLedgerHead: agentId and headHash required');@@ -98,7 +103,12 @@ export async function anchorLedgerHead({ agentId, network = 'mainnet', headHash,);} catch (err) {await upsertAnchor({ agentId, network, throughSeq, headHash, entryCount, status: 'failed', detail: `record_failed: ${err.message}`.slice(0, 280), signature: null });- return { status: 'pending', signature: null, detail: `record_failed: ${err.message}` };+ // Report the broadcast failure as `failed`, matching the row just written.+ // It used to come back as `pending`, which made an unfunded attester wallet+ // (every send rejected with "found no record of a prior credit") read as the+ // benign no-key-configured path: the cron logged a healthy 200 for months+ // while not one head ever reached the chain.+ return { status: 'failed', signature: null, detail: `record_failed: ${err.message}` };}await upsertAnchor({ agentId, network, throughSeq, headHash, entryCount, status: 'anchored', detail: null, signature });diff --git a/api/_lib/oracle/store.js b/api/_lib/oracle/store.jsindex 2a73040de..c0e50a9bf 100644--- a/api/_lib/oracle/store.js+++ b/api/_lib/oracle/store.js@@ -417,7 +417,7 @@ export async function readScoreHistory(mint, network = 'mainnet', hours = 72) {`.catch((err) => {// The sparkline reads an empty series as "this coin has no recorded// conviction movement", which is what the caller sees during a- // connectivity failure too — cached for 60s by /api/oracle/history.+ // connectivity failure too, cached for 60s by /api/oracle/history.// Propagate so wrap() answers 503; a statement fault still degrades.if (isDbUnavailableError(err)) throw err;return [];diff --git a/api/_lib/rate-limit.js b/api/_lib/rate-limit.jsindex fc5de58ab..a502a0bf3 100644--- a/api/_lib/rate-limit.js+++ b/api/_lib/rate-limit.js@@ -1456,9 +1456,15 @@ export const limits = {// Critical (real per-call cost) — fail closed in prod without Redis.voiceClone: (userId) =>getLimiter('voice:clone', { limit: 3, window: '1 d', critical: true }).limit(userId),- // Persona extraction: Claude API call — 5 per user per day.+ // Persona extraction (POST /api/persona/extract): a metered completion on the+ // shared LLM chain, 5 per user per day. Critical for the same reason its+ // sibling personaPreviewUser is: a non-critical bucket degrades to a+ // PER-INSTANCE memory counter, so on a Redis outage the daily budget is+ // silently multiplied by the live Cloud Run instance count and a free-signup+ // loop can spend past it. This is the tighter of the two persona budgets, so+ // it fails closed rather than open.personaExtract: (userId) =>- getLimiter('persona:extract', { limit: 5, window: '1 d' }).limit(userId),+ getLimiter('persona:extract', { limit: 5, window: '1 d', critical: true }).limit(userId),// Onboarding interview (POST /api/persona/interview) in the create-agent// wizard. Same try-first shape as agentSuggest: signed-in callers get room to// re-run the interview while they tune their answers, signed-out callers get adiff --git a/api/agenc/[action].js b/api/agenc/[action].jsindex 92618f17a..27236cdd4 100644--- a/api/agenc/[action].js+++ b/api/agenc/[action].js@@ -12,6 +12,11 @@// /api/agenc/get-task?creator=<base58>&taskId=<hex|label>&cluster=devnet// Single task status + (optionally) lifecycle timeline.//+// /api/agenc/recent-tasks?cluster=devnet[&limit=6]+// The newest task PDAs three.ws itself wrote on-chain through the Agora+// rail, read from the platform's own journal (no RPC round trip), so a+// client with no address in hand has something real to watch.+//// /api/agenc/get-agent?agentPda=<base58>&cluster=devnet// /api/agenc/get-agent?agentId=<hex|label>&cluster=devnet// Agent registration state.@@ -23,10 +28,14 @@// Computes the canonical three.ws → AgenC agentId via the identity// bridge and checks whether that PDA is already registered on-chain.//-// Cluster defaults to `mainnet`. Set `?cluster=devnet` for devnet program-// 6UcJzbTEemBz3aY5wK5qKHGMD7bdRsmR4smND29gB2ab. Reads rotate across the-// platform's canonical Solana RPC chain (see withAgenC below); `AGENC_RPC_URL`-// pins a preferred endpoint at the head of that chain.+// Cluster defaults to `mainnet`; set `?cluster=devnet` for the devnet+// deployment. Every response carries the `programId` the read actually ran+// against, because `createAgenCClient` derives it from the bundled IDL rather+// than from a constant: quoting a program address from anywhere else (docs, UI+// copy, an older SDK export) is how a page ends up naming a program no read of+// ours has touched in months. Reads rotate across the platform's canonical+// Solana RPC chain (see withAgenC below); `AGENC_RPC_URL` pins a preferred+// endpoint at the head of that chain.import { PublicKey } from '@solana/web3.js';import { createHash } from 'node:crypto';@@ -106,6 +115,30 @@ export function taskStateLabel(state) {return String(state);}+// A base58 address a visitor can legitimately paste but that is not an AgenC+// account of the expected type fails INSIDE the Anchor decoder ("Invalid account+// discriminator", "Account does not exist"), not by returning null. That error is+// deterministic, so `rotateRpc` correctly re-throws it on the first endpoint, and+// the wrapper then answered an opaque 500 for what is really "no such task on+// this cluster": the single most likely thing a visitor gets wrong, reported as+// though the platform were broken. Classify it and reuse the handler's own 404.+function isWrongAccount(err) {+ return /invalid account discriminator|account does not exist|could not find account|failed to deserialize/i.test(+ String(err?.message || err),+ );+}++// Read an AgenC account, turning "that address holds no such account" into null+// so callers render the honest 404 instead of a server error.+async function readAccount(read) {+ try {+ return await read();+ } catch (err) {+ if (isWrongAccount(err)) return null;+ throw err;+ }+}+function agentStatusLabel(status) {const map = { 0: 'Inactive', 1: 'Active', 2: 'Busy', 3: 'Suspended' };if (typeof status === 'number') return map[status] ?? `Unknown(${status})`;@@ -265,6 +298,58 @@ async function handleListTasks(req, res) {}));}+// Task discovery without an address in hand. `list-tasks` can only answer once+// the caller already knows a creator wallet, which leaves every first-time+// visitor of /agenc/embodied staring at an input box with nothing to put in it+// and no way to find one: the surface renders live on-chain state and offered no+// path to any. The platform does know real task PDAs, because every task the+// Agora rail posts, claims, and completes is journalled with the PDA it wrote.+// So this reads our own ledger (one DB round trip, no getProgramAccounts scan)+// and hands back the newest PDAs for the requested cluster. It is a pointer+// list, not a source of truth: whatever the caller then acts on is verified+// against the chain by `get-task`.+async function handleRecentTasks(req, res) {+ const cluster = pickCluster(req);+ const requested = parseInt(String(req.query?.limit ?? '6'), 10);+ const limit = Math.min(Math.max(Number.isFinite(requested) ? requested : 6, 1), 25);++ let rows;+ try {+ rows = await sql`+ select a.task_pda,+ max(a.created_at) as last_activity_at,+ max(a.reward_label) as reward_label,+ array_agg(distinct a.kind) as kinds+ from agora_activity a+ join agora_citizens c on c.id = a.citizen_id+ where a.task_pda is not null+ and c.agenc_cluster = ${cluster}+ group by a.task_pda+ order by last_activity_at desc+ limit ${limit}`;+ } catch (err) {+ // The journal is a convenience index over work the chain already holds, so+ // a DB blip degrades discovery rather than failing the request: the caller+ // still has the manual taskPda path, and `degraded` tells it to say so.+ console.warn('[agenc] recent-tasks journal unavailable:', err?.message);+ return json(res, 200, { ok: true, cluster, count: 0, degraded: true, tasks: [], fetchedAt: new Date().toISOString() });+ }++ return json(res, 200, {+ ok: true,+ cluster,+ count: rows.length,+ degraded: false,+ tasks: rows.map((r) => ({+ taskPda: r.task_pda,+ lastActivityAt: r.last_activity_at instanceof Date ? r.last_activity_at.toISOString() : r.last_activity_at,+ rewardLabel: r.reward_label ?? null,+ kinds: Array.isArray(r.kinds) ? r.kinds : [],+ })),+ fetchedAt: new Date().toISOString(),+ });+}+async function handleGetTask(req, res) {const q = req.query || {};// Resolve the caller's identifiers BEFORE touching the chain: a malformed pubkey@@ -288,9 +373,9 @@ async function handleGetTask(req, res) {const wantLifecycle = q.lifecycle === '1' || q.lifecycle === 'true';const { client, pda, task, lifecycle } = await withAgenC(pickCluster(req), async (c) => {const taskPda = explicitPda || deriveTaskPda(creator, taskIdSeed, c.programId);- const found = await getTask(c.program, taskPda);+ const found = await readAccount(() => getTask(c.program, taskPda));if (!found || !wantLifecycle) return { client: c, pda: taskPda, task: found, lifecycle: null };- const s = await getTaskLifecycleSummary(c.program, taskPda);+ const s = await readAccount(() => getTaskLifecycleSummary(c.program, taskPda));if (!s) return { client: c, pda: taskPda, task: found, lifecycle: null };return {client: c,@@ -434,7 +519,7 @@ async function handleGetAgent(req, res) {}const { client, pda, agent } = await withAgenC(pickCluster(req), async (c) => {const agentPda = explicitPda || deriveAgentPda(agentIdSeed, c.programId);- return { client: c, pda: agentPda, agent: await getAgent(c.program, agentPda) };+ return { client: c, pda: agentPda, agent: await readAccount(() => getAgent(c.program, agentPda)) };});if (!agent) {return json(res, 404, {@@ -491,7 +576,7 @@ async function handleLink(req, res) {const cl = cluster === 'devnet' ? 'devnet' : 'mainnet';const { client, pda, agent } = await withAgenC(cl, async (c) => {const agentPda = deriveAgentPda(canonical.agenCAgentId, c.programId);- return { client: c, pda: agentPda, agent: await getAgent(c.program, agentPda) };+ return { client: c, pda: agentPda, agent: await readAccount(() => getAgent(c.program, agentPda)) };});const metadataUri = buildThreewsMetadataUri(@@ -607,6 +692,7 @@ async function handleX402Services(req, res) {const HANDLERS = {'list-tasks': { methods: ['GET'], fn: handleListTasks },+ 'recent-tasks': { methods: ['GET'], fn: handleRecentTasks },'get-task': { methods: ['GET'], fn: handleGetTask },'get-agent': { methods: ['GET'], fn: handleGetAgent },'x402-services': { methods: ['GET'], fn: handleX402Services },diff --git a/api/agent-economy/transact.js b/api/agent-economy/transact.jsindex f2e776670..69865ca35 100644--- a/api/agent-economy/transact.js+++ b/api/agent-economy/transact.js@@ -80,7 +80,10 @@ const FEE_BUFFER_LAMPORTS = 15_000;const bodySchema = z.object({service: z.string().min(1).max(64),- topic: z.string().max(120).optional(),+ // Nullable as well as optional: "no topic" reaches this endpoint as an+ // explicit null from every JSON client that serializes an empty field, and+ // rejecting that turned the plainest possible request into a 400.+ topic: z.string().max(120).nullish(),});export default wrap(async (req, res) => {diff --git a/api/agents/[id]/memory-seed-github.js b/api/agents/[id]/memory-seed-github.jsindex 3a3e92126..71afe1abf 100644--- a/api/agents/[id]/memory-seed-github.js+++ b/api/agents/[id]/memory-seed-github.js@@ -11,6 +11,7 @@import { sql } from '../../_lib/db.js';import { getSessionUser, authenticateBearer, extractBearer } from '../../_lib/auth.js';+import { requireCsrf } from '../../_lib/csrf.js';import { cors, json, method, readJson, wrap, error, rateLimited } from '../../_lib/http.js';import { limits } from '../../_lib/rate-limit.js';import { llmComplete } from '../../_lib/llm.js';@@ -115,11 +116,12 @@ async function handleGet(req, res, agentId) {async function handlePost(req, res, agentId) {const userId = await requireOwnedAgent(req, agentId);-- // The seed budget is consumed only after ownership is proven, so a signed-in- // stranger cannot burn another agent's window by guessing its id.- const rl = await limits.githubSeed(agentId);- if (!rl.success) return rateLimited(res, rl, 'this agent can only be re-seeded every 6 hours');+ // Session-cookie POSTs rewrite this agent's seeded memories, so a cross-site+ // form post must not be able to drive one. Bearer callers are exempt inside+ // requireCsrf. Every sibling memory mutator (memory-seed-x, -farcaster, the+ // preset memory-seed, agent-memory) gates the same way; this route was the+ // one that did not.+ if (!(await requireCsrf(req, res, userId))) return;const conn = await githubConnection(userId);if (!conn) {@@ -151,6 +153,19 @@ async function handlePost(req, res, agentId) {);}+ // The budget is consumed here, once the selection is known good and just+ // before the parts that actually cost something: the README reads, the LLM+ // pass, and the rewrite of this agent's memories. Charging it earlier meant a+ // user who ticked nothing, or whose catalog had gone stale since it loaded,+ // spent their whole 6-hour window on a 400 and could not correct the mistake+ // until it expired. Ownership is already proven above, so a signed-in+ // stranger still cannot burn another agent's window by guessing its id, and+ // the reads that precede this point are the same ones GET already serves+ // unbudgeted. Farcaster keeps its signing challenge outside the budget for+ // the same reason.+ const rl = await limits.githubSeed(agentId);+ if (!rl.success) return rateLimited(res, rl, 'this agent can only be re-seeded every 6 hours');+const readmes = new Map();for (const key of resolved.readmeKeys) {const markdown = await fetchReadme(token, key);@@ -158,11 +173,33 @@ async function handlePost(req, res, agentId) {}const document = buildSeedDocument(resolved, readmes);- const { text: raw } = await llmComplete({- maxTokens: 1500,- system: SEED_SYSTEM_PROMPT,- user: `Extract up to ${MAX_FACTS} memory facts from this GitHub material:\n\n${document}`,- });+ // llmComplete walks the whole provider chain before it gives up, so a throw+ // here means every lane was busy or down at once, not a bug in this route.+ // Left uncaught it reached the client as a bare "internal error, quote ref …"+ // and paged ops as an unhandled 5xx on what is a routine upstream throttle.+ // The budget above is already spent by this point and this abstraction has no+ // refund, so the reply says plainly when the next attempt is allowed instead+ // of inviting a retry that would only earn a 429.+ let raw;+ try {+ ({ text: raw } = await llmComplete({+ maxTokens: 1500,+ system: SEED_SYSTEM_PROMPT,+ user: `Extract up to ${MAX_FACTS} memory facts from this GitHub material:\n\n${document}`,+ }));+ } catch (err) {+ const retryAt = rl.reset ? new Date(rl.reset).toISOString() : null;+ const minutes = rl.reset ? Math.max(1, Math.ceil((rl.reset - Date.now()) / 60_000)) : null;+ return error(+ res,+ 503,+ 'distill_unavailable',+ `every model provider is busy right now, so nothing was seeded and your memories are unchanged${+ minutes ? `. This agent can be seeded again in about ${minutes} minute${minutes === 1 ? '' : 's'}` : '. Try this agent again later'+ }`,+ { retry_at: retryAt, providers_tried: err?.attempts?.map((a) => a.provider) ?? [] },+ );+ }const facts = parseFacts(raw);const seededAt = new Date().toISOString();const manifest = selectionManifest(resolved);@@ -208,7 +245,8 @@ async function handlePost(req, res, agentId) {// ── DELETE — revoke this agent's seeded memories ─────────────────────────────async function handleDelete(req, res, agentId) {- await requireOwnedAgent(req, agentId);+ const userId = await requireOwnedAgent(req, agentId);+ if (!(await requireCsrf(req, res, userId))) return;const deleted = await sql`DELETE FROM agent_memoriesWHERE agent_id = ${agentId} AND context->>'source' = 'github_seed'diff --git a/api/cron/economy-tick.js b/api/cron/economy-tick.jsindex 5e67412bf..23fc01da7 100644--- a/api/cron/economy-tick.js+++ b/api/cron/economy-tick.js@@ -106,6 +106,28 @@ const TARGETS = [const CALL_TIMEOUT_MS = 60_000;+// Is the fan-out target this process's own deployment, or somebody else's?+//+// APP_ORIGIN falls back to https://three.ws whenever PUBLIC_APP_ORIGIN is unset,+// which is exactly the state of a laptop, a CI box, or an audit session. Booting+// this handler there and calling it with the production CRON_SECRET aims all+// thirty-six money engines at production from a machine that is not production.+// On 2026-08-14T05:16Z one such run put 36 rejected calls into the production log+// in a single minute, indistinguishable at a glance from a secret rotation. A+// process with no K_SERVICE (the variable Cloud Run stamps on every revision) has+// no business driving a remote economy: it reports the skip and moves on. Point+// PUBLIC_APP_ORIGIN at a local server to exercise the fan-out for real.+const LOOPBACK_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]', '::1', '0.0.0.0']);++function targetsRemoteEconomy(origin) {+ if (process.env.K_SERVICE) return false;+ try {+ return !LOOPBACK_HOSTS.has(new URL(origin).hostname);+ } catch {+ return true;+ }+}+// Fire one engine over HTTP with the cron bearer. A non-2xx, a 404 (the deployed// build may lag a newly-added engine), or a timeout is reported per-target and// never throws — one dead engine must not stop the others.@@ -159,6 +181,17 @@ export default wrapCron(async (req, res) => {const origin = ORIGIN();const secret = process.env.CRON_SECRET || env.CRON_SECRET;+ if (targetsRemoteEconomy(origin)) {+ log.warn('economy_tick_skipped_remote_origin', { origin, engines: TARGETS.length });+ return json(res, 200, {+ ok: true,+ skipped: 'not_deployed',+ origin,+ engines: TARGETS.length,+ hint: 'this process is not a Cloud Run revision; set PUBLIC_APP_ORIGIN to a local server to fan out',+ });+ }+const results = await Promise.all(TARGETS.map((t) => fireTarget(origin, secret, t)));const fired = results.filter((r) => r.ok).length;const failed = results.filter((r) => !r.ok).length;diff --git a/api/cron/gcp-burn-report.js b/api/cron/gcp-burn-report.jsindex b23729536..3c3dc8913 100644--- a/api/cron/gcp-burn-report.js+++ b/api/cron/gcp-burn-report.js@@ -14,19 +14,44 @@// still shows the report ran.//// If the billing export isn't wired yet the cron no-ops quietly (one alert/day-// max, deduped) rather than erroring — the alerting scaffold is allowed to exist-// before prompt 01's export lands.+// max, deduped) rather than erroring: the alerting scaffold is allowed to exist+// before the export lands. Two states count as not-wired, and both take that+// quiet path: the env vars are missing, or they resolve to a table BigQuery does+// not have because the billing account was never pointed at the dataset. Only+// the second one is reachable once GCP_BILLING_ACCOUNT_ID is set, since the+// table name is derived from it and always resolves.//// Kept as a concrete file (not [name].js) so the burn module + its fetch/crypto// deps don't share a cold start with the heavy SDK bundles.import { json, method, wrapCron } from '../_lib/http.js';import { sendOpsAlert } from '../_lib/alerts.js';-import { buildBurnReport, billingConfigured, BillingUnavailableError, usd, PROGRAM_LANES } from '../_lib/gcp-billing.js';+import { buildBurnReport, billingConfigured, BillingExportMissingError, BillingUnavailableError, resolveBillingConfig, usd, PROGRAM_LANES } from '../_lib/gcp-billing.js';import { requireCron } from '../_lib/cron-auth.js';const STATUS_EMOJI = { runaway: '🔴', underutilized: '🟡', 'on-track': '🟢', idle: '⚪', unknown: '⚪' };+// Both not-wired states share one title and one dedup signature on purpose: they+// are the same operator situation (no burn data yet, one setup step outstanding),+// so they must not page the channel twice in a day between them.+const NOT_WIRED_TITLE = 'GCP burn report: billing export not wired';++// The one console step that turns the not-wired state into a live report, with+// the exact table the config expects so the operator can confirm the match+// instead of guessing which of the three env vars is at fault.+function missingExportDetail(err) {+ const lines = ['The billing export table does not exist yet in BigQuery.'];+ try {+ const cfg = resolveBillingConfig();+ lines.push(`Expected ${cfg.fqTable}`);+ } catch {+ lines.push(err.message);+ }+ lines.push('Enable it once (console-only, no gcloud or API path): Billing → Billing export → BigQuery export → Edit settings → select the dataset. BigQuery then creates the table and this report goes live on the next run.');+ lines.push('See docs/ops/gcp-credits.md.');+ return lines.join('\n');+}+function formatReport(report) {const { totals, projection: p, burn } = report;const lines = [];@@ -54,17 +79,28 @@ export default wrapCron(async (req, res) => {if (!billingConfigured()) {// Scaffold exists before the export lands — say so once/day, don't error.await sendOpsAlert(- 'GCP burn report — billing export not wired',- 'Set GOOGLE_CLOUD_PROJECT + GCP_BILLING_DATASET + GCP_BILLING_TABLE (prompt 01). See docs/gcp-credits.md.',+ NOT_WIRED_TITLE,+ 'Set GOOGLE_CLOUD_PROJECT + GCP_BILLING_DATASET + GCP_BILLING_TABLE (or GCP_BILLING_ACCOUNT_ID, which derives the table). See docs/ops/gcp-credits.md.',{ signature: 'gcp-burn-unconfigured' },);- return json(res, 200, { ok: true, configured: false });+ return json(res, 200, { ok: true, configured: false, reason: 'env_missing' });}let report;try {report = await buildBurnReport({});} catch (err) {+ // The env resolves to a table BigQuery does not have: the billing account+ // was never pointed at the dataset. That is the same not-wired state as+ // missing env, one console step short of done, so it takes the quiet+ // once-a-day path with the exact step to take. Reported as a failure it+ // paged ops daily for weeks about something no retry can fix, which is how+ // a real BigQuery or auth outage would have gone unnoticed in the noise.+ if (err instanceof BillingExportMissingError) {+ const expected = missingExportDetail(err);+ await sendOpsAlert(NOT_WIRED_TITLE, expected, { signature: 'gcp-burn-unconfigured' });+ return json(res, 200, { ok: true, configured: false, reason: 'export_table_missing' });+ }const msg = err instanceof BillingUnavailableError ? err.message : (err?.message || String(err));await sendOpsAlert('GCP burn report failed', msg, { signature: 'gcp-burn-failed' });return json(res, 200, { ok: false, error: msg });diff --git a/api/cron/reconcile-decisions.js b/api/cron/reconcile-decisions.jsindex 6b7772c8b..47d4ad461 100644--- a/api/cron/reconcile-decisions.js+++ b/api/cron/reconcile-decisions.js@@ -30,7 +30,7 @@ export default wrapCron(async (req, res) => {if (!method(req, res, ['GET', 'POST'])) return;if (!requireCron(req, res)) return;- const report = { reconciled: 0, wins: 0, losses: 0, anchored: 0, anchor_pending: 0, anomalies: 0, errors: 0 };+ const report = { reconciled: 0, wins: 0, losses: 0, anchored: 0, anchor_pending: 0, anchor_failed: 0, anchor_skipped: 0, anomalies: 0, errors: 0 };const touchedAgents = new Set();// 1. Reconcile snipe decisions whose position has settled on-chain.@@ -92,9 +92,16 @@ export default wrapCron(async (req, res) => {report.heads_error = err.message;}+ // A broadcast rejection is never agent-specific: an unfunded or unusable+ // attester wallet fails identically for every head in the run. Stop after the+ // first one instead of re-simulating the same doomed memo for each remaining+ // agent (twelve wasted RPC round-trips and twelve rewritten rows, every ten+ // minutes), report what was skipped, and alert once so the outage is visible.let anchoredCount = 0;+ let anchorOutage = null;for (const h of heads) {if (anchoredCount >= MAX_ANCHOR_AGENTS) break;+ if (anchorOutage) { report.anchor_skipped++; continue; }try {const anchor = await latestAnchoredAnchor(h.agent_id);if (anchor && Number(anchor.through_seq) >= Number(h.head_seq)) continue; // already committed@@ -112,12 +119,25 @@ export default wrapCron(async (req, res) => {entryCount: Number(h.cnt),});if (r.status === 'anchored' || r.status === 'deduped') report.anchored++;- else report.anchor_pending++;+ else if (r.status === 'failed') {+ report.anchor_failed++;+ anchorOutage = r.detail || 'anchor broadcast rejected';+ } else report.anchor_pending++;} catch {report.errors++;}}+ if (anchorOutage) {+ report.anchor_outage = String(anchorOutage).slice(0, 280);+ sendOpsAlert(+ 'Reasoning ledger: on-chain anchoring is down',+ `Ledger head anchoring was rejected on-chain and ${report.anchor_skipped} further agent(s) were skipped this run. ` ++ `Chain hashes stay tamper-evident, but no head is reaching Solana. Reason: ${report.anchor_outage}`,+ { signature: 'ledger-anchor-broadcast-failed' },+ );+ }+// 3. Anomaly watch: a verified track record that suddenly collapses is worth// surfacing — it can mean a broken strategy or market regime change.for (const agentId of touchedAgents) {diff --git a/api/oracle/og.js b/api/oracle/og.jsindex f2569a1d9..609023c91 100644--- a/api/oracle/og.js+++ b/api/oracle/og.js@@ -24,8 +24,8 @@ import { isQuoteMint } from '../_lib/quote-mints.js';const MINT_RE = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;const PUMP_FRONTEND_V3 = 'https://frontend-api-v3.pump.fun';const CACHE = 'public, max-age=120, s-maxage=900, stale-while-revalidate=60';-// A card built from a failed read is still a card — an OG scraper needs an image-// back, not a 500 — but it is not an answer worth keeping for 15 minutes. Serve+// A card built from a failed read is still a card (an OG scraper needs an image+// back, not a 500), but it is not an answer worth keeping for 15 minutes. Serve// the degraded render uncached so the next scrape re-reads a recovered database// instead of pinning "Not yet scored" on a real prime coin for a quarter hour.const CACHE_DEGRADED = 'no-store';diff --git a/api/oracle/social.js b/api/oracle/social.jsindex d7b773e58..fb43b4ae3 100644--- a/api/oracle/social.js+++ b/api/oracle/social.js@@ -16,7 +16,7 @@* An author in KOL_ACCOUNTS below gets a 1.5× virality multiplier vs an* anonymous account.*- * Rate-limited per IP (limits.oracleSocialIp). Auth: optional — unauthenticated+ * Rate-limited per IP (limits.oracleSocialIp). Auth: optional. Unauthenticated* calls are accepted so XActions → Oracle works without session overhead.*/@@ -129,7 +129,7 @@ export default wrap(async (req, res) => {// would serialize the whole request behind DB latency. classified_at is bound// per row; the ON CONFLICT branch still uses now() for the update path.// Not guarded: this write IS the request. A swallowed failure used to answer- // `ok: true` with `mints_updated: 0` next to a populated `updated` array — a+ // `ok: true` with `mints_updated: 0` next to a populated `updated` array: a// self-contradicting receipt that told the sender its batch had landed when// nothing was written. wrap() classifies instead (503 on a connectivity// failure, 500 on a statement fault), so the sender knows to retry.diff --git a/api/oracle/stats.js b/api/oracle/stats.jsindex 49368ca6e..fab4e5308 100644--- a/api/oracle/stats.js+++ b/api/oracle/stats.js@@ -48,7 +48,7 @@ const NETWORKS = new Set(['mainnet', 'devnet']);* fault in one of them still degrades that panel to its empty row, so the rest* of the dashboard paints. A CONNECTIVITY failure hits all five at once and used* to render "0 coins scored, 0 armed agents, no win rate" as if the engine had- * never run — cached for 60 seconds. That is a confident wrong answer, so it+ * never run, cached for 60 seconds. That is a confident wrong answer, so it* propagates and wrap() turns it into 503 + Retry-After.*/function emptyOnStatementFault(err) {diff --git a/api/persona/extract.js b/api/persona/extract.jsindex 49a3e28ca..9c2faa640 100644--- a/api/persona/extract.js+++ b/api/persona/extract.js@@ -119,14 +119,31 @@ const handler = wrap(async (req, res) => {system: SYSTEM_PROMPT,user: userMessage,maxTokens: 800,+ // Attribution for the spend ledger. Without it this lane's cost is+ // invisible on the admin dashboard AND llmComplete skips its per-user+ // daily USD cap, which only engages when a userId is known. The 5/day+ // limiter above bounds the call COUNT; this bounds the bill.+ track: { userId, tool: 'persona-extract' },});} catch (err) {if (err instanceof LlmUnavailableError) {+ // The caller cannot act on which server-side key is missing, and naming+ // the env vars in a public response advertises our provider inventory.+ // The operator sees the real cause in this log line.+ console.error('[persona/extract] no LLM provider configured');return error(res, 503, 'config_missing','Persona extraction is not available right now. Please try again later.');}- console.error('[persona/extract] all providers failed', err?.status, err?.message);- return error(res, err?.status || 502, 'upstream_error', 'Persona extraction is briefly unavailable. Please try again.');+ if (err?.code === 'daily_spend_cap_exceeded') {+ // A budget ceiling, not an outage: "try again" would be a lie for the+ // rest of the day, so pass the real reason and reset window through.+ return error(res, 429, 'daily_spend_cap_exceeded', err.message);+ }+ // Flat 502: every provider failure here is server-side, so the upstream's+ // own status must not become the caller's (an expired key answering 401+ // would otherwise read to the client as "your session ended").+ console.error('[persona/extract] all providers failed', err?.status || '', err?.message);+ return error(res, 502, 'upstream_error', 'Persona extraction is briefly unavailable. Please try again.');}// llmComplete prefers returning an empty-but-valid completion over throwingdiff --git a/api/persona/preview.js b/api/persona/preview.jsindex 4e5b4dc57..e05748c10 100644--- a/api/persona/preview.js+++ b/api/persona/preview.js@@ -97,6 +97,11 @@ const handler = wrap(async (req, res) => {system,user: body.user_message,maxTokens: 220,+ // Attribution for the spend ledger. Without it this lane's cost is+ // invisible on the admin dashboard AND llmComplete skips its per-user+ // daily USD cap, which only engages when a userId is known. The 30/hour+ // limiter above bounds the call COUNT; this bounds the bill.+ track: { userId, tool: 'persona-preview' },});} catch (err) {if (err instanceof LlmUnavailableError) {@@ -107,8 +112,16 @@ const handler = wrap(async (req, res) => {return error(res, 503, 'config_missing','Persona preview is not available right now. Please try again later.');}- console.error('[persona/preview] all providers failed', err?.status, err?.message);- return error(res, err?.status || 502, 'upstream_error', 'Persona preview is briefly unavailable. Please try again.');+ if (err?.code === 'daily_spend_cap_exceeded') {+ // A budget ceiling, not an outage: "try again" would be a lie for the+ // rest of the day, so pass the real reason and reset window through.+ return error(res, 429, 'daily_spend_cap_exceeded', err.message);+ }+ // Flat 502: every provider failure here is server-side, so the upstream's+ // own status must not become the caller's (an expired key answering 401+ // would otherwise read to the client as "your session ended").+ console.error('[persona/preview] all providers failed', err?.status || '', err?.message);+ return error(res, 502, 'upstream_error', 'Persona preview is briefly unavailable. Please try again.');}// llmComplete prefers an empty-but-valid completion over throwing when everydiff --git a/api/platform/stats.js b/api/platform/stats.jsindex acfb88f93..f60ac92b2 100644--- a/api/platform/stats.js+++ b/api/platform/stats.js@@ -54,7 +54,11 @@ export function countChains(chainRows, solanaRows) {async function queryStats() {const [agents, views, chats, avatars, countries, widgets, chains, solana] = await Promise.all([- // Total published agents with wallets or 3D avatars+ // Live agent identities: every non-deleted row, published or not. This is+ // deliberately the same predicate /api/home-stats counts on the same+ // table, because both figures render on the homepage; adding an+ // is_published filter on one side alone would print two different agent+ // counts on the same page.sql`select count(*)::int as nfrom agent_identities@@ -82,7 +86,8 @@ async function queryStats() {from widget_viewswhere country is not null and country <> ''`,- // Active widgets (published + visible)+ // Live widgets: non-deleted rows, public or not, matching what+ // /api/home-stats counts for the same reason as `agents` above.sql`select count(*)::int as nfrom widgetsdiff --git a/api/plugins/[action].js b/api/plugins/[action].jsindex c7632de03..6406c5c8f 100644--- a/api/plugins/[action].js+++ b/api/plugins/[action].js@@ -31,6 +31,13 @@ const FETCH_TIMEOUT_MS = 8000;// stored whole and re-served on every detail read.const MAX_IDENTIFIER_LENGTH = 128;const MAX_TOOLS = 100;+// Every tool declared here is handed straight to the model provider as a tool+// definition by the installer (src/plugins/index.js `toClaudeTools`), and both+// Anthropic and OpenAI reject a name outside this charset. Validating it at the+// publish boundary keeps a malformed manifest from breaking chat for everyone+// who installs it from the marketplace.+const TOOL_NAME_PATTERN = /^[a-zA-Z0-9_-]{1,64}$/;+const MAX_TOOL_DESCRIPTION_LENGTH = 1024;// ── Manifest validation — LobeHub/pai-chat ToolManifest format ───────────────// Required: identifier, meta.title, api[]@@ -49,9 +56,29 @@ function validateManifest(json) {throw new Error('api must be a non-empty array');if (json.api.length > MAX_TOOLS) throw new Error(`api must declare at most ${MAX_TOOLS} tools`);for (const tool of json.api) {- if (!tool.name || !tool.description)- throw new Error(`Tool "${tool.name || '?'}" missing name or description`);+ if (!tool || typeof tool !== 'object' || Array.isArray(tool))+ throw new Error('every api entry must be a JSON object');+ if (typeof tool.name !== 'string' || !tool.name)+ throw new Error('every api entry needs a name, given as a string');+ // The name is echoed back in the message, so it is truncated: the manifest+ // ceiling still allows a 64KB one, and a rejection is not a reason to hand+ // the caller their own payload back in full.+ if (!TOOL_NAME_PATTERN.test(tool.name))+ throw new Error(+ `Tool "${tool.name.slice(0, 64)}" name must be 1-64 characters of letters, digits, underscores, or hyphens`,+ );+ if (typeof tool.description !== 'string' || !tool.description.trim())+ throw new Error(`Tool "${tool.name}" needs a non-empty description`);+ if (tool.description.length > MAX_TOOL_DESCRIPTION_LENGTH)+ throw new Error(+ `Tool "${tool.name}" description must be ${MAX_TOOL_DESCRIPTION_LENGTH} characters or fewer`,+ );}+ // The manifest is stored whole and re-served on every list and detail read, so+ // the same ceiling the import fetch enforces applies to a directly published+ // one. Without it /publish accepted a body up to readJson's generic limit.+ if (Buffer.byteLength(JSON.stringify(json), 'utf8') > MAX_MANIFEST_BYTES)+ throw new Error(`manifest must be ${MAX_MANIFEST_BYTES / 1024}KB or smaller`);}// ── Auth ──────────────────────────────────────────────────────────────────────@@ -163,9 +190,17 @@ async function handleList(req, res, url) {const offset = cursor === null ? 0 : Number(cursor);if (!Number.isInteger(offset) || offset < 0)return error(res, 400, 'validation_error', 'cursor must be a non-negative integer');- const qLike = q ? `%${q}%` : null;+ // `%` and `_` are LIKE wildcards, so an unescaped search for "50%" matched+ // every row and "a_b" matched "axb". Escape them (and the escape character+ // itself) so the query text is taken literally, which is what the search box+ // promises.+ const qLike = q ? `%${q.replace(/[\\%_]/g, (ch) => `\\${ch}`)}%` : null;const fetchLimit = limit + 1;+ // p.id closes the ORDER BY. Every seeded plugin shares one created_at and an+ // install_count of 0, so the sort key was not unique and Postgres was free to+ // order the ties differently per query: paging the marketplace at limit=2+ // returned one plugin twice and never showed another at all.const rows = await sql`SELECT p.*, u.display_name AS author_display_name,ap.amount AS asset_price_amount,@@ -183,7 +218,8 @@ async function handleList(req, res, url) {ORDER BYCASE WHEN ${sort} = 'popular' THEN p.install_count END DESC NULLS LAST,CASE WHEN ${sort} = 'az' THEN p.name END ASC NULLS LAST,- p.created_at DESC+ p.created_at DESC,+ p.id DESCLIMIT ${fetchLimit} OFFSET ${offset}`;@@ -282,7 +318,20 @@ async function handleImport(req, res) {clearTimeout(timer);}if (!resp.ok) throw new Error(`HTTP ${resp.status}`);- manifest = JSON.parse(await resp.text());+ const text = await resp.text();+ try {+ manifest = JSON.parse(text);+ } catch {+ // Linking a repository page instead of the raw file is the common way to+ // land here, and a bare parse message ("Unexpected token '<'") does not+ // tell the caller that.+ return error(+ res,+ 422,+ 'invalid_manifest',+ 'manifest_url did not return JSON. Link directly to the manifest file, not to a web page.',+ );+ }} catch (err) {if (err instanceof SsrfBlockedError)return error(res, 400, 'validation_error', `manifest_url rejected: ${err.message}`);@@ -332,7 +381,10 @@ async function handlePublish(req, res) {const rl = await limits.pluginPublishUser(auth.userId);if (!rl.success) return rateLimited(res, rl);- const raw = await readJson(req);+ // Bounded at the manifest ceiling plus room for the envelope's other fields, so+ // an oversized publish is refused (413) at the boundary instead of being parsed+ // into memory first and rejected by validateManifest afterwards.+ const raw = await readJson(req, MAX_MANIFEST_BYTES + 4096);let body;try {body = publishSchema.parse(raw);diff --git a/api/skills/license-onchain.js b/api/skills/license-onchain.jsindex a1fc72189..0760eb059 100644--- a/api/skills/license-onchain.js+++ b/api/skills/license-onchain.js@@ -19,6 +19,8 @@* owner_token_account, program_id, network, explorer, record } }*/+import { PublicKey } from '@solana/web3.js';+import { sql } from '../_lib/db.js';import { cors, error, json, method, wrap, rateLimited, serverError } from '../_lib/http.js';import { clientIp, limits } from '../_lib/rate-limit.js';@@ -28,7 +30,21 @@ import {verifyOnchainSkillLicense,} from '../_lib/skill-license-onchain.js';-const BASE58_RE = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;+/**+ * A base58 charset test is not enough here: a 42-character string passes it but+ * decodes to 31 bytes, which `new PublicKey()` rejects deep inside the PDA+ * derivation. That surfaced as a 502 `rpc_error` ("internal error") for what is+ * plainly a caller mistake, so check the real thing at the boundary and answer+ * 400 instead.+ */+function isPubkey(value) {+ try {+ new PublicKey(value);+ return true;+ } catch {+ return false;+ }+}function explorerForLicense(license, network) {const cluster = network === 'devnet' ? '?cluster=devnet' : '';@@ -49,7 +65,7 @@ export default wrap(async (req, res) => {const agentId = (url.searchParams.get('agent_id') || '').trim();const network = url.searchParams.get('network') === 'devnet' ? 'devnet' : 'mainnet';- if (!BASE58_RE.test(wallet)) {+ if (!isPubkey(wallet)) {return error(res, 400, 'validation_error', 'wallet must be a Solana address');}if (!skill || skill.length > 100) {@@ -79,8 +95,13 @@ export default wrap(async (req, res) => {}agentMint = agent.skill_collection_mint;}- if (!BASE58_RE.test(agentMint)) {- return error(res, 400, 'validation_error', 'agent_mint or agent_id is required');+ if (!isPubkey(agentMint)) {+ return error(+ res,+ 400,+ 'validation_error',+ 'agent_mint (a Solana address) or agent_id is required',+ );}let result;diff --git a/api/sns.js b/api/sns.jsindex 6ee41463c..c86f1510f 100644--- a/api/sns.js+++ b/api/sns.js@@ -1,5 +1,6 @@// GET /api/sns?name=<label>[.sol] → resolve .sol → owner base58// GET /api/sns?address=<base58> → reverse-lookup wallet → primary .sol+// Add &domains=1 to either to also get the owner's full domain list + favorite.//// Both directions always answer 200 with a `{ data: { name, address, network,// resolved } }` envelope. A miss is `resolved: false` with the unresolved side@@ -14,7 +15,7 @@import { cors, error, json, method, wrap, rateLimited } from './_lib/http.js';import { limits, clientIp } from './_lib/rate-limit.js';-import { resolveSnsName, reverseLookupAddress } from '../src/solana/sns.js';+import { resolveSnsName, reverseLookupAddress, snsOwnerDomains } from '../src/solana/sns.js';// Accept a bare label (`nick`), a top-level domain (`nick.sol`), or any depth// of subdomain (`nich.threews.sol`). Each segment is the SNS label rule:@@ -27,6 +28,7 @@ const NEGATIVE_TTL_MS = 60_000;const forwardCache = new Map(); // name → { value, expiresAt }const reverseCache = new Map(); // address → { value, expiresAt }+const domainsCache = new Map(); // owner → { value, expiresAt }function getCached(map, key) {const hit = map.get(key);@@ -51,6 +53,25 @@ function normalizeName(input) {return trimmed.endsWith('.sol') ? trimmed.slice(0, -4) : trimmed;}+// Opt-in extras for a resolved owner: every `.sol` they hold plus their favorite+// domain. Off by default because it costs two calls to the Bonfida index, and+// the reverse lookup on this endpoint runs on every page load. Best-effort by+// construction: an index outage answers with the plain envelope, never a 5xx.+async function ownerExtras(owner) {+ if (!owner) return {};+ let extras = getCached(domainsCache, owner);+ if (extras === undefined) {+ extras = await snsOwnerDomains(owner).catch(() => null);+ setCached(domainsCache, owner, extras);+ }+ if (!extras) return {};+ return {+ all_domains: extras.allDomains,+ favorite_domain: extras.favoriteDomain,+ domains_truncated: extras.truncated,+ };+}+export default wrap(async (req, res) => {if (cors(req, res, { methods: 'GET,OPTIONS' })) return;if (!method(req, res, ['GET'])) return;@@ -61,6 +82,7 @@ export default wrap(async (req, res) => {const url = new URL(req.url, 'http://x');const rawName = url.searchParams.get('name');const rawAddr = url.searchParams.get('address');+ const wantDomains = ['1', 'true', 'yes'].includes(String(url.searchParams.get('domains') || '').toLowerCase());if (rawName && rawAddr) {return error(res, 400, 'validation_error', 'pass either name or address, not both');@@ -80,7 +102,8 @@ export default wrap(async (req, res) => {data: { name: domain, address: null, network: 'solana', resolved: false },}, { 'cache-control': 'public, max-age=30' });}- return json(res, 200, { data: { name: domain, address, network: 'solana', resolved: true } }, {+ const extras = wantDomains ? await ownerExtras(address) : {};+ return json(res, 200, { data: { name: domain, address, network: 'solana', resolved: true, ...extras } }, {'cache-control': 'public, max-age=300',});}@@ -94,11 +117,16 @@ export default wrap(async (req, res) => {setCached(reverseCache, addr, name);}if (!name) {+ // No favorite domain set is not the same as holding none, so the opt-in+ // list still answers here: it is the difference between "unnamed wallet"+ // and "wallet with domains but no primary".+ const missExtras = wantDomains ? await ownerExtras(addr) : {};return json(res, 200, {- data: { name: null, address: addr, network: 'solana', resolved: false },+ data: { name: null, address: addr, network: 'solana', resolved: false, ...missExtras },}, { 'cache-control': 'public, max-age=30' });}- return json(res, 200, { data: { name, address: addr, network: 'solana', resolved: true } }, {+ const extras = wantDomains ? await ownerExtras(addr) : {};+ return json(res, 200, { data: { name, address: addr, network: 'solana', resolved: true, ...extras } }, {'cache-control': 'public, max-age=300',});}@@ -107,4 +135,4 @@ export default wrap(async (req, res) => {});// Exported for unit tests. Not part of the public HTTP surface.-export const _internals = { forwardCache, reverseCache, normalizeName };+export const _internals = { forwardCache, reverseCache, domainsCache, normalizeName };diff --git a/data/changelog.json b/data/changelog.jsonindex da34af323..55ba0f274 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,94 @@{"$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-15",+ "title": "The Agent Economy demo works again when you just pick a service, and it fits a phone screen",+ "summary": "On the Agent Economy page, two 3D agents trade with each other for real SOL: Nova buys a market read, an on-chain insight, or a risk score from Oracle. Picking a service and typing nothing in the optional topic box, which is what almost everyone does, sent the request off in a shape the endpoint refused, so the demo answered with a validation error instead of a trade. It now sends the request correctly, and the endpoint accepts an empty topic besides. On a phone the page was worse than broken: the transaction feed and the status line, the entire output of the demo, were cut off the bottom of the screen with no way to scroll to them, and the floating language button sat on top of the footer links. The centre column now scrolls, the feed keeps a readable height, and the footer stays clickable. Three failure states also stopped lying: a payment that could not go through no longer ends on Transaction complete, a request that never reached the server now says so and offers to try again, and unreadable wallet balances now say they are unavailable and offer a retry instead of spinning forever.",+ "tags": [+ "fix",+ "improvement"+ ],+ "link": "/agent-economy"+ },+ {+ "date": "2026-08-15",+ "title": "Oracle stops answering \"nothing is happening\" when the database is the thing that is down",+ "summary": "Several Oracle reads shared a habit: if the database was unreachable for a few seconds, they answered normally with an empty result. The movers panel said nothing was moving, the stats hero said no coin had ever been scored and no agent was armed, a coin's conviction sparkline came back flat, and the machine-readable signal endpoint told autonomous agents there were no plays, which is exactly the cue for an agent to stand down. Every one of those answers was then cached at the edge for a minute or two, so a blip lasting seconds kept showing a dead market long after the database was back. Those endpoints now tell the difference between a connectivity failure and an ordinary query fault: the first is reported honestly as a temporary outage with a retry hint and is never cached, the second still degrades to the empty answer it always did. The social ingest got the sharper end of the same bug: it used to reply that a batch had been accepted while reporting zero mints written, a receipt for a write that never landed. It now fails loudly so the sender retries. Shared conviction cards behave too: one built during an outage is no longer pinned to a coin's link preview for 15 minutes.",+ "tags": [+ "fix",+ "improvement"+ ],+ "link": "/oracle"+ },+ {+ "date": "2026-08-15",+ "title": "Docs pages stop opening with a wall of raw metadata, and the AWS pages say where the Marketplace listing actually stands",+ "summary": "Nine documentation pages are written as article drafts, so each one starts with a small block of publishing metadata: the title, where it is meant to run, its tags. That block is meant for the tooling, not for you, but the docs reader had no idea what it was and rendered it as an enormous heading at the very top of the article, above the actual writing. It is now recognised and hidden, on the page and in the Copy page text, so those articles begin where they should. Reading the same pages closely turned up claims that had drifted: several said three.ws was already live on AWS Marketplace and billing usage to your AWS invoice. The integration is built and deployed, but the listing itself has not been published yet and the pricing decision is a free subscription with no AWS metering, so the AWS pages now say exactly that and point at the page that tracks the status. The MCP article's vanity-address tool was also listed at a metered price of up to fifty cents; it is a flat five cents per grind, which is what the code has always charged.",+ "tags": [+ "docs",+ "fix"+ ],+ "link": "/docs/aws-marketplace"+ },+ {+ "date": "2026-08-15",+ "title": "A silent outage in the agent reasoning ledger now reports itself",+ "summary": "Every agent decision is committed to a hash chain, and that chain head is written to Solana on a schedule so anyone can check the history was never edited. The wallet that pays for those on-chain writes ran empty, and the scheduled job could not tell that apart from the harmless case where no signing key is set up at all: it answered a healthy 200 every ten minutes while re-sending the same doomed transaction for twelve agents in a row, and not one head reached the chain. A rejected write is now reported as a rejected write, the rest of the run stops instead of repeating a failure that cannot succeed, and it raises an alert so the wallet gets refilled. Verifying a ledger already worked without the on-chain leg and still does: the recomputed hash chain is the tamper proof, the on-chain write is the independent timestamp on top of it. Separately, the once-a-minute economy heartbeat now refuses to drive production from a machine that is not production, so a developer running it locally can no longer fire thirty-six live money engines at the real site.",+ "tags": [+ "fix",+ "infra"+ ],+ "link": "/docs/reasoning-ledger"+ },+ {+ "date": "2026-08-15",+ "title": "The plugin marketplace stops hiding a plugin when you page through it",+ "summary": "Browsing plugins a page at a time could show you the same plugin twice and never show another one at all. The catalogue was sorted by install count and publish date, and the built-in plugins were all published in the same instant with zero installs, so that sort left them tied and the database was free to order the tied rows differently on every request. One plugin therefore landed on two consecutive pages and one fell through the gap. The order is now decided all the way down, so paging through the catalogue returns every plugin exactly once. Searching also takes your text literally: typing a percent sign or an underscore used to act as a database wildcard and match rows it should not. Publishing got stricter at the same time, because a plugin manifest is handed to the model as a tool definition by whoever installs it: a tool name now has to be plain letters, digits, underscores, or hyphens, every tool needs a real description, and a manifest has to fit the same 64KB ceiling that importing one by URL already enforced. And pointing the importer at a repository web page instead of the raw manifest file now says exactly that, rather than showing a raw parser error.",+ "tags": [+ "fix",+ "improvement"+ ],+ "link": "/marketplace"+ },+ {+ "date": "2026-08-15",+ "title": "Plan checkout: a paid upgrade can only ever settle on real mainnet, and a late payment is no longer stranded",+ "summary": "Paying for a plan creates a quote, you send the funds, then the server checks the chain before it upgrades you. Three things in that path were wrong. The checkout side has always refused test-network quotes in production, because test-network dollars are free from a faucet, but the confirm side still let a caller name the test network itself, and it is the confirm side that decides which chain it looks at and which dollar it accepts. Both ends now read the same setting, so a production upgrade can only ever be settled by real funds on mainnet. Second, an Ethereum-side payment has to wait twelve blocks before it counts, which meant funds sent near the end of a session could land on-chain and then be refused for arriving late, with the money already gone; that lane now honors the same one-hour grace window the Solana lane has, so an on-chain payment is always claimable. Third, confirming an Ethereum payment could reach a Solana quote and mark it expired, and asking to buy a skill from a malformed agent id answered a generic server error instead of telling you what was wrong with the request.",+ "tags": [+ "fix",+ "security"+ ],+ "link": "/pricing"+ },+ {+ "date": "2026-08-15",+ "title": "The persona builder stops reporting a model outage as if you had been signed out",+ "summary": "The two routes behind the persona builder (the one that turns your interview answers or a sample of your own writing into a structured persona, and the one that replies to you in that persona's voice) used to hand you whatever status code the model provider returned. If a server-side key expired, the provider answered 401 and so did we, which reads to a browser as an expired session on a request where nothing was wrong with your sign-in. Both now report a provider failure as exactly what it is: a server-side fault, with a plain message and no implication that you need to log back in. Separately, when the platform's daily model-spend ceiling is reached, the builder now says so and tells you when it resets, instead of asking you to retry something that could not have succeeded for the rest of the day. Both routes also now record their model usage against your account, so the spend they generate is visible and capped rather than untracked, and the daily extraction budget now holds across every server instance instead of being counted separately on each one.",+ "tags": [+ "fix",+ "improvement"+ ]+ },+ {+ "date": "2026-08-15",+ "title": "Self-hosting docs no longer hand you a command that wipes your environment",+ "summary": "The deployment guide told self-hosters to set Cloud Run environment variables with `gcloud run services update --set-env-vars`. That flag replaces the service environment wholesale, so following the instruction for a single key silently deletes every other variable the service had. The guide now uses `--update-env-vars` and says plainly why. Four more corrections landed in the same sweep across the deployment, configuration and contributing pages: the Avaturn signup link and the GitHub Discussions links were dead (Discussions are not enabled on the repository, so bug reports and design questions both go to Issues); the in-browser avatar builder was documented as needing its own hosted origin in production when the normal build already serves it same-origin at /avatar-studio; and three counts that had drifted from the code (cron jobs, MCP server packages, contract tests) were replaced with pointers to the files that hold the real numbers.",+ "tags": [+ "docs",+ "fix"+ ],+ "link": "/docs/deployment"+ },+ {+ "date": "2026-08-15",+ "title": "A broken paid endpoint is no longer reported as a free one",+ "summary": "Payment sessions let you hand an agent a budget instead of a key, and two parts of that path judged an endpoint by one rule: if it did not ask for payment, the call was free. That is only true when the endpoint actually succeeded. A paid API answering 404, 400, or 500 was being scored as a free call, and the consequences ran in the wrong direction in both places. The dry run at /pay/simulator, whose whole job is to tell you in advance whether a budget and an allowlist will carry a workload, reported a plan as feasible at a cost of nothing when in fact every endpoint in it was erroring: free calls are never priced, never allowlist-checked, and never counted, so a wall of failures looked like a clean run. And an agent spending through a session got back a success envelope saying no payment was needed for an endpoint that had just failed on it. Both now separate the two cases: a real success with no payment challenge is still free and still costs nothing, while an error status is reported as an endpoint failure carrying the status the endpoint actually returned. No session is charged either way. The simulator lists each failing endpoint by name in its problems list and no longer calls the plan feasible.",+ "tags": [+ "fix"+ ],+ "link": "/pay/simulator"+ },{"date": "2026-08-14","title": "The video studio stops loading an avatar it is about to throw away",diff --git a/data/examples.json b/data/examples.jsonindex def069d8e..0fabd0ce6 100644--- a/data/examples.json+++ b/data/examples.json@@ -2,10 +2,10 @@"$comment": "Generated by scripts/build-examples-index.mjs from what is on disk. Do not edit by hand; run npm run build:examples.","generated_by": "scripts/build-examples-index.mjs","counts": {- "total": 40,+ "total": 42,"html_demos": 11,"projects": 10,- "packages": 19+ "packages": 21},"examples": [{@@ -315,13 +315,29 @@"description": "American Sign Language for 3D avatars.","path": "packages/sign-language/example","files": [- "compile-utterance.mjs"+ "compile-utterance.mjs",+ "utterance.clip.json"],"run": "node packages/sign-language/example/compile-utterance.mjs","runKind": "command","readme": null,"owner": "packages/sign-language"},+ {+ "id": "package:packages/skill-license",+ "kind": "package",+ "group": "Package examples",+ "title": "@three-ws/skill-license",+ "description": "On-chain skill licenses for agents - each purchased skill is a 1/1 SPL NFT plus a deterministic SkillLicense PDA. Mint, verify, and read trustless skill access in one import, no database required.",+ "path": "packages/skill-license/example",+ "files": [+ "verify-license.mjs"+ ],+ "run": "node packages/skill-license/example/verify-license.mjs",+ "runKind": "command",+ "readme": null,+ "owner": "packages/skill-license"+ },{"id": "package:tour-sdk","kind": "package",@@ -356,6 +372,22 @@"readme": "packages/vanity-mcp/examples/README.md","owner": "packages/vanity-mcp"},+ {+ "id": "package:packages/vision-mcp",+ "kind": "package",+ "group": "Package examples",+ "title": "@three-ws/vision-mcp",+ "description": "Two runnable examples. Both spawn this package's own MCP server over stdio (the same node src/index.js entry point the README documents), speak real MCP JSON-RPC to it, and hit the live three.ws vision pipeline.",+ "path": "packages/vision-mcp/examples",+ "files": [+ "list-tools.mjs",+ "read-an-image.mjs"+ ],+ "run": "node packages/vision-mcp/examples/list-tools.mjs",+ "runKind": "command",+ "readme": "packages/vision-mcp/examples/README.md",+ "owner": "packages/vision-mcp"+ },{"id": "package:packages/x402-fetch","kind": "package",diff --git a/data/pages.json b/data/pages.jsonindex bb2565bfe..70182126f 100644--- a/data/pages.json+++ b/data/pages.json@@ -4502,7 +4502,7 @@{"path": "/docs/aws-marketplace","title": "Docs · three.ws on AWS Marketplace",- "description": "three.ws is a verified AWS Partner and listed on AWS Marketplace as an API-based SaaS product. The subscription is a free front door: subscribing links your AWS account to a platform account.",+ "description": "three.ws is a verified AWS Partner. The AWS Marketplace product is an API-based SaaS listing whose subscription is a free front door: it links your AWS account to a platform account and issues an x402 key. Integration, endpoints, and current listing status.","priority": 0.6,"changefreq": "monthly"},@@ -4992,7 +4992,7 @@{"path": "/tutorials/write-a-guard","title": "Tutorial · Write a repository guard",- "description": "This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when an API handler forgets its error boundary, wire it into the gate, cover it with tests, and register it.",+ "description": "This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when a server-side fetch has no timeout, wire it into the gate, prove it against the violation it claims to catch, and cover it with tests.","priority": 0.8,"changefreq": "monthly","added": "2026-07-30"@@ -5008,7 +5008,7 @@{"path": "/docs/tutorials/write-a-guard","title": "Docs · Write a repository guard",- "description": "Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json, wire it into a stage, and cover it with a test that includes the false positive it must never report.",+ "description": "Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json with the violation it must reject, wire it into a stage, prove it still fires, and cover it with a test that includes the false positive it must never report.","priority": 0.5,"changefreq": "monthly","added": "2026-07-30"diff --git a/docs/3d-asset-pipeline.md b/docs/3d-asset-pipeline.mdindex f19a5668e..7a977f762 100644--- a/docs/3d-asset-pipeline.md+++ b/docs/3d-asset-pipeline.md@@ -140,7 +140,8 @@ Source: [scripts/optimize-glb.mjs](../scripts/optimize-glb.mjs). Lossless geomet"tracks": [{ "name": "Hips.position", "type": "vector", "times": [...], "values": [...] },{ "name": "Hips.quaternion", "type": "quaternion", "times": [...], "values": [...] }- // …one position + one quaternion track per canonical bone (≈53 tracks)+ // …one quaternion track per canonical bone, plus the single Hips position+ // track: 52 + 1 = 53 tracks for a full clip]}```@@ -153,7 +154,7 @@ Track names are **canonical bone names** (`Hips`, `Spine`, `LeftArm`, …) so th{ "name": "idle", "url": "/animations/clips/idle.json", "label": "Idle", "icon": "🧍", "loop": true }```-**The canonical skeleton** is a 53-bone humanoid set defined in [src/glb-canonicalize.js](../src/glb-canonicalize.js): the torso chain (`Hips → Spine → Spine1 → Spine2 → Neck → Head`), both arms (`Shoulder → Arm → ForeArm → Hand`) with full finger chains, and both legs (`UpLeg → Leg → Foot → ToeBase`). `public/avatars/cz.glb` is the reference rig every clip is retargeted against.+**The canonical skeleton** is the 52-bone humanoid set exported as `CANONICAL_BONES` from [src/glb-canonicalize.js](../src/glb-canonicalize.js): the torso chain (`Hips → Spine → Spine1 → Spine2 → Neck → Head`), both arms (`Shoulder → Arm → ForeArm → Hand`) with full finger chains, and both legs (`UpLeg → Leg → Foot → ToeBase`). `public/avatars/cz.glb` is the reference rig every clip is retargeted against.---diff --git a/docs/3d-pipeline.md b/docs/3d-pipeline.mdindex 5f9198021..fba81e15a 100644--- a/docs/3d-pipeline.md+++ b/docs/3d-pipeline.md@@ -36,7 +36,10 @@ Every `pipeline-*` route is a synchronous, pay-per-call endpoint:1. You `POST` a JSON body with the source URL + options.2. If you send no `X-PAYMENT` header, you get a `402` challenge quoting the price- in USDC (Solana mainnet; Base when configured).+ in USDC. The challenge carries one `accepts` entry per network the platform+ can settle on: the Solana USDC entry leads whenever the Solana rail is+ settleable, with Base as the alternative. Read the network off the challenge+ rather than assuming one.3. You settle and retry with `X-PAYMENT`. The server validates your input URL(SSRF-guarded, magic-byte sniffed), submits the worker job, polls it tocompletion, validates the output bytes, mirrors the result into first-party@@ -47,6 +50,40 @@ Every `pipeline-*` route is a synchronous, pay-per-call endpoint:Prices are env-overridable per the [pricing model](x402-endpoints.md#pricing-model)(`X402_PRICE_<UPPER_SNAKE_SLUG>`).+## Paying for a stage++There is no x402 command-line tool to shell out to: signing the challenge is the+part that needs your wallet, so paying happens in code. Every stage sample below+is the unpaid `curl`, which returns the 402 challenge and costs nothing. To+actually run a stage, wrap `fetch` once with our published buyer package and call+the same URL:++```bash+npm install @three-ws/x402-fetch+```++```js+import { withX402 } from '@three-ws/x402-fetch';+import { privateKeyToWallet } from '@three-ws/x402-fetch/wallet';++// maxPaymentUsd is a hard ceiling: the wrapper refuses a challenge above it.+const pay = withX402(privateKeyToWallet(process.env.WALLET_PRIVATE_KEY), { maxPaymentUsd: 0.1 });++const res = await pay('https://three.ws/api/x402/pipeline-rig', {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({ glb_url: 'https://three.ws/avatars/mannequin.glb', rig_type: 'biped' }),+});++const { output_url } = await res.json();+console.log(output_url);+```++The wrapper answers the 402, signs the payment, and retries the same request, all+before your `await` resolves. Paying from a three.ws agent wallet instead of a+raw key, or settling on Solana, is covered in+[x402 buyer client](x402-buyer.md).+## Stages### Rig — `POST /api/x402/pipeline-rig` — $0.05@@ -55,15 +92,16 @@ Infers a humanoid skeleton and binds it to a static mesh with skin weights, so tmodel can walk, wave, and emote. **In:** a static GLB. **Out:** a rigged GLB.```bash-# 1. Discover the price (unpaid request returns the 402 challenge)+# Unpaid: returns the 402 challenge with the price and the networks it settles on.curl -s -X POST https://three.ws/api/x402/pipeline-rig \-H 'content-type: application/json' \-d '{"glb_url":"https://three.ws/avatars/mannequin.glb","rig_type":"biped"}'+```++Paid (send the same body through the wrapper above), the response is:-# 2. Pay with an x402 client (settles the 402 and retries automatically)-npx @x402/fetch POST https://three.ws/api/x402/pipeline-rig \- --json '{"glb_url":"https://three.ws/avatars/mannequin.glb","rig_type":"biped"}'-# → { "stage":"rig", "output_url":"https://three.ws/cdn/x402-pipeline/rig/….glb", ... }+```json+{ "stage": "rig", "output_url": "https://three.ws/cdn/x402-pipeline/rig/….glb" }```### Remesh — `POST /api/x402/pipeline-remesh` — $0.03@@ -73,11 +111,14 @@ target face count, with the texture re-baked onto the new topology. **In:** a GLoptions. **Out:** a cleaned GLB with predictable topology.```bash-npx @x402/fetch POST https://three.ws/api/x402/pipeline-remesh \- --json '{"glb_url":"https://three.ws/avatars/brainstem.glb","remesh_mode":"quad","target_faces":20000}'-# → { "stage":"remesh", "output_url":"…", "face_count":20000, "quad_ratio":0.98, "textured":true }+curl -s -X POST https://three.ws/api/x402/pipeline-remesh \+ -H 'content-type: application/json' \+ -d '{"glb_url":"https://three.ws/avatars/brainstem.glb","remesh_mode":"quad","target_faces":20000}'```+Paid response: `{ "stage":"remesh", "output_url":"…", "face_count":20000,+"quad_ratio":0.98, "textured":true }`+Options: `remesh_mode` (`triangle` | `quad` | `lowpoly`), `operation` (`full` |`simplify` | `repair` | `convert`, triangle mode only), `target_faces`(1,000–500,000), `texture_size` (512 | 1024 | 2048).@@ -90,11 +131,14 @@ topology, so the asset drops into a real-time engine within budget. **In:** a GL`poly_budget`. **Out:** an engine-ready GLB.```bash-npx @x402/fetch POST https://three.ws/api/x402/pipeline-gameready \- --json '{"glb_url":"https://three.ws/avatars/fox.glb","topology":"quad","poly_budget":12000}'-# → { "stage":"gameready", "output_url":"…", "poly_budget":12000, "quad_ratio":0.97 }+curl -s -X POST https://three.ws/api/x402/pipeline-gameready \+ -H 'content-type: application/json' \+ -d '{"glb_url":"https://three.ws/avatars/fox.glb","topology":"quad","poly_budget":12000}'```+Paid response: `{ "stage":"gameready", "output_url":"…", "poly_budget":12000,+"quad_ratio":0.97 }`+Options: `topology` (`quad` | `tri`), `poly_budget` (1,000–500,000), `texture_size`(1024 | 2048).@@ -105,11 +149,14 @@ rebuild the mesh itself (not a shader), so the look survives export to any engin**In:** a GLB + `style`. **Out:** a restyled GLB.```bash-npx @x402/fetch POST https://three.ws/api/x402/pipeline-stylize \- --json '{"glb_url":"https://three.ws/avatars/mannequin.glb","style":"voxel","resolution":48}'-# → { "stage":"stylize", "output_url":"…", "style":"voxel", "resolution":48 }+curl -s -X POST https://three.ws/api/x402/pipeline-stylize \+ -H 'content-type: application/json' \+ -d '{"glb_url":"https://three.ws/avatars/mannequin.glb","style":"voxel","resolution":48}'```+Paid response: `{ "stage":"stylize", "output_url":"…", "style":"voxel",+"resolution":48 }`+Options: `style` (`voxel` | `brick` | `voronoi` | `lowpoly`), `resolution`(clamped per filter).@@ -120,11 +167,14 @@ reference view image→3D reconstruction needs so it never bakes a room into themesh. **In:** an image (PNG/JPEG/WEBP/GIF). **Out:** a transparent PNG.```bash-npx @x402/fetch POST https://three.ws/api/x402/pipeline-rembg \- --json '{"image_url":"https://three.ws/avatars/thumbs/default.png","model":"rmbg2"}'-# → { "stage":"rembg", "output_url":"https://three.ws/cdn/x402-pipeline/rembg/….png" }+curl -s -X POST https://three.ws/api/x402/pipeline-rembg \+ -H 'content-type: application/json' \+ -d '{"image_url":"https://three.ws/avatars/thumbs/default.png","model":"rmbg2"}'```+Paid response: `{ "stage":"rembg", "output_url":+"https://three.ws/cdn/x402-pipeline/rembg/….png" }`+Options: `model` (`rmbg2` | `u2net` | `isnet` | `u2net_human_seg` | `silueta`).## A full flow@@ -132,19 +182,43 @@ Options: `model` (`rmbg2` | `u2net` | `isnet` | `u2net_human_seg` | `silueta`).Generate a mesh, then rig and optimize it — three paid calls, each output URLfeeding the next input:-```bash-# 1. Generate ($0.05 draft tier) → poll /api/forge?job=<id> for the GLB-FORGE=$(npx @x402/fetch POST https://three.ws/api/x402/forge \- --json '{"prompt":"a brass steampunk owl, full body","tier":"draft"}')-GLB=$(echo "$FORGE" | jq -r '.glb_url')--# 2. Rig it ($0.05)-RIGGED=$(npx @x402/fetch POST https://three.ws/api/x402/pipeline-rig \- --json "{\"glb_url\":\"$GLB\"}" | jq -r '.output_url')--# 3. Make it game-ready ($0.03)-npx @x402/fetch POST https://three.ws/api/x402/pipeline-gameready \- --json "{\"glb_url\":\"$RIGGED\",\"poly_budget\":15000}"+```js+import { withX402 } from '@three-ws/x402-fetch';+import { privateKeyToWallet } from '@three-ws/x402-fetch/wallet';++const pay = withX402(privateKeyToWallet(process.env.WALLET_PRIVATE_KEY), { maxPaymentUsd: 0.1 });++const post = async (url, body) => {+ const res = await pay(url, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify(body),+ });+ if (!res.ok) throw new Error(`${url} → ${res.status} ${await res.text()}`);+ return res.json();+};++// 1. Generate ($0.05 draft tier). A fast lane answers with status:"done" and the+// GLB inline; anything slower hands back a job token you poll for FREE.+const forge = await post('https://three.ws/api/x402/forge', {+ prompt: 'a brass steampunk owl, full body',+ tier: 'draft',+});+let glbUrl = forge.glb_url ?? null;+while (!glbUrl) {+ await new Promise((r) => setTimeout(r, 5000));+ const poll = await fetch(`https://three.ws${forge.poll_url}`).then((r) => r.json());+ if (poll.status === 'failed') throw new Error(poll.error);+ glbUrl = poll.glb_url ?? null;+}++// 2. Rig it ($0.05), then 3. make it game-ready ($0.03).+const rigged = await post('https://three.ws/api/x402/pipeline-rig', { glb_url: glbUrl });+const ready = await post('https://three.ws/api/x402/pipeline-gameready', {+ glb_url: rigged.output_url,+ poly_budget: 15000,+});+console.log(ready.output_url);```## Operator configurationdiff --git a/docs/PROTOCOL-vanity.md b/docs/PROTOCOL-vanity.mdindex 781df6dbd..7ee167d13 100644--- a/docs/PROTOCOL-vanity.md+++ b/docs/PROTOCOL-vanity.md@@ -279,12 +279,21 @@ difficulty, impostor signing key, or mismatched opened secret each FAIL.```json{"protocol": "three-vanity/v1",- "serviceKey": { "curve": "ed25519", "publicKeyBase58": "…", "publicKeyHex": "…", "use": "receipt-signing" },+ "serviceKey": { "curve": "ed25519", "keyId": "…", "publicKeyBase58": "…", "publicKeyHex": "…", "use": "receipt-signing" },"schemes": { … },- "endpoints": { "grind": "/api/x402/vanity-verifiable", "verifyPage": "/vanity/verify" }+ "endpoints": {+ "grind": "https://three.ws/api/x402/vanity",+ "verifiableGrind": "https://three.ws/api/x402/vanity-verifiable",+ "certRegistry": "https://three.ws/api/vanity/cert",+ "verifyPage": "https://three.ws/vanity/verify"+ }}```+Endpoint URLs are absolute, so a verifier that fetched the document has everything+it needs without knowing the origin. `grind` is the plain vanity endpoint;+`verifiableGrind` is the one that issues the receipts this protocol specifies.+The SDK pins `THREE_VANITY_SERVICE_KEY`; for production verification, cross-checkit against the live well-known document (`fetchServiceKey()` / `--fetch-key` /the web page does this automatically). On key rotation, update the well-knowndiff --git a/docs/agenc.md b/docs/agenc.mdindex c7625360e..46089d154 100644--- a/docs/agenc.md+++ b/docs/agenc.md@@ -1,6 +1,6 @@# AgenC-[AgenC](agora.md) is the on-chain coordination protocol three.ws reads from for+AgenC is the on-chain coordination protocol three.ws reads from fortask discovery and agent identity. three.ws exposes a small set of **read**endpoints over it and bridges three.ws agent handles to AgenC agent IDs. This pagedocuments what is wired today — including, plainly, what is not.diff --git a/docs/agent-manifest.md b/docs/agent-manifest.mdindex f1a039693..a16aa06ad 100644--- a/docs/agent-manifest.md+++ b/docs/agent-manifest.md@@ -50,21 +50,26 @@ The `<agent-3d>` element accepts several source forms. Priority when multiple at<agent-3d body="./product.glb"></agent-3d>```-Programmatically (SDK):+Programmatically, the same loader the element uses is a named export of the published bundle:```js-import { assertValid } from '@three-ws/avatar-schema';+import { loadManifest, normalize } from 'https://three.ws/agent-3d/1.5.2/agent-3d.js';-// Fetch the manifest from wherever it lives — your resolver, an IPFS-// gateway, or a plain HTTPS URL — then validate it against the schema.-const res = await fetch('https://cdn.acme.com/aria/manifest.json');-const manifest = await res.json();+// One call for every source form the element accepts: agent:// (resolved+// through the ERC-8004 registry on the named chain), ipfs://, ar://, and+// plain HTTPS.+const manifest = await loadManifest('https://cdn.acme.com/aria/manifest.json');-// Throws if the document does not match the canonical avatar manifest schema.-assertValid(manifest);+console.log(manifest.name, manifest.body.uri);```-`assertValid` throws if the document does not match the canonical avatar manifest schema, and returns normally when it does. Prefer `validate(manifest)` when you want a `{ valid, errors }` result instead of an exception. Resolve any relative paths in the manifest against the URL you fetched it from.+`loadManifest` returns the manifest already normalized: it stamps `_baseURI` with the URL it fetched from, so relative paths (`instructions.md`, `skills/wave/`, `memory/MEMORY.md`) resolve correctly, and it adapts an ERC-8004 registration JSON into this manifest shape when that is what the URI serves. Call `fetchRelative(manifest, 'instructions.md')` to pull a bundle file. If you already hold the parsed JSON, `normalize(json, { baseURI })` does the shape work alone.++> `@three-ws/avatar-schema` is **not** the validator for this document. It+> validates the *avatar* manifest (`avatar.v1.json`: `schemaVersion`, `mesh`,+> `skeleton`, `owner`), which describes a 3D body, not an agent. Running+> `assertValid` from that package on an agent manifest always throws. See+> [Agents vs. avatars](agents-vs-avatars.md) for why the two are separate.---diff --git a/docs/api-reference.md b/docs/api-reference.mdindex b37a5608a..6fba90919 100644--- a/docs/api-reference.md+++ b/docs/api-reference.md@@ -3647,7 +3647,7 @@ curl -X POST https://three.ws/api/pay/execute \}```-If the endpoint answers without a `402`, it was free. You get `paid: false` and the session is never touched.+If the endpoint answers a success without a `402`, it was free. You get `paid: false` and the session is never touched. If it answers an error status without a `402`, nothing was payable and nothing succeeded: you get `502 endpoint_error` with the real `upstream_status` and `upstream_body`, and the session is still never touched.### Governance errors@@ -5597,13 +5597,15 @@ path is the canonical one.| Parameter | Default | Meaning ||---|---|---|| `category` | all | Exact category slug, as returned by `/api/plugins/categories` |-| `q` | none | Case-insensitive substring match on name or description (first 80 chars used) |+| `q` | none | Case-insensitive substring match on name or description (first 80 chars used). Taken literally: `%` and `_` are escaped, not treated as wildcards. || `sort` | `popular` | `popular` (install count), `new` (newest first), or `az` (name). An unknown value falls back to `popular`. || `limit` | `20` | 1 to 40 || `cursor` | `0` | Opaque offset. Pass back the `next_cursor` from the previous page verbatim. |`cursor` must be a non-negative integer; anything else is a `400`-(`validation_error`), never a 500. `next_cursor` is `null` on the last page.+(`validation_error`), never a 500. `next_cursor` is `null` on the last page. The+sort is fully ordered (ties break on the plugin id), so paging through the whole+catalogue returns every plugin exactly once.```bashcurl -s 'https://three.ws/api/plugins/list?sort=az&limit=2' | jq '.data.items[].identifier'@@ -5695,8 +5697,10 @@ metadata ranges are refused (`400`, `validation_error`). The transfer is cappedat 64 KB and aborted mid-stream if the host exceeds it (`422`, `fetch_failed`).**Errors:** `400` (missing / unparseable / non-http `manifest_url`, blocked-host), `422` (`fetch_failed` for a non-2xx, unparseable, or oversized response;-`invalid_manifest` when the JSON is not a manifest), `429`.+host), `422` (`fetch_failed` for a non-2xx or oversized response;+`invalid_manifest` when the response is not JSON at all, which is what linking a+repository page instead of the raw file produces, or when the JSON is not a+manifest), `429`.### Publish a plugin@@ -5727,11 +5731,17 @@ reads to you. Responds with the same plugin shape the list returns.**Manifest rules:** `identifier` is required, alphanumeric plus `.`, `-`, `_`,and at most 128 characters; `meta.title` is required; `api` must be a non-empty-array of at most 100 tools, each with a `name` and a `description`. A violation-is a `422` (`invalid_manifest`) naming the specific rule.+array of at most 100 tool objects. Each tool needs a `name` of 1 to 64 letters,+digits, underscores, or hyphens (the charset every model provider accepts for a+tool definition, since installers pass these straight through) and a non-empty+`description` of at most 1024 characters. The whole manifest must serialize to+64 KB or less, the same ceiling the import fetch enforces, because it is stored+verbatim and re-served on every read. A violation is a `422`+(`invalid_manifest`) naming the specific rule.**Errors:** `401` (no auth), `403` (`csrf_missing` / `csrf_invalid`), `400`-(malformed body), `422` (`invalid_manifest`), `429`.+(malformed body), `413` (body over the manifest ceiling), `422`+(`invalid_manifest`), `429`.---diff --git a/docs/avatar-thumbnails.md b/docs/avatar-thumbnails.mdindex ea5ec638e..d7b0a8ce1 100644--- a/docs/avatar-thumbnails.md+++ b/docs/avatar-thumbnails.md@@ -199,8 +199,19 @@ node --env-file=.env.local scripts/backfill-avatar-thumbnails.mjs --limit=2000 -node --env-file=.env.local scripts/backfill-avatar-thumbnails.mjs --restyle=200 --limit=200```-Requires `DATABASE_URL` and the `S3_*` credentials, both of which live in-`.env.local`.+Requires `DATABASE_URL` plus the `S3_*` credentials (`S3_BUCKET`,+`S3_ACCESS_KEY_ID`, `S3_SECRET_ACCESS_KEY`, `S3_ENDPOINT`, `S3_PUBLIC_DOMAIN`).+Only `DATABASE_URL` is in `.env.local`; the authoritative copy of the `S3_*` set+lives on the Cloud Run service, so `--env-file=.env.local` alone exits with+`S3_BUCKET is unset`. Export them into the shell first:++```bash+eval "$(gcloud run services describe three-ws-api --region us-central1 \+ --project aerial-vehicle-466722-p5 --format=json \+ | node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{for(const e of JSON.parse(s).spec.template.spec.containers[0].env||[])if(e.name.startsWith("S3_")&&e.value)console.log(`export ${e.name}=${JSON.stringify(e.value)}`)})')"+```++Then any of the commands above runs as written.## Rendering a thumbnail yourselfdiff --git a/docs/aws-builder-center-agent-payment-sessions.md b/docs/aws-builder-center-agent-payment-sessions.mdindex dff253fcc..c52779739 100644--- a/docs/aws-builder-center-agent-payment-sessions.md+++ b/docs/aws-builder-center-agent-payment-sessions.md@@ -79,6 +79,7 @@ create table if not exists payment_sessions (max_per_tx_usdc bigint check (max_per_tx_usdc > 0),allowed_hosts text[] not null default '{}',network text not null default 'solana' check (network in ('solana', 'base')),+ connector_ref text,status text not null default 'active'check (status in ('active', 'exhausted', 'expired', 'cancelled')),@@ -96,11 +97,16 @@ Three details in there are load-bearing.**Money is `bigint`, never `float`.** USDC has six decimals, so every amount is stored in atomic units and converted at the edges. A rounding error in a budget check is a security bug, not a display bug.```js+// USDC has 6 decimals everywhere we settle (Solana mainnet and Base mainnet).+export const USDC_DECIMALS = 6;+const USDC_SCALE = 10 ** USDC_DECIMALS;+export function usdToAtomics(usd) {- return BigInt(Math.round(Number(usd) * 1_000_000));+ return BigInt(Math.round(Number(usd) * USDC_SCALE));}+export function atomicsToUsd(atomics) {- return Number(atomics) / 1_000_000;+ return Number(atomics) / USDC_SCALE;}```@@ -177,13 +183,22 @@ Now the policy runs, in order, cheapest and most decisive first: status, then exThe allowlist check is the one worth showing, because the subdomain rule is where these go wrong:```js-const canonicalAllowlist = allowedHosts.map(normalizeHost).filter(Boolean);-const allowed = canonicalAllowlist.some(- (h) => targetHost === h || targetHost.endsWith(`.${h}`),-);+export function canonicalizeAllowlist(allowedHosts) {+ if (!Array.isArray(allowedHosts)) return [];+ return allowedHosts.map(normalizeHost).filter(Boolean);+}++export function hostMatches(targetHost, entry) {+ if (!targetHost || !entry) return false;+ return targetHost === entry || targetHost.endsWith(`.${entry}`);+}```-`targetHost.endsWith('.' + h)` and not `targetHost.endsWith(h)`. Without the dot, an allowlist entry of `example.com` also authorizes `evil-example.com`, and an attacker who can steer your agent to a URL just needs to register the right domain. Hosts are normalized through the URL parser first, so `HTTPS://Example.COM:443/x` and `example.com` compare equal.+The verdict is then `canonical.some((entry) => hostMatches(targetHost, entry))`.++`targetHost.endsWith('.' + entry)` and not `targetHost.endsWith(entry)`. Without the dot, an allowlist entry of `example.com` also authorizes `evil-example.com`, and an attacker who can steer your agent to a URL just needs to register the right domain. That is exactly why this is a named function with a test behind it rather than an inline `endsWith`. Hosts are normalized through the URL parser first, so `HTTPS://Example.COM:443/x` and `example.com` compare equal.++These predicates live in [`api/_lib/pay/policy.js`](https://github.com/nirholas/three.ws/blob/main/api/_lib/pay/policy.js) and are shared with the dry-run simulator, so a simulated verdict and an enforced one can never disagree.### Phase 3: the atomic reservation@@ -220,18 +235,25 @@ Row-level locking means the second `UPDATE` re-evaluates its `WHERE` clause agai```jsif (!updated) {+ // Could be exhausted mid-race; check to give a precise errorconst [fresh] = await sql`SELECT budget_usdc, spent_usdc FROM payment_sessions WHERE id = ${session.id}`;const remaining = fresh ? BigInt(fresh.budget_usdc) - BigInt(fresh.spent_usdc) : 0n;- throw new SpendGovernorError(- 'insufficient_budget',- `Insufficient session budget. Need $${atomicsToUsd(amount)}, remaining $${atomicsToUsd(remaining)}`,- { need_usd: atomicsToUsd(amount), remaining_usd: atomicsToUsd(remaining) },+ // The SQL predicate already decided; budgetVerdict only phrases the failure,+ // using the same wording the simulator shows for a predicted shortfall.+ throwVerdict(+ budgetVerdict(amount, remaining) ?? {+ code: 'insufficient_budget',+ message: 'Session was not active when the payment was reserved',+ detail: { need_usd: atomicsToUsd(amount), remaining_usd: atomicsToUsd(remaining) },+ },);}```+`throwVerdict` raises a `SpendGovernorError` carrying the machine-readable `code` the API layer maps to a status (`insufficient_budget` becomes a `402`).+No advisory locks, no transaction retry loop, no distributed lock service. One statement whose `WHERE` clause is the invariant. If you take one thing from this article, take this: **write the budget check as a predicate in the `UPDATE`, not as a `SELECT` before it.**Note that this is a *reservation*, taken before the payment is attempted. Optimistic ordering, because the alternative is holding budget open across a network call to a third party.@@ -395,15 +417,25 @@ It gets back the result it wanted plus the receipt it did not ask for: amount, nA budget is debited from the developer's credit balance the moment the session is created, which means an expiry that just marks a row `expired` quietly keeps their money. A sweep runs every five minutes and refunds the difference:```js-const allExpired = await sql`- UPDATE payment_sessions+const expiredRows = await sql`+ WITH due AS (+ SELECT id FROM payment_sessions+ WHERE status = 'active'+ AND expires_at < now()+ ORDER BY expires_at ASC+ LIMIT ${BATCH_LIMIT}+ FOR UPDATE SKIP LOCKED+ )+ UPDATE payment_sessions sSET status = 'expired', updated_at = now()- WHERE status = 'active'- AND expires_at < now()- RETURNING id, user_id, budget_usdc, spent_usdc+ FROM due+ WHERE s.id = due.id+ RETURNING s.id, s.user_id, s.budget_usdc, s.spent_usdc`;```+The batch limit lives inside the `UPDATE` rather than in a JS slice of the result, and that is not a detail. An unbounded `UPDATE` flips every due session to `expired` while only the sliced head is ever refunded, and the remainder is then invisible to the next tick, which only looks at `status = 'active'`. Whatever this tick does not claim stays active and is swept next time. `FOR UPDATE SKIP LOCKED` keeps concurrent ticks on disjoint rows.+Then, per row, with an idempotency key derived from the session id so overlapping ticks cannot double-refund:```js@@ -435,12 +467,12 @@ An autonomous agent with a private key is a liability you cannot bound. An auton## Resources-- **Source:** [`api/pay/execute.js`](https://github.com/nirholas/three.ws/blob/main/api/pay/execute.js) is the request path, [`api/_lib/pay/spend-governor.js`](https://github.com/nirholas/three.ws/blob/main/api/_lib/pay/spend-governor.js) is the governor, [`api/_lib/pay/payment-session.js`](https://github.com/nirholas/three.ws/blob/main/api/_lib/pay/payment-session.js) is the lifecycle+- **Source:** [`api/pay/execute.js`](https://github.com/nirholas/three.ws/blob/main/api/pay/execute.js) is the request path, [`api/_lib/pay/spend-governor.js`](https://github.com/nirholas/three.ws/blob/main/api/_lib/pay/spend-governor.js) is the governor, [`api/_lib/pay/policy.js`](https://github.com/nirholas/three.ws/blob/main/api/_lib/pay/policy.js) holds the shared policy predicates, [`api/_lib/pay/payment-session.js`](https://github.com/nirholas/three.ws/blob/main/api/_lib/pay/payment-session.js) is the lifecycle, and [`api/cron/payment-session-sweep.js`](https://github.com/nirholas/three.ws/blob/main/api/cron/payment-session-sweep.js) is the expiry-and-refund sweep- **MCP server:** [`@three-ws/agentcore-payments-mcp`](https://github.com/nirholas/three.ws/tree/main/packages/agentcore-payments-mcp)- **x402:** [x402.org](https://www.x402.org), the HTTP-native pay-per-call standard the payments settle over- **Model Context Protocol:** [modelcontextprotocol.io](https://modelcontextprotocol.io)-- **Our previous Builder Center article:** [How we metered a SaaS product through AWS Marketplace with the AWS SDK for JavaScript v3](https://builder.aws.com/content/3ESpll50BdSp9eiCEIxcfG9pGUN/how-we-metered-a-saas-product-through-aws-marketplace-with-the-aws-sdk-for-javascript-v3), which covers the other half of this: how the credits that fund a session get billed to an AWS invoice+- **Our previous Builder Center article:** [How we metered a SaaS product through AWS Marketplace with the AWS SDK for JavaScript v3](https://builder.aws.com/content/3ESpll50BdSp9eiCEIxcfG9pGUN/how-we-metered-a-saas-product-through-aws-marketplace-with-the-aws-sdk-for-javascript-v3), which covers the other half of this: how an AWS Marketplace subscription resolves into the same access check that grants a session----*three.ws is a verified AWS Partner and an open-source platform for 3D AI agents and on-chain communities, available on AWS Marketplace with AWS billing wired into its metered API. Live at [three.ws](https://three.ws).*+*three.ws is a verified AWS Partner and an open-source platform for 3D AI agents and on-chain communities, with an AWS Marketplace listing built and awaiting publication. Live at [three.ws](https://three.ws).*diff --git a/docs/aws-builder-center-marketplace-x402.md b/docs/aws-builder-center-marketplace-x402.mdindex 3071570b5..b1de3d310 100644--- a/docs/aws-builder-center-marketplace-x402.md+++ b/docs/aws-builder-center-marketplace-x402.md@@ -13,6 +13,8 @@ tags: [aws, marketplace, saas, serverless, api]# One paywall, two economies: putting AWS Marketplace metering in front of an x402 API+> **Editor's note (2026-08-15).** This is the repo copy of an article published on the AWS Builder Center on 30 May 2026, kept as it was published. One thing has moved since: the AWS Marketplace listing is still awaiting publication, and the pricing decision landed on a **free** listing with no AWS pricing dimensions, so the AWS-metered path described below is built and deployed but not yet billing anyone. Every code sample is still the code that ships. For the current status see [aws-marketplace.md](./aws-marketplace.md).+We run [three.ws](https://three.ws), an open-source platform for 3D AI agents and on-chain communities. Our paid API already had a billing system: **x402**, the HTTP-native pay-per-call protocol where a request to a metered endpoint either carries a subscription key or gets a `402 Payment Required`. That works great for developers who pay in stablecoins.But a lot of teams don't want to touch crypto to pay an invoice. They want it on their AWS bill — drawn down from credits, counted toward their EDP commitment, one line item under *AWS Marketplace Software*. So we listed three.ws as a **SaaS usage-based product on AWS Marketplace** and wired AWS billing straight into the same access check that already powered x402.diff --git a/docs/aws-builder-center-mcp-agents.md b/docs/aws-builder-center-mcp-agents.mdindex f6d903d7e..41fcf79ee 100644--- a/docs/aws-builder-center-mcp-agents.md+++ b/docs/aws-builder-center-mcp-agents.md@@ -44,14 +44,16 @@ The OAuth flow is the textbook one: dynamic client registration (RFC 7591), PKCE## Surface two: paid tools that pay for themselves-This is the part I am most proud of. The npm package `@three-ws/mcp-server` exposes a suite of paid tools that take **no subscription and no API key**. Each call settles per-use in USDC over the x402 protocol (the HTTP 402 Payment Required status code, finally put to work). You configure a wallet address, not a key.+This is the part I am most proud of. The npm package `@three-ws/mcp-server` exposes a suite of paid tools that take **no subscription and no API key**. Each call settles per-use in USDC over the x402 protocol (the HTTP 402 Payment Required status code, finally put to work). You configure a wallet address, not a key. Settlement is USDC on Solana mainnet, `exact` scheme.++Four of the paid tools, to give the shape of the suite (the [package README](https://github.com/nirholas/three.ws/blob/main/mcp-server/README.md) carries the full list and the current prices, which come straight from each tool's source):| Tool | Price | What it returns ||---|---|---|| `get_pose_seed` | $0.001 | A deterministic seed and full Euler-rotation pose map for the pose-studio mannequin, plus a preview URL. || `pump_snapshot` | $0.005 | A live token snapshot: USD price (Jupiter), 24h volume and pair (Dexscreener), mint metadata and image, and on-chain top-holder distribution (Solana RPC). || `agent_reputation` | $0.01 | ERC-8004 on-chain reputation for an agent: score, total stake, and the latest reputation events from the canonical registry (default Base). |-| `vanity_grinder` | up to $0.50 | A Solana keypair whose address starts with a prefix you choose. Settled USDC scales with the work actually done, capped at $0.50. |+| `vanity_grinder` | $0.05 | A Solana keypair whose address starts with a prefix you choose. A flat `exact` settlement regardless of how many attempts the grind took: `@x402/svm` ships no metered `upto` scheme, so Solana bills one price per successful grind. |Setup is a wallet, not an account:@@ -62,7 +64,6 @@ Setup is a wallet, not an account:"command": "npx","args": ["-y", "@three-ws/mcp-server"],"env": {- "MCP_EVM_PAYMENT_ADDRESS": "0xYourBaseWallet","MCP_SVM_PAYMENT_ADDRESS": "YourSolanaWallet"}}@@ -91,7 +92,7 @@ The npm package is a stdio-to-HTTP bridge. It speaks MCP over stdio to the clien## Where AWS comes in-The platform stores its assets on S3-compatible object storage and is available to subscribe through AWS Marketplace, so usage lands on your AWS bill and counts toward existing commitments (the Marketplace metering integration calls AWS in `us-east-1`). three.ws is an AWS Partner (APN Software Path, Technology Partner).+The platform stores its assets on S3-compatible object storage, and its AWS Marketplace listing is built and awaiting publication, so procurement can go through AWS instead of a new vendor relationship (the Marketplace integration calls AWS in `us-east-1`). The subscription itself is free and issues the API key; the paid tools still settle per call in USDC. three.ws is an AWS Partner (APN Software Path, Technology Partner).The MCP server itself is intentionally cloud-agnostic: it is an npm bridge to an HTTP API, so it drops into a Bedrock agent, a Strands agent, a Claude Code session, or anything else that speaks MCP, without caring where the agent runs. If you are building agentic systems on AWS and want them to use paid external tools without a human managing keys, this is a working pattern you can copy.@@ -105,4 +106,4 @@ If you wire it into something, or you want to list a paid tool of your own, the----*three.ws is an open-source platform for 3D AI agents and on-chain communities, an AWS Partner and available on AWS Marketplace. Live at [three.ws](https://three.ws).*+*three.ws is an open-source platform for 3D AI agents and on-chain communities, an AWS Partner with an AWS Marketplace listing built and awaiting publication. Live at [three.ws](https://three.ws).*diff --git a/docs/aws-marketplace.md b/docs/aws-marketplace.mdindex 95e3bb36e..aa7b82a14 100644--- a/docs/aws-marketplace.md+++ b/docs/aws-marketplace.md@@ -1,9 +1,13 @@# three.ws on AWS Marketplace-three.ws is a verified AWS Partner and listed on AWS Marketplace as an API-based (SaaS) product. The AWS subscription is a **free front door**: subscribing links your AWS account to a three.ws account and issues an x402 access key. Actual usage is then paid per-call in USDC over the x402 / HTTP 402 protocol — the same as every other x402 endpoint. AWS Marketplace itself does not meter or bill usage.+three.ws is a verified AWS Partner. The AWS Marketplace product is an API-based (SaaS) listing, and the AWS subscription is a **free front door**: subscribing links your AWS account to a three.ws account and issues an x402 access key. Actual usage is then paid per-call in USDC over the x402 / HTTP 402 protocol, the same as every other x402 endpoint. AWS Marketplace itself does not meter or bill usage.++> **Listing status (checked 2026-08-15): not yet public.** Every endpoint described below is built and deployed, but the product has not been created in the AWS Marketplace Management Portal, so there is nothing to subscribe to on the AWS side yet. The Marketplace credentials (`AWS_MP_*`) are correspondingly unset in production, so `POST /api/aws-marketplace/subscription` answers `503 not_configured` today. The remaining steps are AWS-console work and Seller Operations approval, tracked in [aws-marketplace-listing-kit.md](./aws-marketplace-listing-kit.md). Until then, use x402 directly: no AWS subscription is required to call `/api/x402/*`.## Subscribing via AWS Marketplace+This is the flow once the listing is public.+1. Find the three.ws listing on [AWS Marketplace](https://aws.amazon.com/marketplace).2. Choose **Subscribe** — the AWS Marketplace subscription is free.3. After confirming in AWS, you are redirected to `https://three.ws/aws-marketplace/welcome` to complete account setup.@@ -12,7 +16,7 @@ three.ws is a verified AWS Partner and listed on AWS Marketplace as an API-based## Billing-The AWS Marketplace subscription is free — there are no AWS pricing dimensions, no contract, and no AWS-side metering. Usage is paid per-call in USDC via x402 (HTTP 402): every call returns a structured 402 challenge, your wallet or facilitator pays in USDC, and the request retries automatically. This is identical to how a non-AWS caller pays, so there is nothing to reconcile on your AWS invoice.+The AWS Marketplace subscription is free: there are no AWS pricing dimensions, no contract, and no AWS-side metering. Usage is paid per-call in USDC via x402 (HTTP 402): every call returns a structured 402 challenge, your wallet or facilitator pays in USDC, and the request retries automatically. This is identical to how a non-AWS caller pays, so there is nothing to reconcile on your AWS invoice.## AWS accountdiff --git a/docs/aws-partner-spotlight.md b/docs/aws-partner-spotlight.mdindex 6b61d7045..19e27b7c0 100644--- a/docs/aws-partner-spotlight.md+++ b/docs/aws-partner-spotlight.md@@ -2,7 +2,7 @@title: "three.ws on AWS: giving AI agents a body, a wallet, and an AWS bill"venue: AWS Builder Center / APN Partner Spotlightaccount: three.ws (official)-description: "A look at three.ws, an AWS Technology Partner building browser-native 3D AI agents that you can buy through AWS Marketplace, govern before they act, embed like a video, and let pay for their own work, all on infrastructure that meters to your AWS bill."+description: "A look at three.ws, an AWS Technology Partner building browser-native 3D AI agents that you will buy through AWS Marketplace, govern before they act, embed like a video, and let pay for their own work."tags: [aws, marketplace, agentic-ai, generative-ai, 3d, open-source]canonical: https://three.ws/docs/aws-partner-spotlight.md---@@ -13,7 +13,7 @@ Most enterprise AI agents live inside a chat box. For a lot of work that is exac[three.ws](https://three.ws) is built on a simple thesis: the next interface for AI is spatial, embeddable, and able to act. The platform gives an AI agent a body. You describe an agent in a sentence, and in a few minutes it becomes a textured, rigged, talking 3D character. You give it a brain, optionally a wallet and an on-chain identity, and you drop it onto any web page with a single line of HTML, as easily as embedding a video. The agent renders right in the browser, holds a conversation, remembers across visits, reacts to the page around it, and when you let it, pays for the data and tools it needs to be useful.-three.ws is an **AWS Technology Partner in the AWS Partner Network** and is **live on AWS Marketplace**, so an enterprise can adopt all of this through procurement it already trusts. This is a look at what the team has built, what they are building next, and why running it with AWS makes embodied agents something a business can actually buy, govern, and put into production.+three.ws is an **AWS Technology Partner in the AWS Partner Network**, and the AWS Marketplace listing is built and awaiting publication, so an enterprise will be able to adopt all of this through procurement it already trusts. This is a look at what the team has built, what they are building next, and why running it with AWS makes embodied agents something a business can actually buy, govern, and put into production.---@@ -51,9 +51,9 @@ The throughline across all of it is a single, ambitious idea: an agent you can sthree.ws runs across several clouds, each carrying the work it is best at, and AWS carries the parts where its strengths matter most: storage and delivery of the 3D assets, a slice of the rendering, the operational visibility a serious platform needs, and, most importantly for an enterprise, procurement.-The platform is listed on **AWS Marketplace** as a usage-based product. That single fact changes how a business can adopt it. Instead of a separate vendor relationship and a new way to pay, an enterprise subscribes through the marketplace it already uses, and consumption shows up as one line item on the AWS bill, drawn from existing credits and counted toward existing commitments. No crypto and no card are required to get started. The finance and security teams see something familiar, and the builders get an agent platform without a procurement detour.+The platform is being listed on **AWS Marketplace** as an API-based (SaaS) product. That single fact changes how a business can adopt it. Instead of a separate vendor relationship and a new way to pay, an enterprise subscribes through the marketplace it already uses, and the subscription itself is free: it links the AWS account, issues an API key, and hands the builders an agent platform without a procurement detour. The finance and security teams see something familiar. (The listing is complete on our side and waiting on AWS publication; until it goes public, the same API is reachable directly.)-What makes this genuinely novel is what sits underneath. three.ws agents can already pay for tools on their own, by the call, over an open payment rail. The team connected that same rail to AWS Marketplace, so one product now bills two ways through the very same door. A large enterprise pays through AWS and sees a clean line item. An independent developer pays per call with stablecoins and needs no account at all. Both are reaching the identical capability. The choice of how to pay is theirs, and the platform meters whichever world the caller comes from. That is a clean, pay-for-what-you-use model that fits how enterprises actually want to adopt agentic AI: autonomous where it helps, bounded by policy, and auditable end to end.+What makes this genuinely novel is what sits underneath. three.ws agents can already pay for tools on their own, by the call, over an open payment rail. The team wired AWS Marketplace into the very same access check, so one product serves two economies through one door. An enterprise buyer arrives through AWS procurement. An independent developer pays per call with stablecoins and needs no account at all. Both reach the identical capability, and the platform recognizes whichever world the caller comes from without forking its authorization path. That is a clean, pay-for-what-you-use model that fits how enterprises actually want to adopt agentic AI: autonomous where it helps, bounded by policy, and auditable end to end.Running on AWS also brings the operational posture an enterprise expects. The team manages its AWS footprint as code, so the environment is reproducible and reviewable rather than hand-assembled. Activity is centralized where an AWS-native operations team already looks, so the people responsible for uptime and security can watch the platform with the tools they already trust. And the whole thing is grouped as a single application in the AWS console, with cost and operational views in one place.@@ -79,11 +79,11 @@ Voice and presence are getting deeper, with real-time spoken conversation, voice## In short-three.ws gives an AI agent a body, a memory, a personality, an identity, and the ability to act and pay, then makes it embeddable in a single line of HTML. AWS is what makes it adoptable at enterprise scale: a platform you can buy through AWS Marketplace, govern before it acts, watch with the tools you already run, and bill, by the call, to your AWS account, against the very same capability an independent developer reaches with no account at all.+three.ws gives an AI agent a body, a memory, a personality, an identity, and the ability to act and pay, then makes it embeddable in a single line of HTML. AWS is what makes it adoptable at enterprise scale: a platform you will buy through AWS Marketplace, govern before it acts, and watch with the tools you already run, reaching the very same capability an independent developer reaches with no account at all.-One product. Two ways to pay. One AWS bill.+One product. Two ways in. One authorization path.**Learn more**- Platform: [three.ws](https://three.ws)-- AWS Marketplace and procurement: `three.ws/docs/aws-marketplace.md`-- How agents reach and pay for tools: `three.ws/docs/x402.md`, `three.ws/docs/mcp.md`+- AWS Marketplace and procurement: [three.ws/docs/aws-marketplace](./aws-marketplace.md)+- How agents reach and pay for tools: [three.ws/docs/x402](./x402.md), [three.ws/docs/mcp](./mcp.md)diff --git a/docs/changelog.md b/docs/changelog.mdindex 60af8975b..6723d7ef6 100644--- a/docs/changelog.md+++ b/docs/changelog.md@@ -175,21 +175,25 @@ The CDN bundle is served from three.ws (Google Cloud Run + CDN). The URL includeThe CDN also maintains rolling channel aliases:-| URL pattern | Tracks |+Every channel is a directory holding the same file name, so only the path segment changes:++| URL | Tracks ||---|---|-| `[email protected]` | Exact version (immutable) |-| `[email protected]` | Latest `1.5.x` patch |-| `[email protected]` | Latest `1.x` minor |-| `agent-3d.js` | Latest stable (any version) |+| `https://three.ws/agent-3d/1.5.2/agent-3d.js` | Exact version (immutable) |+| `https://three.ws/agent-3d/1.5/agent-3d.js` | Latest `1.5.x` patch |+| `https://three.ws/agent-3d/1/agent-3d.js` | Latest `1.x` minor |+| `https://three.ws/agent-3d/latest/agent-3d.js` | Latest stable (any version) |**Recommendation:** Pin to a full `MAJOR.MINOR.PATCH` version in production. Upgrade intentionally after reviewing the migration notes for the target version.-Each versioned bundle ships with a `integrity.json` sidecar for [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) verification:+The immutable exact-version directory ships an `integrity.json` sidecar for [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) verification. The rolling channels deliberately have none, because their contents change:```-https://three.ws/agent-3d/1.5.1/integrity.json+https://three.ws/agent-3d/1.5.2/integrity.json```+The same SHA-384 hashes are published for every version at once in the CDN version index, `https://three.ws/agent-3d/versions.json`.+---## Smart Contract Versioning@@ -299,7 +303,7 @@ For contributors and maintainers. A release follows these steps:5. A GitHub Release is created from the tag with the changelog entry as the body.6. `npm run build:all` produces the platform bundle and the CDN library build.7. `npm run publish:lib` copies the CDN bundle into `dist/agent-3d/{version}/`, generates an `integrity.json` sidecar with SHA-384 hashes, updates the rolling channel aliases (`1.5`, `1`, `latest`), and writes a `versions.json` manifest.-8. The image is deployed to Google Cloud Run (`npm run build` then `npm run deploy:gcp`), which serves the updated `dist/` directory — including the CDN library build — from the `three-ws-api` service.+8. The image is deployed to Google Cloud Run with `npm run deploy:gcp:full`, which serves the updated `dist/` directory — including the CDN library build — from the `three-ws-api` service. That one command runs the full `build:gcp` chain and then `deploy:gcp`; a bare `npm run build` is not enough on its own, because the deploy gate checks `dist/` for the UMD library that `build:lib:full` and `publish:lib` put there.The SDK (`@three-ws/sdk`) is published to npm separately:diff --git a/docs/configuration.md b/docs/configuration.mdindex 2b62e9170..99121b4e3 100644--- a/docs/configuration.md+++ b/docs/configuration.md@@ -237,7 +237,7 @@ The three.ws avatar builder is an open-source 3D avatar editor (full body customAVATURN_API_KEY=xxxxx```-Sign up at [avaturn.me/developer](https://avaturn.me/developer).+Sign up through the [Avaturn developer docs](https://docs.avaturn.me/).#### `AVATURN_API_URL`**Optional.** Override for self-hosted or staging photo pipeline deployments. Defaults to `https://api.avaturn.me`.@@ -417,7 +417,7 @@ A **live configuration file** consumed at runtime by the Cloud Run server ([`ser}```-**Cron jobs** are declared here as the source of truth for the schedule (currently 103 entries); in production they are driven by **Google Cloud Scheduler**, each job hitting its `/api/cron/*` handler on the Cloud Run service:+**Cron jobs** are declared here as the source of truth for the schedule. Read the `crons` array itself for the current set rather than trusting a count quoted in prose. In production they are driven by **Google Cloud Scheduler**, each job hitting its `/api/cron/*` handler on the Cloud Run service:```json"crons": [diff --git a/docs/contributing.md b/docs/contributing.mdindex d0d8517f4..3c6690f3e 100644--- a/docs/contributing.md+++ b/docs/contributing.md@@ -166,7 +166,7 @@ npm run verify## Publishing MCP servers & standalone mirrors-Every MCP server package (any directory with both a `package.json` and a `server.json` — the 32 under `packages/*-mcp`, plus `packages/agent-sniper`, `mcp-server`, and `mcp-bridge`) ships to three destinations. All steps are idempotent and default to a safe dry run.+Every MCP server package ships to three destinations. The authoritative list is the `SERVERS` array at the top of `scripts/publish-mcp-servers.mjs`: the `packages/*-mcp` directories that carry both a `package.json` and a `server.json`, plus `packages/agent-sniper`, `mcp-server`, and `mcp-bridge`. Read that array rather than a count quoted here. All steps are idempotent and default to a safe dry run.**1. npm + the official MCP registry** (`registry.modelcontextprotocol.io`):@@ -277,7 +277,7 @@ Skills are the best way to extend three.ws without touching core code. A skill i4. **Write a `SKILL.md`** documenting what your skill does, what permissions it requires, and how to install it.-5. **Share it.** Post it in [GitHub Discussions](https://github.com/nirholas/three.ws/discussions), or list it on the platform's skill marketplace so agents can install it.+5. **Share it.** Open a [GitHub issue](https://github.com/nirholas/three.ws/issues/new) announcing it, or list it on the platform's skill marketplace so agents can install it.---@@ -313,8 +313,7 @@ Check [existing issues](https://github.com/nirholas/three.ws/issues) before open## Getting Help-- **[GitHub Discussions](https://github.com/nirholas/three.ws/discussions)** — design questions, architecture ideas, general "how does X work"-- **[GitHub Issues](https://github.com/nirholas/three.ws/issues)** — bug reports and concrete feature requests+- **[GitHub Issues](https://github.com/nirholas/three.ws/issues)**: bug reports, concrete feature requests, design questions, and general "how does X work". Discussions are not enabled on the repository, so issues are the one channel.Core team response times: typically 2-3 business days on GitHub. If a PR has been open for a week with no review, a polite bump on the PR is welcome.diff --git a/docs/deployment.md b/docs/deployment.mdindex 7d387b9c8..fb7dd80c4 100644--- a/docs/deployment.md+++ b/docs/deployment.md@@ -43,7 +43,7 @@ Point a reverse proxy / load balancer at the container, add your domain and TLS,## Required environment variables-Copy [`.env.example`](../.env.example) to `.env.local` for local work, and set the same variables on your host. On Cloud Run they live on the service (`gcloud run services update three-ws-api --region us-central1 --set-env-vars …`); on any other host, set them however that platform injects environment. Secret-type variables should be stored as secrets, not plaintext — and never trust a `vercel env pull` as a complete export, since it returns empty for secret-type vars.+Copy [`.env.example`](../.env.example) to `.env.local` for local work, and set the same variables on your host. On Cloud Run they live on the service (`gcloud run services update three-ws-api --region us-central1 --update-env-vars NAME=value`); on any other host, set them however that platform injects environment. Use `--update-env-vars`, which merges: `--set-env-vars` REPLACES the service's entire environment, so passing one key with it wipes every other variable the service had. Secret-type variables should be stored as secrets, not plaintext. Never trust a `vercel env pull` as a complete export, since it returns empty for secret-type vars.```bashcp .env.example .env.local@@ -110,14 +110,15 @@ Without Redis, rate limits run in-memory per serverless instance. This is fine f```env# Avatar builder — origin where the in-browser avatar builder iframe is hosted.-# Defaults to http://localhost:5173 in dev. Production deployments should host the-# character-studio/ workspace (it is a separate Vite/React app) and point this env-# var at its origin. Same export contract, same humanoid rig, open-source-# and self-hostable.-VITE_CHARACTER_STUDIO_URL=https://studio.three.ws+# LEAVE THIS UNSET for a normal deployment. When unset it resolves SAME-ORIGIN to+# <your origin>/avatar-studio, where the build already ships the character-studio/+# bundle (the Vite dev middleware serves character-studio/build there in dev).+# Set it only to point at a standalone studio dev server while developing+# character-studio/ itself, e.g. http://localhost:5173.+# VITE_CHARACTER_STUDIO_URL=http://localhost:5173# Photo-to-avatar pipeline-# Get key at https://avaturn.me/developer+# Get key through the Avaturn developer docs: https://docs.avaturn.me/AVATURN_API_KEY=AVATURN_API_URL=https://api.avaturn.meVITE_AVATURN_EDITOR_URL=https://editor.avaturn.me/@@ -354,7 +355,7 @@ The embed routes explicitly set `frame-ancestors *` so the embed iframe can be h### Background cron jobs-The `crons` array in `vercel.json` declares every scheduled job (100 at time of writing: economy tick, on-chain crawl, delegation indexing, DCA, subscriptions, coin-launch lifecycle, treasury top-ups, and more). That array is the authoritative count; read it rather than trusting a number quoted in prose. In production these run as **Google Cloud Scheduler jobs** (one per entry) each firing `GET /api/cron/<name>` with an `Authorization: Bearer $CRON_SECRET` header. A representative slice:+The `crons` array in `vercel.json` declares every scheduled job (economy tick, on-chain crawl, delegation indexing, DCA, subscriptions, coin-launch lifecycle, treasury top-ups, and more). That array is the authoritative list and count; read it rather than trusting a number quoted in prose. In production these run as **Google Cloud Scheduler jobs** (one per entry) each firing `GET /api/cron/<name>` with an `Authorization: Bearer $CRON_SECRET` header. A representative slice:| Cron | Schedule | Purpose ||---|---|---|@@ -408,7 +409,7 @@ cp .env.example .env# Build and testforge build-forge test -vv # 25 tests across three contracts+forge test -vv # the full Solidity suite under contracts/test/# Dry run firstforge script script/Deploy.s.sol --rpc-url https://sepolia.base.orgdiff --git a/docs/embody.md b/docs/embody.mdindex e5920abfd..ed5e413d5 100644--- a/docs/embody.md+++ b/docs/embody.md@@ -25,7 +25,7 @@ Body:| Field | Required | Notes || ----- | -------- | ----- || `name` | yes | Display name, ≤64 chars. |-| `prompt` | one of | Text description of the body to generate. |+| `prompt` | one of | Text description of the body to generate, ≤600 chars. || `image_url` | one of | A reference image URL to reconstruct into 3D. Provide **exactly one** of `prompt` / `image_url`. || `personality` | no | Flavor text stored on the persona, ≤600 chars. || `voice` | no | A TTS voice id (see `GET /api/tts/voices`). Defaults to `nova`. |diff --git a/docs/examples.md b/docs/examples.mdindex a7704ebe4..80def323b 100644--- a/docs/examples.md+++ b/docs/examples.md@@ -735,7 +735,7 @@ genuinely invested in the user's progress.## Every runnable example in the repo-The repo ships 40 examples: 11 web component demos, 10 end-to-end projects, and 19 package example sets. This table is generated from what is on disk, so it cannot list one that was deleted or miss one that was added. The machine-readable version is [data/examples.json](../data/examples.json).+The repo ships 42 examples: 11 web component demos, 10 end-to-end projects, and 21 package example sets. This table is generated from what is on disk, so it cannot list one that was deleted or miss one that was added. The machine-readable version is [data/examples.json](../data/examples.json).### Example projects@@ -767,8 +767,10 @@ The repo ships 40 examples: 11 web component demos, 10 end-to-end projects, and| [`packages/pumpfun-mcp/examples`](../packages/pumpfun-mcp/examples) | Two runnable examples. Both spawn this package's own MCP server over stdio (the same node src/index.js entry point the README documents), speak real MCP JSON-RPC to it, and read live Solana mainnet data through the canonical three.ws backend. | `node packages/pumpfun-mcp/examples/list-tools.mjs` || [`sdk/example`](../sdk/example) | Ship a cross-chain 3D AI agent with EVM + Solana identity, a chat panel, and discoverable .well-known endpoints. | `npm run dev, then open /sdk/example/index.html` || [`packages/sign-language/example`](../packages/sign-language/example) | American Sign Language for 3D avatars. | `node packages/sign-language/example/compile-utterance.mjs` |+| [`packages/skill-license/example`](../packages/skill-license/example) | On-chain skill licenses for agents - each purchased skill is a 1/1 SPL NFT plus a deterministic SkillLicense PDA. Mint, verify, and read trustless skill access in one import, no database required. | `node packages/skill-license/example/verify-license.mjs` || [`tour-sdk/examples`](../tour-sdk/examples) | The guide walks from feature to feature across your real pages. | `npm run dev, then open /tour-sdk/examples/shopify-storefront.html` || [`packages/vanity-mcp/examples`](../packages/vanity-mcp/examples) | Two runnable examples. Both spawn this package's own MCP server over stdio (the same node src/index.js entry point the README documents), speak real MCP JSON-RPC to it, and read the live grind-bounty market. | `node packages/vanity-mcp/examples/list-tools.mjs` |+| [`packages/vision-mcp/examples`](../packages/vision-mcp/examples) | Two runnable examples. Both spawn this package's own MCP server over stdio (the same node src/index.js entry point the README documents), speak real MCP JSON-RPC to it, and hit the live three.ws vision pipeline. | `node packages/vision-mcp/examples/list-tools.mjs` || [`packages/x402-fetch/examples`](../packages/x402-fetch/examples) | Two runnable scripts against the live three.ws x402 Market Data API. Node 20+ is the only requirement; the package has zero production dependencies. | `node packages/x402-fetch/examples/discover.mjs` || [`packages/x402-mcp/examples`](../packages/x402-mcp/examples) | Two runnable examples. Both spawn this package's own MCP server over stdio (the same node src/index.js entry point the README documents), speak real MCP JSON-RPC to it, and hit live data. Neither one pays for anything. | `node packages/x402-mcp/examples/inspect-price.mjs` || [`x402-modal-sdk/examples`](../x402-modal-sdk/examples) | A drop-in payment modal for any x402 paid endpoint. | `node x402-modal-sdk/examples/server.mjs` |diff --git a/docs/ibm-x402-mcp.md b/docs/ibm-x402-mcp.mdindex 1c5daf3df..db20148fc 100644--- a/docs/ibm-x402-mcp.md+++ b/docs/ibm-x402-mcp.md@@ -292,8 +292,9 @@ forecast horizon as timestamped points.```jsonc{- "timestamps": ["2025-01-01T00:00:00Z", "2025-01-02T00:00:00Z", "..."],- "values": [12500, 13200, 0],+ // Both arrays are elided here. A real call sends at least 64 aligned points.+ "timestamps": ["2025-01-01T00:00:00Z", "2025-01-02T00:00:00Z" /* ...62 more */],+ "values": [12500, 13200 /* ...62 more */],"freq": "1D", // pandas-style: 1min, 5min, 1h, 1D, 1W, 1ME, ..."prediction_length": 14, // optional, 1–96; defaults to model horizon"label": "daily_revenue_usd" // optional, echoed back for traceabilitydiff --git a/docs/index.html b/docs/index.htmlindex d296e8833..132c8a111 100644--- a/docs/index.html+++ b/docs/index.html@@ -1117,6 +1117,23 @@return Boolean(target);}+ // Does /docs/<slug>.md exist? Used only to disambiguate a hash that named+ // neither a heading on this page nor a doc the sidebar manifest lists. A+ // HEAD keeps it to headers; a network failure answers "no", which lands+ // the reader exactly where the old code left them.+ const docExistsCache = new Map();+ function docExists(slug) {+ if (!docExistsCache.has(slug)) {+ docExistsCache.set(+ slug,+ fetch('/docs/' + slug + '.md', { method: 'HEAD' })+ .then(res => res.ok)+ .catch(() => false),+ );+ }+ return docExistsCache.get(slug);+ }+function buildSidebar(filter) {const q = (filter || '').toLowerCase();const current = currentPath();@@ -1187,6 +1204,19 @@}).join('');}+ // Strip a leading YAML frontmatter block. Several docs are article+ // drafts that carry one (title, venue, tags, canonical URL), and marked+ // has no concept of frontmatter: it reads the opening `---` as a+ // thematic break and the closing `---` as a setext underline, so the+ // whole YAML block renders as a giant <h2> above the article. Removing+ // it here fixes the rendered page and the "Copy page" markdown in one+ // place; the raw .md link still serves the file with its frontmatter+ // intact, which is what a reader asking for the source wants.+ const FRONTMATTER = /^?---\r?\n[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/;+ function stripFrontmatter(md) {+ return md.replace(FRONTMATTER, '');+ }+// marked/hljs arrive via deferred head scripts, so this must not run at// parse time; the boot below calls it once DOMContentLoaded guarantees// they have executed.@@ -1387,7 +1417,7 @@const url = '/docs/' + path + '.md';const res = await fetch(url);if (!res.ok) throw new DocLoadError(res.status);- const md = await res.text();+ const md = stripFrontmatter(await res.text());// Turn `figure:` directives into inert slots BEFORE parsing. Left as// <img src="figure:…">, the browser fires a request the moment the@@ -1520,23 +1550,39 @@// A cold load of /docs/<page>#<hash> is ambiguous. Usually the hash is// a heading on that page, which is why currentRoute() reads it that- // way. But the sidebar and the prev/next pager mint doc-path hashes,- // so the URL a reader copies after clicking one (for example+ // way. But every in-body cross-doc link is rewritten to a doc-path+ // hash, so the URL a reader copies after clicking one (for example// /docs/payment-sessions#custody) means "open the custody doc". When// the hash matches no heading here but does name a real doc, follow// it, and rewrite the address bar to that doc's own path so the link// is shareable the next time.- const routed = anchor && anchor !== path && ALL_PAGES.find(p => p.path === anchor);- if (routed && !scrollToAnchor(anchor)) {- history.replaceState(null, '', '/docs/' + routed.path);- // The served <head> still describes the page in the URL we arrived- // on, so the tab would name the wrong doc after this redirect.- document.title = 'Docs: ' + routed.label + ' · three.ws';- loadedPath = routed.path;- await loadPage(routed.path, '');- return;+ //+ // The sidebar manifest is NOT the test for "a real doc": it lists the+ // docs worth navigating to, not every doc that exists, and the body of+ // a doc routinely cites one it omits (financial-controls,+ // tutorials/pay-for-x402-service, agent-abilities/wallet/21-access).+ // Judging by the manifest alone stranded the reader on the page they+ // arrived from, with no error, for exactly those links. So fall back to+ // asking the server whether the doc is there. That costs one HEAD, and+ // only on the cold load that would otherwise have gone nowhere.+ const candidate = anchor && anchor !== path ? anchor : '';+ if (candidate && !scrollToAnchor(anchor)) {+ const listed = ALL_PAGES.find(p => p.path === candidate);+ if (listed || (await docExists(candidate))) {+ history.replaceState(null, '', '/docs/' + candidate);+ loadedPath = candidate;+ await loadPage(candidate, '');+ // The served <head> still describes the page in the URL we arrived+ // on, so the tab would name the wrong doc after this redirect.+ const label =+ (listed && listed.label) ||+ (document.querySelector('#docs-content h1') || {}).textContent ||+ candidate;+ document.title = 'Docs: ' + label.trim() + ' · three.ws';+ return;+ }}- if (!routed) scrollToAnchor(anchor);+ if (!candidate) scrollToAnchor(anchor);buildSidebar(document.getElementById('search-input').value);}diff --git a/docs/ops/gcp-credits.md b/docs/ops/gcp-credits.mdindex 6227e2499..a6429edac 100644--- a/docs/ops/gcp-credits.md+++ b/docs/ops/gcp-credits.md@@ -1376,13 +1376,18 @@ Live progress after the 2026-07-07 reauth:provisions its own publisher on the first real threshold crossing, so theend-to-end path does not depend on that manual grant; the synthetic-publish testabove already proves subscription → webhook.-- **BigQuery billing export: dataset pre-created.** `billing_export` (location `US`)- now exists in `aerial-vehicle-466722-p5` — the owner's remaining step is only to- **select it** in Billing → Billing export → BigQuery export (still console-only;- no gcloud/API path exists, confirmed this session). Once selected, BigQuery- auto-creates `gcp_billing_export_v1_01B467_A61905_9A97D2` and the burn report /- dashboard / cron begin reporting. `burn-report.mjs` currently degrades correctly- to "billing export table not found" against the empty dataset.+- **BigQuery billing export: dataset pre-created, export still not selected.**+ `billing_export` (location `US`) exists in `aerial-vehicle-466722-p5` and the+ service env now carries `GOOGLE_CLOUD_PROJECT`, `GCP_BILLING_DATASET` and+ `GCP_BILLING_ACCOUNT_ID`, so the config resolves a table name. The owner's+ remaining step is only to **select the dataset** in Billing → Billing export →+ BigQuery export (still console-only; no gcloud/API path exists, re-confirmed+ 2026-08-15). Until that click lands, `gcp_billing_export_v1_01B467_A61905_9A97D2`+ does not exist and every read of it returns a BigQuery 404. Both readers report+ that as the not-wired state and name the console step:+ `scripts/gcp/burn-report.mjs` exits 3 with the enable instruction, and the daily+ cron answers `{ok:true, configured:false, reason:"export_table_missing"}` and+ posts the deduped "billing export not wired" notice.- **Attribution labels: applied** (`label-resources.sh --apply`): all 9 Cloud Runservices + both buckets carry `program=gcp-credits` and a lane(`forge-gpu` for the model/editing workers, `platform` for agent-sniper /@@ -1405,14 +1410,16 @@ cron begins posting. Until then, per-lane app-side telemetry lives in theProgram budget targets for the alerts: Claude-on-Vertex $40-60k, GPUfleet $15–25k, Imagen $3–5k, vanity/observability/misc ~$5k.-**Two remaining owner actions to fully activate prompt-07 ops:**+**Two remaining owner actions to fully activate prompt-07 ops** (env state verified+on the `three-ws-api` Cloud Run service 2026-08-15, not Vercel):1. Billing → Billing export → BigQuery export → select the `billing_export` dataset- (already created); then set `GCP_BILLING_DATASET=billing_export`,- `GCP_BILLING_ACCOUNT_ID=01B467-A61905-9A97D2`, `GCP_CREDIT_TOTAL_USD=100000`,- `GCP_CREDIT_EXPIRY=<date>` in Vercel + `.env`.-2. Set `TELEGRAM_BOT_TOKEN` + `TELEGRAM_ALERTS_CHAT_ID` in Vercel prod so budget- alerts (subscription already delivering) and the daily cron actually ping the ops- chat instead of no-op'ing.+ (already created). `GCP_BILLING_DATASET`, `GCP_BILLING_ACCOUNT_ID` and+ `GCP_CREDIT_TOTAL_USD` are already set on the service; `GCP_CREDIT_EXPIRY` is+ not, so the projection reports runway without an expiry comparison until it is.+2. Set `TELEGRAM_ALERTS_CHAT_ID` on the service so budget alerts and the daily cron+ ping the private ops chat. `TELEGRAM_BOT_TOKEN` is already set, so alerts+ currently land in the `ops_alerts` dashboard sink only, which is the module's+ intended default rather than a fault._Spend-observability section last verified against source: 2026-07-07 (later session)._diff --git a/docs/oracle.md b/docs/oracle.mdindex 09f51528f..b036c7789 100644--- a/docs/oracle.md+++ b/docs/oracle.md@@ -201,6 +201,8 @@ A score you cannot audit is an opinion. Oracle grades itself in public, and theDuring a database outage the endpoint answers `503` rather than an empty record, so "no wins yet" can never be a dressed-up outage.+That rule is the whole Oracle read surface, not one endpoint. `/api/oracle/feed`, `/categories`, `/agent-stats`, `/follow`, `/movers`, `/signal`, `/stats`, `/history`, and the `/social` ingest all separate a connectivity failure from an ordinary SQL fault: the first propagates as `503` with a `Retry-After` and is never cached, the second still degrades to the documented empty answer. The distinction matters because these responses get CDN-cached for 60 to 120 seconds, so a blip lasting seconds used to pin "nothing is moving", "nobody is armed", or "no plays right now" on the product for minutes after the database recovered. `/api/oracle/og` follows the same rule in its own shape: a card built from a failed read still renders (a social scraper needs an image back), but it is served `no-store` so the next scrape re-reads a recovered database instead of caching "Not yet scored" on a Prime coin for 15 minutes. The contract is pinned in `tests/oracle/api-db-outage.test.js`.+**The realized-hit-rate calibration.** The fitted model answers "what fraction of launches like this one spike or graduate". A user reading a card wants "of the coins Oracle already scored at 99, how many actually won". Nothing reconciled those two, so a card reading conviction 99 quoted a training-label probability above 95 percent for a band that realized 26 percent. `scripts/oracle-calibrate.mjs` closes the gap: it measures the realized rug-aware win rate per score band over resolved production coins, smooths it into a monotone ladder with pool-adjacent-violators (isotonic regression), and writes `api/_lib/oracle/conviction-calibration.json`. `hitRateFor()` then serves that realized rate next to every score, and the public tier boundaries sit on the plateaus this fit exposes. Run it bare to fit and report, `--write` to update the shipped JSON. It reads the production database when `DATABASE_URL` is set and otherwise the live `/api/oracle/backtest`, which runs the same aggregation server-side, so neither path invents a number.**A third question: what the fleet actually banked.** `/api/cron/oracle-calibrate` (Cloud Scheduler) joins conviction to the fleet's *realized PnL* on mints it really traded, buckets by conviction band, and writes `oracle_calibration`. A win here is a positive realized PnL on a real fill, which is neither the trained event nor the site's rug-aware win: exit timing belongs to the fleet, so a gap between this table and `/api/oracle/backtest` is expected rather than a bug. Each band carries a bounded `correction_factor` (observed over claimed, clamped to 0.7-1.3, and pinned at 1.0 until the band has enough real trades). That factor is deliberately **not** written back onto the canonical `oracle_conviction` score: the calibration is measured against that score, so mutating it would feed into its own measurement and oscillate. It is exposed at `GET /api/oracle/calibration` and applied where it belongs, in the sniper optimizer's Rule O, which tunes each arm's entry threshold toward the band that realized wins.@@ -252,22 +254,29 @@ GET https://three.ws/api/oracle/signal?network=mainnet&min_score=72&limit=5GET https://three.ws/api/oracle/signal?mint=<mint>```-Returns the current highest-conviction plays, or one coin's verdict, each with the pillar breakdown, badges, and an explicit recommendation: action (buy, watch, skip), confidence, and a size factor (1.0 for prime, 0.75 for strong, 0 for everything else). Your agent multiplies the size factor by its own per-trade budget and it has a position size. The shape:+Returns the current highest-conviction plays, or one coin's verdict, each with the pillar breakdown, badges, and an explicit recommendation: action (buy, watch, skip), confidence, and a size factor (1.0 for prime, 0.75 for strong, 0 for everything else). Your agent multiplies the size factor by its own per-trade budget and it has a position size.++The list form answers `{ network, count, top, plays, generated_at }`: `plays` is the ranked array, `top` is `plays[0]` (or `null` when nothing clears `min_score`), and `count` is the array's length. The single-mint form answers `{ network, mint, signal, generated_at }` instead, carrying one verdict under `signal`. Both wrap the same play object:```json{"mint": "…", "symbol": "…","conviction": 88, "tier": "strong", "category": "ai",+ "smart_wallet_count": 4,"pillars": { "pedigree": 82, "structure": 88, "narrative": 80, "momentum": 90 },+ "badges": ["smart-money"],"recommendation": {"action": "buy", // buy | watch | skip"confidence": "medium", // high | medium | low"size_factor": 0.75, // 0 to 1 suggested sizing multiplier"note": "strong conviction, favorable across pedigree and structure"- }+ },+ "scored_at": "2026-08-14T06:42:47.867Z"}```+`count: 0` means the oracle sees no play clearing your `min_score` right now, and an agent should stand down. It never means the engine is down: a database outage answers 503 with a `Retry-After` rather than an empty board, so an empty `plays` array is always a real verdict.+Recommendations map from tier: prime to `buy/high/1.0`, strong to `buy/medium/0.75`, lean to `watch`, watch/avoid to `skip`. Reads are cached 3 seconds with stale-while-revalidate, so polling is cheap.### A minimal agent loop in JavaScript@@ -276,8 +285,8 @@ Recommendations map from tier: prime to `buy/high/1.0`, strong to `buy/medium/0.const API = 'https://three.ws/api/oracle/signal?network=mainnet&min_score=72&limit=5';async function tick(budgetSol) {- const { signals } = await fetch(API).then(r => r.json());- for (const s of signals || []) {+ const { plays } = await fetch(API).then(r => r.json());+ for (const s of plays || []) {const { action, size_factor } = s.recommendation;if (action !== 'buy') continue;const size = budgetSol * size_factor;@@ -308,7 +317,7 @@ GET https://three.ws/api/oracle/trades?mint=<mint>- Realized calibration per conviction band at `/api/oracle/calibration`: the fleet's actual win rate from real fills, next to what the band predicted, plus the bounded correction factor the scorer applies.- A dynamic 1200x630 OpenGraph conviction card (SVG) for sharing a coin at `/api/oracle/og`.-The write endpoints. Two are auth-scoped to the agent's owner: `GET·POST /api/oracle/watch` reads or arms an agent's watch config with server-side validation clamping every limit, and `POST /api/oracle/test-alert` sends a test alert. Two are public and IP rate-limited instead: `POST·DELETE /api/oracle/follow` subscribes a Telegram chat to an agent's signals (the chat id the caller supplies is the identity, so there is no session to scope to), and `POST /api/oracle/social` ingests tweets to additively boost virality (never downgrades an LLM read).+The write endpoints. Two are auth-scoped to the agent's owner: `GET·POST /api/oracle/watch` reads or arms an agent's watch config with server-side validation clamping every limit, and `POST /api/oracle/test-alert` sends a test alert. The clamps only ever move a number toward safety: a size above the ceiling is lowered, but arming `mode: "live"` with a `per_trade_sol` under the 0.001 SOL floor, or a `max_daily_sol` smaller than one trade, is a 400 rather than a silent round-up into real spending. Simulate runs keep the forgiving clamps. Two are public and IP rate-limited instead: `POST·DELETE /api/oracle/follow` subscribes a Telegram chat to an agent's signals (the chat id the caller supplies is the identity, so there is no session to scope to), and `POST /api/oracle/social` ingests tweets to additively boost virality (never downgrades an LLM read).### Through MCPdiff --git a/docs/payment-sessions.md b/docs/payment-sessions.mdindex b54f298df..f4da110f9 100644--- a/docs/payment-sessions.md+++ b/docs/payment-sessions.md@@ -313,8 +313,11 @@ What happens, in order:1. **Token check.** The token is verified against its stored hash.2. **Probe.** The endpoint is fetched (SSRF-guarded, 20 s timeout, redirects- not followed). If it responds with anything other than 402, you get the- response back with `"paid": false` and the session is not touched.+ not followed). If it answers with a success and no 402, the call was free:+ you get the response back with `"paid": false` and the session is not+ touched. If it answers with an error status and no 402, there was nothing to+ pay and nothing succeeded, so you get `502 endpoint_error` carrying the real+ `upstream_status` and `upstream_body`. The session is not touched either way.3. **Accept selection.** From the 402 challenge's `accepts[]`, the platformpicks a Solana USDC accept (the challenge must offer network `solana...`,asset USDC, and a `feePayer` in `extra`). Sessions created with@@ -390,6 +393,7 @@ Free endpoint (no 402 challenge):| 402 | `payment_rejected` | The service rejected the payment before settlement. | rolled back || 422 | `no_solana_accept`, `unsupported_asset`, `missing_fee_payer` | The challenge offers no payable Solana USDC option. | untouched || 502 | `endpoint_unreachable`, `invalid_challenge` | Could not reach the endpoint or parse its challenge. | untouched |+| 502 | `endpoint_error` | The endpoint answered an error status with no payment challenge. Carries `upstream_status` and `upstream_body`. | untouched || 502 | `build_failed` | Building the Solana transaction failed. | rolled back || 502 | `settle_uncertain` | Network failure after signing: chain state unknown. Do not retry immediately; check the session executions and wallet activity first. | kept reserved || 502 | `upstream_error` | The endpoint returned a non-402 error after payment. Check wallet activity before retrying. | kept reserved |diff --git a/docs/permissions.md b/docs/permissions.mdindex 218294876..5a28158dd 100644--- a/docs/permissions.md+++ b/docs/permissions.md@@ -233,7 +233,7 @@ curl -s 'https://three.ws/api/permissions/verify?hash=0x00&chainId=84532'| Method | Path | Auth | Description ||--------|------|------|-------------|| `POST` | `/api/permissions/grant` | Session cookie | Store a signed delegation + scope |-| `GET` | `/api/permissions/list` | Session cookie | List delegations (`?agentId=X&status=active`) |+| `GET` | `/api/permissions/list` | Public by `agentId`, session or bearer by `delegator` | List delegations (`?agentId=X&status=active`) || `POST` | `/api/permissions/revoke` | Session cookie | Mirror on-chain revocation to DB || `POST` | `/api/permissions/redeem` | Agent bearer token | Server-side redemption via relayer || `GET` | `/api/permissions/metadata` | Public (cached) | Public scope view for a given `agentId` |@@ -241,6 +241,26 @@ curl -s 'https://three.ws/api/permissions/verify?hash=0x00&chainId=84532'The `metadata` endpoint returns `{ ok, spec: "erc-7715/0.1", delegations: [...] }` with `Cache-Control: public` and `Access-Control-Allow-Origin: *` — it is safe to call from embed iframes.+### Retrying a relayer redemption safely++`POST /api/permissions/redeem` accepts an optional `Idempotency-Key` header. Send the same key when you retry a request whose response you never saw (a dropped connection, a client timeout) and the relayer replays the original `{ ok, txHash, receipt }` instead of broadcasting a second transaction:++```sh+curl -s -X POST https://three.ws/api/permissions/redeem \+ -H "authorization: Bearer $AGENT_TOKEN" \+ -H 'content-type: application/json' \+ -H 'idempotency-key: swap-run-42' \+ -d '{"id":"<delegation-uuid>","calls":[{"to":"0x1111111111111111111111111111111111111111","value":"0","data":"0xa9059cbb..."}]}'+```++What the key does and does not cover:++- **Scoped to the calling token's owner.** A replay only returns the cached result to the principal that made the original call. Another principal sending the same delegation id and key gets the normal ownership answer (`delegation_not_found`), never someone else's transaction hash.+- **Held in memory for 10 minutes**, per server instance. Treat it as a retry window for a request still in flight, not as a durable receipt store. After it lapses, or if the retry lands on a different instance, the request is redeemed again and the spend counts against `scope.maxAmount` a second time.+- **Only successful redemptions are cached.** A request rejected before submission (scope, expiry, ownership) leaves nothing behind, so fixing the request and retrying with the same key works.++Requests without the header are never deduplicated.+---## The DelegationManager contractdiff --git a/docs/plan-checkout.md b/docs/plan-checkout.mdindex 0b6af92c9..f70a9ec23 100644--- a/docs/plan-checkout.md+++ b/docs/plan-checkout.md@@ -87,6 +87,8 @@ The server verifies, at **finalized** commitment (reorg-safe):3. the treasury actually received ≥ the pinned amount of the right asset — SPL transfers are matched by instruction **and** by pre/post token-balance delta with an explicit mint check; native SOL by the recipient's lamport delta;4. one on-chain tx confirms at most one intent (unique index on `tx_hash`).+Both `checkout` and `confirm` take an optional `network` (`mainnet` by default). In production it is the only accepted value, on **both** endpoints: confirm picks the RPC it queries and the USDC mint it accepts from that field, so a mainnet-only checkout paired with a devnet-tolerant confirm would still settle a real plan against faucet USDC. `devnet` is accepted in non-production builds only, and `$THREE` is mainnet-only in every build.+On success, one atomic transaction claims the intent, upserts `subscriptions`, and sets `users.plan`.`tx_not_found` (422) usually means the tx hasn't finalized yet (~10–30 s) — retry; the built-in pricing UIs poll automatically. A payment sent just before the quote expired is still honored within a 1-hour grace window.@@ -117,4 +119,4 @@ On success, one atomic transaction claims the intent, upserts `subscriptions`, a| `SOLANA_RPC_URL` / `SOLANA_RPC_URL_DEVNET` | RPC endpoints — set a paid RPC in production || `SOLANA_USDC_MINT` | Override the USDC mint (defaults to mainnet USDC) |-Plan prices live in [api/payments/_config.js](../api/payments/_config.js) (`PLANS`) — the single source of truth; both pricing pages and the `plans` action read from it. The EVM (USDC-only) sibling path is [api/payments/evm/[action].js](../api/payments/evm/%5Baction%5D.js).+Plan prices live in [api/payments/_config.js](../api/payments/_config.js) (`PLANS`), the single source of truth: both pricing pages and the `plans` action read from it. The EVM (USDC-only) sibling path is [api/payments/evm/[action].js](../api/payments/evm/%5Baction%5D.js). It verifies the same way with two chain-specific differences: it waits for 12 confirmations before granting (EVM reorgs, versus Solana's `finalized` commitment), and because an ERC-20 transfer carries no memo it binds the payment to the account by requiring the payer address to be a wallet linked to that user. It honors the same 1-hour post-expiry grace window, which the confirmation wait makes necessary rather than merely kind.diff --git a/docs/reasoning-ledger.md b/docs/reasoning-ledger.mdindex d56e59646..9c73b2064 100644--- a/docs/reasoning-ledger.md+++ b/docs/reasoning-ledger.md@@ -37,6 +37,13 @@ The consequences, each detectable and pinpointed to a specific `seq`:That last check is the anchor: on a schedule, each agent's current chain head is written to Solana as a signed SPL-Memo transaction (kind `threews.ledger.v1`, recorded in `ledger_anchors`). Because the head commits to the whole prefix, anchoring one hash is a tamper proof for the entire history up to that point. Anchoring is best-effort by contract: without a funded attester key the commitment is recorded locally as pending, and the chain's cryptographic tamper-evidence holds regardless; only the independent on-chain timestamp is deferred.+Two very different things can leave a head un-anchored, and `/api/cron/reconcile-decisions` reports them apart:++- **`anchor_pending`**: no attester key is configured. Every agent's commitment is still recorded locally, and nobody is paged. This is the degraded mode described above.+- **`anchor_failed` + `anchor_outage`**: the memo was broadcast and rejected on-chain, for example when the attester wallet holds no SOL and every send comes back with `Attempt to debit an account but found no record of a prior credit`. That failure is identical for every agent in the run, so the tick stops after the first one, counts the rest under `anchor_skipped`, and raises an ops alert instead of re-simulating the same doomed transaction for every remaining agent, every ten minutes, in silence.++Fixing an `anchor_outage` means funding the `ATTEST_AGENT_SECRET_KEY` wallet; verification keeps working from the recomputed hash chain in the meantime, it just reports `unanchored` rather than `verified`.+## Verifying a ledger yourself```bashdiff --git a/docs/reputation-staking-market.md b/docs/reputation-staking-market.mdindex a7923ff35..c065bf367 100644--- a/docs/reputation-staking-market.md+++ b/docs/reputation-staking-market.md@@ -181,6 +181,31 @@ The funder needs roughly 0.02 SOL per run and is only ever debited to thethrowaway staker the run generates. If it is short, the proof says which accountholds how much and what it needs, rather than failing at a later stage.+### When there is no faucet and no funded keypair either++A local validator needs nothing external at all: `solana-test-validator` bundles+the same SPL Memo program the attestations and the settlement memo use, and it+airdrops without limit, so the whole contract runs offline.++```bash+solana-test-validator --reset --ledger /tmp/rsm-ledger &+solana-keygen new --no-bip39-passphrase --silent --outfile /tmp/rsm-funder.json+solana airdrop 20 "$(solana-keygen pubkey /tmp/rsm-funder.json)" --url http://127.0.0.1:8899++SOLANA_RPC_URL_DEVNET="http://127.0.0.1:8899/?cluster=devnet" \+REPUTATION_MARKET_PROOF_FUNDER_SECRET_KEY="$(cat /tmp/rsm-funder.json)" \+node scripts/reputation-market-proof.mjs+```++Two details in that command are load-bearing. The `?cluster=devnet` suffix is+how the RPC layer infers the cluster (`inferNetwork` in+[`api/_lib/solana/connection.js`](../api/_lib/solana/connection.js)); a bare+localhost URL reads as mainnet and would queue mainnet endpoints as fallbacks+behind it. And the funder rung is used rather than the faucet because+`requestAirdrop` confirms over a WebSocket subscription, which a local validator+serves on a port the derived URL does not point at; every other stage of the+proof confirms over HTTP polling and works untouched.+## HTTP surface| Endpoint | Method | Purpose |diff --git a/docs/seed-quality.md b/docs/seed-quality.mdindex 68edc884c..72c16b2f0 100644--- a/docs/seed-quality.md+++ b/docs/seed-quality.md@@ -45,6 +45,7 @@ forge flow already trusts, then applies catalog-specific bounds on top.| Reason | Meaning | Default bound || --- | --- | --- || `not_valid_glb` | The bytes are not a binary glTF 2.0 at all | - |+| `degenerate_triangles` | Almost no triangle geometry; renders as nothing | `FORGE_QUALITY_MIN_TRIS` = 80 || `vertices_below_floor` | Too coarse to look like anything | `SEED_GATE_MIN_VERTICES` = 1,500 || `vertices_above_ceiling` | Runaway output | `SEED_GATE_MAX_VERTICES` = 1,500,000 || `file_too_small` | Structurally empty | `SEED_GATE_MIN_BYTES` = 20,000 |diff --git a/docs/sign-language.md b/docs/sign-language.mdindex c7482a6e9..404355e5d 100644--- a/docs/sign-language.md+++ b/docs/sign-language.md@@ -45,7 +45,7 @@ If you have `prefers-reduced-motion` turned on, the page never auto-plays: signiThe **Avatar** setting's third pill (`Your avatar…`) opens the three.ws avatar gallery: your own avatars and every public one. Pick one and it takes the hero's place immediately, keeping the speed and signing hand you already set.-It works because signs are anatomy, not coordinates. A sign says "index fingertip on the chin", and the solver measures your avatar's skeleton to find where its chin is, so the same entry lands correctly on a tall rig, a short one, long fingers or small hands. Nothing about the vocabulary is per-avatar, which is also why the [clips retarget](#how-it-works) instead of being rebuilt.+It works because signs are anatomy, not coordinates. A sign says "index fingertip on the chin", and the solver measures your avatar's skeleton to find where its chin is, so the same entry lands correctly on a tall rig, a short one, long fingers or small hands. Nothing about the vocabulary is per-avatar, which is also why the [clips retarget](#part-3-how-it-works) instead of being rebuilt.Once picked, the avatar is remembered on that device and is already on stage on [/asl-alphabet](https://three.ws/asl-alphabet) too. Click its pill again to swap to a different one; the built-in pills switch back without a trip through the gallery.@@ -213,10 +213,13 @@ const clip = buildFingerspellingClip('HELLO', { marks });## Install it as a package-The whole engine ships as [`@three-ws/sign-language`](https://www.npmjs.com/package/@three-ws/sign-language) with **zero runtime dependencies**: no three.js, no DOM, no network. It compiles signing in a browser, in Node, or in a worker.+The whole engine is packaged as `@three-ws/sign-language` with **zero runtime dependencies**: no three.js, no DOM, no network. It compiles signing in a browser, in Node, or in a worker.++The registry publish is still queued, so `npm install @three-ws/sign-language` resolves to nothing today. Until it lands, install the package directory out of a clone of this repository; the import path and every export below are already the published ones:```bash-npm install @three-ws/sign-language+git clone https://github.com/nirholas/three.ws+npm install ./three.ws/packages/sign-language``````js@@ -249,9 +252,9 @@ curl -s "https://three.ws/api/sign?text=happy+to+meet+you" | jq '.timeline'"letters": [ { "letter": "T", "start": 1.64, "end": 2.14 },{ "letter": "O", "start": 2.14, "end": 2.64 } ] },{ "word": "MEET", "signed": true, "gloss": "Two upright index fingers come together.",- "start": 2.82, "end": 3.98, "letters": null },+ "start": 2.82, "end": 3.58, "letters": null },{ "word": "YOU", "signed": true, "gloss": "Index finger points at the person addressed.",- "start": 4.16, "end": 5.0, "letters": null }+ "start": 3.76, "end": 4.64, "letters": null }]```@@ -493,7 +496,7 @@ None of this replaces a human interpreter. It makes an avatar legible to signers1. **Captured signs**: clips from real signers (commissioned, community capture through [Motion Swap](https://three.ws/motion-swap), permissively licensed video) replacing authored entries word by word, through the same dictionary interface.2. **Word-level sign recognition**: the current recognizer reads fingerspelling; a 250-sign vocabulary model (MIT architecture retrained on the CC BY 4.0 PopSign corpus) will let common signs be recognized directly.3. **Review by Deaf signers**: the vocabulary is authored, not validated. Growing it past a core set should follow review and capture, not more authoring.-4. **Standalone package**: the engines are platform-free by design and will ship as an npm package plus reference integration.+4. **Standalone package on npm**: the engine is already packaged and installable from a clone ([Install it as a package](#install-it-as-a-package)); publishing `@three-ws/sign-language` to the public registry is what remains.## Relateddiff --git a/docs/smart-contracts.md b/docs/smart-contracts.mdindex e2b67c0e2..081ec6023 100644--- a/docs/smart-contracts.md+++ b/docs/smart-contracts.md@@ -16,6 +16,19 @@ All contracts are Solidity `^0.8.24`, compiled with the optimizer at 200 runs, aContracts are deployed at the same address on every supported EVM chain, using CREATE2 deterministic deployment. There are two address sets: mainnet and testnet.+> **The addresses below do not run this repository's source.** All three canonical registries are ERC-1967 proxies in front of the ERC-8004 **reference upgradeable** implementations. `contracts/src/*.sol` in this repo is a superset design that is deployed nowhere, so several members documented in the interface sections further down exist only if you deploy the repo contracts yourself. An `eth_call` sweep on 2026-08-15 against Base (8453) and Base Sepolia (84532) confirmed:+>+> | Member | Deployed registry | Repo source |+> |---|---|---|+> | `name`, `symbol`, `ownerOf`, `balanceOf`, `tokenURI`, `register`, `setAgentURI`, `setMetadata`, `setAgentWallet` | yes | yes |+> | `getMetadata`, `getAgentWallet`, `supportsInterface` | Base Sepolia only (the mainnet implementation is older) | yes |+> | `totalSupply`, `tokenOfOwnerByIndex` (ERC-721 Enumerable) | **no**, reverts | yes |+> | `isAgent`, `DOMAIN_SEPARATOR` | **no**, reverts | yes |+> | `deposit`, `withdraw`, `agentBalance`, `setSpendAllowance`, `spend` (ETH escrow) | **no**, reverts | yes |+> | every `ReputationRegistry` member documented below (`submitFeedback`, `getReputation`, `hasReviewed`, `getFeedbackCount`, `getFeedback`, `getFeedbackRange`, `stakeReputation`, `withdrawStake`) | **no**, reverts; the deployed reputation registry exposes the reference `readFeedback` / `getClients` interface instead | yes |+>+> Re-run the sweep before relying on any row: implementations sit behind upgradeable proxies and can change without the address changing. `contracts/DEPLOYMENTS.md` carries the per-chain liveness record.+### MainnetChains with confirmed bytecode: Ethereum (1), Optimism (10), BSC (56), Gnosis (100), Polygon (137), Mantle (5000), Base (8453), Arbitrum One (42161), Celo (42220), Avalanche (43114), Linea (59144), Scroll (534352).@@ -57,7 +70,7 @@ Vanity-prefixed CREATE2 deployer used to obtain matching addresses across chains| Base (8453) | `0x00000000D49195AE81759cd247cFeDD9D0B479df` | `0x4022de2D...C0564f402` || Arbitrum One (42161) | `0x00000000D49195AE81759cd247cFeDD9D0B479df` | `0x4022de2D...C0564f402` |-The 8-byte zero prefix (`0x00000000…`) saves calldata gas on every call. Source is `ThreeWSFactory.sol` (solc 0.8.35, optimizer 200 runs, MIT, verified on BscScan).+The 8-byte zero prefix (`0x00000000…`) saves calldata gas on every call. Source is [`contracts/ThreeWSFactory.sol`](../contracts/ThreeWSFactory.sol) (solc 0.8.35, optimizer 200 runs, MIT, verified on BscScan), with its test at `contracts/test/ThreeWSFactory.t.sol`.```solidityfunction deploy(bytes32 salt, bytes initCode) external returns (address);@@ -71,7 +84,9 @@ event Deployed(address indexed addr, bytes32 indexed salt);## IdentityRegistry-`IdentityRegistry` is the canonical on-chain registry for three.ws identities. Each agent is minted as an ERC-721 token; the token URI points to an ERC-8004 registration JSON (typically hosted on IPFS). The contract extends `ERC721Enumerable`, so all standard ERC-721 enumeration methods work.+`IdentityRegistry` is the canonical on-chain registry for three.ws identities. Each agent is minted as an ERC-721 token; the token URI points to an ERC-8004 registration JSON (typically hosted on IPFS).++This section describes `contracts/src/IdentityRegistry.sol`. It extends `ERC721Enumerable`, so on an instance you deploy yourself all standard ERC-721 enumeration methods work. The canonical deployed addresses run the reference implementation instead and expose no enumeration: see the deployment note above for exactly which members answer and which revert.### Registration@@ -180,20 +195,42 @@ SetAgentWallet(uint256 agentId, address newWallet, uint256 nonce, uint256 deadliDomain: `name = "ERC8004-IdentityRegistry"`, `version = "1"`.+### ETH escrow and spend delegation++Repo source only. An agent can hold ETH inside the registry, attributed per `agentId`, and its owner can authorize a spender (typically a delegated server key) to draw on that balance up to a cap. Bare transfers are rejected (`receive`/`fallback` revert with `DirectTransferRejected`) so ETH is always attributed to one agent rather than pooled.++```solidity+// Anyone may fund an agent; the balance is spendable only against that agent.+function deposit(uint256 agentId) external payable++// The NFT owner reclaims unspent deposits.+function withdraw(uint256 agentId, address payable recipient, uint256 amountWei) external++// The NFT owner caps what a spender may draw.+function setSpendAllowance(uint256 agentId, address spender, uint256 maxWei) external++// The spender pays out, bounded by both the allowance and the agent's own balance.+function spend(uint256 agentId, address payable recipient, uint256 amountWei, string calldata memo) external++// Public storage getters+function agentBalance(uint256 agentId) external view returns (uint256)+function spendAllowance(uint256 agentId, address spender) external view returns (uint256)+```++Emits `AgentDeposit`, `AgentWithdrawal`, `SpendAllowanceSet`, and `AgentPayment(agentId, spender, recipient, amountWei, memo)`. Additional errors: `ZeroDeposit`, `InsufficientAgentBalance`, `DirectTransferRejected`, `EthTransferFailed`, `ZeroRecipient`.+### Helpers```solidity-// Check whether an agentId exists-function isAgent(uint256 agentId) external view returns (bool)+// Standard ERC-721, present on every deployment+function balanceOf(address owner) external view returns (uint256)+function ownerOf(uint256 tokenId) external view returns (address)-// EIP-712 domain separator (useful for off-chain signature construction)+// Repo source only — these revert on the canonical deployed addresses+function isAgent(uint256 agentId) external view returns (bool)function DOMAIN_SEPARATOR() external view returns (bytes32)--// Standard ERC-721 Enumerablefunction totalSupply() external view returns (uint256)function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256)-function balanceOf(address owner) external view returns (uint256)-function ownerOf(uint256 tokenId) external view returns (address)```### Errors@@ -222,20 +259,33 @@ const registry = new ethers.Contract(const owner = await registry.ownerOf(42);const uri = await registry.tokenURI(42);-// List all agents owned by an address+// How many agents an address holdsconst balance = await registry.balanceOf('0xYourAddress');-const ids = [];-for (let i = 0; i < Number(balance); i++) {- ids.push(await registry.tokenOfOwnerByIndex('0xYourAddress', i));-}-// Check total registered agents-const total = await registry.totalSupply();+// Whether a given agentId is registered. ownerOf reverts for an unminted id,+// which is the portable existence check: isAgent() and totalSupply() are+// ERC721Enumerable/repo-source members and revert on the deployed registries.+const exists = await registry.ownerOf(42).then(() => true, () => false);+```++To list the ids an address owns, index the `Transfer` event rather than calling `tokenOfOwnerByIndex`. Public RPCs cap `eth_getLogs` at a 10,000-block range, so page it:-// Check whether a given agentId is registered-const exists = await registry.isAgent(42);+```js+const latest = await provider.getBlockNumber();+const STEP = 10_000;+const ids = new Set();+for (let to = latest; to > latest - 40_000; to -= STEP) {+ const events = await registry.queryFilter(+ registry.filters.Transfer(null, '0xYourAddress'),+ to - STEP + 1,+ to,+ );+ for (const e of events) ids.add(String(e.args.tokenId));+}```+Widen the window (or use an indexed provider) to cover the registry's full history rather than a recent slice.+### Registering from ethers.js```js@@ -278,6 +328,8 @@ await tx2.wait();## ReputationRegistry+**This section describes `contracts/src/ReputationRegistry.sol`, which is deployed nowhere.** The canonical `reputationRegistry` addresses run the ERC-8004 reference implementation, whose interface (`readFeedback`, `getClients`) shares no function with the one below: every call in this section reverts against them. Use it when you deploy the repo contracts yourself, and read the deployment note above before pointing it at a canonical address.+`ReputationRegistry` stores signed feedback about registered agents. Scores are integers in the range `[-100, 100]`: negative scores indicate poor experiences, positive scores indicate good ones. Each `(reviewer, agentId)` pair can only submit once; there is no update path. Agent owners cannot review their own agents. Alongside plain feedback, the contract also exposes an ETH-staked variant (`stakeReputation(uint256 agentId, uint8 score, string comment)` payable, refundable via `withdrawStake(uint256 agentId)`); `submitFeedback` is the path documented here.The registry holds a reference to `IdentityRegistry` — submitting feedback for an unregistered agentId reverts with `UnknownAgent`.diff --git a/docs/troubleshooting.md b/docs/troubleshooting.mdindex 17d07af78..c4778350b 100644--- a/docs/troubleshooting.md+++ b/docs/troubleshooting.md@@ -282,11 +282,11 @@ Organized by symptom. Find your problem, check the likely causes, follow the fix<agent-3d style="width: 100%; height: 50vh;" ...></agent-3d>```2. Avoid `display: inline` on the container — use `block` or `flex`.-3. For inline mode with automatic aspect ratio, add the `responsive` attribute:+3. For inline mode with automatic aspect ratio, set the **`width` attribute** and omit `height`. Responsive sizing is on by default, so there is no `responsive` attribute to add:```html- <agent-3d responsive style="width: 100%;" ...></agent-3d>+ <agent-3d mode="inline" width="320" ...></agent-3d>```- This sets `aspect-ratio: 3/4` and lets height follow width.+ The element then sets `aspect-ratio: 3/4` and height follows width. Two things switch it off: an explicit `height` attribute, and `responsive="false"`. A CSS-only width (`style="width:100%"`) does not engage it, because the element reads the `width` attribute, not the computed style.---@@ -574,7 +574,7 @@ The AR button is only shown after the GLB finishes loading. If the model is largAlmost always a model problem:-1. **File too large.** Quick Look on older devices struggles above ~15 MB. Compress textures and simplify geometry — see [model optimization](/docs/ar#model-size-and-compatibility).+1. **File too large.** Quick Look on older devices struggles above ~15 MB. Compress textures and simplify geometry — see [model optimization](ar.md#model-optimization-for-ar).2. **Draco-compressed GLB.** Quick Look doesn't include a Draco decoder — the file may load partially then fail. Decompress it: `npx @gltf-transform/cli optimize model.glb out.glb --no-draco`.3. **CORS missing on the model URL.** Quick Look fetches the file separately from the browser, and CORS failures are silent. Verify `Access-Control-Allow-Origin: *` is present on the response headers for the GLB URL.4. **USDZ conversion failed.** Check the browser console for errors *before* Quick Look opens — the in-browser USDZExporter logs any failures. A corrupt or oversize USDZ causes immediate dismissal.diff --git a/docs/tutorials/animate-your-agent.md b/docs/tutorials/animate-your-agent.mdindex 1d3be649e..29b0a4056 100644--- a/docs/tutorials/animate-your-agent.md+++ b/docs/tutorials/animate-your-agent.md@@ -91,7 +91,6 @@ curl -X PUT https://three.ws/api/agents/$AGENT_ID/animations \-H "authorization: Bearer $THREE_WS_TOKEN" \-H 'content-type: application/json' \-d '{- "animations": [],"animationSlots": {"dance": "av-offabean-dance","celebrate": "av-cheering",@@ -103,7 +102,9 @@ curl -X PUT https://three.ws/api/agents/$AGENT_ID/animations \Anything not listed keeps the platform default, so a map is only as long as the changes you want. `"animationSlots": {}` clears every override. The map is stored on the agent at `meta.edits.animations` and published on its public manifest as `animationSlots`, so an `<agent-3d>` embed of that agent plays its body language too.-Two things the endpoint will reject rather than silently accept: a slot name outside the vocabulary (a typo would create a gesture nothing ever plays) and a clip name that is not a plain name. `animations` is the agent's clip list and is required by that endpoint; send `[]` only if you do not use it, since the field replaces what is there.+Every field on that endpoint is optional and follows one rule: **present means replace this, absent means leave it alone.** Send `animationSlots` on its own and the agent's clip list, animation graph and choreographies are untouched. Do not pad the body with `"animations": []` to satisfy the schema, because an empty array is a real value and wipes the clip list. The body only has to carry at least one of `animations`, `animationGraph`, `animationSlots` or `choreographies`, or you get a `400`.++Two things the endpoint will reject rather than silently accept: a slot name outside the vocabulary (a typo would create a gesture nothing ever plays) and a clip name that is not a plain alphanumeric name.Any of the 112 clip names in [`/animations/manifest.json`](https://three.ws/animations/manifest.json) is valid. Browse them with previews at [three.ws/animations](https://three.ws/animations).@@ -154,7 +155,7 @@ The full attribute and method surface is in the [embedding guide](/docs/embeddin## 5. Player-driven gestures on /walk-There is a second gesture library for avatars a person is driving rather than an agent: open [three.ws/walk](https://three.ws/walk), move with `WASD`, and press `1`-`8` for a gesture.+There is a second gesture library for avatars a person is driving rather than an agent: open [three.ws/walk](https://three.ws/walk), move with `WASD`, and press `1`-`8` for a gesture. Those eight keys are `wave`, `dance`, `sit`, `point`, `cheer`, `agree`, `disagree` and `talking`, in that order. The library holds four more (`nod`, `shrug`, `jog`, `celebrate`) with no quick key: hold `G` for the gesture wheel, or call `window.walk.playGesture('shrug')`.The difference that matters is the layer. `wave`, `point`, `nod` and `shrug` are **upper-body overlays**: the legs keep the walk cycle, so your avatar waves while it walks. `dance`, `sit`, `jog` and `celebrate` are **full-body**, so movement is suppressed until they end. Try waving while walking, then dancing while walking, and the distinction is obvious in one second.diff --git a/docs/tutorials/animate-your-avatar.md b/docs/tutorials/animate-your-avatar.mdindex e9ae4adef..acc601c31 100644--- a/docs/tutorials/animate-your-avatar.md+++ b/docs/tutorials/animate-your-avatar.md@@ -36,7 +36,7 @@ The thing that makes the library work is that **motion and body are stored separ- An avatar is a **GLB** — geometry, skeleton, skin, textures.- A motion is a **clip JSON** — keyframe tracks only, no geometry. One clip can play on every avatar.-A clip's tracks are named against a **canonical skeleton** — a 53-bone humanoid set (`Hips → Spine → Spine1 → Spine2 → Neck → Head`, both arms `Shoulder → Arm → ForeArm → Hand` with finger chains, both legs `UpLeg → Leg → Foot → ToeBase`). Every clip in [public/animations/clips](../../public/animations/clips) is baked against the reference rig `public/avatars/cz.glb`.+A clip's tracks are named against a **canonical skeleton** — the 52-bone humanoid set exported as `CANONICAL_BONES` (`Hips → Spine → Spine1 → Spine2 → Neck → Head`, both arms `Shoulder → Arm → ForeArm → Hand` with finger chains, both legs `UpLeg → Leg → Foot → ToeBase`). Every clip in [public/animations/clips](../../public/animations/clips) is baked against the reference rig `public/avatars/cz.glb`.Your avatar almost certainly names its bones differently — `mixamorig:Hips`, `DEF-spine`, `J_Bip_C_Hips`, `pelvis`, `leftUpperArm`. Two runtime modules bridge that gap:@@ -100,7 +100,7 @@ The status line at the bottom of the stage confirms the retarget, e.g.:Playing "Cheering" — 96% retargeted (51/53 bones matched).```-That percentage is the coverage — how many of the clip's tracks found a home on your rig. A couple of dropped bones (often fingers a simpler rig lacks) is normal and fine. If coverage falls below 50%, the clip won't apply and the status explains why (see Troubleshooting).+That percentage is the coverage — how many of the clip's tracks found a home on your rig. (The counter is tracks, which the status line labels "bones": a full library clip carries 53 of them, one rotation track per canonical bone plus the hips' position track.) A couple of dropped bones (often fingers a simpler rig lacks) is normal and fine. If coverage falls below 50%, the clip won't apply and the status explains why (see Troubleshooting).Clips marked **once** play a single shot and hold the final frame; **loop** clips cycle until you stop them or pick another.@@ -169,7 +169,7 @@ This is the remix loop: find a motion someone else published, open it in the StuApplying clips in the Studio is the **authoring** side. On a *running* agent, the same library drives emotion and gesture automatically through two channels that share one emotional state — the avatar's **Empathy Layer** ([src/agent-avatar.js](../../src/agent-avatar.js)):-**Gesture slots** ([src/runtime/animation-slots.js](../../src/runtime/animation-slots.js)) — a fixed emotional vocabulary the agent plays in conversation: `idle`, `wave`, `nod`, `shake`, `think`, `celebrate`, `concern`, `bow`, `point`, `shrug`, `dance`. Each slot resolves to a concrete library clip at runtime (e.g. `celebrate` → the `celebrate` clip, `think` → `pray`). An agent picks a slot when the moment calls for it; the clip retargets onto that agent's avatar exactly as in the Studio. You can override any slot per agent via `meta.edits.animations` — point `wave` at a different clip, or map a slot to a motion you authored yourself.+**Gesture slots** ([src/runtime/animation-slots.js](../../src/runtime/animation-slots.js)) — a fixed vocabulary the agent plays in conversation. The conversational slots are `idle`, `wave`, `nod`, `shake`, `think`, `celebrate`, `concern`, `bow`, `point`, `shrug`, `fidget`, `dance`; a second group exists because skills emit the matching hint: `inspect`, `present`, `sign`, `curiosity`, `patience`, `manipulate`, `conjure`. Each slot resolves to a concrete library clip at runtime through `DEFAULT_ANIMATION_MAP` — most map to the clip of the same name (`celebrate` → `celebrate`, `think` → `think`), and a few borrow the closest baked motion where no dedicated clip exists yet (`concern` → `defeated`, `bow` → `sitclap`, `dance` → `rumba`). An agent picks a slot when the moment calls for it; the clip retargets onto that agent's avatar exactly as in the Studio. You can override any slot per agent via `meta.edits.animations` — point `wave` at a different clip, or map a slot to a motion you authored yourself.**Facial expression** ([src/runtime/arkit52.js](../../src/runtime/arkit52.js)) — driven from the same blend of morph targets as the gesture layer, not a separate track. If your avatar carries ARKit-52 blendshapes (most modern avatar-platform exports do, as do VRoid models), the runtime resolves those morph targets and drives expression and lip-sync directly on the face. A skeletal clip plays the body; the blendshape layer plays the eyes, brows, and mouth on top.diff --git a/docs/tutorials/arm-an-agent-sniper.md b/docs/tutorials/arm-an-agent-sniper.mdindex 3049c0520..45e1f8828 100644--- a/docs/tutorials/arm-an-agent-sniper.md+++ b/docs/tutorials/arm-an-agent-sniper.md@@ -66,14 +66,16 @@ That is 0.05 SOL per trade, at most 0.2 SOL per day, one position at a time. `GE## Step 3: Know your exit ladder-Exits are decided by a pure function in strict priority order, so behavior is exactly predictable:+Exits are decided by a pure function in strict priority order, so behavior is exactly predictable. The first rule that matches wins:1. **Stop-loss** (`stop_loss_pct`): value falls 30% below entry, sell everything, always checked first.-2. **Trailing stop** (`trailing_stop_pct`): value falls 25% off its peak since entry, sell.-3. **Take-profit** (`take_profit_pct`): value reaches entry plus 60%, sell.-4. **Timeout** (`max_hold_seconds`): the clock wins no matter what the PnL is.+2. **Signal flip**: only if you armed paid sentiment intel and the position is underwater. A bearish flip closes it rather than waiting for the stop. Off unless you turn it on.+3. **Trailing stop** (`trailing_stop_pct`): value falls 25% off its peak, sell. **It arms only once the position has actually been green** (the peak has to clear entry). Armed underwater a trail just converts recoverable dips into locked losses, and the hard stop-loss above already caps the downside.+4. **Take-initials** (`initials_out_multiple`): the laddered mode's first profit event, fired once, described below.+5. **Take-profit** (`take_profit_pct`): value reaches entry plus 60%, sell. With a ladder armed this applies only after the initials are out, so the ceiling can never pre-empt the ladder.+6. **Timeout** (`max_hold_seconds`): the clock wins no matter what the PnL is.-There is also a laddered mode (`initials_out_multiple`, `moonbag_min_pct`): recover your initial cost when the position hits a multiple, then let the remaining moon bag ride the trailing stop.+The laddered mode (`initials_out_multiple`, `moonbag_min_pct`) is rungs 4 and 5 working together: recover your initial cost when the position hits a multiple, then let the remaining moon bag ride the trailing stop up to the take-profit ceiling.## Step 4: The lesson from the first live trade: set `take_profit_pct`diff --git a/docs/tutorials/custom-skill.md b/docs/tutorials/custom-skill.mdindex f3950bd94..ab1055d0e 100644--- a/docs/tutorials/custom-skill.md+++ b/docs/tutorials/custom-skill.md@@ -180,9 +180,14 @@ const WEATHER_API_BASE = 'https://wttr.in';export async function get_weather({ city, units = 'celsius' }, ctx) {try {// wttr.in is a free weather API, no key needed.- // Format string: condition + temperature + wind + precipitation- const fmt = units === 'celsius' ? '%C+%t+%w+%p' : '%C+%f+%w+%p';- const url = `${WEATHER_API_BASE}/${encodeURIComponent(city)}?format=${encodeURIComponent(fmt)}&lang=en`;+ // Format string: condition | temperature | wind | precipitation.+ // Pipe, not '+', because %t renders a signed value ("+27°C") and a+ // '+' delimiter would split that sign into its own empty field.+ // Units come from the `m` (metric) / `u` (USCS) flag, not the format+ // string — %f is "feels like", not Fahrenheit.+ const fmt = '%C|%t|%w|%p';+ const unitFlag = units === 'celsius' ? 'm' : 'u';+ const url = `${WEATHER_API_BASE}/${encodeURIComponent(city)}?format=${encodeURIComponent(fmt)}&lang=en&${unitFlag}`;const res = await ctx.fetch(url);if (!res.ok) {@@ -190,7 +195,7 @@ export async function get_weather({ city, units = 'celsius' }, ctx) {}const text = (await res.text()).trim();- const [condition, temp, wind, precipitation] = text.split('+');+ const [condition, temp, wind, precipitation] = text.split('|');return {ok: true,@@ -366,9 +371,9 @@ Add to `tools.json`:"days": {"type": "integer","minimum": 1,- "maximum": 7,+ "maximum": 3,"default": 3,- "description": "Number of forecast days"+ "description": "Number of forecast days (wttr.in returns at most 3)"}},"required": ["city"]diff --git a/docs/tutorials/emotion-from-data.md b/docs/tutorials/emotion-from-data.mdindex c96ab1a8e..cdcacb614 100644--- a/docs/tutorials/emotion-from-data.md+++ b/docs/tutorials/emotion-from-data.md@@ -16,7 +16,7 @@ You'll build two working pipelines — one with zero AI (a lexicon sentiment sco## Step 1 — The two animation entry points-Every `<agent-3d>` element exposes two public methods for triggering body animation, and — per the [JS API tutorial](/tutorials/js-api-events#step-5--animations-exact-name-vs-hint) — they answer different questions.+Every `<agent-3d>` element exposes two public methods for triggering body animation, and — per the [JS API tutorial](/tutorials/js-api-events#step-5--animations-exact-clip-vs-emote) — they answer different questions.**`agent.play(clipName)`** — plays the clip with that *exact* name from the loaded library or GLB. Case-sensitive; if the name isn't found, nothing plays. Use this once you know what's actually in the rig — e.g. `agent.play('rumba')`, `agent.play('thriller')`, `agent.play('celebrate')`. The full catalog (idle, locomotion, dance, gesture, action, sport, reaction, fitness — every clip a real, retargetable library entry, never hardcoded per-rig) is browsable at [/animations](/animations).diff --git a/docs/tutorials/first-agent.md b/docs/tutorials/first-agent.mdindex 9d94652a9..0ad9b269b 100644--- a/docs/tutorials/first-agent.md+++ b/docs/tutorials/first-agent.md@@ -235,11 +235,11 @@ Then add your own input below the element:const agent = document.querySelector('agent-3d');const input = document.getElementById('msg');- async function send() {+ function send() {const text = input.value.trim();if (!text) return;input.value = '';- await agent.say(text);+ agent.say(text);}// Submit on Enter@@ -259,8 +259,8 @@ Then add your own input below the element:| Method | What it does ||--------|--------------|-| `agent.say(text)` | Sends a message and returns the reply. The agent also speaks and animates. |-| `agent.ask(text)` | Same as `say()`, but returns the reply text as a string. |+| `agent.say(text)` | Sends a message the way the built-in chat input does. Fire-and-forget: the reply renders in the bubble, and the agent speaks and animates, but nothing is returned. |+| `agent.ask(text)` | Same turn as `say()`, but returns a promise that resolves with the reply text once the response has finished (and rejects if the brain call fails). || `agent.wave()` | Triggers the wave animation directly. || `agent.lookAt(target)` | `'camera'`, `'model'`, or `'user'` — the agent turns to look. || `agent.play(clipName)` | Plays a named animation clip from the GLB. |@@ -273,7 +273,7 @@ Then add your own input below the element:|-------|--------------|----------------|| `agent:ready` | Agent fully booted | `{ agent, manifest }` || `brain:message` | Each turn of conversation | `{ role, content }` |-| `brain:thinking` | LLM call started | — |+| `brain:thinking` | LLM call started, and again when it ends | `{ thinking }` || `skill:tool-called` | Agent used a tool/skill | `{ tool, args, result }` || `voice:transcript` | STT produced a transcript | `{ text, final }` |@@ -285,10 +285,10 @@ Make Aria say hello as soon as the page loads. Add this after the script block f```html<script>- agent.addEventListener('agent:ready', async () => {+ agent.addEventListener('agent:ready', () => {// Short pause so the avatar settles in before speaking- setTimeout(async () => {- await agent.say('Hello! I\'m Aria. How can I help you today?');+ setTimeout(() => {+ agent.say('Hello! I\'m Aria. How can I help you today?');}, 1200);});</script>@@ -450,11 +450,11 @@ Here's the complete `index.html` all in one place:const agent = document.querySelector('agent-3d');const input = document.getElementById('msg');- async function send() {+ function send() {const text = input.value.trim();if (!text) return;input.value = '';- await agent.say(text);+ agent.say(text);}input.addEventListener('keydown', e => {diff --git a/docs/tutorials/js-api-events.md b/docs/tutorials/js-api-events.mdindex cebe8d718..88ddf6e87 100644--- a/docs/tutorials/js-api-events.md+++ b/docs/tutorials/js-api-events.md@@ -183,7 +183,7 @@ Click both. The first animates instantly and makes no sound. The second pauses bThe agent has two ways to pick an animation clip. They map to two different mental models.-**`agent.play(name)`** — plays the clip with that name from the loaded rig (an exact match, falling back to a case-insensitive one). If the clip isn't in the model, it returns `false` and nothing plays. Use this when you know what's in the rig — for instance, if you've baked a `WaveLoop` clip yourself.+**`agent.play(name)`** — plays the clip with that name from the loaded rig: an exact match first, then a case-insensitive one, then a case-insensitive substring match. If the GLB carries no such clip, it looks the name up in the shared animation library instead, and only returns `false` when neither source can supply it. Use this when you know what's in the rig — for instance, if you've baked a `WaveLoop` clip yourself.**`agent.playEmote(name)`** — the resilient one. Instead of a clip name it takes an intent — `'celebrate'`, `'cheer'`, or `'flinch'` — and walks a fallback chain of clips until one exists in the rig (`celebrate` → `wave`; `cheer` → `celebrate` → `wave`; `flinch` → `defeated` → `concern` → `shake`). If none of them are present, it finishes with a small head-bob, so it's guaranteed to do *something* regardless of the rig.@@ -227,11 +227,11 @@ Here are the events that actually fire, in the order you'll usually see them in| `brain:thinking` | An LLM call has started | `{ thinking: true | false }` || `brain:stream` | A chunk of a streamed response arrived | `{ chunk: string }` || `brain:message` | A complete message landed (user or assistant) | `{ role, content, sentiment? }` |-| `skill:tool-start` | A tool/skill is about to run | `{ tool }` |-| `skill:tool-called` | A tool returned | `{ name, args, result }` |+| `skill:tool-start` | A tool/skill is about to run | `{ tool, args }` |+| `skill:tool-called` | A tool returned | `{ tool, args, result }` || `voice:speech-start` | The agent began speaking out loud | `{ text }` || `voice:speech-end` | The agent finished speaking | — |-| `voice:transcript` | Mic input was transcribed | `{ text }` |+| `voice:transcript` | Mic input was transcribed | `{ text, final }` || `memory:write` | Something was written to memory | `{ scope, key, value }` |Wire a logger to see them flow:@@ -264,7 +264,7 @@ Every one of these is a hook for your app. A few common patterns:- **Show a typing indicator** — switch a CSS class on `brain:thinking` and clear it on `brain:message`.- **Mirror chat to your own UI** — listen to `brain:message` and append `e.detail.content` to your message log when `role === 'assistant'`.-- **Track skill usage** — `skill:tool-called` tells you which skill ran, with what arguments, and what came back. Log it to your analytics.+- **Track skill usage** — `skill:tool-called` tells you which skill ran (`e.detail.tool`), with what arguments, and what came back. Log it to your analytics.- **React to speech state** — disable an input while `voice:speech-start` is active, re-enable on `voice:speech-end`. Stops the user from interrupting the agent mid-sentence.---diff --git a/docs/tutorials/mint-pumpfun-token.md b/docs/tutorials/mint-pumpfun-token.mdindex bb2effa37..843026d48 100644--- a/docs/tutorials/mint-pumpfun-token.md+++ b/docs/tutorials/mint-pumpfun-token.md@@ -232,7 +232,7 @@ A token that nobody knows about does nothing. The launch is not the announcementA reasonable sequence on launch day:1. **Update the agent's public card.** The three.ws agent page already shows the Pump.fun panel after bonding, but check it in an incognito tab to confirm.-2. **Post the agent URL** (not the bare Pump.fun URL — the agent URL frames it correctly). Example: "Just bonded a token to my agent. mint and chart on the page → https://three.ws/a/<chain>/<agentId>".+2. **Post the agent URL** (not the bare Pump.fun URL — the agent URL frames it correctly). Example: "Just bonded a token to my agent. mint and chart on the page → `https://three.ws/a/<chain>/<agentId>`".3. **Cross-post the Pump.fun link.** Some communities prefer the raw pump.fun page. Both are valid.4. **Pin the post.** Make it findable.diff --git a/docs/tutorials/walk-companion.md b/docs/tutorials/walk-companion.mdindex eb1d50f54..ed287b690 100644--- a/docs/tutorials/walk-companion.md+++ b/docs/tutorials/walk-companion.md@@ -65,7 +65,7 @@ The embed reads its world and controls from the URL. The verified params:| Param | Values | Effect ||---|---|---|-| `env` | `studio` `void` `beach` `sunset` `night` `grid` | The environment (default scene if omitted) |+| `env` | `studio` `void` `beach` `sunset` `night` `grid` | The environment (`studio` if omitted) || `autoplay` | `true` | Start animating immediately || `controls` | `joystick` `keyboard` `none` | How (or whether) the visitor steers || `orbit` | `true` `false` | Allow drag-to-orbit the camera |@@ -285,26 +285,26 @@ Every stroll logs distance, and the longest ones climb the global board at [/wal```jsasync function loadTopWalkers() {const res = await fetch(- 'https://three.ws/api/walk/leaderboard?period=all-time&metric=distance',+ 'https://three.ws/api/walk/leaderboard?period=all-time&metric=distance&limit=3',{ headers: { accept: 'application/json' } },);if (!res.ok) throw new Error(`HTTP ${res.status}`);- const data = await res.json();- // The endpoint may return { leaders } | { walkers } | { entries } | [...]- const rows = Array.isArray(data)- ? data- : data.leaders || data.walkers || data.entries || data.results || data.data || [];- return rows.slice(0, 3); // each: { name, distance, image_url?, url? }+ const { rows = [] } = await res.json();+ // Each row: { rank, key, username, handle, avatarId, avatar, value, deltaFromYesterday }+ // `value` is the metric you asked for — meters for metric=distance.+ return rows;}```-Format distances for display the way the live page does — meters under 1km, kilometres above:+`period` is `daily` / `weekly` (the default) / `all-time`, `metric` is `distance` (the default) / `sites` / `time`, and `limit` is 1 to 100 (default 50). The response also carries `total`, `offset`, and `hasMore` for paging.++Format distances for display the way the live board does — meters under 1 km, kilometres above:```jsfunction formatDistance(meters) {const m = Number(meters);- if (!Number.isFinite(m) || m <= 0) return '—';- if (m >= 1000) return (m / 1000).toFixed(m >= 10000 ? 0 : 1) + ' km';+ if (!Number.isFinite(m) || m <= 0) return '0 m';+ if (m >= 1000) return (m / 1000).toFixed(2) + ' km';return Math.round(m) + ' m';}```diff --git a/docs/tutorials/web-component-end-to-end.md b/docs/tutorials/web-component-end-to-end.mdindex 96015097c..ea76c965c 100644--- a/docs/tutorials/web-component-end-to-end.md+++ b/docs/tutorials/web-component-end-to-end.md@@ -91,9 +91,9 @@ The rest of this tutorial uses the custom-element form, because that's the one t----## Step 3 — The full attribute surface+## Step 3 — The attribute surface-Here's the full list of attributes the element observes, in the categories you'll actually reach for.+Here are the attributes you'll actually reach for, by category. (`observedAttributes` in [src/element.js](https://github.com/nirholas/three.ws/blob/main/src/element.js) is the exhaustive list; it also carries niche ones like `avatar-id`, `api-base`, `name-plate`, `tracked-mint`, `clip`, `wallet`, and `sign-language`.)**Identity (one of these is required):**@@ -121,14 +121,15 @@ Here's the full list of attributes the element observes, in the categories you'l|---|---|| `name` | The agent's display name in the nameplate || `voice` | Set to `livekit` to opt into LiveKit-backed real-time voice |-| `avatar-chat` | Set to `off` to hide the built-in chat input |+| `chat` | Set to `off` for a bare avatar with no built-in chat shell (`kiosk` does the same) |+| `avatar-chat` | Set to `off` to drop the avatar out of the chat column and lay the chat out as a plain bottom bar || `avatar-walk` | Set to `off` to disable the walk-when-talking behaviour || `framing` | Set to `portrait` for a head-and-shoulders camera framing; the default frames the full body || `eager` | Skip the lazy-load wait — boot immediately even when off-screen || `api-key` | Override the brain API key (use sparingly; backends are safer) || `key-proxy` | URL of your own proxy that vends scoped keys |-Every observed attribute can be changed after mount. Step 6 shows what that looks like in practice.+Every observed attribute can be changed after mount, and Step 6 shows what that looks like in practice. Two of the attributes above are read once at boot rather than observed: `name` and `eager`. Setting either after the element has booted has no effect.---@@ -451,24 +452,26 @@ The element has a built-in chat input at the bottom. That's fine for a drop-in wTwo parts to this.-**Hide the built-in UI** with `avatar-chat="off"`:+**Hide the built-in UI** with `chat="off"` (the same bare-avatar switch `kiosk` flips, but as a value you can bind from a template):```html<agent-3did="agent"agent-id="YOUR_AGENT_ID"- avatar-chat="off"+ chat="off"width="100%"height="100%"></agent-3d>```+The brain still boots, so `say()`, `ask()`, and the whole event stream keep working — only the chrome is gone.+**Wire your own UI** that calls the element's API:```html<div class="agent-shell"><div class="canvas">- <agent-3d id="agent" agent-id="YOUR_AGENT_ID" avatar-chat="off"></agent-3d>+ <agent-3d id="agent" agent-id="YOUR_AGENT_ID" chat="off"></agent-3d></div><div class="composer"><input id="message" placeholder="Ask me anything" />@@ -582,7 +585,7 @@ You can now treat `<agent-3d>` as a real component in any framework. The big tak- Attribute changes are reactive; you can swap agents, modes, and layouts at runtime- React works fine once you bind events in `useEffect`; remember dash-case attribute names- Vue works fine once you flag the tag as a custom element in the compiler config-- Use `avatar-chat="off"` to bring your own composer when you want full control+- Use `chat="off"` to bring your own composer when you want full control- Don't reach into the shadow DOM; style the wrapper, not the internalsThe web component is the most robust integration point the platform offers. Build your design system around it once and the agent fits anywhere you ship.diff --git a/docs/tutorials/write-a-guard.md b/docs/tutorials/write-a-guard.mdindex ab520ded1..78c96033c 100644--- a/docs/tutorials/write-a-guard.md+++ b/docs/tutorials/write-a-guard.md@@ -2,7 +2,7 @@**Level:** intermediate. You should be comfortable with Node and `git`.**Time:** about 20 minutes.-**You will build:** a real guard that fails the build when an API handler forgets its error boundary, wired into the gate, covered by tests, and registered so it shows up on [/guards](/guards).+**You will build:** a real guard that fails the build when a server-side `fetch()` has no timeout, wired into the gate, proven against the violation it claims to catch, covered by tests, and registered so it shows up on [/guards](/guards).This repository has no CI, so a guard is not a nice-to-have that runs somewhere in the cloud. It is the only thing standing between a mistake and production. [Repository guards](/docs/guards) explains the system; this page walks you through adding one.@@ -108,12 +108,32 @@ Add an entry to `data/guards.json`. This is what [/guards](/guards) renders and"protects": "No server-side fetch can hang without a timeout.","why": "A fetch with no timeout turns one slow upstream into stacked requests and 502s on unrelated endpoints. It reads as ordinary code in review.","stages": ["gate"],- "needs": "none"+ "needs": "none",+ "proof": {+ "summary": "An API handler calling fetch() with no timeout.",+ "violation": {+ "write": {+ "api/guard-proof-fetch-timeout.js": "export default async function handler(req, res) {\n\tconst r = await fetch('https://example.com/slow');\n\tres.json(await r.json());\n}\n"+ }+ },+ "expect": "api/guard-proof-fetch-timeout.js"+ }}```Every field is required, and `audit-guards` enforces that, because a guard with no `why` is one nobody dares delete and nobody understands.+`proof` is the field people forget, and it is the one the auditor refuses to let you skip. Leave it out and `npm run audit:guards` fails with:++```+[audit-guards] guard `check-fetch-timeouts`: guard "check-fetch-timeouts" has no+proof block. Every guard must declare the violation it rejects (see docs/guards.md).+```++It declares the violation your guard must reject, in fixture form rather than code: `summary` says what the violation is in one line, `violation` is the mutation applied to a throwaway copy of the repo, and `expect` is the fragment the guard's own failure output must contain. Step 5 runs it. `violation` also takes `append`, `delete`, `link`, and `json` instead of `write`; a guard that genuinely cannot be proven offline declares `{"kind": "live", "reason": "..."}` and says why, rather than faking a green.++Nothing else needs regenerating by hand: `npm run build:guards` refreshes `public/guards.json` (the file [/guards](/guards) fetches), and it already runs inside `prebuild` on every build.+---## Step 4: wire it into a stage@@ -153,9 +173,30 @@ Anything needing the network or credentials goes in `manual`. A flaky guard on a----## Step 5: test it+## Step 5: prove it still catches something++`audit:guards` proved the guard is *wired*. It cannot prove the guard still *catches* anything. A checker that has rotted into a no-op (a directory it stopped scanning, a regex that stopped matching, an exclusion list that grew until it excluded everything) exits 0 forever, and exit 0 is indistinguishable from a clean tree. That is the worst failure mode a safety net has: loudest when it works, silent when it dies.++The `proof` block you wrote in Step 3 is what closes that hole. Run it:++```bash+npm run prove:guards -- --only check-fetch-timeouts+```++The runner builds a throwaway git worktree overlaid with your working tree and runs your guard twice there. Both halves are required:++1. **Control.** The unmutated sandbox must make the guard exit 0. A clean baseline is what makes the next step attributable. Without it, a non-zero exit could just mean the sandbox is broken.+2. **Violation.** The `write` fixture lands `api/guard-proof-fetch-timeout.js`, and the guard must now exit non-zero *and* print the `expect` fragment, because a guard that fails for the wrong reason is not a working guard.++The verdicts you can get back are `proven`, `control-failed` (your guard already fails on a clean tree), `not-caught` (the fixture slipped past it, so the guard is a no-op), and `wrong-reason` (it failed, but not on your violation). Only the first one means what you built works. Results land in `public/guard-proofs.json` with a verdict per guard.++It is safe to run while other agents are working in this tree: each run gets its own sandbox keyed to its process id and never writes to the repository except that one results file.++---++## Step 6: test it-A guard with no test rots into a no-op, and you find out when the thing it was supposed to catch ships anyway. Create `tests/check-fetch-timeouts.test.js`:+A guard with no test rots into a no-op, and you find out when the thing it was supposed to catch ships anyway. A proof covers the violation you thought of; a test file is where you pin the false positives. Create `tests/check-fetch-timeouts.test.js`:```jsimport { describe, it, expect, beforeAll, afterAll } from 'vitest';@@ -228,7 +269,7 @@ Build the sandbox rather than pointing the test at the real repository. A test t----## Step 6: document it+## Step 7: document itAdd a row to the relevant table in [`docs/guards.md`](/docs/guards), and add a `data/changelog.json` entry if the guard changes what contributors have to do.@@ -240,9 +281,10 @@ Your guard is done when all of these are true:- [ ] `scripts/check-<thing>.mjs` exists, exits non-zero with an actionable message, and opens with the incident that motivated it.- [ ] An npm script runs it.-- [ ] `data/guards.json` has an entry with `title`, `protects`, `why`, and `stages`.+- [ ] `data/guards.json` has an entry with `title`, `protects`, `why`, `stages`, and a `proof`.- [ ] It is wired into the chain for every stage it claims.- [ ] `npm run audit:guards` passes.+- [ ] `npm run prove:guards -- --only <id>` returns `proven`, not `not-caught` or `control-failed`.- [ ] A test covers the pass case, the fail case, and at least one false positive it must not report.- [ ] `npm run gate` still passes.@@ -250,6 +292,6 @@ Your guard is done when all of these are true:## Related-- [Repository guards](/docs/guards): every existing guard, its stage, and the design principles.+- [Repository guards](/docs/guards): every existing guard, its stage, the design principles, and the full `proof` vocabulary.- [/guards](/guards): the registry as a browsable page.- [Start here](/docs/start-here): what three.ws is, if you landed here first.diff --git a/docs/vanity.md b/docs/vanity.mdindex 610e3a8c8..6bf3f46f5 100644--- a/docs/vanity.md+++ b/docs/vanity.md@@ -137,7 +137,7 @@ curl "https://three.ws/api/x402/vanity?prefix=So"Longer than 3 chars? A 4–5 char pattern is served if (and only if) it's instock — same endpoint, premium price, `source: "inventory"`. Out of stock getsa `404 not_in_stock`; grind it yourself in the browser at-[`/vanity`](https://three.ws/vanity), or browse what IS available at+[`/vanity-wallet`](https://three.ws/vanity-wallet), or browse what IS available at[premium inventory](#tier-3--premium-inventory).### Security model@@ -227,4 +227,4 @@ challenges and the discovery doc stay in parity.- [x402 endpoints overview](x402-endpoints.md)- [three-vanity/v1 protocol spec](PROTOCOL-vanity.md)- [Pump Launcher](pump-launcher.md) — accepts an optional vanity mint prefix/suffix-- Web grinder + verifier: [`/vanity`](https://three.ws/vanity), [`/vanity/verify`](https://three.ws/vanity/verify)+- Web grinder + verifier: [`/vanity-wallet`](https://three.ws/vanity-wallet), [`/vanity/verify`](https://three.ws/vanity/verify)diff --git a/packages/agent-sniper/README.md b/packages/agent-sniper/README.mdindex 6fec27234..b68a9edb9 100644--- a/packages/agent-sniper/README.md+++ b/packages/agent-sniper/README.md@@ -207,7 +207,7 @@ in-memory transport.## x402 paid HTTP API`agent-sniper serve` (or `import { serve } from '@three-ws/agent-sniper/api'`)-mounts the engine over HTTP. Reads are free; the three mutating endpoints are+mounts the engine over HTTP. Reads are free; the four mutating endpoints aregated behind x402 USDC micropayments via `@three-ws/x402-server` — themiddleware verifies the `X-PAYMENT` header against the facilitator, runs thework, settles on-chain, and emits the receipt.@@ -218,12 +218,15 @@ work, settles on-chain, and emits the receipt.| GET | `/status` | free | Full stats + immutable runtime config. || GET | `/strategies` | free | The armed strategy set. || GET | `/positions?agentId=&status=` | free | Positions from the store. |+| GET | `/activity` | free | The recent engine screen events (what the console feed renders). |+| GET | `/` and `/console` | free | The built-in operator console (see below). || POST | `/strategies` | **$0.01 USDC** | Arm a strategy (SOL → lamports; stop-loss required). || POST | `/snipe` | **$0.05 USDC** | Force a snipe on `{ mint, symbol?, agentId? }`. || POST | `/strategies/:id/disarm` | **$0.005 USDC** | Disable a strategy. |+| POST | `/positions/:id/close` | **$0.005 USDC** | Schedule an exit; the next sweep sells it. |Prices are the defaults (USDC atomic units, 6 decimals); override via-`deps.prices = { arm, snipe, disarm }`.+`deps.prices = { arm, snipe, disarm, close }`.Gating turns on when a merchant wallet is configured — `deps.payTo.solana` or the`X402_PAY_TO_SOLANA` env (a Base lane is available via `X402_PAY_TO_BASE`). Whendiff --git a/packages/agent-sniper/package.json b/packages/agent-sniper/package.jsonindex e762d54f7..164291a64 100644--- a/packages/agent-sniper/package.json+++ b/packages/agent-sniper/package.json@@ -48,8 +48,7 @@"web","server.json","README.md",- "LICENSE",- ".env.example"+ "LICENSE"],"scripts": {"start": "node bin/agent-sniper.js run",diff --git a/packages/agentcore-payments-mcp/README.md b/packages/agentcore-payments-mcp/README.mdindex 35804076e..1e8df6c18 100644--- a/packages/agentcore-payments-mcp/README.md+++ b/packages/agentcore-payments-mcp/README.md@@ -12,7 +12,7 @@ A **Payment Session** is a budget envelope you fund once from your three.ws cred```bash# Configure-export THREE_WS_SESSION="__Host-sid=<your-session-cookie>"+export THREE_WS_SESSION="<the value of your __Host-sid cookie>"export PAYMENT_SESSION_TOKEN="pss_<session-id>_<random>"# Run@@ -28,7 +28,7 @@ MCP client config (`~/.cursor/mcp.json`, Claude Desktop, etc.):"command": "npx","args": ["-y", "@three-ws/agentcore-payments-mcp"],"env": {- "THREE_WS_SESSION": "__Host-sid=...",+ "THREE_WS_SESSION": "<the value of your __Host-sid cookie>","PAYMENT_SESSION_TOKEN": "pss_..."}}@@ -40,7 +40,7 @@ MCP client config (`~/.cursor/mcp.json`, Claude Desktop, etc.):| Variable | Required | Description ||---|---|---|-| `THREE_WS_SESSION` | For session management tools | Browser session cookie (`__Host-sid=...`) for creating/listing/cancelling sessions |+| `THREE_WS_SESSION` | For session management tools | The **value** of your `__Host-sid` browser cookie (no `__Host-sid=` prefix; the server sends the cookie for you) for creating/listing/cancelling sessions || `PAYMENT_SESSION_TOKEN` | For `pay_with_session` default | Bearer token returned when you created a session; passed as the default when no inline token is provided || `THREE_WS_BASE` | No | Base URL (default: `https://three.ws`) || `THREE_WS_TIMEOUT_MS` | No | Request timeout in ms (default: 30000) |@@ -145,6 +145,31 @@ create (budget debited from credits)└─ cancelled (manual — remaining budget refunded immediately)```+## Programmatic use++The package entry point exports **`TOOLS`** (every tool definition: `name`, `title`,+`description`, `inputSchema`, `annotations`, `handler`) and **`buildServer()`**, which returns a+fully-registered `McpServer` with no transport attached. Importing is side-effect free and needs+no credential, so you can mount these tools inside a host of your own or inspect the surface+offline; a credential is only required when a handler actually runs.++```js+// run with: THREE_WS_SESSION=<your __Host-sid value> node this-file.mjs+import { TOOLS, buildServer } from '@three-ws/agentcore-payments-mcp';++for (const tool of TOOLS) {+ const kind = tool.annotations.readOnlyHint ? 'read ' : 'write';+ console.log(`${kind} ${tool.name}`);+}++// A tool handler is a plain async function against the live API.+const list = TOOLS.find((t) => t.name === 'list_payment_sessions');+console.log(await list.handler({ limit: 3 }));++// Or hand the whole registered server to your own MCP transport.+buildServer();+```+## Security properties- **No key exposure**: the session token is a time-bounded, HMAC-signed grant. Compromising it lets an attacker spend up to the remaining budget at allowed hosts — nothing more.diff --git a/packages/agentcore-payments-mcp/examples/README.md b/packages/agentcore-payments-mcp/examples/README.mdindex ba8cd51d6..92b2943c3 100644--- a/packages/agentcore-payments-mcp/examples/README.md+++ b/packages/agentcore-payments-mcp/examples/README.md@@ -25,7 +25,7 @@ tools appear with no `THREE_WS_SESSION` or `PAYMENT_SESSION_TOKEN` set.Abridged output:```-server: agentcore-payments-mcp v0.1.2 (stdio)+server: agentcore-payments-mcp v0.1.3 (stdio)capabilities: toolstools: 5diff --git a/packages/agentcore-payments-mcp/package.json b/packages/agentcore-payments-mcp/package.jsonindex d0bf1340f..72c312a7f 100644--- a/packages/agentcore-payments-mcp/package.json+++ b/packages/agentcore-payments-mcp/package.json@@ -1,6 +1,6 @@{"name": "@three-ws/agentcore-payments-mcp",- "version": "0.1.3",+ "version": "0.1.4","mcpName": "io.github.nirholas/agentcore-payments-mcp","description": "Platform-managed agent payment sessions — create a budget, pay any x402 endpoint without holding a private key. Governed by spend limits, URL allowlists, and per-tx ceilings. The agent proposes spend; three.ws governance enforces policy.","type": "module",@@ -34,6 +34,7 @@},"files": ["src",+ "examples","server.json","README.md","LICENSE"diff --git a/packages/agentcore-payments-mcp/server.json b/packages/agentcore-payments-mcp/server.jsonindex 527749f43..7c3db1519 100644--- a/packages/agentcore-payments-mcp/server.json+++ b/packages/agentcore-payments-mcp/server.json@@ -18,12 +18,12 @@"source": "github","subfolder": "packages/agentcore-payments-mcp"},- "version": "0.1.3",+ "version": "0.1.4","packages": [{"registryType": "npm","identifier": "@three-ws/agentcore-payments-mcp",- "version": "0.1.3",+ "version": "0.1.4","runtimeHint": "npx","transport": {"type": "stdio"diff --git a/packages/agora-mcp/README.md b/packages/agora-mcp/README.mdindex f2bcccbc3..24a95ba18 100644--- a/packages/agora-mcp/README.md+++ b/packages/agora-mcp/README.md@@ -203,6 +203,30 @@ Verify any completion on [Solana Explorer](https://explorer.solana.com/?cluster=| `AGORA_SECRET_KEY` | writes only | — | Default base58 64-byte signer. Never logged or transmitted. || `AGORA_RPC_URL` | no | public RPC | Override the Solana RPC the write tools sign against. |+## Programmatic use++The package entry point exports **`TOOLS`** (every tool definition: `name`, `title`,+`description`, `inputSchema`, `annotations`, `handler`) and **`buildServer()`**, which returns a+fully-registered `McpServer` with no transport attached. Importing is side-effect free and needs+no signer, so you can mount Agora inside a host of your own or inspect the surface offline.++```js+// run from a checkout: node this-file.mjs+import { TOOLS, buildServer } from '@three-ws/agora-mcp';++for (const tool of TOOLS) {+ const kind = tool.annotations.readOnlyHint ? 'read ' : 'write';+ console.log(`${kind} ${tool.name}`);+}++// A read tool is a plain async function: no server, no transport, no key.+const board = TOOLS.find((t) => t.name === 'agora_board');+console.log(await board.handler({ limit: 1 }));++// Or hand the whole registered server to your own MCP transport.+buildServer();+```+## Links- Agora overview: [docs/agora.md](https://github.com/nirholas/three.ws/blob/main/docs/agora.md)diff --git a/packages/alerts-mcp/README.md b/packages/alerts-mcp/README.mdindex 0c643e707..09b9f2b33 100644--- a/packages/alerts-mcp/README.md+++ b/packages/alerts-mcp/README.md@@ -142,6 +142,31 @@ At least one delivery channel must be on: `deliver_in_app` (default true), `webh| `THREE_WS_BASE` | no | `https://three.ws` | Override only for self-hosting / preview deployments. || `THREE_WS_TIMEOUT_MS` | no | `20000` | Per-request timeout (ms). |+## Programmatic use++The package entry point exports **`TOOLS`** (every tool definition: `name`, `title`,+`description`, `inputSchema`, `annotations`, `handler`) and **`buildServer()`**, which returns a+fully-registered `McpServer` with no transport attached. Importing is side-effect free and needs+no session, so you can mount the alert tools inside a host of your own or inspect the surface+offline; the session is only required when a handler actually runs.++```js+// run with: THREE_WS_SESSION=<your __Host-sid value> node this-file.mjs+import { TOOLS, buildServer } from '@three-ws/alerts-mcp';++for (const tool of TOOLS) {+ const kind = tool.annotations.readOnlyHint ? 'read ' : 'write';+ console.log(`${kind} ${tool.name}`);+}++// A tool handler is a plain async function against the live API.+const list = TOOLS.find((t) => t.name === 'list_alert_rules');+console.log(await list.handler({}));++// Or hand the whole registered server to your own MCP transport.+buildServer();+```+## Links- Homepage: https://three.wsdiff --git a/packages/alerts-mcp/test/handlers.test.mjs b/packages/alerts-mcp/test/handlers.test.mjsnew file mode 100644index 000000000..9163c71f3--- /dev/null+++ b/packages/alerts-mcp/test/handlers.test.mjs@@ -0,0 +1,299 @@+// Handler behaviour for @three-ws/alerts-mcp, with fetch stubbed.+//+// registration.test.mjs pins the tool surface; this suite pins what the tools+// actually do on the wire and to the data. Every test replaces globalThis.fetch+// via node:test's mock tracker (restored automatically per-test), so no request+// ever leaves the process. Assertions cover the exact request each handler+// sends (method, path, query, cookie, CSRF header, JSON body), the CSRF+// double-submit flow the writes are required to perform, the client-side+// filtering in get_alert_history, and how upstream failures are normalized.+//+// Run: node --test packages/alerts-mcp/test/handlers.test.mjs++import { test } from 'node:test';+import assert from 'node:assert/strict';++// config.js snapshots env at import time, so pin the session and base BEFORE the+// dynamic imports below. Each node --test file runs in its own process, so this+// does not leak into registration.test.mjs (which asserts the no-session path).+process.env.THREE_WS_SESSION = 'test-session-cookie';+process.env.THREE_WS_BASE = 'https://three.test';+delete process.env.THREE_WS_TIMEOUT_MS;++const { def: listRules } = await import('../src/tools/list-alert-rules.js');+const { def: createRule } = await import('../src/tools/create-alert-rule.js');+const { def: updateRule } = await import('../src/tools/update-alert-rule.js');+const { def: deleteRule } = await import('../src/tools/delete-alert-rule.js');+const { def: getHistory } = await import('../src/tools/get-alert-history.js');+const { summarizeAlert } = await import('../src/lib/shapes.js');++const RULE_ID = '76bf0786-1a43-4815-99fe-33f4a142e562';+// $THREE is the only coin three.ws promotes; it is the fixture mint everywhere.+const THREE_MINT = 'FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump';++function jsonResponse(data, { status = 200 } = {}) {+ return {+ ok: status >= 200 && status < 300,+ status,+ text: async () => JSON.stringify(data),+ };+}++// Stub fetch for one test; returns the recorded calls [{ url, init }].+function stubFetch(t, responder) {+ const calls = [];+ t.mock.method(globalThis, 'fetch', async (url, init) => {+ calls.push({ url: String(url), init });+ return responder(String(url), init);+ });+ return calls;+}++// A responder that answers the CSRF fetch first, then the write itself.+function csrfThen(responder, token = 'csrf-token-1') {+ return (url, init) => {+ if (url.endsWith('/api/csrf-token')) return jsonResponse({ data: { token } });+ return responder(url, init);+ };+}++const ruleRow = (over = {}) => ({+ id: RULE_ID,+ kind: 'price_above',+ label: null,+ label_display: 'Mcap above $100000',+ target_mint: THREE_MINT,+ threshold: 100000,+ deliver_in_app: true,+ cooldown_seconds: 600,+ enabled: true,+ created_at: '2026-08-15T05:16:44.450Z',+ updated_at: '2026-08-15T05:16:44.450Z',+ ...over,+});++// list_alert_rules++test('list_alert_rules GETs the rules endpoint with the session cookie and shapes each row', async (t) => {+ const calls = stubFetch(t, () =>+ jsonResponse({ rules: [ruleRow(), null, ruleRow({ id: 'second' })] }),+ );++ const result = await listRules.handler();++ assert.equal(calls.length, 1);+ assert.equal(calls[0].url, 'https://three.test/api/alerts/rules');+ assert.equal(calls[0].init.method, 'GET');+ assert.equal(calls[0].init.headers.cookie, '__Host-sid=test-session-cookie');+ assert.equal(calls[0].init.headers['x-csrf-token'], undefined);++ // The null row is dropped, and every survivor carries the full pinned shape.+ assert.equal(result.ok, true);+ assert.equal(result.count, 2);+ assert.equal(result.rules[0].target_mint, THREE_MINT);+ assert.equal(result.rules[0].webhook_secret, null);+ assert.equal(result.rules[0].recent_failures, 0);+ assert.deepEqual(result.rules[0].recent_deliveries, []);+});++test('list_alert_rules reports an honest empty list on a malformed upstream', async (t) => {+ stubFetch(t, () => jsonResponse({ ok: true }));+ assert.deepEqual(await listRules.handler(), { ok: true, count: 0, rules: [] });+});++// create_alert_rule++test('create_alert_rule fetches a CSRF token, then POSTs only the defined fields', async (t) => {+ const calls = stubFetch(+ t,+ csrfThen(() => jsonResponse({ rule: ruleRow() })),+ );++ const result = await createRule.handler({+ kind: 'price_above',+ target_mint: THREE_MINT,+ threshold: 100000,+ deliver_in_app: true,+ cooldown_seconds: 600,+ enabled: true,+ });++ assert.equal(calls.length, 2);+ assert.equal(calls[0].url, 'https://three.test/api/csrf-token');+ assert.equal(calls[0].init.method, 'GET');++ const write = calls[1];+ assert.equal(write.url, 'https://three.test/api/alerts/rules');+ assert.equal(write.init.method, 'POST');+ assert.equal(write.init.headers['x-csrf-token'], 'csrf-token-1');+ assert.equal(write.init.headers.cookie, '__Host-sid=test-session-cookie');+ assert.equal(write.init.headers['content-type'], 'application/json');++ // Undefined optionals must not be serialized: the API rejects explicit nulls+ // on create, so an absent field has to stay absent on the wire.+ const body = JSON.parse(write.init.body);+ assert.deepEqual(Object.keys(body).sort(), [+ 'cooldown_seconds',+ 'deliver_in_app',+ 'enabled',+ 'kind',+ 'target_mint',+ 'threshold',+ ]);+ assert.equal(result.rule.id, RULE_ID);+});++test('create_alert_rule surfaces an API validation failure with its status and body', async (t) => {+ stubFetch(+ t,+ csrfThen(() =>+ jsonResponse({ message: 'price_above requires target_mint' }, { status: 400 }),+ ),+ );++ await assert.rejects(+ createRule.handler({ kind: 'price_above', threshold: 1 }),+ (err) => {+ assert.equal(err.code, 'upstream_error');+ assert.equal(err.status, 400);+ assert.equal(err.message, 'price_above requires target_mint');+ return true;+ },+ );+});++test('a write refuses to proceed when three.ws returns no CSRF token', async (t) => {+ const calls = stubFetch(t, (url) =>+ url.endsWith('/api/csrf-token') ? jsonResponse({ data: {} }) : jsonResponse({ rule: ruleRow() }),+ );++ await assert.rejects(createRule.handler({ kind: 'graduation' }), (err) => {+ assert.equal(err.code, 'csrf_unavailable');+ return true;+ });+ // The rule POST must never have been attempted without the token.+ assert.equal(calls.length, 1);+});++// update_alert_rule++test('update_alert_rule PATCHes the rule id and keeps explicit nulls as clears', async (t) => {+ const calls = stubFetch(+ t,+ csrfThen(() => jsonResponse({ rule: ruleRow({ enabled: false, threshold: 250000 }) })),+ );++ const result = await updateRule.handler({+ rule_id: RULE_ID,+ enabled: false,+ threshold: 250000,+ webhook_url: null,+ label: undefined,+ });++ const write = calls[1];+ assert.equal(write.url, `https://three.test/api/alerts/rules/${RULE_ID}`);+ assert.equal(write.init.method, 'PATCH');+ assert.equal(write.init.headers['x-csrf-token'], 'csrf-token-1');++ const body = JSON.parse(write.init.body);+ // rule_id addresses the resource and must not be echoed into the patch; a+ // null is a deliberate clear and must survive; an undefined is dropped.+ assert.equal('rule_id' in body, false);+ assert.equal('label' in body, false);+ assert.equal(body.webhook_url, null);+ assert.equal(body.enabled, false);+ assert.equal(body.threshold, 250000);++ assert.equal(result.rule.enabled, false);+ assert.equal(result.rule.threshold, 250000);+});++// delete_alert_rule++test('delete_alert_rule DELETEs the rule and echoes the id even when the API omits it', async (t) => {+ const calls = stubFetch(+ t,+ csrfThen(() => jsonResponse({ ok: true })),+ );++ const result = await deleteRule.handler({ rule_id: RULE_ID });++ assert.equal(calls[1].url, `https://three.test/api/alerts/rules/${RULE_ID}`);+ assert.equal(calls[1].init.method, 'DELETE');+ assert.equal(calls[1].init.body, undefined);+ assert.deepEqual(result, { ok: true, deleted: true, id: RULE_ID });+});++// get_alert_history++test('get_alert_history asks for exactly the requested page when it is not filtering', async (t) => {+ const calls = stubFetch(t, () => jsonResponse({ notifications: [], unread_count: 0 }));++ await getHistory.handler({ limit: 5 });++ const url = new URL(calls[0].url);+ assert.equal(url.pathname, '/api/notifications');+ assert.equal(url.searchParams.get('type'), 'pump_alert');+ assert.equal(url.searchParams.get('limit'), '5');+});++test('get_alert_history pulls the full page before filtering, then trims to limit', async (t) => {+ const alert = (over) => ({+ id: over.id,+ created_at: '2026-08-15T05:20:00.000Z',+ read_at: null,+ payload: { rule_id: RULE_ID, kind: 'whale_buy', mint: THREE_MINT, symbol: 'THREE', ...over.payload },+ });+ const calls = stubFetch(t, () =>+ jsonResponse({+ unread_count: 3,+ notifications: [+ alert({ id: 1, payload: {} }),+ alert({ id: 2, payload: { kind: 'graduation' } }),+ alert({ id: 3, payload: { rule_id: 'other-rule' } }),+ alert({ id: 4, payload: {} }),+ ],+ }),+ );++ const result = await getHistory.handler({ limit: 1, rule_id: RULE_ID, kind: 'whale_buy' });++ // Filtering client-side must request the API maximum, not the caller's limit,+ // or the filter would run over a pre-truncated slice.+ assert.equal(new URL(calls[0].url).searchParams.get('limit'), '50');+ assert.equal(result.count, 1);+ assert.equal(result.alerts[0].id, 1);+ assert.equal(result.alerts[0].read, false);+ assert.equal(result.unread_count, 3);+});++test('get_alert_history marks a read alert and summarizes each kind the way the site does', async (t) => {+ stubFetch(t, () =>+ jsonResponse({+ notifications: [+ {+ id: 9,+ created_at: '2026-08-15T05:21:00.000Z',+ read_at: '2026-08-15T05:22:00.000Z',+ payload: { kind: 'graduation', symbol: 'THREE', market_cap_usd: 69420 },+ },+ ],+ }),+ );++ const result = await getHistory.handler({ limit: 20 });+ assert.equal(result.alerts[0].read, true);+ assert.equal(result.alerts[0].summary, '$THREE graduated to AMM at $69,420 mcap');++ assert.equal(+ summarizeAlert({ kind: 'whale_buy', symbol: 'THREE', amount_sol: 12.5, amount_usd: 2310 }),+ 'Whale bought 12.50 SOL ($2,310) of $THREE',+ );+ assert.equal(+ summarizeAlert({ kind: 'price_below', symbol: 'THREE', threshold_usd: 50000, market_cap_usd: 48000 }),+ '$THREE mcap fell below $50,000 (now $48,000)',+ );+ assert.equal(summarizeAlert({ kind: 'new_mint', mint: THREE_MINT }), 'FeMb…pump just launched');+ assert.equal(summarizeAlert({ kind: 'unknown_kind' }), 'token alert');+});diff --git a/packages/alibaba-cloud-mcp/README.md b/packages/alibaba-cloud-mcp/README.mdindex 4059748be..72f4a3904 100644--- a/packages/alibaba-cloud-mcp/README.md+++ b/packages/alibaba-cloud-mcp/README.md@@ -104,6 +104,37 @@ Or add the server to your MCP client config:npx -y @modelcontextprotocol/inspector npx @three-ws/alibaba-cloud-mcp```+## Programmatic use++The package entry point (`@three-ws/alibaba-cloud-mcp`) exports **`buildServer()`**: a+fully-registered `McpServer` with no transport attached, so you can mount the three tools+inside a host of your own instead of spawning the binary. It reads `DASHSCOPE_API_KEY` when+called, and registration is otherwise side-effect free. The DashScope client itself is+importable from `@three-ws/alibaba-cloud-mcp/src/dashscope.js` (`loadConfig`,+`DashScopeClient`, `DashScopeError`) when you want the REST wrapper without MCP.++```js+// example.mjs — run with: DASHSCOPE_API_KEY=sk-... node example.mjs+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';+import { buildServer } from '@three-ws/alibaba-cloud-mcp';++const server = buildServer();++// What this server exposes, before connecting anything.+for (const [name, tool] of Object.entries(server._registeredTools)) {+ console.log(`${name}: ${tool.title}`);+}++// Serve it over stdio (what the bin does), or attach any other MCP transport.+await server.connect(new StdioServerTransport());+```++```+qwen_chat: Qwen Chat+qwen_embed: Qwen Text Embeddings+qwen_list_models: List DashScope Models+```+---Built by [three.ws](https://three.ws) · [three.ws/blog/three-ws-alibaba-cloud-partnership](https://three.ws/blog/three-ws-alibaba-cloud-partnership)diff --git a/packages/alibaba-cloud-mcp/package.json b/packages/alibaba-cloud-mcp/package.jsonindex de94f0022..b9767729b 100644--- a/packages/alibaba-cloud-mcp/package.json+++ b/packages/alibaba-cloud-mcp/package.json@@ -1,6 +1,6 @@{"name": "@three-ws/alibaba-cloud-mcp",- "version": "0.1.2",+ "version": "0.1.3","description": "MCP server for Alibaba Cloud DashScope by three.ws — Qwen chat, embeddings, and model discovery using your own Alibaba Cloud API key.","type": "module","author": "nirholas",@@ -55,6 +55,7 @@"inspect": "npx -y @modelcontextprotocol/inspector node src/index.js"},"dependencies": {- "@modelcontextprotocol/sdk": "^1.29.0"+ "@modelcontextprotocol/sdk": "^1.29.0",+ "zod": "^3.23.8"}}diff --git a/packages/alibaba-cloud-mcp/server.json b/packages/alibaba-cloud-mcp/server.jsonindex cfc868398..757d9b9d9 100644--- a/packages/alibaba-cloud-mcp/server.json+++ b/packages/alibaba-cloud-mcp/server.json@@ -18,12 +18,12 @@"source": "github","subfolder": "packages/alibaba-cloud-mcp"},- "version": "0.1.2",+ "version": "0.1.3","packages": [{"registryType": "npm","identifier": "@three-ws/alibaba-cloud-mcp",- "version": "0.1.2",+ "version": "0.1.3","runtimeHint": "npx","transport": {"type": "stdio"diff --git a/packages/alibaba-cloud-mcp/src/tools.js b/packages/alibaba-cloud-mcp/src/tools.jsindex e457351b5..537e1902d 100644--- a/packages/alibaba-cloud-mcp/src/tools.js+++ b/packages/alibaba-cloud-mcp/src/tools.js@@ -1,9 +1,12 @@// MCP tool definitions for the Alibaba Cloud DashScope MCP server.//-// Each entry pairs an MCP tool definition (name + JSON-Schema input) with a-// handler that maps validated arguments onto a DashScopeClient call. Handlers-// trust their inputs (the schema is the boundary) and let DashScopeError-// propagate — the server maps those to MCP tool errors with the upstream cause.+// Each entry pairs an MCP tool definition (name, title, annotations, and a Zod+// raw shape as the input schema) with a handler that maps validated arguments+// onto a DashScopeClient call. The SDK validates against the shape before the+// handler runs, so handlers trust their inputs and let DashScopeError propagate:+// the server maps those to MCP tool errors carrying the upstream cause.++import { z } from 'zod';const generativeAnnotations = {readOnlyHint: true,@@ -23,68 +26,52 @@ function jsonResult(structured, summary) {return { content: [{ type: 'text', text }], structuredContent: structured };}-const samplingProps = {- max_tokens: {- type: 'integer',- minimum: 1,- maximum: 32768,- description: 'Maximum tokens to generate.',- },- temperature: {- type: 'number',- minimum: 0,- maximum: 2,- description: 'Sampling temperature. 0 is greedy/deterministic.',- },- top_p: {- type: 'number',- minimum: 0,- maximum: 1,- description: 'Nucleus sampling probability mass.',- },+const samplingShape = {+ max_tokens: z+ .number()+ .int()+ .min(1)+ .max(32768)+ .optional()+ .describe('Maximum tokens to generate.'),+ temperature: z+ .number()+ .min(0)+ .max(2)+ .optional()+ .describe('Sampling temperature. 0 is greedy/deterministic.'),+ top_p: z.number().min(0).max(1).optional().describe('Nucleus sampling probability mass.'),};export function buildTools(client) {return [{- definition: {- name: 'qwen_chat',- title: 'Qwen Chat',- annotations: generativeAnnotations,- description:- 'Chat completion with an Alibaba Cloud Qwen model via DashScope. ' +- 'Pass a list of role/content messages and get the assistant reply plus ' +- 'token usage. Defaults to qwen-plus; use qwen-max for highest quality, ' +- 'qwen-turbo for fastest/cheapest, or qwen-long for very large contexts.',- inputSchema: {- type: 'object',- properties: {- messages: {- type: 'array',- minItems: 1,- description: 'Conversation so far, oldest first.',- items: {- type: 'object',- properties: {- role: {- type: 'string',- enum: ['system', 'user', 'assistant'],- },- content: { type: 'string' },- },- required: ['role', 'content'],- },- },- model: {- type: 'string',- description:- 'Override the model id. Options: qwen-max, qwen-plus (default), ' +- 'qwen-turbo, qwen-long, qwen-max-latest.',- },- ...samplingProps,- },- required: ['messages'],- },+ name: 'qwen_chat',+ title: 'Qwen Chat',+ annotations: generativeAnnotations,+ description:+ 'Chat completion with an Alibaba Cloud Qwen model via DashScope. ' ++ 'Pass a list of role/content messages and get the assistant reply plus ' ++ 'token usage. Defaults to qwen-plus; use qwen-max for highest quality, ' ++ 'qwen-turbo for fastest/cheapest, or qwen-long for very large contexts.',+ inputSchema: {+ messages: z+ .array(+ z.object({+ role: z.enum(['system', 'user', 'assistant']),+ content: z.string().min(1),+ }),+ )+ .min(1)+ .describe('Conversation so far, oldest first.'),+ model: z+ .string()+ .optional()+ .describe(+ 'Override the model id. Options: qwen-max, qwen-plus (default), ' ++ 'qwen-turbo, qwen-long, qwen-max-latest.',+ ),+ ...samplingShape,},handler: async (args) => {const result = await client.chat(args.messages, {@@ -98,40 +85,33 @@ export function buildTools(client) {},{- definition: {- name: 'qwen_embed',- title: 'Qwen Text Embeddings',- annotations: deterministicAnnotations,- description:- 'Generate text embeddings using Alibaba Cloud text-embedding models. ' +- 'Returns a float vector per input string. Useful for semantic search, ' +- 'clustering, and RAG retrieval. Defaults to text-embedding-v3 (1024-dim).',- inputSchema: {- type: 'object',- properties: {- inputs: {- oneOf: [- { type: 'string' },- { type: 'array', items: { type: 'string' }, minItems: 1 },- ],- description: 'One string or an array of strings to embed.',- },- model: {- type: 'string',- description:- 'Embedding model id (default: text-embedding-v3). ' +- 'Alternatives: text-embedding-v2, text-embedding-async-v3.',- },- dimensions: {- type: 'integer',- minimum: 64,- maximum: 2048,- description:- 'Output vector dimensions. text-embedding-v3 supports 64–2048 (default 1024).',- },- },- required: ['inputs'],- },+ name: 'qwen_embed',+ title: 'Qwen Text Embeddings',+ annotations: deterministicAnnotations,+ description:+ 'Generate text embeddings using Alibaba Cloud text-embedding models. ' ++ 'Returns a float vector per input string. Useful for semantic search, ' ++ 'clustering, and RAG retrieval. Defaults to text-embedding-v3 (1024-dim).',+ inputSchema: {+ inputs: z+ .union([z.string().min(1), z.array(z.string().min(1)).min(1)])+ .describe('One string or an array of strings to embed.'),+ model: z+ .string()+ .optional()+ .describe(+ 'Embedding model id (default: text-embedding-v3). ' ++ 'Alternatives: text-embedding-v2, text-embedding-async-v3.',+ ),+ dimensions: z+ .number()+ .int()+ .min(64)+ .max(2048)+ .optional()+ .describe(+ 'Output vector dimensions. text-embedding-v3 supports 64 to 2048 (default 1024).',+ ),},handler: async (args) => {const inputs = Array.isArray(args.inputs) ? args.inputs : [args.inputs];@@ -141,24 +121,19 @@ export function buildTools(client) {});return jsonResult(result,- `Embedded ${result.inputCount} string(s) with ${result.model} → ${result.dimensions}-dim vectors.`,+ `Embedded ${result.inputCount} string(s) with ${result.model}: ${result.dimensions}-dim vectors.`,);},},{- definition: {- name: 'qwen_list_models',- title: 'List DashScope Models',- annotations: deterministicAnnotations,- description:- 'List the models available on this DashScope account. ' +- 'Returns model ids, owners, and creation timestamps.',- inputSchema: {- type: 'object',- properties: {},- },- },+ name: 'qwen_list_models',+ title: 'List DashScope Models',+ annotations: deterministicAnnotations,+ description:+ 'List the models available on this DashScope account. ' ++ 'Returns model ids, owners, and creation timestamps.',+ inputSchema: {},handler: async () => {const models = await client.listModels();return jsonResult(diff --git a/packages/alibaba-cloud-mcp/test/handlers.test.mjs b/packages/alibaba-cloud-mcp/test/handlers.test.mjsnew file mode 100644index 000000000..c2dc2e98e--- /dev/null+++ b/packages/alibaba-cloud-mcp/test/handlers.test.mjs@@ -0,0 +1,284 @@+// Core-path behaviour for @three-ws/alibaba-cloud-mcp, with fetch stubbed.+//+// dashscope.test.mjs covers config resolution; this suite covers what the+// package actually does at runtime: the exact DashScope requests the client+// sends, how it maps responses and upstream failures, what each tool handler+// returns, and that buildServer() registers all three tools with a usable+// (Zod) input schema. Every test replaces globalThis.fetch via node:test's mock+// tracker (restored automatically per-test), so no request leaves the process.+//+// Run: node --test packages/alibaba-cloud-mcp/test/handlers.test.mjs++import { test } from 'node:test';+import assert from 'node:assert/strict';++// loadConfig() reads process.env at call time, and buildServer() calls it, so a+// key has to be present before the server is built.+process.env.DASHSCOPE_API_KEY = 'sk-test-key';+delete process.env.DASHSCOPE_BASE_URL;+delete process.env.DASHSCOPE_REGION;+delete process.env.DASHSCOPE_MODEL_ID;+delete process.env.DASHSCOPE_EMBED_MODEL_ID;++const { DashScopeClient, DashScopeError, loadConfig, INTL_BASE_URL } = await import(+ '../src/dashscope.js'+);+const { buildTools } = await import('../src/tools.js');+const { buildServer } = await import('../src/index.js');++const client = () => new DashScopeClient(loadConfig());++function jsonResponse(data, { status = 200 } = {}) {+ return {+ ok: status >= 200 && status < 300,+ status,+ text: async () => JSON.stringify(data),+ };+}++// Stub fetch for one test; returns the recorded calls [{ url, init }].+function stubFetch(t, responder) {+ const calls = [];+ t.mock.method(globalThis, 'fetch', async (url, init) => {+ calls.push({ url: String(url), init });+ return responder(String(url), init);+ });+ return calls;+}++const toolsByName = (c) => Object.fromEntries(buildTools(c).map((tool) => [tool.name, tool]));++// DashScopeClient: chat++test('chat POSTs the OpenAI-compatible completions endpoint with bearer auth', async (t) => {+ const calls = stubFetch(t, () =>+ jsonResponse({+ model: 'qwen-plus',+ choices: [{ message: { content: 'hello back' }, finish_reason: 'stop' }],+ usage: { total_tokens: 12 },+ }),+ );++ const result = await client().chat([{ role: 'user', content: 'hello' }]);++ assert.equal(calls.length, 1);+ assert.equal(calls[0].url, `${INTL_BASE_URL}/chat/completions`);+ assert.equal(calls[0].init.method, 'POST');+ assert.equal(calls[0].init.headers.authorization, 'Bearer sk-test-key');+ assert.equal(calls[0].init.headers['content-type'], 'application/json');++ const body = JSON.parse(calls[0].init.body);+ assert.equal(body.model, 'qwen-plus');+ assert.deepEqual(body.messages, [{ role: 'user', content: 'hello' }]);+ // Sampling knobs the caller did not set must not be sent at all, so the+ // account's own model defaults apply.+ assert.equal('temperature' in body, false);+ assert.equal('top_p' in body, false);++ assert.deepEqual(result, {+ text: 'hello back',+ finishReason: 'stop',+ usage: { total_tokens: 12 },+ model: 'qwen-plus',+ });+});++test('chat forwards an overridden model and the sampling parameters', async (t) => {+ const calls = stubFetch(t, () => jsonResponse({ choices: [] }));++ const result = await client().chat([{ role: 'user', content: 'hi' }], {+ model: 'qwen-max',+ maxTokens: 256,+ temperature: 0,+ topP: 0.8,+ });++ const body = JSON.parse(calls[0].init.body);+ assert.equal(body.model, 'qwen-max');+ assert.equal(body.max_tokens, 256);+ assert.equal(body.temperature, 0);+ assert.equal(body.top_p, 0.8);+ // An empty choices array is a real upstream shape, not a crash.+ assert.equal(result.text, '');+ assert.equal(result.model, 'qwen-max');+});++// DashScopeClient: embeddings++test('embed sends float encoding, wraps a single string, and orders vectors by index', async (t) => {+ const calls = stubFetch(t, () =>+ jsonResponse({+ model: 'text-embedding-v3',+ data: [+ { index: 1, embedding: [0.3, 0.4] },+ { index: 0, embedding: [0.1, 0.2] },+ ],+ usage: { total_tokens: 4 },+ }),+ );++ const result = await client().embed(['a', 'b'], { dimensions: 512 });++ assert.equal(calls[0].url, `${INTL_BASE_URL}/embeddings`);+ const body = JSON.parse(calls[0].init.body);+ assert.deepEqual(body.input, ['a', 'b']);+ assert.equal(body.encoding_format, 'float');+ assert.equal(body.dimensions, 512);++ // DashScope may return embeddings out of order; callers index by input.+ assert.deepEqual(result.vectors, [[0.1, 0.2], [0.3, 0.4]]);+ assert.equal(result.inputCount, 2);+ assert.equal(result.dimensions, 2);+ assert.equal(result.model, 'text-embedding-v3');+});++test('embed omits dimensions when unset and accepts a bare string', async (t) => {+ const calls = stubFetch(t, () => jsonResponse({ data: [{ index: 0, embedding: [1] }] }));++ await client().embed('one string');++ const body = JSON.parse(calls[0].init.body);+ assert.deepEqual(body.input, ['one string']);+ assert.equal('dimensions' in body, false);+});++// DashScopeClient: model discovery++test('listModels GETs /models and projects the fields the tool advertises', async (t) => {+ const calls = stubFetch(t, () =>+ jsonResponse({+ data: [{ id: 'qwen-max', object: 'model', owned_by: 'system', created: 1, extra: 'dropped' }],+ }),+ );++ const models = await client().listModels();++ assert.equal(calls[0].url, `${INTL_BASE_URL}/models`);+ assert.equal(calls[0].init.method, 'GET');+ assert.equal(calls[0].init.headers.authorization, 'Bearer sk-test-key');+ assert.deepEqual(models, [{ id: 'qwen-max', object: 'model', owned_by: 'system', created: 1 }]);+});++// Failure mapping++test('an upstream error becomes a DashScopeError carrying status and code', async (t) => {+ stubFetch(t, () =>+ jsonResponse(+ { error: { message: 'Invalid API-key provided.', code: 'InvalidApiKey', type: 'auth' } },+ { status: 401 },+ ),+ );++ await assert.rejects(client().listModels(), (err) => {+ assert.ok(err instanceof DashScopeError);+ assert.equal(err.status, 401);+ assert.equal(err.detail, 'InvalidApiKey');+ assert.match(err.message, /DashScope error \(401\): Invalid API-key provided\./);+ return true;+ });+});++test('a non-JSON error body still produces a coded error, not a parse crash', async (t) => {+ stubFetch(t, () => ({ ok: false, status: 502, text: async () => '<html>bad gateway</html>' }));++ await assert.rejects(client().listModels(), (err) => {+ assert.ok(err instanceof DashScopeError);+ assert.equal(err.status, 502);+ assert.match(err.message, /bad gateway/);+ return true;+ });+});++test('an aborted request maps to a timeout DashScopeError', async (t) => {+ stubFetch(t, () => {+ throw Object.assign(new Error('aborted'), { name: 'AbortError' });+ });++ await assert.rejects(client().chat([{ role: 'user', content: 'hi' }]), (err) => {+ assert.ok(err instanceof DashScopeError);+ assert.match(err.message, /timed out after 60000ms/);+ return true;+ });+});++// Tool handlers++test('qwen_chat returns the reply as the summary and the full result as structured content', async (t) => {+ stubFetch(t, () =>+ jsonResponse({+ model: 'qwen-plus',+ choices: [{ message: { content: 'four' }, finish_reason: 'stop' }],+ usage: { total_tokens: 3 },+ }),+ );++ const result = await toolsByName(client()).qwen_chat.handler({+ messages: [{ role: 'user', content: '2+2?' }],+ });++ assert.equal(result.content[0].type, 'text');+ assert.match(result.content[0].text, /^four\n\n\{/);+ assert.equal(result.structuredContent.text, 'four');+ assert.equal(result.structuredContent.usage.total_tokens, 3);+});++test('qwen_embed accepts one string or many and reports what it embedded', async (t) => {+ stubFetch(t, () =>+ jsonResponse({+ model: 'text-embedding-v3',+ data: [{ index: 0, embedding: [0.1, 0.2, 0.3] }],+ }),+ );++ const result = await toolsByName(client()).qwen_embed.handler({ inputs: 'one string' });++ assert.equal(result.structuredContent.inputCount, 1);+ assert.equal(result.structuredContent.dimensions, 3);+ assert.match(result.content[0].text, /Embedded 1 string\(s\) with text-embedding-v3/);+});++test('qwen_list_models counts what the account exposes', async (t) => {+ stubFetch(t, () => jsonResponse({ data: [{ id: 'qwen-plus' }, { id: 'qwen-turbo' }] }));++ const result = await toolsByName(client()).qwen_list_models.handler({});++ assert.equal(result.structuredContent.count, 2);+ assert.deepEqual(+ result.structuredContent.models.map((m) => m.id),+ ['qwen-plus', 'qwen-turbo'],+ );+ assert.match(result.content[0].text, /^2 models available/);+});++// Registration++test('buildServer registers all three tools with their annotations and a usable schema', () => {+ const tools = buildTools(client());+ assert.deepEqual(+ tools.map((tool) => tool.name),+ ['qwen_chat', 'qwen_embed', 'qwen_list_models'],+ );++ const registered = buildServer()._registeredTools;+ assert.ok(registered, 'McpServer should expose its tool registry');+ for (const tool of tools) {+ const entry = registered[tool.name];+ assert.ok(entry, `${tool.name} not registered on the server`);+ assert.equal(entry.title, tool.title);+ assert.deepEqual(entry.annotations, tool.annotations);+ // The SDK only keeps an inputSchema it recognized as a Zod shape; a raw+ // JSON Schema object is rejected at registration, which is how this+ // server shipped unable to start.+ assert.ok(entry.inputSchema, `${tool.name} must register a Zod input schema`);+ assert.equal(typeof entry.handler, 'function');+ }+});++test('the registered qwen_chat schema rejects an empty message list', () => {+ const entry = buildServer()._registeredTools.qwen_chat;+ assert.equal(entry.inputSchema.safeParse({ messages: [] }).success, false);+ assert.equal(+ entry.inputSchema.safeParse({ messages: [{ role: 'user', content: 'hi' }] }).success,+ true,+ );+});diff --git a/packages/assistant-mcp/README.md b/packages/assistant-mcp/README.mdindex b9c545574..2e7cdcb80 100644--- a/packages/assistant-mcp/README.md+++ b/packages/assistant-mcp/README.md@@ -127,6 +127,29 @@ Paste the `snippet` before `</body>` on any page, or drop the `frame_url` into a| --------------- | -------- | ------------------ || `THREE_WS_BASE` | no | `https://three.ws` |+## Programmatic use++The package entry point exports **`TOOLS`** (every tool definition: `name`, `title`,+`description`, `inputSchema`, `annotations`, `handler`) and **`buildServer()`**, which returns a+fully-registered `McpServer` with no transport attached. Both tools are pure and offline, so you+can call them directly as a widget-builder library with no MCP client involved.++```js+// run from a checkout: node this-file.mjs+import { TOOLS, buildServer } from '@three-ws/assistant-mcp';++const build = TOOLS.find((t) => t.name === 'build_assistant_widget');+const { snippet } = await build.handler({ avatar: '/avatars/michelle.glb', background: 'dusk' });+console.log(snippet);++// Or hand the whole registered server to your own MCP transport.+buildServer();+```++```html+<script src="https://three.ws/assistant/v1.js" async data-avatar="/avatars/michelle.glb" data-bg="dusk"></script>+```+## Links- Builder: https://three.ws/assistantdiff --git a/packages/irl/README.md b/packages/irl/README.mdindex 9b50c7977..1bdeb633c 100644--- a/packages/irl/README.md+++ b/packages/irl/README.md@@ -84,7 +84,7 @@ const fix = await checkIn(); // reads the browser's GPS, mints a prconst agents = await nearby(fix); // only answers for the area you checked in atfor (const a of agents) {- console.log(a.avatar_name, `${a.distance_m}m away`, a.caption);+ console.log(a.avatarName, `${a.distanceM}m away`, a.caption);}```@@ -151,22 +151,27 @@ header.|---|---|---|---|| `radius` | `number` | `40` | Metres. Clamped server-side to **10–60 m**. |-Each returned `Pin` (allow-list projection — never `user_id` or `device_token`):+Each returned `Pin` (allow-list projection — never `user_id` or `device_token`).+The SDK camelCases the wire row and keeps the untouched original on `raw`:| Field | Type | Notes ||---|---|---|| `id` | `string` | Pin UUID. |-| `agent_id` | `string \| null` | Linked agent identity, if any. |+| `agentId` | `string \| null` | Linked agent identity, if any. || `lat` / `lng` | `number` | Coarsened to ~1.1 m (5 dp). || `heading` | `number` | Facing, 0–359°. |-| `distance_m` | `number` | Great-circle metres from your fix. |-| `avatar_url` | `string` | GLB to load (relative or first-party https). |-| `avatar_name` / `caption` | `string \| null` | Public display text. |-| `x402_endpoint` | `string \| null` | First-party pay target for the agent. |-| `view_count` | `number` | Deduplicated visitor count. |-| `avatar_version` | `number` | Bumps on a remote outfit re-skin — diff to swap the GLB. |-| `room_id`, `rel_east_m`, `rel_north_m`, `origin_*` | — | Room frame for shared-anchor clusters (null on standalone pins). |-| `is_mine` | `boolean` | True for the caller's own pins. |+| `distanceM` | `number` | Great-circle metres from your fix. |+| `avatarUrl` | `string` | GLB to load (relative or first-party https). |+| `avatarName` / `caption` | `string \| null` | Public display text. |+| `x402Endpoint` | `string \| null` | First-party pay target for the agent. |+| `viewCount` | `number` | Deduplicated visitor count. |+| `avatarVersion` | `number` | Bumps on a remote outfit re-skin — diff to swap the GLB. |+| `placedAt` | `string \| null` | When the pin was dropped. |+| `anchorHeightM`, `anchorYawDeg`, `anchorQuat`, `anchorSource` | — | AR replay pose, when the placement carried one. |+| `gpsAccuracyM`, `altitudeM` | `number \| null` | Fix quality at placement time. |+| `roomId`, `relEastM`, `relNorthM`, `originLat`, `originLng`, `originYawDeg` | — | Room frame for shared-anchor clusters (null on standalone pins). |+| `isMine` | `boolean` | True for the caller's own pins. |+| `raw` | `unknown` | The untouched wire row (`avatar_name`, `distance_m`, …). |Pins are sorted nearest-first and filtered to those within `radius`.@@ -197,6 +202,11 @@ List the pins you placed. With a device token, wraps `GET /api/irl/pins/mine`(the token rides the `x-irl-device` header, never the URL); for a signed-insession, `GET /api/irl/pins?mine=1`.+Your own pins carry the owner-only fields the public feed strips: `expiresAt`+and `permanent` (`true` for signed-in owners, `false` for anonymous 7-day+placements) instead of `distanceM` and `isMine`. `placePin()` returns a pin in+the same shape.+### `interact(input) → Promise<object>`Log a real-world encounter. Wraps `POST /api/irl/interactions`.diff --git a/packages/mocap/README.md b/packages/mocap/README.mdindex ecc5fade7..bf660892b 100644--- a/packages/mocap/README.md+++ b/packages/mocap/README.md@@ -79,7 +79,7 @@ const { id, slug } = await saveClip(recording, {}, { token: process.env.THREEWS_TOKEN });const clip = await getClip(id);-console.log(clip.frame_count, 'frames,', clip.duration, 'seconds');+console.log(clip.frameCount, 'frames,', clip.duration, 'seconds');// → drop clip.frames into FaceMocap.play(clip) on any ARKit avatar```@@ -123,7 +123,7 @@ A `Frame` is `{ t: number, shapes: Record<string, number>, mat?: number[16] | nu| `description` | `string` | — | Up to 2000 chars. || `tags` | `string[]` | `[]` | Up to 20 tags, ≤40 chars each. || `visibility` | `'private' \| 'unlisted' \| 'public'` | `'private'` | |-| `avatar_id` | `uuid` | — | Bind the clip to one of your avatars. Must be owned by you. |+| `avatarId` | `uuid` | — | Bind the clip to one of your avatars. Must be owned by you. (`avatar_id` is accepted too.) |Returns the created `Clip` (`201`). `kind` (`face` / `pose` / `hand` / `vmc`) isderived from `format` server-side.@@ -139,7 +139,7 @@ A slug is unique per owner, not globally, so a slug lookup resolves to your ownclip when you are authenticated and otherwise to the oldest public clip carryingit. Pass the `id` when you need to name one exact clip.-### `listClips(auth, opts?) → Promise<{ items, next_cursor }>`+### `listClips(auth, opts?) → Promise<{ items, nextCursor }>`List clips **without frames** (metadata only — cheap). Wraps`GET /api/mocap/clips`. Cursor-paginated, newest first.@@ -147,7 +147,7 @@ List clips **without frames** (metadata only — cheap). Wraps| Option | Type | Default | Notes ||---|---|---|---|| `limit` | `number` | `50` | Clamped to `1`–`100`. |-| `cursor` | `string` | — | `next_cursor` from the previous page. |+| `cursor` | `string` | — | `nextCursor` from the previous page. || `kind` | `'face' \| 'pose' \| 'hand' \| 'vmc'` | — | Filter by clip kind. || `includePublic` | `boolean` | `false` | Authed: union your clips with the public pool. |@@ -157,7 +157,7 @@ library; add `includePublic: true` to fold in public clips too.### `updateClip(idOrSlug, patch, auth) → Promise<Clip>`Edit metadata. Wraps `PATCH /api/mocap/clips/:id` (owner only). Patchable:-`name`, `description`, `tags`, `visibility`, `avatar_id`, and `price`. Set+`name`, `description`, `tags`, `visibility`, `avatarId`, and `price`. Set`price: { amount, currency }` to list the clip for sale, or `price: null` to makeit free again. Bearer tokens need the `avatars:write` scope.@@ -166,7 +166,8 @@ it free again. Bearer tokens need the `avatars:write` scope.Soft-delete a clip you own. Wraps `DELETE /api/mocap/clips/:id`. The row istombstoned (`deleted_at`), not destroyed. Bearer tokens need `avatars:delete`.-**`Clip` shape** (returned by every call; `frames` only on `getClip`):+**`Clip` shape** (returned by every call; `frames` only on `getClip`). The SDK+camelCases the wire row and keeps the untouched original on `raw`:| Field | Type | Notes ||---|---|---|@@ -174,15 +175,16 @@ tombstoned (`deleted_at`), not destroyed. Bearer tokens need `avatars:delete`.| `name` / `description` | `string` | Library metadata. || `kind` | `'face' \| 'pose' \| 'hand' \| 'vmc'` | Derived from `format`. || `format` | `string` | Wire-format version string. |-| `duration_ms` / `duration` | `number` | Milliseconds / seconds. |-| `frame_count` | `number` | Number of frames. |+| `durationMs` / `duration` | `number` | Milliseconds / seconds. |+| `frameCount` | `number` | Number of frames. || `frames` | `Frame[]` | Present only on `getClip`. || `tags` | `string[]` | || `visibility` | `string` | `private` / `unlisted` / `public`. |-| `avatar_id` | `uuid \| null` | Bound avatar, if any. |-| `play_count` | `number` | Non-owner fetches. |+| `avatarId` | `uuid \| null` | Bound avatar, if any. |+| `playCount` | `number` | Non-owner fetches. || `price` | `{ amount, currency } \| null` | `null` when free. || `owner` | `'self' \| 'other'` | Relative to the caller. |+| `raw` | `unknown` | The untouched wire row (`duration_ms`, `frame_count`, …). |## How it works@@ -284,9 +286,9 @@ import { listClips } from '@three-ws/mocap';let cursor;const all = [];do {- const page = await listClips({}, { includePublic: false, limit: 100, cursor });+ const page = await listClips({}, { includePublic: true, limit: 100, cursor });all.push(...page.items);- cursor = page.next_cursor;+ cursor = page.nextCursor;} while (cursor);```diff --git a/packages/names/README.md b/packages/names/README.mdindex 99ed49be8..f02d33267 100644--- a/packages/names/README.md+++ b/packages/names/README.md@@ -80,8 +80,12 @@ const eth = await resolve('vitalik.eth');console.log(eth.address); // → 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045const sol = await resolve('bonfida.sol');-console.log(sol.address); // → owner base58 wallet-console.log(sol.allDomains); // → other .sol domains the owner holds+console.log(sol.address); // → owner base58 wallet++// Opt in to the owner's full name list (two extra SNS-index lookups server-side):+const full = await resolve('bonfida.sol', { domains: true });+console.log(full.favoriteDomain); // → the owner's primary .sol, if they set one+console.log(full.allDomains); // → every .sol they hold (capped at 100)```Mint a subdomain for an agent and pay it by name:@@ -90,15 +94,15 @@ Mint a subdomain for an agent and pay it by name:import { mintSubdomain, payByName } from '@three-ws/names';// Registers alice.threews.sol on-chain, transfers it to the agent's wallet.-const { full_name, signature } = await mintSubdomain({+const { fullName, signature } = await mintSubdomain({agentId: 'agt_7Yq…',label: 'alice', // optional — defaults to the agent's slugified nametoken: process.env.THREEWS_TOKEN,});-console.log(full_name); // → alice.threews.sol+console.log(fullName); // → alice.threews.sol// Build an unsigned 5-USDC transfer to that name for a browser wallet to sign.-const { tx_base64, recipient } = await payByName('alice.threews.sol', '5', {+const { txBase64, recipient } = await payByName('alice.threews.sol', '5', {payerWallet: myWallet.publicKey.toBase58(),});console.log(recipient.address, recipient.source); // resolved wallet + 'sns'@@ -112,6 +116,13 @@ Resolve a name to an address. `.eth` goes to ENS, `.sol` to SNS, and a barelabel (`vitalik`) is tried against the `.sol` registry. Wraps`GET /api/sns?name=<name>` for `.sol` and the ENS resolver for `.eth`.+**Options**++| Option | Type | Default | Notes |+|---|---|---|---|+| `domains` | `boolean` | `false` | (SNS) also return every `.sol` the owner holds and their favorite domain. Off by default: it adds two SNS-index lookups the address resolution itself does not need. |+| `signal` | `AbortSignal` | — | Cancel the request. |+**Returns** `ResolveResult`| Field | Type | Notes |@@ -120,8 +131,10 @@ label (`vitalik`) is tried against the `.sol` registry. Wraps| `address` | `string \| null` | Owner wallet. `null` when `resolved` is `false`. || `network` | `'solana' \| 'ethereum'` | Which registry answered. || `resolved` | `boolean` | `false` is a routine "no such name", **not** an error. |-| `allDomains` | `string[]` | (SNS) other `.sol` domains the owner holds. |-| `favoriteDomain` | `string \| null` | (SNS) the owner's primary `.sol`, if set. |+| `allDomains` | `string[]` | (SNS) every `.sol` the owner holds, capped at 100. Empty unless you passed `domains: true`. |+| `favoriteDomain` | `string \| null` | (SNS) the owner's primary `.sol`. Null unless you passed `domains: true`. |+| `domainsTruncated` | `boolean` | `true` when the owner holds more than the 100 names returned. |+| `raw` | `unknown` | The untouched wire envelope. |A `.sol` miss returns `200` with `resolved: false` — the reverse-lookup thatruns on every page load makes "no domain" an expected answer, so it is never a@@ -131,7 +144,10 @@ runs on every page load makes "no domain" an expected answer, so it is never aFind the primary `.sol` for a wallet. Wraps `GET /api/sns?address=<base58>`.Returns the same envelope with `name` populated (or `null` if the wallet has no-favorite domain).+favorite domain). Takes the same `domains` option, which is the difference+between "unnamed wallet" and "wallet holding domains but no primary": a wallet+with no favorite still answers `resolved: false`, now with its `allDomains`+list alongside.### `checkSubdomain(label) → Promise<Availability>`@@ -142,7 +158,7 @@ Check whether `<label>.threews.sol` is free. Wraps|---|---|---|| `label` | `string` | Normalized label. || `parent` | `string` | `threews.sol`. |-| `full_name` | `string` | `<label>.threews.sol`. |+| `fullName` | `string` | `<label>.threews.sol`. || `available` | `boolean` | `true` if no on-chain owner. || `owner` | `string \| null` | Current on-chain owner, if any. |@@ -162,7 +178,7 @@ to a wallet — atomically, in one platform-signed transaction. Wraps| `space` | `number` | Optional, 1000–10000. Registry bytes reserved. Default `2000`. || `token` | `string` | Bearer token (or rely on a session cookie). |-**Returns** `MintResult`: `{ ok, agent_id, full_name, parent, owner, signature, explorer, url_record, agent_url }`. The new subdomain's URL record points at+**Returns** `MintResult`: `{ ok, agentId, fullName, parent, owner, signature, explorer, urlRecord, agentUrl }` (the untouched wire body stays on `raw`). The new subdomain's URL record points at`https://three.ws/a/<agentId>`, and the agent's `meta.sns_domain` is set so x402manifests can show `recipient_name` without an extra round-trip.@@ -196,7 +212,7 @@ agent wallet; **`.sol` domain** (including `foo.threews.sol`) → on-chain owner| `message` | `string` | — | Optional memo. || `token` | `string` | — | Bearer token for `send`. |-**Returns (`prep`)** `{ recipient, amount_usdc, tx_base64, blockhash, last_valid_block_height, mint }` — decode `tx_base64` into a `VersionedTransaction`, sign with the payer wallet, and submit. **Returns (`send`)** `{ recipient, payer, amount_usdc, signature, mode }`. `amount_usdc` accepts a string or number, must be `> 0` and `≤ 10000`.+**Returns (`prep`)** `{ mode: 'prep', recipient, amountUsdc, txBase64, blockhash, lastValidBlockHeight, mint }` — decode `txBase64` into a `VersionedTransaction`, sign with the payer wallet, and submit. **Returns (`send`)** `{ mode: 'send', recipient, payer, amountUsdc, signature }`. The `amountUsdc` argument accepts a string or number, must be `> 0` and `≤ 10000`.### `resolvePayee(name) → Promise<Payee>`@@ -217,8 +233,8 @@ string you pass:▼ ▼ ▼ENS resolver Bonfida SNS users.username(eth RPC, resolve() + reverse → default agent- failover, domains + fav-domain Solana wallet- 3s timeout) (.threews.sol also+ failover, (+ index lookup when Solana wallet+ 3s timeout) domains: true) (.threews.sol also│ │ surfaces a DB claim)▼ ▼ ▼0x… address owner base58 recipient address@@ -230,8 +246,10 @@ string you pass:- **ENS** resolves on Ethereum mainnet through a failover provider, bounded bya 3-second timeout. A reverse lookup of the owner's primary name isbest-effort.-- **SNS** resolves through Bonfida — owner wallet, the owner's other `.sol`- domains, and their favorite domain.+- **SNS** resolves through Bonfida to the owner wallet. Pass `domains: true` and+ the resolution also reads the Bonfida SNS index for every `.sol` that owner+ holds plus their favorite domain, both best-effort: an index outage returns+ the plain envelope rather than failing the resolve.- **Subdomain minting** is a single on-chain transaction: `createSubdomain`(parent owner becomes owner) → `createRecordV2Instruction` writes the URLrecord while the platform still owns it (so `<label>.threews.sol` resolves in@@ -301,10 +319,10 @@ const { data } = await r.json();```jsimport { mintSubdomain, resolvePayee } from '@three-ws/names';-const { full_name } = await mintSubdomain({ agentId, label: 'oracle', token });+const { fullName } = await mintSubdomain({ agentId, label: 'oracle', token });// → oracle.threews.sol, owned by the agent's wallet, URL record → /a/<agentId>-const payee = await resolvePayee(full_name);+const payee = await resolvePayee(fullName);// → { name: 'oracle.threews.sol', address: '…', source: 'sns', claim: … }```@@ -314,10 +332,10 @@ const payee = await resolvePayee(full_name);import { payByName } from '@three-ws/names';import { VersionedTransaction } from '@solana/web3.js';-const { tx_base64 } = await payByName('alice.threews.sol', '2.5', {+const { txBase64 } = await payByName('alice.threews.sol', '2.5', {payerWallet: wallet.publicKey.toBase58(),});-const tx = VersionedTransaction.deserialize(Buffer.from(tx_base64, 'base64'));+const tx = VersionedTransaction.deserialize(Buffer.from(txBase64, 'base64'));const signed = await wallet.signTransaction(tx);const sig = await connection.sendRawTransaction(signed.serialize());```diff --git a/packages/names/src/index.d.ts b/packages/names/src/index.d.tsindex a84cae197..821e219ec 100644--- a/packages/names/src/index.d.ts+++ b/packages/names/src/index.d.ts@@ -36,6 +36,15 @@ export interface CallOptions {token?: string;}+export interface ResolveOptions extends CallOptions {+ /**+ * (SNS) also fetch every `.sol` the owner holds and their favorite domain.+ * Off by default: it costs two extra lookups against the SNS index, which a+ * plain address resolution does not need.+ */+ domains?: boolean;+}+export interface ResolveResult {/** The resolved name, e.g. `alice.sol` or `vitalik.eth`. Null on a miss. */name: string | null;@@ -45,10 +54,12 @@ export interface ResolveResult {network: Network;/** `false` is a routine "no such name", not an error (SNS only). */resolved: boolean;- /** (SNS) other `.sol` domains the owner holds. */+ /** (SNS) every `.sol` the owner holds. Empty unless the call passed `domains: true`. */allDomains: string[];- /** (SNS) the owner's primary `.sol`, if set. */+ /** (SNS) the owner's primary `.sol`. Null unless the call passed `domains: true`. */favoriteDomain: string | null;+ /** (SNS) true when `allDomains` hit the 100-name cap and more exist. */+ domainsTruncated: boolean;/** (ENS) agents registered to the resolved address. */agents?: unknown[];raw: unknown;@@ -170,8 +181,8 @@ export interface PaySendResult {export type PayResult = PayPrepResult | PaySendResult;export interface NamesClient {- resolve(name: string, opts?: CallOptions): Promise<ResolveResult>;- reverseLookup(address: string, opts?: CallOptions): Promise<ResolveResult>;+ resolve(name: string, opts?: ResolveOptions): Promise<ResolveResult>;+ reverseLookup(address: string, opts?: ResolveOptions): Promise<ResolveResult>;checkSubdomain(label: string, opts?: CallOptions): Promise<Availability>;mintSubdomain(input: MintInput): Promise<MintResult>;claimSubdomain(input: ClaimInput): Promise<ClaimResult>;@@ -181,8 +192,8 @@ export interface NamesClient {}export declare function createNames(options?: NamesClientOptions): NamesClient;-export declare function resolve(name: string, opts?: CallOptions): Promise<ResolveResult>;-export declare function reverseLookup(address: string, opts?: CallOptions): Promise<ResolveResult>;+export declare function resolve(name: string, opts?: ResolveOptions): Promise<ResolveResult>;+export declare function reverseLookup(address: string, opts?: ResolveOptions): Promise<ResolveResult>;export declare function checkSubdomain(label: string, opts?: CallOptions): Promise<Availability>;export declare function mintSubdomain(input: MintInput): Promise<MintResult>;export declare function claimSubdomain(input: ClaimInput): Promise<ClaimResult>;diff --git a/packages/names/src/index.js b/packages/names/src/index.jsindex 82b4ec891..b20b6bbd5 100644--- a/packages/names/src/index.js+++ b/packages/names/src/index.js@@ -51,7 +51,10 @@ export function createNames(options = {}) {{ code: 'invalid_input' },);}- const res = await request('/api/sns', { query: { name: trimmed }, signal: opts.signal });+ const res = await request('/api/sns', {+ query: prune({ name: trimmed, domains: domainsFlag(opts) }),+ signal: opts.signal,+ });return shapeSns(res);}@@ -61,7 +64,10 @@ export function createNames(options = {}) {if (!ADDR_RE.test(addr)) {throw new ThreeWsError('reverseLookup() needs a base58 Solana address.', { code: 'invalid_input' });}- const res = await request('/api/sns', { query: { address: addr }, signal: opts.signal });+ const res = await request('/api/sns', {+ query: prune({ address: addr, domains: domainsFlag(opts) }),+ signal: opts.signal,+ });return shapeSns(res);}@@ -247,6 +253,9 @@ function unwrap(res) {return res;}+// `allDomains` / `favoriteDomain` are only populated when the call asked for+// them with `{ domains: true }`; the endpoint omits both otherwise rather than+// paying for the SNS index lookup on every resolve.function shapeSns(res) {const d = unwrap(res) || {};return {@@ -256,10 +265,17 @@ function shapeSns(res) {resolved: Boolean(d.resolved),allDomains: Array.isArray(d.all_domains) ? d.all_domains : [],favoriteDomain: d.favorite_domain ?? null,+ domainsTruncated: Boolean(d.domains_truncated),raw: res,};}+// The endpoint takes `domains=1`; anything falsy is left off the query entirely+// so the default resolve stays a single cache-friendly URL.+function domainsFlag(opts) {+ return opts && opts.domains ? '1' : undefined;+}+function shapeEns(res) {const d = res || {};const address = d.address ?? null;@@ -270,6 +286,7 @@ function shapeEns(res) {resolved: Boolean(address),allDomains: [],favoriteDomain: null,+ domainsTruncated: false,agents: Array.isArray(d.agents) ? d.agents : [],raw: res,};diff --git a/packages/names/test/names.test.js b/packages/names/test/names.test.jsindex a913978ee..e5b069b9b 100644--- a/packages/names/test/names.test.js+++ b/packages/names/test/names.test.js@@ -28,7 +28,7 @@ const SYNTH_PAYER = 'THREEsynthpayer11111111111111111111111111111';test('resolve() routes a .sol name to /api/sns and camelCases the envelope', async () => {const { fetch, calls } = stubFetch([- { body: { data: { name: 'bonfida.sol', address: SYNTH_OWNER, network: 'solana', resolved: true, all_domains: ['bonfida.sol', 'naming.sol'], favorite_domain: 'bonfida.sol' } } },+ { body: { data: { name: 'bonfida.sol', address: SYNTH_OWNER, network: 'solana', resolved: true } } },]);const client = createNames({ fetch, baseUrl: 'https://three.ws' });const res = await client.resolve('bonfida.sol');@@ -36,12 +36,28 @@ test('resolve() routes a .sol name to /api/sns and camelCases the envelope', asyassert.equal(calls[0].url.pathname, '/api/sns');assert.equal(calls[0].url.searchParams.get('name'), 'bonfida.sol');assert.equal(calls[0].init.method, 'GET');+ // The owner's domain list costs two extra SNS-index lookups server-side, so+ // a plain resolve must not ask for it.+ assert.equal(calls[0].url.searchParams.has('domains'), false);assert.equal(res.address, SYNTH_OWNER);assert.equal(res.network, 'solana');assert.equal(res.resolved, true);+ assert.deepEqual(res.allDomains, []);+ assert.equal(res.favoriteDomain, null);+ assert.ok(res.raw, 'keeps a raw escape hatch');+});++test('resolve({ domains: true }) asks for the owner list and maps it', async () => {+ const { fetch, calls } = stubFetch([+ { body: { data: { name: 'bonfida.sol', address: SYNTH_OWNER, network: 'solana', resolved: true, all_domains: ['bonfida.sol', 'naming.sol'], favorite_domain: 'bonfida.sol', domains_truncated: true } } },+ ]);+ const client = createNames({ fetch });+ const res = await client.resolve('bonfida.sol', { domains: true });++ assert.equal(calls[0].url.searchParams.get('domains'), '1');assert.deepEqual(res.allDomains, ['bonfida.sol', 'naming.sol']);assert.equal(res.favoriteDomain, 'bonfida.sol');- assert.ok(res.raw, 'keeps a raw escape hatch');+ assert.equal(res.domainsTruncated, true);});test('resolve() routes a .eth name to the ENS endpoint', async () => {@@ -83,11 +99,25 @@ test('reverseLookup() queries by address and validates base58 first', async () =const client = createNames({ fetch });const res = await client.reverseLookup(SYNTH_OWNER);assert.equal(calls[0].url.searchParams.get('address'), SYNTH_OWNER);+ assert.equal(calls[0].url.searchParams.has('domains'), false);assert.equal(res.name, 'bonfida.sol');await assert.rejects(() => client.reverseLookup('xyz'), /base58 Solana address/);});+test('reverseLookup({ domains: true }) lists a wallet that has no favorite yet', async () => {+ const { fetch, calls } = stubFetch([+ { body: { data: { name: null, address: SYNTH_OWNER, network: 'solana', resolved: false, all_domains: ['naming.sol'], favorite_domain: null } } },+ ]);+ const client = createNames({ fetch });+ const res = await client.reverseLookup(SYNTH_OWNER, { domains: true });++ assert.equal(calls[0].url.searchParams.get('domains'), '1');+ assert.equal(res.resolved, false, 'no primary domain is not an error');+ assert.deepEqual(res.allDomains, ['naming.sol']);+ assert.equal(res.domainsTruncated, false);+});+test('checkSubdomain() reads availability and maps full_name → fullName', async () => {const { fetch, calls } = stubFetch([{ body: { data: { label: 'alice', parent: 'threews.sol', full_name: 'alice.threews.sol', available: true, owner: null } } },diff --git a/packages/notifications-mcp/src/tools/get-preferences.js b/packages/notifications-mcp/src/tools/get-preferences.jsindex b1c5dee07..0638dfadd 100644--- a/packages/notifications-mcp/src/tools/get-preferences.js+++ b/packages/notifications-mcp/src/tools/get-preferences.js@@ -14,8 +14,9 @@ export const def = {description:"Read the account's notification delivery preferences — the resolved channel matrix the platform " +'uses to decide how each kind of event reaches the owner. Returns `categories` (the catalog of ' +- 'user-facing groups: sales, purchases, social, irl, alerts, account — each with a label and ' +- 'description), `channels` (the deliverable channels: in_app, push, email, telegram), `prefs` (the ' ++ 'user-facing groups: sales, purchases, social, irl, alerts, creations, account, each with a label, a ' ++ 'description, and any `lockedChannels` that cannot be switched off), `channels` (the deliverable ' ++ 'channels: in_app, push, email, telegram), `prefs` (the ' +'effective per-category → per-channel on/off matrix with sparse user overrides already merged onto ' +'defaults, plus the linked `telegram_chat_id` if any), and `push` (how many web-push devices are ' +'registered). Read this before calling set_preferences so you patch from the real current state. ' +diff --git a/packages/notifications-mcp/src/tools/set-preferences.js b/packages/notifications-mcp/src/tools/set-preferences.jsindex 5ef24b210..48f7c467a 100644--- a/packages/notifications-mcp/src/tools/set-preferences.js+++ b/packages/notifications-mcp/src/tools/set-preferences.js@@ -2,7 +2,7 @@//// Wraps PUT /api/notifications/preferences { categories, telegram_chat_id } →// { ok, prefs }. The body is a sparse override sanitised server-side: only-// known categories (sales, purchases, social, irl, alerts, account) and channels+// known categories (sales, purchases, social, irl, alerts, creations, account) and channels// (in_app, push, email, telegram) survive; everything else is dropped. Re-sending// the same matrix is a no-op — idempotent.@@ -10,7 +10,10 @@ import { z } from 'zod';import { apiRequest } from '../lib/api.js';-const CATEGORY_KEYS = ['sales', 'purchases', 'social', 'irl', 'alerts', 'account'];+// Kept in step with CATEGORIES in api/_lib/notify-prefs.js, the server-side+// source of truth. A key missing here is a category the model is told does not+// exist and therefore never patches, even though the API would accept it.+const CATEGORY_KEYS = ['sales', 'purchases', 'social', 'irl', 'alerts', 'creations', 'account'];const CHANNEL_KEYS = ['in_app', 'push', 'email', 'telegram'];export const def = {@@ -24,7 +27,9 @@ export const def = {'Only the category/channel pairs you pass change; unknown keys are dropped server-side and untouched ' +'pairs keep their current value (which falls back to the platform default). Pass `telegram_chat_id` ' +'(a numeric Telegram chat id, or "" to unlink) to control where the telegram channel delivers. ' +- 'Provide at least one of `categories` or `telegram_chat_id`. WRITE but idempotent — re-applying the ' ++ 'Provide at least one of `categories` or `telegram_chat_id`. `account` locks its `in_app` channel on: ' ++ 'security and withdrawal notices always reach the bell inbox, so `false` there is ignored. ' ++ 'WRITE but idempotent, re-applying the ' +'same values is a no-op. Returns the full resolved preference matrix after the update. Read it first ' +'with get_preferences.',inputSchema: {diff --git a/packages/pumpfun-mcp/src/index.js b/packages/pumpfun-mcp/src/index.jsindex ff89d771b..16c9fa3b8 100755--- a/packages/pumpfun-mcp/src/index.js+++ b/packages/pumpfun-mcp/src/index.js@@ -16,7 +16,9 @@// Run standalone: npx @three-ws/pumpfun-mcp// Inspect: npx -y @modelcontextprotocol/inspector npx @three-ws/pumpfun-mcp+import { realpathSync } from 'node:fs';import { createRequire } from 'node:module';+import { pathToFileURL } from 'node:url';import { Server } from '@modelcontextprotocol/sdk/server/index.js';import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';@@ -28,7 +30,14 @@ import { buildNativeRegistry } from './native.js';const require = createRequire(import.meta.url);const { version: SERVER_VERSION } = require('../package.json');-const BACKEND_URL = process.env.PUMPFUN_MCP_URL || 'https://three.ws/api/pump-fun-mcp';+// The bundled offline tool surface, re-exported so an embedder can read the+// advertised tools (and their annotations) without spawning the server.+export { FALLBACK_TOOLS, TOOL_ANNOTATIONS } from './tools.js';++// Resolved per call, not once at import: the bin reads it at startup either way,+// and a lazy read lets an embedder (or a test) repoint the bridge after the module+// is already loaded.+const backendUrl = () => process.env.PUMPFUN_MCP_URL || 'https://three.ws/api/pump-fun-mcp';const SERVER_NAME = 'three.ws-pumpfun-mcp';// A monotonically increasing JSON-RPC id for backend calls. Local to this@@ -39,17 +48,18 @@ let rpcId = 0;// envelope. Throws on transport-level failure (network, non-2xx, bad JSON) so// callers surface a real error rather than a fabricated payload.async function callBackend(method, params, timeoutMs = 30_000) {+ const url = backendUrl();const controller = new AbortController();const timer = setTimeout(() => controller.abort(), timeoutMs);try {- const res = await fetch(BACKEND_URL, {+ const res = await fetch(url, {method: 'POST',headers: { 'content-type': 'application/json', accept: 'application/json' },body: JSON.stringify({ jsonrpc: '2.0', id: ++rpcId, method, params }),signal: controller.signal,});if (!res.ok) {- throw new Error(`backend ${BACKEND_URL} → HTTP ${res.status}`);+ throw new Error(`backend ${url} answered HTTP ${res.status}`);}return await res.json();} finally {@@ -100,9 +110,17 @@ function withLocalAnnotations(tool) {};}-async function main() {+/**+ * Build the fully-registered MCP server without connecting a transport. Asks the+ * backend for its authoritative tool list, so this is a live call; the bundled+ * FALLBACK_TOOLS cover an unreachable backend. Safe to import (tests, embedding+ * this bridge in another process).+ *+ * @returns {Promise<Server>}+ */+export async function buildServer() {const backendTools = await loadTools();- const native = buildNativeRegistry(BACKEND_URL, callTool);+ const native = buildNativeRegistry(backendUrl(), callTool);const tools = [...backendTools.map(withLocalAnnotations), ...native.defs];const server = new Server(@@ -188,14 +206,35 @@ async function main() {return { content: [{ type: 'text', text: JSON.stringify(result ?? null) }] };});+ server.threeWsToolCount = tools.length;+ return server;+}++async function main() {+ const server = await buildServer();const transport = new StdioServerTransport();await server.connect(transport);process.stderr.write(- `[pumpfun-mcp] ${SERVER_NAME} v${SERVER_VERSION} ready — ${tools.length} tools via ${BACKEND_URL}\n`,+ `[pumpfun-mcp] ${SERVER_NAME} v${SERVER_VERSION} ready with ${server.threeWsToolCount} tools via ${backendUrl()}\n`,);}-main().catch((err) => {- process.stderr.write(`[pumpfun-mcp] fatal: ${err?.stack || err}\n`);- process.exit(1);-});+// Connect stdio ONLY when this file is the process entry point. Importing the+// module (tests, embedding) must not grab the transport or the process's stdin+// and stdout. realpath both sides: npm bin shims are symlinks, so argv[1] may+// differ from import.meta.url.+function isProcessEntryPoint() {+ if (!process.argv[1]) return false;+ try {+ return import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href;+ } catch {+ return false;+ }+}++if (isProcessEntryPoint()) {+ main().catch((err) => {+ process.stderr.write(`[pumpfun-mcp] fatal: ${err?.stack || err}\n`);+ process.exit(1);+ });+}diff --git a/packages/pumpfun-mcp/test/entrypoint.test.mjs b/packages/pumpfun-mcp/test/entrypoint.test.mjsnew file mode 100644index 000000000..d4ea5aaa0--- /dev/null+++ b/packages/pumpfun-mcp/test/entrypoint.test.mjs@@ -0,0 +1,74 @@+// Entry-point invariants for @three-ws/pumpfun-mcp.+//+// package.json declares src/index.js as BOTH the `bin` and the `main`/`exports`+// entry. Those two roles pull in opposite directions: running it must connect a+// stdio MCP server, and importing it must not. Until this was guarded, the module+// called main() unconditionally, so `import '@three-ws/pumpfun-mcp'` seized the+// process's stdin and stdout and printed a server banner in any host that merely+// read the package's exports.+//+// These tests run offline: importing the module must reach neither the network+// nor the transport.+//+// Run: node --test packages/pumpfun-mcp/test/entrypoint.test.mjs++import { test } from 'node:test';+import assert from 'node:assert/strict';+import { execFile } from 'node:child_process';+import { createRequire } from 'node:module';+import { promisify } from 'node:util';++import { buildServer, FALLBACK_TOOLS, TOOL_ANNOTATIONS } from '../src/index.js';++const require = createRequire(import.meta.url);+const pkg = require('../package.json');+const run = promisify(execFile);+const ENTRY = new URL('../src/index.js', import.meta.url).href;++test('importing the entry point never connects a transport', async () => {+ // A connected StdioServerTransport attaches a stdin reader and keeps the event+ // loop alive forever. Asserted in a CHILD process: this test file has already+ // imported the module, and the test runner touches stdin itself, so only a+ // clean process can answer the question honestly. A regression here does not+ // fail an assertion, it hangs — hence the timeout.+ const { stdout, stderr } = await run(+ process.execPath,+ ['-e', `import(${JSON.stringify(ENTRY)}).then(() => { console.log(process.stdin.listenerCount('data')); });`],+ { timeout: 20_000 },+ );+ assert.equal(stdout.trim(), '0', 'import attached a stdin reader');+ assert.doesNotMatch(stderr, /ready with \d+ tools/, 'import printed the server banner');+});++test('the declared exports resolve to the documented surface', () => {+ assert.equal(typeof buildServer, 'function');+ assert.ok(Array.isArray(FALLBACK_TOOLS) && FALLBACK_TOOLS.length > 0);+ assert.ok(TOOL_ANNOTATIONS && typeof TOOL_ANNOTATIONS === 'object');+});++test('package.json points bin, main and exports at the same real entry file', () => {+ assert.equal(pkg.main, './src/index.js');+ assert.equal(pkg.exports['.'], './src/index.js');+ assert.equal(pkg.bin['pumpfun-mcp'], 'src/index.js');+ // `files` must ship everything those entries reach at install time.+ for (const required of ['src', 'README.md', 'LICENSE']) {+ assert.ok(pkg.files.includes(required), `package.json files is missing ${required}`);+ }+});++test('buildServer registers the bundled tool surface without a key or a transport', async () => {+ // PUMPFUN_MCP_URL is pointed at an unroutable address so the backend tools/list+ // fails fast and the bundled FALLBACK_TOOLS are what get registered. No network+ // dependency, and the offline path is exactly the one a fresh install hits.+ const prior = process.env.PUMPFUN_MCP_URL;+ process.env.PUMPFUN_MCP_URL = 'http://127.0.0.1:1/pump-fun-mcp';+ try {+ const server = await buildServer();+ assert.ok(server, 'buildServer returned nothing');+ assert.ok(server.threeWsToolCount >= FALLBACK_TOOLS.length);+ assert.equal(process.stdin.listenerCount('data'), 0, 'buildServer connected a transport');+ } finally {+ if (prior === undefined) delete process.env.PUMPFUN_MCP_URL;+ else process.env.PUMPFUN_MCP_URL = prior;+ }+});diff --git a/packages/sign-language/README.md b/packages/sign-language/README.mdindex 8c8d6a684..fdb3f225d 100644--- a/packages/sign-language/README.md+++ b/packages/sign-language/README.md@@ -101,6 +101,9 @@ npm test # node --test: guards the published surface + dependency-freenenpm run example # compile "happy to meet you" to example/utterance.clip.json```+Both `npm test` and `npm run example` read `dist/`, so each rebuilds it first+(`pretest` / `preexample`): a fresh clone runs them with no extra step.+Deep engine coverage lives in the monorepo suite (`tests/sign-rig`, `sign-clip`, `sign-dictionary`, `fingerspelling`, `sign-speech`, `sign-goldens`, `sign-linguistics`).## Relateddiff --git a/packages/sign-language/package.json b/packages/sign-language/package.jsonindex e5040c588..648f491db 100644--- a/packages/sign-language/package.json+++ b/packages/sign-language/package.json@@ -50,12 +50,14 @@"sideEffects": false,"scripts": {"build": "node build.mjs",+ "pretest": "node build.mjs","test": "node --test test/*.test.mjs",+ "preexample": "node build.mjs","example": "node example/compile-utterance.mjs","prepublishOnly": "npm run build && npm test"},"devDependencies": {- "esbuild": "^0.27.7"+ "esbuild": "^0.28.1"},"engines": {"node": ">=18"diff --git a/packages/signals-mcp/test/auth-gate.test.mjs b/packages/signals-mcp/test/auth-gate.test.mjsnew file mode 100644index 000000000..7ab464462--- /dev/null+++ b/packages/signals-mcp/test/auth-gate.test.mjs@@ -0,0 +1,61 @@+// Without THREE_WS_API_KEY, the three account-scoped follower tools must fail+// with an actionable `auth_required` BEFORE any request leaves the process. A+// keyless server should never bounce off an upstream 401, and must never leak a+// subscribe/kill attempt onto the wire.+//+// This lives in its own file because src/config.js snapshots process.env at+// module load, and `node --test` runs each test file in its own process.+//+// Run: node --test packages/signals-mcp/test/auth-gate.test.mjs++import { test } from 'node:test';+import assert from 'node:assert/strict';++process.env.THREE_WS_BASE = 'https://signals.test';+delete process.env.THREE_WS_API_KEY;++const { def: getSubscriptions } = await import('../src/tools/get-subscriptions.js');+const { def: subscribeSignal } = await import('../src/tools/subscribe-signal.js');+const { def: setSubscriptionStatus } = await import('../src/tools/set-subscription-status.js');+const { def: listSignalFeeds } = await import('../src/tools/list-signal-feeds.js');++// Any fetch at all is a failure for the account-scoped cases.+globalThis.fetch = async () => {+ throw new Error('a keyless account-scoped tool must never reach the network');+};++const isAuthRequired = (err) => err.code === 'auth_required' && err.status === 401 && /THREE_WS_API_KEY/.test(err.message);++test('get_subscriptions refuses without a key', async () => {+ await assert.rejects(() => getSubscriptions.handler(), isAuthRequired);+});++test('subscribe_signal refuses without a key, before any spend can be arranged', async () => {+ await assert.rejects(+ () => subscribeSignal.handler({ agent_id: 'agt_1', feed_id: 42, mode: 'live' }),+ isAuthRequired,+ );+});++test('set_subscription_status refuses without a key', async () => {+ await assert.rejects(+ () => setSubscriptionStatus.handler({ subscription_id: 7, state: 'killed' }),+ isAuthRequired,+ );+});++test('the public discovery tool still works keyless (it just needs the network)', async () => {+ const calls = [];+ globalThis.fetch = async (url) => {+ calls.push(new URL(url));+ return new Response(JSON.stringify({ network: 'mainnet', sort: 'edge', feeds: [] }), {+ status: 200,+ headers: { 'content-type': 'application/json' },+ });+ };+ const result = await listSignalFeeds.handler({});+ assert.equal(result.ok, true);+ assert.equal(calls[0].pathname, '/api/signals/marketplace');+ // No key configured means no Authorization header is attached at all.+ assert.equal(calls.length, 1);+});diff --git a/packages/signals-mcp/test/handlers.test.mjs b/packages/signals-mcp/test/handlers.test.mjsnew file mode 100644index 000000000..30700b54e--- /dev/null+++ b/packages/signals-mcp/test/handlers.test.mjs@@ -0,0 +1,244 @@+// Handler behavior for @three-ws/signals-mcp: query shaping and clamping,+// request bodies, response mapping, auth gating, and error normalization.+// globalThis.fetch is swapped per test, so nothing here touches the network.+//+// Env is pinned BEFORE the dynamic imports because src/config.js reads+// process.env at module load.+//+// Run: node --test packages/signals-mcp/test/handlers.test.mjs++import { test } from 'node:test';+import assert from 'node:assert/strict';++process.env.THREE_WS_BASE = 'https://signals.test';+process.env.THREE_WS_API_KEY = 'sk_test_signals_mcp';+delete process.env.THREE_WS_TIMEOUT_MS;++const { def: listSignalFeeds } = await import('../src/tools/list-signal-feeds.js');+const { def: getMirrorLeaderboard } = await import('../src/tools/get-mirror-leaderboard.js');+const { def: getSubscriptions } = await import('../src/tools/get-subscriptions.js');+const { def: subscribeSignal } = await import('../src/tools/subscribe-signal.js');+const { def: setSubscriptionStatus } = await import('../src/tools/set-subscription-status.js');+const { apiRequest, requireApiKey } = await import('../src/lib/api.js');+const { THREE_WS_BASE } = await import('../src/config.js');++// Swap globalThis.fetch for the duration of fn, always restoring it.+async function withFetch(stub, fn) {+ const original = globalThis.fetch;+ globalThis.fetch = stub;+ try {+ return await fn();+ } finally {+ globalThis.fetch = original;+ }+}++// Record each fetch invocation and answer with a JSON body at `status`.+function recordingFetch(body, log, status = 200) {+ return async (url, init) => {+ log.push({ url: new URL(url), init });+ return new Response(JSON.stringify(body), {+ status,+ headers: { 'content-type': 'application/json' },+ });+ };+}++// ── list_signal_feeds ────────────────────────────────────────────────────────++test('list_signal_feeds defaults to the mainnet edge ranking', async () => {+ const log = [];+ const result = await withFetch(recordingFetch({ network: 'mainnet', sort: 'edge', feeds: [] }, log), () =>+ listSignalFeeds.handler({}),+ );+ assert.equal(log[0].url.origin, new URL(THREE_WS_BASE).origin);+ assert.equal(log[0].url.pathname, '/api/signals/marketplace');+ assert.equal(log[0].url.searchParams.get('network'), 'mainnet');+ assert.equal(log[0].url.searchParams.get('sort'), 'edge');+ assert.equal(log[0].url.searchParams.get('limit'), '60');+ assert.deepEqual(result, { ok: true, network: 'mainnet', sort: 'edge', count: 0, feeds: [] });+});++test('list_signal_feeds clamps limit and refuses an unknown sort', async () => {+ const log = [];+ await withFetch(recordingFetch({ feeds: [] }, log), () =>+ listSignalFeeds.handler({ network: 'devnet', sort: 'made-up', limit: 5000 }),+ );+ assert.equal(log[0].url.searchParams.get('network'), 'devnet');+ assert.equal(log[0].url.searchParams.get('sort'), 'edge');+ assert.equal(log[0].url.searchParams.get('limit'), '100');+});++test('list_signal_feeds reports the count of the feeds it returns', async () => {+ const feeds = [+ { rank: 1, id: 42, slug: 'alpha-trader-1a2b3c4d', edge_score: 77 },+ { rank: 2, id: 43, slug: 'beta-trader-5e6f7a8b', edge_score: 61 },+ ];+ const result = await withFetch(recordingFetch({ network: 'mainnet', sort: 'roi', feeds }, []), () =>+ listSignalFeeds.handler({ sort: 'roi', limit: 2 }),+ );+ assert.equal(result.count, 2);+ assert.equal(result.sort, 'roi');+ assert.equal(result.feeds[0].id, 42);+});++// ── get_mirror_leaderboard ───────────────────────────────────────────────────++test('get_mirror_leaderboard unwraps the data envelope and clamps limit', async () => {+ const log = [];+ const leaders = [{ rank: 1, agent_id: 'agt_1', name: 'Crosshair', pnl_sol: 0.16 }];+ const result = await withFetch(+ recordingFetch({ data: { network: 'mainnet', sort: 'pnl', leaders } }, log),+ () => getMirrorLeaderboard.handler({ sort: 'pnl', limit: 999 }),+ );+ assert.equal(log[0].url.pathname, '/api/mirror/leaderboard');+ assert.equal(log[0].url.searchParams.get('limit'), '50');+ assert.equal(result.sort, 'pnl');+ assert.equal(result.count, 1);+ assert.equal(result.leaders[0].name, 'Crosshair');+});++test('get_mirror_leaderboard returns an empty board rather than throwing', async () => {+ const result = await withFetch(recordingFetch({ data: {} }, []), () => getMirrorLeaderboard.handler({}));+ assert.deepEqual(result, { ok: true, network: 'mainnet', sort: 'score', count: 0, leaders: [] });+});++// ── account-scoped tools ─────────────────────────────────────────────────────++test('get_subscriptions sends the bearer key and shapes the list', async () => {+ const log = [];+ const result = await withFetch(+ recordingFetch({ subscriptions: [{ id: 7, feed_id: 42, mode: 'live', stats: { executed: 3 } }] }, log),+ () => getSubscriptions.handler(),+ );+ assert.equal(log[0].url.pathname, '/api/signals/subscribe');+ assert.equal(log[0].init.method, 'GET');+ assert.equal(log[0].init.headers.authorization, 'Bearer sk_test_signals_mcp');+ assert.equal(result.count, 1);+ assert.equal(result.subscriptions[0].stats.executed, 3);+});++test('subscribe_signal defaults to simulate and omits unset sizing fields', async () => {+ const log = [];+ const result = await withFetch(+ recordingFetch({ subscription: { id: 7, feed_id: 42, mode: 'simulate', status: 'active', killed: false } }, log),+ () => subscribeSignal.handler({ agent_id: ' agt_1 ', feed_id: 42 }),+ );+ const body = JSON.parse(log[0].init.body);+ assert.equal(log[0].init.method, 'POST');+ assert.equal(body.agent_id, 'agt_1');+ assert.equal(body.feed_id, 42);+ assert.equal(body.mode, 'simulate');+ assert.equal(body.billing, 'per_signal');+ assert.equal(body.firewall_level, 'block');+ assert.equal(body.copy_exits, true);+ for (const key of ['base_sol', 'size_scaling', 'max_per_trade_sol', 'slippage_bps']) {+ assert.ok(!(key in body), `${key} should be left to the server default`);+ }+ assert.equal(result.subscription.mode, 'simulate');+});++test('subscribe_signal passes live sizing through and rounds slippage to whole bps', async () => {+ const log = [];+ await withFetch(recordingFetch({ subscription: { id: 7 } }, log), () =>+ subscribeSignal.handler({+ agent_id: 'agt_1',+ feed_id: 42,+ mode: 'live',+ billing: 'per_epoch',+ base_sol: 0.05,+ size_scaling: 1.5,+ max_per_trade_sol: 0.25,+ slippage_bps: 300.4,+ firewall_level: 'warn',+ copy_exits: false,+ }),+ );+ const body = JSON.parse(log[0].init.body);+ assert.equal(body.mode, 'live');+ assert.equal(body.billing, 'per_epoch');+ assert.equal(body.base_sol, 0.05);+ assert.equal(body.size_scaling, 1.5);+ assert.equal(body.max_per_trade_sol, 0.25);+ assert.equal(body.slippage_bps, 300);+ assert.equal(body.firewall_level, 'warn');+ assert.equal(body.copy_exits, false);+});++test('set_subscription_status sends killed:true for the kill switch, status otherwise', async () => {+ const log = [];+ const killed = await withFetch(+ recordingFetch({ subscription: { id: 7, killed: true, status: 'paused' } }, log),+ () => setSubscriptionStatus.handler({ subscription_id: 7, state: 'killed' }),+ );+ assert.deepEqual(JSON.parse(log[0].init.body), { id: 7, killed: true });+ assert.equal(killed.state, 'killed');++ const log2 = [];+ const paused = await withFetch(+ recordingFetch({ subscription: { id: 7, killed: false, status: 'paused' } }, log2),+ () => setSubscriptionStatus.handler({ subscription_id: 7, state: 'paused' }),+ );+ assert.deepEqual(JSON.parse(log2.at(0).init.body), { id: 7, status: 'paused' });+ assert.equal(paused.state, 'paused');+});++// ── auth gating + error normalization ────────────────────────────────────────++// The keyless case lives in auth-gate.test.mjs: config.js snapshots the env at+// module load, and node --test gives each file its own process.+test('requireApiKey passes once a key is configured', () => {+ assert.doesNotThrow(() => requireApiKey());+});++test('an upstream error carries its code, status and message', async () => {+ await withFetch(+ recordingFetch({ error: 'not_found', message: 'feed not found' }, [], 404),+ async () => {+ await assert.rejects(+ () => apiRequest('/api/signals/subscribe', { method: 'POST', body: { id: 1 } }),+ (err) => err.code === 'upstream_error' && err.status === 404 && err.message === 'feed not found',+ );+ },+ );+});++test('a non-JSON error body still yields a typed error, not a parse crash', async () => {+ await withFetch(+ async () => new Response('<html>502 Bad Gateway</html>', { status: 502 }),+ async () => {+ await assert.rejects(+ () => apiRequest('/api/signals/marketplace'),+ (err) => err.code === 'upstream_error' && err.status === 502 && /HTTP 502/.test(err.message),+ );+ },+ );+});++test('a transport failure is reported as network_error, not a raw fetch throw', async () => {+ await withFetch(+ async () => {+ throw new TypeError('connect ECONNREFUSED');+ },+ async () => {+ await assert.rejects(+ () => apiRequest('/api/signals/marketplace'),+ (err) => err.code === 'network_error' && /ECONNREFUSED/.test(err.message),+ );+ },+ );+});++test('an aborted request is reported as a timeout naming the budget', async () => {+ await withFetch(+ async () => {+ throw Object.assign(new Error('aborted'), { name: 'AbortError' });+ },+ async () => {+ await assert.rejects(+ () => apiRequest('/api/signals/marketplace'),+ (err) => err.code === 'timeout' && /20000ms/.test(err.message),+ );+ },+ );+});diff --git a/packages/skill-license/README.md b/packages/skill-license/README.mdindex 034cf3980..bddd79d8a 100644--- a/packages/skill-license/README.md+++ b/packages/skill-license/README.md@@ -79,13 +79,26 @@ import { verifyLicense } from '@three-ws/skill-license';const owns = await verifyLicense({holder: 'HoLDeRwa11et1111111111111111111111111111111',- agent: 'THREEsynthetic1111111111111111111111111111', // agent skill-collection mint+ agent: 'THREEsynthetic11111111111111111111111111111', // agent skill-collection mintskill: 'web-search',});console.log(owns); // → true | false```+A runnable version of this lives in [example/verify-license.mjs](example/verify-license.mjs).+It hits the live public read endpoint, so it needs no key, no wallet, and no RPC:++```bash+node example/verify-license.mjs # the synthetic placeholders above+node example/verify-license.mjs <holder> <agentMint> <skill>+```++The placeholders are clearly synthetic but decode to real 32-byte base58 keys, so+the snippet runs as written and answers `false` (nothing licensed at that triple).+An address that is *not* a valid 32-byte key is rejected with a `validation_error`+(400) before anything touches the chain.+Need the full record, not just a boolean — purchase date, NFT mint, explorerlink, revoked state:@@ -94,7 +107,7 @@ import { getLicense } from '@three-ws/skill-license';const license = await getLicense({holder: 'HoLDeRwa11et1111111111111111111111111111111',- agent: 'THREEsynthetic1111111111111111111111111111',+ agent: 'THREEsynthetic11111111111111111111111111111',skill: 'web-search',});if (license?.owned) {@@ -189,7 +202,10 @@ Idempotent: a second call returns the existing mint.| `apiKey` | `string` | Bearer token for the authenticated three.ws account (overrides the client's `apiKey`). |To point the client at a different origin, construct one with-`createSkillLicense({ baseUrl })` instead of passing `baseUrl` per call.+`createSkillLicense({ baseUrl, fetch, apiKey, headers })` instead of passing+`baseUrl` per call; it returns `{ verifyLicense, getLicense, mintLicense }` bound+to that configuration. `DEFAULT_BASE_URL` (`https://three.ws`) is exported too,+and `THREE_WS_BASE_URL` in the environment overrides it without any code change.**Returns `MintResult`**: `{ nftMint, signature, collection, network, explorer, skill, agentId, purchaseId, alreadyMinted }`.@@ -241,8 +257,13 @@ The program is **Anchor**, id `EdngSwxmDktyrr4phwGEZnCXEoQ27vgnBtowjhKa7Wr8``verifyLicense` and `getLicense` only read public state, so they never needcredentials. The shapes they surface, straight from the endpoint:+Every rejection is a typed `ThreeWsError` carrying a stable `code`, the HTTP+`status`, and the parsed `body`; a 402 arrives as `PaymentRequiredError` with the+x402 challenge on `.accepts`. Both classes are exported.+| State | Meaning | What you get ||---|---|---|+| `validation_error` (400) | `holder` / `agent` isn't a real 32-byte Solana address, or `skill` is empty/over 100 chars. | Rejects before any chain read. || Program not deployed | The `skill_license` program isn't live on this cluster. | `getLicense` → `{ exists: false, owned: false, deployed: false }`; `verifyLicense` → `false`. || No license | The PDA doesn't exist — never purchased. | `getLicense` → `null`; `verifyLicense` → `false`. || Revoked | Refunded — frozen with `revoked_at` set. | `{ exists: true, revoked: true, owned: false }`. |diff --git a/packages/skill-license/example/verify-license.mjs b/packages/skill-license/example/verify-license.mjsnew file mode 100644index 000000000..60e46f17e--- /dev/null+++ b/packages/skill-license/example/verify-license.mjs@@ -0,0 +1,36 @@+#!/usr/bin/env node+// Check on-chain skill ownership against the live three.ws read endpoint, with+// no wallet, no signer, and no RPC of your own. Run it:+//+// node example/verify-license.mjs [holder] [agentMint] [skill]+//+// Defaults to clearly-synthetic (but real 32-byte base58) placeholders, so the+// example runs as-is and answers "no license here" honestly. Swap in a real+// holder wallet and the agent's skill-collection mint to check a real license.++import { getLicense, skillSeed, verifyLicense, PROGRAM_ID } from '../src/index.js';++const [holder = 'HoLDeRwa11et1111111111111111111111111111111', agent = 'THREEsynthetic11111111111111111111111111111', skill = 'web-search'] =+ process.argv.slice(2);++console.log(`program ${PROGRAM_ID}`);+console.log(`holder ${holder}`);+console.log(`agent ${agent}`);+console.log(`skill ${skill}`);+console.log(`seed sha256(skill) = ${await skillSeed(skill)}`);++// The headline check: one boolean, straight from chain state.+const owned = await verifyLicense({ holder, agent, skill });+console.log(`owned ${owned}`);++// The full record. `null` means the PDA was never created (never purchased).+const license = await getLicense({ holder, agent, skill });+if (!license) {+ console.log('license none on-chain for this triple (never purchased)');+} else {+ console.log(`license ${license.license}`);+ console.log(`nftMint ${license.nftMint}`);+ console.log(`revoked ${license.revoked}`);+ console.log(`bought ${license.purchaseDate}`);+ console.log(`explorer ${license.explorer}`);+}diff --git a/packages/skill-license/package.json b/packages/skill-license/package.jsonindex 3ee019211..84d158473 100644--- a/packages/skill-license/package.json+++ b/packages/skill-license/package.json@@ -16,11 +16,13 @@},"files": ["src",+ "example","README.md","LICENSE"],"scripts": {- "test": "node --test test/*.test.js"+ "test": "node --test test/*.test.js",+ "example": "node example/verify-license.mjs"},"keywords": ["solana",diff --git a/packages/skill-license/test/skill-license.test.js b/packages/skill-license/test/skill-license.test.jsindex 157829d6b..7b17773e1 100644--- a/packages/skill-license/test/skill-license.test.js+++ b/packages/skill-license/test/skill-license.test.js@@ -25,7 +25,7 @@ function stubFetch(responses) {// Synthetic, off-platform placeholders — never a real third-party address.const HOLDER = 'HoLDeRwa11et1111111111111111111111111111111';-const AGENT = 'THREEsynthetic1111111111111111111111111111';+const AGENT = 'THREEsynthetic11111111111111111111111111111';const LICENSE_PDA = 'LiCenSepda11111111111111111111111111111111';const NFT_MINT = 'NftM1nt1111111111111111111111111111111111';diff --git a/packages/spatial-mcp/LICENSE b/packages/spatial-mcp/LICENSEnew file mode 100644index 000000000..7842c3d5f--- /dev/null+++ b/packages/spatial-mcp/LICENSE@@ -0,0 +1,16 @@+CC0 1.0 Universal (CC0 1.0) Public Domain Dedication++To the extent possible under law, three.ws has waived all copyright and related+or neighboring rights to @three-ws/spatial-mcp, the Spatial MCP specification it+implements, and its conformance fixtures. This work is published from the United+States and may be copied, modified, distributed, and used, including for+commercial purposes, all without asking permission.++The work is provided "as is", without warranties of any kind concerning the work,+express, implied, statutory or otherwise, including without limitation warranties+of title, merchantability, fitness for a particular purpose, non-infringement, or+the absence of latent or other defects, accuracy, or the present or absence of+errors, whether or not discoverable, all to the greatest extent permissible under+applicable law.++Full legal code: https://creativecommons.org/publicdomain/zero/1.0/legalcodediff --git a/packages/spatial-mcp/README.md b/packages/spatial-mcp/README.mdindex ef161f02c..b1c34f77a 100644--- a/packages/spatial-mcp/README.md+++ b/packages/spatial-mcp/README.md@@ -90,4 +90,4 @@ This package is emit-and-validate only. The framework-free reference renderer li## License-CC0-1.0. The spec and this implementation are public domain: reimplement, extend, and ship them anywhere.+CC0-1.0 ([LICENSE](LICENSE)). The spec and this implementation are public domain: reimplement, extend, and ship them anywhere.diff --git a/packages/spatial-mcp/package.json b/packages/spatial-mcp/package.jsonindex 95ee160e4..4bc96235b 100644--- a/packages/spatial-mcp/package.json+++ b/packages/spatial-mcp/package.json@@ -32,7 +32,8 @@"files": ["src","fixtures",- "README.md"+ "README.md",+ "LICENSE"],"scripts": {"test": "vitest run --root ../.. packages/spatial-mcp/tests"diff --git a/packages/strategies/README.md b/packages/strategies/README.mdindex a31daea8d..a232de38f 100644--- a/packages/strategies/README.md+++ b/packages/strategies/README.md@@ -166,14 +166,17 @@ so you (or your agent) execute it from your own wallet. Wraps| `minOracleScore` | `number?` | — | 0–100 conviction gate. || `perfFeeBps` | `number` | `1000` | Performance fee to the leader (0–3000 bps). |-Reads: `listSubscriptions()`, `copyExecutions({ status })` (your intent inbox —-`pending` by default), `pauseCopy(id)` / `stopCopy(id)`.+Reads: `listSubscriptions()` and `copyExecutions({ status, limit })` (your intent+inbox: the endpoint serves `pending` when no `status` is passed, and `all` returns+every state). Controls: `pauseCopy(id)` / `stopCopy(id)`, and+on a single intent, `actCopy(executionId, txSignature)` (you executed it from+your own wallet) or `dismissCopy(executionId)` (you skipped it).### `mirror(agentId, leaderAgentId, input) → Promise<Follow>`**Custodial** follow: your agent's wallet sizes and lands the leader's trades-automatically through the leashed runtime. Wraps the agent strategy surface-(`POST /api/agents/:id/strategies` family).+automatically through the leashed runtime. Wraps the agent mirror surface+(`POST /api/agents/:id/mirror` and its `/kill`, `/sync`, `/unfollow` siblings).| Field | Type | Default | Notes ||---|---|---|---|@@ -187,9 +190,11 @@ automatically through the leashed runtime. Wraps the agent strategy surface| `copySells` | `boolean` | `true` | Mirror exits. || `mintAllowlist` / `mintDenylist` | `string[]` | `[]` | Restrict / block specific mints. |-Mirror controls: `killSwitch(agentId, engaged)` (per-owner global halt),-`sweep(agentId)` ("run now"), and `equipped(agentId)` (live equips + open-positions + kill state).+Mirror controls: `killSwitch(agentId, engaged)` (per-owner global halt, `POST+…/mirror/kill`), `sweep(agentId)` ("run now", `POST …/mirror/sync`),+`unmirror(agentId, leaderAgentId)` (drop the follow edge, `POST+…/mirror/unfollow`), and `equipped(agentId)` (`GET …/mirror`: live follows,+recent fills, follower counts, kill state).### Strategy Objects@@ -204,6 +209,7 @@ A reusable, publishable, forkable rule set — ranked by **real** performance.| `forkStrategy(id)` | `POST /api/strategies/:id/fork` | Clone the **rules** into your library (no wallet access transferred). || `publishStrategy(id, published)` | `POST /api/strategies/:id/publish` | Toggle marketplace visibility. || `updateStrategy(id, patch)` | `PATCH /api/strategies/:id` | Edit name/description/config (bumps version). |+| `deleteStrategy(id)` | `DELETE /api/strategies/:id` | Soft-delete it and deactivate its equips (history is kept). |The `config` is a structured plan — `entry` (trigger, age, market-cap, liquidity,creator history), `sizing` (`amount_sol`, `max_slippage_bps`), `exits`diff --git a/packages/strategies/test/strategies.test.js b/packages/strategies/test/strategies.test.jsindex fff230f33..f84b856b4 100644--- a/packages/strategies/test/strategies.test.js+++ b/packages/strategies/test/strategies.test.js@@ -157,6 +157,95 @@ test('killSwitch() posts { killed } to /mirror/kill', async () => {assert.equal(r.killed, true);});+test('sweep() and unmirror() hit the run-now and unfollow endpoints', async () => {+ const { fetch, calls } = stubFetch([+ { body: { data: { synced: [{ leader_agent_id: LEADER, planned_sol: 0.2 }] } } },+ { body: { data: { removed: true } } },+ ]);+ const sx = createStrategies({ fetch });++ const swept = await sx.sweep(AGENT);+ assert.equal(calls[0].url.pathname, `/api/agents/${AGENT}/mirror/sync`);+ assert.equal(calls[0].init.method, 'POST');+ assert.equal(swept.synced.length, 1);++ const removed = await sx.unmirror(AGENT, LEADER);+ assert.equal(calls[1].url.pathname, `/api/agents/${AGENT}/mirror/unfollow`);+ assert.equal(JSON.parse(calls[1].init.body).leader_agent_id, LEADER);+ assert.equal(removed.removed, true);+});++test('equipped() reads live mirror state and shapes follows + fills', async () => {+ const { fetch, calls } = stubFetch([+ {+ body: {+ data: {+ is_owner: true,+ killed: false,+ following_count: 1,+ followers_count: 4,+ active_followers: 2,+ following: [{ id: 7, leader_agent_id: LEADER, sizing_mode: 'fixed', fixed_sol: 0.1, enabled: true }],+ // A leashed SKIP is a designed state, not a failure; it must survive shaping.+ recent: [+ { id: 'f1', side: 'buy', leader_sol: 1, planned_sol: 0.1, status: 'skipped', skip_reason: 'daily_budget', skip_label: 'Daily budget spent' },+ ],+ },+ },+ },+ ]);+ const sx = createStrategies({ fetch });+ const state = await sx.equipped(AGENT);++ assert.equal(calls[0].url.pathname, `/api/agents/${AGENT}/mirror`);+ assert.equal(calls[0].init.method, 'GET');+ assert.equal(state.isOwner, true);+ assert.equal(state.killed, false);+ assert.equal(state.followingCount, 1);+ assert.equal(state.followersCount, 4);+ assert.equal(state.activeFollowers, 2);+ assert.equal(state.following[0].fixedSol, 0.1);+ assert.equal(state.recent[0].skipReason, 'daily_budget');+ assert.equal(state.recent[0].skipLabel, 'Daily budget spent');+});++test('leaderboard() ranks proven strategies and keeps unproven ones honest', async () => {+ const { fetch, calls } = stubFetch([+ {+ body: {+ data: {+ count: 2,+ leaders: [+ { id: STRATEGY, name: 'Proven', rank: 1, performance: { proven: true, trades: 12, open: 1, wins: 8, losses: 4, pnl_sol: '1.25', roi_pct: '18.4', win_rate: '66.7' } },+ { id: '66666666-6666-4666-8666-666666666666', name: 'Untested', rank: 2, performance: { proven: false, trades: 0, open: 0 } },+ ],+ },+ },+ },+ ]);+ const sx = createStrategies({ fetch });+ const board = await sx.leaderboard({ limit: 10 });++ assert.equal(calls[0].url.pathname, '/api/strategies/leaderboard');+ assert.equal(calls[0].url.searchParams.get('limit'), '10');+ assert.equal(board.count, 2);+ assert.equal(board.leaders[0].performance.proven, true);+ assert.equal(board.leaders[0].performance.pnlSol, 1.25);+ assert.equal(board.leaders[0].performance.roiPct, 18.4);+ assert.equal(board.leaders[1].performance.proven, false);+ assert.equal(board.leaders[1].performance.pnlSol, null);+});++test('deleteStrategy() soft-deletes and validates the id first', async () => {+ const { fetch, calls } = stubFetch([{ body: { data: { deleted: true } } }]);+ const sx = createStrategies({ fetch });+ const r = await sx.deleteStrategy(STRATEGY);+ assert.equal(calls[0].url.pathname, `/api/strategies/${STRATEGY}`);+ assert.equal(calls[0].init.method, 'DELETE');+ assert.equal(r.deleted, true);+ await assert.rejects(() => sx.deleteStrategy('not-a-uuid'), (e) => e instanceof StrategyError && e.code === 'invalid_input');+});+test('createStrategy() validates name and shapes performance', async () => {const { fetch, calls } = stubFetch([{ status: 201, body: { data: { id: STRATEGY, name: 'Fresh-launch momentum', published: false, version: 1, performance: { proven: false, trades: 0, open: 0 } } } },diff --git a/packages/three-token-mcp/README.md b/packages/three-token-mcp/README.mdindex 568b1e0c4..457e9f755 100644--- a/packages/three-token-mcp/README.md+++ b/packages/three-token-mcp/README.md@@ -132,7 +132,7 @@ All three tools ship [MCP tool annotations](https://modelcontextprotocol.io/spec1. `GET /api/token/config` → mint, decimals, burn address, treasury.2. `GET /api/token/price?usd=<n>` → live Jupiter price and the exact $THREE atomics.-3. Build **one** transaction: an idempotent ATA-create + SPL transfer per leg (burn + treasury), plus a memo tagging the burn on-chain.+3. Build **one** transaction: an idempotent ATA-create + SPL transfer per leg (burn + treasury), plus a memo tagging the burn on-chain. An amount that will not divide evenly at `burnBps` gives the leftover atomic unit to the **burn** leg, so a burn is never short of its share; with `burnBps: 10000` (or a config with no treasury) there is one leg and everything is destroyed.4. Sign with your wallet, send, and confirm. The result reports the on-chain signature and per-leg amounts.The server pre-checks your $THREE balance and fails fast with a clear error if it can't cover the burn — no opaque on-chain failures. Burns are bounded by `MAX_BURN_USD` (default $100) and gated by `REQUIRE_CONFIRM` (default on).@@ -147,7 +147,7 @@ The server pre-checks your $THREE balance and fails fast with a clear error if i| Variable | Required | Default || -------------------- | -------------- | ------------------------------------------------- |-| `SOLANA_SECRET_KEY` | for burns only | — |+| `SOLANA_SECRET_KEY` | for burns only | none (`FUNDER_SECRET` is accepted as a fallback) || `SOLANA_RPC_URL` | no | `https://api.mainnet-beta.solana.com` || `THREE_WS_BASE` | no | `https://three.ws` || `MAX_BURN_USD` | no | `100` |diff --git a/packages/three-token-mcp/src/lib/token.js b/packages/three-token-mcp/src/lib/token.jsindex 33a3cb620..1fbd05f2a 100644--- a/packages/three-token-mcp/src/lib/token.js+++ b/packages/three-token-mcp/src/lib/token.js@@ -116,10 +116,12 @@ export async function resolveMint() {export function computeSplit(totalAtomics, burnBps, config) {const total = BigInt(totalAtomics);const bps = Math.max(0, Math.min(10_000, Math.round(burnBps)));- let burnAtomics = (total * BigInt(bps)) / 10_000n;- let treasuryAtomics = total - burnAtomics;+ // Floor the TREASURY share, then give the burn leg the remainder: integer+ // division always drops a fraction of an atomic unit somewhere, and the leg+ // that must never come up short is the burn.+ const treasuryAtomics = (total * BigInt(10_000 - bps)) / 10_000n;+ let burnAtomics = total - treasuryAtomics;const legs = [];- // Assign any rounding dust to the burn leg so we never under-burn.if (treasuryAtomics > 0n && config.treasury) {legs.push({ role: 'treasury', address: config.treasury, atomics: treasuryAtomics });} else {diff --git a/packages/three-token-mcp/test/burn-policy.test.mjs b/packages/three-token-mcp/test/burn-policy.test.mjsnew file mode 100644index 000000000..8489c0ffc--- /dev/null+++ b/packages/three-token-mcp/test/burn-policy.test.mjs@@ -0,0 +1,124 @@+// The money math and the guards around it. computeSplit decides how much+// $THREE is destroyed forever versus routed to the treasury, and the policy+// gates (per-burn USD cap, confirm gate, signer parsing) are the only things+// standing between an injected prompt and an irreversible mainnet burn, so+// every one of them is pinned here.+//+// Nothing in this file touches the network or signs anything: every assertion+// is on a pure function or on a guard that fires before the first fetch.+//+// Run: node --test packages/three-token-mcp/test/burn-policy.test.mjs++import { test } from 'node:test';+import assert from 'node:assert/strict';++import { computeSplit, burnThree } from '../src/lib/token.js';+import { def as threeBurn } from '../src/tools/three-burn.js';+import { keypairFromSecret } from '../src/lib/solana.js';+import { MAX_BURN_USD, REQUIRE_CONFIRM, EXPECTED_BURN_ADDRESS } from '../src/config.js';++const CONFIG = {+ mint: 'FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump',+ burn_address: EXPECTED_BURN_ADDRESS,+ treasury: 'THREEsynthetic11111111111111111111111111111',+ decimals: 6,+};++const sum = (legs) => legs.reduce((t, l) => t + l.atomics, 0n);+const leg = (legs, role) => legs.find((l) => l.role === role);++// ── computeSplit ─────────────────────────────────────────────────────────────++test('the default 5000 bps splits evenly and conserves every atomic unit', () => {+ const legs = computeSplit(1_000_000n, 5000, CONFIG);+ assert.equal(legs.length, 2);+ assert.equal(legs[0].role, 'burn', 'the burn leg leads the transaction');+ assert.equal(leg(legs, 'burn').atomics, 500_000n);+ assert.equal(leg(legs, 'treasury').atomics, 500_000n);+ assert.equal(sum(legs), 1_000_000n);+ assert.equal(leg(legs, 'burn').address, EXPECTED_BURN_ADDRESS);+ assert.equal(leg(legs, 'treasury').address, CONFIG.treasury);+});++test('rounding dust goes to the burn leg, never to the treasury', () => {+ // 101 at 50/50 cannot split evenly; the odd unit must be destroyed.+ const legs = computeSplit(101n, 5000, CONFIG);+ assert.equal(leg(legs, 'burn').atomics, 51n);+ assert.equal(leg(legs, 'treasury').atomics, 50n);+ assert.equal(sum(legs), 101n);+ // Same rule at an awkward ratio: burn is never short of its share.+ const thirds = computeSplit(100n, 3333, CONFIG);+ assert.ok(leg(thirds, 'burn').atomics >= 33n);+ assert.equal(sum(thirds), 100n);+});++test('10000 bps burns everything and emits a single leg', () => {+ const legs = computeSplit(1_000_000n, 10_000, CONFIG);+ assert.equal(legs.length, 1);+ assert.equal(legs[0].role, 'burn');+ assert.equal(legs[0].atomics, 1_000_000n);+});++test('0 bps routes it all to the treasury and burns nothing', () => {+ const legs = computeSplit(1_000_000n, 0, CONFIG);+ assert.equal(legs.length, 1);+ assert.equal(legs[0].role, 'treasury');+ assert.equal(legs[0].atomics, 1_000_000n);+});++test('a config with no treasury burns the whole amount rather than dropping it', () => {+ const legs = computeSplit(1_000_000n, 5000, { ...CONFIG, treasury: null });+ assert.equal(legs.length, 1);+ assert.equal(legs[0].role, 'burn');+ assert.equal(legs[0].atomics, 1_000_000n);+ assert.equal(sum(legs), 1_000_000n);+});++test('out-of-range and fractional bps are clamped and rounded, never thrown at the chain', () => {+ assert.equal(sum(computeSplit(1_000n, -50, CONFIG)), 1_000n);+ assert.equal(leg(computeSplit(1_000n, -50, CONFIG), 'treasury').atomics, 1_000n);+ assert.equal(leg(computeSplit(1_000n, 99_999, CONFIG), 'burn').atomics, 1_000n);+ assert.equal(leg(computeSplit(1_000n, 2500.4, CONFIG), 'burn').atomics, 250n);+});++test('a zero total produces no legs at all', () => {+ assert.deepEqual(computeSplit(0n, 5000, CONFIG), []);+});++// ── policy gates (all fire before any network or signing) ────────────────────++test('the per-burn USD cap defaults to $100 and refuses anything above it', async () => {+ assert.equal(MAX_BURN_USD, 100);+ await assert.rejects(+ () => burnThree({ usd: MAX_BURN_USD + 0.01 }),+ (err) => err.code === 'over_burn_cap' && /MAX_BURN_USD/.test(err.message),+ );+});++test('a non-positive burn amount is refused outright', async () => {+ for (const usd of [0, -1, 'abc', undefined]) {+ await assert.rejects(() => burnThree({ usd }), (err) => err.code === 'bad_amount');+ }+});++test('three_burn demands confirm:true before it will execute', async () => {+ assert.equal(REQUIRE_CONFIRM, true, 'the confirm gate must default to on');+ const refused = await threeBurn.handler({ usd: 1 });+ assert.equal(refused.ok, false);+ assert.equal(refused.error, 'confirmation_required');+ assert.match(refused.message, /IRREVERSIBLE/);+ // And the gate is not satisfied by a truthy-but-not-true value.+ const sneaky = await threeBurn.handler({ usd: 1, confirm: 'yes' });+ assert.equal(sneaky.error, 'confirmation_required');+});++test('the confirm gate is checked before the burn cap, so a huge burn cannot slip past it', async () => {+ const refused = await threeBurn.handler({ usd: MAX_BURN_USD * 10 });+ assert.equal(refused.error, 'confirmation_required');+});++test('a missing or malformed signer fails with a clear code, not a crash', () => {+ assert.throws(() => keypairFromSecret(''), (err) => err.code === 'no_signer');+ assert.throws(() => keypairFromSecret(' '), (err) => err.code === 'no_signer');+ assert.throws(() => keypairFromSecret(JSON.stringify([1, 2, 3])), (err) => err.code === 'bad_secret');+});diff --git a/packages/tool-sdk/README.md b/packages/tool-sdk/README.mdindex 1b92395f9..63590aa0f 100644--- a/packages/tool-sdk/README.md+++ b/packages/tool-sdk/README.md@@ -52,29 +52,33 @@ for the one caveat that matters before you publish).## Quick start — full runnable example+A complete MCP server over a real, free, keyless three.ws endpoint: the+vanity-address difficulty oracle (`GET /api/vanity/bounties?view=quote`). Save+it as `quote-server.js` and run it.+```js-import { defineTool, defineExecutor, toMcpTools, z } from '@three-ws/tool-sdk';+import { defineTool, defineExecutor, toMcpTools, guardedFetch, z } from '@three-ws/tool-sdk';import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';// 1. Declare identity, API surface, and permissions once.-const priceTool = defineTool({- id: 'my-org-price-feed',- title: 'My Price Feed',- description: 'Fetches live token prices from My API.',+const quoteTool = defineTool({+ id: 'three-ws-vanity-quote',+ title: 'Vanity Quote',+ description: 'Prices how hard a Solana vanity address pattern is to grind.',version: '1.0.0',permissions: {- network: ['api.example.com'], // guardedFetch may only reach this host- rateLimit: { calls: 30, perSeconds: 60 }, // enforced automatically by the executor+ network: ['three.ws'], // guardedFetch may only reach this host+ rateLimit: { calls: 30, perSeconds: 60 }, // enforced automatically by the executorwallet: false,},apis: [{- name: 'getPrice',- description: 'Get the current USD price for a token symbol.',- annotations: { readOnlyHint: true, idempotentHint: false, openWorldHint: true },+ name: 'getQuote',+ description: 'Quote the difficulty and suggested USDC bounty for a Base58 prefix.',+ annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },parameters: z.object({- symbol: z.string().min(1).describe('Token ticker, e.g. "ETH"'),+ prefix: z.string().min(1).max(6).describe('Base58 prefix, e.g. "THREE"'),}),},],@@ -82,36 +86,57 @@ const priceTool = defineTool({// 2. Wire an implementation. Return plain data — the executor wraps it into// { success: true, content, state } and catches thrown errors for you.-const priceExecutor = defineExecutor(priceTool, {- async getPrice({ symbol }, ctx) {- const fetchGuarded = guardedFetch(priceTool.manifest.permissions);- const res = await fetchGuarded(`https://api.example.com/v1/price/${symbol}`);+const quoteExecutor = defineExecutor(quoteTool, {+ async getQuote({ prefix }) {+ const fetchGuarded = guardedFetch(quoteTool.manifest.permissions);+ const res = await fetchGuarded(`https://three.ws/api/vanity/bounties?view=quote&prefix=${prefix}`);const data = await res.json();- return { symbol, price: data.price };+ return { prefix, tier: data.difficulty.tierLabel, expectedAttempts: data.difficulty.expectedAttempts };},});// 3. Adapt into MCP tool registrations — one call, one tool per declared API.-const server = new McpServer({ name: 'price-feed-mcp', version: '1.0.0' }, { capabilities: { tools: {} } });-for (const def of toMcpTools(priceTool, priceExecutor)) {+// `def.handler` returns raw data and THROWS on failure (the shape every+// hand-written tool in this repo uses), so the server wraps it into MCP+// content blocks exactly the way packages/naming-mcp's buildServer does.+const server = new McpServer({ name: 'vanity-quote-mcp', version: '1.0.0' }, { capabilities: { tools: {} } });+for (const def of toMcpTools(quoteTool, quoteExecutor)) {server.registerTool(def.name,{ title: def.title, description: def.description, inputSchema: def.inputSchema, annotations: def.annotations },- def.handler, // throws on failure, returns content on success — matches every hand-written tool in this repo+ async (args, extra) => {+ try {+ const result = await def.handler(args, extra);+ const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);+ return { content: [{ type: 'text', text }] };+ } catch (err) {+ const payload = { ok: false, error: err?.code || 'unhandled', message: err?.message || String(err) };+ return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }], isError: true };+ }+ },);}await server.connect(new StdioServerTransport());```-Run it, then call `getPrice` from any MCP client (or `npx -y-@modelcontextprotocol/inspector node your-server.js`):+Passing `def.handler` to `registerTool` directly does **not** work: it returns+raw data, and the MCP SDK expects a `{ content: [...] }` result, so the client+receives an empty content array. The wrapper above is the boundary that turns+data into content blocks and thrown errors into `isError` results.++Run it, then call `getQuote` from any MCP client (or `npx -y+@modelcontextprotocol/inspector node quote-server.js`):```jsonc-> { "symbol": "ETH" }-{ "symbol": "ETH", "price": 3421.09 }+> { "prefix": "THREE" }+{ "prefix": "THREE", "tier": "Mythic", "expectedAttempts": 11308763834 }```+Because `permissions.network` lists only `three.ws`, the same implementation+pointed at any other host throws `NETWORK_NOT_ALLOWED` before a packet leaves+the process.+## API### `defineTool(config)`diff --git a/packages/tutor-mcp/test/handlers.test.mjs b/packages/tutor-mcp/test/handlers.test.mjsnew file mode 100644index 000000000..1fcd2276d--- /dev/null+++ b/packages/tutor-mcp/test/handlers.test.mjs@@ -0,0 +1,204 @@+// Handler behavior for @three-ws/tutor-mcp: request shaping against the tutor+// session ledger, the shape each tool returns to the MCP client, and how an+// upstream failure is normalized. Global fetch is replaced for every test, so+// nothing here touches the network.+//+// Env is pinned BEFORE the dynamic imports because src/config.js reads+// process.env at module load.+//+// Run: node --test packages/tutor-mcp/test/handlers.test.mjs++import { test } from 'node:test';+import assert from 'node:assert/strict';++process.env.THREE_WS_BASE = 'https://tutor.test';+delete process.env.THREE_WS_TIMEOUT_MS;++const { def: loadSession } = await import('../src/tools/load-session.js');+const { def: closeSession } = await import('../src/tools/close-session.js');+const { buildServer } = await import('../src/index.js');++const SESSION_ID = 'learn-abc123';++// Swap globalThis.fetch for the duration of fn, always restoring it.+async function withFetch(stub, fn) {+ const original = globalThis.fetch;+ globalThis.fetch = stub;+ try {+ return await fn();+ } finally {+ globalThis.fetch = original;+ }+}++// Answer every fetch with `body`, recording each invocation for assertions.+function recordingFetch(body, log, status = 200) {+ return async (url, init) => {+ log.push({ url: String(url), init });+ return new Response(JSON.stringify(body), {+ status,+ headers: { 'content-type': 'application/json' },+ });+ };+}++// One billed question, exactly as /api/tutor/session itemizes it.+function lineItem(n) {+ return {+ n,+ question: `Question ${n}?`,+ level: 'intro',+ outputTokens: 180,+ costAtomics: 10000,+ costUsd: '0.010000',+ at: '2026-06-24T03:41:00.000Z',+ };+}++function openSession(overrides = {}) {+ return {+ sessionId: SESSION_ID,+ createdAt: '2026-06-24T03:40:00.000Z',+ status: 'open',+ questionCount: 2,+ lineItems: [lineItem(1), lineItem(2)],+ totalAtomics: 20000,+ totalUsd: '0.020000',+ ...overrides,+ };+}++test('load_session GETs the ledger with the sessionId in the query', async () => {+ const log = [];+ const result = await withFetch(recordingFetch(openSession(), log), () =>+ loadSession.handler({ sessionId: SESSION_ID }),+ );++ assert.equal(log.length, 1);+ const url = new URL(log[0].url);+ assert.equal(url.origin, 'https://tutor.test');+ assert.equal(url.pathname, '/api/tutor/session');+ assert.equal(url.searchParams.get('sessionId'), SESSION_ID);+ assert.equal(log[0].init.method, 'GET');++ assert.equal(result.ok, true);+ assert.equal(result.status, 'open');+ assert.equal(result.questionCount, 2);+ assert.equal(result.lineItems.length, 2);+ assert.equal(result.totalAtomics, 20000);+ assert.equal(result.totalUsd, '0.020000');+ assert.equal('invoice' in result, false, 'an open session carries no invoice');+});++test('load_session trims and truncates the sessionId to the API cap', async () => {+ const log = [];+ const long = ` ${'x'.repeat(140)} `;+ await withFetch(recordingFetch(openSession(), log), () => loadSession.handler({ sessionId: long }));++ const sent = new URL(log[0].url).searchParams.get('sessionId');+ assert.equal(sent.length, 100, 'sessionId is capped at 100 chars');+ assert.equal(sent, 'x'.repeat(100));+});++test('load_session surfaces a closed session with its finalized invoice', async () => {+ const invoice = { sessionId: SESSION_ID, attestation: 'sha256:abc', totalAtomics: 20000 };+ const result = await withFetch(recordingFetch(openSession({ status: 'closed', invoice }), []), () =>+ loadSession.handler({ sessionId: SESSION_ID }),+ );++ assert.equal(result.status, 'closed');+ assert.deepEqual(result.invoice, invoice);+});++test('load_session reports an unbilled session as an empty open tab, not an error', async () => {+ // The API answers an unknown sessionId with a fresh empty session; the tool+ // must pass that through as "nothing billed yet" rather than inventing data.+ const empty = { sessionId: 'brand-new', createdAt: '2026-06-24T03:40:00.000Z', status: 'open', questionCount: 0, lineItems: [], totalAtomics: 0, totalUsd: '0.000000' };+ const result = await withFetch(recordingFetch(empty, []), () => loadSession.handler({ sessionId: 'brand-new' }));++ assert.equal(result.ok, true);+ assert.equal(result.questionCount, 0);+ assert.deepEqual(result.lineItems, []);+ assert.equal(result.totalUsd, '0.000000');+});++test('close_session POSTs the end action and returns the attested invoice', async () => {+ const log = [];+ const invoice = {+ sessionId: SESSION_ID,+ createdAt: '2026-06-24T03:40:00.000Z',+ closedAt: '2026-06-24T03:45:00.000Z',+ questionCount: 2,+ lineItems: [lineItem(1), lineItem(2)],+ totalAtomics: 20000,+ totalUsd: '0.020000',+ attestation: 'sha256:9f2c',+ };+ const result = await withFetch(recordingFetch(invoice, log), () =>+ closeSession.handler({ sessionId: SESSION_ID }),+ );++ assert.equal(log.length, 1);+ assert.equal(new URL(log[0].url).pathname, '/api/tutor/session');+ assert.equal(log[0].init.method, 'POST');+ assert.deepEqual(JSON.parse(log[0].init.body), { sessionId: SESSION_ID, action: 'end' });+ assert.equal(log[0].init.headers['content-type'], 'application/json');++ assert.equal(result.ok, true);+ assert.equal(result.closedAt, '2026-06-24T03:45:00.000Z');+ assert.equal(result.attestation, 'sha256:9f2c');+ assert.equal(result.lineItems.length, 2);+});++test('close_session fills honest zeros when the API omits ledger fields', async () => {+ const result = await withFetch(recordingFetch({ sessionId: SESSION_ID }, []), () =>+ closeSession.handler({ sessionId: SESSION_ID }),+ );++ assert.equal(result.questionCount, 0);+ assert.deepEqual(result.lineItems, []);+ assert.equal(result.totalAtomics, 0);+ assert.equal(result.totalUsd, '0.000000');+ assert.equal(result.attestation, null, 'a missing attestation is null, never fabricated');+});++test('an upstream error becomes a typed error carrying the HTTP status', async () => {+ const failing = recordingFetch({ error: 'missing_session', message: 'sessionId is required' }, [], 400);+ await withFetch(failing, () =>+ assert.rejects(() => closeSession.handler({ sessionId: 'x' }), (err) => {+ assert.equal(err.code, 'upstream_error');+ assert.equal(err.status, 400);+ assert.match(err.message, /sessionId is required/);+ return true;+ }),+ );+});++test('the server wrapper renders a handler failure as an isError content block', async () => {+ const server = buildServer();+ const registered = server._registeredTools.load_session;+ const failing = recordingFetch({ error: 'upstream', message: 'ledger unavailable' }, [], 503);++ const result = await withFetch(failing, () => registered.handler({ sessionId: SESSION_ID }, {}));++ assert.equal(result.isError, true);+ const payload = JSON.parse(result.content[0].text);+ assert.equal(payload.ok, false);+ assert.equal(payload.error, 'upstream_error');+ assert.equal(payload.status, 503);+});++test('the server wrapper renders a successful handler result as JSON text', async () => {+ const server = buildServer();+ const registered = server._registeredTools.load_session;++ const result = await withFetch(recordingFetch(openSession(), []), () =>+ registered.handler({ sessionId: SESSION_ID }, {}),+ );++ assert.equal(result.isError, undefined);+ assert.equal(result.content[0].type, 'text');+ const payload = JSON.parse(result.content[0].text);+ assert.equal(payload.sessionId, SESSION_ID);+ assert.equal(payload.questionCount, 2);+});diff --git a/packages/vanity/README.md b/packages/vanity/README.mdindex 0dd387027..2465bc4e4 100644--- a/packages/vanity/README.md+++ b/packages/vanity/README.md@@ -38,10 +38,11 @@Vanity grinding is embarrassingly parallel keypair generation: make an Ed25519keypair, Base58-encode the public key, check the prefix/suffix, repeat until a-hit. The naïve pure-JS version is unusably slow because JS-implemented Ed25519-manages a few thousand candidates per second. A 4-char prefix expects ~11M-attempts. You need native-speed crypto and an honest difficulty model so you-don't kick off a grind that finishes next century.+hit. Keygen dominates the loop, and a single Node thread sustains roughly a+thousand keypairs per second on a typical cloud vCPU. A 4-char prefix expects+~11M attempts, which is hours at that rate, so the difficulty model matters as+much as the hot loop: you need to know what a pattern costs before you start,+not after.`@three-ws/vanity` is that, done once:@@ -181,12 +182,40 @@ x402-capable `fetch` to settle the 402 automatically.| `format` | `'keypair' \| 'mnemonic'` | `mnemonic` returns an importable BIP-39 phrase (≤ 2 chars, ~100× slower). || `strength` | `128 \| 256` | Mnemonic only: 12 or 24 words. || `sealTo` | `string` | Optional X25519 public key — the secret is ECIES-sealed to you and the plaintext is omitted from the response. |-| `fetch` | `typeof fetch` | An x402-wrapped fetch (see [`@three-ws/x402-fetch`](https://www.npmjs.com/package/@three-ws/x402-fetch)). |+| `fetch` | `typeof fetch` | An x402-wrapped fetch (see [`@three-ws/x402-fetch`](https://www.npmjs.com/package/@three-ws/x402-fetch)). Without one you get a `PaymentRequiredError` carrying the x402 challenge to settle yourself. |+| `baseUrl` | `string` | API origin. Defaults to `THREE_WS_BASE_URL` or `https://three.ws`. |+| `apiKey` | `string` | Sent as `Authorization: Bearer …`. Not required for the x402 lane. |+| `headers` | `Record<string,string>` | Extra request headers. |+| `signal` | `AbortSignal` | Cancel the request. |Response fields: `address`, `secretKeyBase58`, `secretKey` (64-int array),`attempts`, `durationMs`, `expectedAttempts`, `network`, `explorerUrl`, and —for `format=mnemonic` — `mnemonic`, `wordCount`, `derivationPath`.+### `createVanity(options?) → VanityClient`++Bind `fetch` / `baseUrl` / `apiKey` / `headers` once and reuse them across calls,+instead of repeating them on every `grindViaApi()`. Returns `{ grindViaApi }`+with identical semantics.++```js+import { createVanity } from '@three-ws/vanity';+import { wrapFetchWithPayment } from '@three-ws/x402-fetch';++const vanity = createVanity({ fetch: wrapFetchWithPayment(fetch, payer) });+const { address } = await vanity.grindViaApi({ prefix: 'ag' });+```++### Also exported++| Export | What it is |+|---|---|+| `base58Encode(bytes)` | Base58 (Solana address) encoder for a `Uint8Array` / number array. Zero deps. |+| `BASE58_ALPHABET` | The 58-character alphabet (excludes the confusable `0 O I l`). |+| `MAX_PATTERN_LENGTH` | The per-pattern ceiling `validatePattern` and `grind` enforce (`6`). |+| `DEFAULT_BASE_URL` | `https://three.ws` — the origin the hosted lane uses unless overridden. |+| `ThreeWsError` / `PaymentRequiredError` | Typed errors (`code`, `status`, and `accepts` for the x402 challenge). |+## How it worksTwo keygen backends, one `grind()` surface. Picked by environment, resolved@@ -216,9 +245,10 @@ once, then the same batched hot loop runs on either.the event loop, so an `AbortSignal` lands within one batch and `onProgress`fires on a ~250ms wall-clock cadence.- **Single-threaded by design.** The local path runs on the calling thread;- `GrindResult.workers` is always `1`. For long patterns, run several- `grind()` calls in your own worker threads or processes if you need- parallelism. The hosted x402 endpoint caps patterns at 3 chars because it+ `GrindResult.workers` is always `1`, and one thread sustains on the order of+ a thousand keypairs per second (measured on a 2-core cloud container; a+ desktop CPU does better). For long patterns, run several `grind()` calls in+ your own worker threads or processes if you need parallelism. The hosted x402 endpoint caps patterns at 3 chars because itgrinds under a server-side wall-clock budget.## Security@@ -282,7 +312,7 @@ The paid `grindViaApi()` path surfaces the endpoint's HTTP errors:| `code` | HTTP | Meaning | Recovery ||---|---|---|---|| `validation_error` | 400 | Bad pattern, format, or strength. | Fix the input. |-| `pattern_too_long` | 400 | Combined pattern > server cap (3, or 2 for mnemonic). | Grind locally with `grind()`. |+| `pattern_too_long` | 400 | Combined pattern over the mnemonic cap of 2. (A combined pattern over 3 never leaves the process: the SDK rejects it locally as `invalid_input`.) | Grind locally with `grind()`. || `grind_exhausted` | 504 | Time budget elapsed without a hit (rare, <1% at 3 chars). | Retry — you weren't charged. || `rate_limited` | 429 | Pre-payment probe rate limit. | Honour `retry-after`. |diff --git a/packages/vanity/src/index.d.ts b/packages/vanity/src/index.d.tsindex e0a3b69ad..6b70a1a54 100644--- a/packages/vanity/src/index.d.ts+++ b/packages/vanity/src/index.d.ts@@ -91,11 +91,18 @@ export interface GrindViaApiOptions extends Pattern {strength?: 128 | 256;/** Optional X25519 public key — the secret is ECIES-sealed to you. */sealTo?: string;- /** An x402-wrapped fetch is supplied via the client, not here. */headers?: Record<string, string>;signal?: AbortSignal;}+/**+ * Options for the standalone `grindViaApi()`: the per-call params plus the+ * client knobs (`fetch`, `baseUrl`, `apiKey`). Supplying any of them binds a+ * client to this call instead of using the shared zero-config one. A client+ * built with `createVanity()` takes the client knobs at construction time.+ */+export interface GrindViaApiStandaloneOptions extends GrindViaApiOptions, VanityClientOptions {}+export interface ApiResult {address: string | null;prefix: string | null;@@ -122,4 +129,4 @@ export interface VanityClient {}export declare function createVanity(options?: VanityClientOptions): VanityClient;-export declare function grindViaApi(params: GrindViaApiOptions): Promise<ApiResult>;+export declare function grindViaApi(params: GrindViaApiStandaloneOptions): Promise<ApiResult>;diff --git a/packages/vanity/src/index.js b/packages/vanity/src/index.jsindex c09d7d46b..2dd7ccad2 100644--- a/packages/vanity/src/index.js+++ b/packages/vanity/src/index.js@@ -414,13 +414,29 @@ function defaultClient() {return (sharedClient ||= createVanity());}+// Client-level knobs the standalone `grindViaApi()` accepts inline, so a caller+// who only needs one call does not have to build a client first. The paid lane+// is unusable without a payment-aware `fetch`, so silently ignoring one passed+// here would send the call out on the bare global fetch and 402.+const CLIENT_OPTION_KEYS = ['fetch', 'baseUrl', 'apiKey'];+/*** Grind a short pattern over the hosted paid x402 endpoint instead of locally.+ *+ * Uses the shared zero-config client unless the call carries client options+ * (`fetch`, `baseUrl`, `apiKey`), in which case a client bound to those is+ * built for this call. Pass an x402-wrapped `fetch` to settle the 402.+ ** @param {GrindViaApiOptions} params* @returns {Promise<ApiResult>}*/-export function grindViaApi(params) {- return defaultClient().grindViaApi(params);+export function grindViaApi(params = {}) {+ const overrides = {};+ for (const key of CLIENT_OPTION_KEYS) {+ if (params[key] !== undefined) overrides[key] = params[key];+ }+ const client = Object.keys(overrides).length > 0 ? createVanity(overrides) : defaultClient();+ return client.grindViaApi(params);}function shapeApiResult(res) {diff --git a/packages/vanity/test/vanity.test.js b/packages/vanity/test/vanity.test.jsindex 5471cbd78..4993b101a 100644--- a/packages/vanity/test/vanity.test.js+++ b/packages/vanity/test/vanity.test.js@@ -183,3 +183,27 @@ test('grindViaApi maps a validation_error to a typed ThreeWsError', async () =>test('the default grindViaApi export is wired to a shared client', () => {assert.equal(typeof grindViaApi, 'function');});++test('the standalone grindViaApi honours a per-call fetch and baseUrl', async () => {+ // The paid lane needs an x402-wrapped fetch, so a `fetch` passed straight to+ // the standalone export must actually be used — falling back to the global+ // one would send the call out unpaid and 402.+ const { fetch, calls } = stubFetch([{ body: { address: 'THREEsynthetic1111', network: 'solana' } }]);+ const res = await grindViaApi({ prefix: 'a', fetch, baseUrl: 'https://preview.three.ws' });++ assert.equal(calls.length, 1, 'the supplied fetch was called');+ assert.equal(calls[0].url.origin, 'https://preview.three.ws');+ assert.equal(calls[0].url.pathname, '/api/x402/vanity');+ assert.equal(calls[0].url.searchParams.get('prefix'), 'a');+ assert.equal(res.address, 'THREEsynthetic1111');+});++test('the standalone grindViaApi still validates before touching the supplied fetch', async () => {+ const { fetch, calls } = stubFetch([]);+ await assert.rejects(() => grindViaApi({ prefix: 'abcd', fetch }), (e) => {+ assert.ok(e instanceof ThreeWsError);+ assert.equal(e.code, 'invalid_input');+ return true;+ });+ assert.equal(calls.length, 0);+});diff --git a/packages/vision-mcp/README.md b/packages/vision-mcp/README.mdindex 6e526a635..12ba3301f 100644--- a/packages/vision-mcp/README.md+++ b/packages/vision-mcp/README.md@@ -116,6 +116,19 @@ All three tools are read-only — they look at an image, they never store or mut}```+## Examples++Runnable, key-free examples live in [`examples/`](./examples):++```bash+node examples/list-tools.mjs # every tool with its full input schema+node examples/read-an-image.mjs # status + alt text + OCR on a live image+```++Both spawn this server over stdio and call the real vision pipeline. Every tool+is read-only, so nothing is stored and nothing is paid. See+[`examples/README.md`](./examples/README.md) for expected output.+Images may be JPEG, PNG, WebP, or GIF, up to **12 MB**. Base64 inputs are size-checked locally before upload; `imageUrl` must be a public **https** URL (the vision server fetches it, so private/loopback hosts are rejected).## Pricing & auth@@ -142,7 +155,7 @@ The endpoint is rate-limited per IP. To raise your limit to the per-user tier, s- Homepage: https://three.ws- Changelog: https://three.ws/changelog- Issues: https://github.com/nirholas/three.ws/issues-- License: Apache-2.0 — see [LICENSE](./LICENSE)+- License: all rights reserved, see [LICENSE](./LICENSE)---diff --git a/packages/vision-mcp/examples/README.md b/packages/vision-mcp/examples/README.mdnew file mode 100644index 000000000..3003ff1db--- /dev/null+++ b/packages/vision-mcp/examples/README.md@@ -0,0 +1,85 @@+# Examples: @three-ws/vision-mcp++Two runnable examples. Both spawn this package's own MCP server over stdio (the+same `node src/index.js` entry point the README documents), speak real MCP+JSON-RPC to it, and hit the live three.ws vision pipeline. Neither one needs a+key and neither one costs anything.++| File | What it does | Run |+|---|---|---|+| [`list-tools.mjs`](list-tools.mjs) | Prints all 3 tools with titles, annotation hints, and full input schemas. | `node examples/list-tools.mjs` |+| [`read-an-image.mjs`](read-an-image.mjs) | Probes the lane with `get_vision_status`, gets alt text from `describe_image`, then reads the text off the same image with `analyze_image`. | `node examples/read-an-image.mjs` |++Run them from the package directory:++```bash+cd packages/vision-mcp+node examples/list-tools.mjs+node examples/read-an-image.mjs+```++Nothing to install and nothing to configure: the vision lane serves anonymous+callers on the free NVIDIA NIM models. The server prints a one-line banner to+stderr on connect (`[[email protected]] connected over stdio with 3 tools`),+which is normal.++## list-tools.mjs++Runs the MCP `initialize` handshake, then `tools/list`, and formats every tool.+Expected output (abridged):++```+server: vision-mcp v0.1.1 (stdio)+capabilities: tools+tools: 3++1. analyze_image+ title: Analyze an image against a prompt+ hints: read-only, open-world+ params:+ - prompt (required; string, maxLength 2000)+ - imageUrl (optional; string)+ ...+```++Every tool is read-only, so the hint line never says `destructive`.++## read-an-image.mjs++The end-to-end path an agent takes when it needs to see something:++```+get_vision_status: is the lane live?+ configured: true+ image types: image/jpeg, image/png, image/webp, image/gif+ max size: 12 MB++describe_image: alt text for https://three.ws/og-image.png+ served: nvidia/nemotron-nano-12b-v2-vl (nvidia lane)+ alt: An advertisement for a website called three.ws that allows users to create a 3D AI agent.++analyze_image: read the text in that same image (OCR through a VLM)+ served: nvidia/nemotron-nano-12b-v2-vl (nvidia lane)+ text: three.ws+ PLATFORM+ The 3D agent layer of the+ internet.+ ...+```++A VLM is non-deterministic, so the exact wording changes between runs; the+shape does not.++Point it at your own image with `IMAGE_URL`:++```bash+IMAGE_URL=https://example.com/screenshot.png node examples/read-an-image.mjs+```++The image must be a public https URL serving JPEG, PNG, WebP, or GIF (the vision+server fetches it, so private and loopback hosts are rejected). To read a local+file instead, base64 it and pass `image` + `imageType` to the same tools.++A free NIM lane can exceed its deadline under load; the example retries an+`upstream_error` / `timeout` / `network_error` once, then reports the tool's own+error code rather than a stack trace.diff --git a/packages/vision-mcp/examples/list-tools.mjs b/packages/vision-mcp/examples/list-tools.mjsnew file mode 100644index 000000000..578bc03d6--- /dev/null+++ b/packages/vision-mcp/examples/list-tools.mjs@@ -0,0 +1,103 @@+// list-tools.mjs: print every tool @three-ws/vision-mcp advertises, with its+// input schema.+//+// Spawns this package's own server over stdio the way the README runs it+// (`node src/index.js`), performs the MCP initialize handshake, calls+// tools/list, and prints each tool's title, annotation hints, and parameters.+//+// node examples/list-tools.mjs+//+// No key and no image: registration is env-free, so the server advertises all+// three tools with nothing configured.++import { fileURLToPath } from 'node:url';++import { Client } from '@modelcontextprotocol/sdk/client/index.js';+import {+ StdioClientTransport,+ getDefaultEnvironment,+} from '@modelcontextprotocol/sdk/client/stdio.js';++// The README's "Run standalone" entry point. Swap for+// { command: 'npx', args: ['-y', '@three-ws/vision-mcp'] } to exercise the+// published package instead of this checkout.+const SERVER_PATH = fileURLToPath(new URL('../src/index.js', import.meta.url));++// Env this server reads (see src/config.js). getDefaultEnvironment() drops+// everything else, so an example never leaks unrelated secrets to the child.+const FORWARDED_ENV = ['THREE_WS_BASE', 'THREE_WS_TIMEOUT_MS', 'THREE_WS_API_KEY'];++function childEnv() {+ const env = getDefaultEnvironment();+ for (const key of FORWARDED_ENV) {+ const value = process.env[key];+ if (value) env[key] = value;+ }+ return env;+}++/** One-line summary of a tool's MCP annotation hints. */+function hints(annotations) {+ if (!annotations) return 'no hints';+ const flags = [];+ if (annotations.readOnlyHint) flags.push('read-only');+ if (annotations.destructiveHint) flags.push('destructive');+ if (annotations.idempotentHint) flags.push('idempotent');+ if (annotations.openWorldHint) flags.push('open-world');+ return flags.length ? flags.join(', ') : 'no hints';+}++/** Render a JSON Schema property as one readable constraint string. */+function constraints(prop) {+ const parts = [prop.type ?? 'any'];+ if (Array.isArray(prop.enum)) parts.push(`one of ${prop.enum.join(' | ')}`);+ if (prop.default !== undefined) parts.push(`default ${JSON.stringify(prop.default)}`);+ if (prop.minimum !== undefined) parts.push(`min ${prop.minimum}`);+ if (prop.maximum !== undefined) parts.push(`max ${prop.maximum}`);+ if (prop.maxLength !== undefined) parts.push(`maxLength ${prop.maxLength}`);+ return parts.join(', ');+}++function printTool(tool, index) {+ const schema = tool.inputSchema ?? {};+ const properties = schema.properties ?? {};+ const required = new Set(schema.required ?? []);+ const names = Object.keys(properties);++ console.log(`\n${index}. ${tool.name}`);+ if (tool.title) console.log(` title: ${tool.title}`);+ console.log(` hints: ${hints(tool.annotations)}`);+ if (tool.description) console.log(` ${tool.description}`);+ if (names.length === 0) {+ console.log(' params: none');+ return;+ }+ console.log(' params:');+ for (const name of names) {+ const prop = properties[name];+ const flag = required.has(name) ? 'required' : 'optional';+ console.log(` - ${name} (${flag}; ${constraints(prop)})`);+ if (prop.description) console.log(` ${prop.description}`);+ }+}++const transport = new StdioClientTransport({+ command: process.execPath,+ args: [SERVER_PATH],+ env: childEnv(),+ stderr: 'inherit',+});+const client = new Client({ name: 'vision-mcp-list-tools-example', version: '1.0.0' });++await client.connect(transport);++const server = client.getServerVersion();+console.log(`server: ${server?.name} v${server?.version} (stdio)`);+console.log(`capabilities: ${Object.keys(client.getServerCapabilities() ?? {}).join(', ') || 'none'}`);++const { tools } = await client.listTools();+console.log(`tools: ${tools.length}`);++tools.forEach((tool, i) => printTool(tool, i + 1));++await client.close();diff --git a/packages/vision-mcp/examples/read-an-image.mjs b/packages/vision-mcp/examples/read-an-image.mjsnew file mode 100644index 000000000..24a4a8edf--- /dev/null+++ b/packages/vision-mcp/examples/read-an-image.mjs@@ -0,0 +1,102 @@+// read-an-image.mjs: let an agent actually see an image, end to end.+//+// Spawns this package's own server over stdio, then runs the three tools in the+// order a real client would: probe the lane with get_vision_status, ask+// describe_image for alt text, and ask analyze_image a concrete question (here,+// reading the text off the image, which is OCR through a VLM).+//+// node examples/read-an-image.mjs+// IMAGE_URL=https://example.com/photo.png node examples/read-an-image.mjs+//+// Live and free: every answer comes from the three.ws vision pipeline (free+// NVIDIA NIM VLM lanes first). No key, no wallet, nothing is stored, nothing is+// paid. The default image is a public PNG served by three.ws.++import { fileURLToPath } from 'node:url';++import { Client } from '@modelcontextprotocol/sdk/client/index.js';+import {+ StdioClientTransport,+ getDefaultEnvironment,+} from '@modelcontextprotocol/sdk/client/stdio.js';++const SERVER_PATH = fileURLToPath(new URL('../src/index.js', import.meta.url));+const IMAGE_URL = process.env.IMAGE_URL || 'https://three.ws/og-image.png';++// Env this server reads (see src/config.js). getDefaultEnvironment() drops+// everything else, so an example never leaks unrelated secrets to the child.+const FORWARDED_ENV = ['THREE_WS_BASE', 'THREE_WS_TIMEOUT_MS', 'THREE_WS_API_KEY'];++function childEnv() {+ const env = getDefaultEnvironment();+ for (const key of FORWARDED_ENV) {+ const value = process.env[key];+ if (value) env[key] = value;+ }+ return env;+}++// A free NIM lane occasionally exceeds its deadline under load; the next call+// lands on a healthy one. Retry those two codes once, and only those.+const TRANSIENT = new Set(['upstream_error', 'timeout', 'network_error']);++/** Call a tool and parse the JSON payload its single text block carries. */+async function callTool(client, name, args, attempt = 1) {+ const res = await client.callTool({ name, arguments: args });+ const text = res?.content?.find((part) => part.type === 'text')?.text ?? '{}';+ const payload = JSON.parse(text);+ if (res.isError || payload.ok === false) {+ if (attempt === 1 && TRANSIENT.has(payload.error)) {+ console.log(` (${payload.error} on the first try, retrying once)`);+ return callTool(client, name, args, 2);+ }+ throw Object.assign(new Error(payload.message || `${name} failed`), { tool: name, payload });+ }+ return payload;+}++const transport = new StdioClientTransport({+ command: process.execPath,+ args: [SERVER_PATH],+ env: childEnv(),+ stderr: 'inherit',+});+const client = new Client({ name: 'vision-mcp-read-an-image-example', version: '1.0.0' });++await client.connect(transport);++try {+ console.log('\nget_vision_status: is the lane live?');+ const status = await callTool(client, 'get_vision_status', {});+ console.log(` configured: ${status.configured}`);+ console.log(` image types: ${status.image_types.join(', ')}`);+ console.log(` max size: ${status.max_image_mb} MB`);+ if (!status.configured) {+ console.log('\nNo vision provider is configured on this deployment; skipping the image calls.');+ process.exit(0);+ }++ console.log(`\ndescribe_image: alt text for ${IMAGE_URL}`);+ const described = await callTool(client, 'describe_image', { imageUrl: IMAGE_URL, detail: 'brief' });+ console.log(` served: ${described.model} (${described.provider} lane)`);+ console.log(` alt: ${described.description}`);++ console.log('\nanalyze_image: read the text in that same image (OCR through a VLM)');+ const analyzed = await callTool(client, 'analyze_image', {+ imageUrl: IMAGE_URL,+ prompt: 'Transcribe every word of text visible in this image, in reading order. Text only.',+ maxTokens: 256,+ });+ console.log(` served: ${analyzed.model} (${analyzed.provider} lane)`);+ console.log(` text: ${analyzed.text.replace(/\n/g, '\n ')}`);++ console.log('\nNothing was stored and nothing was paid: all three tools are read-only.');+} catch (err) {+ // The vision lane is rate limited per IP. Surface the tool's own error code+ // instead of a stack trace so the cause is obvious from the output.+ console.error(`\n${err.tool || 'vision'} failed: ${err.message}`);+ if (err.payload?.error) console.error(`error code: ${err.payload.error}`);+ process.exitCode = 1;+} finally {+ await client.close();+}diff --git a/packages/vscode-x402/.vscodeignore b/packages/vscode-x402/.vscodeignoreindex 8c68d97f0..91218daea 100644--- a/packages/vscode-x402/.vscodeignore+++ b/packages/vscode-x402/.vscodeignore@@ -6,3 +6,4 @@ build.mjs.gitignore.eslintrc*node_modules/**+test/**diff --git a/packages/vscode-x402/CHANGELOG.md b/packages/vscode-x402/CHANGELOG.mdindex 858e703ae..f3b94b2ad 100644--- a/packages/vscode-x402/CHANGELOG.md+++ b/packages/vscode-x402/CHANGELOG.md@@ -1,5 +1,17 @@# Changelog+## 0.2.1++- **Scaffolded endpoints are Solana-first.** `x402: Scaffold a Paid Endpoint`+ used to emit `networks: ['base']`, so a generated endpoint advertised Base+ only. It now emits `['solana', 'base']`, matching every hand-written paid+ route on the platform.+- Test suite added (`npm test`): requirement selection across both rails, token+ classification, wallet-key parsing, and the scaffold template (which is now+ asserted to parse and to pass only options `paidEndpoint()` accepts).+- The bundle is emitted as `dist/extension.cjs` so the CommonJS extension entry+ and the ESM sources can coexist without ambiguity.+## 0.2.0Solana + $THREE payments.diff --git a/packages/vscode-x402/README.md b/packages/vscode-x402/README.mdindex 23325508c..be1fb4844 100644--- a/packages/vscode-x402/README.md+++ b/packages/vscode-x402/README.md@@ -77,10 +77,12 @@ extension offers to set the matching wallet.```bashnpm install-npm run build # bundle to dist/extension.js+npm run build # bundle to dist/extension.cjsnpm run watch # rebuild on change+npm test # requirement selection, token rules, scaffold template```Press <kbd>F5</kbd> in VS Code to launch an Extension Development Host.-Apache-2.0 · part of the [three.ws](https://three.ws) monorepo.+All rights reserved (see [LICENSE](./LICENSE)) · part of the+[three.ws](https://three.ws) monorepo.diff --git a/packages/vscode-x402/build.mjs b/packages/vscode-x402/build.mjsindex 5ed24465b..fc76368f5 100644--- a/packages/vscode-x402/build.mjs+++ b/packages/vscode-x402/build.mjs@@ -10,7 +10,9 @@ const watch = process.argv.includes('--watch');const options = {entryPoints: ['src/extension.js'],bundle: true,- outfile: 'dist/extension.js',+ // .cjs (not .js) because package.json declares "type": "module" for the ESM+ // sources; the extension host still requires this bundle as CommonJS.+ outfile: 'dist/extension.cjs',platform: 'node',format: 'cjs',target: 'node18',diff --git a/packages/vscode-x402/package.json b/packages/vscode-x402/package.jsonindex 114340a5c..1db08b93f 100644--- a/packages/vscode-x402/package.json+++ b/packages/vscode-x402/package.json@@ -33,7 +33,8 @@"bazaar","web3"],- "main": "./dist/extension.js",+ "type": "module",+ "main": "./dist/extension.cjs","icon": "media/icon.png","activationEvents": [],"contributes": {@@ -181,6 +182,7 @@},"scripts": {"build": "node build.mjs",+ "test": "node --test \"test/*.test.mjs\"","watch": "node build.mjs --watch","vscode:prepublish": "node build.mjs --production"},diff --git a/packages/vscode-x402/src/scaffold-template.js b/packages/vscode-x402/src/scaffold-template.jsnew file mode 100644index 000000000..9e1dda1c7--- /dev/null+++ b/packages/vscode-x402/src/scaffold-template.js@@ -0,0 +1,76 @@+// The source a scaffolded paid endpoint is generated from. Kept apart from the+// `vscode` UI flow in scaffold.js so it can be rendered and asserted on outside+// the editor host (test/scaffold.test.mjs does exactly that).+//+// The output follows the repo's canonical paidEndpoint() pattern+// (api/_lib/x402-paid-endpoint.js): Solana-first networks, a bazaar entry so the+// endpoint is discoverable the moment it deploys, and a handler that only runs+// after the buyer's payment settles.++/**+ * Render a ready-to-deploy `api/x402/<slug>.js` handler.+ *+ * @param {{ slug: string, priceUsd: number|string, description: string }} spec+ * @returns {string} JavaScript source for the endpoint file+ */+export function renderEndpoint({ slug, priceUsd, description }) {+ const priceAtomics = Math.round(Number(priceUsd) * 1e6);+ return `// ${slug} — paid x402 endpoint. Buyers pay USDC (Solana or Base); the call runs+// only after settlement. Wired to the shared paidEndpoint() x402 dance.+//+// POST /api/x402/${slug}++import { paidEndpoint } from '../_lib/x402-paid-endpoint.js';+import { buildBazaarSchema } from '../_lib/x402-spec.js';+import { withService } from '../_lib/x402/bazaar-helpers.js';++const RESOURCE_URL = 'https://three.ws/api/x402/${slug}';++const paid = paidEndpoint({+ route: '/api/x402/${slug}',+ method: 'POST',+ // $${Number(priceUsd).toFixed(6)} in USDC atomics (6 decimals).+ priceAtomics: ${priceAtomics},+ // Solana leads the challenge and Base follows, so a first-accept buyer+ // settles on Solana, the platform's home chain.+ networks: ['solana', 'base'],+ description: ${JSON.stringify(description)},+ service: withService({+ serviceName: ${JSON.stringify(slug)},+ tags: ['x402', 'paid'],+ }),+ bazaar: {+ description: ${JSON.stringify(description)},+ useCases: ['x402 paid api'],+ input: { type: 'json', example: {}, schema: { type: 'object', additionalProperties: true } },+ output: { type: 'json', example: {} },+ schema: buildBazaarSchema({ method: 'POST', bodySchema: { type: 'object', additionalProperties: true } }),+ resource: RESOURCE_URL,+ },+ resourceUrlBuilder: () => RESOURCE_URL,++ // Runs ONLY after the buyer's payment settles. Return JSON; throw an Error+ // with a .status for handled failures.+ async handler({ req }) {+ const body = await readJson(req);+ // Replace this echo with the real work. It returns the validated request+ // so the endpoint is wired end-to-end from the first deploy.+ return {+ ok: true,+ service: ${JSON.stringify(slug)},+ received: body,+ };+ },+});++async function readJson(req) {+ const chunks = [];+ for await (const c of req) chunks.push(c);+ const raw = Buffer.concat(chunks).toString('utf8');+ return raw ? JSON.parse(raw) : {};+}++export default paid;+export const config = { api: { bodyParser: false } };+`;+}diff --git a/packages/vscode-x402/src/scaffold.js b/packages/vscode-x402/src/scaffold.jsindex f09cb2d30..ad216371c 100644--- a/packages/vscode-x402/src/scaffold.js+++ b/packages/vscode-x402/src/scaffold.js@@ -4,65 +4,7 @@import * as vscode from 'vscode';-function template({ slug, fnName, priceUsd, description }) {- const priceAtomics = Math.round(Number(priceUsd) * 1e6);- return `// ${slug} — paid x402 endpoint. Buyers pay USDC; the call runs only after-// settlement. Wired to the shared paidEndpoint() x402 dance.-//-// GET|POST /api/x402/${slug}--import { paidEndpoint } from '../_lib/x402-paid-endpoint.js';-import { buildBazaarSchema } from '../_lib/x402-spec.js';-import { withService } from '../_lib/x402/bazaar-helpers.js';--const RESOURCE_URL = 'https://three.ws/api/x402/${slug}';--const paid = paidEndpoint({- route: '/api/x402/${slug}',- method: 'POST',- // $${Number(priceUsd).toFixed(6)} in USDC atomics (6 decimals).- priceAtomics: ${priceAtomics},- networks: ['base'],- description: ${JSON.stringify(description)},- service: withService({- serviceName: ${JSON.stringify(slug)},- tags: ['x402', 'paid'],- }),- bazaar: {- description: ${JSON.stringify(description)},- useCases: ['x402 paid api'],- input: { type: 'json', example: {}, schema: { type: 'object', additionalProperties: true } },- output: { type: 'json', example: {} },- schema: buildBazaarSchema({ method: 'POST', bodySchema: { type: 'object', additionalProperties: true } }),- resource: RESOURCE_URL,- },- resourceUrlBuilder: () => RESOURCE_URL,-- // Runs ONLY after the buyer's USDC settles. Return JSON; throw an Error with- // a .status for handled failures.- async handler({ req }) {- const body = await readJson(req);- // Replace this echo with the real work. It returns the validated request- // so the endpoint is wired end-to-end from the first deploy.- return {- ok: true,- service: ${JSON.stringify(slug)},- received: body,- };- },-});--async function readJson(req) {- const chunks = [];- for await (const c of req) chunks.push(c);- const raw = Buffer.concat(chunks).toString('utf8');- return raw ? JSON.parse(raw) : {};-}--export default paid;-export const config = { api: { bodyParser: false } };-`;-}+import { renderEndpoint } from './scaffold-template.js';export async function scaffoldEndpoint() {const folders = vscode.workspace.workspaceFolders;@@ -94,12 +36,7 @@ export async function scaffoldEndpoint() {if (description == null) return;const cleanSlug = slug.trim();- const content = template({- slug: cleanSlug,- fnName: cleanSlug.replace(/-([a-z])/g, (_, c) => c.toUpperCase()),- priceUsd,- description,- });+ const content = renderEndpoint({ slug: cleanSlug, priceUsd, description });const root = folders[0].uri;const target = vscode.Uri.joinPath(root, 'api', 'x402', `${cleanSlug}.js`);diff --git a/packages/vscode-x402/test/scaffold.test.mjs b/packages/vscode-x402/test/scaffold.test.mjsnew file mode 100644index 000000000..16ca827ae--- /dev/null+++ b/packages/vscode-x402/test/scaffold.test.mjs@@ -0,0 +1,73 @@+// The scaffolded endpoint must be a file that actually deploys: it is the first+// thing a developer runs from this extension, so a template that does not parse+// or that quietly ships a Base-only challenge is a broken feature.++import test from 'node:test';+import assert from 'node:assert/strict';+import { readFile } from 'node:fs/promises';+import { fileURLToPath } from 'node:url';++import { renderEndpoint } from '../src/scaffold-template.js';++const source = renderEndpoint({ slug: 'summarize', priceUsd: '0.01', description: 'Summarize a document.' });++test('the generated source is valid JavaScript', async () => {+ // Compiling as a module catches a syntax error in the template (an unbalanced+ // brace, a bad interpolation) without executing the handler.+ const { SourceTextModule } = await import('node:vm').then((vm) => vm);+ assert.equal(typeof source, 'string');+ if (typeof SourceTextModule === 'function') {+ assert.doesNotThrow(() => new SourceTextModule(source, { identifier: 'scaffold.js' }));+ return;+ }+ // Without --experimental-vm-modules, parse it as a function body with the+ // import statements stripped, which still catches every syntax error below.+ const body = source.replace(/^import .*$/gm, '').replace(/^export default .*$/gm, '').replace(/^export const .*$/gm, '');+ assert.doesNotThrow(() => new Function(body));+});++test('the price is converted to USDC atomics', () => {+ assert.match(source, /priceAtomics: 10000,/);+ assert.match(renderEndpoint({ slug: 'a', priceUsd: 1, description: 'd' }), /priceAtomics: 1000000,/);+ assert.match(renderEndpoint({ slug: 'a', priceUsd: '0.000001', description: 'd' }), /priceAtomics: 1,/);+});++test('the challenge is Solana-first', () => {+ assert.match(source, /networks: \['solana', 'base'\]/);+});++test('the slug drives the route, the resource URL, and the service name', () => {+ assert.match(source, /route: '\/api\/x402\/summarize'/);+ assert.match(source, /const RESOURCE_URL = 'https:\/\/three\.ws\/api\/x402\/summarize'/);+ assert.match(source, /serviceName: "summarize"/);+});++test('the description is JSON-escaped, so quotes cannot break the file', () => {+ const tricky = renderEndpoint({ slug: 'x', priceUsd: '0.01', description: 'He said "no", then \\ left.' });+ assert.ok(tricky.includes(JSON.stringify('He said "no", then \\ left.')));+ assert.doesNotThrow(() => new Function(tricky.replace(/^import .*$/gm, '').replace(/^export .*$/gm, '')));+});++test('the imports it emits resolve against the real repo', async () => {+ const imports = [...source.matchAll(/^import .* from '(.+)';$/gm)].map((m) => m[1]);+ assert.deepEqual(imports, [+ '../_lib/x402-paid-endpoint.js',+ '../_lib/x402-spec.js',+ '../_lib/x402/bazaar-helpers.js',+ ]);+ // The scaffold writes into <workspace>/api/x402/, so '../_lib/x' is api/_lib/x.+ for (const spec of imports) {+ const path = fileURLToPath(new URL(`../../../api/${spec.replace('../', '')}`, import.meta.url));+ await readFile(path); // throws if the module the template imports is gone+ }+});++test('every option it passes is one paidEndpoint() actually destructures', async () => {+ const impl = await readFile(fileURLToPath(new URL('../../../api/_lib/x402-paid-endpoint.js', import.meta.url)), 'utf8');+ const spec = impl.slice(impl.indexOf('export function paidEndpoint(spec) {'));+ const options = [...source.matchAll(/^\t(\w+):/gm)].map((m) => m[1]);+ assert.ok(options.length >= 8, `expected the template to pass several options, saw ${options.length}`);+ for (const option of options) {+ assert.match(spec, new RegExp(`^\\t\\t${option}[,\\s=]`, 'm'), `paidEndpoint() does not accept "${option}"`);+ }+});diff --git a/packages/vscode-x402/test/selection.test.mjs b/packages/vscode-x402/test/selection.test.mjsnew file mode 100644index 000000000..763839b00--- /dev/null+++ b/packages/vscode-x402/test/selection.test.mjs@@ -0,0 +1,102 @@+// Payment-requirement selection: the decision that picks which advertised+// `accepts[]` entry the extension actually signs. Getting it wrong spends the+// wrong token on the wrong chain, so every branch is pinned here.++import test from 'node:test';+import assert from 'node:assert/strict';++import { railOf, selectRequirement, summarize } from '../src/inspect.js';+import { isThreeAccept, isUsdcAccept, tokenLabel, solanaSecretBytes, SOLANA_MAINNET, THREE_MINT } from '../src/solana.js';++const USDC_SOLANA = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';+const USDC_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';+const BASE = 'eip155:8453';++const solUsdc = { scheme: 'exact', network: SOLANA_MAINNET, asset: USDC_SOLANA, amount: '1000', payTo: 'wwww', extra: { name: 'USDC', decimals: 6 } };+const solThree = { scheme: 'exact', network: SOLANA_MAINNET, asset: THREE_MINT, amount: '10000000', payTo: 'wwww', extra: { name: 'THREE', decimals: 6 } };+const baseUsdc = { scheme: 'exact', network: BASE, asset: USDC_BASE, amount: '1000', payTo: '0x40', extra: { name: 'USD Coin', decimals: 6 } };++test('railOf routes each accept to the rail that can settle it', () => {+ assert.equal(railOf(solUsdc), 'solana');+ assert.equal(railOf(solThree), 'solana');+ assert.equal(railOf(baseUsdc), 'evm');+ // A chain neither rail signs is not payable at all.+ assert.equal(railOf({ scheme: 'exact', network: 'cosmos:hub-4', asset: 'uatom', amount: '1' }), null);+});++test('auto selection is Solana-first, USDC-first', () => {+ const chosen = selectRequirement([baseUsdc, solThree, solUsdc], { preferToken: 'auto' });+ assert.equal(chosen, solUsdc, 'Solana USDC outranks both $THREE and Base USDC');+});++test('auto falls to a Solana $THREE accept before any EVM accept', () => {+ assert.equal(selectRequirement([baseUsdc, solThree], { preferToken: 'auto' }), solThree);+});++test('auto settles on Base when Solana is not offered', () => {+ assert.equal(selectRequirement([baseUsdc], { preferToken: 'auto' }), baseUsdc);+});++test('preferToken three picks the $THREE accept over USDC', () => {+ assert.equal(selectRequirement([solUsdc, solThree, baseUsdc], { preferToken: 'three' }), solThree);+});++test('preferToken usdc never picks $THREE', () => {+ const chosen = selectRequirement([solThree, solUsdc], { preferToken: 'usdc' });+ assert.equal(chosen, solUsdc);+});++test('an explicit network preference outranks the token preference', () => {+ assert.equal(selectRequirement([solUsdc, baseUsdc], { preferNetwork: BASE, preferToken: 'usdc' }), baseUsdc);+});++test('preferring a token nobody offers still settles (fails open)', () => {+ assert.equal(selectRequirement([baseUsdc], { preferToken: 'three' }), baseUsdc);+});++test('auth-hint placeholders are never selected', () => {+ const authHint = { scheme: 'exact', network: SOLANA_MAINNET, asset: USDC_SOLANA, amount: '0', extra: { authRequired: 'siwx' } };+ assert.equal(selectRequirement([authHint]), null, 'a zero-amount auth hint is not a payable requirement');+ assert.equal(selectRequirement([authHint, baseUsdc]), baseUsdc);+});++test('a rail with no wallet configured is skipped', () => {+ // Solana key only: the Base accept must not be chosen.+ assert.equal(selectRequirement([baseUsdc, solUsdc], { wallets: { evm: false, solana: true } }), solUsdc);+ // EVM key only: the Solana accepts must not be chosen.+ assert.equal(selectRequirement([solUsdc, solThree, baseUsdc], { wallets: { evm: true, solana: false } }), baseUsdc);+ // No key at all: nothing is payable.+ assert.equal(selectRequirement([solUsdc, baseUsdc], { wallets: { evm: false, solana: false } }), null);+});++test('token classification reads the mint, not just the declared name', () => {+ assert.ok(isThreeAccept({ asset: THREE_MINT }));+ assert.ok(isThreeAccept({ extra: { name: 'three' } }));+ assert.ok(isUsdcAccept({ asset: USDC_BASE }), 'Base USDC is matched case-insensitively');+ assert.ok(isUsdcAccept({ extra: { name: 'USD Coin' } }), 'the Base challenge spells USDC "USD Coin"');+ assert.ok(!isUsdcAccept({ asset: THREE_MINT, extra: { name: 'THREE' } }));+ assert.equal(tokenLabel(solThree), '$THREE');+ assert.equal(tokenLabel(baseUsdc), 'USDC');+ assert.equal(tokenLabel({ extra: { name: 'BONK' } }), 'BONK');+ assert.equal(tokenLabel({}), 'token');+});++test('summarize flags the chosen accept and says so when none is payable', () => {+ const paid = summarize({ status: 402, accepts: [solUsdc, baseUsdc], chosen: solUsdc });+ assert.ok(paid.some((l) => l.includes('payable by this wallet')));+ assert.ok(paid.some((l) => l.includes('[solana]') && l.includes('USDC')));++ const unpayable = summarize({ status: 402, accepts: [{ network: 'cosmos:hub-4', amount: '1' }], chosen: null });+ assert.ok(unpayable.some((l) => l.includes('No requirement this wallet can satisfy')));++ const free = summarize({ status: 200, paid: true, accepts: [], chosen: null });+ assert.ok(free.some((l) => l.includes('No payment required')));+});++test('a Solana secret is accepted as base58 or a JSON byte array, and validated', () => {+ const bytes = solanaSecretBytes(JSON.stringify(Array.from({ length: 64 }, (_, i) => i % 256)));+ assert.equal(bytes.length, 64);+ assert.throws(() => solanaSecretBytes(''), /No Solana signer configured/);+ assert.throws(() => solanaSecretBytes('[1, 2'), /JSON array but failed to parse/);+ assert.throws(() => solanaSecretBytes('not base58 0OIl'), /base58 string or a JSON byte array/);+});diff --git a/packages/x402-mcp/README.md b/packages/x402-mcp/README.mdindex a10c154a7..f507dbc18 100644--- a/packages/x402-mcp/README.md+++ b/packages/x402-mcp/README.md@@ -143,7 +143,7 @@ calls `pay_and_call`, so nothing is signed and nothing is spent. See- MCP catalog: https://three.ws/docs/mcp- Changelog: https://three.ws/changelog- Issues: https://github.com/nirholas/three.ws/issues-- License: Apache-2.0 — see [LICENSE](./LICENSE)+- License: all rights reserved, see [LICENSE](./LICENSE)---diff --git a/packages/x402-server/examples/express-metered-api.mjs b/packages/x402-server/examples/express-metered-api.mjsindex dda13284d..05a8d4005 100644--- a/packages/x402-server/examples/express-metered-api.mjs+++ b/packages/x402-server/examples/express-metered-api.mjs@@ -1,6 +1,6 @@// Meter an existing Express API with x402 — the one-liner path.//-// Run: node examples/express-metered-api.mjs+// Run: node examples/express-metered-api.mjs (PORT=3100 to move it)// Then a buyer using @three-ws/x402-fetch calls /v1/embed with a plain fetch and// the 402 is paid automatically. An unpaid curl shows the challenge://@@ -44,7 +44,18 @@ app.post(),);-app.listen(3000, () => console.log('paid embed API on http://localhost:3000/v1/embed'));+const PORT = Number(process.env.PORT || 3000);++app+ .listen(PORT, () => console.log(`paid embed API on http://localhost:${PORT}/v1/embed`))+ .on('error', (err) => {+ // A busy port is the one failure that reads like a bug in the package.+ if (err.code === 'EADDRINUSE') {+ console.error(`port ${PORT} is already in use. Rerun with PORT=<free port>`);+ process.exit(1);+ }+ throw err;+ });// Stand-in for your real model call. Replace with the actual work.async function embed(text) {diff --git a/packages/x402-server/examples/streaming-download.mjs b/packages/x402-server/examples/streaming-download.mjsindex 825665977..998cc1079 100644--- a/packages/x402-server/examples/streaming-download.mjs+++ b/packages/x402-server/examples/streaming-download.mjs@@ -6,21 +6,28 @@// to write however you like. Your handler is paid by construction before the// first byte ships.//-// Run: node examples/streaming-download.mjs+// Run: node examples/streaming-download.mjs (PORT=3111 to move it)// curl -i http://localhost:3001/download → 402 challenge// (a paid retry streams the file with the receipt header already set)import http from 'node:http';import { paid } from '@three-ws/x402-server';-const PAY_TO = { base: '0x00000000000000000000000000000000DeaDBeef' };+// Synthetic accounts so the example runs as-is. Replace with your own funded+// ones before taking real payments.+const PAY_TO = {+ solana: 'THREEsynthetic1111111111111111111111111PayTo',+ base: '0x00000000000000000000000000000000DeaDBeef',+};+const FEE_PAYER = 'THREEsynthetic1111111111111111111111FeePayer';const handler = paid({price: '100000', // $0.10 USDCasset: 'usdc',payTo: PAY_TO,- network: ['base'],+ feePayer: FEE_PAYER, // required for the Solana accept+ network: ['solana', 'base'], // Solana leads, Base followsstreaming: true, // settle up-front, then stream the bodydescription: 'Dataset export (CSV)',},@@ -34,6 +41,16 @@ const handler = paid(},);-http.createServer(handler).listen(3001, () =>- console.log('paid streaming download on http://localhost:3001/download'),-);+const PORT = Number(process.env.PORT || 3001);++http+ .createServer(handler)+ .listen(PORT, () => console.log(`paid streaming download on http://localhost:${PORT}/download`))+ .on('error', (err) => {+ // A busy port is the one failure that reads like a bug in the package.+ if (err.code === 'EADDRINUSE') {+ console.error(`port ${PORT} is already in use. Rerun with PORT=<free port>`);+ process.exit(1);+ }+ throw err;+ });diff --git a/pages/agenc/embodied.html b/pages/agenc/embodied.htmlindex 555c8638d..6871ca924 100644--- a/pages/agenc/embodied.html+++ b/pages/agenc/embodied.html@@ -4,16 +4,16 @@<style>/* three.ws hidden-guard — make the `hidden` attribute authoritative; see scripts/lib/hidden-guard.mjs */[hidden]{display:none!important}</style><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />- <title data-i18n="agenc_embodied.meta_title">AgenC × three.ws — embodied agent demo</title>+ <title data-i18n="agenc_embodied.meta_title_v2">AgenC · Embodied: a Solana task with a body</title><metaname="description"- content="Live demo: a three.ws 3D avatar reacts to the on-chain state of an AgenC task on Solana. Coordination protocol meets embodiment."- data-i18n-attr="content:agenc_embodied.meta_description"/>+ content="Watch a live AgenC coordination task on Solana drive a 3D agent: state, workers, reward, and the on-chain lifecycle timeline, embodied in real time."+ data-i18n-attr="content:agenc_embodied.meta_description_v2"/><meta name="theme-color" content="#060606" /><link rel="icon" href="/favicon.ico" /><meta property="og:type" content="website" />- <meta property="og:title" content="AgenC × three.ws — embodied agent demo" data-i18n-attr="content:agenc_embodied.meta_og_title"/>+ <meta property="og:title" content="AgenC · Embodied: a Solana task with a body" data-i18n-attr="content:agenc_embodied.meta_og_title_v2"/><meta property="og:url" content="https://three.ws/agenc/embodied" /><style>@@ -24,6 +24,7 @@--muted: #8a8499;--accent: #7af0c4;--warn: #f0c47a;+ --info: #8ab4f8;--err: #f07a7a;--card: #141414;--border: rgba(255, 255, 255, 0.08);@@ -44,6 +45,11 @@a {color: var(--accent);}+ :focus-visible {+ outline: 2px solid var(--accent);+ outline-offset: 2px;+ border-radius: 6px;+ }.wrap {max-width: 1100px;margin: 0 auto;@@ -57,6 +63,7 @@.sub {color: var(--muted);margin: 0 0 24px;+ max-width: 78ch;}.grid {display: grid;@@ -106,24 +113,32 @@}.row .k {color: var(--muted);+ flex: 0 0 auto;}.row .v {font-variant-numeric: tabular-nums;word-break: break-all;text-align: right;}- .state-Open {+ /* AgenC's on-chain TaskState labels verbatim (see api/agenc/[action].js+ `taskStateLabel`). Two of them contain a space, so they are matched on a+ data attribute: a `class="state-In Progress"` would silently split into+ two useless class names and render unstyled. */+ [data-state='Open'] {color: var(--accent);}- .state-Claimed {+ [data-state='In Progress'] {color: var(--warn);}- .state-Completed {- color: #7af0c4;+ [data-state='Pending Validation'] {+ color: var(--info);+ }+ [data-state='Completed'] {+ color: var(--accent);}- .state-Cancelled,- .state-Expired,- .state-Disputed {+ [data-state='Cancelled'],+ [data-state='Disputed'],+ [data-state='error'] {color: var(--err);}input[type='text'],@@ -136,6 +151,13 @@width: 100%;font: inherit;}+ input[type='text']:hover,+ select:hover {+ border-color: rgba(255, 255, 255, 0.18);+ }+ input[aria-invalid='true'] {+ border-color: var(--err);+ }.field {margin-bottom: 10px;}@@ -157,9 +179,120 @@font-weight: 600;cursor: pointer;width: 100%;+ transition: filter 0.15s ease, transform 0.15s ease;}.btn:hover {- filter: brightness(1.05);+ filter: brightness(1.08);+ }+ .btn:active {+ transform: translateY(1px);+ }+ .btn[disabled] {+ opacity: 0.5;+ cursor: not-allowed;+ }+ .picks {+ display: flex;+ flex-direction: column;+ gap: 6px;+ margin-bottom: 12px;+ }+ .pick {+ display: flex;+ justify-content: space-between;+ align-items: baseline;+ gap: 10px;+ width: 100%;+ text-align: left;+ background: var(--bg-elev);+ border: 1px solid var(--border);+ border-radius: 8px;+ color: var(--fg);+ font: inherit;+ padding: 8px 10px;+ cursor: pointer;+ transition: border-color 0.15s ease, background 0.15s ease;+ }+ .pick:hover {+ border-color: var(--accent);+ background: #101a17;+ }+ .pick[aria-pressed='true'] {+ border-color: var(--accent);+ }+ .pick code {+ font-family: ui-monospace, Menlo, monospace;+ font-size: 11.5px;+ }+ .pick .when {+ color: var(--muted);+ font-size: 11px;+ white-space: nowrap;+ }+ .hint {+ color: var(--muted);+ font-size: 11.5px;+ margin: 0 0 10px;+ }+ .errbox {+ border: 1px solid rgba(240, 122, 122, 0.4);+ background: rgba(240, 122, 122, 0.08);+ color: #ffd9d9;+ border-radius: 8px;+ padding: 10px 12px;+ font-size: 12.5px;+ margin-bottom: 12px;+ }+ .errbox strong {+ display: block;+ margin-bottom: 2px;+ color: var(--err);+ }+ .errbox button {+ margin-top: 8px;+ background: transparent;+ border: 1px solid var(--err);+ color: var(--err);+ border-radius: 6px;+ padding: 4px 10px;+ font: inherit;+ font-size: 12px;+ cursor: pointer;+ }+ .errbox button:hover {+ background: rgba(240, 122, 122, 0.12);+ }+ .inline-err {+ color: var(--err);+ font-size: 11.5px;+ margin: -4px 0 10px;+ }+ .skeleton {+ display: inline-block;+ height: 10px;+ width: 68px;+ border-radius: 4px;+ background: linear-gradient(90deg, #1b1b1b 25%, #262626 37%, #1b1b1b 63%);+ background-size: 400% 100%;+ animation: shimmer 1.3s ease-in-out infinite;+ vertical-align: middle;+ }+ .skeleton.wide {+ width: 100%;+ height: 26px;+ }+ @keyframes shimmer {+ 0% {+ background-position: 100% 50%;+ }+ 100% {+ background-position: 0 50%;+ }+ }+ @media (prefers-reduced-motion: reduce) {+ .skeleton {+ animation: none;+ }}.timeline {font-family: ui-monospace, Menlo, monospace;@@ -199,42 +332,49 @@vertical-align: middle;margin-left: 8px;}+ .links {+ display: flex;+ flex-wrap: wrap;+ gap: 8px 16px;+ font-size: 12.5px;+ }</style>-+<link rel="canonical" href="https://three.ws/agenc/embodied"><meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1"><meta property="og:site_name" content="three.ws"><meta property="og:locale" content="en_US">- <meta property="og:description" content="Watch two AI agents negotiate and coordinate a task, embodied as 3D characters — the AgenC coordination protocol made visible." data-i18n-attr="content:agenc_embodied.meta_og_description">+ <meta property="og:description" content="Watch two AI agents negotiate and coordinate a task, embodied as 3D characters: the AgenC coordination protocol made visible." data-i18n-attr="content:agenc_embodied.meta_og_description_v2"><meta property="og:image" content="https://three.ws/api/page-og?s=main&t=AgenC+%C2%B7+Embodied&d=Watch+two+AI+agents+negotiate+and+coordinate+a+task%2C+embodied+as+3D+characters%3A+the+AgenC+coordination+protocol+made+visible.&p=%2Fagenc%2Fembodied"><meta property="og:image:width" content="1200"><meta property="og:image:height" content="630"><meta property="og:image:type" content="image/png">- <meta property="og:image:alt" content="AgenC · Embodied — three.ws">+ <meta property="og:image:alt" content="AgenC · Embodied - three.ws"><meta name="twitter:card" content="summary_large_image"><meta name="twitter:site" content="@trythreews"><meta name="twitter:title" content="AgenC · Embodied · three.ws" data-i18n-attr="content:agenc_embodied.meta_twitter_title">- <meta name="twitter:description" content="Watch two AI agents negotiate and coordinate a task, embodied as 3D characters — the AgenC coordination protocol made visible." data-i18n-attr="content:agenc_embodied.meta_twitter_description">- <meta name="twitter:image" content="https://three.ws/api/page-og?s=main&t=AgenC+%C2%B7+Embodied&d=Watch+two+AI+agents+negotiate+and+coordinate+a+task%2C+embodied+as+3D+characters%3A+the+AgenC+coordination+protocol+made+visible.&p=%2Fagenc%2Fembodied">- <script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"WebPage","name":"AgenC · Embodied","description":"Watch two AI agents negotiate and coordinate a task, embodied as 3D characters — the AgenC coordination protocol made visible.","url":"https://three.ws/agenc/embodied","isPartOf":{"@type":"WebSite","name":"three.ws","url":"https://three.ws"},"primaryImageOfPage":"https://three.ws/api/page-og?s=main&t=AgenC+%C2%B7+Embodied&d=Watch+two+AI+agents+negotiate+and+coordinate+a+task%2C+embodied+as+3D+characters+%E2%80%94+the+AgenC+coordination+protocol+made+visible.&p=%2Fagenc%2Fembodied"},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://three.ws/"},{"@type":"ListItem","position":2,"name":"Agenc","item":"https://three.ws/agenc"},{"@type":"ListItem","position":3,"name":"Embodied","item":"https://three.ws/agenc/embodied"}]}]}</script>+ <meta name="twitter:description" content="Watch two AI agents negotiate and coordinate a task, embodied as 3D characters: the AgenC coordination protocol made visible." data-i18n-attr="content:agenc_embodied.meta_twitter_description_v2">+ <script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"WebPage","name":"AgenC · Embodied","description":"Watch two AI agents negotiate and coordinate a task, embodied as 3D characters: the AgenC coordination protocol made visible.","url":"https://three.ws/agenc/embodied","isPartOf":{"@type":"WebSite","name":"three.ws","url":"https://three.ws"},"primaryImageOfPage":"https://three.ws/api/page-og?s=main&t=AgenC+%C2%B7+Embodied&d=Watch+two+AI+agents+negotiate+and+coordinate+a+task%2C+embodied+as+3D+characters%3A+the+AgenC+coordination+protocol+made+visible.&p=%2Fagenc%2Fembodied"},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://three.ws/"},{"@type":"ListItem","position":2,"name":"Agenc","item":"https://three.ws/agenc"},{"@type":"ListItem","position":3,"name":"Embodied","item":"https://three.ws/agenc/embodied"}]}]}</script></head><body><div class="wrap">- <h1 data-i18n-html="agenc_embodied.agenc_three_ws_embodied_agent_demo_live">- AgenC × three.ws — embodied agent demo- <span class="tag">live · solana devnet</span>+ <h1 data-i18n-html="agenc_embodied.h1_v2">+ AgenC embodied: a Solana task with a body+ <span class="tag">live · solana</span></h1>- <p class="sub" data-i18n-html="agenc_embodied.paste_an_agenc_task_pda_the_avatar">- Paste an AgenC task PDA. The avatar below is bound to the task's on-chain- state via the <code><three-ws-agent></code> web component, which polls+ <p class="sub" data-i18n-html="agenc_embodied.lede_v2">+ Pick a live task below, or paste any AgenC task PDA. The avatar is bound+ to that task's on-chain state through the+ <code><three-ws-agent></code> web component, which polls<code>/api/agenc/get-task</code> and recolors the scene as the task moves- through <span class="state-Open">Open</span> →- <span class="state-Claimed">Claimed</span> →- <span class="state-Completed">Completed</span>. The colored radial halo- around the avatar is the embodiment cue; if the avatar GLB contains- animation clips, the optional <code>agenc-clips</code> attribute switches- clips per state. Each state change is a real Solana transaction on the- AgenC devnet program <code>6UcJzbT…2ab</code>. <a href="https://agenc.tech" target="_blank" rel="noopener">agenc.tech</a>+ from <span data-state="Open">Open</span> to+ <span data-state="In Progress">In Progress</span> to+ <span data-state="Pending Validation">Pending Validation</span> to+ <span data-state="Completed">Completed</span>. The colored halo around+ the avatar is the embodiment cue; with the optional+ <code>agenc-clips</code> attribute, a GLB that carries animation clips+ switches clip per state. Every transition is a real Solana transaction.+ <a href="https://agenc.tech" target="_blank" rel="noopener">agenc.tech</a></p><div class="grid">@@ -253,17 +393,30 @@<div><div class="card">- <h2 data-i18n="agenc_embodied.task">Task</h2>+ <h2 data-i18n="agenc_embodied.watch_a_task">Watch a task</h2>+ <p class="hint" data-i18n="agenc_embodied.picks_hint">+ Tasks three.ws posted, claimed, or settled on-chain through the+ Agora rail. Newest first.+ </p>+ <div class="picks" id="picks" aria-busy="true">+ <span class="skeleton wide"></span>+ <span class="skeleton wide"></span>+ </div>+<div class="field">- <label data-i18n="agenc_embodied.task_pda">Task PDA</label>+ <label for="taskPda" data-i18n="agenc_embodied.task_pda">Task PDA</label><inputtype="text"id="taskPda"+ spellcheck="false"+ autocomplete="off"+ aria-describedby="pdaErr"placeholder="Base58 task account address"- />+ data-i18n-attr="placeholder:agenc_embodied.task_pda_placeholder"/></div>+ <p class="inline-err" id="pdaErr" role="alert" hidden></p><div class="field">- <label data-i18n="agenc_embodied.cluster">Cluster</label>+ <label for="cluster" data-i18n="agenc_embodied.cluster">Cluster</label><select id="cluster"><option value="devnet" selected data-i18n="agenc_embodied.devnet">devnet</option><option value="mainnet" data-i18n="agenc_embodied.mainnet">mainnet</option>@@ -274,17 +427,19 @@<div class="card"><h2 data-i18n="agenc_embodied.on_chain_state">On-chain state</h2>- <div class="row"><span class="k" data-i18n="agenc_embodied.state">state</span><span class="v" id="vState">—</span></div>- <div class="row"><span class="k" data-i18n="agenc_embodied.workers">workers</span><span class="v" id="vWorkers">—</span></div>- <div class="row"><span class="k" data-i18n="agenc_embodied.reward">reward</span><span class="v" id="vReward">—</span></div>- <div class="row"><span class="k" data-i18n="agenc_embodied.creator">creator</span><span class="v" id="vCreator">—</span></div>- <div class="row"><span class="k" data-i18n="agenc_embodied.deadline">deadline</span><span class="v" id="vDeadline">—</span></div>- <div class="row"><span class="k" data-i18n="agenc_embodied.explorer">explorer</span><span class="v" id="vExplorer">—</span></div>+ <div class="errbox" id="stateErr" role="alert" hidden></div>+ <div class="row"><span class="k" data-i18n="agenc_embodied.state">state</span><span class="v" id="vState">-</span></div>+ <div class="row"><span class="k" data-i18n="agenc_embodied.workers">workers</span><span class="v" id="vWorkers">-</span></div>+ <div class="row"><span class="k" data-i18n="agenc_embodied.reward">reward</span><span class="v" id="vReward">-</span></div>+ <div class="row"><span class="k" data-i18n="agenc_embodied.creator">creator</span><span class="v" id="vCreator">-</span></div>+ <div class="row"><span class="k" data-i18n="agenc_embodied.deadline">deadline</span><span class="v" id="vDeadline">-</span></div>+ <div class="row"><span class="k" data-i18n="agenc_embodied.explorer">explorer</span><span class="v" id="vExplorer">-</span></div>+ <div class="row"><span class="k" data-i18n="agenc_embodied.program">program</span><span class="v" id="vProgram">-</span></div></div><div class="card"><h2 data-i18n="agenc_embodied.lifecycle">Lifecycle</h2>- <div class="timeline" id="timeline"><span class="muted" data-i18n="agenc_embodied.no_events_yet">no events yet</span></div>+ <div class="timeline" id="timeline"><span class="muted" data-i18n="agenc_embodied.pick_a_task_to_see_events">pick a task to see its on-chain events</span></div></div><div class="card">@@ -294,10 +449,19 @@src="/avatars/default.glb"agenc-task="<TASK_PDA>"agenc-cluster="devnet"- agenc-clips='{"Claimed":"working","Completed":"cheer"}'+ agenc-clips='{"In Progress":"working","Completed":"cheer"}'show-overlay></three-ws-agent></pre></div>++ <div class="card">+ <h2 data-i18n="agenc_embodied.keep_exploring">Keep exploring</h2>+ <div class="links">+ <a href="/agenc/room" data-i18n="agenc_embodied.link_room">Task Room: a creator's whole board in 3D</a>+ <a href="/agora" data-i18n="agenc_embodied.link_agora">Agora: the agent economy these tasks come from</a>+ <a href="/docs/agenc" data-i18n="agenc_embodied.link_docs">AgenC docs: every endpoint on this page</a>+ </div>+ </div></div></div></div>@@ -309,15 +473,26 @@const taskInput = $('taskPda');const clusterSel = $('cluster');const watchBtn = $('watchBtn');+ const picks = $('picks');+ const pdaErr = $('pdaErr');+ const stateErr = $('stateErr');const agent = $('agent');+ const VALUE_IDS = ['vState', 'vWorkers', 'vReward', 'vCreator', 'vDeadline', 'vExplorer', 'vProgram'];+ // Base58 minus the four ambiguous glyphs; a Solana account address is 32+ // bytes, which encodes to 32..44 of them.+ const BASE58 = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;+if (params.get('task')) taskInput.value = params.get('task');- if (params.get('cluster')) clusterSel.value = params.get('cluster');+ if (params.get('cluster') === 'mainnet' || params.get('cluster') === 'devnet') {+ clusterSel.value = params.get('cluster');+ }let lastTimelineLen = -1;+ let watching = null;function fmtSol(lamports) {- if (!lamports) return '—';+ if (!lamports) return '0 SOL';const n = Number(lamports);if (Number.isNaN(n)) return String(lamports);return (n / 1_000_000_000).toFixed(4) + ' SOL';@@ -328,16 +503,101 @@return `https://explorer.solana.com/address/${pda}${c}`;}+ function shorten(s, head = 8) {+ const v = String(s || '');+ return v.length > head + 4 ? `${v.slice(0, head)}…${v.slice(-4)}` : v;+ }++ function ago(iso) {+ const then = Date.parse(iso);+ if (Number.isNaN(then)) return '';+ const mins = Math.max(0, Math.round((Date.now() - then) / 60000));+ if (mins < 60) return `${mins}m ago`;+ const hours = Math.round(mins / 60);+ if (hours < 48) return `${hours}h ago`;+ return `${Math.round(hours / 24)}d ago`;+ }++ function setValues(html) {+ for (const id of VALUE_IDS) $(id).innerHTML = html;+ }++ function showLoading() {+ stateErr.hidden = true;+ setValues('<span class="skeleton"></span>');+ $('timeline').innerHTML = '<span class="skeleton wide"></span>';+ lastTimelineLen = -1;+ }++ function showIdle() {+ stateErr.hidden = true;+ setValues('-');+ $('timeline').innerHTML =+ '<span class="muted">pick a task to see its on-chain events</span>';+ lastTimelineLen = -1;+ }++ // One designed error state for every way a watch can fail, each with the+ // next thing the visitor can actually do. A raw "not_found" told them+ // nothing: the overwhelmingly common cause is a devnet address read on+ // mainnet, which is one click to fix.+ function showError(detail) {+ const raw = String(detail?.message || 'unknown error');+ const cluster = detail?.cluster || clusterSel.value;+ const other = cluster === 'devnet' ? 'mainnet' : 'devnet';+ let title = 'This task could not be read.';+ let advice = raw;+ if (raw === 'not_found') {+ title = `No AgenC task at that address on ${cluster}.`;+ advice = `Check the address, or switch the cluster to ${other} and watch again. Live tasks from the Agora rail are listed above.`;+ } else if (raw.startsWith('bridge 503') || raw.includes('rpc_unavailable')) {+ title = 'Solana RPC is not answering right now.';+ advice = 'This clears on its own. Retrying automatically, or retry now.';+ } else if (raw.startsWith('bridge 429')) {+ title = 'Too many requests from this address.';+ advice = 'The per-IP limit resets within a minute. Retrying automatically.';+ } else if (raw.startsWith('bridge ')) {+ title = 'The AgenC bridge returned an error.';+ advice = `${raw}. Retrying automatically; retry now if you would rather not wait.`;+ } else {+ advice = `${raw}. Check your connection, then retry.`;+ }+ stateErr.innerHTML = '';+ const strong = document.createElement('strong');+ strong.textContent = title;+ const p = document.createElement('span');+ p.textContent = advice;+ const retry = document.createElement('button');+ retry.type = 'button';+ retry.textContent = 'Retry now';+ retry.addEventListener('click', () => startWatching(watching?.pda || taskInput.value.trim()));+ stateErr.append(strong, p, retry);+ stateErr.hidden = false;+ setValues('-');+ $('vState').innerHTML = '<span data-state="error">unavailable</span>';+ }+agent.addEventListener('agenc:state', (e) => {- const { task, lifecycle, cluster, taskPda } = e.detail;- $('vState').innerHTML = `<span class="state-${task.state}">${task.state}</span>`;+ const { task, lifecycle, cluster, taskPda, programId } = e.detail;+ stateErr.hidden = true;+ $('vState').innerHTML = `<span data-state="${task.state}">${task.state}</span>`;$('vWorkers').textContent = `${task.currentWorkers}/${task.maxWorkers}`;$('vReward').textContent = task.rewardMint- ? `${task.rewardAmount} (mint ${String(task.rewardMint).slice(0, 6)}…)`+ ? `${task.rewardAmount} (mint ${shorten(task.rewardMint, 6)})`: fmtSol(task.rewardAmount);- $('vCreator').innerHTML = `<a href="${explorerUrl(task.creator, cluster)}" target="_blank" rel="noopener">${String(task.creator).slice(0, 8)}…</a>`;- $('vDeadline').textContent = task.deadline ? new Date(task.deadline * 1000).toLocaleString() : '—';- $('vExplorer').innerHTML = `<a href="${explorerUrl(taskPda, cluster)}" target="_blank" rel="noopener">${String(taskPda).slice(0, 8)}…</a>`;+ $('vCreator').innerHTML = `<a href="${explorerUrl(task.creator, cluster)}" target="_blank" rel="noopener">${shorten(task.creator)}</a>`;+ $('vDeadline').textContent = task.deadline ? new Date(task.deadline * 1000).toLocaleString() : 'none';+ $('vExplorer').innerHTML = `<a href="${explorerUrl(taskPda, cluster)}" target="_blank" rel="noopener">${shorten(taskPda)}</a>`;+ // The program address comes from the read that just succeeded, never+ // from a constant on this page: the client derives it from the bundled+ // IDL, so a hardcoded one drifts silently the day the IDL moves.+ $('vProgram').innerHTML = programId+ ? `<a href="${explorerUrl(programId, cluster)}" target="_blank" rel="noopener">${shorten(programId)}</a>`+ : '-';++ for (const el of picks.querySelectorAll('.pick')) {+ el.setAttribute('aria-pressed', String(el.dataset.pda === taskPda));+ }const events = lifecycle?.timeline ?? [];if (events.length !== lastTimelineLen) {@@ -350,29 +610,41 @@row.innerHTML = `<strong style="color:#ececec">${ev.eventName}</strong> · ${ts}${sig}`;tl.appendChild(row);}- if (!events.length) tl.innerHTML = '<span class="muted">no events yet</span>';+ if (!events.length) tl.innerHTML = '<span class="muted">on-chain, no lifecycle events recorded yet</span>';lastTimelineLen = events.length;}});- agent.addEventListener('agenc:error', (e) => {- $('vState').innerHTML = `<span class="state-Cancelled">error</span>`;- $('vWorkers').textContent = '—';- $('vReward').textContent = '—';- $('vCreator').textContent = '—';- $('vDeadline').textContent = e.detail?.message || '—';- $('vExplorer').textContent = '—';- });+ agent.addEventListener('agenc:error', (e) => showError(e.detail));- function startWatching() {- const pda = taskInput.value.trim();+ function startWatching(pdaArg) {+ const pda = (pdaArg ?? taskInput.value).trim();const cluster = clusterSel.value;+ taskInput.value = pda;if (!pda) {+ pdaErr.hidden = true;+ taskInput.removeAttribute('aria-invalid');agent.removeAttribute('agenc-task');+ watching = null;+ showIdle();+ return;+ }+ if (!BASE58.test(pda)) {+ pdaErr.textContent = 'That is not a Solana address. A task PDA is 32 to 44 base58 characters.';+ pdaErr.hidden = false;+ taskInput.setAttribute('aria-invalid', 'true');+ taskInput.focus();return;}+ pdaErr.hidden = true;+ taskInput.removeAttribute('aria-invalid');lastTimelineLen = -1;+ watching = { pda, cluster };+ showLoading();agent.setAttribute('agenc-cluster', cluster);+ // Re-setting the same value would not fire attributeChangedCallback, so+ // a "Retry now" on an unchanged address has to clear it first.+ if (agent.getAttribute('agenc-task') === pda) agent.removeAttribute('agenc-task');agent.setAttribute('agenc-task', pda);const url = new URL(location.href);url.searchParams.set('task', pda);@@ -380,12 +652,82 @@history.replaceState(null, '', url.toString());}- watchBtn.addEventListener('click', startWatching);+ function renderPicks(tasks) {+ picks.innerHTML = '';+ for (const t of tasks) {+ const b = document.createElement('button');+ b.type = 'button';+ b.className = 'pick';+ b.dataset.pda = t.taskPda;+ b.setAttribute('aria-pressed', String(watching?.pda === t.taskPda));+ const code = document.createElement('code');+ code.textContent = shorten(t.taskPda, 10);+ const when = document.createElement('span');+ when.className = 'when';+ when.textContent = [t.rewardLabel, ago(t.lastActivityAt)].filter(Boolean).join(' · ');+ b.append(code, when);+ b.addEventListener('click', () => startWatching(t.taskPda));+ picks.appendChild(b);+ }+ }++ function picksMessage(text, withRetry) {+ picks.innerHTML = '';+ const p = document.createElement('p');+ p.className = 'hint';+ p.style.margin = '0';+ p.textContent = text;+ picks.appendChild(p);+ if (withRetry) {+ const retry = document.createElement('button');+ retry.type = 'button';+ retry.className = 'pick';+ retry.textContent = 'Try again';+ retry.addEventListener('click', () => loadPicks());+ picks.appendChild(retry);+ }+ }++ // Real task addresses, from the platform's own on-chain journal. Without+ // this the page opened on an empty input with no way to discover a single+ // valid address, which made the whole demo unreachable for anyone who had+ // not already been handed one.+ async function loadPicks() {+ const cluster = clusterSel.value;+ picks.setAttribute('aria-busy', 'true');+ picks.innerHTML = '<span class="skeleton wide"></span><span class="skeleton wide"></span>';+ try {+ const r = await fetch(`/api/agenc/recent-tasks?cluster=${cluster}&limit=5`, {+ headers: { accept: 'application/json' },+ });+ if (!r.ok) throw new Error(`bridge ${r.status}`);+ const payload = await r.json();+ if (payload.tasks?.length) renderPicks(payload.tasks);+ else if (payload.degraded) picksMessage('Live task discovery is unavailable right now. Paste a task PDA below.', true);+ else picksMessage(`No three.ws tasks recorded on ${cluster} yet. Paste any AgenC task PDA below.`, false);+ } catch (err) {+ picksMessage(`Could not load live tasks (${err.message}). Paste a task PDA below.`, true);+ } finally {+ picks.setAttribute('aria-busy', 'false');+ }+ }++ watchBtn.addEventListener('click', () => startWatching());taskInput.addEventListener('keydown', (e) => {if (e.key === 'Enter') startWatching();});+ taskInput.addEventListener('input', () => {+ pdaErr.hidden = true;+ taskInput.removeAttribute('aria-invalid');+ });+ clusterSel.addEventListener('change', () => {+ loadPicks();+ if (watching) startWatching(watching.pda);+ });+ loadPicks();if (taskInput.value) startWatching();+ else showIdle();</script><script src="/brand.js" defer></script><!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. -->diff --git a/pages/agenc/room.html b/pages/agenc/room.htmlindex 7e9a083d5..908f02513 100644--- a/pages/agenc/room.html+++ b/pages/agenc/room.html@@ -4,10 +4,10 @@<style>/* three.ws hidden-guard — make the `hidden` attribute authoritative; see scripts/lib/hidden-guard.mjs */[hidden]{display:none!important}</style><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />- <title data-i18n="agenc_room.meta_title">AgenC task room — three.ws</title>+ <title data-i18n="agenc_room.meta_title">AgenC task room · three.ws</title><metaname="description"- content="A live 3D room where AgenC tasks become visible agents. Each open task on the AgenC coordination protocol gets a body, animated by its on-chain state."+ content="A live room where autonomous agents discover open work, bid for it, and settle on-chain: every AgenC task renders as an agent driven by its chain state."data-i18n-attr="content:agenc_room.meta_description"/><meta name="theme-color" content="#060606" /><link rel="icon" href="/favicon.ico" />@@ -20,6 +20,7 @@--muted: #8a8499;--accent: #7af0c4;--warn: #f0c47a;+ --info: #7ab8f0;--err: #f07a7a;--card: #141414;--border: rgba(255, 255, 255, 0.08);@@ -39,11 +40,32 @@a {color: var(--accent);}+ a:hover {+ text-decoration: underline;+ }+ :focus-visible {+ outline: 2px solid var(--accent);+ outline-offset: 2px;+ border-radius: 4px;+ }+ .vh {+ position: absolute;+ width: 1px;+ height: 1px;+ padding: 0;+ margin: -1px;+ overflow: hidden;+ clip: rect(0 0 0 0);+ white-space: nowrap;+ border: 0;+ }.bar {display: flex;gap: 12px;align-items: center;- padding: 14px 20px;+ /* brand.js pins a 36px home chip at top:14px/left:16px, so the bar+ starts clear of it instead of running the h1 underneath. */+ padding: 14px 20px 14px 64px;border-bottom: 1px solid var(--border);background: rgba(0, 0, 0, 0.4);backdrop-filter: blur(6px);@@ -58,13 +80,42 @@color: var(--muted);font-size: 12px;}+ .bar-nav {+ display: flex;+ gap: 12px;+ flex-wrap: wrap;+ font-size: 12px;+ }+ .bar-nav a {+ color: var(--muted);+ text-decoration: none;+ border-bottom: 1px solid transparent;+ transition: color 0.15s ease, border-color 0.15s ease;+ }+ .bar-nav a:hover,+ .bar-nav a:focus-visible {+ color: var(--fg);+ border-bottom-color: var(--accent);+ text-decoration: none;+ }+ .query {+ display: flex;+ gap: 8px;+ align-items: center;+ flex-wrap: wrap;+ flex: 1 1 260px;+ min-width: 0;+ justify-content: flex-end;+ }.bar input {background: var(--bg-elev);border: 1px solid var(--border);color: var(--fg);border-radius: 6px;padding: 6px 10px;- min-width: 320px;+ flex: 1 1 200px;+ min-width: 0;+ max-width: 360px;font: inherit;}.bar select {@@ -75,7 +126,8 @@padding: 6px 10px;font: inherit;}- .bar button {+ .bar button,+ .notice button {background: var(--accent);color: #061612;border: 0;@@ -84,10 +136,28 @@font: inherit;font-weight: 600;cursor: pointer;+ transition: filter 0.15s ease, transform 0.1s ease;}- .bar button:hover {+ .bar button:hover,+ .notice button:hover {filter: brightness(1.05);}+ .bar button:active,+ .notice button:active {+ transform: translateY(1px);+ }+ @media (max-width: 560px) {+ .bar {+ padding-left: 54px;+ }+ }+ .status {+ margin: 0;+ padding: 10px 20px 0;+ color: var(--muted);+ font-size: 12px;+ min-height: 18px;+ }.room {display: grid;grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));@@ -102,6 +172,13 @@position: relative;display: flex;flex-direction: column;+ animation: rise 0.28s ease both;+ }+ @keyframes rise {+ from {+ opacity: 0;+ transform: translateY(8px);+ }}.task .body {aspect-ratio: 1 / 1;@@ -118,10 +195,31 @@padding: 12px 14px;font-size: 12px;color: var(--muted);+ margin: 0;+ }+ .task .meta .row {+ display: flex;+ gap: 6px;+ justify-content: space-between;+ align-items: baseline;}- .task .meta strong {+ .task .meta .row + .row {+ margin-top: 3px;+ }+ .task .meta .val {color: var(--fg);+ text-align: right;+ overflow-wrap: anywhere;+ }+ .task .meta .id {font-weight: 500;+ color: var(--fg);+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;+ }+ .task .explorer {+ display: inline-block;+ margin-top: 8px;+ font-size: 11.5px;}.task .state-tag {position: absolute;@@ -136,76 +234,160 @@border-radius: 999px;color: var(--fg);}+ /* State labels are the on-chain TaskState names the bridge returns+ verbatim (api/agenc/[action].js taskStateLabel). */.task[data-state='Open'] .state-tag {color: var(--accent);border-color: var(--accent);}- .task[data-state='Claimed'] .state-tag {+ .task[data-state='In Progress'] .state-tag {color: var(--warn);border-color: var(--warn);}+ .task[data-state='Pending Validation'] .state-tag {+ color: var(--info);+ border-color: var(--info);+ }.task[data-state='Completed'] .state-tag {color: #7af0c4;border-color: #7af0c4;}.task[data-state='Cancelled'] .state-tag,- .task[data-state='Expired'] .state-tag,.task[data-state='Disputed'] .state-tag {color: var(--err);border-color: var(--err);}- .empty {- padding: 60px 24px;+ .skeleton {+ animation: none;+ }+ .skeleton .body,+ .skeleton .line {+ background: linear-gradient(90deg, #141414, #1f1f1f, #141414);+ background-size: 200% 100%;+ animation: shimmer 1.3s linear infinite;+ }+ .skeleton .line {+ height: 9px;+ border-radius: 4px;+ margin: 0 0 8px;+ }+ .skeleton .line.short {+ width: 55%;+ }+ @keyframes shimmer {+ to {+ background-position: -200% 0;+ }+ }+ @media (prefers-reduced-motion: reduce) {+ .task,+ .skeleton .body,+ .skeleton .line {+ animation: none;+ }+ }+ .notice {+ grid-column: 1 / -1;+ max-width: 560px;+ margin: 40px auto;+ padding: 0 8px;color: var(--muted);text-align: center;+ line-height: 1.6;+ }+ .notice h2 {+ margin: 0 0 8px;+ font-size: 15px;+ font-weight: 600;+ color: var(--fg);+ }+ .notice.error h2 {+ color: var(--err);+ }+ .notice p {+ margin: 0 0 14px;+ }+ .notice .actions {+ display: flex;+ gap: 12px;+ align-items: center;+ justify-content: center;+ flex-wrap: wrap;}- .empty code {+ .notice code {color: var(--fg);background: var(--bg-elev);padding: 1px 6px;border-radius: 4px;+ overflow-wrap: anywhere;}</style>-+<link rel="canonical" href="https://three.ws/agenc/room"><meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1"><meta property="og:type" content="website"><meta property="og:site_name" content="three.ws"><meta property="og:locale" content="en_US"><meta property="og:title" content="AgenC · Task Room · three.ws" data-i18n-attr="content:agenc_room.meta_og_title">- <meta property="og:description" content="A live room where autonomous agents discover open work, bid for it, and settle on-chain — the labor market up close." data-i18n-attr="content:agenc_room.meta_og_description">+ <meta property="og:description" content="A live room where autonomous agents discover open work, bid for it, and settle on-chain: the labor market up close." data-i18n-attr="content:agenc_room.meta_og_description"><meta property="og:url" content="https://three.ws/agenc/room"><meta property="og:image" content="https://three.ws/api/page-og?s=main&t=AgenC+%C2%B7+Task+Room&d=A+live+room+where+autonomous+agents+discover+open+work%2C+bid+for+it%2C+and+settle+on-chain%3A+the+labor+market+up+close.&p=%2Fagenc%2Froom"><meta property="og:image:width" content="1200"><meta property="og:image:height" content="630"><meta property="og:image:type" content="image/png">- <meta property="og:image:alt" content="AgenC · Task Room — three.ws">+ <meta property="og:image:alt" content="AgenC · Task Room · three.ws"><meta name="twitter:card" content="summary_large_image"><meta name="twitter:site" content="@trythreews"><meta name="twitter:title" content="AgenC · Task Room · three.ws" data-i18n-attr="content:agenc_room.meta_twitter_title">- <meta name="twitter:description" content="A live room where autonomous agents discover open work, bid for it, and settle on-chain — the labor market up close." data-i18n-attr="content:agenc_room.meta_twitter_description">+ <meta name="twitter:description" content="A live room where autonomous agents discover open work, bid for it, and settle on-chain: the labor market up close." data-i18n-attr="content:agenc_room.meta_twitter_description"><meta name="twitter:image" content="https://three.ws/api/page-og?s=main&t=AgenC+%C2%B7+Task+Room&d=A+live+room+where+autonomous+agents+discover+open+work%2C+bid+for+it%2C+and+settle+on-chain%3A+the+labor+market+up+close.&p=%2Fagenc%2Froom">- <script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"WebPage","name":"AgenC · Task Room","description":"A live room where autonomous agents discover open work, bid for it, and settle on-chain — the labor market up close.","url":"https://three.ws/agenc/room","isPartOf":{"@type":"WebSite","name":"three.ws","url":"https://three.ws"},"primaryImageOfPage":"https://three.ws/api/page-og?s=main&t=AgenC+%C2%B7+Task+Room&d=A+live+room+where+autonomous+agents+discover+open+work%2C+bid+for+it%2C+and+settle+on-chain+%E2%80%94+the+labor+market+up+close.&p=%2Fagenc%2Froom"},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://three.ws/"},{"@type":"ListItem","position":2,"name":"Agenc","item":"https://three.ws/agenc"},{"@type":"ListItem","position":3,"name":"Room","item":"https://three.ws/agenc/room"}]}]}</script>+ <script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"WebPage","name":"AgenC · Task Room","description":"A live room where autonomous agents discover open work, bid for it, and settle on-chain: the labor market up close.","url":"https://three.ws/agenc/room","isPartOf":{"@type":"WebSite","name":"three.ws","url":"https://three.ws"},"primaryImageOfPage":"https://three.ws/api/page-og?s=main&t=AgenC+%C2%B7+Task+Room&d=A+live+room+where+autonomous+agents+discover+open+work%2C+bid+for+it%2C+and+settle+on-chain%3A+the+labor+market+up+close.&p=%2Fagenc%2Froom"},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://three.ws/"},{"@type":"ListItem","position":2,"name":"Agenc","item":"https://three.ws/agenc"},{"@type":"ListItem","position":3,"name":"Room","item":"https://three.ws/agenc/room"}]}]}</script></head><body>- <div class="bar">+ <header class="bar"><h1 data-i18n="agenc_room.agenc_task_room">AgenC task room</h1><span class="muted" data-i18n-html="agenc_room.on_chain_task_feed_agenc_tech">on-chain task feed · <a href="https://agenc.tech" target="_blank" rel="noopener">agenc.tech</a></span>- <span style="flex: 1"></span>- <input id="creator" type="text" placeholder="creator wallet (base58)" />- <select id="cluster">- <option value="devnet" selected data-i18n="agenc_room.devnet">devnet</option>- <option value="mainnet" data-i18n="agenc_room.mainnet">mainnet</option>- </select>- <button id="loadBtn" data-i18n="agenc_room.load">Load</button>- </div>-- <div id="room" class="room">- <div class="empty">- Paste a creator wallet to render every task they've posted on AgenC as- an embodied avatar. Try a wallet from your <code>agenc-task-roundtrip</code> example.+ <nav class="bar-nav" aria-label="Related AgenC pages" data-i18n-attr="aria-label:agenc_room.nav_aria">+ <a href="/agenc/embodied" data-i18n="agenc_room.nav_embodied">embodied demo</a>+ <a href="/docs/agenc" data-i18n="agenc_room.nav_docs">docs</a>+ <a href="/agora" data-i18n="agenc_room.nav_commons">the Commons</a>+ </nav>+ <form id="query" class="query">+ <label class="vh" for="creator" data-i18n="agenc_room.creator_label">Creator wallet, base58</label>+ <input+ id="creator"+ name="creator"+ type="text"+ placeholder="creator wallet (base58)"+ autocomplete="off"+ autocapitalize="off"+ spellcheck="false"+ data-i18n-attr="placeholder:agenc_room.creator_placeholder"+ />+ <label class="vh" for="cluster" data-i18n="agenc_room.cluster_label">Solana cluster</label>+ <select id="cluster" name="cluster">+ <option value="devnet" selected data-i18n="agenc_room.devnet">devnet</option>+ <option value="mainnet" data-i18n="agenc_room.mainnet">mainnet</option>+ </select>+ <button id="loadBtn" type="submit" data-i18n="agenc_room.load">Load</button>+ </form>+ </header>++ <p id="status" class="status" role="status" aria-live="polite"></p>++ <main id="room" class="room" aria-busy="false">+ <div class="notice">+ <h2 data-i18n="agenc_room.idle_title">Watch a creator's tasks come alive</h2>+ <p data-i18n="agenc_room.idle_body">+ Paste a creator wallet to render every task it has posted on AgenC as an+ embodied avatar, each one animated by its live on-chain state.+ </p>+ <div class="actions">+ <a href="/docs/agenc" data-i18n="agenc_room.idle_docs">How to post a task</a>+ <a href="/agora" data-i18n="agenc_room.idle_commons">See the Commons working</a>+ </div></div>- </div>+ </main><script type="module" src="/agenc/embed.js"></script><script type="module">@@ -213,9 +395,10 @@const AVATARS = ['/avatars/default.glb', '/avatars/cz.glb'];const $ = (id) => document.getElementById(id);const room = $('room');+ const statusEl = $('status');const creatorInput = $('creator');const clusterSel = $('cluster');- const loadBtn = $('loadBtn');+ const form = $('query');const params = new URLSearchParams(location.search);if (params.get('creator')) creatorInput.value = params.get('creator');@@ -223,7 +406,16 @@let pollTimer = null;let currentRequest = 0;- const cards = new Map(); // taskId hex -> { el, state }+ let active = null; // { creator, cluster } currently being polled+ const cards = new Map(); // taskId hex -> card element++ // Runtime-built copy is annotated exactly like the static markup, then+ // handed to the i18n runtime so a non-English visitor gets the same+ // treatment on states that only exist after a fetch.+ function localize(node) {+ window.threewsI18n?.apply?.(node);+ return node;+ }function avatarFor(taskId) {let h = 0;@@ -237,31 +429,146 @@return (n / 1_000_000_000).toFixed(4) + ' SOL';}- function buildCard(task, cluster, taskPda) {+ function rewardLabel(task) {+ return task.rewardMint ? String(task.rewardAmount) : fmtSol(task.rewardAmount);+ }++ function workersLabel(task) {+ const zk = task.private ? ' · private (zk)' : '';+ return `${task.currentWorkers}/${task.maxWorkers}${zk}`;+ }++ function deadlineLabel(task) {+ if (!task.deadline) return 'none set';+ return new Date(task.deadline * 1000).toLocaleString();+ }++ function explorerUrl(pda, cluster) {+ const q = cluster === 'devnet' ? '?cluster=devnet' : '';+ return `https://explorer.solana.com/address/${pda}${q}`;+ }++ function row(parent, label, field, value) {const el = document.createElement('div');+ el.className = 'row';+ const k = document.createElement('span');+ k.textContent = label;+ const v = document.createElement('span');+ v.className = 'val';+ v.dataset.field = field;+ v.textContent = value;+ el.append(k, v);+ parent.appendChild(el);+ return el;+ }++ function describe(task) {+ return `AgenC task ${task.taskId.slice(0, 10)}, state ${task.state}`;+ }++ // Every card body is a live WebGL viewer that also polls its own task, so a+ // wallet with a dozen tasks would otherwise run a dozen renderers and a+ // dozen pollers at once, most of them for cards nobody is looking at. A+ // browser also only keeps a handful of WebGL contexts alive before it+ // starts dropping the oldest, silently. So: mount an avatar when its card+ // nears the viewport, drop it when it leaves, and never exceed the budget.+ const MAX_LIVE_AVATARS = 8;+ const nearViewport = new Set(); // .body elements the visitor can nearly see+ const liveAvatars = new Set(); // .body elements holding a mounted viewer++ function mountAvatar(body) {+ if (liveAvatars.has(body)) return;+ liveAvatars.add(body);+ const agent = document.createElement('three-ws-agent');+ agent.setAttribute('src', body.dataset.avatar);+ if (body.dataset.taskPda) agent.setAttribute('agenc-task', body.dataset.taskPda);+ agent.setAttribute('agenc-cluster', body.dataset.cluster);+ agent.setAttribute('agenc-bridge', '/api/agenc');+ agent.setAttribute('agenc-poll-ms', String(POLL_MS));+ agent.setAttribute('role', 'img');+ agent.setAttribute('aria-label', body.dataset.label);+ body.prepend(agent);+ }++ function unmountAvatar(body) {+ liveAvatars.delete(body);+ // Removing the element runs its disconnectedCallback, which stops that+ // card's own task poll along with the renderer.+ body.querySelector('three-ws-agent')?.remove();+ }++ // Wiping the room detaches every card at once, so drop the bookkeeping with+ // it rather than letting detached bodies hold slots in the budget.+ function resetAvatars() {+ for (const body of nearViewport) avatarObserver?.unobserve(body);+ nearViewport.clear();+ liveAvatars.clear();+ }++ function syncAvatars() {+ for (const body of [...liveAvatars]) {+ if (!nearViewport.has(body) || !body.isConnected) unmountAvatar(body);+ }+ for (const body of nearViewport) {+ if (liveAvatars.size >= MAX_LIVE_AVATARS) break;+ mountAvatar(body);+ }+ }++ const avatarObserver =+ 'IntersectionObserver' in window+ ? new IntersectionObserver(+ (entries) => {+ for (const entry of entries) {+ if (entry.isIntersecting) nearViewport.add(entry.target);+ else nearViewport.delete(entry.target);+ }+ syncAvatars();+ },+ { rootMargin: '200px' },+ )+ : null;++ function buildCard(task, cluster) {+ const el = document.createElement('article');el.className = 'task';el.dataset.state = task.state;el.dataset.taskId = task.taskId;- const reward = task.rewardMint ? `${task.rewardAmount}` : fmtSol(task.rewardAmount);- const pda = taskPda || '';- el.innerHTML = `- <div class="body">- <three-ws-agent- src="${avatarFor(task.taskId)}"- ${pda ? `agenc-task="${pda}"` : ''}- agenc-cluster="${cluster}"- agenc-bridge="/api/agenc"- agenc-poll-ms="8000"- ></three-ws-agent>- <div class="state-tag">${task.state}</div>- </div>- <div class="meta">- <div><strong>${task.taskId.slice(0, 10)}…</strong></div>- <div>reward · ${reward}</div>- <div>workers · ${task.currentWorkers}/${task.maxWorkers}${task.private ? ' · private (zk)' : ''}</div>- <div>deadline · ${task.deadline ? new Date(task.deadline * 1000).toLocaleString() : '—'}</div>- </div>- `;++ const body = document.createElement('div');+ body.className = 'body';+ body.dataset.avatar = avatarFor(task.taskId);+ body.dataset.cluster = cluster;+ body.dataset.label = describe(task);+ if (task.taskPda) body.dataset.taskPda = task.taskPda;+ const tag = document.createElement('div');+ tag.className = 'state-tag';+ tag.textContent = task.state;+ body.append(tag);+ if (avatarObserver) avatarObserver.observe(body);+ else mountAvatar(body);++ const meta = document.createElement('div');+ meta.className = 'meta';+ const id = document.createElement('div');+ id.className = 'id';+ id.textContent = task.taskId.slice(0, 10);+ id.title = task.taskId;+ meta.appendChild(id);+ row(meta, 'reward', 'reward', rewardLabel(task));+ row(meta, 'workers', 'workers', workersLabel(task));+ row(meta, 'deadline', 'deadline', deadlineLabel(task));+ if (task.taskPda) {+ const link = document.createElement('a');+ link.className = 'explorer';+ link.href = explorerUrl(task.taskPda, cluster);+ link.target = '_blank';+ link.rel = 'noopener';+ link.textContent = 'view account on Solana Explorer';+ meta.appendChild(link);+ }++ el.append(body, meta);return el;}@@ -269,88 +576,269 @@if (card.dataset.state !== task.state) {card.dataset.state = task.state;card.querySelector('.state-tag').textContent = task.state;+ const label = describe(task);+ card.querySelector('.body').dataset.label = label;+ card.querySelector('three-ws-agent')?.setAttribute('aria-label', label);+ }+ const set = (field, value) => {+ const el = card.querySelector(`[data-field="${field}"]`);+ if (el && el.textContent !== value) el.textContent = value;+ };+ set('reward', rewardLabel(task));+ set('workers', workersLabel(task));+ set('deadline', deadlineLabel(task));+ }++ // One renderer for every non-populated state, so empty, error and idle all+ // arrive designed and with something to do next.+ function notice({ tone, titleKey, title, bodyKey, body, actions = [] }) {+ const el = document.createElement('div');+ el.className = tone === 'error' ? 'notice error' : 'notice';+ if (tone === 'error') el.setAttribute('role', 'alert');+ const h = document.createElement('h2');+ if (titleKey) h.dataset.i18n = titleKey;+ h.textContent = title;+ const p = document.createElement('p');+ if (bodyKey) p.dataset.i18n = bodyKey;+ p.textContent = body;+ el.append(h, p);+ if (actions.length) {+ const bar = document.createElement('div');+ bar.className = 'actions';+ for (const a of actions) {+ if (a.href) {+ const link = document.createElement('a');+ link.href = a.href;+ if (a.key) link.dataset.i18n = a.key;+ link.textContent = a.label;+ bar.appendChild(link);+ } else {+ const btn = document.createElement('button');+ btn.type = 'button';+ if (a.key) btn.dataset.i18n = a.key;+ btn.textContent = a.label;+ btn.addEventListener('click', a.onClick);+ bar.appendChild(btn);+ }+ }+ el.appendChild(bar);+ }+ return localize(el);+ }++ function showNotice(config) {+ cards.clear();+ resetAvatars();+ room.replaceChildren(notice(config));+ }++ function showSkeleton() {+ room.setAttribute('aria-busy', 'true');+ resetAvatars();+ const frag = document.createDocumentFragment();+ for (let i = 0; i < 6; i++) {+ const el = document.createElement('div');+ el.className = 'task skeleton';+ el.setAttribute('aria-hidden', 'true');+ const body = document.createElement('div');+ body.className = 'body';+ const meta = document.createElement('div');+ meta.className = 'meta';+ for (const cls of ['line', 'line', 'line short']) {+ const line = document.createElement('div');+ line.className = cls;+ meta.appendChild(line);+ }+ el.append(body, meta);+ frag.appendChild(el);+ }+ room.replaceChildren(frag);+ }++ function retryAction() {+ return { key: 'agenc_room.retry', label: 'Retry', onClick: () => start() };+ }++ function docsAction() {+ return { key: 'agenc_room.idle_docs', label: 'How to post a task', href: '/docs/agenc' };+ }++ // The bridge answers errors as JSON ({error, error_description}); anything+ // else (a proxy page, an empty body) still has to read as a sentence.+ async function readError(response) {+ const text = await response.text().catch(() => '');+ try {+ const parsed = JSON.parse(text);+ return parsed.error_description || parsed.message || parsed.error || text;+ } catch {+ return text.trim();}- const meta = card.querySelector('.meta');- const reward = task.rewardMint ? `${task.rewardAmount}` : fmtSol(task.rewardAmount);- meta.children[1].textContent = `reward · ${reward}`;- meta.children[2].textContent = `workers · ${task.currentWorkers}/${task.maxWorkers}${task.private ? ' · private (zk)' : ''}`;+ }++ function scheduleNext(requestId, delayMs) {+ clearTimeout(pollTimer);+ if (requestId !== currentRequest || !active) return;+ if (document.hidden) return; // resumed by the visibilitychange handler+ pollTimer = setTimeout(() => {+ loadTasks(active.creator, active.cluster, requestId);+ }, delayMs);}async function loadTasks(creator, cluster, requestId) {+ let retryMs = POLL_MS;try {const r = await fetch(`/api/agenc/list-tasks?creator=${encodeURIComponent(creator)}&cluster=${cluster}`,);if (requestId !== currentRequest) return;if (!r.ok) {- const text = await r.text();- room.innerHTML = `<div class="empty">error: ${text.slice(0, 200)}</div>`;+ const detail = await readError(r);+ room.setAttribute('aria-busy', 'false');+ // A 4xx is the caller's to fix, so stop the poll and say what to+ // change. A 5xx (or the bridge's own 503 when every Solana RPC lane+ // is cooling) clears itself, so keep polling and say so.+ if (r.status >= 400 && r.status < 500) {+ active = null;+ setStatus('');+ showNotice({+ tone: 'error',+ titleKey: 'agenc_room.err_request_title',+ title: 'That request could not be read',+ body: detail || `The bridge answered ${r.status}.`,+ actions: [retryAction(), docsAction()],+ });+ return;+ }+ const retryAfter = Number(r.headers.get('retry-after'));+ retryMs = Number.isFinite(retryAfter) && retryAfter > 0 ? retryAfter * 1000 : 15000;+ showNotice({+ tone: 'error',+ titleKey: 'agenc_room.err_upstream_title',+ title: 'Solana is not answering right now',+ body: detail || `The bridge answered ${r.status}.`,+ actions: [retryAction(), docsAction()],+ });+ setStatus(`retrying in ${Math.round(retryMs / 1000)}s`);return;}const payload = await r.json();+ room.setAttribute('aria-busy', 'false');if (!payload.ok || !payload.tasks?.length) {- room.innerHTML = `<div class="empty">no tasks found for <code>${creator.slice(0, 12)}…</code> on ${cluster}.</div>`;- cards.clear();+ showNotice({+ titleKey: 'agenc_room.empty_title',+ title: 'No tasks from this wallet yet',+ body: `${creator.slice(0, 12)} has posted nothing on ${cluster}. Check the other cluster, or post a task and watch it appear here.`,+ actions: [+ {+ key: 'agenc_room.switch_cluster',+ label: cluster === 'devnet' ? 'Try mainnet' : 'Try devnet',+ onClick: () => {+ clusterSel.value = cluster === 'devnet' ? 'mainnet' : 'devnet';+ start();+ },+ },+ docsAction(),+ ],+ });+ setStatus(`0 tasks · ${cluster} · rechecking every ${POLL_MS / 1000}s`);return;}+ if (room.querySelector('.notice, .skeleton')) {+ room.replaceChildren();+ cards.clear();+ resetAvatars();+ }const seen = new Set();for (const task of payload.tasks) {seen.add(task.taskId);const existing = cards.get(task.taskId);if (existing) {- updateCard(existing.el, task);+ updateCard(existing, task);} else {- const el = buildCard(task, cluster, task.taskPda);+ const el = buildCard(task, cluster);room.appendChild(el);- cards.set(task.taskId, { el });+ cards.set(task.taskId, el);}}- // Remove cards that are no longer in the response (rare — cancelled+ // Remove cards that are no longer in the response (rare: cancelled// tasks usually stay in the list with state=Cancelled).- for (const [taskId, entry] of cards) {+ for (const [taskId, el] of cards) {if (!seen.has(taskId)) {- entry.el.remove();+ const body = el.querySelector('.body');+ if (body) {+ avatarObserver?.unobserve(body);+ nearViewport.delete(body);+ liveAvatars.delete(body);+ }+ el.remove();cards.delete(taskId);}}- if (room.querySelector('.empty')) {- room.querySelector('.empty').remove();- }+ const stamp = new Date(payload.fetchedAt || Date.now()).toLocaleTimeString();+ setStatus(`${payload.tasks.length} tasks · ${cluster} · updated ${stamp}`);} catch (err) {- if (requestId === currentRequest) {- room.innerHTML = `<div class="empty">network error: ${err.message}</div>`;- }+ if (requestId !== currentRequest) return;+ room.setAttribute('aria-busy', 'false');+ retryMs = 15000;+ showNotice({+ tone: 'error',+ titleKey: 'agenc_room.err_network_title',+ title: 'Could not reach the task bridge',+ body: `${err.message}. The room keeps trying, or retry now.`,+ actions: [retryAction(), docsAction()],+ });+ setStatus('retrying in 15s');} finally {- if (requestId === currentRequest) {- pollTimer = setTimeout(() => loadTasks(creator, cluster, requestId), POLL_MS);- }+ scheduleNext(requestId, retryMs);}}+ function setStatus(text) {+ statusEl.textContent = text;+ }+function start() {const creator = creatorInput.value.trim();const cluster = clusterSel.value;clearTimeout(pollTimer);cards.clear();- room.innerHTML = '';currentRequest += 1;if (!creator) {- room.innerHTML =- '<div class="empty">Paste a creator wallet to render its tasks as a 3D scene.</div>';+ active = null;+ setStatus('');+ room.setAttribute('aria-busy', 'false');+ showNotice({+ titleKey: 'agenc_room.idle_title',+ title: "Watch a creator's tasks come alive",+ body: 'Paste a creator wallet to render every task it has posted on AgenC as an embodied avatar, each one animated by its live on-chain state.',+ actions: [docsAction(), { key: 'agenc_room.idle_commons', label: 'See the Commons working', href: '/agora' }],+ });+ creatorInput.focus();return;}+ active = { creator, cluster };const url = new URL(location.href);url.searchParams.set('creator', creator);url.searchParams.set('cluster', cluster);history.replaceState(null, '', url.toString());- room.innerHTML = '<div class="empty">loading…</div>';+ setStatus(`loading tasks on ${cluster}…`);+ showSkeleton();loadTasks(creator, cluster, currentRequest);}- loadBtn.addEventListener('click', start);- creatorInput.addEventListener('keydown', (e) => {- if (e.key === 'Enter') start();+ form.addEventListener('submit', (e) => {+ e.preventDefault();+ start();+ });+ // A poll running against a hidden tab burns RPC for nobody; pick it back up+ // the moment the visitor returns.+ document.addEventListener('visibilitychange', () => {+ if (document.hidden) {+ clearTimeout(pollTimer);+ } else if (active) {+ loadTasks(active.creator, active.cluster, currentRequest);+ }});if (creatorInput.value) start();</script>diff --git a/pages/agent-economy-volume.html b/pages/agent-economy-volume.htmlindex 74982b1f0..89424ecce 100644--- a/pages/agent-economy-volume.html+++ b/pages/agent-economy-volume.html@@ -41,8 +41,12 @@--line: rgba(255,255,255,0.07);--line-2: rgba(255,255,255,0.12);--text: #e7e9ee;- --muted: rgba(231,233,238,0.55);- --dim: rgba(231,233,238,0.35);+ /* Both tints are read at 11px to 13px, so they carry the WCAG AA 4.5:1+ floor against every surface here (--bg, --bg-2, --card). The old+ --dim landed at 2.86:1 on a card, which axe flags as a serious+ contrast failure on the stat sub-labels and the footnote. */+ --muted: rgba(231,233,238,0.66);+ --dim: rgba(231,233,238,0.52);--green: #4ade80;--amber: #f5a524;--violet: #a78bfa;@@ -52,7 +56,10 @@--skeleton-sheen: rgba(255,255,255,0.08);}[data-theme="light"]{- --bg:#f5f5f5;--bg-2:#fff;--card:#fff;--line:rgba(0,0,0,.07);--line-2:rgba(0,0,0,.12);--text:#111;--muted:rgba(0,0,0,.55);--dim:rgba(0,0,0,.35);--skeleton-base:rgba(0,0,0,.04);--skeleton-sheen:rgba(0,0,0,.08);+ /* --cyan is a link colour here, and the dark-mode value reads 1.91:1 on+ white: unreadable in light mode. The darker sibling clears AA for+ text and still passes 3:1 as a focus ring. */+ --bg:#f5f5f5;--bg-2:#fff;--card:#fff;--line:rgba(0,0,0,.07);--line-2:rgba(0,0,0,.12);--text:#111;--muted:rgba(0,0,0,.68);--dim:rgba(0,0,0,.57);--cyan:#0369a1;--skeleton-base:rgba(0,0,0,.04);--skeleton-sheen:rgba(0,0,0,.08);}*{box-sizing:border-box;margin:0;padding:0;}html,body{background:var(--bg);color:var(--text);font-family:'Inter',system-ui,sans-serif;min-height:100vh;}@@ -95,8 +102,11 @@.chart-wrap{background:var(--card);border:1px solid var(--line-2);border-radius:var(--radius);padding:20px;position:relative;}.chart-canvas{width:100%;height:240px;display:block;}.chart-empty{height:240px;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:8px;color:var(--muted);font-size:13px;text-align:center;padding:0 12px;}- .chart-empty a{color:var(--cyan);border-bottom:1px solid transparent;}- .chart-empty a:hover{border-color:var(--cyan);}+ /* A standing underline, not a hover-only one: inside a sentence of muted+ copy the cyan alone is a ~1.9:1 difference from the text around it, so+ colour is the only thing marking the link and WCAG 1.4.1 fails. */+ .chart-empty a{color:var(--cyan);border-bottom:1px solid currentColor;}+ .chart-empty a:hover{color:var(--text);}.chart-skeleton{height:240px;border-radius:8px;}.chart-tip{position:absolute;pointer-events:none;opacity:0;transform:translate(-50%,-100%);background:var(--bg-2);border:1px solid var(--line-2);border-radius:8px;padding:7px 10px;font-size:12px;line-height:1.4;white-space:nowrap;box-shadow:0 8px 22px rgba(0,0,0,.35);transition:opacity .12s ease;z-index:2;}.chart-tip[data-open="1"]{opacity:1;}@@ -130,8 +140,8 @@.feed-skill{color:var(--muted);}.feed-amt{font-size:13px;font-weight:700;font-variant-numeric:tabular-nums;white-space:nowrap;}.feed-time{font-size:11px;color:var(--dim);white-space:nowrap;}- .feed-link{font-size:11px;color:var(--cyan);white-space:nowrap;}- .feed-link:hover{text-decoration:underline;}+ .feed-link{font-size:11px;color:var(--cyan);white-space:nowrap;text-decoration:underline;text-underline-offset:2px;}+ .feed-link:hover{color:var(--text);}/* Skeleton */.skeleton{background:var(--skeleton-base);background-image:linear-gradient(90deg,var(--skeleton-base) 0%,var(--skeleton-sheen) 50%,var(--skeleton-base) 100%);background-size:200% 100%;border-radius:6px;animation:shimmer 1.4s ease-in-out infinite;}@keyframes shimmer{0%{background-position:200% 0;}100%{background-position:-200% 0;}}@@ -141,13 +151,16 @@.skeleton-headline{display:inline-block;width:190px;max-width:60vw;height:44px;border-radius:10px;vertical-align:middle;}/* Empty / error */.an-empty{color:var(--muted);font-size:13px;padding:18px 0;line-height:1.55;}- .an-empty a{color:var(--cyan);border-bottom:1px solid transparent;}- .an-empty a:hover{border-color:var(--cyan);}+ .an-empty a{color:var(--cyan);border-bottom:1px solid currentColor;}+ .an-empty a:hover{color:var(--text);}.an-error{background:rgba(239,68,68,.08);border:1px solid rgba(239,68,68,.25);border-radius:10px;padding:16px 20px;color:#ef4444;font-size:13px;margin-bottom:24px;display:flex;align-items:center;justify-content:space-between;gap:16px;}- .an-error button{appearance:none;background:#ef4444;color:#fff;border:none;border-radius:8px;padding:7px 14px;font:inherit;font-size:12px;font-weight:600;cursor:pointer;transition:background .15s,transform .1s;}- .an-error button:hover{background:#dc2626;}+ /* #ef4444 under white 12px text is 3.76:1, short of the AA floor for the+ one control that recovers this page from a failed load. */+ .an-error button{appearance:none;background:#dc2626;color:#fff;border:none;border-radius:8px;padding:7px 14px;font:inherit;font-size:12px;font-weight:600;cursor:pointer;transition:background .15s,transform .1s;}+ .an-error button:hover{background:#b91c1c;}.an-error button:active{transform:translateY(1px);}.an-error button[disabled]{opacity:.6;cursor:progress;}+ [data-theme="light"] .an-error{color:#b91c1c;}.foot-note{color:var(--dim);font-size:12px;margin-top:8px;line-height:1.5;}.foot-note a{color:var(--muted);border-bottom:1px solid var(--line-2);}.foot-note a:hover{color:var(--text);border-color:var(--text);}diff --git a/pages/agent-economy.html b/pages/agent-economy.htmlindex 5e9920c4b..8e7e82cd8 100644--- a/pages/agent-economy.html+++ b/pages/agent-economy.html@@ -452,11 +452,13 @@}#fund-alert.visible { display: block; }- /* The two "Add funds" buttons the page injects at runtime: one in the fund- banner, one in the feed's insufficient-balance row. Both shipped with no- styles at all, so they rendered as default OS buttons on a black panel. */+ /* The buttons the page injects at runtime: "Add funds" in the fund banner+ and in the feed's insufficient-balance row, "Retry" in the wallet-status+ notice, "Try again" on a failed request. They shipped with no styles at+ all, so they rendered as default OS buttons on a black panel. */.fund-alert-btn,- .tx-add-funds-btn {+ .tx-add-funds-btn,+ .tx-retry-btn {display: inline-flex;align-items: center;gap: 4px;@@ -473,9 +475,11 @@transition: background .15s, border-color .15s, transform .1s;}.fund-alert-btn:hover,- .tx-add-funds-btn:hover { background: rgba(247,160,53,.22); border-color: rgba(247,160,53,.7); }+ .tx-add-funds-btn:hover,+ .tx-retry-btn:hover { background: rgba(247,160,53,.22); border-color: rgba(247,160,53,.7); }.fund-alert-btn:active,- .tx-add-funds-btn:active { transform: translateY(1px); }+ .tx-add-funds-btn:active,+ .tx-retry-btn:active { transform: translateY(1px); }/* Responsive.Both agents stay on screen on narrow viewports. Hiding the buyer used to@@ -484,19 +488,37 @@display:none column measures zero, so the payment flew out of the cornerof the screen instead of between the agents. */@media (max-width: 700px) {- #root { grid-template-columns: 1fr 1fr; grid-template-rows: 38vh 1fr auto; }+ #root { grid-template-columns: 1fr 1fr; grid-template-rows: 38vh minmax(0, 1fr) auto; }#col-buyer { grid-column: 1; grid-row: 1; }#col-seller { grid-column: 2; grid-row: 1; border-left: 1px solid var(--border); }#center { grid-column: 1 / -1; grid-row: 2; border-left: none; border-right: none; border-top: 1px solid var(--border); }#bottom-bar { grid-row: 3; }+ /* The center column is taller than its row once the catalog, the fund+ banner and the topic field stack up, and it used to clip the overflow:+ at 320px the transaction feed and the status bar (the entire output of+ this page) were cut off with no way to scroll to them. Scroll the+ column instead, and keep the feed a readable height inside it. */+ #center { overflow-y: auto; overscroll-behavior: contain; }+ #feed { flex: 1 0 auto; min-height: 140px; overflow-y: visible; }+ #status-bar { position: sticky; bottom: 0; background: var(--bg); }+/* Half-width columns cannot hold the desktop chrome: let the label wrapand drop the bubble's desktop min-width so neither is clipped. */.av-label { padding: 6px 9px; bottom: 10px; white-space: normal; max-width: calc(100% - 12px); }.av-label-name { font-size: 12px; }.av-label-addr { word-break: break-all; }.av-speech { min-width: 0; max-width: calc(100% - 16px); top: 10px; padding: 8px 10px; font-size: 11px; }- #bottom-bar { flex-wrap: wrap; gap: 8px; row-gap: 4px; padding: 8px 12px; }+ /* The floating language switcher is fixed to the bottom-right corner and+ sat directly on top of these links. Reserve its height so every footer+ link stays clickable. */+ #bottom-bar { flex-wrap: wrap; gap: 8px; row-gap: 4px; padding: 8px 12px 54px; }+ }++ /* Phone widths: 38vh of avatars leaves the catalog and feed fighting over+ what's left, so give the agents a little less room. */+ @media (max-width: 480px) {+ #root { grid-template-rows: 30vh minmax(0, 1fr) auto; }}/* Noscript */diff --git a/pages/agent-exchange.html b/pages/agent-exchange.htmlindex 3c1a10caf..a252dc2c1 100644--- a/pages/agent-exchange.html+++ b/pages/agent-exchange.html@@ -308,6 +308,17 @@#walletState.ws-low .ws-head { color:var(--amber); }.ws-body { color:var(--muted); line-height:1.55; }.ws-mono { font-family:var(--mono); font-size:10.5px; }+ /* Re-probe the balance in place: a wallet funded while the page is open+ recovers without a reload, so the state is actionable, not a dead end. */+ .ws-recheck {+ display:inline-flex; align-items:center; margin-left:2px; padding:3px 10px;+ border-radius:8px; border:1px solid var(--border-hi); background:rgba(255,255,255,0.05);+ color:var(--text); font:12px/1 inherit; font-weight:600; cursor:pointer;+ transition:background .15s, border-color .15s;+ }+ .ws-recheck:hover:not(:disabled) { background:rgba(255,255,255,0.1); border-color:var(--sol-lt); }+ .ws-recheck:active:not(:disabled) { transform:translateY(1px); }+ .ws-recheck:disabled { opacity:.55; cursor:default; }</style><meta property="og:site_name" content="three.ws">@@ -351,12 +362,16 @@<section id="arena" aria-label="Two AI agents"><div class="agents"><!-- Agent A: Seller (left, faces right) -->+ <!-- tabindex=-1: the avatars are driven entirely by postMessage from this+ page and hold nothing to operate, so leaving them in the tab order+ added two focus stops that do nothing and show no focus ring. The+ agent names and roles are already in the labels below. --><div class="agent-slot" id="slotA">- <iframe id="frameA" title="Intel agent" allow="autoplay" aria-label="Selling agent"></iframe>+ <iframe id="frameA" title="Intel agent" allow="autoplay" aria-label="Selling agent" tabindex="-1"></iframe></div><!-- Agent B: Buyer (right, faces left) --><div class="agent-slot" id="slotB">- <iframe id="frameB" title="Buyer agent" allow="autoplay" aria-label="Buying agent"></iframe>+ <iframe id="frameB" title="Buyer agent" allow="autoplay" aria-label="Buying agent" tabindex="-1"></iframe></div></div>diff --git a/pages/agent-screen.html b/pages/agent-screen.htmlindex b3a8f920d..64af1b56d 100644--- a/pages/agent-screen.html+++ b/pages/agent-screen.html@@ -6,7 +6,7 @@<title data-i18n="agent_screen.meta_title">Agent Screen · three.ws</title><meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="theme-color" content="#0a0a0b" />- <meta name="description" content="Watch your agent in real time — see their screen and avatar as they autonomously trade, browse, and act." data-i18n-attr="content:agent_screen.meta_description"/>+ <meta name="description" content="Watch your agent work in real time: their live screen on one side, their 3D avatar rendered as a webcam on the other, while they trade, browse, and act." data-i18n-attr="content:agent_screen.meta_description"/><meta name="robots" content="noindex" /><link rel="canonical" href="https://three.ws/agent-screen" />@@ -178,12 +178,39 @@}body.asc-zen .asc-pnl { display: none; }+ /* The skip link resolves here and the landmark is the flex child that+ owns the remaining height; the stage and the setup view swap inside+ it, one visible at a time, each still stretching to fill. */+ .asc-main {+ flex: 1;+ min-height: 0;+ display: flex;+ flex-direction: column;+ }+.asc-header-right {margin-left: auto;display: flex;align-items: center;gap: 0.3rem;- }+ /* Eighteen controls do not fit a phone. body is overflow:hidden, so+ without this the tail of the bar (fit, screenshot, PiP, fullscreen,+ ambient, zen, wall, agent) was simply cut off and unreachable+ below ~900px. Shrink-to-fit and scroll the excess instead: every+ control stays reachable by swipe, and tabbing to one scrolls it+ into view. */+ min-width: 0;+ overflow-x: auto;+ overflow-y: hidden;+ scrollbar-width: none;+ -webkit-overflow-scrolling: touch;+ overscroll-behavior-x: contain;+ }+ .asc-header-right::-webkit-scrollbar { width: 0; height: 0; }+ .asc-header-right > * { flex: none; }+ /* The name + live badge must yield to the control bar rather than+ overrun it: at 320px the badge used to paint on top of the toggles. */+ .asc-agent-info { flex: 0 1 auto; overflow: hidden; }.asc-ctl-group { display: flex; align-items: center; gap: 0.2rem; }.asc-ctl-sep { width: 1px; height: 20px; background: rgba(255,255,255,0.12); margin: 0 0.25rem; flex: none; }@@ -1295,6 +1322,15 @@.ws-agent-uuid { font-size: 0.7rem; color: rgba(255,255,255,0.3); font-family: monospace; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }.ws-agent-empty { color: rgba(255,255,255,0.35); font-size: 0.85rem; padding: 1rem 0; text-align: center; }.ws-agent-empty a { color: #d4d4d8; }+ /* The agent list failed to load for a reason that is not "signed out":+ say so and offer the way out instead of a blank list. */+ .ws-agent-error {+ display: flex;+ flex-direction: column;+ align-items: center;+ gap: 0.7rem;+ color: rgba(255,255,255,0.72);+ }.ws-key-row { display: flex; gap: 0.65rem; align-items: center; }.ws-key-display {flex: 1; background: rgba(0,0,0,0.3); border: 1px solid rgba(255,255,255,0.1); border-radius: 8px;@@ -2289,13 +2325,15 @@</div></header>- <div class="asc-stage" id="asc-stage" style="display:none">- <!-- populated by agent-screen.js -->- </div>+ <main class="asc-main" id="main-content">+ <div class="asc-stage" id="asc-stage" style="display:none">+ <!-- populated by agent-screen.js -->+ </div>- <div id="asc-no-agent" class="asc-no-agent" style="display:flex">- <div class="ws-spinner"></div>- </div>+ <div id="asc-no-agent" class="asc-no-agent" style="display:flex">+ <div class="ws-spinner"></div>+ </div>+ </main><div class="asc-toast-wrap" id="asc-toast-wrap"></div>diff --git a/pages/aws/index.html b/pages/aws/index.htmlindex 875a766fb..bf18eeaef 100644--- a/pages/aws/index.html+++ b/pages/aws/index.html@@ -254,8 +254,8 @@<div class="desc">Links an AWS Marketplace subscription to an authenticated three.ws account after the post-subscribe redirect.</div></div><div class="endpoint">- <code>BatchMeterUsage + GetEntitlements</code>- <div class="desc">Daily metering and contract entitlement checks via the AWS Marketplace Metering and Entitlement Service SDKs.</div>+ <code>MeterUsage + GetEntitlements</code>+ <div class="desc">Per-call usage reporting (deduplicated per second) and contract entitlement checks via the AWS Marketplace Metering and Entitlement Service SDKs.</div></div></div>diff --git a/pages/guards.html b/pages/guards.htmlindex f6cde7f48..c84b5d40a 100644--- a/pages/guards.html+++ b/pages/guards.html@@ -555,9 +555,12 @@<section class="gd-more"><h2>Adding a guard</h2><p>- A guard that is not wired into an unavoidable path protects nothing. Write the checker, give it an npm- script, register it in <code>data/guards.json</code>, and wire it into a stage. Running- <code>npm run audit:guards</code> will tell you if the last two steps disagree.+ A guard that is not wired into an unavoidable path protects nothing, and a guard nobody has proven+ still catches anything protects nothing either. Write the checker, give it an npm script, register it+ in <code>data/guards.json</code> with the violation it must reject, and wire it into a stage.+ <code>npm run audit:guards</code> tells you if the registry and the chains disagree;+ <code>npm run prove:guards</code> runs each guard against its declared violation and tells you whether+ it still fires.</p><div class="gd-links"><a href="/docs/tutorials/write-a-guard">Write a guard</a>diff --git a/prompts/swarm-100/api-platform-01.md b/prompts/swarm-100/api-platform-01.mddeleted file mode 100644index a7990cfc3..000000000--- a/prompts/swarm-100/api-platform-01.md+++ /dev/null@@ -1,101 +0,0 @@-# API audit: api/platform batch 01 (1 files)--How to run: paste this file's repo path into a fresh Claude Code chat in this-repository and say "run this work order". This file is fully self-contained:-it depends on no other prompt file anywhere. If neighboring files in-prompts/swarm-100/ are gone, that work is done; if present, ignore them.-Every claim below rots; step 0 re-measures, and what you measure wins.--## Operating clause (binding)--- Read CLAUDE.md first. Its rules override everything, including this file.-- Finish 100% in this session. Never end the turn with a question, an option- list, or an unexecuted plan. A judgment call goes in one line of the final- report; it never becomes a question that halts work.-- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real- funds or any irreversible on-chain write, git push or a production deploy,- committing content that references a crypto project other than $THREE, and- destroying unrecoverable data.-- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no- commented-out code. Real APIs and real integrations only.-- The em-dash and en-dash characters are banned in everything you write.-- Concurrent agents share this worktree: stage explicit paths only (never a- bare add-everything), and commit finished work promptly.-- Before committing, run: npm run check:rules -- --paths <files you touched>.- It must exit 0.--## Step 0: re-derive the current state--1. Confirm each file below still exists; deleted ones are done, skip them.-2. For each, decide routability: grep its path in vercel.json and read how- server/index.mjs maps filesystem handlers. Routed files get an endpoint- audit; internal modules get a code and test audit.-3. Start a local server for endpoint checks: node server/index.mjs with .env- loaded, on a free PORT if 3000 is busy.--## Task: audit these api files, then fix everything found--Files in this batch:--- api/platform/stats.js--For every routed handler:--1. Exercise it with curl against the local server: the success path returns- real data with the correct status; malformed input returns a 4xx JSON- error, never a stack trace or an HTML error page; auth is enforced where- the code intends it; CORS matches neighboring handlers.-2. Hard-rule scan: no mock fallbacks, no fake-data arrays, no stubbed- responses, no unfinished markers. Errors are handled at the boundary and- internal code trusts itself.-3. Do not spend funds or sign anything on-chain while probing. Payment and- trading handlers get their validation and error paths exercised, never a- live settlement.--For every internal (non-routed) module:--4. Something must import it; if nothing does, delete it as dead code (verify- with a repo-wide grep first).-5. Its main path and one failure path must be covered in tests/; add the- missing test if not.--## Definition of done--- [ ] Every listed file has recorded evidence: a curl transcript for routed- handlers, a passing test or a deletion for internal modules.-- [ ] Zero hard-rule violations remain in these files.-- [ ] vitest run passes; npm run check:rules -- --paths <touched files>- exits 0.--## Never blocked--| Blocker | Resolution (act, do not ask) |-|---|---|-| Missing env var or credential | Check .env and .env.local, then the Cloud Run service env, then Secret Manager (the CLAUDE.md self-unblock playbook has the exact commands). If it truly exists nowhere, wire the code fully behind the env var, prove the wiring with a dry run, and name the single missing var in the report. |-| gcloud not on PATH | Run: export PATH="$HOME/google-cloud-sdk/bin:$PATH" |-| Dev server port 3000 busy | Another agent may be serving this repo; probe it and reuse if so. Otherwise start your own on a free port: npx vite --port 3101 |-| Playwright browser missing | npx playwright install chromium |-| A surface needs a signed-in user | Register a fresh account through the real /register flow against the real API and use it. Never mock the session. |-| A defect sits in code you did not touch | Fix it if it blocks a Definition of done line (root cause it, never mask it). Otherwise note it in the report and continue. |-| An unrelated test is red | Same rule. Never pipe npm test through tail; it masks exit codes. |--## Close out (required)--1. Verify every Definition of done line with the actual command output in- front of you. Never claim a line you did not verify.-2. Commit with explicit paths and a subject that describes the diff (house- style: type(scope): what changed and why a reader cares).-3. Delete this prompt file in that same commit:-- git rm prompts/swarm-100/api-platform-01.md-- The shrinking directory is this campaign's only progress ledger; there is- no progress log to update.-4. Final report: what step 0 measured, what changed (file list), evidence per- Definition of done line, and any one-line judgment calls. No trailing- questions, no unexecuted plans.--If a line genuinely cannot pass inside this session (an external party must-respond, or an owner-gated action is the final step), finish everything else,-leave this file in place, and state exactly which line remains and who owns-it. Never delete this file on a partial.diff --git a/prompts/swarm-100/api-plugins-01.md b/prompts/swarm-100/api-plugins-01.mddeleted file mode 100644index fb1343995..000000000--- a/prompts/swarm-100/api-plugins-01.md+++ /dev/null@@ -1,101 +0,0 @@-# API audit: api/plugins batch 01 (1 files)--How to run: paste this file's repo path into a fresh Claude Code chat in this-repository and say "run this work order". This file is fully self-contained:-it depends on no other prompt file anywhere. If neighboring files in-prompts/swarm-100/ are gone, that work is done; if present, ignore them.-Every claim below rots; step 0 re-measures, and what you measure wins.--## Operating clause (binding)--- Read CLAUDE.md first. Its rules override everything, including this file.-- Finish 100% in this session. Never end the turn with a question, an option- list, or an unexecuted plan. A judgment call goes in one line of the final- report; it never becomes a question that halts work.-- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real- funds or any irreversible on-chain write, git push or a production deploy,- committing content that references a crypto project other than $THREE, and- destroying unrecoverable data.-- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no- commented-out code. Real APIs and real integrations only.-- The em-dash and en-dash characters are banned in everything you write.-- Concurrent agents share this worktree: stage explicit paths only (never a- bare add-everything), and commit finished work promptly.-- Before committing, run: npm run check:rules -- --paths <files you touched>.- It must exit 0.--## Step 0: re-derive the current state--1. Confirm each file below still exists; deleted ones are done, skip them.-2. For each, decide routability: grep its path in vercel.json and read how- server/index.mjs maps filesystem handlers. Routed files get an endpoint- audit; internal modules get a code and test audit.-3. Start a local server for endpoint checks: node server/index.mjs with .env- loaded, on a free PORT if 3000 is busy.--## Task: audit these api files, then fix everything found--Files in this batch:--- api/plugins/[action].js--For every routed handler:--1. Exercise it with curl against the local server: the success path returns- real data with the correct status; malformed input returns a 4xx JSON- error, never a stack trace or an HTML error page; auth is enforced where- the code intends it; CORS matches neighboring handlers.-2. Hard-rule scan: no mock fallbacks, no fake-data arrays, no stubbed- responses, no unfinished markers. Errors are handled at the boundary and- internal code trusts itself.-3. Do not spend funds or sign anything on-chain while probing. Payment and- trading handlers get their validation and error paths exercised, never a- live settlement.--For every internal (non-routed) module:--4. Something must import it; if nothing does, delete it as dead code (verify- with a repo-wide grep first).-5. Its main path and one failure path must be covered in tests/; add the- missing test if not.--## Definition of done--- [ ] Every listed file has recorded evidence: a curl transcript for routed- handlers, a passing test or a deletion for internal modules.-- [ ] Zero hard-rule violations remain in these files.-- [ ] vitest run passes; npm run check:rules -- --paths <touched files>- exits 0.--## Never blocked--| Blocker | Resolution (act, do not ask) |-|---|---|-| Missing env var or credential | Check .env and .env.local, then the Cloud Run service env, then Secret Manager (the CLAUDE.md self-unblock playbook has the exact commands). If it truly exists nowhere, wire the code fully behind the env var, prove the wiring with a dry run, and name the single missing var in the report. |-| gcloud not on PATH | Run: export PATH="$HOME/google-cloud-sdk/bin:$PATH" |-| Dev server port 3000 busy | Another agent may be serving this repo; probe it and reuse if so. Otherwise start your own on a free port: npx vite --port 3101 |-| Playwright browser missing | npx playwright install chromium |-| A surface needs a signed-in user | Register a fresh account through the real /register flow against the real API and use it. Never mock the session. |-| A defect sits in code you did not touch | Fix it if it blocks a Definition of done line (root cause it, never mask it). Otherwise note it in the report and continue. |-| An unrelated test is red | Same rule. Never pipe npm test through tail; it masks exit codes. |--## Close out (required)--1. Verify every Definition of done line with the actual command output in- front of you. Never claim a line you did not verify.-2. Commit with explicit paths and a subject that describes the diff (house- style: type(scope): what changed and why a reader cares).-3. Delete this prompt file in that same commit:-- git rm prompts/swarm-100/api-plugins-01.md-- The shrinking directory is this campaign's only progress ledger; there is- no progress log to update.-4. Final report: what step 0 measured, what changed (file list), evidence per- Definition of done line, and any one-line judgment calls. No trailing- questions, no unexecuted plans.--If a line genuinely cannot pass inside this session (an external party must-respond, or an owner-gated action is the final step), finish everything else,-leave this file in place, and state exactly which line remains and who owns-it. Never delete this file on a partial.diff --git a/public/agenc/embed.js b/public/agenc/embed.jsindex ca3185c84..6adaaa29e 100644--- a/public/agenc/embed.js+++ b/public/agenc/embed.js@@ -17,15 +17,21 @@// agenc-poll-ms — polling interval; clamped [1500, 120000] (default 4000)// agenc-bridge — base URL of the three.ws AgenC API (default "/api/agenc")// agenc-clips — JSON map of {state: clipName} for state-driven animation,-// e.g. `{"Claimed":"working","Completed":"cheer"}`. Clips-// must exist in the GLB; missing clips are a no-op.+// e.g. `{"In Progress":"working","Completed":"cheer"}`.+// Keys are AgenC's on-chain TaskState labels verbatim (see+// STATE_COLORS below); clips must exist in the GLB, and a+// missing clip is a no-op.// show-overlay — when present, render a small state badge in the corner//// Events (CustomEvent, bubble=true):-// agenc:state — { taskPda, state, task, lifecycle } on every poll where-// the task is found. The page can hook this to drive-// additional UI without reaching into the element.-// agenc:error — { message } on transport / parse failure.+// agenc:state : { taskPda, cluster, state, task, lifecycle, programId }+// on every poll where the task is found. The page can hook+// this to drive additional UI without reaching into the+// element. `programId` is the program the read actually ran+// against, so a host page can name it without hardcoding.+// agenc:error : { message, taskPda, cluster, retryInMs } on a 404, a+// bridge error, or a transport / parse failure. Polling+// continues with backoff; `retryInMs` is when.//// The element is dependency-free apart from <model-viewer>, which is loaded// lazily from the npm CDN on first connect (the same source three.ws uses).@@ -95,12 +101,19 @@ function ensureModelViewer() {return modelViewerPromise;}+// AgenC's on-chain TaskState labels VERBATIM, as `/api/agenc/get-task` reports+// them (api/agenc/[action].js `taskStateLabel`), plus this element's own three+// transport states. The map used to key on "Claimed" and "Expired", which the+// chain has never emitted: a task in the real second state arrives as+// "In Progress" and matched nothing here, so the halo, the badge color and the+// agenc-clips switch all sat inert for the exact transition the embed exists to+// show. Keep this list and taskStateLabel in lockstep.const STATE_COLORS = {Open: '#7af0c4',- Claimed: '#f0c47a',+ 'In Progress': '#f0c47a',+ 'Pending Validation': '#8ab4f8',Completed: '#7af0c4',Cancelled: '#f07a7a',- Expired: '#f07a7a',Disputed: '#f07a7a',loading: '#8a8499',error: '#f07a7a',@@ -118,6 +131,7 @@ class ThreewsAgentElement extends HTMLElement {this._pollTimer = null;this._requestId = 0;this._lastState = null;+ this._failures = 0;}connectedCallback() {@@ -186,17 +200,24 @@ class ThreewsAgentElement extends HTMLElement {opacity: 0;transition: opacity 0.3s, background 0.3s;}- :host([data-state="Claimed"]) .pulse {+ :host([data-state="Open"]) .pulse {+ background: radial-gradient(circle at 50% 70%, #7af0c4 0%, transparent 55%);+ opacity: 0.18;+ }+ :host([data-state="In Progress"]) .pulse {background: radial-gradient(circle at 50% 70%, #f0c47a 0%, transparent 55%);opacity: 0.28;animation: pulse 2.4s ease-in-out infinite;}+ :host([data-state="Pending Validation"]) .pulse {+ background: radial-gradient(circle at 50% 70%, #8ab4f8 0%, transparent 55%);+ opacity: 0.26;+ }:host([data-state="Completed"]) .pulse {background: radial-gradient(circle at 50% 70%, #7af0c4 0%, transparent 55%);opacity: 0.36;}:host([data-state="Cancelled"]) .pulse,- :host([data-state="Expired"]) .pulse,:host([data-state="Disputed"]) .pulse {background: radial-gradient(circle at 50% 70%, #f07a7a 0%, transparent 55%);opacity: 0.24;@@ -205,6 +226,9 @@ class ThreewsAgentElement extends HTMLElement {0%, 100% { opacity: 0.16; }50% { opacity: 0.36; }}+ @media (prefers-reduced-motion: reduce) {+ :host([data-state="In Progress"]) .pulse { animation: none; }+ }.overlay {position: absolute;left: 12px;@@ -274,6 +298,7 @@ class ThreewsAgentElement extends HTMLElement {_restart() {clearTimeout(this._pollTimer);this._requestId += 1;+ this._failures = 0;const taskPda = this.getAttribute('agenc-task');if (!taskPda) {this._setState('idle');@@ -284,6 +309,22 @@ class ThreewsAgentElement extends HTMLElement {this._poll(taskPda, myReq);}+ // Back off after consecutive failures instead of re-asking at the full poll+ // rate forever. A mistyped address 404s permanently, and the flat retry made+ // that one typo a request every 4s for as long as the tab stayed open. Doubles+ // per failure, capped at a minute; a single success resets it.+ _retryDelay() {+ const base = this._pollMs();+ if (!this._failures) return base;+ return Math.min(base * 2 ** Math.min(this._failures, 4), 60000);+ }++ _fail(message) {+ this._failures += 1;+ this._setState('error');+ this._emit('agenc:error', { message, taskPda: this.getAttribute('agenc-task'), cluster: this._cluster(), retryInMs: this._retryDelay() });+ }+async _poll(taskPda, requestId) {const cluster = this._cluster();const bridge = this._bridge();@@ -292,16 +333,15 @@ class ThreewsAgentElement extends HTMLElement {const r = await fetch(url, { headers: { accept: 'application/json' } });if (requestId !== this._requestId) return;if (!r.ok && r.status !== 404) {- this._setState('error');- this._emit('agenc:error', { message: `bridge ${r.status}` });+ this._fail(`bridge ${r.status}`);return;}const payload = await r.json();if (!payload.ok || !payload.task) {- this._setState('error');- this._emit('agenc:error', { message: payload.error || 'not_found' });+ this._fail(payload.error || 'not_found');return;}+ this._failures = 0;this._setState(payload.task.state);this._emit('agenc:state', {taskPda,@@ -309,14 +349,14 @@ class ThreewsAgentElement extends HTMLElement {state: payload.task.state,task: payload.task,lifecycle: payload.lifecycle,+ programId: payload.programId ?? null,});} catch (err) {if (requestId !== this._requestId) return;- this._setState('error');- this._emit('agenc:error', { message: err.message || String(err) });+ this._fail(err.message || String(err));} finally {if (requestId === this._requestId) {- this._pollTimer = setTimeout(() => this._poll(taskPda, requestId), this._pollMs());+ this._pollTimer = setTimeout(() => this._poll(taskPda, requestId), this._retryDelay());}}}diff --git a/public/changelog.json b/public/changelog.jsonindex b4dbebef0..e84c54587 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,11 +1,109 @@{- "generated_at": "2026-08-15T01:22:33.715Z",+ "generated_at": "2026-08-15T05:46:26.707Z","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-08-15",+ "type": "update",+ "title": "A broken paid endpoint is no longer reported as a free one",+ "summary": "Payment sessions let you hand an agent a budget instead of a key, and two parts of that path judged an endpoint by one rule: if it did not ask for payment, the call was free. That is only true when the endpoint actually succeeded. A paid API answering 404, 400, or 500 was being scored as a free call, and the consequences ran in the wrong direction in both places. The dry run at /pay/simulator, whose whole job is to tell you in advance whether a budget and an allowlist will carry a workload, reported a plan as feasible at a cost of nothing when in fact every endpoint in it was erroring: free calls are never priced, never allowlist-checked, and never counted, so a wall of failures looked like a clean run. And an agent spending through a session got back a success envelope saying no payment was needed for an endpoint that had just failed on it. Both now separate the two cases: a real success with no payment challenge is still free and still costs nothing, while an error status is reported as an endpoint failure carrying the status the endpoint actually returned. No session is charged either way. The simulator lists each failing endpoint by name in its problems list and no longer calls the plan feasible.",+ "link": "/pay/simulator",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-08-15",+ "type": "update",+ "title": "A silent outage in the agent reasoning ledger now reports itself",+ "summary": "Every agent decision is committed to a hash chain, and that chain head is written to Solana on a schedule so anyone can check the history was never edited. The wallet that pays for those on-chain writes ran empty, and the scheduled job could not tell that apart from the harmless case where no signing key is set up at all: it answered a healthy 200 every ten minutes while re-sending the same doomed transaction for twelve agents in a row, and not one head reached the chain. A rejected write is now reported as a rejected write, the rest of the run stops instead of repeating a failure that cannot succeed, and it raises an alert so the wallet gets refilled. Verifying a ledger already worked without the on-chain leg and still does: the recomputed hash chain is the tamper proof, the on-chain write is the independent timestamp on top of it. Separately, the once-a-minute economy heartbeat now refuses to drive production from a machine that is not production, so a developer running it locally can no longer fire thirty-six live money engines at the real site.",+ "link": "/docs/reasoning-ledger",+ "tags": [+ "fix",+ "infra"+ ]+ },+ {+ "date": "2026-08-15",+ "type": "update",+ "title": "Docs pages stop opening with a wall of raw metadata, and the AWS pages say where the Marketplace listing actually stands",+ "summary": "Nine documentation pages are written as article drafts, so each one starts with a small block of publishing metadata: the title, where it is meant to run, its tags. That block is meant for the tooling, not for you, but the docs reader had no idea what it was and rendered it as an enormous heading at the very top of the article, above the actual writing. It is now recognised and hidden, on the page and in the Copy page text, so those articles begin where they should. Reading the same pages closely turned up claims that had drifted: several said three.ws was already live on AWS Marketplace and billing usage to your AWS invoice. The integration is built and deployed, but the listing itself has not been published yet and the pricing decision is a free subscription with no AWS metering, so the AWS pages now say exactly that and point at the page that tracks the status. The MCP article's vanity-address tool was also listed at a metered price of up to fifty cents; it is a flat five cents per grind, which is what the code has always charged.",+ "link": "/docs/aws-marketplace",+ "tags": [+ "docs",+ "fix"+ ]+ },+ {+ "date": "2026-08-15",+ "type": "update",+ "title": "Oracle stops answering \"nothing is happening\" when the database is the thing that is down",+ "summary": "Several Oracle reads shared a habit: if the database was unreachable for a few seconds, they answered normally with an empty result. The movers panel said nothing was moving, the stats hero said no coin had ever been scored and no agent was armed, a coin's conviction sparkline came back flat, and the machine-readable signal endpoint told autonomous agents there were no plays, which is exactly the cue for an agent to stand down. Every one of those answers was then cached at the edge for a minute or two, so a blip lasting seconds kept showing a dead market long after the database was back. Those endpoints now tell the difference between a connectivity failure and an ordinary query fault: the first is reported honestly as a temporary outage with a retry hint and is never cached, the second still degrades to the empty answer it always did. The social ingest got the sharper end of the same bug: it used to reply that a batch had been accepted while reporting zero mints written, a receipt for a write that never landed. It now fails loudly so the sender retries. Shared conviction cards behave too: one built during an outage is no longer pinned to a coin's link preview for 15 minutes.",+ "link": "/oracle",+ "tags": [+ "fix",+ "improvement"+ ]+ },+ {+ "date": "2026-08-15",+ "type": "update",+ "title": "Plan checkout: a paid upgrade can only ever settle on real mainnet, and a late payment is no longer stranded",+ "summary": "Paying for a plan creates a quote, you send the funds, then the server checks the chain before it upgrades you. Three things in that path were wrong. The checkout side has always refused test-network quotes in production, because test-network dollars are free from a faucet, but the confirm side still let a caller name the test network itself, and it is the confirm side that decides which chain it looks at and which dollar it accepts. Both ends now read the same setting, so a production upgrade can only ever be settled by real funds on mainnet. Second, an Ethereum-side payment has to wait twelve blocks before it counts, which meant funds sent near the end of a session could land on-chain and then be refused for arriving late, with the money already gone; that lane now honors the same one-hour grace window the Solana lane has, so an on-chain payment is always claimable. Third, confirming an Ethereum payment could reach a Solana quote and mark it expired, and asking to buy a skill from a malformed agent id answered a generic server error instead of telling you what was wrong with the request.",+ "link": "/pricing",+ "tags": [+ "fix",+ "security"+ ]+ },+ {+ "date": "2026-08-15",+ "type": "update",+ "title": "Self-hosting docs no longer hand you a command that wipes your environment",+ "summary": "The deployment guide told self-hosters to set Cloud Run environment variables with `gcloud run services update --set-env-vars`. That flag replaces the service environment wholesale, so following the instruction for a single key silently deletes every other variable the service had. The guide now uses `--update-env-vars` and says plainly why. Four more corrections landed in the same sweep across the deployment, configuration and contributing pages: the Avaturn signup link and the GitHub Discussions links were dead (Discussions are not enabled on the repository, so bug reports and design questions both go to Issues); the in-browser avatar builder was documented as needing its own hosted origin in production when the normal build already serves it same-origin at /avatar-studio; and three counts that had drifted from the code (cron jobs, MCP server packages, contract tests) were replaced with pointers to the files that hold the real numbers.",+ "link": "/docs/deployment",+ "tags": [+ "docs",+ "fix"+ ]+ },+ {+ "date": "2026-08-15",+ "type": "update",+ "title": "The Agent Economy demo works again when you just pick a service, and it fits a phone screen",+ "summary": "On the Agent Economy page, two 3D agents trade with each other for real SOL: Nova buys a market read, an on-chain insight, or a risk score from Oracle. Picking a service and typing nothing in the optional topic box, which is what almost everyone does, sent the request off in a shape the endpoint refused, so the demo answered with a validation error instead of a trade. It now sends the request correctly, and the endpoint accepts an empty topic besides. On a phone the page was worse than broken: the transaction feed and the status line, the entire output of the demo, were cut off the bottom of the screen with no way to scroll to them, and the floating language button sat on top of the footer links. The centre column now scrolls, the feed keeps a readable height, and the footer stays clickable. Three failure states also stopped lying: a payment that could not go through no longer ends on Transaction complete, a request that never reached the server now says so and offers to try again, and unreadable wallet balances now say they are unavailable and offer a retry instead of spinning forever.",+ "link": "/agent-economy",+ "tags": [+ "fix",+ "improvement"+ ]+ },+ {+ "date": "2026-08-15",+ "type": "update",+ "title": "The persona builder stops reporting a model outage as if you had been signed out",+ "summary": "The two routes behind the persona builder (the one that turns your interview answers or a sample of your own writing into a structured persona, and the one that replies to you in that persona's voice) used to hand you whatever status code the model provider returned. If a server-side key expired, the provider answered 401 and so did we, which reads to a browser as an expired session on a request where nothing was wrong with your sign-in. Both now report a provider failure as exactly what it is: a server-side fault, with a plain message and no implication that you need to log back in. Separately, when the platform's daily model-spend ceiling is reached, the builder now says so and tells you when it resets, instead of asking you to retry something that could not have succeeded for the rest of the day. Both routes also now record their model usage against your account, so the spend they generate is visible and capped rather than untracked, and the daily extraction budget now holds across every server instance instead of being counted separately on each one.",+ "link": null,+ "tags": [+ "fix",+ "improvement"+ ]+ },+ {+ "date": "2026-08-15",+ "type": "update",+ "title": "The plugin marketplace stops hiding a plugin when you page through it",+ "summary": "Browsing plugins a page at a time could show you the same plugin twice and never show another one at all. The catalogue was sorted by install count and publish date, and the built-in plugins were all published in the same instant with zero installs, so that sort left them tied and the database was free to order the tied rows differently on every request. One plugin therefore landed on two consecutive pages and one fell through the gap. The order is now decided all the way down, so paging through the catalogue returns every plugin exactly once. Searching also takes your text literally: typing a percent sign or an underscore used to act as a database wildcard and match rows it should not. Publishing got stricter at the same time, because a plugin manifest is handed to the model as a tool definition by whoever installs it: a tool name now has to be plain letters, digits, underscores, or hyphens, every tool needs a real description, and a manifest has to fit the same 64KB ceiling that importing one by URL already enforced. And pointing the importer at a repository web page instead of the raw manifest file now says exactly that, rather than showing a raw parser error.",+ "link": "/marketplace",+ "tags": [+ "fix",+ "improvement"+ ]+ },{"date": "2026-08-14","type": "launch",@@ -6092,7 +6190,7 @@"date": "2026-07-30","type": "launch","title": "Docs · Write a repository guard",- "summary": "Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json, wire it into a stage, and cover it with a test that includes the false positive it must never report.",+ "summary": "Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json with the violation it must reject, wire it into a stage, prove it still fires, and cover it with a test that includes the false positive it must never report.","link": "/docs/tutorials/write-a-guard","tags": ["launch"@@ -6312,7 +6410,7 @@"date": "2026-07-30","type": "launch","title": "Tutorial · Write a repository guard",- "summary": "This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when an API handler forgets its error boundary, wire it into the gate, cover it with tests, and register it.",+ "summary": "This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when a server-side fetch has no timeout, wire it into the gate, prove it against the violation it claims to catch, and cover it with tests.","link": "/tutorials/write-a-guard","tags": ["launch"diff --git a/public/changelog.xml b/public/changelog.xmlindex b4f9053a7..822d53650 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -6,6 +6,78 @@<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>A broken paid endpoint is no longer reported as a free one</title>+ <link>https://three.ws/pay/simulator</link>+ <guid isPermaLink="false">2026-08-15:A broken paid endpoint is no longer reported as a free one</guid>+ <pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>Payment sessions let you hand an agent a budget instead of a key, and two parts of that path judged an endpoint by one rule: if it did not ask for payment, the call was free. That is only true when the endpoint actually succeeded. A paid API answering 404, 400, or 500 was being scored as a free call, and the consequences ran in the wrong direction in both places. The dry run at /pay/simulator, whose whole job is to tell you in advance whether a budget and an allowlist will carry a workload, reported a plan as feasible at a cost of nothing when in fact every endpoint in it was erroring: free calls are never priced, never allowlist-checked, and never counted, so a wall of failures looked like a clean run. And an agent spending through a session got back a success envelope saying no payment was needed for an endpoint that had just failed on it. Both now separate the two cases: a real success with no payment challenge is still free and still costs nothing, while an error status is reported as an endpoint failure carrying the status the endpoint actually returned. No session is charged either way. The simulator lists each failing endpoint by name in its problems list and no longer calls the plan feasible.</description>+ </item>+ <item>+ <title>A silent outage in the agent reasoning ledger now reports itself</title>+ <link>https://three.ws/docs/reasoning-ledger</link>+ <guid isPermaLink="false">2026-08-15:A silent outage in the agent reasoning ledger now reports itself</guid>+ <pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>Every agent decision is committed to a hash chain, and that chain head is written to Solana on a schedule so anyone can check the history was never edited. The wallet that pays for those on-chain writes ran empty, and the scheduled job could not tell that apart from the harmless case where no signing key is set up at all: it answered a healthy 200 every ten minutes while re-sending the same doomed transaction for twelve agents in a row, and not one head reached the chain. A rejected write is now reported as a rejected write, the rest of the run stops instead of repeating a failure that cannot succeed, and it raises an alert so the wallet gets refilled. Verifying a ledger already worked without the on-chain leg and still does: the recomputed hash chain is the tamper proof, the on-chain write is the independent timestamp on top of it. Separately, the once-a-minute economy heartbeat now refuses to drive production from a machine that is not production, so a developer running it locally can no longer fire thirty-six live money engines at the real site.</description>+ </item>+ <item>+ <title>Docs pages stop opening with a wall of raw metadata, and the AWS pages say where the Marketplace listing actually stands</title>+ <link>https://three.ws/docs/aws-marketplace</link>+ <guid isPermaLink="false">2026-08-15:Docs pages stop opening with a wall of raw metadata, and the AWS pages say where the Marketplace listing actually stands</guid>+ <pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate>+ <category>docs</category>+ <description>Nine documentation pages are written as article drafts, so each one starts with a small block of publishing metadata: the title, where it is meant to run, its tags. That block is meant for the tooling, not for you, but the docs reader had no idea what it was and rendered it as an enormous heading at the very top of the article, above the actual writing. It is now recognised and hidden, on the page and in the Copy page text, so those articles begin where they should. Reading the same pages closely turned up claims that had drifted: several said three.ws was already live on AWS Marketplace and billing usage to your AWS invoice. The integration is built and deployed, but the listing itself has not been published yet and the pricing decision is a free subscription with no AWS metering, so the AWS pages now say exactly that and point at the page that tracks the status. The MCP article's vanity-address tool was also listed at a metered price of up to fifty cents; it is a flat five cents per grind, which is what the code has always charged.</description>+ </item>+ <item>+ <title>Oracle stops answering "nothing is happening" when the database is the thing that is down</title>+ <link>https://three.ws/oracle</link>+ <guid isPermaLink="false">2026-08-15:Oracle stops answering "nothing is happening" when the database is the thing that is down</guid>+ <pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>Several Oracle reads shared a habit: if the database was unreachable for a few seconds, they answered normally with an empty result. The movers panel said nothing was moving, the stats hero said no coin had ever been scored and no agent was armed, a coin's conviction sparkline came back flat, and the machine-readable signal endpoint told autonomous agents there were no plays, which is exactly the cue for an agent to stand down. Every one of those answers was then cached at the edge for a minute or two, so a blip lasting seconds kept showing a dead market long after the database was back. Those endpoints now tell the difference between a connectivity failure and an ordinary query fault: the first is reported honestly as a temporary outage with a retry hint and is never cached, the second still degrades to the empty answer it always did. The social ingest got the sharper end of the same bug: it used to reply that a batch had been accepted while reporting zero mints written, a receipt for a write that never landed. It now fails loudly so the sender retries. Shared conviction cards behave too: one built during an outage is no longer pinned to a coin's link preview for 15 minutes.</description>+ </item>+ <item>+ <title>Plan checkout: a paid upgrade can only ever settle on real mainnet, and a late payment is no longer stranded</title>+ <link>https://three.ws/pricing</link>+ <guid isPermaLink="false">2026-08-15:Plan checkout: a paid upgrade can only ever settle on real mainnet, and a late payment is no longer stranded</guid>+ <pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>Paying for a plan creates a quote, you send the funds, then the server checks the chain before it upgrades you. Three things in that path were wrong. The checkout side has always refused test-network quotes in production, because test-network dollars are free from a faucet, but the confirm side still let a caller name the test network itself, and it is the confirm side that decides which chain it looks at and which dollar it accepts. Both ends now read the same setting, so a production upgrade can only ever be settled by real funds on mainnet. Second, an Ethereum-side payment has to wait twelve blocks before it counts, which meant funds sent near the end of a session could land on-chain and then be refused for arriving late, with the money already gone; that lane now honors the same one-hour grace window the Solana lane has, so an on-chain payment is always claimable. Third, confirming an Ethereum payment could reach a Solana quote and mark it expired, and asking to buy a skill from a malformed agent id answered a generic server error instead of telling you what was wrong with the request.</description>+ </item>+ <item>+ <title>Self-hosting docs no longer hand you a command that wipes your environment</title>+ <link>https://three.ws/docs/deployment</link>+ <guid isPermaLink="false">2026-08-15:Self-hosting docs no longer hand you a command that wipes your environment</guid>+ <pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate>+ <category>docs</category>+ <description>The deployment guide told self-hosters to set Cloud Run environment variables with `gcloud run services update --set-env-vars`. That flag replaces the service environment wholesale, so following the instruction for a single key silently deletes every other variable the service had. The guide now uses `--update-env-vars` and says plainly why. Four more corrections landed in the same sweep across the deployment, configuration and contributing pages: the Avaturn signup link and the GitHub Discussions links were dead (Discussions are not enabled on the repository, so bug reports and design questions both go to Issues); the in-browser avatar builder was documented as needing its own hosted origin in production when the normal build already serves it same-origin at /avatar-studio; and three counts that had drifted from the code (cron jobs, MCP server packages, contract tests) were replaced with pointers to the files that hold the real numbers.</description>+ </item>+ <item>+ <title>The Agent Economy demo works again when you just pick a service, and it fits a phone screen</title>+ <link>https://three.ws/agent-economy</link>+ <guid isPermaLink="false">2026-08-15:The Agent Economy demo works again when you just pick a service, and it fits a phone screen</guid>+ <pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>On the Agent Economy page, two 3D agents trade with each other for real SOL: Nova buys a market read, an on-chain insight, or a risk score from Oracle. Picking a service and typing nothing in the optional topic box, which is what almost everyone does, sent the request off in a shape the endpoint refused, so the demo answered with a validation error instead of a trade. It now sends the request correctly, and the endpoint accepts an empty topic besides. On a phone the page was worse than broken: the transaction feed and the status line, the entire output of the demo, were cut off the bottom of the screen with no way to scroll to them, and the floating language button sat on top of the footer links. The centre column now scrolls, the feed keeps a readable height, and the footer stays clickable. Three failure states also stopped lying: a payment that could not go through no longer ends on Transaction complete, a request that never reached the server now says so and offers to try again, and unreadable wallet balances now say they are unavailable and offer a retry instead of spinning forever.</description>+ </item>+ <item>+ <title>The persona builder stops reporting a model outage as if you had been signed out</title>+ <link>https://three.ws/changelog</link>+ <guid isPermaLink="false">2026-08-15:The persona builder stops reporting a model outage as if you had been signed out</guid>+ <pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>The two routes behind the persona builder (the one that turns your interview answers or a sample of your own writing into a structured persona, and the one that replies to you in that persona's voice) used to hand you whatever status code the model provider returned. If a server-side key expired, the provider answered 401 and so did we, which reads to a browser as an expired session on a request where nothing was wrong with your sign-in. Both now report a provider failure as exactly what it is: a server-side fault, with a plain message and no implication that you need to log back in. Separately, when the platform's daily model-spend ceiling is reached, the builder now says so and tells you when it resets, instead of asking you to retry something that could not have succeeded for the rest of the day. Both routes also now record their model usage against your account, so the spend they generate is visible and capped rather than untracked, and the daily extraction budget now holds across every server instance instead of being counted separately on each one.</description>+ </item>+ <item>+ <title>The plugin marketplace stops hiding a plugin when you page through it</title>+ <link>https://three.ws/marketplace</link>+ <guid isPermaLink="false">2026-08-15:The plugin marketplace stops hiding a plugin when you page through it</guid>+ <pubDate>Sat, 15 Aug 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>Browsing plugins a page at a time could show you the same plugin twice and never show another one at all. The catalogue was sorted by install count and publish date, and the built-in plugins were all published in the same instant with zero installs, so that sort left them tied and the database was free to order the tied rows differently on every request. One plugin therefore landed on two consecutive pages and one fell through the gap. The order is now decided all the way down, so paging through the catalogue returns every plugin exactly once. Searching also takes your text literally: typing a percent sign or an underscore used to act as a database wildcard and match rows it should not. Publishing got stricter at the same time, because a plugin manifest is handed to the model as a tool definition by whoever installs it: a tool name now has to be plain letters, digits, underscores, or hyphens, every tool needs a real description, and a manifest has to fit the same 64KB ceiling that importing one by URL already enforced. And pointing the importer at a repository web page instead of the raw manifest file now says exactly that, rather than showing a raw parser error.</description>+ </item><item><title>Agent Interaction Lab</title><link>https://three.ws/demos/agents</link>@@ -4596,7 +4668,7 @@<guid isPermaLink="false">2026-07-30:Docs · Write a repository guard</guid><pubDate>Thu, 30 Jul 2026 12:00:00 GMT</pubDate><category>launch</category>- <description>Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json, wire it into a stage, and cover it with a test that includes the false positive it must never report.</description>+ <description>Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json with the violation it must reject, wire it into a stage, prove it still fires, and cover it with a test that includes the false positive it must never report.</description></item><item><title>Docs World (immersive 3D docs)</title>@@ -4772,7 +4844,7 @@<guid isPermaLink="false">2026-07-30:Tutorial · Write a repository guard</guid><pubDate>Thu, 30 Jul 2026 12:00:00 GMT</pubDate><category>launch</category>- <description>This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when an API handler forgets its error boundary, wire it into the gate, cover it with tests, and register it.</description>+ <description>This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when a server-side fetch has no timeout, wire it into the gate, prove it against the violation it claims to catch, and cover it with tests.</description></item><item><title>Tutorial: build a 3D asset pipeline</title>diff --git a/public/examples.json b/public/examples.jsonindex 70d558d18..8b536da90 100644--- a/public/examples.json+++ b/public/examples.json@@ -2,10 +2,10 @@"$comment": "GENERATED by scripts/mirror-examples-index.mjs from data/examples.json. Do not edit; run `npm run build:examples`.","generated_by": "scripts/build-examples-index.mjs","counts": {- "total": 40,+ "total": 42,"html_demos": 11,"projects": 10,- "packages": 19+ "packages": 21},"examples": [{@@ -315,13 +315,29 @@"description": "American Sign Language for 3D avatars.","path": "packages/sign-language/example","files": [- "compile-utterance.mjs"+ "compile-utterance.mjs",+ "utterance.clip.json"],"run": "node packages/sign-language/example/compile-utterance.mjs","runKind": "command","readme": null,"owner": "packages/sign-language"},+ {+ "id": "package:packages/skill-license",+ "kind": "package",+ "group": "Package examples",+ "title": "@three-ws/skill-license",+ "description": "On-chain skill licenses for agents - each purchased skill is a 1/1 SPL NFT plus a deterministic SkillLicense PDA. Mint, verify, and read trustless skill access in one import, no database required.",+ "path": "packages/skill-license/example",+ "files": [+ "verify-license.mjs"+ ],+ "run": "node packages/skill-license/example/verify-license.mjs",+ "runKind": "command",+ "readme": null,+ "owner": "packages/skill-license"+ },{"id": "package:tour-sdk","kind": "package",@@ -356,6 +372,22 @@"readme": "packages/vanity-mcp/examples/README.md","owner": "packages/vanity-mcp"},+ {+ "id": "package:packages/vision-mcp",+ "kind": "package",+ "group": "Package examples",+ "title": "@three-ws/vision-mcp",+ "description": "Two runnable examples. Both spawn this package's own MCP server over stdio (the same node src/index.js entry point the README documents), speak real MCP JSON-RPC to it, and hit the live three.ws vision pipeline.",+ "path": "packages/vision-mcp/examples",+ "files": [+ "list-tools.mjs",+ "read-an-image.mjs"+ ],+ "run": "node packages/vision-mcp/examples/list-tools.mjs",+ "runKind": "command",+ "readme": "packages/vision-mcp/examples/README.md",+ "owner": "packages/vision-mcp"+ },{"id": "package:packages/x402-fetch","kind": "package",diff --git a/public/features.json b/public/features.jsonindex 7737330f9..62199c26c 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-15T01:22:33.684Z",+ "generated_at": "2026-08-15T05:46:26.357Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -5840,7 +5840,7 @@{"path": "/docs/aws-marketplace","title": "Docs · three.ws on AWS Marketplace",- "description": "three.ws is a verified AWS Partner and listed on AWS Marketplace as an API-based SaaS product. The subscription is a free front door: subscribing links your AWS account to a platform account.",+ "description": "three.ws is a verified AWS Partner. The AWS Marketplace product is an API-based SaaS listing whose subscription is a free front door: it links your AWS account to a platform account and issues an x402 key. Integration, endpoints, and current listing status.","added": null,"auth": null,"indexable": true,@@ -6470,7 +6470,7 @@{"path": "/tutorials/write-a-guard","title": "Tutorial · Write a repository guard",- "description": "This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when an API handler forgets its error boundary, wire it into the gate, cover it with tests, and register it.",+ "description": "This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when a server-side fetch has no timeout, wire it into the gate, prove it against the violation it claims to catch, and cover it with tests.","added": "2026-07-30","auth": null,"indexable": true,@@ -6490,7 +6490,7 @@{"path": "/docs/tutorials/write-a-guard","title": "Docs · Write a repository guard",- "description": "Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json, wire it into a stage, and cover it with a test that includes the false positive it must never report.",+ "description": "Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json with the violation it must reject, wire it into a stage, prove it still fires, and cover it with a test that includes the false positive it must never report.","added": "2026-07-30","auth": null,"indexable": true,diff --git a/public/llms-full.txt b/public/llms-full.txtindex 96a0d6fc2..8584ef5d7 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -3537,7 +3537,7 @@ The AWS Builder Center is Amazon's community publishing platform for engineers bURL: https://three.ws/docs/aws-marketplace-three.ws is a verified AWS Partner and listed on AWS Marketplace as an API-based SaaS product. The subscription is a free front door: subscribing links your AWS account to a platform account.+three.ws is a verified AWS Partner. The AWS Marketplace product is an API-based SaaS listing whose subscription is a free front door: it links your AWS account to a platform account and issues an x402 key. Integration, endpoints, and current listing status.### Docs · three.ws on AWS@@ -3915,7 +3915,7 @@ Turn a raw GLB into a signed-off, hash-anchored manifest: one document that nameURL: https://three.ws/tutorials/write-a-guard-This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when an API handler forgets its error boundary, wire it into the gate, cover it with tests, and register it.+This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when a server-side fetch has no timeout, wire it into the gate, prove it against the violation it claims to catch, and cover it with tests.### Repository guards@@ -3927,7 +3927,7 @@ Every mechanical guard that protects the three.ws codebase, and the stage each oURL: https://three.ws/docs/tutorials/write-a-guard-Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json, wire it into a stage, and cover it with a test that includes the false positive it must never report.+Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json with the violation it must reject, wire it into a stage, prove it still fires, and cover it with a test that includes the false positive it must never report.### Tutorial · Earn and spend in /playdiff --git a/public/llms.txt b/public/llms.txtindex 9f7f3cd1a..e26dd13ea 100644--- a/public/llms.txt+++ b/public/llms.txt@@ -623,7 +623,7 @@ Docs, tutorials, and reference.- [Docs · IBM watsonx and Granite](https://three.ws/docs/ibm): three.ws agents can think on IBM Granite foundation models served through IBM watsonx.ai. The whole integration for developers and operators: model selection, credentials, request shapes, and the fallback behind it.- [Docs · IBM Granite pay-per-call MCP](https://three.ws/docs/ibm-x402-mcp): A menu of IBM AI capabilities (chat, code, embeddings, document analysis, forecasting) that any agent or MCP client can use by paying a few cents per call, with no account and no subscription.- [Docs · three.ws on the AWS Builder Center](https://three.ws/docs/aws-builder-center): The AWS Builder Center is Amazon's community publishing platform for engineers building on AWS. three.ws publishes there under its official organisation account, and this is the index of what has been published.-- [Docs · three.ws on AWS Marketplace](https://three.ws/docs/aws-marketplace): three.ws is a verified AWS Partner and listed on AWS Marketplace as an API-based SaaS product. The subscription is a free front door: subscribing links your AWS account to a platform account.+- [Docs · three.ws on AWS Marketplace](https://three.ws/docs/aws-marketplace): three.ws is a verified AWS Partner. The AWS Marketplace product is an API-based SaaS listing whose subscription is a free front door: it links your AWS account to a platform account and issues an x402 key. Integration, endpoints, and current listing status.- [Docs · three.ws on AWS](https://three.ws/docs/aws-partner-spotlight): Most enterprise AI agents live inside a chat box. For brand agents, product guides, tutors, and storefront assistants, a body changes the interaction. How three.ws builds that on AWS.- [Docs · An MCP server whose tools pay for themselves](https://three.ws/docs/aws-builder-center-mcp-agents): Most AI tooling assumes a human is standing by with a credit card and an API key. That model breaks the moment the caller is an agent. How to build tools an agent can discover, pay for, and use unattended.- [Docs · Give your AI agent a budget, not a private key](https://three.ws/docs/aws-builder-center-agent-payment-sessions): There is a moment in every agentic build where the agent needs to buy something. Handing it a private key is the wrong answer. Payment sessions give it a bounded budget instead, and this is how they work.@@ -686,9 +686,9 @@ Docs, tutorials, and reference.- [Docs: Avatar CLI](https://three.ws/docs/avatar-cli): Command reference for @three-ws/avatar-cli: init, validate, hash, and preview, with every flag, exit code, and JSON shape, plus the two checks that gate a release on your avatar manifest.- [Rig Doctor reference](https://three.ws/docs/rig-doctor): What each Rig Doctor verdict means, how limb-group coverage is scored, what the in-browser repair changes, the eleven rig conventions it recognises, and the full 52-joint canonical skeleton.- [Tutorial · Ship an avatar manifest](https://three.ws/tutorials/ship-an-avatar-manifest): Turn a raw GLB into a signed-off, hash-anchored manifest: one document that names the avatar, records the exact bytes of its mesh, declares its skeleton, and fails your build if the model ever silently changes.-- [Tutorial · Write a repository guard](https://three.ws/tutorials/write-a-guard): This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when an API handler forgets its error boundary, wire it into the gate, cover it with tests, and register it.+- [Tutorial · Write a repository guard](https://three.ws/tutorials/write-a-guard): This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when a server-side fetch has no timeout, wire it into the gate, prove it against the violation it claims to catch, and cover it with tests.- [Repository guards](https://three.ws/guards): Every mechanical guard that protects the three.ws codebase, and the stage each one runs in. This repository has no CI, so correctness is enforced by fast local checks wired into the prebuild, the gate, the deploy build, and the git pre-push hook. Filter by stage, search by command, and read the incident behind each one.-- [Docs · Write a repository guard](https://three.ws/docs/tutorials/write-a-guard): Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json, wire it into a stage, and cover it with a test that includes the false positive it must never report.+- [Docs · Write a repository guard](https://three.ws/docs/tutorials/write-a-guard): Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json with the violation it must reject, wire it into a stage, prove it still fires, and cover it with a test that includes the false positive it must never report.- [Tutorial · Earn and spend in /play](https://three.ws/tutorials/earn-and-spend-in-play): Run the full economic loop in the open world: gather raw materials, sell them to a vendor, buy a better tool, bank the rest so death can't take it, and spin the wheel. Covers why the world has two currencies that never touch, and why the server decides every price.- [Docs: The showcase](https://three.ws/docs/showcase): The public directory of ERC-8004 agents that registered a real 3D avatar. Nothing is curated: an agent appears because the crawler verified its on-chain metadata resolves to a usable model. Covers the qualifying rules and the keyset-paginated API.- [Docs · Tutorial: earn and spend in /play](https://three.ws/docs/tutorials/earn-and-spend-in-play): Run the full economic loop in the open world: gather materials, sell them to the vendor, buy a better tool, bank what you cannot afford to lose, and spin the wheel. Explains why cooking triples fish value and why the bank is the only real decision.diff --git a/public/locales/af.json b/public/locales/af.jsonindex 9b34bcb08..203620d02 100644--- a/public/locales/af.json+++ b/public/locales/af.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agentruil",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Koop inligting — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Koop inligting · $0.01 USDC</span>","buy_intel_on": "Koop inligting oor:","buyer": "KOPER","buyer_agent": "Koperagent","intel_agent": "Inligtingagent","meta_description": "Twee KI-agente met 3D-liggame onderhandel en betaal mekaar vir lewendige kripto-inligting met x402 mikrovergoedings op Solana. Elke transaksie is werklik en op-ketting bevestig.","meta_og_description": "Twee 3D KI-agente koop en verkoop kripto-inligting vir regte USDC op Solana. Kyk hoe elke transaksie op-ketting bevestig word.",- "meta_og_title": "Agentruil — KI-agente betaal mekaar in reële tyd",- "meta_title": "Agentruil — 3D KI-agente betaal mekaar in reële tyd · three.ws",+ "meta_og_title": "Agentruil: KI-agente betaal mekaar in reële tyd",+ "meta_title": "Agentruil: 3D KI-agente betaal mekaar in reële tyd · three.ws","meta_twitter_description": "Twee 3D KI-agente betaal mekaar vir regte kripto-inligting. USDC op Solana. Op-ketting.",- "meta_twitter_title": "Agentruil — KI-agente betaal mekaar in reële tyd",+ "meta_twitter_title": "Agentruil: KI-agente betaal mekaar in reële tyd","seller": "VERKOPER","session_total_0_00_usdc_settled_on": "Sessietotaal: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC op-ketting vereffen","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 betaal-per-oproep demo",- "x402_the_payment_trust_layer_title": "x402 — die betaalvertrouenslaag agter hierdie skikkings"+ "x402_the_payment_trust_layer_title": "x402: die betaalvertrouenslaag agter hierdie skikkings"},"agent_identities": {"1_call_create_identity": "1 · Roep create_identity aan",diff --git a/public/locales/am.json b/public/locales/am.jsonindex 3a0fbdeb2..3a774e49e 100644--- a/public/locales/am.json+++ b/public/locales/am.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>የወኪል ልውውጥ",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">መረጃ ይግዙ — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">መረጃ ይግዙ · $0.01 USDC</span>","buy_intel_on": "መረጃ ይግዙ በ:","buyer": "ገዢ","buyer_agent": "ገዢ ወኪል","intel_agent": "መረጃ ወኪል","meta_description": "ሁለት ባለ 3D አካል ያላቸው AI ወኪሎች በቀጥታ የክሪፕቶ መረጃ ለማግኘት በSolana ላይ x402 ማይክሮ ክፍያዎችን በመጠቀም ይደራደራሉ እና እርስ በእርስ ይከፍላሉ። እያንዳንዱ ግብይት እውነተኛ እና በሰንሰለት ላይ የተረጋገጠ ነው።","meta_og_description": "ሁለት ባለ 3D AI ወኪሎች እውነተኛ USDC ክሪፕቶ መረጃ በSolana ላይ ይገዛሉ እና ይሸጣሉ። እያንዳንዱ ግብይት በሰንሰለት ላይ ሲረጋገጥ ይመልከቱ።",- "meta_og_title": "የወኪል ልውውጥ — AI ወኪሎች እርስ በእርስ በእውነተኛ ጊዜ ሲከፍሉ",- "meta_title": "የወኪል ልውውጥ — ባለ 3D AI ወኪሎች እርስ በእርስ በእውነተኛ ጊዜ ሲከፍሉ · three.ws",+ "meta_og_title": "የወኪል ልውውጥ: AI ወኪሎች እርስ በእርስ በእውነተኛ ጊዜ ሲከፍሉ",+ "meta_title": "የወኪል ልውውጥ: ባለ 3D AI ወኪሎች እርስ በእርስ በእውነተኛ ጊዜ ሲከፍሉ · three.ws","meta_twitter_description": "ሁለት ባለ 3D AI ወኪሎች እውነተኛ የክሪፕቶ መረጃ ለማግኘት እርስ በእርስ ይከፍላሉ። USDC በSolana ላይ። በሰንሰለት ላይ።",- "meta_twitter_title": "የወኪል ልውውጥ — AI ወኪሎች እርስ በእርስ በእውነተኛ ጊዜ ሲከፍሉ",+ "meta_twitter_title": "የወኪል ልውውጥ: AI ወኪሎች እርስ በእርስ በእውነተኛ ጊዜ ሲከፍሉ","seller": "ሻጭ","session_total_0_00_usdc_settled_on": "የክፍለ ጊዜ ድምር: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC በሰንሰለት ላይ ተፈጽሟል","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 በጥሪ ክፍያ ማሳያ",- "x402_the_payment_trust_layer_title": "x402 — the payment trust layer behind these settlements"+ "x402_the_payment_trust_layer_title": "x402: the payment trust layer behind these settlements"},"agent_identities": {"1_call_create_identity": "1 · create_identityን ይጥሩ",diff --git a/public/locales/ar.json b/public/locales/ar.jsonindex beab6362d..b33e4f480 100644--- a/public/locales/ar.json+++ b/public/locales/ar.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>سوق الوكلاء",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">اشترِ معلومات — 0.01 دولار USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">اشترِ معلومات · 0.01 دولار USDC</span>","buy_intel_on": "اشترِ معلومات عن:","buyer": "المشتري","buyer_agent": "وكيل مشتري","intel_agent": "وكيل معلومات","meta_description": "وكيلان ذكاء اصطناعي بأجسام ثلاثية الأبعاد يتفاوضان ويدفعان لبعضهما البعض مقابل معلومات حية عن العملات المشفرة باستخدام مدفوعات x402 المصغرة على Solana. كل معاملة حقيقية ومؤكدة على السلسلة.","meta_og_description": "وكيلان ذكاء اصطناعي ثلاثيا الأبعاد يشتريان ويبيعان معلومات العملات المشفرة مقابل USDC حقيقية على Solana. شاهد كل معاملة وهي تتأكد على السلسلة.",- "meta_og_title": "سوق الوكلاء — وكلاء الذكاء الاصطناعي يدفعون لبعضهم البعض في الوقت الفعلي",- "meta_title": "سوق الوكلاء — وكلاء ذكاء اصطناعي ثلاثيو الأبعاد يدفعون لبعضهم البعض في الوقت الفعلي · three.ws",+ "meta_og_title": "سوق الوكلاء: وكلاء الذكاء الاصطناعي يدفعون لبعضهم البعض في الوقت الفعلي",+ "meta_title": "سوق الوكلاء: وكلاء ذكاء اصطناعي ثلاثيو الأبعاد يدفعون لبعضهم البعض في الوقت الفعلي · three.ws","meta_twitter_description": "وكيلان ذكاء اصطناعي ثلاثيا الأبعاد يدفعان لبعضهما البعض مقابل معلومات حقيقية عن العملات المشفرة. USDC على Solana. على السلسلة.",- "meta_twitter_title": "سوق الوكلاء — وكلاء الذكاء الاصطناعي يدفعون لبعضهم البعض في الوقت الفعلي",+ "meta_twitter_title": "سوق الوكلاء: وكلاء الذكاء الاصطناعي يدفعون لبعضهم البعض في الوقت الفعلي","seller": "البائع","session_total_0_00_usdc_settled_on": "إجمالي الجلسة: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC تمت تسويتها على السلسلة","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 عرض توضيحي للدفع مقابل كل مكالمة",- "x402_the_payment_trust_layer_title": "x402 — طبقة الثقة للدفع وراء هذه التسويات"+ "x402_the_payment_trust_layer_title": "x402: طبقة الثقة للدفع وراء هذه التسويات"},"agent_identities": {"1_call_create_identity": "1 · استدعِ create_identity",diff --git a/public/locales/as.json b/public/locales/as.jsonindex 93bd8ee7a..8da89b713 100644--- a/public/locales/as.json+++ b/public/locales/as.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>এজেণ্ট এক্সচেঞ্জ",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ইণ্টেল ক্ৰয় কৰক — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ইণ্টেল ক্ৰয় কৰক · $0.01 USDC</span>","buy_intel_on": "এই বিষয়ত ইণ্টেল ক্ৰয় কৰক:","buyer": "ক্ৰেতা","buyer_agent": "ক্ৰেতা এজেণ্ট","intel_agent": "ইণ্টেল এজেণ্ট","meta_description": "3D শৰীৰযুক্ত দুটা AI এজেণ্টে লাইভ ক্ৰিপ্টো ইণ্টেলৰ বাবে ইজনে সিজনক আলোচনা কৰে আৰু পৰিশোধ কৰে Solanaত x402 মাইক্ৰ'পেমেণ্ট ব্যৱহাৰ কৰি। প্ৰতিটো লেনদেন বাস্তৱ আৰু অন-চেইনত নিশ্চিত কৰা হয়।","meta_og_description": "দুটা 3D AI এজেণ্টে ক্ৰিপ্টো ইণ্টেল ক্ৰয় আৰু বিক্ৰী কৰে Solanaত বাস্তৱ USDCৰ বাবে। প্ৰতিটো লেনদেন অন-চেইনত নিশ্চিত হোৱা চাওক।",- "meta_og_title": "এজেণ্ট এক্সচেঞ্জ — AI এজেণ্টে বাস্তৱ সময়ত ইজনে সিজনক পৰিশোধ কৰে",- "meta_title": "এজেণ্ট এক্সচেঞ্জ — 3D AI এজেণ্টে বাস্তৱ সময়ত ইজনে সিজনক পৰিশোধ কৰে · three.ws",+ "meta_og_title": "এজেণ্ট এক্সচেঞ্জ: AI এজেণ্টে বাস্তৱ সময়ত ইজনে সিজনক পৰিশোধ কৰে",+ "meta_title": "এজেণ্ট এক্সচেঞ্জ: 3D AI এজেণ্টে বাস্তৱ সময়ত ইজনে সিজনক পৰিশোধ কৰে · three.ws","meta_twitter_description": "দুটা 3D AI এজেণ্টে বাস্তৱ ক্ৰিপ্টো ইণ্টেলৰ বাবে ইজনে সিজনক পৰিশোধ কৰে। Solanaত USDC। অন-চেইন।",- "meta_twitter_title": "এজেণ্ট এক্সচেঞ্জ — AI এজেণ্টে বাস্তৱ সময়ত ইজনে সিজনক পৰিশোধ কৰে",+ "meta_twitter_title": "এজেণ্ট এক্সচেঞ্জ: AI এজেণ্টে বাস্তৱ সময়ত ইজনে সিজনক পৰিশোধ কৰে","seller": "বিক্ৰেতা","session_total_0_00_usdc_settled_on": "ছেছনৰ মুঠ: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC অন-চেইনত নিষ্পত্তি কৰা হ'ল","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 পে-পাৰ-কল ডেমো",- "x402_the_payment_trust_layer_title": "x402 — এই নিষ্পত্তিৰ আঁৰৰ পেমেণ্ট ট্ৰাষ্ট লেয়াৰ"+ "x402_the_payment_trust_layer_title": "x402: এই নিষ্পত্তিৰ আঁৰৰ পেমেণ্ট ট্ৰাষ্ট লেয়াৰ"},"agent_identities": {"1_call_create_identity": "১ · create_identity কল কৰক",diff --git a/public/locales/az.json b/public/locales/az.jsonindex 2f4d3c7af..3637d950f 100644--- a/public/locales/az.json+++ b/public/locales/az.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agent Mübadiləsi",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">İntel al — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">İntel al · $0.01 USDC</span>","buy_intel_on": "İntel al:","buyer": "ALICI","buyer_agent": "Alıcı Agent","intel_agent": "İntel Agent","meta_description": "3D bədənə malik iki süni intellekt agenti Solana üzərində x402 mikroödənişlərdən istifadə edərək canlı kripto intel üçün bir-biri ilə danışıqlar aparır və ödəniş edir. Hər əməliyyat realdır və zəncir üzərində təsdiqlənir.","meta_og_description": "İki 3D süni intellekt agenti Solana üzərində real USDC üçün kripto intel alıb satır. Hər əməliyyatın zəncir üzərində təsdiqlənməsini izləyin.",- "meta_og_title": "Agent Mübadiləsi — Real vaxtda bir-birinə ödəniş edən süni intellekt agentləri",- "meta_title": "Agent Mübadiləsi — Real vaxtda bir-birinə ödəniş edən 3D süni intellekt agentləri · three.ws",+ "meta_og_title": "Agent Mübadiləsi: Real vaxtda bir-birinə ödəniş edən süni intellekt agentləri",+ "meta_title": "Agent Mübadiləsi: Real vaxtda bir-birinə ödəniş edən 3D süni intellekt agentləri · three.ws","meta_twitter_description": "Real kripto intel üçün bir-birinə ödəniş edən iki 3D süni intellekt agenti. USDC Solana üzərində. Zəncir üzərində.",- "meta_twitter_title": "Agent Mübadiləsi — Real vaxtda bir-birinə ödəniş edən süni intellekt agentləri",+ "meta_twitter_title": "Agent Mübadiləsi: Real vaxtda bir-birinə ödəniş edən süni intellekt agentləri","seller": "SATICI","session_total_0_00_usdc_settled_on": "Sessiya cəmi: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC zəncir üzərində həll edildi","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 zəng başına ödəniş demosu",- "x402_the_payment_trust_layer_title": "x402 — bu hesablaşmaların arxasında duran ödəniş etibar qatı"+ "x402_the_payment_trust_layer_title": "x402: bu hesablaşmaların arxasında duran ödəniş etibar qatı"},"agent_identities": {"1_call_create_identity": "1 · create_identity çağırın",diff --git a/public/locales/be.json b/public/locales/be.jsonindex af4edefe0..29fe816b4 100644--- a/public/locales/be.json+++ b/public/locales/be.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Абмен агентамі",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Купіць інтэл — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Купіць інтэл · $0.01 USDC</span>","buy_intel_on": "Купіць інтэл пра:","buyer": "ПАКУПНІК","buyer_agent": "Агент-пакупнік","intel_agent": "Агент-інтэл","meta_description": "Два ІІ-агенты з 3D-целамі вядуць перамовы і плацяць адзін аднаму за актуальны крыпта-інтэл, выкарыстоўваючы мікраплацяжы x402 на Solana. Кожная транзакцыя рэальная і пацверджана ў блокчейне.","meta_og_description": "Два 3D ІІ-агенты купляюць і прадаюць крыпта-інтэл за рэальныя USDC на Solana. Глядзіце, як кожная транзакцыя пацвярджаецца ў блокчейне.",- "meta_og_title": "Абмен агентамі — ІІ-агенты плацяць адзін аднаму ў рэжыме рэальнага часу",- "meta_title": "Абмен агентамі — 3D ІІ-агенты плацяць адзін аднаму ў рэжыме рэальнага часу · three.ws",+ "meta_og_title": "Абмен агентамі: ІІ-агенты плацяць адзін аднаму ў рэжыме рэальнага часу",+ "meta_title": "Абмен агентамі: 3D ІІ-агенты плацяць адзін аднаму ў рэжыме рэальнага часу · three.ws","meta_twitter_description": "Два 3D ІІ-агенты плацяць адзін аднаму за рэальны крыпта-інтэл. USDC на Solana. У блокчейне.",- "meta_twitter_title": "Абмен агентамі — ІІ-агенты плацяць адзін аднаму ў рэжыме рэальнага часу",+ "meta_twitter_title": "Абмен агентамі: ІІ-агенты плацяць адзін аднаму ў рэжыме рэальнага часу","seller": "ПРАДАВЕЦ","session_total_0_00_usdc_settled_on": "Усяго за сесію: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC разлічана ў блокчейне","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 дэма з аплатай за выклік",- "x402_the_payment_trust_layer_title": "x402 — плацежны ўзровень даверу, які забяспечвае гэтыя разлікі"+ "x402_the_payment_trust_layer_title": "x402: плацежны ўзровень даверу, які забяспечвае гэтыя разлікі"},"agent_identities": {"1_call_create_identity": "1 · Выклік create_identity",diff --git a/public/locales/bg.json b/public/locales/bg.jsonindex d00ea1508..9acddd545 100644--- a/public/locales/bg.json+++ b/public/locales/bg.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Обмен на агенти",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Купи информация — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Купи информация · $0.01 USDC</span>","buy_intel_on": "Купи информация на:","buyer": "КУПУВАЧ","buyer_agent": "Агент купувач","intel_agent": "Агент информация","meta_description": "Два AI агента с 3D тела преговарят и плащат един на друг за живи крипто данни, използвайки x402 микроплащания на Solana. Всяка транзакция е реална и потвърдена на веригата.","meta_og_description": "Два 3D AI агента купуват и продават крипто информация за реални USDC на Solana. Гледайте как всяка транзакция се потвърдява на веригата.",- "meta_og_title": "Обмен на агенти — AI агенти, плащащи си в реално време",- "meta_title": "Обмен на агенти — 3D AI агенти, плащащи си в реално време · three.ws",+ "meta_og_title": "Обмен на агенти: AI агенти, плащащи си в реално време",+ "meta_title": "Обмен на агенти: 3D AI агенти, плащащи си в реално време · three.ws","meta_twitter_description": "Два 3D AI агента, плащащи си за реална крипто информация. USDC на Solana. На веригата.",- "meta_twitter_title": "Обмен на агенти — AI агенти, плащащи си в реално време",+ "meta_twitter_title": "Обмен на агенти: AI агенти, плащащи си в реално време","seller": "ПРОДАВАЧ","session_total_0_00_usdc_settled_on": "Обща сума на сесията: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC разплатено на веригата","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 демонстрация на плащане на повикване",- "x402_the_payment_trust_layer_title": "x402 — слой на доверие за плащания зад тези разплащания"+ "x402_the_payment_trust_layer_title": "x402: слой на доверие за плащания зад тези разплащания"},"agent_identities": {"1_call_create_identity": "1 · Обаждане за създаване на идентичност",diff --git a/public/locales/bn.json b/public/locales/bn.jsonindex a26ea43c5..0c7423bf8 100644--- a/public/locales/bn.json+++ b/public/locales/bn.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>এজেন্ট এক্সচেঞ্জ",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">বুদ্ধিমত্তা কিনুন — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">বুদ্ধিমত্তা কিনুন · $0.01 USDC</span>","buy_intel_on": "বুদ্ধিমত্তা কিনুন:","buyer": "ক্রেতা","buyer_agent": "ক্রেতা এজেন্ট","intel_agent": "বুদ্ধিমত্তা এজেন্ট","meta_description": "দুটি AI এজেন্ট 3D শরীর নিয়ে লাইভ ক্রিপ্টো তথ্যের জন্য একে অপরের সাথে আলোচনা করে এবং x402 মাইক্রোপেমেন্ট ব্যবহার করে Solana-এ পরিশোধ করে। প্রতিটি লেনদেন বাস্তব এবং অন-চেইনে নিশ্চিত করা হয়।","meta_og_description": "দুটি 3D AI এজেন্ট বাস্তব USDC এর জন্য ক্রিপ্টো বুদ্ধিমত্তা কিনছে এবং বিক্রি করছে Solana। প্রতিটি লেনদেন চেইনে নিশ্চিত হচ্ছে।",- "meta_og_title": "এজেন্ট এক্সচেঞ্জ — AI এজেন্টরা বাস্তব সময়ে একে অপরকে অর্থ প্রদান করছে",- "meta_title": "এজেন্ট এক্সচেঞ্জ — 3D AI এজেন্টরা বাস্তব সময়ে একে অপরকে অর্থ প্রদান করছে · three.ws",+ "meta_og_title": "এজেন্ট এক্সচেঞ্জ: AI এজেন্টরা বাস্তব সময়ে একে অপরকে অর্থ প্রদান করছে",+ "meta_title": "এজেন্ট এক্সচেঞ্জ: 3D AI এজেন্টরা বাস্তব সময়ে একে অপরকে অর্থ প্রদান করছে · three.ws","meta_twitter_description": "দুটি 3D AI এজেন্ট বাস্তব ক্রিপ্টো বুদ্ধিমত্তার জন্য একে অপরকে অর্থ প্রদান করছে। USDC Solana এ। চেইনে।",- "meta_twitter_title": "এজেন্ট এক্সচেঞ্জ — AI এজেন্টরা বাস্তব সময়ে একে অপরকে অর্থ প্রদান করছে",+ "meta_twitter_title": "এজেন্ট এক্সচেঞ্জ: AI এজেন্টরা বাস্তব সময়ে একে অপরকে অর্থ প্রদান করছে","seller": "বিক্রেতা","session_total_0_00_usdc_settled_on": "সেশনের মোট: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC চেইনে নিষ্পত্তি","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 পে-প্রতি-কল ডেমো",- "x402_the_payment_trust_layer_title": "x402 — এই নিষ্পত্তির পেছনের পেমেন্ট ট্রাস্ট লেয়ার"+ "x402_the_payment_trust_layer_title": "x402: এই নিষ্পত্তির পেছনের পেমেন্ট ট্রাস্ট লেয়ার"},"agent_identities": {"1_call_create_identity": "1 · পরিচয় তৈরি করার জন্য কল করুন",diff --git a/public/locales/bs.json b/public/locales/bs.jsonindex 815e2bb7c..7d7a64f28 100644--- a/public/locales/bs.json+++ b/public/locales/bs.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Razmjena agenata",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kupi informacije — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kupi informacije · $0.01 USDC</span>","buy_intel_on": "Kupi informacije o:","buyer": "KUPAC","buyer_agent": "Agent kupac","intel_agent": "Agent za informacije","meta_description": "Dva AI agenta s 3D tijelima pregovaraju i plaćaju jedni drugima za kripto informacije uživo koristeći x402 mikroplaćanja na Solana. Svaka transakcija je stvarna i potvrđena na lancu.","meta_og_description": "Dva 3D AI agenta kupuju i prodaju kripto informacije za stvarni USDC na Solana. Gledajte kako se svaka transakcija potvrđuje na lancu.",- "meta_og_title": "Razmjena agenata — AI agenti plaćaju jedni drugima u stvarnom vremenu",- "meta_title": "Razmjena agenata — 3D AI agenti plaćaju jedni drugima u stvarnom vremenu · three.ws",+ "meta_og_title": "Razmjena agenata: AI agenti plaćaju jedni drugima u stvarnom vremenu",+ "meta_title": "Razmjena agenata: 3D AI agenti plaćaju jedni drugima u stvarnom vremenu · three.ws","meta_twitter_description": "Dva 3D AI agenta plaćaju jedni drugima za stvarne kripto informacije. USDC na Solana. Na lancu.",- "meta_twitter_title": "Razmjena agenata — AI agenti plaćaju jedni drugima u stvarnom vremenu",+ "meta_twitter_title": "Razmjena agenata: AI agenti plaćaju jedni drugima u stvarnom vremenu","seller": "PRODAVAC","session_total_0_00_usdc_settled_on": "Ukupno sesije: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC poravnato na lancu","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo plaćanja po pozivu",- "x402_the_payment_trust_layer_title": "x402 — sloj povjerenja za plaćanja iza ovih poravnanja"+ "x402_the_payment_trust_layer_title": "x402: sloj povjerenja za plaćanja iza ovih poravnanja"},"agent_identities": {"1_call_create_identity": "1 · Pozovite create_identity",diff --git a/public/locales/ca.json b/public/locales/ca.jsonindex c5fc9b869..0912ab17f 100644--- a/public/locales/ca.json+++ b/public/locales/ca.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Intercanvi d'agents",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Comprar intel·ligència — 0,01 $ USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Comprar intel·ligència · 0,01 $ USDC</span>","buy_intel_on": "Comprar intel·ligència sobre:","buyer": "COMPRADOR","buyer_agent": "Agent comprador","intel_agent": "Agent d'intel·ligència","meta_description": "Dos agents d'IA amb cossos 3D negocien i es paguen mútuament per intel·ligència cripto en temps real utilitzant micropagaments x402 a Solana. Cada transacció és real i es confirma a la cadena.","meta_og_description": "Dos agents d'IA 3D compren i venen intel·ligència cripto per USDC real a Solana. Observa com cada transacció es confirma a la cadena.",- "meta_og_title": "Intercanvi d'agents — Agents d'IA que es paguen mútuament en temps real",- "meta_title": "Intercanvi d'agents — Agents d'IA 3D que es paguen mútuament en temps real · three.ws",+ "meta_og_title": "Intercanvi d'agents: Agents d'IA que es paguen mútuament en temps real",+ "meta_title": "Intercanvi d'agents: Agents d'IA 3D que es paguen mútuament en temps real · three.ws","meta_twitter_description": "Dos agents d'IA 3D que es paguen mútuament per intel·ligència cripto real. USDC a Solana. A la cadena.",- "meta_twitter_title": "Intercanvi d'agents — Agents d'IA que es paguen mútuament en temps real",+ "meta_twitter_title": "Intercanvi d'agents: Agents d'IA que es paguen mútuament en temps real","seller": "VENEDOR","session_total_0_00_usdc_settled_on": "Total de la sessió: <span class=\"tv\" id=\"totalUsdc\">0,00 $ </span>USDC liquidat a la cadena","three_ws": "three.ws","x402_pay_per_call_demo_title": "Demo de pagament per trucada x402",- "x402_the_payment_trust_layer_title": "x402 — la capa de confiança de pagament darrere d'aquestes liquidacions"+ "x402_the_payment_trust_layer_title": "x402: la capa de confiança de pagament darrere d'aquestes liquidacions"},"agent_identities": {"1_call_create_identity": "1 · Invoca `create_identity`",diff --git a/public/locales/cs.json b/public/locales/cs.jsonindex 5feb36df1..18a017a2f 100644--- a/public/locales/cs.json+++ b/public/locales/cs.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agent Exchange",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Koupit intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Koupit intel · $0.01 USDC</span>","buy_intel_on": "Koupit intel na:","buyer": "KUPUJÍCÍ","buyer_agent": "Kupující agent","intel_agent": "Intel agent","meta_description": "Dva AI agenti s 3D těly vyjednávají a platí si navzájem za živé krypto intel pomocí x402 mikroplateb na Solana. Každá transakce je skutečná a potvrzená na řetězci.","meta_og_description": "Dva 3D AI agenti kupují a prodávají krypto intel za skutečné USDC na Solana. Sledujte, jak se každá transakce potvrzuje na řetězci.",- "meta_og_title": "Agent Exchange — AI agenti si navzájem platí v reálném čase",- "meta_title": "Agent Exchange — 3D AI agenti si navzájem platí v reálném čase · three.ws",+ "meta_og_title": "Agent Exchange: AI agenti si navzájem platí v reálném čase",+ "meta_title": "Agent Exchange: 3D AI agenti si navzájem platí v reálném čase · three.ws","meta_twitter_description": "Dva 3D AI agenti si navzájem platí za skutečný krypto intel. USDC na Solana. Na řetězci.",- "meta_twitter_title": "Agent Exchange — AI agenti si navzájem platí v reálném čase",+ "meta_twitter_title": "Agent Exchange: AI agenti si navzájem platí v reálném čase","seller": "PRODÁVAJÍCÍ","session_total_0_00_usdc_settled_on": "Celkový součet relace: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC vyrovnáno na řetězci","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo placení za hovor",- "x402_the_payment_trust_layer_title": "x402 — vrstva důvěry v platby za těmito vyrovnáními"+ "x402_the_payment_trust_layer_title": "x402: vrstva důvěry v platby za těmito vyrovnáními"},"agent_identities": {"1_call_create_identity": "1 · Zavolejte create_identity",diff --git a/public/locales/cy.json b/public/locales/cy.jsonindex 6ac035ef9..ea9179573 100644--- a/public/locales/cy.json+++ b/public/locales/cy.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Cyfnewidfa Asiant",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Prynu cudd-wybodaeth — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Prynu cudd-wybodaeth · $0.01 USDC</span>","buy_intel_on": "Prynu cudd-wybodaeth ar:","buyer": "PRYNNWR","buyer_agent": "Asiant Prynwr","intel_agent": "Asiant Cudd-wybodaeth","meta_description": "Dau asiant AI gyda chorff 3D yn negodi ac yn talu ei gilydd am gudd-wybodaeth crypto byw gan ddefnyddio microdaliadau x402 ar Solana. Mae pob trafodiad yn real ac wedi'i gadarnhau ar-gadwyn.","meta_og_description": "Dau asiant AI 3D yn prynu a gwerthu cudd-wybodaeth crypto am USDC go iawn ar Solana. Gwyliwch bob trafodiad yn cadarnhau ar-gadwyn.",- "meta_og_title": "Cyfnewidfa Asiant — Asiantau AI yn talu ei gilydd mewn amser real",- "meta_title": "Cyfnewidfa Asiant — Asiantau AI 3D yn talu ei gilydd mewn amser real · three.ws",+ "meta_og_title": "Cyfnewidfa Asiant: Asiantau AI yn talu ei gilydd mewn amser real",+ "meta_title": "Cyfnewidfa Asiant: Asiantau AI 3D yn talu ei gilydd mewn amser real · three.ws","meta_twitter_description": "Dau asiant AI 3D yn talu ei gilydd am gudd-wybodaeth crypto go iawn. USDC ar Solana. Ar-gadwyn.",- "meta_twitter_title": "Cyfnewidfa Asiant — Asiantau AI yn talu ei gilydd mewn amser real",+ "meta_twitter_title": "Cyfnewidfa Asiant: Asiantau AI yn talu ei gilydd mewn amser real","seller": "GWERTHWR","session_total_0_00_usdc_settled_on": "Cyfanswm y sesiwn: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC wedi'i setlo ar-gadwyn","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo talu fesul galwad",- "x402_the_payment_trust_layer_title": "x402 — yr haen ymddiriedaeth taliadau y tu ôl i'r setliadau hyn"+ "x402_the_payment_trust_layer_title": "x402: yr haen ymddiriedaeth taliadau y tu ôl i'r setliadau hyn"},"agent_identities": {"1_call_create_identity": "1 · Galw create_identity",diff --git a/public/locales/da.json b/public/locales/da.jsonindex 95146729d..3ffa4620a 100644--- a/public/locales/da.json+++ b/public/locales/da.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agent Exchange",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Køb intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Køb intel · $0.01 USDC</span>","buy_intel_on": "Køb intel på:","buyer": "KØBER","buyer_agent": "Køber Agent","intel_agent": "Intel Agent","meta_description": "To AI-agenter med 3D-kroppe forhandler og betaler hinanden for live kryptointel ved hjælp af x402 mikrobetalinger på Solana. Hver transaktion er ægte og bekræftet on-chain.","meta_og_description": "To 3D AI-agenter køber og sælger kryptointel for ægte USDC på Solana. Se hver transaktion bekræftes on-chain.",- "meta_og_title": "Agent Exchange — AI-agenter, der betaler hinanden i realtid",- "meta_title": "Agent Exchange — 3D AI-agenter, der betaler hinanden i realtid · three.ws",+ "meta_og_title": "Agent Exchange: AI-agenter, der betaler hinanden i realtid",+ "meta_title": "Agent Exchange: 3D AI-agenter, der betaler hinanden i realtid · three.ws","meta_twitter_description": "To 3D AI-agenter, der betaler hinanden for ægte kryptointel. USDC på Solana. On-chain.",- "meta_twitter_title": "Agent Exchange — AI-agenter, der betaler hinanden i realtid",+ "meta_twitter_title": "Agent Exchange: AI-agenter, der betaler hinanden i realtid","seller": "SÆLGER","session_total_0_00_usdc_settled_on": "Session total: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC afregnet on-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 pay-per-call demo",- "x402_the_payment_trust_layer_title": "x402 — betalings tillidslagret bag disse afregninger"+ "x402_the_payment_trust_layer_title": "x402: betalings tillidslagret bag disse afregninger"},"agent_identities": {"1_call_create_identity": "1 · Ring opret identitet",diff --git a/public/locales/de.json b/public/locales/de.jsonindex 919bf027b..7256832a4 100644--- a/public/locales/de.json+++ b/public/locales/de.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agent Exchange",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Intel kaufen — $0,01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Intel kaufen · $0,01 USDC</span>","buy_intel_on": "Intel kaufen zu:","buyer": "KÄUFER","buyer_agent": "Käufer-Agent","intel_agent": "Intel-Agent","meta_description": "Zwei KI-Agenten mit 3D-Körpern verhandeln und bezahlen sich gegenseitig für aktuelle Krypto-Informationen mittels x402 Mikrozahlungen auf Solana. Jede Transaktion ist real und wird On-Chain bestätigt.","meta_og_description": "Zwei 3D-KI-Agenten kaufen und verkaufen Krypto-Informationen für echtes USDC auf Solana. Beobachten Sie, wie jede Transaktion On-Chain bestätigt wird.",- "meta_og_title": "Agent Exchange — KI-Agenten bezahlen sich gegenseitig in Echtzeit",- "meta_title": "Agent Exchange — 3D-KI-Agenten bezahlen sich gegenseitig in Echtzeit · three.ws",+ "meta_og_title": "Agent Exchange: KI-Agenten bezahlen sich gegenseitig in Echtzeit",+ "meta_title": "Agent Exchange: 3D-KI-Agenten bezahlen sich gegenseitig in Echtzeit · three.ws","meta_twitter_description": "Zwei 3D-KI-Agenten bezahlen sich gegenseitig für echte Krypto-Informationen. USDC auf Solana. On-Chain.",- "meta_twitter_title": "Agent Exchange — KI-Agenten bezahlen sich gegenseitig in Echtzeit",+ "meta_twitter_title": "Agent Exchange: KI-Agenten bezahlen sich gegenseitig in Echtzeit","seller": "VERKÄUFER","session_total_0_00_usdc_settled_on": "Sitzung gesamt: <span class=\"tv\" id=\"totalUsdc\">$0,00</span> USDC On-Chain abgewickelt","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 Pay-per-Call-Demo",- "x402_the_payment_trust_layer_title": "x402 — die Zahlungs-Vertrauensschicht hinter diesen Abwicklungen"+ "x402_the_payment_trust_layer_title": "x402: die Zahlungs-Vertrauensschicht hinter diesen Abwicklungen"},"agent_identities": {"1_call_create_identity": "1 · create_identity aufrufen",diff --git a/public/locales/el.json b/public/locales/el.jsonindex 6f3145896..f50170929 100644--- a/public/locales/el.json+++ b/public/locales/el.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span> Ανταλλαγή Agents",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\"> Αγορά πληροφοριών — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\"> Αγορά πληροφοριών · $0.01 USDC</span>","buy_intel_on": "Αγορά πληροφοριών σε:","buyer": "ΑΓΟΡΑΣΤΗΣ","buyer_agent": "Agent Αγοραστής","intel_agent": "Agent Πληροφοριών","meta_description": "Δύο AI agents με 3D σώματα διαπραγματεύονται και πληρώνουν ο ένας τον άλλον για ζωντανές πληροφορίες κρυπτονομισμάτων χρησιμοποιώντας x402 μικροπληρωμές στο Solana. Κάθε συναλλαγή είναι πραγματική και επιβεβαιωμένη on-chain.","meta_og_description": "Δύο 3D AI agents αγοράζουν και πωλούν πληροφορίες κρυπτονομισμάτων για πραγματικά USDC στο Solana. Παρακολουθήστε κάθε συναλλαγή να επιβεβαιώνεται on-chain.",- "meta_og_title": "Ανταλλαγή Agents — AI agents που πληρώνουν ο ένας τον άλλον σε πραγματικό χρόνο",- "meta_title": "Ανταλλαγή Agents — 3D AI agents που πληρώνουν ο ένας τον άλλον σε πραγματικό χρόνο · three.ws",+ "meta_og_title": "Ανταλλαγή Agents: AI agents που πληρώνουν ο ένας τον άλλον σε πραγματικό χρόνο",+ "meta_title": "Ανταλλαγή Agents: 3D AI agents που πληρώνουν ο ένας τον άλλον σε πραγματικό χρόνο · three.ws","meta_twitter_description": "Δύο 3D AI agents πληρώνουν ο ένας τον άλλον για πραγματικές πληροφορίες κρυπτονομισμάτων. USDC στο Solana. On-chain.",- "meta_twitter_title": "Ανταλλαγή Agents — AI agents που πληρώνουν ο ένας τον άλλον σε πραγματικό χρόνο",+ "meta_twitter_title": "Ανταλλαγή Agents: AI agents που πληρώνουν ο ένας τον άλλον σε πραγματικό χρόνο","seller": "ΠΩΛΗΤΗΣ","session_total_0_00_usdc_settled_on": "Συνολικός όγκος συνεδρίας: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC διακανονισμένα on-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 επί πληρωμή ανά κλήση demo",- "x402_the_payment_trust_layer_title": "x402 — το επίπεδο εμπιστοσύνης πληρωμών πίσω από αυτούς τους διακανονισμούς"+ "x402_the_payment_trust_layer_title": "x402: το επίπεδο εμπιστοσύνης πληρωμών πίσω από αυτούς τους διακανονισμούς"},"agent_identities": {"1_call_create_identity": "1 · Κλήση δημιουργίας ταυτότητας",diff --git a/public/locales/en.json b/public/locales/en.jsonindex d44ea92c3..99f17a4f6 100644--- a/public/locales/en.json+++ b/public/locales/en.json@@ -167,16 +167,33 @@},"agenc_room": {"agenc_task_room": "AgenC task room",+ "cluster_label": "Solana cluster",+ "creator_label": "Creator wallet, base58",+ "creator_placeholder": "creator wallet (base58)","devnet": "devnet",+ "empty_title": "No tasks from this wallet yet",+ "err_network_title": "Could not reach the task bridge",+ "err_request_title": "That request could not be read",+ "err_upstream_title": "Solana is not answering right now",+ "idle_body": "Paste a creator wallet to render every task it has posted on AgenC as an embodied avatar, each one animated by its live on-chain state.",+ "idle_commons": "See the Commons working",+ "idle_docs": "How to post a task",+ "idle_title": "Watch a creator's tasks come alive","load": "Load","mainnet": "mainnet",- "meta_description": "A live 3D room where AgenC tasks become visible agents. Each open task on the AgenC coordination protocol gets a body, animated by its on-chain state.",- "meta_og_description": "A live room where autonomous agents discover open work, bid for it, and settle on-chain — the labor market up close.",+ "meta_description": "A live room where autonomous agents discover open work, bid for it, and settle on-chain: every AgenC task renders as an agent driven by its chain state.",+ "meta_og_description": "A live room where autonomous agents discover open work, bid for it, and settle on-chain: the labor market up close.","meta_og_title": "AgenC · Task Room · three.ws",- "meta_title": "AgenC task room — three.ws",- "meta_twitter_description": "A live room where autonomous agents discover open work, bid for it, and settle on-chain — the labor market up close.",+ "meta_title": "AgenC task room · three.ws",+ "meta_twitter_description": "A live room where autonomous agents discover open work, bid for it, and settle on-chain: the labor market up close.","meta_twitter_title": "AgenC · Task Room · three.ws",- "on_chain_task_feed_agenc_tech": "on-chain task feed · <a href=\"https://agenc.tech\" target=\"_blank\" rel=\"noopener\">agenc.tech</a>"+ "nav_aria": "Related AgenC pages",+ "nav_commons": "the Commons",+ "nav_docs": "docs",+ "nav_embodied": "embodied demo",+ "on_chain_task_feed_agenc_tech": "on-chain task feed · <a href=\"https://agenc.tech\" target=\"_blank\" rel=\"noopener\">agenc.tech</a>",+ "retry": "Retry",+ "switch_cluster": "Try the other cluster"},"agent_badge": {"meta_title": "Agent badge"@@ -460,18 +477,18 @@"agent_economy": {"agent_economy": "<span class=\"live-dot\"></span> Agent Economy","agent_to_agent_value_transfer_solana": "Agent-to-agent value transfer · Solana",- "buy_market_analysis_from_ora_arialabel": "Buy Market Analysis from Oracle for $0.001 — live sentiment and trend read",- "buy_on_chain_insight_from_or_arialabel": "Buy On-Chain Insight from Oracle for $0.002 — wallet activity and holder data",- "buy_risk_score_from_oracle_f_arialabel": "Buy Risk Score from Oracle for $0.003 — AI-generated protocol rating",+ "buy_market_analysis_from_ora_arialabel": "Buy Market Analysis from Oracle for $0.001, live sentiment and trend read",+ "buy_on_chain_insight_from_or_arialabel": "Buy On-Chain Insight from Oracle for $0.002, wallet activity and holder data",+ "buy_risk_score_from_oracle_f_arialabel": "Buy Risk Score from Oracle for $0.003, AI-generated protocol rating","galaxy_showcase": "Galaxy showcase","meta_description": "Watch two 3D AI agents transact on-chain. Agent A buys data from Agent B. Real SOL. Real Solana transaction. Live now.","meta_og_description": "Watch two 3D AI agents transact on-chain. Agent A buys data from Agent B. Real SOL. Real Solana transaction. Live now.",- "meta_og_title": "Agent Economy — three.ws live demo",- "meta_title": "Agent Economy — three.ws live demo",+ "meta_og_title": "Agent Economy: two AI agents paying each other in real SOL",+ "meta_title": "Agent Economy: two AI agents paying each other in real SOL","meta_twitter_description": "Watch two 3D AI agents transact on-chain. Agent A buys data from Agent B. Real SOL. Real Solana transaction. Live now.",- "meta_twitter_title": "Agent Economy — three.ws live demo",+ "meta_twitter_title": "Agent Economy: two AI agents paying each other in real SOL","pick_a_service_above_to_watch_the": "Pick a service above to watch the agents transact",- "ready_select_a_service_to_start": "Ready — select a service to start",+ "ready_select_a_service_to_start": "Ready. Select a service to start.","three_ws": "three.ws","x402_bazaar": "x402 Bazaar"},@@ -773,23 +790,23 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agent Exchange",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Buy intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Buy intel · $0.01 USDC</span>","buy_intel_on": "Buy intel on:","buyer": "BUYER","buyer_agent": "Buyer Agent","intel_agent": "Intel Agent","meta_description": "Two AI agents with 3D bodies negotiate and pay each other for live crypto intel using x402 micropayments on Solana. Every transaction is real and confirmed on-chain.","meta_og_description": "Two 3D AI agents buy and sell crypto intel for real USDC on Solana. Watch every transaction confirm on-chain.",- "meta_og_title": "Agent Exchange — AI agents paying each other in real time",- "meta_title": "Agent Exchange — 3D AI agents paying each other in real time · three.ws",+ "meta_og_title": "Agent Exchange: AI agents paying each other in real time",+ "meta_title": "Agent Exchange: 3D AI agents paying each other in real time · three.ws","meta_twitter_description": "Two 3D AI agents paying each other for real crypto intel. USDC on Solana. On-chain.",- "meta_twitter_title": "Agent Exchange — AI agents paying each other in real time",+ "meta_twitter_title": "Agent Exchange: AI agents paying each other in real time","page_heading": "Agent Exchange: two 3D AI agents buying and selling live crypto intel for real USDC on Solana","seller": "SELLER","session_total_0_00_usdc_settled_on": "Session total: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC settled on-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 pay-per-call demo",- "x402_the_payment_trust_layer_title": "x402 — the payment trust layer behind these settlements"+ "x402_the_payment_trust_layer_title": "x402: the payment trust layer behind these settlements"},"agent_identities": {"1_call_create_identity": "1 · Call create_identity",diff --git a/public/locales/es.json b/public/locales/es.jsonindex bd275d005..40ea741b2 100644--- a/public/locales/es.json+++ b/public/locales/es.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agent Exchange",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Comprar inteligencia — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Comprar inteligencia · $0.01 USDC</span>","buy_intel_on": "Comprar inteligencia sobre:","buyer": "COMPRADOR","buyer_agent": "Agente Comprador","intel_agent": "Agente de Inteligencia","meta_description": "Dos agentes de IA con cuerpos 3D negocian y se pagan entre sí por inteligencia cripto en vivo usando micropagos x402 en Solana. Cada transacción es real y se confirma on-chain.","meta_og_description": "Dos agentes de IA 3D compran y venden inteligencia cripto por USDC real en Solana. Observa cómo cada transacción se confirma on-chain.",- "meta_og_title": "Agent Exchange — Agentes de IA pagándose entre sí en tiempo real",- "meta_title": "Agent Exchange — Agentes de IA 3D pagándose entre sí en tiempo real · three.ws",+ "meta_og_title": "Agent Exchange: Agentes de IA pagándose entre sí en tiempo real",+ "meta_title": "Agent Exchange: Agentes de IA 3D pagándose entre sí en tiempo real · three.ws","meta_twitter_description": "Dos agentes de IA 3D se pagan entre sí por inteligencia cripto real. USDC en Solana. On-chain.",- "meta_twitter_title": "Agent Exchange — Agentes de IA pagándose entre sí en tiempo real",+ "meta_twitter_title": "Agent Exchange: Agentes de IA pagándose entre sí en tiempo real","seller": "VENDEDOR","session_total_0_00_usdc_settled_on": "Total de la sesión: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC liquidado on-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demostración de pago por llamada",- "x402_the_payment_trust_layer_title": "x402 — la capa de confianza de pagos detrás de estas liquidaciones"+ "x402_the_payment_trust_layer_title": "x402: la capa de confianza de pagos detrás de estas liquidaciones"},"agent_identities": {"1_call_create_identity": "1 · Llamar a create_identity",diff --git a/public/locales/et.json b/public/locales/et.jsonindex b25ef604d..6c4214307 100644--- a/public/locales/et.json+++ b/public/locales/et.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agentide vahetus",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Osta infot — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Osta infot · $0.01 USDC</span>","buy_intel_on": "Osta infot teemal:","buyer": "OSTJA","buyer_agent": "Ostja agent","intel_agent": "Infoagent","meta_description": "Kaks 3D kehaga AI agenti kauplevad ja maksavad üksteisele reaalajas krüptoinfo eest, kasutades x402 mikromakseid Solana platvormil. Iga tehing on reaalne ja kinnitatud plokiahelas.","meta_og_description": "Kaks 3D AI agenti ostavad ja müüvad krüptoinfot päris USDC eest Solana platvormil. Vaata, kuidas iga tehing plokiahelas kinnitatakse.",- "meta_og_title": "Agentide vahetus — AI agendid maksavad üksteisele reaalajas",- "meta_title": "Agentide vahetus — 3D AI agendid maksavad üksteisele reaalajas · three.ws",+ "meta_og_title": "Agentide vahetus: AI agendid maksavad üksteisele reaalajas",+ "meta_title": "Agentide vahetus: 3D AI agendid maksavad üksteisele reaalajas · three.ws","meta_twitter_description": "Kaks 3D AI agenti maksavad üksteisele päris krüptoinfo eest. USDC Solana platvormil. Plokiahelas.",- "meta_twitter_title": "Agentide vahetus — AI agendid maksavad üksteisele reaalajas",+ "meta_twitter_title": "Agentide vahetus: AI agendid maksavad üksteisele reaalajas","seller": "MÜÜJA","session_total_0_00_usdc_settled_on": "Sessiooni kokku: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC arveldatud plokiahelas","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 tasuline kõnedemo",- "x402_the_payment_trust_layer_title": "x402 — maksete usalduskiht nende arvelduste taga"+ "x402_the_payment_trust_layer_title": "x402: maksete usalduskiht nende arvelduste taga"},"agent_identities": {"1_call_create_identity": "1 · Kutsu create_identity",diff --git a/public/locales/eu.json b/public/locales/eu.jsonindex a6daf7d5f..6e2c21d00 100644--- a/public/locales/eu.json+++ b/public/locales/eu.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agente Trukea",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Erosi intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Erosi intel · $0.01 USDC</span>","buy_intel_on": "Erosi intel honi buruz:","buyer": "EROSLEA","buyer_agent": "Agente Eroslea","intel_agent": "Intel Agentea","meta_description": "3D gorputzak dituzten bi AI agentek elkarrekin negoziatzen eta ordaintzen dute zuzeneko kripto intelagatik, x402 mikropaguen bidez Solana-n. Transakzio guztiak benetakoak dira eta katean berresten dira.","meta_og_description": "Bi 3D AI agentek kripto intel erreala erosi eta saltzen dute USDC-rekin Solana-n. Ikusi transakzio guztiak katean berresten.",- "meta_og_title": "Agente Trukea — AI agenteak elkarri denbora errealean ordaintzen",- "meta_title": "Agente Trukea — 3D AI agenteak elkarri denbora errealean ordaintzen · three.ws",+ "meta_og_title": "Agente Trukea: AI agenteak elkarri denbora errealean ordaintzen",+ "meta_title": "Agente Trukea: 3D AI agenteak elkarri denbora errealean ordaintzen · three.ws","meta_twitter_description": "Bi 3D AI agentek elkarri ordaintzen diote benetako kripto intelagatik. USDC Solana-n. Katean.",- "meta_twitter_title": "Agente Trukea — AI agenteak elkarri denbora errealean ordaintzen",+ "meta_twitter_title": "Agente Trukea: AI agenteak elkarri denbora errealean ordaintzen","seller": "SALTZAILEA","session_total_0_00_usdc_settled_on": "Saioaren guztizkoa: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC katean finkatuta","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 deialdi bakoitzeko ordainketa demoa",- "x402_the_payment_trust_layer_title": "x402 — the payment trust layer behind these settlements"+ "x402_the_payment_trust_layer_title": "x402: the payment trust layer behind these settlements"},"agent_identities": {"1_call_create_identity": "1 · Deitu create_identity",diff --git a/public/locales/fa.json b/public/locales/fa.jsonindex 6ee3a5b0c..161ae9d7f 100644--- a/public/locales/fa.json+++ b/public/locales/fa.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>تبادل عامل",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">خرید اطلاعات — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">خرید اطلاعات · $0.01 USDC</span>","buy_intel_on": "خرید اطلاعات در:","buyer": "خریدار","buyer_agent": "عامل خریدار","intel_agent": "عامل اطلاعات","meta_description": "دو عامل هوش مصنوعی با بدنهای 3D برای اطلاعات زنده کریپتو با استفاده از پرداختهای خرد x402 بر روی Solana مذاکره و پرداخت میکنند. هر تراکنش واقعی و تأیید شده بر روی زنجیره است.","meta_og_description": "دو عامل هوش مصنوعی 3D اطلاعات کریپتو را برای USDC واقعی بر روی Solana خرید و فروش میکنند. هر تراکنش را بر روی زنجیره تأیید کنید.",- "meta_og_title": "تبادل عامل — عوامل هوش مصنوعی که به طور همزمان به یکدیگر پرداخت میکنند",- "meta_title": "تبادل عامل — عوامل هوش مصنوعی 3D که به طور همزمان به یکدیگر پرداخت میکنند · three.ws",+ "meta_og_title": "تبادل عامل: عوامل هوش مصنوعی که به طور همزمان به یکدیگر پرداخت میکنند",+ "meta_title": "تبادل عامل: عوامل هوش مصنوعی 3D که به طور همزمان به یکدیگر پرداخت میکنند · three.ws","meta_twitter_description": "دو عامل هوش مصنوعی 3D که به یکدیگر برای اطلاعات واقعی کریپتو پرداخت میکنند. USDC بر روی Solana. بر روی زنجیره.",- "meta_twitter_title": "تبادل عامل — عوامل هوش مصنوعی که به طور همزمان به یکدیگر پرداخت میکنند",+ "meta_twitter_title": "تبادل عامل: عوامل هوش مصنوعی که به طور همزمان به یکدیگر پرداخت میکنند","seller": "فروشنده","session_total_0_00_usdc_settled_on": "جمع کل جلسه: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC تسویه شده بر روی زنجیره","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 دمو پرداخت به ازای تماس",- "x402_the_payment_trust_layer_title": "x402 — لایه اعتماد پرداخت پشت این تسویهها"+ "x402_the_payment_trust_layer_title": "x402: لایه اعتماد پرداخت پشت این تسویهها"},"agent_identities": {"1_call_create_identity": "1 · تماس برای ایجاد هویت",diff --git a/public/locales/fi.json b/public/locales/fi.jsonindex e3e494f7c..089a58835 100644--- a/public/locales/fi.json+++ b/public/locales/fi.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agentti Vaihto",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Osta tietoa — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Osta tietoa · $0.01 USDC</span>","buy_intel_on": "Osta tietoa:","buyer": "OSTAJA","buyer_agent": "Ostaja Agentti","intel_agent": "Tieto Agentti","meta_description": "Kaksi AI-agenttia, joilla on 3D-kehot, neuvottelevat ja maksavat toisilleen live-krypto tietoa käyttäen x402 mikromaksuja Solana. Jokainen transaktio on todellinen ja vahvistettu ketjussa.","meta_og_description": "Kaksi 3D AI-agenttia ostaa ja myy krypto tietoa oikealla USDC Solana. Katso jokainen transaktio vahvistettuna ketjussa.",- "meta_og_title": "Agentti Vaihto — AI-agentit maksavat toisilleen reaaliajassa",- "meta_title": "Agentti Vaihto — 3D AI-agentit maksavat toisilleen reaaliajassa · three.ws",+ "meta_og_title": "Agentti Vaihto: AI-agentit maksavat toisilleen reaaliajassa",+ "meta_title": "Agentti Vaihto: 3D AI-agentit maksavat toisilleen reaaliajassa · three.ws","meta_twitter_description": "Kaksi 3D AI-agenttia maksavat toisilleen oikeasta krypto tiedosta. USDC Solana. Ketjussa.",- "meta_twitter_title": "Agentti Vaihto — AI-agentit maksavat toisilleen reaaliajassa",+ "meta_twitter_title": "Agentti Vaihto: AI-agentit maksavat toisilleen reaaliajassa","seller": "MYYJÄ","session_total_0_00_usdc_settled_on": "Istunnon yhteensä: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC selvitetty ketjussa","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 maksullinen demo",- "x402_the_payment_trust_layer_title": "x402 — maksujen luottamustaso näiden selvitysten takana"+ "x402_the_payment_trust_layer_title": "x402: maksujen luottamustaso näiden selvitysten takana"},"agent_identities": {"1_call_create_identity": "1 · Kutsu luo_identiteetti",diff --git a/public/locales/fil.json b/public/locales/fil.jsonindex 04a95c6af..0ae51b6b2 100644--- a/public/locales/fil.json+++ b/public/locales/fil.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Palitan ng Ahente",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Bumili ng intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Bumili ng intel · $0.01 USDC</span>","buy_intel_on": "Bumili ng intel sa:","buyer": "BUMILI","buyer_agent": "Ahente ng Mamimili","intel_agent": "Intel Agent","meta_description": "Dalawang AI agents na may 3D na katawan ang nakikipag-ayos at nagbabayad sa isa't isa para sa live na crypto intel gamit ang x402 micropayments sa Solana. Bawat transaksyon ay totoo at nakumpirma sa on-chain.","meta_og_description": "Dalawang 3D AI agents ang bumibili at nagbebenta ng crypto intel para sa totoong USDC sa Solana. Panuorin ang bawat transaksyon na nakumpirma sa on-chain.",- "meta_og_title": "Agent Exchange — AI agents na nagbabayad sa isa't isa sa real time",- "meta_title": "Agent Exchange — 3D AI agents na nagbabayad sa isa't isa sa real time · three.ws",+ "meta_og_title": "Agent Exchange: AI agents na nagbabayad sa isa't isa sa real time",+ "meta_title": "Agent Exchange: 3D AI agents na nagbabayad sa isa't isa sa real time · three.ws","meta_twitter_description": "Dalawang 3D AI agents na nagbabayad sa isa't isa para sa totoong crypto intel. USDC sa Solana. On-chain.",- "meta_twitter_title": "Agent Exchange — AI agents na nagbabayad sa isa't isa sa real time",+ "meta_twitter_title": "Agent Exchange: AI agents na nagbabayad sa isa't isa sa real time","seller": "MANGBEBENTA","session_total_0_00_usdc_settled_on": "Kabuuan ng sesyon: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC settled on-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 pay-per-call demo",- "x402_the_payment_trust_layer_title": "x402 — ang payment trust layer sa likod ng mga kasunduang ito"+ "x402_the_payment_trust_layer_title": "x402: ang payment trust layer sa likod ng mga kasunduang ito"},"agent_identities": {"1_call_create_identity": "1 · Tumawag upang lumikha ng pagkakakilanlan",diff --git a/public/locales/fr.json b/public/locales/fr.jsonindex 46d8992b4..8595c851b 100644--- a/public/locales/fr.json+++ b/public/locales/fr.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Bourse d'agents",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Acheter des infos — 0,01 $ USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Acheter des infos · 0,01 $ USDC</span>","buy_intel_on": "Acheter des infos sur :","buyer": "ACHETEUR","buyer_agent": "Agent acheteur","intel_agent": "Agent d'infos","meta_description": "Deux agents IA avec des corps 3D négocient et se paient mutuellement pour des informations crypto en temps réel via des micropaiements x402 sur Solana. Chaque transaction est réelle et confirmée on-chain.","meta_og_description": "Deux agents IA 3D achètent et vendent des informations crypto contre de vrais USDC sur Solana. Suivez chaque transaction se confirmer on-chain.",- "meta_og_title": "Bourse d'agents — Des agents IA se payant mutuellement en temps réel",- "meta_title": "Bourse d'agents — Des agents IA 3D se payant mutuellement en temps réel · three.ws",+ "meta_og_title": "Bourse d'agents: Des agents IA se payant mutuellement en temps réel",+ "meta_title": "Bourse d'agents: Des agents IA 3D se payant mutuellement en temps réel · three.ws","meta_twitter_description": "Deux agents IA 3D se payant mutuellement pour de vraies informations crypto. USDC sur Solana. On-chain.",- "meta_twitter_title": "Bourse d'agents — Des agents IA se payant mutuellement en temps réel",+ "meta_twitter_title": "Bourse d'agents: Des agents IA se payant mutuellement en temps réel","seller": "VENDEUR","session_total_0_00_usdc_settled_on": "Total de la session : <span class=\"tv\" id=\"totalUsdc\">0,00 $ </span>USDC réglé on-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 démo de paiement par appel",- "x402_the_payment_trust_layer_title": "x402 — la couche de confiance pour les paiements derrière ces règlements"+ "x402_the_payment_trust_layer_title": "x402: la couche de confiance pour les paiements derrière ces règlements"},"agent_identities": {"1_call_create_identity": "1 · Appeler create_identity",diff --git a/public/locales/ga.json b/public/locales/ga.jsonindex fdd517f7e..11e56f63d 100644--- a/public/locales/ga.json+++ b/public/locales/ga.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Malartú Gníomhairí",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Ceannaigh faisnéis — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Ceannaigh faisnéis · $0.01 USDC</span>","buy_intel_on": "Ceannaigh faisnéis ar:","buyer": "CEANNAITHEOIR","buyer_agent": "Gníomhaire Ceannaí","intel_agent": "Gníomhaire Faisnéise","meta_description": "Déanann dhá ghníomhaire AI le comhlachtaí 3D idirbheartaíocht agus íocann siad a chéile as faisnéis chripte bheo ag baint úsáide as micrea-íocaíochtaí x402 ar Solana. Tá gach idirbheart fíor agus deimhnithe ar an slabhra.","meta_og_description": "Ceannaíonn agus díolann dhá ghníomhaire AI 3D faisnéis chripte ar USDC fíor ar Solana. Féach ar gach idirbheart ag deimhniú ar an slabhra.",- "meta_og_title": "Malartú Gníomhairí — Gníomhairí AI ag íoc a chéile i bhfíor-am",- "meta_title": "Malartú Gníomhairí — Gníomhairí AI 3D ag íoc a chéile i bhfíor-am · three.ws",+ "meta_og_title": "Malartú Gníomhairí: Gníomhairí AI ag íoc a chéile i bhfíor-am",+ "meta_title": "Malartú Gníomhairí: Gníomhairí AI 3D ag íoc a chéile i bhfíor-am · three.ws","meta_twitter_description": "Dhá ghníomhaire AI 3D ag íoc a chéile as fíor-fhaisnéis chripte. USDC ar Solana. Ar an slabhra.",- "meta_twitter_title": "Malartú Gníomhairí — Gníomhairí AI ag íoc a chéile i bhfíor-am",+ "meta_twitter_title": "Malartú Gníomhairí: Gníomhairí AI ag íoc a chéile i bhfíor-am","seller": "DÍOLTÓIR","session_total_0_00_usdc_settled_on": "Iomlán an tseisiúin: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC socraithe ar an slabhra","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 taispeántas íoc-in-ghlao",- "x402_the_payment_trust_layer_title": "x402 — an ciseal iontaobhais íocaíochta taobh thiar de na socraíochtaí seo"+ "x402_the_payment_trust_layer_title": "x402: an ciseal iontaobhais íocaíochta taobh thiar de na socraíochtaí seo"},"agent_identities": {"1_call_create_identity": "1 · Glaoigh ar create_identity",diff --git a/public/locales/gl.json b/public/locales/gl.jsonindex e285dd350..23c5b69e0 100644--- a/public/locales/gl.json+++ b/public/locales/gl.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Intercambio de Axentes",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Comprar intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Comprar intel · $0.01 USDC</span>","buy_intel_on": "Comprar intel en:","buyer": "COMPRADOR","buyer_agent": "Axente Comprador","intel_agent": "Axente Intel","meta_description": "Dous axentes de IA con corpos 3D negocian e páganse mutuamente por intel de cripto en tempo real usando micropagamentos x402 en Solana. Cada transacción é real e confirmada na cadea.","meta_og_description": "Dous axentes de IA 3D compran e venden intel de cripto por USDC real en Solana. Observa como cada transacción se confirma na cadea.",- "meta_og_title": "Intercambio de Axentes — Axentes de IA pagándose mutuamente en tempo real",- "meta_title": "Intercambio de Axentes — Axentes de IA 3D pagándose mutuamente en tempo real · three.ws",+ "meta_og_title": "Intercambio de Axentes: Axentes de IA pagándose mutuamente en tempo real",+ "meta_title": "Intercambio de Axentes: Axentes de IA 3D pagándose mutuamente en tempo real · three.ws","meta_twitter_description": "Dous axentes de IA 3D pagándose mutuamente por intel de cripto real. USDC en Solana. Na cadea.",- "meta_twitter_title": "Intercambio de Axentes — Axentes de IA pagándose mutuamente en tempo real",+ "meta_twitter_title": "Intercambio de Axentes: Axentes de IA pagándose mutuamente en tempo real","seller": "VENDEDOR","session_total_0_00_usdc_settled_on": "Total da sesión: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC liquidado na cadea","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo de pago por chamada",- "x402_the_payment_trust_layer_title": "x402 — a capa de confianza de pago detrás destas liquidacións"+ "x402_the_payment_trust_layer_title": "x402: a capa de confianza de pago detrás destas liquidacións"},"agent_identities": {"1_call_create_identity": "1 · Chamar a create_identity",diff --git a/public/locales/gu.json b/public/locales/gu.jsonindex ea9d131f4..ed729c992 100644--- a/public/locales/gu.json+++ b/public/locales/gu.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>એજન્ટ એક્સચેન્જ",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ઇન્ટેલ ખરીદો — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ઇન્ટેલ ખરીદો · $0.01 USDC</span>","buy_intel_on": "આના પર ઇન્ટેલ ખરીદો:","buyer": "ખરીદનાર","buyer_agent": "ખરીદનાર એજન્ટ","intel_agent": "ઇન્ટેલ એજન્ટ","meta_description": "3D બોડીવાળા બે AI એજન્ટો Solana પર x402 માઇક્રોપેમેન્ટ્સનો ઉપયોગ કરીને લાઇવ ક્રિપ્ટો ઇન્ટેલ માટે વાટાઘાટ કરે છે અને એકબીજાને ચૂકવણી કરે છે. દરેક ટ્રાન્ઝેક્શન વાસ્તવિક છે અને ઓન-ચેઇન પર પુષ્ટિ થયેલ છે.","meta_og_description": "બે 3D AI એજન્ટો Solana પર વાસ્તવિક USDC માટે ક્રિપ્ટો ઇન્ટેલ ખરીદે છે અને વેચે છે. દરેક ટ્રાન્ઝેક્શનને ઓન-ચેઇન પર પુષ્ટિ થતી જુઓ.",- "meta_og_title": "એજન્ટ એક્સચેન્જ — AI એજન્ટો એકબીજાને રીઅલ ટાઇમમાં ચૂકવણી કરે છે",- "meta_title": "એજન્ટ એક્સચેન્જ — 3D AI એજન્ટો એકબીજાને રીઅલ ટાઇમમાં ચૂકવણી કરે છે · three.ws",+ "meta_og_title": "એજન્ટ એક્સચેન્જ: AI એજન્ટો એકબીજાને રીઅલ ટાઇમમાં ચૂકવણી કરે છે",+ "meta_title": "એજન્ટ એક્સચેન્જ: 3D AI એજન્ટો એકબીજાને રીઅલ ટાઇમમાં ચૂકવણી કરે છે · three.ws","meta_twitter_description": "બે 3D AI એજન્ટો વાસ્તવિક ક્રિપ્ટો ઇન્ટેલ માટે એકબીજાને ચૂકવણી કરે છે. Solana પર USDC. ઓન-ચેઇન.",- "meta_twitter_title": "એજન્ટ એક્સચેન્જ — AI એજન્ટો એકબીજાને રીઅલ ટાઇમમાં ચૂકવણી કરે છે",+ "meta_twitter_title": "એજન્ટ એક્સચેન્જ: AI એજન્ટો એકબીજાને રીઅલ ટાઇમમાં ચૂકવણી કરે છે","seller": "વેચનાર","session_total_0_00_usdc_settled_on": "સત્ર કુલ: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC ઓન-ચેઇન પર પતાવટ થઈ","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 પે-પર-કોલ ડેમો",- "x402_the_payment_trust_layer_title": "x402 — આ પતાવટ પાછળનું પેમેન્ટ ટ્રસ્ટ લેયર"+ "x402_the_payment_trust_layer_title": "x402: આ પતાવટ પાછળનું પેમેન્ટ ટ્રસ્ટ લેયર"},"agent_identities": {"1_call_create_identity": "1 · create_identity ને કૉલ કરો",diff --git a/public/locales/ha.json b/public/locales/ha.jsonindex a4d1958ce..ff28b946f 100644--- a/public/locales/ha.json+++ b/public/locales/ha.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Musayar Wakilai",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Sayi bayanan sirri — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Sayi bayanan sirri · $0.01 USDC</span>","buy_intel_on": "Sayi bayanan sirri game da:","buyer": "MAI SAYE","buyer_agent": "Wakili Mai Saye","intel_agent": "Wakili Mai Bayanan Sirri","meta_description": "Wakilan AI guda biyu masu jikin 3D suna tattaunawa da biyan juna don bayanan sirri na crypto kai tsaye ta amfani da ƙananan biyan kuɗi na x402 akan Solana. Kowane ma'amala gaskiya ce kuma an tabbatar da ita akan blockchain.","meta_og_description": "Wakilan AI na 3D guda biyu suna saye da siyar da bayanan sirri na crypto don ainihin USDC akan Solana. Kalli kowane ma'amala yana tabbata akan blockchain.",- "meta_og_title": "Musayar Wakilai — Wakilan AI suna biyan juna a ainihin lokaci",- "meta_title": "Musayar Wakilai — Wakilan AI na 3D suna biyan juna a ainihin lokaci · three.ws",+ "meta_og_title": "Musayar Wakilai: Wakilan AI suna biyan juna a ainihin lokaci",+ "meta_title": "Musayar Wakilai: Wakilan AI na 3D suna biyan juna a ainihin lokaci · three.ws","meta_twitter_description": "Wakilan AI na 3D guda biyu suna biyan juna don ainihin bayanan sirri na crypto. USDC akan Solana. Akan blockchain.",- "meta_twitter_title": "Musayar Wakilai — Wakilan AI suna biyan juna a ainihin lokaci",+ "meta_twitter_title": "Musayar Wakilai: Wakilan AI suna biyan juna a ainihin lokaci","seller": "MAI SIYARWA","session_total_0_00_usdc_settled_on": "Jimillar zaman: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC an daidaita akan blockchain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo na biya-kan-kira",- "x402_the_payment_trust_layer_title": "x402 — matakin amana na biyan kuɗi a bayan waɗannan daidaitawa"+ "x402_the_payment_trust_layer_title": "x402: matakin amana na biyan kuɗi a bayan waɗannan daidaitawa"},"agent_identities": {"1_call_create_identity": "1 · Kira create_identity",diff --git a/public/locales/he.json b/public/locales/he.jsonindex e94813051..6ee0b4731 100644--- a/public/locales/he.json+++ b/public/locales/he.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span> חילופי סוכנים",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\"> קנה אינטל — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\"> קנה אינטל · $0.01 USDC</span>","buy_intel_on": "קנה אינטל על:","buyer": "קונה","buyer_agent": "סוכן קונה","intel_agent": "סוכן אינטל","meta_description": "שני סוכני AI עם גופים תלת-ממדיים מנהלים משא ומתן ומשלמים זה לזה עבור אינטל קריפטו חי באמצעות x402 תשלומים מיקרו על Solana. כל עסקה היא אמיתית ומאושרת על הבלוקצ'יין.","meta_og_description": "שני סוכני AI תלת-ממדיים קונים ומוכרים אינטל קריפטו עבור USDC אמיתי על Solana. צפה בכל עסקה מאושרת על הבלוקצ'יין.",- "meta_og_title": "חילופי סוכנים — סוכני AI משלמים זה לזה בזמן אמת",- "meta_title": "חילופי סוכנים — סוכני AI תלת-ממדיים משלמים זה לזה בזמן אמת · three.ws",+ "meta_og_title": "חילופי סוכנים: סוכני AI משלמים זה לזה בזמן אמת",+ "meta_title": "חילופי סוכנים: סוכני AI תלת-ממדיים משלמים זה לזה בזמן אמת · three.ws","meta_twitter_description": "שני סוכני AI תלת-ממדיים משלמים זה לזה עבור אינטל קריפטו אמיתי. USDC על Solana. על הבלוקצ'יין.",- "meta_twitter_title": "חילופי סוכנים — סוכני AI משלמים זה לזה בזמן אמת",+ "meta_twitter_title": "חילופי סוכנים: סוכני AI משלמים זה לזה בזמן אמת","seller": "מוכר","session_total_0_00_usdc_settled_on": "סך הכל של המפגש: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC התנחלויות על הבלוקצ'יין","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 הדגמת תשלום לפי שיחה",- "x402_the_payment_trust_layer_title": "x402 — שכבת האמון בתשלום מאחורי התנחלויות אלו"+ "x402_the_payment_trust_layer_title": "x402: שכבת האמון בתשלום מאחורי התנחלויות אלו"},"agent_identities": {"1_call_create_identity": "1 · קרא create_identity",diff --git a/public/locales/hi.json b/public/locales/hi.jsonindex 60be256ac..510b5febe 100644--- a/public/locales/hi.json+++ b/public/locales/hi.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>एजेंट एक्सचेंज",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">इंटेल खरीदें — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">इंटेल खरीदें · $0.01 USDC</span>","buy_intel_on": "इस पर इंटेल खरीदें:","buyer": "खरीदार","buyer_agent": "खरीदार एजेंट","intel_agent": "इंटेल एजेंट","meta_description": "3D बॉडी वाले दो AI एजेंट Solana पर x402 माइक्रोपेमेंट का उपयोग करके लाइव क्रिप्टो इंटेल के लिए एक-दूसरे से बातचीत करते हैं और भुगतान करते हैं। हर लेनदेन वास्तविक है और ऑन-चेन पुष्टि की जाती है।","meta_og_description": "दो 3D AI एजेंट Solana पर वास्तविक USDC के लिए क्रिप्टो इंटेल खरीदते और बेचते हैं। हर लेनदेन को ऑन-चेन पुष्टि होते देखें।",- "meta_og_title": "एजेंट एक्सचेंज — AI एजेंट वास्तविक समय में एक-दूसरे को भुगतान कर रहे हैं",- "meta_title": "एजेंट एक्सचेंज — 3D AI एजेंट वास्तविक समय में एक-दूसरे को भुगतान कर रहे हैं · three.ws",+ "meta_og_title": "एजेंट एक्सचेंज: AI एजेंट वास्तविक समय में एक-दूसरे को भुगतान कर रहे हैं",+ "meta_title": "एजेंट एक्सचेंज: 3D AI एजेंट वास्तविक समय में एक-दूसरे को भुगतान कर रहे हैं · three.ws","meta_twitter_description": "दो 3D AI एजेंट वास्तविक क्रिप्टो इंटेल के लिए एक-दूसरे को भुगतान कर रहे हैं। Solana पर USDC। ऑन-चेन।",- "meta_twitter_title": "एजेंट एक्सचेंज — AI एजेंट वास्तविक समय में एक-दूसरे को भुगतान कर रहे हैं",+ "meta_twitter_title": "एजेंट एक्सचेंज: AI एजेंट वास्तविक समय में एक-दूसरे को भुगतान कर रहे हैं","seller": "विक्रेता","session_total_0_00_usdc_settled_on": "सत्र का कुल योग: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC ऑन-चेन निपटाया गया","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 पे-पर-कॉल डेमो",- "x402_the_payment_trust_layer_title": "x402 — इन निपटानों के पीछे की भुगतान विश्वास परत"+ "x402_the_payment_trust_layer_title": "x402: इन निपटानों के पीछे की भुगतान विश्वास परत"},"agent_identities": {"1_call_create_identity": "1 · create_identity को कॉल करें",diff --git a/public/locales/hr.json b/public/locales/hr.jsonindex 195aa5cc0..31c5bd8bd 100644--- a/public/locales/hr.json+++ b/public/locales/hr.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Razmjena agenata",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kupite informacije — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kupite informacije · $0.01 USDC</span>","buy_intel_on": "Kupite informacije na:","buyer": "KUPAC","buyer_agent": "Agent kupac","intel_agent": "Agent informacija","meta_description": "Dva AI agenta s 3D tijelima pregovaraju i plaćaju jedni drugima za uživo kripto informacije koristeći x402 mikroplate na Solana. Svaka transakcija je stvarna i potvrđena na lancu.","meta_og_description": "Dva 3D AI agenta kupuju i prodaju kripto informacije za stvarni USDC na Solana. Gledajte svaku transakciju kako se potvrđuje na lancu.",- "meta_og_title": "Razmjena agenata — AI agenti koji jedni drugima plaćaju u stvarnom vremenu",- "meta_title": "Razmjena agenata — 3D AI agenti koji jedni drugima plaćaju u stvarnom vremenu · three.ws",+ "meta_og_title": "Razmjena agenata: AI agenti koji jedni drugima plaćaju u stvarnom vremenu",+ "meta_title": "Razmjena agenata: 3D AI agenti koji jedni drugima plaćaju u stvarnom vremenu · three.ws","meta_twitter_description": "Dva 3D AI agenta plaćaju jedni drugima za stvarne kripto informacije. USDC na Solana. Na lancu.",- "meta_twitter_title": "Razmjena agenata — AI agenti koji jedni drugima plaćaju u stvarnom vremenu",+ "meta_twitter_title": "Razmjena agenata: AI agenti koji jedni drugima plaćaju u stvarnom vremenu","seller": "PRODAJEM","session_total_0_00_usdc_settled_on": "Ukupno sesije: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC poravnato na lancu","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo plaćanja po pozivu",- "x402_the_payment_trust_layer_title": "x402 — sloj povjerenja u plaćanje iza ovih poravnanja"+ "x402_the_payment_trust_layer_title": "x402: sloj povjerenja u plaćanje iza ovih poravnanja"},"agent_identities": {"1_call_create_identity": "1 · Poziv za kreiranje identiteta",diff --git a/public/locales/hu.json b/public/locales/hu.jsonindex bd91f27dc..778e0f312 100644--- a/public/locales/hu.json+++ b/public/locales/hu.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Ügynök Csere",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Vásárolj intel-t — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Vásárolj intel-t · $0.01 USDC</span>","buy_intel_on": "Vásárolj intel-t itt:","buyer": "VÁSÁRLÓ","buyer_agent": "Vásárló Ügynök","intel_agent": "Intel Ügynök","meta_description": "Két AI ügynök 3D testtel tárgyal és fizet egymásnak élő kripto intelért x402 mikrofizetésekkel Solana-n. Minden tranzakció valós és megerősített on-chain.","meta_og_description": "Két 3D AI ügynök vásárol és ad el kripto intel-t valós USDC-ért Solana-n. Nézd meg, ahogy minden tranzakció megerősítésre kerül on-chain.",- "meta_og_title": "Ügynök Csere — AI ügynökök, akik valós időben fizetnek egymásnak",- "meta_title": "Ügynök Csere — 3D AI ügynökök, akik valós időben fizetnek egymásnak · three.ws",+ "meta_og_title": "Ügynök Csere: AI ügynökök, akik valós időben fizetnek egymásnak",+ "meta_title": "Ügynök Csere: 3D AI ügynökök, akik valós időben fizetnek egymásnak · three.ws","meta_twitter_description": "Két 3D AI ügynök, akik valós kripto intelért fizetnek egymásnak. USDC Solana-n. On-chain.",- "meta_twitter_title": "Ügynök Csere — AI ügynökök, akik valós időben fizetnek egymásnak",+ "meta_twitter_title": "Ügynök Csere: AI ügynökök, akik valós időben fizetnek egymásnak","seller": "ELADÓ","session_total_0_00_usdc_settled_on": "Ülés összesen: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC elszámolva on-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 pay-per-call demó",- "x402_the_payment_trust_layer_title": "x402 — a kifizetési bizalom réteg ezek mögött az elszámolások mögött"+ "x402_the_payment_trust_layer_title": "x402: a kifizetési bizalom réteg ezek mögött az elszámolások mögött"},"agent_identities": {"1_call_create_identity": "1 · Hívás create_identity",diff --git a/public/locales/hy.json b/public/locales/hy.jsonindex b82ba6de2..1b4a91f9a 100644--- a/public/locales/hy.json+++ b/public/locales/hy.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Գործակալների փոխանակում",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Գնել ինտել — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Գնել ինտել · $0.01 USDC</span>","buy_intel_on": "Գնել ինտել՝","buyer": "ԳՆՈՐԴ","buyer_agent": "Գնորդ գործակալ","intel_agent": "Ինտել գործակալ","meta_description": "Երկու AI գործակալներ՝ 3D մարմիններով, բանակցում և վճարում են միմյանց կրիպտո ինտելի համար՝ օգտագործելով x402 միկրովճարումներ Solana-ի վրա։ Յուրաքանչյուր գործարք իրական է և հաստատված է շղթայում։","meta_og_description": "Երկու 3D AI գործակալներ գնում և վաճառում են կրիպտո ինտել իրական USDC-ով Solana-ի վրա։ Դիտեք յուրաքանչյուր գործարքի հաստատումը շղթայում։",- "meta_og_title": "Գործակալների փոխանակում — AI գործակալներ, որոնք իրական ժամանակում վճարում են միմյանց",- "meta_title": "Գործակալների փոխանակում — 3D AI գործակալներ, որոնք իրական ժամանակում վճարում են միմյանց · three.ws",+ "meta_og_title": "Գործակալների փոխանակում: AI գործակալներ, որոնք իրական ժամանակում վճարում են միմյանց",+ "meta_title": "Գործակալների փոխանակում: 3D AI գործակալներ, որոնք իրական ժամանակում վճարում են միմյանց · three.ws","meta_twitter_description": "Երկու 3D AI գործակալներ վճարում են միմյանց իրական կրիպտո ինտելի համար։ USDC Solana-ի վրա։ Շղթայում։",- "meta_twitter_title": "Գործակալների փոխանակում — AI գործակալներ, որոնք իրական ժամանակում վճարում են միմյանց",+ "meta_twitter_title": "Գործակալների փոխանակում: AI գործակալներ, որոնք իրական ժամանակում վճարում են միմյանց","seller": "ՎԱՃԱՌՈՂ","session_total_0_00_usdc_settled_on": "Նիստի ընդհանուր գումարը՝ <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC հաշվարկված է շղթայում","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 զանգի դիմաց վճարման դեմո",- "x402_the_payment_trust_layer_title": "x402 — վճարման վստահության շերտը այս հաշվարկների հետևում"+ "x402_the_payment_trust_layer_title": "x402: վճարման վստահության շերտը այս հաշվարկների հետևում"},"agent_identities": {"1_call_create_identity": "1 · Կանչել create_identity",diff --git a/public/locales/id.json b/public/locales/id.jsonindex 6d23e60ae..ff9744beb 100644--- a/public/locales/id.json+++ b/public/locales/id.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Pertukaran Agen",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Beli intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Beli intel · $0.01 USDC</span>","buy_intel_on": "Beli intel di:","buyer": "PEMBELI","buyer_agent": "Agen Pembeli","intel_agent": "Agen Intel","meta_description": "Dua agen AI dengan tubuh 3D bernegosiasi dan saling membayar untuk intel crypto live menggunakan micropayments x402 di Solana. Setiap transaksi adalah nyata dan terkonfirmasi di on-chain.","meta_og_description": "Dua agen AI 3D membeli dan menjual intel crypto untuk USDC nyata di Solana. Saksikan setiap transaksi terkonfirmasi di on-chain.",- "meta_og_title": "Pertukaran Agen — agen AI saling membayar secara real-time",- "meta_title": "Pertukaran Agen — agen AI 3D saling membayar secara real-time · three.ws",+ "meta_og_title": "Pertukaran Agen: agen AI saling membayar secara real-time",+ "meta_title": "Pertukaran Agen: agen AI 3D saling membayar secara real-time · three.ws","meta_twitter_description": "Dua agen AI 3D saling membayar untuk intel crypto nyata. USDC di Solana. Di on-chain.",- "meta_twitter_title": "Pertukaran Agen — agen AI saling membayar secara real-time",+ "meta_twitter_title": "Pertukaran Agen: agen AI saling membayar secara real-time","seller": "PENJUAL","session_total_0_00_usdc_settled_on": "Total sesi: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC diselesaikan di on-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "Demo bayar-per-panggilan x402",- "x402_the_payment_trust_layer_title": "x402 — lapisan kepercayaan pembayaran di balik penyelesaian ini"+ "x402_the_payment_trust_layer_title": "x402: lapisan kepercayaan pembayaran di balik penyelesaian ini"},"agent_identities": {"1_call_create_identity": "1 · Panggil create_identity",diff --git a/public/locales/ig.json b/public/locales/ig.jsonindex 22b2da672..3ab18979c 100644--- a/public/locales/ig.json+++ b/public/locales/ig.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Mgbanwe Onye Nnọchi Anya",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Zụta ozi — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Zụta ozi · $0.01 USDC</span>","buy_intel_on": "Zụta ozi na:","buyer": "ONye Zụrụ Ahịa","buyer_agent": "Onye Nnọchi Anya Zụrụ Ahịa","intel_agent": "Onye Nnọchi Anya Ozi","meta_description": "Ndị nnọchi anya AI abụọ nwere ahụ 3D na-ekwurịta okwu ma na-akwụ ibe ha ụgwọ maka ozi crypto dị ndụ site na iji obere ịkwụ ụgwọ x402 na Solana. Azụmahịa ọ bụla bụ ezigbo ma kwado ya na-agbanyeghị agbụ.","meta_og_description": "Ndị nnọchi anya AI 3D abụọ na-azụ ma na-ere ozi crypto maka ezigbo USDC na Solana. Lelee ka azụmahịa ọ bụla na-akwado na-agbanyeghị agbụ.",- "meta_og_title": "Mgbanwe Onye Nnọchi Anya — Ndị nnọchi anya AI na-akwụ ibe ha ụgwọ n'oge dị adị",- "meta_title": "Mgbanwe Onye Nnọchi Anya — Ndị nnọchi anya AI 3D na-akwụ ibe ha ụgwọ n'oge dị adị · three.ws",+ "meta_og_title": "Mgbanwe Onye Nnọchi Anya: Ndị nnọchi anya AI na-akwụ ibe ha ụgwọ n'oge dị adị",+ "meta_title": "Mgbanwe Onye Nnọchi Anya: Ndị nnọchi anya AI 3D na-akwụ ibe ha ụgwọ n'oge dị adị · three.ws","meta_twitter_description": "Ndị nnọchi anya AI 3D abụọ na-akwụ ibe ha ụgwọ maka ezigbo ozi crypto. USDC na Solana. Na-agbanyeghị agbụ.",- "meta_twitter_title": "Mgbanwe Onye Nnọchi Anya — Ndị nnọchi anya AI na-akwụ ibe ha ụgwọ n'oge dị adị",+ "meta_twitter_title": "Mgbanwe Onye Nnọchi Anya: Ndị nnọchi anya AI na-akwụ ibe ha ụgwọ n'oge dị adị","seller": "ONye Rere Ahịa","session_total_0_00_usdc_settled_on": "Ngụkọta oge: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC kwụrụ ụgwọ na-agbanyeghị agbụ","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 ngosi akwụ ụgwọ-kwa-oku",- "x402_the_payment_trust_layer_title": "x402 — ọkwa ntụkwasị obi ịkwụ ụgwọ nke na-akwado mmezi ndị a"+ "x402_the_payment_trust_layer_title": "x402: ọkwa ntụkwasị obi ịkwụ ụgwọ nke na-akwado mmezi ndị a"},"agent_identities": {"1_call_create_identity": "1 · Kpọọ create_identity",diff --git a/public/locales/is.json b/public/locales/is.jsonindex 5a52f0803..2c3a86123 100644--- a/public/locales/is.json+++ b/public/locales/is.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Umboðsmannaskipti",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kaupa upplýsingar — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kaupa upplýsingar · $0.01 USDC</span>","buy_intel_on": "Kaupa upplýsingar um:","buyer": "KAUPANDI","buyer_agent": "Kaupandi umboðsmaður","intel_agent": "Upplýsingaumboðsmaður","meta_description": "Tveir gervigreindarumboðsmenn með þrívíddar líkama sem semja og borga hvor öðrum fyrir rauntíma dulritunarupplýsingar með x402 örgreiðslum á Solana. Sérhver viðskipti eru raunveruleg og staðfest á keðjunni.","meta_og_description": "Tveir þrívíddar gervigreindarumboðsmenn kaupa og selja dulritunarupplýsingar fyrir raunverulegt USDC á Solana. Fylgstu með hverri færslu staðfestast á keðjunni.",- "meta_og_title": "Umboðsmannaskipti — Gervigreindarumboðsmenn borga hvor öðrum í rauntíma",- "meta_title": "Umboðsmannaskipti — Þrívíddar gervigreindarumboðsmenn borga hvor öðrum í rauntíma · three.ws",+ "meta_og_title": "Umboðsmannaskipti: Gervigreindarumboðsmenn borga hvor öðrum í rauntíma",+ "meta_title": "Umboðsmannaskipti: Þrívíddar gervigreindarumboðsmenn borga hvor öðrum í rauntíma · three.ws","meta_twitter_description": "Tveir þrívíddar gervigreindarumboðsmenn borga hvor öðrum fyrir raunverulegar dulritunarupplýsingar. USDC á Solana. Á keðjunni.",- "meta_twitter_title": "Umboðsmannaskipti — Gervigreindarumboðsmenn borga hvor öðrum í rauntíma",+ "meta_twitter_title": "Umboðsmannaskipti: Gervigreindarumboðsmenn borga hvor öðrum í rauntíma","seller": "SELJANDI","session_total_0_00_usdc_settled_on": "Samtals í lotu: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC gert upp á keðjunni","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 greiðslu-á-símtali kynning",- "x402_the_payment_trust_layer_title": "x402 — traustlagið fyrir greiðslur á bak við þessar uppgjafir"+ "x402_the_payment_trust_layer_title": "x402: traustlagið fyrir greiðslur á bak við þessar uppgjafir"},"agent_identities": {"1_call_create_identity": "1 · Kalla á create_identity",diff --git a/public/locales/it.json b/public/locales/it.jsonindex 6d71547a6..4fc0aabd0 100644--- a/public/locales/it.json+++ b/public/locales/it.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Scambio Agenti",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Acquista intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Acquista intel · $0.01 USDC</span>","buy_intel_on": "Acquista intel su:","buyer": "ACQUIRENTE","buyer_agent": "Agente Acquirente","intel_agent": "Agente Intel","meta_description": "Due agenti AI con corpi 3D negoziano e si pagano per intel crypto live usando micropagamenti x402 su Solana. Ogni transazione è reale e confermata on-chain.","meta_og_description": "Due agenti AI 3D comprano e vendono intel crypto per veri USDC su Solana. Guarda ogni transazione confermata on-chain.",- "meta_og_title": "Scambio Agenti — agenti AI che si pagano in tempo reale",- "meta_title": "Scambio Agenti — agenti AI 3D che si pagano in tempo reale · three.ws",+ "meta_og_title": "Scambio Agenti: agenti AI che si pagano in tempo reale",+ "meta_title": "Scambio Agenti: agenti AI 3D che si pagano in tempo reale · three.ws","meta_twitter_description": "Due agenti AI 3D che si pagano per veri intel crypto. USDC su Solana. On-chain.",- "meta_twitter_title": "Scambio Agenti — agenti AI che si pagano in tempo reale",+ "meta_twitter_title": "Scambio Agenti: agenti AI che si pagano in tempo reale","seller": "VENDITORE","session_total_0_00_usdc_settled_on": "Totale sessione: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC regolato on-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo pay-per-call",- "x402_the_payment_trust_layer_title": "x402 — il layer di fiducia nei pagamenti dietro questi regolamenti"+ "x402_the_payment_trust_layer_title": "x402: il layer di fiducia nei pagamenti dietro questi regolamenti"},"agent_identities": {"1_call_create_identity": "1 · Chiama create_identity",diff --git a/public/locales/ja.json b/public/locales/ja.jsonindex 90ea4c31f..92a09e65a 100644--- a/public/locales/ja.json+++ b/public/locales/ja.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>エージェントエクスチェンジ",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">インテルを購入 — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">インテルを購入 · $0.01 USDC</span>","buy_intel_on": "インテル購入元:","buyer": "買い手","buyer_agent": "買い手エージェント","intel_agent": "インテルエージェント","meta_description": "3Dボディを持つ2体のAIエージェントが、Solana上でx402マイクロペイメントを利用し、リアルタイムの暗号資産インテルを巡って交渉し、互いに支払いを行います。すべての取引は現実のものであり、オンチェーンで確認されます。","meta_og_description": "2体の3D AIエージェントが、Solana上で実際のUSDCを使って暗号資産インテルを売買します。すべての取引がオンチェーンで確認される様子をご覧ください。",- "meta_og_title": "エージェントエクスチェンジ — AIエージェントがリアルタイムで互いに支払い",- "meta_title": "エージェントエクスチェンジ — 3D AIエージェントがリアルタイムで互いに支払い・ three.ws",+ "meta_og_title": "エージェントエクスチェンジ:AIエージェントがリアルタイムで互いに支払い",+ "meta_title": "エージェントエクスチェンジ:3D AIエージェントがリアルタイムで互いに支払い・ three.ws","meta_twitter_description": "2体の3D AIエージェントが、実際の暗号資産インテルのために互いに支払いを行います。Solana上でUSDC。オンチェーン。",- "meta_twitter_title": "エージェントエクスチェンジ — AIエージェントがリアルタイムで互いに支払い",+ "meta_twitter_title": "エージェントエクスチェンジ:AIエージェントがリアルタイムで互いに支払い","seller": "売り手","session_total_0_00_usdc_settled_on": "セッション合計: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDCがオンチェーンで決済されました","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 従量課金デモ",- "x402_the_payment_trust_layer_title": "x402 — これらの決済を支える支払い信頼レイヤー"+ "x402_the_payment_trust_layer_title": "x402:これらの決済を支える支払い信頼レイヤー"},"agent_identities": {"1_call_create_identity": "1 · create_identityを呼び出す",diff --git a/public/locales/ka.json b/public/locales/ka.jsonindex d74e1685f..09009d218 100644--- a/public/locales/ka.json+++ b/public/locales/ka.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>აგენტების გაცვლა",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">შეიძინეთ ინფორმაცია — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">შეიძინეთ ინფორმაცია · $0.01 USDC</span>","buy_intel_on": "შეიძინეთ ინფორმაცია:","buyer": "მყიდველი","buyer_agent": "მყიდველი აგენტი","intel_agent": "ინფორმაციის აგენტი","meta_description": "ორი 3D სხეულის მქონე AI აგენტი აწარმოებს მოლაპარაკებებს და უხდის ერთმანეთს ცოცხალი კრიპტო ინფორმაციისთვის x402 მიკროგადახდების გამოყენებით Solana-ზე. ყოველი ტრანზაქცია რეალურია და დადასტურებულია ონ-ჩეინზე.","meta_og_description": "ორი 3D AI აგენტი ყიდულობს და ყიდის კრიპტო ინფორმაციას რეალური USDC-ით Solana-ზე. ნახეთ, როგორ დასტურდება ყოველი ტრანზაქცია ონ-ჩეინზე.",- "meta_og_title": "აგენტების გაცვლა — AI აგენტები უხდიან ერთმანეთს რეალურ დროში",- "meta_title": "აგენტების გაცვლა — 3D AI აგენტები უხდიან ერთმანეთს რეალურ დროში · three.ws",+ "meta_og_title": "აგენტების გაცვლა: AI აგენტები უხდიან ერთმანეთს რეალურ დროში",+ "meta_title": "აგენტების გაცვლა: 3D AI აგენტები უხდიან ერთმანეთს რეალურ დროში · three.ws","meta_twitter_description": "ორი 3D AI აგენტი უხდის ერთმანეთს რეალური კრიპტო ინფორმაციისთვის. USDC Solana-ზე. ონ-ჩეინზე.",- "meta_twitter_title": "აგენტების გაცვლა — AI აგენტები უხდიან ერთმანეთს რეალურ დროში",+ "meta_twitter_title": "აგენტების გაცვლა: AI აგენტები უხდიან ერთმანეთს რეალურ დროში","seller": "გამყიდველი","session_total_0_00_usdc_settled_on": "სესიის ჯამი: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC დადასტურებულია ონ-ჩეინზე","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 ზარზე გადახდის დემო",- "x402_the_payment_trust_layer_title": "x402 — გადახდის ნდობის ფენა ამ ანგარიშსწორებების უკან"+ "x402_the_payment_trust_layer_title": "x402: გადახდის ნდობის ფენა ამ ანგარიშსწორებების უკან"},"agent_identities": {"1_call_create_identity": "1 · გამოიძახეთ create_identity",diff --git a/public/locales/kk.json b/public/locales/kk.jsonindex e3421c31d..e009748a0 100644--- a/public/locales/kk.json+++ b/public/locales/kk.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Агенттер алмасуы",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Интел сатып алу — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Интел сатып алу · $0.01 USDC</span>","buy_intel_on": "Интелді сатып алу:","buyer": "САТЫП АЛУШЫ","buyer_agent": "Сатып алушы агент","intel_agent": "Интел агенті","meta_description": "3D денесі бар екі AI агенті бір-бірімен тікелей крипто интел үшін Solana желісінде x402 микротөлемдерін пайдалана отырып келіссөз жүргізіп, төлем жасайды. Әр транзакция нақты және тізбекте расталған.","meta_og_description": "Екі 3D AI агенті Solana желісінде нақты USDC үшін крипто интелді сатып алады және сатады. Әр транзакцияның тізбекте расталуын бақылаңыз.",- "meta_og_title": "Агенттер алмасуы — AI агенттері бір-біріне нақты уақытта төлем жасайды",- "meta_title": "Агенттер алмасуы — 3D AI агенттері бір-біріне нақты уақытта төлем жасайды · three.ws",+ "meta_og_title": "Агенттер алмасуы: AI агенттері бір-біріне нақты уақытта төлем жасайды",+ "meta_title": "Агенттер алмасуы: 3D AI агенттері бір-біріне нақты уақытта төлем жасайды · three.ws","meta_twitter_description": "Екі 3D AI агенті бір-біріне нақты крипто интел үшін төлем жасайды. Solana желісінде USDC. Тізбекте.",- "meta_twitter_title": "Агенттер алмасуы — AI агенттері бір-біріне нақты уақытта төлем жасайды",+ "meta_twitter_title": "Агенттер алмасуы: AI агенттері бір-біріне нақты уақытта төлем жасайды","seller": "САТУШЫ","session_total_0_00_usdc_settled_on": "Сессия қорытындысы: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC тізбекте есептелді","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 қоңырау үшін төлем демонстрациясы",- "x402_the_payment_trust_layer_title": "x402 — бұл есеп айырысулардың артындағы төлем сенім қабаты"+ "x402_the_payment_trust_layer_title": "x402: бұл есеп айырысулардың артындағы төлем сенім қабаты"},"agent_identities": {"1_call_create_identity": "1 · create_identity шақыруы",diff --git a/public/locales/km.json b/public/locales/km.jsonindex 6fc4ca352..ea8bce674 100644--- a/public/locales/km.json+++ b/public/locales/km.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>ការផ្លាស់ប្តូរភ្នាក់ងារ",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ទិញព័ត៌មាន — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ទិញព័ត៌មាន · $0.01 USDC</span>","buy_intel_on": "ទិញព័ត៌មានអំពី៖","buyer": "អ្នកទិញ","buyer_agent": "ភ្នាក់ងារអ្នកទិញ","intel_agent": "ភ្នាក់ងារ Intel","meta_description": "ភ្នាក់ងារ AI ពីរដែលមានរូបរាង 3D ចរចា និងបង់ប្រាក់ឱ្យគ្នាទៅវិញទៅមកសម្រាប់ព័ត៌មាន crypto ផ្ទាល់ដោយប្រើ micropayments x402 នៅលើ Solana។ រាល់ប្រតិបត្តិការគឺពិតប្រាកដ និងត្រូវបានបញ្ជាក់នៅលើខ្សែសង្វាក់។","meta_og_description": "ភ្នាក់ងារ AI 3D ពីរទិញ និងលក់ព័ត៌មាន crypto សម្រាប់ USDC ពិតប្រាកដនៅលើ Solana។ មើលរាល់ប្រតិបត្តិការបញ្ជាក់នៅលើខ្សែសង្វាក់។",- "meta_og_title": "ការផ្លាស់ប្តូរភ្នាក់ងារ — ភ្នាក់ងារ AI បង់ប្រាក់ឱ្យគ្នាទៅវិញទៅមកក្នុងពេលជាក់ស្តែង",- "meta_title": "ការផ្លាស់ប្តូរភ្នាក់ងារ — ភ្នាក់ងារ AI 3D បង់ប្រាក់ឱ្យគ្នាទៅវិញទៅមកក្នុងពេលជាក់ស្តែង · three.ws",+ "meta_og_title": "ការផ្លាស់ប្តូរភ្នាក់ងារ: ភ្នាក់ងារ AI បង់ប្រាក់ឱ្យគ្នាទៅវិញទៅមកក្នុងពេលជាក់ស្តែង",+ "meta_title": "ការផ្លាស់ប្តូរភ្នាក់ងារ: ភ្នាក់ងារ AI 3D បង់ប្រាក់ឱ្យគ្នាទៅវិញទៅមកក្នុងពេលជាក់ស្តែង · three.ws","meta_twitter_description": "ភ្នាក់ងារ AI 3D ពីរដែលបង់ប្រាក់ឱ្យគ្នាទៅវិញទៅមកសម្រាប់ព័ត៌មាន crypto ពិតប្រាកដ។ USDC នៅលើ Solana។ នៅលើខ្សែសង្វាក់។",- "meta_twitter_title": "ការផ្លាស់ប្តូរភ្នាក់ងារ — ភ្នាក់ងារ AI បង់ប្រាក់ឱ្យគ្នាទៅវិញទៅមកក្នុងពេលជាក់ស្តែង",+ "meta_twitter_title": "ការផ្លាស់ប្តូរភ្នាក់ងារ: ភ្នាក់ងារ AI បង់ប្រាក់ឱ្យគ្នាទៅវិញទៅមកក្នុងពេលជាក់ស្តែង","seller": "អ្នកលក់","session_total_0_00_usdc_settled_on": "សរុបវគ្គ៖ <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC បានទូទាត់នៅលើខ្សែសង្វាក់","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 ការបង្ហាញបង់តាមការហៅ",- "x402_the_payment_trust_layer_title": "x402 — ស្រទាប់ទំនុកចិត្តនៃការទូទាត់នៅពីក្រោយការទូទាត់ទាំងនេះ"+ "x402_the_payment_trust_layer_title": "x402: ស្រទាប់ទំនុកចិត្តនៃការទូទាត់នៅពីក្រោយការទូទាត់ទាំងនេះ"},"agent_identities": {"1_call_create_identity": "1 · ហៅ create_identity",diff --git a/public/locales/kn.json b/public/locales/kn.jsonindex 63e3afc2c..e9f3588e9 100644--- a/public/locales/kn.json+++ b/public/locales/kn.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>ಏಜೆಂಟ್ ಎಕ್ಸ್ಚೇಂಜ್",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ಇಂಟೆಲ್ ಖರೀದಿಸಿ — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ಇಂಟೆಲ್ ಖರೀದಿಸಿ · $0.01 USDC</span>","buy_intel_on": "ಇಂಟೆಲ್ ಖರೀದಿಸಿ:","buyer": "ಖರೀದಿದಾರ","buyer_agent": "ಖರೀದಿದಾರ ಏಜೆಂಟ್","intel_agent": "ಇಂಟೆಲ್ ಏಜೆಂಟ್","meta_description": "3D ದೇಹಗಳನ್ನು ಹೊಂದಿರುವ ಇಬ್ಬರು AI ಏಜೆಂಟ್ಗಳು Solana ನಲ್ಲಿ x402 ಮೈಕ್ರೋಪೇಮೆಂಟ್ಗಳನ್ನು ಬಳಸಿ ಲೈವ್ ಕ್ರಿಪ್ಟೋ ಇಂಟೆಲ್ಗಾಗಿ ಪರಸ್ಪರ ಮಾತುಕತೆ ನಡೆಸಿ ಪಾವತಿಸುತ್ತವೆ. ಪ್ರತಿ ವಹಿವಾಟು ನೈಜವಾಗಿದೆ ಮತ್ತು ಆನ್-ಚೈನ್ನಲ್ಲಿ ದೃಢೀಕರಿಸಲಾಗಿದೆ.","meta_og_description": "ಇಬ್ಬರು 3D AI ಏಜೆಂಟ್ಗಳು Solana ನಲ್ಲಿ ನಿಜವಾದ USDC ಗಾಗಿ ಕ್ರಿಪ್ಟೋ ಇಂಟೆಲ್ ಅನ್ನು ಖರೀದಿಸುತ್ತವೆ ಮತ್ತು ಮಾರಾಟ ಮಾಡುತ್ತವೆ. ಪ್ರತಿ ವಹಿವಾಟು ಆನ್-ಚೈನ್ನಲ್ಲಿ ದೃಢೀಕರಿಸುವುದನ್ನು ವೀಕ್ಷಿಸಿ.",- "meta_og_title": "ಏಜೆಂಟ್ ಎಕ್ಸ್ಚೇಂಜ್ — AI ಏಜೆಂಟ್ಗಳು ನೈಜ ಸಮಯದಲ್ಲಿ ಪರಸ್ಪರ ಪಾವತಿಸುತ್ತಿವೆ",- "meta_title": "ಏಜೆಂಟ್ ಎಕ್ಸ್ಚೇಂಜ್ — 3D AI ಏಜೆಂಟ್ಗಳು ನೈಜ ಸಮಯದಲ್ಲಿ ಪರಸ್ಪರ ಪಾವತಿಸುತ್ತಿವೆ · three.ws",+ "meta_og_title": "ಏಜೆಂಟ್ ಎಕ್ಸ್ಚೇಂಜ್: AI ಏಜೆಂಟ್ಗಳು ನೈಜ ಸಮಯದಲ್ಲಿ ಪರಸ್ಪರ ಪಾವತಿಸುತ್ತಿವೆ",+ "meta_title": "ಏಜೆಂಟ್ ಎಕ್ಸ್ಚೇಂಜ್: 3D AI ಏಜೆಂಟ್ಗಳು ನೈಜ ಸಮಯದಲ್ಲಿ ಪರಸ್ಪರ ಪಾವತಿಸುತ್ತಿವೆ · three.ws","meta_twitter_description": "ಇಬ್ಬರು 3D AI ಏಜೆಂಟ್ಗಳು ನಿಜವಾದ ಕ್ರಿಪ್ಟೋ ಇಂಟೆಲ್ಗಾಗಿ ಪರಸ್ಪರ ಪಾವತಿಸುತ್ತಿವೆ. USDC Solana ನಲ್ಲಿ. ಆನ್-ಚೈನ್.",- "meta_twitter_title": "ಏಜೆಂಟ್ ಎಕ್ಸ್ಚೇಂಜ್ — AI ಏಜೆಂಟ್ಗಳು ನೈಜ ಸಮಯದಲ್ಲಿ ಪರಸ್ಪರ ಪಾವತಿಸುತ್ತಿವೆ",+ "meta_twitter_title": "ಏಜೆಂಟ್ ಎಕ್ಸ್ಚೇಂಜ್: AI ಏಜೆಂಟ್ಗಳು ನೈಜ ಸಮಯದಲ್ಲಿ ಪರಸ್ಪರ ಪಾವತಿಸುತ್ತಿವೆ","seller": "ಮಾರಾಟಗಾರ","session_total_0_00_usdc_settled_on": "ಸೆಷನ್ ಒಟ್ಟು: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC ಆನ್-ಚೈನ್ನಲ್ಲಿ ಇತ್ಯರ್ಥವಾಗಿದೆ","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 ಪೇ-ಪರ್-ಕಾಲ್ ಡೆಮೊ",- "x402_the_payment_trust_layer_title": "x402 — ಈ ಇತ್ಯರ್ಥಗಳ ಹಿಂದಿನ ಪಾವತಿ ವಿಶ್ವಾಸಾರ್ಹ ಪದರ"+ "x402_the_payment_trust_layer_title": "x402: ಈ ಇತ್ಯರ್ಥಗಳ ಹಿಂದಿನ ಪಾವತಿ ವಿಶ್ವಾಸಾರ್ಹ ಪದರ"},"agent_identities": {"1_call_create_identity": "1 · create_identity ಗೆ ಕರೆ ಮಾಡಿ",diff --git a/public/locales/ko.json b/public/locales/ko.jsonindex 134b715cd..49f17df1d 100644--- a/public/locales/ko.json+++ b/public/locales/ko.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>에이전트 거래소",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">정보 구매 — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">정보 구매 · $0.01 USDC</span>","buy_intel_on": "정보 구매처:","buyer": "구매자","buyer_agent": "구매 에이전트","intel_agent": "정보 에이전트","meta_description": "3D 신체를 가진 두 AI 에이전트가 Solana에서 x402 마이크로페이먼트를 사용하여 실시간 암호화폐 정보를 위해 서로 협상하고 지불합니다. 모든 거래는 실제이며 온체인에서 확인됩니다.","meta_og_description": "두 3D AI 에이전트가 Solana에서 실제 USDC을 사용하여 암호화폐 정보를 사고팝니다. 모든 거래가 온체인에서 확인되는 것을 지켜보세요.",- "meta_og_title": "에이전트 거래소 — AI 에이전트가 실시간으로 서로에게 지불합니다",- "meta_title": "에이전트 거래소 — 3D AI 에이전트가 실시간으로 서로에게 지불합니다 · three.ws",+ "meta_og_title": "에이전트 거래소: AI 에이전트가 실시간으로 서로에게 지불합니다",+ "meta_title": "에이전트 거래소: 3D AI 에이전트가 실시간으로 서로에게 지불합니다 · three.ws","meta_twitter_description": "두 3D AI 에이전트가 실제 암호화폐 정보를 위해 서로에게 지불합니다. Solana에서 USDC. 온체인.",- "meta_twitter_title": "에이전트 거래소 — AI 에이전트가 실시간으로 서로에게 지불합니다",+ "meta_twitter_title": "에이전트 거래소: AI 에이전트가 실시간으로 서로에게 지불합니다","seller": "판매자","session_total_0_00_usdc_settled_on": "세션 총액: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC 온체인 정산","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 호출당 지불 데모",- "x402_the_payment_trust_layer_title": "x402 — 이러한 정산의 기반이 되는 결제 신뢰 계층"+ "x402_the_payment_trust_layer_title": "x402: 이러한 정산의 기반이 되는 결제 신뢰 계층"},"agent_identities": {"1_call_create_identity": "1 · create_identity 호출",diff --git a/public/locales/ky.json b/public/locales/ky.jsonindex cd4398ecc..a31089a6a 100644--- a/public/locales/ky.json+++ b/public/locales/ky.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Агент алмашуу",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Маалымат сатып алуу — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Маалымат сатып алуу · $0.01 USDC</span>","buy_intel_on": "Маалыматты сатып алуу:","buyer": "САТЫП АЛУУЧУ","buyer_agent": "Сатып алуучу агент","intel_agent": "Маалымат агенти","meta_description": "3D денеси бар эки AI агент Solana платформасында x402 микротөлөмдөрүн колдонуп, жандуу крипто маалымат үчүн бири-бири менен сүйлөшүп, төлөшөт. Ар бир транзакция реалдуу жана чынжырда тастыкталган.","meta_og_description": "Эки 3D AI агент Solana платформасында чыныгы USDC үчүн крипто маалыматты сатып жана сатышат. Ар бир транзакциянын чынжырда ырасталганын көрүңүз.",- "meta_og_title": "Агент алмашуу — AI агенттери бири-бирине реалдуу убакытта төлөшөт",- "meta_title": "Агент алмашуу — 3D AI агенттери бири-бирине реалдуу убакытта төлөшөт · three.ws",+ "meta_og_title": "Агент алмашуу: AI агенттери бири-бирине реалдуу убакытта төлөшөт",+ "meta_title": "Агент алмашуу: 3D AI агенттери бири-бирине реалдуу убакытта төлөшөт · three.ws","meta_twitter_description": "Эки 3D AI агент чыныгы крипто маалымат үчүн бири-бирине төлөшөт. USDC Solana платформасында. Чынжырда.",- "meta_twitter_title": "Агент алмашуу — AI агенттери бири-бирине реалдуу убакытта төлөшөт",+ "meta_twitter_title": "Агент алмашуу: AI агенттери бири-бирине реалдуу убакытта төлөшөт","seller": "САТУУЧУ","session_total_0_00_usdc_settled_on": "Сессиянын жалпы суммасы: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC чынжырда жөнгө салынды","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 чалууга акы төлөө демосу",- "x402_the_payment_trust_layer_title": "x402 — бул эсептешүүлөрдүн артындагы төлөм ишеним катмары"+ "x402_the_payment_trust_layer_title": "x402: бул эсептешүүлөрдүн артындагы төлөм ишеним катмары"},"agent_identities": {"1_call_create_identity": "1 · create_identity чакыруу",diff --git a/public/locales/lo.json b/public/locales/lo.jsonindex d3e14dc61..91d65caa9 100644--- a/public/locales/lo.json+++ b/public/locales/lo.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>ການແລກປ່ຽນເອເຈັນ",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ຊື້ຂໍ້ມູນ — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ຊື້ຂໍ້ມູນ · $0.01 USDC</span>","buy_intel_on": "ຊື້ຂໍ້ມູນກ່ຽວກັບ:","buyer": "ຜູ້ຊື້","buyer_agent": "ເອເຈັນຜູ້ຊື້","intel_agent": "ເອເຈັນຂໍ້ມູນ","meta_description": "ເອເຈັນ AI ສອງຕົວທີ່ມີຮ່າງກາຍ 3D ເຈລະຈາ ແລະ ຈ່າຍເງິນໃຫ້ກັນສຳລັບຂໍ້ມູນ crypto ແບບສົດໆ ໂດຍໃຊ້ micropayments x402 ຢູ່ເທິງ Solana. ທຸກໆທຸລະກຳແມ່ນຈິງ ແລະ ຖືກຢືນຢັນເທິງລະບົບຕ່ອງໂສ້.","meta_og_description": "ເອເຈັນ AI 3D ສອງຕົວຊື້ຂາຍຂໍ້ມູນ crypto ເພື່ອ USDC ແທ້ຈິງຢູ່ເທິງ Solana. ເບິ່ງທຸກໆທຸລະກຳຢືນຢັນເທິງລະບົບຕ່ອງໂສ້.",- "meta_og_title": "ການແລກປ່ຽນເອເຈັນ — ເອເຈັນ AI ຈ່າຍເງິນໃຫ້ກັນແບບສົດໆ",- "meta_title": "ການແລກປ່ຽນເອເຈັນ — ເອເຈັນ AI 3D ຈ່າຍເງິນໃຫ້ກັນແບບສົດໆ · three.ws",+ "meta_og_title": "ການແລກປ່ຽນເອເຈັນ: ເອເຈັນ AI ຈ່າຍເງິນໃຫ້ກັນແບບສົດໆ",+ "meta_title": "ການແລກປ່ຽນເອເຈັນ: ເອເຈັນ AI 3D ຈ່າຍເງິນໃຫ້ກັນແບບສົດໆ · three.ws","meta_twitter_description": "ເອເຈັນ AI 3D ສອງຕົວຈ່າຍເງິນໃຫ້ກັນສຳລັບຂໍ້ມູນ crypto ແທ້ຈິງ. USDC ຢູ່ເທິງ Solana. ເທິງລະບົບຕ່ອງໂສ້.",- "meta_twitter_title": "ການແລກປ່ຽນເອເຈັນ — ເອເຈັນ AI ຈ່າຍເງິນໃຫ້ກັນແບບສົດໆ",+ "meta_twitter_title": "ການແລກປ່ຽນເອເຈັນ: ເອເຈັນ AI ຈ່າຍເງິນໃຫ້ກັນແບບສົດໆ","seller": "ຜູ້ຂາຍ","session_total_0_00_usdc_settled_on": "ຍອດລວມຂອງເຊສຊັນ: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC ຖືກຊຳລະເທິງລະບົບຕ່ອງໂສ້","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 ຕົວຢ່າງສາທິດແບບຈ່າຍຕໍ່ການຮຽກໃຊ້",- "x402_the_payment_trust_layer_title": "x402 — ຊັ້ນຄວາມເຊື່ອໝັ້ນການຊໍາລະເງິນທີ່ຢູ່ເບື້ອງຫຼັງການຕົກລົງເຫຼົ່ານີ້"+ "x402_the_payment_trust_layer_title": "x402: ຊັ້ນຄວາມເຊື່ອໝັ້ນການຊໍາລະເງິນທີ່ຢູ່ເບື້ອງຫຼັງການຕົກລົງເຫຼົ່ານີ້"},"agent_identities": {"1_call_create_identity": "1 · ຮຽກໃຊ້ create_identity",diff --git a/public/locales/lt.json b/public/locales/lt.jsonindex 410f1d38f..9ad378ab3 100644--- a/public/locales/lt.json+++ b/public/locales/lt.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agentų mainai",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Pirkti informaciją – $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Pirkti informaciją · $0.01 USDC</span>","buy_intel_on": "Pirkti informaciją apie:","buyer": "PIRKĖJAS","buyer_agent": "Agentas pirkėjas","intel_agent": "Informacijos agentas","meta_description": "Du dirbtinio intelekto agentai su 3D kūnais derasi ir moka vienas kitam už gyvą kripto informaciją, naudodami x402 mikromokėjimus Solana tinkle. Kiekviena operacija yra tikra ir patvirtinta grandinėje.","meta_og_description": "Du 3D DI agentai perka ir parduoda kripto informaciją už tikrus USDC Solana tinkle. Stebėkite, kaip kiekviena operacija patvirtinama grandinėje.",- "meta_og_title": "Agentų mainai – DI agentai moka vienas kitam realiuoju laiku",- "meta_title": "Agentų mainai – 3D DI agentai moka vienas kitam realiuoju laiku · three.ws",+ "meta_og_title": "Agentų mainai: DI agentai moka vienas kitam realiuoju laiku",+ "meta_title": "Agentų mainai: 3D DI agentai moka vienas kitam realiuoju laiku · three.ws","meta_twitter_description": "Du 3D DI agentai moka vienas kitam už tikrą kripto informaciją. USDC Solana tinkle. Grandinėje.",- "meta_twitter_title": "Agentų mainai – DI agentai moka vienas kitam realiuoju laiku",+ "meta_twitter_title": "Agentų mainai: DI agentai moka vienas kitam realiuoju laiku","seller": "PARDAVĖJAS","session_total_0_00_usdc_settled_on": "Sesijos suma: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC atsiskaityta grandinėje","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 mokėjimo už iškvietimą demonstracija",- "x402_the_payment_trust_layer_title": "x402 — mokėjimų patikimumo sluoksnis, užtikrinantis šiuos atsiskaitymus"+ "x402_the_payment_trust_layer_title": "x402: mokėjimų patikimumo sluoksnis, užtikrinantis šiuos atsiskaitymus"},"agent_identities": {"1_call_create_identity": "1 · Iškviesti create_identity",diff --git a/public/locales/lv.json b/public/locales/lv.jsonindex d28ef0a08..d92df45b6 100644--- a/public/locales/lv.json+++ b/public/locales/lv.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Aģentu apmaiņa",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Pirkt informāciju — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Pirkt informāciju · $0.01 USDC</span>","buy_intel_on": "Pirkt informāciju par:","buyer": "PIRCĒJS","buyer_agent": "Pircēja aģents","intel_agent": "Informācijas aģents","meta_description": "Divi AI aģenti ar 3D ķermeņiem savstarpēji vienojas un maksā viens otram par reāllaika kripto informāciju, izmantojot x402 mikromaksājumus uz Solana. Katrs darījums ir reāls un apstiprināts blokķēdē.","meta_og_description": "Divi 3D AI aģenti pērk un pārdod kripto informāciju par reālu USDC uz Solana. Skatieties, kā katrs darījums tiek apstiprināts blokķēdē.",- "meta_og_title": "Aģentu apmaiņa — AI aģenti maksā viens otram reāllaikā",- "meta_title": "Aģentu apmaiņa — 3D AI aģenti maksā viens otram reāllaikā · three.ws",+ "meta_og_title": "Aģentu apmaiņa: AI aģenti maksā viens otram reāllaikā",+ "meta_title": "Aģentu apmaiņa: 3D AI aģenti maksā viens otram reāllaikā · three.ws","meta_twitter_description": "Divi 3D AI aģenti maksā viens otram par reālu kripto informāciju. USDC uz Solana. Blokķēdē.",- "meta_twitter_title": "Aģentu apmaiņa — AI aģenti maksā viens otram reāllaikā",+ "meta_twitter_title": "Aģentu apmaiņa: AI aģenti maksā viens otram reāllaikā","seller": "PĀRDEVĒJS","session_total_0_00_usdc_settled_on": "Sesijas kopsumma: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC apstiprināta blokķēdē","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 maksas-par-zvanu demonstrācija",- "x402_the_payment_trust_layer_title": "x402 — maksājumu uzticamības slānis aiz šiem norēķiniem"+ "x402_the_payment_trust_layer_title": "x402: maksājumu uzticamības slānis aiz šiem norēķiniem"},"agent_identities": {"1_call_create_identity": "1 · Izsaukt create_identity",diff --git a/public/locales/mk.json b/public/locales/mk.jsonindex 23388355f..236cc617a 100644--- a/public/locales/mk.json+++ b/public/locales/mk.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Размена на агенти",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Купи интел — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Купи интел · $0.01 USDC</span>","buy_intel_on": "Купи интел за:","buyer": "КУПУВАЧ","buyer_agent": "Агент купувач","intel_agent": "Интел агент","meta_description": "Двајца АИ агенти со 3Д тела преговараат и си плаќаат еден на друг за крипто интел во живо користејќи x402 микроплаќања на Solana. Секоја трансакција е реална и потврдена на блокчејн.","meta_og_description": "Двајца 3Д АИ агенти купуваат и продаваат крипто интел за вистински USDC на Solana. Гледајте како секоја трансакција се потврдува на блокчејн.",- "meta_og_title": "Размена на агенти — АИ агенти си плаќаат еден на друг во реално време",- "meta_title": "Размена на агенти — 3Д АИ агенти си плаќаат еден на друг во реално време · three.ws",+ "meta_og_title": "Размена на агенти: АИ агенти си плаќаат еден на друг во реално време",+ "meta_title": "Размена на агенти: 3Д АИ агенти си плаќаат еден на друг во реално време · three.ws","meta_twitter_description": "Двајца 3Д АИ агенти си плаќаат еден на друг за вистински крипто интел. USDC на Solana. На блокчејн.",- "meta_twitter_title": "Размена на агенти — АИ агенти си плаќаат еден на друг во реално време",+ "meta_twitter_title": "Размена на агенти: АИ агенти си плаќаат еден на друг во реално време","seller": "ПРОДАВАЧ","session_total_0_00_usdc_settled_on": "Вкупно за сесија: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC порамнето на блокчејн","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 демо со плаќање по повик",- "x402_the_payment_trust_layer_title": "x402 — слојот на доверба за плаќање зад овие порамнувања"+ "x402_the_payment_trust_layer_title": "x402: слојот на доверба за плаќање зад овие порамнувања"},"agent_identities": {"1_call_create_identity": "1 · Повикајте create_identity",diff --git a/public/locales/ml.json b/public/locales/ml.jsonindex 71eab4c10..f448cc523 100644--- a/public/locales/ml.json+++ b/public/locales/ml.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>ഏജന്റ് എക്സ്ചേഞ്ച്",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ഇന്റൽ വാങ്ങുക — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ഇന്റൽ വാങ്ങുക · $0.01 USDC</span>","buy_intel_on": "ഇന്റൽ വാങ്ങുക:","buyer": "വാങ്ങുന്നയാൾ","buyer_agent": "വാങ്ങുന്ന ഏജന്റ്","intel_agent": "ഇന്റൽ ഏജന്റ്","meta_description": "3D ശരീരങ്ങളുള്ള രണ്ട് AI ഏജന്റുമാർ Solana-ൽ x402 മൈക്രോപേയ്മെന്റുകൾ ഉപയോഗിച്ച് തത്സമയ ക്രിപ്റ്റോ ഇന്റലിനായി പരസ്പരം ചർച്ച ചെയ്യുകയും പണം നൽകുകയും ചെയ്യുന്നു. എല്ലാ ഇടപാടുകളും യഥാർത്ഥവും ഓൺ-ചെയിനിൽ സ്ഥിരീകരിച്ചതുമാണ്.","meta_og_description": "രണ്ട് 3D AI ഏജന്റുമാർ Solana-ൽ യഥാർത്ഥ USDC ഉപയോഗിച്ച് ക്രിപ്റ്റോ ഇന്റൽ വാങ്ങുകയും വിൽക്കുകയും ചെയ്യുന്നു. ഓരോ ഇടപാടും ഓൺ-ചെയിനിൽ സ്ഥിരീകരിക്കുന്നത് കാണുക.",- "meta_og_title": "ഏജന്റ് എക്സ്ചേഞ്ച് — AI ഏജന്റുമാർ തത്സമയം പരസ്പരം പണം നൽകുന്നു",- "meta_title": "ഏജന്റ് എക്സ്ചേഞ്ച് — 3D AI ഏജന്റുമാർ തത്സമയം പരസ്പരം പണം നൽകുന്നു · three.ws",+ "meta_og_title": "ഏജന്റ് എക്സ്ചേഞ്ച്: AI ഏജന്റുമാർ തത്സമയം പരസ്പരം പണം നൽകുന്നു",+ "meta_title": "ഏജന്റ് എക്സ്ചേഞ്ച്: 3D AI ഏജന്റുമാർ തത്സമയം പരസ്പരം പണം നൽകുന്നു · three.ws","meta_twitter_description": "രണ്ട് 3D AI ഏജന്റുമാർ യഥാർത്ഥ ക്രിപ്റ്റോ ഇന്റലിനായി പരസ്പരം പണം നൽകുന്നു. USDC Solana-ൽ. ഓൺ-ചെയിനിൽ.",- "meta_twitter_title": "ഏജന്റ് എക്സ്ചേഞ്ച് — AI ഏജന്റുമാർ തത്സമയം പരസ്പരം പണം നൽകുന്നു",+ "meta_twitter_title": "ഏജന്റ് എക്സ്ചേഞ്ച്: AI ഏജന്റുമാർ തത്സമയം പരസ്പരം പണം നൽകുന്നു","seller": "വിൽക്കുന്നയാൾ","session_total_0_00_usdc_settled_on": "സെഷൻ ആകെ: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC ഓൺ-ചെയിനിൽ തീർപ്പാക്കി","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 പേ-പെർ-കോൾ ഡെമോ",- "x402_the_payment_trust_layer_title": "x402 — ഈ തീർപ്പാക്കലുകൾക്ക് പിന്നിലെ പേയ്മെന്റ് ട്രസ്റ്റ് ലെയർ"+ "x402_the_payment_trust_layer_title": "x402: ഈ തീർപ്പാക്കലുകൾക്ക് പിന്നിലെ പേയ്മെന്റ് ട്രസ്റ്റ് ലെയർ"},"agent_identities": {"1_call_create_identity": "1 · create_identity വിളിക്കുക",diff --git a/public/locales/mn.json b/public/locales/mn.jsonindex e5d8b1b52..038fe015c 100644--- a/public/locales/mn.json+++ b/public/locales/mn.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Агентын бирж",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Мэдээлэл худалдаж авах — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Мэдээлэл худалдаж авах · $0.01 USDC</span>","buy_intel_on": "Мэдээлэл худалдаж авах:","buyer": "ХУДАЛДАН АВАГЧ","buyer_agent": "Худалдан авагч агент","intel_agent": "Мэдээллийн агент","meta_description": "3D биетэй хоёр хиймэл оюун ухааны агент Solana дээр x402 бичил төлбөр ашиглан крипто мэдээлэл солилцож, хоорондоо төлбөр хийнэ. Гүйлгээ бүр бодит бөгөөд гинжин хэлхээнд баталгаажсан байна.","meta_og_description": "3D хиймэл оюун ухааны хоёр агент Solana дээр бодит USDC ашиглан крипто мэдээлэл худалдаж, зардаг. Гүйлгээ бүр гинжин хэлхээнд баталгаажиж байгааг хараарай.",- "meta_og_title": "Агентын бирж — Хиймэл оюун ухааны агентууд бодит цаг хугацаанд хоорондоо төлбөр хийж байна",- "meta_title": "Агентын бирж — 3D хиймэл оюун ухааны агентууд бодит цаг хугацаанд хоорондоо төлбөр хийж байна · three.ws",+ "meta_og_title": "Агентын бирж: Хиймэл оюун ухааны агентууд бодит цаг хугацаанд хоорондоо төлбөр хийж байна",+ "meta_title": "Агентын бирж: 3D хиймэл оюун ухааны агентууд бодит цаг хугацаанд хоорондоо төлбөр хийж байна · three.ws","meta_twitter_description": "3D хиймэл оюун ухааны хоёр агент бодит крипто мэдээллийн төлбөрийг хоорондоо хийж байна. USDC Solana дээр. Гинжин хэлхээнд.",- "meta_twitter_title": "Агентын бирж — Хиймэл оюун ухааны агентууд бодит цаг хугацаанд хоорондоо төлбөр хийж байна",+ "meta_twitter_title": "Агентын бирж: Хиймэл оюун ухааны агентууд бодит цаг хугацаанд хоорондоо төлбөр хийж байна","seller": "БОРЛУУЛАГЧ","session_total_0_00_usdc_settled_on": "Сессийн нийт дүн: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC гинжин хэлхээнд шийдэгдсэн","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 дуудлагаар төлөх демо",- "x402_the_payment_trust_layer_title": "x402 — эдгээр тооцооллын ард буй төлбөрийн итгэлцлийн давхарга"+ "x402_the_payment_trust_layer_title": "x402: эдгээр тооцооллын ард буй төлбөрийн итгэлцлийн давхарга"},"agent_identities": {"1_call_create_identity": "1 · create_identity-г дуудах",diff --git a/public/locales/mr.json b/public/locales/mr.jsonindex 6f8792267..3e5acad3f 100644--- a/public/locales/mr.json+++ b/public/locales/mr.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>एजंट एक्सचेंज",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\"> माहिती खरेदी करा — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\"> माहिती खरेदी करा · $0.01 USDC</span>","buy_intel_on": "माहिती खरेदी करा:","buyer": "खरेदी करणारा","buyer_agent": "खरेदी करणारा एजंट","intel_agent": "माहिती एजंट","meta_description": "दोन AI एजंट्स 3D शरीरांसह थेट क्रिप्टो माहितीची वाटाघाटी करतात आणि x402 मायक्रोपेमेंट्सद्वारे Solana वर एकमेकांना पैसे देतात. प्रत्येक व्यवहार वास्तविक आणि चेनवर पुष्टीत आहे.","meta_og_description": "दोन 3D AI एजंट्स वास्तविक USDC साठी क्रिप्टो माहिती खरेदी आणि विक्री करतात Solana वर. प्रत्येक व्यवहार चेनवर पुष्टीत पहा.",- "meta_og_title": "एजंट एक्सचेंज — AI एजंट्स एकमेकांना वास्तविक वेळेत पैसे देत आहेत",- "meta_title": "एजंट एक्सचेंज — 3D AI एजंट्स एकमेकांना वास्तविक वेळेत पैसे देत आहेत · three.ws",+ "meta_og_title": "एजंट एक्सचेंज: AI एजंट्स एकमेकांना वास्तविक वेळेत पैसे देत आहेत",+ "meta_title": "एजंट एक्सचेंज: 3D AI एजंट्स एकमेकांना वास्तविक वेळेत पैसे देत आहेत · three.ws","meta_twitter_description": "दोन 3D AI एजंट्स वास्तविक क्रिप्टो माहिती साठी एकमेकांना पैसे देत आहेत. USDC Solana वर. चेनवर.",- "meta_twitter_title": "एजंट एक्सचेंज — AI एजंट्स एकमेकांना वास्तविक वेळेत पैसे देत आहेत",+ "meta_twitter_title": "एजंट एक्सचेंज: AI एजंट्स एकमेकांना वास्तविक वेळेत पैसे देत आहेत","seller": "विक्री करणारा","session_total_0_00_usdc_settled_on": "सत्र एकूण: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC चेनवर निपटले","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 पे-पर-कॉल डेमो",- "x402_the_payment_trust_layer_title": "x402 — या निपटाऱ्यांच्या मागे पेमेंट ट्रस्ट लेयर"+ "x402_the_payment_trust_layer_title": "x402: या निपटाऱ्यांच्या मागे पेमेंट ट्रस्ट लेयर"},"agent_identities": {"1_call_create_identity": "1 · कॉल create_identity",diff --git a/public/locales/ms.json b/public/locales/ms.jsonindex 4d3302dae..500546853 100644--- a/public/locales/ms.json+++ b/public/locales/ms.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Pertukaran Agen",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Beli intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Beli intel · $0.01 USDC</span>","buy_intel_on": "Beli intel di:","buyer": "PEMBELI","buyer_agent": "Agen Pembeli","intel_agent": "Agen Intel","meta_description": "Dua agen AI dengan badan 3D berunding dan membayar satu sama lain untuk intel crypto secara langsung menggunakan pembayaran mikro x402 di Solana. Setiap transaksi adalah nyata dan disahkan di rantai.","meta_og_description": "Dua agen AI 3D membeli dan menjual intel crypto untuk USDC sebenar di Solana. Saksikan setiap transaksi disahkan di rantai.",- "meta_og_title": "Pertukaran Agen — agen AI membayar satu sama lain dalam masa nyata",- "meta_title": "Pertukaran Agen — agen AI 3D membayar satu sama lain dalam masa nyata · three.ws",+ "meta_og_title": "Pertukaran Agen: agen AI membayar satu sama lain dalam masa nyata",+ "meta_title": "Pertukaran Agen: agen AI 3D membayar satu sama lain dalam masa nyata · three.ws","meta_twitter_description": "Dua agen AI 3D membayar satu sama lain untuk intel crypto yang sebenar. USDC di Solana. Di rantai.",- "meta_twitter_title": "Pertukaran Agen — agen AI membayar satu sama lain dalam masa nyata",+ "meta_twitter_title": "Pertukaran Agen: agen AI membayar satu sama lain dalam masa nyata","seller": "PENJUAL","session_total_0_00_usdc_settled_on": "Jumlah sesi: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC diselesaikan di rantai","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo bayar-per-panggilan",- "x402_the_payment_trust_layer_title": "x402 — lapisan kepercayaan pembayaran di sebalik penyelesaian ini"+ "x402_the_payment_trust_layer_title": "x402: lapisan kepercayaan pembayaran di sebalik penyelesaian ini"},"agent_identities": {"1_call_create_identity": "1 · Panggil create_identity",diff --git a/public/locales/mt.json b/public/locales/mt.jsonindex 42f5b61f9..51edf4949 100644--- a/public/locales/mt.json+++ b/public/locales/mt.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Skambju ta' Aġenti",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Ixtri intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Ixtri intel · $0.01 USDC</span>","buy_intel_on": "Ixtri intel fuq:","buyer": "XERREJ","buyer_agent": "Aġent Xerrej","intel_agent": "Aġent Intel","meta_description": "Żewġ aġenti tal-AI b'korpi 3D jinnegozjaw u jħallsu lil xulxin għal intel kripto live bl-użu ta' mikropagamenti x402 fuq Solana. Kull transazzjoni hija reali u kkonfermata fuq il-katina.","meta_og_description": "Żewġ aġenti tal-AI 3D jixtru u jbigħu intel kripto għal USDC reali fuq Solana. Ara kull transazzjoni tikkonferma fuq il-katina.",- "meta_og_title": "Skambju ta' Aġenti — Aġenti tal-AI jħallsu lil xulxin f'ħin reali",- "meta_title": "Skambju ta' Aġenti — Aġenti tal-AI 3D iħallsu lil xulxin f'ħin reali · three.ws",+ "meta_og_title": "Skambju ta' Aġenti: Aġenti tal-AI jħallsu lil xulxin f'ħin reali",+ "meta_title": "Skambju ta' Aġenti: Aġenti tal-AI 3D iħallsu lil xulxin f'ħin reali · three.ws","meta_twitter_description": "Żewġ aġenti tal-AI 3D iħallsu lil xulxin għal intel kripto reali. USDC fuq Solana. Fuq il-katina.",- "meta_twitter_title": "Skambju ta' Aġenti — Aġenti tal-AI jħallsu lil xulxin f'ħin reali",+ "meta_twitter_title": "Skambju ta' Aġenti: Aġenti tal-AI jħallsu lil xulxin f'ħin reali","seller": "BEJJIEGĦ","session_total_0_00_usdc_settled_on": "Total tas-sessjoni: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC solvut fuq il-katina","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo ta' ħlas skont is-sejħa",- "x402_the_payment_trust_layer_title": "x402 — is-saff ta' fiduċja tal-ħlas wara dawn is-saldu"+ "x402_the_payment_trust_layer_title": "x402: is-saff ta' fiduċja tal-ħlas wara dawn is-saldu"},"agent_identities": {"1_call_create_identity": "1 · Sejjaħ create_identity",diff --git a/public/locales/my.json b/public/locales/my.jsonindex 315e61ec0..5c5aa5aa5 100644--- a/public/locales/my.json+++ b/public/locales/my.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>အေးဂျင့်ဖလှယ်မှု",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ထောက်လှမ်းရေးဝယ်ယူပါ — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ထောက်လှမ်းရေးဝယ်ယူပါ · $0.01 USDC</span>","buy_intel_on": "ထောက်လှမ်းရေးဝယ်ယူရန်-","buyer": "ဝယ်သူ","buyer_agent": "ဝယ်သူအေးဂျင့်","intel_agent": "ထောက်လှမ်းရေးအေးဂျင့်","meta_description": "3D ကိုယ်ထည်ရှိသော AI အေးဂျင့်နှစ်ဦးသည် Solana ပေါ်ရှိ x402 မိုက်ခရိုငွေပေးချေမှုများကို အသုံးပြု၍ တိုက်ရိုက် crypto ထောက်လှမ်းရေးအတွက် အချင်းချင်း ညှိနှိုင်းပြီး ပေးချေကြသည်။ အရောင်းအဝယ်တိုင်းသည် အမှန်တကယ်ဖြစ်ပြီး on-chain တွင် အတည်ပြုထားသည်။","meta_og_description": "3D AI အေးဂျင့်နှစ်ဦးသည် Solana ပေါ်တွင် စစ်မှန်သော USDC ဖြင့် crypto ထောက်လှမ်းရေးကို ဝယ်ယူရောင်းချကြသည်။ အရောင်းအဝယ်တိုင်း on-chain တွင် အတည်ပြုသည်ကို ကြည့်ရှုပါ။",- "meta_og_title": "အေးဂျင့်ဖလှယ်မှု — AI အေးဂျင့်များ အချိန်နှင့်တစ်ပြေးညီ အချင်းချင်း ပေးချေခြင်း",- "meta_title": "အေးဂျင့်ဖလှယ်မှု — 3D AI အေးဂျင့်များ အချိန်နှင့်တစ်ပြေးညီ အချင်းချင်း ပေးချေခြင်း · three.ws",+ "meta_og_title": "အေးဂျင့်ဖလှယ်မှု: AI အေးဂျင့်များ အချိန်နှင့်တစ်ပြေးညီ အချင်းချင်း ပေးချေခြင်း",+ "meta_title": "အေးဂျင့်ဖလှယ်မှု: 3D AI အေးဂျင့်များ အချိန်နှင့်တစ်ပြေးညီ အချင်းချင်း ပေးချေခြင်း · three.ws","meta_twitter_description": "3D AI အေးဂျင့်နှစ်ဦးသည် စစ်မှန်သော crypto ထောက်လှမ်းရေးအတွက် အချင်းချင်း ပေးချေကြသည်။ Solana ပေါ်တွင် USDC။ On-chain။",- "meta_twitter_title": "အေးဂျင့်ဖလှယ်မှု — AI အေးဂျင့်များ အချိန်နှင့်တစ်ပြေးညီ အချင်းချင်း ပေးချေခြင်း",+ "meta_twitter_title": "အေးဂျင့်ဖလှယ်မှု: AI အေးဂျင့်များ အချိန်နှင့်တစ်ပြေးညီ အချင်းချင်း ပေးချေခြင်း","seller": "ရောင်းသူ","session_total_0_00_usdc_settled_on": "စက်ရှင်စုစုပေါင်း- <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC on-chain တွင် အခြေချပြီး","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 ခေါ်ဆိုမှုအလိုက် ငွေပေးချေမှု သရုပ်ပြ",- "x402_the_payment_trust_layer_title": "x402 — ဤအခြေချမှုများနောက်ကွယ်မှ ငွေပေးချေမှု ယုံကြည်စိတ်ချရသော အလွှာ"+ "x402_the_payment_trust_layer_title": "x402: ဤအခြေချမှုများနောက်ကွယ်မှ ငွေပေးချေမှု ယုံကြည်စိတ်ချရသော အလွှာ"},"agent_identities": {"1_call_create_identity": "1 · create_identity ကို ခေါ်ဆိုပါ",diff --git a/public/locales/ne.json b/public/locales/ne.jsonindex 0febd7cb4..ef9f31787 100644--- a/public/locales/ne.json+++ b/public/locales/ne.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>एजेन्ट एक्सचेन्ज",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">इन्टेल किन्नुहोस् — $०.०१ USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">इन्टेल किन्नुहोस् · $०.०१ USDC</span>","buy_intel_on": "यसमा इन्टेल किन्नुहोस्:","buyer": "क्रेता","buyer_agent": "क्रेता एजेन्ट","intel_agent": "इन्टेल एजेन्ट","meta_description": "दुई 3D शरीर भएका AI एजेन्टहरूले Solana मा x402 माइक्रोपेमेन्ट प्रयोग गरी लाइभ क्रिप्टो इन्टेलका लागि एकअर्कासँग वार्ता गर्छन् र भुक्तानी गर्छन्। हरेक लेनदेन वास्तविक र अन-चेनमा पुष्टि हुन्छ।","meta_og_description": "दुई 3D AI एजेन्टहरूले वास्तविक USDC को लागि Solana मा क्रिप्टो इन्टेल किन्छन् र बेच्छन्। हरेक लेनदेन अन-चेनमा पुष्टि भएको हेर्नुहोस्।",- "meta_og_title": "एजेन्ट एक्सचेन्ज — AI एजेन्टहरूले वास्तविक समयमा एकअर्कालाई भुक्तानी गर्दै",- "meta_title": "एजेन्ट एक्सचेन्ज — 3D AI एजेन्टहरूले वास्तविक समयमा एकअर्कालाई भुक्तानी गर्दै · three.ws",+ "meta_og_title": "एजेन्ट एक्सचेन्ज: AI एजेन्टहरूले वास्तविक समयमा एकअर्कालाई भुक्तानी गर्दै",+ "meta_title": "एजेन्ट एक्सचेन्ज: 3D AI एजेन्टहरूले वास्तविक समयमा एकअर्कालाई भुक्तानी गर्दै · three.ws","meta_twitter_description": "दुई 3D AI एजेन्टहरूले वास्तविक क्रिप्टो इन्टेलका लागि एकअर्कालाई भुक्तानी गर्दै। USDC Solana मा। अन-चेन।",- "meta_twitter_title": "एजेन्ट एक्सचेन्ज — AI एजेन्टहरूले वास्तविक समयमा एकअर्कालाई भुक्तानी गर्दै",+ "meta_twitter_title": "एजेन्ट एक्सचेन्ज: AI एजेन्टहरूले वास्तविक समयमा एकअर्कालाई भुक्तानी गर्दै","seller": "विक्रेता","session_total_0_00_usdc_settled_on": "सत्र कुल: <span class=\"tv\" id=\"totalUsdc\">$०.००</span> USDC अन-चेनमा सेटल गरियो","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 पे-पर-कल डेमो",- "x402_the_payment_trust_layer_title": "x402 — यी सेटलमेन्टहरू पछाडिको भुक्तानी विश्वास तह"+ "x402_the_payment_trust_layer_title": "x402: यी सेटलमेन्टहरू पछाडिको भुक्तानी विश्वास तह"},"agent_identities": {"1_call_create_identity": "१ · create_identity लाई कल गर्नुहोस्",diff --git a/public/locales/nl.json b/public/locales/nl.jsonindex 11399a808..f693ab6ad 100644--- a/public/locales/nl.json+++ b/public/locales/nl.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agent Uitwisseling",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Koop intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Koop intel · $0.01 USDC</span>","buy_intel_on": "Koop intel op:","buyer": "KOPER","buyer_agent": "Koper Agent","intel_agent": "Intel Agent","meta_description": "Twee AI-agenten met 3D-lichamen onderhandelen en betalen elkaar voor live crypto intel met x402 micropayments op Solana. Elke transactie is echt en bevestigd op-chain.","meta_og_description": "Twee 3D AI-agenten kopen en verkopen crypto intel voor echte USDC op Solana. Kijk hoe elke transactie op-chain wordt bevestigd.",- "meta_og_title": "Agent Uitwisseling — AI-agenten die elkaar in real-time betalen",- "meta_title": "Agent Uitwisseling — 3D AI-agenten die elkaar in real-time betalen · three.ws",+ "meta_og_title": "Agent Uitwisseling: AI-agenten die elkaar in real-time betalen",+ "meta_title": "Agent Uitwisseling: 3D AI-agenten die elkaar in real-time betalen · three.ws","meta_twitter_description": "Twee 3D AI-agenten die elkaar betalen voor echte crypto intel. USDC op Solana. Op-chain.",- "meta_twitter_title": "Agent Uitwisseling — AI-agenten die elkaar in real-time betalen",+ "meta_twitter_title": "Agent Uitwisseling: AI-agenten die elkaar in real-time betalen","seller": "VERKOPER","session_total_0_00_usdc_settled_on": "Sessie totaal: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC afgewikkeld op-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 pay-per-call demo",- "x402_the_payment_trust_layer_title": "x402 — de betalingsvertrouwenslaag achter deze afrekeningen"+ "x402_the_payment_trust_layer_title": "x402: de betalingsvertrouwenslaag achter deze afrekeningen"},"agent_identities": {"1_call_create_identity": "1 · Bel create_identity",diff --git a/public/locales/no.json b/public/locales/no.jsonindex 5e31063df..6c14c93c0 100644--- a/public/locales/no.json+++ b/public/locales/no.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agentutveksling",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kjøp intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kjøp intel · $0.01 USDC</span>","buy_intel_on": "Kjøp intel på:","buyer": "KJØPER","buyer_agent": "Kjøperagent","intel_agent": "Intel-agent","meta_description": "To AI-agenter med 3D-kropper forhandler og betaler hverandre for live kryptoinformasjon ved hjelp av x402 mikrobetalinger på Solana. Hver transaksjon er ekte og bekreftet på kjeden.","meta_og_description": "To 3D AI-agenter kjøper og selger kryptoinformasjon for ekte USDC på Solana. Se hver transaksjon bekreftes på kjeden.",- "meta_og_title": "Agentutveksling — AI-agenter som betaler hverandre i sanntid",- "meta_title": "Agentutveksling — 3D AI-agenter som betaler hverandre i sanntid · three.ws",+ "meta_og_title": "Agentutveksling: AI-agenter som betaler hverandre i sanntid",+ "meta_title": "Agentutveksling: 3D AI-agenter som betaler hverandre i sanntid · three.ws","meta_twitter_description": "To 3D AI-agenter som betaler hverandre for ekte kryptoinformasjon. USDC på Solana. På kjeden.",- "meta_twitter_title": "Agentutveksling — AI-agenter som betaler hverandre i sanntid",+ "meta_twitter_title": "Agentutveksling: AI-agenter som betaler hverandre i sanntid","seller": "SELGER","session_total_0_00_usdc_settled_on": "Sesjon total: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC oppgjort på kjeden","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 betalingsdemo per samtale",- "x402_the_payment_trust_layer_title": "x402 — betalings tillitslagret bak disse oppgjørene"+ "x402_the_payment_trust_layer_title": "x402: betalings tillitslagret bak disse oppgjørene"},"agent_identities": {"1_call_create_identity": "1 · Ring opprett identitet",diff --git a/public/locales/or.json b/public/locales/or.jsonindex fddf0ec55..20ab03ef1 100644--- a/public/locales/or.json+++ b/public/locales/or.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>ଏଜେଣ୍ଟ ଏକ୍ସଚେଞ୍ଜ୍",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ଇଣ୍ଟେଲ୍ କିଣନ୍ତୁ — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ଇଣ୍ଟେଲ୍ କିଣନ୍ତୁ · $0.01 USDC</span>","buy_intel_on": "ଏହା ଉପରେ ଇଣ୍ଟେଲ୍ କିଣନ୍ତୁ:","buyer": "କ୍ରେତା","buyer_agent": "କ୍ରେତା ଏଜେଣ୍ଟ","intel_agent": "ଇଣ୍ଟେଲ୍ ଏଜେଣ୍ଟ","meta_description": "3D ଶରୀର ଥିବା ଦୁଇଟି AI ଏଜେଣ୍ଟ Solana ଉପରେ x402 ମାଇକ୍ରୋପେମେଣ୍ଟ୍ ବ୍ୟବହାର କରି ଲାଇଭ୍ କ୍ରିପ୍ଟୋ ଇଣ୍ଟେଲ୍ ପାଇଁ ପରସ୍ପର ସହିତ ଆଲୋଚନା କରି ଦେୟ ପ୍ରଦାନ କରନ୍ତି। ପ୍ରତ୍ୟେକ କାରବାର ବାସ୍ତବ ଏବଂ ଅନ୍-ଚେନ୍ରେ ନିଶ୍ଚିତ ହୋଇଛି।","meta_og_description": "ଦୁଇଟି 3D AI ଏଜେଣ୍ଟ Solana ଉପରେ ପ୍ରକୃତ USDC ପାଇଁ କ୍ରିପ୍ଟୋ ଇଣ୍ଟେଲ୍ କିଣନ୍ତି ଏବଂ ବିକ୍ରି କରନ୍ତି। ପ୍ରତ୍ୟେକ କାରବାର ଅନ୍-ଚେନ୍ରେ ନିଶ୍ଚିତ ହେଉଥିବା ଦେଖନ୍ତୁ।",- "meta_og_title": "ଏଜେଣ୍ଟ ଏକ୍ସଚେଞ୍ଜ୍ — AI ଏଜେଣ୍ଟମାନେ ରିଅଲ୍ ଟାଇମ୍ରେ ପରସ୍ପରକୁ ଦେୟ ପ୍ରଦାନ କରୁଛନ୍ତି",- "meta_title": "ଏଜେଣ୍ଟ ଏକ୍ସଚେଞ୍ଜ୍ — 3D AI ଏଜେଣ୍ଟମାନେ ରିଅଲ୍ ଟାଇମ୍ରେ ପରସ୍ପରକୁ ଦେୟ ପ୍ରଦାନ କରୁଛନ୍ତି · three.ws",+ "meta_og_title": "ଏଜେଣ୍ଟ ଏକ୍ସଚେଞ୍ଜ୍: AI ଏଜେଣ୍ଟମାନେ ରିଅଲ୍ ଟାଇମ୍ରେ ପରସ୍ପରକୁ ଦେୟ ପ୍ରଦାନ କରୁଛନ୍ତି",+ "meta_title": "ଏଜେଣ୍ଟ ଏକ୍ସଚେଞ୍ଜ୍: 3D AI ଏଜେଣ୍ଟମାନେ ରିଅଲ୍ ଟାଇମ୍ରେ ପରସ୍ପରକୁ ଦେୟ ପ୍ରଦାନ କରୁଛନ୍ତି · three.ws","meta_twitter_description": "ଦୁଇଟି 3D AI ଏଜେଣ୍ଟ ପ୍ରକୃତ କ୍ରିପ୍ଟୋ ଇଣ୍ଟେଲ୍ ପାଇଁ ପରସ୍ପରକୁ ଦେୟ ପ୍ରଦାନ କରୁଛନ୍ତି। Solana ଉପରେ USDC। ଅନ୍-ଚେନ୍।",- "meta_twitter_title": "ଏଜେଣ୍ଟ ଏକ୍ସଚେଞ୍ଜ୍ — AI ଏଜେଣ୍ଟମାନେ ରିଅଲ୍ ଟାଇମ୍ରେ ପରସ୍ପରକୁ ଦେୟ ପ୍ରଦାନ କରୁଛନ୍ତି",+ "meta_twitter_title": "ଏଜେଣ୍ଟ ଏକ୍ସଚେଞ୍ଜ୍: AI ଏଜେଣ୍ଟମାନେ ରିଅଲ୍ ଟାଇମ୍ରେ ପରସ୍ପରକୁ ଦେୟ ପ୍ରଦାନ କରୁଛନ୍ତି","seller": "ବିକ୍ରେତା","session_total_0_00_usdc_settled_on": "ସେସନ୍ ମୋଟ: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC ଅନ୍-ଚେନ୍ରେ ସମାଧାନ ହୋଇଛି","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 ପେ-ପର୍-କଲ୍ ଡେମୋ",- "x402_the_payment_trust_layer_title": "x402 — ଏହି ସେଟେଲମେଣ୍ଟ୍ ପଛରେ ଥିବା ପେମେଣ୍ଟ୍ ଟ୍ରଷ୍ଟ୍ ଲେୟର୍"+ "x402_the_payment_trust_layer_title": "x402: ଏହି ସେଟେଲମେଣ୍ଟ୍ ପଛରେ ଥିବା ପେମେଣ୍ଟ୍ ଟ୍ରଷ୍ଟ୍ ଲେୟର୍"},"agent_identities": {"1_call_create_identity": "1 · create_identity କଲ୍ କରନ୍ତୁ",diff --git a/public/locales/pa.json b/public/locales/pa.jsonindex 0d243a770..7bc58cb2d 100644--- a/public/locales/pa.json+++ b/public/locales/pa.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>ਏਜੰਟ ਐਕਸਚੇਂਜ",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ਇੰਟੈਲ ਖਰੀਦੋ — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ਇੰਟੈਲ ਖਰੀਦੋ · $0.01 USDC</span>","buy_intel_on": "ਇੰਟੈਲ ਖਰੀਦੋ:","buyer": "ਖਰੀਦਦਾਰ","buyer_agent": "ਖਰੀਦਦਾਰ ਏਜੰਟ","intel_agent": "ਇੰਟੈਲ ਏਜੰਟ","meta_description": "ਦੋ 3D ਸਰੀਰ ਵਾਲੇ AI ਏਜੰਟ Solana 'ਤੇ x402 ਮਾਈਕ੍ਰੋਪੇਮੈਂਟਸ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਲਾਈਵ ਕ੍ਰਿਪਟੋ ਇੰਟੈਲ ਲਈ ਇੱਕ ਦੂਜੇ ਨਾਲ ਗੱਲਬਾਤ ਕਰਦੇ ਹਨ ਅਤੇ ਭੁਗਤਾਨ ਕਰਦੇ ਹਨ। ਹਰ ਲੈਣ-ਦੇਣ ਅਸਲੀ ਹੈ ਅਤੇ ਆਨ-ਚੇਨ 'ਤੇ ਪੁਸ਼ਟੀ ਕੀਤੀ ਜਾਂਦੀ ਹੈ।","meta_og_description": "ਦੋ 3D AI ਏਜੰਟ Solana 'ਤੇ ਅਸਲੀ USDC ਲਈ ਕ੍ਰਿਪਟੋ ਇੰਟੈਲ ਖਰੀਦਦੇ ਅਤੇ ਵੇਚਦੇ ਹਨ। ਹਰ ਲੈਣ-ਦੇਣ ਨੂੰ ਆਨ-ਚੇਨ 'ਤੇ ਪੁਸ਼ਟੀ ਹੁੰਦੇ ਦੇਖੋ।",- "meta_og_title": "ਏਜੰਟ ਐਕਸਚੇਂਜ — AI ਏਜੰਟ ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ ਇੱਕ ਦੂਜੇ ਨੂੰ ਭੁਗਤਾਨ ਕਰ ਰਹੇ ਹਨ",- "meta_title": "ਏਜੰਟ ਐਕਸਚੇਂਜ — 3D AI ਏਜੰਟ ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ ਇੱਕ ਦੂਜੇ ਨੂੰ ਭੁਗਤਾਨ ਕਰ ਰਹੇ ਹਨ · three.ws",+ "meta_og_title": "ਏਜੰਟ ਐਕਸਚੇਂਜ: AI ਏਜੰਟ ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ ਇੱਕ ਦੂਜੇ ਨੂੰ ਭੁਗਤਾਨ ਕਰ ਰਹੇ ਹਨ",+ "meta_title": "ਏਜੰਟ ਐਕਸਚੇਂਜ: 3D AI ਏਜੰਟ ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ ਇੱਕ ਦੂਜੇ ਨੂੰ ਭੁਗਤਾਨ ਕਰ ਰਹੇ ਹਨ · three.ws","meta_twitter_description": "ਦੋ 3D AI ਏਜੰਟ ਅਸਲੀ ਕ੍ਰਿਪਟੋ ਇੰਟੈਲ ਲਈ ਇੱਕ ਦੂਜੇ ਨੂੰ ਭੁਗਤਾਨ ਕਰ ਰਹੇ ਹਨ। USDC Solana 'ਤੇ। ਆਨ-ਚੇਨ।",- "meta_twitter_title": "ਏਜੰਟ ਐਕਸਚੇਂਜ — AI ਏਜੰਟ ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ ਇੱਕ ਦੂਜੇ ਨੂੰ ਭੁਗਤਾਨ ਕਰ ਰਹੇ ਹਨ",+ "meta_twitter_title": "ਏਜੰਟ ਐਕਸਚੇਂਜ: AI ਏਜੰਟ ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ ਇੱਕ ਦੂਜੇ ਨੂੰ ਭੁਗਤਾਨ ਕਰ ਰਹੇ ਹਨ","seller": "ਵੇਚਣ ਵਾਲਾ","session_total_0_00_usdc_settled_on": "ਸੈਸ਼ਨ ਕੁੱਲ: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC ਆਨ-ਚੇਨ 'ਤੇ ਨਿਪਟਾਇਆ ਗਿਆ","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 ਪ੍ਰਤੀ-ਕਾਲ ਭੁਗਤਾਨ ਡੈਮੋ",- "x402_the_payment_trust_layer_title": "x402 — ਇਹਨਾਂ ਨਿਪਟਾਰਿਆਂ ਦੇ ਪਿੱਛੇ ਭੁਗਤਾਨ ਭਰੋਸੇਯੋਗਤਾ ਪਰਤ"+ "x402_the_payment_trust_layer_title": "x402: ਇਹਨਾਂ ਨਿਪਟਾਰਿਆਂ ਦੇ ਪਿੱਛੇ ਭੁਗਤਾਨ ਭਰੋਸੇਯੋਗਤਾ ਪਰਤ"},"agent_identities": {"1_call_create_identity": "1 · create_identity ਨੂੰ ਕਾਲ ਕਰੋ",diff --git a/public/locales/pl.json b/public/locales/pl.jsonindex 7dbfed5ae..c16e00a22 100644--- a/public/locales/pl.json+++ b/public/locales/pl.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Wymiana Agentów",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kup intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kup intel · $0.01 USDC</span>","buy_intel_on": "Kup intel na:","buyer": "KUPUJĄCY","buyer_agent": "Agent Kupujący","intel_agent": "Agent Intel","meta_description": "Dwaj agenci AI z ciałami 3D negocjują i płacą sobie nawzajem za na żywo kryptoinformacje, używając x402 mikropłatności na Solana. Każda transakcja jest rzeczywista i potwierdzona na łańcuchu.","meta_og_description": "Dwaj agenci AI 3D kupują i sprzedają kryptoinformacje za prawdziwe USDC na Solana. Obserwuj, jak każda transakcja potwierdza się na łańcuchu.",- "meta_og_title": "Wymiana Agentów — agenci AI płacący sobie nawzajem w czasie rzeczywistym",- "meta_title": "Wymiana Agentów — agenci AI 3D płacący sobie nawzajem w czasie rzeczywistym · three.ws",+ "meta_og_title": "Wymiana Agentów: agenci AI płacący sobie nawzajem w czasie rzeczywistym",+ "meta_title": "Wymiana Agentów: agenci AI 3D płacący sobie nawzajem w czasie rzeczywistym · three.ws","meta_twitter_description": "Dwaj agenci AI 3D płacący sobie nawzajem za prawdziwe kryptoinformacje. USDC na Solana. Na łańcuchu.",- "meta_twitter_title": "Wymiana Agentów — agenci AI płacący sobie nawzajem w czasie rzeczywistym",+ "meta_twitter_title": "Wymiana Agentów: agenci AI płacący sobie nawzajem w czasie rzeczywistym","seller": "SPRZEDAJĄCY","session_total_0_00_usdc_settled_on": "Całkowity wynik sesji: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC rozliczone na łańcuchu","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo płatności za połączenie",- "x402_the_payment_trust_layer_title": "x402 — warstwa zaufania płatności stojąca za tymi rozliczeniami"+ "x402_the_payment_trust_layer_title": "x402: warstwa zaufania płatności stojąca za tymi rozliczeniami"},"agent_identities": {"1_call_create_identity": "1 · Zadzwoń, aby utworzyć tożsamość",diff --git a/public/locales/ps.json b/public/locales/ps.jsonindex 3295f768a..0c0f257fd 100644--- a/public/locales/ps.json+++ b/public/locales/ps.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span> ایجنټ تبادله",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\"> استخبارات وپیرئ — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\"> استخبارات وپیرئ · $0.01 USDC</span>","buy_intel_on": "پر دې استخبارات وپیرئ:","buyer": "پیرودونکی","buyer_agent": "پیرودونکی ایجنټ","intel_agent": "استخباراتي ایجنټ","meta_description": "دوه AI ایجنټونه د 3D بدنونو سره د x402 مایکرو تادیاتو په کارولو سره په Solana کې د ژوندي کریپټو استخباراتو لپاره له یو بل سره خبرې کوي او تادیه کوي. هره معامله ریښتینې ده او په زنځیر کې تایید شوې.","meta_og_description": "دوه 3D AI ایجنټونه په Solana کې د ریښتیني USDC لپاره کریپټو استخبارات اخلي او پلوري. هره معامله په زنځیر کې تایید کړئ.",- "meta_og_title": "ایجنټ تبادله — AI ایجنټونه په ریښتیني وخت کې یو بل ته تادیه کوي",- "meta_title": "ایجنټ تبادله — 3D AI ایجنټونه په ریښتیني وخت کې یو بل ته تادیه کوي · three.ws",+ "meta_og_title": "ایجنټ تبادله: AI ایجنټونه په ریښتیني وخت کې یو بل ته تادیه کوي",+ "meta_title": "ایجنټ تبادله: 3D AI ایجنټونه په ریښتیني وخت کې یو بل ته تادیه کوي · three.ws","meta_twitter_description": "دوه 3D AI ایجنټونه د ریښتیني کریپټو استخباراتو لپاره یو بل ته تادیه کوي. USDC په Solana کې. په زنځیر کې.",- "meta_twitter_title": "ایجنټ تبادله — AI ایجنټونه په ریښتیني وخت کې یو بل ته تادیه کوي",+ "meta_twitter_title": "ایجنټ تبادله: AI ایجنټونه په ریښتیني وخت کې یو بل ته تادیه کوي","seller": "پلورونکی","session_total_0_00_usdc_settled_on": "د سیشن ټولیز: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC په زنځیر کې حل شو","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 د هر کال په بدل کې د تادیې ډیمو",- "x402_the_payment_trust_layer_title": "x402 — د دې تصفیو تر شا د تادیاتو د باور طبقه"+ "x402_the_payment_trust_layer_title": "x402: د دې تصفیو تر شا د تادیاتو د باور طبقه"},"agent_identities": {"1_call_create_identity": "1 · create_identity ته زنګ ووهئ",diff --git a/public/locales/pt-BR.json b/public/locales/pt-BR.jsonindex 446aa021c..06045b691 100644--- a/public/locales/pt-BR.json+++ b/public/locales/pt-BR.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agent Exchange",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Comprar intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Comprar intel · $0.01 USDC</span>","buy_intel_on": "Comprar intel sobre:","buyer": "COMPRADOR","buyer_agent": "Agente Comprador","intel_agent": "Agente de Intel","meta_description": "Dois agentes de IA com corpos 3D negociam e pagam um ao outro por intel cripto em tempo real usando micropagamentos x402 em Solana. Cada transação é real e confirmada on-chain.","meta_og_description": "Dois agentes de IA 3D compram e vendem intel cripto por USDC real em Solana. Veja cada transação ser confirmada on-chain.",- "meta_og_title": "Agent Exchange — Agentes de IA pagando uns aos outros em tempo real",- "meta_title": "Agent Exchange — Agentes de IA 3D pagando uns aos outros em tempo real · three.ws",+ "meta_og_title": "Agent Exchange: Agentes de IA pagando uns aos outros em tempo real",+ "meta_title": "Agent Exchange: Agentes de IA 3D pagando uns aos outros em tempo real · three.ws","meta_twitter_description": "Dois agentes de IA 3D pagando uns aos outros por intel cripto real. USDC em Solana. On-chain.",- "meta_twitter_title": "Agent Exchange — Agentes de IA pagando uns aos outros em tempo real",+ "meta_twitter_title": "Agent Exchange: Agentes de IA pagando uns aos outros em tempo real","seller": "VENDEDOR","session_total_0_00_usdc_settled_on": "Total da sessão: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC liquidado on-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "Demo de pay-per-call x402",- "x402_the_payment_trust_layer_title": "x402 — a camada de confiança de pagamentos por trás dessas liquidações"+ "x402_the_payment_trust_layer_title": "x402: a camada de confiança de pagamentos por trás dessas liquidações"},"agent_identities": {"1_call_create_identity": "1 · Chamar create_identity",diff --git a/public/locales/ro.json b/public/locales/ro.jsonindex fb98bdfbd..597bc6073 100644--- a/public/locales/ro.json+++ b/public/locales/ro.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Schimb de Agenți",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Cumpără intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Cumpără intel · $0.01 USDC</span>","buy_intel_on": "Cumpără intel pe:","buyer": "CUMPĂRĂTOR","buyer_agent": "Agent Cumpărător","intel_agent": "Agent Intel","meta_description": "Două agenți AI cu corpuri 3D negociază și se plătesc reciproc pentru intel crypto live folosind micropayments x402 pe Solana. Fiecare tranzacție este reală și confirmată pe blockchain.","meta_og_description": "Două agenți AI 3D cumpără și vând intel crypto pentru USDC reale pe Solana. Urmărește fiecare tranzacție confirmată pe blockchain.",- "meta_og_title": "Schimb de Agenți — agenți AI plătind reciproc în timp real",- "meta_title": "Schimb de Agenți — agenți AI 3D plătind reciproc în timp real · three.ws",+ "meta_og_title": "Schimb de Agenți: agenți AI plătind reciproc în timp real",+ "meta_title": "Schimb de Agenți: agenți AI 3D plătind reciproc în timp real · three.ws","meta_twitter_description": "Două agenți AI 3D plătind reciproc pentru intel crypto reale. USDC pe Solana. Pe blockchain.",- "meta_twitter_title": "Schimb de Agenți — agenți AI plătind reciproc în timp real",+ "meta_twitter_title": "Schimb de Agenți: agenți AI plătind reciproc în timp real","seller": "VÂNZĂTOR","session_total_0_00_usdc_settled_on": "Total sesiune: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC reglementat pe blockchain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo plată-per-apel",- "x402_the_payment_trust_layer_title": "x402 — stratul de încredere pentru plăți din spatele acestor reglementări"+ "x402_the_payment_trust_layer_title": "x402: stratul de încredere pentru plăți din spatele acestor reglementări"},"agent_identities": {"1_call_create_identity": "1 · Apelează create_identity",diff --git a/public/locales/ru.json b/public/locales/ru.jsonindex cc279153b..06598e990 100644--- a/public/locales/ru.json+++ b/public/locales/ru.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Биржа агентов",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Купить данные — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Купить данные · $0.01 USDC</span>","buy_intel_on": "Купить данные на:","buyer": "ПОКУПАТЕЛЬ","buyer_agent": "Агент-покупатель","intel_agent": "Агент по данным","meta_description": "Два ИИ-агента с 3D-телами взаимодействуют и оплачивают друг другу актуальные криптоданные, используя микроплатежи x402 на Solana. Каждая транзакция реальна и подтверждена ончейн.","meta_og_description": "Два 3D ИИ-агента покупают и продают криптоданные за реальные USDC на Solana. Следите за подтверждением каждой транзакции ончейн.",- "meta_og_title": "Биржа агентов — ИИ-агенты платят друг другу в реальном времени",- "meta_title": "Биржа агентов — 3D ИИ-агенты платят друг другу в реальном времени · three.ws",+ "meta_og_title": "Биржа агентов: ИИ-агенты платят друг другу в реальном времени",+ "meta_title": "Биржа агентов: 3D ИИ-агенты платят друг другу в реальном времени · three.ws","meta_twitter_description": "Два 3D ИИ-агента платят друг другу за реальные криптоданные. USDC на Solana. Ончейн.",- "meta_twitter_title": "Биржа агентов — ИИ-агенты платят друг другу в реальном времени",+ "meta_twitter_title": "Биржа агентов: ИИ-агенты платят друг другу в реальном времени","seller": "ПРОДАВЕЦ","session_total_0_00_usdc_settled_on": "Итого за сессию: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC урегулировано ончейн","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 демо с оплатой за вызов",- "x402_the_payment_trust_layer_title": "x402 — слой доверия для платежей, лежащий в основе этих расчетов"+ "x402_the_payment_trust_layer_title": "x402: слой доверия для платежей, лежащий в основе этих расчетов"},"agent_identities": {"1_call_create_identity": "1 · Вызов create_identity",diff --git a/public/locales/rw.json b/public/locales/rw.jsonindex e83bd2ac6..a45b778f6 100644--- a/public/locales/rw.json+++ b/public/locales/rw.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Ivunjisha ry'Abakozi",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Gura amakuru — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Gura amakuru · $0.01 USDC</span>","buy_intel_on": "Gura amakuru kuri:","buyer": "UGURA","buyer_agent": "Umukozi ugura","intel_agent": "Umukozi w'amakuru","meta_description": "Abakozi babiri ba AI bafite imibiri ya 3D baganira kandi bakishyurana amakuru ya crypto akurikiranwa bakoresheje micro-kwishyura ya x402 kuri Solana. Buri gikorwa cyose ni ukuri kandi cyemejwe kuri blockchain.","meta_og_description": "Abakozi babiri ba AI ba 3D bagura kandi bakagurisha amakuru ya crypto ku USDC nyayo kuri Solana. Reba buri gikorwa cyose cyemezwa kuri blockchain.",- "meta_og_title": "Ivunjisha ry'Abakozi — Abakozi ba AI bishyurana mu gihe nyacyo",- "meta_title": "Ivunjisha ry'Abakozi — Abakozi ba AI ba 3D bishyurana mu gihe nyacyo · three.ws",+ "meta_og_title": "Ivunjisha ry'Abakozi: Abakozi ba AI bishyurana mu gihe nyacyo",+ "meta_title": "Ivunjisha ry'Abakozi: Abakozi ba AI ba 3D bishyurana mu gihe nyacyo · three.ws","meta_twitter_description": "Abakozi babiri ba AI ba 3D bishyurana amakuru ya crypto nyayo. USDC kuri Solana. Kuri blockchain.",- "meta_twitter_title": "Ivunjisha ry'Abakozi — Abakozi ba AI bishyurana mu gihe nyacyo",+ "meta_twitter_title": "Ivunjisha ry'Abakozi: Abakozi ba AI bishyurana mu gihe nyacyo","seller": "UGURISHA","session_total_0_00_usdc_settled_on": "Igiteranyo cy'igihe: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC cyemejwe kuri blockchain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo yo kwishyura buri koresha",- "x402_the_payment_trust_layer_title": "x402 — urwego rw'icyizere rw'ubwishyu ruri inyuma y'izi nyishyurano"+ "x402_the_payment_trust_layer_title": "x402: urwego rw'icyizere rw'ubwishyu ruri inyuma y'izi nyishyurano"},"agent_identities": {"1_call_create_identity": "1 · Hamagara create_identity",diff --git a/public/locales/si.json b/public/locales/si.jsonindex 401dec3a1..d0c8ba642 100644--- a/public/locales/si.json+++ b/public/locales/si.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>නියෝජිත හුවමාරුව",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">බුද්ධිය මිලදී ගන්න — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">බුද්ධිය මිලදී ගන්න · $0.01 USDC</span>","buy_intel_on": "බුද්ධිය මිලදී ගන්න:","buyer": "ගැනුම්කරු","buyer_agent": "ගැනුම්කරු නියෝජිතයා","intel_agent": "බුද්ධි නියෝජිතයා","meta_description": "ත්රිමාණ ශරීර සහිත AI නියෝජිතයන් දෙදෙනෙකු Solana මත x402 ක්ෂුද්ර ගෙවීම් භාවිතයෙන් සජීවී ක්රිප්ටෝ බුද්ධිය සඳහා එකිනෙකා සමඟ සාකච්ඡා කර ගෙවයි. සෑම ගනුදෙනුවක්ම සැබෑ වන අතර දාමයේ තහවුරු වේ.","meta_og_description": "ත්රිමාණ AI නියෝජිතයන් දෙදෙනෙකු Solana මත සැබෑ USDC සඳහා ක්රිප්ටෝ බුද්ධිය මිලදී ගෙන විකුණයි. සෑම ගනුදෙනුවක්ම දාමයේ තහවුරු වන ආකාරය බලන්න.",- "meta_og_title": "නියෝජිත හුවමාරුව — AI නියෝජිතයන් තත්ය කාලීනව එකිනෙකාට ගෙවයි",- "meta_title": "නියෝජිත හුවමාරුව — ත්රිමාණ AI නියෝජිතයන් තත්ය කාලීනව එකිනෙකාට ගෙවයි · three.ws",+ "meta_og_title": "නියෝජිත හුවමාරුව: AI නියෝජිතයන් තත්ය කාලීනව එකිනෙකාට ගෙවයි",+ "meta_title": "නියෝජිත හුවමාරුව: ත්රිමාණ AI නියෝජිතයන් තත්ය කාලීනව එකිනෙකාට ගෙවයි · three.ws","meta_twitter_description": "ත්රිමාණ AI නියෝජිතයන් දෙදෙනෙකු සැබෑ ක්රිප්ටෝ බුද්ධිය සඳහා එකිනෙකාට ගෙවයි. USDC Solana මත. දාමයේ.",- "meta_twitter_title": "නියෝජිත හුවමාරුව — AI නියෝජිතයන් තත්ය කාලීනව එකිනෙකාට ගෙවයි",+ "meta_twitter_title": "නියෝජිත හුවමාරුව: AI නියෝජිතයන් තත්ය කාලීනව එකිනෙකාට ගෙවයි","seller": "විකුණුම්කරු","session_total_0_00_usdc_settled_on": "සැසිවාරයේ මුළු එකතුව: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC දාමයේ පියවා ඇත","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 ඇමතුමකට ගෙවන නිරූපණය",- "x402_the_payment_trust_layer_title": "x402 — මෙම බේරුම්කරණයන් පිටුපස ඇති ගෙවීම් විශ්වාසනීය ස්ථරය"+ "x402_the_payment_trust_layer_title": "x402: මෙම බේරුම්කරණයන් පිටුපස ඇති ගෙවීම් විශ්වාසනීය ස්ථරය"},"agent_identities": {"1_call_create_identity": "1 · create_identity අමතන්න",diff --git a/public/locales/sk.json b/public/locales/sk.jsonindex 7945df957..85e179868 100644--- a/public/locales/sk.json+++ b/public/locales/sk.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Borza agentov",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kúpiť intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kúpiť intel · $0.01 USDC</span>","buy_intel_on": "Kúpiť intel na:","buyer": "KUPUJÚCI","buyer_agent": "Kupujúci agent","intel_agent": "Intel agent","meta_description": "Dva AI agenti s 3D telami vyjednávajú a platia si navzájom za živé kryptoinformácie pomocou x402 mikroplatieb na Solana. Každá transakcia je skutočná a potvrdená na blockchaine.","meta_og_description": "Dva 3D AI agenti kupujú a predávajú kryptoinformácie za reálne USDC na Solana. Sledujte, ako sa každá transakcia potvrdí na blockchaine.",- "meta_og_title": "Agent Exchange — AI agenti si navzájom platia v reálnom čase",- "meta_title": "Agent Exchange — 3D AI agenti si navzájom platia v reálnom čase · three.ws",+ "meta_og_title": "Agent Exchange: AI agenti si navzájom platia v reálnom čase",+ "meta_title": "Agent Exchange: 3D AI agenti si navzájom platia v reálnom čase · three.ws","meta_twitter_description": "Dva 3D AI agenti si navzájom platia za reálne kryptoinformácie. USDC na Solana. Na blockchaine.",- "meta_twitter_title": "Agent Exchange — AI agenti si navzájom platia v reálnom čase",+ "meta_twitter_title": "Agent Exchange: AI agenti si navzájom platia v reálnom čase","seller": "PREDAJCA","session_total_0_00_usdc_settled_on": "Celkový súčet relácie: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC vyrovnané na blockchaine","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo platby za hovor",- "x402_the_payment_trust_layer_title": "x402 — vrstva dôvery v platby za týmito vyrovnaniami"+ "x402_the_payment_trust_layer_title": "x402: vrstva dôvery v platby za týmito vyrovnaniami"},"agent_identities": {"1_call_create_identity": "1 · Zavolať create_identity",diff --git a/public/locales/sl.json b/public/locales/sl.jsonindex 589bf9d1a..54c7fc4fa 100644--- a/public/locales/sl.json+++ b/public/locales/sl.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Menjalnica agentov",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kupi informacije — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kupi informacije · $0.01 USDC</span>","buy_intel_on": "Kupi informacije o:","buyer": "KUPEC","buyer_agent": "Agent kupec","intel_agent": "Agent za informacije","meta_description": "Dva AI agenta s 3D telesi se pogajata in plačujeta drug drugemu za sprotne kripto informacije z uporabo x402 mikroplačil na Solana. Vsaka transakcija je resnična in potrjena na verigi.","meta_og_description": "Dva 3D AI agenta kupujeta in prodajata kripto informacije za pravi USDC na Solana. Spremljajte potrditev vsake transakcije na verigi.",- "meta_og_title": "Menjalnica agentov — AI agenti si plačujejo v realnem času",- "meta_title": "Menjalnica agentov — 3D AI agenti si plačujejo v realnem času · three.ws",+ "meta_og_title": "Menjalnica agentov: AI agenti si plačujejo v realnem času",+ "meta_title": "Menjalnica agentov: 3D AI agenti si plačujejo v realnem času · three.ws","meta_twitter_description": "Dva 3D AI agenta si plačujeta za resnične kripto informacije. USDC na Solana. Na verigi.",- "meta_twitter_title": "Menjalnica agentov — AI agenti si plačujejo v realnem času",+ "meta_twitter_title": "Menjalnica agentov: AI agenti si plačujejo v realnem času","seller": "PRODAJALEC","session_total_0_00_usdc_settled_on": "Skupno za sejo: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC poravnano na verigi","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo plačevanja po klicu",- "x402_the_payment_trust_layer_title": "x402 — plast zaupanja pri plačilih za te poravnave"+ "x402_the_payment_trust_layer_title": "x402: plast zaupanja pri plačilih za te poravnave"},"agent_identities": {"1_call_create_identity": "1 · Klic ",diff --git a/public/locales/so.json b/public/locales/so.jsonindex 4c3c911ad..f976981e2 100644--- a/public/locales/so.json+++ b/public/locales/so.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Is-weydaarsiga Wakiilka",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Iibso xog — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Iibso xog · $0.01 USDC</span>","buy_intel_on": "Ka iibso xogta:","buyer": "IBSADE","buyer_agent": "Wakiilka Iibsadaha","intel_agent": "Wakiilka Xogta","meta_description": "Laba wakiil oo AI ah oo leh jidh 3D ah ayaa gorgortamaya oo isku bixinaya xogta crypto ee tooska ah iyagoo isticmaalaya lacag-bixinno yaryar oo x402 ah oo ku salaysan Solana. Wax kala iibsi kasta waa mid dhab ah oo lagu xaqiijiyay silsiladda.","meta_og_description": "Laba wakiil oo 3D AI ah ayaa iibsanaya oo iibinaya xogta crypto lacag dhab ah oo USDC ah oo ku salaysan Solana. Daawato wax kala iibsi kasta oo lagu xaqiijinayo silsiladda.",- "meta_og_title": "Is-weydaarsiga Wakiilka — Wakiillada AI oo isku bixinaya waqti dhab ah",- "meta_title": "Is-weydaarsiga Wakiilka — Wakiillada 3D AI oo isku bixinaya waqti dhab ah · three.ws",+ "meta_og_title": "Is-weydaarsiga Wakiilka: Wakiillada AI oo isku bixinaya waqti dhab ah",+ "meta_title": "Is-weydaarsiga Wakiilka: Wakiillada 3D AI oo isku bixinaya waqti dhab ah · three.ws","meta_twitter_description": "Laba wakiil oo 3D AI ah oo isku bixinaya xogta crypto ee dhabta ah. USDC oo ku salaysan Solana. Silsiladda dhexdeeda.",- "meta_twitter_title": "Is-weydaarsiga Wakiilka — Wakiillada AI oo isku bixinaya waqti dhab ah",+ "meta_twitter_title": "Is-weydaarsiga Wakiilka: Wakiillada AI oo isku bixinaya waqti dhab ah","seller": "IIBIYE","session_total_0_00_usdc_settled_on": "Wadarta kalfadhiga: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC lagu xaqiijiyay silsiladda","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo wacis kasta lacag ah",- "x402_the_payment_trust_layer_title": "x402 — the payment trust layer behind these settlements"+ "x402_the_payment_trust_layer_title": "x402: the payment trust layer behind these settlements"},"agent_identities": {"1_call_create_identity": "1 · Wac create_identity",diff --git a/public/locales/sq.json b/public/locales/sq.jsonindex d4d1cb17e..199eac58b 100644--- a/public/locales/sq.json+++ b/public/locales/sq.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Shkëmbim Agjentësh",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Blej inteligjencë — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Blej inteligjencë · $0.01 USDC</span>","buy_intel_on": "Blej inteligjencë për:","buyer": "BLERËS","buyer_agent": "Agjent Blerës","intel_agent": "Agjent Inteligjence","meta_description": "Dy agjentë AI me trupa 3D negociojnë dhe paguajnë njëri-tjetrin për inteligjencë kripto në kohë reale duke përdorur mikropagesa x402 në Solana. Çdo transaksion është real dhe konfirmohet në zinxhir.","meta_og_description": "Dy agjentë AI 3D blejnë dhe shesin inteligjencë kripto për USDC reale në Solana. Shikoni çdo transaksion të konfirmohet në zinxhir.",- "meta_og_title": "Shkëmbim Agjentësh — Agjentë AI që paguajnë njëri-tjetrin në kohë reale",- "meta_title": "Shkëmbim Agjentësh — Agjentë AI 3D që paguajnë njëri-tjetrin në kohë reale · three.ws",+ "meta_og_title": "Shkëmbim Agjentësh: Agjentë AI që paguajnë njëri-tjetrin në kohë reale",+ "meta_title": "Shkëmbim Agjentësh: Agjentë AI 3D që paguajnë njëri-tjetrin në kohë reale · three.ws","meta_twitter_description": "Dy agjentë AI 3D që paguajnë njëri-tjetrin për inteligjencë reale kripto. USDC në Solana. Në zinxhir.",- "meta_twitter_title": "Shkëmbim Agjentësh — Agjentë AI që paguajnë njëri-tjetrin në kohë reale",+ "meta_twitter_title": "Shkëmbim Agjentësh: Agjentë AI që paguajnë njëri-tjetrin në kohë reale","seller": "SHITËS","session_total_0_00_usdc_settled_on": "Totali i sesionit: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC i zgjidhur në zinxhir","three_ws": "three.ws","x402_pay_per_call_demo_title": "Demo me pagesë për thirrje x402",- "x402_the_payment_trust_layer_title": "x402 — shtresa e besueshmërisë së pagesave pas këtyre shlyerjeve"+ "x402_the_payment_trust_layer_title": "x402: shtresa e besueshmërisë së pagesave pas këtyre shlyerjeve"},"agent_identities": {"1_call_create_identity": "1 · Thirrni create_identity",diff --git a/public/locales/sr.json b/public/locales/sr.jsonindex b02bf1d26..8c74e2ded 100644--- a/public/locales/sr.json+++ b/public/locales/sr.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Razmena agenata",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kupi informacije — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Kupi informacije · $0.01 USDC</span>","buy_intel_on": "Kupi informacije o:","buyer": "KUPAC","buyer_agent": "Agent kupac","intel_agent": "Agent za informacije","meta_description": "Dva AI agenta sa 3D telima pregovaraju i plaćaju jedni drugima za kripto informacije uživo koristeći x402 mikroplaćanja na Solana. Svaka transakcija je stvarna i potvrđena na lancu.","meta_og_description": "Dva 3D AI agenta kupuju i prodaju kripto informacije za pravi USDC na Solana. Gledajte kako se svaka transakcija potvrđuje na lancu.",- "meta_og_title": "Razmena agenata — AI agenti plaćaju jedni drugima u realnom vremenu",- "meta_title": "Razmena agenata — 3D AI agenti plaćaju jedni drugima u realnom vremenu · three.ws",+ "meta_og_title": "Razmena agenata: AI agenti plaćaju jedni drugima u realnom vremenu",+ "meta_title": "Razmena agenata: 3D AI agenti plaćaju jedni drugima u realnom vremenu · three.ws","meta_twitter_description": "Dva 3D AI agenta plaćaju jedni drugima za stvarne kripto informacije. USDC na Solana. Na lancu.",- "meta_twitter_title": "Razmena agenata — AI agenti plaćaju jedni drugima u realnom vremenu",+ "meta_twitter_title": "Razmena agenata: AI agenti plaćaju jedni drugima u realnom vremenu","seller": "PRODAVAC","session_total_0_00_usdc_settled_on": "Ukupno za sesiju: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC poravnato na lancu","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo plaćanja po pozivu",- "x402_the_payment_trust_layer_title": "x402 — sloj poverenja za plaćanja iza ovih poravnanja"+ "x402_the_payment_trust_layer_title": "x402: sloj poverenja za plaćanja iza ovih poravnanja"},"agent_identities": {"1_call_create_identity": "1 · Pozovi create_identity",diff --git a/public/locales/sv.json b/public/locales/sv.jsonindex 12b5ffad9..548eb057a 100644--- a/public/locales/sv.json+++ b/public/locales/sv.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agentutbyte",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Köp intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Köp intel · $0.01 USDC</span>","buy_intel_on": "Köp intel på:","buyer": "KÖPARE","buyer_agent": "Köpare Agent","intel_agent": "Intel Agent","meta_description": "Två AI-agenter med 3D-kroppar förhandlar och betalar varandra för live kryptoinformation med hjälp av x402 mikrobetalningar på Solana. Varje transaktion är verklig och bekräftad på kedjan.","meta_og_description": "Två 3D AI-agenter köper och säljer kryptoinformation för verkliga USDC på Solana. Se varje transaktion bekräftas på kedjan.",- "meta_og_title": "Agentutbyte — AI-agenter som betalar varandra i realtid",- "meta_title": "Agentutbyte — 3D AI-agenter som betalar varandra i realtid · three.ws",+ "meta_og_title": "Agentutbyte: AI-agenter som betalar varandra i realtid",+ "meta_title": "Agentutbyte: 3D AI-agenter som betalar varandra i realtid · three.ws","meta_twitter_description": "Två 3D AI-agenter betalar varandra för verklig kryptoinformation. USDC på Solana. På kedjan.",- "meta_twitter_title": "Agentutbyte — AI-agenter som betalar varandra i realtid",+ "meta_twitter_title": "Agentutbyte: AI-agenter som betalar varandra i realtid","seller": "SÄLJARE","session_total_0_00_usdc_settled_on": "Session total: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC avräknat på kedjan","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 betalning per samtal demo",- "x402_the_payment_trust_layer_title": "x402 — betalningens förtroendeskikt bakom dessa avräkningar"+ "x402_the_payment_trust_layer_title": "x402: betalningens förtroendeskikt bakom dessa avräkningar"},"agent_identities": {"1_call_create_identity": "1 · Anropa skapa identitet",diff --git a/public/locales/sw.json b/public/locales/sw.jsonindex 2f08d2506..86cf8f724 100644--- a/public/locales/sw.json+++ b/public/locales/sw.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Kubadilishana Wakala",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Nunua intel — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Nunua intel · $0.01 USDC</span>","buy_intel_on": "Nunua intel kwenye:","buyer": "MNUNUZI","buyer_agent": "Wakala wa Mnunuzi","intel_agent": "Wakala wa Intel","meta_description": "Wakala wawili wa AI wenye miili ya 3D wanajadili na kulipana kwa intel ya crypto ya moja kwa moja wakitumia x402 malipo madogo kwenye Solana. Kila muamala ni halisi na umehakikishwa kwenye mnyororo.","meta_og_description": "Wakala wawili wa 3D wa AI wananunua na kuuza intel ya crypto kwa USDC halisi kwenye Solana. Tazama kila muamala ukihakikishwa kwenye mnyororo.",- "meta_og_title": "Kubadilishana Wakala — wakala wa AI wakilipa kila mmoja kwa wakati halisi",- "meta_title": "Kubadilishana Wakala — wakala wa 3D wa AI wakilipa kila mmoja kwa wakati halisi · three.ws",+ "meta_og_title": "Kubadilishana Wakala: wakala wa AI wakilipa kila mmoja kwa wakati halisi",+ "meta_title": "Kubadilishana Wakala: wakala wa 3D wa AI wakilipa kila mmoja kwa wakati halisi · three.ws","meta_twitter_description": "Wakala wawili wa 3D wa AI wakilipa kila mmoja kwa intel halisi ya crypto. USDC kwenye Solana. Kwenye mnyororo.",- "meta_twitter_title": "Kubadilishana Wakala — wakala wa AI wakilipa kila mmoja kwa wakati halisi",+ "meta_twitter_title": "Kubadilishana Wakala: wakala wa AI wakilipa kila mmoja kwa wakati halisi","seller": "MUUZAJI","session_total_0_00_usdc_settled_on": "Jumla ya kikao: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC yamekamilishwa kwenye mnyororo","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo ya malipo kwa simu",- "x402_the_payment_trust_layer_title": "x402 — safu ya kuaminika ya malipo nyuma ya makubaliano haya"+ "x402_the_payment_trust_layer_title": "x402: safu ya kuaminika ya malipo nyuma ya makubaliano haya"},"agent_identities": {"1_call_create_identity": "1 · Piga simu kuunda_identiti",diff --git a/public/locales/ta.json b/public/locales/ta.jsonindex 3701e8eaf..aff134103 100644--- a/public/locales/ta.json+++ b/public/locales/ta.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span> முகவர் பரிமாற்றம்",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\"> தகவல் வாங்க — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\"> தகவல் வாங்க · $0.01 USDC</span>","buy_intel_on": "தகவல் வாங்க:","buyer": "வாங்குபவர்","buyer_agent": "வாங்குபவர் முகவர்","intel_agent": "தகவல் முகவர்","meta_description": "இரு AI முகவர்கள் 3D உடல்களுடன் நேரடி கிரிப்டோ தகவலுக்கு x402 மைக்ரோபேமெண்ட்களை Solana பயன்படுத்தி பரிமாறி, ஒருவருக்கொருவர் செலுத்துகிறார்கள். ஒவ்வொரு பரிமாற்றமும் உண்மையானது மற்றும் ஒழுங்குபடுத்தப்பட்டுள்ளது.","meta_og_description": "இரு 3D AI முகவர்கள் உண்மையான USDC க்காக கிரிப்டோ தகவலை வாங்கி விற்கிறார்கள் Solana. ஒவ்வொரு பரிமாற்றமும் சங்கிலியில் உறுதிப்படுத்தப்படுவதைப் பாருங்கள்.",- "meta_og_title": "முகவர் பரிமாற்றம் — AI முகவர்கள் நேரத்தில் ஒருவருக்கொருவர் பணம் செலுத்துகிறார்கள்",- "meta_title": "முகவர் பரிமாற்றம் — 3D AI முகவர்கள் நேரத்தில் ஒருவருக்கொருவர் பணம் செலுத்துகிறார்கள் · three.ws",+ "meta_og_title": "முகவர் பரிமாற்றம்: AI முகவர்கள் நேரத்தில் ஒருவருக்கொருவர் பணம் செலுத்துகிறார்கள்",+ "meta_title": "முகவர் பரிமாற்றம்: 3D AI முகவர்கள் நேரத்தில் ஒருவருக்கொருவர் பணம் செலுத்துகிறார்கள் · three.ws","meta_twitter_description": "இரு 3D AI முகவர்கள் உண்மையான கிரிப்டோ தகவலுக்காக ஒருவருக்கொருவர் பணம் செலுத்துகிறார்கள். USDC Solana. சங்கிலியில்.",- "meta_twitter_title": "முகவர் பரிமாற்றம் — AI முகவர்கள் நேரத்தில் ஒருவருக்கொருவர் பணம் செலுத்துகிறார்கள்",+ "meta_twitter_title": "முகவர் பரிமாற்றம்: AI முகவர்கள் நேரத்தில் ஒருவருக்கொருவர் பணம் செலுத்துகிறார்கள்","seller": "விற்பனையாளர்","session_total_0_00_usdc_settled_on": "அமர்வு மொத்தம்: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC சங்கிலியில் தீர்வு","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 அழைப்புக்கு அடிப்படையில் டெமோ",- "x402_the_payment_trust_layer_title": "x402 — இந்த தீர்வுகளின் பின்னணியில் உள்ள பணம் நம்பகத்தன்மை அடுக்கு"+ "x402_the_payment_trust_layer_title": "x402: இந்த தீர்வுகளின் பின்னணியில் உள்ள பணம் நம்பகத்தன்மை அடுக்கு"},"agent_identities": {"1_call_create_identity": "1 · அழைப்பு உருவாக்க_identity",diff --git a/public/locales/te.json b/public/locales/te.jsonindex c90534f75..c6c8d91f4 100644--- a/public/locales/te.json+++ b/public/locales/te.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>ఏజెంట్ ఎక్స్చేంజ్",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ఇంటెల్ కొనండి — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ఇంటెల్ కొనండి · $0.01 USDC</span>","buy_intel_on": "ఇంటెల్ కొనండి:","buyer": "కొనుగోలుదారు","buyer_agent": "కొనుగోలుదారు ఏజెంట్","intel_agent": "ఇంటెల్ ఏజెంట్","meta_description": "రియల్ క్రిప్టో ఇంటెల్ కోసం 3D శరీరాలతో కూడిన రెండు AI ఏజెంట్లు x402 మైక్రోపేమెంట్స్ ఉపయోగించి Solana పై పరస్పరం చర్చించి చెల్లిస్తారు. ప్రతి లావాదేవీ నిజమైనది మరియు చైన్పై నిర్ధారించబడింది.","meta_og_description": "రెండు 3D AI ఏజెంట్లు వాస్తవ USDC కోసం క్రిప్టో ఇంటెల్ కొనుగోలు మరియు అమ్ముతారు Solana పై. ప్రతి లావాదేవీ చైన్పై నిర్ధారించబడినది.",- "meta_og_title": "ఏజెంట్ ఎక్స్చేంజ్ — AI ఏజెంట్లు ప్రత్యక్షంగా ఒకరినొకరు చెల్లించడం",- "meta_title": "ఏజెంట్ ఎక్స్చేంజ్ — 3D AI ఏజెంట్లు ప్రత్యక్షంగా ఒకరినొకరు చెల్లించడం · three.ws",+ "meta_og_title": "ఏజెంట్ ఎక్స్చేంజ్: AI ఏజెంట్లు ప్రత్యక్షంగా ఒకరినొకరు చెల్లించడం",+ "meta_title": "ఏజెంట్ ఎక్స్చేంజ్: 3D AI ఏజెంట్లు ప్రత్యక్షంగా ఒకరినొకరు చెల్లించడం · three.ws","meta_twitter_description": "రెండు 3D AI ఏజెంట్లు వాస్తవ క్రిప్టో ఇంటెల్ కోసం ఒకరినొకరు చెల్లిస్తున్నారు. USDC Solana పై. చైన్పై.",- "meta_twitter_title": "ఏజెంట్ ఎక్స్చేంజ్ — AI ఏజెంట్లు ప్రత్యక్షంగా ఒకరినొకరు చెల్లించడం",+ "meta_twitter_title": "ఏజెంట్ ఎక్స్చేంజ్: AI ఏజెంట్లు ప్రత్యక్షంగా ఒకరినొకరు చెల్లించడం","seller": "అమ్మకందారు","session_total_0_00_usdc_settled_on": "సెషన్ మొత్తం: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC చైన్పై సెటిల్మెంట్","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 పేమెంట్-ప్రతి-కాల్ డెమో",- "x402_the_payment_trust_layer_title": "x402 — ఈ సెటిల్మెంట్ల వెనుక పేమెంట్ ట్రస్ట్ లేయర్"+ "x402_the_payment_trust_layer_title": "x402: ఈ సెటిల్మెంట్ల వెనుక పేమెంట్ ట్రస్ట్ లేయర్"},"agent_identities": {"1_call_create_identity": "1 · కాల్ create_identity",diff --git a/public/locales/tg.json b/public/locales/tg.jsonindex 1f8e5ccc7..37931de46 100644--- a/public/locales/tg.json+++ b/public/locales/tg.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Мубодилаи агентҳо",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Хариди иттилоот — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Хариди иттилоот · $0.01 USDC</span>","buy_intel_on": "Хариди иттилоот дар:","buyer": "ХАРИДОР","buyer_agent": "Агенти харидор","intel_agent": "Агенти иттилоотӣ","meta_description": "Ду агенти AI бо ҷисмҳои 3D бо ҳам музокира мекунанд ва ба ҳамдигар барои иттилооти мустақими крипто бо истифода аз микропардохтҳои x402 дар Solana пардохт мекунанд. Ҳар як амалиёт воқеӣ буда, дар занҷир тасдиқ карда мешавад.","meta_og_description": "Ду агенти 3D AI иттилооти крипторо барои USDC-и воқеӣ дар Solana мехаранд ва мефурӯшанд. Ҳар як амалиётро дар занҷир тасдиқшуда бубинед.",- "meta_og_title": "Мубодилаи агентҳо — Агентҳои AI, ки дар вақти воқеӣ ба ҳамдигар пардохт мекунанд",- "meta_title": "Мубодилаи агентҳо — Агентҳои 3D AI, ки дар вақти воқеӣ ба ҳамдигар пардохт мекунанд · three.ws",+ "meta_og_title": "Мубодилаи агентҳо: Агентҳои AI, ки дар вақти воқеӣ ба ҳамдигар пардохт мекунанд",+ "meta_title": "Мубодилаи агентҳо: Агентҳои 3D AI, ки дар вақти воқеӣ ба ҳамдигар пардохт мекунанд · three.ws","meta_twitter_description": "Ду агенти 3D AI, ки барои иттилооти воқеии крипто ба ҳамдигар пардохт мекунанд. USDC дар Solana. Дар занҷир.",- "meta_twitter_title": "Мубодилаи агентҳо — Агентҳои AI, ки дар вақти воқеӣ ба ҳамдигар пардохт мекунанд",+ "meta_twitter_title": "Мубодилаи агентҳо: Агентҳои AI, ки дар вақти воқеӣ ба ҳамдигар пардохт мекунанд","seller": "ФУРӮШАНДА","session_total_0_00_usdc_settled_on": "Ҷамъи сессия: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC дар занҷир ҳисоб карда шуд","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 демои пардохт-барои-занг",- "x402_the_payment_trust_layer_title": "x402 — қабати эътимоди пардохт дар паси ин ҳисоббаробаркуниҳо"+ "x402_the_payment_trust_layer_title": "x402: қабати эътимоди пардохт дар паси ин ҳисоббаробаркуниҳо"},"agent_identities": {"1_call_create_identity": "1 · Даъват кунед create_identity",diff --git a/public/locales/th.json b/public/locales/th.jsonindex 9721649a6..a9a4df806 100644--- a/public/locales/th.json+++ b/public/locales/th.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>การแลกเปลี่ยนเอเจนต์",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ซื้อข้อมูล — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">ซื้อข้อมูล · $0.01 USDC</span>","buy_intel_on": "ซื้อข้อมูลที่:","buyer": "ผู้ซื้อ","buyer_agent": "เอเจนต์ผู้ซื้อ","intel_agent": "เอเจนต์ข้อมูล","meta_description": "เอเจนต์ AI สองตัวที่มีร่าง 3D เจรจาและจ่ายเงินให้กันสำหรับข้อมูลคริปโตสดโดยใช้ไมโครเพย์เมนต์ x402 บน Solana. ทุกธุรกรรมเป็นจริงและได้รับการยืนยันบน-chain.","meta_og_description": "เอเจนต์ AI 3D สองตัวซื้อและขายข้อมูลคริปโตสำหรับ USDC จริงบน Solana. ดูทุกธุรกรรมยืนยันบน-chain.",- "meta_og_title": "การแลกเปลี่ยนเอเจนต์ — เอเจนต์ AI จ่ายให้กันในเวลาจริง",- "meta_title": "การแลกเปลี่ยนเอเจนต์ — เอเจนต์ AI 3D จ่ายให้กันในเวลาจริง · three.ws",+ "meta_og_title": "การแลกเปลี่ยนเอเจนต์: เอเจนต์ AI จ่ายให้กันในเวลาจริง",+ "meta_title": "การแลกเปลี่ยนเอเจนต์: เอเจนต์ AI 3D จ่ายให้กันในเวลาจริง · three.ws","meta_twitter_description": "เอเจนต์ AI 3D สองตัวจ่ายให้กันสำหรับข้อมูลคริปโตจริง USDC บน Solana. บน-chain.",- "meta_twitter_title": "การแลกเปลี่ยนเอเจนต์ — เอเจนต์ AI จ่ายให้กันในเวลาจริง",+ "meta_twitter_title": "การแลกเปลี่ยนเอเจนต์: เอเจนต์ AI จ่ายให้กันในเวลาจริง","seller": "ผู้ขาย","session_total_0_00_usdc_settled_on": "ยอดรวมเซสชัน: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC ตั้งถิ่นฐานบน-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 สาธิตจ่ายต่อการโทร",- "x402_the_payment_trust_layer_title": "x402 — ชั้นความไว้วางใจในการชำระเงินที่อยู่เบื้องหลังการตั้งถิ่นฐานเหล่านี้"+ "x402_the_payment_trust_layer_title": "x402: ชั้นความไว้วางใจในการชำระเงินที่อยู่เบื้องหลังการตั้งถิ่นฐานเหล่านี้"},"agent_identities": {"1_call_create_identity": "1 · โทรสร้างเอกลักษณ์",diff --git a/public/locales/tr.json b/public/locales/tr.jsonindex 7d0f70382..6a30034c1 100644--- a/public/locales/tr.json+++ b/public/locales/tr.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Ajan Değişimi",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">İstihbarat satın al — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">İstihbarat satın al · $0.01 USDC</span>","buy_intel_on": "İstihbaratı satın al:","buyer": "ALICI","buyer_agent": "Alıcı Ajan","intel_agent": "İstihbarat Ajanı","meta_description": "İki 3D bedene sahip AI ajanı, Solana üzerinde x402 mikro ödemeleri kullanarak canlı kripto istihbaratı için birbirleriyle pazarlık yapar ve ödeme alır. Her işlem gerçek ve on-chain olarak onaylanmıştır.","meta_og_description": "İki 3D AI ajanı, Solana üzerinde gerçek USDC için kripto istihbarat alıp satıyor. Her işlemin on-chain'de onaylandığını izleyin.",- "meta_og_title": "Ajan Değişimi — AI ajanlarının birbirine gerçek zamanlı ödeme yapması",- "meta_title": "Ajan Değişimi — 3D AI ajanlarının birbirine gerçek zamanlı ödeme yapması · three.ws",+ "meta_og_title": "Ajan Değişimi: AI ajanlarının birbirine gerçek zamanlı ödeme yapması",+ "meta_title": "Ajan Değişimi: 3D AI ajanlarının birbirine gerçek zamanlı ödeme yapması · three.ws","meta_twitter_description": "İki 3D AI ajanı, gerçek kripto istihbaratı için birbirine ödeme yapıyor. USDC üzerinde Solana. Zincir üzerinde.",- "meta_twitter_title": "Ajan Değişimi — AI ajanlarının birbirine gerçek zamanlı ödeme yapması",+ "meta_twitter_title": "Ajan Değişimi: AI ajanlarının birbirine gerçek zamanlı ödeme yapması","seller": "SATICI","session_total_0_00_usdc_settled_on": "Oturum toplamı: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC zincir üzerinde yerleşti","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 çağrı başına ödeme demosu",- "x402_the_payment_trust_layer_title": "x402 — bu yerleşimlerin arkasındaki ödeme güven katmanı"+ "x402_the_payment_trust_layer_title": "x402: bu yerleşimlerin arkasındaki ödeme güven katmanı"},"agent_identities": {"1_call_create_identity": "1 · Kimlik oluşturma çağrısı",diff --git a/public/locales/uk.json b/public/locales/uk.jsonindex b3a9bfb1f..07055b151 100644--- a/public/locales/uk.json+++ b/public/locales/uk.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Обмін агентами",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Купити інформацію — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Купити інформацію · $0.01 USDC</span>","buy_intel_on": "Купити інформацію на:","buyer": "ПОКУПЕЦЬ","buyer_agent": "Агент покупця","intel_agent": "Агент інформації","meta_description": "Два AI-агенти з 3D-тілами ведуть переговори та оплачують один одному за живу криптоінформацію, використовуючи x402 мікроплатежі на Solana. Кожна транзакція реальна та підтверджена в блокчейні.","meta_og_description": "Два 3D AI-агенти купують і продають криптоінформацію за реальні USDC на Solana. Дивіться, як кожна транзакція підтверджується в блокчейні.",- "meta_og_title": "Обмін агентами — AI-агенти, які оплачують один одному в реальному часі",- "meta_title": "Обмін агентами — 3D AI-агенти, які оплачують один одному в реальному часі · three.ws",+ "meta_og_title": "Обмін агентами: AI-агенти, які оплачують один одному в реальному часі",+ "meta_title": "Обмін агентами: 3D AI-агенти, які оплачують один одному в реальному часі · three.ws","meta_twitter_description": "Два 3D AI-агенти, які оплачують один одному за реальну криптоінформацію. USDC на Solana. В блокчейні.",- "meta_twitter_title": "Обмін агентами — AI-агенти, які оплачують один одному в реальному часі",+ "meta_twitter_title": "Обмін агентами: AI-агенти, які оплачують один одному в реальному часі","seller": "ПРОДАВЕЦЬ","session_total_0_00_usdc_settled_on": "Загальна сума сесії: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC розраховано в блокчейні","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 демонстрація оплати за виклик",- "x402_the_payment_trust_layer_title": "x402 — рівень довіри до платежів за цими розрахунками"+ "x402_the_payment_trust_layer_title": "x402: рівень довіри до платежів за цими розрахунками"},"agent_identities": {"1_call_create_identity": "1 · Виклик створення ідентичності",diff --git a/public/locales/ur.json b/public/locales/ur.jsonindex d3a863832..7513d717c 100644--- a/public/locales/ur.json+++ b/public/locales/ur.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>ایجنٹ ایکسچینج",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">انٹیلیجنس خریدیں — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">انٹیلیجنس خریدیں · $0.01 USDC</span>","buy_intel_on": "انٹیلیجنس خریدیں:","buyer": "خریدار","buyer_agent": "خریدار ایجنٹ","intel_agent": "انٹیلیجنس ایجنٹ","meta_description": "دو AI ایجنٹس جن کے پاس 3D جسم ہیں، لائیو کرپٹو انٹیلیجنس کے لیے x402 مائیکروپیمنٹس کا استعمال کرتے ہوئے ایک دوسرے سے بات چیت کرتے ہیں اور ادائیگی کرتے ہیں Solana پر۔ ہر ٹرانزیکشن حقیقی اور چین پر تصدیق شدہ ہے۔","meta_og_description": "دو 3D AI ایجنٹس حقیقی USDC کے لیے کرپٹو انٹیلیجنس خریدتے اور بیچتے ہیں Solana پر۔ ہر ٹرانزیکشن چین پر تصدیق ہوتی ہے۔",- "meta_og_title": "ایجنٹ ایکسچینج — AI ایجنٹس ایک دوسرے کو حقیقی وقت میں ادائیگی کر رہے ہیں",- "meta_title": "ایجنٹ ایکسچینج — 3D AI ایجنٹس ایک دوسرے کو حقیقی وقت میں ادائیگی کر رہے ہیں · three.ws",+ "meta_og_title": "ایجنٹ ایکسچینج: AI ایجنٹس ایک دوسرے کو حقیقی وقت میں ادائیگی کر رہے ہیں",+ "meta_title": "ایجنٹ ایکسچینج: 3D AI ایجنٹس ایک دوسرے کو حقیقی وقت میں ادائیگی کر رہے ہیں · three.ws","meta_twitter_description": "دو 3D AI ایجنٹس حقیقی کرپٹو انٹیلیجنس کے لیے ایک دوسرے کو ادائیگی کر رہے ہیں۔ USDC پر Solana۔ چین پر۔",- "meta_twitter_title": "ایجنٹ ایکسچینج — AI ایجنٹس ایک دوسرے کو حقیقی وقت میں ادائیگی کر رہے ہیں",+ "meta_twitter_title": "ایجنٹ ایکسچینج: AI ایجنٹس ایک دوسرے کو حقیقی وقت میں ادائیگی کر رہے ہیں","seller": "بیچنے والا","session_total_0_00_usdc_settled_on": "سیشن کا کل: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC چین پر تصفیہ شدہ","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 ادائیگی فی کال ڈیمو",- "x402_the_payment_trust_layer_title": "x402 — ان تصفیوں کے پیچھے ادائیگی کا اعتماد کا لیئر"+ "x402_the_payment_trust_layer_title": "x402: ان تصفیوں کے پیچھے ادائیگی کا اعتماد کا لیئر"},"agent_identities": {"1_call_create_identity": "1 · شناخت بنائیں کال کریں",diff --git a/public/locales/uz.json b/public/locales/uz.jsonindex 1b44e43cd..3129cec75 100644--- a/public/locales/uz.json+++ b/public/locales/uz.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Agentlar almashinuvi",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Intel sotib olish — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Intel sotib olish · $0.01 USDC</span>","buy_intel_on": "Intel sotib olish:","buyer": "XARIDOR","buyer_agent": "Xaridor agenti","intel_agent": "Intel agenti","meta_description": "3D tanali ikkita AI agenti bir-biri bilan jonli kripto intel uchun muzokara olib boradi va Solanada x402 mikroto'lovlardan foydalanib to'laydi. Har bir tranzaksiya haqiqiy va zanjirda tasdiqlangan.","meta_og_description": "Ikkita 3D AI agenti Solanada haqiqiy USDC evaziga kripto intel sotib oladi va sotadi. Har bir tranzaksiyaning zanjirda tasdiqlanishini kuzating.",- "meta_og_title": "Agentlar almashinuvi — AI agentlari real vaqtda bir-biriga to'laydi",- "meta_title": "Agentlar almashinuvi — 3D AI agentlari real vaqtda bir-biriga to'laydi · three.ws",+ "meta_og_title": "Agentlar almashinuvi: AI agentlari real vaqtda bir-biriga to'laydi",+ "meta_title": "Agentlar almashinuvi: 3D AI agentlari real vaqtda bir-biriga to'laydi · three.ws","meta_twitter_description": "Ikkita 3D AI agenti haqiqiy kripto intel uchun bir-biriga to'laydi. Solanada USDC. Zanjirda.",- "meta_twitter_title": "Agentlar almashinuvi — AI agentlari real vaqtda bir-biriga to'laydi",+ "meta_twitter_title": "Agentlar almashinuvi: AI agentlari real vaqtda bir-biriga to'laydi","seller": "SOTUVCHI","session_total_0_00_usdc_settled_on": "Sessiya jami: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC zanjirda hal qilindi","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 chaqiruv uchun to'lov demo",- "x402_the_payment_trust_layer_title": "x402 — ushbu hisob-kitoblar ortidagi to'lov ishonch qatlami"+ "x402_the_payment_trust_layer_title": "x402: ushbu hisob-kitoblar ortidagi to'lov ishonch qatlami"},"agent_identities": {"1_call_create_identity": "1 · create_identity chaqiruvi",diff --git a/public/locales/vi.json b/public/locales/vi.jsonindex e1fb739d6..2b14da1b4 100644--- a/public/locales/vi.json+++ b/public/locales/vi.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Sàn giao dịch Tác nhân",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Mua thông tin — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Mua thông tin · $0.01 USDC</span>","buy_intel_on": "Mua thông tin trên:","buyer": "NGƯỜI MUA","buyer_agent": "Tác nhân Mua","intel_agent": "Tác nhân Thông tin","meta_description": "Hai tác nhân AI với hình thể 3D thương lượng và thanh toán cho nhau thông tin crypto trực tiếp bằng các khoản micropayment x402 trên Solana. Mỗi giao dịch là thực và được xác nhận trên chuỗi.","meta_og_description": "Hai tác nhân AI 3D mua và bán thông tin crypto cho USDC thực trên Solana. Theo dõi mỗi giao dịch xác nhận trên chuỗi.",- "meta_og_title": "Sàn giao dịch Tác nhân — các tác nhân AI thanh toán cho nhau theo thời gian thực",- "meta_title": "Sàn giao dịch Tác nhân — các tác nhân AI 3D thanh toán cho nhau theo thời gian thực · three.ws",+ "meta_og_title": "Sàn giao dịch Tác nhân: các tác nhân AI thanh toán cho nhau theo thời gian thực",+ "meta_title": "Sàn giao dịch Tác nhân: các tác nhân AI 3D thanh toán cho nhau theo thời gian thực · three.ws","meta_twitter_description": "Hai tác nhân AI 3D thanh toán cho nhau thông tin crypto thực. USDC trên Solana. Trên chuỗi.",- "meta_twitter_title": "Sàn giao dịch Tác nhân — các tác nhân AI thanh toán cho nhau theo thời gian thực",+ "meta_twitter_title": "Sàn giao dịch Tác nhân: các tác nhân AI thanh toán cho nhau theo thời gian thực","seller": "NGƯỜI BÁN","session_total_0_00_usdc_settled_on": "Tổng phiên: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC đã được thanh toán trên chuỗi","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 demo trả phí theo cuộc gọi",- "x402_the_payment_trust_layer_title": "x402 — lớp tin cậy thanh toán đứng sau các giao dịch này"+ "x402_the_payment_trust_layer_title": "x402: lớp tin cậy thanh toán đứng sau các giao dịch này"},"agent_identities": {"1_call_create_identity": "1 · Gọi tạo danh tính",diff --git a/public/locales/yo.json b/public/locales/yo.jsonindex 6b9204611..2b9aaf1cc 100644--- a/public/locales/yo.json+++ b/public/locales/yo.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Ìpààrọ̀ Aṣojú",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Ra ìfọ̀rọ̀wéránṣẹ́ — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Ra ìfọ̀rọ̀wéránṣẹ́ · $0.01 USDC</span>","buy_intel_on": "Ra ìfọ̀rọ̀wéránṣẹ́ lórí:","buyer": "OLÙRÀ","buyer_agent": "Aṣojú Olùrà","intel_agent": "Aṣojú Ìfọ̀rọ̀wéránṣẹ́","meta_description": "Àwọn aṣojú AI méjì pẹ̀lú ara 3D máa ń bá ara wọn jíròrò, wọ́n sì máa ń san owó fún ara wọn fún ìfọ̀rọ̀wéránṣẹ́ crypto láàyè nípa lílo àwọn ìsanwó kékeré x402 lórí Solana. Gbogbo ìṣòwò jẹ́ gidi, a sì ti fi ìdí rẹ̀ múlẹ̀ lórí ẹ̀wọ̀n.","meta_og_description": "Àwọn aṣojú AI 3D méjì máa ń ra, wọ́n sì máa ń ta ìfọ̀rọ̀wéránṣẹ́ crypto fún USDC gidi lórí Solana. Wo bí gbogbo ìṣòwò ṣe ń fi ìdí rẹ̀ múlẹ̀ lórí ẹ̀wọ̀n.",- "meta_og_title": "Ìpààrọ̀ Aṣojú — Àwọn aṣojú AI tó ń san owó fún ara wọn ní àkókò gidi",- "meta_title": "Ìpààrọ̀ Aṣojú — Àwọn aṣojú AI 3D tó ń san owó fún ara wọn ní àkókò gidi · three.ws",+ "meta_og_title": "Ìpààrọ̀ Aṣojú: Àwọn aṣojú AI tó ń san owó fún ara wọn ní àkókò gidi",+ "meta_title": "Ìpààrọ̀ Aṣojú: Àwọn aṣojú AI 3D tó ń san owó fún ara wọn ní àkókò gidi · three.ws","meta_twitter_description": "Àwọn aṣojú AI 3D méjì tó ń san owó fún ara wọn fún ìfọ̀rọ̀wéránṣẹ́ crypto gidi. USDC lórí Solana. Lórí ẹ̀wọ̀n.",- "meta_twitter_title": "Ìpààrọ̀ Aṣojú — Àwọn aṣojú AI tó ń san owó fún ara wọn ní àkókò gidi",+ "meta_twitter_title": "Ìpààrọ̀ Aṣojú: Àwọn aṣojú AI tó ń san owó fún ara wọn ní àkókò gidi","seller": "OLÙTÀ","session_total_0_00_usdc_settled_on": "Àpapọ̀ ìgbà: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC tí a ti yanjú lórí ẹ̀wọ̀n","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 àfihàn ìsanwó-lórí-ìpè",- "x402_the_payment_trust_layer_title": "x402 — ìpele ìgbẹ́kẹ̀lé ìsanwó lẹ́yìn àwọn ìpinnu wọ̀nyí"+ "x402_the_payment_trust_layer_title": "x402: ìpele ìgbẹ́kẹ̀lé ìsanwó lẹ́yìn àwọn ìpinnu wọ̀nyí"},"agent_identities": {"1_call_create_identity": "1 · Pè create_identity",diff --git a/public/locales/zh-CN.json b/public/locales/zh-CN.jsonindex 8a9ea71c1..f7b500616 100644--- a/public/locales/zh-CN.json+++ b/public/locales/zh-CN.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>代理交易平台",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">购买情报 — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">购买情报 · $0.01 USDC</span>","buy_intel_on": "购买情报:","buyer": "买方","buyer_agent": "买方代理","intel_agent": "情报代理","meta_description": "两个拥有 3D 身体的 AI 代理在 Solana 上使用 x402 微支付,相互协商并支付实时加密情报。每笔交易真实且在链上确认。","meta_og_description": "两个 3D AI 代理在 Solana 上使用真实的 USDC 买卖加密情报。观看每笔交易在链上确认。",- "meta_og_title": "代理交易平台 — AI 代理实时相互支付",- "meta_title": "代理交易平台 — 3D AI 代理实时相互支付 · three.ws",+ "meta_og_title": "代理交易平台:AI 代理实时相互支付",+ "meta_title": "代理交易平台:3D AI 代理实时相互支付 · three.ws","meta_twitter_description": "两个 3D AI 代理相互支付以获取真实加密情报。在 Solana 上使用 USDC。链上确认。",- "meta_twitter_title": "代理交易平台 — AI 代理实时相互支付",+ "meta_twitter_title": "代理交易平台:AI 代理实时相互支付","seller": "卖方","session_total_0_00_usdc_settled_on": "会话总计:<span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC 已在链上结算","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 按次调用演示",- "x402_the_payment_trust_layer_title": "x402 — 这些结算背后的支付信任层"+ "x402_the_payment_trust_layer_title": "x402:这些结算背后的支付信任层"},"agent_identities": {"1_call_create_identity": "1 · 调用 create_identity",diff --git a/public/locales/zh-TW.json b/public/locales/zh-TW.jsonindex 875a05fb1..e84f4a193 100644--- a/public/locales/zh-TW.json+++ b/public/locales/zh-TW.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>代理交換",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">購買情報 — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">購買情報 · $0.01 USDC</span>","buy_intel_on": "在以下平台購買情報:","buyer": "買家","buyer_agent": "買方代理人","intel_agent": "情報代理人","meta_description": "兩個擁有 3D 身體的 AI 代理人使用 x402 微支付在 Solana 上進行即時加密情報的談判和支付。每筆交易都是實時的並在鏈上確認。","meta_og_description": "兩個 3D AI 代理人以真實的 USDC 在 Solana 上買賣加密情報。觀看每筆交易在鏈上確認。",- "meta_og_title": "代理交換 — AI 代理人即時支付彼此",- "meta_title": "代理交換 — 3D AI 代理人即時支付彼此 · three.ws",+ "meta_og_title": "代理交換:AI 代理人即時支付彼此",+ "meta_title": "代理交換:3D AI 代理人即時支付彼此 · three.ws","meta_twitter_description": "兩個 3D AI 代理人為真實的加密情報支付彼此。USDC 在 Solana 上。鏈上。",- "meta_twitter_title": "代理交換 — AI 代理人即時支付彼此",+ "meta_twitter_title": "代理交換:AI 代理人即時支付彼此","seller": "賣家","session_total_0_00_usdc_settled_on": "會話總計:<span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC 已在鏈上結算","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 按次付費演示",- "x402_the_payment_trust_layer_title": "x402 — 這些結算背後的支付信任層"+ "x402_the_payment_trust_layer_title": "x402:這些結算背後的支付信任層"},"agent_identities": {"1_call_create_identity": "1 · 呼叫創建身份",diff --git a/public/locales/zu.json b/public/locales/zu.jsonindex d49aae050..39d2c9936 100644--- a/public/locales/zu.json+++ b/public/locales/zu.json@@ -770,22 +770,22 @@},"agent_exchange": {"agent_exchange": "<span class=\"dot\"></span>Ukushintshaniswa Kwama-ejenti",- "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Thenga ulwazi — $0.01 USDC</span>",+ "buy_intel_0_01_usdc": "<span class=\"spin\" aria-hidden=\"true\"></span> <span class=\"lbl\">Thenga ulwazi · $0.01 USDC</span>","buy_intel_on": "Thenga ulwazi ku:","buyer": "UMTHENGI","buyer_agent": "I-ejenti Yomthengi","intel_agent": "I-ejenti Yolwazi","meta_description": "Ama-ejenti amabili e-AI anemizimba ye-3D axoxisana futhi akhokhelane ngolwazi lwe-crypto olubukhoma esebenzisa izinkokhelo ezincane ze-x402 ku-Solana. Konke okwenziwayo kungokoqobo futhi kuqinisekiswa ku-chain.","meta_og_description": "Ama-ejenti amabili e-AI e-3D athenga futhi athengise ulwazi lwe-crypto nge-USDC yangempela ku-Solana. Buka konke okwenziwayo kuqinisekiswa ku-chain.",- "meta_og_title": "Ukushintshaniswa Kwama-ejenti — Ama-ejenti e-AI akhokhelana ngesikhathi sangempela",- "meta_title": "Ukushintshaniswa Kwama-ejenti — Ama-ejenti e-AI e-3D akhokhelana ngesikhathi sangempela · three.ws",+ "meta_og_title": "Ukushintshaniswa Kwama-ejenti: Ama-ejenti e-AI akhokhelana ngesikhathi sangempela",+ "meta_title": "Ukushintshaniswa Kwama-ejenti: Ama-ejenti e-AI e-3D akhokhelana ngesikhathi sangempela · three.ws","meta_twitter_description": "Ama-ejenti amabili e-AI e-3D akhokhelana ngolwazi lwe-crypto lwangempela. USDC ku-Solana. Ku-chain.",- "meta_twitter_title": "Ukushintshaniswa Kwama-ejenti — Ama-ejenti e-AI akhokhelana ngesikhathi sangempela",+ "meta_twitter_title": "Ukushintshaniswa Kwama-ejenti: Ama-ejenti e-AI akhokhelana ngesikhathi sangempela","seller": "UMTHENGISI","session_total_0_00_usdc_settled_on": "Ingqikithi yeseshini: <span class=\"tv\" id=\"totalUsdc\">$0.00</span> USDC isilungisiwe ku-chain","three_ws": "three.ws","x402_pay_per_call_demo_title": "x402 idemo yokukhokha ngocingo ngalunye",- "x402_the_payment_trust_layer_title": "x402 — ungqimba lokwethenjwa kwenkokhelo olungemuva kwalezi zinkokhelo"+ "x402_the_payment_trust_layer_title": "x402: ungqimba lokwethenjwa kwenkokhelo olungemuva kwalezi zinkokhelo"},"agent_identities": {"1_call_create_identity": "1 · Biza i-create_identity",diff --git a/public/mcp-catalog.json b/public/mcp-catalog.jsonindex 7d4e739cc..4a452e889 100644--- a/public/mcp-catalog.json+++ b/public/mcp-catalog.json@@ -6719,7 +6719,7 @@{"name": "get_preferences","title": "Get notification preferences",- "description": "Read the account's notification delivery preferences — the resolved channel matrix the platform uses to decide how each kind of event reaches the owner. Returns `categories` (the catalog of user-facing groups: sales, purchases, social, irl, alerts, account — each with a label and description), `channels` (the deliverable channels: in_app, push, email, telegram), `prefs` (the effective per-category → per-channel on/off matrix with sparse user overrides already merged onto defaults, plus the linked `telegram_chat_id` if any), and `push` (how many web-push devices are registered). Read this before calling set_preferences so you patch from the real current state. Read-only.",+ "description": "Read the account's notification delivery preferences — the resolved channel matrix the platform uses to decide how each kind of event reaches the owner. Returns `categories` (the catalog of user-facing groups: sales, purchases, social, irl, alerts, creations, account, each with a label, a description, and any `lockedChannels` that cannot be switched off), `channels` (the deliverable channels: in_app, push, email, telegram), `prefs` (the effective per-category → per-channel on/off matrix with sparse user overrides already merged onto defaults, plus the linked `telegram_chat_id` if any), and `push` (how many web-push devices are registered). Read this before calling set_preferences so you patch from the real current state. Read-only.","server": {"id": "notifications-mcp","title": "@three-ws/notifications-mcp",@@ -6900,7 +6900,7 @@{"name": "set_preferences","title": "Set notification preferences",- "description": "Update the account's notification delivery preferences with a sparse patch. `categories` maps a category key (${…}) to a channel map turning each channel on/off (${…}) — e.g. { \"alerts\": { \"push\": false }, \"social\": { \"email\": true } }. Only the category/channel pairs you pass change; unknown keys are dropped server-side and untouched pairs keep their current value (which falls back to the platform default). Pass `telegram_chat_id` (a numeric Telegram chat id, or \"\" to unlink) to control where the telegram channel delivers. Provide at least one of `categories` or `telegram_chat_id`. WRITE but idempotent — re-applying the same values is a no-op. Returns the full resolved preference matrix after the update. Read it first with get_preferences.",+ "description": "Update the account's notification delivery preferences with a sparse patch. `categories` maps a category key (${…}) to a channel map turning each channel on/off (${…}) — e.g. { \"alerts\": { \"push\": false }, \"social\": { \"email\": true } }. Only the category/channel pairs you pass change; unknown keys are dropped server-side and untouched pairs keep their current value (which falls back to the platform default). Pass `telegram_chat_id` (a numeric Telegram chat id, or \"\" to unlink) to control where the telegram channel delivers. Provide at least one of `categories` or `telegram_chat_id`. `account` locks its `in_app` channel on: security and withdrawal notices always reach the bell inbox, so `false` there is ignored. WRITE but idempotent, re-applying the same values is a no-op. Returns the full resolved preference matrix after the update. Read it first with get_preferences.","server": {"id": "notifications-mcp","title": "@three-ws/notifications-mcp",diff --git a/public/nav.js b/public/nav.jsindex 7d8ecbcc5..ed22c7ec0 100644--- a/public/nav.js+++ b/public/nav.js@@ -228,6 +228,14 @@ const SKIP_LINK_SELECTOR = '.nav-skip, .skip-link, .h-skip-link';function ensureSkipLink() {if (!document.body || document.querySelector(SKIP_LINK_SELECTOR)) return;+ // The rule that hides this link until focus lives in nav.css, which boot()+ // only fetches for pages that host a `#nav-container`. Full-screen routes+ // without one (/agent-screen, /club, /scan …) still get the link injected,+ // so without this it rendered as visible unstyled text in the normal flow,+ // shoving the whole page down by its line box. nav.css is entirely+ // component-scoped (.nav-*, .notif-*, .dr-*, #nav-container), so loading it+ // on a nav-less page styles this link and nothing else.+ ensureNavStylesheet();if (!document.getElementById('main-content')) {const landmark = document.querySelector('main, [role="main"]');if (landmark && !landmark.id) landmark.id = 'main-content';diff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex 7c83a28b9..41715ae8a 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -4300,7 +4300,7 @@<a href="/docs/aws-marketplace"><span class="sm-title">Docs · three.ws on AWS Marketplace</span><span class="sm-path">/docs/aws-marketplace</span>- <span class="sm-desc">three.ws is a verified AWS Partner and listed on AWS Marketplace as an API-based SaaS product. The subscription is a free front door: subscribing links your AWS account to a platform account.</span>+ <span class="sm-desc">three.ws is a verified AWS Partner. The AWS Marketplace product is an API-based SaaS listing whose subscription is a free front door: it links your AWS account to a platform account and issues an x402 key. Integration, endpoints, and current listing status.</span></a></li><li>@@ -4741,7 +4741,7 @@<a href="/tutorials/write-a-guard"><span class="sm-title">Tutorial · Write a repository guard</span><span class="sm-path">/tutorials/write-a-guard</span>- <span class="sm-desc">This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when an API handler forgets its error boundary, wire it into the gate, cover it with tests, and register it.</span>+ <span class="sm-desc">This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when a server-side fetch has no timeout, wire it into the gate, prove it against the violation it claims to catch, and cover it with tests.</span></a></li><li>@@ -4755,7 +4755,7 @@<a href="/docs/tutorials/write-a-guard"><span class="sm-title">Docs · Write a repository guard</span><span class="sm-path">/docs/tutorials/write-a-guard</span>- <span class="sm-desc">Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json, wire it into a stage, and cover it with a test that includes the false positive it must never report.</span>+ <span class="sm-desc">Build a real guard end to end: write the checker, give it an npm script, register it in data/guards.json with the violation it must reject, wire it into a stage, prove it still fires, and cover it with a test that includes the false positive it must never report.</span></a></li><li>diff --git a/public/tutorials-manifest.js b/public/tutorials-manifest.jsindex a02f610f3..13af14e13 100644--- a/public/tutorials-manifest.js+++ b/public/tutorials-manifest.js@@ -260,7 +260,7 @@builds: 'A production-ready embed in your existing stack',time: '30 min',previewModel: '/animations/soldier.glb',- ctaPrimary: { label: 'Embed docs', href: '/docs#embedding' },+ ctaPrimary: { label: 'Embed docs', href: '/docs/embedding' },},{slug: 'personal-ai-site',@@ -280,7 +280,7 @@builds: 'An agent driven by your app — clicks, scrolls, form submits',time: '25 min',previewModel: '/animations/robotexpressive.glb',- ctaPrimary: { label: 'JS API reference', href: '/docs#js-api' },+ ctaPrimary: { label: 'JS API reference', href: '/docs/js-api' },},{slug: 'web-component-end-to-end',@@ -290,7 +290,7 @@builds: 'A reusable <agent-3d> tag wired into your component system',time: '30 min',previewModel: '/animations/soldier.glb',- ctaPrimary: { label: 'Web component docs', href: '/docs#web-component' },+ ctaPrimary: { label: 'Web component docs', href: '/docs/web-component' },},{slug: 'build-a-site-concierge',@@ -310,7 +310,7 @@builds: 'An agent that reacts to the user journey on your site',time: '25 min',previewModel: '/animations/robotexpressive.glb',- ctaPrimary: { label: 'JS API reference', href: '/docs#js-api' },+ ctaPrimary: { label: 'JS API reference', href: '/docs/js-api' },},{slug: 'character-library-to-embed',@@ -360,7 +360,7 @@builds: 'A distinct, on-brand persona that holds across thousands of chats',time: '40 min',previewModel: '/avatars/cz.glb',- ctaPrimary: { label: 'Agent system docs', href: '/docs#agent-system' },+ ctaPrimary: { label: 'Agent system docs', href: '/docs/agent-system' },},{slug: 'connect-ai-brain',@@ -462,7 +462,7 @@builds: 'A live weather skill bundled, deployed, and callable by the agent',time: '60 min',previewModel: '/animations/robotexpressive.glb',- ctaPrimary: { label: 'Skills docs', href: '/docs#skills' },+ ctaPrimary: { label: 'Skills docs', href: '/docs/skills' },},{slug: 'sell-a-skill-with-a-trial',@@ -482,7 +482,7 @@builds: 'A registered agent identity discoverable from any wallet',time: '45 min',previewModel: '/animations/robotexpressive.glb',- ctaPrimary: { label: 'ERC-8004 docs', href: '/docs#erc8004' },+ ctaPrimary: { label: 'ERC-8004 docs', href: '/docs/erc8004' },},{slug: 'mint-pumpfun-token',@@ -572,7 +572,7 @@builds: 'A fully independent agent stack running on your own servers',time: '90 min',previewModel: '/animations/robotexpressive.glb',- ctaPrimary: { label: 'Architecture docs', href: '/docs#architecture' },+ ctaPrimary: { label: 'Architecture docs', href: '/docs/architecture' },},{slug: 'multi-agent-coordination',@@ -582,7 +582,7 @@builds: 'A team of agents that collaborate to solve a single task',time: '60 min',previewModel: '/animations/soldier.glb',- ctaPrimary: { label: 'Multi-agent docs', href: '/docs#multi-agent' },+ ctaPrimary: { label: 'Multi-agent docs', href: '/docs/multi-agent' },},{slug: 'mcp-server-for-your-agent',@@ -592,7 +592,7 @@builds: 'Your agent reachable as a tool from any MCP-aware app',time: '45 min',previewModel: '/animations/robotexpressive.glb',- ctaPrimary: { label: 'MCP docs', href: '/docs#mcp' },+ ctaPrimary: { label: 'MCP docs', href: '/docs/mcp' },},{slug: 'skill-with-database-auth',@@ -602,7 +602,7 @@builds: 'A production CRM-lookup skill with auth and rate limits',time: '90 min',previewModel: '/avatars/cz.glb',- ctaPrimary: { label: 'Skills docs', href: '/docs#skills' },+ ctaPrimary: { label: 'Skills docs', href: '/docs/skills' },},{slug: 'deploy-to-vercel-custom-domain',@@ -612,7 +612,7 @@builds: 'A live agent on agent.yourcompany.com with CI and SSL',time: '45 min',previewModel: '/animations/robotexpressive.glb',- ctaPrimary: { label: 'Deployment docs', href: '/docs#deployment' },+ ctaPrimary: { label: 'Deployment docs', href: '/docs/deployment' },},{slug: 'claim-threews-name',@@ -698,7 +698,7 @@slug: 'write-a-guard',tier: 'advanced',title: 'Write a repository guard',- blurb: 'This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when an API handler forgets its error boundary, wire it into the gate, cover it with tests, and register it.',+ blurb: 'This repo has no CI, so a guard is the only thing between a mistake and production. Build one that fails the build when a server-side fetch has no timeout, wire it into the gate, prove it against the violation it claims to catch, and cover it with tests.',builds: 'A real guard running in the gate, listed on /guards',time: '20 min',previewModel: '/animations/robotexpressive.glb',diff --git a/scripts/backfill-avatar-thumbnails.mjs b/scripts/backfill-avatar-thumbnails.mjsindex 56be24727..522303bc6 100644--- a/scripts/backfill-avatar-thumbnails.mjs+++ b/scripts/backfill-avatar-thumbnails.mjs@@ -21,7 +21,10 @@* A model that fails to render MAX_ATTEMPTS times is retired and stops consuming* budget.*- * Usage (needs DATABASE_URL + S3_* — they live in .env.local):+ * Usage. Needs DATABASE_URL and the S3_* set. Only DATABASE_URL is in+ * .env.local; the authoritative S3_* copy lives on the Cloud Run service, so+ * export those into the shell first (docs/avatar-thumbnails.md has the one+ * liner that reads them off the service).** node --env-file=.env.local scripts/backfill-avatar-thumbnails.mjs --status* node --env-file=.env.local scripts/backfill-avatar-thumbnails.mjs --adopt-only@@ -72,9 +75,15 @@ const ADOPT_ONLY = has('adopt-only');const RENDER_ONLY = has('render-only');const LOOP = has('loop');+// DATABASE_URL ships in .env.local, but the S3_* set does not: its authoritative+// copy is the Cloud Run service env. Pointing every miss at --env-file sends the+// operator back to the file that just failed them, so name the real source.for (const required of ['DATABASE_URL', 'S3_BUCKET', 'S3_ACCESS_KEY_ID']) {if (!process.env[required]) {- console.error(`[backfill] ${required} is unset — run with: node --env-file=.env.local ${process.argv[1]}`);+ const where = required.startsWith('S3_')+ ? 'export the S3_* set from the Cloud Run service first (see docs/avatar-thumbnails.md, "Operating the backfill")'+ : `run with: node --env-file=.env.local ${process.argv[1]}`;+ console.error(`[backfill] ${required} is unset. ${where}`);process.exit(1);}}diff --git a/scripts/draft-mint-devnet-e2e.mjs b/scripts/draft-mint-devnet-e2e.mjsindex 816571e5f..2cc744cf8 100644--- a/scripts/draft-mint-devnet-e2e.mjs+++ b/scripts/draft-mint-devnet-e2e.mjs@@ -136,14 +136,76 @@ const { mintDraftAgentIdentity } = await import(path.join(ROOT, 'api/_lib/draft-const { authoritySecret, buildAuthorityUmi } = await import(path.join(ROOT, 'api/_lib/onchain-deploy.js'));// ── 0. Authority balance ─────────────────────────────────────────────────────+const REQUIRED_LAMPORTS = 12_000_000; // collection + mint + registry enrolment++/**+ * Land a devnet airdrop for the authority. Any single faucet is throttled per+ * IP and goes dry under load, so this walks the repo's whole devnet endpoint+ * chain (operator endpoints, Helius, Alchemy, dRPC, the public cluster) and+ * retries with backoff, exactly like the sibling tokenize-3d proof. Returns the+ * balance in lamports after the attempt. Devnet only: the endpoint list is+ * built for the devnet cluster and nothing here can reach mainnet.+ */+async function topUpAuthority(pubkeyBase58) {+ const { solanaRpcEndpoints } = await import(path.join(ROOT, 'api/_lib/solana/connection.js'));+ const endpoints = solanaRpcEndpoints('devnet');+ const rpc = async (url, method, params) => {+ const r = await fetch(url, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),+ signal: AbortSignal.timeout(20_000),+ });+ return r.json();+ };+ const balanceOf = async () => {+ for (const url of endpoints) {+ const b = await rpc(url, 'getBalance', [pubkeyBase58]).catch(() => null);+ if (typeof b?.result?.value === 'number') return b.result.value;+ }+ return 0;+ };++ for (let attempt = 1; attempt <= 4; attempt++) {+ for (const url of endpoints) {+ const host = new URL(url).host;+ const out = await rpc(url, 'requestAirdrop', [pubkeyBase58, 1_000_000_000]).catch((e) => ({+ error: { message: e?.message || 'request failed' },+ }));+ if (out?.result) {+ step('airdrop', `${host} → ${out.result}`);+ // The faucet signature needs a moment to land before the balance moves.+ for (let i = 0; i < 10; i++) {+ await new Promise((s) => setTimeout(s, 2_000));+ const bal = await balanceOf();+ if (bal >= REQUIRED_LAMPORTS) return bal;+ }+ } else {+ step('airdrop declined', `${host}: ${String(out?.error?.message || 'unknown').slice(0, 80)}`);+ }+ }+ const bal = await balanceOf();+ if (bal >= REQUIRED_LAMPORTS) return bal;+ await new Promise((s) => setTimeout(s, 4_000 * attempt));+ }+ return balanceOf();+}+const { umi, authoritySigner } = buildAuthorityUmi('devnet', authoritySecret());const authority = authoritySigner.publicKey.toString();-const balance = Number((await umi.rpc.getBalance(authoritySigner.publicKey)).basisPoints);+let balance = Number((await umi.rpc.getBalance(authoritySigner.publicKey)).basisPoints);step('authority', `${authority} holds ${(balance / 1e9).toFixed(4)} devnet SOL`);-if (balance < 12_000_000) {+if (balance < REQUIRED_LAMPORTS) {+ step('funding', 'authority is short; asking every devnet faucet in the endpoint chain');+ balance = await topUpAuthority(authority);+ step('authority', `${authority} now holds ${(balance / 1e9).toFixed(4)} devnet SOL`);+}+if (balance < REQUIRED_LAMPORTS) {fail(`authority needs ~0.012 devnet SOL for collection + mint + registry; it has ${(balance / 1e9).toFixed(4)}.\n` +- ` Top up ${authority} at https://faucet.solana.com and re-run.`,+ ` Every devnet faucet in the endpoint chain refused (they are per-IP throttled and go dry under load).\n` ++ ` Top up ${authority} at https://faucet.solana.com, or set SOLANA_RPC_URL_DEVNET / QUICKNODE_RPC_URL_DEVNET\n` ++ ` to a provider whose faucet quota is intact, then re-run.`,);}diff --git a/scripts/gcp/burn-report.mjs b/scripts/gcp/burn-report.mjsindex 3c4efa141..c0909b893 100755--- a/scripts/gcp/burn-report.mjs+++ b/scripts/gcp/burn-report.mjs@@ -157,10 +157,14 @@ try {process.exit(report.projection.status === 'runaway' ? 2 : 0);} catch (err) {if (err instanceof BillingUnavailableError) {+ // A missing export table is a one-time console step, not a fault: name the+ // step instead of leaving the reader with a bare BigQuery "not found".+ const notWired = err.code === 'billing_export_missing';+ const hint = 'Enable it once (console-only): Billing → Billing export → BigQuery export → Edit settings → select the dataset. See docs/ops/gcp-credits.md.';if (asJson) {- console.log(JSON.stringify({ error: 'billing_unavailable', message: err.message }, null, 2));+ console.log(JSON.stringify({ error: err.code || 'billing_unavailable', message: err.message, ...(notWired ? { hint } : {}) }, null, 2));} else {- console.error(`\n ⚠️ Burn report unavailable\n ${err.message}\n`);+ console.error(`\n ⚠️ Burn report unavailable\n ${err.message}\n${notWired ? ` ${hint}\n` : ''}`);}process.exit(3);}diff --git a/scripts/publish-npm-queue.mjs b/scripts/publish-npm-queue.mjsindex e131456d4..c491afe54 100644--- a/scripts/publish-npm-queue.mjs+++ b/scripts/publish-npm-queue.mjs@@ -59,8 +59,8 @@ const QUEUE = ["avatar-sdk", // @three-ws/avatar 0.2.2 (628 dl/mo)"packages/pumpfun-mcp", // @three-ws/pumpfun-mcp 0.2.5 (549 dl/mo)"page-agent-sdk", // @three-ws/page-agent 0.2.1 (545 dl/mo)- "packages/alibaba-cloud-mcp", // @three-ws/alibaba-cloud-mcp 0.1.2 (430 dl/mo)- "packages/agentcore-payments-mcp", // @three-ws/agentcore-payments-mcp 0.1.3 (377 dl/mo)+ "packages/alibaba-cloud-mcp", // @three-ws/alibaba-cloud-mcp 0.1.3 (430 dl/mo)+ "packages/agentcore-payments-mcp", // @three-ws/agentcore-payments-mcp 0.1.4 (377 dl/mo)"packages/scene-mcp", // @three-ws/scene-mcp 0.2.1 (372 dl/mo)"packages/ibm-x402-mcp", // @three-ws/ibm-x402-mcp 1.1.3 (372 dl/mo)"packages/brain-mcp", // @three-ws/brain-mcp 0.1.3 (368 dl/mo)diff --git a/scripts/reputation-market-proof.mjs b/scripts/reputation-market-proof.mjsindex d5abedc7d..cbcab56f7 100644--- a/scripts/reputation-market-proof.mjs+++ b/scripts/reputation-market-proof.mjs@@ -134,17 +134,31 @@ async function fundStaker(conn, pubkey, targetLamports) {};}-async function attest(conn, signer, agentAsset, payload) {+// Write one attestation memo naming the agent.+//+// Two constraints meet here and only one shape satisfies both:+//+// 1. SPL Memo v3 (MemoSq4gq…) verifies EVERY account handed to it and returns+// MissingRequiredSignature if any of them did not sign. An account passed+// as isSigner:false makes the instruction fail outright.+// 2. readActionHistoryFromChain discovers an agent's history with+// getSignaturesForAddress(agentAsset), which only returns transactions the+// agent account actually appears in. Dropping the account to satisfy (1)+// would make the attestation unfindable.+//+// So the agent account must be present AND must sign. The proof generates the+// agent identity itself, so it holds that keypair and co-signs with it.+async function attest(conn, signer, agentKeypair, payload) {const memoIx = new TransactionInstruction({keys: [{ pubkey: signer.publicKey, isSigner: true, isWritable: false },- { pubkey: agentAsset, isSigner: false, isWritable: false },+ { pubkey: agentKeypair.publicKey, isSigner: true, isWritable: false },],programId: MEMO_PROGRAM_ID,data: Buffer.from(JSON.stringify(payload), 'utf8'),});const tx = new Transaction().add(memoIx);- return sendAndConfirm(conn, tx, [signer], { commitment: 'confirmed', timeoutMs: CONFIRM_TIMEOUT_MS });+ return sendAndConfirm(conn, tx, [signer, agentKeypair], { commitment: 'confirmed', timeoutMs: CONFIRM_TIMEOUT_MS });}const main = async () => {@@ -202,7 +216,7 @@ const main = async () => {{ v: 1, kind: 'threews.feedback.v1', agent: agentAsset.toBase58(), score: 5, task_id: `rsm-proof-${runId}` },];for (const payload of attestations) {- await attest(conn, staker, agentAsset, payload);+ await attest(conn, staker, agent, payload);}step('attest', true, `${attestations.length} signed memos on ${agentAsset.toBase58()}`);diff --git a/scripts/verify-vanity-receipt.mjs b/scripts/verify-vanity-receipt.mjsindex 2498c25a1..e06cc6700 100644--- a/scripts/verify-vanity-receipt.mjs+++ b/scripts/verify-vanity-receipt.mjs@@ -140,12 +140,37 @@ function openSealed(env, secretKey) {return gcm(key, fromB64url(env.nonce), epk).decrypt(fromB64url(env.ciphertext));}+const HELP = `Provably-fair vanity receipt verifier (three-vanity/v1).++Recomputes every claim in a three.ws verifiable-grind receipt locally: the+commitment opens, the seed mix derives the address, the pattern matches, the+difficulty is honest, and the signature is the pinned three.ws service key.+Nothing is sent anywhere. Exit 0 = every check passed, 1 = any failed.++Usage:+ node scripts/verify-vanity-receipt.mjs <receipt.json> [options]+ cat receipt.json | node scripts/verify-vanity-receipt.mjs --stdin++Options:+ --stdin read the receipt JSON from stdin+ --service-key <base58> pin to this service key (default: the receipt's own key;+ pass the key from /.well-known/three-vanity.json to+ prove the signer is really three.ws)+ --fetch-key fetch and pin the live key from the well-known document+ --x25519-secret <key> your X25519 private key (Base58/hex) to open the seal+ --secret-seed <hexkey> a 32/64-byte Ed25519 secret you already opened+ --json emit the machine-readable audit as JSON+ -h, --help show this help++Protocol spec: https://three.ws/docs/PROTOCOL-vanity`;+function parseArgs(args) {- const opts = { json: false, stdin: false, fetchKey: false };+ const opts = { json: false, stdin: false, fetchKey: false, help: false };let path = null;for (let i = 0; i < args.length; i++) {const a = args[i];- if (a === '--json') opts.json = true;+ if (a === '--help' || a === '-h') opts.help = true;+ else if (a === '--json') opts.json = true;else if (a === '--stdin') opts.stdin = true;else if (a === '--fetch-key') opts.fetchKey = true;else if (a === '--service-key') opts.serviceKey = args[++i];@@ -224,13 +249,25 @@ function runChecks(receipt, { servicePublicKey, openedSecretSeed }) {async function main() {const { path, opts } = parseArgs(argv.slice(2));+ if (opts.help) {+ console.log(HELP);+ exit(0);+ }let raw;if (opts.stdin || (!path && !process.stdin.isTTY)) {raw = await readStdin();} else if (path) {raw = readFileSync(path, 'utf8');} else {- console.error('Usage: verify-vanity-receipt.mjs <receipt.json> [--stdin] [--service-key K] [--fetch-key] [--x25519-secret K] [--json]');+ console.error(HELP);+ exit(1);+ }++ // An empty read is "you gave me no receipt", not "your JSON is malformed".+ // Piping from an empty pipe lands here, and the parser's message for it+ // sends the reader hunting for a syntax error that does not exist.+ if (!raw.trim()) {+ console.error(`${RED}No receipt on stdin.${RESET}\n\n${HELP}`);exit(1);}diff --git a/specs/REPUTATION_STAKING_MARKET.md b/specs/REPUTATION_STAKING_MARKET.mdindex b039676f3..f41a44e64 100644--- a/specs/REPUTATION_STAKING_MARKET.md+++ b/specs/REPUTATION_STAKING_MARKET.md@@ -321,4 +321,12 @@ Funding has two rungs, in order: `REPUTATION_MARKET_PROOF_FUNDER_SECRET_KEY` (akeypair funded once, out of band) and the public devnet faucet. The faucetrate-limits per source IP, so it is the fallback rather than the contract; a runfrom an IP the faucet has cut off is a funding problem, never a statement about-the market itself.+the market itself. When neither rung is available, the same proof runs against a+local `solana-test-validator` with no credentials and no faucet; the docs carry+that command and the two RPC details it depends on.++The attestations the proof writes in step 2 name the agent account AND are+co-signed by it. SPL Memo v3 rejects any account handed to it that did not sign,+while `readActionHistoryFromChain` finds an agent's history through+`getSignaturesForAddress(agentAsset)`, which only returns transactions that+account appears in. Both constraints hold at once only when the agent signs.diff --git a/src/agent-economy-volume.js b/src/agent-economy-volume.jsindex d86bca7b8..9e4c30bc4 100644--- a/src/agent-economy-volume.js+++ b/src/agent-economy-volume.js@@ -84,11 +84,27 @@ function statCard(val, lbl, sub) {</div>`;}+function initialsTile(name) {+ return `<div class="rank-av-fallback" aria-hidden="true">${escapeHtml(initials(name))}</div>`;+}+function avatarCell(agent) {if (agent.avatar_thumbnail_url) {- return `<img class="rank-av" src="${escapeHtml(agent.avatar_thumbnail_url)}" alt="" loading="lazy" />`;+ return `<img class="rank-av" src="${escapeHtml(agent.avatar_thumbnail_url)}" alt="" loading="lazy" data-name="${escapeHtml(agent.name || 'Agent')}" />`;}- return `<div class="rank-av-fallback" aria-hidden="true">${escapeHtml(initials(agent.name))}</div>`;+ return initialsTile(agent.name);+}++// A thumbnail whose stored object has since been pruned still resolves to a URL,+// so the row would paint the browser's broken-image glyph. Swap it for the same+// initials tile an agent without a thumbnail gets. `error` does not bubble, so+// the listener goes on each image rather than on the list.+function wireAvatarFallbacks(root) {+ root.querySelectorAll('img.rank-av').forEach((img) => {+ img.addEventListener('error', () => {+ img.outerHTML = initialsTile(img.dataset.name);+ }, { once: true });+ });}function rankRow(num, agent, sub, primary, secondary) {@@ -421,6 +437,8 @@ function renderTotals(t) {}function renderLeaderboards(providers, hirers) {+ const earners = document.getElementById('top-earners');+ const spenders = document.getElementById('top-spenders');setCount('earners-count', providers.length);document.getElementById('top-earners').innerHTML = providers.length? providers.map((a, i) => rankRow(@@ -438,6 +456,9 @@ function renderLeaderboards(providers, hirers) {fmtUsd(a.spent_usd), 'spent',)).join(''): '<div class="an-empty">No agent has hired another yet. <a href="/x402">Browse the x402 catalog</a> to see what is hireable.</div>';++ wireAvatarFallbacks(earners);+ wireAvatarFallbacks(spenders);}function renderFeed(recent) {diff --git a/src/agent-economy.js b/src/agent-economy.jsindex 7c75c36fa..1e77f6e29 100644--- a/src/agent-economy.js+++ b/src/agent-economy.js@@ -85,9 +85,34 @@ function renderFundAlert(status) {});}+// The status read failing left both balance chips spinning forever and the+// addresses on their em-dash placeholder: a permanent loading state with no way+// out. Say what happened and offer the retry instead.+function renderStatusUnavailable() {+ for (const id of ['buyer-bal', 'seller-bal']) {+ const el = $(id);+ if (!el) continue;+ el.className = 'av-label-bal bal-unknown';+ el.textContent = 'balance unavailable';+ }+ const el = $('fund-alert');+ if (!el) return;+ el.innerHTML = `<strong>Live wallet balances are unavailable.</strong> They could not be read just now. You can still request a service.+ <button class="fund-alert-btn" type="button" data-retry-status="1">Retry</button>`;+ el.classList.add('visible');+ el.querySelector('[data-retry-status]')?.addEventListener('click', (e) => {+ e.currentTarget.disabled = true;+ for (const id of ['buyer-bal', 'seller-bal']) {+ const chip = $(id);+ if (chip) { chip.className = 'av-label-bal bal-unknown'; chip.innerHTML = '<span class="bal-spin"></span>'; }+ }+ refreshWalletStatus();+ });+}+async function refreshWalletStatus() {const status = await fetchWalletStatus();- if (!status) return;+ if (!status) { renderStatusUnavailable(); return; }currentWalletStatus = status;renderBal('buyer-bal', status.agentA);renderBal('seller-bal', status.agentB);@@ -257,6 +282,25 @@ function renderAddr(elId, addr, explorerUrl) {}// ── Purchase flow ─────────────────────────────────────────────────────────────+// A request that never reached the server leaves the page with nothing to show,+// so the failure row carries the retry: the reader should not have to guess that+// clicking the same catalog row again is the recovery.+function requestFailed(message, service) {+ setStatus(message);+ const row = addFeedItem({+ icon: '⚠️',+ type: 'pay',+ title: 'Request failed',+ sub: `${escHtml(message)} <button class="tx-retry-btn" type="button">Try again</button>`,+ });+ row?.querySelector('.tx-retry-btn')?.addEventListener('click', () => {+ if (busy) return;+ purchase(service);+ });+ busy = false;+ setButtons(false);+}+async function purchase(service) {if (busy) return;busy = true;@@ -290,15 +334,30 @@ async function purchase(service) {const res = await fetch('/api/agent-economy/transact', {method: 'POST',headers: { 'content-type': 'application/json' },- body: JSON.stringify({ service, topic }),+ // Omit `topic` entirely when the field is empty. Sending `topic: null`+ // failed the endpoint's schema, so the page's most common path (click a+ // service, type nothing) answered 400 instead of transacting.+ body: JSON.stringify(topic ? { service, topic } : { service }),});- data = await res.json();- if (!res.ok) throw new Error(data.error_description || data.error || `HTTP ${res.status}`);+ // A gateway can answer a 502 with HTML, and res.json() throws on it. Read+ // the body once and parse defensively so an infrastructure hiccup reads as+ // "the service is unavailable", not as a bare parser error.+ const raw = await res.text();+ try { data = raw ? JSON.parse(raw) : null; } catch { data = null; }+ if (!res.ok || !data) {+ requestFailed(+ data?.error_description ||+ data?.error ||+ `The agent economy service is unavailable right now (HTTP ${res.status}). Try again in a moment.`,+ service,+ );+ return;+ }} catch (e) {- setStatus(`Error: ${e.message}`);- addFeedItem({ icon: '⚠️', type: 'pay', title: 'Request failed', sub: escHtml(e.message) });- busy = false;- setButtons(false);+ // The raw fetch rejection ("Failed to fetch") told the reader nothing and+ // nothing to do about it. Keep the detail in the console.+ log.warn('[three.ws] agent-economy: transact request failed:', e.message);+ requestFailed('Could not reach the agent economy service. Check your connection and try again.', service);return;}@@ -416,7 +475,11 @@ async function purchase(service) {});}- setStatus('Transaction complete · Select another service to continue');+ // Only a settled payment gets the "complete" line. This used to run+ // unconditionally, so an unfunded wallet or a spent daily budget ended on+ // "Transaction complete", wiping the one line that told the reader what had+ // actually happened and what to do about it.+ if (!tx?.error) setStatus('Transaction complete · Select another service to continue');busy = false;setButtons(false);diff --git a/src/agent-exchange.js b/src/agent-exchange.jsindex 033f30133..1b9ba9551 100644--- a/src/agent-exchange.js+++ b/src/agent-exchange.js@@ -98,10 +98,17 @@ function setPayLabel(text) {if (lbl) lbl.textContent = text;}+const PAY_LABEL = 'Buy intel · $0.01 USDC';+// ── State ─────────────────────────────────────────────────────────────────────let activeTopic = 'sol';let busy = false;let sessionTotal = 0; // USDC in dollars+// Wallet gate. null while a live settlement is possible; otherwise the honest+// button label explaining why it is not, which also disables the pay button.+// Offering "Buy intel" over a wallet that provably cannot settle is a button+// that can only fail, so the gate owns the button and doPurchase defers to it.+let payBlockedLabel = null;let agentAReady = false;let agentBReady = false;const queueA = [];@@ -291,8 +298,11 @@ function narrate(stageId, extra) {function narrateDone(intelObj, paymentObj) {const topic = intelObj?.topic?.toUpperCase() || 'Intel';const amount = paymentObj?.amount ? (Number(paymentObj.amount) / 1e6).toFixed(4) : '0.0100';- const txLink = paymentObj?.tx- ? ` <a href="https://solscan.io/tx/${escHtml(paymentObj.tx)}" target="_blank" rel="noopener">View on Solscan ↗</a>`+ // Same guard the receipt uses: only a well-formed base58 signature becomes a+ // Solscan link, so a truncated tx never ships a dead explorer URL.+ const tx = typeof paymentObj?.tx === 'string' && BASE58_RE.test(paymentObj.tx) ? paymentObj.tx : null;+ const txLink = tx+ ? ` <a href="https://solscan.io/tx/${encodeURIComponent(tx)}" target="_blank" rel="noopener">View on Solscan ↗</a>`: '';els.narration.innerHTML =`<div class="nr-done">` +@@ -301,39 +311,99 @@ function narrateDone(intelObj, paymentObj) {`</div>`;}+// ── Wallet state ──────────────────────────────────────────────────────────────+// Icons for the three panel tones. Kept as constants so the renderer below reads+// as data rather than a wall of inline SVG.+const ICON_ALERT = `<svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><line x1="12" y1="8" x2="12" y2="12"/><line x1="12" y1="16" x2="12.01" y2="16"/></svg>`;+const ICON_WARN = `<svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>`;++// Render (or clear) the wallet panel. `recheck` adds a real button that re-runs+// the probe, so a wallet funded while the page is open recovers without a+// reload. `blocks` is the pay-button label to show while this state holds.+function setWalletState(state) {+ if (!state) {+ els.walletState.className = '';+ els.walletState.innerHTML = '';+ payBlockedLabel = null;+ syncPayButton();+ return;+ }+ els.walletState.className = `show ${state.tone}`;+ els.walletState.innerHTML =+ `<div class="ws-head">${state.icon}${escHtml(state.title)}</div>` ++ `<div class="ws-body">${state.body}` ++ (state.recheck ? `<button type="button" class="ws-recheck" id="wsRecheck">Check again</button>` : '') ++ `</div>`;+ if (state.recheck) {+ const btn = $('wsRecheck');+ btn?.addEventListener('click', () => {+ btn.disabled = true;+ btn.textContent = 'Checking…';+ checkWallet();+ });+ }+ payBlockedLabel = state.blocks || null;+ syncPayButton();+}++// The gate owns disabled + label whenever a purchase is not in flight;+// doPurchase hands the button back to it in its finally block.+function syncPayButton() {+ if (busy) return;+ els.payBtn.disabled = Boolean(payBlockedLabel);+ setPayLabel(payBlockedLabel || PAY_LABEL);+}+async function checkWallet() {+ let b;try {const r = await fetch('/api/x402-pay?balance=1');- if (!r.ok) return;- const b = await r.json();- if (!b.configured) {- els.walletState.className = 'show ws-unconfigured';- els.walletState.innerHTML =- `<div class="ws-head">` +- `<svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><line x1="12" y1="8" x2="12" y2="12"/><line x1="12" y1="16" x2="12.01" y2="16"/></svg>` +- `Demo wallet not configured` +- `</div>` +- `<div class="ws-body">` ++ if (!r.ok) throw new Error(`balance probe returned ${r.status}`);+ b = await r.json();+ } catch (err) {+ // A probe failure is not silence: the viewer is told the balance is+ // unknown and handed a retry, because a page that looks ready over an+ // unreadable wallet is worse than one that says it cannot tell.+ setWalletState({+ tone: 'ws-low',+ icon: ICON_WARN,+ title: 'Wallet status unavailable',+ body:+ `The balance check for the buyer wallet did not answer (${escHtml(err.message || 'network error')}). ` ++ `The exchange still runs, but the settlement may fail if the wallet is empty. `,+ recheck: true,+ });+ return;+ }++ if (!b.configured) {+ setWalletState({+ tone: 'ws-unconfigured',+ icon: ICON_ALERT,+ title: 'Demo wallet not configured',+ body:`This demo settles real USDC on Solana mainnet. The agent wallet isn't configured right now, so live settlements are paused. ` +- `To enable: set <span class="ws-mono">X402_AGENT_SOLANA_SECRET_BASE58</span> and fund the wallet.` +- `</div>`;- els.payBtn.disabled = true;- } else if (typeof b.usdc === 'number' && b.usdc < 0.01) {- const addr = b.address ? `${b.address.slice(0, 8)}…${b.address.slice(-4)}` : 'unavailable';- els.walletState.className = 'show ws-low';- els.walletState.innerHTML =- `<div class="ws-head">` +- `<svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>` +- `Agent wallet low on USDC` +- `</div>` +- `<div class="ws-body">` +- `The buyer wallet holds ${b.usdc.toFixed(4)} USDC, below the $0.01 minimum for a live settlement. ` +- `Fund <span class="ws-mono">${escHtml(addr)}</span> with USDC on Solana mainnet to run the demo.` +- `</div>`;- }- } catch {- // Network failures silently ignored so they never block the page.+ `To enable: set <span class="ws-mono">X402_AGENT_SOLANA_SECRET_BASE58</span> and fund the wallet.`,+ blocks: 'Wallet not configured',+ });+ return;}++ if (typeof b.usdc === 'number' && b.usdc < 0.01) {+ setWalletState({+ tone: 'ws-low',+ icon: ICON_WARN,+ title: 'Agent wallet low on USDC',+ body:+ `The buyer wallet holds ${escHtml(b.usdc.toFixed(4))} USDC, below the $0.01 minimum for a live settlement. ` ++ `Fund <span class="ws-mono">${escHtml(shortB58(b.address, 8, 4))}</span> with USDC on Solana mainnet to run the demo. `,+ recheck: true,+ blocks: 'Wallet needs USDC',+ });+ return;+ }++ setWalletState(null);}// ── Main payment flow ─────────────────────────────────────────────────────────@@ -496,8 +566,10 @@ async function doPurchase() {clearTimeout(timeoutId);busy = false;els.payBtn.classList.remove('busy');- els.payBtn.disabled = false;- setPayLabel('Buy intel · $0.01 USDC');+ // The wallet gate owns the button again, so a settlement that emptied the+ // wallet cannot leave a live-looking "Buy intel" behind.+ syncPayButton();+ checkWallet();}}diff --git a/src/agent-screen-treasury.js b/src/agent-screen-treasury.jsindex 0d9851e6b..240c53f54 100644--- a/src/agent-screen-treasury.js+++ b/src/agent-screen-treasury.js@@ -361,6 +361,7 @@ export function createTreasuryCockpit({ agentId, bodyEl, toast, network = 'mainn<textarea id="ast-policy" class="ast-textarea" rows="3" spellcheck="false"placeholder="Pay your own compute, keep a 1 SOL buffer, put 10% of tips into $THREE, buy back your coin weekly, sweep over 3 SOL to me on Fridays.">${esc(sourceText)}</textarea><input id="ast-sweep" class="ast-input" type="text" spellcheck="false" autocomplete="off"+ aria-label="Sweep destination wallet (optional)"placeholder="Sweep destination wallet (optional)" value="${esc(sweep)}"><div class="ast-preview" id="ast-preview"></div><div class="ast-actions">diff --git a/src/agent-screen.js b/src/agent-screen.jsindex 59e3cb2fa..c9f9379a4 100644--- a/src/agent-screen.js+++ b/src/agent-screen.js@@ -121,6 +121,25 @@ function toast(msg, ms = 2200) {}, ms);}+// ── workspace layout constants ──────────────────────────────────────────────+// These live above the boot dispatch below because that dispatch runs during+// module evaluation: boot() calls loadLayout() synchronously before any await.+// While LS_KEY was declared further down the file it was still in its temporal+// dead zone at that moment, so every read threw a ReferenceError straight into+// loadLayout's catch and a returning viewer's saved panel arrangement was+// silently discarded on every load.++// Bumped v1 → v2 to retire the old six-panels-open layout. Returning visitors+// get the calm two-panel default once, then their re-arrangements persist again.+const LS_KEY = 'twx_asc_workspace_v2';++// Below this width a floating panel spans the full viewport, so the two that+// open by default would completely cover the screen feed and the avatar cam:+// the page's entire reason to exist, hidden behind panels on a phone. Narrow+// viewports therefore start with a bare stage and reach the panels through the+// header toggles, which scroll to stay reachable at any width.+const PANEL_RAIL_MIN_WIDTH = 720;+if (!agentId) {renderSetup();} else {@@ -160,18 +179,35 @@ async function renderSetup() {const detector = { client: null, pollTimer: null, started: false };// ── Check auth ─────────────────────────────────────────────────────────+ // Only a 401 means "signed out". Any other failure (5xx, a proxy hiccup, the+ // browser offline) used to land in the same bucket and told a signed-in+ // owner to go sign in, which is both wrong and a dead end. Those get their+ // own state with a retry instead.let agents = [];let isSignedIn = false;- try {- const r = await fetch('/api/agents', { credentials: 'include' });- if (r.ok) {- const j = await r.json();- agents = j.agents || j.data || [];- isSignedIn = true;- } else if (r.status === 401) {- isSignedIn = false;+ let agentsError = '';++ async function loadAgents() {+ agentsError = '';+ try {+ const r = await fetch('/api/agents', { credentials: 'include' });+ if (r.ok) {+ const j = await r.json();+ agents = j.agents || j.data || [];+ isSignedIn = true;+ return;+ }+ if (r.status === 401) {+ isSignedIn = false;+ return;+ }+ agentsError = `Couldn't load your agents (server said ${r.status}).`;+ } catch {+ agentsError = "Couldn't reach three.ws. Check your connection.";}- } catch { /* network error — treat as signed-out */ }+ }++ await loadAgents();// Command builders pull from the shared, unit-tested module so the copied// command and the highlighted display can never drift. Placeholders are only@@ -208,6 +244,12 @@ async function renderSetup() {function agentGridHTML() {const list = filteredAgents();+ if (agentsError) {+ return `<div class="ws-agent-empty ws-agent-error" role="alert">+ <span>${esc(agentsError)}</span>+ <button class="ws-btn ws-btn-ghost" id="ws-retry-agents" type="button">Retry</button>+ </div>`;+ }if (agents.length === 0) {return `<div class="ws-agent-empty">${isSignedIn@@ -236,7 +278,11 @@ async function renderSetup() {}function goLiveHTML() {- const watchLink = selectedAgent ? `/agent-screen?agentId=${encodeURIComponent(selectedAgent.id)}` : '#';+ // Only ever rendered once an agent is picked, but fall back to the agent+ // list rather than a dead `#` if that ever stops being true.+ const watchLink = selectedAgent+ ? `/agent-screen?agentId=${encodeURIComponent(selectedAgent.id)}`+ : '/agents';const privateNote = privateWarning ? `<div class="ws-golive-note">This agent isn't in the public directory yet. Make it public so viewers can find it on the wall —@@ -288,7 +334,11 @@ async function renderSetup() {<div class="ws-progress" aria-hidden="true">${progressHTML()}</div>- ${!isSignedIn ? `+ ${agentsError ? `+ <div class="ws-not-signed-in" role="alert">+ <span>⚠</span>+ <span>${esc(agentsError)} <button class="ws-link-btn" id="ws-retry-agents-top" type="button">Try again</button></span>+ </div>` : !isSignedIn ? `<div class="ws-not-signed-in"><span>⚠</span><span>You need to <a href="/login">sign in</a> to generate an API key and select an agent.</span>@@ -402,6 +452,14 @@ async function renderSetup() {container.querySelector('#ws-gen-key')?.addEventListener('click', generateKey);container.querySelector('#ws-regen-key')?.addEventListener('click', generateKey);container.querySelector('#ws-retry-key')?.addEventListener('click', generateKey);+ for (const btn of container.querySelectorAll('#ws-retry-agents, #ws-retry-agents-top')) {+ btn.addEventListener('click', async () => {+ btn.disabled = true;+ btn.textContent = 'Retrying…';+ await loadAgents();+ render();+ });+ }container.querySelector('#ws-copy-key')?.addEventListener('click', () => copyText(apiKey, 'ws-copy-key'));container.querySelector('#ws-copy-cmd')?.addEventListener('click', () => copyText(buildRunCommand(cmdOpts()), 'ws-copy-cmd'));container.querySelectorAll('.ws-cmd-tab').forEach((tab) => {@@ -540,11 +598,13 @@ async function renderSetup() {// ── workspace layout persistence ─────────────────────────────────────────────-// Bumped v1 → v2 to retire the old six-panels-open layout. Returning visitors-// get the calm two-panel default once, then their re-arrangements persist again.-const LS_KEY = 'twx_asc_workspace_v2';+function narrowViewport() {+ return typeof window !== 'undefined' && window.innerWidth > 0+ && window.innerWidth < PANEL_RAIL_MIN_WIDTH;+}function defaultLayout() {+ const railFits = !narrowViewport();return {zen: false,zenCam: true, // keep the avatar cam visible in zen by default@@ -555,7 +615,7 @@ function defaultLayout() {// toolbar click away. Bumping LS_KEY resets returning visitors to this baseline.panels: {cam: { hidden: true, min: false, x: null, y: null, w: 260 },- log: { hidden: false, min: false, x: null, y: null, w: 320, h: 280 },+ log: { hidden: !railFits, min: false, x: null, y: null, w: 320, h: 280 },stats: { hidden: true, min: false, x: null, y: null, w: 218 },treasury: { hidden: true, min: false, x: null, y: null, w: 344, h: null },mirror: { hidden: true, min: false, x: null, y: null, w: 380, h: null },@@ -564,7 +624,7 @@ function defaultLayout() {hud: { hidden: true, min: false, x: null, y: null, w: 288, h: null },diary: { hidden: true, min: false, x: null, y: null, w: 360, h: 332 },hire: { hidden: true, min: false, x: null, y: null, w: 340, h: null },- reputation: { hidden: false, min: false, x: null, y: null, w: 320, h: 340 },+ reputation: { hidden: !railFits, min: false, x: null, y: null, w: 320, h: 340 },},};}@@ -663,7 +723,7 @@ async function boot(id) {<!-- Pose Studio Live: call out a pose, the avatar performs it --><div class="asc-pose" id="asc-pose"><form class="asc-pose-form" id="asc-pose-form" autocomplete="off">- <input class="asc-pose-input" id="asc-pose-input" type="text" maxlength="120" spellcheck="false" placeholder="Pose the avatar… try “take a bow”">+ <input class="asc-pose-input" id="asc-pose-input" type="text" maxlength="120" spellcheck="false" aria-label="Pose the avatar" placeholder="Pose the avatar… try “take a bow”"><button class="asc-pose-go" id="asc-pose-go" type="submit" title="Perform pose">Pose</button></form><div class="asc-pose-chips" id="asc-pose-chips"></div>@@ -846,7 +906,7 @@ async function boot(id) {<ol class="asc-stage-lead-list" id="asc-stage-lead-list"></ol></div><form class="asc-stage-ask" id="asc-stage-ask" autocomplete="off">- <input class="asc-stage-ask-input" id="asc-stage-ask-input" type="text" maxlength="240" placeholder="Ask the host a question…" spellcheck="false">+ <input class="asc-stage-ask-input" id="asc-stage-ask-input" type="text" maxlength="240" aria-label="Ask the host a question" placeholder="Ask the host a question…" spellcheck="false"><button class="asc-stage-ask-send" type="submit" title="Ask the host">Ask</button></form><div class="asc-stage-ask-status" id="asc-stage-ask-status"></div>@@ -876,6 +936,7 @@ async function boot(id) {class="asc-task-input"id="asc-task-input"type="text"+ aria-label="Ask this agent anything"placeholder="Ask this agent anything…"maxlength="1000"spellcheck="false"@@ -896,6 +957,7 @@ async function boot(id) {class="asc-forge-input"id="asc-forge-input"type="text"+ aria-label="Describe the avatar to forge"placeholder="Forge an avatar — describe it (e.g. a glossy white robot mascot)"maxlength="1000"spellcheck="false"diff --git a/src/solana/sns.js b/src/solana/sns.jsindex 016d1ea62..e1f8e7a94 100644--- a/src/solana/sns.js+++ b/src/solana/sns.js@@ -80,6 +80,65 @@ const SOL_ADDRESS_RE = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;// Bare label, dotted subdomain (`nich.threews`), or either with a `.sol` suffix.const SOL_NAME_RE = /^[a-z0-9-]{1,63}(?:\.[a-z0-9-]{1,63})*(?:\.sol)?$/i;+// Bonfida's hosted SNS index. Enumerating every domain a wallet holds is a+// scan the on-chain program can't answer in one RPC call, so the index is the+// only practical source for it. Reads are public and unauthenticated.+const SNS_INDEX_API = 'https://sns-api.bonfida.com';+// A whale wallet can hold thousands of domains; the caller wants a name list to+// show, not a dump. Cap it and say so in the payload.+const OWNER_DOMAINS_CAP = 100;++function withSolSuffix(label) {+ const name = String(label || '').trim();+ if (!name) return null;+ return name.endsWith('.sol') ? name : `${name}.sol`;+}++async function snsIndexJson(path, timeoutMs) {+ const res = await fetch(`${SNS_INDEX_API}${path}`, {+ headers: { accept: 'application/json' },+ signal: AbortSignal.timeout(timeoutMs),+ });+ if (!res.ok) return null;+ return res.json();+}++/**+ * Every `.sol` domain a wallet holds, plus its favorite domain, from the Bonfida+ * SNS index. Both halves are best-effort: an index outage degrades to an empty+ * list and a null favorite rather than failing the resolution that asked for it.+ *+ * @param {string} owner - base58-encoded wallet public key+ * @param {{ timeoutMs?: number, limit?: number }} [opts]+ * @returns {Promise<{ allDomains: string[], favoriteDomain: string|null, truncated: boolean }>}+ */+export async function snsOwnerDomains(owner, opts = {}) {+ const addr = String(owner || '').trim();+ const empty = { allDomains: [], favoriteDomain: null, truncated: false };+ if (!SOL_ADDRESS_RE.test(addr)) return empty;+ const timeoutMs = Number.isFinite(opts.timeoutMs) ? opts.timeoutMs : 6000;+ const limit = Number.isFinite(opts.limit) ? Math.max(1, opts.limit) : OWNER_DOMAINS_CAP;++ const [domainsBody, favBody] = await Promise.all([+ snsIndexJson(`/v2/user/domains/${addr}`, timeoutMs).catch(() => null),+ snsIndexJson(`/v2/user/fav-domains/${addr}`, timeoutMs).catch(() => null),+ ]);++ const rawList = domainsBody?.[addr] ?? domainsBody?.data?.[addr] ?? [];+ const names = (Array.isArray(rawList) ? rawList : [])+ .map((d) => withSolSuffix(typeof d === 'string' ? d : d?.domain || d?.name))+ .filter(Boolean)+ .sort((a, b) => a.localeCompare(b));++ const favRaw = favBody?.[addr] ?? favBody?.data?.[addr] ?? null;++ return {+ allDomains: names.slice(0, limit),+ favoriteDomain: withSolSuffix(favRaw),+ truncated: names.length > limit,+ };+}+/*** Resolve a user-supplied Solana recipient string to a base58 address.*diff --git a/tests/.diag-tmp.test.js b/tests/.diag-tmp.test.jsdeleted file mode 100644index eff318949..000000000--- a/tests/.diag-tmp.test.js+++ /dev/null@@ -1,15 +0,0 @@-// @vitest-environment jsdom-import { it, expect } from 'vitest';-import { readFileSync } from 'node:fs';-const source = readFileSync('/workspaces/three.ws/src/game/coincommunities.js','utf8');-const { PlayOnboard } = await import('/workspaces/three.ws/src/game/play-onboard.js');-it('diag', () => {- const handled=[...new Set([...source.matchAll(/k === '([a-z])'/g)].map(m=>m[1]))];- new PlayOnboard({coin:{mint:'x',name:'three.ws',symbol:'three'}});- document.querySelector('.po-ctrl-btn').click();- const keys=[...document.querySelectorAll('#po-help .po-kbd')].map(k=>k.textContent);- console.log('HANDLED IN _bindInput():', handled.sort().join(' '));- console.log('CHIPS IN PANEL :', JSON.stringify(keys));- console.log('GROUPS :', [...document.querySelectorAll('#po-help .po-ctrl-group')].map(g=>g.textContent).join(' | '));- expect(true).toBe(true);-});diff --git a/tests/agent-economy-platform.test.js b/tests/agent-economy-platform.test.jsindex 2d23b40a6..edb13f479 100644--- a/tests/agent-economy-platform.test.js+++ b/tests/agent-economy-platform.test.js@@ -45,12 +45,12 @@ describe('platformEconomyStats', () => {],// top providers (one public w/ avatar, one private)[- { agent_id: 'p1', name: 'Oracle', is_public: true, thumb_key: 'thumb/p1.png', avatar_vis: 'public', earned_usd: 800, hires: 200, avg_rating: 4.6 },- { agent_id: 'p2', name: 'Nova', is_public: false, thumb_key: 'thumb/p2.png', avatar_vis: 'private', earned_usd: 300, hires: 90, avg_rating: null },+ { agent_id: 'p1', name: 'Oracle', linkable: true, thumb_key: 'thumb/p1.png', avatar_vis: 'public', earned_usd: 800, hires: 200, avg_rating: 4.6 },+ { agent_id: 'p2', name: 'Nova', linkable: false, thumb_key: 'thumb/p2.png', avatar_vis: 'private', earned_usd: 300, hires: 90, avg_rating: null },],// top hirers[- { agent_id: 'h1', name: 'Trader', is_public: true, thumb_key: null, avatar_vis: null, spent_usd: 500, hires: 120 },+ { agent_id: 'h1', name: 'Trader', linkable: true, thumb_key: null, avatar_vis: null, spent_usd: 500, hires: 120 },],// recent[@@ -93,6 +93,23 @@ describe('platformEconomyStats', () => {expect(r.recent[0].provider).toEqual({ agent_id: 'p1', name: 'Oracle', url: null });});+ it('never links a leaderboard row whose agent identity is gone', async () => {+ // A deleted agent leaves no `agent_identities` row, so the LEFT JOIN yields+ // a NULL name and no `linkable` flag. Linking it anyway sent readers to a+ // hollow /agent/<id> page, the exact failure the settled-hire feed already+ // guarded against.+ queue.push(+ [{}], // totals+ [], // daily+ [{ agent_id: 'ghost', name: 'Agent', linkable: false, thumb_key: null, avatar_vis: null, earned_usd: 12.5, hires: 1, avg_rating: null }],+ [{ agent_id: 'ghost', name: 'Agent', linkable: false, thumb_key: null, avatar_vis: null, spent_usd: 3, hires: 1 }],+ [], // recent+ );+ const r = await platformEconomyStats();+ expect(r.top_providers[0]).toMatchObject({ agent_id: 'ghost', name: 'Agent', url: null, earned_usd: 12.5 });+ expect(r.top_hirers[0]).toMatchObject({ agent_id: 'ghost', name: 'Agent', url: null, spent_usd: 3 });+ });+it('derives recent USD from atomics when the usd column is null', async () => {queue.push([{}], // totals (all null → zeros)diff --git a/tests/agent-economy-transact.test.js b/tests/agent-economy-transact.test.jsindex ad29d81ee..cbdef29a6 100644--- a/tests/agent-economy-transact.test.js+++ b/tests/agent-economy-transact.test.js@@ -207,6 +207,18 @@ describe('POST /api/agent-economy/transact', () => {expect(sendSolMock).not.toHaveBeenCalled();});+ it('treats an explicit null topic as no topic', async () => {+ // The demo page serialized its empty topic field as null, and a schema that+ // only allowed string|undefined answered 400 to the page's most common+ // request: pick a service, type nothing.+ const res = mkRes();+ await transact(mkReq({ service: 'risk-score', topic: null }), res);++ expect(res.statusCode).toBe(200);+ expect(payload(res).topic).toBeNull();+ expect(sendSolMock).toHaveBeenCalledTimes(1);+ });+it('rejects an unknown service and a bad body before any spend', async () => {const unknown = mkRes();await transact(mkReq({ service: 'not-a-service' }), unknown);diff --git a/tests/api-persona-endpoints.test.js b/tests/api-persona-endpoints.test.jsindex 0532a7b17..72b311fd8 100644--- a/tests/api-persona-endpoints.test.js+++ b/tests/api-persona-endpoints.test.js@@ -225,6 +225,39 @@ describe('POST /api/persona/extract', () => {expect(parse(res).error).toBe('parse_error');});+ // Attribution is not cosmetic: llmComplete only enforces its per-user daily+ // USD cap when a userId is known, and the spend ledger drops any completion+ // that arrives without one. The 5/day limiter bounds the call COUNT; this is+ // what bounds the bill.+ it('attributes the completion to the caller so the spend is capped and ledgered', async () => {+ llmCompleteMock.mockResolvedValue({ text: JSON.stringify(GOOD_PERSONA), model: 'm', usage: OK_USAGE });+ await callExtract({ freeform: 'anything' });+ expect(llmCompleteMock.mock.calls[0][0].track).toEqual({+ userId: 'user-1',+ tool: 'persona-extract',+ });+ });++ it('reports a spent LLM spend cap as a budget rather than a retryable outage', async () => {+ llmCompleteMock.mockRejectedValue(Object.assign(+ new Error('Daily LLM spend cap of $2.00 reached. Resets in under 24 hours.'),+ { status: 429, code: 'daily_spend_cap_exceeded' },+ ));+ const res = await callExtract({ freeform: 'anything' });+ expect(res.statusCode).toBe(429);+ expect(parse(res).error).toBe('daily_spend_cap_exceeded');+ expect(parse(res).error_description).toMatch(/Resets in under 24 hours/);+ });++ it('never lets a provider status become the caller status', async () => {+ // An expired server-side key answers 401. Echoing that reads to a browser+ // as an expired session on a request whose sign-in was never in doubt.+ llmCompleteMock.mockRejectedValue(Object.assign(new Error('provider 401'), { status: 401 }));+ const res = await callExtract({ freeform: 'anything' });+ expect(res.statusCode).toBe(502);+ expect(parse(res).error).toBe('upstream_error');+ });+it('answers a preflight without running the handler body', async () => {const res = mkRes();await extractHandler(mkReq({ method: 'OPTIONS', headers: { origin: 'http://localhost:3000' } }), res);@@ -316,6 +349,32 @@ describe('POST /api/persona/preview', () => {expect(parse(res).error).toBe('upstream_error');});+ it('attributes the completion to the caller so the spend is capped and ledgered', async () => {+ llmCompleteMock.mockResolvedValue({ text: 'ok', model: 'm', usage: OK_USAGE });+ await callPreview({ persona: GOOD_PERSONA, user_message: 'hi' });+ expect(llmCompleteMock.mock.calls[0][0].track).toEqual({+ userId: 'user-1',+ tool: 'persona-preview',+ });+ });++ it('reports a spent LLM spend cap as a budget rather than a retryable outage', async () => {+ llmCompleteMock.mockRejectedValue(Object.assign(+ new Error('Daily LLM spend cap of $2.00 reached. Resets in under 24 hours.'),+ { status: 429, code: 'daily_spend_cap_exceeded' },+ ));+ const res = await callPreview({ persona: GOOD_PERSONA, user_message: 'hi' });+ expect(res.statusCode).toBe(429);+ expect(parse(res).error).toBe('daily_spend_cap_exceeded');+ });++ it('never lets a provider status become the caller status', async () => {+ llmCompleteMock.mockRejectedValue(Object.assign(new Error('provider 401'), { status: 401 }));+ const res = await callPreview({ persona: GOOD_PERSONA, user_message: 'hi' });+ expect(res.statusCode).toBe(502);+ expect(parse(res).error).toBe('upstream_error');+ });+it('rejects a non-POST method', async () => {const res = mkRes();await previewHandler(mkReq({ method: 'GET', url: '/api/persona/preview' }), res);diff --git a/tests/api/sns-owner-domains.test.js b/tests/api/sns-owner-domains.test.jsnew file mode 100644index 000000000..caa34d687--- /dev/null+++ b/tests/api/sns-owner-domains.test.js@@ -0,0 +1,158 @@+// GET /api/sns?...&domains=1 (api/sns.js).+//+// The regression this pins: @three-ws/names has always mapped `all_domains` and+// `favorite_domain` off this endpoint's envelope, but nothing ever put them+// there, so both fields were permanently empty while the SDK README documented+// them as populated. They are now real, opt-in, and off the default path: a+// plain resolve must stay one cache-friendly URL with no SNS-index round trip,+// because the reverse lookup here runs on every page load.++import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';++const resolveSnsName = vi.fn();+const reverseLookupAddress = vi.fn();+const snsOwnerDomains = vi.fn();++vi.mock('../../src/solana/sns.js', () => ({+ resolveSnsName: (...a) => resolveSnsName(...a),+ reverseLookupAddress: (...a) => reverseLookupAddress(...a),+ snsOwnerDomains: (...a) => snsOwnerDomains(...a),+}));+vi.mock('../../api/_lib/rate-limit.js', () => ({+ limits: { snsResolve: async () => ({ success: true }) },+ clientIp: () => '127.0.0.1',+}));++const { default: handler, _internals } = await import('../../api/sns.js');++const OWNER = 'THREEsynthetic1111111111111111111111111111';++function call(url) {+ const res = {+ statusCode: 0,+ body: null,+ headers: {},+ setHeader(k, v) {+ this.headers[k.toLowerCase()] = v;+ },+ getHeader(k) {+ return this.headers[k.toLowerCase()];+ },+ end(b) {+ this.body = b ? JSON.parse(b) : null;+ },+ get headersSent() {+ return this.body !== null;+ },+ get writableEnded() {+ return this.body !== null;+ },+ };+ const req = { method: 'GET', url, headers: { host: 'three.ws' } };+ return handler(req, res).then(() => res);+}++beforeEach(() => {+ resolveSnsName.mockReset();+ reverseLookupAddress.mockReset();+ snsOwnerDomains.mockReset();+ // Module-level caches are shared across tests in this file; a stale entry+ // would make a later assertion pass for the wrong reason.+ _internals.forwardCache.clear();+ _internals.reverseCache.clear();+ _internals.domainsCache.clear();+});++afterEach(() => {+ _internals.domainsCache.clear();+});++describe('GET /api/sns', () => {+ it('leaves the domain list off a plain forward resolve', async () => {+ resolveSnsName.mockResolvedValue(OWNER);+ const res = await call('/api/sns?name=three.sol');++ expect(res.statusCode).toBe(200);+ expect(res.body.data).toEqual({+ name: 'three.sol',+ address: OWNER,+ network: 'solana',+ resolved: true,+ });+ expect(snsOwnerDomains).not.toHaveBeenCalled();+ });++ it('adds the owner domain list and favorite when domains=1', async () => {+ resolveSnsName.mockResolvedValue(OWNER);+ snsOwnerDomains.mockResolvedValue({+ allDomains: ['three.sol', 'threews.sol'],+ favoriteDomain: 'three.sol',+ truncated: false,+ });+ const res = await call('/api/sns?name=three.sol&domains=1');++ expect(res.statusCode).toBe(200);+ expect(snsOwnerDomains).toHaveBeenCalledWith(OWNER);+ expect(res.body.data.all_domains).toEqual(['three.sol', 'threews.sol']);+ expect(res.body.data.favorite_domain).toBe('three.sol');+ expect(res.body.data.domains_truncated).toBe(false);+ });++ it('accepts the truthy spellings of the flag and ignores anything else', async () => {+ resolveSnsName.mockResolvedValue(OWNER);+ snsOwnerDomains.mockResolvedValue({ allDomains: ['three.sol'], favoriteDomain: null, truncated: false });++ for (const flag of ['1', 'true', 'TRUE', 'yes']) {+ _internals.forwardCache.clear();+ const res = await call(`/api/sns?name=three.sol&domains=${flag}`);+ expect(res.body.data.all_domains, `flag=${flag}`).toEqual(['three.sol']);+ }++ snsOwnerDomains.mockClear();+ _internals.forwardCache.clear();+ const off = await call('/api/sns?name=three.sol&domains=0');+ expect(off.body.data.all_domains).toBeUndefined();+ expect(snsOwnerDomains).not.toHaveBeenCalled();+ });++ it('caches the owner lookup so a second resolve of the same owner is free', async () => {+ resolveSnsName.mockResolvedValue(OWNER);+ snsOwnerDomains.mockResolvedValue({ allDomains: ['three.sol'], favoriteDomain: 'three.sol', truncated: false });++ await call('/api/sns?name=three.sol&domains=1');+ _internals.forwardCache.clear();+ await call('/api/sns?name=three.sol&domains=1');++ expect(snsOwnerDomains).toHaveBeenCalledTimes(1);+ });++ it('still answers with the plain envelope when the SNS index is down', async () => {+ resolveSnsName.mockResolvedValue(OWNER);+ snsOwnerDomains.mockRejectedValue(new Error('sns index 503'));+ const res = await call('/api/sns?name=three.sol&domains=1');++ expect(res.statusCode).toBe(200);+ expect(res.body.data.address).toBe(OWNER);+ expect(res.body.data.all_domains).toBeUndefined();+ });++ it('lists a wallet holding domains but no favorite on a reverse miss', async () => {+ reverseLookupAddress.mockResolvedValue(null);+ snsOwnerDomains.mockResolvedValue({ allDomains: ['three.sol'], favoriteDomain: null, truncated: false });+ const res = await call(`/api/sns?address=${OWNER}&domains=1`);++ expect(res.statusCode).toBe(200);+ expect(res.body.data.resolved).toBe(false);+ expect(res.body.data.name).toBeNull();+ expect(res.body.data.all_domains).toEqual(['three.sol']);+ });++ it('adds the list to a resolved reverse lookup too', async () => {+ reverseLookupAddress.mockResolvedValue('three.sol');+ snsOwnerDomains.mockResolvedValue({ allDomains: ['three.sol'], favoriteDomain: 'three.sol', truncated: true });+ const res = await call(`/api/sns?address=${OWNER}&domains=1`);++ expect(res.body.data.name).toBe('three.sol');+ expect(res.body.data.domains_truncated).toBe(true);+ });+});diff --git a/tests/api/x-memory-seed-consent.test.js b/tests/api/x-memory-seed-consent.test.jsnew file mode 100644index 000000000..fb08cd81f--- /dev/null+++ b/tests/api/x-memory-seed-consent.test.js@@ -0,0 +1,507 @@+// Consent gate and revocation for X memory seeding.+//+// tests/api/x-memory-seed-transform.test.js pins the pure transform (what gets+// read, what gets stored, what never does). This file pins the half that decides+// whether the transform is allowed to run at all, and the half that undoes it:+//+// - a POST without an explicit, current-version acceptance reads nothing from+// X and burns none of the owner's re-seed budget,+// - a grant stops authorizing seeds when the disclosure text moves on or the+// connection starts pointing at a different X account,+// - revoking deletes every memory the grant produced and clears the seed+// stamp off the agent, whether or not a grant row survives to revoke.+//+// The handler and api/_lib/x-seed-consent.js both run for real against a routed+// `sql` double, so the actual DELETE predicate (match on the x_seed tag) is what+// gets asserted rather than a restatement of it.++import { describe, it, expect, beforeEach, vi } from 'vitest';++const AGENT = '99999999-8888-4777-8666-555555555555';+const OWNER = 'user-1';++// Routed `sql` double: each handler query is matched on its text, so a test+// states only the rows it cares about instead of counting positions in a queue.+const dbState = {+ agent: null,+ connection: null,+ consent: null,+ seededCount: 0,+ deletedMemoryIds: [],+ revokedConsentIds: [],+ queries: [],+ inserts: [],+};++vi.mock('../../api/_lib/db.js', () => {+ const sql = vi.fn(async (strings, ...values) => {+ const q = (Array.isArray(strings) ? strings.join('?') : String(strings))+ .replace(/\s+/g, ' ')+ .trim();+ dbState.queries.push({ q, values });++ if (/FROM agent_identities/i.test(q)) return dbState.agent ? [dbState.agent] : [];+ if (/FROM social_connections/i.test(q)) return dbState.connection ? [dbState.connection] : [];+ if (/FROM x_memory_consents/i.test(q)) return dbState.consent ? [dbState.consent] : [];+ if (/count\(\*\)::int AS count FROM agent_memories/i.test(q)) {+ return [{ count: dbState.seededCount }];+ }+ if (/^INSERT INTO x_memory_consents/i.test(q)) {+ dbState.consent = {+ id: 'consent-new',+ x_user_id: values[2],+ username: values[3],+ scope_version: values[4],+ granted_scopes: values[6] ?? null,+ granted_at: '2026-08-15T00:00:00.000Z',+ last_seeded_at: null,+ memories_seeded: 0,+ posts_read: 0,+ };+ return [dbState.consent];+ }+ if (/^INSERT INTO agent_memories/i.test(q)) {+ dbState.inserts.push(values);+ return [];+ }+ if (/^UPDATE x_memory_consents SET revoked_at/i.test(q)) {+ const ids = dbState.consent ? [{ id: dbState.consent.id, agent_id: AGENT }] : [];+ dbState.revokedConsentIds = ids;+ dbState.consent = null;+ return ids;+ }+ if (/^DELETE FROM agent_memories/i.test(q)) {+ const rows = dbState.deletedMemoryIds.map((id) => ({ id, agent_id: AGENT }));+ dbState.seededCount = 0;+ dbState.deletedMemoryIds = [];+ return rows;+ }+ return [];+ });+ return {+ sql,+ isDbUnavailableError: () => false,+ isDbCapacityError: () => false,+ isStoragePressured: () => false,+ };+});++const authState = { session: null };+vi.mock('../../api/_lib/auth.js', () => ({+ getSessionUser: vi.fn(async () => authState.session),+ authenticateBearer: vi.fn(async () => null),+ extractBearer: vi.fn(() => null),+}));++vi.mock('../../api/_lib/csrf.js', () => ({ requireCsrf: vi.fn(async () => true) }));++const xSeed = vi.fn(async () => ({ success: true, limit: 1, remaining: 0, reset: 1 }));+vi.mock('../../api/_lib/rate-limit.js', () => ({+ limits: {+ xSeed: (...a) => xSeed(...a),+ authIp: vi.fn(async () => ({ success: true })),+ },+ clientIp: vi.fn(() => '127.0.0.1'),+}));++vi.mock('../../api/_lib/env.js', () => ({+ env: { X_OAUTH_CLIENT_ID: 'test-client-id', X_OAUTH_CLIENT_SECRET: 'test-client-secret' },+}));++const llmComplete = vi.fn(async () => ({ text: '[]' }));+vi.mock('../../api/_lib/llm.js', () => ({ llmComplete: (...a) => llmComplete(...a) }));++vi.mock('../../api/auth/x/[action].js', () => ({+ decryptToken: vi.fn(() => 'plaintext-access-token'),+ encryptToken: vi.fn((t) => `enc:${t}`),+}));++const { default: handler } = await import('../../api/agents/[id]/memory-seed-x.js');+const { X_SEED_DISCLOSURE, X_SEED_SCOPE_VERSION } = await import(+ '../../api/_lib/x-memory-seed.js'+);++function mockRes() {+ return {+ statusCode: 200,+ headers: {},+ body: null,+ headersSent: false,+ writableEnded: false,+ setHeader(k, v) { this.headers[k.toLowerCase()] = v; },+ getHeader(k) { return this.headers[k.toLowerCase()]; },+ end(payload) { this.headersSent = true; this.writableEnded = true; this.body = payload ?? null; },+ get json() { return this.body ? JSON.parse(this.body) : null; },+ };+}++async function call({ method = 'GET', id = AGENT, body } = {}) {+ const req = {+ method,+ url: `/api/agents/${id}/memory/seed/x`,+ headers: {},+ socket: {},+ query: { id },+ };+ if (body !== undefined) {+ req.body = body;+ req.headers['content-type'] = 'application/json';+ }+ const res = mockRes();+ await handler(req, res);+ return res;+}++function liveConnection(overrides = {}) {+ return {+ id: 'conn-1',+ provider_uid: 'x-account-42',+ username: 'qauser',+ scopes: 'tweet.read users.read offline.access',+ access_token: 'enc-access',+ refresh_token: 'enc-refresh',+ expires_at: new Date(Date.now() + 3_600_000).toISOString(),+ ...overrides,+ };+}++function liveConsent(overrides = {}) {+ return {+ id: 'consent-1',+ x_user_id: 'x-account-42',+ username: 'qauser',+ scope_version: X_SEED_SCOPE_VERSION,+ granted_scopes: 'tweet.read users.read offline.access',+ granted_at: '2026-08-11T00:00:00.000Z',+ last_seeded_at: null,+ memories_seeded: 0,+ posts_read: 0,+ ...overrides,+ };+}++beforeEach(() => {+ vi.clearAllMocks();+ authState.session = { id: OWNER, email: '[email protected]' };+ dbState.agent = { id: AGENT, user_id: OWNER, x_username: null, x_seeded_at: null };+ dbState.connection = null;+ dbState.consent = null;+ dbState.seededCount = 0;+ dbState.deletedMemoryIds = [];+ dbState.revokedConsentIds = [];+ dbState.queries = [];+ dbState.inserts = [];+ xSeed.mockResolvedValue({ success: true, limit: 1, remaining: 0, reset: 1 });+ vi.stubGlobal('fetch', vi.fn(async () => {+ throw new Error('the network must not be touched on a refusal path');+ }));+});++describe('GET /api/agents/:id/memory/seed/x', () => {+ it('requires a session', async () => {+ authState.session = null;+ const res = await call();+ expect(res.statusCode).toBe(401);+ expect(res.json).toMatchObject({ error: 'unauthorized' });+ });++ it('refuses an agent the caller does not own', async () => {+ dbState.agent = { id: AGENT, user_id: 'someone-else', x_username: null, x_seeded_at: null };+ const res = await call();+ expect(res.statusCode).toBe(403);+ expect(res.json).toMatchObject({ error: 'forbidden' });+ });++ it('serves the disclosure verbatim so the consent screen never carries its own copy', async () => {+ dbState.connection = liveConnection();+ const res = await call();+ expect(res.statusCode).toBe(200);+ expect(res.json.disclosure).toEqual(JSON.parse(JSON.stringify(X_SEED_DISCLOSURE)));+ expect(res.json.scope_version).toBe(X_SEED_SCOPE_VERSION);+ expect(res.json).toMatchObject({ connected: true, configured: true, username: 'qauser' });+ expect(res.json.consent).toMatchObject({ granted: false, reason: 'none' });+ });++ it('reports a connection that is present but not yet consented as ungranted', async () => {+ dbState.connection = liveConnection();+ dbState.seededCount = 0;+ const res = await call();+ expect(res.json.consent.granted).toBe(false);+ expect(res.json.fact_count).toBe(0);+ });++ it('retires a grant whose disclosure version has moved on', async () => {+ dbState.connection = liveConnection();+ dbState.consent = liveConsent({ scope_version: '2020-01-01.0' });+ const res = await call();+ expect(res.json.consent).toMatchObject({ granted: false, reason: 'scope_version_changed' });+ });++ it('retires a grant when the connection now points at a different X account', async () => {+ dbState.connection = liveConnection({ provider_uid: 'x-account-99' });+ dbState.consent = liveConsent();+ const res = await call();+ expect(res.json.consent).toMatchObject({ granted: false, reason: 'account_changed' });+ });++ it('reports a live grant as active', async () => {+ dbState.connection = liveConnection();+ dbState.consent = liveConsent({ last_seeded_at: '2026-08-12T00:00:00.000Z', memories_seeded: 12 });+ dbState.seededCount = 12;+ const res = await call();+ expect(res.json.consent).toMatchObject({+ granted: true,+ reason: 'active',+ username: 'qauser',+ memories_seeded: 12,+ });+ expect(res.json.fact_count).toBe(12);+ });+});++describe('POST /api/agents/:id/memory/seed/x consent gate', () => {+ it('reads nothing from X and records no grant when consent is absent', async () => {+ dbState.connection = liveConnection();+ const res = await call({ method: 'POST', body: {} });++ expect(res.statusCode).toBe(403);+ expect(res.json).toMatchObject({ error: 'consent_required' });+ expect(res.json.disclosure).toEqual(JSON.parse(JSON.stringify(X_SEED_DISCLOSURE)));+ expect(globalThis.fetch).not.toHaveBeenCalled();+ expect(dbState.queries.some((c) => /INSERT INTO x_memory_consents/i.test(c.q))).toBe(false);+ });++ it('does not burn the re-seed budget on a refused call', async () => {+ dbState.connection = liveConnection();+ await call({ method: 'POST', body: {} });+ expect(xSeed).not.toHaveBeenCalled();+ });++ it('refuses an acceptance pinned to a disclosure version that is no longer current', async () => {+ dbState.connection = liveConnection();+ const res = await call({+ method: 'POST',+ body: { consent: { accepted: true, scope_version: '2020-01-01.0' } },+ });+ expect(res.statusCode).toBe(403);+ expect(res.json).toMatchObject({ error: 'consent_required' });+ expect(globalThis.fetch).not.toHaveBeenCalled();+ });++ it('refuses an acceptance that carries the right version but never says yes', async () => {+ dbState.connection = liveConnection();+ const res = await call({+ method: 'POST',+ body: { consent: { accepted: false, scope_version: X_SEED_SCOPE_VERSION } },+ });+ expect(res.statusCode).toBe(403);+ expect(res.json).toMatchObject({ error: 'consent_required' });+ expect(globalThis.fetch).not.toHaveBeenCalled();+ });++ it('refuses to seed at all without a live X connection', async () => {+ dbState.connection = null;+ const res = await call({+ method: 'POST',+ body: { consent: { accepted: true, scope_version: X_SEED_SCOPE_VERSION } },+ });+ expect(res.statusCode).toBe(400);+ expect(res.json).toMatchObject({ error: 'not_connected' });+ expect(globalThis.fetch).not.toHaveBeenCalled();+ expect(xSeed).not.toHaveBeenCalled();+ });++ it('requires a session before anything else', async () => {+ authState.session = null;+ const res = await call({+ method: 'POST',+ body: { consent: { accepted: true, scope_version: X_SEED_SCOPE_VERSION } },+ });+ expect(res.statusCode).toBe(401);+ expect(globalThis.fetch).not.toHaveBeenCalled();+ });+});++describe('POST /api/agents/:id/memory/seed/x seeding', () => {+ const profilePayload = {+ data: {+ id: 'x-account-42',+ username: 'qauser',+ name: 'QA User',+ description: 'Builds agent tooling on Solana',+ public_metrics: { followers_count: 300, following_count: 120 },+ },+ };+ const postsPayload = {+ data: [+ { text: 'Shipping the retargeting rig today, legs finally land right.', created_at: '2026-08-10T00:00:00Z' },+ { text: 'Solana settlement latency is the whole product, everything else is UI.', created_at: '2026-08-09T00:00:00Z' },+ { text: 'Spent the morning deleting code. Best refactor of the week.', created_at: '2026-08-08T00:00:00Z' },+ ],+ };++ function stubXApi() {+ vi.stubGlobal('fetch', vi.fn(async (url) => {+ if (String(url).includes('/2/users/me')) {+ return { ok: true, json: async () => profilePayload };+ }+ return { ok: true, json: async () => postsPayload };+ }));+ }++ it('grants consent, reads X once, and writes tagged memory rows', async () => {+ dbState.connection = liveConnection();+ stubXApi();+ llmComplete.mockResolvedValue({+ text: JSON.stringify([+ 'Works on avatar retargeting and rigging.',+ 'Believes settlement latency is the core of a payments product.',+ 'Prefers deleting code over adding it.',+ ]),+ });++ const res = await call({+ method: 'POST',+ body: { consent: { accepted: true, scope_version: X_SEED_SCOPE_VERSION } },+ });++ expect(res.statusCode).toBe(200);+ expect(res.json).toMatchObject({ username: 'qauser', seeded: 3, posts_read: 3, distilled_by: 'model' });+ expect(xSeed).toHaveBeenCalledWith(AGENT);+ expect(dbState.inserts).toHaveLength(3);++ // Every stored row carries the tag revocation matches on, and the consent+ // id that authorized it.+ for (const values of dbState.inserts) {+ expect(values.some((v) => Array.isArray(v) && v.includes('x_seed'))).toBe(true);+ const ctx = values.find((v) => typeof v === 'string' && v.includes('consent_id'));+ expect(JSON.parse(ctx)).toMatchObject({ source: 'x_seed', consent_id: 'consent-new' });+ }+ });++ it('replaces the previous batch instead of stacking a second generation', async () => {+ dbState.connection = liveConnection();+ dbState.consent = liveConsent();+ stubXApi();+ llmComplete.mockResolvedValue({ text: JSON.stringify(['Ships avatar tooling.']) });++ const res = await call({ method: 'POST', body: {} });++ expect(res.statusCode).toBe(200);+ const deletes = dbState.queries.filter((c) => /^DELETE FROM agent_memories/i.test(c.q));+ expect(deletes.length).toBe(1);+ expect(deletes[0].q).toMatch(/tags && ARRAY/i);+ });++ it('refuses when the connected account is not the account that consented', async () => {+ dbState.connection = liveConnection();+ dbState.consent = liveConsent();+ vi.stubGlobal('fetch', vi.fn(async (url) => {+ if (String(url).includes('/2/users/me')) {+ return {+ ok: true,+ json: async () => ({ data: { ...profilePayload.data, id: 'x-account-77' } }),+ };+ }+ return { ok: true, json: async () => postsPayload };+ }));++ const res = await call({ method: 'POST', body: {} });++ expect(res.statusCode).toBe(409);+ expect(res.json).toMatchObject({ error: 'account_mismatch' });+ expect(dbState.inserts).toHaveLength(0);+ });++ it('still seeds from derived facts when the distiller is unavailable', async () => {+ dbState.connection = liveConnection();+ dbState.consent = liveConsent();+ stubXApi();+ llmComplete.mockRejectedValue(new Error('no provider'));++ const res = await call({ method: 'POST', body: {} });++ expect(res.statusCode).toBe(200);+ expect(res.json.distilled_by).toBe('derived');+ expect(res.json.seeded).toBeGreaterThan(0);+ });++ it('reports the re-seed window instead of reading X again', async () => {+ dbState.connection = liveConnection();+ dbState.consent = liveConsent();+ xSeed.mockResolvedValue({ success: false, limit: 1, remaining: 0, reset: 60 });++ const res = await call({ method: 'POST', body: {} });++ expect(res.statusCode).toBe(429);+ expect(res.json).toMatchObject({ error: 'rate_limited' });+ expect(globalThis.fetch).not.toHaveBeenCalled();+ });+});++describe('DELETE /api/agents/:id/memory/seed/x', () => {+ it('revokes the grant and deletes every memory it produced', async () => {+ dbState.connection = liveConnection();+ dbState.consent = liveConsent();+ dbState.seededCount = 4;+ dbState.deletedMemoryIds = ['m1', 'm2', 'm3', 'm4'];++ const res = await call({ method: 'DELETE' });++ expect(res.statusCode).toBe(200);+ expect(res.json).toMatchObject({+ revoked: true,+ deleted: 4,+ consents_revoked: 1,+ remaining: 0,+ });+ expect(res.json.consent).toMatchObject({ granted: false, reason: 'revoked' });+ });++ it('deletes on the x_seed tag, so rows from a superseded grant go too', async () => {+ dbState.connection = liveConnection();+ dbState.consent = liveConsent();+ dbState.deletedMemoryIds = ['m1'];++ await call({ method: 'DELETE' });++ const del = dbState.queries.find((c) => /^DELETE FROM agent_memories/i.test(c.q));+ expect(del.q).toMatch(/tags && ARRAY/i);+ expect(del.q).not.toMatch(/consent_id/i);+ expect(del.values).toContain('x_seed');+ });++ it('clears the seed stamp off the agent so the UI stops claiming a seed', async () => {+ dbState.connection = liveConnection();+ dbState.consent = liveConsent();+ dbState.deletedMemoryIds = ['m1'];++ await call({ method: 'DELETE' });++ const stamp = dbState.queries.find(+ (c) => /^UPDATE agent_identities SET x_username = NULL/i.test(c.q),+ );+ expect(stamp).toBeTruthy();+ });++ it('is idempotent and still purges when no grant row survives to revoke', async () => {+ dbState.connection = liveConnection();+ dbState.consent = null;+ dbState.seededCount = 2;+ dbState.deletedMemoryIds = ['orphan-1', 'orphan-2'];++ const res = await call({ method: 'DELETE' });++ expect(res.statusCode).toBe(200);+ expect(res.json).toMatchObject({ revoked: true, deleted: 2, consents_revoked: 0, remaining: 0 });+ });++ it('requires a session and ownership', async () => {+ authState.session = null;+ expect((await call({ method: 'DELETE' })).statusCode).toBe(401);++ authState.session = { id: OWNER };+ dbState.agent = { id: AGENT, user_id: 'someone-else', x_username: null, x_seeded_at: null };+ expect((await call({ method: 'DELETE' })).statusCode).toBe(403);+ });+});diff --git a/tests/cron-economy-tick-origin-guard.test.js b/tests/cron-economy-tick-origin-guard.test.jsnew file mode 100644index 000000000..4a66f213d--- /dev/null+++ b/tests/cron-economy-tick-origin-guard.test.js@@ -0,0 +1,104 @@+// The economy heartbeat must not fan out from a machine that is not production+// (api/cron/economy-tick.js).+//+// economy-tick fires thirty-six money engines over HTTP at env.APP_ORIGIN, which+// falls back to https://three.ws whenever PUBLIC_APP_ORIGIN is unset. That is the+// default state of a laptop, a CI box, or an audit session, so simply booting the+// handler there and calling it with the production cron secret aims the whole+// economy at production from a process that is not production. On 2026-08-14 one+// such run put 36 rejected calls into the production log inside a single minute.+//+// Pinned here:+// 1. no K_SERVICE + a remote origin → no fetch at all, a reported skip, 200+// 2. no K_SERVICE + a loopback origin → the fan-out runs (a deliberate local test)+// 3. K_SERVICE set → the fan-out runs, so the real Cloud Run heartbeat is untouched+import { test, expect, vi, beforeEach, afterEach } from 'vitest';++vi.mock('../api/_lib/cron-auth.js', () => ({ requireCron: () => true }));+vi.mock('../api/_lib/cache.js', () => ({ cacheSet: async () => {} }));+vi.mock('../api/_lib/usage.js', () => ({+ logger: () => ({ info() {}, warn() {}, error() {} }),+}));++const handler = (await import('../api/cron/economy-tick.js')).default;++function makeRes() {+ return {+ statusCode: 0,+ body: null,+ headersSent: false,+ writableEnded: false,+ setHeader() {},+ getHeader() {},+ status(code) { this.statusCode = code; return this; },+ end(payload) {+ this.writableEnded = true;+ if (payload && this.body === null) {+ try { this.body = JSON.parse(payload); } catch { this.body = payload; }+ }+ return this;+ },+ json(payload) { this.body = payload; return this; },+ };+}++const savedService = process.env.K_SERVICE;+const savedOrigin = process.env.PUBLIC_APP_ORIGIN;+let fetched = [];++beforeEach(() => {+ fetched = [];+ vi.stubGlobal('fetch', async (url) => {+ fetched.push(String(url));+ return { ok: true, status: 200, json: async () => ({}) };+ });+});++afterEach(() => {+ vi.unstubAllGlobals();+ if (savedService === undefined) delete process.env.K_SERVICE;+ else process.env.K_SERVICE = savedService;+ if (savedOrigin === undefined) delete process.env.PUBLIC_APP_ORIGIN;+ else process.env.PUBLIC_APP_ORIGIN = savedOrigin;+});++async function run() {+ const res = makeRes();+ await handler({ method: 'GET', url: '/api/cron/economy-tick', headers: {} }, res);+ return res;+}++test('an undeployed process aimed at a remote origin fires nothing', async () => {+ delete process.env.K_SERVICE;+ process.env.PUBLIC_APP_ORIGIN = 'https://three.ws';++ const res = await run();++ expect(fetched).toEqual([]);+ expect(res.body.skipped).toBe('not_deployed');+ expect(res.body.ok).toBe(true);+ expect(res.body.origin).toBe('https://three.ws');+ expect(res.body.engines).toBeGreaterThan(0);+});++test('an undeployed process aimed at a loopback origin still fans out', async () => {+ delete process.env.K_SERVICE;+ process.env.PUBLIC_APP_ORIGIN = 'http://127.0.0.1:3111';++ const res = await run();++ expect(res.body.skipped).toBeUndefined();+ expect(fetched.length).toBeGreaterThan(0);+ expect(fetched.every((u) => u.startsWith('http://127.0.0.1:3111/'))).toBe(true);+});++test('a Cloud Run revision fans out as before', async () => {+ process.env.K_SERVICE = 'three-ws-api';+ process.env.PUBLIC_APP_ORIGIN = 'https://three.ws';++ const res = await run();++ expect(res.body.skipped).toBeUndefined();+ expect(res.body.fired).toBe(fetched.length);+ expect(fetched.every((u) => u.startsWith('https://three.ws/'))).toBe(true);+});diff --git a/tests/cron-ledger-anchor-outage.test.js b/tests/cron-ledger-anchor-outage.test.jsnew file mode 100644index 000000000..6fc43f8d1--- /dev/null+++ b/tests/cron-ledger-anchor-outage.test.js@@ -0,0 +1,120 @@+// A dead on-chain anchor leg must be loud and must stop retrying itself+// (api/cron/reconcile-decisions.js + api/_lib/ledger-anchor.js).+//+// The Reasoning Ledger anchors each agent's chain head as an SPL-Memo so+// /api/ledger/verify/:agentId has an independent on-chain witness. Two distinct+// things can stop that, and they used to be reported identically:+//+// • no attester key configured — a documented degraded mode. The commitment is+// still recorded locally, every agent should still get its row, and nobody+// should be paged.+// • the broadcast itself rejected (an unfunded attester wallet answers every+// send with "Attempt to debit an account but found no record of a prior+// credit") — a real outage. It fails identically for every agent in the run,+// so re-simulating the same doomed memo for each remaining agent is pure+// waste, and a silent 200 is how it stayed invisible.+//+// The properties pinned here are exactly that split:+// 1. a rejected broadcast counts as anchor_failed, halts the loop, records what+// it skipped, and pages ops+// 2. a missing key stays pending for every agent and pages nobody+//+// The matching unit property for anchorLedgerHead itself (a rejected broadcast+// returns 'failed', not 'pending') lives in ledger-anchor-broadcast-status.test.js;+// it needs the real module, which this file mocks out.+import { test, expect, vi, beforeEach } from 'vitest';++const sendOpsAlert = vi.fn(async () => {});+const anchorLedgerHead = vi.fn(async () => ({ status: 'pending', signature: null }));++let sqlHandler = () => [];+vi.mock('../api/_lib/db.js', () => ({+ sql: (strings, ...values) => Promise.resolve(sqlHandler(strings.join('?'), values)),+}));+vi.mock('../api/_lib/alerts.js', () => ({+ sendOpsAlert: (...args) => sendOpsAlert(...args),+}));+vi.mock('../api/_lib/cron-auth.js', () => ({ requireCron: () => true }));+vi.mock('../api/_lib/reasoning-ledger.js', () => ({+ recordOutcome: async () => ({ reconciled: false }),+ computeReputation: () => ({ sample_size: 0, hit_rate: 1, score: 0 }),+ getReputationRecords: async () => [],+}));+vi.mock('../api/_lib/ledger-anchor.js', () => ({+ anchorLedgerHead: (...args) => anchorLedgerHead(...args),+ latestAnchoredAnchor: async () => null,+}));++const handler = (await import('../api/cron/reconcile-decisions.js')).default;++function makeRes() {+ return {+ statusCode: 0,+ body: null,+ headersSent: false,+ writableEnded: false,+ setHeader() {},+ getHeader() {},+ status(code) { this.statusCode = code; return this; },+ end(payload) {+ this.writableEnded = true;+ if (payload && this.body === null) {+ try { this.body = JSON.parse(payload); } catch { this.body = payload; }+ }+ return this;+ },+ json(payload) { this.body = payload; return this; },+ };+}++// Four agents all sitting past their last anchor, nothing to reconcile.+function fourAgentsWithMovedHeads(text) {+ if (text.includes('decision_outcomes o')) return []; // nothing to reconcile+ if (text.includes('max(seq)')) {+ return [1, 2, 3, 4].map((n) => ({ agent_id: `agent-${n}`, head_seq: n * 10, cnt: n * 10 }));+ }+ if (text.includes('entry_hash')) return [{ entry_hash: 'hash', network: 'mainnet' }];+ return [];+}++beforeEach(() => {+ sendOpsAlert.mockClear();+ anchorLedgerHead.mockClear();+ sqlHandler = fourAgentsWithMovedHeads;+});++test('a rejected broadcast halts the anchor loop, reports it, and pages ops', async () => {+ anchorLedgerHead.mockImplementation(async () => ({+ status: 'failed',+ signature: null,+ detail: 'record_failed: Attempt to debit an account but found no record of a prior credit.',+ }));++ const res = makeRes();+ await handler({ method: 'GET', url: '/api/cron/reconcile-decisions', headers: {} }, res);++ expect(res.body.anchor_failed).toBe(1);+ expect(res.body.anchor_skipped).toBe(3);+ expect(res.body.anchored).toBe(0);+ expect(res.body.anchor_outage).toContain('no record of a prior credit');+ // One doomed send, not one per agent.+ expect(anchorLedgerHead).toHaveBeenCalledTimes(1);+ expect(sendOpsAlert).toHaveBeenCalledTimes(1);+ expect(sendOpsAlert.mock.calls[0][2]).toMatchObject({ signature: 'ledger-anchor-broadcast-failed' });+});++test('a missing attester key records every agent as pending and pages nobody', async () => {+ anchorLedgerHead.mockImplementation(async () => ({+ status: 'pending', signature: null, detail: 'attester_key_not_configured',+ }));++ const res = makeRes();+ await handler({ method: 'GET', url: '/api/cron/reconcile-decisions', headers: {} }, res);++ expect(res.body.anchor_pending).toBe(4);+ expect(res.body.anchor_failed).toBe(0);+ expect(res.body.anchor_skipped).toBe(0);+ expect(res.body.anchor_outage).toBeUndefined();+ expect(anchorLedgerHead).toHaveBeenCalledTimes(4);+ expect(sendOpsAlert).not.toHaveBeenCalled();+});diff --git a/tests/gcp-billing.test.js b/tests/gcp-billing.test.jsindex e4068f6a6..e65dbed78 100644--- a/tests/gcp-billing.test.js+++ b/tests/gcp-billing.test.js@@ -12,6 +12,7 @@ import {resolveBillingConfig,billingConfigured,BillingUnavailableError,+ BillingExportMissingError,usd,} from '../api/_lib/gcp-billing.js';@@ -163,6 +164,30 @@ describe('resolveBillingConfig', () => {});});+describe('BillingExportMissingError', () => {+ // The burn cron branches on this type to tell "one console step short of+ // wired" apart from a real BigQuery or auth fault. Getting the hierarchy+ // wrong in either direction is a live bug: too narrow and every existing+ // `instanceof BillingUnavailableError` catch stops firing, too wide and the+ // cron pages ops daily about a step no retry can complete.+ it('is catchable as a BillingUnavailableError', () => {+ const err = new BillingExportMissingError('Billing export table not found: nope');+ expect(err).toBeInstanceOf(BillingUnavailableError);+ expect(err).toBeInstanceOf(Error);+ });++ it('carries a code distinct from a generic billing outage', () => {+ expect(new BillingExportMissingError('x').code).toBe('billing_export_missing');+ expect(new BillingUnavailableError('x').code).toBe('billing_unavailable');+ expect(new BillingUnavailableError('x')).not.toBeInstanceOf(BillingExportMissingError);+ });++ it('keeps the underlying cause when one is given', () => {+ const cause = new Error('404 from BigQuery');+ expect(new BillingExportMissingError('missing', cause).cause).toBe(cause);+ });+});+describe('usd', () => {it('formats with two decimals and thousands separators', () => {expect(usd(1234.5)).toBe('$1,234.50');diff --git a/tests/ledger-anchor-broadcast-status.test.js b/tests/ledger-anchor-broadcast-status.test.jsnew file mode 100644index 000000000..8448ec7b6--- /dev/null+++ b/tests/ledger-anchor-broadcast-status.test.js@@ -0,0 +1,48 @@+// anchorLedgerHead must report a rejected broadcast as what it wrote down+// (api/_lib/ledger-anchor.js).+//+// The helper records two very different outcomes: `pending` when no attester key+// is configured (the commitment is kept locally and the on-chain timestamp is+// deferred, which is fine) and a `failed` row when the memo was actually rejected+// on-chain. It used to RETURN 'pending' for both, so an attester wallet with no+// SOL — every send answered "Attempt to debit an account but found no record of a+// prior credit" — read to its caller exactly like the benign no-key path.+//+// Pinned here: the returned status matches the persisted row, so the cron above+// it can tell a degraded mode from an outage.+import { test, expect, vi } from 'vitest';++const inserted = [];++vi.mock('../api/_lib/db.js', () => ({+ sql: (strings, ...values) => {+ const text = strings.join('?');+ if (text.includes('insert into ledger_anchors')) inserted.push(values);+ return Promise.resolve([]);+ },+}));+vi.mock('../api/_lib/attest-event.js', () => ({+ loadAttesterKeypair: () => ({+ publicKey: { toBase58: () => 'Attester1111111111111111111111111111111111' },+ }),+}));+vi.mock('../api/_lib/solana/connection.js', () => ({ solanaConnection: () => ({}) }));+vi.mock('../api/_lib/solana/confirm.js', () => ({+ sendAndConfirm: async () => {+ throw new Error('Simulation failed. Attempt to debit an account but found no record of a prior credit.');+ },+}));++const { anchorLedgerHead } = await import('../api/_lib/ledger-anchor.js');++test('a rejected broadcast returns failed and writes a failed row', async () => {+ const out = await anchorLedgerHead({+ agentId: 'agent-1', network: 'mainnet', headHash: 'hash', throughSeq: 1, entryCount: 1,+ });++ expect(out.status).toBe('failed');+ expect(out.signature).toBeNull();+ expect(out.detail).toContain('record_failed');+ expect(inserted.length).toBe(1);+ expect(inserted[0]).toContain('failed');+});diff --git a/tests/oracle/api-db-outage.test.js b/tests/oracle/api-db-outage.test.jsindex eb281ebfc..f94ca9e54 100644--- a/tests/oracle/api-db-outage.test.js+++ b/tests/oracle/api-db-outage.test.js@@ -19,7 +19,7 @@// /api/oracle/signal `count: 0` to an autonomous agent, which reads it// as a verdict and stands down// /api/oracle/social `ok: true` with `mints_updated: 0` next to a-// populated `updated` array — a receipt for a write+// populated `updated` array: a receipt for a write// that never landed// /api/oracle/stats "0 coins scored, 0 armed agents", cached 60s, on// the oracle landing herodiff --git a/tests/platform-stats-endpoint.test.js b/tests/platform-stats-endpoint.test.jsindex a39210b41..eb39d7af6 100644--- a/tests/platform-stats-endpoint.test.js+++ b/tests/platform-stats-endpoint.test.js@@ -12,6 +12,9 @@// unknown chain ids never inflate it, and Solana counts as the home chain.// 4. The in-process cache serves repeats without re-querying, and concurrent// misses collapse into a single flight.+// 5. A per-IP flood answers a JSON 429 with Retry-After and never reaches the+// database, so a scraper cannot turn the public counters into free load on+// the eight aggregate queries behind them.import { describe, it, expect, vi, beforeEach } from 'vitest';@@ -33,6 +36,21 @@ vi.mock('../api/_lib/db.js', () => ({isStoragePressured: async () => ({ pressured: false }),}));+// The real limiter is a 240/min per-IP bucket (verified live against a local+// server). Mocking it keeps the 429 branch deterministic and stops earlier+// cases in this file from draining a shared window.+let rateLimit = { success: true };+const rateLimitKeys = [];+vi.mock('../api/_lib/rate-limit.js', () => ({+ limits: {+ publicIp: async (key) => {+ rateLimitKeys.push(key);+ return rateLimit;+ },+ },+ clientIp: (req) => req?.socket?.remoteAddress ?? null,+}));+const { default: handler, _resetStatsCache, countChains } = await import('../api/platform/stats.js');const ROWS = [@@ -82,6 +100,8 @@ beforeEach(() => {sqlCalls.length = 0;sqlRoutes = ROWS;sqlFailure = null;+ rateLimit = { success: true };+ rateLimitKeys.length = 0;_resetStatsCache();});@@ -161,6 +181,25 @@ describe('GET /api/platform/stats', () => {expect(res.body).not.toMatch(/at .*\.js:/);});+ it('buckets the flood guard by client IP', async () => {+ await call();+ expect(rateLimitKeys).toEqual(['203.0.113.7']);+ });++ it('answers a flood with a JSON 429 and never touches the database', async () => {+ rateLimit = { success: false, limit: 240, remaining: 0, reset: Date.now() + 44_000 };++ const res = await call();++ expect(res.statusCode).toBe(429);+ expect(parse(res)).toMatchObject({ error: 'rate_limited' });+ expect(res.headers['retry-after']).toBeTruthy();+ expect(res.body).not.toMatch(/at .*\.js:/);+ // The eight aggregate queries are the whole cost of this endpoint; a+ // throttled caller must not pay it on the platform's behalf.+ expect(sqlCalls.length).toBe(0);+ });+it('answers a preflight with 204 and the read-only method set', async () => {const res = await call({ method: 'OPTIONS', headers: { origin: 'https://example.com' } });diff --git a/tests/plugins-marketplace-endpoint.test.js b/tests/plugins-marketplace-endpoint.test.jsindex 70535bc8f..1ab77b165 100644--- a/tests/plugins-marketplace-endpoint.test.js+++ b/tests/plugins-marketplace-endpoint.test.js@@ -177,6 +177,19 @@ describe('GET /api/plugins/list', () => {expect(lastQueryText()).toContain('p.deleted_at IS NULL');});+ it('breaks ORDER BY ties on the id so OFFSET paging cannot repeat or skip a row', async () => {+ // Every seeded plugin shares one created_at and install_count 0, so without a+ // unique final key Postgres ordered the ties differently per query: paging at+ // limit=2 returned one plugin twice and never showed another at all.+ await call({ path: '/api/plugins/list' });+ expect(lastQueryText()).toMatch(/p\.created_at DESC,\s*p\.id DESC/);+ });++ it('escapes LIKE wildcards so a search for "50%" is taken literally', async () => {+ await call({ path: '/api/plugins/list?q=50%25_x' });+ expect(sqlMock.mock.calls.at(-1)).toContain('%50\\%\\_x%');+ });+it('answers 429 when the browse bucket is spent', async () => {state.rateOk = false;const res = await call({ path: '/api/plugins/list' });@@ -326,6 +339,45 @@ describe('POST /api/plugins/publish', () => {},'at most 100 tools',],+ // api[] entries are handed straight to the model provider as tool+ // definitions by every installer, and both Anthropic and OpenAI reject a name+ // outside [A-Za-z0-9_-]{1,64}. A manifest that got past this broke chat for+ // everyone who installed it.+ [+ { identifier: 'ok', meta: { title: 'x' }, api: ['not-an-object'] },+ 'every api entry must be a JSON object',+ ],+ [+ { identifier: 'ok', meta: { title: 'x' }, api: [{ name: { a: 1 }, description: 'd' }] },+ 'needs a name, given as a string',+ ],+ [+ { identifier: 'ok', meta: { title: 'x' }, api: [{ name: 'bad name!', description: 'd' }] },+ 'letters, digits, underscores, or hyphens',+ ],+ [+ { identifier: 'ok', meta: { title: 'x' }, api: [{ name: 'ok_tool', description: ' ' }] },+ 'needs a non-empty description',+ ],+ [+ {+ identifier: 'ok',+ meta: { title: 'x' },+ api: [{ name: 'ok_tool', description: 'd'.repeat(1025) }],+ },+ '1024 characters or fewer',+ ],+ // The manifest is stored whole and re-served on every list and detail read,+ // so publish inherits the same 64KB ceiling the import fetch caps the+ // transfer at.+ [+ {+ identifier: 'ok',+ meta: { title: 'x', description: 'y'.repeat(65_600) },+ api: [{ name: 'ok_tool', description: 'd' }],+ },+ '64KB or smaller',+ ],]) {const res = await call({path: '/api/plugins/publish',@@ -412,6 +464,20 @@ describe('POST /api/plugins/import', () => {expect(sqlMock).not.toHaveBeenCalled();});+ it('names the real problem when the URL serves a web page instead of JSON', async () => {+ // Linking a repository page rather than the raw file is the common way to land+ // here, and the bare parse message ("Unexpected token '<'") did not say so.+ state.fetchImpl = async () => new Response('<!doctype html><title>repo</title>', { status: 200 });+ const res = await call({+ path: '/api/plugins/import',+ method: 'POST',+ body: { manifest_url: 'https://example.com/blob/main/manifest.json' },+ });+ expect(res.statusCode).toBe(422);+ expect(res.json().error).toBe('invalid_manifest');+ expect(res.json().error_description).toContain('did not return JSON');+ });+it('rejects fetched JSON that is not a plugin manifest', async () => {state.fetchImpl = async () => new Response('{"latest":"1.0.0"}', { status: 200 });const res = await call({diff --git a/tests/solana-sns.test.js b/tests/solana-sns.test.jsindex 59f74e376..619c83027 100644--- a/tests/solana-sns.test.js+++ b/tests/solana-sns.test.js@@ -1,4 +1,4 @@-import { describe, it, expect, vi, beforeEach } from 'vitest';+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';const resolveMock = vi.fn();const getFavoriteDomainMock = vi.fn();@@ -21,7 +21,9 @@ vi.mock('@solana/web3.js', () => {return { Connection, PublicKey };});-const { resolveSnsName, reverseLookupAddress, resolveSolanaRecipient } = await import('../src/solana/sns.js');+const { resolveSnsName, reverseLookupAddress, resolveSolanaRecipient, snsOwnerDomains } = await import(+ '../src/solana/sns.js'+);describe('resolveSnsName', () => {beforeEach(() => {@@ -146,3 +148,69 @@ describe('resolveSolanaRecipient', () => {expect(resolveMock).toHaveBeenCalledWith(expect.anything(), 'nich.threews');});});++describe('snsOwnerDomains', () => {+ const OWNER = 'HKKp49zUBeaABFMpBWKCJPoNDLiR4AEEr8FJKuZPn6Nk';++ // The Bonfida index keys both payloads by the owner address and returns bare+ // labels, so every name needs the .sol suffix put back on.+ function stubIndex({ domains, favorite, domainsStatus = 200, favoriteStatus = 200 }) {+ const fetchMock = vi.fn(async (url) => {+ const path = String(url);+ if (path.includes('/v2/user/domains/')) {+ return { ok: domainsStatus === 200, status: domainsStatus, json: async () => ({ [OWNER]: domains }) };+ }+ if (path.includes('/v2/user/fav-domains/')) {+ return { ok: favoriteStatus === 200, status: favoriteStatus, json: async () => ({ [OWNER]: favorite }) };+ }+ throw new Error(`unexpected fetch: ${path}`);+ });+ vi.stubGlobal('fetch', fetchMock);+ return fetchMock;+ }++ afterEach(() => {+ vi.unstubAllGlobals();+ });++ it('suffixes, sorts, and pairs the list with the favorite', async () => {+ stubIndex({ domains: ['zeta', 'alpha.sol'], favorite: 'alpha' });+ const out = await snsOwnerDomains(OWNER);+ expect(out.allDomains).toEqual(['alpha.sol', 'zeta.sol']);+ expect(out.favoriteDomain).toBe('alpha.sol');+ expect(out.truncated).toBe(false);+ });++ it('caps a whale wallet and reports the truncation', async () => {+ stubIndex({ domains: Array.from({ length: 250 }, (_, i) => `d${String(i).padStart(3, '0')}`), favorite: null });+ const out = await snsOwnerDomains(OWNER, { limit: 100 });+ expect(out.allDomains).toHaveLength(100);+ expect(out.truncated).toBe(true);+ expect(out.favoriteDomain).toBeNull();+ });++ it('never calls the index for a malformed address', async () => {+ const fetchMock = stubIndex({ domains: ['alpha'], favorite: 'alpha' });+ const out = await snsOwnerDomains('not-an-address');+ expect(out).toEqual({ allDomains: [], favoriteDomain: null, truncated: false });+ expect(fetchMock).not.toHaveBeenCalled();+ });++ it('degrades to an empty list when the index errors, never throws', async () => {+ stubIndex({ domains: [], favorite: null, domainsStatus: 503, favoriteStatus: 503 });+ expect(await snsOwnerDomains(OWNER)).toEqual({ allDomains: [], favoriteDomain: null, truncated: false });+ });++ it('keeps the half that answered when only one call fails', async () => {+ vi.stubGlobal(+ 'fetch',+ vi.fn(async (url) => {+ if (String(url).includes('/v2/user/domains/')) throw new Error('socket hang up');+ return { ok: true, status: 200, json: async () => ({ [OWNER]: 'alpha' }) };+ }),+ );+ const out = await snsOwnerDomains(OWNER);+ expect(out.allDomains).toEqual([]);+ expect(out.favoriteDomain).toBe('alpha.sol');+ });+});diff --git a/tests/thumbnail-url-guard.test.js b/tests/thumbnail-url-guard.test.jsindex bb6a7075f..e50be4d56 100644--- a/tests/thumbnail-url-guard.test.js+++ b/tests/thumbnail-url-guard.test.js@@ -51,7 +51,7 @@ describe('thumbnailUrl() behaviour', () => {});// Walk api/ and assert nobody reintroduces a bare publicUrl() on a thumbnail key.-// The two legitimate exceptions are called out by name.+// The three legitimate exceptions are called out by name.describe('no read path bypasses thumbnailUrl()', () => {const ALLOWED = new Set([// The helper itself.diff --git a/vercel.json b/vercel.jsonindex a0614130f..59159ddd2 100644--- a/vercel.json+++ b/vercel.json@@ -442,10 +442,6 @@"src": "/api/3d/openapi\\.json","dest": "/api/3d/openapi"},- {- "src": "/docs/3d-api/?",- "dest": "/3d.html"- },{"src": "/api/features\\.json","dest": "/api/features"@@ -1592,6 +1588,10 @@"src": "/api/agenc/list-tasks","dest": "/api/agenc/[action]?action=list-tasks"},+ {+ "src": "/api/agenc/recent-tasks",+ "dest": "/api/agenc/[action]?action=recent-tasks"+ },{"src": "/api/agenc/get-task","dest": "/api/agenc/[action]?action=get-task"