dev12

.github/workflows/docs.yml

@@ -45,6 +45,7 @@ jobs:
             { ref: "v0.4.0.dev9", dest-dir: "0.4.0.dev9", uv-version: "0.5.11" },
             { ref: "v0.4.0.dev10", dest-dir: "0.4.0.dev10", uv-version: "0.5.11" },
             { ref: "v0.4.0.dev11", dest-dir: "0.4.0.dev11", uv-version: "0.5.11" },
+            { ref: "v0.4.0.dev12", dest-dir: "0.4.0.dev12", uv-version: "0.5.11" },
           ]
     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.dev11`:
-    - `git tag 0.4.0.dev11 && git push origin 0.4.0.dev11`
+2. After merging the PR, create and push a tag that corresponds to the new verion. For example, for `0.4.0.dev12`:
+    - `git tag 0.4.0.dev12 && git push origin 0.4.0.dev12`
 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
 

README.md

@@ -5,22 +5,21 @@
 
 [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/cloudposse.svg?style=social&label=Follow%20%40pyautogen)](https://twitter.com/pyautogen) [![LinkedIn](https://img.shields.io/badge/LinkedIn-Company?style=flat&logo=linkedin&logoColor=white)](https://www.linkedin.com/company/105812540) [![Discord](https://img.shields.io/badge/discord-chat-green?logo=discord)](https://aka.ms/autogen-discord) [![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.dev11/) [![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/0.4.0.dev11/) [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/0.4.0.dev11/)
+[![PyPi autogen-core](https://img.shields.io/badge/PyPi-autogen--core-blue?logo=pypi)](https://pypi.org/project/autogen-core/0.4.0.dev12/) [![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/0.4.0.dev12/) [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/0.4.0.dev12/)
 </div>
 
 # AutoGen
 
 > [!IMPORTANT]
 >
-> - (12/19/24) Hello! 
+> - (12/19/24) Hello!
 The majority of the AutoGen Team members will be resting and recharging with family and friends over the holiday period. Activity/responses on the project may be delayed during the period of Dec 20-Jan 06. We will be excited to engage with you in the new year!
 > - (12/11/24) We have created a new Discord server for the AutoGen community. Join us at [aka.ms/autogen-discord](https://aka.ms/autogen-discord).
 > - (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).
 > - *[Join us for Community Office Hours](https://github.com/microsoft/autogen/discussions/4059)* We will host a weekly open discussion to answer questions, talk about Roadmap, etc.
 
-
 AutoGen is an open-source framework for building AI agent systems.
 It simplifies the creation of event-driven, distributed, scalable, and resilient agentic applications.
 It allows you to quickly build systems where AI agents collaborate and perform tasks autonomously
@@ -108,7 +107,7 @@ We look forward to your contributions!
 First install the packages:
 
 ```bash
