@microsoft/agents-hosting 0.1.49

package/dist/src/turnContext.d.ts

@@ -0,0 +1,160 @@
+import { BaseAdapter } from './baseAdapter';
+import { Activity, ConversationReference } from '@microsoft/agents-activity';
+import { ResourceResponse } from './connector-client/resourceResponse';
+import { TurnContextStateCollection } from './turnContextStateCollection';
+import { AttachmentInfo } from './connector-client/attachmentInfo';
+import { AttachmentData } from './connector-client/attachmentData';
+/**
+ * Defines a handler for sending activities.
+ */
+export type SendActivitiesHandler = (context: TurnContext, activities: Activity[], next: () => Promise<ResourceResponse[]>) => Promise<ResourceResponse[]>;
+/**
+ * Defines a handler for updating an activity.
+ */
+export type UpdateActivityHandler = (context: TurnContext, activity: Activity, next: () => Promise<void>) => Promise<void>;
+/**
+ * Defines a handler for deleting an activity.
+ */
+export type DeleteActivityHandler = (context: TurnContext, reference: ConversationReference, next: () => Promise<void>) => Promise<void>;
+/**
+ * Key for the agent callback handler.
+ */
+export declare const AgentCallbackHandlerKey = "agentCallbackHandler";
+/**
+ * Interface for TurnContext.
+ */
+export interface TurnContext {
+}
+/**
+ * Represents the context object for a turn of an Agent.
+ */
+export declare class TurnContext {
+    private readonly _adapter?;
+    private readonly _activity?;
+    private readonly _respondedRef;
+    private readonly _turnState;
+    private readonly _onSendActivities;
+    private readonly _onUpdateActivity;
+    private readonly _onDeleteActivity;
+    private readonly _turn;
+    private readonly _locale;
+    /**
+     * Initializes a new instance of the TurnContext class.
+     * @param adapterOrContext The adapter or context for the turn.
+     * @param request The activity for the turn.
+     */
+    constructor(adapterOrContext: BaseAdapter, request: Activity);
+    constructor(adapterOrContext: TurnContext);
+    /**
+     * A list of buffered reply activities.
+     */
+    readonly bufferedReplyActivities: Activity[];
+    /**
+     * Sends a trace activity.
+     * @param name The name of the trace activity.
+     * @param value The value of the trace activity.
+     * @param valueType The value type of the trace activity.
+     * @param label The label of the trace activity.
+     * @returns The resource response.
+     */
+    sendTraceActivity(name: string, value?: any, valueType?: string, label?: string): Promise<ResourceResponse | undefined>;
+    /**
+     * Sends an activity.
+     * @param activityOrText The activity or text to send.
+     * @param speak The text to speak.
+     * @param inputHint The input hint.
+     * @returns The resource response.
+     */
+    sendActivity(activityOrText: string | Activity, speak?: string, inputHint?: string): Promise<ResourceResponse | undefined>;
+    /**
+     * Sends multiple activities.
+     * @param activities The activities to send.
+     * @returns The resource responses.
+     */
+    sendActivities(activities: Activity[]): Promise<ResourceResponse[]>;
+    /**
+     * Updates an activity.
+     * @param activity The activity to update.
+     * @returns A promise representing the asynchronous operation.
+     */
+    updateActivity(activity: Activity): Promise<void>;
+    /**
+     * Deletes an activity.
+     * @param idOrReference The ID or reference of the activity to delete.
+     * @returns A promise representing the asynchronous operation.
+     */
+    deleteActivity(idOrReference: string | ConversationReference): Promise<void>;
+    /**
+     * Uploads an attachment.
+     * @param conversationId The conversation ID.
+     * @param attachmentData The attachment data.
+     * @returns The resource response.
+     */
+    uploadAttachment(conversationId: string, attachmentData: AttachmentData): Promise<ResourceResponse>;
+    /**
+     * Gets attachment information.
+     * @param attachmentId The attachment ID.
+     * @returns The attachment information.
+     */
+    getAttachmentInfo(attachmentId: string): Promise<AttachmentInfo>;
+    /**
+     * Gets an attachment.
+     * @param attachmentId The attachment ID.
+     * @param viewId The view ID.
+     * @returns The readable stream of the attachment.
+     */
+    getAttachment(attachmentId: string, viewId: string): Promise<NodeJS.ReadableStream>;
+    /**
+     * Registers a handler for sending activities.
+     * @param handler The handler to register.
+     * @returns The current TurnContext instance.
+     */
+    onSendActivities(handler: SendActivitiesHandler): this;
+    /**
+     * Registers a handler for updating activities.
+     * @param handler The handler to register.
+     * @returns The current TurnContext instance.
+     */
+    onUpdateActivity(handler: UpdateActivityHandler): this;
+    /**
+     * Registers a handler for deleting activities.
+     * @param handler The handler to register.
+     * @returns The current TurnContext instance.
+     */
+    onDeleteActivity(handler: DeleteActivityHandler): this;
+    /**
+     * Copies the properties of this TurnContext to another TurnContext.
+     * @param context The context to copy to.
+     */
+    protected copyTo(context: TurnContext): void;
+    /**
+     * Gets the adapter for the turn.
+     */
+    get adapter(): BaseAdapter;
+    /**
+     * Gets the activity for the turn.
+     */
+    get activity(): Activity;
+    /**
+     * Gets or sets whether the turn has responded.
+     */
+    get responded(): boolean;
+    set responded(value: boolean);
+    /**
+     * Gets or sets the locale for the turn.
+     */
+    get locale(): string | undefined;
+    set locale(value: string | undefined);
+    /**
+     * Gets the turn state collection.
+     */
+    get turnState(): TurnContextStateCollection;
+    /**
+     * Emits events to the registered handlers.
+     * @param handlers The handlers to emit to.
+     * @param arg The argument to pass to the handlers.
+     * @param next The next function to call.
+     * @returns The result of the handlers.
+     */
+    private emit;
+}

