@astroanywhere/agent 0.1.0

package/dist/lib/slurm-job-monitor.js

@@ -0,0 +1,212 @@
+/**
+ * Slurm Job Monitor
+ *
+ * Background poller that tracks submitted Slurm batch jobs (sbatch).
+ * Monitors job status via sacct and streams updates through the
+ * existing WebSocket relay protocol.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { open, stat } from 'node:fs/promises';
+import { readFile } from 'node:fs/promises';
+const execFileAsync = promisify(execFile);
+/** SLURM job IDs are numeric (optionally with array syntax like 12345_1). Validates and returns. */
+function sanitizedSlurmJobId(id) {
+    if (!/^\d+(_\d+)?$/.test(id)) {
+        throw new Error(`Invalid SLURM job ID (possible command injection): ${id}`);
+    }
+    return id;
+}
+/** Terminal Slurm states */
+const TERMINAL_STATES = new Set([
+    'COMPLETED', 'FAILED', 'CANCELLED', 'TIMEOUT',
+    'PREEMPTED', 'NODE_FAIL', 'OUT_OF_MEMORY',
+]);
+export class SlurmJobMonitor {
+    jobs = new Map();
+    pollInterval = null;
+    wsClient;
+    pollIntervalMs;
+    constructor(wsClient, pollIntervalMs = 30_000) {
+        this.wsClient = wsClient;
+        this.pollIntervalMs = pollIntervalMs;
+    }
+    /**
+     * Track a submitted Slurm job
+     */
+    trackJob(slurmJobId, executionId, nodeId, outputPath) {
+        console.log(`[slurm-monitor] Tracking job ${slurmJobId} for task ${executionId}`);
+        this.jobs.set(slurmJobId, {
+            slurmJobId,
+            executionId,
+            nodeId,
+            outputPath,
+            lastOutputOffset: 0,
+            stdoutSequence: 0,
+            trackingSince: new Date(),
+        });
+        // Start polling if not already running
+        if (!this.pollInterval) {
+            this.start();
+        }
+    }
+    /**
+     * Stop tracking a job
+     */
+    untrackJob(slurmJobId) {
+        this.jobs.delete(slurmJobId);
+        if (this.jobs.size === 0) {
+            this.stop();
+        }
+    }
+    /**
+     * Check if any jobs are being tracked
+     */
+    hasTrackedJobs() {
+        return this.jobs.size > 0;
+    }
+    /**
+     * Get tracked job IDs for a given execution
+     */
+    getJobsForExecution(executionId) {
+        return Array.from(this.jobs.values())
+            .filter((j) => j.executionId === executionId)
+            .map((j) => j.slurmJobId);
+    }
+    /**
+     * Start the polling loop
+     */
+    start() {
+        if (this.pollInterval)
+            return;
+        console.log(`[slurm-monitor] Starting poll loop (${this.pollIntervalMs}ms)`);
+        // Immediate first poll so we don't wait a full interval before checking
+        this.pollAll().catch((err) => {
+            console.error('[slurm-monitor] Poll error:', err);
+        });
+        this.pollInterval = setInterval(() => {
+            this.pollAll().catch((err) => {
+                console.error('[slurm-monitor] Poll error:', err);
+            });
+        }, this.pollIntervalMs);
+    }
+    /**
+     * Stop the polling loop
+     */
+    stop() {
+        if (this.pollInterval) {
+            clearInterval(this.pollInterval);
+            this.pollInterval = null;
+            console.log('[slurm-monitor] Stopped poll loop');
+        }
+    }
+    /**
+     * Poll all tracked jobs
+     */
+    async pollAll() {
+        for (const [jobId, job] of this.jobs) {
+            try {
+                await this.pollJob(job);
+            }
+            catch (err) {
+                console.error(`[slurm-monitor] Error polling job ${jobId}:`, err);
+            }
+        }
+    }
+    /**
+     * Poll a single job's status via sacct
+     */
+    async pollJob(job) {
+        const { slurmJobId, executionId } = job;
+        let state = 'UNKNOWN';
+        let exitCode;
+        let elapsed;
+        try {
+            const { stdout } = await execFileAsync('sacct', ['-j', sanitizedSlurmJobId(slurmJobId), '--format=State,ExitCode,Elapsed', '-n', '-P'], { timeout: 10_000 });
+            // sacct can return multiple lines (job + job.batch steps)
+            // Take the first line (main job)
+            const firstLine = stdout.trim().split('\n')[0];
+            if (firstLine) {
+                const parts = firstLine.split('|');
+                state = (parts[0] || 'UNKNOWN').replace(/\+$/, ''); // Remove trailing + from CANCELLED+
+                const exitParts = (parts[1] || '').split(':');
+                exitCode = parseInt(exitParts[0]) || undefined;
+                elapsed = parts[2] || undefined;
+            }
+        }
+        catch {
+            // sacct not available or job not yet visible
+            return;
+        }
+        // Report state changes
+        if (state !== job.lastState) {
+            job.lastState = state;
+            if (TERMINAL_STATES.has(state)) {
+                // Job finished — send result
+                const isSuccess = state === 'COMPLETED' && (!exitCode || exitCode === 0);
+                // Try to read final output
+                let output;
+                if (job.outputPath) {
+                    try {
+                        output = await readFile(job.outputPath, 'utf-8');
+                    }
+                    catch {
+                        // Output file not accessible
+                    }
+                }
+                const result = {
+                    taskId: executionId,
+                    status: isSuccess ? 'completed' : 'failed',
+                    exitCode: exitCode ?? (isSuccess ? 0 : 1),
+                    output: output || `Slurm job ${slurmJobId}: ${state}${elapsed ? ` (${elapsed})` : ''}`,
+                    error: isSuccess ? undefined : `Slurm job ${state}`,
+                    completedAt: new Date().toISOString(),
+                };
+                this.wsClient.sendTaskResult(result);
+                console.log(`[slurm-monitor] Job ${slurmJobId} terminal: ${state}`);
+                this.untrackJob(slurmJobId);
+            }
+            else {
+                // Non-terminal state change — send progress
+                const progress = state === 'RUNNING' ? 50 : state === 'PENDING' ? 10 : 25;
+                const message = `Slurm job ${slurmJobId}: ${state}${elapsed ? ` (${elapsed})` : ''}`;
+                this.wsClient.sendTaskStatus(executionId, 'running', progress, message);
+            }
+        }
+        // Stream output file content if running
+        if (state === 'RUNNING' && job.outputPath) {
+            await this.streamOutput(job);
+        }
+    }
+    /**
+     * Stream new output from the job's output file
+     */
+    async streamOutput(job) {
+        if (!job.outputPath)
+            return;
+        try {
+            const fileStat = await stat(job.outputPath);
+            if (fileStat.size <= job.lastOutputOffset)
+                return;
+            // Read only the new bytes to avoid byte/character offset mismatch
+            const bytesToRead = fileStat.size - job.lastOutputOffset;
+            const fd = await open(job.outputPath, 'r');
+            try {
+                const buffer = Buffer.alloc(bytesToRead);
+                await fd.read(buffer, 0, bytesToRead, job.lastOutputOffset);
+                job.lastOutputOffset = fileStat.size;
+                const newContent = buffer.toString('utf-8');
+                if (newContent.length > 0) {
+                    this.wsClient.sendTaskOutput(job.executionId, 'stdout', newContent, job.stdoutSequence++);
+                }
+            }
+            finally {
+                await fd.close();
+            }
+        }
+        catch {
+            // File not yet created or not accessible
+        }
+    }
+}
+//# sourceMappingURL=slurm-job-monitor.js.map

