@grackle-ai/powerline 0.170.0 → 0.171.0

package/dist/handlers/session-handlers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AHP session lifecycle handlers: create, dispose, list, initialize.
+ * @module handlers/session-handlers
+ */
+import type { AhpResponse, CreateSessionParams, DisposeSessionParams, InitializeParams, InitializeResult, ListSessionsParams, ListSessionsResult } from "@grackle-ai/ahp";
+import type { AhpServerConnection } from "@grackle-ai/ahp-transport";
+import type { ClientState } from "../ahp-types.js";
+/** Return the canned AHP initialize handshake result. */
+export declare function handleInitialize(_params: InitializeParams): InitializeResult;
+/** Parse `createSession` params and spawn or resume the runtime session. */
+export declare function handleCreateSession(params: CreateSessionParams, conn: AhpServerConnection, cState: ClientState, clients: Map<string, ClientState>): AhpResponse | undefined;
+/** Kill a session and remove it from the registry. */
+export declare function handleDisposeSession(params: DisposeSessionParams, conn: AhpServerConnection, clients: Map<string, ClientState>): AhpResponse;
+/** Map the in-memory session registry to an AHP session list. */
+export declare function handleListSessions(_params: ListSessionsParams): ListSessionsResult;
+//# sourceMappingURL=session-handlers.d.ts.map

package/dist/handlers/session-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/session-handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAInB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAKrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAqCnD,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAM5E;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAChC,WAAW,GAAG,SAAS,CAkJzB;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAChC,WAAW,CA4Cb;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAalF"}

package/dist/handlers/session-handlers.js

