@creatoria/miniapp-mcp 0.1.0

package/dist/config/defaults.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Default configuration values for the MCP server
+ */
+import type { ServerConfig, SessionConfig } from '../types.js';
+/**
+ * Default CLI path for WeChat DevTools on macOS
+ */
+export declare const DEFAULT_CLI_PATH_MACOS = "/Applications/wechatwebdevtools.app/Contents/MacOS/cli";
+/**
+ * Default automation port for WeChat DevTools
+ */
+export declare const DEFAULT_AUTOMATION_PORT = 9420;
+/**
+ * Default output directory for artifacts (relative to cwd)
+ */
+export declare const DEFAULT_OUTPUT_DIR = ".mcp-artifacts";
+/**
+ * Default session timeout (30 minutes in milliseconds)
+ */
+export declare const DEFAULT_SESSION_TIMEOUT: number;
+/**
+ * Default global timeout for operations (30 seconds in milliseconds)
+ */
+export declare const DEFAULT_TIMEOUT: number;
+/**
+ * Default timeout for evaluate operations (5 seconds in milliseconds)
+ */
+export declare const DEFAULT_EVALUATE_TIMEOUT: number;
+/**
+ * Default timeout for launch operations (60 seconds in milliseconds)
+ */
+export declare const DEFAULT_LAUNCH_TIMEOUT: number;
+/**
+ * Default timeout for screenshot operations (10 seconds in milliseconds)
+ */
+export declare const DEFAULT_SCREENSHOT_TIMEOUT: number;
+/**
+ * Default capabilities (all tools enabled)
+ */
+export declare const DEFAULT_CAPABILITIES: string[];
+/**
+ * Default log level
+ */
+export declare const DEFAULT_LOG_LEVEL: "info";
+/**
+ * Default log buffer size (number of log entries)
+ */
+export declare const DEFAULT_LOG_BUFFER_SIZE = 100;
+/**
+ * Default log flush interval (5 seconds in milliseconds)
+ */
+export declare const DEFAULT_LOG_FLUSH_INTERVAL = 5000;
+/**
+ * Default server configuration
+ */
+export declare const DEFAULT_SERVER_CONFIG: Required<ServerConfig>;
+/**
+ * Default session configuration
+ */
+export declare const DEFAULT_SESSION_CONFIG: Required<SessionConfig>;
+/**
+ * Get default CLI path for current platform
+ */
+export declare function getDefaultCliPath(): string;
+/**
+ * Merge user config with defaults for server config
+ */
+export declare function mergeServerConfig(userConfig: Partial<ServerConfig>): Required<ServerConfig>;
+/**
+ * Merge user config with defaults for session config
+ */
+export declare function mergeSessionConfig(userConfig: Partial<SessionConfig>): Required<SessionConfig>;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE9D;;GAEG;AACH,eAAO,MAAM,sBAAsB,2DAA2D,CAAA;AAE9F;;GAEG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAA;AAE3C;;GAEG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAA;AAElD;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAiB,CAAA;AAErD;;GAEG;AACH,eAAO,MAAM,eAAe,QAAY,CAAA;AAExC;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAW,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAAY,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,0BAA0B,QAAY,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,oBAAoB,UAAW,CAAA;AAE5C;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAG,MAAe,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,0BAA0B,OAAO,CAAA;AAE9C;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAexD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,aAAa,CAQ1D,CAAA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAO1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAS3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,CAO9F"}

package/dist/config/defaults.js

