Tool call result summary message

[jspv]

Why are these changes needed?

Creates a ToolCallResultSummaryMessage type more clearly differentiate when an agent is responding with a tool summary
vs. a TextMessage response from the LLM.

Related issue number

Closes #4754

Checks

• I've included any doc changes needed for https://microsoft.github.io/autogen/. See https://microsoft.github.io/autogen/docs/Contribute#documentation to build and test documentation locally.
• I've added tests (if relevant) corresponding to the changes introduced in this PR.
• I've made sure all auto checks have passed.

[husseinmozannar]

• We recently updated the naming of toolcallmessage and toolcallresultmessage, look to pull from main and then add your changes, there is no real conflict
• The naming "ToolCallResultSummaryMessage" is a bit too long, I would just do "ToolCallSummaryMessage" perhaps, i'm sure @ekzhu has opinions

[jspv]

Code updated per request

[husseinmozannar]

Thanks!

See the failing tests, I believe ChatMessage should contain ToolCallSummaryMessage because of the Response type

[husseinmozannar]

@victordibia This is related to #4725 I wonder what you think we should do

[ekzhu]

@jspv you can read about how to run tests in CONTRIBUTING.md

In some group chat orchestrator classes, you need to update the handling of message thread:

autogen/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_magentic_one/_magentic_one_orchestrator.py

Lines 426 to 427 in c74c2d6

	def _thread_to_context(self) -> List[LLMMessage]:
	"""Convert the message thread to a context for the model."""

autogen/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_selector_group_chat.py

Lines 103 to 104 in c74c2d6

	if isinstance(msg, TextMessage | StopMessage | HandoffMessage):
	message += f" {msg.content}"

Bonus: would be great to add test code to verify the text content has been added to the prompt that gets sent to the monkey patched model client, for SelectorGroupChat.

Also declare message types for assistant agent, only when there are tools.

autogen/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_assistant_agent.py

Lines 281 to 282 in c74c2d6

	def produced_message_types(self) -> List[type[ChatMessage]]:
	"""The types of messages that the assistant agent produces."""

[ekzhu]

@husseinmozannar I believe the recent changes to this PR has already resolved your requests.

[husseinmozannar]

@victordibia I believe this will break connection.py in AGS, specifically line 328 we should add ToolCallSummary

[victordibia]

@victordibia This is related to #4725 I wonder what you think we should do

It is related, we might defer to a seperate PR.

I feel #4725 might be better served by extending ToolCallExecutionEvent and FunctionExecutionResult to return data on data types returned.

I'll try to see how I can address the ags breaks

[ekzhu]

@husseinmozannar @victordibia please take over this PR from now on to address any changes necessary

[victordibia]

I have taken a look .. I'll address any changes needed in a seperate PR. (mostly to add checks for ToolCallSummaryMessage types). Its not exactly breaking for now (those messages may not show up in the UI)