idun-agent-engine 0.3.9__py3-none-any.whl → 0.4.1__py3-none-any.whl

idun_agent_engine/telemetry/telemetry.py

@@ -0,0 +1,248 @@
+"""Non-blocking telemetry for Idun Agent Engine.
+
+Telemetry is ON by default and can be disabled with `IDUN_TELEMETRY_ENABLED=false`.
+
+We persist a stable `distinct_id` in the OS cache directory at:
+`<cache_dir>/idun/telemetry_user_id`
+"""
+
+from __future__ import annotations
+
+import os
+import platform
+import re
+import sys
+import threading
+import uuid
+from concurrent.futures import Future, ThreadPoolExecutor
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+from platformdirs import user_cache_dir
+
+from .config import telemetry_enabled
+
+_POSTHOG_HOST = "https://us.i.posthog.com"
+_POSTHOG_PROJECT_API_KEY = "phc_mpAplkH6w5zK1aSkkG0IL5Ys55m6X34BFvGozB2NqPw"
+_DISTINCT_ID_ENV = "IDUN_TELEMETRY_DISTINCT_ID"
+_CACHE_APP_NAME = "idun"
+_CACHE_DISTINCT_ID_FILE = "telemetry_user_id"
+_MAX_VALUE_LENGTH = 200
+_SENSITIVE_KEY_FRAGMENTS = (
+    "api_key",
+    "apikey",
+    "access_key",
+    "accesskey",
+    "private_key",
+    "privatekey",
+    "secret",
+    "token",
+    "password",
+    "passphrase",
+    "client_secret",
+    "clientsecret",
+    "bearer",
+    "authorization",
+)
+
+
+def _is_sensitive_key(key: str) -> bool:
+    normalized = re.sub(r"[^a-z0-9]+", "_", key.lower())
+    return any(fragment in normalized for fragment in _SENSITIVE_KEY_FRAGMENTS)
+
+
+def _is_private_key_value(value: str) -> bool:
+    upper_value = value.upper()
+    return "PRIVATE KEY" in upper_value or "BEGIN OPENSSH PRIVATE KEY" in upper_value
+
+
+def _truncate_value(value: str) -> str:
+    if len(value) <= _MAX_VALUE_LENGTH:
+        return value
+    return value[:_MAX_VALUE_LENGTH]
+
+
+def sanitize_telemetry_config(value: Any) -> Any:
+    """Return a telemetry-safe copy of config objects."""
+    if hasattr(value, "model_dump") and callable(value.model_dump):
+        value = value.model_dump()  # type: ignore[assignment]
+    elif hasattr(value, "dict") and callable(value.dict):
+        value = value.dict()  # type: ignore[assignment]
+
+    if isinstance(value, dict):
+        sanitized: dict[str, Any] = {}
+        for key, item in value.items():
+            if isinstance(key, str) and _is_sensitive_key(key):
+                sanitized[key] = "[redacted]"
+            else:
+                sanitized[key] = sanitize_telemetry_config(item)
+        return sanitized
+
+    if isinstance(value, (list, tuple, set)):
+        return [sanitize_telemetry_config(item) for item in value]
+
+    if isinstance(value, str):
+        if _is_private_key_value(value):
+            return "[redacted]"
+        return _truncate_value(value)
+
+    return value
+
+
+def _safe_read_text(path: Path) -> str | None:
+    try:
+        return path.read_text(encoding="utf-8").strip()
+    except Exception:
+        return None
+
+
+def _safe_write_text(path: Path, text: str) -> None:
+    try:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(text, encoding="utf-8")
+    except Exception:
+        # Best-effort only.
+        return
+
+
+def _get_or_create_distinct_id() -> str | None:
+    """Return a stable distinct id.
+
+    Preference order:
+    - `IDUN_TELEMETRY_DISTINCT_ID` (if set)
+    - A UUID persisted to `<cache_dir>/idun/telemetry_user_id`
+    """
+
+    raw = os.environ.get(_DISTINCT_ID_ENV)
+    if raw and raw.strip():
+        return raw.strip()
+
+    cache_dir = Path(user_cache_dir(_CACHE_APP_NAME))
+    id_path = cache_dir / _CACHE_DISTINCT_ID_FILE
+
+    existing = _safe_read_text(id_path)
+    if existing:
+        return existing
+
+    new_id = str(uuid.uuid4())
+    _safe_write_text(id_path, new_id)
+    return new_id
+
+
+def _common_properties() -> dict[str, Any]:
+    from .._version import __version__
+
+    return {
+        "library": "idun-agent-engine",
+        "library_version": __version__,
+        "python_version": platform.python_version(),
+        "python_implementation": platform.python_implementation(),
+        "platform": sys.platform,
+        "os": platform.system(),
+        "os_version": platform.release(),
+    }
+
+
+@dataclass(slots=True)
+class IdunTelemetry:
+    """Non-blocking telemetry client."""
+
+    enabled: bool = field(default_factory=telemetry_enabled)
+    _executor: ThreadPoolExecutor | None = field(default=None, init=False, repr=False)
+    _client: Any | None = field(default=None, init=False, repr=False)
+    _client_lock: threading.Lock = field(
+        default_factory=threading.Lock, init=False, repr=False
+    )
+    _distinct_id: str | None = field(default=None, init=False, repr=False)
+
+    def _ensure_executor(self) -> ThreadPoolExecutor:
+        if self._executor is None:
+            self._executor = ThreadPoolExecutor(
+                max_workers=1, thread_name_prefix="idun-telemetry"
+            )
+        return self._executor
+
+    def _get_client(self) -> Any | None:
+        if not self.enabled:
+            return None
+        if self._client is not None:
+            return self._client
+
+        with self._client_lock:
+            if self._client is not None:
+                return self._client
+            try:
+                from posthog import Posthog
+            except Exception:
+                # Dependency missing or import failure should not break runtime.
+                return None
+
+            client = Posthog(_POSTHOG_PROJECT_API_KEY, host=_POSTHOG_HOST)
+            self._client = client
+            self._distinct_id = _get_or_create_distinct_id()
+            return self._client
+
+    def capture(self, event: str, properties: dict[str, Any] | None = None) -> Future[None] | None:
+        """Capture an event asynchronously (best-effort)."""
+
+        if not self.enabled:
+            return None
+
+        executor = self._ensure_executor()
+
+        def _send() -> None:
+            client = self._get_client()
+            if client is None:
+                return
+
+            merged: dict[str, Any] = _common_properties()
+            if properties:
+                merged.update(properties)
+
+            try:
+                if self._distinct_id:
+                    client.capture(
+                        event=event,
+                        distinct_id=self._distinct_id,
+                        properties=merged,
+                    )
+                else:
+                    client.capture(event=event, properties=merged)
+            except Exception:
+                # Never fail user code because of telemetry.
+                return
+
+        try:
+            return executor.submit(_send)
+        except Exception:
+            return None
+
+    def shutdown(self, timeout_seconds: float = 1.0) -> None:
+        """Best-effort flush/shutdown without blocking application shutdown."""
+
+        executor = self._executor
+        client = self._client
+
+        if executor is None:
+            return
+
+        def _shutdown_client() -> None:
+            try:
+                if client is not None:
+                    shutdown_fn = getattr(client, "shutdown", None)
+                    if callable(shutdown_fn):
+                        shutdown_fn()
+            except Exception:
+                return
+
+        try:
+            fut = executor.submit(_shutdown_client)
+            fut.result(timeout=timeout_seconds)
+        except Exception:
+            pass
+        finally:
+            try:
+                executor.shutdown(wait=False, cancel_futures=False)
+            except Exception:
+                pass

