langstage-cli 0.6.45__tar.gz → 0.6.46__tar.gz

{langstage_cli-0.6.45/langstage_cli.egg-info → langstage_cli-0.6.46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langstage-cli
-Version: 0.6.45
+Version: 0.6.46
 Summary: The terminal stage for your LangGraph agent — Claude Code-style CLI for any CompiledGraph
 Author-email: Kedar Dabhadkar <kdabhadk@gmail.com>
 License-Expression: MIT

{langstage_cli-0.6.45 → langstage_cli-0.6.46}/langstage_cli/cli.py

@@ -1001,6 +1001,15 @@ def _default_agent_path() -> Optional[Path]:
     return path if path.exists() else None
 
 
+# A MESSAGE that is really an agent spec: ``my_agent.py:graph`` or ``pkg.module:agent``.
+_SPEC_LIKE = re.compile(r"^(?:(?:[A-Za-z]:)?[^\s:]+\.py|[A-Za-z_][\w.]*):[A-Za-z_]\w*$")
+
+
+def _looks_like_agent_spec(message: Optional[str]) -> bool:
+    """Whether a positional MESSAGE looks like an agent spec meant for ``-a`` (gh #186)."""
+    return bool(message) and bool(_SPEC_LIKE.match(message.strip()))
+
+
 def _no_agent_toml_hint(cfg: Any, toml_sources: list) -> List[str]:
     """Lines explaining why a ``langstage.toml`` that was read supplied no spec (gh #148).
 
@@ -3468,10 +3477,18 @@ def main(
                 # of only pointing at the env var (gh #148).
                 for line in _no_agent_toml_hint(cfg, toml_sources):
                     _status(f"{YELLOW}{line}{RESET}")
+                # The spec went in as the MESSAGE: name the command that works (gh #186).
+                if _looks_like_agent_spec(message):
+                    _status(
+                        f"{YELLOW}The agent spec goes after -a: langstage-cli -a {message.strip()}{RESET}"
+                    )
                 _status(f"\n{DIM}Usage:{RESET}")
-                _status("  langstage-cli path/to/agent.py:graph")
-                _status("  langstage-cli mypackage.module:agent")
-                _status(f"\n{DIM}Or set the LANGSTAGE_AGENT_SPEC environment variable{RESET}")
+                _status("  langstage-cli -a path/to/agent.py:graph")
+                _status("  langstage-cli -a mypackage.module:agent")
+                _status(
+                    f"\n{DIM}Or set LANGSTAGE_AGENT_SPEC, put the spec under [agent] spec in "
+                    f"langstage.toml, or run `langstage-cli init` for a starter agent{RESET}"
+                )
                 sys.exit(1)
 
         # The BASE directory a relative spec resolves against depends on WHERE it came

{langstage_cli-0.6.45 → langstage_cli-0.6.46/langstage_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langstage-cli
-Version: 0.6.45
+Version: 0.6.46
 Summary: The terminal stage for your LangGraph agent — Claude Code-style CLI for any CompiledGraph
 Author-email: Kedar Dabhadkar <kdabhadk@gmail.com>
 License-Expression: MIT

{langstage_cli-0.6.45 → langstage_cli-0.6.46}/langstage_cli.egg-info/SOURCES.txt

@@ -64,6 +64,7 @@ tests/test_tool_output_escape.py
 tests/test_turn_error_verbose.py
 tests/test_turn_exit_and_render.py
 tests/test_unicode_console.py
+tests/test_usage_hint_186.py
 tests/test_verbose_command.py
 tests/test_verify_flag.py
 tests/test_workspace.py

{langstage_cli-0.6.45 → langstage_cli-0.6.46}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "langstage-cli"
-version = "0.6.45"
+version = "0.6.46"
 description = "The terminal stage for your LangGraph agent — Claude Code-style CLI for any CompiledGraph"
 readme = "README.md"
 requires-python = ">=3.11"

langstage_cli-0.6.46/tests/test_usage_hint_186.py

@@ -0,0 +1,52 @@
+"""gh #186: the "No agent specified" hint shows commands that work (with -a)."""
+
+import pytest
+from click.testing import CliRunner
+
+from langstage_cli import cli
+from langstage_cli.cli import _looks_like_agent_spec, main
+
+
+@pytest.fixture
+def no_agent(tmp_path, monkeypatch):
+    monkeypatch.chdir(tmp_path)
+    for var in ("LANGSTAGE_AGENT_SPEC", "DEEPAGENT_AGENT_SPEC", "DEEPAGENT_SPEC"):
+        monkeypatch.delenv(var, raising=False)
+    monkeypatch.setattr(cli, "_default_agent_path", lambda: None)
+
+
+def test_usage_hint_uses_dash_a(no_agent):
+    r = CliRunner().invoke(main, ["hi"])
+    assert r.exit_code == 1, r.output
+    assert "No agent specified" in r.output
+    assert "langstage-cli -a path/to/agent.py:graph" in r.output
+    assert "langstage-cli -a mypackage.module:agent" in r.output
+    assert "[agent] spec" in r.output and "langstage-cli init" in r.output
+    # Not a spec-looking message: no "goes after -a" line.
+    assert "goes after -a" not in r.output
+
+
+@pytest.mark.parametrize("spec", ["my_agent.py:graph", "mypackage.module:agent"])
+def test_spec_passed_as_message_names_the_working_command(no_agent, spec):
+    r = CliRunner().invoke(main, [spec])
+    assert r.exit_code == 1, r.output
+    assert f"The agent spec goes after -a: langstage-cli -a {spec}" in r.output
+
+
+@pytest.mark.parametrize(
+    "message,expected",
+    [
+        ("my_agent.py:graph", True),
+        ("./agents/a.py:graph", True),
+        (r"C:\work\agent.py:graph", True),
+        ("pkg.module:agent", True),
+        ("hello", False),
+        ("what is 2:3", False),
+        ("ratio 3:1 please", False),
+        ("http://example.org:80", False),
+        ("", False),
+        (None, False),
+    ],
+)
+def test_looks_like_agent_spec(message, expected):
+    assert _looks_like_agent_spec(message) is expected