@juspay/neurolink 12.12.6 → 12.12.8

package/dist/types/middleware.d.ts

@@ -3,7 +3,7 @@ import type { EvaluationData, GetPromptFunction } from "./evaluation.js";
 import type { AuthenticatedUser, RouteDefinition, ServerContext } from "./server.js";
 import type { LanguageModelMiddleware as BaseLanguageModelMiddleware } from "./aiCompat.js";
 export type { LanguageModelMiddleware } from "./aiCompat.js";
-export type { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3Message, LanguageModelV3Prompt, LanguageModelV3StreamPart, LanguageModelV3ToolCall, LanguageModelV3ToolChoice, LanguageModelV3Source, LanguageModelV3Middleware, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, JSONSchema7, } from "./aiCompat.js";
+export type { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3Message, LanguageModelV3Prompt, LanguageModelV3StreamPart, LanguageModelV3Content, LanguageModelV3ToolCall, LanguageModelV3ToolChoice, LanguageModelV3Source, LanguageModelV3Middleware, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, JSONSchema7, } from "./aiCompat.js";
 /**
  * Metadata type for NeuroLink middleware
  * Provides additional information about middleware without affecting execution

package/dist/types/proxy.d.ts

@@ -555,6 +555,14 @@ export type ProxyAccountSortMetrics = {
     scopedSaturated: boolean;
 };
 export type RequestLogEntry = {
+    /** First output text or tool-argument delta, excluding SSE control frames. */
+    firstUsefulOutputMs?: number;
+    /** Small routing evidence retained even when response bodies are pruned. */
+    fallbackPlan?: Array<{
+        provider: string;
+        model: string;
+        reasoningEffort?: string;
+    }>;
     timestamp: string;
     requestId: string;
     method: string;
@@ -605,9 +613,31 @@ export type RequestLogEntry = {
     /** Exact secret-free inputs and result of initial account selection. */
     routingDecision?: ProxyAccountRoutingDecision;
 };
+/** File-sink evidence is independent of model/request success counters. */
+export type ProxyRequestLogSinkSnapshot = {
+    attempted: number;
+    written: number;
+    inFlight: number;
+    pending: number;
+    /** Records not admitted because the bounded writer queue was full. */
+    dropped: number;
+    writeTimeouts: number;
+    unconfirmedWrites: number;
+    lastErrorCode?: string;
+};
+export type ProxyRequestLoggerSnapshot = {
+    enabled: boolean;
+    requests: ProxyRequestLogSinkSnapshot;
+    attempts: ProxyRequestLogSinkSnapshot;
+    debug: ProxyRequestLogSinkSnapshot;
+};
 export type RequestAttemptLogEntry = {
     timestamp: string;
     requestId: string;
+    /** Parent client request for an internal fallback invocation. */
+    parentRequestId?: string;
+    /** Requested effort retained independently of full body captures. */
+    reasoningEffort?: string;
     attempt: number;
     method: string;
     path: string;
@@ -649,7 +679,7 @@ export type RequestAttemptLogEntry = {
     spanId?: string;
 };
 /** Additional fields recorded when a Codex response becomes client-final. */
-export type CodexFinalLogExtra = Partial<Pick<RequestLogEntry, "errorType" | "errorMessage" | "errorCode" | "transportScope" | "inputTokens" | "outputTokens" | "cacheReadTokens" | "cacheCreationTokens" | "terminalOutcome">>;
+export type CodexFinalLogExtra = Partial<Pick<RequestLogEntry, "errorType" | "errorMessage" | "errorCode" | "transportScope" | "inputTokens" | "outputTokens" | "cacheReadTokens" | "cacheCreationTokens" | "terminalOutcome" | "firstUsefulOutputMs">>;
 /** Additional fields recorded for each upstream Codex account attempt. */
 export type CodexAttemptLogExtra = Partial<Pick<RequestAttemptLogEntry, "errorType" | "errorMessage" | "errorCode" | "transportScope" | "retryable" | "rateLimitKind" | "cooldownReason">>;
 /** Minimal persistence contract needed by Codex rotating-token refreshes. */
@@ -1580,15 +1610,17 @@ export type ProxyResponseTrackingObserver = {
     }) => void;
     onTerminal?: (details: {
         outcome: ProxyResponseTerminalOutcome;
+        /** Underlying read failure for structured transport diagnostics. */
+        error?: unknown;
         /** Decoded response-body bytes observed by the adapter. */
         observedBodyBytes: number;
         responseChunks: number;
-    }) => void;
+    }) => unknown;
 };
 /** Versioned lifecycle event names persisted by the proxy adapter. */
 export type ProxyLifecycleEventName = "request_accepted" | "response_headers" | "response_first_chunk" | "request_terminal";
 /** Client-facing terminal classifications recorded by lifecycle metadata. */
