fastworkflow 2.15.7__tar.gz → 2.15.8__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastworkflow
-Version: 2.15.7
+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.7 → 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.7 → fastworkflow-2.15.8}/fastworkflow/cli.py

@@ -12,7 +12,6 @@ import time
 from pathlib import Path
 import importlib.resources
 from rich import print as rprint
-from rich.console import Console
 from rich.live import Live
 from rich.spinner import Spinner
 
@@ -175,72 +174,6 @@ def fetch_example(args):
         traceback.print_exc(file=sys.stderr)
         sys.exit(1)
 
-def train_example(args):
-    # sourcery skip: extract-duplicate-method, extract-method, remove-redundant-fstring, split-or-ifs
-    """Train an existing example workflow."""
-    # Create a spinner for the initial check
-    spinner = Spinner("dots", text="[bold green]Preparing to train example...[/bold green]")
-
-    with Live(spinner, refresh_per_second=10):
-        # Check if example exists in the local examples directory
-        local_examples_dir = Path("./examples")
-        workflow_path = local_examples_dir / args.name
-
-        if workflow_path.is_dir():
-            # Get the appropriate env files for this example workflow
-            env_file_path, passwords_file_path = find_default_env_files(local_examples_dir)
-
-            # Check if the files exist
-            env_file = Path(env_file_path)
-            passwords_file = Path(passwords_file_path)
-
-            # Create args object for train_main
-            train_args = argparse.Namespace(
-                workflow_folderpath=str(workflow_path),
-                env_file_path=str(env_file),
-                passwords_file_path=str(passwords_file)
-            )
-
-    # After the spinner, handle any errors or proceed with training
-    if not workflow_path.is_dir():
-        rprint(f"[bold red]Error:[/bold red] Example '{args.name}' not found in '{local_examples_dir}'.")
-        rprint(f"Use 'fastworkflow examples fetch {args.name}' to fetch the example first.")
-        rprint("Or use 'fastworkflow examples list' to see available examples.")
-        sys.exit(1)
-
-    if not env_file.exists() or not passwords_file.exists():
-        rprint(f"[bold red]Error:[/bold red] Required environment files not found:")
-        if not env_file.exists():
-            rprint(f"  - {env_file} (not found)")
-        if not passwords_file.exists():
-            rprint(f"  - {passwords_file} (not found)")
-        rprint("\nPlease run the following command to fetch the example and its environment files:")
-        rprint(f"  fastworkflow examples fetch {args.name}")
-        rprint("\nAfter fetching, edit the passwords file to add your API keys:")
-        rprint(f"  {local_examples_dir}/fastworkflow.passwords.env")
-        sys.exit(1)
-
-    rprint(f"[bold green]Training example[/bold green] '{args.name}' in '{workflow_path}'...")
-
-    try:
-        # Lazy import train_main only when actually training
-        from .train.__main__ import train_main as _train_main
-        # Call train_main directly instead of using subprocess
-        result = _train_main(train_args)
-
-        if result is None or result == 0:
-            rprint(f"\n✅ Successfully trained example '{args.name}'.")
-            rprint(f"You can now run it with:\nfastworkflow examples run {args.name}")
-        else:
-            rprint(f"\n❌ Training failed.")
-            sys.exit(1)
-
-    except Exception as e:
-        rprint(f"[bold red]An unexpected error occurred during training:[/bold red] {e}")
-        import traceback
-        traceback.print_exc(file=sys.stderr)
-        sys.exit(1)
-
 def find_default_env_files(workflow_path):
     """Find the appropriate default env files based on context.
     
@@ -338,12 +271,6 @@ def add_run_parser(subparsers):
     parser_run.add_argument("--startup_action", help="Optional startup action", default="")
     parser_run.add_argument("--keep_alive", help="Optional keep_alive", default=True)
     parser_run.add_argument("--project_folderpath", help="Optional path to project folder containing application code", default=None)
-    parser_run.add_argument(
-        "--run_as_agent",
-        help="Run in agent mode (uses DSPy for tool selection)",
-        action="store_true",
-        default=False,
-    )
     parser_run.set_defaults(func=lambda args: run_with_defaults(args))
 
 def train_with_defaults(args):  # sourcery skip: extract-duplicate-method
@@ -363,7 +290,7 @@ def train_with_defaults(args):  # sourcery skip: extract-duplicate-method
             example_name = os.path.basename(args.workflow_folderpath)
             print("\nThis appears to be an example workflow. Please run:")
             print(f"  fastworkflow examples fetch {example_name}")
-            print(f"  fastworkflow examples train {example_name}")
+            print(f"  fastworkflow train ./examples/{example_name} ./examples/fastworkflow.env ./examples/fastworkflow.passwords.env")
         else:
             print("\nPlease ensure this file exists with required environment variables.")
             print("You can create a basic .env file in your current directory.")
@@ -376,7 +303,7 @@ def train_with_defaults(args):  # sourcery skip: extract-duplicate-method
             example_name = os.path.basename(args.workflow_folderpath)
             print("\nThis appears to be an example workflow. Please run:")
             print(f"  fastworkflow examples fetch {example_name}")
-            print(f"  fastworkflow examples train {example_name}")
+            print(f"  fastworkflow train ./examples/{example_name} ./examples/fastworkflow.env ./examples/fastworkflow.passwords.env")
         else:
             print("\nPlease ensure this file exists with required API keys.")
             print("You can create a basic passwords.env file in your current directory.")
@@ -403,7 +330,7 @@ def run_with_defaults(args):  # sourcery skip: extract-duplicate-method
             example_name = os.path.basename(args.workflow_path)
             print("\nThis appears to be an example workflow. Please run:")
             print(f"  fastworkflow examples fetch {example_name}")
-            print(f"  fastworkflow examples train {example_name}")
+            print(f"  fastworkflow train ./examples/{example_name} ./examples/fastworkflow.env ./examples/fastworkflow.passwords.env")
         else:
             print("\nPlease ensure this file exists with required environment variables.")
             print("You can create a basic .env file in your current directory.")
@@ -416,7 +343,7 @@ def run_with_defaults(args):  # sourcery skip: extract-duplicate-method
             example_name = os.path.basename(args.workflow_path)
             print("\nThis appears to be an example workflow. Please run:")
             print(f"  fastworkflow examples fetch {example_name}")
-            print(f"  fastworkflow examples train {example_name}")
+            print(f"  fastworkflow train ./examples/{example_name} ./examples/fastworkflow.env ./examples/fastworkflow.passwords.env")
         else:
             print("\nPlease ensure this file exists with required API keys.")
             print("You can create a basic passwords.env file in your current directory.")
@@ -426,86 +353,6 @@ def run_with_defaults(args):  # sourcery skip: extract-duplicate-method
     from .run.__main__ import run_main as _run_main
     return _run_main(args)
 
-def run_example(args):
-    # sourcery skip: extract-duplicate-method, extract-method, remove-redundant-fstring, split-or-ifs
-    """Run an existing example workflow."""
-    # Create a spinner for the initial check
-    spinner = Spinner("dots", text="[bold green]Preparing to run example...[/bold green]")
-
-    with Live(spinner, refresh_per_second=10):
-        # Check if example exists in the local examples directory
-        local_examples_dir = Path("./examples")
-        workflow_path = local_examples_dir / args.name
-
-        if workflow_path.is_dir():
-            # Get the appropriate env files for this example workflow
-            env_file_path, passwords_file_path = find_default_env_files(local_examples_dir)
-
-            # Check if the files exist
-            env_file = Path(env_file_path)
-            passwords_file = Path(passwords_file_path)
-
-            # Check if the example has been trained
-            command_info_dir = workflow_path / "___command_info"
-
-    # After the spinner, handle any errors or proceed with running
-    if not workflow_path.is_dir():
-        rprint(f"[bold red]Error:[/bold red] Example '{args.name}' not found in '{local_examples_dir}'.")
-        rprint(f"Use 'fastworkflow examples fetch {args.name}' to fetch the example first.")
-        rprint("Or use 'fastworkflow examples list' to see available examples.")
-        sys.exit(1)
-
-    if not env_file.exists() or not passwords_file.exists():
-        rprint(f"[bold red]Error:[/bold red] Required environment files not found:")
-        if not env_file.exists():
-            rprint(f"  - {env_file} (not found)")
-        if not passwords_file.exists():
-            rprint(f"  - {passwords_file} (not found)")
-        rprint("\nPlease run the following command to fetch the example and its environment files:")
-        rprint(f"  fastworkflow examples fetch {args.name}")
-        rprint("\nAfter fetching, edit the passwords file to add your API keys:")
-        rprint(f"  {local_examples_dir}/fastworkflow.passwords.env")
-        rprint("\nThen train the example before running it:")
-        rprint(f"  fastworkflow examples train {args.name}")
-        sys.exit(1)
-
-    # Check if the example has been trained
-    if not command_info_dir.exists() or not any(command_info_dir.iterdir()):
-        rprint(f"[bold yellow]Warning:[/bold yellow] Example '{args.name}' does not appear to be trained yet.")
-        rprint(f"Please train the example first with:")
-        rprint(f"  fastworkflow examples train {args.name}")
-        response = input("Do you want to continue anyway? [y/N] ")
-        if response.lower() != 'y':
-            rprint("Operation cancelled.")
-            sys.exit(0)
-
-    rprint(f"[bold green]Running example[/bold green] '{args.name}'...")
-
-    # For interactive applications, we need to use os.execvp to replace the current process
-    # This ensures that stdin/stdout/stderr are properly connected for interactive use
-    cmd = [
-        sys.executable,
-        "-m", "fastworkflow.run",
-        str(workflow_path),
-        str(env_file),
-        str(passwords_file)
-    ]
-
-    # Forward agent mode flag if requested
-    if getattr(args, "run_as_agent", False):
-        cmd.append("--run_as_agent")
-
-    try:
-        rprint(f"[bold green]Starting interactive session...[/bold green]")
-        # Replace the current process with the run command
-        # This ensures that the interactive prompt works correctly
-        os.execvp(sys.executable, cmd)
-    except Exception as e:
-        rprint(f"[bold red]An unexpected error occurred while running the example:[/bold red] {e}")
-        import traceback
-        traceback.print_exc(file=sys.stderr)
-        sys.exit(1)
-
 def main():
     """Main function for the fastworkflow CLI."""
     
@@ -528,22 +375,6 @@ def main():
     parser_fetch.add_argument("--force", action="store_true", help="Force overwrite if example already exists")
     parser_fetch.set_defaults(func=fetch_example)
     
-    # 'examples train' command
-    parser_train_example = examples_subparsers.add_parser("train", help="Train a specific example")
-    parser_train_example.add_argument("name", help="The name of the example to train")
-    parser_train_example.set_defaults(func=train_example)
-    
-    # 'examples run' command
-    parser_run_example = examples_subparsers.add_parser("run", help="Run a specific example")
-    parser_run_example.add_argument("name", help="The name of the example to run")
-    parser_run_example.add_argument(
-        "--run_as_agent",
-        help="Run the example in agent mode (uses DSPy for tool selection)",
-        action="store_true",
-        default=False,
-    )
-    parser_run_example.set_defaults(func=run_example)
-    
     # Add top-level commands
     add_build_parser(subparsers)
     add_refine_parser(subparsers)

{fastworkflow-2.15.7 → fastworkflow-2.15.8}/fastworkflow/examples/fastworkflow.env

@@ -1,7 +1,7 @@
 LLM_SYNDATA_GEN=mistral/mistral-small-latest
 LLM_PARAM_EXTRACTION=mistral/mistral-small-latest
 LLM_RESPONSE_GEN=mistral/mistral-small-latest
-LLM_PLANNER=openrouter/openai/gpt-oss-20b:free
+LLM_PLANNER=mistral/mistral-small-latest
 LLM_AGENT=mistral/mistral-small-latest
 
 SPEEDDICT_FOLDERNAME=___workflow_contexts

{fastworkflow-2.15.7 → fastworkflow-2.15.8}/fastworkflow/run/__main__.py

@@ -139,7 +139,9 @@ def run_main(args):
         raise ValueError("Cannot provide both startup_command and startup_action")
 
     console.print(Panel(f"Running fastWorkflow: [bold]{args.workflow_path}[/bold]", title="[bold green]fastworkflow[/bold green]", border_style="green"))
-    console.print("[bold green]Tips:[/bold green] Type '/exit' to quit the application. Type '/new' to start a new conversation.")
+    console.print(
+        "[bold green]Tips:[/bold green] Type '//exit' to quit the application. Type '//new' to start a new conversation. " 
+        "[bold green]Tips:[/bold green] Prefix natural language commands with a single '/' to execute them in deterministic (non-agentic) mode")
 
     # ------------------------------------------------------------------
     # Startup progress bar ------------------------------------------------
@@ -169,9 +171,9 @@ def run_main(args):
         with open(args.context_file_path, 'r') as file:
             context_dict = json.load(file)
 
-    # Create the chat session with agent mode if specified
-    run_as_agent = args.run_as_agent if hasattr(args, 'run_as_agent') else False
-    fastworkflow.chat_session = fastworkflow.ChatSession(run_as_agent=run_as_agent)
+    # Create the chat session in agent mode always
+    # run_as_agent = args.run_as_agent if hasattr(args, 'run_as_agent') else False
+    fastworkflow.chat_session = fastworkflow.ChatSession(run_as_agent=True)
     
     # Start the workflow within the chat session
     fastworkflow.chat_session.start_workflow(
@@ -194,9 +196,9 @@ def run_main(args):
     while not fastworkflow.chat_session.workflow_is_complete or args.keep_alive:
         with patch_stdout():
             user_command = prompt_session.prompt()
-        if user_command == "/exit":
+        if user_command.startswith("//exit"):
             break
-        if user_command.startswith("/new"):
+        if user_command.startswith("//new"):
             fastworkflow.chat_session.clear_conversation_history()
             console.print("[bold]Agent >[/bold] New conversation started!\n", end="")
             user_command = prompt_session.prompt()
@@ -224,26 +226,25 @@ 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"
+                # Always show agent traces (run mode is always agentic)
+                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(f'[bold]Agent >[/bold] {evt.raw_command}', style=info_style)
-                        else:
-                            # command info (dim yellow or dim orange3)
-                            info = f"[bold]Workflow >[/bold] {evt.command_name or ''}, {evt.parameters}: "
-                            console.print(info, style=info_style, end="")
-                            # response (dim green or dim orange3)
-                            console.print(f'[bold]Workflow >[/bold] {evt.response_text}', style=resp_style)
+                    if evt.direction == fastworkflow.CommandTraceEventDirection.AGENT_TO_WORKFLOW:
+                        console.print(f'[bold]Agent >[/bold] {evt.raw_command}', style=info_style)
+                    else:
+                        # command info (dim yellow or dim orange3)
+                        info = f"[bold]Workflow >[/bold] {evt.command_name or ''}, {evt.parameters}: "
+                        console.print(info, style=info_style, end="")
+                        # response (dim green or dim orange3)
+                        console.print(f'[bold]Workflow >[/bold] {evt.response_text}', style=resp_style)
 
                 time.sleep(0.5)
                 counter += 1
@@ -276,11 +277,6 @@ if __name__ == "__main__":
     parser.add_argument(
         "--project_folderpath", help="Optional path to project folder containing application code", default=None
     )
-    parser.add_argument(
-        "--run_as_agent", 
-        help="Run in agent mode (uses DSPy for tool selection)", 
-        action="store_true",
-        default=False
-    )
+    # run mode is always agentic; deterministic NL execution can be forced by prefixing '/' to a command
     args = parser.parse_args()
     run_main(args)

{fastworkflow-2.15.7 → fastworkflow-2.15.8}/pyproject.toml

@@ -9,7 +9,7 @@ repository = "https://github.com/radiantlogicinc/fastworkflow"
 
 [tool.poetry]
 name = "fastworkflow"
-version = "2.15.7"
+version = "2.15.8"
 description = "A framework for rapidly building large-scale, deterministic, interactive workflows with a fault-tolerant, conversational UX"
 authors = ["Dhar Rawal <drawal@radiantlogic.com>"]
 license = "Apache-2.0"