@juspay/neurolink 13.6.0 → 13.6.1

package/dist/core/modules/ToolsManager.js

@@ -6,6 +6,7 @@ import { logger } from "../../utils/logger.js";
 import { TOOL_EVENTS_WRAPPED } from "../../types/index.js";
 import { getKeyCount } from "../../utils/transformationUtils.js";
 import { extractIsErrorText } from "../../utils/toolResultStatus.js";
+import { createToolExecutionId } from "../../utils/toolExecutionId.js";
 import { convertJsonSchemaToZod } from "../../utils/schemaConversion.js";
 import { generateToolOutputPreview, DEFAULT_MAX_PREVIEW_BYTES, RETRIEVE_CONTEXT_TOOL_NAME, } from "../../context/toolOutputLimits.js";
 /**
@@ -516,9 +517,7 @@ export class ToolsManager {
             // listener can pair this start with its end.
             const eventIds = {
                 ...idField,
-                executionId: `${toolName}-${Date.now()}-${Math.random()
-                    .toString(36)
-                    .slice(2, 11)}`,
+                executionId: createToolExecutionId(toolName),
             };
             return withSpan({
                 name: toolSpanName(toolName),

package/dist/core/nativeGenerateLoop.js

@@ -353,6 +353,7 @@ const validateToolInput = (tool, input) => {
         ? resolveToolInputSchema(tool.inputSchema)
         : undefined;
     if (!schema ||
+        typeof schema !== "object" ||
         !("safeParse" in schema) ||
         typeof schema.safeParse !== "function") {
         return undefined;

package/dist/neurolink.js

@@ -76,6 +76,7 @@ import { SpanSerializer } from "./observability/utils/spanSerializer.js";
 import { endSpanWhenDropped, withSpan } from "./telemetry/withSpan.js";
 import { getActiveTraceContext } from "./telemetry/traceContext.js";
 import { calculateCost } from "./utils/pricing.js";
+import { createToolExecutionId } from "./utils/toolExecutionId.js";
 import { acquireTelemetry, ensureTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, isOpenTelemetryInitialized, releaseTelemetry, setLangfuseContext, traceMetadataFromContext, } from "./services/server/ai/observability/instrumentation.js";
 import { clearChecklistState, createChecklistTools, getChecklistState, resolveChecklistSessionId, } from "./agent/taskChecklist.js";
 import { cancelDelegates as cancelBackgroundDelegates, collectDelegates as collectBackgroundDelegates, configureDelegation, createDelegationTools, spawnDelegate as spawnBackgroundDelegate, } from "./agent/backgroundDelegation.js";
@@ -10599,7 +10600,7 @@ Current user's request: ${currentInput}`;
      * @returns executionId for tracking this specific execution
      */
     emitToolStart(toolName, input, startTime = Date.now()) {
-        const executionId = `${toolName}-${startTime}-${Math.random().toString(36).substr(2, 9)}`;
+        const executionId = createToolExecutionId(toolName, startTime);
         // Create execution context for tracking
         const context = {
             executionId,

package/dist/types/config.d.ts

@@ -443,6 +443,13 @@ export type ToolConfig = {
      * full. Note: the instance-level `include` list deliberately does NOT
      * force tools hot — it scopes the catalog, and discovery defers within
      * that scope (a scoped-but-large catalog is exactly where deferral pays).
+     *
+     * What the model and your listeners see once discovery is on: the
+     * `search_tools` description ends with an instruction to check the catalog
+     * before saying a task cannot be done; each `search_tools` call emits
+     * `tool:start` and `tool:end` (paired by `executionId`) and is traced and
+     * observed like any other tool call; and the events of every wrapped
+     * external tool carry an `executionId`.
      * Default: false.
      */
     discovery?: boolean;
@@ -451,7 +458,12 @@ export type ToolConfig = {
      * - `"external"`: tools of servers attached with `addExternalMCPServer`.
      * - `"all"`: every tool in the request's record except the built-in tools,
      *   so tools registered with `registerTool`/`registerTools` and in-process
-     *   MCP tools are deferred as well.
+     *   MCP tools are deferred as well. That includes the tools NeuroLink
+     *   registers for its own features through `registerTool()`, such as
+     *   `retrieve_context` (memory retrieval), the skills tools, and the tools
+     *   of `registerTaskTools`, `registerDelegationTools`,
+     *   `registerBackgroundCommandTools` and `registerGitTools`. Name them in
+     *   `discoveryAlwaysVisible` to keep them in full.
      * Per-call tools, per-call whitelists, forced `toolChoice` tools and
      * already-discovered tools stay hot in both scopes. Ignored unless
      * `discovery` is true.

package/dist/types/generate.d.ts

@@ -1843,7 +1843,9 @@ export type NativeGenerateLoopArgs = {
     /**
      * Builds the v3 declaration for one tool. When set, every step declares any
      * tool that joined `toolsRecord` mid-turn (discovery's search_tools loads
-     * tools into it), so the model can call what it just loaded.
+     * tools into it), so the model can call what it just loaded. Only the
+     * OpenAI-compatible `generate()` path supplies it; the other providers that
+     * run this loop do not declare a tool `search_tools` loaded mid-turn.
      */
     declareTool?: (name: string, tool: Tool) => Record<string, unknown>;
     /** The turn's resolved tool choice, applied per step via `resolveStepToolChoice`. */

package/dist/utils/toolExecutionId.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @description Builds the id that pairs one tool call's `tool:start` and `tool:end` events.
+ * @param toolName {string} - Name of the tool being run.
+ * @param startTime {number} - When the call started, in epoch milliseconds.
+ * @returns {string} `<toolName>-<startTime>-<nine random base-36 characters>`.
+ */
+export declare function createToolExecutionId(toolName: string, startTime?: number): string;

package/dist/utils/toolExecutionId.js

@@ -0,0 +1,9 @@
+/**
+ * @description Builds the id that pairs one tool call's `tool:start` and `tool:end` events.
+ * @param toolName {string} - Name of the tool being run.
+ * @param startTime {number} - When the call started, in epoch milliseconds.
+ * @returns {string} `<toolName>-<startTime>-<nine random base-36 characters>`.
+ */
+export function createToolExecutionId(toolName, startTime = Date.now()) {
+    return `${toolName}-${startTime}-${Math.random().toString(36).slice(2, 11)}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "13.6.0",
+  "version": "13.6.1",
   "packageManager": "pnpm@10.15.1",
   "description": "The pipe layer of an AI nervous system: one interface connecting provider neurons to your application, across three inference types — generate, stream and decide. `decide` returns typed, calibrated judgements from a non-generative model (~400ms, ~$0.00002/call) for routing, tool selection and context budgeting. MCP-native (4 transports), voice TTS/STT/realtime, RAG, agents, memory, compaction, 9 observability exporters. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · TypeSafe Jev and more.",
   "author": {