@microsoft/m365agentsplayground-cli 0.2.25-alpha.20260507-efe1416.0

package/build/conversationTypes.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Type definitions for multi-turn conversation execution.
+ */
+import type { BotConfig } from "./types";
+import type { CustomActivityTemplateType } from "schema";
+import type { CardValidationError } from "./cardValidator";
+/**
+ * Identity for a user persona in notification activities.
+ */
+export interface PersonaConfig {
+    id: string;
+    name: string;
+    email?: string;
+}
+/**
+ * Server configuration passed per /run-conversation request.
+ */
+export interface E2EConfig {
+    /** Bot endpoint URL (e.g., "http://localhost:3978/api/messages") */
+    botEndpoint: string;
+    /** Response timeout in milliseconds (default: 120000) */
+    timeout?: number;
+    /** Activity delivery mode (default: "expectReplies") */
+    deliveryMode?: "expectReplies" | "default";
+    /** Bot identity configuration */
+    bot?: BotConfig;
+    /** Named personas for notification activities */
+    personas?: Record<string, PersonaConfig>;
+    /**
+     * Default chat context for all "chat" turns in this conversation.
+     * Can be overridden per-turn via turn.chat_type.
+     * Default: "personal"
+     */
+    chatType?: "personal" | "group" | "channel";
+    /**
+     * Quiet-period fallback (ms) for streaming responses.
+     * Primary: resolves on streamType:"final" event (teams-ai / teams.ts SDK).
+     * Fallback: resolves after this many ms with no new updateActivity calls.
+     * Default: 800. Has no effect for bots with stream: false.
+     */
+    streamingSettleDelayMs?: number;
+}
+/**
+ * A single turn to execute in a conversation.
+ */
+export interface Turn {
+    /** Unique identifier for this turn */
+    test_id: string;
+    /** Message text or notification body to send */
+    prompt: string;
+    /**
+     * Activity type. Default: "chat" (standard message).
+     * Any CustomActivityTemplateType value (e.g., "sendEmail", "mentionInWord", "meetingStart")
+     * sends the corresponding notification activity.
+     */
+    turn_type?: "chat" | "card_action" | CustomActivityTemplateType;
+    /**
+     * Chat context for "chat" turn_type. Default: "personal".
+     * - "personal": 1:1 personal chat (default)
+     * - "group": group chat
+     * - "channel": team channel
+     */
+    chat_type?: "personal" | "group" | "channel";
+    /** Persona name override for this turn (looks up in config.personas) */
+    persona?: string;
+    /** Extra metadata for the turn */
+    prompt_metadata?: Record<string, string>;
+    /**
+     * For "messageReaction" turn_type: the reaction emoji.
+     * Defaults to "like". Options: like, heart, laugh, surprised, sad, angry.
+     */
+    reaction_type?: "like" | "heart" | "laugh" | "surprised" | "sad" | "angry";
+    /**
+     * For "messageReaction" turn_type: the message ID to react to.
+     * If omitted, reacts to the last bot message in the conversation.
+     */
+    reply_to_id?: string;
+    /**
+     * For "card_action" turn_type: simulate clicking an Adaptive Card button.
+     * The server must already have a card message in this conversation to target.
+     */
+    card_action?: {
+        /**
+         * The verb of the Action.Execute button to click (required for Action.Execute).
+         */
+        verb?: string;
+        /**
+         * Data payload to send with the action (merged with button's own data).
+         */
+        data?: Record<string, unknown>;
+        /**
+         * test_id of the turn whose first bot response card to target.
+         * If omitted, uses the last bot message that has an attachment.
+         */
+        reply_to_turn?: string;
+        /**
+         * Action type. Default: "Action.Execute".
+         * Use "Action.Submit" for legacy bots.
+         */
+        action_type?: "Action.Execute" | "Action.Submit";
+    };
+}
+/**
+ * Input for a single conversation: a list of turns to execute sequentially.
+ */
+export interface ConversationInput {
+    /** Default persona for all turns */
+    persona?: string;
+    /** Ordered turns to execute */
+    turns: Turn[];
+}
+/**
+ * A single validated Adaptive Card attachment returned with a turn result.
+ */
+export interface TurnAttachment {
+    /** Attachment content type (e.g. "application/vnd.microsoft.card.adaptive") */
+    contentType: string;
+    /** The raw card JSON content */
+    content: Record<string, unknown>;
+    /** Schema validation errors for this card. Empty array means valid. */
+    card_errors: CardValidationError[];
+}
+/**
+ * Result of a single turn execution.
+ */
+export interface TurnResult {
+    test_id: string;
+    prompt: string;
+    actual_response: string | null;
+    /** Adaptive Card attachments returned by the bot this turn, with validation results */
+    attachments: TurnAttachment[];
+    status: "Completed" | "TimedOut" | "Errored" | "Skipped";
+    error_message?: string;
+    duration_seconds: number;
+}
+/**
+ * Result of a full conversation execution.
+ */
+export interface ConversationResult {
+    type: "conversation_result";
+    scenario: string;
+    status: "Completed" | "TimedOut" | "Errored";
+    duration_seconds: number;
+    turns: TurnResult[];
+}
+//# sourceMappingURL=conversationTypes.d.ts.map

