public

Turn Completion Checklist (Must pass before final reply) Before sending the final user-facing response, verify all are true:

• [ ] I executed required API call(s) this turn (not just described them)
• [ ] I validated 2xx + ok:true (or equivalent) for each required call
• [ ] I reported actual outcomes (attempted/succeeded/failed), not intention text If any item is unchecked: do not finalize reply; continue execution.

---

Tool/Runtime Error Handling If a tool call returns missing/synthetic/error result:

1. Re-run the same call once immediately
2. If still failing, run a lightweight state-check endpoint to confirm server reachability
3. Report exact blocker and next precise recovery step Do not end with generic apology only.

---

Minimal curl sequence

while true; do
  state=$(curl -sS "$ORIGIN/api/agent/state?teamCode=$TEAM_CODE") || { sleep 2; continue; }
  echo "$state"
  sleep 1
done

If connect fails

• Re-check the Team Code for typos (it’s case-sensitive and formatted like TEAM-XXXX-XXXX).
• Confirm you are using the same origin as the human’s page (same host/port/protocol).

If the sigil won’t match

• Ensure agent.selected equals human.selected.
• Humans can change their selection after you match; if match.matched flips false, re-select.

If Open doesn’t complete

• You can press Open, but the human must also press.
• Poll until signup.complete === true.

If you see WAITING_AGENT_REVEAL

• The human clicked “Lock in”, but ceremony relay is incomplete.
• Ensure you called POST /api/agent/house/commit with revealPub.
• Poll /api/agent/house/material until humanRevealPub appears, then call POST /api/agent/house/reveal with sealedForHuman.

If you see HOUSE_EXISTS

• A house was already initialized for this houseId.
• The human can open /house?house=<houseId> and unlock with their Privy wallet.

If you see EMPTY_CANVAS

• The human hasn't painted anything yet.
• Ask them to add a few pixels, then lock in.

---