docker-flutter-ios-simulator-mcp 0.1.0

package/dist/flutter/process.js

@@ -0,0 +1,241 @@
+import { spawnStreaming } from '../utils/exec.js';
+import { logger } from '../utils/logger.js';
+import { LogBuffer } from './log-buffer.js';
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+export class FlutterProcessManager {
+    process;
+    flutterProcess;
+    logBuffer;
+    logSubscribers = new Set();
+    constructor(maxLogLines = 1000) {
+        this.logBuffer = new LogBuffer(maxLogLines);
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async start(options) {
+        if (this.process) {
+            throw new Error('Flutter process already running');
+        }
+        logger.info('Starting Flutter process', {
+            worktreePath: options.worktreePath,
+            deviceId: options.deviceId,
+        });
+        // Security: Validate target file
+        // Prevents malicious clients from accessing arbitrary files on the system
+        if (options.target) {
+            const targetPath = resolve(options.worktreePath, options.target);
+            // Prevent path traversal attacks (e.g., "../../../etc/passwd")
+            // Ensures the target file is within the project directory boundary
+            if (!targetPath.startsWith(resolve(options.worktreePath))) {
+                throw new Error(`Security: Target file must be within project directory. ` +
+                    `Target: ${options.target}`);
+            }
+            // Validate file exists to provide early feedback
+            if (!existsSync(targetPath)) {
+                throw new Error(`Target file does not exist: ${options.target}`);
+            }
+            // Only .dart files are valid Flutter entry points
+            // Prevents attempts to execute arbitrary file types
+            if (!targetPath.endsWith('.dart')) {
+                throw new Error(`Target must be a Dart file (.dart extension). ` +
+                    `Provided: ${options.target}`);
+            }
+        }
+        // Security: Validate flavor name
+        // Prevents command injection through flavor parameter
+        if (options.flavor) {
+            // Only allow safe characters that cannot break shell command parsing
+            if (!/^[a-zA-Z0-9_-]+$/.test(options.flavor)) {
+                throw new Error(`Invalid flavor name: ${options.flavor}. ` +
+                    `Flavor must contain only letters, numbers, hyphens, and underscores.`);
+            }
+        }
+        // Security: Validate additionalArgs against allowlist
+        // Prevents command injection by only allowing known-safe Flutter arguments
+        // This protects against malicious arguments like "--dart-define=KEY=$(rm -rf /)"
+        if (options.additionalArgs) {
+            const ALLOWED_ARGS = new Set([
+                '--debug',
+                '--release',
+                '--profile',
+                '--no-sound-null-safety',
+                '--enable-software-rendering',
+                '--verbose',
+                '-v',
+            ]);
+            for (const arg of options.additionalArgs) {
+                // Check if argument is in the allowlist
+                if (ALLOWED_ARGS.has(arg)) {
+                    continue;
+                }
+                // Validate --dart-define format more strictly to prevent injection
+                // Example attack prevented: --dart-define=X=$(malicious_command)
+                if (arg.startsWith('--dart-define=')) {
+                    const defineValue = arg.substring('--dart-define='.length);
+                    // Enforce KEY=VALUE where KEY follows identifier rules (alphanumeric/underscore)
+                    // This prevents shell metacharacters and command substitution
+                    if (!/^[A-Za-z_][A-Za-z0-9_]*=.*$/.test(defineValue)) {
+                        throw new Error(`Invalid --dart-define format: ${arg}. ` +
+                            `Expected --dart-define=KEY=VALUE where KEY is alphanumeric/underscore starting with letter or underscore`);
+                    }
+                    continue;
+                }
+                // If we get here, argument is not allowed - reject it
+                throw new Error(`Invalid Flutter argument: ${arg}. ` +
+                    `Allowed arguments: ${Array.from(ALLOWED_ARGS).join(', ')}, --dart-define=KEY=VALUE`);
+            }
+        }
+        const args = ['run', '-d', options.deviceId];
+        if (options.target) {
+            args.push('-t', options.target);
+        }
+        if (options.flavor) {
+            args.push('--flavor', options.flavor);
+        }
+        if (options.additionalArgs) {
+            args.push(...options.additionalArgs);
+        }
+        this.flutterProcess = {
+            pid: 0,
+            status: 'starting',
+            startedAt: new Date(),
+        };
+        this.process = spawnStreaming('flutter', args, {
+            cwd: options.worktreePath,
+            onStdout: (data) => {
+                this.handleOutput(data);
+            },
+            onStderr: (data) => {
+                this.handleOutput(data);
+            },
+            onExit: (code, signal) => {
+                this.handleExit(code, signal);
+            },
+        });
+        if (this.process.pid) {
+            this.flutterProcess.pid = this.process.pid;
+            this.flutterProcess.status = 'running';
+            logger.info('Flutter process started', { pid: this.process.pid });
+        }
+        return this.flutterProcess;
+    }
+    handleOutput(data) {
+        const lines = data.split('\n');
+        for (const line of lines) {
+            if (line.trim()) {
+                this.logBuffer.append(line);
+                this.logSubscribers.forEach((subscriber) => {
+                    try {
+                        subscriber(line);
+                    }
+                    catch (error) {
+                        logger.error('Error in log subscriber', { error: String(error) });
+                    }
+                });
+                this.detectStatusChanges(line);
+            }
+        }
+    }
+    detectStatusChanges(line) {
+        if (!this.flutterProcess)
+            return;
+        if (line.includes('Hot reload') || line.includes('Reloaded')) {
+            this.flutterProcess.status = 'hot-reloading';
+            setTimeout(() => {
+                if (this.flutterProcess) {
+                    this.flutterProcess.status = 'running';
+                }
+            }, 1000);
+        }
+    }
+    handleExit(code, signal) {
+        logger.info('Flutter process exited', { code, signal });
+        if (this.flutterProcess) {
+            this.flutterProcess.status = code === 0 ? 'stopped' : 'failed';
+            this.flutterProcess.stoppedAt = new Date();
+            this.flutterProcess.exitCode = code ?? undefined;
+        }
+        this.process = undefined;
+    }
+    stop() {
+        if (!this.process) {
+            logger.warn('No Flutter process to stop');
+            return false;
+        }
+        logger.info('Stopping Flutter process', { pid: this.process.pid });
+        this.process.stdin.write('q\n');
+        this.process.stdin.end();
+        return true;
+    }
+    hotReload() {
+        if (!this.process) {
+            logger.warn('No Flutter process for hot reload');
+            return false;
+        }
+        logger.info('Triggering hot reload', { pid: this.process.pid });
+        this.process.stdin.write('r\n');
+        return true;
+    }
+    hotRestart() {
+        if (!this.process) {
+            logger.warn('No Flutter process for hot restart');
+            return false;
+        }
+        logger.info('Triggering hot restart', { pid: this.process.pid });
+        this.process.stdin.write('R\n');
+        return true;
+    }
+    kill(signal = 'SIGTERM') {
+        if (!this.process) {
+            return false;
+        }
+        logger.info('Killing Flutter process', { pid: this.process.pid, signal });
+        return this.process.kill(signal);
+    }
+    getStatus() {
+        return this.flutterProcess;
+    }
+    getLogs(fromIndex, limit) {
+        const logs = this.logBuffer.getLogs(fromIndex, limit);
+        return {
+            logs,
+            nextIndex: this.logBuffer.getNextIndex(),
+            totalLines: this.logBuffer.getTotalLines(),
+        };
+    }
+    subscribeToLogs(callback) {
+        this.logSubscribers.add(callback);
+        return () => {
+            this.logSubscribers.delete(callback);
+        };
+    }
+    clearLogs() {
+        this.logBuffer.clear();
+    }
+    async cleanup() {
+        logger.debug('Cleaning up Flutter process manager');
+        this.logSubscribers.clear();
+        // Capture process reference to avoid race condition
+        const currentProcess = this.process;
+        if (currentProcess) {
+            this.stop();
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    logger.warn('Flutter process did not stop gracefully, killing');
+                    this.kill('SIGKILL');
+                    resolve();
+                }, 5000);
+                currentProcess.wait().then(() => {
+                    clearTimeout(timeout);
+                    resolve();
+                }).catch((error) => {
+                    logger.error('Error waiting for process', { error: String(error) });
+                    clearTimeout(timeout);
+                    resolve();
+                });
+            });
+        }
+        this.clearLogs();
+    }
+}
+//# sourceMappingURL=process.js.map

