@juspay/neurolink 9.65.0 → 9.65.2

package/dist/lib/autoresearch/tools.d.ts

@@ -7,7 +7,7 @@
  *
  * @module autoresearch/tools
  */
-import type { ExperimentRecord, ResearchToolsDeps } from "../types/index.js";
+import type { ResearchToolsDeps, Tool } from "../types/index.js";
 /**
  * Create research management tools bound to a research session.
  *
@@ -24,216 +24,4 @@ import type { ExperimentRecord, ResearchToolsDeps } from "../types/index.js";
  * // tools.research_get_context, tools.research_read_file, etc.
  * ```
  */
-export declare function createResearchTools(deps: ResearchToolsDeps): {
-    /**
-     * Get current research context including state, config, and recent results.
-     */
-    research_get_context: import("ai").Tool<Record<string, never>, {
-        success: boolean;
-        error: string;
-        branch?: undefined;
-        acceptedCommit?: undefined;
-        bestMetric?: undefined;
-        recentResults?: undefined;
-        mutablePaths?: undefined;
-        immutablePaths?: undefined;
-        currentPhase?: undefined;
-        runCount?: undefined;
-        tag?: undefined;
-        keepCount?: undefined;
-    } | {
-        success: boolean;
-        branch: string;
-        acceptedCommit: string | null;
-        bestMetric: number | null;
-        recentResults: ExperimentRecord[];
-        mutablePaths: string[];
-        immutablePaths: string[];
-        currentPhase: import("../types/autoresearch.js").ExperimentPhase;
-        runCount: number;
-        tag: string;
-        keepCount: number;
-        error?: undefined;
-    }>;
-    /**
-     * Read a file from the repository if allowed by policy.
-     */
-    research_read_file: import("ai").Tool<{
-        path: string;
-    }, {
-        success: boolean;
-        error: string;
-        path?: undefined;
-        content?: undefined;
-    } | {
-        success: boolean;
-        path: string;
-        content: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        path: string;
-        content?: undefined;
-    }>;
-    /**
-     * Write a candidate file to the repository if allowed by policy.
-     */
-    research_write_candidate: import("ai").Tool<{
-        path: string;
-        content: string;
-    }, {
-        success: boolean;
-        error: string;
-        path?: undefined;
-        bytesWritten?: undefined;
-    } | {
-        success: boolean;
-        path: string;
-        bytesWritten: number;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        path: string;
-        bytesWritten?: undefined;
-    }>;
-    /**
-     * Get git diff of mutable paths only.
-     */
-    research_diff: import("ai").Tool<Record<string, never>, {
-        success: boolean;
-        diff: string;
-        hasChanges: boolean;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        diff?: undefined;
-        hasChanges?: undefined;
-    }>;
-    /**
-     * Commit staged changes as a candidate.
-     */
-    research_commit_candidate: import("ai").Tool<{
-        message: string;
-    }, {
-        success: boolean;
-        error: string;
-        violations?: undefined;
-        candidateCommit?: undefined;
-        message?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        violations: string[];
-        candidateCommit?: undefined;
-        message?: undefined;
-    } | {
-        success: boolean;
-        candidateCommit: string;
-        message: string;
-        error?: undefined;
-        violations?: undefined;
-    }>;
-    /**
-     * Run the experiment.
-     */
-    research_run_experiment: import("ai").Tool<{
-        description: string;
-    }, {
-        success: boolean;
-        description: string;
-        summary: import("../types/autoresearch.js").ExperimentSummary;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        description?: undefined;
-        summary?: undefined;
-    }>;
-    /**
-     * Parse the experiment log file.
-     */
-    research_parse_log: import("ai").Tool<Record<string, never>, {
-        success: boolean;
-        summary: import("../types/autoresearch.js").ExperimentSummary;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        summary?: undefined;
-    }>;
-    /**
-     * Record an experiment result.
-     */
-    research_record: import("ai").Tool<{
-        description: string;
-    }, {
-        success: boolean;
-        error: string;
-        record?: undefined;
-    } | {
-        success: boolean;
-        record: ExperimentRecord;
-        error?: undefined;
-    }>;
-    /**
-     * Accept the candidate commit as the new baseline.
-     */
-    research_accept: import("ai").Tool<Record<string, never>, {
-        success: boolean;
-        error: string;
-        acceptedCommit?: undefined;
-        bestMetric?: undefined;
-        keepCount?: undefined;
-    } | {
-        success: boolean;
-        acceptedCommit: string;
-        bestMetric: number;
-        keepCount: number;
-        error?: undefined;
-    }>;
-    /**
-     * Revert to the accepted commit.
-     */
-    research_revert: import("ai").Tool<Record<string, never>, {
-        success: boolean;
-        error: string;
-        revertedTo?: undefined;
-    } | {
-        success: boolean;
-        revertedTo: string;
-        error?: undefined;
-    }>;
-    /**
-     * Inspect the last 50 lines of the run log for debugging.
-     */
-    research_inspect_failure: import("ai").Tool<Record<string, never>, {
-        success: boolean;
-        tail: string;
-        totalLines: number;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        tail?: undefined;
-        totalLines?: undefined;
-    }>;
-    /**
-     * Save the current state to disk.
-     */
-    research_checkpoint: import("ai").Tool<Record<string, never>, {
-        success: boolean;
-        error: string;
-        checkpointedAt?: undefined;
-        phase?: undefined;
-        runCount?: undefined;
-    } | {
-        success: boolean;
-        checkpointedAt: string;
-        phase: import("../types/autoresearch.js").ExperimentPhase;
-        runCount: number;
-        error?: undefined;
-    }>;
-};
+export declare function createResearchTools(deps: ResearchToolsDeps): Record<string, Tool>;

package/dist/lib/autoresearch/tools.js

@@ -10,11 +10,11 @@
 import { execFileSync } from "node:child_process";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
-import { tool } from "ai";
 import { z } from "zod";
 import { withTimeout } from "../utils/errorHandling.js";
 import { logger } from "../utils/logger.js";
 import { parseExperimentSummary } from "./summaryParser.js";
+import { tool } from "../utils/tool.js";
 /**
  * Create research management tools bound to a research session.
  *

package/dist/lib/client/reactHooks.js

@@ -254,8 +254,9 @@ export function useChat(options = {}) {
      */
     const handleSubmit = useCallback((e, submitOptions) => {
         e?.preventDefault?.();
-        if (!input.trim())
+        if (!input.trim()) {
             return;
+        }
         const message = {
             role: "user",
             content: input,
@@ -271,8 +272,9 @@ export function useChat(options = {}) {
         // Read from the ref so we always have the latest messages
         const currentMessages = messagesRef.current;
         const lastUserMessageIndex = currentMessages.findLastIndex((m) => m.role === "user");
-        if (lastUserMessageIndex === -1)
+        if (lastUserMessageIndex === -1) {
             return null;
+        }
         const lastUserMessage = currentMessages[lastUserMessageIndex];
         // Remove messages after the last user message
         setMessages((prev) => prev.slice(0, lastUserMessageIndex));
@@ -742,8 +744,9 @@ export function useVoice(options = {}) {
     const synthesisRef = useRef(null);
     // Check browser support
     const isSupported = useMemo(() => {
-        if (typeof window === "undefined")
+        if (typeof window === "undefined") {
             return false;
+        }
         const hasSpeechRecognition = "SpeechRecognition" in window || "webkitSpeechRecognition" in window;
         const hasSpeechSynthesis = "speechSynthesis" in window;
         return hasSpeechRecognition || hasSpeechSynthesis;
@@ -752,12 +755,14 @@ export function useVoice(options = {}) {
      * Initialize speech recognition
      */
     const initRecognition = useCallback(() => {
-        if (typeof window === "undefined")
+        if (typeof window === "undefined") {
             return null;
+        }
         const SpeechRecognitionCtor = window.SpeechRecognition ||
             window.webkitSpeechRecognition;
-        if (!SpeechRecognitionCtor)
+        if (!SpeechRecognitionCtor) {
             return null;
+        }
         const recognition = new SpeechRecognitionCtor();
         recognition.continuous = true;
         recognition.interimResults = true;
@@ -795,8 +800,9 @@ export function useVoice(options = {}) {
      * Start listening for voice input
      */
     const startListening = useCallback(() => {
-        if (!enableSpeechRecognition)
+        if (!enableSpeechRecognition) {
             return;
+        }
         if (!recognitionRef.current) {
             recognitionRef.current = initRecognition();
         }
@@ -820,8 +826,9 @@ export function useVoice(options = {}) {
      * Speak text using TTS
      */
     const speak = useCallback(async (text) => {
-        if (typeof window === "undefined")
+        if (typeof window === "undefined") {
             return;
+        }
         setIsSpeaking(true);
         onSpeechStart?.();
         try {
@@ -1002,8 +1009,9 @@ export function useStream(options = {}) {
             let fullText = "";
             while (true) {
                 const { done, value } = await reader.read();
-                if (done)
+                if (done) {
                     break;
+                }
                 buffer += decoder.decode(value, { stream: true });
                 const lines = buffer.split("\n");
                 buffer = lines.pop() ?? "";

package/dist/lib/core/baseProvider.d.ts

@@ -1,9 +1,9 @@
-import type { LanguageModel, ModelMessage, Tool, ToolCallRepairFunction, ToolSet } from "ai";
 import type { AIProviderName } from "../constants/enums.js";
 import type { EvaluationData } from "../index.js";
 import type { NeuroLink } from "../neurolink.js";
 import type { UnknownRecord, MiddlewareFactoryOptions, StreamOptions, StreamResult, AIProvider, AnalyticsData, EnhancedGenerateResult, TextGenerationOptions, TextGenerationResult, ValidationSchema } from "../types/index.js";
 import { TelemetryHandler } from "./modules/TelemetryHandler.js";
+import type { LanguageModel, ModelMessage, Tool, ToolCallRepairFunction, ToolSet } from "../types/index.js";
 /**
  * Abstract base class for all AI providers
  * Tools are integrated as first-class citizens - always available by default
@@ -20,11 +20,6 @@ export declare abstract class BaseProvider implements AIProvider {
     protected sessionId?: string;
     protected userId?: string;
     protected neurolink?: NeuroLink;
-    /** @internal Trace context propagated from NeuroLink SDK for span hierarchy */
-    protected _traceContext: {
-        traceId: string;
-        parentSpanId: string;
-    } | null;
     setTraceContext(ctx: {
         traceId: string;
         parentSpanId: string;

package/dist/lib/core/baseProvider.js

@@ -1,5 +1,4 @@
 import { context, SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
-import { generateText } from "ai";
 import { directAgentTools } from "../agent/directTools.js";
 import { IMAGE_GENERATION_MODELS } from "../core/constants.js";
 import { MiddlewareFactory } from "../middleware/factory.js";
@@ -21,6 +20,7 @@ import { StreamHandler } from "./modules/StreamHandler.js";
 import { TelemetryHandler } from "./modules/TelemetryHandler.js";
 import { ToolsManager } from "./modules/ToolsManager.js";
 import { Utilities } from "./modules/Utilities.js";
+import { generateText } from "../utils/generation.js";
 /**
  * Abstract base class for all AI providers
  * Tools are integrated as first-class citizens - always available by default

package/dist/lib/core/constants.d.ts

@@ -21,6 +21,7 @@ export declare const DEFAULT_TEMPERATURE = 0.7;
 export declare const DEFAULT_TIMEOUT = 60000;
 export declare const DEFAULT_MAX_STEPS = 200;
 export declare const DEFAULT_TOOL_MAX_RETRIES = 2;
+export declare const TOOL_STORAGE_TIMEOUT_MS = 5000;
 export declare const STEP_LIMITS: {
     min: number;
     max: number;

package/dist/lib/core/constants.js

@@ -107,6 +107,9 @@ export const DEFAULT_TEMPERATURE = 0.7;
 export const DEFAULT_TIMEOUT = 60000;
 export const DEFAULT_MAX_STEPS = 200;
 export const DEFAULT_TOOL_MAX_RETRIES = 2; // Maximum retries per tool before permanently failing
+// Fire-and-forget tool storage writes (Redis). 5s is generous for a single
+// Redis write; if breached, the .catch logs a warning.
+export const TOOL_STORAGE_TIMEOUT_MS = 5000;
 // Step execution limits
 export const STEP_LIMITS = {
     min: 1,

package/dist/lib/core/modules/GenerationHandler.d.ts

@@ -12,9 +12,9 @@
  *
  * @module core/modules/GenerationHandler
  */
-import type { LanguageModel, ModelMessage, Tool } from "ai";
-import { generateText } from "ai";
 import type { AIProviderName, EnhancedGenerateResult, NeuroLinkEvents, StandardRecord, TextGenerationOptions, TypedEventEmitter } from "../../types/index.js";
+import type { LanguageModel, ModelMessage, Tool } from "../../types/index.js";
+import { generateText } from "../../utils/generation.js";
 /**
  * GenerationHandler class - Handles text generation operations for AI providers
  */

package/dist/lib/core/modules/GenerationHandler.js

@@ -13,7 +13,6 @@
  * @module core/modules/GenerationHandler
  */
 import { SpanKind, SpanStatusCode } from "@opentelemetry/api";
-import { generateText, NoObjectGeneratedError, Output, stepCountIs } from "ai";
 import { getModelId } from "../../providers/providerTypeUtils.js";
 import { tracers } from "../../telemetry/tracers.js";
 import { logger } from "../../utils/logger.js";
@@ -22,6 +21,9 @@ import { calculateCost } from "../../utils/pricing.js";
 import { withProviderRetry } from "../../utils/providerRetry.js";
 import { calculateCacheSavingsPercent, extractCacheCreationTokens, extractCacheReadTokens, extractTokenUsage, } from "../../utils/tokenUtils.js";
 import { DEFAULT_MAX_STEPS } from "../constants.js";
+import { NoObjectGeneratedError } from "../../utils/generationErrors.js";
+import { Output, stepCountIs } from "../../utils/tool.js";
+import { generateText } from "../../utils/generation.js";
 const genTracer = tracers.generation;
 /**
  * Safely preview-serialize a value for debug logging.

package/dist/lib/core/modules/MessageBuilder.d.ts

@@ -1,19 +1,5 @@
-/**
- * Message Builder Module
- *
- * Handles all message construction logic for AI providers.
- * Extracted from BaseProvider to follow Single Responsibility Principle.
- *
- * Responsibilities:
- * - Building messages from text generation options
- * - Building messages from stream options
- * - Multimodal input detection
- * - Message format conversion (to ModelMessage[])
- *
- * @module core/modules/MessageBuilder
- */
-import type { ModelMessage } from "ai";
 import type { AIProviderName, TextGenerationOptions, StreamOptions } from "../../types/index.js";
+import type { ModelMessage } from "../../types/index.js";
 /**
  * MessageBuilder class - Handles message construction for AI providers
  */

package/dist/lib/core/modules/MessageBuilder.js

@@ -1,17 +1,3 @@
-/**
- * Message Builder Module
- *
- * Handles all message construction logic for AI providers.
- * Extracted from BaseProvider to follow Single Responsibility Principle.
- *
- * Responsibilities:
- * - Building messages from text generation options
- * - Building messages from stream options
- * - Multimodal input detection
- * - Message format conversion (to ModelMessage[])
- *
- * @module core/modules/MessageBuilder
- */
 import { tracers, ATTR, withSpan } from "../../telemetry/index.js";
 import { logger } from "../../utils/logger.js";
 import { buildMessagesArray, buildMultimodalMessagesArray, } from "../../utils/messageBuilder.js";

package/dist/lib/core/modules/StreamHandler.js

@@ -20,7 +20,7 @@ import { buildNoOutputSentinel, detectPostStreamNoOutput, stampNoOutputSpan, } f
 import { STEP_LIMITS } from "../constants.js";
 import { createAnalytics } from "../analytics.js";
 import { nanoid } from "nanoid";
-import { NoOutputGeneratedError } from "ai";
+import { NoOutputGeneratedError } from "../../utils/generationErrors.js";
 /**
  * StreamHandler class - Handles streaming operations for AI providers
  */

package/dist/lib/core/modules/ToolsManager.d.ts

@@ -1,22 +1,6 @@
-/**
- * Tools Manager Module
- *
- * Handles all tool registration, discovery, and execution for AI providers.
- * Extracted from BaseProvider to follow Single Responsibility Principle.
- *
- * Responsibilities:
- * - Tool registration (direct, custom, MCP, external MCP)
- * - Tool discovery and aggregation
- * - Tool creation from definitions and schemas
- * - Tool executor setup
- * - Session context management for MCP tools
- * - Event emission wrapping for tool execution
- *
- * @module core/modules/ToolsManager
- */
-import type { Tool } from "ai";
 import type { AIProviderName, ToolUtilities } from "../../types/index.js";
 import type { NeuroLink } from "../../neurolink.js";
+import type { Tool } from "../../types/index.js";
 /**
  * ToolsManager class - Handles all tool management operations
  */

package/dist/lib/core/modules/ToolsManager.js

@@ -1,20 +1,3 @@
-/**
- * Tools Manager Module
- *
- * Handles all tool registration, discovery, and execution for AI providers.
- * Extracted from BaseProvider to follow Single Responsibility Principle.
- *
- * Responsibilities:
- * - Tool registration (direct, custom, MCP, external MCP)
- * - Tool discovery and aggregation
- * - Tool creation from definitions and schemas
- * - Tool executor setup
- * - Session context management for MCP tools
- * - Event emission wrapping for tool execution
- *
- * @module core/modules/ToolsManager
- */
-import { tool as createAISDKTool, jsonSchema } from "ai";
 import { z } from "zod";
 import { createToolEventPayload } from "../toolEvents.js";
 import { tracers, ATTR, withSpan } from "../../telemetry/index.js";
@@ -23,6 +6,7 @@ import { logger } from "../../utils/logger.js";
 import { getKeyCount } from "../../utils/transformationUtils.js";
 import { convertJsonSchemaToZod } from "../../utils/schemaConversion.js";
 import { generateToolOutputPreview } from "../../context/toolOutputLimits.js";
+import { tool as createAISDKTool, jsonSchema } from "../../utils/tool.js";
 /**
  * ToolsManager class - Handles all tool management operations
  */

package/dist/lib/core/redisConversationMemoryManager.js

@@ -951,12 +951,6 @@ User message: "${userMessage}"`;
                 provider: this.config.summarizationProvider || "vertex",
                 model: this.config.summarizationModel || "gemini-2.5-flash",
                 disableTools: true, // Title generation doesn't need tools — saves ~600 tokens of tool descriptions
-                // A 20-25 letter title is well under 64 tokens; capping prevents
-                // Vertex 400 INVALID_ARGUMENT — Gemini 2.5 Flash on the native
-                // @google/genai SDK rejects requests with no maxOutputTokens cap
-                // when the prompt is short, which silently broke every
-                // `conversationMemory.enabled + context` test path.
-                maxTokens: 64,
             });
             // Clean up the generated title
             let title = result.content?.trim() || "New Conversation";

package/dist/lib/core/streamAnalytics.js

@@ -1,7 +1,7 @@
 import { createAnalytics } from "./analytics.js";
 import { logger } from "../utils/logger.js";
 import { extractTokenUsage, createEmptyTokenUsage, } from "../utils/tokenUtils.js";
-import { NoOutputGeneratedError } from "ai";
+import { NoOutputGeneratedError } from "../utils/generationErrors.js";
 /**
  * Base implementation for collecting analytics from Vercel AI SDK stream results
  */

package/dist/lib/evaluation/contextBuilder.d.ts

@@ -1,8 +1,5 @@
-/**
- * @file Implements the ContextBuilder class for creating rich evaluation context.
- */
-import type { LanguageModelV3CallOptions } from "@ai-sdk/provider";
 import type { EnhancedEvaluationContext, EvaluationResult, GenerateResult } from "../types/index.js";
+import type { LanguageModelV3CallOptions } from "../types/index.js";
 /**
  * Builds the enhanced context required for a RAGAS-style evaluation.
  * This class gathers data from the generation options and results to create a

package/dist/lib/evaluation/contextBuilder.js

@@ -1,6 +1,3 @@
-/**
- * @file Implements the ContextBuilder class for creating rich evaluation context.
- */
 import { logger } from "../utils/logger.js";
 /**
  * Builds the enhanced context required for a RAGAS-style evaluation.

package/dist/lib/evaluation/index.d.ts

@@ -1,8 +1,5 @@
-/**
- * @file This file exports the main Evaluator class, which serves as the central entry point for the evaluation system.
- */
-import type { LanguageModelV3CallOptions } from "@ai-sdk/provider";
 import type { EvaluationData, GenerateResult, AutoEvaluationConfig, EvaluationConfig } from "../types/index.js";
+import type { LanguageModelV3CallOptions } from "../types/index.js";
 export * from "./errors/index.js";
 export * from "./hooks/index.js";
 export * from "./pipeline/index.js";

package/dist/lib/evaluation/index.js

@@ -1,6 +1,3 @@
-/**
- * @file This file exports the main Evaluator class, which serves as the central entry point for the evaluation system.
- */
 import { ContextBuilder } from "./contextBuilder.js";
 import { RAGASEvaluator } from "./ragasEvaluator.js";
 import { mapToEvaluationData } from "./scoring.js";

package/dist/lib/files/fileTools.d.ts

@@ -1,27 +1,11 @@
-/**
- * On-Demand File Access Tools
- *
- * Exposes file operations as LLM tools via the Vercel AI SDK `tool()` pattern.
- * These tools allow the LLM to access file content lazily — only reading
- * the specific sections, lines, or search results it needs.
- *
- * Tools:
- * - list_attached_files: List all registered files with metadata
- * - read_file_section: Read specific line range with token budget
- * - search_in_file: Search for patterns within a file
- * - get_file_preview: Get the preview/summary of a file
- * - extract_file_content: Targeted extraction for any file type (video frames,
- *     PDF pages, spreadsheet ranges, archive entries, PPTX slides)
- *
- * @module files/fileTools
- */
 import type { FileReferenceRegistry } from "./fileReferenceRegistry.js";
 /**
  * Create file access tools bound to a FileReferenceRegistry instance.
  *
  * These tools follow the same pattern as the existing directAgentTools
  * (getCurrentTime, readFile, etc.) in src/lib/agent/directTools.ts.
- * They use `tool()` from the Vercel AI SDK with zod parameter schemas.
+ * They use NeuroLink's `tool()` helper from `../utils/tool.js` with Zod
+ * parameter schemas.
  *
  * @param registry - The FileReferenceRegistry instance to bind to
  * @returns Record of tool name to tool definition

package/dist/lib/files/fileTools.js

@@ -1,28 +1,12 @@
-/**
- * On-Demand File Access Tools
- *
- * Exposes file operations as LLM tools via the Vercel AI SDK `tool()` pattern.
- * These tools allow the LLM to access file content lazily — only reading
- * the specific sections, lines, or search results it needs.
- *
- * Tools:
- * - list_attached_files: List all registered files with metadata
- * - read_file_section: Read specific line range with token budget
- * - search_in_file: Search for patterns within a file
- * - get_file_preview: Get the preview/summary of a file
- * - extract_file_content: Targeted extraction for any file type (video frames,
- *     PDF pages, spreadsheet ranges, archive entries, PPTX slides)
- *
- * @module files/fileTools
- */
-import { tool } from "ai";
 import { z } from "zod";
+import { tool } from "../utils/tool.js";
 /**
  * Create file access tools bound to a FileReferenceRegistry instance.
  *
  * These tools follow the same pattern as the existing directAgentTools
  * (getCurrentTime, readFile, etc.) in src/lib/agent/directTools.ts.
- * They use `tool()` from the Vercel AI SDK with zod parameter schemas.
+ * They use NeuroLink's `tool()` helper from `../utils/tool.js` with Zod
+ * parameter schemas.
  *
  * @param registry - The FileReferenceRegistry instance to bind to
  * @returns Record of tool name to tool definition