pi-kot 0.1.21 → 0.1.22

package/server/routes/stream.js.map

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

package/server/routes/terminal.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Terminal WebSocket Route
+ *
+ * WebSocket endpoint at /api/v1/terminal that spawns a PTY in the
+ * project's cwd and streams output to the browser.
+ *
+ * **Reattach support:** client passes a stable `tabId` on connect.
+ * If the server still has a PTY for that tabId (from a previous
+ * WS drop within the idle timeout), it reattaches instead of
+ * spawning a new shell. The rolling output buffer is replayed so
+ * xterm shows recent output.
+ *
+ * **Kill vs detach:** When the client closes the socket with reason
+ * `tab_closed` (explicit tab close), the PTY is killed. On any
+ * other close (panel toggle, network blip), the PTY is detached
+ * but kept alive for reattach.
+ *
+ * Protocol:
+ *   Client → Server: {"type":"input","data":"..."} | {"type":"resize","cols":N,"rows":N}
+ *   Server → Client: raw PTY bytes as binary frames (xterm consumes directly)
+ *
+ * Auth: `?token=` query param for browsers (no custom headers on WebSocket upgrade).
+ *
+ * Terminal WebSocket handler for PTY sessions.
+ */
+import type { FastifyPluginAsync } from "fastify";
+export declare const terminalRoutes: FastifyPluginAsync;
+//# sourceMappingURL=terminal.d.ts.map

package/server/routes/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/routes/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,SAAS,CAAC;AA4DlE,eAAO,MAAM,cAAc,EAAE,kBA4K5B,CAAC"}

package/server/routes/terminal.js

