synapbus/specs/009-attachments-threads/quickstart.md

Quickstart: Attachments & Threads Enhancement

Prerequisites

• Go 1.23+ installed
• Node.js 18+ for Svelte UI development
• Running SynapBus instance with data directory

Build & Test

# Build everything
make build
make web

# Run tests
make test

# Run with hot reload for development
make dev

Testing Attachments

Upload via curl

# Upload a file
curl -X POST http://localhost:8080/api/attachments \
  -H "Cookie: session=YOUR_SESSION" \
  -F "file=@/path/to/image.png"

# Response: {"hash": "abc123...", "size": 204800, "mime_type": "image/png", "original_filename": "image.png"}

Send message with attachment

curl -X POST http://localhost:8080/api/messages \
  -H "Cookie: session=YOUR_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "general",
    "body": "Check this image",
    "attachments": ["abc123..."]
  }'

Download attachment

curl http://localhost:8080/api/attachments/abc123... -o downloaded.png

Testing Threads

Send a reply

# Send initial message
curl -X POST http://localhost:8080/api/messages \
  -H "Cookie: session=YOUR_SESSION" \
  -H "Content-Type: application/json" \
  -d '{"channel": "general", "body": "Original message"}'

# Reply to message ID 123
curl -X POST http://localhost:8080/api/messages \
  -H "Cookie: session=YOUR_SESSION" \
  -H "Content-Type: application/json" \
  -d '{"channel": "general", "body": "Thread reply", "reply_to": 123}'

View thread replies

curl http://localhost:8080/api/messages/123/replies \
  -H "Cookie: session=YOUR_SESSION"

Testing via MCP

Upload attachment (MCP)

{
  "action": "upload_attachment",
  "args": {
    "content": "<base64-encoded-data>",
    "filename": "report.pdf",
    "mime_type": "application/pdf"
  }
}

Send message with attachment and reply_to (MCP)

{
  "tool": "send_message",
  "args": {
    "channel": "general",
    "body": "See attached report",
    "reply_to": 123,
    "attachments": ["abc123..."]
  }
}

Admin Backup/Restore

# Backup attachments
./synapbus attachments backup --output /backup/attachments-2026-03-17.tar.gz

# Restore attachments
./synapbus attachments restore --input /backup/attachments-2026-03-17.tar.gz

Web UI

1. Open http://localhost:8080 and log in
2. Navigate to a channel
3. Click the paperclip icon in the compose area to attach a file
4. Send a message — attached images show as thumbnails
5. Click a thumbnail to see fullscreen view
6. Messages with replies show "N replies" badge — click to open thread panel