langstage-cli 0.5.1__tar.gz → 0.5.3__tar.gz

{langstage_cli-0.5.1/langstage_cli.egg-info → langstage_cli-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langstage-cli
-Version: 0.5.1
+Version: 0.5.3
 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.5.1 → langstage_cli-0.5.3}/langstage_cli/cli.py

@@ -998,7 +998,7 @@ def cmd_config(args: str, context: Dict[str, Any]) -> Optional[str]:
                 context["verbose"] = value.lower() in ("true", "1", "on", "yes")
                 print(f"{GREEN}✓ Set verbose = {context['verbose']}{RESET}")
             else:
-                print(f"{YELLOW}Cannot modify {key} at runtime (edit deepagents.toml){RESET}")
+                print(f"{YELLOW}Cannot modify {key} at runtime (edit langstage.toml){RESET}")
     return None
 
 
@@ -1302,6 +1302,7 @@ def run_conversation_loop(
 
 
 @click.command()
+@click.version_option(__version__, "--version", prog_name="langstage-cli")
 @click.argument("message", required=False)
 @click.option(
     "--agent",
@@ -1354,7 +1355,7 @@ def run_conversation_loop(
     "show_config",
     is_flag=True,
     default=False,
-    help="Print the resolved configuration (defaults < deepagents.toml < env < CLI) and exit",
+    help="Print the resolved configuration (defaults < langstage.toml < env < CLI) and exit",
 )
 def main(
     message: Optional[str],
@@ -1380,17 +1381,18 @@ def main(
     - package.module            (Python module path)
     - package.module:agent      (module with graph variable name)
 
-    Supports environment variables for configuration:
+    Supports environment variables for configuration (legacy DEEPAGENT_*
+    names still work as deprecated aliases):
 
     \b
-    - DEEPAGENT_AGENT_SPEC: Agent location (same formats as above).
-      (DEEPAGENT_SPEC is still accepted as a deprecated alias.)
-    - DEEPAGENT_WORKSPACE_ROOT: Working directory for the agent
-    - DEEPAGENT_STREAM_MODE: Stream mode for LangGraph (updates or values)
+    - LANGSTAGE_AGENT_SPEC: Agent location (same formats as above).
+    - LANGSTAGE_WORKSPACE_ROOT: Working directory for the agent
+    - LANGSTAGE_STREAM_MODE: Stream mode for LangGraph (updates or values)
 
-    Reads ~/.deepagents/config.toml (global) and deepagents.toml (project,
+    Reads ~/.langstage/config.toml (global) and langstage.toml (project,
     walks up from cwd). Precedence: CLI args > env vars > project TOML >
-    global TOML > built-in defaults.
+    global TOML > built-in defaults. (The legacy ~/.deepagents/config.toml and
+    deepagents.toml are still read as deprecated fallbacks.)
 
     \b
     Examples:
@@ -1401,10 +1403,6 @@ def main(
         langstage-cli --demo "try it with no API key"
         langstage-cli --show-config
     """
-    if show_config:
-        print(config_module.CodeConfig.resolve(toml_start=Path.cwd()).describe())
-        return
-
     if demo:
         if agent_spec:
             print(f"{RED}⏺ Error: --demo and -a/--agent are mutually exclusive{RESET}")
@@ -1412,6 +1410,29 @@ def main(
         # The keyless echo agent shipped with the shared core.
         agent_spec = "langgraph_stream_parser.demo.stub:graph"
 
+    # CLI flags are the highest-precedence config layer. Build the override dict
+    # ONCE and use it for both --show-config and the real run, so the diagnostic
+    # reflects exactly what a run resolves (CLI-set values then show as
+    # `[override]`, not `[default]`). Resolving --show-config without these was
+    # the bug in #20.
+    cli_overrides = {
+        "agent_spec": agent_spec,
+        "graph_name": graph_name,
+        "stream_mode": stream_mode,
+        # bool flags only override when actually passed; otherwise fall back to
+        # TOML/env/default.
+        "async_mode": True if use_async else None,
+        "verbose": True if verbose else None,
+    }
+
+    if show_config:
+        print(
+            config_module.CodeConfig.resolve(
+                toml_start=Path.cwd(), overrides=cli_overrides
+            ).describe()
+        )
+        return
+
     try:
         # Handle -f/--file option: read message from file
         if prompt_file and message:
@@ -1441,15 +1462,7 @@ def main(
         # (DEEPAGENT_AGENT_SPEC is canonical; DEEPAGENT_SPEC is a deprecated alias.)
         cfg = config_module.CodeConfig.resolve(
             toml_start=Path.cwd(),
-            overrides={
-                "agent_spec": agent_spec,
-                "graph_name": graph_name,
-                "stream_mode": stream_mode,
-                # bool flags only override when actually passed; otherwise fall
-                # back to TOML/env/default.
-                "async_mode": True if use_async else None,
-                "verbose": True if verbose else None,
-            },
+            overrides=cli_overrides,
         )
         final_spec = cfg.agent_spec
         final_graph_name_default = cfg.graph_name
@@ -1471,7 +1484,7 @@ def main(
                 print(f"\n{DIM}Usage:{RESET}")
                 print("  langstage-cli path/to/agent.py:graph")
                 print("  langstage-cli mypackage.module:agent")
-                print(f"\n{DIM}Or set DEEPAGENT_AGENT_SPEC environment variable{RESET}")
+                print(f"\n{DIM}Or set the LANGSTAGE_AGENT_SPEC environment variable{RESET}")
                 sys.exit(1)
 
         # Change to workspace root if specified

{langstage_cli-0.5.1 → langstage_cli-0.5.3/langstage_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langstage-cli
-Version: 0.5.1
+Version: 0.5.3
 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.5.1 → langstage_cli-0.5.3}/langstage_cli.egg-info/SOURCES.txt

@@ -12,6 +12,8 @@ langstage_cli.egg-info/entry_points.txt
 langstage_cli.egg-info/requires.txt
 langstage_cli.egg-info/top_level.txt
 tests/test_cli.py
+tests/test_cli_help.py
 tests/test_codeconfig.py
 tests/test_config.py
-tests/test_rename_shim.py
+tests/test_rename_shim.py
+tests/test_show_config.py

{langstage_cli-0.5.1 → langstage_cli-0.5.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "langstage-cli"
-version = "0.5.1"
+version = "0.5.3"
 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.5.3/tests/test_cli_help.py

@@ -0,0 +1,27 @@
+"""Regression tests for #22: user-facing strings use the canonical LANGSTAGE_*
+names, and a `--version` flag exists.
+"""
+
+from click.testing import CliRunner
+
+from langstage_cli.cli import main
+
+
+def test_version_flag_exists():
+    r = CliRunner().invoke(main, ["--version"])
+    assert r.exit_code == 0, r.output
+    assert "langstage-cli" in r.output
+    assert "0.0.0" not in r.output  # reports the real version, not the fallback
+
+
+def test_help_leads_with_canonical_names():
+    r = CliRunner().invoke(main, ["--help"])
+    assert r.exit_code == 0, r.output
+    out = r.output
+    # canonical LANGSTAGE_* / langstage.toml are present...
+    assert "LANGSTAGE_AGENT_SPEC" in out
+    assert "LANGSTAGE_WORKSPACE_ROOT" in out
+    assert "LANGSTAGE_STREAM_MODE" in out
+    assert "langstage.toml" in out
+    # ...and the legacy names are no longer presented as the only config vocab
+    assert "DEEPAGENT_AGENT_SPEC" not in out

langstage_cli-0.5.3/tests/test_show_config.py

@@ -0,0 +1,47 @@
+"""Regression tests for #20: `--show-config` must reflect CLI flags.
+
+Before the fix, the --show-config branch resolved config WITHOUT the CLI
+overrides, so flags showed as `[default]` and the reported source could
+contradict the real run.
+"""
+
+import re
+
+from click.testing import CliRunner
+
+from langstage_cli.cli import main
+
+
+def test_show_config_reflects_cli_flags():
+    with CliRunner().isolated_filesystem():  # no stray toml
+        r = CliRunner().invoke(
+            main, ["-a", "fromcli.py:graph", "-v", "--stream-mode", "values", "--show-config"]
+        )
+    assert r.exit_code == 0, r.output
+    # CLI-set values appear with the [override] source, not [default].
+    assert re.search(r"agent_spec\s*=\s*fromcli\.py:graph\s*\[override\]", r.output), r.output
+    assert re.search(r"stream_mode\s*=\s*values\s*\[override\]", r.output), r.output
+    assert re.search(r"verbose\s*=\s*True\s*\[override\]", r.output), r.output
+
+
+def test_show_config_cli_flag_beats_env():
+    with CliRunner().isolated_filesystem():
+        r = CliRunner().invoke(
+            main,
+            ["-a", "fromcli.py:graph", "--show-config"],
+            env={"LANGSTAGE_AGENT_SPEC": "fromenv.py:graph"},
+        )
+    assert r.exit_code == 0, r.output
+    # the CLI flag wins (matches what a real run does), not the env var
+    assert re.search(r"agent_spec\s*=\s*fromcli\.py:graph\s*\[override\]", r.output), r.output
+    assert "fromenv.py:graph" not in r.output.split("agent_spec")[1].split("\n")[0]
+
+
+def test_show_config_without_flags_still_reports_env():
+    with CliRunner().isolated_filesystem():
+        r = CliRunner().invoke(
+            main, ["--show-config"], env={"LANGSTAGE_AGENT_SPEC": "fromenv.py:graph"}
+        )
+    assert r.exit_code == 0, r.output
+    # no flags → env is correctly the winning source (no regression)
+    assert re.search(r"agent_spec\s*=\s*fromenv\.py:graph\s*\[env:", r.output), r.output