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

Extract Tasks into the ModelContextProtocol.Extensions.Tasks extension package (#1693)

Browse source 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Tarek Mahmoud Sayed <tarekms@ntdev.microsoft.com>
This commit is contained in:
Jeff Handley 2026-07-14 15:53:58 -07:00 • committed by GitHub
commit 2ca96f548b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 2559 additions and 1895 deletions
Download patch file Download diff file Expand all files Collapse all files

76
src/ModelContextProtocol.Core/Protocol/ResultOrCreatedTask.cs
View file

@ -1,76 +0,0 @@
namespace ModelContextProtocol.Protocol;
/// <summary>
/// Represents the result of a request that supports task-augmented execution, which may be either
/// the standard result or a <see cref="CreateTaskResult"/> indicating asynchronous processing.
/// </summary>
/// <typeparam name="TResult">The standard result type for the request (e.g., <see cref="CallToolResult"/>).</typeparam>
/// <remarks>
/// <para>
/// When a server supports the <c>io.modelcontextprotocol/tasks</c> extension and the client declares
/// the extension capability on its request, the server may return a <see cref="CreateTaskResult"/>
/// instead of the standard result. This type represents that polymorphic response.
/// </para>
/// <para>
/// Use <see cref="IsTask"/> to determine which variant was returned, then access either
/// <see cref="Result"/> for the immediate result or <see cref="TaskCreated"/> for the task handle.
/// </para>
/// <para>
/// See the <see href="https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/seps/2663-tasks-extension.md">SEP-2663</see>
/// specification for details.
/// </para>
/// </remarks>
public class ResultOrCreatedTask<TResult> where TResult : Result
{
private readonly TResult? _result;
private readonly CreateTaskResult? _taskCreated;
/// <summary>
/// Initializes a new instance of <see cref="ResultOrCreatedTask{TResult}"/> with an immediate result.
/// </summary>
/// <param name="result">The standard result returned by the server.</param>
public ResultOrCreatedTask(TResult result)
{
Throw.IfNull(result);
_result = result;
}
/// <summary>
/// Initializes a new instance of <see cref="ResultOrCreatedTask{TResult}"/> with a task handle.
/// </summary>
/// <param name="taskCreated">The task creation result returned by the server.</param>
public ResultOrCreatedTask(CreateTaskResult taskCreated)
{
Throw.IfNull(taskCreated);
_taskCreated = taskCreated;
}
/// <summary>
/// Gets a value indicating whether the server created a task instead of returning an immediate result.
/// </summary>
public bool IsTask => _taskCreated is not null;
/// <summary>
/// Gets the immediate result, or <see langword="null"/> if the server created a task.
/// </summary>
public TResult? Result => _result;
/// <summary>
/// Gets the task creation result, or <see langword="null"/> if the server returned an immediate result.
/// </summary>
public CreateTaskResult? TaskCreated => _taskCreated;
/// <summary>
/// Implicitly converts a <typeparamref name="TResult"/> to a <see cref="ResultOrCreatedTask{TResult}"/>
/// wrapping the immediate result.
/// </summary>
/// <param name="result">The result to wrap.</param>
public static implicit operator ResultOrCreatedTask<TResult>(TResult result) => new(result);
/// <summary>
/// Implicitly converts a <see cref="CreateTaskResult"/> to a <see cref="ResultOrCreatedTask{TResult}"/>
/// wrapping the task handle.
/// </summary>
/// <param name="taskCreated">The task creation result to wrap.</param>
public static implicit operator ResultOrCreatedTask<TResult>(CreateTaskResult taskCreated) => new(taskCreated);
}