@@ -0,0 +1,262 @@
+/**
+ * AHP session lifecycle handlers: create, dispose, list, initialize.
+ * @module handlers/session-handlers
+ */
+import { ActionType, JsonRpcErrorCodes, SessionStatus } from "@grackle-ai/ahp";
+import { validateGitBranchName, worktreeDir } from "@grackle-ai/runtime-sdk";
+import { resolve as resolvePath } from "node:path";
+import { PROTOCOL_VERSION, SESSION_CHANNEL_PREFIX, sessionChannel, sessionIdFromChannel, } from "../channel-codec.js";
+import { getRuntime } from "../runtime-registry.js";
+import { deleteSessionPump, getSession, listAllSessions, removeSession, startSessionPump, } from "../session-mgr.js";
+/**
+ * Record the filesystem roots a newly-created session exposes for resource
+ * read/list/watch.
+ */
+function addSessionRoots(cState, cfg) {
+    const wd = typeof cfg.workingDirectory === "string" && cfg.workingDirectory !== ""
+        ? cfg.workingDirectory
+        : undefined;
+    if (wd === undefined) {
+        return;
+    }
+    const root = resolvePath(wd);
+    cState.allowedRoots.add(root);
+    const branch = typeof cfg.branch === "string" && cfg.branch !== "" ? cfg.branch : undefined;
+    const useWorktrees = cfg.useWorktrees !== false;
+    if (useWorktrees && branch !== undefined) {
+        cState.allowedRoots.add(worktreeDir(root, branch));
+    }
+}
+/** Return the canned AHP initialize handshake result. */
+export function handleInitialize(_params) {
+    return {
+        protocolVersion: PROTOCOL_VERSION,
+        serverSeq: 0,
+        snapshots: [],
+    };
+}
+/** Parse `createSession` params and spawn or resume the runtime session. */
+export function handleCreateSession(params, conn, cState, clients) {
+    const sessionId = sessionIdFromChannel(params.channel);
+    if (sessionId === undefined) {
+        return {
+            jsonrpc: "2.0",
+            id: 0,
+            error: {
+                code: JsonRpcErrorCodes.InvalidParams,
+                message: `createSession: channel must be ${SESSION_CHANNEL_PREFIX}<sessionId>`,
+            },
+        };
+    }
+    const runtimeName = params.provider;
+    if (runtimeName === undefined) {
+        return {
+            jsonrpc: "2.0",
+            id: 0,
+            error: {
+                code: JsonRpcErrorCodes.InvalidParams,
+                message: "createSession: `provider` is required",
+            },
+        };
+    }
+    const runtime = getRuntime(runtimeName);
+    if (runtime === undefined) {
+        return {
+            jsonrpc: "2.0",
+            id: 0,
+            error: {
+                code: JsonRpcErrorCodes.InvalidParams,
+                message: `Unknown runtime: ${runtimeName}`,
+            },
+        };
+    }
+    const existing = getSession(sessionId);
+    if (existing !== undefined) {
+        return {
+            jsonrpc: "2.0",
+            id: 0,
+            error: {
+                code: JsonRpcErrorCodes.InvalidRequest,
+                message: `Session already active: ${sessionId}`,
+            },
+        };
+    }
+    const config = params.config ?? {};
+    const cfg = config;
+    const resumeId = typeof cfg.resumeFromRuntimeSessionId === "string" ? cfg.resumeFromRuntimeSessionId : undefined;
+    let session;
+    try {
+        if (resumeId !== undefined) {
+            session = runtime.resume({
+                sessionId,
+                runtimeSessionId: resumeId,
+            });
+        }
+        else {
+            const prompt = typeof cfg.prompt === "string" ? cfg.prompt : "";
+            const model = typeof cfg.model === "string" ? cfg.model : "";
+            const maxTurns = typeof cfg.maxTurns === "number" ? cfg.maxTurns : 0;
+            const branchVal = typeof cfg.branch === "string" && cfg.branch !== "" ? cfg.branch : undefined;
+            if (branchVal !== undefined) {
+                try {
+                    validateGitBranchName(branchVal);
+                }
+                catch (err) {
+                    return {
+                        jsonrpc: "2.0",
+                        id: 0,
+                        error: {
+                            code: JsonRpcErrorCodes.InvalidParams,
+                            message: err instanceof Error ? err.message : "Invalid branch name",
+                        },
+                    };
+                }
+            }
+            const wdVal = typeof cfg.workingDirectory === "string" && cfg.workingDirectory !== ""
+                ? cfg.workingDirectory
+                : undefined;
+            const useWorktrees = typeof cfg.useWorktrees === "boolean" ? cfg.useWorktrees : undefined;
+            const systemContext = typeof cfg.systemContext === "string" && cfg.systemContext !== ""
+                ? cfg.systemContext
+                : undefined;
+            const workspaceId = typeof cfg.workspaceId === "string" && cfg.workspaceId !== "" ? cfg.workspaceId : undefined;
+            const taskId = typeof cfg.taskId === "string" ? cfg.taskId : undefined;
+            const mcpServersJson = typeof cfg.mcpServersJson === "string" ? cfg.mcpServersJson : "";
+            const mcpUrl = typeof cfg.mcpUrl === "string" ? cfg.mcpUrl : "";
+            const mcpToken = typeof cfg.mcpToken === "string" ? cfg.mcpToken : "";
+            const scriptContent = typeof cfg.scriptContent === "string" && cfg.scriptContent !== ""
+                ? cfg.scriptContent
+                : undefined;
+            const pipe = typeof cfg.pipe === "string" && cfg.pipe !== ""
+                ? cfg.pipe
+                : undefined;
+            session = runtime.spawn({
+                sessionId,
+                prompt,
+                model,
+                maxTurns,
+                ...(branchVal !== undefined ? { branch: branchVal } : {}),
+                ...(wdVal !== undefined ? { workingDirectory: wdVal } : {}),
+                ...(useWorktrees !== undefined ? { useWorktrees } : {}),
+                ...(systemContext !== undefined ? { systemContext } : {}),
+                ...(workspaceId !== undefined ? { workspaceId } : {}),
+                ...(taskId !== undefined ? { taskId } : {}),
+                mcpServers: mcpServersJson
+                    ? JSON.parse(mcpServersJson)
+                    : undefined,
+                ...(mcpUrl && mcpToken ? { mcpBroker: { url: mcpUrl, token: mcpToken } } : {}),
+                ...(scriptContent !== undefined ? { scriptContent } : {}),
+                ...(pipe !== undefined ? { pipe } : {}),
+            });
+        }
+    }
+    catch (err) {
+        return {
+            jsonrpc: "2.0",
+            id: 0,
+            error: {
+                code: JsonRpcErrorCodes.InternalError,
+                message: err instanceof Error ? err.message : String(err),
+            },
+        };
+    }
+    const ownerClientId = conn.clientId;
+    startSessionPump(session, (deadSessionId) => {
+        const owner = clients.get(ownerClientId);
+        owner?.sessionIds.delete(deadSessionId);
+    });
+    cState.sessionIds.add(sessionId);
+    addSessionRoots(cState, cfg);
+    return {
+        jsonrpc: "2.0",
+        id: 0,
+        result: null,
+    };
+}
+/** Kill a session and remove it from the registry. */
+export function handleDisposeSession(params, conn, clients) {
+    const sessionId = sessionIdFromChannel(params.channel);
+    if (sessionId === undefined) {
+        return {
+            jsonrpc: "2.0",
+            id: 0,
+            error: {
+                code: JsonRpcErrorCodes.InvalidParams,
+                message: "disposeSession: channel must be ahp-session:/<id>",
+            },
+        };
+    }
+    const session = getSession(sessionId);
+    if (session !== undefined) {
+        session.kill("killed");
+        removeSession(sessionId);
+        deleteSessionPump(sessionId);
+    }
+    const cState = clients.get(conn.clientId);
+    if (cState !== undefined) {
+        cState.sessionIds.delete(sessionId);
+        const fwd = cState.forwarders.get(sessionId);
+        if (fwd !== undefined) {
+            fwd.serverSeq += 1;
+            const killedAction = {
+                type: ActionType.SessionMetaChanged,
+                _meta: { status: "killed" },
+            };
+            conn.session.notify("action", {
+                channel: sessionChannel(sessionId),
+                serverSeq: fwd.serverSeq,
+                action: killedAction,
+                origin: undefined,
+            });
+            fwd.cancelled = true;
+            fwd.wake?.();
+            cState.forwarders.delete(sessionId);
+        }
+    }
+    return {
+        jsonrpc: "2.0",
+        id: 0,
+        result: null,
+    };
+}
+/** Map the in-memory session registry to an AHP session list. */
+export function handleListSessions(_params) {
+    const items = listAllSessions().map((s) => {
+        const now = Date.now();
+        return {
+            resource: sessionChannel(s.id),
+            provider: s.runtimeName,
+            title: s.id,
+            status: mapAgentStatusToAhp(s.status),
+            createdAt: now,
+            modifiedAt: now,
+        };
+    });
+    return { items };
+}
+/** Map PowerLine's loose status string to AHP's bitset enum. */
+function mapAgentStatusToAhp(status) {
+    switch (status) {
+        case "pending":
+            return SessionStatus.InProgress;
+        case "running":
+            return SessionStatus.InProgress;
+        case "idle":
+            return SessionStatus.InputNeeded;
+        case "stopped":
+            return SessionStatus.Idle;
+        case "suspended":
+            return SessionStatus.Idle;
+        case "waiting_input":
+            return SessionStatus.InputNeeded;
+        case "completed":
+            return SessionStatus.Idle;
+        case "failed":
+        case "killed":
+        case "terminated":
+            return SessionStatus.Error;
+        default:
+            return SessionStatus.Idle;
+    }
+}
+//# sourceMappingURL=session-handlers.js.map

