fastworkflow 2.15.6__tar.gz → 2.15.8__tar.gz

{fastworkflow-2.15.6 → fastworkflow-2.15.8}/PKG-INFO

@@ -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 → fastworkflow-2.15.8}/README.md

@@ -176,7 +176,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.
@@ -186,7 +186,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"!
@@ -207,12 +207,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
@@ -228,11 +222,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 → fastworkflow-2.15.8}/fastworkflow/_workflows/command_metadata_extraction/_commands/ErrorCorrection/you_misunderstood.py

@@ -60,7 +60,7 @@ class ResponseGenerator:
             ])
         )
         response = (
-            "Please enter the correct command from the list below:\n"
+            "Please select the correct command name from the list below:\n"
             f"{response}\n\nor type 'abort' to cancel"
         )
 

{fastworkflow-2.15.6 → fastworkflow-2.15.8}/fastworkflow/_workflows/command_metadata_extraction/_commands/wildcard.py

@@ -4,6 +4,8 @@ import sys
 from typing import Dict, List, Optional, Type, Union
 import json
 import os
+from collections import Counter
+from concurrent.futures import ThreadPoolExecutor, as_completed
 
 from pydantic import BaseModel
 from pydantic_core import PydanticUndefined
@@ -38,6 +40,67 @@ INVALID = fastworkflow.get_env_var("INVALID")
 PARAMETER_EXTRACTION_ERROR_MSG = None
 
 
+# TODO - generation is deterministic. They all return the same answer
+# TODO - Need 'temperature' for intent detection pipeline
+def majority_vote_predictions(command_router, command: str, n_predictions: int = 5) -> list[str]:
+    """
+    Generate N prediction sets in parallel and return the set that wins the majority vote.
+    
+    This function improves prediction reliability by running multiple parallel predictions
+    and selecting the most common result through majority voting. This helps reduce
+    the impact of random variations in model predictions.
+    
+    Args:
+        command_router: The CommandRouter instance to use for predictions
+        command: The input command string
+        n_predictions: Number of parallel predictions to generate (default: 5)
+                      Can be configured via N_PARALLEL_PREDICTIONS environment variable
+        
+    Returns:
+        The prediction set that received the majority vote. Falls back to a single
+        prediction if all parallel predictions fail.
+        
+    Note:
+        Uses ThreadPoolExecutor with max_workers limited to min(n_predictions, 10)
+        to avoid overwhelming the system with too many concurrent threads.
+    """
+    def get_single_prediction():
+        """Helper function to get a single prediction"""
+        return command_router.predict(command)
+    
+    # Generate N predictions in parallel
+    prediction_sets = []
+    with ThreadPoolExecutor(max_workers=min(n_predictions, 10)) as executor:
+        # Submit all prediction tasks
+        futures = [executor.submit(get_single_prediction) for _ in range(n_predictions)]
+        
+        # Collect results as they complete
+        for future in as_completed(futures):
+            try:
+                prediction_set = future.result()
+                prediction_sets.append(prediction_set)
+            except Exception as e:
+                logger.warning(f"Prediction failed: {e}")
+                # Continue with other predictions even if one fails
+    
+    if not prediction_sets:
+        # Fallback to single prediction if all parallel predictions failed
+        logger.warning("All parallel predictions failed, falling back to single prediction")
+        return command_router.predict(command)
+    
+    # Convert lists to tuples so they can be hashed and counted
+    prediction_tuples = [tuple(sorted(pred_set)) for pred_set in prediction_sets]
+    
+    # Count occurrences of each unique prediction set
+    vote_counts = Counter(prediction_tuples)
+    
+    # Get the prediction set with the most votes
+    winning_tuple = vote_counts.most_common(1)[0][0]
+    
+    # Convert back to list and return
+    return list(winning_tuple)
+
+
 class CommandNamePrediction:
     class Output(BaseModel):
         command_name: Optional[str] = None
@@ -140,12 +203,15 @@ class CommandNamePrediction:
                     command_name = cache_result
                 else:
                     predictions=command_router.predict(command)
