langstage-cli 0.0.1__tar.gz → 0.5.0__tar.gz

langstage_cli-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 deepagent-code contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

langstage_cli-0.5.0/PKG-INFO

@@ -0,0 +1,237 @@
+Metadata-Version: 2.4
+Name: langstage-cli
+Version: 0.5.0
+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
+Project-URL: Homepage, https://github.com/dkedar7/langstage-cli
+Project-URL: Repository, https://github.com/dkedar7/langstage-cli
+Project-URL: Issues, https://github.com/dkedar7/langstage-cli/issues
+Keywords: langgraph,langchain,langstage,cli,agents,llm,ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+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: click>=8.0.0
+Requires-Dist: python-dotenv
+Requires-Dist: deepagents
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff==0.15.15; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: agui
+Requires-Dist: langgraph-stream-parser[agui]<0.5,>=0.4; extra == "agui"
+Dynamic: license-file
+
+# langstage-cli
+
+**The terminal stage for your LangGraph agent.** A Claude Code-style CLI that runs *any* LangGraph `CompiledGraph` — yours, not a bundled one — with streaming, tool-call rendering, and human-in-the-loop approval.
+
+> Renamed from **deepagent-code** (the old package name now just installs this one, and the `deepagent-code` command still works).
+
+![langstage-cli](examples/image.png)
+
+## Every stage for your LangGraph agent
+
+langstage-cli is the terminal stage of the **LangStage family**: write your agent once — any LangGraph `CompiledGraph` — and run it on every stage with the same spec string (`module:attr` or `path/to/file.py:attr`), the same `langstage.toml` config file, and the same `LANGSTAGE_*` environment variables.
+
+| Stage | Package | Try it |
+|---|---|---|
+| Web app | [langstage](https://github.com/dkedar7/langstage) | `langstage run --agent my_agent.py:graph` |
+| JupyterLab | [langstage-jupyter](https://github.com/dkedar7/langstage-jupyter) | `pip install langstage-jupyter`, then the chat sidebar in `jupyter lab` |
+| Terminal | langstage-cli | **you are here** |
+| VS Code | [langstage-vscode](https://github.com/dkedar7/langstage-vscode) | chat participant + stdio sidecar |
+| Reference agent | [langstage-hermes](https://github.com/dkedar7/langstage-hermes) | `LANGSTAGE_AGENT_SPEC=langstage_hermes.agent:graph` on any stage |
+| Shared core | [langgraph-stream-parser](https://github.com/dkedar7/langgraph-stream-parser) | typed events + config resolver behind every stage |
+
+📖 **Full documentation:** <https://dkedar7.github.io/langstage-docs/>
+
+### Serve over AG-UI
+
+This surface's agent — any LangGraph `CompiledGraph` — can also be served over the [AG-UI protocol](https://github.com/dkedar7/langgraph-stream-parser):
+
+```bash
+pip install "langgraph-stream-parser[agui]"
+langstage-agui --agent my_agent.py:graph
+```
+
+## Installation
+
+```bash
+pip install langstage-cli
+```
+
+Or install directly from GitHub:
+```bash
+pip install git+https://github.com/dkedar7/langstage-cli.git
+```
+
+## Quick Start
+
+No agent or API key yet? See the CLI working in one command:
+```bash
+langstage-cli --demo "hello"
+```
+
+Run with the default agent (requires `ANTHROPIC_API_KEY`):
+```bash
+export ANTHROPIC_API_KEY="your_api_key"
+langstage-cli
+```
+
+Or specify your own agent:
+```bash
+langstage-cli -a path/to/your_agent.py:graph
+```
+
+This launches an interactive conversation loop with your agent.
+
+## Usage
+
+```bash
+# Use the default agent
+langstage-cli
+
+# Send a message directly
+langstage-cli "Hello, agent!"
+
+# Specify a custom agent file
+langstage-cli -a my_agent.py:graph
+
+# Use a module path
+langstage-cli -a mypackage.agents:chatbot
+
+# Read message from a file
+langstage-cli -f ./prompt.md
+
+# Non-interactive mode (auto-approve tool calls)
+langstage-cli --no-interactive
+
+# Verbose output
+langstage-cli -v
+
+# Keyless demo agent (no API key needed)
+langstage-cli --demo
+
+# Print the resolved configuration: each value, its source, and the
+# env var / langstage.toml key that sets it
+langstage-cli --show-config
+```
+
+## Commands
+
+In the interactive loop:
+- `/q` or `/quit` - Exit
+- `/c` - Clear conversation history
+- `/h` or `/help` - Show help
+
+## Environment Variables
+
+```bash
+# Agent location (path/to/file.py:variable_name or module:variable)
+# (DEEPAGENT_AGENT_SPEC / DEEPAGENT_SPEC still accepted as deprecated aliases)
+export LANGSTAGE_AGENT_SPEC="my_agent.py:graph"
+langstage-cli
+
+# Working directory
+export LANGSTAGE_WORKSPACE_ROOT="/path/to/workspace"
+
+# Stream mode (updates or values)
+export LANGSTAGE_STREAM_MODE="updates"
+```
+
+## Configuration Files
+
+`langstage-cli` reads TOML config from two locations and merges them
+(project overrides global):
+
+- **Global**: `~/.langstage/config.toml`
+- **Project**: `langstage.toml` in the current directory or any ancestor
+
+Legacy locations (`~/.deepagents/config.toml`, `deepagents.toml`) are still
+read as fallbacks; move your config when convenient — `~/.deepagents/` now
+belongs to LangChain's `dcode`.
+
+Precedence: CLI args > env vars > project TOML > global TOML > defaults.
+
+Example `langstage.toml`:
+
+```toml
+[agent]
+spec = "my_agent.py:graph"
+workspace_root = "."
+
+[ui]
+verbose = true
+async_mode = false
+stream_mode = "updates"
+
+[configurable]
+# seeds LangGraph RunnableConfig.configurable
+thread_id = "my-thread"
+```
+
+## CLI Options
+
+```
+Usage: langstage-cli [OPTIONS] [MESSAGE]
+
+Arguments:
+  MESSAGE  Optional input to send to the agent immediately
+
+Options:
+  -a, --agent TEXT                Agent spec (path/to/file.py:graph or module:graph)
+  -g, --graph-name TEXT           Graph variable name (default: "graph")
+  -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)
+  -v, --verbose                   Verbose output
+```
+
+## Creating Your Own Agent
+
+Your agent file should export a compiled LangGraph graph:
+
+```python
+# my_agent.py
+from deepagents import create_deep_agent
+from langgraph.checkpoint.memory import MemorySaver
+
+agent = create_deep_agent(
+    name="My Agent",
+    model="anthropic:claude-sonnet-4-20250514",
+    checkpointer=MemorySaver(),
+)
+```
+
+Then run it:
+```bash
+langstage-cli -a my_agent.py:agent
+```
+
+## Programmatic Use
+
+```python
+from langstage_cli import stream_graph_updates, prepare_agent_input
+
+input_data = prepare_agent_input(message="Hello!")
+
+for chunk in stream_graph_updates(graph, input_data):
+    if chunk.get("chunk"):
+        print(chunk["chunk"], end="")
+```
+
+## License
+
+MIT License - see LICENSE file for details.

langstage_cli-0.5.0/README.md

@@ -0,0 +1,202 @@
+# langstage-cli
+
+**The terminal stage for your LangGraph agent.** A Claude Code-style CLI that runs *any* LangGraph `CompiledGraph` — yours, not a bundled one — with streaming, tool-call rendering, and human-in-the-loop approval.
+
+> Renamed from **deepagent-code** (the old package name now just installs this one, and the `deepagent-code` command still works).
+
+![langstage-cli](examples/image.png)
+
+## Every stage for your LangGraph agent
+
+langstage-cli is the terminal stage of the **LangStage family**: write your agent once — any LangGraph `CompiledGraph` — and run it on every stage with the same spec string (`module:attr` or `path/to/file.py:attr`), the same `langstage.toml` config file, and the same `LANGSTAGE_*` environment variables.
+
+| Stage | Package | Try it |
+|---|---|---|
+| Web app | [langstage](https://github.com/dkedar7/langstage) | `langstage run --agent my_agent.py:graph` |
+| JupyterLab | [langstage-jupyter](https://github.com/dkedar7/langstage-jupyter) | `pip install langstage-jupyter`, then the chat sidebar in `jupyter lab` |
+| Terminal | langstage-cli | **you are here** |
+| VS Code | [langstage-vscode](https://github.com/dkedar7/langstage-vscode) | chat participant + stdio sidecar |
+| Reference agent | [langstage-hermes](https://github.com/dkedar7/langstage-hermes) | `LANGSTAGE_AGENT_SPEC=langstage_hermes.agent:graph` on any stage |
+| Shared core | [langgraph-stream-parser](https://github.com/dkedar7/langgraph-stream-parser) | typed events + config resolver behind every stage |
+
+📖 **Full documentation:** <https://dkedar7.github.io/langstage-docs/>
+
+### Serve over AG-UI
+
+This surface's agent — any LangGraph `CompiledGraph` — can also be served over the [AG-UI protocol](https://github.com/dkedar7/langgraph-stream-parser):
+
+```bash
+pip install "langgraph-stream-parser[agui]"
+langstage-agui --agent my_agent.py:graph
+```
+
+## Installation
+
+```bash
+pip install langstage-cli
+```
+
+Or install directly from GitHub:
+```bash
+pip install git+https://github.com/dkedar7/langstage-cli.git
+```
+
+## Quick Start
+
+No agent or API key yet? See the CLI working in one command:
+```bash
+langstage-cli --demo "hello"
+```
+
+Run with the default agent (requires `ANTHROPIC_API_KEY`):
+```bash
+export ANTHROPIC_API_KEY="your_api_key"
+langstage-cli
+```
+
+Or specify your own agent:
+```bash
+langstage-cli -a path/to/your_agent.py:graph
+```
+
+This launches an interactive conversation loop with your agent.
+
+## Usage
+
+```bash
+# Use the default agent
+langstage-cli
+
+# Send a message directly
+langstage-cli "Hello, agent!"
+
+# Specify a custom agent file
+langstage-cli -a my_agent.py:graph
+
+# Use a module path
+langstage-cli -a mypackage.agents:chatbot
+
+# Read message from a file
+langstage-cli -f ./prompt.md
+
+# Non-interactive mode (auto-approve tool calls)
+langstage-cli --no-interactive
+
+# Verbose output
+langstage-cli -v
+
+# Keyless demo agent (no API key needed)
+langstage-cli --demo
+
+# Print the resolved configuration: each value, its source, and the
+# env var / langstage.toml key that sets it
+langstage-cli --show-config
+```
+
+## Commands
+
+In the interactive loop:
+- `/q` or `/quit` - Exit
+- `/c` - Clear conversation history
+- `/h` or `/help` - Show help
+
+## Environment Variables
+
+```bash
+# Agent location (path/to/file.py:variable_name or module:variable)
+# (DEEPAGENT_AGENT_SPEC / DEEPAGENT_SPEC still accepted as deprecated aliases)
+export LANGSTAGE_AGENT_SPEC="my_agent.py:graph"
+langstage-cli
+
+# Working directory
+export LANGSTAGE_WORKSPACE_ROOT="/path/to/workspace"
+
+# Stream mode (updates or values)
+export LANGSTAGE_STREAM_MODE="updates"
+```
+
+## Configuration Files
+
+`langstage-cli` reads TOML config from two locations and merges them
+(project overrides global):
+
+- **Global**: `~/.langstage/config.toml`
+- **Project**: `langstage.toml` in the current directory or any ancestor
+
+Legacy locations (`~/.deepagents/config.toml`, `deepagents.toml`) are still
+read as fallbacks; move your config when convenient — `~/.deepagents/` now
+belongs to LangChain's `dcode`.
+
+Precedence: CLI args > env vars > project TOML > global TOML > defaults.
+
+Example `langstage.toml`:
+
+```toml
+[agent]
+spec = "my_agent.py:graph"
+workspace_root = "."
+
+[ui]
+verbose = true
+async_mode = false
+stream_mode = "updates"
+
+[configurable]
+# seeds LangGraph RunnableConfig.configurable
+thread_id = "my-thread"
+```
+
+## CLI Options
+
+```
+Usage: langstage-cli [OPTIONS] [MESSAGE]
+
+Arguments:
+  MESSAGE  Optional input to send to the agent immediately
+
+Options:
+  -a, --agent TEXT                Agent spec (path/to/file.py:graph or module:graph)
+  -g, --graph-name TEXT           Graph variable name (default: "graph")
+  -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)
+  -v, --verbose                   Verbose output
+```
+
+## Creating Your Own Agent
+
+Your agent file should export a compiled LangGraph graph:
+
+```python
+# my_agent.py
+from deepagents import create_deep_agent
+from langgraph.checkpoint.memory import MemorySaver
+
+agent = create_deep_agent(
+    name="My Agent",
+    model="anthropic:claude-sonnet-4-20250514",
+    checkpointer=MemorySaver(),
+)
+```
+
+Then run it:
+```bash
+langstage-cli -a my_agent.py:agent
+```
+
+## Programmatic Use
+
+```python
+from langstage_cli import stream_graph_updates, prepare_agent_input
+
+input_data = prepare_agent_input(message="Hello!")
+
+for chunk in stream_graph_updates(graph, input_data):
+    if chunk.get("chunk"):
+        print(chunk["chunk"], end="")
+```
+
+## License
+
+MIT License - see LICENSE file for details.

langstage_cli-0.5.0/deepagent_code/__init__.py

@@ -0,0 +1,23 @@
+"""Deprecated alias package: ``deepagent_code`` is now ``langstage_cli``.
+
+Kept for one transition window so existing imports keep working. Import
+``langstage_cli`` instead.
+"""
+
+import sys as _sys
+import warnings as _warnings
+
+import langstage_cli as _new
+from langstage_cli import *  # noqa: F401,F403
+from langstage_cli import cli, config  # noqa: F401
+
+_warnings.warn(
+    "deepagent_code has been renamed to langstage_cli; "
+    "this alias package will be removed in a future release.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+_sys.modules[__name__ + ".cli"] = cli
+_sys.modules[__name__ + ".config"] = config
+__version__ = getattr(_new, "__version__", "0")

langstage_cli-0.5.0/langstage_cli/__init__.py

@@ -0,0 +1,27 @@
+"""
+langstage_cli - A Claude Code-style CLI for running LangGraph agents.
+
+The streaming / interrupt utilities that used to live here now come from
+``langgraph-stream-parser``. This package re-exports its dict-based convenience
+API for backward compatibility; the lower-level helpers (interrupt parsing,
+tool-call serialization, content extraction) are available from
+``langgraph_stream_parser.extractors`` if needed directly.
+"""
+
+from langgraph_stream_parser import (
+    prepare_agent_input,
+    stream_graph_updates,
+    resume_graph_from_interrupt,
+    astream_graph_updates,
+    aresume_graph_from_interrupt,
+)
+
+__version__ = "0.4.0"
+
+__all__ = [
+    "prepare_agent_input",
+    "stream_graph_updates",
+    "resume_graph_from_interrupt",
+    "astream_graph_updates",
+    "aresume_graph_from_interrupt",
+]