helm-sdk 0.5.15

Rust SDK for HELM — fail-closed tool calling for AI agents
Documentation

HELM SDK - Rust

Typed Rust client for the retained HELM kernel API.

Install

cargo add helm-sdk

Package metadata declares crate version 0.5.15 in Cargo.toml; verify registry state before publishing a pinned install claim.

Local Development

cargo test

Generated Sources

src/types_gen.rs is generated from api/openapi/helm.openapi.yaml. Protobuf bindings under src/generated/ are generated from protocols/proto/; the codegen feature can rebuild them with tonic-build.

Usage

use helm_sdk::{ChatCompletionRequest, ChatCompletionRequestMessagesInner, HelmClient, Role};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = HelmClient::new("http://127.0.0.1:7714");
    let result = client.chat_completions(&ChatCompletionRequest::new(
        "gpt-4".to_string(),
        vec![ChatCompletionRequestMessagesInner::new(
            Role::User,
            "hello".to_string(),
        )],
    ))?;
    println!("{:?}", result);
    Ok(())
}

Execution Boundary Methods

HelmClient includes calls for evidence envelope manifests, boundary records and checkpoints, conformance vectors, MCP quarantine and authorization profiles, sandbox profiles and grants, authz snapshots, approvals, budgets, telemetry export, and coexistence capabilities. SandboxGrantInspection returns either backend profiles or a sealed grant depending on whether a runtime query is provided.

Release Notes

0.5.15 is the release-hardening patch with the retained OpenAPI client surface and optional protobuf codegen.