Merge branch 'main' into selshafey/improve_tool_call_accuracy

Author: Salma Elshafey

.devcontainer/devcontainer.json

@@ -1,41 +1,62 @@
 {
-	"name": "GitHub Codespaces (Default)",
-	"settings": {
-		"terminal.integrated.profiles.linux": {
-			"bash": {
-				"path": "/bin/bash",
-				"args": []
-			}
-		},
-		"terminal.integrated.defaultProfile.linux": "bash",
-		"go.useGoProxyToCheckForToolUpdates": false,
-		"go.useLanguageServer": true,
-		"go.gopath": "/go",
-		"go.goroot": "/usr/local/go",
-		"go.toolsGopath": "/go/bin",
-		"python.defaultInterpreterPath": "/opt/python/latest/bin/python",
-		"lldb.executable": "/usr/bin/lldb",
-		"files.watcherExclude": {
-			"**/target/**": true
-		} 
-	},
-	"remoteUser": "codespace",
-	"overrideCommand": false,
-	"workspaceMount": "source=${localWorkspaceFolder},target=/home/codespace/workspace,type=bind,consistency=cached",
-	"workspaceFolder": "/home/codespace/workspace",
-	"mounts": [ "source=/var/run/docker.sock,target=/var/run/docker-host.sock,type=bind" ],
-	"runArgs": [ "--cap-add=SYS_PTRACE", "--security-opt", "seccomp=unconfined", "--privileged" ],
-	
-	// Add the IDs of extensions you want installed when the container is created.
-	"extensions": [
-		"GitHub.vscode-pull-request-github",
-		"MS-vsliveshare.vsliveshare",
-		"VisualStudioExptTeam.vscodeintellicode"
-	]
-
-	// Use 'forwardPorts' to make a list of ports inside the container available locally.
-	// "forwardPorts": [],
-
-	// Use 'postCreateCommand' to run commands after the container is created.
-	// "postCreateCommand": "uname -a"
-}
+  "name": "GitHub Codespaces (Default)",
+  "remoteUser": "codespace",
+  "overrideCommand": false,
+  "workspaceMount": "source=${localWorkspaceFolder},target=/home/codespace/workspace,type=bind,consistency=cached",
+  "workspaceFolder": "/home/codespace/workspace",
+  "mounts": [
+    "source=/var/run/docker.sock,target=/var/run/docker-host.sock,type=bind"
+  ],
+  "runArgs": [
+    "--cap-add=SYS_PTRACE",
+    "--security-opt",
+    "seccomp=unconfined",
+    "--privileged"
+  ],
+  "postCreateCommand": "bash .devcontainer/init.sh",
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  // "forwardPorts": [],
+  "customizations": {
+    "codespaces": {
+      "repositories": {
+        "Azure/azure-sdk-assets": {
+          "permissions": {
+            "contents": "write"
+          }
+        }
+      }
+    },
+    "vscode": {
+      "settings": {
+        "terminal.integrated.shell.linux": "/bin/bash",
+        "go.useGoProxyToCheckForToolUpdates": false,
+        "go.useLanguageServer": true,
+        "go.gopath": "/go",
+        "go.goroot": "/usr/local/go",
+        "go.toolsGopath": "/go/bin",
+        "python.pythonPath": "/opt/python/latest/bin/python",
+        "python.linting.enabled": true,
+        "python.linting.pylintEnabled": true,
+        "python.formatting.autopep8Path": "/usr/local/py-utils/bin/autopep8",
+        "python.formatting.blackPath": "/usr/local/py-utils/bin/black",
+        "python.formatting.yapfPath": "/usr/local/py-utils/bin/yapf",
+        "python.linting.banditPath": "/usr/local/py-utils/bin/bandit",
+        "python.linting.flake8Path": "/usr/local/py-utils/bin/flake8",
+        "python.linting.mypyPath": "/usr/local/py-utils/bin/mypy",
+        "python.linting.pycodestylePath": "/usr/local/py-utils/bin/pycodestyle",
+        "python.linting.pydocstylePath": "/usr/local/py-utils/bin/pydocstyle",
+        "python.linting.pylintPath": "/usr/local/py-utils/bin/pylint",
+        "lldb.executable": "/usr/bin/lldb",
+        "files.watcherExclude": {
+          "**/target/**": true
+        }
+      },
+      // Add the IDs of extensions you want installed when the container is created.
+      "extensions": [
+        "GitHub.vscode-pull-request-github",
+        "MS-vsliveshare.vsliveshare",
+        "VisualStudioExptTeam.vscodeintellicode"
+      ]
+    }
+  }
+}

