superwise-sentinel-cli 0.3.0__tar.gz → 0.3.1__tar.gz

{superwise_sentinel_cli-0.3.0 → superwise_sentinel_cli-0.3.1}/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.3.0](https://gitlab.com/askboss/product/superwise/platform/sentinel-cli/compare/0.2.3...0.3.0) (2026-09-16)
+
+
+### <!-- 1. -->:rocket: New Features
+
+* configure codex ([16acd79](https://gitlab.com/askboss/product/superwise/platform/sentinel-cli/commit/16acd797fa82669ec3d195fbee8c50e1b4ab0055))
+
+
+### <!-- 2. -->:bug: Bug Fixes
+
+* configure sentinel-cli request timeout ([a2597b7](https://gitlab.com/askboss/product/superwise/platform/sentinel-cli/commit/a2597b742136bb5b05baa046e2a13340b75577cc))
+
 ## [0.2.3](https://gitlab.com/askboss/product/superwise/platform/sentinel-cli/compare/0.2.2...0.2.3) (2026-08-25)
 
 

{superwise_sentinel_cli-0.3.0 → superwise_sentinel_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: superwise-sentinel-cli
-Version: 0.3.0
+Version: 0.3.1
 Summary: Sentinel is an LLM proxy that intercepts traffic, enabling you to monitor, secure, and optimize your AI usage. This CLI tool helps you quickly set up traffic interception on this machine
 Requires-Python: <4.0,>=3.11
 Requires-Dist: click>=8.1

superwise_sentinel_cli-0.3.1/build.env

@@ -0,0 +1 @@
+RELEASED_VERSION=0.3.1

{superwise_sentinel_cli-0.3.0 → superwise_sentinel_cli-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "superwise-sentinel-cli"
-version = "0.3.0"
+version = "0.3.1"
 description = "Sentinel is an LLM proxy that intercepts traffic, enabling you to monitor, secure, and optimize your AI usage. This CLI tool helps you quickly set up traffic interception on this machine"
 requires-python = ">=3.11, <4.0"
 dependencies = [

{superwise_sentinel_cli-0.3.0 → superwise_sentinel_cli-0.3.1}/src/superwise_sentinel_cli/cli.py

@@ -13,6 +13,7 @@ from superwise_sentinel_cli.config import AppConfig
 from superwise_sentinel_cli.config import CustomProvider
 from superwise_sentinel_cli.config import VALID_APPS
 from superwise_sentinel_cli.config import VALID_PROVIDERS
+from superwise_sentinel_cli.controller import check_gateway_health
 from superwise_sentinel_cli.controller import check_invalid_apps
 from superwise_sentinel_cli.controller import check_invalid_providers
 from superwise_sentinel_cli.controller import clear_env_vars
@@ -20,6 +21,7 @@ from superwise_sentinel_cli.controller import get_activation_url
 from superwise_sentinel_cli.controller import get_proxy_status
 from superwise_sentinel_cli.controller import get_running_gateway
 from superwise_sentinel_cli.controller import get_sentinel_url
+from superwise_sentinel_cli.controller import is_docker_running
 from superwise_sentinel_cli.controller import needs_auth
 from superwise_sentinel_cli.controller import parse_apps
 from superwise_sentinel_cli.controller import parse_providers
@@ -105,10 +107,20 @@ def main() -> None:
 @click.pass_context
 def quickstart_flow(ctx, new_sentinel: bool) -> None:
     """Configure your first sentinel proxy."""
-    if new_sentinel or not click.confirm("Do you want to use an existing gateway?"):
+    click.echo(
+        """Welcome to SUPERWISE Sentinel!
+The Sentinel proxy routes your local LLM traffic through a secure gateway, enabling guardrails and optimizations.
+Select your gateway setup:
+A) Provide the URL for an existing gateway.
+B) Create a new gateway locally. Docker needs to be installed and running on this machine."""
+    )
+    if new_sentinel or not click.confirm("Do you have a URL for an existing gateway?"):
         ctx.invoke(start_gateway, new_sentinel=new_sentinel)
     else:
         ctx.invoke(config_url)
+    gateway_text = click.style("gateway", fg="green")
+    proxy_text = click.style("proxy", fg="yellow")
+    click.echo(f"\nWith the {gateway_text} ready, let's customize our {proxy_text} traffic routing.")
     ctx.invoke(config_providers)
     ctx.invoke(config_apps)
     ctx.invoke(start_proxy)
@@ -210,7 +222,9 @@ def start_gateway(
     force: bool,
     timeout_seconds: int | None,
 ) -> None:
-    """Bootstrap & run a local Sentinel gateway container."""
+    """Bootstrap & run a local Sentinel gateway container. Accessible only from this machine."""
+    if not is_docker_running():
+        raise click.ClickException("Docker is not responsive. Is it running?")
     cfg = AppConfig.load()
 
     if custom_providers:
@@ -259,13 +273,16 @@ def start_gateway(
 
     if created_name:
         click.echo(f"New sentinel '{created_name}' created. Sentinel ID: {cfg.sentinel_id}.")
+    local_notice = click.style("This gateway is local, and accessible only from this machine.", fg="cyan")
     click.echo(
-        f"Gateway running on {url} with sentinel ID: {cfg.sentinel_id}. Configuration updated to match."
+        f"Gateway created and running on {url}!"
         f"\nTo view Sentinel configuration and metrics, please visit {get_sentinel_url(cfg)}"
+        f"\n{local_notice}"
     )
     if timeout_seconds is not None:
         click.echo(f"Timeout set to {timeout_seconds} seconds.")
-    click.echo("Want to test it out? Run 'sentinel test --text \"Your text here\"' to see it in action.")
+    test_command = click.style('sentinel test --text "Your text here"', italic=True)
+    click.echo(f"\nWant to test it out? Run '{test_command}' to see it in action.")
 
 
 @gateway.command("stop")
@@ -296,7 +313,12 @@ def update_gateway() -> None:
         click.echo("Image is up to date.")
 
 
-@main.group("config", invoke_without_command=True)
+@main.group()
+def proxy() -> None:
+    """Toggle traffic interception."""
+
+
+@proxy.group("config", invoke_without_command=True)
 @click.option("--url", "url_value", default=None, help="Set the gateway URL non-interactively.")
 @click.option(
     "--providers",
@@ -412,11 +434,6 @@ def config_apps(set_value: str | None) -> None:
         break
 
 
-@main.group()
-def proxy() -> None:
-    """Toggle traffic interception."""
-
-
 @proxy.command("on")
 @click.pass_context
 def start_proxy(ctx) -> None:
@@ -429,6 +446,13 @@ def start_proxy(ctx) -> None:
     if not cfg.providers:
         ctx.invoke(config_providers)
 
+    if not check_gateway_health(cfg.gateway_url):
+        click.echo(
+            f"Gateway at {cfg.gateway_url} did not respond in a timely manner."
+            f" Please verify it is healthy and try again."
+        )
+        return
+
     cfg = AppConfig.load()
     pairs = update_env_vars(cfg)
 

{superwise_sentinel_cli-0.3.0 → superwise_sentinel_cli-0.3.1}/src/superwise_sentinel_cli/controller.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import json
 import os
+import time
 
 import requests
 from superwise_sentinel_cli.auth import authenticate
@@ -14,6 +15,7 @@ from superwise_sentinel_cli.config import VALID_APPS
 from superwise_sentinel_cli.config import VALID_PROVIDERS
 from superwise_sentinel_cli.docker_manager import ensure_container_running
 from superwise_sentinel_cli.docker_manager import get_running_gateway_info
+from superwise_sentinel_cli.docker_manager import is_docker_running
 from superwise_sentinel_cli.docker_manager import pull_latest_image
 from superwise_sentinel_cli.docker_manager import stop_container
 from superwise_sentinel_cli.exceptions import AuthenticationError
@@ -156,6 +158,20 @@ def update_env_vars(cfg: AppConfig) -> list[tuple[str, str]]:
     return pairs
 
 
+def check_gateway_health(gateway_url: str, retries: int = 3, delay_seconds: float = 1.0) -> bool:
+    url = gateway_url.rstrip("/") + "/healthz"
+    for attempt in range(retries):
+        try:
+            resp = requests.get(url, timeout=5)
+            if resp.ok:
+                return True
+        except requests.RequestException:
+            pass
+        if attempt < retries - 1:
+            time.sleep(delay_seconds)
+    return False
+
+
 def write_codex_config(cfg: AppConfig) -> bool:
     if "openai" not in cfg.providers or "codex" not in cfg.apps:
         return False

{superwise_sentinel_cli-0.3.0 → superwise_sentinel_cli-0.3.1}/src/superwise_sentinel_cli/docker_manager.py

@@ -35,6 +35,14 @@ def _docker_client() -> docker.DockerClient:
         raise DockerUnavailableError() from exc
 
 
+def is_docker_running() -> bool:
+    try:
+        _docker_client()
+        return True
+    except DockerUnavailableError:
+        return False
+
+
 def _running_container(client: docker.DockerClient) -> Container | None:
     matches = client.containers.list(filters={"name": CONTAINER_NAME, "status": "running"})
     return matches[0] if matches else None

superwise_sentinel_cli-0.3.0/build.env

@@ -1 +0,0 @@
-RELEASED_VERSION=0.3.0