@microsoft/agents-hosting-extensions-msteams 1.7.0-beta.8.gc2b086aef6

package/dist/src/channels/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./teamsChannel"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/channels/index.js.map

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

package/dist/src/channels/teamsChannel.d.ts

@@ -0,0 +1,100 @@
+import { AgentApplication, TurnState } from '@microsoft/agents-hosting';
+import type { ChannelInfo } from '@microsoft/teams.api';
+import { TeamsTurnContext } from '../teamsTurnContext';
+type ChannelUpdateHandler<TState extends TurnState> = (context: TeamsTurnContext, state: TState, data: ChannelInfo) => Promise<void>;
+/**
+ * Registers handlers for Microsoft Teams channel lifecycle and membership events.
+ *
+ * @typeParam TState - The turn state type used by the agent application.
+ */
+export declare class TeamsChannel<TState extends TurnState = TurnState> {
+    private _app;
+    /**
+     * Creates a Teams channel route helper.
+     *
+     * @param app - The agent application that receives the registered routes.
+     */
+    constructor(app: AgentApplication<TState>);
+    /**
+     * Registers a handler for any Teams channel update event.
+     *
+     * @param handler - Handler invoked with the Teams turn context, turn state, and channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onChannelEventReceived(handler: ChannelUpdateHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for Teams channel created events.
+     *
+     * @param handler - Handler invoked with the created channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onCreated(handler: ChannelUpdateHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for Teams channel deleted events.
+     *
+     * @param handler - Handler invoked with the deleted channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onDeleted(handler: ChannelUpdateHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for Teams channel renamed events.
+     *
+     * @param handler - Handler invoked with the renamed channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onRenamed(handler: ChannelUpdateHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for Teams channel restored events.
+     *
+     * @param handler - Handler invoked with the restored channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onRestored(handler: ChannelUpdateHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for Teams channel shared events.
+     *
+     * @param handler - Handler invoked with the shared channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onShared(handler: ChannelUpdateHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for Teams channel unshared events.
+     *
+     * @param handler - Handler invoked with the unshared channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onUnshared(handler: ChannelUpdateHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for member-added events in a Teams channel.
+     *
+     * @param handler - Handler invoked with channel information for the membership event.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onMemberAdded(handler: ChannelUpdateHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for member-removed events in a Teams channel.
+     *
+     * @param handler - Handler invoked with channel information for the membership event.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onMemberRemoved(handler: ChannelUpdateHandler<TState>, rank?: number, authHandlers?: string[]): this;
+}
+export {};

package/dist/src/channels/teamsChannel.js

@@ -0,0 +1,210 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamsChannel = void 0;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const agents_hosting_1 = require("@microsoft/agents-hosting");
+const activity_extensions_1 = require("../activity-extensions");
+const teamsTurnContext_1 = require("../teamsTurnContext");
+const CHANNEL_CREATED_EVENT = 'channelCreated';
+const CHANNEL_DELETED_EVENT = 'channelDeleted';
+const CHANNEL_RENAMED_EVENT = 'channelRenamed';
+const CHANNEL_RESTORED_EVENT = 'channelRestored';
+const CHANNEL_SHARED_EVENT = 'channelShared';
+const CHANNEL_UNSHARED_EVENT = 'channelUnshared';
+const CHANNEL_MEMBER_ADDED_EVENT = 'channelMemberAdded';
+const CHANNEL_MEMBER_REMOVED_EVENT = 'channelMemberRemoved';
+function isChannelUpdateEvent(context, eventType) {
+    const channelData = (0, activity_extensions_1.parseTeamsChannelData)(context.activity.channelData);
+    const actualEventType = typeof (channelData === null || channelData === void 0 ? void 0 : channelData.eventType) === 'string' ? channelData.eventType.toLowerCase() : undefined;
+    const expectedEventType = eventType === null || eventType === void 0 ? void 0 : eventType.toLowerCase();
+    return (context.activity.type === agents_activity_1.ActivityTypes.ConversationUpdate &&
+        context.activity.channelId === 'msteams' &&
+        (channelData === null || channelData === void 0 ? void 0 : channelData.channel) != null &&
+        (expectedEventType != null
+            ? actualEventType === expectedEventType
+            : (actualEventType === null || actualEventType === void 0 ? void 0 : actualEventType.startsWith('channel')) === true));
+}
+function getChannelInfo(context) {
+    return (0, activity_extensions_1.parseTeamsChannelData)(context.activity.channelData).channel;
+}
+/**
+ * Registers handlers for Microsoft Teams channel lifecycle and membership events.
+ *
+ * @typeParam TState - The turn state type used by the agent application.
+ */
+class TeamsChannel {
+    /**
+     * Creates a Teams channel route helper.
+     *
+     * @param app - The agent application that receives the registered routes.
+     */
+    constructor(app) {
+        this._app = app;
+    }
+    /**
+     * Registers a handler for any Teams channel update event.
+     *
+     * @param handler - Handler invoked with the Teams turn context, turn state, and channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onChannelEventReceived(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isChannelUpdateEvent(context));
+        };
+        const routeHandler = async (context, state) => {
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, getChannelInfo(context));
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for Teams channel created events.
+     *
+     * @param handler - Handler invoked with the created channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onCreated(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isChannelUpdateEvent(context, CHANNEL_CREATED_EVENT));
+        };
+        const routeHandler = async (context, state) => {
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, getChannelInfo(context));
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for Teams channel deleted events.
+     *
+     * @param handler - Handler invoked with the deleted channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onDeleted(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isChannelUpdateEvent(context, CHANNEL_DELETED_EVENT));
+        };
+        const routeHandler = async (context, state) => {
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, getChannelInfo(context));
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for Teams channel renamed events.
+     *
+     * @param handler - Handler invoked with the renamed channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onRenamed(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isChannelUpdateEvent(context, CHANNEL_RENAMED_EVENT));
+        };
+        const routeHandler = async (context, state) => {
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, getChannelInfo(context));
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for Teams channel restored events.
+     *
+     * @param handler - Handler invoked with the restored channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onRestored(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isChannelUpdateEvent(context, CHANNEL_RESTORED_EVENT));
+        };
+        const routeHandler = async (context, state) => {
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, getChannelInfo(context));
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for Teams channel shared events.
+     *
+     * @param handler - Handler invoked with the shared channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onShared(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isChannelUpdateEvent(context, CHANNEL_SHARED_EVENT));
+        };
+        const routeHandler = async (context, state) => {
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, getChannelInfo(context));
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for Teams channel unshared events.
+     *
+     * @param handler - Handler invoked with the unshared channel information.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onUnshared(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isChannelUpdateEvent(context, CHANNEL_UNSHARED_EVENT));
+        };
+        const routeHandler = async (context, state) => {
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, getChannelInfo(context));
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for member-added events in a Teams channel.
+     *
+     * @param handler - Handler invoked with channel information for the membership event.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onMemberAdded(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isChannelUpdateEvent(context, CHANNEL_MEMBER_ADDED_EVENT));
+        };
+        const routeHandler = async (context, state) => {
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, getChannelInfo(context));
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for member-removed events in a Teams channel.
+     *
+     * @param handler - Handler invoked with channel information for the membership event.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This channel helper for chaining.
+     */
+    onMemberRemoved(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isChannelUpdateEvent(context, CHANNEL_MEMBER_REMOVED_EVENT));
+        };
+        const routeHandler = async (context, state) => {
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, getChannelInfo(context));
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+}
+exports.TeamsChannel = TeamsChannel;
+//# sourceMappingURL=teamsChannel.js.map

