fastworkflow 2.15.4__py3-none-any.whl → 2.15.5__py3-none-any.whl

fastworkflow/__init__.py

@@ -1,6 +1,8 @@
 import contextlib
+from dataclasses import dataclass
 from enum import Enum
 import os
+import time
 from typing import Any, Optional, Union
 
 from pydantic import BaseModel
@@ -47,6 +49,20 @@ class MCPToolResult(BaseModel):
     content: list[MCPContent]
     isError: bool = False
 
+class CommandTraceEventDirection(str, Enum):
+    AGENT_TO_WORKFLOW = "agent_to_workflow"
+    WORKFLOW_TO_AGENT = "workflow_to_agent"
+
+@dataclass
+class CommandTraceEvent:
+    direction: CommandTraceEventDirection
+    raw_command: str | None               # for AGENT_TO_WORKFLOW
+    command_name: str | None              # for WORKFLOW_TO_AGENT
+    parameters: dict | str | None
+    response_text: str | None
+    success: bool | None
+    timestamp_ms: int
+
 class CommandOutput(BaseModel):
     command_responses: list[CommandResponse]
     workflow_name: str = ""

fastworkflow/chat_session.py

@@ -119,6 +119,7 @@ class ChatSession:
         # Create queues for user messages and command outputs
         self._user_message_queue = Queue()
         self._command_output_queue = Queue()
+        self._command_trace_queue = Queue()
         self._status = SessionStatus.STOPPED
         self._chat_worker = None
 
@@ -290,6 +291,10 @@ class ChatSession:
     def command_output_queue(self) -> Queue:
         return self._command_output_queue
 
+    @property
+    def command_trace_queue(self) -> Queue:
+        return self._command_trace_queue
+
     @property
     def workflow_is_complete(self) -> bool:
         workflow = ChatSession.get_active_workflow()

fastworkflow/command_executor.py

@@ -45,18 +45,7 @@ class CommandExecutor(CommandExecutorInterface):
                 command = command)
         )
 
-        import json
-
         if command_output.command_handled or not command_output.success:           
-            # Append executed action to action.json for external consumers
-            record = {
-                "command" if command_output.success else "failing command": command,
-                "command_name": command_output.command_name, 
-                "parameters": command_output.command_parameters.model_dump() if command_output.command_parameters else None,
-                "response": command_output.command_responses[0].response if command_output.success else ''}
-            with open("action.json", "a", encoding="utf-8") as f:
-                f.write(json.dumps(record, ensure_ascii=False) + "\n")
-
             return command_output
 
         command_name = command_output.command_responses[0].artifacts["command_name"]
@@ -93,16 +82,7 @@ class CommandExecutor(CommandExecutorInterface):
         command_output.workflow_name = workflow_name
         command_output.context = context
         command_output.command_name = command_name
-        command_output.command_parameters = str(input_obj) if input_obj else ''
-
-        # Append executed action to action.json for external consumers
-        record = {
-            "command": command, 
-            "command_name": command_name, 
-            "parameters": input_obj.model_dump() if input_obj else None,
-            "response": command_output.command_responses[0].response}
-        with open("action.json", "a", encoding="utf-8") as f:
-            f.write(json.dumps(record, ensure_ascii=False) + "\n")
+        command_output.command_parameters = input_obj or None
 
         return command_output
 

fastworkflow/run/__main__.py

@@ -219,6 +219,29 @@ def run_main(args):
         with console.status("[bold cyan]Processing command...[/bold cyan]", spinner="dots") as status:
             counter = 0
             while wait_thread.is_alive():
