InterventionHandler
Defined in: src/interventions/handler.ts:42
Base class for intervention handlers.
Handlers override the lifecycle methods they care about. Default implementations return Proceed. The framework detects which methods are overridden and only registers hook callbacks for those.
Example
Section titled “Example”class CedarAuth extends InterventionHandler { readonly name = 'cedar-auth'
override beforeToolCall(event: BeforeToolCallEvent): InterventionAction { if (!this.isAuthorized(event)) { return deny('User not authorized for this tool') } return proceed() }}Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new InterventionHandler(): InterventionHandler;Returns
Section titled “Returns”InterventionHandler
Properties
Section titled “Properties”abstract readonly name: string;Defined in: src/interventions/handler.ts:43
onError
Section titled “onError”readonly onError: OnError = 'throw';Defined in: src/interventions/handler.ts:46
What to do when this handler throws. Defaults to ‘throw’.
Methods
Section titled “Methods”beforeInvocation()
Section titled “beforeInvocation()”beforeInvocation(_event): Awaitable<Proceed | Deny | Guide | Transform>;Defined in: src/interventions/handler.ts:48
Parameters
Section titled “Parameters”| Parameter | Type |
| --------- | ---------------------------------------------------- |
| _event | BeforeInvocationEvent |
Returns
Section titled “Returns”Awaitable<Proceed | Deny | Guide | Transform>
beforeToolCall()
Section titled “beforeToolCall()”beforeToolCall(_event): Awaitable<Proceed | Deny | Guide | Transform | Confirm>;Defined in: src/interventions/handler.ts:52
Parameters
Section titled “Parameters”| Parameter | Type |
| --------- | ------------------------------------------------ |
| _event | BeforeToolCallEvent |
Returns
Section titled “Returns”Awaitable<Proceed | Deny | Guide | Transform | Confirm>
afterToolCall()
Section titled “afterToolCall()”afterToolCall(_event): Awaitable<Proceed | Transform>;Defined in: src/interventions/handler.ts:56
Parameters
Section titled “Parameters”| Parameter | Type |
| --------- | ---------------------------------------------- |
| _event | AfterToolCallEvent |
Returns
Section titled “Returns”Awaitable<Proceed | Transform>
beforeModelCall()
Section titled “beforeModelCall()”beforeModelCall(_event): Awaitable<Proceed | Deny | Guide | Transform>;Defined in: src/interventions/handler.ts:60
Parameters
Section titled “Parameters”| Parameter | Type |
| --------- | -------------------------------------------------- |
| _event | BeforeModelCallEvent |
Returns
Section titled “Returns”Awaitable<Proceed | Deny | Guide | Transform>
afterModelCall()
Section titled “afterModelCall()”afterModelCall(_event): Awaitable<Proceed | Guide | Transform>;Defined in: src/interventions/handler.ts:64
Parameters
Section titled “Parameters”| Parameter | Type |
| --------- | ------------------------------------------------ |
| _event | AfterModelCallEvent |
Returns
Section titled “Returns”Awaitable<Proceed | Guide | Transform>