maestro-flow 0.1.4 → 0.2.0

package/dist/src/agents/parallel-cli-runner.js

@@ -0,0 +1,277 @@
+// ---------------------------------------------------------------------------
+// Parallel CLI Runner — Async multi-CLI scheduler with semaphore concurrency.
+// Standalone scheduler with SpawnFn injection, decoupled from GraphWalker.
+//
+// Concurrency model (from Bridge's PerSessionWorkerPool):
+// - Tasks with same sessionKey (tool+workDir) run serially
+// - Tasks with different sessionKeys run in parallel
+// - Global maxConcurrency limits total parallel processes
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Tool name -> AgentType mapping (mirrors cli-agent-runner.ts)
+// ---------------------------------------------------------------------------
+const TOOL_TO_AGENT_TYPE = {
+    gemini: 'gemini',
+    qwen: 'qwen',
+    codex: 'codex',
+    claude: 'claude-code',
+    opencode: 'opencode',
+};
+const TOOL_TO_TERMINAL_CMD = {
+    gemini: 'gemini',
+    qwen: 'qwen',
+    codex: 'codex',
+    claude: 'claude',
+    opencode: 'opencode',
+};
+// ---------------------------------------------------------------------------
+// Semaphore — simple counter-based concurrency limiter
+// ---------------------------------------------------------------------------
+class Semaphore {
+    max;
+    current = 0;
+    waiters = [];
+    constructor(max) {
+        this.max = max;
+    }
+    async acquire() {
+        if (this.current < this.max) {
+            this.current++;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.waiters.push(() => {
+                this.current++;
+                resolve();
+            });
+        });
+    }
+    release() {
+        this.current--;
+        const next = this.waiters.shift();
+        if (next)
+            next();
+    }
+}
+// ---------------------------------------------------------------------------
+// Default per-task timeout (10 min ceiling)
+// ---------------------------------------------------------------------------
+const DEFAULT_TASK_TIMEOUT_MS = 10 * 60 * 1000;
+// ---------------------------------------------------------------------------
+// ParallelCliRunner
+// ---------------------------------------------------------------------------
+export class ParallelCliRunner {
+    spawn;
+    terminalBackend;
+    constructor(spawn, terminalBackend) {
+        this.spawn = spawn;
+        this.terminalBackend = terminalBackend;
+    }
+    /**
+     * Execute tasks in parallel with session-key grouping and join strategy.
+     *
+     * Tasks sharing the same sessionKey (defaults to tool+workDir) execute
+     * serially within their group. Different groups run in parallel, limited
+     * by maxConcurrency.
+     */
+    async runAll(tasks, options) {
+        const { maxConcurrency = 4, joinStrategy, signal: globalSignal, } = options;
+        if (tasks.length === 0) {
+            return { results: [], success: true };
+        }
+        // Group by session key
+        const groups = this.groupBySession(tasks);
+        const semaphore = new Semaphore(maxConcurrency);
+        const results = [];
+        // For 'any' strategy, wrap global signal so we can abort remaining
+        // groups once the first group completes.
+        const effectiveAbort = joinStrategy === 'any'
+            ? new AbortController()
+            : undefined;
+        if (effectiveAbort && globalSignal) {
+            globalSignal.addEventListener('abort', () => effectiveAbort.abort(), { once: true });
+        }
+        const effectiveSignal = effectiveAbort?.signal ?? globalSignal;
+        // Create per-group serial chains, run groups in parallel
+        const groupPromises = [...groups.values()].map((queue) => this.runSessionGroup(queue, semaphore, results, effectiveSignal));
+        if (joinStrategy === 'any') {
+            // First group to finish triggers abort of the rest
+            await Promise.race(groupPromises);
+            effectiveAbort.abort();
+            await Promise.allSettled(groupPromises);
+        }
+        else {
+            // 'all' and 'majority' both wait for all groups to settle
+            await Promise.allSettled(groupPromises);
+        }
+        const success = this.evaluateJoin(results, tasks.length, joinStrategy);
+        return { results, success };
+    }
+    // -------------------------------------------------------------------------
+    // Session grouping
+    // -------------------------------------------------------------------------
+    groupBySession(tasks) {
+        const groups = new Map();
+        for (const task of tasks) {
+            const key = task.sessionKey ?? `${task.tool}:${task.workDir}`;
+            if (!groups.has(key))
+                groups.set(key, []);
+            groups.get(key).push(task);
+        }
+        return groups;
+    }
+    // -------------------------------------------------------------------------
+    // Serial execution within a session group
+    // -------------------------------------------------------------------------
+    async runSessionGroup(queue, semaphore, results, signal) {
+        for (const task of queue) {
+            if (signal?.aborted)
+                break;
+            await semaphore.acquire();
+            if (signal?.aborted) {
+                semaphore.release();
+                break;
+            }
+            try {
+                const result = await this.executeTask(task, signal);
+                results.push(result);
+            }
+            finally {
+                semaphore.release();
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Single task execution — routes to SpawnFn or TerminalAdapter
+    // -------------------------------------------------------------------------
+    async executeTask(task, globalSignal) {
+        if (task.backend === 'terminal' && this.terminalBackend) {
+            return this.executeViaTerminal(task, globalSignal);
+        }
+        return this.executeViaSpawn(task, globalSignal);
+    }
+    // -------------------------------------------------------------------------
+    // Execution via SpawnFn (direct adapter — default)
+    // -------------------------------------------------------------------------
+    async executeViaSpawn(task, globalSignal) {
+        const startTime = Date.now();
+        const agentType = TOOL_TO_AGENT_TYPE[task.tool];
+        if (!agentType) {
+            return {
+                id: task.id,
+                success: false,
+                output: `Unknown tool: ${task.tool}`,
+                execId: '',
+                durationMs: Date.now() - startTime,
+            };
+        }
+        // Per-task abort: merges global signal + timeout ceiling
+        const taskAbort = new AbortController();
+        const timeout = setTimeout(() => taskAbort.abort(), DEFAULT_TASK_TIMEOUT_MS);
+        const onGlobalAbort = () => taskAbort.abort();
+        globalSignal?.addEventListener('abort', onGlobalAbort, { once: true });
+        try {
+            const result = await this.spawn({
+                type: agentType,
+                prompt: task.prompt,
+                workDir: task.workDir,
+                approvalMode: task.mode === 'write' ? 'auto' : 'suggest',
+                signal: taskAbort.signal,
+            });
+            return {
+                id: task.id,
+                success: result.success,
+                output: result.output,
+                execId: result.execId,
+                durationMs: result.durationMs,
+            };
+        }
+        catch (err) {
+            return {
+                id: task.id,
+                success: false,
+                output: err instanceof Error ? err.message : String(err),
+                execId: '',
+                durationMs: Date.now() - startTime,
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+            globalSignal?.removeEventListener('abort', onGlobalAbort);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Execution via TerminalAdapter (tmux/wezterm pane)
+    // -------------------------------------------------------------------------
+    async executeViaTerminal(task, globalSignal) {
+        const startTime = Date.now();
+        const agentType = TOOL_TO_AGENT_TYPE[task.tool];
+        if (!agentType) {
+            return {
+                id: task.id, success: false,
+                output: `Unknown tool: ${task.tool}`, execId: '', durationMs: 0,
+            };
+        }
+        const { TerminalAdapter } = await import('./terminal-adapter.js');
+        const cmd = TOOL_TO_TERMINAL_CMD[task.tool] ?? task.tool;
+        const adapter = new TerminalAdapter(this.terminalBackend, cmd);
+        // Cast needed: graph-types AgentType includes 'claude', terminal-adapter's is narrower
+        const proc = await adapter.spawn({
+            type: agentType,
+            prompt: task.prompt,
+            workDir: task.workDir,
+            approvalMode: task.mode === 'write' ? 'auto' : 'suggest',
+        });
+        return new Promise((resolve) => {
+            let output = '';
+            let settled = false;
+            const settle = (success) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timeout);
+                globalSignal?.removeEventListener('abort', onAbort);
+                unsub();
+                resolve({
+                    id: task.id, success, output,
+                    execId: proc.id, durationMs: Date.now() - startTime,
+                });
+            };
+            const timeout = setTimeout(() => {
+                adapter.stop(proc.id);
+                settle(false);
+            }, DEFAULT_TASK_TIMEOUT_MS);
+            const onAbort = () => {
+                adapter.stop(proc.id);
+                settle(false);
+            };
+            globalSignal?.addEventListener('abort', onAbort, { once: true });
+            const unsub = adapter.onEntry(proc.id, (entry) => {
+                if (entry.type === 'assistant_message') {
+                    output += entry.content;
+                }
+                if (entry.type === 'status_change') {
+                    if (entry.status === 'stopped')
+                        settle(true);
+                    else if (entry.status === 'error')
+                        settle(false);
+                }
+            });
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Join strategy evaluation
+    // -------------------------------------------------------------------------
+    evaluateJoin(results, totalTasks, strategy) {
+        const successCount = results.filter((r) => r.success).length;
+        switch (strategy) {
+            case 'all':
+                return successCount === totalTasks;
+            case 'any':
+                return successCount >= 1;
+            case 'majority':
+                return successCount > totalTasks / 2;
+        }
+    }
+}
+//# sourceMappingURL=parallel-cli-runner.js.map

package/dist/src/agents/parallel-cli-runner.js.map

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

package/dist/src/agents/terminal-adapter.d.ts

@@ -0,0 +1,94 @@
+import type { TerminalBackend } from './terminal-backend.js';
+type AgentType = 'claude-code' | 'codex' | 'gemini' | 'qwen' | 'opencode';
+type AgentProcessStatus = 'spawning' | 'running' | 'paused' | 'stopping' | 'stopped' | 'error';
+interface AgentConfig {
+    type: AgentType;
+    prompt: string;
+    workDir: string;
+    env?: Record<string, string>;
+    model?: string;
+    approvalMode?: 'suggest' | 'auto';
+}
+interface AgentProcess {
+    id: string;
+    type: AgentType;
+    status: AgentProcessStatus;
+    config: AgentConfig;
+    startedAt: string;
+    pid?: number;
+}
+interface NormalizedEntryBase {
+    id: string;
+    processId: string;
+    timestamp: string;
+}
+type NormalizedEntry = (NormalizedEntryBase & {
+    type: 'user_message';
+    content: string;
+}) | (NormalizedEntryBase & {
+    type: 'assistant_message';
+    content: string;
+    partial: boolean;
+}) | (NormalizedEntryBase & {
+    type: 'thinking';
+    content: string;
+}) | (NormalizedEntryBase & {
+    type: 'tool_use';
+    name: string;
+    input: Record<string, unknown>;
+    status: string;
+    result?: string;
+}) | (NormalizedEntryBase & {
+    type: 'file_change';
+    path: string;
+    action: string;
+    diff?: string;
+}) | (NormalizedEntryBase & {
+    type: 'command_exec';
+    command: string;
+    exitCode?: number;
+    output?: string;
+}) | (NormalizedEntryBase & {
+    type: 'approval_request';
+    toolName: string;
+    toolInput: Record<string, unknown>;
+    requestId: string;
+}) | (NormalizedEntryBase & {
+    type: 'approval_response';
+    requestId: string;
+    allowed: boolean;
+}) | (NormalizedEntryBase & {
+    type: 'error';
+    message: string;
+    code?: string;
+}) | (NormalizedEntryBase & {
+    type: 'status_change';
+    status: AgentProcessStatus;
+    reason?: string;
+}) | (NormalizedEntryBase & {
+    type: 'token_usage';
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+});
+/** Minimal adapter interface matching BaseAgentAdapter's public surface */
+interface AdapterLike {
+    spawn(config: AgentConfig): Promise<AgentProcess>;
+    stop(processId: string): Promise<void>;
+    onEntry(processId: string, cb: (entry: NormalizedEntry) => void): () => void;
+}
+export declare class TerminalAdapter implements AdapterLike {
+    private readonly backend;
+    private readonly toolCmd;
+    private readonly panes;
+    private readonly listeners;
+    constructor(backend: TerminalBackend, toolCmd: string);
+    spawn(config: AgentConfig): Promise<AgentProcess>;
+    stop(processId: string): Promise<void>;
+    onEntry(processId: string, cb: (entry: NormalizedEntry) => void): () => void;
+    private pollOutput;
+    private emit;
+}
+export {};
+//# sourceMappingURL=terminal-adapter.d.ts.map

package/dist/src/agents/terminal-adapter.d.ts.map

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

package/dist/src/agents/terminal-adapter.js

@@ -0,0 +1,132 @@
+// ---------------------------------------------------------------------------
+// Terminal Adapter — wraps TerminalBackend into AdapterLike interface
+// with 2s polling output collection and 120s stale timeout.
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const POLL_INTERVAL_MS = 2000;
+const MAX_STALE_CYCLES = 60; // 60 * 2s = 120s stale timeout
+const STARTUP_DELAY_MS = 1000;
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export class TerminalAdapter {
+    backend;
+    toolCmd;
+    panes = new Map();
+    listeners = new Map();
+    constructor(backend, toolCmd) {
+        this.backend = backend;
+        this.toolCmd = toolCmd;
+    }
+    async spawn(config) {
+        const processId = `term-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+        // Create pane with the CLI tool running
+        const paneId = await this.backend.createPane({
+            cwd: config.workDir,
+            cmd: this.toolCmd,
+        });
+        this.panes.set(processId, { paneId, polling: true });
+        // Wait for tool to start, then inject prompt
+        await sleep(STARTUP_DELAY_MS);
+        await this.backend.sendText(paneId, config.prompt);
+        // Start polling for output (fire-and-forget async loop)
+        this.pollOutput(processId, paneId);
+        return {
+            id: processId,
+            type: config.type,
+            status: 'running',
+            config,
+            startedAt: new Date().toISOString(),
+        };
+    }
+    async stop(processId) {
+        const pane = this.panes.get(processId);
+        if (!pane)
+            return;
+        pane.polling = false;
+        await this.backend.killPane(pane.paneId);
+        this.panes.delete(processId);
+        this.emit(processId, {
+            id: `${processId}-stop`,
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'status_change',
+            status: 'stopped',
+            reason: 'manual stop',
+        });
+    }
+    onEntry(processId, cb) {
+        if (!this.listeners.has(processId)) {
+            this.listeners.set(processId, new Set());
+        }
+        this.listeners.get(processId).add(cb);
+        return () => {
+            this.listeners.get(processId)?.delete(cb);
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Polling loop — getText diff every 2s, 120s stale timeout
+    // -------------------------------------------------------------------------
+    async pollOutput(processId, paneId) {
+        let lastContent = '';
+        let staleCount = 0;
+        while (this.panes.get(processId)?.polling) {
+            await sleep(POLL_INTERVAL_MS);
+            // Check if pane is still alive
+            const alive = await this.backend.isAlive(paneId);
+            if (!alive) {
+                this.emit(processId, {
+                    id: `${processId}-done`,
+                    processId,
+                    timestamp: new Date().toISOString(),
+                    type: 'status_change',
+                    status: 'stopped',
+                    reason: 'pane exited',
+                });
+                this.panes.delete(processId);
+                break;
+            }
+            // Capture pane content and diff against previous snapshot
+            const content = await this.backend.getText(paneId, 100);
+            if (content !== lastContent) {
+                const newContent = content.slice(lastContent.length);
+                if (newContent.trim()) {
+                    this.emit(processId, {
+                        id: `${processId}-${Date.now()}`,
+                        processId,
+                        timestamp: new Date().toISOString(),
+                        type: 'assistant_message',
+                        content: newContent,
+                        partial: true,
+                    });
+                }
+                lastContent = content;
+                staleCount = 0;
+            }
+            else {
+                staleCount++;
+                if (staleCount >= MAX_STALE_CYCLES) {
+                    this.emit(processId, {
+                        id: `${processId}-timeout`,
+                        processId,
+                        timestamp: new Date().toISOString(),
+                        type: 'status_change',
+                        status: 'stopped',
+                        reason: 'output stale timeout (120s)',
+                    });
+                    this.panes.delete(processId);
+                    break;
+                }
+            }
+        }
+    }
+    emit(processId, entry) {
+        const cbs = this.listeners.get(processId);
+        if (cbs) {
+            cbs.forEach(cb => cb(entry));
+        }
+    }
+}
+//# sourceMappingURL=terminal-adapter.js.map

package/dist/src/agents/terminal-adapter.js.map

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

package/dist/src/agents/terminal-backend.d.ts

@@ -0,0 +1,53 @@
+import { type ExecFileOptions } from 'node:child_process';
+/** Common child_process options with windowsHide:true for all calls. */
+export declare function subprocessOpts(cwd?: string): ExecFileOptions;
+export interface CreatePaneOptions {
+    cwd: string;
+    cmd?: string;
+    direction?: 'right' | 'bottom';
+    percent?: number;
+    parentPaneId?: string;
+}
+export interface TerminalBackend {
+    readonly type: 'tmux' | 'wezterm';
+    createPane(options: CreatePaneOptions): Promise<string>;
+    sendText(paneId: string, text: string): Promise<void>;
+    isAlive(paneId: string): Promise<boolean>;
+    getText(paneId: string, lines?: number): Promise<string>;
+    killPane(paneId: string): Promise<void>;
+}
+export declare class TmuxBackend implements TerminalBackend {
+    readonly type: "tmux";
+    private enterDelay;
+    constructor(options?: {
+        enterDelayMs?: number;
+    });
+    createPane(options: CreatePaneOptions): Promise<string>;
+    sendText(paneId: string, text: string): Promise<void>;
+    isAlive(paneId: string): Promise<boolean>;
+    getText(paneId: string, lines?: number): Promise<string>;
+    killPane(paneId: string): Promise<void>;
+}
+export declare class WeztermBackend implements TerminalBackend {
+    readonly type: "wezterm";
+    private enterDelay;
+    private weztermBin;
+    constructor(options?: {
+        enterDelayMs?: number;
+        weztermBin?: string;
+    });
+    createPane(options: CreatePaneOptions): Promise<string>;
+    sendText(paneId: string, text: string): Promise<void>;
+    /**
+     * 3-level Enter key fallback:
+     * 1. wezterm cli send-key --key Enter (flag form)
+     * 2. wezterm cli send-key Enter (positional form)
+     * 3. CR byte via send-text --no-paste (final fallback)
+     */
+    private sendEnter;
+    isAlive(paneId: string): Promise<boolean>;
+    getText(paneId: string, lines?: number): Promise<string>;
+    killPane(paneId: string): Promise<void>;
+}
+export declare function detectBackend(): TerminalBackend | null;
+//# sourceMappingURL=terminal-backend.d.ts.map

package/dist/src/agents/terminal-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-backend.d.ts","sourceRoot":"","sources":["../../../src/agents/terminal-backend.ts"],"names":[],"mappings":"AAIA,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAuBpE,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAO5D;AAUD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAMD,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAKzC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmCvD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDrD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWzC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAQpD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO9C;AAMD,qBAAa,cAAe,YAAW,eAAe;IACpD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAQ9D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBvD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B3D;;;;;OAKG;YACW,SAAS;IA2BjB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBzC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IASpD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM9C;AAMD,wBAAgB,aAAa,IAAI,eAAe,GAAG,IAAI,CAQtD"}