bedrock-agentcore-starter-toolkit 0.1.10__tar.gz → 0.1.11__tar.gz

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/.github/workflows/ci.yml

@@ -14,7 +14,7 @@ jobs:
     name: Lint
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
 
     - name: Set up Python
       uses: actions/setup-python@v5
@@ -40,7 +40,7 @@ jobs:
         python-version: ['3.10', '3.11', '3.12', '3.13']
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
 
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v5
@@ -77,7 +77,7 @@ jobs:
     needs: [lint]  # Don't require tests to pass for now
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
 
     - name: Set up Python
       uses: actions/setup-python@v5

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/.github/workflows/deploy-docs.yml

@@ -18,12 +18,12 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0  # Fetch all history for proper versioning
 
       - name: Checkout SDK repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           repository: aws/bedrock-agentcore-sdk-python
           path: bedrock-agentcore-sdk-python

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/.github/workflows/integration_testing.yml

@@ -59,13 +59,13 @@ jobs:
       contents: read
     steps:
       - name: Configure Credentials
-        uses: aws-actions/configure-aws-credentials@v4
+        uses: aws-actions/configure-aws-credentials@v5
         with:
          role-to-assume: ${{ secrets.AGENTCORE_INTEG_TEST_ROLE }}
          aws-region: us-west-2
          mask-aws-account-id: true
       - name: Checkout head commit
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           ref: ${{ github.event.pull_request.head.sha }} # Pull the commit from the forked repo
           persist-credentials: false  # Don't persist credentials for subsequent actions

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/.github/workflows/release.yml

@@ -41,7 +41,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
@@ -206,7 +206,7 @@ jobs:
         python-version: ['3.10', '3.11', '3.12', '3.13']
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           ref: release/v${{ needs.prepare-release.outputs.version }}
 
@@ -241,7 +241,7 @@ jobs:
     if: needs.prepare-release.result == 'success'
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           ref: release/v${{ needs.prepare-release.outputs.version }}
 
@@ -305,7 +305,7 @@ jobs:
 
     steps:
       - name: Download artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           name: dist
           path: dist/
@@ -370,12 +370,12 @@ jobs:
       url: https://pypi.org/project/bedrock-agentcore-starter-toolkit/
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
 
       - name: Download artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           name: dist
           path: dist/

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/.github/workflows/security-scanning.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
 
     - name: Set up Python
       uses: actions/setup-python@v5
@@ -53,7 +53,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
 
     - name: Set up Python
       uses: actions/setup-python@v5
@@ -93,12 +93,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
 
       - name: TruffleHog OSS
-        uses: trufflesecurity/trufflehog@v3.90.5
+        uses: trufflesecurity/trufflehog@v3.90.6
         with:
           path: ./
           base: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.sha || github.event.before }}

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/.github/workflows/security.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
 
     - name: Set up Python
       uses: actions/setup-python@v5
@@ -46,7 +46,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
 
     - name: Set up Python
       uses: actions/setup-python@v5
@@ -95,12 +95,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
 
       - name: TruffleHog OSS
-        uses: trufflesecurity/trufflehog@v3.90.5
+        uses: trufflesecurity/trufflehog@v3.90.6
         with:
           path: ./
           base: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.sha || github.event.before }}

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/.github/workflows/test-pypi-release.yml

