Skip to content

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.

9.8 KB
Raw Blame
// /assistant — builder page for the assistant widget.
//
// Left card edits a config object; the right card renders the copy-paste
// script snippet; and the page itself runs the REAL loader
// (public/assistant/v1.js) so every change re-inits the live widget in the
// corner. No mock preview — what you see is the shipped widget.

import { sanitizeAccent, normalizeMode } from './assistant-widget-core.js';

const config = {
	avatar: '',
	bg: '',
	mode: 'both',
	name: '',
	greeting: '',
	context: '',
	accent: '#f97316',
	position: 'right',
};

const snippetEl = document.getElementById('snippet');
const copyBtn = document.getElementById('copy-btn');
const avatarSelect = document.getElementById('cfg-avatar');
const avatarUrlInput = document.getElementById('cfg-avatar-url');
const bgColorInput = document.getElementById('cfg-bg-color');
const nameInput = document.getElementById('cfg-name');
const greetingInput = document.getElementById('cfg-greeting');
const contextInput = document.getElementById('cfg-context');
const accentInput = document.getElementById('cfg-accent');
const previewStatusEl = document.getElementById('preview-status');
const previewMsgEls = document.querySelectorAll('.preview-msg');
const previewRetryBtn = document.getElementById('preview-retry');

// ── Snippet rendering ─────────────────────────────────────────────────────
function escapeAttr(value) {
	return String(value).replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;');
}

function snippetAttrs() {
	const attrs = [];
	if (config.avatar) attrs.push(['data-avatar', config.avatar]);
	if (config.bg) attrs.push(['data-bg', config.bg]);
	if (config.mode !== 'both') attrs.push(['data-mode', config.mode]);
	if (config.name) attrs.push(['data-name', config.name]);
	if (config.greeting) attrs.push(['data-greeting', config.greeting]);
	if (config.context) attrs.push(['data-context', config.context]);
	if (config.accent.toLowerCase() !== '#f97316') attrs.push(['data-accent', config.accent]);
	if (config.position !== 'right') attrs.push(['data-position', config.position]);
	return attrs;
}

function renderSnippet() {
	const attrs = snippetAttrs();
	const lines = [`<span class="tag">&lt;script</span> <span class="attr">src</span>=<span class="val">"https://three.ws/assistant/v1.js"</span> <span class="attr">async</span>`];
	for (const [key, value] of attrs) {
		lines.push(`  <span class="attr">${key}</span>=<span class="val">"${escapeAttr(value)}"</span>`);
	}
	lines[lines.length - 1] += `<span class="tag">&gt;&lt;/script&gt;</span>`;
	snippetEl.innerHTML = lines.join('\n');
}

function snippetText() {
	const attrs = snippetAttrs()
		.map(([key, value]) => `\n  ${key}="${String(value).replace(/"/g, '&quot;')}"`)
		.join('');
	return `<script src="https://three.ws/assistant/v1.js" async${attrs}><\/script>`;
}

// ── Live widget (the real loader, re-inited on every change) ──────────────
//
// State copy lives in the markup (one .preview-msg span per state) so the i18n
// catalog pass translates every state; writing it from here would be reverted
// the moment that async pass landed, and the page would claim it was still
// starting up long after the widget was running.
function setPreviewState(state) {
	previewStatusEl.dataset.state = state;
	for (const el of previewMsgEls) el.hidden = el.dataset.previewState !== state;
	previewRetryBtn.hidden = state === 'loading' || state === 'ready';
}

// The widget's iframe is lazy: it does not fetch the frame (or the avatar)
// until the visitor opens the panel, so a mounted launcher is genuinely
// "running" and the frame's health can only be judged from the moment it is
// opened. Opening arms this watchdog; the frame's own `ready` disarms it, and
// anything else (blocked iframe, avatar that never loads) lands in `degraded`
// instead of a corner that silently stays empty.
const FRAME_READY_TIMEOUT_MS = 20000;
let mountSeq = 0;
let readySeq = -1;
let readyTimer = 0;

window.addEventListener('three-assistant', (event) => {
	const type = event.detail?.type;
	if (type === 'ready') {
		readySeq = mountSeq;
		clearTimeout(readyTimer);
		setPreviewState('ready');
	} else if (type === 'error') {
		clearTimeout(readyTimer);
		setPreviewState('degraded');
	} else if (type === 'open' && readySeq !== mountSeq) {
		const seq = mountSeq;
		clearTimeout(readyTimer);
		readyTimer = setTimeout(() => {
			if (readySeq !== seq) setPreviewState('degraded');
		}, FRAME_READY_TIMEOUT_MS);
	}
});

let loaderReady = null;
function ensureLoader() {
	if (loaderReady) return loaderReady;
	setPreviewState('loading');
	loaderReady = new Promise((resolve, reject) => {
		const s = document.createElement('script');
		s.src = '/assistant/v1.js';
		s.setAttribute('data-manual', ''); // we drive init ourselves
		s.onload = () => {
			if (window.ThreeAssistant) resolve();
			else reject(new Error('assistant loader loaded without ThreeAssistant'));
		};
		s.onerror = () => reject(new Error('assistant loader failed to load'));
		document.head.appendChild(s);
	}).catch((err) => {
		// Drop the rejected promise so Retry re-fetches instead of replaying it.
		loaderReady = null;
		removeLoaderTag();
		throw err;
	});
	return loaderReady;
}

