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.

Pending changes exported from your codespace

oversteppingfe06c97ab5a7
diff --git a/prompts/finish/907-backlog-08-okx-chat-bot-always-on.md b/prompts/finish/907-backlog-08-okx-chat-bot-always-on.md
index 402644abb..0b3478d57 100644
--- a/prompts/finish/907-backlog-08-okx-chat-bot-always-on.md
+++ b/prompts/finish/907-backlog-08-okx-chat-bot-always-on.md
@@ -73,6 +73,24 @@ host. Build it:
host detect an expired session and emit an actionable alert naming the exact
command, rather than failing chat silently.
+## State on 2026-09-24, re-measured: the API half has shipped, only the bot deploy is left
+
+- **API deploy: DONE.** Live API `c8f10f437` (`three-ws-api-00458-njs`) contains `53687d994`,
+ `d3074c1c8` and `f7f7da9b6`. The agent-scoped path is served: a POST to
+ `/api/llm/anthropic/agents/<unknown id>/v1/messages` answers `404 agent not found`, where it
+ answered `No API route matches` on 2026-09-18. Owner action 1 below is complete.
+- **Bot host: unchanged revision, still beating.** `bot_heartbeat` row `okx-chat-bot` was 20 s
+ old at 06:33 UTC, `host cloudrun:okx-chat-bot (okx-chat-bot-00001-926)`, `loggedIn: true`,
+ `activeClients: 1`, `agentCount: 1`, `daemonRestarts: 0`, instance `bootAt`
+ 2026-09-22T13:44Z. No `providerLane` / `leaseHolder` in the beat, so it is still the pre-lane,
+ pre-lease code, pinned to Vertex, which still answers `403 Lightning dunning decision is deny`.
+ `/api/healthz` reports `okx_chat_bot` `degraded` for exactly that reason.
+- **`npm run okx:bot:deploy -- --dry-run`** reaches step [4] green ("live API c8f10f437 contains
+ d3074c1c8") and stops at steps [1] and [3] because this workspace has no `gcloud` binary at all
+ (`spawn gcloud ENOENT`), not just an expired login. The metering service account
+ `[email protected]` does not exist yet, as expected: `--apply` creates it.
+- **What remains is owner step 2 below**, preceded by installing and authenticating `gcloud`.
+
## State on 2026-09-18, and the one command left
The payment-free reply lane is built and proven, the rollout overlap is closed, and the deploy
@@ -100,11 +118,12 @@ is one command. Full measurements: [okx-ai-PROGRESS.md](_context/okx-ai-PROGRESS
### Owner actions, in order (either deploy may go first)
```sh
-# 0. This workspace's gcloud login has expired.
+# 0. As of 2026-09-24 this workspace has no gcloud binary at all (install the Google Cloud CLI
+# first), and any earlier login is gone with it.
gcloud auth login && gcloud auth application-default login
-# 1. Approve and commit the gated files still uncommitted (see the report), then ship the API,
-# which carries the agent-scoped proxy path:
+# 1. DONE by 2026-09-24 (live API c8f10f437 serves the agent-scoped path). Kept for the record:
+# approve and commit the gated files, then ship the API:
npm run clean:worktrees -- --apply
npm run prep:worktree -- --apply
(cd /workspaces/.deploy-wt && npm run deploy:gcp:full)
diff --git a/prompts/finish/911-okx-ai-08-forge-relisting.md b/prompts/finish/911-okx-ai-08-forge-relisting.md
index 9f8034efa..aa6281a6e 100644
--- a/prompts/finish/911-okx-ai-08-forge-relisting.md
+++ b/prompts/finish/911-okx-ai-08-forge-relisting.md
@@ -9,6 +9,29 @@ This superseded `okx-ai-05-relisting-resubmission.md`, which submitted the back-
identity-studio catalog. That order was deleted on 2026-09-09; this file is the only
relisting order.
+## State on 2026-09-24, re-measured: every gate that needs no session is GREEN
+
+- **Step 0: PASS.** Live API `c8f10f437`. `GET /api/okx/3d/catalog` lists exactly the seven
+ forge/free rows (`forge-draft`, `forge-standard`, `forge-hd`, `forge-image`, `forge-status`,
+ `catalog`, `health`) with the nine back-burner rows, `identity-studio` among them, under
+ `unlisted`. Production does not predate the rebuild.
+- **Step 1: PASS on items 1 to 6.** Unpaid `forge_3d` calls answer 402, `x402Version 2`,
+ `accepts[0]` = `exact` / `eip155:196` / USD₮0 / `payTo 0x4022de2D…f402` at 10000 / 50000 /
+ 250000 / 250000. Each rail and asset appears once (X Layer USD₮0, Solana USDC, Solana $THREE,
+ Base USDC). `forge-status` does not 402, `getting_started` is free (200), `catalog` and `health`
+ answer 200 on GET. `node scripts/okx-compliance-probe.mjs` PASS 20 probes, read back with OKX's
+ own `parsePaymentRequired`. `node scripts/okx-three-copy-check.mjs`: module == live == listing
+ submission; **on-chain copy NOT COMPARED** (no session). OKX suites 228/228 pass, including
+ `okx-forge`.
+- **Steps 2 and 3: blocked on the session.** `onchainos` v4.6.2 is installed (binary checked
+ against the release `checksums.txt`), `wallet status` reads `loggedIn: false`, and
+ `get-agents`, `service-list` and `search` all answer
+ `session expired, please login again`. The delta, the QA pass and the on-chain update all need
+ the human browser login first, and the update itself needs the owner's explicit confirm.
+ Approval state of #2632 could not be read today; the last reading (2026-09-09) is
+ `approvalDisplayStatus 5`, `Listing rejected`, `status 2`, `soldCount 2`, with the on-chain
+ descriptions two-part against the module's four-part (7 divergences).
+
## Binding operating clause
1. Finish 100% of everything that is not an on-chain write or an OTP. Never end with a
diff --git a/prompts/finish/913-okx-ai-04-e2e-real-payment-test.md b/prompts/finish/913-okx-ai-04-e2e-real-payment-test.md
index 5fd0f3450..af16df8b6 100644
--- a/prompts/finish/913-okx-ai-04-e2e-real-payment-test.md
+++ b/prompts/finish/913-okx-ai-04-e2e-real-payment-test.md
@@ -5,6 +5,27 @@
Read `prompts/finish/_context/okx-ai-00-CONTEXT.md`, `prompts/finish/_context/okx-ai-RUNBOOK.md`, `specs/okx-agent-payments.md`
and `CLAUDE.md` first. Append your outcome to `prompts/finish/_context/okx-ai-PROGRESS.md` at the end.
+## State on 2026-09-24, re-measured: every leg that signs nothing is GREEN, funding is the gate
+
+- **Step 0: PASS.** Free lane 200 (`health` status ok, `payment-rail` `settleable: true`,
+ `relayer_funded: true`, the field `4e9ad0419` added is now live), catalog byte-identical to the
+ module, unlisted `text-to-3d` 402 unpaid, `okx-3d-services` suite green, listing payload
+ generates seven rows.
+- **`npm run okx:gauntlet -- --dry-run`**: 3/3 exercised cases PASS (1, 1d, 5d), 11 skipped,
+ 0 settlements. `--no-spend` was NOT run: it signs real authorizations and needs a logged-in
+ session. The dry run rewrote three committed captures with a narrower record; they were
+ restored from git, so the 2026-09-09 `--no-spend` evidence stands.
+- **Wallets on X Layer at block 71462665** (public RPC, `balanceOf` + `eth_getBalance`), unchanged
+ since 2026-09-09: buyer `0x75d0…cf69` 0 USD₮0 / 0 OKB (nonce 1, EIP-7702 delegation code);
+ seller `0x4022de2D…f402` 2.427731 USD₮0 / 0.839596 OKB; relayer `0xe81DE501…415B` 0.02 OKB,
+ nonce 0 (never broadcast). Gas price 0.02 gwei.
+- **Funding need, from `okx-e2e-gauntlet.mjs --budget`:** one clean run settles $1.07 and needs
+ a starting float of **1.08 USD₮0**; the order's "times two for retries" makes it **2.16 USD₮0**
+ on X Layer to buyer `0x75d00a2713565171f33216e5aa2a375e076ecf69`, token
+ `0x779ded0c9e1022225f8e0630b35a9b54be713736`, chain 196. The buyer needs no OKB (EIP-3009,
+ relayer pays gas). Plus **0.02 USDC on Solana** to the buyer's Solana address for case 7
+ (read it with `onchainos wallet addresses` once logged in).
+
## Binding operating clause
1. Finish 100% of everything that does not move money. Never end with a question about scope,
@@ -109,7 +130,7 @@ iteration in PROGRESS.md; iterations are evidence of rigor.
| Blocker | Do this |
|---|---|
| Wallet not logged in | `onchainos wallet login [email protected] --locale en_US`, then include the OTP request in your single owner message. Never guess a code. |
-| The bot or daemon is offline | `npm run okx:bot` (`scripts/okx-bot-revive.mjs`) installs, starts and reports health. Exit 2 means staged but logged out. |
+| The bot or daemon is offline | Read the Cloud Run host, do not start a local one: `curl -s https://three.ws/api/healthz \| jq '.subsystems.subsystems[]\|select(.name=="okx_chat_bot")'`. `npm run okx:bot` starts a second writer on the bot's identity and refuses (exit 3) while the host beats. The chat bot is not on this order's path anyway. |
| A deploy is needed for a fix | Deploys are owner-gated. Prepare everything so the ship is one command, state it, and continue with what does not need it. |
| Catalog drift between module, live endpoint and listing | Fix the module first, then redeploy, then re-verify the live endpoint. The three copies must never diverge, even for one review cycle. |
| Settlement tx not found | The test is not passed. Find the tx or find the bug; never mark a 200 response as success. |
diff --git a/prompts/finish/914-okx-ai-07-final-audit-and-watch.md b/prompts/finish/914-okx-ai-07-final-audit-and-watch.md
index 7b94377ba..ecf88e68b 100644
--- a/prompts/finish/914-okx-ai-07-final-audit-and-watch.md
+++ b/prompts/finish/914-okx-ai-07-final-audit-and-watch.md
@@ -13,6 +13,26 @@ Read `prompts/finish/_context/okx-ai-00-CONTEXT.md`, all of `prompts/finish/_con
3. CLAUDE.md hard rules: no mocks, no TODO comments, no em-dash or en-dash characters. Stage
explicit paths only.
+## State on 2026-09-24, re-measured
+
+- **Part 1:** item 1 PASS (four paid rows 402, spec-valid, OKX SDK parse PASS 20 probes).
+ Items 2 and 3 blocked on a funded buyer and a session. Item 4 PASS on the three local copies,
+ on-chain copy unreadable without a session. Item 5: the stream's files carried 16 legacy
+ em-dashes in `tests/api/okx-identity-studio.test.js` and `tests/api/okx-3d-services.test.js`,
+ now removed; no TODOs, no stubs, repo root clean. Item 6: `npm run build:pages` exit 0 (952
+ pages); `npm run audit:docs` has 5 findings, all README-less directories outside this stream
+ (`packages/agent-cli`, `packages/agents-sdk`, `packages/mcp-policy`, `packages/three-ws-cli`,
+ `workers/signal-bridge`, all added by other features on 2026-09-22); `npm test` had 30 failing
+ files, of which the forge lane suites (18 tests, a stale `forge-store.js` mock) and
+ `mcp-3d-challenge` (two unclassified tools) touched this stream's path and were fixed
+ (`9acf0cba2`, `bfeca3aa1`). The rest are outside it.
+- **Part 2:** unchanged since 2026-09-10 and re-checked: the doc's curls answer as documented,
+ `docs/okx-marketplace.md` is linked from `docs/start-here.md`, and its "Verified behavior"
+ section still matches production (no settlement claimed).
+- **Part 3:** approval status could NOT be read (onchainos v4.6.2 installed, `loggedIn: false`,
+ every agent read needs the session). No branch executed. RUNBOOK §0.5 and the CLI version line
+ were corrected.
+
## Part 1: independent adversarial audit (against production, today)
1. Unpaid 402 on the cheapest and the flagship endpoints, still spec-valid. Challenges drift
@@ -82,7 +102,7 @@ current watch status. Update `MEMORY.md`.
| Blocker | Do this |
|---|---|
-| The bot is offline | `npm run okx:bot`. Exit 0 means online, exit 2 means staged but logged out (login URL printed). |
+| The bot is offline | Read the Cloud Run host (`curl -s https://three.ws/api/healthz \| jq '.subsystems.subsystems[]\|select(.name=="okx_chat_bot")'`); fixes ship with `npm run okx:bot:deploy` (owner-gated). Never `npm run okx:bot` while that host beats: it is a second writer on the bot's identity. |
| Wallet dry or logged out | One batched owner message with the funding table and the OTP request. Everything else proceeds without it. |
| A doc claim cannot be reproduced | That is a defect in the doc, not in your test. Correct the doc in the same session. |
| A deploy would be needed to fix a live string | Deploys are owner-gated. Prepare it as one command, say so, and finish everything else. |
diff --git a/prompts/finish/_context/backlog-00-INDEX.md b/prompts/finish/_context/backlog-00-INDEX.md
index 49fa5ce84..217574a48 100644
--- a/prompts/finish/_context/backlog-00-INDEX.md
+++ b/prompts/finish/_context/backlog-00-INDEX.md
@@ -43,7 +43,7 @@ observable health, so 01 to 03 come first.
| 01 | [x402 settle: clear `fee_runway_exhausted`](../902-backlog-01-x402-settle-runway.md) | **the deploy landed 2026-09-08**; one capital decision left (re-measured 2026-09-09 third pass: `fee_runway_exhausted` is gone, the sponsor is 0.000842 SOL under its floor, and the outage hint has been corrected to name the right mechanism) | pick one: release the **0.0558 SOL the platform already owns** but has fenced behind `pump-x402-launcher`'s 0.1 SOL `minSol`, or send SOL to the economy master. Either moves funds, so either is gate 1 |
| 05 | R2 bucket CORS (retired 2026-09-10, order deleted) | **DONE, and no credential was ever minted** | The `S3_*` pair resolved off the Cloud Run service is admin-scoped, so `Get`/`PutBucketCors` both work with it. Canonical split policy applied: `public-read` world-open for GET/HEAD, `browser-upload` origin-locked for PUT. `node scripts/set-r2-cors.mjs --probe` exits 0 with all nine origins matching. Every prior pass filed this as owner-gated on the finding that the only reachable token was object-scoped; that finding was wrong |
| 07 | [BNB testnet: deploy the two finished contracts](../910-backlog-07-bnb-testnet-deploys.md) | one funded EOA | send tBNB to `0x1C4918894dfA5eE11cfF9629B458b5169Cfa3871` (faucet is reCAPTCHA-gated) |
-| 08 | [OKX chat bot: move off the codespace](../907-backlog-08-okx-chat-bot-always-on.md) | **deployed 2026-09-04** and still beating (re-measured 2026-09-09 from `bot_heartbeat`, no `gcloud` needed); only the reply lane is blocked, and the AI-lane chain committed the same day has not shipped. `npm run okx:bot` now refuses to start a rival daemon while that host is beating (2026-09-09, after the order's own first instruction started one) | two: clear the GCP billing hold (it also restores the platform Vertex anchor, `LLM providers DOWN` x657), and deploy `workers/okx-chat-bot/cloudbuild.yaml` so a funded lane can actually be elected |
+| 08 | [OKX chat bot: move off the codespace](../907-backlog-08-okx-chat-bot-always-on.md) | **deployed 2026-09-04** and still beating (re-measured 2026-09-09 from `bot_heartbeat`, no `gcloud` needed); only the reply lane is blocked, and the AI-lane chain committed the same day has not shipped. `npm run okx:bot` now refuses to start a rival daemon while that host is beating (2026-09-09, after the order's own first instruction started one) | one (re-measured 2026-09-24): the API half is live (`c8f10f437` serves the agent-scoped proxy path), so what is left is installing and authenticating `gcloud` and running `npm run okx:bot:deploy`, which provisions the free gateway reply lane and ships the lease-aware worker. Clearing the GCP billing hold is optional now: it moves the bot back to Claude on Vertex by itself |
| 09 | [Telegram bots: durable hosting for both feeds](../908-backlog-09-telegram-bots-durability.md) | **done**; the firehose was found silently dead on 2026-09-09 (dead RPC), fixed and hardened the same day | clear the commit gate on its file update |
| 10 | [x402scan listing: finish the last three steps](../909-backlog-10-x402scan-listing.md) | **the deploy landed 2026-09-08**; only the origin registration is left (re-measured 2026-09-09) | one SIWX wallet signature at x402scan `/resources/register` for origin `https://three.ws`; no funds move |
diff --git a/prompts/finish/_context/okx-ai-PROGRESS.md b/prompts/finish/_context/okx-ai-PROGRESS.md
index 1c9bd7440..e0bd45b2f 100644
--- a/prompts/finish/_context/okx-ai-PROGRESS.md
+++ b/prompts/finish/_context/okx-ai-PROGRESS.md
@@ -4288,3 +4288,60 @@ npm run okx:bot:deploy # bot: provision lane,
npm run okx:bot:gateway -- --verify --cli # prove the real CLI through the lane on production
curl -s https://three.ws/api/healthz | jq '.subsystems.subsystems[]|select(.name=="okx_chat_bot")'
```
+
+## 2026-09-24 | orders 907, 911, 913, 914 | re-measured end to end; nothing on-chain, nothing paid, nothing deployed
+
+One session ran all four open orders' Step 0 against production. Standing constraints for this
+session, set by the owner's instruction and binding over the orders: no payment, no signature
+of any kind (including the `--no-spend` authorizations), no on-chain listing write, no OTP, no
+deploy, no push, and no commit of any file that names OKX until the owner approves it.
+
+**907, chat bot.** The API half shipped: live API `c8f10f437` (`three-ws-api-00458-njs`)
+contains `53687d994`, `d3074c1c8` and `f7f7da9b6`, and the agent-scoped path answers
+`404 agent not found` instead of `No API route matches`. The bot host is unchanged:
+`okx-chat-bot-00001-926`, beat 20 s old, `loggedIn: true`, `activeClients: 1`,
+`daemonRestarts: 0`, instance rebooted 2026-09-22T13:44Z, no `providerLane` or `leaseHolder` in
+the beat, Vertex still `403 Lightning dunning decision is deny`. `npm run okx:bot:deploy --
+--dry-run` passes its live-API check and stops on `gcloud`, which is not installed here at all.
+One owner step left: install and authenticate `gcloud`, then `npm run okx:bot:deploy`.
+
+**911, relisting.** Step 0 PASS (seven forge/free rows listed, nine unlisted). Step 1 PASS:
+four paid rows 402 with `accepts[0]` `exact`/`eip155:196` at 10000/50000/250000/250000, one entry
+per rail and asset, free rows free, compliance probe PASS 20 with OKX's own parser, three local
+copies identical, OKX suites 228/228. Steps 2 and 3 need the session: `onchainos` v4.6.2 was
+installed from the release binary (sha256 matches the release `checksums.txt`; the release has
+no `installer-checksums.txt`), and every agent read answers `session expired`.
+
+**913, real payment.** Every unsigned leg green: `--dry-run` 3/3 (cases 1, 1d, 5d). Its captures
+overwrote three committed evidence files with a narrower record, so they were restored from
+git and the 2026-09-09 `--no-spend` evidence stands. `/api/okx/3d/health` now carries
+`relayer_funded: true` (the `4e9ad0419` field is live). X Layer at block 71462665: buyer
+`0x75d0…cf69` 0 USD₮0 / 0 OKB, seller `0x4022de2D…f402` 2.427731 USD₮0 / 0.839596 OKB, relayer
+`0xe81DE501…415B` 0.02 OKB with nonce 0. The seller balance has not moved since 2026-09-09, so
+no sale has settled on this rail since then. `--budget`: a clean run needs 1.08 USD₮0; with
+the order's retry margin, 2.16 USD₮0 to the buyer on X Layer, plus 0.02 USDC on Solana for
+case 7.
+
+**914, audit.** Findings fixed: 16 legacy em-dashes in the two OKX test suites; the forge lane
+tests broken by a stale `forge-store.js` mock (`9acf0cba2`, 18 tests); two unclassified studio
+tools (`bfeca3aa1`). RUNBOOK §0.5 retitled so it no longer leads with the rival-daemon
+command, with today's host state and `npm run okx:bot:deploy` as the ship path; CLI version line
+updated. The 913 and 914 "never blocked" rows that still said `npm run okx:bot` now say to read
+the Cloud Run host. Not fixed, outside this stream: 5 README-less directories flagged by
+`audit:docs`, and about 25 failing test files unrelated to OKX. Approval status of #2632 was
+not readable; the last reading is still 2026-09-09's `Listing rejected`.
+
+**Owner actions, in order:**
+1. Approve committing the uncommitted OKX-naming files from this session and the earlier ones.
+2. Install and authenticate `gcloud`, then `npm run okx:bot:deploy` (preview with `-- --dry-run`).
+3. Browser login for `[email protected]` (`onchainos wallet login --phase init`, open the URL,
+ enter the emailed code), then run 911 Steps 2 and 3. That gives an on-chain
+ `agent update --agent-id 2632` replacing the seven stored rows' descriptions, then
+ `agent activate --agent-id 2632 --preferred-language en-US`, confirmed by the owner on the
+ diff card.
+4. Fund buyer `0x75d00a2713565171f33216e5aa2a375e076ecf69` with 2.16 USD₮0
+ (`0x779ded0c9e1022225f8e0630b35a9b54be713736`) on X Layer (chain 196), plus 0.02 USDC on
+ Solana to the buyer's Solana address, then approve the 913 gauntlet
+ (`npm run okx:gauntlet -- --yes`), which settles 1.07 USD₮0 on X Layer to seller
+ `0x4022de2D36C334E73C7a108805Cea11C0564f402` (cases 2, 2b, 3, 3i, 3r, 5a) and 0.01 USDC on
+ Solana to the Solana payTo `wwwwwDxFWRn7grgr3Esrsg5C6NvDoDHSA4gaCffccrU` (case 7).
diff --git a/prompts/finish/_context/okx-ai-RUNBOOK.md b/prompts/finish/_context/okx-ai-RUNBOOK.md
index 99cd65679..41db6236c 100644
--- a/prompts/finish/_context/okx-ai-RUNBOOK.md
+++ b/prompts/finish/_context/okx-ai-RUNBOOK.md
@@ -7,8 +7,10 @@ human or agent: every command below was run from this repo and its real output r
- **Full history:** [`okx-ai-PROGRESS.md`](okx-ai-PROGRESS.md).
- **Public docs:** [`docs/okx-marketplace.md`](../../docs/okx-marketplace.md), [`specs/okx-agent-payments.md`](../../specs/okx-agent-payments.md).
-**CLI:** `onchainos` at `~/.local/bin/onchainos` (v4.5.2 as of 2026-09-02; check drift with
-`onchainos --version`). Almost everything here needs an authenticated session as
+**CLI:** `onchainos` at `~/.local/bin/onchainos` (v4.6.2 as of 2026-09-24, installed from the
+`okx/onchainos-skills` release binary and checked against that release's `checksums.txt`; the
+release publishes no `installer-checksums.txt`, so the installer script cannot be verified and
+the binary route is the one to use; check drift with `onchainos --version`). Almost everything here needs an authenticated session as
`[email protected]`: every **write** (update, activate, resubmit) and, as of v4.3.0, the
**reads** too (see the note after the login block). **Login mechanics
changed as of v4.3.0** (older sessions in `okx-ai-PROGRESS.md` describe a direct `wallet login
@@ -47,8 +49,19 @@ Only `curl` against our own `/api/okx/3d/*` endpoints (§7), public RPC reads, a
---
-## 0.5 The chat bot goes offline on its own: `npm run okx:bot`
-
+## 0.5 The chat bot: read the Cloud Run host, never start a local daemon
+
+> **State on 2026-09-24.** Cloud Run `okx-chat-bot-00001-926` is still the only host: its
+> `bot_heartbeat` row was 20 s old, `loggedIn: true`, `activeClients: 1`, `daemonRestarts: 0`,
+> instance booted 2026-09-22. It still has no `providerLane` in its beat, so it is the pre-lane
+> code pinned to Vertex, which answers `Lightning dunning decision is deny`: chat arrives and no
+> reply is authored. The API half of the fix is LIVE (`c8f10f437` contains `53687d994` and
+> `d3074c1c8`; the agent-scoped path answers `agent not found` instead of `no API route
+> matches`). What remains is the bot deploy, `npm run okx:bot:deploy` (preview with
+> `-- --dry-run`), which needs an authenticated `gcloud` and is owner-gated. It replaces the
+> bare `gcloud builds submit` further down this section: it also provisions the metering lane
+> and waits for the new revision to take the single-writer lease.
+>
> **Read this first, 2026-09-09.** The bot is NOT local any more. It runs on Cloud Run
> (`okx-chat-bot`, up since 2026-09-04) and that host owns the GCS state object and the XMTP
> identity, with `--max-instances=1` enforcing exactly one writer. **Running `npm run okx:bot`
diff --git a/public/changelog-recent.json b/public/changelog-recent.json
index 41434686f..f8d2a38e3 100644
--- a/public/changelog-recent.json
+++ b/public/changelog-recent.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-09-24T07:05:41.510Z",
+ "generated_at": "2026-09-24T07:08:16.190Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
diff --git a/public/changelog.json b/public/changelog.json
index 809b7fea3..b55197fd5 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-09-24T07:05:41.482Z",
+ "generated_at": "2026-09-24T07:08:16.161Z",
"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 157adabb4..c38bca61c 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-09-24T07:05:41.465Z",
+ "generated_at": "2026-09-24T07:08:16.143Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
diff --git a/tests/api/okx-3d-services.test.js b/tests/api/okx-3d-services.test.js
index 1747733f0..113b22f01 100644
--- a/tests/api/okx-3d-services.test.js
+++ b/tests/api/okx-3d-services.test.js
@@ -1,5 +1,5 @@
/**
- * Work order 03 — the decomposed 3D studio on OKX.AI
+ * Work order 03: the decomposed 3D studio on OKX.AI
* (/api/okx/3d/<service>, catalog rows in api/_lib/okx-catalog.js, engines in
* api/_okx3d/rest-services.js).
*
@@ -53,7 +53,7 @@ vi.mock('../../api/_lib/x402/payment-identifier-server.js', () => ({
}));
// Payment verification/settlement are exercised against the live rail in the
-// WO-04 gauntlet; here they are seams — the suite asserts WHEN they run
+// WO-04 gauntlet; here they are seams: the suite asserts WHEN they run
// (verify before engine, settle only after success), not chain mechanics.
const verifyPaymentMock = vi.fn();
const settlePaymentMock = vi.fn();
@@ -183,7 +183,7 @@ function makeReq({ method = 'POST', service, headers = {}, body = null } = {}) {
const decode402Header = (res) =>
JSON.parse(Buffer.from(res.headers['payment-required'], 'base64').toString('utf8'));
-describe('okx catalog — work order 03 rows', () => {
+describe('okx catalog, work order 03 rows', () => {
it('all eight decomposed services exist at the work-order price points', () => {
expect(validateCatalog()).toBe(true);
const prices = Object.fromEntries(
@@ -348,7 +348,7 @@ describe('per-service 402 (unpaid POST)', () => {
});
});
-describe('paid dispatch — verify → engine → settle', () => {
+describe('paid dispatch: verify → engine → settle', () => {
function paidReq(service, body) {
return makeReq({ service, body, headers: { 'payment-signature': 'c2ln' } });
}
@@ -430,7 +430,7 @@ describe('paid dispatch — verify → engine → settle', () => {
expect(settlePaymentMock).toHaveBeenCalledTimes(1);
});
- it('pose-seed resolves deterministically in-process — same prompt, same seed, real engine', async () => {
+ it('pose-seed resolves deterministically in-process: same prompt, same seed, real engine', async () => {
const res1 = makeRes();
await handler(paidReq('pose-seed', VALID_INPUT['pose-seed']), res1);
expect(res1.statusCode).toBe(200);
diff --git a/tests/api/okx-identity-studio.test.js b/tests/api/okx-identity-studio.test.js
index ad3e022bb..8773c9b55 100644
--- a/tests/api/okx-identity-studio.test.js
+++ b/tests/api/okx-identity-studio.test.js
@@ -1,5 +1,5 @@
/**
- * Agent Identity Studio — the OKX.AI flagship A2MCP service
+ * Agent Identity Studio: the OKX.AI flagship A2MCP service
* (/api/okx/3d/identity-studio, engine in api/_okx3d/identity.js, catalog row
* in api/_lib/okx-catalog.js).
*
@@ -16,7 +16,7 @@ import { encodeAbiParameters, parseAbiParameters } from 'viem';
process.env.PUBLIC_APP_ORIGIN = 'https://three.ws';
process.env.X402_PAY_TO_BASE ||= '0x0000000000000000000000000000000000000001';
process.env.X402_ASSET_ADDRESS_BASE ||= '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
-// The OKX X Layer rail — the reason this service exists on OKX.AI. With these
+// The OKX X Layer rail, the reason this service exists on OKX.AI. With these
// set, xlayerSettleable() is true and the flagship 402 must lead with eip155:196.
process.env.X402_PAY_TO_XLAYER ||= '0x75d00a2713565171f33216e5aa2a375e076ecf69';
process.env.X402_XLAYER_RELAYER_KEY ||=
@@ -71,7 +71,7 @@ vi.mock('../../api/_lib/r2.js', () => ({
publicUrl: (key) => `https://cdn.test/${key}`,
}));
-// Reference-image validation calls the real SSRF guard's public-URL check —
+// Reference-image validation calls the real SSRF guard's public-URL check;
// stub it to a pass-through so tests control reachability via fetch alone.
// fetchSafePublicUrlPinned is routed through the fetch router for the same
// reason (the pinned variant opens raw sockets, which the sandbox has no
@@ -92,7 +92,7 @@ vi.mock('../../api/_lib/llm.js', () => ({
llmSpy.fn ? llmSpy.fn(...args) : Promise.reject(new Error('llm unavailable')),
}));
-// The pipeline is a pure HTTP client over three.ws surfaces — mock global
+// The pipeline is a pure HTTP client over three.ws surfaces, so mock global
// fetch with a tiny programmable router.
const fetchRoutes = {
chat: null,
@@ -357,7 +357,7 @@ describe('free lanes over HTTP', () => {
expect(rail.relayer_error).toBeTruthy();
});
- it('GET /health goes 503 when a subsystem is down — never a hardcoded ok', async () => {
+ it('GET /health goes 503 when a subsystem is down, never a hardcoded ok', async () => {
fetchRoutes.render = () => new Response(null, { status: 500 });
fetchRoutes.forgeSubmit = () => jsonResponse(200, FORGE_CATALOG);
const res = makeRes();
@@ -433,7 +433,7 @@ describe('free lanes over HTTP', () => {
});
// The generation probe used to GET /api/forge bare, which answers 400
- // missing_job whether the lane is healthy or not — it only failed on a 5xx.
+ // missing_job whether the lane is healthy or not; it only failed on a 5xx.
// It now reads ?catalog and requires a real tier + backend matrix.
it('GET /health fails generation on an empty forge catalog, not just on a 5xx', async () => {
fetchRoutes.forgeSubmit = (u) => {
@@ -503,7 +503,7 @@ describe('402 challenge and pricing', () => {
expect(JSON.stringify(challenge)).toContain('identity-studio');
});
- it('the 402 LEADS with the OKX X Layer (eip155:196) accept — the flagship must be OKX-payable', async () => {
+ it('the 402 LEADS with the OKX X Layer (eip155:196) accept: the flagship must be OKX-payable', async () => {
const res = makeRes();
await handler(
makeReq({
@@ -530,7 +530,7 @@ describe('402 challenge and pricing', () => {
// The 402 envelope is how a buying agent learns to call this server. It used
// to inherit build402Body's default bazaar entry, which describes the main
- // /api/mcp server and told buyers to call validate_model — a tool this
+ // /api/mcp server and told buyers to call validate_model, a tool this
// dispatcher does not have, so an agent that followed it paid $1.50 and then
// sent a call that could only be rejected.
it('the 402 bazaar extension describes THIS server: create_identity, never validate_model', async () => {
@@ -633,7 +633,7 @@ describe('402 challenge and pricing', () => {
expect(challenge.accepts[0].amount).toBe('1500000');
});
- it('identity_status is free — served anonymously, no 402', async () => {
+ it('identity_status is free, served anonymously, no 402', async () => {
const res = makeRes();
await handler(
makeReq({
@@ -648,7 +648,7 @@ describe('402 challenge and pricing', () => {
);
expect(res.statusCode).toBe(200);
const rpc = JSON.parse(res.body);
- expect(rpc.result.isError).toBe(true); // invalid token — but no payment demanded
+ expect(rpc.result.isError).toBe(true); // invalid token, but no payment demanded
expect(rpc.result.structuredContent.error).toBe('invalid_job_id');
});
@@ -754,7 +754,7 @@ describe('pipeline state machine', () => {
const status = await call('identity_status', { job_id: created.result.structuredContent.job_id });
const sc = status.result.structuredContent;
expect(sc.directed).toBe(true);
- // First line only, surrounding quotes stripped — no fallback scaffolding.
+ // First line only, surrounding quotes stripped, no fallback scaffolding.
expect(sc.prompt).toBe(shaped);
expect(sc.prompt).not.toContain('full-body humanoid character:');
});