package/build/conversationTypes.d.ts.map

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

package/build/conversationTypes.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Type definitions for multi-turn conversation execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/index.d.ts

@@ -0,0 +1,14 @@
+export { TestClient } from "./testClient";
+export { ServerManager } from "./serverManager";
+export { ResponseCapture } from "./responseCapture";
+export type { TestClientConfig, BotConfig, BotResponse, PendingResponse } from "./types";
+export { ActionType, LogActionType } from "./types";
+export type { IAction, ICreateMessageAction, IUpdateMessageAction, ITypingAction, IActionMessage, ILogAction, IAppendLogAction, LogItem, } from "./types";
+export { runConversation, log, logError } from "./runConversation";
+export { sendNotificationAndWait } from "./notificationSender";
+export { createConversationServer } from "./conversationServer";
+export type { ConversationServer, ConversationServerOptions } from "./conversationServer";
+export type { E2EConfig, PersonaConfig, Turn, TurnAttachment, ConversationInput, TurnResult, ConversationResult, } from "./conversationTypes";
+export { validateAdaptiveCard } from "./cardValidator";
+export type { CardValidationError } from "./cardValidator";
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGzF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,YAAY,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,cAAc,EAEd,UAAU,EACV,gBAAgB,EAChB,OAAO,GACR,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EACV,SAAS,EACT,aAAa,EACb,IAAI,EACJ,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/build/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAdaptiveCard = exports.createConversationServer = exports.sendNotificationAndWait = exports.logError = exports.log = exports.runConversation = exports.LogActionType = exports.ActionType = exports.ResponseCapture = exports.ServerManager = exports.TestClient = void 0;
+var testClient_1 = require("./testClient");
+Object.defineProperty(exports, "TestClient", { enumerable: true, get: function () { return testClient_1.TestClient; } });
+var serverManager_1 = require("./serverManager");
+Object.defineProperty(exports, "ServerManager", { enumerable: true, get: function () { return serverManager_1.ServerManager; } });
+var responseCapture_1 = require("./responseCapture");
+Object.defineProperty(exports, "ResponseCapture", { enumerable: true, get: function () { return responseCapture_1.ResponseCapture; } });
+// Re-export WebSocket event types for consumers
+var types_1 = require("./types");
+Object.defineProperty(exports, "ActionType", { enumerable: true, get: function () { return types_1.ActionType; } });
+Object.defineProperty(exports, "LogActionType", { enumerable: true, get: function () { return types_1.LogActionType; } });
+// Conversation runner
+var runConversation_1 = require("./runConversation");
+Object.defineProperty(exports, "runConversation", { enumerable: true, get: function () { return runConversation_1.runConversation; } });
+Object.defineProperty(exports, "log", { enumerable: true, get: function () { return runConversation_1.log; } });
+Object.defineProperty(exports, "logError", { enumerable: true, get: function () { return runConversation_1.logError; } });
+var notificationSender_1 = require("./notificationSender");
+Object.defineProperty(exports, "sendNotificationAndWait", { enumerable: true, get: function () { return notificationSender_1.sendNotificationAndWait; } });
+var conversationServer_1 = require("./conversationServer");
+Object.defineProperty(exports, "createConversationServer", { enumerable: true, get: function () { return conversationServer_1.createConversationServer; } });
+// Adaptive Card validation
+var cardValidator_1 = require("./cardValidator");
+Object.defineProperty(exports, "validateAdaptiveCard", { enumerable: true, get: function () { return cardValidator_1.validateAdaptiveCard; } });

