bedrock-agentcore-starter-toolkit 0.1.2__tar.gz → 0.1.4__tar.gz

{bedrock_agentcore_starter_toolkit-0.1.2 → bedrock_agentcore_starter_toolkit-0.1.4}/.github/workflows/ci.yml

@@ -66,9 +66,10 @@ jobs:
         python -c "from bedrock_agentcore_starter_toolkit import Runtime; print('✓ Runtime import successful')"
 
     - name: Run unit tests
+      env:
+        TERM: dumb # disable ANSI escape sequences
       run: |
-        # Run unit tests
-        pytest tests/ || echo "::warning::Some tests failed due to missing dependencies"
+        pytest tests/ --cov=src --cov-report=xml --cov-report=html --cov-precision=2
 
   build:
     name: Build Package

bedrock_agentcore_starter_toolkit-0.1.4/.github/workflows/integration_testing.yml

@@ -0,0 +1,86 @@
+name: Secure Integration test
+
+on:
+  push:
+    branches: [ main ]
+    tags:
+      - 'v*'
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  authorization-check:
+    permissions: read-all
+    runs-on: ubuntu-latest
+    outputs:
+      approval-env: ${{ steps.collab-check.outputs.result }}
+    steps:
+      - name: Collaborator Check
+        uses: actions/github-script@v7
+        id: collab-check
+        with:
+          result-encoding: string
+          script: |
+            try {
+              let username;
+              if (context.payload.pull_request) {
+                username = context.payload.pull_request.user.login;
+              } else {
+                // For non-PRs (eg. merge), check the actor (person who merged)
+                username = context.actor;
+                console.log(`No pull request context found, checking permissions for actor: ${username}`);
+              }
+
+              const permissionResponse = await github.rest.repos.getCollaboratorPermissionLevel({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                username: username,
+              });
+              const permission = permissionResponse.data.permission;
+              const hasWriteAccess = ['write', 'admin'].includes(permission);
+              if (!hasWriteAccess) {
+                console.log(`User ${username} does not have write access to the repository (permission: ${permission})`);
+                return "manual-approval"
+              } else {
+                console.log(`Verifed ${username} has write access. Auto Approving PR Checks.`)
+                return "auto-approve"
+              }
+            } catch (error) {
+              console.log(`${username} does not have write access. Requiring Manual Approval to run PR Checks.`)
+              return "manual-approval"
+            }
+  check-access-and-checkout:
+    runs-on: ubuntu-latest
+    needs: authorization-check
+    environment: ${{ needs.authorization-check.outputs.approval-env }}
+    permissions:
+      id-token: write
+      pull-requests: read
+      contents: read
+    steps:
+      - name: Configure Credentials
+        uses: aws-actions/configure-aws-credentials@v4
+        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
+        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
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+      - name: Install dependencies
+        run: |
+          pip install -e .
+          pip install --no-cache-dir pytest click
+      - name: Run integration tests
+        env:
+          AWS_REGION: us-west-2
+          AGENTCORE_TEST_ROLE: AgentExecutionRole
+        id: tests
+        run: |
+          pytest tests_integ/cli -s --log-cli-level=INFO

bedrock_agentcore_starter_toolkit-0.1.4/.github/workflows/pr-automerge.yml

@@ -0,0 +1,66 @@
+name: PR Auto-merge
+
+on:
+  pull_request_review:
+    types: [submitted]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  auto-merge:
+    name: Auto-merge Release PRs
+    runs-on: ubuntu-latest
+    # Only run when PR is approved and it's a release PR
+    if: |
+      github.event.review.state == 'approved' &&
+      github.event.pull_request.user.login == 'github-actions[bot]' &&
+      startsWith(github.event.pull_request.head.ref, 'release/') &&
+      github.event.pull_request.base.ref == 'main'
+
+    steps:
+      - name: Check CI status
+        id: ci-status
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { data: checkRuns } = await github.rest.checks.listForRef({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              ref: context.payload.pull_request.head.sha
+            });
+
+            // Include ALL required checks
+            const requiredChecks = [
+              'Lint',
+              'Test Python 3.10',
+              'Test Python 3.11',
+              'Test Python 3.12',
+              'Test Python 3.13',
+              'Build Package'
+            ];
+
+            const allPassed = requiredChecks.every(checkName => {
+              const check = checkRuns.check_runs.find(run => run.name === checkName);
+              return check && check.conclusion === 'success';
+            });
+
+            console.log(`All required checks passed: ${allPassed}`);
+            return allPassed;
+
+      - name: Auto-merge PR
+        if: steps.ci-status.outputs.result == 'true'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.pulls.merge({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.payload.pull_request.number,
+              merge_method: 'squash',
+              commit_title: `Release v${context.payload.pull_request.head.ref.split('/')[1]}`,
+              commit_message: 'Auto-merged by release workflow'
+            });
+
+            console.log('✓ PR auto-merged successfully');

