@juspay/neurolink 12.14.5 → 12.14.7

package/dist/types/cli.d.ts

@@ -834,8 +834,14 @@ export type ProxyGuardArgs = {
 };
 /** Arguments accepted by `neurolink proxy telemetry <subcommand>` */
 export type ProxyTelemetryArgs = {
-    action?: "setup" | "start" | "stop" | "status" | "logs" | "import-dashboard";
+    action?: "setup" | "start" | "stop" | "status" | "logs" | "import-dashboard" | "doctor" | "query";
     quiet?: boolean;
+    since?: string;
+    until?: string;
+    kind?: string;
+    format?: "json" | "text";
+    maxRows?: number;
+    proxyUrl?: string;
 };
 /** A fallback chain entry (serialisable subset of FallbackEntry) */
 export type FallbackInfo = {

package/dist/types/index.d.ts

@@ -95,3 +95,4 @@ export * from "./classifierRouter.js";
 export * from "./agentNetwork.js";
 export * from "./localUsage.js";
 export * from "./dispatch.js";
+export * from "./proxyRestart.js";

package/dist/types/index.js

@@ -110,3 +110,4 @@ export * from "./agentNetwork.js";
 export * from "./localUsage.js";
 // resolveRequestKind() dispatch-decision types
 export * from "./dispatch.js";
+export * from "./proxyRestart.js";

package/dist/types/proxy.d.ts

@@ -555,8 +555,14 @@ export type ProxyAccountSortMetrics = {
     scopedSaturated: boolean;
 };
 export type RequestLogEntry = {
-    /** First output text or tool-argument delta, excluding SSE control frames. */
+    /** First text, refusal or populated tool output, excluding SSE control frames. */
     firstUsefulOutputMs?: number;
+    /** Why first-useful-output timing is absent; never substitute a zero. */
+    firstUsefulOutputStatus?: "observed" | "no_useful_output" | "not_observed";
+    /** Native protocol event that established the first useful output. */
+    firstUsefulOutputEvent?: string;
+    /** Requested reasoning effort retained independently of body capture. */
+    reasoningEffort?: string;
     /** Small routing evidence retained even when response bodies are pruned. */
     fallbackPlan?: Array<{
         provider: string;
@@ -610,6 +616,8 @@ export type RequestLogEntry = {
     traceId?: string;
     /** OTel span ID for correlation with distributed traces */
     spanId?: string;
+    /** Original OTel sampling flags retained through deferred logging. */
+    traceFlags?: number;
     /** Exact secret-free inputs and result of initial account selection. */
     routingDecision?: ProxyAccountRoutingDecision;
 };
@@ -631,6 +639,16 @@ export type ProcessedProxyBodyCapture = {
     error?: string;
     queueWaitMs?: number;
     processingMs?: number;
+    admission?: ProxyBodyCaptureAdmission;
+};
+/** Exact bounded-admission state; records no request content. */
+export type ProxyBodyCaptureAdmission = {
+    limitingResource: "entry" | "captures" | "bytes" | "worker";
+    estimatedBytes?: number;
+    pending: number;
+    pendingBytes: number;
+    maxPending: number;
+    maxPendingBytes: number;
 };
 export type ProxyBodyCaptureWorkerSnapshot = {
     attempted: number;
@@ -641,9 +659,12 @@ export type ProxyBodyCaptureWorkerSnapshot = {
     pendingBytes: number;
     maxPending: number;
     maxPendingBytes: number;
+    highWaterPending: number;
+    highWaterBytes: number;
     /** Admission failures by exact guard, independent of processing failures. */
     rejectionReasons: Record<string, number>;
     lastError?: string;
+    lastRejectedAt?: string;
 };
 /** Collector transport evidence; acknowledgement does not prove backend storage. */
 export type ProxyBodyDeliveryResult = {
@@ -664,6 +685,81 @@ export type ProxyBodyPublicationProgress = {
     emitted: number;
     notify?: () => void;
 };
+/** Bounded metadata-only evidence for an unconfirmed or locally rejected OTLP batch. */
+export type ProxyOtelExportFailure = {
+    id: string;
+    at: string;
+    reason: "export_unconfirmed" | "queue_full";
+    error?: string;
+    records: Array<{
+        eventId: string;
+        kind?: string;
+        requestId?: string;
+        captureId?: string;
+    }>;
+};
+/** Read adapter configuration; credentials never appear in diagnostic reports. */
+export type ProxyTelemetryBackend = {
+    baseUrl: string;
+    organization: string;
+    stream: string;
+    authorization?: string;
+    collectorMetricsUrl?: string;
+};
+export type ProxyTelemetryNativeConfig = {
+    exporters?: Record<string, {
+        endpoint?: string;
+        headers?: Record<string, string>;
+    }>;
+};
+export type ProxyTelemetryQueryBudget = {
+    used: number;
+    limit: number;
+};
+export type ProxyTelemetryQueryOptions = {
+    sql: string;
+    signal?: string;
+    startTime: number;
+    endTime: number;
+    size?: number;
+    offset?: number;
+};
+export type ProxyTelemetryDoctorOptions = {
+    backend: ProxyTelemetryBackend;
+    startTime: number;
+    endTime: number;
+    proxyUrl?: string;
+    maxRows?: number;
+    fetchImpl?: typeof fetch;
+};
+export type ProxyTelemetryCheck = {
+    name: string;
+    status: "pass" | "fail" | "warn" | "unverified";
+    evidence: unknown;
+};
+/** Small stored metadata used by the doctor; bodies are queried separately. */
+export type ProxyTelemetryStoredRecord = Partial<RequestLogEntry> & {
+    captureId?: string;
+    bodySha256?: string;
+    redactedBodyBytes?: number;
+    bodyDelivery?: {
+        status?: string;
+    };
+    captureError?: string;
+    captureAdmission?: ProxyBodyCaptureAdmission;
+    bodyTruncated?: boolean;
+    phase?: string;
+    event?: string;
+    telemetryStatus?: string;
+    outcomeSource?: string;
+};
+export type ProxyTelemetryFieldCoverage = {
+    records: number;
+    traceMissing: number;
+    durationMissing: number;
+    outcomeMissing: number;
+    firstOutputUnexplained: number;
+};
 /** Chunk emission stays in the request logger, which owns request attributes. */
 export type ProxyBodyChunkEmitter = (chunk: string, index: number, count: number) => void;
 export type ProxyRequestLoggerSnapshot = {
@@ -721,9 +817,11 @@ export type RequestAttemptLogEntry = {
     traceId?: string;
     /** OTel span ID for correlation with distributed traces */
     spanId?: string;
+    /** Original OTel sampling flags retained through deferred logging. */
+    traceFlags?: number;
 };
 /** 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" | "firstUsefulOutputMs">>;
+export type CodexFinalLogExtra = Partial<Pick<RequestLogEntry, "errorType" | "errorMessage" | "errorCode" | "transportScope" | "inputTokens" | "outputTokens" | "cacheReadTokens" | "cacheCreationTokens" | "terminalOutcome" | "firstUsefulOutputMs" | "firstUsefulOutputStatus" | "firstUsefulOutputEvent">>;
 /** 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. */
@@ -1562,6 +1660,8 @@ export type ProxyRequestContext = {
      * every non-Anthropic model prices to $0.
      */
     provider?: string;
+    /** An internal fallback is an attempt; its parent owns request/token metrics. */
+    recordRequestMetrics?: boolean;
 };
 /** Response-side details parsed from the upstream reply (model, finish, tools). */
 export type ResponseInfoContext = {
@@ -1998,7 +2098,10 @@ export type CodexStreamUsage = {
 export type CodexStreamEvidence = {
     completed: boolean;
     terminalBytes: number;
+    /** Malformed, oversized or undispatched frames prevent proving output absence. */
+    observationIncomplete?: boolean;
     firstUsefulOutputAt?: number;
+    firstUsefulOutputEvent?: string;
     errorType?: string;
     errorMessage?: string;
     errorCode?: string;
@@ -2017,6 +2120,11 @@ export type RuntimeRequestMetadata = {
     /** Last dispatched attempt, retained until this HTTP request terminates. */
     lastUpstreamAttempt?: RequestAttemptLogEntry;
     requestId: string;
+    /** Ingress OTel correlation survives detached stream/error callbacks. */
+    traceId?: string;
+    spanId?: string;
+    /** Original OTel sampling flags retained through deferred logging. */
+    traceFlags?: number;
     method: string;
     path: string;
     startedAt: number;
@@ -2065,6 +2173,8 @@ export type ProxyBodyCaptureEntry = {
     attempt?: number;
     traceId?: string;
     spanId?: string;
+    /** Original OTel sampling flags retained through deferred logging. */
+    traceFlags?: number;
     metadata?: Record<string, unknown>;
 };
 /** JSON object retained in deterministic proxy replay artifacts. */
@@ -2874,7 +2984,7 @@ export type StatusStats = {
     persistence?: ProxyStatsPersistenceStatus;
 };
 /** Sub-action of the `proxy telemetry` CLI command. */
-export type ProxyTelemetryAction = "setup" | "start" | "stop" | "status" | "logs" | "import-dashboard";
+export type ProxyTelemetryAction = "doctor" | "query" | "setup" | "start" | "stop" | "status" | "logs" | "import-dashboard";
 /** Wire format a proxy request is using. */
 export type ProxyFormat = "claude" | "openai" | "gemini";
 /**
@@ -3866,3 +3976,9 @@ export type ProxyShareProvisioningBundle = {
         expiresAt?: number;
     };
 };
+/** Log correlation retained independently of the current async context. */
+export type ProxyLogTraceContext = {
+    traceId: string;
+    spanId: string;
+    traceFlags: number;
+};

package/dist/types/proxyRestart.d.ts

@@ -0,0 +1,49 @@
+import type { RollingProxyServer } from "./proxy.js";
+import type { ProxySupervisorState } from "./cli.js";
+/** Supervisor state with the optional local restart capability. */
+export type ProxyRestartSupervisorState = ProxySupervisorState & {
+    restartControl?: ProxyRestartControlIdentity;
+};
+export type ProxyRestartArgs = {
+    check: boolean;
+    dev: boolean;
+    format: "text" | "json";
+};
+/** Local supervisor control identity; contains no account credentials. */
+export type ProxyRestartControlIdentity = {
+    protocol: 1;
+    socketPath: string;
+    instanceId: string;
+};
+/** Terminal result of a local restart check or worker activation. */
+export type ProxyRestartResult = {
+    ok: boolean;
+    phase: "checked" | "refused" | "failed" | "activated" | "activated_unverified";
+    message: string;
+    supervisorPid: number;
+    previousWorkerPid?: number;
+    workerPid?: number;
+    version?: string;
+    drainingWorkers: number;
+    /** Observed during handoff/verification; does not attribute the cause. */
+    rejectedSocketsDelta?: number;
+    failedTransfersDelta?: number;
+};
+/** CLI failure before a supervisor result can be authenticated or received. */
+export type CliProxyRestartError = {
+    ok: false;
+    phase: "unverified";
+    message: string;
+};
+/** JSON emitted by the restart CLI, including an unknown control outcome. */
+export type CliProxyRestartOutput = ProxyRestartResult | CliProxyRestartError;
+/** Supervisor-owned restart dependencies, injectable for isolated process tests. */
+export type ProxyRestartControlOptions = {
+    stateDir: string;
+    server: RollingProxyServer;
+    getInstalledVersion: () => Promise<string | undefined>;
+    isUpdatePending: () => boolean;
+    getStatus: () => Promise<unknown>;
+    /** Report control-server errors without stopping the serving listener. */
+    log?: (message: string) => void;
+};

package/dist/types/proxyRestart.js

@@ -0,0 +1 @@
+export {};