package/dist/src/channels/teamsChannel.js.map

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

package/dist/src/config/config.d.ts

@@ -0,0 +1,37 @@
+import { AgentApplication, TurnState } from '@microsoft/agents-hosting';
+import type { ConfigResponse } from '@microsoft/teams.api';
+import { TeamsTurnContext } from '../teamsTurnContext';
+type ConfigHandler<TState extends TurnState> = (context: TeamsTurnContext, state: TState, configData: unknown) => Promise<ConfigResponse>;
+/**
+ * Registers handlers for Microsoft Teams app configuration invokes.
+ *
+ * @typeParam TState - The turn state type used by the agent application.
+ */
+export declare class TeamsConfig<TState extends TurnState = TurnState> {
+    private _app;
+    /**
+     * Creates a Teams configuration route helper.
+     *
+     * @param app - The agent application that receives the registered routes.
+     */
+    constructor(app: AgentApplication<TState>);
+    /**
+     * Registers a handler for Teams config/fetch invokes.
+     *
+     * @param handler - Handler invoked with the config fetch payload.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This config helper for chaining.
+     */
+    onConfigFetch(handler: ConfigHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for Teams config/submit invokes.
+     *
+     * @param handler - Handler invoked with the config submit payload.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This config helper for chaining.
+     */
+    onConfigSubmit(handler: ConfigHandler<TState>, rank?: number, authHandlers?: string[]): this;
+}
+export {};

package/dist/src/config/config.js

@@ -0,0 +1,71 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamsConfig = void 0;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const agents_hosting_1 = require("@microsoft/agents-hosting");
+const teamsTurnContext_1 = require("../teamsTurnContext");
+/**
+ * Registers handlers for Microsoft Teams app configuration invokes.
+ *
+ * @typeParam TState - The turn state type used by the agent application.
+ */
+class TeamsConfig {
+    /**
+     * Creates a Teams configuration route helper.
+     *
+     * @param app - The agent application that receives the registered routes.
+     */
+    constructor(app) {
+        this._app = app;
+    }
+    /**
+     * Registers a handler for Teams config/fetch invokes.
+     *
+     * @param handler - Handler invoked with the config fetch payload.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This config helper for chaining.
+     */
+    onConfigFetch(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(context.activity.type === agents_activity_1.ActivityTypes.Invoke &&
+                context.activity.channelId === 'msteams' &&
+                context.activity.name === 'config/fetch');
+        };
+        const routeHandler = async (context, state) => {
+            const response = await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, context.activity.value);
+            const invokeResponse = new agents_activity_1.Activity(agents_activity_1.ActivityTypes.InvokeResponse);
+            invokeResponse.value = { status: 200, body: response };
+            await context.sendActivity(invokeResponse);
+        };
+        this._app.addRoute(routeSel, routeHandler, true, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for Teams config/submit invokes.
+     *
+     * @param handler - Handler invoked with the config submit payload.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This config helper for chaining.
+     */
+    onConfigSubmit(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(context.activity.type === agents_activity_1.ActivityTypes.Invoke &&
+                context.activity.channelId === 'msteams' &&
+                context.activity.name === 'config/submit');
+        };
+        const routeHandler = async (context, state) => {
+            const response = await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, context.activity.value);
+            const invokeResponse = new agents_activity_1.Activity(agents_activity_1.ActivityTypes.InvokeResponse);
+            invokeResponse.value = { status: 200, body: response };
+            await context.sendActivity(invokeResponse);
+        };
+        this._app.addRoute(routeSel, routeHandler, true, rank, authHandlers);
+        return this;
+    }
+}
+exports.TeamsConfig = TeamsConfig;
+//# sourceMappingURL=config.js.map

