@tencent-ai/agent-sdk 0.2.0 → 0.2.2

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-ai/codebuddy-code",
-  "version": "2.37.0",
+  "version": "2.37.2",
   "description": "Use CodeBuddy, Tencent's AI assistant, right from your terminal. CodeBuddy can understand your codebase, edit files, run terminal commands, and handle entire workflows for you.",
   "main": "lib/node/index.js",
   "typings": "lib/node/index.d.ts",

package/cli/product.cloudhosted.json

@@ -323,6 +323,6 @@
     "BillingNotice": false,
     "CustomModelsJSON": true
   },
-  "commit": "efa5193182dd606b62b2bf39142bd8097a9018c5",
-  "date": "2026-01-18T07:28:53.812Z"
+  "commit": "0a8844ff1682b4458baf0a8a7d5f60fc1b42e6bf",
+  "date": "2026-01-19T16:12:04.475Z"
 }

package/cli/product.internal.json

@@ -325,6 +325,6 @@
     "BillingNotice": false,
     "CustomModelsJSON": true
   },
-  "commit": "efa5193182dd606b62b2bf39142bd8097a9018c5",
-  "date": "2026-01-18T07:28:50.985Z"
+  "commit": "0a8844ff1682b4458baf0a8a7d5f60fc1b42e6bf",
+  "date": "2026-01-19T16:12:01.839Z"
 }

package/cli/product.ioa.json

@@ -535,6 +535,6 @@
     "BillingNotice": false,
     "CustomModelsJSON": true
   },
-  "commit": "efa5193182dd606b62b2bf39142bd8097a9018c5",
-  "date": "2026-01-18T07:28:52.395Z"
+  "commit": "0a8844ff1682b4458baf0a8a7d5f60fc1b42e6bf",
+  "date": "2026-01-19T16:12:03.176Z"
 }

package/cli/product.json

@@ -1044,6 +1044,6 @@
       "description": "tool-structuredoutput-description"
     }
   ],
-  "commit": "efa5193182dd606b62b2bf39142bd8097a9018c5",
-  "date": "2026-01-18T07:28:49.601Z"
+  "commit": "0a8844ff1682b4458baf0a8a7d5f60fc1b42e6bf",
+  "date": "2026-01-19T16:12:00.512Z"
 }

package/cli/product.selfhosted.json

@@ -205,6 +205,6 @@
     "BillingNotice": false,
     "CustomModelsJSON": true
   },
-  "commit": "efa5193182dd606b62b2bf39142bd8097a9018c5",
-  "date": "2026-01-18T07:28:55.176Z"
+  "commit": "0a8844ff1682b4458baf0a8a7d5f60fc1b42e6bf",
+  "date": "2026-01-19T16:12:05.780Z"
 }

