Merge remote-tracking branch 'origin/main' into agentchat_memory_vd

.github/workflows/docs.yml

@@ -33,7 +33,7 @@ jobs:
           [
             # For main use the workflow target
             { ref: "${{github.ref}}", dest-dir: dev, uv-version: "0.5.13" },
-            { ref: "${{github.ref}}", dest-dir: stable, uv-version: "0.5.13" },
+            { ref: "v0.4.0", dest-dir: stable, uv-version: "0.5.13" },
             { ref: "v0.4.0.dev0", dest-dir: "0.4.0.dev0", uv-version: "0.5.11" },
             { ref: "v0.4.0.dev1", dest-dir: "0.4.0.dev1", uv-version: "0.5.11" },
             { ref: "v0.4.0.dev2", dest-dir: "0.4.0.dev2", uv-version: "0.5.11" },
@@ -48,6 +48,7 @@ jobs:
             { 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.13" },
             { ref: "v0.4.0.dev13", dest-dir: "0.4.0.dev13", uv-version: "0.5.13" },
+            { ref: "v0.4.0", dest-dir: "0.4.0", uv-version: "0.5.13" },
           ]
     steps:
       - name: Checkout

README.md

@@ -17,7 +17,7 @@
 
 ```bash
 # Install AgentChat and OpenAI client from Extensions
-pip install "autogen-agentchat" "autogen-ext[openai]"
+pip install -U "autogen-agentchat" "autogen-ext[openai]"
 ```
 
 The current stable version is v0.4. If you are upgrading from AutoGen v0.2, please refer to the [Migration Guide](https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/migration-guide.html) for detailed instructions on how to update your code and configurations.
@@ -44,7 +44,7 @@ Create a group chat team with an assistant agent, a web surfer agent, and a user
 for web browsing tasks. You need to install [playwright](https://playwright.dev/python/docs/library).
 
 ```python
-# pip install autogen-agentchat autogen-ext[openai,web-surfer]
+# pip install -U autogen-agentchat autogen-ext[openai,web-surfer]
 # playwright install
 import asyncio
 from autogen_agentchat.agents import AssistantAgent, UserProxyAgent

docs/switcher.json

@@ -1,13 +1,20 @@
 [
     {
-        "name": "0.2 (stable)",
-        "version": "0.2-stable",
-        "url": "/autogen/0.2/"
+        "name": "0.4.0 (stable)",
+        "version": "0.4.0",
+        "url": "/autogen/stable/",
+        "preferred": true
     },
     {
+        "name": "dev (main)",
         "version": "dev",
         "url": "/autogen/dev/"
     },
+    {
+        "name": "0.2",
+        "version": "0.2",
+        "url": "/autogen/0.2/"
+    },
     {
         "name": "0.4.0.dev0",
         "version": "0.4.0.dev0",
@@ -76,7 +83,6 @@
     {
         "name": "0.4.0.dev13",
         "version": "0.4.0.dev13",
-        "url": "/autogen/0.4.0.dev13/",
-        "preferred": true
+        "url": "/autogen/0.4.0.dev13/"
     }
 ]

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.dev13/) [![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/0.4.0.dev13/) [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/0.4.0.dev13/)
+[![PyPi autogen-core](https://img.shields.io/badge/PyPi-autogen--core-blue?logo=pypi)](https://pypi.org/project/autogen-core/) [![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/) [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/)
 
 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.dev13"
+version = "0.4.0"
 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.dev13",
+    "autogen-core==0.4.0",
     "aioconsole>=0.8.1"
 ]
 

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

@@ -20,7 +20,7 @@
             </li>
             <li class="toctree-l1">
                 <a target="_blank" class="reference internal"
-                    href="https://pypi.org/project/autogen-agentchat/0.4.0.dev13/">
+                    href="https://pypi.org/project/autogen-agentchat/">
                     <i class="fa-brands fa-python"></i>
                     PyPi
                     <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>

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

@@ -19,7 +19,7 @@
                 </a>
             </li>
             <li class="toctree-l1">
-                <a target="_blank" class="reference internal" href="https://pypi.org/project/autogen-core/0.4.0.dev13/">
+                <a target="_blank" class="reference internal" href="https://pypi.org/project/autogen-core/">
                     <i class="fa-brands fa-python"></i>
                     PyPi
                     <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>

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

@@ -20,7 +20,7 @@
                 </a>
             </li>
             <li class="toctree-l1">
-                <a target="_blank" class="reference internal" href="https://pypi.org/project/autogen-ext/0.4.0.dev13/">
+                <a target="_blank" class="reference internal" href="https://pypi.org/project/autogen-ext/">
                     <i class="fa-brands fa-python"></i>
                     PyPi
                     <i class="fa-solid fa-arrow-up-right-from-square fa-2xs"></i>

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

@@ -105,25 +105,22 @@ Get Started
 <div class="sd-card-title sd-font-weight-bold docutils">
 
 {fas}`people-group;pst-color-primary` AgentChat
-[![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/0.4.0.dev13/)
+[![PyPi autogen-agentchat](https://img.shields.io/badge/PyPi-autogen--agentchat-blue?logo=pypi)](https://pypi.org/project/autogen-agentchat/)
 
 </div>
 A programming framework for building conversational single and multi-agent applications.
 Built on Core.
 
 ```python
-# pip install "autogen-agentchat==0.4.0.dev13" "autogen-ext[openai]==0.4.0.dev13" "yfinance" "matplotlib"
+# pip install -U "autogen-agentchat" "autogen-ext[openai]"
 import asyncio
 from autogen_agentchat.agents import AssistantAgent
-from autogen_agentchat.ui import Console
 from autogen_ext.models.openai import OpenAIChatCompletionClient
-from autogen_ext.code_executors.local import LocalCommandLineCodeExecutor
-from autogen_ext.tools.code_execution import PythonCodeExecutionTool
 
 async def main() -> None:
-    tool = PythonCodeExecutionTool(LocalCommandLineCodeExecutor(work_dir="coding"))
-    agent = AssistantAgent("assistant", OpenAIChatCompletionClient(model="gpt-4o"), tools=[tool], reflect_on_tool_use=True)
-    await Console(agent.run_stream(task="Create a plot of MSFT stock prices in 2024 and save it to a file. Use yfinance and matplotlib."))
+    agent = AssistantAgent("assistant", OpenAIChatCompletionClient(model="gpt-4o"))
+    print(agent.run(task="Say 'Hello World!'"))
+
 asyncio.run(main())
 ```
 
@@ -139,7 +136,7 @@ Get Started
 
 :::
 
-:::{grid-item-card} {fas}`cube;pst-color-primary` Core [![PyPi autogen-core](https://img.shields.io/badge/PyPi-autogen--core-blue?logo=pypi)](https://pypi.org/project/autogen-core/0.4.0.dev13/)
+:::{grid-item-card} {fas}`cube;pst-color-primary` Core [![PyPi autogen-core](https://img.shields.io/badge/PyPi-autogen--core-blue?logo=pypi)](https://pypi.org/project/autogen-core/)
 :shadow: none
 :margin: 2 0 0 0
 :columns: 12 12 12 12
@@ -162,7 +159,7 @@ Get Started
 
 :::
 
-:::{grid-item-card} {fas}`puzzle-piece;pst-color-primary` Extensions [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/0.4.0.dev13/)
+:::{grid-item-card} {fas}`puzzle-piece;pst-color-primary` Extensions [![PyPi autogen-ext](https://img.shields.io/badge/PyPi-autogen--ext-blue?logo=pypi)](https://pypi.org/project/autogen-ext/)
 :shadow: none
 :margin: 2 0 0 0
 :columns: 12 12 12 12

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.dev13"
+pip install -U "autogen-agentchat"
 ```
 
 ```{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.dev13"
+pip install "autogen-ext[openai]"
 ```
 
 If you are using Azure OpenAI with AAD authentication, you need to install the following:

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

@@ -41,7 +41,7 @@ Be aware that agents may occasionally attempt risky actions, such as recruiting
 
 Install the required packages:
 ```bash
-pip install autogen-agentchat==0.4.0.dev13 autogen-ext[magentic-one,openai]==0.4.0.dev13
+pip install autogen-agentchat autogen-ext[magentic-one,openai]
 
 # If using the MultimodalWebSurfer, you also need to install playwright dependencies:
 playwright install --with-deps chromium

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.dev13\" \"autogen-ext[openai,azure]==0.4.0.dev13\""
+                "pip install -U \"autogen-agentchat\" \"autogen-ext[openai,azure]\""
             ]
         },
         {

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

@@ -28,7 +28,7 @@
                 "where agents take turn to generate a response. \n",
                 "Similar to {py:class}`~autogen_agentchat.teams.SelectorGroupChat`\n",
                 "and {py:class}`~autogen_agentchat.teams.RoundRobinGroupChat`, participant agents\n",
-                "broadcast their responses so all agents share the same mesasge context.\n",
+                "broadcast their responses so all agents share the same message context.\n",
                 "\n",
                 "Different from the other two group chat teams, at each turn,\n",
                 "**the speaker agent is selected based on the most recent\n",
@@ -83,7 +83,7 @@
                 "   - For information needed from the customer, either agent can hand off to the `\"user\"`.\n",
                 "3. The **Flights Refunder** processes refunds using the `refund_flight` tool when appropriate.\n",
                 "4. If an agent hands off to the `\"user\"`, the team execution will stop and wait for the user to input a response.\n",
-                "5. When the user provides input, it's sent back to the team as a {py:class}`~autogen_agentchat.messages.HandaffMessage`. This message is directed to the agent that originally requested user input.\n",
+                "5. When the user provides input, it's sent back to the team as a {py:class}`~autogen_agentchat.messages.HandoffMessage`. This message is directed to the agent that originally requested user input.\n",
                 "6. The process continues until the Travel Agent determines the task is complete and terminates the workflow."
             ]
         },

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

