@juspay/neurolink 9.3.0 → 9.5.0

package/dist/lib/workflow/core/responseConditioner.js

@@ -0,0 +1,226 @@
+/**
+ * workflow/core/responseConditioner.ts
+ * Response conditioning and synthesis
+ *
+ * Uses judge feedback and ensemble responses to synthesize an improved final response.
+ * Combines strengths from multiple responses based on evaluation insights.
+ */
+import { logger } from "../../utils/logger.js";
+import { AIProviderFactory } from "../../core/factory.js";
+const functionTag = "ResponseConditioner";
+// ============================================================================
+// CONDITIONING FUNCTIONS
+// ============================================================================
+/**
+ * Condition response by synthesizing improved version using judge feedback
+ *
+ * @param options - Conditioning options including all responses and judge feedback
+ * @returns Conditioned result with synthesized improved content
+ */
+export async function conditionResponse(options) {
+    const startTime = Date.now();
+    const { content, selectedResponse, allResponses, judgeScores, config, originalPrompt, } = options;
+    logger.debug(`[${functionTag}] Conditioning response with synthesis`, {
+        originalLength: content.length,
+        provider: selectedResponse.provider,
+        model: selectedResponse.model,
+        hasConfig: !!config,
+        numResponses: allResponses?.length || 0,
+    });
+    // Check if conditioning is enabled
+    if (!config || !config.useConfidence) {
+        logger.debug(`[${functionTag}] Conditioning disabled, returning original`);
+        return {
+            content,
+            conditioningTime: Date.now() - startTime,
+            metadata: {
+                conditioningApplied: false,
+                originalLength: content.length,
+                finalLength: content.length,
+            },
+        };
+    }
+    // If synthesis model not configured, fall back to original with metadata
+    if (!config.synthesisModel) {
+        logger.debug(`[${functionTag}] No synthesis model configured, returning original with metadata`);
+        return addMetadataOnly(content, selectedResponse, judgeScores, config, startTime);
+    }
+    try {
+        // Synthesize improved response using LLM
+        const synthesizedContent = await synthesizeImprovedResponse(content, allResponses, judgeScores, originalPrompt, config);
+        const conditioningTime = Date.now() - startTime;
+        logger.debug(`[${functionTag}] Response synthesized successfully`, {
+            conditioningTime,
+            originalLength: content.length,
+            finalLength: synthesizedContent.length,
+            improvement: synthesizedContent.length - content.length,
+        });
+        return {
+            content: synthesizedContent,
+            conditioningTime,
+            metadata: {
+                conditioningApplied: true,
+                originalLength: content.length,
+                finalLength: synthesizedContent.length,
+                confidenceStatementAdded: false,
+                modelAttributionAdded: false,
+                executionTimeAdded: false,
+                synthesisApplied: true,
+            },
+        };
+    }
+    catch (error) {
+        logger.warn(`[${functionTag}] Synthesis failed, falling back to original`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        // Fall back to original with metadata
+        return addMetadataOnly(content, selectedResponse, judgeScores, config, startTime);
+    }
+}
+/**
+ * Check if conditioning is enabled
+ * @param config - Conditioning configuration
+ * @returns True if conditioning should be applied
+ */
+export function isConditioningEnabled(config) {
+    return config?.useConfidence === true;
+}
+// ============================================================================
+// SYNTHESIS FUNCTIONS
+// ============================================================================
+/**
+ * Synthesize improved response using judge feedback and all ensemble responses
+ */
+async function synthesizeImprovedResponse(bestContent, allResponses, judgeScores, originalPrompt, config) {
+    const reasoning = judgeScores?.reasoning || "No specific feedback available";
+    // Build synthesis prompt
+    const synthesisPrompt = `You are a response synthesis expert. Your task is to create an improved, higher-quality response by combining the best elements from multiple AI-generated responses.
+
+ORIGINAL USER PROMPT:
+${originalPrompt || "Not provided"}
+
+JUDGE'S EVALUATION:
+${reasoning}
+
+AVAILABLE RESPONSES:
+${allResponses
+        .filter((r) => r.status === "success" && r.content)
+        .map((r, i) => `
+Response ${i + 1} (${r.provider}/${r.model}):
+${r.content}
+`)
+        .join("\n---\n")}
+
+BEST RESPONSE (Selected by Judge):
+${bestContent}
+
+YOUR TASK:
+Synthesize an improved final response that:
+1. Incorporates the judge's feedback and addresses any identified weaknesses
+2. Combines the strongest elements from all responses
+3. Maintains accuracy and technical correctness
+4. Improves clarity, completeness, and overall quality
+5. Maintains the same tone and format as the original responses
+6. Does NOT add meta-commentary, disclaimers, or explanatory notes
+7. Provides a direct, polished answer to the user's original question
+
+Output ONLY the synthesized response, nothing else.`;
+    logger.debug(`[${functionTag}] Calling synthesis model`, {
+        model: config?.synthesisModel?.model || "default",
+        provider: config?.synthesisModel?.provider || "default",
+    });
+    // Create provider for synthesis using AIProviderFactory
+    const synthesisProvider = config?.synthesisModel?.provider || "azure";
+    const synthesisModel = config?.synthesisModel?.model || "gpt-4o";
+    const provider = await AIProviderFactory.createProvider(synthesisProvider, synthesisModel);
+    // Generate improved response
+    const result = await provider.generate({
+        prompt: synthesisPrompt,
+        temperature: config?.synthesisModel?.temperature || 0.3,
+        maxTokens: 2000,
+        timeout: 30000,
+    });
+    if (!result || !result.content) {
+        throw new Error("Synthesis model returned empty response");
+    }
+    return result.content.trim();
+}
+/**
+ * Fallback: Add metadata only (original behavior)
+ */
+function addMetadataOnly(content, selectedResponse, judgeScores, config, startTime) {
+    let conditionedContent = content;
+    // Add confidence statement if enabled
+    if (config.addConfidenceStatement && judgeScores) {
+        const confidenceLevel = getConfidenceLevel(judgeScores.confidenceInJudgment || 0.5, config);
+        conditionedContent = addConfidenceStatement(conditionedContent, confidenceLevel, judgeScores.confidenceInJudgment || 0.5);
+    }
+    // Add model attribution if enabled
+    if (config.addModelAttribution) {
+        conditionedContent = addModelAttribution(conditionedContent, selectedResponse.provider, selectedResponse.model, judgeScores);
+    }
+    // Add execution time if enabled
+    if (config.addExecutionTime) {
+        conditionedContent = addExecutionMetrics(conditionedContent, selectedResponse.responseTime);
+    }
+    const conditioningTime = Date.now() - startTime;
+    return {
+        content: conditionedContent,
+        conditioningTime,
+        metadata: {
+            conditioningApplied: true,
+            originalLength: content.length,
+            finalLength: conditionedContent.length,
+            confidenceStatementAdded: config.addConfidenceStatement,
+            modelAttributionAdded: config.addModelAttribution,
+            executionTimeAdded: config.addExecutionTime,
+        },
+    };
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Determine confidence level from score
+ */
+function getConfidenceLevel(confidence, config) {
+    const thresholds = config.confidenceThresholds || {
+        high: 0.8,
+        medium: 0.5,
+        low: 0.3,
+    };
+    if (confidence >= thresholds.high) {
+        return "high";
+    }
+    if (confidence >= thresholds.medium) {
+        return "medium";
+    }
+    return "low";
+}
+/**
+ * Add confidence statement to response
+ */
+function addConfidenceStatement(content, level, score) {
+    const statements = {
+        high: `\n\n---\n**Quality Assurance:** This response achieved a high confidence score (${(score * 100).toFixed(0)}%) through multi-model evaluation. The content has been validated for accuracy and completeness.`,
+        medium: `\n\n---\n**Quality Note:** This response received a moderate confidence score (${(score * 100).toFixed(0)}%) from the evaluation system. Consider cross-referencing critical details.`,
+        low: `\n\n---\n**Advisory:** This response has a lower confidence score (${(score * 100).toFixed(0)}%). Please verify important information independently.`,
+    };
+    return content + statements[level];
+}
+/**
+ * Add model attribution
+ */
+function addModelAttribution(content, provider, model, judgeScores) {
+    const score = Object.values(judgeScores?.scores || {}).reduce((max, curr) => Math.max(max, curr), 0);
+    return (content +
+        `\n\n---\n**Source:** Generated by ${provider}/${model} | Evaluation Score: ${score}/100`);
+}
+/**
+ * Add execution metrics
+ */
+function addExecutionMetrics(content, responseTime) {
+    return (content +
+        `\n\n---\n**Performance:** Response generated in ${responseTime}ms`);
+}
+//# sourceMappingURL=responseConditioner.js.map

package/dist/lib/workflow/core/types/conditionerTypes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * workflow/core/types/conditionerTypes.ts
+ * Type definitions for response conditioning
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export type { ConditionOptions, ConditionResult, } from "../../../types/workflowTypes.js";

package/dist/lib/workflow/core/types/conditionerTypes.js

@@ -0,0 +1,8 @@
+/**
+ * workflow/core/types/conditionerTypes.ts
+ * Type definitions for response conditioning
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export {};
+//# sourceMappingURL=conditionerTypes.js.map

package/dist/lib/workflow/core/types/ensembleTypes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * workflow/core/types/ensembleTypes.ts
+ * Type definitions for ensemble execution
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export type { ExecuteEnsembleOptions, EnsembleExecutionResult, ExecuteModelOptions, } from "../../../types/workflowTypes.js";

package/dist/lib/workflow/core/types/ensembleTypes.js

@@ -0,0 +1,8 @@
+/**
+ * workflow/core/types/ensembleTypes.ts
+ * Type definitions for ensemble execution
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export {};
+//# sourceMappingURL=ensembleTypes.js.map

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

@@ -0,0 +1,7 @@
+/**
+ * workflow/core/types/index.ts
+ * Centralized export for all workflow core types
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export type { ConditionOptions, ConditionResult, EnsembleExecutionResult, ExecuteEnsembleOptions, ExecuteModelOptions, ParsedJudgeResponse, ScoreOptions, ScoreResult, ExecuteLayerOptions, LayerExecutionResult, ListOptions, RegisterOptions, RegisterResult, RegistryEntry, RegistryStats, WorkflowMetadata, } from "../../../types/workflowTypes.js";

package/dist/lib/workflow/core/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * workflow/core/types/index.ts
+ * Centralized export for all workflow core types
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/lib/workflow/core/types/judgeTypes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * workflow/core/types/judgeTypes.ts
+ * Type definitions for judge scoring
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export type { ScoreOptions, ScoreResult, ParsedJudgeResponse, } from "../../../types/workflowTypes.js";

package/dist/lib/workflow/core/types/judgeTypes.js

@@ -0,0 +1,8 @@
+/**
+ * workflow/core/types/judgeTypes.ts
+ * Type definitions for judge scoring
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export {};
+//# sourceMappingURL=judgeTypes.js.map

package/dist/lib/workflow/core/types/layerTypes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * workflow/core/types/layerTypes.ts
+ * Type definitions for layer-based execution
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export type { LayerExecutionResult, ExecuteLayerOptions, } from "../../../types/workflowTypes.js";

package/dist/lib/workflow/core/types/layerTypes.js

@@ -0,0 +1,8 @@
+/**
+ * workflow/core/types/layerTypes.ts
+ * Type definitions for layer-based execution
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export {};
+//# sourceMappingURL=layerTypes.js.map

package/dist/lib/workflow/core/types/registryTypes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * workflow/core/types/registryTypes.ts
+ * Type definitions for workflow registry
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export type { RegistryEntry, RegisterOptions, RegisterResult, ListOptions, WorkflowMetadata, RegistryStats, } from "../../../types/workflowTypes.js";

package/dist/lib/workflow/core/types/registryTypes.js

@@ -0,0 +1,8 @@
+/**
+ * workflow/core/types/registryTypes.ts
+ * Type definitions for workflow registry
+ *
+ * Re-exports from the central types folder for backward compatibility
+ */
+export {};
+//# sourceMappingURL=registryTypes.js.map

package/dist/lib/workflow/core/workflowRegistry.d.ts

@@ -0,0 +1,73 @@
+/**
+ * workflow/core/workflowRegistry.ts
+ * Registry for managing workflow configurations
+ */
+import type { WorkflowConfig } from "../types.js";
+import type { ListOptions, RegisterOptions, RegisterResult, RegistryStats, WorkflowMetadata } from "./types/index.js";
+/**
+ * Register a new workflow
+ * @param config - Workflow configuration to register
+ * @param options - Registration options
+ * @returns Registration result
+ */
+export declare function registerWorkflow(config: WorkflowConfig, options?: RegisterOptions): RegisterResult;
+/**
+ * Unregister a workflow
+ * @param workflowId - ID of workflow to unregister
+ * @returns True if workflow was unregistered
+ */
+export declare function unregisterWorkflow(workflowId: string): boolean;
+/**
+ * Get workflow configuration by ID
+ * @param workflowId - ID of workflow to retrieve
+ * @returns Workflow configuration or undefined
+ */
+export declare function getWorkflow(workflowId: string): WorkflowConfig | undefined;
+/**
+ * Check if workflow exists
+ * @param workflowId - ID of workflow to check
+ * @returns True if workflow exists
+ */
+export declare function hasWorkflow(workflowId: string): boolean;
+/**
+ * List all registered workflows
+ * @param options - Listing options for filtering
+ * @returns Array of workflow configurations
+ */
+export declare function listWorkflows(options?: ListOptions): WorkflowConfig[];
+/**
+ * Get workflow metadata (usage stats, timestamps)
+ * @param workflowId - ID of workflow
+ * @returns Metadata or undefined
+ */
+export declare function getWorkflowMetadata(workflowId: string): WorkflowMetadata | undefined;
+/**
+ * Update workflow configuration
+ * @param workflowId - ID of workflow to update
+ * @param updates - Partial workflow config with updates
+ * @param options - Update options
+ * @returns Update result
+ */
+export declare function updateWorkflow(workflowId: string, updates: Partial<WorkflowConfig>, options?: RegisterOptions): RegisterResult;
+/**
+ * Clear all workflows from registry
+ * WARNING: This will remove all registered workflows
+ */
+export declare function clearRegistry(): void;
+/**
+ * Get registry statistics
+ * @returns Statistics about registered workflows
+ */
+export declare function getRegistryStats(): RegistryStats;
+/**
+ * Export registry as JSON for backup/sharing
+ * @returns JSON string of all workflows
+ */
+export declare function exportRegistry(): string;
+/**
+ * Import workflows from JSON
+ * @param json - JSON string of workflow configs
+ * @param options - Import options
+ * @returns Array of registration results
+ */
+export declare function importRegistry(json: string, options?: RegisterOptions): RegisterResult[];