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
// Job -> output-options binding for the /forge generation pipeline.
//
// normalizeForgeOptions() (forge-options.js) parses a request's optional output
// controls (seed, output_format/compression, texture_size, target_polycount,
// lods, bbox) in the SAME serverless invocation that submits the job. An
// asynchronous lane (Replicate/TRELLIS, Hunyuan3D, sketch, BYOK) completes in a
// LATER, separate invocation of pollJob(), which only has the job handle, not
// the original request body. This module remembers the request-affecting
// subset (the post-generation compression choice, whether the caller opted OUT
// of the PBR material completion pass, whether an LOD variant was requested,
// and the requested delivery bbox) against the job handle for the lifetime of a
// single poll cycle, so a completed async job still gets the caller's requested
// output_format, material handling, LOD build, and bbox fit applied at
// materialize time.
//
// Mirrors the bindJobToCacheKey/cacheKeyForJob idiom in forge-cache.js exactly:
// best-effort, short-TTL, fail-open without Redis (a cache/store outage just
// means the completed GLB is delivered uncompressed — never a broken response).
import { getRedis } from './redis.js';
const PREFIX = 'fr:jobopt:';
// The binding only needs to outlive one generation's polling window.
const TTL_S = 3600;
function client(override) {
return override || getRedis();
}
/**
* Remember the post-generation choices a just-submitted job should apply at
* completion. No-op (and safe to call unconditionally) when there is nothing
* non-default to remember, or when Redis is unavailable.
*/
export async function bindJobToOptions(jobHandle, opts, { redis } = {}) {
const r = client(redis);
if (!r || !jobHandle || !opts) return;
const compression = opts.compression === 'none' ? null : opts.compression;
// derivePbr is opt-OUT, so only an explicit false is worth remembering: an
// unbound job takes the default-on path at materialize time either way.
const derivePbr = opts.derivePbr === false ? false : null;
// lods is opt-IN, mirroring compression: only an explicit true is worth
// remembering.
const lods = opts.lods === true ? true : null;
// bbox is opt-IN: a caller-supplied [x, y, z] fit box (forge-options.js).
const bbox = Array.isArray(opts.bbox) ? opts.bbox : null;
if (!compression && derivePbr === null && lods === null && !bbox) return; // default behavior needs no binding
const value = {
...(compression ? { compression } : {}),
...(derivePbr === false ? { derivePbr: false } : {}),
...(lods === true ? { lods: true } : {}),
...(bbox ? { bbox } : {}),
};
try {
await r.set(`${PREFIX}${jobHandle}`, JSON.stringify(value), { ex: TTL_S });
} catch {
/* best-effort */
}
}
/**
* Resolve the post-generation choices bound to a job handle, or null when none
* were bound (the common case: no options requested, or Redis unavailable).
*/
export async function optionsForJob(jobHandle, { redis } = {}) {
const r = client(redis);
if (!r || !jobHandle) return null;
try {
const raw = await r.get(`${PREFIX}${jobHandle}`);
if (!raw) return null;
const value = typeof raw === 'string' ? JSON.parse(raw) : raw;
if (!value || typeof value !== 'object') return null;
const hasCompression = typeof value.compression === 'string';
const hasDerivePbr = value.derivePbr === false;
const hasLods = value.lods === true;
const hasBbox = Array.isArray(value.bbox);
return hasCompression || hasDerivePbr || hasLods || hasBbox ? value : null;
} catch {
return null;
}
}