@microsoft/agents-a365-runtime 0.1.0-preview.93 → 0.2.0-preview.1

package/dist/esm/configuration/DefaultConfigurationProvider.js

@@ -0,0 +1,43 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { RuntimeConfiguration } from './RuntimeConfiguration';
+/**
+ * Default provider that returns environment-based configuration.
+ *
+ * **Multi-tenant considerations:**
+ * This provider creates a single configuration instance at construction time,
+ * shared across all requests in a process. The default module-level providers
+ * (e.g., `defaultRuntimeConfigurationProvider`) are singletons.
+ *
+ * For multi-tenant scenarios, two approaches are supported:
+ *
+ * 1. **Dynamic override functions (recommended):** Pass override functions that
+ *    read from async context (e.g., OpenTelemetry baggage) at runtime. The same
+ *    Configuration instance returns different values per request.
+ *    ```typescript
+ *    const config = new ToolingConfiguration({
+ *      mcpPlatformEndpoint: () => {
+ *        const tenantConfig = context.active().getValue(TENANT_KEY);
+ *        return tenantConfig?.endpoint ?? 'https://default.endpoint';
+ *      }
+ *    });
+ *    ```
+ *
+ * 2. **Per-tenant providers:** Create separate provider instances for each tenant
+ *    when different tenants need different override functions entirely.
+ */
+export class DefaultConfigurationProvider {
+    constructor(factory) {
+        this._configuration = factory();
+    }
+    getConfiguration() {
+        return this._configuration;
+    }
+}
+/**
+ * Shared default provider for RuntimeConfiguration.
+ * Uses environment variables with no overrides - suitable for single-tenant
+ * deployments or when using dynamic override functions for multi-tenancy.
+ */
+export const defaultRuntimeConfigurationProvider = new DefaultConfigurationProvider(() => new RuntimeConfiguration());
+//# sourceMappingURL=DefaultConfigurationProvider.js.map

package/dist/esm/configuration/DefaultConfigurationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultConfigurationProvider.js","sourceRoot":"","sources":["../../../src/configuration/DefaultConfigurationProvider.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAGlC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,4BAA4B;IAKvC,YAAY,OAAgB;QAC1B,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,CAAC;IAClC,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAC9C,IAAI,4BAA4B,CAAC,GAAG,EAAE,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/esm/configuration/IConfigurationProvider.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generic interface for providing configuration.
+ * Each package defines its own configuration type T.
+ */
+export interface IConfigurationProvider<T> {
+    getConfiguration(): T;
+}
+//# sourceMappingURL=IConfigurationProvider.d.ts.map

package/dist/esm/configuration/IConfigurationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConfigurationProvider.d.ts","sourceRoot":"","sources":["../../../src/configuration/IConfigurationProvider.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,gBAAgB,IAAI,CAAC,CAAC;CACvB"}

package/dist/esm/configuration/IConfigurationProvider.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=IConfigurationProvider.js.map

package/dist/esm/configuration/IConfigurationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConfigurationProvider.js","sourceRoot":"","sources":["../../../src/configuration/IConfigurationProvider.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC"}

package/dist/esm/configuration/RuntimeConfiguration.d.ts

@@ -0,0 +1,35 @@
+import { ClusterCategory } from '../power-platform-api-discovery';
+import { RuntimeConfigurationOptions } from './RuntimeConfigurationOptions';
+/**
+ * Base configuration class for Agent365 SDK.
+ * Other packages extend this to add their own settings.
+ *
+ * Override functions are called on each property access, enabling dynamic
+ * resolution from async context (e.g., OpenTelemetry baggage) per-request.
+ */
+export declare class RuntimeConfiguration {
+    protected readonly overrides: RuntimeConfigurationOptions;
+    /**
+     * Parse an environment variable as a boolean.
+     * Recognizes 'true', '1', 'yes', 'on' (case-insensitive) as true; all other values as false.
+     */
+    static parseEnvBoolean(envValue: string | undefined): boolean;
+    /**
+     * Parse an environment variable as an integer, returning fallback if invalid or not set.
+     */
+    static parseEnvInt(envValue: string | undefined, fallback: number): number;
+    constructor(overrides?: RuntimeConfigurationOptions);
+    get clusterCategory(): ClusterCategory;
+    /**
+     * Whether the cluster is a development environment (local or dev).
+     * Based on clusterCategory.
+     */
+    get isDevelopmentEnvironment(): boolean;
+    /**
+     * Whether NODE_ENV indicates development mode.
+     * Returns true when NODE_ENV is 'development' (case-insensitive).
+     * This is the standard Node.js way of indicating development mode.
+     */
+    get isNodeEnvDevelopment(): boolean;
+}
+//# sourceMappingURL=RuntimeConfiguration.d.ts.map

