Struct TaskPushNotificationConfig 

pub struct TaskPushNotificationConfig {
    pub tenant: Option<String>,
    pub id: Option<String>,
    pub task_id: Option<String>,
    pub url: String,
    pub token: Option<String>,
    pub authentication: Option<AuthenticationInfo>,
}

Configuration for delivering task updates to a webhook endpoint.

In v1.0, this is a single flat type combining the previous PushNotificationConfig and TaskPushNotificationConfig.

token is a secret and is redacted in the Debug representation (presence shown, value hidden), as is any credentials inside authentication, so a {:?} of a config tree cannot leak the shared secret into logs. Serialization is unaffected.

Fields

tenant: Option<String>

Optional tenant identifier for multi-tenancy.

id: Option<String>

Server-assigned configuration identifier.

Absent when first creating the config; populated in the server response.

task_id: Option<String>

The task for which push notifications are configured.

Optional in the canonical protocol schema: a config nested in SendMessageConfiguration legitimately omits it (the task does not exist yet), and servers assign it from context. A standalone CreateTaskPushNotificationConfig call does require it — the server rejects a missing task ID there with an invalid-params error.

url: String

HTTPS URL of the client’s webhook endpoint.

token: Option<String>

Optional shared secret for request verification.

authentication: Option<AuthenticationInfo>

Authentication details the agent should use when calling the webhook.

Implementations

impl TaskPushNotificationConfig

pub fn new( task_id: impl Into<String>, url: impl Into<String>, ) -> TaskPushNotificationConfig

Creates a minimal config with a task ID and URL.

pub fn validate(&self) -> Result<(), String>

Validates this configuration.

Errors

Returns an error string if:

• The URL is empty or uses an unsupported scheme
• The task ID is present but empty (an absent task ID is valid on the wire; whether it is required depends on context — e.g. the server’s CreateTaskPushNotificationConfig handler requires it)

Note: http URLs are accepted for development/testing environments. Production deployments should enforce HTTPS.

Trait Implementations

impl AcceptedFields for TaskPushNotificationConfig

fn accepted_fields() -> &'static [&'static str]

Every JSON key this type accepts, sorted, with no duplicates.

impl Clone for TaskPushNotificationConfig

fn clone(&self) -> TaskPushNotificationConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TaskPushNotificationConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskPushNotificationConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<TaskPushNotificationConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<TaskPushNotificationConfig> for TaskPushNotificationConfig

fn from(value: TaskPushNotificationConfig) -> TaskPushNotificationConfig

Converts to this type from the input type.

impl From<TaskPushNotificationConfig> for TaskPushNotificationConfig

fn from(value: TaskPushNotificationConfig) -> TaskPushNotificationConfig

Converts to this type from the input type.

impl Serialize for TaskPushNotificationConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.