@juspay/neurolink 9.83.0 → 9.84.0

package/dist/cli/factories/commandFactory.d.ts

@@ -105,6 +105,14 @@ export declare class CLICommandFactory {
      * Create discover command
      */
     static createDiscoverCommand(): CommandModule;
+    /**
+     * Create agent commands for multi-agent orchestration
+     */
+    static createAgentCommands(): CommandModule;
+    /**
+     * Create network commands for agent network orchestration
+     */
+    static createNetworkCommands(): CommandModule;
     /**
      * Create memory commands
      */

package/dist/cli/factories/commandFactory.js

@@ -27,6 +27,7 @@ import { createStreamAbortHandler } from "../utils/abortHandler.js";
 import { formatVideoFileSize, getVideoMetadataSummary, saveVideoToFile, } from "../utils/videoFileUtils.js";
 import { OllamaCommandFactory } from "./ollamaCommandFactory.js";
 import { SageMakerCommandFactory } from "./sagemakerCommandFactory.js";
+import { AgentCommandFactory } from "../commands/agent.js";
 /**
  * CLI Command Factory for generate commands
  */
@@ -663,6 +664,53 @@ export class CLICommandFactory {
             alias: "rag-top-k",
             default: 5,
         },
+        // Safety — PII detection
+        piiRedact: {
+            type: "boolean",
+            description: "Enable PII detection and redaction on input before sending to LLM",
+            alias: "pii-redact",
+            default: false,
+        },
+        piiTypes: {
+            type: "string",
+            description: "Comma-separated PII types to detect (email,phone,ssn,creditCard,ipAddress,address,name,dateOfBirth,passport,driversLicense)",
+            alias: "pii-types",
+        },
+        piiAction: {
+            type: "string",
+            description: "Action when PII is found: redact, abort, or warn",
+            alias: "pii-action",
+            default: "redact",
+        },
+        // Safety — Input validation
+        inputMaxLength: {
+            type: "number",
+            description: "Maximum input text length (characters)",
+            alias: "input-max-length",
+        },
+        trimWhitespace: {
+            type: "boolean",
+            description: "Trim whitespace from input text",
+            alias: "trim-whitespace",
+            default: false,
+        },
+        requireContent: {
+            type: "boolean",
+            description: "Abort if input text is empty or whitespace",
+            alias: "require-content",
+            default: false,
+        },
+        // Safety — Response validation
+        outputMaxLength: {
+            type: "number",
+            description: "Maximum response length (characters). Truncates if exceeded",
+            alias: "output-max-length",
+        },
+        outputMinLength: {
+            type: "number",
+            description: "Minimum response length (characters)",
+            alias: "output-min-length",
+        },
     };
     // Helper method to build options for commands
     static buildOptions(yargs, additionalOptions = {}) {
@@ -1558,6 +1606,18 @@ export class CLICommandFactory {
     static createDiscoverCommand() {
         return MCPCommandFactory.createDiscoverCommand();
     }
+    /**
+     * Create agent commands for multi-agent orchestration
+     */
+    static createAgentCommands() {
+        return AgentCommandFactory.createAgentCommands();
+    }
+    /**
+     * Create network commands for agent network orchestration
+     */
+    static createNetworkCommands() {
+        return AgentCommandFactory.createNetworkCommands();
+    }
     /**
      * Create memory commands
      */
@@ -2427,6 +2487,34 @@ export class CLICommandFactory {
                         topK: argv.ragTopK,
                     }
                     : undefined,
+                // PII detection
+                piiDetection: argv.piiRedact
+                    ? {
+                        enabled: true,
+                        action: argv.piiAction ?? "redact",
+                        detectTypes: argv.piiTypes
+                            ? argv.piiTypes
+                                .split(",")
+                                .map((t) => t.trim())
+                            : undefined,
+                    }
+                    : undefined,
+                // Input validation
+                inputValidation: argv.inputMaxLength || argv.trimWhitespace || argv.requireContent
+                    ? {
+                        maxLength: argv.inputMaxLength,
+                        trimWhitespace: argv.trimWhitespace,
+                        requireContent: argv.requireContent,
+                    }
+                    : undefined,
+                // Response validation
+                responseValidation: argv.outputMaxLength || argv.outputMinLength
+                    ? {
+                        maxLength: argv.outputMaxLength,
+                        minLength: argv.outputMinLength,
+                        truncationAction: "truncate",
+                    }
+                    : undefined,
                 // TTS configuration
                 tts: enhancedOptions.tts
                     ? {
@@ -2648,6 +2736,34 @@ export class CLICommandFactory {
                     topK: argv.ragTopK,
                 }
                 : undefined,
+            // PII detection
+            piiDetection: argv.piiRedact
+                ? {
+                    enabled: true,
+                    action: argv.piiAction ?? "redact",
+                    detectTypes: argv.piiTypes
+                        ? argv.piiTypes
+                            .split(",")
+                            .map((t) => t.trim())
+                        : undefined,
+                }
+                : undefined,
+            // Input validation
+            inputValidation: argv.inputMaxLength || argv.trimWhitespace || argv.requireContent
+                ? {
+                    maxLength: argv.inputMaxLength,
+                    trimWhitespace: argv.trimWhitespace,
+                    requireContent: argv.requireContent,
+                }
+                : undefined,
+            // Response validation
+            responseValidation: argv.outputMaxLength || argv.outputMinLength
+                ? {
+                    maxLength: argv.outputMaxLength,
+                    minLength: argv.outputMinLength,
+                    truncationAction: "truncate",
+                }
+                : undefined,
             // TTS configuration
             tts: enhancedOptions.tts
                 ? {

package/dist/cli/loop/optionsSchema.d.ts

@@ -4,4 +4,4 @@ import type { OptionSchema, TextGenerationOptions } from "../../lib/types/index.
  * This object provides metadata for validation and help text in the CLI loop.
  * It is derived from the main TextGenerationOptions interface to ensure consistency.
  */
-export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria" | "region" | "csvOptions" | "tts" | "stt" | "thinkingConfig" | "requestId" | "fileRegistry" | "abortSignal" | "toolFilter" | "excludeTools" | "toolChoice" | "prepareStep" | "credentials" | "onFinish" | "onError">, OptionSchema>;
+export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria" | "region" | "csvOptions" | "tts" | "stt" | "thinkingConfig" | "requestId" | "fileRegistry" | "abortSignal" | "toolFilter" | "excludeTools" | "toolChoice" | "prepareStep" | "credentials" | "onFinish" | "onError" | "processors" | "piiDetection" | "responseValidation" | "inputValidation">, OptionSchema>;

package/dist/cli/parser.js

@@ -173,6 +173,10 @@ export function initializeCliParser() {
         .command(CLICommandFactory.createSageMakerCommands())
         // Loop Command - Using CLICommandFactory
         .command(CLICommandFactory.createLoopCommand())
+        // Agent Commands - Using CLICommandFactory (Multi-Agent Orchestration)
+        .command(CLICommandFactory.createAgentCommands())
+        // Network Commands - Using CLICommandFactory (Agent Network Orchestration)
+        .command(CLICommandFactory.createNetworkCommands())
         // Setup Commands - Using SetupCommandFactory
         .command(SetupCommandFactory.createSetupCommands())
         // Server Command Group - Using ServerCommandFactory

package/dist/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/index.js

@@ -707,3 +707,22 @@ 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";

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

@@ -0,0 +1,104 @@
+/**
+ * Agent - Core agent implementation for NeuroLink
+ *
+ * An Agent wraps a NeuroLink instance with specialized behavior, instructions,
+ * and tool restrictions. Agents can be composed into networks for multi-agent
+ * orchestration using the agents-as-tools pattern.
+ */
+import type { z } from "zod";
+import type { NeuroLink } from "../neurolink.js";
+import type { AgentDefinition, AgentExecutionOptions, AgentInput, AgentInstance, AgentResult, AgentStatus, AgentStreamChunk } from "../types/index.js";
+/**
+ * Agent - Wraps a NeuroLink instance with specialized behavior
+ *
+ * Features:
+ * - Custom instructions and persona
+ * - Tool restrictions per agent (via toolFilter on generate/stream)
+ * - Input/output schema validation
+ * - Streaming support
+ * - Execution metrics tracking
+ *
+ * @example
+ * ```typescript
+ * const agent = new Agent({
+ *   id: 'researcher',
+ *   name: 'Research Agent',
+ *   description: 'Searches and analyzes information',
+ *   instructions: 'You are a research assistant...',
+ *   tools: ['websearchGrounding', 'readFile'],
+ * }, neurolink);
+ *
+ * const result = await agent.execute('Find information about quantum computing');
+ * ```
+ */
+export declare class Agent implements AgentInstance {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly instructions: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly tools?: string[];
+    readonly inputSchema?: z.ZodSchema;
+    readonly outputSchema?: z.ZodSchema;
+    readonly maxSteps: number;
+    readonly temperature: number;
+    readonly canDelegate: boolean;
+    readonly metadata?: Record<string, unknown>;
+    private neurolink;
+    private emitter;
+    private executionCount;
+    private lastExecutionTime?;
+    private totalExecutionTime;
+    constructor(definition: AgentDefinition, neurolink: NeuroLink);
+    /**
+     * Execute the agent with given input
+     *
+     * @param input - Text input or structured data
+     * @param options - Execution options
+     * @returns Agent result with content and metadata
+     */
+    execute(input: AgentInput, options?: AgentExecutionOptions): Promise<AgentResult>;
+    /**
+     * Stream execution results
+     *
+     * @param input - Text input or structured data
+     * @param options - Execution options
+     * @yields Agent stream chunks
+     */
+    stream(input: AgentInput, options?: AgentExecutionOptions): AsyncIterable<AgentStreamChunk>;
+    /**
+     * Get agent status
+     */
+    getStatus(): AgentStatus;
+    /**
+     * Get average execution time
+     */
+    getAverageExecutionTime(): number;
+    /**
+     * Subscribe to agent events
+     */
+    on(event: string, handler: (...args: unknown[]) => void): void;
+    /**
+     * Unsubscribe from agent events
+     */
+    off(event: string, handler: (...args: unknown[]) => void): void;
+    /**
+     * Build prompt from input and context
+     */
+    private buildPrompt;
+    /**
+     * Build generation options for NeuroLink.generate()
+     *
+     * Uses toolFilter to delegate tool restriction to BaseProvider.applyToolFiltering()
+     * rather than pre-filtering tools manually.
+     */
+    private buildGenerateOptions;
+    /**
+     * Build stream options for NeuroLink.stream()
+     *
+     * Uses toolFilter to delegate tool restriction to BaseProvider.applyToolFiltering()
+     * rather than pre-filtering tools manually.
+     */
+    private buildStreamOptions;
+}