@creatoria/miniapp-mcp 0.1.0

package/dist/tools/snapshot.js

@@ -0,0 +1,258 @@
+/**
+ * Snapshot tools for MCP server
+ * Provides utilities for capturing page and application state snapshots
+ */
+import * as miniprogramTools from './miniprogram.js';
+import * as pageTools from './page.js';
+/**
+ * Capture a complete page snapshot (data + screenshot)
+ * Includes page data, page info, and screenshot
+ */
+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 });
+        // Validate filename if provided (security: prevent path traversal)
+        if (filename) {
+            const { validateFilename } = await import('../core/validation.js');
+            try {
+                validateFilename(filename, ['json']);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                throw new Error(`Invalid filename: ${errorMessage}`);
+            }
+        }
+        // Get current page from session or specified path
+        const pageStackResult = await miniprogramTools.getPageStack(session);
+        const currentPageInfo = pageStackResult.pages[pageStackResult.pages.length - 1];
+        if (!currentPageInfo) {
+            throw new Error('No active page found');
+        }
+        // Get page data
+        const pageDataResult = await pageTools.getData(session, { pagePath });
+        // Build snapshot data
+        const timestamp = new Date().toISOString();
+        const snapshotData = {
+            timestamp,
+            pagePath: currentPageInfo.path,
+            pageData: pageDataResult.data,
+            pageQuery: currentPageInfo.query,
+        };
+        // Save snapshot JSON
+        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 });
+        // Take screenshot if requested
+        let screenshotPath;
+        if (includeScreenshot) {
+            const screenshotFilename = snapshotFilename.replace('.json', '.png');
+            const screenshotResult = await miniprogramTools.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}`);
+    }
+}
+/**
+ * Capture a complete application snapshot
+ * Includes system info, page stack, current page data, and screenshot
+ */
+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 });
+        // Validate filename if provided (security: prevent path traversal)
+        if (filename) {
+            const { validateFilename } = await import('../core/validation.js');
+            try {
+                validateFilename(filename, ['json']);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                throw new Error(`Invalid filename: ${errorMessage}`);
+            }
+        }
+        // Get system info
+        const systemInfoResult = await miniprogramTools.getSystemInfo(session);
+        // Get page stack
+        const pageStackResult = await miniprogramTools.getPageStack(session);
+        const currentPageInfo = pageStackResult.pages[pageStackResult.pages.length - 1];
+        if (!currentPageInfo) {
+            throw new Error('No active page found');
+        }
+        // Get current page data
+        const pageDataResult = await pageTools.getData(session, {});
+        // Build snapshot data
+        const timestamp = new Date().toISOString();
+        const snapshotData = {
+            timestamp,
+            systemInfo: systemInfoResult.systemInfo,
+            pageStack: pageStackResult.pages,
+            currentPage: {
+                path: currentPageInfo.path,
+                query: currentPageInfo.query,
+                data: pageDataResult.data,
+            },
+        };
+        // Save snapshot JSON
+        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 });
+        // Take screenshot if requested
+        let screenshotPath;
+        if (includeScreenshot) {
+            const screenshotFilename = snapshotFilename.replace('.json', '.png');
+            const screenshotResult = await miniprogramTools.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}`);
+    }
+}
+/**
+ * Capture an element snapshot (properties + screenshot)
+ * Includes element attributes, properties, size, and optional screenshot
+ */
+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 });
+        // Validate filename if provided (security: prevent path traversal)
+        if (filename) {
+            const { validateFilename } = await import('../core/validation.js');
+            try {
+                validateFilename(filename, ['json']);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                throw new Error(`Invalid filename: ${errorMessage}`);
+            }
+        }
+        // Import element tools dynamically to avoid circular dependency
+        const elementTools = await import('./element.js');
+        // Get element text
+        let text;
+        try {
+            const textResult = await elementTools.getText(session, { refId });
+            text = textResult.text;
+        }
+        catch {
+            // Element might not have text
+            text = undefined;
+        }
+        // Get element size
+        const sizeResult = await elementTools.getSize(session, { refId });
+        // Get element offset
+        const offsetResult = await elementTools.getOffset(session, { refId });
+        // Build snapshot data
+        const timestamp = new Date().toISOString();
+        const snapshotData = {
+            timestamp,
+            refId,
+            text,
+            attributes: {}, // We would need to know which attributes to get
+            size: sizeResult.size,
+            offset: offsetResult.offset,
+        };
+        // Save snapshot JSON
+        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 });
+        // Take screenshot if requested
+        let screenshotPath;
+        if (includeScreenshot) {
+            const screenshotFilename = snapshotFilename.replace('.json', '.png');
+            const screenshotResult = await miniprogramTools.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.js.map

package/dist/tools/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/tools/snapshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,gBAAgB,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,SAAS,MAAM,WAAW,CAAA;AAEtC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAqB,EACrB,IAKC;IAaD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,IAAI,CAAA;IAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAE7B,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAA;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAChD,CAAC;QAED,MAAM,EAAE,IAAI,CAAC,yBAAyB,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAA;QAExE,mEAAmE;QACnE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAA;YAClE,IAAI,CAAC;gBACH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAC3E,MAAM,IAAI,KAAK,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAA;YACtD,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,MAAM,eAAe,GAAG,MAAM,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QACpE,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAE/E,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QACzC,CAAC;QAED,gBAAgB;QAChB,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;QAErE,sBAAsB;QACtB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,YAAY,GAAG;YACnB,SAAS;YACT,QAAQ,EAAE,eAAe,CAAC,IAAI;YAC9B,QAAQ,EAAE,cAAc,CAAC,IAAI;YAC7B,SAAS,EAAE,eAAe,CAAC,KAAK;SACjC,CAAA;QAED,qBAAqB;QACrB,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QAC3C,MAAM,aAAa,CAAC,eAAe,EAAE,CAAA;QAErC,MAAM,gBAAgB,GAAG,QAAQ,IAAI,aAAa,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QACvF,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,SAAS,CAChD,gBAAgB,EAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CACnD,CAAA;QAED,MAAM,EAAE,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAA;QAEhE,+BAA+B;QAC/B,IAAI,cAAkC,CAAA;QACtC,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YACpE,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,OAAO,EAAE;gBAClE,QAAQ,EAAE,kBAAkB;gBAC5B,QAAQ;aACT,CAAC,CAAA;YACF,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAA;YAEtC,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;QACjE,CAAC;QAED,MAAM,EAAE,IAAI,CAAC,yBAAyB,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC,CAAA;QAEzE,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,qCAAqC;YAC9C,YAAY;YACZ,cAAc;YACd,IAAI,EAAE,YAAY;SACnB,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3E,MAAM,EAAE,KAAK,CAAC,sBAAsB,EAAE;YACpC,KAAK,EAAE,YAAY;YACnB,QAAQ;SACT,CAAC,CAAA;QAEF,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAA;IAC1D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAqB,EACrB,IAIC;IAiBD,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,IAAI,CAAA;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAE7B,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAA;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAChD,CAAC;QAED,MAAM,EAAE,IAAI,CAAC,qCAAqC,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAA;QAE1E,mEAAmE;QACnE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAA;YAClE,IAAI,CAAC;gBACH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAC3E,MAAM,IAAI,KAAK,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAA;YACtD,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;QAEtE,iBAAiB;QACjB,MAAM,eAAe,GAAG,MAAM,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QACpE,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAE/E,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QACzC,CAAC;QAED,wBAAwB;QACxB,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAE3D,sBAAsB;QACtB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,YAAY,GAAG;YACnB,SAAS;YACT,UAAU,EAAE,gBAAgB,CAAC,UAAU;YACvC,SAAS,EAAE,eAAe,CAAC,KAAK;YAChC,WAAW,EAAE;gBACX,IAAI,EAAE,eAAe,CAAC,IAAI;gBAC1B,KAAK,EAAE,eAAe,CAAC,KAAK;gBAC5B,IAAI,EAAE,cAAc,CAAC,IAAI;aAC1B;SACF,CAAA;QAED,qBAAqB;QACrB,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QAC3C,MAAM,aAAa,CAAC,eAAe,EAAE,CAAA;QAErC,MAAM,gBAAgB,GAAG,QAAQ,IAAI,aAAa,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QACvF,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,SAAS,CAChD,gBAAgB,EAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CACnD,CAAA;QAED,MAAM,EAAE,IAAI,CAAC,iCAAiC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAA;QAEvE,+BAA+B;QAC/B,IAAI,cAAkC,CAAA;QACtC,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YACpE,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,OAAO,EAAE;gBAClE,QAAQ,EAAE,kBAAkB;gBAC5B,QAAQ;aACT,CAAC,CAAA;YACF,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAA;YAEtC,MAAM,EAAE,IAAI,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;QACxE,CAAC;QAED,MAAM,EAAE,IAAI,CAAC,qCAAqC,EAAE;YAClD,YAAY;YACZ,cAAc;SACf,CAAC,CAAA;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,iDAAiD;YAC1D,YAAY;YACZ,cAAc;YACd,IAAI,EAAE,YAAY;SACnB,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3E,MAAM,EAAE,KAAK,CAAC,kCAAkC,EAAE;YAChD,KAAK,EAAE,YAAY;SACpB,CAAC,CAAA;QAEF,MAAM,IAAI,KAAK,CAAC,qCAAqC,YAAY,EAAE,CAAC,CAAA;IACtE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAqB,EACrB,IAIC;IAeD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,iBAAiB,GAAG,KAAK,EAAE,GAAG,IAAI,CAAA;IAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAE7B,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAA;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAChD,CAAC;QAED,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAA;QAExE,mEAAmE;QACnE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAA;YAClE,IAAI,CAAC;gBACH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAC3E,MAAM,IAAI,KAAK,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAA;YACtD,CAAC;QACH,CAAC;QAED,gEAAgE;QAChE,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;QAEjD,mBAAmB;QACnB,IAAI,IAAwB,CAAA;QAC5B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;YACjE,IAAI,GAAG,UAAU,CAAC,IAAI,CAAA;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;YAC9B,IAAI,GAAG,SAAS,CAAA;QAClB,CAAC;QAED,mBAAmB;QACnB,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QAEjE,qBAAqB;QACrB,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QAErE,sBAAsB;QACtB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,YAAY,GAAG;YACnB,SAAS;YACT,KAAK;YACL,IAAI;YACJ,UAAU,EAAE,EAAE,EAAE,gDAAgD;YAChE,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,MAAM,EAAE,YAAY,CAAC,MAAM;SAC5B,CAAA;QAED,qBAAqB;QACrB,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QAC3C,MAAM,aAAa,CAAC,eAAe,EAAE,CAAA;QAErC,MAAM,gBAAgB,GAAG,QAAQ,IAAI,aAAa,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QACvF,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,SAAS,CAChD,gBAAgB,EAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CACnD,CAAA;QAED,MAAM,EAAE,IAAI,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAA;QAEnE,+BAA+B;QAC/B,IAAI,cAAkC,CAAA;QACtC,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YACpE,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,OAAO,EAAE;gBAClE,QAAQ,EAAE,kBAAkB;aAC7B,CAAC,CAAA;YACF,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAA;YAEtC,MAAM,EAAE,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;QACpE,CAAC;QAED,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE;YACzC,YAAY;YACZ,cAAc;SACf,CAAC,CAAA;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,wCAAwC;YACjD,YAAY;YACZ,cAAc;YACd,IAAI,EAAE,YAAY;SACnB,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3E,MAAM,EAAE,KAAK,CAAC,yBAAyB,EAAE;YACvC,KAAK,EAAE,YAAY;YACnB,KAAK;SACN,CAAC,CAAA;QAEF,MAAM,IAAI,KAAK,CAAC,4BAA4B,YAAY,EAAE,CAAC,CAAA;IAC7D,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Core type definitions for creatoria-miniapp-mcp
+ */
+import type { ChildProcess } from 'child_process';
+export type { MiniProgram, Page, Element, SystemInfo } from './types/miniprogram-automator.js';
+export interface ServerConfig {
+    projectPath?: string;
+    cliPath?: string;
+    port?: number;
+    autoPort?: number;
+    capabilities?: string[];
+    outputDir?: string;
+    timeout?: number;
+    sessionTimeout?: number;
+    logLevel?: LogLevel;
+    enableFileLog?: boolean;
+    logBufferSize?: number;
+    logFlushInterval?: number;
+    enableSessionReport?: boolean;
+    enableFailureSnapshot?: boolean;
+}
+/**
+ * Cached element with page metadata for invalidation
+ */
+export interface CachedElement {
+    element: any;
+    pagePath: string;
+    cachedAt: Date;
+}
+export interface SessionState {
+    sessionId: string;
+    miniProgram?: any;
+    ideProcess?: ChildProcess;
+    pages: any[];
+    elements: Map<string, CachedElement>;
+    currentPagePath?: string;
+    outputDir: string;
+    createdAt: Date;
+    lastActivity: Date;
+    config?: SessionConfig;
+    logger?: Logger;
+    loggerConfig?: LoggerConfig;
+    outputManager?: OutputManager;
+    recording?: RecordingState;
+    reportData?: ReportData;
+}
+export interface SessionConfig {
+    projectPath?: string;
+    cliPath?: string;
+    port?: number;
+    /** Global timeout for all operations (ms). Defaults to 30000 (30s) */
+    timeout?: number;
+    /** Timeout for evaluate operations (ms). Defaults to 5000 (5s) */
+    evaluateTimeout?: number;
+    /** Timeout for launch operations (ms). Defaults to 60000 (60s) */
+    launchTimeout?: number;
+    /** Timeout for screenshot operations (ms). Defaults to 10000 (10s) */
+    screenshotTimeout?: number;
+}
+export interface SessionMetrics {
+    totalSessions: number;
+    activeSessions: number;
+    oldestSession?: {
+        sessionId: string;
+        age: number;
+    };
+    totalElements: number;
+}
+/**
+ * Element reference input - supports multiple ways to locate elements
+ */
+export interface ElementRefInput {
+    refId?: string;
+    selector?: string;
+    xpath?: string;
+    index?: number;
+    pagePath?: string;
+    save?: boolean;
+}
+/**
+ * Resolved element result
+ */
+export interface ResolvedElement {
+    page: any;
+    element: any;
+    refId?: string;
+}
+/**
+ * Log level
+ */
+export type LogLevel = 'info' | 'warn' | 'error' | 'debug';
+/**
+ * Structured log entry
+ */
+export interface LogEntry {
+    timestamp: Date;
+    level: LogLevel;
+    message: string;
+    sessionId?: string;
+    toolName?: string;
+    context?: Record<string, any>;
+}
+/**
+ * Logger configuration
+ */
+export interface LoggerConfig {
+    level?: LogLevel;
+    enableFileLog?: boolean;
+    outputDir?: string;
+    bufferSize?: number;
+    flushInterval?: number;
+    enableFailureSnapshot?: boolean;
+}
+/**
+ * Logger interface for structured logging
+ */
+export interface Logger {
+    info(message: string, context?: Record<string, any>): void;
+    warn(message: string, context?: Record<string, any>): void;
+    error(message: string, context?: Record<string, any>): void;
+    debug(message: string, context?: Record<string, any>): void;
+    child(toolName: string): Logger;
+    dispose?(): Promise<void>;
+    flush?(): Promise<void>;
+}
+/**
+ * Tool execution log entry with timing
+ */
+export interface ToolLogEntry extends LogEntry {
+    toolName: string;
+    phase: 'START' | 'END' | 'ERROR';
+    args?: any;
+    result?: any;
+    error?: string;
+    duration?: number;
+    stackTrace?: string;
+}
+/**
+ * Output file type
+ */
+export type OutputType = 'screenshot' | 'snapshot' | 'log' | 'other';
+/**
+ * Output manager for artifact generation
+ */
+export interface OutputManager {
+    /**
+     * Get output directory for the session
+     */
+    getOutputDir(): string;
+    /**
+     * Generate filename for output artifact
+     */
+    generateFilename(type: OutputType, extension: string): string;
+    /**
+     * Write content to file
+     */
+    writeFile(filename: string, content: Buffer | string): Promise<string>;
+    /**
+     * Check if output directory exists
+     */
+    ensureOutputDir(): Promise<void>;
+}
+/**
+ * Recorded action in a sequence
+ */
+export interface RecordedAction {
+    timestamp: Date;
+    toolName: string;
+    args: Record<string, any>;
+    duration?: number;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Action sequence for recording/replay
+ */
+export interface ActionSequence {
+    id: string;
+    name: string;
+    description?: string;
+    createdAt: Date;
+    actions: RecordedAction[];
+    metadata?: Record<string, any>;
+}
+/**
+ * Recording state
+ */
+export interface RecordingState {
+    isRecording: boolean;
+    currentSequence?: ActionSequence;
+    startedAt?: Date;
+}
+/**
+ * Tool call record for session report (F3)
+ */
+export interface ToolCallRecord {
+    timestamp: Date;
+    toolName: string;
+    duration: number;
+    success: boolean;
+    result?: any;
+    error?: {
+        message: string;
+        snapshotPath?: string;
+    };
+}
+/**
+ * Report data collected during session (F3)
+ */
+export interface ReportData {
+    toolCalls: ToolCallRecord[];
+    startTime: Date;
+    endTime?: Date;
+}
+/**
+ * Session report (JSON format) (F3)
+ */
+export interface SessionReport {
+    sessionId: string;
+    startTime: string;
+    endTime: string;
+    duration: number;
+    summary: {
+        totalCalls: number;
+        successCount: number;
+        failureCount: number;
+        successRate: number;
+        avgDuration: number;
+        maxDuration: number;
+        minDuration: number;
+    };
+    toolCalls: ToolCallRecord[];
+    failures: Array<{
+        toolName: string;
+        timestamp: string;
+        error: string;
+        snapshotPath?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core type definitions for creatoria-miniapp-mcp
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}