---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/llm/transformers_js/helpers/interfaces/BatteryLifecycleReport.md
description: A single normalized lifecycle report.
---

# Interface: BatteryLifecycleReport

Defined in: [src/batteries/llm/chat\_common/lifecycle.ts:44](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/llm/chat_common/lifecycle.ts#L44)

A single normalized lifecycle report.

## Properties

| Property                                     | Type                                                                    | Description                                                                                                                                                                                                                                                                                                                                                                              | Defined in                                                                                                                                          |
| -------------------------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
|  `at`                | `string`                                                                | ISO-8601 timestamp stamped when the report was emitted.                                                                                                                                                                                                                                                                                                                                  | [src/batteries/llm/chat\_common/lifecycle.ts:52](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/llm/chat_common/lifecycle.ts#L52) |
|  `battery`      | [`BatteryLifecycleBattery`](../type-aliases/BatteryLifecycleBattery.md) | The battery that produced this report.                                                                                                                                                                                                                                                                                                                                                   | [src/batteries/llm/chat\_common/lifecycle.ts:48](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/llm/chat_common/lifecycle.ts#L48) |
|  `detail?`       | `string`                                                                | Human-readable detail, e.g. `'booting WebGPU runtime'`.                                                                                                                                                                                                                                                                                                                                  | [src/batteries/llm/chat\_common/lifecycle.ts:54](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/llm/chat_common/lifecycle.ts#L54) |
|  `error?`         | `unknown`                                                               | The failure, populated only when `phase === 'error'`.                                                                                                                                                                                                                                                                                                                                    | [src/batteries/llm/chat\_common/lifecycle.ts:60](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/llm/chat_common/lifecycle.ts#L60) |
|  `gpuBudget?` | [`GpuBudget`](GpuBudget.md)                                             | The probed WebGPU device budget, populated on the `ready` phase for on-device batteries running on the WebGPU EP. SURFACED, not enforced — the consumer reads this to know the per-allocation ceiling (the wall an over-large context window hits) and choose its window accordingly. Absent on non-WebGPU runtimes (Node/wasm) and on every other phase. See [GpuBudget](GpuBudget.md). | [src/batteries/llm/chat\_common/lifecycle.ts:67](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/llm/chat_common/lifecycle.ts#L67) |
|  `model`          | `string`                                                                | Best-effort model identifier (the `model` option; `'<stream>'` / `'<blob>'` when not a string).                                                                                                                                                                                                                                                                                          | [src/batteries/llm/chat\_common/lifecycle.ts:50](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/llm/chat_common/lifecycle.ts#L50) |
|  `phase`          | [`BatteryLifecyclePhase`](../type-aliases/BatteryLifecyclePhase.md)     | The phase being entered.                                                                                                                                                                                                                                                                                                                                                                 | [src/batteries/llm/chat\_common/lifecycle.ts:46](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/llm/chat_common/lifecycle.ts#L46) |
|  `progress?`   | `number`                                                                | Normalized download/load progress in `0..1`, when the provider reports it (the `loading` phase).                                                                                                                                                                                                                                                                                         | [src/batteries/llm/chat\_common/lifecycle.ts:56](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/llm/chat_common/lifecycle.ts#L56) |
|  `raw?`             | `unknown`                                                               | The provider's own progress payload, passed through verbatim (the `loading` phase).                                                                                                                                                                                                                                                                                                      | [src/batteries/llm/chat\_common/lifecycle.ts:58](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/llm/chat_common/lifecycle.ts#L58) |
