Graphorin API reference v0.15.1

Graphorin API reference / @graphorin/security / / ToolUsageValidatorOptions

Interface: ToolUsageValidatorOptions

Defined in: packages/security/src/guardrails/builtins/tool-usage-validator.ts:35

Stable

Options for toolUsageValidator(...).

Properties

Property	Modifier	Type	Description	Defined in
`action?`	`readonly`	`"block"` \| `"warn"`	Action on rejection. Defaults to `'block'`.	packages/security/src/guardrails/builtins/tool-usage-validator.ts:52
`forbiddenTools?`	`readonly`	readonly `string`[]	Tool names that must NOT appear.	packages/security/src/guardrails/builtins/tool-usage-validator.ts:39
`maxCalls?`	`readonly`	`number`	Maximum number of total tool invocations.	packages/security/src/guardrails/builtins/tool-usage-validator.ts:41
`maxPerTool?`	`readonly`	`number`	Maximum number of invocations per tool name.	packages/security/src/guardrails/builtins/tool-usage-validator.ts:43
`name?`	`readonly`	`string`	Override guardrail name.	packages/security/src/guardrails/builtins/tool-usage-validator.ts:54
`predicate?`	`readonly`	(`calls`) => \| { `ok`: `true`; } \| { `message`: `string`; `ok`: `false`; }	Custom predicate. Returning `false` rejects the run with the supplied `message`.	packages/security/src/guardrails/builtins/tool-usage-validator.ts:48
`requiredTools?`	`readonly`	readonly `string`[]	Tool names that must appear at least once.	packages/security/src/guardrails/builtins/tool-usage-validator.ts:37