.devcontainer/init.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+
+# Install and use nvm version from .nvmrc
+source $NVM_DIR/nvm.sh
+nvm install
+nvm use
+# Set default node to version we just installed so that new shells start with it
+nvm alias default $(node --version)
+
+# Install utilities
+npm install -g autorest @typespec/compiler @azure-tools/typespec-client-generator-cli
+
+# Install PowerShell. PowerShell is needed for the test proxy asset sync migration scripts,
+# and is also useful for running scripts in eng/common/scripts and eng/common/TestResources.
+# Update the list of packages
+sudo apt-get update
+# Install pre-requisite packages.
+sudo apt-get install -y wget apt-transport-https software-properties-common
+# Download the Microsoft repository GPG keys
+wget -q "https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb"
+# Register the Microsoft repository GPG keys
+sudo dpkg -i packages-microsoft-prod.deb
+# Delete the the Microsoft repository GPG keys file
+rm packages-microsoft-prod.deb
+# Update the list of packages after we added packages.microsoft.com
+sudo apt-get update
+# Install PowerShell
+sudo apt-get install -y powershell
+
+# Install Python tooling
+# init env
+python -m pip install -U pip > /dev/null
+python scripts/dev_setup.py -p azure-core > /dev/null
+pip install tox==4.15.0 > /dev/null
+pip install wheel==0.43.0 > /dev/null
+pip install setuptools==78.1.0 > /dev/null
+pip install setuptools-scm==8.3.0 > /dev/null

.github/CODEOWNERS

@@ -93,7 +93,7 @@
 
 # ServiceLabel: %Communication - Call Automation
 # PRLabel: %Communication - Call Automation
-/sdk/communication/azure-communication-callautomation/               @minwoolee-msft
+/sdk/communication/azure-communication-callautomation/               @minwoolee-msft @fhaghbin-msft @juntuchen-msft @v-dharmarajv
 
 # ServiceLabel: %Communication - Chat
 # PRLabel: %Communication - Chat
@@ -236,10 +236,10 @@
 # ServiceLabel: %Durable Task Scheduler %Service Attention
 /sdk/durabletask/                                                    @berndverst @kaibocai @torosent @RyanLettieri @philliphoff @cgillum
 
-# AzureSdkOwners: @kashifkhan
+# AzureSdkOwners: @shankarsama @rajeshka
 # ServiceLabel: %Event Grid
 # PRLabel: %Event Grid
-/sdk/eventgrid/                                                      @kashifkhan @l0lawrence
+/sdk/eventgrid/                                                      @shankarsama @rajeshka
 
 # PRLabel: %Image Analysis
 # ServiceLabel: %Image Analysis %Service Attention
@@ -255,7 +255,7 @@
 
 # PRLabel: %AI Projects
 # ServiceLabel: %AI Projects %Service Attention
-/sdk/ai/azure-ai-projects/                                           @dargilco @jhakulin
+/sdk/ai/azure-ai-projects/                                           @dargilco @jhakulin @trangevi @glharper @nick863 @howieleung
 
 
 # PRLabel: %HDInsight

.github/copilot-instructions.md

