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
// Pure, offline generators for the three.ws Concierge embed snippets. Given a
// site's config, produce the exact copy-paste code for each install flavor the
// widget supports. No network, no side effects, this mirrors the attribute
// surface documented in the @three-ws/concierge README.
import { THREE_WS_BASE } from '../config.js';
const FLAVORS = ['script', 'web-component', 'npm', 'imperative'];
function esc(s) {
return String(s).replace(/&/g, '&').replace(/"/g, '"').replace(/</g, '<').replace(/>/g, '>');
}
// Normalize the shared config into the attribute/option set both the tag and
// the web component accept. Unknown/empty fields are dropped so a snippet only
// carries what the caller set.
function normalize(config = {}) {
const out = {};
const set = (k, v) => {
if (v !== undefined && v !== null && String(v).trim() !== '') out[k] = String(v).trim();
};
set('siteName', config.siteName);
set('accent', config.accent);
set('avatar', config.avatar);
set('customAvatar', config.customAvatar);
set('position', config.position);
set('theme', config.theme);
set('greeting', config.greeting);
set('persona', config.persona);
set('knowledge', config.knowledge);
set('lang', config.lang);
if (Array.isArray(config.suggestions) && config.suggestions.length) {
out.suggestions = config.suggestions.map((s) => String(s).trim()).filter(Boolean).slice(0, 4);
}
if (config.endpoint) set('endpoint', config.endpoint);
if (config.muted) out.muted = true;
if (config.open) out.open = true;
if (config.noPicker) out.noPicker = true;
if (config.noTeaser) out.noTeaser = true;
return out;
}
const CAMEL_TO_KEBAB = (k) => k.replace(/[A-Z]/g, (c) => '-' + c.toLowerCase());
function dataAttrs(cfg, { indent = ' ' } = {}) {
const lines = [];
for (const [k, v] of Object.entries(cfg)) {
const attr = 'data-' + CAMEL_TO_KEBAB(k);
if (v === true) lines.push(`${indent}${attr}`);
else if (k === 'suggestions') lines.push(`${indent}${attr}="${esc(v.join('|'))}"`);
else lines.push(`${indent}${attr}="${esc(v)}"`);
}
return lines.join('\n');
}
function elementAttrs(cfg, { indent = ' ' } = {}) {
const lines = [];
for (const [k, v] of Object.entries(cfg)) {
const attr = CAMEL_TO_KEBAB(k);
if (v === true) lines.push(`${indent}${attr}`);
else if (k === 'suggestions') lines.push(`${indent}${attr}="${esc(v.join('|'))}"`);
else lines.push(`${indent}${attr}="${esc(v)}"`);
}
return lines.join('\n');
}
function scriptTag(cfg) {
const src = `${THREE_WS_BASE}/concierge/concierge.global.js`;
const attrs = dataAttrs(cfg);
return `<script type="module"\n src="${src}"\n data-concierge${attrs ? '\n' + attrs : ''}></script>`;
}
function webComponent(cfg) {
// The global build registers <three-concierge> on load and only auto-mounts
// when the script tag itself carries data-concierge, so this pair is safe to
// paste into plain HTML with no bundler. (npm users can instead
// `import '@three-ws/concierge'` to register the element.)
const src = `${THREE_WS_BASE}/concierge/concierge.global.js`;
const attrs = elementAttrs(cfg);
return `<script type="module" src="${src}"></script>\n\n<three-concierge${attrs ? '\n' + attrs : ''}>\n</three-concierge>`;
}
function npmSnippet(cfg) {
const json = JSON.stringify(cfg, null, '\t').replace(/^/gm, '\t').trim();
return `// npm install @three-ws/concierge three\nimport { Concierge } from '@three-ws/concierge';\n\nnew Concierge(${json});`;
}
function imperativeSnippet(cfg) {
// Script-tag consumers without a bundler: the global build exposes the full
// API at window.ThreeWsConcierge; mount() returns the controller.
const src = `${THREE_WS_BASE}/concierge/concierge.global.js`;
const json = JSON.stringify(cfg, null, '\t').replace(/^/gm, '\t').trim();
return `<script type="module" src="${src}"></script>\n<script type="module">\n\tconst concierge = window.ThreeWsConcierge.mount(${json});\n</script>`;
}
/**
* Build the requested embed snippet(s).
* @param {object} config shared concierge config (siteName, accent, knowledge, ...)
* @param {'script'|'web-component'|'npm'|'imperative'|'all'} [flavor='all']
* @returns {{ flavor: string, snippets: Record<string,string> }}
*/
export function buildEmbed(config, flavor = 'all') {
const cfg = normalize(config);
const want = flavor === 'all' ? FLAVORS : [flavor];
const snippets = {};
for (const f of want) {
if (f === 'script') snippets.script = scriptTag(cfg);
else if (f === 'web-component') snippets['web-component'] = webComponent(cfg);
else if (f === 'npm') snippets.npm = npmSnippet(cfg);
else if (f === 'imperative') snippets.imperative = imperativeSnippet(cfg);
}
return { flavor, config: cfg, snippets };
}
export { FLAVORS };