@creatoria/miniapp-mcp 0.2.0 → 0.2.3

package/dist/capabilities/snapshot/handlers/snapshot-handlers.js

@@ -0,0 +1,201 @@
+/**
+ * Snapshot handlers - State capture and diagnostic utilities
+ */
+import { getPageStack, getSystemInfo, screenshot } from '../../miniprogram/handlers/index.js';
+import { getData } from '../../page/handlers/index.js';
+import { getText, getSize, getOffset } from '../../element/handlers/index.js';
+export async function snapshotPage(session, args) {
+    const { pagePath, filename, includeScreenshot = true, fullPage = false } = args;
+    const logger = session.logger;
+    try {
+        if (!session.miniProgram) {
+            throw new Error('MiniProgram not connected. Call miniprogram_launch or miniprogram_connect first.');
+        }
+        if (!session.outputManager) {
+            throw new Error('OutputManager not available');
+        }
+        logger?.info('Capturing page snapshot', { pagePath, includeScreenshot });
+        if (filename) {
+            const { validateFilename } = await import('../../../runtime/validation/validation.js');
+            try {
+                validateFilename(filename, ['json']);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                throw new Error(`Invalid filename: ${errorMessage}`);
+            }
+        }
+        const pageStackResult = await getPageStack(session);
+        const currentPageInfo = pageStackResult.pages[pageStackResult.pages.length - 1];
+        if (!currentPageInfo) {
+            throw new Error('No active page found');
+        }
+        const pageDataResult = await getData(session, { pagePath });
+        const timestamp = new Date().toISOString();
+        const snapshotData = {
+            timestamp,
+            pagePath: currentPageInfo.path,
+            pageData: pageDataResult.data,
+            pageQuery: currentPageInfo.query,
+        };
+        const outputManager = session.outputManager;
+        await outputManager.ensureOutputDir();
+        const snapshotFilename = filename || outputManager.generateFilename('snapshot', 'json');
+        const snapshotPath = await outputManager.writeFile(snapshotFilename, Buffer.from(JSON.stringify(snapshotData, null, 2)));
+        logger?.info('Page snapshot data saved', { path: snapshotPath });
+        let screenshotPath;
+        if (includeScreenshot) {
+            const screenshotFilename = snapshotFilename.replace('.json', '.png');
+            const screenshotResult = await screenshot(session, { filename: screenshotFilename, fullPage });
+            screenshotPath = screenshotResult.path;
+            logger?.info('Page screenshot saved', { path: screenshotPath });
+        }
+        logger?.info('Page snapshot completed', { snapshotPath, screenshotPath });
+        return {
+            success: true,
+            message: 'Page snapshot captured successfully',
+            snapshotPath,
+            screenshotPath,
+            data: snapshotData,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger?.error('Page snapshot failed', { error: errorMessage, pagePath });
+        throw new Error(`Page snapshot failed: ${errorMessage}`);
+    }
+}
+export async function snapshotFull(session, args) {
+    const { filename, includeScreenshot = true, fullPage = false } = args;
+    const logger = session.logger;
+    try {
+        if (!session.miniProgram) {
+            throw new Error('MiniProgram not connected. Call miniprogram_launch or miniprogram_connect first.');
+        }
+        if (!session.outputManager) {
+            throw new Error('OutputManager not available');
+        }
+        logger?.info('Capturing full application snapshot', { includeScreenshot });
+        if (filename) {
+            const { validateFilename } = await import('../../../runtime/validation/validation.js');
+            try {
+                validateFilename(filename, ['json']);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                throw new Error(`Invalid filename: ${errorMessage}`);
+            }
+        }
+        const systemInfoResult = await getSystemInfo(session);
+        const pageStackResult = await getPageStack(session);
+        const currentPageInfo = pageStackResult.pages[pageStackResult.pages.length - 1];
+        if (!currentPageInfo) {
+            throw new Error('No active page found');
+        }
+        const pageDataResult = await getData(session, {});
+        const timestamp = new Date().toISOString();
+        const snapshotData = {
+            timestamp,
+            systemInfo: systemInfoResult.systemInfo,
+            pageStack: pageStackResult.pages,
+            currentPage: {
+                path: currentPageInfo.path,
+                query: currentPageInfo.query,
+                data: pageDataResult.data,
+            },
+        };
+        const outputManager = session.outputManager;
+        await outputManager.ensureOutputDir();
+        const snapshotFilename = filename || outputManager.generateFilename('snapshot', 'json');
+        const snapshotPath = await outputManager.writeFile(snapshotFilename, Buffer.from(JSON.stringify(snapshotData, null, 2)));
+        logger?.info('Application snapshot data saved', { path: snapshotPath });
+        let screenshotPath;
+        if (includeScreenshot) {
+            const screenshotFilename = snapshotFilename.replace('.json', '.png');
+            const screenshotResult = await screenshot(session, { filename: screenshotFilename, fullPage });
+            screenshotPath = screenshotResult.path;
+            logger?.info('Application screenshot saved', { path: screenshotPath });
+        }
+        logger?.info('Full application snapshot completed', { snapshotPath, screenshotPath });
+        return {
+            success: true,
+            message: 'Full application snapshot captured successfully',
+            snapshotPath,
+            screenshotPath,
+            data: snapshotData,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger?.error('Full application snapshot failed', { error: errorMessage });
+        throw new Error(`Full application snapshot failed: ${errorMessage}`);
+    }
+}
+export async function snapshotElement(session, args) {
+    const { refId, filename, includeScreenshot = false } = args;
+    const logger = session.logger;
+    try {
+        if (!session.miniProgram) {
+            throw new Error('MiniProgram not connected. Call miniprogram_launch or miniprogram_connect first.');
+        }
+        if (!session.outputManager) {
+            throw new Error('OutputManager not available');
+        }
+        logger?.info('Capturing element snapshot', { refId, includeScreenshot });
+        if (filename) {
+            const { validateFilename } = await import('../../../runtime/validation/validation.js');
+            try {
+                validateFilename(filename, ['json']);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                throw new Error(`Invalid filename: ${errorMessage}`);
+            }
+        }
+        let text;
+        try {
+            const textResult = await getText(session, { refId });
+            text = textResult.text;
+        }
+        catch {
+            text = undefined;
+        }
+        const sizeResult = await getSize(session, { refId });
+        const offsetResult = await getOffset(session, { refId });
+        const timestamp = new Date().toISOString();
+        const snapshotData = {
+            timestamp,
+            refId,
+            text,
+            attributes: {},
+            size: sizeResult.size,
+            offset: offsetResult.offset,
+        };
+        const outputManager = session.outputManager;
+        await outputManager.ensureOutputDir();
+        const snapshotFilename = filename || outputManager.generateFilename('snapshot', 'json');
+        const snapshotPath = await outputManager.writeFile(snapshotFilename, Buffer.from(JSON.stringify(snapshotData, null, 2)));
+        logger?.info('Element snapshot data saved', { path: snapshotPath });
+        let screenshotPath;
+        if (includeScreenshot) {
+            const screenshotFilename = snapshotFilename.replace('.json', '.png');
+            const screenshotResult = await screenshot(session, { filename: screenshotFilename });
+            screenshotPath = screenshotResult.path;
+            logger?.info('Element screenshot saved', { path: screenshotPath });
+        }
+        logger?.info('Element snapshot completed', { snapshotPath, screenshotPath });
+        return {
+            success: true,
+            message: 'Element snapshot captured successfully',
+            snapshotPath,
+            screenshotPath,
+            data: snapshotData,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger?.error('Element snapshot failed', { error: errorMessage, refId });
+        throw new Error(`Element snapshot failed: ${errorMessage}`);
+    }
+}
+//# sourceMappingURL=snapshot-handlers.js.map

package/dist/capabilities/snapshot/handlers/snapshot-handlers.js.map

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

package/dist/capabilities/snapshot/index.d.ts

@@ -1,5 +1,15 @@
 /**
- * Snapshot capability bridge to legacy tool implementations.
+ * Snapshot Capability Module
+ *
+ * Provides tools for state capture and diagnostics including page snapshots,
+ * full application snapshots, and element snapshots.
  */
-export * from '../../tools/snapshot.js';
+import type { CapabilityModule } from '../registry.js';
+export * from './schemas/index.js';
+export * from './handlers/index.js';
+/**
+ * Snapshot capability module
+ */
+export declare const capability: CapabilityModule;
+export default capability;
 //# sourceMappingURL=index.d.ts.map

package/dist/capabilities/snapshot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/capabilities/snapshot/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/capabilities/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,gBAAgB,CAAA;AAatE,cAAc,oBAAoB,CAAA;AAGlC,cAAc,qBAAqB,CAAA;AA6BnC;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,gBAIxB,CAAA;AAED,eAAe,UAAU,CAAA"}

package/dist/capabilities/snapshot/index.js

@@ -1,5 +1,48 @@
 /**
- * Snapshot capability bridge to legacy tool implementations.
+ * Snapshot Capability Module
+ *
+ * Provides tools for state capture and diagnostics including page snapshots,
+ * full application snapshots, and element snapshots.
  */
-export * from '../../tools/snapshot.js';
+import { snapshotPageSchema, snapshotFullSchema, snapshotElementSchema, } from './schemas/index.js';
+import { snapshotPage, snapshotFull, snapshotElement, } from './handlers/index.js';
+// Re-export schemas for external use
+export * from './schemas/index.js';
+// Re-export handlers for external use
+export * from './handlers/index.js';
+/**
+ * Snapshot tool definitions - 3 tools
+ */
+const tools = [
+    {
+        name: 'snapshot_page',
+        description: 'Capture complete page snapshot (data + screenshot)',
+        capability: 'snapshot',
+        inputSchema: snapshotPageSchema,
+        handler: snapshotPage,
+    },
+    {
+        name: 'snapshot_full',
+        description: 'Capture complete application snapshot (system info + page stack + current page)',
+        capability: 'snapshot',
+        inputSchema: snapshotFullSchema,
+        handler: snapshotFull,
+    },
+    {
+        name: 'snapshot_element',
+        description: 'Capture element snapshot (properties + optional screenshot)',
+        capability: 'snapshot',
+        inputSchema: snapshotElementSchema,
+        handler: snapshotElement,
+    },
+];
+/**
+ * Snapshot capability module
+ */
+export const capability = {
+    name: 'snapshot',
+    description: 'State capture and diagnostic utilities (3 tools)',
+    tools,
+};
+export default capability;
 //# sourceMappingURL=index.js.map

package/dist/capabilities/snapshot/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/capabilities/snapshot/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/capabilities/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAE5B,qCAAqC;AACrC,cAAc,oBAAoB,CAAA;AAElC,sCAAsC;AACtC,cAAc,qBAAqB,CAAA;AAEnC;;GAEG;AACH,MAAM,KAAK,GAAqB;IAC9B;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,oDAAoD;QACjE,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,YAAY;KACtB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,iFAAiF;QAC9F,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,YAAY;KACtB;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,6DAA6D;QAC1E,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE,eAAe;KACzB;CACF,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAqB;IAC1C,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,kDAAkD;IAC/D,KAAK;CACN,CAAA;AAED,eAAe,UAAU,CAAA"}

package/dist/capabilities/snapshot/schemas/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Snapshot schemas exports - 3 snapshot tool schemas
+ */
+import { z } from 'zod';
+export declare const snapshotPageSchema: z.ZodObject<{
+    pagePath: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    includeScreenshot: z.ZodOptional<z.ZodBoolean>;
+    fullPage: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    filename?: string | undefined;
+    fullPage?: boolean | undefined;
+    pagePath?: string | undefined;
+    includeScreenshot?: boolean | undefined;
+}, {
+    filename?: string | undefined;
+    fullPage?: boolean | undefined;
+    pagePath?: string | undefined;
+    includeScreenshot?: boolean | undefined;
+}>;
+export declare const snapshotFullSchema: z.ZodObject<{
+    filename: z.ZodOptional<z.ZodString>;
+    includeScreenshot: z.ZodOptional<z.ZodBoolean>;
+    fullPage: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    filename?: string | undefined;
+    fullPage?: boolean | undefined;
+    includeScreenshot?: boolean | undefined;
+}, {
+    filename?: string | undefined;
+    fullPage?: boolean | undefined;
+    includeScreenshot?: boolean | undefined;
+}>;
+export declare const snapshotElementSchema: z.ZodObject<{
+    refId: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+    includeScreenshot: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    refId: string;
+    filename?: string | undefined;
+    includeScreenshot?: boolean | undefined;
+}, {
+    refId: string;
+    filename?: string | undefined;
+    includeScreenshot?: boolean | undefined;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/snapshot/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/snapshot/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAOkC,CAAA;AAEjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAM+D,CAAA;AAE9F,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAMwC,CAAA"}

package/dist/capabilities/snapshot/schemas/index.js

@@ -0,0 +1,28 @@
+/**
+ * Snapshot schemas exports - 3 snapshot tool schemas
+ */
+import { z } from 'zod';
+const refIdSchema = z.string().min(1).describe('Element reference ID from page_query');
+export const snapshotPageSchema = z
+    .object({
+    pagePath: z.string().optional().describe('Page path (optional, defaults to current page)'),
+    filename: z.string().optional().describe('Output filename (optional, auto-generated if not provided)'),
+    includeScreenshot: z.boolean().optional().describe('Whether to include screenshot (default: true)'),
+    fullPage: z.boolean().optional().describe('Whether to capture full page or viewport only (default: false)'),
+})
+    .describe('Capture complete page snapshot (data + screenshot)');
+export const snapshotFullSchema = z
+    .object({
+    filename: z.string().optional().describe('Output filename (optional, auto-generated if not provided)'),
+    includeScreenshot: z.boolean().optional().describe('Whether to include screenshot (default: true)'),
+    fullPage: z.boolean().optional().describe('Whether to capture full page or viewport only (default: false)'),
+})
+    .describe('Capture complete application snapshot (system info + page stack + current page)');
+export const snapshotElementSchema = z
+    .object({
+    refId: refIdSchema,
+    filename: z.string().optional().describe('Output filename (optional, auto-generated if not provided)'),
+    includeScreenshot: z.boolean().optional().describe('Whether to include screenshot (default: false)'),
+})
+    .describe('Capture element snapshot (properties + optional screenshot)');
+//# sourceMappingURL=index.js.map

package/dist/capabilities/snapshot/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/capabilities/snapshot/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC,CAAA;AAEtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC1F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IACtG,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACnG,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;CAC5G,CAAC;KACD,QAAQ,CAAC,oDAAoD,CAAC,CAAA;AAEjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IACtG,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACnG,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;CAC5G,CAAC;KACD,QAAQ,CAAC,iFAAiF,CAAC,CAAA;AAE9F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IACtG,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CACrG,CAAC;KACD,QAAQ,CAAC,6DAA6D,CAAC,CAAA"}

package/dist/config/defaults.d.ts

@@ -30,6 +30,10 @@ 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 connect operations (30 seconds in milliseconds)
+ */
+export declare const DEFAULT_CONNECT_TIMEOUT: number;
 /**
  * Default timeout for screenshot operations (10 seconds in milliseconds)
  */

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

@@ -1 +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"}
+{"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,uBAAuB,QAAY,CAAA;AAEhD;;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,CAkBxD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,aAAa,CAS1D,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

@@ -29,6 +29,10 @@ 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 connect operations (30 seconds in milliseconds)
+ */
+export const DEFAULT_CONNECT_TIMEOUT = 30 * 1000;
 /**
  * Default timeout for screenshot operations (10 seconds in milliseconds)
  */
@@ -67,6 +71,9 @@ export const DEFAULT_SERVER_CONFIG = {
     logFlushInterval: DEFAULT_LOG_FLUSH_INTERVAL,
     enableSessionReport: false, // F3: Session report generation (default: disabled)
     enableFailureSnapshot: false, // F2: Automatic failure snapshot capture (default: disabled)
+    launchTimeout: DEFAULT_LAUNCH_TIMEOUT,
+    connectTimeout: DEFAULT_CONNECT_TIMEOUT,
+    screenshotTimeout: DEFAULT_SCREENSHOT_TIMEOUT,
 };
 /**
  * Default session configuration
@@ -78,6 +85,7 @@ export const DEFAULT_SESSION_CONFIG = {
     timeout: DEFAULT_TIMEOUT,
     evaluateTimeout: DEFAULT_EVALUATE_TIMEOUT,
     launchTimeout: DEFAULT_LAUNCH_TIMEOUT,
+    connectTimeout: DEFAULT_CONNECT_TIMEOUT,
     screenshotTimeout: DEFAULT_SCREENSHOT_TIMEOUT,
 };
 /**

package/dist/config/defaults.js.map

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

package/dist/config/loader.d.ts

@@ -26,6 +26,9 @@ export declare function loadConfigFile(filePath: string): Partial<ServerConfig>;
  * - MCP_OUTPUT_DIR
  * - MCP_TIMEOUT
  * - MCP_SESSION_TIMEOUT
+ * - MCP_LAUNCH_TIMEOUT
+ * - MCP_CONNECT_TIMEOUT
+ * - MCP_SCREENSHOT_TIMEOUT
  */
 export declare function loadConfigFromEnv(): Partial<ServerConfig>;
 /**

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,YAAY,CAAC,CA8DzD;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

@@ -91,6 +91,9 @@ export function loadConfigFile(filePath) {
  * - MCP_OUTPUT_DIR
  * - MCP_TIMEOUT
  * - MCP_SESSION_TIMEOUT
+ * - MCP_LAUNCH_TIMEOUT
+ * - MCP_CONNECT_TIMEOUT
+ * - MCP_SCREENSHOT_TIMEOUT
  */
 export function loadConfigFromEnv() {
     const config = {};
@@ -124,6 +127,24 @@ export function loadConfigFromEnv() {
             config.sessionTimeout = timeout;
         }
     }
+    if (process.env.MCP_LAUNCH_TIMEOUT) {
+        const timeout = parseInt(process.env.MCP_LAUNCH_TIMEOUT, 10);
+        if (!isNaN(timeout)) {
+            config.launchTimeout = timeout;
+        }
+    }
+    if (process.env.MCP_CONNECT_TIMEOUT) {
+        const timeout = parseInt(process.env.MCP_CONNECT_TIMEOUT, 10);
+        if (!isNaN(timeout)) {
+            config.connectTimeout = timeout;
+        }
+    }
+    if (process.env.MCP_SCREENSHOT_TIMEOUT) {
+        const timeout = parseInt(process.env.MCP_SCREENSHOT_TIMEOUT, 10);
+        if (!isNaN(timeout)) {
+            config.screenshotTimeout = timeout;
+        }
+    }
     return config;
 }
 /**

package/dist/config/loader.js.map

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

package/dist/runtime/concurrency/mutex.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Per-key serial queue (mutex).
+ *
+ * The WeChat automation SDK uses a single WebSocket with a serial request/response
+ * protocol. Operations like screenshot cannot run concurrently — firing several at
+ * once makes all but one hang until they time out. This mutex serializes calls that
+ * share a key (e.g. a session id) so concurrent callers are queued instead of racing.
+ */
+/**
+ * Run `task` exclusively for the given `key`. Calls with the same key execute one at a
+ * time, in arrival order. Calls with different keys do not block each other.
+ *
+ * @param key - Serialization key (e.g. session id)
+ * @param task - The async operation to run under the lock
+ */
+export declare function runExclusive<T>(key: string, task: () => Promise<T>): Promise<T>;
+/**
+ * Serialize an operation against all other operations on the same session.
+ *
+ * The SDK multiplexes every request over ONE WebSocket. Running independent
+ * operations (screenshot, evaluate, navigate, …) concurrently makes them race for
+ * that single connection and all but one hang until timeout. Sharing one lock per
+ * session turns concurrent calls into an orderly queue.
+ *
+ * @param sessionId - The session whose SDK operations must run one at a time
+ * @param task - The async SDK operation to run under the session lock
+ */
+export declare function withSessionLock<T>(sessionId: string, task: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=mutex.d.ts.map

package/dist/runtime/concurrency/mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.d.ts","sourceRoot":"","sources":["../../../src/runtime/concurrency/mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAuBrF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAExF"}

package/dist/runtime/concurrency/mutex.js

@@ -0,0 +1,46 @@
+/**
+ * Per-key serial queue (mutex).
+ *
+ * The WeChat automation SDK uses a single WebSocket with a serial request/response
+ * protocol. Operations like screenshot cannot run concurrently — firing several at
+ * once makes all but one hang until they time out. This mutex serializes calls that
+ * share a key (e.g. a session id) so concurrent callers are queued instead of racing.
+ */
+const tails = new Map();
+/**
+ * Run `task` exclusively for the given `key`. Calls with the same key execute one at a
+ * time, in arrival order. Calls with different keys do not block each other.
+ *
+ * @param key - Serialization key (e.g. session id)
+ * @param task - The async operation to run under the lock
+ */
+export async function runExclusive(key, task) {
+    const prev = tails.get(key) ?? Promise.resolve();
+    // Chain after the predecessor, ignoring its outcome so one caller's error
+    // never rejects the next caller in the queue.
+    const run = prev.then(() => task(), () => task());
+    // Advance the tail. Settle to a non-throwing promise so the chain stays clean.
+    const settled = run.then(() => undefined, () => undefined);
+    tails.set(key, settled);
+    // Drop the entry once this task is the last one, to avoid unbounded growth.
+    settled.then(() => {
+        if (tails.get(key) === settled)
+            tails.delete(key);
+    });
+    return run;
+}
+/**
+ * Serialize an operation against all other operations on the same session.
+ *
+ * The SDK multiplexes every request over ONE WebSocket. Running independent
+ * operations (screenshot, evaluate, navigate, …) concurrently makes them race for
+ * that single connection and all but one hang until timeout. Sharing one lock per
+ * session turns concurrent calls into an orderly queue.
+ *
+ * @param sessionId - The session whose SDK operations must run one at a time
+ * @param task - The async SDK operation to run under the session lock
+ */
+export function withSessionLock(sessionId, task) {
+    return runExclusive(`session:${sessionId}`, task);
+}
+//# sourceMappingURL=mutex.js.map

package/dist/runtime/concurrency/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../../../src/runtime/concurrency/mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAA;AAEjD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,GAAW,EAAE,IAAsB;IACvE,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;IAEhD,0EAA0E;IAC1E,8CAA8C;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CACnB,GAAG,EAAE,CAAC,IAAI,EAAE,EACZ,GAAG,EAAE,CAAC,IAAI,EAAE,CACb,CAAA;IAED,+EAA+E;IAC/E,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CACtB,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAEvB,4EAA4E;IAC5E,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;QAChB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAI,SAAiB,EAAE,IAAsB;IAC1E,OAAO,YAAY,CAAC,WAAW,SAAS,EAAE,EAAE,IAAI,CAAC,CAAA;AACnD,CAAC"}

package/dist/runtime/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Runtime facade aggregating session, logging, output, timeout, and validation helpers.
+ * Runtime facade aggregating session, logging, output, timeout, validation, and retry helpers.
  */
 export * from './session/index.js';
 export * from './logging/index.js';
@@ -7,4 +7,5 @@ export * from './outputs/index.js';
 export * from './timeout/index.js';
 export * from './validation/index.js';
 export * from './element/index.js';
+export * from './retry/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}