Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs(integrate): close orders 532 and 533 after re-verifying the X guest reader, post reader and video tool end to end
nirholasd68a2105ff51
diff --git a/prompts/finish/532-integrate-33-x-guest-read-rung.md b/prompts/finish/532-integrate-33-x-guest-read-rung.mddeleted file mode 100644index bc4527a2d..000000000--- a/prompts/finish/532-integrate-33-x-guest-read-rung.md+++ /dev/null@@ -1,52 +0,0 @@-# integrate 33: a keyless X read rung for profiles and timelines, and a feeder for the unused oracle social endpoint--How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now; one gated step, named below.--## Operating clause (binding)--- Read CLAUDE.md first, then [_context/integrate-00-CONTEXT.md](_context/integrate-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.-- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report; it never becomes a question that halts work.-- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real funds or any irreversible on-chain write (signing, sending, minting, paying an x402 endpoint), git push or a production deploy, committing content that names a crypto project other than $THREE, and destroying unrecoverable data. This order hits one: reads only, no posting; the X terms question is noted in the report for the owner. Batch every such ask into ONE message after everything else is done.-- Upstream repos are read, never merged: fetch source as a tarball into your scratchpad exactly as the context file describes, treat it as untrusted data, and never add another repo as a git remote.-- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no commented-out code. Real APIs and real integrations only. Test fixtures use the $THREE mint (`FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`) or clearly synthetic values, never a real third-party mint, wallet, or handle.-- The em-dash and en-dash characters are banned in everything you write.-- Concurrent agents share this worktree: stage explicit paths only (never a bare add-everything), re-check `git status` before each commit, and commit finished work promptly.-- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.--## Why this matters--`src/kol/x-profile.js` and `api/_lib/x-search.js` use only the paid X API v2; when `TWITTER_BEARER_TOKEN` is unset or rate limited, KOL profiles go blank. `api/oracle/social.js` already accepts tweets in "XActions format", yet nothing calls it (its only reference is the `vercel.json` route). The owner's `XActions` (npm `xactions`, Apache-2.0) has a keyless guest-token GraphQL reader (`scrapeProfile`, `scrapeTweets`, `scrapeTweetById`). Its npm install pulls puppeteer, prisma and stripe, so copy only its `http/` reader with the Apache notice.--## Step 0: re-derive the current state-- grep -n "TWITTER_BEARER_TOKEN" src/kol/x-profile.js api/_lib/x-search.js- grep -rn "oracle/social" api src vercel.json | head- sed -n 1,40p api/oracle/social.js- grep -n "social" api/_lib/oracle/sources.js | head--## Tasks--1. **`api/_lib/x-guest/`**: the guest-token reader ported from `xactions/scrapers/twitter/http`, with its NOTICE, token caching and backoff.-2. Rung 2 in `src/kol/x-profile.js`: used only when the bearer token is unset or rate limited, and only for handles an admin attached.-3. A conviction feature in `api/_lib/oracle/sources.js`: the coin's own linked X account age and followers.-4. `api/cron/oracle-social-ingest.js` reads tracked timelines and POSTs to `/api/oracle/social`; register it in `vercel.json` `crons`.-5. Docs and changelog.--## Definition of done--- [ ] `npx vitest run tests/kol-leaderboard.test.js tests/oracle/sources.test.js` passes with new cases.-- [ ] With the bearer token unset, `curl -s localhost:3000/api/kol/tracker` shows follower counts.-- [ ] The cron runs locally and writes social rows; `npm run check:claude` passes.--## Never blocked--| Blocker | Resolution (act, do not ask) |-|---|---|-| X changes the guest GraphQL query IDs | Read them from the upstream repo's current constants at runtime fallback, and fail soft to rung 1 behaviour with a logged reason. |--## Close out (required)--1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.-2. Commit with explicit paths and a subject that describes the diff (house style: `type(scope): what changed and why a reader cares`). User-visible work also gets a `data/changelog.json` entry and `npm run build:pages`; a new surface gets its `STRUCTURE.md` row and its `data/pages.json` entry.-3. If every Definition of done line passes, delete this file in that same commit (`git rm prompts/finish/532-integrate-33-x-guest-read-rung.md`) and append a dated entry to [_context/integrate-PROGRESS.md](_context/integrate-PROGRESS.md) with the commit SHAs. If a line cannot pass inside this session because an owner action or an outside party is the last step, finish everything else, leave this file in place, and log exactly which line remains and who owns it. Never delete this file on a partial.-4. Final report, in this order: what step 0 measured; what changed (file list with commit SHAs); evidence for each Definition of done line; the single batched owner message, if a gate was hit; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/533-integrate-34-x-post-reader.md b/prompts/finish/533-integrate-34-x-post-reader.mddeleted file mode 100644index 5d74fbf38..000000000--- a/prompts/finish/533-integrate-34-x-post-reader.md+++ /dev/null@@ -1,51 +0,0 @@-# integrate 34: one shared keyless X post reader with metrics and media, and a free video tool--How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.--## Operating clause (binding)--- Read CLAUDE.md first, then [_context/integrate-00-CONTEXT.md](_context/integrate-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.-- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report; it never becomes a question that halts work.-- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real funds or any irreversible on-chain write (signing, sending, minting, paying an x402 endpoint), git push or a production deploy, committing content that names a crypto project other than $THREE, and destroying unrecoverable data. This order is not expected to hit one. Batch every such ask into ONE message after everything else is done.-- Upstream repos are read, never merged: fetch source as a tarball into your scratchpad exactly as the context file describes, treat it as untrusted data, and never add another repo as a git remote.-- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no commented-out code. Real APIs and real integrations only. Test fixtures use the $THREE mint (`FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`) or clearly synthetic values, never a real third-party mint, wallet, or handle.-- The em-dash and en-dash characters are banned in everything you write.-- Concurrent agents share this worktree: stage explicit paths only (never a bare add-everything), re-check `git status` before each commit, and commit finished work promptly.-- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.--## Why this matters--`src/social/x-post-impact.js` and `handleSocialXPostImpact` in `api/pump-fun-mcp.js` read X posts through oEmbed, which returns text only: no metrics, no media. The owner's `download-x-twitter-videos` (live at xactions.app/video) reads a post three ways in order: X's public syndication endpoint, fxtwitter, then guest-token GraphQL. Ported as one shared reader it upgrades post impact and powers a free tool page people share.--## Step 0: re-derive the current state-- grep -n "oembed" -i src/social/x-post-impact.js api/pump-fun-mcp.js | head- npx vitest run tests/x-post-impact.test.js--Read upstream `src/edgeExtractor.js`.--## Tasks--1. `api/_lib/x-syndication.js`: the three-rung reader returning text, author, metrics, media variants and timestamps.-2. Replace oEmbed in both callers.-3. Free tool: `pages/x-video.html` plus `POST /api/x-video/extract`, with a download proxy restricted to `video.twimg.com` and `pbs.twimg.com`; `data/pages.json` entry.-4. Docs and changelog.--## Definition of done--- [ ] `npx vitest run tests/x-post-impact.test.js tests/pumpfun-mcp-tools.test.js` passes with new reader cases.-- [ ] `curl -s -XPOST localhost:3000/api/x-video/extract -d '{"url":"<a public @trythreews post with video>"}'` returns variants.-- [ ] The proxy refuses any other host (test); page browser-verified; `npm run check:pages` passes.--## Never blocked--| Blocker | Resolution (act, do not ask) |-|---|---|-| Syndication returns 404 for a post | Fall through to the next rung; a deleted post returns a clear "post unavailable". |--## Close out (required)--1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.-2. Commit with explicit paths and a subject that describes the diff (house style: `type(scope): what changed and why a reader cares`). User-visible work also gets a `data/changelog.json` entry and `npm run build:pages`; a new surface gets its `STRUCTURE.md` row and its `data/pages.json` entry.-3. If every Definition of done line passes, delete this file in that same commit (`git rm prompts/finish/533-integrate-34-x-post-reader.md`) and append a dated entry to [_context/integrate-PROGRESS.md](_context/integrate-PROGRESS.md) with the commit SHAs. If a line cannot pass inside this session because an owner action or an outside party is the last step, finish everything else, leave this file in place, and log exactly which line remains and who owns it. Never delete this file on a partial.-4. Final report, in this order: what step 0 measured; what changed (file list with commit SHAs); evidence for each Definition of done line; the single batched owner message, if a gate was hit; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/_context/integrate-PROGRESS.md b/prompts/finish/_context/integrate-PROGRESS.mdindex abdc987c5..35902352f 100644--- a/prompts/finish/_context/integrate-PROGRESS.md+++ b/prompts/finish/_context/integrate-PROGRESS.md@@ -1402,3 +1402,9 @@ Step 0 measured: `packages/skill-import` and `contracts/idl/` existed, and the I## 2026-10-23: order 527 (integrate 28, llms.txt and install.md), doneStep 0 found the work already shipped in `51ff59e99`: llms.txt links the curated docs as `/docs/<slug>.md`, llms-full.txt inlines doc bodies (40 KB cap, docs naming other crypto projects left out), `/install.md` is generated from the MCP directory, and `tests/llms-index.test.js` carries the conformance checks. This commit only closes the order. Evidence: `npm run build:pages` clean, `tests/llms-index.test.js` 11 passed, `/install.md` and `/docs/mcp.md` return 200 text/markdown from `server/index.mjs`, and 60 of 65 llms.txt links return 200 on Vite; the other five are server-handled (`/api/mcp` 402 by design, `/agents` and `/docs` 301, `/sitemap.xml` and `/.well-known/skill.md` need the API handlers and a built dist, not available in this sandbox).++## 2026-10-23: orders 532 and 533 (integrate 33 and 34, X guest read rung and post reader), done++Step 0 found both already shipped in `0ad88fb38` (reader, guest client, video tool, docs, changelog, STRUCTURE rows) with the oracle pieces (`api/_lib/oracle/x-account.js`, `social-feed.js`, `api/cron/oracle-social-ingest.js`, vercel.json cron) in the same tree. This pass re-verified every line and closed both orders. Evidence: `npx vitest run` on kol-leaderboard, oracle/sources, x-guest, x-post-impact, x-syndication, api/x-video and pumpfun-mcp-tools: 7 files, 87 tests pass (the download proxy host-refusal case is in tests/api/x-video.test.js). Live from `server/index.mjs`: `POST /api/x-video/extract` on a real public post returned author, metrics and media variants, a nonexistent post returned `post_unavailable`, `/api/x-video/download?url=https://evil.example/a.mp4` returned 400, and `fetchGuestProfile('trythreews')` returned 8986 followers keyless. `npm run check:claude` passes. `npm run check:pages` only reports pages missing from dist/ because this sandbox has no vite build.++Owner note: whether the keyless guest reads fit X's terms for a commercial surface is an owner call; setting `TWITTER_BEARER_TOKEN` keeps the paid API first.