Metadata-Version: 2.4
Name: il-audit
Version: 1.0.24
Summary: Cross-app audit and analytics logging for Locaria Intelligence Layer
Author: Locaria Intelligence Layer Team
License: Proprietary
Keywords: audit,logging,bigquery,analytics,locaria
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: google-api-core>=2.19.0
Requires-Dist: google-cloud-bigquery>=3.27.0
Requires-Dist: pydantic>=2.0
Requires-Dist: fastapi>=0.115.0
Provides-Extra: chat
Requires-Dist: langchain-core>=0.2; extra == "chat"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: httpx>=0.27; extra == "dev"

# il-audit — Intelligence Layer audit & analytics

Cross-app BigQuery audit logging for **intelligence-layer-ingest**, **intelligence-layer-chat**, and related services.

**Full documentation:** [documentation/README.md](documentation/README.md)

## Install

```bash
pip install -e ../intelligence-layer-audit   # local
```

```toml
"il-audit>=1.0.0",                           # PyPI
```

See [PUBLISHING.md](PUBLISHING.md) for releases.

## Quick start

```python
from il_audit import emit, AuditContext, taxonomy as T

emit(T.AUTH_LOGIN_SUCCEEDED,
     context=AuditContext(app="ingest", actor_uid=uid, actor_email=email),
     status="succeeded", action="login")
```

Walkthrough: [documentation/guides/getting-started.md](documentation/guides/getting-started.md). Target: [auth_events](https://console.cloud.google.com/bigquery?page=table&p=locaria-dev-int-layer&d=intelligence_layer_logs&t=auth_events).

## Guides

| Guide | Topic |
|-------|--------|
| [getting-started](documentation/guides/getting-started.md) | First emit, verify in BQ |
| [integration](documentation/guides/integration.md) | Backend: middleware, jobs, domain emits |
| [frontend-audit](documentation/guides/frontend-audit.md) | Browser: `audit_beacon.js`, `data-il-audit-*` |
| [cost-rates](documentation/guides/cost-rates.md) | [cost_rates](https://console.cloud.google.com/bigquery?page=table&p=locaria-dev-int-layer&d=intelligence_layer_logs&t=cost_rates) catalog |
| [chat-phase2](documentation/chat-phase2.md) | Chat instrumentation |

## Reference

| Doc | Topic |
|-----|--------|
| [bigquery-tables](documentation/reference/bigquery-tables.md) | All tables, samples, console links |
| [event-taxonomy](documentation/reference/event-taxonomy.md) | Event types → tables |
| [configuration](documentation/reference/configuration.md) | `IL_*` env vars |
| [architecture](documentation/reference/architecture.md) | Data flow |
| [cost-attribution](documentation/reference/cost-attribution.md) | Tokens, USD, correlation |

Dataset: [intelligence_layer_logs](https://console.cloud.google.com/bigquery?project=locaria-dev-int-layer&d=intelligence_layer_logs). Analytics views: [analytics-views.md](documentation/reference/analytics-views.md) · `sql/analytics_views.sql`.

Ingest reference consumer: [ingest audit-logging](https://github.com/Locaria/intelligence-layer-ingest/blob/main/documentation/guides/audit-logging.md).