bedrock_agentcore_starter_toolkit-0.1.4/.github/workflows/release.yml

@@ -0,0 +1,443 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump_type:
+        description: 'Version bump type'
+        required: true
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+          - pre
+      sdk_version:
+        description: 'SDK version to depend on (optional)'
+        required: false
+        type: string
+      wait_for_sdk:
+        description: 'Wait for SDK version on PyPI'
+        required: false
+        type: boolean
+        default: false
+      changelog:
+        description: 'Custom changelog entry (optional)'
+        required: false
+        type: string
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  prepare-release:
+    name: Prepare Release
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.bump.outputs.version }}
+      pr_created: ${{ steps.create-pr.outputs.pull-request-number }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Create virtual environment
+        run: uv venv
+
+      - name: Install dependencies
+        run: |
+          source .venv/bin/activate
+          uv pip install requests  # Needed for SDK version checking
+
+      - name: Configure git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Get current version
+        id: current
+        run: |
+          VERSION=$(grep -m1 -oP '^version = "\K[^"]+' pyproject.toml)
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "Current version: $VERSION"
+
+      - name: Bump version
+        id: bump
+        run: |
+          source .venv/bin/activate
+
+          # Make script executable
+          chmod +x scripts/bump-version.py
+
+          # Build command with all options
+          CMD="python scripts/bump-version.py ${{ github.event.inputs.bump_type }}"
+
+          # Add SDK update if specified
+          if [ -n "${{ github.event.inputs.sdk_version }}" ]; then
+            CMD="$CMD --update-sdk ${{ github.event.inputs.sdk_version }}"
+            if [ "${{ github.event.inputs.wait_for_sdk }}" = "true" ]; then
+              CMD="$CMD --wait-for-sdk"
+            fi
+          fi
+
+          # Add changelog if specified
+          if [ -n "${{ github.event.inputs.changelog }}" ]; then
+            CMD="$CMD --changelog \"${{ github.event.inputs.changelog }}\""
+          fi
+
+          # Run version bump
+          echo "Running: $CMD"
+          eval $CMD
+
+          # Update lockfile after all changes
+          uv lock --no-progress
+
+          # Get new version
+          NEW_VERSION=$(grep -m1 -oP '^version = "\K[^"]+' pyproject.toml)
+          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "New version: $NEW_VERSION"
+
+      - name: Create release branch
+        run: |
+          BRANCH_NAME="release/v${{ steps.bump.outputs.version }}"
+
+          # Clean up any existing branch from previous attempts
+          if git ls-remote --exit-code --heads origin $BRANCH_NAME; then
+            echo "⚠️  Branch $BRANCH_NAME already exists. Deleting it first..."
+            git push origin --delete $BRANCH_NAME
+          fi
+
+          # Clean up local branch if exists
+          if git show-ref --verify --quiet refs/heads/$BRANCH_NAME; then
+            git branch -D $BRANCH_NAME
+          fi
+
+          # Create fresh branch
+          git checkout -b $BRANCH_NAME
+
+          # Add all changes
+          git add -A
+
+          # Commit with co-author
+          git commit -m "chore: bump version to ${{ steps.bump.outputs.version }}
+
+          Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
+
+          # Push the branch
+          git push origin $BRANCH_NAME
+
+          # Verify the version was committed
+          COMMITTED_VERSION=$(git show HEAD:pyproject.toml | grep -m1 -oP '^version = "\K[^"]+')
+          if [ "$COMMITTED_VERSION" != "${{ steps.bump.outputs.version }}" ]; then
+            echo "❌ ERROR: Version not committed correctly!"
+            exit 1
+          fi
+
+      - name: Create Pull Request
+        id: create-pr
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          BRANCH_NAME="release/v${{ steps.bump.outputs.version }}"
+
+          # Create PR using GitHub CLI
+          PR_URL=$(gh pr create \
+            --base main \
+            --head $BRANCH_NAME \
+            --title "Release v${{ steps.bump.outputs.version }}" \
+            --body "## 🚀 Release v${{ steps.bump.outputs.version }}
+
+          This PR was automatically created by the release workflow.
+
+          ### Changes
+          - Version bumped from ${{ steps.current.outputs.version }} to ${{ steps.bump.outputs.version }}
+          - Updated CHANGELOG.md
+          - Updated uv.lock
+          ${{ github.event.inputs.sdk_version && format('- Updated SDK dependency to >={0}', github.event.inputs.sdk_version) || '' }}
+
+          ### Pre-release Checklist
+          - [ ] Review CHANGELOG.md entries
+          - [ ] Verify version numbers are correct
+          - [ ] All tests passing
+          - [ ] Documentation updated (if needed)
+          ${{ github.event.inputs.sdk_version && '- [ ] Verify SDK version is available on PyPI' || '' }}
+
+          ### Release Process
+          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
+
+          ---
+          *Triggered by @${{ github.actor }}*")
+
+          # Extract PR number from URL
+          PR_NUMBER=$(echo "$PR_URL" | grep -oP '\d+$')
+          echo "pull-request-number=$PR_NUMBER" >> $GITHUB_OUTPUT
+
+  test:
+    name: Test
+    needs: prepare-release
+    runs-on: ubuntu-latest
+    if: needs.prepare-release.result == 'success'
+    outputs:
+      version: ${{ needs.prepare-release.outputs.version }}
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: release/v${{ needs.prepare-release.outputs.version }}
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Create virtual environment
+        run: uv venv
+
+      - name: Install dependencies
+        run: |
+          source .venv/bin/activate
+          uv sync --dev
+
+      - name: Run tests
+        run: |
+          source .venv/bin/activate
+          pytest tests/ --cov=src --cov-report=xml --cov-fail-under=80 \
+            -k "not test_launch_help_text_updated"
+
+  build:
+    name: Build Distribution
+    needs: prepare-release
+    runs-on: ubuntu-latest
+    if: needs.prepare-release.result == 'success'
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: release/v${{ needs.prepare-release.outputs.version }}
+
+      - name: Verify version before build
+        run: |
+          EXPECTED_VERSION="${{ needs.prepare-release.outputs.version }}"
+          ACTUAL_VERSION=$(grep -m1 -oP '^version = "\K[^"]+' pyproject.toml)
+
+          echo "Expected version: $EXPECTED_VERSION"
+          echo "Actual version: $ACTUAL_VERSION"
+
+          if [ "$ACTUAL_VERSION" != "$EXPECTED_VERSION" ]; then
+            echo "❌ ERROR: Version mismatch!"
+            echo "Expected $EXPECTED_VERSION but found $ACTUAL_VERSION"
+            exit 1
+          fi
+
+          echo "✓ Version verified: $ACTUAL_VERSION"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Build package
+        run: |
+          uv build
+
+          ls -la dist/
+          if ! ls dist/*-${{ needs.prepare-release.outputs.version }}-*.whl; then
+            echo "❌ ERROR: Built package has wrong version!"
+            exit 1
+          fi
+
+          # Check with twine using tool run
+          uv tool run twine check dist/*
+
+          # Show package contents
+          echo "=== Package contents ==="
+          python -m zipfile -l dist/*.whl | head -20
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          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@v4
+        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
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/bedrock-agentcore-starter-toolkit/
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Get version
+        id: version
+        run: |
+          VERSION=$(ls dist/*.whl | sed -n 's/.*-\([0-9.]*\)-.*/\1/p')
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+      - name: Create and push tag
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          git tag -a v${{ steps.version.outputs.version }} \
+            -m "Release v${{ steps.version.outputs.version }}"
+          git push origin v${{ steps.version.outputs.version }}
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ steps.version.outputs.version }}
+          name: Bedrock AgentCore Starter Toolkit v${{ steps.version.outputs.version }}
+          files: dist/*
+          generate_release_notes: true
+          body: |
+            ## Installation
+            ```bash
+            pip install bedrock-agentcore-starter-toolkit==${{ steps.version.outputs.version }}
+            ```
+
+            ## What's Changed
+            See [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/v${{ steps.version.outputs.version }}/CHANGELOG.md) for details.
+
+            ${{ github.event.inputs.sdk_version && format('### SDK Dependency\nThis release requires `bedrock-agentcore>={0}`', github.event.inputs.sdk_version) || '' }}
+
+  summary:
+    name: Release Summary
+    needs: publish-testpypi
+    runs-on: ubuntu-latest
+    if: always()
+
+    steps:
+      - name: Summary
+        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
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "Package published to: https://test.pypi.org/project/bedrock-agentcore-starter-toolkit/" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "To install from Test PyPI:" >> $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 '```' >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **Release Failed**" >> $GITHUB_STEP_SUMMARY
+            echo "Check the workflow logs for details." >> $GITHUB_STEP_SUMMARY
+          fi

{bedrock_agentcore_starter_toolkit-0.1.2 → bedrock_agentcore_starter_toolkit-0.1.4}/.gitignore

@@ -20,3 +20,4 @@ requirements.txt
 documentation/site
 documentation/.cache
 .agentcore.yaml
+output*/

