akashcli 4.3.1__tar.gz → 4.4.0__tar.gz

{akashcli-4.3.1 → akashcli-4.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akashcli
-Version: 4.3.1
+Version: 4.4.0
 Summary: Akash CLI — secure remote shell relay, file vault, and device management
 License: MIT
 Keywords: akash,cli,relay,remote-shell,vault

{akashcli-4.3.1 → akashcli-4.4.0}/akashcli/cli.py

@@ -74,11 +74,14 @@ class _Spin:
         sys.stdout.flush()
 
 
-def _resolve_client(url_override: str = None):
+def _resolve_client(url_override: str = None, require_key: bool = False):
     """
-    Return (api_key, base_url).
-    If no API key is configured, prompt the user interactively rather than
-    crashing — so commands work on a fresh machine without `akash login`.
+    Return (api_key_or_None, base_url).
+
+    require_key=True  — hard-fail with a clear message if no key found
+                        (used by serve/devices which cannot work without server auth).
+    require_key=False — return None for api_key if missing; caller shows warning
+                        and can offer a local/offline fallback.
     """
     import os as _os
     config = ConfigManager.load()
@@ -88,22 +91,23 @@ def _resolve_client(url_override: str = None):
         or config.get("api_url", "https://jstore.2bd.net")
     ).rstrip("/")
 
-    api_key = _os.getenv("AKASH_API_KEY") or config.get("api_key")
-    if not api_key:
+    api_key = _os.getenv("AKASH_API_KEY") or config.get("api_key") or None
+
+    if not api_key and require_key:
         print(f"  {_Y}!{_RS}  No API key found.")
-        print(f"  {_DM}Set AKASH_API_KEY env var, or run {_C}akash login{_RS}{_DM} to save credentials.{_RS}")
-        try:
-            api_key = typer.prompt("  API key", hide_input=True).strip()
-        except (EOFError, KeyboardInterrupt):
-            print()
-            raise typer.Exit(1)
-        if not api_key:
-            _err("API key required.")
-            raise typer.Exit(1)
+        print(f"  {_DM}Run {_C}akash login{_RS}{_DM} to save your key, or set {_C}AKASH_API_KEY{_RS}{_DM}.{_RS}")
+        raise typer.Exit(1)
 
     return api_key, base
 
 
+_GUEST_WARNING = (
+    f"  {_Y}⚠{_RS}  {_Y}Running as guest{_RS} — not logged in.\n"
+    f"  {_DM}Features are limited and your data won't be saved to the cloud.\n"
+    f"  Run {_RS}{_C}akash login{_RS}{_DM} to unlock full access.{_RS}"
+)
+
+
 def _progress_bar(done: int, total: int, width: int = 28) -> str:
     """Return a plain ASCII progress bar string."""
     if not total:
@@ -138,22 +142,72 @@ def _upload_with_progress(client: AkashClient, tmp_path: str, password=None) ->
 # `cloud_app` — file management (akash cloud upload/files/stream/delete/manage/bulk)
 
 app = typer.Typer(
-    help=(
-        "akash — encrypted cloud backup for your terminal.\n\n"
-        "Quick start:\n"
-        "  akash login          connect your API key\n"
-        "  akash backup         save & sync your terminal\n"
-        "  akash pull <CODE>    restore on a fresh machine\n\n"
-        "Run  akash cloud --help  for file sync commands."
-    ),
+    invoke_without_command=True,
     rich_markup_mode=None,
     add_completion=True,
+    no_args_is_help=False,
 )
