Horizons Private compatibility exports

Status and supported use of legacy and explicit Horizons Private clients exported by synth-ai.

The names on this page remain public for compatibility with explicit Horizons Private integrations. They are not the recommended starting point for new Synth applications.

For new code, start with SynthClient:

from synth_ai import SynthClient

client = SynthClient()

# Managed Research and Research Factory
projects = client.research.projects.list()

# Rollout infrastructure
pools = client.pools.list()

Do not treat these compatibility clients as implicit namespaces on SynthClient. The old client.horizons_private, client.managed_agents, client.managed_agents_anthropic, and client.openai_agents_sdk paths are retired or deprecated. Use the supported research and pools namespaces unless you operate an explicit Horizons Private endpoint.

Compatibility clients

Export	Status	Use
HorizonsPrivateClient	Deprecated facade	Synchronous access to an explicit Horizons Private rollout endpoint. Prefer client.pools.rollouts.
AsyncHorizonsPrivateClient	Deprecated facade	Async counterpart to HorizonsPrivateClient. Prefer the async pools rollout surface.
SynthManagedAgents	Compatibility	Synchronous managed-agent client for an explicit Horizons Private endpoint.
AsyncSynthManagedAgents	Compatibility	Async counterpart to SynthManagedAgents.
ManagedAgentsAnthropicClient	Compatibility	Synchronous Anthropic-shaped client for an explicit Horizons Private endpoint.
AsyncManagedAgentsAnthropicClient	Compatibility	Async counterpart to ManagedAgentsAnthropicClient.
OpenAIAgentsSdkClient	Compatibility	Synchronous OpenAI Agents SDK bridge for an explicit Horizons Private endpoint.
AsyncOpenAIAgentsSdkClient	Compatibility	Async counterpart to OpenAIAgentsSdkClient.
ManagedAgentRun	Compatibility model	Run record returned by the managed-agent compatibility clients.

Construct these clients only through their explicit Horizons Private configuration path, with a private base URL and credential supplied by your Synth operator. Do not copy private endpoints or credentials into source code or documentation.

Tool helpers

Two public helpers build tool definitions for the compatibility clients:

Export	Use
function_tool	Define a function tool using an OpenAI Responses-compatible schema.
mcp_tool	Define an MCP tool entry for the same compatibility surface.

These helpers describe tools; they do not register a tool globally or replace the Managed Research MCP client.

Error compatibility

ManagedResearchError is a legacy base error retained for import compatibility. New integrations should catch ResearchApiError or the more specific typed errors documented in the Research errors reference.

Migration guidance

Older integration	Current path
HorizonsPrivateClient rollout calls	SynthClient().pools.rollouts
Implicit managed-agent namespace	An explicit compatibility client, only for a provisioned Horizons Private endpoint
Managed Research through compatibility clients	SynthClient().research
ManagedResearchError in new code	ResearchApiError or a specific research error

Keeping these exports public avoids a breaking import change. Their presence does not make them part of the primary SDK path, and new features are added to the typed research, pools, and other SynthClient namespaces instead.