Add ModelContextProtocol.Core package (#428)

src/ModelContextProtocol.Core/Client/StdioClientTransportOptions.cs

@@ -0,0 +1,72 @@
+namespace ModelContextProtocol.Client;
+
+/// <summary>
+/// Provides options for configuring <see cref="StdioClientTransport"/> instances.
+/// </summary>
+public class StdioClientTransportOptions
+{
+    /// <summary>
+    /// Gets or sets the command to execute to start the server process.
+    /// </summary>
+    public required string Command
+    {
+        get;
+        set
+        {
+            if (string.IsNullOrWhiteSpace(value))
+            {
+                throw new ArgumentException("Command cannot be null or empty.", nameof(value));
+            }
+
+            field = value;
+        }
+    }
+
+    /// <summary>
+    /// Gets or sets the arguments to pass to the server process when it is started.
+    /// </summary>
+    public IList<string>? Arguments { get; set; }
+
+    /// <summary>
+    /// Gets or sets a transport identifier used for logging purposes.
+    /// </summary>
+    public string? Name { get; set; }
+
+    /// <summary>
+    /// Gets or sets the working directory for the server process.
+    /// </summary>
+    public string? WorkingDirectory { get; set; }
+
+    /// <summary>
+    /// Gets or sets environment variables to set for the server process.
+    /// </summary>
+    /// <remarks>
+    /// <para>
+    /// This property allows you to specify environment variables that will be set in the server process's
+    /// environment. This is useful for passing configuration, authentication information, or runtime flags
+    /// to the server without modifying its code.
+    /// </para>
+    /// <para>
+    /// By default, when starting the server process, the server process will inherit the current environment's variables,
+    /// as discovered via <see cref="Environment.GetEnvironmentVariables()"/>. After those variables are found, the entries
+    /// in this <see cref="EnvironmentVariables"/> dictionary are used to augment and overwrite the entries read from the environment.
+    /// That includes removing the variables for any of this collection's entries with a null value.
+    /// </para>
+    /// </remarks>
+    public Dictionary<string, string?>? EnvironmentVariables { get; set; }
+
+    /// <summary>
+    /// Gets or sets the timeout to wait for the server to shut down gracefully.
+    /// </summary>
+    /// <remarks>
+    /// <para>
+    /// This property dictates how long the client should wait for the server process to exit cleanly during shutdown
+    /// before forcibly terminating it. This balances between giving the server enough time to clean up 
+    /// resources and not hanging indefinitely if a server process becomes unresponsive.
+    /// </para>
+    /// <para>
+    /// The default is five seconds.
+    /// </para>
+    /// </remarks>
+    public TimeSpan ShutdownTimeout { get; set; } = TimeSpan.FromSeconds(5);
+}