Skip to content

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.

docs(changelog): tell holders the expired X connection now offers a reconnect, and regenerate the feeds

nirholas2e7daf6ec2f4
diff --git a/docs/api-reference.md b/docs/api-reference.md
index beb4059a2..cbad8995b 100644
--- a/docs/api-reference.md
+++ b/docs/api-reference.md
@@ -609,6 +609,201 @@ Requires auth. Deletes a single memory by its platform ID.
---
+## Memory seed connectors API
+
+Public-footprint readers that turn an account handle into the raw material for a
+memory seed, plus the synthesizer that writes the seed itself. This is the lane
+behind [/demos/memory-seed](https://three.ws/demos/memory-seed) and the seed
+widget in `src/memory-seed.js`.
+
+Everything these endpoints read is already public. They are read-only, request
+no OAuth from the visitor, and store nothing; the consent-gated seeding flows
+that do write to an agent live at `/api/agents/:id/memory/seed/*` and are
+documented in [GitHub](./github-memory-seeding.md), [X](./x-memory-seeding.md)
+and [Farcaster](./farcaster-memory-seeding.md) memory seeding.
+
+The three connectors are unauthenticated GETs, rate limited per IP, and cached
+at the edge for 5 minutes. A connector that cannot reach its upstream answers
+`200` with `{ "ok": false, "reason", "detail" }` so a partly-configured
+deployment degrades to a greyed-out card instead of a failed page; a bad handle
+is still a `4xx`.
+
+### GitHub footprint
+
+```
+GET /api/seed/github?handle=<user>
+```
+
+No credentials required. `GITHUB_TOKEN` is used when present, purely for the
+higher rate limit.
+
+```bash
+curl -s 'https://three.ws/api/seed/github?handle=nirholas'
+```
+
+```json
+{
+ "ok": true,
+ "handle": "nirholas",
+ "name": "nich",
+ "bio": "",
+ "followers": 617,
+ "public_repos": 223,
+ "top_repos": [
+ {
+ "name": "fresh-start",
+ "description": "The original repo, restored.",
+ "stars": 6250,
+ "language": null,
+ "html_url": "https://github.com/nirholas/fresh-start"
+ }
+ ],
+ "top_readme_excerpt": "# fresh-start"
+}
+```
+
+Errors: `400 invalid_request` (no handle), `400 invalid_handle` (illegal
+characters), `404 not_found` (no such user), `502 upstream_error`.
+
+---
+
+### Farcaster footprint
+
+```
+GET /api/seed/farcaster?handle=<fname-or-fid>
+```
+
+No credentials required. Reads through the platform's shared Farcaster client,
+which prefers Neynar when `NEYNAR_API_KEY` is set and otherwise falls back to a
+public Farcaster hub over HTTP (`FARCASTER_HUB_URL`, default
+`https://hub.pinata.cloud`).
+
+`lane` names the rung that answered. The hub serves raw protocol messages and
+therefore has no reaction counts, so `follower_count`, `following_count` and
+per-cast `engagement` are `null` on that lane rather than `0`. Casts are ranked
+by engagement where the lane knows it and by recency where it does not, with
+replies, link-only posts and duplicates dropped.
+
+```bash
+curl -s 'https://three.ws/api/seed/farcaster?handle=dwr'
+```
+
+```json
+{
+ "ok": true,
+ "lane": "hub",
+ "handle": "dwr",
+ "fid": 3,
+ "display_name": "Dan Romero",
+ "bio": "Working on Farcaster",
+ "follower_count": null,
+ "recent_casts": [
+ {
+ "text": "Best store-bought eggnog available on the west coast",
+ "timestamp": "2025-11-28T01:35:34.000Z",
+ "engagement": null
+ }
+ ]
+}
+```
+
+Errors: `400 invalid_request`, `400 invalid_handle`, `404 not_found`. A hub
+answers an unknown fname with `400` and a `NotFound` detail; that is normalised
+to a `404` here so a typo cannot read as an outage.
+
+---
+
+### X footprint
+
+```
+GET /api/seed/x?handle=<user>
+```
+
+X has no keyless public read lane, so this connector needs one of two credential
+sets and reports `ok: false` without either:
+
+1. `TWITTER_BEARER_TOKEN`, an app-only bearer from the developer portal.
+2. `X_API_KEY` + `X_API_SECRET`, the OAuth 1.0a consumer pair. The handler
+ exchanges them for an app-only bearer at runtime via `appLogin()`, so a
+ deployment that already holds the changelog poster's app credentials needs
+ nothing new provisioned.
+
+```bash
+curl -s 'https://three.ws/api/seed/x?handle=jack'
+```
+
+```json
+{
+ "ok": true,
+ "handle": "jack",
+ "name": "jack",
+ "bio": "no state is the best state",
+ "follower_count": 11300858,
+ "tweet_count": 30894,
+ "recent_tweets": [
+ {
+ "text": "joel is awesome",
+ "created_at": "2026-08-10T21:54:11.000Z",
+ "likes": 1458,
+ "retweets": 87,
+ "replies": 115
+ }
+ ],
+ "top_topics": [{ "topic": "agents", "count": 4 }]
+}
+```
+
+Errors: `400 invalid_request`, `400 invalid_handle`, `404 not_found`. A rate
+limit or outage on the timeline read keeps the profile payload and returns an
+empty `recent_tweets` rather than failing the request.
+
+---
+
+### Synthesize a memory seed
+
+```
+POST /api/seed/synthesize
+```
+
+Requires auth (session cookie or bearer token). Takes any subset of the three
+connector payloads verbatim and returns a 200-300 word markdown memory seed. The
+completion runs on the platform LLM chain (`api/_lib/llm.js`), which leads with
+free and keyless providers, so no provider key is required.
+
+**Request body**
+
+```json
+{
+ "connectors": {
+ "github": { "ok": true, "handle": "nirholas", "top_repos": [] },
+ "x": { "ok": true, "handle": "jack" },
+ "farcaster": { "ok": true, "handle": "dwr", "fid": 3 }
+ }
+}
+```
+
+Connector payloads carrying `ok: false` are ignored. At least one usable payload
+is required.
+
+**Response**
+
+```json
+{
+ "ok": true,
+ "memory_seed": "### Interests\nThe user is a prolific builder...",
+ "sources_used": ["github", "x", "farcaster"],
+ "tokens_used": 2670,
+ "usage": { "input_tokens": 2300, "output_tokens": 370 },
+ "model": "gemini-3.1-flash-lite"
+}
+```
+
+Errors: `401 unauthorized`, `400 validation_error` (unknown key, or no connector
+supplied), `400 no_signal` (every payload unusable), `429
+daily_spend_cap_exceeded`, `502 upstream_error`, `503 llm_unavailable`.
+
+---
+
## Chat / LLM API
### Agent chat
diff --git a/docs/start-here.md b/docs/start-here.md
index f2293bca1..d691aff06 100644
--- a/docs/start-here.md
+++ b/docs/start-here.md
@@ -186,6 +186,7 @@ Deeper references that don't fit a track above but answer real questions:
- [Farcaster memory seeding](./farcaster-memory-seeding.md): give an agent your Farcaster voice, proved with a wallet the account already verified, and revoke it in one click
- [X memory seeding](./x-memory-seeding.md): seed an agent from your public X posts behind an explicit, versioned consent you can revoke (revocation deletes what the seed wrote)
- [GitHub memory seeding](./github-memory-seeding.md): tick the profile, repositories, and READMEs your agent may read, and nothing outside that list is ever fetched or stored (disconnecting deletes every fact it wrote)
+- [Memory seed connectors](./api-reference.md#memory-seed-connectors-api): the public read-only lane behind the seeding demo. Turn a GitHub, X, or Farcaster handle into a footprint payload, then synthesize a memory seed from any subset of them
- [The catalog quality gate](./seed-quality.md): how a platform-seeded model earns its slot in the public catalog, the two stages it must pass, and why a rejected asset is kept rather than deleted
- [Likeness evaluation](./likeness-eval.md): the Phase 1 verification metric, measured rather than asserted. Every reconstruction is rendered at three yaws and compared to the photos it was built from with an open-source face-recognition embedding, so "4 out of 5" means one fixed, calibrated thing
- [Examples gallery](./examples.md): copy-paste-ready code for common use cases
diff --git a/docs/syndication.md b/docs/syndication.md
index 8a54a1635..1bf9cdf3b 100644
--- a/docs/syndication.md
+++ b/docs/syndication.md
@@ -14,6 +14,54 @@ items in `data/rss/items.json` may still carry a `syndication` field
recording where they were mirrored at publish time; it is inert
metadata.
+## Feed URLs and sources
+
+`https://three.ws/rss/announcements.xml` and the shorter
+`https://three.ws/rss.xml` serve the same feed. Both accept one optional
+query parameter, `source`, which selects what the feed is built from:
+
+| `?source=` | Feed contents |
+| --- | --- |
+| omitted, or `curated` | The hand-edited items in `data/rss/items.json`. This is what HackerNoon and every public subscriber reads. |
+| `trythreews` | Announcements archived from [@trythreews](https://x.com/trythreews). |
+| `nichxbt` | Announcements archived from [@nichxbt](https://x.com/nichxbt). |
+| `archive` | Both archived accounts, merged and de-duplicated, newest first. |
+
+The value is case-insensitive. Anything else is a `400` with
+`{"error":"unknown_source"}` rather than a silent fall-back to the
+curated feed, so a subscriber who mistypes a source finds out instead of
+quietly receiving a different feed forever. Responses are cached for ten
+minutes at the edge and are `application/rss+xml`; the endpoint is
+read-only and answers `GET`, `HEAD`, and `OPTIONS` only.
+
+Fetch it from anywhere:
+
+```bash
+curl -s 'https://three.ws/rss/announcements.xml' | xmllint --noout - && echo 'valid feed'
+```
+
+### Why feed validity is load-bearing
+
+XML has no partial failure: one illegal byte anywhere in the document
+makes the *whole* feed unreadable, so a single bad post takes every
+subscriber offline rather than dropping one item. The builder in
+[`api/_lib/rss-feed.js`](../api/_lib/rss-feed.js) therefore neutralizes
+the three inputs that can do that, and
+[`tests/rss-announcements.test.js`](../tests/rss-announcements.test.js)
+pins each one:
+
+- **A `]]>` inside an item body**, which would close the `CDATA` section
+ early. It is re-emitted across two sections so it survives as text.
+- **Characters XML 1.0 forbids** (control bytes other than tab, newline
+ and carriage return; unpaired surrogates). Escaping cannot rescue
+ these, so they are dropped. Real astral characters and emoji are kept.
+- **Prose that spells the linkifier's internal URL placeholder.** The
+ placeholder is a form escaped text cannot contain, so a post can never
+ be mistaken for a link the builder set aside.
+
+Editing `data/rss/items.json` by hand is safe against all three, but run
+the `curl | xmllint` check above after a deploy that touches the feed.
+
## HackerNoon
HackerNoon is one of the world's largest independent tech publications.
diff --git a/public/changelog.json b/public/changelog.json
index 356ba5dc8..cd52e4555 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-08-16T07:25:09.580Z",
+ "generated_at": "2026-08-16T07:25:32.439Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
diff --git a/public/features.json b/public/features.json
index 6008f0d77..49722c821 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-08-16T07:25:09.436Z",
+ "generated_at": "2026-08-16T07:25:32.328Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
diff --git a/public/llms-full.txt b/public/llms-full.txt
index 714124bc5..309ea4d66 100644
--- a/public/llms-full.txt
+++ b/public/llms-full.txt
@@ -3135,7 +3135,7 @@ three.ws is built around two distinct concepts: agents are AI minds, avatars are
URL: https://three.ws/docs/animations
-The motion clips (idle, wave, dance, and about 2,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.
+The motion clips (idle, wave, dance, and about 3,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.
### Docs · Choreography
diff --git a/public/llms.txt b/public/llms.txt
index 158c33ce9..4af584317 100644
--- a/public/llms.txt
+++ b/public/llms.txt
@@ -556,7 +556,7 @@ Docs, tutorials, and reference.
- [Docs · The three.ws Agent Skills pack](https://three.ws/docs/agent-skills): Portable skill folders that teach any Claude surface (Claude Code, the Claude apps, the Agent SDK) how to use three.ws: 3D creation, wallets, and paid services. The 3D subset is cross-platform-safe and needs no credentials.
- [Docs · Agent wallets](https://three.ws/docs/agent-wallets): Every three.ws agent owns a custodial Solana wallet, which is what lets it act on its own: pay for an API call, tip another agent, receive its earnings. Custody model, funding, limits, and the controls around spending.
- [Docs · Agents vs. avatars](https://three.ws/docs/agents-vs-avatars): three.ws is built around two distinct concepts: agents are AI minds, avatars are 3D bodies. The short, plain-language explanation of which is which, how they combine, and why the distinction matters when you go looking for a feature.
-- [Docs · Animations](https://three.ws/docs/animations): The motion clips (idle, wave, dance, and about 2,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.
+- [Docs · Animations](https://three.ws/docs/animations): The motion clips (idle, wave, dance, and about 3,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.
- [Docs · Choreography](https://three.ws/docs/choreography): The developer reference for agent gesture routines: the routine format, the storage and manifest fields, the URL wire format that makes a link a routine, and every way to play one from an embed or your own renderer.
- [Docs · Architecture overview](https://three.ws/docs/architecture): The engineering map of three.ws: how a request flows from the browser through the route table to a handler, where 3D generation runs, how state is stored, and which layer to extend when you want to add something.
- [Docs · Avatar creation](https://three.ws/docs/avatar-creation): The three ways to give an agent a 3D body: generate one from a photo, build one in the browser with the avatar builder, or upload your own GLB. What each path costs, what each produces, and when to choose which.
diff --git a/public/locales/localized-pages.json b/public/locales/localized-pages.json
index 702a23773..bebdda5a4 100644
--- a/public/locales/localized-pages.json
+++ b/public/locales/localized-pages.json
@@ -1,6 +1,6 @@
{
"generated": true,
- "count": 355,
+ "count": 243,
"paths": [
"/",
"/3d",
@@ -157,118 +157,6 @@
"/mocap-studio",
"/motion-swap",
"/my-agents",
- "/news",
- "/news/",
- "/news/2045242891350814835",
- "/news/2049397875935989970",
- "/news/2049406826719137937",
- "/news/2049412062837928202",
- "/news/2049447738434339171",
- "/news/2049458671139336613",
- "/news/2049476546285740512",
- "/news/2049557523330638269",
- "/news/2049573582247022869",
- "/news/2049576603324411933",
- "/news/2049576641127682430",
- "/news/2049577291957899336",
- "/news/2049762836881301865",
- "/news/2049765915575914834",
- "/news/2049997615421649363",
- "/news/2050016695897706885",
- "/news/2050049239301165535",
- "/news/2050221269732425928",
- "/news/2050226678321102975",
- "/news/2050229144676675999",
- "/news/2050284562069266616",
- "/news/2050585585191186781",
- "/news/2050627547394916768",
- "/news/2050753406109880576",
- "/news/2050758788186353723",
- "/news/2050800140295049308",
- "/news/2050886334261391686",
- "/news/2051140736201175323",
- "/news/2051261108506558901",
- "/news/2051616708482498843",
- "/news/2051689230997618690",
- "/news/2051690803203105230",
- "/news/2051774915876098063",
- "/news/2051858035862335505",
- "/news/2051858503523066283",
- "/news/2051893054584553680",
- "/news/2052037977556287723",
- "/news/2052167399399735476",
- "/news/2052181307002929363",
- "/news/2052189491801284690",
- "/news/2052402481024667887",
- "/news/2052402580266098813",
- "/news/2052418108837781511",
- "/news/2052418482269254040",
- "/news/2052426446073983267",
- "/news/2052588973466484922",
- "/news/2052603250524967045",
- "/news/2052685648377913671",
- "/news/2052790746256920583",
- "/news/2052791935585407403",
- "/news/2053025259645981078",
- "/news/2053698115203743922",
- "/news/2053698387263008827",
- "/news/2053730856339144932",
- "/news/2053801703355629587",
- "/news/2053804700609458214",
- "/news/2053832201176027583",
- "/news/2054404663802483072",
- "/news/2054675701132132736",
- "/news/2055140064070717618",
- "/news/2055307440921702738",
- "/news/2055309846556401735",
- "/news/2055310365588922872",
- "/news/2055517252964024561",
- "/news/2055967730495586477",
- "/news/2055985494606106821",
- "/news/2056556899403997450",
- "/news/2057721370310775223",
- "/news/2057780453709648200",
- "/news/2057782522994684413",
- "/news/2057786164862730704",
- "/news/2058076885805085111",
- "/news/2058287578227577039",
- "/news/2059456289789657537",
- "/news/2059456294189498830",
- "/news/2059456295825223723",
- "/news/2059457822941978723",
- "/news/2059675892981633179",
- "/news/2059712761622675776",
- "/news/2059821472156446844",
- "/news/2059894004771418220",
- "/news/2060178868305326413",
- "/news/2060186881636422038",
- "/news/2061418285896269952",
- "/news/2061488909264040194",
- "/news/2061523804405616642",
- "/news/2061713039624405062",
- "/news/aws-agentic-economy-three-ws",
- "/news/aws-builder-center-3d-agents-onchain-payments",
- "/news/aws-builder-center-blog",
- "/news/aws-marketplace-live-may29",
- "/news/bybit-alpha-listing",
- "/news/cmc-mcp-registry-article",
- "/news/cmc-memecoin-3d-world",
- "/news/ibm-collaboration-showcase",
- "/news/ibm-showcase-may31",
- "/news/joined-aws-partner-network",
- "/news/listed-on-bnb-chain-dappbay",
- "/news/live-on-alibaba-cloud-marketplace",
- "/news/live-on-aws-marketplace",
- "/news/mcp-servers-x402-bazaar-coinbase",
- "/news/monetize-mcp-server-x402-paid-tools",
- "/news/moonshot-verified",
- "/news/partnered-with-hackernoon",
- "/news/quicknode-startup-program",
- "/news/text-to-3d-is-live",
- "/news/three-ws-dextools-social-boost-buyback",
- "/news/three-ws-featured-on-alibaba-cloud-marketplace-blog",
- "/news/three-ws-first-month-3d-agent-layer",
- "/news/threews-play-coin-communities",
"/nim-forge",
"/notifications",
"/nvidia",
diff --git a/public/sitemap/index.html b/public/sitemap/index.html
index 4c378c38f..e8d68c0fe 100644
--- a/public/sitemap/index.html
+++ b/public/sitemap/index.html
@@ -3831,7 +3831,7 @@
<a href="/docs/animations">
<span class="sm-title">Docs · Animations</span>
<span class="sm-path">/docs/animations</span>
- <span class="sm-desc">The motion clips (idle, wave, dance, and about 2,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.</span>
+ <span class="sm-desc">The motion clips (idle, wave, dance, and about 3,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.</span>
</a>
</li>
<li>