Python: Workflow run state and structured error events, sample updates, tests (#725)

* Add workflow event types to surface workflow state, status, and failures.

* Address PR feedback

* Updates to use new workflow run state enums

python/packages/main/agent_framework/workflow/__init__.py

@@ -40,6 +40,7 @@ _IMPORTS = [
     "WorkflowAgent",
     "WorkflowViz",
     "FileCheckpointStorage",
+    "ExecutorFailedEvent",
     "InMemoryCheckpointStorage",
     "CheckpointStorage",
     "WorkflowCheckpoint",
@@ -56,6 +57,10 @@ _IMPORTS = [
     "PlanReviewRequest",
     "RequestInfoEvent",
     "StandardMagenticManager",
+    "WorkflowStatusEvent",
+    "WorkflowRunState",
+    "WorkflowErrorDetails",
+    "WorkflowFailedEvent",
     "ConcurrentBuilder",
 ]
 

python/packages/main/agent_framework/workflow/__init__.pyi

@@ -13,6 +13,7 @@ from agent_framework_workflow import (
     Executor,
     ExecutorCompletedEvent,
     ExecutorEvent,
+    ExecutorFailedEvent,
     ExecutorInvokeEvent,
     FileCheckpointStorage,
     FunctionExecutor,
@@ -38,10 +39,14 @@ from agent_framework_workflow import (
     WorkflowCheckpoint,
     WorkflowCompletedEvent,
     WorkflowContext,
+    WorkflowErrorDetails,
     WorkflowEvent,
     WorkflowExecutor,
+    WorkflowFailedEvent,
     WorkflowRunResult,
+    WorkflowRunState,
     WorkflowStartedEvent,
+    WorkflowStatusEvent,
     WorkflowViz,
     __version__,
     executor,
@@ -62,6 +67,7 @@ __all__ = [
     "Executor",
     "ExecutorCompletedEvent",
     "ExecutorEvent",
+    "ExecutorFailedEvent",
     "ExecutorInvokeEvent",
     "FileCheckpointStorage",
     "FunctionExecutor",
@@ -87,10 +93,14 @@ __all__ = [
     "WorkflowCheckpoint",
     "WorkflowCompletedEvent",
     "WorkflowContext",
+    "WorkflowErrorDetails",
     "WorkflowEvent",
     "WorkflowExecutor",
+    "WorkflowFailedEvent",
     "WorkflowRunResult",
+    "WorkflowRunState",
     "WorkflowStartedEvent",
+    "WorkflowStatusEvent",
     "WorkflowViz",
     "__version__",
     "executor",