@taptap/instant-games-open-mcp 1.24.13 → 1.24.14

package/README.md

@@ -265,9 +265,10 @@ Maker MCP 初始化时会通过标准 `initialize.instructions` 向 AI 客户端
 检查实现”不应自动触发 Maker 远端构建，除非用户明确要求构建、运行或预览 Maker 游戏。
 普通构建会先 push 到 Maker 远端再触发远端 build：本地有改动时提交改动，已有未推送 commit 时
 直接 push，本地干净且没有未推送 commit 时创建 `chore: wake maker build server` 空提交来唤醒远端
-服务。push 失败时不会继续 build，会返回本地 commit、ahead 状态、stderr/stdout 和下一步建议，
-交给本地 Agent/skill 处理 pull、rebase 或冲突；push 成功但 build 失败时，会明确说明代码已到
-Maker 远端但构建失败。只有用户明确说“不提交，只构建云端版本”时，才传
+服务。提交前如果本地仅落后于 Maker 远端，会自动执行 fast-forward 后继续提交；如果远端更新会
+覆盖本地未提交修改，则会在创建 commit 前停止并保留本地文件。分叉、非 `main`、鉴权或网络失败仍
+按原有提示处理。push 成功但 build 失败时，会明确说明代码已到 Maker 远端但构建失败。只有用户明确
+说“不提交，只构建云端版本”时，才传
 `confirm_remote_build_without_submit=true`；该模式只构建 Maker 远端已提交版本，不会自动打开
 Maker 页面。
 
@@ -579,6 +580,10 @@ maker_build_current_directory
 远端 proxy tools 使用版本化的本地完整定义在首次 `tools/list` 时立即注册，不等待 cwd、Maker 项目绑定、
 PAT/TapTap token 或远端 proxy 连接。项目定位和鉴权只在实际调用 tool 时校验；远端 schema 不会在运行时
 替换本地定义。schema 变更通过本地 MCP 版本更新发布，远端不可用不会让 proxy tools 从当前会话消失。
+唯一例外是 Maker Server 明确返回 `BLACKLISTED` 的账号：MCP 每个进程启动时只检查一次账号状态，
+`tools/list` 只保留 `maker_status_lite`，任何 tool call 和 `maker://status` 都直接返回限制提示，不进入
+本地构建或远端 proxy。PAT 缺失、过期、网络超时和其它非黑名单错误不会隐藏工具；账号状态变化需要
+重连或重启 MCP 后生效。
 Maker 内嵌代理不打开可选的 standalone SSE GET，远端 RPC 响应和构建进度统一通过 POST SSE 返回；
 这避免 Node.js 26 中长连接占用后续 `tools/list` 请求而触发固定 60 秒超时。普通 MCP Proxy 默认仍保留
 standalone SSE，只有显式设置 `disable_standalone_sse` 才会关闭。
@@ -751,7 +756,8 @@ graph LR
 
 - **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** - 架构文档
 - **[docs/DEPLOYMENT.md](docs/DEPLOYMENT.md)** - 部署指南（本地、Docker、开发者测试）
-- **[docs/PROXY.md](docs/PROXY.md)** - MCP Proxy 开发指南（面向 TapCode 等平台）
+- **[docs/PROXY.md](docs/PROXY.md)** - MCP Proxy 开发指南（面向 TapCode 等平台）。
+  通用 Proxy 默认不添加 `local` 来源标记；本地 Maker 嵌入入口显式启用，服务端无需修改配置。
 - **[docs/PATH_RESOLUTION.md](docs/PATH_RESOLUTION.md)** - 路径解析系统
 
 ## Maker 持久化 Proxy 与多项目

package/dist/proxy.js

@@ -29151,7 +29151,7 @@ var LogWriter = class {
 };
 
 // src/mcp-proxy/config.ts
