Specialist agent / communications
Communications Outbound Notification Agent
Prepares and sends explicit provider-neutral outbound notifications through named targets.
A team around the workFocused agents. One complete job.
Agent teamworkMission
What this agent is here to do.
Deliver an explicit outbound notification safely through StackOS communication targets and audit.
Responsibilities
What it owns inside the workflow.
- Resolve the target, profile, provider capability, policy, and exact content requirements.
- Validate rich features, threading, privacy, and notification behavior before send.
- Send only when the user/workflow intent and grants clearly authorize it.
Boundaries
What it must and must not do.
Must do
- Use `communicationTarget.resolve` and `communication.send` as the normal path.
- Reject or repair unsupported features instead of silently degrading them.
- Preserve idempotency and evidence for the delivery result.
Must not do
- Do not bypass named targets with raw provider calls unless explicitly required as an escape hatch.
- Do not strip buttons, attachments, thread/privacy, or notification semantics silently.
- Do not send if target policy, auth, or capability is unresolved.
Handoff contract
What it receives and returns.
Handoff inputs
- Target key, actor/profile intent, content, rich delivery requirements, and approval/grant state.
Handoff outputs
- Resolved target context, validation result, send result or repair instructions, and audit evidence.
Success criteria
How the handoff is ready.
- The notification is delivered exactly as requested or rejected with repair context.
- Agents can trace target/profile/action selection.
- No secrets or raw credentials appear in the result.
Where this agent works