Graphorin API reference v0.1.0
Graphorin API reference / @graphorin/security / / ToolUsageValidatorOptions
Interface: ToolUsageValidatorOptions
Defined in: packages/security/src/guardrails/builtins/tool-usage-validator.ts:35
Options for toolUsageValidator(...).
Stable
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 |