10xscale-agentflow-cli 0.2.8__tar.gz → 0.3.0__tar.gz

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/10xscale_agentflow_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: 10xscale-agentflow-cli
-Version: 0.2.8
+Version: 0.3.0
 Summary: CLI and API for 10xscale AgentFlow
 Author-email: 10xscale <contact@10xscale.ai>
 Maintainer-email: Shudipto Trafder <shudiptotrafder@gmail.com>
@@ -21,7 +21,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
-Requires-Dist: 10xscale-agentflow>=0.5.0
+Requires-Dist: 10xscale-agentflow>=0.7.0
 Requires-Dist: fastapi
 Requires-Dist: gunicorn
 Requires-Dist: orjson
@@ -32,6 +32,7 @@ Requires-Dist: uvicorn
 Requires-Dist: typer
 Requires-Dist: python-dotenv
 Requires-Dist: PyJWT
+Requires-Dist: textxtract[docx,html,md,pdf,xml]>=0.2.0
 Provides-Extra: sentry
 Requires-Dist: sentry-sdk>=2.10.0; extra == "sentry"
 Provides-Extra: firebase
@@ -81,6 +82,12 @@ agentflow init --prod
 agentflow api
 ```
 
+### Start API With Play
+
+```bash
+agentflow play
+```
+
 ### Generate Docker Files
 
 ```bash
@@ -142,6 +149,24 @@ agentflow api --no-reload
 agentflow api --verbose
 ```
 
+### `agentflow play`
+
+Start the development API server and open the hosted playground with your local backend URL preconfigured.
+
+```bash
+# Start with defaults and open the playground
+agentflow play
+
+# Custom host and port
+agentflow play --host 127.0.0.1 --port 9000
+
+# Custom config file
+agentflow play --config production.json
+
+# Disable auto-reload
+agentflow play --no-reload
+```
+
 ### `agentflow build`
 
 Generate production Docker files.

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/10xscale_agentflow_cli.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ README.md
 agentflow.json
 plan.md
 pyproject.toml
+requirements.txt
 10xscale_agentflow_cli.egg-info/PKG-INFO
 10xscale_agentflow_cli.egg-info/SOURCES.txt
 10xscale_agentflow_cli.egg-info/dependency_links.txt
@@ -42,6 +43,7 @@ agentflow_cli/src/app/core/auth/jwt_auth.py
 agentflow_cli/src/app/core/auth/permissions.py
 agentflow_cli/src/app/core/config/__init__.py
 agentflow_cli/src/app/core/config/graph_config.py
+agentflow_cli/src/app/core/config/media_settings.py
 agentflow_cli/src/app/core/config/sentry_config.py
 agentflow_cli/src/app/core/config/settings.py
 agentflow_cli/src/app/core/config/setup_logs.py
@@ -73,6 +75,10 @@ agentflow_cli/src/app/routers/graph/schemas/__init__.py
 agentflow_cli/src/app/routers/graph/schemas/graph_schemas.py
 agentflow_cli/src/app/routers/graph/services/__init__.py
 agentflow_cli/src/app/routers/graph/services/graph_service.py
+agentflow_cli/src/app/routers/graph/services/multimodal_preprocessor.py
+agentflow_cli/src/app/routers/media/__init__.py
+agentflow_cli/src/app/routers/media/router.py
+agentflow_cli/src/app/routers/media/schemas.py
 agentflow_cli/src/app/routers/ping/__init__.py
 agentflow_cli/src/app/routers/ping/router.py
 agentflow_cli/src/app/routers/store/__init__.py
@@ -90,6 +96,9 @@ agentflow_cli/src/app/utils/response_helper.py
 agentflow_cli/src/app/utils/snowflake_id_generator.py
 agentflow_cli/src/app/utils/swagger_helper.py
 agentflow_cli/src/app/utils/thread_name_generator.py
+agentflow_cli/src/app/utils/media/__init__.py
+agentflow_cli/src/app/utils/media/extractor.py
+agentflow_cli/src/app/utils/media/pipeline.py
 agentflow_cli/src/app/utils/schemas/__init__.py
 agentflow_cli/src/app/utils/schemas/output_schemas.py
 agentflow_cli/src/app/utils/schemas/user_schemas.py
@@ -97,4 +106,6 @@ graph/__init__.py
 graph/react.py
 graph/thread_name_generator.py
 scripts/generate_docs.py
+tests/test_multimodal_sprint2_extraction.py
+tests/test_sprint4_media_api.py
 tests/test_utils_parse_and_callable.py

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/10xscale_agentflow_cli.egg-info/requires.txt

@@ -1,4 +1,4 @@
-10xscale-agentflow>=0.5.0
+10xscale-agentflow>=0.7.0
 fastapi
 gunicorn
 orjson
@@ -9,6 +9,7 @@ uvicorn
 typer
 python-dotenv
 PyJWT
+textxtract[docx,html,md,pdf,xml]>=0.2.0
 
 [firebase]
 firebase-admin>=6.5.0

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: 10xscale-agentflow-cli
-Version: 0.2.8
+Version: 0.3.0
 Summary: CLI and API for 10xscale AgentFlow
 Author-email: 10xscale <contact@10xscale.ai>
 Maintainer-email: Shudipto Trafder <shudiptotrafder@gmail.com>
@@ -21,7 +21,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
-Requires-Dist: 10xscale-agentflow>=0.5.0
+Requires-Dist: 10xscale-agentflow>=0.7.0
 Requires-Dist: fastapi
 Requires-Dist: gunicorn
 Requires-Dist: orjson
@@ -32,6 +32,7 @@ Requires-Dist: uvicorn
 Requires-Dist: typer
 Requires-Dist: python-dotenv
 Requires-Dist: PyJWT
+Requires-Dist: textxtract[docx,html,md,pdf,xml]>=0.2.0
 Provides-Extra: sentry
 Requires-Dist: sentry-sdk>=2.10.0; extra == "sentry"
 Provides-Extra: firebase
@@ -81,6 +82,12 @@ agentflow init --prod
 agentflow api
 ```
 
+### Start API With Play
+
+```bash
+agentflow play
+```
+
 ### Generate Docker Files
 
 ```bash
@@ -142,6 +149,24 @@ agentflow api --no-reload
 agentflow api --verbose
 ```
 
+### `agentflow play`
+
+Start the development API server and open the hosted playground with your local backend URL preconfigured.
+
+```bash
+# Start with defaults and open the playground
+agentflow play
+
+# Custom host and port
+agentflow play --host 127.0.0.1 --port 9000
+
+# Custom config file
+agentflow play --config production.json
+
+# Disable auto-reload
+agentflow play --no-reload
+```
+
 ### `agentflow build`
 
 Generate production Docker files.

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/README.md

@@ -35,6 +35,12 @@ agentflow init --prod
 agentflow api
 ```
 
+### Start API With Play
+
+```bash
+agentflow play
+```
+
 ### Generate Docker Files
 
 ```bash
@@ -96,6 +102,24 @@ agentflow api --no-reload
 agentflow api --verbose
 ```
 
+### `agentflow play`
+
+Start the development API server and open the hosted playground with your local backend URL preconfigured.
+
+```bash
+# Start with defaults and open the playground
+agentflow play
+
+# Custom host and port
+agentflow play --host 127.0.0.1 --port 9000
+
+# Custom config file
+agentflow play --config production.json
+
+# Disable auto-reload
+agentflow play --no-reload
+```
+
 ### `agentflow build`
 
 Generate production Docker files.

10xscale_agentflow_cli-0.3.0/agentflow_cli/cli/commands/api.py

@@ -0,0 +1,211 @@
+"""API server command implementation."""
+
+import ipaddress
+import os
+import socket
+import sys
+import threading
+import time
+import webbrowser
+from pathlib import Path
+from typing import Any
+from urllib.parse import urlencode
+
+import uvicorn
+from dotenv import load_dotenv
+
+from agentflow_cli.cli.commands import BaseCommand
+from agentflow_cli.cli.constants import (
+    DEFAULT_CONFIG_FILE,
+    DEFAULT_HOST,
+    DEFAULT_PLAYGROUND_URL,
+    DEFAULT_PORT,
+)
+from agentflow_cli.cli.core.config import ConfigManager
+from agentflow_cli.cli.core.validation import validate_cli_options
+from agentflow_cli.cli.exceptions import ConfigurationError, ServerError
+
+
+class APICommand(BaseCommand):
+    """Command to start the Pyagenity API server."""
+
+    _PLAYGROUND_WAIT_TIMEOUT_SECONDS = 30.0
+    _PLAYGROUND_WAIT_INTERVAL_SECONDS = 0.25
+
+    def execute(
+        self,
+        config: str = DEFAULT_CONFIG_FILE,
+        host: str = DEFAULT_HOST,
+        port: int = DEFAULT_PORT,
+        reload: bool = True,
+        open_playground: bool = False,
+        playground_url: str = DEFAULT_PLAYGROUND_URL,
+        **kwargs: Any,
+    ) -> int:
+        """Execute the API server command.
+
+        Args:
+            config: Path to config file
+            host: Host to bind to
+            port: Port to bind to
+            reload: Enable auto-reload
+            open_playground: Open the hosted playground after the API becomes reachable
+            playground_url: Hosted playground base URL
+            **kwargs: Additional arguments
+
+        Returns:
+            Exit code
+        """
+        try:
+            # Print banner
+            self.output.print_banner(
+                "API (development)",
+                "Starting development server via Uvicorn. Not for production use.",
+            )
+
+            # Validate inputs
+            validated_options = validate_cli_options(host, port, config)
+
+            # Load configuration
+            config_manager = ConfigManager()
+            actual_config_path = config_manager.find_config_file(validated_options["config"])
+            # Load and validate config
+            config_manager.load_config(str(actual_config_path))
+
+            # Load environment file if specified
+            env_file_path = config_manager.resolve_env_file()
+            if env_file_path:
+                self.logger.info("Loading environment from: %s", env_file_path)
+                load_dotenv(env_file_path)
+            else:
+                # Load default .env if it exists
+                load_dotenv()
+
+            # Set environment variables
+            os.environ["GRAPH_PATH"] = str(actual_config_path)
+
+            # Add project root to sys.path for importing graph modules
+            sys.path.insert(0, str(actual_config_path.parent))
+
+            # Ensure we're using the correct module path
+            sys.path.insert(0, str(Path(__file__).parent.parent.parent))
+
+            self.logger.info(
+                "Starting API with config: %s, host: %s, port: %d",
+                actual_config_path,
+                validated_options["host"],
+                validated_options["port"],
+            )
+
+            if open_playground:
+                self._schedule_playground_launch(
+                    host=validated_options["host"],
+                    port=validated_options["port"],
+                    playground_base_url=playground_url,
+                )
+
+            # Start the server
+            uvicorn.run(
+                "agentflow_cli.src.app.main:app",
+                host=validated_options["host"],
+                port=validated_options["port"],
+                reload=reload,
+                workers=1,
+            )
+
+            return 0
+
+        except (ConfigurationError, ServerError) as e:
+            return self.handle_error(e)
+        except Exception as e:
+            server_error = ServerError(
+                f"Failed to start API server: {e}",
+                host=host,
+                port=port,
+            )
+            return self.handle_error(server_error)
+
+    def _schedule_playground_launch(
+        self,
+        host: str,
+        port: int,
+        playground_base_url: str,
+    ) -> None:
+        browser_host = self._normalize_browser_host(host)
+        launch_url = self._build_playground_url(browser_host, port, playground_base_url)
+        self.output.info(
+            f"Playground will open at {launch_url} when the API is ready.",
+            emoji=False,
+        )
+        launch_thread = threading.Thread(
+            target=self._open_playground_when_ready,
+            args=(launch_url, browser_host, port),
+            daemon=True,
+            name="agentflow-playground-launcher",
+        )
+        launch_thread.start()
+
+    def _open_playground_when_ready(
+        self,
+        launch_url: str,
+        host: str,
+        port: int,
+    ) -> None:
+        if not self._wait_for_server(host, port):
+            self.logger.warning(
+                "API server did not become reachable in time. Open the playground manually: %s",
+                launch_url,
+            )
+            return
+
+        opened = webbrowser.open_new_tab(launch_url)
+        if opened:
+            self.logger.info("Opened playground URL: %s", launch_url)
+            return
+
+        self.logger.warning(
+            "Browser launch returned false. Open the playground manually: %s",
+            launch_url,
+        )
+
+    def _wait_for_server(
+        self,
+        host: str,
+        port: int,
+    ) -> bool:
+        deadline = time.monotonic() + self._PLAYGROUND_WAIT_TIMEOUT_SECONDS
+        while time.monotonic() < deadline:
+            try:
+                with socket.create_connection((host, port), timeout=1):
+                    return True
+            except OSError:
+                time.sleep(self._PLAYGROUND_WAIT_INTERVAL_SECONDS)
+
+        return False
+
+    def _build_playground_url(
+        self,
+        host: str,
+        port: int,
+        playground_base_url: str,
+    ) -> str:
+        backend_host = host
+        if ":" in backend_host and not backend_host.startswith("["):
+            backend_host = f"[{backend_host}]"
+
+        backend_url = f"http://{backend_host}:{port}"
+        return f"{playground_base_url}?{urlencode({'backendUrl': backend_url})}"
+
+    def _normalize_browser_host(self, host: str) -> str:
+        if not host:
+            return "127.0.0.1"
+
+        normalized_host = host[1:-1] if host.startswith("[") and host.endswith("]") else host
+
+        try:
+            if ipaddress.ip_address(normalized_host).is_unspecified:
+                return "127.0.0.1"
+        except ValueError:
+            pass
+
+        return normalized_host

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/agentflow_cli/cli/constants.py

@@ -11,6 +11,7 @@ CLI_VERSION: Final[str] = "1.0.0"
 DEFAULT_HOST: Final[str] = "127.0.0.1"
 DEFAULT_PORT: Final[int] = 8000
 DEFAULT_CONFIG_FILE: Final[str] = "agentflow.json"
+DEFAULT_PLAYGROUND_URL: Final[str] = "https://playground-463bd.web.app"
 DEFAULT_PYTHON_VERSION: Final[str] = "3.13"
 DEFAULT_SERVICE_NAME: Final[str] = "agentflow-api"
 

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/agentflow_cli/cli/main.py

@@ -9,7 +9,11 @@ from agentflow_cli.cli.commands.api import APICommand
 from agentflow_cli.cli.commands.build import BuildCommand
 from agentflow_cli.cli.commands.init import InitCommand
 from agentflow_cli.cli.commands.version import VersionCommand
-from agentflow_cli.cli.constants import DEFAULT_CONFIG_FILE, DEFAULT_HOST, DEFAULT_PORT
+from agentflow_cli.cli.constants import (
+    DEFAULT_CONFIG_FILE,
+    DEFAULT_HOST,
+    DEFAULT_PORT,
+)
 from agentflow_cli.cli.core.output import OutputFormatter
 from agentflow_cli.cli.exceptions import PyagenityCLIError
 from agentflow_cli.cli.logger import setup_cli_logging
@@ -106,6 +110,64 @@ def api(
         sys.exit(handle_exception(e))
 
 
+@app.command()
+def play(
+    config: str = typer.Option(
+        DEFAULT_CONFIG_FILE,
+        "--config",
+        "-c",
+        help="Path to config file",
+    ),
+    host: str = typer.Option(
+        DEFAULT_HOST,
+        "--host",
+        "-H",
+        help=(
+            "Host to run the API on for the local playground session "
+            "(use 127.0.0.1 for localhost only)"
+        ),
+    ),
+    port: int = typer.Option(
+        DEFAULT_PORT,
+        "--port",
+        "-p",
+        help="Port to run the API on",
+    ),
+    reload: bool = typer.Option(
+        True,
+        "--reload/--no-reload",
+        help="Enable auto-reload for development",
+    ),
+    verbose: bool = typer.Option(
+        False,
+        "--verbose",
+        "-v",
+        help="Enable verbose logging",
+    ),
+    quiet: bool = typer.Option(
+        False,
+        "--quiet",
+        "-q",
+        help="Suppress all output except errors",
+    ),
+) -> None:
+    """Start the API server and open the hosted playground."""
+    setup_cli_logging(verbose=verbose, quiet=quiet)
+
+    try:
+        command = APICommand(output)
+        exit_code = command.execute(
+            config=config,
+            host=host,
+            port=port,
+            reload=reload,
+            open_playground=True,
+        )
+        sys.exit(exit_code)
+    except Exception as e:
+        sys.exit(handle_exception(e))
+
+
 @app.command()
 def version(
     verbose: bool = typer.Option(

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/agentflow_cli/src/app/core/auth/jwt_auth.py

@@ -1,4 +1,3 @@
-import os
 from typing import Any
 
 import jwt
@@ -7,6 +6,7 @@ from fastapi.security import HTTPAuthorizationCredentials
 
 from agentflow_cli.src.app.core import logger
 from agentflow_cli.src.app.core.auth.base_auth import BaseAuth
+from agentflow_cli.src.app.core.config.settings import get_settings
 from agentflow_cli.src.app.core.exceptions import UserAccountError
 
 
@@ -44,13 +44,12 @@ class JwtAuth(BaseAuth):
                 message="Invalid token, please login again",
                 error_code="REVOKED_TOKEN",
             )
-        jwt_secret_key = os.environ.get("JWT_SECRET_KEY", None)
-        jwt_algorithm = os.environ.get("JWT_ALGORITHM", None)
 
-        # check bearer token then remove barer prefix
+        settings = get_settings()
+        jwt_secret_key = settings.JWT_SECRET_KEY
+        jwt_algorithm = settings.JWT_ALGORITHM
+
         token = credential.credentials
-        if token.lower().startswith("bearer "):
-            token = token[7:]
 
         if jwt_secret_key is None or jwt_algorithm is None:
             raise UserAccountError(
@@ -61,8 +60,8 @@ class JwtAuth(BaseAuth):
         try:
             decoded_token = jwt.decode(
                 token,
-                jwt_secret_key,  # type: ignore
-                algorithms=[jwt_algorithm],  # type: ignore
+                jwt_secret_key,
+                algorithms=[jwt_algorithm],
             )
         except jwt.ExpiredSignatureError:
             raise UserAccountError(

10xscale_agentflow_cli-0.3.0/agentflow_cli/src/app/core/config/media_settings.py

@@ -0,0 +1,50 @@
+"""Media / multimodal configuration loaded from environment variables."""
+
+from __future__ import annotations
+
+import logging
+from enum import Enum
+from functools import lru_cache
+
+from pydantic import ConfigDict
+from pydantic_settings import BaseSettings
+
+
+logger = logging.getLogger("agentflow-cli.media")
+
+
+class MediaStorageType(str, Enum):
+    MEMORY = "memory"
+    LOCAL = "local"
+    CLOUD = "cloud"
+    PG = "pg"
+
+
+class MediaSettings(BaseSettings):
+    """Settings loaded from env vars (prefix-free, matches plan)."""
+
+    MEDIA_STORAGE_TYPE: MediaStorageType = MediaStorageType.LOCAL
+    MEDIA_STORAGE_PATH: str = "./uploads"
+    MEDIA_MAX_SIZE_MB: float = 25.0
+    DOCUMENT_HANDLING: str = "extract_text"  # extract_text | pass_raw | skip
+
+    # Cloud storage (S3/GCS) — only used when MEDIA_STORAGE_TYPE=cloud
+    MEDIA_CLOUD_PROVIDER: str = "aws"  # aws | gcp
+    MEDIA_CLOUD_BUCKET: str = ""
+    MEDIA_CLOUD_REGION: str = "us-east-1"
+    MEDIA_CLOUD_PREFIX: str = "agentflow-media"
+    MEDIA_CLOUD_ACCESS_KEY_ID: str | None = None
+    MEDIA_CLOUD_SECRET_ACCESS_KEY: str | None = None
+    MEDIA_CLOUD_SESSION_TOKEN: str | None = None
+    MEDIA_CLOUD_PROJECT_ID: str | None = None
+    MEDIA_CLOUD_CREDENTIALS_JSON: str | None = None
+
+    MEDIA_SIGNED_URL_TTL_SECONDS: int = 3600
+    MEDIA_SIGNED_URL_REFRESH_BUFFER_SECONDS: int = 60
+
+    model_config = ConfigDict(extra="allow")
+
+
+@lru_cache
+def get_media_settings() -> MediaSettings:
+    return MediaSettings()  # type: ignore[call-arg]

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/agentflow_cli/src/app/core/config/settings.py

@@ -2,7 +2,7 @@ import logging
 import os
 from functools import lru_cache
 
-from pydantic import field_validator, model_validator
+from pydantic import ConfigDict, field_validator, model_validator
 from pydantic_settings import BaseSettings
 
 
@@ -102,6 +102,12 @@ class Settings(BaseSettings):
     SNOWFLAKE_NODE_BITS: int = 5
     SNOWFLAKE_WORKER_BITS: int = 8
 
+    #################################
+    ###### JWT Config ###############
+    #################################
+    JWT_SECRET_KEY: str | None = None
+    JWT_ALGORITHM: str = "HS256"
+
     @field_validator("MODE", mode="before")
     @classmethod
     def normalize_mode(cls, v: str | None) -> str:
@@ -149,8 +155,7 @@ class Settings(BaseSettings):
 
         return self
 
-    class Config:
-        extra = "allow"
+    model_config = ConfigDict(extra="allow")
 
 
 @lru_cache

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/agentflow_cli/src/app/core/exceptions/handle_errors.py

@@ -1,5 +1,5 @@
 # Handle all exceptions of agentflow here
-from agentflow.exceptions import (
+from agentflow.core.exceptions import (
     GraphError,
     GraphRecursionError,
     MetricsError,

{10xscale_agentflow_cli-0.2.8 → 10xscale_agentflow_cli-0.3.0}/agentflow_cli/src/app/core/middleware/request_limits.py

@@ -56,8 +56,7 @@ class RequestSizeLimitMiddleware(BaseHTTPMiddleware):
                         "error": {
                             "code": "REQUEST_TOO_LARGE",
                             "message": (
-                                f"Request body too large. "
-                                f"Maximum size is {self.max_size_mb:.1f}MB"
+                                f"Request body too large. Maximum size is {self.max_size_mb:.1f}MB"
                             ),
                             "max_size_bytes": self.max_size,
                             "max_size_mb": self.max_size_mb,