flock-core 0.5.0b28__py3-none-any.whl → 0.5.56b0__py3-none-any.whl

flock/webapp/app/utils.py

@@ -1,85 +0,0 @@
-import inspect
-import json
-from typing import Any
-
-def is_pydantic_model(obj: Any) -> bool:
-    """
-    Check if an object is a Pydantic model instance.
-    More robust detection for both v1 and v2 Pydantic models.
-    """
-    # Check for Pydantic v2 model
-    if hasattr(obj, "__class__") and hasattr(obj.__class__, "model_dump"):
-        return True
-    
-    # Check for Pydantic v1 model
-    if hasattr(obj, "__class__") and hasattr(obj.__class__, "schema") and hasattr(obj, "dict"):
-        return True
-    
-    # Check if it has a __pydantic_core__ attribute (v2 models)
-    if hasattr(obj, "__pydantic_core__"):
-        return True
-        
-    # Final check: class name check and module check
-    if hasattr(obj, "__class__"):
-        cls = obj.__class__
-        cls_name = cls.__name__
-        module_name = getattr(cls, "__module__", "")
-        if "pydantic" in module_name.lower() or "basemodel" in cls_name.lower():
-            return True
-    
-    return False
-
-def is_json_serializable(obj: Any) -> bool:
-    """Check if an object can be serialized to JSON."""
-    try:
-        json.dumps(obj)
-        return True
-    except (TypeError, ValueError):
-        return False
-
-def pydantic_to_dict(obj: Any) -> Any:
-    """
-    Recursively convert Pydantic models to dictionaries.
-    Works with nested models, lists, and dictionaries containing models.
-    Falls back to string representation if object can't be serialized.
-    """
-    if obj is None:
-        return None
-        
-    if is_pydantic_model(obj):
-        # Handle Pydantic v2 models
-        if hasattr(obj, "model_dump"):
-            return obj.model_dump()
-        # Handle Pydantic v1 models
-        elif hasattr(obj, "dict"):
-            return obj.dict()
-        # Last resort - try __dict__ if it exists
-        elif hasattr(obj, "__dict__"):
-            return {k: pydantic_to_dict(v) for k, v in obj.__dict__.items() 
-                   if not k.startswith("_")}
-    
-    elif isinstance(obj, dict):
-        # Handle dictionaries that might contain Pydantic models
-        return {k: pydantic_to_dict(v) for k, v in obj.items()}
-    
-    elif isinstance(obj, list):
-        # Handle lists that might contain Pydantic models
-        return [pydantic_to_dict(item) for item in obj]
-    
-    elif isinstance(obj, tuple) and hasattr(obj, '_fields'):
-        # Handle namedtuples
-        return dict(zip(obj._fields, (pydantic_to_dict(item) for item in obj)))
-    
-    elif isinstance(obj, (list, tuple)):
-        # Handle regular lists and tuples
-        return [pydantic_to_dict(item) for item in obj]
-    
-    # Final check - if object is not JSON serializable, convert to string
-    if not is_json_serializable(obj):
-        try:
-            return str(obj)
-        except Exception:
-            return f"<Unserializable object of type {type(obj).__name__}>"
-    
-    # Return other types unchanged - these should be JSON serializable by default
-    return obj 

flock/webapp/run.py

