fastworkflow 2.17.27__py3-none-any.whl → 2.17.29__py3-none-any.whl

fastworkflow/__init__.py

@@ -132,6 +132,12 @@ def init(env_vars: dict):
     global _env_vars, CommandContextModel, RoutingDefinition, RoutingRegistry, ModelPipelineRegistry
     _env_vars = env_vars
 
+    # Reconfigure log level from env_vars (dotenv files) if LOG_LEVEL is specified
+    # This allows LOG_LEVEL to be set in fastworkflow.env files, not just OS environment
+    if log_level := env_vars.get("LOG_LEVEL"):
+        from .utils.logging import reconfigure_log_level
+        reconfigure_log_level(log_level)
+
     # init before importing other modules so env vars are available
     from .command_context_model import CommandContextModel as CommandContextModelClass
     from .command_routing import RoutingDefinition as RoutingDefinitionClass

fastworkflow/build/command_file_template.py

@@ -16,7 +16,7 @@ def get_import_block():
         f"from fastworkflow.train.generate_synthetic import generate_diverse_utterances\n"
         f"from fastworkflow.utils.context_utils import list_context_names\n"
         f"from typing import Any, Dict, Optional\n"
-        f"from pydantic import BaseModel, Field\n"
+        f"from pydantic import BaseModel, Field, ConfigDict\n"
     )
 
 def create_function_command_file(function_info: FunctionInfo, output_dir: str, file_name: str = None, source_dir: str = None, overwrite: bool = False) -> str:
