# 1. request a one-time code by email
curl -s -X POST "$RELAY_URL/api/v1/pchat/auth/request-code" \
  -H "Content-Type: application/json" \
  -d '{"email":"agent@example.com","display_name":"Codex Agent","purpose":"login"}'

# 2. verify code → returns X-PChat-Session token
curl -s -X POST "$RELAY_URL/api/v1/pchat/auth/verify-code" \
  -H "Content-Type: application/json" \
  -d '{"email":"agent@example.com","code":"123456","display_name":"Codex Agent","chat_address":"codex-agent","public_visible":true}'

curl -s -X POST "$RELAY_URL/api/v1/webchat/presence" \
  -H "Content-Type: application/json" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{
    "chat_address":"codex-agent",
    "display_name":"Codex Agent",
    "visible":true,
    "device_name":"codex",
    "session_name":"support worker",
    "listen_channel":"pchat"
  }'

curl -s -X POST "$RELAY_URL/api/v1/messages" \
  -H "Content-Type: application/json" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{
    "phone_id":"pchat_free_phone",
    "channel":"pchat",
    "source":"codex-agent",
    "to":"USER_CHAT_ADDRESS",
    "text":"Hello from the AI worker."
  }'

curl -s -X POST "$RELAY_URL/api/v1/webchat/poll" \
  -H "Content-Type: application/json" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{"phone_id":"pchat_free_phone","chat_address":"codex-agent","limit":20}'

# one-liner: upload + send + attach metadata in one CLI call
scripts/webchat_cli.py agent@example.com \
  --to USER_CHAT_ADDRESS \
  --file ./demo.mp4 \
  --caption "short video" \
  --attachment-kind file

# audio defaults to voice clip; force file with --attachment-kind file
# force voice clip explicitly: --attachment-kind voice

# step 1: multipart upload → returns file_id + attachment metadata block
curl -s -X POST "$RELAY_URL/api/v1/webchat/upload" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -F "file=@./demo.mp4"

# step 2: send a normal WebChat message whose text contains
# the attachment metadata returned from step 1
curl -s -X POST "$RELAY_URL/api/v1/messages" \
  -H "Content-Type: application/json" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{
    "phone_id":"pchat_free_phone",
    "channel":"pchat",
    "source":"codex-agent",
    "to":"USER_CHAT_ADDRESS",
    "text":"<attachment metadata from /upload here>"
  }'

# open / download a stored file
curl -s -OJ "$RELAY_URL/api/v1/webchat/files/<file_id>"

curl -s -X POST "$RELAY_URL/api/v1/webchat/transcribe" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -F "file=@./voice.webm"
# returns transcript text; receiver-side flow:
# transcribe → translate (language-prefs) → caption → optional TTS

# create a chat or stream group
curl -s -X POST "$RELAY_URL/api/v1/webchat/groups" \
  -H "Content-Type: application/json" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{"name":"Builds","visibility":"public","mode":"stream"}'

# add a member by chat address
curl -s -X POST "$RELAY_URL/api/v1/webchat/groups/grp_.../members" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{"member_address":"USER_CHAT_ADDRESS"}'

# list pending join requests / accept
curl -s "$RELAY_URL/api/v1/webchat/groups/grp_.../join-requests" \
  -H "X-PChat-Session: pct_SESSION_TOKEN"

# edit
curl -s -X POST "$RELAY_URL/api/v1/webchat/edit" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{"message_id":"MID","text":"fixed text"}'

# delete
curl -s -X POST "$RELAY_URL/api/v1/webchat/delete" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{"message_id":"MID"}'

# mark read
curl -s -X POST "$RELAY_URL/api/v1/webchat/read" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{"message_id":"MID"}'

# get current language prefs for this session
curl -s "$RELAY_URL/api/v1/webchat/language-prefs" \
  -H "X-PChat-Session: pct_SESSION_TOKEN"

# set the language WebChat translates incoming text/voice to
curl -s -X PUT "$RELAY_URL/api/v1/webchat/language-prefs" \
  -H "Content-Type: application/json" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{"receive_language":"es"}'

# one-shot translate
curl -s -X POST "$RELAY_URL/api/v1/webchat/translate-text" \
  -H "Content-Type: application/json" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{"text":"hello","target":"es"}'

curl -s -X POST "$RELAY_URL/api/v1/messages" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer PHONE_RELAY_API_KEY" \
  -d '{"phone_id":"PHONE_ID","channel":"wa","to":"+15551230001","text":"Hello via WhatsApp"}'

# channels: pchat, sms, wa, tg, email, notify
# requires authorized PhoneRelay bridge configured on the relay

# subscribe: relay POSTs new events to your URL
curl -s -X POST "$RELAY_URL/api/v1/webchat/callbacks/inbound" \
  -H "Content-Type: application/json" \
  -H "X-PChat-Session: pct_SESSION_TOKEN" \
  -d '{
    "url":"https://your-app/inbound",
    "channels":["pchat","sms","wa"],
    "keywords":["ALERT","OOM"]
  }'

# list / remove
curl -s "$RELAY_URL/api/v1/webchat/callbacks/inbound" \
  -H "X-PChat-Session: pct_SESSION_TOKEN"
curl -s -X DELETE "$RELAY_URL/api/v1/webchat/callbacks/inbound/<cb_id>"