{% from '_analytics_charts.html' import bars, trend, donut, usage_table %}
{% from '_fmt.html' import tape, count %}
<section class="usage-dashboard" aria-label="Usage and memory analytics">
    {#- The usage page draws this strip above its filters; embedded views draw it here. -#}
    {% if not usage_tape_shown %}{{ tape(usage_tape, 'Usage summary', 'usage-kpis') }}{% endif %}
    <p class="usage-notice">Recorded window only · {{ count(usage.coverage.events_scanned) }} events · {{ usage.timezone }}. {% if not usage.coverage.read_complete %}Read completeness is partial or not established. Narrow the filters for a more complete window.{% endif %} Unpriced calls are excluded from charges, not treated as free.</p>
    {% if not trace_analysis %}{% include '_prompt_cache.html' %}{% endif %}
    <div class="usage-grid">
        {{ trend(usage_charts.daily_tokens, 'Daily token consumption', 'tokens') }}
        {{ trend(usage_charts.daily_cost, 'Daily known charge', 'USD') }}
        {{ bars(usage_charts.agent_cost, 'Agent charges', 'USD · known portion') }}
        {{ donut(usage_charts.memory_tokens, 'Memory prompt share') }}
        {{ bars(usage_charts.memory_latency, 'Memory retrieval latency', 'mean ms per operation') }}
    </div>
    <div class="usage-flow" aria-label="Measurement stages"><span>Memory reads<br><small>Measured retrieval latency</small></span><span aria-hidden="true">→</span><span>Rendered prompt<br><small>Approximate memory tokens</small></span><span aria-hidden="true">→</span><span>Model result<br><small>Provider tokens × rate card</small></span></div>
    <div class="usage-tables">
        {{ usage_table(usage.agents, 'Usage by agent') }}
        {{ usage_table(usage.models, 'Usage by provider and model') }}
    </div>
    <div class="usage-interactions">{{ usage_table(usage.interactions, 'Usage by interaction') }}</div>
    <details class="usage-table" open><summary>Memory measurements</summary><div class="usage-table-scroll"><table><thead><tr><th>Memory type</th><th class="num">Rendered characters</th><th class="num">Approx. tokens</th><th class="num">Supply samples</th><th class="num">Retrievals / errors</th><th class="num">Total retrieval ms</th><th class="num">Mean / p95 retrieval ms</th></tr></thead><tbody>
    {% for row in usage.memory %}<tr><th>{{ row.label }}</th><td class="num">{{ count(row.memory_chars) if row.supply_samples else 'Unknown' }}</td><td class="num">{{ count(row.memory_tokens_estimate) if row.supply_samples else 'Unknown' }}</td><td class="num">{{ count(row.supply_samples) }}</td><td class="num">{{ count(row.retrieval_samples) }} / <span class="{{ 'is-bad' if row.retrieval_errors else '' }}">{{ count(row.retrieval_errors) }}</span></td><td class="num">{{ '{:,.1f}'.format(row.retrieval_total_ms) if row.retrieval_samples else 'Unknown' }}</td><td class="num">{{ '{:,.1f} / {:,.1f}'.format(row.retrieval_mean_ms, row.retrieval_p95_ms) if row.retrieval_samples else 'Unknown' }}</td></tr>{% else %}<tr><td colspan="7">No per-type instrumentation was recorded. Historical attribution cannot be reconstructed.</td></tr>{% endfor %}
    </tbody></table></div></details>
    <details class="usage-methods"><summary>Accuracy, coverage and pricing sources</summary><ul>{% for note in usage.notes %}<li>{{ note }}</li>{% endfor %}</ul>
        <p>Standard direct-API rates only unless a custom registry is configured. Current-catalog calculations apply today's configured rates to older events; they are not historical invoices. Region, batch, priority, discounts and non-token fees require matching cards or billing reconciliation.</p>
        <ul>{% for price in usage.pricing %}<li>{{ price.pricing_version }} · {{ price.pricing_as_of }} · {{ price.basis }} · {{ price.pricing_source }}</li>{% endfor %}</ul>
        <ul>{% for reason, count_value in usage.unpriced_reasons.items() %}<li>{{ count_value }} calls: {{ reason }}</li>{% endfor %}</ul>
    </details>
</section>