k8s-agent-sandbox-base

A faithful re-publish of the upstream k8s-agent-sandbox Python client, pinned to base commit d0a2213 (v0.5.3-16-gd0a2213), plus two small extension seams that make the client subclass-friendly without editing any other upstream file.

The distribution name is k8s-agent-sandbox-base, but the import package name is unchanged:

pip install k8s-agent-sandbox-base
import k8s_agent_sandbox  # same as upstream

Why this exists

It lets a downstream overlay extend the client without forking or editing upstream sources — so upstream upgrades never merge-conflict with the overlay. See the companion package k8s-agent-sandbox-awx, which uses these seams to provide a broker-backed, kubeconfig-free control plane.

What differs from upstream

Only k8s_agent_sandbox/sandbox_client.py is modified, with two changes that are no-ops for the default Kubernetes path:

1. A _build_k8s_helper() factory (default returns K8sHelper()), called from __init__, so subclasses can supply their own helper.
2. _create_claim() returns the helper's created-claim name, and create_sandbox() adopts that return value.

Everything else is a verbatim re-vendor of the base commit. See NOTICE for full attribution.

License

Apache-2.0 — see LICENSE and NOTICE.