@electric-agent/studio 1.1.0 → 1.3.0

package/dist/bridge/codex-docker.js

@@ -0,0 +1,242 @@
+/**
+ * SessionBridge implementation that runs Codex CLI inside a Docker
+ * container via `docker exec -i`, communicating via exec --json NDJSON.
+ *
+ * The bridge translates Codex's exec --json output into EngineEvents
+ * and writes them to the Durable Stream for the UI.
+ *
+ * Codex runs in one-shot mode (`codex exec --json`) and exits after completing.
+ * On iterate (follow-up message), the bridge respawns Codex with the new prompt.
+ */
+import { spawn } from "node:child_process";
+import * as readline from "node:readline";
+import { DurableStream } from "@durable-streams/client";
+import { ts } from "@electric-agent/protocol";
+import { createCodexJsonParser } from "./codex-json-parser.js";
+export class CodexDockerBridge {
+    sessionId;
+    streamUrl;
+    streamHeaders;
+    containerId;
+    config;
+    writer;
+    parser = createCodexJsonParser();
+    agentEventCallbacks = [];
+    completeCallbacks = [];
+    closed = false;
+    proc = null;
+    /** Codex thread ID captured from thread.started — used for resume */
+    codexThreadId = null;
+    /** Whether a Codex process is currently running */
+    running = false;
+    /** Whether the parser already emitted a session_end */
+    resultReceived = false;
+    constructor(sessionId, connection, containerId, config) {
+        this.sessionId = sessionId;
+        this.streamUrl = connection.url;
+        this.streamHeaders = connection.headers;
+        this.containerId = containerId;
+        this.config = config;
+        this.writer = new DurableStream({
+            url: connection.url,
+            headers: connection.headers,
+            contentType: "application/json",
+        });
+    }
+    async emit(event) {
+        if (this.closed)
+            return;
+        const msg = { source: "server", ...event };
+        await this.writer.append(JSON.stringify(msg));
+    }
+    /**
+     * Send a follow-up user message to Codex by respawning with a new prompt.
+     */
+    async sendCommand(cmd) {
+        if (this.closed)
+            return;
+        if (cmd.command === "iterate" && typeof cmd.request === "string") {
+            this.spawnCodex(cmd.request);
+            return;
+        }
+        console.log(`[codex-docker] Ignoring unsupported command: ${cmd.command}`);
+    }
+    /**
+     * Send a gate response. Codex exec mode doesn't support stdin interaction,
+     * so gate responses are limited.
+     */
+    async sendGateResponse(_gate, _value) {
+        // Codex exec --json doesn't support stdin user messages mid-run
+    }
+    onAgentEvent(cb) {
+        this.agentEventCallbacks.push(cb);
+    }
+    onComplete(cb) {
+        this.completeCallbacks.push(cb);
+    }
+    async start() {
+        if (this.closed)
+            return;
+        this.spawnCodex(this.config.prompt);
+    }
+    close() {
+        this.closed = true;
+        if (this.proc) {
+            try {
+                this.proc.stdin?.end();
+                this.proc.kill("SIGTERM");
+            }
+            catch {
+                // Process may already be dead
+            }
+            this.proc = null;
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Spawn a new Codex process. Called for both the initial prompt
+     * and follow-up iterate messages.
+     */
+    spawnCodex(prompt) {
+        // Kill any existing process
+        if (this.proc) {
+            try {
+                this.proc.stdin?.end();
+                this.proc.kill("SIGTERM");
+            }
+            catch {
+                // Already dead
+            }
+            this.proc = null;
+        }
+        // Reset parser state for the new process
+        this.parser = createCodexJsonParser();
+        this.resultReceived = false;
+        this.running = true;
+        const model = this.config.model ?? "o4-mini";
+        // Build the codex CLI command
+        const codexArgs = [
+            "exec",
+            "--json",
+            "--full-auto",
+            "--model",
+            model,
+            ...(this.config.extraFlags ?? []),
+            "-q",
+            prompt,
+        ];
+        // Escape for bash
+        const escapedArgs = codexArgs.map((a) => `'${a.replace(/'/g, "'\\''")}'`).join(" ");
+        const cmd = `cd '${this.config.cwd}' && codex ${escapedArgs}`;
+        this.proc = spawn("docker", ["exec", this.containerId, "bash", "-c", cmd], {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        console.log(`[codex-docker] Started: session=${this.sessionId} container=${this.containerId} pid=${this.proc.pid}`);
+        console.log(`[codex-docker] cmd: ${cmd}`);
+        const currentProc = this.proc;
+        // Read stdout line by line (exec --json NDJSON)
+        if (currentProc.stdout) {
+            const rl = readline.createInterface({
+                input: currentProc.stdout,
+                terminal: false,
+            });
+            rl.on("line", (line) => {
+                if (this.closed)
+                    return;
+                console.log(`[codex-docker:stdout] ${line.slice(0, 120)}...`);
+                this.handleLine(line);
+            });
+        }
+        // Log stderr
+        if (currentProc.stderr) {
+            const stderrRl = readline.createInterface({
+                input: currentProc.stderr,
+                terminal: false,
+            });
+            stderrRl.on("line", (line) => {
+                if (!this.closed) {
+                    console.error(`[codex-docker:stderr] ${line}`);
+                }
+            });
+        }
+        // Handle process exit — defer to let pending readline events flush first
+        currentProc.on("exit", (code) => {
+            console.log(`[codex-docker] Process exited: code=${code} session=${this.sessionId}`);
+            setTimeout(() => {
+                // Capture thread ID from parser state before marking not running
+                if (this.parser.state.threadId) {
+                    this.codexThreadId = this.parser.state.threadId;
+                }
+                this.running = false;
+                // Emit session_end if the parser didn't already
+                if (!this.closed && !this.resultReceived) {
+                    const endEvent = {
+                        type: "session_end",
+                        success: code === 0,
+                        ts: ts(),
+                    };
+                    this.dispatchEvent(endEvent);
+                }
+            }, 100);
+        });
+    }
+    handleLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        const events = this.parser.parse(trimmed);
+        for (const event of events) {
+            this.dispatchEvent(event);
+        }
+    }
+    dispatchEvent(event) {
+        // Write to Durable Stream for UI
+        const msg = { source: "agent", ...event };
+        this.writer.append(JSON.stringify(msg)).catch(() => { });
+        // Track session_end to prevent duplicates
+        if (event.type === "session_end") {
+            this.resultReceived = true;
+        }
+        // Detect dev:start in Bash tool_use → emit app_ready for the UI preview
+        if (event.type === "pre_tool_use" && event.tool_name === "Bash") {
+            const cmd = event.tool_input?.command;
+            if (typeof cmd === "string" && /\bdev:start\b/.test(cmd)) {
+                const appReady = { type: "app_ready", ts: ts() };
+                const appReadyMsg = { source: "agent", ...appReady };
+                this.writer.append(JSON.stringify(appReadyMsg)).catch(() => { });
+                for (const cb of this.agentEventCallbacks) {
+                    try {
+                        cb(appReady);
+                    }
+                    catch {
+                        // Swallow
+                    }
+                }
+            }
+        }
+        // Dispatch to callbacks
+        for (const cb of this.agentEventCallbacks) {
+            try {
+                cb(event);
+            }
+            catch {
+                // Swallow callback errors
+            }
+        }
+        // Detect session_end
+        if (event.type === "session_end" && "success" in event) {
+            const success = event.success;
+            for (const cb of this.completeCallbacks) {
+                try {
+                    cb(success);
+                }
+                catch {
+                    // Swallow callback errors
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=codex-docker.js.map

package/dist/bridge/codex-docker.js.map

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

package/dist/bridge/codex-json-parser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Translates Codex CLI `codex exec --json` NDJSON messages
+ * into EngineEvent arrays compatible with the existing bridge/UI pipeline.
+ *
+ * Codex exec --json emits lines like:
+ *   {"type":"thread.started","thread_id":"..."}
+ *   {"type":"item.started","item":{"type":"command_execution","id":"...","command":"..."}}
+ *   {"type":"item.completed","item":{"type":"agent_message","id":"...","content":"..."}}
+ *   {"type":"turn.completed","usage":{"input_tokens":100,"output_tokens":50}}
+ *   {"type":"turn.failed","error":"..."}
+ *
+ * This parser converts each line into zero or more EngineEvent objects.
+ */
+import type { EngineEvent } from "@electric-agent/protocol";
+export interface CodexJsonParserState {
+    /** Map item ID → tool name for correlating started/completed events */
+    toolNames: Map<string, string>;
+    /** Accumulated cost from turn.completed messages */
+    totalCost: number;
+    /** Codex thread ID from thread.started */
+    threadId: string | null;
+}
+/**
+ * Create a new stateful parser. The returned `parse` function converts
+ * a single raw JSON line from Codex into zero or more EngineEvents.
+ */
+export declare function createCodexJsonParser(): {
+    state: CodexJsonParserState;
+    parse(line: string): EngineEvent[];
+};
+//# sourceMappingURL=codex-json-parser.d.ts.map

package/dist/bridge/codex-json-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-json-parser.d.ts","sourceRoot":"","sources":["../../src/bridge/codex-json-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AA+F3D,MAAM,WAAW,oBAAoB;IACpC,uEAAuE;IACvE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB;;gBASvB,MAAM,GAAG,WAAW,EAAE;EAInC"}

package/dist/bridge/codex-json-parser.js

@@ -0,0 +1,274 @@
+/**
+ * Translates Codex CLI `codex exec --json` NDJSON messages
+ * into EngineEvent arrays compatible with the existing bridge/UI pipeline.
+ *
+ * Codex exec --json emits lines like:
+ *   {"type":"thread.started","thread_id":"..."}
+ *   {"type":"item.started","item":{"type":"command_execution","id":"...","command":"..."}}
+ *   {"type":"item.completed","item":{"type":"agent_message","id":"...","content":"..."}}
+ *   {"type":"turn.completed","usage":{"input_tokens":100,"output_tokens":50}}
+ *   {"type":"turn.failed","error":"..."}
+ *
+ * This parser converts each line into zero or more EngineEvent objects.
+ */
+import { ts } from "@electric-agent/protocol";
+/**
+ * Create a new stateful parser. The returned `parse` function converts
+ * a single raw JSON line from Codex into zero or more EngineEvents.
+ */
+export function createCodexJsonParser() {
+    const state = {
+        toolNames: new Map(),
+        totalCost: 0,
+        threadId: null,
+    };
+    return {
+        state,
+        parse(line) {
+            return parseLine(line, state);
+        },
+    };
+}
+function parseLine(line, state) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return [];
+    let msg;
+    try {
+        msg = JSON.parse(trimmed);
+    }
+    catch {
+        return [];
+    }
+    if (!msg.type)
+        return [];
+    switch (msg.type) {
+        case "thread.started":
+            return handleThreadStarted(msg, state);
+        case "item.started":
+            return handleItemStarted(msg, state);
+        case "item.completed":
+            return handleItemCompleted(msg, state);
+        case "turn.completed":
+            return handleTurnCompleted(msg, state);
+        case "turn.failed":
+            return handleTurnFailed(msg);
+        default:
+            return [];
+    }
+}
+function handleThreadStarted(msg, state) {
+    state.threadId = msg.thread_id ?? null;
+    return [
+        {
+            type: "session_start",
+            session_id: msg.thread_id ?? "",
+            ts: ts(),
+        },
+    ];
+}
+function handleItemStarted(msg, state) {
+    const item = msg.item;
+    if (!item?.type)
+        return [];
+    switch (item.type) {
+        case "command_execution": {
+            const ce = item;
+            const toolUseId = ce.id ?? `codex_${Date.now()}`;
+            state.toolNames.set(toolUseId, "Bash");
+            return [
+                {
+                    type: "pre_tool_use",
+                    tool_name: "Bash",
+                    tool_use_id: toolUseId,
+                    tool_input: { command: ce.command ?? "" },
+                    ts: ts(),
+                },
+            ];
+        }
+        case "file_change": {
+            const fc = item;
+            const toolUseId = fc.id ?? `codex_${Date.now()}`;
+            const toolName = fc.action === "delete" ? "Delete" : "Write";
+            state.toolNames.set(toolUseId, toolName);
+            return [
+                {
+                    type: "pre_tool_use",
+                    tool_name: toolName,
+                    tool_use_id: toolUseId,
+                    tool_input: { file_path: fc.file_path ?? "", action: fc.action ?? "write" },
+                    ts: ts(),
+                },
+            ];
+        }
+        case "mcp_tool_call": {
+            const mc = item;
+            const toolUseId = mc.id ?? `codex_${Date.now()}`;
+            const toolName = mc.tool_name
+                ? mc.server_name
+                    ? `mcp__${mc.server_name}__${mc.tool_name}`
+                    : mc.tool_name
+                : "mcp_tool";
+            state.toolNames.set(toolUseId, toolName);
+            return [
+                {
+                    type: "pre_tool_use",
+                    tool_name: toolName,
+                    tool_use_id: toolUseId,
+                    tool_input: mc.arguments ?? {},
+                    ts: ts(),
+                },
+            ];
+        }
+        case "reasoning": {
+            const r = item;
+            if (r.content) {
+                return [
+                    {
+                        type: "assistant_thinking",
+                        text: r.content,
+                        ts: ts(),
+                    },
+                ];
+            }
+            return [];
+        }
+        default:
+            return [];
+    }
+}
+function handleItemCompleted(msg, state) {
+    const item = msg.item;
+    if (!item?.type)
+        return [];
+    switch (item.type) {
+        case "agent_message": {
+            const am = item;
+            const text = extractMessageText(am.content);
+            if (text) {
+                return [
+                    {
+                        type: "assistant_message",
+                        text,
+                        ts: ts(),
+                    },
+                ];
+            }
+            return [];
+        }
+        case "command_execution": {
+            const ce = item;
+            const toolUseId = ce.id ?? "";
+            const toolName = state.toolNames.get(toolUseId) ?? "Bash";
+            const isError = ce.exit_code != null && ce.exit_code !== 0;
+            const response = ce.output ?? "";
+            if (isError) {
+                return [
+                    {
+                        type: "post_tool_use",
+                        tool_use_id: toolUseId,
+                        tool_name: toolName,
+                        tool_response: response,
+                        error: response || `Exit code: ${ce.exit_code}`,
+                        ts: ts(),
+                    },
+                ];
+            }
+            return [
+                {
+                    type: "post_tool_use",
+                    tool_use_id: toolUseId,
+                    tool_name: toolName,
+                    tool_response: response,
+                    ts: ts(),
+                },
+            ];
+        }
+        case "file_change": {
+            const fc = item;
+            const toolUseId = fc.id ?? "";
+            const toolName = state.toolNames.get(toolUseId) ?? "Write";
+            return [
+                {
+                    type: "post_tool_use",
+                    tool_use_id: toolUseId,
+                    tool_name: toolName,
+                    tool_response: fc.diff ?? fc.content ?? `File ${fc.action ?? "changed"}: ${fc.file_path ?? ""}`,
+                    ts: ts(),
+                },
+            ];
+        }
+        case "mcp_tool_call": {
+            const mc = item;
+            const toolUseId = mc.id ?? "";
+            const toolName = state.toolNames.get(toolUseId) ?? "mcp_tool";
+            return [
+                {
+                    type: "post_tool_use",
+                    tool_use_id: toolUseId,
+                    tool_name: toolName,
+                    tool_response: mc.result ?? "",
+                    ts: ts(),
+                },
+            ];
+        }
+        case "reasoning": {
+            const r = item;
+            if (r.content) {
+                return [
+                    {
+                        type: "assistant_thinking",
+                        text: r.content,
+                        ts: ts(),
+                    },
+                ];
+            }
+            return [];
+        }
+        default:
+            return [];
+    }
+}
+function handleTurnCompleted(msg, state) {
+    const events = [];
+    if (msg.cost_usd != null) {
+        state.totalCost += msg.cost_usd;
+        events.push({
+            type: "cost_update",
+            totalCostUsd: state.totalCost,
+            ts: ts(),
+        });
+    }
+    return events;
+}
+function handleTurnFailed(msg) {
+    return [
+        {
+            type: "log",
+            level: "error",
+            message: msg.error ?? "Turn failed",
+            ts: ts(),
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function extractMessageText(content) {
+    if (content == null)
+        return "";
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((block) => {
+            if (block.type === "text" && typeof block.text === "string")
+                return block.text;
+            return "";
+        })
+            .filter(Boolean)
+            .join("\n");
+    }
+    return String(content);
+}
+//# sourceMappingURL=codex-json-parser.js.map

package/dist/bridge/codex-json-parser.js.map

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

package/dist/bridge/codex-md-generator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generates AGENTS.md files for Codex CLI project workspaces.
+ *
+ * Reuses the same stack-specific content constants from claude-md-generator.ts
+ * since the instructions are framework-specific (Electric SQL + TanStack DB),
+ * not agent-specific.
+ */
+import type { ClaudeMdOptions } from "./claude-md-generator.js";
+/**
+ * Generate an AGENTS.md file for Codex CLI mode.
+ * Uses the same stack-specific content as Claude Code mode.
+ */
+export declare function generateCodexMd(opts: ClaudeMdOptions): string;
+//# sourceMappingURL=codex-md-generator.d.ts.map

package/dist/bridge/codex-md-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-md-generator.d.ts","sourceRoot":"","sources":["../../src/bridge/codex-md-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAa/D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAoC7D"}

package/dist/bridge/codex-md-generator.js

@@ -0,0 +1,45 @@
+/**
+ * Generates AGENTS.md files for Codex CLI project workspaces.
+ *
+ * Reuses the same stack-specific content constants from claude-md-generator.ts
+ * since the instructions are framework-specific (Electric SQL + TanStack DB),
+ * not agent-specific.
+ */
+import { DRIZZLE_WORKFLOW, devServerInstructions, GUARDRAILS, INFRASTRUCTURE, PLAYBOOK_INSTRUCTIONS, PROJECT_CONTEXT, SCAFFOLD_STRUCTURE, SSR_RULES, sandboxEnvironment, } from "./claude-md-generator.js";
+/**
+ * Generate an AGENTS.md file for Codex CLI mode.
+ * Uses the same stack-specific content as Claude Code mode.
+ */
+export function generateCodexMd(opts) {
+    const sections = [];
+    sections.push(`# ${opts.projectName}`);
+    sections.push("");
+    sections.push(PROJECT_CONTEXT);
+    sections.push("");
+    const sandbox = sandboxEnvironment(opts.runtime);
+    if (sandbox) {
+        sections.push(sandbox);
+        sections.push("");
+    }
+    if (!opts.isIteration) {
+        sections.push("## Current Task");
+        sections.push(opts.description);
+        sections.push("");
+    }
+    sections.push(SCAFFOLD_STRUCTURE);
+    sections.push("");
+    sections.push(DRIZZLE_WORKFLOW);
+    sections.push("");
+    sections.push(GUARDRAILS);
+    sections.push("");
+    sections.push(PLAYBOOK_INSTRUCTIONS);
+    sections.push("");
+    sections.push(INFRASTRUCTURE);
+    sections.push("");
+    sections.push(devServerInstructions(opts.runtime));
+    sections.push("");
+    sections.push(SSR_RULES);
+    sections.push("");
+    return sections.join("\n");
+}
+//# sourceMappingURL=codex-md-generator.js.map

package/dist/bridge/codex-md-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-md-generator.js","sourceRoot":"","sources":["../../src/bridge/codex-md-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACN,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,kBAAkB,GAClB,MAAM,0BAA0B,CAAA;AAEjC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAqB;IACpD,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEjB,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAChD,IAAI,OAAO,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClB,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAChC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClB,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEjB,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC"}