@microsoft/agents-hosting 0.5.4-ga4d0401645 → 0.5.16-g6bdf69cc43

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

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

package/dist/src/app/streaming/message.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../../src/app/streaming/message.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/src/app/streaming/sensitivityUsageInfo.d.ts

@@ -1,40 +0,0 @@
-/**
- * Sensitivity usage info for content sent to the user. This is used to provide information about the content to the user. See ClientCitation for more information.
- */
-export interface SensitivityUsageInfo {
-    /**
-       * Must be "https://schema.org/Message"
-       */
-    type: 'https://schema.org/Message';
-    /**
-       * Required; Set to CreativeWork;
-       */
-    '@type': 'CreativeWork';
-    /**
-       * Sensitivity description of the content
-       */
-    description?: string;
-    /**
-       * Sensitivity title of the content
-       */
-    name: string;
-    /**
-       * Optional; ignored in Teams.
-       */
-    position?: number;
-    pattern?: {
-        /**
-             * Set to DefinedTerm
-             */
-        '@type': 'DefinedTerm';
-        inDefinedTermSet: string;
-        /**
-             * Color
-             */
-        name: string;
-        /**
-             * e.g. #454545
-             */
-        termCode: string;
-    };
-}

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

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=sensitivityUsageInfo.js.map

package/dist/src/app/streaming/sensitivityUsageInfo.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sensitivityUsageInfo.js","sourceRoot":"","sources":["../../../../src/app/streaming/sensitivityUsageInfo.ts"],"names":[],"mappings":""}

package/dist/src/app/streaming/utilities.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../../src/app/streaming/utilities.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,mCAAmC;AAEnC,2CAA2C;AAE3C;;GAEG;AACH,MAAa,SAAS;IACtB,QAAQ;IACR,uCAAuC;IACvC,kBAAkB;IAClB,6GAA6G;IAC7G,qEAAqE;IACrE,8CAA8C;IAC9C,gIAAgI;IAChI,4CAA4C;IAC5C,UAAU;IACV,iGAAiG;IACjG,mDAAmD;IACnD,kBAAkB;IAClB,8CAA8C;IAC9C,uDAAuD;IACvD,qCAAqC;IACrC,6BAA6B;IAC7B,uCAAuC;IACvC,iBAAiB;IACjB,8CAA8C;IAC9C,0CAA0C;IAC1C,+CAA+C;IAC/C,oFAAoF;IACpF,0BAA0B;IAC1B,mBAAmB;IACnB,0BAA0B;IAC1B,YAAY;IACZ,UAAU;IACV,eAAe;IACf,gCAAgC;IAChC,QAAQ;IACR,MAAM;IAEJ;;;;;;SAMK;IACE,MAAM,CAAC,OAAO,CAAE,IAAY,EAAE,SAAiB;QACpD,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;QACtC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAC9E,OAAO,IAAI,KAAK,CAAA;QAChB,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;;;SAIK;IACE,MAAM,CAAC,uBAAuB,CAAE,IAAY;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAA;IACjD,CAAC;IAED;;;;;SAKK;IACE,MAAM,CAAC,gBAAgB,CAAE,IAAY,EAAE,SAA2B;QACvE,MAAM,KAAK,GAAG,aAAa,CAAA;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAEjC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,oBAAoB;QACpB,MAAM,eAAe,GAAG,IAAI,GAAG,EAAE,CAAA;QACjC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACxB,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAM;YACR,CAAC;YAED,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QAEF,gBAAgB;QAChB,MAAM,aAAa,GAAqB,EAAE,CAAA;QAC1C,eAAe,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAChC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,QAAQ,GAAG,KAAK,KAAK,CAAC,CAAA;YAC9E,IAAI,KAAK,EAAE,CAAC;gBACV,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC,CAAC,CAAA;QACF,OAAO,aAAa,CAAA;IACtB,CAAC;CACF;AA7FD,8BA6FC"}

package/dist/src/oauth/oAuthCard.d.ts

