10xscale-agentflow-cli 0.2.9__tar.gz → 0.3.1__tar.gz

{10xscale_agentflow_cli-0.2.9 → 10xscale_agentflow_cli-0.3.1}/10xscale_agentflow_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: 10xscale-agentflow-cli
-Version: 0.2.9
+Version: 0.3.1
 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.9 → 10xscale_agentflow_cli-0.3.1}/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
@@ -21,6 +22,7 @@ agentflow_cli/cli/commands/__init__.py
 agentflow_cli/cli/commands/api.py
 agentflow_cli/cli/commands/build.py
 agentflow_cli/cli/commands/init.py
+agentflow_cli/cli/commands/skills.py
 agentflow_cli/cli/commands/version.py
 agentflow_cli/cli/core/__init__.py
 agentflow_cli/cli/core/config.py
@@ -28,6 +30,36 @@ agentflow_cli/cli/core/output.py
 agentflow_cli/cli/core/validation.py
 agentflow_cli/cli/templates/__init__.py
 agentflow_cli/cli/templates/defaults.py
+agentflow_cli/cli/templates/skills/agent-skills/SKILL.md
+agentflow_cli/cli/templates/skills/agent-skills/references/agents-and-tools.md
+agentflow_cli/cli/templates/skills/agent-skills/references/api-client.md
+agentflow_cli/cli/templates/skills/agent-skills/references/api-configuration.md
+agentflow_cli/cli/templates/skills/agent-skills/references/api-settings-and-middleware.md
+agentflow_cli/cli/templates/skills/agent-skills/references/architecture.md
+agentflow_cli/cli/templates/skills/agent-skills/references/auth-and-authorization.md
+agentflow_cli/cli/templates/skills/agent-skills/references/callbacks-and-command.md
+agentflow_cli/cli/templates/skills/agent-skills/references/checkpointing-and-threads.md
+agentflow_cli/cli/templates/skills/agent-skills/references/cli-commands.md
+agentflow_cli/cli/templates/skills/agent-skills/references/client-auth-and-errors.md
+agentflow_cli/cli/templates/skills/agent-skills/references/client-messages-invoke-stream.md
+agentflow_cli/cli/templates/skills/agent-skills/references/client-threads-memory-files.md
+agentflow_cli/cli/templates/skills/agent-skills/references/context-id-background.md
+agentflow_cli/cli/templates/skills/agent-skills/references/dependency-injection.md
+agentflow_cli/cli/templates/skills/agent-skills/references/id-and-thread-name-generators.md
+agentflow_cli/cli/templates/skills/agent-skills/references/media-and-files.md
+agentflow_cli/cli/templates/skills/agent-skills/references/memory-and-store.md
+agentflow_cli/cli/templates/skills/agent-skills/references/prebuilt-agents-and-tools.md
+agentflow_cli/cli/templates/skills/agent-skills/references/production-runtime.md
+agentflow_cli/cli/templates/skills/agent-skills/references/providers-and-adapters.md
+agentflow_cli/cli/templates/skills/agent-skills/references/publishers-and-runtime-protocols.md
+agentflow_cli/cli/templates/skills/agent-skills/references/remote-tools.md
+agentflow_cli/cli/templates/skills/agent-skills/references/rest-api-and-errors.md
+agentflow_cli/cli/templates/skills/agent-skills/references/security-and-validators.md
+agentflow_cli/cli/templates/skills/agent-skills/references/state-and-messages.md
+agentflow_cli/cli/templates/skills/agent-skills/references/state-graph.md
+agentflow_cli/cli/templates/skills/agent-skills/references/streaming.md
+agentflow_cli/cli/templates/skills/agent-skills/references/testing-and-evaluation.md
+agentflow_cli/cli/templates/skills/copilot/agentflow.instructions.md
 agentflow_cli/src/__init__.py
 agentflow_cli/src/app/__init__.py
 agentflow_cli/src/app/loader.py
@@ -42,6 +74,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 +106,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 +127,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 +137,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.9 → 10xscale_agentflow_cli-0.3.1}/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.9 → 10xscale_agentflow_cli-0.3.1}/MANIFEST.in

@@ -6,6 +6,7 @@ include example_weather_agent.py
 recursive-include agentflow_cli *.json
 recursive-include agentflow_cli *.yaml
 recursive-include agentflow_cli *.yml
+recursive-include agentflow_cli *.md
 recursive-include agentflow_cli *.py
 recursive-include src *.json
 recursive-include src *.yaml

{10xscale_agentflow_cli-0.2.9 → 10xscale_agentflow_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: 10xscale-agentflow-cli
-Version: 0.2.9
+Version: 0.3.1
 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.9 → 10xscale_agentflow_cli-0.3.1}/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.2.9 → 10xscale_agentflow_cli-0.3.1}/agentflow.json

@@ -2,6 +2,5 @@
   "agent": "graph.react:app",
   "thread_name_generator": "graph.thread_name_generator:MyNameGenerator",
   "env": ".env",
-  "auth": null,
-  "agent_card": "agent_card.md"
+  "auth": null
 }

10xscale_agentflow_cli-0.3.1/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