TypeScript SDK
HELM 커널용 TypeScript 클라이언트 — 형식화된 바인딩 및 프레임워크 어댑터.
TypeScript SDK
You may not need the SDK. The simplest integration is changing
base_url— see the Quickstart. The SDK adds typed bindings and framework adapters for deeper integration.
The TypeScript SDK ships in-repo at sdk/ts/ and is published on npm as @mindburn/helm.
Install
npm install @mindburn/helm
Usage
Drop-in proxy (no SDK needed)
const response = await fetch("http://localhost:8080/v1/chat/completions", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
model: "gpt-4",
messages: [{ role: "user", content: "List /tmp" }],
}),
});
// X-Helm-Verdict: ALLOW
SDK client
import { HelmClient, HelmApiError } from "@mindburn/helm";
const client = new HelmClient("http://localhost:8080");
try {
const res = await client.chatCompletions({ model: "gpt-4", messages: [...] });
} catch (e) {
if (e instanceof HelmApiError) {
console.log("Denied:", e.reasonCode); // DENY_TOOL_NOT_FOUND
}
}
Framework adapters
| Adapter | Path | Status |
|---|---|---|
| Mastra | sdk/ts/mastra/ |
Active |
| OpenAI Agents | sdk/ts/openai-agents/ |
Active |
| Semantic Kernel | sdk/ts/semantic-kernel/ |
Active |
| Autogen | sdk/ts/autogen/ |
Active |
Next steps
- Python SDK — Python client
- Go SDK — Go client
- Proxy API — HTTP endpoints