Merge branch 'main' into tcm

Author: cheng-tan

.devcontainer/Dockerfile

@@ -1,5 +1,5 @@
 # Note: You can use any Debian/Ubuntu based image you want.
-FROM mcr.microsoft.com/devcontainers/universal:2
+FROM mcr.microsoft.com/devcontainers/base:ubuntu
 
 # [Optional] Uncomment this section to install additional OS packages.
 # RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \

.devcontainer/devcontainer.json

@@ -20,7 +20,10 @@
 		},
 		"ghcr.io/elanhasson/devcontainer-features/dotnet-aspire-daily:1": {},
 		"ghcr.io/devcontainers/features/azure-cli:1": {},
-		"ghcr.io/azure/azure-dev/azd:0": {}
+		"ghcr.io/devcontainers/features/git:1": {},
+		"ghcr.io/devcontainers/features/dotnet:2": {},
+		"ghcr.io/azure/azure-dev/azd:0": {},
+		"ghcr.io/devcontainers/features/python:1": {}
 	},
 	// Use 'forwardPorts' to make a list of ports inside the container available locally.
 	// "forwardPorts": [],

.github/ISSUE_TEMPLATE/bug_report.yml .github/ISSUE_TEMPLATE/1-bug_report.yml.github/ISSUE_TEMPLATE/bug_report.yml renamed to .github/ISSUE_TEMPLATE/1-bug_report.yml

@@ -1,14 +1,16 @@
-name: Bug Report
+name: 🐛 Bug Report
 description: Report a bug
 type: "bug"
+labels:
+  - needs-triage
 
 body:
   - type: markdown
     attributes:
       value: |
         ## Please Read the following before submitting an issue.
 
