@juspay/neurolink 9.94.7 → 9.95.1

package/dist/types/analytics.d.ts

@@ -78,3 +78,130 @@ export type PerformanceMetrics = {
         external: number;
     };
 };
+export type TimeRangeOption = {
+    start: Date;
+    end: Date;
+};
+/**
+ * Quality score subset captured on an analytics telemetry record.
+ */
+export type AnalyticsQualityScore = {
+    overall: number;
+    relevance: number;
+    accuracy: number;
+    completeness: number;
+    reasoning?: string;
+};
+/**
+ * Single request lifecycle record for advanced analytics aggregation.
+ */
+export type TelemetryRecord = {
+    id: string;
+    provider: string;
+    model: string;
+    userId?: string;
+    teamId?: string;
+    department?: string;
+    timestamp: number;
+    latency: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cost: number;
+    isError: boolean;
+    errorMessage?: string;
+    qualityScore?: AnalyticsQualityScore;
+};
+/**
+ * Pluggable storage backend for analytics telemetry records.
+ */
+export type AnalyticsStorage = {
+    /** Save a telemetry record */
+    saveRecord(record: TelemetryRecord): Promise<void>;
+    /** Retrieve all records */
+    getRecords(): Promise<TelemetryRecord[]>;
+    /** Clear storage */
+    clear(): Promise<void>;
+};
+/**
+ * Options for the bounded in-memory analytics storage backend.
+ */
+export type InMemoryAnalyticsStorageOptions = {
+    /** Maximum records to retain. Oldest records are evicted when exceeded. */
+    maxRecords?: number;
+};
+export type ProviderMetricsOptions = {
+    providers?: string[];
+    timeRange?: TimeRangeOption | string;
+    metrics?: string[];
+};
+export type ProviderMetricItem = {
+    name: string;
+    averageLatency: number;
+    averageResponseTime: number;
+    totalTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+    errorRate: number;
+    successRate: number;
+    costPerToken: number;
+    totalCost: number;
+    requestCount: number;
+};
+export type ProviderMetricsResult = {
+    averageLatency: number;
+    averageResponseTime: number;
+    totalTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+    errorRate: number;
+    successRate: number;
+    costPerToken: number;
+    totalCost: number;
+    requestCount: number;
+    providers: ProviderMetricItem[];
+};
+export type CostAnalysisOptions = {
+    timeRange?: TimeRangeOption | string;
+    groupBy?: string | string[];
+    includeProjections?: boolean;
+};
+export type CostGroupItem = {
+    groupKey: string;
+    provider?: string;
+    model?: string;
+    userId?: string;
+    totalCost: number;
+    costPerToken: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    requestCount: number;
+};
+export type CostAnalysisResult = {
+    totalCost: number;
+    totalTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+    requestCount: number;
+    groups: Record<string, CostGroupItem>;
+    providers: CostGroupItem[];
+    projections?: {
+        nextMonth: number;
+        nextQuarter: number;
+    };
+};
+export type TeamAnalyticsOptions = {
+    teamId?: string;
+    departments?: string[];
+    metrics?: string[];
+    timeRange?: TimeRangeOption | string;
+};
+export type TeamAnalyticsResult = {
+    totalRequests: number;
+    uniqueUsers: number;
+    providersUsed: string[];
+    costBreakdownByProvider: Record<string, number>;
+    costBreakdownByUser: Record<string, number>;
+    qualityScores?: AnalyticsQualityScore;
+};

package/dist/types/cli.d.ts

@@ -138,8 +138,8 @@ export type StreamCommandArgs = BaseCommandArgs & CliToolRoutingFlags & CliClass
  * Batch command arguments
  */
 export type BatchCommandArgs = BaseCommandArgs & CliToolRoutingFlags & CliClassifierRouterFlags & {
-    /** Input file path */
-    file?: string;
+    /** Prompts-list file path (the `<promptsFile>` positional) */
+    promptsFile?: string;
     /** AI provider to use */
     provider?: string;
     /** Model name */
@@ -1684,3 +1684,8 @@ export type CliAudioPlayerCommand = {
     command: string;
     args: string[];
 };
+/**
+ * The CLI flags validated by `validateCliInputFiles` before a
+ * generate/stream/batch run starts (--image/--csv/--pdf/--video/--file).
+ */
+export type CliValidatedFileOption = "--image" | "--csv" | "--pdf" | "--video" | "--file";

package/dist/utils/logger.d.ts

@@ -162,6 +162,17 @@ declare class NeuroLinkLogger {
      * @param args - The arguments to log. These are passed directly to `console.log`.
      */
     always(...args: unknown[]): void;
+    /**
+     * Logs messages unconditionally using `console.error` (stderr).
+     *
+     * Same semantics as `always()` — bypasses log level checks and debug mode
+     * gating — but targets stderr instead of stdout. Use this for output that
+     * must stay visible (safety warnings, notices) without risking corruption
+     * of machine-readable stdout (e.g. `--format json`).
+     *
+     * @param args - The arguments to log. These are passed directly to `console.error`.
+     */
+    alwaysStderr(...args: unknown[]): void;
     /**
      * Displays tabular data unconditionally using `console.table`.
      *
@@ -200,6 +211,7 @@ export declare const logger: {
     warn: (...args: unknown[]) => void;
     error: (...args: unknown[]) => void;
     always: (...args: unknown[]) => void;
+    alwaysStderr: (...args: unknown[]) => void;
     table: (data: unknown) => void;
     shouldLog: (level: LogLevel) => boolean;
     setLogLevel: (level: LogLevel) => void;

package/dist/utils/logger.js

@@ -347,6 +347,19 @@ class NeuroLinkLogger {
     always(...args) {
         console.log(...args);
     }
+    /**
+     * Logs messages unconditionally using `console.error` (stderr).
+     *
+     * Same semantics as `always()` — bypasses log level checks and debug mode
+     * gating — but targets stderr instead of stdout. Use this for output that
+     * must stay visible (safety warnings, notices) without risking corruption
+     * of machine-readable stdout (e.g. `--format json`).
+     *
+     * @param args - The arguments to log. These are passed directly to `console.error`.
+     */
+    alwaysStderr(...args) {
+        console.error(...args);
+    }
     /**
      * Displays tabular data unconditionally using `console.table`.
      *
@@ -436,6 +449,9 @@ export const logger = {
     always: (...args) => {
         neuroLinkLogger.always(...args);
     },
+    alwaysStderr: (...args) => {
+        neuroLinkLogger.alwaysStderr(...args);
+    },
     table: (data) => {
         neuroLinkLogger.table(data);
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.94.7",
+  "version": "9.95.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": {
@@ -123,6 +123,7 @@
     "test:json-e2e": "npx tsx test/continuous-test-suite-json-e2e.ts",
     "test:workflow": "npx tsx test/continuous-test-suite-workflow.ts",
     "test:hitl": "npx tsx test/continuous-test-suite-hitl.ts",
+    "test:analytics": "npx tsx test/continuous-test-suite-analytics.ts",
     "test:tasks": "npx tsx test/continuous-test-suite-tasks.ts",
     "test:auth": "npx tsx test/continuous-test-suite-auth.ts",
     "test:autoresearch": "npx tsx test/continuous-test-suite-autoresearch.ts",