Build and revise procedural 3D assets with your coding agent. Local MCP server, CLI and TypeScript engine with rendered review, editable source and GLB export.
JavaScript 3d3d-assets3d-modelingagent-skillsagent-toolsai-agentsasset-pipelinecligame-assetsglbgltfmcpmcp-servermodel-context-protocolprocedural-generationprocedural-modelingtext-to-3dthreejstypescript
import { mkdir, readFile, writeFile, readdir, rename } from 'node:fs/promises';
import { dirname, resolve, sep } from 'node:path';
import { randomUUID } from 'node:crypto';
import { pathToFileURL } from 'node:url';
import { assetPath, fetchPinnedFile, verifyArchive } from './mirror-core.mjs';
/** Reproducible public staging from the same sealed archive offered for download. */
export async function stageTroy({ site = resolve(import.meta.dirname, '..'), record, mirror, enabled = !['0','false'].includes(process.env.KILN_SITE_PACKS ?? '1') } = {}) {
if (!enabled) return { skipped: true };
record ??= JSON.parse(await readFile(resolve(site, 'src/data/troy-delivery.json'), 'utf8'));
if (!/^[a-z0-9-]+$/.test(record.release)) throw new Error('Invalid Troy release');
const file = await fetchPinnedFile(record, { mirror, cache: resolve(site, '.cache/troy') });
const { files, manifest } = verifyArchive(await readFile(file));
if (manifest.release !== record.release) throw new Error('Troy release differs from its archive');
if (!files['web/index.html']) throw new Error('Troy browser entry is missing');
const base = `/scene-packs/troy/${record.release}/`;
const target = resolve(site, 'public', base.slice(1));
const parent=dirname(target),history=resolve(site,'.cache/troy/staged-history');
await mkdir(parent,{recursive:true});
for(const entry of await readdir(parent,{withFileTypes:true})) {
if(entry.name===record.release)continue;
if(entry.isSymbolicLink()||!entry.isDirectory()||!/^[a-z0-9-]+$/.test(entry.name))throw new Error('Unexpected Troy staging entry');
const prior=resolve(parent,entry.name),preserved=resolve(history,entry.name+'-'+randomUUID());
if(!prior.startsWith(parent+sep)||!preserved.startsWith(history+sep))throw new Error('Troy staging path escaped its managed directory');
await mkdir(history,{recursive:true});
await rename(prior,preserved);
}
for (const [path, bytes] of Object.entries(files)) {
assetPath(path);
if (path.endsWith('/')) continue;
const destination = resolve(target, path);
await mkdir(dirname(destination), { recursive: true });
await writeFile(destination, bytes);
}
return { base, url: `${base}web/index.html`, release: record.release, sha256: record.sha256 };
}
if (process.argv[1] && pathToFileURL(resolve(process.argv[1])).href === import.meta.url) {
console.log(JSON.stringify(await stageTroy({ mirror: process.env.KILN_ASSET_MIRROR })));
}