Skip to main content

​
synth_ai.research.factory_handles

Factory- and Effort-scoped handles for client.research.factories.

​
Classes

​
ResearchEffortHandle

Handle bound to one Effort id. Methods:

​
get

Fetch the Effort. Backend route: GET /smr/efforts/{effort_id}.

​
pause

Pause the Effort. Backend route: PATCH /smr/efforts/{effort_id}.

​
resume

Resume the Effort. Backend route: PATCH /smr/efforts/{effort_id}.

​
ResearchFactoryEffortsAPI

Efforts namespace scoped to one Factory. Methods:

​
list

List the Factory’s Efforts. Backend route: GET /smr/factories/{factory_id}/efforts.

​
open

Open a handle bound to one Effort id (no network call).

​
ResearchFactoryHandle

Handle bound to one Factory id. Lifecycle and wake methods delegate to the same session/facade bindings as client.research.factories; the handle only fixes the factory_id. Methods:

​
efforts

Efforts owned by this Factory.

​
status

Read the Factory workflow projection. Backend route: GET /smr/factories/{factory_id}/status.

​
pause

Pause the Factory. Backend route: PATCH /smr/factories/{factory_id}.

​
resume

Resume the Factory. Backend route: PATCH /smr/factories/{factory_id}.

​
archive

Archive the Factory. Backend route: PATCH /smr/factories/{factory_id}.

​
usage

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

​
events

Read one newest-first page of durable factory events. Backend route: GET /smr/factories/{factory_id}/events (query limit 1-500, cursor).

​
watch_status

Poll the status projection until idle or timeout. Backend route: repeated GET /smr/factories/{factory_id}/status.

​
preview_wake

Preview due experiments without launching. Backend route: POST /smr/factories/{factory_id}/wake-due (dry run).

​
wake_due

Launch exactly the due experiments bound to a reviewed preview. Backend route: POST /smr/factories/{factory_id}/wake-due (confirmed).