@juspay/neurolink 9.5.2 → 9.6.0

package/dist/lib/server/utils/validation.d.ts

@@ -13,12 +13,12 @@ export declare const AgentExecuteRequestSchema: z.ZodObject<{
         files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        files?: string[] | undefined;
         images?: string[] | undefined;
+        files?: string[] | undefined;
     }, {
         text: string;
-        files?: string[] | undefined;
         images?: string[] | undefined;
+        files?: string[] | undefined;
     }>]>;
     provider: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
@@ -32,8 +32,8 @@ export declare const AgentExecuteRequestSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     input: string | {
         text: string;
-        files?: string[] | undefined;
         images?: string[] | undefined;
+        files?: string[] | undefined;
     };
     provider?: string | undefined;
     model?: string | undefined;
@@ -42,13 +42,13 @@ export declare const AgentExecuteRequestSchema: z.ZodObject<{
     sessionId?: string | undefined;
     temperature?: number | undefined;
     maxTokens?: number | undefined;
-    systemPrompt?: string | undefined;
     stream?: boolean | undefined;
+    systemPrompt?: string | undefined;
 }, {
     input: string | {
         text: string;
-        files?: string[] | undefined;
         images?: string[] | undefined;
+        files?: string[] | undefined;
     };
     provider?: string | undefined;
     model?: string | undefined;
@@ -57,8 +57,8 @@ export declare const AgentExecuteRequestSchema: z.ZodObject<{
     sessionId?: string | undefined;
     temperature?: number | undefined;
     maxTokens?: number | undefined;
-    systemPrompt?: string | undefined;
     stream?: boolean | undefined;
+    systemPrompt?: string | undefined;
 }>;
 /**
  * Tool execute request schema
@@ -148,12 +148,12 @@ export declare const SessionsListQuerySchema: z.ZodObject<{
     offset: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
     userId?: string | undefined;
-    offset?: number | undefined;
     limit?: number | undefined;
+    offset?: number | undefined;
 }, {
     userId?: string | undefined;
-    offset?: string | undefined;
     limit?: string | undefined;
+    offset?: string | undefined;
 }>;
 /**
  * Session messages query schema (for pagination)
@@ -162,11 +162,11 @@ export declare const SessionMessagesQuerySchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>>;
     offset: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
-    offset?: number | undefined;
     limit?: number | undefined;
+    offset?: number | undefined;
 }, {
-    offset?: string | undefined;
     limit?: string | undefined;
+    offset?: string | undefined;
 }>;
 /**
  * Standardized error response format

package/dist/lib/session/globalSessionState.d.ts

@@ -1,13 +1,13 @@
 import { NeuroLink } from "../neurolink.js";
 import type { ConversationMemoryConfig } from "../types/conversation.js";
 type SessionVariableValue = string | number | boolean;
-interface LoopSessionState {
+type LoopSessionState = {
     neurolinkInstance: NeuroLink;
     sessionId: string;
     isActive: boolean;
     conversationMemoryConfig?: ConversationMemoryConfig;
     sessionVariables: Record<string, SessionVariableValue>;
-}
+};
 export declare class GlobalSessionManager {
     private static instance;
     private loopSession;

package/dist/lib/telemetry/telemetryService.d.ts

@@ -1,11 +1,11 @@
-export interface HealthMetrics {
+export type HealthMetrics = {
     timestamp: number;
     memoryUsage: NodeJS.MemoryUsage;
     uptime: number;
     activeConnections: number;
     errorRate: number;
     averageResponseTime: number;
-}
+};
 export declare class TelemetryService {
     private static instance;
     private sdk?;

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

@@ -135,3 +135,42 @@ export type Context = {
     sessionId?: string;
     metadata?: Record<string, string | number | boolean>;
 };
+/**
+ * Result of executing a child process (shell command).
+ */
+export type ProcessResult = {
+    /** Exit code of the process */
+    code: number | null;
+    /** Standard output */
+    stdout: string;
+    /** Standard error output */
+    stderr: string;
+    /** Whether the process exited successfully (code === 0) */
+    success: boolean;
+};
+/**
+ * A named test function with an optional category.
+ */
+export type TestFunction = {
+    /** Display name of the test */
+    name: string;
+    /** Async function that returns true on pass, false on fail */
+    fn: () => Promise<boolean>;
+    /** Optional grouping category */
+    category?: string;
+};
+/**
+ * Result of a single test execution.
+ */
+export type TestResult = {
+    /** Display name of the test */
+    name: string;
+    /** Whether the test passed */
+    result: boolean;
+    /** Error message if the test failed, null otherwise */
+    error: string | null;
+    /** Optional grouping category */
+    category?: string;
+    /** Optional execution duration in milliseconds */
+    duration?: number;
+};

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

@@ -4,6 +4,8 @@
  */
 import type { JsonObject } from "./common.js";
 import type { ExecutionContext } from "../types/tools.js";
+import type { ChatMessage, ConversationMemoryConfig } from "./conversation.js";
+import type { CompactionStage } from "../context/contextCompactor.js";
 /**
  * Base context type for all AI operations
  */
@@ -171,4 +173,257 @@ export declare class ContextConverter {
     private static inferProvider;
     private static extractCustomData;
 }
+/** Result of multi-stage context compaction. */
+export type CompactionResult = {
+    compacted: boolean;
+    stagesUsed: CompactionStage[];
+    tokensBefore: number;
+    tokensAfter: number;
+    tokensSaved: number;
+    messages: ChatMessage[];
+};
+/** Configuration for the context compaction pipeline. */
+export type CompactionConfig = {
+    enablePrune?: boolean;
+    enableDeduplicate?: boolean;
+    enableSummarize?: boolean;
+    enableTruncate?: boolean;
+    pruneProtectTokens?: number;
+    pruneMinimumSavings?: number;
+    pruneProtectedTools?: string[];
+    summarizationProvider?: string;
+    summarizationModel?: string;
+    keepRecentRatio?: number;
+    truncationFraction?: number;
+    provider?: string;
+};
+/** Result of a context budget check. */
+export type BudgetCheckResult = {
+    /** Whether the request fits within the context window */
+    withinBudget: boolean;
+    /** Estimated total input tokens */
+    estimatedInputTokens: number;
+    /** Available input tokens for this model */
+    availableInputTokens: number;
+    /** Usage ratio (0.0 - 1.0+) */
+    usageRatio: number;
+    /** Whether auto-compaction should trigger */
+    shouldCompact: boolean;
+    /** Breakdown of token usage by category */
+    breakdown: {
+        systemPrompt: number;
+        conversationHistory: number;
+        currentPrompt: number;
+        toolDefinitions: number;
+        fileAttachments: number;
+    };
+};
+/** Parameters for budget checking. */
+export type BudgetCheckParams = {
+    provider: string;
+    model?: string;
+    maxTokens?: number;
+    systemPrompt?: string;
+    conversationMessages?: Array<{
+        role: string;
+        content: string;
+    }>;
+    currentPrompt?: string;
+    toolDefinitions?: unknown[];
+    fileAttachments?: Array<{
+        content: string;
+    }>;
+    /** Compaction trigger threshold (0.0-1.0). Default: 0.80 */
+    compactionThreshold?: number;
+};
+/** A file prepared for potential summarization. */
+export type FileForSummarization = {
+    /** Display name (e.g. "report.pdf") */
+    fileName: string;
+    /** Human-readable type label (e.g. "PDF Document") */
+    fileType: string;
+    /** Extracted text content */
+    content: string;
+    /** Estimated token count (provider-adjusted) */
+    estimatedTokens: number;
+    /** Optional MIME type */
+    mimeType?: string;
+    /** Original byte size on disk */
+    originalSize?: number;
+};
+/** Parameters for `shouldSummarizeFiles()`. */
+export type FileSummarizationCheckParams = {
+    /** AI provider name (e.g. "vertex", "anthropic") */
+    provider: string;
+    /** Model name (optional -- falls back to provider default) */
+    model?: string;
+    /** Token estimate for the system prompt */
+    systemPromptTokens: number;
+    /** Token estimate for conversation history */
+    conversationHistoryTokens: number;
+    /** Token estimate for the current user prompt */
+    currentPromptTokens: number;
+    /** Token estimate for tool definitions */
+    toolDefinitionTokens: number;
+    /** Token estimate for all attached files (sum) */
+    fileTokens: number;
+    /** Number of attached files */
+    fileCount?: number;
+    /** Explicit maxTokens (output reserve) from user config */
+    maxTokens?: number;
+    /** Context usage fraction that triggers summarization (0.0-1.0, default 0.80) */
+    threshold?: number;
+    /** Minimum tokens per file in the summarization plan */
+    minTokensPerFile?: number;
+    /** Maximum tokens per file in the summarization plan */
+    maxTokensPerFile?: number;
+};
+/** Result of `shouldSummarizeFiles()`. */
+export type FileSummarizationCheckResult = {
+    /** Whether summarization is needed */
+    needsSummarization: boolean;
+    /** Total estimated input tokens (all categories) */
+    totalEstimatedTokens: number;
+    /** Available input tokens for the model */
+    availableInputTokens: number;
+    /** Budget remaining for files after non-file content */
+    availableBudgetForFiles: number;
+    /** If summarizing, the per-file token budget (undefined when not needed) */
+    perFileBudget?: number;
+};
+/** Parameters for `buildFileSummarizationPrompt()`. */
+export type FileSummarizationPromptParams = {
+    /** File display name */
+    fileName: string;
+    /** File type label */
+    fileType: string;
+    /** Full extracted text of the file */
+    fileContent: string;
+    /** The user's original prompt / question */
+    userPrompt: string;
+    /** Target output token count for the summary */
+    targetTokens: number;
+};
+/** Result item from `planFileSummarization()`. */
+export type SummarizedFile = {
+    /** File display name */
+    fileName: string;
+    /** File type label */
+    fileType: string;
+    /** Summary text (or original content if not summarized) */
+    summary: string;
+    /** Original token estimate */
+    originalTokens: number;
+    /** Token estimate of the summary */
+    summaryTokens: number;
+    /** Whether this file was actually summarized */
+    wasSummarized: boolean;
+};
+/** Plan entry for a single file. */
+export type FileSummarizationPlanEntry = {
+    file: FileForSummarization;
+    action: "summarize" | "keep";
+    targetTokens?: number;
+};
+/** Raw file input before text extraction. */
+export type RawFileInput = {
+    /** File content -- either a UTF-8 string or a raw Buffer */
+    content: string | Buffer;
+    /** MIME type (e.g. "application/pdf", "text/plain") */
+    mimeType: string;
+    /** Display file name */
+    fileName: string;
+    /** Original byte size on disk (optional) */
+    originalSize?: number;
+};
+/** Input file for aggregate budget enforcement. */
+export type BudgetFileInput = {
+    name: string;
+    sizeBytes: number;
+    /** Optional file type hint for type-aware token estimation */
+    fileType?: string;
+};
+/** Options for tool output truncation. */
+export type TruncateOptions = {
+    maxBytes?: number;
+    maxLines?: number;
+    direction?: "head" | "tail";
+    saveToDisk?: boolean;
+    saveDir?: string;
+};
+/** Result of tool output truncation. */
+export type TruncateResult = {
+    content: string;
+    truncated: boolean;
+    savedPath?: string;
+    originalSize: number;
+};
+/** Result of tool pair repair. */
+export type RepairResult = {
+    repaired: boolean;
+    messages: ChatMessage[];
+    orphanedCallsFixed: number;
+    orphanedResultsFixed: number;
+};
+/** Options for summarization prompt building. */
+export type SummarizationPromptOptions = {
+    /**
+     * Whether this is an incremental update to an existing summary
+     */
+    isIncremental: boolean;
+    /**
+     * The previous summary to merge with (required for incremental mode)
+     */
+    previousSummary?: string;
+    /**
+     * List of files that have been read during the conversation
+     */
+    filesRead?: string[];
+    /**
+     * List of files that have been modified during the conversation
+     */
+    filesModified?: string[];
+};
+/** Configuration for tool output pruning (Stage 1). */
+export type PruneConfig = {
+    protectTokens?: number;
+    minimumSavings?: number;
+    protectedTools?: string[];
+    provider?: string;
+};
+/** Result of tool output pruning (Stage 1). */
+export type PruneResult = {
+    pruned: boolean;
+    messages: ChatMessage[];
+    tokensSaved: number;
+};
+/** Configuration for sliding window truncation (Stage 4). */
+export type TruncationConfig = {
+    fraction?: number;
+};
+/** Result of sliding window truncation (Stage 4). */
+export type TruncationResult = {
+    truncated: boolean;
+    messages: ChatMessage[];
+    messagesRemoved: number;
+};
+/** Configuration for structured LLM summarization (Stage 3). */
+export type SummarizeConfig = {
+    provider?: string;
+    model?: string;
+    keepRecentRatio?: number;
+    memoryConfig?: Partial<ConversationMemoryConfig>;
+};
+/** Result of structured LLM summarization (Stage 3). */
+export type SummarizeResult = {
+    summarized: boolean;
+    messages: ChatMessage[];
+    summaryText?: string;
+};
+/** Result of file read deduplication (Stage 2). */
+export type DeduplicationResult = {
+    deduplicated: boolean;
+    messages: ChatMessage[];
+    filesDeduped: number;
+};
 export {};

package/dist/lib/types/contextTypes.js

@@ -398,6 +398,4 @@ export class ContextConverter {
         return customData;
     }
 }
