@juspay/neurolink 12.59.0 → 13.0.0

package/dist/core/modules/TelemetryHandler.js

@@ -1,7 +1,7 @@
 /**
  * Telemetry Handler Module
  *
- * Handles analytics, evaluation, performance metrics, and telemetry configuration.
+ * Handles analytics, evaluation and performance metrics.
  * Extracted from BaseProvider to follow Single Responsibility Principle.
  *
  * Responsibilities:
@@ -9,7 +9,6 @@
  * - Evaluation generation
  * - Performance metrics recording
  * - Cost calculation
- * - Telemetry configuration
  *
  * @module core/modules/TelemetryHandler
  */
@@ -17,9 +16,7 @@ import { nanoid } from "nanoid";
 import { extractTokenUsage } from "../../utils/tokenUtils.js";
 import { logger } from "../../utils/logger.js";
 import { recordProviderPerformanceFromMetrics } from "../evaluationProviders.js";
-import { TelemetryService } from "../../telemetry/telemetryService.js";
 import { calculateCost, hasPricing } from "../../utils/pricing.js";
-import { getLangfuseContext } from "../../services/server/ai/observability/instrumentation.js";
 /**
  * TelemetryHandler class - Handles analytics and telemetry for AI providers
  */
@@ -87,8 +84,6 @@ export class TelemetryHandler {
                 cost: actualCost,
                 success: true,
             });
