* Fix: `create_stream` to return valid usage token counts
* documentation

---------

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

* Reset message to clear agent state

* format and lint

* Run LocalCommandLineCodeExecutor within venv

* Remove create_virtual_env func and add docstring

* Add explanation for LocalCommandLineExecutor docstring example

* Enhance docstring example explanation

---------

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

* Ability to generate handoff message from AssistantAgent

* Fix mypy

* Validation

---------

Co-authored-by: Victor Dibia <victordibia@microsoft.com>

* adds Orleans persistence for AgentState

* first notebook for distributed rock, paper and scissors

* add distributed group chat notebook

* fix formatting

* fix pipeline issues

* fix formatting issue

* promote distributed group chat notebook into a multiple files

* fix docs

* fix docs

* fix pyright

* Apply suggestions from code review

Add PR review suggestions

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

* improving group chat manager from round robin to LLM based

Signed-off-by: Mohammad Mazraeh <mazraeh.mohammad@gmail.com>

* remove lfs file to fix

Signed-off-by: Mohammad Mazraeh <mazraeh.mohammad@gmail.com>

* add gut back using lfs

Signed-off-by: Mohammad Mazraeh <mazraeh.mohammad@gmail.com>

* re-add gif using lfs

Signed-off-by: Mohammad Mazraeh <mazraeh.mohammad@gmail.com>

* remove gitattributes

Signed-off-by: Mohammad Mazraeh <mazraeh.mohammad@gmail.com>

* redo git lfs add

---------

Signed-off-by: Mohammad Mazraeh <mazraeh.mohammad@gmail.com>
Co-authored-by: Ryan Sweet <rysweet@microsoft.com>
Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

a mistake about in User Guide sector

Co-authored-by: Leonardo Pinheiro <lpinheiro@microsoft.com>

* Add AssistantAgent, deprecate CodingAssistantAgent and ToolUseAssistantAgent

* Rename

* Add note

* Update uv

* uf lock

* Merge branch 'main' into assistant-agent

* Update uv

Add handoff message type to chat message types
Add Swarm group chat that uses handoff message to select next speaker
Remove tool call and tool call result message types from chat message types
Remove BaseToolUseChatAgent, move tool call handling from group chat's chat agent container upward to the ToolUseAssistantAgent implementation, which subclasses BaseChatAgent directly.
Renaming for better clarity

---------

Co-authored-by: Victor Dibia <victordibia@microsoft.com>

* Add css override for banner

* remove merge conflict

* Corrected grammatical errors and typos

* Corrected formating issues

* add comment to explain await vs run

* update output and import

---------

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

* Update dev version

* Update uv

* C#

* update versions

---------

Co-authored-by: Jack Gerrits <jack@jackgerrits.com>
Co-authored-by: Jack Gerrits <jackgerrits@users.noreply.github.com>

* test multiversion build

* Work on multiversion build

* update refs

* cancel in progress

* add docs dir

* add version switcher

* add version switcher

* add preferred

* version banner and hacky value override...

* add release version

* Allow callable to be used as `registered_tools` in `ToolUseAssistantAgent`.

* fix

* migrate models

* Update python/packages/autogen-agentchat/src/autogen_agentchat/agents/_tool_use_assistant_agent.py

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

* refactor missing imports

* ignore type check errors

* Update python/packages/autogen-ext/src/autogen_ext/models/_openai/_model_info.py

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

* update packages index page

---------

Co-authored-by: Leonardo Pinheiro <lpinheiro@microsoft.com>
Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

* Use dall-e-3 and better prompt to create character consistency for group chat image generation example

* format

Added contributors to recognize the other devs who helped build the example

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

* Update group chat documentation in core to use selector group chat and tool call for illustrator

* Update notebook

* Update group chat with illustration

* Remove embedded fonts in svg

---------

Co-authored-by: Ryan Sweet <rysweet@microsoft.com>

* Create Semantic Router example

* ruff formatting

* linting fixes

* pyright fixes

---------

Co-authored-by: Jack Gerrits <jackgerrits@users.noreply.github.com>

* Move from tomllib to tomli

* added example code for magentic-one + code comments

* adding benchmarks temporarily

* add license for datasets

* revert changes to magentic-one

* change license location

---------

Co-authored-by: Ryan Sweet <rysweet@microsoft.com>

* Restructure extensions, update corresponding docs

* update tests, add deprecation messages

* fix tests

* update lockfile

---------

Co-authored-by: Ryan Sweet <rysweet@microsoft.com>

* Move from tomllib to tomli

* added example code for magentic-one + code comments

* remove added package

* make checks pass

* README for magentic-one examples

* typo fix

---------

* Update FunctionCallGenerator.cs to address race condition

Update FunctionCallGenerator.cs to address race condition

* Update Dockerfile

Use MCR registry

* Update Dockerfile

Use MCR registry

closes #3809 - refactor .NET code foldersand namespaces for better clarity and maintainability

* Update version to dev1

* lockfile

* update tilde

* Update indexes for better navigation

* Fix link

* Fix link

* Support structured output

* use ruff format

* add type checking for cookbook

* add the notebook to index.md

* fix the type error

* pass response_format explicitly

* remove casting

* ensure type are correct

* seperate response_format arg

* fix type and resolve pyright errors

---------

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>