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

package/dist/cjs/utility.js

@@ -0,0 +1,187 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Utility = void 0;
+const jwt = __importStar(require("jsonwebtoken"));
+const os_1 = __importDefault(require("os"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const version_1 = require("./version");
+/**
+ * Utility class providing helper methods for agent runtime operations.
+ */
+class Utility {
+    /**
+     * 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.
+     */
+    static initPackageName() {
+        try {
+            const packageJsonPath = path_1.default.resolve(process.cwd(), 'package.json');
+            const packageJson = JSON.parse(fs_1.default.readFileSync(packageJsonPath, 'utf-8'));
+            return packageJson.name || null;
+        }
+        catch {
+            // TODO: Add debug-level logging once a logger implementation is available
+            // to help troubleshoot package.json read failures in production environments
+            return null;
+        }
+    }
+    /**
+     * **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) {
+        if (!token || token.trim() === '') {
+            return '00000000-0000-0000-0000-000000000000';
+        }
+        try {
+            const decoded = jwt.decode(token);
+            if (!decoded) {
+                return '';
+            }
+            // Look for appid claim first, then azp claim as fallback
+            const appIdClaim = decoded['appid'] || decoded['azp'];
+            return appIdClaim || '';
+        }
+        catch (_error) {
+            // Silent error handling - return empty string on decode failure
+            return '';
+        }
+    }
+    /**
+     * **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) {
+        if (!token || token.trim() === '') {
+            return '';
+        }
+        try {
+            const decoded = jwt.decode(token);
+            if (!decoded) {
+                return '';
+            }
+            // Priority: xms_par_app_azp (agent blueprint ID) > appid > azp
+            return decoded['xms_par_app_azp'] || decoded['appid'] || decoded['azp'] || '';
+        }
+        catch (_error) {
+            // Silent error handling - return empty string on decode failure
+            return '';
+        }
+    }
+    /**
+     * Resolves the agent identity from the turn context or auth token.
+     * @param context Turn Context of the turn.
+     * @param authToken Auth token if available.
+     * @returns Agent identity (App ID)
+     */
+    static ResolveAgentIdentity(context, authToken) {
+        // App ID is required to pass to MCP server URL.
+        const agenticAppId = context.activity.isAgenticRequest()
+            ? context.activity.getAgenticInstanceId() || ''
+            : this.GetAppIdFromToken(authToken);
+        return agenticAppId;
+    }
+    /**
+     * 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) {
+        const osType = os_1.default.type();
+        const orchestratorPart = orchestrator ? `; ${orchestrator}` : '';
+        return `Agent365SDK/${version_1.LIB_VERSION} (${osType}; Node.js ${process.version}${orchestratorPart})`;
+    }
+    /**
+     * 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() {
+        // First try npm_package_name (set automatically by npm/pnpm when running scripts)
+        // eslint-disable-next-line no-restricted-properties -- npm_package_name is set by npm at runtime, not a configurable setting
+        if (process.env.npm_package_name) {
+            // eslint-disable-next-line no-restricted-properties -- npm_package_name is set by npm at runtime, not a configurable setting
+            return process.env.npm_package_name;
+        }
+        // Fall back to cached package.json name (read at module load time)
+        return this.cachedPackageName || undefined;
+    }
+    /**
+     * Resets the cached application name. Used for testing purposes.
+     * @internal
+     */
+    static resetApplicationNameCache() {
+        this.cachedPackageName = Utility.initPackageName();
+    }
+}
+exports.Utility = Utility;
+// Cache for application name read from package.json
+// null = checked but not found, string = found
+// Eagerly initialized at module load time to avoid sync I/O during requests
+Utility.cachedPackageName = Utility.initPackageName();
+//# sourceMappingURL=utility.js.map

package/dist/cjs/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../../src/utility.ts"],"names":[],"mappings":"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"}

package/dist/cjs/version.d.ts

@@ -0,0 +1,2 @@
+export declare const LIB_VERSION = "0.1.0-preview.103";
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,sBAAsB,CAAC"}

package/dist/cjs/version.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIB_VERSION = void 0;
+exports.LIB_VERSION = "0.1.0-preview.103";
+//# sourceMappingURL=version.js.map

package/dist/cjs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG,mBAAmB,CAAC"}

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

@@ -0,0 +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/esm/agentic-authorization-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-authorization-service.d.ts","sourceRoot":"","sources":["../../src/agentic-authorization-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGvE;;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/esm/agentic-authorization-service.js

@@ -0,0 +1,14 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE } from './environment-utils';
+/**
+ * Service for handling agentic user authentication.
+ */
+export class AgenticAuthenticationService {
+    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 ?? [PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE];
+        return (await authorization.exchangeToken(turnContext, authHandlerName, { scopes: effectiveScopes })).token || '';
+    }
+}
+//# sourceMappingURL=agentic-authorization-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-authorization-service.js","sourceRoot":"","sources":["../../src/agentic-authorization-service.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAGlC,OAAO,EAAE,sCAAsC,EAAE,MAAM,qBAAqB,CAAC;AAE7E;;GAEG;AACH,MAAM,OAAO,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,sCAAsC,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"}

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