Merge branch 'main' into redis/support-linear-memory

Author: justin-cechmanek

.github/ISSUE_TEMPLATE/1-bug_report.yml

@@ -90,6 +90,8 @@ body:
       multiple: false
       options:
         - "Python dev (main branch)"
+        - "Python 0.7.4"
+        - "Python 0.7.3"
         - "Python 0.7.2"
         - "Python 0.7.1"
         - "Python 0.6.4"

.github/workflows/docs.yml

@@ -39,7 +39,7 @@ jobs:
               poe-dir: ".",
             },
             {
-              ref: "python-v0.7.2",
+              ref: "python-v0.7.4",
               dest-dir: stable,
               uv-version: "0.7.13",
               sphinx-release-override: "stable",
@@ -199,6 +199,20 @@ jobs:
               sphinx-release-override: "",
               poe-dir: ".",
             },
+            {
+              ref: "python-v0.7.3",
+              dest-dir: "0.7.3",
+              uv-version: "0.7.13",
+              sphinx-release-override: "",
+              poe-dir: ".",
+            },
+            {
+              ref: "python-v0.7.4",
+              dest-dir: "0.7.4",
+              uv-version: "0.7.13",
+              sphinx-release-override: "",
+              poe-dir: ".",
+            },
           ]
     steps:
       - name: Checkout
@@ -216,8 +230,6 @@ jobs:
       - run: |
           uv venv --python=3.11
           source .venv/bin/activate
-          # Only pin version to ensure compatibility
-          uv pip install -U 'setuptools-scm==8.3.1'
           uv sync --locked --all-extras
           poe --directory ${{ matrix.version.poe-dir }} docs-build
           mkdir -p docs-staging/${{ matrix.version.dest-dir }}/

README.md

@@ -24,7 +24,7 @@ AutoGen requires **Python 3.10 or later**.
 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/stable/user-guide/agentchat-user-guide/migration-guide.html) for detailed instructions on how to update your code and configurations.
