Skip to content

Guardrails operators

Public

The Guardrails family contains 4 operators. Input/output filtering and cost capping.

Validates text against safety/compliance rules.

Version 1.0.0 · Semantics passthrough · Visibility advanced · Secrets OPENROUTER_API_KEY

FieldTypeRequiredDefaultDescription
max_tokensintegerno4096
modelstringnoModel identifier (e.g. ‘deepseek/deepseek-r1’).
rulesobject[]yesValidation rules to apply.
stop_sequencesstring[]no
temperaturenumberno0.7
top_pnumberno
PortTypeRequiredDescription
inputstringyesInput
PortTypeRequiredDescription
passbooleannoPass
usageobjectnoUsage
violationsarraynoViolations

Compares the run’s accumulated USD spend against a hard cap. Fails or throttles when exceeded.

Version 1.0.0 · Semantics passthrough · Idempotent

FieldTypeRequiredDefaultDescription
action”fail” | “throttle”no"fail"
current_usdnumbernoExplicit current spend; used when no live accumulator is wired.
max_usdnumberyesMaximum allowed spend in USD.
PortTypeRequiredDescription
inputanynoInput
PortTypeRequiredDescription
outputobjectnoOutput

Scans an input string for PII / prompt injection / jailbreak patterns and can fail, redact, or flag.

Version 1.0.0 · Semantics passthrough · Idempotent

FieldTypeRequiredDefaultDescription
on_block”fail” | “redact” | “flag”no"flag"
rulesstring[]yesDetection rule set.
targetstringnoInput text to scan. Falls back to inputs.output if omitted.
PortTypeRequiredDescription
inputstringnoInput
PortTypeRequiredDescription
outputobjectnoOutput

Validates an output against a JSON schema, truncates by max_tokens, and (optionally) runs an external toxicity check.

Version 1.0.0 · Semantics passthrough · Idempotent · Secrets OPENAI_API_KEY

FieldTypeRequiredDefaultDescription
max_tokensintegernoWhitespace-token cap; exceeding tokens are dropped from the right.
schemaobjectnoOptional JSON Schema to validate the output against.
targetstringnoOutput to filter. Falls back to inputs.output if omitted.
toxicity_provider”openai_moderation” | “none”no"none"
PortTypeRequiredDescription
inputstringnoInput
PortTypeRequiredDescription
outputobjectnoOutput

Every operator above is rendered from its JSON schema in /opt/glyph/schemas/operators/:

  • schemas/operators/guardrails.check.json
  • schemas/operators/guardrails.cost_cap.json
  • schemas/operators/guardrails.input_filter.json
  • schemas/operators/guardrails.output_filter.json