ring-delegating-to-gandalf

name: ring:delegating-to-gandalf description: "Delegating tasks to Gandalf, a Lerian AI teammate reachable over Tailscale, and returning its response. Use when you need to publish an HTML/markdown report to Alfarrabio and get a URL, post a Slack notification, or ask Gandalf for business/product context via a full agent session. Tailscale-network only, no auth token. Skip when off the Tailscale network or the task can be done locally."

Gandalf Webhook

When to use

Need to publish content to Alfarrábio (report server)
Need to send Slack notifications via Gandalf
Need to ask Gandalf for business context or information
Need to delegate a task to Gandalf (AI team member on dedicated Mac mini)

Skip when

Not connected to Lerian's Tailscale network
Task can be completed locally without Gandalf's capabilities

Send tasks to Gandalf and get responses. Tailscale only. No auth token.

POST http://gandalf.heron-justitia.ts.net:18792/task

Actions

`publish` — instant (<1s)

Write content to Alfarrábio, get URL back. Files land under content/misc/ and the returned URL is always https://alfarrabio.lerian.net/misc/<slug>.html.

Send complete HTML — Alfarrábio renders HTML only, so content should be a full HTML document (<!DOCTYPE html> … </html>). Markdown and plain text are accepted but auto-converted to a basic HTML page; for anything beyond simple prose, send your own HTML.

curl -s -X POST http://gandalf.heron-justitia.ts.net:18792/task \
  -H "Content-Type: application/json" \
  -d '{"action": "publish", "message": "Report Title", "content": "<!DOCTYPE html><html>...</html>"}'

Response: {"ok": true, "task_id": "...", "status": "done", "response": "https://alfarrabio.lerian.net/misc/report-title.html"}

`notify` — instant (<1s)

Send Slack message. Prefix with #channel: to target specific channel (default: #gandalf-notifications).

curl -s -X POST http://gandalf.heron-justitia.ts.net:18792/task \
  -H "Content-Type: application/json" \
  -d '{"action": "notify", "message": "#pull-requests: PR #1900 ready for review"}'

`ask` — full agent (~30-60s)

Open a full agent session. Use for business context, analysis, cross-tool tasks.

# Send task
RESP=$(curl -s -X POST http://gandalf.heron-justitia.ts.net:18792/task \
  -H "Content-Type: application/json" \
  -d '{"action": "ask", "message": "What is the status of Voluti integration?", "context": "investigating INC-72"}')
TASK_ID=$(echo $RESP | jq -r .task_id)

# Poll until done — exit ONLY on terminal states
for i in $(seq 1 60); do
  RESULT=$(curl -s http://gandalf.heron-justitia.ts.net:18792/task/$TASK_ID)
  STATUS=$(echo $RESULT | jq -r .status)
  case "$STATUS" in
    completed|failed|error) echo $RESULT | jq . && break ;;
    processing) sleep 5 ;;
    *) sleep 5 ;;  # transient/unknown state — keep polling
  esac
done

Fields

Field	Required	Description
`message`	Yes	What to do. For `publish`, becomes the report title.
`action`	No	`publish`, `notify`, `ask` (default).
`content`	Required for `publish`	Full HTML document for `publish` (Markdown/text accepted but auto-converted; Alfarrábio renders HTML only). Max 5MB. Omit for `notify` and `ask`.
`context`	No	What you're working on (repo, PR, feature).

publish and notify are synchronous — no polling needed.

When to Use What

Need	Action	Speed
Publish HTML report (full HTML doc)	`publish`	<1s
Send Slack notification	`notify`	<1s
Ask business/product question	`ask`	30-60s
Complex cross-tool task	`ask`	30-300s

Constraints

MUST respect rate limit: 10 requests/min per Tailscale node
MUST keep content under 5MB inline
MUST handle agent timeout: 300s maximum
REQUIRED: Tailscale network only — MUST NOT call from public internet
REQUIRED: No file uploads — content MUST be inline as JSON string

Health Check

curl -s http://gandalf.heron-justitia.ts.net:18792/health