Implement SEP-1577: Sampling With Tools

[DaleSeo]

Closes #552

Motivation and Context

This PR implements SEP-1577: Sampling With Tools, enabling MCP servers to run agentic loops using the client's LLM while maintaining user supervision.

Key additions:

• ToolChoice / ToolChoiceMode - Control tool selection behavior
• ToolUseContent / ToolResultContent - Tool calling content types
• SamplingContent<T> - Single or array content wrapper
• SamplingMessageContent - Unified content enum with ToolUse and ToolResult variants
• SamplingCapability - Structured capability with tools and context sub-capabilities

Reference implementations:

• TypeScript SDK: Implement SEP-1577 - Sampling With Tools typescript-sdk#1101
• Python SDK: Implement SEP-1577 - Sampling With Tools python-sdk#1594

How Has This Been Tested?

• New unit tests covering serialization, deserialization, and API usage for all new types
• All existing tests updated and passing

Breaking Changes

Yes, users will need to update code that uses sampling:

1. SamplingMessage.content changed from Content to SamplingContent<SamplingMessageContent>

   // Before
   let msg = SamplingMessage { role: Role::User, content: Content::text("hi") };
   
   // After
   let msg = SamplingMessage::user_text("hi");
   let msg = SamplingMessage::user_text("Hello");
   let msg = SamplingMessage::assistant_text("Hi there");
   
   // Or construct manually
   let msg = SamplingMessage::new(Role::User, SamplingMessageContent::text("Hello"));

2. ClientCapabilities.sampling changed from Option<JsonObject> to Option<SamplingCapability>

   • Empty {} JSON still deserializes correctly (backward compatible)

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update

Checklist

• I have read the MCP Documentation
• My code follows the repository's style guidelines
• New and existing tests pass locally
• I have added appropriate error handling
• I have added or updated documentation as needed

Additional context

// Advertise capability
let capabilities = ClientCapabilities::builder()
    .enable_sampling()
    .enable_sampling_tools()
    .build();

// Create request with tools
let params = CreateMessageRequestParams {
    messages: vec![SamplingMessage::user_text("What's the weather?")],
    tools: Some(vec![weather_tool]),
    tool_choice: Some(ToolChoice::auto()),
    max_tokens: 1000,
    ..Default::default()
};

// Handle tool use response  
if result.stop_reason.as_deref() == Some(CreateMessageResult::STOP_REASON_TOOL_USE) {
    for content in result.message.content.iter() {
        if let Some(tool_use) = content.as_tool_use() {
            // Execute tool and continue conversation
        }
    }
}