@juspay/neurolink 12.27.1 → 12.28.0

package/CHANGELOG.md

@@ -1,8 +1,8 @@
-## [12.27.1](https://github.com/juspay/neurolink/compare/v12.27.0...v12.27.1) (2026-09-26)
+## [12.28.0](https://github.com/juspay/neurolink/compare/v12.27.2...v12.28.0) (2026-09-26)
 
-### Bug Fixes
+### Features
 
-- **(proxy):** report a fallback leg that has stopped serving ([96f8bd0](https://github.com/juspay/neurolink/commit/96f8bd00bb5582b47886cd5771964db4814fe9ea))
+- **(agent):** add terminal agent mode, file-tool roots and a TUA-Bench harness ([91c9eba](https://github.com/juspay/neurolink/commit/91c9eba0d4afec7d42eecab799ad7bffc51c6f35))
 
 ## [11.2.3](https://github.com/juspay/neurolink/compare/v11.2.2...v11.2.3) (2026-08-19)
 

package/dist/agent/directTools.d.ts

@@ -1,4 +1,4 @@
-import type { AllToolsMap, BasicToolsMap, FilesystemToolsMap, Tool, UtilityToolsMap } from "../types/index.js";
+import type { AllToolsMap, FileToolRootPolicy, BasicToolsMap, FilesystemToolsMap, Tool, UtilityToolsMap } from "../types/index.js";
 /**
  * Vertex location for the websearchGrounding tool:
  * NEUROLINK_WEBSEARCH_LOCATION, else `global`.
@@ -65,10 +65,13 @@ export declare function buildWebsearchResults(groundingMetadata: {
     domain: string;
 }[];
 /**
- * Direct tool definitions that work immediately with Gemini/AI SDK
- * These bypass MCP complexity and provide reliable agent functionality
+ * Direct tool definitions that work immediately with Gemini/AI SDK.
+ * These bypass MCP complexity and provide reliable agent functionality.
+ *
+ * `createDirectAgentTools` builds a fresh set bound to `policy`; the shared
+ * `directAgentTools` below keeps the working-directory default.
  */
-export declare const directAgentTools: {
+export declare function createDirectAgentTools(policy: FileToolRootPolicy): {
     getCurrentTime: Tool<{
         timezone?: string | undefined;
     }, {
@@ -93,57 +96,136 @@ export declare const directAgentTools: {
         iso?: undefined;
         timestamp?: undefined;
     }>;
-    readFile: Tool<{
-        path: string;
+    readFile: Tool;
+    listDirectory: Tool;
+    calculateMath: Tool<{
+        expression: string;
+        precision: number;
     }, {
         success: boolean;
         error: string;
-        content?: undefined;
-        size?: undefined;
-        path?: undefined;
-        lastModified?: undefined;
+        expression?: undefined;
+        result?: undefined;
+        type?: undefined;
     } | {
         success: boolean;
-        content: string;
-        size: number;
-        path: string;
-        lastModified: string;
+        expression: string;
+        result: any;
+        type: "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function";
         error?: undefined;
     } | {
         success: boolean;
         error: string;
-        path: string;
-        content?: undefined;
-        size?: undefined;
-        lastModified?: undefined;
+        expression: string;
+        result?: undefined;
+        type?: undefined;
     }>;
-    listDirectory: Tool<{
-        path: string;
-        includeHidden: boolean;
+    writeFile: Tool;
+    analyzeCSV: Tool;
+    websearchGrounding: Tool<{
+        query: string;
+        maxResults: number;
+        maxWords: number;
     }, {
         success: boolean;
         error: string;
-        path?: undefined;
-        items?: undefined;
-        count?: undefined;
+        requiredEnvVars: string[];
+        query?: undefined;
+        searchResults?: undefined;
+        rawContent?: undefined;
+        totalResults?: undefined;
+        provider?: undefined;
+        model?: undefined;
+        responseTime?: undefined;
+        timestamp?: undefined;
+        grounded?: undefined;
     } | {
         success: boolean;
-        path: string;
-        items: {
-            name: string;
-            type: string;
-            size: number | undefined;
-            lastModified: string;
+        error: string;
+        query: string;
+        requiredEnvVars?: undefined;
+        searchResults?: undefined;
+        rawContent?: undefined;
+        totalResults?: undefined;
+        provider?: undefined;
+        model?: undefined;
+        responseTime?: undefined;
+        timestamp?: undefined;
+        grounded?: undefined;
+    } | {
+        success: boolean;
+        query: string;
+        searchResults: {
+            title: string;
+            url: string;
+            snippet: string;
+            domain: string;
         }[];
-        count: number;
+        rawContent: string;
+        totalResults: number;
+        provider: string;
+        model: string;
+        responseTime: number;
+        timestamp: number;
+        grounded: boolean;
+        error?: undefined;
+        requiredEnvVars?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        query: string;
+        provider: string;
+        requiredEnvVars?: undefined;
+        searchResults?: undefined;
+        rawContent?: undefined;
+        totalResults?: undefined;
+        model?: undefined;
+        responseTime?: undefined;
+        timestamp?: undefined;
+        grounded?: undefined;
+    }>;
+};
+/**
+ * Bash command execution tool - exported separately for opt-in use.
+ *
+ * SECURITY: This tool is NOT included in directAgentTools by default.
+ * It must be explicitly enabled via:
+ *   - Environment variable: NEUROLINK_ENABLE_BASH_TOOL=true
+ *   - Config: toolConfig.enableBashTool = true
+ *
+ * Import this directly when you need bash execution capabilities:
+ *   import { bashTool } from '../agent/directTools.js';
+ */
+export declare function createBashTool(policy: FileToolRootPolicy): Tool;
+/** The opt-in bash tool with the working-directory default. */
+export declare const bashTool: Tool;
+export declare const directAgentTools: {
+    getCurrentTime: Tool<{
+        timezone?: string | undefined;
+    }, {
+        success: boolean;
+        time: string;
+        timezone: string;
+        iso: string;
+        timestamp?: undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        time: string;
+        iso: string;
+        timestamp: number;
+        timezone?: undefined;
         error?: undefined;
     } | {
         success: boolean;
         error: string;
-        path: string;
-        items?: undefined;
-        count?: undefined;
+        time?: undefined;
+        timezone?: undefined;
+        iso?: undefined;
+        timestamp?: undefined;
     }>;
+    readFile: Tool;
+    listDirectory: Tool;
     calculateMath: Tool<{
         expression: string;
         precision: number;
@@ -166,54 +248,8 @@ export declare const directAgentTools: {
         result?: undefined;
         type?: undefined;
     }>;
-    writeFile: Tool<{
-        path: string;
-        content: string;
-        mode: "create" | "append" | "overwrite";
-    }, {
-        success: boolean;
-        error: string;
-        path?: undefined;
-        mode?: undefined;
-        size?: undefined;
-        written?: undefined;
-    } | {
-        success: boolean;
-        path: string;
-        mode: "create" | "append" | "overwrite";
-        size: number;
-        written: number;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        path: string;
-        mode?: undefined;
-        size?: undefined;
-        written?: undefined;
-    }>;
-    analyzeCSV: Tool<{
-        filePath: string;
-        operation: "count_by_column" | "sum_by_column" | "average_by_column" | "min_max_by_column" | "describe";
-        column: string;
-        maxRows: number;
-    }, {
-        success: boolean;
-        operation: "count_by_column" | "sum_by_column" | "average_by_column" | "min_max_by_column" | "describe";
-        column: string;
-        result: string;
-        rowCount: number;
-    } | {
-        success: boolean;
-        error: string;
-        operation?: undefined;
-        column?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        operation: "count_by_column" | "sum_by_column" | "average_by_column" | "min_max_by_column" | "describe";
-        column: string;
-    }>;
+    writeFile: Tool;
+    analyzeCSV: Tool;
     websearchGrounding: Tool<{
         query: string;
         maxResults: number;
@@ -277,18 +313,6 @@ export declare const directAgentTools: {
         grounded?: undefined;
     }>;
 };
-/**
- * Bash command execution tool - exported separately for opt-in use.
- *
- * SECURITY: This tool is NOT included in directAgentTools by default.
- * It must be explicitly enabled via:
- *   - Environment variable: NEUROLINK_ENABLE_BASH_TOOL=true
- *   - Config: toolConfig.enableBashTool = true
- *
- * Import this directly when you need bash execution capabilities:
- *   import { bashTool } from '../agent/directTools.js';
- */
-export declare const bashTool: Tool;
 /**
  * Get a subset of tools for specific use cases with improved type safety
  */