@creatoria/miniapp-mcp 0.1.0

package/dist/tools/record.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Recording and replay tool implementations
+ * Handles action sequence recording, saving, and replay
+ */
+import type { SessionState, ActionSequence } from '../types.js';
+/**
+ * Start recording actions
+ */
+export declare function startRecording(session: SessionState, args?: {
+    name?: string;
+    description?: string;
+}): Promise<{
+    success: boolean;
+    message: string;
+    sequenceId?: string;
+}>;
+/**
+ * Stop recording and save sequence
+ */
+export declare function stopRecording(session: SessionState, args?: {
+    save?: boolean;
+}): Promise<{
+    success: boolean;
+    message: string;
+    sequenceId?: string;
+    actionCount?: number;
+    filePath?: string;
+}>;
+/**
+ * Record an action (internal helper, called by tool wrapper)
+ *
+ * Thread-safe: Captures recording state atomically to prevent race conditions
+ */
+export declare function recordAction(session: SessionState, toolName: string, args: Record<string, any>, success: boolean, duration?: number, error?: string): void;
+/**
+ * List all saved sequences
+ */
+export declare function listSequences(session: SessionState): Promise<{
+    success: boolean;
+    message: string;
+    sequences: Array<{
+        id: string;
+        name: string;
+        description?: string;
+        createdAt: string;
+        actionCount: number;
+    }>;
+}>;
+/**
+ * Get a specific sequence
+ */
+export declare function getSequence(session: SessionState, args: {
+    sequenceId: string;
+}): Promise<{
+    success: boolean;
+    message: string;
+    sequence: ActionSequence;
+}>;
+/**
+ * Delete a sequence
+ */
+export declare function deleteSequence(session: SessionState, args: {
+    sequenceId: string;
+}): Promise<{
+    success: boolean;
+    message: string;
+}>;
+/**
+ * Replay a recorded sequence
+ */
+export declare function replaySequence(session: SessionState, args: {
+    sequenceId: string;
+    continueOnError?: boolean;
+}): Promise<{
+    success: boolean;
+    message: string;
+    totalActions: number;
+    successCount: number;
+    failureCount: number;
+    results: Array<{
+        toolName: string;
+        success: boolean;
+        error?: string;
+    }>;
+}>;
+//# sourceMappingURL=record.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/tools/record.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAkB,MAAM,aAAa,CAAA;AAwB/E;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EACrB,IAAI,GAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CAChB,GACL,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAC,CAsCD;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,IAAI,GAAE;IACJ,IAAI,CAAC,EAAE,OAAO,CAAA;CACV,GACL,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAC,CAkDD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAgCN;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IAClE,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAC,CAAA;CACH,CAAC,CAuCD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAA;CACnB,GACA,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,cAAc,CAAA;CACzB,CAAC,CA4BD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAA;CACnB,GACA,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAC,CAwBD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,GACA,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,KAAK,CAAC;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,OAAO,EAAE,OAAO,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;CACH,CAAC,CAwFD"}

package/dist/tools/record.js

