Compare commits

...

4 Commits

Author SHA1 Message Date
Sampath Kumar
4f81c788ad refactor(docs): fix markdown formatting bugs 2026-04-16 12:29:50 +02:00
Sampath Kumar
7a873c805a refactor(docs): Update cross references for specification sections 3 & 4; 2026-04-16 12:01:37 +02:00
Sampath Kumar
44f7d70735 refactor(docs): Update cross references for swapping section 4 with section 3. 2026-04-16 11:57:44 +02:00
Sampath Kumar
2993cac381 refactor(docs): Move Section 4 (Protocol Data Model), to become the new Section 3.
Right now, Section 3 (Operations) describes how to do things (Send Message, Get Task) using objects that aren't defined until Section 4 (Data Model). This change is aims to fix this by swapping the sections.
2026-04-16 11:34:20 +02:00
3 changed files with 728 additions and 728 deletions

File diff suppressed because it is too large Load Diff

View File

@ -81,7 +81,7 @@ Agent Cards include sensitive information, such as:
To mitigate risks, the following protection mechanisms should be considered:
- **Authenticated Agent Cards:** We recommend the use of [authenticated extended agent cards](../specification.md#3111-get-extended-agent-card) for sensitive information or for serving a more detailed version of the card.
- **Authenticated Agent Cards:** We recommend the use of [authenticated extended agent cards](../specification.md#4111-get-extended-agent-card) for sensitive information or for serving a more detailed version of the card.
- **Secure Endpoints:** Implement access controls on the HTTP endpoint serving the Agent Card (e.g., `/.well-known/agent-card.json` or registry API). The methods include:
- Mutual TLS (mTLS)
- Network restrictions (e.g., IP ranges)

View File

@ -52,7 +52,7 @@ The following key features detail how push notifications are implemented and man
- Separately, using the `CreateTaskPushNotificationConfig` RPC method for an existing task.
The `PushNotificationConfig` includes a `url` (the HTTPS webhook URL), an optional `token` (for client-side validation), and optional `authentication` details (for the A2A Server to authenticate to the webhook).
- **Notification Trigger:** The A2A Server decides when to send a push notification, typically when a task reaches a significant state change (for example, terminal state, `input-required`, or `auth-required`).
- **Notification Payload:** The A2A protocol defines the HTTP body payload as a [`StreamResponse`](../specification.md#323-stream-response) object, matching the format used in streaming operations. The payload contains one of: `task`, `message`, `statusUpdate`, or `artifactUpdate`. See [Push Notification Payload](../specification.md#pushnotificationpayload) for detailed structure.
- **Notification Payload:** The A2A protocol defines the HTTP body payload as a [`StreamResponse`](../specification.md#423-stream-response) object, matching the format used in streaming operations. The payload contains one of: `task`, `message`, `statusUpdate`, or `artifactUpdate`. See [Push Notification Payload](../specification.md#pushnotificationpayload) for detailed structure.
- **Client Action:** Upon receiving a push notification (and successfully verifying its authenticity), the client typically uses the `GetTask` RPC method with the `taskId` from the notification to retrieve the complete, updated `Task` object, including any new artifacts.
### When to Use Push Notifications
@ -67,7 +67,7 @@ Push notifications are ideal for:
Refer to the Protocol Specification for detailed structures:
- [`CreateTaskPushNotificationConfig`](../specification.md#317-create-push-notification-config)
- [`CreateTaskPushNotificationConfig`](../specification.md#417-create-push-notification-config)
- [`GetTask`](../specification.md#76-taskspushnotificationconfigget)
### Client-Side Push Notification Service