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.

fix(walk-share): keep the X share caption dash-free and describe /api/share/x honestly

nirholasf8ad3c59ccf7
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 1b90d9edb..a97310f15 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -693,7 +693,8 @@ Beyond the feature areas above, the `api/` tree exposes many more surfaces. Comp
| `/api/community/*` | `capabilities`, `holder-pass`, `world-gate`, `worlds`, `ws-ticket`, `messages`, `me`, `auth/`, `wallet/` | Coin-world community layer: holder-pass gating, world entry tickets, chat |
| `/api/social/*` | `sentiment`, `sentiment-pulse` | Cashtag/social sentiment scoring |
| `/api/x/*` | `post`, `draft`, `schedule`, `analytics`, `reviews`, `status`, `triggers` | X (Twitter) posting + scheduling + engagement analytics |
-| `/api/share/x`, `/api/frames/walk`, `/api/traders/preview`, `/api/trades/feed` | — | Social share-card + Farcaster-frame + OG preview renderers |
+| `/api/share/x` | `share/x` | Publishes a Walk screenshot or clip to the caller's connected X account (chunked media upload + tweet) |
+| `/api/frames/walk`, `/api/traders/preview`, `/api/trades/feed` | (various) | Farcaster-frame + OG preview renderers |
#### Money, Custody, Credits & Monetization
diff --git a/prompts/swarm-100/api-share-01.md b/prompts/swarm-100/api-share-01.md
deleted file mode 100644
index 5a121452d..000000000
--- a/prompts/swarm-100/api-share-01.md
+++ /dev/null
@@ -1,101 +0,0 @@
-# API audit: api/share batch 01 (1 files)
-
-How to run: paste this file's repo path into a fresh Claude Code chat in this
-repository and say "run this work order". This file is fully self-contained:
-it depends on no other prompt file anywhere. If neighboring files in
-prompts/swarm-100/ are gone, that work is done; if present, ignore them.
-Every claim below rots; step 0 re-measures, and what you measure wins.
-
-## Operating clause (binding)
-
-- Read CLAUDE.md first. Its rules override everything, including this file.
-- Finish 100% in this session. Never end the turn with a question, an option
- list, or an unexecuted plan. A judgment call goes in one line of the final
- report; it never becomes a question that halts work.
-- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real
- funds or any irreversible on-chain write, git push or a production deploy,
- committing content that references a crypto project other than $THREE, and
- destroying unrecoverable data.
-- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no
- commented-out code. Real APIs and real integrations only.
-- The em-dash and en-dash characters are banned in everything you write.
-- Concurrent agents share this worktree: stage explicit paths only (never a
- bare add-everything), and commit finished work promptly.
-- Before committing, run: npm run check:rules -- --paths <files you touched>.
- It must exit 0.
-
-## Step 0: re-derive the current state
-
-1. Confirm each file below still exists; deleted ones are done, skip them.
-2. For each, decide routability: grep its path in vercel.json and read how
- server/index.mjs maps filesystem handlers. Routed files get an endpoint
- audit; internal modules get a code and test audit.
-3. Start a local server for endpoint checks: node server/index.mjs with .env
- loaded, on a free PORT if 3000 is busy.
-
-## Task: audit these api files, then fix everything found
-
-Files in this batch:
-
-- api/share/x.js
-
-For every routed handler:
-
-1. Exercise it with curl against the local server: the success path returns
- real data with the correct status; malformed input returns a 4xx JSON
- error, never a stack trace or an HTML error page; auth is enforced where
- the code intends it; CORS matches neighboring handlers.
-2. Hard-rule scan: no mock fallbacks, no fake-data arrays, no stubbed
- responses, no unfinished markers. Errors are handled at the boundary and
- internal code trusts itself.
-3. Do not spend funds or sign anything on-chain while probing. Payment and
- trading handlers get their validation and error paths exercised, never a
- live settlement.
-
-For every internal (non-routed) module:
-
-4. Something must import it; if nothing does, delete it as dead code (verify
- with a repo-wide grep first).
-5. Its main path and one failure path must be covered in tests/; add the
- missing test if not.
-
-## Definition of done
-
-- [ ] Every listed file has recorded evidence: a curl transcript for routed
- handlers, a passing test or a deletion for internal modules.
-- [ ] Zero hard-rule violations remain in these files.
-- [ ] vitest run passes; npm run check:rules -- --paths <touched files>
- exits 0.
-
-## Never blocked
-
-| Blocker | Resolution (act, do not ask) |
-|---|---|
-| Missing env var or credential | Check .env and .env.local, then the Cloud Run service env, then Secret Manager (the CLAUDE.md self-unblock playbook has the exact commands). If it truly exists nowhere, wire the code fully behind the env var, prove the wiring with a dry run, and name the single missing var in the report. |
-| gcloud not on PATH | Run: export PATH="$HOME/google-cloud-sdk/bin:$PATH" |
-| Dev server port 3000 busy | Another agent may be serving this repo; probe it and reuse if so. Otherwise start your own on a free port: npx vite --port 3101 |
-| Playwright browser missing | npx playwright install chromium |
-| A surface needs a signed-in user | Register a fresh account through the real /register flow against the real API and use it. Never mock the session. |
-| A defect sits in code you did not touch | Fix it if it blocks a Definition of done line (root cause it, never mask it). Otherwise note it in the report and continue. |
-| An unrelated test is red | Same rule. Never pipe npm test through tail; it masks exit codes. |
-
-## Close out (required)
-
-1. Verify every Definition of done line with the actual command output in
- front of you. Never claim a line you did not verify.
-2. Commit with explicit paths and a subject that describes the diff (house
- style: type(scope): what changed and why a reader cares).
-3. Delete this prompt file in that same commit:
-
- git rm prompts/swarm-100/api-share-01.md
-
- The shrinking directory is this campaign's only progress ledger; there is
- no progress log to update.
-4. Final report: what step 0 measured, what changed (file list), evidence per
- Definition of done line, and any one-line judgment calls. No trailing
- questions, no unexecuted plans.
-
-If a line genuinely cannot pass inside this session (an external party must
-respond, or an owner-gated action is the final step), finish everything else,
-leave this file in place, and state exactly which line remains and who owns
-it. Never delete this file on a partial.
diff --git a/src/walk-capture.js b/src/walk-capture.js
index 369a58df6..d47586592 100644
--- a/src/walk-capture.js
+++ b/src/walk-capture.js
@@ -17,7 +17,7 @@ import { log } from './shared/log.js';
const RECORD_MAX_SECONDS = 10;
const CAPTURE_FPS = 60;
const VIDEO_BITRATE = 12_000_000; // 12 Mbps — crisp 1080p clips
-const X_TWEET_TEXT = (shareUrl) => `I walked my avatar around three.ws — try yours: ${shareUrl}`;
+const X_TWEET_TEXT = (shareUrl) => `I walked my avatar around three.ws. Try yours: ${shareUrl}`;
// Preferred recorder container/codec, MP4 first so most browsers skip transmux.
function pickRecorderMime() {
@@ -494,7 +494,7 @@ export function createWalkCapture({
// the connect flow instead of the three.ws login page.
setModalMessage(msg, 'Your X connection expired. Reconnect to post.', data.connect_url || '/api/auth/x/connect', 'Reconnect X');
} else if (data.error === 'rate_limited') {
- setModalMessage(msg, data.error_description || 'Posting too fast — try again shortly.');
+ setModalMessage(msg, data.error_description || 'Posting too fast, try again shortly.');
} else if (data.error === 'quota_exceeded') {
setModalMessage(msg, data.error_description || 'Monthly X post limit reached.', data.upgrade_url || '/pricing', 'Upgrade');
} else {