modelcontextprotocol/csharp-sdk
Watch
1
0
Fork
You've already forked csharp-sdk
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

Clarify null semantics in ToolAnnotations hint property docs (#1346)

Browse source
This commit is contained in:
Copilot 2026-02-22 22:52:22 -08:00 • committed by GitHub
commit f241b4aafa
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 11 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

22
src/ModelContextProtocol.Core/Protocol/ToolAnnotations.cs
View file

@ -33,11 +33,11 @@ public sealed class ToolAnnotations
/// Gets or sets a value that indicates whether the tool can perform destructive updates to its environment. /// Gets or sets a value that indicates whether the tool can perform destructive updates to its environment.
/// </summary> /// </summary>
/// <value> /// <value>
/// The default is <see langword="true"/>. /// <see langword="true"/> if the tool can perform destructive updates to its environment;
/// <see langword="false"/> if the tool performs only additive updates;
/// <see langword="null"/> if unspecified, in which case clients should assume <see langword="true"/>.
/// </value> /// </value>
/// <remarks> /// <remarks>
/// If <see langword="true"/>, the tool can perform destructive updates to its environment.
/// If <see langword="false"/>, the tool performs only additive updates.
/// This property is most relevant when the tool modifies its environment (ReadOnly = false). /// This property is most relevant when the tool modifies its environment (ReadOnly = false).
/// </remarks> /// </remarks>
[JsonPropertyName("destructiveHint")] [JsonPropertyName("destructiveHint")]
@ -49,8 +49,8 @@ public sealed class ToolAnnotations
/// </summary> /// </summary>
/// <value> /// <value>
/// <see langword="true"/> if calling the tool repeatedly with the same arguments /// <see langword="true"/> if calling the tool repeatedly with the same arguments
/// has no additional effect on the environment; <see langword="false"/> if it does. /// has no additional effect on the environment; <see langword="false"/> if it does;
/// The default is <see langword="false"/>. /// <see langword="null"/> if unspecified, in which case clients should assume <see langword="false"/>.
/// </value> /// </value>
/// <remarks> /// <remarks>
/// This property is most relevant when the tool modifies its environment (ReadOnly = false). /// This property is most relevant when the tool modifies its environment (ReadOnly = false).
@ -62,9 +62,9 @@ public sealed class ToolAnnotations
/// Gets or sets a value that indicates whether this tool can interact with an "open world" of external entities. /// Gets or sets a value that indicates whether this tool can interact with an "open world" of external entities.
/// </summary> /// </summary>
/// <value> /// <value>
/// <see langword="true"/> if the tool can interact with an unpredictable or dynamic set of entities (like web search). /// <see langword="true"/> if the tool can interact with an unpredictable or dynamic set of entities (like web search);
/// <see langword="false"/> if the tool's domain of interaction is closed and well-defined (like memory access). /// <see langword="false"/> if the tool's domain of interaction is closed and well-defined (like memory access);
/// The default is <see langword="true"/>. /// <see langword="null"/> if unspecified, in which case clients should assume <see langword="true"/>.
/// </value> /// </value>
[JsonPropertyName("openWorldHint")] [JsonPropertyName("openWorldHint")]
public bool? OpenWorldHint { get; set; } public bool? OpenWorldHint { get; set; }
@ -73,9 +73,9 @@ public sealed class ToolAnnotations
/// Gets or sets a value that indicates whether this tool modifies its environment. /// Gets or sets a value that indicates whether this tool modifies its environment.
/// </summary> /// </summary>
/// <value> /// <value>
/// <see langword="true"/> if the tool only performs read operations without changing state. /// <see langword="true"/> if the tool only performs read operations without changing state;
/// <see langword="false"/> if the tool can make modifications to its environment. /// <see langword="false"/> if the tool can make modifications to its environment;
/// The default is <see langword="false"/>. /// <see langword="null"/> if unspecified, in which case clients should assume <see langword="false"/>.
/// </value> /// </value>
/// <remarks> /// <remarks>
/// <para> /// <para>