cmd/kode-gopher | the CLI binary — subcommands exec and serve |
cmd/mcp-smoketest | programmatic MCP client; spawns kode-gopher serve (stdio or streamable HTTP) and exercises execute_go_code end-to-end; --offline runs the checks that need no Google credentials |
cmd/sandbox-server | the in-pod HTTP server (agent-sandbox runtime protocol on :8888), built into the sandbox image |
internal/mcp | MCP server + tool handlers (execute_go_code, gcp_auth_status, lookup_package_docs) |
internal/executor | Build/Run/Fetch phases over a sandbox.Session; bootstraps /app/go.mod from the prewarm lockfile |
internal/sandbox | our thin client over sigs.k8s.io/agent-sandbox; KubeContext + PerAttemptTimeout options; typed ErrSessionDead for retry-once at MCP layer |
internal/creds | unified Source interface: Materialize (files+env for the executor) + Identity (mode/type/email/project for gcp_auth_status), Forwarded, Minted, Service and OAuthUser impls |
internal/normalize | multi-file input; root vs subdirectory partitioning; same-package rewrite; optional extra_imports companion file |
internal/wrapper | the generated func main() shipped alongside snippets |
internal/curated | canonical list of GCP + k8s.io/client-go packages prewarmed in the sandbox image; go:generate drives prompts regen |
internal/prewarm | standalone Go module imported at image build to populate $GOCACHE; committed go.mod+go.sum pin versions |
internal/prompts | generated system.md (LLM system prompt) + description.go (execute_go_code tool description); regenerate via make prompts |
sandbox/Dockerfile | the sandbox image: Go toolchain, sandbox-server, prewarmed cache |
server/Dockerfile | the in-cluster server image: static kode-gopher on distroless, amd64 and arm64 |
manifests/base | kustomize base (kind-compatible): v1beta1 SandboxTemplate with network policy, SandboxWarmPool go-runtime-pool, per-namespace sandbox-router |
manifests/overlays/gke | GKE Autopilot overlay: gVisor + securityContext + pinned image + pool of 2 + C3-first ComputeClass + router lock-down |
manifests/overlays/gke-server | in-cluster kode-gopher (docs/design-in-cluster.md): Deployment, Role, Gateway with managed cert, network policy; gke-server-oauth adds Google sign-in. Deploy with scripts/deploy-gke-server.sh |
scripts/smoketest-kind.sh | local-kind direct-CLI verification |
scripts/smoketest-gke.sh | GKE Autopilot direct-CLI verification |
scripts/smoketest-mcp.sh | MCP-layer verification against either substrate |
scripts/smoketest-http.sh | in-cluster kode-gopher over streamable HTTP, including negative auth cases |
scripts/refresh-warm-pool.sh | replaces the warm pool's unclaimed sandboxes when they run an older image than the template (used by the deploy and kind scripts) |
dev/ci/e2e/kind.sh | CI's kind end-to-end test, no Google credentials: throwaway cluster, agent-sandbox, sandbox image, mcp-smoketest --offline over stdio and HTTP |
experiments/yaegi-poc | Slice 6 proof of concept (shelved) — Yaegi interpreter as an alternative runtime, plus the kg-difftest corpus that ruled it out |