@electric-agent/studio 1.0.0 → 1.1.0

package/dist/active-sessions.d.ts

@@ -0,0 +1,28 @@
+import type { SessionInfo } from "./sessions.js";
+/**
+ * Lightweight in-memory session store for the current server lifetime.
+ *
+ * Sessions are private to each user (stored in their browser's localStorage).
+ * The server only tracks active sessions for sandbox/bridge management.
+ * This store is NOT persisted — it resets on server restart.
+ */
+export declare class ActiveSessions {
+    private sessions;
+    private transcriptToSession;
+    add(session: SessionInfo): void;
+    get(id: string): SessionInfo | undefined;
+    update(id: string, update: Partial<SessionInfo>): void;
+    delete(id: string): boolean;
+    /** Check if a session exists in the active store. */
+    has(id: string): boolean;
+    /**
+     * Look up the EA session ID for a Claude Code transcript path.
+     * Returns undefined if no mapping exists or the session has been deleted.
+     */
+    getByTranscript(transcriptPath: string): string | undefined;
+    /**
+     * Map a transcript path to an EA session ID.
+     */
+    mapTranscript(transcriptPath: string, sessionId: string): void;
+}
+//# sourceMappingURL=active-sessions.d.ts.map

package/dist/active-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-sessions.d.ts","sourceRoot":"","sources":["../src/active-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;GAMG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,mBAAmB,CAA4B;IAEvD,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAI/B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAStD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,qDAAqD;IACrD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAMxB;;;OAGG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAM3D;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAG9D"}

package/dist/active-sessions.js

@@ -0,0 +1,50 @@
+/**
+ * Lightweight in-memory session store for the current server lifetime.
+ *
+ * Sessions are private to each user (stored in their browser's localStorage).
+ * The server only tracks active sessions for sandbox/bridge management.
+ * This store is NOT persisted — it resets on server restart.
+ */
+export class ActiveSessions {
+    sessions = new Map();
+    transcriptToSession = new Map();
+    add(session) {
+        this.sessions.set(session.id, session);
+    }
+    get(id) {
+        return this.sessions.get(id);
+    }
+    update(id, update) {
+        const session = this.sessions.get(id);
+        if (session) {
+            Object.assign(session, update, {
+                lastActiveAt: new Date().toISOString(),
+            });
+        }
+    }
+    delete(id) {
+        return this.sessions.delete(id);
+    }
+    /** Check if a session exists in the active store. */
+    has(id) {
+        return this.sessions.has(id);
+    }
+    // --- Transcript → Session Mapping (for Claude Code hook integration) ---
+    /**
+     * Look up the EA session ID for a Claude Code transcript path.
+     * Returns undefined if no mapping exists or the session has been deleted.
+     */
+    getByTranscript(transcriptPath) {
+        const sessionId = this.transcriptToSession.get(transcriptPath);
+        if (!sessionId)
+            return undefined;
+        return this.sessions.has(sessionId) ? sessionId : undefined;
+    }
+    /**
+     * Map a transcript path to an EA session ID.
+     */
+    mapTranscript(transcriptPath, sessionId) {
+        this.transcriptToSession.set(transcriptPath, sessionId);
+    }
+}
+//# sourceMappingURL=active-sessions.js.map

package/dist/active-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-sessions.js","sourceRoot":"","sources":["../src/active-sessions.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAA;IACzC,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEvD,GAAG,CAAC,OAAoB;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,MAA4B;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACrC,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE;gBAC9B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAA;QACH,CAAC;IACF,CAAC;IAED,MAAM,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAChC,CAAC;IAED,qDAAqD;IACrD,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;IAED,0EAA0E;IAE1E;;;OAGG;IACH,eAAe,CAAC,cAAsB;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QAC9D,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAA;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;IAC5D,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,cAAsB,EAAE,SAAiB;QACtD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAA;IACxD,CAAC;CACD"}

package/dist/bridge/claude-code-docker.d.ts