package/dist/esm/configuration/RuntimeConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeConfiguration.d.ts","sourceRoot":"","sources":["../../../src/configuration/RuntimeConfiguration.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAE1D;;;OAGG;WACW,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO;IAKpE;;OAEG;WACW,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;gBAMrE,SAAS,CAAC,EAAE,2BAA2B;IAInD,IAAI,eAAe,IAAI,eAAe,CAarC;IAED;;;OAGG;IACH,IAAI,wBAAwB,IAAI,OAAO,CAEtC;IAED;;;;OAIG;IACH,IAAI,oBAAoB,IAAI,OAAO,CAMlC;CACF"}

package/dist/esm/configuration/RuntimeConfiguration.js

@@ -0,0 +1,67 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { ClusterCategory } from '../power-platform-api-discovery';
+/**
+ * Base configuration class for Agent365 SDK.
+ * Other packages extend this to add their own settings.
+ *
+ * Override functions are called on each property access, enabling dynamic
+ * resolution from async context (e.g., OpenTelemetry baggage) per-request.
+ */
+export class RuntimeConfiguration {
+    /**
+     * Parse an environment variable as a boolean.
+     * Recognizes 'true', '1', 'yes', 'on' (case-insensitive) as true; all other values as false.
+     */
+    static parseEnvBoolean(envValue) {
+        if (!envValue)
+            return false;
+        return ['true', '1', 'yes', 'on'].includes(envValue.toLowerCase());
+    }
+    /**
+     * Parse an environment variable as an integer, returning fallback if invalid or not set.
+     */
+    static parseEnvInt(envValue, fallback) {
+        if (!envValue)
+            return fallback;
+        const parsed = parseInt(envValue, 10);
+        return Number.isFinite(parsed) ? parsed : fallback;
+    }
+    constructor(overrides) {
+        this.overrides = overrides ?? {};
+    }
+    get clusterCategory() {
+        if (this.overrides.clusterCategory) {
+            return this.overrides.clusterCategory();
+        }
+        const envValue = process.env.CLUSTER_CATEGORY;
+        if (envValue) {
+            const normalized = envValue.toLowerCase();
+            if (Object.values(ClusterCategory).includes(normalized)) {
+                return normalized;
+            }
+            // Invalid value - fall through to default
+        }
+        return ClusterCategory.prod;
+    }
+    /**
+     * Whether the cluster is a development environment (local or dev).
+     * Based on clusterCategory.
+     */
+    get isDevelopmentEnvironment() {
+        return [ClusterCategory.local, ClusterCategory.dev].includes(this.clusterCategory);
+    }
+    /**
+     * Whether NODE_ENV indicates development mode.
+     * Returns true when NODE_ENV is 'development' (case-insensitive).
+     * This is the standard Node.js way of indicating development mode.
+     */
+    get isNodeEnvDevelopment() {
+        const override = this.overrides.isNodeEnvDevelopment?.();
+        if (override !== undefined)
+            return override;
+        const nodeEnv = process.env.NODE_ENV ?? '';
+        return nodeEnv.toLowerCase() === 'development';
+    }
+}
+//# sourceMappingURL=RuntimeConfiguration.js.map

package/dist/esm/configuration/RuntimeConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeConfiguration.js","sourceRoot":"","sources":["../../../src/configuration/RuntimeConfiguration.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAG/B;;;OAGG;IACI,MAAM,CAAC,eAAe,CAAC,QAA4B;QACxD,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,WAAW,CAAC,QAA4B,EAAE,QAAgB;QACtE,IAAI,CAAC,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrD,CAAC;IAED,YAAY,SAAuC;QACjD,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,eAAe;QACjB,IAAI,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QAC1C,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC1C,IAAI,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,UAA6B,CAAC,EAAE,CAAC;gBAC3E,OAAO,UAA6B,CAAC;YACvC,CAAC;YACD,0CAA0C;QAC5C,CAAC;QACD,OAAO,eAAe,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAI,wBAAwB;QAC1B,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACrF,CAAC;IAED;;;;OAIG;IACH,IAAI,oBAAoB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,CAAC;QACzD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAE5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC;IACjD,CAAC;CACF"}