@@ -0,0 +1,316 @@
+/**
+ * Recording and replay tool implementations
+ * Handles action sequence recording, saving, and replay
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+/**
+ * Generate a unique sequence ID
+ */
+function generateSequenceId() {
+    return `seq_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+/**
+ * Get sequences directory path
+ */
+function getSequencesDir(session) {
+    return path.join(session.outputDir, 'sequences');
+}
+/**
+ * Ensure sequences directory exists
+ */
+async function ensureSequencesDir(session) {
+    const dir = getSequencesDir(session);
+    await fs.mkdir(dir, { recursive: true });
+}
+/**
+ * Start recording actions
+ */
+export async function startRecording(session, args = {}) {
+    const { name = `Recording ${new Date().toISOString()}`, description } = args;
+    const logger = session.logger;
+    try {
+        logger?.info('Starting recording', { name });
+        // Check if already recording
+        if (session.recording?.isRecording) {
+            throw new Error('Already recording. Stop current recording first.');
+        }
+        // Initialize recording state
+        const sequenceId = generateSequenceId();
+        session.recording = {
+            isRecording: true,
+            startedAt: new Date(),
+            currentSequence: {
+                id: sequenceId,
+                name,
+                description,
+                createdAt: new Date(),
+                actions: [],
+            },
+        };
+        logger?.info('Recording started', { sequenceId, name });
+        return {
+            success: true,
+            message: `Recording started: ${name}`,
+            sequenceId,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger?.error('Failed to start recording', { error: errorMessage });
+        throw new Error(`Failed to start recording: ${errorMessage}`);
+    }
+}
+/**
+ * Stop recording and save sequence
+ */
+export async function stopRecording(session, args = {}) {
+    const { save = true } = args;
+    const logger = session.logger;
+    try {
+        logger?.info('Stopping recording');
+        // Check if recording
+        if (!session.recording?.isRecording || !session.recording.currentSequence) {
+            throw new Error('Not currently recording');
+        }
+        const sequence = session.recording.currentSequence;
+        const actionCount = sequence.actions.length;
+        // Stop recording
+        session.recording.isRecording = false;
+        let filePath;
+        // Save sequence if requested
+        if (save) {
+            await ensureSequencesDir(session);
+            const filename = `${sequence.id}.json`;
+            filePath = path.join(getSequencesDir(session), filename);
+            await fs.writeFile(filePath, JSON.stringify(sequence, null, 2), 'utf-8');
+            logger?.info('Sequence saved', {
+                sequenceId: sequence.id,
+                filePath,
+                actionCount,
+            });
+        }
+        // Clear recording state
+        session.recording = undefined;
+        return {
+            success: true,
+            message: `Recording stopped: ${sequence.name} (${actionCount} actions)`,
+            sequenceId: sequence.id,
+            actionCount,
+            filePath,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger?.error('Failed to stop recording', { error: errorMessage });
+        throw new Error(`Failed to stop recording: ${errorMessage}`);
+    }
+}
+/**
+ * Record an action (internal helper, called by tool wrapper)
+ *
+ * Thread-safe: Captures recording state atomically to prevent race conditions
+ */
+export function recordAction(session, toolName, args, success, duration, error) {
+    // Atomically capture recording state
+    const recording = session.recording;
+    if (!recording || !recording.isRecording) {
+        return;
+    }
+    const currentSequence = recording.currentSequence;
+    if (!currentSequence) {
+        return;
+    }
+    try {
+        const action = {
+            timestamp: new Date(),
+            toolName,
+            args,
+            duration,
+            success,
+            error,
+        };
+        // Atomically push action
+        // If recording was stopped between the checks above and here,
+        // the action will still be recorded (which is acceptable - better than losing it)
+        currentSequence.actions.push(action);
+    }
+    catch (error) {
+        // Handle potential race condition where currentSequence becomes invalid
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`Failed to record action for ${toolName}:`, errorMessage);
+        // Silently fail - don't break the actual tool execution
+    }
+}
+/**
+ * List all saved sequences
+ */
+export async function listSequences(session) {
+    const logger = session.logger;
+    try {
+        logger?.info('Listing sequences');
+        await ensureSequencesDir(session);
+        const dir = getSequencesDir(session);
+        const files = await fs.readdir(dir);
+        const sequences = [];
+        for (const file of files) {
+            if (!file.endsWith('.json'))
+                continue;
+            const filePath = path.join(dir, file);
+            const content = await fs.readFile(filePath, 'utf-8');
+            const sequence = JSON.parse(content);
+            sequences.push({
+                id: sequence.id,
+                name: sequence.name,
+                description: sequence.description,
+                createdAt: sequence.createdAt.toString(),
+                actionCount: sequence.actions.length,
+            });
+        }
+        logger?.info('Sequences listed', { count: sequences.length });
+        return {
+            success: true,
+            message: `Found ${sequences.length} sequences`,
+            sequences,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger?.error('Failed to list sequences', { error: errorMessage });
+        throw new Error(`Failed to list sequences: ${errorMessage}`);
+    }
+}
+/**
+ * Get a specific sequence
+ */
+export async function getSequence(session, args) {
+    const { sequenceId } = args;
+    const logger = session.logger;
+    try {
+        logger?.info('Getting sequence', { sequenceId });
+        await ensureSequencesDir(session);
+        const filePath = path.join(getSequencesDir(session), `${sequenceId}.json`);
+        const content = await fs.readFile(filePath, 'utf-8');
+        const sequence = JSON.parse(content);
+        logger?.info('Sequence retrieved', {
+            sequenceId,
+            actionCount: sequence.actions.length,
+        });
+        return {
+            success: true,
+            message: `Sequence retrieved: ${sequence.name}`,
+            sequence,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger?.error('Failed to get sequence', { error: errorMessage, sequenceId });
+        throw new Error(`Failed to get sequence: ${errorMessage}`);
+    }
+}
+/**
+ * Delete a sequence
+ */
+export async function deleteSequence(session, args) {
+    const { sequenceId } = args;
+    const logger = session.logger;
+    try {
+        logger?.info('Deleting sequence', { sequenceId });
+        const filePath = path.join(getSequencesDir(session), `${sequenceId}.json`);
+        await fs.unlink(filePath);
+        logger?.info('Sequence deleted', { sequenceId });
+        return {
+            success: true,
+            message: `Sequence deleted: ${sequenceId}`,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger?.error('Failed to delete sequence', {
+            error: errorMessage,
+            sequenceId,
+        });
+        throw new Error(`Failed to delete sequence: ${errorMessage}`);
+    }
+}
+/**
+ * Replay a recorded sequence
+ */
+export async function replaySequence(session, args) {
+    const { sequenceId, continueOnError = false } = args;
+    const logger = session.logger;
+    try {
+        logger?.info('Replaying sequence', { sequenceId, continueOnError });
+        // Get sequence
+        const { sequence } = await getSequence(session, { sequenceId });
+        // Import tools dynamically
+        const tools = await import('./index.js');
+        const results = [];
+        let successCount = 0;
+        let failureCount = 0;
+        // Replay each action
+        for (const action of sequence.actions) {
+            const startTime = Date.now();
+            try {
+                // Get tool function
+                const toolFn = tools[action.toolName];
+                if (!toolFn || typeof toolFn !== 'function') {
+                    throw new Error(`Tool not found: ${action.toolName}`);
+                }
+                // Execute tool
+                await toolFn(session, action.args);
+                const duration = Date.now() - startTime;
+                logger?.info('Action replayed successfully', {
+                    toolName: action.toolName,
+                    duration,
+                });
+                results.push({
+                    toolName: action.toolName,
+                    success: true,
+                });
+                successCount++;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                const duration = Date.now() - startTime;
+                logger?.error('Action replay failed', {
+                    toolName: action.toolName,
+                    error: errorMessage,
+                    duration,
+                });
+                results.push({
+                    toolName: action.toolName,
+                    success: false,
+                    error: errorMessage,
+                });
+                failureCount++;
+                if (!continueOnError) {
+                    throw new Error(`Replay stopped at action ${action.toolName}: ${errorMessage}`);
+                }
+            }
+        }
+        logger?.info('Sequence replay completed', {
+            sequenceId,
+            totalActions: sequence.actions.length,
+            successCount,
+            failureCount,
+        });
+        return {
+            success: failureCount === 0,
+            message: `Replay completed: ${successCount} success, ${failureCount} failures`,
+            totalActions: sequence.actions.length,
+            successCount,
+            failureCount,
+            results,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger?.error('Failed to replay sequence', {
+            error: errorMessage,
+            sequenceId,
+        });
+        throw new Error(`Failed to replay sequence: ${errorMessage}`);
+    }
+}
+//# sourceMappingURL=record.js.map

package/dist/tools/record.js.map

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

package/dist/tools/snapshot.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Snapshot tools for MCP server
+ * Provides utilities for capturing page and application state snapshots
+ */
+import type { SessionState } from '../types.js';
+/**
+ * Capture a complete page snapshot (data + screenshot)
+ * Includes page data, page info, and screenshot
+ */
+export declare function snapshotPage(session: SessionState, args: {
+    pagePath?: string;
+    filename?: string;
+    includeScreenshot?: boolean;
+    fullPage?: boolean;
+}): Promise<{
+    success: boolean;
+    message: string;
+    snapshotPath: string;
+    screenshotPath?: string;
+    data: {
+        timestamp: string;
+        pagePath: string;
+        pageData: any;
+        pageQuery: Record<string, any>;
+    };
+}>;
+/**
+ * Capture a complete application snapshot
+ * Includes system info, page stack, current page data, and screenshot
+ */
+export declare function snapshotFull(session: SessionState, args: {
+    filename?: string;
+    includeScreenshot?: boolean;
+    fullPage?: boolean;
+}): Promise<{
+    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;
+        };
+    };
+}>;
+/**
+ * Capture an element snapshot (properties + screenshot)
+ * Includes element attributes, properties, size, and optional screenshot
+ */
+export declare function snapshotElement(session: SessionState, args: {
+    refId: string;
+    filename?: string;
+    includeScreenshot?: boolean;
+}): Promise<{
+    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;
+    };
+}>;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/tools/snapshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI/C;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GACA,OAAO,CAAC;IACT,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,CAAC,CA2FD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GACA,OAAO,CAAC;IACT,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,CAAC,CAoGD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,GACA,OAAO,CAAC;IACT,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,CAAC,CAuGD"}