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
#!/usr/bin/env node
/**
* Guard the vendored worker modules.
*
* Each worker's Docker build context is its own directory, so `../` is
* unreachable and shared code lives as a byte-identical copy in every worker
* that needs it (worker_security.py, oin.py, gltf_meshopt.py and their vendored
* tests). Nothing enforced that, so a fix applied to one copy could silently
* leave the other seventeen on the old behaviour: the exact shape of bug this
* repo has already paid for once.
*
* This compares every copy of every vendored file against the copy with the
* most instances (the de-facto canonical one) and fails on any divergence,
* naming the file, the workers that differ, and how to resync them.
*
* node scripts/check-vendored-workers.mjs
*/
import { readFileSync, readdirSync, statSync } from 'node:fs';
import { createHash } from 'node:crypto';
import { join } from 'node:path';
// Files that MUST be identical wherever they appear under workers/.
const VENDORED = [
'worker_security.py',
'oin.py',
'oin_upload.py',
'gltf_meshopt.py',
'test_gltf_meshopt.py',
];
const WORKERS_DIR = 'workers';
function digest(path) {
return createHash('sha256').update(readFileSync(path)).digest('hex');
}
function workerDirs() {
return readdirSync(WORKERS_DIR)
.filter((name) => {
try {
return statSync(join(WORKERS_DIR, name)).isDirectory();
} catch {
return false;
}
})
.sort();
}
const dirs = workerDirs();
const failures = [];
let checked = 0;
for (const file of VENDORED) {
const copies = [];
for (const dir of dirs) {
const path = join(WORKERS_DIR, dir, file);
try {
statSync(path);
} catch {
continue;
}
copies.push({ dir, path, sha: digest(path) });
}
if (copies.length < 2) continue;
checked += copies.length;
const counts = new Map();
for (const copy of copies) counts.set(copy.sha, (counts.get(copy.sha) || 0) + 1);
const [canonicalSha] = [...counts.entries()].sort((a, b) => b[1] - a[1])[0];
const canonical = copies.find((c) => c.sha === canonicalSha);
const drifted = copies.filter((c) => c.sha !== canonicalSha);
if (drifted.length) {
failures.push(
`${file}: ${drifted.length} of ${copies.length} copies differ from ${canonical.path}\n` +
drifted.map((c) => ` ${c.path} (resync: cp ${canonical.path} ${c.path})`).join('\n'),
);
}
}
// gltf_meshopt.py shells out to a `gltfpack` binary on PATH (see its
// GLTFPACK_BIN constant). A worker that vendors the module but never stages
// the binary in its Dockerfile passes the build-time unit test (which mocks
// nothing, but also never feeds it meshopt-compressed input) and then fails
// every real meshopt-compressed request at runtime with "the gltfpack
// decoder is not installed". Catch that gap here instead of in production.
const missingGltfpack = [];
for (const dir of dirs) {
const modulePath = join(WORKERS_DIR, dir, 'gltf_meshopt.py');
try {
statSync(modulePath);
} catch {
continue;
}
const dockerfilePath = join(WORKERS_DIR, dir, 'Dockerfile');
let dockerfile;
try {
dockerfile = readFileSync(dockerfilePath, 'utf8');
} catch {
missingGltfpack.push(`${dir}: vendors gltf_meshopt.py but has no Dockerfile at ${dockerfilePath}`);
continue;
}
if (!dockerfile.includes('COPY --from=gltfpack')) {
missingGltfpack.push(
`${dir}: vendors gltf_meshopt.py but ${dockerfilePath} never stages the gltfpack binary ` +
`(no "COPY --from=gltfpack" line; see workers/segment/Dockerfile for the pattern)`,
);
}
}
if (failures.length || missingGltfpack.length) {
if (failures.length) {
console.error('[check-vendored-workers] vendored worker files have drifted:\n');
for (const failure of failures) console.error(` ${failure}\n`);
console.error('Fix the canonical copy, mirror it to every worker, and rerun.');
}
if (missingGltfpack.length) {
console.error('[check-vendored-workers] gltf_meshopt.py is vendored without its gltfpack binary:\n');
for (const failure of missingGltfpack) console.error(` ${failure}\n`);
}
process.exit(1);
}
console.log(
`[check-vendored-workers] OK: ${checked} vendored file copies across ${dirs.length} workers are byte-identical, ` +
'and every worker that vendors gltf_meshopt.py stages the gltfpack binary',
);