Installation
Initialization
register_worker
Create and return a connected SDK instance. The WebSocket connection is established automatically in a dedicated background thread with its own tokio runtime. CallIIIClient::shutdown before the end of main to cleanly stop the
connection and join the background thread. In Rust the process exits
when main returns, terminating all threads, so shutdown() must be
called while main is still running.
Signature
Parameters
Example
Methods
register_trigger
Bind a trigger configuration to a registered function. SignatureParameters
Example
register_function
Register a function with the engine. Argument order matches the Node and Python SDKs:(id, registration).
Signature
Parameters
Example
trigger
Invoke a remote function. The routing behavior depends on theaction field of the request:
- No action: synchronous — waits for the function to return.
TriggerAction::Enqueue- async via named queue.TriggerAction::Void: fire-and-forget.
Parameters
Example
register_trigger_type
Register a custom trigger type with the engine. Returns aTriggerTypeRef handle that can register triggers and
functions with compile-time validated types.
Signature
Parameters
Example
unregister_trigger_type
Unregister a previously registered trigger type. SignatureParameters
get_connection_state
Get the current connection state. Signatureshutdown
Shutdown the III client and wait for the connection thread to finish. This stops the connection loop, sends a shutdown signal, and joins the background connection thread. OpenTelemetry is flushed inside the connection thread before it exits. Signatureshutdown_async
Shutdown the III client. This stops the connection loop and sends a shutdown signal, but it does not joinconnection_thread.
Unlike shutdown, this method does not block
to wait for run_connection() to finish, making it safe to call from
an async context without stalling the executor.
The OpenTelemetry flush (telemetry::shutdown_otel()) still runs inside the connection thread
after run_connection() returns, so it may not complete unless
shutdown is used to join the thread.
Signature
Types
iii_sdk
EnqueueResult · InitOptions · RegisterFunction · RegisterTriggerType · TelemetryOptions
EnqueueResult
Result returned by the engine when a message is successfully enqueued.InitOptions
Configuration options passed toregister_worker.
RegisterFunction
Function registration builder. The function ID is supplied separately at registration time viaIIIClient::register_function, RegisterFunction only carries the handler
and optional metadata.
Constructors:
RegisterFunction::new: sync function. Accepts both typed handlers (schemas auto-extracted viaschemars) andFn(Value) -> Result<Value, Error>closures (permissiveAnyValueschema, sinceValue: JsonSchema).RegisterFunction::new_async: async equivalent ofnew.RegisterFunction::new_async_with_bad_request: typed async handler that routes payload-deserialization failures through a caller-supplied mapper instead of the SDK’s genericError::Serde.RegisterFunction::http: function invoked over HTTP (Lambda, Cloudflare Workers, etc.).
self):
descriptionmetadatarequest_format: overrides any auto-extracted schema.response_format: overrides any auto-extracted schema.
RegisterTriggerType
Builder for registering a custom trigger type with optional format schemas. Type parameters:Ctracks the trigger registration type (set via.trigger_request_format::<T>())Rtracks the call request type (set via.call_request_format::<T>())
Value (untyped) and change when the respective builder
method is called. This allows IIIClient::register_trigger_type to return a
TriggerTypeRef<C, R> with compile-time safety for both config and
function input types.
TelemetryOptions
Worker metadata provided by the SDK to the engine.iii_sdk::builtin_triggers
CronCallRequest · CronTriggerConfig · HttpCallRequest · HttpMethod · HttpTriggerConfig · LogCallRequest · LogLevel · LogTriggerConfig · QueueTriggerConfig · StateCallRequest · StateEventType · StateTriggerConfig · SubscribeTriggerConfig
CronCallRequest
CronTriggerConfig
HttpCallRequest
HttpMethod
HttpTriggerConfig
LogCallRequest
LogLevel
LogTriggerConfig
QueueTriggerConfig
StateCallRequest
StateEventType
StateTriggerConfig
SubscribeTriggerConfig
iii_sdk::channel
Channel · ChannelReader · ChannelWriter · StreamChannelRef
Channel
A streaming channel pair for worker-to-worker data transfer.ChannelReader
WebSocket-backed reader for streaming binary data and text messages.ChannelWriter
WebSocket-backed writer for streaming binary data and text messages.StreamChannelRef
iii_sdk::channels
ChannelDirection · ChannelItem
ChannelDirection
ChannelItem
iii_sdk::engine
EngineFunctions · EngineTriggers
EngineFunctions
Engine function ids for internal operations.EngineTriggers
Engine trigger ids.iii_sdk::errors
Error · InvocationError
Error
Errors returned by the III SDK.InvocationError
Structured invocation failure, mirroring the Node and PythonInvocationError.
Produced from the Error::Remote variant via Error::invocation_error.
function_id is None from that accessor because the wire Remote payload
does not carry it.
iii_sdk::protocol
ErrorBody · FunctionMessage · Message · RegisterFunctionMessage · RegisterTriggerInput · RegisterTriggerMessage · RegisterTriggerTypeMessage · TriggerAction · TriggerRequest · UnregisterTriggerMessage · UnregisterTriggerTypeMessage
ErrorBody
FunctionMessage
Message
RegisterFunctionMessage
RegisterTriggerInput
Input forIIIClient::register_trigger.
The id is auto-generated internally.
RegisterTriggerMessage
RegisterTriggerTypeMessage
TriggerAction
Routing action forTriggerRequest. Determines how the engine handles
the invocation.
Enqueue— Routes through a named queue for async processing.Void— Fire-and-forget, no response.
TriggerRequest
Request object fortrigger(). Matches the Node/Python SDK signature:
trigger({ function_id, payload, action?, timeout_ms? })
UnregisterTriggerMessage
UnregisterTriggerTypeMessage
iii_sdk::runtime
FunctionInfo · FunctionRef · IIIConnectionState · TriggerInfo · TriggerTypeRef · WorkerInfo · WorkerMetadata
FunctionInfo
Function information returned byengine::functions::list
FunctionRef
IIIConnectionState
Connection state for the III WebSocket clientTriggerInfo
Trigger information returned byengine::triggers::list
TriggerTypeRef
Typed handle returned byIIIClient::register_trigger_type.
Type parameters:
C: trigger registration type forregister_triggerR: call request type forregister_function
WorkerInfo
Worker information returned byengine::workers::list
WorkerMetadata
Worker metadata for auto-registrationiii_sdk::structs
MiddlewareFunctionInput
MiddlewareFunctionInput
Input passed to the RBAC middleware function on every function invocation through the RBAC port. The middleware can inspect, modify, or reject the call before it reaches the target function.iii_sdk::trigger
IIITrigger · Trigger · TriggerConfig
IIITrigger
Enum of all built-in trigger types with typed configuration. Use.for_function() to create a RegisterTriggerInput:
Trigger
Handle returned byIIIClient::register_trigger.
Call unregister to remove the trigger from the engine.
TriggerConfig
Configuration passed to aTriggerHandler when a trigger instance is
registered or unregistered.
iii_sdk::types
RemoteFunctionData · RemoteFunctionHandler · RemoteTriggerTypeData · StreamRequest · StreamResponse
RemoteFunctionData
RemoteFunctionHandler
RemoteTriggerTypeData
StreamRequest
Streaming request type, mirroring the Node and PythonStreamRequest.
Alias of iii_helpers::http::HttpRequest; added for cross-language parity.
StreamResponse
Streaming response type, mirroring the Node and PythonStreamResponse.
Alias of iii_helpers::http::HttpResponse; added for cross-language parity.