@juspay/neurolink 7.48.1 → 7.49.0

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

@@ -13,6 +13,32 @@ export declare class GlobalSessionManager {
     private loopSession;
     static getInstance(): GlobalSessionManager;
     setLoopSession(config?: ConversationMemoryConfig): string;
+    /**
+     * Restore a loop session with an existing sessionId and NeuroLink instance
+     * Used for conversation restoration
+     */
+    restoreLoopSession(sessionId: string, neurolinkInstance: NeuroLink, config?: ConversationMemoryConfig, sessionVariables?: Record<string, SessionVariableValue>): void;
+    /**
+     * Update session variables during restoration
+     */
+    restoreSessionVariables(variables: Record<string, SessionVariableValue>): void;
+    /**
+     * Check if a session is currently active
+     */
+    hasActiveSession(): boolean;
+    /**
+     * Get current session metadata for restoration purposes
+     */
+    getSessionMetadata(): {
+        sessionId?: string;
+        conversationMemoryConfig?: ConversationMemoryConfig;
+        sessionVariables: Record<string, SessionVariableValue>;
+        isActive: boolean;
+    };
+    /**
+     * Update the sessionId of the current session (used during restoration)
+     */
+    updateSessionId(newSessionId: string): void;
     getLoopSession(): LoopSessionState | null;
     clearLoopSession(): void;
     getOrCreateNeuroLink(): NeuroLink;

package/dist/lib/session/globalSessionState.js

@@ -28,6 +28,55 @@ export class GlobalSessionManager {
         };
         return sessionId;
     }
+    /**
+     * Restore a loop session with an existing sessionId and NeuroLink instance
+     * Used for conversation restoration
+     */
+    restoreLoopSession(sessionId, neurolinkInstance, config, sessionVariables) {
+        this.loopSession = {
+            neurolinkInstance,
+            sessionId,
+            isActive: true,
+            conversationMemoryConfig: config,
+            sessionVariables: sessionVariables || {},
+        };
+    }
+    /**
+     * Update session variables during restoration
+     */
+    restoreSessionVariables(variables) {
+        const session = this.getLoopSession();
+        if (session) {
+            session.sessionVariables = { ...session.sessionVariables, ...variables };
+        }
+    }
+    /**
+     * Check if a session is currently active
+     */
+    hasActiveSession() {
+        return this.loopSession?.isActive ?? false;
+    }
+    /**
+     * Get current session metadata for restoration purposes
+     */
+    getSessionMetadata() {
+        const session = this.getLoopSession();
+        return {
+            sessionId: session?.sessionId,
+            conversationMemoryConfig: session?.conversationMemoryConfig,
+            sessionVariables: session?.sessionVariables || {},
+            isActive: session?.isActive ?? false,
+        };
+    }
+    /**
+     * Update the sessionId of the current session (used during restoration)
+     */
+    updateSessionId(newSessionId) {
+        const session = this.getLoopSession();
+        if (session) {
+            session.sessionId = newSessionId;
+        }
+    }
     getLoopSession() {
         return this.loopSession?.isActive ? this.loopSession : null;
     }

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

@@ -411,6 +411,34 @@ export type JSONOutput = {
 export type ConsoleOverride = {
     [method: string]: (() => void) | undefined;
 };
+/**
+ * Conversation choice for inquirer prompt
+ */
+export type ConversationChoice = {
+    name: string;
+    value: string | "NEW_CONVERSATION";
+    short: string;
+};
+/**
+ * Session restore result
+ */
+export type SessionRestoreResult = {
+    success: boolean;
+    sessionId: string;
+    messageCount: number;
+    error?: string;
+    lastActivity?: string;
+};
+/**
+ * Tool context for restored sessions
+ */
+export type RestorationToolContext = Record<string, unknown> & {
+    sessionId: string;
+    userId: string;
+    source: string;
+    restored: boolean;
+    timestamp: string;
+};
 /**
  * Type guard for generate result
  */

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

@@ -5,14 +5,14 @@
 /**
  * Text content type for multimodal messages
  */
-export interface TextContent {
+export type TextContent = {
     type: "text";
     text: string;
-}
+};
 /**
  * Image content type for multimodal messages
  */
-export interface ImageContent {
+export type ImageContent = {
     type: "image";
     data: Buffer | string;
     mediaType?: "image/jpeg" | "image/png" | "image/gif" | "image/webp" | "image/bmp" | "image/tiff";
@@ -25,11 +25,24 @@ export interface ImageContent {
         };
         filename?: string;
     };
-}
+};
+/**
+ * CSV content type for multimodal messages
+ */
+export type CSVContent = {
+    type: "csv";
+    data: Buffer | string;
+    metadata?: {
+        filename?: string;
+        maxRows?: number;
+        formatStyle?: "raw" | "markdown" | "json";
+        description?: string;
+    };
+};
 /**
  * Union type for all content types
  */
