artificial-intelligence-usage 0.0.3__tar.gz → 0.0.4__tar.gz

{artificial_intelligence_usage-0.0.3 → artificial_intelligence_usage-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: artificial-intelligence-usage
-Version: 0.0.3
+Version: 0.0.4
 Summary: Analyze usage of artificial intelligence tool.
 Author: Kaizten Analytics
 License-Expression: LicenseRef-Proprietary
@@ -17,6 +17,8 @@ latest session followed by daily session, turn, token, and rate-limit usage.
 ## Behavior
 
 - Reads rollout files below `~/.codex/sessions`.
+- Shows the installed Codex and Claude CLI versions when those commands are
+  available.
 - Shows status details from the most recently modified session.
 - Reports sessions from the last 14 calendar days by default, including today.
 - Counts user turns and cumulative tokens for each session.

{artificial_intelligence_usage-0.0.3 → artificial_intelligence_usage-0.0.4}/README.md

@@ -6,6 +6,8 @@ latest session followed by daily session, turn, token, and rate-limit usage.
 ## Behavior
 
 - Reads rollout files below `~/.codex/sessions`.
+- Shows the installed Codex and Claude CLI versions when those commands are
+  available.
 - Shows status details from the most recently modified session.
 - Reports sessions from the last 14 calendar days by default, including today.
 - Counts user turns and cumulative tokens for each session.

{artificial_intelligence_usage-0.0.3 → artificial_intelligence_usage-0.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "artificial-intelligence-usage"
-version = "0.0.3"
+version = "0.0.4"
 description = "Analyze usage of artificial intelligence tool."
 readme = "README.md"
 requires-python = ">=3.10"

{artificial_intelligence_usage-0.0.3 → artificial_intelligence_usage-0.0.4}/src/artificial_intelligence_usage.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: artificial-intelligence-usage
-Version: 0.0.3
+Version: 0.0.4
 Summary: Analyze usage of artificial intelligence tool.
 Author: Kaizten Analytics
 License-Expression: LicenseRef-Proprietary
@@ -17,6 +17,8 @@ latest session followed by daily session, turn, token, and rate-limit usage.
 ## Behavior
 
 - Reads rollout files below `~/.codex/sessions`.
+- Shows the installed Codex and Claude CLI versions when those commands are
+  available.
 - Shows status details from the most recently modified session.
 - Reports sessions from the last 14 calendar days by default, including today.
 - Counts user turns and cumulative tokens for each session.

{artificial_intelligence_usage-0.0.3 → artificial_intelligence_usage-0.0.4}/src/artificial_intelligence_usage.py

@@ -5,6 +5,8 @@ from __future__ import annotations
 
 import argparse
 import json
+import shutil
+import subprocess
 from collections import Counter, defaultdict
 from datetime import date, datetime, timedelta
 from pathlib import Path
@@ -12,6 +14,7 @@ from typing import Any
 
 
 DEFAULT_DAYS = 14
+SUPPORTED_TOOLS = (("Codex", "codex"), ("Claude", "claude"))
 
 
 def positive_int(value: str) -> int:
@@ -27,6 +30,53 @@ def positive_int(value: str) -> int:
     return number
 
 
+def installed_tool_version(command: str) -> str | None:
+    """Return an installed command's version output, or ``None`` if absent."""
+    executable = shutil.which(command)
+    if executable is None:
+        return None
+
+    try:
+        result = subprocess.run(
+            [executable, "--version"],
+            capture_output=True,
+            check=False,
+            text=True,
+            timeout=5,
+        )
+    except (OSError, subprocess.TimeoutExpired):
+        return "unknown"
+
+    output = result.stdout.strip() or result.stderr.strip()
+    if not output:
+        return "unknown"
+
+    return " ".join(output.splitlines()[0].split())
+
+
+def detect_installed_tool_versions() -> dict[str, str]:
+    """Return versions for the supported AI command-line tools that exist."""
+    versions = {}
+    for name, command in SUPPORTED_TOOLS:
+        version = installed_tool_version(command)
+        if version is not None:
+            versions[name] = version
+    return versions
+
+
+def print_installed_tool_versions(versions: dict[str, str]) -> None:
+    """Print installed AI command-line tool versions when any are present."""
+    if not versions:
+        return
+
+    print("Installed AI tools")
+    print("-" * 57)
+    for name, _command in SUPPORTED_TOOLS:
+        if name in versions:
+            print(f"{name + ':':<16} {versions[name]}")
+    print()
+
+
 def format_timestamp(value: str | int | float | None) -> str:
     """Format an ISO or Unix timestamp in the local timezone."""
     try:
@@ -260,7 +310,12 @@ def build_parser() -> argparse.ArgumentParser:
     return parser
 
 
-def run_report(sessions_dir: Path, days: int, today: date | None = None) -> int:
+def run_report(
+    sessions_dir: Path,
+    days: int,
+    today: date | None = None,
+    tool_versions: dict[str, str] | None = None,
+) -> int:
     """Analyze sessions and print the status and daily usage report."""
     current_day = today or date.today()
     first_day = current_day - timedelta(days=days - 1)
@@ -269,6 +324,10 @@ def run_report(sessions_dir: Path, days: int, today: date | None = None) -> int:
     token_counts: Counter[str] = Counter()
     last_session_by_date: dict[str, Path] = {}
 
+    if tool_versions is None:
+        tool_versions = detect_installed_tool_versions()
+    print_installed_tool_versions(tool_versions)
+
     all_session_files = list(sessions_dir.glob("*/*/*/rollout-*.jsonl"))
     latest_session = (
         max(all_session_files, key=lambda path: path.stat().st_mtime)

{artificial_intelligence_usage-0.0.3 → artificial_intelligence_usage-0.0.4}/tests/test_artificial_intelligence_usage.py

@@ -73,6 +73,63 @@ class ArtificialIntelligenceUsageTests(unittest.TestCase):
         with self.assertRaisesRegex(Exception, "must be an integer"):
             artificial_intelligence_usage.positive_int("nope")
 
+    def test_installed_tool_version_returns_none_when_command_is_absent(self):
+        with patch.object(
+            artificial_intelligence_usage.shutil, "which", return_value=None
+        ):
+            self.assertIsNone(
+                artificial_intelligence_usage.installed_tool_version("codex")
+            )
+
+    def test_installed_tool_version_reads_version_from_command(self):
+        completed = artificial_intelligence_usage.subprocess.CompletedProcess(
+            args=["/tools/codex", "--version"],
+            returncode=0,
+            stdout="codex-cli 1.2.3\n",
+            stderr="",
+        )
+        with (
+            patch.object(
+                artificial_intelligence_usage.shutil,
+                "which",
+                return_value="/tools/codex",
+            ),
+            patch.object(
+                artificial_intelligence_usage.subprocess,
+                "run",
+                return_value=completed,
+            ) as run,
+        ):
+            version = artificial_intelligence_usage.installed_tool_version("codex")
+
+        self.assertEqual(version, "codex-cli 1.2.3")
+        run.assert_called_once_with(
+            ["/tools/codex", "--version"],
+            capture_output=True,
+            check=False,
+            text=True,
+            timeout=5,
+        )
+
+    def test_report_includes_installed_codex_and_claude_versions(self):
+        with tempfile.TemporaryDirectory() as directory:
+            output = io.StringIO()
+            with contextlib.redirect_stdout(output):
+                artificial_intelligence_usage.run_report(
+                    Path(directory),
+                    days=14,
+                    today=date(2026, 10, 4),
+                    tool_versions={
+                        "Codex": "codex-cli 1.2.3",
+                        "Claude": "2.0.1 (Claude Code)",
+                    },
+                )
+
+        report = output.getvalue()
+        self.assertIn("Installed AI tools", report)
+        self.assertIn("Codex:           codex-cli 1.2.3", report)
+        self.assertIn("Claude:          2.0.1 (Claude Code)", report)
+
     def test_analyze_session_ignores_malformed_lines_and_uses_maximum_tokens(self):
         with tempfile.TemporaryDirectory() as directory:
             session_file = Path(directory) / "rollout-test.jsonl"
@@ -118,7 +175,10 @@ class ArtificialIntelligenceUsageTests(unittest.TestCase):
             output = io.StringIO()
             with contextlib.redirect_stdout(output):
                 result = artificial_intelligence_usage.run_report(
-                    Path(directory), days=14, today=date(2026, 10, 4)
+                    Path(directory),
+                    days=14,
+                    today=date(2026, 10, 4),
+                    tool_versions={},
                 )
 
         self.assertEqual(result, 0)
@@ -170,7 +230,10 @@ class ArtificialIntelligenceUsageTests(unittest.TestCase):
             output = io.StringIO()
             with contextlib.redirect_stdout(output):
                 result = artificial_intelligence_usage.run_report(
-                    sessions_dir, days=2, today=date(2026, 10, 4)
+                    sessions_dir,
+                    days=2,
+                    today=date(2026, 10, 4),
+                    tool_versions={},
                 )
 
         report = output.getvalue()