package/dist/esm/configuration/RuntimeConfigurationOptions.d.ts

@@ -0,0 +1,35 @@
+import { ClusterCategory } from '../power-platform-api-discovery';
+/**
+ * Runtime configuration options - all optional functions.
+ * Functions are called on each property access, enabling dynamic resolution.
+ * Unset values fall back to environment variables.
+ */
+export type RuntimeConfigurationOptions = {
+    /**
+     * Override function for cluster category.
+     * Called on each property access to enable dynamic per-request resolution.
+     * Falls back to CLUSTER_CATEGORY env var, then 'prod'.
+     *
+     * @example
+     * // Static override
+     * { clusterCategory: () => ClusterCategory.gov }
+     *
+     * // Dynamic per-tenant override using async context
+     * { clusterCategory: () => context.active().getValue(TENANT_CONFIG_KEY)?.cluster ?? ClusterCategory.prod }
+     */
+    clusterCategory?: () => ClusterCategory;
+    /**
+     * Override for NODE_ENV-based development mode detection.
+     * Called on each property access to enable dynamic per-request resolution.
+     * Falls back to NODE_ENV === 'development' check.
+     *
+     * @example
+     * // Static override
+     * { isNodeEnvDevelopment: () => true }
+     *
+     * // Dynamic override based on request context
+     * { isNodeEnvDevelopment: () => context.active().getValue(DEBUG_KEY) === true }
+     */
+    isNodeEnvDevelopment?: () => boolean;
+};
+//# sourceMappingURL=RuntimeConfigurationOptions.d.ts.map

package/dist/esm/configuration/RuntimeConfigurationOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../src/configuration/RuntimeConfigurationOptions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,MAAM,eAAe,CAAC;IACxC;;;;;;;;;;;OAWG;IACH,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC;CACtC,CAAC"}

package/dist/esm/configuration/RuntimeConfigurationOptions.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=RuntimeConfigurationOptions.js.map

package/dist/esm/configuration/RuntimeConfigurationOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeConfigurationOptions.js","sourceRoot":"","sources":["../../../src/configuration/RuntimeConfigurationOptions.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC"}

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

@@ -0,0 +1,5 @@
+export * from './IConfigurationProvider';
+export * from './RuntimeConfigurationOptions';
+export * from './RuntimeConfiguration';
+export * from './DefaultConfigurationProvider';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/configuration/index.ts"],"names":[],"mappings":"AAGA,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC"}

package/dist/esm/configuration/index.js

@@ -0,0 +1,7 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export * from './IConfigurationProvider';
+export * from './RuntimeConfigurationOptions';
+export * from './RuntimeConfiguration';
+export * from './DefaultConfigurationProvider';
+//# sourceMappingURL=index.js.map

package/dist/esm/configuration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/configuration/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC"}

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

@@ -1,40 +1,98 @@
 /**
  * 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
+ */
+import { RuntimeConfiguration } from './configuration';
+import { IConfigurationProvider } from './configuration/IConfigurationProvider';
+/**
+ * Production observability authentication scope.
+ * @deprecated This constant is exported for backward compatibility only.
+ * For new code, use `ObservabilityConfiguration.observabilityAuthenticationScopes` instead.
  */
 export declare const 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.
+ */
 export declare const 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.
+ */
 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 scope for authenticating to the observability service.
  *
- * The default is the production observability scope, but this can be overridden
- * for internal development and testing scenarios using the
- * `A365_OBSERVABILITY_SCOPES_OVERRIDE` environment variable.
+ * @returns The authentication scopes for the current environment.
+ * @deprecated Use ObservabilityConfiguration.observabilityAuthenticationScopes instead.
  *
