Struct Client 

pub struct Client { /* private fields */ }

Cloneable, pooled HTTP/1 client with verified TLS. No redirects, automatic retries or environment proxies. DNS hostnames must be ASCII (use punycode for IDN). A Tokio runtime is required for requests.

Implementations

impl Client

pub async fn upload_file( &self, filename: &str, data: &[u8], options: FileUploadOptions, ) -> Result<FileObject, Error>

Upload caller-owned JSONL bytes (at most 200 MB); memory includes a multipart copy of the input. No file paths or URLs are opened. Expiry fields precede the file part.

pub async fn list_files( &self, options: BatchListOptions<'_>, purpose: Option<&str>, ) -> Result<BatchPage<FileObject>, Error>

Read one page of files; optional purpose is batch or batch_output.

pub async fn get_file(&self, id: &str) -> Result<FileObject, Error>

Retrieve file metadata.

pub async fn delete_file(&self, id: &str) -> Result<DeletedFile, Error>

Delete a file (the server may retain physical bytes until guarded cleanup).

pub async fn download_file(&self, id: &str) -> Result<Vec<u8>, Error>

Download exact JSONL bytes, bounded by ClientOptions::max_response_bytes (default 8 MiB). Increase that explicit cap when downloading larger files. Dropping the future cancels I/O.

pub async fn create_batch( &self, request: &CreateBatchRequest, idempotency_key: Option<&str>, ) -> Result<Batch, Error>

Create a batch; an optional owner-scoped idempotency key is 1–128 visible ASCII bytes. Retrying is the caller’s decision; reuse the same key only with the same request.

pub async fn list_batches( &self, options: BatchListOptions<'_>, ) -> Result<BatchPage<Batch>, Error>

Read one page of batches.

pub async fn get_batch(&self, id: &str) -> Result<Batch, Error>

Retrieve a batch without polling.

pub async fn cancel_batch(&self, id: &str) -> Result<Batch, Error>

Request cancellation; partial result files may be published later.

pub async fn batch_health(&self) -> Result<Value, Error>

Read Batch health. The server exposes this route without authentication.

impl Client

pub fn files(&self) -> Files<'_>

Files resource with create, retrieve, list, delete and content operations.

pub fn batches(&self) -> Batches<'_>

Batches resource with both create paths, retrieval and opt-in workflow helpers.

impl Client

pub fn new(base_url: &str) -> Result<Self, Error>

Connect to a server root with the default timeout and no authentication.

pub fn with_options(options: ClientOptions<'_>) -> Result<Self, Error>

Validate configuration and build a connection pool. TLS uses an explicit per-client ring provider and the platform’s certificate verifier; no process-global crypto provider is installed.

pub async fn decide<Q: QuestionSet>( &self, state: impl Into<Value>, questions: &Q, ) -> Result<TypedDecisionResponse<Q::Schema>, Error>

Decide from a JSON state and typed question builder.

pub async fn decide_with_options<Q: QuestionSet>( &self, state: impl Into<Value>, questions: &Q, options: DecisionOptions<'_>, ) -> Result<TypedDecisionResponse<Q::Schema>, Error>

Typed decision with explicit model/facts options.

pub async fn decide_request( &self, request: &DecisionRequest, ) -> Result<DecisionResponse, Error>

POST /v1/basal. Request fields and capability limits are validated by the server.

pub async fn models(&self) -> Result<ModelsResponse, Error>

GET /v1/models.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.