@juspay/neurolink 9.65.1 → 9.66.0

package/dist/cli/commands/proxy.js

@@ -234,6 +234,122 @@ async function clearClaudeProxySettings(expectedBaseUrl) {
     fs.writeFileSync(CLAUDE_SETTINGS_PATH, JSON.stringify(settings, null, 2));
     return hadBaseUrl || hadToolSearch;
 }
+// =============================================================================
+// OPENCODE AUTO-CONFIGURATION
+// =============================================================================
+function getOpenCodeConfigDir() {
+    if (process.platform === "darwin") {
+        return join(homedir(), "Library", "Application Support", "opencode");
+    }
+    // Linux/other: XDG_CONFIG_HOME or ~/.config
+    return join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "opencode");
+}
+const OPENCODE_CONFIG_PATH = join(getOpenCodeConfigDir(), "opencode.json");
+/**
+ * Key under which we persist the snapshot of the user's pre-existing
+ * `provider.neurolink` config inside `opencode.json` itself. Persisting (rather
+ * than relying on in-process state) means restoration still works even if the
+ * proxy crashes or shutdown handlers run in a different process.
+ *
+ * Mirrors the Claude pattern (`__proxy_original_env` inside Claude's settings).
+ */
+const OPENCODE_ORIGINAL_KEY = "__proxy_original_neurolink";
+async function setOpenCodeProxySettings(baseUrl, proxyKey) {
+    const fs = await import("fs");
+    const configDir = getOpenCodeConfigDir();
+    try {
+        fs.accessSync(configDir);
+    }
+    catch {
+        // OpenCode not installed — config directory does not exist, skip silently
+        return;
+    }
+    let config;
+    try {
+        config = JSON.parse(fs.readFileSync(OPENCODE_CONFIG_PATH, "utf8"));
+    }
+    catch {
+        // file missing/invalid — create fresh config object
+        config = { provider: {} };
+    }
+    const provider = (config.provider ?? {});
+    // Persist a snapshot of the user's pre-existing provider.neurolink — but
+    // only the first time we touch the file. Subsequent set() calls must NOT
+    // overwrite the snapshot (otherwise after the proxy writes its own block,
+    // the next set() would store the proxy's block as the "original" and
+    // permanently lose the user's real config on the next clear()).
+    if (!(OPENCODE_ORIGINAL_KEY in config)) {
+        config[OPENCODE_ORIGINAL_KEY] =
+            "neurolink" in provider
+                ? JSON.parse(JSON.stringify(provider.neurolink))
+                : null;
+    }
+    provider.neurolink = {
+        id: "neurolink",
+        name: "NeuroLink Proxy",
+        npm: "@ai-sdk/openai-compatible",
+        env: [],
+        models: {},
+        options: {
+            baseURL: baseUrl,
+            apiKey: proxyKey || "neurolink-proxy",
+        },
+    };
+    config.provider = provider;
+    fs.writeFileSync(OPENCODE_CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+async function clearOpenCodeProxySettings(expectedBaseUrl) {
+    const fs = await import("fs");
+    let config;
+    try {
+        config = JSON.parse(fs.readFileSync(OPENCODE_CONFIG_PATH, "utf8"));
+    }
+    catch {
+        return false;
+    }
+    const provider = config.provider;
+    if (!provider || !("neurolink" in provider)) {
+        return false;
+    }
+    // Check if our proxy URL matches before removing
+    const existing = provider.neurolink;
+    if (expectedBaseUrl && existing) {
+        const options = existing.options;
+        if (options && typeof options.baseURL === "string") {
+            if (options.baseURL !== expectedBaseUrl) {
+                // User configured a different URL; do not clobber
+                return false;
+            }
+        }
+    }
+    const hadNeurolink = "neurolink" in provider;
+    // Restore from the snapshot persisted at first set(), regardless of process
+    // identity. Only delete provider.neurolink when the snapshot says the user
+    // explicitly had no entry before — never on an "undefined" snapshot, since
+    // that would mean the snapshot was lost and we cannot prove the entry is ours.
+    if (OPENCODE_ORIGINAL_KEY in config) {
+        const snapshot = config[OPENCODE_ORIGINAL_KEY];
+        if (snapshot === null) {
+            // User had no provider.neurolink before the proxy started — safe to remove.
+            delete provider.neurolink;
+        }
+        else {
+            provider.neurolink = snapshot;
+        }
+        delete config[OPENCODE_ORIGINAL_KEY];
+    }
+    else {
+        // No snapshot present — refuse to delete to avoid destroying a config
+        // the proxy may not own (e.g. a user wrote their own `neurolink` block
+        // before the snapshot key was introduced, or this is being cleared from
+        // a process that never ran set()).
+        logger.debug("[proxy] OpenCode clear: no original-provider snapshot found, leaving provider.neurolink intact");
+        return false;
+    }
+    config.provider = provider;
+    fs.writeFileSync(OPENCODE_CONFIG_PATH, JSON.stringify(config, null, 2));
+    return hadNeurolink;
+}
 async function isProxyHealthy(host, port, timeoutMs) {
     try {
         const response = await fetch(`http://${host}:${port}/health`, {
@@ -533,9 +649,10 @@ function printProxyBanner(url, strategy) {
     logger.always(`  ${chalk.bold("PID:")}        ${chalk.cyan(process.pid)}`);
     logger.always("");
     logger.always(chalk.bold("Endpoints:"));
-    logger.always(`  ${chalk.blue("POST")} /v1/messages  — Proxy to Anthropic`);
-    logger.always(`  ${chalk.green("GET")}  /health       — Health check`);
-    logger.always(`  ${chalk.green("GET")}  /status       — Detailed status`);
+    logger.always(`  ${chalk.blue("POST")} /v1/messages         — Claude proxy (Anthropic format)`);
+    logger.always(`  ${chalk.blue("POST")} /v1/chat/completions — OpenAI-compatible proxy`);
+    logger.always(`  ${chalk.green("GET")}  /health              — Health check`);
+    logger.always(`  ${chalk.green("GET")}  /status              — Detailed status`);
     logger.always("");
     logger.always(chalk.bold("Set in Claude Code:"));
     logger.always(`  ${chalk.cyan(`ANTHROPIC_BASE_URL=${url}`)}`);
@@ -706,6 +823,7 @@ async function resolveBootPrimaryAccountKey(primaryEmail) {
 }
 async function createProxyStartApp(params) {
     const { createClaudeProxyRoutes } = await import("../../lib/server/routes/claudeProxyRoutes.js");
+    const { createOpenAIProxyRoutes } = await import("../../lib/server/routes/openaiProxyRoutes.js");
     const { Hono } = await import("hono");
     const app = new Hono();
     const readiness = createProxyReadinessState();
@@ -724,7 +842,9 @@ async function createProxyStartApp(params) {
         }, 502);
     });
     const routeGroup = createClaudeProxyRoutes(params.modelRouter, "", params.strategy, params.passthrough, params.primaryAccountKey);
-    for (const route of routeGroup.routes) {
+    const openaiRouteGroup = createOpenAIProxyRoutes(params.modelRouter, "", params.port);
+    const allProxyRoutes = [...routeGroup.routes, ...openaiRouteGroup.routes];
+    for (const route of allProxyRoutes) {
         const method = route.method.toLowerCase();
         app[method](route.path, async (c) => {
             const emptyBody = {};
@@ -1025,6 +1145,13 @@ function registerProxyShutdownHandlers(params) {
             catch {
                 // non-fatal
             }
+            try {
+                const shutdownHost = params.host === "0.0.0.0" ? "localhost" : params.host;
+                await clearOpenCodeProxySettings(`http://${shutdownHost}:${params.port}/v1`);
+            }
+            catch {
+                // non-fatal
+            }
         }
         try {
             params.server.close?.();
@@ -1114,6 +1241,15 @@ async function startProxyRuntime(params) {
             logger.debug("[proxy] Failed to auto-configure Claude Code: " +
                 (error instanceof Error ? error.message : String(error)));
         }
+        try {
+            await setOpenCodeProxySettings(`${url}/v1`);
+            logger.always(chalk.green("  ✓ Auto-configured OpenCode settings"));
+            logger.always(chalk.dim("    Restart OpenCode to connect through proxy"));
+        }
+        catch (error) {
+            logger.debug("[proxy] Failed to auto-configure OpenCode: " +
+                (error instanceof Error ? error.message : String(error)));
+        }
     }
     else {
         logger.always(chalk.dim("  ⊘ Dev mode: skipping client auto-configuration"));
@@ -1808,6 +1944,12 @@ export const proxyGuardCommand = {
         }
         // Restart failed or launchd not installed — clean up Claude settings
         const cleared = await clearClaudeProxySettings(expectedBaseUrl);
+        try {
+            await clearOpenCodeProxySettings(`${expectedBaseUrl}/v1`);
+        }
+        catch {
+            // non-fatal
+        }
         const state = loadProxyState();
         if (state &&
             state.host === host &&
@@ -1916,9 +2058,16 @@ export const proxySetupCommand = {
                 console.info(chalk.green("  ✓ Claude Code configured"));
             }
             catch (e) {
-                console.info(chalk.yellow(`  ⚠ Could not auto-configure: ${e instanceof Error ? e.message : String(e)}`));
+                console.info(chalk.yellow(`  ⚠ Could not auto-configure Claude Code: ${e instanceof Error ? e.message : String(e)}`));
                 console.info(chalk.yellow(`  Set manually: ANTHROPIC_BASE_URL=${url}`));
             }
+            try {
+                await setOpenCodeProxySettings(`${url}/v1`);
+                console.info(chalk.green("  ✓ OpenCode configured"));
+            }
+            catch (e) {
+                console.info(chalk.yellow(`  ⚠ Could not auto-configure OpenCode: ${e instanceof Error ? e.message : String(e)}`));
+            }
             // Done!
             console.info("");
             console.info(chalk.bold.green("Setup complete!"));

package/dist/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/client/reactHooks.tsx

@@ -27,7 +27,6 @@ import {
 import type { ReactNode } from "react";
 
 import type {
-  ClientConfig,
   ClientApiError,
   NeuroLinkProviderProps,
   UseChatOptions,
@@ -361,7 +360,9 @@ export function useChat(options: UseChatOptions = {}): UseChatReturn {
     ) => {
       e?.preventDefault?.();
 
-      if (!input.trim()) return;
+      if (!input.trim()) {
+        return;
+      }
 
       const message: Omit<ChatMessage, "id" | "createdAt"> = {
         role: "user",
@@ -384,7 +385,9 @@ export function useChat(options: UseChatOptions = {}): UseChatReturn {
     const lastUserMessageIndex = currentMessages.findLastIndex(
       (m: ChatMessage) => m.role === "user",
     );
-    if (lastUserMessageIndex === -1) return null;
+    if (lastUserMessageIndex === -1) {
+      return null;
+    }
 
     const lastUserMessage = currentMessages[lastUserMessageIndex];
 
@@ -977,7 +980,9 @@ export function useVoice(options: UseVoiceOptions = {}): UseVoiceReturn {
 
   // Check browser support
   const isSupported = useMemo(() => {
-    if (typeof window === "undefined") return false;
+    if (typeof window === "undefined") {
+      return false;
+    }
     const hasSpeechRecognition =
       "SpeechRecognition" in window || "webkitSpeechRecognition" in window;
     const hasSpeechSynthesis = "speechSynthesis" in window;
@@ -988,7 +993,9 @@ export function useVoice(options: UseVoiceOptions = {}): UseVoiceReturn {
    * Initialize speech recognition
    */
   const initRecognition = useCallback(() => {
-    if (typeof window === "undefined") return null;
+    if (typeof window === "undefined") {
+      return null;
+    }
 
     const SpeechRecognitionCtor =
       (
@@ -1002,7 +1009,9 @@ export function useVoice(options: UseVoiceOptions = {}): UseVoiceReturn {
         }
       ).webkitSpeechRecognition;
 
-    if (!SpeechRecognitionCtor) return null;
+    if (!SpeechRecognitionCtor) {
+      return null;
+    }
 
     const recognition = new SpeechRecognitionCtor();
     recognition.continuous = true;
@@ -1047,7 +1056,9 @@ export function useVoice(options: UseVoiceOptions = {}): UseVoiceReturn {
    * Start listening for voice input
    */
   const startListening = useCallback(() => {
-    if (!enableSpeechRecognition) return;
+    if (!enableSpeechRecognition) {
+      return;
+    }
 
     if (!recognitionRef.current) {
       recognitionRef.current = initRecognition();
@@ -1076,7 +1087,9 @@ export function useVoice(options: UseVoiceOptions = {}): UseVoiceReturn {
    */
   const speak = useCallback(
     async (text: string): Promise<void> => {
-      if (typeof window === "undefined") return;
+      if (typeof window === "undefined") {
+        return;
+      }
 
       setIsSpeaking(true);
       onSpeechStart?.();
@@ -1286,7 +1299,9 @@ export function useStream(options: UseStreamOptions = {}): UseStreamReturn {
 
         while (true) {
           const { done, value } = await reader.read();
-          if (done) break;
+          if (done) {
+            break;
+          }
 
           buffer += decoder.decode(value, { stream: true });
           const lines = buffer.split("\n");

package/dist/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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