bedrock-wrapper 2.5.0 → 2.6.0

package/logs/e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3/pre_tool_use.json

@@ -2537,5 +2537,435 @@
       "file_path": "C:\\git\\bedrock-wrapper\\CLAUDE.md",
       "content": "# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n## Project Overview\n\nBedrock Wrapper (v2.5.0) is an npm package that translates OpenAI-compatible API objects to AWS Bedrock's serverless inference LLMs. It supports 32+ models including Claude, Nova, GPT-OSS, Llama, and Mistral families with features like vision support, thinking modes, and stop sequences.\n\n## Core Architecture\n\nThe system has two main API paths and three core components:\n\n### API Paths\n\n1. **Converse API Path** (`useConverseAPI: true`):\n   - Unified request/response format across all models\n   - Simplified message handling without model-specific formatting\n   - Native system prompt support\n   - Cleaner multimodal handling\n   - Located at lines 510-677 in bedrock-wrapper.js\n\n2. **Invoke API Path** (default):\n   - Model-specific request formatting and response parsing\n   - Complex prompt construction for non-messages API models\n   - Located at lines 680-727 in bedrock-wrapper.js\n\n### Core Components\n\n1. **bedrock-wrapper.js**: Main async generator function\n   - `bedrockWrapper()`: Entry point supporting both APIs\n   - `convertToConverseFormat()`: Converts OpenAI messages to Converse API format\n   - `processMessagesForInvoke()`: Handles model-specific message processing\n   - `buildInvokePrompt()`: Constructs model-specific prompts\n   - `buildInvokeRequest()`: Creates model-specific request objects\n   - Thinking mode support with `<think>` tags for Claude and `<reasoning>` tags for GPT-OSS\n\n2. **bedrock-models.js**: Model configuration registry\n   - Each model entry contains: modelName, modelId, vision support, API type, response paths\n   - Special configurations for thinking models (budget_tokens, anthropic_beta headers)\n   - Stop sequences parameter mapping per model family\n\n3. **utils.js**: Helper utilities\n\n## Development Commands\n\n```bash\n# Install dependencies\nnpm install\n\n# Clean reinstall\nnpm run clean\n\n# Test all models with both APIs (comparison mode)\nnpm run test\n\n# Test with specific API\nnpm run test:invoke      # Invoke API only\nnpm run test:converse    # Converse API only\n\n# Test vision capabilities (11 vision-enabled models)\nnpm run test-vision\nnpm run test-vision:invoke\nnpm run test-vision:converse\n\n# Test stop sequences (Claude, Nova, GPT-OSS, Mistral)\nnpm run test-stop\nnpm run test-stop:invoke\nnpm run test-stop:converse\n\n# Test Converse API specifically\nnpm run test-converse\n\n# Interactive CLI testing\nnpm run interactive\n```\n\n## Environment Configuration\n\nCreate `.env` file:\n```\nAWS_REGION=us-west-2\nAWS_ACCESS_KEY_ID=your_access_key\nAWS_SECRET_ACCESS_KEY=your_secret_key\nLLM_MAX_GEN_TOKENS=1024\nLLM_TEMPERATURE=0.1\nLLM_TOP_P=0.9\n```\n\n## Adding New Models\n\nRequired fields in bedrock-models.js:\n- `modelName`: Consumer-facing name\n- `modelId`: AWS Bedrock identifier\n- `vision`: Boolean for image support\n- `messages_api`: Boolean (true for Claude/Nova/GPT-OSS, false for prompt-based)\n- `response_chunk_element`: JSON path for streaming responses\n- `response_nonchunk_element`: JSON path for non-streaming responses\n- `special_request_schema`: Model-specific requirements\n- `stop_sequences_param_name`: Parameter name for stop sequences\n\n## Critical Implementation Details\n\n### Converse API Thinking Support\n- Thinking configuration added via `additionalModelRequestFields`\n- Response thinking data extracted from `reasoningContent.reasoningText.text`\n- Budget tokens calculated with constraints: 1024 <= budget_tokens <= (maxTokens * 0.8)\n- Temperature forced to 1.0, top_p removed for thinking models\n\n### Nova Models Special Handling\n- Detect via `special_request_schema.schemaVersion === \"messages-v1\"`\n- Content must be array format: `[{text: content}]`\n- Parameters nested in `inferenceConfig` object\n\n### Image Processing\n- Sharp library resizes images to max 2048x2048\n- Converts all images to JPEG format\n- Supports base64, data URLs, and HTTP URLs\n- Image-only messages are valid (no text required)\n\n### Stop Sequences Support Matrix\n| Model Family | Support | Parameter | Max Count |\n|-------------|---------|-----------|-----------|\n| Claude      | \u00e2\u0153\u2026      | stop_sequences | 8,191 |\n| Nova        | \u00e2\u0153\u2026      | stopSequences | 4 |\n| GPT-OSS     | \u00e2\u0153\u2026      | stop_sequences | TBD |\n| Mistral     | \u00e2\u0153\u2026      | stop | 10 |\n| Llama       | \u00e2\udc9d\u0152      | N/A | N/A |\n\n### Test Files Output\n- `test-models-output.txt`: Full model test results\n- `test-vision-models-output.txt`: Vision test results\n- `test-stop-sequences-output.txt`: Stop sequences test results\n- `test-converse-api-output.txt`: Converse API comparison results\n\n## Common Issues and Solutions\n\n### Thinking Models Not Showing Tags\n- Ensure `include_thinking_data: true` is in the request\n- Converse API extracts from `reasoningContent.reasoningText.text`\n- Invoke API uses model-specific `thinking_response_chunk_element`\n\n### Stop Sequences Not Working\n- Llama models don't support stop sequences (AWS limitation)\n- Stop sequence stops generation BEFORE the sequence appears\n- Both `stop` and `stop_sequences` parameters are accepted\n\n### Image Processing Failures\n- Ensure images are under 2048x2048 pixels\n- Use JPEG format for best compatibility\n- Check model has `vision: true` in configuration\n\n## Testing Best Practices\n- Always test with both APIs using `--both` flag for comparison\n- Check output files for detailed error messages\n- Use `npm run interactive` for debugging specific models\n- Test thinking models with `include_thinking_data: true`"
     }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "LS",
+    "tool_input": {
+      "path": "C:\\git\\bedrock-proxy-endpoint"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Read",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\server.js"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Read",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\package.json"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Read",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\README.md"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Read",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\example\\example.js"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Read",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\CHANGELOG.md"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "ExitPlanMode",
+    "tool_input": {
+      "plan": "## Plan to Add `useConverseAPI` Parameter to Bedrock Proxy Endpoint\n\nI'll add the `useConverseAPI` optional parameter to the bedrock-proxy-endpoint project, following the same pattern as the existing `include_thinking_data` parameter.\n\n### Changes Required:\n\n#### 1. **server.js** (Main proxy server file)\n- **Line 128-129**: Add `use_converse_api = false` to the parameter extraction, right after `include_thinking_data`\n- **Line 172**: Add `use_converse_api` to the `openaiChatCompletionsCreateObject`\n- **Line 193**: Update the `bedrockWrapper` call to pass `useConverseAPI: use_converse_api` in the options object\n- **Line 209**: Update the non-streaming `bedrockWrapper` call similarly\n\n#### 2. **README.md** (Documentation)\n- Add documentation for the new `use_converse_api` parameter in the \"Important values\" section (around line 90)\n- Update the example code to show the new parameter (around line 134)\n- Add a note explaining the benefits of the Converse API\n\n#### 3. **example/example.js** (Example file)\n- Add the `use_converse_api` parameter to the example (around line 40)\n- Add a comment explaining when to use it\n\n#### 4. **package.json**\n- Update version from 2.4.5 to 2.5.0 to match the bedrock-wrapper version that includes Converse API support\n\n#### 5. **CHANGELOG.md**\n- Add a new entry for version 2.5.0 documenting the Converse API support\n\n### Implementation Details:\n\nThe parameter will:\n- Default to `false` to maintain backward compatibility (uses Invoke API by default)\n- When set to `true`, use AWS Bedrock's Converse API for unified request/response format\n- Work exactly like `include_thinking_data` - as an optional boolean parameter in the OpenAI chat completions request\n\n### Benefits of this addition:\n- Allows users to opt-in to the simpler, unified Converse API\n- Provides better consistency across different model families\n- Maintains full backward compatibility with existing implementations\n- Follows the established pattern for optional parameters in the codebase"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "TodoWrite",
+    "tool_input": {
+      "todos": [
+        {
+          "content": "Update server.js to add use_converse_api parameter extraction and pass to bedrockWrapper",
+          "status": "pending",
+          "id": "1"
+        },
+        {
+          "content": "Update README.md to document the new use_converse_api parameter",
+          "status": "pending",
+          "id": "2"
+        },
+        {
+          "content": "Update example/example.js to include use_converse_api in the example",
+          "status": "pending",
+          "id": "3"
+        },
+        {
+          "content": "Update package.json version to 2.5.0",
+          "status": "pending",
+          "id": "4"
+        },
+        {
+          "content": "Update CHANGELOG.md to document version 2.5.0 with Converse API support",
+          "status": "pending",
+          "id": "5"
+        }
+      ]
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "TodoWrite",
+    "tool_input": {
+      "todos": [
+        {
+          "content": "Update server.js to add use_converse_api parameter extraction and pass to bedrockWrapper",
+          "status": "in_progress",
+          "id": "1"
+        },
+        {
+          "content": "Update README.md to document the new use_converse_api parameter",
+          "status": "pending",
+          "id": "2"
+        },
+        {
+          "content": "Update example/example.js to include use_converse_api in the example",
+          "status": "pending",
+          "id": "3"
+        },
+        {
+          "content": "Update package.json version to 2.5.0",
+          "status": "pending",
+          "id": "4"
+        },
+        {
+          "content": "Update CHANGELOG.md to document version 2.5.0 with Converse API support",
+          "status": "pending",
+          "id": "5"
+        }
+      ]
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\server.js",
+      "old_string": "    // Extract parameters from the incoming request\n    const {\n        messages = [],\n        model = 'Llama-3-8b',\n        max_tokens = 800,\n        temperature = 0.1,\n        top_p = 0.9,\n        stream = true,\n        include_thinking_data = false\n    } = req.body;",
+      "new_string": "    // Extract parameters from the incoming request\n    const {\n        messages = [],\n        model = 'Llama-3-8b',\n        max_tokens = 800,\n        temperature = 0.1,\n        top_p = 0.9,\n        stream = true,\n        include_thinking_data = false,\n        use_converse_api = false\n    } = req.body;"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\server.js",
+      "old_string": "    // ----------------------------------------------------------------------\n    // -- create an object that copies your openai chat completions object --\n    // ----------------------------------------------------------------------\n    const openaiChatCompletionsCreateObject = {\n        messages: messages,\n        model: model,\n        max_tokens: max_tokens,\n        stream: stream,\n        temperature: temperature,\n        top_p: top_p,\n        include_thinking_data: include_thinking_data,\n        ...(req.body.stop && { stop: req.body.stop }),\n        ...(req.body.stop_sequences && { stop_sequences: req.body.stop_sequences })\n    };",
+      "new_string": "    // ----------------------------------------------------------------------\n    // -- create an object that copies your openai chat completions object --\n    // ----------------------------------------------------------------------\n    const openaiChatCompletionsCreateObject = {\n        messages: messages,\n        model: model,\n        max_tokens: max_tokens,\n        stream: stream,\n        temperature: temperature,\n        top_p: top_p,\n        include_thinking_data: include_thinking_data,\n        use_converse_api: use_converse_api,\n        ...(req.body.stop && { stop: req.body.stop }),\n        ...(req.body.stop_sequences && { stop_sequences: req.body.stop_sequences })\n    };"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\server.js",
+      "old_string": "            // -------------------\n            // -- streamed call --\n            // -------------------\n            for await (const chunk of bedrockWrapper(awsCreds, openaiChatCompletionsCreateObject, { logging: CONSOLE_LOGGING })) {",
+      "new_string": "            // -------------------\n            // -- streamed call --\n            // -------------------\n            for await (const chunk of bedrockWrapper(awsCreds, openaiChatCompletionsCreateObject, { logging: CONSOLE_LOGGING, useConverseAPI: use_converse_api })) {"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\server.js",
+      "old_string": "            // ---------------------\n            // -- unstreamed call --\n            // ---------------------\n            const response = await bedrockWrapper(awsCreds, openaiChatCompletionsCreateObject, { logging: CONSOLE_LOGGING });",
+      "new_string": "            // ---------------------\n            // -- unstreamed call --\n            // ---------------------\n            const response = await bedrockWrapper(awsCreds, openaiChatCompletionsCreateObject, { logging: CONSOLE_LOGGING, useConverseAPI: use_converse_api });"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "TodoWrite",
+    "tool_input": {
+      "todos": [
+        {
+          "content": "Update server.js to add use_converse_api parameter extraction and pass to bedrockWrapper",
+          "status": "completed",
+          "id": "1"
+        },
+        {
+          "content": "Update README.md to document the new use_converse_api parameter",
+          "status": "in_progress",
+          "id": "2"
+        },
+        {
+          "content": "Update example/example.js to include use_converse_api in the example",
+          "status": "pending",
+          "id": "3"
+        },
+        {
+          "content": "Update package.json version to 2.5.0",
+          "status": "pending",
+          "id": "4"
+        },
+        {
+          "content": "Update CHANGELOG.md to document version 2.5.0 with Converse API support",
+          "status": "pending",
+          "id": "5"
+        }
+      ]
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\README.md",
+      "old_string": "- Important values\n  - `baseUrl`: Root address of server based on your `.env` configuration.\n  - `apiKey`: Descibed in the *Authentication* section above.\n  - `messages`: Array of objects in role / content format.\n  - `model`: This is the `modelName` from the list of supported models found on the `Bedrock Wrapper` README file [here](https://github.com/jparkerweb/bedrock-wrapper?tab=readme-ov-file#supported-models); The `/models` enpoint of this server will also return a list of supported models.\n  - `include_thinking_data`: _Optional_ boolean parameter that when set to `true` will include the model's thinking process in the response (only used with thinking models such as `Claude-3-7-Sonnet-Thinking`).\n  - `stop` or `stop_sequences`: _Optional_ parameter to specify text sequences that will cause the model to stop generating (e.g., `[\"STOP\", \"END\"]`).",
+      "new_string": "- Important values\n  - `baseUrl`: Root address of server based on your `.env` configuration.\n  - `apiKey`: Descibed in the *Authentication* section above.\n  - `messages`: Array of objects in role / content format.\n  - `model`: This is the `modelName` from the list of supported models found on the `Bedrock Wrapper` README file [here](https://github.com/jparkerweb/bedrock-wrapper?tab=readme-ov-file#supported-models); The `/models` enpoint of this server will also return a list of supported models.\n  - `include_thinking_data`: _Optional_ boolean parameter that when set to `true` will include the model's thinking process in the response (only used with thinking models such as `Claude-3-7-Sonnet-Thinking`).\n  - `use_converse_api`: _Optional_ boolean parameter that when set to `true` will use AWS Bedrock's Converse API instead of the Invoke API. The Converse API provides a unified request/response format across all models, better conversation management, and cleaner multimodal handling. Defaults to `false` for backward compatibility.\n  - `stop` or `stop_sequences`: _Optional_ parameter to specify text sequences that will cause the model to stop generating (e.g., `[\"STOP\", \"END\"]`)."
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\README.md",
+      "old_string": "        const chatCompletion = await openai.chat.completions.create({\n            messages: messages,\n            model: \"Claude-4-Sonnet\",\n            max_tokens: 2048,\n            temperature: 0.4,\n            top_p: 0.7,\n            stream: true,\n            include_thinking_data: false,  // Set to true for thinking models like \"Claude-4-Sonnet-Thinking\"\n        });",
+      "new_string": "        const chatCompletion = await openai.chat.completions.create({\n            messages: messages,\n            model: \"Claude-4-Sonnet\",\n            max_tokens: 2048,\n            temperature: 0.4,\n            top_p: 0.7,\n            stream: true,\n            include_thinking_data: false,  // Set to true for thinking models like \"Claude-4-Sonnet-Thinking\"\n            use_converse_api: false,  // Set to true to use the unified Converse API instead of Invoke API\n        });"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "TodoWrite",
+    "tool_input": {
+      "todos": [
+        {
+          "content": "Update server.js to add use_converse_api parameter extraction and pass to bedrockWrapper",
+          "status": "completed",
+          "id": "1"
+        },
+        {
+          "content": "Update README.md to document the new use_converse_api parameter",
+          "status": "completed",
+          "id": "2"
+        },
+        {
+          "content": "Update example/example.js to include use_converse_api in the example",
+          "status": "in_progress",
+          "id": "3"
+        },
+        {
+          "content": "Update package.json version to 2.5.0",
+          "status": "pending",
+          "id": "4"
+        },
+        {
+          "content": "Update CHANGELOG.md to document version 2.5.0 with Converse API support",
+          "status": "pending",
+          "id": "5"
+        }
+      ]
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\example\\example.js",
+      "old_string": "        const chatCompletion = await openai.chat.completions.create({\n            messages: messages,\n            model: \"Claude-3-7-Sonnet-Thinking\", // Try: \"Claude-4-Sonnet\", \"Claude-4-Opus\", \"Claude-4-Sonnet-Thinking\", \"Claude-4-Opus-Thinking\"\n            max_tokens: 2048,\n            temperature: 0.4,\n            top_p: 0.7,\n            stream: true,\n            include_thinking_data: true, // Works with thinking models\n        });",
+      "new_string": "        const chatCompletion = await openai.chat.completions.create({\n            messages: messages,\n            model: \"Claude-3-7-Sonnet-Thinking\", // Try: \"Claude-4-Sonnet\", \"Claude-4-Opus\", \"Claude-4-Sonnet-Thinking\", \"Claude-4-Opus-Thinking\"\n            max_tokens: 2048,\n            temperature: 0.4,\n            top_p: 0.7,\n            stream: true,\n            include_thinking_data: true, // Works with thinking models\n            use_converse_api: false, // Set to true to use the unified Converse API (better consistency across models)\n        });"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "TodoWrite",
+    "tool_input": {
+      "todos": [
+        {
+          "content": "Update server.js to add use_converse_api parameter extraction and pass to bedrockWrapper",
+          "status": "completed",
+          "id": "1"
+        },
+        {
+          "content": "Update README.md to document the new use_converse_api parameter",
+          "status": "completed",
+          "id": "2"
+        },
+        {
+          "content": "Update example/example.js to include use_converse_api in the example",
+          "status": "completed",
+          "id": "3"
+        },
+        {
+          "content": "Update package.json version to 2.5.0",
+          "status": "in_progress",
+          "id": "4"
+        },
+        {
+          "content": "Update CHANGELOG.md to document version 2.5.0 with Converse API support",
+          "status": "pending",
+          "id": "5"
+        }
+      ]
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\package.json",
+      "old_string": "  \"version\": \"2.4.5\",",
+      "new_string": "  \"version\": \"2.5.0\","
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "TodoWrite",
+    "tool_input": {
+      "todos": [
+        {
+          "content": "Update server.js to add use_converse_api parameter extraction and pass to bedrockWrapper",
+          "status": "completed",
+          "id": "1"
+        },
+        {
+          "content": "Update README.md to document the new use_converse_api parameter",
+          "status": "completed",
+          "id": "2"
+        },
+        {
+          "content": "Update example/example.js to include use_converse_api in the example",
+          "status": "completed",
+          "id": "3"
+        },
+        {
+          "content": "Update package.json version to 2.5.0",
+          "status": "completed",
+          "id": "4"
+        },
+        {
+          "content": "Update CHANGELOG.md to document version 2.5.0 with Converse API support",
+          "status": "in_progress",
+          "id": "5"
+        }
+      ]
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "C:\\git\\bedrock-proxy-endpoint\\CHANGELOG.md",
+      "old_string": "# Changelog\nAll notable changes to this project will be documented in this file.\n\n## [2.4.5] - 2025-08-06",
+      "new_string": "# Changelog\nAll notable changes to this project will be documented in this file.\n\n## [2.5.0] - 2025-08-12\n### Added\n- Updated to use Bedrock Wrapper v2.5.0\n- Support for AWS Bedrock Converse API via `use_converse_api` parameter\n  - Optional boolean parameter that defaults to `false` for backward compatibility\n  - When set to `true`, uses the unified Converse API instead of Invoke API\n  - Provides consistent request/response format across all model families\n  - Simplifies conversation management and multimodal handling\n  - Better support for system prompts and tool use (where applicable)\n- Converse API benefits include:\n  - Unified API format across Claude, Nova, GPT-OSS, Llama, and Mistral models\n  - Cleaner handling of thinking models with proper `reasoningContent` extraction\n  - Simplified message format without model-specific prompt construction\n  - Native support for system prompts as a separate field\n\n### Technical Details\n- The `use_converse_api` parameter follows the same pattern as `include_thinking_data`\n- Passes through to bedrock-wrapper's `useConverseAPI` option\n- Works with both streaming and non-streaming responses\n- Maintains full backward compatibility when not specified or set to `false`\n\n## [2.4.5] - 2025-08-06"
+    }
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "PreToolUse",
+    "tool_name": "TodoWrite",
+    "tool_input": {
+      "todos": [
+        {
+          "content": "Update server.js to add use_converse_api parameter extraction and pass to bedrockWrapper",
+          "status": "completed",
+          "id": "1"
+        },
+        {
+          "content": "Update README.md to document the new use_converse_api parameter",
+          "status": "completed",
+          "id": "2"
+        },
+        {
+          "content": "Update example/example.js to include use_converse_api in the example",
+          "status": "completed",
+          "id": "3"
+        },
+        {
+          "content": "Update package.json version to 2.5.0",
+          "status": "completed",
+          "id": "4"
+        },
+        {
+          "content": "Update CHANGELOG.md to document version 2.5.0 with Converse API support",
+          "status": "completed",
+          "id": "5"
+        }
+      ]
+    }
   }
 ]

package/logs/e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3/stop.json

@@ -76,6 +76,13 @@
     "hook_event_name": "Stop",
     "stop_hook_active": false
   },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "Stop",
+    "stop_hook_active": false
+  },
   {
     "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
     "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",

package/logs/e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3/user_prompt_submit.json

@@ -82,5 +82,12 @@
     "cwd": "C:\\git\\bedrock-wrapper",
     "hook_event_name": "UserPromptSubmit",
     "prompt": "/init "
+  },
+  {
+    "session_id": "e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3",
+    "transcript_path": "C:\\Users\\Justin.Parker\\.claude\\projects\\C--git-bedrock-wrapper\\e4cf59ef-9d22-45bf-9c6c-53e3cb9efda3.jsonl",
+    "cwd": "C:\\git\\bedrock-wrapper",
+    "hook_event_name": "UserPromptSubmit",
+    "prompt": "I want to add our \"use converse api\" optional parameter to the `bedrock-proxy-endpoint` project.  We use an optional paramaeter in a similar way for `include_thinking_data`; lets use this same approach."
   }
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bedrock-wrapper",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "🪨 Bedrock Wrapper is an npm package that simplifies the integration of existing OpenAI-compatible API objects with AWS Bedrock's serverless inference LLMs.",
   "homepage": "https://www.equilllabs.com/projects/bedrock-wrapper",
   "repository": {
@@ -23,6 +23,7 @@
     "test-stop:invoke": "node test-stop-sequences.js",
     "test-stop:converse": "node test-stop-sequences.js --converse",
     "test-converse": "node test-converse-api.js",
+    "test:all": "npm run test && npm run test-vision && npm run test-stop && npm run test-converse",
     "interactive": "node interactive-example.js"
   },
   "main": "bedrock-wrapper.js",
@@ -40,11 +41,11 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@aws-sdk/client-bedrock-runtime": "^3.864.0",
-    "dotenv": "^17.2.1",
-    "sharp": "^0.34.3"
+    "@aws-sdk/client-bedrock-runtime": "^3.899.0",
+    "dotenv": "^17.2.3",
+    "sharp": "^0.34.4"
   },
   "devDependencies": {
-    "chalk": "^5.5.0"
+    "chalk": "^5.6.2"
   }
 }