@microsoft/agents-hosting 1.5.0-beta.6.ga236d9a19c → 1.5.1

package/dist/src/app/proactive/proactive.d.ts

@@ -0,0 +1,248 @@
+import type { Activity } from '@microsoft/agents-activity';
+import type { ResourceResponse } from '../../connector-client';
+import type { BaseAdapter } from '../../baseAdapter';
+import type { TurnContext } from '../../turnContext';
+import type { TurnState } from '../turnState';
+import type { RouteHandler } from '../routeHandler';
+import type { AgentApplication } from '../agentApplication';
+import type { ProactiveOptions } from './proactiveOptions';
+import type { CreateConversationOptions } from './createConversationOptions';
+import { Conversation } from './conversation';
+/**
+ * Provides methods for storing, retrieving, and managing conversation references to enable
+ * proactive messaging scenarios. Supports sending activities and continuing conversations outside
+ * the standard request/response flow using stored conversation references.
+ *
+ * @remarks
+ * Use the `Proactive` class to implement scenarios where an agent needs to initiate conversations
+ * or send messages to users without an incoming activity, such as notifications or scheduled alerts.
+ * Some operations require that conversation references be stored using {@link storeConversation}
+ * before they can be used.
+ *
+ * Access via `app.proactive` after configuring `proactive` in {@link AgentApplicationOptions}.
+ */
+export declare class Proactive<TState extends TurnState> {
+    /**
+     * `activity.valueType` that indicates additional key/values for the ContinueConversation event.
+     */
+    static readonly ContinueConversationValueType = "application/vnd.microsoft.activity.continueconversation+json";
+    private readonly _app;
+    private readonly _options;
+    private readonly _storage?;
+    constructor(app: AgentApplication<TState>, options: ProactiveOptions);
+    private requireStorage;
+    private requireAppStorage;
+    /**
+     * Stores the current conversation reference from a live {@link TurnContext} in proactive storage.
+     *
+     * @param context - The context object for the current turn, containing activity and conversation
+     *   information.
+     * @returns The conversation ID that can be used to retrieve the reference in future operations.
+     * @example
+     * ```typescript
+     * // Inside an onMessage handler — save the conversation so we can message later
+     * app.onActivity('message', async (ctx, state) => {
+     *   const convId = await app.proactive.storeConversation(ctx)
+     *   await ctx.sendActivity(`Conversation stored. ID: ${convId}`)
+     * })
+     * ```
+     */
+    storeConversation(context: TurnContext): Promise<string>;
+    /**
+     * Stores an explicit {@link Conversation} object in proactive storage.
+     *
+     * @param conversation - The conversation reference record to store.
+     * @returns The conversation ID that can be used to retrieve the reference in future operations.
+     * @throws If the conversation fails validation (missing `conversation.id`, `serviceUrl`, or
+     *   `claims.aud`).
+     * @example
+     * ```typescript
+     * // Build a Conversation manually and store it
+     * const conv = ConversationBuilder
+     *   .create('my-app-id', 'msteams')
+     *   .withUser('user-aad-id')
+     *   .withConversationId('19:existing-thread-id@thread.tacv2')
+     *   .build()
+     * const convId = await app.proactive.storeConversation(conv)
+     * ```
+     */
+    storeConversation(conversation: Conversation): Promise<string>;
+    /**
+     * Retrieves the stored {@link Conversation} associated with the given conversation ID.
+     *
+     * @param conversationId - The unique identifier of the conversation to retrieve.
+     * @returns The stored `Conversation`, or `undefined` if no record exists for that ID.
+     * @example
+     * ```typescript
+     * const conv = await app.proactive.getConversation(convId)
+     * if (conv) {
+     *   await app.proactive.sendActivity(adapter, conv, { text: 'Hello!' })
+     * }
+     * ```
+     */
+    getConversation(conversationId: string): Promise<Conversation | undefined>;
+    /**
+     * Retrieves the stored {@link Conversation} for the given ID, throwing if no record is found.
+     *
+     * @param conversationId - The unique identifier of the conversation to retrieve.
+     * @returns The stored `Conversation`.
+     * @throws `Error` if no conversation reference is found for the specified ID.
+     * @example
+     * ```typescript
+     * // Use when absence of the conversation should be treated as an error
+     * const conv = await app.proactive.getConversationOrThrow(convId)
+     * await app.proactive.sendActivity(adapter, conv, { text: 'Alert: your report is ready.' })
+     * ```
+     */
+    getConversationOrThrow(conversationId: string): Promise<Conversation>;
+    /**
+     * Deletes the stored conversation reference for the given conversation ID.
+     *
+     * @param conversationId - The unique identifier of the conversation whose reference should be
+     *   deleted.
+     * @remarks If no record exists for the given ID, no action is taken.
+     * @example
+     * ```typescript
+     * // Clean up after a conversation has ended
+     * app.onActivity('endOfConversation', async (ctx, state) => {
+     *   await app.proactive.deleteConversation(ctx.activity.conversation.id)
+     * })
+     * ```
+     */
+    deleteConversation(conversationId: string): Promise<void>;
+    /**
+     * Sends an activity to a stored conversation, looking it up by ID.
+     *
+     * @param adapter - The channel adapter used to send the activity.
+     * @param conversationId - The ID of a conversation previously stored via {@link storeConversation}.
+     * @param activity - The activity to send. If `type` is not set it defaults to `'message'`.
+     * @returns A {@link ResourceResponse} with the ID of the sent activity.
+     * @throws `Error` if no conversation reference is found for the specified ID.
+     * @example
+     * ```typescript
+     * // Send a notification using a previously stored conversation ID
+     * await app.proactive.sendActivity(adapter, storedConvId, { text: 'Your order has shipped!' })
+     * ```
+     */
+    sendActivity(adapter: BaseAdapter, conversationId: string, activity: Partial<Activity>): Promise<ResourceResponse>;
+    /**
+     * Sends an activity to an existing conversation using the provided {@link Conversation} reference.
+     *
+     * @param adapter - The channel adapter used to send the activity.
+     * @param conversation - A `Conversation` instance created via its constructor or
+     *   {@link ConversationBuilder}.
+     * @param activity - The activity to send. If `type` is not set it defaults to `'message'`.
+     * @returns A {@link ResourceResponse} with the ID of the sent activity.
+     * @example
+     * ```typescript
+     * // Build a Conversation from a stored reference and send a message
+     * const conv = await app.proactive.getConversationOrThrow(convId)
+     * const response = await app.proactive.sendActivity(adapter, conv, { text: 'Hello from the agent!' })
+     * console.log('Sent activity ID:', response.id)
+     * ```
+     */
+    sendActivity(adapter: BaseAdapter, conversation: Conversation, activity: Partial<Activity>): Promise<ResourceResponse>;
+    /**
+     * Continues a stored conversation by executing the given handler within the context of that
+     * conversation, looking it up by ID.
+     *
+     * See the {@link Conversation} overload for full details.
+     *
+     * @param adapter - The channel adapter used to continue the conversation.
+     * @param conversationId - The ID of a conversation previously stored via {@link storeConversation}.
+     * @param handler - The route handler to execute within the continued conversation context.
+     * @param autoSignInHandlers - Optional list of OAuth connection names whose tokens should be
+     *   acquired before invoking the handler.
+     * @param continuationActivity - Optional activity fields merged into the continuation activity,
+     *   making them available on `ctx.activity` inside the handler (e.g. `value`, `valueType`).
+     * @throws `Error` if no conversation reference is found for the specified ID.
+     * @example
+     * ```typescript
+     * // Scheduled job: send a daily digest to all stored conversations
+     * for (const convId of storedIds) {
+     *   await app.proactive.continueConversation(adapter, convId, async (ctx, state) => {
+     *     await ctx.sendActivity('Here is your daily digest...')
+     *   })
+     * }
+     * ```
+     */
+    continueConversation(adapter: BaseAdapter, conversationId: string, handler: RouteHandler<TState>, autoSignInHandlers?: string[], continuationActivity?: Partial<Activity>): Promise<void>;
+    /**
+     * Continues an existing conversation by executing the given handler within the context of the
+     * provided {@link Conversation} reference. The handler receives a {@link TurnContext} and a
+     * freshly loaded {@link TurnState} scoped to the original conversation, enabling the agent to
+     * respond as if replying to an incoming activity.
+     *
+     * @remarks
+     * Exceptions thrown inside the handler are captured and re-thrown after the adapter callback
+     * completes, since the adapter would otherwise silently swallow them.
+     *
+     * If `autoSignInHandlers` are supplied and the application has user authorization configured,
+     * tokens are acquired before the handler is called. If not all tokens are available and
+     * `proactiveOptions.failOnUnsignedInConnections` is not `false`, an error is thrown.
+     *
+     * @param adapter - The channel adapter used to continue the conversation.
+     * @param conversation - A `Conversation` instance created via its constructor or
+     *   {@link ConversationBuilder}.
+     * @param handler - The route handler to execute within the continued conversation context.
+     * @param autoSignInHandlers - Optional list of OAuth connection names whose tokens should be
+     *   acquired before invoking the handler.
+     * @param continuationActivity - Optional activity fields merged into the continuation activity,
+     *   making them available on `ctx.activity` inside the handler (e.g. `value`, `valueType`).
+     * @example
+     * ```typescript
+     * // Continue a conversation with a custom value payload
+     * const conv = await app.proactive.getConversationOrThrow(convId)
+     * await app.proactive.continueConversation(
+     *   adapter,
+     *   conv,
+     *   async (ctx, state) => {
+     *     const payload = ctx.activity.value as { alertType: string }
+     *     await ctx.sendActivity(`Alert triggered: ${payload.alertType}`)
+     *   },
+     *   undefined,
+     *   { value: { alertType: 'threshold-exceeded' }, valueType: Proactive.ContinueConversationValueType }
+     * )
+     * ```
+     */
+    continueConversation(adapter: BaseAdapter, conversation: Conversation, handler: RouteHandler<TState>, autoSignInHandlers?: string[], continuationActivity?: Partial<Activity>): Promise<void>;
+    /**
+     * Creates a new conversation using the specified channel adapter and conversation options.
+     *
+     * @remarks
+     * This wraps `CloudAdapter.createConversationAsync()`, which requires real network connectivity
+     * and authentication. The provided adapter must implement
+     * `createConversationAsync()`; a `TypeError` is thrown if it does not.
+     *
+     * If `createOptions.storeConversation` is `true`, the resulting {@link Conversation} is
+     * automatically stored via {@link storeConversation} so it can be retrieved by ID later.
+     *
+     * If a `handler` is provided it is executed within the newly created conversation, giving the
+     * agent a chance to send an initial message or load state.
+     *
+     * @param adapter - The channel adapter used to create the conversation. Must implement
+     *   `createConversationAsync()` (i.e. a `CloudAdapter` instance).
+     * @param createOptions - Details required to create the conversation, including identity, channel,
+     *   service URL, OAuth scope, and `ConversationParameters`. Build with
+     *   {@link CreateConversationOptionsBuilder}.
+     * @param handler - Optional route handler executed immediately after the conversation is created.
+     * @returns The newly created {@link Conversation}.
+     * @throws `TypeError` if the adapter does not implement `createConversationAsync()`.
+     * @example
+     * ```typescript
+     * // Initiate a new 1:1 conversation with a Teams user and send a welcome message
+     * const opts = CreateConversationOptionsBuilder
+     *   .create(process.env.APP_ID!, 'msteams')
+     *   .withUser('user-aad-object-id')
+     *   .withTenantId('tenant-id')
+     *   .storeConversation(true)
+     *   .build()
+     *
+     * const conv = await app.proactive.createConversation(adapter, opts, async (ctx, state) => {
+     *   await ctx.sendActivity('Hi! I have an update for you.')
+     * })
+     * console.log('New conversation ID:', conv.reference.conversation.id)
+     * ```
+     */
+    createConversation(adapter: BaseAdapter, createOptions: CreateConversationOptions, handler?: RouteHandler<TState>): Promise<Conversation>;
+}

package/dist/src/app/proactive/proactive.js

@@ -0,0 +1,310 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Proactive = void 0;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const conversation_1 = require("./conversation");
+const agents_telemetry_1 = require("@microsoft/agents-telemetry");
+const errorHelper_1 = require("../../errorHelper");
+const traces_1 = require("../../observability/traces");
+const logger = (0, agents_telemetry_1.debug)('agents:proactive');
+const STORAGE_KEY_PREFIX = 'proactive/conversations/';
+/**
+ * Provides methods for storing, retrieving, and managing conversation references to enable
+ * proactive messaging scenarios. Supports sending activities and continuing conversations outside
+ * the standard request/response flow using stored conversation references.
+ *
+ * @remarks
+ * Use the `Proactive` class to implement scenarios where an agent needs to initiate conversations
+ * or send messages to users without an incoming activity, such as notifications or scheduled alerts.
+ * Some operations require that conversation references be stored using {@link storeConversation}
+ * before they can be used.
+ *
+ * Access via `app.proactive` after configuring `proactive` in {@link AgentApplicationOptions}.
+ */
+class Proactive {
+    constructor(app, options) {
+        this._app = app;
+        this._options = options;
+        this._storage = options.storage;
+    }
+    requireStorage() {
+        if (!this._storage) {
+            throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.ProactiveStorageRequired);
+        }
+        return this._storage;
+    }
+    requireAppStorage() {
+        const storage = this._app.options.storage;
+        if (!storage) {
+            throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.ProactiveAppStorageRequired);
+        }
+        return storage;
+    }
+    async storeConversation(contextOrConversation) {
+        return (0, agents_telemetry_1.trace)(traces_1.ProactiveTraceDefinitions.storeConversation, async ({ record }) => {
+            const conv = contextOrConversation instanceof conversation_1.Conversation
+                ? contextOrConversation
+                : new conversation_1.Conversation(contextOrConversation);
+            conv.validate();
+            const id = conv.reference.conversation.id;
+            record({ conversationId: id });
+            await this.requireStorage().write({ [`${STORAGE_KEY_PREFIX}${id}`]: { reference: conv.reference, claims: conv.claims } });
+            return id;
+        });
+    }
+    /**
+     * Retrieves the stored {@link Conversation} associated with the given conversation ID.
+     *
+     * @param conversationId - The unique identifier of the conversation to retrieve.
+     * @returns The stored `Conversation`, or `undefined` if no record exists for that ID.
+     * @example
+     * ```typescript
+     * const conv = await app.proactive.getConversation(convId)
+     * if (conv) {
+     *   await app.proactive.sendActivity(adapter, conv, { text: 'Hello!' })
+     * }
+     * ```
+     */
+    async getConversation(conversationId) {
+        return (0, agents_telemetry_1.trace)(traces_1.ProactiveTraceDefinitions.getConversation, async ({ record }) => {
+            record({ conversationId });
+            const result = await this.requireStorage().read([`${STORAGE_KEY_PREFIX}${conversationId}`]);
+            const stored = result[`${STORAGE_KEY_PREFIX}${conversationId}`];
+            if (!stored) {
+                record({ found: false });
+                return undefined;
+            }
+            record({ found: true });
+            return new conversation_1.Conversation(stored.claims, stored.reference);
+        });
+    }
+    /**
+     * Retrieves the stored {@link Conversation} for the given ID, throwing if no record is found.
+     *
+     * @param conversationId - The unique identifier of the conversation to retrieve.
+     * @returns The stored `Conversation`.
+     * @throws `Error` if no conversation reference is found for the specified ID.
+     * @example
+     * ```typescript
+     * // Use when absence of the conversation should be treated as an error
+     * const conv = await app.proactive.getConversationOrThrow(convId)
+     * await app.proactive.sendActivity(adapter, conv, { text: 'Alert: your report is ready.' })
+     * ```
+     */
+    async getConversationOrThrow(conversationId) {
+        return (0, agents_telemetry_1.trace)(traces_1.ProactiveTraceDefinitions.getConversationOrThrow, async ({ record }) => {
+            record({ conversationId });
+            const conv = await this.getConversation(conversationId);
+            if (!conv) {
+                throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.ProactiveConversationNotFound, undefined, { conversationId });
+            }
+            return conv;
+        });
+    }
+    /**
+     * Deletes the stored conversation reference for the given conversation ID.
+     *
+     * @param conversationId - The unique identifier of the conversation whose reference should be
+     *   deleted.
+     * @remarks If no record exists for the given ID, no action is taken.
+     * @example
+     * ```typescript
+     * // Clean up after a conversation has ended
+     * app.onActivity('endOfConversation', async (ctx, state) => {
+     *   await app.proactive.deleteConversation(ctx.activity.conversation.id)
+     * })
+     * ```
+     */
+    async deleteConversation(conversationId) {
+        return (0, agents_telemetry_1.trace)(traces_1.ProactiveTraceDefinitions.deleteConversation, async ({ record }) => {
+            record({ conversationId });
+            await this.requireStorage().delete([`${STORAGE_KEY_PREFIX}${conversationId}`]);
+        });
+    }
+    async sendActivity(adapter, conversationOrId, activity) {
+        return (0, agents_telemetry_1.trace)(traces_1.ProactiveTraceDefinitions.sendActivity, async ({ record }) => {
+            var _a;
+            const conv = typeof conversationOrId === 'string'
+                ? await this.getConversationOrThrow(conversationOrId)
+                : conversationOrId;
+            const activityToSend = { type: 'message', ...activity };
+            record({
+                conversationId: conv.reference.conversation.id,
+                channelId: conv.reference.channelId,
+                activityType: (_a = activityToSend.type) !== null && _a !== void 0 ? _a : 'message',
+            });
+            logger.info('sendActivity: conversation=%s channel=%s serviceUrl=%s', conv.reference.conversation.id, conv.reference.channelId, conv.reference.serviceUrl);
+            let response;
+            let caughtError;
+            await adapter.continueConversation(conv.identity, conv.reference, async (ctx) => {
+                try {
+                    const result = await ctx.sendActivity(activityToSend);
+                    response = result;
+                }
+                catch (err) {
+                    caughtError = err;
+                }
+            });
+            if (caughtError !== undefined) {
+                logger.warn('sendActivity: failed for conversation=%s: %s', conv.reference.conversation.id, caughtError);
+                throw caughtError;
+            }
+            if (response === undefined)
+                throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.ProactiveSendActivityNoResponse);
+            logger.debug('sendActivity: sent activity id=%s', response.id);
+            return response;
+        });
+    }
+    async continueConversation(adapter, conversationOrId, handler, autoSignInHandlers, continuationActivity) {
+        return (0, agents_telemetry_1.trace)(traces_1.ProactiveTraceDefinitions.continueConversation, async ({ record }) => {
+            const conv = typeof conversationOrId === 'string'
+                ? await this.getConversationOrThrow(conversationOrId)
+                : conversationOrId;
+            record({
+                conversationId: conv.reference.conversation.id,
+                channelId: conv.reference.channelId,
+                hasAutoSignIn: !!(autoSignInHandlers === null || autoSignInHandlers === void 0 ? void 0 : autoSignInHandlers.length),
+            });
+            logger.info('continueConversation: conversation=%s channel=%s serviceUrl=%s', conv.reference.conversation.id, conv.reference.channelId, conv.reference.serviceUrl);
+            let caughtError;
+            await adapter.continueConversation(conv.identity, conv.reference, async (ctx) => {
+                var _a, _b;
+                try {
+                    // Merge caller-supplied activity fields (e.g. value, valueType) into the
+                    // continuation activity so the handler can read request-time parameters.
+                    if (continuationActivity) {
+                        Object.assign(ctx.activity, continuationActivity);
+                    }
+                    const state = this._app.options.turnStateFactory();
+                    await state.load(ctx, this.requireAppStorage());
+                    // Token acquisition (optional — only when auth is configured)
+                    if ((autoSignInHandlers === null || autoSignInHandlers === void 0 ? void 0 : autoSignInHandlers.length) && this._app.hasUserAuthorization) {
+                        logger.debug('continueConversation: acquiring tokens for handlers: %o', autoSignInHandlers);
+                        const results = await Promise.all(autoSignInHandlers.map((handlerId) => this._app.authorization.getToken(ctx, handlerId).catch(() => ({ token: undefined }))));
+                        const allAcquired = results.every((r) => !!r.token);
+                        if (!allAcquired) {
+                            logger.warn('continueConversation: not all tokens acquired for conversation=%s handlers=%o', conv.reference.conversation.id, autoSignInHandlers);
+                            if (this._options.failOnUnsignedInConnections !== false) {
+                                throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.ProactiveNotAllTokensAcquired);
+                            }
+                        }
+                    }
+                    await handler(ctx, state);
+                    await state.save(ctx, this.requireAppStorage());
+                }
+                catch (err) {
+                    caughtError = err;
+                }
+                finally {
+                    if ((_b = (_a = ctx.streamingResponse) === null || _a === void 0 ? void 0 : _a.isStreamStarted) === null || _b === void 0 ? void 0 : _b.call(_a)) {
+                        await ctx.streamingResponse.endStream();
+                    }
+                }
+            });
+            if (caughtError !== undefined) {
+                logger.warn('continueConversation: failed for conversation=%s: %s', conv.reference.conversation.id, caughtError);
+                throw caughtError;
+            }
+            logger.debug('continueConversation: complete for conversation=%s', conv.reference.conversation.id);
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Create new conversation
+    // ---------------------------------------------------------------------------
+    /**
+     * Creates a new conversation using the specified channel adapter and conversation options.
+     *
+     * @remarks
+     * This wraps `CloudAdapter.createConversationAsync()`, which requires real network connectivity
+     * and authentication. The provided adapter must implement
+     * `createConversationAsync()`; a `TypeError` is thrown if it does not.
+     *
+     * If `createOptions.storeConversation` is `true`, the resulting {@link Conversation} is
+     * automatically stored via {@link storeConversation} so it can be retrieved by ID later.
+     *
+     * If a `handler` is provided it is executed within the newly created conversation, giving the
+     * agent a chance to send an initial message or load state.
+     *
+     * @param adapter - The channel adapter used to create the conversation. Must implement
+     *   `createConversationAsync()` (i.e. a `CloudAdapter` instance).
+     * @param createOptions - Details required to create the conversation, including identity, channel,
+     *   service URL, OAuth scope, and `ConversationParameters`. Build with
+     *   {@link CreateConversationOptionsBuilder}.
+     * @param handler - Optional route handler executed immediately after the conversation is created.
+     * @returns The newly created {@link Conversation}.
+     * @throws `TypeError` if the adapter does not implement `createConversationAsync()`.
+     * @example
+     * ```typescript
+     * // Initiate a new 1:1 conversation with a Teams user and send a welcome message
+     * const opts = CreateConversationOptionsBuilder
+     *   .create(process.env.APP_ID!, 'msteams')
+     *   .withUser('user-aad-object-id')
+     *   .withTenantId('tenant-id')
+     *   .storeConversation(true)
+     *   .build()
+     *
+     * const conv = await app.proactive.createConversation(adapter, opts, async (ctx, state) => {
+     *   await ctx.sendActivity('Hi! I have an update for you.')
+     * })
+     * console.log('New conversation ID:', conv.reference.conversation.id)
+     * ```
+     */
+    async createConversation(adapter, createOptions, handler) {
+        return (0, agents_telemetry_1.trace)(traces_1.ProactiveTraceDefinitions.createConversation, async ({ record }) => {
+            var _a, _b, _c;
+            record({
+                channelId: createOptions.channelId,
+                storeConversation: !!createOptions.storeConversation,
+                hasHandler: !!handler,
+            });
+            if (!((_a = createOptions.parameters.members) === null || _a === void 0 ? void 0 : _a.length)) {
+                throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.ProactiveMembersRequired);
+            }
+            record({ membersCount: createOptions.parameters.members.length });
+            // CloudAdapter.createConversationAsync(agentAppId, channelId, serviceUrl, audience, params, logic)
+            // The logic callback IS the handler — context is created internally by the adapter.
+            const cloudAdapter = adapter;
+            if (typeof cloudAdapter.createConversationAsync !== 'function') {
+                throw agents_activity_1.ExceptionHelper.generateException(TypeError, errorHelper_1.Errors.ProactiveCloudAdapterRequired);
+            }
+            logger.info('createConversation: channel=%s serviceUrl=%s members=%d', createOptions.channelId, createOptions.serviceUrl, (_c = (_b = createOptions.parameters.members) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0);
+            let capturedConv;
+            let caughtError;
+            await cloudAdapter.createConversationAsync(createOptions.identity.aud, createOptions.channelId, createOptions.serviceUrl, createOptions.scope, createOptions.parameters, async (ctx) => {
+                try {
+                    const conv = new conversation_1.Conversation(createOptions.identity, ctx.activity.getConversationReference());
+                    capturedConv = conv;
+                    logger.debug('createConversation: created conversation=%s', conv.reference.conversation.id);
+                    if (createOptions.storeConversation) {
+                        await this.storeConversation(conv);
+                    }
+                    if (handler) {
+                        const state = this._app.options.turnStateFactory();
+                        await state.load(ctx, this.requireAppStorage());
+                        await handler(ctx, state);
+                        await state.save(ctx, this.requireAppStorage());
+                    }
+                }
+                catch (err) {
+                    caughtError = err;
+                }
+            });
+            if (caughtError !== undefined) {
+                logger.warn('createConversation: failed for channel=%s: %s', createOptions.channelId, caughtError);
+                throw caughtError;
+            }
+            if (!capturedConv) {
+                throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.ProactiveCallbackNotInvoked);
+            }
+            return capturedConv;
+        });
+    }
+}
+exports.Proactive = Proactive;
+/**
+ * `activity.valueType` that indicates additional key/values for the ContinueConversation event.
+ */
+Proactive.ContinueConversationValueType = 'application/vnd.microsoft.activity.continueconversation+json';
+//# sourceMappingURL=proactive.js.map

package/dist/src/app/proactive/proactive.js.map

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

package/dist/src/app/proactive/proactiveOptions.d.ts

@@ -0,0 +1,19 @@
+import type { Storage } from '../../storage/storage';
+/**
+ * Configuration for the proactive messaging subsystem.
+ */
+export interface ProactiveOptions {
+    /**
+     * Storage backend for persisting conversation references.
+     *
+     * If omitted, falls back to `AgentApplicationOptions.storage`.
+     * A warning is logged when the fallback is used.
+     * Throws at initialization time if neither is configured.
+     */
+    storage?: Storage;
+    /**
+     * When `true` (default), `continueConversation()` throws if any requested
+     * token handler's user has not previously signed in.
+     */
+    failOnUnsignedInConnections?: boolean;
+}

package/dist/src/app/proactive/proactiveOptions.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=proactiveOptions.js.map

package/dist/src/app/proactive/proactiveOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proactiveOptions.js","sourceRoot":"","sources":["../../../../src/app/proactive/proactiveOptions.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC"}

package/dist/src/app/streaming/streamingResponse.js

@@ -7,8 +7,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StreamingResponse = exports.StreamingResponseResult = void 0;
 const agents_activity_1 = require("@microsoft/agents-activity");
 const citationUtil_1 = require("./citationUtil");
-const logger_1 = require("@microsoft/agents-activity/logger");
-const logger = (0, logger_1.debug)('agents:streamingResponse');
+const agents_telemetry_1 = require("@microsoft/agents-telemetry");
+const logger = (0, agents_telemetry_1.debug)('agents:streamingResponse');
 /**
  * Results for streaming response operations.
  */