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

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

@@ -1,5 +1,28 @@
 import { TurnContext, Authorization } from '@microsoft/agents-hosting';
+/**
+ * Service for handling agentic user authentication.
+ */
 export declare class AgenticAuthenticationService {
+    /**
+     * Gets an agentic user token for platform authentication.
+     * Uses the default MCP platform authentication scope.
+     *
+     * @param authorization The authorization handler.
+     * @param authHandlerName The name of the auth handler to use.
+     * @param turnContext The turn context for the current request.
+     * @returns The token string, or empty string if no token was returned.
+     * @deprecated Use the overload with explicit scopes parameter for better control over requested permissions.
+     */
     static GetAgenticUserToken(authorization: Authorization, authHandlerName: string, turnContext: TurnContext): Promise<string>;
+    /**
+     * Gets an agentic user token for platform authentication.
+     *
+     * @param authorization The authorization handler.
+     * @param authHandlerName The name of the auth handler to use.
+     * @param turnContext The turn context for the current request.
+     * @param scopes The OAuth scopes to request. Should be obtained from the appropriate configuration (e.g., ToolingConfiguration.mcpPlatformAuthenticationScope).
+     * @returns The token string, or empty string if no token was returned.
+     */
+    static GetAgenticUserToken(authorization: Authorization, authHandlerName: string, turnContext: TurnContext, scopes: string[]): Promise<string>;
 }
 //# sourceMappingURL=agentic-authorization-service.d.ts.map

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

@@ -1 +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"}
+{"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;;GAEG;AACH,qBAAa,4BAA4B;IACvC;;;;;;;;;OASG;WACiB,mBAAmB,CACrC,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,MAAM,CAAC;IAElB;;;;;;;;OAQG;WACiB,mBAAmB,CACrC,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,MAAM,CAAC;CAYnB"}

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

@@ -4,10 +4,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgenticAuthenticationService = void 0;
 const environment_utils_1 = require("./environment-utils");
+/**
+ * Service for handling agentic user authentication.
+ */
 class AgenticAuthenticationService {
-    static async GetAgenticUserToken(authorization, authHandlerName, turnContext) {
-        const scope = (0, environment_utils_1.getMcpPlatformAuthenticationScope)();
-        return (await authorization.exchangeToken(turnContext, authHandlerName, { scopes: [scope] })).token || '';
+    static async GetAgenticUserToken(authorization, authHandlerName, turnContext, scopes) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- Intentional: maintaining backward compatibility for deprecated 3-param overload
+        const effectiveScopes = scopes ?? [environment_utils_1.PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE];
+        return (await authorization.exchangeToken(turnContext, authHandlerName, { scopes: effectiveScopes })).token || '';
     }
 }
 exports.AgenticAuthenticationService = AgenticAuthenticationService;

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

