@juspay/neurolink 9.30.0 → 9.31.0

package/dist/client/types/hitlTypes.js

@@ -0,0 +1,8 @@
+/**
+ * HITL (Human-in-the-Loop) Type Definitions
+ *
+ * Comprehensive TypeScript interfaces for the HITL safety system.
+ * These types ensure type safety and provide clear contracts for
+ * all HITL-related functionality.
+ */
+export {};

package/dist/client/types/index.js

@@ -0,0 +1,57 @@
+/**
+ * Centralized type exports for NeuroLink
+ */
+// Constants and enums
+export { AIProviderName } from "../constants/enums.js";
+// CLI types
+export * from "./cli.js";
+// Common utility types
+export * from "./common.js";
+// Provider types
+export * from "./providers.js";
+// Task classification types
+export * from "./taskClassificationTypes.js";
+// Tool system types
+export * from "./tools.js";
+export { PROCESSOR_PRIORITIES } from "../processors/base/types.js";
+// Content types for multimodal support (includes multimodal re-exports for backward compatibility)
+export * from "./content.js";
+// Evaluation types - NEW
+export * from "./evaluation.js";
+// Evaluation provider types - NEW
+export * from "./evaluationProviders.js";
+// File detection and processing types
+export * from "./fileTypes.js";
+// HITL (Human-in-the-Loop) types
+export * from "./hitlTypes.js";
+// Middleware Types - Middleware system types
+export * from "./middlewareTypes.js";
+// Model types - NEW
+export * from "./modelTypes.js";
+// SDK Types - Core types for external developers
+// Note: sdkTypes.ts uses selective re-exports internally, so we use wildcard here
+// The conflicts were from generateTypes and analytics which are now handled above
+export * from "./sdkTypes.js";
+// Service types - NEW
+export * from "./serviceTypes.js";
+// TTS (Text-to-Speech) types
+export * from "./ttsTypes.js";
+// Utilities Types - Utility module types (selective export to avoid conflicts)
+export * from "./utilities.js";
+// Workflow types
+export * from "./workflowTypes.js";
+// Context compaction types
+export * from "./contextTypes.js";
+// File reference types
+export * from "./fileReferenceTypes.js";
+// RAG types
+export * from "./ragTypes.js";
+// Conversation memory manager type
+export * from "./conversationMemoryInterface.js";
+// Subscription types (Claude subscription tiers, authentication, usage tracking)
+// NOTE: subscriptionTypes.ts re-exports auth types from ./authTypes.ts for
+// backward compatibility. Import StoredOAuthTokens, TokenRefresher, etc.
+// from authTypes.ts for new code.
+export * from "./subscriptionTypes.js";
+// Proxy types (Claude API format, cloaking, routing, config, stats, server adapters)
+export * from "./proxyTypes.js";

package/dist/client/types/mcpTypes.js

@@ -0,0 +1,5 @@
+/**
+ * MCP Types for In-Memory Server Support
+ * Enables various integrations to register tools directly
+ */
+export {};

package/dist/client/types/middlewareTypes.js

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

package/dist/client/types/modelTypes.js

@@ -0,0 +1,30 @@
+/**
+ * Model-related type definitions for NeuroLink
+ * Consolidates all model configuration, dynamic model, and provider model types
+ */
+import { z } from "zod";
+/**
+ * Zod schema for model configuration validation
+ */
+export const ModelConfigSchema = z.object({
+    id: z.string(),
+    displayName: z.string(),
+    capabilities: z.array(z.string()),
+    deprecated: z.boolean(),
+    pricing: z.object({
+        input: z.number(),
+        output: z.number(),
+    }),
+    contextWindow: z.number(),
+    releaseDate: z.string(),
+});
+/**
+ * Zod schema for model registry validation
+ */
+export const ModelRegistrySchema = z.object({
+    version: z.string(),
+    lastUpdated: z.string(),
+    models: z.record(z.string(), z.record(z.string(), ModelConfigSchema)),
+    aliases: z.record(z.string(), z.string()).optional(),
+    defaults: z.record(z.string(), z.string()).optional(),
+});