+                # Check for agent traces if in agent mode
+                if args.run_as_agent:
+                    while True:
+                        try:
+                            evt = fastworkflow.chat_session.command_trace_queue.get_nowait()
+                        except queue.Empty:
+                            break
+                        
+                        # Choose styles based on success
+                        info_style = "dim orange3" if (evt.success is False) else "dim yellow"
+                        resp_style = "dim orange3" if (evt.success is False) else "dim green"
+
+                        if evt.direction == fastworkflow.CommandTraceEventDirection.AGENT_TO_WORKFLOW:
+                            console.print(Text("Agent -> Workflow: ", style=info_style), end="")
+                            console.print(Text(str(evt.raw_command or ""), style=info_style))
+                        else:
+                            # command info (dim yellow or dim orange3)
+                            info = f"{evt.command_name or ''}, {evt.parameters}: "
+                            console.print(Text("Workflow -> Agent: ", style=info_style), end="")
+                            console.print(Text(info, style=info_style), end="")
+                            # response (dim green or dim orange3)
+                            console.print(Text(str(evt.response_text or ""), style=resp_style))
+
                 time.sleep(0.5)
                 counter += 1
                 if counter % 2 == 0:  # Update message every second

fastworkflow/workflow_agent.py

@@ -3,6 +3,8 @@ Agent integration module for fastWorkflow.
 Provides workflow tool agent functionality for intelligent tool selection.
 """
 
+import json
+import time
 import dspy
 
 import fastworkflow
@@ -78,18 +80,67 @@ def _execute_workflow_query(command: str, chat_session_obj: fastworkflow.ChatSes
     Commands must be formatted using plain text for command name followed by XML tags enclosing parameter values (if any) as follows: command_name <param1_name>param1_value</param1_name> <param2_name>param2_value</param2_name> ...
     Don't use this tool to respond to a clarification requests in PARAMETER EXTRACTION ERROR state
     """
+    # Emit trace event before execution
+    chat_session_obj.command_trace_queue.put(fastworkflow.CommandTraceEvent(
+        direction=fastworkflow.CommandTraceEventDirection.AGENT_TO_WORKFLOW,
+        raw_command=command,
+        command_name=None,
+        parameters=None,
+        response_text=None,
+        success=None,
+        timestamp_ms=int(time.time() * 1000),
+    ))
+
     # Directly invoke the command without going through queues
     # This allows the agent to synchronously call workflow tools
     from fastworkflow.command_executor import CommandExecutor
     command_output = CommandExecutor.invoke_command(chat_session_obj, command)
 
