usage-summary.json

OUTPUT: usage/cost/cache summary generated by matrix-lite-persistent-chat-usage-summary.timer

/home/matrix-lite/state/persistent-chat/usage-summary.json

{
  "ok": true,
  "generated_at": "2026-07-12T14:14:05Z",
  "lookback_hours": 48.0,
  "window_start": "2026-07-10T14:14:04Z",
  "window_end": "2026-07-12T14:14:04Z",
  "config_path": "/home/matrix-lite/state/persistent-chat/usage-summary-config.json",
  "output_path": "/home/matrix-lite/state/persistent-chat/usage-summary.json",
  "reference_captured_at": "2026-05-14",
  "scope_label": "persistent-chat and related sessions",
  "excluded_models": [
    "opencode/big-pickle"
  ],
  "session_count": 0,
  "usage_session_count": 0,
  "usage_record_count": 0,
  "source_counts": {
    "subagent_files_scanned": 9,
    "persistent_subagent_files": 0,
    "persistent_subagent_sessions": 0,
    "acpx_session_files_scanned": 227,
    "relevant_session_records": 204,
    "log_files_scanned": 0,
    "llm_records_seen": 0,
    "usage_records_seen": 0,
    "stream_files_scanned": 183,
    "stream_usage_update_records_seen": 0,
    "stream_result_usage_records_seen": 0,
    "stream_unmatched_usage_updates": 0,
    "stream_sessions_with_usage": 0,
    "stream_sessions_skipped_cross_window": 183,
    "stream_active_sessions_skipped_cross_window": 0,
    "usage_sessions_from_stream": 0,
    "usage_sessions_from_logs": 0,
    "usage_sessions_stream_enriched_from_logs": 0,
    "selected_sessions": 0,
    "selected_usage_sessions": 0
  },
  "totals": {
    "all": {
      "input_tokens": 0,
      "output_tokens": 0,
      "reasoning_tokens": 0,
      "cache_read_tokens": 0,
      "cache_write_tokens": 0,
      "observed_cost": 0.0,
      "estimated_cost": 0.0,
      "reference_estimated_cost": 0.0,
      "usage_records": 0,
      "observed_records": 0,
      "reference_records": 0,
      "unpriced_records": 0,
      "first_event_at": null,
      "last_event_at": null,
      "session_count": 0,
      "model_count": 0
    },
    "included": {
      "input_tokens": 0,
      "output_tokens": 0,
      "reasoning_tokens": 0,
      "cache_read_tokens": 0,
      "cache_write_tokens": 0,
      "observed_cost": 0.0,
      "estimated_cost": 0.0,
      "reference_estimated_cost": 0.0,
      "usage_records": 0,
      "observed_records": 0,
      "reference_records": 0,
      "unpriced_records": 0,
      "first_event_at": null,
      "last_event_at": null,
      "session_count": 0,
      "model_count": 0
    },
    "excluded": {
      "input_tokens": 0,
      "output_tokens": 0,
      "reasoning_tokens": 0,
      "cache_read_tokens": 0,
      "cache_write_tokens": 0,
      "observed_cost": 0.0,
      "estimated_cost": 0.0,
      "reference_estimated_cost": 0.0,
      "usage_records": 0,
      "observed_records": 0,
      "reference_records": 0,
      "unpriced_records": 0,
      "first_event_at": null,
      "last_event_at": null,
      "session_count": 0,
      "model_count": 0
    }
  },
  "by_kind": [],
  "by_model": [],
  "recent_sessions": [],
  "unknown_models": [],
  "notes": [
    "Primary durable source is ACPX stream `result.usage` for sessions created inside the lookback window; OpenCode step-finish logs are only used when stream usage is missing or a session spans the boundary.",
    "observed_cost uses ACPX `usage_update.cost` when present; otherwise estimated_cost falls back to OpenRouter reference pricing or configured proxy mappings.",
    "Excluded models are removed only from totals.included; `by_model` marks them explicitly, while `by_kind` remains raw all-model activity."
  ]
}