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
// three.ws global search — Cmd/Ctrl-K command palette.
// Self-mounting IIFE: nav.js loads this on every page.
// Data sources:
// • /api/explore?q= — live DB query for agents/avatars (debounced)
// • /api/pump/search?q= — live coin/token search (falls back to trending)
// • /features.json — static page/feature registry (loaded once)
// • /skills-index.json — skill catalog (loaded once)
// • quick actions + recents — in-memory verbs + localStorage history
//
// Beyond search, the palette EXECUTES commands in place — it is the agent's
// command line, not just a router. Type a verb and the work happens inside
// the panel against the real public APIs (no auth needed):
// • forge <prompt> → POST /api/forge (free text→3D lane), polls to a GLB
// • digest → GET /api/news/digest — the day clustered into stories
// • price <coin|$X> → GET /api/coin/markets + /detail (falls back to pump)
// • ask <question> → POST /api/chat — streamed answer from the site agent
// Command completions are announced on the DOM ('tws:palette-action') and the
// agent bus ('action:taken') so the corner companion can react to them.
// Opt out per page: <html data-search="off">
(function () {
'use strict';
if (window.__twsSearch) return;
if (typeof document === 'undefined') return;
if (document.documentElement.getAttribute('data-search') === 'off') return;
window.__twsSearch = true;
// ── CSS ──────────────────────────────────────────────────────────────────
var CSS = [
/* dialog reset */
'#tws-search-dialog{all:unset;display:none;position:fixed;inset:0;z-index:9999;}',
'#tws-search-dialog[open]{display:flex;align-items:flex-start;justify-content:center;padding:80px 16px 16px;}',
/* backdrop */
'#tws-search-backdrop{position:fixed;inset:0;background:rgba(0,0,0,0.72);backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px);animation:tws-sk-fadein .12s ease;}',
/* panel */
'#tws-search-panel{position:relative;z-index:1;background:#111;border:1px solid #2a2a2a;border-radius:14px;width:100%;max-width:620px;overflow:hidden;',
'box-shadow:0 24px 80px rgba(0,0,0,0.7),0 0 0 1px rgba(255,255,255,0.04);',
'animation:tws-sk-slidein .14s cubic-bezier(.25,.46,.45,.94);}',
/* input row */
'#tws-search-row{display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1px solid #1c1c1c;}',
'#tws-search-icon{flex-shrink:0;width:18px;height:18px;color:#6a6a6a;}',
'#tws-search-input{flex:1;background:none;border:none;outline:none;font:500 15px/1 inherit;color:#f6f6f6;caret-color:#f6f6f6;letter-spacing:-.01em;}',
'#tws-search-input::placeholder{color:#4a4a4a;}',
'#tws-search-kbd{display:flex;gap:4px;flex-shrink:0;}',
'.tws-sk-key{display:inline-flex;align-items:center;justify-content:center;',
'height:20px;padding:0 5px;border-radius:4px;border:1px solid #2a2a2a;',
'font:600 10px/1 "JetBrains Mono",ui-monospace,monospace;color:#4a4a4a;letter-spacing:.06em;}',
/* results */
'#tws-search-results{overflow-y:auto;max-height:420px;padding:6px 0 8px;}',
'#tws-search-results:empty{padding:0;}',
/* category header */
'.tws-sk-cat{font:600 10px/1 "JetBrains Mono",ui-monospace,monospace;',
'letter-spacing:.14em;text-transform:uppercase;color:#4a4a4a;',
'padding:10px 16px 4px;user-select:none;}',
'.tws-sk-cat:first-child{padding-top:6px;}',
/* result row */
'.tws-sk-row{display:flex;align-items:center;gap:10px;padding:8px 16px;cursor:pointer;',
'border-radius:0;transition:background .1s;outline:none;text-decoration:none;color:inherit;}',
'.tws-sk-row:hover,.tws-sk-row[aria-selected="true"]{background:#1c1c1c;}',
'.tws-sk-row:active{background:#242424;}',
'.tws-sk-row:focus-visible{background:#1c1c1c;outline:2px solid rgba(255,255,255,0.22);outline-offset:-2px;}',
/* row icon */
'.tws-sk-ico{flex-shrink:0;width:32px;height:32px;border-radius:8px;',
'background:#181818;border:1px solid #2a2a2a;display:flex;align-items:center;justify-content:center;font-size:15px;}',
'.tws-sk-ico img{width:100%;height:100%;object-fit:cover;border-radius:7px;}',
/* row text */
'.tws-sk-body{flex:1;min-width:0;}',
'.tws-sk-name{font-size:13.5px;font-weight:500;color:#f6f6f6;letter-spacing:-.01em;',
'white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}',
'.tws-sk-name mark{background:rgba(255,255,255,0.15);color:#fff;border-radius:3px;padding:0 2px;font-style:normal;}',
'.tws-sk-desc{font-size:11.5px;color:#6a6a6a;margin-top:1px;',
'white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}',
/* badge */
'.tws-sk-badge{flex-shrink:0;font:600 9px/1 "JetBrains Mono",ui-monospace,monospace;',
'letter-spacing:.08em;text-transform:uppercase;padding:3px 6px;',
'border-radius:5px;background:#1c1c1c;border:1px solid #2a2a2a;color:#6a6a6a;}',
/* states */
'#tws-search-status{padding:20px 16px;font-size:13px;color:#6a6a6a;text-align:center;',
'display:flex;flex-direction:column;align-items:center;gap:8px;}',
'#tws-search-status .tws-sk-err-retry{',
'margin-top:4px;padding:6px 14px;border-radius:7px;font-size:12px;',
'background:#1c1c1c;border:1px solid #2a2a2a;color:#a8a8a8;cursor:pointer;',
'text-decoration:none;transition:background .12s,border-color .12s;}',
'#tws-search-status .tws-sk-err-retry:hover{background:#242424;border-color:#3a3a3a;color:#f6f6f6;}',
/* spinner */
'.tws-sk-spinner{width:18px;height:18px;border:2px solid #2a2a2a;border-top-color:#6a6a6a;',
'border-radius:50%;animation:tws-sk-spin .7s linear infinite;}',
/* skeleton rows */
'.tws-sk-skel{display:flex;align-items:center;gap:10px;padding:8px 16px;}',
'.tws-sk-skel-ico{width:32px;height:32px;border-radius:8px;background:#1c1c1c;animation:tws-sk-pulse 1.4s ease infinite;}',
'.tws-sk-skel-lines{flex:1;display:flex;flex-direction:column;gap:5px;}',
'.tws-sk-skel-l{height:12px;border-radius:4px;background:#1c1c1c;animation:tws-sk-pulse 1.4s ease infinite;}',
'.tws-sk-skel-l.w60{width:60%}.tws-sk-skel-l.w40{width:40%}.tws-sk-skel-l.w80{width:80%}',
/* command run panel */
'.tws-sk-run-head{display:flex;align-items:center;gap:10px;padding:12px 16px;border-bottom:1px solid #1c1c1c;}',
'.tws-sk-run-title{flex:1;min-width:0;font-size:13.5px;font-weight:600;color:#f6f6f6;letter-spacing:-.01em;',
'white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}',
'.tws-sk-run-status{flex-shrink:0;display:flex;align-items:center;gap:8px;',
'font:500 11px/1 "JetBrains Mono",ui-monospace,monospace;color:#6a6a6a;letter-spacing:.04em;}',
'.tws-sk-run-status.ok{color:#4ade80;}',
'.tws-sk-run-status.err{color:#f87171;}',
'.tws-sk-run-body{padding:4px 0 6px;}',
'.tws-sk-answer{padding:10px 16px 12px;font-size:13px;line-height:1.55;color:#d6d6d6;',
'white-space:pre-wrap;overflow-wrap:break-word;max-height:300px;overflow-y:auto;}',
'.tws-sk-answer:empty::before{content:"…";color:#4a4a4a;}',
'.tws-sk-run-foot{padding:8px 16px 10px;border-top:1px solid #1c1c1c;',
'font:500 10px/1 "JetBrains Mono",ui-monospace,monospace;color:#4a4a4a;letter-spacing:.08em;text-transform:uppercase;}',
/* live region */
'#tws-search-live{position:absolute;left:-9999px;width:1px;height:1px;overflow:hidden;}',
/* keyframes */
'@keyframes tws-sk-fadein{from{opacity:0}to{opacity:1}}',
'@keyframes tws-sk-slidein{from{opacity:0;transform:translateY(-8px) scale(.98)}to{opacity:1;transform:translateY(0) scale(1)}}',
'@keyframes tws-sk-spin{to{transform:rotate(360deg)}}',
'@keyframes tws-sk-pulse{0%,100%{opacity:.5}50%{opacity:1}}',
].join('');
(function injectCSS() {
if (document.getElementById('tws-search-css')) return;
var s = document.createElement('style');
s.id = 'tws-search-css';
s.textContent = CSS;
document.head.appendChild(s);
})();
// ── State ────────────────────────────────────────────────────────────────
var dialog, backdrop, panel, input, results, status, liveRegion;
var featuresCache = null;
var skillsCache = null;
var debounceTimer = null;
var currentController = null; // AbortController for in-flight explore requests
var selectedIndex = -1;
var allRows = []; // flat list of result row elements for keyboard nav
// ── Data fetching ─────────────────────────────────────────────────────────
function fetchFeatures() {
if (featuresCache) return Promise.resolve(featuresCache);
return fetch('/features.json')
.then(function (r) { return r.ok ? r.json() : Promise.reject(r.status); })
.then(function (data) {
// Flatten sections into a single array of {path, title, description, section}
var pages = [];
var jobTitles = {};
(data.jobs || []).forEach(function (j) { jobTitles[j.id] = j.title; });
(data.sections || []).forEach(function (sec) {
(sec.pages || []).forEach(function (p) {
if (p.indexable === false) return;
pages.push({
path: p.path,
title: p.title,
description: p.description || '',
section: sec.id,
sectionTitle: (p.job && jobTitles[p.job]) || sec.title || sec.id,
});
});
});
featuresCache = pages;
return pages;
});
}
function fetchSkills() {
if (skillsCache) return Promise.resolve(skillsCache);
return fetch('/skills-index.json')
.then(function (r) { return r.ok ? r.json() : Promise.reject(r.status); })
.then(function (data) {
skillsCache = Array.isArray(data) ? data : [];
return skillsCache;
});
}
// Full-text documentation search. The engine and its index live in
// /docs-search.js + /docs-search-index.json and are pulled in on the first
// keystroke, never on page load: the index is ~1.4 MB and most visitors
// never open this palette at all.
//
// Until it arrives, every other source still renders on time. `onReady` fires
// once the engine is usable so the caller can re-run the query it already
// showed results for.
var docsEngine = null;
var docsEnginePending = null;
var docsEngineFailed = false;
function docsSearchEngine(onReady) {
if (docsEngine || docsEngineFailed) return docsEngine;
if (!docsEnginePending) {
docsEnginePending = new Promise(function (resolve) {
if (window.twsDocsSearch) return resolve(window.twsDocsSearch);
var script = document.createElement('script');
script.src = '/docs-search.js';
script.onload = function () { resolve(window.twsDocsSearch || null); };
script.onerror = function () { resolve(null); };
document.head.appendChild(script);
})
.then(function (engine) {
return engine ? engine.ready().then(function (ok) { return ok ? engine : null; }) : null;
})
.then(function (engine) {
docsEngine = engine;
// A palette that retried a failed 1.4 MB fetch on every keystroke
// would be worse than one that quietly offers fewer sources.
docsEngineFailed = !engine;
if (engine && typeof onReady === 'function') onReady();
return engine;
});
}
return null;
}
function fetchAgents(q, signal) {
var url = '/api/explore?q=' + encodeURIComponent(q) + '&limit=6&source=all&quality=all';
return fetch(url, { signal: signal })
.then(function (r) { return r.ok ? r.json() : Promise.reject(r.status); })
.then(function (data) { return data.items || []; });
}
// Live coin/token search. Primary source is /api/pump/search (name/symbol
// search across Solana tokens). If that endpoint is unavailable, fall back to
// filtering /api/pump/trending — still real pump.fun/Birdeye data, just scoped
// to what's trending — so the Coins category degrades instead of disappearing.
function fetchCoins(q, signal) {
var ql = q.toLowerCase();
return fetch('/api/pump/search?q=' + encodeURIComponent(q) + '&limit=6', { signal: signal })
.then(function (r) { return r.ok ? r.json() : Promise.reject(r.status); })
.then(function (data) { return (data && data.data) || []; })
.catch(function (err) {
if (err && err.name === 'AbortError') throw err; // propagate cancellation
return fetch('/api/pump/trending?limit=50', { signal: signal })
.then(function (r) { return r.ok ? r.json() : Promise.reject(r.status); })
.then(function (data) {
var coins = (data && data.data) || [];
return coins.filter(function (c) {
return matches(c.symbol, ql) || matches(c.name, ql);
}).slice(0, 6);
})
.catch(function (e) { if (e && e.name === 'AbortError') throw e; return []; });
});
}
// ── Quick actions ──────────────────────────────────────────────────────────
// First-class verbs the palette can run from anywhere. Matched by title +
// keyword bag so "make an avatar" finds "Create an avatar".
var QUICK_ACTIONS = [
{ title: 'Create an avatar', desc: 'Start a new 3D avatar', href: '/create', icon: '🧑🎨', keys: 'create new make avatar character build start' },
{ title: 'Scan yourself to 3D', desc: 'Turn a selfie into a 3D model', href: '/scan', icon: '📸', keys: 'scan selfie photo capture me face camera' },
{ title: 'Forge from text', desc: 'Generate a 3D model from a prompt', href: '/forge', icon: '✨', keys: 'forge generate text prompt ai model create' },
{ title: 'Deploy an agent on-chain', desc: 'Register an agent on-chain', href: '/deploy', icon: '🚀', keys: 'deploy register onchain erc8004 publish ship launch agent' },
{ title: 'Launch a coin', desc: 'Launch a token on pump.fun', href: '/launch', icon: '🪙', keys: 'launch coin token mint pump fun money $three' },
{ title: 'Embed an agent', desc: 'Get an embed snippet for your site', href: '/embed.html', icon: '🔗', keys: 'embed iframe widget snippet share script integrate' },
{ title: 'Browse by goal', desc: 'Every feature grouped by what you want to do', href: '/everything', icon: '🧭', keys: 'everything features goal what can i do browse explore capabilities directory catalog help start' },
{ title: 'Browse all pages', desc: 'The full three.ws directory, filterable', href: '/sitemap', icon: '🗺️', keys: 'sitemap site map all pages everything directory index list browse find' },
];
// ── Commands ───────────────────────────────────────────────────────────────
// Executable verbs. Unlike QUICK_ACTIONS (which navigate), a command runs in
// place: activating it opens the run panel and does the actual work against
// the real API. Matching is intentionally strict verb-first parsing — the
// palette must never hijack a plain search query.
function fetchJson(url, opts) {
return fetch(url, opts).then(function (r) {
if (!r.ok) { var e = new Error('HTTP ' + r.status); e.status = r.status; throw e; }
return r.json();
});
}
// Anonymous per-browser client id sent to the free forge lane (its only
// identifying header; used server-side for telemetry, not auth).
function forgeClientId() {
try {
var v = localStorage.getItem('tws:forge:client');
if (!v) {
v = Math.random().toString(36).slice(2) + Date.now().toString(36);
localStorage.setItem('tws:forge:client', v);
}
return v;
} catch (_) { return 'anon'; }
}
// Broadcast a command lifecycle beat so other surfaces (the corner companion,
// the agent bus's mood engine) can react to what the visitor just did.
function emitAction(action, phase, detail) {
var payload = Object.assign({ action: action, phase: phase }, detail || {});
try {
document.dispatchEvent(new CustomEvent('tws:palette-action', { detail: payload }));
} catch (_) {}
try {
var bus = window.__agentBus || window.__threewsAgentBus;
if (bus && bus.emit) bus.emit('action:taken', Object.assign({ agentId: null, source: 'palette' }, payload));
} catch (_) {}
}
var CMD_DEFS = [
{
id: 'forge',
icon: '✨',
example: 'forge a bronze dragon statue',
prefill: 'forge ',
match: function (q) {
var m = q.match(/^(?:forge|make|generate|imagine)\s+(.{3,200})$/i);
return m ? { prompt: m[1].trim() } : null;
},
title: function (a) { return 'Forge “' + a.prompt + '”'; },
desc: 'Generate a real 3D model right here — free text→3D lane',
run: runForgeCommand,
},
{
id: 'digest',
icon: '📰',
example: 'digest',
match: function (q) {
return /^(?:digest|briefing|news digest|what happened(?:\s+today)?\??|today)$/i.test(q) ? {} : null;
},
title: function () { return 'Today’s crypto digest'; },
desc: 'The last 24h clustered into narratives, right here',
run: runDigestCommand,
},
{
id: 'price',
icon: '💹',
example: 'price btc',
prefill: 'price ',
match: function (q) {
var m = q.match(/^(?:price|quote)\s+(.{1,40})$/i) || q.match(/^\$([a-z0-9]{1,15})$/i);
return m ? { query: m[1].trim() } : null;
},
title: function (a) { return 'Price of ' + a.query; },
desc: 'Live market data — majors and pump.fun coins',
run: runPriceCommand,
},
{
id: 'ask',
icon: '💬',
example: 'ask what is x402?',
prefill: 'ask ',
match: function (q) {
var m = q.match(/^ask\s+(.{3,400})$/i);
if (m) return { question: m[1].trim() };
// A natural question ("how do agents pay each other?") is offered as
// an option below the search results — never auto-run.
if (q.length >= 10 && /\?$/.test(q)) return { question: q };
return null;
},
title: function () { return 'Ask your agent'; },
desc: 'Streamed answer from the site agent — free, no account',
run: runAskCommand,
},
];
// Parse a query into the first matching command. Exposed on the public API
// for tests and for other surfaces (the companion dock) to reuse.
function parseCommand(q) {
var query = String(q || '').trim();
if (!query) return null;
for (var i = 0; i < CMD_DEFS.length; i++) {
var args = CMD_DEFS[i].match(query);
if (args) return { def: CMD_DEFS[i], args: args };
}
return null;
}
// Every command matching the query (a "$sol?" style query can match two).
function matchedCommands(q) {
var query = String(q || '').trim();
if (!query) return [];
var out = [];
for (var i = 0; i < CMD_DEFS.length; i++) {
var args = CMD_DEFS[i].match(query);
if (args) out.push({ def: CMD_DEFS[i], args: args });
}
return out;
}
// Default destinations shown when the palette opens with no query (and no
// recent history yet) — the flagship surfaces, so the palette is never empty.
var SUGGESTED_PAGES = [
{ title: 'Explore agents', desc: 'Browse the agent & avatar directory', href: '/discover', icon: '🔭' },
{ title: 'Marketplace', desc: 'Skills, agents and templates', href: '/marketplace', icon: '🛒' },
{ title: 'Dashboard', desc: 'Your agents, tokens and activity', href: '/dashboard', icon: '📊' },
{ title: 'Playground', desc: 'Walk the $three worlds', href: '/play', icon: '🎮' },
{ title: 'Docs', desc: 'Guides, SDK and API reference', href: '/docs', icon: '📖' },
{ title: 'Browse by goal', desc: 'Every feature grouped by what you want to do', href: '/everything', icon: '🧭' },
];
// ── Recents ─────────────────────────────────────────────────────────────────
// Last few things the user opened from the palette, newest first.
var RECENT_KEY = 'tws:search:recent';
var RECENT_MAX = 6;
function loadRecent() {
try {
var raw = localStorage.getItem(RECENT_KEY);
var arr = raw ? JSON.parse(raw) : [];
return Array.isArray(arr) ? arr.filter(function (r) { return r && r.href && r.name; }) : [];
} catch (_) { return []; }
}
function recordRecent(payload) {
if (!payload || !payload.href || !payload.name) return;
try {
var list = loadRecent().filter(function (r) { return r.href !== payload.href; });
list.unshift({
href: payload.href,
name: payload.name,
desc: payload.desc || '',
badge: payload.badge || '',
iconHTML: payload.iconHTML || '🕘',
});
localStorage.setItem(RECENT_KEY, JSON.stringify(list.slice(0, RECENT_MAX)));
} catch (_) {}
}
// ── String helpers ────────────────────────────────────────────────────────
function escapeRegex(s) {
return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
}
function highlight(text, q) {
if (!q) return esc(text);
var re = new RegExp('(' + escapeRegex(q) + ')', 'gi');
return esc(text).replace(re, '<mark>$1</mark>');
}
// Escapes the full special five. The apostrophe matters: results are
// interpolated into attribute values, and a single-quoted attribute is
// escapable with a bare ' if it is left unescaped.
function esc(s) {
return String(s || '')
.replace(/&/g, '&')
.replace(/</g, '<')
.replace(/>/g, '>')
.replace(/"/g, '"')
.replace(/'/g, ''');
}
function matches(text, q) {
return (text || '').toLowerCase().indexOf(q.toLowerCase()) !== -1;
}
function score(item, q) {
var name = (item.title || item.name || '').toLowerCase();
var ql = q.toLowerCase();
if (name === ql) return 3;
if (name.startsWith(ql)) return 2;
if (name.indexOf(ql) !== -1) return 1;
return 0;
}
// ── DOM helpers ───────────────────────────────────────────────────────────
function el(tag, attrs) {
var e = document.createElement(tag);
if (attrs) {
Object.keys(attrs).forEach(function (k) {
if (k === 'html') { e.innerHTML = attrs[k]; }
else if (k === 'text') { e.textContent = attrs[k]; }
else { e.setAttribute(k, attrs[k]); }
});
}
return e;
}
function categoryHeader(label) {
var h = el('div', { class: 'tws-sk-cat', 'aria-hidden': 'true' });
h.textContent = label;
return h;
}
function resultRow(href, iconHTML, name, desc, badge, q, opts) {
var run = opts && opts.run;
var a = el('a', {
class: 'tws-sk-row',
href: href,
role: 'option',
'aria-selected': 'false',
tabindex: '-1',
});
var ico = el('div', { class: 'tws-sk-ico', 'aria-hidden': 'true' });
ico.innerHTML = iconHTML;
a.appendChild(ico);
var body = el('div', { class: 'tws-sk-body' });
var nameEl = el('div', { class: 'tws-sk-name', html: highlight(name, q) });
body.appendChild(nameEl);
if (desc) {
var descEl = el('div', { class: 'tws-sk-desc', text: desc });
body.appendChild(descEl);
}
a.appendChild(body);
if (badge) {
var b = el('span', { class: 'tws-sk-badge', text: badge });
a.appendChild(b);
}
if (run) {
// Command rows execute in place instead of navigating; they never enter
// the Recents list (a recent must be a re-openable destination).
a._twsRun = run;
a.addEventListener('click', function (e) { e.preventDefault(); run(); });
return a;
}
// Payload replayed into the Recents list when this row is opened.
a._twsRecent = { href: href, name: name, desc: desc || '', badge: badge || '', iconHTML: iconHTML };
a.addEventListener('click', function () { recordRecent(a._twsRecent); close(); });
return a;
}
function agentIcon(item) {
if (item.image) {
return '<img src="' + esc(item.image) + '" alt="" loading="lazy" />';
}
return '🤖';
}
function coinIcon(coin) {
if (coin.logo) {
return '<img src="' + esc(coin.logo) + '" alt="" loading="lazy" />';
}
return '🪙';
}
function pageIcon(section) {
var map = {
main: '🏠', build: '🔨', labs: '🧪', crypto: '🔗',
'agent-tools': '🛠', account: '👤', learn: '📖',
blog: '📝', legal: '⚖️', machine: '⚙️', news: '📰',
};
return map[section] || '📄';
}
function skillIcon() { return '⚡'; }
function skeletonRows(n) {
var f = document.createDocumentFragment();
for (var i = 0; i < n; i++) {
var row = el('div', { class: 'tws-sk-skel' });
var ico = el('div', { class: 'tws-sk-skel-ico' });
var lines = el('div', { class: 'tws-sk-skel-lines' });
var l1 = el('div', { class: 'tws-sk-skel-l w60' });
var l2 = el('div', { class: 'tws-sk-skel-l w40' });
lines.appendChild(l1);
lines.appendChild(l2);
row.appendChild(ico);
row.appendChild(lines);
f.appendChild(row);
}
return f;
}
// ── Build UI ──────────────────────────────────────────────────────────────
function buildUI() {
if (document.getElementById('tws-search-dialog')) return;
// Backdrop (sits behind the panel but inside dialog)
backdrop = el('div', { id: 'tws-search-backdrop' });
backdrop.addEventListener('click', close);
// Input row
var inputRow = el('div', { id: 'tws-search-row' });
var searchIconSvg = [
'<svg id="tws-search-icon" viewBox="0 0 18 18" fill="none"',
' stroke="currentColor" stroke-width="1.6" stroke-linecap="round" aria-hidden="true">',
'<circle cx="7.5" cy="7.5" r="5"/><line x1="11.5" y1="11.5" x2="16" y2="16"/></svg>',
].join('');
inputRow.insertAdjacentHTML('beforeend', searchIconSvg);
input = el('input', {
id: 'tws-search-input',
type: 'search',
placeholder: 'Search — or type forge …, digest, price btc, ask …',
autocomplete: 'off',
autocorrect: 'off',
spellcheck: 'false',
'aria-label': 'Search',
'aria-controls': 'tws-search-results',
'aria-autocomplete': 'list',
role: 'combobox',
'aria-expanded': 'false',
'aria-activedescendant': '',
});
inputRow.appendChild(input);
var kbdWrap = el('div', { id: 'tws-search-kbd', 'aria-hidden': 'true' });
var k1 = el('kbd', { class: 'tws-sk-key' });
k1.textContent = /Mac|iPod|iPhone|iPad/.test(navigator.platform || navigator.userAgent) ? '⌘' : 'Ctrl';
var k2 = el('kbd', { class: 'tws-sk-key' });
k2.textContent = 'K';
kbdWrap.appendChild(k1);
kbdWrap.appendChild(k2);
inputRow.appendChild(kbdWrap);
// Results listbox
results = el('div', {
id: 'tws-search-results',
role: 'listbox',
'aria-label': 'Search results',
});
// Status area
status = el('div', { id: 'tws-search-status', 'aria-live': 'polite', 'aria-atomic': 'true' });
status.hidden = true;
// Live region for screen readers
liveRegion = el('div', { id: 'tws-search-live', 'aria-live': 'assertive', 'aria-atomic': 'true' });
// Panel
panel = el('div', { id: 'tws-search-panel', role: 'dialog', 'aria-modal': 'true', 'aria-label': 'Search' });
panel.appendChild(inputRow);
panel.appendChild(results);
panel.appendChild(status);
panel.appendChild(liveRegion);
// Outer dialog (focus trap container)
dialog = el('div', { id: 'tws-search-dialog' });
dialog.setAttribute('role', 'dialog');
dialog.setAttribute('aria-modal', 'true');
dialog.appendChild(backdrop);
dialog.appendChild(panel);
document.body.appendChild(dialog);
// Wire events
input.addEventListener('input', onInput);
input.addEventListener('keydown', onKeydown);
dialog.addEventListener('keydown', onDialogKeydown);
}
// ── Open / Close ──────────────────────────────────────────────────────────
function open() {
buildUI();
dialog.setAttribute('open', '');
document.body.style.overflow = 'hidden';
input.value = '';
selectedIndex = -1;
allRows = [];
showInitial();
requestAnimationFrame(function () { input.focus(); });
// Prefetch static data in the background
fetchFeatures().catch(function () {});
fetchSkills().catch(function () {});
}
function close() {
if (!dialog) return;
stopRun();
dialog.removeAttribute('open');
document.body.style.overflow = '';
if (debounceTimer) { clearTimeout(debounceTimer); debounceTimer = null; }
if (currentController) { currentController.abort(); currentController = null; }
selectedIndex = -1;
allRows = [];
}
function isOpen() {
return dialog && dialog.hasAttribute('open');
}
// ── Keyboard handlers ──────────────────────────────────────────────────────
function onDialogKeydown(e) {
if (e.key === 'Escape') {
e.preventDefault();
// From a run panel, Esc steps back to the search results; a second Esc
// closes the palette.
if (runActive) { exitRunPanel(true); input.focus(); return; }
close();
}
}
function onKeydown(e) {
switch (e.key) {
case 'ArrowDown':
e.preventDefault();
moveSelection(1);
break;
case 'ArrowUp':
e.preventDefault();
moveSelection(-1);
break;
case 'Enter':
e.preventDefault();
activateSelected();
break;
case 'Tab':
e.preventDefault();
moveSelection(e.shiftKey ? -1 : 1);
break;
}
}
function moveSelection(dir) {
if (!allRows.length) return;
selectedIndex = Math.max(-1, Math.min(allRows.length - 1, selectedIndex + dir));
allRows.forEach(function (r, i) {
var sel = i === selectedIndex;
r.setAttribute('aria-selected', sel ? 'true' : 'false');
if (sel) {
r.scrollIntoView({ block: 'nearest' });
input.setAttribute('aria-activedescendant', r.id || ('tws-sk-row-' + i));
}
});
if (selectedIndex === -1) input.setAttribute('aria-activedescendant', '');
}
function activateSelected() {
if (selectedIndex >= 0 && allRows[selectedIndex]) {
var row = allRows[selectedIndex];
if (row._twsRun) { row._twsRun(); return; }
recordRecent(row._twsRecent);
close();
window.location.href = row.href;
}
}
// ── States ─────────────────────────────────────────────────────────────────
function showInitial() {
var groups = [];
// Lead with the executable verbs — the palette is a command line first.
groups.push({
label: 'Do',
items: CMD_DEFS.map(commandExampleRow),
});
var recent = loadRecent();
if (recent.length) {
groups.push({
label: 'Recent',
items: recent.map(function (r) {
return { el: resultRow(r.href, r.iconHTML, r.name, r.desc, r.badge, '') };
}),
});
}
groups.push({
label: 'Quick actions',
items: QUICK_ACTIONS.map(function (a) {
return { el: resultRow(a.href, a.icon, a.title, a.desc, 'Action', '') };
}),
});
groups.push({
label: recent.length ? 'Jump to' : 'Suggested',
items: SUGGESTED_PAGES.map(function (p) {
return { el: resultRow(p.href, p.icon, p.title, p.desc, '', '') };
}),
});
renderResults(groups, '', { silent: true });
}
function showLoading() {
results.innerHTML = '';
allRows = [];
selectedIndex = -1;
status.hidden = true;
results.appendChild(skeletonRows(4));
input.setAttribute('aria-expanded', 'true');
}
function showNoResults(q) {
results.innerHTML = '';
allRows = [];
selectedIndex = -1;
status.hidden = false;
input.setAttribute('aria-expanded', 'false');
status.innerHTML = [
'<span style="color:#a8a8a8;font-size:13px">No matches for <strong style="color:#f6f6f6">"' + esc(q) + '"</strong></span>',
'<span style="color:#4a4a4a;font-size:12px">Try a different name, feature, or skill</span>',
].join('');
var browseAll = el('a', {
class: 'tws-sk-err-retry',
href: '/sitemap?q=' + encodeURIComponent(q),
text: 'Browse all pages →',
});
status.appendChild(browseAll);
liveRegion.textContent = 'No results for ' + q + '. A link to browse all pages is available.';
}
function showError(retry) {
results.innerHTML = '';
allRows = [];
selectedIndex = -1;
status.hidden = false;
input.setAttribute('aria-expanded', 'false');
status.innerHTML = '<span style="color:#a8a8a8;font-size:13px">Search unavailable</span>';
var btn = el('button', { class: 'tws-sk-err-retry', text: 'Retry' });
btn.addEventListener('click', retry);
status.appendChild(btn);
liveRegion.textContent = 'Search error. Press retry to try again.';
}
// ── Render results ────────────────────────────────────────────────────────
function renderResults(groups, q, opts) {
var silent = opts && opts.silent;
results.innerHTML = '';
allRows = [];
selectedIndex = -1;
var totalItems = 0;
groups.forEach(function (g) { totalItems += g.items.length; });
if (totalItems === 0) {
showNoResults(q);
return;
}
status.hidden = true;
input.setAttribute('aria-expanded', 'true');
groups.forEach(function (g) {
if (!g.items.length) return;
results.appendChild(categoryHeader(g.label));
g.items.forEach(function (item, idx) {
var row = item.el;
row.id = 'tws-sk-row-' + allRows.length;
row.setAttribute('aria-setsize', String(totalItems));
row.setAttribute('aria-posinset', String(allRows.length + 1));
results.appendChild(row);
allRows.push(row);
});
});
if (!silent) {
liveRegion.textContent = totalItems + ' result' + (totalItems === 1 ? '' : 's') + ' for ' + q;
}
}
// ── Command run panel ─────────────────────────────────────────────────────
// Activating a command swaps the results list for a run panel and does the
// work in place. Esc (or typing) returns to the search results; the palette
// itself stays open so the visitor never loses context.
var runAbort = null; // AbortController for the in-flight command
var runActive = false; // whether the run panel currently owns the results area
var runTicker = null; // elapsed-time ticker (setInterval)
var runTimer = null; // poll timer (setTimeout)
function stopRun() {
if (runAbort) { runAbort.abort(); runAbort = null; }
if (runTicker) { clearInterval(runTicker); runTicker = null; }
if (runTimer) { clearTimeout(runTimer); runTimer = null; }
runActive = false;
}
function exitRunPanel(rerunQuery) {
stopRun();
var q = input.value.trim();
if (rerunQuery && q) { showLoading(); runSearch(q); }
else showInitial();
}
function spinnerEl() {
return el('div', { class: 'tws-sk-spinner', 'aria-hidden': 'true' });
}
// Build the panel chrome and hand the command a small UI toolkit.
function openRunPanel(def, args) {
stopRun();
runActive = true;
runAbort = new AbortController();
results.innerHTML = '';
allRows = [];
selectedIndex = -1;
status.hidden = true;
input.setAttribute('aria-expanded', 'true');
var head = el('div', { class: 'tws-sk-run-head' });
var ico = el('div', { class: 'tws-sk-ico', 'aria-hidden': 'true' });
ico.textContent = def.icon;
var title = el('div', { class: 'tws-sk-run-title', text: def.title(args) });
var statusEl = el('div', { class: 'tws-sk-run-status' });
statusEl.appendChild(spinnerEl());
var statusText = el('span', { text: 'Working…' });
statusEl.appendChild(statusText);
head.appendChild(ico);
head.appendChild(title);
head.appendChild(statusEl);
var body = el('div', { class: 'tws-sk-run-body' });
var foot = el('div', { class: 'tws-sk-run-foot', text: 'Esc — back to search' });
results.appendChild(head);
results.appendChild(body);
results.appendChild(foot);
var ui = {
body: body,
signal: runAbort.signal,
setStatus: function (text, mode) {
statusEl.innerHTML = '';
statusEl.className = 'tws-sk-run-status' + (mode ? ' ' + mode : '');
if (!mode) statusEl.appendChild(spinnerEl());
var t = el('span', { text: text });
statusEl.appendChild(t);
liveRegion.textContent = def.title(args) + ' — ' + text;
},
// Register result rows for arrow-key navigation inside the panel.
addRows: function (rows) {
rows.forEach(function (row) {
row.id = 'tws-sk-row-' + allRows.length;
body.appendChild(row);
allRows.push(row);
});
},
fail: function (message, linkHref, linkText) {
ui.setStatus('failed', 'err');
// Reuse an existing (possibly empty) answer block rather than
// stacking a second one under it.
var msg = body.querySelector('.tws-sk-answer') || el('div', { class: 'tws-sk-answer' });
msg.textContent = message;
body.appendChild(msg);
if (linkHref) {
ui.addRows([resultRow(linkHref, '↗', linkText || 'Open', '', '', '')]);
}
},
};
emitAction(def.id, 'start', { args: args });
try {
def.run(args, ui);
} catch (err) {
ui.fail('Command failed: ' + (err && err.message ? err.message : 'unknown error'));
}
}
function commandRow(match, q) {
var def = match.def;
var row = resultRow('#', def.icon, def.title(match.args), def.desc, 'Run', q, {
run: function () { openRunPanel(def, match.args); },
});
return { el: row };
}
// A zero-query example row: activating it prefills the input (teaching the
// verb) rather than running with a canned argument. Commands with no
// arguments (digest) run directly.
function commandExampleRow(def) {
var run = def.prefill
? function () {
input.value = def.prefill;
input.focus();
onInput();
}
: function () { openRunPanel(def, def.match(def.example)); };
return { el: resultRow('#', def.icon, def.example, def.desc, 'Run', '', { run: run }) };
}
// ── Command implementations ────────────────────────────────────────────────
function runForgeCommand(args, ui) {
var startedAt = Date.now();
var elapsed = function () { return Math.round((Date.now() - startedAt) / 1000) + 's'; };
ui.setStatus('forging · 0s');
runTicker = setInterval(function () {
if (!runActive) return;
ui.setStatus('forging · ' + elapsed() + ' — usually 20–60s');
}, 1000);
function finish(job) {
clearInterval(runTicker); runTicker = null;
ui.setStatus('done · ' + elapsed(), 'ok');
var openHref = job.creation_id
? '/forge/share/' + encodeURIComponent(job.creation_id)
: '/forge/embed?src=' + encodeURIComponent(job.glb_url);
var rows = [
resultRow(openHref, '🧊', 'Open your model', 'Orbit it in 3D, share, or remix', 'GLB', ''),
resultRow(job.glb_url, '⬇️', 'Download the GLB', 'The raw binary — drop it into any engine', '', ''),
resultRow('/forge?prompt=' + encodeURIComponent(args.prompt), '🛠', 'Refine on the Forge', 'Higher tiers, engines, and image input', '', ''),
];
ui.addRows(rows);
emitAction('forge', 'done', { prompt: args.prompt, glb_url: job.glb_url, creation_id: job.creation_id || null });
}
function poll(jobId) {
if (!runActive) return;
fetchJson('/api/forge?job=' + encodeURIComponent(jobId), { signal: ui.signal })
.then(function (job) {
if (!runActive) return;
if (job.status === 'done' && job.glb_url) return finish(job);
if (job.status === 'failed') {
clearInterval(runTicker); runTicker = null;
ui.fail(job.error || 'Generation failed — the free lane may be busy.', '/forge', 'Try on the Forge page');
emitAction('forge', 'failed', { prompt: args.prompt });
return;
}
if (Date.now() - startedAt > 4 * 60 * 1000) {
clearInterval(runTicker); runTicker = null;
ui.fail('Still running after 4 minutes — the lane is saturated. Your job may still finish on the Forge page.', '/forge', 'Open the Forge');
return;
}
runTimer = setTimeout(function () { poll(jobId); }, 2500);
})
.catch(function (err) {
if (err && err.name === 'AbortError') return;
clearInterval(runTicker); runTicker = null;
ui.fail('Lost the job while polling — it may still finish on the Forge page.', '/forge', 'Open the Forge');
});
}
fetch('/api/forge', {
method: 'POST',
headers: { 'content-type': 'application/json', 'x-forge-client': forgeClientId() },
body: JSON.stringify({ prompt: args.prompt }),
signal: ui.signal,
})
.then(function (r) {
if (r.status === 429) throw Object.assign(new Error('rate'), { status: 429 });
if (!r.ok) throw new Error('HTTP ' + r.status);
return r.json();
})
.then(function (job) {
if (!runActive) return;
if (job.status === 'done' && job.glb_url) return finish(job);
if (job.job_id) return poll(job.job_id);
throw new Error(job.error || 'unexpected response');
})
.catch(function (err) {
if (err && err.name === 'AbortError') return;
clearInterval(runTicker); runTicker = null;
if (err && err.status === 429) {
ui.fail('Free-lane rate limit reached for now — try again in a few minutes, or use the Forge page.', '/forge', 'Open the Forge');
} else {
ui.fail('Couldn’t start the generation: ' + err.message, '/forge', 'Try on the Forge page');
}
emitAction('forge', 'failed', { prompt: args.prompt });
});
}
function runDigestCommand(args, ui) {
ui.setStatus('clustering the last 24h…');
fetchJson('/api/news/digest?hours=24&limit=8', { signal: ui.signal })
.then(function (d) {
if (!runActive) return;
var narratives = (d && d.narratives) || [];
if (!narratives.length) {
ui.fail('No digest available right now.', '/markets/digest', 'Open the digest page');
return;
}
ui.setStatus(narratives.length + ' stories · mood ' + (d.mood || 'neutral'), 'ok');
var stanceIcon = { bullish: '🟢', bearish: '🔴', neutral: '⚪' };
var rows = narratives.map(function (n) {
var tickers = (n.tickers || []).slice(0, 4).map(function (t) { return '$' + t; }).join(' ');
var desc = n.coverage + ' outlets' + (tickers ? ' · ' + tickers : '') + (n.summary ? ' — ' + n.summary : '');
var href = (n.articles && n.articles[0] && n.articles[0].link) || '/markets/digest';
return resultRow(href, stanceIcon[n.stance] || '⚪', n.title, desc, n.stance || '', '');
});
rows.push(resultRow('/markets/digest', '📰', 'Read the full digest', 'Every narrative with all covering outlets', '', ''));
ui.addRows(rows);
emitAction('digest', 'done', { stories: narratives.length, mood: d.mood || null });
})
.catch(function (err) {
if (err && err.name === 'AbortError') return;
ui.fail('The digest is unavailable right now.', '/markets/digest', 'Open the digest page');
});
}
function runPriceCommand(args, ui) {
ui.setStatus('looking up ' + args.query + '…');
var q = args.query;
fetchJson('/api/coin/markets?q=' + encodeURIComponent(q), { signal: ui.signal })
.then(function (d) {
var hit = d && d.coins && d.coins[0];
if (!hit) throw new Error('no match');
return fetchJson('/api/coin/detail?id=' + encodeURIComponent(hit.id), { signal: ui.signal });
})
.then(function (d) {
if (!runActive) return;
var c = d && d.coin;
if (!c || !c.market) throw new Error('no market data');
var m = c.market;
var chg = m.change_pct && m.change_pct.h24;
var price = m.price != null ? '$' + Number(m.price).toLocaleString('en-US', { maximumFractionDigits: m.price < 1 ? 6 : 2 }) : '—';
var chgTxt = chg != null ? (chg >= 0 ? '▲ +' : '▼ ') + chg.toFixed(2) + '% 24h' : '';
ui.setStatus(price + (chgTxt ? ' · ' + chgTxt : ''), chg == null ? 'ok' : chg >= 0 ? 'ok' : 'err');
var mcap = m.market_cap != null ? 'Mcap $' + Number(m.market_cap).toLocaleString('en-US', { notation: 'compact', maximumFractionDigits: 1 }) : '';
var rows = [
resultRow('/coin/' + encodeURIComponent(c.id), c.image ? '<img src="' + esc(c.image) + '" alt="" loading="lazy" />' : '🪙',
c.name + ' · ' + String(c.symbol || '').toUpperCase(), price + (chgTxt ? ' · ' + chgTxt : '') + (mcap ? ' · ' + mcap : ''),
c.rank ? '#' + c.rank : '', ''),
resultRow('/compare?ids=' + encodeURIComponent(c.id), '⚖️', 'Compare it', 'Line it up against up to three other coins', '', ''),
];
ui.addRows(rows);
emitAction('price', 'done', { id: c.id, symbol: c.symbol });
})
.catch(function (err) {
if (err && err.name === 'AbortError') return;
// Not a listed major — try pump.fun tokens before giving up.
fetchJson('/api/pump/search?q=' + encodeURIComponent(q) + '&limit=3', { signal: ui.signal })
.then(function (d) {
if (!runActive) return;
var coins = (d && d.data) || [];
if (!coins.length) {
ui.fail('No coin found for “' + q + '”.', '/coins', 'Browse all coins');
return;
}
ui.setStatus('pump.fun match', 'ok');
ui.addRows(coins.map(function (c) {
var priceTxt = c.price_usd != null ? '$' + Number(c.price_usd).toLocaleString('en-US', { maximumFractionDigits: 8 }) : '';
return resultRow('/communities/' + esc(c.mint), coinIcon(c), c.name || c.symbol, (c.symbol ? '$' + c.symbol : '') + (priceTxt ? ' · ' + priceTxt : ''), 'Coin', '');
}));
emitAction('price', 'done', { query: q, source: 'pump' });
})
.catch(function (e2) {
if (e2 && e2.name === 'AbortError') return;
ui.fail('No coin found for “' + q + '”.', '/coins', 'Browse all coins');
});
});
}
function runAskCommand(args, ui, attempt) {
attempt = attempt || 0;
ui.setStatus(attempt ? 'retrying…' : 'thinking…');
var answer = ui.body.querySelector('.tws-sk-answer');
if (!answer) {
answer = el('div', { class: 'tws-sk-answer' });
answer.setAttribute('aria-live', 'polite');
ui.body.appendChild(answer);
}
fetch('/api/chat', {
method: 'POST',
credentials: 'include',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({
message: args.question,
// /api/chat validates context as an object (api/chat.js zod schema).
context: { source: 'command-palette', page: location.pathname },
history: [],
}),
signal: ui.signal,
})
.then(function (r) {
if (r.status === 401) {
ui.fail('Chat needs a signed-in session right now.', '/login', 'Sign in');
return null;
}
// Free-lane saturation: the server says how long to back off
// (api/chat.js responds 503/429 rate_limited + retry_after). Honor
// it, up to two retries, instead of failing a transient condition.
if (r.status === 503 || r.status === 429) {
return r.json().catch(function () { return {}; }).then(function (body) {
if (attempt >= 2) {
ui.fail(body.error_description || 'The free chat lane is at capacity — try again shortly.', '/chat', 'Open chat');
return null;
}
var wait = Math.min(Math.max(Number(body.retry_after) || 5, 2), 30);
var left = wait;
ui.setStatus('at capacity — retrying in ' + left + 's');
runTicker = setInterval(function () {
left -= 1;
if (left > 0) ui.setStatus('at capacity — retrying in ' + left + 's');
}, 1000);
runTimer = setTimeout(function () {
clearInterval(runTicker); runTicker = null;
if (runActive) runAskCommand(args, ui, attempt + 1);
}, wait * 1000);
return null;
});
}
if (!r.ok) throw new Error('HTTP ' + r.status);
var reader = r.body.getReader();
var decoder = new TextDecoder();
var buffer = '';
function pump() {
return reader.read().then(function (chunk) {
if (chunk.done) return;
buffer += decoder.decode(chunk.value, { stream: true });
var frames = buffer.split('\n\n');
buffer = frames.pop();
frames.forEach(function (frame) {
var line = frame.split('\n').find(function (l) { return l.indexOf('data: ') === 0; });
if (!line) return;
var evt;
try { evt = JSON.parse(line.slice(6)); } catch (_) { return; }
if (evt.type === 'chunk' && evt.text) {
answer.textContent += evt.text;
answer.scrollTop = answer.scrollHeight;
} else if (evt.type === 'done') {
if (evt.reply && !answer.textContent) answer.textContent = evt.reply;
ui.setStatus('answered', 'ok');
emitAction('ask', 'done', { question: args.question });
} else if (evt.type === 'error') {
ui.fail(evt.error || 'The agent hit an error.');
}
});
return pump();
});
}
return pump();
})
.catch(function (err) {
if (err && err.name === 'AbortError') return;
ui.fail('The agent is unreachable right now — try again shortly, or open the full chat.', '/chat', 'Open chat');
});
}
// ── Search ─────────────────────────────────────────────────────────────────
function onInput() {
// Typing abandons an open run panel and returns to live search.
if (runActive) stopRun();
var q = input.value.trim();
if (!q) { showInitial(); return; }
showLoading();
if (debounceTimer) clearTimeout(debounceTimer);
debounceTimer = setTimeout(function () { runSearch(q); }, 200);
}
function runSearch(q) {
// Cancel any in-flight agent request
if (currentController) currentController.abort();
currentController = new AbortController();
var signal = currentController.signal;
var agentsPromise = fetchAgents(q, signal).catch(function (err) {
if (err && err.name === 'AbortError') return null; // stale, ignore
return [];
});
var coinsPromise = fetchCoins(q, signal).catch(function (err) {
if (err && err.name === 'AbortError') return null; // stale, ignore
return [];
});
Promise.all([fetchFeatures(), fetchSkills(), agentsPromise, coinsPromise])
.then(function (res) {
if (res[2] === null || res[3] === null) return; // aborted — don't render stale results
var pages = res[0];
var skills = res[1];
var agents = res[2];
var coins = res[3];
// Filter features/docs locally
var docSections = { learn: true, blog: true, legal: true, news: true };
var matchedPages = pages
.filter(function (p) { return !docSections[p.section] && (matches(p.title, q) || matches(p.description, q)); })
.sort(function (a, b) { return score(b, q) - score(a, q); })
.slice(0, 5);
var matchedDocs = pages
.filter(function (p) { return docSections[p.section] && (matches(p.title, q) || matches(p.description, q)); })
.sort(function (a, b) { return score(b, q) - score(a, q); })
.slice(0, 4);
var matchedSkills = skills
.filter(function (s) { return matches(s.name, q) || matches(s.description, q); })
.sort(function (a, b) { return score(b, q) - score(a, q); })
.slice(0, 4);
var matchedActions = QUICK_ACTIONS.filter(function (act) {
return matches(act.title, q) || matches(act.keys, q) || matches(act.desc, q);
}).slice(0, 4);
var actionItems = matchedActions.map(function (act) {
return { el: resultRow(act.href, act.icon, act.title, act.desc, 'Action', q) };
});
var coinItems = (coins || []).slice(0, 6).map(function (c) {
var href = c.mint ? '/communities/' + esc(c.mint) : '#';
return {
el: resultRow(
href,
coinIcon(c),
c.name || c.symbol || 'Coin',
c.symbol ? '$' + c.symbol : '',
'Coin',
q
),
};
});
var agentItems = (agents || []).slice(0, 6).map(function (a) {
// Canonical detail-page permalink per entity kind: avatars to
// /avatars/:id, on-chain agents to /a/:chain/:id, three.ws agents
// to /agents/:id. The API's detailUrl is authoritative; the local
// branches keep results linked if a cached bundle outlives it.
var href = a.detailUrl
|| (a.kind === 'avatar' && a.avatarId ? '/avatars/' + esc(a.avatarId)
: a.kind === 'onchain' && a.chainId != null && a.agentId != null
? '/a/' + esc(a.chainId) + '/' + esc(a.agentId)
: a.agentId ? '/agents/' + esc(a.agentId)
: a.viewerUrl || a.explorerUrl || '/agents');
var badge = a.kind === 'avatar' ? 'Avatar'
: a.kind === 'onchain' ? 'ERC-8004'
: a.kind === 'solana' ? 'Solana' : '';
return {
el: resultRow(
href,
agentIcon(a),
a.name || 'Agent',
a.description || '',
badge,
q
),
};
});
var pageItems = matchedPages.map(function (p) {
return {
el: resultRow(p.path, pageIcon(p.section), p.title, p.description, p.sectionTitle, q),
};
});
var docItems = matchedDocs.map(function (p) {
return {
el: resultRow(p.path, '📖', p.title, p.description, p.sectionTitle, q),
};
});
var skillItems = matchedSkills.map(function (s) {
var href = '/marketplace?tab=skills&id=' + esc(s.id || '');
return {
el: resultRow(href, skillIcon(), s.name, s.description, s.version || '', q),
};
});
var cmdItems = matchedCommands(q).map(function (m) { return commandRow(m, q); });
// Content matches from inside the documentation, as opposed to the
// "Docs" group above, which matches doc PAGE titles. Typing a
// question finds the heading that answers it.
var engine = docsSearchEngine(function () {
// The index finished loading after this query was already
// rendered. Re-run it, but only if the reader has not moved on.
if (input.value.trim() === q) runSearch(q);
});
var docHitItems = (engine ? engine.query(q, 4) : []).map(function (hit) {
return {
el: resultRow(
hit.url,
'🔎',
hit.heading || hit.docTitle,
hit.snippet || '',
hit.docTitle,
q
),
};
});
renderResults([
{ label: 'Do', items: cmdItems },
{ label: 'Actions', items: actionItems },
{ label: 'Agents', items: agentItems },
{ label: 'Coins', items: coinItems },
{ label: 'Skills', items: skillItems },
{ label: 'Features & Pages', items: pageItems },
{ label: 'Docs', items: docItems },
{ label: 'In the documentation', items: docHitItems },
], q);
})
.catch(function () {
showError(function () { runSearch(q); });
});
}
// ── Global shortcut + nav button ───────────────────────────────────────────
document.addEventListener('keydown', function (e) {
// Cmd-K (Mac) or Ctrl-K (Win/Linux) — open/close palette
if ((e.metaKey || e.ctrlKey) && e.key === 'k') {
// Don't intercept when typing in an input unless it's our own
var tag = document.activeElement && document.activeElement.tagName;
if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT') {
if (document.activeElement !== input) return;
}
e.preventDefault();
if (isOpen()) { close(); } else { open(); }
}
});
// Wire any nav search button that nav.html injects
document.addEventListener('click', function (e) {
// e.target may be a non-Element (text node, document); closest() lives on
// Elements only, so resolve the nearest Element before calling it.
var t = e.target;
var el = t && t.nodeType === 1 ? t : (t && t.parentElement) || null;
var btn = el && el.closest('[data-search-open]');
if (btn) { e.preventDefault(); open(); }
});
// ── Expose public API ──────────────────────────────────────────────────────
// parseCommand/runCommand let other surfaces (the corner companion, tests)
// reuse the same verb grammar and drive a command programmatically.
function runCommand(query) {
var match = parseCommand(query);
if (!match) return false;
open();
input.value = String(query || '').trim();
openRunPanel(match.def, match.args);
return true;
}
window.__twsSearch = { open: open, close: close, parseCommand: parseCommand, runCommand: runCommand };
})();