Struct SdkConfig 

pub struct SdkConfig {
    pub instance_id: String,
    pub tenant_id: String,
    pub server_addr: SocketAddr,
    pub server_name: String,
    pub skip_cert_verification: bool,
    pub connect_timeout_ms: u64,
    pub request_timeout_ms: u64,
    pub signal_poll_interval_ms: u64,
    pub heartbeat_interval_ms: u64,
}

SDK configuration for connecting to runtara-core.

Fields

instance_id: String

Instance ID (required) - unique identifier for this instance

tenant_id: String

Tenant ID (required) - tenant this instance belongs to

server_addr: SocketAddr

Server address (default: “127.0.0.1:8001”)

server_name: String

Server name for TLS verification (default: “localhost”)

skip_cert_verification: bool

Skip TLS certificate verification (default: false, use true for dev)

connect_timeout_ms: u64

Connection timeout in milliseconds (default: 10_000)

request_timeout_ms: u64

Request timeout in milliseconds (default: 30_000)

signal_poll_interval_ms: u64

Signal poll interval in milliseconds (default: 1_000)

heartbeat_interval_ms: u64

Background heartbeat interval in milliseconds (default: 30_000). Set to 0 to disable automatic heartbeats. Heartbeats run in a background task and keep the instance alive during long-running operations that don’t checkpoint frequently.

Implementations

impl SdkConfig

pub fn from_env() -> Result<SdkConfig, SdkError>

Load configuration from environment variables.

Required Environment Variables

• RUNTARA_INSTANCE_ID - Unique identifier for this instance
• RUNTARA_TENANT_ID - Tenant this instance belongs to

Optional Environment Variables

• RUNTARA_SERVER_ADDR - Server address (default: “127.0.0.1:8001”)
• RUNTARA_SERVER_NAME - Server name for TLS (default: “localhost”)
• RUNTARA_SKIP_CERT_VERIFICATION - Skip TLS verification (default: false)
• RUNTARA_CONNECT_TIMEOUT_MS - Connection timeout (default: 10000)
• RUNTARA_REQUEST_TIMEOUT_MS - Request timeout (default: 30000)
• RUNTARA_SIGNAL_POLL_INTERVAL_MS - Signal poll interval (default: 1000)
• RUNTARA_HEARTBEAT_INTERVAL_MS - Background heartbeat interval (default: 30000, 0 to disable)

pub fn localhost( instance_id: impl Into<String>, tenant_id: impl Into<String>, ) -> SdkConfig

Create a configuration for local development.

This sets up reasonable defaults for local development:

• Connects to 127.0.0.1:8001
• Skips TLS certificate verification

pub fn new( instance_id: impl Into<String>, tenant_id: impl Into<String>, ) -> SdkConfig

Create a new configuration with the given instance and tenant IDs.

pub fn with_server_addr(self, addr: SocketAddr) -> SdkConfig

Set the server address.

pub fn with_server_name(self, name: impl Into<String>) -> SdkConfig

Set the server name for TLS verification.

pub fn with_skip_cert_verification(self, skip: bool) -> SdkConfig

Skip TLS certificate verification (for development only!).

pub fn with_signal_poll_interval_ms(self, interval_ms: u64) -> SdkConfig

Set the signal poll interval.

pub fn with_heartbeat_interval_ms(self, interval_ms: u64) -> SdkConfig

Set the background heartbeat interval. Set to 0 to disable automatic heartbeats.

Trait Implementations

impl Clone for SdkConfig

fn clone(&self) -> SdkConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SdkConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.