-        ### Have you read the doc?
+        ### Have you read the docs?
         - [Python AgentChat User Guide and Tutorial](https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/index.html)
         - [Python Core API User Guide](https://microsoft.github.io/autogen/stable/user-guide/core-user-guide/index.html)
         - [Python API Doc](https://microsoft.github.io/autogen/stable/reference/index.html)
@@ -88,6 +90,10 @@ body:
       multiple: false
       options:
         - "Python dev (main branch)"
+        - "Python 0.5.2"
+        - "Python 0.5.1"
+        - "Python 0.4.9"
+        - "Python 0.4.8"
         - "Python 0.4.7"
         - "Python 0.4.6"
         - "Python 0.4.5"

.github/ISSUE_TEMPLATE/2-doc_issue.yml

@@ -0,0 +1,47 @@
+name: 📘 Doc Issue
+description: Report an issue in the documentation, including missing or incorrect information.
+type: "bug"
+labels:
+  - needs-triage
+  - documentation
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## Please Read the following before submitting an issue.
+
+        ### Have you read the docs?
+        - [Python AgentChat User Guide and Tutorial](https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/index.html)
+        - [Python Core API User Guide](https://microsoft.github.io/autogen/stable/user-guide/core-user-guide/index.html)
+        - [Python API Doc](https://microsoft.github.io/autogen/stable/reference/index.html)
+        - [.NET Doc](https://microsoft.github.io/autogen/dotnet/)
+
+        ### Have you searched for related issues?
+        - Some other users might have the same issue as yours.
+
+  - type: textarea
+    attributes:
+      label: What is the doc issue?
+      description: Please provide as much information as possible, this helps us address the issue. Use Markdown to format your text.
+      value: |
+        **Describe the issue**
+        A clear and concise description of what the issue is. What is missing or incorrect?
+
+        **What do you want to see in the doc?**
+
+        **Screenshots**
+        If applicable, add screenshots to help explain your problem.
+
+        **Additional context**
+        Add any other context about the problem here.
+    validations:
+      required: true
+  - type: input
+    id: doc-link
+    attributes:
+      label: Link to the doc page, if applicable
+      description: Please provide a link to the doc page that has the issue.
+      placeholder: https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/index.html
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/3-maintainer_only.yml

@@ -0,0 +1,20 @@
+name: 🔒 Maintainer Only
+description: Only use this template if you are a maintainer.
+
+body:
+  - type: checkboxes
+    attributes:
+      label: Confirmation
+      description: Please only use this template if you are a maintainer. Thanks for helping us keep the issue tracker organized!
+      options:
+        - label: I confirm that I am a maintainer and so can use this template. If I am not, I understand this issue will be closed and I will be asked to use a different template.
+          required: true
+
+  - type: textarea
+    id: body
+    attributes:
+      label: Issue body
+      description: "How do you trigger this bug? Please walk us through it step by step."
+    validations:
+      required: true
+

.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +1,8 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
 contact_links:
-  - name: Questions or general help 💬
+  - name: 💬 Questions or general help
     url: https://github.com/microsoft/autogen/discussions
     about: Please ask and answer questions here.
+  - name: 💡 Suggest a new feature
+    url: https://github.com/microsoft/autogen/discussions/categories/feature-suggestions
+    about: Please suggest new features here and once the feature is accepted a maintainer will create an issue.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -181,6 +181,44 @@ jobs:
           name: coverage-autogen-ext-grpc
           path: ./python/coverage_autogen-ext-grpc.xml
 
+  test-autogen-ext-pwsh:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          version: "0.5.18"
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install Python deps
+        run: |
+          uv sync --locked --all-extras
+        shell: pwsh
+        working-directory: ./python
+
+      - name: Run tests for Windows
+        run: |
+          .venv/Scripts/activate.ps1
+          poe --directory ./packages/autogen-ext test-windows
+        shell: pwsh
+        working-directory: ./python
+
+      - name: Move coverage file
+        run: |
+          mv ./packages/autogen-ext/coverage.xml coverage_autogen_ext_windows.xml
+        working-directory: ./python
+
+      - name: Upload coverage artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-autogen-ext-windows
+          path: ./python/coverage_autogen_ext_windows.xml
+
   codecov:
     runs-on: ubuntu-latest
     needs: [test, test-grpc]

.github/workflows/checks.yml

@@ -33,7 +33,7 @@ jobs:
           [
             # For main use the workflow target
             { ref: "${{github.ref}}", dest-dir: dev, uv-version: "0.5.13", sphinx-release-override: "dev" },
-            { ref: "python-v0.4.7", dest-dir: stable, uv-version: "0.5.13", sphinx-release-override: "stable" },
+            { ref: "python-v0.5.2", dest-dir: stable, uv-version: "0.5.13", sphinx-release-override: "stable" },
             { ref: "v0.4.0.post1", dest-dir: "0.4.0", uv-version: "0.5.13", sphinx-release-override: "" },
             { ref: "v0.4.1", dest-dir: "0.4.1", uv-version: "0.5.13", sphinx-release-override: "" },
             { ref: "v0.4.2", dest-dir: "0.4.2", uv-version: "0.5.13", sphinx-release-override: "" },
@@ -42,6 +42,10 @@ jobs:
             { ref: "python-v0.4.5", dest-dir: "0.4.5", uv-version: "0.5.13", sphinx-release-override: "" },
             { ref: "python-v0.4.6", dest-dir: "0.4.6", uv-version: "0.5.13", sphinx-release-override: "" },
             { ref: "python-v0.4.7", dest-dir: "0.4.7", uv-version: "0.5.13", sphinx-release-override: "" },
+            { ref: "python-v0.4.8", dest-dir: "0.4.8", uv-version: "0.5.13", sphinx-release-override: "" },
+            { ref: "python-v0.4.9-website", dest-dir: "0.4.9", uv-version: "0.5.13", sphinx-release-override: "" },
+            { ref: "python-v0.5.1", dest-dir: "0.5.1", uv-version: "0.5.13", sphinx-release-override: "" },
+            { ref: "python-v0.5.2", dest-dir: "0.5.2", uv-version: "0.5.13", sphinx-release-override: "" },
           ]
     steps:
       - name: Checkout