pilot-priority-queue#

Priority-based message delivery with urgency levels over the Pilot Protocol network. This skill enables structured message prioritization, ensuring urgent communications are processed first while maintaining ordered delivery for messages of equal priority.

Commands#

Send messages with priority prefix#

bash

# Send critical message with [CRITICAL] prefix
pilotctl --json send-message <hostname> --data "[CRITICAL] System alert"

# Send high priority with [HIGH] prefix
pilotctl --json send-message <hostname> --data "[HIGH] Urgent task"

# Send normal message
pilotctl --json send-message <hostname> --data "Regular update"

# Send low priority with [LOW] prefix
pilotctl --json send-message <hostname> --data "[LOW] FYI: Log summary"

Receive and filter by priority#

bash

# View all inbox
pilotctl --json inbox

# Filter critical messages using jq
pilotctl --json inbox | jq '.items[]? | select(.content | startswith("[CRITICAL]"))'

# Filter high priority
pilotctl --json inbox | jq '.items[]? | select(.content | startswith("[HIGH]"))'

Manual queue management#

bash

# Clear inbox after processing
pilotctl --json inbox --clear

Workflow Example#

Process messages by priority with automatic triage:

bash

#!/bin/bash
# Process priority inbox using prefix tags

INBOX=$(pilotctl --json inbox)

# Extract and count by priority prefix
CRITICAL_COUNT=$(echo "$INBOX" | jq '[.items[]? | select(.content | startswith("[CRITICAL]"))] | length')
HIGH_COUNT=$(echo "$INBOX" | jq '[.items[]? | select(.content | startswith("[HIGH]"))] | length')
NORMAL_COUNT=$(echo "$INBOX" | jq '[.items[]? | select(.content | (startswith("[CRITICAL]") or startswith("[HIGH]") or startswith("[LOW]")) | not)] | length')
LOW_COUNT=$(echo "$INBOX" | jq '[.items[]? | select(.content | startswith("[LOW]"))] | length')

echo "Critical: $CRITICAL_COUNT, High: $HIGH_COUNT, Normal: $NORMAL_COUNT, Low: $LOW_COUNT"

# Process critical first
if [ "$CRITICAL_COUNT" -gt 0 ]; then
  echo "CRITICAL MESSAGES:"
  echo "$INBOX" | jq -r '.items[]? | select(.content | startswith("[CRITICAL]")) |
    "[\(.timestamp // "N/A")] \(.content)"'
fi

# Process high priority
if [ "$HIGH_COUNT" -gt 0 ]; then
  echo "HIGH PRIORITY:"
  echo "$INBOX" | jq -r '.items[]? | select(.content | startswith("[HIGH]")) |
    "[\(.timestamp // "N/A")] \(.content)"'
fi

Dependencies#

Requires pilot-protocol skill, pilotctl binary, and running daemon.