@weapp-vite/mcp 1.5.8 → 2.1.0

package/README.md

@@ -19,6 +19,8 @@
 
 ## 启动
 
+直接使用 `@weapp-vite/mcp` 或 `@weapp-vite/acceptance` 需要 **Node.js >=22.12.0**。这两个包不再支持 Node 20；通过 `weapp-vite` 命令使用时，还须满足 `weapp-vite` 自身的 Node 范围 `^22.18.0 || ^24.11.0 || >=26.0.0`。
+
 ```bash
 pnpm --filter @weapp-vite/mcp start
 ```

package/dist/index.d.ts

@@ -1,222 +1,254 @@
-import { DevtoolsRuntimeHooks } from '@weapp-vite/devtools-runtime';
-import { McpServer } from '@modelcontextprotocol/server';
-
-declare const MCP_SERVER_NAME = "@weapp-vite/mcp";
-declare const MCP_SERVER_VERSION = "2.0.0";
-declare const EXPOSED_PACKAGES: {
-    readonly 'weapp-vite': {
-        readonly id: "weapp-vite";
-        readonly label: "weapp-vite";
-        readonly packageName: "weapp-vite";
-        readonly relativePath: string;
-    };
-    readonly wevu: {
-        readonly id: "wevu";
-        readonly label: "wevu";
-        readonly packageName: "wevu";
-        readonly relativePath: string;
-    };
-    readonly 'wevu-compiler': {
-        readonly id: "wevu-compiler";
-        readonly label: "wevu-compiler";
-        readonly packageName: "@wevu/compiler";
-        readonly relativePath: string;
-    };
-};
-type ExposedPackageId = keyof typeof EXPOSED_PACKAGES;
-declare const DEFAULT_TIMEOUT_MS = 120000;
-declare const DEFAULT_MAX_OUTPUT_CHARS = 120000;
-declare const DEFAULT_MAX_FILE_CHARS = 80000;
-declare const DEFAULT_MAX_RESULTS = 200;
-declare const SKIPPED_DIR_NAMES: Set<string>;
-
-interface ResolvedExposedPackage {
-    id: ExposedPackageId;
-    label: string;
-    packageName: string;
-    version: string;
-    absolutePath: string;
-    relativePath: string;
-    scripts: string[];
-    docs: {
-        readme?: string;
-        changelog?: string;
-    };
-    sourceRoot?: string;
-    cliPath?: string;
-}
-
-interface ExposedPackageSummary extends ResolvedExposedPackage {
-}
-declare function loadPackageSummary(workspaceRoot: string, id: ExposedPackageId): Promise<ExposedPackageSummary>;
-declare function loadExposedCatalog(workspaceRoot: string): Promise<ResolvedExposedPackage[]>;
-
-interface CommandResult {
-    command: string;
-    args: string[];
-    cwd: string;
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-    timedOut: boolean;
-}
-declare function runCommand(workspaceRoot: string, command: string, args: string[], options?: {
-    cwdRelative?: string;
-    timeoutMs?: number;
-    maxOutputChars?: number;
-}): Promise<CommandResult>;
-
-interface SearchMatch {
-    filePath: string;
-    line: number;
-    column: number;
-    text: string;
-}
-declare function listFilesInDirectory(root: string, relativeDirectory?: string, maxResults?: number): Promise<string[]>;
-declare function readFileContent(root: string, relativeFilePath: string, options?: {
-    startLine?: number;
-    endLine?: number;
-    maxChars?: number;
-}): Promise<{
-    filePath: string;
-    content: string;
-}>;
-declare function searchTextInDirectory(root: string, query: string, options?: {
-    relativeDirectory?: string;
-    maxResults?: number;
-}): Promise<SearchMatch[]>;
-
+import { McpServer } from "@modelcontextprotocol/server";
+import { DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT } from "@weapp-core/constants";
+import { AcceptanceOptions, AcceptanceService, RuntimeConnector } from "@weapp-vite/acceptance";
+import { z } from "zod";
+import { DevtoolsRuntimeHooks } from "@weapp-vite/devtools-runtime";
+import { Buffer } from "node:buffer";
+import { WechatDevtoolsSelectionOptions } from "weapp-ide-cli";
+//#region src/server/runtime/shared.d.ts
 interface MiniProgramElement {
-    tagName?: string;
-    $?: (selector: string) => Promise<MiniProgramElement | null>;
-    $$?: (selector: string) => Promise<MiniProgramElement[]>;
-    tap: () => Promise<void>;
+  tagName?: string;
+  $?: (selector: string) => Promise<MiniProgramElement | null>;
+  $$?: (selector: string) => Promise<MiniProgramElement[]>;
+  tap: () => Promise<void>;
 }
 interface MiniProgramPage {
-    path: string;
-    query?: unknown;
-    $: (selector: string, options?: MiniProgramPageQueryOptions) => Promise<MiniProgramElement | null>;
-    $$?: (selector: string, options?: MiniProgramPageQueryOptions) => Promise<MiniProgramElement[]>;
-    data: (path?: string) => Promise<unknown>;
-    size: () => Promise<unknown>;
-    scrollTop: () => Promise<unknown>;
-    waitFor: (milliseconds: number) => Promise<void>;
+  path: string;
+  query?: unknown;
+  $: (selector: string, options?: MiniProgramPageQueryOptions) => Promise<MiniProgramElement | null>;
+  $$?: (selector: string, options?: MiniProgramPageQueryOptions) => Promise<MiniProgramElement[]>;
+  data: (path?: string) => Promise<unknown>;
+  size: () => Promise<unknown>;
+  scrollTop: () => Promise<unknown>;
+  waitFor: (milliseconds: number) => Promise<void>;
 }
 interface MiniProgramPageQueryOptions {
-    fallback?: boolean;
+  fallback?: boolean;
 }
 interface MiniProgramLike {
-    on: (name: 'console' | 'exception', handler: (payload: unknown) => void) => void;
-    off?: (name: 'console' | 'exception', handler: (payload: unknown) => void) => void;
-    currentPage: () => Promise<MiniProgramPage>;
-    systemInfo: () => Promise<unknown>;
-    pageStack: () => Promise<MiniProgramPage[]>;
-    navigateTo: (url: string) => Promise<MiniProgramPage>;
-    redirectTo: (url: string) => Promise<MiniProgramPage>;
-    reLaunch: (url: string) => Promise<MiniProgramPage>;
-    switchTab: (url: string) => Promise<MiniProgramPage>;
-    navigateBack: () => Promise<MiniProgramPage>;
-    screenshot: (options?: {
-        timeout?: number;
-    }) => Promise<string | Uint8Array | undefined>;
-    callWxMethod: (method: string, ...args: unknown[]) => Promise<unknown>;
-}
-interface RuntimeConnectionInput {
-    projectPath: string;
+  on: (name: 'console' | 'exception', handler: (payload: unknown) => void) => void;
+  off?: (name: 'console' | 'exception', handler: (payload: unknown) => void) => void;
+  currentPage: () => Promise<MiniProgramPage>;
+  systemInfo: () => Promise<unknown>;
+  pageStack: () => Promise<MiniProgramPage[]>;
+  navigateTo: (url: string) => Promise<MiniProgramPage>;
+  redirectTo: (url: string) => Promise<MiniProgramPage>;
+  reLaunch: (url: string) => Promise<MiniProgramPage>;
+  switchTab: (url: string) => Promise<MiniProgramPage>;
+  navigateBack: () => Promise<MiniProgramPage>;
+  screenshot: (options?: {
     timeout?: number;
-    port?: number;
-    preferOpenedSession?: boolean;
-    preserveProjectRoot?: boolean;
-    sessionId?: string;
+  }) => Promise<string | Uint8Array | undefined>;
+  callWxMethod: (method: string, ...args: unknown[]) => Promise<unknown>;
+}
+interface RuntimeConnectionInput extends WechatDevtoolsSelectionOptions {
+  cliPath?: string;
+  installationId?: string;
+  runtimeProvider?: 'devtools' | 'headless';
+  projectPath: string;
+  timeout?: number;
+  port?: number;
+  preferOpenedSession?: boolean;
+  preserveProjectRoot?: boolean;
+  sessionId?: string;
 }
 interface RuntimeConsoleLogEntry {
-    level: string;
-    message: string;
-    timestamp: number;
-    raw: unknown;
+  level: string;
+  message: string;
+  timestamp: number;
+  raw: unknown;
+  projectPath?: string;
+  sessionKey?: string;
+  sequence?: number;
 }
 declare class RuntimeSessionManager {
-    private readonly workspaceRoot;
-    private readonly runtimeHooks;
-    private readonly logs;
-    private readonly attachedSessions;
-    private readonly maxLogs;
-    constructor(workspaceRoot: string, runtimeHooks?: DevtoolsRuntimeHooks);
-    close(input: RuntimeConnectionInput): Promise<void>;
-    clearLogs(): void;
-    getLogs(): RuntimeConsoleLogEntry[];
-    resolveProjectPath(projectPath: string): string;
-    resolveWorkspacePath(filePath: string): string;
-    withMiniProgram<T>(input: RuntimeConnectionInput, runner: (miniProgram: MiniProgramLike) => Promise<T>): Promise<T>;
-    withPage<T>(input: RuntimeConnectionInput, runner: (page: MiniProgramPage, miniProgram: MiniProgramLike) => Promise<T>): Promise<T>;
-    rememberPage(input: RuntimeConnectionInput, page: MiniProgramPage | null | undefined): void;
-    private resolveSessionKey;
-    private attach;
-    private resolveCurrentPage;
-    private detach;
-    private pushLog;
+  private readonly workspaceRoot;
+  private readonly runtimeHooks;
+  private readonly resolvedInputs;
+  private readonly resolvedSessionKeys;
+  private readonly logs;
+  private readonly attachedSessions;
+  private readonly maxLogs;
+  private logSequence;
+  private readonly ownedSessions;
+  constructor(workspaceRoot: string, runtimeHooks?: DevtoolsRuntimeHooks);
+  close(input: RuntimeConnectionInput): Promise<void>;
+  clearLogs(): void;
+  getLogs(projectPath?: string, afterSequence?: number): RuntimeConsoleLogEntry[];
+  getLogCursor(): number;
+  prepareProject(projectPath: string, signal: AbortSignal): Promise<void>;
+  fork(workspaceRoot?: string): RuntimeSessionManager;
+  dispose(): Promise<void>;
+  resolveProjectPath(projectPath: string): string;
+  resolveWorkspacePath(filePath: string): string;
+  withMiniProgram<T>(input: RuntimeConnectionInput, runner: (miniProgram: MiniProgramLike) => Promise<T>): Promise<T>;
+  withPage<T>(input: RuntimeConnectionInput, runner: (page: MiniProgramPage, miniProgram: MiniProgramLike) => Promise<T>): Promise<T>;
+  rememberPage(input: RuntimeConnectionInput, page: MiniProgramPage | null | undefined): void;
+  private selectionKey;
+  private resolveInput;
+  private resolveSessionKey;
+  private attach;
+  private resolveCurrentPage;
+  private detach;
+  private pushLog;
+}
+//#endregion
+//#region src/acceptance.d.ts
+export declare function acceptanceRuntime(parent: RuntimeSessionManager): RuntimeConnector;
+export declare function createRuntimeAcceptanceService(root: string, options?: AcceptanceOptions, hooks?: DevtoolsRuntimeHooks): Promise<AcceptanceService>;
+//#endregion
+//#region src/constants.d.ts
+export declare const MCP_SERVER_NAME = "@weapp-vite/mcp";
+export declare const MCP_SERVER_VERSION: string;
+export declare const EXPOSED_PACKAGES: {
+  readonly 'weapp-vite': {
+    readonly id: "weapp-vite";
+    readonly label: "weapp-vite";
+    readonly packageName: "weapp-vite";
+    readonly relativePath: string;
+  };
+  readonly wevu: {
+    readonly id: "wevu";
+    readonly label: "wevu";
+    readonly packageName: "wevu";
+    readonly relativePath: string;
+  };
+  readonly 'wevu-compiler': {
+    readonly id: "wevu-compiler";
+    readonly label: "wevu-compiler";
+    readonly packageName: "@wevu/compiler";
+    readonly relativePath: string;
+  };
+};
+export type ExposedPackageId = keyof typeof EXPOSED_PACKAGES;
+export declare const DEFAULT_TIMEOUT_MS = 120000;
+export declare const DEFAULT_MAX_OUTPUT_CHARS = 120000;
+export declare const DEFAULT_MAX_FILE_CHARS = 80000;
+export declare const DEFAULT_MAX_RESULTS = 200;
+export declare const SKIPPED_DIR_NAMES: Set<string>;
+//#endregion
+//#region src/exposedPackages.d.ts
+interface ResolvedExposedPackage {
+  id: ExposedPackageId;
+  label: string;
+  packageName: string;
+  version: string;
+  absolutePath: string;
+  relativePath: string;
+  scripts: string[];
+  docs: {
+    readme?: string;
+    changelog?: string;
+  };
+  sourceRoot?: string;
+  cliPath?: string;
+}
+//#endregion
+//#region src/catalog.d.ts
+export interface ExposedPackageSummary extends ResolvedExposedPackage {}
+export declare function loadPackageSummary(workspaceRoot: string, id: ExposedPackageId): Promise<ExposedPackageSummary>;
+export declare function loadExposedCatalog(workspaceRoot: string): Promise<ResolvedExposedPackage[]>;
+//#endregion
+//#region src/commandOps.d.ts
+export interface CommandResult {
+  command: string;
+  args: string[];
+  cwd: string;
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+  timedOut: boolean;
+}
+export declare function runCommand(workspaceRoot: string, command: string, args: string[], options?: {
+  cwdRelative?: string;
+  timeoutMs?: number;
+  maxOutputChars?: number;
+}): Promise<CommandResult>;
+//#endregion
+//#region src/fileOps.d.ts
+export interface SearchMatch {
+  filePath: string;
+  line: number;
+  column: number;
+  text: string;
 }
