Skip to content

Interface: PromptFirewallConfig

Defined in: packages/core/src/presenter/PromptFirewall.ts:74

Configuration for the PromptFirewall.

Accepts either a single adapter or a pre-built JudgeChain for multi-adapter evaluation (fallback/consensus).

Example

typescript
// Single adapter:
.promptFirewall({ adapter: gptMini })

// Multi-adapter (fallback):
.promptFirewall({
    chain: createJudgeChain({
        adapters: [gptMini, claudeHaiku],
        strategy: 'fallback',
    }),
})

// Multi-adapter (consensus — both must agree):
.promptFirewall({
    chain: createJudgeChain({
        adapters: [gptMini, claudeHaiku],
        strategy: 'consensus',
    }),
})

Properties

adapter?

ts
readonly optional adapter: SemanticProbeAdapter;

Defined in: packages/core/src/presenter/PromptFirewall.ts:79

Single LLM adapter for evaluation. Mutually exclusive with chain. If both provided, chain wins.


chain?

ts
readonly optional chain: JudgeChain;

Defined in: packages/core/src/presenter/PromptFirewall.ts:85

Pre-built JudgeChain for multi-adapter evaluation. Takes precedence over adapter if both are set.


failOpen?

ts
readonly optional failOpen: boolean;

Defined in: packages/core/src/presenter/PromptFirewall.ts:105

Behavior when ALL judges fail (timeout, error, unparseable).

  • false (default) — Fail-closed: rules are DROPPED.
  • trueFail-open: rules PASS (use at your own risk).

Only used when adapter is set. JudgeChain manages its own failOpen.

Default

ts
false

telemetry?

ts
readonly optional telemetry: TelemetrySink;

Defined in: packages/core/src/presenter/PromptFirewall.ts:112

Optional telemetry sink for security.firewall events. When provided, emits an event after every evaluation with verdict details (allowed/rejected counts, duration, fallback).


timeoutMs?

ts
readonly optional timeoutMs: number;

Defined in: packages/core/src/presenter/PromptFirewall.ts:93

Timeout per individual adapter call in milliseconds. Only used when adapter is set (JudgeChain manages its own timeouts).

Default

ts
5000