mobile-agent-mcp 0.1.1 → 1.0.1

package/dist/driver/flow-io.js

@@ -0,0 +1,128 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { AgentError, ErrorCode } from '../errors.js';
+import { commandExists, runCommand } from './exec.js';
+import { resolveFlowPath } from './maestro.js';
+const TEMPLATES = {
+    login: `appId: \${APP_ID}
+---
+- launchApp
+- assertVisible: "Login"
+- tapOn: "Login"
+`,
+    deeplink: `appId: \${APP_ID}
+---
+- openLink: \${DEEP_LINK}
+- assertVisible: "Home"
+`,
+    smoke: `appId: \${APP_ID}
+---
+- launchApp
+- assertVisible: "Welcome"
+`,
+};
+function assertFlowName(name) {
+    const trimmed = name.trim();
+    if (!trimmed || trimmed.includes('/') || trimmed.includes('\\') || trimmed.includes('..')) {
+        throw new AgentError(`Invalid flow name: ${name}`, ErrorCode.VALIDATION);
+    }
+    return trimmed.replace(/\.(yaml|yml)$/, '');
+}
+export function resolveFlowFilePath(config, flow) {
+    const safeName = assertFlowName(flow);
+    const candidate = path.resolve(config.flowsDir, `${safeName}.yaml`);
+    const flowsRoot = path.resolve(config.flowsDir);
+    if (!candidate.startsWith(`${flowsRoot}${path.sep}`) && candidate !== flowsRoot) {
+        throw new AgentError(`Flow path escapes flowsDir: ${flow}`, ErrorCode.VALIDATION);
+    }
+    return candidate;
+}
+function basicSyntaxCheck(content) {
+    const issues = [];
+    if (!content.trim()) {
+        issues.push('Flow file is empty');
+        return issues;
+    }
+    const parts = content.split(/^---\s*$/m);
+    if (parts.length < 2) {
+        issues.push('Missing YAML document separator (---)');
+    }
+    const steps = parts.slice(1).join('---').trim();
+    if (!steps) {
+        issues.push('No Maestro steps found after frontmatter');
+    }
+    return issues;
+}
+export function validateFlow(config, flow) {
+    const flowPath = resolveFlowFilePath(config, flow);
+    if (!fs.existsSync(flowPath)) {
+        throw new AgentError(`Flow not found: ${flow}`, ErrorCode.FLOW_NOT_FOUND);
+    }
+    const content = fs.readFileSync(flowPath, 'utf-8');
+    const syntaxIssues = basicSyntaxCheck(content);
+    if (syntaxIssues.length > 0) {
+        return {
+            flow: assertFlowName(flow),
+            flowPath,
+            valid: false,
+            method: 'syntax',
+            issues: syntaxIssues,
+        };
+    }
+    if (commandExists(config.maestroBin)) {
+        const dryRun = runCommand(config.maestroBin, ['test', '--dry-run', flowPath], {
+            cwd: config.projectRoot,
+            allowFailure: true,
+        });
+        if (dryRun.status === 0) {
+            return {
+                flow: assertFlowName(flow),
+                flowPath,
+                valid: true,
+                method: 'maestro_dry_run',
+                issues: [],
+            };
+        }
+        const issues = [dryRun.stderr, dryRun.stdout].filter(Boolean);
+        if (issues.length > 0) {
+            return {
+                flow: assertFlowName(flow),
+                flowPath,
+                valid: false,
+                method: 'maestro_dry_run',
+                issues,
+            };
+        }
+    }
+    return {
+        flow: assertFlowName(flow),
+        flowPath,
+        valid: syntaxIssues.length === 0,
+        method: 'syntax',
+        issues: syntaxIssues,
+    };
+}
+export function writeFlow(config, flow, content, template, overwrite = false) {
+    const safeName = assertFlowName(flow);
+    const flowPath = resolveFlowFilePath(config, safeName);
+    const existed = fs.existsSync(flowPath);
+    if (existed && !overwrite) {
+        throw new AgentError(`Flow already exists: ${flowPath}`, ErrorCode.VALIDATION);
+    }
+    const body = content ?? (template ? TEMPLATES[template] : undefined);
+    if (!body) {
+        throw new AgentError('content or template is required', ErrorCode.VALIDATION);
+    }
+    fs.mkdirSync(config.flowsDir, { recursive: true });
+    fs.writeFileSync(flowPath, body, 'utf-8');
+    return {
+        flow: safeName,
+        flowPath,
+        written: true,
+        overwritten: existed,
+    };
+}
+export function resolveExistingFlowPath(config, flow) {
+    return resolveFlowPath(config, flow);
+}
+//# sourceMappingURL=flow-io.js.map

package/dist/driver/flow-io.js.map

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

package/dist/driver/flows.d.ts

