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 x402 — VS Code extension entry. Registers the bazaar tree, the
// inspect/pay/scaffold commands, the wallet status bar, and secret-storage
// wallet management. All payments use @three-ws/x402-fetch; all discovery uses
// the live three.ws bazaar proxy. No mocks.
import * as vscode from 'vscode';
import { BazaarProvider } from './tree.js';
import { inspectEndpoint, summarize } from './inspect.js';
import { showService } from './panel.js';
import { setKey, clearKey, getAddress, setSolanaKey, clearSolanaKey, getSolanaAddress } from './wallet.js';
import { scaffoldEndpoint } from './scaffold.js';
let output;
let statusBar;
export function activate(context) {
output = vscode.window.createOutputChannel('x402');
const provider = new BazaarProvider();
const tree = vscode.window.createTreeView('threewsX402.bazaar', { treeDataProvider: provider });
statusBar = vscode.window.createStatusBarItem(vscode.StatusBarAlignment.Right, 100);
statusBar.command = 'threewsX402.manageWallet';
context.subscriptions.push(output, tree, statusBar);
refreshStatusBar(context);
const reg = (id, fn) =>
context.subscriptions.push(vscode.commands.registerCommand(id, fn));
reg('threewsX402.refresh', () => provider.refresh());
reg('threewsX402.search', async () => {
const q = await vscode.window.showInputBox({
title: 'Search the x402 bazaar',
prompt: 'Keywords (empty to list everything)',
});
if (q === undefined) return;
provider.setQuery(q.trim());
});
reg('threewsX402.setFilters', () => setFilters());
reg('threewsX402.inspect', async (preset) => {
const url =
typeof preset === 'string'
? preset
: await vscode.window.showInputBox({
title: 'Inspect x402 endpoint',
prompt: 'Endpoint URL — decodes its 402 payment challenge',
placeHolder: 'https://three.ws/api/…',
validateInput: (v) => (isUrl(v) ? null : 'Enter a valid http(s) URL'),
});
if (!url) return;
await runInspect(url);
});
reg('threewsX402.openService', (item) => {
if (item) showService(context, item);
});
reg('threewsX402.pay', async (node) => {
// Invoked from the tree inline action (node.command.arguments[0]) or palette.
const item = node?.command?.arguments?.[0] || node;
if (item?.resource) {
showService(context, item);
} else {
const url = await vscode.window.showInputBox({
title: 'Pay & call x402 endpoint',
prompt: 'Endpoint URL',
validateInput: (v) => (isUrl(v) ? null : 'Enter a valid http(s) URL'),
});
if (url) showService(context, syntheticItem(url));
}
});
reg('threewsX402.setWalletKey', async () => {
const address = await setKey(context);
if (address) {
vscode.window.showInformationMessage(`x402 wallet set: ${address}`);
refreshStatusBar(context);
}
});
reg('threewsX402.clearWalletKey', async () => {
await clearKey(context);
vscode.window.showInformationMessage('x402 EVM wallet key cleared.');
refreshStatusBar(context);
});
reg('threewsX402.setSolanaWalletKey', async () => {
const address = await setSolanaKey(context);
if (address) {
vscode.window.showInformationMessage(`x402 Solana wallet set: ${address}`);
refreshStatusBar(context);
}
});
reg('threewsX402.clearSolanaWalletKey', async () => {
await clearSolanaKey(context);
vscode.window.showInformationMessage('x402 Solana wallet key cleared.');
refreshStatusBar(context);
});
reg('threewsX402.manageWallet', async () => {
const [evm, sol] = await Promise.all([getAddress(context), getSolanaAddress(context)]);
const pick = await vscode.window.showQuickPick(
[
{ label: '$(key) Set Solana wallet key', detail: sol ? `Current: ${sol}` : 'Pay USDC or $THREE on Solana', id: 'setSol' },
{ label: '$(key) Set EVM wallet key', detail: evm ? `Current: ${evm}` : 'Pay USDC on Base and other EVM chains', id: 'setEvm' },
...(sol ? [{ label: '$(trash) Clear Solana wallet key', id: 'clrSol' }] : []),
...(evm ? [{ label: '$(trash) Clear EVM wallet key', id: 'clrEvm' }] : []),
],
{ title: 'x402 wallets' },
);
if (!pick) return;
const cmd = {
setSol: 'threewsX402.setSolanaWalletKey',
setEvm: 'threewsX402.setWalletKey',
clrSol: 'threewsX402.clearSolanaWalletKey',
clrEvm: 'threewsX402.clearWalletKey',
}[pick.id];
if (cmd) await vscode.commands.executeCommand(cmd);
});
reg('threewsX402.scaffoldEndpoint', () => scaffoldEndpoint());
provider.refresh();
}
async function refreshStatusBar(context) {
const [evm, sol] = await Promise.all([getAddress(context), getSolanaAddress(context)]);
const short = (a) => `${a.slice(0, 4)}…${a.slice(-4)}`;
const parts = [];
if (sol) parts.push(`◎ ${short(sol)}`);
if (evm) parts.push(`⟠ ${short(evm)}`);
if (parts.length) {
statusBar.text = `$(key) x402 ${parts.join(' ')}`;
statusBar.tooltip =
`x402 wallets — click to manage\n` +
(sol ? `Solana: ${sol}\n` : 'Solana: not set\n') +
(evm ? `EVM: ${evm}` : 'EVM: not set');
} else {
statusBar.text = '$(key) x402: no wallet';
statusBar.tooltip = 'No x402 wallet key set — click to set a Solana or EVM key';
}
statusBar.show();
}
async function runInspect(url) {
output.clear();
output.show(true);
output.appendLine(`Inspecting ${url}`);
const cfg = vscode.workspace.getConfiguration('threewsX402');
const network = cfg.get('network');
const preferToken = cfg.get('preferToken', 'auto');
try {
const result = await inspectEndpoint(url, {
preferNetwork: network || undefined,
preferToken,
wallets: { evm: true, solana: true },
});
summarize(result).forEach((l) => output.appendLine(l));
} catch (e) {
output.appendLine(`Error: ${e?.message || e}`);
}
}
async function setFilters() {
const cfg = vscode.workspace.getConfiguration('threewsX402');
const current = cfg.get('filters', { type: 'http' });
const type = await vscode.window.showQuickPick(
[
{ label: 'http', description: 'Paid HTTP APIs' },
{ label: 'mcp', description: 'Paid MCP tools' },
],
{ title: 'Bazaar type', placeHolder: current.type || 'http' },
);
if (!type) return;
const maxPrice = await vscode.window.showInputBox({
title: 'Max price (USDC atomics, blank = any)',
value: current.maxPrice != null ? String(current.maxPrice) : '',
validateInput: (v) => (!v || /^\d+$/.test(v) ? null : 'digits only'),
});
if (maxPrice === undefined) return;
const tag = await vscode.window.showInputBox({
title: 'Tag filter (blank = any)',
value: current.tag || '',
});
if (tag === undefined) return;
const next = { type: type.label };
if (maxPrice) next.maxPrice = Number(maxPrice);
if (tag.trim()) next.tag = tag.trim();
await cfg.update('filters', next, vscode.ConfigurationTarget.Global);
vscode.commands.executeCommand('threewsX402.refresh');
}
function syntheticItem(url) {
return {
type: 'http',
resource: url,
serviceName: '',
description: 'Manually entered endpoint.',
accepts: [],
tags: [],
networks: [],
minPriceLabel: '',
};
}
function isUrl(v) {
try {
const u = new URL(v);
return u.protocol === 'http:' || u.protocol === 'https:';
} catch {
return false;
}
}
export function deactivate() {}