@@ -0,0 +1,118 @@
+/**
+ * Default configuration values for the MCP server
+ */
+/**
+ * Default CLI path for WeChat DevTools on macOS
+ */
+export const DEFAULT_CLI_PATH_MACOS = '/Applications/wechatwebdevtools.app/Contents/MacOS/cli';
+/**
+ * Default automation port for WeChat DevTools
+ */
+export const DEFAULT_AUTOMATION_PORT = 9420;
+/**
+ * Default output directory for artifacts (relative to cwd)
+ */
+export const DEFAULT_OUTPUT_DIR = '.mcp-artifacts';
+/**
+ * Default session timeout (30 minutes in milliseconds)
+ */
+export const DEFAULT_SESSION_TIMEOUT = 30 * 60 * 1000;
+/**
+ * Default global timeout for operations (30 seconds in milliseconds)
+ */
+export const DEFAULT_TIMEOUT = 30 * 1000;
+/**
+ * Default timeout for evaluate operations (5 seconds in milliseconds)
+ */
+export const DEFAULT_EVALUATE_TIMEOUT = 5 * 1000;
+/**
+ * Default timeout for launch operations (60 seconds in milliseconds)
+ */
+export const DEFAULT_LAUNCH_TIMEOUT = 60 * 1000;
+/**
+ * Default timeout for screenshot operations (10 seconds in milliseconds)
+ */
+export const DEFAULT_SCREENSHOT_TIMEOUT = 10 * 1000;
+/**
+ * Default capabilities (all tools enabled)
+ */
+export const DEFAULT_CAPABILITIES = ['core'];
+/**
+ * Default log level
+ */
+export const DEFAULT_LOG_LEVEL = 'info';
+/**
+ * Default log buffer size (number of log entries)
+ */
+export const DEFAULT_LOG_BUFFER_SIZE = 100;
+/**
+ * Default log flush interval (5 seconds in milliseconds)
+ */
+export const DEFAULT_LOG_FLUSH_INTERVAL = 5000;
+/**
+ * Default server configuration
+ */
+export const DEFAULT_SERVER_CONFIG = {
+    projectPath: '', // Must be provided by user
+    cliPath: process.platform === 'darwin' ? DEFAULT_CLI_PATH_MACOS : '',
+    port: DEFAULT_AUTOMATION_PORT,
+    autoPort: DEFAULT_AUTOMATION_PORT, // Alias for port
+    capabilities: DEFAULT_CAPABILITIES,
+    outputDir: DEFAULT_OUTPUT_DIR,
+    timeout: DEFAULT_TIMEOUT,
+    sessionTimeout: DEFAULT_SESSION_TIMEOUT,
+    logLevel: DEFAULT_LOG_LEVEL,
+    enableFileLog: false,
+    logBufferSize: DEFAULT_LOG_BUFFER_SIZE,
+    logFlushInterval: DEFAULT_LOG_FLUSH_INTERVAL,
+    enableSessionReport: false, // F3: Session report generation (default: disabled)
+    enableFailureSnapshot: false, // F2: Automatic failure snapshot capture (default: disabled)
+};
+/**
+ * Default session configuration
+ */
+export const DEFAULT_SESSION_CONFIG = {
+    projectPath: '', // Must be provided by user
+    cliPath: process.platform === 'darwin' ? DEFAULT_CLI_PATH_MACOS : '',
+    port: DEFAULT_AUTOMATION_PORT,
+    timeout: DEFAULT_TIMEOUT,
+    evaluateTimeout: DEFAULT_EVALUATE_TIMEOUT,
+    launchTimeout: DEFAULT_LAUNCH_TIMEOUT,
+    screenshotTimeout: DEFAULT_SCREENSHOT_TIMEOUT,
+};
+/**
+ * Get default CLI path for current platform
+ */
+export function getDefaultCliPath() {
+    if (process.platform === 'darwin') {
+        return DEFAULT_CLI_PATH_MACOS;
+    }
+    // Windows and Linux paths are not standardized
+    // User must provide via config
+    return '';
+}
+/**
+ * Merge user config with defaults for server config
+ */
+export function mergeServerConfig(userConfig) {
+    return {
+        ...DEFAULT_SERVER_CONFIG,
+        ...userConfig,
+        // Ensure cliPath has a sensible default if not provided
+        cliPath: userConfig.cliPath || getDefaultCliPath(),
+        // Ensure capabilities is always an array
+        capabilities: userConfig.capabilities || DEFAULT_CAPABILITIES,
+    };
+}
+/**
+ * Merge user config with defaults for session config
+ */
+export function mergeSessionConfig(userConfig) {
+    return {
+        ...DEFAULT_SESSION_CONFIG,
+        ...userConfig,
+        // Ensure cliPath has a sensible default if not provided
+        cliPath: userConfig.cliPath || getDefaultCliPath(),
+    };
+}
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"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"}

