@juspay/neurolink 9.83.0 → 9.84.0

package/dist/lib/agent/prompts/routingPrompts.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Routing Prompts for Agent Network
+ *
+ * These prompts guide the routing agent in selecting the appropriate
+ * primitive (agent, workflow, or tool) for a given task.
+ */
+import type { Primitive, AgentRoutingDecision } from "../../types/index.js";
+/**
+ * Prompt templates for routing decisions
+ */
+export declare const ROUTING_PROMPTS: {
+    /**
+     * System instructions for the routing agent
+     */
+    SYSTEM_INSTRUCTIONS: string;
+    /**
+     * Template for task analysis and routing
+     */
+    TASK_ROUTING: string;
+    /**
+     * Template for confidence evaluation
+     */
+    CONFIDENCE_EVALUATION: string;
+    /**
+     * Template for multi-step planning
+     */
+    MULTI_STEP_PLANNING: string;
+};
+/**
+ * Build a routing prompt with primitives and task
+ *
+ * @param task - The task to route
+ * @param primitives - Available primitives
+ * @param options - Additional options
+ * @returns The formatted prompt
+ */
+export declare function buildRoutingPrompt(task: string, primitives: Primitive[], options?: {
+    includeAlternatives?: boolean;
+    maxPrimitivesToShow?: number;
+}): string;
+/**
+ * Parse routing response from LLM
+ *
+ * @param response - The raw LLM response
+ * @returns Parsed routing decision or null if parsing fails
+ */
+export declare function parseRoutingResponse(response: string): Partial<AgentRoutingDecision> | null;
+/**
+ * Build confidence evaluation prompt
+ *
+ * @param primitive - The selected primitive
+ * @param task - The task being evaluated
+ * @returns The formatted prompt
+ */
+export declare function buildConfidencePrompt(primitive: Primitive, task: string): string;
+/**
+ * Build multi-step planning prompt
+ *
+ * @param task - The task to plan
+ * @param primitives - Available primitives
+ * @returns The formatted prompt
+ */
+export declare function buildMultiStepPlanningPrompt(task: string, primitives: Primitive[]): string;

package/dist/lib/agent/prompts/routingPrompts.js