-pip install "autogen-agentchat==0.4.0.dev11" "autogen-ext[openai]==0.4.0.dev11"
+pip install "autogen-agentchat==0.4.0.dev12" "autogen-ext[openai]==0.4.0.dev12"
 ```
 
 The following code uses OpenAI's GPT-4o model and you need to provide your

docs/switcher.json

@@ -66,7 +66,12 @@
     {
         "name": "0.4.0.dev11",
         "version": "0.4.0.dev11",
-        "url": "/autogen/0.4.0.dev11/",
+        "url": "/autogen/0.4.0.dev11/"
+    },
+    {
+        "name": "0.4.0.dev12",
+        "version": "0.4.0.dev12",
+        "url": "/autogen/0.4.0.dev12/",
         "preferred": true
     }
 ]

python/README.md

@@ -1,7 +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.dev11/) [![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/0.4.0.dev11/) [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/0.4.0.dev11/)
+[![PyPi autogen-core](https://img.shields.io/badge/PyPi-autogen--core-blue?logo=pypi)](https://pypi.org/project/autogen-core/0.4.0.dev12/) [![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/0.4.0.dev12/) [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/0.4.0.dev12/)
 
 This directory works as a single `uv` workspace containing all project packages. See [`packages`](./packages/) to discover all project packages.
 

python/packages/autogen-agentchat/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "autogen-agentchat"
-version = "0.4.0.dev11"
+version = "0.4.0.dev12"
 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.dev11",
+    "autogen-core==0.4.0.dev12",
 ]
 
 [tool.ruff]

python/packages/autogen-core/docs/src/_templates/sidebar-nav-bs-agentchat.html

@@ -1,38 +1,39 @@
 {# Displays the TOC-subtree for pages nested under the currently active top-level TOCtree element. #}
 
-<nav class="bd-docs-nav bd-links"
-     aria-label="{{ _('Section Navigation') }}">
-  <div class="bd-toc-item navbar-nav">
-    {{- generate_toctree_html(
-      "sidebar",
-      show_nav_level=theme_show_nav_level | int,
-      maxdepth=theme_navigation_depth | int,
-      collapse=theme_collapse_navigation | tobool,
-      includehidden=theme_sidebar_includehidden | tobool,
-      titles_only=True
-      )
-    -}}
-    <ul class="nav bd-sidenav">
-      <li class="toctree-l1">
-        <a class="reference internal" href="{{pathto('reference/python/autogen_agentchat')}}">
-          <i class="fa-solid fa-file-code"></i>
-          API Reference
-        </a>
-      </li>
-      <li class="toctree-l1">
-        <a target="_blank" class="reference internal" href="https://pypi.org/project/autogen-agentchat/0.4.0.dev11/">
-          <i class="fa-brands fa-python"></i>
-          PyPi
-          <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
-        </a>
-      </li>
-      <li class="toctree-l1">
-        <a target="_blank" class="reference internal" href="https://github.com/microsoft/autogen/tree/main/python/packages/autogen-agentchat">
-          <i class="fa-brands fa-github"></i>
-          Source
-          <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
-        </a>
-      </li>
-    </ul>
-  </div>
+<nav class="bd-docs-nav bd-links" aria-label="{{ _('Section Navigation') }}">
+    <div class="bd-toc-item navbar-nav">
+        {{- generate_toctree_html(
+        "sidebar",
+        show_nav_level=theme_show_nav_level | int,
+        maxdepth=theme_navigation_depth | int,
+        collapse=theme_collapse_navigation | tobool,
+        includehidden=theme_sidebar_includehidden | tobool,
+        titles_only=True
+        )
+        -}}
+        <ul class="nav bd-sidenav">
+            <li class="toctree-l1">
+                <a class="reference internal" href="{{pathto('reference/python/autogen_agentchat')}}">
+                    <i class="fa-solid fa-file-code"></i>
+                    API Reference
+                </a>
+            </li>
+            <li class="toctree-l1">
+                <a target="_blank" class="reference internal"
+                    href="https://pypi.org/project/autogen-agentchat/0.4.0.dev12/">
+                    <i class="fa-brands fa-python"></i>
+                    PyPi
+                    <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
+                </a>
+            </li>
+            <li class="toctree-l1">
+                <a target="_blank" class="reference internal"
+                    href="https://github.com/microsoft/autogen/tree/main/python/packages/autogen-agentchat">
+                    <i class="fa-brands fa-github"></i>
+                    Source
+                    <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
+                </a>
+            </li>
+        </ul>
+    </div>
 </nav>

python/packages/autogen-core/docs/src/_templates/sidebar-nav-bs-core.html

@@ -1,38 +1,38 @@
 {# Displays the TOC-subtree for pages nested under the currently active top-level TOCtree element. #}
 
-<nav class="bd-docs-nav bd-links"
-     aria-label="{{ _('Section Navigation') }}">
-  <div class="bd-toc-item navbar-nav">
-    {{- generate_toctree_html(
-      "sidebar",
-      show_nav_level=theme_show_nav_level | int,
-      maxdepth=theme_navigation_depth | int,
-      collapse=theme_collapse_navigation | tobool,
-      includehidden=theme_sidebar_includehidden | tobool,
-      titles_only=True
-      )
-    -}}
-    <ul class="nav bd-sidenav">
-      <li class="toctree-l1">
-        <a class="reference internal" href="{{pathto('reference/python/autogen_core')}}">
-          <i class="fa-solid fa-file-code"></i>
-          API Reference
-        </a>
-      </li>
-      <li class="toctree-l1">
-        <a target="_blank" class="reference internal" href="https://pypi.org/project/autogen-core/0.4.0.dev11/">
-          <i class="fa-brands fa-python"></i>
-          PyPi
-          <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
-        </a>
-      </li>
-      <li class="toctree-l1">
-        <a target="_blank" class="reference internal" href="https://github.com/microsoft/autogen/tree/main/python/packages/autogen-core">
-          <i class="fa-brands fa-github"></i>
-          Source
-          <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
-        </a>
-      </li>
-    </ul>
-  </div>
-</nav>
+<nav class="bd-docs-nav bd-links" aria-label="{{ _('Section Navigation') }}">
+    <div class="bd-toc-item navbar-nav">
+        {{- generate_toctree_html(
+        "sidebar",
+        show_nav_level=theme_show_nav_level | int,
+        maxdepth=theme_navigation_depth | int,
+        collapse=theme_collapse_navigation | tobool,
+        includehidden=theme_sidebar_includehidden | tobool,
+        titles_only=True
+        )
+        -}}
+        <ul class="nav bd-sidenav">
+            <li class="toctree-l1">
+                <a class="reference internal" href="{{pathto('reference/python/autogen_core')}}">
+                    <i class="fa-solid fa-file-code"></i>
+                    API Reference
+                </a>
+            </li>
+            <li class="toctree-l1">
+                <a target="_blank" class="reference internal" href="https://pypi.org/project/autogen-core/0.4.0.dev12/">
+                    <i class="fa-brands fa-python"></i>
+                    PyPi
+                    <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
+                </a>
+            </li>
+            <li class="toctree-l1">
+                <a target="_blank" class="reference internal"
+                    href="https://github.com/microsoft/autogen/tree/main/python/packages/autogen-core">
+                    <i class="fa-brands fa-github"></i>
+                    Source
+                    <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
+                </a>
+            </li>
+        </ul>
+    </div>
+</nav>

python/packages/autogen-core/docs/src/_templates/sidebar-nav-bs-extensions.html

@@ -1,39 +1,39 @@
 {# Displays the TOC-subtree for pages nested under the currently active top-level TOCtree element. #}
 
-<nav class="bd-docs-nav bd-links"
-     aria-label="{{ _('Section Navigation') }}">
-  <div class="bd-toc-item navbar-nav">
-    {{- generate_toctree_html(
-      "sidebar",
-      show_nav_level=theme_show_nav_level | int,
-      maxdepth=theme_navigation_depth | int,
-      collapse=theme_collapse_navigation | tobool,
-      includehidden=theme_sidebar_includehidden | tobool,
-      titles_only=True
-      )
-    -}}
-    <p aria-level="2" class="caption" role="heading"><span class="caption-text">More</span></p>
-    <ul class="nav bd-sidenav">
-      <li class="toctree-l1">
-        <a class="reference internal" href="{{pathto('reference/python/autogen_ext.agents.magentic_one')}}">
-          <i class="fa-solid fa-file-code"></i>
-          API Reference
-        </a>
-      </li>
-      <li class="toctree-l1">
-        <a target="_blank" class="reference internal" href="https://pypi.org/project/autogen-ext/0.4.0.dev11/">
-          <i class="fa-brands fa-python"></i>
-          PyPi
-          <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
-        </a>
-      </li>
-      <li class="toctree-l1">
-        <a target="_blank" class="reference internal" href="https://github.com/microsoft/autogen/tree/main/python/packages/autogen-ext">
-          <i class="fa-brands fa-github"></i>
-          Source
-          <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
-        </a>
-      </li>
-    </ul>
-  </div>
-</nav>
+<nav class="bd-docs-nav bd-links" aria-label="{{ _('Section Navigation') }}">
+    <div class="bd-toc-item navbar-nav">
+        {{- generate_toctree_html(
+        "sidebar",
+        show_nav_level=theme_show_nav_level | int,
+        maxdepth=theme_navigation_depth | int,
+        collapse=theme_collapse_navigation | tobool,
+        includehidden=theme_sidebar_includehidden | tobool,
+        titles_only=True
+        )
+        -}}
+        <p aria-level="2" class="caption" role="heading"><span class="caption-text">More</span></p>
+        <ul class="nav bd-sidenav">
+            <li class="toctree-l1">
+                <a class="reference internal" href="{{pathto('reference/python/autogen_ext.agents.magentic_one')}}">
+                    <i class="fa-solid fa-file-code"></i>
+                    API Reference
+                </a>
+            </li>
+            <li class="toctree-l1">
+                <a target="_blank" class="reference internal" href="https://pypi.org/project/autogen-ext/0.4.0.dev12/">
+                    <i class="fa-brands fa-python"></i>
+                    PyPi
+                    <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
+                </a>
+            </li>
+            <li class="toctree-l1">
+                <a target="_blank" class="reference internal"
+                    href="https://github.com/microsoft/autogen/tree/main/python/packages/autogen-ext">
+                    <i class="fa-brands fa-github"></i>
+                    Source
+                    <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>
+                </a>
+            </li>
+        </ul>
+    </div>
+</nav>

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

@@ -58,7 +58,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.dev11"
+pip install "autogen-agentchat==0.4.0.dev12"
 ```
 
 💡 *Start here if you are looking for an API similar to AutoGen 0.2.*
