nasc_notify
Sends, reads, or acknowledges notifications. send requires for_who, message and human_requested=true, set only after explicit human permission for this message or ongoing notifications within an authorized scope; scoped ongoing permission covers later updates without a new request. Permission to build, fix, deploy, finish work, or generally coordinate with teammates does not itself authorize notifications. Without permission, routine updates stay in the current conversation, with no repeated requests to send FYIs. The flag is the caller's assertion, not consent verification. read returns compact newest-first rows for the caller (own rows plus 'all' broadcasts); FYI types older than 14 days drop out of the default view. ack takes notification_id or notification_ids (max 100). Discovery never grants access. Ambiguous destinations are refused. An explicit project that conflicts with the destination session is rejected.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "nasc_notify"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| who | No | Operator name label. Attribution comes from the authenticated account. | |
| tldr | No | Optional for action=send: a one-line human-facing summary, about 140 characters. A reader shows tldr to the human and uses message as working context. | |
| type | No | ||
| brain | No | Optional exact target org UUID. A send with no brain UUID may resolve an exact project plus named active NASC recipients across current memberships and live grants. Discovery never grants access, and ambiguous matches are refused. | |
| guard | No | Optional for action=send: opaque rider for the mailbox lane's client hooks. The server stores it verbatim and never interprets its shape beyond requiring an object. | |
| limit | No | read: 1-50. Default 10. | |
| action | Yes | ||
| status | No | read. Default active (unacknowledged). | |
| for_who | No | send: name, alias, comma-separated list, array, or 'all' (broadcast). read: filters to that recipient, or 'all' for everyone; omitted, the caller. | |
| message | No | send: the full detail for the AI or teammate session that reads it. | |
| project | No | read: one slug, or 'all' for every project plus org-wide rows; omitted, the personal inbox. send: an exact slug or name locates named recipients; omitted, it comes from the destination, then source, session. 'all' is rejected on send. | |
| verbose | No | read: full bodies. | |
| from_who | No | read: only rows from this person. | |
| session_id | No | Optional session id from nasc_start. Pins this call's authorization, org and project to that session. | |
| for_session | No | Optional for action=send: one session (id, continuity token or alias in the active brain) as the mailbox delivery target; an unresolvable value fails the send, and it defaults type to 'coordination'. For action=read: filters to that session. | |
| include_stale | No | read: includes FYIs older than 14 days. | |
| human_requested | No | send only. true after explicit human permission for this message or ongoing notifications within the authorized recipients, purpose, and duration. An assertion, not verified consent. | |
| notification_id | No | ack: the one to acknowledge. read: that one in full, any status or age. | |
| continuity_token | No | Optional host conversation id. Resolves the active session and pins this call's authorization, org and project to it. | |
| notification_ids | No | ack: a batch, max 100. |