@juspay/neurolink 7.53.2 → 7.53.4

package/dist/core/baseProvider.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
-import { generateText, tool as createAISDKTool, jsonSchema } from "ai";
+import { generateText, tool as createAISDKTool, jsonSchema, Output } from "ai";
+import { AIProviderName } from "../constants/enums.js";
 import { MiddlewareFactory } from "../middleware/factory.js";
 import { logger } from "../utils/logger.js";
 import { DEFAULT_MAX_STEPS, STEP_LIMITS } from "../core/constants.js";
@@ -300,6 +301,9 @@ export class BaseProvider {
      */
     async executeGeneration(model, messages, tools, options) {
         const shouldUseTools = !options.disableTools && this.supportsTools();
+        const useStructuredOutput = !!options.schema &&
+            (options.output?.format === "json" ||
+                options.output?.format === "structured");
         return await generateText({
             model,
             messages,
@@ -308,6 +312,10 @@ export class BaseProvider {
             toolChoice: shouldUseTools ? "auto" : "none",
             temperature: options.temperature,
             maxTokens: options.maxTokens,
+            ...(useStructuredOutput &&
+                options.schema && {
+                experimental_output: Output.object({ schema: options.schema }),
+            }),
             experimental_telemetry: this.getStreamTelemetryConfig(options, "generate"),
             onStepFinish: ({ toolCalls, toolResults }) => {
                 logger.info("Tool execution completed", { toolResults, toolCalls });
@@ -438,9 +446,17 @@ export class BaseProvider {
     /**
      * Format the enhanced result
      */
-    formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions) {
+    formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions, options) {
+        // Only access experimental_output if we set a schema
+        // (accessing it when not set throws an error)
+        const useStructuredOutput = !!options.schema &&
+            (options.output?.format === "json" ||
+                options.output?.format === "structured");
+        const content = useStructuredOutput
+            ? JSON.stringify(generateResult.experimental_output)
+            : generateResult.text;
         return {
-            content: generateResult.text,
+            content,
             usage: {
                 input: generateResult.usage?.promptTokens || 0,
                 output: generateResult.usage?.completionTokens || 0,
@@ -578,7 +594,7 @@ export class BaseProvider {
             const responseTime = Date.now() - startTime;
             await this.recordPerformanceMetrics(generateResult.usage, responseTime);
             const { toolsUsed, toolExecutions } = this.extractToolInformation(generateResult);
-            const enhancedResult = this.formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions);
+            const enhancedResult = this.formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions, options);
             return await this.enhanceResult(enhancedResult, options, startTime);
         }
         catch (error) {

package/dist/core/factory.d.ts

@@ -1,4 +1,5 @@
-import type { AIProvider, AIProviderName, SupportedModelName } from "../types/index.js";
+import type { AIProvider, SupportedModelName } from "../types/index.js";
+import { AIProviderName } from "../constants/enums.js";
 import type { UnknownRecord } from "../types/common.js";
 import type { ProviderPairResult } from "../types/typeAliases.js";
 /**

package/dist/core/factory.js

@@ -5,6 +5,7 @@ import { ProviderRegistry } from "../factories/providerRegistry.js";
 import { getBestProvider } from "../utils/providerUtils.js";
 import { logger } from "../utils/logger.js";
 import { dynamicModelProvider } from "./dynamicModels.js";
+import { AIProviderName } from "../constants/enums.js";
 const componentIdentifier = "aiProviderFactory";
 /**
  * Factory for creating AI provider instances with centralized configuration

package/dist/factories/providerFactory.d.ts

@@ -1,5 +1,6 @@
-import type { AIProvider, AIProviderName } from "../types/index.js";
+import type { AIProvider } from "../types/index.js";
 import type { UnknownRecord } from "../types/common.js";
+import { AIProviderName } from "../constants/enums.js";
 /**
  * Provider constructor interface - supports both sync constructors and async factory functions
  */

package/dist/factories/providerFactory.js

@@ -1,4 +1,5 @@
 import { logger } from "../utils/logger.js";
+import { AIProviderName } from "../constants/enums.js";
 /**
  * True Factory Pattern implementation for AI Providers
  * Uses registration-based approach to eliminate switch statements

package/dist/factories/providerRegistry.d.ts

@@ -1,13 +1,4 @@
-/**
- * Configuration options for the provider registry
- */
-export interface ProviderRegistryOptions {
-    /**
-     * Enable loading of manual MCP configurations from .mcp-config.json
-     * Should only be true for CLI mode, false for SDK mode
-     */
-    enableManualMCP?: boolean;
-}
+import type { ProviderRegistryOptions } from "../types/index.js";
 /**
  * Provider Registry - registers all providers with the factory
  * This is where we migrate providers one by one to the new pattern

package/dist/factories/providerRegistry.js

@@ -1,9 +1,6 @@
 import { ProviderFactory } from "./providerFactory.js";
-// Lazy loading all providers to avoid circular dependencies
-// Removed all static imports - providers loaded dynamically when needed
-// This breaks the circular dependency chain completely
-import { AIProviderName, GoogleAIModels, OpenAIModels, } from "../types/index.js";
 import { logger } from "../utils/logger.js";
+import { AIProviderName, GoogleAIModels, OpenAIModels, } from "../constants/enums.js";
 /**
  * Provider Registry - registers all providers with the factory
  * This is where we migrate providers one by one to the new pattern

package/dist/hitl/hitlManager.d.ts

@@ -6,7 +6,7 @@
  * for enterprise-grade AI safety.
  */
 import { EventEmitter } from "events";
-import type { HITLConfig, ConfirmationResult, HITLStatistics } from "./types.js";
+import type { HITLConfig, ConfirmationResult, HITLStatistics } from "../types/hitlTypes.js";
 /**
  * HITLManager - Central orchestrator for Human-in-the-Loop safety mechanisms
  *

package/dist/hitl/index.d.ts

@@ -4,5 +4,4 @@
  * Simple barrel export for HITL components.
  */
 export { HITLManager } from "./hitlManager.js";
-export type { HITLConfig, HITLRule, ConfirmationRequest, ConfirmationResult, ConfirmationRequestEvent, ConfirmationResponseEvent, ConfirmationTimeoutEvent, HITLStatistics, HITLAuditLog, } from "./types.js";
 export { HITLError, HITLUserRejectedError, HITLTimeoutError, HITLConfigurationError, } from "./hitlErrors.js";

package/dist/index.d.ts

@@ -8,18 +8,18 @@
  */
 import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
-export type { AIProvider, AIProviderName, AIModelProviderConfig, StreamingOptions, ProviderAttempt, SupportedModelName, } from "./types/index.js";
+export type { AIProvider, AIModelProviderConfig, StreamingOptions, ProviderAttempt, SupportedModelName, } from "./types/index.js";
 export type { GenerateOptions, GenerateResult, EnhancedProvider, } from "./types/generateTypes.js";
 export type { ToolContext } from "./sdk/toolRegistration.js";
 export { validateTool } from "./sdk/toolRegistration.js";
 export type { ToolResult, ToolDefinition } from "./types/tools.js";
-export { BedrockModels, OpenAIModels, VertexModels, DEFAULT_PROVIDER_CONFIGS, } from "./types/index.js";
+export { DEFAULT_PROVIDER_CONFIGS } from "./types/index.js";
+export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 export { getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
 export { dynamicModelProvider } from "./core/dynamicModels.js";
 export type { DynamicModelConfig, ModelRegistry } from "./types/modelTypes.js";
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };
-export type { ProviderStatus, MCPStatus } from "./neurolink.js";
 export type { MCPServerInfo } from "./types/mcpTypes.js";
 export type { ObservabilityConfig, LangfuseConfig, OpenTelemetryConfig, } from "./types/observability.js";
 export { buildObservabilityConfigFromEnv } from "./utils/observabilityHelpers.js";
@@ -84,7 +84,9 @@ export declare function createBestAIProvider(requestedProvider?: string, modelNa
  * ```
  */
 export { initializeMCPEcosystem, listMCPs, executeMCP, getMCPStats, mcpLogger, } from "./mcp/index.js";
-export type { McpMetadata, ExecutionContext, DiscoveredMcp, ToolInfo, ToolExecutionResult, LogLevel, } from "./mcp/index.js";
+export type { McpMetadata, DiscoveredMcp } from "./types/mcpTypes.js";
+export type { ExecutionContext, ToolInfo, ToolExecutionResult, } from "./types/tools.js";
+export type { LogLevel } from "./utils/logger.js";
 export declare function initializeTelemetry(): Promise<boolean>;
 export declare function getTelemetryStatus(): Promise<{
     enabled: boolean;

package/dist/index.js

@@ -11,7 +11,8 @@ import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
 export { validateTool } from "./sdk/toolRegistration.js";
 // Model enums
-export { BedrockModels, OpenAIModels, VertexModels, DEFAULT_PROVIDER_CONFIGS, } from "./types/index.js";
+export { DEFAULT_PROVIDER_CONFIGS } from "./types/index.js";
+export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 // Utility exports
 export { getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
 // Dynamic Models exports

package/dist/lib/constants/enums.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Supported AI Provider Names
+ */
+export declare enum AIProviderName {
+    BEDROCK = "bedrock",
+    OPENAI = "openai",
+    OPENAI_COMPATIBLE = "openai-compatible",
+    VERTEX = "vertex",
+    ANTHROPIC = "anthropic",
+    AZURE = "azure",
+    GOOGLE_AI = "google-ai",
+    HUGGINGFACE = "huggingface",
+    OLLAMA = "ollama",
+    MISTRAL = "mistral",
+    LITELLM = "litellm",
+    SAGEMAKER = "sagemaker",
+    AUTO = "auto"
+}
+/**
+ * Supported Models for Amazon Bedrock
+ */
+export declare enum BedrockModels {
+    CLAUDE_3_SONNET = "anthropic.claude-3-sonnet-20240229-v1:0",
+    CLAUDE_3_HAIKU = "anthropic.claude-3-haiku-20240307-v1:0",
+    CLAUDE_3_5_SONNET = "anthropic.claude-3-5-sonnet-20240620-v1:0",
+    CLAUDE_3_7_SONNET = "arn:aws:bedrock:us-east-2:225681119357:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0"
+}
+/**
+ * Supported Models for OpenAI
+ */
+export declare enum OpenAIModels {
+    GPT_4 = "gpt-4",
+    GPT_4_TURBO = "gpt-4-turbo",
+    GPT_4O = "gpt-4o",
+    GPT_4O_MINI = "gpt-4o-mini",
+    GPT_3_5_TURBO = "gpt-3.5-turbo",
+    O1_PREVIEW = "o1-preview",
+    O1_MINI = "o1-mini"
+}
+/**
+ * Supported Models for Google Vertex AI
+ */
+export declare enum VertexModels {
+    CLAUDE_4_0_SONNET = "claude-sonnet-4@20250514",
+    CLAUDE_4_0_OPUS = "claude-opus-4@20250514",
+    CLAUDE_3_5_SONNET = "claude-3-5-sonnet-20241022",
+    CLAUDE_3_5_HAIKU = "claude-3-5-haiku-20241022",
+    CLAUDE_3_SONNET = "claude-3-sonnet-20240229",
+    CLAUDE_3_OPUS = "claude-3-opus-20240229",
+    CLAUDE_3_HAIKU = "claude-3-haiku-20240307",
+    GEMINI_2_5_PRO = "gemini-2.5-pro",
+    GEMINI_2_5_FLASH = "gemini-2.5-flash",
+    GEMINI_2_5_FLASH_LITE = "gemini-2.5-flash-lite",
+    GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
+    GEMINI_1_5_PRO = "gemini-1.5-pro",
+    GEMINI_1_5_FLASH = "gemini-1.5-flash"
+}
+/**
+ * Supported Models for Google AI Studio
+ */
+export declare enum GoogleAIModels {
+    GEMINI_2_5_PRO = "gemini-2.5-pro",
+    GEMINI_2_5_FLASH = "gemini-2.5-flash",
+    GEMINI_2_5_FLASH_LITE = "gemini-2.5-flash-lite",
+    GEMINI_2_0_FLASH_001 = "gemini-2.0-flash-001",
+    GEMINI_1_5_PRO = "gemini-1.5-pro",
+    GEMINI_1_5_FLASH = "gemini-1.5-flash",
+    GEMINI_1_5_FLASH_LITE = "gemini-1.5-flash-lite"
+}
+/**
+ * Supported Models for Anthropic (Direct API)
+ */
+export declare enum AnthropicModels {
+    CLAUDE_3_5_SONNET = "claude-3-5-sonnet-20241022",
+    CLAUDE_3_5_HAIKU = "claude-3-5-haiku-20241022",
+    CLAUDE_3_SONNET = "claude-3-sonnet-20240229",
+    CLAUDE_3_OPUS = "claude-3-opus-20240229",
+    CLAUDE_3_HAIKU = "claude-3-haiku-20240307"
+}
+/**
+ * API Versions for various providers
+ */
+export declare enum APIVersions {
+    AZURE_LATEST = "2025-04-01-preview",
+    AZURE_STABLE = "2024-10-21",
+    AZURE_LEGACY = "2023-12-01-preview",
+    OPENAI_CURRENT = "v1",
+    OPENAI_BETA = "v1-beta",
+    GOOGLE_AI_CURRENT = "v1",
+    GOOGLE_AI_BETA = "v1beta",
+    ANTHROPIC_CURRENT = "2023-06-01"
+}
+export declare enum ErrorCategory {
+    VALIDATION = "validation",
+    TIMEOUT = "timeout",
+    NETWORK = "network",
+    RESOURCE = "resource",
+    PERMISSION = "permission",
+    CONFIGURATION = "configuration",
+    EXECUTION = "execution",
+    SYSTEM = "system"
+}
+export declare enum ErrorSeverity {
+    LOW = "low",
+    MEDIUM = "medium",
+    HIGH = "high",
+    CRITICAL = "critical"
+}

package/dist/lib/constants/enums.js

@@ -0,0 +1,139 @@
+// ============================================================================
+// ENUMS
+// ============================================================================
+/**
+ * Supported AI Provider Names
+ */
+export var AIProviderName;
+(function (AIProviderName) {
+    AIProviderName["BEDROCK"] = "bedrock";
+    AIProviderName["OPENAI"] = "openai";
+    AIProviderName["OPENAI_COMPATIBLE"] = "openai-compatible";
+    AIProviderName["VERTEX"] = "vertex";
+    AIProviderName["ANTHROPIC"] = "anthropic";
+    AIProviderName["AZURE"] = "azure";
+    AIProviderName["GOOGLE_AI"] = "google-ai";
+    AIProviderName["HUGGINGFACE"] = "huggingface";
+    AIProviderName["OLLAMA"] = "ollama";
+    AIProviderName["MISTRAL"] = "mistral";
+    AIProviderName["LITELLM"] = "litellm";
+    AIProviderName["SAGEMAKER"] = "sagemaker";
+    AIProviderName["AUTO"] = "auto";
+})(AIProviderName || (AIProviderName = {}));
+/**
+ * Supported Models for Amazon Bedrock
+ */
+export var BedrockModels;
+(function (BedrockModels) {
+    BedrockModels["CLAUDE_3_SONNET"] = "anthropic.claude-3-sonnet-20240229-v1:0";
+    BedrockModels["CLAUDE_3_HAIKU"] = "anthropic.claude-3-haiku-20240307-v1:0";
+    BedrockModels["CLAUDE_3_5_SONNET"] = "anthropic.claude-3-5-sonnet-20240620-v1:0";
+    BedrockModels["CLAUDE_3_7_SONNET"] = "arn:aws:bedrock:us-east-2:225681119357:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0";
+})(BedrockModels || (BedrockModels = {}));
+/**
+ * Supported Models for OpenAI
+ */
+export var OpenAIModels;
+(function (OpenAIModels) {
+    OpenAIModels["GPT_4"] = "gpt-4";
+    OpenAIModels["GPT_4_TURBO"] = "gpt-4-turbo";
+    OpenAIModels["GPT_4O"] = "gpt-4o";
+    OpenAIModels["GPT_4O_MINI"] = "gpt-4o-mini";
+    OpenAIModels["GPT_3_5_TURBO"] = "gpt-3.5-turbo";
+    OpenAIModels["O1_PREVIEW"] = "o1-preview";
+    OpenAIModels["O1_MINI"] = "o1-mini";
+})(OpenAIModels || (OpenAIModels = {}));
+/**
+ * Supported Models for Google Vertex AI
+ */
+export var VertexModels;
+(function (VertexModels) {
+    // Claude 4 Series (Latest - May 2025)
+    VertexModels["CLAUDE_4_0_SONNET"] = "claude-sonnet-4@20250514";
+    VertexModels["CLAUDE_4_0_OPUS"] = "claude-opus-4@20250514";
+    // Claude 3.5 Series (Still supported)
+    VertexModels["CLAUDE_3_5_SONNET"] = "claude-3-5-sonnet-20241022";
+    VertexModels["CLAUDE_3_5_HAIKU"] = "claude-3-5-haiku-20241022";
+    // Claude 3 Series (Legacy support)
+    VertexModels["CLAUDE_3_SONNET"] = "claude-3-sonnet-20240229";
+    VertexModels["CLAUDE_3_OPUS"] = "claude-3-opus-20240229";
+    VertexModels["CLAUDE_3_HAIKU"] = "claude-3-haiku-20240307";
+    // Gemini 2.5 Series (Latest - 2025)
+    VertexModels["GEMINI_2_5_PRO"] = "gemini-2.5-pro";
+    VertexModels["GEMINI_2_5_FLASH"] = "gemini-2.5-flash";
+    VertexModels["GEMINI_2_5_FLASH_LITE"] = "gemini-2.5-flash-lite";
+    // Gemini 2.0 Series
+    VertexModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
+    // Gemini 1.5 Series (Legacy support)
+    VertexModels["GEMINI_1_5_PRO"] = "gemini-1.5-pro";
+    VertexModels["GEMINI_1_5_FLASH"] = "gemini-1.5-flash";
+})(VertexModels || (VertexModels = {}));
+/**
+ * Supported Models for Google AI Studio
+ */
+export var GoogleAIModels;
+(function (GoogleAIModels) {
+    // Gemini 2.5 Series (Latest - 2025)
+    GoogleAIModels["GEMINI_2_5_PRO"] = "gemini-2.5-pro";
+    GoogleAIModels["GEMINI_2_5_FLASH"] = "gemini-2.5-flash";
+    GoogleAIModels["GEMINI_2_5_FLASH_LITE"] = "gemini-2.5-flash-lite";
+    // Gemini 2.0 Series
+    GoogleAIModels["GEMINI_2_0_FLASH_001"] = "gemini-2.0-flash-001";
+    // Gemini 1.5 Series (Legacy support)
+    GoogleAIModels["GEMINI_1_5_PRO"] = "gemini-1.5-pro";
+    GoogleAIModels["GEMINI_1_5_FLASH"] = "gemini-1.5-flash";
+    GoogleAIModels["GEMINI_1_5_FLASH_LITE"] = "gemini-1.5-flash-lite";
+})(GoogleAIModels || (GoogleAIModels = {}));
+/**
+ * Supported Models for Anthropic (Direct API)
+ */
+export var AnthropicModels;
+(function (AnthropicModels) {
+    // Claude 3.5 Series (Latest)
+    AnthropicModels["CLAUDE_3_5_SONNET"] = "claude-3-5-sonnet-20241022";
+    AnthropicModels["CLAUDE_3_5_HAIKU"] = "claude-3-5-haiku-20241022";
+    // Claude 3 Series (Legacy support)
+    AnthropicModels["CLAUDE_3_SONNET"] = "claude-3-sonnet-20240229";
+    AnthropicModels["CLAUDE_3_OPUS"] = "claude-3-opus-20240229";
+    AnthropicModels["CLAUDE_3_HAIKU"] = "claude-3-haiku-20240307";
+})(AnthropicModels || (AnthropicModels = {}));
+/**
+ * API Versions for various providers
+ */
+export var APIVersions;
+(function (APIVersions) {
+    // Azure OpenAI API versions
+    APIVersions["AZURE_LATEST"] = "2025-04-01-preview";
+    APIVersions["AZURE_STABLE"] = "2024-10-21";
+    APIVersions["AZURE_LEGACY"] = "2023-12-01-preview";
+    // OpenAI API versions
+    APIVersions["OPENAI_CURRENT"] = "v1";
+    APIVersions["OPENAI_BETA"] = "v1-beta";
+    // Google AI API versions
+    APIVersions["GOOGLE_AI_CURRENT"] = "v1";
+    APIVersions["GOOGLE_AI_BETA"] = "v1beta";
+    // Anthropic API versions
+    APIVersions["ANTHROPIC_CURRENT"] = "2023-06-01";
+    // Other provider versions can be added here
+})(APIVersions || (APIVersions = {}));
+// Error categories for proper handling
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["VALIDATION"] = "validation";
+    ErrorCategory["TIMEOUT"] = "timeout";
+    ErrorCategory["NETWORK"] = "network";
+    ErrorCategory["RESOURCE"] = "resource";
+    ErrorCategory["PERMISSION"] = "permission";
+    ErrorCategory["CONFIGURATION"] = "configuration";
+    ErrorCategory["EXECUTION"] = "execution";
+    ErrorCategory["SYSTEM"] = "system";
+})(ErrorCategory || (ErrorCategory = {}));
+// Error severity levels
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["LOW"] = "low";
+    ErrorSeverity["MEDIUM"] = "medium";
+    ErrorSeverity["HIGH"] = "high";
+    ErrorSeverity["CRITICAL"] = "critical";
+})(ErrorSeverity || (ErrorSeverity = {}));
+//# sourceMappingURL=enums.js.map

package/dist/lib/core/baseProvider.d.ts

@@ -1,6 +1,7 @@
 import type { ValidationSchema } from "../types/typeAliases.js";
 import type { Tool, LanguageModelV1 } from "ai";
-import type { AIProvider, TextGenerationOptions, TextGenerationResult, EnhancedGenerateResult, AnalyticsData, AIProviderName } from "../types/index.js";
+import type { AIProvider, TextGenerationOptions, TextGenerationResult, EnhancedGenerateResult, AnalyticsData } from "../types/index.js";
+import { AIProviderName } from "../constants/enums.js";
 import type { EvaluationData } from "../index.js";
 import type { MiddlewareFactoryOptions } from "../types/middlewareTypes.js";
 import type { StreamOptions, StreamResult } from "../types/streamTypes.js";

package/dist/lib/core/baseProvider.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
-import { generateText, tool as createAISDKTool, jsonSchema } from "ai";
+import { generateText, tool as createAISDKTool, jsonSchema, Output } from "ai";
+import { AIProviderName } from "../constants/enums.js";
 import { MiddlewareFactory } from "../middleware/factory.js";
 import { logger } from "../utils/logger.js";
 import { DEFAULT_MAX_STEPS, STEP_LIMITS } from "../core/constants.js";
@@ -300,6 +301,9 @@ export class BaseProvider {
      */
     async executeGeneration(model, messages, tools, options) {
         const shouldUseTools = !options.disableTools && this.supportsTools();
+        const useStructuredOutput = !!options.schema &&
+            (options.output?.format === "json" ||
+                options.output?.format === "structured");
         return await generateText({
             model,
             messages,
@@ -308,6 +312,10 @@ export class BaseProvider {
             toolChoice: shouldUseTools ? "auto" : "none",
             temperature: options.temperature,
             maxTokens: options.maxTokens,
+            ...(useStructuredOutput &&
+                options.schema && {
+                experimental_output: Output.object({ schema: options.schema }),
+            }),
             experimental_telemetry: this.getStreamTelemetryConfig(options, "generate"),
             onStepFinish: ({ toolCalls, toolResults }) => {
                 logger.info("Tool execution completed", { toolResults, toolCalls });
@@ -438,9 +446,17 @@ export class BaseProvider {
     /**
      * Format the enhanced result
      */
-    formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions) {
+    formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions, options) {
+        // Only access experimental_output if we set a schema
+        // (accessing it when not set throws an error)
+        const useStructuredOutput = !!options.schema &&
+            (options.output?.format === "json" ||
+                options.output?.format === "structured");
+        const content = useStructuredOutput
+            ? JSON.stringify(generateResult.experimental_output)
+            : generateResult.text;
         return {
-            content: generateResult.text,
+            content,
             usage: {
                 input: generateResult.usage?.promptTokens || 0,
                 output: generateResult.usage?.completionTokens || 0,
@@ -578,7 +594,7 @@ export class BaseProvider {
             const responseTime = Date.now() - startTime;
             await this.recordPerformanceMetrics(generateResult.usage, responseTime);
             const { toolsUsed, toolExecutions } = this.extractToolInformation(generateResult);
-            const enhancedResult = this.formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions);
+            const enhancedResult = this.formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions, options);
             return await this.enhanceResult(enhancedResult, options, startTime);
         }
         catch (error) {

package/dist/lib/core/factory.d.ts

@@ -1,4 +1,5 @@
-import type { AIProvider, AIProviderName, SupportedModelName } from "../types/index.js";
+import type { AIProvider, SupportedModelName } from "../types/index.js";
+import { AIProviderName } from "../constants/enums.js";
 import type { UnknownRecord } from "../types/common.js";
 import type { ProviderPairResult } from "../types/typeAliases.js";
 /**

package/dist/lib/core/factory.js

@@ -5,6 +5,7 @@ import { ProviderRegistry } from "../factories/providerRegistry.js";
 import { getBestProvider } from "../utils/providerUtils.js";
 import { logger } from "../utils/logger.js";
 import { dynamicModelProvider } from "./dynamicModels.js";
+import { AIProviderName } from "../constants/enums.js";
 const componentIdentifier = "aiProviderFactory";
 /**
  * Factory for creating AI provider instances with centralized configuration

package/dist/lib/factories/providerFactory.d.ts

@@ -1,5 +1,6 @@
-import type { AIProvider, AIProviderName } from "../types/index.js";
+import type { AIProvider } from "../types/index.js";
 import type { UnknownRecord } from "../types/common.js";
+import { AIProviderName } from "../constants/enums.js";
 /**
  * Provider constructor interface - supports both sync constructors and async factory functions
  */

package/dist/lib/factories/providerFactory.js

@@ -1,4 +1,5 @@
 import { logger } from "../utils/logger.js";
+import { AIProviderName } from "../constants/enums.js";
 /**
  * True Factory Pattern implementation for AI Providers
  * Uses registration-based approach to eliminate switch statements

package/dist/lib/factories/providerRegistry.d.ts

@@ -1,13 +1,4 @@
-/**
- * Configuration options for the provider registry
- */
-export interface ProviderRegistryOptions {
-    /**
-     * Enable loading of manual MCP configurations from .mcp-config.json
-     * Should only be true for CLI mode, false for SDK mode
-     */
-    enableManualMCP?: boolean;
-}
+import type { ProviderRegistryOptions } from "../types/index.js";
 /**
  * Provider Registry - registers all providers with the factory
  * This is where we migrate providers one by one to the new pattern

package/dist/lib/factories/providerRegistry.js

@@ -1,9 +1,6 @@
 import { ProviderFactory } from "./providerFactory.js";
-// Lazy loading all providers to avoid circular dependencies
-// Removed all static imports - providers loaded dynamically when needed
-// This breaks the circular dependency chain completely
-import { AIProviderName, GoogleAIModels, OpenAIModels, } from "../types/index.js";
 import { logger } from "../utils/logger.js";
+import { AIProviderName, GoogleAIModels, OpenAIModels, } from "../constants/enums.js";
 /**
  * Provider Registry - registers all providers with the factory
  * This is where we migrate providers one by one to the new pattern

package/dist/lib/hitl/hitlManager.d.ts

@@ -6,7 +6,7 @@
  * for enterprise-grade AI safety.
  */
 import { EventEmitter } from "events";
-import type { HITLConfig, ConfirmationResult, HITLStatistics } from "./types.js";
+import type { HITLConfig, ConfirmationResult, HITLStatistics } from "../types/hitlTypes.js";
 /**
  * HITLManager - Central orchestrator for Human-in-the-Loop safety mechanisms
  *

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

@@ -4,5 +4,4 @@
  * Simple barrel export for HITL components.
  */
 export { HITLManager } from "./hitlManager.js";
-export type { HITLConfig, HITLRule, ConfirmationRequest, ConfirmationResult, ConfirmationRequestEvent, ConfirmationResponseEvent, ConfirmationTimeoutEvent, HITLStatistics, HITLAuditLog, } from "./types.js";
 export { HITLError, HITLUserRejectedError, HITLTimeoutError, HITLConfigurationError, } from "./hitlErrors.js";

package/dist/lib/index.d.ts

@@ -8,18 +8,18 @@
  */
 import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
-export type { AIProvider, AIProviderName, AIModelProviderConfig, StreamingOptions, ProviderAttempt, SupportedModelName, } from "./types/index.js";
+export type { AIProvider, AIModelProviderConfig, StreamingOptions, ProviderAttempt, SupportedModelName, } from "./types/index.js";
 export type { GenerateOptions, GenerateResult, EnhancedProvider, } from "./types/generateTypes.js";
 export type { ToolContext } from "./sdk/toolRegistration.js";
 export { validateTool } from "./sdk/toolRegistration.js";
 export type { ToolResult, ToolDefinition } from "./types/tools.js";
-export { BedrockModels, OpenAIModels, VertexModels, DEFAULT_PROVIDER_CONFIGS, } from "./types/index.js";
+export { DEFAULT_PROVIDER_CONFIGS } from "./types/index.js";
+export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 export { getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
 export { dynamicModelProvider } from "./core/dynamicModels.js";
 export type { DynamicModelConfig, ModelRegistry } from "./types/modelTypes.js";
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };
-export type { ProviderStatus, MCPStatus } from "./neurolink.js";
 export type { MCPServerInfo } from "./types/mcpTypes.js";
 export type { ObservabilityConfig, LangfuseConfig, OpenTelemetryConfig, } from "./types/observability.js";
 export { buildObservabilityConfigFromEnv } from "./utils/observabilityHelpers.js";
@@ -84,7 +84,9 @@ export declare function createBestAIProvider(requestedProvider?: string, modelNa
  * ```
  */
 export { initializeMCPEcosystem, listMCPs, executeMCP, getMCPStats, mcpLogger, } from "./mcp/index.js";
-export type { McpMetadata, ExecutionContext, DiscoveredMcp, ToolInfo, ToolExecutionResult, LogLevel, } from "./mcp/index.js";
+export type { McpMetadata, DiscoveredMcp } from "./types/mcpTypes.js";
+export type { ExecutionContext, ToolInfo, ToolExecutionResult, } from "./types/tools.js";
+export type { LogLevel } from "./utils/logger.js";
 export declare function initializeTelemetry(): Promise<boolean>;
 export declare function getTelemetryStatus(): Promise<{
     enabled: boolean;

package/dist/lib/index.js

@@ -11,7 +11,8 @@ import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
 export { validateTool } from "./sdk/toolRegistration.js";
 // Model enums
-export { BedrockModels, OpenAIModels, VertexModels, DEFAULT_PROVIDER_CONFIGS, } from "./types/index.js";
+export { DEFAULT_PROVIDER_CONFIGS } from "./types/index.js";
+export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 // Utility exports
 export { getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
 // Dynamic Models exports

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

@@ -3,11 +3,8 @@
  * Universal AI Development Platform with Extensible Plugin Architecture
  * Implementation based on research blueprint
  */
-export type { McpMetadata, DiscoveredMcp } from "../types/mcpTypes.js";
-export type { ExecutionContext, ToolInfo, ToolExecutionResult, } from "../types/tools.js";
-export { mcpLogger } from "../utils/logger.js";
-export type { LogLevel } from "../utils/logger.js";
 import type { McpMetadata } from "../types/mcpTypes.js";
+export { mcpLogger } from "../utils/logger.js";
 /**
  * Initialize the MCP ecosystem - simplified
  */

package/dist/lib/mcp/index.js

@@ -1,9 +1,3 @@
-/**
- * MCP Ecosystem - Main Export
- * Universal AI Development Platform with Extensible Plugin Architecture
- * Implementation based on research blueprint
- */
-// Core functionality exports
 export { mcpLogger } from "../utils/logger.js";
 /**
  * Initialize the MCP ecosystem - simplified