griptape-nodes 0.62.3__py3-none-any.whl → 0.63.0__py3-none-any.whl

griptape_nodes/retained_mode/managers/workflow_manager.py

@@ -5,6 +5,7 @@ import asyncio
 import logging
 import pickle
 import re
+from collections import defaultdict
 from dataclasses import dataclass, field, fields, is_dataclass
 from datetime import UTC, datetime
 from enum import StrEnum
@@ -54,6 +55,8 @@ from griptape_nodes.retained_mode.events.flow_events import (
 from griptape_nodes.retained_mode.events.library_events import (
     GetLibraryMetadataRequest,
     GetLibraryMetadataResultSuccess,
+    ListRegisteredLibrariesRequest,
+    ListRegisteredLibrariesResultSuccess,
 )
 from griptape_nodes.retained_mode.events.object_events import ClearAllObjectStateRequest
 from griptape_nodes.retained_mode.events.workflow_events import (
@@ -118,6 +121,22 @@ from griptape_nodes.retained_mode.events.workflow_events import (
 from griptape_nodes.retained_mode.griptape_nodes import (
     GriptapeNodes,
 )
+from griptape_nodes.retained_mode.managers.fitness_problems.workflows import (
+    InvalidDependencyVersionStringProblem,
+    InvalidLibraryVersionStringProblem,
+    InvalidMetadataSchemaProblem,
+    InvalidMetadataSectionCountProblem,
+    InvalidTomlFormatProblem,
+    LibraryNotRegisteredProblem,
+    LibraryVersionBelowRequiredProblem,
+    LibraryVersionLargeDifferenceProblem,
+    LibraryVersionMajorMismatchProblem,
+    LibraryVersionMinorDifferenceProblem,
+    MissingCreationDateProblem,
+    MissingLastModifiedDateProblem,
+    MissingTomlSectionProblem,
+    WorkflowNotFoundProblem,
+)
 from griptape_nodes.retained_mode.managers.os_manager import OSManager
 
 if TYPE_CHECKING:
@@ -128,6 +147,7 @@ if TYPE_CHECKING:
     from griptape_nodes.retained_mode.events.base_events import ResultPayload
     from griptape_nodes.retained_mode.events.node_events import SerializedNodeCommands, SetLockNodeStateRequest
     from griptape_nodes.retained_mode.managers.event_manager import EventManager
+    from griptape_nodes.retained_mode.managers.fitness_problems.workflows.workflow_problem import WorkflowProblem
 
 
 T = TypeVar("T")
@@ -189,7 +209,7 @@ class WorkflowManager:
         workflow_path: str
         workflow_name: str | None = None
         workflow_dependencies: list[WorkflowManager.WorkflowDependencyInfo] = field(default_factory=list)
-        problems: list[str] = field(default_factory=list)
+        problems: list[WorkflowProblem] = field(default_factory=list)
 
     _workflow_file_path_to_info: dict[str, WorkflowInfo]
 
@@ -419,30 +439,48 @@ class WorkflowManager:
 
         return matches
 
-    def print_workflow_load_status(self) -> None:
+    def print_workflow_load_status(self, min_status: WorkflowStatus = WorkflowStatus.FLAWED) -> None:  # noqa: PLR0915
         workflow_file_paths = self.get_workflows_attempted_to_load()
         workflow_infos = []
         for workflow_file_path in workflow_file_paths:
             workflow_info = self.get_workflow_info_for_attempted_load(workflow_file_path)
             workflow_infos.append(workflow_info)
 
+        # Filter workflows to only show those at or worse than min_status
+        all_statuses = list(self.WorkflowStatus)
+        min_status_index = all_statuses.index(min_status)
+        filtered_workflow_infos = [
+            wf_info for wf_info in workflow_infos if all_statuses.index(wf_info.status) >= min_status_index
+        ]
+
+        # Sort workflows by severity (worst to best)
+        filtered_workflow_infos.sort(key=lambda wf: all_statuses.index(wf.status), reverse=True)
+
         console = Console()
 
         # Check if the list is empty
-        if not workflow_infos:
-            # Display a message indicating no workflows are available
+        if not filtered_workflow_infos:
             empty_message = Text("No workflow information available", style="italic")
             panel = Panel(empty_message, title="Workflow Information", border_style="blue")
             console.print(panel)
             return
 
-        # Create a table with five columns and row dividers
+        # Add filter message if not showing all workflows
+        if min_status != self.WorkflowStatus.GOOD:
+            statuses_shown = all_statuses[min_status_index:]
+            status_names = ", ".join(s.value for s in statuses_shown)
+            filter_message = Text(
+                f"Only displaying workflows with a fitness of {status_names}",
+                style="italic yellow",
+            )
+            console.print(filter_message)
+            console.print()
+
+        # Create a table with three columns and row dividers
         table = Table(show_header=True, box=HEAVY_EDGE, show_lines=True, expand=True)
-        table.add_column("Workflow Name", style="green")
-        table.add_column("Status", style="green")
-        table.add_column("File Path", style="cyan")
-        table.add_column("Problems", style="yellow")
-        table.add_column("Dependencies", style="magenta")
+        table.add_column("Workflow", style="green", ratio=2)
+        table.add_column("Problems", style="yellow", ratio=3)
+        table.add_column("Dependencies", style="magenta", ratio=2)
 
         # Status emojis mapping
         status_emoji = {
@@ -452,6 +490,14 @@ class WorkflowManager:
             self.WorkflowStatus.MISSING: "[red]?[/red]",
         }
 
+        # Status text mapping (colored)
+        status_text = {
+            self.WorkflowStatus.GOOD: "[green](GOOD)[/green]",
+            self.WorkflowStatus.FLAWED: "[yellow](FLAWED)[/yellow]",
+            self.WorkflowStatus.UNUSABLE: "[red](UNUSABLE)[/red]",
+            self.WorkflowStatus.MISSING: "[red](MISSING)[/red]",
+        }
+
         dependency_status_emoji = {
             self.WorkflowDependencyStatus.PERFECT: "[green]OK[/green]",
             self.WorkflowDependencyStatus.GOOD: "[green]GOOD[/green]",
@@ -462,19 +508,37 @@ class WorkflowManager:
         }
 
         # Add rows for each workflow info
-        for wf_info in workflow_infos:
-            # File path column
-            file_path = wf_info.workflow_path
-            file_path_text = Text(file_path, style="cyan")
-            file_path_text.overflow = "fold"  # Force wrapping
-
-            # Workflow name column with emoji based on status
+        for wf_info in filtered_workflow_infos:
+            # Workflow name column with emoji, name, colored status, and file path underneath
             emoji = status_emoji.get(wf_info.status, "ERR: Unknown/Unexpected Workflow Status")
+            colored_status = status_text.get(wf_info.status, "(UNKNOWN)")
             name = wf_info.workflow_name if wf_info.workflow_name else "*UNKNOWN*"
-            workflow_name = f"{emoji} - {name}"
+            file_path = wf_info.workflow_path
+            workflow_name_with_path = Text.from_markup(
+                f"{emoji} - {name} {colored_status}\n[cyan dim]{file_path}[/cyan dim]"
+            )
+            workflow_name_with_path.overflow = "fold"
 
-            # Problems column - format with numbers if there's more than one
-            problems = "\n".join(wf_info.problems) if wf_info.problems else "No problems detected."
+            # Problems column - collate by type
+            if not wf_info.problems:
+                problems = "No problems detected."
+            else:
+                # Group problems by type
+                problems_by_type = defaultdict(list)
+                for problem in wf_info.problems:
+                    problems_by_type[type(problem)].append(problem)
+
+                # Collate each group
+                collated_strings = []
+                for problem_class, instances in problems_by_type.items():
+                    collated_display = problem_class.collate_problems_for_display(instances)
+                    collated_strings.append(collated_display)
+
+                # Format for display
+                if len(collated_strings) == 1:
+                    problems = collated_strings[0]
+                else:
+                    problems = "\n".join([f"{j + 1}. {problem}" for j, problem in enumerate(collated_strings)])
 
             # Dependencies column
             if wf_info.status == self.WorkflowStatus.MISSING or (
@@ -492,9 +556,7 @@ class WorkflowManager:
                 )
 
             table.add_row(
-                workflow_name,
-                wf_info.status.value,
-                file_path_text,
+                workflow_name_with_path,
                 problems,
                 dependencies,
             )
@@ -873,9 +935,7 @@ class WorkflowManager:
                 workflow_path=str_path,
                 workflow_name=None,
                 workflow_dependencies=[],
-                problems=[
-                    "Workflow could not be found at the file path specified. It will be removed from the configuration."
-                ],
+                problems=[WorkflowNotFoundProblem()],
             )
             details = f"Attempted to load workflow metadata for a file at '{complete_file_path}. Failed because no file could be found at that path."
             return LoadWorkflowMetadataResultFailure(result_details=details)
@@ -889,9 +949,7 @@ class WorkflowManager:
                 workflow_path=str_path,
                 workflow_name=None,
                 workflow_dependencies=[],
-                problems=[
-                    f"Failed as it had {len(matches)} sections titled '{block_name}', and we expect exactly 1 such section."
-                ],
+                problems=[InvalidMetadataSectionCountProblem(section_name=block_name, count=len(matches))],
             )
             details = f"Attempted to load workflow metadata for a file at '{complete_file_path}'. Failed as it had {len(matches)} sections titled '{block_name}', and we expect exactly 1 such section."
             return LoadWorkflowMetadataResultFailure(result_details=details)
@@ -910,7 +968,7 @@ class WorkflowManager:
                 workflow_path=str_path,
                 workflow_name=None,
                 workflow_dependencies=[],
-                problems=[f"Failed because the metadata was not valid TOML: {err}"],
+                problems=[InvalidTomlFormatProblem(error_message=str(err))],
             )
             details = f"Attempted to load workflow metadata for a file at '{complete_file_path}'. Failed because the metadata was not valid TOML: {err}"
             return LoadWorkflowMetadataResultFailure(result_details=details)
@@ -925,7 +983,7 @@ class WorkflowManager:
                 workflow_path=str_path,
                 workflow_name=None,
                 workflow_dependencies=[],
-                problems=[f"Failed because the '[{tool_header}.{griptape_nodes_header}]' section could not be found."],
+                problems=[MissingTomlSectionProblem(section_path=f"[{tool_header}.{griptape_nodes_header}]")],
             )
             details = f"Attempted to load workflow metadata for a file at '{complete_file_path}'. Failed because the '[{tool_header}.{griptape_nodes_header}]' section could not be found: {err}"
             return LoadWorkflowMetadataResultFailure(result_details=details)
@@ -941,7 +999,9 @@ class WorkflowManager:
                 workflow_name=None,
                 workflow_dependencies=[],
                 problems=[
-                    f"Failed because the metadata in the '[{tool_header}.{griptape_nodes_header}]' section did not match the requisite schema with error: {err}"
+                    InvalidMetadataSchemaProblem(
+                        section_path=f"[{tool_header}.{griptape_nodes_header}]", error_message=str(err)
+                    )
                 ],
             )
             details = f"Attempted to load workflow metadata for a file at '{complete_file_path}'. Failed because the metadata in the '[{tool_header}.{griptape_nodes_header}]' section did not match the requisite schema with error: {err}"
@@ -956,15 +1016,23 @@ class WorkflowManager:
         if workflow_metadata.creation_date is None:
             # Assign it to the epoch start and flag it as a warning.
             workflow_metadata.creation_date = WorkflowManager.EPOCH_START
-            problems.append(
-                f"Workflow metadata was missing a creation date. Defaulting to {WorkflowManager.EPOCH_START}. This value will be replaced with the current date the first time it is saved."
-            )
+            problems.append(MissingCreationDateProblem(default_date=str(WorkflowManager.EPOCH_START)))
         if workflow_metadata.last_modified_date is None:
             # Assign it to the epoch start and flag it as a warning.
             workflow_metadata.last_modified_date = WorkflowManager.EPOCH_START
-            problems.append(
-                f"Workflow metadata was missing a last modified date. Defaulting to {WorkflowManager.EPOCH_START}. This value will be replaced with the current date the first time it is saved."
-            )
+            problems.append(MissingLastModifiedDateProblem(default_date=str(WorkflowManager.EPOCH_START)))
+
+        # Get list of registered libraries once (silent check - no error logging)
+        list_libraries_request = ListRegisteredLibrariesRequest()
+        list_libraries_result = GriptapeNodes.LibraryManager().on_list_registered_libraries_request(
+            list_libraries_request
+        )
+
+        if not isinstance(list_libraries_result, ListRegisteredLibrariesResultSuccess):
+            # Should not happen, but handle gracefully - treat as no libraries registered
+            registered_libraries = []
+        else:
+            registered_libraries = list_libraries_result.libraries
 
         dependency_infos = []
         for node_library_referenced in workflow_metadata.node_libraries_referenced:
