feat: add multi-platform ARM64 support for dependency packaging

- Support multiple manylinux platforms: aarch64-manylinux2014, aarch64-manylinux_2_17, aarch64-manylinux_2_28
- Try platforms in order of preference for better wheel compatibility
- Fallback to next platform if current one fails to find compatible wheels

Author: adi-avadhanam

src/bedrock_agentcore_starter_toolkit/utils/runtime/package.py

@@ -350,23 +350,47 @@ def _install_dependencies(
         # Input: "PYTHON_3_10" or "python3.10" → Output: "3.10"
         python_version = runtime_version.upper().replace("PYTHON", "").replace("_", ".").strip("_. ")
 
-        cmd = self._build_uv_command(requirements_file, target_dir, python_version, cross_compile)
-        log.info("Installing dependencies with uv%s...", " (cross-compiling for Linux ARM64)" if cross_compile else "")
-
-        try:
-            subprocess.run(cmd, check=True, capture_output=True, text=True)  # nosec B603 - using uv command
-            log.info("✓ Dependencies installed with uv")
-        except subprocess.CalledProcessError as e:
-            raise RuntimeError(f"Failed to install dependencies with uv: {e.stderr}") from e
+        if cross_compile:
+            # Try multiple platforms in order of preference for better compatibility
+            platforms = ["aarch64-manylinux2014", "aarch64-manylinux_2_17", "aarch64-manylinux_2_28"]
+
+            for i, platform in enumerate(platforms):
+                cmd = self._build_uv_command(requirements_file, target_dir, python_version, platform)
+                log.info(
+                    "Installing dependencies with uv for %s%s...",
+                    platform,
+                    " (cross-compiling for Linux ARM64)" if i == 0 else "",
+                )
 
-    def _build_uv_command(self, requirements: Path, target: Path, py_version: str, cross: bool) -> List[str]:
+                try:
+                    subprocess.run(cmd, check=True, capture_output=True, text=True)  # nosec B603 - using uv command
+                    if i == 0:
+                        log.info("✓ Dependencies installed with uv")
+                except subprocess.CalledProcessError as e:
+                    if i == len(platforms) - 1:  # Last platform failed
+                        raise RuntimeError(f"Failed to install dependencies with uv: {e.stderr}") from e
+                    # Try next platform
+                    continue
+        else:
+            cmd = self._build_uv_command(requirements_file, target_dir, python_version, None)
+            log.info("Installing dependencies with uv...")
+
+            try:
+                subprocess.run(cmd, check=True, capture_output=True, text=True)  # nosec B603 - using uv command
+                log.info("✓ Dependencies installed with uv")
+            except subprocess.CalledProcessError as e:
+                raise RuntimeError(f"Failed to install dependencies with uv: {e.stderr}") from e
+
+    def _build_uv_command(
+        self, requirements: Path, target: Path, py_version: str, platform: Optional[str]
+    ) -> List[str]:
         """Build uv pip install command.
 
         Args:
             requirements: Path to requirements.txt
             target: Target directory
             py_version: Python version (e.g., "3.10")
-            cross: Whether to cross-compile
+            platform: Platform string (e.g., "aarch64-manylinux2014") or None for native
 
         Returns:
             Command as list of strings
@@ -381,13 +405,12 @@ def _build_uv_command(self, requirements: Path, target: Path, py_version: str, c
             py_version,
         ]
 
-        # Always use aarch64-manylinux2014 for AgentCore Runtime (ARM64)
-        # Note: uv uses --python-platform (not --platform like pip)
-        if cross:
+        # Add platform-specific options for cross-compilation
+        if platform:
             cmd.extend(
                 [
                     "--python-platform",
-                    "aarch64-manylinux2014",
+                    platform,
                     "--only-binary",
                     ":all:",
                 ]

tests/utils/runtime/test_package.py

@@ -292,7 +292,7 @@ def test_build_uv_command(self, tmp_path):
         target = tmp_path / "target"
 
         packager = CodeZipPackager()
-        cmd = packager._build_uv_command(reqs, target, "3.10", cross=False)
+        cmd = packager._build_uv_command(reqs, target, "3.10", None)
 
         assert "uv" in cmd
         assert "--python-version" in cmd
@@ -306,7 +306,7 @@ def test_build_uv_command_with_cross_compile(self, tmp_path):
         target = tmp_path / "target"
 
         packager = CodeZipPackager()
-        cmd = packager._build_uv_command(reqs, target, "3.10", cross=True)
+        cmd = packager._build_uv_command(reqs, target, "3.10", "aarch64-manylinux2014")
 
         assert "--python-platform" in cmd
         assert "aarch64-manylinux2014" in cmd
@@ -498,15 +498,15 @@ def test_runtime_version_normalization(self, tmp_path):
 
         # Note: Normalization happens in _install_dependencies before calling _build_uv_command
         # This method receives already-normalized versions (e.g., "3.10")
-        cmd1 = packager._build_uv_command(reqs, target, "3.10", cross=False)
+        cmd1 = packager._build_uv_command(reqs, target, "3.10", None)
         assert "--python-version" in cmd1
         assert "3.10" in cmd1
 
-        cmd2 = packager._build_uv_command(reqs, target, "3.11", cross=False)
+        cmd2 = packager._build_uv_command(reqs, target, "3.11", None)
         assert "--python-version" in cmd2
         assert "3.11" in cmd2
 
-        cmd3 = packager._build_uv_command(reqs, target, "3.12", cross=True)
+        cmd3 = packager._build_uv_command(reqs, target, "3.12", "aarch64-manylinux2014")
         assert "--python-version" in cmd3
         assert "3.12" in cmd3
         assert "--python-platform" in cmd3