lithe-cli 0.3.0__tar.gz → 0.4.1__tar.gz

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lithe-cli
-Version: 0.3.0
+Version: 0.4.1
 Summary: Command-line interface for the lithe agent kernel: chat, one-shot runs, undo, and run inspection.
 License: MIT License
         
@@ -39,7 +39,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: lithe>=0.9.5
+Requires-Dist: lithe>=0.9.8
 Requires-Dist: prompt-toolkit>=3.0.38
 Provides-Extra: dev
 Requires-Dist: pytest>=8; extra == "dev"
@@ -118,7 +118,7 @@ usage/context gauges; `--max-steps` caps the tool loop;
 ```bash
 $ lithe chat
 ╭──────────────────────────────────────╮
-│ lithe 0.2.0                          │
+│ lithe 0.4.0                          │
 │ model   your-model                   │
 │ workdir /home/me/my-project          │
 │ /help 查看会话命令，/exit 退出       │
@@ -142,6 +142,7 @@ The kernel ships these as bundles; the CLI grants them per flag:
 | Flag | Tools granted | Notes |
 | --- | --- | --- |
 | `--code` | `run_code` / `run_file` | Python under bubblewrap when installed (passthrough otherwise); `doctor` shows which |
+| `--shell` | `run_command` | Native bash/sh on Linux and macOS, PowerShell/cmd on Windows; runs with the current user's host permissions, is not sandboxed, and cannot be undone |
 | `--skills DIR` | `load_skill` | markdown skill library; defaults to `$LITHE_HOME/skills` when it exists, `--skills ""` disables |
 | `--download` | `download_file` | SSRF-guarded, size-capped network fetch |
 | `--vision` | `image_info` / `analyze_image` | image probe is stdlib-only; analysis routes one vision call to the main endpoint |
@@ -149,6 +150,7 @@ The kernel ships these as bundles; the CLI grants them per flag:
 
 ```bash
 $ lithe run --code "用 run_code 验证 results.csv 的行数"
+$ lithe run --shell "检查当前目录的项目状态"
 $ lithe chat --skills ~/my-skills --mcp @~/mcp.json
 ```
 

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/README.md

@@ -70,7 +70,7 @@ usage/context gauges; `--max-steps` caps the tool loop;
 ```bash
 $ lithe chat
 ╭──────────────────────────────────────╮
-│ lithe 0.2.0                          │
+│ lithe 0.4.0                          │
 │ model   your-model                   │
 │ workdir /home/me/my-project          │
 │ /help 查看会话命令，/exit 退出       │
@@ -94,6 +94,7 @@ The kernel ships these as bundles; the CLI grants them per flag:
 | Flag | Tools granted | Notes |
 | --- | --- | --- |
 | `--code` | `run_code` / `run_file` | Python under bubblewrap when installed (passthrough otherwise); `doctor` shows which |
+| `--shell` | `run_command` | Native bash/sh on Linux and macOS, PowerShell/cmd on Windows; runs with the current user's host permissions, is not sandboxed, and cannot be undone |
 | `--skills DIR` | `load_skill` | markdown skill library; defaults to `$LITHE_HOME/skills` when it exists, `--skills ""` disables |
 | `--download` | `download_file` | SSRF-guarded, size-capped network fetch |
 | `--vision` | `image_info` / `analyze_image` | image probe is stdlib-only; analysis routes one vision call to the main endpoint |
@@ -101,6 +102,7 @@ The kernel ships these as bundles; the CLI grants them per flag:
 
 ```bash
 $ lithe run --code "用 run_code 验证 results.csv 的行数"
+$ lithe run --shell "检查当前目录的项目状态"
 $ lithe chat --skills ~/my-skills --mcp @~/mcp.json
 ```
 

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/lithe_cli/__init__.py

@@ -1,3 +1,3 @@
 """lithe-cli: the command-line interface for the lithe agent kernel."""
 
-__version__ = "0.3.0"
+__version__ = "0.4.1"

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/lithe_cli/agent.py