{idun_agent_engine-0.3.9.dist-info → idun_agent_engine-0.4.1.dist-info}/METADATA

@@ -1,17 +1,17 @@
 Metadata-Version: 2.4
 Name: idun-agent-engine
-Version: 0.3.9
+Version: 0.4.1
 Summary: Python SDK and runtime to serve AI agents with FastAPI, LangGraph, and observability.
 Project-URL: Homepage, https://github.com/geoffreyharrazi/idun-agent-platform
 Project-URL: Repository, https://github.com/geoffreyharrazi/idun-agent-platform
 Project-URL: Documentation, https://github.com/geoffreyharrazi/idun-agent-platform/tree/main/libs/idun_agent_engine
 Project-URL: Issues, https://github.com/geoffreyharrazi/idun-agent-platform/issues
 Author-email: Geoffrey HARRAZI <geoffreyharrazi@gmail.com>
-License-Expression: MIT
+License-Expression: GPL-3.0-only
 Keywords: agents,fastapi,langgraph,llm,observability,sdk
 Classifier: Framework :: FastAPI
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
@@ -31,12 +31,12 @@ Requires-Dist: deepagents<1.0.0,>=0.2.8
 Requires-Dist: fastapi<0.116.0,>=0.115.0
 Requires-Dist: google-adk<2.0.0,>=1.19.0
 Requires-Dist: google-cloud-logging<4.0.0,>=3.10.0
