Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

Bundle tfy-sandbox-server as optional chart dependency (#787)

Raman Tehlan6fcf427d6409
diff --git a/charts/trueforge/Chart.lock b/charts/trueforge/Chart.lock
index 2b8124b2f..468ccc306 100644
--- a/charts/trueforge/Chart.lock
+++ b/charts/trueforge/Chart.lock
@@ -5,5 +5,8 @@ dependencies:
- name: redis
repository: oci://registry-1.docker.io/bitnamicharts
version: 24.0.0
-digest: sha256:6a9a66cd177329b1829c9d3d79c6810b89f4394f0411c3cfcb78cba87ca057e7
-generated: "2026-08-05T20:23:02.606276+01:00"
+- name: tfy-sandbox-server
+ repository: oci://tfy.jfrog.io/tfy-helm
+ version: 0.3.3
+digest: sha256:4a1e8e592add0094b94177b0e5deea17ccec1efc034e4399176a9421e8fca0a7
+generated: "2026-09-17T18:47:27.221049+05:30"
diff --git a/charts/trueforge/Chart.yaml b/charts/trueforge/Chart.yaml
index 55fa4fa03..69317b1d4 100644
--- a/charts/trueforge/Chart.yaml
+++ b/charts/trueforge/Chart.yaml
@@ -4,7 +4,7 @@ description: TrueForge server (API + UI) served from a single container image.
type: application
# version / appVersion are maintained on main (bot chart-release PR or human).
# Publishing is gated by git tag charts/trueforge@<version> (must match version).
-version: "0.2.0-rc.10"
+version: "0.2.0-rc.11"
appVersion: "0.2.0-rc.12"
kubeVersion: ">=1.25.0-0"
home: https://truefoundry.com
@@ -28,3 +28,9 @@ dependencies:
version: "24.0.0"
repository: oci://registry-1.docker.io/bitnamicharts
condition: redis.enabled
+ # Dev sandbox server, deployed only when a parent chart enables it.
+ - name: tfy-sandbox-server
+ version: "0.3.3"
+ repository: oci://tfy.jfrog.io/tfy-helm
+ condition: truefoundry.devSandboxServerEnabled
+ alias: tfy-sandbox-server
diff --git a/charts/trueforge/templates/_helpers.tpl b/charts/trueforge/templates/_helpers.tpl
index e23acfe06..7e45f82d7 100644
--- a/charts/trueforge/templates/_helpers.tpl
+++ b/charts/trueforge/templates/_helpers.tpl
@@ -499,6 +499,21 @@ fields, wires bundled Postgres/Redis, optional OIDC, then server.extraEnv.
{{- $env = append $env (dict "name" "NODE_EXTRA_CA_CERTS" "value" "/etc/ssl/certs/ca-certificates.crt") -}}
{{- end -}}
+{{- /* Bundled dev sandbox server: point the app at the subchart's Service.
+ The subchart's fullname helper computes the name; it needs the
+ subchart's scope (its values live under our tfy-sandbox-server key)
+ and is only defined while the dependency is enabled - the same flag
+ that gates this block. */ -}}
+{{- if (.Values.truefoundry | default dict).devSandboxServerEnabled -}}
+{{- $sandbox := index .Values "tfy-sandbox-server" | default dict -}}
+{{- $sandboxSvc := $sandbox.service | default dict -}}
+{{- $sandboxHost := include "tfy-sandbox-server.fullname" (dict "Values" $sandbox "Chart" (dict "Name" "tfy-sandbox-server") "Release" .Release) -}}
+{{- $env = append $env (dict "name" "TRUEFOUNDRY_SANDBOX_ENABLED" "value" "true") -}}
+{{- $env = append $env (dict "name" "TRUEFOUNDRY_SANDBOX_PROVIDER" "value" "truefoundry") -}}
+{{- $env = append $env (dict "name" "TRUEFOUNDRY_SANDBOX_SERVER_URL" "value" (printf "http://%s:%v" $sandboxHost ($sandboxSvc.port | default 8080))) -}}
+{{- $env = append $env (dict "name" "TRUEFOUNDRY_SANDBOX_SETTINGS" "value" (dict "nats_bridge_url" (printf "ws://%s:%v" $sandboxHost ($sandboxSvc.natsBridgePort | default 4444)) | toJson)) -}}
+{{- end -}}
+
{{- /* env map: replace in place when the chart already emits the name, else
append. Keeps the pod spec free of duplicate env entries. */ -}}
{{- $overrides := .Values.env | default dict -}}
diff --git a/charts/trueforge/values.yaml b/charts/trueforge/values.yaml
index 78a78339f..3c4dc12eb 100644
--- a/charts/trueforge/values.yaml
+++ b/charts/trueforge/values.yaml
@@ -264,6 +264,15 @@ externalRedis:
masterName: ""
# string or valueFrom -> REDIS_SENTINEL_PASSWORD.
password: ""
+# --- Bundled dev sandbox server (tfy-sandbox-server subchart) -------------------
+# Managed by the parent chart; off for standalone installs. When true, the
+# subchart is deployed and the app gets TRUEFOUNDRY_SANDBOX_* env pointing at it.
+truefoundry:
+ devSandboxServerEnabled: false
+tfy-sandbox-server:
+ # Keeps the rendered names distinct from any other sandbox server in the
+ # namespace: <release>-trueforge-tfy-sandbox-server.
+ nameOverride: trueforge-tfy-sandbox-server
# Extra raw manifests deployed alongside the server, e.g. an Istio
# VirtualService, a Gateway, an Ingress, or a NetworkPolicy. Each entry is a