Skip to content

Commit 0e0f8d7

Browse files
committed
linting fixes
1 parent 6790a30 commit 0e0f8d7

File tree

1 file changed

+20
-13
lines changed

1 file changed

+20
-13
lines changed

docs/specification.md

Lines changed: 20 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -983,7 +983,7 @@ Retrieves the current push notification configuration for a specified task. Requ
983983

984984
</div>
985985

986-
**Response `error` type (on failure)**: [`JSONRPCError`](#612-jsonrpcerror-object) (e.g., [`PushNotificationNotSupportedError`](#82-a2a-specific-errors), [`TaskNotFoundError`](#82-a2a-specific-errors)).
986+
**Response `error` type (on failure)**: [`JSONRPCError`](#612-jsonrpcerror-object) (e.g., [`PushNotificationNotSupportedError`](#822-a2a-specific-json-rpc-errors), [`TaskNotFoundError`](#822-a2a-specific-json-rpc-errors)).
987987

988988
#### 7.6.1. `GetTaskPushNotificationConfigParams` Object (`tasks/pushNotificationConfig/get`)
989989

@@ -1039,7 +1039,7 @@ Deletes an associated push notification configuration for a task. Requires the s
10391039

10401040
- **Request `params` type**: [`DeleteTaskPushNotificationConfigParams`](#781-deletetaskpushnotificationconfigparams-object-taskspushnotificationconfigdelete)
10411041
- **Response `result` type (on success)**: [`null`]
1042-
- **Response `error` type (on failure)**: [`JSONRPCError`](#612-jsonrpcerror-object) (e.g., [`PushNotificationNotSupportedError`](#82-a2a-specific-errors), [`TaskNotFoundError`](#82-a2a-specific-errors)).
1042+
- **Response `error` type (on failure)**: [`JSONRPCError`](#612-jsonrpcerror-object) (e.g., [`PushNotificationNotSupportedError`](#822-a2a-specific-json-rpc-errors), [`TaskNotFoundError`](#822-a2a-specific-json-rpc-errors)).
10431043

10441044
#### 7.8.1. `DeleteTaskPushNotificationConfigParams` Object (`tasks/pushNotificationConfig/delete`)
10451045

@@ -1235,6 +1235,7 @@ google.rpc.Status {
12351235
```
12361236

12371237
Error details **SHOULD** include:
1238+
12381239
- `google.rpc.ErrorInfo` with A2A-specific reason codes
12391240
- `google.rpc.RequestInfo` with request identification
12401241
- `google.rpc.ResourceInfo` for resource-related errors (e.g., task not found)
@@ -1284,27 +1285,33 @@ HTTP+JSON/REST implementations **MUST** return error responses with `Content-Typ
12841285
"error": {
12851286
"code": "A2A_ERROR_CODE",
12861287
"message": "Human-readable error description",
1287-
"details": {
1288-
"type": "ERROR_TYPE",
1289-
"reason": "SPECIFIC_REASON_CODE",
1290-
"domain": "a2a.protocol",
1291-
"metadata": {
1292-
"key": "value"
1288+
"details": [
1289+
{
1290+
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
1291+
"reason": "SPECIFIC_REASON_CODE",
1292+
"domain": "a2a.protocol",
1293+
"metadata": {
1294+
"key": "value"
1295+
}
1296+
},
1297+
{
1298+
"@type": "type.googleapis.com/google.rpc.RequestInfo",
1299+
"requestId": "client-request-id"
12931300
}
1294-
}
1301+
]
12951302
},
1296-
"request_id": "client-request-id",
12971303
"timestamp": "2024-03-15T10:30:00Z"
12981304
}
12991305
```
13001306

13011307
**Required fields:**
1308+
13021309
- `error.code`: A2A-specific error identifier (e.g., "TASK_NOT_FOUND")
13031310
- `error.message`: Human-readable error description
13041311

13051312
**Optional fields:**
1306-
- `error.details`: Additional structured error information
1307-
- `request_id`: Client-provided request identifier for tracing
1313+
1314+
- `error.details`: An array of objects containing additional structured error information.
13081315
- `timestamp`: ISO 8601 timestamp when the error occurred
13091316

13101317
#### 8.4.4. HTTP Error Headers
@@ -2156,7 +2163,7 @@ For a client to be considered **A2A-compliant**, it **MUST**:
21562163
#### 11.2.2. Protocol Implementation
21572164

21582165
- **Core method usage**: **MUST** properly construct requests for at least `message/send` and `tasks/get` methods.
2159-
- **Error handling**: **MUST** properly handle all A2A error codes defined in [Section 8.2](#82-a2a-specific-errors).
2166+
- **Error handling**: **MUST** properly handle all A2A error codes defined in [Section 8.2](#822-a2a-specific-json-rpc-errors).
21602167
- **Authentication**: **MUST** support at least one authentication method when interacting with agents that require authentication.
21612168

21622169
#### 11.2.3. Optional Client Features

0 commit comments

Comments
 (0)