From d1195db1a96d732555990cd5bb2380a690326a17 Mon Sep 17 00:00:00 2001 From: khaliqgant Date: Thu, 19 Nov 2026 02:24:22 -0800 Subject: [PATCH 1/2] feat(relay-control): deployment default sharing mode and Control 0.5.35 (relay-control 0.4.23, agent-relay 0.7.62) - sharing.defaultMode (unset by default): all, new or selected, renders SELFHOST_DEFAULT_SHARING_MODE on the Control api container. - sharing.overrideRoles (empty by default): list from owner and admin, renders SELFHOST_SHARING_MODE_OVERRIDE_ROLES as a comma list. - Render refuses any other mode, a non-list, an unknown role or duplicates, matching Control's own startup refusal. - The chart default and the EKS, EKS RDS-native, GCP, gcp-proof-live and kind-core profiles move to relay-control 0.5.35 (sha256:1cb5bd71, b985c6f, publish run 44492248387; GitHub build-provenance attestation verified; amd64+arm64 verified anonymously). It is the first image with #232. Over 0.5.24: migrations 0052-0077 with no operator step, no new required env, same Cmd. License FSL-1.1-ALv2 from 0.5.28, approved by Khaliq 2026-11-19. - customer-images relay-control entry, release evidence manifest hash, supply-chain doc and the subdomain golden follow; the golden diffs are the Control digest and its hash-named migration Jobs. - ci/control-sharing/test_chart.py; registry option opt.relay-control.sharing-mode. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/fast-path.yml | 1 + .github/workflows/lint.yml | 1 + charts/agent-relay/Chart.lock | 6 +- charts/agent-relay/Chart.yaml | 4 +- charts/agent-relay/values-eks-rds-native.yaml | 10 +-- charts/agent-relay/values-eks.yaml | 10 +-- charts/agent-relay/values-gcp-proof-live.yaml | 4 +- charts/agent-relay/values-gcp.yaml | 10 +-- charts/agent-relay/values-kind-core.yaml | 4 +- charts/relay-control/Chart.yaml | 2 +- charts/relay-control/README.md | 2 +- charts/relay-control/templates/_helpers.tpl | 8 +++ .../relay-control/templates/deployment.yaml | 8 +++ charts/relay-control/values.yaml | 22 ++++-- ci/agent-relay/subdomain-golden.sha256 | 8 +-- ci/agent-relay/test_native_no_relayauth.py | 4 +- ci/control-sharing/test_chart.py | 70 +++++++++++++++++++ docs/self-hosted-image-supply-chain.md | 2 +- docs/self-hosted-requirements.md | 28 +++++++- self-hosted/customer-images.yaml | 48 ++++++------- self-hosted/customer-release-evidence.json | 2 +- self-hosted/requirements.yaml | 40 ++++++++++- 22 files changed, 226 insertions(+), 68 deletions(-) create mode 100644 ci/control-sharing/test_chart.py diff --git a/.github/workflows/fast-path.yml b/.github/workflows/fast-path.yml index 8ed45878..e0663a05 100644 --- a/.github/workflows/fast-path.yml +++ b/.github/workflows/fast-path.yml @@ -748,6 +748,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 8c4b4961..ec2f7864 100644 --- a/.github/workflows/lint.yml +++ b/.github/workflows/lint.yml @@ -169,6 +169,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 6d409739..8bf1330f 100644 --- a/charts/agent-relay/Chart.lock +++ b/charts/agent-relay/Chart.lock @@ -10,7 +10,7 @@ dependencies: version: 0.8.51 - 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.7 @@ -35,5 +35,5 @@ dependencies: - name: relaygate repository: file://../relaygate version: 0.1.10 -digest: sha256:83a72086d431f6e9782d91b3cf2fd079df7938e2ba89f7ff204c1f4023570319 -generated: "2026-11-19T01:44:21.234330876-08:00" +digest: sha256:0a1966cbe14e35bb2a1bf319e63c63f8cbb7f63910bc890033cced2e711566ba +generated: "2026-11-19T07:37:18.536986152-08:00" diff --git a/charts/agent-relay/Chart.yaml b/charts/agent-relay/Chart.yaml index 5aee9928..264494b4 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.62 +version: 0.7.64 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 e64b7a02..31d4df2a 100644 --- a/charts/agent-relay/values-eks-rds-native.yaml +++ b/charts/agent-relay/values-eks-rds-native.yaml @@ -293,12 +293,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 7b32da39..b7abc066 100644 --- a/charts/agent-relay/values-eks.yaml +++ b/charts/agent-relay/values-eks.yaml @@ -208,15 +208,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 fdb2dd0e..b07a9934 100644 --- a/charts/agent-relay/values-gcp.yaml +++ b/charts/agent-relay/values-gcp.yaml @@ -372,13 +372,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..a5a4b032 100644 --- a/charts/relay-control/templates/_helpers.tpl +++ b/charts/relay-control/templates/_helpers.tpl @@ -65,6 +65,14 @@ 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 | default dict -}} +{{- $mode := $sharing.defaultMode | default "" -}} +{{- 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 | default list -}} +{{- 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 -}} 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 6d4465b5..bb674011 100644 --- a/ci/agent-relay/subdomain-golden.sha256 +++ b/ci/agent-relay/subdomain-golden.sha256 @@ -1,11 +1,11 @@ # helm v4.3.1 -aee285501fad24c3a5c0b33f263bbe0d3ef3091665a67ca10e23a282e684bf9e eks-rds-native.yaml -d7634c03f7104f7c601ec8778cd34e9e67db7e3a8804e52a1d126bcb373a9e00 gcp-durable-actors.yaml +4dab6a62d27848e39337c33852d013e1e1104c4e2565899196772649f4588216 eks-rds-native.yaml +7df0c1575509be96f5e131dcbc308464c240cd60b3f683d917baf7b8ab87b24d gcp-durable-actors.yaml d9c77f7ab7d0b596305adb7a0b78607d2f5c7e152c99c91cad766b6f25cd464a gcp-proof-flows.yaml 8cfbc78501640e685465e2991d0592c08aa235aeab0d4e6871a64a36fca6618c gcp-proof-live.yaml 0695c2b8b2f804cb0a817bd9dcba04538808283c996d9695235b006d3bc3deec gcp-proof.yaml -7f03c0491cd61dcf3210027f595b7214532489e82eced54043dbb0fe5396c137 gcp-supported-100.yaml -503424c72488a96cf3e76c338d941706be5ef338ef88c19efab395696a1bf71e gcp.yaml +e733739f79ff3ab698067b454b6c11f85be13f571f74acdd88bbf66ed5756892 gcp-supported-100.yaml +ecdfde2e9a579389475b1749b496bcaed4bd6677d929857c8cfdf4faf93174da gcp.yaml 3e3f87fde30fafb454dad5c0d4d935cde221ef8e2d3210ed242e77f04da94f56 kind-durable-actors.yaml fdc618e39628ef38a9cdb1f323a7e92d167573b84872079f986c01a7dc4fc963 relay-control.yaml 18606a2d87c10f97b7e33c323283c6221daf97543e3d0d9e388db5cd913e74a4 relay-webapp.yaml diff --git a/ci/agent-relay/test_native_no_relayauth.py b/ci/agent-relay/test_native_no_relayauth.py index f66fa787..27808f31 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..ba96a647 --- /dev/null +++ b/ci/control-sharing/test_chart.py @@ -0,0 +1,70 @@ +"""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): + v = yaml.safe_load((ROOT / "charts/relay-control/ci/default-values.yaml").read_text()) + if sharing is not None: + v["sharing"] = sharing + 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"), + ]: + with self.subTest(sharing=sharing): + self.render(sharing, fail=msg) + + +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..b883d41a 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` `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-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 c6d08b98..08e65f90 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 @@ -169,7 +169,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.62 | unreleased | 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. | +| agent-relay-0.7.64 | unreleased | agent-relay 0.7.64
relay-control 0.4.23
relay-webapp 0.2.7
(deps: relaycast 0.3.16, relayauth 0.1.5, sessions-pipeline 0.8.51, relay-control 0.4.23, 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:1cb5bd714e7c…`
relay-webapp: `ghcr.io/agentworkforce/relay-webapp@sha256:bd295ccb7d13…` | | | Carries 0.7.62. 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.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. | | agent-relay-0.7.61 | **planned** | agent-relay 0.7.61
relay-control 0.4.22
relay-webapp 0.2.7
(deps: relaycast 0.3.16, relayauth 0.1.5, sessions-pipeline 0.8.50, 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.60 and sessions-pipeline 0.8.50 (searchIndexer.stagedReconcile.enabled, issue 610 Phase 3; no image pin changes). | | agent-relay-0.7.60 | **planned** | agent-relay 0.7.60
relay-control 0.4.22
relay-webapp 0.2.7
(deps: relaycast 0.3.16, relayauth 0.1.5, sessions-pipeline 0.8.49, 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.59. Internal-only GKE edge, opt-in: gkeIngress.mode=internal (default external) renders the Ingress with class gce-internal, a regional static internal address (gkeIngress.staticIpName) and HTTP closed, for a regional internal Application Load Balancer that answers only inside the VPC and the networks routed to it. No ManagedCertificate or FrontendConfig is rendered (GKE Ingress supports neither internally): the certificate is gkeIngress.tlsSecretName or gkeIngress.internal.preSharedCerts (regional certificates). gkeIngress.internal.proxyOnlySubnetCidr is required and every backend NetworkPolicy (and the durable-actors policy) must admit it; the render refuses otherwise, and also refuses sslPolicy or securityPolicy in internal mode and internal.* in external mode. values-gcp-internal.yaml is the overlay; terraform/modules/gcp/internal-edge creates the proxy-only subnet, the address and the firewall rule. Default renders differ only in the helm.sh/chart labels; images unchanged. | | agent-relay-0.7.59 | **planned** | agent-relay 0.7.59
relay-control 0.4.22
relay-webapp 0.2.7
(deps: relaycast 0.3.16, relayauth 0.1.5, sessions-pipeline 0.8.49, 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.57 (0.7.58 is taken by another open change). GKE edge hardening, all opt-in and empty by default: gkeIngress.sslPolicy names a Compute SSL policy that the FrontendConfig applies to the HTTPS listener (without one Google's default policy still accepts TLS 1.0 and 1.1); gkeIngress.securityPolicy names a Cloud Armor backend security policy set on the BackendConfig of every backend behind the Ingress (api, cast, both history edges, the actors and relaygate edges, and new policy-only BackendConfigs -dashboard, -edge-deny and -files; the relay-webapp and relayfile Services need their backend-config annotation and the render fails with the exact value otherwise); gkeIngress.tlsSecretName serves a kubernetes.io/tls Secret instead of the ManagedCertificate, for an edge whose DNS points at a proxy or CDN. The resources come from terraform/modules/gcp/edge-security; terraform/examples/gcp now creates the TLS 1.2 SSL policy by default and exports it in chart_values. Default renders differ only in the helm.sh/chart labels (subdomain golden unchanged); images unchanged. | @@ -1163,6 +1164,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` | @@ -1213,6 +1215,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` | @@ -3080,6 +3083,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 1e413cf1..c20db37e 100644 --- a/self-hosted/customer-images.yaml +++ b/self-hosted/customer-images.yaml @@ -425,45 +425,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 @@ -473,11 +470,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 5bfbbb5b..a2f723e3 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:6a2f5967b675b36690e8993fc5a23600e042a242e0be3221d6c48126ff953ac2", + "imageManifestSha256": "sha256:bed32efe851db06926b26df27a29ed62efe7e2bd7fb33430b0131fc5acf0c81f", "valuesFile": "charts/agent-relay/values-gcp.yaml" }, "releaseDecision": "blocked", diff --git a/self-hosted/requirements.yaml b/self-hosted/requirements.yaml index 9b5a0b21..677a9d4e 100644 --- a/self-hosted/requirements.yaml +++ b/self-hosted/requirements.yaml @@ -2014,9 +2014,22 @@ compatibility: images: relayauth: { repository: ghcr.io/agentworkforce/relayauth, digest: sha256:eb71daa28e30eb7305f666d0bccc5a4002e53e8a574e3c4c32163d907a1b71df } notes: superseded by 0.1.1. - - id: agent-relay-0.7.62 + - id: agent-relay-0.7.64 status: unreleased current: true + charts: { agent-relay: 0.7.64, relay-control: 0.4.23, relay-webapp: 0.2.7 } + 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.51, relay-control: 0.4.23, 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 } + 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:77022c5b6a1d30f96f921d703eb27a1acada8ec273ad84aebdde24f8eddce305 } + 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.62. 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.62 + status: planned charts: { agent-relay: 0.7.62, relay-control: 0.4.22, relay-webapp: 0.2.7 } app_versions: { agent-relay: 0.1.0, relay-control: 0.1.0, relay-webapp: 0.1.0 } depends: @@ -5269,6 +5282,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 From 6bfaf1b727be5166fb160f1d67ba1cd8a1b8b90c Mon Sep 17 00:00:00 2001 From: khaliqgant Date: Thu, 19 Nov 2026 05:35:04 -0800 Subject: [PATCH 2/2] fix(relay-control): review fixes for sharing values; supply-chain row names 0.5.35 - Type-check sharing.defaultMode / overrideRoles before any default, so false, 0 and {} are refused instead of silently treated as unset; sharing must be a map. - Reserve SELFHOST_DEFAULT_SHARING_MODE and SELFHOST_SHARING_MODE_OVERRIDE_ROLES so extraEnv cannot duplicate or shadow them; tests for both. - docs/self-hosted-image-supply-chain.md: the relay-control row now names 0.5.35 (b985c6f, run 44492248387, FSL-1.1-ALv2), attestation re-verified. Co-Authored-By: Claude Opus 5.5 --- charts/relay-control/templates/_helpers.tpl | 13 ++++++++++--- ci/control-sharing/test_chart.py | 15 ++++++++++++++- docs/self-hosted-image-supply-chain.md | 2 +- 3 files changed, 25 insertions(+), 5 deletions(-) diff --git a/charts/relay-control/templates/_helpers.tpl b/charts/relay-control/templates/_helpers.tpl index a5a4b032..e40d90f7 100644 --- a/charts/relay-control/templates/_helpers.tpl +++ b/charts/relay-control/templates/_helpers.tpl @@ -65,11 +65,16 @@ 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 | default dict -}} -{{- $mode := $sharing.defaultMode | default "" -}} +{{- $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 | default list -}} +{{- $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 -}} @@ -138,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/ci/control-sharing/test_chart.py b/ci/control-sharing/test_chart.py index ba96a647..4fed97b5 100644 --- a/ci/control-sharing/test_chart.py +++ b/ci/control-sharing/test_chart.py @@ -11,10 +11,12 @@ class ControlSharing(unittest.TestCase): - def render(self, sharing=None, umbrella=False, fail=None): + 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" @@ -61,10 +63,21 @@ def test_invalid_refused(self): ({"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 b883d41a..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:1cb5bd714e7c9f326cfe107544b8b7125207c80a7e556ab8debf78a8b2167ad9` | 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