* Change nav depth

* Remove repetitive module names

* Increase nav depth

* Cloud event publishing

* Implement cloud event receiving

* impl host servicer and

* Add grpcio back to deps

* Update uv lock

* Replatform closure agent on base agent

* Fix mypy

* update agentcaht

---------

* Add special topic for agent direct messaging

* move to base

* update sub counts

* Fix tests

* Add type prefix subscription

* update example

---------

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

* add protobuf serialization test

* proto file regeneration

---------

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

* Update version to dev7

* update other references

* Add tool to check example in docstrings

* update lock

* add task

* add ignored message

* add example check CI

* Fix examples in docstrings

* formatting

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

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

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

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

* Update python/packages/autogen-ext/src/autogen_ext/agents/_openai_assistant_agent.py

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

* Update python/packages/autogen-ext/src/autogen_ext/agents/_openai_assistant_agent.py

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

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

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

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

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

* Formattinggp

---------

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

* Fix none check

* fix func

* fmt, lint

---------

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

* Update pyright and mypy

* fmt

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

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

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

* Add warnings for deprecated azure oai config changes

* Update docs and usages, simplify capabilities

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

* Make grpc an optional dependency

* add note to the runtime docs

* update version

---------

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

* Selector Group Chat Tutorial (#4112)

* update doc

* update

* Add custom selector function

* Update doc

---------

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

* task: added warning when none is called in intervention handler

* add leading underscore to indicate private to _warn_if_none method in intervention.py

* address comment of returning Any for result in intervention.py

* Update intervention.py to remove redundant name change

* Format and lint

---------

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

* delete files and update dependencies

* add explicit config exports

* ignore mypy error on nb

---------

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

* Misc doc fixes

* Update _console.py

---------

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

* Swarm Tutorial

* Include 2 swarm example, add svgs

* Include latest Swarm changes & Eric changes

* Update docs to remove UserProxyAgent

* Include latest Console changes

---------

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.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

* add ui streaming to distributed group chat example

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

* fix pyright error after updating dependencies

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

---------

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

When the tool expects complex inputs that require nested models, pydantic will generate a JSON Schema that will include references to other schemas using the `$ref` keyword (cf https://json-schema.org/understanding-json-schema/structuring#dollarref).

But the `$ref` keyword is not supported by OpenAI.

This fix:

1. Resolves the references and inlines the corresponding schemas.
2. Removes the then useless root `$defs` field of the JSON schema to save tokens.

Co-authored-by: Jean-Marc Le Roux <contact@jmlx.io>
Co-authored-by: Jack Gerrits <jackgerrits@users.noreply.github.com>

* fix select speaker for swarm

* Fix max-turn = 1 for swarm

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

* feat: watsonx support

* fix: addressing comments

* fix: addressing comments

* fix: addressing comments

* Delete python/packages/autogen-core/docs/src/user-guide/extensions-user-guide/watsonx-client-integration.md

* Update python/packages/autogen-core/docs/src/user-guide/extensions-user-guide/index.md

---------

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

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

* Max turn parameter for group chats

* Add note no usage

Removed "can", making it: which defines the messages that are passed...

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

* Various docs improvements

* Update python/packages/autogen-core/docs/src/user-guide/core-user-guide/framework/command-line-code-executors.ipynb

---------

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

* protobuf serialization in python

* remove test code

* clarify TODO