@bsbofmusic/evomap-mcp-lite 0.1.1 → 0.3.0

package/index.js

@@ -13,9 +13,15 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 ========================= */
 const API = process.env.EVOMAP_API_BASE || "https://evomap.ai";
 const TIMEOUT_MS = Number(process.env.EVOMAP_TIMEOUT || "30") * 1000;
-const MAX_RETURN_CHARS = 8000;
 
-// node_id storage
+// retry settings (stability)
+const RETRY_MAX = Number(process.env.EVOMAP_RETRY_MAX || "3"); // 0..5 recommended
+const RETRY_BASE_DELAY_MS = Number(process.env.EVOMAP_RETRY_BASE_DELAY_MS || "250");
+
+// output clipping (token control)
+const MAX_RETURN_CHARS = Number(process.env.EVOMAP_MAX_RETURN_CHARS || "8000");
+
+// node identity persistence
 const DEFAULT_NODE_FILE = path.join(os.homedir(), ".evomap-mcp", "node.json");
 const NODE_FILE = process.env.EVOMAP_NODE_FILE || DEFAULT_NODE_FILE;
 
@@ -23,6 +29,18 @@ const NODE_FILE = process.env.EVOMAP_NODE_FILE || DEFAULT_NODE_FILE;
 const HEARTBEAT_MIN_INTERVAL_MS = 10 * 60 * 1000; // 10 minutes
 let lastHeartbeatAt = 0;
 
+/* =========================
+   STATE (binding)
+========================= */
+const state = {
+  sender_id: null,
+  bound: null, // true/false/unknown
+  claim_code: null,
+  claim_url: null,
+  lastHelloAt: null,
+  lastHelloRaw: null
+};
+
 /* =========================
    UTILS
 ========================= */