@@ -73,9 +73,9 @@ curl -s "https://api.github.com/repos/Azure/azure-rest-api-specs/commits?path=<p
 ## EXECUTION SEQUENCE - 7 MANDATORY STEPS
 
 **ESTIMATED TOTAL TIME: 10-15 minutes**
-- SDK Generation: 5-6 minutes
-- Static Validation: 3-5 minutes  
-- Documentation & Commit: 2-4 minutes
+- SDK Generation: ~2 minutes
+- Static Validation: ~3-5 minutes
+- Documentation & Commit: ~2-4 minutes
 
 **ALWAYS inform users of time expectations before starting any long-running operations.**
 
@@ -89,18 +89,14 @@ IF missing dependencies:
 
 ### STEP 2: SDK GENERATION
 ```
-ACTION: Use azure-sdk-python-mcp sdk generation server tools (init, init_local)
-TIMING: ALWAYS inform user before starting: "This SDK generation step will take approximately 5-6 minutes to complete."
-IF local path provided:
-    USE local mcp tools with tspconfig.yaml path
+ACTION: Use azure-sdk-python-mcp sdk generation server tools (init for new packages, update for existing packages)
 IF commands fail:
     ANALYZE error messages
     DIRECT user to fix TypeSpec errors in source repo
 ```
 
 ### STEP 3: STATIC VALIDATION (SEQUENTIAL)
 ```
-TIMING: Inform user: "Static validation will take approximately 3-5 minutes for each step."
 FOR EACH validation step:
     RUN validation (tox mcp tool)
     IF errors/warnings found:
@@ -280,3 +276,25 @@ Mypy: FAIL
 Tests - CI: FAIL
 
 This library is failing two release blocking checks - Mypy and Tests - CI. The library needs attention primarily due to Pylint warnings, disabled sample tests, and open customer-reported issues.
+
+---
+
+## SDK release
+
+There are two tools to help with SDK releases:
+- Check SDK release readiness
+- Release SDK
+
+### Check SDK Release Readiness
+Run `CheckPackageReleaseReadiness` to verify if the package is ready for release. This tool checks:
+- API review status
+- Change log status
+- Package name approval(If package is new and releasing a preview version)
+- Release date is set in release tracker
+
+### Release SDK
+Run `ReleasePackage` to release the package. This tool requires package name and language as inputs. It will:
+- Check if the package is ready for release
+- Identify the release pipeline
+- Trigger the release pipeline.
+User needs to approve the release stage in the pipeline after it is triggered.

.github/prompts/check-package-readiness.prompt.md

@@ -0,0 +1,36 @@
+---
+mode: 'agent'
+tools: ['CheckPackageReleaseReadiness']
+description: 'This prompt is designed to check the release readiness of a SDK package.'
+---
+## Goal
+Check the release readiness of an SDK package by collecting the required information from the user and executing the readiness check.
+
+## Instructions
+1. **Collect Required Information**:
+    - Prompt the user for the exact package name
+    - Prompt the user to select the programming language from the following options (case sensitive):
+      - Python
+      - Java
+      - JavaScript
+      - .NET
+      - Go
+
+2. **Execute Readiness Check**:
+    - Use the `CheckPackageReleaseReadiness` tool with the provided package name and selected language
+    - Do not check for existing pull requests to run this step.
+    - Do not ask the user to create a release plan to run this step.
+
+3. **Present Results**:
+    - If the package is ready for release, highlight and provide the link to the release pipeline
+    - If the package is not ready, display the specific issues that need to be resolved
+
+4. **Follow-up Actions**:
+    - Provide clear next steps based on the readiness status
+    - If issues are found, offer guidance on how to resolve them
+
+## Expected User Interaction Flow
+1. Ask: "What is the exact name of the package you want to check for release readiness?"
+2. Ask: "Please select the programming language for this package: Python, Java, JavaScript, .NET, or Go"
+3. Execute the readiness check using the provided information
+4. Display results and next steps

.github/workflows/dependency-checker.yml

@@ -5,19 +5,33 @@ on:
     - cron: "0 0,12 * * *"  # Runs at 00:00 and 12:00 UTC
   workflow_dispatch:         # Optional manual trigger
 
+permissions:
+  issues: write  # to create the Issues using API
+
 jobs:
-  build-and-test:
+  check-dependencies:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - name: Checkout repository
+        uses: actions/checkout@v3
 
-      - name: Set up Python 3.11
+      - name: Set up Python
         uses: actions/setup-python@v4
         with:
           python-version: 3.11
 
       - name: Install Dependencies
         run: pip install packaging==25.0 requests==2.32.4
 
-      - name: Run Script
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install packaging==25.0 requests==2.32.4
+
+      - name: Run major dependency update check
         run: python sdk/ml/azure-ai-ml/scripts/major_updates.py
+
+      - name: Create GitHub issues for major updates
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: python sdk/ml/azure-ai-ml/scripts/create_issue.py

.vscode/cspell.json

@@ -11,6 +11,7 @@
     "en-gb"
   ],
   "ignorePaths": [
+    ".devcontainer/**",
     "eng/**",
     ".github/CODEOWNERS",
     "scripts/**",

.vscode/mcp.json

@@ -10,6 +10,11 @@
                 "azure-sdk-python-mcp",
                 "azure-sdk-python-mcp"
             ],
+        },
+        "azure-sdk-mcp": {
+            "type": "stdio",
+            "command": "pwsh",        
+            "args": ["${workspaceFolder}/eng/common/mcp/azure-sdk-mcp.ps1", "-Run", "-Version","1.0.0-dev.20250630.3"]
         }
     }
 }

doc/dev/ai/typespec_generation.md

@@ -24,7 +24,7 @@ Copilot will automatically:
 
 1. **Verify environment** - Check dependencies and virtual environment
 2. **Generate SDK** - Run TypeSpec generation (~5-6 minutes)
-3. **Validate code** - Run Pylint, MyPy, Pyright, Verifytypes (~3-5 minutes each)
+3. **Validate code** - Run Pylint, MyPy, Pyright, Verifytypes, Sphinx, Mindependency, Bandit, Black, Samples, Breaking changes (~3-5 minutes each)
 4. **Update docs** - Create/update CHANGELOG.md and version files
 5. **Commit changes** - Add, commit, and push to your branch
 6. **Create PR** - Generate pull request in draft mode

doc/dev/mgmt/cheatsheet.md

@@ -36,12 +36,6 @@ python ./scripts/dev_setup.py -p $PACKAGE
 python -m packaging_tools.generate_sdk -v -m restapi_path/readme.md
 ```
 
-Regenerate multi-api client:<br/>
-`python ./scripts/multiapi_init_gen.py azure-mgmt-myservice`
-
-Regenerate multi-api of multi-client package:<br/>
-`python ./scripts/multiapi_init_gen.py azure-mgmt-myservice#subclientname`
-
 ## Update packaging setup.py / MANIFEST / etc.
 
 Locally:<br/>
@@ -50,7 +44,7 @@ Locally:<br/>
 Update a given PR (needs GH_TOKEN env variable set):<br/>
 `python -m packaging_tools.update_pr -v -p 3979`
 
-Edit `sdk_packaging.toml` if necesseray and restart the tool.
+Edit `sdk_packaging.toml` if necessary and restart the tool.
 
 Available options:
 
@@ -61,7 +55,7 @@ Available options:
 | package_nspkg | str | namespace package name | azure-mgmt-nspkg |
 | package_pprint_name | str | The nice name to show on PyPI | MyService Management |
 | package_doc_id | str | the moniker on docs.microsoft.com (could be empty) | my-service |
-| is_stable | bool | Should have discriminer as stable | false |
+| is_stable | bool | Should have discriminator as stable | false |
 | is_arm | bool | needs a dependency on msrestazure | true |
 
 ## ChangeLog