package/build/notificationSender.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Notification sender for multi-turn conversation execution.
+ *
+ * Sends custom notification activities through the playground's Factory
+ * infrastructure and polls ConversationManager for bot responses.
+ */
+import type { PersonaConfig, Turn } from "./conversationTypes";
+/**
+ * Send a notification activity and wait for the bot's response.
+ *
+ * The turn's turn_type must be a valid CustomActivityTemplateType
+ * (e.g., "sendEmail", "mentionInWord"). It is passed directly to
+ * the playground's CustomActivityService.
+ */
+export declare function sendNotificationAndWait(conversationId: string, turn: Turn, persona: PersonaConfig | undefined, timeout: number): Promise<string>;
+//# sourceMappingURL=notificationSender.d.ts.map

package/build/notificationSender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationSender.d.ts","sourceRoot":"","sources":["../src/notificationSender.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAQ/D;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAyGjB"}

package/build/notificationSender.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Notification sender for multi-turn conversation execution.
+ *
+ * Sends custom notification activities through the playground's Factory
+ * infrastructure and polls ConversationManager for bot responses.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendNotificationAndWait = void 0;
+const server_1 = require("server");
+const POLL_INTERVAL_MS = 200;
+function log(msg) {
+    process.stderr.write(`[notification] ${msg}\n`);
+}
+/**
+ * Send a notification activity and wait for the bot's response.
+ *
+ * The turn's turn_type must be a valid CustomActivityTemplateType
+ * (e.g., "sendEmail", "mentionInWord"). It is passed directly to
+ * the playground's CustomActivityService.
+ */
+async function sendNotificationAndWait(conversationId, turn, persona, timeout) {
+    const templateType = turn.turn_type;
+    const customActivityService = server_1.Factory.getCustomActivityService();
+    const accessor = server_1.Factory.getBaseUserBotAccessor();
+    const conversationManager = server_1.Factory.getConversationManager();
+    // Count existing messages before sending.
+    const messagesBefore = conversationManager.listMessages(conversationId);
+    const countBefore = messagesBefore.length;
+    // Generate the activity template as a mutable plain object.
+    const template = customActivityService.generateTemplate(conversationId, templateType);
+    // Override the from field if a persona is provided.
+    if (persona) {
+        const from = (template.from ?? {});
+        template.from = {
+            ...from,
+            id: persona.email ?? persona.id,
+            name: persona.name,
+        };
+    }
+    // Customize the activity body based on turn type.
+    if (templateType === "sendEmail") {
+        const entities = template.entities;
+        const emailEntity = entities?.find((e) => e.type === "emailNotification");
+        if (emailEntity) {
+            emailEntity.htmlBody = turn.prompt;
+        }
+    }
+    else if (templateType === "mentionInWord") {
+        template.text = turn.prompt;
+        if (turn.prompt_metadata?.documentUrl) {
+            const attachments = template.attachments;
+            if (attachments?.[0]) {
+                attachments[0].contentUrl = turn.prompt_metadata.documentUrl;
+            }
+        }
+        if (turn.prompt_metadata?.documentName) {
+            const attachments = template.attachments;
+            if (attachments?.[0]) {
+                attachments[0].name = turn.prompt_metadata.documentName;
+            }
+        }
+    }
+    else if (templateType === "meetingStart" || templateType === "meetingEnd") {
+        if (turn.prompt_metadata?.meetingTitle) {
+            const value = (template.value ?? {});
+            value.Title = turn.prompt_metadata.meetingTitle;
+            template.value = value;
+        }
+    }
+    else if (templateType === "participantJoin" || templateType === "participantLeave") {
+        if (turn.prompt) {
+            const value = (template.value ?? {});
+            const members = (value.members ?? []);
+            if (members[0]) {
+                const user = (members[0].user ?? {});
+                user.name = turn.prompt;
+                members[0].user = user;
+                value.members = members;
+                template.value = value;
+            }
+        }
+    }
+    else if (templateType === "messageReaction") {
+        const reaction = turn.reaction_type ?? "like";
+        template.reactionsAdded = [{ type: reaction }];
+        template.reactionsRemoved = [];
+        if (turn.reply_to_id) {
+            template.replyToId = turn.reply_to_id;
+        }
+        else {
+            // Default: react to last bot message
+            const messages = conversationManager.listMessages(conversationId);
+            const lastBotMsg = [...messages].reverse().find((m) => m.createdBy === "bot");
+            if (lastBotMsg) {
+                template.replyToId = lastBotMsg.content.id;
+            }
+        }
+    }
+    log(`Sending ${templateType} activity to conversation ${conversationId}`);
+    // sendActivity expects the Activity class from the server's dependency tree.
+    // We cast through unknown to bridge the inferred template type.
+    await accessor.sendActivity(template);
+    // Poll for new bot messages.
+    const deadline = Date.now() + timeout;
+    while (Date.now() < deadline) {
+        const messages = conversationManager.listMessages(conversationId);
+        const newBotMessages = messages.slice(countBefore).filter((m) => m.createdBy === "bot");
+        if (newBotMessages.length > 0) {
+            const responseText = newBotMessages
+                .map((m) => m.content.text ?? "")
+                .filter((t) => t.length > 0)
+                .join("\n\n");
+            return responseText;
+        }
+        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+    }
+    throw new Error(`Timeout waiting for bot response to ${templateType} after ${timeout}ms`);
+}
+exports.sendNotificationAndWait = sendNotificationAndWait;

