Merge branch 'main' into fixing_issue_43955

Author: Nikhil172913832

.github/CODEOWNERS

@@ -33,7 +33,7 @@
 # ServiceLabel: %AI
 
 # PRLabel: %AI
-/sdk/ai/                                                             @luigiw @needuv @paulshealy1 @singankit @dargilco @jhakulin
+/sdk/ai/                                                             @luigiw @needuv @paulshealy1 @singankit @dargilco @trrwilson
 
 # ServiceOwners: @luigiw @needuv @singankit
 # ServiceLabel: %Evaluation
@@ -80,6 +80,12 @@
 # PRLabel: %CognitiveServices
 /sdk/cognitiveservices/                                              @lmazuel
 
+# ServiceOwners: @amber-yujueWang @rhurey @xitzhang
+# ServiceLabel: %Speech Transcription
+
+# PRLabel: %Speech Transcription
+/sdk/cognitiveservices/azure-ai-transcription/                       @amber-yujueWang @rhurey @xitzhang
+
 # ServiceLabel: %Communication
 # PRLabel: %Communication
 /sdk/communication/                                                  @acsdevx-msft
@@ -243,15 +249,15 @@
 
 # PRLabel: %AI Model Inference
 # ServiceLabel: %AI Model Inference %Service Attention
-/sdk/ai/azure-ai-inference/                                          @dargilco @trangevi @jhakulin
+/sdk/ai/azure-ai-inference/                                          @dargilco @trangevi @trrwilson
 
 # PRLabel: %AI Agents
 # ServiceLabel: %AI Agents %Service Attention
-/sdk/ai/azure-ai-agents/                                             @dargilco @jhakulin @trangevi @glharper @nick863 @howieleung
+/sdk/ai/azure-ai-agents/                                             @dargilco @trrwilson @trangevi @glharper @nick863 @howieleung
 
 # PRLabel: %AI Projects
 # ServiceLabel: %AI Projects %Service Attention
-/sdk/ai/azure-ai-projects/                                           @dargilco @jhakulin @trangevi @glharper @nick863 @howieleung
+/sdk/ai/azure-ai-projects/                                           @dargilco @trrwilson @trangevi @glharper @nick863 @howieleung @kingernupur
 
 # PRLabel: %Voice Live
 # ServiceLabel: %Voice Live %Service Attention
@@ -320,6 +326,10 @@
 # PRLabel: %Operator Nexus - Network Cloud
 /sdk/networkcloud/                                                   @Azure/azure-sdk-write-networkcloud
 
+# ServiceLabel: %Planetary Computer
+# PRLabel: %Planetary Computer
+/sdk/planetarycomputer/                                              @mandarinamdar @chahibi
+
 # AzureSdkOwners: @annatisch
 # ServiceLabel: %Azure Projects
 # ServiceOwners: @annatisch
@@ -410,7 +420,7 @@
 /sdk/translation/azure-ai-translation-text/                          @MikeyMCZ
 
 # PRLabel: %Cognitive - Language
-/sdk/cognitivelanguage/                                              @quentinRobinson @wangyuantao
+/sdk/cognitivelanguage/                                              @quentinRobinson @bidisha-c @mikaelsitruk @sarkar-rajarshi @ahmedaashour
 
 # PRLabel: %Cognitive - Personalizer
 /sdk/personalizer/                                                   @sharathmalladi
@@ -836,6 +846,7 @@
 /eng/common/                                                         @Azure/azure-sdk-eng
 /.github/workflows/                                                  @Azure/azure-sdk-eng
 /.github/CODEOWNERS                                                  @lmazuel @xiangyan99 @kashifkhan @Azure/azure-sdk-eng
+/.github/copilot-instructions.md                                     @l0lawrence @praveenkuttappan @maririos
 /sdk/pullrequest.yml                                                 @scbedd @weshaggard @benbp
 
 /.config/1espt/                                                      @benbp @weshaggard
