@juspay/neurolink 9.75.0 → 9.77.0

package/dist/lib/utils/providerErrorClassification.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared provider-error classification utilities used by both neurolink.ts and
+ * the ModelPool routing subsystem.
+ *
+ * Extracted here to avoid duplication and to ensure that typed error classes
+ * (AuthenticationError, AuthorizationError, ModelAccessDeniedError) are
+ * checked consistently in both code paths.
+ */
+/**
+ * Detects whether an error object looks like a model-access-denied condition.
+ * Matches LiteLLM "team not allowed" / "team can only access models=[...]"
+ * plus typed-error name/code markers when the full typed class is not present.
+ */
+export declare function looksLikeModelAccessDenied(error: unknown): boolean;
+/**
+ * Returns true when the error is definitively non-retryable: typed error
+ * classes (auth, access-denied, invalid-model), non-retryable HTTP status
+ * codes, or deterministic 400-class message patterns.
+ *
+ * NOTE: ContextBudgetExceededError is intentionally NOT non-retryable —
+ * each provider has its own context window, so a budget rejection on one
+ * provider does not preclude another provider accepting the same payload.
+ */
+export declare function isNonRetryableProviderError(error: unknown): boolean;

package/dist/lib/utils/providerErrorClassification.js

@@ -0,0 +1,89 @@
+/**
+ * Shared provider-error classification utilities used by both neurolink.ts and
+ * the ModelPool routing subsystem.
+ *
+ * Extracted here to avoid duplication and to ensure that typed error classes
+ * (AuthenticationError, AuthorizationError, ModelAccessDeniedError) are
+ * checked consistently in both code paths.
+ */
+import { AuthenticationError, AuthorizationError, InvalidModelError, ModelAccessDeniedError, } from "../types/index.js";
+import { NON_RETRYABLE_HTTP_STATUS_CODES, isDeterministicClientErrorMessage, } from "./retryability.js";
+/**
+ * Detects whether an error object looks like a model-access-denied condition.
+ * Matches LiteLLM "team not allowed" / "team can only access models=[...]"
+ * plus typed-error name/code markers when the full typed class is not present.
+ */
+export function looksLikeModelAccessDenied(error) {
+    if (!error) {
+        return false;
+    }
+    const e = error;
+    if (e.name === "ModelAccessDeniedError") {
+        return true;
+    }
+    if (e.code === "MODEL_ACCESS_DENIED") {
+        return true;
+    }
+    const msg = typeof e.message === "string"
+        ? e.message
+        : error instanceof Error
+            ? error.message
+            : String(error);
+    if (!msg) {
+        return false;
+    }
+    const lower = msg.toLowerCase();
+    return ((lower.includes("team") && lower.includes("not allowed")) ||
+        lower.includes("team can only access") ||
+        /not\s+allowed\s+to\s+access\s+(this\s+)?model/i.test(msg));
+}
+/**
+ * Returns true when the error is definitively non-retryable: typed error
+ * classes (auth, access-denied, invalid-model), non-retryable HTTP status
+ * codes, or deterministic 400-class message patterns.
+ *
+ * NOTE: ContextBudgetExceededError is intentionally NOT non-retryable —
+ * each provider has its own context window, so a budget rejection on one
+ * provider does not preclude another provider accepting the same payload.
+ */
+export function isNonRetryableProviderError(error) {
+    if (error instanceof InvalidModelError) {
+        return true;
+    }
+    if (error instanceof AuthenticationError) {
+        return true;
+    }
+    if (error instanceof AuthorizationError) {
+        return true;
+    }
+    if (error instanceof ModelAccessDeniedError) {
+        return true;
+    }
+    if (error && typeof error === "object") {
+        const err = error;
+        const status = typeof err.status === "number"
+            ? err.status
+            : typeof err.statusCode === "number"
+                ? err.statusCode
+                : undefined;
+        if (status !== undefined &&
+            NON_RETRYABLE_HTTP_STATUS_CODES.includes(status)) {
+            return true;
+        }
+    }
+    if (error instanceof Error) {
+        const msg = error.message;
+        if (msg.includes("NOT_FOUND") ||
+            msg.includes("Model Not Found") ||
+            msg.includes("model not found") ||
+            msg.includes("PERMISSION_DENIED") ||
+            msg.includes("UNAUTHENTICATED")) {
+            return true;
+        }
+        if (isDeterministicClientErrorMessage(msg)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=providerErrorClassification.js.map

package/dist/neurolink.d.ts

@@ -5,7 +5,7 @@
  * Enhanced AI provider system with natural MCP tool access.
  * Uses real MCP infrastructure for tool discovery and execution.
  */
-import type { CompactionConfig, CompactionResult, SpanData, ObservabilityConfig, MetricsSummary, MCPToolAnnotations, TraceView, AuthenticatedContext, AuthProvider, JsonObject, NeuroLinkEvents, TypedEventEmitter, MCPEnhancementsConfig, NeuroLinkAuthConfig, NeurolinkConstructorConfig, ChatMessage, ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo, GenerateOptions, GenerateResult, ProviderStatus, TextGenerationOptions, TextGenerationResult, MCPExecutableTool, MCPServerInfo, MCPStatus, StreamOptions, StreamResult, ToolExecutionContext, ToolExecutionSummary, ToolInfo, ToolRegistrationOptions, BatchOperationResult, StreamGenerationEndContext, ToolRoutingServerDescriptor } from "./types/index.js";
+import type { CompactionConfig, CompactionResult, SpanData, ObservabilityConfig, MetricsSummary, MCPToolAnnotations, TraceView, AuthenticatedContext, AuthProvider, JsonObject, NeuroLinkEvents, TypedEventEmitter, MCPEnhancementsConfig, NeuroLinkAuthConfig, NeurolinkConstructorConfig, ChatMessage, ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo, GenerateOptions, GenerateResult, ProviderStatus, TextGenerationOptions, TextGenerationResult, MCPExecutableTool, MCPServerInfo, MCPStatus, StreamOptions, StreamResult, ToolExecutionContext, ToolExecutionSummary, ToolInfo, ToolRegistrationOptions, BatchOperationResult, StreamGenerationEndContext, ToolRoutingServerDescriptor, ToolDedupConfig } from "./types/index.js";
 import { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
 import type { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
 import { ExternalServerManager } from "./mcp/externalServerManager.js";
@@ -102,12 +102,15 @@ export declare class NeuroLink {
     private conversationMemoryConfig?;
     private toolRoutingConfig?;
     private toolRoutingCacheInstance?;
+    private toolDedupConfig?;
     private enableOrchestration;
     private authProvider?;
     private pendingAuthConfig?;
     private authInitPromise?;
     private credentials?;
     private readonly fallbackConfig;
+    private readonly modelPool;
+    private readonly requestRouter;
     /**
      * Merge instance-level credentials with per-call credentials.
      *
@@ -611,6 +614,25 @@ export declare class NeuroLink {
     private maybeHandleEarlyGenerateResult;
     private runStandardGenerateRequest;
     private maybeApplyGenerateOrchestration;
+    /**
+     * Applies the host-configured `requestRouter` to `options` in place.
+     *
+     * The router is skipped when:
+     *   - no `requestRouter` is configured on this instance, or
+     *   - the caller explicitly set both `options.provider` AND `options.model`
+     *     (we only skip the router if BOTH are set; a caller setting only one
+     *     still lets the router fill in the other field).
+     *
+     * Fails open: any router error is logged at WARN level and the call
+     * continues with the original options unmodified.
+     *
+     * @param options — the mutable options object (generate or stream).
+     * @param promptText — the text prompt used to build the RouterInputContext.
+     * @param hasTools — true when at least one tool is available for this call.
+     * @param requiresVision — true when the call includes image attachments.
+     * @param thinkingLevel — optional thinking level string from the call options.
+     */
+    private applyRequestRouter;
     private prepareGenerateAugmentations;
     private buildGenerateTextOptions;
     private finalizeGenerateRequestResult;
@@ -1089,6 +1111,19 @@ export declare class NeuroLink {
      * @see {@link NeuroLink.executeTool} for events related to tool execution
      */
     getEventEmitter(): TypedEventEmitter<NeuroLinkEvents>;
+    /**
+     * Returns the instance-level tool-dedup configuration, or `undefined` when
+     * toolDedup was not provided at construction time.
+     *
+     * The stored object is returned as-is whenever `toolDedup` was supplied,
+     * including when `enabled: false` — only the complete absence of a `toolDedup`
+     * option results in `undefined`.
+     *
+     * Called by `BaseProvider.applyToolFiltering` so the dedup pass uses the
+     * same config for every generate/stream call without threading an extra
+     * parameter through the full call stack.
+     */
+    getToolDedupConfig(): ToolDedupConfig | undefined;
     /**
      * Curator P1-1: synchronous credential health check for a single provider.
      *