Merge branch 'main' into u/#4354

.github/workflows/docs.yml

@@ -40,6 +40,7 @@ jobs:
             { ref: "v0.4.0.dev5", dest-dir: "0.4.0.dev5" },
             { ref: "v0.4.0.dev6", dest-dir: "0.4.0.dev6" },
             { ref: "v0.4.0.dev7", dest-dir: "0.4.0.dev7" },
+            { ref: "v0.4.0.dev8", dest-dir: "0.4.0.dev8" },
           ]
     steps:
       - name: Checkout

CONTRIBUTING.md

@@ -49,8 +49,8 @@ We will update verion numbers according to the following rules:
 
 1. Create a PR that updates the version numbers across the codebase ([example](https://github.com/microsoft/autogen/pull/4359))
     2. The docs CI will fail for the PR, but this is expected and will be resolved in the next step
-2. After merging the PR, create and push a tag that corresponds to the new verion. For example, for `0.4.0.dev7`:
-    - `git tag 0.4.0.dev7 && git push origin 0.4.0.dev7`
+2. After merging the PR, create and push a tag that corresponds to the new verion. For example, for `0.4.0.dev8`:
+    - `git tag 0.4.0.dev8 && git push origin 0.4.0.dev8`
 3. Restart the docs CI by finding the failed [job corresponding to the `push` event](https://github.com/microsoft/autogen/actions/workflows/docs.yml) and restarting all jobs
 4. Run [this](https://github.com/microsoft/autogen/actions/workflows/single-python-package.yml) workflow for each of the packages that need to be released and get an approval for the release for it to run
 
@@ -59,27 +59,27 @@ We will update verion numbers according to the following rules:
 To help ensure the health of the project and community the AutoGen committers have a weekly triage process to ensure that all issues and pull requests are reviewed and addressed in a timely manner. The following documents the responsibilites while on triage duty:
 
 - Issues
-    - Review all new issues - these will be tagged with [`needs-triage`](https://github.com/microsoft/autogen/issues?q=is%3Aissue%20state%3Aopen%20label%3Aneeds-triage).
-    - Apply appropriate labels:
-        - One of `proj-*` labels based on the project the issue is related to
-        - `documentation`: related to documentation
-        - `x-lang`: related to cross language functionality
-        - `dotnet`: related to .NET
-    - Add the issue to a relevant milestone if necessary
-    - If you can resolve the issue or reply to the OP please do.
-    - If you cannot resolve the issue, assign it to the appropriate person.
-    - If awaiting a reply add the tag `awaiting-op-response` (this will be auto removed when the OP replies).
-    - Bonus: there is a backlog of old issues that need to be reviewed - if you have time, review these as well and close or refresh as many as you can.
+  - Review all new issues - these will be tagged with [`needs-triage`](https://github.com/microsoft/autogen/issues?q=is%3Aissue%20state%3Aopen%20label%3Aneeds-triage).
+  - Apply appropriate labels:
+    - One of `proj-*` labels based on the project the issue is related to
+    - `documentation`: related to documentation
+    - `x-lang`: related to cross language functionality
+    - `dotnet`: related to .NET
+  - Add the issue to a relevant milestone if necessary
+  - If you can resolve the issue or reply to the OP please do.
+  - If you cannot resolve the issue, assign it to the appropriate person.
+  - If awaiting a reply add the tag `awaiting-op-response` (this will be auto removed when the OP replies).
+  - Bonus: there is a backlog of old issues that need to be reviewed - if you have time, review these as well and close or refresh as many as you can.
 - PRs
-    - The UX on GH flags all recently updated PRs. Draft PRs can be ignored, otherwise review all recently updated PRs.
-    - If a PR is ready for review and you can provide one please go ahead. If you cant, please assign someone. You can quickly spin up a codespace with the PR to test it out.
-    - If a PR is needing a reply from the op, please tag it `awaiting-op-response`.
-    - If a PR is approved and passes CI, its ready to merge, please do so.
-    - If it looks like there is a possibly transient CI failure, re-run failed jobs.
+  - The UX on GH flags all recently updated PRs. Draft PRs can be ignored, otherwise review all recently updated PRs.
+  - If a PR is ready for review and you can provide one please go ahead. If you cant, please assign someone. You can quickly spin up a codespace with the PR to test it out.
+  - If a PR is needing a reply from the op, please tag it `awaiting-op-response`.
+  - If a PR is approved and passes CI, its ready to merge, please do so.
+  - If it looks like there is a possibly transient CI failure, re-run failed jobs.
 - Discussions
-    - Look for recently updated discussions and reply as needed or find someone on the team to reply.
+  - Look for recently updated discussions and reply as needed or find someone on the team to reply.
 - Security
-    - Look through any securty alerts and file issues or dismiss as needed.
+  - Look through any securty alerts and file issues or dismiss as needed.
 
 ## Becoming a Reviewer
 

README.md

@@ -4,14 +4,14 @@
 <img src="https://microsoft.github.io/autogen/0.2/img/ag.svg" alt="AutoGen Logo" width="100">
 
 [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/cloudposse.svg?style=social&label=Follow%20%40pyautogen)](https://twitter.com/pyautogen) [![GitHub Discussions](https://img.shields.io/badge/Discussions-Q%26A-green?logo=github)](https://github.com/microsoft/autogen/discussions) [![0.2 Docs](https://img.shields.io/badge/Docs-0.2-blue)](https://microsoft.github.io/autogen/0.2/) [![0.4 Docs](https://img.shields.io/badge/Docs-0.4-blue)](https://microsoft.github.io/autogen/dev/)
-[![PyPi autogen-core](https://img.shields.io/badge/PyPi-autogen--core-blue?logo=pypi)](https://pypi.org/project/autogen-core/0.4.0.dev7/) [![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/0.4.0.dev7/) [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/0.4.0.dev7/)
-
+[![PyPi autogen-core](https://img.shields.io/badge/PyPi-autogen--core-blue?logo=pypi)](https://pypi.org/project/autogen-core/0.4.0.dev8/) [![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/0.4.0.dev8/) [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/0.4.0.dev8/)
 
 </div>
 
 # AutoGen
 
 > [!IMPORTANT]
+>
 > - (11/14/24) ⚠️ In response to a number of asks to clarify and distinguish between official AutoGen and its forks that created confusion, we issued a [clarification statement](https://github.com/microsoft/autogen/discussions/4217).
 > - (10/13/24) Interested in the standard AutoGen as a prior user? Find it at the actively-maintained *AutoGen* [0.2 branch](https://github.com/microsoft/autogen/tree/0.2) and `autogen-agentchat~=0.2` PyPi package.
 > - (10/02/24) [AutoGen 0.4](https://microsoft.github.io/autogen/dev) is a from-the-ground-up rewrite of AutoGen. Learn more about the history, goals and future at [this blog post](https://microsoft.github.io/autogen/blog). We’re excited to work with the community to gather feedback, refine, and improve the project before we officially release 0.4. This is a big change, so AutoGen 0.2 is still available, maintained, and developed in the [0.2 branch](https://github.com/microsoft/autogen/tree/0.2).
@@ -104,7 +104,7 @@ We look forward to your contributions!
 First install the packages:
 
 ```bash
-pip install 'autogen-agentchat==0.4.0.dev7' 'autogen-ext[openai]==0.4.0.dev7'
+pip install 'autogen-agentchat==0.4.0.dev8' 'autogen-ext[openai]==0.4.0.dev8'
 ```
 
 The following code uses OpenAI's GPT-4o model and you need to provide your

docs/switcher.json

@@ -46,7 +46,12 @@
     {
         "name": "0.4.0.dev7",
         "version": "0.4.0.dev7",
-        "url": "/autogen/0.4.0.dev7/",
+        "url": "/autogen/0.4.0.dev7/"
+    },
+    {
+        "name": "0.4.0.dev8",
+        "version": "0.4.0.dev8",
+        "url": "/autogen/0.4.0.dev8/",
         "preferred": true
     }
 ]

python/README.md

@@ -1,8 +1,7 @@
 # AutoGen Python packages
 
 [![0.4 Docs](https://img.shields.io/badge/Docs-0.4-blue)](https://microsoft.github.io/autogen/dev/)
-[![PyPi autogen-core](https://img.shields.io/badge/PyPi-autogen--core-blue?logo=pypi)](https://pypi.org/project/autogen-core/0.4.0.dev7/) [![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/0.4.0.dev7/) [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/0.4.0.dev7/)
-
+[![PyPi autogen-core](https://img.shields.io/badge/PyPi-autogen--core-blue?logo=pypi)](https://pypi.org/project/autogen-core/0.4.0.dev8/) [![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/0.4.0.dev8/) [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/0.4.0.dev8/)
 
 This directory works as a single `uv` workspace containing all project packages. See [`packages`](./packages/) to discover all project packages.
 
@@ -17,10 +16,13 @@ poe check
 ```
 
 ### Setup
+
 `uv` is a package manager that assists in creating the necessary environment and installing packages to run AutoGen.
+
 - [Install `uv`](https://docs.astral.sh/uv/getting-started/installation/).
 
 ### Virtual Environment
+
 During development, you may need to test changes made to any of the packages.\
 To do so, create a virtual environment where the AutoGen packages are installed based on the current state of the directory.\
 Run the following commands at the root level of the Python directory:
@@ -29,11 +31,14 @@ Run the following commands at the root level of the Python directory:
 uv sync --all-extras
 source .venv/bin/activate
 ```
+
 - `uv sync --all-extras` will create a `.venv` directory at the current level and install packages from the current directory along with any other dependencies. The `all-extras` flag adds optional dependencies.
 - `source .venv/bin/activate` activates the virtual environment.
 
 ### Common Tasks
+
 To create a pull request (PR), ensure the following checks are met. You can run each check individually:
+
 - Format: `poe format`
 - Lint: `poe lint`
 - Test: `poe test`

python/packages/autogen-agentchat/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "autogen-agentchat"
-version = "0.4.0.dev7"
+version = "0.4.0.dev8"
 license = {file = "LICENSE-CODE"}
 description = "AutoGen agents and teams library"
 readme = "README.md"
@@ -15,7 +15,7 @@ classifiers = [
     "Operating System :: OS Independent",
 ]
 dependencies = [
-    "autogen-core==0.4.0.dev7",
+    "autogen-core==0.4.0.dev8",
 ]
 
 [tool.uv]

python/packages/autogen-core/docs/src/index.md

@@ -61,7 +61,7 @@ AgentChat </div>
 High-level API that includes preset agents and teams for building multi-agent systems.
 
 ```sh
-pip install 'autogen-agentchat==0.4.0.dev7'
+pip install 'autogen-agentchat==0.4.0.dev8'
 ```
 
 💡 *Start here if you are looking for an API similar to AutoGen 0.2*
@@ -82,7 +82,7 @@ Get Started
 Provides building blocks for creating asynchronous, event driven multi-agent systems.
 
 ```sh
-pip install 'autogen-core==0.4.0.dev7'
+pip install 'autogen-core==0.4.0.dev8'
 ```
 
 +++

python/packages/autogen-core/docs/src/packages/index.md

@@ -31,10 +31,10 @@ myst:
 Library that is at a similar level of abstraction as AutoGen 0.2, including default agents and group chat.
 
 ```sh
-pip install 'autogen-agentchat==0.4.0.dev7'
+pip install 'autogen-agentchat==0.4.0.dev8'
 ```
 
-[{fas}`circle-info;pst-color-primary` User Guide](/user-guide/agentchat-user-guide/index.md) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_agentchat/autogen_agentchat.rst) | [{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-agentchat/0.4.0.dev7/) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/autogen/tree/main/python/packages/autogen-agentchat)
+[{fas}`circle-info;pst-color-primary` User Guide](/user-guide/agentchat-user-guide/index.md) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_agentchat/autogen_agentchat.rst) | [{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-agentchat/0.4.0.dev8/) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/autogen/tree/main/python/packages/autogen-agentchat)
 :::
 
 (pkg-info-autogen-core)=
@@ -46,10 +46,10 @@ pip install 'autogen-agentchat==0.4.0.dev7'
 Implements the core functionality of the AutoGen framework, providing basic building blocks for creating multi-agent systems.
 
 ```sh
-pip install 'autogen-core==0.4.0.dev7'
+pip install 'autogen-core==0.4.0.dev8'
 ```
 
-[{fas}`circle-info;pst-color-primary` User Guide](/user-guide/core-user-guide/index.md) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_core/autogen_core.rst) | [{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-core/0.4.0.dev7/) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/autogen/tree/main/python/packages/autogen-core)
+[{fas}`circle-info;pst-color-primary` User Guide](/user-guide/core-user-guide/index.md) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_core/autogen_core.rst) | [{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-core/0.4.0.dev8/) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/autogen/tree/main/python/packages/autogen-core)
 :::
 
 (pkg-info-autogen-ext)=
@@ -61,7 +61,7 @@ pip install 'autogen-core==0.4.0.dev7'
 Implementations of core components that interface with external services, or use extra dependencies. For example, Docker based code execution.
 
 ```sh
-pip install 'autogen-ext==0.4.0.dev7'
+pip install 'autogen-ext==0.4.0.dev8'
 ```
 
 Extras:
@@ -71,7 +71,7 @@ Extras:
 - `docker` needed for {py:class}`~autogen_ext.code_executors.DockerCommandLineCodeExecutor`
 - `openai` needed for {py:class}`~autogen_ext.models.OpenAIChatCompletionClient`
 
-[{fas}`circle-info;pst-color-primary` User Guide](/user-guide/extensions-user-guide/index.md) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_ext/autogen_ext.rst) | [{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-ext/0.4.0.dev7/) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/autogen/tree/main/python/packages/autogen-ext)
+[{fas}`circle-info;pst-color-primary` User Guide](/user-guide/extensions-user-guide/index.md) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_ext/autogen_ext.rst) | [{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-ext/0.4.0.dev8/) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/autogen/tree/main/python/packages/autogen-ext)
 :::
 
 (pkg-info-autogen-magentic-one)=

python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/installation.md

@@ -61,7 +61,7 @@ Install the `autogen-agentchat` package using pip:
 
 ```bash
 
-pip install 'autogen-agentchat==0.4.0.dev7'
+pip install 'autogen-agentchat==0.4.0.dev8'
 ```
 
 ```{note}
@@ -74,7 +74,7 @@ To use the OpenAI and Azure OpenAI models, you need to install the following
 extensions:
 
 ```bash
-pip install 'autogen-ext[openai]==0.4.0.dev7'
+pip install 'autogen-ext[openai]==0.4.0.dev8'
 ```
 
 ## Install Docker for Code Execution

python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/quickstart.ipynb

@@ -37,7 +37,7 @@
             },
             "outputs": [],
             "source": [
-                "pip install 'autogen-agentchat==0.4.0.dev7' 'autogen-ext[openai]==0.4.0.dev7'"
+                "pip install 'autogen-agentchat==0.4.0.dev8' 'autogen-ext[openai]==0.4.0.dev8'"
             ]
         },
         {