00_INDEX

HELM SDK Documentation

Available SDKs

Language Package Install Docs
TypeScript @mindburn/helm npm install @mindburn/helm sdk/ts/README.md
Python helm-sdk pip install helm-sdk sdk/python/README.md
Go helm-oss/sdk/go go get github.com/Mindburn-Labs/helm-oss/sdk/go sdk/go/README.md
Rust helm-sdk cargo add helm-sdk sdk/rust/README.md
Java ai.mindburn.helm:helm Maven/Gradle sdk/java/README.md

Common API Surface

Every SDK exposes the same core primitives:

Method Description
chatCompletions Governed chat completion via HELM proxy
approveIntent Submit approval for high-risk operations
listSessions List ProofGraph sessions
getReceipts Get receipts for a session
exportEvidence Export EvidencePack
verifyEvidence Verify EvidencePack offline
conformanceRun Run conformance check
health Health check

Every error includes a typed reason_code (e.g., DENY_TOOL_NOT_FOUND, BUDGET_EXCEEDED).

Zero-SDK Path

You don't need an SDK to use HELM. Point any OpenAI-compatible client at the HELM proxy:

export OPENAI_BASE_URL=http://localhost:8080/v1

SDKs add typed errors, receipt parsing, and framework-specific adapters.

Contract Versioning

SDKs are generated from api/openapi/helm.openapi.yaml. CI prevents drift between the spec and generated types. Run make codegen-check to verify.