@juspay/neurolink 13.4.10 → 13.5.1

package/dist/voice/livekit/realtimeVoiceAgent.js

@@ -23,7 +23,7 @@ import { createRealtimeLlm, requireXaiApiKey } from "./realtimeModel.js";
 import { readCallContextFromRoom } from "./roomContext.js";
 import { attachRealtimeEventBridge } from "./realtimeEventBridge.js";
 import { buildRealtimeMcpTools } from "./realtimeMcpTools.js";
-import { setUpRealtimeCallMemory } from "./realtimeMemory.js";
+import { setUpRealtimeCallMemory, setUpRealtimeCallTracing, } from "./realtimeMemory.js";
 const realtimeLogEventSchema = z.object({
     level: z.enum(["debug", "info", "warn", "error"]),
     message: z.string(),
@@ -219,6 +219,18 @@ export function defineRealtimeVoiceAgent(config = {}) {
             model: cfg.model,
             backend: cfg.backend,
         });
+        // Tracing does not depend on memory: a call without it is still traced.
+        const recorder = memory?.recorder ??
+            setUpRealtimeCallTracing(ctx, {
+                model: cfg.model,
+                backend: cfg.backend,
+                ...(memoryConfig?.settleMs !== undefined
+                    ? { settleMs: memoryConfig.settleMs }
+                    : {}),
+                ...(memoryConfig?.flushBudgetMs !== undefined
+                    ? { flushBudgetMs: memoryConfig.flushBudgetMs }
+                    : {}),
+            });
         await installRealtimeJobLifecycle(ctx, cfg);
         const { voice } = await import("@livekit/agents");
         const realtimeLlm = await createRealtimeLlm(cfg);
@@ -249,10 +261,10 @@ export function defineRealtimeVoiceAgent(config = {}) {
                         xContext,
                         publishEvent: bridge.publishEvent,
                         requestConfirmation: bridge.requestConfirmation,
-                        ...(memory
+                        ...(recorder
                             ? {
-                                onToolStart: (call) => memory.recorder.toolStart(call),
-                                onToolEnd: (call) => memory.recorder.toolEnd(call),
+                                onToolStart: (call) => recorder.toolStart(call),
+                                onToolEnd: (call) => recorder.toolEnd(call),
                             }
                             : {}),
                     });
@@ -319,7 +331,7 @@ export function defineRealtimeVoiceAgent(config = {}) {
                                 });
                             }
                             bridge.publishEvent("text", { delta: chunk });
-                            memory?.recorder.assistantDelta(chunk);
+                            recorder?.assistantDelta(chunk);
                         }
                     }
                 }
@@ -358,7 +370,7 @@ export function defineRealtimeVoiceAgent(config = {}) {
                 text: ev.transcript,
                 final: ev.isFinal,
             });
