@zils/cli 0.4.11 → 0.4.13

package/README.md

@@ -24,6 +24,17 @@ private cache. It needs internet access, takes longer than subsequent starts,
 and does not modify your system Python. npm installation itself runs no setup
 scripts. Set `ZILS_PYTHON` to an executable path if Python is not on your PATH.
 
+## Use from an agent (MCP)
+
+```sh
+claude mcp add zils -- npx -y @zils/cli mcp      # Claude Code
+codex mcp add zils -- npx -y @zils/cli mcp       # Codex
+```
+
+Other hosts: run `npx` with the arguments `-y @zils/cli mcp` over stdio. The
+agent can answer decisions and check, submit and follow training jobs, with a
+required cost limit on every submission.
+
 ## Commands
 
 ```sh

package/bootstrap.py

@@ -66,16 +66,17 @@ def pip_install(python, target, **options):
 
 
 def install(python, wheel):
-    """The CLI must install; `zils merge`'s numpy is best effort, since a new Python can lack a
-    binary build of it, and that must not block other commands."""
+    """The CLI must install; `zils merge`'s numpy and `zils mcp`'s MCP library are best effort,
+    since a new Python can lack a binary build of them, and that must not block other commands."""
     pip_install(python, str(wheel), stdout=sys.stderr, check=True)
-    if pip_install(python, f"{wheel}[merge]", capture_output=True, text=True).returncode:
-        version = "%d.%d" % sys.version_info[:2]
-        print(
-            f"zils merge is unavailable on Python {version}: its dependencies have no build for it yet."
-            " Every other command works.",
-            file=sys.stderr,
-        )
+    for extra in ("merge", "mcp"):
+        if pip_install(python, f"{wheel}[{extra}]", capture_output=True, text=True).returncode:
+            version = "%d.%d" % sys.version_info[:2]
+            print(
+                f"zils {extra} is unavailable on Python {version}: its dependencies have no build for it yet."
+                " Every other command works.",
+                file=sys.stderr,
+            )
     subprocess.run(
         [str(python), "-I", "-c", "import zils_sdk; from zils_sdk.cli import main"],
         stdout=sys.stderr,
@@ -83,6 +84,23 @@ def install(python, wheel):
     )
 
 
+def create_runtime(environment):
+    """`python -m venv`. Debian and Ubuntu ship python3 without ensurepip, so this is the step
+    that fails on a fresh box; say which package fixes it instead of a bare exit status."""
+    try:
+        subprocess.run(
+            [sys.executable, "-I", "-m", "venv", str(environment)],
+            stdout=sys.stderr,
+            check=True,
+        )
+    except subprocess.CalledProcessError as error:
+        raise RuntimeError(
+            f"{sys.executable} cannot create a virtual environment (python3 -m venv failed). On"
+            " Debian or Ubuntu run: sudo apt install python3-venv (or python3.X-venv for your"
+            " Python), then retry"
+        ) from error
+
+
 def runtime():
     package = Path(__file__).resolve().parent
     version = json.loads((package / "package.json").read_text())["version"]
@@ -110,11 +128,7 @@ def runtime():
             ready.unlink(missing_ok=True)
             if environment.exists():
                 shutil.rmtree(environment)
-            subprocess.run(
-                [sys.executable, "-I", "-m", "venv", str(environment)],
-                stdout=sys.stderr,
-                check=True,
-            )
+            create_runtime(environment)
             install(python, wheel)
             ready.write_text(digest + "\n")
     return python

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zils/cli",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "Sign in, train, and call Zils decision models from your terminal",
   "license": "MIT",
   "homepage": "https://zils.ai",