@juspay/neurolink 5.3.0 → 6.0.0

package/dist/types/providers.js

@@ -0,0 +1,23 @@
+/**
+ * Provider-specific type definitions for NeuroLink
+ * Replaces 'any' types in provider implementations
+ */
+/**
+ * Type guard for provider error
+ */
+export function isProviderError(error) {
+    return error instanceof Error && "provider" in error;
+}
+/**
+ * Type guard for token usage
+ */
+export function isTokenUsage(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "inputTokens" in value &&
+        "outputTokens" in value &&
+        "totalTokens" in value &&
+        typeof value.inputTokens === "number" &&
+        typeof value.outputTokens === "number" &&
+        typeof value.totalTokens === "number");
+}

package/dist/types/stream-types.d.ts

@@ -1,12 +1,13 @@
 import type { ZodType, ZodTypeDef } from "zod";
 import type { Tool, Schema } from "ai";
 import type { AIProviderName, AnalyticsData, EvaluationData } from "../core/types.js";
+import type { UnknownRecord, Unknown } from "./common.js";
 /**
  * Interface for tool execution calls
  */
 export interface ToolCall {
     toolName: string;
-    parameters: Record<string, any>;
+    parameters: UnknownRecord;
     id?: string;
 }
 /**
@@ -15,7 +16,7 @@ export interface ToolCall {
 export interface ToolResult {
     toolName: string;
     status: "success" | "failure";
-    output?: any;
+    output?: Unknown;
     error?: string;
     id?: string;
     executionTime?: number;
@@ -48,7 +49,7 @@ export interface StreamOptions {
     maxSteps?: number;
     enableEvaluation?: boolean;
     enableAnalytics?: boolean;
-    context?: Record<string, any>;
+    context?: UnknownRecord;
     evaluationDomain?: string;
     toolUsageContext?: string;
     conversationHistory?: Array<{

package/dist/types/tools.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Tool system type definitions for NeuroLink
+ * Replaces 'any' types in tool registration and execution
+ */
+import { z } from "zod";
+import type { Result, JsonValue, ErrorInfo } from "./common.js";
+/**
+ * Tool parameter schema types
+ */
+export type ToolParameterSchema = z.ZodSchema | Record<string, JsonValue>;
+/**
+ * Standard tool input parameters
+ */
+export interface BaseToolArgs {
+    [key: string]: JsonValue | undefined;
+}
+/**
+ * Tool execution arguments with specific common patterns
+ */
+export interface ToolArgs extends BaseToolArgs {
+    input?: JsonValue;
+    data?: JsonValue;
+    options?: JsonValue;
+}
+/**
+ * Tool execution metadata
+ */
+export interface ToolExecutionMetadata {
+    requestId?: string;
+    startTime?: number;
+    version?: string;
+    [key: string]: JsonValue | undefined;
+}
+/**
+ * Tool execution context
+ */
+export interface ToolContext {
+    sessionId?: string;
+    userId?: string;
+    aiProvider?: string;
+    metadata?: ToolExecutionMetadata;
+}
+/**
+ * Tool execution result metadata
+ */
+export interface ToolResultMetadata {
+    toolName?: string;
+    executionTime?: number;
+    timestamp?: number;
+    source?: string;
+    version?: string;
+    serverId?: string;
+}
+/**
+ * Tool execution result
+ */
+export interface ToolResult<T = JsonValue> extends Result<T, ErrorInfo> {
+    success: boolean;
+    data?: T;
+    error?: ErrorInfo;
+    metadata?: ToolResultMetadata;
+}
+/**
+ * Tool metadata for registration
+ */
+export interface ToolMetadata {
+    category?: string;
+    version?: string;
+    author?: string;
+    tags?: string[];
+    documentation?: string;
+    [key: string]: JsonValue | undefined;
+}
+/**
+ * Tool definition interface
+ */
+export interface ToolDefinition<TArgs = ToolArgs, TResult = JsonValue> {
+    description: string;
+    parameters?: ToolParameterSchema;
+    metadata?: ToolMetadata;
+    execute: (args: TArgs, context?: ToolContext) => Promise<ToolResult<TResult>> | ToolResult<TResult>;
+}
+/**
+ * Simple tool interface (for SDK)
+ */
+export interface SimpleTool<TArgs = ToolArgs, TResult = JsonValue> {
+    description: string;
+    parameters?: z.ZodSchema;
+    metadata?: ToolMetadata;
+    execute: (args: TArgs, context?: ToolContext) => Promise<TResult> | TResult;
+}
+/**
+ * Tool registry entry
+ */
+export interface ToolRegistryEntry {
+    name: string;
+    description: string;
+    serverId?: string;
+    isImplemented?: boolean;
+    parameters?: ToolParameterSchema;
+    execute?: ToolDefinition["execute"];
+}
+/**
+ * Tool execution information
+ */
+export interface ToolExecution {
+    toolName: string;
+    args: ToolArgs;
+    result: ToolResult;
+    executionTime: number;
+    timestamp: number;
+}
+/**
+ * Available tool information
+ */
+export interface AvailableTool {
+    name: string;
+    description: string;
+    serverId?: string;
+    toolName?: string;
+    parameters?: ToolParameterSchema;
+}
+/**
+ * Tool validation options
+ */
+export interface ToolValidationOptions {
+    customValidator?: (toolName: string, args: ToolArgs) => boolean | Promise<boolean>;
+    validateSchema?: boolean;
+    allowUnknownProperties?: boolean;
+}
+/**
+ * Tool call information (for AI SDK integration)
+ */
+export interface ToolCall {
+    toolName: string;
+    parameters: ToolArgs;
+    id?: string;
+}
+/**
+ * Tool call result (for AI SDK integration)
+ */
+export interface ToolCallResult {
+    id?: string;
+    result: ToolResult;
+    formattedForAI: string;
+}
+/**
+ * Type guard for tool result
+ */
+export declare function isToolResult(value: unknown): value is ToolResult;
+/**
+ * Type guard for tool definition
+ */
+export declare function isToolDefinition(value: unknown): value is ToolDefinition;

