Silmaril

Protect long-horizon agents. Install an SDK, initialize Firewall, and classify key execution boundaries. Explore the core concepts.

Choose your path

Protect an AI application Add a language SDK and classify your first request at the model or tool boundary. Secure an AI gateway Inspect model traffic through LiteLLM guardrails or Vercel AI Gateway middleware.

Classify a request

```typescript TypeScript theme={"theme":"github-light-default"} import { Firewall, HookLabel } from "@silmaril-security/sdk" const fw = new Firewall({ apiKey: process.env.SILMARIL_API_KEY!, apiUrl: process.env.SILMARIL_API_URL!, }) const userInput = "Summarize this release note." const result = await fw.classify(userInput, { hook: HookLabel.USER_INPUT, }) console.log(result.prediction) ``` ```python Python theme={"theme":"github-light-default"} import os from silmaril_security.sdk import Firewall, HookLabel fw = Firewall( api_key=os.environ["SILMARIL_API_KEY"], api_url=os.environ["SILMARIL_API_URL"], ) user_input = "Summarize this release note." result = fw.classify( user_input, hook=HookLabel.USER_INPUT, ) print(result.prediction) ``` ```go Go theme={"theme":"github-light-default"} package main import ( "context" "log" "os" "github.com/Silmaril-Security/sdk-go/firewall" ) func main() { fw, err := firewall.New(firewall.Options{ APIKey: os.Getenv("SILMARIL_API_KEY"), APIURL: os.Getenv("SILMARIL_API_URL"), }) if err != nil { log.Fatal(err) } result, err := fw.Classify(context.Background(), "Summarize this release note.", firewall.WithHook(firewall.HookUserInput), ) if err != nil { log.Fatal(err) } log.Println(result.Prediction) } ``` ```java Java theme={"theme":"github-light-default"} import dev.silmaril.security.Firewall; import dev.silmaril.security.HookLabel; import dev.silmaril.security.ClassifyOptions; public class Example { public static void main(String[] args) throws Exception { var fw = Firewall.builder() .apiKey(System.getenv("SILMARIL_API_KEY")) .apiUrl(System.getenv("SILMARIL_API_URL")) .build(); var result = fw.classify( "Summarize this release note.", ClassifyOptions.builder() .hook(HookLabel.USER_INPUT) .build() ); System.out.println(result.prediction()); } } ``` ```typescript TypeScript theme={"theme":"github-light-default"} import { Firewall, HookLabel } from "@silmaril-security/sdk" const fw = new Firewall({ apiKey: process.env.SILMARIL_API_KEY!, apiUrl: process.env.SILMARIL_API_URL!, }) const toolOutput = "Release note text." const result = await fw.classify(toolOutput, { hook: HookLabel.TOOL_RESPONSE, toolName: "read_file", }) console.log(result.prediction) ``` ```python Python theme={"theme":"github-light-default"} import os from silmaril_security.sdk import Firewall, HookLabel fw = Firewall( api_key=os.environ["SILMARIL_API_KEY"], api_url=os.environ["SILMARIL_API_URL"], ) tool_output = "Release note text." result = fw.classify( tool_output, hook=HookLabel.TOOL_RESPONSE, tool_name="read_file", ) print(result.prediction) ``` ```go Go theme={"theme":"github-light-default"} package main import ( "context" "log" "os" "github.com/Silmaril-Security/sdk-go/firewall" ) func main() { fw, err := firewall.New(firewall.Options{ APIKey: os.Getenv("SILMARIL_API_KEY"), APIURL: os.Getenv("SILMARIL_API_URL"), }) if err != nil { log.Fatal(err) } result, err := fw.Classify(context.Background(), "Release note text.", firewall.WithHook(firewall.HookToolResponse), firewall.WithToolName("read_file"), ) if err != nil { log.Fatal(err) } log.Println(result.Prediction) } ``` ```java Java theme={"theme":"github-light-default"} import dev.silmaril.security.Firewall; import dev.silmaril.security.HookLabel; import dev.silmaril.security.ClassifyOptions; public class Example { public static void main(String[] args) throws Exception { var fw = Firewall.builder() .apiKey(System.getenv("SILMARIL_API_KEY")) .apiUrl(System.getenv("SILMARIL_API_URL")) .build(); var result = fw.classify( "Release note text.", ClassifyOptions.builder() .hook(HookLabel.TOOL_RESPONSE) .toolName("read_file") .build() ); System.out.println(result.prediction()); } } ``` ```typescript TypeScript theme={"theme":"github-light-default"} import { Firewall, HookLabel } from "@silmaril-security/sdk" const fw = new Firewall({ apiKey: process.env.SILMARIL_API_KEY!, apiUrl: process.env.SILMARIL_API_URL!, }) const modelOutput = "The release improves request handling." const result = await fw.classify(modelOutput, { hook: HookLabel.LLM_OUTPUT, }) console.log(result.prediction) ``` ```python Python theme={"theme":"github-light-default"} import os from silmaril_security.sdk import Firewall, HookLabel fw = Firewall( api_key=os.environ["SILMARIL_API_KEY"], api_url=os.environ["SILMARIL_API_URL"], ) model_output = "The release improves request handling." result = fw.classify( model_output, hook=HookLabel.LLM_OUTPUT, ) print(result.prediction) ``` ```go Go theme={"theme":"github-light-default"} package main import ( "context" "log" "os" "github.com/Silmaril-Security/sdk-go/firewall" ) func main() { fw, err := firewall.New(firewall.Options{ APIKey: os.Getenv("SILMARIL_API_KEY"), APIURL: os.Getenv("SILMARIL_API_URL"), }) if err != nil { log.Fatal(err) } result, err := fw.Classify(context.Background(), "The release improves request handling.", firewall.WithHook(firewall.HookLLMOutput), ) if err != nil { log.Fatal(err) } log.Println(result.Prediction) } ``` ```java Java theme={"theme":"github-light-default"} import dev.silmaril.security.Firewall; import dev.silmaril.security.HookLabel; import dev.silmaril.security.ClassifyOptions; public class Example { public static void main(String[] args) throws Exception { var fw = Firewall.builder() .apiKey(System.getenv("SILMARIL_API_KEY")) .apiUrl(System.getenv("SILMARIL_API_URL")) .build(); var result = fw.classify( "The release improves request handling.", ClassifyOptions.builder() .hook(HookLabel.LLM_OUTPUT) .build() ); System.out.println(result.prediction()); } } ```

Install and configure your SDK, then try a classification. Handle the result before continuing.

Language SDKs

TypeScriptSDK {sdkVersions.typescript.version}

PythonSDK {sdkVersions.python.version}

GoSDK {sdkVersions.go.version}

JavaSDK {sdkVersions.java.version}

Connect your stack

Framework SDKsAdd protection to Vercel AI SDK, LangChain, or LangGraph. Coding agent pluginsConnect protection directly to supported agent hooks. Firewall MCPLet your MCP client investigate findings and traffic. Self-hostingPlan a deployment in your cloud account with Silmaril.