bedrock-agentcore-starter-toolkit 0.1.3__tar.gz → 0.1.5__tar.gz

{bedrock_agentcore_starter_toolkit-0.1.3 → bedrock_agentcore_starter_toolkit-0.1.5}/.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.3 → bedrock_agentcore_starter_toolkit-0.1.5}/.github/workflows/deploy-docs.yml

@@ -35,7 +35,7 @@ jobs:
           python-version: '3.10'
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v6
 
       - name: Create virtual environment and install dependencies
         run: |

bedrock_agentcore_starter_toolkit-0.1.5/.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.5/.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.3 → bedrock_agentcore_starter_toolkit-0.1.5}/.github/workflows/security-scanning.yml

@@ -98,7 +98,7 @@ jobs:
           fetch-depth: 0
 
       - name: TruffleHog OSS
-        uses: trufflesecurity/trufflehog@v3.90.0
+        uses: trufflesecurity/trufflehog@v3.90.3
         with:
           path: ./
           base: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.sha || github.event.before }}

{bedrock_agentcore_starter_toolkit-0.1.3 → bedrock_agentcore_starter_toolkit-0.1.5}/.github/workflows/security.yml

@@ -100,7 +100,7 @@ jobs:
           fetch-depth: 0
 
       - name: TruffleHog OSS
-        uses: trufflesecurity/trufflehog@v3.82.3
+        uses: trufflesecurity/trufflehog@v3.90.3
         with:
           path: ./
           base: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.sha || github.event.before }}

{bedrock_agentcore_starter_toolkit-0.1.3 → bedrock_agentcore_starter_toolkit-0.1.5}/.gitignore

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

{bedrock_agentcore_starter_toolkit-0.1.3 → bedrock_agentcore_starter_toolkit-0.1.5}/.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.3 → bedrock_agentcore_starter_toolkit-0.1.5}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.1.5] - 2025-08-08
+
+### Changes
+
+- ci(deps): bump trufflesecurity/trufflehog from 3.82.3 to 3.90.3 (#99) (c055722)
+- ci(deps): bump astral-sh/setup-uv from 3 to 6 (#80) (8f70a8c)
+- increase botocore timeout (#108) (db90f00)
+- bump the default otel dependency (#107) (4fd8429)
+- bump version to 0.1.4 (#105) (a21ecfb)
+
+## [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

{bedrock_agentcore_starter_toolkit-0.1.3 → bedrock_agentcore_starter_toolkit-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bedrock-agentcore-starter-toolkit
-Version: 0.1.3
+Version: 0.1.5
 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
@@ -21,17 +21,23 @@ Classifier: Programming Language :: Python :: 3.13
 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.1
 Requires-Dist: boto3>=1.39.7
 Requires-Dist: botocore>=1.39.7
 Requires-Dist: docstring-parser<1.0,>=0.15
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: jinja2>=3.1.6
+Requires-Dist: openapi-spec-validator>=0.7.2
+Requires-Dist: prance>=25.4.8.0
 Requires-Dist: prompt-toolkit>=3.0.51
+Requires-Dist: py-openapi-schema-to-json-schema>=0.0.3
 Requires-Dist: pydantic<3.0.0,>=2.0.0
 Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: questionary>=2.1.0
 Requires-Dist: requests>=2.25.0
-Requires-Dist: rich<15.0.0,>=14.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: ruamel-yaml>=0.18.14
 Requires-Dist: toml>=0.10.2
 Requires-Dist: typer>=0.16.0
 Requires-Dist: typing-extensions<5.0.0,>=4.13.2
@@ -121,6 +127,20 @@ agentcore invoke '{"prompt": "Hello from Bedrock AgentCore!"}'
 - 🌐 **Browser** - Fast, secure cloud-based browser for web automation
 - 📊 **Observability** - Real-time monitoring and tracing with OpenTelemetry support
 
+## ➡️ Importing from Bedrock Agents
+
+Import from Bedrock Agents to AgentCore using the `import-agent` utility.
+
+```bash
+# Launch the import-agent workflow
+agentcore import-agent
+```
+
+This will generate an equivalent Langchain or Strands agent in `./output`, leveraging AgentCore primitives, and provide an option to deploy the agent to AgentCore Runtime. See additional documentation on this utility:
+- [Quickstart Guide](https://github.com/aws/bedrock-agentcore-starter-toolkit/blob/main/documentation/docs/user-guide/import-agent/quickstart.md)
+- [Utility Overview](https://github.com/aws/bedrock-agentcore-starter-toolkit/blob/main/documentation/docs/user-guide/import-agent/overview.md)
+
+
 ## 📚 About Amazon Bedrock AgentCore
 
 Amazon Bedrock AgentCore enables you to deploy and operate highly effective agents securely, at scale using any framework and model. With AgentCore, developers can accelerate AI agents into production with enterprise-grade scale, reliability, and security. The platform provides:

{bedrock_agentcore_starter_toolkit-0.1.3 → bedrock_agentcore_starter_toolkit-0.1.5}/README.md

@@ -80,6 +80,20 @@ agentcore invoke '{"prompt": "Hello from Bedrock AgentCore!"}'
 - 🌐 **Browser** - Fast, secure cloud-based browser for web automation
 - 📊 **Observability** - Real-time monitoring and tracing with OpenTelemetry support
 
+## ➡️ Importing from Bedrock Agents
+
+Import from Bedrock Agents to AgentCore using the `import-agent` utility.
+
+```bash
+# Launch the import-agent workflow
+agentcore import-agent
+```
+
+This will generate an equivalent Langchain or Strands agent in `./output`, leveraging AgentCore primitives, and provide an option to deploy the agent to AgentCore Runtime. See additional documentation on this utility:
+- [Quickstart Guide](https://github.com/aws/bedrock-agentcore-starter-toolkit/blob/main/documentation/docs/user-guide/import-agent/quickstart.md)
+- [Utility Overview](https://github.com/aws/bedrock-agentcore-starter-toolkit/blob/main/documentation/docs/user-guide/import-agent/overview.md)
+
+
 ## 📚 About Amazon Bedrock AgentCore
 
 Amazon Bedrock AgentCore enables you to deploy and operate highly effective agents securely, at scale using any framework and model. With AgentCore, developers can accelerate AI agents into production with enterprise-grade scale, reliability, and security. The platform provides:

{bedrock_agentcore_starter_toolkit-0.1.3 → bedrock_agentcore_starter_toolkit-0.1.5}/documentation/docs/api-reference/cli.md

@@ -219,3 +219,23 @@ agentcore gateway create-mcp-gateway-target \
   --gateway-url https://gateway-url.us-west-2.amazonaws.com \
   --role-arn arn:aws:iam::123456789012:role/GatewayRole
 ```
+
+### Importing from Bedrock Agents
+
+```bash
+# Interactive Mode
+agentcore import-agent
+
+# For Automation
+agentcore import-agent \
+  --region us-east-1 \
+  --agent-id ABCD1234 \
+  --agent-alias-id TSTALIASID \
+  --target-platform strands \
+  --output-dir ./my-agent \
+  --deploy-runtime \
+  --run-option runtime
+
+# AgentCore Primitive Opt-out
+agentcore import-agent --disable-gateway --disable-memory --disable-code-interpreter --disable-observability
+```