Merge branch 'main' into feature/4904-exception-handling

.azure/pipelines/build.yaml

@@ -1,11 +1,3 @@
-trigger:
-  branches:
-    include:
-    - main
-  paths:
-    include:
-    - dotnet
-
 schedules:
 - cron: "0 0 * * *"
   displayName: 'Daily midnight build (including CodeQL)'

.azure/pipelines/templates/build.yaml

@@ -79,6 +79,7 @@ jobs:
           allowPackageConflicts: true
   steps:
   - checkout: self
+    lfs: true
   - task: UseDotNet@2
     displayName: 'Use .NET Core sdk'
     inputs:
@@ -111,7 +112,7 @@ jobs:
     displayName: Build
     inputs:
       command: build
-      arguments: '$(build_flags) /bl:${{parameters.build_configuration}}-Build.binlog /p:Configuration=${{parameters.build_configuration}} $(solution)'
+      arguments: '$(build_flags) /bl:${{parameters.build_configuration}}-Build.binlog /p:Configuration=${{parameters.build_configuration}} /p:ContinuousIntegrationBuild=true $(solution)'
       workingDirectory: $(Build.SourcesDirectory)/dotnet
     env:
       PATH: "C:\\Users\\cloudtest\\.local\\bin;$(PATH)"
@@ -201,7 +202,7 @@ jobs:
   - task: CmdLine@2
     displayName: Pack
     inputs:
-      script: 'dotnet pack --no-build --no-restore $(build_flags) /bl:${{parameters.build_configuration}}-Pack.binlog /p:Configuration=${{parameters.build_configuration}} $(solution)'
+      script: 'dotnet pack --no-build --no-restore $(build_flags) /bl:${{parameters.build_configuration}}-Pack.binlog /p:Configuration=${{parameters.build_configuration}} /p:ContinuousIntegrationBuild=true $(solution)'
       workingDirectory: $(Build.SourcesDirectory)/dotnet
     env:
       ${{ if and(eq(parameters.include_suffix, true), eq(parameters.publish_nuget, false)) }}:

.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": [],

.gitattributes

@@ -85,10 +85,7 @@ makefile          text eol=lf
 *.png filter=lfs diff=lfs merge=lfs -text
 *.jpg filter=lfs diff=lfs merge=lfs -text
 *.jpeg filter=lfs diff=lfs merge=lfs -text
-python/packages/autogen-magentic-one/imgs/autogen-magentic-one-example.png filter=lfs diff=lfs merge=lfs -text
-python/packages/autogen-magentic-one/imgs/autogen-magentic-one-agents.png filter=lfs diff=lfs merge=lfs -text
 
