wavecap-alerts
Manage WaveCap alert rules and keyword triggers. Use when the user wants to view, add, update, or remove alert phrases and notification rules.
When & Why to Use This Skill
The WaveCap Alerts skill provides a comprehensive interface for managing real-time keyword triggers and notification rules. It enables users to programmatically view, add, update, and remove alert phrases within WaveCap streams, ensuring critical information is immediately flagged via audio or visual notifications. This skill is designed to enhance situational awareness and streamline incident response by automating the monitoring of transcription data for high-priority events.
Use Cases
- Emergency Response: Automatically trigger alerts for high-priority keywords such as 'fire', 'medical', or 'emergency' in live audio transcriptions to reduce response times.
- Operational Oversight: Monitor communication streams for specific project names, technical issues, or status updates to keep teams informed of critical developments.
- Dynamic Alert Management: Programmatically update or rotate keyword lists based on changing operational needs, shift schedules, or specific event durations.
- Custom Notification Workflows: Configure tailored alert rules with specific parameters like case sensitivity and audio triggers to filter out noise and focus on relevant data.
| name | wavecap-alerts |
|---|---|
| description | Manage WaveCap alert rules and keyword triggers. Use when the user wants to view, add, update, or remove alert phrases and notification rules. |
WaveCap Alerts Skill
Use this skill to manage keyword alert rules in WaveCap.
Authentication Required
Updating alerts requires editor authentication:
TOKEN=$(curl -s -X POST http://localhost:8000/api/auth/login \
-H "Content-Type: application/json" \
-d '{"password": "YOUR_EDITOR_PASSWORD"}' | jq -r '.token')
View Current Alerts
curl -s http://localhost:8000/api/alerts | jq
Response Format
{
"enabled": true,
"rules": [
{
"id": "rule-1",
"label": "Emergency",
"phrases": ["emergency", "urgent", "mayday"],
"playSound": true,
"notify": true,
"caseSensitive": false,
"enabled": true
}
]
}
Update Alerts
The PUT endpoint replaces the entire alerts configuration:
curl -s -X PUT http://localhost:8000/api/alerts \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"enabled": true,
"rules": [
{
"id": "emergency",
"label": "Emergency",
"phrases": ["emergency", "mayday", "urgent"],
"playSound": true,
"notify": true,
"caseSensitive": false,
"enabled": true
},
{
"id": "fire",
"label": "Fire",
"phrases": ["structure fire", "brush fire", "fire alarm"],
"playSound": true,
"notify": true,
"caseSensitive": false,
"enabled": true
}
]
}' | jq
Alert Rule Fields
| Field | Type | Description |
|---|---|---|
id |
string | Unique identifier for the rule |
label |
string | Display name for the alert |
phrases |
string[] | Keywords/phrases to match |
playSound |
bool | Play audio alert when triggered |
notify |
bool | Show notification when triggered |
caseSensitive |
bool | Match case exactly |
enabled |
bool | Whether rule is active |
Common Operations
Add a New Alert Rule
First get existing alerts, then append the new rule:
# Get current config
CURRENT=$(curl -s http://localhost:8000/api/alerts)
# Add new rule using jq
UPDATED=$(echo "$CURRENT" | jq '.rules += [{
"id": "medical",
"label": "Medical Emergency",
"phrases": ["cardiac arrest", "cpr", "unresponsive"],
"playSound": true,
"notify": true,
"caseSensitive": false,
"enabled": true
}]')
# Update
curl -s -X PUT http://localhost:8000/api/alerts \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "$UPDATED" | jq
Disable a Rule
CURRENT=$(curl -s http://localhost:8000/api/alerts)
UPDATED=$(echo "$CURRENT" | jq '(.rules[] | select(.id == "rule-id")).enabled = false')
curl -s -X PUT http://localhost:8000/api/alerts \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "$UPDATED" | jq
Remove a Rule
CURRENT=$(curl -s http://localhost:8000/api/alerts)
UPDATED=$(echo "$CURRENT" | jq '.rules = [.rules[] | select(.id != "rule-to-remove")]')
curl -s -X PUT http://localhost:8000/api/alerts \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "$UPDATED" | jq
Add Phrases to Existing Rule
CURRENT=$(curl -s http://localhost:8000/api/alerts)
UPDATED=$(echo "$CURRENT" | jq '(.rules[] | select(.id == "emergency")).phrases += ["crisis", "help"]')
curl -s -X PUT http://localhost:8000/api/alerts \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "$UPDATED" | jq
Disable All Alerts
curl -s -X PUT http://localhost:8000/api/alerts \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"enabled": false, "rules": []}' | jq
View Triggered Alerts in Transcriptions
Transcriptions that triggered alerts have an alerts array:
curl -s "http://localhost:8000/api/streams/{STREAM_ID}/transcriptions?limit=100" | \
jq '[.transcriptions[] | select(.alerts | length > 0)] | .[] | {timestamp, text, alerts: [.alerts[].ruleLabel]}'
Tips
- The entire rules array is replaced on PUT - always include all rules you want to keep
- Use descriptive
idvalues for easy reference - Keep
caseSensitive: falsefor most use cases - Test phrases with common variations and misspellings