Marona Rust SDK
Universal Model Gateway and MCP/Skill SDK for Rust 1.82+.
Install
[]
= "1.1.2"
Authentication
A project-scoped Marona Developer Key is mandatory for every client and runtime
mode. Pass it explicitly or let the builder resolve MARONA_API_KEY.
use ;
async
Missing, invalid, revoked, and expired keys produce typed
Error::Authentication values with canonical gateway metadata.
Universal Model Gateway
Every model name must use the marona/* namespace. marona/auto delegates
selection to the project-scoped Model Registry; aliases such as
marona/company-assistant resolve there. Provider credentials and custom model
endpoints are configured once through the Marona Developer Portal or Model
Registry API. They are write-only and never exposed through this crate.
All calls—including registered Edge models—go through authenticated Marona Runtime. The crate has no direct-provider, local-executor, credential-cache, or public model-registration bypass.
Agents and Hub tools
use ;
# async
The same agent supports streaming, realtime, handoffs, delegation, A2A peers, validated function tools, lifecycle behavior, and published Marona Skills while keeping model execution behind the Universal Model Gateway.
Errors
GatewayError exposes code, request_id, retryable,
required_action, retry_after_ms, and safe details. Typed Error
variants cover authentication, namespace/model, credits, upstream service,
custom model, billing, and Marona availability failures. Responses expose only
safe routing fields, never upstream endpoints or raw provider payloads.
External MCP federation
# use Marona;
# async
Marona manages the Microsoft OAuth client; each application user only follows the authorization URL and consents. Use the same user subject as the runtime user ID afterward. The unified connection covers supported Outlook, Calendar, Teams, people, Planner, and OneDrive or SharePoint work context, including Word, Excel, and PowerPoint files, subject to the signed-in user's permissions.
Use a targeted connect for least privilege. connect_all() returns every
capability available to the developer key. External calls always pass through
Marona's governed gateway; upstream credentials and direct external endpoints
are never returned to the SDK.
Release
Version 1.1.2 is published to crates.io from tag rust-v1.1.2 only after
formatting, tests, Clippy, and package validation succeed on main.