Kaylie (kaylieee) · Oct 1, 2026 · Oct 2, 2026 · Oct 2, 2026 · Oct 2, 2026 · Oct 5, 2026
diff --git a/eng/versioning/version_client.txt b/eng/versioning/version_client.txt
@@ -37,7 +37,7 @@ com.azure:azure-data-sdk-parent;1.3.0;1.3.0
 com.azure:azure-sdk-parent;1.6.0;1.6.0
 com.azure:azure-client-sdk-parent;1.7.0;1.7.0
 com.azure:azure-ai-agents-persistent;1.0.0-beta.2;1.0.0-beta.3
-com.azure:azure-ai-agents;2.8.0;2.9.0-beta.1
+com.azure:azure-ai-agents;2.8.0;2.9.0
 com.azure:azure-ai-contentsafety;1.0.21;1.1.0-beta.2
 com.azure:azure-ai-contentunderstanding;1.0.0;1.1.0-beta.4
 com.azure:azure-ai-discovery;1.0.0-beta.1;1.0.0-beta.2
@@ -51,7 +51,7 @@ com.azure:azure-ai-openai;1.0.0-beta.16;1.0.0-beta.17
 com.azure:azure-ai-openai-assistants;1.0.0-beta.5;1.0.0-beta.6
 com.azure:azure-ai-openai-realtime;1.0.0-beta.1;1.0.0-beta.1
 com.azure:azure-ai-openai-stainless;1.0.0-beta.1;1.0.0-beta.1
-com.azure:azure-ai-projects;2.8.0;2.9.0-beta.1
+com.azure:azure-ai-projects;2.8.0;2.9.0
 com.azure:azure-ai-speech-transcription;1.0.0;1.1.0-beta.1
 com.azure:azure-ai-textanalytics;5.5.16;5.6.0-beta.1
 com.azure:azure-ai-textanalytics-perf;1.0.0-beta.1;1.0.0-beta.1

@@ -1,15 +1,52 @@
 # Release History
 
-## 2.9.0-beta.1 (Unreleased)
+## 2.9.0 (2026-10-30)
 
 ### Features Added
 
+- Added hosted-agent memory snapshot opt-in through `HostedAgentDefinition.setEnableMemorySnapshot(...)` and
+  `isEnableMemorySnapshot()`. Sessions for a snapshot-enabled agent version start from a snapshot of its initialized
+  process instead of starting the process from its image.
+- Added preview voice-agent soundscapes through `VoiceAgentDefinition.setSoundscape(...)`,
+  `VoiceAgentSoundscapeConfiguration`, and related track and built-in sound models. Soundscapes support background
+  ambience, delayed working audio while tools are pending, and opening, transfer, and closing cues. Rendering is
+  currently limited to telephony calls; persisted conversation recordings do not include the soundscape mix.
+- Added preview input-transcript profanity filtering through `VoiceAgentInputTranscription.setProfanityFilter(...)`
+  and `VoiceAgentProfanityFilterMode`, with `MASKED`, `REMOVED`, and `UNFILTERED` modes. Filtering is supported with
+  managed Azure Speech, including Custom Speech, and must be configured before the session starts.
+- Added `VoiceAgentInputTranscriptionModel.AZURE_SPEECH_STREAMING` for preview streaming Azure Speech transcription
+  in cascaded text-model conversations. It requires a nonempty language setting and supports Custom Speech,
+  phrase hints, and profanity filtering; it is not supported with realtime speech-to-speech models.
+- Added preview `VoiceAgentNoiseReductionType.AZURE_DEEP_NOISE_SUPPRESSION_HEADSET` and
+  `AZURE_PERSONAL_NOISE_SUPPRESSION` modes for local voice activity detection. These modes enhance detection audio
+  without changing the audio used for recognition.
+- Added preview `AgentEndpointProtocol.VOICE_CONVERSATION_ENGINE` for the hosted-agent text conversation protocol
+  used by Voice Live Bridge. Audio transport remains outside this protocol.
+
 ### Breaking Changes
 
+- Updated the preview hosted voice conversation-engine contract: hosted agents referenced by
+  `VoiceHostedAgentConversationEngine` must declare `voice_conversation_engine` version `1.0.0`.
+  Declaring `invocations_ws` is optional and no longer substitutes for the dedicated voice conversation-engine protocol.
+
 ### Bugs Fixed
 
+- Fixed cursor-based list operations that stopped after the first page, including memory-store, memory-item,
+  toolbox, and voice-agent listings. Paging now follows the service's `last_id` cursor and supports resuming from
+  a continuation token.
+- Fixed cursor-based paging to stop when the service returns `has_more: false`, even if the response still includes
+  a `last_id`, avoiding unnecessary requests after the final page.
+
 ### Other Changes
 
