Merge pull request #51 from neuroglia-io/feat-align-part-with-a2a-0.3.0

cdavernas · web-flow · commit 650d49a29ce3 · 2026-01-29T11:04:47.000+01:00
feat: align the `Part` model with A2A specification `v0.3.0`
diff --git a/src/A2A.Client.Abstractions/A2A.Client.Abstractions.csproj b/src/A2A.Client.Abstractions/A2A.Client.Abstractions.csproj
@@ -5,7 +5,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Client</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Client.Transports.Grpc/A2A.Client.Transports.Grpc.csproj b/src/A2A.Client.Transports.Grpc/A2A.Client.Transports.Grpc.csproj
@@ -5,7 +5,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Client.Transports</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Client.Transports.Grpc/A2AGrpcMapper.cs b/src/A2A.Client.Transports.Grpc/A2AGrpcMapper.cs
@@ -135,10 +135,10 @@ public static Models.Part MapFromGrpc(Part source)
             },
             Part.PartOneofCase.File => new Models.FilePart()
             {
-                Name = source.File.Name,
+                FileName = source.File.Name,
                 MediaType = source.File.MediaType,
-                Uri = string.IsNullOrWhiteSpace(source.File.FileWithUri) ? null : new Uri(source.File.FileWithUri),
-                Bytes = source.File.FileWithBytes.IsEmpty ? null : source.File.FileWithBytes.ToByteArray()
+                Url = string.IsNullOrWhiteSpace(source.File.FileWithUri) ? null : new Uri(source.File.FileWithUri),
+                Raw = source.File.FileWithBytes.IsEmpty ? null : source.File.FileWithBytes.ToByteArray()
             },
             Part.PartOneofCase.Data => new Models.DataPart()
             {
@@ -281,10 +281,10 @@ public static Part MapToGrpc(Models.Part source)
             {
                 File = new FilePart()
                 {
-                    Name = filePart.Name,
+                    Name = filePart.FileName,
                     MediaType = filePart.MediaType,
-                    FileWithUri = filePart.Uri?.OriginalString ?? string.Empty,
-                    FileWithBytes = filePart.Bytes == null ? ByteString.Empty : ByteString.CopyFrom(filePart.Bytes.Value.ToArray())
+                    FileWithUri = filePart.Url?.OriginalString ?? string.Empty,
+                    FileWithBytes = filePart.Raw == null ? ByteString.Empty : ByteString.CopyFrom(filePart.Raw.Value.ToArray())
                 }
             },
             Models.DataPart dataPart => new Part()
diff --git a/src/A2A.Client.Transports.Http/A2A.Client.Transports.Http.csproj b/src/A2A.Client.Transports.Http/A2A.Client.Transports.Http.csproj
@@ -5,7 +5,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Client.Transports</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Client.Transports.JsonRpc/A2A.Client.Transports.JsonRpc.csproj b/src/A2A.Client.Transports.JsonRpc/A2A.Client.Transports.JsonRpc.csproj
@@ -5,7 +5,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Client.Transports</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Client/A2A.Client.csproj b/src/A2A.Client/A2A.Client.csproj
@@ -5,7 +5,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Client</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Core.JsonRpc/A2A.Core.JsonRpc.csproj b/src/A2A.Core.JsonRpc/A2A.Core.JsonRpc.csproj
@@ -5,7 +5,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Core/A2A.Core.csproj b/src/A2A.Core/A2A.Core.csproj
@@ -5,7 +5,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Core/Models/FilePart.cs b/src/A2A.Core/Models/FilePart.cs
@@ -26,28 +26,21 @@ public sealed record FilePart
     /// Gets the file's name, if any.
     /// </summary>
     [Description("The file's name, if any.")]
-    [DataMember(Order = 1, Name = "name"), JsonPropertyOrder(1), JsonPropertyName("name")]
-    public string? Name { get; init; }
+    [DataMember(Order = 1, Name = "filename"), JsonPropertyOrder(1), JsonPropertyName("filename")]
+    public string? FileName { get; init; }
 
     /// <summary>
-    /// Gets the file's media type, if any.
+    /// Gets the file's URL, if any. Required if 'raw' is not set.
     /// </summary>
-    [Description("The file's media type, if any.")]
-    [DataMember(Order = 2, Name = "mediaType"), JsonPropertyOrder(2), JsonPropertyName("mediaType")]
-    public string? MediaType { get; init; }
+    [Description("The file's URL, if any. Required if 'raw' is not set.")]
+    [DataMember(Order = 3, Name = "url"), JsonPropertyOrder(3), JsonPropertyName("url")]
+    public Uri? Url { get; init; }
 
     /// <summary>
-    /// Gets the file's URI, if any. Required if 'bytes' is not set.
+    /// Gets the file's bytes, if any. Required if 'url' is not set.
     /// </summary>
-    [Description("The file's URI, if any. Required if 'bytes' is not set.")]
-    [DataMember(Order = 3, Name = "fileWithUri"), JsonPropertyOrder(3), JsonPropertyName("fileWithUri")]
-    public Uri? Uri { get; init; }
-
-    /// <summary>
-    /// Gets the file's bytes, if any. Required if 'uri' is not set.
-    /// </summary>
-    [Description("The file's bytes, if any. Required if 'uri' is not set.")]
-    [DataMember(Order = 4, Name = "fileWithBytes"), JsonPropertyOrder(4), JsonPropertyName("fileWithBytes")]
-    public ReadOnlyMemory<byte>? Bytes { get; init; }
+    [Description("The file's bytes, if any. Required if 'url' is not set.")]
+    [DataMember(Order = 4, Name = "raw"), JsonPropertyOrder(4), JsonPropertyName("raw")]
+    public ReadOnlyMemory<byte>? Raw { get; init; }
 
 }
