> ## 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.

# 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`:

```python theme={null}
from synth_ai import SynthClient

client = SynthClient()

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

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

<Warning>
  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.
</Warning>

## 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](/reference/sdk/research/synth_ai-research-errors).

## 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.