package/dist/client/types/multimodal.js

@@ -0,0 +1,135 @@
+/**
+ * Multimodal Content Types for NeuroLink
+ *
+ * Central registry for all multimodal input/output types.
+ * This file consolidates types from content.ts and conversation.ts
+ * to provide a single source of truth for multimodal functionality.
+ *
+ * @module types/multimodal
+ *
+ * @example Basic Multimodal Input
+ * ```typescript
+ * import type { MultimodalInput } from './types/multimodal.js';
+ *
+ * const input: MultimodalInput = {
+ *   text: "What's in this image?",
+ *   images: [imageBuffer, "https://example.com/image.jpg"],
+ *   pdfFiles: [pdfBuffer]
+ * };
+ * ```
+ *
+ * @example Audio/Video Input (Future)
+ * ```typescript
+ * const avInput: MultimodalInput = {
+ *   text: "Transcribe this audio and analyze this video",
+ *   audioFiles: [audioBuffer],
+ *   videoFiles: ["path/to/video.mp4"]
+ * };
+ * ```
+ *
+ * @example Advanced Content Array
+ * ```typescript
+ * const advanced: MultimodalInput = {
+ *   text: "irrelevant", // ignored when content[] is provided
+ *   content: [
+ *     { type: "text", text: "Analyze these items:" },
+ *     { type: "image", data: imageBuffer, mediaType: "image/jpeg" },
+ *     { type: "pdf", data: pdfBuffer, metadata: { filename: "report.pdf" } }
+ *   ]
+ * };
+ * ```
+ */
+// ============================================
+// TYPE GUARDS
+// ============================================
+/**
+ * Type guard to check if content is TextContent
+ */
+export function isTextContent(content) {
+    return content.type === "text";
+}
+/**
+ * Type guard to check if content is ImageContent
+ */
+export function isImageContent(content) {
+    return content.type === "image";
+}
+/**
+ * Type guard to check if content is CSVContent
+ */
+export function isCSVContent(content) {
+    return content.type === "csv";
+}
+/**
+ * Type guard to check if content is PDFContent
+ */
+export function isPDFContent(content) {
+    return content.type === "pdf";
+}
+/**
+ * Type guard to check if content is AudioContent
+ */
+export function isAudioContent(content) {
+    return content.type === "audio";
+}
+/**
+ * Type guard to check if content is VideoContent
+ */
+export function isVideoContent(content) {
+    return content.type === "video";
+}
+/**
+ * Type guard to check if input contains multimodal content
+ * Now includes audio and video detection
+ */
+/**
+ * Type guard to validate if an object matches the DirectorSegment shape.
+ * Checks for required prompt (string) and image (Buffer, string, or ImageWithAltText).
+ */
+function isDirectorSegment(segment) {
+    if (!segment || typeof segment !== "object") {
+        return false;
+    }
+    const maybeSegment = segment;
+    // Check for required prompt field
+    if (typeof maybeSegment.prompt !== "string" || !maybeSegment.prompt) {
+        return false;
+    }
+    // Check for required image field
+    const { image } = maybeSegment;
+    if (!image) {
+        return false;
+    }
+    // Validate image type: Buffer, string (URL/path), or ImageWithAltText
+    if (Buffer.isBuffer(image)) {
+        return true;
+    }
+    if (typeof image === "string") {
+        return true;
+    }
+    // Check for ImageWithAltText structure
+    if (typeof image === "object" && "data" in image) {
+        const imgData = image.data;
+        return Buffer.isBuffer(imgData) || typeof imgData === "string";
+    }
+    return false;
+}
+export function isMultimodalInput(input) {
+    const maybeInput = input;
+    return !!(maybeInput?.images?.length ||
+        maybeInput?.csvFiles?.length ||
+        maybeInput?.pdfFiles?.length ||
+        maybeInput?.files?.length ||
+        maybeInput?.content?.length ||
+        maybeInput?.audioFiles?.length ||
+        maybeInput?.videoFiles?.length ||
+        (maybeInput?.segments?.length &&
+            Array.isArray(maybeInput.segments) &&
+            maybeInput.segments.every(isDirectorSegment)));
+}
+/**
+ * Type guard to check if message content is multimodal (array)
+ */
+export function isMultimodalMessageContent(content) {
+    return Array.isArray(content);
+}

