antahkarana-cli 0.1.0__py3-none-any.whl

ant/__init__.py

@@ -0,0 +1,3 @@
+# Author - Deepak Soni
+"""ant — the Antaḥkaraṇa governed-AI operator CLI. `pip install antahkarana-cli`, run `ant`, prompt your copilot."""
+__version__ = "0.1.0"

ant/cli.py

@@ -0,0 +1,179 @@
+# Author - Deepak Soni
+"""ant — Antaḥkaraṇa governed-AI operator CLI.
+
+`pip install antahkarana-cli` → run `ant` → connect to your copilot → prompt it. It investigates a machine,
+reasons, runs read-only commands immediately, and asks y/N before any state-changing action (catastrophic
+commands are hard-blocked server-side). Thin client over the copilot's /api/chat (the model + control ring).
+
+Commands:
+  ant                         interactive REPL (banner + prompt)
+  ant "check open ports"      one-shot
+  ant connect <url>           save the copilot endpoint
+  ant login <token>           save an auth token (sent as Bearer)
+  ant status                  show connection + model health
+In the REPL, slash commands: /connect /login /model /status /help /clear /exit
+"""
+import json, os, sys, urllib.request, urllib.error
+
+# ── cross-OS terminal setup (Windows / macOS / Linux) ──
+try:                                              # never crash on non-UTF-8 consoles (e.g. Windows cmd)
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+if os.name == "nt":
+    os.system("")                                 # enable ANSI escape processing on Windows 10+
+_COLOR = sys.stdout.isatty() and os.environ.get("NO_COLOR") is None
+_uni = (getattr(sys.stdout, "encoding", "") or "").lower().startswith("utf")
+TOOL_ICON, WARN_ICON = ("🔧", "⚠") if _uni else ("[*]", "[!]")
+
+CFG_DIR = os.path.expanduser("~/.ant")
+CFG = os.path.join(CFG_DIR, "config.json")
+DEFAULT_URL = "http://129.146.3.254:8090"
+_RAW = {"g": "\033[32m", "y": "\033[33m", "r": "\033[31m", "c": "\033[36m", "b": "\033[1m", "d": "\033[2m", "x": "\033[0m"}
+C = {k: (v if _COLOR else "") for k, v in _RAW.items()}
+
+if _uni:
+    _ART = "   ▄▀█ █▄░█ ▀█▀   ·  Antaḥkaraṇa\n   █▀█ █░▀█ ░█░   ·  governed AI operator"
+else:
+    _ART = "   a n t   :  Antahkarana\n   governed AI operator"
+BANNER = f"{C['c']}{C['b']}\n{_ART}{C['x']}{C['d']}\n   prompt a machine - read-only runs - changes need y/N - catastrophic blocked{C['x']}\n"
+
+
+def load():
+    try:
+        return json.load(open(CFG))
+    except Exception:
+        return {"url": DEFAULT_URL, "token": "", "model": ""}
+
+
+def save(cfg):
+    os.makedirs(CFG_DIR, exist_ok=True)
+    json.dump(cfg, open(CFG, "w"), indent=2)
+
+
+def _headers(cfg):
+    h = {"Content-Type": "application/json"}
+    if cfg.get("token"):
+        h["Authorization"] = "Bearer " + cfg["token"]
+    return h
+
+
+def health(cfg):
+    try:
+        req = urllib.request.Request(cfg["url"].rstrip("/") + "/api/health", headers=_headers(cfg))
+        return json.load(urllib.request.urlopen(req, timeout=8))
+    except Exception as e:  # noqa: BLE001
+        return {"error": str(e)}
+
+
+def chat(cfg, history, approved):
+    """Stream the agent's steps; return commands awaiting approval."""
+    body = json.dumps({"messages": history, "approved": approved}).encode()
+    req = urllib.request.Request(cfg["url"].rstrip("/") + "/api/chat", body, _headers(cfg))
+    pending, buf = [], ""
+    with urllib.request.urlopen(req, timeout=300) as r:
+        for chunk in r:
+            buf += chunk.decode("utf-8", "ignore")
+            while "\n\n" in buf:
+                line, buf = buf.split("\n\n", 1)
+                line = line.strip()
+                if not line.startswith("data:"):
+                    continue
+                e = json.loads(line[5:].strip()); t = e.get("type")
+                if t == "tool":
+                    col = {"allow": C["g"], "soft_block": C["y"], "hard_block": C["r"]}.get(e["tier"], "")
+                    print(f"  {C['d']}{TOOL_ICON} {e['name']}({e.get('target','')}){C['x']} {col}[{e['tier']}]{C['x']}")
+                elif t == "approval":
+                    pending.append(e["command"])
+                elif t == "message":
+                    print(f"\n{e.get('markdown','')}\n")
+                    history.append({"role": "assistant", "content": e.get("markdown", "")})
+                elif t == "error":
+                    print(f"  {C['r']}error: {e['text']}{C['x']}")
+    return pending
+
+
+def ask(cfg, history, approved, q):
+    history.append({"role": "user", "content": q})
+    pending = chat(cfg, history, approved)
+    while pending:
+        granted = False
+        for cmd in pending:
+            a = input(f"  {C['y']}{WARN_ICON} approve state-changing command?{C['x']} {C['b']}{cmd}{C['x']} [y/N] ").strip().lower()
+            if a == "y":
+                granted = True
+                if cmd not in approved:
+                    approved.append(cmd)
+        history.append({"role": "user", "content": "Approved — run the approved command(s) now."
+                        if granted else "Denied — do not run that; stop or suggest a safer alternative."})
+        pending = chat(cfg, history, approved)
+
+
+def status(cfg):
+    h = health(cfg)
+    ok = "error" not in h
+    print(f"  endpoint : {cfg['url']}")
+    print(f"  auth     : {'token set' if cfg.get('token') else 'none'}")
+    if ok:
+        print(f"  copilot  : {C['g']}up{C['x']}   model: {h.get('model','?')}   llm: {'ready' if h.get('llm_ready') else 'loading'}")
+    else:
+        print(f"  copilot  : {C['r']}unreachable{C['x']} ({h['error']})")
+
+
+def repl(cfg):
+    print(BANNER)
+    status(cfg)
+    print(f"  {C['d']}type a prompt, or /help for commands{C['x']}\n")
+    history, approved = [], []
+    while True:
+        try:
+            q = input(f"{C['b']}{C['c']}ant>{C['x']} ").strip()
+        except (EOFError, KeyboardInterrupt):
+            print(); break
+        if not q:
+            continue
+        if q.startswith("/"):
+            parts = q[1:].split(maxsplit=1); cmd = parts[0]; arg = parts[1] if len(parts) > 1 else ""
+            if cmd in ("exit", "quit"):
+                break
+            elif cmd == "help":
+                print("  /connect <url>  /login <token>  /model  /status  /clear  /exit")
+            elif cmd == "connect":
+                cfg["url"] = arg or cfg["url"]; save(cfg); status(cfg)
+            elif cmd == "login":
+                cfg["token"] = arg; save(cfg); print("  token saved")
+            elif cmd == "model":
+                print(f"  model: {health(cfg).get('model','?')}  (served by the copilot)")
+            elif cmd == "status":
+                status(cfg)
+            elif cmd == "clear":
+                history, approved = [], []; print("  conversation cleared")
+            else:
+                print(f"  unknown command: /{cmd}")
+            continue
+        try:
+            ask(cfg, history, approved, q)
+        except urllib.error.HTTPError as e:
+            print(f"  {C['r']}HTTP {e.code}: {e.read().decode('utf-8','ignore')[:160]}{C['x']}")
+        except Exception as e:  # noqa: BLE001
+            print(f"  {C['r']}request failed: {e}{C['x']}")
+
+
+def main():
+    cfg = load()
+    a = sys.argv[1:]
+    if not a:
+        repl(cfg); return
+    if a[0] == "connect" and len(a) > 1:
+        cfg["url"] = a[1]; save(cfg); print(f"connected to {a[1]}"); status(cfg)
+    elif a[0] == "login" and len(a) > 1:
+        cfg["token"] = a[1]; save(cfg); print("token saved")
+    elif a[0] == "status":
+        status(cfg)
+    else:                                   # one-shot prompt
+        print(BANNER)
+        ask(cfg, [], [], " ".join(a))
+
+
+if __name__ == "__main__":
+    main()

