@juspay/neurolink 7.36.0 → 7.37.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [7.37.0](https://github.com/juspay/neurolink/compare/v7.36.0...v7.37.0) (2025-09-10)
+
+### Features
+
+- **(sdk):** Add advanced orchestration of model and providers BZ-43839 ([840d697](https://github.com/juspay/neurolink/commit/840d697aa6ef3e5e4c511a9482fc7e80006d2534))
+
 ## [7.36.0](https://github.com/juspay/neurolink/compare/v7.35.0...v7.36.0) (2025-09-10)
 
 ### Features

package/dist/config/taskClassificationConfig.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Task Classification Configuration
+ * Contains patterns, keywords, and scoring weights for task classification
+ */
+/**
+ * Regular expression patterns that indicate fast response tasks
+ */
+export declare const FAST_PATTERNS: RegExp[];
+/**
+ * Regular expression patterns that indicate reasoning tasks
+ */
+export declare const REASONING_PATTERNS: RegExp[];
+/**
+ * Keywords that indicate fast tasks regardless of context
+ */
+export declare const FAST_KEYWORDS: string[];
+/**
+ * Keywords that indicate reasoning tasks regardless of context
+ */
+export declare const REASONING_KEYWORDS: string[];
+/**
+ * Scoring weights for different classification factors
+ */
+export declare const SCORING_WEIGHTS: {
+    readonly SHORT_PROMPT_BONUS: 2;
+    readonly LONG_PROMPT_BONUS: 1;
+    readonly PATTERN_MATCH_SCORE: 3;
+    readonly KEYWORD_MATCH_SCORE: 1;
+    readonly MULTIPLE_QUESTIONS_BONUS: 1;
+    readonly MULTI_SENTENCE_BONUS: 1;
+    readonly TECHNICAL_DOMAIN_BONUS: 1;
+    readonly SIMPLE_DEFINITION_BONUS: 2;
+};
+/**
+ * Classification thresholds and constraints
+ */
+export declare const CLASSIFICATION_THRESHOLDS: {
+    readonly SHORT_PROMPT_LENGTH: 50;
+    readonly LONG_PROMPT_LENGTH: 200;
+    readonly SIMPLE_DEFINITION_LENGTH: 100;
+    readonly MIN_CONFIDENCE: 0.6;
+    readonly MAX_CONFIDENCE: 0.95;
+    readonly DEFAULT_CONFIDENCE: 0.5;
+};
+/**
+ * Domain-specific patterns for enhanced classification
+ */
+export declare const DOMAIN_PATTERNS: {
+    readonly TECHNICAL: RegExp;
+    readonly SIMPLE_DEFINITION: RegExp;
+};

package/dist/config/taskClassificationConfig.js

@@ -0,0 +1,148 @@
+/**
+ * Task Classification Configuration
+ * Contains patterns, keywords, and scoring weights for task classification
+ */
+/**
+ * Regular expression patterns that indicate fast response tasks
+ */
+export const FAST_PATTERNS = [
+    // Greetings and social
+    /^(hi|hello|hey|good morning|good afternoon|good evening)/i,
+    /^(thanks?|thank you|thx)/i,
+    /^(yes|no|ok|okay|sure|fine)/i,
+    // Simple questions
+    /^what is\s+\w+\??$/i,
+    /^how are you/i,
+    /^tell me about\s+\w+$/i,
+    // Simple requests
+    /^(list|show|display)\s+/i,
+    /^give me\s+/i,
+    /^can you\s+(help|assist)/i,
+    // Simple definitions
+    /^define\s+/i,
+    /^meaning of\s+/i,
+    /^what does\s+\w+\s+mean/i,
+    // Quick facts
+    /^when (is|was|did)/i,
+    /^where (is|was)/i,
+    /^who (is|was)/i,
+    // Simple translations
+    /^translate\s+["'].*["']\s+to\s+\w+/i,
+    /^how do you say\s+/i,
+];
+/**
+ * Regular expression patterns that indicate reasoning tasks
+ */
+export const REASONING_PATTERNS = [
+    // Analysis and comparison
+    /\b(analyz|compar|evaluat|assess|examin)\w*/i,
+    /\b(pros and cons|advantages and disadvantages)/i,
+    /\b(better|worse|best|worst)\b.*\b(than|versus|vs)\b/i,
+    // Problem solving
+    /\b(solve|solution|problem|issue|challenge)\b/i,
+    /\b(how to|step by step|strategy|approach)\b/i,
+    /\b(optimize|improve|enhance|maximize|minimize)\b/i,
+    // Planning and design
+    /\b(plan|design|architect|structure|framework)\b/i,
+    /\b(implement|develop|build|create|construct)\b/i,
+    /\b(roadmap|timeline|schedule|phases)\b/i,
+    // Complex questions
+    /\b(why|explain|reason|cause|effect|impact)\b/i,
+    /\b(implications|consequences|considerations)\b/i,
+    /\b(should I|would you recommend|what if)\b/i,
+    // Research and investigation
+    /\b(research|investigate|explore|discover)\b/i,
+    /\b(evidence|proof|validate|verify)\b/i,
+    /\b(trends|patterns|insights|conclusions)\b/i,
+    // Business and strategy
+    /\b(business|strategy|market|competitive|financial)\b/i,
+    /\b(ROI|revenue|profit|investment|budget)\b/i,
+    /\b(stakeholder|customer|user experience|UX)\b/i,
+    // Technical complexity
+    /\b(algorithm|architecture|system|infrastructure)\b/i,
+    /\b(performance|scalability|security|reliability)\b/i,
+    /\b(integration|API|database|server)\b/i,
+];
+/**
+ * Keywords that indicate fast tasks regardless of context
+ */
+export const FAST_KEYWORDS = [
+    "quick",
+    "simple",
+    "brief",
+    "short",
+    "summary",
+    "overview",
+    "definition",
+    "meaning",
+    "list",
+    "show",
+    "display",
+    "name",
+    "tell",
+    "what",
+    "when",
+    "where",
+    "who",
+    "how many",
+    "count",
+];
+/**
+ * Keywords that indicate reasoning tasks regardless of context
+ */
+export const REASONING_KEYWORDS = [
+    "complex",
+    "detailed",
+    "comprehensive",
+    "thorough",
+    "in-depth",
+    "analyze",
+    "compare",
+    "evaluate",
+    "assess",
+    "research",
+    "investigate",
+    "strategy",
+    "plan",
+    "design",
+    "solve",
+    "optimize",
+    "recommend",
+    "explain",
+    "why",
+    "justify",
+    "pros",
+    "cons",
+    "trade-offs",
+];
+/**
+ * Scoring weights for different classification factors
+ */
+export const SCORING_WEIGHTS = {
+    SHORT_PROMPT_BONUS: 2,
+    LONG_PROMPT_BONUS: 1,
+    PATTERN_MATCH_SCORE: 3,
+    KEYWORD_MATCH_SCORE: 1,
+    MULTIPLE_QUESTIONS_BONUS: 1,
+    MULTI_SENTENCE_BONUS: 1,
+    TECHNICAL_DOMAIN_BONUS: 1,
+    SIMPLE_DEFINITION_BONUS: 2,
+};
+/**
+ * Classification thresholds and constraints
+ */
+export const CLASSIFICATION_THRESHOLDS = {
+    SHORT_PROMPT_LENGTH: 50,
+    LONG_PROMPT_LENGTH: 200,
+    SIMPLE_DEFINITION_LENGTH: 100,
+    MIN_CONFIDENCE: 0.6,
+    MAX_CONFIDENCE: 0.95,
+    DEFAULT_CONFIDENCE: 0.5,
+};
+/**
+ * Domain-specific patterns for enhanced classification
+ */
+export const DOMAIN_PATTERNS = {
+    TECHNICAL: /\b(code|programming|development|software)\b/i,
+    SIMPLE_DEFINITION: /\b(definition|meaning|what is)\b/i,
+};

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

@@ -0,0 +1,51 @@
+/**
+ * Task Classification Configuration
+ * Contains patterns, keywords, and scoring weights for task classification
+ */
+/**
+ * Regular expression patterns that indicate fast response tasks
+ */
+export declare const FAST_PATTERNS: RegExp[];
+/**
+ * Regular expression patterns that indicate reasoning tasks
+ */
+export declare const REASONING_PATTERNS: RegExp[];
+/**
+ * Keywords that indicate fast tasks regardless of context
+ */
+export declare const FAST_KEYWORDS: string[];
+/**
+ * Keywords that indicate reasoning tasks regardless of context
+ */
+export declare const REASONING_KEYWORDS: string[];
+/**
+ * Scoring weights for different classification factors
+ */
+export declare const SCORING_WEIGHTS: {
+    readonly SHORT_PROMPT_BONUS: 2;
+    readonly LONG_PROMPT_BONUS: 1;
+    readonly PATTERN_MATCH_SCORE: 3;
+    readonly KEYWORD_MATCH_SCORE: 1;
+    readonly MULTIPLE_QUESTIONS_BONUS: 1;
+    readonly MULTI_SENTENCE_BONUS: 1;
+    readonly TECHNICAL_DOMAIN_BONUS: 1;
+    readonly SIMPLE_DEFINITION_BONUS: 2;
+};
+/**
+ * Classification thresholds and constraints
+ */
+export declare const CLASSIFICATION_THRESHOLDS: {
+    readonly SHORT_PROMPT_LENGTH: 50;
+    readonly LONG_PROMPT_LENGTH: 200;
+    readonly SIMPLE_DEFINITION_LENGTH: 100;
+    readonly MIN_CONFIDENCE: 0.6;
+    readonly MAX_CONFIDENCE: 0.95;
+    readonly DEFAULT_CONFIDENCE: 0.5;
+};
+/**
+ * Domain-specific patterns for enhanced classification
+ */
+export declare const DOMAIN_PATTERNS: {
+    readonly TECHNICAL: RegExp;
+    readonly SIMPLE_DEFINITION: RegExp;
+};

package/dist/lib/config/taskClassificationConfig.js

@@ -0,0 +1,148 @@
+/**
+ * Task Classification Configuration
+ * Contains patterns, keywords, and scoring weights for task classification
+ */
+/**
+ * Regular expression patterns that indicate fast response tasks
+ */
+export const FAST_PATTERNS = [
+    // Greetings and social
+    /^(hi|hello|hey|good morning|good afternoon|good evening)/i,
+    /^(thanks?|thank you|thx)/i,
+    /^(yes|no|ok|okay|sure|fine)/i,
+    // Simple questions
+    /^what is\s+\w+\??$/i,
+    /^how are you/i,
+    /^tell me about\s+\w+$/i,
+    // Simple requests
+    /^(list|show|display)\s+/i,
+    /^give me\s+/i,
+    /^can you\s+(help|assist)/i,
+    // Simple definitions
+    /^define\s+/i,
+    /^meaning of\s+/i,
+    /^what does\s+\w+\s+mean/i,
+    // Quick facts
+    /^when (is|was|did)/i,
+    /^where (is|was)/i,
+    /^who (is|was)/i,
+    // Simple translations
+    /^translate\s+["'].*["']\s+to\s+\w+/i,
+    /^how do you say\s+/i,
+];
+/**
+ * Regular expression patterns that indicate reasoning tasks
+ */
+export const REASONING_PATTERNS = [
+    // Analysis and comparison
+    /\b(analyz|compar|evaluat|assess|examin)\w*/i,
+    /\b(pros and cons|advantages and disadvantages)/i,
+    /\b(better|worse|best|worst)\b.*\b(than|versus|vs)\b/i,
+    // Problem solving
+    /\b(solve|solution|problem|issue|challenge)\b/i,
+    /\b(how to|step by step|strategy|approach)\b/i,
+    /\b(optimize|improve|enhance|maximize|minimize)\b/i,
+    // Planning and design
+    /\b(plan|design|architect|structure|framework)\b/i,
+    /\b(implement|develop|build|create|construct)\b/i,
+    /\b(roadmap|timeline|schedule|phases)\b/i,
+    // Complex questions
+    /\b(why|explain|reason|cause|effect|impact)\b/i,
+    /\b(implications|consequences|considerations)\b/i,
+    /\b(should I|would you recommend|what if)\b/i,
+    // Research and investigation
+    /\b(research|investigate|explore|discover)\b/i,
+    /\b(evidence|proof|validate|verify)\b/i,
+    /\b(trends|patterns|insights|conclusions)\b/i,
+    // Business and strategy
+    /\b(business|strategy|market|competitive|financial)\b/i,
+    /\b(ROI|revenue|profit|investment|budget)\b/i,
+    /\b(stakeholder|customer|user experience|UX)\b/i,
+    // Technical complexity
+    /\b(algorithm|architecture|system|infrastructure)\b/i,
+    /\b(performance|scalability|security|reliability)\b/i,
+    /\b(integration|API|database|server)\b/i,
+];
+/**
+ * Keywords that indicate fast tasks regardless of context
+ */
+export const FAST_KEYWORDS = [
+    "quick",
+    "simple",
+    "brief",
+    "short",
+    "summary",
+    "overview",
+    "definition",
+    "meaning",
+    "list",
+    "show",
+    "display",
+    "name",
+    "tell",
+    "what",
+    "when",
+    "where",
+    "who",
+    "how many",
+    "count",
+];
+/**
+ * Keywords that indicate reasoning tasks regardless of context
+ */
+export const REASONING_KEYWORDS = [
+    "complex",
+    "detailed",
+    "comprehensive",
+    "thorough",
+    "in-depth",
+    "analyze",
+    "compare",
+    "evaluate",
+    "assess",
+    "research",
+    "investigate",
+    "strategy",
+    "plan",
+    "design",
+    "solve",
+    "optimize",
+    "recommend",
+    "explain",
+    "why",
+    "justify",
+    "pros",
+    "cons",
+    "trade-offs",
+];
+/**
+ * Scoring weights for different classification factors
+ */
+export const SCORING_WEIGHTS = {
+    SHORT_PROMPT_BONUS: 2,
+    LONG_PROMPT_BONUS: 1,
+    PATTERN_MATCH_SCORE: 3,
+    KEYWORD_MATCH_SCORE: 1,
+    MULTIPLE_QUESTIONS_BONUS: 1,
+    MULTI_SENTENCE_BONUS: 1,
+    TECHNICAL_DOMAIN_BONUS: 1,
+    SIMPLE_DEFINITION_BONUS: 2,
+};
+/**
+ * Classification thresholds and constraints
+ */
+export const CLASSIFICATION_THRESHOLDS = {
+    SHORT_PROMPT_LENGTH: 50,
+    LONG_PROMPT_LENGTH: 200,
+    SIMPLE_DEFINITION_LENGTH: 100,
+    MIN_CONFIDENCE: 0.6,
+    MAX_CONFIDENCE: 0.95,
+    DEFAULT_CONFIDENCE: 0.5,
+};
+/**
+ * Domain-specific patterns for enhanced classification
+ */
+export const DOMAIN_PATTERNS = {
+    TECHNICAL: /\b(code|programming|development|software)\b/i,
+    SIMPLE_DEFINITION: /\b(definition|meaning|what is)\b/i,
+};

package/dist/lib/neurolink.d.ts

@@ -62,6 +62,7 @@ export declare class NeuroLink {
     private conversationMemory?;
     private conversationMemoryNeedsInit;
     private conversationMemoryConfig?;
+    private enableOrchestration;
     /**
      * Creates a new NeuroLink instance for AI text generation with MCP tool integration.
      *
@@ -70,6 +71,7 @@ export declare class NeuroLink {
      * @param config.conversationMemory.enabled - Whether to enable conversation memory (default: false)
      * @param config.conversationMemory.maxSessions - Maximum number of concurrent sessions (default: 100)
      * @param config.conversationMemory.maxTurnsPerSession - Maximum conversation turns per session (default: 50)
+     * @param config.enableOrchestration - Whether to enable smart model orchestration (default: false)
      *
      * @example
      * ```typescript
@@ -84,6 +86,11 @@ export declare class NeuroLink {
      *     maxTurnsPerSession: 20
      *   }
      * });
+     *
+     * // With orchestration enabled
+     * const neurolink = new NeuroLink({
+     *   enableOrchestration: true
+     * });
      * ```
      *
      * @throws {Error} When provider registry setup fails
@@ -92,6 +99,7 @@ export declare class NeuroLink {
      */
     constructor(config?: {
         conversationMemory?: Partial<ConversationMemoryConfig>;
+        enableOrchestration?: boolean;
     });
     /**
      * Log constructor start with comprehensive environment analysis
@@ -158,6 +166,18 @@ export declare class NeuroLink {
      * Log MCP initialization completion
      */
     private logMCPInitComplete;
+    /**
+     * Apply orchestration to determine optimal provider and model
+     * @param options - Original GenerateOptions
+     * @returns Modified options with orchestrated provider marked in context, or empty object if validation fails
+     */
+    private applyOrchestration;
+    /**
+     * Apply orchestration to determine optimal provider and model for streaming
+     * @param options - Original StreamOptions
+     * @returns Modified options with orchestrated provider marked in context, or empty object if validation fails
+     */
+    private applyStreamOrchestration;
     /**
      * MAIN ENTRY POINT: Enhanced generate method with new function signature
      * Replaces both generateText and legacy methods