@xiaou66/vite-plugin-vue-mcp-next 1.0.3 → 1.0.4

package/dist/index.d.cts

@@ -370,10 +370,25 @@ interface PageTarget {
     readonly pathname: string;
     /** 页面标题，用于 AI 和用户在多个相似 URL 中识别目标页面。 */
     readonly title?: string;
+    /** 同标签页稳定身份，仅 runtime 目标提供，用于刷新或 HMR 重连时断开旧 pageId。 */
+    readonly runtimeClientId?: string;
     /** 对应的 Vite HTML 入口或 appendTo 入口，用于说明页面来自哪个开发入口。 */
     readonly entry?: string;
     /** 页面是否仍可调试，用于避免 MCP 对已断开的页面继续执行操作。 */
     readonly connected: boolean;
+    /** runtime 目标断开时间，仅用于保留短期历史并清理过期断开记录。 */
+    readonly disconnectedAt?: number;
+}
+/**
+ * 页面目标列表选项。
+ *
+ * 默认列表面向日常调试，只展示可操作页面；排查生命周期问题时可显式包含断开 runtime 记录。
+ */
+interface PageTargetListOptions {
+    /** 是否包含已断开的 runtime 页面，默认隐藏以避免刷新历史干扰目标选择。 */
+    readonly includeDisconnected?: boolean;
+    /** 测试或批处理场景可传入固定时间，避免依赖真实时钟造成用例不稳定。 */
+    readonly now?: number;
 }
 /**
  * 页面 Console 和运行时异常的统一记录。
@@ -444,13 +459,13 @@ interface NetworkRecord {
  */
 interface PageTargetRegistry {
     /** 新增或更新页面目标，适合 runtime 重连和 CDP target 刷新场景。 */
-    upsert(target: PageTarget): void;
+    upsert(target: PageTarget, now?: number): void;
     /** 获取单个页面目标，工具调用解析 pageId 时使用。 */
     get(pageId: string): PageTarget | undefined;
-    /** 返回所有页面目标快照，避免调用方修改内部 Map。 */
-    list(): PageTarget[];
-    /** 标记页面断开，保留记录可以帮助用户理解刚才的页面为什么不可操作。 */
-    disconnect(pageId: string): void;
+    /** 返回页面目标快照，默认隐藏已断开的 runtime 历史记录。 */
+    list(options?: PageTargetListOptions): PageTarget[];
+    /** 标记页面断开，保留短期记录可以帮助用户理解刚才的页面为什么不可操作。 */
+    disconnect(pageId: string, now?: number): void;
 }
 /**
  * 插件内部共享上下文。

package/dist/index.d.ts

@@ -370,10 +370,25 @@ interface PageTarget {
     readonly pathname: string;
     /** 页面标题，用于 AI 和用户在多个相似 URL 中识别目标页面。 */
     readonly title?: string;
+    /** 同标签页稳定身份，仅 runtime 目标提供，用于刷新或 HMR 重连时断开旧 pageId。 */
+    readonly runtimeClientId?: string;
     /** 对应的 Vite HTML 入口或 appendTo 入口，用于说明页面来自哪个开发入口。 */
     readonly entry?: string;
     /** 页面是否仍可调试，用于避免 MCP 对已断开的页面继续执行操作。 */
     readonly connected: boolean;
