bedrock-agentcore-starter-toolkit 0.1.12__tar.gz → 0.1.14__tar.gz

{bedrock_agentcore_starter_toolkit-0.1.12 → bedrock_agentcore_starter_toolkit-0.1.14}/.github/workflows/release.yml

@@ -181,8 +181,6 @@ jobs:
           1. Approve and merge this PR
           2. The release workflow will automatically:
              - Build and test the package
-             - Publish to Test PyPI
-             - Wait for approval
              - Publish to PyPI
              - Create a GitHub release
              - Tag the release
@@ -294,76 +292,9 @@ jobs:
           name: dist
           path: dist/
 
-  publish-testpypi:
-    name: Publish to TestPyPI
-    needs: build
-    runs-on: ubuntu-latest
-
-    environment:
-      name: test-pypi
-      url: https://test.pypi.org/project/bedrock-agentcore-starter-toolkit/
-
-    steps:
-      - name: Download artifacts
-        uses: actions/download-artifact@v5
-        with:
-          name: dist
-          path: dist/
-
-      - name: Publish to TestPyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          repository-url: https://test.pypi.org/legacy/
-          skip-existing: true
-          password: ${{ secrets.TEST_PYPI_API_TOKEN }}
-
-      - name: Test installation from TestPyPI
-        run: |
-          sleep 60  # Wait for package to be available
-
-          # Get version from wheel filename
-          VERSION=$(ls dist/*.whl | sed -n 's/.*-\([0-9.]*\)-.*/\1/p')
-
-          # Create test environment
-          python -m venv test-install
-          source test-install/bin/activate
-
-          # Install from Test PyPI
-          pip install --index-url https://test.pypi.org/simple/ \
-            --extra-index-url https://pypi.org/simple/ \
-            bedrock-agentcore-starter-toolkit==$VERSION
-
-          # Test CLI
-          agentcore --help
-
-  release-approval:
-    name: Release Approval
-    needs: publish-testpypi
-    runs-on: ubuntu-latest
-    environment:
-      name: pypi-approval
-
-    steps:
-      - name: Approval checkpoint
-        run: |
-          echo "✓ TestPyPI deployment successful"
-          echo "✓ Package available at: https://test.pypi.org/project/bedrock-agentcore-starter-toolkit/"
-          echo ""
-          echo "⚠️  MANUAL APPROVAL REQUIRED"
-          echo ""
-          echo "Before approving production release:"
-          echo "1. Test the package from TestPyPI:"
-          echo "   pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ bedrock-agentcore-starter-toolkit"
-          echo ""
-          echo "2. Verify the CLI works: agentcore --help"
-          echo "3. Check version number is correct"
-          echo "4. Test basic functionality"
-          echo ""
-          echo "Only approve if everything looks good!"
-
   publish-pypi:
     name: Publish to PyPI
-    needs: release-approval
+    needs: [test, build]
     runs-on: ubuntu-latest
     environment:
       name: pypi
@@ -391,6 +322,20 @@ jobs:
         with:
           password: ${{ secrets.PYPI_API_TOKEN }}
 
+      - name: Wait for PyPI availability
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+
+          echo "Waiting for package to be available on PyPI..."
+          for i in {1..10}; do
+            if pip index versions bedrock-agentcore-starter-toolkit | grep -q "$VERSION"; then
+              echo "✓ Package version $VERSION is now available on PyPI"
+              break
+            fi
+            echo "Attempt $i/10: Package not yet available, waiting 30s..."
+            sleep 30
+          done
+
       - name: Create and push tag
         run: |
           git config --global user.name "github-actions[bot]"
@@ -419,7 +364,7 @@ jobs:
 
   summary:
     name: Release Summary
-    needs: publish-testpypi
+    needs: publish-pypi
     runs-on: ubuntu-latest
     if: always()
 
@@ -428,14 +373,14 @@ jobs:
         run: |
           echo "## Release Summary" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
-          if [ "${{ needs.publish-testpypi.result }}" == "success" ]; then
-            echo "✅ **Test PyPI Release Successful**" >> $GITHUB_STEP_SUMMARY
+          if [ "${{ needs.publish-pypi.result }}" == "success" ]; then
+            echo "✅ **PyPI Release Successful**" >> $GITHUB_STEP_SUMMARY
             echo "" >> $GITHUB_STEP_SUMMARY
-            echo "Package published to: https://test.pypi.org/project/bedrock-agentcore-starter-toolkit/" >> $GITHUB_STEP_SUMMARY
+            echo "Package published to: https://pypi.org/project/bedrock-agentcore-starter-toolkit/" >> $GITHUB_STEP_SUMMARY
             echo "" >> $GITHUB_STEP_SUMMARY
-            echo "To install from Test PyPI:" >> $GITHUB_STEP_SUMMARY
+            echo "To install:" >> $GITHUB_STEP_SUMMARY
             echo '```bash' >> $GITHUB_STEP_SUMMARY
-            echo "pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ bedrock-agentcore-starter-toolkit" >> $GITHUB_STEP_SUMMARY
+            echo "pip install bedrock-agentcore-starter-toolkit" >> $GITHUB_STEP_SUMMARY
             echo '```' >> $GITHUB_STEP_SUMMARY
           else
             echo "❌ **Release Failed**" >> $GITHUB_STEP_SUMMARY

{bedrock_agentcore_starter_toolkit-0.1.12 → bedrock_agentcore_starter_toolkit-0.1.14}/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [0.1.14] - 2025-09-25
+
+### Changes
+
+- Fix: Runtime configure function now sets CodeBuild execution role from --code_build_execution_role parameter (#184) (7d7dffd)
+- docs: Generate llm.txt via mkdocs-llmstxt (#213) (6459979)
+- fix: llm.txt typo (#210) (f48ae5e)
+- docs: Add llm.txt and file on runtime deployment (#202) (90dac4b)
+- fix: correct pyproject.toml installation in subdirectories (#207) (ea01c65)
+- chore: bump version to 0.1.13 (#205) (86269a9)
+
+## [0.1.13] - 2025-09-24
+
+### Changes
+
+- Fix linter errors and ran formatter (#203) (64656b6)
+- fix: add S3 bucket ownership verification (#194) (225dd86)
+- quick start doc updates (#199) (3e9b930)
+- Add ability to invoke runtime with custom headers (#200) (ba337db)
+- revert dockerfile optimization (#198) (3285377)
+- Added request header allowlist configuration support (#197) (7a7c65f)
+- feat: change create_or_get_memory to get_or_create_memory to do the lookup before the create (#195) (ef22d20)
+- Remove TestPyPI publishing step from release workflow (#186) (887e23b)
+- feat: Initial commit for Memory manager (#169) (e067386)
+
 ## [0.1.12] - 2025-09-18
 
 ### Changes

{bedrock_agentcore_starter_toolkit-0.1.12 → bedrock_agentcore_starter_toolkit-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bedrock-agentcore-starter-toolkit
-Version: 0.1.12
+Version: 0.1.14
 Summary: A starter toolkit for using Bedrock AgentCore
 Project-URL: Homepage, https://github.com/aws/bedrock-agentcore-starter-toolkit
 Project-URL: Bug Tracker, https://github.com/aws/bedrock-agentcore-starter-toolkit/issues
@@ -23,8 +23,8 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Requires-Dist: autopep8>=2.3.2
 Requires-Dist: bedrock-agentcore>=0.1.4
-Requires-Dist: boto3>=1.39.7
-Requires-Dist: botocore>=1.39.7
+Requires-Dist: boto3>=1.40.35
+Requires-Dist: botocore>=1.40.35
 Requires-Dist: docstring-parser<1.0,>=0.15
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: jinja2>=3.1.6
@@ -38,7 +38,6 @@ Requires-Dist: questionary>=2.1.0
 Requires-Dist: requests>=2.25.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: ruamel-yaml>=0.18.14
-Requires-Dist: strands-agents>=1.7.1
 Requires-Dist: toml>=0.10.2
 Requires-Dist: typer>=0.16.0
 Requires-Dist: typing-extensions<5.0.0,>=4.13.2

{bedrock_agentcore_starter_toolkit-0.1.12 → bedrock_agentcore_starter_toolkit-0.1.14}/documentation/docs/examples/memory_gateway_agent.md

@@ -65,11 +65,11 @@ class MemoryHook(HookProvider):
     - Loads previous conversation when agent starts
     - Saves each message after it's processed
     """
-    
+
     def on_agent_initialized(self, event):
         """Runs when agent starts - loads conversation history"""
         if not MEMORY_ID: return
-        
+
         # Get last 3 conversation turns from memory
         turns = memory_client.get_last_k_turns(
             memory_id=MEMORY_ID,
@@ -77,17 +77,17 @@ class MemoryHook(HookProvider):
             session_id=event.agent.state.get("session_id", "default"),
             k=3  # Number of previous exchanges to remember
         )
-        
+
         # Add conversation history to agent's context
         if turns:
-            context = "\n".join([f"{m['role']}: {m['content']['text']}" 
+            context = "\n".join([f"{m['role']}: {m['content']['text']}"
                                for t in turns for m in t])
             event.agent.system_prompt += f"\n\nPrevious:\n{context}"
-    
+
     def on_message_added(self, event):
         """Runs after each message - saves it to memory"""
         if not MEMORY_ID: return
-        
+
         # Save the latest message to memory
         msg = event.agent.messages[-1]
         memory_client.create_event(
@@ -96,7 +96,7 @@ class MemoryHook(HookProvider):
             session_id=event.agent.state.get("session_id", "default"),
             messages=[(str(msg["content"]), msg["role"])]
         )
-    
+
     def register_hooks(self, registry):
         """Registers both hooks with the agent"""
         registry.add_callback(AgentInitializedEvent, self.on_agent_initialized)
@@ -120,7 +120,7 @@ def invoke(payload, context):
     # Use the session ID from runtime (for session isolation)
     if hasattr(context, 'session_id'):
         agent.state.set("session_id", context.session_id)
-    
+
     # Process the user's message and return response
     response = agent(payload.get("prompt", "Hello"))
     return response.message['content'][0]['text']
@@ -182,12 +182,12 @@ ltm = client.create_memory_and_wait(
     strategies=[
         # Extracts user preferences like "I prefer Python"
         {"userPreferenceMemoryStrategy": {
-            "name": "prefs", 
+            "name": "prefs",
             "namespaces": ["/user/preferences"]
         }},
         # Extracts facts like "My birthday is in January"
         {"semanticMemoryStrategy": {
-            "name": "facts", 
+            "name": "facts",
             "namespaces": ["/user/facts"]
         }}
     ],
@@ -363,25 +363,25 @@ except:
 
 class MemoryHook(HookProvider):
     """Handles memory operations - same as before"""
-    
+
     def on_agent_initialized(self, event):
         if not MEMORY_ID: return
-        
+
         turns = memory_client.get_last_k_turns(
             memory_id=MEMORY_ID,
             actor_id="user",
             session_id=event.agent.state.get("session_id", "default"),
             k=3
         )
-        
+
         if turns:
-            context = "\n".join([f"{m['role']}: {m['content']['text']}" 
+            context = "\n".join([f"{m['role']}: {m['content']['text']}"
                                for t in turns for m in t])
             event.agent.system_prompt += f"\n\nPrevious:\n{context}"
-    
+
     def on_message_added(self, event):
         if not MEMORY_ID: return
-        
+
         msg = event.agent.messages[-1]
         memory_client.create_event(
             memory_id=MEMORY_ID,
@@ -389,7 +389,7 @@ class MemoryHook(HookProvider):
             session_id=event.agent.state.get("session_id", "default"),
             messages=[(str(msg["content"]), msg["role"])]
         )
-    
+
     def register_hooks(self, registry):
         registry.add_callback(AgentInitializedEvent, self.on_agent_initialized)
         registry.add_callback(MessageAddedEvent, self.on_message_added)
@@ -399,13 +399,13 @@ async def get_gateway_tools():
     """Get tools from gateway using MCP"""
     if not gateway_config:
         return None
-    
+
     try:
         gateway_url = gateway_config["gateway_url"]
         access_token = gateway_config["access_token"]
-        
+
         headers = {"Authorization": f"Bearer {access_token}"}
-        
+
         async with streamablehttp_client(gateway_url, headers=headers) as (read, write, _):
             async with ClientSession(read, write) as session:
                 await session.initialize()
@@ -431,7 +431,7 @@ def invoke(payload, context):
     # Use the session ID from runtime
     if hasattr(context, 'session_id'):
         agent.state.set("session_id", context.session_id)
-    
+
     # Try to get gateway tools
     gateway_tools = None
     if gateway_config:
@@ -442,7 +442,7 @@ def invoke(payload, context):
                 agent.tools = gateway_tools
         except Exception as e:
             print(f"Error getting gateway tools: {e}")
-    
+
     # Process the user's message
     response = agent(payload.get("prompt", "Hello"))
     return response.message['content'][0]['text']

bedrock_agentcore_starter_toolkit-0.1.14/documentation/docs/mcp/agentcore_runtime_deployment.md

@@ -0,0 +1,48 @@
+### Build your first agent or transform existing code
+
+#### Prerequisites & Environment Setup
+- **Environment**: Set up Python 3.10+ and virtual environment - [Environment Setup](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/quickstart.html#step-0-setup-folder-and-virtual-environment)
+
+#### Step 1: Install Dependencies & Create Agent Code
+- **New Agents**: Install AgentCore packages and create your agent using hello world strands agents  [Installation & Creation Guide](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/quickstart.html#step-1-install-and-create-your-agent)
+- **Existing Agents**: Transform your current agent code to work with AgentCore - [Framework Integration Examples](https://aws.github.io/bedrock-agentcore-starter-toolkit/examples/index.html)
+
+#### Step 1.1: For strands refer to following documentation 
+- [Welcome](https://strandsagents.com/latest/documentation/docs/index.md)
+- [Amazon Bedrock](https://strandsagents.com/latest/documentation/docs/user-guide/concepts/model-providers/amazon-bedrock/index.md)
+- [Amazon Bedrock AgentCore](https://strandsagents.com/latest/documentation/docs/user-guide/deploy/deploy_to_bedrock_agentcore/index.md)
+1. Import strands agent - `from strands import Agent`
+2. Create an agent with default settings - agent = Agent()
+3. Ask the agent a question - agent("Tell me about agentic AI")
+
+#### Step 1.2 - Transforming agent code for agentcore 
+- **Agent code**: Always use these [code patterns](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/overview.html#agent-development-patterns) for agent code.
+- **AgentCore Wrapper**: Use  [bedrock-agentcore](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/overview.html#what-is-the-agentcore-runtime-sdk) wrappers to implement runtime service contract.
+1. Import the Runtime App with from bedrock_agentcore.runtime import BedrockAgentCoreApp
+2. Initialize the App in your code with app = BedrockAgentCoreApp()
+3. Decorate the invocation function with the @app.entrypoint decorator
+4. Create a requirements.txt file with needed packages. Note: if strands-tools is detected, the correct library to add is strands-agents-tools
+5. Let AgentCore Runtime control the running of the agent with app.run() 
+
+#### Step 2: Local Development & Testing (Optional)
+- **Local Testing**: Run and test your agent locally before deployment - [Local Testing Guide](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/quickstart.html#step-2-test-locally)
+1. Start the agent using python <my_agent.py>
+2. # Test it (in another terminal)
+    curl -X POST http://localhost:8080/invocations \
+    -H "Content-Type: application/json" \
+    -d '{"prompt": "Hello!"}'
+3. Stop the agent.
+
+#### Step 3: Deploy to AgentCore using CLI
+Refer to https://aws.github.io/bedrock-agentcore-starter-toolkit/api-reference/cli.html
+1. Install cli with 'pip install bedrock-agentcore-starter-toolkit'
+2. **Configuration**: Use AgentCore CLI to configure your agent for deployment.
+    ```agentcore configure --entrypoint converted_agentcore_file.py --non-interactive```
+3. **Deployment**: Launch your agent to AWS with automatic resource creation.
+    ```agentcore launch```
+4. **Invocation**: agentcore invoke '{"prompt": "Hello"}' Test your deployed agent using the CLI or API calls
+
+#### Step 4: Troubleshooting & Enhancement
+- **Common Issues**: Resolve deployment and runtime issues - [Troubleshooting Guide](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/quickstart.html#troubleshooting)
+- **Advanced Features**: Add memory, authentication, and gateway integrations - [Next Steps](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/quickstart.html#next-steps)
+- **Monitoring**: Set up observability and monitoring for production agents

{bedrock_agentcore_starter_toolkit-0.1.12 → bedrock_agentcore_starter_toolkit-0.1.14}/documentation/docs/user-guide/gateway/quickstart.md

@@ -448,87 +448,12 @@ Run: `python cleanup_gateway.py`
 
 ### Next Steps
 
-- **Add Your Own APIs**: Extend your Gateway with OpenAPI specifications for real services
 - **Custom Lambda Tools**: Create Lambda functions with your business logic
+- **Add Your Own APIs**: Extend your Gateway with OpenAPI specifications for real services
 - **Production Setup**: Configure VPC endpoints, custom domains, and monitoring
 
-## Adding Your Own APIs
-
-### NASA API Integration
-
-Integrate real APIs like NASA’s Astronomy Picture of the Day. Get your API key from https://api.nasa.gov/ (instant via email), then create `add_nasa_api.py`:
-
- This example shows how to add external REST APIs to your Gateway, making them available as tools for your agent.
-
-
-```python
-from bedrock_agentcore_starter_toolkit.operations.gateway.client import GatewayClient
-import json
-
-with open("gateway_config.json", "r") as f:
-    config = json.load(f)
-
-client = GatewayClient(region_name=config["region"])
-
-nasa_spec = {
-    "openapi": "3.0.0",
-    "info": {"title": "NASA API", "version": "1.0.0"},
-    "servers": [{"url": "https://api.nasa.gov"}],
-    "paths": {
-        "/planetary/apod": {
-            "get": {
-                "operationId": "getAstronomyPictureOfDay",
-                "summary": "Get NASA's Astronomy Picture of the Day",
-                "parameters": [
-                    {
-                        "name": "date",
-                        "in": "query",
-                        "required": False,
-                        "schema": {"type": "string"},
-                        "description": "Date in YYYY-MM-DD format"
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "Success",
-                        "content": {
-                            "application/json": {
-                                "schema": {
-                                    "type": "object",
-                                    "properties": {
-                                        "title": {"type": "string"},
-                                        "explanation": {"type": "string"},
-                                        "url": {"type": "string"}
-                                    }
-                                }
-                            }
-                        }
-                    }
-                }
-            }
-        }
-    }
-}
-
-gateway = client.client.get_gateway(gatewayIdentifier=config["gateway_id"])
-
-nasa_target = client.create_mcp_gateway_target(
-    gateway=gateway,
-    name="NasaApi",
-    target_type="openApiSchema",
-    target_payload={"inlinePayload": json.dumps(nasa_spec)},
-    credentials={
-        "api_key": "YOUR_NASA_API_KEY",  # Replace with your key
-        "credential_location": "QUERY_PARAMETER",
-        "credential_parameter_name": "api_key"
-    }
-)
-
-print(f"✓ NASA API added! Try: 'Get NASA's astronomy picture for 2024-12-25'")
-print("Run 'python run_agent.py' and try: 'Get NASA's astronomy picture for 2024-12-25'")
-```
 
-### Custom Lambda Tools
+## Custom Lambda Tools
 
 Create your own Lambda functions with custom business logic and add them as Gateway targets. Lambda targets allow you to implement any custom tool logic in Python, Node.js, or other supported runtimes.
 
@@ -696,6 +621,83 @@ Run: `python create_custom_lambda.py` then `python run_agent.py` to test.
 
 If you're excited and want to learn more about Gateways and the other Target types. Continue through this guide.
 
+## Adding Your Own APIs
+
+### NASA API Integration
+
+Integrate real APIs like NASA’s Astronomy Picture of the Day. Get your API key from https://api.nasa.gov/ (instant via email), then create `add_nasa_api.py`:
+
+ This example shows how to add external REST APIs to your Gateway, making them available as tools for your agent.
+
+
+```python
+from bedrock_agentcore_starter_toolkit.operations.gateway.client import GatewayClient
+import json
+
+with open("gateway_config.json", "r") as f:
+    config = json.load(f)
+
+client = GatewayClient(region_name=config["region"])
+
+nasa_spec = {
+    "openapi": "3.0.0",
+    "info": {"title": "NASA API", "version": "1.0.0"},
+    "servers": [{"url": "https://api.nasa.gov"}],
+    "paths": {
+        "/planetary/apod": {
+            "get": {
+                "operationId": "getAstronomyPictureOfDay",
+                "summary": "Get NASA's Astronomy Picture of the Day",
+                "parameters": [
+                    {
+                        "name": "date",
+                        "in": "query",
+                        "required": False,
+                        "schema": {"type": "string"},
+                        "description": "Date in YYYY-MM-DD format"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Success",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "object",
+                                    "properties": {
+                                        "title": {"type": "string"},
+                                        "explanation": {"type": "string"},
+                                        "url": {"type": "string"}
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
+
+gateway = client.client.get_gateway(gatewayIdentifier=config["gateway_id"])
+
+nasa_target = client.create_mcp_gateway_target(
+    gateway=gateway,
+    name="NasaApi",
+    target_type="openApiSchema",
+    target_payload={"inlinePayload": json.dumps(nasa_spec)},
+    credentials={
+        "api_key": "YOUR_NASA_API_KEY",  # Replace with your key
+        "credential_location": "QUERY_PARAMETER",
+        "credential_parameter_name": "api_key"
+    }
+)
+
+print(f"✓ NASA API added! Try: 'Get NASA's astronomy picture for 2024-12-25'")
+print("Run 'python run_agent.py' and try: 'Get NASA's astronomy picture for 2024-12-25'")
+```
+
+
 ### Adding OpenAPI Targets
 
 Let's add an OpenAPI target. This code uses the OpenAPI schema for a NASA API that provides Mars weather information. You can get an API key sent to your email in a minute by filling out the form here: https://api.nasa.gov/.

{bedrock_agentcore_starter_toolkit-0.1.12 → bedrock_agentcore_starter_toolkit-0.1.14}/documentation/docs/user-guide/runtime/overview.md

@@ -19,7 +19,7 @@ if __name__ == "__main__":
 
 ```bash
 # Configure and deploy your agent
-agentcore configure --entrypoint my_agent.py
+agentcore configure --entrypoint my_agent.py --non-interactive
 agentcore launch
 agentcore invoke '{"name": "Alice"}'
 ```