@microsoft/m365agentsplayground-cli 0.2.26 → 0.2.27

package/build/testClient.js

@@ -1,434 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TestClient = void 0;
-const events_1 = require("events");
-const schema_1 = require("schema");
-const server_1 = require("server");
-const serverManager_1 = require("./serverManager");
-const websocketClient_1 = require("./websocketClient");
-/**
- * Test client for sending messages to a bot and receiving responses.
- * Designed for testing multi-turn conversations.
- *
- * @example
- * ```typescript
- * const client = new TestClient({
- *   botEndpoint: 'http://localhost:3978/api/messages',
- * });
- *
- * await client.start();
- *
- * // Multi-turn conversation
- * const [r1] = await client.sendMessage('Hello');
- * expect(r1.text).to.include('Hi');
- *
- * const [r2] = await client.sendMessage('Book a flight');
- * expect(r2.text).to.include('Where');
- *
- * await client.stop();
- * ```
- *
- * @example
- * ```typescript
- * // With WebSocket events
- * const client = new TestClient({
- *   botEndpoint: 'http://localhost:3978/api/messages',
- * });
- *
- * client.on('message:created', (event) => {
- *   console.log('New message:', event.message.text);
- * });
- *
- * client.on('typing', (event) => {
- *   console.log('Bot is typing...');
- * });
- *
- * await client.start();
- * await client.sendMessage('Hello');
- * await client.stop();
- * ```
- *
- * @example
- * ```typescript
- * // With Log WebSocket events
- * const client = new TestClient({
- *   botEndpoint: 'http://localhost:3978/api/messages',
- * });
- *
- * client.on('log:append', (event) => {
- *   console.log('Log entry:', event.logItem);
- * });
- *
- * await client.start();
- * await client.sendMessage('Hello');
- * await client.stop();
- * ```
- */
-class TestClient extends events_1.EventEmitter {
-    /** The placeholder text teams-ai sends as the first streaming activity */
-    static STREAMING_PLACEHOLDER = "Loading stream results...";
-    serverManager;
-    responseCapture;
-    wsClient = null;
-    logWsClient = null;
-    config;
-    conversationId = "";
-    userId = "";
-    started = false;
-    constructor(config) {
-        super();
-        this.config = {
-            timeout: 5000,
-            ...config,
-        };
-        this.serverManager = new serverManager_1.ServerManager();
-        this.responseCapture = serverManager_1.ServerManager.getResponseCapture();
-    }
-    /**
-     * Start the test client and server
-     */
-    async start() {
-        if (this.started) {
-            throw new Error("TestClient is already started");
-        }
-        await this.serverManager.start(this.config);
-        // Create a unique conversation for this client
-        this.registerUniqueConversation();
-        // Connect to WebSocket for real-time events
-        this.wsClient = new websocketClient_1.WebSocketClient({
-            port: this.serverManager.port,
-            onMessage: (action) => {
-                switch (action.action) {
-                    case schema_1.ActionType.CreateMessage:
-                        this.emit("message:created", action);
-                        break;
-                    case schema_1.ActionType.UpdateMessage:
-                        this.emit("message:updated", action);
-                        break;
-                    case schema_1.ActionType.Typing:
-                        this.emit("typing", action);
-                        break;
-                }
-            },
-            onError: (err) => {
-                this.emit("websocket:error", err);
-            },
-            onClose: () => {
-                this.emit("websocket:close");
-            },
-        });
-        await this.wsClient.connect();
-        // Connect to Log WebSocket for log events
-        this.logWsClient = new websocketClient_1.LogWebSocketClient({
-            port: this.serverManager.port,
-            onLogMessage: (action) => {
-                if (action.logAction === schema_1.LogActionType.AppendLog) {
-                    this.emit("log:append", action);
-                }
-            },
-            onError: (err) => {
-                this.emit("log:websocket:error", err);
-            },
-            onClose: () => {
-                this.emit("log:websocket:close");
-            },
-        });
-        await this.logWsClient.connect();
-        this.started = true;
-    }
-    /**
-     * Stop the test client and server
-     */
-    async stop() {
-        if (!this.started) {
-            return;
-        }
-        // Close WebSocket connections
-        if (this.wsClient) {
-            this.wsClient.close();
-            this.wsClient = null;
-        }
-        if (this.logWsClient) {
-            this.logWsClient.close();
-            this.logWsClient = null;
-        }
-        this.responseCapture.clearConversation(this.conversationId);
-        await this.serverManager.stop();
-        this.started = false;
-    }
-    /**
-     * Send a message to the bot and wait for response(s)
-     *
-     * @param text The message text to send
-     * @returns Array of bot responses
-     */
-    async sendMessage(text) {
-        if (!this.started) {
-            throw new Error("TestClient is not started. Call start() first.");
-        }
-        const conversationManager = server_1.Factory.getConversationManager();
-        const messageService = server_1.Factory.getMessageService();
-        // Get the conversation
-        const conversation = conversationManager.getConversation(this.conversationId);
-        // Track message updates received via WebSocket (for streaming bots).
-        const messageUpdates = new Map(); // messageId → latest text
-        let streamFinalReceived = false; // set when streamType:"final" arrives
-        let lastUpdateTime = Date.now(); // epoch ms of last update (or conversation start)
-        const updateListener = (action) => {
-            const id = action.message?.messageId;
-            const msg = action.message;
-            if (id && msg.text !== undefined) {
-                messageUpdates.set(id, msg.text);
-                lastUpdateTime = Date.now();
-                if (msg.streamEntity?.streamType === "final") {
-                    streamFinalReceived = true;
-                }
-            }
-        };
-        this.on("message:updated", updateListener);
-        // Create the message request
-        const messagePayload = {
-            text,
-            textFormat: "plain",
-            from: { id: this.userId },
-        };
-        // Start waiting for response before sending (to avoid race conditions)
-        const responsePromise = this.responseCapture.waitForResponse(this.conversationId, conversationManager, this.config.timeout ?? 5000);
-        // Send the message
-        const { afterAll } = messageService.createMessage(conversation, messagePayload);
-        // Execute the async send
-        if (afterAll) {
-            afterAll();
-        }
-        // Wait for the first bot response (may be a streaming placeholder)
-        await responsePromise;
-        // Get the initial bot messages to check for streaming placeholder
-        const allMessages = conversationManager.listMessages(this.conversationId);
-        const lastUserIdx = allMessages.reduce((lastIdx, msg, idx) => (msg.createdBy === "client" ? idx : lastIdx), -1);
-        const initialBotMessages = allMessages
-            .slice(lastUserIdx + 1)
-            .filter((m) => m.createdBy === "bot");
-        const isStreamingPlaceholder = initialBotMessages.some((m) => m.content.text === TestClient.STREAMING_PLACEHOLDER);
-        if (isStreamingPlaceholder) {
-            // Streaming bot detected.
-            // Primary signal: wait for streamType:"final" WS event (teams-ai / teams.ts SDK).
-            // Fallback: quiet-period in case the bot doesn't send streamType at all.
-            const quietPeriodMs = this.config.streamingSettleDelayMs ?? 800;
-            const maxWaitMs = this.config.timeout ?? 30000;
-            await this.waitForStreamFinal(() => streamFinalReceived, () => lastUpdateTime, quietPeriodMs, maxWaitMs);
-        }
-        this.off("message:updated", updateListener);
-        // Re-read messages after any streaming updates have landed
-        const messages = conversationManager.listMessages(this.conversationId);
-        const lastUserMessageIndex = messages.reduce((lastIndex, msg, index) => {
-            if (msg.createdBy === "client") {
-                return index;
-            }
-            return lastIndex;
-        }, -1);
-        const recentBotMessages = messages
-            .slice(lastUserMessageIndex + 1)
-            .filter((m) => m.createdBy === "bot");
-        return recentBotMessages.map((msg) => {
-            const response = this.toBotResponse(msg);
-            // If this message was updated via streaming, use the final streamed text
-            const streamedText = messageUpdates.get(response.messageId);
-            if (streamedText !== undefined) {
-                response.text = streamedText;
-            }
-            return response;
-        });
-    }
-    /**
-     * Wait for streaming to complete.
-     *
-     * Primary: resolves immediately when `streamType:"final"` WS event arrives.
-     * Fallback: resolves after `quietPeriodMs` of no new updateActivity events,
-     *   for bots that don't send streamType (e.g. non-teams-ai streaming bots).
-     * Hard cap: always resolves after `maxWaitMs`.
-     */
-    async waitForStreamFinal(isFinalReceived, getLastUpdateTime, quietPeriodMs, maxWaitMs) {
-        return new Promise((resolve) => {
-            const deadline = Date.now() + maxWaitMs;
-            const poll = () => {
-                // Primary signal: streamType:"final" received
-                if (isFinalReceived()) {
-                    resolve();
-                    return;
-                }
-                const now = Date.now();
-                if (now >= deadline) {
-                    resolve();
-                    return;
-                }
-                const lastUpdate = getLastUpdateTime();
-                // Fallback: quiet period after last update
-                if (lastUpdate > 0 && now - lastUpdate >= quietPeriodMs) {
-                    resolve();
-                    return;
-                }
-                setTimeout(poll, 50);
-            };
-            setTimeout(poll, 50);
-        });
-    }
-    /**
-     * Start a new conversation (resets conversation state)
-     */
-    newConversation() {
-        if (!this.started) {
-            throw new Error("TestClient is not started. Call start() first.");
-        }
-        // Clear pending responses for the old conversation
-        this.responseCapture.clearConversation(this.conversationId);
-        // Create a fresh unique conversation
-        this.registerUniqueConversation();
-    }
-    /**
-     * Get all messages in the current conversation
-     */
-    getMessages() {
-        if (!this.started) {
-            throw new Error("TestClient is not started. Call start() first.");
-        }
-        const conversationManager = server_1.Factory.getConversationManager();
-        return conversationManager.listMessages(this.conversationId);
-    }
-    /**
-     * Get the last bot message in the current conversation
-     */
-    getLastBotMessage() {
-        const messages = this.getMessages();
-        const botMessages = messages.filter((m) => m.createdBy === "bot");
-        return botMessages[botMessages.length - 1];
-    }
-    /**
-     * Get the current conversation ID
-     */
-    getConversationId() {
-        return this.conversationId;
-    }
-    /**
-     * Get the port the test server is running on
-     */
-    getPort() {
-        return this.serverManager.port;
-    }
-    /**
-     * Simulate clicking an Adaptive Card button (Action.Execute).
-     *
-     * @param messageId  The message ID of the card message (from BotResponse.messageId)
-     * @param verb       The Action.Execute verb defined on the button
-     * @param data       Optional extra data to merge with the button's own data
-     * @returns          The invoke response body from the bot
-     */
-    async clickCardButton(messageId, verb, data = {}) {
-        if (!this.started) {
-            throw new Error("TestClient is not started. Call start() first.");
-        }
-        const port = this.serverManager.port;
-        const meId = server_1.Factory.getTenantManager().getMe().id;
-        const body = {
-            name: "adaptiveCard/action",
-            conversation: { id: this.conversationId },
-            from: { id: meId },
-            replyToId: messageId,
-            value: {
-                action: {
-                    type: "Action.Execute",
-                    verb,
-                    data,
-                },
-            },
-        };
-        const res = await fetch(`http://localhost:${port}/_conversation/v1/invoke`, {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify(body),
-        });
-        if (!res.ok) {
-            throw new Error(`Card action invoke failed: HTTP ${res.status}`);
-        }
-        return res.json();
-    }
-    /**
-     * Simulate submitting an Adaptive Card form (Action.Submit / legacy bots).
-     *
-     * @param messageId  The message ID of the card message
-     * @param data       The form data to submit
-     */
-    async submitCardForm(messageId, data) {
-        if (!this.started) {
-            throw new Error("TestClient is not started. Call start() first.");
-        }
-        const port = this.serverManager.port;
-        const meId = server_1.Factory.getTenantManager().getMe().id;
-        const body = {
-            name: "message/submitAction",
-            conversation: { id: this.conversationId },
-            from: { id: meId },
-            replyToId: messageId,
-            value: data,
-        };
-        const res = await fetch(`http://localhost:${port}/_conversation/v1/invoke`, {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify(body),
-        });
-        if (!res.ok) {
-            throw new Error(`Card form submit failed: HTTP ${res.status}`);
-        }
-        return res.json();
-    }
-    /**
-     * Create a unique conversation for this client based on chatType config.
-     * - personal: creates a new personal chat with a unique userId
-     * - group: creates a new group chat
-     * - channel: uses the team's general channel
-     */
-    registerUniqueConversation() {
-        const chatType = this.config.chatType ?? "personal";
-        const chatManager = server_1.Factory.getChatManager();
-        const conversationManager = server_1.Factory.getConversationManager();
-        if (chatType === "group") {
-            const chat = chatManager.createGroupChat(`test-group-${Date.now()}`);
-            const conversation = conversationManager.createConversation(chat);
-            this.conversationId = conversation.id;
-            this.userId = server_1.Factory.getTenantManager().getMe().id;
-        }
-        else if (chatType === "channel") {
-            const teamManager = server_1.Factory.getTeamManager();
-            const channel = teamManager.getGeneralChannel();
-            const conversation = conversationManager.createConversation(channel);
-            this.conversationId = conversation.id;
-            this.userId = server_1.Factory.getTenantManager().getMe().id;
-        }
-        else {
-            this.userId = `test-user-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-            const chat = chatManager.createPersonalChat(this.userId, "Test Chat");
-            const conversation = conversationManager.createConversation(chat);
-            this.conversationId = conversation.id;
-            // Replace the fake userId in the chat's user set with the real "me" user so that:
-            //   1. isOtherUserChat() returns false → WebSocket events are broadcast to this client
-            //   2. getChatUsers() doesn't throw when looking up the fake userId in the tenant
-            // Using 'as any' is intentional — ChatManager has no public addUserToChat API and
-            // this is simulator-only setup code, not production logic.
-            const meId = server_1.Factory.getTenantManager().getMe().id;
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
-            chatManager._chatUsers.set(chat.id, new Set([meId]));
-        }
-    }
-    /**
-     * Convert a Message to a BotResponse
-     */
-    toBotResponse(message) {
-        return {
-            messageId: message.content.id,
-            text: message.content.text,
-            attachments: message.content.attachments,
-            timestamp: message.content.timestamp.getTime(),
-            raw: message,
-        };
-    }
-}
-exports.TestClient = TestClient;

package/build/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGzC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACnD,YAAY,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,cAAc,EAEd,UAAU,EACV,gBAAgB,EAChB,OAAO,GACR,MAAM,QAAQ,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;IAE5C;;;;OAIG;IACH,YAAY,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAE3C;;;;;;;;;;;;;;;;;OAiBG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAE3B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/build/types.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogActionType = exports.ActionType = void 0;
-// Re-export action types for consumers
-var schema_1 = require("schema");
-Object.defineProperty(exports, "ActionType", { enumerable: true, get: function () { return schema_1.ActionType; } });
-Object.defineProperty(exports, "LogActionType", { enumerable: true, get: function () { return schema_1.LogActionType; } });

package/build/websocketClient.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"websocketClient.d.ts","sourceRoot":"","sources":["../src/websocketClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAK7C,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,EAAE,sBAAsB;IAI3C;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAA4B;gBAE/B,OAAO,EAAE,yBAAyB;IAI9C;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB"}

package/build/websocketClient.js

@@ -1,129 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogWebSocketClient = exports.WebSocketClient = void 0;
-const ws_1 = __importDefault(require("ws"));
-const CONVERSATION_WS_PATH = "/_ws_conversation/v1/conversations/stream";
-const LOG_WS_PATH = "/_ws/log/stream";
-/**
- * WebSocket client for connecting to the conversation WebSocket endpoint.
- * Receives real-time message and typing events from the server.
- */
-class WebSocketClient {
-    ws = null;
-    options;
-    constructor(options) {
-        this.options = options;
-    }
-    /**
-     * Connect to the WebSocket server
-     */
-    connect() {
-        return new Promise((resolve, reject) => {
-            const url = `ws://localhost:${this.options.port}${CONVERSATION_WS_PATH}`;
-            this.ws = new ws_1.default(url);
-            this.ws.on("open", () => {
-                // Small delay to ensure server has processed the connection
-                setTimeout(resolve, 50);
-            });
-            this.ws.on("message", (data) => {
-                try {
-                    const message = JSON.parse(data.toString());
-                    this.options.onMessage(message);
-                }
-                catch (err) {
-                    console.error("Failed to parse WebSocket message:", err);
-                }
-            });
-            this.ws.on("error", (err) => {
-                if (this.options.onError) {
-                    this.options.onError(err);
-                }
-                reject(err);
-            });
-            this.ws.on("close", () => {
-                if (this.options.onClose) {
-                    this.options.onClose();
-                }
-            });
-        });
-    }
-    /**
-     * Close the WebSocket connection
-     */
-    close() {
-        if (this.ws) {
-            this.ws.close();
-            this.ws = null;
-        }
-    }
-    /**
-     * Check if the WebSocket is connected
-     */
-    isConnected() {
-        return this.ws !== null && this.ws.readyState === ws_1.default.OPEN;
-    }
-}
-exports.WebSocketClient = WebSocketClient;
-/**
- * WebSocket client for connecting to the log WebSocket endpoint.
- * Receives real-time log events from the server.
- */
-class LogWebSocketClient {
-    ws = null;
-    options;
-    constructor(options) {
-        this.options = options;
-    }
-    /**
-     * Connect to the log WebSocket server
-     */
-    connect() {
-        return new Promise((resolve, reject) => {
-            const url = `ws://localhost:${this.options.port}${LOG_WS_PATH}`;
-            this.ws = new ws_1.default(url);
-            this.ws.on("open", () => {
-                // Small delay to ensure server has processed the connection
-                setTimeout(resolve, 50);
-            });
-            this.ws.on("message", (data) => {
-                try {
-                    const message = JSON.parse(data.toString());
-                    this.options.onLogMessage(message);
-                }
-                catch (err) {
-                    console.error("Failed to parse log WebSocket message:", err);
-                }
-            });
-            this.ws.on("error", (err) => {
-                if (this.options.onError) {
-                    this.options.onError(err);
-                }
-                reject(err);
-            });
-            this.ws.on("close", () => {
-                if (this.options.onClose) {
-                    this.options.onClose();
-                }
-            });
-        });
-    }
-    /**
-     * Close the WebSocket connection
-     */
-    close() {
-        if (this.ws) {
-            this.ws.close();
-            this.ws = null;
-        }
-    }
-    /**
-     * Check if the WebSocket is connected
-     */
-    isConnected() {
-        return this.ws !== null && this.ws.readyState === ws_1.default.OPEN;
-    }
-}
-exports.LogWebSocketClient = LogWebSocketClient;

