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
// UX preview overlay for /app-next — re-skins /src/app.js without touching it.
import { getMe, readAuthHint, saveRemoteGlbToAccount } from './account.js';
import { log } from './shared/log.js';
const STORAGE_HINT_KEY = 'nxt:first-hint-dismissed';
const CHIP_ROTATE_MS = 9000;
const IDLE_HIDE_MS = 5000;
const AGENT_BUBBLE_MS = 6000;
// Suggested chat prompts — animation primers + agent questions. Each prompt's
// optional `clip` plays the matching animation alongside the chat reply, so
// "Wave at me!" actually triggers the wave clip when the agent answers.
const CHAT_PROMPTS = [
{ text: 'Wave at me!', icon: '👋', clip: 'av-waving' },
{ text: 'Do a superhero jump', icon: '🦸', clip: 'av-superhero-jump' },
{ text: 'Show me a dance', icon: '🥊', clip: 'boxer-dance' },
{ text: 'Flex for me', icon: '💪', clip: 'av-flex-arm' },
{ text: 'Brag and clap', icon: '👏', clip: 'av-brag-and-clap' },
{ text: 'Who are you?', icon: '👤' },
{ text: 'What can you do?', icon: '✨' },
{ text: 'Tell me about three.ws', icon: '🌐' },
{ text: 'Why are you embodied?', icon: '🧠' },
{ text: 'Sneak walk away', icon: '🚶', clip: 'av-walk-crouching' },
];
const VISIBLE_CHIPS = 3;
const ICON_OVERRIDES = {
idle: '🧍',
lookdown: '👀',
covereyes: '🙈',
facepalm: '🤦',
'av-waving': '👋',
'av-superhero-jump': '🦸',
'boxer-dance': '🥊',
'av-brag-and-clap': '👏',
'av-flex-arm': '💪',
'av-walk-crouching': '🚶',
'av-idle-breath': '🧘',
'av-waiting': '🕰️',
};
// Camera preset framings, all expressed relative to the avatar's bounding box.
// Each entry maps to (cameraOffset, targetOffset) computed at preset time.
const CAMERA_PRESETS = {
face: { framePadding: 0.6, heightFrac: 0.92, distFrac: 1.5, targetY: 0.92 },
body: { framePadding: 1.25, heightFrac: 0.55, distFrac: 2.6, targetY: 0.5 },
wide: { framePadding: 1.9, heightFrac: 0.5, distFrac: 4.0, targetY: 0.45 },
hero: { framePadding: 1.55, heightFrac: 0.3, distFrac: 3.2, targetY: 0.55 },
};
// Stage backdrops painted behind the transparent avatar canvas. Each `css` is a
// valid CSS `background` value (gradient or solid). `light` flips the swatch
// label to dark text. The agent can also set an arbitrary solid color via the
// chat ("make the background dark blue") — that arrives as a `nxt:backdrop`
// CustomEvent and is rendered as the "Custom" entry.
const BACKDROPS = [
{ id: 'studio', label: 'Studio', css: 'radial-gradient(circle at 50% 28%, #2b2b33 0%, #111116 72%)' },
{ id: 'aurora', label: 'Aurora', css: 'linear-gradient(165deg, #0a1f3a 0%, #123f54 48%, #1e6f60 100%)' },
{ id: 'sunset', label: 'Sunset', css: 'linear-gradient(165deg, #271238 0%, #7a2f4a 55%, #d9763c 100%)' },
{ id: 'mint', label: 'Mint', css: 'linear-gradient(165deg, #0c2a26 0%, #15463c 100%)' },
{ id: 'noir', label: 'Noir', css: '#050507' },
{ id: 'paper', label: 'Paper', css: 'linear-gradient(165deg, #f5f2ea 0%, #dcd6c9 100%)', light: true },
];
const BACKDROP_STORAGE_KEY = 'nxt:backdrop';
const DEFAULT_BACKDROP_ID = 'studio';
document.addEventListener('DOMContentLoaded', boot);
// Read the viewer's launch hash (`/app#model=…&kind=object&title=…`). app.js
// parses the same hash for the model; we only need the mode-shaping keys.
function readLaunchHash() {
try {
return Object.fromEntries(new URLSearchParams(location.hash.replace(/^#/, '')));
} catch {
return {};
}
}
// A prop opened from /objects is a 3D thing to look at and modify, not an
// embodied agent to converse with. In object mode we drop the whole agent
// surface (chat dock, suggested prompts, agent bubble, visitor card, avatar
// switcher, animation sheet) and offer view + modify actions instead.
function isObjectMode() {
return (readLaunchHash().kind || '').toLowerCase() === 'object';
}
function boot() {
// In chat-embed mode (/a/<uuid>?embed=1) the site header and nav chrome
// are hidden by CSS. Wire only what the embedded chat surface needs.
const chatEmbed = new URLSearchParams(location.search).get('embed') === '1';
if (chatEmbed) {
wireChatDock();
wireChatPanelDock();
wireAutoHide();
waitForViewer().then((viewer) => {
if (!viewer) return;
hookAgentBubble();
});
return;
}
if (isObjectMode()) {
bootObjectMode();
return;
}
wireExploreMenu();
wireUserMenu();
wireFirstHint();
wireKeyboardShortcuts();
wirePrimaryCTA();
wireAnimationSheet();
wireChatDock();
wireChatPanelDock();
wireShare();
wireFullscreen();
wireCameraPresets();
wireHelp();
wireAutoHide();
wireDeployMirror();
wireVisitorCard();
wirePosterSkeleton();
wireBackdrop();
wireAvatarSwitcher();
waitForViewer().then((viewer) => {
if (!viewer) {
log.warn('[nxt] viewer never appeared — stage polish skipped');
return;
}
polishStage(viewer);
startChatChipRotation(viewer);
startCameraDrift(viewer);
hookAgentBubble();
applyCameraPreset('body'); // initial framing
});
refreshAuthState();
window.addEventListener('storage', (e) => {
if (e.key === 'nxt-auth-touch' || e.key?.startsWith('auth')) refreshAuthState();
});
}
// ── Object mode ─────────────────────────────────────────────────────────────
// The viewer opened on a prop (a wrench, a vase, an ammo box), not an agent.
// Keep everything that helps you look at and modify a 3D thing (camera presets,
// backdrops, upload, fullscreen, help, keyboard) and strip everything that only
// makes sense for an embodied agent.
function bootObjectMode() {
document.documentElement.dataset.appMode = 'object';
// Chrome that stays: it all applies to inspecting any 3D model.
wireExploreMenu();
wireUserMenu();
wireKeyboardShortcuts();
wirePrimaryCTA();
wireShare();
wireFullscreen();
wireCameraPresets();
wireHelp();
wireAutoHide();
wireDeployMirror();
wirePosterSkeleton();
wireBackdrop();
// Deliberately NOT wired: wireChatDock, wireChatPanelDock, wireAnimationSheet,
// wireVisitorCard, wireAvatarSwitcher, startChatChipRotation, hookAgentBubble,
// wireFirstHint — all agent-only.
wireObjectActions();
waitForViewer().then((viewer) => {
if (!viewer) {
log.warn('[nxt] viewer never appeared — stage polish skipped');
return;
}
polishStage(viewer);
startCameraDrift(viewer);
applyCameraPreset('body'); // initial framing
});
refreshAuthState();
window.addEventListener('storage', (e) => {
if (e.key === 'nxt-auth-touch' || e.key?.startsWith('auth')) refreshAuthState();
});
}
// Replace the agent surface with view + modify actions for the loaded prop.
// Restyle reads `?url=`, AR Studio reads `src=`/`title=`, Download is the GLB.
function wireObjectActions() {
const hash = readLaunchHash();
const modelUrl = hash.model || '';
const title = hash.title || 'Object';
if (!modelUrl) return;
// Hide the agent-only bottom-bar controls (animations, avatar switcher).
['nxt-anim-btn', 'nxt-avatar-btn'].forEach((id) => {
const el = document.getElementById(id);
if (el) el.hidden = true;
});
const bar = document.querySelector('.nxt-action-bar--secondary');
if (!bar) return;
const enc = encodeURIComponent(modelUrl);
const encTitle = encodeURIComponent(title);
const actions = [
{
href: `/restyle?url=${enc}`,
label: 'Restyle',
title: 'Recolor materials, apply presets, or AI-restyle this object',
path: 'M4 13.5V16h2.5l7.4-7.4-2.5-2.5L4 13.5zM15.7 6.3a1 1 0 000-1.4l-1.6-1.6a1 1 0 00-1.4 0l-1.2 1.2 2.5 2.5 1.7-1.7z',
},
{
href: `/ar/studio?src=${enc}&title=${encTitle}`,
label: 'View in AR',
title: 'Place this object in your real space with AR Studio',
path: 'M10 2l7 4v8l-7 4-7-4V6l7-4zm0 2.2L5 6.9v6.2l5 2.7 5-2.7V6.9l-5-2.7zM10 9.5L6.5 7.6M10 9.5l3.5-1.9M10 9.5v4',
},
{
href: modelUrl,
label: 'Download',
title: 'Download the GLB (CC0, free to reuse)',
download: true,
path: 'M10 3v9m-4-4l4 4 4-4M4 15h12',
},
];
const frag = document.createDocumentFragment();
for (const a of actions) {
const el = document.createElement('a');
el.className = 'nxt-action nxt-action--ghost';
el.href = a.href;
el.title = a.title;
if (a.download) el.setAttribute('download', '');
el.innerHTML =
`<svg viewBox="0 0 20 20" width="14" height="14" aria-hidden="true">` +
`<path d="${a.path}" stroke="currentColor" stroke-width="1.5" fill="none" ` +
`stroke-linecap="round" stroke-linejoin="round" /></svg>` +
`<span>${escHtml(a.label)}</span>`;
frag.appendChild(el);
}
// Every prop in the /objects library comes from Poly Haven (CC0); credit
// it right in the viewer chrome, not just on the catalog page.
const credit = document.createElement('a');
credit.className = 'nxt-action nxt-action--ghost nxt-action--credit';
credit.href = 'https://polyhaven.com';
credit.target = '_blank';
credit.rel = 'noopener';
credit.title = 'This object is sourced from Poly Haven, a CC0 asset library';
credit.innerHTML = `<span>Poly Haven</span>`;
frag.appendChild(credit);
// Insert the object actions before the primary (Save/Sign-in) button so the
// bar reads: Backdrop · Upload · Restyle · AR · Download · Poly Haven · Save.
const primary = document.getElementById('nxt-primary');
if (primary) bar.insertBefore(frag, primary);
else bar.appendChild(frag);
}
// ── Viewer wait ───────────────────────────────────────────────────────────
function waitForViewer(timeoutMs = 15000) {
return new Promise((resolve) => {
const started = Date.now();
const tick = () => {
const v = window.VIEWER?.viewer;
if (v && v.scene && v.renderer && v.controls) return resolve(v);
if (Date.now() - started > timeoutMs) return resolve(null);
setTimeout(tick, 120);
};
tick();
});
}
function waitForAgent(timeoutMs = 15000) {
return new Promise((resolve) => {
const started = Date.now();
const tick = () => {
const a = window.VIEWER?.agent;
if (a && typeof a._send === 'function' && a.panel) return resolve(a);
if (Date.now() - started > timeoutMs) return resolve(null);
setTimeout(tick, 150);
};
tick();
});
}
// ── Stage polish ──────────────────────────────────────────────────────────
function polishStage(viewer) {
try {
viewer.state.transparentBg = true;
viewer.updateBackground();
} catch (err) {
log.warn('[nxt] could not set transparent canvas', err);
}
}
// ── Camera idle drift ─────────────────────────────────────────────────────
function startCameraDrift(viewer) {
if (!viewer.controls) return;
let userInteracted = false;
let resumeTimer = null;
const enableDrift = () => {
viewer.state.autoRotate = true;
viewer.controls.autoRotate = true;
viewer.controls.autoRotateSpeed = 0.35;
viewer.invalidate?.();
};
const pauseDrift = () => {
viewer.state.autoRotate = false;
viewer.controls.autoRotate = false;
userInteracted = true;
clearTimeout(resumeTimer);
resumeTimer = setTimeout(() => {
if (userInteracted) {
userInteracted = false;
enableDrift();
}
}, 10000);
};
enableDrift();
viewer.controls.addEventListener('start', pauseDrift);
}
// ── Camera presets ────────────────────────────────────────────────────────
function applyCameraPreset(name) {
const viewer = window.VIEWER?.viewer;
if (!viewer || !viewer.content || !viewer.controls || !viewer.defaultCamera) return;
const preset = CAMERA_PRESETS[name];
if (!preset) return;
const THREE = window.THREE;
if (!THREE) return;
const box = new THREE.Box3().setFromObject(viewer.content);
const size = box.getSize(new THREE.Vector3());
const center = box.getCenter(new THREE.Vector3());
if (!isFinite(size.length()) || size.length() === 0) return;
const fovRad = viewer.defaultCamera.fov * (Math.PI / 180);
const fittingHeight = size.y * preset.framePadding;
const baseDist = fittingHeight / 2 / Math.tan(fovRad / 2);
const dist = baseDist * (preset.distFrac / 2.6);
const targetY = box.min.y + size.y * preset.targetY;
const camY = box.min.y + size.y * preset.heightFrac;
const target = new THREE.Vector3(center.x, targetY, center.z);
const pos = new THREE.Vector3(center.x + dist * 0.12, camY, center.z + dist);
if (typeof viewer._tweenCamera === 'function') {
viewer._tweenCamera(pos, target, 500);
} else {
viewer.defaultCamera.position.copy(pos);
viewer.controls.target.copy(target);
viewer.controls.update();
viewer.invalidate?.();
}
updatePresetActive(name);
}
function updatePresetActive(name) {
document.querySelectorAll('.nxt-preset').forEach((btn) => {
btn.classList.toggle('is-active', btn.dataset.preset === name);
});
}
function wireCameraPresets() {
document.querySelectorAll('.nxt-preset').forEach((btn) => {
btn.addEventListener('click', () => applyCameraPreset(btn.dataset.preset));
});
}
// ── Chat chip rotation ────────────────────────────────────────────────────
function startChatChipRotation(viewer) {
const chipsEl = document.getElementById('nxt-chat-chips');
if (!chipsEl) return;
let pool = CHAT_PROMPTS.slice();
let cursor = Math.floor(Math.random() * pool.length);
const render = () => {
const mgr = viewer.animationManager;
// Clip-bearing chips ("Show me a dance") only make sense when the loaded
// model can actually perform the pre-baked library. A user's own GLB with
// no compatible skeleton retargets every clip to nothing, so for those we
// drop the animation chips and keep only the conversational prompts.
const canPerform = mgr?.supportsCanonicalClips?.() !== false;
const available = new Set((mgr?.getAnimationDefs?.() || []).map((d) => d.name));
const filtered = pool.filter((p) => {
if (!p.clip) return true;
if (!canPerform) return false;
return available.size === 0 || available.has(p.clip);
});
const showPool = filtered.length >= VISIBLE_CHIPS ? filtered : pool;
chipsEl.innerHTML = '';
for (let i = 0; i < VISIBLE_CHIPS; i++) {
const prompt = showPool[(cursor + i) % showPool.length];
const chip = document.createElement('button');
chip.type = 'button';
chip.className = 'nxt-chat-chip';
chip.setAttribute('role', 'listitem');
chip.dataset.text = prompt.text;
if (prompt.clip) chip.dataset.clip = prompt.clip;
chip.innerHTML =
`<span class="nxt-chat-chip__icon">${escHtml(prompt.icon || '✨')}</span>` +
`<span>${escHtml(prompt.text)}</span>`;
chip.addEventListener('click', () => sendChat(prompt.text, prompt.clip));
chipsEl.appendChild(chip);
}
};
render();
let rotateTimer = setInterval(() => {
cursor = (cursor + VISIBLE_CHIPS) % pool.length;
render();
}, CHIP_ROTATE_MS);
// A new model can change which clips are performable — re-filter the chips
// the moment it loads instead of waiting for the next rotation tick.
window.addEventListener('viewer:model-loaded', () => render());
// Pause rotation when the chat dock is focused/hovered
const dock = document.getElementById('nxt-chat-dock');
if (dock) {
const stop = () => {
if (rotateTimer) {
clearInterval(rotateTimer);
rotateTimer = null;
}
};
const start = () => {
if (!rotateTimer) {
rotateTimer = setInterval(() => {
cursor = (cursor + VISIBLE_CHIPS) % pool.length;
render();
}, CHIP_ROTATE_MS);
}
};
dock.addEventListener('mouseenter', stop);
dock.addEventListener('mouseleave', start);
dock.addEventListener('focusin', stop);
dock.addEventListener('focusout', start);
}
}
// ── Chat dock — input + send wires through NichAgent ──────────────────────
function wireChatDock() {
const input = document.getElementById('nxt-chat-input');
const form = document.getElementById('nxt-chat-form');
const mic = document.getElementById('nxt-chat-mic');
if (!form || !input) return;
form.addEventListener('submit', (e) => {
e.preventDefault();
const text = input.value.trim();
if (!text) return;
sendChat(text);
input.value = '';
});
// Pin chat-active class while input is focused or NichAgent panel is open.
input.addEventListener('focus', () => document.body.classList.add('nxt-chat-active'));
input.addEventListener('blur', () => {
setTimeout(() => {
if (!document.activeElement?.closest('.nxt-chat-dock, .nich-panel')) {
document.body.classList.remove('nxt-chat-active');
}
}, 100);
});
// Push-to-talk via spacebar (NichAgent's mic toggle covers the actual recognition).
if (mic && 'webkitSpeechRecognition' in window) {
mic.hidden = false;
mic.addEventListener('click', () => triggerMicToggle(mic));
document.addEventListener('keydown', (e) => {
if (e.code !== 'Space') return;
if (e.target.matches('input, textarea, [contenteditable="true"]')) return;
e.preventDefault();
triggerMicToggle(mic);
});
}
}
// ── Unified chat — dock the thread panel flush onto the composer ──────────
//
// The NichAgent panel (conversation thread) and the chat dock (chips + input)
// are two separate DOM trees. Left alone they render as two detached glass
// surfaces with a gap, which reads as "two chats". This pins the thread panel's
// bottom edge directly onto the dock's top edge and flags `nxt-chat-merged` so
// the CSS fuses them into a single card whenever the thread is open.
function wireChatPanelDock() {
const dock = document.getElementById('nxt-chat-dock');
if (!dock) return;
waitForAgent().then((agent) => {
const panel = agent?.panel;
if (!panel) return;
const syncBottom = () => {
if (panel.style.display === 'none') return;
const dockTop = dock.getBoundingClientRect().top;
// Flush: panel bottom edge meets dock top edge (0px gap → one card).
panel.style.bottom = `${Math.max(0, Math.round(window.innerHeight - dockTop))}px`;
};
let lastOpen = null;
const reflectOpenState = () => {
const open = panel.style.display !== 'none';
if (open === lastOpen) return; // ignore our own inline `bottom` writes
lastOpen = open;
document.body.classList.toggle('nxt-chat-merged', open);
if (open) requestAnimationFrame(syncBottom);
};
new MutationObserver(reflectOpenState).observe(panel, {
attributes: true,
attributeFilter: ['style'],
});
// Keep the seam tight as the layout shifts underneath the thread.
window.addEventListener('resize', () => requestAnimationFrame(syncBottom));
dock.addEventListener('transitionend', () => requestAnimationFrame(syncBottom));
const chips = document.getElementById('nxt-chat-chips');
if (chips) {
new MutationObserver(() => requestAnimationFrame(syncBottom)).observe(chips, {
childList: true,
});
}
reflectOpenState();
});
}
async function triggerMicToggle(micEl) {
const agent = await waitForAgent(8000);
if (!agent) return;
const agentMicBtn = agent.panel?.querySelector('.nich-mic');
if (!agentMicBtn) {
toast('Voice not available in this browser.');
return;
}
agentMicBtn.click();
micEl.classList.toggle('is-recording');
}
async function sendChat(text, optionalClip) {
const agent = await waitForAgent(8000);
if (!agent) {
toast('Agent loading… try again in a moment.');
return;
}
// Open the panel so the user sees the conversation thread.
const panelHidden = agent.panel.style.display === 'none';
if (panelHidden && typeof agent._togglePanel === 'function') {
agent._togglePanel();
}
document.body.classList.add('nxt-chat-active');
// Optionally fire the matching animation alongside the chat reply.
if (optionalClip) {
const viewer = window.VIEWER?.viewer;
const mgr = viewer?.animationManager;
if (mgr && typeof mgr.ensureLoaded === 'function') {
mgr.ensureLoaded(optionalClip)
.then(() => mgr.play(optionalClip))
.catch(() => {});
}
}
const agentInput = agent.panel.querySelector('.nich-input');
if (agentInput) {
agentInput.value = text;
// _send reads the input, pushes the user message, and dispatches to skills/LLM.
try {
agent._send();
} catch (err) {
log.warn('[nxt] chat send failed', err);
}
}
}
// ── Agent speech bubble ───────────────────────────────────────────────────
function hookAgentBubble() {
const bubble = document.getElementById('nxt-agent-bubble');
const textEl = document.getElementById('nxt-agent-bubble-text');
if (!bubble || !textEl) return;
let hideTimer = null;
const showReply = (text) => {
if (!text) return;
textEl.textContent = text;
bubble.hidden = false;
clearTimeout(hideTimer);
hideTimer = setTimeout(() => {
bubble.hidden = true;
}, AGENT_BUBBLE_MS);
};
// ACTION_TYPES.SPEAK resolves to 'speak' (lowercase) — match the actual value.
const protocol = window.VIEWER?.agent_protocol;
if (protocol && typeof protocol.on === 'function') {
protocol.on('speak', (action) => {
const t = action?.payload?.text;
if (t) showReply(t);
});
}
}
// ── Animation sheet ───────────────────────────────────────────────────────
function wireAnimationSheet() {
const btn = document.getElementById('nxt-anim-btn');
const sheet = document.getElementById('nxt-anim-sheet');
const closeBtn = document.getElementById('nxt-anim-sheet-close');
const search = document.getElementById('nxt-anim-search');
const grid = document.getElementById('nxt-anim-grid');
if (!btn || !sheet || !grid) return;
let rendered = false;
const open = () => {
sheet.hidden = false;
sheet.setAttribute('aria-hidden', 'false');
btn.setAttribute('aria-expanded', 'true');
if (!rendered) {
renderGrid().then(() => {
rendered = true;
});
}
setTimeout(() => search?.focus(), 60);
};
const close = () => {
sheet.hidden = true;
sheet.setAttribute('aria-hidden', 'true');
btn.setAttribute('aria-expanded', 'false');
};
// A new model can have a different set of (or no) usable animations — drop the
// cached grid so the next open rebuilds it, and rebuild live if it's open now.
window.addEventListener('viewer:model-loaded', () => {
rendered = false;
if (!sheet.hidden) renderGrid().then(() => { rendered = true; });
});
btn.addEventListener('click', () => {
if (sheet.hidden) open();
else close();
});
closeBtn?.addEventListener('click', close);
document.addEventListener('keydown', (e) => {
if (e.key === 'Escape' && !sheet.hidden) close();
});
document.addEventListener('pointerdown', (e) => {
if (sheet.hidden) return;
if (sheet.contains(e.target) || btn.contains(e.target)) return;
close();
});
search?.addEventListener('input', filterGrid);
async function renderGrid() {
const viewer = await waitForViewer();
if (!viewer) {
grid.innerHTML = '<div class="nxt-anim-empty">Viewer not ready — reload to try again.</div>';
return;
}
await pollForClips(viewer);
const defs = viewer.animationManager.getAnimationDefs();
if (!defs || defs.length === 0) {
grid.innerHTML = '<div class="nxt-anim-empty">This avatar has no animations.</div>';
return;
}
// The built-in library only retargets onto a compatible humanoid rig. For a
// custom upload with no matching skeleton, every clip would play to no
// effect — say so instead of listing actions that do nothing.
if (viewer.animationManager.supportsCanonicalClips?.() === false) {
grid.innerHTML =
'<div class="nxt-anim-empty">This model’s rig isn’t compatible with the built-in animations. Upload a humanoid avatar (Mixamo, Ready Player Me, Avaturn) to use them.</div>';
return;
}
grid.innerHTML = '';
const activeName = viewer.animationManager.currentName;
for (const def of defs) {
const card = document.createElement('button');
card.type = 'button';
card.className = 'nxt-anim-card';
card.dataset.name = def.name;
card.setAttribute('aria-pressed', activeName === def.name ? 'true' : 'false');
const icon = ICON_OVERRIDES[def.name] || def.icon || '✨';
const label = def.label || prettify(def.name);
card.innerHTML =
`<span class="nxt-anim-card__icon">${escHtml(icon)}</span>` +
`<span>${escHtml(label)}</span>`;
card.addEventListener('click', () => {
playClip(viewer, def.name);
grid.querySelectorAll('.nxt-anim-card').forEach((c) => {
c.setAttribute('aria-pressed', c.dataset.name === def.name ? 'true' : 'false');
});
// Dismiss the sheet so the user can actually watch the clip play.
close();
});
grid.appendChild(card);
}
// Chain through any existing onChange so we don't clobber a viewer subscriber.
const prevOnChange = viewer.animationManager.onChange;
viewer.animationManager.onChange = (...args) => {
try { prevOnChange?.(...args); } catch (e) { log.warn('[nxt] prior onChange threw', e); }
const current = viewer.animationManager.currentName;
grid.querySelectorAll('.nxt-anim-card').forEach((c) => {
c.setAttribute('aria-pressed', c.dataset.name === current ? 'true' : 'false');
});
};
}
function filterGrid() {
const q = (search?.value || '').trim().toLowerCase();
const cards = grid.querySelectorAll('.nxt-anim-card');
let visible = 0;
cards.forEach((c) => {
const hay = (c.textContent + ' ' + c.dataset.name).toLowerCase();
const match = !q || hay.includes(q);
c.style.display = match ? '' : 'none';
if (match) visible++;
});
grid.querySelectorAll('.nxt-anim-empty[data-search]').forEach((n) => n.remove());
// No cards means the grid is showing its own status ("Loading clips…", "This
// avatar has no animations", a rig warning). The search box is focused 60ms
// after the sheet opens, so typing straight away is the normal flow, and
// appending a second message there stacks two contradictory answers under
// each other. An empty query has nothing to report either way.
if (!cards.length || !q) return;
if (visible === 0) {
const empty = document.createElement('div');
empty.className = 'nxt-anim-empty';
empty.dataset.search = '1';
empty.textContent = `No clips matching "${q}".`;
grid.appendChild(empty);
}
}
}
function pollForClips(viewer, timeoutMs = 12000) {
return new Promise((resolve) => {
const started = Date.now();
const tick = () => {
const defs = viewer.animationManager?.getAnimationDefs?.() || [];
if (defs.length > 0) return resolve(defs);
if (Date.now() - started > timeoutMs) return resolve([]);
setTimeout(tick, 300);
};
tick();
});
}
function playClip(viewer, name) {
const mgr = viewer.animationManager;
if (!mgr) return;
const defs = mgr.getAnimationDefs();
const def = defs.find((d) => d.name === name);
if (!def) return;
mgr.ensureLoaded(name)
.then(() => mgr.play(name))
.catch((err) => log.warn('[nxt] clip play failed', name, err));
}
// ── Share / embed popover ─────────────────────────────────────────────────
function wireShare() {
const btn = document.getElementById('nxt-share-btn');
const pop = document.getElementById('nxt-share-popover');
const closeBtn = document.getElementById('nxt-share-close');
const urlEl = document.getElementById('nxt-share-url');
const embedEl = document.getElementById('nxt-share-embed');
const urlCopyBtn = document.getElementById('nxt-share-url-copy');
const embedCopyBtn = document.getElementById('nxt-share-embed-copy');
if (!btn || !pop) return;
const refresh = () => {
const baseUrl = location.origin + '/app';
const params = new URLSearchParams();
const agentId = new URLSearchParams(location.search).get('agent');
if (agentId) {
params.set('agent', agentId);
} else {
const currentModelUrl = window.VIEWER?.app?._currentModelUrl;
if (currentModelUrl && !currentModelUrl.includes('/avatars/cz.glb')) {
params.set('model', currentModelUrl);
}
}
const share = params.toString() ? `${baseUrl}?${params.toString()}` : baseUrl;
urlEl.value = share;
const kiosk = share + (share.includes('?') ? '&' : '?') + 'kiosk=1';
embedEl.value =
`<iframe src="${kiosk}" width="540" height="720" ` +
`style="border:0;border-radius:18px;overflow:hidden" ` +
`allow="autoplay;microphone;camera"></iframe>`;
};
const open = () => {
refresh();
pop.hidden = false;
btn.setAttribute('aria-expanded', 'true');
};
const close = () => {
pop.hidden = true;
btn.setAttribute('aria-expanded', 'false');
};
btn.addEventListener('click', () => (pop.hidden ? open() : close()));
closeBtn?.addEventListener('click', close);
document.addEventListener('pointerdown', (e) => {
if (pop.hidden) return;
if (pop.contains(e.target) || btn.contains(e.target)) return;
close();
});
const copy = async (textEl, copyBtn) => {
const text = textEl.value;
try {
await navigator.clipboard.writeText(text);
} catch {
textEl.select();
document.execCommand?.('copy');
}
copyBtn.textContent = 'Copied ✓';
copyBtn.classList.add('is-copied');
setTimeout(() => {
copyBtn.textContent = 'Copy';
copyBtn.classList.remove('is-copied');
}, 1800);
};
urlCopyBtn?.addEventListener('click', () => copy(urlEl, urlCopyBtn));
embedCopyBtn?.addEventListener('click', () => copy(embedEl, embedCopyBtn));
// Social share buttons
const twitterBtn = document.getElementById('nxt-share-twitter');
const farcasterBtn = document.getElementById('nxt-share-farcaster');
const telegramBtn = document.getElementById('nxt-share-telegram');
// The stock identity is literally named "Agent", so a visitor who has not
// loaded an agent of their own used to broadcast "Meet Agent" to X, Farcaster
// and Telegram. A placeholder name is no name: fall through to the generic
// line instead of publishing the default.
const PLACEHOLDER_NAMES = new Set(['agent', 'untitled', 'unnamed', 'avatar']);
const shareText = () => {
const app = window.VIEWER?.app;
const name = app?.identity?.name?.trim();
return name && !PLACEHOLDER_NAMES.has(name.toLowerCase())
? `Meet ${name}, an embodied AI agent on @trythreews`
: 'Check out this embodied AI agent on @trythreews';
};
const shareUrl = () => urlEl?.value || location.href;
twitterBtn?.addEventListener('click', () => {
const url = `https://x.com/intent/tweet?text=${encodeURIComponent(shareText())}&url=${encodeURIComponent(shareUrl())}`;
window.open(url, '_blank', 'noopener,noreferrer,width=600,height=400');
});
farcasterBtn?.addEventListener('click', () => {
const url = `https://warpcast.com/~/compose?text=${encodeURIComponent(shareText() + ' ' + shareUrl())}`;
window.open(url, '_blank', 'noopener,noreferrer,width=600,height=600');
});
telegramBtn?.addEventListener('click', () => {
const url = `https://t.me/share/url?url=${encodeURIComponent(shareUrl())}&text=${encodeURIComponent(shareText())}`;
window.open(url, '_blank', 'noopener,noreferrer,width=600,height=400');
});
}
// ── Fullscreen ────────────────────────────────────────────────────────────
function wireFullscreen() {
const btn = document.getElementById('nxt-fullscreen-btn');
if (!btn) return;
const toggle = () => {
if (!document.fullscreenElement) {
document.documentElement.requestFullscreen?.().catch(() => {
toast('Fullscreen blocked by browser.');
});
} else {
document.exitFullscreen?.();
}
};
btn.addEventListener('click', toggle);
}
// ── Header menus ──────────────────────────────────────────────────────────
function wireExploreMenu() {
const btn = document.getElementById('nxt-more-btn');
const menu = document.getElementById('nxt-more-menu');
if (!btn || !menu) return;
const positionMenu = () => {
const r = btn.getBoundingClientRect();
const rightOffset = window.innerWidth - r.right;
const minEdge = 12;
menu.style.top = `${r.bottom + 6}px`;
menu.style.right = `${Math.max(minEdge, rightOffset)}px`;
menu.style.left = '';
if (rightOffset < minEdge) {
menu.style.right = `${minEdge}px`;
}
};
const close = () => {
menu.hidden = true;
btn.setAttribute('aria-expanded', 'false');
};
btn.addEventListener('click', (e) => {
e.stopPropagation();
if (menu.hidden) {
positionMenu();
menu.hidden = false;
btn.setAttribute('aria-expanded', 'true');
} else {
close();
}
});
document.addEventListener('pointerdown', (e) => {
if (menu.hidden) return;
if (menu.contains(e.target) || btn.contains(e.target)) return;
close();
});
document.addEventListener('keydown', (e) => {
if (e.key === 'Escape' && !menu.hidden) close();
});
window.addEventListener('resize', () => {
if (!menu.hidden) close();
});
}
function wireUserMenu() {
const btn = document.getElementById('nav-user-btn');
const menu = document.getElementById('nav-user-menu');
if (!btn || !menu) return;
const close = () => {
menu.hidden = true;
btn.setAttribute('aria-expanded', 'false');
};
btn.addEventListener('click', (e) => {
e.stopPropagation();
if (menu.hidden) {
menu.hidden = false;
btn.setAttribute('aria-expanded', 'true');
} else {
close();
}
});
document.addEventListener('pointerdown', (e) => {
if (menu.hidden) return;
if (menu.contains(e.target) || btn.contains(e.target)) return;
close();
});
}
// ── Auth state + primary CTA ──────────────────────────────────────────────
async function refreshAuthState() {
const signinEl = document.getElementById('nav-sign-in');
const userWrap = document.getElementById('nav-user-wrap');
const userLabel = document.getElementById('nav-user-label');
const profileLink = document.getElementById('nav-my-profile-link');
const primary = document.getElementById('nxt-primary');
const primaryLabel = document.getElementById('nxt-primary-label');
// Optimistic first paint from the boolean hint so returning users don't
// see a "Sign in" flash before getMe() resolves. getMe() then confirms.
const hint = readAuthHint?.();
if (hint === 'true') {
if (signinEl) signinEl.hidden = true;
if (userWrap) userWrap.hidden = false;
if (primaryLabel) primaryLabel.textContent = 'Save to account';
if (primary) primary.dataset.mode = 'save';
}
let me = null;
try {
me = await getMe();
} catch {
me = null;
}
// A session resolves to a user whether or not they've claimed a `username`
// (most accounts only have a `display_name` until they set a handle). Gate
// on the user record itself, not on the optional username.
if (me?.id) {
const label = me.username || me.display_name || me.email?.split('@')[0] || 'Account';
if (signinEl) signinEl.hidden = true;
if (userWrap) userWrap.hidden = false;
if (userLabel) userLabel.textContent = label;
// Phones hide the label and keep the dot, so the account button carries
// the identity for screen readers and as its tooltip.
const userBtn = document.getElementById('nav-user-btn');
if (userBtn) {
const full = me.email || me.username || label;
userBtn.title = full;
userBtn.setAttribute('aria-label', `Account: ${full}`);
}
// The public profile route is keyed by handle, so only link it once the
// user has a username — otherwise it would resolve to a dead page.
if (profileLink) {
if (me.username) {
profileLink.href = `/profile/${encodeURIComponent(me.username)}`;
profileLink.hidden = false;
} else {
profileLink.href = '/settings';
profileLink.hidden = true;
}
}
if (primaryLabel) primaryLabel.textContent = 'Save to account';
if (primary) primary.dataset.mode = 'save';
} else {
if (signinEl) signinEl.hidden = false;
if (userWrap) userWrap.hidden = true;
if (primaryLabel) primaryLabel.textContent = 'Sign in to save';
if (primary) primary.dataset.mode = 'signin';
}
}
function wirePrimaryCTA() {
const primary = document.getElementById('nxt-primary');
const primaryLabel = document.getElementById('nxt-primary-label');
if (!primary) return;
// Outside the closure so a second save can cancel the previous revert.
let revertTimer = null;
primary.addEventListener('click', async () => {
const mode = primary.dataset.mode || 'signin';
if (mode !== 'save') {
location.href = '/login?next=' + encodeURIComponent(location.pathname);
return;
}
const viewer = window.VIEWER?.viewer;
const app = window.VIEWER?.app;
const source = app?._currentLocalFile || app?._currentModelUrl;
if (!viewer || !source) {
toast('Nothing to save yet — load a model first.');
return;
}
const original = 'Save to account';
if (revertTimer) {
clearTimeout(revertTimer);
revertTimer = null;
}
if (primaryLabel) primaryLabel.textContent = 'Saving…';
primary.disabled = true;
try {
const meta = {
name: app?._currentModelName || 'Avatar',
};
if (app?._currentLocalFile) {
meta.source = 'upload';
if (app._currentLocalFile.name) {
meta.source_meta = { original_filename: app._currentLocalFile.name };
}
}
const res = await saveRemoteGlbToAccount(source, meta);
if (res?.id) {
if (primaryLabel) primaryLabel.textContent = 'Saved ✓';
toast(`Saved to your account.`, `/avatars/${res.id}`);
} else {
throw new Error('save failed');
}
} catch (err) {
log.warn('[nxt] save failed', err);
if (primaryLabel) primaryLabel.textContent = original;
const code = err.data?.error || err.code || '';
const detail = err.data?.error_description || err.message || '';
if (code === 'plan_limit_count' || code === 'plan_limit_storage') {
toast('Avatar limit reached — delete old avatars or upgrade your plan.');
} else if (err.status === 401 || code === 'not_signed_in') {
toast('Session expired — please sign in again.');
} else if (err.status === 413 || code === 'plan_limit_size') {
toast('File too large for your plan.');
} else if (err.status === 429) {
toast('Too many uploads — wait a moment and try again.');
} else if (detail) {
toast(`Save failed — ${detail}`);
} else {
toast('Save failed — try again.');
}
} finally {
revertTimer = setTimeout(() => {
revertTimer = null;
if (primaryLabel && primaryLabel.textContent === 'Saved ✓') {
primaryLabel.textContent = original;
}
primary.disabled = false;
}, 2400);
}
});
}
// ── Deploy on-chain mirror ────────────────────────────────────────────────
//
// /src/app.js owns the canonical deploy CTA via #deploy-onchain-btn — it sets
// .href, .hidden, and the inner [data-state-label] ("Deploy on Solana").
// We mirror that state into two visible Next surfaces:
//
// • #nxt-deploy-btn — pill in the secondary action bar
// • #nxt-share-deploy — row inside the Share/Embed popover
//
// A MutationObserver on the source keeps the mirrors in sync as app.js
// re-runs _refreshDeployButton (e.g. after the agent record is fetched and
// the deployed state is known).
function wireDeployMirror() {
const src = document.getElementById('deploy-onchain-btn');
if (!src) return;
const targets = [
{
btn: document.getElementById('nxt-deploy-btn'),
label: document.getElementById('nxt-deploy-label'),
subEl: null,
divider: null,
},
{
btn: document.getElementById('nxt-share-deploy'),
label: document.getElementById('nxt-share-deploy-label'),
subEl: document.getElementById('nxt-share-deploy-sub'),
divider: document.getElementById('nxt-share-deploy-divider'),
},
].filter((t) => t.btn);
if (!targets.length) return;
const sync = () => {
const hidden = src.hidden || src.hasAttribute('hidden');
const href = src.getAttribute('href') || '';
const target = src.getAttribute('target') || '';
const rel = src.getAttribute('rel') || '';
const title = src.getAttribute('title') || '';
const aria = src.getAttribute('aria-label') || '';
const labelText =
src.querySelector('[data-state-label]')?.textContent?.trim() ||
src.textContent?.trim() ||
'Deploy on-chain';
const isDeployed = src.classList.contains('is-deployed') || /Deployed/i.test(labelText);
for (const t of targets) {
t.btn.hidden = hidden;
if (t.divider) t.divider.hidden = hidden;
if (href) t.btn.setAttribute('href', href);
else t.btn.removeAttribute('href');
if (target) t.btn.setAttribute('target', target);
else t.btn.removeAttribute('target');
if (rel) t.btn.setAttribute('rel', rel);
else t.btn.removeAttribute('rel');
if (title) t.btn.setAttribute('title', title);
if (aria) t.btn.setAttribute('aria-label', aria);
t.btn.classList.toggle('is-deployed', isDeployed);
if (t.label) t.label.textContent = labelText;
if (t.subEl) {
t.subEl.textContent =
'Hand off to the deployment agent — put this 3D asset on Solana.';
}
}
};
sync();
// Re-run whenever app.js re-paints the source button.
const obs = new MutationObserver(sync);
obs.observe(src, {
attributes: true,
attributeFilter: ['href', 'hidden', 'target', 'rel', 'title', 'aria-label', 'class'],
childList: true,
subtree: true,
characterData: true,
});
// If the user clicks the share-popover row while the popover is open, dismiss
// it so the navigation feels intentional. (Anchor navigation handles the rest.)
const shareRow = document.getElementById('nxt-share-deploy');
const pop = document.getElementById('nxt-share-popover');
if (shareRow && pop) {
shareRow.addEventListener('click', () => {
pop.hidden = true;
document.getElementById('nxt-share-btn')?.setAttribute('aria-expanded', 'false');
});
}
}
// ── Backdrop switcher ──────────────────────────────────────────────────────
//
// The avatar canvas is kept transparent (see polishStage), so a full-bleed
// layer behind it sets the visible "scene". The agent can change it from chat
// (setBgColor → nxt:backdrop event) and the user can pick from a popover.
function applyBackdrop(value, { persistId } = {}) {
const layer = document.getElementById('nxt-stage-backdrop');
if (!layer) return;
layer.style.background = value;
layer.classList.add('is-painted');
if (persistId) {
try {
localStorage.setItem(BACKDROP_STORAGE_KEY, persistId);
} catch {}
}
// Reflect the active swatch in the popover, if open/built.
document.querySelectorAll('.nxt-backdrop-swatch').forEach((b) => {
b.classList.toggle('is-active', b.dataset.id === persistId);
b.setAttribute('aria-pressed', b.dataset.id === persistId ? 'true' : 'false');
});
}
function wireBackdrop() {
const btn = document.getElementById('nxt-backdrop-btn');
const pop = document.getElementById('nxt-backdrop-popover');
const grid = document.getElementById('nxt-backdrop-grid');
// Restore the saved (or default) backdrop even if the control markup is absent.
let savedId = DEFAULT_BACKDROP_ID;
try {
const s = localStorage.getItem(BACKDROP_STORAGE_KEY);
if (s) savedId = s;
} catch {}
const saved = BACKDROPS.find((b) => b.id === savedId);
if (saved) applyBackdrop(saved.css, { persistId: saved.id });
// The agent can paint an arbitrary solid color via chat.
window.addEventListener('nxt:backdrop', (e) => {
const value = e.detail?.value;
if (typeof value === 'string') applyBackdrop(value, { persistId: 'custom' });
});
if (!btn || !pop || !grid) return;
// Build the swatch grid once.
grid.innerHTML = '';
for (const b of BACKDROPS) {
const swatch = document.createElement('button');
swatch.type = 'button';
swatch.className = 'nxt-backdrop-swatch' + (b.light ? ' is-light' : '');
swatch.dataset.id = b.id;
swatch.style.background = b.css;
swatch.title = b.label;
swatch.setAttribute('aria-pressed', b.id === savedId ? 'true' : 'false');
if (b.id === savedId) swatch.classList.add('is-active');
swatch.innerHTML = `<span class="nxt-backdrop-swatch__label">${escHtml(b.label)}</span>`;
swatch.addEventListener('click', () => {
applyBackdrop(b.css, { persistId: b.id });
});
grid.appendChild(swatch);
}
const open = () => {
pop.hidden = false;
btn.setAttribute('aria-expanded', 'true');
};
const close = () => {
pop.hidden = true;
btn.setAttribute('aria-expanded', 'false');
};
btn.addEventListener('click', () => (pop.hidden ? open() : close()));
document.addEventListener('pointerdown', (e) => {
if (pop.hidden) return;
if (pop.contains(e.target) || btn.contains(e.target)) return;
close();
});
document.addEventListener('keydown', (e) => {
if (e.key === 'Escape' && !pop.hidden) close();
});
}
// ── Avatar switcher ────────────────────────────────────────────────────────
//
// Opens the shared gallery picker (same component as /gallery) and swaps the
// loaded avatar to whatever the user chooses — "change the avatar like in the
// gallery", but without leaving the stage.
function wireAvatarSwitcher() {
const btn = document.getElementById('nxt-avatar-btn');
if (!btn) return;
let opening = false;
btn.addEventListener('click', async () => {
if (opening) return;
opening = true;
btn.classList.add('is-loading');
try {
const { AvatarGalleryPicker } = await import('./avatar-gallery-picker.js');
const currentId = new URLSearchParams(location.search).get('agent') || undefined;
const picker = new AvatarGalleryPicker({
source: 'public',
title: 'Switch avatar',
showModes: false,
ctaLabel: 'Use this avatar',
selectedId: currentId,
onSelect: (avatar) => {
if (avatar?.model_url) loadAvatarOntoStage(avatar);
},
});
picker.openModal();
} catch (err) {
log.warn('[nxt] avatar picker failed to load', err);
toast('Could not open the avatar gallery — try again.');
} finally {
btn.classList.remove('is-loading');
opening = false;
}
});
}
function loadAvatarOntoStage(avatar) {
const app = window.VIEWER?.app;
if (!app || typeof app.view !== 'function') {
toast('Viewer not ready — try again in a moment.');
return;
}
toast(`Loading ${avatar.name || 'avatar'}…`);
try {
const result = app.view(avatar.model_url, '', new Map());
Promise.resolve(result)
.then(() => {
// Reframe on the new avatar and refresh the (clip-dependent) chips.
applyCameraPreset('body');
window.dispatchEvent(new CustomEvent('viewer:model-loaded'));
})
.catch((err) => {
log.warn('[nxt] avatar load failed', err);
toast('Failed to load that avatar.');
});
} catch (err) {
log.warn('[nxt] avatar view() threw', err);
toast('Failed to load that avatar.');
}
}
// ── Toast ─────────────────────────────────────────────────────────────────
let toastTimer = null;
function toast(message, href) {
const el = document.getElementById('nxt-toast');
if (!el) return;
el.innerHTML = href
? `${escHtml(message)} <a href="${escHtml(href)}">View →</a>`
: escHtml(message);
el.hidden = false;
clearTimeout(toastTimer);
toastTimer = setTimeout(() => {
el.hidden = true;
}, 4200);
}
// ── First-visit hint ──────────────────────────────────────────────────────
function wireFirstHint() {
const hint = document.getElementById('nxt-first-hint');
const close = document.getElementById('nxt-first-hint-close');
if (!hint || !close) return;
try {
if (localStorage.getItem(STORAGE_HINT_KEY) === '1') return;
} catch {}
hint.hidden = false;
const dismiss = () => {
hint.hidden = true;
try {
localStorage.setItem(STORAGE_HINT_KEY, '1');
} catch {}
};
close.addEventListener('click', dismiss);
setTimeout(dismiss, 14000);
}
// ── Help overlay ──────────────────────────────────────────────────────────
function wireHelp() {
const help = document.getElementById('nxt-help');
const closeBtn = document.getElementById('nxt-help-close');
if (!help) return;
const open = () => {
help.hidden = false;
};
const close = () => {
help.hidden = true;
};
closeBtn?.addEventListener('click', close);
document.addEventListener('keydown', (e) => {
if (e.target.matches('input, textarea, select, [contenteditable="true"]')) return;
if (e.key === '?' || (e.shiftKey && e.key === '/')) {
e.preventDefault();
help.hidden ? open() : close();
} else if (e.key === 'Escape' && !help.hidden) {
close();
}
});
}
// ── Keyboard shortcuts ────────────────────────────────────────────────────
function wireKeyboardShortcuts() {
document.addEventListener('keydown', (e) => {
// Allow shortcuts inside the chat input only for Esc (which blurs).
const inField = e.target.matches('input, textarea, select, [contenteditable="true"]');
if (inField) {
if (e.key === 'Escape') {
e.target.blur();
document.body.classList.remove('nxt-chat-active');
}
return;
}
if (e.metaKey || e.ctrlKey || e.altKey) return;
switch (e.key) {
case 'a':
case 'A':
e.preventDefault();
document.getElementById('nxt-anim-btn')?.click();
break;
case 'u':
case 'U':
e.preventDefault();
document.getElementById('file-input')?.click();
break;
case 's':
case 'S':
e.preventDefault();
document.getElementById('nxt-share-btn')?.click();
break;
case 'f':
case 'F':
e.preventDefault();
document.getElementById('nxt-fullscreen-btn')?.click();
break;
case '/':
if (!e.shiftKey) {
e.preventDefault();
document.getElementById('nxt-chat-input')?.focus();
}
break;
case '1':
e.preventDefault();
applyCameraPreset('face');
break;
case '2':
e.preventDefault();
applyCameraPreset('body');
break;
case '3':
e.preventDefault();
applyCameraPreset('wide');
break;
case '4':
e.preventDefault();
applyCameraPreset('hero');
break;
}
});
}
// ── Auto-hide chrome on idle ──────────────────────────────────────────────
function wireAutoHide() {
let idleTimer = null;
let hasInteracted = false;
const arm = () => {
document.body.classList.remove('nxt-chrome-hidden');
clearTimeout(idleTimer);
// Don't hide chrome at all until the user has actually engaged with the page —
// otherwise the bottom bar disappears before they've had a chance to read it.
if (!hasInteracted) return;
idleTimer = setTimeout(() => {
if (document.body.classList.contains('nxt-chat-active')) return;
if (anyPanelOpen()) return;
document.body.classList.add('nxt-chrome-hidden');
}, IDLE_HIDE_MS);
};
const markInteracted = () => {
hasInteracted = true;
arm();
};
['pointerdown', 'keydown', 'wheel', 'touchstart'].forEach((evt) =>
window.addEventListener(evt, markInteracted, { passive: true }),
);
// mousemove arms but doesn't count as engagement on its own (cursor lands on the
// page from another tab without intent).
window.addEventListener('mousemove', arm, { passive: true });
}
function anyPanelOpen() {
// Every dismissible surface belongs here. Auto-hide drops pointer-events on
// the action bar, and the backdrop picker lives INSIDE that bar: leave it out
// and a user who opens the picker and spends five seconds reading the six
// swatch names watches their open picker fade out from under the cursor.
const ids = [
'nxt-anim-sheet',
'nxt-share-popover',
'nxt-backdrop-popover',
'nxt-help',
'nxt-more-menu',
'nav-user-menu',
];
for (const id of ids) {
const el = document.getElementById(id);
if (el && !el.hidden) return true;
}
const nichPanel = document.querySelector('.nich-panel');
if (nichPanel && nichPanel.style.display !== 'none') return true;
return false;
}
// ── Visitor card + mobile strip ──────────────────────────────────────
function wireVisitorCard() {
const agentId = new URLSearchParams(location.search).get('agent');
if (!agentId) return;
fetchAgentPublic(agentId).then((agent) => {
if (!agent) return;
populateVisitorCard(agent);
populateMobileStrip(agent);
updatePageTitle(agent);
});
}
async function fetchAgentPublic(agentId) {
try {
const resp = await fetch(`/api/agents/${agentId}`);
if (!resp.ok) return null;
const data = await resp.json();
return data.agent || null;
} catch {
return null;
}
}
function populateVisitorCard(agent) {
const card = document.getElementById('nxt-visitor-card');
if (!card) return;
const nameEl = document.getElementById('nxt-visitor-name');
const descEl = document.getElementById('nxt-visitor-desc');
const skillsEl = document.getElementById('nxt-visitor-skills');
const avatarEl = document.getElementById('nxt-visitor-avatar');
const statusEl = document.getElementById('nxt-visitor-status');
if (nameEl) nameEl.textContent = agent.name || 'Agent';
if (descEl) {
descEl.textContent = agent.description || 'An embodied AI agent on three.ws';
}
if (agent.avatar_thumbnail_url && avatarEl) {
const img = document.createElement('img');
img.src = agent.avatar_thumbnail_url;
img.alt = agent.name || 'Agent avatar';
img.className = 'nxt-visitor-card__avatar-img';
img.loading = 'eager';
const shimmer = avatarEl.querySelector('.nxt-visitor-card__avatar-shimmer');
if (shimmer) shimmer.remove();
avatarEl.appendChild(img);
}
if (statusEl && agent.is_registered) {
statusEl.innerHTML = 'On-chain <svg width="10" height="10" viewBox="0 0 24 24" fill="currentColor" style="vertical-align:-1px"><path d="M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z"/></svg>';
}
const skills = agent.skills || [];
if (skills.length && skillsEl) {
skillsEl.hidden = false;
skillsEl.innerHTML = skills
.slice(0, 6)
.map((s) => `<span class="nxt-visitor-card__skill">${escHtml(s)}</span>`)
.join('');
}
const shareBtn = document.getElementById('nxt-visitor-share');
if (shareBtn) {
shareBtn.addEventListener('click', () => {
document.getElementById('nxt-share-btn')?.click();
});
}
getMe()
.then((me) => {
if (!me) card.hidden = false;
})
.catch(() => {
card.hidden = false;
});
}
function populateMobileStrip(agent) {
const strip = document.getElementById('nxt-mobile-agent-strip');
if (!strip) return;
const nameEl = document.getElementById('nxt-mobile-name');
const descEl = document.getElementById('nxt-mobile-desc');
const avatarEl = document.getElementById('nxt-mobile-avatar');
if (nameEl) nameEl.textContent = agent.name || 'Agent';
if (descEl) descEl.textContent = agent.description || '';
if (agent.avatar_thumbnail_url && avatarEl) {
avatarEl.style.backgroundImage = `url(${agent.avatar_thumbnail_url})`;
avatarEl.style.backgroundSize = 'cover';
avatarEl.style.backgroundPosition = 'center top';
}
const shareBtn = document.getElementById('nxt-mobile-share');
if (shareBtn) {
shareBtn.addEventListener('click', () => {
if (navigator.share) {
navigator.share({
title: `${agent.name || 'Agent'} — three.ws`,
text: `Meet ${agent.name || 'this agent'} — an embodied AI agent on three.ws`,
url: location.href,
}).catch(() => {});
} else {
document.getElementById('nxt-share-btn')?.click();
}
});
}
strip.hidden = false;
}
function updatePageTitle(agent) {
if (!agent?.name) return;
document.title = `${agent.name} — three.ws`;
const metaDesc = document.querySelector('meta[name="description"]');
if (metaDesc && agent.description) {
metaDesc.setAttribute('content', agent.description);
}
}
// ── Poster skeleton ──────────────────────────────────────────────────
function wirePosterSkeleton() {
const agentId = new URLSearchParams(location.search).get('agent');
if (!agentId) return;
const skeleton = document.getElementById('nxt-poster-skeleton');
if (!skeleton) return;
skeleton.hidden = false;
waitForViewer().then(() => {
skeleton.classList.add('nxt-poster-skeleton--fading');
setTimeout(() => {
skeleton.hidden = true;
}, 700);
});
}
// ── Helpers ───────────────────────────────────────────────────────────────
function escHtml(s) {
return String(s ?? '').replace(/[&<>"']/g, (ch) => ({
'&': '&',
'<': '<',
'>': '>',
'"': '"',
"'": ''',
})[ch]);
}
function prettify(name) {
return String(name)
.replace(/^av-/, '')
.replace(/[-_]/g, ' ')
.replace(/\b\w/g, (c) => c.toUpperCase());
}