diff --git a/src/A2A.Core/Models/Part.cs b/src/A2A.Core/Models/Part.cs
@@ -25,6 +25,13 @@ namespace A2A.Models;
 public abstract record Part
 {
 
+    /// <summary>
+    /// Gets the part content's media type, if any.
+    /// </summary>
+    [Description("The part content's media type, if any.")]
+    [DataMember(Order = 0, Name = "mediaType"), JsonPropertyOrder(0), JsonPropertyName("mediaType")]
+    public string? MediaType { get; init; }
+
     /// <summary>
     /// Gets a key/value mapping, if any, containing metadata associated with the part.
     /// </summary>
diff --git a/src/A2A.Extensions.A2UI/A2A.Extensions.A2UI.csproj b/src/A2A.Extensions.A2UI/A2A.Extensions.A2UI.csproj
@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Extensions</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Server.Abstractions/A2A.Server.Abstractions.csproj b/src/A2A.Server.Abstractions/A2A.Server.Abstractions.csproj
@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Server</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Server.AspNetCore/A2A.Server.csproj b/src/A2A.Server.AspNetCore/A2A.Server.csproj
@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Server</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Server.Persistence.Memory/A2A.Server.Persistence.Memory.csproj b/src/A2A.Server.Persistence.Memory/A2A.Server.Persistence.Memory.csproj
@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Server</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Server.Persistence.Redis/A2A.Server.Persistence.Redis.csproj b/src/A2A.Server.Persistence.Redis/A2A.Server.Persistence.Redis.csproj
@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Server</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Server.Scheduling.Memory/A2A.Server.Scheduling.Memory.csproj b/src/A2A.Server.Scheduling.Memory/A2A.Server.Scheduling.Memory.csproj
@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Server</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Server.Scheduling.Quartz/A2A.Server.Scheduling.Quartz.csproj b/src/A2A.Server.Scheduling.Quartz/A2A.Server.Scheduling.Quartz.csproj
@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Server</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Server.Transports.Grpc/A2A.Server.Transports.Grpc.csproj b/src/A2A.Server.Transports.Grpc/A2A.Server.Transports.Grpc.csproj
@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Server.Transports</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Server.Transports.Grpc/A2AGrpcMapper.cs b/src/A2A.Server.Transports.Grpc/A2AGrpcMapper.cs
@@ -63,10 +63,10 @@ public static Models.Part MapFromGrpc(Part source)
             },
             Part.PartOneofCase.File => new Models.FilePart()
             {
-                Name = source.File.Name,
+                FileName = source.File.Name,
                 MediaType = source.File.MediaType,
-                Uri = string.IsNullOrWhiteSpace(source.File.FileWithUri) ? null : new Uri(source.File.FileWithUri),
-                Bytes = source.File.FileWithBytes.IsEmpty ? null : source.File.FileWithBytes.ToByteArray()
+                Url = string.IsNullOrWhiteSpace(source.File.FileWithUri) ? null : new Uri(source.File.FileWithUri),
+                Raw = source.File.FileWithBytes.IsEmpty ? null : source.File.FileWithBytes.ToByteArray()
             },
             Part.PartOneofCase.Data => new Models.DataPart()
             {
@@ -167,10 +167,10 @@ public static Part MapToGrpc(Models.Part source)
             {
                 File = new FilePart()
                 {
-                    Name = filePart.Name,
+                    Name = filePart.FileName,
                     MediaType = filePart.MediaType,
-                    FileWithUri = filePart.Uri?.OriginalString ?? string.Empty,
-                    FileWithBytes = filePart.Bytes == null ? ByteString.Empty : ByteString.CopyFrom(filePart.Bytes.Value.ToArray())
+                    FileWithUri = filePart.Url?.OriginalString ?? string.Empty,
+                    FileWithBytes = filePart.Raw == null ? ByteString.Empty : ByteString.CopyFrom(filePart.Raw.Value.ToArray())
                 }
             },
             Models.DataPart dataPart => new Part()
diff --git a/src/A2A.Server.Transports.Http/A2A.Server.Transports.Http.csproj b/src/A2A.Server.Transports.Http/A2A.Server.Transports.Http.csproj
@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Server.Transports</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/src/A2A.Server.Transports.JsonRpc/A2A.Server.Transports.JsonRpc.csproj b/src/A2A.Server.Transports.JsonRpc/A2A.Server.Transports.JsonRpc.csproj
@@ -6,7 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 	<RootNamespace>A2A.Server.Transports</RootNamespace>
-    <VersionPrefix>0.19.0</VersionPrefix>
+    <VersionPrefix>0.20.0</VersionPrefix>
     <AssemblyVersion>$(VersionPrefix)</AssemblyVersion>
     <FileVersion>$(VersionPrefix)</FileVersion>
     <NeutralLanguage>en</NeutralLanguage>
diff --git a/tests/A2A.UnitTests/Services/PartFactory.cs b/tests/A2A.UnitTests/Services/PartFactory.cs
@@ -30,9 +30,9 @@ internal static class PartFactory
 
     internal static FilePart CreateUriFilePart() => new()
     {
-        Name = "example.txt",
+        FileName = "example.txt",
         MediaType = "text/plain",
-        Uri = new Uri("https://example.com/example.txt"),
+        Url = new Uri("https://example.com/example.txt"),
         Metadata = new Dictionary<string, JsonNode>
         {
             ["metaKey"] = "metaValue"
@@ -41,9 +41,9 @@ internal static class PartFactory
 
     internal static FilePart CreateDataFilePart() => new()
     {
-        Name = "example.txt",
+        FileName = "example.txt",
         MediaType = "text/plain",
-        Bytes = Encoding.UTF8.GetBytes("This is an example file content."),
+        Raw = Encoding.UTF8.GetBytes("This is an example file content."),
         Metadata = new Dictionary<string, JsonNode>
         {
             ["metaKey"] = "metaValue"

Original file line number	Diff line number	Diff line change
`@@ -135,10 +135,10 @@ public static Models.Part MapFromGrpc(Part source)`
`135`	`135`	`},`
`136`	`136`	`Part.PartOneofCase.File => new Models.FilePart()`
`137`	`137`	`{`
`138`		`- Name = source.File.Name,`
	`138`	`+ FileName = source.File.Name,`
`139`	`139`	`MediaType = source.File.MediaType,`
`140`		`- Uri = string.IsNullOrWhiteSpace(source.File.FileWithUri) ? null : new Uri(source.File.FileWithUri),`
`141`		`- Bytes = source.File.FileWithBytes.IsEmpty ? null : source.File.FileWithBytes.ToByteArray()`
	`140`	`+ Url = string.IsNullOrWhiteSpace(source.File.FileWithUri) ? null : new Uri(source.File.FileWithUri),`
	`141`	`+ Raw = source.File.FileWithBytes.IsEmpty ? null : source.File.FileWithBytes.ToByteArray()`
`142`	`142`	`},`
`143`	`143`	`Part.PartOneofCase.Data => new Models.DataPart()`
`144`	`144`	`{`
`@@ -281,10 +281,10 @@ public static Part MapToGrpc(Models.Part source)`
`281`	`281`	`{`
`282`	`282`	`File = new FilePart()`
`283`	`283`	`{`
`284`		`- Name = filePart.Name,`
	`284`	`+ Name = filePart.FileName,`
`285`	`285`	`MediaType = filePart.MediaType,`
`286`		`- FileWithUri = filePart.Uri?.OriginalString ?? string.Empty,`
`287`		`- FileWithBytes = filePart.Bytes == null ? ByteString.Empty : ByteString.CopyFrom(filePart.Bytes.Value.ToArray())`
	`286`	`+ FileWithUri = filePart.Url?.OriginalString ?? string.Empty,`
	`287`	`+ FileWithBytes = filePart.Raw == null ? ByteString.Empty : ByteString.CopyFrom(filePart.Raw.Value.ToArray())`
`288`	`288`	`}`
`289`	`289`	`},`
`290`	`290`	`Models.DataPart dataPart => new Part()`