@@ -8,9 +8,9 @@ Everything here maps lithe's host contract onto CLI defaults:
   kernel's zero-database default;
 - tools — the workspace bundle (read/write/edit/list/search/glob +
   apply_patch) and todos, plus opt-in capabilities: ``--code`` (sandboxed
-  Python), ``--skills`` (markdown skill library), ``--vision`` (image
-  probe/analysis), ``--download`` (SSRF-guarded network fetch) and
-  ``--mcp`` (external MCP servers);
+  Python), ``--shell`` (native host commands), ``--skills`` (markdown skill
+  library), ``--vision`` (image probe/analysis), ``--download`` (SSRF-guarded
+  network fetch) and ``--mcp`` (external MCP servers);
 - undo — the bundled tools register reverters, so ``lithe undo`` works with
   zero configuration.
 """
@@ -32,6 +32,7 @@ from lithe.bundles import (
     Workspace,
     undo_run,
 )
+from lithe.bundles.command import register_command_tools
 from lithe.bundles.download import register_download_tools
 from lithe.bundles.patch import register_apply_patch_tool
 from lithe.bundles.workspace import register_file_tools
@@ -57,6 +58,8 @@ def build_system_prompt(cfg: Config) -> str:
     extras = []
     if cfg.code:
         extras.append("可以用 run_code 执行 Python 来验证想法、计算或测试。")
+    if cfg.shell:
+        extras.append("可以用 run_command 在主机上运行系统命令；命令有当前用户权限且副作用不可撤销，执行前先确认必要性。")
     if cfg.download:
         extras.append("可以用 download_file 下载网络文件到工作区。")
     if cfg.skills_dir is not None:
@@ -97,6 +100,12 @@ def build_registry(cfg: Config) -> ToolRegistry:
 
         runner = CodeRunner(sys.executable, backend=sandbox_backend())
         register_code_tools(reg, lambda ctx: str(cfg.workspace_dir.resolve()), runner)
+    if cfg.shell:
+        from lithe.bundles.command import CommandRunner
+
+        register_command_tools(
+            reg, lambda ctx: cfg.workspace_dir.resolve(), CommandRunner()
+        )
     if cfg.skills_dir is not None:
         from lithe.bundles.skills import SkillLibrary, register_skill_tool
 
@@ -146,14 +155,14 @@ def render_event(
             ui.assistant(text)
     elif t == "tool_call":
         args = json.dumps(ev.get("args", {}), ensure_ascii=False)
-        ui.tool_call(str(ev.get("name")), args[:120])
+        ui.tool_call(str(ev.get("name")), args)
         if ev.get("id") is not None:
             pending[ev["id"]] = time.monotonic()
     elif t == "tool_result":
         summary = (ev.get("summary") or "").replace("\n", " ")
         started = pending.pop(ev.get("id"), None) if ev.get("id") else None
         elapsed = (time.monotonic() - started) if started is not None else None
-        ui.tool_result(bool(ev.get("ok")), summary[:160], elapsed)
+        ui.tool_result(bool(ev.get("ok")), summary, elapsed)
     elif t == "error":
         ui.error(str(ev.get("message", "")))
     elif t == "cancelled":

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/lithe_cli/config.py

@@ -57,6 +57,7 @@ class Config:
     download: bool = False
     verbose: bool = False
     code: bool = False
+    shell: bool = False
     skills_dir: Path | None = None
     mcp_spec: str | None = None
     mcp_servers: list = field(default_factory=list)
@@ -204,6 +205,7 @@ def load_config(args: Any) -> Config:
         download=g("download", False),
         verbose=g("verbose", False),
         code=g("code", False),
+        shell=g("shell", False),
         skills_dir=skills_dir,
         mcp_spec=mcp_raw,
         mcp_servers=load_mcp_spec(mcp_raw) if mcp_raw else [],

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/lithe_cli/main.py

@@ -66,6 +66,11 @@ def build_parser() -> argparse.ArgumentParser:
             help="grant run_code/run_file (sandboxed Python; "
             "bwrap when available, passthrough otherwise)",
         )
+        sp.add_argument(
+            "--shell",
+            action="store_true",
+            help="grant run_command (native shell with current-user host access)",
+        )
         sp.add_argument(
             "--skills",
             metavar="DIR",
@@ -178,7 +183,7 @@ def _cmd_runs(cfg: Any, limit: int) -> int:
     rows = []
     for r in reversed(runs):  # newest last, like a log
         task = (r.task or "").replace("\n", " ")
-        rows.append([r.run_id, r.status, str(r.steps), f"{r.cost:.4f}", task[:60]])
+        rows.append([r.run_id, r.status, str(r.steps), f"{r.cost:.4f}", truncate(task, 60)])
     print(
         ui.table(
             ["run", "status", "steps", "cost", "task"],
@@ -224,7 +229,7 @@ def _cmd_doctor() -> int:
     class _Args:  # doctor reuses load_config over env-only defaults
         api_key = base_url = model = store = workspace = user = None
         skills = mcp = None
-        download = code = vision = color = no_color = verbose = False
+        download = code = shell = vision = color = no_color = verbose = False
 
     cfg = load_config(_Args())
     print(ui.s(f"lithe-cli {__version__}（lithe {lithe_version}）", CYAN, BOLD))
@@ -264,6 +269,8 @@ def _cmd_doctor() -> int:
     else:
         sandbox_line = ui.s("passthrough（未找到 bwrap，无隔离）", RED)
     print(ui.kv("sandbox", sandbox_line + "；--code 启用 run_code"))
+    command_line = "已启用（run_command 可执行主机命令）" if cfg.shell else "未启用（--shell 显式授权）"
+    print(ui.kv("shell", command_line))
 
     skills = default_skills_dir()
     if cfg.skills_dir is not None:

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/lithe_cli/ui.py

@@ -13,6 +13,7 @@ from __future__ import annotations
 
 import os
 import re
+import shutil
 import sys
 import unicodedata
 
@@ -81,8 +82,13 @@ def truncate(text: str, width: int) -> str:
 class UI:
     """All terminal output goes through here; ``color`` gates every code."""
 
-    def __init__(self, color: bool = False):
+    def __init__(self, color: bool = False, width: int | None = None):
         self.color = bool(color)
+        self._width = width
+
+    @property
+    def width(self) -> int:
+        return max(12, self._width or shutil.get_terminal_size((100, 24)).columns)
 
     def s(self, text: str, *styles: str) -> str:
         """Wrap *text* in *styles* when color is on and text is non-empty."""
@@ -93,36 +99,53 @@ class UI:
     # -- structural ---------------------------------------------------------
 
     def rule(self, char: str = "─", width: int = 60) -> str:
-        return self.s(char * width, DIM)
+        return self.s(char * min(width, self.width), DIM)
 
     def kv(self, label: str, value: str) -> str:
         return f"{self.s(pad(label, 11), CYAN, BOLD)} {value}"
 
     def section(self, title: str) -> str:
-        tail = "─" * max(0, 50 - display_width(title))
-        return self.s(f"── {title} {tail}", DIM)
+        width = min(50, self.width)
+        label = f"── {title} "
+        if display_width(label) > width:
+            return self.s(truncate(label, width), DIM)
+        return self.s(label + "─" * (width - display_width(label)), DIM)
 
     def table(
         self, headers: list[str], rows: list[list[str]], cell_styles: list | None = None
     ) -> str:
-        """Aligned table; ``cell_styles[i](text) -> str`` styles column i."""
+        """Aligned, terminal-width-aware table with display-width styling."""
         widths = [display_width(h) for h in headers]
         for row in rows:
-            for i, cell in enumerate(row):
+            for i, cell in enumerate(row[:len(headers)]):
                 widths[i] = max(widths[i], display_width(cell))
+        spacing = "  " if self.width >= 3 * len(headers) else " "
+        available = max(1, self.width - display_width(spacing) * (len(headers) - 1))
+        overflow = max(0, sum(widths) - available)
+        for i in range(len(widths) - 1, -1, -1):
+            floor = min(widths[i], max(1, display_width(headers[i])))
+            reduction = min(overflow, widths[i] - floor)
+            widths[i] -= reduction
+            overflow -= reduction
+        for i in range(len(widths) - 1, -1, -1):
+            reduction = min(overflow, widths[i] - 1)
+            widths[i] -= reduction
+            overflow -= reduction
+        shown_headers = [truncate(h, widths[i]) for i, h in enumerate(headers)]
         head = self.s(
-            "  ".join(pad(h, widths[i]) for i, h in enumerate(headers)), BOLD, DIM
+            spacing.join(pad(shown_headers[i], widths[i]) for i in range(len(headers))),
+            BOLD,
+            DIM,
         )
-        sep = self.s("  ".join("─" * w for w in widths), DIM)
+        sep = self.s(spacing.join("─" * w for w in widths), DIM)
         lines = [head, sep]
         for row in rows:
             cells = []
-            for i, cell in enumerate(row):
-                styled = cell
-                if cell_styles and cell_styles[i]:
-                    styled = cell_styles[i](cell)
+            for i, cell in enumerate(row[:len(headers)]):
+                shown = truncate(cell, widths[i])
+                styled = cell_styles[i](shown) if cell_styles and cell_styles[i] else shown
                 cells.append(pad(styled, widths[i]))
-            lines.append("  ".join(cells))
+            lines.append(spacing.join(cells))
         return "\n".join(lines)
 
     def status(self, text: str) -> str:
@@ -146,12 +169,15 @@ class UI:
         print(self.s(text, GREEN))
 
     def tool_call(self, name: str, args: str) -> None:
-        print(f"  {self.s('⚒', CYAN)} {self.s(name, CYAN, BOLD)} {self.s(args, DIM)}")
+        prefix = f"  ⚒ {name} "
+        detail = truncate(args, max(8, self.width - display_width(prefix)))
+        print(f"  {self.s('⚒', CYAN)} {self.s(name, CYAN, BOLD)} {self.s(detail, DIM)}")
 
     def tool_result(self, ok: bool, summary: str, elapsed: float | None) -> None:
         mark = self.s("✓", GREEN) if ok else self.s("✗", RED)
         tail = self.s(f" {elapsed:.1f}s", DIM) if elapsed is not None else ""
-        print(f"  {mark} {self.s(summary, GREEN if ok else RED)}{tail}")
+        label = truncate(summary, max(8, self.width - 8 - display_width(tail)))
+        print(f"  {mark} {self.s(label, GREEN if ok else RED)}{tail}")
 
     def error(self, msg: str) -> None:
         print(f"  {self.s('!', RED)} {self.s(msg, RED)}")
@@ -188,15 +214,17 @@ class UI:
 
     def banner(self, version: str, model: str, workspace: str) -> str:
         rows = [
-            f"lithe {version}",
-            f"model   {model}",
-            f"workdir {workspace}",
-            "/help 查看会话命令，/exit 退出",
+            f"lithe {version} · command agent",
+            f"◆ model      {model}",
+            f"⌂ workspace  {workspace}",
+            "/help 查看会话命令 · /exit 退出",
         ]
-        width = max(display_width(r) for r in rows) + 2
+        inner = max(8, self.width - 4)
+        rows = [truncate(row, inner - 2) for row in rows]
+        width = max(display_width(row) for row in rows) + 2
         top = "╭" + "─" * width + "╮"
         bot = "╰" + "─" * width + "╯"
-        body = "\n".join("│" + pad(" " + r, width) + "│" for r in rows)
+        body = "\n".join("│" + pad(" " + row, width) + "│" for row in rows)
         art = "\n".join((top, body, bot))
         return self.s(art, CYAN)
 

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/lithe_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lithe-cli
-Version: 0.3.0
+Version: 0.4.1
 Summary: Command-line interface for the lithe agent kernel: chat, one-shot runs, undo, and run inspection.
 License: MIT License
         
@@ -39,7 +39,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: lithe>=0.9.5
+Requires-Dist: lithe>=0.9.8
 Requires-Dist: prompt-toolkit>=3.0.38
 Provides-Extra: dev
 Requires-Dist: pytest>=8; extra == "dev"
@@ -118,7 +118,7 @@ usage/context gauges; `--max-steps` caps the tool loop;
 ```bash
 $ lithe chat
 ╭──────────────────────────────────────╮
-│ lithe 0.2.0                          │
+│ lithe 0.4.0                          │
 │ model   your-model                   │
 │ workdir /home/me/my-project          │
 │ /help 查看会话命令，/exit 退出       │
@@ -142,6 +142,7 @@ The kernel ships these as bundles; the CLI grants them per flag:
 | Flag | Tools granted | Notes |
 | --- | --- | --- |
 | `--code` | `run_code` / `run_file` | Python under bubblewrap when installed (passthrough otherwise); `doctor` shows which |
+| `--shell` | `run_command` | Native bash/sh on Linux and macOS, PowerShell/cmd on Windows; runs with the current user's host permissions, is not sandboxed, and cannot be undone |
 | `--skills DIR` | `load_skill` | markdown skill library; defaults to `$LITHE_HOME/skills` when it exists, `--skills ""` disables |
 | `--download` | `download_file` | SSRF-guarded, size-capped network fetch |
 | `--vision` | `image_info` / `analyze_image` | image probe is stdlib-only; analysis routes one vision call to the main endpoint |
@@ -149,6 +150,7 @@ The kernel ships these as bundles; the CLI grants them per flag:
 
 ```bash
 $ lithe run --code "用 run_code 验证 results.csv 的行数"
+$ lithe run --shell "检查当前目录的项目状态"
 $ lithe chat --skills ~/my-skills --mcp @~/mcp.json
 ```
 

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/lithe_cli.egg-info/requires.txt

@@ -1,4 +1,4 @@
-lithe>=0.9.5
+lithe>=0.9.8
 prompt-toolkit>=3.0.38
 
 [dev]

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/pyproject.toml

@@ -9,7 +9,7 @@ description = "Command-line interface for the lithe agent kernel: chat, one-shot
 readme = "README.md"
 license = { file = "LICENSE" }
 requires-python = ">=3.10"
-dependencies = ["lithe>=0.9.5", "prompt-toolkit>=3.0.38"]
+dependencies = ["lithe>=0.9.8", "prompt-toolkit>=3.0.38"]
 keywords = ["agent", "llm", "react", "cli", "tool-calling"]
 classifiers = [
     "Development Status :: 4 - Beta",

{lithe_cli-0.3.0 → lithe_cli-0.4.1}/tests/test_cli.py

@@ -45,6 +45,7 @@ def test_tools_command(tmp_path, capsys):
         assert name in out, f"{name} missing from tools listing"
     # download stays opt-in
     assert "download_file" not in out
+    assert "run_command" not in out
 
 
 def test_tools_command_with_download(tmp_path, capsys):
@@ -64,6 +65,23 @@ def test_tools_command_with_download(tmp_path, capsys):
     assert "download_file" in capsys.readouterr().out
 
 
+def test_tools_command_with_shell(tmp_path, capsys):
+    from lithe_cli.main import main
+
+    rc = main(
+        [
+            "tools",
+            "--workspace",
+            str(tmp_path),
+            "--store",
+            str(tmp_path / "s"),
+            "--shell",
+        ]
+    )
+    assert rc == 0
+    assert "run_command" in capsys.readouterr().out
+
+
 def test_tools_command_with_code(tmp_path, capsys):
     from lithe_cli.main import main
 
@@ -182,7 +200,9 @@ def test_system_prompt_mentions_capabilities(tmp_path):
 
     base = build_system_prompt(Config())
     with_code = build_system_prompt(Config(code=True))
+    with_shell = build_system_prompt(Config(shell=True))
     assert "run_code" in with_code and "run_code" not in base
+    assert "run_command" in with_shell and "run_command" not in base
 
 
 def test_ui_degrades_without_color():
@@ -200,11 +220,30 @@ def test_ui_table_aligns_wide_chars():
 
     out = UI(color=False).table(["name", "desc"], [["abc", "说明"], ["de", "plain"]])
     lines = out.splitlines()
-    # rows line up: the desc column starts at the same offset on every row
     offs = {ln.index("说") if "说" in ln else ln.index("p") for ln in lines[2:]}
     assert len(offs) == 1
 
 
+def test_ui_table_fits_narrow_terminal():
+    from lithe_cli.ui import UI, display_width
+
+    out = UI(color=False, width=24).table(
+        ["name", "status", "description"],
+        [["long-tool-name", "running", "工作区中的较长中文说明文本"]],
+    )
+    assert all(display_width(line) <= 24 for line in out.splitlines())
+    assert "…" in out
+
+
+def test_ui_banner_fits_terminal_width():
+    from lithe_cli.ui import UI, display_width
+
+    out = UI(color=False, width=28).banner("0.3.0", "a-very-long-model-name", "/a/very/long/workspace/path")
+    assert all(display_width(line) <= 28 for line in out.splitlines())
+    assert "workspace" in out
+    assert "…" in out
+
+
 def test_no_command_prints_help(capsys):
     from lithe_cli.main import main