@@ -859,4 +870,4 @@
 /eng/emitter-package-lock.json                                       @mccoyp @catalinaperalta @iscai-msft
 
 /pylintrc                                                            @l0lawrence @scbedd @mccoyp
-/sdk/**/ci.yml                                                       @msyyc @lmazuel
+/sdk/**/ci.yml                                                       @msyyc @lmazuel @scbedd

.github/copilot-instructions.md

@@ -14,6 +14,7 @@
 
 ### RULE 3: VERIFY ENVIRONMENT FIRST
 **REQUIRED CONDITIONS:**
+- Always run the [`azsdk_verify_setup`](../eng/common/instructions/azsdk-tools/verify-setup.instructions.md) tool to check the user's development environment setup for using SDK MCP tools. DO NOT PROCEED with running other tools before completing this step. Only skip for queries that don't need tools.
 - To use Azure MCP tool calls, users must have PowerShell installed. Provide [PowerShell installation instructions](https://learn.microsoft.com/powershell/scripting/install/installing-powershell) if not installed, and recommend restarting the IDE to start the MCP server.
 
 ---
@@ -110,4 +111,4 @@ This library is failing two release blocking checks - Mypy and Tests - CI. The l
 
 ## SDK release
 
-For detailed workflow instructions, see [SDK Release](../eng/common/instructions/copilot/sdk-release.instructions.md).
+For detailed workflow instructions, see [SDK Release](https://github.com/Azure/azure-sdk-for-python/blob/main/eng/common/instructions/copilot/sdk-release.instructions.md).

.vscode/cspell.json

@@ -155,6 +155,7 @@
     "sdk/ai/azure-ai-voicelive/samples/**"
   ],
   "words": [
+    "qnas",
     "msedge",
     "spinup",
     "cibuildwheel",
@@ -356,6 +357,7 @@
     "nbsp",
     "noarch",
     "NOPERM",
+    "norecursedirs",
     "northcentralus",
     "nspkg",
     "OAEP",
@@ -529,7 +531,7 @@
     "logprobs",
     "pyaudio",
     "PyAudio",
-	"libasound",
+    "libasound",
     "ingraph"
   ],
   "overrides": [
@@ -907,12 +909,12 @@
     },
     {
       "filename": "sdk/cognitivelanguage/azure-ai-language-conversations-authoring/**",
-      "words": [ "unassigning" ],
+      "words": [ "unassigning", "unassignment" ],
       "caseSensitive": false
     },
     {
       "filename": "sdk/cognitivelanguage/azure-ai-language-questionanswering/**",
-      "words": [ "qnas", "qnamaker", "ADTO" ],
+      "words": [ "qnas", "qnamaker", "ADTO", "tfidf", "ngram" ],
       "caseSensitive": false
     },
     {

argfile.json

@@ -17,6 +17,7 @@ When migrating to the hybrid model design, expect these breaking changes:
 | [Additional Properties](#additional-properties-handling)                            | `additional_properties` parameter removed                 | Use direct dictionary syntax: `model["key"] = value`                              |
 | [String Representation](#string-representation-matches-rest-api)                    | Model key output changed from `snake_case` to `camelCase` | Update any code parsing model strings to expect `camelCase`                       |
 | [Serialization/Deserialization](#serialization-and-deserialization-methods-removed) | `serialize` and `deserialize` methods removed     | Use dictionary access for serialization, constructor for deserialization          |
+| [Reserved Property Names](#reserved-property-name-conflicts)                      | Conflicting names suffixed with `_property`       | Update code to use `_property` suffix: `model.keys` → `model.keys_property`      |
 
 ## Detailed Breaking Changes
 
@@ -273,6 +274,50 @@ serialized_dict = as_attribute_dict(model, exclude_readonly=False)
 serialized_dict = as_attribute_dict(model, exclude_readonly=True)
 ```
 
+### Reserved Property Name Conflicts
+
+**What changed**: Hybrid models now inherit from Python's built-in `dict`. If a REST API property name collides with a `dict` method name (e.g. `keys`, `values`, `items`, `clear`, `update`, `get`, `pop`, `popitem`, `setdefault`, `copy`), the Python emitter appends `_property` to the generated attribute to avoid masking the dictionary method.
+
+**What will break**:
+
+- Constructor calls that pass reserved names as keyword arguments: `Model(keys=...)` will now pass the argument to the underlying `dict` constructor, which means the property value will not be set as expected and may result in a `TypeError` or unexpected behavior.
+- Attribute access expecting the property value: `model.keys` now refers to the method; calling it without parentheses will not return the property data.
+
+**Before**:
+
+```python
+from azure.mgmt.test.models import Model
+
+model = Model(keys={"a": 1}, values=[1, 2, 3])
+print(model.keys)      # Property value (old behavior)
+print(model.values)    # Property value (old behavior)
+print(model.as_dict()["keys"]) # REST layer value
+```
+
+**After**:
+
+```python
+from azure.mgmt.test.models import Model
+
+# Reserved property names receive a `_property` suffix
+model = Model(keys_property={"a": 1}, values_property=[1, 2, 3])
+
+print(model.keys_property)    # ✅ Property value
+print(model.values_property)  # ✅ Property value
+print(model["keys"])          # REST layer value
+
+# names without suffix are now dict methods
+print(list(model.keys()))     # ✅ Dict method listing all keys in the model
+print(list(model.values()))   # ✅ Dict method listing all values
+```
+
+**Migration steps:**
+
+1. Search for any usage of reserved names as constructor keywords or attribute accesses.
+2. Append `_property` to both initialization and attribute access: `Model(keys=...)` → `Model(keys_property=...)`; `model.keys` → `model.keys_property`.
+3. Update tests and documentation references accordingly.
+4. If you had dynamic code relying on `getattr(model, name)`, ensure you add a rule to transform reserved names to `name + "_property"` first.
+
 ---
 
 ## Additional Helper Methods

doc/dev/mgmt/hybrid_model_migration.md

@@ -205,16 +205,31 @@ op IotDpsResourceGetCustomized(
 );
 ```
 
-## 6. Removal of Unreferenced Models
+## 6. Common Types Upgrade
+
+**Changelog Pattern**:
+
+Multiple changes related to common infrastructure types such as `SystemData` and `IdentityType`:
+
+```md
+- Deleted or renamed model `IdentityType`
+```
+
+**Reason**: Common types are upgraded to their latest versions during TypeSpec migration.
+
+**Impact**: Low impact since these are common infrastructure types rarely used directly by users.
+
+**Resolution**: Accept these breaking changes.
+
+## 7. Removal of Unreferenced Models
 
 **Changelog Pattern**:
 
 Multiple removals of unreferenced models that are typically not used in the SDK:
 
 ```md
-- Deleted or renamed model `ReplicationUsageList`
-- Deleted or renamed model `VaultList`
-- Deleted or renamed model `VaultUsageList`
+- Deleted or renamed model `ProxyResourceWithoutSystemData`
+- Deleted or renamed model `Resource`
 ```
 
 **Reason**: Unreferenced models are removed during TypeSpec migration.
@@ -223,7 +238,27 @@ Multiple removals of unreferenced models that are typically not used in the SDK:
 
 **Resolution**: Accept these breaking changes.
 
-## 7. Parameters Changed to Keyword-only
+## 8. Removal of Pageable Models
+
+**Changelog Pattern**:
+
+Multiple removals of models following the pattern `xxxList`:
+
+```md
+- Deleted or renamed model `ElasticSanList`
+- Deleted or renamed model `SkuInformationList`
+- Deleted or renamed model `SnapshotList`
+- Deleted or renamed model `VolumeGroupList`
+- Deleted or renamed model `VolumeList`
+```
+
+**Reason**: Python will not expose pageable models for list APIs.
+
+**Impact**: Low impact since these models are typically not used directly by users.
+
+**Resolution**: Accept these breaking changes.
+
+## 9. Parameters Changed to Keyword-only
 
 **Changelog Pattern**:
 
@@ -239,7 +274,7 @@ Entries showing the usage of passing parameters positionally is disabled:
 
 **Resolution**: Accept these breaking changes.
 
-## 8. Removal of Parameter `if_match`
+## 10. Removal of Parameter `if_match`
 
 **Changelog Pattern**:
 
@@ -257,7 +292,7 @@ Removal of parameter `if_match` and addition of `etag/match_condition` for the s
 
 **Resolution**: Accept these breaking changes.
 
-## 9. Removal of multi-level flattened properties
+## 11. Removal of multi-level flattened properties
 
 **Changelog Pattern**:
 

doc/dev/mgmt/sdk-breaking-changes-guide.md

@@ -275,6 +275,9 @@ To run recorded tests successfully when recorded values are inconsistent or rand
 proxy provides a `variables` API. This makes it possible for a test to record the values of variables that were used
 during recording and use the same values in playback mode without a sanitizer.
 
+Note that the recorded variables **must** have string values. For example, trying to record an integer value for a
+variable will cause a test proxy error.
+
 For example, imagine that a test uses a randomized `table_uuid` variable when creating resources. The same random value
 for `table_uuid` can be used in playback mode by using this `variables` API.
 
@@ -293,14 +296,14 @@ class TestExample(AzureRecordedTestCase):
     @recorded_by_proxy
     def test_example(self, **kwargs):
         # In live mode, variables is an empty dictionary
-        # In playback mode, the value of variables is {"table_uuid": "random-value"}
+        # In playback mode, the value of variables is {"current_time": "<previously recorded time>"}
         variables = kwargs.pop("variables", {})
 
-        # To fetch variable values, use the `setdefault` method to look for a key ("table_uuid")
-        # and set a real value for that key if it's not present ("random-value")
-        table_uuid = variables.setdefault("table_uuid", "random-value")
+        # To fetch variable values, use the `setdefault` method to look for a key ("current_time")
+        # and set a real value for that key if it's not present (str(time.time()))
+        # Note that time.time() is converted from a float to a string to record it properly
+        current_time = variables.setdefault("current_time", str(time.time()))
 
-        # use variables["table_uuid"] when using the table UUID throughout the test
         ...
 
         # return the variables at the end of the test to record them

doc/dev/test_proxy_troubleshooting.md

@@ -27,6 +27,8 @@ This repo is currently migrating all checks from a slower `tox`-based framework,
 |`verifysdist`| Verify directories included in sdist and contents in manifest file. Also ensures that py.typed configuration is correct within the setup.py. | `azpysdk verifysdist .` |
 |`verify_keywords`| Verify that the keyword 'azure sdk' is present in the targeted package's keywords. | `azpysdk verify_keywords .` |
 |`import_all`| Installs the package w/ default dependencies, then attempts to `import *` from the base namespace. Ensures that all imports will resolve after a base install and import. | `azpysdk import_all .` |
+|`generate`| Regenerates the code. | `azpysdk generate .` |
+|`breaking`| Checks for breaking changes. | `azpysdk breaking .` |
 
 ## Common arguments
 

doc/tool_usage_guide.md

@@ -22,7 +22,7 @@ omitted_paths:
 language: python
 root_check_enabled: True
 required_readme_sections:
-  - ^Azure (.+ client library for Python|Smoke Test for Python)
+  - ^Azure (.+ client library for Python|Smoke Test for Python|AI Agent Server Adapter for .*Python)
   - ^Getting started$
   - ^Key concepts$
   - ^Examples$

eng/.docsettings.yml

@@ -11,7 +11,7 @@ pkginfo==1.12.1.2
 pip==24.0
 typing-extensions==4.12.2
 pyproject-api==1.8.0
-cibuildwheel==2.16.5
+cibuildwheel==2.23.3
 importlib-metadata==8.5.0
 build==1.2.2.post1