fastworkflow 2.13.5__tar.gz → 2.14.1__tar.gz

{fastworkflow-2.13.5 → fastworkflow-2.14.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastworkflow
-Version: 2.13.5
+Version: 2.14.1
 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
@@ -198,6 +198,7 @@ You'll need to add at least:
 LITELLM_API_KEY_SYNDATA_GEN=your-mistral-api-key
 LITELLM_API_KEY_PARAM_EXTRACTION=your-mistral-api-key
 LITELLM_API_KEY_RESPONSE_GEN=your-mistral-api-key
+LITELLM_API_KEY_PLANNER=your-mistral-api-key
 LITELLM_API_KEY_AGENT=your-mistral-api-key
 ```
 
@@ -260,6 +261,12 @@ 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
+```
+
 Each command has additional options that can be viewed with the `--help` flag:
 
 ```sh
@@ -581,7 +588,8 @@ This single command will generate the `greet.py` command, `get_properties` and `
 | `LLM_SYNDATA_GEN` | LiteLLM model string for synthetic utterance generation | `train` | `mistral/mistral-small-latest` |
 | `LLM_PARAM_EXTRACTION` | LiteLLM model string for parameter extraction | `train`, `run` | `mistral/mistral-small-latest` |
 | `LLM_RESPONSE_GEN` | LiteLLM model string for response generation | `run` | `mistral/mistral-small-latest` |
-| `LLM_AGENT` | LiteLLM model string for the DSPy agent | `run_agent` | `mistral/mistral-small-latest` |
+| `LLM_PLANNER` | LiteLLM model string for the agent's task planner | `run` (agent mode) | `mistral/mistral-small-latest` |
+| `LLM_AGENT` | LiteLLM model string for the DSPy agent | `run` (agent mode) | `mistral/mistral-small-latest` |
 | `NOT_FOUND` | Placeholder value for missing parameters during extraction | Always | `"NOT_FOUND"` |
 | `MISSING_INFORMATION_ERRMSG` | Error message prefix for missing parameters | Always | `"Missing required..."` |
 | `INVALID_INFORMATION_ERRMSG` | Error message prefix for invalid parameters | Always | `"Invalid information..."` |
@@ -593,7 +601,8 @@ This single command will generate the `greet.py` command, `get_properties` and `
 | `LITELLM_API_KEY_SYNDATA_GEN`| API key for the `LLM_SYNDATA_GEN` model | `train` | *required* |
 | `LITELLM_API_KEY_PARAM_EXTRACTION`| API key for the `LLM_PARAM_EXTRACTION` model | `train`, `run` | *required* |
 | `LITELLM_API_KEY_RESPONSE_GEN`| API key for the `LLM_RESPONSE_GEN` model | `run` | *required* |
-| `LITELLM_API_KEY_AGENT`| API key for the `LLM_AGENT` model | `run_agent` | *required* |
+| `LITELLM_API_KEY_PLANNER`| API key for the `LLM_PLANNER` model | `run` (agent mode) | *required* |
+| `LITELLM_API_KEY_AGENT`| API key for the `LLM_AGENT` model | `run` (agent mode) | *required* |
 
 > [!tip]
 > The example workflows are configured to use Mistral's models by default. You can get a free API key from [Mistral AI](https://mistral.ai) that works with the `mistral-small-latest` model.

{fastworkflow-2.13.5 → fastworkflow-2.14.1}/README.md

@@ -165,6 +165,7 @@ You'll need to add at least:
 LITELLM_API_KEY_SYNDATA_GEN=your-mistral-api-key
 LITELLM_API_KEY_PARAM_EXTRACTION=your-mistral-api-key
 LITELLM_API_KEY_RESPONSE_GEN=your-mistral-api-key
+LITELLM_API_KEY_PLANNER=your-mistral-api-key
 LITELLM_API_KEY_AGENT=your-mistral-api-key
 ```
 
@@ -227,6 +228,12 @@ 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
+```
+
 Each command has additional options that can be viewed with the `--help` flag:
 
 ```sh
@@ -548,7 +555,8 @@ This single command will generate the `greet.py` command, `get_properties` and `
 | `LLM_SYNDATA_GEN` | LiteLLM model string for synthetic utterance generation | `train` | `mistral/mistral-small-latest` |
 | `LLM_PARAM_EXTRACTION` | LiteLLM model string for parameter extraction | `train`, `run` | `mistral/mistral-small-latest` |
 | `LLM_RESPONSE_GEN` | LiteLLM model string for response generation | `run` | `mistral/mistral-small-latest` |
-| `LLM_AGENT` | LiteLLM model string for the DSPy agent | `run_agent` | `mistral/mistral-small-latest` |
+| `LLM_PLANNER` | LiteLLM model string for the agent's task planner | `run` (agent mode) | `mistral/mistral-small-latest` |
+| `LLM_AGENT` | LiteLLM model string for the DSPy agent | `run` (agent mode) | `mistral/mistral-small-latest` |
 | `NOT_FOUND` | Placeholder value for missing parameters during extraction | Always | `"NOT_FOUND"` |
 | `MISSING_INFORMATION_ERRMSG` | Error message prefix for missing parameters | Always | `"Missing required..."` |
 | `INVALID_INFORMATION_ERRMSG` | Error message prefix for invalid parameters | Always | `"Invalid information..."` |
@@ -560,7 +568,8 @@ This single command will generate the `greet.py` command, `get_properties` and `
 | `LITELLM_API_KEY_SYNDATA_GEN`| API key for the `LLM_SYNDATA_GEN` model | `train` | *required* |
 | `LITELLM_API_KEY_PARAM_EXTRACTION`| API key for the `LLM_PARAM_EXTRACTION` model | `train`, `run` | *required* |
 | `LITELLM_API_KEY_RESPONSE_GEN`| API key for the `LLM_RESPONSE_GEN` model | `run` | *required* |
-| `LITELLM_API_KEY_AGENT`| API key for the `LLM_AGENT` model | `run_agent` | *required* |
+| `LITELLM_API_KEY_PLANNER`| API key for the `LLM_PLANNER` model | `run` (agent mode) | *required* |
+| `LITELLM_API_KEY_AGENT`| API key for the `LLM_AGENT` model | `run` (agent mode) | *required* |
 
 > [!tip]
 > The example workflows are configured to use Mistral's models by default. You can get a free API key from [Mistral AI](https://mistral.ai) that works with the `mistral-small-latest` model.

{fastworkflow-2.13.5 → fastworkflow-2.14.1}/fastworkflow/_workflows/command_metadata_extraction/_commands/ErrorCorrection/you_misunderstood.py

@@ -41,7 +41,7 @@ class ResponseGenerator:
         fully_qualified_command_names = (
             set(cme_command_names) | 
             set(subject_crd.get_command_names(app_workflow.current_command_context_name))
-        ) - {'wildcard'}
+        )
 
         valid_command_names = [
             fully_qualified_command_name.split('/')[-1] 

{fastworkflow-2.13.5 → fastworkflow-2.14.1}/fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/go_up.py

@@ -6,7 +6,7 @@ from fastworkflow.train.generate_synthetic import generate_diverse_utterances
 
 
 class Signature:  # noqa: D101
-    """Change context to the parent of the current context."""
+    """Change context to the parent of the current context. This could change the commands that are available."""
 
     plain_utterances = [
         "go up",

{fastworkflow-2.13.5 → fastworkflow-2.14.1}/fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/reset_context.py

@@ -5,7 +5,7 @@ from fastworkflow.train.generate_synthetic import generate_diverse_utterances
 
 
 class Signature:  # noqa: D101
-    """Reset the current context to the global context (*)."""
+    """Reset the current context to the global context (*). This could change the commands that are available."""
     plain_utterances = [
         "reset context",
         "clear context",

fastworkflow-2.14.1/fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/what_can_i_do.py

@@ -0,0 +1,158 @@
+from __future__ import annotations
+
+import contextlib
+from pathlib import Path
+from typing import Dict, Any
+from pydantic import BaseModel
+import json
+
+import fastworkflow
+from fastworkflow.train.generate_synthetic import generate_diverse_utterances
+from fastworkflow.command_metadata_api import CommandMetadataAPI
+
+class Signature:
+    """List all the commands available in the current context along with their metadata"""
+    class Output(BaseModel):
+        valid_command_names: list[str]
+
+    # Constants from plain_utterances.json
+    plain_utterances = [
+        "show me all the utterances",
+        "what can you do?",
+        "what are my options?",
+        "what are my choices?",
+        "what are my capabilities?",
+        "what can i do?",
+        "what can i do here?",
+        "what can i use?",
+        "what are my tools?",
+        "now what?",
+        "list commands",
+        "list utterances"
+    ]
+
+    @staticmethod
+    def generate_utterances(workflow: fastworkflow.Workflow, command_name: str) -> list[str]:
+        return [
+            command_name.split('/')[-1].lower().replace('_', ' ')
+        ] + generate_diverse_utterances(Signature.plain_utterances, command_name)
+
+
+class ResponseGenerator:
+    # def _get_enhanced_command_info(self, workflow: fastworkflow.Workflow) -> Dict[str, Any]:
+    #     """
+    #     Get enhanced command information for agent mode.
+    #     Returns structured JSON with context info, command details, etc.
+    #     """
+    #     app_workflow = workflow.context["app_workflow"]
+
+    #     # Get the current context information
+    #     context_info = {
+    #         "name": app_workflow.current_command_context_name,
+    #         "display_name": app_workflow.current_command_context_displayname,
+    #         "description": "",
+    #         "inheritance": [],
+    #         "containment": []
+    #     }
+
+    #     # Try to load context hierarchy information if available
+    #     with contextlib.suppress(Exception):
+    #         inheritance_path = Path(app_workflow.folderpath) / "context_inheritance_model.json"
+    #         if inheritance_path.exists():
+    #             with open(inheritance_path) as f:
+    #                 inheritance_data = json.load(f)
+    #                 context_info["inheritance"] = inheritance_data.get(context_info["name"], [])
+
+    #         containment_path = Path(app_workflow.folderpath) / "context_containment_model.json"
+    #         if containment_path.exists():
+    #             with open(containment_path) as f:
+    #                 containment_data = json.load(f)
+    #                 context_info["containment"] = containment_data.get(context_info["name"], [])
+
+    #     from fastworkflow.command_metadata_api import CommandMetadataAPI
+
+    #     meta = CommandMetadataAPI.get_enhanced_command_info(
+    #         subject_workflow_path=app_workflow.folderpath,
+    #         cme_workflow_path=workflow.folderpath,
+    #         active_context_name=app_workflow.current_command_context_name,
+    #     )
+
+    #     return {
+    #         "context": context_info,
+    #         "commands": meta.get("commands", [])
+    #     }
+    
+    # def _process_command(
+    #     self, workflow: fastworkflow.Workflow
+    # ) -> Signature.Output:
+    #     """
+    #     Provides helpful information about this type of work-item.
+    #     If the workitem_path is not provided, it provides information about the current work-item.
+
+    #     :param input: The input parameters for the function.
+    #     """
+    #     app_workflow = workflow.context["app_workflow"]
+    #     subject_crd = fastworkflow.RoutingRegistry.get_definition(
+    #         app_workflow.folderpath)
+        
+    #     crd = fastworkflow.RoutingRegistry.get_definition(
+    #         workflow.folderpath)
+    #     cme_command_names = crd.get_command_names('IntentDetection')
+
+    #     # ------------------------------------------------------------------
+    #     # Build the union of command names that *should* be visible, then
+    #     # filter out any command that (a) is the special wildcard helper or
+    #     # (b) has no user-facing utterances in *any* command directory.
+    #     # ------------------------------------------------------------------
+
+    #     candidate_commands: set[str] = (
+    #         set(cme_command_names)
+    #         | set(subject_crd.get_command_names(app_workflow.current_command_context_name))
+    #     )
+
+    #     def _has_utterances(fq_cmd: str) -> bool:
+    #         """Return True if *fq_cmd* has at least one utterance definition in
+    #         either the subject workflow or the CME workflow."""
+    #         return (
+    #             subject_crd.command_directory.get_utterance_metadata(fq_cmd) is not None
+    #             or crd.command_directory.get_utterance_metadata(fq_cmd) is not None
+    #         )
+
+    #     visible_commands = [
+    #         fq_cmd for fq_cmd in candidate_commands
+    #         if fq_cmd != "wildcard" and _has_utterances(fq_cmd)
+    #     ]
+
+    #     valid_command_names = [
+    #         cmd.split("/")[-1] for cmd in sorted(visible_commands)
+    #     ]
+
+    #     return Signature.Output(valid_command_names=valid_command_names)
+
+    def __call__(
+        self,
+        workflow: fastworkflow.Workflow,
+        command: str,
+    ) -> fastworkflow.CommandOutput:
+        # Check if we're in agent mode by looking for chat session run_as_agent flag
+        is_agent_mode = False
+        with contextlib.suppress(Exception):
+            if fastworkflow.chat_session:
+                is_agent_mode = fastworkflow.chat_session.run_as_agent
+        
+        app_workflow = workflow.context["app_workflow"]
+        response = CommandMetadataAPI.get_command_display_text(
+            subject_workflow_path=app_workflow.folderpath,
+            cme_workflow_path=workflow.folderpath,
+            active_context_name=app_workflow.current_command_context_name,
+            for_agents=is_agent_mode,
+        )
+
+        return fastworkflow.CommandOutput(
+            workflow_id=workflow.id,
+            command_responses=[
+                fastworkflow.CommandResponse(
+                    response=response,
+                )
+            ]
+        ) 

{fastworkflow-2.13.5 → fastworkflow-2.14.1}/fastworkflow/_workflows/command_metadata_extraction/_commands/wildcard.py

@@ -80,7 +80,7 @@ class CommandNamePrediction:
             valid_command_names = (
                 set(cme_command_names) | 
                 set(app_crd.get_command_names(command_context_name))
-            ) - {'wildcard'}
+            )
 
         command_name_dict = {
             fully_qualified_command_name.split('/')[-1]: fully_qualified_command_name 
@@ -338,7 +338,11 @@ class ParameterExtraction:
 
         stored_params = self._get_stored_parameters(self.cme_workflow)
 
-        input_for_param_extraction = InputForParamExtraction.create(self.app_workflow, self.command_name, self.command)
+        self.command = self.command.replace(self.command_name, "").strip()
+
+        input_for_param_extraction = InputForParamExtraction.create(
+            self.app_workflow, self.command_name, 
+            self.command)
 
         if stored_params:
             _, _, _, stored_missing_fields = self._extract_missing_fields(input_for_param_extraction, self.app_workflow, self.command_name, stored_params)
@@ -372,7 +376,7 @@ 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' if you want to abort the command."
+            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."
             return self.Output(
                 parameters_are_valid=False,