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.Deploy on macOS Protect local coding agents with a direct install or a managed rollout through your MDM.Secure an AI gateway Inspect model traffic through LiteLLM guardrails or Vercel AI Gateway middleware.

Classify a request

User input
Tool output
Model output

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)

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)

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)
}

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());
    }
}

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)

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)

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)
}

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());
    }
}

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)

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)

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)
}

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());
    }
}