@juspay/neurolink 9.43.0 → 9.44.1

package/dist/lib/types/serverTypes.js

@@ -0,0 +1,68 @@
+/**
+ * Server Adapter Types
+ * Comprehensive type system for NeuroLink server adapters
+ */
+// ============================================
+// Error Types
+// ============================================
+/**
+ * Error categories for server adapter errors
+ */
+export const ErrorCategory = {
+    CONFIG: "CONFIG",
+    VALIDATION: "VALIDATION",
+    EXECUTION: "EXECUTION",
+    EXTERNAL: "EXTERNAL",
+    RATE_LIMIT: "RATE_LIMIT",
+    AUTHENTICATION: "AUTHENTICATION",
+    AUTHORIZATION: "AUTHORIZATION",
+    STREAMING: "STREAMING",
+    WEBSOCKET: "WEBSOCKET",
+};
+/**
+ * Error severity levels
+ */
+export const ErrorSeverity = {
+    LOW: "LOW",
+    MEDIUM: "MEDIUM",
+    HIGH: "HIGH",
+    CRITICAL: "CRITICAL",
+};
+/**
+ * Server adapter error codes
+ */
+export const ServerAdapterErrorCode = {
+    // Configuration errors
+    INVALID_CONFIG: "SERVER_ADAPTER_INVALID_CONFIG",
+    MISSING_DEPENDENCY: "SERVER_ADAPTER_MISSING_DEPENDENCY",
+    FRAMEWORK_INIT_FAILED: "SERVER_ADAPTER_FRAMEWORK_INIT_FAILED",
+    // Route errors
+    ROUTE_NOT_FOUND: "SERVER_ADAPTER_ROUTE_NOT_FOUND",
+    ROUTE_CONFLICT: "SERVER_ADAPTER_ROUTE_CONFLICT",
+    INVALID_ROUTE: "SERVER_ADAPTER_INVALID_ROUTE",
+    // Execution errors
+    HANDLER_ERROR: "SERVER_ADAPTER_HANDLER_ERROR",
+    TIMEOUT: "SERVER_ADAPTER_TIMEOUT",
+    MIDDLEWARE_ERROR: "SERVER_ADAPTER_MIDDLEWARE_ERROR",
+    // Rate limit errors
+    RATE_LIMIT_EXCEEDED: "SERVER_ADAPTER_RATE_LIMIT_EXCEEDED",
+    // Authentication/Authorization errors
+    AUTH_REQUIRED: "SERVER_ADAPTER_AUTH_REQUIRED",
+    AUTH_INVALID: "SERVER_ADAPTER_AUTH_INVALID",
+    FORBIDDEN: "SERVER_ADAPTER_FORBIDDEN",
+    // Streaming errors
+    STREAM_ERROR: "SERVER_ADAPTER_STREAM_ERROR",
+    STREAM_ABORTED: "SERVER_ADAPTER_STREAM_ABORTED",
+    // WebSocket errors
+    WEBSOCKET_ERROR: "SERVER_ADAPTER_WEBSOCKET_ERROR",
+    WEBSOCKET_CONNECTION_FAILED: "SERVER_ADAPTER_WEBSOCKET_CONNECTION_FAILED",
+    // Validation errors
+    VALIDATION_ERROR: "SERVER_ADAPTER_VALIDATION_ERROR",
+    SCHEMA_ERROR: "SERVER_ADAPTER_SCHEMA_ERROR",
+    // Server lifecycle errors
+    START_FAILED: "SERVER_ADAPTER_START_FAILED",
+    STOP_FAILED: "SERVER_ADAPTER_STOP_FAILED",
+    ALREADY_RUNNING: "SERVER_ADAPTER_ALREADY_RUNNING",
+    NOT_RUNNING: "SERVER_ADAPTER_NOT_RUNNING",
+};
+//# sourceMappingURL=serverTypes.js.map

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

@@ -1,7 +1,7 @@
 import type { LanguageModel, StepResult, Tool, ToolChoice } from "ai";
 import type { AIProviderName } from "../constants/enums.js";
-import type { EvaluationData } from "../index.js";
-import type { RAGConfig } from "../rag/types.js";
+import type { EvaluationData } from "./evaluation.js";
+import type { RAGConfig } from "./ragTypes.js";
 import type { AnalyticsData, ToolExecutionEvent, ToolExecutionSummary } from "../types/index.js";
 import type { MiddlewareFactoryOptions, OnChunkCallback, OnErrorCallback, OnFinishCallback } from "../types/middlewareTypes.js";
 import type { TokenUsage } from "./analytics.js";

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

@@ -4,7 +4,7 @@
  */
 import type { ZodTypeAny } from "zod";
 import type { Schema } from "ai";