@@ -0,0 +1,202 @@
+/**
+ * Routing Prompts for Agent Network
+ *
+ * These prompts guide the routing agent in selecting the appropriate
+ * primitive (agent, workflow, or tool) for a given task.
+ */
+/**
+ * Prompt templates for routing decisions
+ */
+export const ROUTING_PROMPTS = {
+    /**
+     * System instructions for the routing agent
+     */
+    SYSTEM_INSTRUCTIONS: `You are a task routing agent responsible for analyzing tasks and selecting the best primitive to handle them.
+
+Your role is to:
+1. Analyze the incoming task to understand what needs to be done
+2. Review the available primitives (agents, workflows, tools)
+3. Select the most appropriate primitive based on capabilities
+4. Format the input appropriately for the selected primitive
+5. Provide your reasoning and confidence level
+
+Always respond in valid JSON format.`,
+    /**
+     * Template for task analysis and routing
+     */
+    TASK_ROUTING: `Analyze the following task and select the most appropriate primitive to handle it.
+
+Available Primitives:
+{{PRIMITIVES}}
+
+Task to route:
+{{TASK}}
+
+Consider:
+1. The primitive's description and capabilities
+2. The complexity of the task
+3. Required tools or skills
+4. Expected output format
+
+Respond in JSON format:
+{
+  "selectedPrimitive": {
+    "type": "agent" | "workflow" | "tool",
+    "id": "<primitive_id>",
+    "name": "<primitive_name>"
+  },
+  "confidence": <0.0-1.0>,
+  "reasoning": "<explanation of why this primitive was chosen>",
+  "formattedInput": "<the input formatted for the selected primitive>",
+  "alternatives": [
+    {
+      "type": "agent" | "workflow" | "tool",
+      "id": "<alternative_id>",
+      "confidence": <0.0-1.0>
+    }
+  ]
+}`,
+    /**
+     * Template for confidence evaluation
+     */
+    CONFIDENCE_EVALUATION: `Evaluate the confidence that the selected primitive can successfully complete the task.
+
+Selected Primitive:
+- Type: {{PRIMITIVE_TYPE}}
+- Name: {{PRIMITIVE_NAME}}
+- Description: {{PRIMITIVE_DESCRIPTION}}
+
+Task: {{TASK}}
+
+Rate the confidence from 0.0 to 1.0 based on:
+- How well the primitive's capabilities match the task
+- The specificity of the primitive's description
+- The complexity of the task vs primitive's scope
+- Potential edge cases or limitations`,
+    /**
+     * Template for multi-step planning
+     */
+    MULTI_STEP_PLANNING: `Plan the execution of this complex task that may require multiple primitives.
+
+Task: {{TASK}}
+
+Available Primitives:
+{{PRIMITIVES}}
+
+Create an execution plan with the following structure:
+{
+  "isMultiStep": true/false,
+  "steps": [
+    {
+      "stepNumber": 1,
+      "primitiveId": "<primitive_id>",
+      "description": "<what this step accomplishes>",
+      "dependsOn": [<step numbers this depends on>]
+    }
+  ],
+  "expectedOutcome": "<description of final result>"
+}`,
+};
+/**
+ * Build a routing prompt with primitives and task
+ *
+ * @param task - The task to route
+ * @param primitives - Available primitives
+ * @param options - Additional options
+ * @returns The formatted prompt
+ */
+export function buildRoutingPrompt(task, primitives, options) {
+    const { includeAlternatives = true, maxPrimitivesToShow = 20 } = options ?? {};
+    // Format primitives list
+    const primitivesDescription = primitives
+        .slice(0, maxPrimitivesToShow)
+        .map((p) => {
+        const tools = p.type === "agent" && "agent" in p
+            ? p.agent.tools
+            : undefined;
+        const toolsInfo = tools && tools.length > 0 ? `\n  Tools: ${tools.join(", ")}` : "";
+        return `- [${p.type.toUpperCase()}] ${p.id}: ${p.name}\n  Description: ${p.description}${toolsInfo}`;
+    })
+        .join("\n");
+    let prompt = ROUTING_PROMPTS.TASK_ROUTING.replace("{{PRIMITIVES}}", primitivesDescription).replace("{{TASK}}", task);
+    if (!includeAlternatives) {
+        // Remove alternatives section from expected output
+        prompt = prompt.replace(`"alternatives": [
+    {
+      "type": "agent" | "workflow" | "tool",
+      "id": "<alternative_id>",
+      "confidence": <0.0-1.0>
+    }
+  ]`, "");
+    }
+    return prompt;
+}
+/**
+ * Parse routing response from LLM
+ *
+ * @param response - The raw LLM response
+ * @returns Parsed routing decision or null if parsing fails
+ */
+export function parseRoutingResponse(response) {
+    try {
+        // Try to extract JSON from the response
+        const jsonMatch = response.match(/\{[\s\S]*\}/);
+        if (!jsonMatch) {
+            return null;
+        }
+        const parsed = JSON.parse(jsonMatch[0]);
+        // Validate required fields
+        if (!parsed.selectedPrimitive ||
+            !parsed.selectedPrimitive.id ||
+            !parsed.selectedPrimitive.type) {
+            return null;
+        }
+        return {
+            selectedPrimitive: {
+                type: parsed.selectedPrimitive.type,
+                id: parsed.selectedPrimitive.id,
+                name: parsed.selectedPrimitive.name || parsed.selectedPrimitive.id,
+            },
+            confidence: typeof parsed.confidence === "number" ? parsed.confidence : 0.8,
+            reasoning: parsed.reasoning || "No reasoning provided",
+            formattedInput: parsed.formattedInput,
+            alternatives: Array.isArray(parsed.alternatives)
+                ? parsed.alternatives.map((alt) => ({
+                    type: alt.type,
+                    id: alt.id,
+                    confidence: typeof alt.confidence === "number" ? alt.confidence : 0.5,
+                }))
+                : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build confidence evaluation prompt
+ *
+ * @param primitive - The selected primitive
+ * @param task - The task being evaluated
+ * @returns The formatted prompt
+ */
+export function buildConfidencePrompt(primitive, task) {
+    return ROUTING_PROMPTS.CONFIDENCE_EVALUATION.replace("{{PRIMITIVE_TYPE}}", primitive.type)
+        .replace("{{PRIMITIVE_NAME}}", primitive.name)
+        .replace("{{PRIMITIVE_DESCRIPTION}}", primitive.description)
+        .replace("{{TASK}}", task);
+}
+/**
+ * Build multi-step planning prompt
+ *
+ * @param task - The task to plan
+ * @param primitives - Available primitives
+ * @returns The formatted prompt
+ */
+export function buildMultiStepPlanningPrompt(task, primitives) {
+    const primitivesDescription = primitives
+        .map((p) => `- [${p.type.toUpperCase()}] ${p.id}: ${p.name} - ${p.description}`)
+        .join("\n");
+    return ROUTING_PROMPTS.MULTI_STEP_PLANNING.replace("{{TASK}}", task).replace("{{PRIMITIVES}}", primitivesDescription);
+}
+//# sourceMappingURL=routingPrompts.js.map

package/dist/lib/index.d.ts

@@ -424,3 +424,9 @@ export { AgentExecuteRequestSchema, AlreadyRunningError, AuthenticationError, Au
 export { assembleContext, batchRerank, CharacterChunker, ChunkerRegistry, CohereRelevanceScorer, CrossEncoderReranker, CSVLoader, chunkText, createChunker, createContextWindow, createHybridSearch, createRAGPipeline, createVectorQueryTool, executeWithCircuitBreaker, extractMetadata, formatContextWithCitations, GraphRAG, getAvailableStrategies, getCircuitBreaker, getDefaultChunkerConfig, getRecommendedStrategy, HTMLChunker, HTMLLoader, InMemoryBM25Index, InMemoryVectorStore, JSONChunker as RAGJSONChunker, JSONLoader, LaTeXChunker, LLMMetadataExtractor, linearCombination, loadDocument, loadDocuments, MarkdownChunker, MarkdownLoader, MDocument, PDFLoader, prepareRAGTool, processDocument, RAGCircuitBreaker, RAGCircuitBreakerManager, RAGPipeline, RAGRetryHandler, RecursiveChunker, ragCircuitBreakerManager, reciprocalRankFusion, rerank, SemanticChunker, SentenceChunker, simpleRerank, summarizeContext, TextLoader, TokenChunker, WebLoader, } from "./rag/index.js";
 export { ContextBuilder } from "./evaluation/contextBuilder.js";
 export { AuthProviderFactory, createAuthProvider, AuthProviderRegistry, AuthError as AuthErrorFactory, AuthErrorCodes, BaseAuthProvider, InMemorySessionStorage, AuthProviderError, createAuthMiddleware as createAuthProviderMiddleware, createRBACMiddleware, createProtectedMiddleware, createExpressAuthMiddleware, createRequestContext, extractToken, AuthMiddlewareError, AuthMiddlewareErrorCodes, UserRateLimiter, MemoryRateLimitStorage, RedisRateLimitStorage, createRateLimitByUserMiddleware, createAuthenticatedRateLimitMiddleware, createRateLimitStorage, SessionManager, MemorySessionStorage, RedisSessionStorage, createSessionStorage, AuthContextHolder, globalAuthContext, getAuthContext, getCurrentUser, getCurrentSession, isAuthenticated, hasRole, hasAnyRole, hasPermission, hasAllPermissions, requireAuth, requireRole, requirePermission, requireUser, runWithAuthContext, createAuthenticatedContext, RequestContext, NEUROLINK_RESOURCE_ID_KEY, NEUROLINK_THREAD_ID_KEY, createAuthValidatorFromProvider, } from "./auth/index.js";
+export { detectAndRedactPII } from "./utils/piiDetector.js";
+export { validateResponse } from "./utils/responseValidator.js";
+export { TripwireEvaluator, createDefaultTripwireEvaluator, commonTripwires, } from "./utils/tripwireEvaluator.js";
+export { Agent } from "./agent/agent.js";
+export { AgentNetwork } from "./agent/agentNetwork.js";
+export { AgentCoordinator, TaskDistributor, MessageBus, NetworkOrchestrator, NetworkTopology, TopologyBuilder, } from "./agent/index.js";

package/dist/lib/index.js

@@ -707,4 +707,23 @@ AuthContextHolder, globalAuthContext, getAuthContext, getCurrentUser, getCurrent
 RequestContext, NEUROLINK_RESOURCE_ID_KEY, NEUROLINK_THREAD_ID_KEY, 
 // Server Bridge
 createAuthValidatorFromProvider, } from "./auth/index.js";
+// ============================================================================
+// SAFETY UTILITIES — PII Detection, Response Validation, Tripwires
+// ============================================================================
+export { detectAndRedactPII } from "./utils/piiDetector.js";
+export { validateResponse } from "./utils/responseValidator.js";
+export { TripwireEvaluator, createDefaultTripwireEvaluator, commonTripwires, } from "./utils/tripwireEvaluator.js";
+// ============================================================================
+// Multi-Agent Orchestration exports
+// ============================================================================
+export { Agent } from "./agent/agent.js";
+export { AgentNetwork } from "./agent/agentNetwork.js";
+// Advanced agent orchestration exports
+export { 
+// Coordination
+AgentCoordinator, TaskDistributor, 
+// Communication
+MessageBus, 
+// Orchestration
+NetworkOrchestrator, NetworkTopology, TopologyBuilder, } from "./agent/index.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/neurolink.d.ts

@@ -5,6 +5,7 @@
  * Enhanced AI provider system with natural MCP tool access.
  * Uses real MCP infrastructure for tool discovery and execution.
  */
+import type { AgentDefinition, AgentNetworkConfig, NetworkExecutionInput, NetworkExecutionOptions, NetworkExecutionResult, NetworkStreamChunk } from "./types/index.js";
 import type { CompactionConfig, CompactionResult, SpanData, ObservabilityConfig, MetricsSummary, MCPToolAnnotations, TraceView, AuthenticatedContext, AuthProvider, JsonObject, NeuroLinkEvents, TypedEventEmitter, MCPEnhancementsConfig, NeuroLinkAuthConfig, NeurolinkConstructorConfig, ChatMessage, ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo, GenerateOptions, GenerateResult, ProviderStatus, TextGenerationOptions, TextGenerationResult, MCPExecutableTool, MCPServerInfo, MCPStatus, StreamOptions, StreamResult, ToolExecutionContext, ToolExecutionSummary, ToolInfo, ToolRegistrationOptions, BatchOperationResult, StreamGenerationEndContext, ToolRoutingServerDescriptor, ToolDedupConfig } from "./types/index.js";
 import { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
 import type { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
@@ -2162,6 +2163,134 @@ export declare class NeuroLink {
      * ```
      */
     getEvaluationPreset(presetName: "safety" | "rag" | "quality" | "comprehensive" | "minimal" | "summarization" | "customerSupport" | "codeGeneration"): Promise<import("./types/index.js").PipelineConfig>;
+    /**
+     * Create an Agent instance for multi-agent orchestration.
+     *
+     * Agents are specialized AI entities with defined instructions, tools, and behavior.
+     * They can be composed into networks for complex task orchestration.
+     *
+     * @param definition - Agent definition specifying behavior and capabilities
+     * @returns A new Agent instance
+     *
+     * @example
+     * ```typescript
+     * const researcher = neurolink.createAgent({
+     *   id: 'researcher',
+     *   name: 'Research Agent',
+     *   description: 'Searches and analyzes information from various sources',
+     *   instructions: 'You are a research assistant. Search thoroughly and cite sources.',
+     *   tools: ['websearchGrounding', 'readFile'],
+     *   model: 'gpt-4o'
+     * });
+     *
+     * const result = await researcher.execute('Find recent AI breakthroughs');
+     * ```
+     *
+     * @see {@link AgentDefinition} for definition options
+     * @see {@link Agent} for agent methods
+     * @since 8.38.0
+     */
+    createAgent(definition: AgentDefinition): Promise<import("./agent/agent.js").Agent>;
+    /**
+     * Create an AgentNetwork for multi-agent orchestration.
+     *
+     * Networks coordinate multiple agents, workflows, and tools with intelligent
+     * LLM-powered routing. The router agent analyzes tasks and delegates to
+     * the most appropriate primitive.
+     *
+     * @param config - Network configuration with agents, workflows, and routing settings
+     * @returns A new AgentNetwork instance
+     *
+     * @example
+     * ```typescript
+     * const network = neurolink.createNetwork({
+     *   name: 'Content Team',
+     *   description: 'Collaborative content creation pipeline',
+     *   agents: [
+     *     {
+     *       id: 'researcher',
+     *       name: 'Researcher',
+     *       description: 'Finds and verifies information',
+     *       instructions: 'Research topics thoroughly...',
+     *     },
+     *     {
+     *       id: 'writer',
+     *       name: 'Writer',
+     *       description: 'Creates engaging content',
+     *       instructions: 'Write clear, engaging content...',
+     *     },
+     *     {
+     *       id: 'editor',
+     *       name: 'Editor',
+     *       description: 'Reviews and improves content',
+     *       instructions: 'Review for clarity and accuracy...',
+     *     }
+     *   ],
+     *   router: {
+     *     model: 'gpt-4o',
+     *     confidenceThreshold: 0.7
+     *   }
+     * });
+     *
+     * const result = await network.execute({
+     *   message: 'Write an article about quantum computing'
+     * });
+     * ```
+     *
+     * @see {@link AgentNetworkConfig} for configuration options
+     * @see {@link AgentNetwork} for network methods
+     * @since 8.38.0
+     */
+    createNetwork(config: AgentNetworkConfig): Promise<import("./agent/agentNetwork.js").AgentNetwork>;
+    /**
+     * Execute an agent network with the given input.
+     *
+     * @param network - The agent network to execute
+     * @param input - Execution input (message and context)
+     * @param options - Optional execution options
+     * @returns Network execution result with content, trace, and usage
+     *
+     * @see {@link NetworkExecutionInput} for input options
+     * @see {@link NetworkExecutionResult} for result structure
+     * @since 8.38.0
+     */
+    executeNetwork(network: import("./agent/agentNetwork.js").AgentNetwork, input: NetworkExecutionInput, options?: NetworkExecutionOptions): Promise<NetworkExecutionResult>;
+    /**
+     * Stream agent network execution with real-time events.
+     *
+     * @param network - The agent network to stream
+     * @param input - Execution input (message and context)
+     * @param options - Optional execution options
+     * @returns Async iterable of network stream chunks
+     *
+     * @see {@link NetworkStreamChunk} for chunk types
+     * @since 8.38.0
+     */
+    streamNetwork(network: import("./agent/agentNetwork.js").AgentNetwork, input: NetworkExecutionInput, options?: NetworkExecutionOptions): AsyncIterable<NetworkStreamChunk>;
+    /**
+     * Create a NetworkOrchestrator for managing multiple agent networks.
+     *
+     * @param config - Orchestrator configuration options
+     * @returns A new NetworkOrchestrator instance
+     * @since 8.38.0
+     */
+    createOrchestrator(config?: import("./types/index.js").OrchestratorConfig): Promise<import("./agent/orchestration/index.js").NetworkOrchestrator>;
+    /**
+     * Create an AgentCoordinator for managing agent coordination strategies.
+     *
+     * @param config - Coordinator configuration options
+     * @returns A new AgentCoordinator instance
+     * @since 8.38.0
+     */
+    createCoordinator(config?: import("./types/index.js").CoordinatorConfig): Promise<import("./agent/coordination/index.js").AgentCoordinator>;
+    /**
+     * Create a MessageBus for inter-agent communication.
+     *
+     * @param config - Message bus configuration options
+     * @returns A new MessageBus instance
+     * @since 8.38.0
+     */
+    createMessageBus(config?: import("./types/index.js").MessageBusConfig): Promise<import("./agent/communication/index.js").MessageBus>;
     /**
      * Dispose of all resources and cleanup connections
      * Call this method when done using the NeuroLink instance to prevent resource leaks