package/dist/handlers/session-handlers.js.map

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

package/dist/handlers/subscribe-handlers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AHP subscribe/unsubscribe handlers: session and resource-watch subscriptions.
+ * @module handlers/subscribe-handlers
+ */
+import type { AhpResponse, SubscribeParams } from "@grackle-ai/ahp";
+import type { AhpServerConnection } from "@grackle-ai/ahp-transport";
+import type { ClientState } from "../ahp-types.js";
+/** Route a subscribe request to either resource-watch or session forwarding. */
+export declare function handleSubscribe(params: SubscribeParams, conn: AhpServerConnection, cState: ClientState, clients: Map<string, ClientState>): AhpResponse;
+//# sourceMappingURL=subscribe-handlers.d.ts.map

package/dist/handlers/subscribe-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/subscribe-handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAmB,MAAM,iBAAiB,CAAC;AAErF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,iBAAiB,CAAC;AAMnE,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAChC,WAAW,CAqBb"}

package/dist/handlers/subscribe-handlers.js

@@ -0,0 +1,82 @@
+/**
+ * AHP subscribe/unsubscribe handlers: session and resource-watch subscriptions.
+ * @module handlers/subscribe-handlers
+ */
+import { JsonRpcErrorCodes } from "@grackle-ai/ahp";
+import { RESOURCE_WATCH_CHANNEL_PREFIX, sessionIdFromChannel } from "../channel-codec.js";
+import { runForwarder } from "../forwarder.js";
+import { startResourceWatch } from "../resource-watch.js";
+import { getSession, isParked } from "../session-mgr.js";
+/** Route a subscribe request to either resource-watch or session forwarding. */
+export function handleSubscribe(params, conn, cState, clients) {
+    if (params.channel.startsWith(RESOURCE_WATCH_CHANNEL_PREFIX)) {
+        const entry = cState.watches.get(params.channel);
+        if (entry === undefined) {
+            return {
+                jsonrpc: "2.0",
+                id: 0,
+                error: {
+                    code: JsonRpcErrorCodes.InvalidParams,
+                    message: `Unknown resource-watch channel: ${params.channel}`,
+                },
+            };
+        }
+        startResourceWatch(conn, params.channel, entry);
+        return {
+            jsonrpc: "2.0",
+            id: 0,
+            result: { snapshot: undefined },
+        };
+    }
+    return handleSessionSubscribe(params, conn, cState, clients);
+}
+/** Set up the per-(session, client) forwarder for a session-channel subscribe. */
+function handleSessionSubscribe(params, conn, cState, clients) {
+    const sessionId = sessionIdFromChannel(params.channel);
+    if (sessionId === undefined) {
+        return {
+            jsonrpc: "2.0",
+            id: 0,
+            result: { snapshot: undefined },
+        };
+    }
+    const session = getSession(sessionId);
+    if (session === undefined && !isParked(sessionId)) {
+        return {
+            jsonrpc: "2.0",
+            id: 0,
+            error: {
+                code: JsonRpcErrorCodes.InvalidParams,
+                message: `Unknown session channel: ${params.channel}`,
+            },
+        };
+    }
+    const prior = cState.forwarders.get(sessionId);
+    if (prior !== undefined) {
+        prior.cancelled = true;
+        prior.wake?.();
+    }
+    const forwarder = {
+        mapperContext: {
+            turnId: undefined,
+            openToolCalls: [],
+            partCounter: 0,
+            eventIndex: 0,
+            metaAccumulator: {},
+        },
+        serverSeq: 0,
+        cancelled: false,
+        lastMetaSnapshot: undefined,
+        pos: 0,
+    };
+    cState.forwarders.set(sessionId, forwarder);
+    queueMicrotask(() => {
+        runForwarder(conn, sessionId, forwarder, clients).catch(() => { });
+    });
+    return {
+        jsonrpc: "2.0",
+        id: 0,
+        result: { snapshot: undefined },
+    };
+}
+//# sourceMappingURL=subscribe-handlers.js.map