package/build/responseCapture.d.ts

@@ -0,0 +1,29 @@
+import { BotConnectorService, ConversationManager, Message } from "server";
+/**
+ * Captures bot responses by hooking into BotConnectorService.processActivity
+ */
+export declare class ResponseCapture {
+    private pendingResponses;
+    private originalProcessActivity?;
+    /**
+     * Hook into BotConnectorService to intercept responses
+     */
+    hookIntoBotConnectorService(service: BotConnectorService): void;
+    /**
+     * Wait for a response in the given conversation
+     */
+    waitForResponse(conversationId: string, conversationManager: ConversationManager, timeout: number): Promise<Message[]>;
+    /**
+     * Resolve waiting promises when a response arrives
+     */
+    private resolveWaiting;
+    /**
+     * Clear all pending responses
+     */
+    clear(): void;
+    /**
+     * Clear pending responses for a specific conversation only
+     */
+    clearConversation(conversationId: string): void;
+}
+//# sourceMappingURL=responseCapture.d.ts.map

package/build/responseCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseCapture.d.ts","sourceRoot":"","sources":["../src/responseCapture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAI3E;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,uBAAuB,CAAC,CAAuD;IAEvF;;OAEG;IACH,2BAA2B,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAkD/D;;OAEG;IACG,eAAe,CACnB,cAAc,EAAE,MAAM,EACtB,mBAAmB,EAAE,mBAAmB,EACxC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,EAAE,CAAC;IA6BrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;CAOhD"}

