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(platform): route table, build config, deps, distribution sync job, page registry and regenerated changelog and llms feeds for the new surfaces
nirholasb8f0f1d41b67
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex af0fbb8c5..09f74c9cc 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,9 +6,12 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr## 2026-09-22+- **Authorize the three-ws CLI** (`/cli/authorize`): Approve a sign-in started by npx three-ws in your terminal. Check the code matches, choose what the new API key may do (money-moving permissions are flagged and can be removed), and the CLI finishes setup on its own.+- **Community Skills** (`/skills/community`): Open-source skills for AI agents: one markdown file of instructions each, contributed by pull request and imported onto any three.ws agent in one click. Search by tag or author, preview the full SKILL.md, then manage your agent's skills and token budget.- **Data Desk** (`/data-desk`): Live market data bought minute by minute by brand-new agent wallets over x402. Every dataset carries its receipt: the wallet that paid, the price, and the Solana settlement transaction.- **Docs · Fresh-wallet workers** (`/docs/x402-fresh-workers`): How the platform mints a brand-new Solana wallet for every x402 purchase, what those wallets buy (3D props for the library, datasets for the data desk), how each wallet is emptied and closed so nothing strands, and where to watch it.- **Agents now buy real work from brand-new wallets, and you can watch it**: The platform's agent economy used to prove the payment rail from a few long-lived wallets buying test calls. It now mints a fresh Solana wallet for every purchase: each one is created, given exactly one job's worth of USDC, pays a three.ws endpoint, and is emptied and closed within the minute. Every purchase does something useful. Some buy a 3D generation that lands in the Agent-Forged Gallery, where a new fresh wallet badge marks it. The rest buy live market data, which now has its own page, the Data Desk, showing each dataset with the wallet that paid, the price, and the Solana receipt. Both feeds are public JSON as well, and a new stats endpoint lists every wallet with its three transactions. (`/data-desk`) `[feature]`+- **The agent economy now pays from thousands of distinct wallets, and only from ones that hold funds**: The x402 ring, the closed loop where three.ws agents pay each other for services, has a pool of 2,000 payer wallets to rotate through instead of a single seed wallet, so on-chain activity reflects many participants rather than one cron. Rotation now checks each wallet's recorded SOL and USDC before handing it a payment and falls back to the seed payer when nothing in the pool can cover the call, so a freshly minted or thinly funded pool never produces failed payments. The funder that keeps the pool topped up only submits transfers its own wallets can pay for, and the ring status endpoint reports how many pool wallets are minted and how many are ready to pay. `[infra, improvement]`## 2026-09-21diff --git a/STRUCTURE.md b/STRUCTURE.mdindex a1fc911a5..0d273a137 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -27,6 +27,7 @@ bottom.| React avatar creator | [avatar-sdk/](avatar-sdk) `→ /react` `/creator` | Published as `@three-ws/avatar` | Same package, React subpath || Avatar CLI (manifests in the build pipeline) | [packages/avatar-cli/](packages/avatar-cli), landing [pages/avatar-cli.html](pages/avatar-cli.html) `→ /avatar-cli`, styles [public/avatar-cli.css](public/avatar-cli.css), page runtime [src/avatar-cli-page.js](src/avatar-cli-page.js) | Published as `@three-ws/avatar-cli` | The terminal half of the avatar story, and the half that makes an avatar auditable. Four commands over one file: `init` scaffolds a schema-valid manifest from a wallet plus a mesh (reading the GLB once to compute its SHA-256 and size, so the document cannot disagree with the bytes it was built from), `validate` checks it against [packages/avatar-schema/](packages/avatar-schema) and exits non-zero so it works as a build gate, `hash` prints a bare digest that composes in a shell, and `preview` emits a resolver URL, an `<agent-3d>` snippet paired with the loader that registers it, and a zero-install iframe. Offline and deterministic throughout: no account, no API key, no network call, which is what makes it safe in a release script. `preview` warns instead of printing a dead snippet when `mesh.uri` is still a local `file://` path. The landing page proves the emitted markup by rendering it live rather than screenshotting it. Docs: [docs/avatar-cli.md](docs/avatar-cli.md) `→ /docs/avatar-cli`, tutorial [docs/tutorials/ship-an-avatar-manifest.md](docs/tutorials/ship-an-avatar-manifest.md). Tests: [packages/avatar-cli/test/](packages/avatar-cli/test) || Asset catalog (one search over every ready-made asset) | join + ranking [api/_lib/asset-catalog.js](api/_lib/asset-catalog.js), code generation [api/_lib/asset-snippets.js](api/_lib/asset-snippets.js), REST [api/catalog.js](api/catalog.js) `→ /api/catalog`, MCP tools [api/_mcp/tools/library.js](api/_mcp/tools/library.js), CLI [packages/assets-cli/](packages/assets-cli) | Published as `@three-ws/assets` | The CC0 prop library, the ready-made character library and the motion-clip library joined into one ranked catalog (3,492 items) that also hands back paste-ready source: the `<model-viewer>` tag the browse grids render with, `<agent-3d>` pinned to the exact published version plus its SRI hash, plain three.js, or React. Reachable three ways off one implementation: `GET /api/catalog`, the free MCP tools `search_catalog` / `get_catalog_item` / `get_item_source` (on the dispatcher's public allowlist, so no OAuth and no x402), and `npx @three-ws/assets add <id>`, which downloads the asset into the caller's project and rewrites the snippet to the local path. Every word of a query must match, with a labelled partial-match fallback so a phrase never dead-ends. Docs: [docs/mcp.md](docs/mcp.md) `→ /docs/mcp`, [docs/api-reference.md](docs/api-reference.md). Tests: [tests/api/mcp-asset-catalog.test.js](tests/api/mcp-asset-catalog.test.js), [tests/api/catalog-endpoint.test.js](tests/api/catalog-endpoint.test.js), [packages/assets-cli/test/](packages/assets-cli/test) |+| MCP resources and guided prompts | registry and readers [api/_mcp/resources.js](api/_mcp/resources.js), prompts [api/_mcp/prompts.js](api/_mcp/prompts.js), `read_resource` tools [api/_mcp/tools/resources.js](api/_mcp/tools/resources.js) and [api/_mcp3d/tools/resources.js](api/_mcp3d/tools/resources.js), `create_agent` in [api/_mcp/tools/agents.js](api/_mcp/tools/agents.js) over the shared creation path [api/_lib/agent-create.js](api/_lib/agent-create.js), subscriptions table [api/_lib/migrations/20260922120000_mcp_resource_subscriptions.sql](api/_lib/migrations/20260922120000_mcp_resource_subscriptions.sql), manifest generator [scripts/build-mcp-surfaces.mjs](scripts/build-mcp-surfaces.mjs) | Live on `/api/mcp`, `/api/mcp-agent`, `/api/mcp-3d`, `/api/mcp-bazaar` | Live read-only `three://` views of the caller's account (agents, each agent's Solana wallet with balances, limits and freeze state, usage, chat, runs, orders, DCA, intents, wallets, launches) plus the public marketplace, model catalog, x402 catalog and 3D assets, each as JSON or markdown and each also reachable through the `read_resource` tool. `resources/subscribe` stores a fingerprint per client and the authenticated GET event stream emits `notifications/resources/updated` when it moves; a wallet moves when its latest signature changes. Seventeen guided prompts render against each server's live tools/list, so a server only offers flows whose tools it publishes, and venue flows switch to their executing tools once those ship. `npm run audit:mcp-surfaces` keeps `server*.json` and `/.well-known/mcp.json` in step with the code. Docs: [docs/mcp.md](docs/mcp.md) `→ /docs/mcp`. Tests: [tests/mcp-resources.test.js](tests/mcp-resources.test.js), [tests/mcp-prompts.test.js](tests/mcp-prompts.test.js) || Terminal avatar (any avatar or agent body, live in a terminal) | [packages/tty-avatar/](packages/tty-avatar) | Published as `@three-ws/tty-avatar` | `npx @three-ws/tty-avatar <avatar id>` draws the avatar in colour at 24 fps in any terminal: a software rasterizer ([packages/tty-avatar/src/raster.js](packages/tty-avatar/src/raster.js), z-buffered scanline fill, key + fill + rim lighting) over a subpixel grid that three encoders turn into truecolor half-blocks, braille, or plain ASCII ([packages/tty-avatar/src/encode.js](packages/tty-avatar/src/encode.js)). Sources: a `.glb` path, a URL, an avatar id (`/api/avatars/:id`), `agent:<id>` (the agent's bound body via `/api/agents/:id`), or a three.ws page URL. Moods are procedural whole-body motion ([packages/tty-avatar/src/moods.js](packages/tty-avatar/src/moods.js)), so a rigless prop animates too, and they cross-fade. The point of it: `install-hooks --write` merges nine Claude Code hooks whose command is a bare `cat > ~/.three-ws/tty-avatar/event.json` (zero startup cost per tool call), the viewer polls that file and maps each payload to a mood and a caption ([packages/tty-avatar/src/state.js](packages/tty-avatar/src/state.js)), so the avatar thinks, works, errors, asks and celebrates in step with the agent. Every avatar and agent page's Embed tab prints the command ([src/avatar-page.js](src/avatar-page.js)). Docs: [docs/tty-avatar.md](docs/tty-avatar.md) `→ /docs/tty-avatar`. Tests: [packages/tty-avatar/test/](packages/tty-avatar/test) (builds a real GLB in memory and exercises loader, rasterizer, encoders, moods, state bridge, hook installer and CLI) || Model Diff (what changed between two GLBs) | [pages/diff.html](pages/diff.html) `→ /diff` + page runtime [src/model-diff.js](src/model-diff.js), 3D stage [src/model-diff-stage.js](src/model-diff-stage.js), styles [public/model-diff.css](public/model-diff.css), engine [packages/glb-diff/](packages/glb-diff), free API [api/3d/diff.js](api/3d/diff.js) `→ /api/3d/diff` (catalog entry [api/_lib/3d-catalog/diff.js](api/_lib/3d-catalog/diff.js)), MCP tool `diff_models` in [api/_mcp/tools/models.js](api/_mcp/tools/models.js) | Live | The check that catches the most expensive silent failure in an asset pipeline: a checksum flags every re-export, and cannot tell a lossless recompression from a rig that quietly lost three finger joints. Objects are paired in three passes the way git pairs renamed files (name, then content hash, then similarity), so an exporter that renumbers `Mesh.001` reads as a rename rather than a rewrite, and a node that kept its name but changed parent reads as a move. Vertex data is hashed at a 1e-4 quantum with normals, UVs and **skin weights** included, so a Draco round trip registers as nothing and a re-skin registers as a change. Every difference carries a severity (`none` to `breaking`), where breaking means something a consumer addresses by name is gone: a clip, a joint, a mesh. One engine, four surfaces, so a CI verdict can never disagree with the page: the browser page (drop two files, nothing uploaded; overlay / wipe / side-by-side in 3D, clicking a row frames that node), the free keyless API (`?a=&b=`, `format=markdown` for a pull-request comment), the `glb-diff` CLI (`--fail-on breaking`, exit 2 reserved for "could not run"), and the MCP tool. Docs: [docs/model-diff.md](docs/model-diff.md) `→ /docs/model-diff`. Tests: [packages/glb-diff/tests/glb-diff.test.js](packages/glb-diff/tests/glb-diff.test.js), [tests/model-diff-api.test.js](tests/model-diff-api.test.js) || Rig Doctor (will this GLB animate?) | [pages/rig-doctor.html](pages/rig-doctor.html) `→ /rig-doctor`, analysis [src/rig-report.js](src/rig-report.js), page runtime [src/rig-doctor-page.js](src/rig-doctor-page.js), styles [public/rig-doctor.css](public/rig-doctor.css) | Live | The answer to the most expensive silent failure on the platform: a rig loads, renders, and never moves, because clips address bones by name and this skeleton calls them something else. Drop a `.glb` and the page reads its glTF JSON chunk in the browser, names the authoring convention (twelve fingerprints, from Mixamo and Ready Player Me to Unreal, VRM, MMD, Biped, Rigify, and HumanIK), and scores four limb groups independently against the 52-joint canonical set, because "62% covered" is not actionable and "your legs will not move" is. The verdict mirrors the runtime gate in [src/animation-manager.js](src/animation-manager.js) exactly (a skinned mesh plus 8 mapped joints), so it predicts rather than approximates. It then does two things a report cannot: mounts the real [src/avatar-pose.js](src/avatar-pose.js) stage on a blob URL of the file so the user watches their own rig perform the actual clip library, and runs [src/glb-canonicalize.js](src/glb-canonicalize.js) in-browser to hand back a repaired GLB with canonical joint names. Nothing is uploaded: the only network calls are for the clip library and the sample rigs. Also emits a schema-v1 manifest, an `<agent-3d>` snippet, and the matching [packages/avatar-cli/](packages/avatar-cli) commands. Docs: [docs/rig-doctor.md](docs/rig-doctor.md) `→ /docs/rig-doctor`. Tests: [tests/rig-report.test.js](tests/rig-report.test.js) |diff --git a/data/changelog.json b/data/changelog.jsonindex 901840d84..7ffbdc8be 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,16 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-09-22",+ "title": "Claude and other AI clients can now read your three.ws account and follow guided flows",+ "summary": "Every hosted three.ws MCP server now publishes live, read-only views of your account as resources: your agents, each agent's Solana wallet with balances, limits and freeze state, usage and costs, chat history, runs, open orders, DCA plans and intents, plus the marketplace, the model catalog with prices, your token launches and the x402 service catalog. Clients like Claude Desktop show them in the attachment picker, and a client can subscribe to an agent's wallet to be told the moment a transfer lands. Each server also offers guided prompts, such as get-started, create-agent, setup-wallet, trade, hire-agent and review-costs, that walk you through a flow tool by tool and always show the recipient, amount, token and chain before anything that moves money. A new create_agent tool lets a model create an agent for you, and read_resource gives the same data to clients without a resource reader.",+ "tags": [+ "feature",+ "sdk"+ ],+ "link": "/docs/mcp"+ },{"date": "2026-09-22","title": "Agents now buy real work from brand-new wallets, and you can watch it",diff --git a/data/pages.json b/data/pages.jsonindex 98a47dcf2..58176c96d 100644--- a/data/pages.json+++ b/data/pages.json@@ -340,6 +340,14 @@"indexable": false,"added": "2026-05-27"},+ {+ "path": "/skills/community",+ "title": "Community Skills",+ "description": "Open-source skills for AI agents: one markdown file of instructions each, contributed by pull request and imported onto any three.ws agent in one click. Search by tag or author, preview the full SKILL.md, then manage your agent's skills and token budget.",+ "priority": 0.8,+ "changefreq": "weekly",+ "added": "2026-09-22"+ },{"path": "/community","title": "Community",diff --git a/distributions/hermes/install.ps1 b/distributions/hermes/install.ps1new file mode 100644index 000000000..3aad5a5ad--- /dev/null+++ b/distributions/hermes/install.ps1@@ -0,0 +1,76 @@+# three-ws-agent installer for Windows: Hermes Agent with three.ws built in.+#+# irm https://three.ws/install/hermes.ps1 | iex+#+# three-ws-agent is a downstream distribution of Hermes Agent (Nous Research,+# MIT). Upstream code is unchanged; the distribution adds the three.ws plugin.+# This script clones the distribution, runs Hermes' own unmodified installer+# against it (so `hermes update` keeps tracking the distribution), and finishes+# with `hermes three-ws setup`.+#+# Set $env:THREE_WS_AGENT_CONVERT = "1" to switch an existing stock Hermes+# checkout to three-ws-agent. Set $env:THREE_WS_SKIP_SETUP = "1" to skip the+# final setup step.++$ErrorActionPreference = "Stop"++$Repo = if ($env:THREE_WS_AGENT_REPO) { $env:THREE_WS_AGENT_REPO } else { "https://github.com/nirholas/three-ws-agent.git" }+$Branch = if ($env:THREE_WS_AGENT_BRANCH) { $env:THREE_WS_AGENT_BRANCH } else { "main" }+$HermesHome = if ($env:HERMES_HOME) { $env:HERMES_HOME } else { "$env:LOCALAPPDATA\hermes" }+$InstallDir = if ($env:HERMES_INSTALL_DIR) { $env:HERMES_INSTALL_DIR } else { "$HermesHome\hermes-agent" }++function Normalize([string]$Url) {+ return ($Url -replace '^[email protected]:', 'https://github.com/' -replace '\.git$', '' -replace '/$', '')+}++if (-not (Get-Command git -ErrorAction SilentlyContinue)) {+ throw "git is required. Install it with: winget install --id Git.Git -e, then open a new terminal and rerun."+}++if (Test-Path "$InstallDir\.git") {+ $origin = (git -C $InstallDir remote get-url origin 2>$null)+ if ((Normalize $origin) -ne (Normalize $Repo)) {+ if ($env:THREE_WS_AGENT_CONVERT -ne "1") {+ Write-Host "An existing Hermes install lives at $InstallDir (origin: $origin)."+ Write-Host ""+ Write-Host "Keep it and add three.ws as a plugin:"+ Write-Host " hermes plugins install nirholas/three-ws-agent/plugins/three-ws; hermes plugins enable three-ws; hermes three-ws setup"+ Write-Host ""+ Write-Host "Or switch that install to three-ws-agent (config, memories and sessions are kept):"+ Write-Host ' $env:THREE_WS_AGENT_CONVERT = "1"; irm https://three.ws/install/hermes.ps1 | iex'+ exit 1+ }+ Write-Host "==> Switching $InstallDir to three-ws-agent"+ git -C $InstallDir remote set-url origin $Repo+ }+} else {+ Write-Host "==> Cloning three-ws-agent into $InstallDir"+ New-Item -ItemType Directory -Force -Path (Split-Path $InstallDir) | Out-Null+ git clone --depth 1 --single-branch --branch $Branch $Repo $InstallDir+ if ($LASTEXITCODE -ne 0) { throw "git clone of $Repo failed." }+}++Write-Host "==> Running the Hermes Agent installer from the distribution"+& "$InstallDir\scripts\install.ps1" -InstallDir $InstallDir -HermesHome $HermesHome -Branch $Branch++$HermesBin = "$InstallDir\venv\Scripts\hermes.exe"+if (-not (Test-Path $HermesBin)) {+ $found = Get-Command hermes -ErrorAction SilentlyContinue+ if (-not $found) { throw "Hermes installed but hermes.exe was not found. Open a new terminal and run: hermes plugins enable three-ws; hermes three-ws setup" }+ $HermesBin = $found.Source+}++$env:HERMES_HOME = $HermesHome+Write-Host "==> Enabling the three.ws plugin"+& $HermesBin plugins enable three-ws++if ($env:THREE_WS_SKIP_SETUP -ne "1") {+ Write-Host "==> Connecting three.ws"+ & $HermesBin three-ws setup+}++Write-Host ""+Write-Host "three-ws-agent is installed. Open a new terminal, then:"+Write-Host " hermes start a chat"+Write-Host " hermes three-ws status check the three.ws connection"+Write-Host " hermes update pull the latest three-ws-agent (tracks Hermes upstream)"diff --git a/distributions/hermes/install.sh b/distributions/hermes/install.shnew file mode 100644index 000000000..6d605c0bf--- /dev/null+++ b/distributions/hermes/install.sh@@ -0,0 +1,100 @@+#!/usr/bin/env bash+# three-ws-agent installer: Hermes Agent with three.ws built in.+#+# curl -fsSL https://three.ws/install/hermes.sh | bash+#+# three-ws-agent is a downstream distribution of Hermes Agent (Nous Research,+# MIT). Upstream code is unchanged; the distribution adds the three.ws plugin.+# This script clones the distribution, hands it to Hermes' own unmodified+# installer (which then updates from the distribution, so `hermes update`+# keeps tracking it), and finishes with `hermes three-ws setup`.+#+# Options (after `bash -s --`):+# --convert Switch an existing stock Hermes checkout to three-ws-agent.+# --no-three-ws-setup Install only; run `hermes three-ws setup` later.+# Anything else is passed through to Hermes' installer (see its --help).+#+# Environment:+# HERMES_HOME Data directory (default ~/.hermes)+# HERMES_INSTALL_DIR Code directory (default $HERMES_HOME/hermes-agent)+# THREE_WS_AGENT_REPO Git URL of the distribution+# THREE_WS_AGENT_BRANCH Branch to install (default main)++set -euo pipefail++REPO="${THREE_WS_AGENT_REPO:-https://github.com/nirholas/three-ws-agent.git}"+BRANCH="${THREE_WS_AGENT_BRANCH:-main}"+HERMES_HOME="${HERMES_HOME:-$HOME/.hermes}"+INSTALL_DIR="${HERMES_INSTALL_DIR:-$HERMES_HOME/hermes-agent}"+CONVERT=false+RUN_SETUP=true+PASSTHROUGH=()++while [ $# -gt 0 ]; do+ case "$1" in+ --convert) CONVERT=true ;;+ --no-three-ws-setup) RUN_SETUP=false ;;+ --dir) INSTALL_DIR="$2"; shift ;;+ --branch) BRANCH="$2"; shift ;;+ *) PASSTHROUGH+=("$1") ;;+ esac+ shift+done++info() { printf '\033[1;37m==>\033[0m %s\n' "$*"; }+die() { printf '\033[1;31merror:\033[0m %s\n' "$*" >&2; exit 1; }++command -v git >/dev/null 2>&1 || die "git is required. Install it with your package manager (for example: sudo apt install git, or xcode-select --install), then rerun."++normalize() { printf '%s' "$1" | sed -e 's#^[email protected]:#https://github.com/#' -e 's#\.git$##' -e 's#/$##'; }++if [ -d "$INSTALL_DIR/.git" ]; then+ origin="$(git -C "$INSTALL_DIR" remote get-url origin 2>/dev/null || true)"+ if [ "$(normalize "$origin")" != "$(normalize "$REPO")" ]; then+ if [ "$CONVERT" != true ]; then+ cat >&2 <<EOF+An existing Hermes install lives at $INSTALL_DIR (origin: ${origin:-none}).++Keep it and add three.ws as a plugin:+ hermes plugins install nirholas/three-ws-agent/plugins/three-ws && hermes plugins enable three-ws && hermes three-ws setup++Or switch that install to three-ws-agent (your config, memories and sessions are kept):+ curl -fsSL https://three.ws/install/hermes.sh | bash -s -- --convert+EOF+ exit 1+ fi+ info "Switching $INSTALL_DIR to three-ws-agent"+ git -C "$INSTALL_DIR" remote set-url origin "$REPO"+ fi+else+ info "Cloning three-ws-agent into $INSTALL_DIR"+ mkdir -p "$(dirname "$INSTALL_DIR")"+ git clone --depth 1 --single-branch --branch "$BRANCH" "$REPO" "$INSTALL_DIR"+fi++info "Running the Hermes Agent installer from the distribution"+HERMES_HOME="$HERMES_HOME" bash "$INSTALL_DIR/scripts/install.sh" --dir "$INSTALL_DIR" --branch "$BRANCH" ${PASSTHROUGH[@]+"${PASSTHROUGH[@]}"}++HERMES_BIN="$INSTALL_DIR/venv/bin/hermes"+[ -x "$HERMES_BIN" ] || HERMES_BIN="$(command -v hermes || true)"+[ -n "$HERMES_BIN" ] || die "Hermes installed but its binary was not found. Open a new terminal and run: hermes plugins enable three-ws && hermes three-ws setup"++info "Enabling the three.ws plugin"+HERMES_HOME="$HERMES_HOME" "$HERMES_BIN" plugins enable three-ws++if [ "$RUN_SETUP" = true ]; then+ info "Connecting three.ws"+ if (: </dev/tty) 2>/dev/null; then+ HERMES_HOME="$HERMES_HOME" "$HERMES_BIN" three-ws setup </dev/tty+ else+ HERMES_HOME="$HERMES_HOME" "$HERMES_BIN" three-ws setup --no-login+ fi+fi++cat <<EOF++three-ws-agent is installed. Open a new terminal (so PATH picks up hermes), then:+ hermes start a chat+ hermes three-ws status check the three.ws connection+ hermes update pull the latest three-ws-agent (tracks Hermes upstream)+EOFdiff --git a/distributions/hermes/overlay/plugins/three-ws/__init__.py b/distributions/hermes/overlay/plugins/three-ws/__init__.pynew file mode 100644index 000000000..de16266e1--- /dev/null+++ b/distributions/hermes/overlay/plugins/three-ws/__init__.py@@ -0,0 +1,39 @@+"""three.ws for Hermes Agent.++Registers `hermes three-ws setup | login | status | uninstall`, an in-session+`/three-ws` status command, and the bundled three.ws skills.++Everything the plugin changes goes through Hermes' own public commands+(`hermes config set`, `hermes mcp login`, `hermes mcp test`), so it keeps+working as Hermes evolves and always targets the active profile.+"""++from __future__ import annotations++from pathlib import Path++from . import setup_flow+++def register(ctx):+ ctx.register_cli_command(+ name="three-ws",+ help="Connect Hermes to three.ws: MCP servers, skills, sign-in and skin",+ description=(+ "Wire the three.ws MCP servers and skills into the active Hermes profile, "+ "sign in with OAuth or an API key, and check the connection."+ ),+ setup_fn=setup_flow.build_parser,+ handler_fn=setup_flow.dispatch,+ )+ ctx.register_command(+ "three-ws",+ handler=setup_flow.slash_status,+ description="Show the three.ws connection for this profile",+ )+ skills_dir = Path(__file__).parent / "skills"+ if skills_dir.is_dir():+ for child in sorted(skills_dir.iterdir()):+ skill_md = child / "SKILL.md"+ if child.is_dir() and skill_md.is_file():+ ctx.register_skill(child.name, skill_md)diff --git a/distributions/hermes/overlay/plugins/three-ws/setup_flow.py b/distributions/hermes/overlay/plugins/three-ws/setup_flow.pynew file mode 100644index 000000000..08c016090--- /dev/null+++ b/distributions/hermes/overlay/plugins/three-ws/setup_flow.py@@ -0,0 +1,337 @@+"""The `hermes three-ws` subcommands.++Every endpoint, server name and skill list comes from `three_ws.json`, which+three.ws generates from data/agent-frameworks.json. Nothing here hardcodes a+URL, so moving the platform to a new endpoint is a regenerate, not a code edit.+"""++from __future__ import annotations++import argparse+import json+import os+import shutil+import subprocess+import sys+from pathlib import Path+from typing import Iterable++PLUGIN_DIR = Path(__file__).resolve().parent+CONFIG = json.loads((PLUGIN_DIR / "three_ws.json").read_text(encoding="utf-8"))++SERVER = CONFIG["server"]+FREE = CONFIG["free"]+KEY_ENV = CONFIG["apiKeyEnv"]+SKIN = CONFIG["skin"]+SKILL_CATEGORY = CONFIG["skillCategory"]+++# --- environment ---------------------------------------------------------------------------+++def hermes_home() -> Path:+ """The active profile's home. `hermes -p <name>` exports HERMES_HOME before plugins run."""+ try:+ from hermes_constants import get_hermes_home++ return Path(get_hermes_home())+ except ImportError:+ return Path(os.environ.get("HERMES_HOME") or Path.home() / ".hermes")+++def hermes_argv() -> list[str]:+ """Run Hermes with the interpreter that is running us, so venvs and profiles line up."""+ return [sys.executable, "-m", "hermes_cli.main"]+++def run_hermes(args: Iterable[str], *, capture: bool = False, timeout: int | None = None) -> subprocess.CompletedProcess:+ return subprocess.run(+ [*hermes_argv(), *args],+ text=True,+ capture_output=capture,+ timeout=timeout,+ check=False,+ )+++def interactive() -> bool:+ return sys.stdin.isatty() and sys.stdout.isatty()+++# --- output --------------------------------------------------------------------------------+++def say(line: str = "") -> None:+ print(line, flush=True)+++def ok(line: str) -> None:+ say(f" ✓ {line}")+++def warn(line: str) -> None:+ say(f" ! {line}")+++def fail(line: str) -> None:+ say(f" ✗ {line}")+++def mask(secret: str) -> str:+ return f"...{secret[-4:]}" if len(secret) > 4 else "****"+++# --- config writes -------------------------------------------------------------------------+++def config_set(key: str, value: str) -> None:+ result = run_hermes(["config", "set", key, value], capture=True)+ if result.returncode != 0:+ raise SetupError(f"hermes config set {key} failed: {(result.stderr or result.stdout).strip()}")+++def config_unset(key: str) -> None:+ run_hermes(["config", "unset", key], capture=True)+++def config_get(key: str) -> str:+ result = run_hermes(["config", "get", key], capture=True)+ return result.stdout.strip() if result.returncode == 0 else ""+++class SetupError(RuntimeError):+ pass+++def write_servers(mode: str) -> None:+ """Point both three.ws servers at the configured URLs. `mode` is `oauth` or `key`."""+ name = SERVER["name"]+ config_set(f"mcp_servers.{name}.url", SERVER["url"])+ if mode == "key":+ config_unset(f"mcp_servers.{name}.auth")+ config_set(f"mcp_servers.{name}.headers.Authorization", f"Bearer ${{{KEY_ENV}}}")+ else:+ config_unset(f"mcp_servers.{name}.headers")+ config_set(f"mcp_servers.{name}.auth", "oauth")+ config_set(f"mcp_servers.{FREE['name']}.url", FREE["url"])+ ok(f"MCP servers: {name} ({'API key' if mode == 'key' else 'OAuth'}) and {FREE['name']} (free, no sign-in)")+++def env_path() -> Path:+ return hermes_home() / ".env"+++def save_api_key(key: str) -> None:+ """Store the key in the profile .env (0600). Hermes resolves ${VAR} in headers at connect time."""+ path = env_path()+ path.parent.mkdir(parents=True, exist_ok=True)+ lines = path.read_text(encoding="utf-8").splitlines() if path.exists() else []+ lines = [line for line in lines if not line.startswith(f"{KEY_ENV}=")]+ lines.append(f"{KEY_ENV}={key}")+ path.write_text("\n".join(lines) + "\n", encoding="utf-8")+ try:+ path.chmod(0o600)+ except OSError:+ pass+ ok(f"Saved {KEY_ENV} ({mask(key)}) to {path}")+++def install_skin(apply_default: bool) -> None:+ source = PLUGIN_DIR / "skins" / f"{SKIN}.yaml"+ target_dir = hermes_home() / "skins"+ target_dir.mkdir(parents=True, exist_ok=True)+ shutil.copyfile(source, target_dir / source.name)+ if apply_default:+ config_set("display.skin", SKIN)+ ok(f"Skin: {SKIN} (now the default; `/skin default` switches back)")+ else:+ ok(f"Skin: {SKIN} installed (`/skin {SKIN}` to use it)")+++def install_skills() -> int:+ """Copy the bundled skills into the profile so they appear in the agent's skill index."""+ source_root = PLUGIN_DIR / "skills"+ target_root = hermes_home() / "skills" / SKILL_CATEGORY+ target_root.mkdir(parents=True, exist_ok=True)+ count = 0+ for child in sorted(source_root.iterdir()):+ if not (child / "SKILL.md").is_file():+ continue+ target = target_root / child.name+ if target.exists():+ shutil.rmtree(target)+ shutil.copytree(child, target)+ count += 1+ ok(f"Skills: {count} three.ws skills in {target_root}")+ return count+++def remove_skills() -> None:+ target_root = hermes_home() / "skills" / SKILL_CATEGORY+ if target_root.exists():+ shutil.rmtree(target_root)+ ok(f"Removed {target_root}")+++# --- connection checks ---------------------------------------------------------------------+++def test_server(name: str) -> tuple[bool, str]:+ try:+ result = run_hermes(["mcp", "test", name], capture=True, timeout=120)+ except subprocess.TimeoutExpired:+ return False, "timed out after 120s"+ output = (result.stdout or "") + (result.stderr or "")+ for line in output.splitlines():+ if "Tools discovered" in line:+ return True, line.strip().lstrip("✓ ").strip()+ reason = next((line.strip() for line in output.splitlines() if "✗" in line), "")+ return False, reason.lstrip("✗ ").strip() or "no tools discovered"+++def report_connections() -> bool:+ all_ok = True+ for server in (FREE, SERVER):+ passed, detail = test_server(server["name"])+ (ok if passed else fail)(f"{server['name']}: {detail}")+ all_ok = all_ok and passed+ return all_ok+++def oauth_login() -> bool:+ name = SERVER["name"]+ if not interactive():+ warn(f"Not a terminal, so sign-in was skipped. Run: hermes three-ws login")+ return False+ say(f"\n Signing in to three.ws. A browser window opens; approve access and come back here.\n")+ result = run_hermes(["mcp", "login", name])+ if result.returncode != 0:+ fail(f"Sign-in did not finish. Retry with: hermes three-ws login (or --api-key from {CONFIG['apiKeyPage']})")+ return False+ return True+++# --- subcommands ---------------------------------------------------------------------------+++def cmd_setup(args: argparse.Namespace) -> int:+ say(f"\n three.ws setup for Hermes ({CONFIG['homepage']})")+ say(f" Profile home: {hermes_home()}\n")+ key = args.api_key or ("" if not args.use_env_key else os.environ.get(KEY_ENV, ""))+ try:+ mode = "key" if key else "oauth"+ if key:+ save_api_key(key)+ write_servers(mode)+ if not args.no_skills:+ install_skills()+ if not args.no_skin:+ install_skin(apply_default=not args.keep_skin)+ except SetupError as error:+ fail(str(error))+ return 1+ if mode == "oauth" and not args.no_login:+ oauth_login()+ say("\n Checking the connection:")+ healthy = report_connections()+ say()+ if healthy:+ say(f" Done. Start a chat with `hermes` and try:\n {CONFIG['firstPrompt']}\n")+ return 0+ say(f" The free server works without an account. For the rest, run `hermes three-ws login`.")+ say(f" Docs: {CONFIG['docs']}\n")+ return 0 if mode == "oauth" and args.no_login else 1+++def cmd_login(args: argparse.Namespace) -> int:+ try:+ if args.api_key:+ save_api_key(args.api_key)+ write_servers("key")+ else:+ write_servers("oauth")+ if not oauth_login():+ return 1+ except SetupError as error:+ fail(str(error))+ return 1+ passed, detail = test_server(SERVER["name"])+ (ok if passed else fail)(f"{SERVER['name']}: {detail}")+ return 0 if passed else 1+++def cmd_status(_args: argparse.Namespace) -> int:+ say(f"\n three.ws in {hermes_home()}")+ url = config_get(f"mcp_servers.{SERVER['name']}.url")+ auth = config_get(f"mcp_servers.{SERVER['name']}.auth")+ header = config_get(f"mcp_servers.{SERVER['name']}.headers.Authorization")+ if not url:+ fail(f"Not set up. Run: hermes three-ws setup")+ return 1+ say(f" {SERVER['name']}: {url} auth: {'API key (' + KEY_ENV + ')' if header else auth or 'none'}")+ free_url = config_get(f"mcp_servers.{FREE['name']}.url")+ say(f" {FREE['name']}: {free_url or 'not configured'}")+ say(f" skin: {config_get('display.skin') or 'default'}")+ skills_root = hermes_home() / "skills" / SKILL_CATEGORY+ count = sum(1 for p in skills_root.glob("*/SKILL.md")) if skills_root.exists() else 0+ say(f" skills: {count} in {skills_root}\n")+ healthy = report_connections()+ say()+ return 0 if healthy else 1+++def cmd_uninstall(args: argparse.Namespace) -> int:+ for name in (SERVER["name"], FREE["name"]):+ config_unset(f"mcp_servers.{name}")+ ok("Removed the three.ws MCP servers from this profile")+ remove_skills()+ if config_get("display.skin") == SKIN:+ config_set("display.skin", "default")+ ok("Skin reset to default")+ return 0+++def build_parser(parser: argparse.ArgumentParser) -> None:+ subs = parser.add_subparsers(dest="three_ws_command", metavar="{setup,login,status,uninstall}")++ setup = subs.add_parser("setup", help="Wire three.ws into this profile and sign in")+ setup.add_argument("--api-key", help=f"Use an API key instead of OAuth (create one at {CONFIG['apiKeyPage']})")+ setup.add_argument("--use-env-key", action="store_true", help=f"Use ${KEY_ENV} from the environment as the API key")+ setup.add_argument("--no-login", action="store_true", help="Configure only; sign in later with `hermes three-ws login`")+ setup.add_argument("--no-skills", action="store_true", help="Do not copy the three.ws skills into the profile")+ setup.add_argument("--no-skin", action="store_true", help="Do not install the three.ws skin")+ setup.add_argument("--keep-skin", action="store_true", help="Install the skin but keep the current default")++ login = subs.add_parser("login", help="Sign in again (OAuth), or switch to an API key")+ login.add_argument("--api-key", help="Switch this profile to API-key auth with this key")++ subs.add_parser("status", help="Show what is configured and test both servers")+ subs.add_parser("uninstall", help="Remove the three.ws servers, skills and skin from this profile")+ parser.set_defaults(func=dispatch)+++HANDLERS = {"setup": cmd_setup, "login": cmd_login, "status": cmd_status, "uninstall": cmd_uninstall}+++def dispatch(args: argparse.Namespace) -> int:+ handler = HANDLERS.get(getattr(args, "three_ws_command", None) or "")+ if handler is None:+ say("Usage: hermes three-ws {setup,login,status,uninstall} (hermes three-ws setup to begin)")+ return 2+ code = handler(args)+ if code:+ sys.exit(code)+ return code+++def slash_status(_raw_args: str) -> str:+ url = config_get(f"mcp_servers.{SERVER['name']}.url")+ if not url:+ return "three.ws is not set up in this profile. Exit and run: hermes three-ws setup"+ lines = [f"three.ws: {url}"]+ for server in (FREE, SERVER):+ passed, detail = test_server(server["name"])+ lines.append(f"{'ok' if passed else 'failed'} {server['name']}: {detail}")+ if not all(line.startswith("ok") for line in lines[1:]):+ lines.append("Sign in again from a terminal: hermes three-ws login")+ return "\n".join(lines)diff --git a/distributions/sync/cloudbuild.json b/distributions/sync/cloudbuild.jsonnew file mode 100644index 000000000..b09b282b5--- /dev/null+++ b/distributions/sync/cloudbuild.json@@ -0,0 +1,34 @@+{+ "steps": [+ {+ "id": "sync",+ "name": "python:3.12-bookworm",+ "entrypoint": "bash",+ "secretEnv": ["GITHUB_TOKEN"],+ "env": ["PUSH=${_PUSH}", "THREE_WS_REF=${_THREE_WS_REF}"],+ "args": [+ "-c",+ "set -euo pipefail\ngit clone -q --depth 1 --filter=blob:none --sparse --branch \"$$THREE_WS_REF\" https://github.com/nirholas/three.ws.git /workspace/three.ws\ngit -C /workspace/three.ws sparse-checkout set distributions\ncd /workspace/three.ws\nbash distributions/sync/run.sh\n"+ ]+ }+ ],+ "substitutions": {+ "_PUSH": "1",+ "_THREE_WS_REF": "main"+ },+ "availableSecrets": {+ "secretManager": [+ {+ "versionName": "projects/aerial-vehicle-466722-p5/secrets/three-ws-distributions-github-token/versions/latest",+ "env": "GITHUB_TOKEN"+ }+ ]+ },+ "timeout": "2400s",+ "options": {+ "machineType": "E2_HIGHCPU_8",+ "logging": "CLOUD_LOGGING_ONLY"+ },+ "serviceAccount": "projects/aerial-vehicle-466722-p5/serviceAccounts/[email protected]",+ "tags": ["three-ws-distributions-sync"]+}diff --git a/distributions/sync/publish-extension.sh b/distributions/sync/publish-extension.shnew file mode 100644index 000000000..8be201bda--- /dev/null+++ b/distributions/sync/publish-extension.sh@@ -0,0 +1,70 @@+#!/usr/bin/env bash+# Publish a generated directory to its own GitHub repository, root-level.+#+# Used for the Gemini CLI extension: Gemini installs extensions from a repo+# whose root holds gemini-extension.json, and its gallery crawls tagged repos.+# The directory in three.ws is the source of truth; this mirrors it, commits+# only when something changed, and tags v<version> from the manifest.+#+# Usage: distributions/sync/publish-extension.sh <source-dir> <repo-url> <manifest-file>+# PUSH=1 pushes (needs GITHUB_TOKEN); anything else is a dry run.++set -euo pipefail+export GIT_TERMINAL_PROMPT=0++SRC="$(cd "$1" && pwd)"+REPO_URL="$2"+MANIFEST="$3"+PUSH="${PUSH:-0}"+WORK_DIR="${WORK_DIR:-$(mktemp -d)}"+NAME="$(basename "$REPO_URL" .git)"++log() { printf '[publish:%s] %s\n' "$NAME" "$*"; }+die() { printf '[publish:%s] error: %s\n' "$NAME" "$*" >&2; exit 1; }++[ -f "$SRC/$MANIFEST" ] || die "$SRC/$MANIFEST not found"+VERSION="$(python3 -c 'import json,sys; print(json.load(open(sys.argv[1]))["version"])' "$SRC/$MANIFEST")"+THREE_WS_SHA="$(git -C "$SRC" rev-parse --short HEAD 2>/dev/null || echo unknown)"++REPO="$WORK_DIR/$NAME"+rm -rf "$REPO"+if git ls-remote --exit-code --heads "$REPO_URL" main >/dev/null 2>&1; then+ git clone -q --depth 1 --no-single-branch "$REPO_URL" "$REPO"+ git -C "$REPO" fetch -q --tags+else+ log "repository has no main branch yet: starting it"+ git init -q -b main "$REPO"+ git -C "$REPO" remote add origin "$REPO_URL"+fi+cd "$REPO"+git config user.name "three.ws distribution bot"+git config user.email "[email protected]"++find . -mindepth 1 -maxdepth 1 ! -name .git -exec rm -rf {} ++cp -a "$SRC/." .+git add -A+if git diff --cached --quiet; then+ log "no changes"+else+ git commit -q -m "Release $VERSION from three.ws@$THREE_WS_SHA"+ log "committed $VERSION"+fi++tag="v$VERSION"+if git rev-parse -q --verify "refs/tags/$tag" >/dev/null; then+ [ "$(git rev-list -n1 "$tag")" = "$(git rev-parse HEAD)" ] \+ || die "content changed but $tag already exists: bump the version in data/agent-frameworks.json"+else+ git tag -a "$tag" -m "$NAME $VERSION"+ log "tagged $tag"+fi++if [ "$PUSH" = "1" ]; then+ [ -n "${GITHUB_TOKEN:-}" ] || die "PUSH=1 needs GITHUB_TOKEN"+ push_url="$(printf '%s' "$REPO_URL" | sed "s#https://#https://x-access-token:${GITHUB_TOKEN}@#")"+ git push -q "$push_url" main:main+ git push -q "$push_url" "$tag"+ log "pushed main and $tag"+else+ log "dry run: not pushing. Result in $REPO"+fidiff --git a/distributions/sync/run.sh b/distributions/sync/run.shnew file mode 100644index 000000000..76efe657e--- /dev/null+++ b/distributions/sync/run.sh@@ -0,0 +1,20 @@+#!/usr/bin/env bash+# One scheduled pass over every externally hosted three.ws distribution:+# 1. nirholas/three-ws-agent merged with Hermes Agent upstream, overlay refreshed, verified+# 2. nirholas/three-ws-gemini mirrored from distributions/gemini-cli and tagged+#+# Cloud Build runs this daily (distributions/sync/cloudbuild.json, scheduled by+# scripts/create-distribution-sync-job.mjs). Locally it is a dry run unless PUSH=1.++set -euo pipefail+export GIT_TERMINAL_PROMPT=0++HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"+export THREE_WS_DIR="${THREE_WS_DIR:-$(cd "$HERE/../.." && pwd)}"+WORK_ROOT="${WORK_ROOT:-$(mktemp -d)}"++WORK_DIR="$WORK_ROOT/hermes" bash "$HERE/sync-hermes.sh"+WORK_DIR="$WORK_ROOT/gemini" bash "$HERE/publish-extension.sh" \+ "$THREE_WS_DIR/distributions/gemini-cli" \+ "${GEMINI_REPO_URL:-https://github.com/nirholas/three-ws-gemini.git}" \+ gemini-extension.jsondiff --git a/distributions/sync/sync-hermes.sh b/distributions/sync/sync-hermes.shnew file mode 100644index 000000000..d6f004aed--- /dev/null+++ b/distributions/sync/sync-hermes.sh@@ -0,0 +1,130 @@+#!/usr/bin/env bash+# Keep nirholas/three-ws-agent in sync with Hermes Agent upstream.+#+# The distribution's main branch is upstream main plus the three.ws overlay+# (distributions/hermes/overlay/). Each run merges the latest upstream into it,+# refreshes the overlay, proves upstream files are byte-identical, installs the+# result, exercises the plugin, and only then pushes. Every run is a merge on+# top of the previous distribution commit, so `hermes update` (git pull+# --ff-only) always fast-forwards for people who installed it.+#+# Usage: distributions/sync/sync-hermes.sh+#+# Environment:+# THREE_WS_DIR three.ws checkout holding the overlay (default: this repo)+# FORK_URL distribution repo (default https://github.com/nirholas/three-ws-agent.git)+# UPSTREAM_URL upstream repo (default https://github.com/NousResearch/hermes-agent.git)+# UPSTREAM_BRANCH upstream branch (default main)+# WORK_DIR scratch directory (default: a fresh temp dir)+# VERIFY_INSTALL 1 (default) installs Hermes from the merged tree and tests the plugin+# PUSH 1 pushes the result; anything else is a dry run+# GITHUB_TOKEN token with contents:write on the fork, needed when PUSH=1++set -euo pipefail+export GIT_TERMINAL_PROMPT=0++HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"+THREE_WS_DIR="${THREE_WS_DIR:-$(cd "$HERE/../.." && pwd)}"+OVERLAY="$THREE_WS_DIR/distributions/hermes/overlay"+FORK_URL="${FORK_URL:-https://github.com/nirholas/three-ws-agent.git}"+UPSTREAM_URL="${UPSTREAM_URL:-https://github.com/NousResearch/hermes-agent.git}"+UPSTREAM_BRANCH="${UPSTREAM_BRANCH:-main}"+WORK_DIR="${WORK_DIR:-$(mktemp -d)}"+VERIFY_INSTALL="${VERIFY_INSTALL:-1}"+PUSH="${PUSH:-0}"+# Paths the overlay owns. Everything else in the distribution must equal upstream.+OWNED=(plugins/three-ws .github/README.md THREE-WS-NOTICE.md)++log() { printf '[sync-hermes] %s\n' "$*"; }+die() { printf '[sync-hermes] error: %s\n' "$*" >&2; exit 1; }++[ -d "$OVERLAY/plugins/three-ws" ] || die "overlay not found at $OVERLAY (run npm run build:distributions)"+THREE_WS_SHA="$(git -C "$THREE_WS_DIR" rev-parse --short HEAD 2>/dev/null || echo unknown)"++REPO="$WORK_DIR/three-ws-agent"+rm -rf "$REPO"+git init -q -b main "$REPO"+cd "$REPO"+git config user.name "three.ws distribution bot"+git config user.email "[email protected]"+git remote add upstream "$UPSTREAM_URL"+git remote add origin "$FORK_URL"++log "fetching upstream $UPSTREAM_URL ($UPSTREAM_BRANCH)"+git fetch -q --filter=blob:none upstream "$UPSTREAM_BRANCH"+UPSTREAM_SHA="$(git rev-parse --short "upstream/$UPSTREAM_BRANCH")"++if git ls-remote --exit-code --heads origin main >/dev/null 2>&1; then+ log "fetching distribution $FORK_URL"+ git fetch -q --filter=blob:none origin main+ git checkout -q -B main origin/main+ if git merge-base --is-ancestor "upstream/$UPSTREAM_BRANCH" HEAD; then+ log "upstream $UPSTREAM_SHA already merged"+ else+ log "merging upstream $UPSTREAM_SHA"+ git merge -q --no-edit -m "Merge Hermes Agent upstream $UPSTREAM_SHA" "upstream/$UPSTREAM_BRANCH" \+ || die "merge conflict with upstream $UPSTREAM_SHA; the overlay must only own ${OWNED[*]}"+ fi+else+ log "distribution has no main branch yet: starting from upstream $UPSTREAM_SHA"+ git checkout -q -B main "upstream/$UPSTREAM_BRANCH"+fi++log "applying the three.ws overlay from three.ws@$THREE_WS_SHA"+for path in "${OWNED[@]}"; do+ rm -rf "$path"+ if [ -e "$OVERLAY/$path" ]; then+ mkdir -p "$(dirname "$path")"+ cp -a "$OVERLAY/$path" "$path"+ fi+done+find plugins/three-ws -name '__pycache__' -type d -prune -exec rm -rf {} ++git add -A -- "${OWNED[@]}"+if git diff --cached --quiet; then+ log "overlay unchanged"+else+ git commit -q -m "three.ws overlay from three.ws@$THREE_WS_SHA"+ log "committed overlay"+fi++log "verifying upstream files are unchanged"+excludes=()+for path in "${OWNED[@]}"; do excludes+=(":(exclude)$path"); done+if ! git diff --quiet "upstream/$UPSTREAM_BRANCH" HEAD -- . "${excludes[@]}"; then+ git diff --stat "upstream/$UPSTREAM_BRANCH" HEAD -- . "${excludes[@]}" >&2+ die "files outside the overlay differ from upstream"+fi++log "compiling the plugin"+python3 -m py_compile plugins/three-ws/*.py++if [ "$VERIFY_INSTALL" = "1" ]; then+ command -v uv >/dev/null 2>&1 || python3 -m pip install -q uv+ UV="$(command -v uv || echo "$HOME/.local/bin/uv")"+ log "installing Hermes from the merged tree"+ "$UV" venv -q --python 3.12 "$WORK_DIR/venv"+ VIRTUAL_ENV="$WORK_DIR/venv" "$UV" pip install -q -e ".[mcp]"+ HERMES="$WORK_DIR/venv/bin/hermes"+ export HERMES_HOME="$WORK_DIR/hermes-home"+ mkdir -p "$HERMES_HOME"+ log "plugin doctor"+ "$HERMES" plugins doctor plugins/three-ws --ci+ log "enabling the plugin and running setup against production"+ "$HERMES" plugins enable three-ws+ "$HERMES" three-ws setup --no-login </dev/null | tee "$WORK_DIR/setup.log"+ grep -q "three-ws-studio: Tools discovered" "$WORK_DIR/setup.log" \+ || die "setup did not reach the free three.ws server"+ [ -f "$HERMES_HOME/skins/three-ws.yaml" ] || die "skin was not installed"+ ls "$HERMES_HOME"/skills/three-ws/*/SKILL.md >/dev/null || die "skills were not installed"+ log "install verified"+fi++if [ "$PUSH" = "1" ]; then+ [ -n "${GITHUB_TOKEN:-}" ] || die "PUSH=1 needs GITHUB_TOKEN"+ push_url="$(printf '%s' "$FORK_URL" | sed "s#https://#https://x-access-token:${GITHUB_TOKEN}@#")"+ log "pushing main to $FORK_URL"+ git push -q "$push_url" main:main+ log "pushed $(git rev-parse --short HEAD) (upstream $UPSTREAM_SHA, three.ws@$THREE_WS_SHA)"+else+ log "dry run: not pushing. Result is $(git rev-parse --short HEAD) in $REPO"+fidiff --git a/package-lock.json b/package-lock.jsonindex 1ba3af864..68dcece1f 100644--- a/package-lock.json+++ b/package-lock.json@@ -110,7 +110,9 @@"@grpc/proto-loader": "^0.8.1","@jaames/iro": "^5.5.2","@jup-ag/api": "^6.0.48",+ "@kamino-finance/farms-sdk": "^3.2.26","@kamino-finance/klend-sdk": "^12.0.0",+ "@kamino-finance/scope-sdk": "^10.2.6","@leeoniya/ufuzzy": "^1.0.19","@mediapipe/tasks-vision": "^0.10.35","@metaplex-foundation/genesis": "^0.43.0",@@ -190,6 +192,8 @@"fflate": "^0.8.3","gltf-validator": "^2.0.0-dev.3.10","helius-sdk": "^3.2.0",+ "hyparquet": "^1.31.1",+ "hyparquet-compressors": "^1.1.2","idb-keyval": "^6.3.0","imapflow": "^2.0.2","jose": "^6.2.12",@@ -39420,6 +39424,28 @@"ms": "^2.0.0"}},+ "node_modules/hyparquet": {+ "version": "1.31.1",+ "resolved": "https://registry.npmjs.org/hyparquet/-/hyparquet-1.31.1.tgz",+ "integrity": "sha512-tF9580Xb+41+Eb+mH0av1k7m1PWl+PSKrX66Yd7UOZ760cwEXP9/enwHRMSCeVncaubRI8XPb3v580/ujYKK5w==",+ "license": "MIT"+ },+ "node_modules/hyparquet-compressors": {+ "version": "1.1.2",+ "resolved": "https://registry.npmjs.org/hyparquet-compressors/-/hyparquet-compressors-1.1.2.tgz",+ "integrity": "sha512-0Hx6w0ZpVpNCefKy5xBYLTp6rKeZn/tsUzuliNzfKqSCdLcTQSfwATEoeedS703Y17k1qNS61HwRME5aOeNkPg==",+ "license": "MIT",+ "dependencies": {+ "fzstd": "0.1.1",+ "hysnappy": "1.1.1"+ }+ },+ "node_modules/hysnappy": {+ "version": "1.1.1",+ "resolved": "https://registry.npmjs.org/hysnappy/-/hysnappy-1.1.1.tgz",+ "integrity": "sha512-/V9XcN2NtRyWjR4LYMfvnvasVVF8jbT/ej0eofBQjZel91E3D813FQ3mQC6gDSMMTCq/FJh28XHeyqr3I/oBRw==",+ "license": "MIT"+ },"node_modules/i18n-iso-countries": {"version": "7.14.0","resolved": "https://registry.npmjs.org/i18n-iso-countries/-/i18n-iso-countries-7.14.0.tgz",diff --git a/package.json b/package.jsonindex 7fe601be1..832d4837c 100644--- a/package.json+++ b/package.json@@ -247,13 +247,15 @@"audit:route-shadowing": "node scripts/audit-route-shadowing.mjs","audit:handlers": "node scripts/audit-empty-handlers.mjs","audit:x402-catalog": "node scripts/audit-x402-catalog.mjs",- "gate": "npm run check:conflicts && npm run check:claude && npm run check:vendored && npm run check:model-viewer && npm run check:gcloudignore && npm run check:fetch-timeouts && npm run check:tdz-bootstrap && npm run check:event && npm run check:cron-syntax && npm run check:home-matrix && npm run check:studio-openapi && npm run test:gate && npm run test:gate-3d && npm run audit:mcp && npm run audit:mcp-golden && npm run audit:mcp-safety && npm run audit:mcp-catalog && npm run audit:mcp-listing && npm run audit:routes && npm run audit:handlers && npm run audit:pages && npm run audit:links && npm run check:awesome && npm run check:prompt-library && npm run audit:docs && npm run check:docs-freshness && npm run audit:upstreams && npm run check:tutorials && npm run audit:hidden-guard && npm run audit:inline-handlers && npm run audit:x402-catalog && npm run audit:tokens && npm run audit:states && npm run audit:motion-tokens && npm run audit:guards && npm run audit:tour-atlas && npm run check:ios-icons && npm run check:macos-icon && npm run check:apple-widget && npm run check:windows-widget && npm run check:announce && npm run i18n:home && npm run check:skills-seed && npm run check:openai-skills && npm run check:skills-pack && npm run check:skill-repos && npm run check:openai-fields && npm run audit:motion && npm run audit:tour-global && npm run check:doc-media && npm run check:images && npm run audit:route-shadowing",+ "gate": "npm run check:conflicts && npm run check:claude && npm run check:vendored && npm run check:model-viewer && npm run check:gcloudignore && npm run check:fetch-timeouts && npm run check:tdz-bootstrap && npm run check:event && npm run check:cron-syntax && npm run check:home-matrix && npm run check:studio-openapi && npm run test:gate && npm run test:gate-3d && npm run audit:mcp && npm run audit:mcp-golden && npm run audit:mcp-safety && npm run audit:mcp-catalog && npm run audit:mcp-listing && npm run audit:mcp-surfaces && npm run audit:routes && npm run audit:handlers && npm run audit:pages && npm run audit:links && npm run check:awesome && npm run check:prompt-library && npm run audit:docs && npm run check:docs-freshness && npm run audit:upstreams && npm run check:tutorials && npm run audit:hidden-guard && npm run audit:inline-handlers && npm run audit:x402-catalog && npm run audit:tokens && npm run audit:states && npm run audit:motion-tokens && npm run audit:guards && npm run audit:tour-atlas && npm run check:ios-icons && npm run check:macos-icon && npm run check:apple-widget && npm run check:windows-widget && npm run check:announce && npm run i18n:home && npm run check:skills-seed && npm run check:openai-skills && npm run check:skills-pack && npm run check:skill-repos && npm run check:openai-fields && npm run audit:motion && npm run audit:tour-global && npm run check:doc-media && npm run check:images && npm run audit:route-shadowing","test:gate-3d": "vitest run tests/glb-canonicalize.test.js tests/animation-retarget.test.js tests/animation-retarget-rest-pollution.test.js tests/viewer-framing.test.js","audit:mcp-golden": "node scripts/audit-mcp-golden.mjs","audit:mcp-safety": "node scripts/audit-mcp-safety.mjs","audit:mcp-catalog": "node scripts/build-mcp-catalog.mjs --check","audit:mcp-reviewer": "node scripts/audit-mcp-reviewer-path.mjs","audit:mcp-listing": "node scripts/build-mcp-listing-source.mjs --check",+ "audit:mcp-surfaces": "node scripts/build-mcp-surfaces.mjs --check",+ "build:mcp-surfaces": "node scripts/build-mcp-surfaces.mjs","build:mcp-catalog": "node scripts/build-mcp-catalog.mjs","audit:inline-handlers": "node scripts/audit-inline-handlers.mjs","audit:csp": "node scripts/audit-csp.mjs",@@ -544,7 +546,9 @@"@grpc/proto-loader": "^0.8.1","@jaames/iro": "^5.5.2","@jup-ag/api": "^6.0.48",+ "@kamino-finance/farms-sdk": "^3.2.26","@kamino-finance/klend-sdk": "^12.0.0",+ "@kamino-finance/scope-sdk": "^10.2.6","@leeoniya/ufuzzy": "^1.0.19","@mediapipe/tasks-vision": "^0.10.35","@metaplex-foundation/genesis": "^0.43.0",@@ -624,6 +628,8 @@"fflate": "^0.8.3","gltf-validator": "^2.0.0-dev.3.10","helius-sdk": "^3.2.0",+ "hyparquet": "^1.31.1",+ "hyparquet-compressors": "^1.1.2","idb-keyval": "^6.3.0","imapflow": "^2.0.2","jose": "^6.2.12",diff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex 132f415f8..89c3bcd5a 100644--- a/public/changelog-recent.json+++ b/public/changelog-recent.json@@ -1,14 +1,34 @@{- "generated_at": "2026-09-22T04:19:11.095Z",+ "generated_at": "2026-09-22T06:14:49.374Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},- "total": 3747,+ "total": 3750,"complete": false,"full_feed": "/changelog.json","entries": [+ {+ "date": "2026-09-22",+ "type": "launch",+ "title": "Authorize the three-ws CLI",+ "summary": "Approve a sign-in started by npx three-ws in your terminal. Check the code matches, choose what the new API key may do (money-moving permissions are flagged and can be removed), and the CLI finishes setup on its own.",+ "link": "/cli/authorize",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-09-22",+ "type": "launch",+ "title": "Community Skills",+ "summary": "Open-source skills for AI agents: one markdown file of instructions each, contributed by pull request and imported onto any three.ws agent in one click. Search by tag or author, preview the full SKILL.md, then manage your agent's skills and token budget.",+ "link": "/skills/community",+ "tags": [+ "launch"+ ]+ },{"date": "2026-09-22","type": "launch",@@ -39,6 +59,17 @@"feature"]},+ {+ "date": "2026-09-22",+ "type": "update",+ "title": "The agent economy now pays from thousands of distinct wallets, and only from ones that hold funds",+ "summary": "The x402 ring, the closed loop where three.ws agents pay each other for services, has a pool of 2,000 payer wallets to rotate through instead of a single seed wallet, so on-chain activity reflects many participants rather than one cron. Rotation now checks each wallet's recorded SOL and USDC before handing it a payment and falls back to the seed payer when nothing in the pool can cover the call, so a freshly minted or thinly funded pool never produces failed payments. The funder that keeps the pool topped up only submits transfers its own wallets can pay for, and the ring status endpoint reports how many pool wallets are minted and how many are ready to pay.",+ "link": null,+ "tags": [+ "infra",+ "improvement"+ ]+ },{"date": "2026-09-21","type": "update",@@ -1579,38 +1610,6 @@"fix","improvement"]- },- {- "date": "2026-09-09",- "type": "update",- "title": "The partnership page works properly on the partner's own site",- "summary": "The IBM partnership page is published once onto IBM's own domain and then keeps itself current by reading from three.ws, so everything it loads is a cross-origin read and anything we get wrong there is invisible on three.ws itself. Three things were wrong. The site-wide command palette asked the partner's server for our page index and for the ranking module it imports, so it never opened and logged an error on every visit: the index now travels with the code the way the language catalogs already do, and both files are readable from other sites. And a build step that adds the site's mobile stylesheet to every page was reaching the partner artifacts too, even though they are copied out untouched by design, so the hosted copy asked IBM's server for a stylesheet only we have. All three are closed, and the audit that loads the page from a foreign domain now passes all four of its checks: the live update applies, the language switcher mounts, the paid demo arms, and the console is clean.",- "link": null,- "tags": [- "fix"- ]- },- {- "date": "2026-09-09",- "type": "update",- "title": "The payments dashboard now says whose wallet ran out of SOL",- "summary": "When a Solana payment cannot go through because the wallet paying the network fee is too low, the chain reports it as a generic simulation failure. Our status page grouped all of those together, so the platform's own fee wallet running low looked exactly like a buyer signing from an empty wallet, and both were also counted as payment-network faults. They are now three separate, named outcomes, so the status page says whether the money problem is ours to fix, the buyer's, or neither. Today's reject book was 1,438 rows of the first kind reading as the third.",- "link": null,- "tags": [- "fix",- "infra"- ]- },- {- "date": "2026-09-09",- "type": "update",- "title": "The payments status page now says which of two opposite outages it is looking at",- "summary": "When agent payments stop settling, the status page names the cause. Two very different situations shared one description: either the platform stops offering Solana payment on its price quotes, so nothing is ever attempted, or it keeps offering them and then turns each signed payment away at the final check. Both are fixed by topping up the same wallet, but the evidence sits in opposite places, and the old wording sent whoever was on call to the wrong one. It could even report that Solana had been withdrawn from quotes while the counter printed beside it read zero withdrawals. The status page now names the mechanism and points at the record that actually holds the proof, and the operations runbook carries a table for telling the two apart.",- "link": null,- "tags": [- "fix",- "infra"- ]}]}diff --git a/public/changelog.json b/public/changelog.jsonindex e264809ea..8b5d1b397 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,11 +1,31 @@{- "generated_at": "2026-09-22T04:19:11.069Z",+ "generated_at": "2026-09-22T06:14:49.340Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},"entries": [+ {+ "date": "2026-09-22",+ "type": "launch",+ "title": "Authorize the three-ws CLI",+ "summary": "Approve a sign-in started by npx three-ws in your terminal. Check the code matches, choose what the new API key may do (money-moving permissions are flagged and can be removed), and the CLI finishes setup on its own.",+ "link": "/cli/authorize",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-09-22",+ "type": "launch",+ "title": "Community Skills",+ "summary": "Open-source skills for AI agents: one markdown file of instructions each, contributed by pull request and imported onto any three.ws agent in one click. Search by tag or author, preview the full SKILL.md, then manage your agent's skills and token budget.",+ "link": "/skills/community",+ "tags": [+ "launch"+ ]+ },{"date": "2026-09-22","type": "launch",@@ -36,6 +56,17 @@"feature"]},+ {+ "date": "2026-09-22",+ "type": "update",+ "title": "The agent economy now pays from thousands of distinct wallets, and only from ones that hold funds",+ "summary": "The x402 ring, the closed loop where three.ws agents pay each other for services, has a pool of 2,000 payer wallets to rotate through instead of a single seed wallet, so on-chain activity reflects many participants rather than one cron. Rotation now checks each wallet's recorded SOL and USDC before handing it a payment and falls back to the seed payer when nothing in the pool can cover the call, so a freshly minted or thinly funded pool never produces failed payments. The funder that keeps the pool topped up only submits transfers its own wallets can pay for, and the ring status endpoint reports how many pool wallets are minted and how many are ready to pay.",+ "link": null,+ "tags": [+ "infra",+ "improvement"+ ]+ },{"date": "2026-09-21","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex a96a6a298..6e36b6251 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -6,6 +6,22 @@<atom:link href="https://three.ws/changelog.xml" rel="self" type="application/rss+xml"/><description>What's new on three.ws: features, improvements, and releases, newest first.</description><language>en</language>+ <item>+ <title>Authorize the three-ws CLI</title>+ <link>https://three.ws/cli/authorize</link>+ <guid isPermaLink="false">2026-09-22:Authorize the three-ws CLI</guid>+ <pubDate>Tue, 22 Sep 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>Approve a sign-in started by npx three-ws in your terminal. Check the code matches, choose what the new API key may do (money-moving permissions are flagged and can be removed), and the CLI finishes setup on its own.</description>+ </item>+ <item>+ <title>Community Skills</title>+ <link>https://three.ws/skills/community</link>+ <guid isPermaLink="false">2026-09-22:Community Skills</guid>+ <pubDate>Tue, 22 Sep 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>Open-source skills for AI agents: one markdown file of instructions each, contributed by pull request and imported onto any three.ws agent in one click. Search by tag or author, preview the full SKILL.md, then manage your agent's skills and token budget.</description>+ </item><item><title>Data Desk</title><link>https://three.ws/data-desk</link>@@ -30,6 +46,14 @@<category>feature</category><description>The platform's agent economy used to prove the payment rail from a few long-lived wallets buying test calls. It now mints a fresh Solana wallet for every purchase: each one is created, given exactly one job's worth of USDC, pays a three.ws endpoint, and is emptied and closed within the minute. Every purchase does something useful. Some buy a 3D generation that lands in the Agent-Forged Gallery, where a new fresh wallet badge marks it. The rest buy live market data, which now has its own page, the Data Desk, showing each dataset with the wallet that paid, the price, and the Solana receipt. Both feeds are public JSON as well, and a new stats endpoint lists every wallet with its three transactions.</description></item>+ <item>+ <title>The agent economy now pays from thousands of distinct wallets, and only from ones that hold funds</title>+ <link>https://three.ws/changelog</link>+ <guid isPermaLink="false">2026-09-22:The agent economy now pays from thousands of distinct wallets, and only from ones that hold funds</guid>+ <pubDate>Tue, 22 Sep 2026 12:00:00 GMT</pubDate>+ <category>infra</category>+ <description>The x402 ring, the closed loop where three.ws agents pay each other for services, has a pool of 2,000 payer wallets to rotate through instead of a single seed wallet, so on-chain activity reflects many participants rather than one cron. Rotation now checks each wallet's recorded SOL and USDC before handing it a payment and falls back to the seed payer when nothing in the pool can cover the call, so a freshly minted or thinly funded pool never produces failed payments. The funder that keeps the pool topped up only submits transfers its own wallets can pay for, and the ring status endpoint reports how many pool wallets are minted and how many are ready to pay.</description>+ </item><item><title>Forge now asks what your model is for</title><link>https://three.ws/forge</link>diff --git a/public/features.json b/public/features.jsonindex a0bef147f..6a7d179c1 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-09-22T04:19:11.057Z",+ "generated_at": "2026-09-22T06:14:49.325Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -396,6 +396,16 @@"tags": [],"showcase": false},+ {+ "path": "/skills/community",+ "title": "Community Skills",+ "description": "Open-source skills for AI agents: one markdown file of instructions each, contributed by pull request and imported onto any three.ws agent in one click. Search by tag or author, preview the full SKILL.md, then manage your agent's skills and token budget.",+ "added": "2026-09-22",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false+ },{"path": "/community","title": "Community",@@ -1273,6 +1283,16 @@"tags": [],"showcase": false},+ {+ "path": "/cli/authorize",+ "title": "Authorize the three-ws CLI",+ "description": "Approve a sign-in started by npx three-ws in your terminal. Check the code matches, choose what the new API key may do (money-moving permissions are flagged and can be removed), and the CLI finishes setup on its own.",+ "added": "2026-09-22",+ "auth": null,+ "indexable": false,+ "tags": [],+ "showcase": false+ },{"path": "/smart-home/join","title": "Join a home",diff --git a/public/llms-full.txt b/public/llms-full.txtindex 046daca27..01ac55f0e 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -245,6 +245,12 @@ Indexable: no (excluded from sitemap)Browse, search, and install agent skills: tool packs, knowledge bases, and capabilities that make AI agents smarter. Now lives inside the Marketplace; this path forwards there.+### Community Skills++URL: https://three.ws/skills/community++Open-source skills for AI agents: one markdown file of instructions each, contributed by pull request and imported onto any three.ws agent in one click. Search by tag or author, preview the full SKILL.md, then manage your agent's skills and token budget.+### CommunityURL: https://three.ws/community@@ -782,6 +788,13 @@ URL: https://three.ws/materializeTurn any 3D model into a real printed object. Live printability analysis and automatic repair, a true-scale AR preview on your own desk, an itemized price from the mesh's own measured volume, and USDC checkout on Solana.+### Authorize the three-ws CLI++URL: https://three.ws/cli/authorize+Indexable: no (excluded from sitemap)++Approve a sign-in started by npx three-ws in your terminal. Check the code matches, choose what the new API key may do (money-moving permissions are flagged and can be removed), and the CLI finishes setup on its own.+### Join a homeURL: https://three.ws/smart-home/joindiff --git a/public/llms.txt b/public/llms.txtindex 996632d89..d055435c1 100644--- a/public/llms.txt+++ b/public/llms.txt@@ -68,6 +68,7 @@ Entry points into the product.- [Companion](https://three.ws/companion): A 3D companion that delivers your important messages in person. Connect your own Telegram bot, calendar, inbox, or phone, give each contact their own avatar and voice, and hear only what clears your bar.- [Knock](https://three.ws/knock): Put a price on reaching you. Anyone, a person or an agent, can pay it to get exactly one message through, and your 3D companion walks on screen and delivers it out loud with their name and what they paid. The USDC settles straight to your wallet.- [Herald](https://three.ws/herald): Deliver a message in person: a 3D character walks onto your page and tells the user what happened. Open SDK, one line of code, an accessible fallback, and a CLI that announces when your build finishes.+- [Community Skills](https://three.ws/skills/community): Open-source skills for AI agents: one markdown file of instructions each, contributed by pull request and imported onto any three.ws agent in one click. Search by tag or author, preview the full SKILL.md, then manage your agent's skills and token budget.- [Community](https://three.ws/community): Live platform activity plus where to follow, contribute, and connect with three.ws creators.- [Contributors](https://three.ws/contributors): A living thank-you to the developers, issue reporters, and community members improving the open-source three.ws platform.- [Crew HQ](https://three.ws/crews): Found a crew, invite your people, and watch the whole roster stand in one 3D headquarters. Every member appears as their own agent, lit when they are live in the world.diff --git a/public/locales/localized-pages.json b/public/locales/localized-pages.jsonindex 3f7358af5..c606dd768 100644--- a/public/locales/localized-pages.json+++ b/public/locales/localized-pages.json@@ -1,6 +1,6 @@{"generated": true,- "count": 358,+ "count": 245,"paths": ["/","/3d",@@ -159,119 +159,6 @@"/mocap-studio","/motion-swap","/my-agents",- "/news",- "/news/2045242891350814835",- "/news/2049397875935989970",- "/news/2049406826719137937",- "/news/2049412062837928202",- "/news/2049447738434339171",- "/news/2049458671139336613",- "/news/2049476546285740512",- "/news/2049557523330638269",- "/news/2049573582247022869",- "/news/2049576603324411933",- "/news/2049576641127682430",- "/news/2049577291957899336",- "/news/2049762836881301865",- "/news/2049765915575914834",- "/news/2049997615421649363",- "/news/2050016695897706885",- "/news/2050049239301165535",- "/news/2050221269732425928",- "/news/2050226678321102975",- "/news/2050229144676675999",- "/news/2050284562069266616",- "/news/2050585585191186781",- "/news/2050627547394916768",- "/news/2050753406109880576",- "/news/2050758788186353723",- "/news/2050800140295049308",- "/news/2050886334261391686",- "/news/2051140736201175323",- "/news/2051261108506558901",- "/news/2051616708482498843",- "/news/2051689230997618690",- "/news/2051690803203105230",- "/news/2051774915876098063",- "/news/2051858035862335505",- "/news/2051858503523066283",- "/news/2051893054584553680",- "/news/2052037977556287723",- "/news/2052167399399735476",- "/news/2052181307002929363",- "/news/2052189491801284690",- "/news/2052402481024667887",- "/news/2052402580266098813",- "/news/2052418108837781511",- "/news/2052418482269254040",- "/news/2052426446073983267",- "/news/2052588973466484922",- "/news/2052603250524967045",- "/news/2052685648377913671",- "/news/2052790746256920583",- "/news/2052791935585407403",- "/news/2053025259645981078",- "/news/2053698115203743922",- "/news/2053698387263008827",- "/news/2053730856339144932",- "/news/2053801703355629587",- "/news/2053804700609458214",- "/news/2053832201176027583",- "/news/2054404663802483072",- "/news/2054675701132132736",- "/news/2055140064070717618",- "/news/2055307440921702738",- "/news/2055309846556401735",- "/news/2055310365588922872",- "/news/2055517252964024561",- "/news/2055967730495586477",- "/news/2055985494606106821",- "/news/2056556899403997450",- "/news/2057721370310775223",- "/news/2057780453709648200",- "/news/2057782522994684413",- "/news/2057786164862730704",- "/news/2058076885805085111",- "/news/2058287578227577039",- "/news/2059456289789657537",- "/news/2059456294189498830",- "/news/2059456295825223723",- "/news/2059457822941978723",- "/news/2059675892981633179",- "/news/2059712761622675776",- "/news/2059821472156446844",- "/news/2059894004771418220",- "/news/2060178868305326413",- "/news/2060186881636422038",- "/news/2061418285896269952",- "/news/2061488909264040194",- "/news/2061523804405616642",- "/news/2061713039624405062",- "/news/aws-agentic-economy-three-ws",- "/news/aws-builder-center-3d-agents-onchain-payments",- "/news/aws-builder-center-blog",- "/news/aws-marketplace-live-may29",- "/news/bybit-alpha-listing",- "/news/cmc-mcp-registry-article",- "/news/cmc-memecoin-3d-world",- "/news/huggingface-bodies-and-wallets",- "/news/huggingface-building-3d-ai-agents",- "/news/ibm-collaboration-showcase",- "/news/ibm-showcase-may31",- "/news/joined-aws-partner-network",- "/news/listed-on-bnb-chain-dappbay",- "/news/live-on-alibaba-cloud-marketplace",- "/news/live-on-aws-marketplace",- "/news/mcp-servers-x402-bazaar-coinbase",- "/news/monetize-mcp-server-x402-paid-tools",- "/news/moonshot-verified",- "/news/partnered-with-hackernoon",- "/news/quicknode-startup-program",- "/news/text-to-3d-is-live",- "/news/three-ws-dextools-social-boost-buyback",- "/news/three-ws-featured-on-alibaba-cloud-marketplace-blog",- "/news/three-ws-first-month-3d-agent-layer",- "/news/threews-play-coin-communities","/nim-forge","/notifications","/nvidia",diff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex 61bbb7803..c9c91fcb2 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -96,7 +96,7 @@<main class="sm-wrap"><div class="sm-hero"><h1>Sitemap</h1>- <p>All 950 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>+ <p>All 952 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p><div class="sm-formats"><a href="/sitemap.xml"><code>sitemap.xml</code> · for search engines</a><a href="/llms.txt"><code>llms.txt</code> · for AI agents</a>@@ -108,7 +108,7 @@</div><div class="sm-filter"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m21 21-4.3-4.3"/></svg>- <input id="sm-filter-input" type="search" placeholder="Filter 950 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />+ <input id="sm-filter-input" type="search" placeholder="Filter 952 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" /><kbd id="sm-filter-kbd" aria-hidden="true">/</kbd></div><p class="sm-filter-count" role="status" aria-live="polite"><span id="sm-filter-count"></span><span id="sm-filter-hint" aria-hidden="true"></span></p>@@ -124,6 +124,14 @@<span class="sm-desc">Live market data bought minute by minute by brand-new agent wallets over x402. Every dataset carries its receipt: the wallet that paid, the price, and the Solana settlement transaction.</span></a></li>+ <li>+ <a href="/skills/community">+ <span class="sm-new-date">Sep 22, 2026</span>+ <span class="sm-title">Community Skills</span>+ <span class="sm-path">/skills/community</span>+ <span class="sm-desc">Open-source skills for AI agents: one markdown file of instructions each, contributed by pull request and imported onto any three.ws agent in one click. Search by tag or author, preview the full SKILL.md, then manage your agent's skills and token budget.</span>+ </a>+ </li><li><a href="/docs/x402-fresh-workers"><span class="sm-new-date">Sep 22, 2026</span>@@ -180,14 +188,6 @@<span class="sm-desc">Wear smart glasses and the world tells you an agent is standing thirty metres away. How three.ws splits the work: the lens carries the signal, the phone carries the 3D body, and the presence-gated IRL rail carries the truth.</span></a></li>- <li>- <a href="/docs/x402-settlement-pending">- <span class="sm-new-date">Sep 17, 2026</span>- <span class="sm-title">Pending settlement: the third answer an x402 settle can give</span>- <span class="sm-path">/docs/x402-settlement-pending</span>- <span class="sm-desc">Broadcasting a Solana payment and confirming it are separate events, so a settle has three outcomes, not two. What settlement_pending means for a buyer, how our facilitator guarantees one authorization never produces two transactions, and the reconciler that closes the books.</span>- </a>- </li></ul></section><nav class="sm-toc" aria-label="Sections">@@ -205,7 +205,7 @@</nav><section class="sm-section" id="main"><header>- <h2>Main<span class="sm-count" data-count>61</span></h2>+ <h2>Main<span class="sm-count" data-count>62</span></h2><p class="sm-section-desc">Entry points into the product.</p></header><ul class="sm-list">@@ -475,6 +475,13 @@<span class="sm-desc">Browse, search, and install agent skills: tool packs, knowledge bases, and capabilities that make AI agents smarter. Now lives inside the Marketplace; this path forwards there.</span></a></li>+ <li>+ <a href="/skills/community">+ <span class="sm-title">Community Skills</span>+ <span class="sm-path">/skills/community</span>+ <span class="sm-desc">Open-source skills for AI agents: one markdown file of instructions each, contributed by pull request and imported onto any three.ws agent in one click. Search by tag or author, preview the full SKILL.md, then manage your agent's skills and token budget.</span>+ </a>+ </li><li><a href="/community"><span class="sm-title">Community</span>@@ -641,7 +648,7 @@<section class="sm-section" id="build"><header>- <h2>Build<span class="sm-count" data-count>79</span></h2>+ <h2>Build<span class="sm-count" data-count>80</span></h2><p class="sm-section-desc">Create and customize an agent.</p></header><ul class="sm-list">@@ -1093,6 +1100,13 @@<span class="sm-desc">Turn any 3D model into a real printed object. Live printability analysis and automatic repair, a true-scale AR preview on your own desk, an itemized price from the mesh's own measured volume, and USDC checkout on Solana.</span></a></li>+ <li>+ <a href="/cli/authorize">+ <span class="sm-title">Authorize the three-ws CLI<span class="sm-badge sm-badge-internal">internal</span></span>+ <span class="sm-path">/cli/authorize</span>+ <span class="sm-desc">Approve a sign-in started by npx three-ws in your terminal. Check the code matches, choose what the new API key may do (money-moving permissions are flagged and can be removed), and the CLI finishes setup on its own.</span>+ </a>+ </li><li><a href="/smart-home/join"><span class="sm-title">Join a home<span class="sm-badge sm-badge-internal">internal</span></span>diff --git a/scripts/create-distribution-sync-job.mjs b/scripts/create-distribution-sync-job.mjsnew file mode 100644index 000000000..75f64cd87--- /dev/null+++ b/scripts/create-distribution-sync-job.mjs@@ -0,0 +1,137 @@+#!/usr/bin/env node+// Schedule the daily sync of the externally hosted three.ws distributions.+//+// Cloud Scheduler calls the Cloud Build API with distributions/sync/cloudbuild.json+// as the request body, so every run builds the current three.ws main without a+// connected repository or a build trigger. The build merges Hermes Agent upstream+// into nirholas/three-ws-agent and mirrors the Gemini CLI extension (see+// distributions/sync/run.sh).+//+// Pushing to GitHub is publishing, so this is owner-gated: the default prints the+// plan and changes nothing.+//+// node scripts/create-distribution-sync-job.mjs # plan+// node scripts/create-distribution-sync-job.mjs --apply # create or update the job+// node scripts/create-distribution-sync-job.mjs --run-now # also trigger one run+//+// Prerequisite: the secret three-ws-distributions-github-token (a fine-grained PAT+// with contents:write on nirholas/three-ws-agent and nirholas/three-ws-gemini).++import { execFileSync } from 'node:child_process';+import { readFileSync } from 'node:fs';+import { fileURLToPath } from 'node:url';++const PROJECT = 'aerial-vehicle-466722-p5';+const LOCATION = 'us-central1';+const JOB_ID = 'three-ws-distributions-sync';+const SCHEDULE = '17 6 * * *';+const TIME_ZONE = 'Etc/UTC';+const SECRET = 'three-ws-distributions-github-token';+const BUILD_SA = `three-ws-build@${PROJECT}.iam.gserviceaccount.com`;+const CONFIG_PATH = fileURLToPath(new URL('../distributions/sync/cloudbuild.json', import.meta.url));+const BUILDS_URI = `https://cloudbuild.googleapis.com/v1/projects/${PROJECT}/locations/${LOCATION}/builds`;++const argv = process.argv.slice(2);+const apply = argv.includes('--apply') || argv.includes('--run-now');+const runNow = argv.includes('--run-now');++function gcloud(args, { allowFail = false } = {}) {+ try {+ return execFileSync('gcloud', [...args, `--project=${PROJECT}`, '--quiet'], {+ encoding: 'utf8',+ stdio: ['ignore', 'pipe', 'pipe'],+ }).trim();+ } catch (error) {+ if (allowFail) return null;+ throw new Error(`gcloud ${args.join(' ')} failed:\n${error.stderr || error.message}`);+ }+}++function show(args) {+ return `gcloud ${args.map((a) => (/[\s*]/.test(a) ? `'${a}'` : a)).join(' ')} --project=${PROJECT}`;+}++export function jobArgs(verb) {+ return [+ 'scheduler',+ 'jobs',+ verb,+ 'http',+ JOB_ID,+ `--location=${LOCATION}`,+ `--schedule=${SCHEDULE}`,+ `--time-zone=${TIME_ZONE}`,+ `--uri=${BUILDS_URI}`,+ '--http-method=POST',+ `--message-body-from-file=${CONFIG_PATH}`,+ '--headers=Content-Type=application/json',+ `--oauth-service-account-email=${BUILD_SA}`,+ '--oauth-token-scope=https://www.googleapis.com/auth/cloud-platform',+ '--attempt-deadline=180s',+ `--description=Daily sync of three-ws-agent (Hermes upstream) and the three.ws Gemini CLI extension`,+ ];+}++const grants = [+ [+ 'secrets',+ 'add-iam-policy-binding',+ SECRET,+ `--member=serviceAccount:${BUILD_SA}`,+ '--role=roles/secretmanager.secretAccessor',+ ],+ [+ 'iam',+ 'service-accounts',+ 'add-iam-policy-binding',+ BUILD_SA,+ `--member=serviceAccount:${BUILD_SA}`,+ '--role=roles/iam.serviceAccountUser',+ ],+ [+ 'projects',+ 'add-iam-policy-binding',+ PROJECT,+ `--member=serviceAccount:${BUILD_SA}`,+ '--role=roles/cloudbuild.builds.editor',+ '--condition=None',+ ],+];++function main() {+ JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));+ const exists = gcloud(['scheduler', 'jobs', 'describe', JOB_ID, `--location=${LOCATION}`, '--format=value(name)'], {+ allowFail: true,+ });+ const verb = exists ? 'update' : 'create';++ if (!apply) {+ console.log(`Plan (nothing changed; rerun with --apply):\n`);+ console.log(`# 1. The GitHub token (once): paste a fine-grained PAT with contents:write on both repos`);+ console.log(`printf '%s' "$GITHUB_TOKEN" | gcloud secrets create ${SECRET} --data-file=- --project=${PROJECT}\n`);+ console.log(`# 2. Permissions for the build service account`);+ for (const g of grants) console.log(show(g));+ console.log(`\n# 3. The schedule (${SCHEDULE} ${TIME_ZONE}); job ${exists ? 'exists, will update' : 'does not exist, will create'}`);+ console.log(show(jobArgs(verb)));+ console.log(`\n# 4. A first run on demand`);+ console.log(show(['scheduler', 'jobs', 'run', JOB_ID, `--location=${LOCATION}`]));+ return;+ }++ if (!gcloud(['secrets', 'describe', SECRET, '--format=value(name)'], { allowFail: true })) {+ console.error(`Secret ${SECRET} does not exist. Create it first:\n printf '%s' "$GITHUB_TOKEN" | gcloud secrets create ${SECRET} --data-file=- --project=${PROJECT}`);+ process.exit(1);+ }+ for (const g of grants) {+ gcloud(g);+ console.log(`granted: ${g.slice(-1)[0].replace('--role=', '')}`);+ }+ gcloud(jobArgs(verb));+ console.log(`${verb}d scheduler job ${JOB_ID} (${SCHEDULE} ${TIME_ZONE})`);+ if (runNow) {+ gcloud(['scheduler', 'jobs', 'run', JOB_ID, `--location=${LOCATION}`]);+ console.log(`triggered a run; follow it with: gcloud builds list --region=${LOCATION} --filter="tags=three-ws-distributions-sync" --project=${PROJECT}`);+ }+}++if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) main();diff --git a/vercel.json b/vercel.jsonindex e51a68ffb..3249522df 100644--- a/vercel.json+++ b/vercel.json@@ -1034,6 +1034,10 @@"src": "/drops/?$","dest": "/drops.html"},+ {+ "src": "/skills/community/?$",+ "dest": "/skills-community.html"+ },{"src": "/spotlight/?$","dest": "/spotlight.html"@@ -2595,6 +2599,13 @@},"status": 301},+ {+ "src": "/dashboard/connections/?",+ "headers": {+ "Location": "/dashboard/settings#connected-apps"+ },+ "status": 302+ },{"src": "/dashboard/actions","headers": {@@ -3036,6 +3047,18 @@"src": "/marketplace/(tools|skills|animations|onchain)/([^/]+)","dest": "/marketplace.html"},+ {+ "src": "/marketplace/agents/?",+ "dest": "/agent-market.html"+ },+ {+ "src": "/marketplace/agents/dashboard/?",+ "dest": "/agent-market.html"+ },+ {+ "src": "/marketplace/agents/listing/([0-9a-fA-F-]{36})/?",+ "dest": "/agent-market.html"+ },{"src": "/marketplace/agents/([^/]+)","status": 301,diff --git a/vite.config.js b/vite.config.jsindex 77d3d6cc8..b92d51d0b 100644--- a/vite.config.js+++ b/vite.config.js@@ -656,6 +656,7 @@ const appConfig = {'drop-collection': resolve(__dirname, 'pages/drop-collection.html'),pocket: resolve(__dirname, 'pages/pocket.html'),spotlight: resolve(__dirname, 'pages/spotlight.html'),+ 'skills-community': resolve(__dirname, 'pages/skills-community.html'),'spotlight-entry': resolve(__dirname, 'pages/spotlight-entry.html'),certificate: resolve(__dirname, 'pages/certificate.html'),'print-insert': resolve(__dirname, 'pages/print-insert.html'),@@ -749,6 +750,7 @@ const appConfig = {'create-review': resolve(__dirname, 'pages/create-review.html'),'import-rpm': resolve(__dirname, 'pages/import-rpm.html'),marketplace: resolve(__dirname, 'pages/marketplace.html'),+ 'agent-market': resolve(__dirname, 'pages/agent-market.html'),'marketplace-walk': resolve(__dirname, 'pages/marketplace-walk.html'),'marketplace-analytics': resolve(__dirname, 'pages/marketplace-analytics.html'),conversions: resolve(__dirname, 'pages/conversions.html'),@@ -785,6 +787,7 @@ const appConfig = {'agents-live': resolve(__dirname, 'pages/agents-live.html'),monitor: resolve(__dirname, 'pages/monitor.html'),'agent-wallet': resolve(__dirname, 'pages/agent-wallet.html'),+ 'agent-cards': resolve(__dirname, 'pages/agent-cards.html'),wallet: resolve(__dirname, 'pages/wallet.html'),guardian: resolve(__dirname, 'pages/guardian.html'),launches: resolve(__dirname, 'pages/launches.html'),@@ -1636,6 +1639,8 @@ const appConfig = {'/drops/': resolve(root, 'pages/drops.html'),'/pocket': resolve(root, 'pages/pocket.html'),'/pocket/': resolve(root, 'pages/pocket.html'),+ '/skills/community': resolve(root, 'pages/skills-community.html'),+ '/skills/community/': resolve(root, 'pages/skills-community.html'),'/spotlight': resolve(root, 'pages/spotlight.html'),'/spotlight/': resolve(root, 'pages/spotlight.html'),'/cert': resolve(root, 'pages/certificate.html'),@@ -2236,6 +2241,10 @@ const appConfig = {else if (!filePath && /^\/pay\/c\/[a-z0-9][a-z0-9-]+\/?$/.test(path))filePath = resolve(root, 'public/pay/c/index.html');// /dashboard/x402 → x402 SKU dashboard (already in fileMap)+ // Whole-agent marketplace: browse, dashboard, listing detail. Must+ // precede the /marketplace/agents/:id redirect-to-profile rule.+ else if (!filePath && /^\/marketplace\/agents(\/dashboard|\/listing\/[0-9a-fA-F-]{36})?\/?$/.test(path))+ filePath = resolve(root, 'pages/agent-market.html');else if (!filePath && /^\/marketplace\/agents\/[^/]+\/?$/.test(path))filePath = resolve(root, 'pages/marketplace.html');else if (!filePath && /^\/marketplace\/avatars\/[^/]+\/?$/.test(path))@@ -2267,6 +2276,9 @@ const appConfig = {// (must precede the /agent/:id and /agents/:id catch-alls below).else if (!filePath && /^\/agents?\/[^/.]+\/wallet\/?$/.test(path))filePath = resolve(root, 'pages/agent-wallet.html');+ // /agents/:id/cards and /agent-cards → Agent Cards (gift + prepaid cards).+ else if (!filePath && /^\/(agents\/[^/.]+\/cards|agent-cards)\/?$/.test(path))+ filePath = resolve(root, 'pages/agent-cards.html');// /agents/:id/classic → the preserved pre-redesign profile layoutelse if (!filePath && /^\/agents?\/[^/.]+\/classic\/?$/.test(path))filePath = resolve(root, 'pages/agent-detail-classic.html');