@juspay/neurolink 10.8.0 → 10.8.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [10.8.1](https://github.com/juspay/neurolink/compare/v10.8.0...v10.8.1) (2026-07-30)
+
+### Bug Fixes
+
+- **(proxy):** snapshot live log analysis ([1c975bd](https://github.com/juspay/neurolink/commit/1c975bd9fcf53230e593ffafc485ec15ef26eb5e))
+
 ## [10.8.0](https://github.com/juspay/neurolink/compare/v10.7.1...v10.8.0) (2026-07-30)
 
 ### Features

package/dist/cli/commands/proxyAnalyze.js

@@ -10,6 +10,7 @@ function printAnalysis(report) {
     logger.always(chalk.bold.cyan("NeuroLink Proxy Analysis"));
     logger.always(chalk.gray("=".repeat(50)));
     logger.always(`  Since:       ${chalk.cyan(report.since)}`);
+    logger.always(`  Until:       ${chalk.cyan(report.until)}`);
     logger.always(`  Logs:        ${chalk.cyan(report.logsDir)}`);
     logger.always(`  Files:       ${report.files.requests} request, ${report.files.attempts} attempt, ${report.files.lifecycle} lifecycle, ${report.files.debug} debug`);
     logger.always("");
@@ -133,6 +134,10 @@ export const proxyAnalyzeCommand = {
         type: "string",
         default: "24h",
         description: "ISO timestamp or lookback such as 6h, 1d, or 1w",
+    })
+        .option("until", {
+        type: "string",
+        description: "ISO timestamp or lookback such as 6h, 1d, or 1w; defaults to analysis start time",
     })
         .option("format", {
         type: "string",
@@ -152,6 +157,7 @@ export const proxyAnalyzeCommand = {
             const report = await analyzeProxyLogs({
                 logsDir: argv.logsDir,
                 since: argv.since,
+                until: argv.until,
             });
             if (argv.format === "json") {
                 logger.always(JSON.stringify(report, null, 2));

package/dist/lib/proxy/proxyAnalysis.js

@@ -212,6 +212,19 @@ function parseSince(value, nowMs) {
     }
     return parsed;
 }
+function parseUntil(value, nowMs) {
+    let parsed;
+    try {
+        parsed = parseSince(value, nowMs);
+    }
+    catch {
+        throw new Error(`Invalid --until value "${value}". Use an ISO timestamp or a duration such as 6h, 1d, or 1w.`);
+    }
+    if (parsed > nowMs) {
+        throw new Error(`Invalid --until value "${value}". It must not be later than the analysis start time.`);
+    }
+    return parsed;
+}
 async function readJsonLines(filePath, onRecord, onMalformed) {
     let linesRead = 0;
     const lines = createInterface({
@@ -412,6 +425,10 @@ async function discoverLogFiles(logsDir) {
 export async function analyzeProxyLogs(options) {
     const nowMs = options?.nowMs ?? Date.now();
     const sinceMs = parseSince(options?.since ?? "24h", nowMs);
+    const untilMs = options?.until ? parseUntil(options.until, nowMs) : nowMs;
+    if (untilMs < sinceMs) {
+        throw new Error(`Invalid analysis window: --until must not be earlier than --since.`);
+    }
     const logsDir = resolve(options?.logsDir ?? join(homedir(), ".neurolink", "logs"));
     const { lifecycleFiles, requestFiles, attemptFiles, debugFiles } = await discoverLogFiles(logsDir);
     const observedRanges = {
@@ -448,7 +465,7 @@ export async function analyzeProxyLogs(options) {
     for (const filePath of lifecycleFiles) {
         linesRead += await readJsonLines(filePath, (record) => {
             const timestamp = observeTimestamp("lifecycle", record);
-            if (timestamp === null || timestamp < sinceMs) {
+            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
                 return;
             }
             const event = stringValue(record.event);
@@ -530,7 +547,7 @@ export async function analyzeProxyLogs(options) {
     for (const filePath of attemptFiles) {
         linesRead += await readJsonLines(filePath, (record) => {
             const timestamp = observeTimestamp("attempts", record);
-            if (timestamp === null || timestamp < sinceMs) {
+            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
                 return;
             }
             const requestId = stringValue(record.requestId);
@@ -595,7 +612,7 @@ export async function analyzeProxyLogs(options) {
     for (const filePath of requestFiles) {
         linesRead += await readJsonLines(filePath, (record) => {
             const timestamp = observeTimestamp("requests", record);
-            if (timestamp === null || timestamp < sinceMs) {
+            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
                 return;
             }
             const requestId = stringValue(record.requestId);
@@ -649,7 +666,7 @@ export async function analyzeProxyLogs(options) {
     for (const filePath of debugFiles) {
         linesRead += await readJsonLines(filePath, (record) => {
             const timestamp = observeTimestamp("debug", record);
-            if (timestamp === null || timestamp < sinceMs) {
+            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
                 return;
             }
             if (record.type !== "body_capture") {
@@ -709,6 +726,7 @@ export async function analyzeProxyLogs(options) {
     return {
         generatedAt: new Date(nowMs).toISOString(),
         since: new Date(sinceMs).toISOString(),
+        until: new Date(untilMs).toISOString(),
         logsDir,
         files: {
             lifecycle: lifecycleFiles.length,

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

@@ -795,6 +795,7 @@ export type ProxyStatusArgs = {
 export type ProxyAnalyzeArgs = {
     logsDir?: string;
     since?: string;
+    until?: string;
     format?: "text" | "json";
     quiet?: boolean;
 };

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

@@ -1247,6 +1247,7 @@ export type ProxyAnalysisStreamName = "lifecycle" | "requests" | "attempts" | "d
 export type ProxyAnalysisReport = {
     generatedAt: string;
     since: string;
+    until: string;
     logsDir: string;
     files: {
         lifecycle: number;
@@ -1352,6 +1353,7 @@ export type ProxyAnalysisReport = {
 export type ProxyAnalysisOptions = {
     logsDir?: string;
     since?: string;
+    until?: string;
     nowMs?: number;
 };
 /** Attempt timing retained while joining offline proxy log records. */

package/dist/proxy/proxyAnalysis.js

@@ -212,6 +212,19 @@ function parseSince(value, nowMs) {
     }
     return parsed;
 }
+function parseUntil(value, nowMs) {
+    let parsed;
+    try {
+        parsed = parseSince(value, nowMs);
+    }
+    catch {
+        throw new Error(`Invalid --until value "${value}". Use an ISO timestamp or a duration such as 6h, 1d, or 1w.`);
+    }
+    if (parsed > nowMs) {
+        throw new Error(`Invalid --until value "${value}". It must not be later than the analysis start time.`);
+    }
+    return parsed;
+}
 async function readJsonLines(filePath, onRecord, onMalformed) {
     let linesRead = 0;
     const lines = createInterface({
@@ -412,6 +425,10 @@ async function discoverLogFiles(logsDir) {
 export async function analyzeProxyLogs(options) {
     const nowMs = options?.nowMs ?? Date.now();
     const sinceMs = parseSince(options?.since ?? "24h", nowMs);
+    const untilMs = options?.until ? parseUntil(options.until, nowMs) : nowMs;
+    if (untilMs < sinceMs) {
+        throw new Error(`Invalid analysis window: --until must not be earlier than --since.`);
+    }
     const logsDir = resolve(options?.logsDir ?? join(homedir(), ".neurolink", "logs"));
     const { lifecycleFiles, requestFiles, attemptFiles, debugFiles } = await discoverLogFiles(logsDir);
     const observedRanges = {
@@ -448,7 +465,7 @@ export async function analyzeProxyLogs(options) {
     for (const filePath of lifecycleFiles) {
         linesRead += await readJsonLines(filePath, (record) => {
             const timestamp = observeTimestamp("lifecycle", record);
-            if (timestamp === null || timestamp < sinceMs) {
+            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
                 return;
             }
             const event = stringValue(record.event);
@@ -530,7 +547,7 @@ export async function analyzeProxyLogs(options) {
     for (const filePath of attemptFiles) {
         linesRead += await readJsonLines(filePath, (record) => {
             const timestamp = observeTimestamp("attempts", record);
-            if (timestamp === null || timestamp < sinceMs) {
+            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
                 return;
             }
             const requestId = stringValue(record.requestId);
@@ -595,7 +612,7 @@ export async function analyzeProxyLogs(options) {
     for (const filePath of requestFiles) {
         linesRead += await readJsonLines(filePath, (record) => {
             const timestamp = observeTimestamp("requests", record);
-            if (timestamp === null || timestamp < sinceMs) {
+            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
                 return;
             }
             const requestId = stringValue(record.requestId);
@@ -649,7 +666,7 @@ export async function analyzeProxyLogs(options) {
     for (const filePath of debugFiles) {
         linesRead += await readJsonLines(filePath, (record) => {
             const timestamp = observeTimestamp("debug", record);
-            if (timestamp === null || timestamp < sinceMs) {
+            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
                 return;
             }
             if (record.type !== "body_capture") {
@@ -709,6 +726,7 @@ export async function analyzeProxyLogs(options) {
     return {
         generatedAt: new Date(nowMs).toISOString(),
         since: new Date(sinceMs).toISOString(),
+        until: new Date(untilMs).toISOString(),
         logsDir,
         files: {
             lifecycle: lifecycleFiles.length,

package/dist/types/cli.d.ts

@@ -795,6 +795,7 @@ export type ProxyStatusArgs = {
 export type ProxyAnalyzeArgs = {
     logsDir?: string;
     since?: string;
+    until?: string;
     format?: "text" | "json";
     quiet?: boolean;
 };

package/dist/types/proxy.d.ts

@@ -1247,6 +1247,7 @@ export type ProxyAnalysisStreamName = "lifecycle" | "requests" | "attempts" | "d
 export type ProxyAnalysisReport = {
     generatedAt: string;
     since: string;
+    until: string;
     logsDir: string;
     files: {
         lifecycle: number;
@@ -1352,6 +1353,7 @@ export type ProxyAnalysisReport = {
 export type ProxyAnalysisOptions = {
     logsDir?: string;
     since?: string;
+    until?: string;
     nowMs?: number;
 };
 /** Attempt timing retained while joining offline proxy log records. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "10.8.0",
+  "version": "10.8.1",
   "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": {