package/dist/handlers/subscribe-handlers.js.map

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

package/dist/index.js

@@ -4,14 +4,10 @@ import { mountAhpServer } from "./ahp-handlers.js";
 import { registerRuntime } from "./runtime-registry.js";
 import { StubRuntime } from "./runtimes/stub.js";
 import { StubMcpRuntime } from "./runtimes/stub-mcp.js";
-import { GenAIScriptRuntime } from "@grackle-ai/runtime-genaiscript";
-import { ClaudeCodeRuntime } from "@grackle-ai/runtime-claude-code";
-import { CopilotRuntime } from "@grackle-ai/runtime-copilot";
-import { CodexRuntime } from "@grackle-ai/runtime-codex";
-import { AcpRuntime } from "@grackle-ai/runtime-acp";
 import { DEFAULT_POWERLINE_PORT } from "@grackle-ai/common";
 import { createRequire } from "node:module";
 import { logger } from "./logger.js";
+import { loadRuntimesFromCatalog } from "./runtime-loader.js";
 const esmRequire = createRequire(import.meta.url);
 const { version } = esmRequire("../package.json");
 // The PowerLine is an independent service, not a nested Claude Code session.
@@ -19,7 +15,7 @@ const { version } = esmRequire("../package.json");
 // refuse to start when the PowerLine happens to be launched from within
 // a Claude Code session (e.g. during development or local testing).
 delete process.env.CLAUDECODE;
