Delivery Validation • AI Agent SDK

DeliveryValidation: Result of a creation-time delivery-target pre-flight (Issue #3800).

DeliveryValidation

Defined in the protocols module.

Result of a creation-time delivery-target pre-flight (Issue #3800).

A scheduled job or agent-initiated proactive message carries a `DeliveryTarget` whose reachability is otherwise only discovered when the job fires — potentially hours later, where an unroutable target is silently dropped or dead-target self-healed. This closed shape lets a resolver answer “will this route?” the moment the send is created, so the creator gets an immediate, actionable error instead of a late invisible drop.

Attributes: ok: Whether the target resolves to a reachable channel/route. reason: On failure, a human-readable explanation of why it is unroutable (empty when `ok). hint: On failure, an actionable next step (e.g. the configured channels, or a command to list them); empty when ok. preview: A dry-run preview of the destination (e.g. "telegram:@alice (session main)"`) suitable for surfacing to the creator before commit.

Properties

Source