@juspay/neurolink 9.51.4 → 9.53.0

package/dist/lib/types/autoresearchTypes.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Type definitions for the NeuroLink AutoResearch system.
+ *
+ * An autonomous experiment loop that proposes code changes, executes
+ * experiments, evaluates results against a deterministic metric, and
+ * keeps or discards each change — running unattended for hours.
+ */
+import type { ThinkingLevel } from "./configTypes.js";
+export type MetricDirection = "lower" | "higher";
+export type MetricConfig = {
+    name: string;
+    direction: MetricDirection;
+    pattern: string;
+};
+export type MemoryMetricConfig = {
+    name: string;
+    pattern: string;
+};
+export type ResearchConfig = {
+    repoPath: string;
+    programPath: string;
+    mutablePaths: string[];
+    immutablePaths: string[];
+    resultsPath: string;
+    statePath: string;
+    runCommand: string;
+    logPath: string;
+    metric: MetricConfig;
+    memoryMetric?: MemoryMetricConfig;
+    timeoutMs: number;
+    branchPrefix: string;
+    provider?: string;
+    model?: string;
+    maxExperiments?: number;
+    thinkingLevel?: ThinkingLevel;
+};
+export type ExperimentStatus = "keep" | "discard" | "crash" | "timeout";
+export type ExperimentPhase = "bootstrap" | "baseline" | "propose" | "edit" | "commit" | "run" | "evaluate" | "record" | "accept_or_revert";
+export type ResearchState = {
+    branch: string;
+    acceptedCommit: string | null;
+    baselineMetric: number | null;
+    bestMetric: number | null;
+    candidateCommit: string | null;
+    runCount: number;
+    keepCount: number;
+    lastStatus: ExperimentStatus | null;
+    currentPhase: ExperimentPhase;
+    tag: string;
+    startedAt: string;
+    updatedAt: string;
+    lastSummary?: ExperimentSummary | null;
+};
+export type ExperimentSummary = {
+    crashed: boolean;
+    timedOut: boolean;
+    metric: number | null;
+    memoryValue: number | null;
+    trainingSeconds: number | null;
+    rawTail: string;
+};
+export type ExperimentRecord = {
+    commit: string;
+    metric: number | null;
+    memoryGb: number | null;
+    status: ExperimentStatus;
+    description: string;
+    timestamp: string;
+};
+export type ExperimentStats = {
+    total: number;
+    keepCount: number;
+    discardCount: number;
+    crashCount: number;
+    timeoutCount: number;
+    keepRate: number;
+    bestMetric: number | null;
+    bestCommit: string | null;
+};
+export type ResearchWorkerConfig = Omit<Partial<ResearchConfig>, "repoPath" | "mutablePaths" | "runCommand" | "metric"> & {
+    repoPath: string;
+    mutablePaths: string[];
+    runCommand: string;
+    metric: MetricConfig;
+};
+export type PhaseToolPolicy = {
+    activeTools: string[];
+    forcedTool?: string;
+};
+export type AutoresearchInitializedEvent = {
+    tag: string;
+    branch: string;
+    config: {
+        repoPath: string;
+        runCommand: string;
+        metric: MetricConfig;
+        timeoutMs: number;
+    };
+};
+export type AutoresearchResumedEvent = {
+    tag: string;
+    branch: string;
+    runCount: number;
+    currentPhase: ExperimentPhase;
+};
+export type AutoresearchPhaseChangedEvent = {
+    from: ExperimentPhase;
+    to: ExperimentPhase;
+    runCount: number;
+    tag: string;
+};
+export type AutoresearchExperimentStartedEvent = {
+    tag: string;
+    runCount: number;
+    description: string;
+};
+export type AutoresearchExperimentCompletedEvent = {
+    tag: string;
+    runCount: number;
+    status: ExperimentStatus;
+    metric: number | null;
+    commit: string;
+    description: string;
+    durationMs: number;
+};
+export type AutoresearchMetricImprovedEvent = {
+    tag: string;
+    previousBest: number | null;
+    newBest: number;
+    commit: string;
+    direction: MetricDirection;
+    runCount: number;
+};
+export type AutoresearchRevertEvent = {
+    tag: string;
+    targetCommit: string;
+    reason: ExperimentStatus;
+    runCount: number;
+};
+export type AutoresearchRevertFailedEvent = {
+    tag: string;
+    targetCommit: string;
+    error: string;
+    runCount: number;
+};
+export type AutoresearchStateUpdatedEvent = {
+    tag: string;
+    phase: ExperimentPhase;
+    runCount: number;
+    keepCount: number;
+    bestMetric: number | null;
+};
+export type AutoresearchErrorEvent = {
+    tag: string;
+    error: string;
+    code?: string;
+    phase?: ExperimentPhase;
+    runCount?: number;
+};
+/**
+ * Union map of all autoresearch event names to their payload types.
+ * Used by TypedEventEmitter consumers for documentation;
+ * NeuroLinkEvents uses `unknown` payloads for flexibility.
+ */
+export type AutoresearchEventMap = {
+    "autoresearch:initialized": AutoresearchInitializedEvent;
+    "autoresearch:resumed": AutoresearchResumedEvent;
+    "autoresearch:phase-changed": AutoresearchPhaseChangedEvent;
+    "autoresearch:experiment-started": AutoresearchExperimentStartedEvent;
+    "autoresearch:experiment-completed": AutoresearchExperimentCompletedEvent;
+    "autoresearch:metric-improved": AutoresearchMetricImprovedEvent;
+    "autoresearch:revert": AutoresearchRevertEvent;
+    "autoresearch:revert-failed": AutoresearchRevertFailedEvent;
+    "autoresearch:state-updated": AutoresearchStateUpdatedEvent;
+    "autoresearch:error": AutoresearchErrorEvent;
+};
+/** All known autoresearch event names. */
+export type AutoresearchEventName = keyof AutoresearchEventMap;
+/**
+ * Minimal emitter interface accepted by autoresearch subsystems.
+ * Matches the shape injected by NeuroLink via setEmitter().
+ */
+export type AutoresearchEmitter = {
+    emit(event: string, ...args: unknown[]): boolean;
+};
+export declare const AUTORESEARCH_DEFAULTS: {
+    readonly programPath: "program.md";
+    readonly resultsPath: "results.tsv";
+    readonly statePath: ".autoresearch/state.json";
+    readonly logPath: "run.log";
+    readonly timeoutMs: 600000;
+    readonly branchPrefix: "autoresearch/";
+    readonly thinkingLevel: ThinkingLevel;
+};

