chore: import upstream snapshot with attribution

python/semantic_kernel/agents/strategies/termination/aggregator_termination_strategy.py

@@ -0,0 +1,52 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+import asyncio
+from enum import Enum
+from typing import TYPE_CHECKING
+
+from pydantic import Field
+
+from semantic_kernel.agents.strategies.termination.termination_strategy import TerminationStrategy
+from semantic_kernel.contents.chat_message_content import ChatMessageContent
+from semantic_kernel.kernel_pydantic import KernelBaseModel
+from semantic_kernel.utils.feature_stage_decorator import experimental
+
+if TYPE_CHECKING:
+    from semantic_kernel.agents.agent import Agent
+
+
+@experimental
+class AggregateTerminationCondition(str, Enum):
+    """The condition for terminating the aggregation process."""
+
+    ALL = "All"
+    ANY = "Any"
+
+
+@experimental
+class AggregatorTerminationStrategy(KernelBaseModel):
+    """A strategy that aggregates multiple termination strategies."""
+
+    strategies: list[TerminationStrategy]
+    condition: AggregateTerminationCondition = Field(default=AggregateTerminationCondition.ALL)
+
+    async def should_terminate_async(
+        self,
+        agent: "Agent",
+        history: list[ChatMessageContent],
+    ) -> bool:
+        """Check if the agent should terminate.
+
+        Args:
+            agent: The agent to check.
+            history: The history of messages in the conversation.
+
+        Returns:
+            True if the agent should terminate, False otherwise
+        """
+        strategy_execution = [strategy.should_terminate(agent, history) for strategy in self.strategies]
+        results = await asyncio.gather(*strategy_execution)
+
+        if self.condition == AggregateTerminationCondition.ALL:
+            return all(results)
+        return any(results)

python/semantic_kernel/agents/strategies/termination/default_termination_strategy.py

@@ -0,0 +1,31 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+from typing import TYPE_CHECKING
+
+from pydantic import Field
+
+from semantic_kernel.agents.strategies.termination.termination_strategy import TerminationStrategy
+from semantic_kernel.utils.feature_stage_decorator import experimental
+
+if TYPE_CHECKING:
+    from semantic_kernel.agents.agent import Agent
+    from semantic_kernel.contents.chat_message_content import ChatMessageContent
+
+
+@experimental
+class DefaultTerminationStrategy(TerminationStrategy):
+    """A default termination strategy that never terminates."""
+
+    maximum_iterations: int = Field(default=5, description="The maximum number of iterations to run the agent.")
+
+    async def should_agent_terminate(self, agent: "Agent", history: list["ChatMessageContent"]) -> bool:
+        """Check if the agent should terminate.
+
+        Args:
+            agent: The agent to check.
+            history: The history of messages in the conversation.
+
+        Returns:
+            Defaults to False for the default strategy
+        """
+        return False

python/semantic_kernel/agents/strategies/termination/kernel_function_termination_strategy.py

@@ -0,0 +1,99 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+import logging
+from collections.abc import Callable
+from inspect import isawaitable
+from typing import TYPE_CHECKING, ClassVar
+
+from pydantic import Field
+
+from semantic_kernel.agents.strategies.termination.termination_strategy import TerminationStrategy
+from semantic_kernel.contents.chat_message_content import ChatMessageContent
+from semantic_kernel.contents.history_reducer.chat_history_reducer import ChatHistoryReducer
+from semantic_kernel.functions.kernel_arguments import KernelArguments
+from semantic_kernel.functions.kernel_function import KernelFunction
+from semantic_kernel.kernel import Kernel
+from semantic_kernel.utils.feature_stage_decorator import experimental
+
+if TYPE_CHECKING:
+    from semantic_kernel.agents import Agent
+
+logger: logging.Logger = logging.getLogger(__name__)
+
+
+@experimental
+class KernelFunctionTerminationStrategy(TerminationStrategy):
+    """A termination strategy that uses a kernel function to determine termination."""
+
+    DEFAULT_AGENT_VARIABLE_NAME: ClassVar[str] = "_agent_"
+    DEFAULT_HISTORY_VARIABLE_NAME: ClassVar[str] = "_history_"
+
+    agent_variable_name: str | None = Field(default=DEFAULT_AGENT_VARIABLE_NAME)
+    history_variable_name: str | None = Field(default=DEFAULT_HISTORY_VARIABLE_NAME)
+    arguments: KernelArguments | None = None
+    function: KernelFunction
+    kernel: Kernel
+    result_parser: Callable[..., bool] = Field(default_factory=lambda: (lambda: True))
+    history_reducer: ChatHistoryReducer | None = None
+
+    async def should_agent_terminate(
+        self,
+        agent: "Agent",
+        history: list[ChatMessageContent],
+    ) -> bool:
+        """Check if the agent should terminate.
+
+        Args:
+            agent: The agent to check.
+            history: The history of messages in the conversation.
+
+        Returns:
+            True if the agent should terminate, False otherwise
+        """
+        if self.history_reducer is not None:
+            self.history_reducer.messages = history
+            reduced_history = await self.history_reducer.reduce()
+            if reduced_history is not None:
+                history = reduced_history.messages
+
+        original_arguments = self.arguments or KernelArguments()
+        execution_settings = original_arguments.execution_settings or {}
+
+        messages = [message.to_dict(role_key="role", content_key="content") for message in history]
+
+        filtered_arguments = {
+            self.agent_variable_name: agent.name or agent.id,
+            self.history_variable_name: messages,
+        }
+
+        extracted_settings = {key: setting.model_dump() for key, setting in execution_settings.items()}
+
+        combined_arguments = {
+            **original_arguments,
+            **extracted_settings,
+            **{k: v for k, v in filtered_arguments.items()},
+        }
+
+        arguments = KernelArguments(
+            **combined_arguments,
+        )
+
+        logger.info(f"should_agent_terminate, function invoking: `{self.function.fully_qualified_name}`")
+
+        result = await self.function.invoke(kernel=self.kernel, arguments=arguments)
+
+        if result is None:
+            logger.info(
+                f"should_agent_terminate, function `{self.function.fully_qualified_name}` invoked with result `None`",
+            )
+            return False
+
+        logger.info(
+            f"should_agent_terminate, function `{self.function.fully_qualified_name}` "
+            f"invoked with result `{result.value if result.value else None}`",
+        )
+
+        result_parsed = self.result_parser(result)
+        if isawaitable(result_parsed):
+            result_parsed = await result_parsed
+        return result_parsed

python/semantic_kernel/agents/strategies/termination/termination_strategy.py

@@ -0,0 +1,57 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+import logging
+from typing import TYPE_CHECKING
+
+from pydantic import Field
+
+from semantic_kernel.agents.agent import Agent
+from semantic_kernel.kernel_pydantic import KernelBaseModel
+from semantic_kernel.utils.feature_stage_decorator import experimental
+
+if TYPE_CHECKING:
+    from semantic_kernel.contents.chat_message_content import ChatMessageContent
+
+logger: logging.Logger = logging.getLogger(__name__)
+
+
+@experimental
+class TerminationStrategy(KernelBaseModel):
+    """A strategy for determining when an agent should terminate."""
+
+    maximum_iterations: int = Field(default=99)
+    automatic_reset: bool = False
+    agents: list[Agent] = Field(default_factory=list)
+
+    async def should_agent_terminate(self, agent: "Agent", history: list["ChatMessageContent"]) -> bool:
+        """Check if the agent should terminate.
+
+        Args:
+            agent: The agent to check.
+            history: The history of messages in the conversation.
+
+        Returns:
+            True if the agent should terminate, False otherwise
+        """
+        raise NotImplementedError("Subclasses should implement this method")
+
+    async def should_terminate(self, agent: "Agent", history: list["ChatMessageContent"]) -> bool:
+        """Check if the agent should terminate.
+
+        Args:
+            agent: The agent to check.
+            history: The history of messages in the conversation.
+
+        Returns:
+            True if the agent should terminate, False otherwise
+        """
+        logger.info(f"Evaluating termination criteria for {agent.id}")
+
+        if self.agents and not any(a.id == agent.id for a in self.agents):
+            logger.info(f"Agent {agent.id} is out of scope")
+            return False
+
+        should_terminate = await self.should_agent_terminate(agent, history)
+
+        logger.info(f"Evaluated criteria for {agent.id}, should terminate: {should_terminate}")
+        return should_terminate