Skip to content

Proactive messages ​

The platform assistant (Hush Assistant) does not only answer. It watches the work you own and speaks first when something is worth saying.

This page explains what it says, where to see it, what the buttons do, how to make it more accurate, and why sometimes it says nothing.


What it is ​

It talks about your own work, not platform announcements or marketing:

TypeExample
To-do"The CE order is waiting for you: 1 plan approval · €44.00"
Payment due"The customs order is waiting for payment (2 items)"
Failure"VAT filing failed: the tax portal returned 502"
Stalled"The customs declaration has not moved for 5 days; last step: waiting for supplier receipt"
Just completed"The CE order just completed with 4 deliverables"
In progress"German packaging compliance is still running; currently at customs document review"
Recently discussed"You exchanged 6 messages with the content and SEO adviser — should I summarise the conclusions?"

One message covers one thing, with one button. It does not cram five items into a paragraph and leave you to find the priority.


Where to see it ​

  1. Hush Assistant in the sidebar: a blue dot appears when there is a new proactive message; opening the conversation clears it.
  2. Cards in the conversation: a proactive message renders as a card — title, one line of context (amount / reason / last step / number of deliverables), and a primary button.
  3. "Got it": collapses the card; the text version remains in history.

What the buttons do ​

ButtonWhat happens
Review / Pay / AcceptOpens the task where you approve, pay or accept
View plan / View failure / See where it is stuck / View progress / View resultOpens the same task at the relevant detail
SummariseSends "summarise the recent conclusions" to the assistant
Useful / Not interestedTells it whether this kind of message helps (see below)
Got itOnly collapses the card; changes no state

Buttons carry the task id. If the task is gone, the assistant says so instead of opening a blank page.


When it speaks ​

Two paths share one set of anti-nag rules:

TriggerWhat it saysTiming
Event-levelPlan needs approval, payment due, execution failed, delivery ready to acceptImmediately
Daily digestThe one thing most worth doing today: approval / payment / failure / stalled / just completed / in progress / recently discussedScan every 30 minutes; also checked when you open the workspace

The anti-nag rules (all four matter):

  • At most 3 messages per day. Actionable items (approval, payment, failure, acceptance) are capped at 2; the rest are "status" messages;
  • The same item is mentioned once per 24 hours: "plan ready" and "plan awaiting approval" for the same order are the same item;
  • No interruption while you are talking: if you sent a message in the last 60 seconds, the message is deferred — a minute later is not worse, interrupting is;
  • If nothing is worth saying, say nothing. This is not the same as "nothing is stuck": a completed task, a task in progress, or a recent conversation can all be worth mentioning.

Operations can tune this with PROACTIVE_DAILY_BUDGET (daily cap), PROACTIVE_EVENTS=off (disable event-level messages) and PROACTIVE_SCHEDULER=off (disable the scheduled scan).


Making it more accurate ​

Cards and news messages accept feedback:

  • Useful → this kind of content is weighted up (+2);
  • Not interested → weighted down (-4, and muted after repeated negatives).

The two targets are different:

TargetWhat it affects
News (topic = source)Whether that source is suggested again
Cards (topic = card:<type>)What the daily digest mentions first; dismissed types are skipped

One deliberate boundary: "Not interested" on a card only affects the daily digest. It does not make approval, failure or acceptance alerts disappear — being tired of reminders is different from being willing to miss work that is stuck.

Feedback is stored under your account and can be reviewed or revoked:

bash
# See what the assistant remembers
curl -s /api/proactive/interests -H "Authorization: Bearer <token>"

# Forget a topic (removes "not interested")
curl -X DELETE /api/proactive/interests/<topic> -H "Authorization: Bearer <token>"

What it reads and does not read ​

  • Reads: the state and progress of tasks you own, the number and last time of your conversations with agents, and curated industry news;
  • Does not read: other people's tasks or conversations; it does not copy your conversation text elsewhere;
  • It does not decide for you: approval, payment and acceptance always require your click.

FAQ ​

The card became plain text after a refresh? Check that the browser loaded the latest frontend (in the console, inspect the main module script). If it is an old bundle, hard-refresh with Ctrl+Shift+R.

"View result" does nothing? The card carries a task id. If the task was deleted, it says "task not found; refresh the list and try again".

Can I turn proactive messages off entirely? Currently only per topic ("Not interested"); there is no global switch yet. If you need full mute, the platform can add an account-level switch.


Next ​

Released under the MIT License.