package/src/cardValidator.ts

@@ -1,56 +0,0 @@
-/**
- * Adaptive Card schema validation using the official `adaptivecards` package.
- *
- * Validates that a card payload is a well-formed Adaptive Card that Teams can
- * parse. Does NOT check visual rendering — only structural/schema correctness.
- */
-
-import { AdaptiveCard, SerializationContext } from "adaptivecards";
-
-export interface CardValidationError {
-  /** Human-readable description of the issue */
-  message: string;
-  /** "parsing" | "schema" */
-  phase: string;
-}
-
-/**
- * Validate a raw Adaptive Card JSON payload.
- * Returns an empty array if the card is valid.
- */
-export function validateAdaptiveCard(
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  payload: Record<string, unknown>
-): CardValidationError[] {
-  const errors: CardValidationError[] = [];
-
-  // Basic type guard: must have type === "AdaptiveCard"
-  if (payload.type !== "AdaptiveCard") {
-    errors.push({
-      message: `Expected type "AdaptiveCard", got "${String(payload.type ?? "(missing)")}"`,
-      phase: "schema",
-    });
-    return errors; // No point parsing further
-  }
-
-  try {
-    const card = new AdaptiveCard();
-    const context = new SerializationContext();
-    card.parse(payload, context);
-
-    for (let i = 0; i < context.eventCount; i++) {
-      const event = context.getEventAt(i);
-      errors.push({
-        message: event.message ?? String(event),
-        phase: event.phase !== undefined ? String(event.phase) : "parsing",
-      });
-    }
-  } catch (err) {
-    errors.push({
-      message: err instanceof Error ? err.message : String(err),
-      phase: "parsing",
-    });
-  }
-
-  return errors;
-}