@hol-org/hashnet-mcp 1.0.0

package/AGENTS.md

@@ -0,0 +1,133 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+The MCP server lives in `src/` with three core modules: `mcp.ts` (tool wiring and metadata), `broker.ts` (the `RegistryBrokerClient` wrapper), and `transports.ts` (stdio plus SSE server built on Hono). Place shared schemas in `src/schemas/` and transport helpers in `src/transports/` if they grow larger. Configuration belongs in `tsconfig.json`, environment defaults in `.env.example`, and any integration fixtures under `examples/`. Keep tests in `tests/` mirroring the source tree so `tests/mcp/tools.spec.ts` maps cleanly to `src/mcp.ts`.
+
+## Build, Test, and Development Commands
+- `pnpm install` — syncs dependencies, including FastMCP, Hono, and the Hashgraph Online SDK.
+- `pnpm dev:stdio` — launches `src/index.ts` with `MCP_TRANSPORT=stdio`, wired for Claude Desktop.
+- `pnpm dev:sse` — serves `http://localhost:${PORT}/mcp/stream` via Hono’s SSE transport for Claude Code/Cursor.
+- `HTTP_STREAM_PORT` controls the upstream FastMCP HTTP server (defaults to `PORT + 1`). External clients still connect to `http://localhost:${PORT}/mcp/stream` (Streamable HTTP) or `/mcp/sse`.
+- `pnpm build` — runs `tsup` (see `tsup.config.ts`) to emit both `dist/index.js` and the NPX CLI bundle.
+- `pnpm start` — executes the compiled output (`node dist/index.js`) for production parity.
+- `pnpm test --run --coverage` — executes Vitest once with V8 coverage; `pnpm test` stays in watch mode.
+- `pnpm quickstart` — interactive DX script that installs deps, copies `.env`, runs smoke tests, and launches your preferred transport (stdio or SSE).
+- `pnpm test:tools` — end-to-end harness that connects to the HTTP-stream gateway via the official MCP client (Streamable HTTP transport) and calls every `hol.*` tool using sample payloads (set `TEST_UAID`, `TEST_CHAT_UAID`, `TEST_REGISTRATION_ATTEMPT_ID` to cover UAID/chat flows). The script manages its own server lifecycle; do **not** pass `--spawn` manually.
+- `pnpm test:tools:mock` — runs the same harness against the built-in mock MCP server so CI can exercise the exit flow without touching the real Registry Broker.
+- `BROKER_PROTOCOL_TOOLS=1` — optional flag to include `hol.listProtocols` / `hol.detectProtocol` in the tool suite; leave unset if your API key or environment doesn't expose those endpoints (the public staging broker returns 404).
+- `pnpm workflow:list` / `pnpm workflow:run <name>` — inspect and execute any workflow (pair with `examples/workflows/<workflow>.json` for sample payloads).
+- `pnpm workflow:register` — interactive wizard that runs the registration/chat/ops workflows and saves a JSON report (UAID + Claude snippet).
+- `pnpm workflow:register:advanced` — guided prompts for `workflow.registerAgentAdvanced` (additional registries + optional credit purchase).
+- `pnpm workflow:register:erc8004` — helper around the ERC-8004 workflow (ledger walkthrough + post-registration chat).
+- `pnpm mock:broker` — local mock broker for CI/contract testing.
+- All scripts load `.env` automatically via `dotenv`, so once you copy `.env.example` you can simply edit the file and re-run commands without re-exporting variables.
+
+## Workflows
+`pnpm workflow:list` prints every registered pipeline, and each one has a golden-path payload under `examples/workflows/`. Copy the file, replace the placeholder UAIDs/API keys, then run `pnpm workflow:run <name> --payload <file>`.
+
+**Discovery & Ops**
+- `workflow.discovery` and `workflow.erc8004Discovery` (search/vector/namespace lookups).
+- `workflow.opsCheck` (stats + metrics + protocols).
+- `workflow.registryBrokerShowcase` (discovery → analytics → optional chat).
+
+**Registration Pipelines**
+- `workflow.registerMcp`, `workflow.registerAgentAdvanced`, `workflow.registerAgentErc8004`.
+- `workflow.fullRegistration` (discovery → registration → chat → ops).
+- `workflow.erc8004X402` and `workflow.x402Registration` (registration funded via X402 with optional chat checks).
+
+**Credit & Ledger Utilities**
+- `workflow.ledgerAuth` (challenge + verify).
+- `workflow.x402TopUp` (buy credits via X402).
+- `workflow.historyTopUp` (chat compaction + HBAR auto-purchases on 402 errors).
+
+**Chat & Interop**
+- `workflow.chatSmoke` (UAID session lifecycle).
+- `workflow.openrouterChat` (discover + ping an OpenRouter model).
+- `workflow.agentverseBridge` (relay traffic between a local UAID and Agentverse).
+
+Runbook examples:
+
+```
+pnpm workflow:run workflow.registerAgentAdvanced --payload examples/workflows/workflow.registerAgentAdvanced.json
+pnpm workflow:run workflow.openrouterChat --payload examples/workflows/workflow.openrouterChat.json --endpoint https://host/mcp/stream
+```
+
+Each workflow emits a structured report (steps, timings, context) whether executed via MCP or CLI.
+
+### Workflow Architecture
+- Pipelines live in `src/workflows/`; each file exports a `registerPipeline()` definition.
+- `src/workflows/index.ts` imports these modules so they register at startup.
+- MCP tools (`workflow.*`) are wired in `src/mcp.ts` and simply call the pipelines.
+- For a visual overview, see the "Architecture Overview" section in `README.md`.
+
+### Required Environment Variables
+- `REGISTRY_BROKER_API_URL` / `REGISTRY_BROKER_API_KEY` — broker endpoint + key (staging/testnet supported).
+- `HEDERA_ACCOUNT_ID` / `HEDERA_PRIVATE_KEY` — optional; only set these if you want CLI-driven credit purchases when the key runs dry.
+- `WORKFLOW_DRY_RUN=1` — optional guard that makes pipelines skip state-changing broker calls.
+- `BROKER_E2E=1` — opt into real broker hits in CI; otherwise the mock broker is used when available.
+- `BROKER_AUTO_TOP_UP=1` — opt into automatic broker purchases without HITL prompts (defaults to manual approvals).
+- X402 workflows also require EVM wallet details (see `examples/workflows/workflow.x402*.json`) plus any ledger challenge metadata referenced in the payload.
+- Tool-suite fixtures (optional): `TEST_UAID`, `TEST_CHAT_UAID`, `TEST_REGISTRATION_ATTEMPT_ID`, and `BROKER_PROTOCOL_TOOLS`. Populate them (see `.env.example`) so `pnpm test:tools` can exercise UAID/chat flows locally or skip protocol checks when the broker doesn’t expose those endpoints; leave blank to rely on auto-discovered UAIDs/attempt IDs from the preceding scenarios.
+Workflow pipelines declare their required env vars and will fail fast with a descriptive error if anything is missing; payload-specific secrets (OpenRouter tokens, Agentverse headers, bearer tokens) should be supplied via `.env` or injected by your CLI before invoking the workflow.
+
+### Running `pnpm workflow:register`
+1. The CLI prompts for display name, alias, description, MCP URL, chat message, and report path (defaults provided).
+2. Runs the registration → chat → ops pipelines and prints progress to the console.
+3. Writes the report JSON (defaults to `workflow-register-report.json`) containing:
+   - UAID (if registration succeeded)
+   - Pipeline traces (steps + context)
+   - Claude config snippet pointing at your MCP URL
+   - Raw pipeline responses for registration/chat/ops
+
+**Sample report excerpt**
+
+```json
+{
+  "uaid": "uaid:registry:abcd-1234",
+  "pipelines": [
+    { "name": "workflow.registerMcp", "steps": ["hol.getRegistrationQuote", "hol.registerAgent"] }
+  ],
+  "claudeConfig": {
+    "mcpServers": {
+      "hashnet": {
+        "command": "npx",
+        "args": ["@hol-org/hashnet-mcp@latest", "up", "--transport", "sse"]
+      }
+    }
+  }
+}
+```
+
+The CLI spends the API key’s existing credits first. If the broker rejects the registration (HTTP 402), the script fetches a fresh quote, prints the required/available credits, and prompts for HITL approval before calling `purchaseCreditsWithHbar` (when `HEDERA_*` are configured). It continues only after the broker reports the new balance. Toggle `BROKER_AUTO_TOP_UP=1` if you want the SDK’s legacy auto top-up behaviour without prompts.
+
+### Adding / Extending Workflows
+1. Create `src/workflows/<name>.ts`, register the pipeline with metadata + env requirements, and export any helper schemas.
+2. Import it from `src/workflows/index.ts` so registration happens at server boot.
+3. Optional MCP tool: define schemas/handlers in `src/mcp.ts` and wrap responses with `formatPipelineResult`.
+4. Tests belong in `tests/workflows/<name>.spec.ts` (unit) plus CLI hooks in `scripts/workflow-run*.ts` when interactive flags are required.
+5. Document new workflows (README/AGENTS) and mention logging fields or env toggles to keep DX consistent.
+
+## Coding Style & Naming Conventions
+Use TypeScript with strict mode enabled and 2-space indentation. Prefer explicit return types on exported functions, `zod` schemas for all tool inputs, and descriptive FastMCP tool IDs (`hol.search`, `hol.resolveUaid`). Filenames stay kebab-case (`hashnet-tool.ts`), while classes remain PascalCase and functions camelCase. Run `pnpm lint` (ESLint + `@typescript-eslint`) and `pnpm format` (Prettier) before pushing; both respect the repo’s `.editorconfig`.
+
+## Testing Guidelines
+Vitest powers unit tests, and supertest-style integration tests cover the Hono transport. Name files `*.spec.ts` for unit scope and `*.int.spec.ts` for transport flows. Mock the broker via dependency injection so tests never hit the live Registry API; only allow network calls inside smoke tests guarded by `BROKER_E2E=1`. Maintain >90% branch coverage for `src/mcp.ts` and `src/broker.ts`, since they enforce tool contracts.
+
+## Commit & Pull Request Guidelines
+Follow Conventional Commits (`feat: add UAID validator`, `fix: guard vector search limit`). Bundle related file changes and keep commit bodies focused on the “why.” PRs should include: purpose summary, testing evidence (`pnpm test --run --coverage`), config diffs when touching `.env`, and screenshots or curl snippets for new transport endpoints. Link issues or TODO references in the description so MCP consumers understand the lifecycle.
+
+## Security & Configuration Tips
+Never commit `.env` or keys; ship a `.env.example` with placeholder values. Treat `HEDERA_PRIVATE_KEY` as production-only and load it via secrets management when deploying. Prefer `process.env` lookups consolidated in a single `src/config.ts` module to avoid desync. When testing auto top-ups, set throttles via `Bottleneck` in `broker.ts` to keep Registry traffic predictable.
+
+## Observability & Operations
+- `pino` logging is centralized in `src/logger.ts`; set `LOG_LEVEL=fatal|error|warn|info|debug|trace`.
+- `/healthz` replies with `{ status, uptime, tools }` for Fly/Cloud Run probes.
+- Enable distributed throttling by setting `BROKER_MAX_CONCURRENT`, `BROKER_MIN_TIME_MS`, and `BROKER_RATE_LIMIT_REDIS_URL`; `withBroker` automatically queues calls.
+
+## Deployment & MCP Clients
+- `deploy/fly.toml` and `deploy/Dockerfile`/`deploy/README.md` document Fly.io and Cloud Run rollouts (SSE endpoint exposed at `/mcp/stream`).
+- Claude Desktop config: point to `pnpm dev:stdio` with the necessary Registry env vars; Claude Code/Cursor should target the SSE URL published by Fly/Cloud Run.
+
+## NPX Installer
+- `npx @hol-org/hashnet-mcp up --transport sse` bootstraps deps, copies `.env.example`, and launches the desired transport; `--install-only` skips the final run.
+- The CLI lives in `src/cli/up.ts` (bundled to `dist/cli/up.js`) and doubles as the package `bin` for NPX installs.

