ai-telemetry-agent 0.1.1__tar.gz

ai_telemetry_agent-0.1.1/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: ai-telemetry-agent
+Version: 0.1.1
+Summary: Local developer telemetry agent for Antigravity AI usage and engineering signals
+Author: Engineering Telemetry Team
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Requires-Dist: python-dotenv>=1.0.0; extra == "dev"
+
+# AI Telemetry Agent
+
+A local developer telemetry agent for Antigravity AI usage, Git activity, and engineering signals.
+
+---
+
+## Architecture Overview
+
+```
+Developer Interaction
+       │
+       ▼
+Antigravity Lifecycle Hooks (%USERPROFILE%\.gemini\config\hooks.json)
+       │
+       ▼
+AI Telemetry Agent Collector (ai_telemetry_agent)
+       │
+       ▼
+Append-Only Daily JSONL Storage (~/.telemetry_agent/)
+```
+
+### Storage Structure
+
+```
+~/.telemetry_agent/
+├── identity.json
+├── device_id
+└── data/
+    ├── telemetry-2026-10-07.jsonl
+    ├── telemetry-2026-10-08.jsonl
+    └── telemetry-YYYY-MM-DD.jsonl
+```
+
+- **`identity.json`** (`WHO`): Local developer identity and hardware metadata (`member_id`, `member_name`, `device_id`, `hostname`).
+- **`data/telemetry-YYYY-MM-DD.jsonl`** (`WHAT`): Append-only daily JSONL telemetry files named by UTC date. Exactly one valid JSON object per line.
+
+---
+
+## Privacy & Security
+
+The AI Telemetry Agent enforces strict privacy boundaries:
+- **NO Prompts or Model Responses**: Never collects, records, or transmits conversational text or prompts.
+- **NO Source Code or File Contents**: Never collects repository file contents, code diffs, or patch bodies.
+- **NO Tool Arguments or Command History**: Never stores terminal history or tool call parameter values.
+- **NO Secrets or Credentials**: Environment variables, API keys, passwords, and tokens are scrubbed and excluded.
+- **Metadata Only**: Collects only execution metadata (event type, UTC timestamp, session ID, model name, tool name, repository name, branch).
+
+---
+
+## Installation & Setup
+
+### 1. Install Package
+```bash
+pip install ai-telemetry-agent
+```
+
+### 2. First-Time Developer Enrollment & Hook Setup
+Run the setup command:
+```bash
+telemetry-agent install
+```
+
+When run for the first time, you will be prompted for your name:
+```text
+========================================
+       AI Telemetry Agent Setup
+========================================
+
+Enter your name: Rahul Sharma
+
+Developer: Rahul Sharma
+Device: DELL-LAPTOP-123
+Device ID: dev-401e19f040bb
+
+Save this identity? [Y/n]: Y
+[OK] Developer identity saved
+[OK] Antigravity hooks installed
+[OK] Telemetry agent configured
+```
+
+Subsequent runs are idempotent and reuse the saved identity:
+```text
+========================================
+       AI Telemetry Agent Setup
+========================================
+[OK] Telemetry Agent already configured
+Developer: Rahul Sharma
+Device: DELL-LAPTOP-123
+Device ID: dev-401e19f040bb
+Member ID: mem-401e19f040
+```
+
+---
+
+## CLI Commands
+
+### Agent Status
+```bash
+telemetry-agent status
+```
+Displays collector daemon state, local developer identity, device ID, hook installation status, and total recorded events.
+
+### View Recent Events
+```bash
+# View last 10 events
+telemetry-agent events --last 10
+
+# Filter by event type
+telemetry-agent events --type ai_run_started
+
+# Filter by repository
+telemetry-agent events --repo chatbot-service
+
+# Output formatted JSON
+telemetry-agent events --last 5 --json
+```
+
+### View Session Summaries
+```bash
+# Aggregate multi-model sessions across all JSONL logs
+telemetry-agent sessions
+
+# Inspect specific session history
+telemetry-agent session <session-id>
+```
+
+### Repository & Engineering Summary
+```bash
+# Aggregated metrics per repository
+telemetry-agent summary
+```
+
+### Manage Antigravity Hooks
+```bash
+# Check hook installation status
+telemetry-agent hook-status
+
+# Install or repair global hooks
+telemetry-agent install-hook
+
+# Uninstall hooks cleanly
+telemetry-agent uninstall-hook
+```
+
+---
+
+## Running Tests
+
+Run the full automated test suite:
+```bash
+pytest tests -v
+```
+
+---
+
+## Building Distribution Packages
+
+```bash
+# Clean previous artifacts and build package
+python -m build
+
+# Validate distributions
+python -m twine check dist/*
+```
+
+---
+
+## Publishing Packages to PyPI / TestPyPI
+
+Secure publishing is configured via local `.env` and `scripts/publish_pypi.py`:
+
+1. **Configure local `.env`** (ignored by Git, never committed):
+   ```env
+   TWINE_USERNAME=__token__
+   TWINE_PASSWORD=
+   ```
+2. **Build and validate package artifacts**:
+   ```bash
+   python -m build
+   python -m twine check dist/*
+   ```
+3. **Run pre-flight check (Dry Run)**:
+   ```bash
+   python scripts/publish_pypi.py --dry-run
+   ```
+4. **Publish**:
+   ```bash
+   # Production PyPI:
+   python scripts/publish_pypi.py
+
+   # TestPyPI:
+   python scripts/publish_pypi.py --repository-url https://test.pypi.org/legacy/
+   ```
+