-python/packages/autogen-magentic-one/tests/browser_utils/test_files/test_blog.html linguist-vendored
 python/packages/autogen-ext/src/autogen_ext/runtimes/grpc/protos/*.py linguist-generated
 python/packages/autogen-ext/src/autogen_ext/runtimes/grpc/protos/*.pyi linguist-generated
 python/packages/autogen-ext/tests/protos/*.py linguist-generated

.github/ISSUE_TEMPLATE/1-bug_report.yml

@@ -0,0 +1,167 @@
+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 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.
+
+        ### Are you familiar with GitHub Markdown Syntax?
+        Please use [GitHub Markdown](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)
+        syntax to format your input.
+        Pay attention to code blocks. Use "```" blocks for code and output.
+        For examples:
+
+        ````
+        ```python
+        # your Python code here.
+        ```
+        ````
+
+        ````
+        ```bash
+        # your bash shell command here.
+        ```
+        ````
+
+        If your output contains "```", use "````" (four "`") to escape them.
+
+        You can use the "Preview" switcher to check your formatted output.
+  - type: textarea
+    attributes:
+      label: What happened?
+      description: Please provide as much information as possible, this helps us address the issue. Use Markdown to format your text.
+      value: |
+        **Describe the bug**
+        A clear and concise description of what the bug is.
+        If it is a question or suggestion, please use [Discussions](https://github.com/microsoft/autogen/discussions)
+        instead.
+
+        **To Reproduce**
+        Steps to reproduce the behavior. Please include code and outputs such as stacktrace.
+
+        - If your input is just "I tried X, and it didn't work" or
+        "X is not working", your issue will be ignored.
+        - If your input is not well formatted, it will hurt readability and
+        may be ignored as well.
+
+        **Expected behavior**
+        A clear and concise description of what you expected to happen.
+
+        **Screenshots**
+        If applicable, add screenshots to help explain your problem.
+
+        **Additional context**
+        Add any other context about the problem here.
+    validations:
+      required: true
+  - type: dropdown
+    attributes:
+      label: Which packages was the bug in?
+      multiple: true
+      options:
+        - Python Core (autogen-core)
+        - Python AgentChat (autogen-agentchat>=0.4.0)
+        - Python Extensions (autogen-ext)
+        - .NET Core (Microsoft.AutoGen.Core)
+        - AutoGen Studio (autogensudio)
+        - AutoGen Bench (agbench)
+        - Magentic One CLI (magentic-one-cli)
+        - V0.2 (autogen-agetnchat==0.2.*)
+    validations:
+      required: true
+  - type: dropdown
+    attributes:
+      label: AutoGen library version.
+      description: What is the version of the library was used.
+      multiple: false
+      options:
+        - "Python dev (main branch)"
+        - "Python 0.4.7"
+        - "Python 0.4.6"
+        - "Python 0.4.5"
+        - "Python 0.4.4"
+        - "Python 0.4.3"
+        - "Python 0.4.2"
+        - "Python 0.4.1"
+        - "Python 0.4.0"
+        - ".NET dev (main branch)"
+        - "Studio 0.4.1"
+        - "Studio 0.4.0"
+        - "Other (please specify)"
+    validations:
+      required: True
+  - type: input
+    attributes:
+      label: Other library version.
+      description: "Please specify if selected 'Other' above"
+  - type: input
+    attributes:
+      label: Model used
+      description: If a model was used, please name here. Use full model name with version number.
+      placeholder: "e.g., gpt-4o-2024-11-20"
+  - type: dropdown
+    attributes:
+      label: Model provider
+      description: The provider or hosting service that runs the model.
+      options:
+        - "Anthropic"
+        - "AWS Bedrock"
+        - "Azure OpenAI"
+        - "Azure AI Foundary (Azure AI Studio)"
+        - "DeepSeek (Hosted)"
+        - "GitHub Models"
+        - "Google Gemini"
+        - "Google Vertex AI"
+        - "HuggingFace Models (Hosted)"
+        - "HuggingFace Transformers (Local)"
+        - "LlamaCpp"
+        - "Mistral AI"
+        - "Ollama"
+        - "OpenAI"
+        - "OpenRouter"
+        - "Together AI"
+        - "vLLM"
+        - "Other (please specify below)"
+  - type: input
+    attributes:
+      label: Other model provider
+      description: "Other provider if not found above."
+  - type: dropdown
+    attributes:
+      label: Python version
+      options:
+        - "3.10"
+        - "3.11"
+        - "3.12"
+        - "3.13"
+        - Other (please note we only support Python 3.10+)
+  - type: dropdown
+    attributes:
+      label: .NET version
+      options:
+        - ".NET 9"
+        - ".NET 8"
+  - type: dropdown
+    attributes:
+      label: Operating system
+      options:
+        - Windows
+        - MacOS
+        - Ubuntu
+        - Fedora
+        - CentOS
+        - Other

.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/PULL_REQUEST_TEMPLATE.md

@@ -12,6 +12,6 @@
 
 ## Checks
 
-- [ ] I've included any doc changes needed for https://microsoft.github.io/autogen/. See https://microsoft.github.io/autogen/docs/Contribute#documentation to build and test documentation locally.
+- [ ] I've included any doc changes needed for <https://microsoft.github.io/autogen/>. See <https://github.com/microsoft/autogen/blob/main/CONTRIBUTING.md> to build and test documentation locally.
 - [ ] I've added tests (if relevant) corresponding to the changes introduced in this PR.
 - [ ] I've made sure all auto checks have passed.