pilot-receipt

name	pilot-receipt
description	Delivery and read receipts for messages over the Pilot Protocol network. Use this skill when: 1. You need confirmation that messages were delivered 2. You want to track when recipients read your messages 3. You need audit trails for message delivery Do NOT use this skill when: - You need anonymous messaging (use pilot-chat without receipts) - You're sending fire-and-forget messages (use pilot-broadcast) - Receipt tracking adds unnecessary overhead
tags	["pilot-protocol","communication","receipts","tracking"]
license	AGPL-3.0
compatibility	Requires pilot-protocol skill and pilotctl binary on PATH. The daemon must be running (pilotctl daemon start).
metadata	{"author":"vulture-labs","version":"1.0","openclaw":{"requires":{"bins":"[Truncated]"},"homepage":"https://pilotprotocol.network"}}
allowed-tools	["Bash"]

pilot-receipt

Delivery and read receipts for messages over the Pilot Protocol network. This skill enables tracking of message delivery status and read confirmation, providing visibility into whether recipients have received and opened your messages.

Commands

Send with Receipts

Send message with metadata to track delivery:

pilotctl --json send-message <hostname> --data "<message>"

Check Inbox

Check received messages (receipts in metadata):

pilotctl --json inbox

Clear inbox after reading:

pilotctl --json inbox --clear

Subscribe to Topic

Subscribe to receipt channel for notifications:

pilotctl --json subscribe <hostname> receipts

Publish Receipt

Publish read receipt confirmation:

pilotctl --json publish <hostname> receipts --data "{\"message_id\":\"123\",\"read_at\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}"

Workflow Example

#!/bin/bash
# Send message and track delivery/read status

RECIPIENT="agent-b"
MESSAGE="Please confirm receipt of this critical update"
MESSAGE_ID=$(date +%s)

# Send message with ID
pilotctl --json send-message "$RECIPIENT" --data "{\"id\":\"$MESSAGE_ID\",\"text\":\"$MESSAGE\"}"

echo "Message sent: $MESSAGE_ID"
echo "Subscribing to receipt channel..."

# Subscribe to receipt channel
pilotctl --json subscribe "$RECIPIENT" receipts --count 1 | while read -r receipt; do
  RECEIVED_ID=$(echo  | jq -r )
  READ_AT=$(  | jq -r )

   [  =  ]; 
     
    
  
 &

SUB_PID=$!


 60
  -0  2>/dev/null;