`synth_ai.research.models`

Research API model aliases. Typed wire models live in the canonical synth_ai.managed_research.models package. Import these names from synth_ai.research.models in customer code.

Public name	Role
`ResearchAgentHarness` / `ResearchAgentModel`	Typed agent launch selectors
`ResearchRoleBinding` / `ResearchRoleBindings` / `ResearchWorkerRolePalette`	Typed role launch policy
`ResearchRunLaunchRequest`	Validated configured-run request
`ResearchAuthorityReadouts`	Canonical run/task authority projection
`ResearchProject`	Project record
`ResearchSwarm`	Swarm state model returned by `swarms.wait` / `swarms.state` (alias `ResearchRun`)
`ResearchRunbookPreset`	Named runbook preset for `swarms.create`
`ResearchOrgLimits`	Organization plan limits and usage windows
`ResearchBillingCatalog`	Canonical billing plans and allowances catalog
`ResearchBillingPlan`	Organization billing plan snapshot
`ResearchBillingDrawdown`	Run or Factory-effort billing drawdown
`ResearchBillingEntitlements`	Organization billing entitlement snapshot
`ResearchProjectEconomics`	Project usage, entitlements, and budgets
`ResearchSwarmProgress`	Typed progress returned by `handle.progress.get_typed` (alias `ResearchRunProgress`)
`ResearchWorkProduct`	Work product metadata
`ResearchArtifact`	Run artifact metadata
`ResearchArtifactManifest`	Typed run artifact manifest
`ResearchTagSessionCreateRequest`	Typed Factory Tag session request
`ResearchCreateProjectResult`	Result of runnable project creation

Classes

`ResearchSwarmProgress`

Public progress model including the backend-owned swarm state projection. Methods:

`from_wire`

from_wire(cls, payload: object) -> ResearchSwarmProgress

Decode backend swarm progress into the public progress model.