+- Deprecated `BrowserAutomationPreviewTool`, `BrowserAutomationPreviewToolboxTool`, and the corresponding
+  `BROWSER_AUTOMATION_PREVIEW` tool-type values. Use `BrowserAutomationTool`, `BrowserAutomationToolboxTool`,
+  and the `BROWSER_AUTOMATION` values instead. See [Browser Automation documentation](https://aka.ms/bat/docs).
+- Regenerated the client from the updated Foundry TypeSpec specification.
+- Updated `azure-core` from `1.60.0` to `1.61.0` and `azure-core-http-netty` from `1.16.8` to `1.17.0`.
+- Updated Reactor Netty from `1.2.18` to `1.3.7` and Netty from `4.1.138.Final` to `4.2.19.Final`,
+  including the Netty codec module changes required by the newer runtime.
+
 ## 2.8.0 (2026-10-19)
 
 ### Features Added

@@ -31,7 +31,7 @@ Various documentation is available to help you get started
 <dependency>
     <groupId>com.azure</groupId>
     <artifactId>azure-ai-agents</artifactId>
-    <version>2.8.0</version>
+    <version>2.9.0</version>
 </dependency>
 ```
 [//]: # ({x-version-update-end})
@@ -160,7 +160,7 @@ The SDK supports a variety of tools that can be attached to agent definitions. S
 | Tool class | Description |
 |---|---|
 | `BingCustomSearchPreviewTool` | Bing custom search |
-| `BrowserAutomationPreviewTool` | Browser automation |
+| `BrowserAutomationPreviewTool` | Deprecated; use `BrowserAutomationTool` |
 | `ComputerUsePreviewTool` | Computer use |
 | `FabricIqPreviewTool` | Fabric IQ |
 | `MemorySearchPreviewTool` | Memory search |
@@ -662,6 +662,9 @@ See the full sample in [SharePointGroundingSync.java](https://github.com/Azure/a
 
 Interact with web pages using `BrowserAutomationTool`. For toolbox configuration, use `BrowserAutomationToolboxTool`.
 
+The legacy `BrowserAutomationPreviewTool` and `BrowserAutomationPreviewToolboxTool` are deprecated and no longer available.
+Use `BrowserAutomationTool` and `BrowserAutomationToolboxTool` instead. See [Browser Automation documentation](https://aka.ms/bat/docs).
+
 ```java com.azure.ai.agents.define_browser_automation
 // Create browser automation tool with connection configuration
 BrowserAutomationTool browserTool = new BrowserAutomationTool(

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "java",
   "TagPrefix": "java/ai/azure-ai-agents",
-  "Tag": "java/ai/azure-ai-agents_27635be873"
+  "Tag": "java/ai/azure-ai-agents_bab0385d9d"
 }
@@ -5,6 +5,7 @@ class;com.azure.ai.agents.models.A2AToolCall;Preview API. preview_tool;
 class;com.azure.ai.agents.models.A2AToolCallOutput;Preview API. preview_tool;
 field;com.azure.ai.agents.models.AgentDetails;Preview API. DigitalWorker=V1Preview;digital_worker_type
 field;com.azure.ai.agents.models.AgentEndpointProtocol;Preview API.;VOICE
+field;com.azure.ai.agents.models.AgentEndpointProtocol;Preview API.;VOICE_CONVERSATION_ENGINE
 class;com.azure.ai.agents.models.AgentHarness;Preview API. GitHubCopilot=V1Preview, MicrosoftCopilot=V1Preview;
 field;com.azure.ai.agents.models.AgentKind;Preview API.;VOICE
 field;com.azure.ai.agents.models.AgentVersionDetails;Preview API. DraftAgents=V1Preview;draft
@@ -282,6 +283,7 @@ class;com.azure.ai.agents.models.VoiceAgentMaxOutputTokens;Preview API. VoiceAge
 class;com.azure.ai.agents.models.VoiceAgentMcpTool;Preview API. VoiceAgents=V1Preview;
 class;com.azure.ai.agents.models.VoiceAgentNoiseReduction;Preview API. VoiceAgents=V1Preview;
 class;com.azure.ai.agents.models.VoiceAgentNoiseReductionType;Preview API. VoiceAgents=V1Preview;
+class;com.azure.ai.agents.models.VoiceAgentProfanityFilterMode;Preview API. VoiceAgents=V1Preview;
 class;com.azure.ai.agents.models.VoiceAgentRealtimeResponse;Preview API. VoiceAgents=V1Preview;
 class;com.azure.ai.agents.models.VoiceAgentResponseAnimationBlendshapeDeltaEvent;Preview API. VoiceAgents=V1Preview;
 class;com.azure.ai.agents.models.VoiceAgentResponseAnimationBlendshapeDoneEvent;Preview API. VoiceAgents=V1Preview;
@@ -312,6 +314,11 @@ class;com.azure.ai.agents.models.VoiceAgentSessionSubagentCompletedEvent;Preview
 class;com.azure.ai.agents.models.VoiceAgentSessionSubagentStartedEvent;Preview API. VoiceAgents=V1Preview;
 class;com.azure.ai.agents.models.VoiceAgentSessionUpdate;Preview API. VoiceAgents=V1Preview;
 class;com.azure.ai.agents.models.VoiceAgentSessionUpdateConfiguration;Preview API. VoiceAgents=V1Preview;
+class;com.azure.ai.agents.models.VoiceAgentSoundscapeConfiguration;Preview API. VoiceAgents=V1Preview;
+class;com.azure.ai.agents.models.VoiceAgentSoundscapeSound;Preview API. VoiceAgents=V1Preview;
+class;com.azure.ai.agents.models.VoiceAgentSoundscapeSourceConfiguration;Preview API. VoiceAgents=V1Preview;
+class;com.azure.ai.agents.models.VoiceAgentSoundscapeTrackConfiguration;Preview API. VoiceAgents=V1Preview;
+class;com.azure.ai.agents.models.VoiceAgentSoundscapeWorkingTrackConfiguration;Preview API. VoiceAgents=V1Preview;
 class;com.azure.ai.agents.models.VoiceAgentStaticInterimResponseConfiguration;Preview API. VoiceAgents=V1Preview;
 class;com.azure.ai.agents.models.VoiceAgentSubagent;Preview API. VoiceAgents=V1Preview;
 class;com.azure.ai.agents.models.VoiceAgentSubagentAbortReason;Preview API. VoiceAgents=V1Preview;

@@ -14,6 +14,8 @@
 import com.github.javaparser.ast.expr.NormalAnnotationExpr;
 import com.github.javaparser.ast.expr.ObjectCreationExpr;
 import com.github.javaparser.ast.expr.StringLiteralExpr;
+import com.github.javaparser.ast.nodeTypes.NodeWithAnnotations;
+import com.github.javaparser.ast.nodeTypes.NodeWithJavadoc;
 import com.github.javaparser.ast.stmt.ExpressionStmt;
 import java.io.IOException;
 import java.io.UncheckedIOException;
@@ -39,6 +41,7 @@ public void customize(LibraryCustomization libraryCustomization, Logger logger)
         customizeOptimizationPollingStrategies(libraryCustomization, logger);
         stopPagingWhenHasMoreIsFalse(libraryCustomization, logger);
         internalizeUnusedVoiceAgentFunctionToolType(libraryCustomization, logger);
+        deprecateLegacyBrowserAutomationTools(libraryCustomization);
         protectPolymorphicBaseConstructors(libraryCustomization);
         makeRealtimeMessageDiscriminatorsFinal(libraryCustomization);
         applyUnionTypeWrappers(libraryCustomization, logger);
@@ -76,6 +79,50 @@ private void stopPagingWhenHasMoreIsFalse(LibraryCustomization customization, Lo
 
     private static final String MODELS_PACKAGE = "com.azure.ai.agents.models";
 
+    private void deprecateLegacyBrowserAutomationTools(LibraryCustomization customization) {
+        for (String className : Arrays.asList("BrowserAutomationPreviewTool", "BrowserAutomationPreviewToolboxTool")) {
+            customization.getClass(MODELS_PACKAGE, className).customizeAst(ast -> {
+                ClassOrInterfaceDeclaration clazz = ast.getClassByName(className)
+                    .orElseThrow(() -> new IllegalStateException(className + " was not generated"));
+                deprecateBrowserAutomationNode(clazz, className.replace("Preview", ""));
+            });
+        }
+
+        customization.getClass(MODELS_PACKAGE, "ToolType").customizeAst(ast -> {
+            FieldDeclaration field = ast.getClassByName("ToolType")
+                .orElseThrow(() -> new IllegalStateException("ToolType was not generated"))
+                .getFieldByName("BROWSER_AUTOMATION_PREVIEW")
+                .orElseThrow(() -> new IllegalStateException("ToolType.BROWSER_AUTOMATION_PREVIEW was not generated"));
+            deprecateBrowserAutomationNode(field, "ToolType#BROWSER_AUTOMATION");
+        });
+
+        customization.getClass(MODELS_PACKAGE, "ToolboxToolType")
+            .customizeAst(ast -> deprecateBrowserAutomationNode(
+                ast.getEnumByName("ToolboxToolType")
+                    .orElseThrow(() -> new IllegalStateException("ToolboxToolType was not generated"))
+                    .getEntries()
+                    .stream()
+                    .filter(entry -> "BROWSER_AUTOMATION_PREVIEW".equals(entry.getNameAsString()))
+                    .findFirst()
+                    .orElseThrow(() -> new IllegalStateException(
+                        "ToolboxToolType.BROWSER_AUTOMATION_PREVIEW was not generated")),
+                "ToolboxToolType#BROWSER_AUTOMATION"));
+    }
+
+    private <T extends Node & NodeWithAnnotations<T> & NodeWithJavadoc<T>> void deprecateBrowserAutomationNode(T node,
+        String replacement) {
+        if (!node.isAnnotationPresent(Deprecated.class)) {
+            node.addMarkerAnnotation(Deprecated.class);
+        }
+        com.github.javaparser.javadoc.Javadoc javadoc = node.getJavadoc()
+            .orElseThrow(() -> new IllegalStateException("Missing Javadoc for legacy Browser Automation API"));
+        javadoc.getBlockTags().removeIf(tag -> "deprecated".equals(tag.getTagName()));
+        javadoc.addBlockTag("deprecated",
+            "This legacy Browser Automation tool is deprecated and is no longer available. Use {@link " + replacement
+                + "} instead. See <a href=\"https://aka.ms/bat/docs\">Browser Automation documentation</a>.");
+        node.setJavadocComment(javadoc);
+    }
+
     private static final String UNION_MARKER = "AI Tooling: union type";
 
     private static final String DEDUP_MARKER = "AI Tooling: openai-java de-dup";
@@ -819,7 +866,9 @@ private void annotateBetaFields(LibraryCustomization customization, List<String[
     }
 
     private void annotateMember(TypeDeclaration<?> type, String member, String description, Logger logger) {
-        String fieldName = toCamelCase(member);
+        String fieldName = type.getFields().stream()
+            .flatMap(field -> field.getVariables().stream())
+            .anyMatch(variable -> variable.getNameAsString().equals(member)) ? member : toCamelCase(member);
         boolean found = false;
 
         for (FieldDeclaration field : type.getFields()) {

@@ -14,7 +14,7 @@
 
   <groupId>com.azure</groupId>
   <artifactId>azure-ai-agents</artifactId>
-  <version>2.9.0-beta.1</version> <!-- {x-version-update;com.azure:azure-ai-agents;current} -->
+  <version>2.9.0</version> <!-- {x-version-update;com.azure:azure-ai-agents;current} -->
   <packaging>jar</packaging>
 
   <name>Microsoft Azure SDK for Agents</name>

@@ -86,4 +86,12 @@ public static Collection<AgentEndpointProtocol> values() {
     @Generated
     @Beta(warningText = "Preview API.")
     public static final AgentEndpointProtocol VOICE = fromString("voice");
+
+    /**
+     * Text conversation protocol for a hosted agent used by Voice Live Bridge. Declare version `1.0.0`; audio transport
+     * remains outside this protocol.
+     */
+    @Generated
+    @Beta(warningText = "Preview API.")
+    public static final AgentEndpointProtocol VOICE_CONVERSATION_ENGINE = fromString("voice_conversation_engine");
 }
@@ -13,8 +13,15 @@
 
 /**
  * The input definition information for a Browser Automation Tool, as used to configure an Agent.
+ * BrowserAutomationPreviewTool is deprecated.
+ * Please use BrowserAutomationTool instead.
+ * See https://aka.ms/bat/docs for more information on Browser automation tool.
+ *
+ * @deprecated This legacy Browser Automation tool is deprecated and is no longer available. Use
+ * {@link BrowserAutomationTool} instead. See <a href="https://aka.ms/bat/docs">Browser Automation documentation</a>.
  */
 @Immutable
+@Deprecated
 @Beta(warningText = "Preview API. preview_tool")
 public final class BrowserAutomationPreviewTool extends Tool {
 

@@ -14,8 +14,16 @@
 
 /**
  * A browser automation tool stored in a toolbox.
+ * BrowserAutomationPreviewToolboxTool is deprecated.
+ * Please use BrowserAutomationToolboxTool instead.
+ * See https://aka.ms/bat/docs for more information on Browser automation tool.
+ *
+ * @deprecated This legacy Browser Automation tool is deprecated and is no longer available. Use
+ * {@link BrowserAutomationToolboxTool} instead. See <a href="https://aka.ms/bat/docs">Browser Automation
+ * documentation</a>.
  */
 @Fluent
+@Deprecated
 @Beta(warningText = "Preview API. preview_tool")
 public final class BrowserAutomationPreviewToolboxTool extends ToolboxTool {
 

@@ -124,6 +124,7 @@ public JsonWriter toJson(JsonWriter jsonWriter) throws IOException {
         jsonWriter.writeJsonField("code_configuration", this.codeConfiguration);
         jsonWriter.writeJsonField("telemetry_config", this.telemetryConfig);
         jsonWriter.writeJsonField("session_configuration", this.sessionConfiguration);
+        jsonWriter.writeBooleanField("enable_memory_snapshot", this.enableMemorySnapshot);
         return jsonWriter.writeEndObject();
     }
 
@@ -149,6 +150,7 @@ public static HostedAgentDefinition fromJson(JsonReader jsonReader) throws IOExc
             CodeConfiguration codeConfiguration = null;
             TelemetryConfig telemetryConfig = null;
             SessionConfiguration sessionConfiguration = null;
+            Boolean enableMemorySnapshot = null;
             while (reader.nextToken() != JsonToken.END_OBJECT) {
                 String fieldName = reader.getFieldName();
                 reader.nextToken();
@@ -172,6 +174,8 @@ public static HostedAgentDefinition fromJson(JsonReader jsonReader) throws IOExc
                     telemetryConfig = TelemetryConfig.fromJson(reader);
                 } else if ("session_configuration".equals(fieldName)) {
                     sessionConfiguration = SessionConfiguration.fromJson(reader);
+                } else if ("enable_memory_snapshot".equals(fieldName)) {
+                    enableMemorySnapshot = reader.getNullable(JsonReader::getBoolean);
                 } else {
                     reader.skipChildren();
                 }
@@ -185,6 +189,7 @@ public static HostedAgentDefinition fromJson(JsonReader jsonReader) throws IOExc
             deserializedHostedAgentDefinition.codeConfiguration = codeConfiguration;
             deserializedHostedAgentDefinition.telemetryConfig = telemetryConfig;
             deserializedHostedAgentDefinition.sessionConfiguration = sessionConfiguration;
+            deserializedHostedAgentDefinition.enableMemorySnapshot = enableMemorySnapshot;
             return deserializedHostedAgentDefinition;
         });
     }
@@ -350,4 +355,37 @@ public HostedAgentDefinition setSessionConfiguration(SessionConfiguration sessio
         this.sessionConfiguration = sessionConfiguration;
         return this;
     }
+
+    /*
+     * Whether this agent version uses memory snapshots. Sessions for a snapshot-enabled version start from a snapshot
+     * of the agent's initialized process rather than starting the process from its image. Defaults to false.
+     */
+    @Generated
+    private Boolean enableMemorySnapshot;
+
+    /**
+     * Get the enableMemorySnapshot property: Whether this agent version uses memory snapshots. Sessions for a
+     * snapshot-enabled version start from a snapshot of the agent's initialized process rather than starting the
+     * process from its image. Defaults to false.
+     *
+     * @return the enableMemorySnapshot value.
+     */
+    @Generated
+    public Boolean isEnableMemorySnapshot() {
+        return this.enableMemorySnapshot;
+    }
+
+    /**
+     * Set the enableMemorySnapshot property: Whether this agent version uses memory snapshots. Sessions for a
+     * snapshot-enabled version start from a snapshot of the agent's initialized process rather than starting the
+     * process from its image. Defaults to false.
+     *
+     * @param enableMemorySnapshot the enableMemorySnapshot value to set.
+     * @return the HostedAgentDefinition object itself.
+     */
+    @Generated
+    public HostedAgentDefinition setEnableMemorySnapshot(Boolean enableMemorySnapshot) {
+        this.enableMemorySnapshot = enableMemorySnapshot;
+        return this;
+    }
 }
@@ -68,8 +68,13 @@ public final class ToolType extends ExpandableStringEnum<ToolType> {
 
     /**
      * Static value browser_automation_preview for ToolType.
+     *
+     * @deprecated This legacy Browser Automation tool is deprecated and is no longer available. Use
+     * {@link ToolType#BROWSER_AUTOMATION} instead. See <a href="https://aka.ms/bat/docs">Browser Automation
+     * documentation</a>.
      */
     @Generated
+    @Deprecated
     public static final ToolType BROWSER_AUTOMATION_PREVIEW = fromString("browser_automation_preview");
 
     /**