Skip to content

Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-host it, with any agent harness and any model.

feat(deploy): wire the distributed Slack app through the chart

Petr Bauch9b44f252186d
diff --git a/deploy/remote/helm/switch/samples/ingress.example.yaml b/deploy/remote/helm/switch/samples/ingress.example.yaml
index 5fb7effd1..998f9fa6a 100644
--- a/deploy/remote/helm/switch/samples/ingress.example.yaml
+++ b/deploy/remote/helm/switch/samples/ingress.example.yaml
@@ -46,6 +46,12 @@ spec:
- path: /.well-known
pathType: Prefix
backend: { service: { name: RELEASE-switch-core, port: { number: 8000 } } }
+ # The distributed Slack app's OAuth callback and event URLs. Needed
+ # only if you offer workspace installs; Slack dials these from the
+ # internet, so they must be reachable and on a trusted certificate.
+ - path: /messaging
+ pathType: Prefix
+ backend: { service: { name: RELEASE-switch-core, port: { number: 8000 } } }
- path: /health
pathType: Prefix
backend: { service: { name: RELEASE-switch-core, port: { number: 8000 } } }
diff --git a/deploy/remote/helm/switch/templates/_helpers.tpl b/deploy/remote/helm/switch/templates/_helpers.tpl
index eac995c80..22f2bf51a 100644
--- a/deploy/remote/helm/switch/templates/_helpers.tpl
+++ b/deploy/remote/helm/switch/templates/_helpers.tpl
@@ -62,6 +62,10 @@ MATTERMOST_USER_PASSWORD: {{ .Values.secrets.mattermostUserPassword | default .V
{{- if .Values.switchCore.oidc.enabled }}
GATEWAY_OIDC_CLIENT_SECRET: {{ required "secrets.gatewayOidcClientSecret is required when switchCore.oidc.enabled" .Values.secrets.gatewayOidcClientSecret | b64enc | quote }}
{{- end }}
+{{- if .Values.switchCore.slackApp.enabled }}
+SLACK_APP_CLIENT_SECRET: {{ required "secrets.slackAppClientSecret is required when switchCore.slackApp.enabled" .Values.secrets.slackAppClientSecret | b64enc | quote }}
+SLACK_APP_SIGNING_SECRET: {{ required "secrets.slackAppSigningSecret is required when switchCore.slackApp.enabled" .Values.secrets.slackAppSigningSecret | b64enc | quote }}
+{{- end }}
{{- end }}
{{/*
@@ -604,6 +608,22 @@ Include with `nindent 12`.
- name: GATEWAY_PUBLIC_URL
value: {{ .Values.switchCore.gatewayPublicUrl | quote }}
{{- end }}
+{{- if .Values.switchCore.slackApp.enabled }}
+- name: MESSAGING_PUBLIC_URL
+ value: {{ required "switchCore.slackApp.messagingPublicUrl is required when switchCore.slackApp.enabled" .Values.switchCore.slackApp.messagingPublicUrl | quote }}
+- name: SLACK_APP_CLIENT_ID
+ value: {{ required "switchCore.slackApp.clientId is required when switchCore.slackApp.enabled" .Values.switchCore.slackApp.clientId | quote }}
+- name: SLACK_APP_CLIENT_SECRET
+ valueFrom:
+ secretKeyRef:
+ name: {{ include "switch.secretName" . }}
+ key: SLACK_APP_CLIENT_SECRET
+- name: SLACK_APP_SIGNING_SECRET
+ valueFrom:
+ secretKeyRef:
+ name: {{ include "switch.secretName" . }}
+ key: SLACK_APP_SIGNING_SECRET
+{{- end }}
{{- end }}
{{/*
diff --git a/deploy/remote/helm/switch/values.yaml b/deploy/remote/helm/switch/values.yaml
index 6aca7c16d..a978886b6 100644
--- a/deploy/remote/helm/switch/values.yaml
+++ b/deploy/remote/helm/switch/values.yaml
@@ -32,6 +32,18 @@ ingress:
# Emit ingress-nginx annotations that keep MCP/SSE streams alive (long read
# timeouts, buffering off). Harmless on other controllers but ignored by them
# — set false and add your controller's equivalents via annotations.
+ #
+ # Your controller almost certainly needs an equivalent, because the defaults
+ # elsewhere are short enough to cut an idle agent stream. An AWS ALB idles a
+ # connection out after 60 seconds; a GCE backend service after 30. On an ALB,
+ # add to annotations above:
+ #
+ # alb.ingress.kubernetes.io/load-balancer-attributes: idle_timeout.timeout_seconds=3600
+ #
+ # — a property of the load balancer rather than of this Ingress, so Ingresses
+ # sharing a group must all agree on the value or the controller reconciles
+ # none of them. On GCE it is `timeoutSec` on a BackendConfig, which is a
+ # separate object this chart does not render.
streamingAnnotations: true
tls:
enabled: false
@@ -90,6 +102,11 @@ secrets:
mattermostUserPassword: ""
# Gateway OIDC client secret (required when switchCore.oidc.enabled).
gatewayOidcClientSecret: ""
+ # Distributed Slack app (required when switchCore.slackApp.enabled). The
+ # signing secret is the whole of what distinguishes a real Slack event from
+ # a post by anyone who learned the URL.
+ slackAppClientSecret: ""
+ slackAppSigningSecret: ""
# ── Switch Core (FastAPI) ─────────────────────────────────────────────────────
switchCore:
@@ -150,6 +167,24 @@ switchCore:
requireEmailVerified: true
# Set false to disable password login entirely (OIDC-only).
passwordLoginEnabled: true
+ # The distributed Slack app: the one a customer installs into their workspace
+ # by clicking a button, as opposed to an app an operator registers themselves
+ # and pastes a bot token for. Off unless you have registered such an app and
+ # are distributing it — a self-hosted install almost certainly wants the
+ # per-tenant Socket Mode bridge instead.
+ #
+ # Enabling it commits the deployment to being reachable from the internet:
+ # Slack dials messagingPublicUrl and gives up on anything it cannot resolve
+ # or cannot verify a certificate for. Add /messaging to ingress.agentApiPaths
+ # as well, or the URLs exist and nothing routes to them.
+ slackApp:
+ enabled: false
+ # Public origin Slack reaches Switch on — scheme + host, https, no path.
+ # Not the same thing as gatewayPublicUrl, which is where a person lands
+ # from a deeplink and may be private; setting this one to that host would
+ # move every deeplink along with it.
+ messagingPublicUrl: ""
+ clientId: ""
# Bearer-token resolution runs before every authenticated request and agents
# beat continuously, so a successful resolution is memoised in process for
# this many seconds. Only successes are cached — an unknown or revoked token