@@ -0,0 +1,59 @@
+/**
+ * SessionBridge implementation that runs Claude Code CLI inside a Docker
+ * container via `docker exec -i`, communicating via stream-json NDJSON.
+ *
+ * The bridge translates Claude Code's stream-json output into EngineEvents
+ * and writes them to the Durable Stream for the UI. User messages and
+ * gate responses are sent to Claude Code's stdin.
+ */
+import type { EngineEvent } from "@electric-agent/protocol";
+import type { StreamConnectionInfo } from "../streams.js";
+import type { SessionBridge } from "./types.js";
+export interface ClaudeCodeDockerConfig {
+    /** Initial prompt (the user's app description or task) */
+    prompt: string;
+    /** Working directory inside the container */
+    cwd: string;
+    /** Model to use (default: claude-sonnet-4-6) */
+    model?: string;
+    /** Allowed tools (default: all standard tools) */
+    allowedTools?: string[];
+    /** Additional CLI flags */
+    extraFlags?: string[];
+}
+export declare class ClaudeCodeDockerBridge implements SessionBridge {
+    readonly sessionId: string;
+    readonly streamUrl: string;
+    readonly streamHeaders: Record<string, string>;
+    private containerId;
+    private config;
+    private writer;
+    private parser;
+    private agentEventCallbacks;
+    private completeCallbacks;
+    private closed;
+    private proc;
+    constructor(sessionId: string, connection: StreamConnectionInfo, containerId: string, config: ClaudeCodeDockerConfig);
+    emit(event: EngineEvent): Promise<void>;
+    /**
+     * Send a follow-up user message to Claude Code via stdin.
+     * Used for iteration requests (the user types a new message in the UI).
+     */
+    sendCommand(cmd: Record<string, unknown>): Promise<void>;
+    /**
+     * Send a gate response back to Claude Code as a user message.
+     * For ask_user_question gates, the user's answer becomes a follow-up message.
+     */
+    sendGateResponse(gate: string, value: Record<string, unknown>): Promise<void>;
+    onAgentEvent(cb: (event: EngineEvent) => void): void;
+    onComplete(cb: (success: boolean) => void): void;
+    start(): Promise<void>;
+    close(): void;
+    private handleLine;
+    private dispatchEvent;
+    /**
+     * Write a user message to Claude Code's stdin in stream-json format.
+     */
+    private writeUserMessage;
+}
+//# sourceMappingURL=claude-code-docker.d.ts.map

package/dist/bridge/claude-code-docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-docker.d.ts","sourceRoot":"","sources":["../../src/bridge/claude-code-docker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAA;AAE9D,MAAM,WAAW,sBAAsB;IACtC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAcD,qBAAa,sBAAuB,YAAW,aAAa;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,mBAAmB,CAA0C;IACrE,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,IAAI,CAA4B;gBAGvC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,sBAAsB;IAezB,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;;OAGG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCnF,YAAY,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIpD,UAAU,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAI1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8E5B,KAAK,IAAI,IAAI;IAiBb,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,aAAa;IA4CrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAQxB"}

package/dist/bridge/claude-code-docker.js

