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
// agent-gateway: the process behind every three.ws chat gateway.
//
// The webhook receivers (api/gateway/telegram.js, api/gateway/discord.js) verify
// each delivery and queue it in gateway_inbox; notifications for paired chats
// are queued there too (api/_lib/gateway/notify.js). This worker drains that
// inbox: it claims rows one chat at a time under a lease, runs each through the
// shared gateway core with the platform's adapter, and acknowledges, retries
// with backoff, or dead-letters it. It also holds the Discord gateway connection
// (DMs and mentions), expires stale trade previews and prunes finished rows.
//
// Cloud Run runs it as an always-on service (no CPU throttling, one instance is
// enough; more are safe because the claim is exclusive). GET /healthz reports
// the loop, the adapters and the counters. SIGTERM stops claiming, lets running
// rows finish within the grace period, and closes the platform connections.
//
// Local: npm run dev (loads ../../.env and ../../.env.local). README.md has the
// env vars and the deploy command.
import http from 'node:http';
import { enqueueInbox, inboxBacklog } from '../../../api/_lib/gateway/store.js';
import { loadConfig } from './config.js';
import { loadAdapters } from './adapters/index.js';
import { createDrainer } from './drain.js';
import { errorSummary } from './errors.js';
import { log } from './log.js';
function startHealthServer({ port, drainer, adapters, skipped }) {
const server = http.createServer(async (req, res) => {
const path = new URL(req.url, 'http://localhost').pathname;
if (req.method !== 'GET' || (path !== '/' && path !== '/healthz')) {
res.writeHead(404, { 'content-type': 'application/json' });
res.end(JSON.stringify({ error: 'not_found' }));
return;
}
const h = drainer.health();
const backlog = await inboxBacklog().catch(() => null);
const body = {
...h,
ok: h.ok && adapters.size > 0,
adapters: Object.fromEntries([...adapters].map(([p, a]) => [p, a.describe ? a.describe() : {}])),
skipped,
backlog,
};
res.writeHead(body.ok ? 200 : 503, { 'content-type': 'application/json', 'cache-control': 'no-store' });
res.end(JSON.stringify(body));
});
server.listen(port, () => log.info('health endpoint listening', { port }));
return server;
}
async function main() {
const config = loadConfig();
const { adapters, skipped } = loadAdapters({ config, log });
for (const s of skipped) log.warn('adapter not loaded', s);
if (!adapters.size) log.error('no chat platform is configured; set TELEGRAM_BOT_TOKEN and/or DISCORD_BOT_TOKEN + DISCORD_APP_ID');
const drainer = createDrainer({ adapters, config, log });
const server = startHealthServer({ port: config.port, drainer, adapters, skipped });
const enqueue = async (delivery) => {
const fresh = await enqueueInbox(delivery);
log.debug('inbound delivery queued', { platform: delivery.platform, fresh });
return fresh;
};
for (const [platform, adapter] of adapters) {
if (typeof adapter.start !== 'function') continue;
try {
await adapter.start({ enqueue });
} catch (e) {
log.error('adapter listener failed to start; queued deliveries still drain', { platform, ...errorSummary(e) });
}
}
log.info('agent gateway started', {
platforms: [...adapters.keys()],
concurrency: config.concurrency,
leaseSeconds: config.leaseSeconds,
maxAttempts: config.maxAttempts,
chatKeys: config.chatKeys,
});
drainer.start();
let shuttingDown = false;
const shutdown = async (signal) => {
if (shuttingDown) return;
shuttingDown = true;
log.info('shutdown requested', { signal, inflight: drainer.inflight.size });
const { abandoned } = await drainer.stop();
for (const [platform, adapter] of adapters) {
if (typeof adapter.stop === 'function') await adapter.stop().catch((e) => log.warn('adapter stop failed', { platform, ...errorSummary(e) }));
}
server.close();
log.info('agent gateway stopped', { abandoned });
process.exit(0);
};
process.on('SIGTERM', () => shutdown('SIGTERM'));
process.on('SIGINT', () => shutdown('SIGINT'));
}
process.on('unhandledRejection', (e) => log.error('unhandled rejection', errorSummary(e)));
main().catch((e) => {
log.error('agent gateway failed to start', errorSummary(e));
process.exit(1);
});