-            memory?.recorder.userTranscript({
+            recorder?.userTranscript({
                 text: ev.transcript,
                 final: ev.isFinal,
             });
@@ -379,7 +391,7 @@ export function defineRealtimeVoiceAgent(config = {}) {
                 // The id the stored messages carry, so a client can merge its live
                 // copy of the turn with history instead of showing it twice.
                 bridge.publishEvent("done", memory ? { turnId: ev.item.id } : {});
-                memory?.recorder.assistantMessage({
+                recorder?.assistantMessage({
                     id: ev.item.id,
                     text: ev.item.textContent,
                     interrupted: ev.item.interrupted,
@@ -398,7 +410,7 @@ export function defineRealtimeVoiceAgent(config = {}) {
         bridge.publishEvent("status", { state: "listening" });
         if (cfg.greeting.trim().length > 0) {
             logger.info("realtime.session.greeting", { ms: sinceConnect() });
-            memory?.recorder.expectGreeting();
+            recorder?.expectGreeting();
             session.generateReply({ instructions: cfg.greeting });
         }
     }

package/dist/voice/livekit/turnRecorder.js

@@ -102,6 +102,18 @@ async function writeWithRetry(record, context) {
         /* a failure sink must never break the call */
     }
 }
+/** The stored form of a closed exchange. */
+function turnRecord(exchange) {
+    return {
+        turnId: exchange.turnId,
+        userMessage: exchange.user,
+        aiResponse: exchange.assistant,
+        interrupted: exchange.interrupted,
+        callEnded: exchange.callEnded,
+        startTime: new Date(exchange.startedAt),
+        ...(exchange.events.length > 0 ? { events: exchange.events } : {}),
+    };
+}
 /** Create a recorder for one call. */
 export function createVoiceTurnRecorder(options) {
     const settleMs = options.settleMs ?? DEFAULT_SETTLE_MS;
@@ -165,15 +177,14 @@ export function createVoiceTurnRecorder(options) {
         });
     }
     function finishExchange(exchange) {
-        enqueue({
-            turnId: exchange.turnId,
-            userMessage: exchange.user,
-            aiResponse: exchange.assistant,
-            interrupted: exchange.interrupted,
-            callEnded: exchange.callEnded,
-            startTime: new Date(exchange.startedAt),
-            ...(exchange.events.length > 0 ? { events: exchange.events } : {}),
-        });
+        const record = turnRecord(exchange);
+        try {
+            options.onClosed?.(record);
+        }
+        catch {
+            /* an observer of closed exchanges must never break the call */
+        }
+        enqueue(record);
     }
     function syntheticTurnId() {
         syntheticTurns += 1;
@@ -297,6 +308,7 @@ export function createVoiceTurnRecorder(options) {
             open.events.push(nextEvent("tool:start", {
                 tool: call.name,
                 toolName: call.name,
+                ...(call.callId !== undefined ? { callId: call.callId } : {}),
                 ...(call.args !== undefined
                     ? { args: boundedPayload(call.args) }
                     : {}),
@@ -309,6 +321,7 @@ export function createVoiceTurnRecorder(options) {
             open.events.push(nextEvent("tool:end", {
                 tool: call.name,
                 toolName: call.name,
+                ...(call.callId !== undefined ? { callId: call.callId } : {}),
                 success: call.error === undefined,
                 ...(call.error !== undefined
                     ? { error: boundedText(call.error) }

package/dist/workflow/core/ensembleExecutor.js

@@ -23,6 +23,7 @@ export async function executeEnsemble(options) {
     return withSpan({
         name: "neurolink.workflow.ensemble.execute",
         tracer: tracers.workflow,
+        observationType: "span",
         attributes: {
             "workflow.model_count": options.models.length,
             "workflow.parallelism": options.executionConfig?.parallelism ?? 10,
@@ -318,6 +319,7 @@ export async function executeModelGroups(groups, prompt, _executionConfig, syste
     return withSpan({
         name: "neurolink.workflow.layers.execute",
         tracer: tracers.workflow,
+        observationType: "span",
         attributes: {
             "workflow.group_count": groups.length,
             "workflow.total_models": groups.reduce((n, g) => n + g.models.length, 0),

package/dist/workflow/core/judgeScorer.js

@@ -23,6 +23,7 @@ export async function scoreEnsemble(options) {
     return withSpan({
         name: "neurolink.workflow.judge.score",
         tracer: tracers.workflow,
+        observationType: "span",
         attributes: {
             "workflow.judges_count": options.judges.length,
             "workflow.responses_count": options.responses.length,

package/dist/workflow/core/responseConditioner.js

@@ -23,6 +23,7 @@ export async function conditionResponse(options) {
     return withSpan({
         name: "neurolink.workflow.response.condition",
         tracer: tracers.workflow,
+        observationType: "span",
         attributes: {
             "workflow.conditioning.enabled": Boolean(options.config?.useConfidence),
             "workflow.conditioning.has_synthesis_model": Boolean(options.config?.synthesisModel),

package/dist/workflow/core/workflowRunner.js

@@ -14,6 +14,7 @@
 import { SpanStatusCode } from "@opentelemetry/api";
 import { logger } from "../../utils/logger.js";
 import { SpanSerializer, SpanType, SpanStatus, getMetricsAggregator, } from "../../observability/index.js";
+import { observe } from "../../telemetry/observation.js";
 import { withSpan } from "../../telemetry/withSpan.js";
 import { tracers } from "../../telemetry/tracers.js";
 import { getModelGroups, PLACEHOLDER_MODEL, PLACEHOLDER_PROVIDER, usesModelGroups, } from "../config.js";
@@ -51,6 +52,7 @@ export async function runWorkflow(config, options) {
     return withSpan({
         name: "neurolink.workflow.run",
         tracer: tracers.sdk,
+        observationType: "span",
         attributes: {
             "workflow.name": config.name,
             "workflow.type": config.type,
@@ -486,7 +488,10 @@ export async function* runWorkflowWithStreaming(config, options) {
             "workflow.type": config.type,
             "workflow.id": config.id ?? "unknown",
         },
-    }, (otelSpan) => runWorkflowStreamingInner(config, options, otelSpan));
+    }, (otelSpan) => {
+        observe(otelSpan, "span", {});
+        return runWorkflowStreamingInner(config, options, otelSpan);
+    });
     yield* generator;
 }
 async function* runWorkflowStreamingInner(config, options, otelSpan) {

package/dist/workflow/index.d.ts

@@ -1,3 +1,4 @@
+import "../services/server/ai/observability/instrumentation.js";
 export { createWorkflowConfig, DEFAULT_EXECUTION_CONFIG, DEFAULT_JUDGE_CONFIG, getAllModels, getModelGroups, usesModelGroups, WorkflowConfigSchema, } from "./config.js";
 export { clearRegistry, getRegistryStats, getWorkflow, listWorkflows, registerWorkflow, unregisterWorkflow, } from "./core/workflowRegistry.js";
 export { runWorkflow } from "./core/workflowRunner.js";

package/dist/workflow/index.js

@@ -1,3 +1,7 @@
+// Imported on its own, this entry starts tracing at its first span, as the
+// main entry does. The import sits here rather than in the shared tracers so
+// that the client entry stays free of the OpenTelemetry Node SDK.
+import "../services/server/ai/observability/instrumentation.js";
 // ============================================================================
 // CORE FUNCTIONS
 // ============================================================================