package/dist/client/types/observability.js

@@ -0,0 +1,6 @@
+/**
+ * Observability Configuration Types
+ * These configs are passed from the parent application (e.g., Lighthouse)
+ * to enable telemetry and observability features in Neurolink SDK
+ */
+export {};

package/dist/client/types/pptTypes.js

@@ -0,0 +1,82 @@
+/**
+ * PPT Generation Types
+ *
+ * All types for presentation generation - both external API types and internal pipeline types.
+ * Used by the content planner, slide generator, and orchestrator.
+ *
+ * Architecture:
+ * - PPTOutputOptions / PPTGenerationResult: External API types (GenerateOptions.output.ppt)
+ * - SlideSchema / ContentPlan: Content planning pipeline types
+ * - CompleteSlide / PPTGenerationContext: Generation context types
+ * - PPTError: Error handling (follows VideoError pattern)
+ */
+import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
+import { NeuroLinkError } from "../utils/errorHandling.js";
+// ============================================================================
+// ERROR TYPES (Following VideoError pattern from vertexVideoHandler.ts)
+// ============================================================================
+/**
+ * PPT generation error codes
+ * Following the VIDEO_ERROR_CODES pattern
+ */
+export const PPT_ERROR_CODES = {
+    /** Content planning AI call failed */
+    PLANNING_FAILED: "PPT_PLANNING_FAILED",
+    /** AI returned invalid/unparseable response */
+    INVALID_AI_RESPONSE: "PPT_INVALID_AI_RESPONSE",
+    /** Image generation for slide failed */
+    IMAGE_GENERATION_FAILED: "PPT_IMAGE_GENERATION_FAILED",
+    /** PPTX file assembly failed */
+    ASSEMBLY_FAILED: "PPT_ASSEMBLY_FAILED",
+    /** File system write failed */
+    FILE_WRITE_FAILED: "PPT_FILE_WRITE_FAILED",
+    /** Invalid input options */
+    INVALID_INPUT: "PPT_INVALID_INPUT",
+    /** Generation timeout */
+    TIMEOUT: "PPT_TIMEOUT",
+};
+/**
+ * PPT generation error class
+ * Extends NeuroLinkError for consistent error handling (follows VideoError pattern)
+ */
+export class PPTError extends NeuroLinkError {
+    constructor(message, code, context, originalError) {
+        super({
+            code,
+            message,
+            category: ErrorCategory.EXECUTION,
+            severity: ErrorSeverity.HIGH,
+            retriable: false,
+            context: {
+                ...context,
+                originalMessage: originalError?.message,
+            },
+            originalError,
+        });
+        this.name = "PPTError";
+    }
+}
+// ============================================================================
+// VALIDATION CONSTANTS
+// ============================================================================
+/** Minimum number of slides allowed */
+export const MIN_SLIDES = 5;
+/** Maximum number of slides allowed */
+export const MAX_SLIDES = 50;
+/** Slide dimensions in inches by aspect ratio */
+export const SLIDE_DIMENSIONS = {
+    "16:9": { width: 10, height: 5.625 },
+    "4:3": { width: 10, height: 7.5 },
+};
+/**
+ * Validate a hex color string (6 hex characters, no # prefix).
+ */
+export function isValidHexColor(color) {
+    return /^[0-9A-Fa-f]{6}$/.test(color);
+}
+/**
+ * Normalize a hex color by stripping leading # if present.
+ */
+export function normalizeHexColor(color) {
+    return color.startsWith("#") ? color.slice(1) : color;
+}

package/dist/client/types/providers.js

