fastworkflow 2.15.6__py3-none-any.whl → 2.15.8__py3-none-any.whl

fastworkflow/workflow_agent.py

@@ -11,17 +11,16 @@ import fastworkflow
 from fastworkflow.utils.logging import logger
 from fastworkflow.utils import dspy_utils
 from fastworkflow.command_metadata_api import CommandMetadataAPI
-from fastworkflow.mcp_server import FastWorkflowMCPServer
+from fastworkflow.utils.react import fastWorkflowReAct
 
 
 class WorkflowAgentSignature(dspy.Signature):
     """
-    Carefully review the user request and conversation_history, then execute the todo list using available tools for building the final answer.
-    All the tasks in the todo list must be completed before returning the final answer.
+    Carefully review the user request, then execute the next steps using available tools for building the final answer.
+    Every user intent must be fully addressed before returning the final answer.
     """
     user_query = dspy.InputField(desc="The natural language user query.")
-    conversation_history: dspy.History = dspy.InputField()
-    final_answer = dspy.OutputField(desc="Comprehensive final answer with supporting evidence to demonstrate that all the tasks in the todo list have been completed.")
+    final_answer = dspy.OutputField(desc="Comprehensive final answer with supporting evidence to demonstrate that every user intent has been fully addressed.")
 
 def _what_can_i_do(chat_session_obj: fastworkflow.ChatSession) -> str:
     """
@@ -34,36 +33,36 @@ def _what_can_i_do(chat_session_obj: fastworkflow.ChatSession) -> str:
         active_context_name=current_workflow.current_command_context_name,
     )
 
-def _clarify_ambiguous_intent(
-        correct_command_name: str,
-        chat_session_obj: fastworkflow.ChatSession) -> str:
-    """
-    Call this tool ONLY in the intent detection error state (ambiguous or misunderstood intent) to provide the exact command name.
-    The intent detection error message will list the command names to pick from.
-    """
-    return _execute_workflow_query(correct_command_name, chat_session_obj = chat_session_obj)
-
-def _provide_missing_or_corrected_parameters(
-        missing_or_corrected_parameter_values: list[str|int|float|bool],
-        chat_session_obj: fastworkflow.ChatSession) -> str:
-    """
-    Call this tool ONLY in the parameter extraction error state to provide missing or corrected parameter values.
-    Missing parameter values may be found in the user query, or information already available, or by aborting and executing a different command (refer to the optional 'available_from' hint for guidance on appropriate commands to use to get the information).
-    If the error message indicates parameter values are improperly formatted, correct using your internal knowledge and command metadata information.
-    """
-    if missing_or_corrected_parameter_values:
-        command = ', '.join(missing_or_corrected_parameter_values)
-    else:
-        return "Provide missing or corrected parameter values or abort"
+# def _clarify_ambiguous_intent(
+#         correct_command_name: str,
+#         chat_session_obj: fastworkflow.ChatSession) -> str:
+#     """
+#     Call this tool ONLY in the intent detection error state (ambiguous or misunderstood intent) to provide the exact command name.
+#     The intent detection error message will list the command names to pick from.
+#     """
+#     return _execute_workflow_query(correct_command_name, chat_session_obj = chat_session_obj)
+
+# def _provide_missing_or_corrected_parameters(
+#         missing_or_corrected_parameter_values: list[str|int|float|bool],
+#         chat_session_obj: fastworkflow.ChatSession) -> str:
+#     """
+#     Call this tool ONLY in the parameter extraction error state to provide missing or corrected parameter values.
+#     Missing parameter values may be found in the user query, or information already available, or by aborting and executing a different command (refer to the optional 'available_from' hint for guidance on appropriate commands to use to get the information).
+#     If the error message indicates parameter values are improperly formatted, correct using your internal knowledge and command metadata information.
+#     """
+#     if missing_or_corrected_parameter_values:
+#         command = ', '.join(missing_or_corrected_parameter_values)
+#     else:
+#         return "Provide missing or corrected parameter values or abort"
     
-    return _execute_workflow_query(command, chat_session_obj = chat_session_obj)
+#   return _execute_workflow_query(command, chat_session_obj = chat_session_obj)
 
-def _abort_current_command_to_exit_parameter_extraction_error_state(
-        chat_session_obj: fastworkflow.ChatSession) -> str:
-    """
-    Call this tool ONLY in the parameter extraction error state when you want to get out of the parameter extraction error state and execute a different command.
-    """
-    return _execute_workflow_query('abort', chat_session_obj = chat_session_obj)
+# def _abort_current_command_to_exit_parameter_extraction_error_state(
+#         chat_session_obj: fastworkflow.ChatSession) -> str:
+#     """
+#     Call this tool ONLY in the parameter extraction error state when you want to get out of the parameter extraction error state and execute a different command.
+#     """
+#     return 
 
 def _intent_misunderstood(
         chat_session_obj: fastworkflow.ChatSession) -> str:
