Final Java Fixes (Azure#48620)

* regen

* final regen for enums

* update samples, readme, tests, changelogs

Author: kaylieee

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

@@ -8,7 +8,22 @@
 
 ### Breaking Changes
 
-- `MemoryStoreUpdateStatus` changed from a standard Java `enum` to an `ExpandableStringEnum`-based class. The `values()` method now returns a `Collection` instead of an array, and instances should be compared using `.equals()` rather than `==`.
+- The following types changed from standard Java `enum` to `ExpandableStringEnum`-based classes, allowing unknown values to be handled without throwing exceptions. The `values()` method now returns a `Collection` instead of an array, and instances should be compared using `.equals()` rather than `==`:
+  - `ComputerEnvironment`
+  - `ContainerMemoryLimit`
+  - `GrammarSyntax`
+  - `ImageGenActionEnum`
+  - `ImageGenToolBackground`
+  - `ImageGenToolModeration`
+  - `ImageGenToolOutputFormat`
+  - `ImageGenToolQuality`
+  - `ImageGenToolSize`
+  - `InputFidelity`
+  - `McpToolConnectorId`
+  - `MemoryStoreUpdateStatus`
+  - `RankerVersionType`
+  - `SearchContextSize`
+  - `WebSearchToolSearchContextSize`
 - Renamed `getObject()` to `getObjectType()` in `AgentDetails`, `AgentVersionDetails`, and `MemoryStoreDetails`. The underlying field was renamed from `object` to `objectType`.
 - Renamed `MCPToolConnectorId` enum to `McpToolConnectorId` for consistent casing. The `McpTool` methods `getConnectorType()` and `setConnectorType()` now use `McpToolConnectorId` instead of `MCPToolConnectorId`.
 - `getContainerAsAutoCodeInterpreterToolParam()` on `CodeInterpreterTool` renamed to `getContainerAsAutoCodeInterpreterToolParameter()`, and `setContainer(AutoCodeInterpreterToolParam)` now accepts `AutoCodeInterpreterToolParameter` instead.

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

@@ -1,71 +1,75 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 // Code generated by Microsoft (R) TypeSpec Code Generator.
-
 package com.azure.ai.agents.models;
 
+import com.azure.core.annotation.Generated;
+import com.azure.core.util.ExpandableStringEnum;
+import java.util.Collection;
+
 /**
  * Defines values for ComputerEnvironment.
  */
-public enum ComputerEnvironment {
+public final class ComputerEnvironment extends ExpandableStringEnum<ComputerEnvironment> {
+
     /**
-     * Enum value windows.
+     * Static value windows for ComputerEnvironment.
      */
-    WINDOWS("windows"),
+    @Generated
+    public static final ComputerEnvironment WINDOWS = fromString("windows");
 
     /**
-     * Enum value mac.
+     * Static value mac for ComputerEnvironment.
      */
-    MAC("mac"),
+    @Generated
+    public static final ComputerEnvironment MAC = fromString("mac");
 
     /**
-     * Enum value linux.
+     * Static value linux for ComputerEnvironment.
      */
-    LINUX("linux"),
+    @Generated
+    public static final ComputerEnvironment LINUX = fromString("linux");
 
     /**
-     * Enum value ubuntu.
+     * Static value ubuntu for ComputerEnvironment.
      */
-    UBUNTU("ubuntu"),
+    @Generated
+    public static final ComputerEnvironment UBUNTU = fromString("ubuntu");
 
     /**
-     * Enum value browser.
+     * Static value browser for ComputerEnvironment.
      */
-    BROWSER("browser");
+    @Generated
+    public static final ComputerEnvironment BROWSER = fromString("browser");
 
     /**
-     * The actual serialized value for a ComputerEnvironment instance.
+     * Creates a new instance of ComputerEnvironment value.
+     *
+     * @deprecated Use the {@link #fromString(String)} factory method.
      */
-    private final String value;
-
-    ComputerEnvironment(String value) {
-        this.value = value;
+    @Generated
+    @Deprecated
+    public ComputerEnvironment() {
     }
 
     /**
-     * Parses a serialized value to a ComputerEnvironment instance.
-     * 
-     * @param value the serialized value to parse.
-     * @return the parsed ComputerEnvironment object, or null if unable to parse.
+     * Creates or finds a ComputerEnvironment from its string representation.
+     *
+     * @param name a name to look for.
+     * @return the corresponding ComputerEnvironment.
      */
-    public static ComputerEnvironment fromString(String value) {
-        if (value == null) {
-            return null;
-        }
-        ComputerEnvironment[] items = ComputerEnvironment.values();
-        for (ComputerEnvironment item : items) {
-            if (item.toString().equalsIgnoreCase(value)) {
-                return item;
-            }
-        }
-        return null;
+    @Generated
+    public static ComputerEnvironment fromString(String name) {
+        return fromString(name, ComputerEnvironment.class);
     }
 
     /**
-     * {@inheritDoc}
+     * Gets known ComputerEnvironment values.
+     *
+     * @return known ComputerEnvironment values.
      */
-    @Override
-    public String toString() {
-        return this.value;
+    @Generated
+    public static Collection<ComputerEnvironment> values() {
+        return values(ComputerEnvironment.class);
     }
 }

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

@@ -1,66 +1,69 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 // Code generated by Microsoft (R) TypeSpec Code Generator.
-
 package com.azure.ai.agents.models;
 
+import com.azure.core.annotation.Generated;
+import com.azure.core.util.ExpandableStringEnum;
+import java.util.Collection;
+
 /**
  * Defines values for ContainerMemoryLimit.
  */
-public enum ContainerMemoryLimit {
+public final class ContainerMemoryLimit extends ExpandableStringEnum<ContainerMemoryLimit> {
+
     /**
-     * Enum value 1g.
+     * Static value 1g for ContainerMemoryLimit.
      */
-    MEMORY_1GB("1g"),
+    @Generated
+    public static final ContainerMemoryLimit MEMORY_1GB = fromString("1g");
 
     /**
-     * Enum value 4g.
+     * Static value 4g for ContainerMemoryLimit.
      */
-    MEMORY_4GB("4g"),
+    @Generated
+    public static final ContainerMemoryLimit MEMORY_4GB = fromString("4g");
 
     /**
-     * Enum value 16g.
+     * Static value 16g for ContainerMemoryLimit.
      */
-    MEMORY_16GB("16g"),
+    @Generated
+    public static final ContainerMemoryLimit MEMORY_16GB = fromString("16g");
 
     /**
-     * Enum value 64g.
+     * Static value 64g for ContainerMemoryLimit.
      */
-    MEMORY_64GB("64g");
+    @Generated
+    public static final ContainerMemoryLimit MEMORY_64GB = fromString("64g");
 
     /**
-     * The actual serialized value for a ContainerMemoryLimit instance.
+     * Creates a new instance of ContainerMemoryLimit value.
+     *
+     * @deprecated Use the {@link #fromString(String)} factory method.
      */
-    private final String value;
-
-    ContainerMemoryLimit(String value) {
-        this.value = value;
+    @Generated
+    @Deprecated
+    public ContainerMemoryLimit() {
     }
 
     /**
-     * Parses a serialized value to a ContainerMemoryLimit instance.
-     * 
-     * @param value the serialized value to parse.
-     * @return the parsed ContainerMemoryLimit object, or null if unable to parse.
+     * Creates or finds a ContainerMemoryLimit from its string representation.
+     *
+     * @param name a name to look for.
+     * @return the corresponding ContainerMemoryLimit.
      */
-    public static ContainerMemoryLimit fromString(String value) {
-        if (value == null) {
-            return null;
-        }
-        ContainerMemoryLimit[] items = ContainerMemoryLimit.values();
-        for (ContainerMemoryLimit item : items) {
-            if (item.toString().equalsIgnoreCase(value)) {
-                return item;
-            }
-        }
-        return null;
+    @Generated
+    public static ContainerMemoryLimit fromString(String name) {
+        return fromString(name, ContainerMemoryLimit.class);
     }
 
     /**
-     * {@inheritDoc}
+     * Gets known ContainerMemoryLimit values.
+     *
+     * @return known ContainerMemoryLimit values.
      */
-    @Override
-    public String toString() {
-        return this.value;
+    @Generated
+    public static Collection<ContainerMemoryLimit> values() {
+        return values(ContainerMemoryLimit.class);
     }
 }

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

@@ -1,56 +1,57 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 // Code generated by Microsoft (R) TypeSpec Code Generator.
-
 package com.azure.ai.agents.models;
 
+import com.azure.core.annotation.Generated;
+import com.azure.core.util.ExpandableStringEnum;
+import java.util.Collection;
+
 /**
  * Defines values for GrammarSyntax.
  */
-public enum GrammarSyntax {
+public final class GrammarSyntax extends ExpandableStringEnum<GrammarSyntax> {
+
     /**
-     * Enum value lark.
+     * Static value lark for GrammarSyntax.
      */
-    LARK("lark"),
+    @Generated
+    public static final GrammarSyntax LARK = fromString("lark");
 
     /**
-     * Enum value regex.
+     * Static value regex for GrammarSyntax.
      */
-    REGEX("regex");
+    @Generated
+    public static final GrammarSyntax REGEX = fromString("regex");
 
     /**
-     * The actual serialized value for a GrammarSyntax instance.
+     * Creates a new instance of GrammarSyntax value.
+     *
+     * @deprecated Use the {@link #fromString(String)} factory method.
      */
-    private final String value;
-
-    GrammarSyntax(String value) {
-        this.value = value;
+    @Generated
+    @Deprecated
+    public GrammarSyntax() {
     }
 
     /**
-     * Parses a serialized value to a GrammarSyntax instance.
-     * 
-     * @param value the serialized value to parse.
-     * @return the parsed GrammarSyntax object, or null if unable to parse.
+     * Creates or finds a GrammarSyntax from its string representation.
+     *
+     * @param name a name to look for.
+     * @return the corresponding GrammarSyntax.
      */
-    public static GrammarSyntax fromString(String value) {
-        if (value == null) {
-            return null;
-        }
-        GrammarSyntax[] items = GrammarSyntax.values();
-        for (GrammarSyntax item : items) {
-            if (item.toString().equalsIgnoreCase(value)) {
-                return item;
-            }
-        }
-        return null;
+    @Generated
+    public static GrammarSyntax fromString(String name) {
+        return fromString(name, GrammarSyntax.class);
     }
 
     /**
-     * {@inheritDoc}
+     * Gets known GrammarSyntax values.
+     *
+     * @return known GrammarSyntax values.
      */
-    @Override
-    public String toString() {
-        return this.value;
+    @Generated
+    public static Collection<GrammarSyntax> values() {
+        return values(GrammarSyntax.class);
     }
 }