package/build/responseCapture.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseCapture = void 0;
+/**
+ * Captures bot responses by hooking into BotConnectorService.processActivity
+ */
+class ResponseCapture {
+    pendingResponses = new Map();
+    originalProcessActivity;
+    /**
+     * Hook into BotConnectorService to intercept responses
+     */
+    hookIntoBotConnectorService(service) {
+        if (this.originalProcessActivity) {
+            // Already hooked
+            return;
+        }
+        this.originalProcessActivity = service.processActivity.bind(service);
+        service.processActivity = async (conversationId, activity) => {
+            if (this.originalProcessActivity === undefined) {
+                throw new Error("BotConnectorService.processActivity is undefined");
+            }
+            try {
+                const result = await this.originalProcessActivity(conversationId, activity);
+                // Only resolve waiting when an actual message was created (resIds non-empty).
+                // Typing indicators and trace activities return resIds:[] and must NOT
+                // resolve the waiting promise prematurely.
+                if (result.resIds.length > 0) {
+                    this.resolveWaiting(conversationId);
+                }
+                return result;
+            }
+            catch (error) {
+                // Log the error for debugging — this is the actual error that causes 500s
+                // when the bot POSTs back to the connector.
+                console.error(`[ResponseCapture] processActivity error for conversation ${conversationId}:`, error);
+                const activityAny = activity;
+                const entities = Array.isArray(activityAny.entities) ? activityAny.entities : [];
+                console.error(`[ResponseCapture] Activity type: ${String(activityAny.type)}, ` +
+                    `entities: ${JSON.stringify(entities.map((e) => e.type))}`);
+                // Still resolve waiting on error — the test should see whatever messages
+                // were created before the error, rather than timing out silently.
+                this.resolveWaiting(conversationId);
+                throw error;
+            }
+        };
+    }
+    /**
+     * Wait for a response in the given conversation
+     */
+    async waitForResponse(conversationId, conversationManager, timeout) {
+        const messageCountBefore = conversationManager.listMessages(conversationId).length;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingResponses.delete(conversationId);
+                // Check one more time before rejecting
+                const messages = conversationManager.listMessages(conversationId);
+                const newMessages = messages.slice(messageCountBefore);
+                const botMessages = newMessages.filter((m) => m.createdBy === "bot");
+                if (botMessages.length > 0) {
+                    resolve(botMessages);
+                }
+                else {
+                    reject(new Error(`Timeout waiting for bot response after ${timeout}ms`));
+                }
+            }, timeout);
+            this.pendingResponses.set(conversationId, {
+                resolve: (messages) => {
+                    clearTimeout(timer);
+                    resolve(messages);
+                },
+                reject,
+                timer,
+                messageCountBefore,
+            });
+        });
+    }
+    /**
+     * Resolve waiting promises when a response arrives
+     */
+    resolveWaiting(conversationId) {
+        const pending = this.pendingResponses.get(conversationId);
+        if (!pending) {
+            return;
+        }
+        // Use setImmediate to allow the message to be stored first
+        setImmediate(() => {
+            // The pending might have been removed by timeout
+            if (!this.pendingResponses.has(conversationId)) {
+                return;
+            }
+            // We don't have direct access to conversationManager here,
+            // so we just signal completion. The TestClient will check for new messages.
+            this.pendingResponses.delete(conversationId);
+            clearTimeout(pending.timer);
+            pending.resolve([]);
+        });
+    }
+    /**
+     * Clear all pending responses
+     */
+    clear() {
+        this.pendingResponses.forEach((pending) => {
+            clearTimeout(pending.timer);
+        });
+        this.pendingResponses.clear();
+    }
+    /**
+     * Clear pending responses for a specific conversation only
+     */
+    clearConversation(conversationId) {
+        const pending = this.pendingResponses.get(conversationId);
+        if (pending) {
+            clearTimeout(pending.timer);
+            this.pendingResponses.delete(conversationId);
+        }
+    }
+}
+exports.ResponseCapture = ResponseCapture;

package/build/runConversation.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Conversation execution logic for the test harness.
+ *
+ * Runs a sequence of turns against a bot through a fresh TestClient
+ * and returns the bot's responses. No eval logic — just execution.
+ */
+import type { E2EConfig, ConversationInput, ConversationResult } from "./conversationTypes";
+export declare function log(msg: string): void;
+export declare function logError(msg: string): void;
+/**
+ * Run a single conversation through a fresh TestClient.
+ *
+ * Creates an isolated TestClient, sends each turn sequentially, and
+ * collects the bot's responses. On failure, remaining turns are skipped.
+ */
+export declare function runConversation(config: E2EConfig, scenario: string, input: ConversationInput): Promise<ConversationResult>;
+//# sourceMappingURL=runConversation.d.ts.map

package/build/runConversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runConversation.d.ts","sourceRoot":"","sources":["../src/runConversation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EACV,SAAS,EAET,iBAAiB,EAIjB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAM7B,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAErC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE1C;AAiHD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA+N7B"}