package/dist/config/loader.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Configuration loader with support for files, environment variables, and CLI args
+ * Priority: CLI args > Environment variables > Config file > Defaults
+ */
+import type { ServerConfig } from '../types.js';
+/**
+ * Find config file in current directory or parent directories
+ */
+export declare function findConfigFile(startDir?: string): string | null;
+/**
+ * Auto-detect miniprogram project path
+ * Searches for project.config.json or app.json in current dir and subdirectories
+ */
+export declare function autoDetectProjectPath(startDir?: string): string | null;
+/**
+ * Load config from file
+ */
+export declare function loadConfigFile(filePath: string): Partial<ServerConfig>;
+/**
+ * Load config from environment variables
+ * Supported variables:
+ * - MCP_PROJECT_PATH
+ * - MCP_CLI_PATH
+ * - MCP_PORT
+ * - MCP_CAPABILITIES (comma-separated)
+ * - MCP_OUTPUT_DIR
+ * - MCP_TIMEOUT
+ * - MCP_SESSION_TIMEOUT
+ */
+export declare function loadConfigFromEnv(): Partial<ServerConfig>;
+/**
+ * Merge configs with priority: cliConfig > envConfig > fileConfig > defaults
+ */
+export declare function mergeConfigs(fileConfig?: Partial<ServerConfig>, envConfig?: Partial<ServerConfig>, cliConfig?: Partial<ServerConfig>): Required<ServerConfig>;
+/**
+ * Load complete configuration from all sources
+ *
+ * @param options - Optional overrides
+ * @param options.configPath - Explicit config file path (skips auto-discovery)
+ * @param options.cliConfig - CLI arguments config
+ * @param options.skipEnv - Skip loading from environment variables
+ * @param options.skipFile - Skip loading from config file
+ */
+export declare function loadConfig(options?: {
+    configPath?: string;
+    cliConfig?: Partial<ServerConfig>;
+    skipEnv?: boolean;
+    skipFile?: boolean;
+}): Required<ServerConfig>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAc/C;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAoB9E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAwBrF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,YAAY,CAAC,CAyCzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,GAAE,OAAO,CAAC,YAAY,CAAM,EACtC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,EACrC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GACpC,QAAQ,CAAC,YAAY,CAAC,CAYxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACd,GACL,QAAQ,CAAC,YAAY,CAAC,CAwCxB"}

package/dist/config/loader.js

