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.

test(okx): pin the four-part listing description and the paid-retry wording

nirholas92a80e9d25d4
diff --git a/public/locales/en.json b/public/locales/en.json
index ed497eeb0..d70ccc293 100644
--- a/public/locales/en.json
+++ b/public/locales/en.json
@@ -15785,7 +15785,7 @@
"three_ws_3d_agent_identity_and_x402": "three.ws 3D agent identity and x402 payment rails integrate with IBM watsonx and IBM Granite. Agents run enterprise AI models while maintaining on-chain identity and executing real micropayments — all from a single agent profile.",
"three_ws_is_a_member_of_nvidia": "three.ws is a member of NVIDIA Inception, NVIDIA's program for startups building on accelerated computing. Every 3D generation lane already runs on NVIDIA silicon: text to 3D, photo to avatar, auto-rigging, and motion capture, plus the free hosted NIM lane behind the forge.",
"three_ws_is_a_member_of_the": "three.ws is a member of the Quicknode Startup Program with approved infrastructure credits. Quicknode's globally distributed RPC endpoints add capacity and redundancy to the chain access behind agent wallets, x402 settlement verification, and live Solana market data.",
- "three_ws_is_an_openai_select_partner": "three.ws is an OpenAI Select Partner in the OpenAI Partner Network. The free three.ws 3D Studio connector gives ChatGPT nine keyless 3D tools: text to model, rigged avatars, conversational refinement, and a living agent body, all rendered interactively inline in the conversation.",
+ "three_ws_is_an_openai_select_partner": "three.ws is an OpenAI Select Partner in the OpenAI Partner Network. The free three.ws 3D Studio connector gives ChatGPT eleven keyless 3D tools: text to model, rigged avatars, conversational refinement, a look at the finished model from several angles, and a living agent body, all rendered interactively inline in the conversation.",
"three_ws_runs_on_and_integrates_with": "three.ws runs on and integrates with the leading cloud, AI, and hardware platforms — giving every agent enterprise-grade compute, identity, and reach.",
"vertex_ai": "Vertex AI",
"watsonx_ai": "watsonx.ai",
diff --git a/tests/api/okx-3d-services.test.js b/tests/api/okx-3d-services.test.js
index 248d49d44..41b942daa 100644
--- a/tests/api/okx-3d-services.test.js
+++ b/tests/api/okx-3d-services.test.js
@@ -118,8 +118,11 @@ const {
OKX_CATALOG,
catalogEntry,
catalogIndex,
+ displayWidth,
listedCatalog,
listingDescription,
+ parameterSpec,
+ requestMethod,
validateCatalog,
} = await import('../../api/_lib/okx-catalog.js');
const studioCatalog = await import('../../api/_mcp3d/catalog.js');
@@ -196,12 +199,64 @@ describe('okx catalog — work order 03 rows', () => {
expect(prices['fbx-export']).toEqual(['0.10', '100000']);
});
- it('every paid row routes /api/okx/3d/<id>, is POST-documented, and its listing description joins the two parts', () => {
+ it('every paid row routes /api/okx/3d/<id> and is POST-documented', () => {
for (const id of PAID_REST_IDS) {
const e = catalogEntry(id);
expect(e.endpoint).toBe(`https://three.ws/api/okx/3d/${id}`);
expect(e.inputSchema).toBeTruthy();
- expect(listingDescription(e)).toBe(`${e.describes.capability}\n${e.describes.input}`);
+ }
+ });
+
+ // OKX listing QA requires FOUR parts on an A2MCP service and rejects a
+ // listing missing any of them (`onchainos agent update --help`). Submitting
+ // two parts is what earned the 2026-09-02 rejection: "The service you
+ // submitted is missing a complete description, parameter details, and usage
+ // examples."
+ it('every listed row submits four parts: capability, parameters, method, example', () => {
+ for (const e of listedCatalog()) {
+ const parts = listingDescription(e).split('\n');
+ expect(parts, `${e.id} part count`).toHaveLength(4);
+ expect(parts[0], `${e.id} capability`).toBe(e.describes.capability);
+ expect(parts[1], `${e.id} parameters`).toBe(parameterSpec(e));
+ expect(parts[2], `${e.id} method`).toBe(requestMethod(e));
+ expect(parts[3], `${e.id} example`).toMatch(/^curl /);
+ expect(parts[3], `${e.id} example hits the real endpoint`).toContain(e.endpoint);
+ expect(displayWidth(listingDescription(e)), `${e.id} width`).toBeLessThanOrEqual(2000);
+ }
+ });
+
+ // Part 2 is generated from the schema, so it names every argument the
+ // endpoint accepts, with the type and required flag the endpoint enforces.
+ it('the parameter spec names every schema property with its real type and requiredness', () => {
+ for (const e of listedCatalog()) {
+ const props = Object.entries(e.inputSchema?.properties || {});
+ const spec = parameterSpec(e);
+ if (!props.length) {
+ expect(spec).toBe('No parameters. Send an empty request.');
+ continue;
+ }
+ const required = new Set(e.inputSchema.required || []);
+ for (const [name, prop] of props) {
+ const type = prop.type === 'array' ? `${prop.items?.type}[]` : prop.type;
+ expect(spec, `${e.id}.${name}`).toContain(
+ `${name} (${type}, ${required.has(name) ? 'required' : 'optional'}):`,
+ );
+ }
+ }
+ });
+
+ // A published usage example the endpoint would reject is worse than none:
+ // the buyer copies it, gets a 400, and leaves. Validate each example against
+ // the row's own schema with the same Ajv the endpoints use.
+ it('every listed usage example validates against its own endpoint schema', async () => {
+ const { default: Ajv } = await import('ajv');
+ const { default: addFormats } = await import('ajv-formats');
+ const ajv = addFormats(new Ajv({ strict: false }));
+ for (const e of listedCatalog()) {
+ if (!Object.keys(e.inputSchema?.properties || {}).length) continue;
+ const validate = ajv.compile(e.inputSchema);
+ const ok = validate(e.describes.example);
+ expect(ok, `${e.id} example: ${ajv.errorsText(validate.errors)}`).toBe(true);
}
});
diff --git a/workers/okx-chat-bot/config.js b/workers/okx-chat-bot/config.js
index bf3d6444c..41311e9a9 100644
--- a/workers/okx-chat-bot/config.js
+++ b/workers/okx-chat-bot/config.js
@@ -4,6 +4,7 @@
// VM, and locally with no code change. The defaults are the production posture:
// state persisted to GCS, heartbeat on, session probed every minute.
+import { existsSync } from 'node:fs';
import { homedir, hostname } from 'node:os';
import { join } from 'node:path';
@@ -29,18 +30,31 @@ const num = (v, fallback) => {
* CLAUDE_CODE_OAUTH_TOKEN → claude
* OPENAI_API_KEY → codex
*
+ * A headless host is credentialed by env alone, but a developer host running the
+ * stopgap has no key at all: its claude CLI was logged in interactively and keeps
+ * the grant in ~/.claude/.credentials.json. Ignoring that file reports
+ * `ai_provider_uncredentialed` on a host whose adapter demonstrably authors
+ * replies, which is a false red, and a false red trains people to ignore the
+ * signal that this worker exists to raise.
+ *
* @param {NodeJS.ProcessEnv} env
+ * @param {string} [home] where the CLI keeps an interactive login
* @returns {{ provider: string, reason: string, credentialed: boolean }}
*/
-export function resolveProvider(env = process.env) {
+export function resolveProvider(env = process.env, home = env.OKX_BOT_HOME || homedir()) {
const pinned = (env.OKX_BOT_AI_PROVIDER || '').trim().toLowerCase();
- const hasClaude = !!(env.ANTHROPIC_API_KEY || env.CLAUDE_CODE_OAUTH_TOKEN);
+ const hasClaudeKey = !!(env.ANTHROPIC_API_KEY || env.CLAUDE_CODE_OAUTH_TOKEN);
+ const hasClaudeLogin = existsSync(join(home, '.claude', '.credentials.json'));
+ const hasClaude = hasClaudeKey || hasClaudeLogin;
const hasCodex = !!env.OPENAI_API_KEY;
if (pinned) {
const credentialed = pinned === 'claude' ? hasClaude : pinned === 'codex' ? hasCodex : true;
return { provider: pinned, reason: 'pinned by OKX_BOT_AI_PROVIDER', credentialed };
}
- if (hasClaude) return { provider: 'claude', reason: 'ANTHROPIC_API_KEY present', credentialed: true };
+ if (hasClaudeKey) return { provider: 'claude', reason: 'ANTHROPIC_API_KEY present', credentialed: true };
+ if (hasClaudeLogin) {
+ return { provider: 'claude', reason: 'claude CLI holds an interactive login', credentialed: true };
+ }
if (hasCodex) return { provider: 'codex', reason: 'OPENAI_API_KEY present (no Anthropic key)', credentialed: true };
return {
provider: 'claude',
@@ -77,13 +91,14 @@ export function resolveHost(env = process.env) {
}
export function loadConfig(env = process.env) {
- const provider = resolveProvider(env);
+ const home = env.OKX_BOT_HOME || homedir();
+ const provider = resolveProvider(env, home);
const host = resolveHost(env);
return {
// HOME for both CLIs. Everything durable lands under it:
// $home/.okx-agent-task/ daemon state, sqlite, XMTP db, AI workspace
// $home/.onchainos/ wallet keyring, session, machine identity
- home: env.OKX_BOT_HOME || homedir(),
+ home,
port: num(env.PORT, 0),
agentId: env.OKX_BOT_AGENT_ID || '2632',