-
-interface CreateServerOptions {
-    runtimeHooks?: DevtoolsRuntimeHooks;
-    workspaceRoot?: string;
+export declare function listFilesInDirectory(root: string, relativeDirectory?: string, maxResults?: number): Promise<string[]>;
+export declare function readFileContent(root: string, relativeFilePath: string, options?: {
+  startLine?: number;
+  endLine?: number;
+  maxChars?: number;
+}): Promise<{
+  filePath: string;
+  content: string;
+}>;
+export declare function searchTextInDirectory(root: string, query: string, options?: {
+  relativeDirectory?: string;
+  maxResults?: number;
+}): Promise<SearchMatch[]>;
+//#endregion
+//#region src/server/index.d.ts
+export interface CreateServerOptions {
+  runtimeHooks?: DevtoolsRuntimeHooks;
+  workspaceRoot?: string;
 }
-interface WeappViteMcpServerFactory {
-    createServer: () => McpServer;
-    runtimeManager: RuntimeSessionManager;
-    workspaceRoot: string;
+export interface WeappViteMcpServerFactory {
+  createServer: () => McpServer;
+  runtimeManager: RuntimeSessionManager;
+  workspaceRoot: string;
+  close: () => Promise<void>;
 }
-declare function createWeappViteMcpServerFactory(options?: CreateServerOptions): Promise<WeappViteMcpServerFactory>;
-declare function createWeappViteMcpServer(options?: CreateServerOptions): Promise<{
-    runtimeManager: RuntimeSessionManager;
-    server: McpServer;
-    workspaceRoot: string;
+export declare function createWeappViteMcpServerFactory(options?: CreateServerOptions): Promise<WeappViteMcpServerFactory>;
+export declare function createWeappViteMcpServer(options?: CreateServerOptions): Promise<{
+  close: () => Promise<void>;
+  runtimeManager: RuntimeSessionManager;
+  server: McpServer;
+  workspaceRoot: string;
 }>;
-
-declare const DEFAULT_RUNTIME_REST_ENDPOINT = "/api/weapp/devtools";
-
-declare const DEFAULT_MCP_HOST = "127.0.0.1";
-declare const DEFAULT_MCP_PORT = 3088;
-declare const DEFAULT_MCP_ENDPOINT = "/mcp";
-interface StartMcpServerOptions extends CreateServerOptions {
-    transport?: 'stdio' | 'streamable-http';
-    host?: string;
-    port?: number;
-    endpoint?: string;
-    restEndpoint?: string | false;
-    unref?: boolean;
-    quiet?: boolean;
-    onReady?: (message: string) => void;
+//#endregion
+//#region src/runtime.d.ts
+export interface StartMcpServerOptions extends CreateServerOptions {
+  transport?: 'stdio' | 'streamable-http';
+  host?: string;
+  port?: number;
+  endpoint?: string;
+  restEndpoint?: string | false;
+  unref?: boolean;
+  quiet?: boolean;
+  onReady?: (message: string) => void;
 }
-interface McpServerHandle {
-    transport: 'stdio' | 'streamable-http';
-    close?: () => Promise<void>;
+export interface McpServerHandle {
+  transport: 'stdio' | 'streamable-http';
+  close?: () => Promise<void>;
 }
-declare function startStdioServer(options?: CreateServerOptions): Promise<McpServerHandle>;
-declare function startWeappViteMcpServer(options?: StartMcpServerOptions): Promise<McpServerHandle>;
-
-declare function formatJson(value: unknown): string;
-declare function normalizeErrorMessage(error: unknown): string;
-declare function toToolResult(data: unknown, text?: string): {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: {
-        result: unknown;
-    };
+export declare function startStdioServer(options?: CreateServerOptions): Promise<McpServerHandle>;
+export declare function startWeappViteMcpServer(options?: StartMcpServerOptions): Promise<McpServerHandle>;
+//#endregion
+//#region src/server/acceptance.d.ts
+export declare function registerAcceptanceTools(server: McpServer, service: () => Promise<AcceptanceService>): McpServer;
+//#endregion
+//#region src/utils.d.ts
+export declare function formatJson(value: unknown): string;
+export declare function normalizeErrorMessage(error: unknown): string;
+export declare function toToolResult(data: unknown, text?: string): {
+  content: {
+    type: "text";
+    text: string;
+  }[];
+  structuredContent: {
+    result: unknown;
+  };
 };
-declare function toToolError(error: unknown): {
-    isError: boolean;
-    content: {
-        type: "text";
-        text: string;
-    }[];
+export declare function toToolError(error: unknown): {
+  isError: boolean;
+  content: {
+    type: "text";
+    text: string;
+  }[];
 };
-
-declare function resolveWorkspaceRoot(start?: string): string;
-declare function assertInsideRoot(root: string, targetPath: string): string;
-declare function resolveSubPath(root: string, relativePath: string): string;
-
-export { DEFAULT_MAX_FILE_CHARS, DEFAULT_MAX_OUTPUT_CHARS, DEFAULT_MAX_RESULTS, DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT, DEFAULT_TIMEOUT_MS, EXPOSED_PACKAGES, MCP_SERVER_NAME, MCP_SERVER_VERSION, SKIPPED_DIR_NAMES, assertInsideRoot, createWeappViteMcpServer, createWeappViteMcpServerFactory, formatJson, listFilesInDirectory, loadExposedCatalog, loadPackageSummary, normalizeErrorMessage, readFileContent, resolveSubPath, resolveWorkspaceRoot, runCommand, searchTextInDirectory, startStdioServer, startWeappViteMcpServer, toToolError, toToolResult };
-export type { CommandResult, CreateServerOptions, ExposedPackageId, ExposedPackageSummary, McpServerHandle, SearchMatch, StartMcpServerOptions, WeappViteMcpServerFactory };
+//#endregion
+//#region src/workspace.d.ts
+export declare function resolveWorkspaceRoot(start?: string): string;
+export declare function assertInsideRoot(root: string, targetPath: string): string;
+export declare function resolveSubPath(root: string, relativePath: string): string;
+//#endregion
+export { DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT };