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
// The ChatGPT-dedicated forge pipeline clone — isolation contract.
//
// /api/gpt-forge (api/gpt-forge.js) is an exact clone of /api/forge created so
// the ChatGPT surfaces (the Apps SDK MCP connector and the custom-GPT Actions
// endpoint) can be improved independently without touching the forge pipeline
// or any surface that rides it. These tests pin the wiring both ways:
//
// 1. The clone client (gpt-forge-client.js) talks ONLY to /api/gpt-forge.
// 2. The ChatGPT surfaces import the clone client; the agent surfaces keep
// the original. Neither side silently re-couples to the other.
// 3. The clone's public API is a SUPERSET of the original's, so anything
// written against forge-client keeps working on the ChatGPT clone. The
// clone may ADD exports (that is what "evolve independently" means); it
// must never DROP one.
// 4. The cloned orchestrator actually serves: its public catalog is the
// SAME contract /api/forge serves (both read api/_lib/forge-tiers.js).
//
// Deliberately NOT pinned: byte-parity between api/forge.js and
// api/gpt-forge.js. The clone exists to diverge; the moment it does, parity
// would be a false failure. What must never drift is the wiring above.
import { describe, it, expect, beforeAll } from 'vitest';
import { readFileSync } from 'node:fs';
import path from 'node:path';
const ROOT = path.resolve(__dirname, '../..');
const read = (p) => readFileSync(path.join(ROOT, p), 'utf8');
beforeAll(() => {
Object.assign(process.env, {
APP_ORIGIN: 'https://three.ws',
JWT_SECRET: 'test-jwt-secret-at-least-32-characters-long',
});
});
describe('gpt-forge-client — endpoint isolation', () => {
it('every fetch targets /api/gpt-forge, never /api/forge', () => {
const src = read('api/_mcp-studio/gpt-forge-client.js');
const fetches = src.match(/fetch\(`[^`]+`/g) || [];
expect(fetches.length).toBeGreaterThanOrEqual(3); // submit, rig, poll
for (const f of fetches) {
expect(f).toContain('/api/gpt-forge');
expect(f).not.toMatch(/\/api\/forge[?`]/);
}
});
it('exposes at least the same public API as forge-client', async () => {
const orig = await import('../../api/_mcp-studio/forge-client.js');
const clone = await import('../../api/_mcp-studio/gpt-forge-client.js');
const cloneKeys = new Set(Object.keys(clone));
// Every original export survives on the clone: a tool written against
// forge-client runs unchanged against the ChatGPT pipeline.
for (const key of Object.keys(orig)) expect(cloneKeys.has(key)).toBe(true);
// Same shape for each shared export (all functions today): a name that
// survives as a different KIND of thing would break callers just as hard.
for (const key of Object.keys(orig)) expect(typeof clone[key]).toBe(typeof orig[key]);
});
it('ChatGPT-only additions are exported as callable functions', async () => {
const orig = await import('../../api/_mcp-studio/forge-client.js');
const clone = await import('../../api/_mcp-studio/gpt-forge-client.js');
const added = Object.keys(clone).filter((k) => !(k in orig));
// pollOnce backs the check_job tool: a single status probe with no loop,
// the collector for a generation that outlived a tool call's inline wait.
expect(added).toContain('pollOnce');
for (const key of added) expect(typeof clone[key]).toBe('function');
});
});
describe('surface wiring — ChatGPT on the clone, agents on the original', () => {
const CHATGPT_SURFACES = ['api/_mcp-studio/tools.js', 'api/3d/studio.js'];
const AGENT_SURFACES = ['api/3d/generate.js', 'api/v1/ai/text-to-3d.js'];
it.each(CHATGPT_SURFACES)('%s imports gpt-forge-client', (file) => {
const src = read(file);
expect(src).toMatch(/from '[^']*gpt-forge-client\.js'/);
expect(src).not.toMatch(/from '[^']*\/forge-client\.js'/);
});
it.each(AGENT_SURFACES)('%s stays on the original forge-client', (file) => {
const src = read(file);
expect(src).toMatch(/from '[^']*_mcp-studio\/forge-client\.js'/);
expect(src).not.toMatch(/gpt-forge-client/);
});
});
describe('gpt-forge divergences — ChatGPT-side improvements stay in place', () => {
it('poll metadata surfaces the painted concept view (preview_image_url) to the ChatGPT surfaces', () => {
const src = read('api/gpt-forge.js');
const metaBlock = src.slice(src.indexOf('const metaFields'), src.indexOf('const metaFields') + 900);
expect(metaBlock).toContain('preview_image_url');
expect(metaBlock).toContain('text_to_image_model');
});
});
describe('/api/gpt-forge — the cloned orchestrator serves', () => {
function makeReq(url) {
return { method: 'GET', url, headers: {} };
}
function makeRes() {
const res = {
statusCode: 0,
headers: {},
body: null,
setHeader(k, v) {
this.headers[k.toLowerCase()] = v;
},
end(payload) {
this.body = payload ? JSON.parse(payload) : null;
this.done = true;
},
};
res.writeHead = (code) => {
res.statusCode = code;
return res;
};
return res;
}
it('answers ?catalog with the same tier/backend contract as /api/forge', async () => {
const { default: forge } = await import('../../api/forge.js');
const { default: gptForge } = await import('../../api/gpt-forge.js');
const a = makeRes();
await forge(makeReq('/api/forge?catalog=1'), a);
const b = makeRes();
await gptForge(makeReq('/api/gpt-forge?catalog=1'), b);
expect(b.statusCode).toBe(a.statusCode);
expect(a.statusCode).toBe(200);
expect(b.body).toEqual(a.body);
expect(Array.isArray(b.body.backends)).toBe(true);
expect(b.body.tiers.map((t) => t.id)).toEqual(['draft', 'standard', 'high']);
});
});