@@ -71,7 +70,7 @@ def _intent_misunderstood(
     Shows the full list of available command names so you can specify the command name you really meant
     Call this tool when your intent is misunderstood (i.e. the wrong command name is executed).
     """
-    return _execute_workflow_query('you misunderstood', chat_session_obj = chat_session_obj)
+    return _what_can_i_do(chat_session_obj = chat_session_obj)
 
 def _execute_workflow_query(command: str, chat_session_obj: fastworkflow.ChatSession) -> str:
     """
@@ -105,21 +104,23 @@ def _execute_workflow_query(command: str, chat_session_obj: fastworkflow.ChatSes
     params_dict = params.model_dump() if params else None
     
     # Extract response text
-    resp_text = ""
+    response_text = ""
     if command_output.command_responses:
-        response_parts = [
+        response_parts = []
+        response_parts.extend(
             cmd_response.response
             for cmd_response in command_output.command_responses
             if cmd_response.response
-        ]
-        resp_text = "\n".join(response_parts)
-    
+        )
+        response_text = "\n".join(response_parts) \
+            if response_parts else "Command executed successfully but produced no output."
+
     chat_session_obj.command_trace_queue.put(fastworkflow.CommandTraceEvent(
         direction=fastworkflow.CommandTraceEventDirection.WORKFLOW_TO_AGENT,
         raw_command=None,
         command_name=name,
         parameters=params_dict,
-        response_text=resp_text or "",
+        response_text=response_text,
         success=bool(command_output.success),
         timestamp_ms=int(time.time() * 1000),
     ))
@@ -129,66 +130,73 @@ def _execute_workflow_query(command: str, chat_session_obj: fastworkflow.ChatSes
         "command" if command_output.success else "failing command": command,
         "command_name": name,
         "parameters": params_dict,
-        "response": resp_text if command_output.success else ""
+        "response": response_text if command_output.success else ""
     }
     with open("action.json", "a", encoding="utf-8") as f:
         f.write(json.dumps(record, ensure_ascii=False) + "\n")
 
-    # Format output - extract text from command response
-    if command_output.command_responses:
-        response_parts = []
-        response_parts.extend(
-            cmd_response.response
-            for cmd_response in command_output.command_responses
-            if cmd_response.response
-        )
-        return "\n".join(response_parts) if response_parts else "Command executed successfully."
-
-    return "Command executed but produced no output."
-
-def _missing_information_guidance_tool(
-        how_to_find_request: str, 
-        chat_session_obj: fastworkflow.ChatSession) -> str:
-    """
-    Request guidance on finding missing information. 
-    The how_to_find_request must be plain text without any formatting.
-    """
-    lm = dspy_utils.get_lm("LLM_AGENT", "LITELLM_API_KEY_AGENT")
-    with dspy.context(lm=lm):
-        guidance_func = dspy.ChainOfThought(
-            "command_info, missing_information_guidance_request -> guidance: str")
-        prediction = guidance_func(
-            command_info=_what_can_i_do(chat_session_obj), 
-            missing_information_guidance_request=how_to_find_request)
-        return prediction.guidance
+    if 'PARAMETER EXTRACTION ERROR' in response_text or 'The command is ambiguous' in response_text:
+        abort_confirmation = _execute_workflow_query('abort', chat_session_obj = chat_session_obj)
+        return f'{response_text}\n{abort_confirmation}'
+
+    return response_text
+
+# def _missing_information_guidance_tool(
+#         how_to_find_request: str, 
+#         chat_session_obj: fastworkflow.ChatSession) -> str:
+#     """
+#     Request guidance on finding missing information. 
+#     The how_to_find_request must be plain text without any formatting.
+#     """
+#     class MissingInfoGuidanceSignature(dspy.Signature):
+#         """
+#         Carefully review the command info 'available_from' hints to see if the missing information can be found by executing a different command.
+#         You may have to walk the graph of commands based on the 'available_from' hints to find the most appropriate command
+#         Note that using the wrong command name can produce missing information errors. The requestor should double-check that the command name is correct. 
+#         """
+#         command_info: str = dspy.InputField()
+#         missing_information_guidance_request: str = dspy.InputField()
+#         guidance: str = dspy.OutputField()
+
+
+#     lm = dspy_utils.get_lm("LLM_AGENT", "LITELLM_API_KEY_AGENT")
+#     with dspy.context(lm=lm):
+#         guidance_func = dspy.ChainOfThought(MissingInfoGuidanceSignature)
+#         prediction = guidance_func(
+#             command_info=_what_can_i_do(chat_session_obj), 
+#             missing_information_guidance_request=how_to_find_request)
+#         return prediction.guidance
 
 def _ask_user_tool(clarification_request: str, chat_session_obj: fastworkflow.ChatSession) -> str:
     """
-    As a last resort, request clarification for missing information (only after using the missing_information_guidance_tool) or error correction from the human user. 
+    If the missing_information_guidance_tool does not help and only as the last resort, request clarification for missing information from the human user. 
     The clarification_request must be plain text without any formatting.
+    Note that using the wrong command name can produce missing information errors. Double-check with the missing_information_guidance_tool to verify that the correct command name is being used 
     """
     command_output = fastworkflow.CommandOutput(
         command_responses=[fastworkflow.CommandResponse(response=clarification_request)]
     )
+
     chat_session_obj.command_output_queue.put(command_output)
+
     user_query = chat_session_obj.user_message_queue.get()
-    return _think_and_plan(user_query, chat_session_obj)
+    return build_query_with_next_steps(user_query, chat_session_obj, with_agent_inputs_and_trajectory = True)
 
-def initialize_workflow_tool_agent(mcp_server: FastWorkflowMCPServer, max_iters: int = 25):
+def initialize_workflow_tool_agent(chat_session: fastworkflow.ChatSession, max_iters: int = 25):
     """
     Initialize and return a DSPy ReAct agent that exposes individual MCP tools.
     Each tool expects a single query string for its specific tool.
     
     Args:
-        mcp_server: FastWorkflowMCPServer instance
+        chat_session: fastworkflow.ChatSession instance
         max_iters: Maximum iterations for the ReAct agent
         
     Returns:
         DSPy ReAct agent configured with workflow tools
     """
-    chat_session_obj = mcp_server.chat_session
+    chat_session_obj = chat_session
     if not chat_session_obj:
-        return None
+        raise ValueError("chat session cannot be null")
 
     def what_can_i_do() -> str:
         """
@@ -196,36 +204,10 @@ def initialize_workflow_tool_agent(mcp_server: FastWorkflowMCPServer, max_iters:
         """
         return _what_can_i_do(chat_session_obj=chat_session_obj)
 
-    def clarify_ambiguous_intent(
-            correct_command_name: str) -> str:
-        """
-        Call this tool ONLY in the intent detection error state to provide the exact command name.
-        The intent detection error message will list the command names to pick from.
-        """
-        return _clarify_ambiguous_intent(correct_command_name, chat_session_obj = chat_session_obj)
-
-    def provide_missing_or_corrected_parameters(
-            missing_or_corrected_parameter_values: list[str|int|float|bool]) -> str:
-        """
-        Call this tool ONLY in the parameter extraction error state to provide missing or corrected parameter values.
-        Missing parameter values may be found in the user query, or information already available, or by executing a different command (refer to the optional 'available_from' hint for guidance on appropriate commands to use to get the information).
-        If the error message indicates parameter values are improperly formatted, correct using your internal knowledge.
-        """
-        return _provide_missing_or_corrected_parameters(missing_or_corrected_parameter_values, chat_session_obj=chat_session_obj)
-
-    def abort_current_command_to_exit_parameter_extraction_error_state() -> str:
-        """
-        Call this tool ONLY when you need to execute a different command to get missing parameters.
-        DO NOT execute the same failing command over and over. Either provide_missing_or_corrected_parameters or abort 
-        """
-        return _abort_current_command_to_exit_parameter_extraction_error_state(
-            chat_session_obj=chat_session_obj)
-
     def intent_misunderstood() -> str:
         """
         Shows the full list of available command names so you can specify the command name you really meant
         Call this tool when your intent is misunderstood (i.e. the wrong command name is executed).
-        Do not use this tool if its a missing or invalid parameter issue. Use the provide_missing_or_corrected_parameters tool instead
         """
         return _intent_misunderstood(chat_session_obj = chat_session_obj)
 
@@ -249,49 +231,63 @@ def initialize_workflow_tool_agent(mcp_server: FastWorkflowMCPServer, max_iters:
                 # Continue to next attempt
                 logger.warning(f"Attempt {attempt + 1} failed for command '{command}': {str(e)}")
 
-    def missing_information_guidance(how_to_find_request: str) -> str:
-        """
-        Request guidance on finding missing information. 
-        The how_to_find_request must be plain text without any formatting.
-        """
-        return _missing_information_guidance_tool(how_to_find_request, chat_session_obj=chat_session_obj)
+    # def missing_information_guidance(how_to_find_request: str) -> str:
+    #     """
+    #     Request guidance on finding missing information. 
+    #     The how_to_find_request must be plain text without any formatting.
+    #     """
+    #     return _missing_information_guidance_tool(how_to_find_request, chat_session_obj=chat_session_obj)
 
     def ask_user(clarification_request: str) -> str:
         """
-        As a last resort, request clarification for missing information (only after using the missing_information_guidance_tool) or error correction from the human user. 
+        Only as the last resort, request clarification for missing information from the human user. 
         The clarification_request must be plain text without any formatting.
+        Note that using the wrong command name can produce missing information errors. Double-check with the what_can_i_do tool to verify that the correct command name is being used 
         """
         return _ask_user_tool(clarification_request, chat_session_obj=chat_session_obj)
 
     tools = [
         what_can_i_do,
         execute_workflow_query,
-        missing_information_guidance,
-        clarify_ambiguous_intent,
+        # missing_information_guidance,
         intent_misunderstood,
         ask_user,
-        provide_missing_or_corrected_parameters,
-        abort_current_command_to_exit_parameter_extraction_error_state,
     ]
 
-    return dspy.ReAct(
+    return fastWorkflowReAct(
         WorkflowAgentSignature,
         tools=tools,
         max_iters=max_iters,
     )
 
-def _think_and_plan(user_query: str, chat_session_obj: fastworkflow.ChatSession) -> str:
+
+def build_query_with_next_steps(user_query: str, 
+    chat_session_obj: fastworkflow.ChatSession, with_agent_inputs_and_trajectory: bool = False) -> str:
     """
-    Returns a refined plan by breaking down a user_query into simpler tasks based only on available commands and returns a todo list.
+    Generate a todo list.
+    Return a string that combine the user query and todo list
     """
     class TaskPlannerSignature(dspy.Signature):
         """
-        Break down a user_query into simpler tasks based only on available commands and return a todo list.
-        If user_query is simple, return a single todo that is the user_query as-is
+        Carefully review the user_query and generate a next steps sequence based only on available commands.
+        Walk the graph of commands based on the 'available_from' hints to build the most appropriate command sequence
+        Avoid specifying 'ask user' because 9 times out of 10, you can find the information via available commands. 
         """
         user_query: str = dspy.InputField()
         available_commands: list[str] = dspy.InputField()
-        todo_list: list[str] = dspy.OutputField(desc="task descriptions as short sentences")
+        next_steps: list[str] = dspy.OutputField(desc="task descriptions as short sentences")
+
+    class TaskPlannerWithTrajectoryAndAgentInputsSignature(dspy.Signature):
+        """
+        Carefully review agent inputs, agent trajectory and user response and generate a next steps sequence based only on available commands.
+        Walk the graph of commands based on the 'available_from' hints to build the most appropriate command sequence
+        Avoid specifying 'ask user' because 9 times out of 10, you can find the information via available commands. 
+        """
+        agent_inputs: dict = dspy.InputField()
+        agent_trajectory: dict = dspy.InputField()
+        user_response: str = dspy.InputField()
+        available_commands: list[str] = dspy.InputField()
+        next_steps: list[str] = dspy.OutputField(desc="task descriptions as short sentences")
 
     current_workflow = chat_session_obj.get_active_workflow()
     available_commands = CommandMetadataAPI.get_command_display_text(
@@ -302,10 +298,27 @@ def _think_and_plan(user_query: str, chat_session_obj: fastworkflow.ChatSession)
 
     planner_lm = dspy_utils.get_lm("LLM_PLANNER", "LITELLM_API_KEY_PLANNER")
     with dspy.context(lm=planner_lm):
-        task_planner_func = dspy.ChainOfThought(TaskPlannerSignature)
-        prediction = task_planner_func(user_query=user_query, available_commands=available_commands)
-
-        if not prediction.todo_list or (len(prediction.todo_list) == 1 and prediction.todo_list[0] == user_query):
+        if with_agent_inputs_and_trajectory:
+            workflow_tool_agent = chat_session_obj.workflow_tool_agent
+            task_planner_func = dspy.ChainOfThought(TaskPlannerWithTrajectoryAndAgentInputsSignature)
+            prediction = task_planner_func(
+                agent_inputs = workflow_tool_agent.inputs,
+                agent_trajectory = workflow_tool_agent.current_trajectory,
+                user_response = user_query,
+                available_commands=available_commands)
+        else:
+            task_planner_func = dspy.ChainOfThought(TaskPlannerSignature)
+            prediction = task_planner_func(
+                user_query=user_query,
+                available_commands=available_commands)
+
+        if not prediction.next_steps:
             return user_query
 
-        return f"{user_query}\nNext steps:\n{'\n'.join([f'{i + 1}. {task}' for i, task in enumerate(prediction.todo_list)])}"
+        steps_list = '\n'.join([f'{i + 1}. {task}' for i, task in enumerate(prediction.next_steps)])
+        user_query_and_next_steps = f"{user_query}\n\nNext steps:\n{steps_list}"
+        return (
+            f'{available_commands}\n\nUser Query:\n{user_query_and_next_steps}'
+            if with_agent_inputs_and_trajectory else
+            user_query_and_next_steps
+        )

{fastworkflow-2.15.6.dist-info → fastworkflow-2.15.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastworkflow
-Version: 2.15.6
+Version: 2.15.8
 Summary: A framework for rapidly building large-scale, deterministic, interactive workflows with a fault-tolerant, conversational UX
 License: Apache-2.0
 Keywords: fastworkflow,ai,workflow,llm,openai
@@ -209,7 +209,7 @@ You can get a free API key from [Mistral AI](https://mistral.ai) - the example i
 Train the intent-detection models for the workflow:
 
 ```sh
-fastworkflow examples train hello_world
+fastworkflow train ./examples/hello_world ./examples/fastworkflow.env ./examples/fastworkflow.passwords.env
 ```
 
 This step builds the NLP models that help the workflow understand user commands.
@@ -219,7 +219,7 @@ This step builds the NLP models that help the workflow understand user commands.
 Once training is complete, run the interactive assistant:
 
 ```sh
-fastworkflow examples run hello_world
+fastworkflow run ./examples/hello_world ./examples/fastworkflow.env ./examples/fastworkflow.passwords.env
 ```
 
 You will be greeted with a `User >` prompt. Try it out by asking "what can you do?" or "add 49 + 51"!
@@ -240,12 +240,6 @@ fastworkflow examples list
 
 # Fetch an example to your local directory
 fastworkflow examples fetch <example_name>
-
-# Train an example workflow
-fastworkflow examples train <example_name>
-
-# Run an example workflow
-fastworkflow examples run <example_name>
 ```
 
 ### Workflow Operations
@@ -261,11 +255,8 @@ fastworkflow train <workflow_dir> <env_file> <passwords_file>
 fastworkflow run <workflow_dir> <env_file> <passwords_file>
 ```
 
-To run a workflow in agentic mode, add the `--run_as_agent` flag:
-
-```sh
-fastworkflow run <workflow_dir> <env_file> <passwords_file> --run_as_agent
-```
+> [!tip]
+> **Deterministic execution:** Prefix a natural language command with `/` to execute it deterministically (non‑agentic) during an interactive run.
 
 Each command has additional options that can be viewed with the `--help` flag:
 

{fastworkflow-2.15.6.dist-info → fastworkflow-2.15.8.dist-info}/RECORD

@@ -4,13 +4,13 @@ fastworkflow/_commands/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSu
 fastworkflow/_workflows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fastworkflow/_workflows/command_metadata_extraction/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fastworkflow/_workflows/command_metadata_extraction/_commands/ErrorCorrection/abort.py,sha256=C5H_sOOC1KBaW888QarWnWffMoV7VnZ03q4GMqmitSE,1388
-fastworkflow/_workflows/command_metadata_extraction/_commands/ErrorCorrection/you_misunderstood.py,sha256=Sp_H_ybS5-UM8ActdIrANInIsgQ1uA3pAZnznF8ubvk,2511
+fastworkflow/_workflows/command_metadata_extraction/_commands/ErrorCorrection/you_misunderstood.py,sha256=VHfhwlqc1ceG9P_wL8Fl7dpJA2UlcSrcXhz7zZU9NpA,2517
 fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/go_up.py,sha256=K526OAf5ks95SwqVdRNVxLM_AWDfA1qXbkNYq0dANwg,1889
 fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/reset_context.py,sha256=xvInu6uDw0YRUHVXNyTZphSr75f8QiQgFwDtv7SlE9o,1346
 fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/what_can_i_do.py,sha256=Fw8tsk3wyCujf8nBfUgPDxnTP9c2IE513FzqAWGm8pU,6216
 fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/what_is_current_context.py,sha256=S5RQLr62Q2MnKU85nw4IW_ueAK_FXvhcY9gXajFxujg,1464
 fastworkflow/_workflows/command_metadata_extraction/_commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fastworkflow/_workflows/command_metadata_extraction/_commands/wildcard.py,sha256=HgMHoyyCDB0Jh65lgygDDs6M_86-IKMX1dmVAzrMAfE,29900
+fastworkflow/_workflows/command_metadata_extraction/_commands/wildcard.py,sha256=0VDWnDUAoMwsfH7WEI1e9UWJz_rkVGYH8KqTv9Gwea8,33307
 fastworkflow/_workflows/command_metadata_extraction/command_context_model.json,sha256=zGWBweQSmFf7WsfR_F2DE7AJ8S8-q7F9ZbvyccysJJI,117
 fastworkflow/build/__main__.py,sha256=NtedkZfM56qoEJ5vQECSURbE8AMTfwHN3tAZyZoWabk,15905
 fastworkflow/build/ast_class_extractor.py,sha256=F9OG4stkp7w3kadKqxMm8h3ZDSp_zg6mwcrKMl_XqdI,13527
@@ -33,8 +33,8 @@ fastworkflow/build/navigator_stub_generator.py,sha256=_DSvHC6r1xWQiFHtUgPhI51nQf
 fastworkflow/build/pydantic_model_generator.py,sha256=oNyoANyUWBpHG-fE3tGL911RNvDzQXjxAm0ssvuXUH4,1854
 fastworkflow/build/utterance_generator.py,sha256=UrtkF0wyAZ1hiFitHX0g8w7Wh-D0leLCrP1aUACSfHo,299
 fastworkflow/cache_matching.py,sha256=OoB--1tO6-O4BKCuCrUbB0CkUr76J62K4VAf6MShi-w,7984
-fastworkflow/chat_session.py,sha256=rdW26lnBjBSmeb3q-JDeihdw-kJEv8HLIXyxhTavGmU,27992
-fastworkflow/cli.py,sha256=RB78V78NAZsZtNqF4_kk-TnEKCOy-cFLF6wSwz8aP14,26345
+fastworkflow/chat_session.py,sha256=MVHSoygLIW4Gh3BRfDYSxmh5RMuBxc96c8E9QRW6ZyU,27563
+fastworkflow/cli.py,sha256=li9OFT05sxqz4BZJc9byKAeTmomjLfsWMVuy0OiRGSs,18953
 fastworkflow/command_context_model.py,sha256=nWxLP3TR7WJr3yWCedqcdFOxo_kwae_mS3VRN2cOmK8,13437
 fastworkflow/command_directory.py,sha256=aJ6UQCwevfF11KbcQB2Qz6mQ7Kj91pZtvHmQY6JFnao,29030
 fastworkflow/command_executor.py,sha256=IEcuHEqrqc6I-Hpv451VIHw6z64zkO4o51MpXUFnPGo,7936
@@ -48,7 +48,7 @@ fastworkflow/examples/extended_workflow_example/_commands/generate_report.py,sha
 fastworkflow/examples/extended_workflow_example/_commands/startup.py,sha256=V5Q29148SvXw6i3i0pKTuNWsv2xnkUMsHHuzt1ndxro,1028
 fastworkflow/examples/extended_workflow_example/simple_workflow_template.json,sha256=A-dAl5iD9ehdMGGn05O2Kjwq6ZetqQjAGzlM1st0K9U,1237
 fastworkflow/examples/extended_workflow_example/workflow_inheritance_model.json,sha256=TBk272pqfyRKzm4T-I6_nGfbcdmEzjwon7kFPWtgyhw,81
-fastworkflow/examples/fastworkflow.env,sha256=AtHxE3hf69DDIA8o27cOeV_0iKuMTpJCHf-CY_gzPzQ,629
+fastworkflow/examples/fastworkflow.env,sha256=FNx41woSsG7ljcwI6H6Y3RCMw6mXiImcq8QMnqeqSao,623
 fastworkflow/examples/fastworkflow.passwords.env,sha256=CJemqCpj8HeSznTFUfCSc6I5r8noXuRWKfkrHaslD7E,424
 fastworkflow/examples/hello_world/_commands/README.md,sha256=pYOTGqVx41ZIuNc6hPTEJzNcMQ2Vwx3PN74ifSlayvU,1297
 fastworkflow/examples/hello_world/_commands/add_two_numbers.py,sha256=0lFGK1llT6u6fByvzCDPdegjY6gWcerM2cvxVSo7lIw,2232
@@ -84,7 +84,7 @@ fastworkflow/examples/messaging_app_4/context_hierarchy_model.json,sha256=p1PkLF
 fastworkflow/examples/messaging_app_4/startup_action.json,sha256=HhS0ApuK1wZmX2M0pVusCkgrV0IU7BwvkfEOpRfN95A,84
 fastworkflow/examples/retail_workflow/_commands/calculate.py,sha256=uj-Yg0RSiSPkK7Y0AZN1fgDdL0GWIw33g9ARAPGFFVU,2285
 fastworkflow/examples/retail_workflow/_commands/cancel_pending_order.py,sha256=npU7sERB915WJyqjuku6L63sxvXtrWGkjoTrU0nNhEU,4466
-fastworkflow/examples/retail_workflow/_commands/exchange_delivered_order_items.py,sha256=5Pl8eTa2fVd183RiBHczDx3GbPeP0A92uKkfSUfiddg,4107
+fastworkflow/examples/retail_workflow/_commands/exchange_delivered_order_items.py,sha256=6g04D3eHUQdIBu3wqPbhHMjJUK_91uHxaZrlDggnFS0,5349
 fastworkflow/examples/retail_workflow/_commands/find_user_id_by_email.py,sha256=EhI1bNcmWETGllyb5Z91v0mRm8Ex4eQ44IQHZ244Syc,2793
 fastworkflow/examples/retail_workflow/_commands/find_user_id_by_name_zip.py,sha256=lA9UfEkBNjCXozM4fALSZZuS0DgO3W1qQ2cg0dv1XUA,3340
 fastworkflow/examples/retail_workflow/_commands/get_order_details.py,sha256=X5tcMfx0lBm5vot7Ssn8Uzg0UaTPJU7GTn0C8fGnGxM,3584
@@ -92,11 +92,11 @@ fastworkflow/examples/retail_workflow/_commands/get_product_details.py,sha256=Qf
 fastworkflow/examples/retail_workflow/_commands/get_user_details.py,sha256=zk_QYvoj-DYP4muq0p9uDF_puCKPwy9OZrYhyM6grnI,3091
 fastworkflow/examples/retail_workflow/_commands/list_all_product_types.py,sha256=qnxbHU6PwWiV0E9jO6jYOIs1w5RCrTYQYqYyip14VzI,2529
 fastworkflow/examples/retail_workflow/_commands/modify_pending_order_address.py,sha256=As6TZ2uPicrylJCULN53maHTUj4Sq-XN4C2sF653EDk,3826
-fastworkflow/examples/retail_workflow/_commands/modify_pending_order_items.py,sha256=53Oao7c9uLRqpgzVMzJZW9KOmSUQ-IBDWyCdbH_4AtY,4135
+fastworkflow/examples/retail_workflow/_commands/modify_pending_order_items.py,sha256=t4UbYlgAADyzrE37PDcjZPd7UVqqlYE906d07zdMbKs,5346
 fastworkflow/examples/retail_workflow/_commands/modify_pending_order_payment.py,sha256=zw8mhNkT6HoSPk2ADVROyGIIPpXsT3BhB5YrRnkCtmQ,3356
 fastworkflow/examples/retail_workflow/_commands/modify_user_address.py,sha256=2Zxgbge6wDufWEvk5D7PgOkYb3bayXGH_d0Kr0AFRsw,3864
-fastworkflow/examples/retail_workflow/_commands/return_delivered_order_items.py,sha256=CzWYCi8xyJV1-2R7zVPaUxX8jwej8dTer62vT7jaINM,3819
-fastworkflow/examples/retail_workflow/_commands/transfer_to_human_agents.py,sha256=H49f81dYXVN145aeA4HCeZ4VcdrkkBofeejeVu3TWFo,2908
+fastworkflow/examples/retail_workflow/_commands/return_delivered_order_items.py,sha256=xMKn1pO91BAjYURo5lf2GjpoOm1iQxsxidq69svVRQk,4222
+fastworkflow/examples/retail_workflow/_commands/transfer_to_human_agents.py,sha256=09YXFSeeTN2-bNh_CzHyUN-XhYAbXOe403tjP2zo3KI,2924
 fastworkflow/examples/retail_workflow/context_inheritance_model.json,sha256=jrlby8FUUwkx4V_EGMix_pkQlWcUCVUgmeoapZaZnt4,3
 fastworkflow/examples/retail_workflow/retail_data/__init__.py,sha256=HW8jqarRRTRtNBMp8jqQBTanFTQQC_uShqY_PiGrVtI,629
 fastworkflow/examples/retail_workflow/retail_data/orders.json,sha256=JZihJYbSjy1r0WvIb0yAACm2rxjgq7XEde9chpwRztE,1810945
@@ -142,7 +142,7 @@ fastworkflow/mcp_server.py,sha256=f6vqHiG-cuMpeoeRY-mvsFxApmQ28cAJFfMtqoJYy5k,88
 fastworkflow/model_pipeline_training.py,sha256=P_9wrYSfJVSYCTu8VEPkgXJ16eH58LLCK4rCRbRFAVg,46740
 fastworkflow/refine/__main__.py,sha256=bDLpPNMcdp8U4EFnMdjxx1sPDQCZuEJoBURr2KebTng,3398
 fastworkflow/run/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fastworkflow/run/__main__.py,sha256=a01u5voGUyVyh6ko_sjEPgSoupYw-t5PHE9UHYEnsEk,12237
+fastworkflow/run/__main__.py,sha256=e3gTjcQwYuEz12LZIdL5w48aMRJ-42MdlyapINj7XWk,12430
 fastworkflow/run_agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fastworkflow/run_agent/__main__.py,sha256=japXWziVDHdLl7Hk-jzwcYkImVY4j4k9SodMhiRK3ow,11986
 fastworkflow/run_agent/agent_module.py,sha256=XbOfX2K2CwmIRT45YtoROCN4en9Ud8gMQh2kGEhqw_A,8012
@@ -163,13 +163,14 @@ fastworkflow/utils/logging.py,sha256=2SA-04fg7Lx_vGf980tfCOGDQxBvU9X6Vbhv47rbdaw
 fastworkflow/utils/parameterize_func_decorator.py,sha256=V6YJnishWRCdwiBQW6P17hmGGrga0Empk-AN5Gm7iMk,633
 fastworkflow/utils/pydantic_model_2_dspy_signature_class.py,sha256=w1pvl8rJq48ulFwaAtBgfXYn_SBIDBgq1aLMUg1zJn8,12875
 fastworkflow/utils/python_utils.py,sha256=OzSf-bGve1401SHM3QXXFauBOBrlGQzPNgvvGJPavX0,8200
-fastworkflow/utils/signatures.py,sha256=3B3EafS5b76L4hOwDyABKMuY_bfEwmCYdK6T5DxWM1w,20968
+fastworkflow/utils/react.py,sha256=HubwmM4H9UzLaLaeIkJseKCNMjyrOXvMZz-8sw4ycCE,11224
+fastworkflow/utils/signatures.py,sha256=pOQtvp5qXmA-ETD4xpax5Kj8abkRVbznywyCwanVpxY,20938
 fastworkflow/utils/startup_progress.py,sha256=9icSdnpFAxzIq0sUliGpNaH0Efvrt5lDtGfURV5BD98,3539
 fastworkflow/workflow.py,sha256=F7kGoNQbAMwy71zT1V_KF8PbRTCY4Dz-16Zv4ApK8m8,18939
-fastworkflow/workflow_agent.py,sha256=usSLXUJouVHQOBR2GWMGlb_uTYf9SL_WKav6nEoAxP8,15385
+fastworkflow/workflow_agent.py,sha256=iUcaE1fKLTiRNyDaochPpRHdijCiQBYaCWR8DdslO9Y,16028
 fastworkflow/workflow_inheritance_model.py,sha256=Pp-qSrQISgPfPjJVUfW84pc7HLmL2evuq0UVIYR51K0,7974
-fastworkflow-2.15.6.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-fastworkflow-2.15.6.dist-info/METADATA,sha256=nwvStKcn0GeGkbwRfZLyX4w4gZs5tnkYMSXWxvD925o,29867
-fastworkflow-2.15.6.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-fastworkflow-2.15.6.dist-info/entry_points.txt,sha256=m8HqoPzCyaZLAx-V5X8MJgw3Lx3GiPDlxNEZ7K-Gb-U,54
-fastworkflow-2.15.6.dist-info/RECORD,,
+fastworkflow-2.15.8.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+fastworkflow-2.15.8.dist-info/METADATA,sha256=e_tIGgR1TqfZGWWtZXMWfs6AFpFssNnrCai2pvBE54o,29869
+fastworkflow-2.15.8.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+fastworkflow-2.15.8.dist-info/entry_points.txt,sha256=m8HqoPzCyaZLAx-V5X8MJgw3Lx3GiPDlxNEZ7K-Gb-U,54
+fastworkflow-2.15.8.dist-info/RECORD,,