chaos

Documentation

Overview

Package chaos provides fault injection for PromptArena resilience testing. It implements a hooks.ToolHook that intercepts tool execution and injects failures (errors, timeouts, latency) based on scenario chaos configuration.

Index

• func ConfigFromContext(ctx context.Context) *config.ChaosConfig
• func WithConfig(ctx context.Context, cfg *config.ChaosConfig) context.Context
• type Hook
  • func NewHook() *Hook
  • func (h *Hook) AfterExecution(_ context.Context, _ hooks.ToolRequest, _ hooks.ToolResponse) hooks.Decision
  • func (h *Hook) BeforeExecution(ctx context.Context, req hooks.ToolRequest) hooks.Decision
  • func (h *Hook) Name() string

Functions

func ConfigFromContext

func ConfigFromContext(ctx context.Context) *config.ChaosConfig

ConfigFromContext retrieves chaos config from the context.

func WithConfig

func WithConfig(ctx context.Context, cfg *config.ChaosConfig) context.Context

WithConfig stores chaos config in the context.

Types

type Hook

type Hook struct{}

Hook implements hooks.ToolHook to inject failures into tool execution.

func NewHook

func NewHook() *Hook

NewHook creates a new chaos injection hook.

func (*Hook) AfterExecution

func (h *Hook) AfterExecution(_ context.Context, _ hooks.ToolRequest, _ hooks.ToolResponse) hooks.Decision

AfterExecution is a no-op — always allows.

func (*Hook) BeforeExecution

func (h *Hook) BeforeExecution(ctx context.Context, req hooks.ToolRequest) hooks.Decision

BeforeExecution checks chaos config and injects tool failures.

func (*Hook) Name

func (h *Hook) Name() string

Name returns the hook name.