package/dist/src/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/config/config.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;AAElC,gEAAoE;AACpE,8DAA4H;AAE5H,0DAAsD;AAItD;;;;GAIG;AACH,MAAa,WAAW;IAGtB;;;;OAIG;IACH,YAAa,GAA6B;QACxC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;IACjB,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CAAE,OAA8B,EAAE,OAAe,0BAAS,CAAC,WAAW,EAAE,eAAyB,EAAE;QAC9G,MAAM,QAAQ,GAAkB,CAAC,OAAoB,EAAE,EAAE;YACvD,OAAO,OAAO,CAAC,OAAO,CACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,+BAAa,CAAC,MAAM;gBAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS;gBACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CACzC,CAAA;QACH,CAAC,CAAA;QACD,MAAM,YAAY,GAAyB,KAAK,EAAE,OAAoB,EAAE,KAAa,EAAE,EAAE;YACvF,MAAM,QAAQ,GAAmB,MAAM,OAAO,CAAC,IAAI,mCAAgB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAC5G,MAAM,cAAc,GAAG,IAAI,0BAAQ,CAAC,+BAAa,CAAC,cAAc,CAAC,CAAA;YACjE,cAAc,CAAC,KAAK,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;YACtD,MAAM,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;QAC5C,CAAC,CAAA;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QACpE,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAE,OAA8B,EAAE,OAAe,0BAAS,CAAC,WAAW,EAAE,eAAyB,EAAE;QAC/G,MAAM,QAAQ,GAAkB,CAAC,OAAoB,EAAE,EAAE;YACvD,OAAO,OAAO,CAAC,OAAO,CACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,+BAAa,CAAC,MAAM;gBAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS;gBACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,eAAe,CAC1C,CAAA;QACH,CAAC,CAAA;QACD,MAAM,YAAY,GAAyB,KAAK,EAAE,OAAoB,EAAE,KAAa,EAAE,EAAE;YACvF,MAAM,QAAQ,GAAmB,MAAM,OAAO,CAAC,IAAI,mCAAgB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAC5G,MAAM,cAAc,GAAG,IAAI,0BAAQ,CAAC,+BAAa,CAAC,cAAc,CAAC,CAAA;YACjE,cAAc,CAAC,KAAK,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;YACtD,MAAM,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;QAC5C,CAAC,CAAA;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QACpE,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AA/DD,kCA+DC"}

