Interface: GuardrailContext

Defined in: packages/agentos/src/core/guardrails/IGuardrailService.ts:76

Lightweight description of the conversational context for guardrail decisions.

Provides identity and session information to help guardrails make context-aware decisions (e.g., different policies per user tier).

Example

const context: GuardrailContext = {
  userId: 'user-123',
  sessionId: 'session-abc',
  personaId: 'support-agent',
  metadata: { userTier: 'premium', region: 'EU' }
};

Properties

conversationId?

optional conversationId: string

Defined in: packages/agentos/src/core/guardrails/IGuardrailService.ts:87

Conversation thread identifier

---

metadata?

optional metadata: Record<string, unknown>

Defined in: packages/agentos/src/core/guardrails/IGuardrailService.ts:93

Additional context for guardrail evaluation

---

mode?

optional mode: string

Defined in: packages/agentos/src/core/guardrails/IGuardrailService.ts:90

Operating mode (e.g., 'debug', 'production')

---

personaId?

optional personaId: string

Defined in: packages/agentos/src/core/guardrails/IGuardrailService.ts:84

Active persona/agent identity (if applicable)

---

sessionId

sessionId: string

Defined in: packages/agentos/src/core/guardrails/IGuardrailService.ts:81

Current session identifier

---

userId

userId: string

Defined in: packages/agentos/src/core/guardrails/IGuardrailService.ts:78

Unique identifier for the user making the request