antahkarana_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: antahkarana-cli
+Version: 0.1.0
+Summary: ant — the Antaḥkaraṇa governed-AI operator CLI: prompt your on-box copilot to investigate/operate a machine, read-only by default, with y/N approval for changes and catastrophic commands hard-blocked.
+Author: Deepak Soni
+License: Apache-2.0
+Project-URL: Homepage, https://pypi.org/project/antahkarana/
+Keywords: llm,agent,cli,security,mcp,antahkarana,governed,ssh
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# ant — Antaḥkaraṇa governed-AI operator CLI
+
+Author — Deepak Soni. A tiny, dependency-free CLI that prompts your **on-box copilot** (the Antaḥkaraṇa model +
+control ring) from any terminal — Claude-Code style. It investigates a machine, reasons, runs **read-only**
+commands immediately, and asks **y/N before any state-changing action**; catastrophic commands are hard-blocked
+server-side.
+
+## Install
+```bash
+pip install antahkarana-cli
+```
+
+## Use
+```bash
+ant connect http://YOUR-BOX:8090     # point it at your copilot (saved to ~/.ant/config.json)
+ant                                  # interactive: banner + prompt
+ant "what is listening on this server?"   # one-shot
+ant status                           # connection + model health
+```
+In the REPL, slash commands: `/connect <url>` · `/login <token>` · `/model` · `/status` · `/clear` · `/exit`.
+
+## What you can ask
+- `what OS is this and what's listening on its ports?`  → runs read-only, reports
+- `create a file /tmp/demo.txt`  → proposes it, asks **[y/N]**, runs only if you approve
+- `rm -rf /tmp/x`  → **hard-blocked** by the control ring
+- `assess example.com`  → passive web-recon → prioritized report
+
+## How it works
+`ant` is a thin client over the copilot's `/api/chat` — the model (e.g. Qwen2.5-14B), the governed `run_shell`,
+the web-recon tools, and the control ring all live on the box (or a remote SSH target the copilot is pointed at).
+Nothing runs locally; every decision is governed and audited server-side.
+
+Requires a running Antaḥkaraṇa copilot (see `antahkarana-net/box/copilot/`).

antahkarana_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+ant/__init__.py,sha256=2l5J6_CrEfngomOjmced3POM7OdTSnQQjs0Ehy3PTWE,168
+ant/cli.py,sha256=OlFewO69SkpQlBrW60DwN4pptXKHvTFoSJfhM86YozE,7347
+antahkarana_cli-0.1.0.dist-info/METADATA,sha256=GpjBWAhHljzqXfFd1DNcC7T3mO9bwP3n8zO4TBVKB0U,2100
+antahkarana_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+antahkarana_cli-0.1.0.dist-info/entry_points.txt,sha256=Y6KfPuLvtohyfYX-g7h645Zbr140zodtjBoW2hJx2PU,37
+antahkarana_cli-0.1.0.dist-info/top_level.txt,sha256=8g98uTVZGWavv2MVXE4KhTMrVT3XOxBl6Hh9Wh_wGAg,4
+antahkarana_cli-0.1.0.dist-info/RECORD,,

antahkarana_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

antahkarana_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ant = ant.cli:main

antahkarana_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ant