* Termination Conditions Tutorial (#4334)

* Fix format

* Update python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/termination.ipynb

* Update python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/termination.ipynb

* Update python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/termination.ipynb

* update docs

* update doc

---------

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

* initial addition of a user proxy agent in agentchat, related to #3614

* fix typing/mypy errors

* format fixes

* format and pyright checks

* update, add support for returning handoff message, add tests

---------

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

* Misc doc fixes

* Update _console.py

---------

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

* Console to return last processed (#4277)

* Preserve input generator type

* Add tests

* format

---------

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

* initial assistant client draft

* expose assistants client

* initial openai assistant agentchat draft

* update file search

* add delete methods and fix typing

* add tool execution

* fix tool call and add docstring

* abstract tools and support thread management

* add tests

* removed unused typevars

* add unsaved test changes

* test typing fixes

---------

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

* task can be ChatMessage; add group chat state validation step, and address swarm state valiation; change handling of start and reset to RPC to capture any error.

* Update tutorial note

* Console pretty print for on_messages_stream

* Update doc

* Update docs

* Support iterm inline image protocol in console output

* fix lint

---------

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

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

* fix select speaker for swarm

* Fix max-turn = 1 for swarm

* Initial work on magentic-one orchestrator port.

* Max turn parameter for group chats

* Add note no usage

* Handoff termination and show how to use it for asking user input

* lint

* Initial implementation of SOM agent

* add tests

* edit prompt

* Update prompt

* lint

* Add task type that are messages to enable multi-modal tasks.

* fix test

* AgentChat pause and resume a task
Resolves #3859

* Add

* Update usage

* Update usage

* WIP to address stateful group chat

* Refactor group chat to add reset and flags for running

* documentation

* Update version to dev4

* Agentchat refactor

* Move termination stop message to a separate field in task result

* Update quick start example

* Use string stop reason instead of stop message in task result for simpler API

* Use main function

* Termination condition as part of constructor

* Update doc

* Update notebooks

* Add token usage termination

* fix test

* Add token usage to messages

* small test edit

* AssistantAgent no longer sends out StopMessage. We use TextMentionTermination("TERMINATE") on the team instead for default setting.

* Fix test

* Custom selector function for SelectorGroupChat

* Update documentation

* Remove termination condition from team constructor

* fix usage

* `ChatAgent` declares the types of messages it produces

* Reset message to clear agent state

* format and lint

* Ability to generate handoff message from AssistantAgent

* Fix mypy

* Validation

---------

Co-authored-by: Victor Dibia <victordibia@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>

* 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>