@@ -1 +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"}
+{"version":3,"file":"agentic-authorization-service.js","sourceRoot":"","sources":["../../src/agentic-authorization-service.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAGlC,2DAA6E;AAE7E;;GAEG;AACH,MAAa,4BAA4B;IAiChC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CACrC,aAA4B,EAC5B,eAAuB,EACvB,WAAwB,EACxB,MAAiB;QAEjB,+IAA+I;QAC/I,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,0DAAsC,CAAC,CAAC;QAC3E,OAAO,CAAC,MAAM,aAAa,CAAC,aAAa,CAAC,WAAW,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;IACpH,CAAC;CACF;AA3CD,oEA2CC"}

package/dist/cjs/configuration/DefaultConfigurationProvider.d.ts

@@ -0,0 +1,39 @@
+import { IConfigurationProvider } from './IConfigurationProvider';
+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 declare class DefaultConfigurationProvider<T extends RuntimeConfiguration> implements IConfigurationProvider<T> {
+    private readonly _configuration;
+    constructor(factory: () => T);
+    getConfiguration(): T;
+}
+/**
+ * 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 declare const defaultRuntimeConfigurationProvider: DefaultConfigurationProvider<RuntimeConfiguration>;
+//# sourceMappingURL=DefaultConfigurationProvider.d.ts.map

package/dist/cjs/configuration/DefaultConfigurationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultConfigurationProvider.d.ts","sourceRoot":"","sources":["../../../src/configuration/DefaultConfigurationProvider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,4BAA4B,CAAC,CAAC,SAAS,oBAAoB,CACtE,YAAW,sBAAsB,CAAC,CAAC,CAAC;IAEpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAI;gBAEvB,OAAO,EAAE,MAAM,CAAC;IAI5B,gBAAgB,IAAI,CAAC;CAGtB;AAED;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,oDACoB,CAAC"}

package/dist/cjs/configuration/DefaultConfigurationProvider.js

@@ -0,0 +1,47 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultRuntimeConfigurationProvider = exports.DefaultConfigurationProvider = void 0;
+const RuntimeConfiguration_1 = require("./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.
+ */
+class DefaultConfigurationProvider {
+    constructor(factory) {
+        this._configuration = factory();
+    }
+    getConfiguration() {
+        return this._configuration;
+    }
+}
+exports.DefaultConfigurationProvider = DefaultConfigurationProvider;
+/**
+ * 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.
+ */
+exports.defaultRuntimeConfigurationProvider = new DefaultConfigurationProvider(() => new RuntimeConfiguration_1.RuntimeConfiguration());
+//# sourceMappingURL=DefaultConfigurationProvider.js.map

package/dist/cjs/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,iEAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAa,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;AAZD,oEAYC;AAED;;;;GAIG;AACU,QAAA,mCAAmC,GAC9C,IAAI,4BAA4B,CAAC,GAAG,EAAE,CAAC,IAAI,2CAAoB,EAAE,CAAC,CAAC"}

package/dist/cjs/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/cjs/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/cjs/configuration/IConfigurationProvider.js

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

package/dist/cjs/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/cjs/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/cjs/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/cjs/configuration/RuntimeConfiguration.js

@@ -0,0 +1,71 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuntimeConfiguration = void 0;
+const power_platform_api_discovery_1 = require("../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.
+ */
+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(power_platform_api_discovery_1.ClusterCategory).includes(normalized)) {
+                return normalized;
+            }
+            // Invalid value - fall through to default
+        }
+        return power_platform_api_discovery_1.ClusterCategory.prod;
+    }
+    /**
+     * Whether the cluster is a development environment (local or dev).
+     * Based on clusterCategory.
+     */
+    get isDevelopmentEnvironment() {
+        return [power_platform_api_discovery_1.ClusterCategory.local, power_platform_api_discovery_1.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';
+    }
+}
+exports.RuntimeConfiguration = RuntimeConfiguration;
+//# sourceMappingURL=RuntimeConfiguration.js.map

package/dist/cjs/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,kFAAkE;AAGlE;;;;;;GAMG;AACH,MAAa,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,8CAAe,CAAC,CAAC,QAAQ,CAAC,UAA6B,CAAC,EAAE,CAAC;gBAC3E,OAAO,UAA6B,CAAC;YACvC,CAAC;YACD,0CAA0C;QAC5C,CAAC;QACD,OAAO,8CAAe,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAI,wBAAwB;QAC1B,OAAO,CAAC,8CAAe,CAAC,KAAK,EAAE,8CAAe,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;AA5DD,oDA4DC"}

package/dist/cjs/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/cjs/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/cjs/configuration/RuntimeConfigurationOptions.js

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

package/dist/cjs/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/cjs/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/cjs/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/cjs/configuration/index.js

@@ -0,0 +1,23 @@
+"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("./IConfigurationProvider"), exports);
+__exportStar(require("./RuntimeConfigurationOptions"), exports);
+__exportStar(require("./RuntimeConfiguration"), exports);
+__exportStar(require("./DefaultConfigurationProvider"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/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,2DAAyC;AACzC,gEAA8C;AAC9C,yDAAuC;AACvC,iEAA+C"}

package/dist/cjs/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/cjs/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"}