/** Remove a failed loader tag so a retry isn't blocked by a dead script node. */
function removeLoaderTag() {
	for (const tag of document.querySelectorAll('script[src="/assistant/v1.js"]')) tag.remove();
}

// Every config key ends up in the frame URL, so a re-mount tears the iframe
// down and refetches the avatar. Skip the ones that would change nothing (a
// re-click on the active swatch, a keystroke that trims to the same value):
// they cost a GLB download and reset the conversation for no visible gain.
let mountedSignature = '';

let applyTimer = 0;
function applyLive({ delay = 250, force = false } = {}) {
	clearTimeout(applyTimer);
	applyTimer = setTimeout(async () => {
		const signature = JSON.stringify(config);
		if (!force && signature === mountedSignature && window.ThreeAssistant?.instance) return;
		try {
			await ensureLoader();
			const wasOpen = Boolean(window.ThreeAssistant?.instance?.isOpen);
			mountSeq += 1;
			clearTimeout(readyTimer);
			window.ThreeAssistant.init({ ...config, open: wasOpen });
			mountedSignature = signature;
			setPreviewState('ready');
		} catch {
			mountedSignature = '';
			setPreviewState('error');
		}
	}, delay);
}

previewRetryBtn.addEventListener('click', () => {
	readySeq = -1;
	setPreviewState('loading');
	applyLive({ delay: 0, force: true });
});

// Free-text fields get a longer debounce than the discrete controls: a pause
// mid-sentence should not cost a full widget re-mount.
const TYPING_DEBOUNCE_MS = 600;

function update(patch, options) {
	Object.assign(config, patch);
	renderSnippet();
	applyLive(options);
}

// ── Control wiring ────────────────────────────────────────────────────────
avatarSelect.addEventListener('change', () => {
	const custom = avatarSelect.value === 'custom';
	avatarUrlInput.hidden = !custom;
	update({ avatar: custom ? avatarUrlInput.value.trim() : avatarSelect.value });
	if (custom) avatarUrlInput.focus();
});
avatarUrlInput.addEventListener('input', () =>
	update({ avatar: avatarUrlInput.value.trim() }, { delay: TYPING_DEBOUNCE_MS }),
);

for (const swatch of document.querySelectorAll('.swatch')) {
	swatch.addEventListener('click', () => {
		for (const s of document.querySelectorAll('.swatch')) s.setAttribute('aria-pressed', 'false');
		swatch.setAttribute('aria-pressed', 'true');
		const isCustom = swatch.dataset.bg === 'custom-color';
		bgColorInput.hidden = !isCustom;
		update({ bg: isCustom ? bgColorInput.value : swatch.dataset.bg });
	});
}
bgColorInput.addEventListener('input', () => update({ bg: bgColorInput.value }));

for (const btn of document.querySelectorAll('[data-mode]')) {
	btn.addEventListener('click', () => {
		for (const b of document.querySelectorAll('[data-mode]')) b.setAttribute('aria-pressed', 'false');
		btn.setAttribute('aria-pressed', 'true');
		update({ mode: normalizeMode(btn.dataset.mode) });
	});
}

for (const btn of document.querySelectorAll('[data-pos]')) {
	btn.addEventListener('click', () => {
		for (const b of document.querySelectorAll('[data-pos]')) b.setAttribute('aria-pressed', 'false');
		btn.setAttribute('aria-pressed', 'true');
		update({ position: btn.dataset.pos });
	});
}

const typing = { delay: TYPING_DEBOUNCE_MS };
nameInput.addEventListener('input', () => update({ name: nameInput.value.trim() }, typing));
greetingInput.addEventListener('input', () => update({ greeting: greetingInput.value.trim() }, typing));
contextInput.addEventListener('input', () => update({ context: contextInput.value.trim() }, typing));
accentInput.addEventListener('input', () => update({ accent: sanitizeAccent(accentInput.value) }, typing));

let copyBtnLabel = '';
copyBtn.addEventListener('click', async () => {
	// Read the resting label at click time: i18n may have translated it, and
	// restoring a hardcoded English string below would undo that.
	if (!copyBtnLabel) copyBtnLabel = copyBtn.textContent.trim();
	try {
		await navigator.clipboard.writeText(snippetText());
		copyBtn.textContent = 'Copied!';
	} catch {
		// Clipboard API blocked (permissions / http) — select the snippet so
		// the user can copy manually.
		const range = document.createRange();
		range.selectNodeContents(snippetEl);
		const sel = getSelection();
		sel.removeAllRanges();
		sel.addRange(range);
		copyBtn.textContent = 'Press Ctrl+C';
	}
	setTimeout(() => {
		copyBtn.textContent = copyBtnLabel;
	}, 1600);
});

// ── Boot ──────────────────────────────────────────────────────────────────
renderSnippet();
applyLive();