langstage-cli 0.5.4__tar.gz → 0.5.6__tar.gz

{langstage_cli-0.5.4/langstage_cli.egg-info → langstage_cli-0.5.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langstage-cli
-Version: 0.5.4
+Version: 0.5.6
 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
@@ -19,7 +19,7 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: langgraph>=0.2.0
-Requires-Dist: langgraph-stream-parser<0.5,>=0.3
+Requires-Dist: langgraph-stream-parser<0.7,>=0.6.6
 Requires-Dist: click>=8.0.0
 Requires-Dist: python-dotenv
 Provides-Extra: dev
@@ -30,7 +30,7 @@ Requires-Dist: ruff==0.15.15; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: deepagents>=0.3; extra == "dev"
 Provides-Extra: agui
-Requires-Dist: langgraph-stream-parser[agui]<0.5,>=0.4; extra == "agui"
+Requires-Dist: langgraph-stream-parser[agui]<0.7,>=0.6.6; extra == "agui"
 Dynamic: license-file
 
 # langstage-cli
@@ -146,7 +146,7 @@ langstage-cli
 # Working directory
 export LANGSTAGE_WORKSPACE_ROOT="/path/to/workspace"
 
-# Stream mode (updates or values)
+# Stream mode (updates or messages)
 export LANGSTAGE_STREAM_MODE="updates"
 ```
 
@@ -169,7 +169,9 @@ Example `langstage.toml`:
 ```toml
 [agent]
 spec = "my_agent.py:graph"
-workspace_root = "."
+
+[workspace]
+root = "."
 
 [ui]
 verbose = true
@@ -195,7 +197,8 @@ Options:
   -f, --file PATH                 Read message from a file (any extension)
   --interactive/--no-interactive  Handle interrupts (default: interactive)
   --async-mode/--sync-mode        Async streaming (default: sync)
-  --stream-mode TEXT              Stream mode (updates or values)
+  --stream-mode [updates|messages]
+                                  Stream mode (default: updates)
   -v, --verbose                   Verbose output
 ```
 

{langstage_cli-0.5.4 → langstage_cli-0.5.6}/README.md

@@ -111,7 +111,7 @@ langstage-cli
 # Working directory
 export LANGSTAGE_WORKSPACE_ROOT="/path/to/workspace"
 
-# Stream mode (updates or values)
+# Stream mode (updates or messages)
 export LANGSTAGE_STREAM_MODE="updates"
 ```
 
@@ -134,7 +134,9 @@ Example `langstage.toml`:
 ```toml
 [agent]
 spec = "my_agent.py:graph"
-workspace_root = "."
+
+[workspace]
+root = "."
 
 [ui]
 verbose = true
@@ -160,7 +162,8 @@ Options:
   -f, --file PATH                 Read message from a file (any extension)
   --interactive/--no-interactive  Handle interrupts (default: interactive)
   --async-mode/--sync-mode        Async streaming (default: sync)
-  --stream-mode TEXT              Stream mode (updates or values)
+  --stream-mode [updates|messages]
+                                  Stream mode (default: updates)
   -v, --verbose                   Verbose output
 ```
 

{langstage_cli-0.5.4 → langstage_cli-0.5.6}/langstage_cli/cli.py

@@ -190,11 +190,15 @@ class Spinner:
             frame = SPINNER_FRAMES[self.frame_idx % len(SPINNER_FRAMES)]
             elapsed = time.time() - self.start_time
             elapsed_str = f"{int(elapsed)}s"
-            print(
-                f"\r{CYAN}{frame}{RESET} {DIM}{self.message}... {elapsed_str}{RESET}",
-                end="",
-                flush=True,
-            )
+            # Never let a stdout hiccup in this daemon thread crash the run.
+            try:
+                print(
+                    f"\r{CYAN}{frame}{RESET} {DIM}{self.message}... {elapsed_str}{RESET}",
+                    end="",
+                    flush=True,
+                )
+            except (UnicodeEncodeError, ValueError):
+                pass
             self.frame_idx += 1
             time.sleep(0.08)
 
@@ -751,25 +755,26 @@ async def run_single_turn_async(
         spinner = Spinner("Thinking")
         spinner.start()
 
-        async for chunk in astream_graph_updates(
-            graph, input_data, config=config, stream_mode=stream_mode
-        ):
-            # Stop spinner on first chunk
-            if first_chunk:
-                spinner.stop()
-                first_chunk = False
-
-            print_chunk(chunk, verbose=verbose)
-
-            if chunk.get("status") == "interrupt":
-                has_interrupt = True
-                # Count pending action requests
-                interrupt_data = chunk.get("interrupt", {})
-                action_requests = interrupt_data.get("action_requests", [])
-                num_pending_actions = len(action_requests) if action_requests else 1
-
-        # Ensure spinner is stopped even if no chunks received
-        if first_chunk:
+        try:
+            async for chunk in astream_graph_updates(
+                graph, input_data, config=config, stream_mode=stream_mode
+            ):
+                # Stop spinner on first chunk
+                if first_chunk:
+                    spinner.stop()
+                    first_chunk = False
+
+                print_chunk(chunk, verbose=verbose)
+
+                if chunk.get("status") == "interrupt":
+                    has_interrupt = True
+                    # Count pending action requests
+                    interrupt_data = chunk.get("interrupt", {})
+                    action_requests = interrupt_data.get("action_requests", [])
+                    num_pending_actions = len(action_requests) if action_requests else 1
+        finally:
+            # Always stop the spinner (see sync variant) so a streaming error
+            # can't leave a daemon thread holding stdout at interpreter shutdown.
             spinner.stop()
 
         if has_interrupt and interactive:
@@ -800,25 +805,27 @@ def run_single_turn_sync(
         spinner = Spinner("Thinking")
         spinner.start()
 
-        for chunk in stream_graph_updates(
-            graph, input_data, config=config, stream_mode=stream_mode
-        ):
-            # Stop spinner on first chunk
-            if first_chunk:
-                spinner.stop()
-                first_chunk = False
-
-            print_chunk(chunk, verbose=verbose)
-
-            if chunk.get("status") == "interrupt":
-                has_interrupt = True
-                # Count pending action requests
-                interrupt_data = chunk.get("interrupt", {})
-                action_requests = interrupt_data.get("action_requests", [])
-                num_pending_actions = len(action_requests) if action_requests else 1
-
-        # Ensure spinner is stopped even if no chunks received
-        if first_chunk:
+        try:
+            for chunk in stream_graph_updates(
+                graph, input_data, config=config, stream_mode=stream_mode
+            ):
+                # Stop spinner on first chunk
+                if first_chunk:
+                    spinner.stop()
+                    first_chunk = False
+
+                print_chunk(chunk, verbose=verbose)
+
+                if chunk.get("status") == "interrupt":
+                    has_interrupt = True
+                    # Count pending action requests
+                    interrupt_data = chunk.get("interrupt", {})
+                    action_requests = interrupt_data.get("action_requests", [])
+                    num_pending_actions = len(action_requests) if action_requests else 1
+        finally:
+            # Always stop the spinner — if the stream raises, an unstopped daemon
+            # spinner thread holds stdout at interpreter shutdown, which crashes
+            # with "Fatal Python error: _enter_buffered_busy".
             spinner.stop()
 
         if has_interrupt and interactive:
@@ -1335,7 +1342,8 @@ def run_conversation_loop(
 )
 @click.option(
     "--stream-mode",
-    help="Stream mode for LangGraph (default: 'updates')",
+    type=click.Choice(["updates", "messages"]),
+    help="Stream mode: 'updates' (default) or 'messages' (token-level).",
 )
 @click.option(
     "--verbose",
@@ -1348,7 +1356,7 @@ def run_conversation_loop(
     "--demo",
     is_flag=True,
     default=False,
-    help="Run with the built-in keyless demo agent — no API key needed",
+    help="Run with the built-in keyless demo agent (no API key needed)",
 )
 @click.option(
     "--show-config",
@@ -1387,7 +1395,7 @@ def main(
     \b
     - 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)
+    - LANGSTAGE_STREAM_MODE: Stream mode for LangGraph (updates or messages)
 
     Reads ~/.langstage/config.toml (global) and langstage.toml (project,
     walks up from cwd). Precedence: CLI args > env vars > project TOML >
@@ -1403,6 +1411,16 @@ def main(
         langstage-cli --demo "try it with no API key"
         langstage-cli --show-config
     """
+    # Windows consoles default to cp1252, where the spinner (Braille frames) and
+    # status glyphs (✓ ⏺ —) raise UnicodeEncodeError — the documented
+    # `langstage-cli --demo "hello"` one-liner crashed before any output. Force
+    # UTF-8 with errors="replace" so a glyph can never crash the process.
+    for _stream in (sys.stdout, sys.stderr):
+        try:
+            _stream.reconfigure(encoding="utf-8", errors="replace")
+        except (AttributeError, ValueError):  # non-reconfigurable stream
+            pass
+
     if demo:
         if agent_spec:
             print(f"{RED}⏺ Error: --demo and -a/--agent are mutually exclusive{RESET}")
@@ -1467,6 +1485,15 @@ def main(
         final_spec = cfg.agent_spec
         final_graph_name_default = cfg.graph_name
         final_stream_mode = cfg.stream_mode
+        # The CLI's render path only supports 'updates' / 'messages'. Reject anything
+        # else (e.g. LANGSTAGE_STREAM_MODE=values, which bypasses the flag's Choice)
+        # with a clean error instead of a fatal crash deep in the stream worker.
+        if final_stream_mode not in ("updates", "messages"):
+            print(
+                f"{RED}⏺ Error: unsupported stream mode {final_stream_mode!r} "
+                f"(use 'updates' or 'messages'){RESET}"
+            )
+            sys.exit(2)
         use_async = cfg.async_mode
         verbose = cfg.verbose
         # Only change directory when a workspace root was actually configured.

{langstage_cli-0.5.4 → langstage_cli-0.5.6/langstage_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langstage-cli
-Version: 0.5.4
+Version: 0.5.6
 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
@@ -19,7 +19,7 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: langgraph>=0.2.0
-Requires-Dist: langgraph-stream-parser<0.5,>=0.3
+Requires-Dist: langgraph-stream-parser<0.7,>=0.6.6
 Requires-Dist: click>=8.0.0
 Requires-Dist: python-dotenv
 Provides-Extra: dev
@@ -30,7 +30,7 @@ Requires-Dist: ruff==0.15.15; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: deepagents>=0.3; extra == "dev"
 Provides-Extra: agui
-Requires-Dist: langgraph-stream-parser[agui]<0.5,>=0.4; extra == "agui"
+Requires-Dist: langgraph-stream-parser[agui]<0.7,>=0.6.6; extra == "agui"
 Dynamic: license-file
 
 # langstage-cli
@@ -146,7 +146,7 @@ langstage-cli
 # Working directory
 export LANGSTAGE_WORKSPACE_ROOT="/path/to/workspace"
 
-# Stream mode (updates or values)
+# Stream mode (updates or messages)
 export LANGSTAGE_STREAM_MODE="updates"
 ```
 
@@ -169,7 +169,9 @@ Example `langstage.toml`:
 ```toml
 [agent]
 spec = "my_agent.py:graph"
-workspace_root = "."
+
+[workspace]
+root = "."
 
 [ui]
 verbose = true
@@ -195,7 +197,8 @@ Options:
   -f, --file PATH                 Read message from a file (any extension)
   --interactive/--no-interactive  Handle interrupts (default: interactive)
   --async-mode/--sync-mode        Async streaming (default: sync)
-  --stream-mode TEXT              Stream mode (updates or values)
+  --stream-mode [updates|messages]
+                                  Stream mode (default: updates)
   -v, --verbose                   Verbose output
 ```
 

{langstage_cli-0.5.4 → langstage_cli-0.5.6}/langstage_cli.egg-info/SOURCES.txt

@@ -16,4 +16,6 @@ tests/test_cli_help.py
 tests/test_codeconfig.py
 tests/test_config.py
 tests/test_rename_shim.py
-tests/test_show_config.py
+tests/test_show_config.py
+tests/test_stream_mode.py
+tests/test_unicode_console.py

{langstage_cli-0.5.4 → langstage_cli-0.5.6}/langstage_cli.egg-info/requires.txt

@@ -1,10 +1,10 @@
 langgraph>=0.2.0
-langgraph-stream-parser<0.5,>=0.3
+langgraph-stream-parser<0.7,>=0.6.6
 click>=8.0.0
 python-dotenv
 
 [agui]
-langgraph-stream-parser[agui]<0.5,>=0.4
+langgraph-stream-parser[agui]<0.7,>=0.6.6
 
 [dev]
 pytest>=7.0.0

{langstage_cli-0.5.4 → langstage_cli-0.5.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "langstage-cli"
-version = "0.5.4"
+version = "0.5.6"
 description = "The terminal stage for your LangGraph agent — Claude Code-style CLI for any CompiledGraph"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -25,7 +25,9 @@ classifiers = [
 
 dependencies = [
     "langgraph>=0.2.0",
-    "langgraph-stream-parser>=0.3,<0.5",
+    # >=0.6.6 modernizes off the stale <0.5 pin and carries the dict-form-message
+    # fix, so a CompiledGraph returning {"role":...,"content":...} renders (gh #-dogfood).
+    "langgraph-stream-parser>=0.6.6,<0.7",
     "click>=8.0.0",
     "python-dotenv",
 ]
@@ -43,7 +45,7 @@ dev = [
     # pull deepagents + langchain + langgraph.
     "deepagents>=0.3",
 ]
-agui = ["langgraph-stream-parser[agui]>=0.4,<0.5"]
+agui = ["langgraph-stream-parser[agui]>=0.6.6,<0.7"]
 
 [project.scripts]
 langstage-cli = "langstage_cli.cli:main"

{langstage_cli-0.5.4 → langstage_cli-0.5.6}/tests/test_show_config.py

@@ -15,12 +15,12 @@ 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"]
+            main, ["-a", "fromcli.py:graph", "-v", "--stream-mode", "messages", "--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"stream_mode\s*=\s*messages\s*\[override\]", r.output), r.output
     assert re.search(r"verbose\s*=\s*True\s*\[override\]", r.output), r.output
 
 

langstage_cli-0.5.6/tests/test_stream_mode.py

@@ -0,0 +1,36 @@
+"""--stream-mode validation (gh #-dogfood).
+
+`values` was advertised but unsupported by the CLI's render path; passing it
+crashed with a fatal interpreter-shutdown error (a ValueError surfaced while the
+spinner daemon thread held stdout). Now: the flag is a Choice {updates,messages},
+and the resolved value (incl. LANGSTAGE_STREAM_MODE, which bypasses the flag) is
+validated up front with a clean error.
+"""
+
+from click.testing import CliRunner
+
+from langstage_cli.cli import main
+
+
+def test_stream_mode_values_flag_rejected_cleanly():
+    r = CliRunner().invoke(main, ["--demo", "--no-interactive", "--stream-mode", "values", "hi"])
+    assert r.exit_code != 0
+    assert "values" in r.output
+    assert "Fatal" not in r.output  # no interpreter-shutdown crash
+
+
+def test_stream_mode_messages_flag_accepted():
+    # A valid mode must still be accepted by the Choice (parses, doesn't error on the flag).
+    r = CliRunner().invoke(main, ["--stream-mode", "messages", "--show-config"])
+    assert r.exit_code == 0, r.output
+    assert "messages" in r.output
+
+
+def test_stream_mode_values_via_env_rejected():
+    r = CliRunner().invoke(
+        main,
+        ["--demo", "--no-interactive", "hi"],
+        env={"LANGSTAGE_STREAM_MODE": "values"},
+    )
+    assert r.exit_code == 2, r.output
+    assert "unsupported stream mode" in r.output.lower()

langstage_cli-0.5.6/tests/test_unicode_console.py

@@ -0,0 +1,31 @@
+"""Regression: the headline `langstage-cli --demo` must not crash on a non-UTF-8
+console (Windows cp1252).
+
+The spinner (Braille frames) and status glyphs (✓ ⏺) raised UnicodeEncodeError on
+a default Windows console, so the documented one-liner crashed before output.
+`main()` now reconfigures stdio to UTF-8 (errors="replace"). We force `cp1252`
+via PYTHONIOENCODING so this reproduces on any platform — without the fix this
+test exits non-zero with a UnicodeEncodeError traceback.
+"""
+
+import os
+import subprocess
+import sys
+
+
+def test_demo_runs_on_cp1252_console():
+    env = dict(os.environ)
+    env["PYTHONIOENCODING"] = "cp1252"
+    env.pop("PYTHONUTF8", None)
+    proc = subprocess.run(
+        [sys.executable, "-c", "from langstage_cli.cli import main; main()", "--demo", "hello"],
+        capture_output=True,
+        text=True,
+        encoding="utf-8",
+        errors="replace",
+        env=env,
+    )
+    assert proc.returncode == 0, f"stdout={proc.stdout!r}\nstderr={proc.stderr!r}"
+    assert "UnicodeEncodeError" not in proc.stderr, proc.stderr
+    # The demo stub echoes the input back.
+    assert "demo agent" in proc.stdout.lower() or "hello" in proc.stdout.lower(), proc.stdout