10xscale-agentflow-cli 0.3.2.1__tar.gz → 0.3.2.2__tar.gz

{10xscale_agentflow_cli-0.3.2.1 → 10xscale_agentflow_cli-0.3.2.2}/10xscale_agentflow_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: 10xscale-agentflow-cli
-Version: 0.3.2.1
+Version: 0.3.2.2
 Summary: CLI and API for 10xscale AgentFlow
 Author-email: 10xscale <contact@10xscale.ai>
 Maintainer-email: Shudipto Trafder <shudiptotrafder@gmail.com>
@@ -31,6 +31,7 @@ Requires-Dist: pydantic-settings
 Requires-Dist: uvicorn
 Requires-Dist: typer
 Requires-Dist: python-dotenv
+Requires-Dist: questionary
 Provides-Extra: sentry
 Requires-Dist: sentry-sdk>=2.10.0; extra == "sentry"
 Provides-Extra: firebase

{10xscale_agentflow_cli-0.3.2.1 → 10xscale_agentflow_cli-0.3.2.2}/10xscale_agentflow_cli.egg-info/SOURCES.txt

@@ -28,6 +28,35 @@ 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/dev/agentflow.json
+agentflow_cli/cli/templates/dev/graph/__init__.py
+agentflow_cli/cli/templates/dev/graph/agent.py
+agentflow_cli/cli/templates/prod/.pre-commot-config.yaml
+agentflow_cli/cli/templates/prod/agentflow.json
+agentflow_cli/cli/templates/prod/auth/__init__.py
+agentflow_cli/cli/templates/prod/auth/agent_auth.py
+agentflow_cli/cli/templates/prod/evals/__init__.py
+agentflow_cli/cli/templates/prod/evals/weather_agents.py
+agentflow_cli/cli/templates/prod/graph/__init__.py
+agentflow_cli/cli/templates/prod/graph/agent.py
+agentflow_cli/cli/templates/prod/graph/state.py
+agentflow_cli/cli/templates/prod/graph/thread_name_generator.py
+agentflow_cli/cli/templates/prod/graph/nodes/__init__.py
+agentflow_cli/cli/templates/prod/graph/nodes/main_node.py
+agentflow_cli/cli/templates/prod/graph/nodes/tool_node.py
+agentflow_cli/cli/templates/prod/graph/tools/__init__.py
+agentflow_cli/cli/templates/prod/graph/tools/weather_tool.py
+agentflow_cli/cli/templates/prod/graph/utils/__init__.py
+agentflow_cli/cli/templates/prod/graph/utils/tool_decision.py
+agentflow_cli/cli/templates/prod/graph/validators/__init__.py
+agentflow_cli/cli/templates/prod/graph/validators/lifecyle.py
+agentflow_cli/cli/templates/prod/graph/validators/manager.py
+agentflow_cli/cli/templates/prod/graph/validators/validators.py
+agentflow_cli/cli/templates/prod/tests/__init__.py
+agentflow_cli/cli/templates/prod/tests/conftest.py
+agentflow_cli/cli/templates/prod/tests/test_agent_eval.py
+agentflow_cli/cli/templates/prod/tests/test_catalog_tools.py
+agentflow_cli/cli/templates/prod/tests/test_graph_nodes.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
@@ -141,8 +170,6 @@ agentflow_cli/src/app/utils/schemas/output_schemas.py
 agentflow_cli/src/app/utils/schemas/user_schemas.py
 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.3.2.1 → 10xscale_agentflow_cli-0.3.2.2}/10xscale_agentflow_cli.egg-info/requires.txt

@@ -8,6 +8,7 @@ pydantic-settings
 uvicorn
 typer
 python-dotenv
+questionary
 
 [firebase]
 firebase-admin>=6.5.0

