Skip to main content

Crate synthiaresearch

Crate synthiaresearch 

Source
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) and packages/sdk-python/src/synthia/client.py method-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.