@@ -1,215 +0,0 @@
-# src/flock/webapp/run.py
-import sys
-from collections.abc import Callable, Sequence
-from pathlib import Path
-from typing import TYPE_CHECKING, Any
-
-import uvicorn
-
-# Import core Flock components
-if TYPE_CHECKING:
-    from flock.core.api.custom_endpoint import FlockEndpoint
-    from flock.core.flock import Flock
-
-# --- Ensure src is in path for imports ---
-current_file_path = Path(__file__).resolve()
-flock_webapp_dir = current_file_path.parent
-flock_dir = flock_webapp_dir.parent
-src_dir = flock_dir.parent # Assuming `flock` is a package within `src`
-
-if str(src_dir) not in sys.path:
-    sys.path.insert(0, str(src_dir))
-
-# --- Main Server Startup Function ---
-def start_unified_server(
-    flock_instance: "Flock",
-    host: str,
-    port: int,
-    server_title: str,
-    enable_ui_routes: bool,
-    enable_chat_routes: bool = False,
-    ui_theme: str | None = None,
-    custom_endpoints: Sequence["FlockEndpoint"] | dict[tuple[str, list[str] | None], Callable[..., Any]] | None = None,
-):
-    """Starts the unified FastAPI server for Flock.
-    - Initializes the web application (imported from webapp.app.main).
-    - Sets the provided Flock instance and a RunStore for dependency injection
-      and makes them available via app.state.
-    - Configures the UI theme.
-    - Stores custom API endpoints for registration during app lifespan startup.
-    - Optionally registers chat routes.
-    - Runs Uvicorn.
-    """
-    print(f"Attempting to start unified server for Flock '{flock_instance.name}' on http://{host}:{port}")
-    print(f"UI Routes Enabled: {enable_ui_routes}, Theme: {ui_theme or 'Default'}")
-
-    try:
-        # Import necessary webapp components HERE, after path setup.
-        from flock.core.api.run_store import RunStore
-        from flock.core.logging.logging import get_logger  # For logging
-        from flock.webapp.app.config import (  # For logging resolved theme
-            get_current_theme_name,
-            set_current_theme_name,
-        )
-        from flock.webapp.app.dependencies import (
-            add_pending_custom_endpoints,
-            set_global_flock_services,
-        )
-        from flock.webapp.app.main import (
-            app as fastapi_app,  # The single FastAPI app instance
-        )
-
-        logger = get_logger("webapp.run") # Use a logger
-
-        # 1. Set UI Theme globally for the webapp
-        set_current_theme_name(ui_theme)
-        logger.info(f"Unified server configured to use theme: {get_current_theme_name()}")
-
-        # 2. Create RunStore & Set Global Services for Dependency Injection
-        run_store_instance = RunStore()
-        set_global_flock_services(flock_instance, run_store_instance)
-        logger.info("Global Flock instance and RunStore set for dependency injection.")
-
-        # 3. Make Flock instance and filename available on app.state
-        fastapi_app.state.flock_instance = flock_instance
-        source_file_attr = "_source_file_path" # Attribute where Flock might store its load path
-        fastapi_app.state.flock_filename = getattr(flock_instance, source_file_attr, None) or \
-                                           f"{flock_instance.name.replace(' ', '_').lower()}.flock.yaml"
-        fastapi_app.state.run_store = run_store_instance
-        fastapi_app.state.chat_enabled = enable_chat_routes
-
-        logger.info(f"Flock '{flock_instance.name}' (from '{fastapi_app.state.flock_filename}') made available via app.state.")
-
-        # 4. Store Custom Endpoints for registration by the lifespan manager in app.main
-        processed_custom_endpoints = []
-        if custom_endpoints:
-            from flock.core.api.custom_endpoint import (
-                FlockEndpoint,  # Ensure it's imported
-            )
-            if isinstance(custom_endpoints, dict):
-                for (path_val, methods_val), cb_val in custom_endpoints.items():
-                    processed_custom_endpoints.append(
-                        FlockEndpoint(path=path_val, methods=list(methods_val) if methods_val else ["GET"], callback=cb_val)
-                    )
-            else: # Assumed Sequence[FlockEndpoint]
-                processed_custom_endpoints.extend(list(custom_endpoints))
-
-        if processed_custom_endpoints:
-            add_pending_custom_endpoints(processed_custom_endpoints)
-            logger.info(f"{len(processed_custom_endpoints)} custom endpoints stored for registration by app lifespan.")
-
-        # 5. Update FastAPI app title (FastAPI app instance is now imported from main)
-        fastapi_app.title = server_title
-
-        # 5a. Optionally strip UI routes if UI is disabled
-        if not enable_ui_routes:
-            from fastapi.routing import APIRoute
-
-            allowed_tags = {"Flock API Core", "Flock API Custom Endpoints", "Chat"}
-
-            def _route_is_allowed(route: APIRoute) -> bool:  # type: ignore
-                # Keep documentation and non-API utility routes (no tags)
-                if not hasattr(route, "tags") or not route.tags:
-                    return True
-                # Keep if any tag is in the allowed list
-                return any(tag in allowed_tags for tag in route.tags)  # type: ignore
-
-            original_count = len(fastapi_app.router.routes)
-            fastapi_app.router.routes = [r for r in fastapi_app.router.routes if _route_is_allowed(r)]
-
-            # Clear cached OpenAPI schema so FastAPI regenerates it with the reduced route set
-            if hasattr(fastapi_app, "openapi_schema"):
-                fastapi_app.openapi_schema = None  # type: ignore
-
-            logger.info(
-                f"UI disabled: removed {original_count - len(fastapi_app.router.routes)} UI routes. Remaining routes: {len(fastapi_app.router.routes)}"
-            )
-
-        # 5b. Include Chat routes if requested
-        if enable_chat_routes:
-            try:
-                from flock.webapp.app.chat import (
-                    router as chat_router,  # type: ignore
-                )
-                fastapi_app.include_router(chat_router, tags=["Chat"])
-                logger.info("Chat routes enabled and registered.")
-            except Exception as e:
-                logger.error(f"Failed to include chat routes: {e}")
-
-        # 6. Run Uvicorn
-        logger.info(f"Running Uvicorn with application: flock.webapp.app.main:app")
-        uvicorn.run(
-            "flock.webapp.app.main:app",
-            host=host,
-            port=port,
-            reload=False, # Critical for programmatically set state like flock_instance
-       #     root_path=os.getenv("FLOCK_ROOT_PATH", "")
-        )
-
-    except ImportError as e:
-        # More specific error logging
-        print(f"CRITICAL: Error importing components for unified server: {e}", file=sys.stderr)
-        print(f"Module not found: {e.name}", file=sys.stderr)
-        print("This usually means a problem with sys.path or missing dependencies.", file=sys.stderr)
-        print(f"Current sys.path: {sys.path}", file=sys.stderr)
-        sys.exit(1)
-    except Exception as e:
-        print(f"CRITICAL: Error starting unified server: {e}", file=sys.stderr)
-        # Consider logging the full traceback for easier debugging
-        import traceback
-        traceback.print_exc(file=sys.stderr)
-        sys.exit(1)
-
-
-# --- Standalone Webapp Runner (for `flock --web` or direct execution `python -m flock.webapp.run`) ---
-def main():
-    """Runs the Flock web application in standalone mode.
-    In this mode, no specific Flock is pre-loaded by the startup script;
-    the user will load or create one via the UI.
-    The FastAPI app (`webapp.app.main:app`) will initialize with DI services
-    set to None for Flock, and a new RunStore.
-    """
-    print("Starting Flock web application in standalone mode...")
-
-    from flock.core.api.run_store import RunStore
-    from flock.webapp.app.config import (
-        get_current_theme_name,  # To log the theme being used
-    )
-    from flock.webapp.app.dependencies import set_global_flock_services
-
-    # No pre-loaded Flock instance; create a RunStore so API calls can still function
-    standalone_run_store = RunStore()
-    set_global_flock_services(None, standalone_run_store)
-
-    print(
-        f"Standalone mode: Initialized global services. Flock: None, RunStore: {type(standalone_run_store)}"
-    )
-    print(f"Standalone webapp using theme: {get_current_theme_name()}")
-
-    host = "127.0.0.1"
-    port = 8344
-    try:
-        import os
-
-        host = os.environ.get("FLOCK_WEB_HOST", host)
-        port = int(os.environ.get("FLOCK_WEB_PORT", port))
-        webapp_reload = os.environ.get("FLOCK_WEB_RELOAD", "true").lower() == "true"
-    except Exception:
-        webapp_reload = True
-
-    app_import_string = "flock.webapp.app.main:app"
-    print(
-        f"Running Uvicorn: app='{app_import_string}', host='{host}', port={port}, reload={webapp_reload}"
-    )
-
-    uvicorn.run(
-        app_import_string,
-        host=host,
-        port=port,
-        reload=webapp_reload,
-       # root_path=os.getenv("FLOCK_ROOT_PATH", "")
-    )
-
-
-if __name__ == "__main__":
-    main()

flock/webapp/static/css/chat.css

@@ -1,301 +0,0 @@
-/* --- Enhanced Chat Styles --- */
-body.chat-page {
-    display: block;
-    padding: 0;
-    margin: 0;
-    height: 100vh;
-    width: 100vw;
-    overflow: hidden;
-    background-color: var(--pico-background-color);
-}
-
-#chat-container {
-    /* Allow the chat container to grow to full width on small screens,
-       but cap it at 80% of the viewport on larger displays and
-       center it horizontally. */
-    width: 100%;
-    max-width: 80%;
-    margin: 0 auto;
-    display: flex;
-    flex-direction: column;
-    height: 100vh;
-    background-color: var(--pico-background-color);
-    overflow: hidden;
-}
-
-#chat-log { 
-    flex: 1; 
-    overflow-y: auto; 
-    padding: 1rem 1.5rem; 
-    display: flex;
-    flex-direction: column;
-    min-height: 0;
-    gap: 1rem;
-    background-color: rgba(0, 0, 0, 0.05);
-    background-image: 
-        radial-gradient(rgba(255, 255, 255, 0.03) 1px, transparent 1px),
-        radial-gradient(rgba(255, 255, 255, 0.03) 1px, transparent 1px);
-    background-size: 20px 20px;
-    background-position: 0 0, 10px 10px;
-}
-
-
-
-.bubble { 
-    position: relative;
-    padding: 0.75rem 1rem; 
-    border-radius: 1.2rem; 
-    max-width: 80%; 
-    margin: 0.25rem 0; 
-    box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
-    animation: fadeIn 0.3s ease-out;
-    word-break: break-word;
-    line-height: 1.4;
-}
-
-@keyframes fadeIn {
-    from { opacity: 0; transform: translateY(10px); }
-    to { opacity: 1; transform: translateY(0); }
-}
-
-.bubble.user { 
-    background: var(--pico-primary); 
-    color: var(--pico-button-base-color); 
-    margin-left: auto; 
-    border-bottom-right-radius: 0.3rem;
-    text-align: right;
-}
-
-.bubble.user::after {
-    content: '';
-    position: absolute;
-    bottom: 0;
-    right: -0.5rem;
-    width: 1rem;
-    height: 1rem;
-    background: var(--pico-primary-hover, var(--pico-primary));
-    clip-path: polygon(0 0, 0% 100%, 100% 100%);
-}
-
-.bubble.bot { 
-    background: var(--pico-code-background-color); 
-    color: var(--pico-code-color); 
-    margin-right: auto; 
-    border-bottom-left-radius: 0.3rem;
-}
-
-.bubble.bot::after {
-    content: '';
-    position: absolute;
-    bottom: 0;
-    left: -0.5rem;
-    width: 1rem;
-    height: 1rem;
-    background: var(--pico-code-background-color);
-    clip-path: polygon(100% 0, 0% 100%, 100% 100%);
-}
-
-#chat-container form { 
-    display: flex; 
-    gap: 0.5rem; 
-    margin: 0;
-    padding: 1rem;
-    background-color: var(--pico-card-background-color);
-    border-top: 1px solid var(--pico-muted-border-color);
-}
-
-#chat-container form input[type="text"] { 
-    flex: 1; 
-    border-radius: 2rem;
-    padding-left: 1.25rem;
-    background-color: var(--pico-background-color);
-    border: 1px solid var(--pico-muted-border-color);
-    transition: all 0.2s ease;
-    height: 3rem;
-    font-size: 1rem;
-}
-
-#chat-container form input[type="text"]:focus {
-    border-color: var(--pico-primary);
-    box-shadow: 0 0 0 2px rgba(var(--pico-primary-rgb, 0, 123, 255), 0.25);
-}
-
-#chat-container form button[type="submit"] { 
-    flex: 0 0 auto; 
-    min-width: auto;
-    width: 150px; /* Wider send button */
-    padding: 0 1rem;
-    border-radius: 2rem;
-    background: var(--pico-primary);
-    color: var(--pico-button-base-color);
-    font-weight: 600;
-    transition: all 0.2s ease;
-    margin-left: 0.5rem;
-    height: 3rem;
-}
-
-#chat-container form button[type="submit"]:hover {
-    background: var(--pico-primary-hover, var(--pico-primary));
-    transform: translateY(-2px);
-    box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
-}
-
-.chat-header {
-    padding: 1rem 1.5rem;
-    background-color: var(--pico-card-background-color);
-    border-bottom: 1px solid var(--pico-muted-border-color);
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    flex-shrink: 0;
-}
-
-.chat-header h2 {
-    margin: 0;
-    font-size: 1.5rem;
-    color: var(--pico-color);
-}
-
-.chat-header h3 {
-    margin: 0;
-    font-size: 0.9rem;
-    color: var(--pico-muted-color);
-    font-weight: normal;
-}
-
-.chat-timestamp {
-    display: block;
-    font-size: 0.7rem;
-    color: var(--pico-button-base-color);
-    margin-top: 0.25rem;
-    opacity: 0.8;
-}
-
-.chat-footer {
-    padding: 0.5rem 1rem;
-    text-align: center;
-    font-size: 0.8rem;
-    color: var(--pico-muted-color);
-    background-color: var(--pico-card-background-color);
-    border-top: 1px solid var(--pico-muted-border-color);
-    flex-shrink: 0;
-}
-/* --- End Enhanced Chat Styles --- */
-
-/* -------------------------------------------------------------------------
-   Chat container tweaks when embedded in the main UI (non-standalone mode)
-   ------------------------------------------------------------------------- */
-body:not(.chat-page) #chat-container,
-body:not(.chat-page) .chat-container {
-    height: 100%;
-    min-height: 100%;
-    /* allow full width inside the main content area */
-    width: 100%;
-    max-width: 100%;
-    margin: 0 auto;
-}
-
-/* Settings form inside chat container should stack vertically */
-.chat-settings-form {
-    display: flex;
-    flex-direction: column;
-    min-height: 60vh;
-    min-width: 100%;
-}
-
-.chat-settings-form label,
-.chat-settings-form input,
-.chat-settings-form select {
-    display: block;
-    width: 100%;
-    margin-bottom: 0.75rem;
-}
-
-.chat-settings-form .grid {
-    display: flex;
-    gap: 0.5rem;
-}
-
-/* Button sizing for Save Settings */
-.chat-settings-form .grid button:first-child {
-    flex: 1 1 auto; /* expand in standalone */
-    width: 50%;
-}
-
-/* In integrated UI (non chat-page) keep natural size */
-body:not(.chat-page) .chat-settings-form .grid button:first-child {
-    flex: 0 0 auto;
-    width: auto;
-}
-
-/* -------------------------------------------------------------------------
-   Container flex area to ensure chat-log grows/shrinks as needed
-   ------------------------------------------------------------------------- */
-#chat-content-area {
-    display: flex;
-    flex-direction: column;
-    flex: 1 1 auto;
-    overflow: hidden;
-}
-
-/* Prevent double scrollbars when chat is embedded */
-main.main-content:has(#chat-container) {
-    overflow: hidden;
-}
-
-/* Ensure all direct text and common markdown elements within bot bubbles use the bot's text color */
-.bubble.bot,
-.bubble.bot p,
-.bubble.bot li,
-.bubble.bot h1,
-.bubble.bot h2,
-.bubble.bot h3,
-.bubble.bot h4,
-.bubble.bot h5,
-.bubble.bot h6,
-.bubble.bot strong,
-.bubble.bot em,
-.bubble.bot table,
-.bubble.bot th,
-.bubble.bot td {
-    color: var(--pico-code-color);
-}
-
-/* For links specifically within bot messages, you might want them to also use the bot text color */
-.bubble.bot a {
-    color: var(--pico-code-color);
-    text-decoration: underline; /* Or your preferred link style */
-}
-.bubble.bot a:hover {
-    color: var(--pico-primary-hover, var(--pico-primary));
-    text-decoration: underline;
-}
-
-/* Styling for code blocks generated by Markdown and highlighted by Prism.js */
-/* The prism-okaidia theme will handle the internal colors of the code. */
-/* This is more about the container of the code block. */
-.bubble.bot pre[class*="language-"] {
-    background-color: var(--pico-card-background-color); /* Or a slightly different dark shade */
-    border: 1px solid var(--pico-muted-border-color);
-    border-radius: var(--pico-border-radius);
-    padding: 0.75em;
-    margin: 0.5em 0;
-    font-size: 0.875em; /* Adjust as needed */
-    overflow-x: auto; /* Allow horizontal scrolling for long code lines */
-    /* The text color *inside* the code block will be handled by the Prism theme (e.g., Okaidia) */
-}
-
-/* Ensure the code itself inside the pre block also resets its base color if needed,
-   though Prism themes usually take care of this. This is a fallback. */
-.bubble.bot pre[class*="language-"] code {
-    /* color: inherit; */ /* This might not be necessary if Prism theme is comprehensive - try without first */
-    background: none;
-    padding: 0;
-}
-
-/* Styles for preformatted text wrapping */
-.bubble pre {
-    white-space: pre-wrap;  /* Allows wrapping and preserves sequences of white space and newlines */
-    word-wrap: break-word; /* Breaks long words/strings if they would overflow */
-    overflow-x: auto;     /* Adds a scrollbar if content is still too wide */
-}