acra-cli 0.1.2__tar.gz → 0.1.3__tar.gz

{acra_cli-0.1.2/acra_cli.egg-info → acra_cli-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acra-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: Agentic CLI for LLM task execution, research, and workflow automation.
 Author: Raj Tembe
 License: GNU Affero General Public License v3

{acra_cli-0.1.2 → acra_cli-0.1.3}/acra/cli.py

@@ -2,11 +2,17 @@
 
 import typer
 
+import acra
+from acra.commands.ask import ask, build, explain, fix, review, run
+from acra.commands.research import research
 from acra.commands import (
     serve_app,
     config_app,
     keys_app,
-    research_app,
+    brain_app,
+    context_app,
+    logs_app,
+    plugin_app,
     memory_app,
     session_app,
     graph_app,
@@ -19,11 +25,28 @@ app = typer.Typer(add_completion=True)
 app.add_typer(serve_app, name="serve")
 app.add_typer(config_app, name="config")
 app.add_typer(keys_app, name="keys")
-app.add_typer(research_app, name="research")
 app.add_typer(memory_app, name="memory")
 app.add_typer(session_app, name="session")
 app.add_typer(graph_app, name="graph")
 app.add_typer(utils_app, name="workspace")
+app.add_typer(brain_app, name="brain", help="Brain management commands for acra.")
+app.add_typer(context_app, name="context", help="Context management commands for acra.")
+app.add_typer(logs_app, name="logs", help="Logging commands for acra.")
+app.add_typer(plugin_app, name="plugin", help="Plugin commands for acra.")
+
+app.command("ask")(ask)
+app.command("build")(build)
+app.command("fix")(fix)
+app.command("review")(review)
+app.command("explain")(explain)
+app.command("run")(run)
+app.command("research")(research)
+
+
+def _version_callback(value: bool):
+    if value:
+        typer.echo(acra.__version__)
+        raise typer.Exit()
 
 
 def app_main() -> None:
@@ -34,9 +57,16 @@ def app_main() -> None:
 @app.callback(invoke_without_command=True)
 def main(
     ctx: typer.Context,
+    version: bool = typer.Option(
+        False,
+        "--version",
+        callback=_version_callback,
+        is_eager=True,
+        help="Show the installed acra version and exit.",
+    ),
     profile: str = typer.Option(None, "--profile", help="Profile to use."),
     workspace: str = typer.Option(None, "--workspace", help="Override workspace path."),
-    no_memory: bool = typer.Option(False, "--no-memory", help="Run without memory."),
+    use_memory: bool = typer.Option(True, "--memory/--no-memory", help="Use memory."),
     dry_run: bool = typer.Option(False, "--dry-run", help="Display planned actions without executing."),
     json_output: bool = typer.Option(False, "--json", help="Output JSON-formatted results."),
     verbose: bool = typer.Option(False, "--verbose", "-v", help="Enable verbose logging."),

{acra_cli-0.1.2 → acra_cli-0.1.3}/acra/commands/__init__.py

@@ -1,6 +1,7 @@
 """acra command modules."""
 
 from .serve import app as serve_app
+from .ask import app as ask_app
 from .config import app as config_app
 from .brain import app as brain_app
 from .research import app as research_app
@@ -15,6 +16,7 @@ from .utils import app as utils_app
 
 __all__ = [
     "serve_app",
+    "ask_app",
     "config_app",
     "brain_app",
     "research_app",

acra_cli-0.1.3/acra/commands/ask.py

@@ -0,0 +1,95 @@
+"""Agent task commands for acra."""
+
+from typing import Optional
+
+import typer
+
+from acra.graph.workflow import OmniAgentCallbacks, omniagent_graph
+from acra.ui.components import render_panel
+
+app = typer.Typer(help="Agent task commands for acra.")
+
+
+def _run_task(
+    task: str,
+    task_label: str,
+    profile: Optional[str] = None,
+    use_memory: bool = True,
+    interactive: bool = False,
+):
+    state = {
+        "user_request": task,
+        "task_label": task_label,
+        "no_memory": not use_memory,
+        "profile": profile,
+        "interactive": interactive,
+    }
+    result = omniagent_graph.invoke(state, config={"callbacks": [OmniAgentCallbacks()]})
+    render_panel(result, title=task_label)
+    return result
+
+
+@app.command()
+def ask(
+    task: str = typer.Argument(..., help="Task or question for the agent."),
+    profile: Optional[str] = typer.Option(None, help="Profile to use."),
+    use_memory: bool = typer.Option(True, "--memory/--no-memory", help="Use memory for this task."),
+    interactive: bool = typer.Option(False, "--interactive", help="Route agent approval requests to the human node."),
+):
+    """Ask the assistant a question."""
+    return _run_task(task, "ask", profile, use_memory, interactive)
+
+
+@app.command()
+def build(
+    task: str = typer.Argument(..., help="Build task for the agent."),
+    profile: Optional[str] = typer.Option(None, help="Profile to use."),
+    use_memory: bool = typer.Option(True, "--memory/--no-memory", help="Use memory for this task."),
+    interactive: bool = typer.Option(False, "--interactive", help="Route agent approval requests to the human node."),
+):
+    """Run a build workflow for a project task."""
+    return _run_task(task, "build", profile, use_memory, interactive)
+
+
+@app.command()
+def fix(
+    task: str = typer.Argument(..., help="Code issue or bug for the agent to fix."),
+    profile: Optional[str] = typer.Option(None, help="Profile to use."),
+    use_memory: bool = typer.Option(True, "--memory/--no-memory", help="Use memory for this task."),
+    interactive: bool = typer.Option(False, "--interactive", help="Route agent approval requests to the human node."),
+):
+    """Run a fix workflow for a code issue."""
+    return _run_task(task, "fix", profile, use_memory, interactive)
+
+
+@app.command()
+def review(
+    task: str = typer.Argument(..., help="Code, design, or task to review."),
+    profile: Optional[str] = typer.Option(None, help="Profile to use."),
+    use_memory: bool = typer.Option(True, "--memory/--no-memory", help="Use memory for this task."),
+    interactive: bool = typer.Option(False, "--interactive", help="Route agent approval requests to the human node."),
+):
+    """Review code or design with the critic pipeline."""
+    return _run_task(task, "review", profile, use_memory, interactive)
+
+
+@app.command()
+def explain(
+    task: str = typer.Argument(..., help="Concept or code path to explain."),
+    profile: Optional[str] = typer.Option(None, help="Profile to use."),
+    use_memory: bool = typer.Option(True, "--memory/--no-memory", help="Use memory for this task."),
+    interactive: bool = typer.Option(False, "--interactive", help="Route agent approval requests to the human node."),
+):
+    """Explain a technical concept or code path."""
+    return _run_task(task, "explain", profile, use_memory, interactive)
+
+
+@app.command()
+def run(
+    task: str = typer.Argument(..., help="Task for the agent to execute."),
+    profile: Optional[str] = typer.Option(None, help="Profile to use."),
+    use_memory: bool = typer.Option(True, "--memory/--no-memory", help="Use memory for this task."),
+    interactive: bool = typer.Option(False, "--interactive", help="Route agent approval requests to the human node."),
+):
+    """Execute a task using the executor agent."""
+    return _run_task(task, "run", profile, use_memory, interactive)

{acra_cli-0.1.2 → acra_cli-0.1.3}/acra/commands/research.py

@@ -27,7 +27,11 @@ def research(
     output: Optional[str] = typer.Option(None, help="Write research output to a file."),
     save: bool = typer.Option(False, help="Persist research output into memory."),
     follow_up: bool = typer.Option(False, help="Keep the session open for follow-up questions."),
-    no_memory: bool = typer.Option(False, help="Skip memory persistence for this research."),
+    use_memory: bool = typer.Option(
+        True,
+        "--memory/--no-memory",
+        help="Use memory persistence for this research.",
+    ),
     profile: Optional[str] = typer.Option(None, help="Profile to use."),
     json_output: bool = typer.Option(False, "--json", help="Output JSON instead of rich text."),
     verbose: bool = typer.Option(False, "--verbose", "-v", help="Show detailed debug output."),
@@ -45,7 +49,7 @@ def research(
         "research_depth": depth,
         "research_sources": source_list,
         "follow_up": follow_up,
-        "save_to_memory": save and not no_memory,
+        "save_to_memory": save and use_memory,
         "profile": profile,
     }
 

{acra_cli-0.1.2 → acra_cli-0.1.3/acra_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acra-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: Agentic CLI for LLM task execution, research, and workflow automation.
 Author: Raj Tembe
 License: GNU Affero General Public License v3

{acra_cli-0.1.2 → acra_cli-0.1.3}/acra_cli.egg-info/SOURCES.txt

@@ -174,4 +174,5 @@ acra_cli.egg-info/dependency_links.txt
 acra_cli.egg-info/entry_points.txt
 acra_cli.egg-info/requires.txt
 acra_cli.egg-info/top_level.txt
-tests/test_cli.py
+tests/test_cli.py
+tests/test_interactive_routing.py

{acra_cli-0.1.2 → acra_cli-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "acra-cli"
-version = "0.1.2"
+version = "0.1.3"
 description = "Agentic CLI for LLM task execution, research, and workflow automation."
 readme = "README.md"
 requires-python = ">=3.11"

acra_cli-0.1.3/tests/test_cli.py

@@ -0,0 +1,91 @@
+from typer.testing import CliRunner
+
+from acra.cli import app
+import acra.commands.ask as ask_module
+import acra.commands.serve as serve_module
+
+
+def test_root_cli_exposes_ask_commands():
+    runner = CliRunner()
+
+    result = runner.invoke(app, ["build", "--help"])
+
+    assert result.exit_code == 0
+    assert "Run a build workflow for a project task." in result.output
+
+
+def test_root_cli_exposes_brain_command():
+    runner = CliRunner()
+
+    result = runner.invoke(app, ["brain", "--help"])
+
+    assert result.exit_code == 0
+    assert "Brain management commands for acra." in result.output
+
+
+def test_root_cli_exposes_context_command():
+    runner = CliRunner()
+
+    result = runner.invoke(app, ["context", "--help"])
+
+    assert result.exit_code == 0
+    assert "Context management commands for acra." in result.output
+
+
+def test_root_cli_exposes_logs_command():
+    runner = CliRunner()
+
+    result = runner.invoke(app, ["logs", "--help"])
+
+    assert result.exit_code == 0
+    assert "Logging commands for acra." in result.output
+
+
+def test_root_cli_exposes_plugin_command():
+    runner = CliRunner()
+
+    result = runner.invoke(app, ["plugin", "--help"])
+
+    assert result.exit_code == 0
+    assert "Plugin commands for acra." in result.output
+
+
+def test_brain_models_command_renders_without_crashing():
+    runner = CliRunner()
+
+    result = runner.invoke(app, ["brain", "models"])
+
+    assert result.exit_code == 0
+    assert "Models for all providers" in result.output
+
+
+def test_build_command_sets_interactive_and_memory_flags(monkeypatch):
+    runner = CliRunner()
+    captured = {}
+
+    class FakeGraph:
+        def invoke(self, state, config=None):
+            captured["state"] = state
+            return {"ok": True}
+
+    monkeypatch.setattr(ask_module, "omniagent_graph", FakeGraph())
+    result = runner.invoke(app, ["build", "create a hello world script", "--interactive", "--no-memory"])
+
+    assert result.exit_code == 0
+    assert captured["state"]["task_label"] == "build"
+    assert captured["state"]["interactive"] is True
+    assert captured["state"]["no_memory"] is True
+
+
+def test_serve_command_launches_shell_without_subcommand(monkeypatch):
+    runner = CliRunner()
+    called = {"value": False}
+
+    def fake_launch_shell(*args, **kwargs):
+        called["value"] = True
+
+    monkeypatch.setattr(serve_module, "launch_shell", fake_launch_shell)
+    result = runner.invoke(app, ["serve"])
+
+    assert result.exit_code == 0
+    assert called["value"] is True

acra_cli-0.1.3/tests/test_interactive_routing.py

@@ -0,0 +1,53 @@
+from types import SimpleNamespace
+
+from acra.agents.planner import planner_agent as planner_module
+
+
+def test_planner_routes_to_human_when_interactive_approval_required(monkeypatch):
+    class FakePlannerChain:
+        def invoke(self, inputs):
+            return SimpleNamespace(
+                tasks=["Confirm plan"],
+                current_step="Confirm plan",
+                workflow_status="planning",
+                next_agent="coder",
+                require_human_approval=True,
+            )
+
+    monkeypatch.setattr(
+        planner_module,
+        "create_planner_chain",
+        lambda: FakePlannerChain(),
+    )
+
+    result = planner_module.planner_agent({
+        "user_request": "build a script",
+        "interactive": True,
+    })
+
+    assert result["next_agent"] == "human"
+
+
+def test_planner_skips_human_route_without_interactive_flag(monkeypatch):
+    class FakePlannerChain:
+        def invoke(self, inputs):
+            return SimpleNamespace(
+                tasks=["Write code"],
+                current_step="Write code",
+                workflow_status="planning",
+                next_agent="coder",
+                require_human_approval=True,
+            )
+
+    monkeypatch.setattr(
+        planner_module,
+        "create_planner_chain",
+        lambda: FakePlannerChain(),
+    )
+
+    result = planner_module.planner_agent({
+        "user_request": "build a script",
+        "interactive": False,
+    })
+
+    assert result["next_agent"] == "coder"

acra_cli-0.1.2/acra/commands/ask.py

@@ -1,49 +0,0 @@
-"""Agent task commands for acra."""
-
-import uuid
-from typing import Optional
-
-from acra.graph.workflow import OmniAgentCallbacks, omniagent_graph
-from acra.ui.components import render_panel
-
-
-def _run_task(task: str, task_label: str, profile: Optional[str] = None, no_memory: bool = False):
-    state = {
-        "user_request": task,
-        "task_label": task_label,
-        "no_memory": no_memory,
-        "profile": profile,
-    }
-    result = omniagent_graph.invoke(state, config={"callbacks": [OmniAgentCallbacks()]})
-    render_panel(result, title=task_label)
-    return result
-
-
-def ask(task: str, profile: Optional[str] = None, no_memory: bool = False):
-    """Ask the assistant a question."""
-    return _run_task(task, "ask", profile, no_memory)
-
-
-def build(task: str, profile: Optional[str] = None, no_memory: bool = False):
-    """Run a build workflow for a project task."""
-    return _run_task(task, "build", profile, no_memory)
-
-
-def fix(task: str, profile: Optional[str] = None, no_memory: bool = False):
-    """Run a fix workflow for a code issue."""
-    return _run_task(task, "fix", profile, no_memory)
-
-
-def review(task: str, profile: Optional[str] = None, no_memory: bool = False):
-    """Review code or design with the critic pipeline."""
-    return _run_task(task, "review", profile, no_memory)
-
-
-def explain(task: str, profile: Optional[str] = None, no_memory: bool = False):
-    """Explain a technical concept or code path."""
-    return _run_task(task, "explain", profile, no_memory)
-
-
-def run(task: str, profile: Optional[str] = None, no_memory: bool = False):
-    """Execute a task using the executor agent."""
-    return _run_task(task, "run", profile, no_memory)

acra_cli-0.1.2/tests/test_cli.py

@@ -1,36 +0,0 @@
-from typer.testing import CliRunner
-
-from acra.cli import app
-import acra.commands.serve as serve_module
-
-
-def test_root_cli_exposes_brain_command():
-    runner = CliRunner()
-
-    result = runner.invoke(app, ["brain", "--help"])
-
-    assert result.exit_code == 0
-    assert "Brain management commands for acra." in result.output
-
-
-def test_brain_models_command_renders_without_crashing():
-    runner = CliRunner()
-
-    result = runner.invoke(app, ["brain", "models"])
-
-    assert result.exit_code == 0
-    assert "Models for all providers" in result.output
-
-
-def test_serve_command_launches_shell_without_subcommand(monkeypatch):
-    runner = CliRunner()
-    called = {"value": False}
-
-    def fake_launch_shell(*args, **kwargs):
-        called["value"] = True
-
-    monkeypatch.setattr(serve_module, "launch_shell", fake_launch_shell)
-    result = runner.invoke(app, ["serve"])
-
-    assert result.exit_code == 0
-    assert called["value"] is True