-function main() {
+async function main() {
     const program = new Command();
     program
         .name("grackle-powerline")
@@ -29,7 +25,7 @@ function main() {
         .option("--token <token>", "Authentication token")
         .option("--no-auth", "Run without authentication (development only)")
         .option("--host <host>", "Host to bind to", "127.0.0.1")
-        .action((opts) => {
+        .action(async (opts) => {
         const port = parseInt(opts.port, 10);
         const host = opts.host;
         const powerlineToken = opts.auth
@@ -40,24 +36,11 @@ function main() {
             process.exitCode = 1;
             return;
         }
-        // Register runtimes
+        // Register stubs (PowerLine-internal test runtimes, no catalog factory).
         registerRuntime(new StubRuntime());
         registerRuntime(new StubMcpRuntime());
-        registerRuntime(new GenAIScriptRuntime());
-        registerRuntime(new ClaudeCodeRuntime());
-        registerRuntime(new CopilotRuntime());
-        registerRuntime(new CodexRuntime());
-        registerRuntime(new AcpRuntime({ name: "goose", command: "goose", args: ["acp"] }));
-        registerRuntime(new AcpRuntime({ name: "codex-acp", command: "codex-acp", args: [] }));
-        registerRuntime(new AcpRuntime({ name: "copilot-acp", command: "copilot", args: ["--acp", "--stdio"] }));
-        registerRuntime(new AcpRuntime({
-            name: "claude-code-acp",
-            command: "claude-agent-acp",
-            args: [],
-            // Isolate from ~/.claude so interactive-only settings (e.g.
-            // permissions.defaultMode "auto") don't crash session/new (#1366).
-            isolateClaudeConfig: true,
-        }));
+        // Register production runtimes from the catalog.
+        await loadRuntimesFromCatalog();
         // HR8d: PowerLine speaks AHP JSON-RPC over WebSocket (not gRPC).
         // AhpServerSocket handles the HTTP upgrade and Bearer-token auth.
         const server = http.createServer((req, res) => {
@@ -108,7 +91,10 @@ function main() {
         process.on("SIGINT", shutdown);
         process.on("SIGTERM", shutdown);
     });
-    program.parse();
+    await program.parseAsync();
 }
-main();
+main().catch((err) => {
+    logger.fatal({ err }, "PowerLine failed to start");
+    process.exitCode = 1;
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/resource-watch.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Filesystem resource watch lifecycle: create, start, stop, flush.
+ * @module resource-watch
+ */
+import type { CreateResourceWatchParams, CreateResourceWatchResult } from "@grackle-ai/ahp";
+import type { AhpServerConnection } from "@grackle-ai/ahp-transport";
+import type { ClientState, ResourceWatchEntry } from "./ahp-types.js";
+/**
+ * Allocate a resource-watch channel for a sandbox-validated URI. The watcher
+ * itself is started lazily when the client subscribes to the returned channel
+ * ({@link startResourceWatch}).
+ *
+ * @throws ResourceError — `InvalidParams`/`PermissionDenied` (sandbox) or
+ * `NotFound` if the watch target does not exist.
+ */
+export declare function createResourceWatchEntry(params: CreateResourceWatchParams, cState: ClientState): Promise<CreateResourceWatchResult>;
+/**
+ * Flush the coalesced change batch for a watch as a single
+ * `resourceWatch/changed` action. Never dispatches an empty batch (per spec).
+ */
+export declare function flushResourceWatch(conn: AhpServerConnection, channel: string, entry: ResourceWatchEntry): void;
+/**
+ * Start the chokidar watcher for a previously-created watch entry and wire its
+ * events into coalesced `resourceWatch/changed` notifications. Idempotent: a
+ * second subscribe to the same channel is a no-op.
+ */
+export declare function startResourceWatch(conn: AhpServerConnection, channel: string, entry: ResourceWatchEntry): void;
+/** Release a watch's filesystem resources (watcher + pending flush timer). */
+export declare function stopResourceWatch(entry: ResourceWatchEntry): void;
+//# sourceMappingURL=resource-watch.d.ts.map

package/dist/resource-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-watch.d.ts","sourceRoot":"","sources":["../src/resource-watch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EAG1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAQrE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AA8BtE;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,yBAAyB,EACjC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,yBAAyB,CAAC,CAsBpC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,kBAAkB,GACxB,IAAI,CAiBN;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,kBAAkB,GACxB,IAAI,CAsEN;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAejE"}