package/dist/lib/slurm-job-monitor.js.map

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

package/dist/lib/ssh-discovery.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SSH config discovery for remote host detection
+ */
+import type { DiscoveredHost } from '../types.js';
+/**
+ * Discover all remote hosts from various sources
+ */
+export declare function discoverRemoteHosts(): Promise<DiscoveredHost[]>;
+/**
+ * Format discovered hosts for display
+ */
+export declare function formatDiscoveredHosts(hosts: DiscoveredHost[]): string;
+/**
+ * Build SSH command for connecting to a host
+ */
+export declare function buildSSHCommand(host: DiscoveredHost, command?: string): string;
+//# sourceMappingURL=ssh-discovery.d.ts.map

package/dist/lib/ssh-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-discovery.d.ts","sourceRoot":"","sources":["../../src/lib/ssh-discovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,aAAa,CAAC;AA2N3D;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAmDrE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAsCrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAuB9E"}

package/dist/lib/ssh-discovery.js

@@ -0,0 +1,287 @@
+/**
+ * SSH config discovery for remote host detection
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * Parse SSH config file and extract host configurations
+ */
+async function parseSSHConfig() {
+    const sshConfigPath = join(homedir(), '.ssh', 'config');
+    console.log(`[ssh-discovery] Parsing SSH config from: ${sshConfigPath}`);
+    try {
+        const content = await readFile(sshConfigPath, 'utf-8');
+        const hosts = [];
+        let currentHost = null;
+        let skippedCount = 0;
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            // Skip comments and empty lines
+            if (!trimmed || trimmed.startsWith('#')) {
+                continue;
+            }
+            // Parse key-value pair
+            const match = trimmed.match(/^(\S+)\s+(.+)$/);
+            if (!match)
+                continue;
+            const [, key, value] = match;
+            const keyLower = key?.toLowerCase();
+            if (keyLower === 'host') {
+                // Save previous host if exists
+                if (currentHost) {
+                    hosts.push(currentHost);
+                    console.log(`[ssh-discovery] ✓ Added host: ${currentHost.name} (${currentHost.hostname})`);
+                }
+                const hostPattern = value?.trim() ?? '';
+                // Skip wildcard patterns and local-only patterns
+                if (hostPattern.includes('*') ||
+                    hostPattern === 'localhost' ||
+                    hostPattern === '127.0.0.1') {
+                    console.log(`[ssh-discovery] ⊗ Skipped pattern/localhost: ${hostPattern}`);
+                    skippedCount++;
+                    currentHost = null;
+                    continue;
+                }
+                currentHost = {
+                    name: hostPattern,
+                    hostname: hostPattern, // Default to the host alias
+                };
+            }
+            else if (currentHost && value) {
+                switch (keyLower) {
+                    case 'hostname':
+                        currentHost.hostname = value.trim();
+                        break;
+                    case 'user':
+                        currentHost.user = value.trim();
+                        break;
+                    case 'port':
+                        currentHost.port = parseInt(value.trim(), 10);
+                        break;
+                    case 'identityfile':
+                        currentHost.identityFile = value.trim().replace('~', homedir());
+                        break;
+                    case 'proxyjump':
+                        currentHost.proxyJump = value.trim();
+                        break;
+                }
+            }
+        }
+        // Don't forget the last host
+        if (currentHost) {
+            hosts.push(currentHost);
+            console.log(`[ssh-discovery] ✓ Added host: ${currentHost.name} (${currentHost.hostname})`);
+        }
+        console.log(`[ssh-discovery] Parsed ${hosts.length} valid hosts (skipped ${skippedCount} wildcards/localhost)`);
+        return hosts;
+    }
+    catch (error) {
+        // SSH config doesn't exist or can't be read
+        if (error.code === 'ENOENT') {
+            console.log(`[ssh-discovery] No SSH config file found at ${sshConfigPath}`);
+            return [];
+        }
+        console.error(`[ssh-discovery] Error reading SSH config:`, error);
+        throw error;
+    }
+}
+/**
+ * Discover VS Code Remote SSH tunnel configurations
+ */
+async function discoverVSCodeTunnels() {
+    const hosts = [];
+    // VS Code stores remote configurations in different locations based on platform
+    const vscodeConfigPaths = [
+        join(homedir(), '.vscode-server', 'data', 'Machine', 'settings.json'),
+        join(homedir(), '.vscode', 'globalStorage', 'ms-vscode-remote.remote-ssh', 'hosts.json'),
+        join(homedir(), 'Library', 'Application Support', 'Code', 'User', 'globalStorage', 'ms-vscode-remote.remote-ssh', 'hosts.json'),
+        join(homedir(), '.config', 'Code', 'User', 'globalStorage', 'ms-vscode-remote.remote-ssh', 'hosts.json'),
+    ];
+    for (const configPath of vscodeConfigPaths) {
+        try {
+            const content = await readFile(configPath, 'utf-8');
+            const config = JSON.parse(content);
+            // Handle different VS Code config formats
+            if (Array.isArray(config)) {
+                for (const entry of config) {
+                    if (entry.host && entry.hostName) {
+                        hosts.push({
+                            name: entry.host,
+                            hostname: entry.hostName,
+                            user: entry.user,
+                            port: entry.port,
+                            identityFile: entry.identityFile,
+                        });
+                    }
+                }
+            }
+            else if (config.remote?.SSH?.remotePlatform) {
+                // Newer VS Code format
+                for (const hostName of Object.keys(config.remote.SSH.remotePlatform)) {
+                    if (!hosts.some((h) => h.name === hostName)) {
+                        hosts.push({
+                            name: hostName,
+                            hostname: hostName,
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Config doesn't exist or is invalid, continue to next path
+            continue;
+        }
+    }
+    return hosts;
+}
+/**
+ * Parse known_hosts file to find additional hosts
+ */
+async function parseKnownHosts() {
+    const knownHostsPath = join(homedir(), '.ssh', 'known_hosts');
+    try {
+        const content = await readFile(knownHostsPath, 'utf-8');
+        const hostnames = new Set();
+        for (const line of content.split('\n')) {
+            if (!line.trim() || line.startsWith('#')) {
+                continue;
+            }
+            // Known hosts format: hostname[,hostname,...] keytype key [comment]
+            const hostPart = line.split(' ')[0];
+            if (!hostPart) {
+                continue;
+            }
+            // Split by comma for multiple hostnames on same line
+            for (let hostname of hostPart.split(',')) {
+                // Remove port if present (e.g., [hostname]:port)
+                hostname = hostname.replace(/^\[(.+)\]:\d+$/, '$1');
+                // Skip IP addresses and localhost
+                if (hostname.match(/^\d+\.\d+\.\d+\.\d+$/) ||
+                    hostname === 'localhost' ||
+                    hostname === '127.0.0.1') {
+                    continue;
+                }
+                // Skip hashed hostnames (start with |)
+                if (hostname.startsWith('|')) {
+                    continue;
+                }
+                hostnames.add(hostname);
+            }
+        }
+        return Array.from(hostnames);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Discover all remote hosts from various sources
+ */
+export async function discoverRemoteHosts() {
+    console.log('[ssh-discovery] Starting remote host discovery...');
+    const discovered = [];
+    const seenHosts = new Set();
+    // Parse SSH config (highest priority)
+    console.log('[ssh-discovery] 1/3 Checking SSH config (~/.ssh/config)...');
+    const sshHosts = await parseSSHConfig();
+    for (const host of sshHosts) {
+        seenHosts.add(host.name);
+        discovered.push({
+            ...host,
+            source: 'ssh-config',
+        });
+    }
+    console.log(`[ssh-discovery] Found ${sshHosts.length} hosts from SSH config`);
+    // Discover VS Code tunnels
+    console.log('[ssh-discovery] 2/3 Checking VS Code Remote SSH...');
+    const vscodeTunnels = await discoverVSCodeTunnels();
+    for (const host of vscodeTunnels) {
+        if (!seenHosts.has(host.name)) {
+            seenHosts.add(host.name);
+            discovered.push({
+                ...host,
+                source: 'vscode-tunnel',
+            });
+        }
+    }
+    console.log(`[ssh-discovery] Found ${vscodeTunnels.length} unique VS Code hosts`);
+    // Parse known_hosts (lowest priority - just suggests hostnames)
+    console.log('[ssh-discovery] 3/3 Checking known_hosts...');
+    const knownHostnames = await parseKnownHosts();
+    let knownHostsAdded = 0;
+    for (const hostname of knownHostnames) {
+        if (!seenHosts.has(hostname)) {
+            seenHosts.add(hostname);
+            discovered.push({
+                name: hostname,
+                hostname,
+                source: 'known-hosts',
+            });
+            knownHostsAdded++;
+        }
+    }
+    console.log(`[ssh-discovery] Found ${knownHostsAdded} unique hosts from known_hosts`);
+    console.log(`[ssh-discovery] Discovery complete: ${discovered.length} total unique hosts`);
+    return discovered;
+}
+/**
+ * Format discovered hosts for display
+ */
+export function formatDiscoveredHosts(hosts) {
+    if (hosts.length === 0) {
+        return 'No remote hosts discovered.';
+    }
+    const lines = ['Discovered Remote Hosts:', ''];
+    // Group by source
+    const bySource = new Map();
+    for (const host of hosts) {
+        const existing = bySource.get(host.source) ?? [];
+        existing.push(host);
+        bySource.set(host.source, existing);
+    }
+    const sourceLabels = {
+        'ssh-config': 'From SSH config (~/.ssh/config):',
+        'vscode-tunnel': 'From VS Code Remote SSH:',
+        'known-hosts': 'From known hosts:',
+    };
+    for (const [source, sourceHosts] of bySource) {
+        lines.push(`  ${sourceLabels[source] ?? source}`);
+        for (const host of sourceHosts) {
+            const details = [];
+            if (host.user)
+                details.push(`user: ${host.user}`);
+            if (host.port && host.port !== 22)
+                details.push(`port: ${host.port}`);
+            if (host.proxyJump)
+                details.push(`via: ${host.proxyJump}`);
+            const detailStr = details.length > 0 ? ` (${details.join(', ')})` : '';
+            const targetStr = host.hostname !== host.name ? ` → ${host.hostname}` : '';
+            lines.push(`    • ${host.name}${targetStr}${detailStr}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Build SSH command for connecting to a host
+ */
+export function buildSSHCommand(host, command) {
+    const parts = ['ssh'];
+    if (host.port && host.port !== 22) {
+        parts.push('-p', String(host.port));
+    }
+    if (host.identityFile) {
+        parts.push('-i', host.identityFile);
+    }
+    if (host.proxyJump) {
+        parts.push('-J', host.proxyJump);
+    }
+    const target = host.user ? `${host.user}@${host.hostname}` : host.hostname;
+    parts.push(target);
+    if (command) {
+        parts.push(command);
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=ssh-discovery.js.map

package/dist/lib/ssh-discovery.js.map

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

package/dist/lib/ssh-installer.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Remote SSH installation utilities for local dev.
+ *
+ * Packs the agent-runner locally, SCPs it to the target host,
+ * installs via npm, and pushes pre-provisioned tokens so the
+ * remote host skips its own device auth entirely.
+ */
+import type { DiscoveredHost } from '../types.js';
+/**
+ * Detect the LAN IP of this machine so remote hosts can reach the dev server.
+ * Returns the first non-internal IPv4 address found.
+ */
+export declare function detectLocalIP(): string;
+/**
+ * SSH to a host and check whether Node.js ≥ 18 is available.
+ * Returns { available, version } or throws on SSH failure.
+ */
+export declare function checkRemoteNode(host: DiscoveredHost): Promise<{
+    available: boolean;
+    version: string | null;
+}>;
+export interface InstallOptions {
+    host: DiscoveredHost;
+    apiUrl: string;
+    relayUrl: string;
+    accessToken: string;
+    refreshToken: string;
+    wsToken: string;
+    machineId: string;
+}
+/**
+ * Pack the local agent-runner, SCP it to the remote host, install, and configure.
+ *
+ * Steps:
+ *   1. `npm pack` in the agent-runner directory → tarball
+ *   2. `scp` tarball to remote ~/
+ *   3. `ssh npm install -g <tarball>` on remote
+ *   4. `ssh astro-agent setup --non-interactive --skip-auth` on remote
+ *   5. Push tokens via `ssh astro-agent config --set` commands
+ */
+export declare function packAndInstall(opts: InstallOptions, onProgress?: (msg: string) => void): Promise<void>;
+export declare function buildSshArgs(host: DiscoveredHost, command: string): string[];
+export declare function sshExec(host: DiscoveredHost, command: string): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export interface StartRemoteOptions {
+    maxTasks?: number;
+    logLevel?: string;
+    preserveWorktrees?: boolean;
+}
+export interface RemoteStartResult {
+    host: DiscoveredHost;
+    success: boolean;
+    message: string;
+    alreadyRunning?: boolean;
+}
+/**
+ * Start agent runners on remote hosts.
+ *
+ * For each host:
+ *   1. Check if an agent is already running (pgrep)
+ *   2. Start via nohup + disown
+ *   3. Verify after 2s with pgrep
+ *
+ * One failure does not block others.
+ */
+export declare function startRemoteAgents(hosts: DiscoveredHost[], options?: StartRemoteOptions, onProgress?: (host: string, msg: string) => void): Promise<RemoteStartResult[]>;
+//# sourceMappingURL=ssh-installer.d.ts.map

package/dist/lib/ssh-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-installer.d.ts","sourceRoot":"","sources":["../../src/lib/ssh-installer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAatC;AAMD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CASzD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,cAAc,EACpB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,IAAI,CAAC,CAkEf;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAoB5E;AAuBD,wBAAsB,OAAO,CAC3B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAG7C;AAMD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE,kBAAuB,EAChC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,GAC/C,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA8D9B"}