@@ -0,0 +1,3 @@
+export declare function listFlows(flowsDir: string): string[];
+export declare function formatFlowList(flowsDir: string, flows: string[]): string;
+//# sourceMappingURL=flows.d.ts.map

package/dist/driver/flows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/driver/flows.ts"],"names":[],"mappings":"AAIA,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUpD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAKxE"}

package/dist/driver/flows.js

@@ -0,0 +1,20 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { AgentError, ErrorCode } from '../errors.js';
+export function listFlows(flowsDir) {
+    if (!fs.existsSync(flowsDir)) {
+        throw new AgentError(`flowsDir not found: ${flowsDir}`, ErrorCode.FLOW_NOT_FOUND);
+    }
+    return fs
+        .readdirSync(flowsDir)
+        .filter((name) => name.endsWith('.yaml') || name.endsWith('.yml'))
+        .map((name) => name.replace(/\.(yaml|yml)$/, ''))
+        .sort((a, b) => a.localeCompare(b));
+}
+export function formatFlowList(flowsDir, flows) {
+    if (flows.length === 0) {
+        return `No flows in ${flowsDir}`;
+    }
+    return flows.map((flow) => path.join(flowsDir, `${flow}.yaml`)).join('\n');
+}
+//# sourceMappingURL=flows.js.map

package/dist/driver/flows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.js","sourceRoot":"","sources":["../../src/driver/flows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,UAAU,CAAC,uBAAuB,QAAQ,EAAE,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,EAAE;SACN,WAAW,CAAC,QAAQ,CAAC;SACrB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SACjE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;SAChD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,KAAe;IAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,eAAe,QAAQ,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC"}

package/dist/driver/logs.d.ts

@@ -0,0 +1,33 @@
+import type { Platform, ResolvedConfig } from '../config.js';
+import type { LogSnapshot } from '../results/types.js';
+export type LogSource = 'metro' | 'logcat' | 'sim' | 'auto';
+export interface TailLogsOptions {
+    platform: Platform;
+    source?: LogSource;
+    lines?: number;
+}
+export interface CollectLogsOptions extends TailLogsOptions {
+    durationMs?: number;
+}
+export declare function resolveLogSource(platform: Platform, source?: LogSource): Exclude<LogSource, 'auto'>;
+export declare function applyLogFilters(text: string, filters: string[] | undefined): string;
+declare function metroPort(config: ResolvedConfig): number;
+export declare function isMetroPortOpen(port: number): boolean;
+export declare function tailLogsSnapshot(config: ResolvedConfig, options: TailLogsOptions): LogSnapshot;
+export declare function tailLogs(config: ResolvedConfig, options: TailLogsOptions): string;
+export declare function collectLogs(config: ResolvedConfig, options: CollectLogsOptions): Promise<LogSnapshot>;
+export declare function tailLogsFollow(config: ResolvedConfig, options: TailLogsOptions): Promise<number>;
+export declare function checkMetroLog(config: ResolvedConfig): {
+    ok: boolean;
+    message: string;
+};
+export declare function checkLogcatAvailable(): {
+    ok: boolean;
+    message: string;
+};
+export declare function checkSimLogAvailable(): {
+    ok: boolean;
+    message: string;
+};
+export { metroPort };
+//# sourceMappingURL=logs.d.ts.map

package/dist/driver/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/driver/logs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAK5B;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAQnF;AAED,iBAAS,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEjD;AAaD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKrD;AAuED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,WAAW,CAmB9F;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CASjF;AAMD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAoBtB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BhG;AAUD,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAOtF;AAED,wBAAgB,oBAAoB,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUvE;AAED,wBAAgB,oBAAoB,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAYvE;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/driver/logs.js

