Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
fix(solana): treat 'history not on node' as a pruned attestation cursor and recover, and document the grok skill file and Video to Motion nav entry
nirholas6e2ac65e72fc
diff --git a/api/_lib/solana/cursor-recovery.js b/api/_lib/solana/cursor-recovery.jsindex 22fb6c073..d0c44f3b8 100644--- a/api/_lib/solana/cursor-recovery.js+++ b/api/_lib/solana/cursor-recovery.js@@ -24,12 +24,23 @@* error must still propagate, because dropping the cursor on a transient* failure would re-scan the whole history on every blip.*+ * Three message shapes mean the same thing: the lane that answered cannot+ * resolve the stored cursor signature. "Transaction <sig> not found" and+ * "failed to get signatures for address: ..." come from a node that pruned+ * the signature outright; "history not on node" (connection.js's+ * JSONRPC_HISTORY_NOT_ON_NODE path, -32020) comes from a lane that never+ * held it. All three get the same recovery: drop the cursor and re-scan.+ ** @param {unknown} err* @returns {boolean}*/export function isPrunedCursorError(err) {const msg = (err && typeof err === 'object' && 'message' in err ? String(err.message) : String(err || ''));- return /Transaction .* not found/i.test(msg) || /failed to get signatures for address/i.test(msg);+ return (+ /Transaction .* not found/i.test(msg) ||+ /failed to get signatures for address/i.test(msg) ||+ /history not on node/i.test(msg)+ );}/**diff --git a/docs/grok.md b/docs/grok.mdindex 4f863e8b4..66e5370d9 100644--- a/docs/grok.md+++ b/docs/grok.md@@ -206,6 +206,34 @@ its calls in [MCP use cases](./mcp.md#use-cases), andcaller's own `tools/list`, so a prompt never names a tool the connector cannotcall.+## A skill file for Grok++[`https://three.ws/grok-skill.md`](https://three.ws/grok-skill.md) teaches+Grok all of the above in one Markdown file: the connector URL and its settings,+the plain HTTPS fallback, the links contract, the free limits, what needs an+account, and the rule that a connector never spends. Upload it to Grok's Skills,+or have Grok Bot keep it in its files:++```+Download https://three.ws/grok-skill.md to your files and follow it whenever I ask for anything 3D.+```++It works without a connector too. Grok Bot has a terminal, so the file shows the+free server as `curl` JSON-RPC calls that run as written: list the tools, search+the ready-made library, get paste-ready code for a match, generate a model, and+collect a render that outlived the call:++```bash+curl -s -X POST https://three.ws/api/mcp-studio \+ -H 'content-type: application/json' \+ -H 'accept: application/json, text/event-stream' \+ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_catalog","arguments":{"q":"chair","limit":2}}}'+```++The file is the Grok edition of the general [`/skill.md`](./agent-skills.md#the-entry-point-skill-httpsthreewsskillmd).+Both render from one set of facts, so their URLs, mint and free limits cannot+disagree; see [Agent Skills](./agent-skills.md#the-grok-edition-httpsthreewsgrok-skillmd).+## How it behaves under Grok**No call hangs.** A model usually lands in under a minute, but a GPU that hasdiff --git a/docs/nav.json b/docs/nav.jsonindex a420aa78a..243aa0b45 100644--- a/docs/nav.json+++ b/docs/nav.json@@ -265,6 +265,10 @@"label": "Motion Swap (swap yourself in video)","path": "motion-swap"},+ {+ "label": "Video to Motion (export a motion capture as GLB/BVH/FBX)",+ "path": "video-to-motion"+ },{"label": "Procedural animation","path": "procedural-animation"diff --git a/docs/ops/agent-index.md b/docs/ops/agent-index.mdindex 063b31864..993eb5a41 100644--- a/docs/ops/agent-index.md+++ b/docs/ops/agent-index.md@@ -28,9 +28,11 @@ same bug on both chains, and it is silent by construction:- Solana resumes each agent from the newest signature it saw, handed back as`getSignaturesForAddress({ until })`. That parameter is resolved against theanswering node's own history, and the whole call fails with- `Transaction <sig> not found` when that node does not have it. The lane router- answers from whichever provider is not cooling and providers disagree about- retention, so a cursor written by one lane is regularly unreadable by the next.+ `Transaction <sig> not found` when that node does not have it, or with+ `history not on node` (JSON-RPC -32020) when the lane never held it at all.+ The lane router answers from whichever provider is not cooling and providers+ disagree about retention, so a cursor written by one lane is regularly+ unreadable by the next.- EVM resumes at `last_block + 1`. A provider that has pruned that height answers`History has been pruned for this block`, and no smaller window fixes it,because the data is gone rather than the request being too wide. A keyless node@@ -44,9 +46,12 @@ the crons catch per agent and per chain, so they keep returning 200 while thedirectory quietly stops learning anything.Both legs now recover on their own:-`api/_lib/solana/cursor-recovery.js` drops `until` and re-scans from the head,-and `isPrunedHistoryRejection()` skips the EVM cursor forward to the head. Both-are safe to replay, because every row lands through `on conflict do nothing`.+`api/_lib/solana/cursor-recovery.js`'s `isPrunedCursorError()` recognizes all+three Solana message shapes (`Transaction <sig> not found`,+`failed to get signatures for address`, and `history not on node`), drops+`until`, and re-scans from the head; `isPrunedHistoryRejection()` skips the EVM+cursor forward to the head. Both are safe to replay, because every row lands+through `on conflict do nothing`.Two things had to change before the EVM half could actually fire. `erc8004RpcCall`now reads the JSON-RPC body **before** the HTTP status, because the providers that@@ -94,7 +99,7 @@ gcloud logging read 'resource.type="cloud_run_revision" resource.labels.service_| Class (from the grouped read above) | Meaning | Action ||---|---|---|-| `failed to get signatures for address: Transaction <sig> not found` | The answering lane cannot resolve the stored cursor. | Self-healing. If a block of agents is already stuck, drain it with the recovery script below instead of waiting a full sweep cycle. |+| `failed to get signatures for address: Transaction <sig> not found` / `solana rpc history not on node @ <host>` | The answering lane cannot resolve the stored cursor, either because it pruned the signature or because it never held it. | Self-healing. If a block of agents is already stuck, drain it with the recovery script below instead of waiting a full sweep cycle. || `solana rpc 429 @ <host>` | That lane is rate-limited. | Transient. The router cools the lane and retries; see [solana-rpc-lanes.md](solana-rpc-lanes.md) if it persists. || `solana rpc provider error -16401 @ <host>` | The lane gates this method behind a paid tier. | Per-method capability routing in `api/_lib/solana/connection.js`. Add the method to that lane's blocked set. || `fetch failed (…) @ <host>` | Transport fault on one lane. | Transient. Persistent means the lane is dead: drop it. |diff --git a/tests/solana-attestations-cursor-recovery.test.js b/tests/solana-attestations-cursor-recovery.test.jsindex 0467e4222..9b5dd485f 100644--- a/tests/solana-attestations-cursor-recovery.test.js+++ b/tests/solana-attestations-cursor-recovery.test.js@@ -18,6 +18,7 @@ describe('isPrunedCursorError', () => {it('matches the RPC message for a cursor the node no longer has', () => {expect(isPrunedCursorError(PRUNED)).toBe(true);expect(isPrunedCursorError(new Error('Transaction abc123 not found'))).toBe(true);+ expect(isPrunedCursorError(new Error('solana rpc history not on node @ https://example.com'))).toBe(true);});it('does not swallow unrelated RPC failures', () => {