-Requires-Dist: guardrails-ai<0.8.0,>=0.7.0
+Requires-Dist: guardrails-ai<0.8.0,>=0.7.2
 Requires-Dist: httpx<0.29.0,>=0.28.1
 Requires-Dist: idun-agent-schema<1.0.0,>=0.3.8
 Requires-Dist: langchain-core<2.0.0,>=1.0.0
 Requires-Dist: langchain-google-vertexai<4.0.0,>=2.0.27
-Requires-Dist: langchain-mcp-adapters<0.2.0,>=0.1.0
+Requires-Dist: langchain-mcp-adapters<0.3.0,>=0.2.0
 Requires-Dist: langchain<2.0.0,>=1.0.0
 Requires-Dist: langfuse-haystack>=2.3.0
 Requires-Dist: langfuse<4.0.0,>=2.60.8
@@ -51,12 +51,16 @@ Requires-Dist: openinference-instrumentation-mcp<2.0.0,>=1.0.0
 Requires-Dist: openinference-instrumentation-vertexai<1.0.0,>=0.1.0
 Requires-Dist: opentelemetry-exporter-gcp-trace<2.0.0,>=1.6.0
 Requires-Dist: opentelemetry-exporter-otlp-proto-http<2.0.0,>=1.22.0
+Requires-Dist: platformdirs<5.0.0,>=4.0.0
+Requires-Dist: posthog<8.0.0,>=7.0.0
 Requires-Dist: psycopg-binary<4.0.0,>=3.3.0
 Requires-Dist: pydantic<3.0.0,>=2.11.7
 Requires-Dist: python-dotenv>=1.1.1
+Requires-Dist: pyyaml<7.0.0,>=6.0.0
 Requires-Dist: sqlalchemy<3.0.0,>=2.0.36
 Requires-Dist: streamlit<2.0.0,>=1.47.1
 Requires-Dist: tavily-python<0.8.0,>=0.7.9
+Requires-Dist: textual<7.4.0,>=7.3.0
 Requires-Dist: uvicorn<0.36.0,>=0.35.0
 Description-Content-Type: text/markdown
 
@@ -72,7 +76,7 @@ Idun Agent Engine is a lightweight runtime and SDK that wraps your agent with a
 pip install idun-agent-engine
 ```
 
-- Requires Python 3.13
+- Requires Python 3.12+
 - Ships with FastAPI, Uvicorn, LangGraph, SQLite checkpointing, and optional observability hooks
 
 ## Quickstart
@@ -319,9 +323,9 @@ from idun_agent_engine import (
 
 Issues and PRs are welcome. See the repository:
 
-- Repo: `https://github.com/geoffreyharrazi/idun-agent-platform`
+- Repo: `https://github.com/Idun-Group/idun-agent-platform`
 - Package path: `libs/idun_agent_engine`
-- Open an issue: `https://github.com/geoffreyharrazi/idun-agent-platform/issues`
+- Open an issue: `https://github.com/Idun-Group/idun-agent-platform/issues`
 
 Run locally:
 

{idun_agent_engine-0.3.9.dist-info → idun_agent_engine-0.4.1.dist-info}/RECORD

@@ -1,29 +1,29 @@
 idun_agent_engine/__init__.py,sha256=PhOL6foq5V0eXaoXw7xKUeCWXIWrOHrAFB8OuJnBqyM,550
-idun_agent_engine/_version.py,sha256=wg5TtrJHehk9ojgri-pSlGNV_tkiMqJWfjSzOxSjvMM,72
+idun_agent_engine/_version.py,sha256=46Sg_0NATQ79huYXlK2uZI6BAN4q9gzxYyxZAuU0Bh0,72
 idun_agent_engine/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 idun_agent_engine/agent/__init__.py,sha256=foyOoRdI_04q1b6f2A5EXEpWSCKjZxpgWMWrKcsHNl8,220
 idun_agent_engine/agent/base.py,sha256=c-3gljSHQpm6aY0JNDmXkaPtcW55rXdsI8Cgv9l4bCs,3294
 idun_agent_engine/agent/adk/__init__.py,sha256=jLV2Z9qQGZtBpF_0pQI1FRCPJ_J1G3Z6cEAzHnQyuu4,83
-idun_agent_engine/agent/adk/adk.py,sha256=29YC5rgLjdod-CU3a2JqgAvzYcD5u2EY7pylozGNi9c,11375
+idun_agent_engine/agent/adk/adk.py,sha256=0lfubR5ylfmfuSTOryULxnlJS3gAxpP3xtRaDypGqvE,11415
 idun_agent_engine/agent/haystack/__init__.py,sha256=y5ADrD8gWBeYIvV7tmu6OpPdJ8POHt-tyraIL7RkkWI,179
 idun_agent_engine/agent/haystack/haystack.py,sha256=k4NAx_zTBO9uiExM9NtuDAN94H1lrCWtHf1GEWEN16g,10966
 idun_agent_engine/agent/haystack/haystack_model.py,sha256=EtOYnsWRufcrQufTRMeB3V-rZVQqfnmwKwPsYGfZdCs,362
 idun_agent_engine/agent/haystack/utils.py,sha256=sKRoPhzZWFw1NPsYwCockafzMBCCq3lGOrndbNE_C3M,609
 idun_agent_engine/agent/langgraph/__init__.py,sha256=CoBdkp9P4livdy5B0bvj9o7ftoqKmXEr9cZv4TZLncs,107
-idun_agent_engine/agent/langgraph/langgraph.py,sha256=vM5ppt0s_2izzZVbVXXGXGCVUGSN-GZhvQ5-6YbOgVM,22904
+idun_agent_engine/agent/langgraph/langgraph.py,sha256=cbVrUs74a0p6omypMHWO3-1uqGLtJdiyAMrCheQHF5w,22966
 idun_agent_engine/core/__init__.py,sha256=F0DMDlWcSWS_1dvh3xMbrdcVvZRHVnoAFFgREuSJfBI,408
-idun_agent_engine/core/app_factory.py,sha256=XiLrctFT_n8LP3flKFwJoJDbiWPiw98N9lbkpR8P1O0,2597
-idun_agent_engine/core/config_builder.py,sha256=HpKrWwpohuArICyuOd-0eUQMG0PP2ZfhZzRGjLP9yck,25841
+idun_agent_engine/core/app_factory.py,sha256=2w4o7wV8FQCZdBTk3W7cS0vnmpUM_TdAmphFKHbL31w,2597
+idun_agent_engine/core/config_builder.py,sha256=MosVcPjn7qXUAlmaYvnPquJ0jZ55pDOLfLv0i-D-A28,26049
 idun_agent_engine/core/engine_config.py,sha256=IR8WhbenDstNSL7ORrUW8AnzgS3exFQxtwip66pFhcM,545
 idun_agent_engine/core/server_runner.py,sha256=DwN5kHiKVvUJLw5iSkaxs2rKRaMgOwSUZmeUPSuDbf8,4899
 idun_agent_engine/guardrails/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 idun_agent_engine/guardrails/base.py,sha256=rvi7gcuKK8-3GtGicWzMWYsKKv0g3LjGBI-FycxgKVU,814
-idun_agent_engine/guardrails/guardrails_hub/__init__.py,sha256=gz2E0wPBEKi69RRRgo3zDBYwaEyGxH6GDDNcG1l6Y3E,131
+idun_agent_engine/guardrails/guardrails_hub/__init__.py,sha256=MwWdgrM1dNzKwuS9ZEFw5Cin91JXh2PYlMma8yZFO7o,123
 idun_agent_engine/guardrails/guardrails_hub/guardrails_hub.py,sha256=DgcUIDy9_bcVcpYVvDJowFe_QVlCpEkr8hntPRgRmS0,3456
 idun_agent_engine/guardrails/guardrails_hub/utils.py,sha256=bC6-MsCVF7xKTr48z7OzJJUeWvqAB7BiHeNTiKsme70,20
-idun_agent_engine/mcp/__init__.py,sha256=tsX4sJa7UZD-lr8O1acMwDrdDWJc_hMlB9IrX1NH8Wk,255
-idun_agent_engine/mcp/helpers.py,sha256=aFiLlk63pifBjGgctREFWxuSbb-um6QDOVpyikQ5NJ0,3224
-idun_agent_engine/mcp/registry.py,sha256=K9-OLF_7FoKmyrwi65i6E3goZROHLRgISlF1yPwkEm8,3996
+idun_agent_engine/mcp/__init__.py,sha256=ygChpEQ4MzMpEifW3szi5kNiLIMhOhJEtqxy0nmewDU,501
+idun_agent_engine/mcp/helpers.py,sha256=b345RHXgeZ15a4gfg8sUJ3Ke7Iwke6FR1RqDRfRUB0c,6589
+idun_agent_engine/mcp/registry.py,sha256=8zt9o8MZmYKx55xb0E7n-qOCR_3m2-XGf7ToQEwHkTU,4229
 idun_agent_engine/observability/__init__.py,sha256=DCtK6b3xiX4dh0_8GBDOcSXQdcIJz2wTqqPa_ZFAES4,430
 idun_agent_engine/observability/base.py,sha256=C6mY_ZafDEHkMz8_ZeaEh--pyYuzJYEUqhoJ0sVP2wY,5570
 idun_agent_engine/observability/gcp_logging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -38,24 +38,52 @@ idun_agent_engine/observability/phoenix_local/__init__.py,sha256=m9dIw1GWGKAW4wP
 idun_agent_engine/observability/phoenix_local/phoenix_local_handler.py,sha256=wjOZuMpAxdD5D33rzxycNEzFMunETpPnYjiHjbjz5GA,4252
 idun_agent_engine/server/__init__.py,sha256=WaFektUsy37bNg2niAUy_TykzStukgWPnxC-t49CEwo,177
 idun_agent_engine/server/dependencies.py,sha256=MVH8STOQ8wu-iYE_28y5dvw5FGT5PX0uQl0ldkpxw6Y,2080
-idun_agent_engine/server/lifespan.py,sha256=sp1EaCRKHblRFwYHWWNQzuD3deFiFpb06QlSutvoZRo,3832
+idun_agent_engine/server/lifespan.py,sha256=pTPZ36R4jlx1jq249kpj4DEe-opIGYiRNUHncKlnuGs,4670
 idun_agent_engine/server/server_config.py,sha256=RYA7Y0c5aRw_WXaX8svFUIEtTPqzn3o-WQRm2p52C6g,213
 idun_agent_engine/server/routers/__init__.py,sha256=BgNzSVvHtGPGn5zhXhomwpKlDYBkeFi7xCbdcWVOgc8,102
 idun_agent_engine/server/routers/agent.py,sha256=qLaVRKgMIu-YfOi-tPEzLNRZKZ4DaZEQ8KQ-4HrWbbY,9194
 idun_agent_engine/server/routers/agui.py,sha256=Z1G4fuo57MazQWfp7ao8QZ1or2H9BXLS_JB1nFPXAkE,1891
 idun_agent_engine/server/routers/base.py,sha256=wICOXCokCIRjmHuDPDTWqeXqOVPes1CtDtiR_HvtsF0,3756
+idun_agent_engine/telemetry/__init__.py,sha256=oYmmgUYvuwM-eV1qBeTgy6HoG6H3LC_S4fMH04QiMWY,519
+idun_agent_engine/telemetry/config.py,sha256=APSmZWocwSqB1xSxoZkJrSTZnWlBiQdif4whdXi8uBE,845
+idun_agent_engine/telemetry/telemetry.py,sha256=g14ouZnSIV85A58HeAH5IlJ_IDKO_uYo7kFbWRo5PpI,7319
 idun_agent_engine/templates/__init__.py,sha256=xxbJZXaX6VEm_UrqzAOQcuujpEji5yqYzwQfwiqig8o,31
 idun_agent_engine/templates/correction.py,sha256=qApH4W99K31maxNrGf0hPVe_Wd4xjYjJrEKlu7PbRpw,1823
 idun_agent_engine/templates/deep_research.py,sha256=j4WypBkBz7V3EG-U8vawfNXDNhcCf2QiEK0veI4M68s,1077
 idun_agent_engine/templates/translation.py,sha256=vjp1yEyhDMFO4nEbq5WG7LAA7nLrhVAjznOkV7ob_Ss,2149
 idun_platform_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-idun_platform_cli/main.py,sha256=jWL7Ob0p4KdRUqgPTP_EB68n7z2LyMKC2DeUsfWlBO4,200
+idun_platform_cli/main.py,sha256=B7b1x0kgfuiAWGmSCFJeu_zkWiodJjOGu0nWuNAWM-k,299
+idun_platform_cli/telemetry.py,sha256=mLTO8717ckmglm_oSl1xFxomk-eqwqrCU9Nl1uq27Dg,1711
 idun_platform_cli/groups/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+idun_platform_cli/groups/init.py,sha256=gBWU7tQ0v9aaPNSQXorKWrOkUc5YgJU06pzDC-qG97U,769
 idun_platform_cli/groups/agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 idun_platform_cli/groups/agent/main.py,sha256=QMGQi3JZ76SeFI3miIjVWpMt0L-hGz5FwxtTPQX4-Uw,301
-idun_platform_cli/groups/agent/package.py,sha256=LdIFAcfrlUcCssmSliYQIi0NFMuVkpx6t8WhMHATan8,2525
-idun_platform_cli/groups/agent/serve.py,sha256=2AbL0G1WqR33jlyiGaNvAoPZ3G1o52KYUptz_HaAjIg,3863
-idun_agent_engine-0.3.9.dist-info/METADATA,sha256=xUkcP9OMVWs9ftXHs0gmTnLdddG_t4eoNGc9Sbs15jI,10692
-idun_agent_engine-0.3.9.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-idun_agent_engine-0.3.9.dist-info/entry_points.txt,sha256=XG3oxlSOaCrYKT1oyhKa0Ag1iJPMZ-WF6gaV_mzIJW4,52
-idun_agent_engine-0.3.9.dist-info/RECORD,,
+idun_platform_cli/groups/agent/package.py,sha256=JeoQBZ_egkeKhQhB-FuGGrY1T1VG4f4ixuhjt0mDygE,2615
+idun_platform_cli/groups/agent/serve.py,sha256=ujCmJ3JsrjHkXvNwyB7V4poAaTxMQAPcIbRPDVybRQo,3947
+idun_platform_cli/tui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+idun_platform_cli/tui/main.py,sha256=1gFEdbynBfiBLrZrKvNJN16Uc_3DOJl1spexRz38Q-E,3080
+idun_platform_cli/tui/css/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+idun_platform_cli/tui/css/create_agent.py,sha256=ZyFNv6-EUTUaJ_817wh0KUvdu8rtuuPj9jTbigLfOR8,14050
+idun_platform_cli/tui/css/main.py,sha256=gJ_kNb2lC2l99lq8NqtYU2imXAjUpxfiOaf1mNJr-Po,1134
+idun_platform_cli/tui/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+idun_platform_cli/tui/schemas/create_agent.py,sha256=2jsZ5v1sZLKmypgimdVoeVjd-wOylTE3IUYPw63eb8Y,1512
+idun_platform_cli/tui/screens/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+idun_platform_cli/tui/screens/create_agent.py,sha256=3Yav2gvJhh0el4BTLuYzYELrHWuKDBnNnNHlRIBUEJE,23881
+idun_platform_cli/tui/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+idun_platform_cli/tui/utils/config.py,sha256=AEgjgnNkCtQwuGxI8lclteunKZXvn_TMx0eBx7uJWto,7286
+idun_platform_cli/tui/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+idun_platform_cli/tui/validators/guardrails.py,sha256=l6TJKxjpr8Nktwndh6C7Juz4oY-bqpg295jtYTKHuQ8,3537
+idun_platform_cli/tui/validators/mcps.py,sha256=oDxbxt7qOzsW8yjd_fwBnlDPOSxPqCXqbF5q8eEYRVQ,2852
+idun_platform_cli/tui/validators/observability.py,sha256=IWNuJg42eZUxjV-7v12kms7DpJsAs3FSSD5zLU5eKUc,2436
+idun_platform_cli/tui/widgets/__init__.py,sha256=w8rQsUxqTtxuhpOPxCgl1pmv2vjCJseKNc1lhfMMkBM,521
+idun_platform_cli/tui/widgets/chat_widget.py,sha256=8RCAY97asVxyy7VV7IJ4kEAX9edK46UGO90BJ0X4BL0,5731
+idun_platform_cli/tui/widgets/guardrails_widget.py,sha256=3EDrfTKXyN7N8qMuWVy-BjK6ia3CZIE0EVm1sh6FhMw,14552
+idun_platform_cli/tui/widgets/identity_widget.py,sha256=LjpX-mgIinxJ5FzKBFz1HYbImwX7khpbetl86LsPnfw,9508
+idun_platform_cli/tui/widgets/mcps_widget.py,sha256=5AToZHU5PAUJEuq0HhL4Mi_VmWlFLyTeY5pohWY3rKw,10974
+idun_platform_cli/tui/widgets/memory_widget.py,sha256=QHCH0et_lJa9pheTpcZdbzTDUzw95Do2koi6hEdmrOc,6996
+idun_platform_cli/tui/widgets/observability_widget.py,sha256=9AO7-nqMEIx_9FCmqbtprxoBejq4w8bR9wOhxl2BbmA,14915
+idun_platform_cli/tui/widgets/serve_widget.py,sha256=0FinYhkyA0LJnX1g4JDrkcD5df-l-qgMxjRjgF0CleQ,2749
+idun_agent_engine-0.4.1.dist-info/METADATA,sha256=xGS6C3n58AGB9WezKja-6Oy2EigEcuO3v8M6JKnZFu0,10870
+idun_agent_engine-0.4.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+idun_agent_engine-0.4.1.dist-info/entry_points.txt,sha256=XG3oxlSOaCrYKT1oyhKa0Ag1iJPMZ-WF6gaV_mzIJW4,52
+idun_agent_engine-0.4.1.dist-info/RECORD,,

idun_platform_cli/groups/agent/package.py

@@ -4,6 +4,8 @@ from pathlib import Path
 
 import click
 
+from idun_platform_cli.telemetry import track_command
+
 
 class Dependency(StrEnum):
     """Dependency Enum."""
@@ -57,6 +59,7 @@ CMD ["idun", "agent", "serve", "--source=manager"]
 @click.command("package")
 @click.argument("path", default=".")
 @click.option("--target", required=False, default=".")
