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
feat(x-search): add xAI x_search as a second rung behind the X bearer failure chain
nirholasf1fb7e192d25
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex d3002df5c..907f7f74a 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -4,16 +4,59 @@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-10-11++- **Sentiment Scout's X reads gained a second, independent path through xAI**: The Sentiment Scout reads X for posts quoting a coin's exact contract address, as evidence a holder can open and check. When our own X search credentials are unavailable or rate limited, it now fails over to xAI's x_search tool, a second route to the same posts, metered by its own daily cap so an outage on one path never silently costs more than planned on the other. No change for anyone reading the Scout: the evidence looks the same either way. (`/docs/sentiment-scout`) `[improvement, infra]`++## 2026-10-10++- **Docs · Grok Bot recipes** (`/docs/tutorials/grok-bot-recipes`): Six Grok Bot recipes run against production, not imagined: a daily 3D brief, a game-jam asset pack, an avatar from a photo, an X post's image turned into a 3D model, a weekly agent report over OAuth, and a Solana-first $THREE market brief. Every output in the doc came from a real run.++## 2026-10-09++- **Docs · Grok Bot connector reference** (`/docs/grok-bot`): Connect Grok Bot to three.ws as a custom MCP connector: exact fields for each sign-in mode, which server to pick, the links every result carries, jobs and safe retries, free limits and install tokens, why a connector key can never spend, guided prompts, and a fix for every connection failure.+- **three.ws for Grok Bot: a free 3D studio and a body for Grok** (`/grok`): Everything Grok Bot can do with three.ws on one page: generate textured 3D models, rig avatars, find ready-made CC0 assets and run your agents through one custom MCP connector. Real models made minutes ago, the exact connector settings, three recipes to schedule and the Grok skill file. Free, no account, no key.+- **AI agents can now read how to connect three.ws to their client**: The public server directory at three.ws/.well-known/mcp.json now carries setup for each AI client: Claude, ChatGPT, Grok Bot, Cursor, VS Code and Claude Code. For each one it names the server to add, whether to pick no sign-in, OAuth or an API key, and the exact values for that client's connector form or config file, plus one-click install links where the client has them. An agent asked to connect three.ws to Grok Bot can now do it from that one file, without a person reading the setup page. The site index for AI agents (three.ws/llms.txt) points to it too. (`/docs/mcp`) `[feature, docs]`+- **Avatar builds that hit a full library now say so, and the news knowledge base stops losing stories**: If your avatar library filled up while a photo or prompt avatar was still generating, the finished job used to sit unresolved and retry in the background without ever telling you why nothing appeared. It now closes with a clear message: delete an avatar or upgrade, then build it again. Separately, news stories whose text contained a half-cut emoji or a stray null character were silently dropped from the knowledge base the 3D agents ground their answers on, about 120 a day. They are now cleaned and saved. Static files such as images and environment maps also stop answering a server error when the CDN revalidates them after an update. (`/news`) `[fix]`+- **Set up Grok Bot from the terminal with npx three-ws setup**: Grok Bot keeps its connectors in xAI's cloud, so there is no config file to write, but the three-ws CLI now does every other step. Run npx three-ws setup --client grok-bot, or tick Grok Bot in the setup picker, and it prints the exact fields Grok Bot's custom MCP form asks for, copies the server URL to your clipboard, and checks the public URL live the way Grok Bot will call it. Pick how Grok Bot signs in: free with no account, free with an install token that keeps one quota across scheduled runs, a connector key it mints for you that can read and generate but never spend, or OAuth so Grok Bot signs in itself. (`/docs/cli`) `[feature, sdk]`+## 2026-10-08- **Chart Companion** (`/chart-companion`): Paste any DEXTools pair and a 3D agent watches the live chart with you, reacting to every real swap: cheering whale buys, flinching at dumps, calling streaks and new highs, each reaction linked to its transaction. Turn on its voice, bring your own three.ws agent, embed it with one iframe, or add it to OBS as a transparent stream overlay.+- **Docs · Chart Companion** (`/docs/chart-companion`): How to watch a DEXTools chart with a 3D agent that reacts to every real swap: the URL parameters, streaming it as a transparent OBS overlay, embedding it with one iframe, bringing your own agent, and exactly how whale, streak and new-high reactions are decided.+- **Docs · DEXTools integration** (`/docs/dextools`): How three.ws and DEXTools connect: the /dextools hub, the embed builder that turns any DEXTools pair link into a 3D scene or Social Boost card snippet, the framable Boost on DEXTools card, and the counted redirect and public totals behind every visit three.ws sends to a DEXTools pair page.+- **Docs · three.ws for Grok** (`/docs/grok`): Connect Grok Bot, Grok connectors and the xAI API to one free remote MCP server that turns text or an image into a textured 3D model, a rigged avatar, or a named 3D persona that lip-syncs its replies. No account, payment or API key.+- **grok-skill.md** (`/grok-skill.md`): The three.ws skill for Grok and Grok Bot: the connector that adds a free 3D studio, runnable curl calls for a Grok with no connector, the links every model comes back with, what needs an account, and the rule that it never spends. Upload it to Grok's Skills.- **three.ws x DEXTools** (`/dextools`): Every way three.ws works with DEXTools: DEXTools charts in every coin chart, any DEXTools pair rendered as a live 3D scene, a Social Boost card any project can embed, and a public count of the visits three.ws sends to DEXTools pair pages. Paste a DEXTools link to get the embed snippet.+- **3D Studio results now hand every agent plain links to the model**: Every model the free 3D Studio MCP server hands back, whether freshly generated, picked from the asset catalog or saved as a persona, now comes with four plain links, both in the result data and in its first lines of text: a viewer page, the GLB file, a rendered PNG picture and a paste-ready embed snippet. Agents that cannot show a 3D widget, like Grok Bot and other browser agents, can now open, download, share and embed the model directly. A model that is still rendering comes with a viewer link that waits for the job and opens the model the moment it is ready. (`/docs/mcp-studio`) `[feature]`+- **A paid call that fails after you were charged never asks you to pay again**: If a paid three.ws endpoint takes your payment and the work then fails, the error now says so plainly: it carries paid: true, retry_safe: true, the settlement transaction, and the sentence "You were charged; repeat this exact request with the same payment to get your result." Repeating the request with the same payment re-runs the work with no second charge, up to three times within 24 hours. Before, a download or stream that failed after payment answered with a generic error and the retry was refused as a reused payment. Errors before any charge now say paid: false, so a client always knows which case it is in. Separately, paid POST requests are now matched on their body too, so two different requests under one payment identifier can no longer receive the same cached answer. (`/docs/x402`) `[fix]`+- **A skill file that teaches Grok to use three.ws**: three.ws/grok-skill.md is one Markdown file you can upload to Grok's Skills or hand to Grok Bot. It tells Grok exactly which connector URL to add for a free 3D studio, how to sign it in to work with your agents, and, when no connector is set up, how to search the 3D catalog, generate a model and look at it with plain curl calls that run as written. It also spells out the links every model comes back with, what needs an account, and that Grok never spends money on your behalf. It is built from the same facts as three.ws/skill.md, so the two always agree. The Grok page has a button to download it. (`/grok`) `[feature, docs]`- **Agent earnings are updating again**: pump.fun moved the service that reports creator fees, so the Earned figures on agent pages, agent profiles, coin pages and /analytics had stopped refreshing since the end of September. Earnings now read from pump.fun's current fees service, with a second source behind it if that one stumbles, and every agent coin is back on its 30-minute refresh. (`/analytics`) `[fix]`+- **Agent Wallet MCP: quote an x402 service before your assistant pays it**: The Agent Wallet MCP server has a new pay_quote tool. It reads what a paid x402 endpoint charges (price, network and the address that gets paid) without spending anything. pay_and_call now works end to end once you turn it on for a connection: your assistant quotes first, shows you the price, and pays only after you say yes, using that quote. Paying a different endpoint than the one quoted, or paying with an expired quote, is refused before any USDC moves. (`/docs/mcp-agent`) `[feature, security]`+- **API keys for AI agents that can never spend**: When you make an API key you can now choose "For an AI agent (Grok Bot, schedules, CI)". That key can read, generate and edit your avatars, agents and their memory, and it can never spend: it cannot pay, send, trade, bid, launch or change where your agents get paid, and nothing done to it later can change that. If an agent holding it reaches one of those actions, it gets a clear answer with a link back to three.ws, where you approve the action yourself. The same rule now covers every route that arms an autopilot, a market maker, a launcher or a recurring charge, or moves a payout address. Keys you already have keep exactly the permissions they were made with. (`/docs/mcp`) `[feature, security]`+- **Chart Companion: a 3D agent that watches the chart with you**: Paste any DEXTools pair at /chart-companion and a 3D agent sits beside the live chart, reacting to every real swap as it lands: a superhero jump for a whale buy, a facepalm for a dump, a dance for a buy streak, applause for a new daily high. Each reaction comes with a line you can trace to its transaction, and it can read them aloud. Bring your own three.ws agent, embed it on your coin's site with one iframe, or add it to OBS as a transparent overlay for your stream. (`/chart-companion`) `[feature]`- **Chat and agents stay up through more AI outages**: Every AI answer on three.ws, from chat to agent brains, the tutor and the fact-checker, now has five more free models to fall back on when the usual ones are busy. NVIDIA's largest open model, Nemotron 3 Ultra, now answers right behind Nemotron 3 Super, with the compact Nemotron 3.5 Lightning further down the line. A second, independent route to the same Nemotron models works with no account at all, and a Gemma 4 model is back in the mix as well. The free NVIDIA and gateway models are now checked against their providers every six hours too, so the team hears the moment one is switched off instead of finding out from a failed answer. (`/chat`) `[improvement]`+- **Coin charts say plainly when a coin has no market yet**: A coin with no trading pool anywhere could show a price-history error on its chart when a market data source was busy. The chart now recognises the coin has no market and shows the no-price-history state, and it asks that source one question fewer per chart load. (`/terminal`) `[fix]`+- **Coin pages keep their Markets table when the listing sources are busy**: When both of our exchange-listing sources were rate-limited, a coin page's Markets table could show an error for coins only one of them lists. It now falls back to the coin's live DEX trading pairs, found by its contract address, with each pair's venue, chain, price, 24h volume and a link to trade it. (`/coins`) `[fix]`- **Community sentiment readings are back on coin pages and the Oracle**: pump.fun moved the feed of community callouts that our sentiment pulse reads, so every reading had been failing with an unavailable error. The pulse now reads the new feed, so launch pages, the Oracle and the sentiment_pulse MCP tool score real community commentary again, up to 100 callouts per coin. (`/oracle`) `[fix]`+- **Connect Grok Bot and other cloud agents with OAuth, and revoke them instantly**: Cloud agents such as Grok Bot can now sign in to your three.ws account over OAuth 2.1 from wherever they run, with a callback on any https address. The sign-in screen says plainly which app is asking, which site it belongs to, where it will send you back, and what it will be able to do, and it states that the app can never spend from your wallet. Spending is only granted if you tick a separate box. Settings, Connected apps lists every app with when it last called in, and Revoke now cuts an app off on its very next request instead of up to an hour later. (`/docs/mcp`) `[feature, security]`- **DEXTools is one click away on every coin, and every visit counts toward Social Boost**: DEXTools Social Boost ranks tokens by visits to their DEXTools page, and $THREE has already won three buybacks from it. Every coin on three.ws now carries a DEXTools link: it leads the trading terminal row and appears on coin and launch pages, the 3D coin view, the Oracle, agent and character pages, the live pump.fun feeds and your token dashboard. Each link opens the coin's busiest pair on DEXTools, so the visit lands on the page Social Boost actually counts. Launch pages, and the success screen right after you launch a coin, also get a Social Boost card that explains how the ranking works and sends your community there in one click. Visits are counted in daily totals per coin and per page that sent them. No visitor data is stored. (`/three-token`) `[feature]`- **Event-attested reputation now requires the platform's own signature**: The event-attested tier in a Solana agent's reputation, which ranks above community feedback in the Passport grade, was granted on a label written inside the memo, so any signer could claim it. It now counts only attestations the platform's own attester minted and recorded, so a self-written label earns ordinary feedback weight and nothing more. (`/reputation/market`) `[fix, security]`+- **Every MCP server now knows which AI client is calling**: The three.ws MCP servers now remember which AI app opened each connection, such as Claude, ChatGPT, Cursor or Grok Bot, using the name and version the app announces when it connects, and count which tools each one uses. Only those names and counts are kept, never what anyone asked for. Each connection gets a session id that MCP apps send back automatically, so nothing changes for anyone connecting. It tells us which apps people actually use three.ws from, so we know where to make the experience better next. `[infra]`+- **Fewer failed 3D generations when the concept image comes back blank**: Text to 3D first paints a concept image, then sculpts it. When the painting service quietly returned a blank black frame instead of a picture, the studio used it anyway, and every 3D engine then failed because there was nothing in the image to sculpt. The studio now spots a blank or withheld frame and paints the concept with the next image service instead, so those prompts finish as real models. (`/forge`) `[fix]`+- **Grok model menus now offer xAI's current models**: Every Grok picker on three.ws (the /brain menu, agent chat, the avatar page and the embed editor) now lists xAI's current line-up: Grok 4.7, xAI's flagship, Grok 4.3 with its 1M-token context at the lowest Grok price, Grok 4.20 Fast with no thinking pass, and Grok Build for coding. Agents and embeds that saved a Grok model xAI has since retired, such as Grok 4.1 Fast, keep working and answer on the model xAI recommends in its place. People who bring their own xAI key now get Grok 4.7 by default instead of an older flagship. (`/brain`) `[improvement]`+- **Long 3D jobs and safe retries for AI agents**: Agents that run on schedules can now generate 3D models without ever making the same model twice. Every generation tool on the free 3D Studio MCP server accepts an optional idempotency_key: retry a call that timed out with the same key and you get the first call's job back instead of a second generation, and the retry costs none of your quota. A new get_job tool reports any job's status, progress and time left, hands back the viewer, download, picture and embed links when it is done, and says what went wrong and what to do next when it fails. MCP clients that ask for progress updates now receive them live while the model renders. (`/docs/mcp-studio`) `[feature, improvement]`+- **MCP docs now show every guided workflow as the exact calls an agent makes**: The MCP guide has a new Use cases section: each of the 17 guided prompts (create an agent, set up a wallet, hire an agent, generate a 3D model and the rest) written out as the ordered tool and resource calls it drives on each server, with every step that spends money marked. A test renders every prompt against each server's live tool list and fails if the section names a tool that no longer exists or misses one a prompt now calls, so the page stays accurate as tools change. (`/docs/mcp`) `[docs]`+- **One Grok Bot connector for 3D and your agents**: https://three.ws/api/mcp-grok is now the one URL to paste into Grok Bot. With no sign-in it is the free 3D studio: text or an image to a 3D model, a rigged avatar, or a talking persona, with links Grok can share. Give the same URL a connector API key, or sign it in with OAuth at https://three.ws/api/mcp-grok?auth=oauth, and Grok also manages your agents, their memory and skills, and your avatars. It never lists a wallet, payment, card, trading, launch or delete tool, whatever the sign-in allows, so a Grok Bot task can build with your agents but can never spend. (`/docs/grok`) `[feature]`+- **Picking the free Hugging Face engine no longer leaves you stuck when its Spaces are down**: When every free Hugging Face Space is out of GPU quota, the Forge now pauses that engine for a few minutes, greys it out in the engine picker with the reason, and moves a generation you started on it to a working engine, showing you the switch, instead of retrying the same dead Spaces with a countdown. (`/forge`) `[fix]`+- **Ready-made scheduled tasks for Grok Bot and other AI agents**: The free 3D Studio and the Grok Bot connector now offer guided prompts written for an agent that runs on its own schedule. daily-3d-brief turns a topic, or the day's top trending one, into a 3D model and a poster image and hands back the links. asset-pack builds a themed set of 3D assets, using ready-made catalog items first and generating only what is missing. avatar-from-photo turns a photo into a rigged avatar with a pose studio link. agent-report, once the connector is signed in, writes a read-only status report on your agents. Every prompt names the exact calls to make and marks each generation so a retried run never makes the same model twice. (`/docs/grok`) `[feature]`+- **See which agents earned the most on the new Earned leaderboard**: The leaderboard has a second tab, Earned, that ranks every public agent by what it actually earned in the last 24 hours, 7 days, 30 days or all time. Earnings are the creator fees its coin collects from trading plus what people and other agents paid for its skills, each shown beside the total in SOL with the dollar value, along with the agent's coin and how many places it moved since the previous period. Each row matches the Earned card on that agent's own page, and the card now links straight to its spot on the board, such as "#1 this week". The tab and period live in the address bar, so a link opens the exact view you shared. Separately, the coin-launch ranking on /rankings and its daily Top 10 badge now count launches from the platform's own launch records, so builders who launched from an agent's wallet are no longer ranked with zero. (`/leaderboard`) `[feature]`+- **Shared 3D models now explain themselves to X and Grok**: Every 3D model page now tells whoever reads the link exactly what it is. A model shared from three.ws unfurls on X as a large card showing a render of the model itself instead of a stock image, with its own title and description. Model, avatar and agent pages also describe themselves in a machine-readable form that search engines and AI assistants like Grok can read: the 3D file, a picture of it, who made it, when, and the terms it is shared under. So when someone asks Grok what a three.ws link is, it can answer from the model rather than guess. (`/creations`) `[improvement]`- **The coin visualizer and communities keep loading when pump.fun throttles us**: The full coin board behind the pump.fun visualizer, the communities page and the home page's live coin now retries a rate-limited read once and falls back to the last board any server saw in the past 30 minutes, marked as slightly stale, instead of showing an error. (`/communities`) `[fix]`+- **The terminal 3D renderer animates live in every HTTP client**: curl three.ws/tty streams an animated 3D character into your terminal frame by frame. Clients that ask for compressed responses, such as curl --compressed, scripts using fetch, and most HTTP libraries, used to get nothing for about ten seconds and then the whole animation at once as a wall of text. Live streams are no longer compressed, so every client now sees the character move from the first frame. Streaming agent and chat responses get the same fix. (`/tty`) `[fix]`+- **Topping up an agent's inference credits now asks for the real-funds agreements first**: Moving USDC from an agent wallet into model credits is a real-funds action, so it now follows the same rule as withdrawals, trades and vaults. A one-off credit top-up, turning on the automatic top-up rule, and funding a new inference key from the command line all require the signed real-funds agreements (Terms of Service, Risk Disclosure and Agent Wallet Agreement). On the credits panel the signing dialog opens before the first top-up; from the CLI or an API key you get a link to sign once. Previews still work without signing, and switching the automatic top-up off never needs it. (`/legal/agreements`) `[security]`+- **Use three.ws from Grok Bot**: The connect page now has a Grok Bot tab. Grok Bot adds three.ws as a custom MCP connector, so the tab shows the exact fields to type in: the name, transport Streamable HTTP, the URL with a copy button, and whether authentication is None (the free 3D servers) or OAuth (servers that work with your account). Pick a different server above and every field follows it, and there is a ready-made sentence to send Grok Bot instead of filling in the form. Opening three.ws/connect?client=grok starts on the Grok server, which is free with no sign-in and adds your own agents when you sign in. The page also reminds you that a localhost URL never works, because Grok Bot connects from xAI's cloud. (`/connect?client=grok`) `[feature]`+- **Your own free 3D quota when you connect through Grok Bot or another cloud agent**: Cloud agents like Grok Bot reach three.ws from one shared address, so every user of that agent used to share one free 3D quota. Now you can generate a free install token on the Connect page (pick 3D Studio (free), then Generate my connector URL) or with one POST to /api/mcp-studio/install, and add the connector with that URL. Your generations then count against a quota of your own: 4 a minute and 30 an hour. No account, no key, and the token works on every free studio URL, including the Grok one. When a limit is reached, the message now says which limit, exactly when it resets, and how to lift it. (`/connect?server=three-ws-studio`) `[feature, improvement]`## 2026-10-01@@ -53,7 +96,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr## 2026-09-29-- **Connect three.ws to Claude, ChatGPT, Cursor & VS Code** (`/connect`): Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.+- **Connect three.ws to Claude, ChatGPT, Grok Bot, Cursor & VS Code** (`/connect`): Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Grok Bot, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.- **Copy Coach: your first copy trade, the careful way** (`/copy-coach`): A guided first copy trade for someone who has never copied one. See a real verified win next to the full record behind it, ghost-copy a leader with fake money, then make one tiny, server-capped copy you sign yourself. The coach answers from the real numbers on the page and never promises returns.- **Daily Trading Quests** (`/quests`): Five trading quests that reset every UTC midnight: make three trades, fork a verified trade, ghost-copy a new agent, act on a copy intent, and let your agent close a winner. Scored from on-chain proof, rewarded with XP, levels and badges.- **Docs · Copy Coach** (`/docs/copy-coach`): How the Copy Coach takes a first-timer from a real win and its full record, through a fake-money ghost copy, to one tiny server-capped copy they sign themselves: the starter caps, the confirmation card, the grounded coach answers, and the API.@@ -1561,7 +1604,7 @@ And all of it is public. Oracle Lab publishes the actual model: every weight, th## 2026-07-31-- **.well-known/mcp.json** (`/.well-known/mcp.json`): Directory of every hosted three.ws MCP server: endpoint, transport, auth, and what each one does.+- **.well-known/mcp.json** (`/.well-known/mcp.json`): Directory of every hosted three.ws MCP server (endpoint, transport, auth, what each one does) plus a clients block with setup for Claude, ChatGPT, Grok Bot, Cursor, VS Code and Claude Code: the recommended server, the auth mode and the exact connector settings or config file.- **Atlas** (`/atlas`): The whole platform as one searchable map: every page grouped by what it is for, plus the task shortcuts the Cmd+K palette answers with. Press Cmd+K anywhere on the site to search it without leaving the page.- **Choreographer** (`/choreograph`): Compose agent gestures into a timed routine on a real timeline, preview the whole performance on a live 3D avatar, then save it to your agent and play it by name from any embed.- **Crew HQ** (`/crews`): Found a crew, invite your people, and watch the whole roster stand in one 3D headquarters. Every member appears as their own agent, lit when they are live in the world.diff --git a/api/_lib/sentiment-scout.js b/api/_lib/sentiment-scout.jsindex d9973c072..8dbaf2346 100644--- a/api/_lib/sentiment-scout.js+++ b/api/_lib/sentiment-scout.js@@ -37,7 +37,7 @@ import { cacheGet, cacheSet, cacheWrap } from './cache.js';import { getBondingStatus } from './pump-bonding.js';import { fetchPumpFunCallouts } from './pump-callouts.js';import { receiptTxUrl } from './trade-receipt.js';-import { searchMintPosts, summarizePosts, xSearchConfigured } from './x-search.js';+import { searchMintPosts, summarizePosts, anyXSearchConfigured } from './x-search.js';export const EVIDENCE_TYPES = Object.freeze(['volume_spike',@@ -546,7 +546,7 @@ export function postReceipts(posts, n = MAX_POST_RECEIPTS) {// X posts quoting one mint, cached per mint. A failed read is cached briefly// as a failure, so an X outage does not turn every board refresh into a wait.async function readXPosts(mint, firstSeenAt) {- if (!xSearchConfigured()) return { unavailable: 'not_configured' };+ if (!anyXSearchConfigured()) return { unavailable: 'not_configured' };const key = `scout:x:v1:${mint}`;const hit = await cacheGet(key).catch(() => null);if (hit) return hit;diff --git a/api/_lib/x-search.js b/api/_lib/x-search.jsindex 936ded055..c043891ea 100644--- a/api/_lib/x-search.js+++ b/api/_lib/x-search.js@@ -16,8 +16,21 @@// reports what is left (x-rate-limit-remaining); once it drops under// RESERVE_REQUESTS this module stops searching until the window resets, so a// busy scout board can never exhaust the quota other X features share.+//+// Second rung: xAI's built-in x_search tool on the Responses API+// (https://api.x.ai/v1/responses). It is a second, independent path to the+// same X data, billed per call by xAI, so searchMintPosts only reaches it+// when the bearer rung above cannot answer (XSearchUnavailable of any+// reason). Grok runs the search server-side and is instructed to return the+// matching posts as strict JSON; that JSON is untrusted model output, parsed+// defensively and never treated as instructions. A daily cap+// (XAI_X_SEARCH_DAILY_CAP, counted in Postgres so it holds across instances+// and cold starts) stops the rung once reached rather than paying for every+// search an outage on rung one would otherwise trigger.-import { fetchUpstream } from './upstream-fetch.js';+import { fetchUpstream, fetchUpstreamJson } from './upstream-fetch.js';+import { sql } from './db.js';+import { GROK_BUDGET_MODEL } from './chat-models.js';const TOKEN_URL = 'https://api.twitter.com/oauth2/token';const SEARCH_URL = 'https://api.twitter.com/2/tweets/search/recent';@@ -25,6 +38,12 @@ const BREAKER = 'x:search';const TIMEOUT_MS = 6_000;const RESERVE_REQUESTS = 60;+const XAI_RESPONSES_URL = 'https://api.x.ai/v1/responses';+const XAI_BREAKER = 'x:search:xai';+const XAI_TIMEOUT_MS = 15_000;+const XAI_USAGE_KEY = 'x_search_xai_usage';+const XAI_DEFAULT_DAILY_CAP = 200;+let _token = null;let _budget = { remaining: null, resetAtMs: 0 };@@ -36,11 +55,21 @@ export class XSearchUnavailable extends Error {}}-/** True when this deployment holds credentials that can search. */+/** True when this deployment holds credentials for the bearer (rung one) search. */export function xSearchConfigured(env = process.env) {return !!(env.X_BEARER_TOKEN || (env.X_API_KEY && env.X_API_SECRET));}+/** True when this deployment holds an xAI key for the x_search rung (rung two). */+export function xaiSearchConfigured(env = process.env) {+ return !!(env.GROK_API_KEY || env.XAI_API_KEY);+}++/** True when either rung could answer a search. Gate feature-level attempts on this, not xSearchConfigured alone. */+export function anyXSearchConfigured(env = process.env) {+ return xSearchConfigured(env) || xaiSearchConfigured(env);+}+/*** Build the search query for posts quoting one contract address. Retweets are* excluded: a retweet is the same post again, and counting it would let one@@ -164,15 +193,15 @@ async function bearer(env, fetchImpl) {}/**- * Search recent posts (X keeps the last 7 days searchable) quoting a mint.- * Throws XSearchUnavailable when search cannot run (no credentials, auth- * failure, the budget reserve reached, or X down); callers list the source as- * unavailable rather than guessing.+ * Search recent posts (X keeps the last 7 days searchable) quoting a mint,+ * via the app-only bearer rung. Throws XSearchUnavailable when search cannot+ * run (no credentials, auth failure, the budget reserve reached, or X down);+ * callers list the source as unavailable rather than guessing.** @param {string} mint* @param {{ sinceIso?: string|null, maxResults?: number, env?: object, fetchImpl?: Function }} [opts]*/-export async function searchMintPosts(mint, { sinceIso = null, maxResults = 25, env = process.env, fetchImpl = fetchUpstream } = {}) {+export async function searchMintPostsBearer(mint, { sinceIso = null, maxResults = 25, env = process.env, fetchImpl = fetchUpstream } = {}) {if (!xSearchConfigured(env)) throw new XSearchUnavailable('not_configured', 'X search credentials are not configured');if (budgetExhausted()) throw new XSearchUnavailable('budget_reserve', 'X search budget reserve reached for this window');@@ -210,6 +239,205 @@ export async function searchMintPosts(mint, { sinceIso = null, maxResults = 25,throw new XSearchUnavailable('auth_failed', 'X rejected the app token');}+// ---------------------------------------------------------------------------+// Rung two: xAI's x_search tool on the Responses API.+// ---------------------------------------------------------------------------++function xaiDailyCap(env = process.env) {+ const v = parseInt(env.XAI_X_SEARCH_DAILY_CAP, 10);+ return Number.isFinite(v) && v > 0 ? v : XAI_DEFAULT_DAILY_CAP;+}++function todayUtc() {+ return new Date().toISOString().slice(0, 10);+}++async function ensureAppSettings() {+ await sql`+ CREATE TABLE IF NOT EXISTS app_settings (+ key text PRIMARY KEY,+ value jsonb NOT NULL,+ updated_at timestamptz NOT NULL DEFAULT now()+ )+ `;+}++/** How many xAI x_search calls have been made today. Exported for telemetry/ops reads. */+export async function xaiSearchUsageToday() {+ await ensureAppSettings();+ const [row] = await sql`SELECT value FROM app_settings WHERE key = ${XAI_USAGE_KEY}`;+ const v = row?.value;+ if (!v || v.day !== todayUtc()) return 0;+ return Number(v.count) || 0;+}++async function bumpXaiSearchUsage() {+ await ensureAppSettings();+ const day = todayUtc();+ const rows = await sql`+ INSERT INTO app_settings (key, value)+ VALUES (${XAI_USAGE_KEY}, jsonb_build_object('day', ${day}::text, 'count', 1))+ ON CONFLICT (key) DO UPDATE SET+ value = CASE+ WHEN app_settings.value->>'day' = ${day}::text+ THEN jsonb_build_object('day', ${day}::text, 'count', (app_settings.value->>'count')::int + 1)+ ELSE jsonb_build_object('day', ${day}::text, 'count', 1)+ END,+ updated_at = now()+ RETURNING (value->>'count')::int AS count+ `;+ return rows[0]?.count ?? 1;+}++/**+ * Build the strict-JSON instruction sent as the Responses API `input`. Grok+ * runs x_search itself; this only tells it what shape to answer in. The+ * model's answer is untrusted text, parsed defensively by+ * parseXaiSearchPayload and never treated as instructions.+ */+export function buildXaiSearchPrompt(mint, maxResults) {+ return [+ `Use the x_search tool to find up to ${maxResults} recent posts on X (Twitter) that contain the exact text "${String(mint).trim()}" and are not retweets.`,+ 'Reply with ONLY a JSON array, no prose and no markdown code fence. Each element must have exactly this shape:',+ '{"id": "<the post\'s numeric id as a string>", "url": "<the post\'s https://x.com/.../status/<id> url>", "text": "<the post\'s exact own text>", "created_at": "<ISO 8601 timestamp, or null if unknown>", "author": {"username": "<handle without the @, or null if unknown>"}}',+ 'If no matching posts exist, reply with exactly: []',+ ].join('\n');+}++/** Pull the assistant's text out of a Responses API body, across its output items. PURE. */+export function extractResponsesOutputText(payload) {+ const items = Array.isArray(payload?.output) ? payload.output : [];+ const parts = [];+ for (const item of items) {+ const content = Array.isArray(item?.content) ? item.content : [];+ for (const part of content) {+ if (typeof part?.text === 'string') parts.push(part.text);+ }+ }+ return parts.join('').trim();+}++/**+ * Normalize Grok's strict-JSON x_search answer into the same post shape+ * parseSearchPayload returns. Engagement counters and author details the+ * tool does not expose are left at null/0 rather than fabricated. PURE.+ * Throws if the model's answer is not the requested JSON array shape.+ *+ * @param {object} payload the JSON body of POST /v1/responses+ */+export function parseXaiSearchPayload(payload) {+ const text = extractResponsesOutputText(payload);+ const fenced = text.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);+ const raw = JSON.parse(fenced ? fenced[1] : text);+ if (!Array.isArray(raw)) throw new Error('xAI x_search answer was not a JSON array');++ const out = [];+ for (const p of raw) {+ if (!p || typeof p !== 'object') continue;+ const id = p.id != null ? String(p.id) : (typeof p.url === 'string' ? p.url.match(/status\/(\d+)/)?.[1] : null);+ if (!id) continue;+ const username = p.author?.username ? String(p.author.username).replace(/^@/, '') : null;+ out.push({+ id,+ url: typeof p.url === 'string' && p.url ? p.url : (username ? `https://x.com/${username}/status/${id}` : `https://x.com/i/status/${id}`),+ text: decodeXText(String(p.text ?? '')),+ created_at: typeof p.created_at === 'string' ? p.created_at : null,+ author: { id: null, username, name: null, followers: null, verified: false },+ likes: 0,+ reposts: 0,+ replies: 0,+ quotes: 0,+ impressions: null,+ });+ }+ return out;+}++/**+ * Search X for a mint through xAI's x_search tool. Second rung: only reached+ * by searchMintPosts when the bearer rung cannot answer. Throws+ * XSearchUnavailable on no credentials, the daily cap, a rate limit, or an+ * upstream/parse failure, exactly like the bearer rung, so callers never need+ * to know which rung answered.+ *+ * @param {string} mint+ * @param {{ sinceIso?: string|null, maxResults?: number, env?: object, fetchImpl?: Function }} [opts]+ */+export async function searchMintPostsViaXai(mint, { sinceIso = null, maxResults = 25, env = process.env, fetchImpl = fetchUpstreamJson } = {}) {+ if (!xaiSearchConfigured(env)) throw new XSearchUnavailable('not_configured', 'xAI X search credentials are not configured');++ let usedToday;+ try {+ usedToday = await xaiSearchUsageToday();+ } catch {+ usedToday = 0; // a DB hiccup never blocks a rung that would otherwise work+ }+ if (usedToday >= xaiDailyCap(env)) throw new XSearchUnavailable('xai_daily_cap', 'xAI X search daily cap reached');++ const key = env.GROK_API_KEY || env.XAI_API_KEY;+ const capped = Math.max(1, Math.min(25, Math.round(maxResults)));+ const toDate = new Date().toISOString().slice(0, 10);+ const tools = [{ type: 'x_search', to_date: toDate }];+ if (sinceIso) {+ const t = Date.parse(sinceIso);+ const floor = Date.now() - 7 * 24 * 3600 * 1000;+ if (Number.isFinite(t)) tools[0].from_date = new Date(Math.max(t, floor)).toISOString().slice(0, 10);+ }++ const payload = {+ model: GROK_BUDGET_MODEL,+ input: [{ role: 'user', content: buildXaiSearchPrompt(mint, capped) }],+ tools,+ };++ let body;+ try {+ body = await fetchImpl(XAI_RESPONSES_URL, {+ method: 'POST',+ headers: { authorization: `Bearer ${key}`, 'content-type': 'application/json' },+ body: JSON.stringify(payload),+ }, { name: XAI_BREAKER, timeoutMs: XAI_TIMEOUT_MS, attempts: 1 });+ } catch (err) {+ if (err?.status === 429) throw new XSearchUnavailable('rate_limited', 'xAI X search rate limit reached');+ throw new XSearchUnavailable('upstream_error', `xAI X search returned HTTP ${err?.status ?? 'error'}`);+ }++ // The search already ran and was billed by xAI even if parsing fails below,+ // so the count is what the cap is protecting and must be bumped regardless.+ // Awaited (not fire-and-forget): the cap only works if the count it reads+ // back next time reflects every call that was actually billed.+ try {+ await bumpXaiSearchUsage();+ } catch {+ // A DB hiccup must never throw away a search result that already ran.+ }++ try {+ return parseXaiSearchPayload(body);+ } catch {+ throw new XSearchUnavailable('upstream_error', 'xAI X search returned an unparseable answer');+ }+}++/**+ * Search recent posts quoting a mint, failing over from the bearer rung to+ * xAI's x_search when the bearer rung cannot answer. Throws+ * XSearchUnavailable only when neither rung can answer.+ *+ * @param {string} mint+ * @param {{ sinceIso?: string|null, maxResults?: number, env?: object, fetchImpl?: Function }} [opts]+ */+export async function searchMintPosts(mint, opts = {}) {+ try {+ return await searchMintPostsBearer(mint, opts);+ } catch (err) {+ if (!(err instanceof XSearchUnavailable)) throw err;+ const env = opts.env || process.env;+ if (!xaiSearchConfigured(env)) throw err;+ return await searchMintPostsViaXai(mint, opts);+ }+}+/** Test seam: forget the cached token and budget. */export function _resetXSearch() {_token = null;diff --git a/data/changelog.json b/data/changelog.jsonindex 413c72d30..7a897a705 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,13 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-10-11",+ "title": "Sentiment Scout's X reads gained a second, independent path through xAI",+ "summary": "The Sentiment Scout reads X for posts quoting a coin's exact contract address, as evidence a holder can open and check. When our own X search credentials are unavailable or rate limited, it now fails over to xAI's x_search tool, a second route to the same posts, metered by its own daily cap so an outage on one path never silently costs more than planned on the other. No change for anyone reading the Scout: the evidence looks the same either way.",+ "tags": ["improvement", "infra"],+ "link": "/docs/sentiment-scout"+ },{"date": "2026-10-09","title": "Avatar builds that hit a full library now say so, and the news knowledge base stops losing stories",diff --git a/docs/ops/llm-lanes.md b/docs/ops/llm-lanes.mdindex 2ca351efe..173bcb004 100644--- a/docs/ops/llm-lanes.md+++ b/docs/ops/llm-lanes.md@@ -43,7 +43,7 @@ production are routinely dead and a chain that depends on them fails:| 17 | Anthropic first-party | `ANTHROPIC_API_KEY` | paid | **absent** (no key anywhere) || 18 | OpenRouter Claude mirror | `OPENROUTER_CLAUDE_MIRROR_MODEL` | paid | off by default (see below) || 19 | OpenAI `gpt-5.4-nano` | `OPENAI_API_KEY` | paid | **dead**: 429 `billing_not_active` |-| 20 | xAI Grok `grok-4.3`, reasoning off (`GROK_BUDGET_MODEL`) | `GROK_API_KEY` (or `XAI_API_KEY`) | paid | not configured in prod: no key in `.env`, `.env.local`, the `three-ws-api` service, or Secret Manager (checked 2026-10-08). A caller's own xAI key leads the chain instead, on `grok-4.7` unless they name a model. See [Grok model ids](#grok-model-ids). |+| 20 | xAI Grok `grok-4.3`, reasoning off (`GROK_BUDGET_MODEL`) | `GROK_API_KEY` (or `XAI_API_KEY`) | paid | not configured in prod: no key in `.env`, `.env.local`, the `three-ws-api` service, or Secret Manager (checked 2026-10-11). A caller's own xAI key leads the chain instead, on `grok-4.7` unless they name a model. See [Grok model ids](#grok-model-ids). The same key, once set, also lights up a second rung of a different chain: X search for the Sentiment Scout fails over to xAI's `x_search` tool when the X bearer rung cannot answer (`searchMintPostsViaXai` in `api/_lib/x-search.js`, documented in [docs/sentiment-scout.md](../sentiment-scout.md#x-search-budget)). |The 2026-08-05 widening (SambaNova, Mistral, Z.AI, Cloudflare, LLM7,SiliconFlow) added six independent free quota pools; each is documented withdiff --git a/docs/sentiment-scout.md b/docs/sentiment-scout.mdindex d63d5fd71..311f9484f 100644--- a/docs/sentiment-scout.md+++ b/docs/sentiment-scout.md@@ -167,6 +167,22 @@ Credentials: `X_BEARER_TOKEN`, or the app key pair `X_API_KEY` / `X_API_SECRET`from which an app token is minted. Without them X posts are listed asunavailable and everything else works.+**Second rung: xAI's `x_search` tool.** When the bearer rung above cannot+answer (not configured, rate limited, or X itself down) and an xAI key+(`GROK_API_KEY` or `XAI_API_KEY`) is configured, `searchMintPosts` falls over+to a second, independent read of the same data: xAI's `x_search` tool on its+Responses API (`POST https://api.x.ai/v1/responses`). Grok runs the search+server-side and is instructed to answer with a strict JSON array of matching+posts, parsed defensively into the same post shape the bearer rung returns+(engagement counts and author detail the tool does not expose are left null+rather than invented). That answer is untrusted model output, never+instructions. Every xAI call is billed per call, so a daily cap+(`XAI_X_SEARCH_DAILY_CAP`, default 200, counted in Postgres `app_settings` so+it holds across instances) stops the rung for the rest of the day once+reached; callers then see the same `unavailable` shape as any other outage.+Code: `searchMintPostsViaXai` / `parseXaiSearchPayload` in+`api/_lib/x-search.js`.+## Related- [Trading surfaces](./trading-surfaces.md): Coin Intelligence and the launch datadiff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex 96d56ac8f..2fcc6ce23 100644--- a/public/changelog-recent.json+++ b/public/changelog-recent.json@@ -1,14 +1,87 @@{- "generated_at": "2026-10-08T04:39:10.614Z",+ "generated_at": "2026-10-11T00:07:40.296Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},- "total": 3818,+ "total": 3852,"complete": false,"full_feed": "/changelog.json","entries": [+ {+ "date": "2026-10-11",+ "type": "update",+ "title": "Sentiment Scout's X reads gained a second, independent path through xAI",+ "summary": "The Sentiment Scout reads X for posts quoting a coin's exact contract address, as evidence a holder can open and check. When our own X search credentials are unavailable or rate limited, it now fails over to xAI's x_search tool, a second route to the same posts, metered by its own daily cap so an outage on one path never silently costs more than planned on the other. No change for anyone reading the Scout: the evidence looks the same either way.",+ "link": "/docs/sentiment-scout",+ "tags": [+ "improvement",+ "infra"+ ]+ },+ {+ "date": "2026-10-10",+ "type": "launch",+ "title": "Docs · Grok Bot recipes",+ "summary": "Six Grok Bot recipes run against production, not imagined: a daily 3D brief, a game-jam asset pack, an avatar from a photo, an X post's image turned into a 3D model, a weekly agent report over OAuth, and a Solana-first $THREE market brief. Every output in the doc came from a real run.",+ "link": "/docs/tutorials/grok-bot-recipes",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-09",+ "type": "launch",+ "title": "Docs · Grok Bot connector reference",+ "summary": "Connect Grok Bot to three.ws as a custom MCP connector: exact fields for each sign-in mode, which server to pick, the links every result carries, jobs and safe retries, free limits and install tokens, why a connector key can never spend, guided prompts, and a fix for every connection failure.",+ "link": "/docs/grok-bot",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-09",+ "type": "launch",+ "title": "three.ws for Grok Bot: a free 3D studio and a body for Grok",+ "summary": "Everything Grok Bot can do with three.ws on one page: generate textured 3D models, rig avatars, find ready-made CC0 assets and run your agents through one custom MCP connector. Real models made minutes ago, the exact connector settings, three recipes to schedule and the Grok skill file. Free, no account, no key.",+ "link": "/grok",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-09",+ "type": "update",+ "title": "AI agents can now read how to connect three.ws to their client",+ "summary": "The public server directory at three.ws/.well-known/mcp.json now carries setup for each AI client: Claude, ChatGPT, Grok Bot, Cursor, VS Code and Claude Code. For each one it names the server to add, whether to pick no sign-in, OAuth or an API key, and the exact values for that client's connector form or config file, plus one-click install links where the client has them. An agent asked to connect three.ws to Grok Bot can now do it from that one file, without a person reading the setup page. The site index for AI agents (three.ws/llms.txt) points to it too.",+ "link": "/docs/mcp",+ "tags": [+ "feature",+ "docs"+ ]+ },+ {+ "date": "2026-10-09",+ "type": "update",+ "title": "Avatar builds that hit a full library now say so, and the news knowledge base stops losing stories",+ "summary": "If your avatar library filled up while a photo or prompt avatar was still generating, the finished job used to sit unresolved and retry in the background without ever telling you why nothing appeared. It now closes with a clear message: delete an avatar or upgrade, then build it again. Separately, news stories whose text contained a half-cut emoji or a stray null character were silently dropped from the knowledge base the 3D agents ground their answers on, about 120 a day. They are now cleaned and saved. Static files such as images and environment maps also stop answering a server error when the CDN revalidates them after an update.",+ "link": "/news",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-09",+ "type": "update",+ "title": "Set up Grok Bot from the terminal with npx three-ws setup",+ "summary": "Grok Bot keeps its connectors in xAI's cloud, so there is no config file to write, but the three-ws CLI now does every other step. Run npx three-ws setup --client grok-bot, or tick Grok Bot in the setup picker, and it prints the exact fields Grok Bot's custom MCP form asks for, copies the server URL to your clipboard, and checks the public URL live the way Grok Bot will call it. Pick how Grok Bot signs in: free with no account, free with an install token that keeps one quota across scheduled runs, a connector key it mints for you that can read and generate but never spend, or OAuth so Grok Bot signs in itself.",+ "link": "/docs/cli",+ "tags": [+ "feature",+ "sdk"+ ]+ },{"date": "2026-10-08","type": "launch",@@ -19,6 +92,46 @@"launch"]},+ {+ "date": "2026-10-08",+ "type": "launch",+ "title": "Docs · Chart Companion",+ "summary": "How to watch a DEXTools chart with a 3D agent that reacts to every real swap: the URL parameters, streaming it as a transparent OBS overlay, embedding it with one iframe, bringing your own agent, and exactly how whale, streak and new-high reactions are decided.",+ "link": "/docs/chart-companion",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "launch",+ "title": "Docs · DEXTools integration",+ "summary": "How three.ws and DEXTools connect: the /dextools hub, the embed builder that turns any DEXTools pair link into a 3D scene or Social Boost card snippet, the framable Boost on DEXTools card, and the counted redirect and public totals behind every visit three.ws sends to a DEXTools pair page.",+ "link": "/docs/dextools",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "launch",+ "title": "Docs · three.ws for Grok",+ "summary": "Connect Grok Bot, Grok connectors and the xAI API to one free remote MCP server that turns text or an image into a textured 3D model, a rigged avatar, or a named 3D persona that lip-syncs its replies. No account, payment or API key.",+ "link": "/docs/grok",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "launch",+ "title": "grok-skill.md",+ "summary": "The three.ws skill for Grok and Grok Bot: the connector that adds a free 3D studio, runnable curl calls for a Grok with no connector, the links every model comes back with, what needs an account, and the rule that it never spends. Upload it to Grok's Skills.",+ "link": "/grok-skill.md",+ "tags": [+ "launch"+ ]+ },{"date": "2026-10-08","type": "launch",@@ -29,6 +142,37 @@"launch"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "3D Studio results now hand every agent plain links to the model",+ "summary": "Every model the free 3D Studio MCP server hands back, whether freshly generated, picked from the asset catalog or saved as a persona, now comes with four plain links, both in the result data and in its first lines of text: a viewer page, the GLB file, a rendered PNG picture and a paste-ready embed snippet. Agents that cannot show a 3D widget, like Grok Bot and other browser agents, can now open, download, share and embed the model directly. A model that is still rendering comes with a viewer link that waits for the job and opens the model the moment it is ready.",+ "link": "/docs/mcp-studio",+ "tags": [+ "feature"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "A paid call that fails after you were charged never asks you to pay again",+ "summary": "If a paid three.ws endpoint takes your payment and the work then fails, the error now says so plainly: it carries paid: true, retry_safe: true, the settlement transaction, and the sentence \"You were charged; repeat this exact request with the same payment to get your result.\" Repeating the request with the same payment re-runs the work with no second charge, up to three times within 24 hours. Before, a download or stream that failed after payment answered with a generic error and the retry was refused as a reused payment. Errors before any charge now say paid: false, so a client always knows which case it is in. Separately, paid POST requests are now matched on their body too, so two different requests under one payment identifier can no longer receive the same cached answer.",+ "link": "/docs/x402",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "A skill file that teaches Grok to use three.ws",+ "summary": "three.ws/grok-skill.md is one Markdown file you can upload to Grok's Skills or hand to Grok Bot. It tells Grok exactly which connector URL to add for a free 3D studio, how to sign it in to work with your agents, and, when no connector is set up, how to search the 3D catalog, generate a model and look at it with plain curl calls that run as written. It also spells out the links every model comes back with, what needs an account, and that Grok never spends money on your behalf. It is built from the same facts as three.ws/skill.md, so the two always agree. The Grok page has a button to download it.",+ "link": "/grok",+ "tags": [+ "feature",+ "docs"+ ]+ },{"date": "2026-10-08","type": "update",@@ -39,6 +183,38 @@"fix"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Agent Wallet MCP: quote an x402 service before your assistant pays it",+ "summary": "The Agent Wallet MCP server has a new pay_quote tool. It reads what a paid x402 endpoint charges (price, network and the address that gets paid) without spending anything. pay_and_call now works end to end once you turn it on for a connection: your assistant quotes first, shows you the price, and pays only after you say yes, using that quote. Paying a different endpoint than the one quoted, or paying with an expired quote, is refused before any USDC moves.",+ "link": "/docs/mcp-agent",+ "tags": [+ "feature",+ "security"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "API keys for AI agents that can never spend",+ "summary": "When you make an API key you can now choose \"For an AI agent (Grok Bot, schedules, CI)\". That key can read, generate and edit your avatars, agents and their memory, and it can never spend: it cannot pay, send, trade, bid, launch or change where your agents get paid, and nothing done to it later can change that. If an agent holding it reaches one of those actions, it gets a clear answer with a link back to three.ws, where you approve the action yourself. The same rule now covers every route that arms an autopilot, a market maker, a launcher or a recurring charge, or moves a payout address. Keys you already have keep exactly the permissions they were made with.",+ "link": "/docs/mcp",+ "tags": [+ "feature",+ "security"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Chart Companion: a 3D agent that watches the chart with you",+ "summary": "Paste any DEXTools pair at /chart-companion and a 3D agent sits beside the live chart, reacting to every real swap as it lands: a superhero jump for a whale buy, a facepalm for a dump, a dance for a buy streak, applause for a new daily high. Each reaction comes with a line you can trace to its transaction, and it can read them aloud. Bring your own three.ws agent, embed it on your coin's site with one iframe, or add it to OBS as a transparent overlay for your stream.",+ "link": "/chart-companion",+ "tags": [+ "feature"+ ]+ },{"date": "2026-10-08","type": "update",@@ -49,6 +225,26 @@"improvement"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Coin charts say plainly when a coin has no market yet",+ "summary": "A coin with no trading pool anywhere could show a price-history error on its chart when a market data source was busy. The chart now recognises the coin has no market and shows the no-price-history state, and it asks that source one question fewer per chart load.",+ "link": "/terminal",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Coin pages keep their Markets table when the listing sources are busy",+ "summary": "When both of our exchange-listing sources were rate-limited, a coin page's Markets table could show an error for coins only one of them lists. It now falls back to the coin's live DEX trading pairs, found by its contract address, with each pair's venue, chain, price, 24h volume and a link to trade it.",+ "link": "/coins",+ "tags": [+ "fix"+ ]+ },{"date": "2026-10-08","type": "update",@@ -59,6 +255,17 @@"fix"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Connect Grok Bot and other cloud agents with OAuth, and revoke them instantly",+ "summary": "Cloud agents such as Grok Bot can now sign in to your three.ws account over OAuth 2.1 from wherever they run, with a callback on any https address. The sign-in screen says plainly which app is asking, which site it belongs to, where it will send you back, and what it will be able to do, and it states that the app can never spend from your wallet. Spending is only granted if you tick a separate box. Settings, Connected apps lists every app with when it last called in, and Revoke now cuts an app off on its very next request instead of up to an hour later.",+ "link": "/docs/mcp",+ "tags": [+ "feature",+ "security"+ ]+ },{"date": "2026-10-08","type": "update",@@ -80,6 +287,107 @@"security"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Every MCP server now knows which AI client is calling",+ "summary": "The three.ws MCP servers now remember which AI app opened each connection, such as Claude, ChatGPT, Cursor or Grok Bot, using the name and version the app announces when it connects, and count which tools each one uses. Only those names and counts are kept, never what anyone asked for. Each connection gets a session id that MCP apps send back automatically, so nothing changes for anyone connecting. It tells us which apps people actually use three.ws from, so we know where to make the experience better next.",+ "link": null,+ "tags": [+ "infra"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Fewer failed 3D generations when the concept image comes back blank",+ "summary": "Text to 3D first paints a concept image, then sculpts it. When the painting service quietly returned a blank black frame instead of a picture, the studio used it anyway, and every 3D engine then failed because there was nothing in the image to sculpt. The studio now spots a blank or withheld frame and paints the concept with the next image service instead, so those prompts finish as real models.",+ "link": "/forge",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Grok model menus now offer xAI's current models",+ "summary": "Every Grok picker on three.ws (the /brain menu, agent chat, the avatar page and the embed editor) now lists xAI's current line-up: Grok 4.7, xAI's flagship, Grok 4.3 with its 1M-token context at the lowest Grok price, Grok 4.20 Fast with no thinking pass, and Grok Build for coding. Agents and embeds that saved a Grok model xAI has since retired, such as Grok 4.1 Fast, keep working and answer on the model xAI recommends in its place. People who bring their own xAI key now get Grok 4.7 by default instead of an older flagship.",+ "link": "/brain",+ "tags": [+ "improvement"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Long 3D jobs and safe retries for AI agents",+ "summary": "Agents that run on schedules can now generate 3D models without ever making the same model twice. Every generation tool on the free 3D Studio MCP server accepts an optional idempotency_key: retry a call that timed out with the same key and you get the first call's job back instead of a second generation, and the retry costs none of your quota. A new get_job tool reports any job's status, progress and time left, hands back the viewer, download, picture and embed links when it is done, and says what went wrong and what to do next when it fails. MCP clients that ask for progress updates now receive them live while the model renders.",+ "link": "/docs/mcp-studio",+ "tags": [+ "feature",+ "improvement"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "MCP docs now show every guided workflow as the exact calls an agent makes",+ "summary": "The MCP guide has a new Use cases section: each of the 17 guided prompts (create an agent, set up a wallet, hire an agent, generate a 3D model and the rest) written out as the ordered tool and resource calls it drives on each server, with every step that spends money marked. A test renders every prompt against each server's live tool list and fails if the section names a tool that no longer exists or misses one a prompt now calls, so the page stays accurate as tools change.",+ "link": "/docs/mcp",+ "tags": [+ "docs"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "One Grok Bot connector for 3D and your agents",+ "summary": "https://three.ws/api/mcp-grok is now the one URL to paste into Grok Bot. With no sign-in it is the free 3D studio: text or an image to a 3D model, a rigged avatar, or a talking persona, with links Grok can share. Give the same URL a connector API key, or sign it in with OAuth at https://three.ws/api/mcp-grok?auth=oauth, and Grok also manages your agents, their memory and skills, and your avatars. It never lists a wallet, payment, card, trading, launch or delete tool, whatever the sign-in allows, so a Grok Bot task can build with your agents but can never spend.",+ "link": "/docs/grok",+ "tags": [+ "feature"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Picking the free Hugging Face engine no longer leaves you stuck when its Spaces are down",+ "summary": "When every free Hugging Face Space is out of GPU quota, the Forge now pauses that engine for a few minutes, greys it out in the engine picker with the reason, and moves a generation you started on it to a working engine, showing you the switch, instead of retrying the same dead Spaces with a countdown.",+ "link": "/forge",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Ready-made scheduled tasks for Grok Bot and other AI agents",+ "summary": "The free 3D Studio and the Grok Bot connector now offer guided prompts written for an agent that runs on its own schedule. daily-3d-brief turns a topic, or the day's top trending one, into a 3D model and a poster image and hands back the links. asset-pack builds a themed set of 3D assets, using ready-made catalog items first and generating only what is missing. avatar-from-photo turns a photo into a rigged avatar with a pose studio link. agent-report, once the connector is signed in, writes a read-only status report on your agents. Every prompt names the exact calls to make and marks each generation so a retried run never makes the same model twice.",+ "link": "/docs/grok",+ "tags": [+ "feature"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "See which agents earned the most on the new Earned leaderboard",+ "summary": "The leaderboard has a second tab, Earned, that ranks every public agent by what it actually earned in the last 24 hours, 7 days, 30 days or all time. Earnings are the creator fees its coin collects from trading plus what people and other agents paid for its skills, each shown beside the total in SOL with the dollar value, along with the agent's coin and how many places it moved since the previous period. Each row matches the Earned card on that agent's own page, and the card now links straight to its spot on the board, such as \"#1 this week\". The tab and period live in the address bar, so a link opens the exact view you shared. Separately, the coin-launch ranking on /rankings and its daily Top 10 badge now count launches from the platform's own launch records, so builders who launched from an agent's wallet are no longer ranked with zero.",+ "link": "/leaderboard",+ "tags": [+ "feature"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Shared 3D models now explain themselves to X and Grok",+ "summary": "Every 3D model page now tells whoever reads the link exactly what it is. A model shared from three.ws unfurls on X as a large card showing a render of the model itself instead of a stock image, with its own title and description. Model, avatar and agent pages also describe themselves in a machine-readable form that search engines and AI assistants like Grok can read: the 3D file, a picture of it, who made it, when, and the terms it is shared under. So when someone asks Grok what a three.ws link is, it can answer from the model rather than guess.",+ "link": "/creations",+ "tags": [+ "improvement"+ ]+ },{"date": "2026-10-08","type": "update",@@ -90,6 +398,47 @@"fix"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "The terminal 3D renderer animates live in every HTTP client",+ "summary": "curl three.ws/tty streams an animated 3D character into your terminal frame by frame. Clients that ask for compressed responses, such as curl --compressed, scripts using fetch, and most HTTP libraries, used to get nothing for about ten seconds and then the whole animation at once as a wall of text. Live streams are no longer compressed, so every client now sees the character move from the first frame. Streaming agent and chat responses get the same fix.",+ "link": "/tty",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Topping up an agent's inference credits now asks for the real-funds agreements first",+ "summary": "Moving USDC from an agent wallet into model credits is a real-funds action, so it now follows the same rule as withdrawals, trades and vaults. A one-off credit top-up, turning on the automatic top-up rule, and funding a new inference key from the command line all require the signed real-funds agreements (Terms of Service, Risk Disclosure and Agent Wallet Agreement). On the credits panel the signing dialog opens before the first top-up; from the CLI or an API key you get a link to sign once. Previews still work without signing, and switching the automatic top-up off never needs it.",+ "link": "/legal/agreements",+ "tags": [+ "security"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Use three.ws from Grok Bot",+ "summary": "The connect page now has a Grok Bot tab. Grok Bot adds three.ws as a custom MCP connector, so the tab shows the exact fields to type in: the name, transport Streamable HTTP, the URL with a copy button, and whether authentication is None (the free 3D servers) or OAuth (servers that work with your account). Pick a different server above and every field follows it, and there is a ready-made sentence to send Grok Bot instead of filling in the form. Opening three.ws/connect?client=grok starts on the Grok server, which is free with no sign-in and adds your own agents when you sign in. The page also reminds you that a localhost URL never works, because Grok Bot connects from xAI's cloud.",+ "link": "/connect?client=grok",+ "tags": [+ "feature"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Your own free 3D quota when you connect through Grok Bot or another cloud agent",+ "summary": "Cloud agents like Grok Bot reach three.ws from one shared address, so every user of that agent used to share one free 3D quota. Now you can generate a free install token on the Connect page (pick 3D Studio (free), then Generate my connector URL) or with one POST to /api/mcp-studio/install, and add the connector with that URL. Your generations then count against a quota of your own: 4 a minute and 30 an hour. No account, no key, and the token works on every free studio URL, including the Grok one. When a limit is reached, the message now says which limit, exactly when it resets, and how to lift it.",+ "link": "/connect?server=three-ws-studio",+ "tags": [+ "feature",+ "improvement"+ ]+ },{"date": "2026-10-01","type": "update",@@ -400,8 +749,8 @@{"date": "2026-09-29","type": "launch",- "title": "Connect three.ws to Claude, ChatGPT, Cursor & VS Code",- "summary": "Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.",+ "title": "Connect three.ws to Claude, ChatGPT, Grok Bot, Cursor & VS Code",+ "summary": "Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Grok Bot, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.","link": "/connect","tags": ["launch"@@ -1212,367 +1561,6 @@"fix","sdk"]- },- {- "date": "2026-09-18",- "type": "update",- "title": "The Trade Terminal finally looks the way it was designed",- "summary": "The Trade Terminal at /trades was written against a set of colors and fonts that the page itself never defined, so browsers quietly fell back to their defaults: Times New Roman text, oversized controls and missing panel colors. The page now defines its own palette, in both dark and light themes, and renders as the dense, monospaced trading terminal it was meant to be.",- "link": "/trades",- "tags": [- "fix"- ]- },- {- "date": "2026-09-17",- "type": "launch",- "title": "Agent Wallet Agreement",- "summary": "The agreement governing every agent wallet: experimental custodial software, deposits by anyone at their own risk, no insurance, no guaranteed withdrawal or recovery, and no liability for lost funds.",- "link": "/legal/agent-wallet",- "tags": [- "launch"- ]- },- {- "date": "2026-09-17",- "type": "launch",- "title": "Docs · Doc freshness, keeping docs true to the code",- "summary": "Every doc is bound to the code it names, and git decides whether that code moved after the page was last written or last reviewed. How the measurement works, what each status means, how to record that you checked a page, and where the check runs.",- "link": "/docs/doc-freshness",- "tags": [- "launch"- ]- },- {- "date": "2026-09-17",- "type": "launch",- "title": "Docs · Smart glasses, agents on your lens",- "summary": "Wear smart glasses and the world tells you an agent is standing thirty metres away. How three.ws splits the work: the lens carries the signal, the phone carries the 3D body, and the presence-gated IRL rail carries the truth.",- "link": "/docs/glasses",- "tags": [- "launch"- ]- },- {- "date": "2026-09-17",- "type": "launch",- "title": "Pending settlement: the third answer an x402 settle can give",- "summary": "Broadcasting a Solana payment and confirming it are separate events, so a settle has three outcomes, not two. What settlement_pending means for a buyer, how our facilitator guarantees one authorization never produces two transactions, and the reconciler that closes the books.",- "link": "/docs/x402-settlement-pending",- "tags": [- "launch"- ]- },- {- "date": "2026-09-17",- "type": "launch",- "title": "Real-Funds Agreements",- "summary": "Sign, and review your signatures on, the Terms of Service, Risk Disclosure, and Agent Wallet Agreement required before any real-funds action.",- "link": "/legal/agreements",- "tags": [- "launch"- ]- },- {- "date": "2026-09-17",- "type": "update",- "title": "A payment that is still confirming no longer reads as a failed payment",- "summary": "Settling an x402 payment on Solana means broadcasting a transaction and then waiting for the network to confirm it, and in between the answer is genuinely unknown. Until now an unfinished wait was reported as a failure, so a payment the chain was in the middle of accepting could tell the buyer it had failed and withhold what they paid for. Our facilitator now answers with the protocol's pending state and the settlement signature instead, a retry re-checks that same transaction rather than sending a second one, the endpoint still returns the work with the signature to watch, and a reconciler closes the books every two minutes once the chain answers. The confirmation wait also dropped from 30 seconds to 12, so paid calls come back faster.",- "link": "/docs/x402-settlement-pending",- "tags": [- "fix",- "improvement",- "infra"- ]- },- {- "date": "2026-09-17",- "type": "update",- "title": "A plan for meeting agents through smart glasses",- "summary": "three.ws already lets you pin a 3D agent at a real place and walk up to it, and /irl can already mirror the nearest-agent cue to Brilliant Labs Frame and Even Realities G1 lenses over Bluetooth. New documentation maps the whole glasses lane: how the work splits between the lens (who is near, which way, how far) and the phone (the 3D body in AR), a full build plan for Meta Ray-Ban Display glasses and the Neural Band, and an honest survey of every platform, repository and package involved, including which ones have shut down and should not be built on.",- "link": "/docs/glasses",- "tags": [- "docs",- "feature"- ]- },- {- "date": "2026-09-17",- "type": "update",- "title": "Agent wallets that cannot sign no longer look tradeable",- "summary": "A small number of agent wallets hold a balance that three.ws cannot currently sign for. Their Portfolio tab used to show a live net worth with Trade buttons, and the Trade tab showed a working form, so the first sign of trouble was a failed withdrawal. Portfolio and Trade now say up front that trading and withdrawals are paused for that wallet, hide the actions that cannot work, and link straight to support. The explanation is also clearer: the balance has not moved, it is still on chain at the same address, and you should not create a replacement wallet while access is being restored.",- "link": "/agents",- "tags": [- "fix"- ]- },- {- "date": "2026-09-17",- "type": "update",- "title": "Ask your AI assistant to show the picture inside a Solana transaction",- "summary": "Some Solana transactions carry a small image written straight into their memo, which explorers show as thousands of characters of unreadable text. A new free MCP server, @three-ws/solana-memo-media-mcp, lets Claude, Cursor or any other MCP client fetch a transaction by its signature and show you the image directly, alongside who signed it and a fingerprint of the exact bytes. It can also scan an account's recent history and pick out only the transactions that carry images. It needs no account, key or wallet, never writes anything, and only shows PNG, JPEG, WebP and GIF files whose contents match their label. The Onchain Viewer at /onchain was also fixed: it only recognised the newest memo program, so memos written through the standard Solana memo program were reported as missing. It now reads all three.",- "link": "/docs/mcp-solana-memo-media",- "tags": [- "feature",- "fix"- ]- },- {- "date": "2026-09-17",- "type": "update",- "title": "Coin pages show the numbers, not a score",- "summary": "Every coin launched on three.ws used to carry a quality score, a conviction tier and risk labels on its page, in the launch feed and on its share image. A high score can read as investment advice and a low one as FUD about someone's launch, so all of them are gone. In their place is a Token stats panel with the facts traders look up in terminals: volume, buys, sells, net buy and price change over 5 minutes, 1 hour, 6 hours and 24 hours, plus holders, the top 10 share, how much the dev holds, how much early buyers still hold, mint and freeze authority, bonding curve progress, liquidity and whether a DEX Screener profile was paid for. The Holders panel lists the ten largest wallets with links to each one, and leaves the bonding curve and pool out of the ranking. If the full holder index is unavailable, the page still shows the largest holders and says so instead of going blank.",- "link": "/launches",- "tags": [- "improvement"- ]- },- {- "date": "2026-09-17",- "type": "update",- "title": "Documentation that tells you whether to trust it",- "summary": "Every page in the docs is bound to the code it names, and git decides whether that code moved after the page was last written. That measurement now has a second clock: when someone reads a page, checks it against the source and finds it correct, that review is recorded, so careful reading counts as much as editing and nobody has to fake a change to clear a page. Docs that record a moment, like a dated audit or a finished piece of work, are marked as records and are no longer counted as drift. Every page that was out of date has been brought back in line: 110 documents were read against the exact changes that had moved under them, 82 were corrected, 22 were confirmed still accurate, and 6 were marked as records of a moment. The dashboard at /docs/freshness now shows who last checked each page and when, the report is regenerated on every deploy instead of by hand, and the check runs automatically so drift cannot pile up unnoticed again.",- "link": "/docs/freshness",- "tags": [- "docs",- "improvement"- ]- },- {- "date": "2026-09-17",- "type": "update",- "title": "Pick your chart on every coin page, and click an agent's coin to open it",- "summary": "Every coin launched on three.ws now lets you choose the chart you trust, right on its page: our own price line, live TradingView candles that tick with each trade, or the DexScreener, Birdeye, GMGN and GeckoTerminal charts, all free and all without leaving three.ws. Your choice is remembered from coin to coin. Birdeye and GMGN are also added to the chart picker on /coin pages. A brand-new coin used to show \"no price history\" for its first hours, because the chart data sources had not listed it yet; it now charts from its very first trade. If GeckoTerminal has not listed a young coin yet, its tab says so and offers a chart that already covers it, instead of an error page. And the coin shown on an agent's page, its profile and its home card is now a link straight to that coin's page, where before it could not be clicked at all.",- "link": "/launches",- "tags": [- "feature",- "fix"- ]- },- {- "date": "2026-09-17",- "type": "update",- "title": "Sign the real-funds agreements once before using real money",- "summary": "three.ws is experimental technology, and agent wallets are custodial software, not bank accounts. Before you deposit into an agent wallet, trade, send, withdraw, arm autopilot, or pay with real funds, you now sign three agreements in one step: the Terms of Service, the Risk Disclosure, and the new Agent Wallet Agreement. You tick each one, confirm you are eligible and that you understand funds can be lost for any reason with nothing insured, and type your name as your signature. An agent's deposit address now appears only after signing, and every deposit is covered by the Agent Wallet Agreement. When you are signed in, the signature is saved to your account and the servers refuse real-funds actions from unsigned accounts, including through the API, so it cannot be skipped. You can review every signature you have made at /legal/agreements. Devnet stays free of this step.",- "link": "/legal/agreements",- "tags": [- "security",- "feature"- ]- },- {- "date": "2026-09-16",- "type": "launch",- "title": "Docs · The /launch launchpad",- "summary": "How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.",- "link": "/docs/launchpad",- "tags": [- "launch"- ]- },- {- "date": "2026-09-16",- "type": "update",- "title": "A cleaner launchpad for your 3D agent's coin, with rewards you claim right here",- "summary": "three.ws/launch is rebuilt around one flow: pick one of your 3D agents, name the coin, and launch it on pump.fun from your wallet or from the agent's own wallet. The coin's metadata links your agent's page and 3D body, a live preview and cost panel show exactly what you will pay (including a 1% three.ws fee on the dev buy), and a new My coins tab shows unclaimed creator rewards and claims them in one click, no pump.fun app needed. Launches now fit in a single transaction thanks to pump.fun's lookup table, and larger ones, like USDC-paired coins with a dev buy, use Solana transaction v1 automatically when your wallet supports it. This also fixes launches that were failing because an on-chain buyback program stopped accepting new agents.",- "link": "/launch",- "tags": [- "feature",- "improvement",- "fix"- ]- },- {- "date": "2026-09-16",- "type": "update",- "title": "A flat 1% fee on trades made through three.ws",- "summary": "Trades that three.ws builds or runs for you now carry a 1% fee, paid in the same transaction as the trade: buys and sells in the coin trade window, trades from your agent's wallet, and trades your agents make through strategies, mirror trading, orders, market making and sniping. The fee is shown before you confirm, both in the trade window and in the agent wallet's trade tab. Trades you make on other apps are not affected, and three.ws's own agents are never charged.",- "link": "/legal/tos",- "tags": [- "improvement"- ]- },- {- "date": "2026-09-16",- "type": "update",- "title": "Deploy your agent on-chain with Solana's new transaction v1",- "summary": "Minting an agent to Solana now uses the new transaction v1 format whenever your wallet supports it, from the agent deploy button, the registration wizard (vanity addresses included), and /deploy-onchain. On /deploy-onchain that turns a Genesis-shape deploy from two wallet transactions into one: the asset is created and registered in the Metaplex Agent Registry atomically, so there is no half-finished deploy if something fails in between. Each deploy spells out its compute, account data, and priority fee limits instead of relying on defaults, and three.ws checks that the transaction that landed on-chain is the exact version it prepared before recording your agent. Wallets that have not added v1 yet keep working exactly as before, and a deployed agent now shows which transaction format it used.",- "link": "/deploy-onchain",- "tags": [- "feature",- "security"- ]- },- {- "date": "2026-09-16",- "type": "update",- "title": "GitHub fee claims now say what they actually prove",- "summary": "A GitHub fee claim on pump.fun proves that a GitHub account collected creator fees routed to it. It does not prove that person built the coin, owns the linked repository, or backs the project. Claim cards on /pumpfun used to read as a developer endorsing a coin even when the account was a lookalike name, the coin had no GitHub link at all, or one fee account was shared by several coins and the card simply picked the biggest one. Every claim now carries one of five labels: verified repository, verified creator wallet, identity mismatch, unverified, or unresolved pooled withdrawal. Only the two verified labels get trade buttons or count toward a coin's reputation score, mismatches are flagged in red, and the Telegram claims channel follows the same rules.",- "link": "/pumpfun",- "tags": [- "fix",- "improvement"- ]- },- {- "date": "2026-09-16",- "type": "update",- "title": "pump.fun agent skills now launch holder-reward coins",- "summary": "The pump.fun launch, swap and fee skills that agents use on three.ws now run on version 2 of the pump.fun SDK. Launching a coin can now turn on holder rewards, which sends every creator fee to the coin's holders instead of the launcher, permanently. Cashback launches were retired by pump.fun, so the skill now refuses them up front with a clear message instead of handing back a transaction that would fail after you sign it. The fee skill also recognizes holder-reward coins and explains where their fees go rather than trying to collect them.",- "link": null,- "tags": [- "improvement",- "fix"- ]- },- {- "date": "2026-09-15",- "type": "launch",- "title": "Atomic - Solana V1 Inspector",- "summary": "A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.",- "link": "/atomic",- "tags": [- "launch"- ]- },- {- "date": "2026-09-15",- "type": "launch",- "title": "Contributors",- "summary": "A living thank-you to the developers, issue reporters, and community members improving the open-source three.ws platform.",- "link": "/contributors",- "tags": [- "launch"- ]- },- {- "date": "2026-09-15",- "type": "launch",- "title": "Docs · Solana Memo Media MCP",- "summary": "Decode validated image data embedded in Solana Memo transactions and return safe inline MCP images with provenance.",- "link": "/docs/mcp-solana-memo-media",- "tags": [- "launch"- ]- },- {- "date": "2026-09-15",- "type": "launch",- "title": "Onchain Viewer",- "summary": "Open an image or text written into a public Solana Memo. Paste a transaction signature or Solscan link to preview the signed data without copying a data URI.",- "link": "/onchain",- "tags": [- "launch"- ]- },- {- "date": "2026-09-15",- "type": "update",- "title": "Show and tell now captures projects people can actually try",- "summary": "The GitHub community showcase now asks builders for the outcome, live demo, source, three.ws surface used, one useful lesson, and visual proof. That structure makes each submission easier to understand, reproduce, feature, and turn into an honest adopter story. Two compact developer front doors are also fully built and exportable: a Codespaces starter that opens on a live animated agent, and a GLB pull-request quality gate powered by the same model-diff engine as three.ws.",- "link": null,- "tags": [- "improvement",- "docs"- ]- },- {- "date": "2026-09-15",- "type": "update",- "title": "three.ws is ready for Solana's new 4 KiB transactions",- "summary": "Solana V1 transactions are live, with more than three times the wire room and a different place for execution limits. Every three.ws transaction reader now opts into V1, so a payment, registration, receipt, or agent action cannot disappear just because it uses the new format. The new Atomic inspector reads a confirmed signature or raw base64 handoff and shows the exact byte footprint, compute and account-data limits, priority fee, actual compute use, and the warning a fee sponsor needs before co-signing. It never signs or broadcasts anything.",- "link": "/atomic",- "tags": [- "feature",- "improvement",- "security"- ]- },- {- "date": "2026-09-13",- "type": "launch",- "title": "Docs · x402 for VS Code",- "summary": "Find, inspect, and pay x402 APIs from VS Code with $THREE or USDC on Solana, including wallet setup, token selection, safety controls, and the $THREE contract address.",- "link": "/docs/x402-vscode",- "tags": [- "launch"- ]- },- {- "date": "2026-09-12",- "type": "update",- "title": "Corrected what the 3D Studio connector declares about checking a pending job",- "summary": "The tool that collects a finished 3D generation was labelled a read-only status probe. It is not: the first check that finds a job done copies the model into permanent storage, records it, and scores it, and it can route failed work to another provider. Any AI client reading those labels to decide whether a call is safe to repeat was being told the wrong thing. The labels and the documentation now match the behaviour. Nothing about how the tool works changed.",- "link": "/docs/mcp-studio",- "tags": [- "fix",- "sdk"- ]- },- {- "date": "2026-09-12",- "type": "update",- "title": "The 3D viewer inside ChatGPT now loads everything through three.ws",- "summary": "The interactive viewer that shows your 3D model inside ChatGPT now fetches every model and every preview image through three.ws itself, so the only places it is allowed to reach are three.ws and the 3D viewer library it runs on. Nothing about what you see changes: the model still renders, spins and downloads the same way. There is also a dedicated connection address for the ChatGPT plugin directory, https://three.ws/api/mcp-chatgpt, carrying the eight 3D creation tools. The existing connector at https://three.ws/api/mcp-studio keeps every tool, including the living agent body.",- "link": "/docs/mcp-studio",- "tags": [- "improvement",- "security"- ]- },- {- "date": "2026-09-11",- "type": "update",- "title": "Selfie to avatar is unstuck: a scan that used to wait forever now finishes in seconds",- "summary": "Uploading a photo on the selfie page could sit on the same message indefinitely and never start the scan, with no error and nothing to retry. One copy of the face-tracking runtime held at our CDN was telling browsers to expect 11 MB and then sending a third of that, so the page waited for bytes that were never coming. That copy is gone, and three changes make the failure impossible to repeat silently: the face-tracking runtime now loads from three.ws first instead of a public CDN, any wait on it gives up after fifteen seconds and builds your avatar from the photo as it is, and a photo is never rejected for having no face in it just because the detector could not load. A new check also walks every large file on the site the way a browser asks for it and fails loudly when the bytes do not add up. Measured after the fix: a selfie became a rigged, animation-ready avatar in about fifteen seconds, and still finished in under a minute with the face-tracking runtime completely unreachable.",- "link": "/create/selfie",- "tags": [- "fix",- "infra"- ]- },- {- "date": "2026-09-11",- "type": "update",- "title": "The 3D creation skills are now a public download",- "summary": "The skills that teach an AI agent when and how to generate, rig, and embed 3D models on three.ws used to live only inside this repo. Four of them are now published at three.ws/skills/3d-studio: read one straight from the web, or download the whole set as a zip and drop it into whatever agent you are building. Nothing there needs an account, an API key, or a payment. A skill is only included if every tool it tells an agent to call is actually served, so a downloaded skill cannot send an agent after something that does not exist.",- "link": "/docs/agent-skills",- "tags": [- "feature",- "sdk"- ]- },- {- "date": "2026-09-11",- "type": "update",- "title": "Your selfie avatar now survives a storage outage instead of vanishing at the last step",- "summary": "For part of today, a selfie could finish building and then be thrown away. The 3D model was generated correctly, but the step that files it into your library could not reach our object storage, so the page said the avatar finished and could not be saved, and trying again hit the same wall. The avatar was never actually lost: a complete copy sits with the service that built it. The last step now recognises a storage outage for what it is and keeps your avatar, serving it from that copy and flagging it to be filed away properly once storage is back, so a problem on our side costs a housekeeping step instead of the model you waited for. Anything that is not a storage outage still fails loudly rather than quietly papering over a real bug. The image API for agents also now answers with a clear temporarily unavailable instead of a generic failure, so it no longer reads as a bad prompt when nothing was wrong with the prompt.",- "link": "/create/selfie",- "tags": [- "fix",- "infra"- ]- },- {- "date": "2026-09-10",- "type": "launch",- "title": "Sonar Control",- "summary": "Control a 3D agent with your hands and no camera. three.ws plays an inaudible carrier tone through your speakers and reads the Doppler shift of your hand off the microphone, so a sweep, a push or a lift moves the avatar on screen.",- "link": "/sonar",- "tags": [- "launch"- ]- },- {- "date": "2026-09-10",- "type": "update",- "title": "3D assets now load on any website, not just ours",- "summary": "Files served straight from our asset storage carried a permission list that only named a handful of sites, so a browser on any other site quietly threw the file away after downloading it. Anyone embedding a three.ws avatar or model from its direct storage link saw an empty viewer with a cross-origin error, and the workarounds were our /cdn and /api/glb routes. Storage now allows reads from everywhere while keeping uploads locked to our own pages, so direct links work in any embed. This also fixed a first-party case: the www version of the site served every page correctly but had all of its 3D blocked.",- "link": null,- "tags": [- "fix",- "infra"- ]}]}diff --git a/public/changelog.json b/public/changelog.jsonindex f875fe8f6..ac2248720 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,11 +1,84 @@{- "generated_at": "2026-10-08T04:39:10.573Z",+ "generated_at": "2026-10-11T00:07:40.265Z","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-10-11",+ "type": "update",+ "title": "Sentiment Scout's X reads gained a second, independent path through xAI",+ "summary": "The Sentiment Scout reads X for posts quoting a coin's exact contract address, as evidence a holder can open and check. When our own X search credentials are unavailable or rate limited, it now fails over to xAI's x_search tool, a second route to the same posts, metered by its own daily cap so an outage on one path never silently costs more than planned on the other. No change for anyone reading the Scout: the evidence looks the same either way.",+ "link": "/docs/sentiment-scout",+ "tags": [+ "improvement",+ "infra"+ ]+ },+ {+ "date": "2026-10-10",+ "type": "launch",+ "title": "Docs · Grok Bot recipes",+ "summary": "Six Grok Bot recipes run against production, not imagined: a daily 3D brief, a game-jam asset pack, an avatar from a photo, an X post's image turned into a 3D model, a weekly agent report over OAuth, and a Solana-first $THREE market brief. Every output in the doc came from a real run.",+ "link": "/docs/tutorials/grok-bot-recipes",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-09",+ "type": "launch",+ "title": "Docs · Grok Bot connector reference",+ "summary": "Connect Grok Bot to three.ws as a custom MCP connector: exact fields for each sign-in mode, which server to pick, the links every result carries, jobs and safe retries, free limits and install tokens, why a connector key can never spend, guided prompts, and a fix for every connection failure.",+ "link": "/docs/grok-bot",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-09",+ "type": "launch",+ "title": "three.ws for Grok Bot: a free 3D studio and a body for Grok",+ "summary": "Everything Grok Bot can do with three.ws on one page: generate textured 3D models, rig avatars, find ready-made CC0 assets and run your agents through one custom MCP connector. Real models made minutes ago, the exact connector settings, three recipes to schedule and the Grok skill file. Free, no account, no key.",+ "link": "/grok",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-09",+ "type": "update",+ "title": "AI agents can now read how to connect three.ws to their client",+ "summary": "The public server directory at three.ws/.well-known/mcp.json now carries setup for each AI client: Claude, ChatGPT, Grok Bot, Cursor, VS Code and Claude Code. For each one it names the server to add, whether to pick no sign-in, OAuth or an API key, and the exact values for that client's connector form or config file, plus one-click install links where the client has them. An agent asked to connect three.ws to Grok Bot can now do it from that one file, without a person reading the setup page. The site index for AI agents (three.ws/llms.txt) points to it too.",+ "link": "/docs/mcp",+ "tags": [+ "feature",+ "docs"+ ]+ },+ {+ "date": "2026-10-09",+ "type": "update",+ "title": "Avatar builds that hit a full library now say so, and the news knowledge base stops losing stories",+ "summary": "If your avatar library filled up while a photo or prompt avatar was still generating, the finished job used to sit unresolved and retry in the background without ever telling you why nothing appeared. It now closes with a clear message: delete an avatar or upgrade, then build it again. Separately, news stories whose text contained a half-cut emoji or a stray null character were silently dropped from the knowledge base the 3D agents ground their answers on, about 120 a day. They are now cleaned and saved. Static files such as images and environment maps also stop answering a server error when the CDN revalidates them after an update.",+ "link": "/news",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-09",+ "type": "update",+ "title": "Set up Grok Bot from the terminal with npx three-ws setup",+ "summary": "Grok Bot keeps its connectors in xAI's cloud, so there is no config file to write, but the three-ws CLI now does every other step. Run npx three-ws setup --client grok-bot, or tick Grok Bot in the setup picker, and it prints the exact fields Grok Bot's custom MCP form asks for, copies the server URL to your clipboard, and checks the public URL live the way Grok Bot will call it. Pick how Grok Bot signs in: free with no account, free with an install token that keeps one quota across scheduled runs, a connector key it mints for you that can read and generate but never spend, or OAuth so Grok Bot signs in itself.",+ "link": "/docs/cli",+ "tags": [+ "feature",+ "sdk"+ ]+ },{"date": "2026-10-08","type": "launch",@@ -16,6 +89,46 @@"launch"]},+ {+ "date": "2026-10-08",+ "type": "launch",+ "title": "Docs · Chart Companion",+ "summary": "How to watch a DEXTools chart with a 3D agent that reacts to every real swap: the URL parameters, streaming it as a transparent OBS overlay, embedding it with one iframe, bringing your own agent, and exactly how whale, streak and new-high reactions are decided.",+ "link": "/docs/chart-companion",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "launch",+ "title": "Docs · DEXTools integration",+ "summary": "How three.ws and DEXTools connect: the /dextools hub, the embed builder that turns any DEXTools pair link into a 3D scene or Social Boost card snippet, the framable Boost on DEXTools card, and the counted redirect and public totals behind every visit three.ws sends to a DEXTools pair page.",+ "link": "/docs/dextools",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "launch",+ "title": "Docs · three.ws for Grok",+ "summary": "Connect Grok Bot, Grok connectors and the xAI API to one free remote MCP server that turns text or an image into a textured 3D model, a rigged avatar, or a named 3D persona that lip-syncs its replies. No account, payment or API key.",+ "link": "/docs/grok",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "launch",+ "title": "grok-skill.md",+ "summary": "The three.ws skill for Grok and Grok Bot: the connector that adds a free 3D studio, runnable curl calls for a Grok with no connector, the links every model comes back with, what needs an account, and the rule that it never spends. Upload it to Grok's Skills.",+ "link": "/grok-skill.md",+ "tags": [+ "launch"+ ]+ },{"date": "2026-10-08","type": "launch",@@ -26,6 +139,37 @@"launch"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "3D Studio results now hand every agent plain links to the model",+ "summary": "Every model the free 3D Studio MCP server hands back, whether freshly generated, picked from the asset catalog or saved as a persona, now comes with four plain links, both in the result data and in its first lines of text: a viewer page, the GLB file, a rendered PNG picture and a paste-ready embed snippet. Agents that cannot show a 3D widget, like Grok Bot and other browser agents, can now open, download, share and embed the model directly. A model that is still rendering comes with a viewer link that waits for the job and opens the model the moment it is ready.",+ "link": "/docs/mcp-studio",+ "tags": [+ "feature"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "A paid call that fails after you were charged never asks you to pay again",+ "summary": "If a paid three.ws endpoint takes your payment and the work then fails, the error now says so plainly: it carries paid: true, retry_safe: true, the settlement transaction, and the sentence \"You were charged; repeat this exact request with the same payment to get your result.\" Repeating the request with the same payment re-runs the work with no second charge, up to three times within 24 hours. Before, a download or stream that failed after payment answered with a generic error and the retry was refused as a reused payment. Errors before any charge now say paid: false, so a client always knows which case it is in. Separately, paid POST requests are now matched on their body too, so two different requests under one payment identifier can no longer receive the same cached answer.",+ "link": "/docs/x402",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "A skill file that teaches Grok to use three.ws",+ "summary": "three.ws/grok-skill.md is one Markdown file you can upload to Grok's Skills or hand to Grok Bot. It tells Grok exactly which connector URL to add for a free 3D studio, how to sign it in to work with your agents, and, when no connector is set up, how to search the 3D catalog, generate a model and look at it with plain curl calls that run as written. It also spells out the links every model comes back with, what needs an account, and that Grok never spends money on your behalf. It is built from the same facts as three.ws/skill.md, so the two always agree. The Grok page has a button to download it.",+ "link": "/grok",+ "tags": [+ "feature",+ "docs"+ ]+ },{"date": "2026-10-08","type": "update",@@ -36,6 +180,38 @@"fix"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Agent Wallet MCP: quote an x402 service before your assistant pays it",+ "summary": "The Agent Wallet MCP server has a new pay_quote tool. It reads what a paid x402 endpoint charges (price, network and the address that gets paid) without spending anything. pay_and_call now works end to end once you turn it on for a connection: your assistant quotes first, shows you the price, and pays only after you say yes, using that quote. Paying a different endpoint than the one quoted, or paying with an expired quote, is refused before any USDC moves.",+ "link": "/docs/mcp-agent",+ "tags": [+ "feature",+ "security"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "API keys for AI agents that can never spend",+ "summary": "When you make an API key you can now choose \"For an AI agent (Grok Bot, schedules, CI)\". That key can read, generate and edit your avatars, agents and their memory, and it can never spend: it cannot pay, send, trade, bid, launch or change where your agents get paid, and nothing done to it later can change that. If an agent holding it reaches one of those actions, it gets a clear answer with a link back to three.ws, where you approve the action yourself. The same rule now covers every route that arms an autopilot, a market maker, a launcher or a recurring charge, or moves a payout address. Keys you already have keep exactly the permissions they were made with.",+ "link": "/docs/mcp",+ "tags": [+ "feature",+ "security"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Chart Companion: a 3D agent that watches the chart with you",+ "summary": "Paste any DEXTools pair at /chart-companion and a 3D agent sits beside the live chart, reacting to every real swap as it lands: a superhero jump for a whale buy, a facepalm for a dump, a dance for a buy streak, applause for a new daily high. Each reaction comes with a line you can trace to its transaction, and it can read them aloud. Bring your own three.ws agent, embed it on your coin's site with one iframe, or add it to OBS as a transparent overlay for your stream.",+ "link": "/chart-companion",+ "tags": [+ "feature"+ ]+ },{"date": "2026-10-08","type": "update",@@ -46,6 +222,26 @@"improvement"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Coin charts say plainly when a coin has no market yet",+ "summary": "A coin with no trading pool anywhere could show a price-history error on its chart when a market data source was busy. The chart now recognises the coin has no market and shows the no-price-history state, and it asks that source one question fewer per chart load.",+ "link": "/terminal",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Coin pages keep their Markets table when the listing sources are busy",+ "summary": "When both of our exchange-listing sources were rate-limited, a coin page's Markets table could show an error for coins only one of them lists. It now falls back to the coin's live DEX trading pairs, found by its contract address, with each pair's venue, chain, price, 24h volume and a link to trade it.",+ "link": "/coins",+ "tags": [+ "fix"+ ]+ },{"date": "2026-10-08","type": "update",@@ -56,6 +252,17 @@"fix"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Connect Grok Bot and other cloud agents with OAuth, and revoke them instantly",+ "summary": "Cloud agents such as Grok Bot can now sign in to your three.ws account over OAuth 2.1 from wherever they run, with a callback on any https address. The sign-in screen says plainly which app is asking, which site it belongs to, where it will send you back, and what it will be able to do, and it states that the app can never spend from your wallet. Spending is only granted if you tick a separate box. Settings, Connected apps lists every app with when it last called in, and Revoke now cuts an app off on its very next request instead of up to an hour later.",+ "link": "/docs/mcp",+ "tags": [+ "feature",+ "security"+ ]+ },{"date": "2026-10-08","type": "update",@@ -77,6 +284,107 @@"security"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Every MCP server now knows which AI client is calling",+ "summary": "The three.ws MCP servers now remember which AI app opened each connection, such as Claude, ChatGPT, Cursor or Grok Bot, using the name and version the app announces when it connects, and count which tools each one uses. Only those names and counts are kept, never what anyone asked for. Each connection gets a session id that MCP apps send back automatically, so nothing changes for anyone connecting. It tells us which apps people actually use three.ws from, so we know where to make the experience better next.",+ "link": null,+ "tags": [+ "infra"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Fewer failed 3D generations when the concept image comes back blank",+ "summary": "Text to 3D first paints a concept image, then sculpts it. When the painting service quietly returned a blank black frame instead of a picture, the studio used it anyway, and every 3D engine then failed because there was nothing in the image to sculpt. The studio now spots a blank or withheld frame and paints the concept with the next image service instead, so those prompts finish as real models.",+ "link": "/forge",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Grok model menus now offer xAI's current models",+ "summary": "Every Grok picker on three.ws (the /brain menu, agent chat, the avatar page and the embed editor) now lists xAI's current line-up: Grok 4.7, xAI's flagship, Grok 4.3 with its 1M-token context at the lowest Grok price, Grok 4.20 Fast with no thinking pass, and Grok Build for coding. Agents and embeds that saved a Grok model xAI has since retired, such as Grok 4.1 Fast, keep working and answer on the model xAI recommends in its place. People who bring their own xAI key now get Grok 4.7 by default instead of an older flagship.",+ "link": "/brain",+ "tags": [+ "improvement"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Long 3D jobs and safe retries for AI agents",+ "summary": "Agents that run on schedules can now generate 3D models without ever making the same model twice. Every generation tool on the free 3D Studio MCP server accepts an optional idempotency_key: retry a call that timed out with the same key and you get the first call's job back instead of a second generation, and the retry costs none of your quota. A new get_job tool reports any job's status, progress and time left, hands back the viewer, download, picture and embed links when it is done, and says what went wrong and what to do next when it fails. MCP clients that ask for progress updates now receive them live while the model renders.",+ "link": "/docs/mcp-studio",+ "tags": [+ "feature",+ "improvement"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "MCP docs now show every guided workflow as the exact calls an agent makes",+ "summary": "The MCP guide has a new Use cases section: each of the 17 guided prompts (create an agent, set up a wallet, hire an agent, generate a 3D model and the rest) written out as the ordered tool and resource calls it drives on each server, with every step that spends money marked. A test renders every prompt against each server's live tool list and fails if the section names a tool that no longer exists or misses one a prompt now calls, so the page stays accurate as tools change.",+ "link": "/docs/mcp",+ "tags": [+ "docs"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "One Grok Bot connector for 3D and your agents",+ "summary": "https://three.ws/api/mcp-grok is now the one URL to paste into Grok Bot. With no sign-in it is the free 3D studio: text or an image to a 3D model, a rigged avatar, or a talking persona, with links Grok can share. Give the same URL a connector API key, or sign it in with OAuth at https://three.ws/api/mcp-grok?auth=oauth, and Grok also manages your agents, their memory and skills, and your avatars. It never lists a wallet, payment, card, trading, launch or delete tool, whatever the sign-in allows, so a Grok Bot task can build with your agents but can never spend.",+ "link": "/docs/grok",+ "tags": [+ "feature"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Picking the free Hugging Face engine no longer leaves you stuck when its Spaces are down",+ "summary": "When every free Hugging Face Space is out of GPU quota, the Forge now pauses that engine for a few minutes, greys it out in the engine picker with the reason, and moves a generation you started on it to a working engine, showing you the switch, instead of retrying the same dead Spaces with a countdown.",+ "link": "/forge",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Ready-made scheduled tasks for Grok Bot and other AI agents",+ "summary": "The free 3D Studio and the Grok Bot connector now offer guided prompts written for an agent that runs on its own schedule. daily-3d-brief turns a topic, or the day's top trending one, into a 3D model and a poster image and hands back the links. asset-pack builds a themed set of 3D assets, using ready-made catalog items first and generating only what is missing. avatar-from-photo turns a photo into a rigged avatar with a pose studio link. agent-report, once the connector is signed in, writes a read-only status report on your agents. Every prompt names the exact calls to make and marks each generation so a retried run never makes the same model twice.",+ "link": "/docs/grok",+ "tags": [+ "feature"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "See which agents earned the most on the new Earned leaderboard",+ "summary": "The leaderboard has a second tab, Earned, that ranks every public agent by what it actually earned in the last 24 hours, 7 days, 30 days or all time. Earnings are the creator fees its coin collects from trading plus what people and other agents paid for its skills, each shown beside the total in SOL with the dollar value, along with the agent's coin and how many places it moved since the previous period. Each row matches the Earned card on that agent's own page, and the card now links straight to its spot on the board, such as \"#1 this week\". The tab and period live in the address bar, so a link opens the exact view you shared. Separately, the coin-launch ranking on /rankings and its daily Top 10 badge now count launches from the platform's own launch records, so builders who launched from an agent's wallet are no longer ranked with zero.",+ "link": "/leaderboard",+ "tags": [+ "feature"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Shared 3D models now explain themselves to X and Grok",+ "summary": "Every 3D model page now tells whoever reads the link exactly what it is. A model shared from three.ws unfurls on X as a large card showing a render of the model itself instead of a stock image, with its own title and description. Model, avatar and agent pages also describe themselves in a machine-readable form that search engines and AI assistants like Grok can read: the 3D file, a picture of it, who made it, when, and the terms it is shared under. So when someone asks Grok what a three.ws link is, it can answer from the model rather than guess.",+ "link": "/creations",+ "tags": [+ "improvement"+ ]+ },{"date": "2026-10-08","type": "update",@@ -87,6 +395,47 @@"fix"]},+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "The terminal 3D renderer animates live in every HTTP client",+ "summary": "curl three.ws/tty streams an animated 3D character into your terminal frame by frame. Clients that ask for compressed responses, such as curl --compressed, scripts using fetch, and most HTTP libraries, used to get nothing for about ten seconds and then the whole animation at once as a wall of text. Live streams are no longer compressed, so every client now sees the character move from the first frame. Streaming agent and chat responses get the same fix.",+ "link": "/tty",+ "tags": [+ "fix"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Topping up an agent's inference credits now asks for the real-funds agreements first",+ "summary": "Moving USDC from an agent wallet into model credits is a real-funds action, so it now follows the same rule as withdrawals, trades and vaults. A one-off credit top-up, turning on the automatic top-up rule, and funding a new inference key from the command line all require the signed real-funds agreements (Terms of Service, Risk Disclosure and Agent Wallet Agreement). On the credits panel the signing dialog opens before the first top-up; from the CLI or an API key you get a link to sign once. Previews still work without signing, and switching the automatic top-up off never needs it.",+ "link": "/legal/agreements",+ "tags": [+ "security"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Use three.ws from Grok Bot",+ "summary": "The connect page now has a Grok Bot tab. Grok Bot adds three.ws as a custom MCP connector, so the tab shows the exact fields to type in: the name, transport Streamable HTTP, the URL with a copy button, and whether authentication is None (the free 3D servers) or OAuth (servers that work with your account). Pick a different server above and every field follows it, and there is a ready-made sentence to send Grok Bot instead of filling in the form. Opening three.ws/connect?client=grok starts on the Grok server, which is free with no sign-in and adds your own agents when you sign in. The page also reminds you that a localhost URL never works, because Grok Bot connects from xAI's cloud.",+ "link": "/connect?client=grok",+ "tags": [+ "feature"+ ]+ },+ {+ "date": "2026-10-08",+ "type": "update",+ "title": "Your own free 3D quota when you connect through Grok Bot or another cloud agent",+ "summary": "Cloud agents like Grok Bot reach three.ws from one shared address, so every user of that agent used to share one free 3D quota. Now you can generate a free install token on the Connect page (pick 3D Studio (free), then Generate my connector URL) or with one POST to /api/mcp-studio/install, and add the connector with that URL. Your generations then count against a quota of your own: 4 a minute and 30 an hour. No account, no key, and the token works on every free studio URL, including the Grok one. When a limit is reached, the message now says which limit, exactly when it resets, and how to lift it.",+ "link": "/connect?server=three-ws-studio",+ "tags": [+ "feature",+ "improvement"+ ]+ },{"date": "2026-10-01","type": "update",@@ -397,8 +746,8 @@{"date": "2026-09-29","type": "launch",- "title": "Connect three.ws to Claude, ChatGPT, Cursor & VS Code",- "summary": "Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.",+ "title": "Connect three.ws to Claude, ChatGPT, Grok Bot, Cursor & VS Code",+ "summary": "Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Grok Bot, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.","link": "/connect","tags": ["launch"@@ -14839,7 +15188,7 @@"date": "2026-07-31","type": "launch","title": ".well-known/mcp.json",- "summary": "Directory of every hosted three.ws MCP server: endpoint, transport, auth, and what each one does.",+ "summary": "Directory of every hosted three.ws MCP server (endpoint, transport, auth, what each one does) plus a clients block with setup for Claude, ChatGPT, Grok Bot, Cursor, VS Code and Claude Code: the recommended server, the auth mode and the exact connector settings or config file.","link": "/.well-known/mcp.json","tags": ["launch"diff --git a/public/changelog.xml b/public/changelog.xmlindex e13280fab..70093410f 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -6,6 +6,62 @@<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>Sentiment Scout's X reads gained a second, independent path through xAI</title>+ <link>https://three.ws/docs/sentiment-scout</link>+ <guid isPermaLink="false">2026-10-11:Sentiment Scout's X reads gained a second, independent path through xAI</guid>+ <pubDate>Sun, 11 Oct 2026 12:00:00 GMT</pubDate>+ <category>improvement</category>+ <description>The Sentiment Scout reads X for posts quoting a coin's exact contract address, as evidence a holder can open and check. When our own X search credentials are unavailable or rate limited, it now fails over to xAI's x_search tool, a second route to the same posts, metered by its own daily cap so an outage on one path never silently costs more than planned on the other. No change for anyone reading the Scout: the evidence looks the same either way.</description>+ </item>+ <item>+ <title>Docs · Grok Bot recipes</title>+ <link>https://three.ws/docs/tutorials/grok-bot-recipes</link>+ <guid isPermaLink="false">2026-10-10:Docs · Grok Bot recipes</guid>+ <pubDate>Sat, 10 Oct 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>Six Grok Bot recipes run against production, not imagined: a daily 3D brief, a game-jam asset pack, an avatar from a photo, an X post's image turned into a 3D model, a weekly agent report over OAuth, and a Solana-first $THREE market brief. Every output in the doc came from a real run.</description>+ </item>+ <item>+ <title>Docs · Grok Bot connector reference</title>+ <link>https://three.ws/docs/grok-bot</link>+ <guid isPermaLink="false">2026-10-09:Docs · Grok Bot connector reference</guid>+ <pubDate>Fri, 09 Oct 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>Connect Grok Bot to three.ws as a custom MCP connector: exact fields for each sign-in mode, which server to pick, the links every result carries, jobs and safe retries, free limits and install tokens, why a connector key can never spend, guided prompts, and a fix for every connection failure.</description>+ </item>+ <item>+ <title>three.ws for Grok Bot: a free 3D studio and a body for Grok</title>+ <link>https://three.ws/grok</link>+ <guid isPermaLink="false">2026-10-09:three.ws for Grok Bot: a free 3D studio and a body for Grok</guid>+ <pubDate>Fri, 09 Oct 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>Everything Grok Bot can do with three.ws on one page: generate textured 3D models, rig avatars, find ready-made CC0 assets and run your agents through one custom MCP connector. Real models made minutes ago, the exact connector settings, three recipes to schedule and the Grok skill file. Free, no account, no key.</description>+ </item>+ <item>+ <title>AI agents can now read how to connect three.ws to their client</title>+ <link>https://three.ws/docs/mcp</link>+ <guid isPermaLink="false">2026-10-09:AI agents can now read how to connect three.ws to their client</guid>+ <pubDate>Fri, 09 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>The public server directory at three.ws/.well-known/mcp.json now carries setup for each AI client: Claude, ChatGPT, Grok Bot, Cursor, VS Code and Claude Code. For each one it names the server to add, whether to pick no sign-in, OAuth or an API key, and the exact values for that client's connector form or config file, plus one-click install links where the client has them. An agent asked to connect three.ws to Grok Bot can now do it from that one file, without a person reading the setup page. The site index for AI agents (three.ws/llms.txt) points to it too.</description>+ </item>+ <item>+ <title>Avatar builds that hit a full library now say so, and the news knowledge base stops losing stories</title>+ <link>https://three.ws/news</link>+ <guid isPermaLink="false">2026-10-09:Avatar builds that hit a full library now say so, and the news knowledge base stops losing stories</guid>+ <pubDate>Fri, 09 Oct 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>If your avatar library filled up while a photo or prompt avatar was still generating, the finished job used to sit unresolved and retry in the background without ever telling you why nothing appeared. It now closes with a clear message: delete an avatar or upgrade, then build it again. Separately, news stories whose text contained a half-cut emoji or a stray null character were silently dropped from the knowledge base the 3D agents ground their answers on, about 120 a day. They are now cleaned and saved. Static files such as images and environment maps also stop answering a server error when the CDN revalidates them after an update.</description>+ </item>+ <item>+ <title>Set up Grok Bot from the terminal with npx three-ws setup</title>+ <link>https://three.ws/docs/cli</link>+ <guid isPermaLink="false">2026-10-09:Set up Grok Bot from the terminal with npx three-ws setup</guid>+ <pubDate>Fri, 09 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>Grok Bot keeps its connectors in xAI's cloud, so there is no config file to write, but the three-ws CLI now does every other step. Run npx three-ws setup --client grok-bot, or tick Grok Bot in the setup picker, and it prints the exact fields Grok Bot's custom MCP form asks for, copies the server URL to your clipboard, and checks the public URL live the way Grok Bot will call it. Pick how Grok Bot signs in: free with no account, free with an install token that keeps one quota across scheduled runs, a connector key it mints for you that can read and generate but never spend, or OAuth so Grok Bot signs in itself.</description>+ </item><item><title>Chart Companion</title><link>https://three.ws/chart-companion</link>@@ -14,6 +70,38 @@<category>launch</category><description>Paste any DEXTools pair and a 3D agent watches the live chart with you, reacting to every real swap: cheering whale buys, flinching at dumps, calling streaks and new highs, each reaction linked to its transaction. Turn on its voice, bring your own three.ws agent, embed it with one iframe, or add it to OBS as a transparent stream overlay.</description></item>+ <item>+ <title>Docs · Chart Companion</title>+ <link>https://three.ws/docs/chart-companion</link>+ <guid isPermaLink="false">2026-10-08:Docs · Chart Companion</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>How to watch a DEXTools chart with a 3D agent that reacts to every real swap: the URL parameters, streaming it as a transparent OBS overlay, embedding it with one iframe, bringing your own agent, and exactly how whale, streak and new-high reactions are decided.</description>+ </item>+ <item>+ <title>Docs · DEXTools integration</title>+ <link>https://three.ws/docs/dextools</link>+ <guid isPermaLink="false">2026-10-08:Docs · DEXTools integration</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>How three.ws and DEXTools connect: the /dextools hub, the embed builder that turns any DEXTools pair link into a 3D scene or Social Boost card snippet, the framable Boost on DEXTools card, and the counted redirect and public totals behind every visit three.ws sends to a DEXTools pair page.</description>+ </item>+ <item>+ <title>Docs · three.ws for Grok</title>+ <link>https://three.ws/docs/grok</link>+ <guid isPermaLink="false">2026-10-08:Docs · three.ws for Grok</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>Connect Grok Bot, Grok connectors and the xAI API to one free remote MCP server that turns text or an image into a textured 3D model, a rigged avatar, or a named 3D persona that lip-syncs its replies. No account, payment or API key.</description>+ </item>+ <item>+ <title>grok-skill.md</title>+ <link>https://three.ws/grok-skill.md</link>+ <guid isPermaLink="false">2026-10-08:grok-skill.md</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>The three.ws skill for Grok and Grok Bot: the connector that adds a free 3D studio, runnable curl calls for a Grok with no connector, the links every model comes back with, what needs an account, and the rule that it never spends. Upload it to Grok's Skills.</description>+ </item><item><title>three.ws x DEXTools</title><link>https://three.ws/dextools</link>@@ -22,6 +110,30 @@<category>launch</category><description>Every way three.ws works with DEXTools: DEXTools charts in every coin chart, any DEXTools pair rendered as a live 3D scene, a Social Boost card any project can embed, and a public count of the visits three.ws sends to DEXTools pair pages. Paste a DEXTools link to get the embed snippet.</description></item>+ <item>+ <title>3D Studio results now hand every agent plain links to the model</title>+ <link>https://three.ws/docs/mcp-studio</link>+ <guid isPermaLink="false">2026-10-08:3D Studio results now hand every agent plain links to the model</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>Every model the free 3D Studio MCP server hands back, whether freshly generated, picked from the asset catalog or saved as a persona, now comes with four plain links, both in the result data and in its first lines of text: a viewer page, the GLB file, a rendered PNG picture and a paste-ready embed snippet. Agents that cannot show a 3D widget, like Grok Bot and other browser agents, can now open, download, share and embed the model directly. A model that is still rendering comes with a viewer link that waits for the job and opens the model the moment it is ready.</description>+ </item>+ <item>+ <title>A paid call that fails after you were charged never asks you to pay again</title>+ <link>https://three.ws/docs/x402</link>+ <guid isPermaLink="false">2026-10-08:A paid call that fails after you were charged never asks you to pay again</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>If a paid three.ws endpoint takes your payment and the work then fails, the error now says so plainly: it carries paid: true, retry_safe: true, the settlement transaction, and the sentence "You were charged; repeat this exact request with the same payment to get your result." Repeating the request with the same payment re-runs the work with no second charge, up to three times within 24 hours. Before, a download or stream that failed after payment answered with a generic error and the retry was refused as a reused payment. Errors before any charge now say paid: false, so a client always knows which case it is in. Separately, paid POST requests are now matched on their body too, so two different requests under one payment identifier can no longer receive the same cached answer.</description>+ </item>+ <item>+ <title>A skill file that teaches Grok to use three.ws</title>+ <link>https://three.ws/grok</link>+ <guid isPermaLink="false">2026-10-08:A skill file that teaches Grok to use three.ws</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>three.ws/grok-skill.md is one Markdown file you can upload to Grok's Skills or hand to Grok Bot. It tells Grok exactly which connector URL to add for a free 3D studio, how to sign it in to work with your agents, and, when no connector is set up, how to search the 3D catalog, generate a model and look at it with plain curl calls that run as written. It also spells out the links every model comes back with, what needs an account, and that Grok never spends money on your behalf. It is built from the same facts as three.ws/skill.md, so the two always agree. The Grok page has a button to download it.</description>+ </item><item><title>Agent earnings are updating again</title><link>https://three.ws/analytics</link>@@ -30,6 +142,30 @@<category>fix</category><description>pump.fun moved the service that reports creator fees, so the Earned figures on agent pages, agent profiles, coin pages and /analytics had stopped refreshing since the end of September. Earnings now read from pump.fun's current fees service, with a second source behind it if that one stumbles, and every agent coin is back on its 30-minute refresh.</description></item>+ <item>+ <title>Agent Wallet MCP: quote an x402 service before your assistant pays it</title>+ <link>https://three.ws/docs/mcp-agent</link>+ <guid isPermaLink="false">2026-10-08:Agent Wallet MCP: quote an x402 service before your assistant pays it</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>The Agent Wallet MCP server has a new pay_quote tool. It reads what a paid x402 endpoint charges (price, network and the address that gets paid) without spending anything. pay_and_call now works end to end once you turn it on for a connection: your assistant quotes first, shows you the price, and pays only after you say yes, using that quote. Paying a different endpoint than the one quoted, or paying with an expired quote, is refused before any USDC moves.</description>+ </item>+ <item>+ <title>API keys for AI agents that can never spend</title>+ <link>https://three.ws/docs/mcp</link>+ <guid isPermaLink="false">2026-10-08:API keys for AI agents that can never spend</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>When you make an API key you can now choose "For an AI agent (Grok Bot, schedules, CI)". That key can read, generate and edit your avatars, agents and their memory, and it can never spend: it cannot pay, send, trade, bid, launch or change where your agents get paid, and nothing done to it later can change that. If an agent holding it reaches one of those actions, it gets a clear answer with a link back to three.ws, where you approve the action yourself. The same rule now covers every route that arms an autopilot, a market maker, a launcher or a recurring charge, or moves a payout address. Keys you already have keep exactly the permissions they were made with.</description>+ </item>+ <item>+ <title>Chart Companion: a 3D agent that watches the chart with you</title>+ <link>https://three.ws/chart-companion</link>+ <guid isPermaLink="false">2026-10-08:Chart Companion: a 3D agent that watches the chart with you</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>Paste any DEXTools pair at /chart-companion and a 3D agent sits beside the live chart, reacting to every real swap as it lands: a superhero jump for a whale buy, a facepalm for a dump, a dance for a buy streak, applause for a new daily high. Each reaction comes with a line you can trace to its transaction, and it can read them aloud. Bring your own three.ws agent, embed it on your coin's site with one iframe, or add it to OBS as a transparent overlay for your stream.</description>+ </item><item><title>Chat and agents stay up through more AI outages</title><link>https://three.ws/chat</link>@@ -38,6 +174,22 @@<category>improvement</category><description>Every AI answer on three.ws, from chat to agent brains, the tutor and the fact-checker, now has five more free models to fall back on when the usual ones are busy. NVIDIA's largest open model, Nemotron 3 Ultra, now answers right behind Nemotron 3 Super, with the compact Nemotron 3.5 Lightning further down the line. A second, independent route to the same Nemotron models works with no account at all, and a Gemma 4 model is back in the mix as well. The free NVIDIA and gateway models are now checked against their providers every six hours too, so the team hears the moment one is switched off instead of finding out from a failed answer.</description></item>+ <item>+ <title>Coin charts say plainly when a coin has no market yet</title>+ <link>https://three.ws/terminal</link>+ <guid isPermaLink="false">2026-10-08:Coin charts say plainly when a coin has no market yet</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>A coin with no trading pool anywhere could show a price-history error on its chart when a market data source was busy. The chart now recognises the coin has no market and shows the no-price-history state, and it asks that source one question fewer per chart load.</description>+ </item>+ <item>+ <title>Coin pages keep their Markets table when the listing sources are busy</title>+ <link>https://three.ws/coins</link>+ <guid isPermaLink="false">2026-10-08:Coin pages keep their Markets table when the listing sources are busy</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>When both of our exchange-listing sources were rate-limited, a coin page's Markets table could show an error for coins only one of them lists. It now falls back to the coin's live DEX trading pairs, found by its contract address, with each pair's venue, chain, price, 24h volume and a link to trade it.</description>+ </item><item><title>Community sentiment readings are back on coin pages and the Oracle</title><link>https://three.ws/oracle</link>@@ -46,6 +198,14 @@<category>fix</category><description>pump.fun moved the feed of community callouts that our sentiment pulse reads, so every reading had been failing with an unavailable error. The pulse now reads the new feed, so launch pages, the Oracle and the sentiment_pulse MCP tool score real community commentary again, up to 100 callouts per coin.</description></item>+ <item>+ <title>Connect Grok Bot and other cloud agents with OAuth, and revoke them instantly</title>+ <link>https://three.ws/docs/mcp</link>+ <guid isPermaLink="false">2026-10-08:Connect Grok Bot and other cloud agents with OAuth, and revoke them instantly</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>Cloud agents such as Grok Bot can now sign in to your three.ws account over OAuth 2.1 from wherever they run, with a callback on any https address. The sign-in screen says plainly which app is asking, which site it belongs to, where it will send you back, and what it will be able to do, and it states that the app can never spend from your wallet. Spending is only granted if you tick a separate box. Settings, Connected apps lists every app with when it last called in, and Revoke now cuts an app off on its very next request instead of up to an hour later.</description>+ </item><item><title>DEXTools is one click away on every coin, and every visit counts toward Social Boost</title><link>https://three.ws/three-token</link>@@ -62,6 +222,86 @@<category>fix</category><description>The event-attested tier in a Solana agent's reputation, which ranks above community feedback in the Passport grade, was granted on a label written inside the memo, so any signer could claim it. It now counts only attestations the platform's own attester minted and recorded, so a self-written label earns ordinary feedback weight and nothing more.</description></item>+ <item>+ <title>Every MCP server now knows which AI client is calling</title>+ <link>https://three.ws/changelog</link>+ <guid isPermaLink="false">2026-10-08:Every MCP server now knows which AI client is calling</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>infra</category>+ <description>The three.ws MCP servers now remember which AI app opened each connection, such as Claude, ChatGPT, Cursor or Grok Bot, using the name and version the app announces when it connects, and count which tools each one uses. Only those names and counts are kept, never what anyone asked for. Each connection gets a session id that MCP apps send back automatically, so nothing changes for anyone connecting. It tells us which apps people actually use three.ws from, so we know where to make the experience better next.</description>+ </item>+ <item>+ <title>Fewer failed 3D generations when the concept image comes back blank</title>+ <link>https://three.ws/forge</link>+ <guid isPermaLink="false">2026-10-08:Fewer failed 3D generations when the concept image comes back blank</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>Text to 3D first paints a concept image, then sculpts it. When the painting service quietly returned a blank black frame instead of a picture, the studio used it anyway, and every 3D engine then failed because there was nothing in the image to sculpt. The studio now spots a blank or withheld frame and paints the concept with the next image service instead, so those prompts finish as real models.</description>+ </item>+ <item>+ <title>Grok model menus now offer xAI's current models</title>+ <link>https://three.ws/brain</link>+ <guid isPermaLink="false">2026-10-08:Grok model menus now offer xAI's current models</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>improvement</category>+ <description>Every Grok picker on three.ws (the /brain menu, agent chat, the avatar page and the embed editor) now lists xAI's current line-up: Grok 4.7, xAI's flagship, Grok 4.3 with its 1M-token context at the lowest Grok price, Grok 4.20 Fast with no thinking pass, and Grok Build for coding. Agents and embeds that saved a Grok model xAI has since retired, such as Grok 4.1 Fast, keep working and answer on the model xAI recommends in its place. People who bring their own xAI key now get Grok 4.7 by default instead of an older flagship.</description>+ </item>+ <item>+ <title>Long 3D jobs and safe retries for AI agents</title>+ <link>https://three.ws/docs/mcp-studio</link>+ <guid isPermaLink="false">2026-10-08:Long 3D jobs and safe retries for AI agents</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>Agents that run on schedules can now generate 3D models without ever making the same model twice. Every generation tool on the free 3D Studio MCP server accepts an optional idempotency_key: retry a call that timed out with the same key and you get the first call's job back instead of a second generation, and the retry costs none of your quota. A new get_job tool reports any job's status, progress and time left, hands back the viewer, download, picture and embed links when it is done, and says what went wrong and what to do next when it fails. MCP clients that ask for progress updates now receive them live while the model renders.</description>+ </item>+ <item>+ <title>MCP docs now show every guided workflow as the exact calls an agent makes</title>+ <link>https://three.ws/docs/mcp</link>+ <guid isPermaLink="false">2026-10-08:MCP docs now show every guided workflow as the exact calls an agent makes</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>docs</category>+ <description>The MCP guide has a new Use cases section: each of the 17 guided prompts (create an agent, set up a wallet, hire an agent, generate a 3D model and the rest) written out as the ordered tool and resource calls it drives on each server, with every step that spends money marked. A test renders every prompt against each server's live tool list and fails if the section names a tool that no longer exists or misses one a prompt now calls, so the page stays accurate as tools change.</description>+ </item>+ <item>+ <title>One Grok Bot connector for 3D and your agents</title>+ <link>https://three.ws/docs/grok</link>+ <guid isPermaLink="false">2026-10-08:One Grok Bot connector for 3D and your agents</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>https://three.ws/api/mcp-grok is now the one URL to paste into Grok Bot. With no sign-in it is the free 3D studio: text or an image to a 3D model, a rigged avatar, or a talking persona, with links Grok can share. Give the same URL a connector API key, or sign it in with OAuth at https://three.ws/api/mcp-grok?auth=oauth, and Grok also manages your agents, their memory and skills, and your avatars. It never lists a wallet, payment, card, trading, launch or delete tool, whatever the sign-in allows, so a Grok Bot task can build with your agents but can never spend.</description>+ </item>+ <item>+ <title>Picking the free Hugging Face engine no longer leaves you stuck when its Spaces are down</title>+ <link>https://three.ws/forge</link>+ <guid isPermaLink="false">2026-10-08:Picking the free Hugging Face engine no longer leaves you stuck when its Spaces are down</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>When every free Hugging Face Space is out of GPU quota, the Forge now pauses that engine for a few minutes, greys it out in the engine picker with the reason, and moves a generation you started on it to a working engine, showing you the switch, instead of retrying the same dead Spaces with a countdown.</description>+ </item>+ <item>+ <title>Ready-made scheduled tasks for Grok Bot and other AI agents</title>+ <link>https://three.ws/docs/grok</link>+ <guid isPermaLink="false">2026-10-08:Ready-made scheduled tasks for Grok Bot and other AI agents</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>The free 3D Studio and the Grok Bot connector now offer guided prompts written for an agent that runs on its own schedule. daily-3d-brief turns a topic, or the day's top trending one, into a 3D model and a poster image and hands back the links. asset-pack builds a themed set of 3D assets, using ready-made catalog items first and generating only what is missing. avatar-from-photo turns a photo into a rigged avatar with a pose studio link. agent-report, once the connector is signed in, writes a read-only status report on your agents. Every prompt names the exact calls to make and marks each generation so a retried run never makes the same model twice.</description>+ </item>+ <item>+ <title>See which agents earned the most on the new Earned leaderboard</title>+ <link>https://three.ws/leaderboard</link>+ <guid isPermaLink="false">2026-10-08:See which agents earned the most on the new Earned leaderboard</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>The leaderboard has a second tab, Earned, that ranks every public agent by what it actually earned in the last 24 hours, 7 days, 30 days or all time. Earnings are the creator fees its coin collects from trading plus what people and other agents paid for its skills, each shown beside the total in SOL with the dollar value, along with the agent's coin and how many places it moved since the previous period. Each row matches the Earned card on that agent's own page, and the card now links straight to its spot on the board, such as "#1 this week". The tab and period live in the address bar, so a link opens the exact view you shared. Separately, the coin-launch ranking on /rankings and its daily Top 10 badge now count launches from the platform's own launch records, so builders who launched from an agent's wallet are no longer ranked with zero.</description>+ </item>+ <item>+ <title>Shared 3D models now explain themselves to X and Grok</title>+ <link>https://three.ws/creations</link>+ <guid isPermaLink="false">2026-10-08:Shared 3D models now explain themselves to X and Grok</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>improvement</category>+ <description>Every 3D model page now tells whoever reads the link exactly what it is. A model shared from three.ws unfurls on X as a large card showing a render of the model itself instead of a stock image, with its own title and description. Model, avatar and agent pages also describe themselves in a machine-readable form that search engines and AI assistants like Grok can read: the 3D file, a picture of it, who made it, when, and the terms it is shared under. So when someone asks Grok what a three.ws link is, it can answer from the model rather than guess.</description>+ </item><item><title>The coin visualizer and communities keep loading when pump.fun throttles us</title><link>https://three.ws/communities</link>@@ -70,6 +310,38 @@<category>fix</category><description>The full coin board behind the pump.fun visualizer, the communities page and the home page's live coin now retries a rate-limited read once and falls back to the last board any server saw in the past 30 minutes, marked as slightly stale, instead of showing an error.</description></item>+ <item>+ <title>The terminal 3D renderer animates live in every HTTP client</title>+ <link>https://three.ws/tty</link>+ <guid isPermaLink="false">2026-10-08:The terminal 3D renderer animates live in every HTTP client</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>curl three.ws/tty streams an animated 3D character into your terminal frame by frame. Clients that ask for compressed responses, such as curl --compressed, scripts using fetch, and most HTTP libraries, used to get nothing for about ten seconds and then the whole animation at once as a wall of text. Live streams are no longer compressed, so every client now sees the character move from the first frame. Streaming agent and chat responses get the same fix.</description>+ </item>+ <item>+ <title>Topping up an agent's inference credits now asks for the real-funds agreements first</title>+ <link>https://three.ws/legal/agreements</link>+ <guid isPermaLink="false">2026-10-08:Topping up an agent's inference credits now asks for the real-funds agreements first</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>security</category>+ <description>Moving USDC from an agent wallet into model credits is a real-funds action, so it now follows the same rule as withdrawals, trades and vaults. A one-off credit top-up, turning on the automatic top-up rule, and funding a new inference key from the command line all require the signed real-funds agreements (Terms of Service, Risk Disclosure and Agent Wallet Agreement). On the credits panel the signing dialog opens before the first top-up; from the CLI or an API key you get a link to sign once. Previews still work without signing, and switching the automatic top-up off never needs it.</description>+ </item>+ <item>+ <title>Use three.ws from Grok Bot</title>+ <link>https://three.ws/connect?client=grok</link>+ <guid isPermaLink="false">2026-10-08:Use three.ws from Grok Bot</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>The connect page now has a Grok Bot tab. Grok Bot adds three.ws as a custom MCP connector, so the tab shows the exact fields to type in: the name, transport Streamable HTTP, the URL with a copy button, and whether authentication is None (the free 3D servers) or OAuth (servers that work with your account). Pick a different server above and every field follows it, and there is a ready-made sentence to send Grok Bot instead of filling in the form. Opening three.ws/connect?client=grok starts on the Grok server, which is free with no sign-in and adds your own agents when you sign in. The page also reminds you that a localhost URL never works, because Grok Bot connects from xAI's cloud.</description>+ </item>+ <item>+ <title>Your own free 3D quota when you connect through Grok Bot or another cloud agent</title>+ <link>https://three.ws/connect?server=three-ws-studio</link>+ <guid isPermaLink="false">2026-10-08:Your own free 3D quota when you connect through Grok Bot or another cloud agent</guid>+ <pubDate>Thu, 08 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>Cloud agents like Grok Bot reach three.ws from one shared address, so every user of that agent used to share one free 3D quota. Now you can generate a free install token on the Connect page (pick 3D Studio (free), then Generate my connector URL) or with one POST to /api/mcp-studio/install, and add the connector with that URL. Your generations then count against a quota of your own: 4 a minute and 30 an hour. No account, no key, and the token works on every free studio URL, including the Grok one. When a limit is reached, the message now says which limit, exactly when it resets, and how to lift it.</description>+ </item><item><title>Avatar pictures show a natural standing pose instead of a T-pose</title><link>https://three.ws/spotlight</link>@@ -311,12 +583,12 @@<description>A new Duels page pairs traders who sit next to each other on the board and asks one question: who books more realized profit over tomorrow, or over next week? Make your call before the window starts with free points from your daily allowance, then watch the race live on the duel page with both traders' records, trade rooms and profiles one tap away. Results come straight from the on-chain trade ledger, the same numbers their profiles show, and ties or empty windows refund every call. A correct call doubles your stake and adds XP to your quest level, and there is a monthly season board and four badges to earn. Points have no cash value and cannot be bought, sold, transferred or redeemed.</description></item><item>- <title>Connect three.ws to Claude, ChatGPT, Cursor & VS Code</title>+ <title>Connect three.ws to Claude, ChatGPT, Grok Bot, Cursor & VS Code</title><link>https://three.ws/connect</link>- <guid isPermaLink="false">2026-09-29:Connect three.ws to Claude, ChatGPT, Cursor & VS Code</guid>+ <guid isPermaLink="false">2026-09-29:Connect three.ws to Claude, ChatGPT, Grok Bot, Cursor & VS Code</guid><pubDate>Tue, 29 Sep 2026 12:00:00 GMT</pubDate><category>launch</category>- <description>Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.</description>+ <description>Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Grok Bot, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.</description></item><item><title>Copy Coach: your first copy trade, the careful way</title>@@ -11148,7 +11420,7 @@ And all of it is public. Oracle Lab publishes the actual model: every weight, th<guid isPermaLink="false">2026-07-31:.well-known/mcp.json</guid><pubDate>Fri, 31 Jul 2026 12:00:00 GMT</pubDate><category>launch</category>- <description>Directory of every hosted three.ws MCP server: endpoint, transport, auth, and what each one does.</description>+ <description>Directory of every hosted three.ws MCP server (endpoint, transport, auth, what each one does) plus a clients block with setup for Claude, ChatGPT, Grok Bot, Cursor, VS Code and Claude Code: the recommended server, the auth mode and the exact connector settings or config file.</description></item><item><title>Atlas</title>diff --git a/public/features.json b/public/features.jsonindex af0b832e6..fa7ee3418 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-08T04:39:10.556Z",+ "generated_at": "2026-10-11T00:07:40.247Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -3979,6 +3979,26 @@"tags": [],"showcase": false},+ {+ "path": "/docs/dextools",+ "title": "Docs · DEXTools integration",+ "description": "How three.ws and DEXTools connect: the /dextools hub, the embed builder that turns any DEXTools pair link into a 3D scene or Social Boost card snippet, the framable Boost on DEXTools card, and the counted redirect and public totals behind every visit three.ws sends to a DEXTools pair page.",+ "added": "2026-10-08",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false+ },+ {+ "path": "/docs/chart-companion",+ "title": "Docs · Chart Companion",+ "description": "How to watch a DEXTools chart with a 3D agent that reacts to every real swap: the URL parameters, streaming it as a transparent OBS overlay, embedding it with one iframe, bringing your own agent, and exactly how whale, streak and new-high reactions are decided.",+ "added": "2026-10-08",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false+ },{"path": "/docs/coin3d-embed","title": "Docs · Token in 3D, as an embed",@@ -5020,40 +5040,40 @@"showcase": false},{- "path": "/docs/mcp-solana-memo-media",- "title": "Docs · Solana Memo Media MCP",- "description": "Decode validated image data embedded in Solana Memo transactions and return safe inline MCP images with provenance.",- "added": "2026-09-15",+ "path": "/docs/grok",+ "title": "Docs · three.ws for Grok",+ "description": "Connect Grok Bot, Grok connectors and the xAI API to one free remote MCP server that turns text or an image into a textured 3D model, a rigged avatar, or a named 3D persona that lip-syncs its replies. No account, payment or API key.",+ "added": "2026-10-08","auth": null,"indexable": true,"tags": [],"showcase": false},{- "path": "/docs/vscode",- "title": "Docs · three.ws in VS Code",- "description": "The VS Code extension that renders .glb and .gltf files in an editor tab, reports on them, generates and rigs new models on the free lane, and writes a pinned <agent-3d> embed.",- "added": "2026-09-05",+ "path": "/docs/grok-bot",+ "title": "Docs · Grok Bot connector reference",+ "description": "Connect Grok Bot to three.ws as a custom MCP connector: exact fields for each sign-in mode, which server to pick, the links every result carries, jobs and safe retries, free limits and install tokens, why a connector key can never spend, guided prompts, and a fix for every connection failure.",+ "added": "2026-10-09","auth": null,"indexable": true,"tags": [],"showcase": false},{- "path": "/docs/grok",- "title": "Docs · three.ws for Grok",- "description": "Connect Grok Bot, Grok connectors and the xAI API to one free remote MCP server that turns text or an image into a textured 3D model, a rigged avatar, or a named 3D persona that lip-syncs its replies. No account, payment or API key.",- "added": "2026-10-08",+ "path": "/docs/mcp-solana-memo-media",+ "title": "Docs · Solana Memo Media MCP",+ "description": "Decode validated image data embedded in Solana Memo transactions and return safe inline MCP images with provenance.",+ "added": "2026-09-15","auth": null,"indexable": true,"tags": [],"showcase": false},{- "path": "/docs/grok-bot",- "title": "Docs · Grok Bot connector reference",- "description": "Connect Grok Bot to three.ws as a custom MCP connector: exact fields for each sign-in mode, which server to pick, the links every result carries, jobs and safe retries, free limits and install tokens, why a connector key can never spend, guided prompts, and a fix for every connection failure.",- "added": "2026-10-09",+ "path": "/docs/vscode",+ "title": "Docs · three.ws in VS Code",+ "description": "The VS Code extension that renders .glb and .gltf files in an editor tab, reports on them, generates and rigs new models on the free lane, and writes a pinned <agent-3d> embed.",+ "added": "2026-09-05","auth": null,"indexable": true,"tags": [],@@ -7389,6 +7409,16 @@"tags": [],"showcase": false},+ {+ "path": "/grok",+ "title": "three.ws for Grok Bot: a free 3D studio and a body for Grok",+ "description": "Everything Grok Bot can do with three.ws on one page: generate textured 3D models, rig avatars, find ready-made CC0 assets and run your agents through one custom MCP connector. Real models made minutes ago, the exact connector settings, three recipes to schedule and the Grok skill file. Free, no account, no key.",+ "added": "2026-10-09",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false+ },{"path": "/mcp-tools","title": "MCP Tool Catalog",@@ -7409,16 +7439,6 @@"tags": [],"showcase": false},- {- "path": "/grok",- "title": "three.ws for Grok Bot: a free 3D studio and a body for Grok",- "description": "Everything Grok Bot can do with three.ws on one page: generate textured 3D models, rig avatars, find ready-made CC0 assets and run your agents through one custom MCP connector. Real models made minutes ago, the exact connector settings, three recipes to schedule and the Grok skill file. Free, no account, no key.",- "added": "2026-10-09",- "auth": null,- "indexable": true,- "tags": [],- "showcase": false- },{"path": "/docs/experiments","title": "Docs · How we run and publish experiments",@@ -7899,6 +7919,16 @@"tags": [],"showcase": false},+ {+ "path": "/docs/tutorials/grok-bot-recipes",+ "title": "Docs · Grok Bot recipes",+ "description": "Six Grok Bot recipes run against production, not imagined: a daily 3D brief, a game-jam asset pack, an avatar from a photo, an X post's image turned into a 3D model, a weekly agent report over OAuth, and a Solana-first $THREE market brief. Every output in the doc came from a real run.",+ "added": "2026-10-10",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false+ },{"path": "/docs/tutorials/write-a-guard","title": "Docs · Write a repository guard",@@ -8730,6 +8760,16 @@"tags": [],"showcase": false},+ {+ "path": "/grok-skill.md",+ "title": "grok-skill.md",+ "description": "The three.ws skill for Grok and Grok Bot: the connector that adds a free 3D studio, runnable curl calls for a Grok with no connector, the links every model comes back with, what needs an account, and the rule that it never spends. Upload it to Grok's Skills.",+ "added": "2026-10-08",+ "auth": null,+ "indexable": false,+ "tags": [],+ "showcase": false+ },{"path": "/robots.txt","title": "robots.txt",@@ -8750,16 +8790,6 @@"tags": [],"showcase": false},- {- "path": "/grok-skill.md",- "title": "grok-skill.md",- "description": "The three.ws skill for Grok and Grok Bot: the connector that adds a free 3D studio, runnable curl calls for a Grok with no connector, the links every model comes back with, what needs an account, and the rule that it never spends. Upload it to Grok's Skills.",- "added": "2026-10-08",- "auth": null,- "indexable": false,- "tags": [],- "showcase": false- },{"path": "/.well-known/x402","title": ".well-known/x402",diff --git a/public/llms-full.txt b/public/llms-full.txtindex 07a74af69..b7443038e 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -2393,6 +2393,18 @@ URL: https://three.ws/docs/swarmsHow 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 · DEXTools integration++URL: https://three.ws/docs/dextools++How three.ws and DEXTools connect: the /dextools hub, the embed builder that turns any DEXTools pair link into a 3D scene or Social Boost card snippet, the framable Boost on DEXTools card, and the counted redirect and public totals behind every visit three.ws sends to a DEXTools pair page.++### Docs · Chart Companion++URL: https://three.ws/docs/chart-companion++How to watch a DEXTools chart with a 3D agent that reacts to every real swap: the URL parameters, streaming it as a transparent OBS overlay, embedding it with one iframe, bringing your own agent, and exactly how whale, streak and new-high reactions are decided.+### Docs · Token in 3D, as an embedURL: https://three.ws/docs/coin3d-embed@@ -3017,18 +3029,6 @@ URL: https://three.ws/docs/mcpExpose your agent as an MCP server for Claude, ChatGPT, and other clients.-### Docs · Solana Memo Media MCP--URL: https://three.ws/docs/mcp-solana-memo-media--Decode validated image data embedded in Solana Memo transactions and return safe inline MCP images with provenance.--### Docs · three.ws in VS Code--URL: https://three.ws/docs/vscode--The VS Code extension that renders .glb and .gltf files in an editor tab, reports on them, generates and rigs new models on the free lane, and writes a pinned <agent-3d> embed.-### Docs · three.ws for GrokURL: https://three.ws/docs/grok@@ -3041,6 +3041,18 @@ URL: https://three.ws/docs/grok-botConnect Grok Bot to three.ws as a custom MCP connector: exact fields for each sign-in mode, which server to pick, the links every result carries, jobs and safe retries, free limits and install tokens, why a connector key can never spend, guided prompts, and a fix for every connection failure.+### Docs · Solana Memo Media MCP++URL: https://three.ws/docs/mcp-solana-memo-media++Decode validated image data embedded in Solana Memo transactions and return safe inline MCP images with provenance.++### Docs · three.ws in VS Code++URL: https://three.ws/docs/vscode++The VS Code extension that renders .glb and .gltf files in an editor tab, reports on them, generates and rigs new models on the free lane, and writes a pinned <agent-3d> embed.+### Docs · The prompt libraryURL: https://three.ws/docs/prompts@@ -4745,6 +4757,12 @@ URL: https://three.ws/brownoutEvery response from this API says where its data came from and how fresh it is, and every declared fallback has been proven by breaking the upstream it protects against, inside the real request path. Read the receipts: which provider refused, which one caught the request, and how old the answer was.+### Docs · Grok Bot recipes++URL: https://three.ws/docs/tutorials/grok-bot-recipes++Six Grok Bot recipes run against production, not imagined: a daily 3D brief, a game-jam asset pack, an avatar from a photo, an X post's image turned into a 3D model, a weekly agent report over OAuth, and a Solana-first $THREE market brief. Every output in the doc came from a real run.+### Docs · Write a repository guardURL: https://three.ws/docs/tutorials/write-a-guard@@ -5248,6 +5266,13 @@ Indexable: no (excluded from sitemap)The three.ws Agent Skill: how an AI agent connects to three.ws, the rules it follows around money and official addresses, and an index of the focused skills for 3D generation, avatars and agents. Load it like any SKILL.md.+### grok-skill.md++URL: https://three.ws/grok-skill.md+Indexable: no (excluded from sitemap)++The three.ws skill for Grok and Grok Bot: the connector that adds a free 3D studio, runnable curl calls for a Grok with no connector, the links every model comes back with, what needs an account, and the rule that it never spends. Upload it to Grok's Skills.+### robots.txtURL: https://three.ws/robots.txt@@ -5260,13 +5285,6 @@ Crawler directives.URL: https://three.ws/openapi.jsonIndexable: no (excluded from sitemap)-### grok-skill.md--URL: https://three.ws/grok-skill.md-Indexable: no (excluded from sitemap)--The three.ws skill for Grok and Grok Bot: the connector that adds a free 3D studio, runnable curl calls for a Grok with no connector, the links every model comes back with, what needs an account, and the rule that it never spends. Upload it to Grok's Skills.-Machine-readable HTTP API spec.### .well-known/x402diff --git a/public/llms.txt b/public/llms.txtindex dbdad12f3..52ff1f3a6 100644--- a/public/llms.txt+++ b/public/llms.txt@@ -98,6 +98,6 @@ Machine-readable entry points. Fetch these instead of scraping HTML.## Optional-- [llms-full.txt](https://three.ws/llms-full.txt): Every public page (930), grouped by section, with full descriptions.+- [llms-full.txt](https://three.ws/llms-full.txt): Every public page (931), grouped by section, with full descriptions.- [Sitemap](https://three.ws/sitemap): The same index for people, with search.- [sitemap.xml](https://three.ws/sitemap.xml): XML sitemap for crawlers, including every agent and avatar page.diff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex 2746a21c2..420822555 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -3,16 +3,16 @@<head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" />-<title data-i18n="sitemap_index.meta_title">Sitemap · three.ws</title>-<meta name="description" content="Human-readable index of every page on three.ws." data-i18n-attr="content:sitemap_index.meta_description"/>+<title>Sitemap · three.ws</title>+<meta name="description" content="Human-readable index of every page on three.ws." /><meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1" /><link rel="canonical" href="https://three.ws/sitemap" /><meta property="og:type" content="website" /><meta property="og:site_name" content="three.ws" /><meta property="og:locale" content="en_US" /><meta property="og:url" content="https://three.ws/sitemap" />-<meta property="og:title" content="Sitemap · three.ws" data-i18n-attr="content:sitemap_index.meta_og_title"/>-<meta property="og:description" content="Human-readable index of every page on three.ws." data-i18n-attr="content:sitemap_index.meta_og_description"/>+<meta property="og:title" content="Sitemap · three.ws" />+<meta property="og:description" content="Human-readable index of every page on three.ws." /><meta property="og:image" content="https://three.ws/api/page-og?s=main&t=Sitemap&d=Human-readable+index+of+every+page+on+three.ws.&p=%2Fsitemap" /><meta property="og:image:width" content="1200" /><meta property="og:image:height" content="630" />@@ -20,8 +20,8 @@<meta property="og:image:alt" content="Sitemap - three.ws" /><meta name="twitter:card" content="summary_large_image" /><meta name="twitter:site" content="@trythreews" />-<meta name="twitter:title" content="Sitemap · three.ws" data-i18n-attr="content:sitemap_index.meta_twitter_title"/>-<meta name="twitter:description" content="Human-readable index of every page on three.ws." data-i18n-attr="content:sitemap_index.meta_twitter_description"/>+<meta name="twitter:title" content="Sitemap · three.ws" />+<meta name="twitter:description" content="Human-readable index of every page on three.ws." /><meta name="twitter:image" content="https://three.ws/api/page-og?s=main&t=Sitemap&d=Human-readable+index+of+every+page+on+three.ws.&p=%2Fsitemap" /><script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"WebPage","name":"Sitemap","description":"Human-readable index of every page on three.ws.","url":"https://three.ws/sitemap","isPartOf":{"@type":"WebSite","name":"three.ws","url":"https://three.ws"},"primaryImageOfPage":"https://three.ws/api/page-og?s=main&t=Sitemap&d=Human-readable+index+of+every+page+on+three.ws.&p=%2Fsitemap"}]}</script><link rel="alternate" type="application/xml" title="XML sitemap" href="/sitemap.xml" />@@ -95,27 +95,51 @@<header><div id="nav-container"></div></header><main class="sm-wrap"><div class="sm-hero">- <h1 data-i18n="sitemap_index.sitemap">Sitemap</h1>- <p><span>975</span> <span data-i18n="sitemap_index.pages_grouped">pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</span></p>+ <h1>Sitemap</h1>+ <p><span>982</span> <span data-i18n="sitemap_index.pages_grouped">pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</span></p><div class="sm-formats">- <a href="/sitemap.xml" data-i18n-html="sitemap_index.for_search_engines"><code>sitemap.xml</code> · for search engines</a>- <a href="/llms.txt" data-i18n-html="sitemap_index.for_ai_agents"><code>llms.txt</code> · for AI agents</a>- <a href="/llms-full.txt" data-i18n-html="sitemap_index.long_form"><code>llms-full.txt</code> · long form</a>- <a href="/api/features.json" data-i18n-html="sitemap_index.machine_manifest"><code>features.json</code> · machine manifest</a>- <a href="/changelog" data-i18n-html="sitemap_index.what_s_new"><code>changelog</code> · what's new</a>- <a href="/openapi.json" data-i18n-html="sitemap_index.http_api"><code>openapi.json</code> · HTTP API</a>+ <a href="/sitemap.xml"><code>sitemap.xml</code> · for search engines</a>+ <a href="/llms.txt"><code>llms.txt</code> · for AI agents</a>+ <a href="/llms-full.txt"><code>llms-full.txt</code> · long form</a>+ <a href="/api/features.json"><code>features.json</code> · machine manifest</a>+ <a href="/changelog"><code>changelog</code> · what's new</a>+ <a href="/openapi.json"><code>openapi.json</code> · HTTP API</a></div></div><div class="sm-filter"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m21 21-4.3-4.3"/></svg>- <input id="sm-filter-input" type="search" placeholder="Filter 975 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />+ <input id="sm-filter-input" type="search" placeholder="Filter 982 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" /><kbd id="sm-filter-kbd" aria-hidden="true">/</kbd></div><p class="sm-filter-count" role="status" aria-live="polite"><span id="sm-filter-count"></span><span id="sm-filter-hint" aria-hidden="true"></span></p><section class="sm-new" id="sm-new" aria-labelledby="sm-new-title">- <h2 id="sm-new-title" data-i18n-html="sitemap_index.newestfull_changelog">Newest<a class="sm-new-more" href="/changelog">full changelog →</a></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.the_9_most_recently_launched_pages_straight">The 9 most recently launched pages, straight to the live surface.</p>+ <h2 id="sm-new-title">Newest<a class="sm-new-more" href="/changelog">full changelog →</a></h2>+ <p class="sm-section-desc">The 9 most recently launched pages, straight to the live surface.</p><ul class="sm-list">+ <li>+ <a href="/docs/tutorials/grok-bot-recipes">+ <span class="sm-new-date" translate="no">Oct 10, 2026</span>+ <span class="sm-title"><span data-i18n="sitemap_index.t_docs_tutorials_grok_bot_recipes">Docs · Grok Bot recipes</span></span>+ <span class="sm-path" translate="no">/docs/tutorials/grok-bot-recipes</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_docs_tutorials_grok_bot_recipes">Six Grok Bot recipes run against production, not imagined: a daily 3D brief, a game-jam asset pack, an avatar from a photo, an X post's image turned into a 3D model, a weekly agent report over OAuth, and a Solana-first $THREE market brief. Every output in the doc came from a real run.</span>+ </a>+ </li>+ <li>+ <a href="/docs/grok-bot">+ <span class="sm-new-date" translate="no">Oct 9, 2026</span>+ <span class="sm-title"><span data-i18n="sitemap_index.t_docs_grok_bot">Docs · Grok Bot connector reference</span></span>+ <span class="sm-path" translate="no">/docs/grok-bot</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_docs_grok_bot">Connect Grok Bot to three.ws as a custom MCP connector: exact fields for each sign-in mode, which server to pick, the links every result carries, jobs and safe retries, free limits and install tokens, why a connector key can never spend, guided prompts, and a fix for every connection failure.</span>+ </a>+ </li>+ <li>+ <a href="/grok">+ <span class="sm-new-date" translate="no">Oct 9, 2026</span>+ <span class="sm-title"><span data-i18n="sitemap_index.t_grok">three.ws for Grok Bot: a free 3D studio and a body for Grok</span></span>+ <span class="sm-path" translate="no">/grok</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_grok">Everything Grok Bot can do with three.ws on one page: generate textured 3D models, rig avatars, find ready-made CC0 assets and run your agents through one custom MCP connector. Real models made minutes ago, the exact connector settings, three recipes to schedule and the Grok skill file. Free, no account, no key.</span>+ </a>+ </li><li><a href="/dextools"><span class="sm-new-date" translate="no">Oct 8, 2026</span>@@ -133,80 +157,56 @@</a></li><li>- <a href="/duels">- <span class="sm-new-date" translate="no">Sep 30, 2026</span>- <span class="sm-title"><span data-i18n="sitemap_index.t_duels">Trader Duels: call the winner</span></span>- <span class="sm-path" translate="no">/duels</span>- <span class="sm-desc" data-i18n="sitemap_index.d_duels">Call which of two pump.fun trader agents books more realized profit over a fixed UTC window. Free to play with a daily points allowance; points have no cash value. Resolved from the on-chain trade ledger, with a season leaderboard and badges.</span>- </a>- </li>- <li>- <a href="/experiments">- <span class="sm-new-date" translate="no">Sep 30, 2026</span>- <span class="sm-title"><span data-i18n="sitemap_index.t_experiments">Experiments</span></span>- <span class="sm-path" translate="no">/experiments</span>- <span class="sm-desc" data-i18n="sitemap_index.d_experiments">What three.ws tried, what it cost, what the numbers said and what we got wrong. Every write-up is measured from production data and ends with the queries that produced its numbers, filterable by running, concluded or killed.</span>- </a>- </li>- <li>- <a href="/analytics">- <span class="sm-new-date" translate="no">Sep 30, 2026</span>- <span class="sm-title"><span data-i18n="sitemap_index.t_analytics">Platform Analytics</span></span>- <span class="sm-path" translate="no">/analytics</span>- <span class="sm-desc" data-i18n="sitemap_index.d_analytics">Every three.ws platform total on one page, read live: agents, agents with a wallet, coins launched, 3D models generated, LLM tokens processed, x402 settlements and volume, marketplace sales and agent-to-agent hire volume, each with a daily growth chart over 30 days, 90 days or all time and a note on exactly how it is counted.</span>- </a>- </li>- <li>- <a href="/stories">- <span class="sm-new-date" translate="no">Sep 30, 2026</span>- <span class="sm-title"><span data-i18n="sitemap_index.t_stories">Success Stories</span></span>- <span class="sm-path" translate="no">/stories</span>- <span class="sm-desc" data-i18n="sitemap_index.d_stories">Agents with results anyone can check: coins launched, creator fees and service income, computed by three.ws from launch records and settled payments and shown only when the agent's owner opts in. Grouped by category, each linking to the full Spotlight entry and the coin on Solscan.</span>+ <a href="/docs/dextools">+ <span class="sm-new-date" translate="no">Oct 8, 2026</span>+ <span class="sm-title"><span data-i18n="sitemap_index.t_docs_dextools">Docs · DEXTools integration</span></span>+ <span class="sm-path" translate="no">/docs/dextools</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_docs_dextools">How three.ws and DEXTools connect: the /dextools hub, the embed builder that turns any DEXTools pair link into a 3D scene or Social Boost card snippet, the framable Boost on DEXTools card, and the counted redirect and public totals behind every visit three.ws sends to a DEXTools pair page.</span></a></li><li>- <a href="/docs/experiments">- <span class="sm-new-date" translate="no">Sep 30, 2026</span>- <span class="sm-title"><span data-i18n="sitemap_index.t_docs_experiments">Docs · How we run and publish experiments</span></span>- <span class="sm-path" translate="no">/docs/experiments</span>- <span class="sm-desc" data-i18n="sitemap_index.d_docs_experiments">The six-section write-up template every three.ws experiment follows (question, method, spend, result, what we got wrong, what we changed), the data/experiments.json entry format, and the build check that enforces both.</span>+ <a href="/docs/chart-companion">+ <span class="sm-new-date" translate="no">Oct 8, 2026</span>+ <span class="sm-title"><span data-i18n="sitemap_index.t_docs_chart_companion">Docs · Chart Companion</span></span>+ <span class="sm-path" translate="no">/docs/chart-companion</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_docs_chart_companion">How to watch a DEXTools chart with a 3D agent that reacts to every real swap: the URL parameters, streaming it as a transparent OBS overlay, embedding it with one iframe, bringing your own agent, and exactly how whale, streak and new-high reactions are decided.</span></a></li><li>- <a href="/docs/experiments-agent-launch-funnel">- <span class="sm-new-date" translate="no">Sep 30, 2026</span>- <span class="sm-title"><span data-i18n="sitemap_index.t_docs_experiments_agent_launch_funnel">Experiment · How many new agents ever launch a coin?</span></span>- <span class="sm-path" translate="no">/docs/experiments-agent-launch-funnel</span>- <span class="sm-desc" data-i18n="sitemap_index.d_docs_experiments_agent_launch_funnel">Measured from production: of 788 agents created in the 30 days to 2026-09-30, 2 launched a coin, about three in four had no wallet, and no token plan has ever been saved. What we got wrong and what we changed, with every query.</span>+ <a href="/docs/grok">+ <span class="sm-new-date" translate="no">Oct 8, 2026</span>+ <span class="sm-title"><span data-i18n="sitemap_index.t_docs_grok">Docs · three.ws for Grok</span></span>+ <span class="sm-path" translate="no">/docs/grok</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_docs_grok">Connect Grok Bot, Grok connectors and the xAI API to one free remote MCP server that turns text or an image into a textured 3D model, a rigged avatar, or a named 3D persona that lip-syncs its replies. No account, payment or API key.</span></a></li><li>- <a href="/docs/experiments-autonomous-trading">+ <a href="/duels"><span class="sm-new-date" translate="no">Sep 30, 2026</span>- <span class="sm-title"><span data-i18n="sitemap_index.t_docs_experiments_autonomous_trading">Experiment · Can autonomous agents trade new coins at a profit?</span></span>- <span class="sm-path" translate="no">/docs/experiments-autonomous-trading</span>- <span class="sm-desc" data-i18n="sitemap_index.d_docs_experiments_autonomous_trading">1,296 real trades by AI agents on Solana: 16.4% winners and a net loss of 0.5402 SOL on 9.1444 SOL deployed. Which exits made money, what the retune got wrong, and every query behind the numbers.</span>+ <span class="sm-title"><span data-i18n="sitemap_index.t_duels">Trader Duels: call the winner</span></span>+ <span class="sm-path" translate="no">/duels</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_duels">Call which of two pump.fun trader agents books more realized profit over a fixed UTC window. Free to play with a daily points allowance; points have no cash value. Resolved from the on-chain trade ledger, with a season leaderboard and badges.</span></a></li></ul></section><nav class="sm-toc" aria-label="Sections">- <a href="#main" data-i18n="sitemap_index.main">Main</a>- <a href="#build" data-i18n="sitemap_index.build">Build</a>- <a href="#labs" data-i18n="sitemap_index.labs">Labs</a>- <a href="#crypto" data-i18n="sitemap_index.crypto">Crypto</a>- <a href="#agent-tools" data-i18n="sitemap_index.agent_tools">Agent Tools</a>- <a href="#account" data-i18n="sitemap_index.account">Account</a>- <a href="#learn" data-i18n="sitemap_index.learn">Learn</a>- <a href="#blog" data-i18n="sitemap_index.blog">Blog</a>- <a href="#legal" data-i18n="sitemap_index.legal">Legal</a>- <a href="#machine" data-i18n="sitemap_index.machine_readable">Machine-readable</a>- <a href="#news" data-i18n="sitemap_index.news">News</a>+ <a href="#main">Main</a>+ <a href="#build">Build</a>+ <a href="#labs">Labs</a>+ <a href="#crypto">Crypto</a>+ <a href="#agent-tools">Agent Tools</a>+ <a href="#account">Account</a>+ <a href="#learn">Learn</a>+ <a href="#blog">Blog</a>+ <a href="#legal">Legal</a>+ <a href="#machine">Machine-readable</a>+ <a href="#news">News</a></nav><section class="sm-section" id="main"><header><h2><span data-i18n="sitemap_index.section_main">Main</span><span class="sm-count" data-count>62</span></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.entry_points_into_the_product">Entry points into the product.</p>+ <p class="sm-section-desc">Entry points into the product.</p></header><ul class="sm-list"><li>@@ -649,7 +649,7 @@<section class="sm-section" id="build"><header><h2><span data-i18n="sitemap_index.section_build">Build</span><span class="sm-count" data-count>80</span></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.create_and_customize_an_agent">Create and customize an agent.</p>+ <p class="sm-section-desc">Create and customize an agent.</p></header><ul class="sm-list"><li>@@ -1218,7 +1218,7 @@<section class="sm-section" id="labs"><header><h2><span data-i18n="sitemap_index.section_labs">Labs</span><span class="sm-count" data-count>25</span></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.experimental_features_actively_shipping_expe">Experimental features actively shipping. Expect fast iteration.</p>+ <p class="sm-section-desc">Experimental features actively shipping. Expect fast iteration.</p></header><ul class="sm-list"><li>@@ -1402,7 +1402,7 @@<section class="sm-section" id="crypto"><header><h2><span data-i18n="sitemap_index.section_crypto">Crypto</span><span class="sm-count" data-count>156</span></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.on_chain_features_pay_per_call_token">On-chain features: pay-per-call, token launches, vanity wallets.</p>+ <p class="sm-section-desc">On-chain features: pay-per-call, token launches, vanity wallets.</p></header><ul class="sm-list"><li>@@ -2503,7 +2503,7 @@<section class="sm-section" id="agent-tools"><header><h2><span data-i18n="sitemap_index.section_agent-tools">Agent Tools</span><span class="sm-count" data-count>10</span></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.manage_talk_to_and_deploy_individual_agents">Manage, talk to, and deploy individual agents.</p>+ <p class="sm-section-desc">Manage, talk to, and deploy individual agents.</p></header><ul class="sm-list"><li>@@ -2582,7 +2582,7 @@<section class="sm-section" id="account"><header><h2><span data-i18n="sitemap_index.section_account">Account</span><span class="sm-count" data-count>14</span></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.sign_in_dashboard_billing">Sign-in, dashboard, billing.</p>+ <p class="sm-section-desc">Sign-in, dashboard, billing.</p></header><ul class="sm-list"><li>@@ -2688,8 +2688,8 @@<section class="sm-section" id="learn"><header>- <h2><span data-i18n="sitemap_index.section_learn">Learn</span><span class="sm-count" data-count>451</span></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.docs_tutorials_and_reference">Docs, tutorials, and reference.</p>+ <h2><span data-i18n="sitemap_index.section_learn">Learn</span><span class="sm-count" data-count>457</span></h2>+ <p class="sm-section-desc">Docs, tutorials, and reference.</p></header><ul class="sm-list"><li>@@ -2944,6 +2944,20 @@<span class="sm-desc" data-i18n="sitemap_index.d_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.</span></a></li>+ <li>+ <a href="/docs/dextools">+ <span class="sm-title"><span data-i18n="sitemap_index.t_docs_dextools">Docs · DEXTools integration</span></span>+ <span class="sm-path" translate="no">/docs/dextools</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_docs_dextools">How three.ws and DEXTools connect: the /dextools hub, the embed builder that turns any DEXTools pair link into a 3D scene or Social Boost card snippet, the framable Boost on DEXTools card, and the counted redirect and public totals behind every visit three.ws sends to a DEXTools pair page.</span>+ </a>+ </li>+ <li>+ <a href="/docs/chart-companion">+ <span class="sm-title"><span data-i18n="sitemap_index.t_docs_chart_companion">Docs · Chart Companion</span></span>+ <span class="sm-path" translate="no">/docs/chart-companion</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_docs_chart_companion">How to watch a DEXTools chart with a 3D agent that reacts to every real swap: the URL parameters, streaming it as a transparent OBS overlay, embedding it with one iframe, bringing your own agent, and exactly how whale, streak and new-high reactions are decided.</span>+ </a>+ </li><li><a href="/docs/coin3d-embed"><span class="sm-title"><span data-i18n="sitemap_index.t_docs_coin3d_embed">Docs · Token in 3D, as an embed</span></span>@@ -3672,6 +3686,20 @@<span class="sm-desc" data-i18n="sitemap_index.d_docs_mcp">Expose your agent as an MCP server for Claude, ChatGPT, and other clients.</span></a></li>+ <li>+ <a href="/docs/grok">+ <span class="sm-title"><span data-i18n="sitemap_index.t_docs_grok">Docs · three.ws for Grok</span></span>+ <span class="sm-path" translate="no">/docs/grok</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_docs_grok">Connect Grok Bot, Grok connectors and the xAI API to one free remote MCP server that turns text or an image into a textured 3D model, a rigged avatar, or a named 3D persona that lip-syncs its replies. No account, payment or API key.</span>+ </a>+ </li>+ <li>+ <a href="/docs/grok-bot">+ <span class="sm-title"><span data-i18n="sitemap_index.t_docs_grok_bot">Docs · Grok Bot connector reference</span></span>+ <span class="sm-path" translate="no">/docs/grok-bot</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_docs_grok_bot">Connect Grok Bot to three.ws as a custom MCP connector: exact fields for each sign-in mode, which server to pick, the links every result carries, jobs and safe retries, free limits and install tokens, why a connector key can never spend, guided prompts, and a fix for every connection failure.</span>+ </a>+ </li><li><a href="/docs/mcp-solana-memo-media"><span class="sm-title"><span data-i18n="sitemap_index.t_docs_mcp_solana_memo_media">Docs · Solana Memo Media MCP</span></span>@@ -5312,9 +5340,16 @@</li><li><a href="/connect">- <span class="sm-title"><span data-i18n="sitemap_index.t_connect">Connect three.ws to Claude, ChatGPT, Cursor & VS Code</span></span>+ <span class="sm-title"><span data-i18n="sitemap_index.t_connect">Connect three.ws to Claude, ChatGPT, Grok Bot, Cursor & VS Code</span></span><span class="sm-path" translate="no">/connect</span>- <span class="sm-desc" data-i18n="sitemap_index.d_connect">Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_connect">Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Grok Bot, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.</span>+ </a>+ </li>+ <li>+ <a href="/grok">+ <span class="sm-title"><span data-i18n="sitemap_index.t_grok">three.ws for Grok Bot: a free 3D studio and a body for Grok</span></span>+ <span class="sm-path" translate="no">/grok</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_grok">Everything Grok Bot can do with three.ws on one page: generate textured 3D models, rig avatars, find ready-made CC0 assets and run your agents through one custom MCP connector. Real models made minutes ago, the exact connector settings, three recipes to schedule and the Grok skill file. Free, no account, no key.</span></a></li><li>@@ -5667,6 +5702,13 @@<span class="sm-desc" data-i18n="sitemap_index.d_brownout">Every response from this API says where its data came from and how fresh it is, and every declared fallback has been proven by breaking the upstream it protects against, inside the real request path. Read the receipts: which provider refused, which one caught the request, and how old the answer was.</span></a></li>+ <li>+ <a href="/docs/tutorials/grok-bot-recipes">+ <span class="sm-title"><span data-i18n="sitemap_index.t_docs_tutorials_grok_bot_recipes">Docs · Grok Bot recipes</span></span>+ <span class="sm-path" translate="no">/docs/tutorials/grok-bot-recipes</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_docs_tutorials_grok_bot_recipes">Six Grok Bot recipes run against production, not imagined: a daily 3D brief, a game-jam asset pack, an avatar from a photo, an X post's image turned into a 3D model, a weekly agent report over OAuth, and a Solana-first $THREE market brief. Every output in the doc came from a real run.</span>+ </a>+ </li><li><a href="/docs/tutorials/write-a-guard"><span class="sm-title"><span data-i18n="sitemap_index.t_docs_tutorials_write_a_guard">Docs · Write a repository guard</span></span>@@ -5855,7 +5897,7 @@<section class="sm-section" id="blog"><header><h2><span data-i18n="sitemap_index.section_blog">Blog</span><span class="sm-count" data-count>39</span></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.long_form_announcements_launches_and_writing">Long-form announcements, launches, and writing from three.ws.</p>+ <p class="sm-section-desc">Long-form announcements, launches, and writing from three.ws.</p></header><ul class="sm-list"><li>@@ -6208,8 +6250,8 @@<section class="sm-section" id="machine"><header>- <h2><span data-i18n="sitemap_index.section_machine">Machine-readable</span><span class="sm-count" data-count>17</span></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.indexes_and_well_known_files_for_crawlers">Indexes and well-known files for crawlers and AI agents.</p>+ <h2><span data-i18n="sitemap_index.section_machine">Machine-readable</span><span class="sm-count" data-count>18</span></h2>+ <p class="sm-section-desc">Indexes and well-known files for crawlers and AI agents.</p></header><ul class="sm-list"><li>@@ -6261,6 +6303,13 @@<span class="sm-desc" data-i18n="sitemap_index.d_skill_md">The three.ws Agent Skill: how an AI agent connects to three.ws, the rules it follows around money and official addresses, and an index of the focused skills for 3D generation, avatars and agents. Load it like any SKILL.md.</span></a></li>+ <li>+ <a href="/grok-skill.md">+ <span class="sm-title"><span data-i18n="sitemap_index.t_grok_skill_md">grok-skill.md</span><span class="sm-badge sm-badge-internal" data-i18n="sitemap_index.badge_internal">internal</span></span>+ <span class="sm-path" translate="no">/grok-skill.md</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_grok_skill_md">The three.ws skill for Grok and Grok Bot: the connector that adds a free 3D studio, runnable curl calls for a Grok with no connector, the links every model comes back with, what needs an account, and the rule that it never spends. Upload it to Grok's Skills.</span>+ </a>+ </li><li><a href="/robots.txt"><span class="sm-title"><span data-i18n="sitemap_index.t_robots_txt">robots.txt</span><span class="sm-badge sm-badge-internal" data-i18n="sitemap_index.badge_internal">internal</span></span>@@ -6307,14 +6356,14 @@<a href="/api/mcp"><span class="sm-title"><span data-i18n="sitemap_index.t_api_mcp">MCP server</span><span class="sm-badge sm-badge-internal" data-i18n="sitemap_index.badge_internal">internal</span></span><span class="sm-path" translate="no">/api/mcp</span>- <span class="sm-desc" data-i18n="sitemap_index.d_api_mcp">Hosted Model Context Protocol server (Streamable HTTP): avatars, glTF validation, agent data, and memory as tools. Six more hosted servers are listed in /.well-known/mcp.json.</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_api_mcp">Hosted Model Context Protocol server (Streamable HTTP): avatars, glTF validation, agent data, and memory as tools. Every other hosted server, including the Grok Bot connector, is listed in /.well-known/mcp.json.</span></a></li><li><a href="/.well-known/mcp.json"><span class="sm-title"><span data-i18n="sitemap_index.t_well_known_mcp_json">.well-known/mcp.json</span><span class="sm-badge sm-badge-internal" data-i18n="sitemap_index.badge_internal">internal</span></span><span class="sm-path" translate="no">/.well-known/mcp.json</span>- <span class="sm-desc" data-i18n="sitemap_index.d_well_known_mcp_json">Directory of every hosted three.ws MCP server: endpoint, transport, auth, and what each one does.</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_well_known_mcp_json">Directory of every hosted three.ws MCP server (endpoint, transport, auth, what each one does) plus a clients block with setup for Claude, ChatGPT, Grok Bot, Cursor, VS Code and Claude Code: the recommended server, the auth mode and the exact connector settings or config file.</span></a></li><li>@@ -6337,7 +6386,7 @@<section class="sm-section" id="news"><header><h2><span data-i18n="sitemap_index.section_news">News</span><span class="sm-count" data-count>112</span></h2>- <p class="sm-section-desc" data-i18n="sitemap_index.product_launches_integrations_and_announceme">Product launches, integrations, and announcements from three.ws.</p>+ <p class="sm-section-desc">Product launches, integrations, and announcements from three.ws.</p></header><ul class="sm-list"><li>@@ -7128,10 +7177,10 @@</section><div class="sm-empty" id="sm-empty" hidden><p><span data-i18n="sitemap_index.no_pages_match">No pages match</span> “<span id="sm-empty-q"></span>”.</p>- <p class="sm-empty-hint" data-i18n="sitemap_index.try_a_shorter_word_or_search_everything">Try a shorter word, or search everything: global search covers agents, coins, and skills too.</p>+ <p class="sm-empty-hint">Try a shorter word, or search everything: global search covers agents, coins, and skills too.</p><div class="sm-empty-actions">- <button type="button" id="sm-empty-clear" data-i18n="sitemap_index.clear_filter">Clear filter</button>- <a id="sm-empty-search" href="/search" data-i18n="sitemap_index.search_all_of_three_ws">Search all of three.ws</a>+ <button type="button" id="sm-empty-clear">Clear filter</button>+ <a id="sm-empty-search" href="/search">Search all of three.ws</a></div></div></main>diff --git a/tests/x-search.test.js b/tests/x-search.test.jsnew file mode 100644index 000000000..592100931--- /dev/null+++ b/tests/x-search.test.js@@ -0,0 +1,204 @@+/**+ * X search failover: the app-only bearer rung (api/_lib/x-search.js,+ * searchMintPostsBearer) and the xAI x_search rung added as a second,+ * independent path to the same data (searchMintPostsViaXai). Covers the pure+ * parsing of both rungs' payloads, the orchestrator's failover between them,+ * and the daily cap that stops the xAI rung once reached. Payloads are+ * captured, real-shaped fixtures, not live responses.+ */++import { describe, it, expect, beforeEach, vi } from 'vitest';++const settings = new Map();++vi.mock('../api/_lib/db.js', () => ({+ sql: vi.fn((strings, ...values) => {+ const text = Array.isArray(strings) ? strings.join('?') : String(strings);+ if (text.includes('CREATE TABLE')) return Promise.resolve([]);+ if (text.includes('SELECT value FROM app_settings')) {+ const key = values[0];+ const row = settings.get(key);+ return Promise.resolve(row ? [{ value: row }] : []);+ }+ if (text.includes('INSERT INTO app_settings')) {+ const key = values[0];+ const day = values[1];+ const prev = settings.get(key);+ const count = prev && prev.day === day ? prev.count + 1 : 1;+ const value = { day, count };+ settings.set(key, value);+ return Promise.resolve([{ count }]);+ }+ return Promise.resolve([]);+ }),+}));++const xs = await import('../api/_lib/x-search.js');++const MINT = 'FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump';++beforeEach(() => {+ settings.clear();+ xs._resetXSearch();+ vi.clearAllMocks();+});++// --- parseXaiSearchPayload / extractResponsesOutputText --------------------++describe('extractResponsesOutputText', () => {+ it('joins text parts across every output message', () => {+ const payload = {+ id: 'resp_1',+ output: [+ { type: 'message', content: [{ type: 'output_text', text: '[{"id":"1"' }] },+ { type: 'message', content: [{ type: 'output_text', text: ',"url":"https://x.com/alice/status/1"}]' }] },+ ],+ };+ expect(xs.extractResponsesOutputText(payload)).toBe('[{"id":"1","url":"https://x.com/alice/status/1"}]');+ });++ it('returns empty string for a malformed body', () => {+ expect(xs.extractResponsesOutputText({})).toBe('');+ expect(xs.extractResponsesOutputText(null)).toBe('');+ });+});++describe('parseXaiSearchPayload', () => {+ function responsesBody(jsonText) {+ return { id: 'resp_1', status: 'completed', output: [{ type: 'message', content: [{ type: 'output_text', text: jsonText }] }] };+ }++ it('normalizes a strict-JSON x_search answer into the shared post shape', () => {+ const body = responsesBody(JSON.stringify([+ { id: '1999000111', url: `https://x.com/alice/status/1999000111`, text: `the mint is ${MINT} & it is live`, created_at: '2026-10-10T12:00:00.000Z', author: { username: '@alice' } },+ ]));+ const posts = xs.parseXaiSearchPayload(body);+ expect(posts).toEqual([{+ id: '1999000111',+ url: 'https://x.com/alice/status/1999000111',+ text: `the mint is ${MINT} & it is live`,+ created_at: '2026-10-10T12:00:00.000Z',+ author: { id: null, username: 'alice', name: null, followers: null, verified: false },+ likes: 0,+ reposts: 0,+ replies: 0,+ quotes: 0,+ impressions: null,+ }]);+ });++ it('strips a markdown code fence around the JSON', () => {+ const body = responsesBody('```json\n[]\n```');+ expect(xs.parseXaiSearchPayload(body)).toEqual([]);+ });++ it('derives the post id from the url when id is missing, and skips posts with neither', () => {+ const body = responsesBody(JSON.stringify([+ { url: 'https://x.com/bob/status/42', text: 'no id field' },+ { text: 'no id and no url at all' },+ ]));+ const posts = xs.parseXaiSearchPayload(body);+ expect(posts).toHaveLength(1);+ expect(posts[0].id).toBe('42');+ });++ it('throws when the model answer is not a JSON array', () => {+ const body = responsesBody('sure, here are the posts: none found');+ expect(() => xs.parseXaiSearchPayload(body)).toThrow();+ });+});++// --- searchMintPostsViaXai ---------------------------------------------------++function fakeResponses(jsonText) {+ return vi.fn(async () => ({ id: 'resp_1', status: 'completed', output: [{ type: 'message', content: [{ type: 'output_text', text: jsonText }] }] }));+}++describe('searchMintPostsViaXai', () => {+ it('throws not_configured without a key', async () => {+ await expect(xs.searchMintPostsViaXai(MINT, { env: {}, fetchImpl: fakeResponses('[]') }))+ .rejects.toMatchObject({ name: 'XSearchUnavailable', reason: 'not_configured' });+ });++ it('returns parsed posts on a real-shaped Responses API payload', async () => {+ const fetchImpl = fakeResponses(JSON.stringify([+ { id: '555', url: 'https://x.com/carol/status/555', text: `holding ${MINT}`, created_at: '2026-10-11T00:00:00.000Z', author: { username: 'carol' } },+ ]));+ const posts = await xs.searchMintPostsViaXai(MINT, { env: { GROK_API_KEY: 'xai-test-key' }, fetchImpl });+ expect(posts).toHaveLength(1);+ expect(posts[0]).toMatchObject({ id: '555', url: 'https://x.com/carol/status/555', author: { username: 'carol' } });+ expect(fetchImpl).toHaveBeenCalledTimes(1);+ const [url, init] = fetchImpl.mock.calls[0];+ expect(url).toBe('https://api.x.ai/v1/responses');+ expect(init.headers.authorization).toBe('Bearer xai-test-key');+ const body = JSON.parse(init.body);+ expect(body.tools).toEqual([{ type: 'x_search', to_date: expect.any(String) }]);+ expect(body.input[0].content).toContain(MINT);+ });++ it('maps a 429 to rate_limited', async () => {+ const fetchImpl = vi.fn(async () => { const e = new Error('rate limited'); e.status = 429; throw e; });+ await expect(xs.searchMintPostsViaXai(MINT, { env: { XAI_API_KEY: 'k' }, fetchImpl }))+ .rejects.toMatchObject({ reason: 'rate_limited' });+ });++ it('maps an unparseable answer to upstream_error without losing the usage count', async () => {+ const fetchImpl = fakeResponses('not json at all');+ await expect(xs.searchMintPostsViaXai(MINT, { env: { XAI_API_KEY: 'k' }, fetchImpl }))+ .rejects.toMatchObject({ reason: 'upstream_error' });+ expect(await xs.xaiSearchUsageToday()).toBe(1);+ });++ it('stops the rung once the daily cap is reached', async () => {+ const fetchImpl = fakeResponses('[]');+ const env = { XAI_API_KEY: 'k', XAI_X_SEARCH_DAILY_CAP: '2' };+ await xs.searchMintPostsViaXai(MINT, { env, fetchImpl });+ await xs.searchMintPostsViaXai(MINT, { env, fetchImpl });+ expect(await xs.xaiSearchUsageToday()).toBe(2);++ await expect(xs.searchMintPostsViaXai(MINT, { env, fetchImpl }))+ .rejects.toMatchObject({ reason: 'xai_daily_cap' });+ expect(fetchImpl).toHaveBeenCalledTimes(2); // the capped call never reached the network+ });+});++// --- searchMintPosts orchestrator (failover) --------------------------------++describe('searchMintPosts failover', () => {+ it('never calls the xAI rung when the bearer rung answers', async () => {+ const bearerFetch = vi.fn(async () => new Response(JSON.stringify({ data: [] }), { status: 200, headers: { 'content-type': 'application/json' } }));+ const posts = await xs.searchMintPosts(MINT, { env: { X_BEARER_TOKEN: 'bt' }, fetchImpl: bearerFetch });+ expect(posts).toEqual([]);+ expect(bearerFetch).toHaveBeenCalledTimes(1);+ });++ it('falls over to the xAI rung when the bearer rung is not configured', async () => {+ const xaiFetch = fakeResponses(JSON.stringify([+ { id: '7', url: 'https://x.com/dave/status/7', text: `re: ${MINT}`, author: { username: 'dave' } },+ ]));+ // searchMintPosts shares one `fetchImpl` across both rungs; the bearer+ // rung never configured means it throws before using fetchImpl at all.+ const posts = await xs.searchMintPosts(MINT, { env: { XAI_API_KEY: 'k' }, fetchImpl: xaiFetch });+ expect(posts).toHaveLength(1);+ expect(posts[0].author.username).toBe('dave');+ });++ it('throws the bearer error when neither rung is configured', async () => {+ await expect(xs.searchMintPosts(MINT, { env: {} }))+ .rejects.toMatchObject({ name: 'XSearchUnavailable', reason: 'not_configured' });+ });++ it('falls over when the bearer rung is rate limited and xAI is configured', async () => {+ let calls = 0;+ const fetchImpl = vi.fn(async (url) => {+ calls += 1;+ if (url.startsWith('https://api.twitter.com')) {+ return new Response('', { status: 429, headers: {} });+ }+ return { id: 'resp_1', status: 'completed', output: [{ type: 'message', content: [{ type: 'output_text', text: '[]' }] }] };+ });+ const posts = await xs.searchMintPosts(MINT, { env: { X_BEARER_TOKEN: 'bt', XAI_API_KEY: 'k' }, fetchImpl });+ expect(posts).toEqual([]);+ expect(calls).toBe(2); // bearer attempt, then the xAI rung+ });+});