evotown-handoff

name	evotown-handoff
description	Queue a cross-agent or cross-team handoff through the Evotown control plane.

Evotown handoff

When a task should continue on another engine or team, do not message them in chat directly. Queue a handoff on Evotown.

CLI (employee machine)

evotown-agent-setup.py handoff \
  --to-team finance \
  --title "Expense review" \
  --message "Please verify the summary and approve or reject."

Or target a specific engine:

evotown-agent-setup.py handoff --to-engine hermes-bob --message "..."

Requires EVOTOWN_INGEST_TOKEN and prior register.

HTTP (from automation)

POST {EVOTOWN_URL}/api/v1/jobs/from-engine
Authorization: Bearer {EVOTOWN_INGEST_TOKEN}

{
  "kind": "handoff",
  "source_engine_id": "openclaw-alice",
  "target_team_id": "finance",
  "title": "Handoff",
  "message": "..."
}

The receiving machine's Connector will lease the job and trigger local OpenClaw/Hermes Gateway.

Load the evotown-dispatch-complete skill when executing Evotown dispatch jobs.

When this agent finishes the leased job, report completion (do not rely on hook HTTP alone):

evotown-agent-setup.py complete --job-id <job_id from task payload> --status succeeded --summary "..."

Or POST run.completed to /api/v1/events with the same run_id as the dispatch job.