package/dist/src/turnContext.js

@@ -0,0 +1,286 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurnContext = exports.AgentCallbackHandlerKey = void 0;
+/** * Copyright (c) Microsoft Corporation. All rights reserved. * Licensed under the MIT License. */
+const activityHandler_1 = require("./activityHandler");
+const agents_activity_1 = require("@microsoft/agents-activity");
+const turnContextStateCollection_1 = require("./turnContextStateCollection");
+/**
+ * Key for the agent callback handler.
+ */
+exports.AgentCallbackHandlerKey = 'agentCallbackHandler';
+/**
+ * Represents the context object for a turn of an Agent.
+ */
+class TurnContext {
+    constructor(adapterOrContext, request) {
+        this._respondedRef = { responded: false };
+        this._turnState = new turnContextStateCollection_1.TurnContextStateCollection();
+        this._onSendActivities = [];
+        this._onUpdateActivity = [];
+        this._onDeleteActivity = [];
+        this._turn = 'turn';
+        this._locale = 'locale';
+        /**
+         * A list of buffered reply activities.
+         */
+        this.bufferedReplyActivities = [];
+        if (adapterOrContext instanceof TurnContext) {
+            adapterOrContext.copyTo(this);
+        }
+        else {
+            this._adapter = adapterOrContext;
+            this._activity = request;
+        }
+    }
+    /**
+     * Sends a trace activity.
+     * @param name The name of the trace activity.
+     * @param value The value of the trace activity.
+     * @param valueType The value type of the trace activity.
+     * @param label The label of the trace activity.
+     * @returns The resource response.
+     */
+    async sendTraceActivity(name, value, valueType, label) {
+        const traceActivityObj = {
+            type: agents_activity_1.ActivityTypes.Trace,
+            timestamp: new Date().toISOString(),
+            name,
+            value,
+            valueType,
+            label
+        };
+        const traceActivity = agents_activity_1.Activity.fromObject(traceActivityObj);
+        return await this.sendActivity(traceActivity);
+    }
+    /**
+     * Sends an activity.
+     * @param activityOrText The activity or text to send.
+     * @param speak The text to speak.
+     * @param inputHint The input hint.
+     * @returns The resource response.
+     */
+    async sendActivity(activityOrText, speak, inputHint) {
+        let activityObject;
+        if (typeof activityOrText === 'string') {
+            activityObject = { type: agents_activity_1.ActivityTypes.Message, text: activityOrText, inputHint: inputHint || agents_activity_1.InputHints.AcceptingInput };
+            if (speak) {
+                activityObject = { ...activityObject, speak };
+            }
+        }
+        else {
+            activityObject = activityOrText;
+        }
+        const activity = agents_activity_1.Activity.fromObject(activityObject);
+        const responses = (await this.sendActivities([activity])) || [];
+        return responses[0];
+    }
+    /**
+     * Sends multiple activities.
+     * @param activities The activities to send.
+     * @returns The resource responses.
+     */
+    async sendActivities(activities) {
+        let sentNonTraceActivity = false;
+        const ref = this.activity.getConversationReference();
+        const output = activities.map((activity) => {
+            const result = activity.applyConversationReference(ref);
+            if (!result.type) {
+                result.type = agents_activity_1.ActivityTypes.Message;
+            }
+            if (result.type === agents_activity_1.ActivityTypes.InvokeResponse) {
+                this.turnState.set(activityHandler_1.INVOKE_RESPONSE_KEY, activity);
+            }
+            if (result.type !== agents_activity_1.ActivityTypes.Trace) {
+                sentNonTraceActivity = true;
+            }
+            if (result.id) {
+                delete result.id;
+            }
+            return result;
+        });
+        return await this.emit(this._onSendActivities, output, async () => {
+            if (this.activity.deliveryMode === agents_activity_1.DeliveryModes.ExpectReplies) {
+                const responses = [];
+                output.forEach((a) => {
+                    this.bufferedReplyActivities.push(a);
+                    if (a.type === agents_activity_1.ActivityTypes.InvokeResponse) {
+                        this.turnState.set(activityHandler_1.INVOKE_RESPONSE_KEY, a);
+                    }
+                    responses.push({ id: '' });
+                });
+                if (sentNonTraceActivity) {
+                    this.responded = true;
+                }
+                return responses;
+            }
+            else {
+                const responses = await this.adapter.sendActivities(this, output);
+                for (let index = 0; index < (responses === null || responses === void 0 ? void 0 : responses.length); index++) {
+                    const activity = output[index];
+                    activity.id = responses[index].id;
+                }
+                if (sentNonTraceActivity) {
+                    this.responded = true;
+                }
+                return responses;
+            }
+        });
+    }
+    /**
+     * Updates an activity.
+     * @param activity The activity to update.
+     * @returns A promise representing the asynchronous operation.
+     */
+    async updateActivity(activity) {
+        const ref = this.activity.getConversationReference();
+        const a = activity.applyConversationReference(ref);
+        return await this.emit(this._onUpdateActivity, a, async () => await this.adapter.updateActivity(this, a).then(() => { }));
+    }
+    /**
+     * Deletes an activity.
+     * @param idOrReference The ID or reference of the activity to delete.
+     * @returns A promise representing the asynchronous operation.
+     */
+    async deleteActivity(idOrReference) {
+        let reference;
+        if (typeof idOrReference === 'string') {
+            reference = this.activity.getConversationReference();
+            reference.activityId = idOrReference;
+        }
+        else {
+            reference = idOrReference;
+        }
+        return await this.emit(this._onDeleteActivity, reference, async () => await this.adapter.deleteActivity(this, reference));
+    }
+    /**
+     * Uploads an attachment.
+     * @param conversationId The conversation ID.
+     * @param attachmentData The attachment data.
+     * @returns The resource response.
+     */
+    async uploadAttachment(conversationId, attachmentData) {
+        return await this.adapter.uploadAttachment(conversationId, attachmentData);
+    }
+    /**
+     * Gets attachment information.
+     * @param attachmentId The attachment ID.
+     * @returns The attachment information.
+     */
+    async getAttachmentInfo(attachmentId) {
+        return await this.adapter.getAttachmentInfo(attachmentId);
+    }
+    /**
+     * Gets an attachment.
+     * @param attachmentId The attachment ID.
+     * @param viewId The view ID.
+     * @returns The readable stream of the attachment.
+     */
+    async getAttachment(attachmentId, viewId) {
+        return await this.adapter.getAttachment(attachmentId, viewId);
+    }
+    /**
+     * Registers a handler for sending activities.
+     * @param handler The handler to register.
+     * @returns The current TurnContext instance.
+     */
+    onSendActivities(handler) {
+        this._onSendActivities.push(handler);
+        return this;
+    }
+    /**
+     * Registers a handler for updating activities.
+     * @param handler The handler to register.
+     * @returns The current TurnContext instance.
+     */
+    onUpdateActivity(handler) {
+        this._onUpdateActivity.push(handler);
+        return this;
+    }
+    /**
+     * Registers a handler for deleting activities.
+     * @param handler The handler to register.
+     * @returns The current TurnContext instance.
+     */
+    onDeleteActivity(handler) {
+        this._onDeleteActivity.push(handler);
+        return this;
+    }
+    /**
+     * Copies the properties of this TurnContext to another TurnContext.
+     * @param context The context to copy to.
+     */
+    copyTo(context) {
+        ['_adapter', '_activity', '_respondedRef', '_services', '_onSendActivities', '_onUpdateActivity', '_onDeleteActivity'].forEach((prop) => (context[prop] = this[prop]));
+    }
+    /**
+     * Gets the adapter for the turn.
+     */
+    get adapter() {
+        return this._adapter;
+    }
+    /**
+     * Gets the activity for the turn.
+     */
+    get activity() {
+        return this._activity;
+    }
+    /**
+     * Gets or sets whether the turn has responded.
+     */
+    get responded() {
+        return this._respondedRef.responded;
+    }
+    set responded(value) {
+        if (!value) {
+            throw new Error("TurnContext: cannot set 'responded' to a value of 'false'.");
+        }
+        this._respondedRef.responded = true;
+    }
+    /**
+     * Gets or sets the locale for the turn.
+     */
+    get locale() {
+        const turnObj = this._turnState.get(this._turn);
+        if (turnObj && typeof turnObj[this._locale] === 'string') {
+            return turnObj[this._locale];
+        }
+        return undefined;
+    }
+    set locale(value) {
+        let turnObj = this._turnState.get(this._turn);
+        if (turnObj) {
+            turnObj[this._locale] = value;
+        }
+        else {
+            turnObj = { [this._locale]: value };
+            this._turnState.set(this._turn, turnObj);
+        }
+    }
+    /**
+     * Gets the turn state collection.
+     */
+    get turnState() {
+        return this._turnState;
+    }
+    /**
+     * Emits events to the registered handlers.
+     * @param handlers The handlers to emit to.
+     * @param arg The argument to pass to the handlers.
+     * @param next The next function to call.
+     * @returns The result of the handlers.
+     */
+    async emit(handlers, arg, next) {
+        const runHandlers = async ([handler, ...remaining]) => {
+            try {
+                return handler ? await handler(this, arg, async () => await runHandlers(remaining)) : await Promise.resolve(next());
+            }
+            catch (err) {
+                return await Promise.reject(err);
+            }
+        };
+        return await runHandlers(handlers);
+    }
+}
+exports.TurnContext = TurnContext;
+//# sourceMappingURL=turnContext.js.map