-import type { JsonValue, JsonObject } from "./common.js";
+import type { JsonValue, Result, AsyncFunction } from "./common.js";
 import { zodToJsonSchema } from "zod-to-json-schema";
 /**
  * Type alias for complex Zod schema type to improve readability
@@ -65,11 +65,6 @@ export type JsonRecord = Record<string, JsonValue>;
 export type OptionalStandardRecord = StandardRecord | undefined;
 export type OptionalStringRecord = StringRecord | undefined;
 export type OptionalJsonRecord = JsonRecord | undefined;
-/**
- * Standard async function type for tool execution
- * Most common function signature in the codebase
- */
-export type AsyncFunction<TParams = unknown, TResult = unknown> = (params: TParams) => Promise<TResult>;
 /**
  * Tool execution function with context
  * Standard pattern for MCP tool execution
@@ -98,21 +93,11 @@ export type TransformFunction<TInput = unknown, TOutput = unknown> = (input: TIn
  * Async transformation function type
  */
 export type AsyncTransformFunction<TInput = unknown, TOutput = unknown> = (input: TInput) => Promise<TOutput>;
-/**
- * Array of unknown values
- * Common for flexible array parameters
- */
-export type UnknownArray = unknown[];
 /**
  * Array of standard records
  * Common in data collections
  */
 export type RecordArray = StandardRecord[];
-/**
- * Array of JSON objects
- * API-safe array type
- */
-export type JsonArray = JsonObject[];
 /**
  * String array type
  * Very common for lists of identifiers, names, etc.
@@ -203,17 +188,6 @@ export type StandardError = {
     details?: StandardRecord;
     stack?: string;
 };
-/**
- * Result type with success/error pattern
- * Common pattern for operation results
- */
-export type Result<TData = unknown, TError = StandardError> = {
-    success: true;
-    data: TData;
-} | {
-    success: false;
-    error: TError;
-};
 /**
  * Async result type
  */
@@ -285,16 +259,6 @@ export type ServiceConfig = {
     apiKey?: string;
     metadata?: StandardRecord;
 };
