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

{bedrock_agentcore_starter_toolkit-0.1.12 → bedrock_agentcore_starter_toolkit-0.1.13}/.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.13}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [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.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bedrock-agentcore-starter-toolkit
-Version: 0.1.12
+Version: 0.1.13
 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.13}/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.12 → bedrock_agentcore_starter_toolkit-0.1.13}/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/.