+    /** runtime 目标断开时间，仅用于保留短期历史并清理过期断开记录。 */
+    readonly disconnectedAt?: number;
+}
+/**
+ * 页面目标列表选项。
+ *
+ * 默认列表面向日常调试，只展示可操作页面；排查生命周期问题时可显式包含断开 runtime 记录。
+ */
+interface PageTargetListOptions {
+    /** 是否包含已断开的 runtime 页面，默认隐藏以避免刷新历史干扰目标选择。 */
+    readonly includeDisconnected?: boolean;
+    /** 测试或批处理场景可传入固定时间，避免依赖真实时钟造成用例不稳定。 */
+    readonly now?: number;
 }
 /**
  * 页面 Console 和运行时异常的统一记录。
@@ -444,13 +459,13 @@ interface NetworkRecord {
  */
 interface PageTargetRegistry {
     /** 新增或更新页面目标，适合 runtime 重连和 CDP target 刷新场景。 */
-    upsert(target: PageTarget): void;
+    upsert(target: PageTarget, now?: number): void;
     /** 获取单个页面目标，工具调用解析 pageId 时使用。 */
     get(pageId: string): PageTarget | undefined;
-    /** 返回所有页面目标快照，避免调用方修改内部 Map。 */
-    list(): PageTarget[];
-    /** 标记页面断开，保留记录可以帮助用户理解刚才的页面为什么不可操作。 */
-    disconnect(pageId: string): void;
+    /** 返回页面目标快照，默认隐藏已断开的 runtime 历史记录。 */
+    list(options?: PageTargetListOptions): PageTarget[];
+    /** 标记页面断开，保留短期记录可以帮助用户理解刚才的页面为什么不可操作。 */
+    disconnect(pageId: string, now?: number): void;
 }
 /**
  * 插件内部共享上下文。

package/dist/index.js

@@ -194,24 +194,64 @@ function createRingBuffer(capacity) {
 }
 
 // src/context.ts
+var MINUTE_MS = 60 * 1e3;
+var DISCONNECTED_RUNTIME_TARGET_RETENTION_MS = 5 * MINUTE_MS;
+function shouldPruneDisconnectedRuntimeTarget(target, now) {
+  return target.source === "runtime" && !target.connected && typeof target.disconnectedAt === "number" && now - target.disconnectedAt > DISCONNECTED_RUNTIME_TARGET_RETENTION_MS;
+}
+function pruneDisconnectedRuntimeTargets(targets, now) {
+  for (const [pageId, target] of targets) {
+    if (shouldPruneDisconnectedRuntimeTarget(target, now)) {
+      targets.delete(pageId);
+    }
+  }
+}
+function markTargetDisconnected(target, now) {
+  return {
+    ...target,
+    connected: false,
+    disconnectedAt: target.disconnectedAt ?? now
+  };
+}
+function shouldListPageTarget(target, options) {
+  return options.includeDisconnected === true || target.source !== "runtime" || target.connected;
+}
+function disconnectPreviousRuntimeClientTarget(targets, target, now) {
+  if (target.source !== "runtime" || !target.runtimeClientId) {
+    return;
+  }
+  for (const [pageId, currentTarget] of targets) {
+    if (pageId === target.pageId || currentTarget.source !== "runtime" || currentTarget.runtimeClientId !== target.runtimeClientId || !currentTarget.connected) {
+      continue;
+    }
+    targets.set(pageId, markTargetDisconnected(currentTarget, now));
+  }
+}
 function createPageTargetRegistry() {
   const targets = /* @__PURE__ */ new Map();
   return {
-    upsert(target) {
+    upsert(target, now = Date.now()) {
+      pruneDisconnectedRuntimeTargets(targets, now);
+      disconnectPreviousRuntimeClientTarget(targets, target, now);
       targets.set(target.pageId, target);
     },
     get(pageId) {
       return targets.get(pageId);
     },
-    list() {
-      return [...targets.values()];
+    list(options = {}) {
+      const now = options.now ?? Date.now();
+      pruneDisconnectedRuntimeTargets(targets, now);
+      return [...targets.values()].filter(
+        (target) => shouldListPageTarget(target, options)
+      );
     },
-    disconnect(pageId) {
+    disconnect(pageId, now = Date.now()) {
+      pruneDisconnectedRuntimeTargets(targets, now);
       const target = targets.get(pageId);
       if (!target) {
         return;
       }
-      targets.set(pageId, { ...target, connected: false });
+      targets.set(pageId, markTargetDisconnected(target, now));
     }
   };
 }
@@ -664,9 +704,12 @@ function registerPageTools(server, ctx, vite) {
   server.registerTool(
     MCP_TOOL_NAMES.listPages,
     {
-      description: "List Vite page entries and connected runtime/CDP targets."
+      description: "List Vite page entries and connected runtime/CDP targets.",
+      inputSchema: {
+        includeDisconnected: z5.boolean().optional()
+      }
     },
-    async () => {
+    async (input) => {
       const cdpResult = await listCdpPageTargets(ctx);
       for (const target of cdpResult.pages) {
         ctx.pages.upsert(target);
@@ -674,7 +717,9 @@ function registerPageTools(server, ctx, vite) {
       }
       return createToolResponse({
         entries: discoverHtmlEntries(vite),
-        pages: ctx.pages.list(),
+        pages: ctx.pages.list({
+          includeDisconnected: input.includeDisconnected
+        }),
         cdpError: cdpResult.error
       });
     }
@@ -2298,7 +2343,7 @@ function isRuntimePageTarget(payload) {
     return false;
   }
   const target = payload;
-  return target.source === "runtime" && typeof target.pageId === "string" && typeof target.url === "string" && typeof target.pathname === "string" && typeof target.connected === "boolean";
+  return target.source === "runtime" && typeof target.pageId === "string" && typeof target.url === "string" && typeof target.pathname === "string" && typeof target.connected === "boolean" && (target.runtimeClientId === void 0 || typeof target.runtimeClientId === "string");
 }
 function isConsoleRecord(payload) {
   if (!payload || typeof payload !== "object") {