package/README.md

@@ -0,0 +1,251 @@
+# Hashnet MCP
+
+Node/TypeScript Model Context Protocol server exposing the Hashgraph Online Registry Broker via FastMCP, with both stdio and SSE transports. See `AGENTS.md` for full contributor guidance.
+
+## Directory Layout
+- `src/` – application source code. Core entrypoints (`mcp.ts`, `broker.ts`) live here.
+- `src/schemas/` – shared zod schemas and SDK-driven types.
+- `src/transports/` – stdio/SSE transport helpers plus bootstrap glue.
+- `tests/` – Vitest specs mirroring the `src/` tree.
+- `examples/` – sample payloads, env snippets, and integration fixtures.
+
+## Getting Started
+```
+pnpm install
+pnpm dev:stdio # once scripts are added
+```
+Copy `.env.example` to `.env` and fill in Registry Broker + Hedera credentials before running transports.
+All transports, workflows, and CLI scripts load `.env` automatically via `dotenv`, so once the file is populated you can run `pnpm dev:*`, `pnpm workflow:*`, or tests without re-exporting environment variables.
+
+### Zero-touch Quickstart
+```
+pnpm quickstart
+```
+The DX script will:
+1. Copy `.env.example` (and let you inject your Registry Broker API key).
+2. Install dependencies, build the project, and run smoke tests.
+3. Launch the dev transport you choose (`sse` by default) with a stylized CLI experience.
+
+## Logging & Health
+- `LOG_LEVEL` controls `pino` verbosity (`fatal`, `error`, `warn`, `info`, `debug`, `trace`).
+- Every tool invocation is logged with a requestId plus duration; SSE/stdio transport logs each HTTP request.
+- `/healthz` returns `{ status, uptime, tools }` so Fly.io/Cloud Run probes can verify readiness.
+- Optional rate limiting is enabled via the `BROKER_*` variables; point `BROKER_RATE_LIMIT_REDIS_URL` at your Redis cluster to queue requests across replicas.
+- `HTTP_STREAM_PORT` lets you pin the internal FastMCP HTTP-stream backend to a specific port (defaults to `PORT + 1`). External clients always connect to `http://<host>:PORT/mcp/stream` (Streamable HTTP) or `http://<host>:PORT/mcp/sse` (SSE fallback).
+
+## MCP Client Configuration
+Claude Desktop (stdio):
+
+```json
+{
+  "mcpServers": {
+    "hashgraph-standards": {
+      "command": "pnpm",
+      "args": ["dev:stdio"],
+      "env": {
+        "REGISTRY_BROKER_API_URL": "https://registry.hashgraphonline.com/api/v1",
+        "REGISTRY_BROKER_API_KEY": "YOUR_KEY"
+      }
+    }
+  }
+}
+```
+
+Claude Code / Cursor (HTTP streaming): point the client at `https://<host>/mcp/stream` once deployed (see `deploy/README.md`). Use `pnpm dev:sse` locally to expose the same endpoint at `http://localhost:3333/mcp/stream`. SSE fallback remains available at `/mcp/sse` for clients that still require it.
+
+#### Claude Code auto-install
+- `pnpm claude:install --endpoint http://localhost:3333/mcp/stream` — adds/updates the MCP entry inside Claude Code’s config (`~/Library/Application Support/Claude/claude_code_config.json` on macOS; `%APPDATA%\Claude\claude_code_config.json` on Windows; `~/.config/Claude/claude_code_config.json` on Linux).
+- Pass `--name <id>` to customize the MCP server handle or `--config <path>` if your Claude Code build stores config elsewhere.
+- Use `--force` to overwrite an existing entry, `--dry-run` to preview changes, and `--skip-backup` to avoid writing a `.bak` file next to the config.
+- After running the script, restart Claude Code so the client discovers the new `hol.*` tool catalog automatically.
+
+#### Cursor auto-install
+- `pnpm cursor:install --endpoint http://localhost:3333/mcp/stream` — writes/updates the `modelContextProtocol.servers` array inside Cursor’s `settings.json` (`~/Library/Application Support/Cursor/User/settings.json` on macOS; `%APPDATA%\Cursor\User\settings.json` on Windows; `~/.config/Cursor/User/settings.json` on Linux).
+- Use `--name <id>` to change the MCP handle, `--config <path>` to point at a custom settings file, and `--force` if you need to replace an existing server entry.
+- Add `--dry-run` to preview the merged JSON. Once applied, restart Cursor so the MCP list refreshes and exposes the `hol.*` commands.
+
+### Workflow Helpers
+Run `pnpm workflow:list` to see the live catalog (the script reads `src/workflows/index.ts`, so it never goes stale). Each workflow’s golden-path payload lives under `examples/workflows/`—copy one, replace the placeholder UAIDs/keys, and pass it to `pnpm workflow:run <workflow> --payload <file>`.
+
+**Discovery & Ops**
+- `workflow.discovery` – `hol.search` + `hol.vectorSearch` (`examples/workflows/workflow.discovery.json`)
+- `workflow.erc8004Discovery` – ERC-8004 search + namespace lookup (`examples/workflows/workflow.erc8004Discovery.json`)
+- `workflow.opsCheck` – Stats/metrics/protocol snapshot (`examples/workflows/workflow.opsCheck.json`)
+- `workflow.registryBrokerShowcase` – Discovery + analytics + optional chat (`examples/workflows/workflow.registryBrokerShowcase.json`)
+
+**Registration Pipelines**
+- `workflow.registerMcp` – Quote → register → wait (`examples/workflows/workflow.registerMcp.json`)
+- `workflow.registerAgentAdvanced` – Additional registries + optional update + HITL credit top-up (`examples/workflows/workflow.registerAgentAdvanced.json`)
+- `workflow.registerAgentErc8004` – ERC-8004 network resolution + optional ledger verification (`examples/workflows/workflow.registerAgentErc8004.json`)
+- `workflow.erc8004X402` – ERC-8004 registration funded via X402 with follow-up chat (`examples/workflows/workflow.erc8004X402.json`)
+- `workflow.x402Registration` – General-purpose registration paid for by X402 credits (`examples/workflows/workflow.x402Registration.json`)
+- `workflow.fullRegistration` – Discovery → registration → chat → ops composite (`examples/workflows/workflow.fullRegistration.json`)
+
+**Credit & Ledger Utilities**
+- `workflow.ledgerAuth` – Create + verify ledger challenges (`examples/workflows/workflow.ledgerAuth.json`)
+- `workflow.x402TopUp` – Buy credits via X402 (`examples/workflows/workflow.x402TopUp.json`)
+- `workflow.historyTopUp` – Chat + history compaction + automatic HBAR purchases on 402s (`examples/workflows/workflow.historyTopUp.json`)
+
+**Chat & Interop**
+- `workflow.chatSmoke` – Session lifecycle validation (`examples/workflows/workflow.chatSmoke.json`)
+- `workflow.openrouterChat` – Discover an OpenRouter UAID and send an authenticated message (`examples/workflows/workflow.openrouterChat.json`)
+- `workflow.agentverseBridge` – Relay between a local UAID and Agentverse (`examples/workflows/workflow.agentverseBridge.json`)
+
+Common CLI patterns:
+
+```
+pnpm workflow:list
+pnpm workflow:run workflow.registerAgentAdvanced --payload examples/workflows/workflow.registerAgentAdvanced.json
+pnpm workflow:run workflow.openrouterChat --payload examples/workflows/workflow.openrouterChat.json --endpoint https://host/mcp/stream
+pnpm workflow:register
+pnpm workflow:register:advanced
+pnpm workflow:register:erc8004
+```
+
+`workflow:run` spawns the local server (if needed) and prints a structured pipeline report. Use `--endpoint https://host/mcp/stream` to target a remote deployment; add `--reuse-server` to skip spawning when pointing at an already-running localhost instance.
+
+`pnpm workflow:register` flow:
+1. CLI prompts for display name, alias, description, MCP URL, chat message, and report path.
+2. Runs `workflow.registerMcp`, `workflow.chatSmoke`, `workflow.opsCheck` sequentially.
+3. Saves `workflow-register-report.json` (configurable) containing:
+   - `uaid`
+   - Pipeline traces (steps, dry-run flag, UAID context)
+   - Claude config snippet with your MCP URL
+   - Raw pipeline results (registration/chat/ops)
+
+**Sample report snippet**
+
+```json
+{
+  "uaid": "uaid:registry:abcd-1234",
+  "claudeConfig": {
+    "mcpServers": {
+      "hashnet": {
+        "command": "npx",
+        "args": ["@hol-org/hashnet-mcp@latest", "up"]
+      }
+    }
+  },
+  "pipelines": [
+    {
+      "name": "workflow.registerMcp",
+      "steps": [
+        { "id": "hol.getRegistrationQuote", "durationMs": 812 },
+        { "id": "hol.registerAgent", "durationMs": 1420 }
+      ]
+    }
+  ]
+}
+```
+
+During `workflow.registerMcp`, the CLI always attempts to spend the API key’s existing credits first. Only if the broker rejects the registration with a 402 does the script fetch the latest quote, show the required/available credits plus the estimated ℏ charge, and ask for HITL approval before calling `purchaseCreditsWithHbar`. It then polls the quote endpoint until the newly purchased credits appear so you never pay without seeing the balance update. Set `BROKER_AUTO_TOP_UP=1` if you need the “fire-and-forget” auto top-up behaviour with no prompts.
+
+#### Workflow Environment Requirements
+- Every workflow requires `REGISTRY_BROKER_API_KEY`. Discovery/ops flows can run with just that variable.
+- Registration workflows (`workflow.register*`, `workflow.fullRegistration`) will prompt for purchases when credits are low. Provide `HEDERA_ACCOUNT_ID` + `HEDERA_PRIVATE_KEY` to allow automatic HBAR-based top-ups; otherwise the pipeline aborts on 402.
+- X402 flows (`workflow.x402*`, `workflow.erc8004X402`) also need an EVM private key plus any ledger verification payloads referenced in the sample JSON.
+- Chat/interop flows (`workflow.chatSmoke`, `workflow.agentverseBridge`, `workflow.openrouterChat`, `workflow.historyTopUp`) require valid UAIDs and, when applicable, bearer tokens for the downstream service.
+- `examples/workflows/*.json` files include clearly named placeholders (e.g., `0xYOUR_EVM_PRIVATE_KEY`). Replace them before running `workflow:run`; keeping them as-is will cause schema validation or broker auth failures.
+
+### Hol Tool Catalog
+These FastMCP tools are available everywhere the server runs (CLI, Claude Desktop, Claude Code, Cursor, or any MCP-compliant client).
+
+| Tool | Purpose |
+| --- | --- |
+| `hol.search.help` | Markdown primer that documents filters and usage for search-heavy agents. |
+| `hol.search` | Keyword search across the Registry Broker catalog with filtering and sorting controls. |
+| `hol.vectorSearch` | Embedding-backed discovery endpoint for semantic matches. |
+| `hol.resolveUaid` | Look up metadata and trust status for a UAID or alias. |
+| `hol.closeUaidConnection` | Forcibly closes any active UAID tunnel after ops or chat completes. |
+| `hol.getRegistrationQuote` | Fetch cost + prerequisites before registering a new agent. |
+| `hol.registerAgent` | Submit a signed registration payload to the broker. |
+| `hol.waitForRegistrationCompletion` | Poll the broker until a registration attempt succeeds, fails, or times out. |
+| `hol.chat.createSession` | Start a chat session scoped to a UAID. |
+| `hol.chat.sendMessage` | Send a broker-routed chat message within an existing session. |
+| `hol.chat.history` | Retrieve the message transcript for observability or resume flows. |
+| `hol.chat.compact` | Truncate chat history while preserving a fixed number of recent entries. |
+| `hol.chat.end` | End the active session and release broker-side resources. |
+| `hol.listProtocols` | Enumerate known Registry Broker protocols plus transport metadata. |
+| `hol.detectProtocol` | Inspect headers/body to auto-detect which broker protocol applies. |
+| `hol.stats` | Aggregate registry stats (totals, growth, health). |
+| `hol.metricsSummary` | Pull summarized broker metrics for dashboards. |
+| `hol.dashboardStats` | Fetch the dashboard-friendly stats bundle used by ops workflows. |
+| `hol.credits.balance` | Return API key, Hedera, and (optionally) X402 credit balances from `/credits/balance`. |
+
+#### Invoking Tools from the CLI
+- `pnpm test:tools` — boot the SSE transport on `http://localhost:3333/mcp/stream` and run every `hol.*` tool with sample payloads (set `TEST_UAID`, `TEST_CHAT_UAID`, `TEST_REGISTRATION_ATTEMPT_ID` so UAID/chat steps execute instead of skipping). No need to append `--spawn`; the script already starts/stops the local server.
+- `pnpm test:tools:mock` — smoke-test the CLI against the bundled mock MCP server (no registry/Broker access required). Useful for CI to verify the harness exits cleanly with code 0.
+- `pnpm test:tools --endpoint https://host/mcp/stream` — hit a remote deployment without spawning a local server; combine with `--port <n>` when using `--spawn` to change the local port.
+- Use `TEST_UAID=<uaid> TEST_CHAT_UAID=<uaid> pnpm test:tools --spawn` to pass environment variables inline; the harness reports missing vars and skips dependent tools if they are not provided.
+- Set `BROKER_PROTOCOL_TOOLS=1` if your API key has access to the `/protocols` + `/detect-protocol` endpoints; otherwise those scenarios are skipped (the staging broker currently returns 404 for those routes).
+- For ad-hoc calls, point `scripts/run-tool-suite.ts` at any MCP endpoint (`tsx scripts/run-tool-suite.ts --endpoint ...`) and edit the scenarios array to focus on a subset of tools or custom payloads.
+
+### Workflow Environment Requirements
+- `REGISTRY_BROKER_API_URL` / `REGISTRY_BROKER_API_KEY` – base URL + key for the Registry Broker API (staging/testnet supported).
+- `HEDERA_ACCOUNT_ID` / `HEDERA_PRIVATE_KEY` – optional; only required if you want the CLI to purchase credits on your behalf when the API key runs dry.
+- `WORKFLOW_DRY_RUN=1` – skip state-changing steps (quote-only, no registration).
+- `BROKER_E2E=1` – opt in to real broker calls inside CI/e2e scripts (otherwise the mock broker is used where possible).
+- `BROKER_AUTO_TOP_UP=1` – opt in to automatic broker purchases without prompts (defaults to `0`, which enables HITL confirmation).
+- Tool-suite fixtures (optional): `TEST_UAID`, `TEST_CHAT_UAID`, `TEST_REGISTRATION_ATTEMPT_ID`, and `BROKER_PROTOCOL_TOOLS`. Populate these in `.env` (see `.env.example`) so `pnpm test:tools` can run UAID/chat flows locally and skip protocol checks unless your API key has access. Leave them blank to let the suite auto-discover UAIDs/attempt IDs from preceding steps.
+
+Each workflow definition lists its required env vars and the pipeline runner will fail fast (before touching the broker) if any are missing. Restart the MCP server after changing credentials so FastMCP snapshots the updated environment.
+
+## NPX Quick Start
+```
+npx @hol-org/hashnet-mcp up --transport sse
+```
+The CLI verifies Node ≥18, installs dependencies (preferring pnpm), copies `.env.example` if needed, and launches the requested transport. Pass `--install-only` to skip auto-start. See `AGENTS.md` for advanced flags.
+
+## Deployment
+- `deploy/fly.toml` – Fly.io app manifest exposing `/mcp/stream`.
+- `deploy/Dockerfile` – Cloud Run-ready image that builds the project and runs `node dist/index.js`.
+- `deploy/README.md` – step-by-step instructions for both targets.
+
+## Architecture Overview
+
+```
+[ CLI / Agent ]
+       │
+       ▼
+┌──────────────────────┐
+│ MCP Gateway (Hono)   │
+│ /mcp/stream & /mcp/sse│
+└─────────┬────────────┘
+          │ proxies HTTP stream traffic
+┌─────────▼────────────┐
+│ FastMCP / mcp.ts     │  ← registers `hol.*` + `workflow.*` tools
+│   ├─ broker.ts       │  ← wraps RegistryBrokerClient
+│   └─ workflows/      │  ← pipeline definitions + registry
+└─────────┬────────────┘
+          │
+          ▼
+┌──────────────────────┐
+│ Workflow Pipelines   │
+│ (discovery/register/ │
+│  chat/ops/full)      │
+└──────────────────────┘
+```
+
+- `src/workflows/pipeline.ts` implements the reusable pipeline engine (steps, hooks, dry-run).
+- `src/workflows/*.ts` define domain workflows; importing `src/workflows/index.ts` registers them.
+- MCP tools (`workflow.*`) simply call the registered pipelines and return structured reports.
+
+## Examples
+- `examples/agent-registration-request.json` mirrors the stricter schema used by `hol.registerAgent` and `hol.getRegistrationQuote`.
+
+## Testing & Automation
+- `pnpm test --run --coverage` — runs Vitest in CI mode with V8 coverage, ensuring `src/mcp.ts` and `src/broker.ts` stay above the 90% branch threshold.
+- `pnpm test:run` — quick single-pass test run without coverage.
+- `pnpm test:tools` — spins up the HTTP-stream gateway (unless one is already running) and exercises every MCP tool end-to-end via the official MCP client (Streamable HTTP transport). Set `TEST_UAID`, `TEST_CHAT_UAID`, and `TEST_REGISTRATION_ATTEMPT_ID` if you want UAID-specific flows to run instead of being skipped.
+- `pnpm workflow:list` / `pnpm workflow:run <name>` — inspect and execute the built-in pipelines (use `examples/workflows/*.json` for payloads).
+- `pnpm workflow:register` — prompts for metadata, runs the registration/chat/ops pipelines, and writes a JSON report (UAID, Claude config snippet, workflow traces).
+- `pnpm workflow:register:advanced` — guided version of the advanced workflow (additional registries + optional credit purchasing prompts).
+- `pnpm workflow:register:erc8004` — helper around the ERC-8004 workflow (ledger prompts + X402/X-Ledger guidance).
+- `pnpm mock:broker` — boot a lightweight mock Registry Broker for CI/testing without external dependencies.
+
+## Adding New Workflows
+1. Create `src/workflows/<name>.ts` exporting a factory that calls `registerPipeline()` with metadata (description, input schema, required env vars).
+2. Import the module inside `src/workflows/index.ts` so the pipeline registers at startup.
+3. Wire an MCP tool in `src/mcp.ts` (define a `zod` schema, call `runPipeline`, and convert the result with `formatPipelineResult`).
+4. Add Vitest coverage in `tests/workflows/<name>.spec.ts` plus CLI smoke coverage if pipelines should be runnable via `workflow:run`.
+5. Update README/AGENTS describing the workflow, logging fields, and any CLI flags so downstream agents know how to trigger it.