@@ -1,27 +0,0 @@
-import { CardAction } from '@microsoft/agents-activity';
-import { TokenExchangeResource, TokenPostResource } from './signingResource';
-/**
- * Represents an OAuth card.
- */
-export interface OAuthCard {
-    /**
-     * The buttons associated with the OAuth card.
-     */
-    buttons: CardAction[];
-    /**
-     * The connection name for the OAuth card.
-     */
-    connectionName: string;
-    /**
-     * The text content of the OAuth card.
-     */
-    text: string;
-    /**
-     * The token exchange resource for the OAuth card.
-     */
-    tokenExchangeResource: TokenExchangeResource;
-    /**
-     * The token post resource for the OAuth card.
-     */
-    tokenPostResource: TokenPostResource;
-}

package/dist/src/oauth/oAuthCard.js.map

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

package/dist/src/oauth/signingResource.d.ts

@@ -1,43 +0,0 @@
-/**
- * Represents a resource for exchanging tokens.
- */
-export interface TokenExchangeResource {
-    /**
-     * The ID of the token exchange resource.
-     */
-    id?: string;
-    /**
-     * The URI of the token exchange resource.
-     */
-    uri?: string;
-    /**
-     * The provider ID for the token exchange resource.
-     */
-    providerId?: string;
-}
-/**
- * Represents a resource for posting tokens.
- */
-export interface TokenPostResource {
-    /**
-     * The SAS URL for the token post resource.
-     */
-    sasUrl?: string;
-}
-/**
- * Represents a resource for signing in.
- */
-export interface SigningResource {
-    /**
-     * The link for signing in.
-     */
-    signInLink: string;
-    /**
-     * The resource for token exchange.
-     */
-    tokenExchangeResource: TokenExchangeResource;
-    /**
-     * The resource for token post.
-     */
-    tokenPostResource: TokenPostResource;
-}

package/dist/src/oauth/signingResource.js

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

package/dist/src/oauth/signingResource.js.map

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

package/dist/src/oauth/tokenExchangeRequest.d.ts

@@ -1,17 +0,0 @@
-/**
- * Represents a request for exchanging tokens.
- */
-export interface TokenExchangeRequest {
-    /**
-     * The URI for the token exchange request.
-     */
-    uri?: string;
-    /**
-     * The token to be exchanged.
-     */
-    token?: string;
-    /**
-     * The ID associated with the token exchange request.
-     */
-    id?: string;
-}

package/dist/src/oauth/tokenExchangeRequest.js

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

package/dist/src/oauth/tokenExchangeRequest.js.map

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

package/dist/src/oauth/tokenResponse.d.ts

@@ -1,29 +0,0 @@
-/**
- * Represents the status of an OAuth token request.
- */
-export declare enum TokenRequestStatus {
-    /**
-     * Indicates that the token request was successful.
-     */
-    Success = "Success",
-    /**
-     * Indicates that the token request failed.
-     */
-    Failed = "Failed",
-    /**
-     * Indicates that the token request is pending.
-     */
-    InProgress = "InProgress",
-    Expired = "Expired"
-}
-/**
- * Represents the response containing OAuth token information.
- * This interface encapsulates all data related to an OAuth token response.
- */
-export interface TokenResponse {
-    status: TokenRequestStatus;
-    /**
-     * The OAuth token string, or null if no token is available.
-     */
-    token: string | undefined;
-}

package/dist/src/oauth/tokenResponse.js

@@ -1,25 +0,0 @@
-"use strict";
-// Copyright (c) Microsoft Corporation. All rights reserved.
-// Licensed under the MIT License.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TokenRequestStatus = void 0;
-/**
- * Represents the status of an OAuth token request.
- */
-var TokenRequestStatus;
-(function (TokenRequestStatus) {
-    /**
-     * Indicates that the token request was successful.
-     */
-    TokenRequestStatus["Success"] = "Success";
-    /**
-     * Indicates that the token request failed.
-     */
-    TokenRequestStatus["Failed"] = "Failed";
-    /**
-     * Indicates that the token request is pending.
-     */
-    TokenRequestStatus["InProgress"] = "InProgress";
-    TokenRequestStatus["Expired"] = "Expired";
-})(TokenRequestStatus || (exports.TokenRequestStatus = TokenRequestStatus = {}));
-//# sourceMappingURL=tokenResponse.js.map

package/dist/src/oauth/tokenResponse.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tokenResponse.js","sourceRoot":"","sources":["../../../src/oauth/tokenResponse.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;AAElC;;GAEG;AACH,IAAY,kBAiBX;AAjBD,WAAY,kBAAkB;IAC5B;;OAEG;IACH,yCAAmB,CAAA;IAEnB;;OAEG;IACH,uCAAiB,CAAA;IAEjB;;OAEG;IACH,+CAAyB,CAAA;IAEzB,yCAAmB,CAAA;AACrB,CAAC,EAjBW,kBAAkB,kCAAlB,kBAAkB,QAiB7B"}

package/src/app/oauth/authorization.ts

@@ -1,162 +0,0 @@
-/**
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the MIT License.
- */
-
-import { TurnContext } from '../../turnContext'
-import { debug } from '../../logger'
-import { TurnState } from '../turnState'
-import { Storage } from '../../storage'
-import { OAuthFlow, TokenRequestStatus, TokenResponse } from '../../oauth'
-import { UserState } from '../../state'
-
-const logger = debug('agents:authorization')
-
-/**
- * Interface defining an authorization handler for OAuth flows
- * @interface AuthHandler
- */
-export interface AuthHandler {
-  /** Connection name for the auth provider */
-  name?: string,
-  /** Whether authorization should be triggered automatically */
-  auto?: boolean,
-  /** The OAuth flow implementation */
-  flow?: OAuthFlow,
-  /** Title to display on auth cards/UI */
-  title?: string,
-  /** Text to display on auth cards/UI */
-  text?: string,
-}
-
-/**
- * Options for configuring user authorization.
- * Contains settings to configure OAuth connections.
- */
-export interface AuthorizationHandlers extends Record<string, AuthHandler> {}
-
-/**
- * Class responsible for managing authorization and OAuth flows
- * @class Authorization
- */
-export class Authorization {
-  _authHandlers: AuthorizationHandlers
-
-  /**
-   * Creates a new instance of UserAuthorization.
-   * @param {Storage} storage - The storage system to use for state management.
-   * @param {AuthorizationHandlers} authHandlers - Configuration for OAuth providers
-   * @throws {Error} If storage is null/undefined or no auth handlers are provided
-   */
-  constructor (storage: Storage, authHandlers: AuthorizationHandlers) {
-    if (storage === undefined || storage === null) {
-      throw new Error('Storage is required for UserAuthorization')
-    }
-    const userState = new UserState(storage)
-    if (authHandlers === undefined || Object.keys(authHandlers).length === 0) {
-      throw new Error('The authorization does not have any auth handlers')
-    }
-    this._authHandlers = authHandlers
-    for (const ah in this._authHandlers) {
-      if (this._authHandlers![ah].name === undefined && process.env[ah + '_connectionName'] === undefined) {
-        throw new Error(`AuthHandler name ${ah}_connectionName not set in autorization and not found in env vars.`)
-      }
-      const currentAuthHandler = this._authHandlers![ah]
-      currentAuthHandler.name = currentAuthHandler.name ?? process.env[ah + '_connectionName'] as string
-      currentAuthHandler.title = currentAuthHandler.title ?? process.env[ah + '_connectionTitle'] as string
-      currentAuthHandler.text = currentAuthHandler.text ?? process.env[ah + '_connectionText'] as string
-      currentAuthHandler.auto = currentAuthHandler.auto ?? process.env[ah + '_connectionAuto'] === 'true'
-      currentAuthHandler.flow = new OAuthFlow(userState, currentAuthHandler.name, null!, currentAuthHandler.title, currentAuthHandler.text)
-    }
-    logger.info('Authorization handlers configured with', this._authHandlers.length, 'handlers')
-  }
-
-  /**
-   * Gets the token for a specific auth handler
-   * @param {TurnContext} context - The context object for the current turn
-   * @param {string} [authHandlerId] - Optional ID of the auth handler to use, defaults to first handler
-   * @returns {Promise<TokenResponse>} The token response from the OAuth provider
-   */
-  public async getToken (context: TurnContext, authHandlerId?: string): Promise<TokenResponse> {
-    logger.info('getToken from user token service for authHandlerId:', authHandlerId)
-    const authHandler = this.resolverHandler(authHandlerId)
-    return await authHandler.flow?.getUserToken(context)!
-  }
-
-  /**
-   * Begins or continues an OAuth flow
-   * @param {TurnContext} context - The context object for the current turn
-   * @param {TurnState} state - The state object for the current turn
-   * @param {string} [authHandlerId] - Optional ID of the auth handler to use, defaults to first handler
-   * @returns {Promise<TokenResponse>} The token response from the OAuth provider
-   */
-  public async beginOrContinueFlow (context: TurnContext, state: TurnState, authHandlerId?: string) : Promise<TokenResponse> {
-    logger.info('beginOrContinueFlow for authHandlerId:', authHandlerId)
-    const flow = this.resolverHandler(authHandlerId).flow!
-    let tokenResponse: TokenResponse
-    if (flow.state!.flowStarted === false) {
-      tokenResponse = await flow.beginFlow(context)
-    } else {
-      tokenResponse = await flow.continueFlow(context)
-      if (tokenResponse.status === TokenRequestStatus.Success) {
-        if (this._signInHandler) {
-          await this._signInHandler(context, state, authHandlerId)
-        }
-      }
-    }
-    return tokenResponse
-  }
-
-  /**
-   * Gets the current state of the OAuth flow
-   * @param {string} [authHandlerId] - Optional ID of the auth handler to check, defaults to first handler
-   * @returns {boolean} Whether the flow has started
-   */
-  public getFlowState (authHandlerId?: string) : boolean {
-    const flow = this.resolverHandler(authHandlerId).flow!
-    return flow.state?.flowStarted!
-  }
-
-  /**
-   * Resolves the auth handler to use based on the provided ID
-   * @param {string} [authHandlerId] - Optional ID of the auth handler to resolve, defaults to first handler
-   * @returns {AuthHandler} The resolved auth handler
-   */
-  resolverHandler = (authHandlerId?: string) : AuthHandler => {
-    if (authHandlerId) {
-      return this._authHandlers![authHandlerId]
-    }
-    return this._authHandlers![Object.keys(this._authHandlers)[0]]
-  }
-
-  /**
-   * Signs out the current user.
-   * This method clears the user's token and resets the SSO state.
-   *
-   * @param {TurnContext} context - The context object for the current turn.
-   * @param {TurnState} state - The state object for the current turn.
-   * @param {string} [authHandlerId] - Optional ID of the auth handler to use for sign out
-   * @returns {Promise<void>}
-   */
-  async signOut (context: TurnContext, state: TurnState, authHandlerId?: string) : Promise<void> {
-    logger.info('signOut for authHandlerId:', authHandlerId)
-    if (authHandlerId === undefined) { // aw
-      for (const ah in this._authHandlers) {
-        const flow = this._authHandlers[ah].flow
-        await flow?.signOut(context)
-      }
-    } else {
-      await this.resolverHandler(authHandlerId).flow?.signOut(context)
-    }
-  }
-
-  _signInHandler: ((context: TurnContext, state: TurnState, authHandlerId?: string) => void) | null = null
-
-  /**
-   * Sets a handler to be called when sign-in is successfully completed
-   * @param {Function} handler - The handler function to call on successful sign-in
-   */
-  public onSignInSuccess (handler: (context: TurnContext, state: TurnState, authHandlerId?: string) => void) {
-    this._signInHandler = handler
-  }
-}

package/src/app/streaming/AIEntity.ts

@@ -1,44 +0,0 @@
-/**
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the MIT License.
- */
-
-import { ClientCitation } from './clientCitation'
-import { SensitivityUsageInfo } from './sensitivityUsageInfo'
-
-export interface AIEntity {
-  /**
-     * Required as 'https://schema.org/Message'
-     */
-  type: 'https://schema.org/Message';
-
-  /**
-     * Required as 'Message
-     */
-  '@type': 'Message';
-
-  /**
-     * Required as 'https://schema.org
-     */
-  '@context': 'https://schema.org';
-
-  /**
-     * Must be left blank. This is for Bot Framework schema.
-     */
-  '@id': '';
-
-  /**
-     * Indicate that the content was generated by AI.
-     */
-  additionalType: ['AIGeneratedContent'];
-
-  /**
-     * Optional; if citations object is included, the  sent activity will include the citations, referenced in the activity text.
-     */
-  citation?: ClientCitation[];
-
-  /**
-     * Optional; if usage_info object is included, the sent activity will include the sensitivity usage information.
-     */
-  usageInfo?: SensitivityUsageInfo;
-}

package/src/app/streaming/actionCall.ts

@@ -1,37 +0,0 @@
-/**
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the MIT License.
- */
-
-/**
- * An action call to be requested by the LLM model. This type is a generic meant to be the equivalent of OpenAI's [`ChatCompletionMessageToolCall`](https://github.com/openai/openai-node/blob/master/src/resources/chat/completions.ts#L477), but is not tied to OpenAI's implementation in order to allow for flexibility for other models in the future.
- */
-export interface ActionCall {
-  /**
-     * The ID of the tool call.
-     */
-  id: string;
-
-  /**
-     * The function that the model called.
-     */
-  function: {
-    /**
-         * The name of the function.
-         */
-    name: string;
-
-    /**
-         * The arguments to call the function with, as generated by the model in JSON
-         * format. Note that the model does not always generate valid JSON, and may
-         * hallucinate parameters not defined by your function schema. Validate the
-         * arguments in your code before calling your function.
-         */
-    arguments: string;
-  };
-
-  /**
-     * The type of the tool. Currently, only `function` is supported.
-     */
-  type: 'function';
-}

package/src/app/streaming/clientCitation.ts

@@ -1,102 +0,0 @@
-/**
- * @module teams-ai
- */
-/**
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the MIT License.
- */
-
-import { SensitivityUsageInfo } from './sensitivityUsageInfo'
-
-export type ClientCitationIconName =
-    | 'Microsoft Word'
-    | 'Microsoft Excel'
-    | 'Microsoft PowerPoint'
-    | 'Microsoft OneNote'
-    | 'Microsoft SharePoint'
-    | 'Microsoft Visio'
-    | 'Microsoft Loop'
-    | 'Microsoft Whiteboard'
-    | 'Adobe Illustrator'
-    | 'Adobe Photoshop'
-    | 'Adobe InDesign'
-    | 'Adobe Flash'
-    | 'Sketch'
-    | 'Source Code'
-    | 'Image'
-    | 'GIF'
-    | 'Video'
-    | 'Sound'
-    | 'ZIP'
-    | 'Text'
-    | 'PDF'
-
-/**
- * Represents a Teams client citation to be included in a message. See Bot messages with AI-generated content for more details.
- * https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/bot-messages-ai-generated-content?tabs=before%2Cbotmessage
- */
-export interface ClientCitation {
-  /**
-     * Required; must be "Claim"
-     */
-  '@type': 'Claim';
-
-  /**
-     * Required. Number and position of the citation.
-     */
-  position: number;
-  appearance: {
-    /**
-         * Required; Must be 'DigitalDocument'
-         */
-    '@type': 'DigitalDocument';
-
-    /**
-         * Name of the document. (max length 80)
-         */
-    name: string;
-
-    /**
-         * Stringified adaptive card with additional information about the citation.
-         * It is rendered within the modal.
-         */
-    text?: string;
-
-    /**
-         * URL of the document. This will make the name of the citation clickable and direct the user to the specified URL.
-         */
-    url?: string;
-
-    /**
-         * Extract of the referenced content. (max length 160)
-         */
-    abstract: string;
-
-    /**
-         * Encoding format of the `citation.appearance.text` field.
-         */
-    encodingFormat?: 'application/vnd.microsoft.card.adaptive';
-
-    /**
-         * Information about the citation’s icon.
-         */
-    image?: {
-      '@type': 'ImageObject';
-
-      /**
-             * The image/icon name
-             */
-      name: ClientCitationIconName;
-    };
-
-    /**
-         * Optional; set by developer. (max length 3) (max keyword length 28)
-         */
-    keywords?: string[];
-
-    /**
-         * Optional sensitivity content information.
-         */
-    usageInfo?: SensitivityUsageInfo;
-  };
-}