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

package/dist/cjs/environment-utils.js

@@ -0,0 +1,121 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+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.
+ *
+ * Note: These utility functions are maintained for backward compatibility.
+ * For new code, prefer using the configuration classes directly:
+ * - RuntimeConfiguration for clusterCategory, isDevelopmentEnvironment, isNodeEnvDevelopment
+ * - ToolingConfiguration for mcpPlatformAuthenticationScope
+ * - ObservabilityConfiguration for observabilityAuthenticationScopes
+ */
+const configuration_1 = require("./configuration");
+/**
+ * Production observability authentication scope.
+ * @deprecated This constant is exported for backward compatibility only.
+ * For new code, use `ObservabilityConfiguration.observabilityAuthenticationScopes` instead.
+ */
+exports.PROD_OBSERVABILITY_SCOPE = 'https://api.powerplatform.com/.default';
+/**
+ * Production MCP platform authentication scope.
+ * @deprecated This constant is exported for backward compatibility only.
+ * For new code, use `ToolingConfiguration.mcpPlatformAuthenticationScope` instead.
+ */
+exports.PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE = 'ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default';
+/**
+ * Default cluster category for production environments.
+ * @deprecated This constant is exported for backward compatibility only.
+ * For new code, use `RuntimeConfiguration.clusterCategory` instead.
+ */
+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 scopes for the current environment.
+ * @deprecated Use ObservabilityConfiguration.observabilityAuthenticationScopes instead.
+ *
+ * @example
+ * // Before:
+ * import { getObservabilityAuthenticationScope } from '@microsoft/agents-a365-runtime';
+ * const scopes = getObservabilityAuthenticationScope();
+ *
+ * // After:
+ * import { defaultObservabilityConfigurationProvider } from '@microsoft/agents-a365-observability';
+ * const scopes = [...defaultObservabilityConfigurationProvider.getConfiguration().observabilityAuthenticationScopes];
+ */
+function getObservabilityAuthenticationScope() {
+    // Returns production default - use ObservabilityConfiguration for proper env var support
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- Intentional: deprecated function using deprecated constant
+    return [exports.PROD_OBSERVABILITY_SCOPE];
+}
+/**
+ * Gets the cluster category from environment variables.
+ *
+ * @param configProvider Optional configuration provider. Defaults to defaultRuntimeConfigurationProvider if not specified.
+ * @returns The cluster category from CLUSTER_CATEGORY env var, defaults to 'prod'.
+ * @deprecated Use RuntimeConfiguration.clusterCategory instead.
+ *
+ * @example
+ * // Before:
+ * import { getClusterCategory } from '@microsoft/agents-a365-runtime';
+ * const cluster = getClusterCategory();
+ *
+ * // After:
+ * import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime';
+ * const cluster = defaultRuntimeConfigurationProvider.getConfiguration().clusterCategory;
+ */
+function getClusterCategory(configProvider) {
+    const provider = configProvider ?? configuration_1.defaultRuntimeConfigurationProvider;
+    return provider.getConfiguration().clusterCategory;
+}
+/**
+ * Returns true if the current environment is a development environment.
+ *
+ * @param configProvider Optional configuration provider. Defaults to defaultRuntimeConfigurationProvider if not specified.
+ * @returns True if the current environment is development, false otherwise.
+ * @deprecated Use RuntimeConfiguration.isDevelopmentEnvironment instead.
+ *
+ * @example
+ * // Before:
+ * import { isDevelopmentEnvironment } from '@microsoft/agents-a365-runtime';
+ * if (isDevelopmentEnvironment()) { ... }
+ *
+ * // After:
+ * import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime';
+ * if (defaultRuntimeConfigurationProvider.getConfiguration().isDevelopmentEnvironment) { ... }
+ */
+function isDevelopmentEnvironment(configProvider) {
+    const provider = configProvider ?? configuration_1.defaultRuntimeConfigurationProvider;
+    return provider.getConfiguration().isDevelopmentEnvironment;
+}
+/**
+ * Gets the MCP platform authentication scope.
+ *
+ * @returns The MCP platform authentication scope.
+ * @deprecated Use ToolingConfiguration.mcpPlatformAuthenticationScope instead.
+ *
+ * @example
+ * // Before:
+ * import { getMcpPlatformAuthenticationScope } from '@microsoft/agents-a365-runtime';
+ * const scope = getMcpPlatformAuthenticationScope();
+ *
+ * // After:
+ * import { defaultToolingConfigurationProvider } from '@microsoft/agents-a365-tooling';
+ * const scope = defaultToolingConfigurationProvider.getConfiguration().mcpPlatformAuthenticationScope;
+ */
+function getMcpPlatformAuthenticationScope() {
+    // Returns production default - use ToolingConfiguration for proper env var support
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- Intentional: deprecated function using deprecated constant
+    return 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,uCAAuC;AACvC,kCAAkC;;;AAuDlC,kFAIC;AAkBD,gDAKC;AAkBD,4DAKC;AAiBD,8EAIC;AA5HD;;;;;;;;GAQG;AAEH,mDAA4F;AAG5F;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,wCAAwC,CAAC;AAEjF;;;;GAIG;AACU,QAAA,sCAAsC,GAAG,+CAA+C,CAAC;AAEtG;;;;GAIG;AACU,QAAA,mCAAmC,GAAG,MAAM,CAAC;AAE1D,4BAA4B;AACf,QAAA,2BAA2B,GAAG,YAAY,CAAC;AAC3C,QAAA,4BAA4B,GAAG,aAAa,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,SAAgB,mCAAmC;IACjD,yFAAyF;IACzF,0HAA0H;IAC1H,OAAO,CAAC,gCAAwB,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,kBAAkB,CAChC,cAA6D;IAE7D,MAAM,QAAQ,GAAG,cAAc,IAAI,mDAAmC,CAAC;IACvE,OAAO,QAAQ,CAAC,gBAAgB,EAAE,CAAC,eAAe,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,wBAAwB,CACtC,cAA6D;IAE7D,MAAM,QAAQ,GAAG,cAAc,IAAI,mDAAmC,CAAC;IACvE,OAAO,QAAQ,CAAC,gBAAgB,EAAE,CAAC,wBAAwB,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,iCAAiC;IAC/C,mFAAmF;IACnF,0HAA0H;IAC1H,OAAO,8CAAsC,CAAC;AAChD,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,8 @@
+export * from './power-platform-api-discovery';
+export * from './environment-utils';
+export * from './utility';
+export * from './agentic-authorization-service';
+export * from './operation-error';
+export * from './operation-result';
+export * from './configuration';
+//# 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":"AAGA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,26 @@
+"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 __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("./environment-utils"), exports);
+__exportStar(require("./utility"), exports);
+__exportStar(require("./agentic-authorization-service"), exports);
+__exportStar(require("./operation-error"), exports);
+__exportStar(require("./operation-result"), exports);
+__exportStar(require("./configuration"), 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,uCAAuC;AACvC,kCAAkC;;;;;;;;;;;;;;;;AAElC,iEAA+C;AAC/C,sDAAoC;AACpC,4CAA0B;AAC1B,kEAAgD;AAChD,oDAAkC;AAClC,qDAAmC;AACnC,kDAAgC"}

package/dist/cjs/operation-error.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Encapsulates an error from an operation.
+ */
+export declare class OperationError {
+    /**
+     * Gets the exception associated with the error.
+     */
+    readonly exception: Error;
+    /**
+     * Gets the message associated with the error.
+     */
+    get message(): string;
+    /**
+     * Initializes a new instance of the OperationError class.
+     * @param exception The exception associated with the error.
+     */
+    constructor(exception: Error);
+    /**
+     * Returns a string representation of the error.
+     * @returns A string representation of the error.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=operation-error.d.ts.map

package/dist/cjs/operation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-error.d.ts","sourceRoot":"","sources":["../../src/operation-error.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,SAAgB,SAAS,EAAE,KAAK,CAAC;IAEjC;;OAEG;IACH,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED;;;OAGG;gBACS,SAAS,EAAE,KAAK;IAO5B;;;OAGG;IACI,QAAQ,IAAI,MAAM;CAG1B"}

package/dist/cjs/operation-error.js

@@ -0,0 +1,35 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationError = void 0;
+/**
+ * Encapsulates an error from an operation.
+ */
+class OperationError {
+    /**
+     * Gets the message associated with the error.
+     */
+    get message() {
+        return this.exception.message;
+    }
+    /**
+     * Initializes a new instance of the OperationError class.
+     * @param exception The exception associated with the error.
+     */
+    constructor(exception) {
+        if (!exception) {
+            throw new Error('exception is required');
+        }
+        this.exception = exception;
+    }
+    /**
+     * Returns a string representation of the error.
+     * @returns A string representation of the error.
+     */
+    toString() {
+        return this.exception.toString();
+    }
+}
+exports.OperationError = OperationError;
+//# sourceMappingURL=operation-error.js.map

package/dist/cjs/operation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-error.js","sourceRoot":"","sources":["../../src/operation-error.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC;;GAEG;AACH,MAAa,cAAc;IAMzB;;OAEG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,YAAY,SAAgB;QAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACI,QAAQ;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;CACF;AA/BD,wCA+BC"}

package/dist/cjs/operation-result.d.ts

@@ -0,0 +1,41 @@
+import { OperationError } from './operation-error';
+/**
+ * Represents the result of an operation.
+ */
+export declare class OperationResult {
+    private static readonly _success;
+    private readonly _errors;
+    /**
+     * Gets a flag indicating whether the operation succeeded.
+     */
+    readonly succeeded: boolean;
+    /**
+     * Gets an array of OperationError instances indicating errors that occurred during the operation.
+     */
+    get errors(): OperationError[];
+    /**
+     * Private constructor for OperationResult.
+     * @param succeeded Whether the operation succeeded.
+     * @param errors Optional array of errors.
+     */
+    private constructor();
+    /**
+     * Returns an OperationResult indicating a successful operation.
+     */
+    static get success(): OperationResult;
+    /**
+     * Creates an OperationResult indicating a failed operation, with a list of errors if applicable.
+     * @param errors An optional array of OperationError which caused the operation to fail.
+     * @returns An OperationResult indicating a failed operation, with a list of errors if applicable.
+     */
+    static failed(...errors: OperationError[]): OperationResult;
+    /**
+     * Converts the value of the current OperationResult object to its equivalent string representation.
+     * @returns A string representation of the current OperationResult object.
+     * @remarks
+     * If the operation was successful the toString() will return "Succeeded" otherwise it will return
+     * "Failed : " followed by a comma delimited list of error messages from its errors collection, if any.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=operation-result.d.ts.map

package/dist/cjs/operation-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-result.d.ts","sourceRoot":"","sources":["../../src/operation-result.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C;;OAEG;IACH,SAAgB,SAAS,EAAE,OAAO,CAAC;IAEnC;;OAEG;IACH,IAAW,MAAM,IAAI,cAAc,EAAE,CAEpC;IAED;;;;OAIG;IACH,OAAO;IAKP;;OAEG;IACH,WAAkB,OAAO,IAAI,eAAe,CAE3C;IAED;;;;OAIG;WACW,MAAM,CAAC,GAAG,MAAM,EAAE,cAAc,EAAE,GAAG,eAAe;IAIlE;;;;;;OAMG;IACI,QAAQ,IAAI,MAAM;CAQ1B"}

package/dist/cjs/operation-result.js

@@ -0,0 +1,56 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationResult = void 0;
+/**
+ * Represents the result of an operation.
+ */
+class OperationResult {
+    /**
+     * Gets an array of OperationError instances indicating errors that occurred during the operation.
+     */
+    get errors() {
+        return this._errors || [];
+    }
+    /**
+     * Private constructor for OperationResult.
+     * @param succeeded Whether the operation succeeded.
+     * @param errors Optional array of errors.
+     */
+    constructor(succeeded, errors) {
+        this.succeeded = succeeded;
+        this._errors = errors || [];
+    }
+    /**
+     * Returns an OperationResult indicating a successful operation.
+     */
+    static get success() {
+        return OperationResult._success;
+    }
+    /**
+     * Creates an OperationResult indicating a failed operation, with a list of errors if applicable.
+     * @param errors An optional array of OperationError which caused the operation to fail.
+     * @returns An OperationResult indicating a failed operation, with a list of errors if applicable.
+     */
+    static failed(...errors) {
+        return new OperationResult(false, errors.length > 0 ? errors : []);
+    }
+    /**
+     * Converts the value of the current OperationResult object to its equivalent string representation.
+     * @returns A string representation of the current OperationResult object.
+     * @remarks
+     * If the operation was successful the toString() will return "Succeeded" otherwise it will return
+     * "Failed : " followed by a comma delimited list of error messages from its errors collection, if any.
+     */
+    toString() {
+        if (this.succeeded) {
+            return 'Succeeded';
+        }
+        const errorMessages = this.errors.map(e => e.message).join(', ');
+        return `Failed : ${errorMessages}`;
+    }
+}
+exports.OperationResult = OperationResult;
+OperationResult._success = new OperationResult(true);
+//# sourceMappingURL=operation-result.js.map

package/dist/cjs/operation-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-result.js","sourceRoot":"","sources":["../../src/operation-result.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAIlC;;GAEG;AACH,MAAa,eAAe;IAS1B;;OAEG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,YAAoB,SAAkB,EAAE,MAAyB;QAC/D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACI,MAAM,KAAK,OAAO;QACvB,OAAO,eAAe,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,GAAG,MAAwB;QAC9C,OAAO,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;OAMG;IACI,QAAQ;QACb,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,OAAO,YAAY,aAAa,EAAE,CAAC;IACrC,CAAC;;AAxDH,0CAyDC;AAxDyB,wBAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * Cluster categories for Power Platform API discovery.
+ * String enum provides both compile-time type safety and runtime validation.
+ */
+export declare enum ClusterCategory {
+    local = "local",
+    dev = "dev",
+    test = "test",
+    preprod = "preprod",
+    firstrelease = "firstrelease",
+    prod = "prod",
+    gov = "gov",
+    high = "high",
+    dod = "dod",
+    mooncake = "mooncake",
+    ex = "ex",
+    rx = "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;;;GAGG;AACH,oBAAY,eAAe;IACzB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,EAAE,OAAO;IACT,EAAE,OAAO;CACV;AAED,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,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PowerPlatformApiDiscovery = exports.ClusterCategory = void 0;
+/**
+ * Cluster categories for Power Platform API discovery.
+ * String enum provides both compile-time type safety and runtime validation.
+ */
+var ClusterCategory;
+(function (ClusterCategory) {
+    ClusterCategory["local"] = "local";
+    ClusterCategory["dev"] = "dev";
+    ClusterCategory["test"] = "test";
+    ClusterCategory["preprod"] = "preprod";
+    ClusterCategory["firstrelease"] = "firstrelease";
+    ClusterCategory["prod"] = "prod";
+    ClusterCategory["gov"] = "gov";
+    ClusterCategory["high"] = "high";
+    ClusterCategory["dod"] = "dod";
+    ClusterCategory["mooncake"] = "mooncake";
+    ClusterCategory["ex"] = "ex";
+    ClusterCategory["rx"] = "rx";
+})(ClusterCategory || (exports.ClusterCategory = ClusterCategory = {}));
+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 ClusterCategory.firstrelease:
+            case ClusterCategory.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":"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"}

package/dist/cjs/utility.d.ts

@@ -0,0 +1,73 @@
+import { TurnContext } from '@microsoft/agents-hosting';
+/**
+ * Utility class providing helper methods for agent runtime operations.
+ */
+export declare class Utility {
+    private static cachedPackageName;
+    /**
+     * Reads the application name from package.json at module load time.
+     * This ensures file I/O happens during initialization, not during requests.
+     *
+     * Note: Uses process.cwd() which assumes the application is started from its root directory.
+     * This is a fallback mechanism - npm_package_name (checked first in getApplicationName) is
+     * the preferred source as it's reliably set by npm/pnpm when running package scripts.
+     */
+    private static initPackageName;
+    /**
+     * **WARNING: NO SIGNATURE VERIFICATION** - This method uses jwt.decode() which does NOT
+     * verify the token signature. The token claims can be spoofed by malicious actors.
+     * This method is ONLY suitable for logging, analytics, and diagnostics purposes.
+     * Do NOT use the returned value for authorization, access control, or security decisions.
+     *
+     * Decodes the current token and retrieves the App ID (appid or azp claim).
+     *
+     * Note: Returns a default GUID ('00000000-0000-0000-0000-000000000000') for empty tokens
+     * for backward compatibility with callers that expect a valid-looking GUID.
+     * For agent identification where empty string is preferred, use {@link getAgentIdFromToken}.
+     *
+     * @param token Token to Decode
+     * @returns AppId, or default GUID for empty token, or empty string if decode fails
+     */
+    static GetAppIdFromToken(token: string): string;
+    /**
+     * **WARNING: NO SIGNATURE VERIFICATION** - This method uses jwt.decode() which does NOT
+     * verify the token signature. The token claims can be spoofed by malicious actors.
+     * This method is ONLY suitable for logging, analytics, and diagnostics purposes.
+     * Do NOT use the returned value for authorization, access control, or security decisions.
+     *
+     * Decodes the token and retrieves the best available agent identifier.
+     * Checks claims in priority order: xms_par_app_azp (agent blueprint ID) > appid > azp.
+     *
+     * Note: Returns empty string for empty/missing tokens (unlike {@link GetAppIdFromToken} which
+     * returns a default GUID). This allows callers to omit headers when no identifier is available.
+     *
+     * @param token JWT token to decode
+     * @returns Agent ID (GUID) or empty string if not found or token is empty
+     */
+    static getAgentIdFromToken(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;
+    /**
+     * Generates a User-Agent header string containing SDK version, OS type, Node.js version, and orchestrator.
+     * @param orchestrator Optional orchestrator identifier to include in the User-Agent string.
+     * @returns Formatted User-Agent header string.
+     */
+    static GetUserAgentHeader(orchestrator?: string): string;
+    /**
+     * Gets the application name from npm_package_name environment variable or package.json.
+     * The package.json result is cached at module load time to avoid sync I/O during requests.
+     * @returns Application name or undefined if not available.
+     */
+    static getApplicationName(): string | undefined;
+    /**
+     * Resets the cached application name. Used for testing purposes.
+     * @internal
+     */
+    static resetApplicationNameCache(): void;
+}
+//# 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;AAQxD;;GAEG;AACH,qBAAa,OAAO;IAIlB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA4C;IAE5E;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAW9B;;;;;;;;;;;;;;OAcG;WACW,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAoBtD;;;;;;;;;;;;;;OAcG;WACW,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAmBxD;;;;;OAKG;WACW,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IASnF;;;;OAIG;WACW,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IAM/D;;;;OAIG;WACW,kBAAkB,IAAI,MAAM,GAAG,SAAS;IAYtD;;;OAGG;WACW,yBAAyB,IAAI,IAAI;CAGhD"}