[BREAKING] Python: Refactor workflow events to unified discriminated union pattern (#3690)

* Refactor events

* Merge main

* Fixes

* Cleanup

* Update samples and tests

* Remove unused imports

* PR feedback

* Merge main. Add properties for events to help typing

* Formatting

* Cleanup

* use builtins.type to avoid shadowing by WorkflowEvent.type attribute

* Final improvements

Author: moonbox3

python/packages/core/agent_framework/_tools.py

@@ -2135,6 +2135,9 @@ def get_response(
         filtered_kwargs = {k: v for k, v in kwargs.items() if k != "thread"}
         # Make options mutable so we can update conversation_id during function invocation loop
         mutable_options: dict[str, Any] = dict(options) if options else {}
+        # Remove additional_function_arguments from options passed to underlying chat client
+        # It's for tool invocation only and not recognized by chat service APIs
+        mutable_options.pop("additional_function_arguments", None)
 
         if not stream:
 

python/packages/core/agent_framework/_workflows/__init__.py

@@ -31,22 +31,11 @@
 )
 from ._edge_runner import create_edge_runner
 from ._events import (
-    ExecutorCompletedEvent,
-    ExecutorEvent,
-    ExecutorFailedEvent,
-    ExecutorInvokedEvent,
-    RequestInfoEvent,
-    SuperStepCompletedEvent,
-    SuperStepStartedEvent,
     WorkflowErrorDetails,
     WorkflowEvent,
     WorkflowEventSource,
-    WorkflowFailedEvent,
-    WorkflowLifecycleEvent,
-    WorkflowOutputEvent,
+    WorkflowEventType,
     WorkflowRunState,
-    WorkflowStartedEvent,
-    WorkflowStatusEvent,
 )
 from ._exceptions import (
     WorkflowCheckpointException,
@@ -96,10 +85,6 @@
     "EdgeCondition",
     "EdgeDuplicationError",
     "Executor",
-    "ExecutorCompletedEvent",
-    "ExecutorEvent",
-    "ExecutorFailedEvent",
-    "ExecutorInvokedEvent",
     "FanInEdgeGroup",
     "FanOutEdgeGroup",
     "FileCheckpointStorage",
@@ -108,14 +93,11 @@
     "InMemoryCheckpointStorage",
     "InProcRunnerContext",
     "Message",
-    "RequestInfoEvent",
     "Runner",
     "RunnerContext",
     "SingleEdgeGroup",
     "SubWorkflowRequestMessage",
     "SubWorkflowResponseMessage",
-    "SuperStepCompletedEvent",
-    "SuperStepStartedEvent",
     "SwitchCaseEdgeGroup",
     "SwitchCaseEdgeGroupCase",
     "SwitchCaseEdgeGroupDefault",
@@ -132,16 +114,12 @@
     "WorkflowErrorDetails",
     "WorkflowEvent",
     "WorkflowEventSource",
+    "WorkflowEventType",
     "WorkflowException",
     "WorkflowExecutor",
-    "WorkflowFailedEvent",
-    "WorkflowLifecycleEvent",
-    "WorkflowOutputEvent",
     "WorkflowRunResult",
     "WorkflowRunState",
     "WorkflowRunnerException",
-    "WorkflowStartedEvent",
-    "WorkflowStatusEvent",
     "WorkflowValidationError",
     "WorkflowViz",
     "create_edge_runner",