@juspay/neurolink 9.52.0 → 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/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/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.js

@@ -28,9 +28,9 @@ import { getContextOverflowProvider, isContextOverflowError, parseProviderOverfl
 import { ContextBudgetExceededError } from "./context/errors.js";
 import { repairToolPairs } from "./context/toolPairRepair.js";
 import { SYSTEM_LIMITS } from "./core/constants.js";
-import { createToolEventPayload } from "./core/toolEvents.js";
 import { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
 import { AIProviderFactory } from "./core/factory.js";
+import { createToolEventPayload } from "./core/toolEvents.js";
 import { ProviderRegistry } from "./factories/providerRegistry.js";
 import { FileReferenceRegistry } from "./files/fileReferenceRegistry.js";
 import { createFileTools } from "./files/fileTools.js";
@@ -2705,6 +2705,7 @@ Current user's request: ${currentInput}`;
             region: options.region,
             tts: options.tts,
             fileRegistry: this.fileRegistry,
+            timeout: options.timeout,
             abortSignal: options.abortSignal,
             skipToolPromptInjection: options.skipToolPromptInjection,
             middleware: options.middleware,
@@ -4108,7 +4109,26 @@ Current user's request: ${currentInput}`;
                     responseTime,
                     finishReason: result.finishReason,
                     toolsUsed: result.toolsUsed || [],
-                    enhancedWithTools: false,
+                    // Map toolExecutions from EnhancedGenerateResult shape ({name,input,output})
+                    // to TextGenerationResult shape ({toolName,executionTime,success}).
+                    // Preserve original timing/status when present, fall back to safe defaults.
+                    toolExecutions: result.toolExecutions?.map((te) => {
+                        const t = te;
+                        return {
+                            // Spread original fields first so normalized fields take precedence
+                            ...te,
+                            toolName: te.name,
+                            executionTime: typeof t.executionTime === "number"
+                                ? t.executionTime
+                                : typeof t.duration === "number"
+                                    ? t.duration
+                                    : 0,
+                            success: typeof t.success === "boolean"
+                                ? t.success
+                                : t.status === "success",
+                        };
+                    }),
+                    enhancedWithTools: !!result.toolExecutions?.length,
                     analytics: result.analytics,
                     evaluation: result.evaluation,
                     audio: result.audio,

package/dist/providers/litellm.js

@@ -1,6 +1,6 @@
 import { createOpenAI } from "@ai-sdk/openai";
 import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
-import { NoOutputGeneratedError, Output, streamText, } from "ai";
+import { NoOutputGeneratedError, Output, stepCountIs, streamText, } from "ai";
 import { BaseProvider } from "../core/baseProvider.js";
 import { DEFAULT_MAX_STEPS } from "../core/constants.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
@@ -165,7 +165,7 @@ export class LiteLLMProvider extends BaseProvider {
                     Object.keys(tools).length > 0 && {
                     tools,
                     toolChoice: resolveToolChoice(options, tools, shouldUseTools),
-                    maxSteps: options.maxSteps || DEFAULT_MAX_STEPS,
+                    stopWhen: stepCountIs(options.maxSteps || DEFAULT_MAX_STEPS),
                 }),
                 abortSignal: composeAbortSignals(options.abortSignal, timeoutController?.controller.signal),
                 experimental_telemetry: this.telemetryHandler.getTelemetryConfig(options),

package/dist/providers/openRouter.js

@@ -1,5 +1,5 @@
 import { createOpenRouter } from "@openrouter/ai-sdk-provider";
-import { NoOutputGeneratedError, Output, streamText, } from "ai";
+import { NoOutputGeneratedError, Output, stepCountIs, streamText, } from "ai";
 import { AIProviderName } from "../constants/enums.js";
 import { BaseProvider } from "../core/baseProvider.js";
 import { DEFAULT_MAX_STEPS } from "../core/constants.js";
@@ -248,7 +248,7 @@ export class OpenRouterProvider extends BaseProvider {
                     Object.keys(tools).length > 0 && {
                     tools,
                     toolChoice: resolveToolChoice(options, tools, shouldUseTools),
-                    maxSteps: options.maxSteps || DEFAULT_MAX_STEPS,
+                    stopWhen: stepCountIs(options.maxSteps || DEFAULT_MAX_STEPS),
                 }),
                 abortSignal: composeAbortSignals(options.abortSignal, timeoutController?.controller.signal),
                 experimental_telemetry: this.telemetryHandler.getTelemetryConfig(options),

package/dist/providers/openaiCompatible.js

@@ -1,6 +1,7 @@
 import { createOpenAI } from "@ai-sdk/openai";
-import { NoOutputGeneratedError, streamText, } from "ai";
+import { NoOutputGeneratedError, stepCountIs, streamText, } from "ai";
 import { BaseProvider } from "../core/baseProvider.js";
+import { DEFAULT_MAX_STEPS } from "../core/constants.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
 import { createProxyFetch } from "../proxy/proxyFetch.js";
 import { logger } from "../utils/logger.js";
@@ -191,6 +192,7 @@ export class OpenAICompatibleProvider extends BaseProvider {
                     : {}),
                 tools,
                 toolChoice: resolveToolChoice(options, tools, shouldUseTools),
+                stopWhen: stepCountIs(options.maxSteps || DEFAULT_MAX_STEPS),
                 abortSignal: composeAbortSignals(options.abortSignal, timeoutController?.controller.signal),
                 experimental_telemetry: this.telemetryHandler.getTelemetryConfig(options),
                 onStepFinish: (event) => {

package/dist/rag/errors/RAGError.d.ts

@@ -82,7 +82,7 @@ export declare const RAGErrorFactory: {
         readonly RETRY_EXHAUSTED: "RAG_RETRY_EXHAUSTED";
         readonly INVALID_CONFIGURATION: "RAG_INVALID_CONFIGURATION";
     };
-    create: (code: "CHUNKING_ERROR" | "CHUNKING_INVALID_CONFIG" | "CHUNKING_STRATEGY_NOT_FOUND" | "CHUNKING_EMPTY_CONTENT" | "CHUNKING_SIZE_EXCEEDED" | "METADATA_EXTRACTION_ERROR" | "METADATA_EXTRACTION_TIMEOUT" | "METADATA_SCHEMA_INVALID" | "METADATA_EXTRACTOR_NOT_FOUND" | "EMBEDDING_ERROR" | "EMBEDDING_DIMENSION_MISMATCH" | "EMBEDDING_RATE_LIMIT" | "EMBEDDING_PROVIDER_ERROR" | "VECTOR_QUERY_ERROR" | "VECTOR_QUERY_TIMEOUT" | "VECTOR_STORE_UNAVAILABLE" | "VECTOR_STORE_CONNECTION_ERROR" | "VECTOR_INDEX_NOT_FOUND" | "RERANKER_ERROR" | "RERANKER_NOT_FOUND" | "RERANKER_API_ERROR" | "GRAPH_RAG_ERROR" | "GRAPH_TRAVERSAL_ERROR" | "GRAPH_NODE_NOT_FOUND" | "PIPELINE_ERROR" | "PIPELINE_STAGE_FAILED" | "PIPELINE_PARTIAL_FAILURE" | "CIRCUIT_BREAKER_OPEN" | "CIRCUIT_BREAKER_HALF_OPEN_LIMIT" | "OPERATION_TIMEOUT" | "RETRY_EXHAUSTED" | "INVALID_CONFIGURATION", message: string, options?: {
+    create: (code: "INVALID_CONFIGURATION" | "CHUNKING_ERROR" | "CHUNKING_INVALID_CONFIG" | "CHUNKING_STRATEGY_NOT_FOUND" | "CHUNKING_EMPTY_CONTENT" | "CHUNKING_SIZE_EXCEEDED" | "METADATA_EXTRACTION_ERROR" | "METADATA_EXTRACTION_TIMEOUT" | "METADATA_SCHEMA_INVALID" | "METADATA_EXTRACTOR_NOT_FOUND" | "EMBEDDING_ERROR" | "EMBEDDING_DIMENSION_MISMATCH" | "EMBEDDING_RATE_LIMIT" | "EMBEDDING_PROVIDER_ERROR" | "VECTOR_QUERY_ERROR" | "VECTOR_QUERY_TIMEOUT" | "VECTOR_STORE_UNAVAILABLE" | "VECTOR_STORE_CONNECTION_ERROR" | "VECTOR_INDEX_NOT_FOUND" | "RERANKER_ERROR" | "RERANKER_NOT_FOUND" | "RERANKER_API_ERROR" | "GRAPH_RAG_ERROR" | "GRAPH_TRAVERSAL_ERROR" | "GRAPH_NODE_NOT_FOUND" | "PIPELINE_ERROR" | "PIPELINE_STAGE_FAILED" | "PIPELINE_PARTIAL_FAILURE" | "CIRCUIT_BREAKER_OPEN" | "CIRCUIT_BREAKER_HALF_OPEN_LIMIT" | "OPERATION_TIMEOUT" | "RETRY_EXHAUSTED", message: string, options?: {
         retryable?: boolean;
         details?: Record<string, unknown>;
         cause?: Error;

package/dist/tasks/autoresearchTaskExecutor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Autoresearch task executor — bridges TaskManager with the
+ * autoresearch experiment loop.
+ *
+ * Each tick:
+ * 1. Loads/creates a ResearchWorker for the task's tag
+ * 2. Gets the phase-appropriate tool filter
+ * 3. Calls NeuroLink.generate() with research tools + prompt
+ * 4. Advances phase based on which tools the AI called
+ * 5. Returns a TaskRunResult
+ *
+ * Workers are cached by tag to avoid re-initialization on each tick.
+ * Forwards the NeuroLink emitter to each worker for lifecycle events.
+ */
+import type { AutoresearchEmitter } from "../types/autoresearchTypes.js";
+import type { NeuroLinkExecutable, Task, TaskRunResult } from "../types/taskTypes.js";
+/**
+ * Clear all cached workers. Called by TaskManager.shutdown().
+ */
+export declare function clearWorkerCache(): void;
+/**
+ * Execute one autoresearch tick for a task.
+ *
+ * Returns a TaskRunResult-shaped object.
+ * If the task is missing autoresearch config, returns an error result
+ * instead of throwing (so the scheduler can record the failure).
+ *
+ * @param emitter - Optional emitter to forward autoresearch lifecycle events
+ */
+export declare function executeAutoresearchTick(task: Task & {
+    autoresearch?: unknown;
+}, neurolink: NeuroLinkExecutable, emitter?: AutoresearchEmitter): Promise<TaskRunResult>;