@@ -0,0 +1,199 @@
+import { spawn } from 'node:child_process';
+import { AgentError, ErrorCode } from '../errors.js';
+import { commandExists, runCommand } from './exec.js';
+const MAX_COLLECT_DURATION_MS = 10_000;
+const COLLECT_POLL_MS = 500;
+export function resolveLogSource(platform, source) {
+    if (source && source !== 'auto') {
+        return source;
+    }
+    return platform === 'android' ? 'logcat' : 'sim';
+}
+export function applyLogFilters(text, filters) {
+    if (!filters?.length) {
+        return text;
+    }
+    return text
+        .split('\n')
+        .filter((line) => filters.some((filter) => line.includes(filter)))
+        .join('\n');
+}
+function metroPort(config) {
+    return config.log?.metroPort ?? config.devServerUrl?.port ?? 8081;
+}
+function androidPackage(config) {
+    const pkg = config.log?.androidPackage ?? config.maestroAppIds.android;
+    if (!pkg) {
+        throw new AgentError('log.androidPackage or maestro.appId.android required for logcat', ErrorCode.NOT_CONFIGURED);
+    }
+    return pkg;
+}
+export function isMetroPortOpen(port) {
+    const result = runCommand('curl', ['-sf', `http://127.0.0.1:${port}/status`], {
+        allowFailure: true,
+    });
+    return result.status === 0;
+}
+function tailLogcatText(config, lines) {
+    if (!commandExists('adb')) {
+        throw new AgentError('adb not installed', ErrorCode.TOOL_UNAVAILABLE);
+    }
+    const pkg = androidPackage(config);
+    const pidResult = runCommand('adb', ['shell', 'pidof', '-s', pkg], { allowFailure: true });
+    const pid = pidResult.stdout.trim();
+    const args = ['logcat', '-d', '-t', String(lines)];
+    if (pid) {
+        args.push('--pid', pid);
+    }
+    const result = runCommand('adb', args, { allowFailure: true });
+    let output = [result.stdout, result.stderr].filter(Boolean).join('\n');
+    output = applyLogFilters(output, config.log?.filters);
+    if (!output.trim()) {
+        return `logcat: no lines matched (package ${pkg})`;
+    }
+    return output;
+}
+function tailSimText(lines, filters) {
+    if (process.platform !== 'darwin') {
+        throw new AgentError('iOS sim logs require macOS', ErrorCode.TOOL_UNAVAILABLE);
+    }
+    const result = runCommand('log', ['show', '--style', 'compact', '--last', '1m'], {
+        allowFailure: true,
+        timeoutMs: 15_000,
+    });
+    const rows = (result.stdout || result.stderr).split('\n').slice(-lines);
+    const output = applyLogFilters(rows.join('\n'), filters);
+    return output.trim() || 'sim: no log lines in the last minute';
+}
+function buildSnapshot(platform, source, text, metroReachable) {
+    const lines = text.split('\n').filter((line) => line.length > 0);
+    return {
+        platform,
+        source,
+        text,
+        lineCount: lines.length,
+        truncated: false,
+        metroReachable,
+    };
+}
+function tailMetroSnapshot(config, platform, lines) {
+    const port = metroPort(config);
+    const up = isMetroPortOpen(port);
+    const filters = config.log?.filters ?? ['ReactNative', 'Expo', 'Metro'];
+    if (!up) {
+        throw new AgentError(`Metro not responding on port ${port}`, ErrorCode.LOG_SOURCE_UNAVAILABLE);
+    }
+    const body = platform === 'android' ? tailLogcatText(config, lines) : tailSimText(lines, filters);
+    return buildSnapshot(platform, 'metro', body, true);
+}
+export function tailLogsSnapshot(config, options) {
+    const lines = options.lines ?? 100;
+    const source = resolveLogSource(options.platform, options.source);
+    if (source === 'logcat') {
+        if (options.platform !== 'android') {
+            throw new AgentError('logcat is Android only', ErrorCode.VALIDATION);
+        }
+        return buildSnapshot(options.platform, 'logcat', tailLogcatText(config, lines));
+    }
+    if (source === 'sim') {
+        if (options.platform !== 'ios') {
+            throw new AgentError('sim logs are iOS only', ErrorCode.VALIDATION);
+        }
+        return buildSnapshot(options.platform, 'sim', tailSimText(lines, config.log?.filters));
+    }
+    return tailMetroSnapshot(config, options.platform, lines);
+}
+export function tailLogs(config, options) {
+    const snapshot = tailLogsSnapshot(config, options);
+    if (snapshot.metroReachable === false) {
+        return `Metro not responding\n\n${snapshot.text}`;
+    }
+    if (snapshot.metroReachable) {
+        return `Metro reachable\n\n${snapshot.text}`;
+    }
+    return snapshot.text;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function collectLogs(config, options) {
+    const durationMs = Math.min(options.durationMs ?? 0, MAX_COLLECT_DURATION_MS);
+    const lines = options.lines ?? 100;
+    if (durationMs <= 0) {
+        return tailLogsSnapshot(config, options);
+    }
+    const deadline = Date.now() + durationMs;
+    let latest = tailLogsSnapshot(config, { ...options, lines });
+    while (Date.now() < deadline) {
+        await sleep(COLLECT_POLL_MS);
+        const next = tailLogsSnapshot(config, { ...options, lines });
+        if (next.text !== latest.text) {
+            latest = { ...next, truncated: next.lineCount >= lines };
+        }
+    }
+    return { ...latest, truncated: latest.lineCount >= lines };
+}
+export function tailLogsFollow(config, options) {
+    const source = resolveLogSource(options.platform, options.source);
+    if (source === 'logcat') {
+        if (options.platform !== 'android') {
+            return Promise.reject(new AgentError('logcat is Android only', ErrorCode.VALIDATION));
+        }
+        if (!commandExists('adb')) {
+            return Promise.reject(new AgentError('adb not installed', ErrorCode.TOOL_UNAVAILABLE));
+        }
+        const pkg = androidPackage(config);
+        const pidResult = runCommand('adb', ['shell', 'pidof', '-s', pkg], { allowFailure: true });
+        const pid = pidResult.stdout.trim();
+        const args = pid ? ['logcat', '--pid', pid] : ['logcat'];
+        return streamCommand('adb', args);
+    }
+    if (source === 'sim') {
+        if (process.platform !== 'darwin') {
+            return Promise.reject(new AgentError('iOS sim logs require macOS', ErrorCode.TOOL_UNAVAILABLE));
+        }
+        return streamCommand('log', ['stream', '--style', 'compact']);
+    }
+    return Promise.reject(new AgentError('follow mode supports logcat or sim only', ErrorCode.VALIDATION));
+}
+function streamCommand(command, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: 'inherit' });
+        child.on('error', reject);
+        child.on('close', (code) => resolve(code ?? 1));
+    });
+}
+export function checkMetroLog(config) {
+    const port = metroPort(config);
+    const up = isMetroPortOpen(port);
+    return {
+        ok: up,
+        message: up ? `Metro on :${port}` : `Metro not on :${port}`,
+    };
+}
+export function checkLogcatAvailable() {
+    if (!commandExists('adb')) {
+        return { ok: false, message: 'adb not installed' };
+    }
+    const adb = runCommand('adb', ['devices'], { allowFailure: true });
+    const hasDevice = adb.stdout.split('\n').some((line) => line.trim().endsWith('device'));
+    return {
+        ok: hasDevice,
+        message: hasDevice ? 'logcat ready' : 'adb installed but no device',
+    };
+}
+export function checkSimLogAvailable() {
+    if (process.platform !== 'darwin') {
+        return { ok: false, message: 'sim logs require macOS' };
+    }
+    const booted = runCommand('xcrun', ['simctl', 'list', 'devices', 'booted'], {
+        allowFailure: true,
+    });
+    const hasBooted = booted.stdout.includes('Booted');
+    return {
+        ok: hasBooted,
+        message: hasBooted ? 'sim log stream ready' : 'no booted iOS simulator',
+    };
+}
+export { metroPort };
+//# sourceMappingURL=logs.js.map