@@ -28,7 +28,7 @@
             },
             "outputs": [],
             "source": [
-                "pip install \"autogen-ext[openai]==0.4.0.dev13\""
+                "pip install \"autogen-ext[openai]\""
             ]
         },
         {
@@ -108,7 +108,7 @@
             },
             "outputs": [],
             "source": [
-                "pip install \"autogen-ext[openai,azure]==0.4.0.dev13\""
+                "pip install \"autogen-ext[openai,azure]\""
             ]
         },
         {

python/packages/autogen-core/docs/src/user-guide/core-user-guide/framework/distributed-agent-runtime.ipynb

@@ -24,7 +24,7 @@
                 "````{note}\n",
                 "The distributed agent runtime requires extra dependencies, install them using:\n",
                 "```bash\n",
-                "pip install \"autogen-ext[grpc]==0.4.0.dev13\"\n",
+                "pip install \"autogen-ext[grpc]\"\n",
                 "```\n",
                 "````\n",
                 "\n",
@@ -222,4 +222,4 @@
     },
     "nbformat": 4,
     "nbformat_minor": 2
-}
+}

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

@@ -54,7 +54,7 @@ Install the `autogen-core` package using pip:
 
 ```bash
 
-pip install "autogen-core==0.4.0.dev13"
+pip install "autogen-core"
 ```
 
 ```{note}