-// Framework fields configuration loading moved to lazy initialization
-// Call ContextFactory.loadFrameworkFieldsFromEnv() explicitly in application entrypoint or test setup
 //# sourceMappingURL=contextTypes.js.map

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

@@ -55,6 +55,34 @@ export type ConversationMemoryConfig = {
     mem0Config?: Mem0Config;
     /** Redis configuration (optional) - overrides environment variables */
     redisConfig?: RedisStorageConfig;
+    /** Context compaction configuration */
+    contextCompaction?: {
+        /** Enable auto-compaction (default: true when summarization enabled) */
+        enabled?: boolean;
+        /** Compaction trigger threshold (0.0-1.0, default: 0.80) */
+        threshold?: number;
+        /** Enable tool output pruning (default: true) */
+        enablePruning?: boolean;
+        /** Enable file read deduplication (default: true) */
+        enableDeduplication?: boolean;
+        /** Enable sliding window fallback (default: true) */
+        enableSlidingWindow?: boolean;
+        /** Tool output max size in bytes (default: 50KB) */
+        maxToolOutputBytes?: number;
+        /** Tool output max lines (default: 2000) */
+        maxToolOutputLines?: number;
+        /** File read budget as fraction of remaining context (default: 0.60) */
+        fileReadBudgetPercent?: number;
+    };
+    /** Configuration for automatic file content summarization when files exceed context budget */
+    fileSummarization?: {
+        enabled?: boolean;
+        provider?: string;
+        model?: string;
+        threshold?: number;
+        minTokensPerFile?: number;
+        maxTokensPerFile?: number;
+    };
     /** @deprecated Use tokenThreshold instead - Maximum number of conversation turns to keep per session (default: 20) */
     maxTurnsPerSession?: number;
     /** @deprecated Use tokenThreshold instead - Turn count to trigger summarization */
@@ -97,6 +125,14 @@ export type SessionMemory = {
     lastTokenCount?: number;
     /** When token count was last calculated (NEW - for token-based memory) */
     lastCountedAt?: number;
+    /** API-reported token count from last request (most accurate) */
+    lastApiTokenCount?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+        cacheReadTokens?: number;
+        cacheWriteTokens?: number;
+    };
     /** Optional session metadata */
     metadata?: {
         /** User role or permissions */
@@ -199,6 +235,16 @@ export type ChatMessage = {
         /** Whether extended thinking was used for this message */
         thinkingExpanded?: boolean;
     };
+    /** UUID identifying this condensation group */
+    condenseId?: string;
+    /** Points to summary that replaces this message */
+    condenseParent?: string;
+    /** UUID identifying this truncation group */
+    truncationId?: string;
+    /** Points to truncation marker that hides this message */
+    truncationParent?: string;
+    /** Marks this message as a truncation boundary marker */
+    isTruncationMarker?: boolean;
 };
 /**
  * Multimodal message types - Re-exported from multimodal.ts
@@ -277,6 +323,14 @@ export type StoreConversationTurnOptions = {
     providerDetails?: ProviderDetails;
     enableSummarization?: boolean;
     events?: StreamEventSequence[];
+    /** API-reported token usage from provider response */
+    tokenUsage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+        cacheReadTokens?: number;
+        cacheWriteTokens?: number;
+    };
 };
 /**
  * Lightweight session metadata for efficient session listing
@@ -315,6 +369,14 @@ export type ConversationBase = {
     lastTokenCount?: number;
     /** Timestamp of last token count */
     lastCountedAt?: number;
