Agent Executor (AX) is Google's open agentic orchestration runtime
Go
Delete Kubernetes sandbox agents (#281)
Jaana Dogan9da8fad0ba92
diff --git a/Makefile b/Makefileindex 628f6d3..b73fb78 100644--- a/Makefile+++ b/Makefile@@ -74,10 +74,6 @@ ate-agent-image:@echo "Building ATE agent container image with ko..."GOFLAGS="-tags=ate" ko build --base-import-paths ./internal/experimental/examples/ate_agent-k8s-sandbox-router-image:- @echo "Building sandbox-router container image with ko..."- ko build --base-import-paths ./internal/experimental/k8s-sandbox-router-axepp-image:@echo "Building axepp container image with ko..."GOFLAGS="-tags=ate" ko build --base-import-paths ./cmd/axepp@@ -88,4 +84,4 @@ ax-shell-image:KO_DOCKER_REPO=$(KO_DOCKER_REPO)/ax-shell KO_DEFAULTBASEIMAGE=busybox:1.36 GOFLAGS="-tags=ate" ko build --base-import-paths ./cmd/ax# Build all container images-images: ax-image ate-agent-image k8s-sandbox-router-image axepp-image ax-shell-image+images: ax-image ate-agent-image axepp-image ax-shell-imagediff --git a/README.md b/README.mdindex e169cef..f985bb1 100644--- a/README.md+++ b/README.md@@ -355,7 +355,6 @@ requires explicit user approval via a confirmation flow before running.Custom agents can be registered on the AX server:- [Remote Agent](docs/remote-agent.md)-- [Kubernetes Sandbox Agents (Experimental)](docs/experimental/k8s-sandbox-agent.md)- [Colab Agents (Experimental)](docs/experimental/colab-agent.md)Please note that AX is actively developing a resumable streaming protocol;diff --git a/ax.yaml b/ax.yamlindex eb9ea5d..0984441 100644--- a/ax.yaml+++ b/ax.yaml@@ -47,14 +47,6 @@ registry:# metadata:# version: "1.0"- # k8s_sandbox_agents:- # - id: "uppercase"- # name: "Uppercase Agent"- # description: "Converts text to uppercase."- # sandbox_template_ref: "uppercase-agent-template"- # container_port: 8494- # use_router: true-# colab_agents:# - id: "plotter"# name: "Function Plotter"diff --git a/docs/experimental/k8s-sandbox-agent.md b/docs/experimental/k8s-sandbox-agent.mddeleted file mode 100644index 06a1050..0000000--- a/docs/experimental/k8s-sandbox-agent.md+++ /dev/null@@ -1,97 +0,0 @@-# Kubernetes Sandbox Agents--AX supports dynamically provisioning secure, isolated agents on Kubernetes via the [Agent Sandbox](https://github.com/kubernetes-sigs/agent-sandbox) feature. When an agent requires a Sandbox Agent, the AX server requests a temporary remote agent container in the cluster, establishes a secure connection locally (using port-forwarding via a proxy service), and cleans up the sandbox claim automatically upon closing.--## Prerequisites-- A running Kubernetes cluster.-- The [Agent Sandbox Controller](https://github.com/kubernetes-sigs/agent-sandbox?tab=readme-ov-file#installation) installed.-- `kubectl` installed and configured locally.--## Setup: Deploying the Router-Before using Sandbox Agents remotely and developing locally, you must deploy the `sandbox-router` into your cluster. This router proxies traffic securely to the isolated gVisor pods (direct port-forwarding to gVisor pods is not supported by Kubernetes due to netstack isolation).--1. Apply the manifest:-```bash--# Apply the manifest-kubectl apply -f internal/experimental/k8s-sandbox-router/sandbox-router.yaml-kubectl rollout status deployment/sandbox-router --timeout=60s-```--2. Expose it as a service:-```bash-kubectl expose deployment sandbox-router --port=8080 --target-port=8080-```--To use a Sandbox Agent, specify it in your `ax.yaml` configuration:--```yaml-registry:- k8s_sandbox_agents:- - id: "my-sandbox-agent"- name: "Sandbox Worker"- description: "An ephemeral sandbox processor"- sandbox_template_ref: "your-gke-sandbox-template-name"- container_port: 8494-```--## End-to-End Example (Uppercase Agent)--AX provides a complete example of a Sandbox Agent in `examples/k8s_sandbox_agent/`. It receives text input via gRPC and returns the same text converted to uppercase.--You can test this agent end-to-end using the `ax` binary, which exercises the full `SandboxAgent` lifecycle (provisioning, port-forwarding, and remote execution).--**1. Build the Agent Image**--From the root of the AX repository:-```bash-docker build -t ax-uppercase:latest -f examples/k8s_sandbox_agent/Dockerfile .-```--**2. Publish Image to Registry**--When deploying to a cluster, you can host the agent container image in **any standard container registry** accessible by your Kubernetes cluster (e.g., Docker Hub, Google Artifact Registry, GitHub Container Registry).-- For production, update the `image` field in `examples/k8s_sandbox_agent/sandbox-template-and-pool.yaml` to your full registry path.--Once the image is available, register the SandboxTemplate:-```bash-kubectl apply -f examples/k8s_sandbox_agent/sandbox-template-and-pool.yaml-```--**3. Configure ax.yaml**-Ensure your `ax.yaml` references this sandbox agent:-```yaml-registry:- k8s_sandbox_agents:- - id: "uppercase"- sandbox_template_ref: "uppercase-agent-template"- container_port: 8494- use_router: true-```--**4. Run the Server**-```bash-ax serve --config ax.yaml-```--**5. Run the Agent**-In a separate terminal:-```bash-ax exec --agent "uppercase" --input "hello world"-```--The system will dynamically create a `SandboxClaim`, establish a connection via `kubectl port-forward`, execute the code securely, and return the result.---## Viewing Sandbox Logs-If you want to monitor the internal agent output or see if your gVisor sandbox received the physical gRPC requests:--1. List the active sandbox Pods:-```bash-kubectl get pods -n default-```--2. Fetch the logs for your specific sandbox claim:-```bash-kubectl logs -f ax-claim-uppercase-<hash_id>-```diff --git a/examples/k8s_sandbox_agent/Dockerfile b/examples/k8s_sandbox_agent/Dockerfiledeleted file mode 100644index 84dfadd..0000000--- a/examples/k8s_sandbox_agent/Dockerfile+++ /dev/null@@ -1,61 +0,0 @@-# Copyright 2026 Google LLC-#-# Licensed under the Apache License, Version 2.0 (the "License");-# you may not use this file except in compliance with the License.-# You may obtain a copy of the License at-#-# http://www.apache.org/licenses/LICENSE-2.0-#-# Unless required by applicable law or agreed to in writing, software-# distributed under the License is distributed on an "AS IS" BASIS,-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-# See the License for the specific language governing permissions and-# limitations under the License.--# This Dockerfile builds the container image for the 'uppercase' Sandbox Agent.-# The resulting image is pushed to Artifact Registry and referenced by the-# SandboxTemplate manifest to be executed dynamically via GKE Agent Sandbox.-#-# For more details on GKE Agent Sandbox container requirements, see:-# https://docs.cloud.google.com/kubernetes-engine/docs/how-to/agent-sandbox--# Build stage-# TODO: consider other options instead of Alpine-FROM golang:alpine AS builder--# Install build dependencies-RUN apk add --no-cache git make build-base--WORKDIR /app--# Download dependencies first to cache them-COPY go.mod go.sum ./-RUN go mod download--# Copy source code-COPY . .--# Build the uppercase agent-RUN go build -o /app/bin/uppercase ./examples/sandbox_agent--# Runtime stage-# TODO: consider other options instead of Alpine-FROM alpine:3.19--# Install certificates for secure gRPC and external calls-RUN apk add --no-cache ca-certificates tzdata--WORKDIR /app--# Copy the built binary-COPY --from=builder /app/bin/uppercase /usr/local/bin/uppercase--# Create a non-root user matching expected Kubernetes security context best practices-RUN addgroup -S ax && adduser -S ax -G ax-USER ax--# Expose standard remote agent port-EXPOSE 8494--# Set default command-ENTRYPOINT ["/usr/local/bin/uppercase"]diff --git a/examples/k8s_sandbox_agent/main.go b/examples/k8s_sandbox_agent/main.godeleted file mode 100644index b8dc9a7..0000000--- a/examples/k8s_sandbox_agent/main.go+++ /dev/null@@ -1,153 +0,0 @@-// Copyright 2026 Google LLC-//-// Licensed under the Apache License, Version 2.0 (the "License");-// you may not use this file except in compliance with the License.-// You may obtain a copy of the License at-//-// http://www.apache.org/licenses/LICENSE-2.0-//-// Unless required by applicable law or agreed to in writing, software-// distributed under the License is distributed on an "AS IS" BASIS,-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-// See the License for the specific language governing permissions and-// limitations under the License.--package main--import (- "context"- "fmt"- "io"- "log"- "net"- "os"- "os/signal"- "strings"- "syscall"-- "github.com/google/ax/proto"- "google.golang.org/grpc"- "google.golang.org/grpc/reflection"-)--type server struct {- proto.UnimplementedAgentServiceServer-}--func (s *server) HealthCheck(ctx context.Context, req *proto.HealthCheckRequest) (*proto.HealthCheckResponse, error) {- return &proto.HealthCheckResponse{Healthy: true, Message: "k8s sandbox agent is running"}, nil-}--func (s *server) Connect(stream grpc.BidiStreamingServer[proto.AgentMessage, proto.AgentMessage]) error {- for {- // Read input from the orchestrator- req, err := stream.Recv()- if err == io.EOF {- return nil- }- if err != nil {- return err- }-- var outputs []*proto.Message- start := req.GetStart()- if start != nil && len(start.Messages) > 0 {- // Find the most recent message from the "user" in the history- var targetText string- for i := len(start.Messages) - 1; i >= 0; i-- {- msg := start.Messages[i]- if textContent := msg.GetContent().GetText(); textContent != nil && msg.Role == "user" {- targetText = textContent.Text- break- }- }-- if targetText != "" {- // Convert to upper case dynamically!- upper := strings.ToUpper(targetText)-- log.Printf("📥 Processed resolved text: %q", targetText)- log.Printf("📤 Sending response: %q", upper)-- outputs = append(outputs, &proto.Message{- Role: "agent",- Content: &proto.Content{- Type: &proto.Content_Text{- Text: &proto.TextContent{- Text: "Hey, I'm your sandbox agent.\n",- },- },- },- })- outputs = append(outputs, &proto.Message{- Role: "agent",- Content: &proto.Content{- Type: &proto.Content_Text{- Text: &proto.TextContent{- Text: fmt.Sprintf("here is your upper case text: %s", upper),- },- },- },- })- }- }-- if len(outputs) > 0 {- // Send response back via gRPC- if err := stream.Send(&proto.AgentMessage{- ConversationId: req.ConversationId,- ExecId: req.ExecId,- Type: &proto.AgentMessage_Outputs{- Outputs: &proto.AgentOutputs{- Messages: outputs,- },- },- }); err != nil {- return err- }- }-- // Send AgentEnd to signal end of outputs.- if err := stream.Send(&proto.AgentMessage{- ConversationId: req.ConversationId,- ExecId: req.ExecId,- Type: &proto.AgentMessage_End{- End: &proto.AgentEnd{},- },- }); err != nil {- return err- }- }-}--func main() {- port := os.Getenv("PORT")- if port == "" {- port = "50051" // Default port for local testing- }-- // 1. Listen on port- lis, err := net.Listen("tcp", ":"+port)- if err != nil {- log.Fatalf("failed to listen on %s: %v", port, err)- }-- // 2. Create gRPC server- s := grpc.NewServer()- proto.RegisterAgentServiceServer(s, &server{})- reflection.Register(s)-- // 3. Graceful shutdown handler- sigChan := make(chan os.Signal, 1)- signal.Notify(sigChan, os.Interrupt, syscall.SIGTERM)- go func() {- <-sigChan- log.Println("Shutting down upper_case_agent...")- s.GracefulStop()- }()-- log.Printf("🟢 upper_case_agent listening on :%s", port)- if err := s.Serve(lis); err != nil {- log.Fatalf("failed to serve: %v", err)- }-}diff --git a/examples/k8s_sandbox_agent/main_test.go b/examples/k8s_sandbox_agent/main_test.godeleted file mode 100644index e1b0dc0..0000000--- a/examples/k8s_sandbox_agent/main_test.go+++ /dev/null@@ -1,110 +0,0 @@-// Copyright 2026 Google LLC-//-// Licensed under the Apache License, Version 2.0 (the "License");-// you may not use this file except in compliance with the License.-// You may obtain a copy of the License at-//-// http://www.apache.org/licenses/LICENSE-2.0-//-// Unless required by applicable law or agreed to in writing, software-// distributed under the License is distributed on an "AS IS" BASIS,-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-// See the License for the specific language governing permissions and-// limitations under the License.--package main--import (- "fmt"- "strings"- "testing"-- "github.com/google/ax/proto"-)--func TestExtractLatestPayload(t *testing.T) {- // Let's create a simulated history payload- history := []*proto.Message{- {- Role: "user",- Content: &proto.Content{- Type: &proto.Content_Text{- Text: &proto.TextContent{Text: "old user prompt"},- },- },- },- {- Role: "agent",- Content: &proto.Content{- Type: &proto.Content_Text{- Text: &proto.TextContent{Text: "old agent response"},- },- },- },- {- Role: "user",- Content: &proto.Content{- Type: &proto.Content_Text{- Text: &proto.TextContent{Text: "find this text plz plz plz"},- },- },- },- {- Role: "agent",- Content: &proto.Content{- Type: &proto.Content_ToolCall{- ToolCall: &proto.ToolCallContent{- Type: &proto.ToolCallContent_FunctionCall{- FunctionCall: &proto.FunctionCallContent{- Name: "uppercase-agent",- },- },- },- },- },- },- }-- // 1. Emulate the agent logic exactly!- var targetText string- for i := len(history) - 1; i >= 0; i-- {- if content := history[i].GetContent(); content != nil {- if text := content.GetText(); text != nil && history[i].Role == "user" {- targetText = text.Text- break- }- }- }-- if targetText != "find this text plz plz plz" {- t.Errorf("Failed to identify correct user substring! Got: %q", targetText)- }-- // 2. Format output- upper := strings.ToUpper(targetText)- var outputs []*proto.Message- outputs = append(outputs, &proto.Message{- Role: "agent",- Content: &proto.Content{- Type: &proto.Content_Text{- Text: &proto.TextContent{- Text: "Hey, I'm your sandbox agent.\n",- },- },- },- })- outputs = append(outputs, &proto.Message{- Role: "agent",- Content: &proto.Content{- Type: &proto.Content_Text{- Text: &proto.TextContent{- Text: fmt.Sprintf("here is your upper case text: %s", upper),- },- },- },- })-- if len(outputs) != 2 || !strings.Contains(outputs[1].GetContent().GetText().Text, strings.ToUpper("find this text plz plz plz")) {- t.Errorf("Outputs failed! Got: %v", outputs)- }-}diff --git a/examples/k8s_sandbox_agent/sandbox-template-and-pool.yaml b/examples/k8s_sandbox_agent/sandbox-template-and-pool.yamldeleted file mode 100644index 70ed280..0000000--- a/examples/k8s_sandbox_agent/sandbox-template-and-pool.yaml+++ /dev/null@@ -1,58 +0,0 @@-# Copyright 2026 Google LLC-#-# Licensed under the Apache License, Version 2.0 (the "License");-# you may not use this file except in compliance with the License.-# You may obtain a copy of the License at-#-# http://www.apache.org/licenses/LICENSE-2.0-#-# Unless required by applicable law or agreed to in writing, software-# distributed under the License is distributed on an "AS IS" BASIS,-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-# See the License for the specific language governing permissions and-# limitations under the License.--# This is the Kubernetes manifest defining the execution environment for the agent.-# It is applied strictly to the GKE Agent Sandbox controllers to define the Sandbox.-#-# AGENT SEGREGATION:-# To support multiple different agents, you MUST create a separate SandboxTemplate-# and SandboxWarmPool for each agent with different sandbox requirements.-# The `sandboxTemplateRef` in the WarmPool and `ax.yaml` maps the AX logic to the specific isolated environment.-#-# For more details on GKE Agent Sandbox container requirements, see:-# https://docs.cloud.google.com/kubernetes-engine/docs/how-to/agent-sandbox-apiVersion: extensions.agents.x-k8s.io/v1alpha1-kind: SandboxTemplate-metadata:- name: uppercase-agent-template- namespace: default-spec:- podTemplate:- spec:- runtimeClassName: gvisor- containers:- - name: agent- image: us-central1-docker.pkg.dev/a2a-ae-demo-eoeg5x/ax-repo/ax-uppercase:latest- imagePullPolicy: Always- env:- - name: PORT- value: "8494"- ports:- - containerPort: 8494- name: grpc- readinessProbe:- tcpSocket:- port: 8494- initialDelaySeconds: 1- periodSeconds: 2-----apiVersion: extensions.agents.x-k8s.io/v1alpha1-kind: SandboxWarmPool-metadata:- name: uppercase-agent-warmpool- namespace: default-spec:- replicas: 2- sandboxTemplateRef:- name: uppercase-agent-templatediff --git a/go.mod b/go.modindex b6bd5af..49c037c 100644--- a/go.mod+++ b/go.mod@@ -11,18 +11,13 @@ require (github.com/google/uuid v1.6.0github.com/gorilla/websocket v1.5.4-0.20250319132907-e064f32e3674github.com/spf13/cobra v1.10.2- golang.org/x/net v0.52.0golang.org/x/sync v0.20.0google.golang.org/genai v1.43.0google.golang.org/genproto/googleapis/rpc v0.0.0-20260406210006-6f92a3bedf2dgoogle.golang.org/grpc v1.80.0google.golang.org/protobuf v1.36.12-0.20260120151049-f2248ac996afgopkg.in/yaml.v3 v3.0.1- k8s.io/api v0.35.3- k8s.io/apimachinery v0.36.0-beta.0- k8s.io/client-go v0.35.3modernc.org/sqlite v1.47.0- sigs.k8s.io/agent-sandbox v0.2.2-0.20260330232013-dff20f58c81e)require (@@ -43,84 +38,46 @@ require (github.com/clipperhouse/stringish v0.1.1 // indirectgithub.com/clipperhouse/uax29/v2 v2.3.0 // indirectgithub.com/cncf/xds/go v0.0.0-20251210132809-ee656c7534f5 // indirect- github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirectgithub.com/dustin/go-humanize v1.0.1 // indirect- github.com/emicklei/go-restful/v3 v3.13.0 // indirectgithub.com/envoyproxy/protoc-gen-validate v1.3.0 // indirectgithub.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirectgithub.com/felixge/httpsnoop v1.0.4 // indirect- github.com/fxamacker/cbor/v2 v2.9.0 // indirectgithub.com/go-logr/logr v1.4.3 // indirectgithub.com/go-logr/stdr v1.2.2 // indirect- github.com/go-openapi/jsonpointer v0.22.4 // indirect- github.com/go-openapi/jsonreference v0.21.4 // indirect- github.com/go-openapi/swag v0.25.4 // indirect- github.com/go-openapi/swag/cmdutils v0.25.4 // indirect- github.com/go-openapi/swag/conv v0.25.4 // indirect- github.com/go-openapi/swag/fileutils v0.25.4 // indirect- github.com/go-openapi/swag/jsonname v0.25.4 // indirect- github.com/go-openapi/swag/jsonutils v0.25.4 // indirect- github.com/go-openapi/swag/loading v0.25.4 // indirect- github.com/go-openapi/swag/mangling v0.25.4 // indirect- github.com/go-openapi/swag/netutils v0.25.4 // indirect- github.com/go-openapi/swag/stringutils v0.25.4 // indirect- github.com/go-openapi/swag/typeutils v0.25.4 // indirect- github.com/go-openapi/swag/yamlutils v0.25.4 // indirect- github.com/google/gnostic-models v0.7.0 // indirectgithub.com/google/go-cmp v0.7.0 // indirect+ github.com/google/pprof v0.0.0-20250403155104-27863c87afa6 // indirectgithub.com/google/s2a-go v0.1.9 // indirectgithub.com/googleapis/enterprise-certificate-proxy v0.3.14 // indirectgithub.com/googleapis/gax-go/v2 v2.21.0 // indirectgithub.com/inconshreveable/mousetrap v1.1.0 // indirect- github.com/json-iterator/go v1.1.12 // indirectgithub.com/lucasb-eyer/go-colorful v1.3.0 // indirectgithub.com/mattn/go-isatty v0.0.20 // indirectgithub.com/mattn/go-localereader v0.0.1 // indirectgithub.com/mattn/go-runewidth v0.0.19 // indirectgithub.com/mitchellh/hashstructure/v2 v2.0.2 // indirect- github.com/moby/spdystream v0.5.1 // indirect- github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect- github.com/modern-go/reflect2 v1.0.3-0.20250322232337-35a7c28c31ee // indirectgithub.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirectgithub.com/muesli/cancelreader v0.2.2 // indirectgithub.com/muesli/termenv v0.16.0 // indirect- github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirectgithub.com/ncruces/go-strftime v1.0.0 // indirectgithub.com/planetscale/vtprotobuf v0.6.1-0.20240319094008-0393e58bdf10 // indirectgithub.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirectgithub.com/rivo/uniseg v0.4.7 // indirectgithub.com/spf13/pflag v1.0.10 // indirect- github.com/x448/float16 v0.8.4 // indirectgithub.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirectgo.opentelemetry.io/auto/sdk v1.2.1 // indirectgo.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.64.0 // indirectgo.opentelemetry.io/otel v1.43.0 // indirectgo.opentelemetry.io/otel/metric v1.43.0 // indirectgo.opentelemetry.io/otel/trace v1.43.0 // indirect- go.yaml.in/yaml/v2 v2.4.3 // indirect- go.yaml.in/yaml/v3 v3.0.4 // indirectgolang.org/x/crypto v0.49.0 // indirectgolang.org/x/mod v0.33.0 // indirect- golang.org/x/oauth2 v0.36.0 // indirect+ golang.org/x/net v0.52.0 // indirectgolang.org/x/sys v0.42.0 // indirect- golang.org/x/term v0.41.0 // indirectgolang.org/x/text v0.35.0 // indirect- golang.org/x/time v0.15.0 // indirectgoogle.golang.org/api v0.274.0 // indirect- gopkg.in/evanphx/json-patch.v4 v4.13.0 // indirect- gopkg.in/inf.v0 v0.9.1 // indirect- k8s.io/klog/v2 v2.140.0 // indirect- k8s.io/kube-openapi v0.0.0-20260317180543-43fb72c5454a // indirect- k8s.io/streaming v0.36.0-beta.0 // indirect- k8s.io/utils v0.0.0-20260319190234-28399d86e0b5 // indirectmodernc.org/libc v1.70.0 // indirectmodernc.org/mathutil v1.7.1 // indirectmodernc.org/memory v1.11.0 // indirect- sigs.k8s.io/controller-runtime v0.23.3 // indirect- sigs.k8s.io/json v0.0.0-20250730193827-2d320260d730 // indirect- sigs.k8s.io/randfill v1.0.0 // indirect- sigs.k8s.io/structured-merge-diff/v6 v6.3.2 // indirect- sigs.k8s.io/yaml v1.6.0 // indirect)replace github.com/ai-on-gke/SubstrATE => ../SubstrATEdiff --git a/go.sum b/go.sumindex e604da4..8c1ceda 100644--- a/go.sum+++ b/go.sum@@ -6,12 +6,8 @@ cloud.google.com/go/compute/metadata v0.9.0 h1:pDUj4QMoPejqq20dK0Pg2N4yG9zIkYGdBcloud.google.com/go/compute/metadata v0.9.0/go.mod h1:E0bWwX5wTnLPedCKqk3pJmVgCBSM6qQI1yTBdEb3C10=github.com/MakeNowJust/heredoc v1.0.0 h1:cXCdzVdstXyiTqTvfqk9SDHpKNjxuom+DOlyEeQ4pzQ=github.com/MakeNowJust/heredoc v1.0.0/go.mod h1:mG5amYoWBHf8vpLOuehzbGGw0EHxpZZ6lCpQ4fNJ8LE=-github.com/Masterminds/semver/v3 v3.4.0 h1:Zog+i5UMtVoCU8oKka5P7i9q9HgrJeGzI9SA1Xbatp0=-github.com/Masterminds/semver/v3 v3.4.0/go.mod h1:4V+yj/TJE1HU9XfppCwVMZq3I84lprf4nC11bSS5beM=github.com/a2aproject/a2a-go/v2 v2.2.0 h1:eayiNXYpyTOLVhhQrGmIHlcy8GnOdnwaNdYQPvS84Ik=github.com/a2aproject/a2a-go/v2 v2.2.0/go.mod h1:htTxMwicNXXXEwwfjuB/Pd1g7UHDrswhSievncmTVcE=-github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5 h1:0CwZNZbxp69SHPdPJAN/hZIm0C4OItdklCFmMRWYpio=-github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5/go.mod h1:wHh0iHkYZB8zMSxRWpUBQtwG5a7fFgvEO+odwuTv2gs=github.com/atotto/clipboard v0.1.4 h1:EH0zSVneZPSuFR11BlR9YppQTVDbh5+16AmcJi4g1z4=github.com/atotto/clipboard v0.1.4/go.mod h1:ZY9tmq7sm5xIbd9bOK4onWV4S6X0u6GY7Vn0Yu86PYI=github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=@@ -59,14 +55,10 @@ github.com/cncf/xds/go v0.0.0-20251210132809-ee656c7534f5/go.mod h1:KdCmV+x/Buvygithub.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=github.com/creack/pty v1.1.24 h1:bJrF4RRfyJnbTJqzRLHzcGaZK1NeM5kTC9jGgovnR1s=github.com/creack/pty v1.1.24/go.mod h1:08sCNb52WyoAwi2QDyzUCTgcvVFhUzewun7wtTfvcwE=-github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM=github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=-github.com/emicklei/go-restful/v3 v3.13.0 h1:C4Bl2xDndpU6nJ4bc1jXd+uTmYPVUwkD6bFY/oTyCes=-github.com/emicklei/go-restful/v3 v3.13.0/go.mod h1:6n3XBCmQQb25CM2LCACGz8ukIrRry+4bhvbpWn3mrbc=github.com/envoyproxy/go-control-plane/envoy v1.36.0 h1:yg/JjO5E7ubRyKX3m07GF3reDNEnfOboJ0QySbH736g=github.com/envoyproxy/go-control-plane/envoy v1.36.0/go.mod h1:ty89S1YCCVruQAm9OtKeEkQLTb+Lkz0k8v9W0Oxsv98=github.com/envoyproxy/protoc-gen-validate v1.3.0 h1:TvGH1wof4H33rezVKWSpqKz5NXWg5VPuZ0uONDT6eb4=@@ -75,56 +67,15 @@ github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=github.com/felixge/httpsnoop v1.0.4 h1:NFTV2Zj1bL4mc9sqWACXbQFVBBg2W3GPvqp8/ESS2Wg=github.com/felixge/httpsnoop v1.0.4/go.mod h1:m8KPJKqk1gH5J9DgRY2ASl2lWCfGKXixSwevea8zH2U=-github.com/fxamacker/cbor/v2 v2.9.0 h1:NpKPmjDBgUfBms6tr6JZkTHtfFGcMKsw3eGcmD/sapM=-github.com/fxamacker/cbor/v2 v2.9.0/go.mod h1:vM4b+DJCtHn+zz7h3FFp/hDAI9WNWCsZj23V5ytsSxQ=github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A=github.com/go-logr/logr v1.4.3 h1:CjnDlHq8ikf6E492q6eKboGOC0T8CDaOvkHCIg8idEI=github.com/go-logr/logr v1.4.3/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag=github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE=-github.com/go-openapi/jsonpointer v0.22.4 h1:dZtK82WlNpVLDW2jlA1YCiVJFVqkED1MegOUy9kR5T4=-github.com/go-openapi/jsonpointer v0.22.4/go.mod h1:elX9+UgznpFhgBuaMQ7iu4lvvX1nvNsesQ3oxmYTw80=-github.com/go-openapi/jsonreference v0.21.4 h1:24qaE2y9bx/q3uRK/qN+TDwbok1NhbSmGjjySRCHtC8=-github.com/go-openapi/jsonreference v0.21.4/go.mod h1:rIENPTjDbLpzQmQWCj5kKj3ZlmEh+EFVbz3RTUh30/4=-github.com/go-openapi/swag v0.25.4 h1:OyUPUFYDPDBMkqyxOTkqDYFnrhuhi9NR6QVUvIochMU=-github.com/go-openapi/swag v0.25.4/go.mod h1:zNfJ9WZABGHCFg2RnY0S4IOkAcVTzJ6z2Bi+Q4i6qFQ=-github.com/go-openapi/swag/cmdutils v0.25.4 h1:8rYhB5n6WawR192/BfUu2iVlxqVR9aRgGJP6WaBoW+4=-github.com/go-openapi/swag/cmdutils v0.25.4/go.mod h1:pdae/AFo6WxLl5L0rq87eRzVPm/XRHM3MoYgRMvG4A0=-github.com/go-openapi/swag/conv v0.25.4 h1:/Dd7p0LZXczgUcC/Ikm1+YqVzkEeCc9LnOWjfkpkfe4=-github.com/go-openapi/swag/conv v0.25.4/go.mod h1:3LXfie/lwoAv0NHoEuY1hjoFAYkvlqI/Bn5EQDD3PPU=-github.com/go-openapi/swag/fileutils v0.25.4 h1:2oI0XNW5y6UWZTC7vAxC8hmsK/tOkWXHJQH4lKjqw+Y=-github.com/go-openapi/swag/fileutils v0.25.4/go.mod h1:cdOT/PKbwcysVQ9Tpr0q20lQKH7MGhOEb6EwmHOirUk=-github.com/go-openapi/swag/jsonname v0.25.4 h1:bZH0+MsS03MbnwBXYhuTttMOqk+5KcQ9869Vye1bNHI=-github.com/go-openapi/swag/jsonname v0.25.4/go.mod h1:GPVEk9CWVhNvWhZgrnvRA6utbAltopbKwDu8mXNUMag=-github.com/go-openapi/swag/jsonutils v0.25.4 h1:VSchfbGhD4UTf4vCdR2F4TLBdLwHyUDTd1/q4i+jGZA=-github.com/go-openapi/swag/jsonutils v0.25.4/go.mod h1:7OYGXpvVFPn4PpaSdPHJBtF0iGnbEaTk8AvBkoWnaAY=-github.com/go-openapi/swag/jsonutils/fixtures_test v0.25.4 h1:IACsSvBhiNJwlDix7wq39SS2Fh7lUOCJRmx/4SN4sVo=-github.com/go-openapi/swag/jsonutils/fixtures_test v0.25.4/go.mod h1:Mt0Ost9l3cUzVv4OEZG+WSeoHwjWLnarzMePNDAOBiM=-github.com/go-openapi/swag/loading v0.25.4 h1:jN4MvLj0X6yhCDduRsxDDw1aHe+ZWoLjW+9ZQWIKn2s=-github.com/go-openapi/swag/loading v0.25.4/go.mod h1:rpUM1ZiyEP9+mNLIQUdMiD7dCETXvkkC30z53i+ftTE=-github.com/go-openapi/swag/mangling v0.25.4 h1:2b9kBJk9JvPgxr36V23FxJLdwBrpijI26Bx5JH4Hp48=-github.com/go-openapi/swag/mangling v0.25.4/go.mod h1:6dxwu6QyORHpIIApsdZgb6wBk/DPU15MdyYj/ikn0Hg=-github.com/go-openapi/swag/netutils v0.25.4 h1:Gqe6K71bGRb3ZQLusdI8p/y1KLgV4M/k+/HzVSqT8H0=-github.com/go-openapi/swag/netutils v0.25.4/go.mod h1:m2W8dtdaoX7oj9rEttLyTeEFFEBvnAx9qHd5nJEBzYg=-github.com/go-openapi/swag/stringutils v0.25.4 h1:O6dU1Rd8bej4HPA3/CLPciNBBDwZj9HiEpdVsb8B5A8=-github.com/go-openapi/swag/stringutils v0.25.4/go.mod h1:GTsRvhJW5xM5gkgiFe0fV3PUlFm0dr8vki6/VSRaZK0=-github.com/go-openapi/swag/typeutils v0.25.4 h1:1/fbZOUN472NTc39zpa+YGHn3jzHWhv42wAJSN91wRw=-github.com/go-openapi/swag/typeutils v0.25.4/go.mod h1:Ou7g//Wx8tTLS9vG0UmzfCsjZjKhpjxayRKTHXf2pTE=-github.com/go-openapi/swag/yamlutils v0.25.4 h1:6jdaeSItEUb7ioS9lFoCZ65Cne1/RZtPBZ9A56h92Sw=-github.com/go-openapi/swag/yamlutils v0.25.4/go.mod h1:MNzq1ulQu+yd8Kl7wPOut/YHAAU/H6hL91fF+E2RFwc=-github.com/go-openapi/testify/enable/yaml/v2 v2.0.2 h1:0+Y41Pz1NkbTHz8NngxTuAXxEodtNSI1WG1c/m5Akw4=-github.com/go-openapi/testify/enable/yaml/v2 v2.0.2/go.mod h1:kme83333GCtJQHXQ8UKX3IBZu6z8T5Dvy5+CW3NLUUg=-github.com/go-openapi/testify/v2 v2.0.2 h1:X999g3jeLcoY8qctY/c/Z8iBHTbwLz7R2WXd6Ub6wls=-github.com/go-openapi/testify/v2 v2.0.2/go.mod h1:HCPmvFFnheKK2BuwSA0TbbdxJ3I16pjwMkYkP4Ywn54=-github.com/go-task/slim-sprig/v3 v3.0.0 h1:sUs3vkvUymDpBKi3qH1YSqBQk9+9D/8M2mN1vB6EwHI=-github.com/go-task/slim-sprig/v3 v3.0.0/go.mod h1:W848ghGpv3Qj3dhTPRyJypKRiqCdHZiAzKg9hl15HA8=github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=-github.com/google/gnostic-models v0.7.0 h1:qwTtogB15McXDaNqTZdzPJRHvaVJlAl+HVQnLmJEJxo=-github.com/google/gnostic-models v0.7.0/go.mod h1:whL5G0m6dmc5cPxKc5bdKdEN3UjI7OUGxBlw57miDrQ=github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=-github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=github.com/google/pprof v0.0.0-20250403155104-27863c87afa6 h1:BHT72Gu3keYf3ZEu2J0b1vyeLSOYI8bm5wbJM/8yDe8=github.com/google/pprof v0.0.0-20250403155104-27863c87afa6/go.mod h1:boTsfXsheKC2y+lKOCMpSfarhxDeIzfZG1jqGcPl3cA=github.com/google/s2a-go v0.1.9 h1:LGD7gtMgezd8a/Xak7mEWL0PjoTQFvpRudN895yqKW0=@@ -141,8 +92,6 @@ github.com/hashicorp/golang-lru/v2 v2.0.7 h1:a+bsQ5rvGLjzHuww6tVxozPZFVghXaHOwFsgithub.com/hashicorp/golang-lru/v2 v2.0.7/go.mod h1:QeFd9opnmA6QUJc5vARoKUSoFhyfM2/ZepoAG6RGpeM=github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=-github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=-github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=@@ -157,31 +106,16 @@ github.com/mattn/go-runewidth v0.0.19 h1:v++JhqYnZuu5jSKrk9RbgF5v4CGUjqRfBm05byFgithub.com/mattn/go-runewidth v0.0.19/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=github.com/mitchellh/hashstructure/v2 v2.0.2 h1:vGKWl0YJqUNxE8d+h8f6NJLcCJrgbhC4NcD46KavDd4=github.com/mitchellh/hashstructure/v2 v2.0.2/go.mod h1:MG3aRVU/N29oo/V/IhBX8GR/zz4kQkprJgF2EVszyDE=-github.com/moby/spdystream v0.5.1 h1:9sNYeYZUcci9R6/w7KDaFWEWeV4LStVG78Mpyq/Zm/Y=-github.com/moby/spdystream v0.5.1/go.mod h1:xBAYlnt/ay+11ShkdFKNAG7LsyK/tmNBVvVOwrfMgdI=-github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=-github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=-github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=-github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=-github.com/modern-go/reflect2 v1.0.3-0.20250322232337-35a7c28c31ee h1:W5t00kpgFdJifH4BDsTlE89Zl93FEloxaWZfGcifgq8=-github.com/modern-go/reflect2 v1.0.3-0.20250322232337-35a7c28c31ee/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=-github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA=-github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ=github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w=github.com/ncruces/go-strftime v1.0.0/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls=-github.com/onsi/ginkgo/v2 v2.27.2 h1:LzwLj0b89qtIy6SSASkzlNvX6WktqurSHwkk2ipF/Ns=-github.com/onsi/ginkgo/v2 v2.27.2/go.mod h1:ArE1D/XhNXBXCBkKOLkbsb2c81dQHCRcF5zwn/ykDRo=-github.com/onsi/gomega v1.38.2 h1:eZCjf2xjZAqe+LeWvKb5weQ+NcPwX84kqJ0cZNxok2A=-github.com/onsi/gomega v1.38.2/go.mod h1:W2MJcYxRGV63b418Ai34Ud0hEdTVXq9NW9+Sx6uXf3k=github.com/planetscale/vtprotobuf v0.6.1-0.20240319094008-0393e58bdf10 h1:GFCKgmp0tecUJ0sJuv4pzYCqS9+RGSn52M3FUwPs+uo=github.com/planetscale/vtprotobuf v0.6.1-0.20240319094008-0393e58bdf10/go.mod h1:t/avpk3KcrXxUnYOhZhMXJlSEyie6gQbtLq5NM3loB8=-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U=github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=@@ -196,14 +130,8 @@ github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTgithub.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=github.com/spf13/pflag v1.0.10 h1:4EBh2KAYBwaONj6b2Ye1GiHfwjqyROoF4RwYO+vPwFk=github.com/spf13/pflag v1.0.10/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=-github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=-github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=-github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=-github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=-github.com/x448/float16 v0.8.4 h1:qLwI1I70+NjRFUR3zs1JPUCgaCXSh3SW62uAKT1mSBM=-github.com/x448/float16 v0.8.4/go.mod h1:14CWIYCyZA/cWjXOioeEpHeN/83MdbZDRQHoFcYsOfg=github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=go.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ64=@@ -220,9 +148,6 @@ go.opentelemetry.io/otel/sdk/metric v1.43.0 h1:S88dyqXjJkuBNLeMcVPRFXpRw2fuwdvfCgo.opentelemetry.io/otel/sdk/metric v1.43.0/go.mod h1:C/RJtwSEJ5hzTiUz5pXF1kILHStzb9zFlIEe85bhj6A=go.opentelemetry.io/otel/trace v1.43.0 h1:BkNrHpup+4k4w+ZZ86CZoHHEkohws8AY+WTX09nk+3A=go.opentelemetry.io/otel/trace v1.43.0/go.mod h1:/QJhyVBUUswCphDVxq+8mld+AvhXZLhe+8WVFxiFff0=-go.yaml.in/yaml/v2 v2.4.3 h1:6gvOSjQoTB3vt1l+CU+tSyi/HOjfOjRLJ4YwYZGwRO0=-go.yaml.in/yaml/v2 v2.4.3/go.mod h1:zSxWcmIDjOzPXpjlTTbAsKokqkDNAVtZO0WOMiT90s8=-go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=golang.org/x/crypto v0.49.0 h1:+Ng2ULVvLHnJ/ZFEq4KdcDd/cfjrrjjNSXNzxg0Y4U4=golang.org/x/crypto v0.49.0/go.mod h1:ErX4dUh2UM+CFYiXZRTcMpEcN8b/1gxEuv3nODoYtCA=@@ -232,20 +157,14 @@ golang.org/x/mod v0.33.0 h1:tHFzIWbBifEmbwtGz65eaWyGiGZatSrT9prnU8DbVL8=golang.org/x/mod v0.33.0/go.mod h1:swjeQEj+6r7fODbD2cqrnje9PnziFuw4bmLbBZFrQ5w=golang.org/x/net v0.52.0 h1:He/TN1l0e4mmR3QqHMT2Xab3Aj3L9qjbhRm78/6jrW0=golang.org/x/net v0.52.0/go.mod h1:R1MAz7uMZxVMualyPXb+VaqGSa3LIaUqk0eEt3w36Sw=-golang.org/x/oauth2 v0.36.0 h1:peZ/1z27fi9hUOFCAZaHyrpWG5lwe0RJEEEeH0ThlIs=-golang.org/x/oauth2 v0.36.0/go.mod h1:YDBUJMTkDnJS+A4BP4eZBjCqtokkg1hODuPjwiGPO7Q=golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4=golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=golang.org/x/sys v0.42.0 h1:omrd2nAlyT5ESRdCLYdm3+fMfNFE/+Rf4bDIQImRJeo=golang.org/x/sys v0.42.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=-golang.org/x/term v0.41.0 h1:QCgPso/Q3RTJx2Th4bDLqML4W6iJiaXFq2/ftQF13YU=-golang.org/x/term v0.41.0/go.mod h1:3pfBgksrReYfZ5lvYM0kSO0LIkAl4Yl2bXOkKP7Ec2A=golang.org/x/text v0.35.0 h1:JOVx6vVDFokkpaq1AEptVzLTpDe9KGpj5tR4/X+ybL8=golang.org/x/text v0.35.0/go.mod h1:khi/HExzZJ2pGnjenulevKNX1W67CUy0AsXcNubPGCA=-golang.org/x/time v0.15.0 h1:bbrp8t3bGUeFOx08pvsMYRTCVSMk89u4tKbNOZbp88U=-golang.org/x/time v0.15.0/go.mod h1:Y4YMaQmXwGQZoFaVFk4YpCt4FLQMYKZe9oeV/f4MSno=golang.org/x/tools v0.42.0 h1:uNgphsn75Tdz5Ji2q36v/nsFSfR/9BRFvqhGBaJGd5k=golang.org/x/tools v0.42.0/go.mod h1:Ma6lCIwGZvHK6XtgbswSoWroEkhugApmsXyrUmBhfr0=gonum.org/v1/gonum v0.17.0 h1:VbpOemQlsSMrYmn7T2OUvQ4dqxQXU+ouZFQsZOx50z4=@@ -267,26 +186,8 @@ google.golang.org/protobuf v1.36.12-0.20260120151049-f2248ac996af/go.mod h1:HTf+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=-gopkg.in/evanphx/json-patch.v4 v4.13.0 h1:czT3CmqEaQ1aanPc5SdlgQrrEIb8w/wwCvWWnfEbYzo=-gopkg.in/evanphx/json-patch.v4 v4.13.0/go.mod h1:p8EYWUEYMpynmqDbY58zCKCFZw8pRWMG4EsWvDvM72M=-gopkg.in/inf.v0 v0.9.1 h1:73M5CoZyi3ZLMOyDlQh031Cx6N9NDJ2Vvfl76EDAgDc=-gopkg.in/inf.v0 v0.9.1/go.mod h1:cWUDdTG/fYaXco+Dcufb5Vnc6Gp2YChqWtbxRZE0mXw=gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=-k8s.io/api v0.35.3 h1:pA2fiBc6+N9PDf7SAiluKGEBuScsTzd2uYBkA5RzNWQ=-k8s.io/api v0.35.3/go.mod h1:9Y9tkBcFwKNq2sxwZTQh1Njh9qHl81D0As56tu42GA4=-k8s.io/apimachinery v0.36.0-beta.0 h1:FioYxKfnvZuo0EUX/W9X0FhH3omaG7dEdtDk2IsfEtU=-k8s.io/apimachinery v0.36.0-beta.0/go.mod h1:AEUkaeqhot34WXPkRiWxszI4nUd8m40AAYi28N33hqc=-k8s.io/client-go v0.35.3 h1:s1lZbpN4uI6IxeTM2cpdtrwHcSOBML1ODNTCCfsP1pg=-k8s.io/client-go v0.35.3/go.mod h1:RzoXkc0mzpWIDvBrRnD+VlfXP+lRzqQjCmKtiwZ8Q9c=-k8s.io/klog/v2 v2.140.0 h1:Tf+J3AH7xnUzZyVVXhTgGhEKnFqye14aadWv7bzXdzc=-k8s.io/klog/v2 v2.140.0/go.mod h1:o+/RWfJ6PwpnFn7OyAG3QnO47BFsymfEfrz6XyYSSp0=-k8s.io/kube-openapi v0.0.0-20260317180543-43fb72c5454a h1:xCeOEAOoGYl2jnJoHkC3hkbPJgdATINPMAxaynU2Ovg=-k8s.io/kube-openapi v0.0.0-20260317180543-43fb72c5454a/go.mod h1:uGBT7iTA6c6MvqUvSXIaYZo9ukscABYi2btjhvgKGZ0=-k8s.io/streaming v0.36.0-beta.0 h1:F3nft77sAwteE5VgwkJQQQsdRqkPCBKk4O24W5bkvtk=-k8s.io/streaming v0.36.0-beta.0/go.mod h1:5Zm1U2Duu3uu1nG/ijKuwNWDkQk24aXVpScAhzRkzkk=-k8s.io/utils v0.0.0-20260319190234-28399d86e0b5 h1:kBawHLSnx/mYHmRnNUf9d4CpjREbeZuxoSGOX/J+aYM=-k8s.io/utils v0.0.0-20260319190234-28399d86e0b5/go.mod h1:xDxuJ0whA3d0I4mf/C4ppKHxXynQ+fxnkmQH0vTHnuk=modernc.org/cc/v4 v4.27.1 h1:9W30zRlYrefrDV2JE2O8VDtJ1yPGownxciz5rrbQZis=modernc.org/cc/v4 v4.27.1/go.mod h1:uVtb5OGqUKpoLWhqwNQo/8LwvoiEBLvZXIQ/SmO6mL0=modernc.org/ccgo/v4 v4.32.0 h1:hjG66bI/kqIPX1b2yT6fr/jt+QedtP2fqojG2VrFuVw=@@ -315,15 +216,3 @@ modernc.org/strutil v1.2.1 h1:UneZBkQA+DX2Rp35KcM69cSsNES9ly8mQWD71HKlOA0=modernc.org/strutil v1.2.1/go.mod h1:EHkiggD70koQxjVdSBM3JKM7k6L0FbGE5eymy9i3B9A=modernc.org/token v1.1.0 h1:Xl7Ap9dKaEs5kLoOQeQmPWevfnk/DM5qcLcYlA8ys6Y=modernc.org/token v1.1.0/go.mod h1:UGzOrNV1mAFSEB63lOFHIpNRUVMvYTc6yu1SMY/XTDM=-sigs.k8s.io/agent-sandbox v0.2.2-0.20260330232013-dff20f58c81e h1:pWRnvUEp87A/NmMYKuwxxuZNkmxlRlAxaf89Khn7ICQ=-sigs.k8s.io/agent-sandbox v0.2.2-0.20260330232013-dff20f58c81e/go.mod h1:KgzzW+pWCb1u3/+xaw+zhpKp+O7WlHYWCQtbfypARGQ=-sigs.k8s.io/controller-runtime v0.23.3 h1:VjB/vhoPoA9l1kEKZHBMnQF33tdCLQKJtydy4iqwZ80=-sigs.k8s.io/controller-runtime v0.23.3/go.mod h1:B6COOxKptp+YaUT5q4l6LqUJTRpizbgf9KSRNdQGns0=-sigs.k8s.io/json v0.0.0-20250730193827-2d320260d730 h1:IpInykpT6ceI+QxKBbEflcR5EXP7sU1kvOlxwZh5txg=-sigs.k8s.io/json v0.0.0-20250730193827-2d320260d730/go.mod h1:mdzfpAEoE6DHQEN0uh9ZbOCuHbLK5wOm7dK4ctXE9Tg=-sigs.k8s.io/randfill v1.0.0 h1:JfjMILfT8A6RbawdsK2JXGBR5AQVfd+9TbzrlneTyrU=-sigs.k8s.io/randfill v1.0.0/go.mod h1:XeLlZ/jmk4i1HRopwe7/aU3H5n1zNUcX6TM94b3QxOY=-sigs.k8s.io/structured-merge-diff/v6 v6.3.2 h1:kwVWMx5yS1CrnFWA/2QHyRVJ8jM6dBA80uLmm0wJkk8=-sigs.k8s.io/structured-merge-diff/v6 v6.3.2/go.mod h1:M3W8sfWvn2HhQDIbGWj3S099YozAsymCo/wrT5ohRUE=-sigs.k8s.io/yaml v1.6.0 h1:G8fkbMSAFqgEFgh4b1wmtzDnioxFCUgTZhlbj5P9QYs=-sigs.k8s.io/yaml v1.6.0/go.mod h1:796bPqUfzR/0jLAl6XjHl3Ck7MiyVv8dbTdyT3/pMf4=diff --git a/internal/cliutil/cliutil.go b/internal/cliutil/cliutil.goindex 68b8e2a..50fa39c 100644--- a/internal/cliutil/cliutil.go+++ b/internal/cliutil/cliutil.go@@ -86,12 +86,6 @@ func NewControllerFromConfig(ctx context.Context, cfg *config.Config) (*controll}}- for _, agentCfg := range cfg.Registry.KubernetesSandboxAgents {- if err := c.Registry().RegisterKubernetesSandbox(ctx, agentCfg); err != nil {- return nil, fmt.Errorf("failed to register kubernetes sandbox agent %s: %w", agentCfg.ID, err)- }- }-for _, agentCfg := range cfg.Registry.ColabAgents {if err := c.Registry().RegisterColab(agentCfg); err != nil {return nil, fmt.Errorf("failed to register colab agent %s: %w", agentCfg.ID, err)diff --git a/internal/config/config.go b/internal/config/config.goindex e7f407b..b00ebc1 100644--- a/internal/config/config.go+++ b/internal/config/config.go@@ -36,10 +36,9 @@ type Config struct {// RegistryConfig allows registring agents.type RegistryConfig struct {- RemoteAgents []RemoteAgentConfig `yaml:"remote_agents,omitempty"`- KubernetesSandboxAgents []SandboxAgentConfig `yaml:"k8s_sandbox_agents,omitempty"`- ColabAgents []ColabAgentConfig `yaml:"colab_agents,omitempty"`- ATEAgents []ATEAgentConfig `yaml:"ate_agents,omitempty"`+ RemoteAgents []RemoteAgentConfig `yaml:"remote_agents,omitempty"`+ ColabAgents []ColabAgentConfig `yaml:"colab_agents,omitempty"`+ ATEAgents []ATEAgentConfig `yaml:"ate_agents,omitempty"`}// ATEConfig configures the ATE integration.@@ -142,18 +141,6 @@ type A2AConfig struct {Stateless bool `yaml:"stateless,omitempty"` // Send full history each turn (default: stateful)}-// SandboxAgentConfig configures a Kubernetes Sandbox agent to register on startup.-type SandboxAgentConfig struct {- ID string `yaml:"id"` // Unique agent identifier- Name string `yaml:"name"` // Human-readable name- Description string `yaml:"description"` // Description of agent capabilities- SandboxTemplateRef string `yaml:"sandbox_template_ref"` // Name of the SandboxTemplate CR to use- // TODO: implement shutdown_time for automatic sandbox shutdown- ContainerPort int `yaml:"container_port,omitempty"` // Optional container port, defaults to 8494- UseRouter bool `yaml:"use_router,omitempty"` // Override port-forwarding to use Sandbox Router- Metadata map[string]string `yaml:"metadata,omitempty"` // Optional metadata-}-// ColabAgentConfig configures a Colab agent to register on startup.type ColabAgentConfig struct {ID string `yaml:"id"` // Unique agent identifierdiff --git a/internal/controller/registry.go b/internal/controller/registry.goindex 1c5601d..e3f9ce0 100644--- a/internal/controller/registry.go+++ b/internal/controller/registry.go@@ -140,40 +140,6 @@ func (r *Registry) registerA2A(ctx context.Context, cfg config.RemoteAgentConfigreturn nil}-// RegisterKubernetesSandbox registers a sandbox agent by dynamically provisioning a Sandbox on GKE.-func (r *Registry) RegisterKubernetesSandbox(ctx context.Context, cfg config.SandboxAgentConfig) error {- r.mu.Lock()- defer r.mu.Unlock()-- if err := validateID(cfg.ID); err != nil {- return err- }-- if _, ok := r.agents[cfg.ID]; ok {- return fmt.Errorf("agent %s already registered", cfg.ID)- }-- sandboxAgent, err := expagent.NewKubernetesSandboxAgent(ctx, expagent.KubernetesSandboxAgentConfig{- ID: cfg.ID,- SandboxTemplateRef: cfg.SandboxTemplateRef,- ContainerPort: cfg.ContainerPort,- UseRouter: cfg.UseRouter,- })- if err != nil {- return fmt.Errorf("failed to provision sandbox agent: %w", err)- }-- r.agents[cfg.ID] = sandboxAgent- r.agentInfo[cfg.ID] = &agent.AgentInfo{- ID: cfg.ID,- Name: cfg.Name,- Description: cfg.Description,- Metadata: cfg.Metadata,- }-- return nil-}-// RegisterColab registers a Colab agent that executes a local Python file// on a remote Colab session via the colab CLI.func (r *Registry) RegisterColab(cfg config.ColabAgentConfig) error {diff --git a/internal/experimental/agent/k8s_sandbox.go b/internal/experimental/agent/k8s_sandbox.godeleted file mode 100644index ffb6d3f..0000000--- a/internal/experimental/agent/k8s_sandbox.go+++ /dev/null@@ -1,228 +0,0 @@-// Copyright 2026 Google LLC-//-// Licensed under the Apache License, Version 2.0 (the "License");-// you may not use this file except in compliance with the License.-// You may obtain a copy of the License at-//-// http://www.apache.org/licenses/LICENSE-2.0-//-// Unless required by applicable law or agreed to in writing, software-// distributed under the License is distributed on an "AS IS" BASIS,-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-// See the License for the specific language governing permissions and-// limitations under the License.--package agent--import (- "context"- "fmt"- "log"- "net"- "os"- "strings"- "sync"- "time"-- "github.com/google/ax/internal/agent"- "github.com/google/ax/internal/experimental/k8s/sandboxclient"- "github.com/google/ax/proto"- "google.golang.org/grpc/metadata"-)--type KubernetesSandboxAgent struct {- client *sandboxclient.Client- config KubernetesSandboxAgentConfig- inCluster bool-- claimMu sync.Mutex- activeClaims map[string]struct{}-}--// KubernetesSandboxAgentConfig configures a sandbox agent client.-type KubernetesSandboxAgentConfig struct {- ID string- SandboxTemplateRef string-- ContainerPort int- UseRouter bool- RouterAddress string-}--// NewKubernetesSandboxAgent creates a new sandbox agent logic coordinator.-func NewKubernetesSandboxAgent(ctx context.Context, config KubernetesSandboxAgentConfig) (*KubernetesSandboxAgent, error) {- namespace := "default"- //TODO(lhuan): allow setup in yaml- if ns := os.Getenv("POD_NAMESPACE"); ns != "" {- namespace = ns- }-- client, err := sandboxclient.NewClient(namespace)- if err != nil {- return nil, fmt.Errorf("failed to create sandbox client: %w", err)- }-- return newKubernetesSandboxAgentWithClient(ctx, client, config)-}--// newKubernetesSandboxAgentWithClient allows customizing the client instantiation.-func newKubernetesSandboxAgentWithClient(ctx context.Context, client *sandboxclient.Client, config KubernetesSandboxAgentConfig) (*KubernetesSandboxAgent, error) {- agent := &KubernetesSandboxAgent{- client: client,- config: config,- inCluster: os.Getenv("KUBERNETES_SERVICE_HOST") != "",- activeClaims: make(map[string]struct{}),- }-- return agent, nil-}--func (a *KubernetesSandboxAgent) Connect(ctx context.Context, conversationID string, execID string, start *proto.AgentStart, e agent.Executor, o agent.OutputHandler) error {- ctx, cancel := context.WithTimeout(ctx, 5*time.Second)- defer cancel()-- // Use the id deterministically so interactive executions reuse the same sandbox pod,- // rather than spawning a new pod for every exchanged message.- safeID := strings.ReplaceAll(execID, "-", "")- if len(safeID) > 20 {- safeID = safeID[:20] // Keep it short for k8s names- }- claimName := fmt.Sprintf("ax-claim-%s-%s", a.config.ID, safeID)-- // 1. Create Ephemeral SandboxClaim (Ignore AlreadyExists errors if it's already created this execution)- if err := a.client.CreateClaim(ctx, claimName, a.config.SandboxTemplateRef); err != nil {- if !strings.Contains(err.Error(), "already exists") {- return fmt.Errorf("failed to create SandboxClaim: %w", err)- }- }-- // We track the claim so `Close()` deletes it at the end of the execution.- // If we deleted it here, interactive shells would lose the pod.- a.claimMu.Lock()- a.activeClaims[claimName] = struct{}{}- a.claimMu.Unlock()-- // Wait for Sandbox to bound and get the warm pool pod selector- selector, err := a.client.WaitForSandbox(ctx, claimName)- if err != nil {- return fmt.Errorf("failed to wait for sandbox: %w", err)- }-- // 2. Setup Connection (Direct or Router)- targetPort := a.config.ContainerPort- if targetPort == 0 {- targetPort = 8494- }-- var remoteAddr string- var pfCancel func()- var errPF error-- namespace := "default"- if ns := os.Getenv("POD_NAMESPACE"); ns != "" {- namespace = ns- }-- if a.config.UseRouter {- // Use Sandbox Router- routerAddr := a.config.RouterAddress- if routerAddr == "" {- routerAddr = fmt.Sprintf("sandbox-router-svc.%s.svc.cluster.local:8080", namespace)- }-- if !a.inCluster {- // Local testing: port-forward the router service- localPort, err := findAvailablePort()- if err != nil {- return err- }- pfCancel, errPF = a.client.PortForwardRouter(ctx, localPort, 8080)- if errPF != nil {- return fmt.Errorf("router port-forward failed: %w", errPF)- }- remoteAddr = fmt.Sprintf("127.0.0.1:%d", localPort)- } else {- remoteAddr = routerAddr- }-- // Add routing headers- ctx = metadata.AppendToOutgoingContext(ctx,- "x-sandbox-id", claimName,- "x-sandbox-namespace", namespace,- "x-sandbox-port", fmt.Sprintf("%d", targetPort),- )- } else {- // Direct to Pod- if !a.inCluster {- localPort, err := findAvailablePort()- if err != nil {- return err- }- pfCancel, errPF = a.client.PortForward(ctx, claimName, selector, localPort, targetPort)- if errPF != nil {- return fmt.Errorf("port-forward failed: %w", errPF)- }- remoteAddr = fmt.Sprintf("127.0.0.1:%d", localPort)- log.Printf("Sandbox port-forward established at: %s", remoteAddr)- } else {- // This case is rare for direct-to-pod in cluster (usually uses service)- // But for now, we'll assume the service is named after the claim- remoteAddr = fmt.Sprintf("%s.%s.svc.cluster.local:%d", claimName, namespace, targetPort)- }- }-- if pfCancel != nil {- defer pfCancel()- }-- // Connect to the agent (either direct or via router)- remoteAgent, err := agent.NewRemoteAgent(agent.RemoteAgentConfig{- Address: remoteAddr,- // TODO: allow setup reconnect and max retires in yaml.- // TODO: implement dynamic mTLS or PSK interceptors to secure the unauthenticated gRPC Sandbox transport- Reconnect: true,- MaxRetries: 3,- })- if err != nil {- return fmt.Errorf("failed to create remote agent connection: %w", err)- }- defer remoteAgent.Close()-- // Forward the request!- return remoteAgent.Connect(ctx, conversationID, execID, start, e, o)-}--func findAvailablePort() (int, error) {- addr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:0")- if err != nil {- return 0, fmt.Errorf("failed to resolve local address: %w", err)- }- l, err := net.ListenTCP("tcp", addr)- if err != nil {- return 0, fmt.Errorf("failed to bind to local port: %w", err)- }- defer l.Close()- return l.Addr().(*net.TCPAddr).Port, nil-}--// Close gracefully shreds all active SandboxClaims generated by this agent-// during interactive executions.-func (a *KubernetesSandboxAgent) Close() error {- ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)- defer cancel()-- var errs []string-- a.claimMu.Lock()- for claimName := range a.activeClaims {- if err := a.client.DeleteClaim(ctx, claimName); err != nil {- errs = append(errs, fmt.Sprintf("failed to delete claim %q: %v", claimName, err))- }- }- a.claimMu.Unlock()-- if len(errs) > 0 {- return fmt.Errorf("cleanup errors: %s", strings.Join(errs, "; "))- }- return nil-}diff --git a/internal/experimental/k8s-sandbox-router/main.go b/internal/experimental/k8s-sandbox-router/main.godeleted file mode 100644index 029a014..0000000--- a/internal/experimental/k8s-sandbox-router/main.go+++ /dev/null@@ -1,115 +0,0 @@-// Copyright 2026 Google LLC-//-// Licensed under the Apache License, Version 2.0 (the "License");-// you may not use this file except in compliance with the License.-// You may obtain a copy of the License at-//-// http://www.apache.org/licenses/LICENSE-2.0-//-// Unless required by applicable law or agreed to in writing, software-// distributed under the License is distributed on an "AS IS" BASIS,-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-// See the License for the specific language governing permissions and-// limitations under the License.--// The sandbox-router is a reverse proxy for routing requests-// to sandbox agents.-// It reads routing information from HTTP headers and forwards requests-// to the corresponding sandbox service within a Kubernetes cluster.-package main--import (- "crypto/tls"- "fmt"- "io"- "log"- "net"- "net/http"- "net/http/httputil"- "net/url"- "os"-- "golang.org/x/net/http2"- "golang.org/x/net/http2/h2c"-)--func main() {- port := os.Getenv("PORT")- if port == "" {- port = "8080"- }-- director := func(req *http.Request) {- sandboxID := req.Header.Get("X-Sandbox-Id")- sandboxNamespace := req.Header.Get("X-Sandbox-Namespace")- sandboxPort := req.Header.Get("X-Sandbox-Port")-- if sandboxID == "" {- sandboxID = req.Header.Get("x-sandbox-id")- }- if sandboxNamespace == "" {- sandboxNamespace = req.Header.Get("x-sandbox-namespace")- }- if sandboxPort == "" {- sandboxPort = req.Header.Get("x-sandbox-port")- }-- if sandboxID == "" || sandboxNamespace == "" || sandboxPort == "" {- log.Printf("Missing required headers: ID=%v, Namespace=%v, Port=%v", sandboxID, sandboxNamespace, sandboxPort)- return- }-- targetURL := fmt.Sprintf("http://%s.%s.svc.cluster.local:%s", sandboxID, sandboxNamespace, sandboxPort)- target, err := url.Parse(targetURL)- if err != nil {- log.Printf("Failed to parse target URL %s: %v", targetURL, err)- return- }-- log.Printf("Proxying request %s to %s", req.URL.Path, targetURL)-- req.URL.Scheme = target.Scheme- req.URL.Host = target.Host- req.Host = target.Host- }-- proxy := &httputil.ReverseProxy{- Director: director,- Transport: &http2.Transport{- AllowHTTP: true,- DialTLS: func(network, addr string, cfg *tls.Config) (net.Conn, error) {- return net.Dial(network, addr)- },- },- ErrorHandler: func(w http.ResponseWriter, r *http.Request, err error) {- log.Printf("Proxy error for %s: %v", r.URL.Path, err)- http.Error(w, "Proxy error: "+err.Error(), http.StatusBadGateway)- },- ModifyResponse: func(res *http.Response) error {- if res.StatusCode != http.StatusOK {- body, _ := io.ReadAll(res.Body)- log.Printf("Backend returned error %d: %s", res.StatusCode, string(body))- }- return nil- },- }-- handler := func(w http.ResponseWriter, r *http.Request) {- if r.URL.Path == "/healthz" {- w.WriteHeader(http.StatusOK)- w.Write([]byte("ok\n"))- return- }- proxy.ServeHTTP(w, r)- }-- server := &http.Server{- Addr: ":" + port,- Handler: h2c.NewHandler(http.HandlerFunc(handler), &http2.Server{}),- }-- log.Printf("Starting sandbox router on port %s...", port)- if err := server.ListenAndServe(); err != nil {- log.Fatalf("Server failed: %v", err)- }-}diff --git a/internal/experimental/k8s-sandbox-router/sandbox-router.yaml b/internal/experimental/k8s-sandbox-router/sandbox-router.yamldeleted file mode 100644index 30214e0..0000000--- a/internal/experimental/k8s-sandbox-router/sandbox-router.yaml+++ /dev/null@@ -1,35 +0,0 @@-# Copyright 2026 Google LLC-#-# Licensed under the Apache License, Version 2.0 (the "License");-# you may not use this file except in compliance with the License.-# You may obtain a copy of the License at-#-# http://www.apache.org/licenses/LICENSE-2.0-#-# Unless required by applicable law or agreed to in writing, software-# distributed under the License is distributed on an "AS IS" BASIS,-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-# See the License for the specific language governing permissions and-# limitations under the License.--apiVersion: apps/v1-kind: Deployment-metadata:- name: sandbox-router- labels:- app: sandbox-router-spec:- replicas: 1- selector:- matchLabels:- app: sandbox-router- template:- metadata:- labels:- app: sandbox-router- spec:- containers:- - name: router- image: gcr.io/ax-container-images/k8s-sandbox-router- ports:- - containerPort: 8080diff --git a/internal/experimental/k8s/sandboxclient/client.go b/internal/experimental/k8s/sandboxclient/client.godeleted file mode 100644index 23cde4d..0000000--- a/internal/experimental/k8s/sandboxclient/client.go+++ /dev/null@@ -1,359 +0,0 @@-// Copyright 2026 Google LLC-//-// Licensed under the Apache License, Version 2.0 (the "License");-// you may not use this file except in compliance with the License.-// You may obtain a copy of the License at-//-// http://www.apache.org/licenses/LICENSE-2.0-//-// Unless required by applicable law or agreed to in writing, software-// distributed under the License is distributed on an "AS IS" BASIS,-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-// See the License for the specific language governing permissions and-// limitations under the License.--// Package sandboxclient provides a high-level Go client for interacting with-// the Kubernetes Agent Sandbox controllers, mirroring the official Python client.-package sandboxclient--import (- "context"- "fmt"- "log"- "time"-- corev1 "k8s.io/api/core/v1"- metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"- "k8s.io/apimachinery/pkg/watch"- "k8s.io/client-go/kubernetes"- "k8s.io/client-go/rest"- "k8s.io/client-go/tools/clientcmd"-- sandboxv1alpha1 "sigs.k8s.io/agent-sandbox/api/v1alpha1"- agentsclientset "sigs.k8s.io/agent-sandbox/clients/k8s/clientset/versioned"- extclientset "sigs.k8s.io/agent-sandbox/clients/k8s/extensions/clientset/versioned"- extensionsv1alpha1 "sigs.k8s.io/agent-sandbox/extensions/api/v1alpha1"-)--const routerLabelSelector = "app=sandbox-router"--// Client implements a high-level client for managing Sandbox resources in Kubernetes.-//-// It holds three typed clientsets — one per API group:-//-// - agentsClient: for Sandbox resources (agents.x-k8s.io/v1alpha1).-// Used to Watch/Get sandboxes and check the Ready condition.-//-// - extClient: for SandboxClaim, SandboxTemplate, SandboxWarmPool-// (extensions.agents.x-k8s.io/v1alpha1). Used to Create/Delete claims.-//-// - clientset: for core Kubernetes resources (pods, services).-// Needed for pod discovery during port-forward setup and for the-// CoreV1().RESTClient() that SPDY port-forward tunneling requires.-type Client struct {- agentsClient agentsclientset.Interface // Handles Sandbox resources (agents.x-k8s.io/v1alpha1)- extClient extclientset.Interface // Handles SandboxClaim, SandboxTemplate, SandboxWarmPool (extensions.agents.x-k8s.io/v1alpha1)- clientset kubernetes.Interface // Handles Core Kubernetes resources (Pods, Services, REST client)- restConfig *rest.Config- namespace string-}--// NewClient creates a new Sandbox client using the local kubeconfig or cluster environment.-func NewClient(namespace string) (*Client, error) {- config, err := rest.InClusterConfig()- if err != nil {- kubeconfig := clientcmd.RecommendedHomeFile- config, err = clientcmd.BuildConfigFromFlags("", kubeconfig)- if err != nil {- return nil, fmt.Errorf("failed to load kubeconfig: %w", err)- }- }-- agentsClient, err := agentsclientset.NewForConfig(config)- if err != nil {- return nil, fmt.Errorf("failed to create agents clientset: %w", err)- }-- extClient, err := extclientset.NewForConfig(config)- if err != nil {- return nil, fmt.Errorf("failed to create extensions clientset: %w", err)- }-- clientset, err := kubernetes.NewForConfig(config)- if err != nil {- return nil, fmt.Errorf("failed to create kubernetes clientset: %w", err)- }-- return &Client{- agentsClient: agentsClient,- extClient: extClient,- clientset: clientset,- restConfig: config,- namespace: namespace,- }, nil-}--// CreateClaim provisions an ephemeral sandbox execution environment by creating a SandboxClaim.-func (c *Client) CreateClaim(ctx context.Context, claimName, templateRef string) error {- claim := &extensionsv1alpha1.SandboxClaim{- ObjectMeta: metav1.ObjectMeta{- Name: claimName,- },- Spec: extensionsv1alpha1.SandboxClaimSpec{- TemplateRef: extensionsv1alpha1.SandboxTemplateRef{- Name: templateRef,- },- },- }-- _, err := c.extClient.ExtensionsV1alpha1().SandboxClaims(c.namespace).- Create(ctx, claim, metav1.CreateOptions{})- return err-}--// ResolveSandboxName watches the SandboxClaim until its status contains the resolved-// Sandbox name (populated by the controller after a warm-pool pod is assigned).-func (c *Client) ResolveSandboxName(ctx context.Context, claimName string, timeout time.Duration) (string, error) {- ctx, cancel := context.WithTimeout(ctx, timeout)- defer cancel()-- watcher, err := c.extClient.ExtensionsV1alpha1().SandboxClaims(c.namespace).- Watch(ctx, metav1.ListOptions{- FieldSelector: fmt.Sprintf("metadata.name=%s", claimName),- })- if err != nil {- return "", fmt.Errorf("failed to watch SandboxClaim %s: %w", claimName, err)- }- defer watcher.Stop()-- for event := range watcher.ResultChan() {- if event.Type == watch.Error {- continue- }- claim, ok := event.Object.(*extensionsv1alpha1.SandboxClaim)- if !ok {- continue- }- // In the current schema, the Sandbox name is identical to the claim name,- // and we wait for the claim to be Ready to ensure it's bound.- for _, cond := range claim.Status.Conditions {- if string(cond.Type) == "Ready" && string(cond.Status) == string(metav1.ConditionTrue) {- return claimName, nil- }- }- }- return "", fmt.Errorf("timeout waiting for sandbox readiness on claim %s", claimName)-}--// ResolveSandboxStatus watches the Sandbox until its status is fully populated,-// returning the label selector and service name needed for port-forwarding.-func (c *Client) ResolveSandboxStatus(ctx context.Context, sandboxName string, timeout time.Duration) (selector, svc string, err error) {- ctx, cancel := context.WithTimeout(ctx, timeout)- defer cancel()-- watcher, err := c.agentsClient.AgentsV1alpha1().Sandboxes(c.namespace).- Watch(ctx, metav1.ListOptions{- FieldSelector: fmt.Sprintf("metadata.name=%s", sandboxName),- })- if err != nil {- return "", "", fmt.Errorf("failed to watch Sandbox %s: %w", sandboxName, err)- }- defer watcher.Stop()-- for event := range watcher.ResultChan() {- if event.Type == watch.Error {- continue- }- sandbox, ok := event.Object.(*sandboxv1alpha1.Sandbox)- if !ok {- continue- }- if sandbox.Status.LabelSelector != "" && sandbox.Status.Service != "" {- return sandbox.Status.LabelSelector, sandbox.Status.Service, nil- }- }- return "", "", fmt.Errorf("timeout waiting for sandbox status for %s", sandboxName)-}--// WaitForSandboxReady watches the Sandbox until the Ready condition is True.-func (c *Client) WaitForSandboxReady(ctx context.Context, sandboxName string) error {- watcher, err := c.agentsClient.AgentsV1alpha1().Sandboxes(c.namespace).- Watch(ctx, metav1.ListOptions{- FieldSelector: fmt.Sprintf("metadata.name=%s", sandboxName),- })- if err != nil {- return fmt.Errorf("failed to watch Sandbox %s: %w", sandboxName, err)- }- defer watcher.Stop()-- for event := range watcher.ResultChan() {- sandbox, ok := event.Object.(*sandboxv1alpha1.Sandbox)- if !ok {- continue- }- for _, cond := range sandbox.Status.Conditions {- if string(cond.Type) == string(sandboxv1alpha1.SandboxConditionReady) && string(cond.Status) == string(metav1.ConditionTrue) {- return nil- }- }- }- return fmt.Errorf("timeout waiting for Sandbox %s to be ready", sandboxName)-}--// findRunningPod finds a Running pod matching the given label selector.-func (c *Client) findRunningPod(ctx context.Context, selector string) (string, error) {- pods, err := c.clientset.CoreV1().Pods(c.namespace).List(ctx, metav1.ListOptions{- LabelSelector: selector,- FieldSelector: "status.phase=Running",- })- if err != nil {- return "", fmt.Errorf("failed to list pods with selector %s: %w", selector, err)- }- if len(pods.Items) == 0 {- return "", fmt.Errorf("no running pod found with selector %s", selector)- }- return pods.Items[0].Name, nil-}--// PortForward establishes a local connection to the remote sandbox pod over the given port.-// It returns a cleanup function the caller MUST execute when finished.-func (c *Client) PortForward(ctx context.Context, claimName, selector string, localPort, targetPort int) (cancelFunc func(), err error) {- ctx, cancel := context.WithCancel(ctx)-- // 1. Resolve sandbox name from the claim- sandboxName, err := c.ResolveSandboxName(ctx, claimName, 2*time.Minute)- if err != nil {- cancel()- return nil, fmt.Errorf("failed to resolve sandbox for claim %s: %w", claimName, err)- }-- // 2. Wait for Sandbox to be ready- waitCtx, waitCancel := context.WithTimeout(ctx, 2*time.Minute)- defer waitCancel()-- if err := c.WaitForSandboxReady(waitCtx, sandboxName); err != nil {- cancel()- return nil, fmt.Errorf("failed waiting for Sandbox %s to be ready: %w", sandboxName, err)- }-- // 3. Resolve sandbox status to get the label selector if not provided- if selector == "" {- resolvedSelector, _, err := c.ResolveSandboxStatus(ctx, sandboxName, 30*time.Second)- if err != nil {- cancel()- return nil, fmt.Errorf("failed to resolve sandbox status for %s: %w", sandboxName, err)- }- selector = resolvedSelector- }-- // 4. Find the specific running pod assigned to the claim- podName, err := c.findRunningPod(ctx, selector)- if err != nil {- cancel()- return nil, fmt.Errorf("failed to find running pod for %s: %w", claimName, err)- }-- // 5. Establish SPDY port-forward (no kubectl subprocess)- if err := c.forwardPortToPod(ctx, cancel, podName, localPort, targetPort); err != nil {- cancel()- return nil, err- }-- return cancel, nil-}--// PortForwardRouter establishes a local connection to the Sandbox Router service.-func (c *Client) PortForwardRouter(ctx context.Context, localPort, targetPort int) (cancelFunc func(), err error) {- ctx, cancel := context.WithCancel(ctx)-- routerPodName, err := c.waitForRouterPod(ctx, 2*time.Minute)- if err != nil {- cancel()- return nil, fmt.Errorf("failed waiting for sandbox-router to be ready: %w", err)- }-- if err := c.forwardPortToPod(ctx, cancel, routerPodName, localPort, targetPort); err != nil {- cancel()- return nil, err- }-- return cancel, nil-}--// waitForPod watches for a Ready pod matching the given selector.-func (c *Client) waitForPod(ctx context.Context, selector string, timeout time.Duration) (string, error) {- ctx, cancel := context.WithTimeout(ctx, timeout)- defer cancel()-- // Check if already ready- pods, err := c.clientset.CoreV1().Pods(c.namespace).List(ctx, metav1.ListOptions{- LabelSelector: selector,- })- if err != nil {- return "", fmt.Errorf("failed to list pods with selector %s: %w", selector, err)- }- for _, pod := range pods.Items {- if isPodReady(&pod) {- return pod.Name, nil- }- }-- // Watch until one becomes Ready- watcher, err := c.clientset.CoreV1().Pods(c.namespace).Watch(ctx, metav1.ListOptions{- LabelSelector: selector,- })- if err != nil {- return "", fmt.Errorf("failed to watch pods with selector %s: %w", selector, err)- }- defer watcher.Stop()-- for event := range watcher.ResultChan() {- pod, ok := event.Object.(*corev1.Pod)- if !ok {- continue- }- if isPodReady(pod) {- return pod.Name, nil- }- }- return "", fmt.Errorf("timeout waiting for pod with selector %s to be ready", selector)-}--// waitForRouterPod watches for a Ready sandbox-router pod.-func (c *Client) waitForRouterPod(ctx context.Context, timeout time.Duration) (string, error) {- return c.waitForPod(ctx, routerLabelSelector, timeout)-}--func isPodReady(pod *corev1.Pod) bool {- for _, cond := range pod.Status.Conditions {- if cond.Type == corev1.PodReady && cond.Status == corev1.ConditionTrue {- return true- }- }- return false-}--// DeleteClaim deletes the SandboxClaim, releasing the sandbox back to the warm pool.-func (c *Client) DeleteClaim(ctx context.Context, claimName string) error {- return c.extClient.ExtensionsV1alpha1().SandboxClaims(c.namespace).- Delete(ctx, claimName, metav1.DeleteOptions{})-}--// WaitForSandbox wraps the name resolution, selector resolution, and readiness wait into a single call for callers.-func (c *Client) WaitForSandbox(ctx context.Context, claimName string) (string, error) {- sandboxName, err := c.ResolveSandboxName(ctx, claimName, 2*time.Minute)- if err != nil {- return "", fmt.Errorf("failed to resolve sandbox name: %w", err)- }-- selector, _, err := c.ResolveSandboxStatus(ctx, sandboxName, 30*time.Second)- if err != nil {- return "", fmt.Errorf("failed to resolve sandbox status: %w", err)- }-- if err := c.WaitForSandboxReady(ctx, sandboxName); err != nil {- log.Printf("Warning: failed waiting for Sandbox %s to be ready: %v", sandboxName, err)- }-- return selector, nil-}diff --git a/internal/experimental/k8s/sandboxclient/portforward.go b/internal/experimental/k8s/sandboxclient/portforward.godeleted file mode 100644index b922a93..0000000--- a/internal/experimental/k8s/sandboxclient/portforward.go+++ /dev/null@@ -1,72 +0,0 @@-// Copyright 2026 Google LLC-//-// Licensed under the Apache License, Version 2.0 (the "License");-// you may not use this file except in compliance with the License.-// You may obtain a copy of the License at-//-// http://www.apache.org/licenses/LICENSE-2.0-//-// Unless required by applicable law or agreed to in writing, software-// distributed under the License is distributed on an "AS IS" BASIS,-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-// See the License for the specific language governing permissions and-// limitations under the License.--package sandboxclient--import (- "bytes"- "context"- "fmt"- "net/http"- "time"-- "k8s.io/client-go/tools/portforward"- "k8s.io/client-go/transport/spdy"-)--// forwardPortToPod executes the low-level SPDY stream connection to forward ports.-func (c *Client) forwardPortToPod(ctx context.Context, cancel context.CancelFunc, podName string, localPort, targetPort int) error {- req := c.clientset.CoreV1().RESTClient().Post().- Resource("pods").- Namespace(c.namespace).- Name(podName).- SubResource("portforward")-- transport, upgrader, err := spdy.RoundTripperFor(c.restConfig)- if err != nil {- return fmt.Errorf("error creating round tripper: %w", err)- }-- dialer := spdy.NewDialer(upgrader, &http.Client{Transport: transport}, http.MethodPost, req.URL())-- readyChan := make(chan struct{})- ports := []string{fmt.Sprintf("%d:%d", localPort, targetPort)}-- var stdoutBuf bytes.Buffer- var stderrBuf bytes.Buffer-- pf, err := portforward.New(dialer, ports, ctx.Done(), readyChan, &stdoutBuf, &stderrBuf)- if err != nil {- return fmt.Errorf("error creating portforward: %w", err)- }-- errChan := make(chan error, 1)- go func() {- errChan <- pf.ForwardPorts()- }()-- timer := time.NewTimer(30 * time.Second)- defer timer.Stop()-- select {- case <-readyChan:- return nil- case err := <-errChan:- cancel()- return fmt.Errorf("port forwarding failed: %w", err)- case <-timer.C:- cancel()- return fmt.Errorf("timeout waiting for port-forward to be ready")- }-}diff --git a/internal/multi_test.go b/internal/multi_test.goindex 9663cd7..343d4fe 100644--- a/internal/multi_test.go+++ b/internal/multi_test.go@@ -89,7 +89,7 @@ func TestMulti(t *testing.T) {Description: "Converts text to uppercase",Agent: uppercaseAgent,}); err != nil {- t.Fatalf("Error registering sandbox agent: %v", err)+ t.Fatalf("Error registering uppercase agent: %v", err)}inputs := []*proto.Message{@@ -228,7 +228,7 @@ func (m *mockPlanner) Connect(ctx context.Context, conversationID string, execIDreturn err}- // Step 3: Remote -> Sandbox+ // Step 3: Remote -> Uppercaseif strings.HasPrefix(lastText, "Remote Prefix:") {inputs := append(start.Messages, &proto.Message{Role: "assistant",@@ -245,7 +245,7 @@ func (m *mockPlanner) Connect(ctx context.Context, conversationID string, execIDreturn err}- // Final step: Sandbox -> Done+ // Final step: Uppercase -> Doneif strings.Contains(lastText, "UPPERCASE") {return handler(&proto.AgentOutputs{Messages: []*proto.Message{{