@@ -0,0 +1,211 @@
+/**
+ * Terminal WebSocket Route
+ *
+ * WebSocket endpoint at /api/v1/terminal that spawns a PTY in the
+ * project's cwd and streams output to the browser.
+ *
+ * **Reattach support:** client passes a stable `tabId` on connect.
+ * If the server still has a PTY for that tabId (from a previous
+ * WS drop within the idle timeout), it reattaches instead of
+ * spawning a new shell. The rolling output buffer is replayed so
+ * xterm shows recent output.
+ *
+ * **Kill vs detach:** When the client closes the socket with reason
+ * `tab_closed` (explicit tab close), the PTY is killed. On any
+ * other close (panel toggle, network blip), the PTY is detached
+ * but kept alive for reattach.
+ *
+ * Protocol:
+ *   Client → Server: {"type":"input","data":"..."} | {"type":"resize","cols":N,"rows":N}
+ *   Server → Client: raw PTY bytes as binary frames (xterm consumes directly)
+ *
+ * Auth: `?token=` query param for browsers (no custom headers on WebSocket upgrade).
+ *
+ * Terminal WebSocket handler for PTY sessions.
+ */
+import { authEnabled, verifyHmac } from "./auth.js";
+import { config } from "../config.js";
+import { attachSink, findPtyByTabId, killPty, spawnPty, } from "../terminal-provider.js";
+import { getProject } from "../workspace-store.js";
+const CLOSE_AUTH_REQUIRED = 4401;
+const CLOSE_PROJECT_NOT_FOUND = 4404;
+const CLOSE_INTERNAL_ERROR = 4500;
+function parseClientMessage(raw) {
+    if (typeof raw !== "string" && !(raw instanceof Buffer))
+        return undefined;
+    const MAX_INPUT_BYTES = 1 * 1024 * 1024;
+    if (typeof raw === "string" ? raw.length > MAX_INPUT_BYTES : raw.byteLength > MAX_INPUT_BYTES) {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(typeof raw === "string" ? raw : raw.toString("utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return undefined;
+    const obj = parsed;
+    if (obj.type === "input" && typeof obj.data === "string") {
+        return { type: "input", data: obj.data };
+    }
+    if (obj.type === "resize" &&
+        typeof obj.cols === "number" &&
+        typeof obj.rows === "number" &&
+        Number.isInteger(obj.cols) &&
+        Number.isInteger(obj.rows) &&
+        obj.cols > 0 &&
+        obj.rows > 0 &&
+        obj.cols <= 1000 &&
+        obj.rows <= 1000) {
+        return { type: "resize", cols: obj.cols, rows: obj.rows };
+    }
+    return undefined;
+}
+export const terminalRoutes = async (fastify) => {
+    fastify.get("/terminal", {
+        websocket: true,
+        config: { public: true },
+    }, async (socket, req) => {
+        const log = req.log;
+        const query = req.query;
+        // Auth check
+        if (authEnabled()) {
+            const apiKey = config.apiKey;
+            const token = query.token;
+            const verified = token !== undefined &&
+                (verifyHmac(token) !== undefined ||
+                    (apiKey !== undefined && token === apiKey));
+            if (!verified) {
+                socket.send(JSON.stringify({ type: "error", message: "Authentication required" }));
+                socket.close(CLOSE_AUTH_REQUIRED, "auth_required");
+                return;
+            }
+        }
+        // Resolve project for cwd
+        const projectId = query.projectId;
+        let projectCwd;
+        if (projectId) {
+            const project = await getProject(projectId);
+            if (project) {
+                projectCwd = project.path;
+            }
+        }
+        const cwd = projectCwd || query.cwd || config.workspacePath || process.env.HOME || "/tmp";
+        // Reattach path: if tabId is provided and a PTY exists, reuse it
+        const requestedTabId = query.tabId;
+        let managed;
+        let reattached = false;
+        if (requestedTabId !== undefined && projectId !== undefined) {
+            const existing = findPtyByTabId(requestedTabId, projectId);
+            if (existing !== undefined) {
+                managed = existing;
+                reattached = true;
+            }
+        }
+        if (managed === undefined) {
+            try {
+                managed = spawnPty({
+                    cwd,
+                    tabId: requestedTabId ?? `srv-${Date.now().toString(36)}`,
+                    projectId: projectId ?? "_default",
+                });
+            }
+            catch (err) {
+                log.error({ err }, "pty spawn failed");
+                socket.send(JSON.stringify({ type: "error", message: "Failed to spawn PTY" }));
+                socket.close(CLOSE_INTERNAL_ERROR, "spawn_failed");
+                return;
+            }
+        }
+        log.info({ ptyId: managed.ptyId, tabId: managed.tabId, cwd, reattached }, reattached ? "terminal reattached" : "terminal opened");
+        // Send open confirmation
+        socket.send(JSON.stringify({ type: "open", id: managed.ptyId, cwd, reattached }));
+        // Attach sink: PTY output → binary WebSocket frames
+        const closeOnDisplace = () => {
+            if (socket.readyState === socket.OPEN || socket.readyState === socket.CONNECTING) {
+                socket.close(4409, "replaced_by_new_attach");
+            }
+        };
+        const detach = attachSink(managed.ptyId, (chunk) => {
+            if (socket.readyState === socket.OPEN) {
+                socket.send(chunk);
+            }
+        }, undefined, closeOnDisplace);
+        if (detach === undefined) {
+            log.error({ ptyId: managed.ptyId }, "attachSink failed");
+            socket.close(CLOSE_INTERNAL_ERROR, "attach_failed");
+            return;
+        }
+        // WebSocket keepalive ping
+        const keepAliveTimer = setInterval(() => {
+            if (socket.readyState === socket.OPEN) {
+                try {
+                    socket.ping();
+                }
+                catch {
+                    // socket closing
+                }
+            }
+        }, 30_000).unref();
+        // PTY exit → close socket
+        const exitDisposable = managed.process.onExit(({ exitCode, signal }) => {
+            log.info({ ptyId: managed.ptyId, exitCode, signal }, "terminal exited");
+            if (socket.readyState === socket.OPEN || socket.readyState === socket.CONNECTING) {
+                socket.send(JSON.stringify({ type: "exit", code: exitCode }));
+                socket.close(1000, "pty_exited");
+            }
+        });
+        let disposed = false;
+        const cleanup = (reason, killOnClose = false) => {
+            if (disposed)
+                return;
+            disposed = true;
+            clearInterval(keepAliveTimer);
+            detach();
+            exitDisposable.dispose();
+            if (killOnClose) {
+                killPty(managed.ptyId);
+                log.info({ ptyId: managed.ptyId, tabId: managed.tabId, reason }, "terminal closed");
+                return;
+            }
+            log.info({ ptyId: managed.ptyId, tabId: managed.tabId, reason }, "terminal detached");
+        };
+        socket.on("message", (raw) => {
+            const msg = parseClientMessage(raw);
+            if (msg === undefined)
+                return;
+            if (msg.type === "input") {
+                try {
+                    managed.process.write(msg.data);
+                }
+                catch (err) {
+                    log.warn({ err, ptyId: managed.ptyId }, "pty write failed");
+                    if (socket.readyState === socket.OPEN) {
+                        socket.close(CLOSE_INTERNAL_ERROR, "pty_dead");
+                    }
+                }
+            }
+            else {
+                try {
+                    managed.process.resize(msg.cols, msg.rows);
+                }
+                catch (err) {
+                    log.warn({ err }, "pty resize failed");
+                    if (socket.readyState === socket.OPEN) {
+                        socket.close(CLOSE_INTERNAL_ERROR, "pty_dead");
+                    }
+                }
+            }
+        });
+        socket.on("close", (_code, reason) => {
+            cleanup("ws_close", reason.toString("utf8") === "tab_closed");
+        });
+        socket.on("error", (err) => {
+            log.warn({ err, ptyId: managed.ptyId }, "terminal websocket error");
+            cleanup("ws_error");
+        });
+    });
+};
+//# sourceMappingURL=terminal.js.map

package/server/routes/terminal.js.map

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

package/server/routes/tunnel.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tunnel REST routes — all under GET/POST /api/v1/tunnel/*
+ *
+ * Wires the ngrok tunnel service into Fastify. The tunnel service is a
+ * singleton (one active tunnel at a time) constructed lazily on first request.
+ */
+import type { FastifyPluginAsync } from "fastify";
+/**
+ * Tunnel routes. The tunnel service is a server-wide singleton
+ * created on first request to /api/v1/tunnel/*.
+ */
+export declare const tunnelRoutes: FastifyPluginAsync;
+//# sourceMappingURL=tunnel.d.ts.map

package/server/routes/tunnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.d.ts","sourceRoot":"","sources":["../../src/routes/tunnel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAalD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,kBA6P1B,CAAC"}

package/server/routes/tunnel.js

@@ -0,0 +1,231 @@
+/**
+ * Tunnel REST routes — all under GET/POST /api/v1/tunnel/*
+ *
+ * Wires the ngrok tunnel service into Fastify. The tunnel service is a
+ * singleton (one active tunnel at a time) constructed lazily on first request.
+ */
+import { createTunnelProviderRegistry } from "../tunnel/registry.js";
+import { createTunnelService } from "../tunnel/service.js";
+import { createNgrokTunnelProvider } from "../tunnel/providers/ngrok.js";
+import { TunnelServiceError, TUNNEL_PROVIDER_NGROK, } from "../tunnel/types.js";
+import { config } from "../config.js";
+/**
+ * Tunnel routes. The tunnel service is a server-wide singleton
+ * created on first request to /api/v1/tunnel/*.
+ */
+export const tunnelRoutes = async (fastify) => {
+    // ── Singleton state ─────────────────────────────────────────────────────
+    let activeController = null;
+    let serviceInitialized = false;
+    let tunnelServiceInstance;
+    function getTunnelService() {
+        if (!serviceInitialized) {
+            const registry = createTunnelProviderRegistry([
+                createNgrokTunnelProvider(),
+            ]);
+            registry.seal();
+            tunnelServiceInstance = createTunnelService({
+                registry,
+                getController: () => activeController,
+                setController: (c) => { activeController = c; },
+                getActivePort: () => config.port,
+                onQuickTunnelWarning: () => {
+                    fastify.log.warn("ngrok quick tunnel started — URL is ephemeral");
+                },
+            });
+            serviceInitialized = true;
+        }
+        return tunnelServiceInstance;
+    }
+    // ── Routes ──────────────────────────────────────────────────────────────
+    /**
+     * GET /tunnel/check — Check if ngrok is installed.
+     */
+    fastify.get("/tunnel/check", {
+        schema: {
+            description: "Check if ngrok is installed",
+            tags: ["tunnel"],
+            response: {
+                200: {
+                    type: "object",
+                    properties: {
+                        available: { type: "boolean" },
+                        provider: { type: "string" },
+                        version: { type: "string", nullable: true },
+                        dependency: { type: "string", nullable: true },
+                        installCommand: { type: "string", nullable: true },
+                        installUrl: { type: "string", nullable: true },
+                        platform: { type: "string" },
+                        message: { type: "string", nullable: true },
+                    },
+                },
+            },
+        },
+    }, async () => {
+        try {
+            const service = getTunnelService();
+            const result = await service.checkAvailability(TUNNEL_PROVIDER_NGROK);
+            return {
+                available: result.available,
+                provider: TUNNEL_PROVIDER_NGROK,
+                version: result.version || null,
+                dependency: result.dependency || null,
+                installCommand: result.installCommand || null,
+                installUrl: result.installUrl || null,
+                platform: result.platform || process.platform,
+                message: result.message || null,
+            };
+        }
+        catch (error) {
+            fastify.log.warn({ error }, "Tunnel dependency check failed");
+            return {
+                available: false,
+                provider: TUNNEL_PROVIDER_NGROK,
+                version: null,
+                dependency: null,
+                installCommand: null,
+                installUrl: null,
+                platform: process.platform,
+                message: null,
+            };
+        }
+    });
+    /**
+     * GET /tunnel/doctor — Run ngrok diagnostics.
+     */
+    fastify.get("/tunnel/doctor", {
+        schema: {
+            description: "Run ngrok diagnostics (binary, authtoken, network)",
+            tags: ["tunnel"],
+        },
+    }, async (req, reply) => {
+        try {
+            const providerId = TUNNEL_PROVIDER_NGROK;
+            // Import and run ngrok's diagnose directly
+            const { diagnoseNgrok } = await import("../tunnel/providers/ngrok.js");
+            const result = await diagnoseNgrok();
+            return { ok: true, provider: providerId, ...result };
+        }
+        catch (error) {
+            if (error instanceof TunnelServiceError) {
+                return reply.status(400).send({ ok: false, error: error.message, code: error.code });
+            }
+            fastify.log.warn({ error }, "Tunnel doctor failed");
+            return reply.status(500).send({ ok: false, error: "Failed to run tunnel doctor" });
+        }
+    });
+    /**
+     * GET /tunnel/status — Get the current tunnel state.
+     */
+    fastify.get("/tunnel/status", {
+        schema: {
+            description: "Get current tunnel status",
+            tags: ["tunnel"],
+            response: {
+                200: {
+                    type: "object",
+                    properties: {
+                        active: { type: "boolean" },
+                        url: { type: "string", nullable: true },
+                        mode: { type: "string", nullable: true },
+                        provider: { type: "string", nullable: true },
+                        providerMetadata: { type: "object", nullable: true },
+                        localPort: { type: "number", nullable: true },
+                    },
+                },
+            },
+        },
+    }, async () => {
+        const service = getTunnelService();
+        const publicUrl = service.getPublicUrl();
+        if (!publicUrl) {
+            return {
+                active: false,
+                url: null,
+                mode: null,
+                provider: service.resolveActiveProvider(),
+                providerMetadata: null,
+                localPort: config.port,
+            };
+        }
+        return {
+            active: true,
+            url: publicUrl,
+            mode: service.resolveActiveMode(),
+            provider: service.resolveActiveProvider(),
+            providerMetadata: service.getProviderMetadata(),
+            localPort: config.port,
+        };
+    });
+    /**
+     * POST /tunnel/start — Start an ngrok tunnel.
+     * Body: { mode?: "quick" } (only quick mode supported)
+     */
+    fastify.post("/tunnel/start", {
+        schema: {
+            description: "Start an ngrok tunnel",
+            tags: ["tunnel"],
+            body: {
+                type: "object",
+                properties: {
+                    mode: { type: "string", default: "quick" },
+                },
+            },
+        },
+    }, async (req, reply) => {
+        try {
+            const body = (req.body ?? {});
+            const service = getTunnelService();
+            const result = await service.start({
+                provider: TUNNEL_PROVIDER_NGROK,
+                mode: "quick",
+            });
+            fastify.log.info(`ngrok tunnel active: ${result.publicUrl}`);
+            return {
+                ok: true,
+                url: result.publicUrl,
+                mode: result.activeMode,
+                provider: result.provider,
+                providerMetadata: result.providerMetadata,
+                localPort: config.port,
+            };
+        }
+        catch (error) {
+            fastify.log.error({ error }, "Failed to start ngrok tunnel");
+            activeController = null;
+            if (error instanceof TunnelServiceError) {
+                const status = error.code === "missing_dependency" ? 400
+                    : error.code === "validation_error" || error.code === "provider_unsupported" || error.code === "mode_unsupported" ? 422
+                        : 500;
+                return reply.status(status).send({
+                    ok: false,
+                    error: error.message,
+                    code: error.code,
+                });
+            }
+            return reply.status(500).send({
+                ok: false,
+                error: error instanceof Error ? error.message : "Failed to start tunnel",
+                code: "startup_failed",
+            });
+        }
+    });
+    /**
+     * POST /tunnel/stop — Stop the active ngrok tunnel.
+     */
+    fastify.post("/tunnel/stop", {
+        schema: {
+            description: "Stop the active ngrok tunnel",
+            tags: ["tunnel"],
+        },
+    }, async () => {
+        const service = getTunnelService();
+        const wasActive = service.getPublicUrl() !== null;
+        if (wasActive) {
+            fastify.log.info("Stopping active ngrok tunnel...");
+            service.stop();
+        }
+        return { ok: true, wasActive };
+    });
+};
+//# sourceMappingURL=tunnel.js.map

package/server/routes/tunnel.js.map

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

package/server/session-alerts.d.ts

@@ -0,0 +1,28 @@
+import type { AgentSession } from "@earendil-works/pi-coding-agent";
+export interface CustomLifecycleMessage {
+    customType: string;
+    content: string;
+    display: boolean;
+    details?: unknown;
+}
+interface LifecycleSession {
+    isStreaming: boolean;
+    messages: readonly unknown[];
+    sendCustomMessage: AgentSession["sendCustomMessage"];
+}
+/**
+ * Send a custom lifecycle/status card with explicit active-run behavior.
+ *
+ * While streaming, lifecycle cards use `steer`. When idle, `triggerTurn`
+ * controls whether the card starts a new model turn.
+ */
+export declare function sendCustomLifecycleMessage(session: LifecycleSession, message: CustomLifecycleMessage, options: {
+    triggerTurn: boolean;
+    dedupe?: {
+        detailKey: string;
+        detailValue: string;
+    };
+    onError?: (err: unknown) => void;
+}): void;
+export {};
+//# sourceMappingURL=session-alerts.d.ts.map

package/server/session-alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-alerts.d.ts","sourceRoot":"","sources":["../src/session-alerts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,gBAAgB;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,iBAAiB,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC;CACtD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE;IACP,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC,GACA,IAAI,CA6BN"}

package/server/session-alerts.js

@@ -0,0 +1,38 @@
+/**
+ * Send a custom lifecycle/status card with explicit active-run behavior.
+ *
+ * While streaming, lifecycle cards use `steer`. When idle, `triggerTurn`
+ * controls whether the card starts a new model turn.
+ */
+export function sendCustomLifecycleMessage(session, message, options) {
+    if (options.dedupe !== undefined &&
+        hasExistingNotification(session.messages, message.customType, options.dedupe)) {
+        return;
+    }
+    const send = (sendOptions) => {
+        void session.sendCustomMessage(message, sendOptions).catch((err) => {
+            options.onError?.(err);
+        });
+    };
+    if (session.isStreaming) {
+        send({ deliverAs: "steer", triggerTurn: options.triggerTurn });
+        return;
+    }
+    if (options.dedupe !== undefined &&
+        hasExistingNotification(session.messages, message.customType, options.dedupe)) {
+        return;
+    }
+    send({ triggerTurn: options.triggerTurn });
+}
+function hasExistingNotification(messages, customType, dedupe) {
+    return messages.some((message) => {
+        const m = message;
+        if (m.role !== "custom" || m.customType !== customType)
+            return false;
+        if (typeof m.details !== "object" || m.details === null)
+            return false;
+        const details = m.details;
+        return details[dedupe.detailKey] === dedupe.detailValue;
+    });
+}
+//# sourceMappingURL=session-alerts.js.map

package/server/session-alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-alerts.js","sourceRoot":"","sources":["../src/session-alerts.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAyB,EACzB,OAA+B,EAC/B,OAIC;IAED,IACE,OAAO,CAAC,MAAM,KAAK,SAAS;QAC5B,uBAAuB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,EAC7E,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,WAGb,EAAQ,EAAE;QACT,KAAK,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YAC1E,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,IACE,OAAO,CAAC,MAAM,KAAK,SAAS;QAC5B,uBAAuB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,EAC7E,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,uBAAuB,CAC9B,QAA4B,EAC5B,UAAkB,EAClB,MAAkD;IAElD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/B,MAAM,CAAC,GAAG,OAAsE,CAAC;QACjF,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC;QACrE,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACtE,MAAM,OAAO,GAAG,CAAC,CAAC,OAAkC,CAAC;QACrD,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC"}