@juspay/neurolink 9.32.0 → 9.33.0

package/dist/client/providers/amazonBedrock.js

@@ -1,1512 +0,0 @@
-import { BedrockClient, ListFoundationModelsCommand, } from "@aws-sdk/client-bedrock";
-import { BedrockRuntimeClient, ConverseCommand, ConverseStreamCommand, ImageFormat, } from "@aws-sdk/client-bedrock-runtime";
-import path from "path";
-import { createAnalytics } from "../core/analytics.js";
-import { BaseProvider } from "../core/baseProvider.js";
-import { DEFAULT_MAX_STEPS } from "../core/constants.js";
-import { AuthenticationError, ProviderError } from "../types/errors.js";
-import { isAbortError, withTimeout } from "../utils/errorHandling.js";
-import { logger } from "../utils/logger.js";
-import { calculateCost } from "../utils/pricing.js";
-import { buildMultimodalMessagesArray } from "../utils/messageBuilder.js";
-import { buildMultimodalOptions } from "../utils/multimodalOptionsBuilder.js";
-import { convertZodToJsonSchema } from "../utils/schemaConversion.js";
-import { trace, SpanKind, SpanStatusCode } from "@opentelemetry/api";
-const bedrockTracer = trace.getTracer("neurolink.bedrock");
-// Bedrock-specific types now imported from ../types/providerSpecific.js
-export class AmazonBedrockProvider extends BaseProvider {
-    bedrockClient;
-    conversationHistory = [];
-    region;
-    constructor(modelName, neurolink, region) {
-        super(modelName, "bedrock", neurolink);
-        this.region = region || process.env.AWS_REGION || "us-east-1";
-        logger.debug("[AmazonBedrockProvider] Starting constructor with extensive logging for debugging");
-        // Log environment variables for debugging
-        logger.debug(`[AmazonBedrockProvider] Environment check: AWS_REGION=${process.env.AWS_REGION || "undefined"}, AWS_ACCESS_KEY_ID=${process.env.AWS_ACCESS_KEY_ID ? "SET" : "undefined"}, AWS_SECRET_ACCESS_KEY=${process.env.AWS_SECRET_ACCESS_KEY ? "SET" : "undefined"}`);
-        try {
-            // Create BedrockRuntimeClient with clean configuration like working Bedrock-MCP-Connector
-            // Absolutely no proxy interference - let AWS SDK handle everything natively
-            logger.debug("[AmazonBedrockProvider] Creating BedrockRuntimeClient with clean configuration");
-            this.bedrockClient = new BedrockRuntimeClient({
-                region: this.region,
-                // Clean configuration - AWS SDK will handle credentials via:
-                // 1. IAM roles (preferred in production)
-                // 2. Environment variables
-                // 3. AWS config files
-                // 4. Instance metadata
-            });
-            logger.debug(`[AmazonBedrockProvider] Successfully created BedrockRuntimeClient with model: ${this.modelName}, region: ${this.region}`);
-        }
-        catch (error) {
-            logger.error(`[AmazonBedrockProvider] CRITICAL: Failed to initialize BedrockRuntimeClient:`, error);
-            throw error;
-        }
-    }
-    /**
-     * Perform initial health check to catch credential/connectivity issues early
-     * This prevents the health check failure we saw in production logs
-     */
-    async performInitialHealthCheck() {
-        const bedrockClient = new BedrockClient({
-            region: this.region,
-        });
-        try {
-            logger.debug("[AmazonBedrockProvider] Starting initial health check to validate credentials and connectivity");
-            // Try to list foundation models as a lightweight health check
-            const command = new ListFoundationModelsCommand({});
-            const startTime = Date.now();
-            await bedrockClient.send(command);
-            const responseTime = Date.now() - startTime;
-            logger.debug(`[AmazonBedrockProvider] Health check PASSED - credentials valid, connectivity good, responseTime: ${responseTime}ms`);
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            logger.error(`[AmazonBedrockProvider] Health check FAILED - this will cause production failures:`, {
-                error: errorMessage,
-                errorType: error instanceof Error ? error.constructor.name : "Unknown",
-                region: process.env.AWS_REGION || "us-east-1",
-                hasAccessKey: !!process.env.AWS_ACCESS_KEY_ID,
-                hasSecretKey: !!process.env.AWS_SECRET_ACCESS_KEY,
-            });
-            // Don't throw here - let the actual usage fail with better context
-        }
-        finally {
-            try {
-                bedrockClient.destroy();
-            }
-            catch {
-                // Ignore destroy errors during cleanup
-            }
-        }
-    }
-    // Not using AI SDK approach in conversation management
-    getAISDKModel() {
-        throw new Error("AmazonBedrockProvider does not use AI SDK models");
-    }
-    getProviderName() {
-        return "bedrock";
-    }
-    getDefaultModel() {
-        return process.env.BEDROCK_MODEL || "anthropic.claude-sonnet-4-6";
-    }
-    /**
-     * Get the default embedding model for Amazon Bedrock
-     * @returns The default Bedrock embedding model name
-     */
-    getDefaultEmbeddingModel() {
-        return (process.env.BEDROCK_EMBEDDING_MODEL ||
-            process.env.AWS_EMBEDDING_MODEL ||
-            "amazon.titan-embed-text-v2:0");
-    }
-    // Override the main generate method to implement conversation management
-    async generate(optionsOrPrompt) {
-        logger.debug("[AmazonBedrockProvider] generate() called with conversation management");
-        const options = typeof optionsOrPrompt === "string"
-            ? { prompt: optionsOrPrompt }
-            : optionsOrPrompt;
-        // Clear conversation history for new generation
-        this.conversationHistory = [];
-        // Check for multimodal input (images, PDFs, CSVs, files)
-        // Cast to any to access multimodal properties (runtime check is safe)
-        const input = options.input;
-        const hasMultimodalInput = !!(input?.images?.length ||
-            input?.content?.length ||
-            input?.files?.length ||
-            input?.csvFiles?.length ||
-            input?.pdfFiles?.length);
-        if (hasMultimodalInput) {
-            logger.debug(`[AmazonBedrockProvider] Detected multimodal input in generate(), using multimodal message builder`, {
-                hasImages: !!input?.images?.length,
-                imageCount: input?.images?.length || 0,
-                hasContent: !!input?.content?.length,
-                contentCount: input?.content?.length || 0,
-                hasFiles: !!input?.files?.length,
-                fileCount: input?.files?.length || 0,
-                hasCSVFiles: !!input?.csvFiles?.length,
-                csvFileCount: input?.csvFiles?.length || 0,
-                hasPDFFiles: !!input?.pdfFiles?.length,
-                pdfFileCount: input?.pdfFiles?.length || 0,
-            });
-            // Cast options to StreamOptions for multimodal processing
-            const streamOptions = options;
-            const multimodalOptions = buildMultimodalOptions(streamOptions, this.providerName, this.modelName);
-            const multimodalMessages = await buildMultimodalMessagesArray(multimodalOptions, this.providerName, this.modelName);
-            // Convert to Bedrock format
-            this.conversationHistory =
-                this.convertToBedrockMessages(multimodalMessages);
-        }
-        else {
-            logger.debug(`[AmazonBedrockProvider] Text-only input in generate(), using simple message builder`);
-            // Add user message to conversation - simple text-only case
-            const userMessage = {
-                role: "user",
-                content: [{ text: options.prompt }],
-            };
-            this.conversationHistory.push(userMessage);
-        }
-        logger.debug(`[AmazonBedrockProvider] Starting conversation with ${this.conversationHistory.length} message(s)`);
-        // Start conversation loop and return enhanced result
-        const text = await this.conversationLoop(options);
-        return {
-            content: text, // CLI expects 'content' not 'text'
-            usage: { total: 0, input: 0, output: 0 },
-            model: this.modelName || this.getDefaultModel(),
-            provider: this.getProviderName(),
-        };
-    }
-    async conversationLoop(options) {
-        const maxIterations = 10; // Prevent infinite loops
-        let iteration = 0;
-        while (iteration < maxIterations) {
-            iteration++;
-            logger.debug(`[AmazonBedrockProvider] Conversation iteration ${iteration}`);
-            try {
-                logger.debug(`[AmazonBedrockProvider] About to call Bedrock API`);
-                const response = await this.callBedrock(options);
-                logger.debug(`[AmazonBedrockProvider] Received Bedrock response`, JSON.stringify(response, null, 2));
-                const result = await this.handleBedrockResponse(response);
-                logger.debug(`[AmazonBedrockProvider] Handle response result:`, result);
-                if (result.shouldContinue) {
-                    logger.debug(`[AmazonBedrockProvider] Continuing conversation loop...`);
-                }
-                else {
-                    logger.debug(`[AmazonBedrockProvider] Conversation completed with final text`);
-                    logger.debug(`[AmazonBedrockProvider] Returning final text: "${result.text}"`);
-                    return result.text || "";
-                }
-            }
-            catch (error) {
-                logger.error(`[AmazonBedrockProvider] Error in conversation loop:`, error);
-                throw this.handleProviderError(error);
-            }
-        }
-        throw new Error("Conversation loop exceeded maximum iterations");
-    }
-    async callBedrock(options) {
-        const startTime = Date.now();
-        return bedrockTracer.startActiveSpan("bedrock.generate", {
-            kind: SpanKind.CLIENT,
-            attributes: {
-                "gen_ai.system": "aws.bedrock",
-                "gen_ai.request.model": this.modelName || this.getDefaultModel(),
-                "gen_ai.operation.name": "chat",
-            },
-        }, async (generateSpan) => {
-            logger.info(`🚀 [AmazonBedrockProvider] Starting Bedrock API call at ${new Date().toISOString()}`);
-            try {
-                // Pre-call validation and logging
-                let region = "unknown";
-                try {
-                    region =
-                        typeof this.bedrockClient.config.region === "function"
-                            ? await this.bedrockClient.config.region()
-                            : (this.bedrockClient.config.region ?? "unknown");
-                }
-                catch {
-                    // Region lookup failed — not critical, only used for logging
-                }
-                logger.info(`🔧 [AmazonBedrockProvider] Client region: ${region}`);
-                logger.info(`🔧 [AmazonBedrockProvider] Model: ${this.modelName || this.getDefaultModel()}`);
-                logger.info(`🔧 [AmazonBedrockProvider] Conversation history length: ${this.conversationHistory.length}`);
-                // Get all available tools
-                const aiTools = await this.getAllTools();
-                const allTools = this.convertAISDKToolsToToolDefinitions(aiTools);
-                const toolConfig = this.formatToolsForBedrock(allTools);
-                const commandInput = {
-                    modelId: this.modelName || this.getDefaultModel(),
-                    messages: this.convertToAWSMessages(this.conversationHistory),
-                    system: [
-                        {
-                            text: options.systemPrompt ||
-                                "You are a helpful assistant with access to external tools. Use tools when necessary to provide accurate information.",
-                        },
-                    ],
-                    inferenceConfig: {
-                        maxTokens: options.maxTokens, // No default limit - unlimited unless specified
-                        temperature: options.temperature || 0.7,
-                    },
-                };
-                if (toolConfig) {
-                    commandInput.toolConfig = toolConfig;
-                    logger.info(`🛠️ [AmazonBedrockProvider] Tools configured: ${toolConfig.tools?.length || 0}`);
-                }
-                // Log command details for debugging
-                logger.info(`📋 [AmazonBedrockProvider] Command input summary:`);
-                logger.info(`  - Model ID: ${commandInput.modelId}`);
-                logger.info(`  - Messages count: ${commandInput.messages?.length || 0}`);
-                logger.info(`  - System prompts: ${commandInput.system?.length || 0}`);
-                logger.info(`  - Max tokens: ${commandInput.inferenceConfig?.maxTokens}`);
-                logger.info(`  - Temperature: ${commandInput.inferenceConfig?.temperature}`);
-                logger.debug(`[AmazonBedrockProvider] Calling Bedrock with ${this.conversationHistory.length} messages and ${toolConfig?.tools?.length || 0} tools`);
-                // Create command and attempt API call
-                const command = new ConverseCommand(commandInput);
-                logger.debug("[Observability] Bedrock API request", {
-                    model: commandInput.modelId,
-                    region: region,
-                    messageCount: commandInput.messages?.length || 0,
-                    toolCount: commandInput.toolConfig?.tools?.length || 0,
-                    maxTokens: commandInput.inferenceConfig?.maxTokens,
-                });
-                const apiCallStartTime = Date.now();
-                const response = await withTimeout(this.bedrockClient.send(command), 120_000, new Error("Bedrock API call timed out"));
-                const apiCallDuration = Date.now() - apiCallStartTime;
-                logger.debug("[Observability] Bedrock API response", {
-                    model: commandInput.modelId,
-                    durationMs: apiCallDuration,
-                    hasContent: !!response.output?.message?.content?.length,
-                    stopReason: response.stopReason,
-                    usage: response.usage
-                        ? {
-                            inputTokens: response.usage.inputTokens,
-                            outputTokens: response.usage.outputTokens,
-                            totalTokens: (response.usage.inputTokens || 0) +
-                                (response.usage.outputTokens || 0),
-                        }
-                        : undefined,
-                });
-                logger.info(`[AmazonBedrockProvider] Bedrock API call successful`);
-                logger.info(`[AmazonBedrockProvider] API call duration: ${apiCallDuration}ms`);
-                const totalDuration = Date.now() - startTime;
-                logger.info(`[AmazonBedrockProvider] Total callBedrock duration: ${totalDuration}ms`);
-                generateSpan.setAttribute("gen_ai.response.stop_reason", response.stopReason ?? "");
-                generateSpan.setAttribute("gen_ai.usage.input_tokens", response.usage?.inputTokens ?? 0);
-                generateSpan.setAttribute("gen_ai.usage.output_tokens", response.usage?.outputTokens ?? 0);
-                const cost = calculateCost(this.providerName, this.modelName, {
-                    input: response.usage?.inputTokens ?? 0,
-                    output: response.usage?.outputTokens ?? 0,
-                    total: (response.usage?.inputTokens ?? 0) +
-                        (response.usage?.outputTokens ?? 0),
-                });
-                if (cost && cost > 0) {
-                    generateSpan.setAttribute("neurolink.cost", cost);
-                }
-                generateSpan.setStatus({ code: SpanStatusCode.OK });
-                generateSpan.end();
-                return response;
-            }
-            catch (error) {
-                const errorDuration = Date.now() - startTime;
-                // Extract AWS metadata for structured logging
-                const awsError = error && typeof error === "object"
-                    ? error
-                    : null;
-                const metadata = awsError?.$metadata && typeof awsError.$metadata === "object"
-                    ? awsError.$metadata
-                    : null;
-                logger.debug("[Observability] Bedrock API request failed", {
-                    model: this.modelName || this.getDefaultModel(),
-                    durationMs: errorDuration,
-                    error: error instanceof Error ? error.message : String(error),
-                    errorName: error instanceof Error ? error.name : undefined,
-                    httpStatus: metadata?.httpStatusCode,
-                    awsRequestId: metadata?.requestId,
-                    awsErrorCode: awsError?.Code,
-                });
-                logger.error(`[AmazonBedrockProvider] Bedrock API call failed after ${errorDuration}ms`);
-                if (error instanceof Error) {
-                    logger.error(`[AmazonBedrockProvider] Error: ${error.name} - ${error.message}`);
-                }
-                if (metadata) {
-                    logger.error(`[AmazonBedrockProvider] AWS SDK metadata`, {
-                        httpStatus: metadata.httpStatusCode,
-                        requestId: metadata.requestId,
-                        attempts: metadata.attempts,
-                        totalRetryDelay: metadata.totalRetryDelay,
-                    });
-                }
-                generateSpan.setStatus({
-                    code: SpanStatusCode.ERROR,
-                    message: error instanceof Error ? error.message : String(error),
-                });
-                generateSpan.recordException(error instanceof Error ? error : new Error(String(error)));
-                generateSpan.end();
-                throw error;
-            }
-        }); // end bedrockTracer.startActiveSpan('bedrock.generate')
-    }
-    async handleBedrockResponse(response) {
-        logger.debug(`[AmazonBedrockProvider] Received response with stopReason: ${response.stopReason}`);
-        if (!response.output || !response.output.message) {
-            throw new Error("Invalid response structure from Bedrock API");
-        }
-        const assistantMessage = response.output.message;
-        const stopReason = response.stopReason;
-        // Add assistant message to conversation history
-        const bedrockAssistantMessage = {
-            role: "assistant",
-            content: (assistantMessage.content || []).map((item) => {
-                const bedrockItem = {};
-                if ("text" in item && item.text) {
-                    bedrockItem.text = item.text;
-                }
-                if ("toolUse" in item && item.toolUse) {
-                    bedrockItem.toolUse = {
-                        toolUseId: item.toolUse.toolUseId || "",
-                        name: item.toolUse.name || "",
-                        input: item.toolUse.input || {},
-                    };
-                }
-                if ("toolResult" in item && item.toolResult) {
-                    bedrockItem.toolResult = {
-                        toolUseId: item.toolResult.toolUseId || "",
-                        content: (item.toolResult.content || []).map((c) => ({
-                            text: typeof c === "object" && "text" in c
-                                ? c.text || ""
-                                : "",
-                        })),
-                        status: item.toolResult.status || "unknown",
-                    };
-                }
-                return bedrockItem;
-            }),
-        };
-        this.conversationHistory.push(bedrockAssistantMessage);
-        if (stopReason === "end_turn" || stopReason === "stop_sequence") {
-            // Extract text from assistant message
-            const textContent = bedrockAssistantMessage.content
-                .filter((item) => item.text)
-                .map((item) => item.text)
-                .join(" ");
-            return { shouldContinue: false, text: textContent };
-        }
-        else if (stopReason === "tool_use") {
-            logger.debug(`[AmazonBedrockProvider] Tool use detected - executing tools immediately`);
-            // Execute all tool uses in the message
-            const toolResults = [];
-            for (const contentItem of bedrockAssistantMessage.content) {
-                if (contentItem.toolUse) {
-                    logger.debug(`[AmazonBedrockProvider] Executing tool: ${contentItem.toolUse.name}`);
-                    try {
-                        // Execute tool using BaseProvider's tool execution
-                        logger.debug(`[AmazonBedrockProvider] Debug toolUse.input:`, JSON.stringify(contentItem.toolUse.input, null, 2));
-                        const toolResult = await this.executeSingleTool(contentItem.toolUse.name, contentItem.toolUse.input || {}, contentItem.toolUse.toolUseId);
-                        logger.debug(`[AmazonBedrockProvider] Tool execution successful: ${contentItem.toolUse.name}`);
-                        toolResults.push({
-                            toolResult: {
-                                toolUseId: contentItem.toolUse.toolUseId,
-                                content: [{ text: String(toolResult) }],
-                                status: "success",
-                            },
-                        });
-                    }
-                    catch (error) {
-                        logger.error(`[AmazonBedrockProvider] Tool execution failed: ${contentItem.toolUse.name}`, error);
-                        const errorMessage = error instanceof Error ? error.message : String(error);
-                        // Still create toolResult for failed tools to maintain 1:1 mapping with toolUse blocks
-                        toolResults.push({
-                            toolResult: {
-                                toolUseId: contentItem.toolUse.toolUseId,
-                                content: [
-                                    {
-                                        text: `Error executing tool ${contentItem.toolUse.name}: ${errorMessage}`,
-                                    },
-                                ],
-                                status: "error",
-                            },
-                        });
-                    }
-                }
-            }
-            // Add tool results as user message
-            if (toolResults.length > 0) {
-                const userMessageWithToolResults = {
-                    role: "user",
-                    content: toolResults,
-                };
-                this.conversationHistory.push(userMessageWithToolResults);
-                logger.debug(`[AmazonBedrockProvider] Added ${toolResults.length} tool results to conversation`);
-            }
-            return { shouldContinue: true };
-        }
-        else if (stopReason === "max_tokens") {
-            // Max tokens reached — return what we have rather than continuing,
-            // since the model hit the configured limit.
-            const textContent = bedrockAssistantMessage.content
-                .filter((item) => item.text)
-                .map((item) => item.text)
-                .join(" ");
-            return { shouldContinue: false, text: textContent };
-        }
-        else {
-            logger.warn(`[AmazonBedrockProvider] Unrecognized stop reason "${stopReason}", ending conversation.`);
-            return { shouldContinue: false, text: "" };
-        }
-    }
-    convertToAWSMessages(bedrockMessages) {
-        return bedrockMessages.map((msg) => ({
-            role: msg.role,
-            content: msg.content.map((item) => {
-                if (item.text) {
-                    return {
-                        text: item.text,
-                    };
-                }
-                if (item.image) {
-                    return {
-                        image: item.image,
-                    };
-                }
-                if (item.document) {
-                    return {
-                        document: item.document,
-                    };
-                }
-                if (item.toolUse) {
-                    return {
-                        toolUse: {
-                            toolUseId: item.toolUse.toolUseId,
-                            name: item.toolUse.name,
-                            input: item.toolUse.input,
-                        },
-                    };
-                }
-                if (item.toolResult) {
-                    return {
-                        toolResult: {
-                            toolUseId: item.toolResult.toolUseId,
-                            content: item.toolResult.content,
-                            status: item.toolResult.status,
-                        },
-                    };
-                }
-                return { text: "" };
-            }),
-        }));
-    }
-    async executeSingleTool(toolName, args, _toolUseId) {
-        return bedrockTracer.startActiveSpan("bedrock.tool.execute", {
-            kind: SpanKind.CLIENT,
-            attributes: {
-                "gen_ai.tool.name": toolName,
-                "gen_ai.system": "aws.bedrock",
-            },
-        }, async (span) => {
-            try {
-                logger.debug(`[AmazonBedrockProvider] Executing single tool: ${toolName}`, {
-                    args,
-                });
-                // Use BaseProvider's tool execution mechanism
-                const aiTools = await this.getAllTools();
-                const tools = this.convertAISDKToolsToToolDefinitions(aiTools);
-                if (!tools[toolName]) {
-                    throw new Error(`Tool not found: ${toolName}`);
-                }
-                const tool = tools[toolName];
-                if (!tool || !tool.execute) {
-                    throw new Error(`Tool ${toolName} does not have execute method`);
-                }
-                // Apply robust parameter handling like Bedrock-MCP-Connector
-                // Bedrock toolUse.input already contains the correct parameter structure
-                const toolInput = args || {};
-                // Add default parameters for common tools that Claude might call without required params
-                if (toolName === "list_directory" && !toolInput.path) {
-                    toolInput.path = ".";
-                    logger.debug(`[AmazonBedrockProvider] Added default path '.' for list_directory tool`);
-                }
-                logger.debug(`[AmazonBedrockProvider] Tool input parameters:`, toolInput);
-                // Convert Record<string, unknown> to ToolArgs by filtering out non-JsonValue types
-                const toolArgs = {};
-                for (const [key, value] of Object.entries(toolInput)) {
-                    // Only include values that are JsonValue compatible
-                    if (value === null ||
-                        typeof value === "string" ||
-                        typeof value === "number" ||
-                        typeof value === "boolean" ||
-                        (typeof value === "object" && value !== null)) {
-                        toolArgs[key] = value;
-                    }
-                }
-                const result = await tool.execute(toolArgs);
-                logger.debug(`[AmazonBedrockProvider] Tool execution result:`, {
-                    toolName,
-                    result,
-                });
-                // Handle ToolResult type
-                let finalResult;
-                if (result && typeof result === "object" && "success" in result) {
-                    if (result.success && result.data !== undefined) {
-                        if (typeof result.data === "string") {
-                            finalResult = result.data;
-                        }
-                        else if (typeof result.data === "object") {
-                            finalResult = JSON.stringify(result.data, null, 2);
-                        }
-                        else {
-                            finalResult = String(result.data);
-                        }
-                    }
-                    else if (result.error) {
-                        const errorMessage = typeof result.error === "string"
-                            ? result.error
-                            : result.error.message || "Tool execution failed";
-                        throw new Error(errorMessage);
-                    }
-                    else {
-                        finalResult = "";
-                    }
-                }
-                else if (typeof result === "string") {
-                    // Fallback for non-ToolResult return types
-                    finalResult = result;
-                }
-                else if (typeof result === "object") {
-                    finalResult = JSON.stringify(result, null, 2);
-                }
-                else {
-                    finalResult = String(result);
-                }
-                span.setStatus({ code: SpanStatusCode.OK });
-                return finalResult;
-            }
-            catch (error) {
-                logger.error(`[AmazonBedrockProvider] Tool execution error:`, {
-                    toolName,
-                    error,
-                });
-                span.setStatus({
-                    code: SpanStatusCode.ERROR,
-                    message: error.message,
-                });
-                span.recordException(error);
-                throw error;
-            }
-            finally {
-                span.end();
-            }
-        });
-    }
-    convertAISDKToolsToToolDefinitions(aiTools) {
-        const result = {};
-        for (const [name, tool] of Object.entries(aiTools)) {
-            if ("description" in tool && tool.description) {
-                // Extract schema from legacy `parameters` (AI SDK v3/v4) or current `inputSchema` (v6)
-                const legacyTool = tool;
-                const extractedParams = legacyTool.parameters ??
-                    tool.inputSchema;
-                result[name] = {
-                    description: tool.description,
-                    parameters: extractedParams,
-                    execute: async (params) => {
-                        if ("execute" in tool && tool.execute) {
-                            const result = await tool.execute(params, {
-                                toolCallId: `tool_${Date.now()}`,
-                                messages: [],
-                            });
-                            return {
-                                success: true,
-                                data: result,
-                            };
-                        }
-                        throw new Error(`Tool ${name} has no execute method`);
-                    },
-                };
-            }
-        }
-        return result;
-    }
-    formatToolsForBedrock(tools) {
-        if (!tools || Object.keys(tools).length === 0) {
-            return null;
-        }
-        const bedrockTools = Object.entries(tools).map(([name, tool]) => {
-            // Handle Zod schema or plain object schema
-            let schema;
-            if (tool.parameters && typeof tool.parameters === "object") {
-                // Check if it's a Zod schema
-                if ("_def" in tool.parameters) {
-                    // It's a Zod schema, convert to JSON schema
-                    schema = convertZodToJsonSchema(tool.parameters);
-                }
-                else {
-                    // It's already a plain object schema
-                    schema = tool.parameters;
-                }
-            }
-            else {
-                schema = {
-                    type: "object",
-                    properties: {},
-                    required: [],
-                };
-            }
-            // Ensure the schema always has type: "object" at the root level
-            if (!schema.type || schema.type !== "object") {
-                schema = {
-                    type: "object",
-                    properties: schema.properties || {},
-                    required: schema.required || [],
-                };
-            }
-            const toolSpec = {
-                name,
-                description: tool.description,
-                inputSchema: {
-                    json: schema,
-                },
-            };
-            return {
-                toolSpec,
-            };
-        });
-        logger.debug(`[AmazonBedrockProvider] Formatted ${bedrockTools.length} tools for Bedrock`);
-        return { tools: bedrockTools };
-    }
-    // Convert multimodal messages to Bedrock format
-    convertToBedrockMessages(messages) {
-        return messages.map((msg) => {
-            const bedrockMessage = {
-                role: msg.role === "system" ? "user" : msg.role,
-                content: [],
-            };
-            if (typeof msg.content === "string") {
-                bedrockMessage.content.push({ text: msg.content });
-            }
-            else {
-                msg.content.forEach((contentItem) => {
-                    if (contentItem.type === "text" && contentItem.text) {
-                        bedrockMessage.content.push({ text: contentItem.text });
-                    }
-                    else if (contentItem.type === "image" && contentItem.image) {
-                        const imageData = typeof contentItem.image === "string"
-                            ? Buffer.from(contentItem.image.replace(/^data:image\/\w+;base64,/, ""), "base64")
-                            : contentItem.image;
-                        let format = contentItem.mimeType?.split("/")[1] || "png";
-                        if (format === "jpg") {
-                            format = "jpeg";
-                        }
-                        bedrockMessage.content.push({
-                            image: {
-                                format: format === "jpeg"
-                                    ? ImageFormat.JPEG
-                                    : format === "png"
-                                        ? ImageFormat.PNG
-                                        : format === "gif"
-                                            ? ImageFormat.GIF
-                                            : ImageFormat.WEBP,
-                                source: {
-                                    bytes: imageData,
-                                },
-                            },
-                        });
-                    }
-                    else if (contentItem.type === "document" ||
-                        contentItem.type === "pdf" ||
-                        (contentItem.type === "file" &&
-                            contentItem.mimeType?.toLowerCase().startsWith("application/pdf"))) {
-                        let docData;
-                        if (typeof contentItem.data === "string") {
-                            const pdfString = contentItem.data.replace(/^data:application\/pdf;base64,/i, "");
-                            docData = Buffer.from(pdfString, "base64");
-                        }
-                        else {
-                            docData = contentItem.data;
-                        }
-                        // Extract basename and sanitize for Bedrock's filename requirements
-                        // Bedrock only allows: alphanumeric, whitespace, hyphens, parentheses, brackets
-                        // NOTE: Periods (.) are NOT allowed, so we remove the extension
-                        let filename = typeof contentItem.name === "string" && contentItem.name
-                            ? path.basename(contentItem.name)
-                            : "document-pdf";
-                        // Remove file extension
-                        filename = filename.replace(/\.[^.]+$/, "");
-                        // Replace all disallowed characters with hyphens
-                        // Bedrock constraint: only alphanumeric, whitespace, hyphens, parentheses, brackets allowed
-                        filename = filename.replace(/[^a-zA-Z0-9\s\-()[\]]/g, "-");
-                        // Clean up: remove multiple consecutive hyphens and trim
-                        filename = filename
-                            .replace(/-+/g, "-")
-                            .trim()
-                            .replace(/^-+|-+$/g, "");
-                        // Fallback if filename becomes empty after sanitization
-                        filename = filename || "document";
-                        bedrockMessage.content.push({
-                            document: {
-                                format: "pdf",
-                                name: filename,
-                                source: {
-                                    bytes: docData,
-                                },
-                            },
-                        });
-                    }
-                });
-            }
-            return bedrockMessage;
-        });
-    }
-    // Bedrock-MCP-Connector compatibility
-    getBedrockClient() {
-        return this.bedrockClient;
-    }
-    async executeStream(options) {
-        logger.debug("🟢 [TRACE] executeStream ENTRY - starting streaming attempt");
-        logger.info("🚀 [AmazonBedrockProvider] Attempting real streaming with ConverseStreamCommand");
-        return bedrockTracer.startActiveSpan("bedrock.stream", {
-            kind: SpanKind.CLIENT,
-            attributes: {
-                "gen_ai.system": "aws.bedrock",
-                "gen_ai.request.model": this.modelName || this.getDefaultModel(),
-                "gen_ai.operation.name": "stream",
-            },
-        }, async (streamSpan) => {
-            try {
-                logger.debug("🟢 [TRACE] executeStream TRY block - about to call streamingConversationLoop");
-                // Clear conversation history for new streaming session
-                this.conversationHistory = [];
-                // Check for multimodal input (images, PDFs, CSVs, files)
-                const hasMultimodalInput = !!(options.input?.images?.length ||
-                    options.input?.content?.length ||
-                    options.input?.files?.length ||
-                    options.input?.csvFiles?.length ||
-                    options.input?.pdfFiles?.length);
-                if (hasMultimodalInput) {
-                    logger.debug(`[AmazonBedrockProvider] Detected multimodal input, using multimodal message builder`, {
-                        hasImages: !!options.input?.images?.length,
-                        imageCount: options.input?.images?.length || 0,
-                        hasContent: !!options.input?.content?.length,
-                        contentCount: options.input?.content?.length || 0,
-                        hasFiles: !!options.input?.files?.length,
-                        fileCount: options.input?.files?.length || 0,
-                        hasCSVFiles: !!options.input?.csvFiles?.length,
-                        csvFileCount: options.input?.csvFiles?.length || 0,
-                        hasPDFFiles: !!options.input?.pdfFiles?.length,
-                        pdfFileCount: options.input?.pdfFiles?.length || 0,
-                    });
-                    const multimodalOptions = buildMultimodalOptions(options, this.providerName, this.modelName);
-                    const multimodalMessages = await buildMultimodalMessagesArray(multimodalOptions, this.providerName, this.modelName);
-                    // Convert to Bedrock format
-                    this.conversationHistory =
-                        this.convertToBedrockMessages(multimodalMessages);
-                }
-                else {
-                    logger.debug(`[AmazonBedrockProvider] Text-only input, using simple message builder`);
-                    // Add user message to conversation - simple text-only case
-                    const userMessage = {
-                        role: "user",
-                        content: [{ text: options.input.text }],
-                    };
-                    this.conversationHistory.push(userMessage);
-                }
-                logger.debug(`[AmazonBedrockProvider] Starting streaming conversation with ${this.conversationHistory.length} message(s)`);
-                // Call the actual streaming implementation that already exists
-                logger.debug("🟢 [TRACE] executeStream - calling streamingConversationLoop NOW");
-                const result = await this.streamingConversationLoop(options, streamSpan);
-                logger.debug("🟢 [TRACE] executeStream - streamingConversationLoop SUCCESS, returning result");
-                streamSpan.setStatus({ code: SpanStatusCode.OK });
-                streamSpan.end();
-                return result;
-            }
-            catch (error) {
-                logger.debug("🔴 [TRACE] executeStream CATCH - error caught from streamingConversationLoop");
-                const errorObj = error;
-                // Check if error is related to streaming permissions
-                const isPermissionError = errorObj?.name ===
-                    "AccessDeniedException" ||
-                    errorObj?.name ===
-                        "UnauthorizedOperation" ||
-                    errorObj?.message?.includes("bedrock:InvokeModelWithResponseStream") ||
-                    errorObj?.message?.includes("streaming") ||
-                    errorObj?.message?.includes("ConverseStream");
-                logger.debug("🔴 [TRACE] executeStream CATCH - checking if permission error");
-                logger.debug(`🔴 [TRACE] executeStream CATCH - isPermissionError=${isPermissionError}`);
-                if (isPermissionError) {
-                    logger.debug("🟡 [TRACE] executeStream CATCH - PERMISSION ERROR DETECTED, starting fallback");
-                    logger.warn(`[AmazonBedrockProvider] Streaming permissions not available, falling back to generate method: ${errorObj.message}`);
-                    streamSpan.addEvent("stream.fallback_to_generate", {
-                        reason: errorObj.message,
-                    });
-                    // Fallback to generate method and convert to streaming format
-                    const generateResult = await this.generate({
-                        prompt: options.input.text,
-                        input: options.input,
-                        maxTokens: options.maxTokens,
-                        temperature: options.temperature,
-                        systemPrompt: options.systemPrompt,
-                    });
-                    if (!generateResult) {
-                        streamSpan.setStatus({
-                            code: SpanStatusCode.ERROR,
-                            message: "Generate method returned null result",
-                        });
-                        streamSpan.end();
-                        // eslint-disable-next-line preserve-caught-error
-                        throw new Error("Generate method returned null result");
-                    }
-                    streamSpan.setAttribute("gen_ai.response.stop_reason", "fallback_end_turn");
-                    streamSpan.setStatus({ code: SpanStatusCode.OK });
-                    streamSpan.end();
-                    // Convert generate result to streaming format
-                    const stream = new ReadableStream({
-                        start(controller) {
-                            // Split the response into chunks for pseudo-streaming
-                            const responseText = generateResult.content || "";
-                            const chunks = responseText.split(" ");
-                            chunks.forEach((word, _index) => {
-                                controller.enqueue({ content: word + " " });
-                            });
-                            controller.enqueue({ content: "" });
-                            controller.close();
-                        },
-                    });
-                    // Convert ReadableStream to AsyncIterable like streamingConversationLoop does
-                    const asyncIterable = {
-                        async *[Symbol.asyncIterator]() {
-                            const reader = stream.getReader();
-                            try {
-                                while (true) {
-                                    const { done, value } = await reader.read();
-                                    if (done) {
-                                        break;
-                                    }
-                                    yield value;
-                                }
-                            }
-                            finally {
-                                reader.releaseLock();
-                            }
-                        },
-                    };
-                    return {
-                        stream: asyncIterable,
-                        usage: { total: 0, input: 0, output: 0 },
-                        model: this.modelName || this.getDefaultModel(),
-                        provider: this.getProviderName(),
-                        metadata: {
-                            fallback: true,
-                        },
-                    };
-                }
-                // Re-throw non-permission errors
-                streamSpan.setStatus({
-                    code: SpanStatusCode.ERROR,
-                    message: errorObj instanceof Error ? errorObj.message : String(errorObj),
-                });
-                streamSpan.recordException(errorObj instanceof Error ? errorObj : new Error(String(errorObj)));
-                streamSpan.end();
-                throw error;
-            }
-        });
-    }
-    async streamingConversationLoop(options, streamSpan) {
-        logger.debug("🟦 [TRACE] streamingConversationLoop ENTRY");
-        const startTime = Date.now();
-        const maxIterations = options.maxSteps || DEFAULT_MAX_STEPS;
-        let iteration = 0;
-        // The REAL issue: ReadableStream errors don't bubble up to the caller
-        // So we need to make the first streaming call synchronously to test permissions
-        try {
-            logger.debug("🟦 [TRACE] streamingConversationLoop - testing first streaming call");
-            const commandInput = await this.prepareStreamCommand(options);
-            const command = new ConverseStreamCommand(commandInput);
-            logger.debug("[Observability] Bedrock streaming API request", {
-                model: commandInput.modelId,
-                messageCount: commandInput.messages?.length || 0,
-                toolCount: commandInput.toolConfig?.tools?.length || 0,
-            });
-            streamSpan.addEvent("stream.api_call", {
-                "bedrock.message_count": commandInput.messages?.length || 0,
-                "bedrock.tool_count": commandInput.toolConfig?.tools?.length || 0,
-            });
-            const streamStartTime = Date.now();
-            const response = await withTimeout(this.bedrockClient.send(command), 120_000, new Error("Bedrock streaming API call timed out"));
-            logger.debug("[Observability] Bedrock streaming API connection established", {
-                model: commandInput.modelId,
-                durationMs: Date.now() - streamStartTime,
-                hasStream: !!response.stream,
-            });
-            // Process the first response immediately to avoid waste
-            const stream = new ReadableStream({
-                start: async (controller) => {
-                    logger.debug("🟦 [TRACE] streamingConversationLoop - ReadableStream start() called");
-                    try {
-                        // Process the first response we already have, tracking all event types
-                        let firstStopReason = "";
-                        if (response.stream) {
-                            const firstMessageContent = [];
-                            let firstText = "";
-                            for await (const chunk of response.stream) {
-                                if (chunk.contentBlockStart) {
-                                    firstMessageContent.push({});
-                                }
-                                if (chunk.contentBlockDelta?.delta?.text) {
-                                    const textDelta = chunk.contentBlockDelta.delta.text;
-                                    firstText += textDelta;
-                                    controller.enqueue({ content: textDelta });
-                                }
-                                if (chunk.contentBlockStart?.start?.toolUse) {
-                                    const currentBlock = firstMessageContent[firstMessageContent.length - 1];
-                                    currentBlock.toolUse = {
-                                        name: chunk.contentBlockStart.start.toolUse.name || "",
-                                        input: {},
-                                        toolUseId: chunk.contentBlockStart.start.toolUse.toolUseId ||
-                                            `tool_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`,
-                                    };
-                                }
-                                if (chunk.contentBlockDelta?.delta?.toolUse) {
-                                    const currentBlock = firstMessageContent[firstMessageContent.length - 1];
-                                    if (!currentBlock.toolUse) {
-                                        currentBlock.toolUse = {
-                                            name: "",
-                                            input: {},
-                                            toolUseId: `tool_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`,
-                                        };
-                                    }
-                                    const deltaInput = chunk.contentBlockDelta.delta.toolUse.input;
-                                    if (!deltaInput) {
-                                        // no input delta
-                                    }
-                                    else if (typeof deltaInput === "string") {
-                                        currentBlock._inputBuffer =
-                                            (currentBlock._inputBuffer || "") + deltaInput;
-                                    }
-                                    else if (typeof deltaInput === "object" &&
-                                        !Array.isArray(deltaInput)) {
-                                        const currentInput = currentBlock.toolUse.input || {};
-                                        currentBlock.toolUse.input = {
-                                            ...currentInput,
-                                            ...deltaInput,
-                                        };
-                                    }
-                                }
-                                if (chunk.contentBlockStop) {
-                                    const currentBlock = firstMessageContent[firstMessageContent.length - 1];
-                                    if (currentBlock?.toolUse && currentBlock._inputBuffer) {
-                                        try {
-                                            currentBlock.toolUse.input = JSON.parse(currentBlock._inputBuffer);
-                                        }
-                                        catch {
-                                            currentBlock.toolUse.input = {};
-                                        }
-                                        delete currentBlock._inputBuffer;
-                                    }
-                                    if (firstText && currentBlock && !currentBlock.toolUse) {
-                                        currentBlock.text = firstText;
-                                    }
-                                    firstText = "";
-                                }
-                                if (chunk.messageStop) {
-                                    firstStopReason = chunk.messageStop.stopReason || "end_turn";
-                                    break;
-                                }
-                            }
-                            // Add first assistant message to conversation history
-                            const firstAssistantMessage = {
-                                role: "assistant",
-                                content: firstMessageContent,
-                            };
-                            this.conversationHistory.push(firstAssistantMessage);
-                            streamSpan.addEvent("stream.turn_complete", {
-                                iteration: 0,
-                                stop_reason: firstStopReason,
-                            });
-                            if (firstStopReason === "tool_use") {
-                                const toolNames = firstMessageContent
-                                    .filter((b) => b.toolUse?.name)
-                                    .map((b) => b.toolUse.name)
-                                    .join(", ");
-                                streamSpan.addEvent("stream.tool_use", {
-                                    iteration: 0,
-                                    tool_names: toolNames,
-                                });
-                            }
-                            // Handle the stop reason from the first response
-                            const shouldContinue = await this.handleStreamStopReason(firstStopReason, firstAssistantMessage, controller, options);
-                            if (!shouldContinue) {
-                                streamSpan.setAttribute("gen_ai.response.stop_reason", firstStopReason);
-                                return;
-                            }
-                        }
-                        // Continue with normal iterations if needed
-                        while (iteration < maxIterations) {
-                            iteration++;
-                            logger.debug(`[AmazonBedrockProvider] Streaming iteration ${iteration}`);
-                            const commandInput = await this.prepareStreamCommand(options);
-                            const { stopReason, assistantMessage } = await this.processStreamResponse(commandInput, controller);
-                            streamSpan.addEvent("stream.turn_complete", {
-                                iteration,
-                                stop_reason: stopReason,
-                            });
-                            if (stopReason === "tool_use") {
-                                const toolNames = assistantMessage.content
-                                    .filter((b) => b.toolUse?.name)
-                                    .map((b) => b.toolUse.name)
-                                    .join(", ");
-                                streamSpan.addEvent("stream.tool_use", {
-                                    iteration,
-                                    tool_names: toolNames,
-                                });
-                            }
-                            const shouldContinue = await this.handleStreamStopReason(stopReason, assistantMessage, controller, options);
-                            if (!shouldContinue) {
-                                streamSpan.setAttribute("gen_ai.response.stop_reason", stopReason);
-                                break;
-                            }
-                        }
-                        if (iteration >= maxIterations) {
-                            streamSpan.setAttribute("gen_ai.response.stop_reason", "max_iterations");
-                            controller.error(new Error("Streaming conversation exceeded maximum iterations"));
-                        }
-                    }
-                    catch (error) {
-                        logger.debug("🔴 [TRACE] streamingConversationLoop - CATCH block hit in ReadableStream");
-                        controller.error(error);
-                    }
-                },
-            });
-            // Create analytics promise (without token tracking for now due to AWS SDK limitations)
-            const analyticsPromise = Promise.resolve(createAnalytics(this.providerName, this.modelName || this.getDefaultModel(), { usage: { input: 0, output: 0, total: 0 } }, Date.now() - startTime, {
-                requestId: `bedrock-stream-${Date.now()}`,
-                streamingMode: true,
-                note: "Token usage not available from AWS SDK streaming responses",
-            }));
-            return {
-                stream: this.convertToAsyncIterable(stream),
-                usage: { total: 0, input: 0, output: 0 },
-                model: this.modelName || this.getDefaultModel(),
-                provider: this.getProviderName(),
-                analytics: analyticsPromise,
-                metadata: {
-                    startTime,
-                    streamId: `bedrock-${Date.now()}`,
-                },
-            };
-        }
-        catch (error) {
-            logger.debug("🔴 [TRACE] streamingConversationLoop - first streaming call FAILED, throwing");
-            throw error; // This will be caught by executeStream
-        }
-    }
-    convertToAsyncIterable(stream) {
-        return {
-            async *[Symbol.asyncIterator]() {
-                const reader = stream.getReader();
-                try {
-                    while (true) {
-                        const { done, value } = await reader.read();
-                        if (done) {
-                            break;
-                        }
-                        yield value;
-                    }
-                }
-                finally {
-                    reader.releaseLock();
-                }
-            },
-        };
-    }
-    async prepareStreamCommand(options) {
-        // CRITICAL DEBUG: Log conversation history before conversion
-        if (logger.shouldLog("debug")) {
-            logger.debug(`[AmazonBedrockProvider] BEFORE conversion - conversationHistory length: ${this.conversationHistory.length}`);
-            this.conversationHistory.forEach((msg, index) => {
-                logger.debug(`[AmazonBedrockProvider] Message ${index}: role=${msg.role}, content=${JSON.stringify(msg.content)}`);
-            });
-        }
-        // Get all available tools
-        // BaseProvider.stream() pre-merges base tools + external tools into options.tools
-        const aiTools = options.tools ||
-            (await this.getAllTools());
-        const allTools = this.convertAISDKToolsToToolDefinitions(aiTools);
-        const toolConfig = this.formatToolsForBedrock(allTools);
-        const convertedMessages = this.convertToAWSMessages(this.conversationHistory);
-        if (logger.shouldLog("debug")) {
-            logger.debug(`[AmazonBedrockProvider] AFTER conversion - messages length: ${convertedMessages.length}`);
-            convertedMessages.forEach((msg, index) => {
-                logger.debug(`[AmazonBedrockProvider] Converted Message ${index}: role=${msg.role}, content=${JSON.stringify(msg.content)}`);
-            });
-        }
-        const commandInput = {
-            modelId: this.modelName || this.getDefaultModel(),
-            messages: convertedMessages,
-            system: [
-                {
-                    text: options.systemPrompt ||
-                        "You are a helpful assistant with access to external tools. Use tools when necessary to provide accurate information.",
-                },
-            ],
-            inferenceConfig: {
-                maxTokens: options.maxTokens, // No default limit - unlimited unless specified
-                temperature: options.temperature || 0.7,
-            },
-        };
-        if (toolConfig) {
-            commandInput.toolConfig = toolConfig;
-        }
-        logger.debug(`[AmazonBedrockProvider] Calling Bedrock streaming with ${this.conversationHistory.length} messages`);
-        // DEBUG: Log exact conversation structure being sent to Bedrock
-        logger.debug(`[AmazonBedrockProvider] DEBUG - Conversation structure:`);
-        this.conversationHistory.forEach((msg, index) => {
-            logger.debug(`  Message ${index} (${msg.role}): ${msg.content.length} content items`);
-            msg.content.forEach((item, itemIndex) => {
-                const keys = Object.keys(item);
-                logger.debug(`    Content ${itemIndex}: ${keys.join(", ")}`);
-            });
-        });
-        return commandInput;
-    }
-    async processStreamResponse(commandInput, controller) {
-        const command = new ConverseStreamCommand(commandInput);
-        logger.debug("[Observability] Bedrock streaming API request (continuation)", {
-            model: commandInput.modelId,
-            messageCount: commandInput.messages?.length || 0,
-        });
-        const iterationStartTime = Date.now();
-        const response = await withTimeout(this.bedrockClient.send(command), 120_000, new Error("Bedrock streaming API call timed out"));
-        logger.debug("[Observability] Bedrock streaming API connection established (continuation)", {
-            model: commandInput.modelId,
-            durationMs: Date.now() - iterationStartTime,
-        });
-        if (!response.stream) {
-            throw new Error("No stream returned from Bedrock");
-        }
-        const currentMessageContent = [];
-        let stopReason = "";
-        let currentText = "";
-        // Process streaming chunks
-        for await (const chunk of response.stream) {
-            if (chunk.contentBlockStart) {
-                // Starting a new content block
-                currentMessageContent.push({});
-            }
-            if (chunk.contentBlockDelta?.delta?.text) {
-                // Text delta - stream it to user
-                const textDelta = chunk.contentBlockDelta.delta.text;
-                currentText += textDelta;
-                controller.enqueue({
-                    content: textDelta,
-                });
-            }
-            if (chunk.contentBlockStart?.start?.toolUse) {
-                // Tool use block starting - initialize tool information
-                const currentBlock = currentMessageContent[currentMessageContent.length - 1];
-                currentBlock.toolUse = {
-                    name: chunk.contentBlockStart.start.toolUse.name || "",
-                    input: {}, // Initialize empty - will be populated by delta chunks
-                    toolUseId: chunk.contentBlockStart.start.toolUse.toolUseId ||
-                        `tool_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`,
-                };
-            }
-            if (chunk.contentBlockDelta?.delta?.toolUse) {
-                // Tool use delta - accumulate tool information
-                const currentBlock = currentMessageContent[currentMessageContent.length - 1];
-                if (!currentBlock.toolUse) {
-                    currentBlock.toolUse = {
-                        name: "",
-                        input: {},
-                        toolUseId: `tool_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`,
-                    };
-                }
-                // Accumulate JSON string fragments into _inputBuffer.
-                // Bedrock sends toolUse.input as incremental JSON string fragments,
-                // not pre-parsed objects. We buffer them and parse at contentBlockStop.
-                if (chunk.contentBlockDelta.delta.toolUse.input) {
-                    const deltaInput = chunk.contentBlockDelta.delta.toolUse.input;
-                    if (typeof deltaInput === "string") {
-                        currentBlock._inputBuffer =
-                            (currentBlock._inputBuffer || "") + deltaInput;
-                    }
-                    else if (deltaInput &&
-                        typeof deltaInput === "object" &&
-                        !Array.isArray(deltaInput)) {
-                        // Some SDK versions may deliver pre-parsed objects; merge directly
-                        const currentInput = currentBlock.toolUse.input || {};
-                        currentBlock.toolUse.input = {
-                            ...currentInput,
-                            ...deltaInput,
-                        };
-                    }
-                }
-            }
-            if (chunk.contentBlockStop) {
-                // Content block completed
-                const currentBlock = currentMessageContent[currentMessageContent.length - 1];
-                // Parse accumulated JSON input buffer for tool-use blocks
-                if (currentBlock?.toolUse && currentBlock._inputBuffer) {
-                    try {
-                        currentBlock.toolUse.input = JSON.parse(currentBlock._inputBuffer);
-                    }
-                    catch {
-                        currentBlock.toolUse.input = {};
-                    }
-                    delete currentBlock._inputBuffer;
-                }
-                if (currentText && currentBlock && !currentBlock.toolUse) {
-                    // Only add text to blocks that don't have toolUse
-                    currentBlock.text = currentText;
-                }
-                currentText = "";
-            }
-            if (chunk.messageStop) {
-                stopReason = chunk.messageStop.stopReason || "end_turn";
-                break;
-            }
-        }
-        // Add assistant message to conversation history
-        const assistantMessage = {
-            role: "assistant",
-            content: currentMessageContent,
-        };
-        this.conversationHistory.push(assistantMessage);
-        return { stopReason, assistantMessage };
-    }
-    async handleStreamStopReason(stopReason, assistantMessage, controller, options) {
-        if (stopReason === "end_turn" || stopReason === "stop_sequence") {
-            // Conversation completed
-            controller.close();
-            return false;
-        }
-        else if (stopReason === "tool_use") {
-            logger.debug(`🛠️ [AmazonBedrockProvider] Tool use detected in streaming - executing tools`);
-            await this.executeStreamTools(assistantMessage.content, options);
-            return true; // Continue conversation loop
-        }
-        else if (stopReason === "max_tokens") {
-            // Max tokens reached — close the stream rather than continuing,
-            // since the model hit the configured limit.
-            controller.close();
-            return false;
-        }
-        else {
-            // Unknown stop reason - end conversation
-            controller.close();
-            return false;
-        }
-    }
-    async executeStreamTools(messageContent, options) {
-        // Execute all tool uses in the message - ensure 1:1 mapping like Bedrock-MCP-Connector
-        const toolResults = [];
-        let toolUseCount = 0;
-        // Track tool calls and results for storage (similar to Vertex onStepFinish)
-        const toolCalls = [];
-        const toolResultsForStorage = [];
-        // Count toolUse blocks first to ensure 1:1 mapping
-        for (const contentItem of messageContent) {
-            if (contentItem.toolUse) {
-                toolUseCount++;
-            }
-        }
-        logger.debug(`🔍 [AmazonBedrockProvider] Found ${toolUseCount} toolUse blocks in assistant message`);
-        for (const contentItem of messageContent) {
-            if (contentItem.toolUse) {
-                logger.debug(`🔧 [AmazonBedrockProvider] Executing tool: ${contentItem.toolUse.name}`);
-                // Track tool call
-                toolCalls.push({
-                    type: "tool-call",
-                    toolCallId: contentItem.toolUse.toolUseId,
-                    toolName: contentItem.toolUse.name,
-                    args: contentItem.toolUse.input || {},
-                });
-                try {
-                    const toolResult = await this.executeSingleTool(contentItem.toolUse.name, contentItem.toolUse.input || {}, contentItem.toolUse.toolUseId);
-                    logger.debug(`✅ [AmazonBedrockProvider] Tool execution successful: ${contentItem.toolUse.name}`);
-                    // Track tool result for storage
-                    toolResultsForStorage.push({
-                        type: "tool-result",
-                        toolCallId: contentItem.toolUse.toolUseId,
-                        toolName: contentItem.toolUse.name,
-                        result: toolResult,
-                    });
-                    // Ensure exact structure matching Bedrock-MCP-Connector
-                    toolResults.push({
-                        toolResult: {
-                            toolUseId: contentItem.toolUse.toolUseId,
-                            content: [{ text: String(toolResult) }],
-                            status: "success",
-                        },
-                    });
-                }
-                catch (error) {
-                    logger.error(`❌ [AmazonBedrockProvider] Tool execution failed: ${contentItem.toolUse.name}`, error);
-                    const errorMessage = error instanceof Error ? error.message : String(error);
-                    // Track failed tool result
-                    toolResultsForStorage.push({
-                        type: "tool-result",
-                        toolCallId: contentItem.toolUse.toolUseId,
-                        toolName: contentItem.toolUse.name,
-                        result: { error: errorMessage },
-                    });
-                    toolResults.push({
-                        toolResult: {
-                            toolUseId: contentItem.toolUse.toolUseId,
-                            content: [
-                                {
-                                    text: `Error executing tool ${contentItem.toolUse.name}: ${errorMessage}`,
-                                },
-                            ],
-                            status: "error",
-                        },
-                    });
-                }
-            }
-        }
-        logger.debug(`📊 [AmazonBedrockProvider] Created ${toolResults.length} toolResult blocks for ${toolUseCount} toolUse blocks`);
-        // Validate 1:1 mapping before adding to conversation
-        if (toolResults.length !== toolUseCount) {
-            logger.error(`❌ [AmazonBedrockProvider] Mismatch: ${toolResults.length} toolResults vs ${toolUseCount} toolUse blocks`);
-            throw new Error(`Tool mapping mismatch: ${toolResults.length} toolResults for ${toolUseCount} toolUse blocks`);
-        }
-        // Add tool results as user message - exact structure like Bedrock-MCP-Connector
-        if (toolResults.length > 0) {
-            const userMessageWithToolResults = {
-                role: "user",
-                content: toolResults,
-            };
-            this.conversationHistory.push(userMessageWithToolResults);
-            logger.debug(`📤 [AmazonBedrockProvider] Added ${toolResults.length} tool results to conversation (1:1 mapping validated)`);
-            // Store tool execution for analytics and debugging (similar to Vertex onStepFinish)
-            this.handleToolExecutionStorage(toolCalls, toolResultsForStorage, options, new Date()).catch((error) => {
-                logger.warn("[AmazonBedrockProvider] Failed to store tool executions", {
-                    provider: this.providerName,
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            });
-        }
-    }
-    /**
-     * Health check for Amazon Bedrock service
-     * Uses ListFoundationModels API to validate connectivity and permissions
-     */
-    async checkBedrockHealth() {
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), 10000); // 10 second timeout
-        // Create a separate BedrockClient for health checks (not BedrockRuntimeClient)
-        // Use simple configuration like working example - no custom proxy handler
-        const healthCheckClient = new BedrockClient({
-            region: process.env.AWS_REGION || "us-east-1",
-        });
-        try {
-            logger.debug("🔍 [AmazonBedrockProvider] Starting health check...");
-            const command = new ListFoundationModelsCommand({});
-            const response = await healthCheckClient.send(command, {
-                abortSignal: controller.signal,
-            });
-            const models = response.modelSummaries || [];
-            const activeModels = models.filter((model) => model.modelLifecycle?.status === "ACTIVE");
-            logger.debug(`✅ [AmazonBedrockProvider] Health check passed - Found ${activeModels.length} active models out of ${models.length} total models`);
-            if (activeModels.length === 0) {
-                throw new Error("No active foundation models available in the region");
-            }
-        }
-        catch (error) {
-            clearTimeout(timeoutId);
-            const errorObj = error;
-            if (isAbortError(error)) {
-                throw new Error("Bedrock health check timed out after 10 seconds", {
-                    cause: error,
-                });
-            }
-            const errorMessage = typeof errorObj.message === "string" ? errorObj.message : "";
-            if (errorMessage.includes("UnauthorizedOperation") ||
-                errorMessage.includes("AccessDenied")) {
-                throw new Error("Bedrock access denied. Check your AWS credentials and IAM permissions for bedrock:ListFoundationModels", { cause: error });
-            }
-            if (errorObj.code === "ECONNREFUSED" || errorObj.code === "ENOTFOUND") {
-                throw new Error("Unable to connect to Bedrock service. Check your network connectivity and AWS region configuration", { cause: error });
-            }
-            logger.error("❌ [AmazonBedrockProvider] Health check failed:", error);
-            throw new Error(`Bedrock health check failed: ${errorMessage || "Unknown error"}`, { cause: error });
-        }
-        finally {
-            clearTimeout(timeoutId);
-            try {
-                healthCheckClient.destroy();
-            }
-            catch {
-                // Ignore destroy errors during cleanup
-            }
-        }
-    }
-    formatProviderError(error) {
-        // Handle AWS SDK specific errors
-        const message = error instanceof Error ? error.message : String(error);
-        if (message.includes("AccessDeniedException")) {
-            return new AuthenticationError("AWS Bedrock access denied. Check your credentials and permissions.", this.providerName);
-        }
-        if (message.includes("ValidationException")) {
-            return new ProviderError(`Validation error: ${message}`, this.providerName);
-        }
-        return new ProviderError(`AWS Bedrock error: ${message}`, this.providerName);
-    }
-    /**
-     * Generate embeddings for text using Amazon Bedrock embedding models
-     * Uses the native AWS SDK InvokeModel command for Titan embeddings
-     * @param text - The text to embed
-     * @param modelName - The embedding model to use (default: amazon.titan-embed-text-v2:0)
-     * @returns Promise resolving to the embedding vector
-     */
-    async embed(text, modelName) {
-        const embeddingModelName = modelName || "amazon.titan-embed-text-v2:0";
-        logger.debug("Generating embedding", {
-            provider: this.providerName,
-            model: embeddingModelName,
-            textLength: text.length,
-        });
-        try {
-            const { InvokeModelCommand } = await import("@aws-sdk/client-bedrock-runtime");
-            // Titan Embed models expect a specific input format
-            const requestBody = JSON.stringify({
-                inputText: text,
-            });
-            const command = new InvokeModelCommand({
-                modelId: embeddingModelName,
-                contentType: "application/json",
-                accept: "application/json",
-                body: requestBody,
-            });
-            const response = await withTimeout(this.bedrockClient.send(command), 60_000, new Error("Bedrock embedding API call timed out"));
-            // Parse the response
-            const responseBody = JSON.parse(new TextDecoder().decode(response.body));
-            if (!responseBody.embedding || !Array.isArray(responseBody.embedding)) {
-                throw new Error("Invalid embedding response from Bedrock");
-            }
-            logger.debug("Embedding generated successfully", {
-                provider: this.providerName,
-                model: embeddingModelName,
-                embeddingDimension: responseBody.embedding.length,
-            });
-            return responseBody.embedding;
-        }
-        catch (error) {
-            logger.error("Embedding generation failed", {
-                error: error instanceof Error ? error.message : String(error),
-                model: embeddingModelName,
-                textLength: text.length,
-            });
-            throw this.handleProviderError(error);
-        }
-    }
-    /**
-     * Generate embeddings for multiple texts in a single batch
-     * @param texts - The texts to embed
-     * @param modelName - The embedding model to use (default: amazon.titan-embed-text-v2:0)
-     * @returns Promise resolving to an array of embedding vectors
-     */
-    async embedMany(texts, modelName) {
-        const embeddingModelName = modelName || "amazon.titan-embed-text-v2:0";
-        logger.debug("Generating batch embeddings", {
-            provider: this.providerName,
-            model: embeddingModelName,
-            count: texts.length,
-        });
-        try {
-            const embeddings = await Promise.all(texts.map((text) => this.embed(text, embeddingModelName)));
-            logger.debug("Batch embeddings generated successfully", {
-                provider: this.providerName,
-                model: embeddingModelName,
-                count: embeddings.length,
-                embeddingDimension: embeddings[0]?.length,
-            });
-            return embeddings;
-        }
-        catch (error) {
-            logger.error("Batch embedding generation failed", {
-                error: error instanceof Error ? error.message : String(error),
-                model: embeddingModelName,
-                count: texts.length,
-            });
-            throw this.handleProviderError(error);
-        }
-    }
-}