Intents and diagnostics
AnnouncementIntent output and AnnouncementDiagnostic decisions for delivery, tests, telemetry, and bounded failure analysis.
AnnouncementIntent
An AnnouncementIntent describes an update prepared by core. It does not confirm that the browser delivered it or that a screen reader spoke it.
Options and return values
idstringRequired
Unique scheduled output identity.
- Default
n/a
atnumberRequired
Injected clock timestamp at delivery.
- Default
n/a
channelpolite | assertiveRequired
Requested urgency for the delivery layer.
- Default
n/a
textstringRequired
Translated text with normalized whitespace.
- Default
n/a
sourceTypeevent typeRequired
Identifies the app event that caused this intent.
- Default
n/a
responseId / toolId / interactionIdstringOptional
Optional source lifecycle correlation.
- Default
undefined
AnnouncementDiagnostic
Diagnostics record runtime decisions for tests and telemetry. Listener failures do not change runtime behavior. Repeated queue-limit decisions can share one diagnostic with a count.
| Disposition | Typical reasons | Meaning |
|---|---|---|
| queued | scheduled | Candidate entered the scheduler |
| merged | coalesced | Pending equivalent work was replaced |
| suppressed | duplicate, policy-silent, stale-response | Policy or identity prevented output |
| cancelled | scope-cancelled, runtime-disposed | Pending work became invalid |
| announced | delivered, delivery-error | Listeners accepted output or every attempt failed |
Options and return values
dispositionDiagnosticDispositionRequired
High-level outcome category.
- Default
n/a
reasonDiagnosticReasonRequired
Stable machine-readable explanation for the decision.
- Default
n/a
countnumberOptional
Number of equivalent decisions represented by an aggregated diagnostic.
- Default
undefined
Versioned runtime observability
subscribeDiagnosticEvents emits each normalized source event before the decisions caused by that dispatch. getDiagnosticSnapshot returns current lifecycle and queue timing without response text, labels, errors, scopes, deduplication keys, or timer handles.
Options and return values
RuntimeDiagnosticEventV1event-observed | decisionEvent
Schema-versioned ordered diagnostic event with injected time and a monotonic sequence.
- Default
n/a
RuntimeDiagnosticSnapshotV1immutable objectSnapshot
Content-free active response, tool, pending announcement, and response flush state.
- Default
n/a
pending.announcementsreadonly DiagnosticPendingAnnouncement[]Snapshot field
Stable correlation, channel, source, scheduling, due-time, delay, and queue sequence fields ordered by due time.
- Default
[]