@@ -89,17 +89,15 @@ Get Started
 
 :::
 
-
 :::{grid-item-card} {fas}`cube;pst-color-primary` Core
 :shadow: none
 :margin: 2 0 0 0
 :columns: 12 12 6 6
 
-
 Provides building blocks for creating asynchronous, event driven multi-agent systems.
 
 ```sh
-pip install "autogen-core==0.4.0.dev11"
+pip install "autogen-core==0.4.0.dev12"
 ```
 
 +++
@@ -117,11 +115,10 @@ Get Started
 :margin: 2 0 0 0
 :columns: 12 12 6 6
 
-
 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.dev11"
+pip install "autogen-ext==0.4.0.dev12"
 ```
 
 +++

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.dev11"
+pip install "autogen-agentchat==0.4.0.dev12"
 ```
 
 ```{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.dev11"
+pip install "autogen-ext[openai]==0.4.0.dev12"
 ```
 
 ## Install Docker for Code Execution

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

@@ -29,7 +29,7 @@
             },
             "outputs": [],
             "source": [
-                "pip install \"autogen-agentchat==0.4.0.dev11\" \"autogen-ext[openai]==0.4.0.dev11\""
+                "pip install \"autogen-agentchat==0.4.0.dev12\" \"autogen-ext[openai]==0.4.0.dev12\""
             ]
         },
         {