@@ -98,8 +98,10 @@ def create_function_command_file(function_info: FunctionInfo, output_dir: str, f
         call_param = ""
         call_arg = ""
 
-    # Add Output class
-    command_file_content += f"    class Output(BaseModel):\n{output_fields}\n\n"
+    # Add Output class with arbitrary_types_allowed for non-Pydantic return types
+    command_file_content += f"    class Output(BaseModel):\n"
+    command_file_content += f"        model_config = ConfigDict(arbitrary_types_allowed=True)\n"
+    command_file_content += f"{output_fields}\n\n"
 
     # Add utterances
     command_file_content += f"    plain_utterances = [\n{plain_utterances}\n    ]\n\n"
@@ -326,8 +328,10 @@ def create_command_file(class_info, method_info, output_dir, file_name=None, is_
     # Add Input class if needed
     command_file_content += input_class
 
-    # Add Output class
-    command_file_content += f"    class Output(BaseModel):\n{output_fields}\n\n"
+    # Add Output class with arbitrary_types_allowed for non-Pydantic return types
+    command_file_content += f"    class Output(BaseModel):\n"
+    command_file_content += f"        model_config = ConfigDict(arbitrary_types_allowed=True)\n"
+    command_file_content += f"{output_fields}\n\n"
 
     # Add utterances
     command_file_content += f"    plain_utterances = [\n{plain_utterances}\n    ]\n\n"

fastworkflow/run_fastapi_mcp/__main__.py

@@ -20,6 +20,7 @@ See docs/fastworkflow_fastapi_spec.md for complete specification.
 
 import asyncio
 import json
+import logging
 import os
 import queue
 import time
@@ -106,6 +107,22 @@ class ProbeLoggingFilterMiddleware(BaseHTTPMiddleware):
         return response
 
 
+class ProbeAccessLogFilter(logging.Filter):
+    """
+    Filter to suppress successful probe requests from uvicorn's access logger.
+    
+    This prevents Kubernetes health check spam in access logs while preserving
+    access logs for all other endpoints. Failed probes (non-200) are still logged
+    via ProbeLoggingFilterMiddleware at WARNING level.
+    """
+    
+    def filter(self, record: logging.LogRecord) -> bool:
+        message = record.getMessage()
+        return not any(
+            f'"{path}' in message and '" 200' in message for path in PROBE_PATHS
+        )
+
+
 # ============================================================================
 # Readiness State Tracking
 # ============================================================================
@@ -229,8 +246,6 @@ async def get_session_and_ensure_runtime(
 @asynccontextmanager
 async def lifespan(_app: FastAPI):
     """Startup and shutdown hooks"""
-    logger.info("FastWorkflow FastAPI service starting...")
-    logger.info(f"Startup with CLI params: workflow_path={ARGS.workflow_path}, env_file_path={ARGS.env_file_path}, passwords_file_path={ARGS.passwords_file_path}")
 
     def initialize_fastworkflow_on_startup() -> None:
         env_vars: dict[str, str] = {}
@@ -304,6 +319,9 @@ async def lifespan(_app: FastAPI):
 
     try:
         initialize_fastworkflow_on_startup()
+        # Log startup info AFTER init() so log level from env file is respected
+        logger.info("FastWorkflow FastAPI service starting...")
+        logger.info(f"Startup with CLI params: workflow_path={ARGS.workflow_path}, env_file_path={ARGS.env_file_path}, passwords_file_path={ARGS.passwords_file_path}")
         # Mark application as ready to accept traffic
         readiness_state.set_ready(True)
         logger.info("Application ready to accept traffic")
@@ -1485,7 +1503,21 @@ def main():
     """Entry point for the FastAPI MCP server."""
     host = ARGS.host if hasattr(ARGS, 'host') else "0.0.0.0"
     port = ARGS.port if hasattr(ARGS, 'port') else 8000
-    uvicorn.run(app, host=host, port=port)
+    
+    # Read LOG_LEVEL from env file to configure uvicorn's logger
+    # (env file isn't loaded until lifespan, but uvicorn needs log_level at startup)
+    log_level = "info"  # uvicorn default
+    if hasattr(ARGS, 'env_file_path') and ARGS.env_file_path:
+        env_vars = dotenv_values(ARGS.env_file_path)
+        if "LOG_LEVEL" in env_vars:
+            log_level = env_vars["LOG_LEVEL"].lower()
+    
+    # Add filter to suppress successful probe requests from uvicorn's access logger
+    # This preserves access logs for other endpoints while eliminating probe spam
+    # Probe failures (non-200) are still logged via ProbeLoggingFilterMiddleware at WARNING level
+    logging.getLogger("uvicorn.access").addFilter(ProbeAccessLogFilter())
+    
+    uvicorn.run(app, host=host, port=port, log_level=log_level)
 
 if __name__ == "__main__":
     main()

fastworkflow/utils/logging.py

@@ -113,6 +113,48 @@ logging.getLogger("speedict").setLevel(logging.WARNING)
 logging.getLogger("filelock").setLevel(logging.WARNING)
 logging.getLogger("datasets").setLevel(logging.WARNING)
 
+
+def reconfigure_log_level(log_level_str: str) -> None:
+    """Reconfigure the fastWorkflow logger's level after initialization.
+    
+    This allows LOG_LEVEL to be set via dotenv files loaded after module import.
+    
+    Args:
+        log_level_str: One of DEBUG, INFO, WARNING, ERROR, CRITICAL
+    """
+    global LOG_LEVEL
+    
+    level_map = {
+        "DEBUG": logging.DEBUG,
+        "INFO": logging.INFO,
+        "WARNING": logging.WARNING,
+        "ERROR": logging.ERROR,
+        "CRITICAL": logging.CRITICAL,
+    }
+    
+    log_level_str_upper = log_level_str.upper()
+    if log_level_str_upper not in level_map:
+        logger.warning(
+            f"Invalid LOG_LEVEL '{log_level_str}', must be one of {list(level_map.keys())}. Keeping current level."
+        )
+        return
+    
+    new_level = level_map[log_level_str_upper]
+    
+    # Only reconfigure if the level is actually different
+    if LOG_LEVEL == new_level:
+        return
+    
+    LOG_LEVEL = new_level
+    logger.setLevel(LOG_LEVEL)
+    
+    # Update all handlers
+    for handler in logger.handlers:
+        handler.setLevel(LOG_LEVEL)
+    
+    logger.info(f"Log level reconfigured to {log_level_str_upper}")
+
+
 # some testing code
 if __name__ == "__main__":
     logger.debug("debug message")

{fastworkflow-2.17.27.dist-info → fastworkflow-2.17.29.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastworkflow
-Version: 2.17.27
+Version: 2.17.29
 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
@@ -133,6 +133,9 @@ While [DSPy](https://dspy.ai) ([Why DSPy](https://x.com/lateinteraction/status/1
     - [Adding context hierarchies with context_inheritance_model.json](#adding-context-hierarchies-with-context_inheritance_modeljson)
     - [Using DSPy for Response Generation](#using-dspy-for-response-generation)
     - [Using Startup Commands and Actions](#using-startup-commands-and-actions)
+    - [Running FastWorkflow as a FastAPI Service](#running-fastworkflow-as-a-fastapi-service)
+        - [Kubernetes Liveness and Readiness Probes](#kubernetes-liveness-and-readiness-probes)
+        - [Using LiteLLM Proxy](#using-litellm-proxy)
 - [Rapidly Building Workflows with the Build Tool](#rapidly-building-workflows-with-the-build-tool)
 - [Environment Variables Reference](#environment-variables-reference)
     - [Environment Variables](#environment-variables)
@@ -582,6 +585,110 @@ For workflows with complex initialization requirements, creating a dedicated sta
 
 ---
 
+### Running FastWorkflow as a FastAPI Service
+
+For production deployments and integrations, fastWorkflow provides a FastAPI-based HTTP service via the `run_fastapi_mcp` module. This exposes your workflow as REST endpoints with JWT authentication, SSE streaming, and MCP (Model Context Protocol) support.
+
+```sh
+# Run the FastAPI service
+python -m fastworkflow.run_fastapi_mcp \
+  --workflow_path ./my_workflow \
+  --env_file_path ./fastworkflow.env \
+  --passwords_file_path ./fastworkflow.passwords.env \
+  --port 8000
+```
+
+The service provides endpoints for:
+- `/initialize` - Create a new session and obtain JWT tokens
+- `/invoke_agent` - Submit natural language queries to the agent
+- `/invoke_agent_stream` - Stream responses via SSE or NDJSON
+- `/perform_action` - Execute workflow actions directly
+- `/conversations` - Manage conversation history
+
+#### Kubernetes Liveness and Readiness Probes
+
+When deploying fastWorkflow in Kubernetes, the service provides dedicated probe endpoints for health monitoring:
+
+**Liveness Probe (`/probes/healthz`)**
+
+Determines whether the container is still running. If this probe fails, Kubernetes will restart the container.
+
+```sh
+curl http://localhost:8000/probes/healthz
+# Response: {"status": "alive"}
+```
+
+**Readiness Probe (`/probes/readyz`)**
+
+Checks whether the container is ready to accept traffic. Kubernetes only routes traffic to containers that pass this check.
+
+```sh
+curl http://localhost:8000/probes/readyz
+# Response (ready): {"status": "ready", "checks": {"ready": true, "fastworkflow_initialized": true, "workflow_path_valid": true}}
+# Response (not ready): {"status": "not_ready", "checks": {"ready": false, ...}}
+```
+
+The readiness probe returns:
+- `200 OK` when the application is ready to serve traffic
+- `503 Service Unavailable` when not ready (e.g., during startup)
+
+**Example Kubernetes Configuration**
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+spec:
+  template:
+    spec:
+      containers:
+        - name: fastworkflow
+          livenessProbe:
+            httpGet:
+              path: /probes/healthz
+              port: 8000
+            initialDelaySeconds: 10
+            periodSeconds: 10
+            failureThreshold: 5
+            timeoutSeconds: 3
+          readinessProbe:
+            httpGet:
+              path: /probes/readyz
+              port: 8000
+            initialDelaySeconds: 5
+            periodSeconds: 5
+            failureThreshold: 3
+            timeoutSeconds: 3
+```
+
+> [!note]
+> Probe endpoints do not require authentication and are excluded from request logging when returning 200 status to avoid excessive log noise from frequent Kubernetes health checks.
+
+#### Using LiteLLM Proxy
+
+FastWorkflow supports routing LLM calls through a [LiteLLM Proxy](https://docs.litellm.ai/docs/simple_proxy) server. This is useful when you want to:
+- Centralize API key management
+- Use a unified endpoint for multiple LLM providers
+- Route requests through a corporate proxy with custom configurations
+
+To use LiteLLM Proxy, set your model strings to use the `litellm_proxy/` prefix and configure the proxy URL:
+
+```
+# In fastworkflow.env - use the litellm_proxy/ prefix for model names
+LLM_AGENT=litellm_proxy/bedrock_mistral_large_2407
+LLM_PARAM_EXTRACTION=litellm_proxy/bedrock_mistral_large_2407
+LITELLM_PROXY_API_BASE=http://127.0.0.1:4000
+
+# In fastworkflow.passwords.env - shared key for proxy authentication
+LITELLM_PROXY_API_KEY=your-proxy-api-key
+```
+
+The model name after `litellm_proxy/` (e.g., `bedrock_mistral_large_2407`) is passed to your proxy server, which routes it to the actual provider based on its configuration.
+
+> [!note]
+> When using `litellm_proxy/` models, the per-role API keys (`LITELLM_API_KEY_*`) are ignored. All proxied calls use the shared `LITELLM_PROXY_API_KEY` instead. You can mix proxied and direct models - only models with the `litellm_proxy/` prefix are routed through the proxy.
+
+---
+
 ## Rapidly Building Workflows with the Build Tool
 
 After understanding the manual process, you can use the `fastworkflow build` command to automate everything. It introspects your code and generates all the necessary files.
@@ -633,30 +740,6 @@ This single command will generate the `greet.py` command, `get_properties` and `
 > [!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.
 
-### Using LiteLLM Proxy
-
-FastWorkflow supports routing LLM calls through a [LiteLLM Proxy](https://docs.litellm.ai/docs/simple_proxy) server. This is useful when you want to:
-- Centralize API key management
-- Use a unified endpoint for multiple LLM providers
-- Route requests through a corporate proxy with custom configurations
-
-To use LiteLLM Proxy, set your model strings to use the `litellm_proxy/` prefix and configure the proxy URL:
-
-```
-# In fastworkflow.env - use the litellm_proxy/ prefix for model names
-LLM_AGENT=litellm_proxy/bedrock_mistral_large_2407
-LLM_PARAM_EXTRACTION=litellm_proxy/bedrock_mistral_large_2407
-LITELLM_PROXY_API_BASE=http://127.0.0.1:4000
-
-# In fastworkflow.passwords.env - shared key for proxy authentication
-LITELLM_PROXY_API_KEY=your-proxy-api-key
-```
-
-The model name after `litellm_proxy/` (e.g., `bedrock_mistral_large_2407`) is passed to your proxy server, which routes it to the actual provider based on its configuration.
-
-> [!note]
-> When using `litellm_proxy/` models, the per-role API keys (`LITELLM_API_KEY_*`) are ignored. All proxied calls use the shared `LITELLM_PROXY_API_KEY` instead. You can mix proxied and direct models - only models with the `litellm_proxy/` prefix are routed through the proxy.
-
 ---
 
 ## Troubleshooting / FAQ

{fastworkflow-2.17.27.dist-info → fastworkflow-2.17.29.dist-info}/RECORD

@@ -1,5 +1,5 @@
 fastworkflow/.DS_Store,sha256=CTvh7SVnPHlYsgd1jwLq9digT-k8QV6JS7JgXEw0OVo,8196
-fastworkflow/__init__.py,sha256=wrifGmkwLnHs6BupEliX20cDuV7WkQEKjNspunkzBlc,7604
+fastworkflow/__init__.py,sha256=SiOTpsqqyHkg4XTeh9jveBPEn93rKdQG3xLTnBjskfU,7922
 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
@@ -20,7 +20,7 @@ fastworkflow/build/class_analysis_structures.py,sha256=UWOKcs9pCiNuXc64hNywkTJq5
 fastworkflow/build/cli_specification.md,sha256=zAVG6wv7AzSotimAQlQmuq6y6ZumhdtftUBcKw3NdA0,3742
 fastworkflow/build/command_dependency_resolver.py,sha256=nNE7nANeDPXLvBlKkIS-8XVkNbg5dPVXB4lJMMANju8,3211
 fastworkflow/build/command_file_generator.py,sha256=i9ZcQLFUr-m1pxK1Vo79ons3yBzniuytx5vvY-0QfZ8,19630
-fastworkflow/build/command_file_template.py,sha256=U1t36YVtDUZVgBuXYsCw8ovK1ZQZkFhWYqNHvoI3hwk,18948
+fastworkflow/build/command_file_template.py,sha256=MmKFnj81SDiNP8h2B4Pec_15WLWYmkR2radVVqfl_Go,19336
 fastworkflow/build/command_import_utils.py,sha256=nwyiurA9HDTLig-e9crBYVsVjkj4qfnLl8CqHUgs9XM,2127
 fastworkflow/build/command_stub_generator.py,sha256=KFOkAZfHeqyDlv59A3PfbuLn7jPXxXp-6MbjWO25LqE,13989
 fastworkflow/build/context_folder_generator.py,sha256=VpKoz3KYKGzCEFPqdVSwGLXLnrqN4MBU7TusOAhzfr0,5254
@@ -148,7 +148,7 @@ fastworkflow/run/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,
 fastworkflow/run/__main__.py,sha256=kHgLI5kQ__4ITNFw7QJdv5u8nmmxbCyLsaiSde6Hnjc,12199
 fastworkflow/run_fastapi_mcp/README.md,sha256=dAmG2KF-9mqSjyIPSA9vhUit-DjsDH6WJUDCkQ3C1is,11943
 fastworkflow/run_fastapi_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fastworkflow/run_fastapi_mcp/__main__.py,sha256=vPdg7vEqxBvMDAAErk0MU921z9jXIRNqSuAPVGbBqKE,60540
+fastworkflow/run_fastapi_mcp/__main__.py,sha256=OPd-BERua8XXuJ3r5uv8kdsVgdQ5qCGO9ezhW0n7Utw,61991
 fastworkflow/run_fastapi_mcp/conversation_store.py,sha256=2qnNLO_RVHznbIzTjpdff7szsrGyr1FVt1spcKvkrKk,13534
 fastworkflow/run_fastapi_mcp/jwt_manager.py,sha256=XHImakUgetCHRHwyacsWUtv0dhlrZtFF6vdastO6XEc,12507
 fastworkflow/run_fastapi_mcp/mcp_specific.py,sha256=RdOPcPn68KlxNSM9Vb2yeYEDNGoNTcKZq-AC0cd86cw,4506
@@ -167,7 +167,7 @@ fastworkflow/utils/dspy_utils.py,sha256=eFpU6jggaE9SGXO88Imxye6Q_EYsU0aymuFCGOsw
 fastworkflow/utils/env.py,sha256=2E9sev6kWEHP0jx1gs1Kv2HJAjr_mb8nyIPzWpRBU08,787
 fastworkflow/utils/fuzzy_match.py,sha256=9NRvgrhHezslGQdquFeWXxc2oE1eNYz4NFMEtsSeXMw,2521
 fastworkflow/utils/generate_param_examples.py,sha256=K0x1Zwe82xqhKA15AYTodWg7mquXsobXtqtZT-B5QAE,25581
-fastworkflow/utils/logging.py,sha256=CsPlhqtR2_HpWNk4iYVKSRtu_xeij6SQKy48xlnKEmI,4116
+fastworkflow/utils/logging.py,sha256=Wj0kj6Cfdh1Ftig0NnVWJl-YxB7lxUEj1T_AcJPuEiQ,5304
 fastworkflow/utils/parameterize_func_decorator.py,sha256=V6YJnishWRCdwiBQW6P17hmGGrga0Empk-AN5Gm7iMk,633
 fastworkflow/utils/pydantic_model_2_dspy_signature_class.py,sha256=w1pvl8rJq48ulFwaAtBgfXYn_SBIDBgq1aLMUg1zJn8,12875
 fastworkflow/utils/python_utils.py,sha256=KMxktfIVOre7qkLhd80Ig39g313EMx_I_oHSa6sC5wI,8512
@@ -177,8 +177,8 @@ fastworkflow/utils/startup_progress.py,sha256=9icSdnpFAxzIq0sUliGpNaH0Efvrt5lDtG
 fastworkflow/workflow.py,sha256=37gn7e3ct-gdGw43zS6Ab_ADoJJBO4eJW2PywfUpjEg,18825
 fastworkflow/workflow_agent.py,sha256=jCvMyz5mLr8UX5QN1ssWebs4f24XhirjGkoJpsS-qZ0,19202
 fastworkflow/workflow_inheritance_model.py,sha256=Pp-qSrQISgPfPjJVUfW84pc7HLmL2evuq0UVIYR51K0,7974
-fastworkflow-2.17.27.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-fastworkflow-2.17.27.dist-info/METADATA,sha256=DswdUGq2rnGkYoe_lGjUqtJYmm4IlUyjU3zpVqU-CmY,33130
-fastworkflow-2.17.27.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-fastworkflow-2.17.27.dist-info/entry_points.txt,sha256=m8HqoPzCyaZLAx-V5X8MJgw3Lx3GiPDlxNEZ7K-Gb-U,54
-fastworkflow-2.17.27.dist-info/RECORD,,
+fastworkflow-2.17.29.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+fastworkflow-2.17.29.dist-info/METADATA,sha256=03WQ1AuapBVYc1pRY3B29jHZ4yqMFI8B0zR5ct-YSBQ,36038
+fastworkflow-2.17.29.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+fastworkflow-2.17.29.dist-info/entry_points.txt,sha256=m8HqoPzCyaZLAx-V5X8MJgw3Lx3GiPDlxNEZ7K-Gb-U,54
+fastworkflow-2.17.29.dist-info/RECORD,,