package/dist/src/config/index.d.ts

@@ -0,0 +1 @@
+export * from './config';

package/dist/src/config/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;;;;;;;;;;;;;;AAElC,2CAAwB"}

package/dist/src/errorHelper.d.ts

@@ -0,0 +1,19 @@
+import { AgentErrorDefinition } from '@microsoft/agents-activity';
+/**
+ * Error definitions for the Teams Extensions system.
+ * This contains localized error codes for the Teams Extensions subsystem of the AgentSDK.
+ *
+ * Each error definition includes an error code (starting from -150000), a description, and a help link
+ * pointing to an AKA link to get help for the given error.
+ *
+ * Usage example:
+ * ```
+ * throw ExceptionHelper.generateException(
+ *   Error,
+ *   Errors.TeamsApiClientNotAvailable
+ * );
+ * ```
+ */
+export declare const Errors: {
+    [key: string]: AgentErrorDefinition;
+};

package/dist/src/errorHelper.js

@@ -0,0 +1,96 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Errors = void 0;
+/**
+ * Error definitions for the Teams Extensions system.
+ * This contains localized error codes for the Teams Extensions subsystem of the AgentSDK.
+ *
+ * Each error definition includes an error code (starting from -150000), a description, and a help link
+ * pointing to an AKA link to get help for the given error.
+ *
+ * Usage example:
+ * ```
+ * throw ExceptionHelper.generateException(
+ *   Error,
+ *   Errors.TeamsApiClientNotAvailable
+ * );
+ * ```
+ */
+exports.Errors = {
+    // Teams Graph Errors (-150012 to -150015, -150017 to -150019)
+    /**
+     * Error thrown when a Graph authorization handler returns an empty token.
+     */
+    TeamsGraphTokenUnavailable: {
+        code: -150012,
+        description: 'Unable to acquire a Graph access token using authorization handler {handlerName}.'
+    },
+    /**
+     * Error thrown when no Graph authorization handlers are configured.
+     */
+    TeamsGraphAuthorizationHandlerRequired: {
+        code: -150013,
+        description: 'A Graph client requires at least one configured authorization handler.'
+    },
+    /**
+     * Error thrown when multiple Graph authorization handlers are configured and no handler name is provided.
+     */
+    TeamsGraphAuthorizationHandlerNameRequired: {
+        code: -150014,
+        description: 'A Graph client requires handlerName when multiple authorization handlers are configured.'
+    },
+    /**
+     * Error thrown when a required Graph client parameter is missing.
+     */
+    TeamsGraphParameterRequired: {
+        code: -150015,
+        description: 'The {parameterName} parameter is required to create a Graph client.'
+    },
+    /**
+     * Error thrown when the Graph base URL is invalid.
+     */
+    TeamsGraphInvalidBaseUrl: {
+        code: -150017,
+        description: 'The graphBaseUrl parameter must be a valid absolute URL.'
+    },
+    /**
+     * Error thrown when user authorization is unavailable from the current turn.
+     */
+    TeamsGraphUserAuthorizationNotConfigured: {
+        code: -150018,
+        description: 'User authorization is not configured on the AgentApplication. A delegated Graph client requires configured user authorization.'
+    },
+    /**
+     * Error thrown when token connections are unavailable.
+     */
+    TeamsGraphConnectionsNotConfigured: {
+        code: -150019,
+        description: 'Connections are not configured on the AgentApplication. An app-only Graph client requires a configured token connection.'
+    },
+    // TaskModule Errors (-150016)
+    /**
+     * Error thrown when unexpected TaskModules.submit() is triggered.
+     */
+    UnexpectedTaskModuleSubmit: {
+        code: -150016,
+        description: 'Unexpected TaskModules.submit() triggered for activity type: {activityType}'
+    },
+    // TeamsApiClient Errors (-150010 to -150011)
+    /**
+     * Error thrown when the Teams SDK client is not available in the context.
+     */
+    TeamsApiClientNotAvailable: {
+        code: -150010,
+        description: 'Teams API client is not available in the context. Add TeamsAgentExtension to populate it before use.'
+    },
+    /**
+     * Error thrown when Teams API client prerequisites are missing for Teams activities.
+     */
+    TeamsApiClientSetupFailed: {
+        code: -150011,
+        description: 'Teams API client setup failed: missing {missing}.'
+    }
+};
+//# sourceMappingURL=errorHelper.js.map