package/dist/src/turnContext.js.map

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

package/dist/src/turnContextStateCollection.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A collection for managing state within a turn context.
+ */
+export declare class TurnContextStateCollection extends Map<any, any> {
+    /**
+     * Gets the value associated with the specified key.
+     * @param key The key of the element to get.
+     * @returns The element associated with the specified key, or undefined if the key does not exist.
+     */
+    get<T = any>(key: any): T;
+    /**
+     * Gets the value associated with the specified key.
+     * @param key The key of the element to get.
+     * @returns The element associated with the specified key, or undefined if the key does not exist.
+     */
+    get(key: any): any;
+    /**
+     * Pushes a value onto the stack for the specified key.
+     * @param key The key of the element to push.
+     * @param value The value to push onto the stack.
+     */
+    push(key: any, value: any): void;
+    /**
+     * Pops a value from the stack for the specified key.
+     * @param key The key of the element to pop.
+     * @returns The value that was popped from the stack.
+     */
+    pop(key: any): any;
+}

package/dist/src/turnContextStateCollection.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurnContextStateCollection = void 0;
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+const TURN_STATE_SCOPE_CACHE = Symbol('turnStateScopeCache');
+/**
+ * A collection for managing state within a turn context.
+ */
+class TurnContextStateCollection extends Map {
+    get(key) {
+        return super.get(key);
+    }
+    /**
+     * Pushes a value onto the stack for the specified key.
+     * @param key The key of the element to push.
+     * @param value The value to push onto the stack.
+     */
+    push(key, value) {
+        var _a;
+        const current = this.get(key);
+        const cache = this.get(TURN_STATE_SCOPE_CACHE) || new Map();
+        if (cache.has(key)) {
+            (_a = cache.get(key)) === null || _a === void 0 ? void 0 : _a.push(current);
+        }
+        else {
+            cache.set(key, [current]);
+        }
+        if (value === undefined) {
+            value = current;
+        }
+        this.set(key, value);
+        this.set(TURN_STATE_SCOPE_CACHE, cache);
+    }
+    /**
+     * Pops a value from the stack for the specified key.
+     * @param key The key of the element to pop.
+     * @returns The value that was popped from the stack.
+     */
+    pop(key) {
+        var _a;
+        const current = this.get(key);
+        let previous;
+        const cache = this.get(TURN_STATE_SCOPE_CACHE) || new Map();
+        if (cache.has(key)) {
+            previous = (_a = cache.get(key)) === null || _a === void 0 ? void 0 : _a.pop();
+        }
+        this.set(key, previous);
+        this.set(TURN_STATE_SCOPE_CACHE, cache);
+        return current;
+    }
+}
+exports.TurnContextStateCollection = TurnContextStateCollection;
+//# sourceMappingURL=turnContextStateCollection.js.map

package/dist/src/turnContextStateCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnContextStateCollection.js","sourceRoot":"","sources":["../../src/turnContextStateCollection.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAM,sBAAsB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAA;AAE5D;;GAEG;AACH,MAAa,0BAA2B,SAAQ,GAAa;IAe3D,GAAG,CAAE,GAAQ;QACX,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAE,GAAQ,EAAE,KAAU;;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC7B,MAAM,KAAK,GAAoB,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,IAAI,GAAG,EAAc,CAAA;QACxF,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,MAAA,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,0CAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;QAC3B,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,GAAG,OAAO,CAAA;QACjB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACpB,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAA;IACzC,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAE,GAAQ;;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAE7B,IAAI,QAAa,CAAA;QACjB,MAAM,KAAK,GAAoB,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,IAAI,GAAG,EAAc,CAAA;QACxF,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,QAAQ,GAAG,MAAA,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,0CAAE,GAAG,EAAE,CAAA;QAClC,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QACvB,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAA;QAEvC,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AA3DD,gEA2DC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@microsoft/agents-hosting",
+  "version": "0.1.49",
+  "homepage": "https://github.com/microsoft/Agents-for-js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/microsoft/Agents-for-js.git"
+  },
+  "author": {
+    "name": "Microsoft",
+    "email": "agentssdk@microsoft.com",
+    "url": "https://aka.ms/Agents"
+  },
+  "description": "Microsoft 365 Agents SDK for JavaScript",
+  "keywords": [
+    "Agents"
+  ],
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "dependencies": {
+    "@microsoft/agents-activity": "0.1.49",
+    "@azure/msal-node": "^3.4.1",
+    "jsonwebtoken": "^9.0.2",
+    "jwks-rsa": "^3.2.0",
+    "axios": "^1.8.2",
+    "debug": "^4.3.7"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.1"
+  },
+  "license": "MIT",
+  "files": [
+    "README.md",
+    "dist/src",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "require": "./dist/src/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}