@@ -46,12 +64,10 @@ function ensureDirForFile(filePath) {
 }
 
 function loadOrCreateNodeId() {
-  // 1) explicit env wins
   if (process.env.EVOMAP_NODE_ID && process.env.EVOMAP_NODE_ID.trim()) {
     return { sender_id: process.env.EVOMAP_NODE_ID.trim(), source: "env" };
   }
 
-  // 2) file storage
   try {
     if (fs.existsSync(NODE_FILE)) {
       const raw = fs.readFileSync(NODE_FILE, "utf8");
@@ -59,31 +75,19 @@ function loadOrCreateNodeId() {
       if (obj?.sender_id) return { sender_id: String(obj.sender_id), source: "file" };
     }
   } catch {
-    // ignore read/parse errors; we'll recreate
+    // ignore
   }
 
-  // 3) create new
   const sender_id = `node_${crypto.randomBytes(10).toString("hex")}`;
   try {
     ensureDirForFile(NODE_FILE);
     fs.writeFileSync(NODE_FILE, JSON.stringify({ sender_id, created_at: nowIso() }, null, 2), "utf8");
   } catch {
-    // ignore write errors; still usable for this session
+    // ignore
   }
   return { sender_id, source: "generated" };
 }
 
-async function http(method, url, data) {
-  const res = await axios({
-    method,
-    url,
-    data,
-    timeout: TIMEOUT_MS,
-    headers: { "content-type": "application/json" }
-  });
-  return res.data;
-}
-
 function makeEnvelope({ message_type, sender_id, payload }) {
   return {
     protocol: "gep-a2a",
@@ -96,70 +100,110 @@ function makeEnvelope({ message_type, sender_id, payload }) {
   };
 }
 
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+function isRetryable(err) {
+  const status = err?.response?.status;
+  if (!status) return true;
+  if (status === 429) return true;
+  if (status >= 500) return true;
+  return false;
+}
+
+async function http(method, url, data) {
+  return axios({
+    method,
+    url,
+    data,
+    timeout: TIMEOUT_MS,
+    headers: { "content-type": "application/json" }
+  }).then((r) => r.data);
+}
+
 async function safeCall(method, url, data) {
-  try {
-    return await http(method, url, data);
-  } catch (err) {
-    if (err?.response) {
-      return { error: true, status: err.response.status, data: err.response.data };
+  let attempt = 0;
+  while (true) {
+    try {
+      const out = await http(method, url, data);
+      return out;
+    } catch (err) {
+      attempt += 1;
+
+      const wrapped = err?.response
+        ? { error: true, status: err.response.status, data: err.response.data }
+        : { error: true, message: err?.message || String(err) };
+
+      if (attempt > RETRY_MAX || !isRetryable(err)) return wrapped;
+
+      const delay = RETRY_BASE_DELAY_MS * Math.pow(2, attempt - 1);
+      await sleep(delay);
     }
-    return { error: true, message: err?.message || String(err) };
   }
 }
 
-async function ensureHeartbeat(sender_id) {
+function bindingNoticeIfNeeded() {
+  if (state.bound === false && state.claim_url) {
+    return `⚠️ EvoMap 账号未绑定。请用 claim 链接绑定后再长期使用：${state.claim_url}（claim_code: ${state.claim_code || "N/A"}）`;
+  }
+  return null;
+}
+
+/* =========================
+   HELLO + HEARTBEAT
+========================= */
+async function ensureHeartbeat() {
   const now = Date.now();
   if (now - lastHeartbeatAt < HEARTBEAT_MIN_INTERVAL_MS) return;
 
-  // Heartbeat endpoint in skill 是 REST（不是 envelope）。如果未来强制 envelope，我们再改也很容易。
-  const payload = { node_id: sender_id, timestamp: nowIso() };
+  const payload = { node_id: state.sender_id, timestamp: nowIso() };
   const data = await safeCall("post", `${API}/a2a/heartbeat`, payload);
   lastHeartbeatAt = now;
 
-  // 不要把 heartbeat 打到 stdout（会干扰 MCP），仅 stderr
-  if (data?.error) {
-    console.error("[evomap-lite] heartbeat failed:", data);
-  }
+  if (data?.error) console.error("[evomap-lite] heartbeat failed:", data);
 }
 
-async function tryHello(sender_id) {
-  // hello 是 A2A envelope
+async function helloAndUpdateBinding() {
   const env = makeEnvelope({
     message_type: "hello",
-    sender_id,
+    sender_id: state.sender_id,
     payload: {
-      capabilities: ["mcp", "bugfix", "asset_reuse"],
+      capabilities: ["mcp", "bugfix", "asset_reuse", "validate"],
       gene_count: 0,
       capsule_count: 0,
-      env_fingerprint: {
-        platform: process.platform,
-        node: process.version
-      }
+      env_fingerprint: { platform: process.platform, arch: process.arch, node: process.version }
     }
   });
 
   const data = await safeCall("post", `${API}/a2a/hello`, env);
+  state.lastHelloAt = nowIso();
+  state.lastHelloRaw = data;
 
   if (data?.error) {
-    console.error("[evomap-lite] hello failed (will continue anyway):", data);
+    console.error("[evomap-lite] hello failed (continuing):", data);
+    state.bound = null;
     return;
   }
 
-  // 如果服务端回传 canonical node_id，就写回文件（提高兼容性）
+  const claim_code = data?.claim_code || data?.payload?.claim_code || data?.data?.claim_code;
+  const claim_url = data?.claim_url || data?.payload?.claim_url || data?.data?.claim_url;
+
+  state.claim_code = claim_code || null;
+  state.claim_url = claim_url || null;
+  state.bound = claim_url ? false : true;
+
   const maybeNodeId =
+    data?.your_node_id ||
     data?.node_id ||
-    data?.payload?.node_id ||
-    data?.data?.node_id ||
-    data?.result?.node_id;
+    data?.payload?.your_node_id ||
+    data?.payload?.node_id;
 
   if (maybeNodeId && typeof maybeNodeId === "string" && !process.env.EVOMAP_NODE_ID) {
     try {
       ensureDirForFile(NODE_FILE);
-      fs.writeFileSync(
-        NODE_FILE,
-        JSON.stringify({ sender_id: maybeNodeId, updated_at: nowIso() }, null, 2),
-        "utf8"
-      );
+      fs.writeFileSync(NODE_FILE, JSON.stringify({ sender_id: maybeNodeId, updated_at: nowIso() }, null, 2), "utf8");
+      state.sender_id = maybeNodeId;
       console.error("[evomap-lite] node_id updated from hello response:", maybeNodeId);
     } catch {
       // ignore
@@ -171,64 +215,127 @@ async function tryHello(sender_id) {
    MCP SERVER
 ========================= */
 const { sender_id } = loadOrCreateNodeId();
+state.sender_id = sender_id;
 
 const server = new McpServer({
   name: "evomap-lite",
-  version: "0.1.1"
+  version: "0.3.0"
 });
 
-/* TOOL 1: evomap_fetch (A2A envelope) */
+/* TOOL: account status (NEW) */
+server.tool(
+  "evomap_account_status",
+  {
+    type: "object",
+    properties: {},
+    required: []
+  },
+  async () => {
+    if (state.bound === null) await helloAndUpdateBinding();
+
+    const notice = bindingNoticeIfNeeded();
+    const out = {
+      sender_id: state.sender_id,
+      bound: state.bound,
+      claim_code: state.claim_code,
+      claim_url: state.claim_url,
+      last_hello_at: state.lastHelloAt
+    };
+
+    return {
+      content: [
+        ...(notice ? [{ type: "text", text: notice }] : []),
+        { type: "text", text: clipJson(out) }
+      ]
+    };
+  }
+);
+
+/* TOOL 1: fetch (A2A envelope) */
 server.tool(
   "evomap_fetch",
   {
-    signals: { type: "array", items: { type: "string" }, description: "keywords array" },
-    context: { type: "string", description: "short error stack or description" },
-    limit: { type: "number", optional: true, description: "default 5, max 10" }
+    type: "object",
+    properties: {
+      signals: { type: "array", items: { type: "string" }, description: "keywords array" },
+      context: { type: "string", description: "short bug context", default: "" },
+      limit: { type: "number", description: "default 5, max 10", default: 5 }
+    },
+    required: ["signals"]
   },
   async ({ signals, context, limit }) => {
-    await ensureHeartbeat(sender_id);
+    await ensureHeartbeat();
 
     const env = makeEnvelope({
       message_type: "fetch",
-      sender_id,
+      sender_id: state.sender_id,
       payload: {
         signals,
-        context,
+        context: context || "",
         limit: Math.min(Number(limit || 5), 10)
       }
     });
 
     const data = await safeCall("post", `${API}/a2a/fetch`, env);
-    return { content: [{ type: "text", text: clipJson(data) }] };
+
+    const notice = bindingNoticeIfNeeded();
+    return {
+      content: [
+        ...(notice ? [{ type: "text", text: notice }] : []),
+        { type: "text", text: clipJson(data) }
+      ]
+    };
   }
 );
 
-/* TOOL 2: evomap_asset (REST) */
+/* TOOL 2: asset detail (REST) */
 server.tool(
   "evomap_asset",
   {
-    asset_id: { type: "string", description: "asset id" },
-    detail_level: { type: "string", optional: true, description: "brief|full (default brief)" }
+    type: "object",
+    properties: {
+      asset_id: { type: "string", description: "asset id" },
+      detail_level: { type: "string", enum: ["brief", "full"], default: "brief" }
+    },
+    required: ["asset_id"]
   },
   async ({ asset_id, detail_level }) => {
-    const detailed = (detail_level || "brief") === "full" ? "true" : "false";
+    const detailed = detail_level === "full" ? "true" : "false";
     const data = await safeCall(
       "get",
       `${API}/a2a/assets/${encodeURIComponent(asset_id)}?detailed=${detailed}`
     );
-    return { content: [{ type: "text", text: clipJson(data) }] };
+
+    const notice = bindingNoticeIfNeeded();
+    return {
+      content: [
+        ...(notice ? [{ type: "text", text: notice }] : []),
+        { type: "text", text: clipJson(data) }
+      ]
+    };
   }
 );
 
-/* TOOL 3: evomap_validate_bundle (REST) */
+/* TOOL 3: validate bundle (REST) */
 server.tool(
   "evomap_validate_bundle",
   {
-    bundle: { type: "object", description: "gene+capsule bundle; keep small" }
+    type: "object",
+    properties: {
+      bundle: { type: "object", description: "gene + capsule + evolution_event bundle object" }
+    },
+    required: ["bundle"]
   },
   async ({ bundle }) => {
     const data = await safeCall("post", `${API}/a2a/validate`, bundle);
-    return { content: [{ type: "text", text: clipJson(data) }] };
+
+    const notice = bindingNoticeIfNeeded();
+    return {
+      content: [
+        ...(notice ? [{ type: "text", text: notice }] : []),
+        { type: "text", text: clipJson(data) }
+      ]
+    };
   }
 );
 
@@ -236,5 +343,8 @@ server.tool(
 const transport = new StdioServerTransport();
 await server.connect(transport);
 
-// hello 放在 connect 之后执行也行（不会影响 MCP 协议输出）
-await tryHello(sender_id);
+// hello after connect
+await helloAndUpdateBinding();
+if (state.bound === false && state.claim_url) {
+  console.error("[evomap-lite] account not bound; claim_url:", state.claim_url);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bsbofmusic/evomap-mcp-lite",
-  "version": "0.1.1",
-  "description": "Lite MCP server for EvoMap asset reuse (bugfix oriented)",
+  "version": "0.3.0",
+  "description": "EvoMap MCP Lite (Plus) - compliant A2A + stable connectivity + binding check",
   "type": "module",
   "bin": {
     "evomap-mcp-lite": "./index.js"

package/evomap-mcp-pro/node_modules/.bin/node-which

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../which/bin/node-which" "$@"
-else 
-  exec node  "$basedir/../which/bin/node-which" "$@"
-fi

package/evomap-mcp-pro/node_modules/.bin/node-which.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\which\bin\node-which" %*

package/evomap-mcp-pro/node_modules/.bin/node-which.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../which/bin/node-which" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../which/bin/node-which" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../which/bin/node-which" $args
-  } else {
-    & "node$exe"  "$basedir/../which/bin/node-which" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret