Release 2.0.0

README.md

@@ -6,7 +6,9 @@
     ▐   ▐        █▀█ █ ▀█  █  █▄█ █ ▀█
     ▐   ▐
 ```
+
 # Meet Anton - an agent that gets real work done
+
 Anton is a personal AI agent that helps you get actual-work done. Tell it what you need in plain language and it takes it from there - sending emails, calling APIs, connecting to data sources, building dashboards, and delivering results. No setup, no plugins, no fuss.
 
 It doesn't just answer questions. It *does things*: cleans your inbox, builds integrations, analyzes your data, automates workflows - whatever the task requires.
@@ -77,7 +79,9 @@ Set up a WhatsApp integration so I can message you from my phone.
 
 Anton doesn't wait for someone to build a connector. It writes the integration code itself, sets it up, and gets it running - so you can chat with it from WhatsApp, Telegram, or whatever channel you need.
 
+
 ### 🔧 Ask for anything that requires action
+
 - **Send emails** - connect accounts, draft messages or even send them on your behalf.
 - **Manage Calendarss** - Summarize your day, create meetings, block time, etc. All just by asking.
 - **Automated reporting** - pull from multiple databases, crunch numbers, deliver a report on a schedule.

anton/__init__.py

@@ -1 +1 @@
-__version__ = "1.1.5"
+__version__ = "2.0.0"

anton/analytics.py

@@ -1,30 +1,96 @@
 """Fire-and-forget anonymous analytics events.
 
 Every call spawns a daemon thread that issues a single GET request to the
-configured analytics URL.  The request carries only the action name and a
-timestamp — no PII, no payload beyond what the query string contains.
+configured analytics URL.  The request carries only the action name, a
+timestamp, and an anonymous machine fingerprint — no PII, no payload
+beyond what the query string contains.
 
 Guarantees:
   • Never blocks the caller.
   • Never raises — all exceptions are silently swallowed.
   • Daemon threads die automatically when the process exits.
+
+Machine fingerprint
+===================
+
+Each event includes an ``aid`` (Anton Installation ID) — a deterministic
+SHA-256 hash of the machine's MAC address (``uuid.getnode()``).  This is:
+
+  • **Anonymous**: the hash is one-way; the raw MAC never leaves the
+    device.  No hostname, no platform, no PII.
+  • **Stateless**: no file on normal machines — computed from the MAC.
+  • **Stable**: changes only if the primary network adapter changes.
+
+Fallback for Docker / containers: if Python can't find a real MAC
+(detected via the multicast bit), a random UUID is persisted to
+``~/.anton/.installation_id`` so it stays stable across restarts.
+File I/O only happens in this edge case — normal desktops never
+touch disk.
+
+The ``aid`` is truncated to 16 hex characters (~64 bits of entropy) —
+enough to be collision-free across millions of installations, short
+enough to be a readable query parameter.
 """
 
 from __future__ import annotations
 
+import hashlib
 import threading
 import time
 import urllib.parse
 import urllib.request
+import uuid
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
     from anton.config.settings import AntonSettings
 
 _TIMEOUT = 3  # seconds
 
+# Cached after first computation — the fingerprint never changes within
+# a process, so computing it once is sufficient.
+_cached_aid: str | None = None
+
+
+def get_installation_id() -> str:
+    """Return a deterministic, anonymous machine fingerprint.
+
+    The fingerprint is a truncated SHA-256 of the MAC address on normal
+    machines. If no real MAC is available (Docker containers with stripped
+    networking), a random UUID is persisted to ``~/.anton/.installation_id``
+    as a one-time fallback. Computed once per process and cached.
+
+    Returns:
+        A 16-character hex string (64 bits of entropy).
+    """
+    global _cached_aid
+    if _cached_aid is not None:
+        return _cached_aid
+
+    try:
+        node = uuid.getnode()
+        is_random_fallback = bool(node & (1 << 40))  # multicast bit = Python faked it
+
+        if is_random_fallback:
+            # No real MAC (e.g. Docker with stripped networking).
+            # Persist a UUID to disk so it's stable across restarts.
+            from pathlib import Path
+
+            path = Path("~/.anton/.installation_id").expanduser()
+            if path.is_file():
+                _cached_aid = path.read_text(encoding="utf-8").strip()[:16]
+            else:
+                _cached_aid = uuid.uuid4().hex[:16]
+                path.parent.mkdir(parents=True, exist_ok=True)
+                path.write_text(_cached_aid + "\n", encoding="utf-8")
+        else:
+            _cached_aid = hashlib.sha256(str(node).encode()).hexdigest()[:16]
+    except Exception:
+        _cached_aid = "unknown"
+    return _cached_aid
+
 
-def send_event(settings: AntonSettings, action: str, **extra: str) -> None:
+def send_event(settings: "AntonSettings", action: str, **extra: str) -> None:
     """Send an analytics event in a background thread.
 
     Args:
@@ -41,6 +107,7 @@ def send_event(settings: AntonSettings, action: str, **extra: str) -> None:
 
         params: dict[str, str] = {
             "action": action,
+            "aid": get_installation_id(),
             "timestamp": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
             "_": str(int(time.time() * 1000)),
         }