@juspay/neurolink 9.28.0 → 9.29.0

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/providers/amazonBedrock.js

@@ -88,7 +88,7 @@ export class AmazonBedrockProvider extends BaseProvider {
         return "bedrock";
     }
     getDefaultModel() {
-        return (process.env.BEDROCK_MODEL || "anthropic.claude-3-sonnet-20240229-v1:0");
+        return process.env.BEDROCK_MODEL || "anthropic.claude-sonnet-4-6";
     }
     /**
      * Get the default embedding model for Amazon Bedrock

package/dist/lib/providers/anthropic.js

@@ -213,7 +213,7 @@ const getAnthropicApiKey = () => {
     return validateApiKey(createAnthropicConfig());
 };
 const getDefaultAnthropicModel = () => {
-    return getProviderModel("ANTHROPIC_MODEL", AnthropicModels.CLAUDE_3_5_SONNET);
+    return getProviderModel("ANTHROPIC_MODEL", AnthropicModels.CLAUDE_SONNET_4_6);
 };
 const streamTracer = trace.getTracer("neurolink.provider.anthropic");
 /**

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/providers/amazonBedrock.js

@@ -88,7 +88,7 @@ export class AmazonBedrockProvider extends BaseProvider {
         return "bedrock";
     }
     getDefaultModel() {
-        return (process.env.BEDROCK_MODEL || "anthropic.claude-3-sonnet-20240229-v1:0");
+        return process.env.BEDROCK_MODEL || "anthropic.claude-sonnet-4-6";
     }
     /**
      * Get the default embedding model for Amazon Bedrock

package/dist/providers/anthropic.js

@@ -213,7 +213,7 @@ const getAnthropicApiKey = () => {
     return validateApiKey(createAnthropicConfig());
 };
 const getDefaultAnthropicModel = () => {
-    return getProviderModel("ANTHROPIC_MODEL", AnthropicModels.CLAUDE_3_5_SONNET);
+    return getProviderModel("ANTHROPIC_MODEL", AnthropicModels.CLAUDE_SONNET_4_6);
 };
 const streamTracer = trace.getTracer("neurolink.provider.anthropic");
 /**

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.0",
+  "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": [