feat: add UIPATH_LOG_TO_FILE env var for file logging without job context

src/uipath/runtime/context.py

@@ -32,6 +32,7 @@ class UiPathRuntimeContext(BaseModel):
     resume: bool = False
     command: str | None = None
     job_id: str | None = None
+    log_to_file: bool = False
     conversation_id: str | None = Field(
         None, description="Conversation identifier for CAS"
     )
@@ -188,6 +189,7 @@ def __enter__(self):
             dir=self.runtime_dir,
             file=self.logs_file,
             job_id=self.job_id,
+            log_to_file=self.log_to_file,
         )
         self.logs_interceptor.setup()
 
@@ -327,6 +329,7 @@ def with_defaults(
 
         # Apply defaults from env
         base.job_id = os.environ.get("UIPATH_JOB_KEY")
+        base.log_to_file = os.environ.get("UIPATH_LOG_TO_FILE", "").lower() == "true"
         base.logs_min_level = os.environ.get("LOG_LEVEL", "INFO")
         base.org_id = os.environ.get("UIPATH_ORGANIZATION_ID")
         base.tenant_id = os.environ.get("UIPATH_TENANT_ID")

src/uipath/runtime/logging/_interceptor.py

@@ -20,7 +20,7 @@
 class UiPathRuntimeLogsInterceptor:
     """Intercepts all logging and stdout/stderr, routing to either persistent log files or stdout based on whether it's running as a job or not."""
 
     def __init__(
         self,
         min_level: str | None = "INFO",
         dir: str | None = "__uipath",
@@ -28,6 +28,7 @@
         job_id: str | None = None,
         execution_id: str | None = None,
         log_handler: logging.Handler | None = None,
+        log_to_file: bool = False,
     ):
         """Initialize the log interceptor.
 
@@ -38,6 +39,7 @@
             job_id (str, optional): If provided, logs go to file; otherwise, to stdout.
             execution_id (str, optional): Unique identifier for this execution context.
             log_handler (logging.Handler, optional): Custom log handler to use for this execution context.
+            log_to_file (bool): If True, force file logging even without a job_id.
         """
         min_level = min_level or "INFO"
         self.job_id = job_id
@@ -67,8 +69,8 @@
         if log_handler:
             self.log_handler = log_handler
         else:
-            # Create either file handler (runtime) or stdout handler (debug)
-            if not job_id:
+            # Create either file handler (runtime/log_to_file) or stdout handler (debug)
+            if not job_id and not log_to_file:
                 # Only wrap if stdout is using a problematic encoding (like cp1252 on Windows)
                 if (
                     hasattr(sys.stdout, "encoding")