docs: add FixSpec wrapper for CreateMessageResult schema divergence

Document the intentional divergence between SDK's CreateMessageResult
(single content for v1.x backwards compat) and the spec's version
(array content per SEP-1577).

The full array-capable type is available as CreateMessageResultWithTools.
This will be aligned with schema in v2.0.

Author: felixweinberger

src/spec.types.test.ts

@@ -80,6 +80,16 @@ type FixSpecInitializeRequest<T> = T extends { params: infer P } ? Omit<T, 'para
 
 type FixSpecClientRequest<T> = T extends { params: infer P } ? Omit<T, 'params'> & { params: FixSpecInitializeRequestParams<P> } : T;
 
+// Targeted fix: CreateMessageResult in SDK uses single content for v1.x backwards compat.
+// The full array-capable type is CreateMessageResultWithTools.
+// This will be aligned with schema in v2.0.
+type FixSpecCreateMessageResult<T> = T extends { content: infer C; stopReason?: infer S }
+    ? Omit<T, 'content' | 'stopReason'> & {
+          content: C extends (infer U)[] ? U : C;
+          stopReason?: Exclude<S, 'toolUse'>;
+      }
+    : T;
+
 const sdkTypeChecks = {
     RequestParams: (sdk: RemovePassthrough<SDKTypes.RequestParams>, spec: SpecTypes.RequestParams) => {
         sdk = spec;
@@ -369,7 +379,10 @@ const sdkTypeChecks = {
         sdk = spec;
         spec = sdk;
     },
-    CreateMessageResult: (sdk: RemovePassthrough<SDKTypes.CreateMessageResult>, spec: SpecTypes.CreateMessageResult) => {
+    CreateMessageResult: (
+        sdk: RemovePassthrough<SDKTypes.CreateMessageResult>,
+        spec: FixSpecCreateMessageResult<SpecTypes.CreateMessageResult>
+    ) => {
         sdk = spec;
         spec = sdk;
     },