@jobmatchme/bee-slack

bee-slack is the Slack-facing adapter for the Bee Dance stack.

It accepts inbound Slack events, normalizes them into gateway turns, forwards them through @jobmatchme/bee-gate, and renders the resulting Bee Dance event stream back into Slack messages and thread updates.

What this package does

• connects to Slack via Socket Mode
• resolves inbound DMs and app mentions against a route configuration
• downloads Slack file attachments into the gateway blob store
• maps inbound Slack messages into the Bee Gate input model
• renders streamed Bee Dance output back into Slack messages and artifacts

Design intent

The package is intentionally thin. It owns Slack-specific concerns:

• Slack tokens and Socket Mode lifecycle
• user and channel lookups
• route matching
• posting and updating Slack messages
• uploading artifacts to Slack

It does not own protocol orchestration itself. That responsibility stays in @jobmatchme/bee-gate, which keeps the Slack adapter replaceable and easier to compare against other frontends.

Local development

For local manual testing, copy local.config.example.json to local.config.json, fill in your Slack tokens, and run:

npm run start:local

This starts a local NATS broker via Docker, starts the local fake backend, and then launches bee-slack against that local stack. The local broker defaults to max_payload: 8MB for inline artifact testing; override with BEE_LOCAL_NATS_MAX_PAYLOAD if needed.

Publishing

The package is intended for public npm publication from GitHub Actions using npm Trusted Publishing via GitHub OIDC.

Container images are published to GHCR from GitHub Actions on version tags. The image entrypoint expects a mounted JSON config file and runs:

bee-slack /config/config.json

Container image

Build the container locally with:

docker build -t bee-slack:local .

Run it with a mounted config file:

docker run --rm \
  -v "$(pwd)/local.config.json:/config/config.json:ro" \
  bee-slack:local

Kubernetes

A reusable Helm chart is included under charts/bee-slack. The chart supports either:

• mounting an existing Secret that contains config.json
• creating the config Secret from values at install time

The chart mounts /workspace as an ephemeral emptyDir. That is enough for the local blob store used for Slack attachments and generated artifacts, but those files are intentionally not persisted across pod restarts or recreations.

Example values files for both secret-handling modes are included under:

• charts/bee-slack/values-existing-secret.example.yaml
• charts/bee-slack/values-inline-config.example.yaml

Example install using an existing Secret:

helm upgrade --install bee-slack ./charts/bee-slack \
  --namespace ai-agents \
  --create-namespace \
  --set config.existingSecretName=bee-slack-config \
  --set image.repository=ghcr.io/jobmatchme/bee-slack \
  --set image.tag=0.1.7

The mounted config file must contain the same structure as local.config.example.json.

Scheduled Slack turns

The same container can also run a one-shot scheduled turn. This is intended for Kubernetes CronJobs that should survive bee-slack or fabee-pi-agent pod restarts while triggering a Bee worker and publishing the result to Slack:

bee-slack run-scheduled /config/config.json /scheduled/job.json

Example /scheduled/job.json:

{
  "id": "daily-dbt-report",
  "routeId": "dm-test",
  "target": { "slackUserId": "U1234567890" },
  "text": "Erstelle den täglichen dbt Report und schreibe die Ergebnisse kompakt auf Deutsch."
}

routeId selects one of the configured Slack routes and therefore the Bee worker subject, for example fabee.agent.pi.default. For DM targets the command opens the Slack DM, streams the worker run, updates the Slack status message, and uploads inline artifacts when available.

The Helm chart supports persistent cluster schedules via scheduledRuns values; each entry creates a Kubernetes CronJob plus a ConfigMap containing its one-shot job config.

Release order matters for changes in the shared gateway runtime: publish the referenced @jobmatchme/bee-gate version first, then tag and publish bee-slack so the npm package, GHCR image, and OCI Helm chart resolve the same runtime.

License

MIT