AgentRelay 📨

Reliable Agent-to-Agent Communication Protocol — Solves sessions_send timeout issues for large payloads using shared files + short message pointers.

🎯 When to Use This Skill

When you see messages like the following, immediately use this Skill to handle:

Please use AgentRelay skill to handle this message:
REQ,r1_r,s/r1_r.json,,

Or

📨 AgentRelay Protocol Message

Please use AgentRelay skill to handle:
- Message Type: REQ
- Event ID: r1_r  
- File Pointer: s/r1_r.json

Key Trigger Phrases:

• "use AgentRelay skill to handle"
• "AgentRelay protocol message"
• "Use AgentRelay"

When you see these keywords, immediately execute the Commands below!

🚀 Quick Start

Standard Flow After Receiving AgentRelay Message

Step 1: Parse Message

python3 {baseDir}/run_relay.py receive "REQ,r1_r,s/r1_r.json,,"

Example output:

{
  "type": "REQ",
  "event_id": "r1_r",
  "content": {"task": "write_poem", "sender_color": "red"},
  "secret": "ABC123"
}

Step 2: Understand Task and Execute

Check the content field to understand what needs to be done (e.g., write poem, analyze data, generate report).

Step 3: Update Result

python3 {baseDir}/run_relay.py complete r1_r "Task completed" "agent:red:red"

Step 4: Send CMP Confirmation

# generate CMP message (done automatically by run_relay.py complete)
# Output: CMP,r1_r,,,ABC123
# Then send via sessions_send
sessions_send(target='agent:red:red', message='CMP,r1_r,,,ABC123')

📚 Commands

receive <csv_message>

Parse AgentRelay CSV message and read shared file content.

Parameters:

• csv_message: CSV format message (without AgentRelay: prefix)

Example:

python3 {baseDir}/run_relay.py receive "REQ,r1_r,s/r1_r.json,,"

Output (JSON):

{
  "type": "REQ",
  "event_id": "r1_r",
  "ptr": "s/r1_r.json",
  "content": {...},
  "secret": "ABC123"
}

update <event_id> <json_updates>

Update shared file content.

Parameters:

• event_id: Event ID
• json_updates: JSON format updates (merged into payload.content)

Example:

python3 {baseDir}/scripts/handle_relay.py update r1_r '{"status":"completed","result":"done"}'

Output:

{"status":"ok","file":"/path/to/r1_r.json","ptr":"s/r1_r.json"}

ack <event_id> <secret>

Generate ACK confirmation message.

Parameters:

• event_id: Event ID
• secret: Secret Code read from file

Example:

python3 {baseDir}/scripts/handle_relay.py ack r1_r ABC123

Output:

{
  "status": "ok",
  "ack_message": "ACK,r1_r,,,ABC123",
  "instruction": "Call sessions_send with message='ACK,r1_r,,,ABC123'"
}

🔄 Complete Communication Flow

Sender Agent

# 1. Prepare data
content = {
    "task": "write_poem",
    "sender": "red",
    "receiver": "orange",
    "sender_color": "red",
    "receiver_color": "orange"
}