@weapp-vite/mcp 1.5.8 → 2.0.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.mts

@@ -1,5 +1,96 @@
+import { RuntimeConnector, AcceptanceOptions, AcceptanceService } from '@weapp-vite/acceptance';
 import { DevtoolsRuntimeHooks } from '@weapp-vite/devtools-runtime';
 import { McpServer } from '@modelcontextprotocol/server';
+export { DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT } from '@weapp-core/constants';
+
+interface MiniProgramElement {
+    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>;
+}
+interface MiniProgramPageQueryOptions {
+    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 {
+    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;
+    projectPath?: string;
+    sessionKey?: string;
+    sequence?: number;
+}
+declare class RuntimeSessionManager {
+    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 resolveInput;
+    private resolveSessionKey;
+    private attach;
+    private resolveCurrentPage;
+    private detach;
+    private pushLog;
+}
+
+declare function acceptanceRuntime(parent: RuntimeSessionManager): RuntimeConnector;
+declare function createRuntimeAcceptanceService(root: string, options?: AcceptanceOptions, hooks?: DevtoolsRuntimeHooks): Promise<AcceptanceService>;
 
 declare const MCP_SERVER_NAME = "@weapp-vite/mcp";
 declare const MCP_SERVER_VERSION = "2.0.0";
@@ -86,77 +177,6 @@ declare function searchTextInDirectory(root: string, query: string, options?: {
     maxResults?: number;
 }): Promise<SearchMatch[]>;
 
-interface MiniProgramElement {
-    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>;
-}
-interface MiniProgramPageQueryOptions {
-    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;
-    timeout?: number;
-    port?: number;
-    preferOpenedSession?: boolean;
-    preserveProjectRoot?: boolean;
-    sessionId?: string;
-}
-interface RuntimeConsoleLogEntry {
-    level: string;
-    message: string;
-    timestamp: number;
-    raw: unknown;
-}
-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;
-}
-
 interface CreateServerOptions {
     runtimeHooks?: DevtoolsRuntimeHooks;
     workspaceRoot?: string;
@@ -165,19 +185,16 @@ interface WeappViteMcpServerFactory {
     createServer: () => McpServer;
     runtimeManager: RuntimeSessionManager;
     workspaceRoot: string;
+    close: () => Promise<void>;
 }
 declare function createWeappViteMcpServerFactory(options?: CreateServerOptions): Promise<WeappViteMcpServerFactory>;
 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;
@@ -195,6 +212,8 @@ interface McpServerHandle {
 declare function startStdioServer(options?: CreateServerOptions): Promise<McpServerHandle>;
 declare function startWeappViteMcpServer(options?: StartMcpServerOptions): Promise<McpServerHandle>;
 
+declare function registerAcceptanceTools(server: McpServer, service: () => Promise<AcceptanceService>): McpServer;
+
 declare function formatJson(value: unknown): string;
 declare function normalizeErrorMessage(error: unknown): string;
 declare function toToolResult(data: unknown, text?: string): {
@@ -218,5 +237,5 @@ 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 { DEFAULT_MAX_FILE_CHARS, DEFAULT_MAX_OUTPUT_CHARS, DEFAULT_MAX_RESULTS, DEFAULT_TIMEOUT_MS, EXPOSED_PACKAGES, MCP_SERVER_NAME, MCP_SERVER_VERSION, SKIPPED_DIR_NAMES, acceptanceRuntime, assertInsideRoot, createRuntimeAcceptanceService, createWeappViteMcpServer, createWeappViteMcpServerFactory, formatJson, listFilesInDirectory, loadExposedCatalog, loadPackageSummary, normalizeErrorMessage, readFileContent, registerAcceptanceTools, resolveSubPath, resolveWorkspaceRoot, runCommand, searchTextInDirectory, startStdioServer, startWeappViteMcpServer, toToolError, toToolResult };
 export type { CommandResult, CreateServerOptions, ExposedPackageId, ExposedPackageSummary, McpServerHandle, SearchMatch, StartMcpServerOptions, WeappViteMcpServerFactory };

package/dist/index.d.ts

@@ -1,5 +1,96 @@
+import { RuntimeConnector, AcceptanceOptions, AcceptanceService } from '@weapp-vite/acceptance';
 import { DevtoolsRuntimeHooks } from '@weapp-vite/devtools-runtime';
 import { McpServer } from '@modelcontextprotocol/server';
+export { DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT } from '@weapp-core/constants';
+
+interface MiniProgramElement {
+    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>;
+}
+interface MiniProgramPageQueryOptions {
+    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 {
+    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;
+    projectPath?: string;
+    sessionKey?: string;
+    sequence?: number;
+}
+declare class RuntimeSessionManager {
+    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 resolveInput;
+    private resolveSessionKey;
+    private attach;
+    private resolveCurrentPage;
+    private detach;
+    private pushLog;
+}
+
+declare function acceptanceRuntime(parent: RuntimeSessionManager): RuntimeConnector;
+declare function createRuntimeAcceptanceService(root: string, options?: AcceptanceOptions, hooks?: DevtoolsRuntimeHooks): Promise<AcceptanceService>;
 
 declare const MCP_SERVER_NAME = "@weapp-vite/mcp";
 declare const MCP_SERVER_VERSION = "2.0.0";
@@ -86,77 +177,6 @@ declare function searchTextInDirectory(root: string, query: string, options?: {
     maxResults?: number;
 }): Promise<SearchMatch[]>;
 
-interface MiniProgramElement {
-    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>;
-}
-interface MiniProgramPageQueryOptions {
-    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;
-    timeout?: number;
-    port?: number;
-    preferOpenedSession?: boolean;
-    preserveProjectRoot?: boolean;
-    sessionId?: string;
-}
-interface RuntimeConsoleLogEntry {
-    level: string;
-    message: string;
-    timestamp: number;
-    raw: unknown;
-}
-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;
-}
-
 interface CreateServerOptions {
     runtimeHooks?: DevtoolsRuntimeHooks;
     workspaceRoot?: string;
@@ -165,19 +185,16 @@ interface WeappViteMcpServerFactory {
     createServer: () => McpServer;
     runtimeManager: RuntimeSessionManager;
     workspaceRoot: string;
+    close: () => Promise<void>;
 }
 declare function createWeappViteMcpServerFactory(options?: CreateServerOptions): Promise<WeappViteMcpServerFactory>;
 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;
@@ -195,6 +212,8 @@ interface McpServerHandle {
 declare function startStdioServer(options?: CreateServerOptions): Promise<McpServerHandle>;
 declare function startWeappViteMcpServer(options?: StartMcpServerOptions): Promise<McpServerHandle>;
 
+declare function registerAcceptanceTools(server: McpServer, service: () => Promise<AcceptanceService>): McpServer;
+
 declare function formatJson(value: unknown): string;
 declare function normalizeErrorMessage(error: unknown): string;
 declare function toToolResult(data: unknown, text?: string): {
@@ -218,5 +237,5 @@ 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 { DEFAULT_MAX_FILE_CHARS, DEFAULT_MAX_OUTPUT_CHARS, DEFAULT_MAX_RESULTS, DEFAULT_TIMEOUT_MS, EXPOSED_PACKAGES, MCP_SERVER_NAME, MCP_SERVER_VERSION, SKIPPED_DIR_NAMES, acceptanceRuntime, assertInsideRoot, createRuntimeAcceptanceService, createWeappViteMcpServer, createWeappViteMcpServerFactory, formatJson, listFilesInDirectory, loadExposedCatalog, loadPackageSummary, normalizeErrorMessage, readFileContent, registerAcceptanceTools, resolveSubPath, resolveWorkspaceRoot, runCommand, searchTextInDirectory, startStdioServer, startWeappViteMcpServer, toToolError, toToolResult };
 export type { CommandResult, CreateServerOptions, ExposedPackageId, ExposedPackageSummary, McpServerHandle, SearchMatch, StartMcpServerOptions, WeappViteMcpServerFactory };