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

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

Constructor

new InterventionHandler(): InterventionHandler;

Returns

InterventionHandler

Properties

name

abstract readonly name: string;

Defined in: src/interventions/handler.ts:43

---

onError

readonly onError: OnError = 'throw';

Defined in: src/interventions/handler.ts:46

What to do when this handler throws. Defaults to ‘throw’.

Methods

beforeInvocation()

beforeInvocation(_event): Awaitable<Proceed | Deny | Guide | Transform>;

Defined in: src/interventions/handler.ts:48

Parameters

Parameter	Type
_event	BeforeInvocationEvent

Returns

Awaitable<Proceed | Deny | Guide | Transform>

---

beforeToolCall()

beforeToolCall(_event): Awaitable<Proceed | Deny | Guide | Transform | Confirm>;

Defined in: src/interventions/handler.ts:52

Parameters

Parameter	Type
_event	BeforeToolCallEvent

Returns

Awaitable<Proceed | Deny | Guide | Transform | Confirm>

---

afterToolCall()

afterToolCall(_event): Awaitable<Proceed | Transform>;

Defined in: src/interventions/handler.ts:56

Parameters

Parameter	Type
_event	AfterToolCallEvent

Returns

Awaitable<Proceed | Transform>

---

beforeModelCall()

beforeModelCall(_event): Awaitable<Proceed | Deny | Guide | Transform>;

Defined in: src/interventions/handler.ts:60

Parameters

Parameter	Type
_event	BeforeModelCallEvent

Returns

Awaitable<Proceed | Deny | Guide | Transform>

---

afterModelCall()

afterModelCall(_event): Awaitable<Proceed | Guide | Transform>;

Defined in: src/interventions/handler.ts:64

Parameters

Parameter	Type
_event	AfterModelCallEvent

Returns

Awaitable<Proceed | Guide | Transform>