sernixa-cli 0.4.2__tar.gz → 0.4.3__tar.gz

{sernixa_cli-0.4.2 → sernixa_cli-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sernixa-cli
-Version: 0.4.2
+Version: 0.4.3
 Summary: Official Sernixa CLI for policy-governed local AI agent actions
 Author: Sernixa Team
 License-Expression: MIT
@@ -22,7 +22,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: platformdirs>=4.0.0
 Requires-Dist: prompt-toolkit>=3.0.48
 Requires-Dist: rich>=13.8.0
-Requires-Dist: sernixa>=0.4.1
+Requires-Dist: sernixa>=0.4.2
 Requires-Dist: sernixa-agent>=1.6.1
 Requires-Dist: typer>=0.12.0
 

{sernixa_cli-0.4.2 → sernixa_cli-0.4.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sernixa-cli"
-version = "0.4.2"
+version = "0.4.3"
 description = "Official Sernixa CLI for policy-governed local AI agent actions"
 readme = "README.md"
 license = "MIT"
@@ -21,7 +21,7 @@ dependencies = [
     "platformdirs>=4.0.0",
     "prompt-toolkit>=3.0.48",
     "rich>=13.8.0",
-    "sernixa>=0.4.1",
+    "sernixa>=0.4.2",
     "sernixa-agent>=1.6.1",
     "typer>=0.12.0",
 ]

{sernixa_cli-0.4.2 → sernixa_cli-0.4.3}/sernixa_cli/__init__.py

@@ -1,3 +1,3 @@
 """Official Sernixa command-line client."""
 
-__version__ = "0.4.2"
+__version__ = "0.4.3"

{sernixa_cli-0.4.2 → sernixa_cli-0.4.3}/sernixa_cli/config.py

@@ -6,6 +6,7 @@ import unicodedata
 from dataclasses import asdict, dataclass
 from pathlib import Path
 from typing import Literal
+from uuid import uuid4
 
 from platformdirs import user_config_path
 
@@ -51,6 +52,42 @@ def plan_session_path() -> Path:
     return user_config_path("sernixa", appauthor=False) / "plan-session.json"
 
 
+def installation_id_path() -> Path:
+    override = os.getenv("SERNIXA_INSTALLATION_FILE", "").strip()
+    if override:
+        return Path(override).expanduser()
+    return user_config_path("sernixa", appauthor=False) / "installation.json"
+
+
+def load_or_create_installation_id() -> str:
+    """Return a stable local ID that the API immediately hashes with the org ID."""
+    path = installation_id_path()
+    if path.exists():
+        try:
+            payload = json.loads(path.read_text(encoding="utf-8"))
+        except (OSError, json.JSONDecodeError) as exc:
+            raise ConfigError(f"Installation identity file is unreadable: {path}") from exc
+        installation_id = (
+            str(payload.get("installation_id") or "") if isinstance(payload, dict) else ""
+        )
+        if 16 <= len(installation_id) <= 128:
+            return installation_id
+
+    installation_id = uuid4().hex
+    path.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
+    temporary = path.with_suffix(path.suffix + ".tmp")
+    temporary.write_text(
+        json.dumps({"installation_id": installation_id}, separators=(",", ":")) + "\n",
+        encoding="utf-8",
+    )
+    if os.name == "posix":
+        temporary.chmod(0o600)
+    temporary.replace(path)
+    if os.name == "posix":
+        path.chmod(0o600)
+    return installation_id
+
+
 def save_plan_session(evaluation: dict[str, object]) -> Path:
     token = evaluation.get("plan_token")
     proofs = evaluation.get("step_proofs")

{sernixa_cli-0.4.2 → sernixa_cli-0.4.3}/sernixa_cli/main.py

@@ -34,6 +34,7 @@ from .config import (
     ConfigError,
     config_path,
     load_config,
+    load_or_create_installation_id,
     normalize_api_key,
     normalize_base_url,
     remove_config,
@@ -181,6 +182,44 @@ def _print_banner() -> None:
     typer.echo("Govern every agent action.")
 
 
+def _platform_family() -> Literal["macos", "windows", "linux", "other"]:
+    value = platform.system().casefold()
+    if value == "darwin":
+        return "macos"
+    if value == "windows":
+        return "windows"
+    if value == "linux":
+        return "linux"
+    return "other"
+
+
+def _observed_integrations() -> list[str]:
+    integrations: list[str] = []
+    for target, status in all_target_statuses().items():
+        if not (status.get("wrapper_valid") or status.get("sernixa_installed")):
+            continue
+        normalized = "claude" if target == "claude-desktop" else target
+        if normalized in {"codex", "claude", "cursor", "langchain", "mcp"}:
+            integrations.append(normalized)
+    return list(dict.fromkeys(integrations))
+
+
+def _record_cli_installation(client: Client, *, integrations: list[str] | None = None) -> None:
+    """Best-effort telemetry must never make sign-in or setup fail."""
+    recorder = getattr(client, "record_installation", None)
+    if not callable(recorder):
+        return
+    try:
+        recorder(
+            installation_id=load_or_create_installation_id(),
+            version=__version__,
+            platform=_platform_family(),
+            integrations=integrations if integrations is not None else _observed_integrations(),
+        )
+    except (ConfigError, OSError, SernixaError):
+        return
+
+
 def _interactive_terminal() -> bool:
     return sys.stdin.isatty() and sys.stdout.isatty()
 
@@ -363,6 +402,51 @@ def _render_console_help() -> None:
     typer.echo("  @exit          Close the session")
     typer.echo("Slash-prefixed forms remain supported for compatibility.")
     typer.echo("Any normal command also works, for example: validate request.json")
+    typer.echo("Run PowerShell and Python snippets in the host terminal, not at sernixa ›.")
+
+
+def _console_input_guidance(raw: str) -> str | None:
+    """Explain common host-language pastes instead of reporting a false CLI error."""
+    stripped = raw.strip()
+    lowered = stripped.casefold()
+    if (
+        lowered.startswith(("$env:", "setx ", "set ", "export "))
+        or ".trim()" in lowered
+    ):
+        return (
+            "That is a host-shell environment command. Type @exit, run it in "
+            "PowerShell or your system terminal, then start `sernixa` again."
+        )
+    python_prefixes = (
+        "from ",
+        "import ",
+        "for ",
+        "while ",
+        "if ",
+        "def ",
+        "class ",
+        "print(",
+        "python ",
+        "py ",
+    )
+    looks_like_python_assignment = (
+        "=" in stripped
+        and not lowered.startswith(("@", "/", "sernixa "))
+        and any(
+            token in lowered
+            for token in ("client", "decision", "surface", "schema_version")
+        )
+    )
+    if (
+        lowered.startswith(python_prefixes)
+        or looks_like_python_assignment
+        or stripped.startswith(("{", "}", "[", "]", '"', "'"))
+    ):
+        return (
+            "That is Python code, not a Sernixa console command. Type @exit, "
+            "start `python` (or run a .py file), then execute the snippet there."
+        )
+    return None
 
 
 def _resolve_console_command(raw: str) -> tuple[str, list[str]]:
@@ -463,7 +547,10 @@ def _run_interactive_console(
             elif action == "already_open":
                 typer.echo("The Sernixa console is already open.")
             elif action in {"invalid", "unknown"}:
-                typer.echo("Unknown command. Type @help for available actions.")
+                typer.echo(
+                    _console_input_guidance(raw)
+                    or "Unknown command. Type @help for available actions."
+                )
             elif action == "execute":
                 try:
                     execute(argv)
@@ -840,6 +927,7 @@ def auth_login(
                     expires_at=expires_at,
                 )
             )
+        _record_cli_installation(client)
     except (ConfigError, SernixaError) as exc:
         _tool_error(str(exc))
         raise typer.Exit(2) from exc
@@ -1193,6 +1281,7 @@ def setup(
         "auth": {"configured": False, "valid": False},
         "host_tools": _host_tool_statuses(),
     }
+    client: Client | None = None
     try:
         client, _ = _client()
         identity = client.whoami()
@@ -1256,6 +1345,15 @@ def setup(
                 failed = True
                 payload["launcher"] = {"status": "failed", "error": str(exc)}
     payload["healthy"] = not failed and bool(payload["auth"]["valid"])
+    if not dry_run and payload["auth"]["valid"] and client is not None:
+        _record_cli_installation(
+            client,
+            integrations=[
+                "claude" if target == "claude-desktop" else target
+                for target, result in payload["targets"].items()
+                if result.get("status") not in {"manual_required", "failed"}
+            ],
+        )
     if json_output:
         typer.echo(json.dumps(payload, sort_keys=True))
     else:

{sernixa_cli-0.4.2 → sernixa_cli-0.4.3}/sernixa_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sernixa-cli
-Version: 0.4.2
+Version: 0.4.3
 Summary: Official Sernixa CLI for policy-governed local AI agent actions
 Author: Sernixa Team
 License-Expression: MIT
@@ -22,7 +22,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: platformdirs>=4.0.0
 Requires-Dist: prompt-toolkit>=3.0.48
 Requires-Dist: rich>=13.8.0
-Requires-Dist: sernixa>=0.4.1
+Requires-Dist: sernixa>=0.4.2
 Requires-Dist: sernixa-agent>=1.6.1
 Requires-Dist: typer>=0.12.0
 

{sernixa_cli-0.4.2 → sernixa_cli-0.4.3}/sernixa_cli.egg-info/requires.txt

@@ -1,6 +1,6 @@
 platformdirs>=4.0.0
 prompt-toolkit>=3.0.48
 rich>=13.8.0
-sernixa>=0.4.1
+sernixa>=0.4.2
 sernixa-agent>=1.6.1
 typer>=0.12.0

{sernixa_cli-0.4.2 → sernixa_cli-0.4.3}/tests/test_cli.py

@@ -18,7 +18,9 @@ from sernixa_cli.config import (
     CliConfig,
     ConfigError,
     config_path,
+    installation_id_path,
     load_config,
+    load_or_create_installation_id,
     normalize_api_key,
     save_config,
 )
@@ -29,6 +31,16 @@ from sernixa_cli.local_agent_targets import hook_snippet
 runner = CliRunner()
 
 
+@pytest.fixture(autouse=True)
+def _isolate_installation_identity(
+    monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+) -> None:
+    monkeypatch.setenv(
+        "SERNIXA_INSTALLATION_FILE",
+        str(tmp_path / "sernixa-installation.json"),
+    )
+
+
 def _configure(monkeypatch, tmp_path: Path) -> Path:
     path = tmp_path / "sernixa-config.json"
     monkeypatch.setenv("SERNIXA_CONFIG_FILE", str(path))
@@ -51,6 +63,23 @@ def test_config_round_trip_uses_private_permissions(
         assert path.stat().st_mode & 0o777 == 0o600
 
 
+def test_installation_identity_is_stable_and_private(
+    monkeypatch: pytest.MonkeyPatch,
+    tmp_path: Path,
+) -> None:
+    path = tmp_path / "installation.json"
+    monkeypatch.setenv("SERNIXA_INSTALLATION_FILE", str(path))
+
+    first = load_or_create_installation_id()
+    second = load_or_create_installation_id()
+
+    assert first == second
+    assert len(first) == 32
+    assert installation_id_path() == path
+    if os.name == "posix":
+        assert path.stat().st_mode & 0o777 == 0o600
+
+
 def test_auth_login_validates_before_saving_and_config_show_hides_secret(
     monkeypatch,
     tmp_path: Path,
@@ -65,7 +94,10 @@ def test_auth_login_validates_before_saving_and_config_show_hides_secret(
     }
     client.current_plan.return_value = {"plan": {"id": "free", "name": "Free"}}
 
-    with patch("sernixa_cli.main.Client", return_value=client):
+    with (
+        patch("sernixa_cli.main.Client", return_value=client),
+        patch("sernixa_cli.main._observed_integrations", return_value=["codex"]),
+    ):
         login = runner.invoke(
             app,
             ["auth", "login", "--base-url", "https://api.test", "--api-key-stdin"],
@@ -78,6 +110,11 @@ def test_auth_login_validates_before_saving_and_config_show_hides_secret(
     assert json.loads(path.read_text(encoding="utf-8"))["api_key"] == (
         "srnx_live_login_secret"
     )
+    client.record_installation.assert_called_once()
+    observation = client.record_installation.call_args.kwargs
+    assert observation["version"] == __version__
+    assert observation["integrations"] == ["codex"]
+    assert len(observation["installation_id"]) == 32
 
     shown = runner.invoke(app, ["config", "show"])
     assert shown.exit_code == 0
@@ -168,6 +205,33 @@ def test_auth_login_accepts_secure_stdin_for_powershell_clipboard(
     client.whoami.assert_called_once_with()
 
 
+def test_auth_login_succeeds_when_telemetry_is_unavailable(
+    monkeypatch: pytest.MonkeyPatch,
+    tmp_path: Path,
+) -> None:
+    path = tmp_path / "login-config.json"
+    monkeypatch.setenv("SERNIXA_CONFIG_FILE", str(path))
+    client = MagicMock()
+    client.whoami.return_value = {"organization_id": "org_windows"}
+    client.current_plan.return_value = {"plan": {"name": "Free"}}
+    client.record_installation.side_effect = SernixaApiError("telemetry unavailable")
+
+    with patch("sernixa_cli.main.Client", return_value=client):
+        login = runner.invoke(
+            app,
+            ["auth", "login", "--api-key-stdin"],
+            input="srnx_live_windows_secret\n",
+        )
+
+    assert login.exit_code == 0
+    assert "Signed in · org_windows · Free" in login.stdout
+    assert "telemetry" not in login.stdout.casefold()
+
+
+def test_installation_telemetry_is_compatible_with_an_older_sdk() -> None:
+    cli_main._record_cli_installation(SimpleNamespace())
+
+
 def test_auth_login_stdin_mode_refuses_to_wait_on_an_interactive_terminal(
     monkeypatch,
     tmp_path: Path,
@@ -659,6 +723,31 @@ def test_interactive_console_runs_multiple_real_commands_and_exits_cleanly(
     assert "Session closed." in output
 
 
+def test_interactive_console_explains_windows_and_python_pastes(
+    monkeypatch, tmp_path: Path, capsys
+) -> None:
+    commands = iter(
+        [
+            '$env:SERNIXA_BASE_URL = "https://api.sernixa.com"',
+            "from sernixa import Client",
+            "client = Client()",
+            "@exit",
+        ]
+    )
+    monkeypatch.setenv("SERNIXA_HISTORY_FILE", str(tmp_path / "history"))
+
+    cli_main._run_interactive_console(
+        read_command=lambda _: next(commands),
+        execute=lambda argv: 0,
+    )
+
+    output = capsys.readouterr().out
+    assert "run it in PowerShell or your system terminal" in output
+    assert "That is Python code" in output
+    assert "Unknown command" not in output
+    assert "Session closed." in output
+
+
 def test_console_history_is_private_and_console_commands_are_discoverable(
     monkeypatch, tmp_path: Path
 ) -> None: