* Move LLMUsageTracker to a cookbook

* rename, add to index

* fmt and remove test

* Update python/packages/autogen-core/docs/src/user-guide/core-user-guide/cookbook/llm-usage-logger.ipynb

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Fix missing quotation marks in notebook

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Core API example showing multiple agents concurrently (#4427)

* Apply feedback

* Add different topics for closure agent example

* Address feedback

* Mypy fix

* Modify import path based on refactoring

---------

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

* Flatten core base and components

* remove extra files

* dont export from deprecated locations

* format

* fmt

* Change nav depth

* Remove repetitive module names

* Increase nav depth

* Decrease base font size of docs

* Improve docs

* Undo css change

* allowed_type_values

* add return for post init

* Update python/packages/autogen-core/src/autogen_core/base/_agent_id.py

* Update python/packages/autogen-core/src/autogen_core/base/_topic.py

* Merge branch 'main' into allowed_type_values

* lint

* Change base agent to use on message impl

* update doc

* Update

* Merge branch 'main' into on_msg_impl

* adds a python xlang sample and aspire code to host it
* fixes message delivery on dotnet runtime

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