@@ -0,0 +1,258 @@
+/**
+ * SessionBridge implementation that runs Claude Code CLI inside a Docker
+ * container via `docker exec -i`, communicating via stream-json NDJSON.
+ *
+ * The bridge translates Claude Code's stream-json output into EngineEvents
+ * and writes them to the Durable Stream for the UI. User messages and
+ * gate responses are sent to Claude Code's stdin.
+ */
+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 { createStreamJsonParser } from "./stream-json-parser.js";
+const DEFAULT_ALLOWED_TOOLS = [
+    "Read",
+    "Write",
+    "Edit",
+    "Bash",
+    "Glob",
+    "Grep",
+    "WebSearch",
+    "TodoWrite",
+    "AskUserQuestion",
+];
+export class ClaudeCodeDockerBridge {
+    sessionId;
+    streamUrl;
+    streamHeaders;
+    containerId;
+    config;
+    writer;
+    parser = createStreamJsonParser();
+    agentEventCallbacks = [];
+    completeCallbacks = [];
+    closed = false;
+    proc = null;
+    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 Claude Code via stdin.
+     * Used for iteration requests (the user types a new message in the UI).
+     */
+    async sendCommand(cmd) {
+        if (this.closed || !this.proc?.stdin?.writable)
+            return;
+        // For iteration: send the request as a user message to Claude Code's stdin
+        if (cmd.command === "iterate" && typeof cmd.request === "string") {
+            this.writeUserMessage(cmd.request);
+            return;
+        }
+        // For initial "new" command: this is handled in start() via the prompt
+        // Other commands are ignored — Claude Code doesn't understand them
+        console.log(`[claude-code-docker] Ignoring unsupported command: ${cmd.command}`);
+    }
+    /**
+     * Send a gate response back to Claude Code as a user message.
+     * For ask_user_question gates, the user's answer becomes a follow-up message.
+     */
+    async sendGateResponse(gate, value) {
+        if (this.closed || !this.proc?.stdin?.writable)
+            return;
+        if (gate === "ask_user_question" || gate.startsWith("ask_user_question:")) {
+            const answer = value.answer || "";
+            this.writeUserMessage(answer);
+            return;
+        }
+        if (gate === "clarification") {
+            const answers = value.answers;
+            if (answers?.length) {
+                this.writeUserMessage(answers.join("\n"));
+            }
+            return;
+        }
+        if (gate === "approval") {
+            const decision = value.decision || "approve";
+            this.writeUserMessage(decision);
+            return;
+        }
+        if (gate === "continue") {
+            const proceed = value.proceed;
+            this.writeUserMessage(proceed ? "continue" : "stop");
+            return;
+        }
+        // Generic: send the value as JSON
+        this.writeUserMessage(JSON.stringify(value));
+    }
+    onAgentEvent(cb) {
+        this.agentEventCallbacks.push(cb);
+    }
+    onComplete(cb) {
+        this.completeCallbacks.push(cb);
+    }
+    async start() {
+        if (this.closed)
+            return;
+        const allowedTools = this.config.allowedTools ?? DEFAULT_ALLOWED_TOOLS;
+        const model = this.config.model ?? "claude-sonnet-4-6";
+        // Build the claude CLI command
+        const claudeArgs = [
+            "-p",
+            this.config.prompt,
+            "--output-format",
+            "stream-json",
+            "--verbose",
+            "--model",
+            model,
+            "--dangerously-skip-permissions",
+            "--allowedTools",
+            allowedTools.join(","),
+            ...(this.config.extraFlags ?? []),
+        ];
+        // Escape for bash
+        const escapedArgs = claudeArgs.map((a) => `'${a.replace(/'/g, "'\\''")}'`).join(" ");
+        const cmd = `cd '${this.config.cwd}' && claude ${escapedArgs}`;
+        // Note: do NOT use -i flag — Claude Code detects interactive stdin and blocks
+        // waiting for input even when -p is provided. Without -i, stdout flows normally.
+        this.proc = spawn("docker", ["exec", this.containerId, "bash", "-c", cmd], {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        console.log(`[claude-code-docker] Started: session=${this.sessionId} container=${this.containerId} pid=${this.proc.pid}`);
+        console.log(`[claude-code-docker] cmd: ${cmd}`);
+        // Read stdout line by line (stream-json NDJSON)
+        if (this.proc.stdout) {
+            const rl = readline.createInterface({
+                input: this.proc.stdout,
+                terminal: false,
+            });
+            rl.on("line", (line) => {
+                if (this.closed)
+                    return;
+                console.log(`[claude-code-docker:stdout] ${line.slice(0, 120)}...`);
+                this.handleLine(line);
+            });
+        }
+        // Log stderr
+        if (this.proc.stderr) {
+            const stderrRl = readline.createInterface({
+                input: this.proc.stderr,
+                terminal: false,
+            });
+            stderrRl.on("line", (line) => {
+                if (!this.closed) {
+                    console.error(`[claude-code-docker:stderr] ${line}`);
+                }
+            });
+        }
+        // Handle process exit
+        this.proc.on("exit", (code) => {
+            console.log(`[claude-code-docker] Process exited: code=${code} session=${this.sessionId}`);
+            // If process exits without a session_end event, emit one
+            if (!this.closed) {
+                const endEvent = {
+                    type: "session_end",
+                    success: code === 0,
+                    ts: ts(),
+                };
+                this.dispatchEvent(endEvent);
+            }
+        });
+    }
+    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
+    // -----------------------------------------------------------------------
+    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(() => { });
+        // 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
+                }
+            }
+        }
+    }
+    /**
+     * Write a user message to Claude Code's stdin in stream-json format.
+     */
+    writeUserMessage(content) {
+        if (!this.proc?.stdin?.writable)
+            return;
+        const msg = JSON.stringify({
+            type: "user",
+            message: { role: "user", content },
+        });
+        this.proc.stdin.write(`${msg}\n`);
+    }
+}
+//# sourceMappingURL=claude-code-docker.js.map