ai_telemetry_agent-0.1.1/README.md

@@ -0,0 +1,194 @@
+# AI Telemetry Agent
+
+A local developer telemetry agent for Antigravity AI usage, Git activity, and engineering signals.
+
+---
+
+## Architecture Overview
+
+```
+Developer Interaction
+       │
+       ▼
+Antigravity Lifecycle Hooks (%USERPROFILE%\.gemini\config\hooks.json)
+       │
+       ▼
+AI Telemetry Agent Collector (ai_telemetry_agent)
+       │
+       ▼
+Append-Only Daily JSONL Storage (~/.telemetry_agent/)
+```
+
+### Storage Structure
+
+```
+~/.telemetry_agent/
+├── identity.json
+├── device_id
+└── data/
+    ├── telemetry-2026-10-07.jsonl
+    ├── telemetry-2026-10-08.jsonl
+    └── telemetry-YYYY-MM-DD.jsonl
+```
+
+- **`identity.json`** (`WHO`): Local developer identity and hardware metadata (`member_id`, `member_name`, `device_id`, `hostname`).
+- **`data/telemetry-YYYY-MM-DD.jsonl`** (`WHAT`): Append-only daily JSONL telemetry files named by UTC date. Exactly one valid JSON object per line.
+
+---
+
+## Privacy & Security
+
+The AI Telemetry Agent enforces strict privacy boundaries:
+- **NO Prompts or Model Responses**: Never collects, records, or transmits conversational text or prompts.
+- **NO Source Code or File Contents**: Never collects repository file contents, code diffs, or patch bodies.
+- **NO Tool Arguments or Command History**: Never stores terminal history or tool call parameter values.
+- **NO Secrets or Credentials**: Environment variables, API keys, passwords, and tokens are scrubbed and excluded.
+- **Metadata Only**: Collects only execution metadata (event type, UTC timestamp, session ID, model name, tool name, repository name, branch).
+
+---
+
+## Installation & Setup
+
+### 1. Install Package
+```bash
+pip install ai-telemetry-agent
+```
+
+### 2. First-Time Developer Enrollment & Hook Setup
+Run the setup command:
+```bash
+telemetry-agent install
+```
+
+When run for the first time, you will be prompted for your name:
+```text
+========================================
+       AI Telemetry Agent Setup
+========================================
+
+Enter your name: Rahul Sharma
+
+Developer: Rahul Sharma
+Device: DELL-LAPTOP-123
+Device ID: dev-401e19f040bb
+
+Save this identity? [Y/n]: Y
+[OK] Developer identity saved
+[OK] Antigravity hooks installed
+[OK] Telemetry agent configured
+```
+
+Subsequent runs are idempotent and reuse the saved identity:
+```text
+========================================
+       AI Telemetry Agent Setup
+========================================
+[OK] Telemetry Agent already configured
+Developer: Rahul Sharma
+Device: DELL-LAPTOP-123
+Device ID: dev-401e19f040bb
+Member ID: mem-401e19f040
+```
+
+---
+
+## CLI Commands
+
+### Agent Status
+```bash
+telemetry-agent status
+```
+Displays collector daemon state, local developer identity, device ID, hook installation status, and total recorded events.
+
+### View Recent Events
+```bash
+# View last 10 events
+telemetry-agent events --last 10
+
+# Filter by event type
+telemetry-agent events --type ai_run_started
+
+# Filter by repository
+telemetry-agent events --repo chatbot-service
+
+# Output formatted JSON
+telemetry-agent events --last 5 --json
+```
+
+### View Session Summaries
+```bash
+# Aggregate multi-model sessions across all JSONL logs
+telemetry-agent sessions
+
+# Inspect specific session history
+telemetry-agent session <session-id>
+```
+
+### Repository & Engineering Summary
+```bash
+# Aggregated metrics per repository
+telemetry-agent summary
+```
+
+### Manage Antigravity Hooks
+```bash
+# Check hook installation status
+telemetry-agent hook-status
+
+# Install or repair global hooks
+telemetry-agent install-hook
+
+# Uninstall hooks cleanly
+telemetry-agent uninstall-hook
+```
+
+---
+
+## Running Tests
+
+Run the full automated test suite:
+```bash
+pytest tests -v
+```
+
+---
+
+## Building Distribution Packages
+
+```bash
+# Clean previous artifacts and build package
+python -m build
+
+# Validate distributions
+python -m twine check dist/*
+```
+
+---
+
+## Publishing Packages to PyPI / TestPyPI
+
+Secure publishing is configured via local `.env` and `scripts/publish_pypi.py`:
+
+1. **Configure local `.env`** (ignored by Git, never committed):
+   ```env
+   TWINE_USERNAME=__token__
+   TWINE_PASSWORD=
+   ```
+2. **Build and validate package artifacts**:
+   ```bash
+   python -m build
+   python -m twine check dist/*
+   ```
+3. **Run pre-flight check (Dry Run)**:
+   ```bash
+   python scripts/publish_pypi.py --dry-run
+   ```
+4. **Publish**:
+   ```bash
+   # Production PyPI:
+   python scripts/publish_pypi.py
+
+   # TestPyPI:
+   python scripts/publish_pypi.py --repository-url https://test.pypi.org/legacy/
+   ```
+