+                    # predictions = majority_vote_predictions(command_router, command)
 
                     if len(predictions)==1:
                         command_name = predictions[0].split('/')[-1]
                     else:
                         # If confidence is low, treat as ambiguous command (type 1)
-                        error_msg = self._formulate_ambiguous_command_error_message(predictions)
+                        error_msg = self._formulate_ambiguous_command_error_message(
+                            predictions, "run_as_agent" in self.app_workflow.context)
+
                         # Store suggested commands
                         self._store_suggested_commands(self.path, predictions, 1)
                         return CommandNamePrediction.Output(error_msg=error_msg)
@@ -296,7 +362,8 @@ class CommandNamePrediction:
             db.close()
 
     @staticmethod
-    def _formulate_ambiguous_command_error_message(route_choice_list: list[str]) -> str:
+    def _formulate_ambiguous_command_error_message(
+        route_choice_list: list[str], run_as_agent: bool) -> str:
         command_list = (
             "\n".join([
                 f"{route_choice.split('/')[-1].lower()}"
@@ -305,10 +372,14 @@ class CommandNamePrediction:
         )
 
         return (
-            "The command is ambiguous. Please select from these possible options:\n"
-            f"{command_list}\n\n"
-            "or type 'what can i do' to see all commands\n"
-            "or type 'abort' to cancel"
+            "The command is ambiguous. "
+            + (
+                "Choose the correct command name from these possible options and update your command:\n"
+                if run_as_agent
+                else "Please choose a command name from these possible options:\n"
+            )
+            + f"{command_list}\n\nor type 'what can i do' to see all commands\n"
+            + ("or type 'abort' to cancel" if run_as_agent else '')
         )
 
 class ParameterExtraction:
@@ -376,8 +447,11 @@ class ParameterExtraction:
             if params_str := self._format_parameters_for_display(merged_params):
                 error_msg = f"Extracted parameters so far:\n{params_str}\n\n{error_msg}"
 
-            error_msg += "\nEnter 'abort' to get out of this error state and/or execute a different command."
-            error_msg += "\nEnter 'you misunderstood' if the wrong command was executed."
+            if "run_as_agent" not in self.app_workflow.context:
+                error_msg += "\nEnter 'abort' to get out of this error state and/or execute a different command."
+                error_msg += "\nEnter 'you misunderstood' if the wrong command was executed."
+            else:
+                error_msg += "\nCheck your command name if the wrong command was executed."
             return self.Output(
                 parameters_are_valid=False,
                 error_msg=error_msg,
@@ -626,6 +700,7 @@ class ResponseGenerator:
             workflow_context = workflow.context
             if cnp_output.command_name == 'ErrorCorrection/you_misunderstood':
                 workflow_context["NLU_Pipeline_Stage"] = NLUPipelineStage.INTENT_MISUNDERSTANDING_CLARIFICATION
+                workflow_context["command"] = command
             else:
                 workflow.end_command_processing()
             workflow.context = workflow_context
@@ -664,6 +739,7 @@ class ResponseGenerator:
                         workflow_context = workflow.context
                         workflow_context["NLU_Pipeline_Stage"] = \
                             NLUPipelineStage.INTENT_MISUNDERSTANDING_CLARIFICATION
+                        workflow_context["command"] = command
                         workflow.context = workflow_context
 
                         startup_action = Action(
@@ -686,10 +762,9 @@ class ResponseGenerator:
             # move to the parameter extraction stage
             workflow_context = workflow.context
             workflow_context["NLU_Pipeline_Stage"] = NLUPipelineStage.PARAMETER_EXTRACTION
-            workflow_context["command_name"] = cnp_output.command_name
             workflow.context = workflow_context
 
-        command_name = workflow.context["command_name"]
+        command_name = cnp_output.command_name
         extractor = ParameterExtraction(workflow, app_workflow, command_name, command)
         pe_output = extractor.extract()
         if not pe_output.parameters_are_valid: