Arch board feedback + beta.2 release preparation

sdk/ai/azure-ai-agents/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Release History
 
-## 2.0.0-beta.2 (Unreleased)
+## 2.0.0-beta.2 (2026-03-04)
 
 ### Features Added
 
@@ -9,7 +9,7 @@
 - Added `action` property to `ImageGenTool` with new `ImageGenActionEnum` (values: `GENERATE`, `EDIT`, `AUTO`).
 - Added `GPT_IMAGE_1_5` to `ImageGenToolModel`.
 - Added container skill types: `ContainerSkill`, `ContainerSkillType`, `ContainerAutoParam`, `ContainerNetworkPolicyParam`, and related network policy types (`ContainerNetworkPolicyAllowlistParam`, `ContainerNetworkPolicyDisabledParam`, `ContainerNetworkPolicyDomainSecretParam`, `ContainerNetworkPolicyParamType`).
-- Added environment configuration for `FunctionShellToolParam` and `InputItemFunctionShellCallItemParam` via new `FunctionShellToolParamEnvironment`, `FunctionShellCallItemParamEnvironment`, and related container/local environment parameter types. `InputItemFunctionShellCallItemParam`, `FunctionShellCallItemParamEnvironment`, and related types moved to `implementation/models` (internal).
+- Added environment configuration for `FunctionShellToolParameter` and `InputItemFunctionShellCallItemParam` via new `FunctionShellToolParamEnvironment`, `FunctionShellCallItemParamEnvironment`, and related container/local environment parameter types. `InputItemFunctionShellCallItemParam`, `FunctionShellCallItemParamEnvironment`, and related types moved to `implementation/models` (internal).
 - Added `MessageContent` and `MessageContentType` model types; subsequently moved to `implementation/models` (internal).
 - Added skill parameter types: `InlineSkillParam`, `InlineSkillSourceParam`, `LocalSkillParam`, `SkillReferenceParam`.
 
@@ -29,6 +29,17 @@
 - `Summary` renamed to `SummaryTextContent` and moved to `implementation/models` (internal).
 - Moved ~100 model classes from `com.azure.ai.agents.models` to `com.azure.ai.agents.implementation.models`, removing them from the public API surface. This includes `InputItem` and all subtypes, `Annotation`, output content types, and related types.
 - Removed public methods from `MemoryStoresClient`/`MemoryStoresAsyncClient`: `searchMemoriesWithResponse` and `beginUpdateMemories` (protocol methods accepting `BinaryData`), `searchMemories(name, scope)` (minimal convenience overload), and `searchMemories`/`beginUpdateMemories` overloads accepting `List<ResponseInputItem>`.
+- Renamed model classes for naming consistency:
+  - `AgentObjectVersions` renamed to `AgentDetailsVersions`
+  - `OpenAIError` renamed to `ApiError`
+  - `AzureFunctionDefinitionFunction` renamed to `AzureFunctionDefinitionDetails`
+- Renamed tool classes from `*Param` suffix to `*Parameter`:
+  - `ApplyPatchToolParam` renamed to `ApplyPatchToolParameter`
+  - `CustomGrammarFormatParam` renamed to `CustomGrammarFormatParameter`
+  - `CustomToolParam` renamed to `CustomToolParameter`
+  - `FunctionShellToolParam` renamed to `FunctionShellToolParameter`
+  - `LocalShellToolParam` renamed to `LocalShellToolParameter`
+- `OpenApiFunctionDefinition`: `getDefaultParams()` and `setDefaultParams()` renamed to `getDefaultParameters()` and `setDefaultParameters()`
 
 ### Bugs Fixed
 

sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentDetails.java

@@ -39,21 +39,7 @@ public final class AgentDetails implements JsonSerializable<AgentDetails> {
      * The latest version of the agent.
      */
     @Generated
-    private final AgentObjectVersions versions;
-
-    /**
-     * Creates an instance of AgentDetails class.
-     *
-     * @param id the id value to set.
-     * @param name the name value to set.
-     * @param versions the versions value to set.
-     */
-    @Generated
-    private AgentDetails(String id, String name, AgentObjectVersions versions) {
-        this.id = id;
-        this.name = name;
-        this.versions = versions;
-    }
+    private final AgentDetailsVersions versions;
 
     /**
      * Get the object property: The object type, which is always 'agent'.
@@ -91,7 +77,7 @@ public String getName() {
      * @return the versions value.
      */
     @Generated
-    public AgentObjectVersions getVersions() {
+    public AgentDetailsVersions getVersions() {
         return this.versions;
     }
 
@@ -123,7 +109,7 @@ public static AgentDetails fromJson(JsonReader jsonReader) throws IOException {
         return jsonReader.readObject(reader -> {
             String id = null;
             String name = null;
-            AgentObjectVersions versions = null;
+            AgentDetailsVersions versions = null;
             while (reader.nextToken() != JsonToken.END_OBJECT) {
                 String fieldName = reader.getFieldName();
                 reader.nextToken();
@@ -132,12 +118,26 @@ public static AgentDetails fromJson(JsonReader jsonReader) throws IOException {
                 } else if ("name".equals(fieldName)) {
                     name = reader.getString();
                 } else if ("versions".equals(fieldName)) {
-                    versions = AgentObjectVersions.fromJson(reader);
+                    versions = AgentDetailsVersions.fromJson(reader);
                 } else {
                     reader.skipChildren();
                 }
             }
             return new AgentDetails(id, name, versions);
         });
     }
+
+    /**
+     * Creates an instance of AgentDetails class.
+     *
+     * @param id the id value to set.
+     * @param name the name value to set.
+     * @param versions the versions value to set.
+     */
+    @Generated
+    private AgentDetails(String id, String name, AgentDetailsVersions versions) {
+        this.id = id;
+        this.name = name;
+        this.versions = versions;
+    }
 }

sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentObjectVersions.java → sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentDetailsVersions.java

@@ -12,17 +12,27 @@
 import java.io.IOException;
 
 /**
- * The AgentObjectVersions model.
+ * The AgentDetailsVersions model.
  */
 @Immutable
-public final class AgentObjectVersions implements JsonSerializable<AgentObjectVersions> {
+public final class AgentDetailsVersions implements JsonSerializable<AgentDetailsVersions> {
 
     /*
      * The latest property.
      */
     @Generated
     private final AgentVersionDetails latest;
 
+    /**
+     * Creates an instance of AgentDetailsVersions class.
+     *
+     * @param latest the latest value to set.
+     */
+    @Generated
+    private AgentDetailsVersions(AgentVersionDetails latest) {
+        this.latest = latest;
+    }
+
     /**
      * Get the latest property: The latest property.
      *
@@ -45,16 +55,16 @@ public JsonWriter toJson(JsonWriter jsonWriter) throws IOException {
     }
 
     /**
-     * Reads an instance of AgentObjectVersions from the JsonReader.
+     * Reads an instance of AgentDetailsVersions from the JsonReader.
      *
      * @param jsonReader The JsonReader being read.
-     * @return An instance of AgentObjectVersions if the JsonReader was pointing to an instance of it, or null if it was
-     * pointing to JSON null.
+     * @return An instance of AgentDetailsVersions if the JsonReader was pointing to an instance of it, or null if it
+     * was pointing to JSON null.
      * @throws IllegalStateException If the deserialized JSON object was missing any required properties.
-     * @throws IOException If an error occurs while reading the AgentObjectVersions.
+     * @throws IOException If an error occurs while reading the AgentDetailsVersions.
      */
     @Generated
-    public static AgentObjectVersions fromJson(JsonReader jsonReader) throws IOException {
+    public static AgentDetailsVersions fromJson(JsonReader jsonReader) throws IOException {
         return jsonReader.readObject(reader -> {
             AgentVersionDetails latest = null;
             while (reader.nextToken() != JsonToken.END_OBJECT) {
@@ -66,17 +76,7 @@ public static AgentObjectVersions fromJson(JsonReader jsonReader) throws IOExcep
                     reader.skipChildren();
                 }
             }
-            return new AgentObjectVersions(latest);
+            return new AgentDetailsVersions(latest);
         });
     }
-
-    /**
-     * Creates an instance of AgentObjectVersions class.
-     *
-     * @param latest the latest value to set.
-     */
-    @Generated
-    private AgentObjectVersions(AgentVersionDetails latest) {
-        this.latest = latest;
-    }
 }

sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OpenAIError.java → sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ApiError.java

@@ -15,10 +15,10 @@
 import java.util.Map;
 
 /**
- * The OpenAIError model.
+ * The ApiError model.
  */
 @Immutable
-public final class OpenAIError implements JsonSerializable<OpenAIError> {
+public final class ApiError implements JsonSerializable<ApiError> {
 
     /*
      * The code property.
@@ -48,7 +48,7 @@ public final class OpenAIError implements JsonSerializable<OpenAIError> {
      * The details property.
      */
     @Generated
-    private List<OpenAIError> details;
+    private List<ApiError> details;
 
     /*
      * The additionalInfo property.
@@ -63,13 +63,13 @@ public final class OpenAIError implements JsonSerializable<OpenAIError> {
     private Map<String, BinaryData> debugInfo;
 
     /**
-     * Creates an instance of OpenAIError class.
+     * Creates an instance of ApiError class.
      *
      * @param code the code value to set.
      * @param message the message value to set.
      */
     @Generated
-    private OpenAIError(String code, String message) {
+    private ApiError(String code, String message) {
         this.code = code;
         this.message = message;
     }
@@ -120,7 +120,7 @@ public String getType() {
      * @return the details value.
      */
     @Generated
-    public List<OpenAIError> getDetails() {
+    public List<ApiError> getDetails() {
         return this.details;
     }
 
@@ -174,22 +174,22 @@ public JsonWriter toJson(JsonWriter jsonWriter) throws IOException {
     }
 
     /**
-     * Reads an instance of OpenAIError from the JsonReader.
+     * Reads an instance of ApiError from the JsonReader.
      *
      * @param jsonReader The JsonReader being read.
-     * @return An instance of OpenAIError if the JsonReader was pointing to an instance of it, or null if it was
-     * pointing to JSON null.
+     * @return An instance of ApiError if the JsonReader was pointing to an instance of it, or null if it was pointing
+     * to JSON null.
      * @throws IllegalStateException If the deserialized JSON object was missing any required properties.
-     * @throws IOException If an error occurs while reading the OpenAIError.
+     * @throws IOException If an error occurs while reading the ApiError.
      */
     @Generated
-    public static OpenAIError fromJson(JsonReader jsonReader) throws IOException {
+    public static ApiError fromJson(JsonReader jsonReader) throws IOException {
         return jsonReader.readObject(reader -> {
             String code = null;
             String message = null;
             String param = null;
             String type = null;
-            List<OpenAIError> details = null;
+            List<ApiError> details = null;
             Map<String, BinaryData> additionalInfo = null;
             Map<String, BinaryData> debugInfo = null;
             while (reader.nextToken() != JsonToken.END_OBJECT) {
@@ -204,7 +204,7 @@ public static OpenAIError fromJson(JsonReader jsonReader) throws IOException {
                 } else if ("type".equals(fieldName)) {
                     type = reader.getString();
                 } else if ("details".equals(fieldName)) {
-                    details = reader.readArray(reader1 -> OpenAIError.fromJson(reader1));
+                    details = reader.readArray(reader1 -> ApiError.fromJson(reader1));
                 } else if ("additionalInfo".equals(fieldName)) {
                     additionalInfo = reader.readMap(reader1 -> reader1
                         .getNullable(nonNullReader -> BinaryData.fromObject(nonNullReader.readUntyped())));
@@ -215,13 +215,13 @@ public static OpenAIError fromJson(JsonReader jsonReader) throws IOException {
                     reader.skipChildren();
                 }
             }
-            OpenAIError deserializedOpenAIError = new OpenAIError(code, message);
-            deserializedOpenAIError.param = param;
-            deserializedOpenAIError.type = type;
-            deserializedOpenAIError.details = details;
-            deserializedOpenAIError.additionalInfo = additionalInfo;
-            deserializedOpenAIError.debugInfo = debugInfo;
-            return deserializedOpenAIError;
+            ApiError deserializedApiError = new ApiError(code, message);
+            deserializedApiError.param = param;
+            deserializedApiError.type = type;
+            deserializedApiError.details = details;
+            deserializedApiError.additionalInfo = additionalInfo;
+            deserializedApiError.debugInfo = debugInfo;
+            return deserializedApiError;
         });
     }
 }

sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ApplyPatchToolParam.java → sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ApplyPatchToolParameter.java

@@ -16,7 +16,7 @@
  * Allows the assistant to create, delete, or update files using unified diffs.
  */
 @Immutable
-public final class ApplyPatchToolParam extends Tool {
+public final class ApplyPatchToolParameter extends Tool {
 
     /*
      * The type property.
@@ -25,10 +25,10 @@ public final class ApplyPatchToolParam extends Tool {
     private ToolType type = ToolType.APPLY_PATCH;
 
     /**
-     * Creates an instance of ApplyPatchToolParam class.
+     * Creates an instance of ApplyPatchToolParameter class.
      */
     @Generated
-    public ApplyPatchToolParam() {
+    public ApplyPatchToolParameter() {
     }
 
     /**
@@ -54,27 +54,27 @@ public JsonWriter toJson(JsonWriter jsonWriter) throws IOException {
     }
 
     /**
-     * Reads an instance of ApplyPatchToolParam from the JsonReader.
+     * Reads an instance of ApplyPatchToolParameter from the JsonReader.
      *
      * @param jsonReader The JsonReader being read.
-     * @return An instance of ApplyPatchToolParam if the JsonReader was pointing to an instance of it, or null if it was
-     * pointing to JSON null.
-     * @throws IOException If an error occurs while reading the ApplyPatchToolParam.
+     * @return An instance of ApplyPatchToolParameter if the JsonReader was pointing to an instance of it, or null if it
+     * was pointing to JSON null.
+     * @throws IOException If an error occurs while reading the ApplyPatchToolParameter.
      */
     @Generated
-    public static ApplyPatchToolParam fromJson(JsonReader jsonReader) throws IOException {
+    public static ApplyPatchToolParameter fromJson(JsonReader jsonReader) throws IOException {
         return jsonReader.readObject(reader -> {
-            ApplyPatchToolParam deserializedApplyPatchToolParam = new ApplyPatchToolParam();
+            ApplyPatchToolParameter deserializedApplyPatchToolParameter = new ApplyPatchToolParameter();
             while (reader.nextToken() != JsonToken.END_OBJECT) {
                 String fieldName = reader.getFieldName();
                 reader.nextToken();
                 if ("type".equals(fieldName)) {
-                    deserializedApplyPatchToolParam.type = ToolType.fromString(reader.getString());
+                    deserializedApplyPatchToolParameter.type = ToolType.fromString(reader.getString());
                 } else {
                     reader.skipChildren();
                 }
             }
-            return deserializedApplyPatchToolParam;
+            return deserializedApplyPatchToolParameter;
         });
     }
 }