> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usesynth.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# factory_usage
# `synth_ai.research.factory_usage`
Typed Factory usage and event bindings for `client.research.factories`.
Backend routes (backend PR #747):
* `GET /smr/factories/{factory_id}/usage` → `SmrFactoryUsageResponse`
* `GET /smr/factories/{factory_id}/events` → `SmrFactoryEventsResponse`
Both are read via the session client's internal `_request_json` layer, the
same transport every other `/smr` binding uses.
## Functions
### `fetch_factory_usage`
```python theme={null}
fetch_factory_usage(session: ManagedResearchClient, factory_id: str) -> FactoryUsage
```
Read the factory usage aggregate.
Backend route: `GET /smr/factories/{factory_id}/usage` (query `window`).
### `fetch_factory_events`
```python theme={null}
fetch_factory_events(session: ManagedResearchClient, factory_id: str) -> FactoryEventsPage
```
Read one page of the durable factory event projection.
Backend route: `GET /smr/factories/{factory_id}/events`
(query `limit`, `cursor`).
## Classes
### `FactoryUsageCost`
Typed `SmrFactoryUsageCostTotals` (nominal ledger cost for the window).
**Methods:**
#### `from_wire`
```python theme={null}
from_wire(cls, payload: object) -> FactoryUsageCost
```
### `FactoryUsageBudget`
Typed `SmrFactoryUsageBudgetResponse` (budget policy status; all optional).
**Methods:**
#### `from_wire`
```python theme={null}
from_wire(cls, payload: object) -> FactoryUsageBudget
```
### `FactoryEffortUsage`
Typed `SmrFactoryEffortUsageResponse` (per-effort drawdown in the window).
**Methods:**
#### `from_wire`
```python theme={null}
from_wire(cls, payload: object) -> FactoryEffortUsage
```
### `FactoryUsage`
Typed `SmrFactoryUsageResponse`.
Backend route: `GET /smr/factories/{factory_id}/usage`
(query `window`: `month_to_date` | `last_7_days`).
**Methods:**
#### `from_wire`
```python theme={null}
from_wire(cls, payload: object) -> FactoryUsage
```
### `FactoryEvent`
Typed `SmrFactoryEventResponse` (one durable factory event row).
**Methods:**
#### `from_wire`
```python theme={null}
from_wire(cls, payload: object) -> FactoryEvent
```
### `FactoryEventsPage`
Typed `SmrFactoryEventsResponse` (newest-first cursor page).
Backend route: `GET /smr/factories/{factory_id}/events`
(query `limit` 1-500, `cursor`; `next_cursor` is null when drained).
**Methods:**
#### `from_wire`
```python theme={null}
from_wire(cls, payload: object) -> FactoryEventsPage
```