+    /** API-reported token count from last request */
+    lastApiTokenCount?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+        cacheReadTokens?: number;
+        cacheWriteTokens?: number;
+    };
 };
 /**
  * Redis conversation storage object format

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

@@ -0,0 +1,27 @@
+/**
+ * Shared type for conversation memory managers.
+ * Both ConversationMemoryManager and RedisConversationMemoryManager
+ * should implement this type.
+ */
+import type { ChatMessage, ConversationMemoryConfig, ConversationMemoryStats, SessionMemory, StoreConversationTurnOptions } from "./conversation.js";
+/**
+ * Common type for all conversation memory manager implementations.
+ * Provides a consistent API for storing, retrieving, and managing conversation history.
+ */
+export type IConversationMemoryManager = {
+    config: ConversationMemoryConfig;
+    /** Initialize the memory manager */
+    initialize(): Promise<void> | void;
+    /** Store a conversation turn */
+    storeConversationTurn(options: StoreConversationTurnOptions): Promise<void>;
+    /** Get session by ID */
+    getSession(sessionId: string, userId?: string): SessionMemory | undefined | Promise<SessionMemory | undefined>;
+    /** Build context messages for AI prompt injection */
+    buildContextMessages(sessionId: string, userId?: string, enableSummarization?: boolean): Promise<ChatMessage[]> | ChatMessage[];
+    /** Clear a specific session */
+    clearSession(sessionId: string, userId?: string): Promise<boolean> | boolean;
+    /** Clear all sessions */
+    clearAllSessions(): Promise<void> | void;
+    /** Get memory statistics */
+    getStats(): Promise<ConversationMemoryStats> | ConversationMemoryStats;
+};

package/dist/lib/types/conversationMemoryInterface.js

@@ -0,0 +1,7 @@
+/**
+ * Shared type for conversation memory managers.
+ * Both ConversationMemoryManager and RedisConversationMemoryManager
+ * should implement this type.
+ */
+export {};
+//# sourceMappingURL=conversationMemoryInterface.js.map