@@ -22,7 +22,7 @@ jobs:
       url: https://test.pypi.org/p/bedrock-agentcore-starter-toolkit
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
 
     - name: Set up Python
       uses: actions/setup-python@v5

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.1.11] - 2025-09-17
+
+### Changes
+
+- feat(observability): Add automatic Transaction Search configuration (#175) (fe7f29a)
+- ci(deps): bump trufflesecurity/trufflehog from 3.90.5 to 3.90.6 (#172) (afe2458)
+- adding - enable transaction search (#170) (2eaad64)
+- fix source (#168) (15d6b05)
+- small error fixes in stuff i added to quick start (#165) (2b7756b)
+- Fix: typo var name and use "-" not "_" in target (#142) (948c0d2)
+- Optimize Dockerfile template for faster builds (#166) (4d1a118)
+- Remove reference to IAM users, remove erroneous AWS CLI commands (#164) (d055a18)
+- Fix pre-commit linting issues (#161) (205678e)
+- Add pre-req steps so customers can easily follow along (#159) (67eb571)
+- ci(deps): bump actions/checkout from 4 to 5 (#121) (7282d82)
+- ci(deps): bump actions/download-artifact from 4 to 5 (#122) (141c8b7)
+- chore(deps): update mkdocstrings-python requirement (#147) (0922960)
+- ci(deps): bump aws-actions/configure-aws-credentials from 4 to 5 (#155) (4d931c7)
+- Using valid address for client http requests connection (#78) (2332309)
+- chore: bump version to 0.1.10 (#157) (569b6ac)
+
+### Dependencies
+- Updated to bedrock-agentcore SDK v0.1.4
+
 ## [0.1.10] - 2025-09-08
 
 ### Changes

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bedrock-agentcore-starter-toolkit
-Version: 0.1.10
+Version: 0.1.11
 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
@@ -22,7 +22,7 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Requires-Dist: autopep8>=2.3.2
-Requires-Dist: bedrock-agentcore>=0.1.3
+Requires-Dist: bedrock-agentcore>=0.1.4
 Requires-Dist: boto3>=1.39.7
 Requires-Dist: botocore>=1.39.7
 Requires-Dist: docstring-parser<1.0,>=0.15

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/documentation/docs/user-guide/gateway/quickstart.md

@@ -15,6 +15,19 @@ In the quick start guide you will learn how to set up a Gateway and integrate it
 - **Python 3.10+** installed.
 - **Access to** Anthropic's Sonnet 3.7 (or another model) for running the demo agent below.
 
+
+## Step 0: Setup folder and virtual environment
+
+Create a new folder for this quickstart, create and initialize a new python virtual environment
+
+```bash
+mkdir agentcore-gateway-quickstart
+cd agentcore-gateway-quickstart
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+
 ## Step 1: Install and Create Your Agent
 
 ```bash

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/documentation/docs/user-guide/identity/quickstart.md

@@ -8,12 +8,18 @@ Before you begin, ensure you have:
 
 - An AWS account with appropriate permissions
 - Python 3.10+ installed
-- AWS CLI configured with your credentials
+- AWS credentials and region configured (`aws configure`)
 - (Optional) External service accounts for OAuth2 or API key integration
 
 ## Install the SDK
 
+Make a folder for this quickstart, create a virtual environment, and install the agentcore sdk.
+
 ```bash
+mkdir agentcore-identity-quickstart
+cd agentcore-identity-quickstart
+python3 -m venv .venv
+source .venv/bin/activate
 pip install bedrock-agentcore
 ```
 
@@ -36,13 +42,6 @@ print(f"Workload Identity ARN: {workload_identity['workloadIdentityArn']}")
 print(f"Agent Name: {workload_identity['name']}")
 ```
 
-You can also use the AWS CLI:
-
-```bash
-aws bedrock-agentcore create-workload-identity \
-    --name "my-research-agent"
-```
-
 ## Configure Credential Providers
 
 Credential providers define how your agent accesses external services:
@@ -73,22 +72,6 @@ perplexity_provider = identity_client.create_api_key_credential_provider(req={
 })
 ```
 
-## Configure Environment Variables
-
-Set up environment variables for your development environment:
-
-```bash
-# AWS Configuration
-export AWS_REGION=us-west-2
-export AWS_ACCESS_KEY_ID=your-access-key-id
-export AWS_SECRET_ACCESS_KEY=your-secret-access-key
-
-# Agent Configuration
-export AGENT_IDENTITY_ID=your-agent-identity-id
-export AGENT_IDENTITY_ARN=your-agent-identity-arn
-export WORKLOAD_ACCESS_TOKEN=your-workload-access-token
-```
-
 ## Building a Simple Research Agent
 
 Let's create a simple research agent that demonstrates AgentCore Identity capabilities:

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/documentation/docs/user-guide/memory/quickstart.md

@@ -4,9 +4,13 @@ Amazon Bedrock AgentCore Memory lets you create and manage memory resources that
 
 ## Install Dependencies
 
-To get started with Amazon Bedrock AgentCore Memory, install the required Python package:
+To get started with Amazon Bedrock AgentCore Memory, make a folder for this quick start, create a virtual environment, and install the dependencies.
 
 ```bash
+mkdir agentcore-memory-quickstart
+cd agentcore-memory-quickstart
+python3 -m venv .venv
+source .venv/bin/activate
 pip install bedrock-agentcore
 ```
 

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/documentation/docs/user-guide/observability/quickstart.md

@@ -19,21 +19,74 @@ Before starting, make sure you have:
 
 - **AWS Account** with credentials configured (`aws configure`) with model access enabled to the Foundation Model you would like to use.
 - **Python 3.10+** installed
-- **Enable transaction search** on Amazon CloudWatch. First-time users must enable [CloudWatch Transaction Search](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Enable-TransactionSearch.html) to view Bedrock AgentCore spans and traces.
+- **Enable transaction search** on Amazon CloudWatch. Only once, first-time users must enable [CloudWatch Transaction Search](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Enable-TransactionSearch.html) to view Bedrock AgentCore spans and traces
 - **Add the OpenTelemetry library** Include `aws-opentelemetry-distro` (ADOT) in your requirements.txt file.
 - Ensure that your framework is configured to emit traces (eg. `strands-agents[otel]` package), you may sometimes need to include `<your-agent-framework-auto-instrumentor>` # e.g., `opentelemetry-instrumentation-langchain`
 
-
 AgentCore Observability offers two ways to configure monitoring to match different infrastructure needs:
 1. AgentCore Runtime-hosted agents
 2. Non-runtime hosted agents
 
-## Enabling Observability for AgentCore-Hosted Agents
+As a **one time** setup per account, first time users would need to enable Transaction Search on Amazon CloudWatch. There are two ways to do this, via the API and via the CloudWatch Console.
+
+## Enabling Transaction Search on CloudWatch
+
+After you enable Transaction Search, it can take ten minutes for spans to become available for search and analysis. Please choose one of the options below:
+
+### Option 1 : Enabling Transaction Search using an API
+
+**Step 1: Create a policy that grants access to ingest spans in CloudWatch Logs using AWS CLI**
+
+An example is shown below on how to format your AWS CLI command with PutResourcePolicy.
+
+```bash
+aws logs put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayAccess", "Effect": "Allow", "Principal": { "Service": "xray.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": [ "arn:partition:logs:region:account-id:log-group:aws/spans:*", "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*" ], "Condition": { "ArnLike": { "aws:SourceArn": "arn:partition:xray:region:account-id:*" }, "StringEquals": { "aws:SourceAccount": "account-id" } } } ]}'
+```
+
+**Step 2: Configure the destination of trace segments**
+
+An example is shown below on how to format your AWS CLI command with UpdateTraceSegmentDestination.
+
+```bash
+aws xray update-trace-segment-destination --destination CloudWatchLogs
+```
+
+**Optional** Step : Configure the amount of spans to index
+
+Configure your desired sampling percentage with UpdateIndexingRule.
+
+```bash
+aws xray update-indexing-rule --name "Default" --rule '{"Probabilistic": {"DesiredSamplingPercentage": number}}'
+```
+
+### Option 2: Enabling Transaction Search in the CloudWatch console
+
+- Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.
+- From the navigation pane, under Application Signals, choose Transaction Search.
+- Choose Enable Transaction Search.
+- Select the box to ingest spans as structured logs, and enter a percentage of spans to be indexed. You can index spans at 1% for free and change the percentage later based on your requirements.
+
+Let's now proceed to exploring the two ways to configure observability.
+
+## Enabling Observability for AgentCore Runtime hosted Agents
 
 AgentCore Runtime-hosted agents are deployed and executed directly within the AgentCore environment, providing automatic instrumentation with minimal configuration. This approach offers the fastest path to deployment and is ideal for rapid development and testing.
 
 For a complete example please refer to this [notebook](https://github.com/awslabs/amazon-bedrock-agentcore-samples/blob/main/01-tutorials/06-AgentCore-observability/01-Agentcore-runtime-hosted/runtime_with_strands_and_bedrock_models.ipynb)
 
+
+## Step 0: Setup folder and virtual environment
+
+Create a new folder for this quickstart, create and initialize a new python virtual environment
+
+```bash
+mkdir agentcore-observability-quickstart
+cd agentcore-observability-quickstart
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+
 ### Step 1 : Create your Agent, shown below is an example with Strands Agents SDK:
 
 To enable OTEL exporting, please note to install [Strands Agents](https://strandsagents.com/latest/) with otel extra dependencies:

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/documentation/docs/user-guide/runtime/quickstart.md

@@ -15,6 +15,18 @@ Before starting, make sure you have:
 - **Model Access**: Anthropic Claude 4.0 enabled in [Amazon Bedrock console](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access-modify.html)
 
 
+## Step 0: Setup folder and virtual environment
+
+Create a new folder for this quickstart, create and initialize a new python virtual environment
+
+```bash
+mkdir agentcore-runtime-quickstart
+cd agentcore-runtime-quickstart
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+
 ## Step 1: Install and Create Your Agent
 
 ```bash

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "bedrock-agentcore-starter-toolkit"
-version = "0.1.10"
+version = "0.1.11"
 description = "A starter toolkit for using Bedrock AgentCore"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -28,7 +28,7 @@ classifiers = [
 dependencies = [
     "boto3>=1.39.7",
     "botocore>=1.39.7",
-    "bedrock-agentcore>=0.1.3",
+    "bedrock-agentcore>=0.1.4",
     "docstring_parser>=0.15,<1.0",
     "httpx>=0.28.1",
     "jinja2>=3.1.6",
@@ -166,5 +166,5 @@ dev = [
     "mkdocs~=1.6.1",
     "mkdocs-macros-plugin~=1.3.7",
     "mkdocs-material~=9.6.12",
-    "mkdocstrings-python>=1.16.10,<1.18.0",
+    "mkdocstrings-python>=1.16.10,<1.19.0",
 ]

{bedrock_agentcore_starter_toolkit-0.1.10 → bedrock_agentcore_starter_toolkit-0.1.11}/src/bedrock_agentcore_starter_toolkit/cli/cli.py

@@ -5,7 +5,7 @@ import typer
 from ..cli.gateway.commands import create_mcp_gateway, create_mcp_gateway_target, gateway_app
 from ..utils.logging_config import setup_toolkit_logging
 from .import_agent.commands import import_agent
-from .runtime.commands import configure_app, invoke, launch, status, destroy
+from .runtime.commands import configure_app, destroy, invoke, launch, status
 
 app = typer.Typer(name="agentcore", help="BedrockAgentCore CLI", add_completion=False, rich_markup_mode="rich")