+
+@app.callback(invoke_without_command=True)
+def _main(ctx: typer.Context,
+          help: bool = typer.Option(False, "--help", "-h", is_eager=True, expose_value=False,
+                                    callback=lambda v: (_print_help(), raise_exit()) if v else None,
+                                    help="Show this message and exit.")):
+    """akash — your encrypted terminal cloud."""
+    if ctx.invoked_subcommand is None:
+        _print_help()
+        raise typer.Exit(0)
+
+def raise_exit():
+    raise typer.Exit(0)
+
+def _print_help():
+    C, G, Y, DM, RS = _C, _G, _Y, _DM, _RS
+    lines = [
+        f"",
+        f"  {C}akash{RS}  {DM}— encrypted cloud backup · remote shell · file vault{RS}",
+        f"",
+        f"  {DM}ACCOUNT{RS}",
+        f"  {C}login{RS}    {DM}[--label NAME]{RS}      save your API key + name this device",
+        f"  {C}whoami{RS}                        show account info and storage quota",
+        f"  {C}logout{RS}                        clear saved credentials",
+        f"",
+        f"  {DM}TERMINAL BACKUP{RS}",
+        f"  {C}backup{RS}                        save this terminal environment to the cloud",
+        f"  {C}restore{RS}                       restore environment from the cloud",
+        f"  {C}saves{RS}                         list your saved environments",
+        f"  {C}pull{RS}     {DM}<CODE>{RS}               restore on any machine — no login needed",
+        f"",
+        f"  {DM}REMOTE SHELL{RS}",
+        f"  {C}shell{RS}    {DM}[--device NAME]{RS}     open a shell here, or on another device",
+        f"  {C}run{RS}      {DM}<CMD> [--device NAME]{RS}  run a command locally or on a device",
+        f"  {C}serve{RS}    {DM}[--label NAME]{RS}      make this device reachable for shell/run",
+        f"  {C}devices{RS}  {DM}[--revoke NAME]{RS}     list or revoke enrolled devices",
+        f"",
+        f"  {DM}FILES{RS}",
+        f"  {C}pipe{RS}     {DM}[--run CMD]{RS}         upload stdin or a command's output",
+        f"  {C}cloud{RS}    {DM}<upload|files|stream…>{RS}  manage individual cloud files",
+        f"",
+        f"  {DM}SECURE TRANSFER{RS}",
+        f"  {C}send{RS}     {DM}<USER> <FILE>{RS}       encrypt and send a file to another user",
+        f"  {C}inbox{RS}                         receive and decrypt files sent to you",
+        f"  {C}id{RS}                            show your P2P identity / manage contacts",
+        f"",
+        f"  {DM}OTHER{RS}",
+        f"  {C}env{RS}      {DM}<set|get|list…>{RS}     encrypted local .env manager",
+        f"  {C}log{RS}      {DM}[--stats]{RS}           operation history (--stats for summary)",
+        f"  {C}check{RS}    {DM}[--seal]{RS}            verify file integrity (--seal to re-seal)",
+        f"",
+        f"  {DM}Run  {RS}{C}akash <command> --help{RS}{DM}  for full options on any command.{RS}",
+        f"",
+    ]
+    print("\n".join(lines))
+
 cloud_app = typer.Typer(
-    help="akash cloud — upload, stream, manage individual files.",
+    help="Manage individual cloud files.",
     rich_markup_mode=None,
 )
-app.add_typer(cloud_app, name="cloud", help="File sync ops (upload, stream, delete…)")
+app.add_typer(cloud_app, name="cloud", help="upload · stream · delete individual files")
 
 
 # ── Integrity check ───────────────────────────────────────────────────────────
@@ -861,44 +915,37 @@ def pull(
     _print_reload_hint(meta)
 
 
-# ── akash seal ────────────────────────────────────────────────────────────────
+# ── akash check (seal + integrity merged) ────────────────────────────────────
 
 @app.command()
-def seal():
-    """Hash all source files and write a signed integrity manifest."""
-    from .integrity import seal as _seal, _manifest_path
-    _info("sealing source integrity…")
-    hashes = _seal()
-    _ok(f"hashed {len(hashes)} source files")
-    _ok(f"manifest → {_dim(str(_manifest_path()))}")
-    _info("tamper detection active for backup, restore, and pull")
-
-
-# ── akash integrity ───────────────────────────────────────────────────────────
+def check(
+    seal: bool = typer.Option(False, "--seal", help="Re-seal the integrity manifest"),
+):
+    """Verify file integrity — or re-seal with --seal.
 
-@app.command()
-def integrity():
-    """Check all installed source files match the sealed manifest."""
-    from .integrity import status as _status
-    s = _status()
-    if not s["sealed"]:
-        _warn(f"not sealed: {s['message']}")
-        _info("run `akash seal` to enable tamper detection")
-        return
-    if s["ok"]:
-        _ok(f"integrity OK — {s['files']} files verified")
+    Examples:
+      akash check          verify all source files are untampered
+      akash check --seal   hash source files and write a new manifest
+    """
+    if seal:
+        from .integrity import seal as _seal, _manifest_path
+        _info("sealing source integrity…")
+        hashes = _seal()
+        _ok(f"hashed {len(hashes)} source files")
+        _ok(f"manifest → {_dim(str(_manifest_path()))}")
+        _info("tamper detection active for backup, restore, and pull")
     else:
-        _err("tamper detected!")
-        print(s["message"], file=sys.stderr)
-        raise typer.Exit(2)
-
-
-# ── akash docs ────────────────────────────────────────────────────────────────
-
-@app.command()
-def docs():
-    """Open the documentation."""
-    webbrowser.open("https://github.com/juniorsir/akashcli")
+        from .integrity import status as _status
+        s = _status()
+        if not s["sealed"]:
+            _warn(f"not sealed yet — run {_cy('akash check --seal')} to enable tamper detection")
+            return
+        if s["ok"]:
+            _ok(f"integrity OK — {s['files']} files verified")
+        else:
+            _err("tamper detected!")
+            print(s["message"], file=sys.stderr)
+            raise typer.Exit(2)
 
 
 # ── akash logout ─────────────────────────────────────────────────────────────
@@ -936,6 +983,12 @@ def run(
     try:
         api_key, base = _resolve_client(url)
 
+        # ── No key + device flag → relay needs auth ───────────────────────
+        if device is not None and not api_key:
+            print(_GUEST_WARNING)
+            _err("relay requires an API key. Run `akash login` first.")
+            raise typer.Exit(1)
+
         # ── Device relay path ─────────────────────────────────────────────
         if device is not None:
             from .relay import connect_run
@@ -952,6 +1005,22 @@ def run(
                 raise typer.Exit(exit_code)
             return
 
+        # ── No key → local execution fallback ────────────────────────────
+        if not api_key:
+            print(_GUEST_WARNING)
+            _p()
+            _info(f"running locally:  {command}")
+            _p()
+            import subprocess as _sp
+            result = _sp.run(command, shell=True)
+            _p()
+            if result.returncode == 0:
+                _info("exited 0")
+            else:
+                _warn(f"exited {result.returncode}")
+                raise typer.Exit(result.returncode)
+            return
+
         if reauth:
             _clear_cached_token()
             _info("cleared cached token — re-authenticating…")
@@ -1079,6 +1148,12 @@ def shell(
     try:
         api_key, base = _resolve_client(url)
 
+        # ── No key + device flag → relay needs auth ───────────────────────
+        if device is not None and not api_key:
+            print(_GUEST_WARNING)
+            _err("relay requires an API key. Run `akash login` first.")
+            raise typer.Exit(1)
+
         # ── Device relay path ─────────────────────────────────────────────
         if device is not None:
             from .relay import connect_shell
@@ -1095,6 +1170,20 @@ def shell(
                 raise typer.Exit(exit_code)
             return
 
+        # ── No key → local PTY shell fallback ────────────────────────────
+        if not api_key:
+            import shutil as _sh
+            print(_GUEST_WARNING)
+            _p()
+            shell_bin = os.environ.get("SHELL") or _sh.which("bash") or _sh.which("sh") or "/bin/sh"
+            _info(f"opening local shell  {_dim(shell_bin)}")
+            _p()
+            import subprocess as _sp
+            result = _sp.run([shell_bin])
+            _p()
+            _info("session closed")
+            raise typer.Exit(result.returncode)
+
         if reauth:
             _clear_cached_token()
             _info("cleared cached token — re-authenticating…")
@@ -1136,7 +1225,7 @@ def devices(
       akash devices --revoke laptop   remove a device
     """
     try:
-        api_key, base = _resolve_client()
+        api_key, base = _resolve_client(require_key=True)
     except typer.Exit:
         raise
     except Exception as e:
@@ -1242,7 +1331,7 @@ def serve(
         return
 
     try:
-        api_key, base = _resolve_client(url)
+        api_key, base = _resolve_client(url, require_key=True)
     except typer.Exit:
         raise
     except Exception as e:
@@ -1718,26 +1807,51 @@ def pipe(
     _p()
 
 
-# ── akash log ─────────────────────────────────────────────────────────────────
+# ── akash log (+ --stats) ─────────────────────────────────────────────────────
 
 @app.command(name="log")
 def cmd_log(
-    last:   int            = typer.Option(20,  "--last",  "-n", help="Show last N entries"),
-    op:     Optional[str]  = typer.Option(None,"--op",   "-o", help="Filter by operation type"),
-    raw:    bool           = typer.Option(False,"--json",       help="Raw JSON output"),
+    last:   int            = typer.Option(20,   "--last",  "-n", help="Show last N entries"),
+    op:     Optional[str]  = typer.Option(None, "--op",   "-o", help="Filter by operation type"),
+    raw:    bool           = typer.Option(False, "--json",        help="Raw JSON output"),
+    stats:  bool           = typer.Option(False, "--stats", "-s", help="Show summary instead of list"),
 ):
-    """Show operation history from ~/.akash/log.jsonl.
+    """Show operation history — or a summary with --stats.
 
     Examples:
       akash log                   last 20 operations
+      akash log --stats           summary with counts per operation
       akash log --last 50         last 50 operations
       akash log --op backup       only backup operations
       akash log --json            raw JSON (pipe to jq)
     """
-    from .logger import read_log
+    from .logger import read_log, log_summary
 
-    entries = read_log(last_n=last, op_filter=op)
+    if stats:
+        s = log_summary()
+        if s["total"] == 0:
+            _info("no log entries yet — run some commands first")
+            return
+        _p()
+        print(f"  {_C}◈{_RS}  operation history")
+        _p()
+        _info(f"total       {_ye(str(s['total']))}  "
+              f"({_G}{s['ok']} ok{_RS}" +
+              (f"  {_R}{s['fail']} failed{_RS}" if s["fail"] else "") + ")")
+        _p()
+        for oper, count in sorted(s["by_op"].items(), key=lambda x: -x[1]):
+            bar = "█" * min(count * 2, 24)
+            print(f"  {_C}{oper:<14}{_RS}  {_DM}{bar}{_RS}  {count}")
+        _p()
+        uploads = read_log(last_n=100, op_filter=None)
+        recent = [e for e in uploads if e.get("op") in ("backup", "pipe", "send", "cloud_upload") and e.get("code")]
+        if recent:
+            lu = recent[-1]
+            print(f"  {_DM}last upload  {_RS}{_ye(str(lu.get('code','?')))}  {_dim(str(lu.get('ts',''))[:16].replace('T',' '))}")
+        _p()
+        return
 
+    entries = read_log(last_n=last, op_filter=op)
     if not entries:
         _info("no log entries yet")
         return
@@ -1752,11 +1866,7 @@ def cmd_log(
         oper = e.get("op", "?")
         ok   = e.get("ok", True)
         icon = f"{_G}✓{_RS}" if ok else f"{_R}✗{_RS}"
-
-        # Build a short detail string from the payload
         detail_parts = []
-        for skip in ("ts", "op", "ok", "error"):
-            pass
         for k, v in e.items():
             if k in ("ts", "op", "ok"):
                 continue
@@ -1768,56 +1878,18 @@ def cmd_log(
                 detail_parts.append(f"{k}={_dim(str(v))}")
             else:
                 detail_parts.append(f"{k}={_dim(str(v)[:40])}")
-
         detail = "  ".join(detail_parts[:4])
         print(f"  {icon}  {_GR}{ts}{_RS}  {_C}{oper:<12}{_RS}  {detail}")
     _p()
 
 
-# ── akash stats ───────────────────────────────────────────────────────────────
-
-@app.command()
-def stats():
-    """Show a summary of your akash operation history."""
-    from .logger import log_summary, read_log
-
-    s = log_summary()
-    if s["total"] == 0:
-        _info("no log entries yet — run some commands first")
-        return
-
-    _p()
-    print(f"  {_C}◈{_RS}  operation history")
-    _p()
-    _info(f"total ops      {_ye(str(s['total']))}")
-    _info(f"succeeded      {_G}{s['ok']}{_RS}")
-    if s["fail"]:
-        _info(f"failed         {_R}{s['fail']}{_RS}")
-    _p()
-    print(f"  {_DM}by operation:{_RS}")
-    for op, count in sorted(s["by_op"].items(), key=lambda x: -x[1]):
-        bar_w = min(count * 2, 20)
-        bar   = "█" * bar_w
-        print(f"  {_C}{op:<14}{_RS}  {_dim(bar)}  {count}")
-    _p()
-
-    # Last upload code
-    uploads = read_log(last_n=100, op_filter=None)
-    recent  = [e for e in uploads if e.get("op") in ("backup", "pipe", "send", "cloud_upload") and e.get("code")]
-    if recent:
-        last_up = recent[-1]
-        print(f"  {_DM}last upload  {_RS}{_ye(str(last_up.get('code', '?')))}  "
-              f"{_dim(str(last_up.get('ts', ''))[:16].replace('T',' '))}")
-    _p()
-
-
 # ── akash env ─────────────────────────────────────────────────────────────────
 
 env_app = typer.Typer(
-    help="akash env — encrypted local .env file manager.",
+    help="Encrypted local .env store — set, get, push, pull.",
     rich_markup_mode=None,
 )
-app.add_typer(env_app, name="env", help="Encrypted .env manager (set/get/list/push/pull)")
+app.add_typer(env_app, name="env", help="set · get · push · pull encrypted .env variables")
 
 
 @env_app.command("list")

{akashcli-4.3.1 → akashcli-4.4.0}/akashcli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akashcli
-Version: 4.3.1
+Version: 4.4.0
 Summary: Akash CLI — secure remote shell relay, file vault, and device management
 License: MIT
 Keywords: akash,cli,relay,remote-shell,vault

{akashcli-4.3.1 → akashcli-4.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "akashcli"
-version = "4.3.1"
+version = "4.4.0"
 description = "Akash CLI — secure remote shell relay, file vault, and device management"
 readme = "README.md"
 requires-python = ">=3.9"