@termlink/cli 0.1.0

package/dist/server/connection.js

@@ -0,0 +1,182 @@
+import { Command, PROTOCOL_VERSION, TERMINAL_FRAME_INPUT, decodeTerminalFrame, } from "@termlink/protocol";
+import { HostError, errorMessage } from "../errors.js";
+import { TerminalSession } from "../session/terminal-session.js";
+/**
+ * One client's view of the host, independent of transport. The local WebSocket
+ * server and the relay link both use it.
+ */
+export class ClientConnection {
+    #manager;
+    #send;
+    #sendBinary;
+    #hostInfo;
+    #attachments = new Map();
+    #unsubscribeHost = null;
+    #disposed = false;
+    constructor(manager, transport, hostInfo) {
+        this.#manager = manager;
+        const t = typeof transport === "function" ? { send: transport } : transport;
+        this.#send = t.send;
+        this.#sendBinary = t.sendBinary ?? (() => { });
+        this.#hostInfo = hostInfo;
+    }
+    async open() {
+        this.#unsubscribeHost = this.#manager.onHostEvent((event) => {
+            if (event.type === "session.closed" && event.sessionId)
+                this.#attachments.delete(event.sessionId);
+            this.#send(event);
+        });
+        await this.announce();
+    }
+    /** Sends host.ready. The relay transport repeats it when a new client joins. */
+    async announce() {
+        const payload = await this.#hostInfo();
+        if (this.#disposed)
+            return;
+        this.#send({ v: PROTOCOL_VERSION, kind: "evt", type: "host.ready", ts: Date.now(), payload });
+    }
+    async handle(raw) {
+        let data;
+        try {
+            data = JSON.parse(raw);
+        }
+        catch {
+            this.#fail("", "bad_request", "message is not valid JSON");
+            return;
+        }
+        await this.handleMessage(data);
+    }
+    /** Handles an already parsed message, such as one reassembled from chunks. */
+    async handleMessage(data) {
+        const parsed = Command.safeParse(data);
+        if (!parsed.success) {
+            const issues = parsed.error.issues.slice(0, 3).map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`);
+            this.#fail(reqIdOf(data), "bad_request", issues.join("; "));
+            return;
+        }
+        try {
+            await this.#dispatch(parsed.data);
+        }
+        catch (err) {
+            if (err instanceof HostError)
+                this.#fail(parsed.data.reqId, err.code, err.message);
+            else
+                this.#fail(parsed.data.reqId, "internal", errorMessage(err));
+        }
+    }
+    /**
+     * Terminal input from a binary frame. Only for sessions this connection is attached
+     * to; anything else is dropped without a reply, since frames carry no reqId.
+     */
+    handleBinary(data) {
+        const frame = decodeTerminalFrame(data);
+        if (!frame || frame.kind !== TERMINAL_FRAME_INPUT || !this.#attachments.has(frame.sessionId))
+            return;
+        const session = this.#manager.get(frame.sessionId);
+        if (session instanceof TerminalSession && !session.closed)
+            session.write(frame.payload);
+    }
+    dispose() {
+        this.#disposed = true;
+        for (const detach of this.#attachments.values())
+            detach();
+        this.#attachments.clear();
+        this.#unsubscribeHost?.();
+    }
+    // Each case replies itself. Attaching, replying and replaying happen in one
+    // synchronous block so no live event can slip in between them.
+    async #dispatch(command) {
+        const { reqId } = command;
+        switch (command.type) {
+            case "host.info":
+                return this.#ok(reqId, command.type, await this.#hostInfo());
+            case "session.list":
+                return this.#ok(reqId, command.type, { sessions: this.#manager.list() });
+            case "session.create": {
+                const session = await this.#manager.create(command.payload);
+                if (session instanceof TerminalSession) {
+                    const attachment = this.#subscribeTerminal(session, command.payload.clientId);
+                    this.#ok(reqId, command.type, { session: session.info });
+                    return attachment.catchUp();
+                }
+                const { replay } = this.#subscribeAgent(session, 0);
+                this.#ok(reqId, command.type, { session: session.info });
+                return replay.forEach(this.#send);
+            }
+            case "session.attach": {
+                const session = this.#manager.get(command.payload.sessionId);
+                if (session instanceof TerminalSession) {
+                    const attachment = this.#subscribeTerminal(session, command.payload.clientId);
+                    this.#ok(reqId, command.type, { session: session.info, gap: false, oldestSeq: 0, replayed: 0 });
+                    return attachment.catchUp();
+                }
+                const { replay, gap, oldestSeq } = this.#subscribeAgent(session, command.payload.afterSeq ?? 0);
+                this.#ok(reqId, command.type, { session: session.info, gap, oldestSeq, replayed: replay.length });
+                return replay.forEach(this.#send);
+            }
+            case "session.detach":
+                this.#detach(command.payload.sessionId);
+                return this.#ok(reqId, command.type, {});
+            case "session.send":
+                await this.#manager.agent(command.payload.sessionId).send(command.payload.input);
+                return this.#ok(reqId, command.type, {});
+            case "session.interrupt":
+                await this.#manager.agent(command.payload.sessionId).interrupt();
+                return this.#ok(reqId, command.type, {});
+            case "session.close":
+                await this.#manager.close(command.payload.sessionId, "closed by client");
+                return this.#ok(reqId, command.type, {});
+            case "session.configure": {
+                const { sessionId, ...settings } = command.payload;
+                const session = this.#manager.agent(sessionId);
+                session.configure(settings);
+                return this.#ok(reqId, command.type, { session: session.info });
+            }
+            case "input.respond": {
+                const { sessionId, requestId, decisionId, answers } = command.payload;
+                this.#manager.agent(sessionId).respond(requestId, decisionId, answers);
+                return this.#ok(reqId, command.type, {});
+            }
+            case "terminal.resize": {
+                const session = this.#manager.terminal(command.payload.sessionId);
+                session.resize(command.payload.cols, command.payload.rows);
+                return this.#ok(reqId, command.type, { session: session.info });
+            }
+            case "terminal.ack":
+                this.#manager.terminal(command.payload.sessionId).ack(command.payload.clientId, command.payload.bytes);
+                return this.#ok(reqId, command.type, {});
+            case "terminal.kill":
+                this.#manager.terminal(command.payload.sessionId).kill();
+                return this.#ok(reqId, command.type, {});
+        }
+    }
+    #subscribeAgent(session, afterSeq) {
+        this.#detach(session.id);
+        const attachment = session.attach(this.#send, afterSeq);
+        this.#attachments.set(session.id, attachment.detach);
+        return attachment;
+    }
+    #subscribeTerminal(session, clientId) {
+        this.#detach(session.id);
+        const attachment = session.attach({ event: this.#send, bytes: this.#sendBinary }, clientId);
+        this.#attachments.set(session.id, attachment.detach);
+        return attachment;
+    }
+    #detach(sessionId) {
+        this.#attachments.get(sessionId)?.();
+        this.#attachments.delete(sessionId);
+    }
+    #ok(reqId, _type, result) {
+        this.#send({ v: PROTOCOL_VERSION, kind: "res", reqId, ok: true, result });
+    }
+    #fail(reqId, code, message) {
+        this.#send({ v: PROTOCOL_VERSION, kind: "res", reqId, ok: false, error: { code, message } });
+    }
+}
+function reqIdOf(data) {
+    if (typeof data === "object" && data !== null && "reqId" in data && typeof data.reqId === "string") {
+        return data.reqId.slice(0, 64);
+    }
+    return "";
+}
+//# sourceMappingURL=connection.js.map

package/dist/server/connection.js.map

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

package/dist/server/local-server.d.ts

@@ -0,0 +1,27 @@
+import { type HostInfo } from "@termlink/protocol";
+import { type RawData } from "ws";
+import type { SessionManager } from "../session/manager.js";
+export interface LocalServerOptions {
+    manager: SessionManager;
+    hostInfo: () => Promise<HostInfo>;
+    token: string;
+    host?: string;
+    /** 0 picks a free port. */
+    port?: number;
+    /** A client that falls this far behind is disconnected rather than buffered without bound. */
+    maxBufferedBytes?: number;
+}
+export interface LocalServer {
+    url: string;
+    port: number;
+    close(): Promise<void>;
+}
+/**
+ * Direct WebSocket endpoint for development and for clients on the same machine.
+ * Clients authenticate with ?token=. There is no TLS, so keep it on loopback.
+ * Accepts chunked messages like the relay transport, so one client works with both.
+ */
+export declare function startLocalServer(options: LocalServerOptions): Promise<LocalServer>;
+/** ws hands binary messages over as a Buffer, an array of them, or an ArrayBuffer. */
+export declare function toBytes(data: RawData): Uint8Array;
+//# sourceMappingURL=local-server.d.ts.map

package/dist/server/local-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-server.d.ts","sourceRoot":"","sources":["../../src/server/local-server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiFxF;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAIjD"}

package/dist/server/local-server.js

@@ -0,0 +1,108 @@
+import { timingSafeEqual } from "node:crypto";
+import { createServer } from "node:http";
+import { FrameAssembler } from "@termlink/protocol";
+import { WebSocketServer } from "ws";
+import { ClientConnection } from "./connection.js";
+/**
+ * Direct WebSocket endpoint for development and for clients on the same machine.
+ * Clients authenticate with ?token=. There is no TLS, so keep it on loopback.
+ * Accepts chunked messages like the relay transport, so one client works with both.
+ */
+export async function startLocalServer(options) {
+    const host = options.host ?? "127.0.0.1";
+    const maxBufferedBytes = options.maxBufferedBytes ?? 8 * 1024 * 1024;
+    const http = createServer((req, res) => {
+        if (req.url === "/healthz") {
+            res.writeHead(200, { "content-type": "text/plain" }).end("ok");
+            return;
+        }
+        res.writeHead(404).end();
+    });
+    const wss = new WebSocketServer({ noServer: true, maxPayload: 1024 * 1024 });
+    http.on("upgrade", (req, socket, head) => {
+        const url = new URL(req.url ?? "/", "http://localhost");
+        if (url.pathname !== "/ws" || !tokenMatches(url.searchParams.get("token"), options.token)) {
+            socket.end("HTTP/1.1 401 Unauthorized\r\nConnection: close\r\nContent-Length: 0\r\n\r\n");
+            return;
+        }
+        wss.handleUpgrade(req, socket, head, (ws) => {
+            const guard = () => {
+                if (ws.readyState !== ws.OPEN)
+                    return false;
+                if (ws.bufferedAmount > maxBufferedBytes) {
+                    ws.close(1013, "client is not keeping up");
+                    return false;
+                }
+                return true;
+            };
+            const connection = new ClientConnection(options.manager, {
+                send: (message) => {
+                    if (guard())
+                        ws.send(JSON.stringify(message));
+                },
+                sendBinary: (frame) => {
+                    if (guard())
+                        ws.send(frame, { binary: true });
+                },
+            }, options.hostInfo);
+            const assembler = new FrameAssembler();
+            ws.on("message", (data, isBinary) => {
+                if (isBinary) {
+                    connection.handleBinary(toBytes(data));
+                    return;
+                }
+                const text = data.toString();
+                let message;
+                try {
+                    message = assembler.push(text);
+                }
+                catch (err) {
+                    // Not JSON: let the connection answer bad_request. Too large: drop the client.
+                    if (err instanceof SyntaxError)
+                        void connection.handle(text);
+                    else
+                        ws.close(1009, "message too large");
+                    return;
+                }
+                if (message !== undefined)
+                    void connection.handleMessage(message);
+            });
+            ws.on("close", () => connection.dispose());
+            void connection.open();
+        });
+    });
+    await new Promise((resolve, reject) => {
+        http.once("error", reject);
+        http.listen(options.port ?? 7420, host, () => {
+            http.off("error", reject);
+            resolve();
+        });
+    });
+    const { port } = http.address();
+    return {
+        url: `ws://${host}:${port}/ws`,
+        port,
+        close: async () => {
+            for (const client of wss.clients)
+                client.terminate();
+            wss.close();
+            await new Promise((resolve) => http.close(() => resolve()));
+        },
+    };
+}
+/** ws hands binary messages over as a Buffer, an array of them, or an ArrayBuffer. */
+export function toBytes(data) {
+    if (Array.isArray(data))
+        return Buffer.concat(data);
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    return data;
+}
+function tokenMatches(given, expected) {
+    if (given === null)
+        return false;
+    const a = Buffer.from(given);
+    const b = Buffer.from(expected);
+    return a.length === b.length && timingSafeEqual(a, b);
+}
+//# sourceMappingURL=local-server.js.map

package/dist/server/local-server.js.map

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

package/dist/session/event-log.d.ts

@@ -0,0 +1,17 @@
+import type { AgentEvent } from "@termlink/protocol";
+export interface LogSlice {
+    events: AgentEvent[];
+    /** True when events after the requested seq have already been evicted. */
+    gap: boolean;
+    /** Seq of the oldest event still held, or 0 when the log is empty. */
+    oldestSeq: number;
+}
+/** Bounded buffer of one session's durable events, used to replay after a reconnect. */
+export declare class EventLog {
+    #private;
+    readonly capacity: number;
+    constructor(capacity?: number);
+    append(event: AgentEvent): void;
+    since(afterSeq: number): LogSlice;
+}
+//# sourceMappingURL=event-log.d.ts.map

package/dist/session/event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../src/session/event-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,0EAA0E;IAC1E,GAAG,EAAE,OAAO,CAAC;IACb,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wFAAwF;AACxF,qBAAa,QAAQ;;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B,YAAY,QAAQ,SAAO,EAE1B;IAED,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAI9B;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAIhC;CACF"}

package/dist/session/event-log.js

@@ -0,0 +1,21 @@
+/** Bounded buffer of one session's durable events, used to replay after a reconnect. */
+export class EventLog {
+    capacity;
+    #events = [];
+    constructor(capacity = 2000) {
+        this.capacity = capacity;
+    }
+    append(event) {
+        if (event.seq === undefined)
+            throw new Error(`event ${event.type} has no seq`);
+        this.#events.push(event);
+        if (this.#events.length > this.capacity)
+            this.#events.shift();
+    }
+    since(afterSeq) {
+        const oldestSeq = this.#events[0]?.seq ?? 0;
+        const events = this.#events.filter((e) => (e.seq ?? 0) > afterSeq);
+        return { events, gap: oldestSeq > 0 && afterSeq < oldestSeq - 1, oldestSeq };
+    }
+}
+//# sourceMappingURL=event-log.js.map

package/dist/session/event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.js","sourceRoot":"","sources":["../../src/session/event-log.ts"],"names":[],"mappings":"AAUA,wFAAwF;AACxF,MAAM,OAAO,QAAQ;IACV,QAAQ,CAAS;IAC1B,OAAO,GAAiB,EAAE,CAAC;IAE3B,YAAY,QAAQ,GAAG,IAAI;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,KAAiB;QACtB,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,aAAa,CAAC,CAAC;QAC/E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,QAAgB;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;QACnE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,CAAC,IAAI,QAAQ,GAAG,SAAS,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC;IAC/E,CAAC;CACF"}

package/dist/session/manager.d.ts

@@ -0,0 +1,62 @@
+import type { AutoApprove, ProviderId, ProviderStatus, SessionInfo } from "@termlink/protocol";
+import type { HostProvider } from "../providers/types.js";
+import { AgentSession, type Listener } from "./session.js";
+import type { SessionStore } from "./store.js";
+import { TerminalSession, type FlowControlOptions } from "./terminal-session.js";
+export type HostSession = AgentSession | TerminalSession;
+export interface CreateSessionOptions {
+    provider: ProviderId;
+    cwd: string;
+    title?: string | undefined;
+    /** Agent sessions. */
+    autoApprove?: AutoApprove | undefined;
+    /** Terminal sessions. */
+    cols?: number | undefined;
+    rows?: number | undefined;
+}
+export interface SessionManagerOptions {
+    providers: HostProvider[];
+    logCapacity?: number;
+    /** Folders sessions may be opened in. Unset means any folder. */
+    allowedRoots?: string[];
+    /** Remembers resumable agent sessions across host restarts. */
+    store?: SessionStore;
+    /** autoApprove for new agent sessions that do not ask for one. Defaults to off. */
+    autoApprove?: AutoApprove;
+    /** Flow control for terminal sessions. */
+    flow?: FlowControlOptions;
+}
+/** Owns all sessions on this host and fans host-channel events out to every connection. */
+export declare class SessionManager {
+    #private;
+    constructor(options: SessionManagerOptions);
+    /** Folders sessions may be opened in, or undefined when unrestricted. */
+    get roots(): string[] | undefined;
+    onHostEvent(listener: Listener): () => void;
+    providerStatuses(): Promise<ProviderStatus[]>;
+    list(): SessionInfo[];
+    get(sessionId: string): HostSession;
+    /** The session, if it is an agent session; commands for turns and approvals need one. */
+    agent(sessionId: string): AgentSession;
+    terminal(sessionId: string): TerminalSession;
+    create(options: CreateSessionOptions): Promise<HostSession>;
+    /** create() for callers that need an agent session, such as tests. */
+    createAgent(options: CreateSessionOptions): Promise<AgentSession>;
+    /** create() for callers that need a terminal session. */
+    createTerminal(options: CreateSessionOptions): Promise<TerminalSession>;
+    /**
+     * Brings back the agent sessions the store remembers, with their recent history read
+     * from each provider's transcript. Providers resume on first use. Returns how many came back.
+     * Terminal sessions are never remembered: their shell died with the previous host.
+     */
+    restore(): Promise<number>;
+    /** Closed by a client: the session is forgotten and will not come back after a restart. */
+    close(sessionId: string, reason?: string | null): Promise<void>;
+    closeAll(reason?: string | null): Promise<void>;
+    /**
+     * Stops the host: saves resumable sessions, closes everything, then releases provider
+     * resources such as the Codex app-server. Unlike close(), agent sessions stay remembered.
+     */
+    shutdown(reason?: string | null): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/session/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE3G,OAAO,KAAK,EAAE,YAAY,EAAqC,MAAM,uBAAuB,CAAC;AAE7F,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,eAAe,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,UAAU,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,sBAAsB;IACtB,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,mFAAmF;IACnF,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAMD,2FAA2F;AAC3F,qBAAa,cAAc;;IAYzB,YAAY,OAAO,EAAE,qBAAqB,EAOzC;IAED,yEAAyE;IACzE,IAAI,KAAK,IAAI,MAAM,EAAE,GAAG,SAAS,CAEhC;IAED,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAG1C;IAEK,gBAAgB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAWlD;IAED,IAAI,IAAI,WAAW,EAAE,CAEpB;IAED,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAIlC;IAED,yFAAyF;IACzF,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAIrC;IAED,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAI3C;IAEK,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAOhE;IAED,sEAAsE;IAChE,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAOtE;IAED,yDAAyD;IACnD,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAO5E;IAiED;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CA0C/B;IAED,2FAA2F;IACrF,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1E;IAEK,QAAQ,CAAC,MAAM,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;IAED;;;OAGG;IACG,QAAQ,CAAC,MAAM,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ1D;CAqDF"}