+@track_command("agent package")
 def package_command(path: str, target: str):
     """Packages the agent and it's dependencies into a Dockerfile. You can specifiy the input path and the destination. Defaults to current directory."""
     dependency = get_dependencies(path)

idun_platform_cli/groups/agent/serve.py

@@ -8,6 +8,7 @@ from idun_agent_engine.core.app_factory import create_app
 from idun_agent_engine.core.config_builder import ConfigBuilder
 from idun_agent_engine.core.engine_config import EngineConfig
 from idun_agent_engine.core.server_runner import run_server
+from idun_platform_cli.telemetry import track_command
 
 
 class ServerSource(StrEnum):
@@ -84,6 +85,7 @@ class Serve:
 @click.command("serve")
 @click.option("--source", required=True)
 @click.option("--path")
+@track_command("agent serve")
 def serve_command(source: str, path: str | None):
     """Reads a config and exposes it's agent as an API. Config is either fetched from the manager, or from a path.
 

idun_platform_cli/groups/init.py

@@ -0,0 +1,25 @@
+import sys
+
+import click
+
+from idun_platform_cli.telemetry import track_command
+from idun_platform_cli.tui.main import IdunApp
+
+
+@click.command("init")
+@track_command("init")
+def init_command() -> None:
+    """Starts a terminal user interface that guides you through configuring and managing Idun agents."""
+    try:
+        app = IdunApp()
+        app.run()
+    except ImportError as e:
+        print(f"[ERROR]: Missing required dependency for TUI: {e}")
+        print("[INFO]: Make sure 'textual' is installed in your environment")
+        sys.exit(1)
+    except KeyboardInterrupt:
+        print("\n[INFO]: Initialization cancelled by user")
+        sys.exit(0)
+    except Exception as e:
+        print(f"[ERROR]: Failed to launch the Idun TUI: {e}")
+    sys.exit(1)

idun_platform_cli/main.py

@@ -1,5 +1,7 @@
 import click
+
 from idun_platform_cli.groups.agent.main import agent
+from idun_platform_cli.groups.init import init_command
 
 
 @click.group()
@@ -9,6 +11,7 @@ def cli():
 
 
 cli.add_command(agent)
+cli.add_command(init_command, name="init")
 
 if __name__ == "__main__":
     cli()

idun_platform_cli/telemetry.py

@@ -0,0 +1,54 @@
+"""Telemetry utilities for CLI command tracking."""
+
+from __future__ import annotations
+
+import functools
+import time
+from typing import Any, Callable, TypeVar
+
+from idun_agent_engine.telemetry import get_telemetry, sanitize_telemetry_config
+
+F = TypeVar("F", bound=Callable[..., Any])
+
+
+def track_command(command_name: str) -> Callable[[F], F]:
+    """Decorator to track CLI command invocations via telemetry.
+
+    Args:
+        command_name: The name of the command to track (e.g., "init", "agent serve").
+
+    Returns:
+        A decorator that wraps the command function with telemetry tracking.
+    """
+
+    def decorator(func: F) -> F:
+        @functools.wraps(func)
+        def wrapper(*args: Any, **kwargs: Any) -> Any:
+            telemetry = get_telemetry()
+            start_time = time.time()
+            success = True
+            error_message: str | None = None
+
+            try:
+                return func(*args, **kwargs)
+            except Exception as e:
+                success = False
+                error_message = str(e)
+                raise
+            finally:
+                duration_ms = (time.time() - start_time) * 1000
+                telemetry.capture(
+                    "cli command invoked",
+                    properties={
+                        "command": command_name,
+                        "arguments": sanitize_telemetry_config(kwargs),
+                        "success": success,
+                        "error": error_message,
+                        "duration_ms": round(duration_ms, 2),
+                    },
+                )
+                telemetry.shutdown(timeout_seconds=0.5)
+
+        return wrapper  # type: ignore[return-value]
+
+    return decorator