Pilot Event Filter
Filter and transform events before delivery using pattern matching and jq transforms. Use this skill when: 1. You need to filter events by content, not just topic wildcards 2. You need to transform event payloads before processing 3. You need to route events conditionally based on content 4. You need to reduce event noise by selective forwarding Do NOT use this skill when: - Topic wildcards alone are sufficient (use pilot-event-bus instead) - You need all events without filtering (subscribe directly) - You need persistent storage (use pilot-event-log instead)
Pilot Event Filter
Filter and transform Pilot Protocol event streams using jq-based pattern matching.
Commands
Subscribe with filtering
pilotctl --json subscribe <source-hostname> <topic> --timeout 60 | \
jq -c '.data.events[] | select(<filter-expression>)'
Transform and republish
pilotctl --json subscribe <source> <topic> --timeout 60 | \
jq -c '.data.events[] | <transform-expression>' | \
while IFS= read -r event; do
pilotctl --json publish <destination> "<new-topic>" --data "$event"
done
Workflow Example
Filter critical alerts and forward to on-call agent:
#!/bin/bash
SOURCE_AGENT="monitoring-hub"
ONCALL_AGENT="oncall-agent"
pilotctl --json subscribe "$SOURCE_AGENT" "alerts.*" --timeout 600 | \
jq -c '.data.events[]' | \
while IFS= read -r event; do
severity=$(echo "$event" | jq -r '.data | fromjson | .severity // "unknown"')
if [ "$severity" = "critical" ]; then
pilotctl --json publish "$ONCALL_AGENT" "oncall.critical" --data "$event"
fi
done
Dependencies
Requires pilot-protocol skill, jq, and a running daemon.
- Downloads
- 973All time
- Security audit
- Pass
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