@@ -0,0 +1,189 @@
+/**
+ * Configuration loader with support for files, environment variables, and CLI args
+ * Priority: CLI args > Environment variables > Config file > Defaults
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { mergeServerConfig } from './defaults.js';
+/**
+ * Config file names to search for (in order of priority)
+ */
+const CONFIG_FILE_NAMES = ['.mcp.json', 'mcp.config.json', '.mcp.config.json'];
+/**
+ * Environment variable prefix
+ * @unused Reserved for future environment variable support
+ */
+const _ENV_PREFIX = 'MCP_';
+/**
+ * Find config file in current directory or parent directories
+ */
+export function findConfigFile(startDir = process.cwd()) {
+    let currentDir = startDir;
+    // Search up to 5 levels
+    for (let i = 0; i < 5; i++) {
+        for (const fileName of CONFIG_FILE_NAMES) {
+            const filePath = join(currentDir, fileName);
+            if (existsSync(filePath)) {
+                return filePath;
+            }
+        }
+        const parentDir = join(currentDir, '..');
+        if (parentDir === currentDir) {
+            break; // Reached root
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Auto-detect miniprogram project path
+ * Searches for project.config.json or app.json in current dir and subdirectories
+ */
+export function autoDetectProjectPath(startDir = process.cwd()) {
+    const indicators = ['project.config.json', 'app.json'];
+    // Check current directory first
+    for (const indicator of indicators) {
+        if (existsSync(join(startDir, indicator))) {
+            return startDir;
+        }
+    }
+    // Check common subdirectories
+    const commonDirs = ['dist', 'build', 'miniprogram', 'src'];
+    for (const dir of commonDirs) {
+        const subDir = join(startDir, dir);
+        if (existsSync(subDir)) {
+            for (const indicator of indicators) {
+                if (existsSync(join(subDir, indicator))) {
+                    return subDir;
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Load config from file
+ */
+export function loadConfigFile(filePath) {
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const config = JSON.parse(content);
+        // Validate that it's an object (not array or null)
+        if (typeof config !== 'object' || config === null || Array.isArray(config)) {
+            throw new Error('Config file must contain a JSON object');
+        }
+        return config;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in config file ${filePath}: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Load config from environment variables
+ * Supported variables:
+ * - MCP_PROJECT_PATH
+ * - MCP_CLI_PATH
+ * - MCP_PORT
+ * - MCP_CAPABILITIES (comma-separated)
+ * - MCP_OUTPUT_DIR
+ * - MCP_TIMEOUT
+ * - MCP_SESSION_TIMEOUT
+ */
+export function loadConfigFromEnv() {
+    const config = {};
+    if (process.env.MCP_PROJECT_PATH) {
+        config.projectPath = process.env.MCP_PROJECT_PATH;
+    }
+    if (process.env.MCP_CLI_PATH) {
+        config.cliPath = process.env.MCP_CLI_PATH;
+    }
+    if (process.env.MCP_PORT) {
+        const port = parseInt(process.env.MCP_PORT, 10);
+        if (!isNaN(port)) {
+            config.port = port;
+        }
+    }
+    if (process.env.MCP_CAPABILITIES) {
+        config.capabilities = process.env.MCP_CAPABILITIES.split(',').map((s) => s.trim());
+    }
+    if (process.env.MCP_OUTPUT_DIR) {
+        config.outputDir = process.env.MCP_OUTPUT_DIR;
+    }
+    if (process.env.MCP_TIMEOUT) {
+        const timeout = parseInt(process.env.MCP_TIMEOUT, 10);
+        if (!isNaN(timeout)) {
+            config.timeout = timeout;
+        }
+    }
+    if (process.env.MCP_SESSION_TIMEOUT) {
+        const timeout = parseInt(process.env.MCP_SESSION_TIMEOUT, 10);
+        if (!isNaN(timeout)) {
+            config.sessionTimeout = timeout;
+        }
+    }
+    return config;
+}
+/**
+ * Merge configs with priority: cliConfig > envConfig > fileConfig > defaults
+ */
+export function mergeConfigs(fileConfig = {}, envConfig = {}, cliConfig = {}) {
+    // Start with file config
+    let merged = { ...fileConfig };
+    // Override with env config
+    merged = { ...merged, ...envConfig };
+    // Override with CLI config
+    merged = { ...merged, ...cliConfig };
+    // Merge with defaults (fills in missing values)
+    return mergeServerConfig(merged);
+}
+/**
+ * Load complete configuration from all sources
+ *
+ * @param options - Optional overrides
+ * @param options.configPath - Explicit config file path (skips auto-discovery)
+ * @param options.cliConfig - CLI arguments config
+ * @param options.skipEnv - Skip loading from environment variables
+ * @param options.skipFile - Skip loading from config file
+ */
+export function loadConfig(options = {}) {
+    const { configPath, cliConfig = {}, skipEnv = false, skipFile = false } = options;
+    // Load from file
+    let fileConfig = {};
+    if (!skipFile) {
+        const foundPath = configPath || findConfigFile();
+        if (foundPath) {
+            try {
+                fileConfig = loadConfigFile(foundPath);
+                console.error(`Loaded config from: ${foundPath}`);
+            }
+            catch (error) {
+                console.error(`Failed to load config file: ${error}`);
+                // Continue with empty file config
+            }
+        }
+    }
+    // Load from environment
+    let envConfig = {};
+    if (!skipEnv) {
+        envConfig = loadConfigFromEnv();
+        const envKeys = Object.keys(envConfig);
+        if (envKeys.length > 0) {
+            console.error(`Loaded config from environment: ${envKeys.join(', ')}`);
+        }
+    }
+    // Auto-detect project path if not specified
+    let finalCliConfig = { ...cliConfig };
+    if (!finalCliConfig.projectPath && !fileConfig.projectPath && !envConfig.projectPath) {
+        const detected = autoDetectProjectPath();
+        if (detected) {
+            finalCliConfig.projectPath = detected;
+            console.error(`Auto-detected project path: ${detected}`);
+        }
+    }
+    // Merge all configs
+    return mergeConfigs(fileConfig, envConfig, finalCliConfig);
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"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"}

package/dist/core/element-ref.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ElementRef resolver for locating elements in miniProgram pages
+ * Supports multiple location strategies: refId, selector, xpath, index
+ *
+ * Cache Invalidation:
+ * - Element cache is automatically cleared when page navigation is detected
+ * - Cached elements are validated against current page before use
+ * - Stale elements (from different pages) are removed automatically
+ */
+import type { SessionState, ElementRefInput, ResolvedElement } from '../types.js';
+import type { Page } from '../types/miniprogram-automator.js';
+/**
+ * Generate a unique reference ID for caching elements
+ */
+export declare function generateRefId(): string;
+/**
+ * Check if page has changed and clear stale element cache
+ * Called before each element resolution to ensure cache validity
+ *
+ * @param state - Session state with element cache
+ * @param currentPagePath - Current page path
+ */
+export declare function invalidateStaleCacheEntries(state: SessionState, currentPagePath: string): void;
+/**
+ * Resolve page object from sessionState
+ * @param state - Session state containing miniProgram instance
+ * @param pagePath - Optional page path. If not provided, uses currentPage
+ * @returns Page object
+ * @throws Error if miniProgram not connected or page not found
+ */
+export declare function resolvePage(state: SessionState, pagePath?: string): Promise<Page>;
+/**
+ * Resolve element using various location strategies
+ * @param state - Session state containing element cache
+ * @param ref - Element reference input with location strategy
+ * @returns Resolved element with page, element object, and optional refId
+ * @throws Error if element not found or invalid reference
+ */
+export declare function resolveElement(state: SessionState, ref: ElementRefInput): Promise<ResolvedElement>;
+/**
+ * Validate ElementRefInput and provide helpful error messages
+ */
+export declare function validateElementRef(ref: ElementRefInput): void;
+//# sourceMappingURL=element-ref.d.ts.map

package/dist/core/element-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-ref.d.ts","sourceRoot":"","sources":["../../src/core/element-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACjF,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,mCAAmC,CAAA;AAEtE;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAgB9F;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCvF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,eAAe,CAAC,CAoI1B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAwB7D"}