package/dist/bridge/claude-code-docker.js.map

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

package/dist/bridge/claude-code-sprites.d.ts

@@ -0,0 +1,49 @@
+/**
+ * SessionBridge implementation that runs Claude Code CLI inside a Sprites
+ * sandbox via the Sprites SDK session API, communicating via stream-json NDJSON.
+ *
+ * The bridge translates Claude Code's stream-json output into EngineEvents
+ * and writes them to the Durable Stream for the UI. User messages and
+ * gate responses are sent to Claude Code's stdin.
+ */
+import type { EngineEvent } from "@electric-agent/protocol";
+import type { Sprite } from "@fly/sprites";
+import type { StreamConnectionInfo } from "../streams.js";
+import type { SessionBridge } from "./types.js";
+export interface ClaudeCodeSpritesConfig {
+    /** Initial prompt (the user's app description or task) */
+    prompt: string;
+    /** Working directory inside the sprite */
+    cwd: string;
+    /** Model to use (default: claude-sonnet-4-6) */
+    model?: string;
+    /** Allowed tools (default: all standard tools) */
+    allowedTools?: string[];
+    /** Additional CLI flags */
+    extraFlags?: string[];
+}
+export declare class ClaudeCodeSpritesBridge implements SessionBridge {
+    readonly sessionId: string;
+    readonly streamUrl: string;
+    readonly streamHeaders: Record<string, string>;
+    private sprite;
+    private config;
+    private writer;
+    private parser;
+    private agentEventCallbacks;
+    private completeCallbacks;
+    private closed;
+    private cmd;
+    constructor(sessionId: string, connection: StreamConnectionInfo, sprite: Sprite, config: ClaudeCodeSpritesConfig);
+    emit(event: EngineEvent): Promise<void>;
+    sendCommand(cmd: Record<string, unknown>): Promise<void>;
+    sendGateResponse(gate: string, value: Record<string, unknown>): Promise<void>;
+    onAgentEvent(cb: (event: EngineEvent) => void): void;
+    onComplete(cb: (success: boolean) => void): void;
+    start(): Promise<void>;
+    close(): void;
+    private handleLine;
+    private dispatchEvent;
+    private writeUserMessage;
+}
+//# sourceMappingURL=claude-code-sprites.d.ts.map

package/dist/bridge/claude-code-sprites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-sprites.d.ts","sourceRoot":"","sources":["../../src/bridge/claude-code-sprites.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAA;AAI9D,MAAM,WAAW,uBAAuB;IACvC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAcD,qBAAa,uBAAwB,YAAW,aAAa;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,mBAAmB,CAA0C;IACrE,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,GAAG,CAA6B;gBAGvC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,uBAAuB;IAe1B,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCnF,YAAY,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIpD,UAAU,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAI1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoE5B,KAAK,IAAI,IAAI;IAgBb,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,aAAa;IAyCrB,OAAO,CAAC,gBAAgB;CAQxB"}