- * When the override is set to a non-empty string, it is split on whitespace
- * into individual scopes.
+ * @example
+ * // Before:
+ * import { getObservabilityAuthenticationScope } from '@microsoft/agents-a365-runtime';
+ * const scopes = getObservabilityAuthenticationScope();
  *
- * @returns The authentication scopes for the current environment.
+ * // After:
+ * import { defaultObservabilityConfigurationProvider } from '@microsoft/agents-a365-observability';
+ * const scopes = [...defaultObservabilityConfigurationProvider.getConfiguration().observabilityAuthenticationScopes];
  */
 export declare function getObservabilityAuthenticationScope(): string[];
 /**
  * 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;
  */
-export declare function getClusterCategory(): string;
+export declare function getClusterCategory(configProvider?: IConfigurationProvider<RuntimeConfiguration>): string;
 /**
  * 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) { ... }
  */
-export declare function isDevelopmentEnvironment(): boolean;
+export declare function isDevelopmentEnvironment(configProvider?: IConfigurationProvider<RuntimeConfiguration>): boolean;
 /**
- * Gets the MCP platform authentication scope from environment variables.
+ * 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();
  *
- * @returns The MCP platform authentication scope from MCP_PLATFORM_AUTHENTICATION_SCOPE env var, defaults to production scope.
+ * // After:
+ * import { defaultToolingConfigurationProvider } from '@microsoft/agents-a365-tooling';
+ * const scope = defaultToolingConfigurationProvider.getConfiguration().mcpPlatformAuthenticationScope;
  */
 export declare function getMcpPlatformAuthenticationScope(): string;
 //# sourceMappingURL=environment-utils.d.ts.map

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

