diff --git a/.github/workflows/fast-path.yml b/.github/workflows/fast-path.yml
index b83686d4..575ce445 100644
--- a/.github/workflows/fast-path.yml
+++ b/.github/workflows/fast-path.yml
@@ -749,6 +749,7 @@ jobs:
python3 ci/sessions-pipeline-scrub-engine/test_scrub_engine.py -v
python3 ci/pipeline-analytics/test_chart.py -v
python3 ci/control-analytics/test_chart.py -v
+ python3 ci/control-sharing/test_chart.py -v
python3 ci/operator-session-erase/test_chart.py -v
python3 ci/sessions-pipeline-s3-ledger/test_chart.py -v
python3 ci/history-upload/test_chart.py -v
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 3cdd587c..0edf490a 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -170,6 +170,7 @@ jobs:
python3 ci/sessions-pipeline-scrub-engine/test_scrub_engine.py -v
python3 ci/pipeline-analytics/test_chart.py -v
python3 ci/control-analytics/test_chart.py -v
+ python3 ci/control-sharing/test_chart.py -v
python3 ci/operator-session-erase/test_chart.py -v
python3 ci/sessions-pipeline-s3-ledger/test_chart.py -v
python3 ci/history-upload/test_chart.py -v
diff --git a/charts/agent-relay/Chart.lock b/charts/agent-relay/Chart.lock
index 6a1de246..efe98570 100644
--- a/charts/agent-relay/Chart.lock
+++ b/charts/agent-relay/Chart.lock
@@ -10,7 +10,7 @@ dependencies:
version: 0.8.52
- name: relay-control
repository: file://../relay-control
- version: 0.4.22
+ version: 0.4.23
- name: relay-webapp
repository: file://../relay-webapp
version: 0.2.8
@@ -35,5 +35,5 @@ dependencies:
- name: relaygate
repository: file://../relaygate
version: 0.1.10
-digest: sha256:ad3504a7f5e142fccd57d6512c8936dbfd9ce0647d8a65b647c5ab88ede640ea
-generated: "2026-11-19T19:13:06.938977005Z"
+digest: sha256:d7d43773a7cb4cdc235a7d085185d7c85c78c64b7ea86e6ad0fd35bc8a927c08
+generated: "2026-11-21T00:39:20.725542992-08:00"
diff --git a/charts/agent-relay/Chart.yaml b/charts/agent-relay/Chart.yaml
index f6d578d2..99c310a7 100644
--- a/charts/agent-relay/Chart.yaml
+++ b/charts/agent-relay/Chart.yaml
@@ -2,7 +2,7 @@ apiVersion: v2
name: agent-relay
description: Self-hosted Agent Relay messaging and sessions suite
type: application
-version: 0.7.67
+version: 0.7.68
appVersion: "0.1.0"
kubeVersion: ">=1.28.0-0"
annotations:
@@ -29,7 +29,7 @@ dependencies:
repository: file://../sessions-pipeline
condition: components.sessionsPipeline
- name: relay-control
- version: 0.4.22
+ version: 0.4.23
repository: file://../relay-control
condition: components.control
- name: relay-webapp
diff --git a/charts/agent-relay/values-eks-rds-native.yaml b/charts/agent-relay/values-eks-rds-native.yaml
index 75251864..c0c7358c 100644
--- a/charts/agent-relay/values-eks-rds-native.yaml
+++ b/charts/agent-relay/values-eks-rds-native.yaml
@@ -301,12 +301,12 @@ sessions-pipeline:
relay-control:
image:
- # Release image (public GHCR, relay-control 0.5.24, edad6432: #134 desktop
- # enrollment keys (migration 0050), #136 Grok Bot wake-ups (0051), #137 sender
- # receipts and grant-bound OAuth launches, #138 optional Ed25519 file feed
- # signer; publish run 43673082170).
+ # Release image (public GHCR, relay-control 0.5.35, b985c6f; publish run
+ # 44492248387, GitHub build-provenance attestation; FSL-1.1-ALv2). Adds
+ # Control migrations 0052-0077 over 0.5.24 (no operator step) and optional
+ # env only, including the deployment default sharing mode (#232).
repository: ghcr.io/agentworkforce/relay-control
- digest: sha256:d1b6ca95fab240a9d41208d83de3b1f4245408b0765038762f1c419ee60f43bc
+ digest: sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9
existingSecret: agent-relay-secrets
bootstrap:
# REQUIRED OVERRIDE: customer display name and first owner role mailbox.
diff --git a/charts/agent-relay/values-eks.yaml b/charts/agent-relay/values-eks.yaml
index b52125db..5c8cacba 100644
--- a/charts/agent-relay/values-eks.yaml
+++ b/charts/agent-relay/values-eks.yaml
@@ -239,15 +239,15 @@ sessions-pipeline:
relay-control:
fullnameOverride: relay-control
image:
- # Release image (public GHCR, relay-control 0.5.24, edad6432: #134 desktop
- # enrollment keys (migration 0050), #136 Grok Bot wake-ups (0051), #137 sender
- # receipts and grant-bound OAuth launches, #138 optional Ed25519 file feed
- # signer; publish run 43673082170).
+ # Release image (public GHCR, relay-control 0.5.35, b985c6f; publish run
+ # 44492248387, GitHub build-provenance attestation; FSL-1.1-ALv2). Adds
+ # Control migrations 0052-0077 over 0.5.24 (no operator step) and optional
+ # env only, including the deployment default sharing mode (#232).
# Reads EKS Pod Identity / IRSA credentials (Desktop-feed role) and
# supports the setup key and password sign-in without SMTP. Mirror it by
# digest to your registry and override repository.
repository: ghcr.io/agentworkforce/relay-control
- digest: sha256:d1b6ca95fab240a9d41208d83de3b1f4245408b0765038762f1c419ee60f43bc
+ digest: sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9
# The customer profile opts into the owner-only Usage page and qualified
# MCP agent launch. Remove launch if the enrolled owner/admin Desktop target
# fails its install-time lifecycle check; Usage remains independent.
diff --git a/charts/agent-relay/values-gcp-proof-live.yaml b/charts/agent-relay/values-gcp-proof-live.yaml
index 2cd81866..6008189f 100644
--- a/charts/agent-relay/values-gcp-proof-live.yaml
+++ b/charts/agent-relay/values-gcp-proof-live.yaml
@@ -10,10 +10,10 @@ relay-control:
nameOverride: relay-cloud-api
fullnameOverride: relay-cloud-api
image:
- # relay-control 0.5.24, edad6432 (publish run 43673082170). The session
+ # relay-control 0.5.35, b985c6f (publish run 44492248387). The session
# read handoff needs 0.5.1 or later and stays off unless enabled below.
# The earlier 17bdc78 proof build was only in the private proof registry.
- digest: sha256:d1b6ca95fab240a9d41208d83de3b1f4245408b0765038762f1c419ee60f43bc
+ digest: sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9
resources:
requests: { cpu: 25m, memory: 128Mi }
limits: { memory: 512Mi }
diff --git a/charts/agent-relay/values-gcp.yaml b/charts/agent-relay/values-gcp.yaml
index e1a6e8db..9a802811 100644
--- a/charts/agent-relay/values-gcp.yaml
+++ b/charts/agent-relay/values-gcp.yaml
@@ -380,13 +380,13 @@ sessions-pipeline:
relay-control:
fullnameOverride: relay-control
image:
- # Release image (public GHCR, relay-control 0.5.24, edad6432: #134 desktop
- # enrollment keys (migration 0050), #136 Grok Bot wake-ups (0051), #137 sender
- # receipts and grant-bound OAuth launches, #138 optional Ed25519 file feed
- # signer; publish run 43673082170).
+ # Release image (public GHCR, relay-control 0.5.35, b985c6f; publish run
+ # 44492248387, GitHub build-provenance attestation; FSL-1.1-ALv2). Adds
+ # Control migrations 0052-0077 over 0.5.24 (no operator step) and optional
+ # env only, including the deployment default sharing mode (#232).
# Mirror it by digest to your registry and override repository.
repository: ghcr.io/agentworkforce/relay-control
- digest: sha256:d1b6ca95fab240a9d41208d83de3b1f4245408b0765038762f1c419ee60f43bc
+ digest: sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9
database:
runtimeRole: control_api_runtime
# Non-secret id of the encryption key (SELFHOST_ENCRYPTION_KEY_ID), stored
diff --git a/charts/agent-relay/values-kind-core.yaml b/charts/agent-relay/values-kind-core.yaml
index d2b0178d..74151bc5 100644
--- a/charts/agent-relay/values-kind-core.yaml
+++ b/charts/agent-relay/values-kind-core.yaml
@@ -24,9 +24,9 @@ global:
relay-control:
fullnameOverride: relay-control
image:
- # relay-control 0.5.24, edad6432 (publish run 43673082170).
+ # relay-control 0.5.35, b985c6f (publish run 44492248387).
repository: ghcr.io/agentworkforce/relay-control
- digest: sha256:d1b6ca95fab240a9d41208d83de3b1f4245408b0765038762f1c419ee60f43bc
+ digest: sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9
existingSecret: kind-control
publicUrl: https://relay.kind.agentrelay.com:8443
dashboardUrl: https://relay.kind.agentrelay.com:8443
diff --git a/charts/relay-control/Chart.yaml b/charts/relay-control/Chart.yaml
index 5f250b1c..79dfdafa 100644
--- a/charts/relay-control/Chart.yaml
+++ b/charts/relay-control/Chart.yaml
@@ -2,7 +2,7 @@ apiVersion: v2
name: relay-control
description: Self-hosted Agent Relay control-plane API for messaging and sessions
type: application
-version: 0.4.22
+version: 0.4.23
appVersion: "0.1.0"
kubeVersion: ">=1.28.0-0"
annotations:
diff --git a/charts/relay-control/README.md b/charts/relay-control/README.md
index 72c6e9f5..ec2e8407 100644
--- a/charts/relay-control/README.md
+++ b/charts/relay-control/README.md
@@ -25,7 +25,7 @@ The image must contain the compiled `relay-control` package. The server runs
built before the rename, set `server.args` and `migrations.args` to its
`node_modules/@cloud/selfhost-api/dist/` paths.
-The default image is `ghcr.io/agentworkforce/relay-control` 0.5.24. The session
+The default image is `ghcr.io/agentworkforce/relay-control` 0.5.35. The session
read handoff and MCP reads (`services.sessionReadApi*`,
`secretKeys.sessionReadApiSecret`) need 0.5.1 or later, which this pin
satisfies; they still stay off by default. `secretKeys.introspectSecret` and
diff --git a/charts/relay-control/templates/_helpers.tpl b/charts/relay-control/templates/_helpers.tpl
index 577604ed..e40d90f7 100644
--- a/charts/relay-control/templates/_helpers.tpl
+++ b/charts/relay-control/templates/_helpers.tpl
@@ -65,6 +65,19 @@ check what is rendered, including the gate-only SESSION_READ_API_URL. */ -}}
{{- if ne (len .Values.selectedFeatures) (len (uniq .Values.selectedFeatures)) }}{{ fail "selectedFeatures must not contain duplicates" }}{{ end -}}
{{- range .Values.selectedFeatures }}{{ if not (has . (list "flows" "relayfile" "chief" "usage" "launch" "usage_people")) }}{{ fail "selectedFeatures contains an unknown optional component" }}{{ end }}{{ end -}}
{{- end -}}
+{{- $sharing := .Values.sharing -}}
+{{- if kindIs "invalid" $sharing }}{{ $sharing = dict }}{{ end -}}
+{{- if not (kindIs "map" $sharing) }}{{ fail "sharing must be a map" }}{{ end -}}
+{{- /* Type checks come before any default: Sprig's default treats false, 0 and empty values as absent. */ -}}
+{{- $mode := $sharing.defaultMode -}}
+{{- if kindIs "invalid" $mode }}{{ $mode = "" }}{{ end -}}
+{{- if not (kindIs "string" $mode) }}{{ fail "sharing.defaultMode must be a string: all, new or selected" }}{{ end -}}
+{{- if and $mode (not (has $mode (list "all" "new" "selected"))) }}{{ fail (printf "sharing.defaultMode must be all, new or selected, not %q" $mode) }}{{ end -}}
+{{- $roles := $sharing.overrideRoles -}}
+{{- if kindIs "invalid" $roles }}{{ $roles = list }}{{ end -}}
+{{- if not (kindIs "slice" $roles) }}{{ fail "sharing.overrideRoles must be a list of roles: owner, admin" }}{{ end -}}
+{{- if ne (len $roles) (len (uniq $roles)) }}{{ fail "sharing.overrideRoles must not contain duplicates" }}{{ end -}}
+{{- range $roles }}{{ if not (has . (list "owner" "admin")) }}{{ fail (printf "sharing.overrideRoles: %v is not owner or admin" .) }}{{ end }}{{ end -}}
{{- if ne (int .Values.replicaCount) 1 }}{{ fail "replicaCount must be 1: the self-host API pilot has process-local login/device rate limits and is not HA" }}{{ end -}}
{{- if not .Values.existingSecret }}{{ fail "existingSecret is required; inline credentials are not supported" }}{{ end -}}
{{- if not (kindIs "bool" .Values.services.relayauthEnabled) }}{{ fail "services.relayauthEnabled must be a boolean" }}{{ end -}}
@@ -130,6 +143,8 @@ the chart already sets, including duplicates inside extraEnv. */ -}}
"RELAYHISTORY_BACKEND" "SESSION_ERASE_API_URL" "SESSION_ERASE_API_SECRET" -}}
{{- if not (kindIs "invalid" .Values.selectedFeatures) }}{{ $managed = append $managed "SELFHOST_FEATURES" }}{{ end -}}
{{- if .Values.services.relayhistoryReadApiUrl }}{{ $managed = concat $managed (list "RELAYHISTORY_READ_API_URL" "RELAYHISTORY_READ_API_EVENTS") }}{{ end -}}
+{{- /* The sharing.* values own these names whether or not they are set, so extraEnv cannot shadow or duplicate them. */ -}}
+{{- $managed = concat $managed (list "SELFHOST_DEFAULT_SHARING_MODE" "SELFHOST_SHARING_MODE_OVERRIDE_ROLES") -}}
{{- if (.Values.postgresCa | default dict).enabled }}{{ $managed = append $managed "NODE_EXTRA_CA_CERTS" }}{{ end -}}
{{- if .Values.desktopFeed.signingKeys.existingSecret }}{{ $managed = concat $managed (list "SELFHOST_DESKTOP_FEED_SIGNER" "SELFHOST_DESKTOP_FEED_KEY_FILES") }}{{ end -}}
{{- range $name := $managed }}{{ if hasSuffix "_FILE" $name }}{{ $managed = append $managed (trimSuffix "_FILE" $name) }}{{ end }}{{ end -}}
diff --git a/charts/relay-control/templates/deployment.yaml b/charts/relay-control/templates/deployment.yaml
index bed58c55..e602ae6f 100644
--- a/charts/relay-control/templates/deployment.yaml
+++ b/charts/relay-control/templates/deployment.yaml
@@ -102,6 +102,14 @@ spec:
{{- if .Values.sessionErasureApi.enabled }}
{{- include "relay-control.sessionErasureApiEnv" . | nindent 12 }}
{{- end }}
+ {{- with (.Values.sharing | default dict) }}
+ {{- with .defaultMode }}
+ - { name: SELFHOST_DEFAULT_SHARING_MODE, value: {{ . | quote }} }
+ {{- end }}
+ {{- with .overrideRoles }}
+ - { name: SELFHOST_SHARING_MODE_OVERRIDE_ROLES, value: {{ join "," . | quote }} }
+ {{- end }}
+ {{- end }}
{{- if .Values.introspection.existingSecret }}
- { name: RELAYCONTROL_INTROSPECT_SECRET_FILE, value: /var/run/agent-relay/introspection/secret }
{{- end }}
diff --git a/charts/relay-control/values.yaml b/charts/relay-control/values.yaml
index efa1c3af..f82264b4 100644
--- a/charts/relay-control/values.yaml
+++ b/charts/relay-control/values.yaml
@@ -2,15 +2,15 @@
# replica is enforced; this chart does not claim HA.
replicaCount: 1
image:
- # relay-control 0.5.24, edad6432 (#134 desktop enrollment keys/migration
- # 0050, #136 Grok Bot wake-ups/0051, #137 sender receipts and grant-bound
- # OAuth launches, #138 optional Ed25519 file feed signer). Published at
- # ghcr.io/agentworkforce/relay-control:0.5.24 by publish run 43673082170 with
- # a GitHub build-provenance attestation; never pin a digest that is not
+ # relay-control 0.5.35, b985c6f (migrations 0052-0077 over 0.5.24, no
+ # operator step; #232 deployment default sharing mode, see sharing below;
+ # optional env only). Published at ghcr.io/agentworkforce/relay-control:0.5.35
+ # by publish run 44492248387 with a GitHub build-provenance attestation.
+ # License FSL-1.1-ALv2 from 0.5.28 on. Never pin a digest that is not
# published under this name. Mirror by digest to your registry and override
# repository if needed.
repository: ghcr.io/agentworkforce/relay-control
- digest: sha256:d1b6ca95fab240a9d41208d83de3b1f4245408b0765038762f1c419ee60f43bc
+ digest: sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9
pullPolicy: IfNotPresent
imagePullSecrets: []
nameOverride: ""
@@ -362,6 +362,16 @@ sessionErasureApi:
existingSecret: ""
secretKey: SESSION_ERASE_API_SECRET
+# Deployment default for session sharing. Both unset by default, which keeps
+# Control's built-in behaviour. Needs a Control image that implements them;
+# an image without it ignores the variables.
+sharing:
+ # SELFHOST_DEFAULT_SHARING_MODE: "" (unset) | all | new | selected.
+ defaultMode: ""
+ # SELFHOST_SHARING_MODE_OVERRIDE_ROLES: workspace roles that may change the
+ # mode, from [owner, admin], e.g. [owner]. Empty: unset.
+ overrideRoles: []
+
# Token introspection audiences (SELFHOST_INTROSPECT_AUDIENCES): http(s)
# origins a token may be introspected for. Empty uses
# services.relayhistoryPublicUrl. Add the read API's exact READ_API_ORIGIN when
diff --git a/ci/agent-relay/subdomain-golden.sha256 b/ci/agent-relay/subdomain-golden.sha256
index c1406b73..d5b61c33 100644
--- a/ci/agent-relay/subdomain-golden.sha256
+++ b/ci/agent-relay/subdomain-golden.sha256
@@ -1,11 +1,11 @@
# helm v4.3.1
-c71a7948f27bd5a9df7dd91ec77bd0e4bb6da2144672f3d63af49e35138f2e93 eks-rds-native.yaml
-144ca65adee66eade341241629904deb2333d07d6e6a73020229fb3ee29ef600 gcp-durable-actors.yaml
+941bb496b6157cb53fe7cec6d741e6bc33a911ad5285c654472201d21610e300 eks-rds-native.yaml
+f871b9f52ccd0219b908829864db2efb1ac737a0daae529c5ed7c1d61d7f41b9 gcp-durable-actors.yaml
0fafdd5840024ad47d585d159cc9d691f257bccbafa465aec99cbb6e2f598a3e gcp-proof-flows.yaml
6f23e1d3e9eae71754aa5c8ed0a9f67372a5ce1819a969e163684baaa6c43b32 gcp-proof-live.yaml
66912be89079b82f54baf9252f143e82fab8cc38062c12052985f70471d120f6 gcp-proof.yaml
-27d9fdb88972af2ea6a12e5fcc4350a0ab05bdaa786e608af835202b79a05663 gcp-supported-100.yaml
-746894290d46885f64616f7c6e7e22e9a50386f7e6776f62828103e5075e9eae gcp.yaml
+095fe8be4c537265648994a239a66b347a990856352eed9eab650dfd308c2d83 gcp-supported-100.yaml
+1912d2850db9d3101b5e1c9c319a65ed895c02adc81e92f251bd2215657d341f gcp.yaml
3e3f87fde30fafb454dad5c0d4d935cde221ef8e2d3210ed242e77f04da94f56 kind-durable-actors.yaml
fdc618e39628ef38a9cdb1f323a7e92d167573b84872079f986c01a7dc4fc963 relay-control.yaml
dfb644a6f10249294131293d9764e2384dd9a1f366425ee5d25d970feb111d32 relay-webapp.yaml
diff --git a/ci/agent-relay/test_native_no_relayauth.py b/ci/agent-relay/test_native_no_relayauth.py
index 2ff889ac..bd5456c7 100644
--- a/ci/agent-relay/test_native_no_relayauth.py
+++ b/ci/agent-relay/test_native_no_relayauth.py
@@ -334,7 +334,7 @@ def test_gcp_native_profile_routes_reader_ingest_and_postgres_search(self):
self.assertIn('agent-relay-read-api', services)
self.assertEqual(
deployments['relay-control']['spec']['template']['spec']['containers'][0]['image'],
- 'ghcr.io/agentworkforce/relay-control@sha256:d1b6ca95fab240a9d41208d83de3b1f4245408b0765038762f1c419ee60f43bc')
+ 'ghcr.io/agentworkforce/relay-control@sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9')
self.assertEqual(
deployments['relay-webapp']['spec']['template']['spec']['containers'][0]['image'],
'ghcr.io/agentworkforce/relay-webapp@sha256:da0cc80476eac734299c0c6ceb94e2bca7dae7913cce56a8ca8592cf086dd02e')
@@ -369,7 +369,7 @@ def test_umbrella_overlay_renders_without_relayauth_or_history(self):
webapp_deploy = next(doc for doc in docs if doc.get('kind') == 'Deployment' and doc['metadata']['name'] == 'relay-webapp')
self.assertEqual(
control_deploy['spec']['template']['spec']['containers'][0]['image'],
- 'ghcr.io/agentworkforce/relay-control@sha256:d1b6ca95fab240a9d41208d83de3b1f4245408b0765038762f1c419ee60f43bc')
+ 'ghcr.io/agentworkforce/relay-control@sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9')
self.assertEqual(
webapp_deploy['spec']['template']['spec']['containers'][0]['image'],
'ghcr.io/agentworkforce/relay-webapp@sha256:da0cc80476eac734299c0c6ceb94e2bca7dae7913cce56a8ca8592cf086dd02e')
diff --git a/ci/control-sharing/test_chart.py b/ci/control-sharing/test_chart.py
new file mode 100644
index 00000000..4fed97b5
--- /dev/null
+++ b/ci/control-sharing/test_chart.py
@@ -0,0 +1,83 @@
+"""Deployment default session-sharing mode for self-hosted Control."""
+from pathlib import Path
+import subprocess
+import tempfile
+import unittest
+
+import yaml
+
+ROOT = Path(__file__).resolve().parents[2]
+NAMES = ("SELFHOST_DEFAULT_SHARING_MODE", "SELFHOST_SHARING_MODE_OVERRIDE_ROLES")
+
+
+class ControlSharing(unittest.TestCase):
+ def render(self, sharing=None, umbrella=False, fail=None, extra_env=None):
+ v = yaml.safe_load((ROOT / "charts/relay-control/ci/default-values.yaml").read_text())
+ if sharing is not None:
+ v["sharing"] = sharing
+ if extra_env is not None:
+ v["extraEnv"] = extra_env
+ chart = "relay-control"
+ if umbrella:
+ chart = "agent-relay"
+ components = {k: False for k in yaml.safe_load((ROOT / "charts/agent-relay/values.yaml").read_text())["components"]}
+ components["control"] = True
+ v.setdefault("services", {}).setdefault("relayhistoryBackend", "legacy")
+ v = {"components": components, "relay-control": v}
+ with tempfile.TemporaryDirectory() as folder:
+ p = Path(folder) / "values.yaml"
+ p.write_text(yaml.safe_dump(v))
+ r = subprocess.run(["helm", "template", "ci", str(ROOT / "charts" / chart), "-n", "ci", "-f", str(p)],
+ text=True, capture_output=True)
+ if fail:
+ self.assertNotEqual(r.returncode, 0, r.stdout[-500:])
+ self.assertIn(fail.lower(), r.stderr.lower())
+ return None
+ self.assertEqual(r.returncode, 0, r.stderr)
+ for doc in yaml.safe_load_all(r.stdout):
+ if doc and doc.get("kind") == "Deployment" and "control" in doc["metadata"]["name"] and "webapp" not in doc["metadata"]["name"]:
+ api = next(c for c in doc["spec"]["template"]["spec"]["containers"] if c["name"] == "api")
+ return {e["name"]: e.get("value") for e in api["env"] if e["name"] in NAMES}
+ self.fail("no Control Deployment rendered")
+
+ def test_unset_by_default(self):
+ self.assertEqual(self.render(), {})
+ self.assertEqual(self.render({"defaultMode": "", "overrideRoles": []}), {})
+
+ def test_set_renders_env(self):
+ self.assertEqual(self.render({"defaultMode": "selected", "overrideRoles": ["owner"]}),
+ {"SELFHOST_DEFAULT_SHARING_MODE": "selected", "SELFHOST_SHARING_MODE_OVERRIDE_ROLES": "owner"})
+ self.assertEqual(self.render({"defaultMode": "all"}), {"SELFHOST_DEFAULT_SHARING_MODE": "all"})
+ self.assertEqual(self.render({"overrideRoles": ["owner", "admin"]}),
+ {"SELFHOST_SHARING_MODE_OVERRIDE_ROLES": "owner,admin"})
+
+ def test_umbrella(self):
+ self.assertEqual(self.render({"defaultMode": "new", "overrideRoles": ["admin"]}, umbrella=True),
+ {"SELFHOST_DEFAULT_SHARING_MODE": "new", "SELFHOST_SHARING_MODE_OVERRIDE_ROLES": "admin"})
+
+ def test_invalid_refused(self):
+ for sharing, msg in [
+ ({"defaultMode": "everyone"}, "sharing.defaultMode must be all, new or selected"),
+ ({"defaultMode": "All"}, "sharing.defaultMode must be all, new or selected"),
+ ({"defaultMode": True}, "sharing.defaultMode must be a string"),
+ ({"overrideRoles": "owner"}, "sharing.overrideRoles must be a list"),
+ ({"overrideRoles": ["member"]}, "is not owner or admin"),
+ ({"overrideRoles": ["owner", "owner"]}, "must not contain duplicates"),
+ ({"defaultMode": False}, "sharing.defaultMode must be a string"),
+ ({"defaultMode": 0}, "sharing.defaultMode must be a string"),
+ ({"overrideRoles": False}, "sharing.overrideRoles must be a list"),
+ ({"overrideRoles": {}}, "sharing.overrideRoles must be a list"),
+ ("selected", "sharing must be a map"),
+ ]:
+ with self.subTest(sharing=sharing):
+ self.render(sharing, fail=msg)
+
+ def test_extra_env_cannot_set_sharing_names(self):
+ for name in NAMES:
+ for sharing in (None, {"defaultMode": "selected", "overrideRoles": ["owner"]}):
+ with self.subTest(name=name, sharing=sharing):
+ self.render(sharing, extra_env=[{"name": name, "value": "all"}], fail=name)
+
+
+if __name__ == "__main__":
+ unittest.main()
diff --git a/docs/self-hosted-image-supply-chain.md b/docs/self-hosted-image-supply-chain.md
index 6fc890a6..73e16178 100644
--- a/docs/self-hosted-image-supply-chain.md
+++ b/docs/self-hosted-image-supply-chain.md
@@ -52,7 +52,7 @@ The audit checked:
| `ghcr.io/agentworkforce/96bulls-services@sha256:070fe6fd46ecd1e1f9db32ff22379f6df9b9e6c4d48ede5312c8fb986a95f3a9` | Four Sessions Deployments and migration Job | [`AgentWorkforce/sessions-pipeline`](https://github.com/AgentWorkforce/sessions-pipeline) `main` `f1c2672581b6f88d26d0549b4d1cb78fce0d5f16` (origin-bound courier assertions, #204) | Apache-2.0 | Registry-verified anonymously, `linux/amd64`, `linux/arm64` | Approval-gated [workflow](https://github.com/AgentWorkforce/sessions-pipeline/blob/f1c2672581b6f88d26d0549b4d1cb78fce0d5f16/.github/workflows/publish-image.yml), [run](https://github.com/AgentWorkforce/sessions-pipeline/actions/runs/41796259208); SBOM and max-mode provenance (the GitHub attestation step failed on the private repository); public. Its first migrate needs the HoopDb role bootstraps shipped in the image (see the agent-relay 0.3.11 release notes) | Approved |
| `ghcr.io/cloudnative-pg/postgresql@sha256:ed6923f9ba2399cf9070379a353c710c29ced8a294be73986a2c3dae7e599ce3` | Sessions migration `wait-for-role` init container | Public [`cloudnative-pg/postgres-containers`](https://github.com/cloudnative-pg/postgres-containers) `4c2710a78328becdadf708ca6d9cb3fb61f3f5ee` (the image's revision label and its SLSA provenance both name it) | Apache-2.0 packaging; PostgreSQL License | Registry-verified `linux/amd64`, `linux/arm64` | Upstream [`bake_targets.yml`](https://github.com/cloudnative-pg/postgres-containers/blob/4c2710a78328becdadf708ca6d9cb3fb61f3f5ee/.github/workflows/bake_targets.yml), [run 40291448784](https://github.com/cloudnative-pg/postgres-containers/actions/runs/40291448784); SPDX SBOM and SLSA v1 attestation manifests; keyless cosign signature verified with `--certificate-github-workflow-sha 4c2710a…` | Approved (third party) |
| `ghcr.io/agentworkforce/relayhistory@sha256:d3166bb14e1d6043426a4dd8cc05408b94574c8d79ad5fd6e789e0de00ab371b` | RelayHistory Deployment and migration Job | [`AgentWorkforce/relayhistory-cloud`](https://github.com/AgentWorkforce/relayhistory-cloud) `main` `53c333349cb9210832013cd3a2423f5f19062d36` | Apache-2.0 | Registry-verified anonymously, `linux/amd64`, `linux/arm64` | Reviewed [workflow](https://github.com/AgentWorkforce/relayhistory-cloud/blob/53c333349cb9210832013cd3a2423f5f19062d36/.github/workflows/container.yml), [run](https://github.com/AgentWorkforce/relayhistory-cloud/actions/runs/41773941051); SBOM and max-mode provenance (the GitHub attestation step failed on the private repository); public | Approved |
-| `ghcr.io/agentworkforce/relay-control@sha256:d1b6ca95fab240a9d41208d83de3b1f4245408b0765038762f1c419ee60f43bc` | Control API Deployment and migration Job | [`AgentWorkforce/relay-control`](https://github.com/AgentWorkforce/relay-control) `main` `edad6432b07ac9997fb7af9c29999b52c81e0c5a` (0.5.24) | Apache-2.0 | Registry-verified anonymously, `linux/amd64`, `linux/arm64` | [Workflow](https://github.com/AgentWorkforce/relay-control/blob/edad6432b07ac9997fb7af9c29999b52c81e0c5a/.github/workflows/release-relay-control-image.yml), [run](https://github.com/AgentWorkforce/relay-control/actions/runs/43673082170): validate and build/publish jobs green, GitHub build-provenance attestation verified with `gh attestation verify` (source ref `refs/heads/main`); public GHCR digest | Approved |
+| `ghcr.io/agentworkforce/relay-control@sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9` | Control API Deployment and migration Job | [`AgentWorkforce/relay-control`](https://github.com/AgentWorkforce/relay-control) `main` `b985c6f678ff37718a851d5f53c33a05e6a4c0a6` (0.5.35) | FSL-1.1-ALv2 ([LICENSE](https://github.com/AgentWorkforce/relay-control/blob/b985c6f678ff37718a851d5f53c33a05e6a4c0a6/LICENSE)) | Registry-verified anonymously, `linux/amd64`, `linux/arm64` | [Workflow](https://github.com/AgentWorkforce/relay-control/blob/b985c6f678ff37718a851d5f53c33a05e6a4c0a6/.github/workflows/release-relay-control-image.yml), [run 44492248387](https://github.com/AgentWorkforce/relay-control/actions/runs/44492248387); GitHub build-provenance attestation verified with `gh attestation verify` (source ref `refs/heads/main`, digest b985c6f); public GHCR digest | Approved |
| `ghcr.io/agentworkforce/relay-dashboard@sha256:c50005fcdd1fc5ab5ef3dac9b621db8e0c7e03480406bfe519743ae435d8f1ad` | Dashboard init and application containers | [`AgentWorkforce/relay-dashboard`](https://github.com/AgentWorkforce/relay-dashboard) `main` `e5003d05bab52cb782e982ac44149b891f6e67d0` | Apache-2.0 | Registry-verified anonymously, `linux/amd64`, `linux/arm64` | Reviewed [workflow](https://github.com/AgentWorkforce/relay-dashboard/blob/e5003d05bab52cb782e982ac44149b891f6e67d0/.github/workflows/container.yml), [run](https://github.com/AgentWorkforce/relay-dashboard/actions/runs/41809435279); SPDX SBOM, max-mode provenance and a GitHub build-provenance attestation; public | Approved |
`relay-dashboard` intentionally appears twice in the rendered Pod (an init
diff --git a/docs/self-hosted-requirements.md b/docs/self-hosted-requirements.md
index 0a55261d..f7af78b9 100644
--- a/docs/self-hosted-requirements.md
+++ b/docs/self-hosted-requirements.md
@@ -14,7 +14,7 @@ registered, every shipped entry must exist in the charts, planned entries must
not be referenced by any template, and the compatibility matrix must equal
the pinned digests.
-Source of truth: [`self-hosted/requirements.yaml`](../self-hosted/requirements.yaml). 203 entries: 55 requirements (55 shipped, 0 planned), 148 options (147 shipped, 1 planned).
+Source of truth: [`self-hosted/requirements.yaml`](../self-hosted/requirements.yaml). 204 entries: 55 requirements (55 shipped, 0 planned), 149 options (148 shipped, 1 planned).
## Contents
@@ -170,7 +170,8 @@ Services image (sessions-pipeline-worker, alleyoop and the privileged SQL Jobs):
| relayauth-0.1.2 | shipped | relayauth 0.1.2 | relayauth: `ghcr.io/agentworkforce/relayauth@sha256:c23c92d25fdf…` | | | License-annotation patch bump of 0.1.1. Superseded by 0.1.3. |
| relayauth-0.1.1 | shipped | relayauth 0.1.1 | relayauth: `ghcr.io/agentworkforce/relayauth@sha256:c23c92d25fdf…` | | | relayauth 784582ef (machine-bound History assertion contract, relayauth #113). Superseded by 0.1.2. |
| relayauth-0.1.0 | shipped | relayauth 0.1.0 | relayauth: `ghcr.io/agentworkforce/relayauth@sha256:eb71daa28e30…` | | | superseded by 0.1.1. |
-| agent-relay-0.7.67 | unreleased | agent-relay 0.7.67
relay-control 0.4.22
relay-webapp 0.2.8
(deps: relaycast 0.3.16, relayauth 0.1.5, sessions-pipeline 0.8.52, relay-control 0.4.22, relay-webapp 0.2.8, relayflows 0.2.5, durable-actors 0.14.6-awf.4, relayfile 0.2.2, telemetry-collector 0.1.7, relay-chief 0.1.0, slack-relay 0.3.11, relaygate 0.1.10) | relaycast: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
relaycast-postgres: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
sessions-pipeline-worker: `ghcr.io/agentworkforce/sessions-pipeline@sha256:e51749eb2b7c…`
relay-control: `ghcr.io/agentworkforce/relay-control@sha256:d1b6ca95fab2…`
relay-webapp: `ghcr.io/agentworkforce/relay-webapp@sha256:bd295ccb7d13…` | | | Carries 0.7.66 and sessions-pipeline 0.8.52. relay-webapp 0.2.8 adds dashboard-origin MCP and OAuth discovery/consent prefixes to the leaf and shared GKE routes, EKS script, chart-rendered EKS controlPaths default and Azure example. Confirmed against Control 0.5.24 source edad6432; images unchanged. GKE reuses the api BackendConfig with 11 dashboard paths, or 12 in single-host mode. EKS equivalence tests cover the expanded default and explicitly pinned legacy lists. No live install or client sign-in proof. |
+| agent-relay-0.7.68 | unreleased | agent-relay 0.7.68
relay-control 0.4.23
relay-webapp 0.2.8
(deps: relaycast 0.3.16, relayauth 0.1.5, sessions-pipeline 0.8.52, relay-control 0.4.23, relay-webapp 0.2.8, relayflows 0.2.5, durable-actors 0.14.6-awf.4, relayfile 0.2.2, telemetry-collector 0.1.7, relay-chief 0.1.0, slack-relay 0.3.11, relaygate 0.1.10) | relaycast: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
relaycast-postgres: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
sessions-pipeline-worker: `ghcr.io/agentworkforce/sessions-pipeline@sha256:e51749eb2b7c…`
relay-control: `ghcr.io/agentworkforce/relay-control@sha256:1cb5bd714e7c…`
relay-webapp: `ghcr.io/agentworkforce/relay-webapp@sha256:bd295ccb7d13…` | | | Carries 0.7.67. relay-control 0.4.23: the chart default and the EKS, EKS RDS-native, GCP, gcp-proof-live and kind-core profiles move to Control 0.5.35 (sha256:1cb5bd71, b985c6f, publish run 44492248387; migrations 0052-0077, no operator step, no new required env; license FSL-1.1-ALv2). New optional sharing.defaultMode (all, new, selected) and sharing.overrideRoles (owner, admin) render SELFHOST_DEFAULT_SHARING_MODE and SELFHOST_SHARING_MODE_OVERRIDE_ROLES, unset by default. The Control migration Job name follows the image, so it re-runs on upgrade. |
+| agent-relay-0.7.67 | **planned** | agent-relay 0.7.67
relay-control 0.4.22
relay-webapp 0.2.8
(deps: relaycast 0.3.16, relayauth 0.1.5, sessions-pipeline 0.8.52, relay-control 0.4.22, relay-webapp 0.2.8, relayflows 0.2.5, durable-actors 0.14.6-awf.4, relayfile 0.2.2, telemetry-collector 0.1.7, relay-chief 0.1.0, slack-relay 0.3.11, relaygate 0.1.10) | relaycast: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
relaycast-postgres: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
sessions-pipeline-worker: `ghcr.io/agentworkforce/sessions-pipeline@sha256:e51749eb2b7c…`
relay-control: `ghcr.io/agentworkforce/relay-control@sha256:d1b6ca95fab2…`
relay-webapp: `ghcr.io/agentworkforce/relay-webapp@sha256:bd295ccb7d13…` | | | Carries 0.7.66 and sessions-pipeline 0.8.52. relay-webapp 0.2.8 adds dashboard-origin MCP and OAuth discovery/consent prefixes to the leaf and shared GKE routes, EKS script, chart-rendered EKS controlPaths default and Azure example. Confirmed against Control 0.5.24 source edad6432; images unchanged. GKE reuses the api BackendConfig with 11 dashboard paths, or 12 in single-host mode. EKS equivalence tests cover the expanded default and explicitly pinned legacy lists. No live install or client sign-in proof. |
| agent-relay-0.7.66 | **planned** | agent-relay 0.7.66
relay-control 0.4.22
relay-webapp 0.2.7
(deps: relaycast 0.3.16, relayauth 0.1.5, sessions-pipeline 0.8.52, relay-control 0.4.22, relay-webapp 0.2.7, relayflows 0.2.5, durable-actors 0.14.6-awf.4, relayfile 0.2.2, telemetry-collector 0.1.7, relay-chief 0.1.0, slack-relay 0.3.11, relaygate 0.1.10) | relaycast: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
relaycast-postgres: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
sessions-pipeline-worker: `ghcr.io/agentworkforce/sessions-pipeline@sha256:e51749eb2b7c…`
relay-control: `ghcr.io/agentworkforce/relay-control@sha256:d1b6ca95fab2…`
relay-webapp: `ghcr.io/agentworkforce/relay-webapp@sha256:bd295ccb7d13…` | | | Carries 0.7.63. Opt-in EKS ALB edge: eksIngress.enabled (default false) renders the internet-facing ALB Ingress that scripts/selfhost/eks-alb-ingress.sh prints, option for option, plus eksIngress.controlPaths (default /cloud/api, /login, /relay-node). Refuses eksIngress with gkeIngress. ci/agent-relay/test_eks_alb_ingress.py proves deep equality with the script over the option matrix. Default renders differ only in chart labels; images unchanged. Not applied to any cluster. |
| agent-relay-0.7.63 | **planned** | agent-relay 0.7.63
relay-control 0.4.22
relay-webapp 0.2.7
(deps: relaycast 0.3.16, relayauth 0.1.5, sessions-pipeline 0.8.52, relay-control 0.4.22, relay-webapp 0.2.7, relayflows 0.2.5, durable-actors 0.14.6-awf.4, relayfile 0.2.2, telemetry-collector 0.1.7, relay-chief 0.1.0, slack-relay 0.3.11, relaygate 0.1.10) | relaycast: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
relaycast-postgres: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
sessions-pipeline-worker: `ghcr.io/agentworkforce/sessions-pipeline@sha256:e51749eb2b7c…`
relay-control: `ghcr.io/agentworkforce/relay-control@sha256:d1b6ca95fab2…`
relay-webapp: `ghcr.io/agentworkforce/relay-webapp@sha256:bd295ccb7d13…` | | | Carries 0.7.62 and sessions-pipeline 0.8.52. The GCP, EKS and EKS RDS-native profiles move the services image to relayhistory-pipeline efdd4bb2 (ghcr.io/agentworkforce/sessions-pipeline@sha256:e51749eb, publish run 44489159041; issue 610 Phase 3, staged reconcile and streaming on by default; with streaming.enabled=false and stagedReconcile unset the staged path resolves off). It vendors relayscrubber 0.5.0-alpha.9 under Khaliqs recorded OVERRIDE of the relayscrubber-lead security block (customer-images.yaml); alpha.10 replaces it when it passes. Upgrade pre-steps for an existing database: the bulls96_legacy_export_privacy role (re-run the modes migration-roles bootstrap from the image) and the 058000 index prebuild or one allowBlockingIndexBuild. 28 migrations plus HoopDb 0005/0006 run in the migrate Job; the indexer restarts until 062110 (and 062140 with output facts) are applied. License FSL-1.1-ALv2. No upgrade rehearsal from a 7e9b2f0f database yet. |
| agent-relay-0.7.62 | **planned** | agent-relay 0.7.62
relay-control 0.4.22
relay-webapp 0.2.7
(deps: relaycast 0.3.16, relayauth 0.1.5, sessions-pipeline 0.8.51, relay-control 0.4.22, relay-webapp 0.2.7, relayflows 0.2.5, durable-actors 0.14.6-awf.4, relayfile 0.2.2, telemetry-collector 0.1.7, relay-chief 0.1.0, slack-relay 0.3.11, relaygate 0.1.10) | relaycast: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
relaycast-postgres: `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af…`
sessions-pipeline-worker: `ghcr.io/agentworkforce/sessions-pipeline@sha256:77022c5b6a1d…`
relay-control: `ghcr.io/agentworkforce/relay-control@sha256:d1b6ca95fab2…`
relay-webapp: `ghcr.io/agentworkforce/relay-webapp@sha256:bd295ccb7d13…` | | | Carries 0.7.61 and sessions-pipeline 0.8.51. RDS migrate Jobs can select the name-agnostic separate-database preflight; fresh managed-database installs use the dedicated hoopdb_owner login and legacy upgrades can point migration/bootstrap Jobs at one short-lived Secret. |
@@ -1167,6 +1168,7 @@ chart `relay-control` · values [`ci/default-values.yaml`](../charts/relay-contr
| | option | choices | default here | maps to |
| --- | --- | --- | --- | --- |
| shipped | [CA bundle for verifying the Postgres server certificate (postgresCa)](#opt-postgres-ca-bundle) | `false`, `true` | `false` | values `worker.postgresCa.*`, `alleyoop.postgresCa.*`, `relay-control:postgresCa.*`, `relaychief-control:postgresCa.*`, `relayfile-control:postgresCa.*`; env `NODE_EXTRA_CA_CERTS`, `PGSSLROOTCERT` |
+| shipped | [Control deployment default session-sharing mode](#opt-relay-control-sharing-mode) | (no default), `all`, `new`, `selected` | (no default) | values `sharing.defaultMode`, `sharing.overrideRoles`; env `SELFHOST_DEFAULT_SHARING_MODE`, `SELFHOST_SHARING_MODE_OVERRIDE_ROLES` |
| shipped | [Control collector analytics adapter](#opt-relay-control-collector-analytics) | `false`, `true` | `false` | values `analytics.*`; env `SELFHOST_ANALYTICS_DESTINATION`, `SELFHOST_ANALYTICS_PROFILE`, `SELFHOST_ANALYTICS_DEPLOYMENT_ID`, `SELFHOST_ANALYTICS_COLLECTOR_URL`, `SELFHOST_ANALYTICS_COLLECTOR_TOKEN_FILE`, `SELFHOST_ANALYTICS_COLLECTOR_CA_FILE`; Secret `` keys `token` |
| shipped | [Control advertises relaygate under gate-only](#opt-relay-control-relaygate-public-url) | `off`, `on` | `off` | values `services.relaycastPublicUrl`; env `SELFHOST_RELAYGATE_PUBLIC_URL` |
| shipped | [Separate Control introspection credential Secret](#opt-relay-control-external-introspection-secret) | `disabled`, `enabled` | `disabled` | values `introspection.existingSecret`, `introspection.key`; env `RELAYCONTROL_INTROSPECT_SECRET_FILE`; Secret `` keys `introspect-secret` |
@@ -1217,6 +1219,7 @@ chart `agent-relay` · values [`values-gcp-proof.yaml`](../charts/agent-relay/va
| | option | choices | default here | maps to |
| --- | --- | --- | --- | --- |
| shipped | [CA bundle for verifying the Postgres server certificate (postgresCa)](#opt-postgres-ca-bundle) | `false`, `true` | `false` | values `worker.postgresCa.*`, `alleyoop.postgresCa.*`, `relay-control:postgresCa.*`, `relaychief-control:postgresCa.*`, `relayfile-control:postgresCa.*`; env `NODE_EXTRA_CA_CERTS`, `PGSSLROOTCERT` |
+| shipped | [Control deployment default session-sharing mode](#opt-relay-control-sharing-mode) | (no default), `all`, `new`, `selected` | (no default) | values `sharing.defaultMode`, `sharing.overrideRoles`; env `SELFHOST_DEFAULT_SHARING_MODE`, `SELFHOST_SHARING_MODE_OVERRIDE_ROLES` |
| shipped | [Control collector analytics adapter](#opt-relay-control-collector-analytics) | `false`, `true` | `false` | values `analytics.*`; env `SELFHOST_ANALYTICS_DESTINATION`, `SELFHOST_ANALYTICS_PROFILE`, `SELFHOST_ANALYTICS_DEPLOYMENT_ID`, `SELFHOST_ANALYTICS_COLLECTOR_URL`, `SELFHOST_ANALYTICS_COLLECTOR_TOKEN_FILE`, `SELFHOST_ANALYTICS_COLLECTOR_CA_FILE`; Secret `` keys `token` |
| shipped | [Control advertises relaygate under gate-only](#opt-relay-control-relaygate-public-url) | `off`, `on` | `off` | values `services.relaycastPublicUrl`; env `SELFHOST_RELAYGATE_PUBLIC_URL` |
| shipped | [Separate Control introspection credential Secret](#opt-relay-control-external-introspection-secret) | `disabled`, `enabled` | `disabled` | values `introspection.existingSecret`, `introspection.key`; env `RELAYCONTROL_INTROSPECT_SECRET_FILE`; Secret `` keys `introspect-secret` |
@@ -3084,6 +3087,27 @@ admit the labeled brief pod at the collector.
- Verify: Check brief-only analytics credentials, separate CA paths and restricted egress. Verify a real session_brief.tick_completed in the private collector files and an unchanged model admission limit.
- Sources: [`charts/sessions-pipeline-worker/templates/_brief-analytics.tpl`](../charts/sessions-pipeline-worker/templates/_brief-analytics.tpl), [`charts/sessions-pipeline-worker/templates/brief-analytics-networkpolicy.yaml`](../charts/sessions-pipeline-worker/templates/brief-analytics-networkpolicy.yaml)
+#### opt.relay-control.sharing-mode
+
+
+
+**Control deployment default session-sharing mode** · shipped · chart `relay-control` · profiles relay-control, agent-relay
+
+Optional deployment default for session sharing, with the workspace roles
+allowed to change it. Both unset by default, which keeps Control's
+built-in behaviour. defaultMode is one of all, new or selected;
+overrideRoles is a list from owner and admin. Any other value is refused
+at render, and Control refuses it at startup. Needs relay-control 0.5.35
+or later (the chart default).
+
+- Default: (no default)
+- Choices: (no default): Unset; Control's built-in behaviour.; `all`; `new`; `selected`
+- Provided by: operator
+- Values: `sharing.defaultMode`, `sharing.overrideRoles`
+- Env: `SELFHOST_DEFAULT_SHARING_MODE`, `SELFHOST_SHARING_MODE_OVERRIDE_ROLES`
+- Verify: Render default with neither variable; render defaultMode selected and overrideRoles [owner] and confirm both variables on the Control api container only; confirm the refusals for an unknown mode, a non-list or unknown role and duplicates.
+- Sources: [`charts/relay-control/templates/deployment.yaml:1`](../charts/relay-control/templates/deployment.yaml#L1), [`ci/control-sharing/test_chart.py:1`](../ci/control-sharing/test_chart.py#L1)
+
#### opt.relay-control.collector-analytics
diff --git a/self-hosted/customer-images.yaml b/self-hosted/customer-images.yaml
index 13244f9d..2d75d3b0 100644
--- a/self-hosted/customer-images.yaml
+++ b/self-hosted/customer-images.yaml
@@ -446,45 +446,42 @@ images:
- Deployment/relay-control:relay-control
current:
repository: ghcr.io/agentworkforce/relay-control
- digest: sha256:d1b6ca95fab240a9d41208d83de3b1f4245408b0765038762f1c419ee60f43bc
+ digest: sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9
chartStatus: shipped
source:
repository: https://github.com/AgentWorkforce/relay-control
- revision: edad6432b07ac9997fb7af9c29999b52c81e0c5a
+ revision: b985c6f678ff37718a851d5f53c33a05e6a4c0a6
path: Dockerfile
reproducibleReference: true
note: >-
- Relay Control 0.5.24: sender receipts and grant-bound OAuth launches
- (#137), the optional Ed25519 file feed signer (#138, new optional
- SELFHOST_DESKTOP_FEED_SIGNER/_KEY_FILES/_KEY_LABEL env, unused by the
- charts), Grok Bot webhook wake-ups (#136, migration 0051) and desktop
- enrollment keys (#134, migration 0050). Carries migrations 0043
- through 0049 from 0.5.17-0.5.23 and everything in 0.5.16: shared-session
- read auditing with an owner/admin export (#100, migration 0042), the
- bounded native provider transport (#101), the one-time first-admin
- setup key and admin-set temporary passwords with password sign-in
- that works without SMTP (#96, migration 0041), MCP agent launch behind
- SELFHOST_FEATURES=launch (#95), Desktop dashboard links redirected to
- the dashboard host (#97), Claude Code chat attestation (#98), the
- owner-only usage API (#92), EKS Pod Identity / IRSA credentials (#91)
- and direct-to-S3 History upload credentials (#90). The image Cmd is
- unchanged (node node_modules/relay-control/dist/server.js), so the
- chart's server.js and migrate-cli.js args still apply.
+ Relay Control 0.5.35: the deployment default session-sharing mode with
+ an owner override (#232; optional SELFHOST_DEFAULT_SHARING_MODE and
+ SELFHOST_SHARING_MODE_OVERRIDE_ROLES, rendered by sharing.*). Adds
+ migrations 0052-0065 and 0067-0077 over 0.5.24 with no operator step:
+ 0057 rewrites two small Desktop identity tables, 0074 backfills
+ use_count on exchanged enrollment tokens, 0073 validates a constraint
+ on admin_audit_events under a short lock, and the 0062 preflight cannot
+ fire on a 0.5.24 database. No new required env or Secrets (20 new
+ optional names; an invalid value refuses startup). History origins now
+ live in SELFHOST_RELAYHISTORY_AUDIENCES; a History origin left in
+ SELFHOST_INTROSPECT_AUDIENCES is ignored with a startup warning. The
+ image Cmd is unchanged (node node_modules/relay-control/dist/server.js),
+ so the chart's server.js and migrate-cli.js args still apply.
license:
status: approved
- spdx: Apache-2.0
- evidence: https://github.com/AgentWorkforce/relay-control/blob/edad6432b07ac9997fb7af9c29999b52c81e0c5a/LICENSE
+ spdx: FSL-1.1-ALv2
+ evidence: https://github.com/AgentWorkforce/relay-control/blob/b985c6f678ff37718a851d5f53c33a05e6a4c0a6/LICENSE
platforms:
expected: [linux/amd64, linux/arm64]
verifiedFromRegistry: [linux/amd64, linux/arm64]
status: verified
verificationAccess: anonymous
release:
- workflow: https://github.com/AgentWorkforce/relay-control/blob/edad6432b07ac9997fb7af9c29999b52c81e0c5a/.github/workflows/release-relay-control-image.yml
- run: https://github.com/AgentWorkforce/relay-control/actions/runs/43673082170
+ workflow: https://github.com/AgentWorkforce/relay-control/blob/b985c6f678ff37718a851d5f53c33a05e6a4c0a6/.github/workflows/release-relay-control-image.yml
+ run: https://github.com/AgentWorkforce/relay-control/actions/runs/44492248387
trigger: workflow_dispatch
buildsCommittedRevision: true
- publishedTags: ["0.5.24", sha-edad6432b07ac9997fb7af9c29999b52c81e0c5a]
+ publishedTags: ["0.5.35", sha-b985c6f678ff37718a851d5f53c33a05e6a4c0a6]
publishesSbom: true
publishesProvenance: true
provenanceMode: max-plus-github-attestation
@@ -494,11 +491,12 @@ images:
approval:
status: approved
basis: >-
- Public digest from the successful reviewed 0.5.24 release workflow at
+ Public digest from the successful reviewed 0.5.35 release workflow at
the recorded revision (validate and build/publish jobs green), with
SBOM, max-mode provenance, a GitHub build-provenance attestation
verified with gh attestation verify, and amd64+arm64 verified
- anonymously.
+ anonymously. License FSL-1.1-ALv2 (from 0.5.28) approved by Khaliq on
+ 2026-11-19 for self-hosted distribution.
blockingReasons: []
- id: relay-webapp
diff --git a/self-hosted/customer-release-evidence.json b/self-hosted/customer-release-evidence.json
index 62a2836e..81adb68f 100644
--- a/self-hosted/customer-release-evidence.json
+++ b/self-hosted/customer-release-evidence.json
@@ -111,7 +111,7 @@
"protected": false,
"requiredApprovals": 0
},
- "imageManifestSha256": "sha256:5fe8ae878f8c3ebeb735c6b995c11dd3d214c0fabe7453c527f7153ec68686df",
+ "imageManifestSha256": "sha256:82162eaa1decaa95302170a8b40d92d907731f54468253b760b92a6a674ae2bc",
"valuesFile": "charts/agent-relay/values-gcp.yaml"
},
"releaseDecision": "blocked",
diff --git a/self-hosted/requirements.yaml b/self-hosted/requirements.yaml
index f47ca328..79b2c1f6 100644
--- a/self-hosted/requirements.yaml
+++ b/self-hosted/requirements.yaml
@@ -2042,9 +2042,22 @@ compatibility:
images:
relayauth: { repository: ghcr.io/agentworkforce/relayauth, digest: sha256:eb71daa28e30eb7305f666d0bccc5a4002e53e8a574e3c4c32163d907a1b71df }
notes: superseded by 0.1.1.
- - id: agent-relay-0.7.67
+ - id: agent-relay-0.7.68
status: unreleased
current: true
+ charts: { agent-relay: 0.7.68, relay-control: 0.4.23, relay-webapp: 0.2.8 }
+ app_versions: { agent-relay: 0.1.0, relay-control: 0.1.0, relay-webapp: 0.1.0 }
+ depends:
+ agent-relay: { relaycast: 0.3.16, relayauth: 0.1.5, sessions-pipeline: 0.8.52, relay-control: 0.4.23, relay-webapp: 0.2.8, relayflows: 0.2.5, durable-actors: 0.14.6-awf.4, relayfile: 0.2.2, telemetry-collector: 0.1.7, relay-chief: 0.1.0, slack-relay: 0.3.11, relaygate: 0.1.10 }
+ images:
+ relaycast: { repository: ghcr.io/agentworkforce/relaycast-self-host, digest: sha256:ec062ef901af15cf575b53a71d7eb09f2e6ab6e7c0d5be2da35339a275a5c6cc }
+ relaycast-postgres: { repository: ghcr.io/agentworkforce/relaycast-self-host, digest: sha256:ec062ef901af15cf575b53a71d7eb09f2e6ab6e7c0d5be2da35339a275a5c6cc }
+ sessions-pipeline-worker: { repository: ghcr.io/agentworkforce/sessions-pipeline, digest: sha256:e51749eb2b7c91b790a1e05c126cc4a7b47243ab5d8d116c62732746e223c4a5 }
+ relay-control: { repository: ghcr.io/agentworkforce/relay-control, digest: sha256:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9 }
+ relay-webapp: { repository: ghcr.io/agentworkforce/relay-webapp, digest: sha256:bd295ccb7d1323965dce890f19d0b7f857d706c00d7756f719c713763fdb49f3 }
+ notes: 'Carries 0.7.67. relay-control 0.4.23: the chart default and the EKS, EKS RDS-native, GCP, gcp-proof-live and kind-core profiles move to Control 0.5.35 (sha256:1cb5bd71, b985c6f, publish run 44492248387; migrations 0052-0077, no operator step, no new required env; license FSL-1.1-ALv2). New optional sharing.defaultMode (all, new, selected) and sharing.overrideRoles (owner, admin) render SELFHOST_DEFAULT_SHARING_MODE and SELFHOST_SHARING_MODE_OVERRIDE_ROLES, unset by default. The Control migration Job name follows the image, so it re-runs on upgrade.'
+ - id: agent-relay-0.7.67
+ status: planned
charts: { agent-relay: 0.7.67, relay-control: 0.4.22, relay-webapp: 0.2.8 }
app_versions: { agent-relay: 0.1.0, relay-control: 0.1.0, relay-webapp: 0.1.0 }
depends:
@@ -5336,6 +5349,31 @@ entries:
- charts/sessions-pipeline-worker/templates/_brief-analytics.tpl
- charts/sessions-pipeline-worker/templates/brief-analytics-networkpolicy.yaml
+ - id: opt.relay-control.sharing-mode
+ kind: option
+ status: shipped
+ title: Control deployment default session-sharing mode
+ chart: relay-control
+ description: |
+ Optional deployment default for session sharing, with the workspace roles
+ allowed to change it. Both unset by default, which keeps Control's
+ built-in behaviour. defaultMode is one of all, new or selected;
+ overrideRoles is a list from owner and admin. Any other value is refused
+ at render, and Control refuses it at startup. Needs relay-control 0.5.35
+ or later (the chart default).
+ values: [sharing.defaultMode, sharing.overrideRoles]
+ env: [SELFHOST_DEFAULT_SHARING_MODE, SELFHOST_SHARING_MODE_OVERRIDE_ROLES]
+ profiles: [relay-control, agent-relay]
+ provided_by: operator
+ default: null
+ choices:
+ - { value: null, note: Unset; Control's built-in behaviour. }
+ - { value: all }
+ - { value: new }
+ - { value: selected }
+ verify: Render default with neither variable; render defaultMode selected and overrideRoles [owner] and confirm both variables on the Control api container only; confirm the refusals for an unknown mode, a non-list or unknown role and duplicates.
+ sources: ["charts/relay-control/templates/deployment.yaml:1", "ci/control-sharing/test_chart.py:1"]
+
- id: opt.relay-control.collector-analytics
kind: option
status: shipped