Skip to content

Commit 7585a33

Browse files
committed
Move task-augmentation capabilities under tasks.requests for clarity
1 parent 726a4db commit 7585a33

File tree

4 files changed

+251
-225
lines changed

4 files changed

+251
-225
lines changed

docs/specification/draft/basic/utilities/tasks.mdx

Lines changed: 37 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -26,31 +26,33 @@ Servers declare which server-side requests can be augmented with tasks:
2626
{
2727
"capabilities": {
2828
"tasks": {
29-
"tools": {
30-
"call": true,
31-
"list": true
32-
},
33-
"resources": {
34-
"read": true,
35-
"list": true
36-
},
37-
"prompts": {
38-
"get": true,
39-
"list": true
40-
},
41-
"tasks": {
42-
"get": true,
43-
"list": true,
44-
"result": true
29+
"requests": {
30+
"tools": {
31+
"call": true,
32+
"list": true
33+
},
34+
"resources": {
35+
"read": true,
36+
"list": true
37+
},
38+
"prompts": {
39+
"get": true,
40+
"list": true
41+
},
42+
"tasks": {
43+
"get": true,
44+
"list": true,
45+
"result": true
46+
}
4547
}
4648
}
4749
}
4850
}
4951
```
5052

51-
Servers **MAY** support tasks for any subset of their available request types. If a request type is not listed in the `tasks` capability or is set to `false`, requestors **SHOULD NOT** augment those requests with task metadata.
53+
Servers **MAY** support tasks for any subset of their available request types. If a request type is not listed in the `tasks.requests` capability or is set to `false`, requestors **SHOULD NOT** augment those requests with task metadata.
5254

53-
The `tasks.tasks` nested capability indicates whether the task management operations themselves (`tasks/get`, `tasks/list`, `tasks/result`) can be augmented with tasks, enabling recursive task tracking for task queries.
55+
The `tasks.requests.tasks` nested capability indicates whether the task management operations themselves (`tasks/get`, `tasks/list`, `tasks/result`) can be augmented with tasks, enabling recursive task tracking for task queries.
5456

5557
### Client Capabilities
5658

@@ -60,32 +62,34 @@ Clients declare which client-side requests can be augmented with tasks:
6062
{
6163
"capabilities": {
6264
"tasks": {
63-
"sampling": {
64-
"createMessage": true
65-
},
66-
"elicitation": {
67-
"create": true
68-
},
69-
"roots": {
70-
"list": true
71-
},
72-
"tasks": {
73-
"get": true,
74-
"list": true,
75-
"result": true
65+
"requests": {
66+
"sampling": {
67+
"createMessage": true
68+
},
69+
"elicitation": {
70+
"create": true
71+
},
72+
"roots": {
73+
"list": true
74+
},
75+
"tasks": {
76+
"get": true,
77+
"list": true,
78+
"result": true
79+
}
7680
}
7781
}
7882
}
7983
}
8084
```
8185

82-
The `tasks.tasks` capability applies when the client is acting as a receiver of task-augmented requests from the server (for example, when a server sends a task-augmented `sampling/createMessage` request to the client).
86+
The `tasks.requests.tasks` capability applies when the client is acting as a receiver of task-augmented requests from the server (for example, when a server sends a task-augmented `sampling/createMessage` request to the client).
8387

8488
### Capability Negotiation
8589

8690
During the initialization phase, both parties exchange their `tasks` capabilities to establish which operations support task-based execution. Requestors **MUST** only augment requests with task metadata if the corresponding capability has been declared by the receiver.
8791

88-
For example, if a server's capabilities include `tasks.tools.call: true`, then clients may augment `tools/call` requests with task metadata. However, if the server does not declare `tasks.resources.read`, clients should not send task-augmented `resources/read` requests.
92+
For example, if a server's capabilities include `tasks.requests.tools.call: true`, then clients may augment `tools/call` requests with task metadata. However, if the server does not declare `tasks.requests.resources.read`, clients should not send task-augmented `resources/read` requests.
8993

9094
## Protocol Messages
9195

0 commit comments

Comments
 (0)