-export type Content = TextContent | ImageContent;
+export type Content = TextContent | ImageContent | CSVContent;
 /**
  * Vision capability information for providers
  */

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

@@ -3,6 +3,7 @@
  * Provides type-safe context integration for AI generation
  */
 import type { JsonObject } from "./common.js";
+import type { ExecutionContext } from "../types/tools.js";
 /**
  * Base context interface for all AI operations
  */
@@ -149,7 +150,6 @@ export declare class ContextFactory {
  * Context conversion utilities for domain-specific data
  * Replaces hardcoded business context with generic domain context
  */
-import type { ExecutionContext } from "../mcp/contracts/mcpContract.js";
 interface ContextConversionOptions {
     preserveLegacyFields?: boolean;
     validateDomainData?: boolean;

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

@@ -148,6 +148,16 @@ export declare class ConversationMemoryError extends Error {
     details?: Record<string, unknown> | undefined;
     constructor(message: string, code: "STORAGE_ERROR" | "CONFIG_ERROR" | "SESSION_NOT_FOUND" | "CLEANUP_ERROR", details?: Record<string, unknown> | undefined);
 }
+/**
+ * NeuroLink initialization options
+ * Configuration for creating NeuroLink instances with conversation memory
+ */
+export interface NeurolinkOptions {
+    /** Conversation memory configuration */
+    conversationMemory?: ConversationMemoryConfig;
+    /** Session identifier for conversation context */
+    sessionId?: string;
+}
 /**
  * Session identifier for Redis storage operations
  */
@@ -166,10 +176,10 @@ export interface SessionMetadata {
     updatedAt: string;
 }
 /**
- * New Redis conversation storage object format
- * Contains conversation metadata and history in a single object
+ * Base conversation metadata (shared fields across all conversation types)
+ * Contains essential conversation information without heavy data arrays
  */
-export type RedisConversationObject = {
+export interface ConversationBase {
     /** Unique conversation identifier (UUID v4) */
     id: string;
     /** Auto-generated conversation title */
@@ -182,9 +192,50 @@ export type RedisConversationObject = {
     createdAt: string;
     /** When this conversation was last updated */
     updatedAt: string;
+}
+/**
+ * Redis conversation storage object format
+ * Contains conversation metadata and full message history
+ */
+export interface RedisConversationObject extends ConversationBase {
     /** Array of conversation messages */
     messages: ChatMessage[];
-};
+}
+/**
+ * Full conversation data for session restoration and manipulation
+ * Extends Redis storage object with additional loop mode metadata
+ */
+export interface ConversationData extends RedisConversationObject {
+    /** Optional metadata for session variables and other loop mode data */
+    metadata?: {
+        /** Session variables set during loop mode */
+        sessionVariables?: Record<string, string | number | boolean>;
+        /** Message count (for compatibility) */
+        messageCount?: number;
+        /** Additional metadata can be added here */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Conversation summary for listing and selection
+ * Contains conversation preview information without heavy message arrays
+ */
+export interface ConversationSummary extends ConversationBase {
+    /** First message preview (for conversation preview) */
+    firstMessage: {
+        content: string;
+        timestamp: string;
+    };
+    /** Last message preview (for conversation preview) */
+    lastMessage: {
+        content: string;
+        timestamp: string;
+    };
+    /** Total number of messages in conversation */
+    messageCount: number;
+    /** Human-readable time since last update (e.g., "2 hours ago") */
+    duration: string;
+}
 /**
  * Redis storage configuration
  */

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

@@ -0,0 +1,65 @@
+/**
+ * File detection and processing types for unified file handling
+ */
+/**
+ * Supported file types for multimodal input
+ */
+export type FileType = "csv" | "image" | "pdf" | "text" | "unknown";
+/**
+ * File input can be Buffer or string (path/URL/data URI)
+ */
+export type FileInput = Buffer | string;
+/**
+ * File source type for tracking input origin
+ */
+export type FileSource = "url" | "path" | "buffer" | "datauri";
+/**
+ * File detection result with confidence scoring
+ */
+export type FileDetectionResult = {
+    type: FileType;
+    mimeType: string;
+    extension: string | null;
+    source: FileSource;
+    metadata: {
+        size?: number;
+        filename?: string;
+        confidence: number;
+    };
+};
+/**
+ * File processing result after detection and conversion
+ */
+export type FileProcessingResult = {
+    type: FileType;
+    content: string | Buffer;
+    mimeType: string;
+    metadata: {
+        confidence: number;
+        size?: number;
+        filename?: string;
+        rowCount?: number;
+        columnCount?: number;
+        columnNames?: string[];
+        sampleData?: string;
+        hasEmptyColumns?: boolean;
+    };
+};
+/**
+ * CSV processor options
+ */
+export type CSVProcessorOptions = {
+    maxRows?: number;
+    formatStyle?: "raw" | "markdown" | "json";
+    includeHeaders?: boolean;
+};
+/**
+ * File detector options
+ */
+export type FileDetectorOptions = {
+    maxSize?: number;
+    timeout?: number;
+    allowedTypes?: FileType[];
+    csvOptions?: CSVProcessorOptions;
+    confidenceThreshold?: number;
+};

package/dist/lib/types/fileTypes.js

@@ -0,0 +1,4 @@
+/**
+ * File detection and processing types for unified file handling
+ */
+export {};

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

@@ -15,11 +15,18 @@ export type GenerateOptions = {
     input: {
         text: string;
         images?: Array<Buffer | string>;
+        csvFiles?: Array<Buffer | string>;
+        files?: Array<Buffer | string>;
         content?: Array<TextContent | ImageContent>;
     };
     output?: {
         format?: "text" | "structured" | "json";
     };
+    csvOptions?: {
+        maxRows?: number;
+        formatStyle?: "raw" | "markdown" | "json";
+        includeHeaders?: boolean;
+    };
     provider?: AIProviderName | string;
     model?: string;
     region?: string;
@@ -168,6 +175,11 @@ export type TextGenerationOptions = {
     middleware?: MiddlewareFactoryOptions;
     expectedOutcome?: string;
     evaluationCriteria?: string[];
+    csvOptions?: {
+        maxRows?: number;
+        formatStyle?: "raw" | "markdown" | "json";
+        includeHeaders?: boolean;
+    };
 };
 /**
  * Text generation result (consolidated from core types)

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

@@ -0,0 +1,103 @@
+import type { LanguageModelV1 } from "ai";
+/**
+ * Result from precall evaluation of user input
+ */
+export interface PrecallEvaluationResult {
+    overall: "safe" | "unsafe" | "suspicious" | "inappropriate";
+    safetyScore: number;
+    appropriatenessScore: number;
+    confidenceLevel: number;
+    issues?: {
+        category: "explicit_content" | "hate_speech" | "violence" | "personal_info" | "spam" | "other";
+        severity: "low" | "medium" | "high" | "critical";
+        description: string;
+    }[];
+    suggestedAction: "allow" | "block" | "sanitize" | "warn";
+    reasoning?: string;
+}
+export type IssueCategory = "explicit_content" | "hate_speech" | "violence" | "personal_info" | "spam" | "other";
+export type IssueSeverity = "low" | "medium" | "high" | "critical";
+export type EvaluationAction = "allow" | "block" | "sanitize" | "warn";
+export type SafetyStatus = "safe" | "unsafe" | "suspicious" | "inappropriate";
+export interface EvaluationActions {
+    onUnsafe?: "block" | "sanitize" | "warn" | "log";
+    onInappropriate?: "block" | "sanitize" | "warn" | "log";
+    onSuspicious?: "warn" | "log" | "allow";
+}
+export interface EvaluationThresholds {
+    safetyScore?: number;
+    appropriatenessScore?: number;
+    confidenceLevel?: number;
+}
+/**
+ * Configuration for precall evaluation using AI models
+ */
+export interface PrecallEvaluationConfig {
+    enabled?: boolean;
+    provider?: string;
+    evaluationModel?: string;
+    evaluationPrompt?: string;
+    actions?: EvaluationActions;
+    thresholds?: EvaluationThresholds;
+    blockUnsafeRequests?: boolean;
+    /**
+     * Regex patterns to use for sanitizing input when action is "sanitize".
+     * Each pattern will be applied with the 'gi' flags (global, case-insensitive).
+     * Matched content will be replaced with the value specified in `replacementText`.
+     *
+     * Example patterns:
+     * - Email: '\\b[\\w.-]+@[\\w.-]+\\.\\w+\\b'
+     * - Phone: '\\b\\d{3}[-.]?\\d{3}[-.]?\\d{4}\\b'
+     * - SSN: '\\b\\d{3}-\\d{2}-\\d{4}\\b'
+     * - Custom words: '\\b(word1|word2|word3)\\b'
+     */
+    sanitizationPatterns?: string[];
+    /**
+     * Text to use when replacing sanitized content.
+     * @default '[REDACTED]'
+     *
+     * Examples:
+     * - '[REDACTED]' (default)
+     * - '***PRIVATE***'
+     * - '####'
+     * - '[FILTERED]'
+     */
+    replacementText?: string;
+}
+export interface BadWordsConfig {
+    enabled?: boolean;
+    list?: string[];
+    regexPatterns?: string[];
+    /**
+     * Text to use when replacing filtered content.
+     * @default '[REDACTED]'
+     *
+     * Examples:
+     * - '[REDACTED]' (default)
+     * - '***'
+     * - '####'
+     * - '[FILTERED]'
+     */
+    replacementText?: string;
+}
+export interface ModelFilterConfig {
+    enabled?: boolean;
+    filterModel?: LanguageModelV1;
+}
+/**
+ * Configuration for the Guardrails middleware
+ */
+export interface GuardrailsMiddlewareConfig {
+    badWords?: BadWordsConfig;
+    modelFilter?: ModelFilterConfig;
+    precallEvaluation?: PrecallEvaluationConfig;
+}
+export interface EvaluationActionResult {
+    shouldBlock: boolean;
+    sanitizedInput?: string;
+}
+export interface EvaluationIssue {
+    category: IssueCategory;
+    severity: IssueSeverity;
+    description: string;
+}

package/dist/lib/types/guardrails.js

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

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

@@ -8,11 +8,11 @@ export * from "./cli.js";
 export * from "./taskClassificationTypes.js";
 export type { NeuroLinkConfig, PerformanceConfig, CacheConfig, FallbackConfig, RetryConfig, AnalyticsConfig, ToolConfig, BackupInfo, BackupMetadata, ConfigValidationResult, ConfigUpdateOptions, } from "./configTypes.js";
 export type { Unknown, UnknownRecord, UnknownArray, JsonValue, JsonObject, JsonArray, ErrorInfo, Result, FunctionParameters, } from "./common.js";
-export type { ToolArgs, ToolContext, ToolResult, ToolDefinition, SimpleTool, AvailableTool, ToolExecution, } from "./tools.js";
+export type { ToolArgs, ToolContext, ToolResult, ToolDefinition, SimpleTool, AvailableTool, ToolInfo, ToolExecution, ToolExecutionResult, ValidationResult, ExecutionContext, CacheOptions, FallbackOptions, } from "./tools.js";
 export type { AISDKModel, ProviderError, AIModelProviderConfig, } from "./providers.js";
 export type { BaseCommandArgs, GenerateCommandArgs, MCPCommandArgs, ModelsCommandArgs, CommandResult, GenerateResult, StreamChunk, } from "./cli.js";
 export type { TaskType, TaskClassification, ClassificationScores, ClassificationStats, ClassificationValidation, } from "./taskClassificationTypes.js";
-export type { MCPTransportType, MCPServerConnectionStatus, MCPServerCategory, MCPServerStatus, MCPDiscoveredServer, MCPConnectedServer, MCPToolInfo, MCPExecutableTool, MCPServerMetadata, MCPToolMetadata, MCPServerRegistryEntry, } from "./mcpTypes.js";
+export type { MCPTransportType, MCPServerConnectionStatus, MCPServerCategory, MCPServerStatus, MCPDiscoveredServer, MCPConnectedServer, MCPToolInfo, MCPExecutableTool, MCPServerMetadata, MCPToolMetadata, MCPServerRegistryEntry, NeuroLinkMCPTool, NeuroLinkMCPServer, NeuroLinkExecutionContext, MCPServerConfig, DiscoveredMcp, McpMetadata, ProviderStatus, ToolDiscoveryResult, ExternalToolExecutionOptions, ToolValidationResult, ToolRegistryEvents, CircuitBreakerState, CircuitBreakerConfig, CircuitBreakerStats, CircuitBreakerEvents, McpRegistry, MCPClientResult, FlexibleValidationResult, } from "./mcpTypes.js";
 export type { ExternalMCPServerInstance, ExternalMCPServerStatus, ExternalMCPToolInfo, ExternalMCPServerHealth, ExternalMCPConfigValidation, ExternalMCPOperationResult, ExternalMCPToolContext, ExternalMCPToolResult, ExternalMCPServerEvents, ExternalMCPManagerConfig, } from "./externalMcp.js";
 export type { ModelCapability, ModelUseCase, ModelFilter, ModelResolutionContext, ModelStats, ModelPricing, } from "./providers.js";
 export type { DomainType, DomainConfig, DomainTemplate, DomainConfigOptions, DomainEvaluationCriteria, DomainValidationRule, } from "./domainTypes.js";
@@ -26,3 +26,5 @@ export * from "./modelTypes.js";
 export * from "./serviceTypes.js";
 export * from "./evaluationProviders.js";
 export * from "./sdkTypes.js";
+export * from "./fileTypes.js";
+export * from "./content.js";

package/dist/lib/types/index.js

@@ -25,3 +25,7 @@ export * from "./serviceTypes.js";
 export * from "./evaluationProviders.js";
 // SDK Types - Core types for external developers
 export * from "./sdkTypes.js";
+// File detection and processing types
+export * from "./fileTypes.js";
+// Content types for multimodal support
+export * from "./content.js";