package/dist/lib/types/autoresearchTypes.js

@@ -0,0 +1,18 @@
+/**
+ * Type definitions for the NeuroLink AutoResearch system.
+ *
+ * An autonomous experiment loop that proposes code changes, executes
+ * experiments, evaluates results against a deterministic metric, and
+ * keeps or discards each change — running unattended for hours.
+ */
+// ── Defaults ─────────────────────────────────────────────
+export const AUTORESEARCH_DEFAULTS = {
+    programPath: "program.md",
+    resultsPath: "results.tsv",
+    statePath: ".autoresearch/state.json",
+    logPath: "run.log",
+    timeoutMs: 600_000,
+    branchPrefix: "autoresearch/",
+    thinkingLevel: "medium",
+};
+//# sourceMappingURL=autoresearchTypes.js.map

package/dist/lib/types/common.d.ts

@@ -1,6 +1,7 @@
 /**
  * Common utility types for NeuroLink
  */
+import type { AutoresearchErrorEvent, AutoresearchExperimentCompletedEvent, AutoresearchExperimentStartedEvent, AutoresearchInitializedEvent, AutoresearchMetricImprovedEvent, AutoresearchPhaseChangedEvent, AutoresearchResumedEvent, AutoresearchRevertEvent, AutoresearchRevertFailedEvent, AutoresearchStateUpdatedEvent } from "./autoresearchTypes.js";
 /**
  * Type-safe unknown value - use when type is truly unknown
  */
@@ -115,6 +116,16 @@ export type NeuroLinkEvents = {
     error: unknown;
     log: unknown;
     "log-event": unknown;
+    "autoresearch:initialized": AutoresearchInitializedEvent;
+    "autoresearch:resumed": AutoresearchResumedEvent;
+    "autoresearch:phase-changed": AutoresearchPhaseChangedEvent;
+    "autoresearch:experiment-started": AutoresearchExperimentStartedEvent;
+    "autoresearch:experiment-completed": AutoresearchExperimentCompletedEvent;
+    "autoresearch:metric-improved": AutoresearchMetricImprovedEvent;
+    "autoresearch:revert": AutoresearchRevertEvent;
+    "autoresearch:revert-failed": AutoresearchRevertFailedEvent;
+    "autoresearch:state-updated": AutoresearchStateUpdatedEvent;
+    "autoresearch:error": AutoresearchErrorEvent;
     [key: string]: unknown;
 };
 /**

package/dist/lib/types/configTypes.d.ts

@@ -11,6 +11,7 @@ import type { RoutingStrategy } from "../mcp/routing/index.js";
 import type { CacheStrategy } from "../mcp/caching/index.js";
 import type { ToolMiddleware } from "../mcp/toolIntegration.js";
 import type { MastraAuthProvider, AuthProviderType, AuthProviderConfig, Auth0Config, ClerkConfig, FirebaseConfig, SupabaseConfig, WorkOSConfig, BetterAuthConfig, JWTConfig, OAuth2Config, CognitoConfig, KeycloakConfig, AuthenticatedContext } from "./authTypes.js";
+import type { NeurolinkCredentials } from "./providers.js";
 /**
  * Main NeuroLink configuration type
  */
@@ -39,6 +40,12 @@ export type NeurolinkConstructorConfig = {
     auth?: NeuroLinkAuthConfig;
     /** TaskManager configuration (scheduled and self-running tasks) */
     tasks?: TaskManagerConfig;
+    /**
+     * Per-provider credential overrides.
+     * When set here, applies as the default for all generate()/stream() calls
+     * from this NeuroLink instance. Per-call credentials override these.
+     */
+    credentials?: NeurolinkCredentials;
 };
 /**
  * Configuration for MCP enhancement modules wired into generate()/stream() paths.

package/dist/lib/types/generateTypes.d.ts

@@ -11,6 +11,7 @@ import type { DirectorModeOptions, DirectorSegment, VideoGenerationResult, Video
 import type { PPTGenerationResult, PPTOutputOptions } from "./pptTypes.js";
 import type { TTSOptions, TTSResult } from "./ttsTypes.js";
 import type { StandardRecord, ValidationSchema, ZodUnknownSchema } from "./typeAliases.js";
+import type { NeurolinkCredentials } from "./providers.js";
 /**
  * Generate function options type - Primary method for content generation
  * Supports multimodal content while maintaining backward compatibility
@@ -424,6 +425,12 @@ export type GenerateOptions = {
     auth?: {
         token: string;
     };
+    /**
+     * Per-provider credential overrides for this request.
+     * Overrides instance-level credentials set in `new NeuroLink({ credentials })`.
+     * Unset providers fall through to instance credentials, then environment variables.
+     */
+    credentials?: NeurolinkCredentials;
     /**
      * Per-call memory control.
      *
@@ -942,6 +949,12 @@ export type TextGenerationOptions = {
         /** Thinking level (Gemini 3: minimal|low|medium|high). Ignored for Anthropic. */
         thinkingLevel?: "minimal" | "low" | "medium" | "high";
     };
