@autonome-research/thread-phase-agents 3.0.0

package/dist/acp/adapter.js

@@ -0,0 +1,461 @@
+/**
+ * ACP chassis — `AgentAdapter` that consumes any ACP-speaking subprocess.
+ *
+ * Lifecycle: spawn → initialize → session/new (or session/load on resume)
+ * → session/prompt → stream session/update notifications → await
+ * stopReason → emit agent_end → dispose.
+ *
+ * Translation table:
+ *   session/update { sessionUpdate: 'agent_message_chunk' }   → text event
+ *   session/update { sessionUpdate: 'agent_thought_chunk' }   → thinking event
+ *   session/update { sessionUpdate: 'tool_call' }             → tool_call event
+ *   session/update { sessionUpdate: 'tool_call_update', status: 'completed' }
+ *                                                              → tool_result event
+ *   everything else                                            → native event
+ *
+ * Cancellation: forceful. abort() sends session/cancel as a notification,
+ * then SIGTERM after a short grace window, then SIGKILL. Subprocess
+ * cleanup is unconditional on result resolution.
+ *
+ * Resumption: 'opaque' — the ACP session id is wrapped in a
+ * `ResumeToken{ kind: 'opaque', data: sessionId }` and emitted on
+ * agent_start (when input resume) and agent_end (always).
+ *
+ * @internal
+ */
+import { spawn } from 'node:child_process';
+import { composeAbort, createEventQueue, defineAgentAdapter, lazyEvents, serializeError, TurnAccumulator, } from '@autonome-research/thread-phase/agents';
+import { ACP_METHODS, ACP_PROTOCOL_VERSION, contentBlockToText, } from './types.js';
+import { createAcpTransport, JsonRpcCallError } from './transport.js';
+/**
+ * Build an ACP-speaking adapter with the given id. The chassis itself
+ * is exported as `acpAgent` (id 'acp'); wrappers like `hermesAgent` and
+ * `openClawAgent` are produced by calling this with their own id.
+ *
+ * @internal
+ */
+export function createAcpAdapter(opts = {}) {
+    const id = opts.id ?? 'acp';
+    return defineAgentAdapter({
+        id,
+        capabilities: {
+            streaming: 'text',
+            cancellation: 'forceful',
+            resumption: 'opaque',
+            structuredOutput: 'prompted',
+        },
+        adapter: (config, options) => makeAcpRun(id, config, options ?? {}),
+    });
+}
+/** The unparameterized chassis adapter. @internal */
+export const acpAgent = createAcpAdapter({ id: 'acp' });
+// ---------------------------------------------------------------------------
+// run construction
+// ---------------------------------------------------------------------------
+function makeAcpRun(source, config, options) {
+    const traceId = options.traceId;
+    const cancelGraceMs = config.cancelGraceMs ?? 2000;
+    const killGraceMs = config.killGraceMs ?? 3000;
+    const { signal: compositeSignal, controller } = composeAbort(options.signal);
+    const queue = createEventQueue(options.eventBus);
+    const pushEvent = queue.push;
+    const closeStream = queue.close;
+    const turns = new TurnAccumulator(pushEvent, source, traceId);
+    // Follow-up queue: messages to send as additional session/prompt requests
+    // after the current prompt completes. Synchronously drained between turns
+    // (the loop checks for new messages each iteration; no callback timing).
+    const followUpQueue = [];
+    let hasEnded = false;
+    // Lazy start.
+    let started = false;
+    let runPromise = null;
+    const startIfNeeded = () => {
+        if (runPromise)
+            return runPromise;
+        started = true;
+        runPromise = runOnce();
+        return runPromise;
+    };
+    async function runOnce() {
+        let resumeToken = config.resumeSessionId
+            ? { kind: 'opaque', data: config.resumeSessionId }
+            : undefined;
+        pushEvent({ type: 'agent_start', source, traceId, resumeToken });
+        let child = null;
+        let transport = null;
+        let stderrBuf = '';
+        const collectedText = [];
+        let activeSessionId;
+        const cleanup = async () => {
+            transport?.dispose();
+            if (child && child.exitCode === null && child.signalCode === null) {
+                try {
+                    child.kill('SIGTERM');
+                }
+                catch {
+                    // already gone
+                }
+                await waitForExit(child, killGraceMs).catch(() => {
+                    try {
+                        child.kill('SIGKILL');
+                    }
+                    catch {
+                        // already gone
+                    }
+                });
+            }
+        };
+        const fail = async (err, reason) => {
+            turns.close();
+            pushEvent({
+                type: 'error',
+                source,
+                traceId,
+                error: serializeError(err),
+                transient: false,
+            });
+            pushEvent({ type: 'agent_end', source, traceId, reason, resumeToken });
+            closeStream();
+            hasEnded = true;
+            await cleanup();
+            return {
+                text: collectedText.join(''),
+                finishReason: reason,
+                usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+                executedToolCalls: [],
+                resumeToken,
+            };
+        };
+        try {
+            // 1. Spawn subprocess.
+            child = spawnAgent(config);
+            child.on('error', (err) => {
+                pushEvent({
+                    type: 'error',
+                    source,
+                    traceId,
+                    error: serializeError(err),
+                    transient: false,
+                });
+            });
+            child.stderr.setEncoding('utf8');
+            child.stderr.on('data', (chunk) => {
+                stderrBuf += chunk;
+                // Cap to avoid unbounded growth on noisy agents.
+                if (stderrBuf.length > 16_384) {
+                    stderrBuf = stderrBuf.slice(-16_384);
+                }
+                pushEvent({
+                    type: 'native',
+                    source,
+                    traceId,
+                    kind: 'acp:stderr',
+                    payload: chunk,
+                });
+            });
+            // 2. Build transport.
+            transport = createAcpTransport({
+                child,
+                onNotification: (method, params) => {
+                    if (method === ACP_METHODS.sessionUpdate) {
+                        handleSessionUpdate(params);
+                    }
+                    else {
+                        pushEvent({
+                            type: 'native',
+                            source,
+                            traceId,
+                            kind: `acp:notification:${method}`,
+                            payload: params,
+                        });
+                    }
+                },
+                onRequest: async (method, params) => {
+                    if (method === ACP_METHODS.requestPermission) {
+                        pushEvent({
+                            type: 'native',
+                            source,
+                            traceId,
+                            kind: 'acp:request_permission',
+                            payload: params,
+                        });
+                        // v1: respond per permissionMode. Real shape per the ACP spec
+                        // varies by agent; we return a best-effort approval/rejection
+                        // shape. Adapters that need finer control can wrap this
+                        // chassis with their own onRequest before we land it as a
+                        // first-class option.
+                        return config.permissionMode === 'allow'
+                            ? { outcome: { outcome: 'selected', optionId: 'allow' } }
+                            : { outcome: { outcome: 'cancelled' } };
+                    }
+                    pushEvent({
+                        type: 'native',
+                        source,
+                        traceId,
+                        kind: `acp:request:${method}`,
+                        payload: params,
+                    });
+                    throw new Error(`unsupported ACP request: ${method}`);
+                },
+                onTransportError: (err) => {
+                    pushEvent({
+                        type: 'error',
+                        source,
+                        traceId,
+                        error: serializeError(err),
+                        transient: true,
+                    });
+                },
+            });
+            // 3. Initialize handshake.
+            const initReq = {
+                protocolVersion: ACP_PROTOCOL_VERSION,
+                clientInfo: config.clientInfo,
+                clientCapabilities: config.clientCapabilities,
+            };
+            const initRes = await transport.request(ACP_METHODS.initialize, initReq);
+            pushEvent({
+                type: 'native',
+                source,
+                traceId,
+                kind: 'acp:initialized',
+                payload: initRes,
+            });
+            if (compositeSignal.aborted) {
+                return await fail(new Error('aborted before session creation'), 'aborted');
+            }
+            // 4. Session creation or resumption.
+            const mcpServers = config.mcpServers ?? [];
+            if (config.resumeSessionId) {
+                if (initRes.agentCapabilities?.loadSession !== true) {
+                    throw new Error('agent does not declare loadSession capability; cannot resume');
+                }
+                const loadReq = {
+                    sessionId: config.resumeSessionId,
+                    cwd: config.cwd,
+                    mcpServers,
+                };
+                await transport.request(ACP_METHODS.loadSession, loadReq);
+                activeSessionId = config.resumeSessionId;
+            }
+            else {
+                const newReq = {
+                    cwd: config.cwd,
+                    mcpServers,
+                };
+                const newRes = await transport.request(ACP_METHODS.newSession, newReq);
+                activeSessionId = newRes.sessionId;
+            }
+            resumeToken = { kind: 'opaque', data: activeSessionId };
+            if (compositeSignal.aborted) {
+                return await fail(new Error('aborted before prompt'), 'aborted');
+            }
+            // 5. Wire cancel — send session/cancel when the composite aborts.
+            let cancelSent = false;
+            const sendCancel = () => {
+                if (cancelSent || !activeSessionId || !transport)
+                    return;
+                cancelSent = true;
+                const params = { sessionId: activeSessionId };
+                try {
+                    transport.notify(ACP_METHODS.cancel, params);
+                }
+                catch {
+                    // transport may already be down; cleanup handles it
+                }
+            };
+            if (compositeSignal.aborted) {
+                sendCancel();
+            }
+            else {
+                compositeSignal.addEventListener('abort', sendCancel, { once: true });
+            }
+            // 6. Prompt loop. The first iteration uses config.prompt; subsequent
+            // iterations drain followUpQueue (populated by SteerableAgentRun.followUp).
+            // Loop exits when the queue is empty after a response, or on abort/error.
+            let firstIteration = true;
+            let lastFinishReason = 'unknown';
+            while (true) {
+                let currentPrompt;
+                if (firstIteration) {
+                    currentPrompt = config.prompt;
+                    firstIteration = false;
+                }
+                else {
+                    currentPrompt = followUpQueue.shift();
+                }
+                if (currentPrompt === undefined)
+                    break;
+                const promptBlocks = Array.isArray(currentPrompt)
+                    ? currentPrompt
+                    : [{ type: 'text', text: currentPrompt }];
+                const promptReq = {
+                    sessionId: activeSessionId,
+                    prompt: promptBlocks,
+                };
+                let promptRes;
+                try {
+                    promptRes = await transport.request(ACP_METHODS.prompt, promptReq);
+                }
+                catch (err) {
+                    const aborted = compositeSignal.aborted || cancelSent;
+                    return await fail(err, aborted ? 'aborted' : 'error');
+                }
+                // Emit canonical turn_end for this prompt cycle. Natural ordering:
+                // text + tool_call events already arrived during the response, so
+                // endTurn() emits a turn_end with the accumulated counts immediately.
+                turns.endTurn();
+                lastFinishReason = mapStopReason(promptRes.stopReason, compositeSignal.aborted);
+                if (lastFinishReason === 'aborted')
+                    break;
+            }
+            // 7. Synthesize result. resumeToken at this point points at the
+            // (potentially updated) session id.
+            turns.close();
+            pushEvent({ type: 'agent_end', source, traceId, reason: lastFinishReason, resumeToken });
+            closeStream();
+            hasEnded = true;
+            await cleanup();
+            return {
+                text: collectedText.join(''),
+                finishReason: lastFinishReason,
+                usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+                executedToolCalls: [],
+                resumeToken,
+            };
+        }
+        catch (err) {
+            const aborted = compositeSignal.aborted;
+            return await fail(err, aborted ? 'aborted' : 'error');
+        }
+        function handleSessionUpdate(params) {
+            if (!params || typeof params !== 'object' || !('update' in params)) {
+                return;
+            }
+            // params.update is typed as SessionUpdate for known variants. Future
+            // or vendor variants arrive with an unrecognized `sessionUpdate` —
+            // they hit the `default` branch via a wider runtime check.
+            const update = params.update;
+            switch (update.sessionUpdate) {
+                case 'agent_message_chunk': {
+                    const text = contentBlockToText(update.content);
+                    collectedText.push(text);
+                    turns.text(text);
+                    break;
+                }
+                case 'agent_thought_chunk': {
+                    turns.thinking(contentBlockToText(update.content));
+                    break;
+                }
+                case 'tool_call': {
+                    turns.toolCall(update.toolCallId, update.title ?? update.kind ?? 'tool', update.rawInput ?? update.content ?? null);
+                    break;
+                }
+                case 'tool_call_update': {
+                    if (update.status === 'completed') {
+                        turns.toolResult(update.toolCallId, update.title ?? 'tool', update.rawOutput ?? update.content ?? null, false);
+                    }
+                    else if (update.status === 'failed' || update.status === 'cancelled') {
+                        turns.toolResult(update.toolCallId, update.title ?? 'tool', update.rawOutput ?? update.content ?? null, true);
+                    }
+                    else {
+                        // 'in_progress' / 'pending' — informational; surface as native.
+                        turns.native(`acp:tool_status:${update.status}`, update);
+                    }
+                    break;
+                }
+                case 'user_message_chunk': {
+                    // Echo of the client's own prompt; surface as native rather than
+                    // as a canonical text event (which is reserved for the agent).
+                    turns.native('acp:user_chunk', update);
+                    break;
+                }
+                default: {
+                    turns.native(`acp:${update.sessionUpdate}`, update);
+                    break;
+                }
+            }
+        }
+    }
+    return {
+        events: lazyEvents(queue.events, startIfNeeded),
+        get result() {
+            return startIfNeeded();
+        },
+        abort(reason) {
+            controller.abort(reason);
+            if (!started)
+                startIfNeeded();
+        },
+        /**
+         * Queue an additional prompt to send on the same ACP session after
+         * the current prompt response completes. Calls before the run starts
+         * are honored — the loop drains the queue before exiting. After
+         * agent_end the call rejects.
+         */
+        followUp(message) {
+            if (hasEnded) {
+                return Promise.reject(new Error('cannot followUp after agent_end'));
+            }
+            followUpQueue.push(message);
+            return Promise.resolve();
+        },
+        /**
+         * Mid-stream steering. ACP's `session/prompt` is a discrete request —
+         * the protocol doesn't expose mid-generation injection. Callers that
+         * need to add a message after the current response should use
+         * `followUp()` instead.
+         */
+        steer(_message) {
+            return Promise.reject(new Error(`${source} does not support mid-stream steering; use followUp() to send a message after the current prompt response completes`));
+        },
+    }; // SteerableAgentRun at runtime; narrowed via isSteerable() at the call site.
+}
+// ---------------------------------------------------------------------------
+// helpers
+// ---------------------------------------------------------------------------
+function spawnAgent(config) {
+    const env = config.env ? { ...process.env, ...config.env } : process.env;
+    const child = spawn(config.command, config.args ?? [], {
+        cwd: config.subprocessCwd ?? config.cwd,
+        env,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    return child;
+}
+function waitForExit(child, graceMs) {
+    return new Promise((resolve, reject) => {
+        if (child.exitCode !== null || child.signalCode !== null) {
+            resolve();
+            return;
+        }
+        const t = setTimeout(() => {
+            child.removeListener('exit', onExit);
+            reject(new Error('exit timeout'));
+        }, graceMs);
+        const onExit = () => {
+            clearTimeout(t);
+            resolve();
+        };
+        child.once('exit', onExit);
+    });
+}
+function mapStopReason(reason, aborted) {
+    if (aborted || reason === 'cancelled')
+        return 'aborted';
+    switch (reason) {
+        case 'end_turn':
+            return 'stop';
+        case 'max_tokens':
+            return 'length';
+        case 'max_turn_requests':
+            return 'tool_calls';
+        case 'refusal':
+            return 'content_filter';
+        default:
+            return 'unknown';
+    }
+}
+// Re-export the JsonRpcCallError class for callers that catch it.
+export { JsonRpcCallError };
+//# sourceMappingURL=adapter.js.map

package/dist/acp/adapter.js.map

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

package/dist/acp/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Agent Client Protocol chassis. Public entry for the ACP-speaking adapter
+ * surface. Sibling adapters in this package (hermes, openclaw) call
+ * `createAcpAdapter({ id })` to mint their own AgentAdapterMeta with the
+ * right `source` field on every event.
+ *
+ * @internal
+ */
+export { acpAgent, createAcpAdapter, JsonRpcCallError } from './adapter.js';
+export type { AcpAgentConfig, CreateAcpAdapterOptions } from './adapter.js';
+export type { AgentCapabilities as AcpAgentCapabilities, AuthMethod, ClientCapabilities, ContentBlock, Implementation, McpServer, SessionId, StopReason, ToolCallStatus, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/acp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG5E,YAAY,EACV,iBAAiB,IAAI,oBAAoB,EACzC,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,SAAS,EACT,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/acp/index.js

@@ -0,0 +1,10 @@
+/**
+ * Agent Client Protocol chassis. Public entry for the ACP-speaking adapter
+ * surface. Sibling adapters in this package (hermes, openclaw) call
+ * `createAcpAdapter({ id })` to mint their own AgentAdapterMeta with the
+ * right `source` field on every event.
+ *
+ * @internal
+ */
+export { acpAgent, createAcpAdapter, JsonRpcCallError } from './adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/acp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/acp/transport.d.ts

@@ -0,0 +1,82 @@
+/**
+ * NDJSON JSON-RPC 2.0 transport over a child-process stdio pair.
+ *
+ * ACP frames messages as newline-delimited JSON — one JSON-RPC envelope
+ * per line, no Content-Length headers. The transport owns the byte-level
+ * framing, request/response correlation, and notification dispatch. The
+ * adapter layer above translates ACP-specific messages into canonical
+ * `AgentEvent`s.
+ *
+ * Single-process scope: each transport instance binds to one subprocess.
+ * Disposing it ends the child's stdin and (optionally) signals the child.
+ *
+ * @internal
+ */
+import type { ChildProcessByStdio } from 'node:child_process';
+import type { Readable, Writable } from 'node:stream';
+/** A JSON-RPC 2.0 request, response, or notification. @internal */
+export type JsonRpcMessage = {
+    jsonrpc: '2.0';
+    id: number | string;
+    method: string;
+    params?: unknown;
+} | {
+    jsonrpc: '2.0';
+    id: number | string;
+    result: unknown;
+} | {
+    jsonrpc: '2.0';
+    id: number | string;
+    error: JsonRpcError;
+} | {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown;
+};
+/** JSON-RPC 2.0 error object. @internal */
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/** @internal */
+export declare class JsonRpcCallError extends Error {
+    method: string;
+    rpcError: JsonRpcError;
+    constructor(method: string, rpcError: JsonRpcError);
+}
+/** @internal */
+export interface AcpTransportOptions {
+    /** The spawned child whose stdio we'll speak over. */
+    child: ChildProcessByStdio<Writable, Readable, Readable | null>;
+    /**
+     * Called on every notification received from the agent. Notifications
+     * are method calls without an `id` — the transport routes them here.
+     */
+    onNotification?: (method: string, params: unknown) => void;
+    /**
+     * Called on every request the agent makes back at the client (e.g.
+     * session/request_permission). The handler returns the response value
+     * which the transport replies with. If no handler is set or the
+     * handler throws, the transport responds with a JSON-RPC method-not-
+     * found error.
+     */
+    onRequest?: (method: string, params: unknown) => Promise<unknown>;
+    /** Called when the underlying stream emits a parse error or closes unexpectedly. */
+    onTransportError?: (err: Error) => void;
+}
+/**
+ * Build a transport bound to the given child's stdio. The transport
+ * starts reading immediately. Call `dispose()` to release listeners and
+ * close stdin.
+ *
+ * @internal
+ */
+export declare function createAcpTransport(opts: AcpTransportOptions): AcpTransport;
+/** @internal */
+export interface AcpTransport {
+    request<T>(method: string, params?: unknown): Promise<T>;
+    notify(method: string, params?: unknown): void;
+    dispose(): void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/acp/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/acp/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,mEAAmE;AACnE,MAAM,MAAM,cAAc,GACtB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACzE;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACxD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAC5D;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzD,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,gBAAgB;AAChB,qBAAa,gBAAiB,SAAQ,KAAK;IACtB,MAAM,EAAE,MAAM;IAAS,QAAQ,EAAE,YAAY;gBAA7C,MAAM,EAAE,MAAM,EAAS,QAAQ,EAAE,YAAY;CAIjE;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,KAAK,EAAE,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IAChE;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3D;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CACzC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,YAAY,CA+J1E;AAED,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,OAAO,IAAI,IAAI,CAAC;CACjB"}