@creatoria/miniapp-mcp 0.1.3 → 0.2.2

package/dist/runtime/session/utils/cleanup.js

@@ -0,0 +1,78 @@
+import { generateAndSaveReports } from '../../outputs/report-generator.js';
+export async function cleanupSessionResources(session, sessionId) {
+    const errors = [];
+    if (session.reportData) {
+        try {
+            await generateAndSaveReports(session);
+            console.error(`Session reports generated for ${sessionId}`);
+        }
+        catch (error) {
+            console.error(`Failed to generate session reports for ${sessionId}:`, error);
+        }
+    }
+    if (session.logger?.dispose) {
+        try {
+            await session.logger.dispose();
+            console.error(`Logger disposed for session ${sessionId}`);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            errors.push(new Error(`Failed to dispose logger: ${err.message}`));
+            console.error(`Failed to dispose logger for session ${sessionId}:`, error);
+        }
+    }
+    if (session.miniProgram) {
+        try {
+            if (typeof session.miniProgram.disconnect === 'function') {
+                await session.miniProgram.disconnect();
+            }
+            console.error(`Disconnected miniProgram for session ${sessionId}`);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            errors.push(new Error(`Failed to disconnect miniProgram: ${err.message}`));
+            console.error(`Failed to disconnect miniProgram for session ${sessionId}:`, error);
+        }
+    }
+    const ideProcess = session.ideProcess;
+    if (ideProcess) {
+        try {
+            if (typeof ideProcess.kill === 'function') {
+                if (typeof ideProcess.once === 'function') {
+                    await new Promise((resolve, reject) => {
+                        const timeout = setTimeout(() => {
+                            reject(new Error('IDE process did not exit within 5 seconds'));
+                        }, 5000);
+                        ideProcess.once('exit', () => {
+                            clearTimeout(timeout);
+                            resolve();
+                        });
+                        ideProcess.kill();
+                    });
+                }
+                else {
+                    ideProcess.kill();
+                }
+            }
+            console.error(`Killed IDE process for session ${sessionId}`);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            errors.push(new Error(`Failed to kill IDE process: ${err.message}`));
+            console.error(`Failed to kill IDE process for session ${sessionId}:`, error);
+        }
+    }
+    try {
+        session.elements.clear();
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        errors.push(new Error(`Failed to clear element cache: ${err.message}`));
+    }
+    if (errors.length > 0) {
+        console.error(`Session ${sessionId} cleanup completed with ${errors.length} error(s)`);
+        throw new AggregateError(errors, `Session cleanup had ${errors.length} error(s)`);
+    }
+    console.error(`Session ${sessionId} cleaned up successfully`);
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/runtime/session/utils/cleanup.js.map

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

package/dist/runtime/timeout/index.d.ts

@@ -0,0 +1,2 @@
+export * from './timeout.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/timeout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/timeout/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}

package/dist/runtime/timeout/index.js

@@ -0,0 +1,2 @@
+export * from './timeout.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/timeout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/timeout/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}

package/dist/runtime/timeout/timeout.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Timeout utilities for protecting async operations
+ */
+/**
+ * Wraps a promise with timeout protection
+ *
+ * @param promise - The promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param operation - Description of the operation for error messages
+ * @returns The promise result or throws TimeoutError
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   page.$(selector),
+ *   5000,
+ *   'Query element'
+ * )
+ * ```
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, operation: string): Promise<T>;
+/**
+ * Default timeout values for different operations
+ */
+export declare const DEFAULT_TIMEOUTS: {
+    /** Default timeout for most operations (30 seconds) */
+    readonly default: 30000;
+    /** Timeout for evaluate operations (5 seconds) */
+    readonly evaluate: 5000;
+    /** Timeout for launch operations (60 seconds) */
+    readonly launch: 60000;
+    /** Timeout for connect operations (30 seconds) */
+    readonly connect: 30000;
+    /** Timeout for screenshot operations (10 seconds) */
+    readonly screenshot: 10000;
+    /** Timeout for fullPage screenshot operations (30 seconds) */
+    readonly screenshotFullPage: 30000;
+    /** Timeout for navigation operations (30 seconds) */
+    readonly navigation: 30000;
+    /** Timeout for callWx operations (10 seconds) */
+    readonly callWx: 10000;
+    /** Timeout for pageStack operations (5 seconds) */
+    readonly pageStack: 5000;
+    /** Timeout for systemInfo operations (5 seconds) */
+    readonly systemInfo: 5000;
+    /** Timeout for waitFor operations (30 seconds) */
+    readonly waitFor: 30000;
+    /** Timeout for element queries (10 seconds) */
+    readonly query: 10000;
+};
+/**
+ * Get timeout value with fallback chain:
+ * 1. Operation-specific timeout from config
+ * 2. Global timeout from config
+ * 3. Operation-specific default
+ * 4. Global default (30s)
+ */
+export declare function getTimeout(configTimeout: number | undefined, operationDefault: number): number;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/runtime/timeout/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../../src/runtime/timeout/timeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,uDAAuD;;IAEvD,kDAAkD;;IAElD,iDAAiD;;IAEjD,kDAAkD;;IAElD,qDAAqD;;IAErD,8DAA8D;;IAE9D,qDAAqD;;IAErD,iDAAiD;;IAEjD,mDAAmD;;IAEnD,oDAAoD;;IAEpD,kDAAkD;;IAElD,+CAA+C;;CAEvC,CAAA;AAEV;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAE9F"}

package/dist/runtime/timeout/timeout.js

@@ -0,0 +1,77 @@
+/**
+ * Timeout utilities for protecting async operations
+ */
+/**
+ * Wraps a promise with timeout protection
+ *
+ * @param promise - The promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param operation - Description of the operation for error messages
+ * @returns The promise result or throws TimeoutError
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   page.$(selector),
+ *   5000,
+ *   'Query element'
+ * )
+ * ```
+ */
+export async function withTimeout(promise, timeoutMs, operation) {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new Error(`${operation} timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    try {
+        const result = await Promise.race([promise, timeoutPromise]);
+        clearTimeout(timeoutId);
+        return result;
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        throw error;
+    }
+}
+/**
+ * Default timeout values for different operations
+ */
+export const DEFAULT_TIMEOUTS = {
+    /** Default timeout for most operations (30 seconds) */
+    default: 30000,
+    /** Timeout for evaluate operations (5 seconds) */
+    evaluate: 5000,
+    /** Timeout for launch operations (60 seconds) */
+    launch: 60000,
+    /** Timeout for connect operations (30 seconds) */
+    connect: 30000,
+    /** Timeout for screenshot operations (10 seconds) */
+    screenshot: 10000,
+    /** Timeout for fullPage screenshot operations (30 seconds) */
+    screenshotFullPage: 30000,
+    /** Timeout for navigation operations (30 seconds) */
+    navigation: 30000,
+    /** Timeout for callWx operations (10 seconds) */
+    callWx: 10000,
+    /** Timeout for pageStack operations (5 seconds) */
+    pageStack: 5000,
+    /** Timeout for systemInfo operations (5 seconds) */
+    systemInfo: 5000,
+    /** Timeout for waitFor operations (30 seconds) */
+    waitFor: 30000,
+    /** Timeout for element queries (10 seconds) */
+    query: 10000,
+};
+/**
+ * Get timeout value with fallback chain:
+ * 1. Operation-specific timeout from config
+ * 2. Global timeout from config
+ * 3. Operation-specific default
+ * 4. Global default (30s)
+ */
+export function getTimeout(configTimeout, operationDefault) {
+    return configTimeout ?? operationDefault ?? DEFAULT_TIMEOUTS.default;
+}
+//# sourceMappingURL=timeout.js.map

package/dist/runtime/timeout/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../../src/runtime/timeout/timeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,SAAiB,EACjB,SAAiB;IAEjB,IAAI,SAAyB,CAAA;IAE7B,MAAM,cAAc,GAAG,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAClD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,SAAS,oBAAoB,SAAS,IAAI,CAAC,CAAC,CAAA;QAClE,CAAC,EAAE,SAAS,CAAC,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAA;QAC5D,YAAY,CAAC,SAAU,CAAC,CAAA;QACxB,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CAAC,SAAU,CAAC,CAAA;QACxB,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,uDAAuD;IACvD,OAAO,EAAE,KAAK;IACd,kDAAkD;IAClD,QAAQ,EAAE,IAAI;IACd,iDAAiD;IACjD,MAAM,EAAE,KAAK;IACb,kDAAkD;IAClD,OAAO,EAAE,KAAK;IACd,qDAAqD;IACrD,UAAU,EAAE,KAAK;IACjB,8DAA8D;IAC9D,kBAAkB,EAAE,KAAK;IACzB,qDAAqD;IACrD,UAAU,EAAE,KAAK;IACjB,iDAAiD;IACjD,MAAM,EAAE,KAAK;IACb,mDAAmD;IACnD,SAAS,EAAE,IAAI;IACf,oDAAoD;IACpD,UAAU,EAAE,IAAI;IAChB,kDAAkD;IAClD,OAAO,EAAE,KAAK;IACd,+CAA+C;IAC/C,KAAK,EAAE,KAAK;CACJ,CAAA;AAEV;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,aAAiC,EAAE,gBAAwB;IACpF,OAAO,aAAa,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,OAAO,CAAA;AACtE,CAAC"}

package/dist/runtime/validation/index.d.ts

@@ -0,0 +1,2 @@
+export * from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/dist/runtime/validation/index.js

@@ -0,0 +1,2 @@
+export * from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/dist/runtime/validation/validation.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Input validation utilities
+ */
+/**
+ * Validates a filename to prevent path traversal attacks
+ *
+ * Rules:
+ * - No path separators (/ or \)
+ * - No parent directory references (..)
+ * - Only alphanumeric, underscore, hyphen, and dot
+ * - Must have a valid extension
+ *
+ * @param filename - The filename to validate
+ * @param allowedExtensions - Array of allowed extensions (without dot)
+ * @throws Error if filename is invalid
+ *
+ * @example
+ * ```typescript
+ * validateFilename('screenshot.png', ['png', 'jpg']) // OK
+ * validateFilename('../etc/passwd', ['png']) // throws
+ * validateFilename('file/path.png', ['png']) // throws
+ * ```
+ */
+export declare function validateFilename(filename: string, allowedExtensions?: string[]): void;
+/**
+ * Sanitizes a filename by removing or replacing invalid characters
+ *
+ * @param filename - The filename to sanitize
+ * @param defaultExtension - Default extension if none provided
+ * @returns A safe filename
+ *
+ * @example
+ * ```typescript
+ * sanitizeFilename('my file!.png') // 'my-file.png'
+ * sanitizeFilename('test', 'json') // 'test.json'
+ * ```
+ */
+export declare function sanitizeFilename(filename: string, defaultExtension?: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/runtime/validation/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/runtime/validation/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,iBAAiB,GAAE,MAAM,EAA0C,GAClE,IAAI,CA0CN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BpF"}

package/dist/runtime/validation/validation.js

@@ -0,0 +1,93 @@
+/**
+ * Input validation utilities
+ */
+/**
+ * Validates a filename to prevent path traversal attacks
+ *
+ * Rules:
+ * - No path separators (/ or \)
+ * - No parent directory references (..)
+ * - Only alphanumeric, underscore, hyphen, and dot
+ * - Must have a valid extension
+ *
+ * @param filename - The filename to validate
+ * @param allowedExtensions - Array of allowed extensions (without dot)
+ * @throws Error if filename is invalid
+ *
+ * @example
+ * ```typescript
+ * validateFilename('screenshot.png', ['png', 'jpg']) // OK
+ * validateFilename('../etc/passwd', ['png']) // throws
+ * validateFilename('file/path.png', ['png']) // throws
+ * ```
+ */
+export function validateFilename(filename, allowedExtensions = ['png', 'jpg', 'jpeg', 'json', 'txt']) {
+    if (!filename || filename.trim() === '') {
+        throw new Error('Filename cannot be empty');
+    }
+    // Check for path traversal attempts
+    if (filename.includes('..')) {
+        throw new Error('Filename must not contain ".." sequences (path traversal attempt)');
+    }
+    // Check for path separators
+    if (filename.includes('/') || filename.includes('\\')) {
+        throw new Error('Filename must not contain path separators');
+    }
+    // Check for null bytes (security)
+    if (filename.includes('\0')) {
+        throw new Error('Filename must not contain null bytes');
+    }
+    // Validate format: alphanumeric, underscore, hyphen, and dot
+    if (!/^[a-zA-Z0-9_.-]+$/.test(filename)) {
+        throw new Error('Filename must only contain alphanumeric characters, underscores, hyphens, and dots');
+    }
+    // Check extension
+    const parts = filename.split('.');
+    if (parts.length < 2) {
+        throw new Error('Filename must have an extension');
+    }
+    const extension = parts[parts.length - 1].toLowerCase();
+    if (!allowedExtensions.includes(extension)) {
+        throw new Error(`Invalid file extension. Allowed extensions: ${allowedExtensions.join(', ')}`);
+    }
+    // Check length (防止过长文件名)
+    if (filename.length > 255) {
+        throw new Error('Filename is too long (max 255 characters)');
+    }
+}
+/**
+ * Sanitizes a filename by removing or replacing invalid characters
+ *
+ * @param filename - The filename to sanitize
+ * @param defaultExtension - Default extension if none provided
+ * @returns A safe filename
+ *
+ * @example
+ * ```typescript
+ * sanitizeFilename('my file!.png') // 'my-file.png'
+ * sanitizeFilename('test', 'json') // 'test.json'
+ * ```
+ */
+export function sanitizeFilename(filename, defaultExtension) {
+    // Remove path components
+    filename = filename.split('/').pop();
+    filename = filename.split('\\').pop();
+    // Remove or replace invalid characters
+    filename = filename.replace(/[^a-zA-Z0-9_.-]/g, '-');
+    // Remove multiple consecutive hyphens or dots
+    filename = filename.replace(/[-]{2,}/g, '-');
+    filename = filename.replace(/[.]{2,}/g, '.');
+    // Ensure extension
+    if (defaultExtension && !filename.includes('.')) {
+        filename = `${filename}.${defaultExtension}`;
+    }
+    // Limit length
+    if (filename.length > 255) {
+        const parts = filename.split('.');
+        const ext = parts.pop();
+        const name = parts.join('.').substring(0, 255 - ext.length - 1);
+        filename = `${name}.${ext}`;
+    }
+    return filename;
+}
+//# sourceMappingURL=validation.js.map

package/dist/runtime/validation/validation.js.map

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

package/dist/schemas/automator/miniprogram_close.json

@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/miniprogram_close",
+  "definitions": {
+    "miniprogram_close": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false,
+      "description": "Close current mini program session and cleanup all resources"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/schemas/automator/miniprogram_connect.json

@@ -0,0 +1,19 @@
+{
+  "$ref": "#/definitions/miniprogram_connect",
+  "definitions": {
+    "miniprogram_connect": {
+      "type": "object",
+      "properties": {
+        "port": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 65535,
+          "description": "Automation port for an existing DevTools instance"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Connect to an already running WeChat DevTools instance"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/schemas/automator/miniprogram_disconnect.json

@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/miniprogram_disconnect",
+  "definitions": {
+    "miniprogram_disconnect": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false,
+      "description": "Disconnect from miniprogram but keep IDE running"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/schemas/automator/miniprogram_launch.json

@@ -0,0 +1,30 @@
+{
+  "$ref": "#/definitions/miniprogram_launch",
+  "definitions": {
+    "miniprogram_launch": {
+      "type": "object",
+      "properties": {
+        "projectPath": {
+          "type": "string",
+          "minLength": 1
+        },
+        "cliPath": {
+          "type": "string",
+          "minLength": 1
+        },
+        "port": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 65535,
+          "description": "Automation port for WeChat DevTools"
+        }
+      },
+      "required": [
+        "projectPath"
+      ],
+      "additionalProperties": false,
+      "description": "Launch WeChat Mini Program with automator"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/server.js

@@ -4,8 +4,8 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { SessionStore } from './core/session.js';
-import { registerTools } from './tools/index.js';
+import { SessionStore } from './runtime/session/index.js';
+import { setupCapabilities } from './capabilities/loader.js';
 import { mergeServerConfig } from './config/defaults.js';
 export async function startServer(config = {}) {
     // Merge config with defaults to ensure all fields are present
@@ -35,9 +35,9 @@ export async function startServer(config = {}) {
             tools: {},
         },
     });
-    // Register tools based on capabilities
-    // registerTools now actually registers the CallToolRequestSchema handler
-    const tools = registerTools(server, {
+    // Register tools based on capabilities using new architecture
+    // setupCapabilities loads capability modules dynamically and registers handlers
+    const { tools } = await setupCapabilities(server, {
         capabilities,
         sessionId, // Pass the unique session ID
         getSession: (sid) => {

package/dist/server.js.map

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

package/dist/tools/index.d.ts.map

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

package/dist/tools/index.js

@@ -15,7 +15,7 @@
  * Total: 65 tools
  */
 import { CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { ToolLogger } from '../core/tool-logger.js';
+import { ToolLogger } from '../runtime/logging/tool-logger.js';
 import * as automatorTools from './automator.js';
 import * as miniprogramTools from './miniprogram.js';
 import * as pageTools from './page.js';
@@ -153,17 +153,21 @@ export const MINIPROGRAM_TOOLS = [
     },
     {
         name: 'miniprogram_screenshot',
-        description: 'Take a screenshot of the mini program. Returns base64 string by default, or saves to file if filename is provided.',
+        description: 'Take a screenshot of the mini program. Use returnBase64=true for quick base64 response, or provide filename to save to file.',
         inputSchema: {
             type: 'object',
             properties: {
                 filename: {
                     type: 'string',
-                    description: 'Optional filename to save screenshot to file. If not provided, returns base64 string instead.',
+                    description: 'Optional filename to save screenshot to file. If not provided and returnBase64=true, returns base64 string directly.',
                 },
                 fullPage: {
                     type: 'boolean',
-                    description: 'Whether to capture the full page (default: false)',
+                    description: 'Whether to capture the full page including scroll area (default: false). Note: fullPage screenshots use longer timeout (30s vs 10s).',
+                },
+                returnBase64: {
+                    type: 'boolean',
+                    description: 'Return screenshot as base64 string. If true and no filename provided, returns base64 directly without saving file. (default: false)',
                 },
             },
         },