+The current stable version can be found in the [releases](https://github.com/microsoft/autogen/releases). If you are upgrading from AutoGen v0.2, please refer to the [Migration Guide](https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/migration-guide.html) for detailed instructions on how to update your code and configurations.
 
 ```bash
 # Install AutoGen Studio for no-code GUI
@@ -43,7 +43,7 @@ from autogen_agentchat.agents import AssistantAgent
 from autogen_ext.models.openai import OpenAIChatCompletionClient
 
 async def main() -> None:
-    model_client = OpenAIChatCompletionClient(model="gpt-4o")
+    model_client = OpenAIChatCompletionClient(model="gpt-4.1")
     agent = AssistantAgent("assistant", model_client=model_client)
     print(await agent.run(task="Say 'Hello World!'"))
     await model_client.close()
@@ -90,6 +90,58 @@ asyncio.run(main())
 > **Warning**: Only connect to trusted MCP servers as they may execute commands
 > in your local environment or expose sensitive information.
 
+### Multi-Agent Orchestration
+
+You can use `AgentTool` to create a basic multi-agent orchestration setup.
+
+```python
+import asyncio
+
+from autogen_agentchat.agents import AssistantAgent
+from autogen_agentchat.tools import AgentTool
+from autogen_agentchat.ui import Console
+from autogen_ext.models.openai import OpenAIChatCompletionClient
+
+
+async def main() -> None:
+    model_client = OpenAIChatCompletionClient(model="gpt-4.1")
+
+    math_agent = AssistantAgent(
+        "math_expert",
+        model_client=model_client,
+        system_message="You are a math expert.",
+        description="A math expert assistant.",
+        model_client_stream=True,
+    )
+    math_agent_tool = AgentTool(math_agent, return_value_as_last_message=True)
+
+    chemistry_agent = AssistantAgent(
+        "chemistry_expert",
+        model_client=model_client,
+        system_message="You are a chemistry expert.",
+        description="A chemistry expert assistant.",
+        model_client_stream=True,
+    )
+    chemistry_agent_tool = AgentTool(chemistry_agent, return_value_as_last_message=True)
+
+    agent = AssistantAgent(
+        "assistant",
+        system_message="You are a general assistant. Use expert tools when needed.",
+        model_client=model_client,
+        model_client_stream=True,
+        tools=[math_agent_tool, chemistry_agent_tool],
+        max_tool_iterations=10,
+    )
+    await Console(agent.run_stream(task="What is the integral of x^2?"))
+    await Console(agent.run_stream(task="What is the molecular weight of water?"))
+
+
+asyncio.run(main())
+```
+
+For more advanced multi-agent orchestrations and workflows, read
+[AgentChat documentation](https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/index.html).
+
 ### AutoGen Studio
 
 Use AutoGen Studio to prototype and run multi-agent workflows without writing code.

docs/dotnet/core/index.md

@@ -81,7 +81,7 @@ You can run the backend on its own:
 dotnet run --project Microsoft.AutoGen.AgentHost
 ```
 
-or you can run iclude it inside your own application:
+or you can include it inside your own application:
 
 ```csharp
 using Microsoft.AutoGen.RuntimeGateway;

docs/switcher.json

@@ -5,11 +5,21 @@
         "url": "/autogen/dev/"
     },
     {
-        "name": "0.7.2 (stable)",
+        "name": "0.7.4 (stable)",
         "version": "stable",
         "url": "/autogen/stable/",
         "preferred": true
     },
+    {
+        "name": "0.7.3",
+        "version": "0.7.3",
+        "url": "/autogen/0.7.3/"
+    },
+    {
+        "name": "0.7.2",
+        "version": "0.7.2",
+        "url": "/autogen/0.7.2/"
+    },
     {
         "name": "0.7.1",
         "version": "0.7.1",

python/packages/autogen-agentchat/pyproject.toml

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

python/packages/autogen-agentchat/src/autogen_agentchat/tools/_task_runner_tool.py

@@ -36,6 +36,7 @@ def __init__(
             return_type=TaskResult,
             name=name,
             description=description,
+            strict=True,
         )
 
     async def run(self, args: TaskRunnerToolArgs, cancellation_token: CancellationToken) -> TaskResult:

python/packages/autogen-core/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "autogen-core"
-version = "0.7.2"
+version = "0.7.4"
 license = {file = "LICENSE-CODE"}
 description = "Foundational interfaces and agent runtime implementation for AutoGen"
 readme = "README.md"

python/packages/autogen-core/src/autogen_core/models/_model_client.py

@@ -18,6 +18,7 @@ class ModelFamily:
 
     This namespace class holds constants for the model families that AutoGen understands. Other families definitely exist and can be represented by a string, however, AutoGen will treat them as unknown."""
 
+    GPT_5 = "gpt-5"
     GPT_41 = "gpt-41"
     GPT_45 = "gpt-45"
     GPT_4O = "gpt-4o"
@@ -53,6 +54,7 @@ class ModelFamily:
 
     ANY: TypeAlias = Literal[
         # openai_models
+        "gpt-5",
         "gpt-41",
         "gpt-45",
         "gpt-4o",
@@ -121,6 +123,7 @@ def is_gemini(family: str) -> bool:
     @staticmethod
     def is_openai(family: str) -> bool:
         return family in (
+            ModelFamily.GPT_5,
             ModelFamily.GPT_45,
             ModelFamily.GPT_41,
             ModelFamily.GPT_4O,

python/packages/autogen-ext/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "autogen-ext"
-version = "0.7.2"
+version = "0.7.4"
 license = {file = "LICENSE-CODE"}
 description = "AutoGen extensions library"
 readme = "README.md"
@@ -15,7 +15,7 @@ classifiers = [
     "Operating System :: OS Independent",
 ]
 dependencies = [
-    "autogen-core==0.7.2",
+    "autogen-core==0.7.4",
 ]
 
 [project.optional-dependencies]
@@ -32,7 +32,7 @@ docker = ["docker~=7.0", "asyncio_atexit>=1.0.1"]
 ollama = ["ollama>=0.4.7", "tiktoken>=0.8.0"]
 openai = ["openai>=1.93", "tiktoken>=0.8.0", "aiofiles"]
 file-surfer = [
-    "autogen-agentchat==0.7.2",
+    "autogen-agentchat==0.7.4",
     "magika>=0.6.1rc2",
     "markitdown[all]~=0.1.0a3",
 ]
@@ -50,21 +50,21 @@ mem0-local = [
     "chromadb>=1.0.0"
 ]
 web-surfer = [
-    "autogen-agentchat==0.7.2",
+    "autogen-agentchat==0.7.4",
     "playwright>=1.48.0",
     "pillow>=11.0.0",
     "magika>=0.6.1rc2",
     "markitdown[all]~=0.1.0a3",
 ]
 magentic-one = [
-    "autogen-agentchat==0.7.2",
+    "autogen-agentchat==0.7.4",
     "magika>=0.6.1rc2",
     "markitdown[all]~=0.1.0a3",
     "playwright>=1.48.0",
     "pillow>=11.0.0",
 ]
 video-surfer = [
-    "autogen-agentchat==0.7.2",
+    "autogen-agentchat==0.7.4",
     "opencv-python>=4.5",
     "ffmpeg-python",
     "openai-whisper",