-export type ProxyLifecycleTerminalOutcome = ProxyResponseTerminalOutcome | "handler_error";
+export type ProxyLifecycleTerminalOutcome = ProxyResponseTerminalOutcome | "handler_error" | "unknown";
 /** Content-free lifecycle event accepted by the bounded metadata logger. */
 export type ProxyLifecycleEventInput = {
     event: ProxyLifecycleEventName;
@@ -1601,6 +1633,13 @@ export type ProxyLifecycleEventInput = {
     sessionHash?: string;
     requestBytes?: number;
     responseStatus?: number;
+    /** Semantic final status; the HTTP status may already have been committed. */
+    finalStatus?: number;
+    /** Terminal bookkeeping health, separate from the model outcome. */
+    telemetryStatus?: "complete" | "timeout" | "observer_error" | "missing_final";
+    /** Transport completion is independent of successful model completion. */
+    transportOutcome?: ProxyResponseTerminalOutcome;
+    outcomeSource?: "final_request" | "transport_error" | "http_status" | "unknown";
     /** Decoded response-body bytes observed by the adapter. */
     observedBodyBytes?: number;
     responseChunks?: number;
@@ -1627,6 +1666,10 @@ export type ProxyLifecycleLoggerSnapshot = {
     writeFailures: number;
     /** Events requeued after a transient lifecycle metadata write failure. */
     writeRetries: number;
+    /** Slow appends still owned by the original writer, never replayed on timeout. */
+    writeTimeouts: number;
+    /** Records in failed appends that may have partially reached the file. */
+    unconfirmedWrites: number;
     pending: number;
     inFlight: number;
     flushing: boolean;
@@ -1698,6 +1741,12 @@ export type ProxyAnalysisReport = {
         unsupportedLifecycleLines: number;
         lifecycleSequenceGaps: number;
         lifecycleSequenceDuplicates: number;
+        conflictingLifecycleDuplicates: number;
+        duplicateAttempts: number;
+        finalOutcomeConflicts: number;
+        /** Missing evidence; may include in-flight or interrupted requests. */
+        acceptedWithoutFinal: number;
+        terminalWithoutFinal: number;
         streams: Record<ProxyAnalysisStreamName, {
             observedFrom: string | null;
             observedTo: string | null;
@@ -1755,6 +1804,7 @@ export type ProxyAnalysisReport = {
     latencyMs: {
         headers: ProxyLatencySummary;
         firstChunk: ProxyLatencySummary;
+        firstUsefulOutput: ProxyLatencySummary;
         terminal: ProxyLatencySummary;
         finalRequest: ProxyLatencySummary;
         attempt: ProxyLatencySummary;
@@ -1817,6 +1867,7 @@ export type ProxyAnalysisAttemptRecord = {
 };
 /** Final request fields retained while joining offline proxy log records. */
 export type ProxyAnalysisFinalRequestRecord = {
+    firstUsefulOutputMs: number | null;
     timestamp: string;
     status: number;
     durationMs: number | null;
@@ -1861,6 +1912,15 @@ export type CodexStreamUsage = {
     cacheCreationTokens: number;
     reasoningTokens: number;
 };
+/** Semantic completion evidence observed in native Codex SSE bytes. */
+export type CodexStreamEvidence = {
+    completed: boolean;
+    terminalBytes: number;
+    firstUsefulOutputAt?: number;
+    errorType?: string;
+    errorMessage?: string;
+    errorCode?: string;
+};
 /** Validated account-routing evidence joined to a final request log. */
 export type ProxyAnalysisRoutingRecord = {
     requestId: string;
@@ -1883,6 +1943,8 @@ export type RuntimeRequestMetadata = {
     rejectForUpdate?: boolean;
     terminalErrorType?: string;
     terminalErrorCode?: string;
+    /** Canonical final record, populated synchronously before asynchronous I/O. */
+    terminalResult?: RequestLogEntry;
     /** Releases this request's peer-share concurrency slot. Set by the share
      *  gate for borrowed traffic; invoked once the response body completes, so a
      *  long stream holds its slot for as long as it is actually streaming. */
@@ -2073,6 +2135,8 @@ export type SSEContentBlock = {
 };
 /** Aggregated telemetry resolved when an SSE stream completes. */
 export type SSETelemetry = {
+    messageStopReceived: boolean;
+    firstUsefulOutputAt?: number;
     messageId: string;
     model: string;
     usage: {
@@ -2115,6 +2179,8 @@ export type StreamTerminalOutcomeTracker = {
 };
 /** Mutable accumulator the SSE interceptor uses internally. */
 export type TelemetryAccumulator = {
+    messageStopReceived: boolean;
+    firstUsefulOutputAt?: number;
     messageId: string;
     model: string;
     inputTokens: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "12.12.6",
+  "version": "12.12.8",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {
@@ -112,6 +112,7 @@
     "test:mcp:spans": "pnpm exec tsx test/continuous-test-suite-mcp-spans.ts",
     "test:mcp:infra": "pnpm exec tsx test/continuous-test-suite-mcp-infra.ts",
     "test:vendor-recovery": "pnpm exec tsx test/continuous-test-suite-native-vendor-recovery.ts",
+    "test:browser-bundle": "pnpm exec tsx test/continuous-test-suite-browser-bundle.ts",
     "test:providers-mocked": "pnpm exec tsx test/continuous-test-suite-providers-mocked.ts",
     "scaffold:provider": "pnpm exec tsx tools/scaffold-provider.ts",
     "verify:provider-onboarding": "pnpm exec tsx tools/verify-provider-onboarding.ts",
@@ -143,6 +144,7 @@
     "test:dynamic": "pnpm exec tsx test/continuous-test-suite-dynamic.ts",
     "test:proxy": "pnpm exec tsx test/continuous-test-suite-proxy.ts",
     "test:proxy-connect-retry": "pnpm exec tsx test/continuous-test-suite-proxy-connect-retry.ts",
+    "test:proxy-telemetry": "pnpm exec tsx test/continuous-test-suite-proxy-telemetry.ts",
     "test:codex": "pnpm exec tsx test/continuous-test-suite-codex.ts",
     "test:bugfixes": "pnpm exec tsx test/continuous-test-suite-bugfixes.ts",
     "test:json-e2e": "pnpm exec tsx test/continuous-test-suite-json-e2e.ts",