@creatoria/miniapp-mcp 0.1.3 → 0.2.2

package/dist/capabilities/registry.js

@@ -0,0 +1,261 @@
+/**
+ * Centralized Tool Registry for MCP Server
+ *
+ * Provides unified tool registration, lookup, and validation.
+ * All capabilities register their tools through this registry.
+ */
+/**
+ * Centralized Tool Registry
+ *
+ * Features:
+ * - Unique tool name enforcement
+ * - Capability-based organization
+ * - Schema and handler management
+ * - MCP Tool type conversion
+ */
+export class ToolRegistry {
+    tools = new Map();
+    capabilities = new Map();
+    /**
+     * Register a single tool definition
+     */
+    register(definition) {
+        if (this.tools.has(definition.name)) {
+            throw new Error(`Duplicate tool registration: ${definition.name}`);
+        }
+        this.tools.set(definition.name, definition);
+    }
+    /**
+     * Register a complete capability module
+     */
+    registerCapability(module) {
+        if (this.capabilities.has(module.name)) {
+            throw new Error(`Duplicate capability registration: ${module.name}`);
+        }
+        this.capabilities.set(module.name, module);
+        // Register all tools from this capability
+        for (const tool of module.tools) {
+            this.register({ ...tool, capability: module.name });
+        }
+    }
+    /**
+     * Get a tool definition by name
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Get handler for a tool
+     */
+    getHandler(name) {
+        return this.tools.get(name)?.handler;
+    }
+    /**
+     * Get all registered tool definitions
+     */
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Get tools by capability name
+     */
+    getByCapability(capabilityName) {
+        return Array.from(this.tools.values()).filter((t) => t.capability === capabilityName);
+    }
+    /**
+     * Get all registered capabilities
+     */
+    getCapabilities() {
+        return Array.from(this.capabilities.values());
+    }
+    /**
+     * Check if a tool exists
+     */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get total number of registered tools
+     */
+    get size() {
+        return this.tools.size;
+    }
+    /**
+     * JSON Schema type for MCP Tool inputSchema
+     */
+    createJsonSchema(properties = {}, required) {
+        return {
+            type: 'object',
+            properties,
+            ...(required && required.length > 0 ? { required } : {}),
+        };
+    }
+    /**
+     * Convert Zod schema to JSON Schema for MCP Tool format
+     */
+    zodToJsonSchema(schema) {
+        // Use zod-to-json-schema or manual conversion
+        // For now, use the shape if available
+        const zodSchema = schema;
+        if (zodSchema._def?.typeName === 'ZodObject') {
+            const shape = zodSchema._def.shape?.();
+            if (shape) {
+                const properties = {};
+                const required = [];
+                for (const [key, value] of Object.entries(shape)) {
+                    const fieldSchema = value;
+                    properties[key] = this.zodFieldToJsonSchema(fieldSchema);
+                    // Check if field is required (not optional)
+                    if (!fieldSchema.isOptional?.()) {
+                        required.push(key);
+                    }
+                }
+                return this.createJsonSchema(properties, required);
+            }
+        }
+        // Fallback for non-object schemas
+        return this.createJsonSchema({});
+    }
+    /**
+     * Convert a single Zod field to JSON Schema
+     */
+    zodFieldToJsonSchema(field) {
+        const typeName = field._def?.typeName;
+        // Handle optional wrapper
+        if (typeName === 'ZodOptional') {
+            return this.zodFieldToJsonSchema(field._def.innerType);
+        }
+        // Handle basic types
+        switch (typeName) {
+            case 'ZodString':
+                return {
+                    type: 'string',
+                    ...(field._def.description ? { description: field._def.description } : {}),
+                };
+            case 'ZodNumber':
+                return {
+                    type: 'number',
+                    ...(field._def.description ? { description: field._def.description } : {}),
+                };
+            case 'ZodBoolean':
+                return {
+                    type: 'boolean',
+                    ...(field._def.description ? { description: field._def.description } : {}),
+                };
+            case 'ZodArray':
+                return {
+                    type: 'array',
+                    items: this.zodFieldToJsonSchema(field._def.type),
+                    ...(field._def.description ? { description: field._def.description } : {}),
+                };
+            case 'ZodEnum':
+                return {
+                    type: 'string',
+                    enum: field._def.values,
+                    ...(field._def.description ? { description: field._def.description } : {}),
+                };
+            case 'ZodObject':
+                return this.zodToJsonSchema(field);
+            default:
+                // Default to any type
+                return { description: field._def?.description };
+        }
+    }
+    /**
+     * Convert registered tools to MCP Tool format
+     */
+    toMCPTools() {
+        return Array.from(this.tools.values()).map((def) => ({
+            name: def.name,
+            description: def.description,
+            inputSchema: this.zodToJsonSchema(def.inputSchema),
+        }));
+    }
+    /**
+     * Convert tools for specific capabilities to MCP Tool format
+     */
+    toMCPToolsForCapabilities(capabilityNames) {
+        // If 'core' is specified, return all tools
+        if (capabilityNames.includes('core')) {
+            return this.toMCPTools();
+        }
+        // Otherwise, filter by capability names
+        return Array.from(this.tools.values())
+            .filter((def) => capabilityNames.includes(def.capability))
+            .map((def) => ({
+            name: def.name,
+            description: def.description,
+            inputSchema: this.zodToJsonSchema(def.inputSchema),
+        }));
+    }
+    /**
+     * Get handlers map for specific capabilities
+     */
+    getHandlersForCapabilities(capabilityNames) {
+        const handlers = new Map();
+        // If 'core' is specified, return all handlers
+        if (capabilityNames.includes('core')) {
+            for (const [name, def] of this.tools) {
+                handlers.set(name, def.handler);
+            }
+            return handlers;
+        }
+        // Otherwise, filter by capability names
+        for (const [name, def] of this.tools) {
+            if (capabilityNames.includes(def.capability)) {
+                handlers.set(name, def.handler);
+            }
+        }
+        return handlers;
+    }
+    /**
+     * Get statistics about registered tools
+     */
+    getStats() {
+        const byCapability = {};
+        for (const def of this.tools.values()) {
+            byCapability[def.capability] = (byCapability[def.capability] || 0) + 1;
+        }
+        return {
+            total: this.tools.size,
+            byCapability,
+        };
+    }
+    /**
+     * Validate all registrations
+     */
+    validate() {
+        const errors = [];
+        for (const def of this.tools.values()) {
+            // Check required fields
+            if (!def.name) {
+                errors.push('Tool missing name');
+            }
+            if (!def.description) {
+                errors.push(`Tool ${def.name} missing description`);
+            }
+            if (!def.handler) {
+                errors.push(`Tool ${def.name} missing handler`);
+            }
+            if (!def.inputSchema) {
+                errors.push(`Tool ${def.name} missing inputSchema`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Clear all registrations (useful for testing)
+     */
+    clear() {
+        this.tools.clear();
+        this.capabilities.clear();
+    }
+}
+/**
+ * Global tool registry instance
+ */
+export const globalRegistry = new ToolRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/capabilities/registry.js.map

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

package/dist/capabilities/schema-registry.d.ts

@@ -0,0 +1,4 @@
+import type { ToolSchemaLookupResult } from './schema-types.js';
+export declare function getToolSchema(toolName: string): ToolSchemaLookupResult | undefined;
+export declare function listToolSchemas(): ToolSchemaLookupResult[];
+//# sourceMappingURL=schema-registry.d.ts.map

package/dist/capabilities/schema-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-registry.d.ts","sourceRoot":"","sources":["../../src/capabilities/schema-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAgB/D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAElF;AAED,wBAAgB,eAAe,IAAI,sBAAsB,EAAE,CAE1D"}

package/dist/capabilities/schema-registry.js

@@ -0,0 +1,18 @@
+import { automatorSchemas } from './automator/schemas/index.js';
+const schemaMap = new Map();
+function registerSchemas(schemas) {
+    for (const schema of schemas) {
+        if (schemaMap.has(schema.name)) {
+            throw new Error(`Duplicate schema definition for tool: ${schema.name}`);
+        }
+        schemaMap.set(schema.name, schema);
+    }
+}
+registerSchemas(automatorSchemas);
+export function getToolSchema(toolName) {
+    return schemaMap.get(toolName);
+}
+export function listToolSchemas() {
+    return Array.from(schemaMap.values());
+}
+//# sourceMappingURL=schema-registry.js.map

package/dist/capabilities/schema-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-registry.js","sourceRoot":"","sources":["../../src/capabilities/schema-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAE/D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAA;AAE3D,SAAS,eAAe,CAAC,OAAiC;IACxD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACzE,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;AACH,CAAC;AAED,eAAe,CAAC,gBAAgB,CAAC,CAAA;AAEjC,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;AACvC,CAAC"}

package/dist/capabilities/schema-types.d.ts

@@ -0,0 +1,22 @@
+import type { ZodTypeAny } from 'zod';
+export interface ToolSchemaDefinition {
+    /** 工具名称，与 MCP 注册名一致 */
+    name: string;
+    /** 能力分组，例如 automator/miniprogram 等 */
+    capability: string;
+    /** 与工具清单描述保持一致的简介 */
+    description: string;
+    /** 输入参数 schema */
+    input: ZodTypeAny;
+    /** 可选输出 schema（后续阶段使用） */
+    output?: ZodTypeAny;
+}
+export type ToolSchemaRegistry = Record<string, ToolSchemaDefinition>;
+export interface ToolSchemaLookupResult {
+    name: string;
+    capability: string;
+    description: string;
+    input: ZodTypeAny;
+    output?: ZodTypeAny;
+}
+//# sourceMappingURL=schema-types.d.ts.map

package/dist/capabilities/schema-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-types.d.ts","sourceRoot":"","sources":["../../src/capabilities/schema-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAErC,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB;IAClB,KAAK,EAAE,UAAU,CAAA;IACjB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAA;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;AAErE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,EAAE,UAAU,CAAA;CACpB"}

package/dist/capabilities/schema-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-types.js.map

package/dist/capabilities/schema-types.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Snapshot handlers exports
+ *
+ * All 3 handlers are now independently implemented in this directory.
+ */
+export { snapshotPage, snapshotFull, snapshotElement, type SnapshotPageArgs, type SnapshotPageResult, type SnapshotFullArgs, type SnapshotFullResult, type SnapshotElementArgs, type SnapshotElementResult, } from './snapshot-handlers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/snapshot/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAA"}

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

@@ -0,0 +1,7 @@
+/**
+ * Snapshot handlers exports
+ *
+ * All 3 handlers are now independently implemented in this directory.
+ */
+export { snapshotPage, snapshotFull, snapshotElement, } from './snapshot-handlers.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/capabilities/snapshot/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,GAOhB,MAAM,wBAAwB,CAAA"}

package/dist/capabilities/snapshot/handlers/snapshot-handlers.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Snapshot handlers - State capture and diagnostic utilities
+ */
+import type { SessionState } from '../../../types.js';
+export interface SnapshotPageArgs {
+    pagePath?: string;
+    filename?: string;
+    includeScreenshot?: boolean;
+    fullPage?: boolean;
+}
+export interface SnapshotPageResult {
+    success: boolean;
+    message: string;
+    snapshotPath: string;
+    screenshotPath?: string;
+    data: {
+        timestamp: string;
+        pagePath: string;
+        pageData: any;
+        pageQuery: Record<string, any>;
+    };
+}
+export declare function snapshotPage(session: SessionState, args: SnapshotPageArgs): Promise<SnapshotPageResult>;
+export interface SnapshotFullArgs {
+    filename?: string;
+    includeScreenshot?: boolean;
+    fullPage?: boolean;
+}
+export interface SnapshotFullResult {
+    success: boolean;
+    message: string;
+    snapshotPath: string;
+    screenshotPath?: string;
+    data: {
+        timestamp: string;
+        systemInfo: any;
+        pageStack: Array<{
+            path: string;
+            query: Record<string, any>;
+        }>;
+        currentPage: {
+            path: string;
+            query: Record<string, any>;
+            data: any;
+        };
+    };
+}
+export declare function snapshotFull(session: SessionState, args: SnapshotFullArgs): Promise<SnapshotFullResult>;
+export interface SnapshotElementArgs {
+    refId: string;
+    filename?: string;
+    includeScreenshot?: boolean;
+}
+export interface SnapshotElementResult {
+    success: boolean;
+    message: string;
+    snapshotPath: string;
+    screenshotPath?: string;
+    data: {
+        timestamp: string;
+        refId: string;
+        text?: string;
+        attributes: Record<string, any>;
+        size: {
+            width: number;
+            height: number;
+        } | null;
+        offset: {
+            left: number;
+            top: number;
+        } | null;
+    };
+}
+export declare function snapshotElement(session: SessionState, args: SnapshotElementArgs): Promise<SnapshotElementResult>;
+//# sourceMappingURL=snapshot-handlers.d.ts.map

package/dist/capabilities/snapshot/handlers/snapshot-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-handlers.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/snapshot/handlers/snapshot-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AASrD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAA;QACjB,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,GAAG,CAAA;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAC/B,CAAA;CACF;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2E7G;AAMD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,GAAG,CAAA;QACf,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;SAAE,CAAC,CAAA;QAC9D,WAAW,EAAE;YACX,IAAI,EAAE,MAAM,CAAA;YACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;YAC1B,IAAI,EAAE,GAAG,CAAA;SACV,CAAA;KACF,CAAA;CACF;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgF7G;AAMD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QAC/B,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;QAC9C,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAC7C,CAAA;CACF;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA+EtH"}

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