v0.1.0-preview.8

This release corrects the CreateMessageResult.Role type, exposes JsonSerializerOptions configuration across tool and prompt APIs, and adds comprehensive XML documentation comments across the SDK.

Breaking Changes

Refer to the C# SDK Versioning documentation for details on versioning and breaking change policies.

1. Fix CreateMessageResult.Role type #264
   • CreateMessageResult.Role changed from string to Role enum type
   • Migration: Replace string values like "assistant" with Role.Assistant or "user" with Role.User
2. Expose JsonSerializerOptions in prompts APIs #279
   • WithPrompts removed params modifier; added JsonSerializerOptions? serializerOptions parameter
   • Migration: Wrap multiple type arguments in a collection, e.g. WithPrompts([typeof(A), typeof(B)])
3. Expose JsonSerializerOptions in tools APIs #266
   • WithTools removed params modifier; added JsonSerializerOptions? serializerOptions parameter
   • Migration: Wrap multiple type arguments in a collection, e.g. WithTools([typeof(A), typeof(B)])

What's Changed

• Fix CreateMessageRule.Role to be of type Role #264 by @stephentoub
• Delete some dead methods from Log.cs #277 by @stephentoub
• Expose a JsonSerializerOptions setting in the prompts APIs #279 by @eiriktsarpalis

Documentation Updates

• Add XML documentation comments across the SDK #238 by @robch (co-authored by @stephentoub)
• Augment McpServerTool/Prompt docs with details of parameter/result marshaling #271 by @stephentoub

Test Improvements

• Disable STJ reflection for testing #266 by @eiriktsarpalis (co-authored by @stephentoub)

Repository Infrastructure Updates

• Bump version to 0.1.0-preview.8 #256 by @eiriktsarpalis

Acknowledgements

• @robch made their first contribution in #238
• @halter73 reviewed pull requests

Full Changelog: v0.1.0-preview.7...v0.1.0-preview.8