package/dist/driver/logs.js.map

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

package/dist/driver/maestro.d.ts

@@ -1,11 +1,31 @@
 import type { Platform, ResolvedConfig } from '../config.js';
+import type { FlowRunResult, SmokeRunResult } from '../results/types.js';
 export interface RunFlowOptions {
     flow: string;
     platform?: Platform;
     env?: Record<string, string>;
     captureAfter?: boolean;
 }
+export interface RunFlowContextOptions extends RunFlowOptions {
+    logLines?: number;
+}
+export declare function resolveFlowPath(config: ResolvedConfig, flow: string): string;
 export declare function requireMaestro(bin: string): void;
-export declare function runMaestroFlow(config: ResolvedConfig, options: RunFlowOptions): string;
-export declare function runMaestroFlows(config: ResolvedConfig, flows: string[], options: Omit<RunFlowOptions, 'flow'>): string;
+export declare function runMaestroFlowCore(config: ResolvedConfig, options: RunFlowOptions): FlowRunResult;
+export declare function runMaestroFlow(config: ResolvedConfig, options: RunFlowOptions): FlowRunResult;
+export declare function runMaestroFlowWithContext(config: ResolvedConfig, options: RunFlowContextOptions): {
+    logs: import("../results/types.js").LogSnapshot;
+    diagnosis: import("../results/types.js").Diagnosis | null;
+    flow: string;
+    flowPath: string;
+    platform: Platform;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    env: Record<string, string>;
+    screenshot: import("../results/types.js").ScreenshotResult | null;
+    ok: boolean;
+};
+export declare function runMaestroFlows(config: ResolvedConfig, flows: string[], options: Omit<RunFlowOptions, 'flow'>): SmokeRunResult;
+export declare function runMaestroFlowsAll(config: ResolvedConfig, flows: string[], options: Omit<RunFlowOptions, 'flow'>): SmokeRunResult;
 //# sourceMappingURL=maestro.d.ts.map

package/dist/driver/maestro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"maestro.d.ts","sourceRoot":"","sources":["../../src/driver/maestro.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM7D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAsBD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAOhD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAoDtF;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GACpC,MAAM,CAMR"}
+{"version":3,"file":"maestro.d.ts","sourceRoot":"","sources":["../../src/driver/maestro.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAoB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO3F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB5E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAOhD;AAgDD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAwBjG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAU7F;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB;;;;;;;;;;;;EAoD/F;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GACpC,cAAc,CA6BhB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GACpC,cAAc,CA4BhB"}