-var DEFAULT_TOOL_CALL_TIMEOUT_MS = 60 * 60 * 1e3;
+var DEFAULT_TOOL_CALL_TIMEOUT_MS = 5 * 60 * 1e3;
 function readStdin() {
   return new Promise((resolve, reject) => {
     const chunks = [];
@@ -29306,8 +29306,7 @@ function applyDefaults(config2) {
 }
 
 // src/mcp-proxy/proxy.ts
-var VERSION = true ? "1.24.13" : "dev";
-var LOCAL_PROXY_TAG = "local";
+var VERSION = true ? "1.24.14" : "dev";
 var DEFAULT_RECONNECT_INTERVAL_MS = 5e3;
 var MAX_RECONNECT_INTERVAL_MS = 60 * 1e3;
 function createNonReplayableToolResult(name, executionState) {
@@ -29369,20 +29368,23 @@ function isHttpClientError(error2) {
   return numericCode !== void 0 && numericCode >= 400 && numericCode < 500 || /\bHTTP\s+4\d\d\b/i.test(error2.message);
 }
 var TapTapMCPProxy = class {
-  constructor(config2) {
+  constructor(config2, runtimeOptions = {}) {
     this.connected = false;
     this.reconnecting = false;
     this.reconnectTimer = null;
     this.healthCheckTimer = null;
     this.pendingRequests = [];
-    this.reconnectDelayMs = DEFAULT_RECONNECT_INTERVAL_MS;
     // 会话验证相关
     this.sessionValidated = false;
     this.lastValidationTime = 0;
     this.SESSION_VALIDATION_INTERVAL = 3e4;
-    var _a3;
+    var _a3, _b;
     this.config = config2;
-    this.cookieJar = new CookieJar(((_a3 = config2.options) == null ? void 0 : _a3.verbose) ?? false);
+    this.sourceTag = runtimeOptions.sourceTag;
+    this.remoteErrorMode = runtimeOptions.remoteErrorMode ?? "passthrough";
+    this.recoveryMode = runtimeOptions.recoveryMode ?? "compatible";
+    this.reconnectDelayMs = ((_a3 = config2.options) == null ? void 0 : _a3.reconnect_interval) ?? DEFAULT_RECONNECT_INTERVAL_MS;
+    this.cookieJar = new CookieJar(((_b = config2.options) == null ? void 0 : _b.verbose) ?? false);
     this.logWriter = this.createLogWriter();
     this.client = this.createClient();
     this.server = new Server(
@@ -29480,11 +29482,13 @@ var TapTapMCPProxy = class {
    * - X-TapTap-Project-Path: 项目路径
    * - X-TapTap-Mac-Token: MAC 认证令牌（JSON）
    * - X-TapTap-Custom-Fields: 业务自定义字段（JSON）
-   * - X-TapTap-Tag: 调用来源标记，固定为 "local"
+   * - X-TapTap-Tag: 调用来源标记，仅在嵌入入口显式启用时发送
    */
   buildSessionHeaders() {
     const headers = {};
-    headers["X-TapTap-Tag"] = LOCAL_PROXY_TAG;
+    if (this.sourceTag !== void 0) {
+      headers["X-TapTap-Tag"] = this.sourceTag;
+    }
     if (this.config.tenant.user_id) {
       headers["X-TapTap-User-Id"] = this.config.tenant.user_id;
     }
@@ -29512,12 +29516,14 @@ var TapTapMCPProxy = class {
    * - _project_id: 项目标识（可选）
    * - _project_path: 项目路径（可选）
    * - _custom_fields: 业务自定义字段（可选）
-   * - _tag: 调用来源标记，固定为 "local"
+   * - _tag: 调用来源标记，仅在嵌入入口显式启用时注入
    */
   injectPrivateParams(args) {
     const injected = { ...args || {} };
     injected._mac_token = this.config.auth;
-    injected._tag = LOCAL_PROXY_TAG;
+    if (this.sourceTag !== void 0) {
+      injected._tag = this.sourceTag;
+    }
     if (this.config.tenant.user_id) {
       injected._user_id = this.config.tenant.user_id;
     }
@@ -29568,6 +29574,18 @@ var TapTapMCPProxy = class {
     const replayableTools = (_a3 = this.config.options) == null ? void 0 : _a3.replayable_tools;
     return replayableTools === void 0 || replayableTools.includes(name);
   }
+  toolErrorResult(error2) {
+    return this.remoteErrorMode === "tool-result" ? convertMcpApplicationErrorToToolResult(error2) : void 0;
+  }
+  shouldReplayToolFailure(name, error2) {
+    if (!this.isToolReplayable(name) || !(error2 instanceof Error)) return false;
+    if (this.recoveryMode === "resilient") return true;
+    if (this.isSessionInvalidError(error2) || error2.message.toLowerCase().includes("not connected")) {
+      return true;
+    }
+    const code = error2.code;
+    return !isTransientHttpServerError(error2) && code !== ErrorCode.ConnectionClosed && code !== ErrorCode.RequestTimeout;
+  }
   /**
    * 连接到 TapTap MCP Server
    */
@@ -29604,8 +29622,13 @@ var TapTapMCPProxy = class {
       this.log("info", "✅ Connected and session validated");
       this.startHealthCheck();
       if (this.reconnecting) {
+        if (this.recoveryMode === "compatible") {
+          await this.notifyReconnected();
+        }
         await this.processPendingRequests();
-        await this.notifyReconnected();
+        if (this.recoveryMode === "resilient") {
+          await this.notifyReconnected();
+        }
         this.reconnecting = false;
       }
     } catch (error2) {
@@ -29760,15 +29783,17 @@ var TapTapMCPProxy = class {
     var _a3, _b, _c;
     this.clearReconnectTimer();
     const configuredInterval = ((_a3 = this.config.options) == null ? void 0 : _a3.reconnect_interval) ?? DEFAULT_RECONNECT_INTERVAL_MS;
-    const interval = this.reconnectDelayMs || configuredInterval;
+    const interval = this.recoveryMode === "resilient" ? this.reconnectDelayMs : configuredInterval;
     this.reconnectTimer = setTimeout(() => {
       this.reconnectToServer();
     }, interval);
     (_c = (_b = this.reconnectTimer).unref) == null ? void 0 : _c.call(_b);
-    this.reconnectDelayMs = Math.min(
-      Math.max(interval * 2, configuredInterval),
-      MAX_RECONNECT_INTERVAL_MS
-    );
+    if (this.recoveryMode === "resilient") {
+      this.reconnectDelayMs = Math.min(
+        Math.max(interval * 2, configuredInterval),
+        Math.max(MAX_RECONNECT_INTERVAL_MS, configuredInterval)
+      );
+    }
   }
   /**
    * 清除重连定时器
@@ -29809,15 +29834,18 @@ var TapTapMCPProxy = class {
    * 检测是否是需要重连的错误（网络错误或会话无效）
    */
   isNetworkError(error2) {
+    var _a3;
     if (!(error2 instanceof Error)) return false;
     if (convertMcpApplicationErrorToToolResult(error2)) {
       return false;
     }
     if (isHttpClientError(error2)) {
-      return false;
-    }
-    if (isTransientHttpServerError(error2)) {
-      return true;
+      if (this.isMcpApplicationError(error2)) {
+        return false;
+      }
+      const code = error2.code;
+      const status = typeof code === "number" && code >= 400 && code < 500 ? code : typeof code === "string" && /^4\d\d$/.test(code) ? Number(code) : Number((_a3 = error2.message.match(/\bHTTP\s+(4\d\d)\b/i)) == null ? void 0 : _a3[1]);
+      return (status === 400 || status === 404) && this.isSessionInvalidError(error2);
     }
     const errorMsg = error2.message.toLowerCase();
     const errorCode = error2.code;
@@ -29845,11 +29873,14 @@ var TapTapMCPProxy = class {
     if (errorCode === ErrorCode.ConnectionClosed || errorCode === ErrorCode.RequestTimeout) {
       return true;
     }
+    if (this.isMcpApplicationError(error2)) {
+      return false;
+    }
     if (errorMsg.includes("not connected") || this.isSessionInvalidError(error2)) {
       return true;
     }
-    if (this.isMcpApplicationError(error2)) {
-      return false;
+    if (isTransientHttpServerError(error2)) {
+      return true;
     }
     const networkErrorKeywords = [
       "fetch failed",
@@ -29876,7 +29907,6 @@ var TapTapMCPProxy = class {
   async processPendingRequests() {
     var _a3, _b, _c;
     const timeout = ((_a3 = this.config.options) == null ? void 0 : _a3.request_timeout) ?? 3e4;
-    const now = Date.now();
     this.log("info", `Processing ${this.pendingRequests.length} pending requests...`);
     while (this.pendingRequests.length > 0) {
       const req = this.pendingRequests.shift();
@@ -29884,7 +29914,7 @@ var TapTapMCPProxy = class {
         req.resolve(createNonReplayableToolResult(req.name, req.executionState ?? "unknown"));
         continue;
       }
-      if (now - req.timestamp > timeout) {
+      if (Date.now() - req.timestamp > timeout) {
         req.reject(new Error("Request timeout while waiting for reconnection"));
         continue;
       }
@@ -29904,7 +29934,7 @@ var TapTapMCPProxy = class {
         );
         req.resolve(result);
       } catch (error2) {
-        const toolErrorResult = convertMcpApplicationErrorToToolResult(error2);
+        const toolErrorResult = this.toolErrorResult(error2);
         if (toolErrorResult) {
           req.resolve(toolErrorResult);
           continue;
@@ -29912,7 +29942,11 @@ var TapTapMCPProxy = class {
         if (this.isNetworkError(error2)) {
           this.connected = false;
           this.sessionValidated = false;
-          this.pendingRequests.unshift(req);
+          if (this.recoveryMode === "resilient") {
+            this.pendingRequests.unshift(req);
+          } else {
+            req.reject(error2);
+          }
           throw error2;
         }
         req.reject(error2 instanceof Error ? error2 : new Error(String(error2)));
@@ -30051,19 +30085,23 @@ var TapTapMCPProxy = class {
         );
         return result;
       } catch (error2) {
-        const toolErrorResult = convertMcpApplicationErrorToToolResult(error2);
+        const toolErrorResult = this.toolErrorResult(error2);
         if (toolErrorResult) {
           return toolErrorResult;
         }
         if (this.isNetworkError(error2)) {
           this.log("error", "❌ Network error detected, marking connection as lost");
           this.connected = false;
+          this.sessionValidated = false;
           if (!this.reconnecting) {
             this.log("info", "Triggering immediate reconnection...");
             this.reconnectToServer();
             if (!this.isToolReplayable(name)) {
               return createNonReplayableToolResult(name, "unknown");
             }
+            if (!this.shouldReplayToolFailure(name, error2)) {
+              throw error2;
+            }
             this.log("info", `⏳ Queueing current request: ${name}`);
             return new Promise((resolve, reject) => {
               this.pendingRequests.push({

package/dist/server.js

@@ -6101,7 +6101,7 @@ class MultiplayerManager {
 // 导出
 // export default MultiplayerManager;
 // module.exports = MultiplayerManager;
-// window.MultiplayerManager = MultiplayerManager;`}]}}};var Es;Es="1.24.13";async function $De(){return Jo(jm,"api_event_relations")}async function PDe(){return Jo(jm,"protocol_template")}async function DD(){return Jo(jm,"complete_example")}async function TDe(){return`# TapTap 多人联机集成指南
+// window.MultiplayerManager = MultiplayerManager;`}]}}};var Es;Es="1.24.14";async function $De(){return Jo(jm,"api_event_relations")}async function PDe(){return Jo(jm,"protocol_template")}async function DD(){return Jo(jm,"complete_example")}async function TDe(){return`# TapTap 多人联机集成指南
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taptap/instant-games-open-mcp",
-  "version": "1.24.13",
+  "version": "1.24.14",
   "type": "module",
   "description": "TapTap Open API MCP Server - Documentation and Management APIs for TapTap Minigame and H5 Games (Leaderboard, and more features coming)",
   "main": "dist/server.js",