package/dist/src/errorHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHelper.js","sourceRoot":"","sources":["../../src/errorHelper.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;AAIlC;;;;;;;;;;;;;;GAcG;AACU,QAAA,MAAM,GAA4C;IAC7D,8DAA8D;IAC9D;;OAEG;IACH,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,mFAAmF;KACjG;IAED;;OAEG;IACH,sCAAsC,EAAE;QACtC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,wEAAwE;KACtF;IAED;;OAEG;IACH,0CAA0C,EAAE;QAC1C,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0FAA0F;KACxG;IAED;;OAEG;IACH,2BAA2B,EAAE;QAC3B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,qEAAqE;KACnF;IAED;;OAEG;IACH,wBAAwB,EAAE;QACxB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0DAA0D;KACxE;IAED;;OAEG;IACH,wCAAwC,EAAE;QACxC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,gIAAgI;KAC9I;IAED;;OAEG;IACH,kCAAkC,EAAE;QAClC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0HAA0H;KACxI;IAED,8BAA8B;IAC9B;;OAEG;IACH,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,6EAA6E;KAC3F;IAED,6CAA6C;IAC7C;;OAEG;IACH,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,sGAAsG;KACpH;IAED;;OAEG;IACH,yBAAyB,EAAE;QACzB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,mDAAmD;KACjE;CACF,CAAA"}

package/dist/src/fileConsents/fileConsent.d.ts

@@ -0,0 +1,37 @@
+import { AgentApplication, TurnState } from '@microsoft/agents-hosting';
+import type { FileConsentCardResponse } from '@microsoft/teams.api';
+import { TeamsTurnContext } from '../teamsTurnContext';
+type FileConsentHandler<TState extends TurnState> = (context: TeamsTurnContext, state: TState, response: FileConsentCardResponse) => Promise<void>;
+/**
+ * Registers handlers for Microsoft Teams file consent card actions.
+ *
+ * @typeParam TState - The turn state type used by the agent application.
+ */
+export declare class FileConsent<TState extends TurnState = TurnState> {
+    private _app;
+    /**
+     * Creates a Teams file consent route helper.
+     *
+     * @param app - The agent application that receives the registered routes.
+     */
+    constructor(app: AgentApplication<TState>);
+    /**
+     * Registers a handler for accepted file consent cards.
+     *
+     * @param handler - Handler invoked with the file consent card response.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This file consent helper for chaining.
+     */
+    onAccept(handler: FileConsentHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for declined file consent cards.
+     *
+     * @param handler - Handler invoked with the file consent card response.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This file consent helper for chaining.
+     */
+    onDecline(handler: FileConsentHandler<TState>, rank?: number, authHandlers?: string[]): this;
+}
+export {};