-/**
- * Cache configuration
- * Common caching parameters
- */
-export type CacheConfig = {
-    enabled?: boolean;
-    ttl?: number;
-    maxSize?: number;
-    strategy?: "memory" | "redis" | "hybrid";
-};
 /**
  * Rate limiting configuration
  * Common rate limiting parameters

package/dist/lib/workflow/config.d.ts

@@ -41,8 +41,8 @@ export declare const JudgeConfigSchema: z.ZodObject<{
     model: z.ZodString;
     criteria: z.ZodArray<z.ZodString>;
     outputFormat: z.ZodEnum<{
-        scores: "scores";
         detailed: "detailed";
+        scores: "scores";
         ranking: "ranking";
         best: "best";
     }>;
@@ -195,8 +195,8 @@ export declare const WorkflowConfigSchema: z.ZodObject<{
         model: z.ZodString;
         criteria: z.ZodArray<z.ZodString>;
         outputFormat: z.ZodEnum<{
-            scores: "scores";
             detailed: "detailed";
+            scores: "scores";
             ranking: "ranking";
             best: "best";
         }>;
@@ -219,8 +219,8 @@ export declare const WorkflowConfigSchema: z.ZodObject<{
         model: z.ZodString;
         criteria: z.ZodArray<z.ZodString>;
         outputFormat: z.ZodEnum<{
-            scores: "scores";
             detailed: "detailed";
+            scores: "scores";
             ranking: "ranking";
             best: "best";
         }>;

package/dist/rag/errors/RAGError.d.ts

@@ -82,7 +82,7 @@ export declare const RAGErrorFactory: {
         readonly RETRY_EXHAUSTED: "RAG_RETRY_EXHAUSTED";
         readonly INVALID_CONFIGURATION: "RAG_INVALID_CONFIGURATION";
     };
-    create: (code: "INVALID_CONFIGURATION" | "CHUNKING_ERROR" | "CHUNKING_INVALID_CONFIG" | "CHUNKING_STRATEGY_NOT_FOUND" | "CHUNKING_EMPTY_CONTENT" | "CHUNKING_SIZE_EXCEEDED" | "METADATA_EXTRACTION_ERROR" | "METADATA_EXTRACTION_TIMEOUT" | "METADATA_SCHEMA_INVALID" | "METADATA_EXTRACTOR_NOT_FOUND" | "EMBEDDING_ERROR" | "EMBEDDING_DIMENSION_MISMATCH" | "EMBEDDING_RATE_LIMIT" | "EMBEDDING_PROVIDER_ERROR" | "VECTOR_QUERY_ERROR" | "VECTOR_QUERY_TIMEOUT" | "VECTOR_STORE_UNAVAILABLE" | "VECTOR_STORE_CONNECTION_ERROR" | "VECTOR_INDEX_NOT_FOUND" | "RERANKER_ERROR" | "RERANKER_NOT_FOUND" | "RERANKER_API_ERROR" | "GRAPH_RAG_ERROR" | "GRAPH_TRAVERSAL_ERROR" | "GRAPH_NODE_NOT_FOUND" | "PIPELINE_ERROR" | "PIPELINE_STAGE_FAILED" | "PIPELINE_PARTIAL_FAILURE" | "CIRCUIT_BREAKER_OPEN" | "CIRCUIT_BREAKER_HALF_OPEN_LIMIT" | "OPERATION_TIMEOUT" | "RETRY_EXHAUSTED", message: string, options?: {
+    create: (code: "CHUNKING_ERROR" | "CHUNKING_INVALID_CONFIG" | "CHUNKING_STRATEGY_NOT_FOUND" | "CHUNKING_EMPTY_CONTENT" | "CHUNKING_SIZE_EXCEEDED" | "METADATA_EXTRACTION_ERROR" | "METADATA_EXTRACTION_TIMEOUT" | "METADATA_SCHEMA_INVALID" | "METADATA_EXTRACTOR_NOT_FOUND" | "EMBEDDING_ERROR" | "EMBEDDING_DIMENSION_MISMATCH" | "EMBEDDING_RATE_LIMIT" | "EMBEDDING_PROVIDER_ERROR" | "VECTOR_QUERY_ERROR" | "VECTOR_QUERY_TIMEOUT" | "VECTOR_STORE_UNAVAILABLE" | "VECTOR_STORE_CONNECTION_ERROR" | "VECTOR_INDEX_NOT_FOUND" | "RERANKER_ERROR" | "RERANKER_NOT_FOUND" | "RERANKER_API_ERROR" | "GRAPH_RAG_ERROR" | "GRAPH_TRAVERSAL_ERROR" | "GRAPH_NODE_NOT_FOUND" | "PIPELINE_ERROR" | "PIPELINE_STAGE_FAILED" | "PIPELINE_PARTIAL_FAILURE" | "CIRCUIT_BREAKER_OPEN" | "CIRCUIT_BREAKER_HALF_OPEN_LIMIT" | "OPERATION_TIMEOUT" | "RETRY_EXHAUSTED" | "INVALID_CONFIGURATION", message: string, options?: {
         retryable?: boolean;
         details?: Record<string, unknown>;
         cause?: Error;

package/dist/rag/types.d.ts

@@ -698,71 +698,4 @@ export type RAGCommandArgs = {
     /** Use Graph RAG */
     graph?: boolean;
 };
-/**
- * RAG configuration for generate() and stream() APIs.
- *
- * When provided, NeuroLink automatically:
- * 1. Loads the specified files
- * 2. Chunks them using the selected strategy
- * 3. Generates embeddings
- * 4. Stores in an in-memory vector store
- * 5. Creates a search tool the AI can invoke on demand
- *
- * @example
- * ```typescript
- * const result = await neurolink.generate({
- *   input: { text: "What is RAG?" },
- *   provider: "vertex",
- *   rag: {
- *     files: ["./docs/guide.md", "./docs/api.md"],
- *     strategy: "markdown",
- *     chunkSize: 512,
- *     topK: 5,
- *   }
- * });
- * ```
- */
-export type RAGConfig = {
-    /** File paths to load and index for retrieval */
-    files: string[];
-    /**
-     * Chunking strategy to use. If not specified, auto-detected from file extension.
-     * @default "recursive"
-     */
-    strategy?: ChunkingStrategy;
-    /**
-     * Maximum chunk size in characters.
-     * @default 1000
-     */
-    chunkSize?: number;
-    /**
-     * Overlap between adjacent chunks in characters.
-     * @default 200
-     */
-    chunkOverlap?: number;
-    /**
-     * Number of top results to retrieve per query.
-     * @default 5
-     */
-    topK?: number;
-    /**
-     * Tool name visible to the AI model.
-     * @default "search_knowledge_base"
-     */
-    toolName?: string;
-    /**
-     * Tool description for the AI model explaining what the knowledge base contains.
-     * @default "Search the loaded documents for relevant information to answer the user's question"
-     */
-    toolDescription?: string;
-    /**
-     * Embedding model provider for generating embeddings.
-     * Defaults to the same provider used for generation.
-     */
-    embeddingProvider?: string;
-    /**
-     * Embedding model name.
-     * Defaults to the provider's default embedding model.
-     */
-    embeddingModel?: string;
-};
+export type { RAGConfig } from "../types/ragTypes.js";