Expand description
Rust SDK for the Synthia API.
Synthia interviews your agent to model its users, generates a calibrated dataset of adversarial scenarios, plays each one in a deterministic simulator, and judges every rollout. Your agent runs on your infrastructure; only replies and traced tool calls cross the wire.
This SDK mirrors the JavaScript and Python SDKs — same methods, same request
bodies, same server contract, snake_case names. docs/reference/js-api.md
is the long-form reference; the Rust-specific divergences (async, Result,
options structs) are listed in docs/reference/rust-api.md.
Every SDK publishes as synthiaresearch — npm, PyPI, and crates.io.
Re-exports§
pub use crate::client::AgentReply;pub use crate::client::Content;pub use crate::client::Dataset;pub use crate::client::Datasets;pub use crate::client::EvalOptions;pub use crate::client::EvalOutcome;pub use crate::client::GenerateOptions;pub use crate::client::GenerationJob;pub use crate::client::ModelRef;pub use crate::client::PrepareOptions;pub use crate::client::PrepareResult;pub use crate::client::ProbeAgent;pub use crate::client::ProbeOptions;pub use crate::client::QualityCheck;pub use crate::client::Reply;pub use crate::client::RolloutAgent;pub use crate::client::RolloutRef;pub use crate::client::RolloutResult;pub use crate::client::Rollouts;pub use crate::client::RunOptions;pub use crate::client::ScenarioOptions;pub use crate::client::Seeds;pub use crate::client::Synthia;pub use crate::client::SynthiaOptions;pub use crate::client::ToolCall;pub use crate::client::TraceIngestOptions;pub use crate::client::TraceRecorder;pub use crate::client::Traces;pub use crate::client::UserModels;pub use crate::client::ValidationRun;pub use crate::client::WaitOptions;pub use crate::error::Error;pub use crate::error::Result;pub use crate::sandbox::py_json;pub use crate::sandbox::Report;pub use crate::sandbox::ToolEvent;pub use crate::sandbox::ToolSandbox;pub use crate::types::Rollout as ApiRollout;pub use crate::types::ToolCall as ApiToolCall;pub use crate::types::TranscriptTurn as ApiTranscriptTurn;
Modules§
- client
- The Synthia client. Mirrors
packages/sdk-js/src/client.ts(canonical) andpackages/sdk-python/src/synthia/client.pymethod-for-method. - error
- Errors.
- redact
- Client-side PII redaction for production traces.
- sandbox
- Deterministic tool sandbox — the four-way hash-identity constraint.
- types
Constants§
- DEFAULT_
BASE_ URL - Default base URL for the hosted API. Override with
SYNTHIA_BASE_URL. - SDK_
VERSION - The SDK version reported to the server on the session handshake.