@hol-org/hashnet-mcp 1.0.20 → 1.0.21

package/package.json

@@ -1,32 +1,27 @@
 {
   "name": "@hol-org/hashnet-mcp",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "description": "HOL MCP server for agentic search, discovery, registration, chat, and more with the Hashgraph Online Registry Broker.",
   "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "types": "./dist/index.d.cts",
+      "import": "./dist/index.cjs",
+      "default": "./dist/index.cjs"
     },
     "./cli/up": {
-      "import": "./dist/cli/up.js",
-      "default": "./dist/cli/up.js"
+      "import": "./dist/cli/up.cjs",
+      "default": "./dist/cli/up.cjs"
     }
   },
   "bin": {
-    "hashnet-mcp": "./dist/cli/up.js"
+    "hashnet-mcp": "./dist/cli/up.cjs"
   },
   "files": [
-    "dist",
-    "deploy",
-    "examples",
-    "README.md",
-    "AGENTS.md",
-    "todo.md"
+    "dist"
   ],
   "scripts": {
     "dev:stdio": "MCP_TRANSPORT=stdio tsx src/index.ts",
@@ -80,29 +75,33 @@
   },
   "packageManager": "pnpm@10.10.0",
   "devDependencies": {
-    "@types/node": "^24.10.0",
-    "@vitest/coverage-v8": "^2.1.4",
-    "tsup": "^8.5.0",
-    "tsx": "^4.20.6",
-    "typescript": "^5.9.3",
-    "vitest": "^2.1.4"
-  },
-  "dependencies": {
     "@hashgraphonline/standards-sdk": "^0.1.139",
     "@hono/node-server": "^1.19.6",
     "@modelcontextprotocol/sdk": "^1.21.1",
+    "@types/node": "^24.10.0",
+    "@vitest/coverage-v8": "^2.1.4",
     "bottleneck": "^2.19.5",
     "dotenv": "^17.2.3",
     "fastmcp": "^3.22.0",
     "hono": "^4.10.5",
     "ioredis": "^5.8.2",
     "pino": "^10.1.0",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
     "undici": "^7.16.0",
+    "vitest": "^2.1.4",
     "zod": "^4.1.12"
   },
-  "optionalDependencies": {
+  "dependencies": {},
+  "peerDependencies": {
     "better-sqlite3": "^11.5.0"
   },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    }
+  },
   "overrides": {
     "@hashgraphonline/standards-sdk": "^0.1.139"
   }

package/AGENTS.md

@@ -1,163 +0,0 @@
-# Repository Guidelines
-
-# **ABSOLUTE PROHIBITION — NO FILE DELETIONS OR GIT REVERTS.** Never delete files, directories, or history. Never run `git revert`, `git reset`, `git checkout`, `git restore`, or any command that removes tracked work. Violations immediately fail the task and forfeit all points.
-
-# AGENTS.md — Tool Selection (TypeScript)
-
-- Find files by file name: `fd`
-- Find files with path name: `fd -p <file-path>`
-- List files in a directory: `fd . <directory>`
-- Find files with extension and pattern: `fd -e <extension> <pattern>`
-- Find text: `rg`
-- Structured code search and codemods: `ast-grep`
-  - Default languages:
-    - `.ts` → `ast-grep --lang ts -p '<pattern>'`
-    - `.tsx` → `ast-grep --lang tsx -p '<pattern>'`
-  - Common languages:
-    - Python → `ast-grep --lang python -p '<pattern>'`
-    - TypeScript → `ast-grep --lang ts -p '<pattern>'`
-    - TSX (React) → `ast-grep --lang tsx -p '<pattern>'`
-    - JavaScript → `ast-grep --lang js -p '<pattern>'`
-    - Rust → `ast-grep --lang rust -p '<pattern>'`
-    - Bash → `ast-grep --lang bash -p '<pattern>'`
-    - JSON → `ast-grep --lang json -p '<pattern>'`
-  - Select among matches: pipe to `fzf`
-  - JSON: `jq`
-  - YAML/XML: `yq`
-
-If `ast-grep` is available, avoid `rg` or `grep` unless a plain-text search is explicitly requested.
-
-## 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.
-
-### Memory (optional)
-- Set `MEMORY_ENABLED=1` to enable local memory capture (SQLite by default; see `.env.example` for limits and store selection). When enabled, workflows like `workflow.chatSmoke`, `workflow.openrouterChat`, `workflow.historyTopUp`, `workflow.registryBrokerShowcase`, and `workflow.fullRegistration` will load scoped context (uaid/session/namespace) and append discovery/chat traces. Pass `disableMemory: true` in workflow inputs to opt out even when memory is enabled.
-
-### 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/deploy/Dockerfile