@@ -975,7 +1043,7 @@ class WorkflowManager:
             except Exception:
                 had_critical_error = True
                 problems.append(
-                    f"Workflow cited an invalid version string '{desired_version_str}' for library '{library_name}'. Must be specified in major.minor.patch format."
+                    InvalidDependencyVersionStringProblem(library_name=library_name, version_string=desired_version_str)
                 )
                 dependency_infos.append(
                     WorkflowManager.WorkflowDependencyInfo(
@@ -988,20 +1056,32 @@ class WorkflowManager:
                 # SKIP IT.
                 continue
             # See how our desired version compares against the actual library we (may) have.
-            # See if the library exists.
+            # Check if library is registered (silent check - no error logging)
+            if library_name not in registered_libraries:
+                # Library not registered
+                had_critical_error = True
+                problems.append(LibraryNotRegisteredProblem(library_name=library_name))
+                dependency_infos.append(
+                    WorkflowManager.WorkflowDependencyInfo(
+                        library_name=library_name,
+                        version_requested=desired_version_str,
+                        version_present=None,
+                        status=WorkflowManager.WorkflowDependencyStatus.MISSING,
+                    )
+                )
+                # SKIP IT.
+                continue
+
+            # Get library metadata (we know library is registered, so no error logging)
             library_metadata_request = GetLibraryMetadataRequest(library=library_name)
-            # NOTE: Per https://github.com/griptape-ai/griptape-vsl-gui/issues/1123, we
-            # generate a FLOOD of error messages here that can swamp the GUI. We'll call
-            # directly instead of the usual handle_request() path so we don't generate those.
             library_metadata_result = GriptapeNodes.LibraryManager().get_library_metadata_request(
                 library_metadata_request
             )
+
             if not isinstance(library_metadata_result, GetLibraryMetadataResultSuccess):
-                # Metadata failed to be found.
+                # Should not happen since we verified library is registered, but handle gracefully
                 had_critical_error = True
-                problems.append(
-                    f"Library '{library_name}' was not successfully registered. It may have other problems that prevented it from loading."
-                )
+                problems.append(LibraryNotRegisteredProblem(library_name=library_name))
                 dependency_infos.append(
                     WorkflowManager.WorkflowDependencyInfo(
                         library_name=library_name,
@@ -1021,7 +1101,7 @@ class WorkflowManager:
             except Exception:
                 had_critical_error = True
                 problems.append(
-                    f"Library an invalid version string '{library_version_str}' for library '{library_name}'. Must be specified in major.minor.patch format."
+                    InvalidLibraryVersionStringProblem(library_name=library_name, version_string=library_version_str)
                 )
                 dependency_infos.append(
                     WorkflowManager.WorkflowDependencyInfo(
@@ -1046,24 +1126,40 @@ class WorkflowManager:
                 delta = library_version.minor - desired_version.minor
                 if delta < 0:
                     problems.append(
-                        f"Library '{library_name}' is at version '{library_version}', which is below the desired version."
+                        LibraryVersionBelowRequiredProblem(
+                            library_name=library_name,
+                            current_version=str(library_version),
+                            required_version=str(desired_version),
+                        )
                     )
                     status = WorkflowManager.WorkflowDependencyStatus.BAD
                     had_critical_error = True
                 elif delta > WorkflowManager.MAX_MINOR_VERSION_DEVIATION:
                     problems.append(
-                        f"This workflow was built with library '{library_name}' v{desired_version}, but you have v{library_version}. This large version difference may cause compatibility issues. You can update the library to a compatible version or save this workflow to update it to your current library versions."
+                        LibraryVersionLargeDifferenceProblem(
+                            library_name=library_name,
+                            workflow_version=str(desired_version),
+                            current_version=str(library_version),
+                        )
                     )
                     status = WorkflowManager.WorkflowDependencyStatus.BAD
                     had_critical_error = True
                 else:
                     problems.append(
-                        f"This workflow was built with library '{library_name}' v{desired_version}, but you have v{library_version}. Minor differences are usually compatible. If you experience issues, you can update the library or save this workflow to update it to your current library versions."
+                        LibraryVersionMinorDifferenceProblem(
+                            library_name=library_name,
+                            workflow_version=str(desired_version),
+                            current_version=str(library_version),
+                        )
                     )
                     status = WorkflowManager.WorkflowDependencyStatus.CAUTION
             else:
                 problems.append(
-                    f"This workflow requires library '{library_name}' v{desired_version}, but you have v{library_version}. Major version changes may include breaking changes. Consider updating the library to match, or save this workflow to update it to your current library versions."
+                    LibraryVersionMajorMismatchProblem(
+                        library_name=library_name,
+                        workflow_version=str(desired_version),
+                        current_version=str(library_version),
+                    )
                 )
                 status = WorkflowManager.WorkflowDependencyStatus.BAD
                 had_critical_error = True
@@ -1083,7 +1179,7 @@ class WorkflowManager:
             workflow_metadata
         )
         for issue in workflow_version_issues:
-            problems.append(issue.message)
+            problems.append(issue.problem)
             if issue.severity == WorkflowManager.WorkflowStatus.UNUSABLE:
                 had_critical_error = True
 
@@ -2386,82 +2482,11 @@ class WorkflowManager:
         workflow_name: str,
         import_recorder: ImportRecorder,
     ) -> list[ast.AST]:
-        import_recorder.add_from_import(
-            "griptape_nodes.retained_mode.events.library_events", "GetAllInfoForAllLibrariesRequest"
-        )
-        import_recorder.add_from_import(
-            "griptape_nodes.retained_mode.events.library_events", "GetAllInfoForAllLibrariesResultSuccess"
-        )
-        import_recorder.add_from_import(
-            "griptape_nodes.retained_mode.events.library_events", "ReloadAllLibrariesRequest"
-        )
+        import_recorder.add_from_import("griptape_nodes.retained_mode.events.library_events", "LoadLibrariesRequest")
 
         code_blocks: list[ast.AST] = []
 
-        response_assign = ast.Assign(
-            targets=[ast.Name(id="response", ctx=ast.Store())],
-            value=ast.Call(
-                func=ast.Attribute(
-                    value=ast.Name(id="GriptapeNodes", ctx=ast.Load()),
-                    attr="handle_request",
-                    ctx=ast.Load(),
-                ),
-                args=[
-                    ast.Call(
-                        func=ast.Name(id="GetAllInfoForAllLibrariesRequest", ctx=ast.Load()),
-                        args=[],
-                        keywords=[],
-                    )
-                ],
-                keywords=[],
-            ),
-        )
-        ast.fix_missing_locations(response_assign)
-        code_blocks.append(response_assign)
-
-        isinstance_test = ast.Call(
-            func=ast.Name(id="isinstance", ctx=ast.Load()),
-            args=[
-                ast.Name(id="response", ctx=ast.Load()),
-                ast.Name(id="GetAllInfoForAllLibrariesResultSuccess", ctx=ast.Load()),
-            ],
-            keywords=[],
-        )
-        ast.fix_missing_locations(isinstance_test)
-
-        len_call = ast.Call(
-            func=ast.Name(id="len", ctx=ast.Load()),
-            args=[
-                ast.Call(
-                    func=ast.Attribute(
-                        value=ast.Attribute(
-                            value=ast.Name(id="response", ctx=ast.Load()),
-                            attr="library_name_to_library_info",
-                            ctx=ast.Load(),
-                        ),
-                        attr="keys",
-                        ctx=ast.Load(),
-                    ),
-                    args=[],
-                    keywords=[],
-                )
-            ],
-            keywords=[],
-        )
-        compare_len = ast.Compare(
-            left=len_call,
-            ops=[ast.Lt()],
-            comparators=[ast.Constant(value=1)],
-        )
-        ast.fix_missing_locations(compare_len)
-
-        test = ast.BoolOp(
-            op=ast.And(),
-            values=[isinstance_test, compare_len],
-        )
-        ast.fix_missing_locations(test)
-
-        # 3) the body: GriptapeNodes.handle_request(ReloadAllLibrariesRequest())
+        # Generate load libraries request call
         # TODO (https://github.com/griptape-ai/griptape-nodes/issues/1615): Generate requests to load ONLY the libraries used in this workflow
         load_call = ast.Expr(
             value=ast.Call(
@@ -2472,7 +2497,7 @@ class WorkflowManager:
                 ),
                 args=[
                     ast.Call(
-                        func=ast.Name(id="ReloadAllLibrariesRequest", ctx=ast.Load()),
+                        func=ast.Name(id="LoadLibrariesRequest", ctx=ast.Load()),
                         args=[],
                         keywords=[],
                     )
@@ -2481,17 +2506,9 @@ class WorkflowManager:
             )
         )
         ast.fix_missing_locations(load_call)
+        code_blocks.append(load_call)
 
-        # 4) assemble the `if` statement
-        if_node = ast.If(
-            test=test,
-            body=[load_call],
-            orelse=[],
-        )
-        ast.fix_missing_locations(if_node)
-        code_blocks.append(if_node)
-
-        # 5) context_manager = GriptapeNodes.ContextManager()
+        # Generate context manager assignment
         assign_context_manager = ast.Assign(
             targets=[ast.Name(id="context_manager", ctx=ast.Store())],
             value=ast.Call(

griptape_nodes/servers/static.py

@@ -29,11 +29,6 @@ logger = logging.getLogger("griptape_nodes_api")
 logging.getLogger("uvicorn").addHandler(RichHandler(show_time=True, show_path=False, markup=True, rich_tracebacks=True))
 
 
-"""Create and configure the FastAPI application."""
-app = FastAPI()
-
-
-@app.post("/static-upload-urls")
 async def _create_static_file_upload_url(request: Request) -> dict:
     """Create a URL for uploading a static file.
 
@@ -47,7 +42,6 @@ async def _create_static_file_upload_url(request: Request) -> dict:
     return {"url": url}
 
 
-@app.put("/static-uploads/{file_path:path}")
 async def _create_static_file(request: Request, file_path: str) -> dict:
     """Upload a static file to the static server."""
     if not STATIC_SERVER_ENABLED:
@@ -76,8 +70,6 @@ async def _create_static_file(request: Request, file_path: str) -> dict:
     return {"url": static_url}
 
 
-@app.get("/static-uploads/{file_path_prefix:path}")
-@app.get("/static-uploads/")
 async def _list_static_files(file_path_prefix: str = "") -> dict:
     """List static files in the static server under the specified path prefix."""
     if not STATIC_SERVER_ENABLED:
@@ -107,7 +99,6 @@ async def _list_static_files(file_path_prefix: str = "") -> dict:
         return {"files": file_names}
 
 
-@app.delete("/static-files/{file_path:path}")
 async def _delete_static_file(file_path: str) -> dict:
     """Delete a static file from the static server."""
     if not STATIC_SERVER_ENABLED:
@@ -139,11 +130,21 @@ async def _delete_static_file(file_path: str) -> dict:
         return {"message": f"File {file_path} deleted successfully"}
 
 
-def _setup_app() -> None:
-    """Setup FastAPI app with middleware and static files."""
-    workspace_directory = Path(GriptapeNodes.ConfigManager().get_config_value("workspace_directory"))
-    static_files_directory = Path(GriptapeNodes.ConfigManager().get_config_value("static_files_directory"))
+def start_static_server() -> None:
+    """Run uvicorn server synchronously using uvicorn.run."""
+    logger.debug("Starting static server...")
+
+    # Create FastAPI app
+    app = FastAPI()
+
+    # Register routes
+    app.add_api_route("/static-upload-urls", _create_static_file_upload_url, methods=["POST"])
+    app.add_api_route("/static-uploads/{file_path:path}", _create_static_file, methods=["PUT"])
+    app.add_api_route("/static-uploads/{file_path_prefix:path}", _list_static_files, methods=["GET"])
+    app.add_api_route("/static-uploads/", _list_static_files, methods=["GET"])
+    app.add_api_route("/static-files/{file_path:path}", _delete_static_file, methods=["DELETE"])
 
+    # Add CORS middleware
     app.add_middleware(
         CORSMiddleware,
         allow_origins=[
@@ -156,6 +157,10 @@ def _setup_app() -> None:
         allow_headers=["*"],
     )
 
+    # Mount static files
+    workspace_directory = Path(GriptapeNodes.ConfigManager().get_config_value("workspace_directory"))
+    static_files_directory = Path(GriptapeNodes.ConfigManager().get_config_value("static_files_directory"))
+
     app.mount(
         STATIC_SERVER_URL,
         StaticFiles(directory=workspace_directory),
@@ -170,12 +175,6 @@ def _setup_app() -> None:
         name="static",
     )
 
-
-def start_static_server() -> None:
-    """Run uvicorn server synchronously using uvicorn.run."""
-    # Setup the FastAPI app
-    _setup_app()
-
     try:
         # Run server using uvicorn.run
         uvicorn.run(

griptape_nodes/version_compatibility/versions/v0_39_0/modified_parameters_set_removal.py

@@ -9,6 +9,18 @@ from griptape_nodes.retained_mode.events.app_events import (
     GetEngineVersionResultSuccess,
 )
 from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
+from griptape_nodes.retained_mode.managers.fitness_problems.libraries.modified_parameters_set_deprecation_warning_problem import (
+    ModifiedParametersSetDeprecationWarningProblem,
+)
+from griptape_nodes.retained_mode.managers.fitness_problems.libraries.modified_parameters_set_removed_problem import (
+    ModifiedParametersSetRemovedProblem,
+)
+from griptape_nodes.retained_mode.managers.fitness_problems.libraries.ui_options_field_modified_incompatible_problem import (
+    UiOptionsFieldModifiedIncompatibleProblem,
+)
+from griptape_nodes.retained_mode.managers.fitness_problems.libraries.ui_options_field_modified_warning_problem import (
+    UiOptionsFieldModifiedWarningProblem,
+)
 from griptape_nodes.retained_mode.managers.library_lifecycle.library_status import LibraryStatus
 from griptape_nodes.retained_mode.managers.version_compatibility_manager import (
     LibraryVersionCompatibilityCheck,
@@ -49,15 +61,11 @@ class ModifiedParametersSetRemovalCheck(LibraryVersionCompatibilityCheck):
             # 0.39+ Release: Parameter removed, reject incompatible libraries
             return [
                 LibraryVersionCompatibilityIssue(
-                    message=f"This library (built for engine version {library_version_str}) is incompatible with Griptape Nodes 0.39+. "
-                    "The 'modified_parameters_set' parameter has been removed from BaseNode methods: 'after_incoming_connection', 'after_outgoing_connection', 'after_incoming_connection_removed', 'after_outgoing_connection_removed', 'before_value_set', and 'after_value_set'. "
-                    "If this library overrides any of these methods, it will not load or function properly. Please update to a newer version of this library or contact the library author immediately.",
+                    problem=ModifiedParametersSetRemovedProblem(library_engine_version=library_version_str),
                     severity=LibraryStatus.UNUSABLE,
                 ),
                 LibraryVersionCompatibilityIssue(
-                    message=f"This library (built for engine version {library_version_str}) is incompatible with Griptape Nodes 0.39+."
-                    "The 'ui_options' field has been modified on all Elements. In order to function properly, all nodes must update ui_options by setting its value to a new dictionary. Updating ui_options by accessing the private field _ui_options will no longer create UI updates in the editor."
-                    "If this library accesses the private _ui_options field, it will not update the editor properly. Please update to a newer version of this library or contact the library author immediately.",
+                    problem=UiOptionsFieldModifiedIncompatibleProblem(library_engine_version=library_version_str),
                     severity=LibraryStatus.UNUSABLE,
                 ),
             ]
@@ -65,15 +73,11 @@ class ModifiedParametersSetRemovalCheck(LibraryVersionCompatibilityCheck):
             # 0.38 Release: Warning about upcoming removal in 0.39
             return [
                 LibraryVersionCompatibilityIssue(
-                    message=f"WARNING: The 'modified_parameters_set' parameter will be removed in Griptape Nodes 0.39 from BaseNode methods: 'after_incoming_connection', 'after_outgoing_connection', 'after_incoming_connection_removed', 'after_outgoing_connection_removed', 'before_value_set', and 'after_value_set'. "
-                    f"This library (built for engine version {library_version_str}) must be updated before the 0.39 release. "
-                    "If this library overrides any of these methods, it will fail to load in 0.39. If not, no action is necessary. Please contact the library author to confirm whether this library is impacted.",
+                    problem=ModifiedParametersSetDeprecationWarningProblem(library_engine_version=library_version_str),
                     severity=LibraryStatus.FLAWED,
                 ),
                 LibraryVersionCompatibilityIssue(
-                    message="WARNING: The 'ui_options' field has been modified in Griptape Nodes 0.38 on all BaseNodeElements."
-                    "In order to function properly, all nodes must update ui_options by setting its value to a new dictionary. Updating ui_options by accessing the private field _ui_options will no longer create UI updates in the editor."
-                    "If this library accesses the private _ui_options field, it will not update the editor properly. Please update to a newer version of this library or contact the library author immediately.",
+                    problem=UiOptionsFieldModifiedWarningProblem(),
                     severity=LibraryStatus.FLAWED,
                 ),
             ]

griptape_nodes/version_compatibility/workflow_versions/v0_7_0/local_executor_argument_addition.py

@@ -6,6 +6,9 @@ from typing import TYPE_CHECKING
 
 import semver
 
+from griptape_nodes.retained_mode.managers.fitness_problems.workflows.workflow_schema_version_problem import (
+    WorkflowSchemaVersionProblem,
+)
 from griptape_nodes.retained_mode.managers.version_compatibility_manager import (
     WorkflowVersionCompatibilityCheck,
     WorkflowVersionCompatibilityIssue,
@@ -39,9 +42,9 @@ class LocalExecutorArgumentAddition(WorkflowVersionCompatibilityCheck):
         if workflow_schema_version < semver.VersionInfo(0, 7, 0):
             issues.append(
                 WorkflowVersionCompatibilityIssue(
-                    message=f"Workflow schema version {workflow_metadata.schema_version} is older than version 0.7.0. "
-                    "The generated LocalExecutor code for the workflow file is missing the `--json-input` argument, which may cause issues for Publish Workflow requests when using certain Library targets. "
-                    "Consider updating the workflow by saving it again.",
+                    problem=WorkflowSchemaVersionProblem(
+                        description=f"Schema version {workflow_metadata.schema_version} older than 0.7.0. This workflow may not publish or execute properly. Re-save workflow to update."
+                    ),
                     severity=WorkflowManager.WorkflowStatus.FLAWED,
                 )
             )