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
// content.js — injected into the host page to mount the walking avatar iframe.
//
// Injected via chrome.scripting.executeScript({ files: [...] }) as a CLASSIC
// script (no ES modules), so the narrator is exposed on window by
// content-narrator.js (injected just before this file) rather than imported.
//
// Responsibilities: mount/unmount the avatar iframe, drag-to-reposition, a
// hover-revealed mute + close toolbar, live settings application, and relaying
// the iframe's postMessage events. Page narration is delegated to the Narrator.
(function () {
'use strict';
// Guard against double-injection on re-enable / SPA re-runs.
if (window.__threewsWalkLoaded) return;
window.__threewsWalkLoaded = true;
const THREEWS = 'https://three.ws';
const CONTAINER_ID = '__threews_walk_container__';
let container = null;
let iframe = null;
let grip = null;
let mounted = false;
let narrator = null;
let muted = false;
let settings = {};
let session = null;
// Drag state
let dragging = false;
let dragOffX = 0;
let dragOffY = 0;
const SIZE_PRESETS = {
small: { width: 120, height: 180 },
medium: { width: 180, height: 260 },
large: { width: 240, height: 340 },
};
function resolveSize(s) {
if (s.sizePreset === 'custom') {
return {
width: clamp(parseInt(s.width, 10) || 180, 80, 600),
height: clamp(parseInt(s.height, 10) || 260, 120, 800),
};
}
return SIZE_PRESETS[s.sizePreset] || SIZE_PRESETS.medium;
}
function clamp(v, lo, hi) { return Math.max(lo, Math.min(hi, v)); }
function buildEmbedSrc(avatarId) {
const p = new URLSearchParams();
if (avatarId) p.set('avatar', avatarId);
p.set('controls', 'none');
p.set('autoplay', 'true');
p.set('ground', 'false');
p.set('orbit', 'false');
p.set('bg', 'transparent');
return `${THREEWS}/walk-embed?${p.toString()}`;
}
function getPositionStyle(pos) {
const m = '16px';
switch (pos) {
case 'custom': return customPositionStyle();
case 'top-left': return { top: m, left: m, bottom: 'auto', right: 'auto' };
case 'top-right': return { top: m, right: m, bottom: 'auto', left: 'auto' };
case 'bottom-left': return { bottom: m, left: m, top: 'auto', right: 'auto' };
default: return { bottom: m, right: m, top: 'auto', left: 'auto' };
}
}
// A dragged avatar is stored as absolute viewport pixels. Re-clamp on every
// apply so a spot saved on a wide monitor still lands on screen in a narrow
// window instead of parking the avatar off the right edge.
function customPositionStyle() {
const { width, height } = resolveSize(settings);
const x = clamp(Number(settings.customX) || 0, 0, Math.max(0, window.innerWidth - width));
const y = clamp(Number(settings.customY) || 0, 0, Math.max(0, window.innerHeight - height));
return { left: x + 'px', top: y + 'px', right: 'auto', bottom: 'auto' };
}
// ── Theme ────────────────────────────────────────────────────────────────────
// Resolve light/dark for the avatar's shadow + toolbar contrast. 'auto'
// samples the host page's effective background luminance so the avatar reads
// against either a light or dark site.
function pageBackgroundLuminance() {
let el = document.body || document.documentElement;
while (el) {
const bg = getComputedStyle(el).backgroundColor;
const m = bg && bg.match(/rgba?\(([^)]+)\)/);
if (m) {
const [r, g, b, a = '1'] = m[1].split(',').map((s) => parseFloat(s));
if (parseFloat(a) > 0) {
// Rec. 709 relative luminance, 0 (black) … 1 (white).
return (0.2126 * r + 0.7152 * g + 0.0722 * b) / 255;
}
}
el = el.parentElement;
}
return 0; // No opaque background found — assume a dark canvas.
}
function resolveTheme(s) {
if (s.theme === 'light' || s.theme === 'dark') return s.theme;
return pageBackgroundLuminance() > 0.5 ? 'light' : 'dark';
}
function applyTheme() {
if (!container) return;
const theme = resolveTheme(settings);
// On a light page a soft dark shadow grounds the avatar; on a dark page a
// faint light glow keeps its silhouette legible.
container.style.filter = theme === 'light'
? 'drop-shadow(0 10px 28px rgba(0,0,0,0.28))'
: 'drop-shadow(0 10px 30px rgba(0,0,0,0.5)) drop-shadow(0 0 1px rgba(255,255,255,0.25))';
container.dataset.theme = theme;
// Hand the embed the resolved theme so its narration bubble can match.
iframe?.contentWindow?.postMessage({ type: 'walk:theme', theme }, THREEWS);
}
// ── Follow-cursor ──────────────────────────────────────────────────────────
let followHandler = null;
function enableFollowCursor() {
disableFollowCursor();
followHandler = (e) => {
if (!container || dragging) return;
const w = container.offsetWidth;
const h = container.offsetHeight;
const x = clamp(e.clientX + 24, 0, window.innerWidth - w);
const y = clamp(e.clientY - h / 2, 0, window.innerHeight - h);
container.style.left = x + 'px';
container.style.top = y + 'px';
container.style.right = 'auto';
container.style.bottom = 'auto';
};
document.addEventListener('mousemove', followHandler, { passive: true });
}
function disableFollowCursor() {
if (followHandler) {
document.removeEventListener('mousemove', followHandler);
followHandler = null;
}
}
// ── Drag to reposition ─────────────────────────────────────────────────────
// The grip in the hover toolbar is the only drag surface: the iframe below it
// swallows pointer events, so move/release listeners live on the document for
// the duration of a drag and detach on release.
function beginDrag(clientX, clientY) {
if (!container) return;
const rect = container.getBoundingClientRect();
dragging = true;
dragOffX = clientX - rect.left;
dragOffY = clientY - rect.top;
// Pin the container to its current pixel box before switching anchors, so
// a bottom/right-anchored avatar doesn't jump on grab.
container.style.left = rect.left + 'px';
container.style.top = rect.top + 'px';
container.style.right = 'auto';
container.style.bottom = 'auto';
if (grip) grip.style.cursor = 'grabbing';
// Without this the iframe eats every move once the cursor crosses into it.
if (iframe) iframe.style.pointerEvents = 'none';
document.body?.style.setProperty('user-select', 'none');
}
function moveDrag(clientX, clientY) {
if (!dragging || !container) return;
const x = clamp(clientX - dragOffX, 0, window.innerWidth - container.offsetWidth);
const y = clamp(clientY - dragOffY, 0, window.innerHeight - container.offsetHeight);
container.style.left = x + 'px';
container.style.top = y + 'px';
}
function finishDrag() {
if (!dragging) return;
dragging = false;
if (grip) grip.style.cursor = 'grab';
if (iframe) iframe.style.pointerEvents = '';
document.body?.style.removeProperty('user-select');
// A deliberate drop wins over follow-cursor and over the saved preset:
// record it as an explicit 'custom' position so the next mount, and every
// other tab, restores the avatar where the user left it.
if (!container) return;
disableFollowCursor();
const next = {
position: 'custom',
customX: Math.round(parseFloat(container.style.left) || 0),
customY: Math.round(parseFloat(container.style.top) || 0),
};
settings = { ...settings, ...next };
chrome.storage.sync.set(next);
}
function startDrag(e) {
if (e.button !== 0) return;
e.preventDefault();
beginDrag(e.clientX, e.clientY);
document.addEventListener('mousemove', onDragMove);
document.addEventListener('mouseup', onDragEnd);
}
function onDragMove(e) { moveDrag(e.clientX, e.clientY); }
function onDragEnd() {
document.removeEventListener('mousemove', onDragMove);
document.removeEventListener('mouseup', onDragEnd);
finishDrag();
}
function startDragTouch(e) {
const t = e.touches[0];
if (!t) return;
e.preventDefault();
beginDrag(t.clientX, t.clientY);
document.addEventListener('touchmove', onDragTouchMove, { passive: false });
document.addEventListener('touchend', onDragTouchEnd);
document.addEventListener('touchcancel', onDragTouchEnd);
}
function onDragTouchMove(e) {
const t = e.touches[0];
if (!t) return;
e.preventDefault();
moveDrag(t.clientX, t.clientY);
}
function onDragTouchEnd() {
document.removeEventListener('touchmove', onDragTouchMove);
document.removeEventListener('touchend', onDragTouchEnd);
document.removeEventListener('touchcancel', onDragTouchEnd);
finishDrag();
}
// Unmounting mid-drag would otherwise leave document-level listeners and the
// page's user-select lock behind.
function cancelDrag() {
if (!dragging) return;
onDragEnd();
onDragTouchEnd();
}
// ── Mount / unmount ──────────────────────────────────────────────────────────
function mount(avatarId) {
if (mounted) {
if (iframe && avatarId) {
iframe.contentWindow?.postMessage({ type: 'walk:setAvatar', id: avatarId }, THREEWS);
}
return;
}
const { width, height } = resolveSize(settings);
const pos = settings.position || 'bottom-right';
container = document.createElement('div');
container.id = CONTAINER_ID;
container.setAttribute('role', 'complementary');
container.setAttribute('aria-label', 'three.ws walking avatar');
container.style.cssText = `
position: fixed;
width: ${width}px;
height: ${height}px;
z-index: 2147483647;
background: transparent;
border-radius: 14px;
overflow: visible;
pointer-events: auto;
filter: drop-shadow(0 10px 28px rgba(0,0,0,0.32));
`;
Object.assign(container.style, getPositionStyle(pos));
// Hover toolbar (drag handle + mute + close)
const toolbar = document.createElement('div');
toolbar.style.cssText = `
position: absolute;
top: -2px; left: 0; right: 0;
height: 26px;
display: flex;
align-items: center;
justify-content: flex-end;
gap: 4px;
padding: 0 4px;
opacity: 0;
transition: opacity 0.18s ease;
z-index: 10;
`;
grip = document.createElement('div');
grip.title = 'Drag to move';
grip.style.cssText = `
flex: 1;
height: 22px;
cursor: grab;
border-radius: 8px;
background: rgba(0,0,0,0.22);
backdrop-filter: blur(6px);
-webkit-backdrop-filter: blur(6px);
`;
const muteBtn = iconButton(muteIcon(muted), muted ? 'Unmute narration' : 'Mute narration');
muteBtn.id = '__threews_mute_btn__';
muteBtn.addEventListener('click', toggleMute);
const closeBtn = iconButton('×', 'Hide avatar');
closeBtn.style.fontSize = '16px';
closeBtn.addEventListener('click', () => unmount());
toolbar.appendChild(grip);
toolbar.appendChild(muteBtn);
toolbar.appendChild(closeBtn);
iframe = document.createElement('iframe');
iframe.src = buildEmbedSrc(avatarId);
iframe.title = 'three.ws walking avatar';
iframe.allow = 'accelerometer; gyroscope; autoplay';
iframe.setAttribute('scrolling', 'no');
iframe.style.cssText = `
width: 100%;
height: 100%;
border: 0;
background: transparent;
display: block;
border-radius: 14px;
`;
container.appendChild(iframe);
container.appendChild(toolbar);
(document.body || document.documentElement).appendChild(container);
mounted = true;
container.addEventListener('mouseenter', () => { toolbar.style.opacity = '1'; });
container.addEventListener('mouseleave', () => { toolbar.style.opacity = '0'; });
grip.addEventListener('mousedown', startDrag);
grip.addEventListener('touchstart', startDragTouch, { passive: false });
window.addEventListener('message', onIframeMessage);
// Apply runtime config once the embed signals readiness.
applyLiveConfig();
applyTheme();
if (settings.position === 'follow-cursor') enableFollowCursor();
// Start narration if enabled and motion is allowed.
maybeStartNarrator();
}
function unmount() {
if (!mounted) return;
window.removeEventListener('message', onIframeMessage);
disableFollowCursor();
cancelDrag();
narrator?.stop();
narrator = null;
if (container && container.parentNode) container.parentNode.removeChild(container);
container = null;
iframe = null;
grip = null;
mounted = false;
window.__threewsWalkLoaded = false; // allow a clean re-mount later
}
function iconButton(label, title) {
const b = document.createElement('button');
b.type = 'button';
b.title = title;
b.setAttribute('aria-label', title);
b.innerHTML = label;
b.style.cssText = `
width: 22px; height: 22px;
border: 0;
border-radius: 7px;
background: rgba(0,0,0,0.34);
color: rgba(255,255,255,0.86);
font-size: 13px;
line-height: 1;
cursor: pointer;
display: flex;
align-items: center;
justify-content: center;
backdrop-filter: blur(6px);
-webkit-backdrop-filter: blur(6px);
padding: 0;
`;
b.addEventListener('mouseenter', () => { b.style.background = 'rgba(0,0,0,0.55)'; });
b.addEventListener('mouseleave', () => { b.style.background = 'rgba(0,0,0,0.34)'; });
return b;
}
function muteIcon(isMuted) {
return isMuted
? '<svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 5 6 9H2v6h4l5 4V5z"/><line x1="23" y1="9" x2="17" y2="15"/><line x1="17" y1="9" x2="23" y2="15"/></svg>'
: '<svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 5 6 9H2v6h4l5 4V5z"/><path d="M15.54 8.46a5 5 0 0 1 0 7.07"/><path d="M19.07 4.93a10 10 0 0 1 0 14.14"/></svg>';
}
function toggleMute() {
muted = !muted;
const btn = document.getElementById('__threews_mute_btn__');
if (btn) {
btn.innerHTML = muteIcon(muted);
btn.title = muted ? 'Unmute narration' : 'Mute narration';
btn.setAttribute('aria-label', btn.title);
}
if (muted) narrator?.mute();
else narrator?.unmute();
}
// ── Live config ──────────────────────────────────────────────────────────────
function applyLiveConfig() {
if (!iframe) return;
const speed = settings.walkSpeed || 1;
const send = () => {
iframe.contentWindow?.postMessage({ type: 'walk:config', speed }, THREEWS);
iframe.contentWindow?.postMessage({ type: 'walk:setMotion', motion: 'walk' }, THREEWS);
};
// The embed posts walk:ready when its scene is up; send immediately and
// once more shortly after to cover the race before the listener attaches.
send();
setTimeout(send, 800);
}
function applySettings(next) {
settings = { ...settings, ...next };
if (!mounted || !container) return;
const { width, height } = resolveSize(settings);
container.style.width = width + 'px';
container.style.height = height + 'px';
if (settings.position === 'follow-cursor') {
enableFollowCursor();
} else {
disableFollowCursor();
Object.assign(container.style, getPositionStyle(settings.position || 'bottom-right'));
}
applyLiveConfig();
applyTheme();
maybeStartNarrator();
}
// ── Narrator ───────────────────────────────────────────────────────────────
function maybeStartNarrator() {
const reduced = window.matchMedia?.('(prefers-reduced-motion: reduce)')?.matches;
if (!settings.narrationEnabled || reduced) {
narrator?.stop();
narrator = null;
return;
}
if (narrator) {
narrator.refresh();
return;
}
const NarratorClass = window.__ThreewsWalkNarrator;
if (!NarratorClass) return;
narrator = new NarratorClass({
getIframe: () => iframe,
getSession: () => session,
getSettings: () => settings,
isMuted: () => muted,
});
narrator.start();
}
// ── iframe → host relay ──────────────────────────────────────────────────────
function onIframeMessage(e) {
if (!iframe || e.source !== iframe.contentWindow) return;
const data = e.data;
if (!data || typeof data !== 'object') return;
if (data.type === 'walk:ready') { applyLiveConfig(); applyTheme(); }
// Surface avatar events to the host page for any listeners.
try {
document.dispatchEvent(new CustomEvent('threews-walk', { detail: data }));
} catch {}
}
// SPA route changes don't disturb a fixed-position overlay, so no history
// patching is needed — the container persists across pushState navigations.
// ── Runtime messaging ────────────────────────────────────────────────────────
chrome.runtime.onMessage.addListener((msg) => {
switch (msg.type) {
case 'walk:mount':
loadContext().then(() => mount(msg.avatarId || settings.avatarId));
break;
case 'walk:unmount':
unmount();
break;
case 'walk:setAvatar':
if (iframe) iframe.contentWindow?.postMessage({ type: 'walk:setAvatar', id: msg.avatarId }, THREEWS);
break;
case 'walk:applySettings':
applySettings(msg.settings || {});
break;
default:
break;
}
});
// Load cached settings + session before the first mount.
async function loadContext() {
const [{ threews_session }, sync] = await Promise.all([
chrome.storage.local.get('threews_session'),
chrome.storage.sync.get(null),
]);
session = threews_session || null;
settings = { ...settings, ...sync };
}
})();