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
// QStash worker endpoint for async knowledge embedding.
//
// Called by QStash after _knowledge.ingestKnowledge() queues large docs.
// Verifies the inbound signature so only QStash (or replays of valid messages)
// can trigger processing. Reads the queued doc by ID, embeds its chunks,
// marks ready. Idempotent — safe to retry on transient failures.
import { wrap, json, error, method, readBody } from '../../_lib/http.js';
import { verifyQstashSignature, qstashEnabled } from '../../_lib/qstash.js';
import { processQueuedDoc } from './_knowledge.js';
import { env } from '../../_lib/env.js';
// Delegates to the shared readBody (api/_lib/http.js), which prefers the
// pre-parsed req.rawBody the Cloud Run server already captured pre-parse, so
// the QStash signature below checks the exact signed bytes — re-reading the
// raw stream here (as this function used to) hangs forever once Express has
// drained it.
async function readRawBody(req, limit = 1_000_000) {
return (await readBody(req, limit)).toString('utf8');
}
export default wrap(async (req, res) => {
if (!method(req, res, ['POST'])) return;
if (!qstashEnabled()) {
return error(res, 503, 'qstash_disabled', 'QStash not configured on this deployment');
}
const signature = req.headers['upstash-signature'];
const rawBody = await readRawBody(req).catch((err) => {
throw Object.assign(new Error(err?.message || 'body read failed'), {
status: err?.status || 400,
});
});
const widgetIdFromQuery = req.query?.id || '';
const verifyUrl = `${env.APP_ORIGIN}/api/widgets/${widgetIdFromQuery}/knowledge-process`;
try {
await verifyQstashSignature({ signature, body: rawBody, url: verifyUrl });
} catch (err) {
console.warn('[knowledge-process] signature verify failed:', err?.message);
return error(res, 401, 'invalid_signature', 'QStash signature verification failed');
}
let payload;
try {
payload = JSON.parse(rawBody || '{}');
} catch {
return error(res, 400, 'invalid_json', 'body must be JSON');
}
const docId = String(payload?.doc_id || '').trim();
const widgetId = String(payload?.widget_id || widgetIdFromQuery || '').trim();
if (!docId || !widgetId) {
return error(res, 400, 'invalid_request', 'doc_id and widget_id required');
}
try {
const result = await processQueuedDoc({ docId, widgetId });
return json(res, 200, { ok: true, ...result });
} catch (err) {
const status = err?.status || 500;
// Return 5xx so QStash retries with backoff. 4xx terminates retries.
const code = err?.code || 'process_failed';
console.error('[knowledge-process] failed', { docId, widgetId, err: err?.message });
return error(res, status, code, err?.message || 'processing failed');
}
});