+    /**
+     * Per-provider credential overrides for this request.
+     * Overrides instance-level credentials set in `new NeuroLink({ credentials })`.
+     * Unset providers fall through to instance credentials, then environment variables.
+     */
+    credentials?: NeurolinkCredentials;
     /**
      * Optional request identifier for observability and log correlation.
      * When provided, this ID is forwarded to spans, logs, and telemetry so

package/dist/lib/types/index.d.ts

@@ -19,35 +19,37 @@ export { PROCESSOR_PRIORITIES } from "../processors/base/types.js";
 export type { ActionAWSConfig, ActionCommentResult, ActionEvaluation, ActionExecutionResult, ActionGoogleCloudConfig, ActionInputs, ActionInputValidation, ActionMultimodalInputs, ActionOutput, ActionProviderKeys, ActionThinkingConfig, ActionTokenUsage, CliAnalytics, CliEvaluation, CliResponse, CliTokenUsage, ProviderKeyMapping, } from "./actionTypes.js";
 export type { AnalyticsData, AnalyticsErrorInfo, PerformanceMetrics, StreamAnalyticsData, TokenUsage, } from "./analytics.js";
 export * from "./multimodal.js";
+export type { Auth0Config, AuthCacheConfig, AuthErrorCode, AuthErrorInfo, AuthErrorInfo as AuthErrorType, AuthEventData, AuthEventHandler, AuthEvents, AuthEventType, AuthenticatedContext, AuthHealthCheck, AuthLifecycle, AuthMiddlewareConfig, AuthMiddlewareOptions, AuthorizationResult, AuthProviderConfig, AuthProviderFactoryFn, AuthProviderHealthCheck, AuthProviderHealthStatus, AuthProviderMetadata, AuthProviderRegistration, AuthProviderType, AuthRequestContext, AuthRequestHandler, AuthSession, AuthSessionManager, AuthTokenValidator, AuthUser, AuthUserAuthorizer, AuthUserManager, BaseAuthProviderConfig, BetterAuthConfig, ClerkConfig, CognitoConfig, CustomAuthConfig, FirebaseConfig, JWK, JWKS, JWTConfig, KeycloakConfig, MastraAuthProvider, OAuth2Config, PermissionDefinition, RBACConfig, RBACMiddlewareConfig, SessionConfig, SessionStorage, SessionStorageType, SessionValidationResult, SupabaseConfig, TokenClaims, TokenExtractionConfig, TokenExtractionStrategy, TokenRefreshResult, TokenType, TokenValidationConfig, TokenValidationResult as AuthTokenValidationResult, WorkOSConfig, } from "./authTypes.js";
+export type { AutoresearchEmitter, AutoresearchErrorEvent, AutoresearchEventMap, AutoresearchEventName, AutoresearchExperimentCompletedEvent, AutoresearchExperimentStartedEvent, AutoresearchInitializedEvent, AutoresearchMetricImprovedEvent, AutoresearchPhaseChangedEvent, AutoresearchResumedEvent, AutoresearchRevertEvent, AutoresearchRevertFailedEvent, AutoresearchStateUpdatedEvent, ExperimentPhase, ExperimentRecord, ExperimentStats, ExperimentStatus, ExperimentSummary, MemoryMetricConfig, MetricConfig, MetricDirection, PhaseToolPolicy, ResearchConfig, ResearchState, ResearchWorkerConfig, } from "./autoresearchTypes.js";
+export { AUTORESEARCH_DEFAULTS } from "./autoresearchTypes.js";
+export type { AgentExecuteOptions as ClientAgentExecuteOptions, AgentExecuteResult as ClientAgentExecuteResult, AgentInfo as ClientAgentInfo, ApiError as ClientApiError, AuthConfig as ClientAuthConfig, ClientApiResponse, ClientChatMessage, ClientConfig, ClientMiddlewareContext, ClientOAuth2Config, ClientProviderStatus, ClientRetryConfig, ClientStreamEvent, ClientStreamResult, ClientTokenRefreshResult, GenerateRequestOptions as ClientGenerateRequestOptions, GenerateResponse as ClientGenerateResponse, LanguageModel as ClientLanguageModel, LanguageModelCallOptions as ClientLanguageModelCallOptions, LanguageModelResponse as ClientLanguageModelResponse, LanguageModelStreamResponse as ClientLanguageModelStreamResponse, Middleware as ClientMiddleware, MiddlewareRequest as ClientMiddlewareRequest, MiddlewareResponse as ClientMiddlewareResponse, ModelOptions as ClientModelOptions, NeuroLinkProviderOptions, RequestOptions as ClientRequestOptions, SpeechRecognitionResult as ClientSpeechRecognitionResult, SpeechSynthesisOptions as ClientSpeechSynthesisOptions, StreamCallbacks as ClientStreamCallbacks, StreamEventType as ClientStreamEventType, StreamRequestOptions as ClientStreamRequestOptions, ToolInfo as ClientToolInfo, UseAgentOptions, UseAgentReturn, UseChatOptions, UseChatReturn, UseStreamOptions, UseStreamReturn, UseToolsOptions, UseToolsReturn, UseVoiceOptions, UseVoiceReturn, UseWorkflowOptions, UseWorkflowReturn, WebSocketMessageHandler as ClientWebSocketMessageHandler, WebSocketOptions as ClientWebSocketOptions, WebSocketState as ClientWebSocketState, WorkflowExecuteOptions as ClientWorkflowExecuteOptions, WorkflowExecuteResult as ClientWorkflowExecuteResult, WorkflowInfo as ClientWorkflowInfo, WSClientConfig, WSClientEventHandlers, WSClientMessage, WSClientState, } from "./clientTypes.js";
+export * from "./contextTypes.js";
+export type { ConversationData, ConversationSummary, NeurolinkOptions, StorageConfig, } from "./conversation.js";
+export * from "./conversationMemoryInterface.js";
 export type { DomainConfig, DomainConfigOptions, DomainEvaluationCriteria, DomainTemplate, DomainType, DomainValidationRule, } from "./domainTypes.js";
+export { AuthenticationError, AuthorizationError, NetworkError, RateLimitError, } from "./errors.js";
 export * from "./evaluation.js";
 export * from "./evaluationProviders.js";
+export * from "./fileReferenceTypes.js";
 export * from "./fileTypes.js";
 export type { AdditionalMemoryUser, EnhancedGenerateResult, EnhancedProvider, FactoryEnhancedProvider, GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
 TextGenerationOptions, TextGenerationResult, UnifiedGenerationOptions, } from "./generateTypes.js";
 export * from "./hitlTypes.js";
 export * from "./middlewareTypes.js";
 export * from "./modelTypes.js";
+export * from "./proxyTypes.js";
+export * from "./ragTypes.js";
 export * from "./scorerTypes.js";
 export * from "./sdkTypes.js";
+export type { AgentExecuteRequest, AgentExecuteResponse, AuthConfig as ServerAuthConfig, AuthenticatedUser, AuthStrategy, BodyParserConfig, CORSConfig, DataStreamWriter, EmbedManyRequest, EmbedManyResponse, EmbedRequest, EmbedResponse, ErrorCategory, ErrorCategoryType, ErrorSeverity, ErrorSeverityType, HealthResponse, HttpMethod, LoggingConfig, MCPServerStatusResponse, MiddlewareDefinition, MiddlewareHandler, RateLimitConfig as ServerRateLimitConfig, ReadyResponse, RedactionConfig, RequiredBodyParserConfig, RequiredCORSConfig, RequiredLoggingConfig, RequiredRateLimitConfig, RequiredRedactionConfig, RequiredServerAdapterConfig, RequiredShutdownConfig, RouteDefinition, RouteDeprecation, RouteGroup, RouteHandler, ServerAdapterConfig, ServerAdapterErrorCode, ServerAdapterErrorCodeType, ServerAdapterErrorContext, ServerAdapterEvents, ServerAdapterFactoryOptions, ServerContext, ServerFramework, ServerLifecycleState, ServerResponse, ServerStatus, ShutdownConfig, SSEWriteOptions, StreamingConfig, ToolExecuteRequest, ToolExecuteResponse, TrackedConnection, WebSocketConfig, WebSocketConnection, WebSocketHandler, WebSocketMessage, WebSocketMessageType, } from "./serverTypes.js";
 export * from "./serviceTypes.js";
 export type { EnhancedStreamProvider, ProgressCallback, StreamingMetadata, StreamingOptions, StreamingProgressData, StreamOptions, StreamResult, ToolCall as StreamToolCall, // Renamed to avoid conflict with tools.js ToolCall
 ToolCallResults, ToolCalls, ToolResult as StreamToolResult, } from "./streamTypes.js";
+export type { TokenRefresher } from "./subscriptionTypes.js";
+export * from "./subscriptionTypes.js";
+export type { AutoresearchTaskConfig, ConversationEntry as TaskConversationEntry, CronSchedule, IntervalSchedule, OnceSchedule, ScheduledTaskType, Task, TaskBackend, TaskBackendName, TaskDefinition, TaskExecutionMode, TaskManagerConfig, TaskRetentionConfig, TaskRunError, TaskRunResult, TaskSchedule, TaskScheduleType, TaskStatus, TaskStore, WorkerState, } from "./taskTypes.js";
+export { TASK_DEFAULTS } from "./taskTypes.js";
 export * from "./ttsTypes.js";
 export * from "./utilities.js";
 export type { AggregatedUsage, ConditioningConfig, ConditionOptions, ConditionResult, EnsembleExecutionResult, EnsembleResponse, ExecuteEnsembleOptions, ExecuteLayerOptions, ExecuteModelOptions, ExecutionConfig, ExecutionStrategy, JudgeConfig, JudgeOutputFormat, JudgeScores, LayerExecutionResult, ListOptions, ModelGroup, MultiJudgeScores, ParsedJudgeResponse, RegisterOptions, RegisterResult, RegistryEntry, RegistryStats, ScoreOptions, ScoreResult as WorkflowScoreResult, SummaryStats, ToneAdjustment, ValidationIssues, WorkflowAnalytics, WorkflowComparison, WorkflowConfig, WorkflowErrorDetails, WorkflowEvaluationData, WorkflowExecutionMetrics, WorkflowGenerateOptions, WorkflowInput, WorkflowMetadata, WorkflowModelConfig, WorkflowResult, WorkflowType, WorkflowValidationError, WorkflowValidationResult, WorkflowValidationWarning, } from "./workflowTypes.js";
 export { WorkflowError } from "./workflowTypes.js";
-export * from "./contextTypes.js";
-export * from "./fileReferenceTypes.js";
-export * from "./ragTypes.js";
-export type { AgentExecuteRequest, AgentExecuteResponse, AuthConfig as ServerAuthConfig, AuthenticatedUser, AuthStrategy, BodyParserConfig, CORSConfig, DataStreamWriter, EmbedManyRequest, EmbedManyResponse, EmbedRequest, EmbedResponse, ErrorCategory, ErrorCategoryType, ErrorSeverity, ErrorSeverityType, HealthResponse, HttpMethod, LoggingConfig, MCPServerStatusResponse, MiddlewareDefinition, MiddlewareHandler, RateLimitConfig as ServerRateLimitConfig, ReadyResponse, RedactionConfig, RequiredBodyParserConfig, RequiredCORSConfig, RequiredLoggingConfig, RequiredRateLimitConfig, RequiredRedactionConfig, RequiredServerAdapterConfig, RequiredShutdownConfig, RouteDefinition, RouteDeprecation, RouteGroup, RouteHandler, ServerAdapterConfig, ServerAdapterErrorCode, ServerAdapterErrorCodeType, ServerAdapterErrorContext, ServerAdapterEvents, ServerAdapterFactoryOptions, ServerContext, ServerFramework, ServerLifecycleState, ServerResponse, ServerStatus, ShutdownConfig, SSEWriteOptions, StreamingConfig, ToolExecuteRequest, ToolExecuteResponse, TrackedConnection, WebSocketConfig, WebSocketConnection, WebSocketHandler, WebSocketMessage, WebSocketMessageType, } from "./serverTypes.js";
-export * from "./conversationMemoryInterface.js";
-export type { StorageConfig, ConversationData, ConversationSummary, NeurolinkOptions, } from "./conversation.js";
-export { AuthenticationError, AuthorizationError, NetworkError, RateLimitError, } from "./errors.js";
-export * from "./subscriptionTypes.js";
-export type { ClientConfig, RequestOptions as ClientRequestOptions, ClientRetryConfig, ClientApiResponse, ApiError as ClientApiError, ClientProviderStatus, StreamEventType as ClientStreamEventType, ClientStreamEvent, StreamCallbacks as ClientStreamCallbacks, ClientStreamResult, GenerateRequestOptions as ClientGenerateRequestOptions, GenerateResponse as ClientGenerateResponse, StreamRequestOptions as ClientStreamRequestOptions, AgentExecuteOptions as ClientAgentExecuteOptions, AgentExecuteResult as ClientAgentExecuteResult, AgentInfo as ClientAgentInfo, WorkflowExecuteOptions as ClientWorkflowExecuteOptions, WorkflowExecuteResult as ClientWorkflowExecuteResult, WorkflowInfo as ClientWorkflowInfo, ToolInfo as ClientToolInfo, Middleware as ClientMiddleware, MiddlewareRequest as ClientMiddlewareRequest, MiddlewareResponse as ClientMiddlewareResponse, ClientMiddlewareContext, ClientChatMessage, UseChatOptions, UseChatReturn, UseAgentOptions, UseAgentReturn, UseWorkflowOptions, UseWorkflowReturn, UseVoiceOptions, UseVoiceReturn, UseStreamOptions, UseStreamReturn, UseToolsOptions, UseToolsReturn, LanguageModel as ClientLanguageModel, LanguageModelCallOptions as ClientLanguageModelCallOptions, LanguageModelResponse as ClientLanguageModelResponse, LanguageModelStreamResponse as ClientLanguageModelStreamResponse, NeuroLinkProviderOptions, ModelOptions as ClientModelOptions, WebSocketOptions as ClientWebSocketOptions, WebSocketState as ClientWebSocketState, WebSocketMessageHandler as ClientWebSocketMessageHandler, WSClientState, WSClientConfig, WSClientMessage, WSClientEventHandlers, SpeechRecognitionResult as ClientSpeechRecognitionResult, SpeechSynthesisOptions as ClientSpeechSynthesisOptions, AuthConfig as ClientAuthConfig, ClientOAuth2Config, ClientTokenRefreshResult, } from "./clientTypes.js";
-export type { TokenRefresher } from "./subscriptionTypes.js";
-export * from "./proxyTypes.js";
-export type { AuthProviderType, AuthProviderConfig, MastraAuthProvider, BetterAuthConfig, Auth0Config, ClerkConfig, FirebaseConfig, SupabaseConfig, WorkOSConfig, JWTConfig, OAuth2Config, CognitoConfig, KeycloakConfig, CustomAuthConfig, BaseAuthProviderConfig, AuthUser, AuthSession, TokenType, TokenValidationResult as AuthTokenValidationResult, TokenClaims, JWK, JWKS, TokenRefreshResult, TokenValidationConfig, TokenExtractionConfig, SessionValidationResult, SessionStorage, AuthorizationResult, AuthRequestContext, AuthenticatedContext, TokenExtractionStrategy, SessionConfig, SessionStorageType, RBACConfig, PermissionDefinition, AuthCacheConfig, AuthMiddlewareOptions, AuthMiddlewareConfig, RBACMiddlewareConfig, AuthErrorCode, AuthErrorInfo, AuthErrorInfo as AuthErrorType, AuthEventType, AuthEventData, AuthEventHandler, AuthProviderFactoryFn, AuthProviderRegistration, AuthHealthCheck, AuthProviderHealthCheck, AuthEvents, AuthProviderMetadata, AuthProviderHealthStatus, AuthTokenValidator, AuthUserAuthorizer, AuthSessionManager, AuthRequestHandler, AuthUserManager, AuthLifecycle, } from "./authTypes.js";
-export type { Task, TaskDefinition, TaskSchedule, TaskScheduleType, CronSchedule, IntervalSchedule, OnceSchedule, TaskExecutionMode, TaskStatus, TaskRunResult, TaskRunError, TaskStore, TaskBackend, TaskBackendName, TaskManagerConfig, TaskRetentionConfig, WorkerState, ConversationEntry as TaskConversationEntry, } from "./taskTypes.js";
-export { TASK_DEFAULTS } from "./taskTypes.js";

package/dist/lib/types/index.js

@@ -16,10 +16,22 @@ export * from "./tools.js";
 export { PROCESSOR_PRIORITIES } from "../processors/base/types.js";
 // Content types for multimodal support (direct export from canonical source)
 export * from "./multimodal.js";
+export { AUTORESEARCH_DEFAULTS } from "./autoresearchTypes.js";
+// Content types: canonical source is ./multimodal.js (already exported above).
+// ./content.js re-exports from multimodal for backward compat but is NOT
+// re-exported here to avoid duplicate symbol collisions.
+// Context compaction types
+export * from "./contextTypes.js";
+// Conversation memory manager type
+export * from "./conversationMemoryInterface.js";
+// Error classes
+export { AuthenticationError, AuthorizationError, NetworkError, RateLimitError, } from "./errors.js";
 // Evaluation types - NEW
 export * from "./evaluation.js";
 // Evaluation provider types - NEW
 export * from "./evaluationProviders.js";
+// File reference types
+export * from "./fileReferenceTypes.js";
 // File detection and processing types
 export * from "./fileTypes.js";
 // HITL (Human-in-the-Loop) types
@@ -28,6 +40,10 @@ export * from "./hitlTypes.js";
 export * from "./middlewareTypes.js";
 // Model types - NEW
 export * from "./modelTypes.js";
+// Proxy types (Claude API format, cloaking, routing, config, stats, server adapters)
+export * from "./proxyTypes.js";
+// RAG types
+export * from "./ragTypes.js";
 // Scorer types for evaluation system
 export * from "./scorerTypes.js";
 // SDK Types - Core types for external developers
@@ -36,27 +52,15 @@ export * from "./scorerTypes.js";
 export * from "./sdkTypes.js";
 // Service types - NEW
 export * from "./serviceTypes.js";
-// TTS (Text-to-Speech) types
-export * from "./ttsTypes.js";
-// Utilities Types - Utility module types (selective export to avoid conflicts)
-export * from "./utilities.js";
-export { WorkflowError } from "./workflowTypes.js";
-// Context compaction types
-export * from "./contextTypes.js";
-// File reference types
-export * from "./fileReferenceTypes.js";
-// RAG types
-export * from "./ragTypes.js";
-// Conversation memory manager type
-export * from "./conversationMemoryInterface.js";
-// Error classes
-export { AuthenticationError, AuthorizationError, NetworkError, RateLimitError, } from "./errors.js";
 // Subscription types (Claude subscription tiers, authentication, usage tracking)
 // NOTE: subscriptionTypes.ts re-exports auth types from ./authTypes.ts for
 // backward compatibility. Import StoredOAuthTokens, TokenRefresher, etc.
 // from authTypes.ts for new code.
 export * from "./subscriptionTypes.js";
-// Proxy types (Claude API format, cloaking, routing, config, stats, server adapters)
-export * from "./proxyTypes.js";
 export { TASK_DEFAULTS } from "./taskTypes.js";
+// TTS (Text-to-Speech) types
+export * from "./ttsTypes.js";
+// Utilities Types - Utility module types (selective export to avoid conflicts)
+export * from "./utilities.js";
+export { WorkflowError } from "./workflowTypes.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/types/providers.d.ts

@@ -71,6 +71,81 @@ export type AWSCredentialConfig = {
     /** Optional service endpoint override (e.g., VPC/Gov endpoints) */
     endpoint?: string;
 };
