Python: Adding support for nested workflows (#460)

* Adding design documents and data flow descriptions for sub-workflows

* Updating docs.

* Sub-workflow implementation #1. Stuck because of singleton RequestInfoExecutor, going to make a change to remove that restrivtion.

* Removed the singleton restriction on RequestInfoExecutor so enable sub-workflows.

* Scenarios seem to be working.

* Sample improved.

* going to have intern add generic response wrappers.

* Wrapped responses working.

* Non-hardcoded routing is working.

* Sample showing external approved and not approved.

* Cleaning up.

* Updating some samples and user guide.

* Removing old design doc.

* Cleaning up.

* Adding python-package-setup.md back.

* Update python/packages/workflow/agent_framework_workflow/_executor.py

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

* Update python/packages/workflow/agent_framework_workflow/_validation.py

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

* Removing prints.

* Fixing lint and type issues.

* Fixing lint and type issues.

* Update python/packages/workflow/agent_framework_workflow/_executor.py

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

* Adding type hints to intercepts decorator.

* Removing unused files.

* Fixing issue with sample 5 groupchat with hil.

* Removing redundent samples.

* Updates to ensure no conflicting request interceptors and to support a subflow with multiple requests in a single super step.

* Fixing pypi errors.

* clean up samples

* update samples to make it more clear

* warning for unhandled request info from sub workflow

* add logger info

---------

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

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

@@ -35,6 +35,11 @@ _IMPORTS = [
     "WorkflowCheckpoint",
     "Case",
     "Default",
+    "RequestResponse",
+    "SubWorkflowRequestInfo",
+    "SubWorkflowResponse",
+    "WorkflowExecutor",
+    "intercepts_request",
 ]
 
 

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

@@ -18,17 +18,22 @@ from agent_framework_workflow import (
     RequestInfoEvent,
     RequestInfoExecutor,
     RequestInfoMessage,
+    RequestResponse,
+    SubWorkflowRequestInfo,
+    SubWorkflowResponse,
     Workflow,
     WorkflowBuilder,
     WorkflowCheckpoint,
     WorkflowCompletedEvent,
     WorkflowContext,
     WorkflowEvent,
+    WorkflowExecutor,
     WorkflowRunResult,
     WorkflowStartedEvent,
     WorkflowViz,
     __version__,
     handler,
+    intercepts_request,
 )
 
 __all__ = [
@@ -49,15 +54,20 @@ __all__ = [
     "RequestInfoEvent",
     "RequestInfoExecutor",
     "RequestInfoMessage",
+    "RequestResponse",
+    "SubWorkflowRequestInfo",
+    "SubWorkflowResponse",
     "Workflow",
     "WorkflowBuilder",
     "WorkflowCheckpoint",
     "WorkflowCompletedEvent",
     "WorkflowContext",
     "WorkflowEvent",
+    "WorkflowExecutor",
     "WorkflowRunResult",
     "WorkflowStartedEvent",
     "WorkflowViz",
     "__version__",
     "handler",
+    "intercepts_request",
 ]