package/dist/flutter/process.js.map

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

package/dist/flutter/types.d.ts

@@ -0,0 +1,31 @@
+export type FlutterProcessStatus = 'starting' | 'running' | 'hot-reloading' | 'stopped' | 'failed';
+export interface FlutterProcess {
+    pid: number;
+    status: FlutterProcessStatus;
+    startedAt: Date;
+    stoppedAt?: Date;
+    exitCode?: number;
+}
+export interface LogEntry {
+    line: string;
+    timestamp: Date;
+    index: number;
+}
+export interface FlutterRunOptions {
+    worktreePath: string;
+    deviceId: string;
+    flavor?: string;
+    target?: string;
+    additionalArgs?: string[];
+}
+export interface FlutterLogsQuery {
+    sessionId: string;
+    fromIndex?: number;
+    limit?: number;
+}
+export interface FlutterLogsResult {
+    logs: LogEntry[];
+    nextIndex: number;
+    totalLines: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/flutter/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/flutter/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,SAAS,GACT,eAAe,GACf,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/flutter/types.js

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

package/dist/flutter/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+import express from 'express';
+import { createMCPServer } from './server.js';
+import { setupTransport } from './transport.js';
+import { sessionManager } from './session/manager.js';
+import { logger } from './utils/logger.js';
+function parseArgs() {
+    const args = process.argv.slice(2);
+    let port = parseInt(process.env.PORT || '3000', 10);
+    let host = process.env.HOST || '127.0.0.1';
+    let help = false;
+    let allowOnly = process.env.ALLOW_ONLY || '/Users/';
+    let maxSessions = parseInt(process.env.MAX_SESSIONS || '10', 10);
+    let preBuildScript = process.env.PRE_BUILD_SCRIPT;
+    let postBuildScript = process.env.POST_BUILD_SCRIPT;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            help = true;
+        }
+        else if (arg === '--port' || arg === '-p') {
+            const portValue = args[++i];
+            if (!portValue || isNaN(parseInt(portValue, 10))) {
+                console.error('Error: --port requires a numeric value');
+                process.exit(1);
+            }
+            port = parseInt(portValue, 10);
+        }
+        else if (arg === '--host') {
+            const hostValue = args[++i];
+            if (!hostValue) {
+                console.error('Error: --host requires a value');
+                process.exit(1);
+            }
+            host = hostValue;
+        }
+        else if (arg === '--allow-only') {
+            const pathValue = args[++i];
+            if (!pathValue) {
+                console.error('Error: --allow-only requires a path value');
+                process.exit(1);
+            }
+            allowOnly = pathValue;
+        }
+        else if (arg === '--max-sessions') {
+            const maxValue = args[++i];
+            if (!maxValue || isNaN(parseInt(maxValue, 10))) {
+                console.error('Error: --max-sessions requires a numeric value');
+                process.exit(1);
+            }
+            maxSessions = parseInt(maxValue, 10);
+            if (maxSessions < 1) {
+                console.error('Error: --max-sessions must be at least 1');
+                process.exit(1);
+            }
+        }
+        else if (arg === '--pre-build-script') {
+            const scriptValue = args[++i];
+            if (!scriptValue) {
+                console.error('Error: --pre-build-script requires a command value');
+                process.exit(1);
+            }
+            preBuildScript = scriptValue;
+        }
+        else if (arg === '--post-build-script') {
+            const scriptValue = args[++i];
+            if (!scriptValue) {
+                console.error('Error: --post-build-script requires a command value');
+                process.exit(1);
+            }
+            postBuildScript = scriptValue;
+        }
+        else {
+            console.error(`Error: Unknown argument: ${arg}`);
+            console.error('Use --help to see available options');
+            process.exit(1);
+        }
+    }
+    return { port, host, help, allowOnly, maxSessions, preBuildScript, postBuildScript };
+}
+function showHelp() {
+    console.log(`
+docker-flutter-ios-simulator-mcp - MCP server for containerized Flutter iOS development
+
+USAGE:
+  docker-flutter-ios-simulator-mcp [OPTIONS]
+
+OPTIONS:
+  -p, --port <port>              Port to listen on (default: 3000)
+      --host <host>              Host address to bind to (default: 127.0.0.1)
+      --allow-only <path>        Only allow Flutter projects under this path (default: /Users/)
+      --max-sessions <number>    Maximum number of concurrent sessions (default: 10)
+      --pre-build-script <cmd>   Command to run before flutter build/run (e.g., "git pull")
+      --post-build-script <cmd>  Command to run after flutter build/run completes
+  -h, --help                     Show this help message
+
+ENVIRONMENT VARIABLES:
+  PORT                      Port to listen on (overridden by --port)
+  HOST                      Host address to bind to (overridden by --host)
+  ALLOW_ONLY                Path prefix for allowed projects (overridden by --allow-only)
+  MAX_SESSIONS              Maximum concurrent sessions (overridden by --max-sessions)
+  PRE_BUILD_SCRIPT          Command to run before builds (overridden by --pre-build-script)
+  POST_BUILD_SCRIPT         Command to run after builds (overridden by --post-build-script)
+  LOG_LEVEL                 Logging level (debug, info, warn, error)
+
+EXAMPLES:
+  docker-flutter-ios-simulator-mcp
+  docker-flutter-ios-simulator-mcp --port 8080
+  docker-flutter-ios-simulator-mcp --port 3000 --host localhost
+  docker-flutter-ios-simulator-mcp --allow-only /Users/alice/projects
+  docker-flutter-ios-simulator-mcp --max-sessions 20
+  docker-flutter-ios-simulator-mcp --pre-build-script "git pull" --post-build-script "echo Done"
+  PORT=8080 docker-flutter-ios-simulator-mcp
+
+SECURITY:
+  By default, only Flutter projects under /Users/ are allowed to prevent
+  malicious MCP clients from accessing system directories like /etc/, /usr/, etc.
+
+For more information, visit: https://github.com/zafnz/docker-flutter-ios-simulator-mcp
+`);
+}
+async function main() {
+    const { port, host, help, allowOnly, maxSessions, preBuildScript, postBuildScript } = parseArgs();
+    if (help) {
+        showHelp();
+        process.exit(0);
+    }
+    // Configure session manager with allowed path prefix and session limit
+    sessionManager.configure(allowOnly, maxSessions, preBuildScript, postBuildScript);
+    const PORT = port;
+    const HOST = host;
+    const app = express();
+    // Middleware
+    app.use(express.json());
+    app.use(express.urlencoded({ extended: true }));
+    // Error handling middleware for JSON parse errors
+    app.use((err, req, res, next) => {
+        if (err instanceof SyntaxError && 'body' in err) {
+            logger.warn('Invalid JSON in request', { error: err.message, path: req.path });
+            res.status(400).json({ error: 'Invalid JSON in request body' });
+            return;
+        }
+        next(err);
+    });
+    const mcpServer = createMCPServer();
+    const transport = setupTransport(app);
+    await mcpServer.connect(transport);
+    app.get('/health', (_req, res) => {
+        res.json({ status: 'ok', timestamp: new Date().toISOString() });
+    });
+    const server = app.listen(PORT, HOST, () => {
+        logger.info('Server started', {
+            host: HOST,
+            port: String(PORT),
+            mcpEndpoint: `http://${HOST}:${String(PORT)}/mcp`,
+        });
+    });
+    server.on('error', (error) => {
+        if (error.code === 'EADDRINUSE') {
+            logger.error(`Port ${String(PORT)} is already in use`);
+            process.exit(1);
+        }
+        else {
+            logger.error('Server error', { error: error.message });
+            process.exit(1);
+        }
+    });
+    const shutdown = async () => {
+        logger.info('Shutting down server');
+        // Forcefully exit after timeout to prevent hanging
+        const forceExitTimeout = setTimeout(() => {
+            logger.warn('Forced shutdown after timeout');
+            process.exit(0);
+        }, 10000);
+        try {
+            await sessionManager.cleanup();
+            await transport.close();
+            server.close(() => {
+                clearTimeout(forceExitTimeout);
+                logger.info('Server closed');
+                process.exit(0);
+            });
+        }
+        catch (error) {
+            logger.error('Error during shutdown', { error: String(error) });
+            clearTimeout(forceExitTimeout);
+            process.exit(1);
+        }
+    };
+    process.on('SIGTERM', () => {
+        shutdown().catch((error) => {
+            logger.error('Fatal error during shutdown', { error: String(error) });
+            process.exit(1);
+        });
+    });
+    process.on('SIGINT', () => {
+        shutdown().catch((error) => {
+            logger.error('Fatal error during shutdown', { error: String(error) });
+            process.exit(1);
+        });
+    });
+}
+main().catch((error) => {
+    logger.error('Fatal error', { error: String(error) });
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAY3C,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACpD,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC;IAC3C,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,SAAS,CAAC;IACpD,IAAI,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IACjE,IAAI,cAAc,GAAuB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACtE,IAAI,eAAe,GAAuB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAExE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;gBACjD,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;gBACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACjC,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC;aAAM,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;aAAM,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC/C,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;gBAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,WAAW,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACrC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;gBAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,KAAK,oBAAoB,EAAE,CAAC;YACxC,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;gBACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,cAAc,GAAG,WAAW,CAAC;QAC/B,CAAC;aAAM,IAAI,GAAG,KAAK,qBAAqB,EAAE,CAAC;YACzC,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,eAAe,GAAG,WAAW,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC;AACvF,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCb,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,SAAS,EAAE,CAAC;IAElG,IAAI,IAAI,EAAE,CAAC;QACT,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,uEAAuE;IACvE,cAAc,CAAC,SAAS,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;IAElF,MAAM,IAAI,GAAG,IAAI,CAAC;IAClB,MAAM,IAAI,GAAG,IAAI,CAAC;IAClB,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,aAAa;IACb,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACxB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEhD,kDAAkD;IAClD,GAAG,CAAC,GAAG,CAAC,CAAC,GAAU,EAAE,GAAoB,EAAE,GAAqB,EAAE,IAA0B,EAAQ,EAAE;QACpG,IAAI,GAAG,YAAY,WAAW,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/E,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAEtC,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEnC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC5B,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;YAClB,WAAW,EAAE,UAAU,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM;SAClD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,CAAC,QAAQ,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAEpC,mDAAmD;QACnD,MAAM,gBAAgB,GAAG,UAAU,CAAC,GAAG,EAAE;YACvC,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;YAExB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBAChB,YAAY,CAAC,gBAAgB,CAAC,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAChE,YAAY,CAAC,gBAAgB,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAClC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAClC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createMCPServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,eAAe,IAAI,SAAS,CAmB3C"}

package/dist/server.js

@@ -0,0 +1,18 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerTools } from './tools/index.js';
+import { logger } from './utils/logger.js';
+export function createMCPServer() {
+    logger.info('Creating MCP server');
+    const server = new McpServer({
+        name: 'docker-flutter-ios-simulator-mcp',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    registerTools(server);
+    logger.info('MCP server created');
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,UAAU,eAAe;IAC7B,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAEnC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtB,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/session/manager.d.ts

@@ -0,0 +1,74 @@
+import { CreateSessionParams, Session, SessionInfo } from './types.js';
+export declare class SessionManager {
+    private allowedPathPrefix;
+    private maxSessions;
+    private preBuildScript?;
+    private postBuildScript?;
+    constructor(allowedPathPrefix?: string, maxSessions?: number);
+    /**
+     * Configure the session manager with security settings.
+     *
+     * @param allowedPathPrefix - Absolute path prefix for allowed Flutter projects (e.g., "/Users/")
+     * @param maxSessions - Optional maximum number of concurrent sessions
+     * @param preBuildScript - Optional command to run before flutter build/run
+     * @param postBuildScript - Optional command to run after flutter build/run
+     *
+     * @example
+     * sessionManager.configure('/Users/alice/projects', 20, 'git pull', 'echo Done');
+     */
+    configure(allowedPathPrefix: string, maxSessions?: number, preBuildScript?: string, postBuildScript?: string): void;
+    /**
+     * Create a new development session with an iOS Simulator.
+     *
+     * Creates a fresh iOS Simulator, boots it, and associates it with the Flutter project directory.
+     * Validates that the project path is within allowed directories and contains a valid Flutter project.
+     *
+     * @param params - Session creation parameters
+     * @param params.worktreePath - Absolute path to Flutter project directory (must contain pubspec.yaml)
+     * @param params.deviceType - iOS device type to simulate (default: "iPhone 16 Pro")
+     *
+     * @returns Session information including unique ID and simulator UDID
+     *
+     * @throws {Error} If session limit is reached
+     * @throws {Error} If path is outside allowed prefix
+     * @throws {Error} If project directory doesn't exist or isn't valid
+     * @throws {Error} If simulator creation or boot fails
+     *
+     * @example
+     * const session = await sessionManager.createSession({
+     *   worktreePath: '/Users/alice/my-flutter-app',
+     *   deviceType: 'iPhone 16 Pro'
+     * });
+     * // Returns: { id: 'uuid...', worktreePath: '...', simulatorUdid: '...', deviceType: '...' }
+     */
+    createSession(params: CreateSessionParams): Promise<SessionInfo>;
+    endSession(sessionId: string): Promise<void>;
+    /**
+     * List all active sessions.
+     *
+     * @returns Array of session information for all active sessions
+     */
+    listSessions(): SessionInfo[];
+    /**
+     * Get detailed information about a specific session.
+     *
+     * @param sessionId - Unique session identifier from createSession()
+     * @returns Session object with full state, or undefined if not found
+     */
+    getSession(sessionId: string): Session | undefined;
+    /**
+     * Get the pre-build script command if configured.
+     *
+     * @returns Pre-build script command, or undefined if not set
+     */
+    getPreBuildScript(): string | undefined;
+    /**
+     * Get the post-build script command if configured.
+     *
+     * @returns Post-build script command, or undefined if not set
+     */
+    getPostBuildScript(): string | undefined;
+    cleanup(): Promise<void>;
+}
+export declare const sessionManager: SessionManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/session/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIvE,qBAAa,cAAc;IACzB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,eAAe,CAAC,CAAS;gBAErB,iBAAiB,SAAY,EAAE,WAAW,SAAK;IAK3D;;;;;;;;;;OAUG;IACH,SAAS,CACP,iBAAiB,EAAE,MAAM,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,EACvB,eAAe,CAAC,EAAE,MAAM,GACvB,IAAI;IAeP;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IA8EhE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4ClD;;;;OAIG;IACH,YAAY,IAAI,WAAW,EAAE;IAI7B;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIlD;;;;OAIG;IACH,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAIvC;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,GAAG,SAAS;IAIlC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAe/B;AAED,eAAO,MAAM,cAAc,gBAAuB,CAAC"}