+/**
+ * Per-provider credential overrides for generate() / stream() calls.
+ *
+ * When set on `NeurolinkConstructorConfig.credentials`, applies as the default
+ * for all calls from that NeuroLink instance. When set on
+ * `GenerateOptions.credentials` or `StreamOptions.credentials`, overrides the
+ * instance default for that single call.
+ *
+ * Unset providers fall through to environment variables (existing behaviour).
+ */
+export type NeurolinkCredentials = {
+    openai?: {
+        apiKey?: string;
+        baseURL?: string;
+    };
+    anthropic?: {
+        apiKey?: string;
+        oauthToken?: string;
+    };
+    googleAiStudio?: {
+        apiKey?: string;
+    };
+    vertex?: {
+        projectId?: string;
+        location?: string;
+        /** Vertex Express Mode — simplified API-key auth */
+        apiKey?: string;
+        /** Full service-account JSON string */
+        serviceAccountKey?: string;
+        /** Inline service-account fields (alternative to serviceAccountKey) */
+        clientEmail?: string;
+        privateKey?: string;
+    };
+    bedrock?: {
+        accessKeyId?: string;
+        secretAccessKey?: string;
+        sessionToken?: string;
+        region?: string;
+    };
+    sagemaker?: {
+        accessKeyId?: string;
+        secretAccessKey?: string;
+        sessionToken?: string;
+        region?: string;
+        endpoint?: string;
+    };
+    azure?: {
+        apiKey?: string;
+        resourceName?: string;
+        deploymentName?: string;
+        apiVersion?: string;
+    };
+    mistral?: {
+        apiKey?: string;
+    };
+    huggingFace?: {
+        apiKey?: string;
+        baseURL?: string;
+    };
+    openrouter?: {
+        apiKey?: string;
+        baseURL?: string;
+    };
+    litellm?: {
+        apiKey?: string;
+        baseURL?: string;
+    };
+    openaiCompatible?: {
+        apiKey?: string;
+        baseURL?: string;
+    };
+    ollama?: {
+        baseURL?: string;
+    };
+};
 /**
  * AWS Credential Validation Result
  */