@@ -1,24 +0,0 @@
-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

@@ -1,31 +0,0 @@
-# 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

@@ -1,41 +0,0 @@
-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

@@ -1,175 +0,0 @@
-#!/usr/bin/env node
-
-// src/cli/up.ts
-import { spawnSync } from "child_process";
-import { copyFileSync, existsSync, writeFileSync } 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"]);
-var preferStderr = transport === "stdio";
-var logInfo = (...messages) => preferStderr ? console.error(...messages) : console.log(...messages);
-var logWarn = (...messages) => preferStderr ? console.error(...messages) : console.warn(...messages);
-try {
-  ensureNodeVersion();
-  const packageManager = detectPackageManager(preferStderr);
-  ensurePnpmConfig();
-  installDependencies(packageManager, preferStderr);
-  ensureEnvFile();
-  if (installOnly) {
-    logInfo("Dependencies installed. Skipping server launch (--install-only set).");
-    process.exit(0);
-  }
-  runServer(packageManager, transport, preferStderr);
-} 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(preferStderr2) {
-  if (commandExists("pnpm")) {
-    return "pnpm";
-  }
-  logWarn("pnpm not detected. Attempting to enable via corepack...");
-  const enabled = spawnSync("corepack", ["enable", "pnpm"], {
-    stdio: preferStderr2 ? ["ignore", "pipe", "inherit"] : "inherit"
-  });
-  if (preferStderr2 && enabled.stdout?.length) {
-    process.stderr.write(enabled.stdout);
-  }
-  if (enabled.status === 0 && commandExists("pnpm")) {
-    return "pnpm";
-  }
-  logWarn("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, preferStderr2) {
-  logInfo(`Installing dependencies with ${pm}...`);
-  const baseEnv = {
-    ...process.env,
-    NODE_OPTIONS: process.env.NODE_OPTIONS ?? "--max-old-space-size=8192"
-  };
-  const npmArgs = ["install", "--legacy-peer-deps"];
-  const installResult = spawnSync(pm, pm === "pnpm" ? ["install"] : npmArgs, {
-    cwd: projectRoot,
-    stdio: preferStderr2 ? ["ignore", "pipe", "inherit"] : "inherit",
-    env: baseEnv
-  });
-  if (preferStderr2 && installResult.stdout?.length) {
-    process.stderr.write(installResult.stdout);
-  }
-  if (installResult.status !== 0) {
-    throw new Error(`${pm} install failed.`);
-  }
-}
-function ensurePnpmConfig() {
-  const npmrcPath = path.join(projectRoot, ".npmrc");
-  if (existsSync(npmrcPath)) {
-    return;
-  }
-  const content = [
-    "node-linker=isolated",
-    "shamefully-hoist=false",
-    "strict-peer-dependencies=false",
-    "auto-install-peers=false",
-    "resolution-mode=lowest-direct",
-    "node-options=--max-old-space-size=8192",
-    "child-concurrency=4"
-  ].join("\n");
-  writeFileSync(npmrcPath, content);
-}
-function ensureEnvFile() {
-  const envPath = path.join(projectRoot, ".env");
-  const examplePath = path.join(projectRoot, ".env.example");
-  if (!existsSync(envPath) && existsSync(examplePath)) {
-    copyFileSync(examplePath, envPath);
-    logInfo("Created .env from .env.example. Remember to fill in your credentials.");
-  }
-}
-function runServer(pm, transport2, preferStderr2) {
-  if (!["stdio", "sse"].includes(transport2)) {
-    throw new Error(`Unsupported transport "${transport2}". Use stdio or sse.`);
-  }
-  const distEntry = path.join(projectRoot, "dist", "index.js");
-  const env = { ...process.env, MCP_TRANSPORT: transport2 };
-  if (!existsSync(distEntry)) {
-    logInfo("dist/index.js not found. Building project before start...");
-    const buildResult = spawnSync(pm, ["run", "build"], {
-      cwd: projectRoot,
-      stdio: preferStderr2 ? ["ignore", "pipe", "inherit"] : "inherit",
-      env
-    });
-    if (preferStderr2 && buildResult.stdout?.length) {
-      process.stderr.write(buildResult.stdout);
-    }
-    if (buildResult.status !== 0) {
-      throw new Error(`${pm} run build exited with code ${buildResult.status}`);
-    }
-  }
-  logInfo(`Starting ${transport2} transport via ${pm} run start...`);
-  const child = spawnSync(pm, ["run", "start"], {
-    cwd: projectRoot,
-    stdio: "inherit",
-    env
-  });
-  if (child.status !== 0) {
-    throw new Error(`${pm} run start exited with code ${child.status}`);
-  }
-}
-//# sourceMappingURL=up.js.map

package/dist/cli/up.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/cli/up.ts"],"sourcesContent":["import { spawnSync } from 'node:child_process';\nimport { copyFileSync, existsSync, writeFileSync } 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']);\nconst preferStderr = transport === 'stdio';\nconst logInfo = (...messages: any[]) => (preferStderr ? console.error(...messages) : console.log(...messages));\nconst logWarn = (...messages: any[]) => (preferStderr ? console.error(...messages) : console.warn(...messages));\n\ntry {\n  ensureNodeVersion();\n  const packageManager = detectPackageManager(preferStderr);\n  ensurePnpmConfig();\n  installDependencies(packageManager, preferStderr);\n  ensureEnvFile();\n\n  if (installOnly) {\n    logInfo('Dependencies installed. Skipping server launch (--install-only set).');\n    process.exit(0);\n  }\n\n  runServer(packageManager, transport, preferStderr);\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(preferStderr: boolean): 'pnpm' | 'npm' {\n  if (commandExists('pnpm')) {\n    return 'pnpm';\n  }\n\n  logWarn('pnpm not detected. Attempting to enable via corepack...');\n  const enabled = spawnSync('corepack', ['enable', 'pnpm'], {\n    stdio: preferStderr ? ['ignore', 'pipe', 'inherit'] : 'inherit',\n  });\n  if (preferStderr && enabled.stdout?.length) {\n    process.stderr.write(enabled.stdout);\n  }\n  if (enabled.status === 0 && commandExists('pnpm')) {\n    return 'pnpm';\n  }\n\n  logWarn('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', preferStderr: boolean) {\n  logInfo(`Installing dependencies with ${pm}...`);\n  const baseEnv = {\n    ...process.env,\n    NODE_OPTIONS: process.env.NODE_OPTIONS ?? '--max-old-space-size=8192',\n  };\n\n  const npmArgs = ['install', '--legacy-peer-deps'];\n\n  const installResult = spawnSync(pm, pm === 'pnpm' ? ['install'] : npmArgs, {\n    cwd: projectRoot,\n    stdio: preferStderr ? ['ignore', 'pipe', 'inherit'] : 'inherit',\n    env: baseEnv,\n  });\n  if (preferStderr && installResult.stdout?.length) {\n    process.stderr.write(installResult.stdout);\n  }\n  if (installResult.status !== 0) {\n    throw new Error(`${pm} install failed.`);\n  }\n}\n\nfunction ensurePnpmConfig() {\n  const npmrcPath = path.join(projectRoot, '.npmrc');\n  if (existsSync(npmrcPath)) {\n    return;\n  }\n\n  const content = [\n    'node-linker=isolated',\n    'shamefully-hoist=false',\n    'strict-peer-dependencies=false',\n    'auto-install-peers=false',\n    'resolution-mode=lowest-direct',\n    'node-options=--max-old-space-size=8192',\n    'child-concurrency=4',\n  ].join('\\n');\n\n  writeFileSync(npmrcPath, content);\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    logInfo('Created .env from .env.example. Remember to fill in your credentials.');\n  }\n}\n\nfunction runServer(pm: 'pnpm' | 'npm', transport: string, preferStderr: boolean) {\n  if (!['stdio', 'sse'].includes(transport)) {\n    throw new Error(`Unsupported transport \"${transport}\". Use stdio or sse.`);\n  }\n  const distEntry = path.join(projectRoot, 'dist', 'index.js');\n  const env = { ...process.env, MCP_TRANSPORT: transport };\n\n  if (!existsSync(distEntry)) {\n    logInfo('dist/index.js not found. Building project before start...');\n    const buildResult = spawnSync(pm, ['run', 'build'], {\n      cwd: projectRoot,\n      stdio: preferStderr ? ['ignore', 'pipe', 'inherit'] : 'inherit',\n      env,\n    });\n    if (preferStderr && buildResult.stdout?.length) {\n      process.stderr.write(buildResult.stdout);\n    }\n    if (buildResult.status !== 0) {\n      throw new Error(`${pm} run build exited with code ${buildResult.status}`);\n    }\n  }\n\n  logInfo(`Starting ${transport} transport via ${pm} run start...`);\n  const child = spawnSync(pm, ['run', 'start'], {\n    cwd: projectRoot,\n    stdio: 'inherit',\n    env,\n  });\n  if (child.status !== 0) {\n    throw new Error(`${pm} run start exited with code ${child.status}`);\n  }\n}\n"],"mappings":"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","names":["preferStderr","transport"]}