package/lib/acp/acp-client.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ACP Client Adapter
+ *
+ * Acts as a bridge between ACP protocol (JSON-RPC) and SDK internal format (JSON lines).
+ *
+ * Flow:
+ * 1. Caller writes ACP messages to WritableStream
+ * 2. Convert ACP format to SDK internal format
+ * 3. Send to CLI via ProcessTransport
+ * 4. Receive responses from CLI via ProcessTransport
+ * 5. Convert back to ACP format
+ * 6. Caller reads from ReadableStream
+ */
+import type { ProcessTransportOptions } from '../transport';
+import { type AcpToolCall, type AcpToolResult } from './tool-converter';
+/**
+ * Options for creating ACP client
+ */
+export interface AcpClientOptions extends ProcessTransportOptions {
+}
+/**
+ * ACP message types (JSON-RPC 2.0 messages)
+ */
+export interface AcpMessage {
+    jsonrpc: '2.0';
+    id?: string | number;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * Result of createAcpClient
+ */
+export interface AcpClientResult {
+    readable: ReadableStream<AcpMessage>;
+    writable: WritableStream<AcpMessage>;
+    close(): void;
+}
+/**
+ * Tool call message format from SDK
+ */
+export interface ToolCallMessage {
+    method: 'tool_call';
+    toolCall: AcpToolCall;
+}
+/**
+ * Tool result message format from ACP client
+ */
+export interface ToolResultMessage {
+    method: 'tool_result';
+    result: AcpToolResult;
+}
+/**
+ * Create an ACP client that bridges between ACP protocol and SDK format
+ */
+export declare function createAcpClient(options?: AcpClientOptions): AcpClientResult;
+//# sourceMappingURL=acp-client.d.ts.map

package/lib/acp/acp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-client.d.ts","sourceRoot":"","sources":["../../src/acp/acp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,EAKH,KAAK,WAAW,EAChB,KAAK,aAAa,EACrB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,uBAAuB;CAEhE;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,WAAW,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA6Q/E"}

package/lib/acp/acp-client.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAcpClient = createAcpClient;
+const process_transport_1 = require("../transport/process-transport");
+const tool_converter_1 = require("./tool-converter");
+/**
+ * Create an ACP client that bridges between ACP protocol and SDK format
+ */
+function createAcpClient(options = {}) {
+    const transport = new process_transport_1.ProcessTransport(options);
+    let closed = false;
+    // Message queues
+    const readableQueue = [];
+    const readableResolvers = [];
+    const writableQueue = [];
+    let processingWritable = false;
+    /**
+     * Convert ACP message to SDK internal format (JSON lines for CLI)
+     */
+    function acpToSdk(acpMessage) {
+        var _a;
+        if (acpMessage.method === 'session/prompt') {
+            const params = acpMessage.params;
+            const sessionId = params === null || params === void 0 ? void 0 : params.sessionId;
+            const prompt = params === null || params === void 0 ? void 0 : params.prompt;
+            // Extract text content from prompt
+            let content = '';
+            if (prompt && Array.isArray(prompt)) {
+                for (const block of prompt) {
+                    if (block.type === 'text' && block.text) {
+                        content += block.text;
+                    }
+                }
+            }
+            return {
+                type: 'user',
+                session_id: sessionId || 'unknown',
+                message: {
+                    role: 'user',
+                    content: content,
+                },
+                parent_tool_use_id: null,
+            };
+        }
+        if (acpMessage.method === 'session/cancel') {
+            return {
+                type: 'control_request',
+                request: 'interrupt',
+            };
+        }
+        if (acpMessage.method === 'session/tool_result') {
+            // Handle tool result from ACP client
+            // params should be the AcpToolResult object itself
+            const acpResult = acpMessage.params;
+            if (acpResult === null || acpResult === void 0 ? void 0 : acpResult.toolCallId) {
+                console.error('[AcpClient] Converting tool result for toolCallId:', acpResult.toolCallId);
+                // Convert ACP result to SDK ToolResultContentBlock
+                const toolResultBlock = (0, tool_converter_1.convertAcpToolResultToSdk)(acpResult.toolCallId, acpResult);
+                // Wrap it in a user message with tool result
+                return {
+                    type: 'user',
+                    session_id: ((_a = acpMessage.params) === null || _a === void 0 ? void 0 : _a.sessionId) || 'unknown',
+                    message: {
+                        role: 'user',
+                        content: [toolResultBlock],
+                    },
+                    parent_tool_use_id: acpResult.toolCallId,
+                };
+            }
+        }
+        // For other methods, return null - they don't map to SDK format
+        return null;
+    }
+    /**
+     * Convert SDK message to ACP format
+     */
+    function sdkToAcp(message) {
+        const messages = [];
+        // Handle assistant messages with tool uses
+        if ('type' in message && message.type === 'assistant') {
+            const assistantMsg = message;
+            if (assistantMsg.message.content && Array.isArray(assistantMsg.message.content)) {
+                // Extract tool use blocks and convert them
+                const toolUseBlocks = (0, tool_converter_1.extractToolUseBlocks)(assistantMsg.message.content);
+                for (const toolUse of toolUseBlocks) {
+                    // Convert SDK tool use to ACP tool call
+                    const acpToolCall = (0, tool_converter_1.convertSdkToolUseToAcpToolCall)(toolUse);
+                    // Wrap in ACP message format
+                    const toolCallMsg = {
+                        jsonrpc: '2.0',
+                        method: 'tool_call',
+                        params: acpToolCall,
+                    };
+                    messages.push(toolCallMsg);
+                    console.error('[AcpClient] Converted tool use:', toolUse.name, '→', acpToolCall.kind);
+                }
+                // Extract and send text content if present
+                const textContent = (0, tool_converter_1.extractTextContent)(assistantMsg.message.content);
+                if (textContent) {
+                    messages.push({
+                        jsonrpc: '2.0',
+                        method: 'session/text',
+                        params: {
+                            content: textContent,
+                        },
+                    });
+                }
+                return messages;
+            }
+        }
+        // Ignore system, result, and other non-content messages
+        // Only convert assistant messages to ACP format
+        const messageType = ('type' in message) ? message.type : null;
+        if (messageType === 'system' || messageType === 'result' || messageType === 'stream_event') {
+            // Skip these message types - don't send to ACP client
+            return [];
+        }
+        // For other message types, also skip by default
+        // ACP client only needs to know about tool calls and text responses
+        return [];
+    }
+    /**
+     * Enqueue message for readable stream
+     */
+    function enqueueReadable(message) {
+        if (readableResolvers.length > 0) {
+            const resolver = readableResolvers.shift();
+            resolver(message);
+        }
+        else {
+            readableQueue.push(message);
+        }
+    }
+    /**
+     * Dequeue message from readable stream
+     */
+    function dequeueReadable() {
+        if (closed) {
+            return Promise.resolve(null);
+        }
+        if (readableQueue.length > 0) {
+            return Promise.resolve(readableQueue.shift());
+        }
+        return new Promise((resolve) => {
+            readableResolvers.push(resolve);
+        });
+    }
+    /**
+     * Process writable queue - convert ACP to JSON lines and send to CLI
+     */
+    async function processWritableQueue() {
+        if (processingWritable) {
+            return;
+        }
+        processingWritable = true;
+        try {
+            while (writableQueue.length > 0 && !closed) {
+                const acpMessage = writableQueue.shift();
+                console.error('[AcpClient] Processing writable message:', acpMessage.method);
+                // Convert ACP to SDK format
+                const sdkMessage = acpToSdk(acpMessage);
+                if (sdkMessage) {
+                    console.error('[AcpClient] Converted to SDK format, sending to CLI');
+                    if ('type' in sdkMessage && sdkMessage.type === 'user') {
+                        transport.sendUserMessage(sdkMessage);
+                    }
+                    else if ('type' in sdkMessage && sdkMessage.type === 'control_request') {
+                        const controlRequest = sdkMessage;
+                        transport.sendControlRequestNoWait(controlRequest.request);
+                    }
+                }
+                else {
+                    console.error('[AcpClient] Could not convert ACP message to SDK format');
+                }
+            }
+        }
+        finally {
+            processingWritable = false;
+        }
+    }
+    /**
+     * Start receiving SDK messages from transport and convert to ACP
+     */
+    async function startTransportLoop() {
+        transport.start();
+        // Read SDK messages from transport and convert to ACP for readable stream
+        try {
+            for await (const message of transport.messages()) {
+                if (closed)
+                    break;
+                if ('type' in message && message.type !== 'control_request') {
+                    const acpMessages = sdkToAcp(message);
+                    for (const acpMessage of acpMessages) {
+                        enqueueReadable(acpMessage);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error('[AcpClient] Transport loop error:', error);
+        }
+    }
+    /**
+     * Close the client
+     */
+    function close() {
+        if (!closed) {
+            closed = true;
+            transport.close();
+            readableResolvers.forEach((resolver) => resolver(null));
+            readableResolvers.length = 0;
+        }
+    }
+    // Start transport loop in background
+    startTransportLoop().catch((error) => {
+        console.error('[AcpClient] Transport loop error:', error);
+        close();
+    });
+    // Create readable stream
+    const readable = new ReadableStream({
+        async pull(controller) {
+            const message = await dequeueReadable();
+            if (message === null) {
+                controller.close();
+            }
+            else {
+                controller.enqueue(message);
+            }
+        },
+        cancel() {
+            close();
+        },
+    });
+    // Create writable stream
+    const writable = new WritableStream({
+        async write(message) {
+            if (closed) {
+                throw new Error('AcpClient is closed');
+            }
+            writableQueue.push(message);
+            await processWritableQueue();
+        },
+        close() {
+            close();
+        },
+        abort() {
+            close();
+        },
+    });
+    return {
+        readable,
+        writable,
+        close,
+    };
+}
+//# sourceMappingURL=acp-client.js.map

package/lib/acp/acp-client.js.map

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

package/lib/acp/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ACP (Agent Client Protocol) Client Integration
+ *
+ * This module provides utilities for creating ACP clients that work with
+ * the agent SDK by converting ACP protocol messages to/from SDK format.
+ *
+ * Key Design Principles:
+ * - NO DATA LOSS: All tool inputs preserved in rawInput
+ * - Tool IDs maintained throughout conversion chain
+ * - Error states properly tracked and propagated
+ */
+export { createAcpClient } from './acp-client';
+export type { AcpClientOptions, AcpMessage, AcpClientResult, ToolCallMessage, ToolResultMessage } from './acp-client';
+export { convertSdkToolUseToAcpToolCall, convertAcpToolResultToSdk, extractToolUseBlocks, extractTextContent, } from './tool-converter';
+export type { AcpToolCall, AcpToolKind, AcpContent, AcpDiff, AcpLocation, AcpToolResult, } from './tool-converter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtH,OAAO,EACH,8BAA8B,EAC9B,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,OAAO,EACP,WAAW,EACX,aAAa,GAChB,MAAM,kBAAkB,CAAC"}

package/lib/acp/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * ACP (Agent Client Protocol) Client Integration
+ *
+ * This module provides utilities for creating ACP clients that work with
+ * the agent SDK by converting ACP protocol messages to/from SDK format.
+ *
+ * Key Design Principles:
+ * - NO DATA LOSS: All tool inputs preserved in rawInput
+ * - Tool IDs maintained throughout conversion chain
+ * - Error states properly tracked and propagated
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTextContent = exports.extractToolUseBlocks = exports.convertAcpToolResultToSdk = exports.convertSdkToolUseToAcpToolCall = exports.createAcpClient = void 0;
+var acp_client_1 = require("./acp-client");
+Object.defineProperty(exports, "createAcpClient", { enumerable: true, get: function () { return acp_client_1.createAcpClient; } });
+var tool_converter_1 = require("./tool-converter");
+Object.defineProperty(exports, "convertSdkToolUseToAcpToolCall", { enumerable: true, get: function () { return tool_converter_1.convertSdkToolUseToAcpToolCall; } });
+Object.defineProperty(exports, "convertAcpToolResultToSdk", { enumerable: true, get: function () { return tool_converter_1.convertAcpToolResultToSdk; } });
+Object.defineProperty(exports, "extractToolUseBlocks", { enumerable: true, get: function () { return tool_converter_1.extractToolUseBlocks; } });
+Object.defineProperty(exports, "extractTextContent", { enumerable: true, get: function () { return tool_converter_1.extractTextContent; } });
+//# sourceMappingURL=index.js.map

package/lib/acp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AAGxB,mDAK0B;AAJtB,gIAAA,8BAA8B,OAAA;AAC9B,2HAAA,yBAAyB,OAAA;AACzB,sHAAA,oBAAoB,OAAA;AACpB,oHAAA,kBAAkB,OAAA"}

package/lib/acp/tool-converter.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Tool Converter Utility
+ *
+ * Converts SDK internal tool formats to ACP (Agent Client Protocol) format and vice versa.
+ *
+ * Critical Design Principle: NO DATA LOSS
+ * - SDK tool inputs are preserved completely in rawInput
+ * - Tool IDs are maintained throughout the conversion
+ * - Tool results are preserved with error state tracking
+ */
+import type { ToolUseContentBlock, ToolResultContentBlock } from '../types';
+/**
+ * ACP Tool Call representation (not JSON-RPC wrapped)
+ * This is the actual tool call information sent to ACP client
+ */
+export interface AcpToolCall {
+    toolCallId: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    title: string;
+    kind: AcpToolKind;
+    rawInput: Record<string, unknown>;
+    content?: AcpContent[];
+    locations?: AcpLocation[];
+    rawOutput?: unknown;
+}
+export type AcpToolKind = 'read' | 'edit' | 'delete' | 'move' | 'search' | 'execute' | 'think' | 'fetch' | 'other';
+export interface AcpContent {
+    type: 'text' | 'diff' | 'terminal';
+    content?: {
+        type: string;
+        text: string;
+    } | AcpDiff;
+}
+export interface AcpDiff {
+    path: string;
+    oldText: string | null;
+    newText: string;
+}
+export interface AcpLocation {
+    path: string;
+    line?: number;
+}
+/**
+ * ACP Tool Result representation
+ */
+export interface AcpToolResult {
+    toolCallId: string;
+    status: 'completed' | 'failed';
+    content?: AcpContent[];
+    locations?: AcpLocation[];
+    rawOutput?: unknown;
+}
+/**
+ * Convert SDK ToolUseContentBlock to ACP Tool Call
+ * Preserves all input data in rawInput field
+ *
+ * @param toolUse - SDK tool use block
+ * @returns ACP tool call with complete data preservation
+ */
+export declare function convertSdkToolUseToAcpToolCall(toolUse: ToolUseContentBlock): AcpToolCall;
+/**
+ * Convert ACP Tool Result to SDK ToolResultContentBlock
+ * Preserves tool_use_id and ensures error state is tracked
+ *
+ * @param toolCallId - Original tool call ID
+ * @param acpResult - ACP tool result
+ * @returns SDK ToolResultContentBlock
+ */
+export declare function convertAcpToolResultToSdk(toolCallId: string, acpResult: AcpToolResult): ToolResultContentBlock;
+/**
+ * Extract tool use blocks from content blocks array
+ */
+export declare function extractToolUseBlocks(contentBlocks: unknown[]): ToolUseContentBlock[];
+/**
+ * Extract text content from content blocks array
+ */
+export declare function extractTextContent(contentBlocks: unknown[]): string;
+//# sourceMappingURL=tool-converter.d.ts.map

package/lib/acp/tool-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-converter.d.ts","sourceRoot":"","sources":["../../src/acp/tool-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAkC,MAAM,UAAU,CAAC;AAI5G;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IACnC,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;CACtD;AAED,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAID;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,CAaxF;AAqTD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,GACzB,sBAAsB,CAUxB;AAyFD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,OAAO,EAAE,GAAG,mBAAmB,EAAE,CAUpF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,OAAO,EAAE,GAAG,MAAM,CAanE"}