@adcp/sdk API Reference - v7.9.0
    Preparing search index...

    Interface NotificationMetadata

    Metadata for agent-initiated notifications Same as WebhookMetadata but includes notification-specific fields

    interface NotificationMetadata {
        operation_id: string;
        task_id: string;
        agent_id: string;
        task_type: string;
        status: TaskStatus;
        context_id?: string;
        message?: string;
        timestamp: string;
        rawHTTPPayload?: any;
        protocol?: "mcp" | "a2a";
        idempotency_key?: string;
        notification_type: "scheduled" | "final" | "delayed";
        sequence_number?: number;
        next_expected_at?: string;
    }

    Hierarchy (View Summary)

    Index

    Properties

    operation_id task_id agent_id task_type status context_id? message? timestamp rawHTTPPayload? protocol? idempotency_key? notification_type sequence_number? next_expected_at?

    Properties

    operation_id: string

    Client-provided operation ID

    task_id: string

    Server's task ID

    agent_id: string

    Agent ID

    task_type: string

    Task type/tool name

    status: TaskStatus

    Task status (completed, failed, needs_input, working, etc)

    context_id?: string

    Server's context ID

    message?: string

    Human-readable context about the status change

    timestamp: string

    Timestamp

    rawHTTPPayload?: any

    raw HTTP payload

    protocol?: "mcp" | "a2a"

    Wire protocol that delivered this webhook. Useful for handler code that needs to treat MCP and A2A transports differently (e.g., idempotency_key is only present on MCP payloads).

    idempotency_key?: string

    Sender-generated key stable across retries of the same webhook event (MCP envelope only — A2A webhooks do not carry this field). Use this as the canonical dedup key; see AsyncHandlerConfig.webhookDedup.

    notification_type: "scheduled" | "final" | "delayed"

    Notification type

    sequence_number?: number

    Sequence number of this notification

    next_expected_at?: string

    When next notification is expected (not present for 'final')

    Settings

    Member Visibility

    On This Page

    Properties