manage-alerts

1# Manage alerts
2 
3Let the user manage their own AlphaAI ticker news-alert subscriptions from the
4chat. Identity comes from the OAuth login — these tools act on the **caller's
5own** account.
6 
7> **Tier-gated.** `alphai_alerts_*` require a **Basic or Pro** plan. On the Free
8> tier they return `tier_not_paid` — relay that and point to
9> <https://alphai.io/pricing> instead of retrying.
10 
11## Steps
12 
131. **Show current state first.** For any add/remove, call `alphai_alerts_list()`
14   up front so you (and the user) can see existing subscriptions, the per-alert
15   filters, and the tier limit (`current` / `limit`).
162. **Subscribe / update.** `alphai_alerts_subscribe(ticker, category_filter?,
17   min_relevance_score?)`.
18   - This is a **partial update**: omitting a field on an *existing* subscription
19     preserves its current value. A brand-new subscription defaults
20     `min_relevance_score` to 6.
21   - `category_filter` is an optional whitelist from the 14 categories (e.g.
22     `["earnings", "insider"]`) — only those categories trigger the alert.
23   - Confirm the ticker is real first if unsure (`alphai_tickers`); the tool
24     raises `unknown_ticker` / `limit_reached` otherwise.
253. **Unsubscribe.** `alphai_alerts_unsubscribe(ticker)` — idempotent; returns
26   `{removed: false}` if it was already inactive.
27 
28## Output
29 
30- After a change, restate the resulting subscription in one line: ticker, which
31  categories trigger it, and the minimum relevance — so the user sees exactly
32…