Skip to main content

​
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

Read the factory usage aggregate. Backend route: GET /smr/factories/{factory_id}/usage (query window).

​
fetch_factory_events

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

​
FactoryUsageBudget

Typed SmrFactoryUsageBudgetResponse (budget policy status; all optional). Methods:

​
from_wire

​
FactoryEffortUsage

Typed SmrFactoryEffortUsageResponse (per-effort drawdown in the window). Methods:

​
from_wire

​
FactoryUsage

Typed SmrFactoryUsageResponse. Backend route: GET /smr/factories/{factory_id}/usage (query window: month_to_date | last_7_days). Methods:

​
from_wire

​
FactoryEvent

Typed SmrFactoryEventResponse (one durable factory event row). Methods:

​
from_wire

​
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