package/dist/lib/types/streamTypes.d.ts

@@ -9,7 +9,7 @@ import type { JsonValue, UnknownRecord } from "./common.js";
 import type { Content, ImageWithAltText } from "./content.js";
 import type { ChatMessage } from "./conversation.js";
 import type { AdditionalMemoryUser } from "./generateTypes.js";
-import type { AIModelProviderConfig } from "./providers.js";
+import type { AIModelProviderConfig, NeurolinkCredentials } from "./providers.js";
 import type { TTSChunk, TTSOptions } from "./ttsTypes.js";
 import type { StandardRecord, ValidationSchema } from "./typeAliases.js";
 /**
@@ -444,6 +444,12 @@ export type StreamOptions = {
     auth?: {
         token: string;
     };
+    /**
+     * Per-provider credential overrides for this request.
+     * Overrides instance-level credentials set in `new NeuroLink({ credentials })`.
+     * Unset providers fall through to instance credentials, then environment variables.
+     */
+    credentials?: NeurolinkCredentials;
     /**
      * Per-call memory control.
      *

package/dist/lib/types/taskTypes.d.ts

@@ -6,7 +6,37 @@
  */
 import type { Cron } from "croner";
 import type { createClient } from "redis";
+import type { MemoryMetricConfig, MetricConfig } from "./autoresearchTypes.js";
 import type { ThinkingLevel } from "./configTypes.js";
