A Node.js server that receives webhooks and cron triggers, evaluates declarative automation rules, and dispatches prompts to AI agents running on Sprites via the Sprites.dev API.

# Install dependencies
npm install

# Copy and configure environment
cp .env.example .env
# Edit .env with your values (see Configuration below)

# Run locally
npm run dev

# Upload an example automation
curl http://localhost:8080/admin/automations \
  -X POST \
  -H "X-Admin-Token: $ADMIN_TOKEN" \
  -H "Content-Type: text/yaml" \
  --data-binary @examples/pr-review.yaml

The examples/ directory contains ready-to-use automations:

GET /health

POST /webhook/:source

Receives webhooks from external sources. The :source parameter specifies the adapter.

All admin endpoints require the X-Admin-Token header.

GET    /admin/automations      # List all automations
GET    /admin/automations/:id  # Get a single automation
POST   /admin/automations      # Upload/update an automation (YAML body)
DELETE /admin/automations/:id  # Delete an automation

id: pr-review-bot
description: Triggers code review when PR is opened

sprite:
  name: code-reviewer
  path: claude
  cmd: "-p"
  workdir: /home/user/repo

source:
  type: github
  events:
    - pull_request

match:
  - payload.action == "opened"
  - payload.repository.full_name == "myorg/myrepo"
  - payload.pull_request.draft == false

run: |
  Review this PR and post your feedback to GitHub.

  PR #{{payload.pull_request.number}}: {{payload.pull_request.title}}
  Author: {{payload.pull_request.user.login}}

  1. Run 'git diff main' to see the changes
  2. Review for bugs, security issues, and code quality
  3. Post a review with specific line comments using the GitHub CLI

id: daily-metrics

sprite:
  name: analytics-agent
  path: claude
  cmd: "-p"
  workdir: /home/user

source:
  type: cron
  schedule: "0 9 * * 1-5"  # 9am weekdays

run: |
  Good morning! Time for the daily metrics check.

  1. Query the analytics API for the last 24 hours
  2. Summarize key metrics and trends
  3. Post the summary to #metrics in Slack

Match expressions use JSONPath with == or != operators (all must pass):

match:
  - payload.action == "opened"
  - payload.repository.private == false
  - payload.sender.login != "bot-user"

Use {{path.to.value}} syntax in the run command:

• {{payload.x.y.z}} - Values from webhook payload
• {{sprite.workdir}} - Sprite working directory

Missing values resolve to empty string.

1. Log into Cloudflare dashboard
2. Go to Workers & Pages → KV
3. Click Create a namespace (e.g., spriteswarm-automations)
4. Copy the Namespace ID
5. Go to My Profile → API Tokens → Create Token
6. Use the Edit Cloudflare Workers template
7. Copy the API Token and Account ID (from the dashboard URL)

# Create the app
fly launch --no-deploy

# Set secrets
fly secrets set \
  SPRITES_TOKEN="..." \
  ADMIN_TOKEN="..." \
  GITHUB_WEBHOOK_SECRET="..." \
  CF_ACCOUNT_ID="..." \
  CF_API_TOKEN="..." \
  CF_KV_NAMESPACE_ID="..."

# Deploy
fly deploy

Point your GitHub webhook to https://your-app.fly.dev/webhook/github

Supported events: issue_comment, pull_request, pull_request_review, push

1. Create a Slack app at https://api.slack.com/apps
2. Enable Event Subscriptions with URL: https://your-app.fly.dev/webhook/slack
3. Subscribe to events like app_mention, message.channels
4. Copy the Signing Secret to SLACK_WEBHOOK_SECRET

Point AgentMail webhooks to https://your-app.fly.dev/webhook/agentmail

Supported events: message.received, message.sent, message.delivered, message.bounced

For custom integrations, send POST requests to https://your-app.fly.dev/webhook/generic with:

• X-Webhook-Secret: Your configured secret
• X-Event-Type: Event type to match (default: message)
• JSON body: Your payload (accessible via {{payload.x.y}})