+    # Emit trace event after execution
+    # Extract command name and parameters from command_output
+    name = command_output.command_name
+    params = command_output.command_parameters
+    
+    # Handle parameter serialization
+    params_dict = params.model_dump() if params else None
+    
+    # Extract response text
+    resp_text = ""
+    if command_output.command_responses:
+        response_parts = [
+            cmd_response.response
+            for cmd_response in command_output.command_responses
+            if cmd_response.response
+        ]
+        resp_text = "\n".join(response_parts)
+    
+    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 "",
+        success=bool(command_output.success),
+        timestamp_ms=int(time.time() * 1000),
+    ))
+
+    # Append executed action to action.json for external consumers (agent mode only)
+    record = {
+        "command" if command_output.success else "failing command": command,
+        "command_name": name,
+        "parameters": params_dict,
+        "response": resp_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 hasattr(command_output, 'command_responses') and command_output.command_responses:
+    if command_output.command_responses:
         response_parts = []
         response_parts.extend(
             cmd_response.response
             for cmd_response in command_output.command_responses
-            if hasattr(cmd_response, 'response') and cmd_response.response
+            if cmd_response.response
         )
         return "\n".join(response_parts) if response_parts else "Command executed successfully."
 

{fastworkflow-2.15.4.dist-info → fastworkflow-2.15.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastworkflow
-Version: 2.15.4
+Version: 2.15.5
 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

{fastworkflow-2.15.4.dist-info → fastworkflow-2.15.5.dist-info}/RECORD

@@ -1,5 +1,5 @@
 fastworkflow/.DS_Store,sha256=CTvh7SVnPHlYsgd1jwLq9digT-k8QV6JS7JgXEw0OVo,8196
-fastworkflow/__init__.py,sha256=FbOtFQsjbYXcMjL800X46LcDayzqmB6RDZL782_hj9w,7102
+fastworkflow/__init__.py,sha256=wrifGmkwLnHs6BupEliX20cDuV7WkQEKjNspunkzBlc,7604
 fastworkflow/_commands/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fastworkflow/_workflows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fastworkflow/_workflows/command_metadata_extraction/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -33,11 +33,11 @@ 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=KfbRrw4fhTANNifgA6oSmZP7nlz9xSo1dOx3x-B7foI,27848
+fastworkflow/chat_session.py,sha256=rdW26lnBjBSmeb3q-JDeihdw-kJEv8HLIXyxhTavGmU,27992
 fastworkflow/cli.py,sha256=RB78V78NAZsZtNqF4_kk-TnEKCOy-cFLF6wSwz8aP14,26345
 fastworkflow/command_context_model.py,sha256=nWxLP3TR7WJr3yWCedqcdFOxo_kwae_mS3VRN2cOmK8,13437
 fastworkflow/command_directory.py,sha256=aJ6UQCwevfF11KbcQB2Qz6mQ7Kj91pZtvHmQY6JFnao,29030
-fastworkflow/command_executor.py,sha256=nlg-vzZI78f-9tcacrOB4_SK4vVhvszsZd6cwfDP9hc,9030
+fastworkflow/command_executor.py,sha256=IEcuHEqrqc6I-Hpv451VIHw6z64zkO4o51MpXUFnPGo,7936
 fastworkflow/command_interfaces.py,sha256=PWIKlcp0G8nmYl0vkrg1o6QzJL0pxXkfrn1joqTa0eU,460
 fastworkflow/command_metadata_api.py,sha256=KtidE3PM9HYfY-nmEXZ8Y4nnaw2qn23p_gvwFVT3F8Y,39770
 fastworkflow/command_routing.py,sha256=R7194pcY0d2VHzmCu9ALacm1UvNuIRIvTn8mLp-EZIM,17219
@@ -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=f03MJeL9gELvxsn276AUl1Hx35sY2diliepCpV8_k38,10801
+fastworkflow/run/__main__.py,sha256=BYK1i0o2zLBlpLbwXwy0FCj7W72KN7h5Tjkc0H9ZyWI,12219
 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
@@ -166,10 +166,10 @@ fastworkflow/utils/python_utils.py,sha256=OzSf-bGve1401SHM3QXXFauBOBrlGQzPNgvvGJ
 fastworkflow/utils/signatures.py,sha256=3B3EafS5b76L4hOwDyABKMuY_bfEwmCYdK6T5DxWM1w,20968
 fastworkflow/utils/startup_progress.py,sha256=9icSdnpFAxzIq0sUliGpNaH0Efvrt5lDtGfURV5BD98,3539
 fastworkflow/workflow.py,sha256=F7kGoNQbAMwy71zT1V_KF8PbRTCY4Dz-16Zv4ApK8m8,18939
-fastworkflow/workflow_agent.py,sha256=ryVP3OVr-o6kEd32c9lCTYjmnJ24M7NgspfOJ9r3Q5k,13653
+fastworkflow/workflow_agent.py,sha256=usSLXUJouVHQOBR2GWMGlb_uTYf9SL_WKav6nEoAxP8,15385
 fastworkflow/workflow_inheritance_model.py,sha256=Pp-qSrQISgPfPjJVUfW84pc7HLmL2evuq0UVIYR51K0,7974
-fastworkflow-2.15.4.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-fastworkflow-2.15.4.dist-info/METADATA,sha256=8ApRYYVYgmvedFe6L2K7YB19xF9kAL8x_lU2Z67pbOE,29867
-fastworkflow-2.15.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-fastworkflow-2.15.4.dist-info/entry_points.txt,sha256=m8HqoPzCyaZLAx-V5X8MJgw3Lx3GiPDlxNEZ7K-Gb-U,54
-fastworkflow-2.15.4.dist-info/RECORD,,
+fastworkflow-2.15.5.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+fastworkflow-2.15.5.dist-info/METADATA,sha256=geBiwc_MYU7xiXrD1JI48e7zZiW2Rxpxw1J5zpFDDHs,29867
+fastworkflow-2.15.5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+fastworkflow-2.15.5.dist-info/entry_points.txt,sha256=m8HqoPzCyaZLAx-V5X8MJgw3Lx3GiPDlxNEZ7K-Gb-U,54
+fastworkflow-2.15.5.dist-info/RECORD,,