package/deploy/Dockerfile

@@ -0,0 +1,24 @@
+FROM node:20-slim AS deps
+WORKDIR /app
+ENV NODE_ENV=production
+RUN corepack enable
+COPY package.json pnpm-lock.yaml ./
+RUN pnpm install --frozen-lockfile
+
+FROM node:20-slim AS builder
+WORKDIR /app
+RUN corepack enable
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN pnpm build
+
+FROM node:20-slim
+WORKDIR /app
+ENV NODE_ENV=production
+ENV PORT=3333
+RUN corepack enable
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/dist ./dist
+COPY package.json pnpm-lock.yaml .
+EXPOSE 3333
+CMD ["node", "dist/index.js"]

package/deploy/README.md

@@ -0,0 +1,31 @@
+# Deployment Guide
+
+## Fly.io
+1. Install the Fly CLI and log in: `fly auth signup` or `fly auth login`.
+2. Create the app and volume: `fly launch --now --copy-config --copy-env` (the bundled `fly.toml` targets `/healthz`).
+3. Supply secrets:
+   ```bash
+   fly secrets set REGISTRY_BROKER_API_URL=... REGISTRY_BROKER_API_KEY=...
+   fly secrets set HEDERA_ACCOUNT_ID=... HEDERA_PRIVATE_KEY=...
+   ```
+4. Deploy: `fly deploy -c deploy/fly.toml`.
+5. Configure Claude Code/Cursor with `https://<app>.fly.dev/mcp/stream`.
+
+## Cloud Run (GCP)
+1. Build the container:
+   ```bash
+   gcloud builds submit --tag gcr.io/PROJECT_ID/hashnet-mcp --config deploy/Dockerfile
+   ```
+2. Deploy the service:
+   ```bash
+   gcloud run deploy hashnet-mcp \
+     --image gcr.io/PROJECT_ID/hashnet-mcp \
+     --platform managed \
+     --allow-unauthenticated \
+     --set-env-vars PORT=3333 \
+     --set-secrets REGISTRY_BROKER_API_KEY=projects/.../secrets/... \
+     --region us-central1
+   ```
+3. Confirm `/healthz` returns `200` and wire clients to `https://hashnet-mcp-<region>.a.run.app/mcp/stream`.
+
+Both platforms honor the same `.env` variables; enable rate limiting by setting the `BROKER_*` values and pointing Redis to a managed cache.