ai_telemetry_agent-0.1.1/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ai-telemetry-agent"
+version = "0.1.1"
+description = "Local developer telemetry agent for Antigravity AI usage and engineering signals"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    { name = "Engineering Telemetry Team" }
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.1.0",
+    "build>=1.0.0",
+    "twine>=5.0.0",
+    "python-dotenv>=1.0.0"
+]
+
+[project.scripts]
+telemetry-agent = "ai_telemetry_agent.cli:cli_entrypoint"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["ai_telemetry_agent*"]
+
+[tool.setuptools.package-data]
+ai_telemetry_agent = ["*.json", "integrations/hooks/*.json", "integrations/mcp_probe/*.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+pythonpath = ["src"]
+

ai_telemetry_agent-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ai_telemetry_agent-0.1.1/src/ai_telemetry_agent/__init__.py

@@ -0,0 +1,24 @@
+"""AI Telemetry Agent - Local developer telemetry agent for AI usage and engineering signals."""
+
+__version__ = "0.1.1"
+__package_name__ = "ai-telemetry-agent"
+
+from ai_telemetry_agent.config.settings import Settings, load_settings
+from ai_telemetry_agent.core.collector import TelemetryCollector
+from ai_telemetry_agent.core.event import TelemetryEvent, EventType
+from ai_telemetry_agent.core.identity import DeveloperIdentity, get_identity, is_enrolled
+from ai_telemetry_agent.storage.jsonl_store import JSONLEventStore
+
+__all__ = [
+    "__version__",
+    "__package_name__",
+    "Settings",
+    "load_settings",
+    "TelemetryCollector",
+    "TelemetryEvent",
+    "EventType",
+    "DeveloperIdentity",
+    "get_identity",
+    "is_enrolled",
+    "JSONLEventStore",
+]

ai_telemetry_agent-0.1.1/src/ai_telemetry_agent/__main__.py

@@ -0,0 +1,6 @@
+"""Main execution entry point for ai_telemetry_agent package."""
+
+from ai_telemetry_agent.cli import cli_entrypoint
+
+if __name__ == "__main__":
+    cli_entrypoint()