@@ -1 +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;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,EAAE,CAQ9D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAQ3C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,IAAI,MAAM,CAE1D"}
+{"version":3,"file":"environment-utils.d.ts","sourceRoot":"","sources":["../../src/environment-utils.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAuC,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,2CAA2C,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,kDAAkD,CAAC;AAEtG;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,SAAS,CAAC;AAG1D,eAAO,MAAM,2BAA2B,eAAe,CAAC;AACxD,eAAO,MAAM,4BAA4B,gBAAgB,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,EAAE,CAI9D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,CAAC,EAAE,sBAAsB,CAAC,oBAAoB,CAAC,GAC5D,MAAM,CAGR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,CAAC,EAAE,sBAAsB,CAAC,oBAAoB,CAAC,GAC5D,OAAO,CAGT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iCAAiC,IAAI,MAAM,CAI1D"}

package/dist/esm/environment-utils.js

@@ -1,61 +1,114 @@
-// ------------------------------------------------------------------------------
-// Copyright (c) Microsoft Corporation. All rights reserved.
-// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
 /**
  * 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
+ */
+import { defaultRuntimeConfigurationProvider } from './configuration';
+/**
+ * Production observability authentication scope.
+ * @deprecated This constant is exported for backward compatibility only.
+ * For new code, use `ObservabilityConfiguration.observabilityAuthenticationScopes` instead.
  */
 export const 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.
+ */
 export const 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.
+ */
 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 scope for authenticating to the observability service.
  *
- * The default is the production observability scope, but this can be overridden
- * for internal development and testing scenarios using the
- * `A365_OBSERVABILITY_SCOPES_OVERRIDE` environment variable.
+ * @returns The authentication scopes for the current environment.
+ * @deprecated Use ObservabilityConfiguration.observabilityAuthenticationScopes instead.
  *
- * When the override is set to a non-empty string, it is split on whitespace
- * into individual scopes.
+ * @example
+ * // Before:
+ * import { getObservabilityAuthenticationScope } from '@microsoft/agents-a365-runtime';
+ * const scopes = getObservabilityAuthenticationScope();
  *
- * @returns The authentication scopes for the current environment.
+ * // After:
+ * import { defaultObservabilityConfigurationProvider } from '@microsoft/agents-a365-observability';
+ * const scopes = [...defaultObservabilityConfigurationProvider.getConfiguration().observabilityAuthenticationScopes];
  */
 export function getObservabilityAuthenticationScope() {
-    const override = process.env.A365_OBSERVABILITY_SCOPES_OVERRIDE;
-    if (override && override.trim().length > 0) {
-        return override.trim().split(/\s+/);
-    }
+    // 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 [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;
  */
-export function getClusterCategory() {
-    const clusterCategory = process.env.CLUSTER_CATEGORY;
-    if (!clusterCategory) {
-        return 'prod';
-    }
-    return clusterCategory.toLowerCase();
+export function getClusterCategory(configProvider) {
+    const provider = configProvider ?? 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) { ... }
  */
-export function isDevelopmentEnvironment() {
-    const clusterCategory = getClusterCategory();
-    return ['local', 'dev'].includes(clusterCategory);
+export function isDevelopmentEnvironment(configProvider) {
+    const provider = configProvider ?? defaultRuntimeConfigurationProvider;
+    return provider.getConfiguration().isDevelopmentEnvironment;
 }
 /**
- * Gets the MCP platform authentication scope from environment variables.
+ * 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();
  *
- * @returns The MCP platform authentication scope from MCP_PLATFORM_AUTHENTICATION_SCOPE env var, defaults to production scope.
+ * // After:
+ * import { defaultToolingConfigurationProvider } from '@microsoft/agents-a365-tooling';
+ * const scope = defaultToolingConfigurationProvider.getConfiguration().mcpPlatformAuthenticationScope;
  */
 export function getMcpPlatformAuthenticationScope() {
-    return process.env.MCP_PLATFORM_AUTHENTICATION_SCOPE || PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE;
+    // 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 PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE;
 }
 //# sourceMappingURL=environment-utils.js.map

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

@@ -1 +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;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mCAAmC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC;IAEhE,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,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"}
+{"version":3,"file":"environment-utils.js","sourceRoot":"","sources":["../../src/environment-utils.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;;;;;GAQG;AAEH,OAAO,EAAwB,mCAAmC,EAAE,MAAM,iBAAiB,CAAC;AAG5F;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,wCAAwC,CAAC;AAEjF;;;;GAIG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,+CAA+C,CAAC;AAEtG;;;;GAIG;AACH,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;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mCAAmC;IACjD,yFAAyF;IACzF,0HAA0H;IAC1H,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAChC,cAA6D;IAE7D,MAAM,QAAQ,GAAG,cAAc,IAAI,mCAAmC,CAAC;IACvE,OAAO,QAAQ,CAAC,gBAAgB,EAAE,CAAC,eAAe,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,wBAAwB,CACtC,cAA6D;IAE7D,MAAM,QAAQ,GAAG,cAAc,IAAI,mCAAmC,CAAC;IACvE,OAAO,QAAQ,CAAC,gBAAgB,EAAE,CAAC,wBAAwB,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iCAAiC;IAC/C,mFAAmF;IACnF,0HAA0H;IAC1H,OAAO,sCAAsC,CAAC;AAChD,CAAC"}

package/dist/esm/index.d.ts

@@ -1,7 +1,8 @@
 export * from './power-platform-api-discovery';
-export * from './agentic-authorization-service';
 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/esm/index.d.ts.map

@@ -1 +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;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}
+{"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/esm/index.js

@@ -1,7 +1,10 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
 export * from './power-platform-api-discovery';
-export * from './agentic-authorization-service';
 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.js.map

package/dist/esm/index.js.map

@@ -1 +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;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,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/esm/power-platform-api-discovery.d.ts

@@ -1,4 +1,21 @@
-export type ClusterCategory = 'local' | 'dev' | 'test' | 'preprod' | 'firstrelease' | 'prod' | 'gov' | 'high' | 'dod' | 'mooncake' | 'ex' | 'rx';
+/**
+ * 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);

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

@@ -1 +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"}
+{"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/esm/power-platform-api-discovery.js

@@ -1,3 +1,22 @@
+/**
+ * Cluster categories for Power Platform API discovery.
+ * String enum provides both compile-time type safety and runtime validation.
+ */
+export 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 || (ClusterCategory = {}));
 export class PowerPlatformApiDiscovery {
     constructor(clusterCategory) {
         this.clusterCategory = clusterCategory;
@@ -31,8 +50,8 @@ export class PowerPlatformApiDiscovery {
     }
     _getHexApiSuffixLength() {
         switch (this.clusterCategory) {
-            case 'firstrelease':
-            case 'prod':
+            case ClusterCategory.firstrelease:
+            case ClusterCategory.prod:
                 return 2;
             default:
                 return 1;