{bedrock_agentcore_starter_toolkit-0.1.2 → bedrock_agentcore_starter_toolkit-0.1.4}/.pre-commit-config.yaml

@@ -53,8 +53,8 @@ repos:
           --cov=src,
           --cov-report=term-missing,
           --cov-report=html,
-          --cov-fail-under=90,
           --cov-branch,
+          --cov-precision=2,
           tests/
         ]
 

{bedrock_agentcore_starter_toolkit-0.1.2 → bedrock_agentcore_starter_toolkit-0.1.4}/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.1.4] - 2025-08-06
+
+Added a utility to import from Bedrock Agents -> Bedrock AgentCore. Developers can generate and deploy a Langchain/Strands + AgentCore agent from a selected Bedrock Agent. The output agent leverages AgentCore primitives such as Gateway, Observability, Memory, and Code Interpreter. Added documentation on usage and design of this utility. This utility does not introduce any breaking changes. It is aimed towards Bedrock Agents customers who want to try a code-first, extensible approach with AgentCore.
+
+## [0.1.3] - 2025-08-01
+
+### BREAKING CHANGES
+- **CodeBuild is now the default launch method** - The `--codebuild` flag is no longer needed
+  - To use local Docker builds, you must now explicitly use `--local-build` flag
+  - This change improves the default user experience by building ARM64 containers in the cloud without requiring local Docker
+
+### Added
+- **Streaming invoke support re-enabled** - Restored streaming functionality for real-time agent responses
+- **Extended request timeout** - Increased invoke request timeout from default to 900 seconds (15 minutes) to support long-running agent operations
+
+### Changed
+- **Default launch behavior** - CodeBuild is now the default (`use_codebuild=True`)
+  - Users no longer need Docker installed locally for standard deployments
+  - Automatic ARM64 container builds in AWS CodeBuild
+  - Use `agentcore launch` for cloud builds (default)
+  - Use `agentcore launch --local-build` for local Docker builds
+
+### Improved
+- **Enhanced CLI help text** - Clearer descriptions guide users toward recommended options
+- **Better error messages** - Actionable recommendations for common issues
+- **Conflict handling** - Enhanced exception messages now suggest using `--auto-update-on-conflict` flag
+
+
 ## [0.1.2] - 2025-07-23
 
 ### Fixed