@naylence/agent-sdk 0.3.4-test.727 → 0.3.4-test.728

package/dist/browser/index.js

@@ -15671,12 +15671,12 @@
     // --- END ENV SHIM ---
 
     // This file is auto-generated during build - do not edit manually
-    // Generated from package.json version: 0.3.5-test.929
+    // Generated from package.json version: 0.3.5-test.930
     /**
      * The package version, injected at build time.
      * @internal
      */
-    const VERSION$1 = '0.3.5-test.929';
+    const VERSION$1 = '0.3.5-test.930';
 
     /**
      * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -44050,239 +44050,10 @@
         default: NoopTraceEmitterFactory
     });
 
-    const logger$n = getLogger('naylence.fame.telemetry.otel_setup');
-    const stringFrom = (...codes) => String.fromCharCode(...codes);
-    const OTEL_PREFIX = `${stringFrom(64, 111, 112, 101, 110, 116, 101, 108, 101, 109, 101, 116, 114, 121)}${stringFrom(47)}`;
-    const OTEL_API_SPEC = `${OTEL_PREFIX}${stringFrom(97, 112, 105)}`;
-    const OTEL_RESOURCES_SPEC = `${OTEL_PREFIX}${stringFrom(114, 101, 115, 111, 117, 114, 99, 101, 115)}`;
-    const OTEL_TRACE_NODE_SPEC = `${OTEL_PREFIX}${stringFrom(115, 100, 107, 45, 116, 114, 97, 99, 101, 45, 110, 111, 100, 101)}`;
-    const OTEL_TRACE_BASE_SPEC = `${OTEL_PREFIX}${stringFrom(115, 100, 107, 45, 116, 114, 97, 99, 101, 45, 98, 97, 115, 101)}`;
-    const OTEL_EXPORTER_HTTP_SPEC = `${OTEL_PREFIX}${stringFrom(101, 120, 112, 111, 114, 116, 101, 114, 45, 116, 114, 97, 99, 101, 45, 111, 116, 108, 112, 45, 104, 116, 116, 112)}`;
-    let registeredOtel = null;
-    async function setupOtel(options) {
-        const normalized = normalizeSetupOtelOptions(options);
-        try {
-            if (registeredOtel) {
-                logger$n.debug('open_telemetry_reusing_provider', {
-                    service_name: normalized.serviceName,
-                });
-                return registeredOtel.control;
-            }
-            const [apiModule, resourcesModule, nodeModule, traceBaseModule] = await Promise.all([
-                import(OTEL_API_SPEC),
-                import(OTEL_RESOURCES_SPEC),
-                import(OTEL_TRACE_NODE_SPEC),
-                import(OTEL_TRACE_BASE_SPEC),
-            ]);
-            const { trace } = apiModule;
-            const { defaultResource, resourceFromAttributes } = resourcesModule;
-            const { NodeTracerProvider } = nodeModule;
-            const { BatchSpanProcessor, ConsoleSpanExporter, ParentBasedSampler, AlwaysOnSampler, AlwaysOffSampler, TraceIdRatioBasedSampler, } = traceBaseModule;
-            const currentProvider = trace.getTracerProvider();
-            if (currentProvider && currentProvider instanceof NodeTracerProvider) {
-                return null;
-            }
-            if (currentProvider &&
-                currentProvider.constructor?.name === 'NodeTracerProvider') {
-                logger$n.debug('open_telemetry_existing_node_provider', {
-                    service_name: normalized.serviceName,
-                });
-                return null;
-            }
-            logger$n.debug('open_telemetry_initializing', {
-                service_name: normalized.serviceName,
-                endpoint: normalized.endpoint ?? null,
-                environment: normalized.environment ?? null,
-                sampler: normalized.sampler ?? null,
-                headers_present: Boolean(normalized.headers && Object.keys(normalized.headers).length),
-            });
-            const sampler = resolveSampler(normalized.sampler, {
-                ParentBasedSampler,
-                AlwaysOnSampler,
-                AlwaysOffSampler,
-                TraceIdRatioBasedSampler,
-            });
-            const baseResource = defaultResource();
-            const mergedResource = resourceFromAttributes({
-                'service.name': normalized.serviceName,
-                'service.instance.id': generateInstanceId(),
-                'deployment.environment': normalized.environment ?? 'dev',
-            });
-            const resource = baseResource.merge(mergedResource);
-            const exporter = await resolveExporter(normalized.endpoint ?? undefined, normalized.headers, ConsoleSpanExporter);
-            const spanProcessor = new BatchSpanProcessor(exporter);
-            const provider = new NodeTracerProvider({
-                resource,
-                sampler,
-                spanProcessors: [spanProcessor],
-            });
-            provider.register();
-            logger$n.debug('open_telemetry_initialized', {
-                service_name: normalized.serviceName,
-                exporter: exporter.constructor?.name ?? 'unknown_exporter',
-            });
-            const control = {
-                forceFlush: async () => {
-                    try {
-                        await provider.forceFlush();
-                    }
-                    catch (flushError) {
-                        logger$n.warning('open_telemetry_force_flush_failed', {
-                            error: flushError instanceof Error
-                                ? flushError.message
-                                : String(flushError),
-                        });
-                    }
-                },
-                shutdown: async () => {
-                    try {
-                        await provider.shutdown();
-                    }
-                    catch (shutdownError) {
-                        logger$n.warning('open_telemetry_shutdown_failed', {
-                            error: shutdownError instanceof Error
-                                ? shutdownError.message
-                                : String(shutdownError),
-                        });
-                    }
-                    finally {
-                        registeredOtel = null;
-                    }
-                },
-            };
-            registeredOtel = {
-                provider,
-                control,
-            };
-            return control;
-        }
-        catch (error) {
-            logger$n.error('open_telemetry_not_available', {
-                error: error instanceof Error ? error.message : String(error),
-                stack: error instanceof Error && error.stack ? error.stack : undefined,
-            });
-            return null;
-        }
-    }
-    function normalizeSetupOtelOptions(options) {
-        const source = (options ?? {});
-        const serviceName = extractNonEmptyString$1(pickFirst$2(source, ['serviceName', 'service_name'])) ??
-            'naylence-service';
-        const endpoint = extractNonEmptyString$1(pickFirst$2(source, ['endpoint', 'otlpEndpoint', 'otlp_endpoint'])) ?? null;
-        const environment = extractNonEmptyString$1(pickFirst$2(source, [
-            'environment',
-            'deploymentEnvironment',
-            'deployment_environment',
-        ])) ?? null;
-        const sampler = extractNonEmptyString$1(pickFirst$2(source, ['sampler', 'samplingStrategy', 'sampling_strategy'])) ?? null;
-        const headers = extractHeaders$1(pickFirst$2(source, ['headers', 'otlpHeaders', 'otlp_headers']));
-        return {
-            serviceName,
-            endpoint,
-            environment,
-            sampler,
-            headers: headers ?? undefined,
-        };
-    }
-    function pickFirst$2(source, keys) {
-        for (const key of keys) {
-            if (Object.prototype.hasOwnProperty.call(source, key)) {
-                const value = source[key];
-                if (value !== undefined) {
-                    return value;
-                }
-            }
-        }
-        return undefined;
-    }
-    function extractNonEmptyString$1(value) {
-        if (typeof value === 'string') {
-            const trimmed = value.trim();
-            if (trimmed.length > 0) {
-                return trimmed;
-            }
-        }
-        return undefined;
-    }
-    function extractHeaders$1(value) {
-        if (!value || typeof value !== 'object') {
-            return null;
-        }
-        const headers = {};
-        for (const [key, raw] of Object.entries(value)) {
-            if (typeof raw === 'string') {
-                headers[key] = raw;
-            }
-        }
-        return Object.keys(headers).length > 0 ? headers : null;
-    }
-    function generateInstanceId() {
-        try {
-            if (typeof crypto !== 'undefined' &&
-                typeof crypto.randomUUID === 'function') {
-                return crypto.randomUUID().replace(/-/g, '');
-            }
-        }
-        catch {
-            // Ignore crypto availability errors
-        }
-        const random = Math.random().toString(16).slice(2);
-        return random.padEnd(32, '0').slice(0, 32);
-    }
-    function resolveSampler(samplerSetting, samplers) {
-        const normalized = (samplerSetting ?? 'parentbased_always_on').toLowerCase();
-        let base;
-        if (normalized === 'always_off') {
-            base = new samplers.AlwaysOffSampler();
-        }
-        else if (normalized === 'always_on' ||
-            normalized === 'parentbased_always_on') {
-            base = new samplers.AlwaysOnSampler();
-        }
-        else if (normalized.startsWith('ratio:')) {
-            const ratioValue = Number.parseFloat(normalized.slice('ratio:'.length));
-            const ratio = Number.isFinite(ratioValue)
-                ? Math.min(Math.max(ratioValue, 0), 1)
-                : 1;
-            base = new samplers.TraceIdRatioBasedSampler(ratio);
-        }
-        else {
-            base = new samplers.AlwaysOnSampler();
-        }
-        return new samplers.ParentBasedSampler({ root: base });
-    }
-    async function resolveExporter(endpoint, headers, ConsoleSpanExporter) {
-        if (endpoint) {
-            try {
-                const exporterModule = await import(OTEL_EXPORTER_HTTP_SPEC);
-                if ('OTLPTraceExporter' in exporterModule) {
-                    const { OTLPTraceExporter } = exporterModule;
-                    const exporterOptions = {
-                        url: endpoint,
-                    };
-                    if (headers && Object.keys(headers).length > 0) {
-                        exporterOptions.headers = headers;
-                    }
-                    logger$n.debug('open_telemetry_using_otlp_http_exporter', {
-                        endpoint,
-                        headers_present: Boolean(headers && Object.keys(headers).length),
-                    });
-                    return new OTLPTraceExporter(exporterOptions);
-                }
-            }
-            catch (error) {
-                logger$n.error('open_telemetry_exporter_not_available', {
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
-        }
-        logger$n.warning('open_telemetry_falling_back_to_console_exporter');
-        return new ConsoleSpanExporter();
-    }
-
     let openTelemetryTraceEmitterModulePromise = null;
     let otelApiModulePromise = null;
-    const logger$m = getLogger('naylence.fame.telemetry.open_telemetry_trace_emitter_factory');
+    let otelSetupModulePromise = null;
+    const logger$n = getLogger('naylence.fame.telemetry.open_telemetry_trace_emitter_factory');
     const MISSING_OTEL_HELP_MESSAGE = 'Missing optional OpenTelemetry dependency. Install @opentelemetry/api (and related packages) to enable trace emission.';
     function getOpenTelemetryTraceEmitterModule() {
         if (!openTelemetryTraceEmitterModulePromise) {
@@ -44300,6 +44071,14 @@
         }
         return otelApiModulePromise;
     }
+    function getOtelSetupModule() {
+        if (!otelSetupModulePromise) {
+            otelSetupModulePromise = safeImport(() => Promise.resolve().then(function () { return otelSetup; }), '@opentelemetry/api', {
+                helpMessage: MISSING_OTEL_HELP_MESSAGE,
+            });
+        }
+        return otelSetupModulePromise;
+    }
     const FACTORY_META$V = {
         base: TRACE_EMITTER_FACTORY_BASE_TYPE,
         key: 'OpenTelemetryTraceEmitter',
@@ -44323,7 +44102,7 @@
                     await AuthInjectionStrategyFactory.createAuthInjectionStrategy(normalized.auth);
                 try {
                     await authStrategy.apply(mergedHeaders);
-                    logger$m.info('trace_emitter_auth_applied', {
+                    logger$n.info('trace_emitter_auth_applied', {
                         service_name: normalized.serviceName,
                     });
                 }
@@ -44339,6 +44118,7 @@
             }
             let lifecycle = null;
             try {
+                const { setupOtel } = await getOtelSetupModule();
                 lifecycle = await setupOtel({
                     serviceName: normalized.serviceName,
                     endpoint: normalized.endpoint,
@@ -44346,7 +44126,7 @@
                     sampler: normalized.sampler,
                     headers: Object.keys(mergedHeaders).length > 0 ? mergedHeaders : undefined,
                 });
-                logger$m.debug('trace_emitter_lifecycle_acquired', {
+                logger$n.debug('trace_emitter_lifecycle_acquired', {
                     service_name: normalized.serviceName,
                     lifecycle_available: Boolean(lifecycle),
                 });
@@ -44384,7 +44164,7 @@
             }
             try {
                 const emitter = new OpenTelemetryTraceEmitter(emitterOptions);
-                logger$m.debug('trace_emitter_created', {
+                logger$n.debug('trace_emitter_created', {
                     service_name: normalized.serviceName,
                     has_lifecycle: Boolean(lifecycle),
                     has_auth_strategy: Boolean(authStrategy),
@@ -44416,17 +44196,17 @@
             };
         }
         const candidate = config;
-        const serviceName = extractString(pickFirst$1(candidate, ['serviceName', 'service_name'])) ??
+        const serviceName = extractString(pickFirst$2(candidate, ['serviceName', 'service_name'])) ??
             'naylence-service';
-        const endpoint = extractString(pickFirst$1(candidate, ['endpoint', 'otlpEndpoint', 'otlp_endpoint'])) ?? null;
-        const environment = extractString(pickFirst$1(candidate, [
+        const endpoint = extractString(pickFirst$2(candidate, ['endpoint', 'otlpEndpoint', 'otlp_endpoint'])) ?? null;
+        const environment = extractString(pickFirst$2(candidate, [
             'environment',
             'deploymentEnvironment',
             'deployment_environment',
         ])) ?? null;
-        const sampler = extractString(pickFirst$1(candidate, ['sampler', 'samplingStrategy', 'sampling_strategy'])) ?? null;
-        const headersFromConfig = extractHeaders(pickFirst$1(candidate, ['headers', 'otlpHeaders', 'otlp_headers']));
-        const authConfig = pickFirst$1(candidate, [
+        const sampler = extractString(pickFirst$2(candidate, ['sampler', 'samplingStrategy', 'sampling_strategy'])) ?? null;
+        const headersFromConfig = extractHeaders$1(pickFirst$2(candidate, ['headers', 'otlpHeaders', 'otlp_headers']));
+        const authConfig = pickFirst$2(candidate, [
             'auth',
         ]);
         return {
@@ -44444,7 +44224,7 @@
         }
         return undefined;
     }
-    function pickFirst$1(source, keys) {
+    function pickFirst$2(source, keys) {
         for (const key of keys) {
             if (Object.prototype.hasOwnProperty.call(source, key)) {
                 const value = source[key];
@@ -44455,7 +44235,7 @@
         }
         return undefined;
     }
-    function extractHeaders(value) {
+    function extractHeaders$1(value) {
         if (!value || typeof value !== 'object') {
             return null;
         }
@@ -44475,7 +44255,7 @@
         default: OpenTelemetryTraceEmitterFactory
     });
 
-    const logger$l = getLogger('naylence.fame.telemetry.trace_emitter_profile_factory');
+    const logger$m = getLogger('naylence.fame.telemetry.trace_emitter_profile_factory');
     const PROFILE_NAME_NOOP$1 = 'noop';
     const PROFILE_NAME_OPEN_TELEMETRY = 'open-telemetry';
     const ENV_VAR_TELEMETRY_SERVICE_NAME = 'FAME_TELEMETRY_SERVICE_NAME';
@@ -44503,7 +44283,7 @@
         async create(config, ...factoryArgs) {
             const normalized = normalizeTraceEmitterProfileConfig(config);
             const profileConfig = resolveProfileConfig$2(normalized.profile);
-            logger$l.debug('enabling_trace_emitter_profile', {
+            logger$m.debug('enabling_trace_emitter_profile', {
                 profile: normalized.profile,
             });
             const traceEmitter = await TraceEmitterFactory.createTraceEmitter(profileConfig, {
@@ -44691,7 +44471,7 @@
         default: HttpListenerFactory
     });
 
-    const logger$k = getLogger('naylence.fame.connector.http_stateless_connector');
+    const logger$l = getLogger('naylence.fame.connector.http_stateless_connector');
     class HttpStatelessConnector extends BaseAsyncConnector {
         constructor(config, dependencies = {}) {
             super(config);
@@ -44737,7 +44517,7 @@
             }
             catch (error) {
                 if (error instanceof QueueFullError) {
-                    logger$k.warning('receive_queue_full', {
+                    logger$l.warning('receive_queue_full', {
                         url: this.url,
                     });
                 }
@@ -44759,7 +44539,7 @@
                 });
                 if (!response.ok) {
                     const statusText = response.statusText || 'HTTP error';
-                    logger$k.error('http_request_failed', {
+                    logger$l.error('http_request_failed', {
                         url: this.url,
                         status: response.status,
                         statusText,
@@ -44771,7 +44551,7 @@
                 if (error instanceof FameTransportClose) {
                     throw error;
                 }
-                logger$k.error('http_request_error', {
+                logger$l.error('http_request_error', {
                     url: this.url,
                     error: error instanceof Error ? error.message : String(error),
                 });
@@ -44985,7 +44765,7 @@
         default: HttpStatelessConnectorFactory
     });
 
-    const logger$j = getLogger('naylence.fame.connector.websocket_connector_factory');
+    const logger$k = getLogger('naylence.fame.connector.websocket_connector_factory');
     let sslLoader = null;
     function setWebSocketConnectorSslLoader(loader) {
         sslLoader = loader;
@@ -45269,7 +45049,7 @@
         }
         async _defaultWebSocketClient(url, subprotocols, headers) {
             try {
-                logger$j.debug('websocket_connector_connecting', { url, subprotocols });
+                logger$k.debug('websocket_connector_connecting', { url, subprotocols });
                 if (typeof window !== 'undefined' &&
                     typeof window.WebSocket !== 'undefined') {
                     return await this._createBrowserWebSocket(url, subprotocols);
@@ -45352,7 +45132,7 @@
                     await Promise.resolve().then(function () { return websocketConnectorNodeSsl; });
                 }
                 catch (error) {
-                    logger$j.debug('ssl_certificate_loader_import_failed', {
+                    logger$k.debug('ssl_certificate_loader_import_failed', {
                         error: error instanceof Error ? error.message : String(error),
                     });
                 }
@@ -45361,7 +45141,7 @@
             if (!loader) {
                 return undefined;
             }
-            return await loader(logger$j);
+            return await loader(logger$k);
         }
     }
 
@@ -45696,7 +45476,7 @@
         default: AtMostOnceDeliveryPolicyFactory
     });
 
-    const logger$i = getLogger('naylence.fame.delivery.delivery_profile_factory');
+    const logger$j = getLogger('naylence.fame.delivery.delivery_profile_factory');
     const PROFILE_NAME_AT_LEAST_ONCE = 'at-least-once';
     const PROFILE_NAME_AT_MOST_ONCE = 'at-most-once';
     const ENV_VAR_FAME_DELIVERY_MAX_RETRIES = 'FAME_DELIVERY_MAX_RETRIES';
@@ -45736,7 +45516,7 @@
         async create(config) {
             const normalized = normalizeDeliveryProfileConfig(config);
             const profileConfig = resolveProfileConfig$1(normalized.profile);
-            logger$i.debug('enabling_delivery_profile', { profile: normalized.profile });
+            logger$j.debug('enabling_delivery_profile', { profile: normalized.profile });
             const policy = await DeliveryPolicyFactory.createDeliveryPolicy(profileConfig);
             if (!policy) {
                 throw new Error(`Failed to create delivery policy for profile: ${normalized.profile}`);
@@ -45819,7 +45599,7 @@
             service.capabilities.includes(SINK_CAPABILITY));
     }
 
-    const logger$h = getLogger('naylence.fame.fabric.in_process');
+    const logger$i = getLogger('naylence.fame.fabric.in_process');
     function normalizeNodeConfig(config) {
         if (config && typeof config === 'object' && !Array.isArray(config)) {
             return config;
@@ -45843,13 +45623,13 @@
             this._versionLogged = true;
             const version = await resolveRuntimeVersion();
             if (version) {
-                logger$h.info('naylence_runtime_startup', {
+                logger$i.info('naylence_runtime_startup', {
                     version,
                     fabric_type: 'in_process',
                 });
             }
             else {
-                logger$h.warning('naylence_runtime_version_not_found', {
+                logger$i.warning('naylence_runtime_version_not_found', {
                     message: 'Could not determine package version',
                     fabric_type: 'in_process',
                 });
@@ -45874,7 +45654,7 @@
                 return;
             }
             await this.logStartupVersion();
-            logger$h.debug('starting_fabric', { type: 'in_process' });
+            logger$i.debug('starting_fabric', { type: 'in_process' });
             if (!this._currentNode) {
                 const nodeConfig = normalizeNodeConfig(this._config?.node ?? null);
                 this._currentNode = await NodeLikeFactory.createNode(nodeConfig);
@@ -46009,7 +45789,7 @@
         default: InProcessFameFabricFactory
     });
 
-    const logger$g = getLogger('naylence.fame.node.admission.admission_profile_factory');
+    const logger$h = getLogger('naylence.fame.node.admission.admission_profile_factory');
     const ENV_VAR_IS_ROOT = 'FAME_ROOT';
     const ENV_VAR_JWT_AUDIENCE = 'FAME_JWT_AUDIENCE';
     const ENV_VAR_ADMISSION_TOKEN_URL = 'FAME_ADMISSION_TOKEN_URL';
@@ -46244,7 +46024,7 @@
         async create(config) {
             const normalized = normalizeConfig$m(config);
             const profileConfig = resolveProfileConfig(normalized.profile);
-            logger$g.debug('enabling_admission_profile', { profile: normalized.profile });
+            logger$h.debug('enabling_admission_profile', { profile: normalized.profile });
             return AdmissionClientFactory.createAdmissionClient(profileConfig);
         }
     }
@@ -46283,7 +46063,7 @@
         default: AdmissionProfileFactory
     });
 
-    const logger$f = getLogger('naylence.fame.node.admission.direct_admission_client');
+    const logger$g = getLogger('naylence.fame.node.admission.direct_admission_client');
     class DirectAdmissionClient {
         constructor(options) {
             this.hasUpstream = true;
@@ -46308,7 +46088,7 @@
             }
         }
         async hello(systemId, instanceId, requestedLogicals) {
-            logger$f.debug('direct_admission_hello_start', {
+            logger$g.debug('direct_admission_hello_start', {
                 providedSystemId: systemId,
                 instanceId,
                 requestedLogicals,
@@ -46316,7 +46096,7 @@
             const effectiveSystemId = systemId && systemId.trim().length > 0
                 ? systemId
                 : await generateIdAsync({ mode: 'fingerprint' }).catch(async () => {
-                    logger$f.debug('direct_admission_fingerprint_generation_failed', {
+                    logger$g.debug('direct_admission_fingerprint_generation_failed', {
                         reason: 'falling back to random id',
                     });
                     return generateIdAsync({ mode: 'random' });
@@ -46338,7 +46118,7 @@
             const envelope = createFameEnvelope({
                 frame: welcomeFrame,
             });
-            logger$f.debug('direct_admission_hello_success', {
+            logger$g.debug('direct_admission_hello_success', {
                 systemId: welcomeFrame.systemId,
                 instanceId: welcomeFrame.instanceId,
                 acceptedLogicals: welcomeFrame.acceptedLogicals,
@@ -46515,7 +46295,7 @@
         default: NoAuthInjectionStrategyFactory
     });
 
-    const logger$e = getLogger('naylence.fame.node.admission.welcome_service_client');
+    const logger$f = getLogger('naylence.fame.node.admission.welcome_service_client');
     class WelcomeServiceClient {
         constructor(options) {
             this.hasUpstream = options.hasUpstream ?? options.has_upstream ?? false;
@@ -46564,7 +46344,7 @@
                     'Content-Type': 'application/json',
                     ...authHeaders,
                 };
-                logger$e.debug('welcome_service_hello_request', {
+                logger$f.debug('welcome_service_hello_request', {
                     url: this.url,
                     systemId,
                     instanceId,
@@ -46600,7 +46380,7 @@
                     parsedEnvelope.frame.type !== 'NodeWelcome') {
                     throw new Error(`Unexpected frame type '${parsedEnvelope.frame?.type ?? 'unknown'}'`);
                 }
-                logger$e.debug('welcome_service_hello_success', {
+                logger$f.debug('welcome_service_hello_success', {
                     systemId: parsedEnvelope.frame.systemId,
                     targetSystemId: parsedEnvelope.frame.targetSystemId,
                     assignedPath: parsedEnvelope.frame.assignedPath,
@@ -47732,7 +47512,7 @@
         default: NoopTokenVerifierFactory
     });
 
-    const logger$d = getLogger('naylence.fame.security.auth.oauth2_authorizer_factory');
+    const logger$e = getLogger('naylence.fame.security.auth.oauth2_authorizer_factory');
     let oauth2AuthorizerModulePromise = null;
     function getOAuth2AuthorizerModule() {
         if (!oauth2AuthorizerModulePromise) {
@@ -47759,12 +47539,12 @@
             if (normalized.tokenIssuerConfig) {
                 try {
                     tokenIssuer = await TokenIssuerFactory.createTokenIssuer(normalized.tokenIssuerConfig);
-                    logger$d.debug('token_issuer_created_for_reverse_auth', {
+                    logger$e.debug('token_issuer_created_for_reverse_auth', {
                         issuer_type: normalized.tokenIssuerConfig.type,
                     });
                 }
                 catch (error) {
-                    logger$d.warning('failed_to_create_token_issuer_for_reverse_auth', {
+                    logger$e.warning('failed_to_create_token_issuer_for_reverse_auth', {
                         error: error instanceof Error ? error.message : String(error),
                         issuer_config: normalized.tokenIssuerConfig,
                     });
@@ -48717,7 +48497,7 @@
         normalizeSessionKeyConfig: normalizeSessionKeyConfig
     });
 
-    const logger$c = getLogger('naylence.fame.security.default_security_manager_factory');
+    const logger$d = getLogger('naylence.fame.security.default_security_manager_factory');
     function normalizeDefaultSecurityManagerConfig(config) {
         if (!config) {
             return null;
@@ -48885,7 +48665,7 @@
                 return await KeyStoreFactory.createKeyStore(value, createOptions ?? undefined);
             }
             catch (error) {
-                logger$c.error('failed_to_create_key_store_from_config', {
+                logger$d.error('failed_to_create_key_store_from_config', {
                     error: error instanceof Error ? error.message : String(error),
                 });
                 return null;
@@ -48921,7 +48701,7 @@
                     return null;
                 }
                 const cryptoProvider = cryptoProviderOverride ?? null;
-                logger$c.debug('auto_create_envelope_signer', {
+                logger$d.debug('auto_create_envelope_signer', {
                     has_crypto_override: Boolean(cryptoProviderOverride),
                     override_constructor: cryptoProviderOverride
                         ? (cryptoProviderOverride.constructor?.name ?? 'unknown')
@@ -48942,7 +48722,7 @@
                 });
             }
             catch (error) {
-                logger$c.error('failed_to_auto_create_envelope_signer', {
+                logger$d.error('failed_to_auto_create_envelope_signer', {
                     error: error instanceof Error ? error.message : String(error),
                     exc_info: true,
                 });
@@ -48977,7 +48757,7 @@
                 });
             }
             catch (error) {
-                logger$c.error('failed_to_auto_create_envelope_verifier', {
+                logger$d.error('failed_to_auto_create_envelope_verifier', {
                     error: error instanceof Error ? error.message : String(error),
                     exc_info: true,
                 });
@@ -48989,7 +48769,7 @@
             if (encryptionConfig &&
                 DefaultSecurityManagerFactory.isConfigLike(encryptionConfig)) {
                 if (!keyManager) {
-                    logger$c.warning('encryption_manager_config_requires_key_manager');
+                    logger$d.warning('encryption_manager_config_requires_key_manager');
                     return { encryptionManager: null, secureChannelManager };
                 }
                 const manager = await EncryptionManagerFactory.createEncryptionManager(encryptionConfig, {
@@ -49026,7 +48806,7 @@
                 return { encryptionManager: manager, secureChannelManager };
             }
             catch (error) {
-                logger$c.error('failed_to_auto_create_encryption_manager', {
+                logger$d.error('failed_to_auto_create_encryption_manager', {
                     error: error instanceof Error ? error.message : String(error),
                     exc_info: true,
                 });
@@ -49069,7 +48849,7 @@
                 });
             }
             catch (error) {
-                logger$c.error('failed_to_auto_create_key_manager', {
+                logger$d.error('failed_to_auto_create_key_manager', {
                     error: error instanceof Error ? error.message : String(error),
                     exc_info: true,
                 });
@@ -49118,7 +48898,7 @@
                 })) ?? null);
             }
             catch (error) {
-                logger$c.error('failed_to_auto_create_authorizer', {
+                logger$d.error('failed_to_auto_create_authorizer', {
                     error: error instanceof Error ? error.message : String(error),
                     exc_info: true,
                 });
@@ -49147,7 +48927,7 @@
                 });
             }
             catch (error) {
-                logger$c.error('failed_to_auto_create_certificate_manager', {
+                logger$d.error('failed_to_auto_create_certificate_manager', {
                     error: error instanceof Error ? error.message : String(error),
                     exc_info: true,
                 });
@@ -49405,7 +49185,7 @@
         default: DefaultKeyManagerFactory
     });
 
-    const logger$b = getLogger('naylence.fame.security.keys.in_memory_key_store');
+    const logger$c = getLogger('naylence.fame.security.keys.in_memory_key_store');
     class InMemoryKeyStore extends KeyStore {
         constructor(initialKeys = null) {
             super();
@@ -49427,7 +49207,7 @@
             }
             catch (error) {
                 if (error instanceof JWKValidationError) {
-                    logger$b.warning('rejected_invalid_jwk_individual', {
+                    logger$c.warning('rejected_invalid_jwk_individual', {
                         kid,
                         error: error.message,
                     });
@@ -49471,7 +49251,7 @@
                     }
                 }
                 if (staleKeys.length > 0) {
-                    logger$b.debug('removing_stale_keys_before_adding_new_key', {
+                    logger$c.debug('removing_stale_keys_before_adding_new_key', {
                         new_kid: kid,
                         physical_path: physicalPath,
                         base_path: basePath,
@@ -49499,7 +49279,7 @@
                     }
                     keysByPath[path].push(existingKid);
                 }
-                logger$b.debug('key_lookup_failed', {
+                logger$c.debug('key_lookup_failed', {
                     missing_kid: kid,
                     available_kids: Array.from(this.keys.keys()),
                     keys_by_path: keysByPath,
@@ -49548,7 +49328,7 @@
                 this.keys.delete(kid);
             }
             if (keysToRemove.length > 0) {
-                logger$b.debug('removed_keys_for_path', {
+                logger$c.debug('removed_keys_for_path', {
                     physical_path: physicalPath,
                     removed_key_ids: keysToRemove,
                     count: keysToRemove.length,
@@ -49559,7 +49339,7 @@
         async removeKey(kid) {
             const removed = this.keys.delete(kid);
             if (removed) {
-                logger$b.debug('removed_individual_key', { kid });
+                logger$c.debug('removed_individual_key', { kid });
             }
             return removed;
         }
@@ -49925,7 +49705,7 @@
         default: CapabilityAwareRoutingPolicyFactory
     });
 
-    const logger$a = getLogger('naylence.fame.sentinel.composite_routing_policy_factory');
+    const logger$b = getLogger('naylence.fame.sentinel.composite_routing_policy_factory');
     const FACTORY_META$8 = {
         base: ROUTING_POLICY_FACTORY_BASE,
         key: 'CompositeRoutingPolicy',
@@ -49951,13 +49731,13 @@
                         policies.push(policy);
                     }
                     else {
-                        logger$a.warning('composite_policy_null_child', {
+                        logger$b.warning('composite_policy_null_child', {
                             config: policyConfig,
                         });
                     }
                 }
                 catch (error) {
-                    logger$a.warning('composite_policy_child_error', {
+                    logger$b.warning('composite_policy_child_error', {
                         error: error instanceof Error ? error.message : String(error),
                         config: policyConfig,
                     });
@@ -50253,7 +50033,7 @@
         default: HRWLoadBalancingStrategyFactory
     });
 
-    const logger$9 = getLogger('naylence.fame.sentinel.load_balancing.load_balancing_profile_factory');
+    const logger$a = getLogger('naylence.fame.sentinel.load_balancing.load_balancing_profile_factory');
     const PROFILE_NAME_RANDOM = 'random';
     const PROFILE_NAME_ROUND_ROBIN = 'round_robin';
     const PROFILE_NAME_HRW = 'hrw';
@@ -50287,7 +50067,7 @@
         async create(config, ...factoryArgs) {
             const finalConfig = this.normalizeConfig(config);
             const profileName = finalConfig.profile ?? PROFILE_NAME_DEVELOPMENT$1;
-            logger$9.debug('enabling_load_balancing_profile', { profile: profileName });
+            logger$a.debug('enabling_load_balancing_profile', { profile: profileName });
             const strategyConfig = this.resolveProfile(profileName);
             const strategy = await createResource$1(LOAD_BALANCING_STRATEGY_FACTORY_BASE, strategyConfig, { factoryArgs });
             if (!strategy) {
@@ -50478,7 +50258,7 @@
         default: StickyLoadBalancingStrategyFactory
     });
 
-    const logger$8 = getLogger('naylence.fame.sentinel.routing_profile_factory');
+    const logger$9 = getLogger('naylence.fame.sentinel.routing_profile_factory');
     const PROFILE_NAME_DEVELOPMENT = 'development';
     const PROFILE_NAME_PRODUCTION = 'production';
     const PROFILE_NAME_BASIC = 'basic';
@@ -50529,7 +50309,7 @@
         }
         async create(config, ...kwargs) {
             const normalized = this.normalizeConfig(config);
-            logger$8.debug('enabling_routing_profile', { profile: normalized.profile });
+            logger$9.debug('enabling_routing_profile', { profile: normalized.profile });
             const routingConfig = this.getProfileConfig(normalized.profile);
             const policy = await createResource$1(ROUTING_POLICY_FACTORY_BASE, routingConfig, {
                 factoryArgs: kwargs,
@@ -50825,21 +50605,21 @@
     }
     function normalizeOpenTelemetryTraceEmitterOptions(input) {
         const source = (input ?? {});
-        const serviceName = extractNonEmptyString(pickFirst(source, ['serviceName', 'service_name'])) ?? 'naylence-service';
-        const tracer = pickFirst(source, ['tracer']);
-        const otelApi = pickFirst(source, [
+        const serviceName = extractNonEmptyString$1(pickFirst$1(source, ['serviceName', 'service_name'])) ?? 'naylence-service';
+        const tracer = pickFirst$1(source, ['tracer']);
+        const otelApi = pickFirst$1(source, [
             'otelApi',
             'otel_api',
         ]);
         if (!otelApi) {
             throw new Error('OpenTelemetryTraceEmitter requires OpenTelemetry API bindings. Provide otelApi via options.');
         }
-        const lifecycle = pickFirst(source, [
+        const lifecycle = pickFirst$1(source, [
             'lifecycle',
             'lifeCycle',
             'life_cycle',
         ]) ?? null;
-        const authStrategy = pickFirst(source, [
+        const authStrategy = pickFirst$1(source, [
             'authStrategy',
             'auth_strategy',
         ]) ?? null;
@@ -50851,7 +50631,7 @@
             authStrategy,
         };
     }
-    function pickFirst(source, keys) {
+    function pickFirst$1(source, keys) {
         for (const key of keys) {
             if (Object.prototype.hasOwnProperty.call(source, key)) {
                 const value = source[key];
@@ -50862,7 +50642,7 @@
         }
         return undefined;
     }
-    function extractNonEmptyString(value) {
+    function extractNonEmptyString$1(value) {
         if (typeof value === 'string') {
             const trimmed = value.trim();
             if (trimmed.length > 0) {
@@ -50915,6 +50695,241 @@
         OpenTelemetryTraceEmitter: OpenTelemetryTraceEmitter
     });
 
+    const logger$8 = getLogger('naylence.fame.telemetry.otel_setup');
+    const stringFrom = (...codes) => String.fromCharCode(...codes);
+    const OTEL_PREFIX = `${stringFrom(64, 111, 112, 101, 110, 116, 101, 108, 101, 109, 101, 116, 114, 121)}${stringFrom(47)}`;
+    const OTEL_API_SPEC = `${OTEL_PREFIX}${stringFrom(97, 112, 105)}`;
+    const OTEL_RESOURCES_SPEC = `${OTEL_PREFIX}${stringFrom(114, 101, 115, 111, 117, 114, 99, 101, 115)}`;
+    const OTEL_TRACE_NODE_SPEC = `${OTEL_PREFIX}${stringFrom(115, 100, 107, 45, 116, 114, 97, 99, 101, 45, 110, 111, 100, 101)}`;
+    const OTEL_TRACE_BASE_SPEC = `${OTEL_PREFIX}${stringFrom(115, 100, 107, 45, 116, 114, 97, 99, 101, 45, 98, 97, 115, 101)}`;
+    const OTEL_EXPORTER_HTTP_SPEC = `${OTEL_PREFIX}${stringFrom(101, 120, 112, 111, 114, 116, 101, 114, 45, 116, 114, 97, 99, 101, 45, 111, 116, 108, 112, 45, 104, 116, 116, 112)}`;
+    let registeredOtel = null;
+    async function setupOtel(options) {
+        const normalized = normalizeSetupOtelOptions(options);
+        try {
+            if (registeredOtel) {
+                logger$8.debug('open_telemetry_reusing_provider', {
+                    service_name: normalized.serviceName,
+                });
+                return registeredOtel.control;
+            }
+            const [apiModule, resourcesModule, nodeModule, traceBaseModule] = await Promise.all([
+                import(OTEL_API_SPEC),
+                import(OTEL_RESOURCES_SPEC),
+                import(OTEL_TRACE_NODE_SPEC),
+                import(OTEL_TRACE_BASE_SPEC),
+            ]);
+            const { trace } = apiModule;
+            const { defaultResource, resourceFromAttributes } = resourcesModule;
+            const { NodeTracerProvider } = nodeModule;
+            const { BatchSpanProcessor, ConsoleSpanExporter, ParentBasedSampler, AlwaysOnSampler, AlwaysOffSampler, TraceIdRatioBasedSampler, } = traceBaseModule;
+            const currentProvider = trace.getTracerProvider();
+            if (currentProvider && currentProvider instanceof NodeTracerProvider) {
+                return null;
+            }
+            if (currentProvider &&
+                currentProvider.constructor?.name === 'NodeTracerProvider') {
+                logger$8.debug('open_telemetry_existing_node_provider', {
+                    service_name: normalized.serviceName,
+                });
+                return null;
+            }
+            logger$8.debug('open_telemetry_initializing', {
+                service_name: normalized.serviceName,
+                endpoint: normalized.endpoint ?? null,
+                environment: normalized.environment ?? null,
+                sampler: normalized.sampler ?? null,
+                headers_present: Boolean(normalized.headers && Object.keys(normalized.headers).length),
+            });
+            const sampler = resolveSampler(normalized.sampler, {
+                ParentBasedSampler,
+                AlwaysOnSampler,
+                AlwaysOffSampler,
+                TraceIdRatioBasedSampler,
+            });
+            const baseResource = defaultResource();
+            const mergedResource = resourceFromAttributes({
+                'service.name': normalized.serviceName,
+                'service.instance.id': generateInstanceId(),
+                'deployment.environment': normalized.environment ?? 'dev',
+            });
+            const resource = baseResource.merge(mergedResource);
+            const exporter = await resolveExporter(normalized.endpoint ?? undefined, normalized.headers, ConsoleSpanExporter);
+            const spanProcessor = new BatchSpanProcessor(exporter);
+            const provider = new NodeTracerProvider({
+                resource,
+                sampler,
+                spanProcessors: [spanProcessor],
+            });
+            provider.register();
+            logger$8.debug('open_telemetry_initialized', {
+                service_name: normalized.serviceName,
+                exporter: exporter.constructor?.name ?? 'unknown_exporter',
+            });
+            const control = {
+                forceFlush: async () => {
+                    try {
+                        await provider.forceFlush();
+                    }
+                    catch (flushError) {
+                        logger$8.warning('open_telemetry_force_flush_failed', {
+                            error: flushError instanceof Error
+                                ? flushError.message
+                                : String(flushError),
+                        });
+                    }
+                },
+                shutdown: async () => {
+                    try {
+                        await provider.shutdown();
+                    }
+                    catch (shutdownError) {
+                        logger$8.warning('open_telemetry_shutdown_failed', {
+                            error: shutdownError instanceof Error
+                                ? shutdownError.message
+                                : String(shutdownError),
+                        });
+                    }
+                    finally {
+                        registeredOtel = null;
+                    }
+                },
+            };
+            registeredOtel = {
+                provider,
+                control,
+            };
+            return control;
+        }
+        catch (error) {
+            logger$8.error('open_telemetry_not_available', {
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error && error.stack ? error.stack : undefined,
+            });
+            return null;
+        }
+    }
+    function normalizeSetupOtelOptions(options) {
+        const source = (options ?? {});
+        const serviceName = extractNonEmptyString(pickFirst(source, ['serviceName', 'service_name'])) ??
+            'naylence-service';
+        const endpoint = extractNonEmptyString(pickFirst(source, ['endpoint', 'otlpEndpoint', 'otlp_endpoint'])) ?? null;
+        const environment = extractNonEmptyString(pickFirst(source, [
+            'environment',
+            'deploymentEnvironment',
+            'deployment_environment',
+        ])) ?? null;
+        const sampler = extractNonEmptyString(pickFirst(source, ['sampler', 'samplingStrategy', 'sampling_strategy'])) ?? null;
+        const headers = extractHeaders(pickFirst(source, ['headers', 'otlpHeaders', 'otlp_headers']));
+        return {
+            serviceName,
+            endpoint,
+            environment,
+            sampler,
+            headers: headers ?? undefined,
+        };
+    }
+    function pickFirst(source, keys) {
+        for (const key of keys) {
+            if (Object.prototype.hasOwnProperty.call(source, key)) {
+                const value = source[key];
+                if (value !== undefined) {
+                    return value;
+                }
+            }
+        }
+        return undefined;
+    }
+    function extractNonEmptyString(value) {
+        if (typeof value === 'string') {
+            const trimmed = value.trim();
+            if (trimmed.length > 0) {
+                return trimmed;
+            }
+        }
+        return undefined;
+    }
+    function extractHeaders(value) {
+        if (!value || typeof value !== 'object') {
+            return null;
+        }
+        const headers = {};
+        for (const [key, raw] of Object.entries(value)) {
+            if (typeof raw === 'string') {
+                headers[key] = raw;
+            }
+        }
+        return Object.keys(headers).length > 0 ? headers : null;
+    }
+    function generateInstanceId() {
+        try {
+            if (typeof crypto !== 'undefined' &&
+                typeof crypto.randomUUID === 'function') {
+                return crypto.randomUUID().replace(/-/g, '');
+            }
+        }
+        catch {
+            // Ignore crypto availability errors
+        }
+        const random = Math.random().toString(16).slice(2);
+        return random.padEnd(32, '0').slice(0, 32);
+    }
+    function resolveSampler(samplerSetting, samplers) {
+        const normalized = (samplerSetting ?? 'parentbased_always_on').toLowerCase();
+        let base;
+        if (normalized === 'always_off') {
+            base = new samplers.AlwaysOffSampler();
+        }
+        else if (normalized === 'always_on' ||
+            normalized === 'parentbased_always_on') {
+            base = new samplers.AlwaysOnSampler();
+        }
+        else if (normalized.startsWith('ratio:')) {
+            const ratioValue = Number.parseFloat(normalized.slice('ratio:'.length));
+            const ratio = Number.isFinite(ratioValue)
+                ? Math.min(Math.max(ratioValue, 0), 1)
+                : 1;
+            base = new samplers.TraceIdRatioBasedSampler(ratio);
+        }
+        else {
+            base = new samplers.AlwaysOnSampler();
+        }
+        return new samplers.ParentBasedSampler({ root: base });
+    }
+    async function resolveExporter(endpoint, headers, ConsoleSpanExporter) {
+        if (endpoint) {
+            try {
+                const exporterModule = await import(OTEL_EXPORTER_HTTP_SPEC);
+                if ('OTLPTraceExporter' in exporterModule) {
+                    const { OTLPTraceExporter } = exporterModule;
+                    const exporterOptions = {
+                        url: endpoint,
+                    };
+                    if (headers && Object.keys(headers).length > 0) {
+                        exporterOptions.headers = headers;
+                    }
+                    logger$8.debug('open_telemetry_using_otlp_http_exporter', {
+                        endpoint,
+                        headers_present: Boolean(headers && Object.keys(headers).length),
+                    });
+                    return new OTLPTraceExporter(exporterOptions);
+                }
+            }
+            catch (error) {
+                logger$8.error('open_telemetry_exporter_not_available', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        logger$8.warning('open_telemetry_falling_back_to_console_exporter');
+        return new ConsoleSpanExporter();
+    }
+
+    var otelSetup = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        setupOtel: setupOtel
+    });
+
     const logger$7 = getLogger('naylence.fame.connector.default_http_server');
     function makeKey(host, port) {
         return `${host}:${port}`;