Skip to content

Commit 7dcdd69

Browse files
committed
chore: Rename execution.task to execution.taskSupport
1 parent 970851e commit 7dcdd69

File tree

4 files changed

+18
-18
lines changed

4 files changed

+18
-18
lines changed

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

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -108,15 +108,15 @@ The set of capabilities in `capabilities.tasks.requests` is exhaustive. If a req
108108

109109
### Tool-Level Negotiation
110110

111-
Tool calls are given special consideration for the purpose of task augmentation. In the result of `tools/list`, tools declare support for tasks via `execution.task`, which if present can have a value of `"always"`, `"optional"`, or `"never"`.
111+
Tool calls are given special consideration for the purpose of task augmentation. In the result of `tools/list`, tools declare support for tasks via `execution.taskSupport`, which if present can have a value of `"required"`, `"optional"`, or `"forbidden"`.
112112

113113
This is to be interpreted as a fine-grained layer in addition to capabilities, following these rules:
114114

115-
1. If a server's capabilities do not include `tasks.requests.tools.call`, then clients **MUST NOT** attempt to use task augmentation on that server's tools, regardless of the `execution.task` value.
116-
1. If a server's capabilities include `tasks.requests.tools.call`, then clients consider the value of `execution.task`, and handle it accordingly:
117-
1. If `execution.task` is not present or `"never"`, clients **MUST NOT** attempt to invoke the tool as a task. Servers **SHOULD** return a `-32601` (Method not found) error if a client attempts to do so. This is the default behavior.
118-
1. If `execution.task` is `"optional"`, clients **MAY** invoke the tool as a task or as a normal request.
119-
1. If `execution.task` is `"always"`, clients **MUST** invoke the tool as a task. Servers **MUST** return a `-32601` (Method not found) error if a client does not attempt to do so.
115+
1. If a server's capabilities do not include `tasks.requests.tools.call`, then clients **MUST NOT** attempt to use task augmentation on that server's tools, regardless of the `execution.taskSupport` value.
116+
1. If a server's capabilities include `tasks.requests.tools.call`, then clients consider the value of `execution.taskSupport`, and handle it accordingly:
117+
1. If `execution.taskSupport` is not present or `"forbidden"`, clients **MUST NOT** attempt to invoke the tool as a task. Servers **SHOULD** return a `-32601` (Method not found) error if a client attempts to do so. This is the default behavior.
118+
1. If `execution.taskSupport` is `"optional"`, clients **MAY** invoke the tool as a task or as a normal request.
119+
1. If `execution.taskSupport` is `"required"`, clients **MUST** invoke the tool as a task. Servers **MUST** return a `-32601` (Method not found) error if a client does not attempt to do so.
120120

121121
## Protocol Messages
122122

docs/specification/draft/schema.mdx

Lines changed: 3 additions & 3 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

schema/draft/schema.json

Lines changed: 5 additions & 5 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

schema/draft/schema.ts

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1226,13 +1226,13 @@ export interface ToolExecution {
12261226
* This allows clients to handle long-running operations through polling
12271227
* the task system.
12281228
*
1229-
* - "never": Tool does not support task-augmented execution (default when absent)
1229+
* - "forbidden": Tool does not support task-augmented execution (default when absent)
12301230
* - "optional": Tool may support task-augmented execution
1231-
* - "always": Tool requires task-augmented execution
1231+
* - "required": Tool requires task-augmented execution
12321232
*
1233-
* Default: "never"
1233+
* Default: "forbidden"
12341234
*/
1235-
task?: "never" | "optional" | "always";
1235+
taskSupport?: "forbidden" | "optional" | "required";
12361236
}
12371237

12381238
/**

0 commit comments

Comments
 (0)