feat(gpu): route device selection through driver config

[elezar]

Summary

Draft POC for routing driver-specific GPU device selection through the selected runtime driver_config while keeping portable GPU presence/count in resource_requirements.gpu. This targets the updated PR #1156 shape and keeps Kubernetes out of exact device-id support for now.

Related Issue

Related to #1156 and #1589.

Changes

• Add per-driver gpu_device_ids handling for Docker, Podman, and VM driver config.
• Allow --gpu-device to imply GPU intent and set the portable GPU count to match the requested device IDs.
• Select the active driver config block in the gateway and pass it to the driver without interpreting nested fields.
• Validate gpu_device_ids at the driver level: non-empty IDs require a non-zero GPU count, duplicates are rejected, and the number of unique IDs must equal resource_requirements.gpu.count.
• Leave Kubernetes without exact device-id handling for this POC.
• Update driver docs, sandbox docs, architecture notes, and focused tests.

Testing

• mise run pre-commit passes
• mise exec -- cargo test -p openshell-core -p openshell-driver-docker -p openshell-driver-podman -p openshell-driver-vm --lib gpu
• mise run check
• Unit tests added/updated
• E2E tests added/updated (if applicable)

Checklist

• Follows Conventional Commits
• Commits are signed off (DCO)
• Architecture docs updated (if applicable)

[copy-pr-bot]

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

[github-actions]

🌿 Preview your docs: https://nvidia-preview-pr-1716.docs.buildwithfern.com/openshell