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
chore(hood-mcp): release 0.1.1 and add a script that turns a package into a documented standalone repo
nirholas370e5da3267f
diff --git a/prompts/store-submissions/_generated/mcp-registry-republish.sh b/prompts/store-submissions/_generated/mcp-registry-republish.shindex b7edb48bc..8249c11a7 100644--- a/prompts/store-submissions/_generated/mcp-registry-republish.sh+++ b/prompts/store-submissions/_generated/mcp-registry-republish.sh@@ -1,8 +1,8 @@#!/usr/bin/env bash# Republish stale/new three.ws MCP servers to the official MCP registry.-# GENERATED 2026-09-30 by build-registry-republish.mjs. Regenerate after any manifest bump.+# GENERATED 2026-10-10 by build-registry-republish.mjs. Regenerate after any manifest bump.# DO NOT run unattended. A human must be logged in and review each publish.-# 1 servers need a republish; 51 are already current.+# 1 servers need a republish; 52 are already current.set -euo pipefailcd "$(git rev-parse --show-toplevel)"@@ -11,7 +11,7 @@ cd "$(git rev-parse --show-toplevel)"# 2. Publish each manifest whose local version is newer than (or absent from) the registry:-# io.github.nirholas/solana-memo-media-mcp: registry (none) -> local 0.1.0 [NEW]+# io.github.nirholas/solana-memo-media-mcp: registry (none) -> local 0.1.1 [NEW]mcp-publisher publish "packages/solana-memo-media-mcp/server.json"# 3. Verify all versions match the manifests:diff --git a/robinhood/hood-mcp/package-lock.json b/robinhood/hood-mcp/package-lock.jsonindex 6c75588b5..4119c42a4 100644--- a/robinhood/hood-mcp/package-lock.json+++ b/robinhood/hood-mcp/package-lock.json@@ -1,13 +1,13 @@{"name": "hood-mcp",- "version": "0.1.0",+ "version": "0.1.1","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "hood-mcp",- "version": "0.1.0",- "license": "SEE LICENSE IN LICENSE",+ "version": "0.1.1",+ "license": "Apache-2.0","dependencies": {"@modelcontextprotocol/sdk": "^1.29.0","hoodchain": "^0.1.0",diff --git a/robinhood/hood-mcp/package.json b/robinhood/hood-mcp/package.jsonindex 28dde2405..e868f6160 100644--- a/robinhood/hood-mcp/package.json+++ b/robinhood/hood-mcp/package.json@@ -1,6 +1,6 @@{"name": "hood-mcp",- "version": "0.1.0",+ "version": "0.1.1","mcpName": "io.github.nirholas/hood-mcp","description": "Model Context Protocol servers for Robinhood Chain (chain ID 4663): a zero-config read-only data server (Stock Token quotes, multiplier-correct portfolios, memecoin launches, chain stats) and an explicitly opt-in trading server (guarded swaps + USDG transfers with hard spend caps and a confirm gate).","keywords": [diff --git a/robinhood/hood-mcp/server.json b/robinhood/hood-mcp/server.jsonindex 842af23ee..8d2e27059 100644--- a/robinhood/hood-mcp/server.json+++ b/robinhood/hood-mcp/server.json@@ -3,7 +3,7 @@"name": "io.github.nirholas/hood-mcp","title": "Robinhood Chain","description": "Robinhood Chain data + guarded trading for AI agents: Stock Token quotes, portfolios, launches",- "version": "0.1.0",+ "version": "0.1.1","websiteUrl": "https://nirholas.github.io/robinhood-chain-mcp/","repository": {"url": "https://github.com/nirholas/robinhood-chain-mcp",@@ -14,7 +14,7 @@"registryType": "npm","registryBaseUrl": "https://registry.npmjs.org","identifier": "hood-mcp",- "version": "0.1.0",+ "version": "0.1.1","runtimeHint": "npx","transport": { "type": "stdio" },"environmentVariables": [diff --git a/scripts/publish-standalone.mjs b/scripts/publish-standalone.mjsnew file mode 100644index 000000000..7adc1ec74--- /dev/null+++ b/scripts/publish-standalone.mjs@@ -0,0 +1,247 @@+#!/usr/bin/env node+// Turn a packages/<name> directory into a standalone, fully documented GitHub repo+// (README badges, AGENTS.md, llms.txt, SECURITY/CONTRIBUTING/CoC, issue templates,+// a GitHub Pages site under docs/, topics) and optionally publish it.+//+// node scripts/publish-standalone.mjs <package-dir> [--repo <name>] [--publish]+//+// Without --publish it builds and tests the repo under ~/projects/standalone/<repo>+// and stops. With --publish it creates nirholas/<repo> via the gh CLI, pushes,+// sets topics and enables Pages. It never publishes to npm.+import fs from 'node:fs';+import path from 'node:path';+import os from 'node:os';+import { execFileSync, spawnSync } from 'node:child_process';+import { fileURLToPath } from 'node:url';+import { marked } from 'marked';++const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');+const OWNER = 'nirholas';+const OUT = path.join(os.homedir(), 'projects', 'standalone');+const BASE_TOPICS = ['three-ws', 'ai-agents', 'llms-txt', 'nodejs'];++const argv = process.argv.slice(2);+const pkgDir = argv.find((a) => !a.startsWith('--'));+const flag = (n) => argv.includes(n);+const val = (n) => (argv.includes(n) ? argv[argv.indexOf(n) + 1] : null);+if (!pkgDir) {+ console.error('usage: publish-standalone.mjs <package-dir> [--repo <name>] [--publish]');+ process.exit(2);+}++const src = path.resolve(ROOT, 'packages', pkgDir);+const pkg = JSON.parse(fs.readFileSync(path.join(src, 'package.json'), 'utf8'));+if (pkg.private) throw new Error(`${pkg.name} is private and is not extracted`);+const repo = val('--repo') || pkgDir;+const dest = path.join(OUT, repo);+const slug = `${OWNER}/${repo}`;+const siteUrl = `https://${OWNER}.github.io/${repo}/`;+const desc = (pkg.description || `${pkg.name}, part of three.ws`).replace(/\s+/g, ' ').trim();+const shortDesc = desc.length > 340 ? desc.slice(0, 337) + '...' : desc;++function run(cmd, args, opts = {}) {+ const r = spawnSync(cmd, args, { stdio: 'inherit', ...opts });+ if (r.status !== 0) throw new Error(`${cmd} ${args.join(' ')} failed (${r.status})`);+}+const write = (rel, body) => {+ fs.mkdirSync(path.dirname(path.join(dest, rel)), { recursive: true });+ fs.writeFileSync(path.join(dest, rel), body.endsWith('\n') ? body : body + '\n');+};+const esc = (s) => s.replace(/&/g, '&').replace(/</g, '<').replace(/"/g, '"');++// 1. copy the package, without installed deps or build output+fs.rmSync(dest, { recursive: true, force: true });+fs.mkdirSync(dest, { recursive: true });+fs.cpSync(src, dest, {+ recursive: true,+ filter: (p) => !/(^|\/)(node_modules|dist|\.turbo)(\/|$)/.test(path.relative(src, p)),+});++// 2. package.json points at the new repo+const next = JSON.parse(fs.readFileSync(path.join(dest, 'package.json'), 'utf8'));+next.repository = { type: 'git', url: `git+https://github.com/${slug}.git` };+next.bugs = { url: `https://github.com/${slug}/issues` };+next.homepage = siteUrl;+fs.writeFileSync(path.join(dest, 'package.json'), JSON.stringify(next, null, 2) + '\n');++// 3. README: badges on top, links to the repo files below+let readme = fs.readFileSync(path.join(dest, 'README.md'), 'utf8');+const badges = [+ `[](https://www.npmjs.com/package/${next.name})`,+ `[.replace(/-/g, '--')}-blue)](LICENSE)`,+ `[](${siteUrl})`,+].join('\n');+readme = readme.replace(/^(# .+\n)/, `$1\n${badges}\n`);+if (!/AGENTS\.md/.test(readme)) {+ readme = readme.trimEnd() + `\n\n## Security and contributing\n\nSee [SECURITY.md](SECURITY.md), [CONTRIBUTING.md](CONTRIBUTING.md) and [AGENTS.md](AGENTS.md) (for AI agents). Part of [three.ws](https://three.ws).\n`;+}+fs.writeFileSync(path.join(dest, 'README.md'), readme);++// 4. docs and discovery files+const testCmd = next.scripts?.test ? 'npm test' : 'node --version';+write('AGENTS.md', `# AGENTS.md++Guidance for AI coding agents working in, or using, this repository.++## What this is++\`${next.name}\`: ${shortDesc}++Part of [three.ws](https://three.ws). Canonical docs: [README.md](README.md). Machine-readable summary: [llms.txt](llms.txt).++## Work on it++\`\`\`bash+npm install+${testCmd}+\`\`\`++Rules:++- Read the README and the neighboring code before changing anything; match the existing style.+- Every behavior change gets a test. Tests use real inputs, no network calls unless the package is a client for one.+- Never commit secrets, private keys or real wallet material.+- Keep the public API in the README accurate: update it in the same change.+- Use plain, specific commit messages (\`fix(scope): what changed and why\`).++## Discovery++- Site: ${siteUrl}+- npm: https://www.npmjs.com/package/${next.name}+- Platform: https://three.ws+`);+const llms = `# ${next.name}++> ${shortDesc}++## Docs+- [README](https://github.com/${slug}/blob/main/README.md): install, usage and API+- [AGENTS.md](https://github.com/${slug}/blob/main/AGENTS.md): how an AI agent should use and modify this repo+- [Site](${siteUrl}): rendered docs+- [npm](https://www.npmjs.com/package/${next.name})++## Optional+- [three.ws](https://three.ws): the platform this package belongs to+- [llms-full.txt](https://three.ws/llms-full.txt): platform-wide index+`;+write('llms.txt', llms);+write('docs/llms.txt', llms);+write('docs/.nojekyll', '');+write('.gitignore', 'node_modules/\ndist/\n*.tgz\n.DS_Store\n');+write('SECURITY.md', `# Security policy++Email [email protected] with a description and reproduction steps. Please do not open a public issue for a vulnerability. We acknowledge reports within 3 business days.+`);+write('CONTRIBUTING.md', `# Contributing++\`\`\`bash+git clone https://github.com/${slug}+cd ${repo}+npm install+${testCmd}+\`\`\`++Keep changes small and tested, keep the README accurate, and never commit secrets. By contributing you agree your work is licensed under ${next.license || 'Apache-2.0'}.+`);+write('CODE_OF_CONDUCT.md', '# Code of conduct\n\nBe respectful and constructive. No harassment, discrimination or personal attacks. Maintainers may remove content or block contributors who break this. Report concerns to [email protected].\n');+write('CHANGELOG.md', `# Changelog\n\n## ${next.version}\n\nInitial standalone release of ${next.name} as its own repository. History before this point lives in [three.ws](https://github.com/${OWNER}/three.ws/tree/main/packages/${pkgDir}).\n`);+write('.github/ISSUE_TEMPLATE/bug_report.md', `---\nname: Bug report\nabout: Something does not work as documented\n---\n\n**Version of ${next.name}**\n\n**What you ran**\n\n**Expected vs actual**\n`);+write('.github/ISSUE_TEMPLATE/feature_request.md', `---\nname: Feature request\nabout: An improvement or new capability\n---\n\n**The problem**\n\n**What you would like**\n`);+write('.github/pull_request_template.md', '## What changed and why\n\n## How I tested it\n- [ ] Tests pass\n- [ ] README updated if the API changed\n');++// 5. docs site rendered from the README+const body = marked.parse(fs.readFileSync(path.join(dest, 'README.md'), 'utf8'));+const ld = {+ '@context': 'https://schema.org',+ '@type': 'SoftwareSourceCode',+ name: next.name,+ description: shortDesc,+ codeRepository: `https://github.com/${slug}`,+ url: siteUrl,+ license: next.license ? `https://spdx.org/licenses/${next.license}` : undefined,+ programmingLanguage: 'JavaScript',+};+write('docs/index.html', `<!doctype html>+<html lang="en">+<head>+<meta charset="utf-8">+<meta name="viewport" content="width=device-width, initial-scale=1">+<title>${esc(next.name)}</title>+<meta name="description" content="${esc(shortDesc)}">+<link rel="canonical" href="${siteUrl}">+<meta property="og:title" content="${esc(next.name)}">+<meta property="og:description" content="${esc(shortDesc)}">+<meta property="og:type" content="website">+<meta property="og:url" content="${siteUrl}">+<meta name="twitter:card" content="summary">+<link rel="alternate" type="text/plain" href="llms.txt" title="llms.txt">+<script type="application/ld+json">${JSON.stringify(ld).replace(/</g, '\\u003c')}</script>+<style>+:root{--bg:#fff;--ink:#14141a;--dim:#4d4d5c;--accent:#5b3cf0;--code:#f3f2f9;--line:#e3e1ee}+@media (prefers-color-scheme:dark){:root{--bg:#0e0e14;--ink:#f1f0f8;--dim:#b4b3c4;--accent:#9d86ff;--code:#1a1a24;--line:#2a2a38}}+*{box-sizing:border-box}+body{margin:0;background:var(--bg);color:var(--ink);font:16px/1.65 system-ui,-apple-system,Segoe UI,sans-serif}+main{max-width:820px;margin:0 auto;padding:40px 16px 80px}+nav{max-width:820px;margin:0 auto;padding:16px;display:flex;gap:16px;flex-wrap:wrap;font-size:.9rem}+h1,h2,h3{line-height:1.2}h2{margin-top:2.2em;border-bottom:1px solid var(--line);padding-bottom:.3em}+p,li{color:var(--dim)}a{color:var(--accent)}a:focus-visible{outline:2px solid var(--accent);outline-offset:2px}+pre{background:var(--code);border:1px solid var(--line);border-radius:10px;padding:14px 16px;overflow-x:auto}+code{font:.9em ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--ink)}+table{border-collapse:collapse;display:block;overflow-x:auto}td,th{border:1px solid var(--line);padding:6px 10px;text-align:left}+img{max-width:100%}+</style>+</head>+<body>+<nav aria-label="Project"><a href="https://github.com/${slug}">GitHub</a><a href="https://www.npmjs.com/package/${next.name}">npm</a><a href="llms.txt">llms.txt</a><a href="https://three.ws">three.ws</a></nav>+<main>+${body}+</main>+</body>+</html>`);++// 6. refuse em-dashes anywhere in what we wrote or copied+const bad = [];+(function scan(d) {+ for (const e of fs.readdirSync(d, { withFileTypes: true })) {+ const p = path.join(d, e.name);+ if (e.isDirectory()) { if (e.name !== '.git' && e.name !== 'node_modules') scan(p); }+ else if (/\.(md|js|mjs|json|html|txt)$/.test(e.name) && /[\u2014\u2013]/.test(fs.readFileSync(p, 'utf8'))) bad.push(path.relative(dest, p));+ }+})(dest);+if (bad.length) {+ for (const f of bad) {+ const p = path.join(dest, f);+ fs.writeFileSync(p, fs.readFileSync(p, 'utf8').replace(/\s*\u2014\s*/g, ', ').replace(/\u2013/g, '-'));+ }+ console.log(`replaced dash glyphs in ${bad.length} file(s)`);+}++// 7. a test script that reaches into the monorepo cannot run standalone+if (/--root\s+\.\./.test(next.scripts?.test || '')) throw new Error(`${next.name}: test script depends on the monorepo root; not extractable as-is`);+// 7b. install and test, so nothing broken is ever published+if (next.scripts?.test) {+ run('npm', ['install', '--no-audit', '--no-fund'], { cwd: dest });+ run('npm', ['test'], { cwd: dest });+}++// 8. git+const git = (...a) => execFileSync('git', ['-c', 'user.name=nirholas', '-c', '[email protected]', ...a], { cwd: dest, encoding: 'utf8' });+git('init', '-q', '-b', 'main');+git('add', '-A');+git('commit', '-q', '-m', `feat: standalone ${next.name} with docs site, agent discovery files and community health files\n\nCo-Authored-By: Claude Sonnet 5.5 <[email protected]>`);+console.log(`built ${dest}`);++if (!flag('--publish')) process.exit(0);++// 9. publish+if (spawnSync('gh', ['repo', 'view', slug], { stdio: 'ignore' }).status === 0) {+ console.log(`${slug} already exists; built locally only`);+ process.exit(0);+}+const topics = [...new Set([...(next.keywords || []), ...BASE_TOPICS]+ .map((k) => String(k).toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, ''))+ .filter((k) => k && k.length <= 50 && /^[a-z0-9]/.test(k)))].slice(0, 20);+run('gh', ['repo', 'create', slug, '--public', '--description', shortDesc.slice(0, 340), '--homepage', siteUrl, '--source', '.', '--remote', 'origin', '--push'], { cwd: dest });+run('gh', ['repo', 'edit', slug, ...topics.flatMap((t) => ['--add-topic', t])]);+run('gh', ['api', '-X', 'POST', `repos/${slug}/pages`, '-f', 'source[branch]=main', '-f', 'source[path]=/docs']);+console.log(`published https://github.com/${slug} site ${siteUrl}`);