hvip-mcp-server 0.4.3 → 0.6.0

package/dist/index.js

@@ -4805,11 +4805,11 @@ var require_core = __commonJS({
     Ajv2.ValidationError = validation_error_1.default;
     Ajv2.MissingRefError = ref_error_1.default;
     exports2.default = Ajv2;
-    function checkOptions(checkOpts, options, msg, log = "error") {
+    function checkOptions(checkOpts, options, msg, log4 = "error") {
       for (const key in checkOpts) {
         const opt = key;
         if (opt in options)
-          this.logger[log](`${msg}: option ${key}. ${checkOpts[opt]}`);
+          this.logger[log4](`${msg}: option ${key}. ${checkOpts[opt]}`);
       }
     }
     function getSchEnv(keyRef) {
@@ -4856,13 +4856,13 @@ var require_core = __commonJS({
     }, warn() {
     }, error() {
     } };
-    function getLogger(logger) {
-      if (logger === false)
+    function getLogger(logger2) {
+      if (logger2 === false)
         return noLogs;
-      if (logger === void 0)
+      if (logger2 === void 0)
         return console;
-      if (logger.log && logger.warn && logger.error)
-        return logger;
+      if (logger2.log && logger2.warn && logger2.error)
+        return logger2;
       throw new Error("logger must implement log, warn and error methods");
     }
     var KEYWORD_NAME = /^[a-z_$][a-z0-9_$:-]*$/i;
@@ -10980,10 +10980,94 @@ var require_websocket_server = __commonJS({
   );
 })();
 
+// src/dns-fix.ts
+var import_node_dns = __toESM(require("node:dns"));
+
+// src/utils/logger.ts
+var LEVEL_EMOJI = {
+  [0 /* DEBUG */]: "\u{1F50D}",
+  [1 /* INFO */]: "\u2139\uFE0F",
+  [2 /* WARN */]: "\u26A0\uFE0F",
+  [3 /* ERROR */]: "\u274C",
+  [4 /* SILENT */]: ""
+};
+function resolveLevel() {
+  const raw = (process.env.LOG_LEVEL || "").toUpperCase();
+  if (raw === "DEBUG") return 0 /* DEBUG */;
+  if (raw === "WARN" || raw === "WARNING") return 2 /* WARN */;
+  if (raw === "ERROR") return 3 /* ERROR */;
+  if (raw === "SILENT" || raw === "OFF") return 4 /* SILENT */;
+  return 1 /* INFO */;
+}
+var currentLevel = resolveLevel();
+var LoggerImpl = class {
+  constructor(tag) {
+    this.tag = tag;
+  }
+  tag;
+  debug(msg) {
+    this.write(0 /* DEBUG */, msg);
+  }
+  info(msg) {
+    this.write(1 /* INFO */, msg);
+  }
+  warn(msg) {
+    this.write(2 /* WARN */, msg);
+  }
+  error(msg) {
+    this.write(3 /* ERROR */, msg);
+  }
+  write(level, msg) {
+    if (level < currentLevel) return;
+    const ts = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
+    const emoji2 = LEVEL_EMOJI[level];
+    const tag = this.tag ? `[${this.tag}]` : "";
+    const prefix = emoji2 ? `${emoji2} ${tag}` : tag;
+    process.stderr.write(`${ts} ${prefix} ${msg}
+`);
+  }
+};
+function logger(tag) {
+  return new LoggerImpl(tag);
+}
+
+// src/dns-fix.ts
+var log = logger("dns-fix");
+var FALLBACK_DNS = ["8.8.8.8", "1.1.1.1", "8.8.4.4"];
+function checkAndFixDns() {
+  try {
+    const servers = import_node_dns.default.getServers();
+    if (servers.some((s) => FALLBACK_DNS.includes(s))) {
+      return;
+    }
+    const hasLocalhost = servers.some((s) => s.startsWith("127."));
+    if (!hasLocalhost) {
+      return;
+    }
+    const testDomain = "one.one.one.one";
+    import_node_dns.default.resolve4(testDomain, (err) => {
+      if (err && (err.code === "ECONNREFUSED" || err.code === "ENOTFOUND" || err.code === "ETIMEOUT")) {
+        log.warn(`\u7CFB\u7EDF DNS (${servers.join(", ")}) \u4E0D\u53EF\u8FBE (${err.code})\uFF0C\u5207\u6362\u81F3\u516C\u5171 DNS: ${FALLBACK_DNS.join(", ")}`);
+        import_node_dns.default.setServers(FALLBACK_DNS);
+        import_node_dns.default.resolve4("www.okx.com", (verifyErr) => {
+          if (verifyErr) {
+            log.warn(`\u516C\u5171 DNS \u4E5F\u65E0\u6CD5\u89E3\u6790: ${verifyErr.code}`);
+          } else {
+            log.info(`DNS \u4FEE\u590D\u6210\u529F\uFF0C\u5F53\u524D\u670D\u52A1\u5668: ${import_node_dns.default.getServers().join(", ")}`);
+          }
+        });
+      }
+    });
+  } catch (e) {
+    log.warn(`DNS \u68C0\u6D4B\u5931\u8D25: ${e instanceof Error ? e.message : String(e)}`);
+  }
+}
+checkAndFixDns();
+
 // src/index.ts
 var import_node_http = require("node:http");
-var import_node_fs = require("node:fs");
-var import_node_path = require("node:path");
+var import_node_fs2 = require("node:fs");
+var import_node_path2 = require("node:path");
 
 // node_modules/zod/v3/external.js
 var external_exports = {};
@@ -23859,8 +23943,8 @@ var Server = class extends Protocol {
     this._loggingLevels = /* @__PURE__ */ new Map();
     this.LOG_LEVEL_SEVERITY = new Map(LoggingLevelSchema.options.map((level, index) => [level, index]));
     this.isMessageIgnored = (level, sessionId) => {
-      const currentLevel = this._loggingLevels.get(sessionId);
-      return currentLevel ? this.LOG_LEVEL_SEVERITY.get(level) < this.LOG_LEVEL_SEVERITY.get(currentLevel) : false;
+      const currentLevel2 = this._loggingLevels.get(sessionId);
+      return currentLevel2 ? this.LOG_LEVEL_SEVERITY.get(level) < this.LOG_LEVEL_SEVERITY.get(currentLevel2) : false;
     };
     this._capabilities = options?.capabilities ?? {};
     this._instructions = options?.instructions;
@@ -37557,6 +37641,7 @@ function registerWsTools(server, auth) {
 
 // src/adapters/agent-hub.ts
 var MAX_ROOM_MESSAGES = 200;
+var log2 = logger("AgentHub");
 var AgentHub = class {
   wss = null;
   agents = /* @__PURE__ */ new Map();
@@ -37564,30 +37649,53 @@ var AgentHub = class {
   rooms = /* @__PURE__ */ new Map();
   heartbeatTimer = null;
   version = "0.0.0";
+  startTime = 0;
   port = 0;
+  // public: updated after WS negotiate, read by hub for dashboard URL
+  registryCount = 0;
+  // set by hub-server after HubRegistry loads
   db = null;
   token = "";
   // PSK 鉴权令牌
+  costTracker = null;
+  // HubCosts 实例
   // ── 持久化绑定 ──
+  setCostTracker(ct) {
+    this.costTracker = ct;
+  }
   setDB(db) {
     this.db = db;
     const rows = db.loadTasks();
+    let orphanCount = 0;
     for (const r of rows) {
-      this.tasks.set(r.taskId, {
-        status: r.status,
-        assignedTo: r.assignedTo || void 0,
-        claimedAt: r.claimedAt || void 0,
-        result: r.result || void 0,
-        branch: r.branch || void 0
-      });
+      if (r.status === "assigned" && r.assignedTo && !this.agents.has(r.assignedTo)) {
+        this.tasks.set(r.taskId, {
+          status: "unassigned",
+          assignedTo: void 0,
+          claimedAt: void 0,
+          result: r.result || void 0,
+          branch: r.branch || void 0
+        });
+        db.saveTask({ taskId: r.taskId, status: "unassigned" });
+        orphanCount++;
+      } else {
+        this.tasks.set(r.taskId, {
+          status: r.status,
+          assignedTo: r.assignedTo || void 0,
+          claimedAt: r.claimedAt || void 0,
+          result: r.result || void 0,
+          branch: r.branch || void 0
+        });
+      }
     }
     if (rows.length > 0) {
-      console.log(`[AgentHub] \u4ECE DB \u6062\u590D ${rows.length} \u4E2A\u4EFB\u52A1`);
+      log2.info(`\u4ECE DB \u6062\u590D ${rows.length} \u4E2A\u4EFB\u52A1` + (orphanCount > 0 ? `\uFF0C\u91CA\u653E ${orphanCount} \u4E2A\u5B64\u513F\u4EFB\u52A1` : ""));
     }
   }
   // ── 启动 ──
   start(port, host = "0.0.0.0", version2 = "0.0.0", token = "") {
     this.version = version2;
+    this.startTime = Date.now();
     this.token = token;
     const startWss = (p) => {
       return new Promise((resolve2) => {
@@ -37623,12 +37731,10 @@ var AgentHub = class {
       return ok === true ? true : false;
     }).then((ok) => {
       if (!ok) {
-        process.stderr.write(`[AgentHub] WS Hub \u8DF3\u8FC7\uFF08\u7AEF\u53E3 ${ports.join("/")} \u4E0D\u53EF\u7528\uFF09
-`);
+        log2.warn(`WS Hub \u8DF3\u8FC7\uFF08\u7AEF\u53E3 ${ports.join("/")} \u4E0D\u53EF\u7528\uFF09`);
         return;
       }
-      process.stderr.write(`[AgentHub] WS Hub v${version2} ws://${host}:${this.port}
-`);
+      log2.info(`WS Hub v${version2} ws://${host}:${this.port}`);
       this.setupHub();
     });
   }
@@ -37660,17 +37766,17 @@ var AgentHub = class {
         if (agentId) this.handleDisconnect(agentId);
       });
       ws.on("error", (e) => {
-        process.stderr.write(`[AgentHub] WS \u9519\u8BEF: ${e.message}
-`);
+        log2.error(`WS \u9519\u8BEF: ${e.message}`);
       });
     });
     this.heartbeatTimer = setInterval(() => {
       const now = Date.now();
       for (const [id, a] of this.agents) {
+        if (id.startsWith("term-") || id.startsWith("dashboard")) continue;
         if (now - a.lastSeen > 12e4) {
           a.ws.close();
           this.agents.delete(id);
-          console.log("[AgentHub] Agent \u5FC3\u8DF3\u8D85\u65F6: " + id);
+          log2.warn("Agent \u5FC3\u8DF3\u8D85\u65F6: " + id);
         }
       }
     }, 3e4);
@@ -37686,9 +37792,29 @@ var AgentHub = class {
       case "task:claim":
         this.handleClaim(msg);
         break;
+      case "task:progress":
+        this.broadcast(msg);
+        break;
+      // 流式文本转发
+      case "task:tool":
+        this.broadcast(msg);
+        break;
+      // 工具调用转发
       case "task:done":
         this.handleDone(msg);
         break;
+      case "task:assign":
+        this.handleAssign(msg);
+        break;
+      // Chronos AI 调度指令
+      case "task:unassign":
+        this.handleUnassign(msg);
+        break;
+      // Chronos 释放卡住任务
+      case "task:reject":
+        this.handleReject(msg);
+        break;
+      // Worker 忙时拒绝任务
       // ── Room ──
       case "room:join":
         this.handleRoomJoin(authAgentId, msg);
@@ -37727,7 +37853,7 @@ var AgentHub = class {
       lastSeen: Date.now()
     });
     this.joinRoom(agentId, "#lobby");
-    console.log(`[AgentHub] Agent \u6CE8\u518C: ${agentId} (${name}) skills: [${capabilities.join(", ")}]`);
+    log2.info(`Agent \u6CE8\u518C: ${agentId} (${name}) skills: [${capabilities.join(", ")}]`);
     this.send(ws, {
       type: "agent:registered",
       agentId,
@@ -37735,6 +37861,13 @@ var AgentHub = class {
       message: `\u5DF2\u6CE8\u518C\u3002\u53EF\u7528\u4EFB\u52A1: ${this.getUnassignedTasks().join(", ") || "\u65E0"}`,
       pendingTasks: this.getUnassignedTasks()
     });
+    this.broadcast({
+      type: "agent:update",
+      agentId,
+      name,
+      capabilities,
+      status: "idle"
+    });
     const agentVersion = String(msg.version || "");
     if (agentVersion && agentVersion !== this.version) {
       this.send(ws, {
@@ -37756,7 +37889,8 @@ var AgentHub = class {
   }
   handleDisconnect(agentId) {
     const info = this.agents.get(agentId);
-    console.log(`[AgentHub] Agent \u79BB\u7EBF: ${agentId} (${info?.name || "?"})`);
+    log2.info(`Agent \u79BB\u7EBF: ${agentId} (${info?.name || "?"})`);
+    this.broadcast({ type: "agent:offline", agentId });
     for (const [roomId, room] of this.rooms) {
       if (room.members.has(agentId)) {
         room.members.delete(agentId);
@@ -37796,8 +37930,12 @@ var AgentHub = class {
       return;
     }
     if (task.status === "assigned" && task.assignedTo !== agentId) {
-      this.sendTo(agentId, { type: "error", message: `\u4EFB\u52A1 ${taskId} \u5DF2\u88AB ${task.assignedTo} \u8BA4\u9886` });
-      return;
+      const assignedWorker = task.assignedTo ? this.agents.get(task.assignedTo) : null;
+      if (assignedWorker) {
+        this.sendTo(agentId, { type: "error", message: `\u4EFB\u52A1 ${taskId} \u5DF2\u88AB ${task.assignedTo} \u8BA4\u9886` });
+        return;
+      }
+      log2.info(`${agentId} \u63A5\u7BA1\u5B64\u513F\u4EFB\u52A1 ${taskId}\uFF08\u539F ${task.assignedTo} \u5DF2\u79BB\u7EBF\uFF09`);
     }
     task.status = "assigned";
     task.assignedTo = agentId;
@@ -37805,7 +37943,7 @@ var AgentHub = class {
     const a = this.agents.get(agentId);
     if (a) a.status = "working";
     this.joinRoom(agentId, `#task-${taskId}`);
-    console.log(`[AgentHub] ${agentId} \u8BA4\u9886 ${taskId}`);
+    log2.info(`${agentId} \u8BA4\u9886 ${taskId}`);
     this.db?.saveTask({ taskId, status: "assigned", title: this.getTaskTitle(taskId), assignedTo: agentId, claimedAt: task.claimedAt });
     this.sendTo(agentId, {
       type: "task:assigned",
@@ -37821,18 +37959,44 @@ var AgentHub = class {
     const agentId = String(msg.agentId || "");
     const result = String(msg.result || "");
     const branch = String(msg.branch || "");
+    const error2 = msg.error ? String(msg.error) : "";
+    const usage = msg.usage;
+    const steps = Number(msg.steps || 0);
+    if (this.costTracker && usage?.inputTokens) {
+      this.costTracker.record({
+        agentId,
+        taskId,
+        model: usage.model || "claude-sonnet-4-6",
+        inputTokens: usage.inputTokens || 0,
+        outputTokens: usage.outputTokens || 0,
+        purpose: "task"
+      });
+    }
     const task = this.tasks.get(taskId);
     if (!task) {
       this.sendTo(agentId, { type: "error", message: `\u4EFB\u52A1 ${taskId} \u4E0D\u5B58\u5728` });
       return;
     }
+    if (error2 || /^❌|^执行失败/i.test(result)) {
+      task.status = "unassigned";
+      task.assignedTo = void 0;
+      task.claimedAt = void 0;
+      const a2 = this.agents.get(agentId);
+      if (a2) a2.status = "idle";
+      this.db?.saveTask({ taskId, status: "unassigned" });
+      log2.info(`\u4EFB\u52A1\u6267\u884C\u5931\u8D25\uFF0C\u91CA\u653E\u91CD\u8BD5: ${taskId} \u2014 ${error2 || result.slice(0, 80)}`);
+      this.broadcast({ type: "agent:update", agentId, status: "idle" });
+      this.broadcast({ type: "task:released", taskId, reason: `\u6267\u884C\u5931\u8D25: ${error2 || result.slice(0, 60)}` });
+      return;
+    }
     task.status = "done";
     task.result = result;
     task.branch = branch;
     const a = this.agents.get(agentId);
     if (a) a.status = "idle";
-    console.log(`[AgentHub] ${agentId} \u5B8C\u6210 ${taskId}: ${result}`);
+    log2.info(`${agentId} \u5B8C\u6210 ${taskId}: ${result}`);
     this.db?.saveTask({ taskId, status: "done", title: this.getTaskTitle(taskId), assignedTo: agentId, result, branch });
+    this.broadcast({ type: "agent:update", agentId, status: "idle" });
     this.sendToRoom(`#task-${taskId}`, agentId, `\u5DF2\u5B8C\u6210 ${taskId}: ${result} (branch: ${branch})\uFF0C\u7B49\u5F85\u5BA1\u6838\u3002`);
     this.sendToRoom("#review", agentId, `${taskId} \u63D0\u4EA4\u5B8C\u6210\uFF0Cbranch: ${branch}`);
     this.broadcast({
@@ -37844,41 +38008,125 @@ var AgentHub = class {
       message: `${agentId} \u5DF2\u5B8C\u6210 ${taskId}\uFF0C\u7B49\u5F85\u5BA1\u6838`
     });
   }
+  // ── Chronos 释放卡住任务 ──
+  handleUnassign(msg) {
+    const taskId = String(msg.taskId || "");
+    const reason = String(msg.reason || "Chronos \u5DE1\u68C0\u91CA\u653E");
+    const task = this.tasks.get(taskId);
+    if (!task) {
+      log2.warn(`Chronos \u91CA\u653E\u5931\u8D25: \u4EFB\u52A1 ${taskId} \u4E0D\u5B58\u5728`);
+      return;
+    }
+    if (task.status !== "assigned") {
+      return;
+    }
+    const oldAgentId = task.assignedTo;
+    task.status = "unassigned";
+    task.assignedTo = void 0;
+    task.claimedAt = void 0;
+    if (oldAgentId) {
+      const oldWorker = this.agents.get(oldAgentId);
+      if (oldWorker && oldWorker.status === "working") {
+        oldWorker.status = "idle";
+      }
+    }
+    this.db?.saveTask({ taskId, status: "unassigned" });
+    log2.warn(`Chronos \u91CA\u653E\u5361\u4F4F\u4EFB\u52A1: ${taskId} (\u539F ${oldAgentId || "?"}) \u2014 ${reason}`);
+    this.broadcast({
+      type: "task:released",
+      taskId,
+      reason: `Chronos \u91CA\u653E: ${reason}`
+    });
+  }
+  // ── Worker 拒绝任务（忙碌）──
+  handleReject(msg) {
+    const taskId = String(msg.taskId || "");
+    const agentId = String(msg.agentId || "");
+    const reason = String(msg.reason || "Worker busy");
+    const task = this.tasks.get(taskId);
+    if (!task) return;
+    if (task.status !== "assigned") return;
+    task.status = "unassigned";
+    task.assignedTo = void 0;
+    task.claimedAt = void 0;
+    const a = this.agents.get(agentId);
+    if (a && a.status === "working") a.status = "idle";
+    this.db?.saveTask({ taskId, status: "unassigned" });
+    log2.info(`\u4EFB\u52A1\u88AB\u62D2\u7EDD: ${taskId} by ${agentId} \u2014 ${reason}`);
+    this.broadcast({ type: "task:released", taskId, reason: `Worker \u62D2\u7EDD: ${reason}` });
+  }
   // ── 注册任务（自动派发给空闲 Agent） ──
-  registerTask(taskId, title) {
+  /** 检查是否有空闲的 WS Worker（非 dashboard、非 CLI spawn） */
+  hasIdleWorker() {
+    for (const [id, a] of this.agents) {
+      if (a.status === "idle" && !id.startsWith("dashboard") && !id.startsWith("term-")) {
+        return true;
+      }
+    }
+    return false;
+  }
+  registerTask(taskId, title, promptB64) {
     if (!this.tasks.has(taskId)) {
       this.tasks.set(taskId, { status: "unassigned" });
     }
-    if (title) {
-      const t = this.tasks.get(taskId);
-      t.title = title;
-    }
-    console.log(`[AgentHub] \u4EFB\u52A1\u6CE8\u518C: ${taskId} "${title || taskId}"`);
+    const task = this.tasks.get(taskId);
+    if (title) task.title = title;
+    if (promptB64) task.promptB64 = promptB64;
+    log2.info(`\u4EFB\u52A1\u6CE8\u518C: ${taskId} "${title || taskId}"`);
     this.broadcast({ type: "task:announced", taskId, title: title || taskId });
-    const idleAgents = [...this.agents.entries()].filter(([, a]) => a.status === "idle" && !a.agentId.startsWith("dashboard"));
+    const hasChronos = [...this.agents.values()].some(
+      (a) => a.agentId === "chronos-dispatcher" && a.status !== "offline"
+    );
+    if (hasChronos) {
+      log2.info(`Chronos \u5728\u7EBF\uFF0C\u4EFB\u52A1 ${taskId} \u7B49\u5F85 AI \u8C03\u5EA6`);
+      return;
+    }
+    const idleAgents = [...this.agents.entries()].filter(([, a]) => a.status === "idle" && !a.agentId.startsWith("dashboard") && !a.agentId.startsWith("term-"));
     if (idleAgents.length === 0) {
-      console.log(`[AgentHub] \u6CA1\u6709\u7A7A\u95F2 Agent\uFF0C\u4EFB\u52A1 ${taskId} \u7B49\u5F85\u624B\u52A8 spawn`);
+      log2.warn(`\u6CA1\u6709\u7A7A\u95F2 Agent\uFF0C\u4EFB\u52A1 ${taskId} \u7B49\u5F85\u624B\u52A8 spawn`);
       return;
     }
     const match = idleAgents.find(([, a]) => a.capabilities.includes(taskId)) || idleAgents[0];
     if (match) {
-      console.log(`[AgentHub] \u81EA\u52A8\u6D3E\u53D1 ${taskId} \u2192 ${match[1].name} (${match[0]})`);
-      this.dispatchTaskTo(taskId, match[0]);
+      log2.info(`\u81EA\u52A8\u6D3E\u53D1 ${taskId} \u2192 ${match[1].name} (${match[0]})`);
+      this.dispatchTaskTo(taskId, match[0], promptB64);
     }
   }
   // ── 派发任务 ──
-  dispatchTaskTo(taskId, agentId) {
+  dispatchTaskTo(taskId, agentId, promptB64) {
     if (!this.tasks.has(taskId)) {
       this.tasks.set(taskId, { status: "unassigned" });
     }
     const task = this.tasks.get(taskId);
     if (task.status === "assigned") return;
-    this.sendTo(agentId, {
+    const msg = {
       type: "task:dispatch",
       taskId,
-      title: this.getTaskTitle(taskId),
-      url: `https://github.com/okx-wallet-H/hvip-mcp/blob/master/tasks/${taskId}.md`
-    });
+      title: this.getTaskTitle(taskId)
+    };
+    if (promptB64) msg.promptB64 = promptB64;
+    else if (task.promptB64) msg.promptB64 = task.promptB64;
+    this.sendTo(agentId, msg);
+  }
+  // ── Chronos 调度指令 ──
+  handleAssign(msg) {
+    const taskId = String(msg.taskId || "");
+    const targetAgentId = String(msg.agentId || "");
+    const assignedBy = String(msg.assignedBy || "chronos");
+    if (!taskId || !targetAgentId) return;
+    const targetWorker = this.agents.get(targetAgentId);
+    if (!targetWorker) {
+      log2.warn(`Chronos \u6307\u6D3E\u5931\u8D25: Worker ${targetAgentId} \u4E0D\u5728\u7EBF`);
+      return;
+    }
+    if (targetWorker.status !== "idle") {
+      log2.warn(`Chronos \u6307\u6D3E\u5931\u8D25: Worker ${targetAgentId} \u5FD9\u788C\u4E2D`);
+      return;
+    }
+    log2.info(`Chronos \u8C03\u5EA6: ${taskId} \u2192 ${targetWorker.name}`);
+    const task = this.tasks.get(taskId);
+    const promptB64 = task?.promptB64;
+    this.dispatchTaskTo(taskId, targetAgentId, promptB64);
   }
   // ── 审核 + 自动通知房间 ──
   reviewTask(taskId, verdict, feedback) {
@@ -37926,7 +38174,7 @@ var AgentHub = class {
       });
     }
     this.sendToRoomMembers(room, { type: "room:member_joined", roomId, agentId });
-    console.log(`[AgentHub] ${agentId} \u2192 ${roomId}`);
+    log2.info(`${agentId} \u2192 ${roomId}`);
   }
   leaveRoom(agentId, roomId) {
     const room = this.rooms.get(roomId);
@@ -38043,7 +38291,7 @@ var AgentHub = class {
       branch: t.branch
     }));
     const rooms = this.getRooms();
-    return { agents, tasks, rooms, agentCount: agents.length, taskCount: tasks.length };
+    return { agents, tasks, rooms, agentCount: agents.length, taskCount: tasks.length, version: this.version, uptime: this.startTime ? Math.floor((Date.now() - this.startTime) / 1e3) : 0, registry: `${this.registryCount || 24} plugins` };
   }
   // ── 关闭 ──
   close() {
@@ -38628,6 +38876,146 @@ function registerCodeGraphTools(server) {
   );
 }
 
+// src/adapters/api-credits.ts
+var import_node_sqlite = require("node:sqlite");
+var import_node_fs = require("node:fs");
+var import_node_path = require("node:path");
+var log3 = logger("Credits");
+var CREDIT_COST = {
+  READ: 1,
+  WRITE: 5,
+  FUND_TRANSFER: 10,
+  ADMIN: 20
+};
+var ApiCredits = class {
+  db;
+  cache = /* @__PURE__ */ new Map();
+  cacheLoaded = false;
+  constructor(dbPath = ".hub/api-credits.db") {
+    const dir = (0, import_node_path.dirname)(dbPath);
+    if (!(0, import_node_fs.existsSync)(dir)) (0, import_node_fs.mkdirSync)(dir, { recursive: true });
+    this.db = new import_node_sqlite.DatabaseSync(dbPath);
+    this.db.exec("PRAGMA journal_mode=WAL");
+    this.init();
+  }
+  init() {
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS api_keys (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        key TEXT UNIQUE NOT NULL,
+        client_name TEXT NOT NULL,
+        credits REAL NOT NULL DEFAULT 0,
+        total_used INTEGER NOT NULL DEFAULT 0,
+        enabled INTEGER NOT NULL DEFAULT 1,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        last_used_at TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_api_keys_key ON api_keys(key);
+    `);
+    this.loadCache();
+  }
+  loadCache() {
+    const rows = this.db.prepare("SELECT * FROM api_keys").all();
+    for (const r of rows) this.cache.set(r.key, r);
+    this.cacheLoaded = true;
+    log3.info(`\u5DF2\u52A0\u8F7D ${rows.length} \u4E2A API Key`);
+  }
+  /** 查找 Key — 缓存命中或直接查 DB */
+  lookup(key) {
+    if (!this.cacheLoaded) this.loadCache();
+    const cached2 = this.cache.get(key);
+    if (cached2) return cached2;
+    const row = this.db.prepare("SELECT * FROM api_keys WHERE key = ?").get(key);
+    if (row) {
+      this.cache.set(key, row);
+      return row;
+    }
+    return null;
+  }
+  /** 校验并扣费 */
+  deduct(key, riskLevel) {
+    const record2 = this.lookup(key);
+    if (!record2) return { ok: false, error: "\u65E0\u6548\u7684 API Key" };
+    if (!record2.enabled) return { ok: false, error: "API Key \u5DF2\u7981\u7528" };
+    const cost = CREDIT_COST[riskLevel] || 1;
+    if (record2.credits < cost) return { ok: false, error: `\u79EF\u5206\u4E0D\u8DB3 (\u9700\u8981 ${cost}\uFF0C\u5269\u4F59 ${record2.credits})` };
+    record2.credits -= cost;
+    record2.totalUsed++;
+    record2.lastUsedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.db.prepare("UPDATE api_keys SET credits = ?, total_used = ?, last_used_at = ? WHERE id = ?").run(record2.credits, record2.totalUsed, record2.lastUsedAt, record2.id);
+    return { ok: true, remaining: record2.credits };
+  }
+  /** 管理：创建 Key */
+  createKey(clientName, initialCredits = 1e3) {
+    const key = "hvip-" + Array.from(
+      { length: 32 },
+      () => "abcdefghijklmnopqrstuvwxyz0123456789"[Math.floor(Math.random() * 36)]
+    ).join("");
+    const result = this.db.prepare(
+      "INSERT INTO api_keys (key, client_name, credits) VALUES (?, ?, ?)"
+    ).run(key, clientName, initialCredits);
+    const record2 = {
+      id: result.lastInsertRowid,
+      key,
+      clientName,
+      credits: initialCredits,
+      totalUsed: 0,
+      enabled: true,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      lastUsedAt: null
+    };
+    this.cache.set(key, record2);
+    return record2;
+  }
+  /** 管理：充值 */
+  topUp(key, amount) {
+    const record2 = this.lookup(key);
+    if (!record2) return { ok: false, error: "Key \u4E0D\u5B58\u5728" };
+    if (amount <= 0) return { ok: false, error: "\u5145\u503C\u91D1\u989D\u5FC5\u987B > 0" };
+    record2.credits += amount;
+    this.db.prepare("UPDATE api_keys SET credits = ? WHERE id = ?").run(record2.credits, record2.id);
+    return { ok: true, newBalance: record2.credits };
+  }
+  /** 管理：启用/禁用 Key */
+  setEnabled(key, enabled) {
+    const record2 = this.lookup(key);
+    if (!record2) return false;
+    record2.enabled = enabled;
+    this.db.prepare("UPDATE api_keys SET enabled = ? WHERE id = ?").run(enabled ? 1 : 0, record2.id);
+    return true;
+  }
+  /** 管理：列出所有 Key (含 Key 前缀，完整 Key 仅创建时返回) */
+  listAll() {
+    return [...this.cache.values()].map((r) => ({
+      id: r.id,
+      clientName: r.clientName,
+      credits: r.credits,
+      totalUsed: r.totalUsed,
+      enabled: r.enabled,
+      createdAt: r.createdAt,
+      lastUsedAt: r.lastUsedAt,
+      keyPrefix: r.key.slice(0, 12) + "..." + r.key.slice(-8)
+    }));
+  }
+  /** 客户端：查询余额 */
+  getBalance(key) {
+    const record2 = this.lookup(key);
+    if (!record2) return null;
+    return { clientName: record2.clientName, credits: record2.credits, totalUsed: record2.totalUsed };
+  }
+  close() {
+    try {
+      this.db.close();
+    } catch {
+    }
+  }
+};
+var instance = null;
+function getApiCredits(dbPath) {
+  if (!instance) instance = new ApiCredits(dbPath);
+  return instance;
+}
+
 // src/index.ts
 function resolveExecutionMode() {
   if (process.env.MCP_EXECUTION_ENABLED === "false") {
@@ -38700,7 +39088,7 @@ function registerAllTools(server, auth, readOnly) {
       if (risk !== "READ") {
         skipped++;
         skipLog.push(`${name} (${risk})`);
-        return;
+        return server;
       }
       return orig(name, ...args);
     };
@@ -38732,22 +39120,46 @@ function registerAllTools(server, auth, readOnly) {
   return { skipped, skipLog };
 }
 async function startHttp(server, version2, auth, readOnly, skipped) {
-  const port = parseInt(process.env.PORT || "3000", 10);
+  let port = parseInt(process.env.PORT || "3000", 10);
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
     process.stderr.write(`[hvip] \u274C \u65E0\u6548\u7AEF\u53E3: ${process.env.PORT}\uFF0C\u4F7F\u7528\u9ED8\u8BA4 3000
 `);
+    port = 3e3;
   }
   const host = process.env.HOST || "127.0.0.1";
-  const token = process.env.MCP_AUTH_TOKEN || "";
+  const adminToken = process.env.MCP_AUTH_TOKEN || "";
+  const creditsEnabled = process.env.MCP_CREDITS !== "false" && process.env.MCP_CREDITS !== "0";
+  const credits = creditsEnabled ? getApiCredits() : null;
   const transport = new StreamableHTTPServerTransport({
     sessionIdGenerator: void 0
     // stateless
   });
   await server.connect(transport);
   const httpServer = (0, import_node_http.createServer)(async (req, res) => {
-    if (token && req.url !== "/health") {
-      const provided = req.headers["authorization"]?.replace(/^Bearer\s+/i, "") || "";
-      if (provided !== token) {
+    const provided = req.headers["authorization"]?.replace(/^Bearer\s+/i, "") || "";
+    if (req.url !== "/health" && req.url !== "/") {
+      if (adminToken && provided === adminToken) {
+      } else if (credits && provided) {
+        const record2 = credits.lookup(provided);
+        if (!record2) {
+          res.writeHead(401, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: "Unauthorized \u2014 \u65E0\u6548\u7684 API Key" }));
+          return;
+        }
+        if (!record2.enabled) {
+          res.writeHead(403, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: "Forbidden \u2014 API Key \u5DF2\u7981\u7528" }));
+          return;
+        }
+        if (req.method === "POST" && req.url === "/mcp") {
+          const result = credits.deduct(provided, "READ");
+          if (!result.ok) {
+            res.writeHead(402, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: result.error, remaining: credits.lookup(provided)?.credits || 0 }));
+            return;
+          }
+        }
+      } else if (adminToken) {
         res.writeHead(401, { "Content-Type": "application/json" });
         res.end(JSON.stringify({ error: "Unauthorized \u2014 \u8BF7\u5728 Authorization \u5934\u643A\u5E26\u6709\u6548 token" }));
         return;
@@ -38764,15 +39176,15 @@ async function startHttp(server, version2, auth, readOnly, skipped) {
     if (req.method === "GET" && (req.url === "/" || req.url === "/index.html")) {
       try {
         const paths = [
-          (0, import_node_path.join)(__dirname, "web", "index.html"),
+          (0, import_node_path2.join)(__dirname, "web", "index.html"),
           // published npm (dist/index.js → dist/web/)
-          (0, import_node_path.join)(__dirname, "..", "src", "web", "index.html")
+          (0, import_node_path2.join)(__dirname, "..", "src", "web", "index.html")
           // dev (dist/index.js → ../src/web/)
         ];
         let html = "";
         for (const p of paths) {
-          if ((0, import_node_fs.existsSync)(p)) {
-            html = (0, import_node_fs.readFileSync)(p, "utf-8");
+          if ((0, import_node_fs2.existsSync)(p)) {
+            html = (0, import_node_fs2.readFileSync)(p, "utf-8");
             break;
           }
         }
@@ -38832,7 +39244,7 @@ async function startHttp(server, version2, auth, readOnly, skipped) {
     const platform = process.platform;
     const cmd = platform === "win32" ? `start ${openUrl}` : platform === "darwin" ? `open ${openUrl}` : `xdg-open ${openUrl}`;
     import("node:child_process").then((cp) => {
-      cp.exec(cmd, () => {
+      cp.exec(cmd, { windowsHide: true }, () => {
       });
     });
   });
@@ -38863,12 +39275,33 @@ async function startStdio(server, version2, auth, readOnly, skipped, skipLog) {
   }
   const wsHost = process.env.WS_BIND_HOST || "127.0.0.1";
   const wsToken = process.env.HUB_AUTH_TOKEN || "";
-  startAgentHub(parseInt(process.env.WS_AGENT_PORT || "9321"), wsHost, version2, wsToken);
+  startAgentHub(parseInt(process.env.WS_AGENT_PORT || "9321", 10), wsHost, version2, wsToken);
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
+var _cachedVersion = null;
+function loadVersion() {
+  if (_cachedVersion) return _cachedVersion;
+  try {
+    const paths = [
+      (0, import_node_path2.join)(__dirname, "..", "package.json"),
+      (0, import_node_path2.join)(__dirname, "..", "..", "..", "package.json")
+    ];
+    for (const p of paths) {
+      if ((0, import_node_fs2.existsSync)(p)) {
+        const pkg = JSON.parse((0, import_node_fs2.readFileSync)(p, "utf-8"));
+        if (pkg.version) {
+          _cachedVersion = String(pkg.version);
+          return _cachedVersion;
+        }
+      }
+    }
+  } catch {
+  }
+  return "0.0.0";
+}
 async function main() {
-  const VERSION = "0.3.2";
+  const VERSION = loadVersion();
   const argv = process.argv.slice(2);
   if (argv.includes("--help") || argv.includes("-h")) printHelpAndExit(VERSION);
   if (argv.includes("--version") || argv.includes("-v")) {