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
modelstringno—Model identifier (e.g. ‘deepseek/deepseek-r1’).
rulesobject[]yes—Validation 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_usdnumberno—Explicit current spend; used when no live accumulator is wired.
max_usdnumberyes—Maximum 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[]yes—Detection rule set.
targetstringno—Input 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_tokensintegerno—Whitespace-token cap; exceeding tokens are dropped from the right.
schemaobjectno—Optional JSON Schema to validate the output against.
targetstringno—Output 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