@microsoft/agents-hosting 1.9.0-beta.8.gf58e66b2ee → 1.9.1

package/dist/src/configuration/botFrameworkEnvironmentCompatibility.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadBotFrameworkEnvironmentConfiguration = loadBotFrameworkEnvironmentConfiguration;
+exports.loadBotFrameworkPrefixedEnvironmentConfiguration = loadBotFrameworkPrefixedEnvironmentConfiguration;
+exports.loadBotFrameworkAuthorizationEnvironmentConfiguration = loadBotFrameworkAuthorizationEnvironmentConfiguration;
+const configuration_1 = require("./configuration");
+const env_1 = require("../utils/env");
+const DEFAULT_CONNECTION_ID = 'serviceConnection';
+const flatConnectionProperties = {
+    MicrosoftAppTenantId: 'tenantId',
+    MicrosoftAppId: 'clientId',
+    MicrosoftAppPassword: 'clientSecret',
+    certPemFile: 'certPemFile',
+    certKeyFile: 'certKeyFile',
+    connectionName: 'connectionName',
+    MicrosoftAppClientId: 'federatedClientId',
+    authorityEndpoint: 'authorityEndpoint',
+    scope: 'scopes',
+    altBlueprintConnectionName: 'altBlueprintConnectionName',
+    alternateBlueprintConnectionName: 'altBlueprintConnectionName',
+    WIDAssertionFile: 'WIDAssertionFile',
+    azureRegion: 'azureRegion',
+    sendX5C: 'sendX5C',
+    msalRetryCount: 'msalRetryCount',
+    authType: 'authType',
+    federatedTokenFile: 'federatedTokenFile',
+    idpmResource: 'idpmResource',
+    sidecarBaseUrl: 'sidecarBaseUrl',
+    serviceName: 'serviceName',
+    blueprintServiceName: 'blueprintServiceName',
+    bypassLocalNetworkRestriction: 'bypassLocalNetworkRestriction',
+    requestTimeout: 'requestTimeout',
+    retryCount: 'retryCount',
+    validateIssuer: 'validateIssuer'
+};
+const prefixedConnectionProperties = {
+    tenantId: 'tenantId',
+    clientId: 'clientId',
+    clientSecret: 'clientSecret',
+    certPemFile: 'certPemFile',
+    certKeyFile: 'certKeyFile',
+    connectionName: 'connectionName',
+    FICClientId: 'federatedClientId',
+    authorityEndpoint: 'authorityEndpoint',
+    scope: 'scopes',
+    altBlueprintConnectionName: 'altBlueprintConnectionName',
+    alternateBlueprintConnectionName: 'altBlueprintConnectionName',
+    WIDAssertionFile: 'WIDAssertionFile',
+    azureRegion: 'azureRegion',
+    sendX5C: 'sendX5C',
+    msalRetryCount: 'msalRetryCount',
+    authType: 'authType',
+    federatedTokenFile: 'federatedTokenFile',
+    idpmResource: 'idpmResource',
+    sidecarBaseUrl: 'sidecarBaseUrl',
+    serviceName: 'serviceName',
+    blueprintServiceName: 'blueprintServiceName',
+    bypassLocalNetworkRestriction: 'bypassLocalNetworkRestriction',
+    requestTimeout: 'requestTimeout',
+    retryCount: 'retryCount',
+    validateIssuer: 'validateIssuer'
+};
+const legacyAuthorizationProperties = {
+    type: 'type',
+    connectionName: 'azureBotOAuthConnectionName',
+    connectionTitle: 'title',
+    connectionText: 'text',
+    maxAttempts: 'invalidSignInRetryMax',
+    messages_invalidCode: 'invalidSignInRetryMessage',
+    messages_invalidCodeFormat: 'invalidSignInRetryMessageFormat',
+    messages_maxAttemptsExceeded: 'invalidSignInRetryMaxExceededMessage',
+    obo_connection: 'oboConnectionName',
+    obo_scopes: 'oboScopes',
+    enableSso: 'enableSso',
+    scopes: 'scopes',
+    altBlueprintConnectionName: 'altBlueprintConnectionName'
+};
+/** Binds the flat Bot Framework single-connection environment variables. */
+function loadBotFrameworkEnvironmentConfiguration(env = process.env) {
+    return bindConnectionCompatibility(env, undefined, flatConnectionProperties);
+}
+/** Binds the Bot Framework `<connectionName>_<property>` environment form. */
+function loadBotFrameworkPrefixedEnvironmentConfiguration(connectionName, env = process.env) {
+    return bindConnectionCompatibility(env, connectionName, prefixedConnectionProperties);
+}
+/**
+ * Binds Bot Framework-era `<handlerId>_<property>` authorization variables.
+ * Only known runtime/external handler IDs participate, matching existing
+ * compatibility behavior.
+ */
+function loadBotFrameworkAuthorizationEnvironmentConfiguration(handlerIds, env = process.env) {
+    const layer = (0, configuration_1.createConfigurationLayer)();
+    const replacements = [];
+    const longestHandlerIdsFirst = [...handlerIds].sort((left, right) => right.length - left.length);
+    for (const [legacyKey, rawValue] of Object.entries(env)) {
+        if (!(rawValue === null || rawValue === void 0 ? void 0 : rawValue.trim())) {
+            continue;
+        }
+        const id = longestHandlerIdsFirst.find(candidate => legacyKey.toLowerCase().startsWith(`${candidate.toLowerCase()}_`));
+        if (!id) {
+            continue;
+        }
+        const legacyProperty = legacyKey.substring(id.length + 1);
+        const property = findProperty(legacyAuthorizationProperties, legacyProperty);
+        if (!property) {
+            continue;
+        }
+        const value = normalizeAuthorizationValue(property, rawValue);
+        if (!trySet(layer, `agentApplication.userAuthorization.handlers.${id}.settings.${property}`, value, legacyKey)) {
+            continue;
+        }
+        replacements.push({
+            legacyKey,
+            modernKey: `AgentApplication__UserAuthorization__Handlers__${id}__Settings__${property}`
+        });
+    }
+    return {
+        layer: (0, configuration_1.freezeConfigurationLayer)(layer),
+        replacements: Object.freeze(replacements.map(replacement => Object.freeze(replacement)))
+    };
+}
+function bindConnectionCompatibility(env, connectionName, properties) {
+    const layer = (0, configuration_1.createConfigurationLayer)();
+    const id = connectionName || DEFAULT_CONNECTION_ID;
+    const indexedEnvironment = (0, env_1.loadEnvSettings)(() => { }, env);
+    for (const [legacyProperty, property] of Object.entries(properties)) {
+        const key = connectionName ? `${connectionName}_${legacyProperty}` : legacyProperty;
+        const value = findEnvironmentValue(indexedEnvironment, key);
+        if (!(value === null || value === void 0 ? void 0 : value.trim())) {
+            continue;
+        }
+        trySet(layer, `connections.${id}.settings.${property}`, normalizeConnectionValue(property, value), key, property === 'validateIssuer');
+    }
+    return (0, configuration_1.freezeConfigurationLayer)(layer);
+}
+function findEnvironmentValue(env, key) {
+    var _a;
+    return (_a = env[key.toUpperCase()]) === null || _a === void 0 ? void 0 : _a.value;
+}
+function findProperty(properties, input) {
+    const key = Object.keys(properties).find(candidate => candidate.toLowerCase() === input.toLowerCase());
+    return key ? properties[key] : undefined;
+}
+function normalizeConnectionValue(property, value) {
+    if (property === 'sendX5C' || property === 'bypassLocalNetworkRestriction') {
+        return String(value === 'true');
+    }
+    if (property === 'msalRetryCount' || property === 'requestTimeout' || property === 'retryCount') {
+        const parsed = Number.parseInt(value, 10);
+        return Number.isFinite(parsed) ? String(parsed) : value;
+    }
+    return value;
+}
+function normalizeAuthorizationValue(property, value) {
+    if (property === 'enableSso') {
+        return String(value !== 'false');
+    }
+    if (property === 'invalidSignInRetryMax') {
+        const parsed = Number.parseInt(value);
+        return Number.isFinite(parsed) ? String(parsed) : value;
+    }
+    return value;
+}
+function trySet(layer, path, value, sourceName, throwOnInvalidValue = false) {
+    try {
+        (0, configuration_1.setConfigurationValue)(layer, path, value, sourceName, 'environment');
+        return true;
+    }
+    catch (error) {
+        if (!(0, configuration_1.isConfigurationInputError)(error)) {
+            throw error;
+        }
+        if (throwOnInvalidValue && (0, configuration_1.isInvalidConfigurationValueError)(error)) {
+            throw error;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=botFrameworkEnvironmentCompatibility.js.map

package/dist/src/configuration/botFrameworkEnvironmentCompatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"botFrameworkEnvironmentCompatibility.js","sourceRoot":"","sources":["../../../src/configuration/botFrameworkEnvironmentCompatibility.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,mDAOwB;AACxB,sCAAuD;AAEvD,MAAM,qBAAqB,GAAG,mBAAmB,CAAA;AAEjD,MAAM,wBAAwB,GAAG;IAC/B,oBAAoB,EAAE,UAAU;IAChC,cAAc,EAAE,UAAU;IAC1B,oBAAoB,EAAE,cAAc;IACpC,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,oBAAoB,EAAE,mBAAmB;IACzC,iBAAiB,EAAE,mBAAmB;IACtC,KAAK,EAAE,QAAQ;IACf,0BAA0B,EAAE,4BAA4B;IACxD,gCAAgC,EAAE,4BAA4B;IAC9D,gBAAgB,EAAE,kBAAkB;IACpC,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,UAAU;IACpB,kBAAkB,EAAE,oBAAoB;IACxC,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,oBAAoB,EAAE,sBAAsB;IAC5C,6BAA6B,EAAE,+BAA+B;IAC9D,cAAc,EAAE,gBAAgB;IAChC,UAAU,EAAE,YAAY;IACxB,cAAc,EAAE,gBAAgB;CACxB,CAAA;AAEV,MAAM,4BAA4B,GAAG;IACnC,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,mBAAmB;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,KAAK,EAAE,QAAQ;IACf,0BAA0B,EAAE,4BAA4B;IACxD,gCAAgC,EAAE,4BAA4B;IAC9D,gBAAgB,EAAE,kBAAkB;IACpC,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,UAAU;IACpB,kBAAkB,EAAE,oBAAoB;IACxC,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,oBAAoB,EAAE,sBAAsB;IAC5C,6BAA6B,EAAE,+BAA+B;IAC9D,cAAc,EAAE,gBAAgB;IAChC,UAAU,EAAE,YAAY;IACxB,cAAc,EAAE,gBAAgB;CACxB,CAAA;AAEV,MAAM,6BAA6B,GAAG;IACpC,IAAI,EAAE,MAAM;IACZ,cAAc,EAAE,6BAA6B;IAC7C,eAAe,EAAE,OAAO;IACxB,cAAc,EAAE,MAAM;IACtB,WAAW,EAAE,uBAAuB;IACpC,oBAAoB,EAAE,2BAA2B;IACjD,0BAA0B,EAAE,iCAAiC;IAC7D,4BAA4B,EAAE,sCAAsC;IACpE,cAAc,EAAE,mBAAmB;IACnC,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,0BAA0B,EAAE,4BAA4B;CAChD,CAAA;AAUV,4EAA4E;AAC5E,kDACE,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,OAAO,2BAA2B,CAAC,GAAG,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAA;AAC9E,CAAC;AAED,8EAA8E;AAC9E,0DACE,cAAsB,EACtB,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,OAAO,2BAA2B,CAAC,GAAG,EAAE,cAAc,EAAE,4BAA4B,CAAC,CAAA;AACvF,CAAC;AAED;;;;GAIG;AACH,+DACE,UAA6B,EAC7B,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,MAAM,KAAK,GAAG,IAAA,wCAAwB,GAAE,CAAA;IACxC,MAAM,YAAY,GAAoD,EAAE,CAAA;IACxE,MAAM,sBAAsB,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IAEhG,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxD,IAAI,EAAC,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,IAAI,EAAE,CAAA,EAAE,CAAC;YACtB,SAAQ;QACV,CAAC;QACD,MAAM,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CACjD,SAAS,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAClE,CAAA;QACD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,SAAQ;QACV,CAAC;QAED,MAAM,cAAc,GAAG,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACzD,MAAM,QAAQ,GAAG,YAAY,CAAC,6BAA6B,EAAE,cAAc,CAAC,CAAA;QAC5E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAQ;QACV,CAAC;QAED,MAAM,KAAK,GAAG,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAC7D,IAAI,CAAC,MAAM,CACT,KAAK,EACL,+CAA+C,EAAE,aAAa,QAAQ,EAAE,EACxE,KAAK,EACL,SAAS,CACV,EAAE,CAAC;YACF,SAAQ;QACV,CAAC;QAED,YAAY,CAAC,IAAI,CAAC;YAChB,SAAS;YACT,SAAS,EAAE,kDAAkD,EAAE,eAAe,QAAQ,EAAE;SACzF,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,IAAA,wCAAwB,EAAC,KAAK,CAAC;QACtC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;KACzF,CAAA;AACH,CAAC;AAED,SAAS,2BAA2B,CAClC,GAAsB,EACtB,cAAkC,EAClC,UAA4C;IAE5C,MAAM,KAAK,GAAG,IAAA,wCAAwB,GAAE,CAAA;IACxC,MAAM,EAAE,GAAG,cAAc,IAAI,qBAAqB,CAAA;IAClD,MAAM,kBAAkB,GAAG,IAAA,qBAAe,EAAC,GAAG,EAAE,GAAE,CAAC,EAAE,GAAG,CAAC,CAAA;IAEzD,KAAK,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACpE,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,cAAc,CAAA;QACnF,MAAM,KAAK,GAAG,oBAAoB,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAA;QAC3D,IAAI,EAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,EAAE,CAAA,EAAE,CAAC;YACnB,SAAQ;QACV,CAAC;QACD,MAAM,CACJ,KAAK,EACL,eAAe,EAAE,aAAa,QAAQ,EAAE,EACxC,wBAAwB,CAAC,QAAQ,EAAE,KAAK,CAAC,EACzC,GAAG,EACH,QAAQ,KAAK,gBAAgB,CAC9B,CAAA;IACH,CAAC;IAED,OAAO,IAAA,wCAAwB,EAAC,KAAK,CAAC,CAAA;AACxC,CAAC;AAED,SAAS,oBAAoB,CAAE,GAAY,EAAE,GAAW;;IACtD,OAAO,MAAA,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,0CAAE,KAAK,CAAA;AACtC,CAAC;AAED,SAAS,YAAY,CACnB,UAA4C,EAC5C,KAAa;IAEb,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IACtG,OAAO,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1C,CAAC;AAED,SAAS,wBAAwB,CAAE,QAAgB,EAAE,KAAa;IAChE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,+BAA+B,EAAE,CAAC;QAC3E,OAAO,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,CAAA;IACjC,CAAC;IACD,IAAI,QAAQ,KAAK,gBAAgB,IAAI,QAAQ,KAAK,gBAAgB,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QAChG,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QACzC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACzD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,2BAA2B,CAAE,QAAgB,EAAE,KAAa;IACnE,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,CAAA;IAClC,CAAC;IACD,IAAI,QAAQ,KAAK,uBAAuB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACzD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,MAAM,CACb,KAAyB,EACzB,IAAY,EACZ,KAAa,EACb,UAAkB,EAClB,mBAAmB,GAAG,KAAK;IAE3B,IAAI,CAAC;QACH,IAAA,qCAAqB,EAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,CAAC,CAAA;QACpE,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,IAAA,yCAAyB,EAAC,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,KAAK,CAAA;QACb,CAAC;QACD,IAAI,mBAAmB,IAAI,IAAA,gDAAgC,EAAC,KAAK,CAAC,EAAE,CAAC;YACnE,MAAM,KAAK,CAAA;QACb,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/src/configuration/configuration.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { ConfigurationSourceMode, ConfigurationSourceRegistration, ConfigurationSourceResult } from './configurationSource';
+export type AuthConnectionPatch = Record<string, unknown>;
+export type AuthConnectionMapPatch = Partial<{
+    serviceUrl: string;
+    audience: string;
+    connection: string;
+}>;
+export type CloudAdapterConfigurationPatch = Partial<{
+    emitStackTrace: boolean;
+    validateServiceUrl: boolean;
+}>;
+export type OutboundHostValidatorConfigurationPatch = Partial<{
+    enabled: boolean;
+    includeDefaultMicrosoftHosts: boolean;
+    hosts: readonly string[];
+}>;
+export type AuthorizationHandlerPatch = Record<string, unknown>;
+export interface ConfigurationLayer {
+    readonly connections: ReadonlyMap<string, Readonly<{
+        id: string;
+        settings: Readonly<AuthConnectionPatch>;
+    }>>;
+    readonly connectionsMap: ReadonlyMap<number, Readonly<AuthConnectionMapPatch>>;
+    readonly cloudAdapterOptions: Readonly<CloudAdapterConfigurationPatch>;
+    readonly outboundHostValidator: Readonly<OutboundHostValidatorConfigurationPatch>;
+    readonly agentApplication: Readonly<{
+        userAuthorization: Readonly<{
+            handlers: ReadonlyMap<string, Readonly<{
+                id: string;
+                settings: Readonly<AuthorizationHandlerPatch>;
+            }>>;
+        }>;
+    }>;
+}
+type ConfigurationSnapshot = Readonly<Record<ConfigurationSourceMode, ConfigurationLayer>>;
+type ConfigurationInputFormat = ConfigurationSourceResult['format'] | 'environment';
+/**
+ * An immutable, host-scoped set of resolved external configuration sources.
+ *
+ * @remarks
+ * Create instances with {@link createConfigurationContext}. The context is
+ * intentionally opaque; consumers pass it through their named options.
+ */
+export declare class ConfigurationContext {
+    private readonly configurationContextBrand;
+    private constructor();
+}
+export declare function createConfigurationLayer(): ConfigurationLayer;
+export declare function freezeConfigurationLayer(layer: ConfigurationLayer): ConfigurationLayer;
+export declare function mergeConfigurationLayers(...layers: readonly ConfigurationLayer[]): ConfigurationLayer;
+/**
+ * Suggests a canonical path by correcting only fixed schema segments.
+ * Dynamic connection/handler IDs and route indexes are preserved verbatim.
+ */
+export declare function suggestConfigurationPath(path: string): string | undefined;
+export declare function setConfigurationValue(target: ConfigurationLayer, path: string, rawValue: unknown, sourceName: string, format: ConfigurationInputFormat): void;
+export declare function isConfigurationInputError(error: unknown): boolean;
+export declare function isInvalidConfigurationValueError(error: unknown): boolean;
+/**
+ * Loads configuration sources into a new immutable, host-scoped context.
+ *
+ * @param registrations Configuration sources and their explicit resolution modes.
+ * @returns A context that can be shared by consumers belonging to one host.
+ */
+export declare function createConfigurationContext(registrations: readonly ConfigurationSourceRegistration[]): Promise<ConfigurationContext>;
+/**
+ * Preloads external configuration sources into an immutable process-level snapshot.
+ *
+ * @remarks
+ * Call this function once, before constructing configuration consumers such as
+ * `CloudAdapter` or `AgentApplication`. Sources in the same mode are applied in
+ * registration order, with later values winning.
+ *
+ * @param registrations Configuration sources and their explicit resolution modes.
+ */
+export declare function preloadConfigurationSources(registrations: readonly ConfigurationSourceRegistration[]): Promise<void>;
+export declare function getConfigurationSnapshot(context?: ConfigurationContext): ConfigurationSnapshot;
+export declare function resetConfigurationSourcesForTest(): void;
+export {};