@opentabs-dev/cli 0.0.1

package/dist/commands/dev.js

@@ -0,0 +1,128 @@
+/**
+ * `opentabs dev` command — starts the MCP server with hot reload.
+ *
+ * Server output is written to both the terminal and a log file at
+ * ~/.opentabs/server.log (or $OPENTABS_CONFIG_DIR/server.log).
+ * The `opentabs logs` command tails this file.
+ */
+import { getConfigDir, getLogFilePath } from '../config.js';
+import { parsePort, resolvePort } from '../parse-port.js';
+import { InvalidArgumentError } from 'commander';
+import pc from 'picocolors';
+import { mkdirSync, createWriteStream } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const LOG_LEVELS = ['debug', 'info', 'warn', 'error', 'silent'];
+const resolveServerEntry = () => {
+    try {
+        return fileURLToPath(import.meta.resolve('@opentabs-dev/mcp-server'));
+    }
+    catch {
+        const cliDir = dirname(fileURLToPath(import.meta.url));
+        return resolve(cliDir, '..', '..', '..', 'mcp-server', 'dist', 'index.js');
+    }
+};
+const isPortInUse = async (port) => {
+    try {
+        await fetch(`http://localhost:${port}/health`, {
+            signal: AbortSignal.timeout(1_000),
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Pipe a readable stream to both a terminal writable and a log file stream.
+ * Returns when the readable stream ends.
+ */
+const teeStream = async (readable, terminal, logFile) => {
+    const reader = readable.getReader();
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        terminal.write(value);
+        logFile.write(value);
+    }
+};
+const handleDev = async (options) => {
+    const serverEntry = resolveServerEntry();
+    if (!(await Bun.file(serverEntry).exists())) {
+        console.error(pc.red(`Error: MCP server entry not found at ${serverEntry}`));
+        console.error('Run bun run build from the project root first.');
+        process.exit(1);
+    }
+    const port = resolvePort(options);
+    if (await isPortInUse(port)) {
+        console.error(pc.red(`Error: Port ${port} is already in use.`));
+        console.error(port === 9515
+            ? 'Another OpenTabs server may already be running. Use --port to specify a different port.'
+            : `Use a different port with: opentabs dev --port <number>`);
+        process.exit(1);
+    }
+    const env = { ...process.env };
+    env.PORT = String(port);
+    if (options.verbose)
+        env.OPENTABS_LOG_LEVEL = 'debug';
+    else if (options.logLevel)
+        env.OPENTABS_LOG_LEVEL = options.logLevel;
+    const logFilePath = getLogFilePath();
+    mkdirSync(getConfigDir(), { recursive: true });
+    const logStream = createWriteStream(logFilePath, { flags: 'a' });
+    console.log(`Starting OpenTabs MCP server on port ${pc.bold(String(port))}...`);
+    console.log('');
+    console.log(`  ${pc.cyan('MCP endpoint:')}  http://localhost:${port}/mcp`);
+    console.log(`  ${pc.cyan('Health check:')}  http://localhost:${port}/health`);
+    console.log(`  ${pc.cyan('Log file:')}     ${logFilePath}`);
+    console.log('');
+    console.log(pc.dim('  MCP client config (~/.claude/settings/mcp.json):'));
+    console.log(pc.dim(`  { "mcpServers": { "opentabs": { "type": "streamable-http", "url": "http://127.0.0.1:${port}/mcp" } } }`));
+    console.log('');
+    if (options.verbose)
+        console.log(pc.yellow('  Debug logging enabled'));
+    console.log(pc.dim('  Press Ctrl+C to stop'));
+    console.log('');
+    const proc = Bun.spawn(['bun', '--hot', serverEntry], {
+        env: env,
+        stdio: ['inherit', 'pipe', 'pipe'],
+    });
+    const stdoutPipe = teeStream(proc.stdout, process.stdout, logStream);
+    const stderrPipe = teeStream(proc.stderr, process.stderr, logStream);
+    process.on('SIGINT', () => proc.kill('SIGINT'));
+    process.on('SIGTERM', () => proc.kill('SIGTERM'));
+    await Promise.all([stdoutPipe, stderrPipe]);
+    logStream.end();
+    const exitCode = await proc.exited;
+    process.exit(exitCode);
+};
+export const registerDevCommand = (program) => {
+    program
+        .command('dev')
+        .description('Start the MCP server with hot reload')
+        .option('--port <number>', 'Server port (default: 9515)', parsePort)
+        .option('--verbose', 'Enable debug logging (shorthand for --log-level debug)')
+        .option('--log-level <level>', 'Set log level', (value) => {
+        if (!LOG_LEVELS.includes(value)) {
+            throw new InvalidArgumentError(`Must be one of: ${LOG_LEVELS.join(', ')}`);
+        }
+        return value;
+    })
+        .addHelpText('after', `
+Examples:
+  $ opentabs dev
+  $ opentabs dev --port 3000
+  $ opentabs dev --verbose
+  $ opentabs dev --log-level warn`)
+        .action((_options, command) => {
+        const opts = command.optsWithGlobals();
+        if (opts.verbose && opts.logLevel) {
+            console.error(pc.red('Error: --verbose and --log-level cannot be used together.'));
+            console.error('Use --verbose for debug logging, or --log-level to set a specific level.');
+            process.exit(1);
+        }
+        return handleDev(opts);
+    });
+};
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `opentabs doctor` command — diagnoses the entire OpenTabs setup.
+ */
+import type { Command } from 'commander';
+declare const registerDoctorCommand: (program: Command) => void;
+export { registerDoctorCommand };
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6PzC,QAAA,MAAM,qBAAqB,GAAI,SAAS,OAAO,KAAG,IAajD,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/commands/doctor.js

@@ -0,0 +1,212 @@
+/**
+ * `opentabs doctor` command — diagnoses the entire OpenTabs setup.
+ */
+import { getConfigPath, getPluginsFromConfig, readConfig, resolvePluginPath } from '../config.js';
+import { parsePort, resolvePort } from '../parse-port.js';
+import pc from 'picocolors';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const pass = (label, detail) => ({ label, ok: true, detail, fatal: false });
+const warn = (label, detail, hint) => ({
+    label,
+    ok: false,
+    detail,
+    hint,
+    fatal: false,
+});
+const fail = (label, detail, hint) => ({
+    label,
+    ok: false,
+    detail,
+    hint,
+    fatal: true,
+});
+const checkBunVersion = () => {
+    const bunVersion = typeof Bun !== 'undefined' ? Bun.version : undefined;
+    if (bunVersion) {
+        return pass('Bun runtime', `v${bunVersion}`);
+    }
+    return fail('Bun runtime', 'not detected', 'Install Bun: https://bun.sh');
+};
+const checkConfigFile = async () => {
+    const configPath = getConfigPath();
+    const config = await readConfig(configPath);
+    if (config) {
+        return { result: pass('Config file', configPath), config };
+    }
+    return {
+        result: warn('Config file', `not found at ${configPath}`, 'Run opentabs dev to create one automatically'),
+        config: null,
+    };
+};
+const checkServerHealth = async (port) => {
+    const url = `http://localhost:${port}/health`;
+    try {
+        const res = await fetch(url, { signal: AbortSignal.timeout(3_000) });
+        if (!res.ok) {
+            return {
+                result: fail('MCP server', `HTTP ${res.status}`, 'Check server logs for errors'),
+                data: null,
+            };
+        }
+        const data = (await res.json());
+        const version = typeof data.version === 'string' ? data.version : 'unknown';
+        return { result: pass('MCP server', `running (v${version}) on port ${port}`), data };
+    }
+    catch {
+        const portSuffix = port !== 9515 ? ` --port ${port}` : '';
+        const hint = `Start it with: opentabs dev${portSuffix}`;
+        return {
+            result: fail('MCP server', 'not reachable', hint),
+            data: null,
+        };
+    }
+};
+const checkExtensionConnected = (data) => {
+    if (!data) {
+        return warn('Extension connection', 'unknown (server not reachable)', 'Start the MCP server first');
+    }
+    if (data.extensionConnected === true) {
+        return pass('Extension connection', 'connected');
+    }
+    return warn('Extension connection', 'not connected', 'Open Chrome and ensure the OpenTabs extension is loaded and enabled');
+};
+const checkExtensionInstalled = async () => {
+    const extensionDir = join(homedir(), '.opentabs', 'extension');
+    const manifestPath = join(extensionDir, 'manifest.json');
+    if (!existsSync(manifestPath)) {
+        return {
+            result: warn('Extension installed', `not found at ${extensionDir}`, 'Run opentabs setup to install the extension'),
+            versionFile: null,
+        };
+    }
+    const versionPath = join(extensionDir, '.opentabs-version');
+    const versionFile = (await Bun.file(versionPath).exists()) ? await Bun.file(versionPath).text() : null;
+    return {
+        result: pass('Extension installed', extensionDir),
+        versionFile: versionFile?.trim() ?? null,
+    };
+};
+const checkExtensionVersion = async (installedVersion) => {
+    const cliDir = dirname(fileURLToPath(import.meta.url));
+    let cliVersion = 'unknown';
+    try {
+        const pkgJson = JSON.parse(await Bun.file(join(cliDir, '..', '..', 'package.json')).text());
+        cliVersion = pkgJson.version;
+    }
+    catch {
+        return warn('Extension version', 'could not read CLI version', 'Ensure @opentabs-dev/cli package.json is accessible');
+    }
+    if (!installedVersion) {
+        return warn('Extension version', 'no version marker found', 'Run opentabs setup to install a versioned extension');
+    }
+    if (installedVersion === cliVersion) {
+        return pass('Extension version', `v${cliVersion} (matches CLI)`);
+    }
+    return warn('Extension version', `v${installedVersion} (CLI is v${cliVersion})`, 'Run opentabs setup to update the extension');
+};
+const checkPlugins = async (config) => {
+    if (!config) {
+        return [warn('Plugins', 'no config to check', 'Create a config file first')];
+    }
+    const configPath = getConfigPath();
+    const pluginPaths = getPluginsFromConfig(config);
+    if (pluginPaths.length === 0) {
+        return [warn('Plugins', 'none configured', 'Add a plugin with: opentabs plugin add <path>')];
+    }
+    const results = [];
+    for (const pluginPath of pluginPaths) {
+        const resolvedPath = resolvePluginPath(pluginPath, configPath);
+        if (!existsSync(resolvedPath)) {
+            results.push(fail(`Plugin ${pluginPath}`, 'directory not found', `Check path: ${resolvedPath}`));
+            continue;
+        }
+        const manifestPath = join(resolvedPath, 'opentabs-plugin.json');
+        if (!existsSync(manifestPath)) {
+            results.push(warn(`Plugin ${pluginPath}`, 'manifest not found', 'Run opentabs build in the plugin directory'));
+            continue;
+        }
+        const iifePath = join(resolvedPath, 'dist', 'adapter.iife.js');
+        if (!existsSync(iifePath)) {
+            results.push(warn(`Plugin ${pluginPath}`, 'adapter IIFE not found', 'Run opentabs build in the plugin directory'));
+            continue;
+        }
+        let manifestName = pluginPath;
+        try {
+            const data = await Bun.file(manifestPath).json();
+            if (data !== null && typeof data === 'object' && 'name' in data) {
+                const d = data;
+                manifestName = d.name;
+            }
+        }
+        catch {
+            // Manifest unreadable — fall back to path
+        }
+        results.push(pass(`Plugin ${manifestName}`, 'manifest + IIFE present'));
+    }
+    return results;
+};
+const handleDoctor = async (options) => {
+    const port = resolvePort(options);
+    const results = [];
+    // 1. Bun version
+    results.push(checkBunVersion());
+    // 2. Config file
+    const { result: configResult, config } = await checkConfigFile();
+    results.push(configResult);
+    // 3. MCP server health
+    const { result: serverResult, data: healthData } = await checkServerHealth(port);
+    results.push(serverResult);
+    // 4. Extension connected
+    results.push(checkExtensionConnected(healthData));
+    // 5. Extension installed
+    const { result: installedResult, versionFile } = await checkExtensionInstalled();
+    results.push(installedResult);
+    // 6. Extension version matches CLI
+    results.push(await checkExtensionVersion(versionFile));
+    // 7. Plugin checks
+    const pluginResults = await checkPlugins(config);
+    results.push(...pluginResults);
+    // Print results
+    console.log(pc.bold('OpenTabs Doctor'));
+    console.log('');
+    let hasFatal = false;
+    for (const r of results) {
+        const icon = r.ok ? pc.green('\u2713') : r.fatal ? pc.red('\u2717') : pc.yellow('!');
+        const label = r.ok ? r.label : r.fatal ? pc.red(r.label) : pc.yellow(r.label);
+        console.log(`  ${icon} ${label}: ${r.detail}`);
+        if (!r.ok && r.hint) {
+            console.log(`    ${pc.dim(r.hint)}`);
+        }
+        if (r.fatal)
+            hasFatal = true;
+    }
+    console.log('');
+    const passed = results.filter(r => r.ok).length;
+    const total = results.length;
+    if (hasFatal) {
+        console.log(pc.red(`${passed}/${total} checks passed. Fix the errors above to proceed.`));
+        process.exit(1);
+    }
+    else if (passed < total) {
+        console.log(pc.yellow(`${passed}/${total} checks passed. Some warnings above may need attention.`));
+    }
+    else {
+        console.log(pc.green(`All ${total} checks passed. Your OpenTabs setup looks good!`));
+    }
+};
+const registerDoctorCommand = (program) => {
+    program
+        .command('doctor')
+        .description('Diagnose your OpenTabs setup')
+        .option('--port <number>', 'MCP server port to check (default: 9515)', parsePort)
+        .addHelpText('after', `
+Examples:
+  $ opentabs doctor
+  $ opentabs doctor --port 3000`)
+        .action((_options, command) => handleDoctor(command.optsWithGlobals()));
+};
+export { registerDoctorCommand };
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/index.d.ts

@@ -0,0 +1,10 @@
+export { registerBuildCommand } from './build.js';
+export { registerConfigCommand } from './config.js';
+export { registerDevCommand } from './dev.js';
+export { registerDoctorCommand } from './doctor.js';
+export { registerLogsCommand } from './logs.js';
+export { registerReloadCommand } from './reload.js';
+export { registerStatusCommand } from './status.js';
+export { registerSetupCommand } from './setup.js';
+export { registerPluginCommand } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,10 @@
+export { registerBuildCommand } from './build.js';
+export { registerConfigCommand } from './config.js';
+export { registerDevCommand } from './dev.js';
+export { registerDoctorCommand } from './doctor.js';
+export { registerLogsCommand } from './logs.js';
+export { registerReloadCommand } from './reload.js';
+export { registerStatusCommand } from './status.js';
+export { registerSetupCommand } from './setup.js';
+export { registerPluginCommand } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/commands/logs.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `opentabs logs` command — tails the MCP server log output.
+ *
+ * The log file is written by `opentabs dev` at ~/.opentabs/server.log
+ * (or $OPENTABS_CONFIG_DIR/server.log).
+ */
+import type { Command } from 'commander';
+declare const registerLogsCommand: (program: Command) => void;
+export { registerLogsCommand };
+//# sourceMappingURL=logs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/commands/logs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8FzC,QAAA,MAAM,mBAAmB,GAAI,SAAS,OAAO,KAAG,IAe/C,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/commands/logs.js

@@ -0,0 +1,103 @@
+/**
+ * `opentabs logs` command — tails the MCP server log output.
+ *
+ * The log file is written by `opentabs dev` at ~/.opentabs/server.log
+ * (or $OPENTABS_CONFIG_DIR/server.log).
+ */
+import { getLogFilePath } from '../config.js';
+import { InvalidArgumentError } from 'commander';
+import pc from 'picocolors';
+import { existsSync, statSync, createReadStream, watch } from 'node:fs';
+const DEFAULT_LINES = 50;
+/** Read buffer size for reverse-seek tail (64KB bounds memory usage) */
+const TAIL_BUFFER_SIZE = 64 * 1024;
+/**
+ * Read the last N lines from a file using a reverse-seek approach.
+ * Reads at most TAIL_BUFFER_SIZE bytes from the end instead of the entire file.
+ * Returns the tail content as a string and the file size (for follow offset).
+ */
+const tailFile = async (filePath, lineCount) => {
+    const file = Bun.file(filePath);
+    const fileSize = file.size;
+    if (lineCount <= 0 || fileSize === 0)
+        return { content: '', fileSize };
+    const readStart = Math.max(0, fileSize - TAIL_BUFFER_SIZE);
+    const chunk = await file.slice(readStart, fileSize).text();
+    const lines = chunk.split('\n');
+    // If we didn't read from the start, the first line may be partial — skip it
+    if (readStart > 0)
+        lines.shift();
+    const tail = lines.slice(-lineCount);
+    return { content: tail.join('\n'), fileSize };
+};
+/**
+ * Follow (tail -f) a log file. Watches for changes and streams new content.
+ * Returns a promise that never resolves (runs until the process exits).
+ */
+const followFile = async (filePath, initialOffset) => {
+    let offset = initialOffset;
+    const readNewContent = () => {
+        const currentSize = statSync(filePath).size;
+        if (currentSize < offset) {
+            // File was truncated (e.g., new server start) — read from beginning
+            offset = 0;
+        }
+        if (currentSize <= offset)
+            return;
+        const stream = createReadStream(filePath, { start: offset, encoding: 'utf-8' });
+        stream.on('data', (chunk) => {
+            process.stdout.write(chunk);
+        });
+        offset = currentSize;
+    };
+    const watcher = watch(filePath, () => readNewContent());
+    process.on('SIGINT', () => {
+        watcher.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        watcher.close();
+        process.exit(0);
+    });
+    return new Promise(() => {
+        // Runs forever until interrupted
+    });
+};
+const parseLines = (value) => {
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 0) {
+        throw new InvalidArgumentError('Must be a non-negative integer.');
+    }
+    return n;
+};
+const handleLogs = async (options) => {
+    const logFilePath = getLogFilePath();
+    if (!existsSync(logFilePath)) {
+        console.error(pc.red('No log file found.'));
+        console.error(pc.dim(`Expected at: ${logFilePath}`));
+        console.error(pc.dim('Start the server with: opentabs dev'));
+        process.exit(1);
+    }
+    const lineCount = options.lines ?? DEFAULT_LINES;
+    const { content, fileSize } = await tailFile(logFilePath, lineCount);
+    if (content)
+        process.stdout.write(content);
+    if (options.follow !== false) {
+        await followFile(logFilePath, fileSize);
+    }
+};
+const registerLogsCommand = (program) => {
+    program
+        .command('logs')
+        .description('Tail the MCP server log output')
+        .option('--lines <n>', `Number of lines to show (default: ${DEFAULT_LINES})`, parseLines)
+        .option('--no-follow', 'Print recent lines and exit (do not follow)')
+        .addHelpText('after', `
+Examples:
+  $ opentabs logs                  # Tail logs (follows new output)
+  $ opentabs logs --lines 100      # Show last 100 lines then follow
+  $ opentabs logs --no-follow      # Show last 50 lines and exit`)
+        .action((options) => handleLogs(options));
+};
+export { registerLogsCommand };
+//# sourceMappingURL=logs.js.map

package/dist/commands/logs.js.map

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

package/dist/commands/plugin.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `opentabs plugin` command — manage plugins (list, add, remove, create).
+ */
+import type { Command } from 'commander';
+export declare const registerPluginCommand: (program: Command) => void;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/commands/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/commands/plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+JzC,eAAO,MAAM,qBAAqB,GAAI,SAAS,OAAO,KAAG,IA6ExD,CAAC"}