{10xscale_agentflow_cli-0.3.2.1 → 10xscale_agentflow_cli-0.3.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: 10xscale-agentflow-cli
-Version: 0.3.2.1
+Version: 0.3.2.2
 Summary: CLI and API for 10xscale AgentFlow
 Author-email: 10xscale <contact@10xscale.ai>
 Maintainer-email: Shudipto Trafder <shudiptotrafder@gmail.com>
@@ -31,6 +31,7 @@ Requires-Dist: pydantic-settings
 Requires-Dist: uvicorn
 Requires-Dist: typer
 Requires-Dist: python-dotenv
+Requires-Dist: questionary
 Provides-Extra: sentry
 Requires-Dist: sentry-sdk>=2.10.0; extra == "sentry"
 Provides-Extra: firebase

{10xscale_agentflow_cli-0.3.2.1 → 10xscale_agentflow_cli-0.3.2.2}/agentflow.json

@@ -12,4 +12,4 @@
     "trusted_proxy_headers": false,
     "exclude_paths": ["/health", "/docs", "/redoc", "/openapi.json"]
   }
-}
+}

10xscale_agentflow_cli-0.3.2.2/agentflow_cli/cli/commands/init.py

@@ -0,0 +1,392 @@
+"""Init command implementation."""
+
+import contextlib
+import json
+import re
+from pathlib import Path
+from string import Template
+from typing import Any
+
+import questionary
+import typer
+
+from agentflow_cli.cli.commands import BaseCommand
+from agentflow_cli.cli.constants import Colors
+from agentflow_cli.cli.exceptions import FileOperationError
+
+
+_TEMPLATES_DIR = Path(__file__).parent.parent / "templates"
+_SKIP_DIRS = {"__pycache__"}
+_DIVIDER = Colors.colorize("  " + "─" * 46, "cyan")
+
+# Directories inside prod/ that are only included based on user choices
+_AUTH_DIR = "auth"
+
+
+def _dim(text: str) -> str:
+    return f"\033[2m{text}\033[0m"
+
+
+def _bold(text: str) -> str:
+    return f"\033[1m{text}\033[0m"
+
+
+def _slugify(name: str) -> str:
+    """Convert 'WeatherBot' → 'weather-bot'."""
+    s = re.sub(r"([A-Z])", r"-\1", name).lstrip("-").lower()
+    s = re.sub(r"[^a-z0-9]+", "-", s)
+    return s.strip("-")
+
+
+def _strip_env_blocks(content: str, *, keep_redis: bool, keep_jwt: bool) -> str:
+    """Remove conditional marker blocks that are not needed."""
+    if not keep_redis:
+        content = re.sub(r"##\[IF_REDIS\]##.*?##\[/IF_REDIS\]##\n?", "", content, flags=re.DOTALL)
+    else:
+        content = re.sub(r"##\[IF_REDIS\]##\n?", "", content)
+        content = re.sub(r"##\[/IF_REDIS\]##\n?", "", content)
+
+    if not keep_jwt:
+        content = re.sub(r"##\[IF_JWT\]##.*?##\[/IF_JWT\]##\n?", "", content, flags=re.DOTALL)
+    else:
+        content = re.sub(r"##\[IF_JWT\]##\n?", "", content)
+        content = re.sub(r"##\[/IF_JWT\]##\n?", "", content)
+
+    return content
+
+
+class InitCommand(BaseCommand):
+    """Command to initialize a new agent project interactively."""
+
+    def execute(self, path: str = ".", force: bool = False, **kwargs: Any) -> int:
+        try:
+            self.output.print_banner(
+                "Init", "Create a new AgentFlow agent project", color="magenta"
+            )
+
+            context = self._prompt_user()
+            if context is None:
+                typer.echo("\n  Cancelled.")
+                return 0
+
+            self._print_summary(context)
+
+            base_path = Path(path)
+            base_path.mkdir(parents=True, exist_ok=True)
+
+            is_prod = context["setup_type"] == "production"
+            template_dir = _TEMPLATES_DIR / ("prod" if is_prod else "dev")
+
+            typer.echo(f"\n  {_bold('Creating project files...')}\n")
+            created = self._copy_template_dir(
+                template_dir, base_path, context, force=force, is_prod=is_prod
+            )
+
+            # Regenerate agentflow.json from the built config (overrides template copy)
+            config_path = base_path / "agentflow.json"
+            config = self._build_config(context, is_prod)
+            self._write_file(config_path, json.dumps(config, indent=2) + "\n", force=True)
+            if config_path not in created:
+                self._print_file_line(config_path, base_path)
+
+            agent_name = context["agent_name"]
+            typer.echo("")
+            typer.echo(_DIVIDER)
+            typer.echo(
+                "  ✨  "
+                + Colors.colorize(f'Project "{agent_name}" ready at ', "green")
+                + Colors.colorize(str(base_path.resolve()), "cyan")
+            )
+            typer.echo(_DIVIDER)
+
+            self._print_next_steps(context, is_prod)
+
+            return 0
+
+        except FileOperationError as e:
+            return self.handle_error(e)
+        except Exception as e:
+            return self.handle_error(FileOperationError(f"Failed to initialize project: {e}"))
+
+    # ------------------------------------------------------------------
+    # Prompts
+    # ------------------------------------------------------------------
+
+    def _prompt_user(self) -> dict | None:  # noqa: PLR0911
+        agent_name = questionary.text(
+            "What is your agent name?",
+            default="MyAgent",
+        ).ask()
+        if agent_name is None:
+            return None
+
+        setup_choice = questionary.select(
+            "Quick Start or Production setup?",
+            choices=["Quick Start", "Production"],
+            default="Quick Start",
+        ).ask()
+        if setup_choice is None:
+            return None
+
+        is_prod = setup_choice == "Production"
+
+        context: dict[str, Any] = {
+            "agent_name": agent_name,
+            "agent_name_slug": _slugify(agent_name),
+            "setup_type": "production" if is_prod else "quick_start",
+            "auth": "none",
+            "rate_limit": "none",
+        }
+
+        if not is_prod:
+            return context
+
+        # --- Production questions ---
+
+        auth_choice = questionary.select(
+            "Authentication type?",
+            choices=["None", "JWT", "Custom"],
+            default="None",
+        ).ask()
+        if auth_choice is None:
+            return None
+        context["auth"] = auth_choice.lower()
+
+        rl_choice = questionary.select(
+            "Rate limiting?",
+            choices=["None", "Memory Based", "Redis Based"],
+            default="None",
+        ).ask()
+        if rl_choice is None:
+            return None
+        context["rate_limit"] = {
+            "None": "none",
+            "Memory Based": "memory",
+            "Redis Based": "redis",
+        }[rl_choice]
+
+        if context["rate_limit"] != "none":
+            rl_requests = questionary.text(
+                "Max requests per window?",
+                default="100",
+                validate=lambda v: v.isdigit() and int(v) > 0 or "Enter a positive integer",
+            ).ask()
+            if rl_requests is None:
+                return None
+            context["rl_requests"] = int(rl_requests)
+
+            rl_window = questionary.text(
+                "Window size (seconds)?",
+                default="60",
+                validate=lambda v: v.isdigit() and int(v) > 0 or "Enter a positive integer",
+            ).ask()
+            if rl_window is None:
+                return None
+            context["rl_window"] = int(rl_window)
+
+            rl_by = questionary.select(
+                "Limit by?",
+                choices=["Per IP (recommended)", "Global"],
+                default="Per IP (recommended)",
+            ).ask()
+            if rl_by is None:
+                return None
+            context["rl_by"] = "ip" if "IP" in rl_by else "global"
+
+            rl_proxy = questionary.confirm(
+                "Behind a reverse proxy? (reads real IP from forwarded headers)",
+                default=False,
+            ).ask()
+            if rl_proxy is None:
+                return None
+            context["rl_trusted_proxy"] = rl_proxy
+
+        return context
+
+    # ------------------------------------------------------------------
+    # Output helpers
+    # ------------------------------------------------------------------
+
+    def _print_summary(self, context: dict) -> None:
+        is_prod = context["setup_type"] == "production"
+        setup_label = "Production" if is_prod else "Quick Start"
+
+        typer.echo("")
+        typer.echo(_DIVIDER)
+        typer.echo("  " + _bold("Project Summary"))
+        typer.echo(_DIVIDER)
+
+        rows: list[tuple[str, str]] = [
+            ("Agent name", context["agent_name"]),
+            ("Package name", context["agent_name_slug"]),
+            ("Setup", setup_label),
+        ]
+        if is_prod:
+            auth = context["auth"]
+            rows.append(("Auth", "None" if auth == "none" else auth.upper()))
+
+            rl = context["rate_limit"]
+            if rl == "none":
+                rows.append(("Rate limit", "None"))
+            else:
+                rl_by = "Global" if context.get("rl_by") == "global" else "Per IP"
+                proxy = " · proxy headers on" if context.get("rl_trusted_proxy") else ""
+                rows.append(
+                    (
+                        "Rate limit",
+                        f"{rl.capitalize()} · {context.get('rl_requests', 100)} req / "
+                        f"{context.get('rl_window', 60)}s · {rl_by}{proxy}",
+                    )
+                )
+
+        label_width = max(len(k) for k, _ in rows) + 2
+        for label, value in rows:
+            padded = (label + " ").ljust(label_width, "·")
+            typer.echo(
+                "  " + Colors.colorize(padded, "cyan") + "  " + Colors.colorize(value, "white")
+            )
+        typer.echo(_DIVIDER)
+
+    def _print_file_line(self, dest: Path, base_path: Path) -> None:
+        rel = dest.relative_to(base_path)
+        typer.echo(
+            "    " + Colors.colorize("✓", "green") + "  " + Colors.colorize(str(rel), "white")
+        )
+
+    def _print_next_steps(self, context: dict, is_prod: bool) -> None:
+        steps: list[tuple[str, str]] = []
+
+        steps.append(("agentflow skills", "Install coding agent skills"))
+
+        if is_prod:
+            steps.append(("pre-commit install", "Set up Git hooks (ruff, bandit, etc.)"))
+
+        steps.append(("pip install google-genai", "Add the AI provider library"))
+        steps.append(("cp .env.example .env", "Copy env template, then fill in your API keys"))
+
+        if context["auth"] == "jwt":
+            steps.append(("# Set JWT_SECRET_KEY in .env", "Required for JWT auth to work"))
+
+        if context["rate_limit"] == "redis":
+            steps.append(("# Set REDIS_URL in .env", "Required for Redis rate limiting"))
+
+        steps.append(("agentflow play", "Launch your agent"))
+
+        typer.echo("")
+        typer.echo("  " + Colors.colorize("🚀  Next steps", "magenta"))
+        typer.echo("")
+
+        cmd_width = max(len(cmd) for cmd, _ in steps) + 2
+        for i, (cmd, description) in enumerate(steps, 1):
+            num = Colors.colorize(f"  {i}", "cyan")
+            command = Colors.colorize(cmd.ljust(cmd_width), "yellow")
+            desc = _dim(description)
+            typer.echo(f"{num}  {command}  {desc}")
+
+        typer.echo("")
+
+    # ------------------------------------------------------------------
+    # Config generation
+    # ------------------------------------------------------------------
+
+    def _build_config(self, context: dict, is_prod: bool) -> dict:
+        config: dict = {
+            "agent": "graph.agent:app",
+            "env": ".env",
+            "auth": None,
+            "thread_name_generator": None,
+        }
+
+        if not is_prod:
+            return config
+
+        auth = context["auth"]
+        if auth == "jwt":
+            config["auth"] = {"method": "jwt"}
+        elif auth == "custom":
+            config["auth"] = {"method": "custom", "path": "auth.agent_auth:AgentAuth"}
+
+        config["thread_name_generator"] = "graph.thread_name_generator:MyNameGenerator"
+        config["injectq"] = "graph.agent:container"
+
+        rate_limit = context["rate_limit"]
+        if rate_limit != "none":
+            config["rate_limit"] = {
+                "enabled": True,
+                "backend": rate_limit,
+                "requests": context.get("rl_requests", 100),
+                "window": context.get("rl_window", 60),
+                "by": context.get("rl_by", "ip"),
+                "trusted_proxy_headers": context.get("rl_trusted_proxy", False),
+                "exclude_paths": ["/health", "/docs", "/redoc", "/openapi.json"],
+            }
+
+        return config
+
+    # ------------------------------------------------------------------
+    # File helpers
+    # ------------------------------------------------------------------
+
+    def _should_skip(self, src: Path, template_dir: Path, context: dict, is_prod: bool) -> bool:
+        """Return True if this template file should not be copied."""
+        if any(part in _SKIP_DIRS for part in src.parts):
+            return True
+        if not is_prod:
+            return False
+        # auth/ is only included for custom auth; skip for none and jwt
+        rel_parts = src.relative_to(template_dir).parts
+        return rel_parts[0] == _AUTH_DIR and context["auth"] != "custom"
+
+    def _render(self, src: Path, context: dict, is_prod: bool) -> str:
+        content = src.read_text(encoding="utf-8")
+
+        # Strip conditional blocks in .env.example before substitution
+        if src.name == ".env.example" and is_prod:
+            content = _strip_env_blocks(
+                content,
+                keep_redis=context["rate_limit"] == "redis",
+                keep_jwt=context["auth"] == "jwt",
+            )
+
+        with contextlib.suppress(Exception):
+            content = Template(content).safe_substitute(context)
+
+        return content
+
+    def _copy_template_dir(
+        self,
+        template_dir: Path,
+        dest_dir: Path,
+        context: dict,
+        *,
+        force: bool,
+        is_prod: bool,
+    ) -> set[Path]:
+        created: set[Path] = set()
+        for src in sorted(template_dir.rglob("*")):
+            if src.is_dir():
+                continue
+            if self._should_skip(src, template_dir, context, is_prod):
+                continue
+            rel = src.relative_to(template_dir)
+            dest = dest_dir / rel
+            content = self._render(src, context, is_prod)
+            self._write_file(dest, content, force=force)
+            self._print_file_line(dest, dest_dir)
+            created.add(dest)
+        return created
+
+    def _write_file(self, path: Path, content: str, *, force: bool) -> None:
+        try:
+            path.parent.mkdir(parents=True, exist_ok=True)
+            if path.exists() and not force:
+                raise FileOperationError(
+                    f"File already exists: {path}. Use --force to overwrite.",
+                    file_path=str(path),
+                )
+            path.write_text(content, encoding="utf-8")
+            self.logger.debug("Wrote file: %s", path)
+        except OSError as e:
+            raise FileOperationError(
+                f"Failed to write file {path}: {e}", file_path=str(path)
+            ) from e

{10xscale_agentflow_cli-0.3.2.1 → 10xscale_agentflow_cli-0.3.2.2}/agentflow_cli/cli/main.py

@@ -202,7 +202,7 @@ def init(
         ".",
         "--path",
         "-p",
-        help="Directory to initialize config and graph files in",
+        help="Directory to initialize the agent project in",
     ),
     force: bool = typer.Option(
         False,
@@ -210,13 +210,6 @@ def init(
         "-f",
         help="Overwrite existing files if they exist",
     ),
-    prod: bool = typer.Option(
-        False,
-        "--prod",
-        help=(
-            "Initialize production-ready project (adds pyproject.toml and .pre-commit-config.yaml)"
-        ),
-    ),
     verbose: bool = typer.Option(
         False,
         "--verbose",
@@ -230,13 +223,12 @@ def init(
         help="Suppress all output except errors",
     ),
 ) -> None:
-    """Initialize default config and graph files (agentflow.json and graph/react.py)."""
-    # Setup logging
+    """Interactively initialize a new agent project."""
     setup_cli_logging(verbose=verbose, quiet=quiet)
 
     try:
         command = InitCommand(output)
-        exit_code = command.execute(path=path, force=force, prod=prod)
+        exit_code = command.execute(path=path, force=force)
         sys.exit(exit_code)
     except Exception as e:
         sys.exit(handle_exception(e))

10xscale_agentflow_cli-0.3.2.2/agentflow_cli/cli/templates/dev/agentflow.json

@@ -0,0 +1,6 @@
+{
+  "agent": "graph.agent:app",
+  "env": ".env",
+  "auth": null,
+  "thread_name_generator": null
+}

10xscale_agentflow_cli-0.3.2.2/agentflow_cli/cli/templates/dev/graph/agent.py

@@ -0,0 +1,132 @@
+import logging
+import random
+from datetime import datetime
+
+from agentflow.core import Agent, StateGraph, ToolNode
+from agentflow.core.state import AgentState
+from agentflow.core.state.stream_emitter import StreamEmitter
+from agentflow.storage.checkpointer import InMemoryCheckpointer
+from agentflow.utils.constants import END
+from dotenv import load_dotenv
+
+
+load_dotenv()
+
+checkpointer = InMemoryCheckpointer()
+
+logger = logging.getLogger(__name__)
+
+
+def call_weather_api(location: str) -> str:
+    is_failed = random.choice([True, False])  # Randomly simulate success or failure  # noqa: S311
+    if is_failed:
+        raise Exception("Failed to fetch weather data due to a simulated API error.")
+    return f"The weather in {location} is sunny"
+
+
+def get_weather(
+    location: str,
+    tool_call_id: str | None = None,
+    state: AgentState | None = None,
+    emit: StreamEmitter | None = None,
+) -> str:
+    """
+    Get the current weather for a specific location.
+    This demo shows injectable parameters: tool_call_id and state are automatically injected.
+    """
+    # You can access injected parameters here
+    if tool_call_id:
+        logger.info(f"Tool call ID: {tool_call_id}")
+    if state and hasattr(state, "context"):
+        logger.info(f"Number of messages in context: {len(state.context)}")  # type: ignore
+    if emit:
+        emit.progress("Fetching weather data...")
+
+    # return f"The weather in {location} is sunny"
+
+    result = ""
+    for i in range(3):  # Try up to 3 times
+        try:
+            result = call_weather_api(location)
+            break  # If successful, exit the loop
+        except Exception as e:
+            logger.error(f"Attempt {i + 1} failed: {e}")
+            result = f"Sorry, I couldn't fetch the weather for {location} after multiple attempts."
+            if emit:
+                emit.progress(f"Attempt {i + 1} failed, retrying...")
+
+    return result
+
+
+tool_node = ToolNode(
+    [
+        get_weather,
+    ]
+)
+
+# Create agent with tools
+agent = Agent(
+    model="gemini-3-flash-preview",
+    provider="google",
+    system_prompt=[
+        {
+            "role": "system",
+            "content": """
+                You are a helpful assistant.
+                Your task is to assist the user in finding information and answering questions.
+            """,
+        },
+        {
+            "role": "user",
+            "content": f"Today Date is {datetime.now().strftime('%Y-%m-%d')}",
+        },  # Inject current date into system prompt
+    ],
+    trim_context=True,
+    reasoning_config=True,
+    tool_node=tool_node,
+)
+
+
+def should_use_tools(state: AgentState) -> str:
+    """Determine if we should use tools or end the conversation."""
+    if not state.context or len(state.context) == 0:
+        return "TOOL"  # No context, might need tools
+
+    last_message = state.context[-1]
+
+    # If the last message is from assistant and has tool calls, go to TOOL
+    if (
+        hasattr(last_message, "tools_calls")
+        and last_message.tools_calls
+        and len(last_message.tools_calls) > 0
+        and last_message.role == "assistant"
+    ):
+        return "TOOL"
+
+    # If last message is a tool result, we should be done (AI will make final response)
+    if last_message.role == "tool":
+        return "MAIN"
+
+    # Default to END for other cases
+    return END
+
+
+graph = StateGraph()
+graph.add_node("MAIN", agent)
+graph.add_node("TOOL", tool_node)
+
+# Add conditional edges from MAIN
+graph.add_conditional_edges(
+    "MAIN",
+    should_use_tools,
+    {"TOOL": "TOOL", END: END},
+)
+
+# Always go back to MAIN after TOOL execution
+graph.add_edge("TOOL", "MAIN")
+graph.set_entry_point("MAIN")
+
+
+app = graph.compile(
+    checkpointer=checkpointer,
+)