@microsoft/agents-copilotstudio-client 1.4.0-beta.6.g725ba9fc33 → 1.4.1

package/dist/src/connectionSettings.d.ts

@@ -42,6 +42,8 @@ declare abstract class ConnectionOptions implements Omit<CopilotStudioConnection
     directConnectUrl?: string;
     /** Flag to use the experimental endpoint if available */
     useExperimentalEndpoint?: boolean;
+    /** Flag to enable diagnostic logging. Default is false. */
+    enableDiagnostics?: boolean;
 }
 /**
  * Represents the settings required to establish a connection to Copilot Studio.

package/dist/src/connectionSettings.js

@@ -14,6 +14,8 @@ class ConnectionOptions {
     constructor() {
         /** Flag to use the experimental endpoint if available */
         this.useExperimentalEndpoint = false;
+        /** Flag to enable diagnostic logging. Default is false. */
+        this.enableDiagnostics = false;
     }
 }
 /**
@@ -47,7 +49,7 @@ exports.ConnectionSettings = ConnectionSettings;
  * @returns The connection settings.
  */
 const loadCopilotStudioConnectionSettingsFromEnv = () => {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     return new ConnectionSettings({
         appClientId: (_a = process.env.appClientId) !== null && _a !== void 0 ? _a : '',
         tenantId: (_b = process.env.tenantId) !== null && _b !== void 0 ? _b : '',
@@ -59,7 +61,8 @@ const loadCopilotStudioConnectionSettingsFromEnv = () => {
         customPowerPlatformCloud: process.env.customPowerPlatformCloud,
         copilotAgentType: process.env.copilotAgentType,
         directConnectUrl: process.env.directConnectUrl,
-        useExperimentalEndpoint: ((_g = process.env.useExperimentalEndpoint) === null || _g === void 0 ? void 0 : _g.toLowerCase()) === 'true'
+        useExperimentalEndpoint: ((_g = process.env.useExperimentalEndpoint) === null || _g === void 0 ? void 0 : _g.toLowerCase()) === 'true',
+        enableDiagnostics: ((_h = process.env.enableDiagnostics) === null || _h === void 0 ? void 0 : _h.toLowerCase()) === 'true'
     });
 };
 exports.loadCopilotStudioConnectionSettingsFromEnv = loadCopilotStudioConnectionSettingsFromEnv;

package/dist/src/connectionSettings.js.map

@@ -1 +1 @@
-{"version":3,"file":"connectionSettings.js","sourceRoot":"","sources":["../../src/connectionSettings.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2CAAuC;AAEvC,6DAAyD;AAEzD;;GAEG;AACH,MAAe,iBAAiB;IAAhC;QAgCE,yDAAyD;QAClD,4BAAuB,GAAa,KAAK,CAAA;IAClD,CAAC;CAAA;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,iBAAiB;IAiBvD;;OAEG;IACH,YAAa,OAA2B;;QACtC,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QAED,MAAM,KAAK,GAAG,CAAA,MAAA,OAAO,CAAC,KAAK,0CAAE,IAAI,EAAE,KAAI,uCAAkB,CAAC,IAAI,CAAA;QAC9D,MAAM,gBAAgB,GAAG,CAAA,MAAA,OAAO,CAAC,gBAAgB,0CAAE,IAAI,EAAE,KAAI,qBAAS,CAAC,SAAS,CAAA;QAChF,MAAM,SAAS,GAAG,CAAA,MAAA,OAAO,CAAC,SAAS,0CAAE,IAAI,EAAE,KAAI,mCAAmC,CAAA;QAElF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,uCAAkB,CAAC,CAAC,QAAQ,CAAC,KAA2B,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,wBAAwB,MAAM,CAAC,MAAM,CAAC,uCAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC9H,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAS,CAAC,CAAC,QAAQ,CAAC,gBAA6B,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,uBAAuB,gBAAgB,wBAAwB,MAAM,CAAC,MAAM,CAAC,qBAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACvH,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC,CAAA;IACzE,CAAC;CACF;AAzCD,gDAyCC;AAED;;;GAGG;AACI,MAAM,0CAA0C,GAA6B,GAAG,EAAE;;IACvF,OAAO,IAAI,kBAAkB,CAAC;QAC5B,WAAW,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,WAAW,mCAAI,EAAE;QAC1C,QAAQ,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,QAAQ,mCAAI,EAAE;QACpC,SAAS,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,iBAAiB,mCAAI,mCAAmC;QAC/E,aAAa,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,aAAa,mCAAI,EAAE;QAC9C,eAAe,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,eAAe,mCAAI,EAAE;QAClD,UAAU,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,UAAU,mCAAI,EAAE;QACxC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAA2B;QAC9C,wBAAwB,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB;QAC9D,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAA6B;QAC3D,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAC9C,uBAAuB,EAAE,CAAA,MAAA,OAAO,CAAC,GAAG,CAAC,uBAAuB,0CAAE,WAAW,EAAE,MAAK,MAAM;KACvF,CAAC,CAAA;AACJ,CAAC,CAAA;AAdY,QAAA,0CAA0C,8CActD"}
+{"version":3,"file":"connectionSettings.js","sourceRoot":"","sources":["../../src/connectionSettings.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2CAAuC;AAEvC,6DAAyD;AAEzD;;GAEG;AACH,MAAe,iBAAiB;IAAhC;QAgCE,yDAAyD;QAClD,4BAAuB,GAAa,KAAK,CAAA;QAChD,2DAA2D;QACpD,sBAAiB,GAAa,KAAK,CAAA;IAC5C,CAAC;CAAA;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,iBAAiB;IAiBvD;;OAEG;IACH,YAAa,OAA2B;;QACtC,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QAED,MAAM,KAAK,GAAG,CAAA,MAAA,OAAO,CAAC,KAAK,0CAAE,IAAI,EAAE,KAAI,uCAAkB,CAAC,IAAI,CAAA;QAC9D,MAAM,gBAAgB,GAAG,CAAA,MAAA,OAAO,CAAC,gBAAgB,0CAAE,IAAI,EAAE,KAAI,qBAAS,CAAC,SAAS,CAAA;QAChF,MAAM,SAAS,GAAG,CAAA,MAAA,OAAO,CAAC,SAAS,0CAAE,IAAI,EAAE,KAAI,mCAAmC,CAAA;QAElF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,uCAAkB,CAAC,CAAC,QAAQ,CAAC,KAA2B,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,wBAAwB,MAAM,CAAC,MAAM,CAAC,uCAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC9H,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAS,CAAC,CAAC,QAAQ,CAAC,gBAA6B,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,uBAAuB,gBAAgB,wBAAwB,MAAM,CAAC,MAAM,CAAC,qBAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACvH,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC,CAAA;IACzE,CAAC;CACF;AAzCD,gDAyCC;AAED;;;GAGG;AACI,MAAM,0CAA0C,GAA6B,GAAG,EAAE;;IACvF,OAAO,IAAI,kBAAkB,CAAC;QAC5B,WAAW,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,WAAW,mCAAI,EAAE;QAC1C,QAAQ,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,QAAQ,mCAAI,EAAE;QACpC,SAAS,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,iBAAiB,mCAAI,mCAAmC;QAC/E,aAAa,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,aAAa,mCAAI,EAAE;QAC9C,eAAe,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,eAAe,mCAAI,EAAE;QAClD,UAAU,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,UAAU,mCAAI,EAAE;QACxC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAA2B;QAC9C,wBAAwB,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB;QAC9D,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAA6B;QAC3D,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAC9C,uBAAuB,EAAE,CAAA,MAAA,OAAO,CAAC,GAAG,CAAC,uBAAuB,0CAAE,WAAW,EAAE,MAAK,MAAM;QACtF,iBAAiB,EAAE,CAAA,MAAA,OAAO,CAAC,GAAG,CAAC,iBAAiB,0CAAE,WAAW,EAAE,MAAK,MAAM;KAC3E,CAAC,CAAA;AACJ,CAAC,CAAA;AAfY,QAAA,0CAA0C,8CAetD"}

package/dist/src/copilotStudioClient.d.ts

@@ -4,6 +4,9 @@
  */
 import { ConnectionSettings } from './connectionSettings';
 import { Activity } from '@microsoft/agents-activity';
+import { StartRequest } from './startRequest';
+import { StartResponse, ExecuteTurnResponse } from './responses';
+import { SubscribeEvent } from './subscribeEvent';
 /**
  * Client for interacting with Microsoft Copilot Studio services.
  * Provides functionality to start conversations and send messages to Copilot Studio bots.
@@ -24,6 +27,7 @@ export declare class CopilotStudioClient {
      * This is used for authentication token audience configuration.
      * @param settings Copilot Studio connection settings.
      * @returns The scope URL for token audience.
+     * @deprecated Use ScopeHelper.getScopeFromSettings instead.
      */
     static scopeFromSettings: (settings: ConnectionSettings) => string;
     /**
@@ -32,6 +36,12 @@ export declare class CopilotStudioClient {
      * @param token The authentication token.
      */
     constructor(settings: ConnectionSettings, token: string);
+    /**
+     * Logs a diagnostic message if diagnostics are enabled.
+     * @param message The message to log.
+     * @param args Additional arguments to log.
+     */
+    private logDiagnostic;
     /**
      * Streams activities from the Copilot Studio service using eventsource-client.
      * @param url The connection URL for Copilot Studio.
@@ -40,14 +50,13 @@ export declare class CopilotStudioClient {
      * @returns An async generator yielding the Agent's Activities.
      */
     private postRequestAsync;
+    private processResponseHeaders;
     /**
-     * Appends this package.json version to the User-Agent header.
-     * - For browser environments, it includes the user agent of the browser.
-     * - For Node.js environments, it includes the Node.js version, platform, architecture, and release.
-     * @returns A string containing the product information, including version and user agent.
+     * Starts a new conversation with the Copilot Studio service using a StartRequest.
+     * @param request The request parameters for starting the conversation.
+     * @returns An async generator yielding the Agent's Activities.
      */
-    private static getProductInfo;
-    private processResponseHeaders;
+    startConversationStreaming(request: StartRequest): AsyncGenerator<Activity>;
     /**
      * Starts a new conversation with the Copilot Studio service.
      * @param emitStartConversationEvent Whether to emit a start conversation event. Defaults to true.
@@ -61,6 +70,31 @@ export declare class CopilotStudioClient {
      * @returns An async generator yielding the Agent's Activities.
      */
     sendActivityStreaming(activity: Activity, conversationId?: string): AsyncGenerator<Activity>;
+    /**
+     * Executes a turn in an existing conversation by sending an activity.
+     * This method provides explicit control over the conversation ID.
+     * @param activity The activity to send.
+     * @param conversationId The ID of the conversation. Required.
+     * @returns An async generator yielding the Agent's Activities.
+     * @throws Error if conversationId is not provided.
+     */
+    executeStreaming(activity: Activity, conversationId: string): AsyncGenerator<Activity>;
+    /**
+     * Executes a turn in an existing conversation by sending an activity.
+     * @param activity The activity to send.
+     * @param conversationId The ID of the conversation. Required.
+     * @returns A promise yielding an array of activities.
+     * @throws Error if conversationId is not provided.
+     * @deprecated Use executeStreaming instead.
+     */
+    execute(activity: Activity, conversationId: string): Promise<Activity[]>;
+    /**
+     * Starts a new conversation with the Copilot Studio service using a StartRequest.
+     * @param request The request parameters for starting the conversation.
+     * @returns A promise yielding an array of activities.
+     * @deprecated Use startConversationStreaming instead.
+     */
+    startConversationAsync(request: StartRequest): Promise<Activity[]>;
     /**
      * Starts a new conversation with the Copilot Studio service.
      * @param emitStartConversationEvent Whether to emit a start conversation event. Defaults to true.
@@ -84,4 +118,25 @@ export declare class CopilotStudioClient {
      * @deprecated Use sendActivityStreaming instead.
      */
     sendActivity(activity: Activity, conversationId?: string): Promise<Activity[]>;
+    /**
+     * Starts a new conversation and returns a typed response.
+     * @param request The request parameters for starting the conversation.
+     * @returns A promise yielding a StartResponse with activities and conversation metadata.
+     */
+    startConversationWithResponse(request?: StartRequest | boolean): Promise<StartResponse>;
+    /**
+     * Executes a turn and returns a typed response.
+     * @param activity The activity to send.
+     * @param conversationId The conversation ID.
+     * @returns A promise yielding an ExecuteTurnResponse with activities and metadata.
+     */
+    executeWithResponse(activity: Activity, conversationId: string): Promise<ExecuteTurnResponse>;
+    /**
+     * Subscribes to a conversation to receive events via Server-Sent Events (SSE).
+     * This method allows resumption from a specific event ID.
+     * @param conversationId The ID of the conversation to subscribe to.
+     * @param lastReceivedEventId Optional. The last received event ID for resumption.
+     * @returns An async generator yielding SubscribeEvent objects containing activities and event IDs.
+     */
+    subscribeAsync(conversationId: string, lastReceivedEventId?: string): AsyncGenerator<SubscribeEvent>;
 }

package/dist/src/copilotStudioClient.js

@@ -3,9 +3,6 @@
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Licensed under the MIT License.
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CopilotStudioClient = void 0;
 const eventsource_client_1 = require("eventsource-client");
@@ -13,8 +10,9 @@ const powerPlatformEnvironment_1 = require("./powerPlatformEnvironment");
 const agents_activity_1 = require("@microsoft/agents-activity");
 const executeTurnRequest_1 = require("./executeTurnRequest");
 const logger_1 = require("@microsoft/agents-activity/logger");
-const package_json_1 = require("../package.json");
-const os_1 = __importDefault(require("os"));
+const userAgentHelper_1 = require("./userAgentHelper");
+const scopeHelper_1 = require("./scopeHelper");
+const responses_1 = require("./responses");
 const logger = (0, logger_1.debug)('copilot-studio:client');
 /**
  * Client for interacting with Microsoft Copilot Studio services.
@@ -32,6 +30,16 @@ class CopilotStudioClient {
         this.settings = settings;
         this.token = token;
     }
+    /**
+     * Logs a diagnostic message if diagnostics are enabled.
+     * @param message The message to log.
+     * @param args Additional arguments to log.
+     */
+    logDiagnostic(message, ...args) {
+        if (this.settings.enableDiagnostics) {
+            logger.info(`[DIAGNOSTICS] ${message}`, ...args);
+        }
+    }
     /**
      * Streams activities from the Copilot Studio service using eventsource-client.
      * @param url The connection URL for Copilot Studio.
@@ -41,13 +49,16 @@ class CopilotStudioClient {
      */
     async *postRequestAsync(url, body, method = 'POST') {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        this.logDiagnostic(`Request URL: ${url}`);
+        this.logDiagnostic(`Request Method: ${method}`);
+        this.logDiagnostic('Request Body:', body ? JSON.stringify(body, null, 2) : 'none');
         logger.debug(`>>> SEND TO ${url}`);
         const streamMap = new Map();
         const eventSource = (0, eventsource_client_1.createEventSource)({
             url,
             headers: {
                 Authorization: `Bearer ${this.token}`,
-                'User-Agent': CopilotStudioClient.getProductInfo(),
+                'User-Agent': userAgentHelper_1.UserAgentHelper.getProductInfo(),
                 'Content-Type': 'application/json',
                 Accept: 'text/event-stream'
             },
@@ -121,24 +132,6 @@ class CopilotStudioClient {
             eventSource.close();
         }
     }
-    /**
-     * Appends this package.json version to the User-Agent header.
-     * - For browser environments, it includes the user agent of the browser.
-     * - For Node.js environments, it includes the Node.js version, platform, architecture, and release.
-     * @returns A string containing the product information, including version and user agent.
-     */
-    static getProductInfo() {
-        const versionString = `CopilotStudioClient.agents-sdk-js/${package_json_1.version}`;
-        let userAgent;
-        if (typeof window !== 'undefined' && window.navigator) {
-            userAgent = `${versionString} ${navigator.userAgent}`;
-        }
-        else {
-            userAgent = `${versionString} nodejs/${process.version} ${os_1.default.platform()}-${os_1.default.arch()}/${os_1.default.release()}`;
-        }
-        logger.debug(`User-Agent: ${userAgent}`);
-        return userAgent;
-    }
     processResponseHeaders(responseHeaders) {
         var _a, _b;
         if (this.settings.useExperimentalEndpoint && !((_a = this.settings.directConnectUrl) === null || _a === void 0 ? void 0 : _a.trim())) {
@@ -158,17 +151,35 @@ class CopilotStudioClient {
                 sanitizedHeaders.set(key, value);
             }
         });
-        logger.debug('Headers received:', sanitizedHeaders);
+        this.logDiagnostic('Response Headers:', sanitizedHeaders);
     }
     /**
-     * Starts a new conversation with the Copilot Studio service.
-     * @param emitStartConversationEvent Whether to emit a start conversation event. Defaults to true.
-     * @returns An async generator yielding the Agent's Activities.
+     * Implementation of startConversationStreaming with overloads.
      */
-    async *startConversationStreaming(emitStartConversationEvent = true) {
-        const uriStart = (0, powerPlatformEnvironment_1.getCopilotStudioConnectionUrl)(this.settings);
-        const body = { emitStartConversationEvent };
-        logger.info('Starting conversation ...');
+    async *startConversationStreaming(requestOrFlag) {
+        var _a;
+        // Normalize input to StartRequest
+        let request;
+        if (typeof requestOrFlag === 'boolean' || requestOrFlag === undefined) {
+            // Legacy call: startConversationStreaming(true/false)
+            request = {
+                emitStartConversationEvent: requestOrFlag !== null && requestOrFlag !== void 0 ? requestOrFlag : true
+            };
+        }
+        else {
+            // New call: startConversationStreaming({ locale: 'en-US', ... })
+            request = requestOrFlag;
+        }
+        const uriStart = (0, powerPlatformEnvironment_1.getCopilotStudioConnectionUrl)(this.settings, request.conversationId);
+        const body = {
+            emitStartConversationEvent: (_a = request.emitStartConversationEvent) !== null && _a !== void 0 ? _a : true
+        };
+        // Add locale to body if provided
+        if (request.locale) {
+            body.locale = request.locale;
+        }
+        logger.info('Starting conversation ...', request);
+        this.logDiagnostic('Start conversation request:', body);
         yield* this.postRequestAsync(uriStart, body, 'POST');
     }
     /**
@@ -186,14 +197,48 @@ class CopilotStudioClient {
         yield* this.postRequestAsync(uriExecute, qbody, 'POST');
     }
     /**
-     * Starts a new conversation with the Copilot Studio service.
-     * @param emitStartConversationEvent Whether to emit a start conversation event. Defaults to true.
+     * Executes a turn in an existing conversation by sending an activity.
+     * This method provides explicit control over the conversation ID.
+     * @param activity The activity to send.
+     * @param conversationId The ID of the conversation. Required.
+     * @returns An async generator yielding the Agent's Activities.
+     * @throws Error if conversationId is not provided.
+     */
+    async *executeStreaming(activity, conversationId) {
+        if (!conversationId || !conversationId.trim()) {
+            throw new Error('conversationId is required for executeStreaming');
+        }
+        const uriExecute = (0, powerPlatformEnvironment_1.getCopilotStudioConnectionUrl)(this.settings, conversationId);
+        const request = new executeTurnRequest_1.ExecuteTurnRequest(activity, conversationId);
+        logger.info('Executing turn with conversation ID:', conversationId);
+        this.logDiagnostic('Execute turn request:', {
+            conversationId,
+            activityType: activity.type,
+            activityText: activity.text
+        });
+        yield* this.postRequestAsync(uriExecute, request, 'POST');
+    }
+    /**
+     * Executes a turn in an existing conversation by sending an activity.
+     * @param activity The activity to send.
+     * @param conversationId The ID of the conversation. Required.
      * @returns A promise yielding an array of activities.
-     * @deprecated Use startConversationStreaming instead.
+     * @throws Error if conversationId is not provided.
+     * @deprecated Use executeStreaming instead.
      */
-    async startConversationAsync(emitStartConversationEvent = true) {
+    async execute(activity, conversationId) {
         const result = [];
-        for await (const value of this.startConversationStreaming(emitStartConversationEvent)) {
+        for await (const value of this.executeStreaming(activity, conversationId)) {
+            result.push(value);
+        }
+        return result;
+    }
+    /**
+     * Implementation of startConversationAsync with overloads.
+     */
+    async startConversationAsync(requestOrFlag) {
+        const result = [];
+        for await (const value of this.startConversationStreaming(requestOrFlag)) {
             result.push(value);
         }
         return result;
@@ -236,6 +281,98 @@ class CopilotStudioClient {
         }
         return result;
     }
+    /**
+     * Starts a new conversation and returns a typed response.
+     * @param request The request parameters for starting the conversation.
+     * @returns A promise yielding a StartResponse with activities and conversation metadata.
+     */
+    async startConversationWithResponse(request) {
+        var _a;
+        const activities = [];
+        let finalConversationId = '';
+        for await (const activity of this.startConversationStreaming(request)) {
+            activities.push(activity);
+            if ((_a = activity.conversation) === null || _a === void 0 ? void 0 : _a.id) {
+                finalConversationId = activity.conversation.id;
+            }
+        }
+        // Fall back to instance conversationId if not found in activities
+        finalConversationId = finalConversationId || this.conversationId;
+        return (0, responses_1.createStartResponse)(activities, finalConversationId);
+    }
+    /**
+     * Executes a turn and returns a typed response.
+     * @param activity The activity to send.
+     * @param conversationId The conversation ID.
+     * @returns A promise yielding an ExecuteTurnResponse with activities and metadata.
+     */
+    async executeWithResponse(activity, conversationId) {
+        const activities = [];
+        for await (const value of this.executeStreaming(activity, conversationId)) {
+            activities.push(value);
+        }
+        return (0, responses_1.createExecuteTurnResponse)(activities, conversationId);
+    }
+    /**
+     * Subscribes to a conversation to receive events via Server-Sent Events (SSE).
+     * This method allows resumption from a specific event ID.
+     * @param conversationId The ID of the conversation to subscribe to.
+     * @param lastReceivedEventId Optional. The last received event ID for resumption.
+     * @returns An async generator yielding SubscribeEvent objects containing activities and event IDs.
+     */
+    async *subscribeAsync(conversationId, lastReceivedEventId) {
+        if (!conversationId || !conversationId.trim()) {
+            throw new Error('conversationId is required for subscribeAsync');
+        }
+        const url = (0, powerPlatformEnvironment_1.getCopilotStudioSubscribeUrl)(this.settings, conversationId);
+        logger.info('Subscribing to conversation:', conversationId);
+        this.logDiagnostic('Subscribe request:', { conversationId, lastReceivedEventId, url });
+        const eventSource = (0, eventsource_client_1.createEventSource)({
+            url,
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                'User-Agent': userAgentHelper_1.UserAgentHelper.getProductInfo(),
+                Accept: 'text/event-stream',
+                ...(lastReceivedEventId && { 'Last-Event-ID': lastReceivedEventId })
+            },
+            method: 'GET',
+            fetch: async (url, init) => {
+                const response = await fetch(url, init);
+                this.processResponseHeaders(response.headers);
+                return response;
+            }
+        });
+        try {
+            for await (const { data, event, id } of eventSource) {
+                if (data && event === 'activity') {
+                    try {
+                        const activity = agents_activity_1.Activity.fromJson(data);
+                        const subscribeEvent = {
+                            activity,
+                            eventId: id
+                        };
+                        logger.debug(`Received activity via subscription, event ID: ${id}`);
+                        this.logDiagnostic('Subscribe event received:', { eventId: id, activityType: activity.type });
+                        yield subscribeEvent;
+                    }
+                    catch (error) {
+                        logger.error('Failed to parse activity in subscription:', error);
+                    }
+                }
+                else if (event === 'end') {
+                    logger.debug('Subscription stream complete');
+                    break;
+                }
+                if (eventSource.readyState === 'closed') {
+                    logger.debug('Subscription connection closed');
+                    break;
+                }
+            }
+        }
+        finally {
+            eventSource.close();
+        }
+    }
 }
 exports.CopilotStudioClient = CopilotStudioClient;
 /** Header key for conversation ID. */
@@ -247,6 +384,7 @@ CopilotStudioClient.islandExperimentalUrlHeaderKey = 'x-ms-d2e-experimental';
  * This is used for authentication token audience configuration.
  * @param settings Copilot Studio connection settings.
  * @returns The scope URL for token audience.
+ * @deprecated Use ScopeHelper.getScopeFromSettings instead.
  */
-CopilotStudioClient.scopeFromSettings = powerPlatformEnvironment_1.getTokenAudience;
+CopilotStudioClient.scopeFromSettings = scopeHelper_1.ScopeHelper.getScopeFromSettings;
 //# sourceMappingURL=copilotStudioClient.js.map

package/dist/src/copilotStudioClient.js.map

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

package/dist/src/copilotStudioConnectionSettings.d.ts

@@ -27,6 +27,12 @@ export interface CopilotStudioConnectionSettings {
     directConnectUrl?: string;
     /** Directs Copilot Studio Client to use the experimental endpoint if available. Default value is false. */
     useExperimentalEndpoint?: boolean;
+    /**
+     * Enables diagnostic logging for debugging purposes.
+     * When enabled, detailed logs about requests, responses, and connection status will be emitted.
+     * Default value is false.
+     */
+    enableDiagnostics?: boolean;
     /**
      * The login authority to use for the connection.
      * @deprecated This property will not be supported in future versions. Handle the auth properties in the agent.

package/dist/src/copilotStudioWebChat.d.ts

@@ -18,6 +18,30 @@ export interface CopilotStudioWebChatSettings {
      * @default false
      */
     showTyping?: boolean;
+    /**
+     * An existing conversation ID to resume. When provided, the connection will
+     * send subsequent messages to this conversation instead of starting a new one.
+     *
+     * By default, providing a conversationId will skip the initial
+     * `startConversationStreaming()` call. Override this with the
+     * `startConversation` setting.
+     *
+     * **Note:** The server does not validate conversation IDs. A non-existent
+     * GUID will silently create a new conversation under that ID, while a
+     * non-GUID string may cause the server to return no response. Only pass
+     * IDs that were previously captured from a real conversation.
+     */
+    conversationId?: string;
+    /**
+     * Controls whether `startConversationStreaming()` is called when the
+     * connection is first subscribed to.
+     *
+     * - `undefined` (default): starts a new conversation only when no
+     *   `conversationId` is provided (`!conversationId`).
+     * - `true`: always starts a conversation, even when resuming.
+     * - `false`: never starts a conversation, even for new connections.
+     */
+    startConversation?: boolean;
 }
 /**
  * Represents a connection interface for integrating Copilot Studio with WebChat.
@@ -50,6 +74,12 @@ export interface CopilotStudioWebChatConnection {
      * - Standard Bot Framework Activity properties (type, text, attachments, etc.)
      */
     activity$: Observable<Partial<Activity>>;
+    /**
+     * The active conversation ID. Set from `CopilotStudioWebChatSettings.conversationId`
+     * when resuming, or captured from the first response activity for new conversations.
+     * Returns `undefined` until a conversation has been established.
+     */
+    readonly conversationId: string | undefined;
     /**
      * Posts a user activity to the Copilot Studio service and returns an observable
      * that emits the activity ID once the message is successfully sent.

package/dist/src/copilotStudioWebChat.js

@@ -140,31 +140,47 @@ class CopilotStudioWebChat {
      * ```
      */
     static createConnection(client, settings) {
+        var _a;
         logger.info('--> Creating connection between Copilot Studio and WebChat ...');
+        const normalizedConversationId = (settings === null || settings === void 0 ? void 0 : settings.conversationId) && settings.conversationId.trim() !== ''
+            ? settings.conversationId.trim()
+            : undefined;
+        const shouldStart = (_a = settings === null || settings === void 0 ? void 0 : settings.startConversation) !== null && _a !== void 0 ? _a : !normalizedConversationId;
         let sequence = 0;
         let activitySubscriber;
         let conversation;
+        let activeConversationId = normalizedConversationId;
+        let ended = false;
+        let started = false;
         const connectionStatus$ = new rxjs_1.BehaviorSubject(0);
         const activity$ = createObservable(async (subscriber) => {
+            var _a;
             activitySubscriber = subscriber;
             const handleAcknowledgementOnce = once(async () => {
                 connectionStatus$.next(2);
                 await Promise.resolve(); // Webchat requires an extra tick to process the connection status change
             });
+            // When resuming (shouldStart === false), transition straight to connected
+            if (!shouldStart || started) {
+                await handleAcknowledgementOnce();
+                return;
+            }
+            started = true;
             logger.debug('--> Connection established.');
             notifyTyping();
-            if (connectionStatus$.value < 2) {
-                for await (const activity of client.startConversationStreaming()) {
-                    delete activity.replyToId;
-                    if (!conversation && activity.conversation) {
-                        conversation = activity.conversation;
-                        await handleAcknowledgementOnce();
-                    }
-                    notifyActivity(activity);
+            for await (const activity of client.startConversationStreaming()) {
+                delete activity.replyToId;
+                if (!conversation && activity.conversation) {
+                    conversation = activity.conversation;
+                }
+                if ((_a = activity.conversation) === null || _a === void 0 ? void 0 : _a.id) {
+                    activeConversationId = activity.conversation.id;
                 }
-                // If no activities received from bot, we should still acknowledge.
                 await handleAcknowledgementOnce();
+                notifyActivity(activity);
             }
+            // If no activities received from bot, we should still acknowledge.
+            await handleAcknowledgementOnce();
         });
         const notifyActivity = (activity) => {
             const newActivity = {
@@ -191,15 +207,22 @@ class CopilotStudioWebChat {
         return {
             connectionStatus$,
             activity$,
+            get conversationId() {
+                return activeConversationId;
+            },
             postActivity(activity) {
                 logger.info('--> Preparing to send activity to Copilot Studio ...');
                 if (!activity) {
                     throw new Error('Activity cannot be null.');
                 }
+                if (ended) {
+                    throw new Error('Connection has been ended.');
+                }
                 if (!activitySubscriber) {
                     throw new Error('Activity subscriber is not initialized.');
                 }
                 return createObservable(async (subscriber) => {
+                    var _a;
                     try {
                         logger.info('--> Sending activity to Copilot Studio ...');
                         const newActivity = agents_activity_1.Activity.fromObject({
@@ -211,8 +234,11 @@ class CopilotStudioWebChat {
                         notifyTyping();
                         // Notify WebChat immediately that the message was sent
                         subscriber.next(newActivity.id);
-                        // Stream the agent's response, but don't block the UI
-                        for await (const responseActivity of client.sendActivityStreaming(newActivity)) {
+                        // Stream the agent's response, passing activeConversationId for URL routing
+                        for await (const responseActivity of client.sendActivityStreaming(newActivity, activeConversationId)) {
+                            if (!activeConversationId && ((_a = responseActivity.conversation) === null || _a === void 0 ? void 0 : _a.id)) {
+                                activeConversationId = responseActivity.conversation.id;
+                            }
                             notifyActivity(responseActivity);
                             logger.info('<-- Activity received correctly from Copilot Studio.');
                         }
@@ -226,6 +252,7 @@ class CopilotStudioWebChat {
             },
             end() {
                 logger.info('--> Ending connection between Copilot Studio and WebChat ...');
+                ended = true;
                 connectionStatus$.complete();
                 if (activitySubscriber) {
                     activitySubscriber.complete();