-            // Wire TelemetryService metrics so OTEL counters/histograms are populated
-            TelemetryService.getInstance().recordAIRequest(this.providerName, this.modelName, totalTokens, responseTime, actualCost !== undefined && actualCost > 0 ? actualCost : undefined);
             logger.debug(`Performance recorded for ${this.providerName}`, {
                 responseTime: `${responseTime}ms`,
                 tokens: totalTokens,
@@ -99,26 +94,6 @@ export class TelemetryHandler {
             logger.warn("⚠️ Performance recording failed:", perfError);
         }
     }
-    /**
-     * Record a TTS synthesis failure without affecting the generation result.
-     */
-    recordTTSFailure(ttsProvider, error, latency) {
-        try {
-            const labels = {
-                provider: ttsProvider,
-                error_code: error.code,
-                ...(error.retriable !== undefined
-                    ? { retriable: error.retriable.toString() }
-                    : {}),
-            };
-            const telemetry = TelemetryService.getInstance();
-            telemetry.recordCustomMetric("tts_failures", 1, labels);
-            telemetry.recordCustomHistogram("tts_failure_latency_ms", latency, labels);
-        }
-        catch (telemetryError) {
-            logger.warn("TTS failure telemetry recording failed:", telemetryError);
-        }
-    }
     /**
      * Estimate cost only from known per-model rates. Unknown pricing remains
      * absent from cost metrics instead of using another model's default rate.
@@ -137,46 +112,6 @@ export class TelemetryHandler {
             return undefined;
         }
     }
-    /**
-     * Create telemetry configuration for Vercel AI SDK experimental_telemetry
-     * This enables automatic OpenTelemetry tracing when telemetry is enabled
-     */
-    getTelemetryConfig(options, operationType = "stream") {
-        // Check if telemetry is enabled via NeuroLink observability config
-        if (!this.neurolink?.isTelemetryEnabled()) {
-            return undefined;
-        }
-        const context = options.context;
-        const langfuseContext = getLangfuseContext();
-        const traceName = context?.traceName ?? langfuseContext?.traceName;
-        const userId = context?.userId ?? langfuseContext?.userId;
-        const functionId = traceName ? traceName : userId ? userId : "guest";
-        const metadata = {
-            ...(context?.metadata || {}),
-            provider: this.providerName,
-            model: this.modelName,
-            toolsEnabled: !options.disableTools,
-            neurolink: true,
-            operationType,
-            originalProvider: this.providerName,
-        };
-        // Add sessionId if available
-        if ("sessionId" in options && options.sessionId) {
-            const sessionId = options.sessionId;
-            if (typeof sessionId === "string" ||
-                typeof sessionId === "number" ||
-                typeof sessionId === "boolean") {
-                metadata.sessionId = sessionId;
-            }
-        }
-        return {
-            isEnabled: true,
-            functionId,
-            metadata,
-            recordInputs: process.env.NEUROLINK_RECORD_INPUTS?.toLowerCase() !== "false",
-            recordOutputs: true,
-        };
-    }
     /**
      * Handle tool execution storage if available
      */

package/dist/core/modules/ToolsManager.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { createToolEventPayload } from "../toolEvents.js";
-import { tracers, ATTR, withSpan } from "../../telemetry/index.js";
+import { tracers, ATTR, observe, toolSpanName, withSpan, } from "../../telemetry/index.js";
 import { SpanStatusCode } from "@opentelemetry/api";
 import { logger } from "../../utils/logger.js";
 import { TOOL_EVENTS_WRAPPED } from "../../types/index.js";
@@ -504,7 +504,6 @@ export class ToolsManager {
             return execute;
         }
         const wrapped = async (params, execOptions) => {
-            const startTime = Date.now();
             // The loop's execute options carry the model's tool_call id, which is
             // what lets a listener pair concurrent same-name start/end events.
             const toolCallId = execOptions && typeof execOptions === "object"
@@ -513,33 +512,47 @@ export class ToolsManager {
             const idField = typeof toolCallId === "string" && toolCallId.length > 0
                 ? { toolCallId }
                 : {};
-            this.emitToolEvent("tool:start", toolName, {
-                input: params,
-                ...idField,
-            });
-            let result;
-            try {
-                result = await execute(params, execOptions);
-            }
-            catch (error) {
-                const errorMsg = error instanceof Error ? error.message : String(error);
+            return withSpan({
+                name: toolSpanName(toolName),
+                tracer: tracers.mcp,
+                attributes: { "tool.name": toolName, ...idField },
+            }, async (span) => {
+                observe(span, "tool", { input: params });
+                const startTime = Date.now();
+                this.emitToolEvent("tool:start", toolName, {
+                    input: params,
+                    ...idField,
+                });
+                let result;
+                try {
+                    result = await execute(params, execOptions);
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    this.emitToolEvent("tool:end", toolName, {
+                        error: errorMsg,
+                        success: false,
+                        responseTime: Date.now() - startTime,
+                        ...idField,
+                    });
+                    throw error;
+                }
+                const isErrorText = extractIsErrorText(result);
+                observe(span, "tool", {
+                    output: result,
+                    ...(isErrorText !== undefined
+                        ? { level: "ERROR", statusMessage: isErrorText }
+                        : {}),
+                });
                 this.emitToolEvent("tool:end", toolName, {
-                    error: errorMsg,
-                    success: false,
+                    result,
+                    success: isErrorText === undefined,
+                    ...(isErrorText !== undefined ? { error: isErrorText } : {}),
                     responseTime: Date.now() - startTime,
                     ...idField,
                 });
-                throw error;
-            }
-            const isErrorText = extractIsErrorText(result);
-            this.emitToolEvent("tool:end", toolName, {
-                result,
-                success: isErrorText === undefined,
-                ...(isErrorText !== undefined ? { error: isErrorText } : {}),
-                responseTime: Date.now() - startTime,
-                ...idField,
+                return result;
             });
-            return result;
         };
         this.eventWrappedExecutes.add(wrapped);
         return wrapped;
@@ -592,7 +605,7 @@ export class ToolsManager {
      * @param functionTag - Function name for logging
      */
     setupToolExecutor(sdk, functionTag) {
-        const span = tracers.sdk.startSpan("neurolink.tools.register", {
+        const span = tracers.sdk.startSpan("tools.register", {
             attributes: {
                 [ATTR.NL_PROVIDER]: this.providerName,
                 "tools.custom_count": sdk.customTools.size,
@@ -632,7 +645,7 @@ export class ToolsManager {
      */
     async getAllTools() {
         return withSpan({
-            name: "neurolink.tools.getAll",
+            name: "tools.getAll",
             tracer: tracers.sdk,
             attributes: {
                 [ATTR.NL_PROVIDER]: this.providerName,
@@ -843,14 +856,10 @@ export class ToolsManager {
                 description: toolInfo.description || `Tool ${toolName}`,
                 inputSchema: finalSchema, // AI SDK v6 uses inputSchema (not parameters)
                 execute: async (params) => {
-                    const customToolSpan = tracers.sdk.startSpan("neurolink.tools.execute_custom", {
+                    const customToolSpan = tracers.sdk.startSpan("tools.execute_custom", {
                         attributes: {
                             "tool.name": toolName,
                             "tool.type": "custom",
-                            // Curator P1-3: pure wrapper — duplicates the AI SDK's
-                            // ai.toolCall observation in Langfuse. Keep the OTel span
-                            // for internal metrics; filter from Langfuse export.
-                            "langfuse.internal": true,
                         },
                     });
                     const startTime = Date.now();

package/dist/core/nativeGenerateLoop.js

@@ -13,6 +13,8 @@
  * share this: the v3 result shape (`content` parts, `finishReason`, `usage`) is
  * the same across Anthropic, the OpenAI-compatible family and SageMaker.
  */
+import { observeGeneration } from "../telemetry/observation.js";
+import { StepSpans, withGeneration } from "../telemetry/withSpan.js";
 import { logger } from "../utils/logger.js";
 import { guardToolExecutor } from "./toolExecutionGuards.js";
 const DEFAULT_TOOL_CHOICE_STEPS = 1;
@@ -384,7 +386,76 @@ export const appendJsonSchemaInstruction = (conversation, schema) => {
         : instruction;
     return conversation.map((message, index) => index === lastSystemIndex ? { ...message, content } : message);
 };
+function describeV3Response(res) {
+    const parts = asParts(res.content);
+    const usage = res.usage;
+    const finish = res.finishReason;
+    const response = res.response;
+    const toolCalls = parts
+        .filter((p) => p.type === "tool-call")
+        .map((p) => ({
+        id: p.toolCallId,
+        name: p.toolName,
+        args: p.input,
+    }));
+    const reasoning = parts
+        .filter((p) => p.type === "reasoning" && typeof p.text === "string")
+        .map((p) => p.text)
+        .join("");
+    return {
+        responseModel: typeof response?.modelId === "string" ? response.modelId : undefined,
+        output: {
+            text: parts
+                .filter((p) => p.type === "text" && typeof p.text === "string")
+                .map((p) => p.text)
+                .join(""),
+            ...(reasoning ? { reasoning } : {}),
+            ...(toolCalls.length > 0 ? { toolCalls } : {}),
+        },
+        usage: usage
+            ? {
+                inputTokens: usage.inputTokens?.noCache ?? usage.inputTokens?.total,
+                outputTokens: usage.outputTokens?.total,
+                cacheReadTokens: usage.inputTokens?.cacheRead,
+                cacheCreationTokens: usage.inputTokens?.cacheWrite,
+                reasoningTokens: usage.outputTokens?.reasoning,
+            }
+            : undefined,
+        finishReason: typeof finish === "string"
+            ? finish
+            : finish?.unified,
+    };
+}
+function generateObservedStep(args, request) {
+    return withGeneration({
+        provider: args.provider,
+        model: args.modelId,
+        modelParameters: {
+            temperature: args.temperature,
+            maxTokens: args.maxOutputTokens,
+        },
+        input: { messages: args.conversation },
+    }, async (span) => {
+        const res = await args.runStep(() => args.doGenerate(request));
+        observeGeneration(span, {
+            provider: args.provider,
+            model: args.modelId,
+            ...describeV3Response(res),
+            aborted: args.abortSignal?.aborted,
+        });
+        return res;
+    });
+}
 export async function runNativeGenerateLoop(args, toolExecutionSummaries) {
+    const stepSpans = new StepSpans();
+    try {
+        return await runGenerateSteps(args, toolExecutionSummaries, stepSpans);
+    }
+    finally {
+        stepSpans.end();
+    }
+}
+async function runGenerateSteps(args, toolExecutionSummaries, stepSpans) {
     const toolsUsed = [];
     let text = "";
     let reasoning = "";
@@ -411,6 +482,7 @@ export async function runNativeGenerateLoop(args, toolExecutionSummaries) {
     const stepRecords = [];
     for (let step = 0; step < args.maxSteps; step++) {
         steps = step + 1;
+        stepSpans.begin(steps);
         // The forced-choice window and the caller's hook are resolved BEFORE the
         // re-ask override below: the re-ask has to win, since its whole point is
         // a request with tools disabled.
@@ -445,7 +517,7 @@ export async function runNativeGenerateLoop(args, toolExecutionSummaries) {
         if (guarded) {
             args.conversation.splice(0, args.conversation.length, ...guarded);
         }
-        const runThisStep = () => args.runStep(() => args.doGenerate({
+        const runThisStep = () => generateObservedStep(args, {
             prompt: args.conversation,
             ...(args.tools && args.tools.length > 0 ? { tools: args.tools } : {}),
             // The v3 call option is an OBJECT — `{ type: "none" }`. Passing the
@@ -459,9 +531,7 @@ export async function runNativeGenerateLoop(args, toolExecutionSummaries) {
                 : wireToolChoice !== undefined
                     ? { toolChoice: wireToolChoice }
                     : {}),
-            ...(args.responseFormat
-                ? { responseFormat: args.responseFormat }
-                : {}),
+            ...(args.responseFormat ? { responseFormat: args.responseFormat } : {}),
             ...(args.providerOptions
                 ? { providerOptions: args.providerOptions }
                 : {}),
@@ -472,10 +542,10 @@ export async function runNativeGenerateLoop(args, toolExecutionSummaries) {
                 ? { temperature: args.temperature }
                 : {}),
             ...(args.abortSignal ? { abortSignal: args.abortSignal } : {}),
-        }));
+        });
         let res;
         try {
-            res = await runThisStep();
+            res = await stepSpans.run(runThisStep);
         }
         catch (stepError) {
             // Ported from GenerationHandler.recoverEmptyToolCallsFinish's catch: a
@@ -650,11 +720,11 @@ export async function runNativeGenerateLoop(args, toolExecutionSummaries) {
                             ? { toolTimeoutMs: args.toolTimeoutMs }
                             : {}),
                     });
-                    output = await guarded(input, {
+                    output = await stepSpans.run(() => guarded(input, {
                         toolCallId: id,
                         messages: [],
                         ...(args.abortSignal ? { abortSignal: args.abortSignal } : {}),
-                    });
+                    }));
                     toolsUsed.push(name);
                 }
                 catch (err) {

package/dist/core/redisConversationMemoryManager.js

@@ -2,7 +2,7 @@
  * Redis Conversation Memory Manager for NeuroLink
  * Redis-based implementation of conversation storage with same interface as ConversationMemoryManager
  */
-import { SpanKind, SpanStatusCode } from "@opentelemetry/api";
+import { context, SpanKind, SpanStatusCode } from "@opentelemetry/api";
 import { tracers } from "../telemetry/tracers.js";
 import { randomUUID } from "crypto";
 import { MESSAGES_PER_TURN } from "../config/conversationMemory.js";
@@ -13,7 +13,6 @@ import { NeuroLink } from "../neurolink.js";
 import { ConversationMemoryError } from "../types/index.js";
 import { withTimeout } from "../utils/errorHandling.js";
 import { buildContextFromPointer, getEffectiveTokenThreshold, } from "../utils/conversationMemory.js";
-import { runWithCurrentLangfuseContext } from "../services/server/ai/observability/instrumentation.js";
 import { logger } from "../utils/logger.js";
 import { assistantTurnIdentity, isTurnAlreadyStored, turnMessageFields, userTurnIdentity, } from "../utils/conversationTurnIdentity.js";
 import { extractIsErrorText } from "../utils/toolResultStatus.js";
@@ -57,7 +56,7 @@ export class RedisConversationMemoryManager {
             logger.debug("[RedisConversationMemoryManager] Already initialized, skipping");
             return;
         }
-        await redisTracer.startActiveSpan("neurolink.memory.initialize", {
+        await redisTracer.startActiveSpan("memory.initialize", {
             kind: SpanKind.CLIENT,
             attributes: {
                 "redis.host": this.redisConfig.host,
@@ -135,7 +134,7 @@ export class RedisConversationMemoryManager {
             return undefined;
         }
         const redisClient = this.redisClient;
-        return redisTracer.startActiveSpan("neurolink.memory.getSession", { kind: SpanKind.CLIENT, attributes: { "session.id": sessionId } }, async (span) => {
+        return redisTracer.startActiveSpan("memory.getSession", { kind: SpanKind.CLIENT, attributes: { "session.id": sessionId } }, async (span) => {
             if (userId) {
                 span.setAttribute("user.id", userId);
             }
@@ -380,7 +379,7 @@ export class RedisConversationMemoryManager {
         });
         await this.ensureInitialized();
         // NLK-GAP-012: Add span for storeTurn CRUD operation
-        return redisTracer.startActiveSpan("neurolink.memory.storeTurn", {
+        return redisTracer.startActiveSpan("memory.storeTurn", {
             kind: SpanKind.CLIENT,
             attributes: {
                 "session.id": options.sessionId,
@@ -407,10 +406,7 @@ export class RedisConversationMemoryManager {
                 const normalizedUserId = options.userId || "randomUser";
                 if (!conversation) {
                     const titleGenerationKey = `${options.sessionId}:${normalizedUserId}`;
-                    // Capture the current Langfuse ALS context before setImmediate,
-                    // which breaks automatic AsyncLocalStorage propagation and would
-                    // otherwise cause orphaned traces in Langfuse.
-                    const generateTitleWithContext = runWithCurrentLangfuseContext(async () => {
+                    const generateTitleWithContext = context.bind(context.active(), async () => {
                         if (this.titleGenerationInProgress.has(titleGenerationKey)) {
                             return;
                         }
@@ -509,10 +505,7 @@ export class RedisConversationMemoryManager {
                     const summarizationKey = `${options.sessionId}:${normalizedUserId}`;
                     // Only trigger summarization if not already in progress for this session
                     if (!this.summarizationInProgress.has(summarizationKey)) {
-                        // Capture the current Langfuse ALS context before setImmediate,
-                        // which breaks automatic AsyncLocalStorage propagation and would
-                        // otherwise cause orphaned traces in Langfuse.
-                        const summarizeWithContext = runWithCurrentLangfuseContext(async () => {
+                        const summarizeWithContext = context.bind(context.active(), async () => {
                             try {
                                 await this.checkAndSummarize(conversation, tokenThreshold, options.sessionId, options.userId, options.requestId);
                             }
@@ -761,7 +754,7 @@ export class RedisConversationMemoryManager {
         }
         const redisClient = this.redisClient;
         // NLK-GAP-012: Add span for buildContext CRUD operation
-        return redisTracer.startActiveSpan("neurolink.memory.buildContext", {
+        return redisTracer.startActiveSpan("memory.buildContext", {
             kind: SpanKind.CLIENT,
             attributes: {
                 "session.id": sessionId,
@@ -1238,7 +1231,7 @@ User message: "${userMessage}"`;
         }
         const redisClient = this.redisClient;
         // NLK-GAP-012: Add span for clearSession CRUD operation
-        return redisTracer.startActiveSpan("neurolink.memory.clear", {
+        return redisTracer.startActiveSpan("memory.clear", {
             kind: SpanKind.CLIENT,
             attributes: {
                 "session.id": sessionId,

package/dist/core/toolExecutionGuards.js

@@ -29,19 +29,7 @@ import { raceWithAbort, withTimeout } from "../utils/async/index.js";
  */
 export function guardToolExecutor(name, execute, guards) {
     return async (args, opts) => {
-        const invoke = () => Promise.resolve(execute(args, opts));
-        // The span wraps the CALL, not the guard: a timeout or an abort is a fact
-        // about this tool invocation and belongs inside its observation.
-        const wrapInSpan = guards.withToolSpan;
-        const toolCallId = typeof opts === "object" &&
-            opts !== null &&
-            "toolCallId" in opts &&
-            typeof opts.toolCallId === "string"
-            ? opts.toolCallId
-            : undefined;
-        const call = wrapInSpan
-            ? () => wrapInSpan(name, invoke, { args, toolCallId })
-            : invoke;
+        const call = () => Promise.resolve(execute(args, opts));
         guards.onProgress?.();
         try {
             const raced = guards.abortSignal

package/dist/index.d.ts

@@ -84,15 +84,16 @@ export { HITLManager } from "./hitl/hitlManager.js";
 export { ProviderRegistry } from "./factories/providerRegistry.js";
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };
-export { buildObservabilityConfigFromEnv } from "./utils/observabilityHelpers.js";
-import { createContextEnricher, flushOpenTelemetry, getLangfuseContext, getLangfuseHealthStatus, getLangfuseSpanProcessor, getSpanProcessors, getTracer, getTracerProvider, initializeOpenTelemetry, isLangfuseInternalSpan, isOpenTelemetryInitialized, isUsingExternalTracerProvider, langfuseShouldExportSpan, runWithCurrentLangfuseContext, setLangfuseContext, shutdownOpenTelemetry } from "./services/server/ai/observability/instrumentation.js";
-export { initializeOpenTelemetry, shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, getLangfuseSpanProcessor, getTracerProvider, isOpenTelemetryInitialized, getSpanProcessors, createContextEnricher, isUsingExternalTracerProvider, isLangfuseInternalSpan, langfuseShouldExportSpan, getLangfuseContext, getTracer, runWithCurrentLangfuseContext, };
+import { flushOpenTelemetry, getLangfuseHealthStatus, isOpenTelemetryInitialized, setLangfuseContext, shutdownOpenTelemetry } from "./services/server/ai/observability/instrumentation.js";
+export { shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, isOpenTelemetryInitialized, };
 export { clearAnalyticsMetrics, createAnalyticsMiddleware, getAnalyticsMetrics, } from "./middleware/builtin/analytics.js";
 export { createLifecycleMiddleware } from "./middleware/builtin/lifecycle.js";
 export { MiddlewareFactory } from "./middleware/factory.js";
 export { tool, jsonSchema, stepCountIs } from "./utils/tool.js";
 export { ExporterRegistry } from "./observability/exporterRegistry.js";
 export { NoOpExporter } from "./observability/exporters/baseExporter.js";
+export { createExporterSpanProcessor, ExporterSpanProcessor, } from "./observability/exporterSpanProcessor.js";
+export { LangfuseExporter } from "./observability/exporters/langfuseExporter.js";
 export { getMetricsAggregator, MetricsAggregator, resetMetricsAggregator, } from "./observability/metricsAggregator.js";
 export { AlwaysSampler, NeverSampler, } from "./observability/sampling/samplers.js";
 export { TokenTracker } from "./observability/tokenTracker.js";
@@ -241,14 +242,6 @@ export { getPoolStats } from "./utils/redis.js";
 export { ToolRoutingCache } from "./core/toolRoutingCache.js";
 export { resolveToolRoutingExclusions, buildToolRoutingCatalog, buildRoutingQueryFromHistory, DEFAULT_ROUTER_PROMPT_PREFIX, } from "./core/toolRouting.js";
 export { cosineSimilarity, ToolEmbeddingIndex, selectRelevantToolNames, } from "./core/toolRoutingEmbedding.js";
-export declare function initializeTelemetry(): Promise<boolean>;
-export declare function getTelemetryStatus(): Promise<{
-    enabled: boolean;
-    initialized: boolean;
-    endpoint?: string;
-    service?: string;
-    version?: string;
-}>;
 /**
  * Evaluation System Exports
  *
@@ -281,7 +274,7 @@ export declare function getTelemetryStatus(): Promise<{
  * });
  * ```
  */
-export { Evaluator, EvaluationAggregator, EvaluatorFactory, getEvaluatorFactory, getEvaluatorRegistry, evaluationErrors, isRetryableEvaluationError, isEvaluationError, createEvaluationFailedError, createParseError, createStrategyNotFoundError, createProviderError, createMaxRetriesExceededError, createBatchEvaluationError, createConfigurationError, contextToErrorContext, createLangfuseAdapter, createMockLangfuseClient, startLangfuseAdapter, createConsoleLoggerHook, createMetricsCollectorHook, ObservabilityHooks, observabilityHooks, pipelineToSpanAttributes, scorerToSpanAttributes, createAndInitializePipeline, createPipeline, EvaluationPipeline, PipelineBuilder, Pipelines, CODE_GENERATION_PIPELINE, COMPREHENSIVE_PIPELINE, CUSTOMER_SUPPORT_PIPELINE, getPreset, getPresetNames, MINIMAL_PIPELINE, QUALITY_PIPELINE, RAG_PIPELINE, SAFETY_PIPELINE, SUMMARIZATION_PIPELINE, BatchStrategy, createBatchStrategy, evaluateBatch, streamBatchEvaluation, createSamplingStrategy, DEFAULT_SAMPLING_CONFIG, SamplingStrategies, SamplingStrategy, createMetricsCollector, globalMetricsCollector, MetricsCollector, createReportGenerator, ReportGenerator, Reports, BaseScorer, DEFAULT_SCORE_SCALE as EVAL_DEFAULT_SCORE_SCALE, composeScorers, createConditionalScorer, createFunctionScorer, createInvertedScorer, createKeywordScorer, createRegexScorer, createScorerMetadata, createSimpleLengthScorer, AnswerRelevancyScorer, createAnswerRelevancyScorer, BaseLLMScorer, DEFAULT_LLM_SCORER_CONFIG, BiasDetectionScorer, createBiasDetectionScorer, ContextPrecisionScorer, createContextPrecisionScorer, ContextRelevancyScorer, createContextRelevancyScorer, createFaithfulnessScorer, FaithfulnessScorer, createHallucinationScorer, HallucinationScorer, createPromptAlignmentScorer, PromptAlignmentScorer, createSummarizationScorer, SummarizationScorer, createToneConsistencyScorer, ToneConsistencyScorer, createToxicityScorer, ToxicityScorer, BaseRuleScorer, DEFAULT_RULE_SCORER_CONFIG, createContentSimilarityScorer, createFormatScorer, FormatScorerPresets, createKeywordCoverageScorer, createLengthScorer, LengthScorerPresets, ScorerBuilder, Scorers, ScorerRegistry, RAGASEvaluator, RetryManager, } from "./evaluation/index.js";
+export { Evaluator, EvaluationAggregator, EvaluatorFactory, getEvaluatorFactory, getEvaluatorRegistry, evaluationErrors, isRetryableEvaluationError, isEvaluationError, createEvaluationFailedError, createParseError, createStrategyNotFoundError, createProviderError, createMaxRetriesExceededError, createBatchEvaluationError, createConfigurationError, contextToErrorContext, createLangfuseAdapter, startLangfuseAdapter, createConsoleLoggerHook, createMetricsCollectorHook, ObservabilityHooks, observabilityHooks, pipelineToSpanAttributes, scorerToSpanAttributes, createAndInitializePipeline, createPipeline, EvaluationPipeline, PipelineBuilder, Pipelines, CODE_GENERATION_PIPELINE, COMPREHENSIVE_PIPELINE, CUSTOMER_SUPPORT_PIPELINE, getPreset, getPresetNames, MINIMAL_PIPELINE, QUALITY_PIPELINE, RAG_PIPELINE, SAFETY_PIPELINE, SUMMARIZATION_PIPELINE, BatchStrategy, createBatchStrategy, evaluateBatch, streamBatchEvaluation, createSamplingStrategy, DEFAULT_SAMPLING_CONFIG, SamplingStrategies, SamplingStrategy, createMetricsCollector, globalMetricsCollector, MetricsCollector, createReportGenerator, ReportGenerator, Reports, BaseScorer, DEFAULT_SCORE_SCALE as EVAL_DEFAULT_SCORE_SCALE, composeScorers, createConditionalScorer, createFunctionScorer, createInvertedScorer, createKeywordScorer, createRegexScorer, createScorerMetadata, createSimpleLengthScorer, AnswerRelevancyScorer, createAnswerRelevancyScorer, BaseLLMScorer, DEFAULT_LLM_SCORER_CONFIG, BiasDetectionScorer, createBiasDetectionScorer, ContextPrecisionScorer, createContextPrecisionScorer, ContextRelevancyScorer, createContextRelevancyScorer, createFaithfulnessScorer, FaithfulnessScorer, createHallucinationScorer, HallucinationScorer, createPromptAlignmentScorer, PromptAlignmentScorer, createSummarizationScorer, SummarizationScorer, createToneConsistencyScorer, ToneConsistencyScorer, createToxicityScorer, ToxicityScorer, BaseRuleScorer, DEFAULT_RULE_SCORER_CONFIG, createContentSimilarityScorer, createFormatScorer, FormatScorerPresets, createKeywordCoverageScorer, createLengthScorer, LengthScorerPresets, ScorerBuilder, Scorers, ScorerRegistry, RAGASEvaluator, RetryManager, } from "./evaluation/index.js";
 /**
  * Legacy generateText function for backward compatibility.
  *

package/dist/index.js

@@ -172,23 +172,8 @@ export { ProviderRegistry } from "./factories/providerRegistry.js";
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };
 // Observability configuration types
-export { buildObservabilityConfigFromEnv } from "./utils/observabilityHelpers.js";
-import { createContextEnricher, flushOpenTelemetry, 
-// Enhanced context and tracing
-getLangfuseContext, getLangfuseHealthStatus, getLangfuseSpanProcessor, 
-// NEW EXPORTS - External TracerProvider Support
-getSpanProcessors, getTracer, getTracerProvider, initializeOpenTelemetry, isLangfuseInternalSpan, isOpenTelemetryInitialized, isUsingExternalTracerProvider, langfuseShouldExportSpan, runWithCurrentLangfuseContext, setLangfuseContext, shutdownOpenTelemetry, } from "./services/server/ai/observability/instrumentation.js";
-import { getTelemetryStatus as getStatus, initializeTelemetry as init, } from "./telemetry/index.js";
-export { initializeOpenTelemetry, shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, getLangfuseSpanProcessor, getTracerProvider, isOpenTelemetryInitialized, 
-// NEW EXPORTS - External TracerProvider Support
-getSpanProcessors, createContextEnricher, isUsingExternalTracerProvider, 
-// Host-processor filter helpers — reuse NeuroLink's internal-span filtering
-// when the host app registers its own LangfuseSpanProcessor.
-isLangfuseInternalSpan, langfuseShouldExportSpan, 
-// Enhanced context and tracing
-getLangfuseContext, getTracer, 
-// ALS context propagation helper
-runWithCurrentLangfuseContext, };
+import { flushOpenTelemetry, getLangfuseHealthStatus, isOpenTelemetryInitialized, setLangfuseContext, shutdownOpenTelemetry, } from "./services/server/ai/observability/instrumentation.js";
+export { shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, isOpenTelemetryInitialized, };
 // Analytics Middleware exports
 export { clearAnalyticsMetrics, createAnalyticsMiddleware, getAnalyticsMetrics, } from "./middleware/builtin/analytics.js";
 export { createLifecycleMiddleware } from "./middleware/builtin/lifecycle.js";
@@ -199,6 +184,8 @@ export { MiddlewareFactory } from "./middleware/factory.js";
 export { tool, jsonSchema, stepCountIs } from "./utils/tool.js";
 export { ExporterRegistry } from "./observability/exporterRegistry.js";
 export { NoOpExporter } from "./observability/exporters/baseExporter.js";
+export { createExporterSpanProcessor, ExporterSpanProcessor, } from "./observability/exporterSpanProcessor.js";
+export { LangfuseExporter } from "./observability/exporters/langfuseExporter.js";
 // Observability modules and types
 export { getMetricsAggregator, MetricsAggregator, resetMetricsAggregator, } from "./observability/metricsAggregator.js";
 export { AlwaysSampler, NeverSampler, } from "./observability/sampling/samplers.js";
@@ -418,25 +405,6 @@ export { resolveToolRoutingExclusions, buildToolRoutingCatalog, buildRoutingQuer
 // Pre-call tool routing — embedding fast-path (ITEM B: L2 semantic retrieval)
 export { cosineSimilarity, ToolEmbeddingIndex, selectRelevantToolNames, } from "./core/toolRoutingEmbedding.js";
 // ============================================================================
-// REAL-TIME SERVICES & TELEMETRY - Enterprise Platform Features
-// ============================================================================
-// Real-time Services (Phase 1) - Basic SSE functionality only
-// export { createEnhancedChatService } from './chat/index.js';
-// export type * from './services/types.js';
-// Optional Telemetry (Phase 2) - Telemetry service initialization
-export async function initializeTelemetry() {
-    try {
-        const result = await init();
-        return !!result;
-    }
-    catch {
-        return false;
-    }
-}
-export async function getTelemetryStatus() {
-    return getStatus();
-}
-// ============================================================================
 // EVALUATION SYSTEM - Comprehensive Response Evaluation & Scoring
 // ============================================================================
 /**
@@ -479,7 +447,7 @@ EvaluationAggregator, EvaluatorFactory, getEvaluatorFactory, getEvaluatorRegistr
 // Error utilities
 evaluationErrors, isRetryableEvaluationError, isEvaluationError, createEvaluationFailedError, createParseError, createStrategyNotFoundError, createProviderError, createMaxRetriesExceededError, createBatchEvaluationError, createConfigurationError, contextToErrorContext, 
 // Hooks
-createLangfuseAdapter, createMockLangfuseClient, startLangfuseAdapter, createConsoleLoggerHook, createMetricsCollectorHook, ObservabilityHooks, observabilityHooks, pipelineToSpanAttributes, scorerToSpanAttributes, 
+createLangfuseAdapter, startLangfuseAdapter, createConsoleLoggerHook, createMetricsCollectorHook, ObservabilityHooks, observabilityHooks, pipelineToSpanAttributes, scorerToSpanAttributes, 
 // Pipeline
 createAndInitializePipeline, createPipeline, EvaluationPipeline, PipelineBuilder, Pipelines, CODE_GENERATION_PIPELINE, COMPREHENSIVE_PIPELINE, CUSTOMER_SUPPORT_PIPELINE, getPreset, getPresetNames, MINIMAL_PIPELINE, QUALITY_PIPELINE, RAG_PIPELINE, SAFETY_PIPELINE, SUMMARIZATION_PIPELINE, 
 // Strategies

package/dist/mcp/batching/requestBatcher.js

@@ -220,7 +220,7 @@ export class RequestBatcher extends EventEmitter {
         this.activeBatches++;
         this.emit("batchStarted", { batchId, size: batchRequests.length });
         await withSpan({
-            name: "neurolink.mcp.batch.execute",
+            name: "mcp.batch.execute",
             tracer: tracers.mcp,
             attributes: {
                 "mcp.batch.id": batchId,