package/deploy/fly.toml

@@ -0,0 +1,41 @@
+app = "hashnet-mcp"
+primary_region = "iad"
+
+[build]
+  dockerfile = "deploy/Dockerfile"
+
+[env]
+  PORT = "3333"
+
+[[services]]
+  processes = ["app"]
+  protocol = "tcp"
+  internal_port = 3333
+
+  [[services.ports]]
+    handlers = ["http"]
+    port = 80
+
+  [[services.ports]]
+    handlers = ["tls", "http"]
+    port = 443
+
+  [[services.tcp_checks]]
+    interval = "10s"
+    timeout = "2s"
+
+  [[services.http_checks]]
+    interval = "15s"
+    timeout = "5s"
+    grace_period = "30s"
+    method = "GET"
+    path = "/healthz"
+
+[checks]
+  [checks.healthz]
+    type = "http"
+    port = 3333
+    interval = "15s"
+    timeout = "5s"
+    method = "GET"
+    path = "/healthz"

package/dist/cli/up.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+
+// src/cli/up.ts
+import { spawnSync } from "child_process";
+import { copyFileSync, existsSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+var dirname = path.dirname(fileURLToPath(import.meta.url));
+var projectRoot = path.resolve(dirname, "../..");
+var args = process.argv.slice(2);
+var command = args[0];
+if (!command || command === "--help" || command === "-h") {
+  printHelp();
+  process.exit(0);
+}
+if (command !== "up") {
+  console.error(`Unknown command: ${command}`);
+  printHelp();
+  process.exit(1);
+}
+var flags = parseFlags(args.slice(1));
+var transport = (flags.transport ?? "stdio").toLowerCase();
+var installOnly = Boolean(flags["install-only"]);
+try {
+  ensureNodeVersion();
+  const packageManager = detectPackageManager();
+  installDependencies(packageManager);
+  ensureEnvFile();
+  if (installOnly) {
+    console.log("Dependencies installed. Skipping server launch (--install-only set).");
+    process.exit(0);
+  }
+  runServer(packageManager, transport);
+} catch (error) {
+  console.error(error instanceof Error ? error.message : error);
+  process.exit(1);
+}
+function printHelp() {
+  console.log(`Usage: npx @hol-org/hashnet-mcp up [options]
+
+Options:
+  --transport <stdio|sse>  Choose the transport to start (default: stdio)
+  --install-only          Install deps and sync .env, then exit
+  -h, --help              Show this help message`);
+}
+function parseFlags(values) {
+  const cloned = [...values];
+  return cloned.reduce((acc, entry, index) => {
+    if (entry.startsWith("--")) {
+      const [key, inlineValue] = entry.split("=");
+      const normalized = key.replace(/^--/, "");
+      if (inlineValue !== void 0) {
+        acc[normalized] = inlineValue;
+      } else {
+        const next = cloned[index + 1];
+        if (next && !next.startsWith("--")) {
+          acc[normalized] = next;
+          cloned.splice(index + 1, 1);
+        } else {
+          acc[normalized] = true;
+        }
+      }
+    }
+    return acc;
+  }, {});
+}
+function ensureNodeVersion() {
+  const major = Number(process.versions.node.split(".")[0]);
+  if (Number.isNaN(major) || major < 18) {
+    throw new Error(`Node.js 18+ is required (detected ${process.versions.node}).`);
+  }
+}
+function detectPackageManager() {
+  if (commandExists("pnpm")) {
+    return "pnpm";
+  }
+  console.warn("pnpm not detected. Attempting to enable via corepack...");
+  const enabled = spawnSync("corepack", ["enable", "pnpm"], { stdio: "inherit" });
+  if (enabled.status === 0 && commandExists("pnpm")) {
+    return "pnpm";
+  }
+  console.warn("Falling back to npm. Install pnpm globally for faster installs.");
+  return "npm";
+}
+function commandExists(bin) {
+  try {
+    const result = spawnSync(bin, ["--version"], { stdio: "ignore" });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+function installDependencies(pm) {
+  console.log(`Installing dependencies with ${pm}...`);
+  const installResult = spawnSync(pm, ["install"], {
+    cwd: projectRoot,
+    stdio: "inherit"
+  });
+  if (installResult.status !== 0) {
+    throw new Error(`${pm} install failed.`);
+  }
+}
+function ensureEnvFile() {
+  const envPath = path.join(projectRoot, ".env");
+  const examplePath = path.join(projectRoot, ".env.example");
+  if (!existsSync(envPath) && existsSync(examplePath)) {
+    copyFileSync(examplePath, envPath);
+    console.log("Created .env from .env.example. Remember to fill in your credentials.");
+  }
+}
+function runServer(pm, transport2) {
+  if (!["stdio", "sse"].includes(transport2)) {
+    throw new Error(`Unsupported transport "${transport2}". Use stdio or sse.`);
+  }
+  const script = transport2 === "stdio" ? "dev:stdio" : "dev:sse";
+  console.log(`Starting ${transport2} transport via ${pm} run ${script}...`);
+  const runner = ["run", script];
+  const child = spawnSync(pm, runner, {
+    cwd: projectRoot,
+    stdio: "inherit",
+    env: { ...process.env }
+  });
+  if (child.status !== 0) {
+    throw new Error(`${pm} run ${script} exited with code ${child.status}`);
+  }
+}
+//# sourceMappingURL=up.js.map

package/dist/cli/up.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/up.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { spawnSync } from 'node:child_process';\nimport { copyFileSync, existsSync } from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst dirname = path.dirname(fileURLToPath(import.meta.url));\nconst projectRoot = path.resolve(dirname, '../..');\n\nconst args = process.argv.slice(2);\nconst command = args[0];\n\nif (!command || command === '--help' || command === '-h') {\n  printHelp();\n  process.exit(0);\n}\n\nif (command !== 'up') {\n  console.error(`Unknown command: ${command}`);\n  printHelp();\n  process.exit(1);\n}\n\nconst flags = parseFlags(args.slice(1));\nconst transport = (flags.transport ?? 'stdio').toLowerCase();\nconst installOnly = Boolean(flags['install-only']);\n\ntry {\n  ensureNodeVersion();\n  const packageManager = detectPackageManager();\n  installDependencies(packageManager);\n  ensureEnvFile();\n\n  if (installOnly) {\n    console.log('Dependencies installed. Skipping server launch (--install-only set).');\n    process.exit(0);\n  }\n\n  runServer(packageManager, transport);\n} catch (error) {\n  console.error(error instanceof Error ? error.message : error);\n  process.exit(1);\n}\n\nfunction printHelp() {\n  console.log(`Usage: npx @hol-org/hashnet-mcp up [options]\\n\\nOptions:\\n  --transport <stdio|sse>  Choose the transport to start (default: stdio)\\n  --install-only          Install deps and sync .env, then exit\\n  -h, --help              Show this help message`);\n}\n\nfunction parseFlags(values: string[]) {\n  const cloned = [...values];\n  return cloned.reduce<Record<string, any>>((acc, entry, index) => {\n    if (entry.startsWith('--')) {\n      const [key, inlineValue] = entry.split('=');\n      const normalized = key.replace(/^--/, '');\n      if (inlineValue !== undefined) {\n        acc[normalized] = inlineValue;\n      } else {\n        const next = cloned[index + 1];\n        if (next && !next.startsWith('--')) {\n          acc[normalized] = next;\n          cloned.splice(index + 1, 1);\n        } else {\n          acc[normalized] = true;\n        }\n      }\n    }\n    return acc;\n  }, {});\n}\n\nfunction ensureNodeVersion() {\n  const major = Number(process.versions.node.split('.')[0]);\n  if (Number.isNaN(major) || major < 18) {\n    throw new Error(`Node.js 18+ is required (detected ${process.versions.node}).`);\n  }\n}\n\nfunction detectPackageManager(): 'pnpm' | 'npm' {\n  if (commandExists('pnpm')) {\n    return 'pnpm';\n  }\n\n  console.warn('pnpm not detected. Attempting to enable via corepack...');\n  const enabled = spawnSync('corepack', ['enable', 'pnpm'], { stdio: 'inherit' });\n  if (enabled.status === 0 && commandExists('pnpm')) {\n    return 'pnpm';\n  }\n\n  console.warn('Falling back to npm. Install pnpm globally for faster installs.');\n  return 'npm';\n}\n\nfunction commandExists(bin: string) {\n  try {\n    const result = spawnSync(bin, ['--version'], { stdio: 'ignore' });\n    return result.status === 0;\n  } catch {\n    return false;\n  }\n}\n\nfunction installDependencies(pm: 'pnpm' | 'npm') {\n  console.log(`Installing dependencies with ${pm}...`);\n  const installResult = spawnSync(pm, ['install'], {\n    cwd: projectRoot,\n    stdio: 'inherit',\n  });\n  if (installResult.status !== 0) {\n    throw new Error(`${pm} install failed.`);\n  }\n}\n\nfunction ensureEnvFile() {\n  const envPath = path.join(projectRoot, '.env');\n  const examplePath = path.join(projectRoot, '.env.example');\n  if (!existsSync(envPath) && existsSync(examplePath)) {\n    copyFileSync(examplePath, envPath);\n    console.log('Created .env from .env.example. Remember to fill in your credentials.');\n  }\n}\n\nfunction runServer(pm: 'pnpm' | 'npm', transport: string) {\n  if (!['stdio', 'sse'].includes(transport)) {\n    throw new Error(`Unsupported transport \"${transport}\". Use stdio or sse.`);\n  }\n  const script = transport === 'stdio' ? 'dev:stdio' : 'dev:sse';\n  console.log(`Starting ${transport} transport via ${pm} run ${script}...`);\n  const runner = ['run', script];\n  const child = spawnSync(pm, runner, {\n    cwd: projectRoot,\n    stdio: 'inherit',\n    env: { ...process.env },\n  });\n  if (child.status !== 0) {\n    throw new Error(`${pm} run ${script} exited with code ${child.status}`);\n  }\n}\n"],"mappings":"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","names":["transport"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }