@microsoft/agents-a365-runtime 0.1.0-preview.30

package/README.md

@@ -0,0 +1,33 @@
+# @microsoft/agents-a365-runtime
+
+[![npm](https://img.shields.io/npm/v/@microsoft/agents-a365-runtime?label=npm&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-runtime)
+[![npm Downloads](https://img.shields.io/npm/dm/@microsoft/agents-a365-runtime?label=Downloads&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-runtime)
+
+Core runtime utilities and services for applications built with the Microsoft Agent 365 SDK. This package provides authentication, authorization, and Power Platform API discovery capabilities for building enterprise-ready AI agents.
+
+## Installation
+
+```bash
+npm install @microsoft/agents-a365-runtime
+```
+
+## Usage
+
+For detailed usage examples and implementation guidance, see the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/?tabs=nodejs).
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section
+- See the [main documentation](../../README.md) for more information
+
+## Trademarks
+
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../LICENSE.md) file for details

package/dist/cjs/agentic-authorization-service.d.ts

@@ -0,0 +1,5 @@
+import { TurnContext, Authorization } from '@microsoft/agents-hosting';
+export declare class AgenticAuthenticationService {
+    static GetAgenticUserToken(authorization: Authorization, authHandlerName: string, turnContext: TurnContext): Promise<string>;
+}
+//# sourceMappingURL=agentic-authorization-service.d.ts.map

package/dist/cjs/agentic-authorization-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-authorization-service.d.ts","sourceRoot":"","sources":["../../src/agentic-authorization-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGvE,qBAAa,4BAA4B;WACnB,mBAAmB,CAAC,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW;CAIxH"}

package/dist/cjs/agentic-authorization-service.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticAuthenticationService = void 0;
+const environment_utils_1 = require("./environment-utils");
+class AgenticAuthenticationService {
+    static async GetAgenticUserToken(authorization, authHandlerName, turnContext) {
+        const scope = (0, environment_utils_1.getMcpPlatformAuthenticationScope)();
+        return (await authorization.exchangeToken(turnContext, authHandlerName, { scopes: [scope] })).token || '';
+    }
+}
+exports.AgenticAuthenticationService = AgenticAuthenticationService;
+//# sourceMappingURL=agentic-authorization-service.js.map

package/dist/cjs/agentic-authorization-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-authorization-service.js","sourceRoot":"","sources":["../../src/agentic-authorization-service.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAGlC,2DAAwE;AAExE,MAAa,4BAA4B;IAChC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,aAA4B,EAAE,eAAuB,EAAE,WAAwB;QACrH,MAAM,KAAK,GAAG,IAAA,qDAAiC,GAAE,CAAC;QAClD,OAAO,CAAC,MAAM,aAAa,CAAC,aAAa,CAAC,WAAW,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;IAC5G,CAAC;CACF;AALD,oEAKC"}

package/dist/cjs/environment-utils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Utility logic for environment-related operations.
+ */
+export declare const PROD_OBSERVABILITY_SCOPE = "https://api.powerplatform.com/.default";
+export declare const PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE = "ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default";
+export declare const PROD_OBSERVABILITY_CLUSTER_CATEGORY = "prod";
+export declare const PRODUCTION_ENVIRONMENT_NAME = "production";
+export declare const DEVELOPMENT_ENVIRONMENT_NAME = "Development";
+/**
+ * Returns the scope for authenticating to the observability service
+ *
+ * @returns The authentication scope for the current environment.
+ */
+export declare function getObservabilityAuthenticationScope(): string[];
+/**
+ * Gets the cluster category from environment variables.
+ *
+ * @returns The cluster category from CLUSTER_CATEGORY env var, defaults to 'prod'.
+ */
+export declare function getClusterCategory(): string;
+/**
+ * Returns true if the current environment is a development environment.
+ *
+ * @returns True if the current environment is development, false otherwise.
+ */
+export declare function isDevelopmentEnvironment(): boolean;
+/**
+ * Gets the MCP platform authentication scope from environment variables.
+ *
+ * @returns The MCP platform authentication scope from MCP_PLATFORM_AUTHENTICATION_SCOPE env var, defaults to production scope.
+ */
+export declare function getMcpPlatformAuthenticationScope(): string;
+//# sourceMappingURL=environment-utils.d.ts.map

package/dist/cjs/environment-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-utils.d.ts","sourceRoot":"","sources":["../../src/environment-utils.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,eAAO,MAAM,wBAAwB,2CAA2C,CAAC;AACjF,eAAO,MAAM,sCAAsC,kDAAkD,CAAC;AACtG,eAAO,MAAM,mCAAmC,SAAS,CAAC;AAG1D,eAAO,MAAM,2BAA2B,eAAe,CAAC;AACxD,eAAO,MAAM,4BAA4B,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,EAAE,CAG9D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAQ3C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,IAAI,MAAM,CAE1D"}

package/dist/cjs/environment-utils.js

@@ -0,0 +1,58 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEVELOPMENT_ENVIRONMENT_NAME = exports.PRODUCTION_ENVIRONMENT_NAME = exports.PROD_OBSERVABILITY_CLUSTER_CATEGORY = exports.PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE = exports.PROD_OBSERVABILITY_SCOPE = void 0;
+exports.getObservabilityAuthenticationScope = getObservabilityAuthenticationScope;
+exports.getClusterCategory = getClusterCategory;
+exports.isDevelopmentEnvironment = isDevelopmentEnvironment;
+exports.getMcpPlatformAuthenticationScope = getMcpPlatformAuthenticationScope;
+/**
+ * Utility logic for environment-related operations.
+ */
+exports.PROD_OBSERVABILITY_SCOPE = 'https://api.powerplatform.com/.default';
+exports.PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE = 'ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default';
+exports.PROD_OBSERVABILITY_CLUSTER_CATEGORY = 'prod';
+// Default environment names
+exports.PRODUCTION_ENVIRONMENT_NAME = 'production';
+exports.DEVELOPMENT_ENVIRONMENT_NAME = 'Development';
+/**
+ * Returns the scope for authenticating to the observability service
+ *
+ * @returns The authentication scope for the current environment.
+ */
+function getObservabilityAuthenticationScope() {
+    // Always return production scope
+    return [exports.PROD_OBSERVABILITY_SCOPE];
+}
+/**
+ * Gets the cluster category from environment variables.
+ *
+ * @returns The cluster category from CLUSTER_CATEGORY env var, defaults to 'prod'.
+ */
+function getClusterCategory() {
+    const clusterCategory = process.env.CLUSTER_CATEGORY;
+    if (!clusterCategory) {
+        return 'prod';
+    }
+    return clusterCategory.toLowerCase();
+}
+/**
+ * Returns true if the current environment is a development environment.
+ *
+ * @returns True if the current environment is development, false otherwise.
+ */
+function isDevelopmentEnvironment() {
+    const clusterCategory = getClusterCategory();
+    return ['local', 'dev'].includes(clusterCategory);
+}
+/**
+ * Gets the MCP platform authentication scope from environment variables.
+ *
+ * @returns The MCP platform authentication scope from MCP_PLATFORM_AUTHENTICATION_SCOPE env var, defaults to production scope.
+ */
+function getMcpPlatformAuthenticationScope() {
+    return process.env.MCP_PLATFORM_AUTHENTICATION_SCOPE || exports.PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE;
+}
+//# sourceMappingURL=environment-utils.js.map

package/dist/cjs/environment-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-utils.js","sourceRoot":"","sources":["../../src/environment-utils.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;;;AAmBjF,kFAGC;AAOD,gDAQC;AAOD,4DAGC;AAOD,8EAEC;AAtDD;;GAEG;AAEU,QAAA,wBAAwB,GAAG,wCAAwC,CAAC;AACpE,QAAA,sCAAsC,GAAG,+CAA+C,CAAC;AACzF,QAAA,mCAAmC,GAAG,MAAM,CAAC;AAE1D,4BAA4B;AACf,QAAA,2BAA2B,GAAG,YAAY,CAAC;AAC3C,QAAA,4BAA4B,GAAG,aAAa,CAAC;AAE1D;;;;GAIG;AACH,SAAgB,mCAAmC;IACjD,iCAAiC;IACjC,OAAO,CAAC,gCAAwB,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB;IAChC,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAErD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,eAAe,CAAC,WAAW,EAAE,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,SAAgB,wBAAwB;IACtC,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAC7C,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,SAAgB,iCAAiC;IAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,8CAAsC,CAAC;AACjG,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,5 @@
+export * from './power-platform-api-discovery';
+export * from './agentic-authorization-service';
+export * from './environment-utils';
+export * from './utility';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,21 @@
+"use strict";
+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("./power-platform-api-discovery"), exports);
+__exportStar(require("./agentic-authorization-service"), exports);
+__exportStar(require("./environment-utils"), exports);
+__exportStar(require("./utility"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAA+C;AAC/C,kEAAgD;AAChD,sDAAoC;AACpC,4CAA0B"}

package/dist/cjs/power-platform-api-discovery.d.ts

@@ -0,0 +1,13 @@
+export type ClusterCategory = 'local' | 'dev' | 'test' | 'preprod' | 'firstrelease' | 'prod' | 'gov' | 'high' | 'dod' | 'mooncake' | 'ex' | 'rx';
+export declare class PowerPlatformApiDiscovery {
+    readonly clusterCategory: ClusterCategory;
+    constructor(clusterCategory: ClusterCategory);
+    getTokenAudience(): string;
+    getTokenEndpointHost(): string;
+    getTenantEndpoint(tenantId: string): string;
+    getTenantIslandClusterEndpoint(tenantId: string): string;
+    private _generatePowerPlatformApiDomain;
+    private _getHexApiSuffixLength;
+    private _getEnvironmentApiHostNameSuffix;
+}
+//# sourceMappingURL=power-platform-api-discovery.d.ts.map

package/dist/cjs/power-platform-api-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"power-platform-api-discovery.d.ts","sourceRoot":"","sources":["../../src/power-platform-api-discovery.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,KAAK,GACL,MAAM,GACN,SAAS,GACT,cAAc,GACd,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,UAAU,GACV,IAAI,GACJ,IAAI,CAAC;AAET,qBAAa,yBAAyB;IACpC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;gBAE9B,eAAe,EAAE,eAAe;IAIrC,gBAAgB,IAAI,MAAM;IAI1B,oBAAoB,IAAI,MAAM;IAI9B,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI3C,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI/D,OAAO,CAAC,+BAA+B;IAkCvC,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,gCAAgC;CAuBzC"}

package/dist/cjs/power-platform-api-discovery.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PowerPlatformApiDiscovery = void 0;
+class PowerPlatformApiDiscovery {
+    constructor(clusterCategory) {
+        this.clusterCategory = clusterCategory;
+    }
+    getTokenAudience() {
+        return `https://${this._getEnvironmentApiHostNameSuffix()}`;
+    }
+    getTokenEndpointHost() {
+        return this._getEnvironmentApiHostNameSuffix();
+    }
+    getTenantEndpoint(tenantId) {
+        return this._generatePowerPlatformApiDomain(tenantId);
+    }
+    getTenantIslandClusterEndpoint(tenantId) {
+        return this._generatePowerPlatformApiDomain(tenantId, 'il-');
+    }
+    _generatePowerPlatformApiDomain(hostNameIdentifier, hostNamePrefix = '') {
+        if (!/^[a-zA-Z0-9-]+$/.test(hostNameIdentifier)) {
+            throw new Error(`Cannot generate Power Platform API endpoint because the tenant identifier contains invalid host name characters, only alphanumeric and dash characters are expected: ${hostNameIdentifier}`);
+        }
+        const hostNameInfix = 'tenant';
+        const hexNameSuffixLength = this._getHexApiSuffixLength();
+        const hexName = hostNameIdentifier.toLowerCase().replace(/-/g, '');
+        if (hexNameSuffixLength >= hexName.length) {
+            throw new Error(`Cannot generate Power Platform API endpoint because the normalized tenant identifier must be at least ${hexNameSuffixLength + 1} characters in length: ${hexName}`);
+        }
+        const hexNameSuffix = hexName.substring(hexName.length - hexNameSuffixLength);
+        const hexNamePrefix = hexName.substring(0, hexName.length - hexNameSuffixLength);
+        const hostNameSuffix = this._getEnvironmentApiHostNameSuffix();
+        return `${hostNamePrefix}${hexNamePrefix}.${hexNameSuffix}.${hostNameInfix}.${hostNameSuffix}`;
+    }
+    _getHexApiSuffixLength() {
+        switch (this.clusterCategory) {
+            case 'firstrelease':
+            case 'prod':
+                return 2;
+            default:
+                return 1;
+        }
+    }
+    _getEnvironmentApiHostNameSuffix() {
+        const apiHostNameSuffixMap = {
+            local: 'api.powerplatform.localhost',
+            dev: 'api.powerplatform.com', //default to prod
+            test: 'api.powerplatform.com', //default to prod
+            preprod: 'api.powerplatform.com', //default to prod
+            firstrelease: 'api.powerplatform.com',
+            prod: 'api.powerplatform.com',
+            gov: 'api.gov.powerplatform.microsoft.us',
+            high: 'api.high.powerplatform.microsoft.us',
+            dod: 'api.appsplatform.us',
+            mooncake: 'api.powerplatform.partner.microsoftonline.cn',
+            ex: 'api.powerplatform.eaglex.ic.gov',
+            rx: 'api.powerplatform.microsoft.scloud',
+        };
+        const suffix = apiHostNameSuffixMap[this.clusterCategory];
+        if (!suffix) {
+            throw new Error(`Invalid ClusterCategory value: ${this.clusterCategory}`);
+        }
+        return suffix;
+    }
+}
+exports.PowerPlatformApiDiscovery = PowerPlatformApiDiscovery;
+//# sourceMappingURL=power-platform-api-discovery.js.map

package/dist/cjs/power-platform-api-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"power-platform-api-discovery.js","sourceRoot":"","sources":["../../src/power-platform-api-discovery.ts"],"names":[],"mappings":";;;AAcA,MAAa,yBAAyB;IAGpC,YAAY,eAAgC;QAC1C,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAEM,gBAAgB;QACrB,OAAO,WAAW,IAAI,CAAC,gCAAgC,EAAE,EAAE,CAAC;IAC9D,CAAC;IAEM,oBAAoB;QACzB,OAAO,IAAI,CAAC,gCAAgC,EAAE,CAAC;IACjD,CAAC;IAEM,iBAAiB,CAAC,QAAgB;QACvC,OAAO,IAAI,CAAC,+BAA+B,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IAEM,8BAA8B,CAAC,QAAgB;QACpD,OAAO,IAAI,CAAC,+BAA+B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IAEO,+BAA+B,CACrC,kBAA0B,EAC1B,iBAAyB,EAAE;QAE3B,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,wKAAwK,kBAAkB,EAAE,CAC7L,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG,QAAQ,CAAC;QAC/B,MAAM,mBAAmB,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAEnE,IAAI,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,yGACE,mBAAmB,GAAG,CACxB,0BAA0B,OAAO,EAAE,CACpC,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CACrC,OAAO,CAAC,MAAM,GAAG,mBAAmB,CACrC,CAAC;QACF,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CACrC,CAAC,EACD,OAAO,CAAC,MAAM,GAAG,mBAAmB,CACrC,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,CAAC,gCAAgC,EAAE,CAAC;QAE/D,OAAO,GAAG,cAAc,GAAG,aAAa,IAAI,aAAa,IAAI,aAAa,IAAI,cAAc,EAAE,CAAC;IACjG,CAAC;IAEO,sBAAsB;QAC5B,QAAQ,IAAI,CAAC,eAAe,EAAE,CAAC;YAC/B,KAAK,cAAc,CAAC;YACpB,KAAK,MAAM;gBACT,OAAO,CAAC,CAAC;YACX;gBACE,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAEO,gCAAgC;QACtC,MAAM,oBAAoB,GAA8C;YACtE,KAAK,EAAE,6BAA6B;YACpC,GAAG,EAAE,uBAAuB,EAAE,iBAAiB;YAC/C,IAAI,EAAE,uBAAuB,EAAE,iBAAiB;YAChD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB;YACnD,YAAY,EAAE,uBAAuB;YACrC,IAAI,EAAE,uBAAuB;YAC7B,GAAG,EAAE,oCAAoC;YACzC,IAAI,EAAE,qCAAqC;YAC3C,GAAG,EAAE,qBAAqB;YAC1B,QAAQ,EAAE,8CAA8C;YACxD,EAAE,EAAE,iCAAiC;YACrC,EAAE,EAAE,oCAAoC;SACzC,CAAC;QACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,CAAC,eAAe,EAAE,CACzD,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA1FD,8DA0FC"}

package/dist/cjs/utility.d.ts

@@ -0,0 +1,20 @@
+import { TurnContext } from '@microsoft/agents-hosting';
+/**
+ * Utility class providing helper methods for agent runtime operations.
+ */
+export declare class Utility {
+    /**
+     * Decodes the current token and retrieves the App ID (appid or azp claim).
+     * @param token Token to Decode
+     * @returns AppId
+     */
+    static GetAppIdFromToken(token: string): string;
+    /**
+     * Resolves the agent identity from the turn context or auth token.
+     * @param context Turn Context of the turn.
+     * @param authToken Auth token if available.
+     * @returns Agent identity (App ID)
+     */
+    static ResolveAgentIdentity(context: TurnContext, authToken: string): string;
+}
+//# sourceMappingURL=utility.d.ts.map

package/dist/cjs/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../src/utility.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD;;GAEG;AACH,qBAAa,OAAO;IAClB;;;;OAIG;WACW,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAoBtD;;;;;OAKG;WACW,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;CAQpF"}

package/dist/cjs/utility.js

@@ -0,0 +1,82 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// 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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Utility = void 0;
+const jwt = __importStar(require("jsonwebtoken"));
+/**
+ * Utility class providing helper methods for agent runtime operations.
+ */
+class Utility {
+    /**
+     * Decodes the current token and retrieves the App ID (appid or azp claim).
+     * @param token Token to Decode
+     * @returns AppId
+     */
+    static GetAppIdFromToken(token) {
+        if (!token || token.trim() === '') {
+            return '00000000-0000-0000-0000-000000000000';
+        }
+        try {
+            const decoded = jwt.decode(token);
+            if (!decoded) {
+                return '';
+            }
+            // Look for appid claim first, then azp claim as fallback
+            const appIdClaim = decoded['appid'] || decoded['azp'];
+            return appIdClaim || '';
+        }
+        catch (_error) {
+            // Silent error handling - return empty string on decode failure
+            return '';
+        }
+    }
+    /**
+     * Resolves the agent identity from the turn context or auth token.
+     * @param context Turn Context of the turn.
+     * @param authToken Auth token if available.
+     * @returns Agent identity (App ID)
+     */
+    static ResolveAgentIdentity(context, authToken) {
+        // App ID is required to pass to MCP server URL.
+        const agenticAppId = context.activity.isAgenticRequest()
+            ? context.activity.getAgenticInstanceId() || ''
+            : this.GetAppIdFromToken(authToken);
+        return agenticAppId;
+    }
+}
+exports.Utility = Utility;
+//# sourceMappingURL=utility.js.map

package/dist/cjs/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../../src/utility.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGlC,kDAAoC;AAEpC;;GAEG;AACH,MAAa,OAAO;IAClB;;;;OAIG;IACI,MAAM,CAAC,iBAAiB,CAAC,KAAa;QAC3C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAClC,OAAO,sCAAsC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAmB,CAAC;YACpD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,yDAAyD;YACzD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;YACtD,OAAO,UAAU,IAAI,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,gEAAgE;YAChE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,oBAAoB,CAAC,OAAoB,EAAE,SAAiB;QACxE,gDAAgD;QAChD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,EAAE;YACtD,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,EAAE,IAAI,EAAE;YAC/C,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEtC,OAAO,YAAY,CAAC;IACtB,CAAC;CACF;AAxCD,0BAwCC"}

package/dist/esm/agentic-authorization-service.d.ts

@@ -0,0 +1,5 @@
+import { TurnContext, Authorization } from '@microsoft/agents-hosting';
+export declare class AgenticAuthenticationService {
+    static GetAgenticUserToken(authorization: Authorization, authHandlerName: string, turnContext: TurnContext): Promise<string>;
+}
+//# sourceMappingURL=agentic-authorization-service.d.ts.map

package/dist/esm/agentic-authorization-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-authorization-service.d.ts","sourceRoot":"","sources":["../../src/agentic-authorization-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGvE,qBAAa,4BAA4B;WACnB,mBAAmB,CAAC,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW;CAIxH"}

package/dist/esm/agentic-authorization-service.js

@@ -0,0 +1,10 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { getMcpPlatformAuthenticationScope } from './environment-utils';
+export class AgenticAuthenticationService {
+    static async GetAgenticUserToken(authorization, authHandlerName, turnContext) {
+        const scope = getMcpPlatformAuthenticationScope();
+        return (await authorization.exchangeToken(turnContext, authHandlerName, { scopes: [scope] })).token || '';
+    }
+}
+//# sourceMappingURL=agentic-authorization-service.js.map

package/dist/esm/agentic-authorization-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-authorization-service.js","sourceRoot":"","sources":["../../src/agentic-authorization-service.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAGlC,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAExE,MAAM,OAAO,4BAA4B;IAChC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,aAA4B,EAAE,eAAuB,EAAE,WAAwB;QACrH,MAAM,KAAK,GAAG,iCAAiC,EAAE,CAAC;QAClD,OAAO,CAAC,MAAM,aAAa,CAAC,aAAa,CAAC,WAAW,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;IAC5G,CAAC;CACF"}

package/dist/esm/environment-utils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Utility logic for environment-related operations.
+ */
+export declare const PROD_OBSERVABILITY_SCOPE = "https://api.powerplatform.com/.default";
+export declare const PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE = "ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default";
+export declare const PROD_OBSERVABILITY_CLUSTER_CATEGORY = "prod";
+export declare const PRODUCTION_ENVIRONMENT_NAME = "production";
+export declare const DEVELOPMENT_ENVIRONMENT_NAME = "Development";
+/**
+ * Returns the scope for authenticating to the observability service
+ *
+ * @returns The authentication scope for the current environment.
+ */
+export declare function getObservabilityAuthenticationScope(): string[];
+/**
+ * Gets the cluster category from environment variables.
+ *
+ * @returns The cluster category from CLUSTER_CATEGORY env var, defaults to 'prod'.
+ */
+export declare function getClusterCategory(): string;
+/**
+ * Returns true if the current environment is a development environment.
+ *
+ * @returns True if the current environment is development, false otherwise.
+ */
+export declare function isDevelopmentEnvironment(): boolean;
+/**
+ * Gets the MCP platform authentication scope from environment variables.
+ *
+ * @returns The MCP platform authentication scope from MCP_PLATFORM_AUTHENTICATION_SCOPE env var, defaults to production scope.
+ */
+export declare function getMcpPlatformAuthenticationScope(): string;
+//# sourceMappingURL=environment-utils.d.ts.map

package/dist/esm/environment-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-utils.d.ts","sourceRoot":"","sources":["../../src/environment-utils.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,eAAO,MAAM,wBAAwB,2CAA2C,CAAC;AACjF,eAAO,MAAM,sCAAsC,kDAAkD,CAAC;AACtG,eAAO,MAAM,mCAAmC,SAAS,CAAC;AAG1D,eAAO,MAAM,2BAA2B,eAAe,CAAC;AACxD,eAAO,MAAM,4BAA4B,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,EAAE,CAG9D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAQ3C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,IAAI,MAAM,CAE1D"}

package/dist/esm/environment-utils.js

@@ -0,0 +1,51 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+/**
+ * Utility logic for environment-related operations.
+ */
+export const PROD_OBSERVABILITY_SCOPE = 'https://api.powerplatform.com/.default';
+export const PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE = 'ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default';
+export const PROD_OBSERVABILITY_CLUSTER_CATEGORY = 'prod';
+// Default environment names
+export const PRODUCTION_ENVIRONMENT_NAME = 'production';
+export const DEVELOPMENT_ENVIRONMENT_NAME = 'Development';
+/**
+ * Returns the scope for authenticating to the observability service
+ *
+ * @returns The authentication scope for the current environment.
+ */
+export function getObservabilityAuthenticationScope() {
+    // Always return production scope
+    return [PROD_OBSERVABILITY_SCOPE];
+}
+/**
+ * Gets the cluster category from environment variables.
+ *
+ * @returns The cluster category from CLUSTER_CATEGORY env var, defaults to 'prod'.
+ */
+export function getClusterCategory() {
+    const clusterCategory = process.env.CLUSTER_CATEGORY;
+    if (!clusterCategory) {
+        return 'prod';
+    }
+    return clusterCategory.toLowerCase();
+}
+/**
+ * Returns true if the current environment is a development environment.
+ *
+ * @returns True if the current environment is development, false otherwise.
+ */
+export function isDevelopmentEnvironment() {
+    const clusterCategory = getClusterCategory();
+    return ['local', 'dev'].includes(clusterCategory);
+}
+/**
+ * Gets the MCP platform authentication scope from environment variables.
+ *
+ * @returns The MCP platform authentication scope from MCP_PLATFORM_AUTHENTICATION_SCOPE env var, defaults to production scope.
+ */
+export function getMcpPlatformAuthenticationScope() {
+    return process.env.MCP_PLATFORM_AUTHENTICATION_SCOPE || PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE;
+}
+//# sourceMappingURL=environment-utils.js.map

package/dist/esm/environment-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-utils.js","sourceRoot":"","sources":["../../src/environment-utils.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;AAEjF;;GAEG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,wCAAwC,CAAC;AACjF,MAAM,CAAC,MAAM,sCAAsC,GAAG,+CAA+C,CAAC;AACtG,MAAM,CAAC,MAAM,mCAAmC,GAAG,MAAM,CAAC;AAE1D,4BAA4B;AAC5B,MAAM,CAAC,MAAM,2BAA2B,GAAG,YAAY,CAAC;AACxD,MAAM,CAAC,MAAM,4BAA4B,GAAG,aAAa,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,mCAAmC;IACjD,iCAAiC;IACjC,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAErD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,eAAe,CAAC,WAAW,EAAE,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAC7C,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iCAAiC;IAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,sCAAsC,CAAC;AACjG,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+export * from './power-platform-api-discovery';
+export * from './agentic-authorization-service';
+export * from './environment-utils';
+export * from './utility';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+export * from './power-platform-api-discovery';
+export * from './agentic-authorization-service';
+export * from './environment-utils';
+export * from './utility';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC"}

package/dist/esm/power-platform-api-discovery.d.ts

@@ -0,0 +1,13 @@
+export type ClusterCategory = 'local' | 'dev' | 'test' | 'preprod' | 'firstrelease' | 'prod' | 'gov' | 'high' | 'dod' | 'mooncake' | 'ex' | 'rx';
+export declare class PowerPlatformApiDiscovery {
+    readonly clusterCategory: ClusterCategory;
+    constructor(clusterCategory: ClusterCategory);
+    getTokenAudience(): string;
+    getTokenEndpointHost(): string;
+    getTenantEndpoint(tenantId: string): string;
+    getTenantIslandClusterEndpoint(tenantId: string): string;
+    private _generatePowerPlatformApiDomain;
+    private _getHexApiSuffixLength;
+    private _getEnvironmentApiHostNameSuffix;
+}
+//# sourceMappingURL=power-platform-api-discovery.d.ts.map

package/dist/esm/power-platform-api-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"power-platform-api-discovery.d.ts","sourceRoot":"","sources":["../../src/power-platform-api-discovery.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,KAAK,GACL,MAAM,GACN,SAAS,GACT,cAAc,GACd,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,UAAU,GACV,IAAI,GACJ,IAAI,CAAC;AAET,qBAAa,yBAAyB;IACpC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;gBAE9B,eAAe,EAAE,eAAe;IAIrC,gBAAgB,IAAI,MAAM;IAI1B,oBAAoB,IAAI,MAAM;IAI9B,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI3C,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI/D,OAAO,CAAC,+BAA+B;IAkCvC,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,gCAAgC;CAuBzC"}

package/dist/esm/power-platform-api-discovery.js

@@ -0,0 +1,63 @@
+export class PowerPlatformApiDiscovery {
+    constructor(clusterCategory) {
+        this.clusterCategory = clusterCategory;
+    }
+    getTokenAudience() {
+        return `https://${this._getEnvironmentApiHostNameSuffix()}`;
+    }
+    getTokenEndpointHost() {
+        return this._getEnvironmentApiHostNameSuffix();
+    }
+    getTenantEndpoint(tenantId) {
+        return this._generatePowerPlatformApiDomain(tenantId);
+    }
+    getTenantIslandClusterEndpoint(tenantId) {
+        return this._generatePowerPlatformApiDomain(tenantId, 'il-');
+    }
+    _generatePowerPlatformApiDomain(hostNameIdentifier, hostNamePrefix = '') {
+        if (!/^[a-zA-Z0-9-]+$/.test(hostNameIdentifier)) {
+            throw new Error(`Cannot generate Power Platform API endpoint because the tenant identifier contains invalid host name characters, only alphanumeric and dash characters are expected: ${hostNameIdentifier}`);
+        }
+        const hostNameInfix = 'tenant';
+        const hexNameSuffixLength = this._getHexApiSuffixLength();
+        const hexName = hostNameIdentifier.toLowerCase().replace(/-/g, '');
+        if (hexNameSuffixLength >= hexName.length) {
+            throw new Error(`Cannot generate Power Platform API endpoint because the normalized tenant identifier must be at least ${hexNameSuffixLength + 1} characters in length: ${hexName}`);
+        }
+        const hexNameSuffix = hexName.substring(hexName.length - hexNameSuffixLength);
+        const hexNamePrefix = hexName.substring(0, hexName.length - hexNameSuffixLength);
+        const hostNameSuffix = this._getEnvironmentApiHostNameSuffix();
+        return `${hostNamePrefix}${hexNamePrefix}.${hexNameSuffix}.${hostNameInfix}.${hostNameSuffix}`;
+    }
+    _getHexApiSuffixLength() {
+        switch (this.clusterCategory) {
+            case 'firstrelease':
+            case 'prod':
+                return 2;
+            default:
+                return 1;
+        }
+    }
+    _getEnvironmentApiHostNameSuffix() {
+        const apiHostNameSuffixMap = {
+            local: 'api.powerplatform.localhost',
+            dev: 'api.powerplatform.com', //default to prod
+            test: 'api.powerplatform.com', //default to prod
+            preprod: 'api.powerplatform.com', //default to prod
+            firstrelease: 'api.powerplatform.com',
+            prod: 'api.powerplatform.com',
+            gov: 'api.gov.powerplatform.microsoft.us',
+            high: 'api.high.powerplatform.microsoft.us',
+            dod: 'api.appsplatform.us',
+            mooncake: 'api.powerplatform.partner.microsoftonline.cn',
+            ex: 'api.powerplatform.eaglex.ic.gov',
+            rx: 'api.powerplatform.microsoft.scloud',
+        };
+        const suffix = apiHostNameSuffixMap[this.clusterCategory];
+        if (!suffix) {
+            throw new Error(`Invalid ClusterCategory value: ${this.clusterCategory}`);
+        }
+        return suffix;
+    }
+}
+//# sourceMappingURL=power-platform-api-discovery.js.map

package/dist/esm/power-platform-api-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"power-platform-api-discovery.js","sourceRoot":"","sources":["../../src/power-platform-api-discovery.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,yBAAyB;IAGpC,YAAY,eAAgC;QAC1C,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAEM,gBAAgB;QACrB,OAAO,WAAW,IAAI,CAAC,gCAAgC,EAAE,EAAE,CAAC;IAC9D,CAAC;IAEM,oBAAoB;QACzB,OAAO,IAAI,CAAC,gCAAgC,EAAE,CAAC;IACjD,CAAC;IAEM,iBAAiB,CAAC,QAAgB;QACvC,OAAO,IAAI,CAAC,+BAA+B,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IAEM,8BAA8B,CAAC,QAAgB;QACpD,OAAO,IAAI,CAAC,+BAA+B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IAEO,+BAA+B,CACrC,kBAA0B,EAC1B,iBAAyB,EAAE;QAE3B,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,wKAAwK,kBAAkB,EAAE,CAC7L,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG,QAAQ,CAAC;QAC/B,MAAM,mBAAmB,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAEnE,IAAI,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,yGACE,mBAAmB,GAAG,CACxB,0BAA0B,OAAO,EAAE,CACpC,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CACrC,OAAO,CAAC,MAAM,GAAG,mBAAmB,CACrC,CAAC;QACF,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CACrC,CAAC,EACD,OAAO,CAAC,MAAM,GAAG,mBAAmB,CACrC,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,CAAC,gCAAgC,EAAE,CAAC;QAE/D,OAAO,GAAG,cAAc,GAAG,aAAa,IAAI,aAAa,IAAI,aAAa,IAAI,cAAc,EAAE,CAAC;IACjG,CAAC;IAEO,sBAAsB;QAC5B,QAAQ,IAAI,CAAC,eAAe,EAAE,CAAC;YAC/B,KAAK,cAAc,CAAC;YACpB,KAAK,MAAM;gBACT,OAAO,CAAC,CAAC;YACX;gBACE,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAEO,gCAAgC;QACtC,MAAM,oBAAoB,GAA8C;YACtE,KAAK,EAAE,6BAA6B;YACpC,GAAG,EAAE,uBAAuB,EAAE,iBAAiB;YAC/C,IAAI,EAAE,uBAAuB,EAAE,iBAAiB;YAChD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB;YACnD,YAAY,EAAE,uBAAuB;YACrC,IAAI,EAAE,uBAAuB;YAC7B,GAAG,EAAE,oCAAoC;YACzC,IAAI,EAAE,qCAAqC;YAC3C,GAAG,EAAE,qBAAqB;YAC1B,QAAQ,EAAE,8CAA8C;YACxD,EAAE,EAAE,iCAAiC;YACrC,EAAE,EAAE,oCAAoC;SACzC,CAAC;QACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,CAAC,eAAe,EAAE,CACzD,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/esm/utility.d.ts

@@ -0,0 +1,20 @@
+import { TurnContext } from '@microsoft/agents-hosting';
+/**
+ * Utility class providing helper methods for agent runtime operations.
+ */
+export declare class Utility {
+    /**
+     * Decodes the current token and retrieves the App ID (appid or azp claim).
+     * @param token Token to Decode
+     * @returns AppId
+     */
+    static GetAppIdFromToken(token: string): string;
+    /**
+     * Resolves the agent identity from the turn context or auth token.
+     * @param context Turn Context of the turn.
+     * @param authToken Auth token if available.
+     * @returns Agent identity (App ID)
+     */
+    static ResolveAgentIdentity(context: TurnContext, authToken: string): string;
+}
+//# sourceMappingURL=utility.d.ts.map

package/dist/esm/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../src/utility.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD;;GAEG;AACH,qBAAa,OAAO;IAClB;;;;OAIG;WACW,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAoBtD;;;;;OAKG;WACW,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;CAQpF"}

package/dist/esm/utility.js

@@ -0,0 +1,45 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import * as jwt from 'jsonwebtoken';
+/**
+ * Utility class providing helper methods for agent runtime operations.
+ */
+export class Utility {
+    /**
+     * Decodes the current token and retrieves the App ID (appid or azp claim).
+     * @param token Token to Decode
+     * @returns AppId
+     */
+    static GetAppIdFromToken(token) {
+        if (!token || token.trim() === '') {
+            return '00000000-0000-0000-0000-000000000000';
+        }
+        try {
+            const decoded = jwt.decode(token);
+            if (!decoded) {
+                return '';
+            }
+            // Look for appid claim first, then azp claim as fallback
+            const appIdClaim = decoded['appid'] || decoded['azp'];
+            return appIdClaim || '';
+        }
+        catch (_error) {
+            // Silent error handling - return empty string on decode failure
+            return '';
+        }
+    }
+    /**
+     * Resolves the agent identity from the turn context or auth token.
+     * @param context Turn Context of the turn.
+     * @param authToken Auth token if available.
+     * @returns Agent identity (App ID)
+     */
+    static ResolveAgentIdentity(context, authToken) {
+        // App ID is required to pass to MCP server URL.
+        const agenticAppId = context.activity.isAgenticRequest()
+            ? context.activity.getAgenticInstanceId() || ''
+            : this.GetAppIdFromToken(authToken);
+        return agenticAppId;
+    }
+}
+//# sourceMappingURL=utility.js.map

package/dist/esm/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../../src/utility.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAGlC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,OAAO;IAClB;;;;OAIG;IACI,MAAM,CAAC,iBAAiB,CAAC,KAAa;QAC3C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAClC,OAAO,sCAAsC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAmB,CAAC;YACpD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,yDAAyD;YACzD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;YACtD,OAAO,UAAU,IAAI,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,gEAAgE;YAChE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,oBAAoB,CAAC,OAAoB,EAAE,SAAiB;QACxE,gDAAgD;QAChD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,EAAE;YACtD,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,EAAE,IAAI,EAAE;YAC/C,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEtC,OAAO,YAAY,CAAC;IACtB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@microsoft/agents-a365-runtime",
+  "version": "0.1.0-preview.30",
+  "description": "Agent 365 Runtime SDK for AI agents built with TypeScript/Node.js",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "scripts": {
+    "build:cjs": "npx tsc --project tsconfig.cjs.json",
+    "build:esm": "npx tsc --project tsconfig.esm.json",
+    "build": "npm run build:cjs && npm run build:esm",
+    "build:watch": "npx tsc --watch",
+    "clean": "npx rimraf dist",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "prepublishOnly": "npm run clean && npm run build",
+    "ci": "npm ci",
+    "pack": "npm pack --pack-destination=../"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "azure",
+    "typescript"
+  ],
+  "author": "Microsoft Corporation",
+  "license": "See license file",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/Agent365-nodejs.git",
+    "directory": "packages/agents-a365-runtime"
+  },
+  "dependencies": {
+    "@microsoft/agents-hosting": "*",
+    "@azure/identity": "*",
+    "jsonwebtoken": "^9.0.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0",
+    "rimraf": "^5.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "CHANGELOG.md"
+  ]
+}