feat: named agents, session resumption, and Slack bot

[maxigimenez]

Summary

• Named agents with system prompts — define reusable AgentDefinition entries in parallax.yml; route tickets to specific agents using agentLabels (ticket label → agent name); each agent can have an optional systemPrompt prepended to every prompt
• Session ID tracking & --resume — Claude Code session_id captured from system:init stream events, persisted to the DB, and passed as --resume <id> on retry to continue interrupted work
• Slack bot (@parallax/slack) — Bolt Socket Mode bot (no public URL needed); posts plan approval messages with Approve/Reject buttons, sends task event notifications (PR created, failed, canceled), and handles /parallax slash commands (retry, cancel, status, pr-review)

Running locally

1. Install and build

pnpm install
pnpm build

2. Update parallax.yml with the new top-level structure

# Agent definitions (optional)
- agents:
    - name: developer
      provider: claude-code
      model: claude-opus-4-5
      systemPrompt: "You are a senior backend engineer..."

# Slack config (optional)
- slack:
    botToken: xoxb-...       # Bot User OAuth Token
    appToken: xapp-...       # App-Level Token (Socket Mode)
    channel: "#ai-tasks"

# Projects — unchanged format
- id: my-repo
  workspaceDir: /path/to/repo
  agent:
    name: developer          # references agents[].name
  agentLabels:
    ai-frontend: reviewer    # ticket label → agent name
  pullFrom:
    provider: github
    filters:
      owner: myorg
      repo: my-repo
      labels: [ai-ready]

Existing single-project parallax.yml files with agent.provider work unchanged.

3. Set up the Slack bot (optional)

See docs/slack-bot.md for the full step-by-step:

1. Create a Slack App at api.slack.com/apps
2. Enable Socket Mode and generate an App-Level Token (xapp-)
3. Add OAuth scopes: chat:write, commands, channels:history, groups:history
4. Install the app to your workspace and copy the Bot Token (xoxb-)
5. Create a /parallax slash command
6. Add botToken and appToken to the slack: section in your parallax.yml

4. Start

pnpm parallax register ./parallax.yml
pnpm parallax start

Test plan

• pnpm install && pnpm build completes without errors across all packages
• pnpm test — all new and updated test cases pass (config-loader, provider-services, claude-code adapter, github-service, linear-service, slack formatters)
• Register a config with named agents and agentLabels; create a GitHub issue with a matching label and verify agentName is set on the task
• Verify --resume flag appears in task logs when retrying a task that has a stored agentSessionId
• Configure the Slack section; restart the orchestrator; confirm the bot connects with no errors; trigger a task and verify a plan approval message appears with Approve/Reject buttons

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
parallax	Skipped		May 14, 2026 9:20am