package/dist/types/tools.js

@@ -0,0 +1,25 @@
+/**
+ * Tool system type definitions for NeuroLink
+ * Replaces 'any' types in tool registration and execution
+ */
+import { z } from "zod";
+/**
+ * Type guard for tool result
+ */
+export function isToolResult(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "success" in value &&
+        typeof value.success === "boolean");
+}
+/**
+ * Type guard for tool definition
+ */
+export function isToolDefinition(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "description" in value &&
+        "execute" in value &&
+        typeof value.description === "string" &&
+        typeof value.execute === "function");
+}

package/dist/utils/logger.d.ts

@@ -4,9 +4,9 @@
  * Provides conditional logging based on NEUROLINK_DEBUG environment variable
  */
 export declare const logger: {
-    debug: (...args: any[]) => void;
-    info: (...args: any[]) => void;
-    warn: (...args: any[]) => void;
-    error: (...args: any[]) => void;
-    always: (...args: any[]) => void;
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    always: (...args: unknown[]) => void;
 };

package/dist/utils/provider-validation.d.ts

@@ -7,6 +7,7 @@
  * - Proper error classification
  * - Rate-limit friendly validation
  */
+import type { UnknownRecord } from "../types/common.js";
 export interface ProviderValidationResult {
     configured: boolean;
     formatValid: boolean;
@@ -15,7 +16,7 @@ export interface ProviderValidationResult {
     error?: string;
     errorType?: "config" | "format" | "auth" | "network" | "quota" | "unknown";
     responseTime?: number;
-    details?: Record<string, any>;
+    details?: UnknownRecord;
 }
 /**
  * Validate API key format for a specific provider

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "5.3.0",
+  "version": "6.0.0",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 9 major providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",