@@ -0,0 +1,111 @@
+/**
+ * Provider-specific type definitions for NeuroLink
+ */
+import { AIProviderName, AnthropicModels, BedrockModels, GoogleAIModels, OpenAIModels, VertexModels, } from "../constants/enums.js";
+/**
+ * Type guard to check if a configuration is an AnthropicProviderConfig
+ *
+ * @param config - The configuration object to check
+ * @returns True if the configuration is an AnthropicProviderConfig
+ *
+ * @example
+ * ```typescript
+ * const config = getProviderConfig();
+ * if (isAnthropicConfig(config)) {
+ *   // TypeScript knows config is AnthropicProviderConfig here
+ *   console.log(config.subscriptionTier);
+ *   console.log(config.oauthConfig?.clientId);
+ * }
+ * ```
+ */
+export function isAnthropicConfig(config) {
+    if (config === null || config === undefined) {
+        return false;
+    }
+    if (typeof config !== "object") {
+        return false;
+    }
+    const configObj = config;
+    // Check for Anthropic-specific properties
+    // A config is considered Anthropic if it has:
+    // 1. An authMethod that is a valid AnthropicAuthMethod, OR
+    // 2. A subscriptionTier that is a valid ClaudeSubscriptionTier, OR
+    // 3. An oauthConfig object
+    const validAuthMethods = ["api_key", "oauth"];
+    const validSubscriptionTiers = [
+        "free",
+        "pro",
+        "max",
+        "max_5",
+        "max_20",
+        "api",
+    ];
+    // Check for authMethod
+    if (configObj.authMethod !== undefined &&
+        typeof configObj.authMethod === "string" &&
+        validAuthMethods.includes(configObj.authMethod)) {
+        return true;
+    }
+    // Check for subscriptionTier
+    if (configObj.subscriptionTier !== undefined &&
+        typeof configObj.subscriptionTier === "string" &&
+        validSubscriptionTiers.includes(configObj.subscriptionTier)) {
+        return true;
+    }
+    // Check for oauthConfig
+    if (configObj.oauthConfig !== undefined &&
+        typeof configObj.oauthConfig === "object" &&
+        configObj.oauthConfig !== null) {
+        return true;
+    }
+    // Check for authConfig (AnthropicAuthConfig)
+    if (configObj.authConfig !== undefined &&
+        typeof configObj.authConfig === "object" &&
+        configObj.authConfig !== null) {
+        const authConfig = configObj.authConfig;
+        if (authConfig.method !== undefined &&
+            typeof authConfig.method === "string" &&
+            validAuthMethods.includes(authConfig.method)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Default model aliases for easy reference
+ */
+export const DEFAULT_MODEL_ALIASES = {
+    // Latest recommended models per provider
+    LATEST_OPENAI: OpenAIModels.GPT_4O,
+    FASTEST_OPENAI: OpenAIModels.GPT_4O_MINI,
+    LATEST_ANTHROPIC: AnthropicModels.CLAUDE_3_5_SONNET,
+    FASTEST_ANTHROPIC: AnthropicModels.CLAUDE_3_5_HAIKU,
+    LATEST_GOOGLE: GoogleAIModels.GEMINI_2_5_PRO,
+    FASTEST_GOOGLE: GoogleAIModels.GEMINI_2_5_FLASH,
+    // Best models by use case
+    BEST_CODING: AnthropicModels.CLAUDE_3_5_SONNET,
+    BEST_ANALYSIS: GoogleAIModels.GEMINI_2_5_PRO,
+    BEST_CREATIVE: AnthropicModels.CLAUDE_3_5_SONNET,
+    BEST_VALUE: GoogleAIModels.GEMINI_2_5_FLASH,
+};
+/**
+ * @deprecated Use DEFAULT_MODEL_ALIASES instead. Will be removed in future version.
+ */
+export const ModelAliases = DEFAULT_MODEL_ALIASES;
+/**
+ * Default provider configurations
+ */
+export const DEFAULT_PROVIDER_CONFIGS = [
+    {
+        provider: AIProviderName.BEDROCK,
+        models: [BedrockModels.CLAUDE_3_7_SONNET, BedrockModels.CLAUDE_3_5_SONNET],
+    },
+    {
+        provider: AIProviderName.VERTEX,
+        models: [VertexModels.CLAUDE_4_0_SONNET, VertexModels.GEMINI_2_5_FLASH],
+    },
+    {
+        provider: AIProviderName.OPENAI,
+        models: [OpenAIModels.GPT_4O, OpenAIModels.GPT_4O_MINI],
+    },
+];

package/dist/client/types/proxyTypes.js

@@ -0,0 +1,16 @@
+/**
+ * Proxy type definitions for NeuroLink
+ *
+ * Consolidates all proxy-related types from:
+ * - src/lib/proxy/claudeFormat.ts (Claude API types, SSE types, internal result)
+ * - src/lib/proxy/cloaking/types.ts (cloaking pipeline types)
+ * - src/lib/proxy/cloaking/plugins/ (plugin option types)
+ * - src/lib/proxy/modelRouter.ts (routing types)
+ * - src/lib/proxy/proxyConfig.ts (config file types)
+ * - src/lib/proxy/requestLogger.ts (log entry type)
+ * - src/lib/proxy/usageStats.ts (stats types)
+ * - src/lib/proxy/tokenRefresh.ts (refresh types)
+ * - src/lib/proxy/accountQuota.ts (quota type)
+ * - src/lib/server/routes/claudeProxyRoutes.ts (runtime state, deps)
+ */
+export {};

package/dist/client/types/ragTypes.js

@@ -0,0 +1,7 @@
+/**
+ * RAG Type Definitions
+ *
+ * Canonical type file for all RAG (Retrieval-Augmented Generation) interfaces.
+ * All exported interfaces from src/lib/rag/ are collected here as type aliases.
+ */
+export {};

package/dist/client/types/sdkTypes.js

@@ -0,0 +1,8 @@
+/**
+ * NeuroLink SDK Core Types
+ *
+ * This file exposes ALL essential types that external developers need
+ * when integrating with the NeuroLink SDK. Maximum type exposure for
+ * comprehensive TypeScript support across the NeuroLink ecosystem.
+ */
+export {};

package/dist/client/types/serviceTypes.js

@@ -0,0 +1,5 @@
+/**
+ * Service-related type definitions for NeuroLink
+ * Service registry, dependency injection, and service management types
+ */
+export {};

package/dist/client/types/streamTypes.js

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

package/dist/client/types/subscriptionTypes.js

@@ -0,0 +1,9 @@
+/**
+ * Claude Subscription Types for NeuroLink
+ *
+ * Type definitions for Claude subscription tiers, authentication methods,
+ * and usage tracking for Anthropic API access.
+ */
+export {};
+// TokenStorageData and StoredProviderTokens are now in authTypes.ts and
+// re-exported at the top of this file for backward compatibility.

package/dist/client/types/taskClassificationTypes.js

@@ -0,0 +1,5 @@
+/**
+ * Task Classification Types
+ * Type definitions for the task classification system
+ */
+export {};

package/dist/client/types/tools.js

@@ -0,0 +1,24 @@
+/**
+ * Type definitions for NeuroLink tool system, including parameter schemas,
+ * argument patterns, execution metadata, context, and result types.
+ */
+/**
+ * Type guard for tool result
+ */
+export function isToolResult(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "success" in value &&
+        typeof value.success === "boolean");
+}
+/**
+ * Type guard for tool definition
+ */
+export function isToolDefinition(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "description" in value &&
+        "execute" in value &&
+        typeof value.description === "string" &&
+        typeof value.execute === "function");
+}

package/dist/client/types/ttsTypes.js

@@ -0,0 +1,57 @@
+/**
+ * Text-to-Speech (TTS) Type Definitions for NeuroLink
+ *
+ * This module defines types for TTS audio generation and output.
+ *
+ * @module types/ttsTypes
+ */
+/** Valid audio formats as an array for runtime validation */
+export const VALID_AUDIO_FORMATS = [
+    "mp3",
+    "wav",
+    "ogg",
+    "opus",
+];
+/** Valid TTS quality levels as an array for runtime validation */
+export const VALID_TTS_QUALITIES = ["standard", "hd"];
+/**
+ * Type guard to check if an object is a TTSResult
+ */
+export function isTTSResult(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const obj = value;
+    return (Buffer.isBuffer(obj.buffer) &&
+        typeof obj.format === "string" &&
+        VALID_AUDIO_FORMATS.includes(obj.format) &&
+        typeof obj.size === "number" &&
+        obj.size >= 0);
+}
+/**
+ * Type guard to check if TTSOptions are valid
+ */
+export function isValidTTSOptions(options) {
+    if (!options || typeof options !== "object") {
+        return false;
+    }
+    const opts = options;
+    if (opts.speed !== undefined) {
+        if (typeof opts.speed !== "number" ||
+            opts.speed < 0.25 ||
+            opts.speed > 4.0) {
+            return false;
+        }
+    }
+    if (opts.format !== undefined) {
+        if (!VALID_AUDIO_FORMATS.includes(opts.format)) {
+            return false;
+        }
+    }
+    if (opts.quality !== undefined) {
+        if (!VALID_TTS_QUALITIES.includes(opts.quality)) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/client/types/typeAliases.js

@@ -0,0 +1,48 @@
+/**
+ * Comprehensive Type Alias Library
+ * Centralizes commonly used complex types to improve readability and maintainability
+ */
+// ============================================================================
+// TYPE GUARDS AND UTILITIES
+// ============================================================================
+/**
+ * Type guard for checking if value is a StandardRecord
+ *
+ * @param value - Value to check
+ * @returns True if value is a non-null object (but not an array)
+ *
+ * @example
+ * ```typescript
+ * if (isStandardRecord(data)) {
+ *   // TypeScript now knows data is Record<string, unknown>
+ *   console.log(data.someProperty);
+ * }
+ * ```
+ */
+export function isStandardRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Type guard for checking if value is a JsonRecord
+ */
+export function isJsonRecord(value) {
+    return (isStandardRecord(value) &&
+        Object.values(value).every((val) => val === null ||
+            typeof val === "string" ||
+            typeof val === "number" ||
+            typeof val === "boolean" ||
+            Array.isArray(val) ||
+            isJsonRecord(val)));
+}
+/**
+ * Type guard for checking if value is a StringArray
+ */
+export function isStringArray(value) {
+    return (Array.isArray(value) && value.every((item) => typeof item === "string"));
+}
+/**
+ * Type guard for checking if value is an AsyncFunction
+ */
+export function isAsyncFunction(value) {
+    return typeof value === "function";
+}

package/dist/client/types/utilities.js

@@ -0,0 +1,4 @@
+/**
+ * Utility module types - extracted from utils module files
+ */
+export {};

package/dist/client/types/workflowTypes.js

@@ -0,0 +1,30 @@
+/**
+ * types/workflowTypes.ts
+ * Core type definitions for the Workflow Engine
+ *
+ * Testing Phase: Focuses on original output + evaluation metrics for AB testing
+ */
+/**
+ * Workflow execution error class
+ */
+export class WorkflowError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.name = "WorkflowError";
+        this.details = details;
+        // Maintain proper stack trace for V8 engines
+        if ("captureStackTrace" in Error &&
+            typeof Error.captureStackTrace === "function") {
+            Error.captureStackTrace(this, WorkflowError);
+        }
+    }
+}
+// ============================================================================
+// TYPE ALIASES FOR BACKWARD COMPATIBILITY (internal to workflow module only)
+// ============================================================================
+// Note: ModelConfig and EvaluationData aliases are NOT exported from this file
+// to avoid conflicts with modelTypes.ModelConfig and evaluation.EvaluationData.
+// Use WorkflowModelConfig and WorkflowEvaluationData when importing from this file.
+// The workflow/types.ts re-exports these aliases for backward compatibility
+// within the workflow module only.