fastworkflow 2.14.0__tar.gz → 2.14.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastworkflow
-Version: 2.14.0
+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.14.0 → 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.14.0 → fastworkflow-2.14.1}/fastworkflow/command_metadata_api.py

@@ -316,12 +316,18 @@ class CommandMetadataAPI:
                                                 desc_val = str(param.get("description", "") or "").strip()
                                                 name_val = str(param.get("name", "") or "").strip()
                                                 title_val = desc_val or name_val
+                                                type_val = str(param.get("type", "") or "").strip()
                                                 if not title_val:
                                                     # Skip to avoid a bare '-'
                                                     continue
-                                                lines.append(f"{indent_str}  - {title_val}")
+                                                # Render name/description and type on the same line
+                                                if type_val:
+                                                    lines.append(f"{indent_str}  - {title_val}, type: {type_val}")
+                                                else:
+                                                    lines.append(f"{indent_str}  - {title_val}")
                                                 for rk2, rv2 in param.items():
-                                                    if rk2 in {"name", "description"}:
+                                                    # We've already rendered name/description (and type) inline
+                                                    if rk2 in {"name", "description", "type"}:
                                                         continue
                                                     # Render examples inline for readability
                                                     if rk2 == "examples" and isinstance(rv2, list):

{fastworkflow-2.14.0 → fastworkflow-2.14.1}/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_AGENT=bedrock/us.anthropic.claude-3-7-sonnet-20250219-v1:0
+LLM_PLANNER=openrouter/openai/gpt-oss-20b:free
 LLM_AGENT=mistral/mistral-small-latest
 
 SPEEDDICT_FOLDERNAME=___workflow_contexts

{fastworkflow-2.14.0 → fastworkflow-2.14.1}/fastworkflow/examples/fastworkflow.passwords.env

@@ -2,4 +2,5 @@
 LITELLM_API_KEY_SYNDATA_GEN=<API KEY for synthetic data generation model>
 LITELLM_API_KEY_PARAM_EXTRACTION=<API KEY for parameter extraction model>
 LITELLM_API_KEY_RESPONSE_GEN=<API KEY for response generation model>
+LITELLM_API_KEY_PLANNER=<API KEY for the agent's task planner model>
 LITELLM_API_KEY_AGENT=<API KEY for the agent model>

{fastworkflow-2.14.0 → fastworkflow-2.14.1}/pyproject.toml

@@ -9,7 +9,7 @@ repository = "https://github.com/radiantlogicinc/fastworkflow"
 
 [tool.poetry]
 name = "fastworkflow"
-version = "2.14.0"
+version = "2.14.1"
 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"