# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-03-04

HANDLER-NAME
============
tokens - Token-Verbrauch und Kosten-Tracking


BESCHREIBUNG
============
Der tokens-Handler erfasst und analysiert den Verbrauch von LLM-Tokens
(Input/Output) sowie die anfallenden Kosten in EUR. Daten werden aus der
monitor_tokens-Tabelle in bach.db abgefragt. Unterstützt Zeitfenster von
heute, letzte 7 Tage und 30 Tage.


OPERATIONEN
===========
Abrufbar mit: bach --tokens <operation>

status   (default)  Zusammenfassung: Heute / Woche / Monat
today               Detailliert: letzte 20 Einträge des heutigen Tages
week                Nach Tag gruppiert: letzte 7 Tage mit Kostensummen
report              Bericht nach Model + aktuelle Preise (30 Tage)


BEISPIELE
=========
Aktuellen Status checken:
  bach --tokens status
  bach --tokens

Heute Kosten einsehen:
  bach --tokens today

Wochenverbrauch analysieren:
  bach --tokens week

Detaillierten Bericht:
  bach --tokens report


DATEIEN
=======
Quellcode:        hub/tokens.py
Basis-Handler:    hub/base.py
Datenbank:        data/bach.db (monitor_tokens-Tabelle)
Preise-Tabelle:   data/bach.db (monitor_pricing-Tabelle)


SIEHE AUCH
==========
bach_api       Programmatischer Zugriff auf Handler
monitor-db     Datenbankbefehle und Schema
base.py        Handler-Interface und Fehlerbehandlung
