@juspay/neurolink 9.28.1 → 9.29.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [9.29.0](https://github.com/juspay/neurolink/compare/v9.28.1...v9.29.0) (2026-03-19)
+
+### Features
+
+- **(observability):** add OTEL instrumentation, observability exporters, and comprehensive test suite fixes ([095a774](https://github.com/juspay/neurolink/commit/095a7748b08edac4c34467e2a72caff4426a65bd))
+
 ## [9.28.1](https://github.com/juspay/neurolink/compare/v9.28.0...v9.28.1) (2026-03-18)
 
 ### Bug Fixes

package/dist/context/contextCompactor.js

@@ -40,7 +40,7 @@ export class ContextCompactor {
      * Run the multi-stage compaction pipeline until messages fit within budget.
      */
     async compact(messages, targetTokens, memoryConfig, requestId) {
-        const span = SpanSerializer.createSpan(SpanType.CONTEXT_COMPACTION, "context.compact", {
+        let span = SpanSerializer.createSpan(SpanType.CONTEXT_COMPACTION, "context.compact", {
             "context.operation": "compact",
             "context.targetTokens": targetTokens,
         });
@@ -132,7 +132,7 @@ export class ContextCompactor {
                         saved: 0,
                     });
                     // Record failure on the compaction span for trace visibility
-                    SpanSerializer.updateAttributes(span, {
+                    span = SpanSerializer.updateAttributes(span, {
                         "compaction.stage3.error": err.message,
                         "compaction.stage3.errorName": err.name,
                         "compaction.stage3.tokensBefore": stageTokensBefore,

package/dist/core/baseProvider.d.ts

@@ -24,11 +24,15 @@ export declare abstract class BaseProvider implements AIProvider {
     protected sessionId?: string;
     protected userId?: string;
     protected neurolink?: NeuroLink;
-    /** Trace context propagated from NeuroLink SDK for span hierarchy */
-    _traceContext: {
+    /** @internal Trace context propagated from NeuroLink SDK for span hierarchy */
+    protected _traceContext: {
         traceId: string;
         parentSpanId: string;
     } | null;
+    setTraceContext(ctx: {
+        traceId: string;
+        parentSpanId: string;
+    } | null): void;
     private readonly messageBuilder;
     private readonly streamHandler;
     private readonly generationHandler;

package/dist/core/baseProvider.js

@@ -3,7 +3,10 @@ import { generateText } from "ai";
 import { directAgentTools } from "../agent/directTools.js";
 import { IMAGE_GENERATION_MODELS } from "../core/constants.js";
 import { MiddlewareFactory } from "../middleware/factory.js";
+import { SpanStatus, SpanType } from "../observability/types/spanTypes.js";
+import { SpanSerializer } from "../observability/utils/spanSerializer.js";
 import { ATTR, tracers } from "../telemetry/index.js";
+import { calculateCost } from "../utils/pricing.js";
 import { isAbortError } from "../utils/errorHandling.js";
 import { logger } from "../utils/logger.js";
 import { composeAbortSignals, createTimeoutController, TimeoutError, } from "../utils/timeout.js";
@@ -37,8 +40,11 @@ export class BaseProvider {
     sessionId;
     userId;
     neurolink; // Reference to actual NeuroLink instance for MCP tools
-    /** Trace context propagated from NeuroLink SDK for span hierarchy */
+    /** @internal Trace context propagated from NeuroLink SDK for span hierarchy */
     _traceContext = null;
+    setTraceContext(ctx) {
+        this._traceContext = ctx;
+    }
     // Composition modules - Single Responsibility Principle
     messageBuilder;
     streamHandler;
@@ -81,6 +87,14 @@ export class BaseProvider {
      */
     async stream(optionsOrPrompt, analysisSchema) {
         let options = this.normalizeStreamOptions(optionsOrPrompt);
+        // Observability: create metrics span for provider.stream
+        const metricsSpan = SpanSerializer.createSpan(SpanType.MODEL_GENERATION, "provider.stream", {
+            "ai.provider": this.providerName || "unknown",
+            "ai.model": this.modelName || options.model || "unknown",
+            "ai.temperature": options.temperature,
+            "ai.max_tokens": options.maxTokens,
+        }, this._traceContext?.parentSpanId, this._traceContext?.traceId);
+        let metricsSpanRecorded = false;
         // OTEL span for provider-level stream tracing
         const otelStreamSpan = tracers.provider.startSpan("neurolink.provider.stream", {
             kind: SpanKind.CLIENT,
@@ -173,6 +187,11 @@ export class BaseProvider {
             }
         }
         catch (error) {
+            // Observability: record failed stream span
+            metricsSpanRecorded = true;
+            const _endedStreamSpan = SpanSerializer.endSpan(metricsSpan, SpanStatus.ERROR, error instanceof Error ? error.message : String(error));
+            // Note: Do NOT record to getMetricsAggregator() here — neurolink.ts
+            // stream:complete listener handles authoritative metrics to avoid double-counting.
             otelStreamSpan.setStatus({
                 code: SpanStatusCode.ERROR,
                 message: error instanceof Error ? error.message : String(error),
@@ -181,6 +200,12 @@ export class BaseProvider {
             throw error;
         }
         finally {
+            // Observability: record successful stream span (only if not already ended via error path)
+            if (!metricsSpanRecorded) {
+                const _endedStreamSpan = SpanSerializer.endSpan(metricsSpan, SpanStatus.OK);
+                // Note: Do NOT record to getMetricsAggregator() here — neurolink.ts
+                // stream:complete listener handles authoritative metrics to avoid double-counting.
+            }
             // End OTEL span on success (only if not already ended via error path)
             if (otelStreamSpan.isRecording()) {
                 otelStreamSpan.setStatus({ code: SpanStatusCode.OK });
@@ -477,6 +502,13 @@ export class BaseProvider {
         const options = this.normalizeTextOptions(optionsOrPrompt);
         this.validateOptions(options);
         const startTime = Date.now();
+        // Observability: create metrics span for provider.generate
+        const metricsSpan = SpanSerializer.createSpan(SpanType.MODEL_GENERATION, "provider.generate", {
+            "ai.provider": this.providerName || "unknown",
+            "ai.model": this.modelName || options.model || "unknown",
+            "ai.temperature": options.temperature,
+            "ai.max_tokens": options.maxTokens,
+        }, this._traceContext?.parentSpanId, this._traceContext?.traceId);
         // OTEL span for provider-level generate tracing
         // Use startActiveSpan pattern via context.with() so child spans become descendants
         const otelSpan = tracers.provider.startSpan("neurolink.provider.generate", {
@@ -665,9 +697,37 @@ export class BaseProvider {
                         });
                     }
                 }
+                // Observability: record successful generate span with token/cost data
+                let enrichedGenerateSpan = { ...metricsSpan };
+                if (enhancedResult?.usage) {
+                    enrichedGenerateSpan = SpanSerializer.enrichWithTokenUsage(enrichedGenerateSpan, {
+                        promptTokens: enhancedResult.usage.input || 0,
+                        completionTokens: enhancedResult.usage.output || 0,
+                        totalTokens: enhancedResult.usage.total || 0,
+                    });
+                    const cost = calculateCost(this.providerName, this.modelName, {
+                        input: enhancedResult.usage.input || 0,
+                        output: enhancedResult.usage.output || 0,
+                        total: enhancedResult.usage.total || 0,
+                    });
+                    if (cost && cost > 0) {
+                        enrichedGenerateSpan = SpanSerializer.enrichWithCost(enrichedGenerateSpan, {
+                            totalCost: cost,
+                        });
+                    }
+                }
+                const _endedGenerateSpan = SpanSerializer.endSpan(enrichedGenerateSpan, SpanStatus.OK);
+                // Note: Do NOT record to getMetricsAggregator() here — the neurolink.ts
+                // generation:end listener creates an authoritative span with richer context
+                // (provider name, model, input/output) and records to both aggregators.
+                // Recording here would double-count cost and token metrics.
                 return await this.enhanceResult(enhancedResult, options, startTime);
             }
             catch (error) {
+                // Observability: record failed generate span
+                const _endedGenerateSpan = SpanSerializer.endSpan(metricsSpan, SpanStatus.ERROR, error instanceof Error ? error.message : String(error));
+                // Note: Do NOT record to getMetricsAggregator() here — neurolink.ts
+                // handles authoritative metrics recording to avoid double-counting.
                 otelSpan.setStatus({
                     code: SpanStatusCode.ERROR,
                     message: error instanceof Error ? error.message : String(error),

package/dist/lib/context/contextCompactor.js

@@ -40,7 +40,7 @@ export class ContextCompactor {
      * Run the multi-stage compaction pipeline until messages fit within budget.
      */
     async compact(messages, targetTokens, memoryConfig, requestId) {
-        const span = SpanSerializer.createSpan(SpanType.CONTEXT_COMPACTION, "context.compact", {
+        let span = SpanSerializer.createSpan(SpanType.CONTEXT_COMPACTION, "context.compact", {
             "context.operation": "compact",
             "context.targetTokens": targetTokens,
         });
@@ -132,7 +132,7 @@ export class ContextCompactor {
                         saved: 0,
                     });
                     // Record failure on the compaction span for trace visibility
-                    SpanSerializer.updateAttributes(span, {
+                    span = SpanSerializer.updateAttributes(span, {
                         "compaction.stage3.error": err.message,
                         "compaction.stage3.errorName": err.name,
                         "compaction.stage3.tokensBefore": stageTokensBefore,

package/dist/lib/core/baseProvider.d.ts

@@ -24,11 +24,15 @@ export declare abstract class BaseProvider implements AIProvider {
     protected sessionId?: string;
     protected userId?: string;
     protected neurolink?: NeuroLink;
-    /** Trace context propagated from NeuroLink SDK for span hierarchy */
-    _traceContext: {
+    /** @internal Trace context propagated from NeuroLink SDK for span hierarchy */
+    protected _traceContext: {
         traceId: string;
         parentSpanId: string;
     } | null;
+    setTraceContext(ctx: {
+        traceId: string;
+        parentSpanId: string;
+    } | null): void;
     private readonly messageBuilder;
     private readonly streamHandler;
     private readonly generationHandler;

package/dist/lib/core/baseProvider.js

@@ -3,7 +3,10 @@ import { generateText } from "ai";
 import { directAgentTools } from "../agent/directTools.js";
 import { IMAGE_GENERATION_MODELS } from "../core/constants.js";
 import { MiddlewareFactory } from "../middleware/factory.js";
+import { SpanStatus, SpanType } from "../observability/types/spanTypes.js";
+import { SpanSerializer } from "../observability/utils/spanSerializer.js";
 import { ATTR, tracers } from "../telemetry/index.js";
+import { calculateCost } from "../utils/pricing.js";
 import { isAbortError } from "../utils/errorHandling.js";
 import { logger } from "../utils/logger.js";
 import { composeAbortSignals, createTimeoutController, TimeoutError, } from "../utils/timeout.js";
@@ -37,8 +40,11 @@ export class BaseProvider {
     sessionId;
     userId;
     neurolink; // Reference to actual NeuroLink instance for MCP tools
-    /** Trace context propagated from NeuroLink SDK for span hierarchy */
+    /** @internal Trace context propagated from NeuroLink SDK for span hierarchy */
     _traceContext = null;
+    setTraceContext(ctx) {
+        this._traceContext = ctx;
+    }
     // Composition modules - Single Responsibility Principle
     messageBuilder;
     streamHandler;
@@ -81,6 +87,14 @@ export class BaseProvider {
      */
     async stream(optionsOrPrompt, analysisSchema) {
         let options = this.normalizeStreamOptions(optionsOrPrompt);
+        // Observability: create metrics span for provider.stream
+        const metricsSpan = SpanSerializer.createSpan(SpanType.MODEL_GENERATION, "provider.stream", {
+            "ai.provider": this.providerName || "unknown",
+            "ai.model": this.modelName || options.model || "unknown",
+            "ai.temperature": options.temperature,
+            "ai.max_tokens": options.maxTokens,
+        }, this._traceContext?.parentSpanId, this._traceContext?.traceId);
+        let metricsSpanRecorded = false;
         // OTEL span for provider-level stream tracing
         const otelStreamSpan = tracers.provider.startSpan("neurolink.provider.stream", {
             kind: SpanKind.CLIENT,
@@ -173,6 +187,11 @@ export class BaseProvider {
             }
         }
         catch (error) {
+            // Observability: record failed stream span
+            metricsSpanRecorded = true;
+            const _endedStreamSpan = SpanSerializer.endSpan(metricsSpan, SpanStatus.ERROR, error instanceof Error ? error.message : String(error));
+            // Note: Do NOT record to getMetricsAggregator() here — neurolink.ts
+            // stream:complete listener handles authoritative metrics to avoid double-counting.
             otelStreamSpan.setStatus({
                 code: SpanStatusCode.ERROR,
                 message: error instanceof Error ? error.message : String(error),
@@ -181,6 +200,12 @@ export class BaseProvider {
             throw error;
         }
         finally {
+            // Observability: record successful stream span (only if not already ended via error path)
+            if (!metricsSpanRecorded) {
+                const _endedStreamSpan = SpanSerializer.endSpan(metricsSpan, SpanStatus.OK);
+                // Note: Do NOT record to getMetricsAggregator() here — neurolink.ts
+                // stream:complete listener handles authoritative metrics to avoid double-counting.
+            }
             // End OTEL span on success (only if not already ended via error path)
             if (otelStreamSpan.isRecording()) {
                 otelStreamSpan.setStatus({ code: SpanStatusCode.OK });
@@ -477,6 +502,13 @@ export class BaseProvider {
         const options = this.normalizeTextOptions(optionsOrPrompt);
         this.validateOptions(options);
         const startTime = Date.now();
+        // Observability: create metrics span for provider.generate
+        const metricsSpan = SpanSerializer.createSpan(SpanType.MODEL_GENERATION, "provider.generate", {
+            "ai.provider": this.providerName || "unknown",
+            "ai.model": this.modelName || options.model || "unknown",
+            "ai.temperature": options.temperature,
+            "ai.max_tokens": options.maxTokens,
+        }, this._traceContext?.parentSpanId, this._traceContext?.traceId);
         // OTEL span for provider-level generate tracing
         // Use startActiveSpan pattern via context.with() so child spans become descendants
         const otelSpan = tracers.provider.startSpan("neurolink.provider.generate", {
@@ -665,9 +697,37 @@ export class BaseProvider {
                         });
                     }
                 }
+                // Observability: record successful generate span with token/cost data
+                let enrichedGenerateSpan = { ...metricsSpan };
+                if (enhancedResult?.usage) {
+                    enrichedGenerateSpan = SpanSerializer.enrichWithTokenUsage(enrichedGenerateSpan, {
+                        promptTokens: enhancedResult.usage.input || 0,
+                        completionTokens: enhancedResult.usage.output || 0,
+                        totalTokens: enhancedResult.usage.total || 0,
+                    });
+                    const cost = calculateCost(this.providerName, this.modelName, {
+                        input: enhancedResult.usage.input || 0,
+                        output: enhancedResult.usage.output || 0,
+                        total: enhancedResult.usage.total || 0,
+                    });
+                    if (cost && cost > 0) {
+                        enrichedGenerateSpan = SpanSerializer.enrichWithCost(enrichedGenerateSpan, {
+                            totalCost: cost,
+                        });
+                    }
+                }
+                const _endedGenerateSpan = SpanSerializer.endSpan(enrichedGenerateSpan, SpanStatus.OK);
+                // Note: Do NOT record to getMetricsAggregator() here — the neurolink.ts
+                // generation:end listener creates an authoritative span with richer context
+                // (provider name, model, input/output) and records to both aggregators.
+                // Recording here would double-count cost and token metrics.
                 return await this.enhanceResult(enhancedResult, options, startTime);
             }
             catch (error) {
+                // Observability: record failed generate span
+                const _endedGenerateSpan = SpanSerializer.endSpan(metricsSpan, SpanStatus.ERROR, error instanceof Error ? error.message : String(error));
+                // Note: Do NOT record to getMetricsAggregator() here — neurolink.ts
+                // handles authoritative metrics recording to avoid double-counting.
                 otelSpan.setStatus({
                     code: SpanStatusCode.ERROR,
                     message: error instanceof Error ? error.message : String(error),

package/dist/lib/memory/hippocampusInitializer.d.ts

@@ -1,5 +1,5 @@
-import { Hippocampus, type HippocampusConfig, type CustomStorageConfig } from "@juspay/hippocampus";
-export type { HippocampusConfig, CustomStorageConfig };
+import { Hippocampus, type HippocampusConfig, type StorageConfig } from "@juspay/hippocampus";
+export type { HippocampusConfig, StorageConfig };
 export type Memory = HippocampusConfig & {
     enabled?: boolean;
 };

package/dist/lib/neurolink.js

@@ -3503,7 +3503,7 @@ Current user's request: ${currentInput}`;
             this, // Pass SDK instance
             options.region);
             // Propagate trace context for parent-child span hierarchy
-            provider._traceContext = this._metricsTraceContext;
+            provider.setTraceContext(this._metricsTraceContext);
             // ADD: Emit connection events for all providers (Bedrock-compatible)
             this.emitter.emit("connected");
             this.emitter.emit("message", `${providerName} provider initialized successfully`);
@@ -3734,7 +3734,7 @@ Current user's request: ${currentInput}`;
                 this, // Pass SDK instance
                 options.region);
                 // Propagate trace context for parent-child span hierarchy
-                provider._traceContext = this._metricsTraceContext;
+                provider.setTraceContext(this._metricsTraceContext);
                 // ADD: Emit connection events for successful provider creation (Bedrock-compatible)
                 this.emitter.emit("connected");
                 this.emitter.emit("message", `${providerName} provider initialized successfully`);
@@ -4660,7 +4660,7 @@ Current user's request: ${currentInput}`;
         this, // Pass SDK instance
         options.region);
         // Propagate trace context for parent-child span hierarchy
-        provider._traceContext = this._metricsTraceContext;
+        provider.setTraceContext(this._metricsTraceContext);
         // Enable tool execution for the provider using BaseProvider method
         provider.setupToolExecutor({
             customTools: this.getCustomTools(),

package/dist/lib/observability/exporters/langfuseExporter.d.ts

@@ -13,6 +13,7 @@ export declare class LangfuseExporter extends BaseExporter {
     private readonly secretKey;
     private readonly baseUrl;
     private readonly release?;
+    private readonly redactIO;
     constructor(config: LangfuseExporterConfig);
     initialize(): Promise<void>;
     exportSpan(span: SpanData): Promise<ExportResult>;

package/dist/lib/observability/exporters/langfuseExporter.js

@@ -14,12 +14,14 @@ export class LangfuseExporter extends BaseExporter {
     secretKey;
     baseUrl;
     release;
+    redactIO;
     constructor(config) {
         super("langfuse", config);
         this.publicKey = config.publicKey;
         this.secretKey = config.secretKey;
         this.baseUrl = config.baseUrl ?? "https://cloud.langfuse.com";
         this.release = config.release;
+        this.redactIO = config.redactIO ?? false;
     }
     async initialize() {
         if (this.initialized) {
@@ -135,6 +137,10 @@ export class LangfuseExporter extends BaseExporter {
             ...langfuseSpan,
             traceId: span.traceId,
         };
+        if (this.redactIO) {
+            delete body["input"];
+            delete body["output"];
+        }
         await this.apiCall("/api/public/spans", body);
     }
     /**
@@ -155,8 +161,8 @@ export class LangfuseExporter extends BaseExporter {
                 maxTokens: span.attributes["ai.max_tokens"],
                 topP: span.attributes["ai.top_p"],
             },
-            input: langfuseSpan.input,
-            output: langfuseSpan.output,
+            input: this.redactIO ? undefined : langfuseSpan.input,
+            output: this.redactIO ? undefined : langfuseSpan.output,
             usage: langfuseSpan.usage,
             metadata: langfuseSpan.metadata,
             level: langfuseSpan.level,

package/dist/lib/observability/exporters/langsmithExporter.js

@@ -3,6 +3,19 @@
  * Exports spans to LangSmith observability platform
  */
 import { logger } from "../../utils/logger.js";
+/**
+ * Build a LangSmith dotted_order value: "{datetime}.{id}"
+ * Format: YYYYMMDDTHHmmssSSSSSSZ.<id> (datetime in UTC with microseconds)
+ */
+function buildDottedOrder(isoTime, id) {
+    const d = new Date(isoTime);
+    const pad2 = (n) => String(n).padStart(2, "0");
+    const microseconds = String(d.getUTCMilliseconds() * 1000).padStart(6, "0");
+    const dt = `${d.getUTCFullYear()}${pad2(d.getUTCMonth() + 1)}${pad2(d.getUTCDate())}T` +
+        `${pad2(d.getUTCHours())}${pad2(d.getUTCMinutes())}${pad2(d.getUTCSeconds())}` +
+        `${microseconds}Z`;
+    return `${dt}.${id}`;
+}
 import { SpanSerializer } from "../utils/spanSerializer.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
@@ -67,17 +80,24 @@ export class LangSmithExporter extends BaseExporter {
     async exportBatch(spans) {
         const startTime = Date.now();
         try {
-            const runs = spans.map((s) => ({
-                ...SpanSerializer.toLangSmithFormat(s),
-                session_name: this.projectName,
-            }));
+            const post = spans.map((s) => {
+                const run = SpanSerializer.toLangSmithFormat(s);
+                // LangSmith /api/v1/runs/batch requires dotted_order and trace_id on each run
+                const dotted_order = buildDottedOrder(run.start_time ?? s.startTime, run.id);
+                return {
+                    ...run,
+                    trace_id: run.trace_id ?? run.id,
+                    dotted_order,
+                    session_name: this.projectName,
+                };
+            });
             const response = await fetch(`${this.endpoint}/api/v1/runs/batch`, {
                 method: "POST",
                 headers: {
                     "Content-Type": "application/json",
                     "x-api-key": this.apiKey,
                 },
-                body: JSON.stringify({ runs }),
+                body: JSON.stringify({ post }),
             });
             if (!response.ok) {
                 throw new Error(`Batch export failed: ${response.statusText}`);

package/dist/lib/observability/otelBridge.js

@@ -30,7 +30,7 @@ export class OtelBridge {
      * Create a NeuroLink span from OpenTelemetry context
      */
     createSpanFromOtelContext(spanContext, type, name) {
-        return SpanSerializer.createSpan(type, name, {}, undefined, spanContext.traceId);
+        return SpanSerializer.createSpan(type, name, {}, spanContext.spanId, spanContext.traceId);
     }
     /**
      * Wrap a function with OpenTelemetry tracing that also creates NeuroLink spans

package/dist/lib/observability/types/exporterTypes.d.ts

@@ -64,6 +64,13 @@ export type LangfuseExporterConfig = ExporterConfig & {
     secretKey: string;
     baseUrl?: string;
     release?: string;
+    /**
+     * When true, `input` and `output` fields are omitted from exported spans and
+     * generations. Enable in compliance-sensitive deployments where prompt/response
+     * content is considered PII or subject to data-minimisation requirements.
+     * Defaults to false (input/output are exported).
+     */
+    redactIO?: boolean;
 };
 /**
  * LangSmith exporter configuration

package/dist/lib/observability/utils/spanSerializer.js

@@ -105,7 +105,9 @@ export class SpanSerializer {
             startTime: span.startTime,
             endTime: span.endTime,
             // Only pick safe, non-PII attributes for metadata — intentionally excludes
-            // input, output, error.stack, and other user content for PII safety
+            // error.stack and other internal fields. input/output are exported here for
+            // Langfuse tracing; use LangfuseExporterConfig.redactIO=true to suppress them
+            // in compliance-sensitive deployments.
             metadata: filterSafeMetadata(span.attributes),
             level: span.status === SpanStatus.ERROR ? "ERROR" : "DEFAULT",
             statusMessage: span.statusMessage,

package/dist/lib/types/conversation.d.ts

@@ -33,8 +33,8 @@
  * - Current time (ISO): `new Date().toISOString()`
  */
 import type { Mem0Config } from "../memory/mem0Initializer.js";
-import type { Memory, CustomStorageConfig } from "../memory/hippocampusInitializer.js";
-export type { Memory, CustomStorageConfig };
+import type { Memory, StorageConfig } from "../memory/hippocampusInitializer.js";
+export type { Memory, StorageConfig };
 /**
  * Configuration for conversation memory feature
  */

package/dist/lib/types/index.d.ts

@@ -38,5 +38,5 @@ export * from "./contextTypes.js";
 export * from "./fileReferenceTypes.js";
 export * from "./ragTypes.js";
 export * from "./conversationMemoryInterface.js";
-export type { CustomStorageConfig } from "./conversation.js";
+export type { StorageConfig } from "./conversation.js";
 export * from "./subscriptionTypes.js";

package/dist/lib/types/providers.d.ts

@@ -335,11 +335,14 @@ export type AIProvider = {
         customTools: Map<string, unknown>;
         executeTool: (toolName: string, params: unknown) => Promise<unknown>;
     }, functionTag: string): void;
-    /** Trace context propagated from NeuroLink SDK for parent-child span hierarchy */
-    _traceContext?: {
+    /**
+     * Propagate trace context from NeuroLink SDK for parent-child span hierarchy.
+     * Use this method instead of accessing `_traceContext` directly.
+     */
+    setTraceContext(ctx: {
         traceId: string;
         parentSpanId: string;
-    } | null;
+    } | null): void;
 };
 /**
  * Provider attempt result for iteration tracking (converted from interface)

package/dist/memory/hippocampusInitializer.d.ts

@@ -1,5 +1,5 @@
-import { Hippocampus, type HippocampusConfig, type CustomStorageConfig } from "@juspay/hippocampus";
-export type { HippocampusConfig, CustomStorageConfig };
+import { Hippocampus, type HippocampusConfig, type StorageConfig } from "@juspay/hippocampus";
+export type { HippocampusConfig, StorageConfig };
 export type Memory = HippocampusConfig & {
     enabled?: boolean;
 };

package/dist/neurolink.js

@@ -3503,7 +3503,7 @@ Current user's request: ${currentInput}`;
             this, // Pass SDK instance
             options.region);
             // Propagate trace context for parent-child span hierarchy
-            provider._traceContext = this._metricsTraceContext;
+            provider.setTraceContext(this._metricsTraceContext);
             // ADD: Emit connection events for all providers (Bedrock-compatible)
             this.emitter.emit("connected");
             this.emitter.emit("message", `${providerName} provider initialized successfully`);
@@ -3734,7 +3734,7 @@ Current user's request: ${currentInput}`;
                 this, // Pass SDK instance
                 options.region);
                 // Propagate trace context for parent-child span hierarchy
-                provider._traceContext = this._metricsTraceContext;
+                provider.setTraceContext(this._metricsTraceContext);
                 // ADD: Emit connection events for successful provider creation (Bedrock-compatible)
                 this.emitter.emit("connected");
                 this.emitter.emit("message", `${providerName} provider initialized successfully`);
@@ -4660,7 +4660,7 @@ Current user's request: ${currentInput}`;
         this, // Pass SDK instance
         options.region);
         // Propagate trace context for parent-child span hierarchy
-        provider._traceContext = this._metricsTraceContext;
+        provider.setTraceContext(this._metricsTraceContext);
         // Enable tool execution for the provider using BaseProvider method
         provider.setupToolExecutor({
             customTools: this.getCustomTools(),

package/dist/observability/exporters/langfuseExporter.d.ts

@@ -13,6 +13,7 @@ export declare class LangfuseExporter extends BaseExporter {
     private readonly secretKey;
     private readonly baseUrl;
     private readonly release?;
+    private readonly redactIO;
     constructor(config: LangfuseExporterConfig);
     initialize(): Promise<void>;
     exportSpan(span: SpanData): Promise<ExportResult>;

package/dist/observability/exporters/langfuseExporter.js

@@ -14,12 +14,14 @@ export class LangfuseExporter extends BaseExporter {
     secretKey;
     baseUrl;
     release;
+    redactIO;
     constructor(config) {
         super("langfuse", config);
         this.publicKey = config.publicKey;
         this.secretKey = config.secretKey;
         this.baseUrl = config.baseUrl ?? "https://cloud.langfuse.com";
         this.release = config.release;
+        this.redactIO = config.redactIO ?? false;
     }
     async initialize() {
         if (this.initialized) {
@@ -135,6 +137,10 @@ export class LangfuseExporter extends BaseExporter {
             ...langfuseSpan,
             traceId: span.traceId,
         };
+        if (this.redactIO) {
+            delete body["input"];
+            delete body["output"];
+        }
         await this.apiCall("/api/public/spans", body);
     }
     /**
@@ -155,8 +161,8 @@ export class LangfuseExporter extends BaseExporter {
                 maxTokens: span.attributes["ai.max_tokens"],
                 topP: span.attributes["ai.top_p"],
             },
-            input: langfuseSpan.input,
-            output: langfuseSpan.output,
+            input: this.redactIO ? undefined : langfuseSpan.input,
+            output: this.redactIO ? undefined : langfuseSpan.output,
             usage: langfuseSpan.usage,
             metadata: langfuseSpan.metadata,
             level: langfuseSpan.level,

package/dist/observability/exporters/langsmithExporter.js

@@ -3,6 +3,19 @@
  * Exports spans to LangSmith observability platform
  */
 import { logger } from "../../utils/logger.js";
+/**
+ * Build a LangSmith dotted_order value: "{datetime}.{id}"
+ * Format: YYYYMMDDTHHmmssSSSSSSZ.<id> (datetime in UTC with microseconds)
+ */
+function buildDottedOrder(isoTime, id) {
+    const d = new Date(isoTime);
+    const pad2 = (n) => String(n).padStart(2, "0");
+    const microseconds = String(d.getUTCMilliseconds() * 1000).padStart(6, "0");
+    const dt = `${d.getUTCFullYear()}${pad2(d.getUTCMonth() + 1)}${pad2(d.getUTCDate())}T` +
+        `${pad2(d.getUTCHours())}${pad2(d.getUTCMinutes())}${pad2(d.getUTCSeconds())}` +
+        `${microseconds}Z`;
+    return `${dt}.${id}`;
+}
 import { SpanSerializer } from "../utils/spanSerializer.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
@@ -67,17 +80,24 @@ export class LangSmithExporter extends BaseExporter {
     async exportBatch(spans) {
         const startTime = Date.now();
         try {
-            const runs = spans.map((s) => ({
-                ...SpanSerializer.toLangSmithFormat(s),
-                session_name: this.projectName,
-            }));
+            const post = spans.map((s) => {
+                const run = SpanSerializer.toLangSmithFormat(s);
+                // LangSmith /api/v1/runs/batch requires dotted_order and trace_id on each run
+                const dotted_order = buildDottedOrder(run.start_time ?? s.startTime, run.id);
+                return {
+                    ...run,
+                    trace_id: run.trace_id ?? run.id,
+                    dotted_order,
+                    session_name: this.projectName,
+                };
+            });
             const response = await fetch(`${this.endpoint}/api/v1/runs/batch`, {
                 method: "POST",
                 headers: {
                     "Content-Type": "application/json",
                     "x-api-key": this.apiKey,
                 },
-                body: JSON.stringify({ runs }),
+                body: JSON.stringify({ post }),
             });
             if (!response.ok) {
                 throw new Error(`Batch export failed: ${response.statusText}`);

package/dist/observability/otelBridge.js

@@ -30,7 +30,7 @@ export class OtelBridge {
      * Create a NeuroLink span from OpenTelemetry context
      */
     createSpanFromOtelContext(spanContext, type, name) {
-        return SpanSerializer.createSpan(type, name, {}, undefined, spanContext.traceId);
+        return SpanSerializer.createSpan(type, name, {}, spanContext.spanId, spanContext.traceId);
     }
     /**
      * Wrap a function with OpenTelemetry tracing that also creates NeuroLink spans

package/dist/observability/types/exporterTypes.d.ts

@@ -64,6 +64,13 @@ export type LangfuseExporterConfig = ExporterConfig & {
     secretKey: string;
     baseUrl?: string;
     release?: string;
+    /**
+     * When true, `input` and `output` fields are omitted from exported spans and
+     * generations. Enable in compliance-sensitive deployments where prompt/response
+     * content is considered PII or subject to data-minimisation requirements.
+     * Defaults to false (input/output are exported).
+     */
+    redactIO?: boolean;
 };
 /**
  * LangSmith exporter configuration

package/dist/observability/utils/spanSerializer.js

@@ -105,7 +105,9 @@ export class SpanSerializer {
             startTime: span.startTime,
             endTime: span.endTime,
             // Only pick safe, non-PII attributes for metadata — intentionally excludes
-            // input, output, error.stack, and other user content for PII safety
+            // error.stack and other internal fields. input/output are exported here for
+            // Langfuse tracing; use LangfuseExporterConfig.redactIO=true to suppress them
+            // in compliance-sensitive deployments.
             metadata: filterSafeMetadata(span.attributes),
             level: span.status === SpanStatus.ERROR ? "ERROR" : "DEFAULT",
             statusMessage: span.statusMessage,

package/dist/types/conversation.d.ts

@@ -33,8 +33,8 @@
  * - Current time (ISO): `new Date().toISOString()`
  */
 import type { Mem0Config } from "../memory/mem0Initializer.js";
-import type { Memory, CustomStorageConfig } from "../memory/hippocampusInitializer.js";
-export type { Memory, CustomStorageConfig };
+import type { Memory, StorageConfig } from "../memory/hippocampusInitializer.js";
+export type { Memory, StorageConfig };
 /**
  * Configuration for conversation memory feature
  */

package/dist/types/index.d.ts

@@ -38,5 +38,5 @@ export * from "./contextTypes.js";
 export * from "./fileReferenceTypes.js";
 export * from "./ragTypes.js";
 export * from "./conversationMemoryInterface.js";
-export type { CustomStorageConfig } from "./conversation.js";
+export type { StorageConfig } from "./conversation.js";
 export * from "./subscriptionTypes.js";

package/dist/types/providers.d.ts

@@ -335,11 +335,14 @@ export type AIProvider = {
         customTools: Map<string, unknown>;
         executeTool: (toolName: string, params: unknown) => Promise<unknown>;
     }, functionTag: string): void;
-    /** Trace context propagated from NeuroLink SDK for parent-child span hierarchy */
-    _traceContext?: {
+    /**
+     * Propagate trace context from NeuroLink SDK for parent-child span hierarchy.
+     * Use this method instead of accessing `_traceContext` directly.
+     */
+    setTraceContext(ctx: {
         traceId: string;
         parentSpanId: string;
-    } | null;
+    } | null): void;
 };
 /**
  * Provider attempt result for iteration tracking (converted from interface)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.28.1",
+  "version": "9.29.0",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 13 providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",
@@ -194,7 +194,7 @@
     "@opentelemetry/core": "^2.1.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.202.0",
     "@opentelemetry/resources": "^2.1.0",
-    "@opentelemetry/sdk-node": "^0.56.0",
+    "@opentelemetry/sdk-node": "^0.202.0",
     "@opentelemetry/semantic-conventions": "^1.30.1",
     "adm-zip": "^0.5.16",
     "ai": "4.3.19",
@@ -371,7 +371,9 @@
       "tmp@<=0.2.3": ">=0.2.4",
       "axios@<1.8.2": ">=1.8.2",
       "glob@>=10.3.7 <=11.0.3": ">=11.1.0",
-      "@semantic-release/npm": "^13.1.2"
+      "@semantic-release/npm": "^13.1.2",
+      "@opentelemetry/sdk-trace-base": "^2.0.1",
+      "@opentelemetry/sdk-trace-node": "^2.0.1"
     }
   },
   "os": [