+/**
+ * Discriminator for standard vs autoresearch tasks.
+ * - "standard": Normal prompt-based task (default)
+ * - "autoresearch": Autonomous experiment loop task
+ */
+export type ScheduledTaskType = "standard" | "autoresearch";
+/**
+ * Configuration for autoresearch tasks.
+ * Embedded in TaskDefinition/Task when type === "autoresearch".
+ */
+export type AutoresearchTaskConfig = {
+    repoPath: string;
+    mutablePaths: string[];
+    runCommand: string;
+    metric: MetricConfig;
+    immutablePaths?: string[];
+    timeoutMs?: number;
+    maxExperiments?: number;
+    provider?: string;
+    model?: string;
+    thinkingLevel?: ThinkingLevel;
+    maxBudgetUsd?: number;
+    programPath?: string;
+    resultsPath?: string;
+    statePath?: string;
+    logPath?: string;
+    branchPrefix?: string;
+    memoryMetric?: MemoryMetricConfig;
+};
 export type TaskScheduleType = "cron" | "interval" | "once";
 export type CronSchedule = {
     type: "cron";
@@ -37,6 +67,10 @@ export type TaskDefinition = {
     prompt: string;
     schedule: TaskSchedule;
     mode?: TaskExecutionMode;
+    /** Task type discriminator. Default: "standard" */
+    type?: ScheduledTaskType;
+    /** Autoresearch config (required when type === "autoresearch") */
+    autoresearch?: AutoresearchTaskConfig;
     provider?: string;
     model?: string;
     thinkingLevel?: ThinkingLevel;
@@ -67,7 +101,11 @@ export type Task = {
     prompt: string;
     schedule: TaskSchedule;
     mode: TaskExecutionMode;
+    /** Task type discriminator. Default: "standard" */
+    type: ScheduledTaskType;
     status: TaskStatus;
+    /** Autoresearch config (present when type === "autoresearch") */
+    autoresearch?: AutoresearchTaskConfig;
     provider?: string;
     model?: string;
     thinkingLevel?: ThinkingLevel;

package/dist/lib/workflow/config.d.ts

@@ -41,8 +41,8 @@ export declare const JudgeConfigSchema: z.ZodObject<{
     model: z.ZodString;
     criteria: z.ZodArray<z.ZodString>;
     outputFormat: z.ZodEnum<{
-        detailed: "detailed";
         scores: "scores";
+        detailed: "detailed";
         ranking: "ranking";
         best: "best";
     }>;
@@ -195,8 +195,8 @@ export declare const WorkflowConfigSchema: z.ZodObject<{
         model: z.ZodString;
         criteria: z.ZodArray<z.ZodString>;
         outputFormat: z.ZodEnum<{
-            detailed: "detailed";
             scores: "scores";
+            detailed: "detailed";
             ranking: "ranking";
             best: "best";
         }>;
@@ -219,8 +219,8 @@ export declare const WorkflowConfigSchema: z.ZodObject<{
         model: z.ZodString;
         criteria: z.ZodArray<z.ZodString>;
         outputFormat: z.ZodEnum<{
-            detailed: "detailed";
             scores: "scores";
+            detailed: "detailed";
             ranking: "ranking";
             best: "best";
         }>;

package/dist/neurolink.d.ts

@@ -73,6 +73,27 @@ export declare class NeuroLink {
     private authProvider?;
     private pendingAuthConfig?;
     private authInitPromise?;
+    private credentials?;
+    /**
+     * Merge instance-level credentials with per-call credentials.
+     *
+     * Semantics: **deep merge at the provider level.** For each provider key
+     * present in both `this.credentials` and `callCredentials`, the per-call
+     * fields are merged ON TOP of the instance-level fields, so fields not
+     * mentioned in the per-call slice are preserved.
+     *
+     * Example:
+     * ```
+     * instance:  { openai: { apiKey: "key1", baseURL: "url1" } }
+     * per-call:  { openai: { apiKey: "key2" } }
+     * merged:    { openai: { apiKey: "key2", baseURL: "url1" } }   // baseURL preserved
+     * ```
+     *
+     * Providers present only in one source are carried through unchanged.
+     * Unrelated providers (not overridden in callCredentials) are carried through
+     * from instance credentials unchanged.
+     */
+    private resolveCredentials;
     private hitlManager?;
     private _sessionCostUsd;
     private fileRegistry;