ADR 0054 — model usage is a vendor-neutral record at two grains #29

2026-09-06T21:39:05Z

jschoubben commented

2026-09-06 21:39:05 +00:00

Closes the usage-tracking half ADR 0050 explicitly left open (its home, cadence, and grain). One row shape (0050's (licence, consumer, period, metric, value)+raw), recorded at two consumer grains that differ only in consumer: the holding module (licence-level, e.g. Anthropic utilization%) and the agent session (per-session tokens/cost — since a session is a consumer, ADR 0026). Produced by the vendor adapter; read on a schedule (ADR 0053); recorded as events the audit-logger keeps (0041/0042) plus a queryable usage context store (0008); usage is not a credential and is recorded in the clear. Reuses the session, schedule, event, and store the mesh already has rather than inventing a vocabulary beside them. Accepted per the decision to build the full feature including per-session token/cost.

https://claude.ai/code/session_01LrgweAeERJYBg88c5cKDzF

Closes the usage-tracking half ADR 0050 explicitly left open (its home, cadence, and grain). One row shape (0050's `(licence, consumer, period, metric, value)+raw`), recorded at **two consumer grains** that differ only in `consumer`: the holding module (licence-level, e.g. Anthropic `utilization%`) and the **agent session** (per-session tokens/cost — since a session *is* a consumer, ADR 0026). Produced by the vendor adapter; read on a **schedule** (ADR 0053); recorded as **events** the audit-logger keeps (0041/0042) **plus** a queryable **usage context store** (0008); usage is **not a credential** and is recorded in the clear. Reuses the session, schedule, event, and store the mesh already has rather than inventing a vocabulary beside them. Accepted per the decision to build the full feature including per-session token/cost. https://claude.ai/code/session_01LrgweAeERJYBg88c5cKDzF

jschoubben added 1 commit 2026-09-06 21:39:05 +00:00

ADR 0054 — model usage is a vendor-neutral record at two grains (licence + session) ec2d73bc06

Closes the usage-tracking half ADR 0050 left open. One row shape (0050's), recorded at two
consumer grains: the holding module (licence-level, e.g. Anthropic utilization%) and the agent
session (per-session tokens/cost, since a session IS a consumer per ADR 0026). Produced by the
vendor adapter; read on a schedule (0053); recorded as events the audit-logger keeps (0041/0042)
plus a queryable usage context store (0008); usage is not a credential and is recorded in the
clear. Reuses the session, schedule, event, and store the mesh already has. Accepted per the
user's choice to build the full feature incl. per-session token/cost.

Claude-Session: https://claude.ai/code/session_01LrgweAeERJYBg88c5cKDzF

jschoubben merged commit b7a33a1e26 into main

2026-09-06 21:39:11 +00:00

jschoubben deleted branch feat/adr-0054-model-usage

2026-09-06 21:39:12 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: novox/hq#29