# loopy-agent — public API reference for LLM ingestion

Generated by `scripts/generate_llms_txt.py`. This file captures every public symbol in the `loopy` package along with its docstring and source signature. Designed for AI coding assistants (Cursor, Claude Code, Continue, Aider, Cody, etc.) to ingest as project context.

Format: each symbol is fenced by `# Module` headers and `# Symbol` subheaders.


---


# Module `loopy`

## AgentLoop

> Could not import `loopy.AgentLoop`: No module named 'loopy'

## AssertionResult

> Could not import `loopy.AssertionResult`: No module named 'loopy'

## AuditLogger

> Could not import `loopy.AuditLogger`: No module named 'loopy'

## AuditReport

> Could not import `loopy.AuditReport`: No module named 'loopy'

## BudgetExceeded

> Could not import `loopy.BudgetExceeded`: No module named 'loopy'

## CacheMiddleware

> Could not import `loopy.CacheMiddleware`: No module named 'loopy'

## CacheStats

> Could not import `loopy.CacheStats`: No module named 'loopy'

## CheckItem

> Could not import `loopy.CheckItem`: No module named 'loopy'

## CircuitBreakerMiddleware

> Could not import `loopy.CircuitBreakerMiddleware`: No module named 'loopy'

## ComplianceChecker

> Could not import `loopy.ComplianceChecker`: No module named 'loopy'

## ConnectionPool

> Could not import `loopy.ConnectionPool`: No module named 'loopy'

## Context

> Could not import `loopy.Context`: No module named 'loopy'

## CostReport

> Could not import `loopy.CostReport`: No module named 'loopy'

## CostTracker

> Could not import `loopy.CostTracker`: No module named 'loopy'

## DecisionStep

> Could not import `loopy.DecisionStep`: No module named 'loopy'

## DecisionTrace

> Could not import `loopy.DecisionTrace`: No module named 'loopy'

## DecisionTracker

> Could not import `loopy.DecisionTracker`: No module named 'loopy'

## DecisionType

> Could not import `loopy.DecisionType`: No module named 'loopy'

## DriftDetector

> Could not import `loopy.DriftDetector`: No module named 'loopy'

## DriftIssue

> Could not import `loopy.DriftIssue`: No module named 'loopy'

## DriftReport

> Could not import `loopy.DriftReport`: No module named 'loopy'

## Edge

> Could not import `loopy.Edge`: No module named 'loopy'

## EvalCase

> Could not import `loopy.EvalCase`: No module named 'loopy'

## EvalGate

> Could not import `loopy.EvalGate`: No module named 'loopy'

## EvalGateResult

> Could not import `loopy.EvalGateResult`: No module named 'loopy'

## EvalGateType

> Could not import `loopy.EvalGateType`: No module named 'loopy'

## EvalReport

> Could not import `loopy.EvalReport`: No module named 'loopy'

## EvalResult

> Could not import `loopy.EvalResult`: No module named 'loopy'

## EvalSuite

> Could not import `loopy.EvalSuite`: No module named 'loopy'

## Evaluator

> Could not import `loopy.Evaluator`: No module named 'loopy'

## FallbackMiddleware

> Could not import `loopy.FallbackMiddleware`: No module named 'loopy'

## FilterAction

> Could not import `loopy.FilterAction`: No module named 'loopy'

## Gateway

> Could not import `loopy.Gateway`: No module named 'loopy'

## GatewayResponse

> Could not import `loopy.GatewayResponse`: No module named 'loopy'

## GuardrailPipeline

> Could not import `loopy.GuardrailPipeline`: No module named 'loopy'

## ImageFormat

> Could not import `loopy.ImageFormat`: No module named 'loopy'

## InputFilter

> Could not import `loopy.InputFilter`: No module named 'loopy'

## JudgeConfig

> Could not import `loopy.JudgeConfig`: No module named 'loopy'

## LLMCache

> Could not import `loopy.LLMCache`: No module named 'loopy'

## LocalMCP

> Could not import `loopy.LocalMCP`: No module named 'loopy'

## LoggingMiddleware

> Could not import `loopy.LoggingMiddleware`: No module named 'loopy'

## LoopConfig

> Could not import `loopy.LoopConfig`: No module named 'loopy'

## LoopPattern

> Could not import `loopy.LoopPattern`: No module named 'loopy'

## LoopState

> Could not import `loopy.LoopState`: No module named 'loopy'

## MCPClient

> Could not import `loopy.MCPClient`: No module named 'loopy'

## MCPTool

> Could not import `loopy.MCPTool`: No module named 'loopy'

## MCPToolResult

> Could not import `loopy.MCPToolResult`: No module named 'loopy'

## MediaContent

> Could not import `loopy.MediaContent`: No module named 'loopy'

## MediaType

> Could not import `loopy.MediaType`: No module named 'loopy'

## MetricsCollector

> Could not import `loopy.MetricsCollector`: No module named 'loopy'

## ModelProvider

> Could not import `loopy.ModelProvider`: No module named 'loopy'

## MultiModalBuilder

> Could not import `loopy.MultiModalBuilder`: No module named 'loopy'

## MultiModalMessage

> Could not import `loopy.MultiModalMessage`: No module named 'loopy'

## Node

> Could not import `loopy.Node`: No module named 'loopy'

## Orchestrator

> Could not import `loopy.Orchestrator`: No module named 'loopy'

## OutputFilter

> Could not import `loopy.OutputFilter`: No module named 'loopy'

## PatternCadence

> Could not import `loopy.PatternCadence`: No module named 'loopy'

## PatternRegistry

> Could not import `loopy.PatternRegistry`: No module named 'loopy'

## Pipeline

> Could not import `loopy.Pipeline`: No module named 'loopy'

## Plugin

> Could not import `loopy.Plugin`: No module named 'loopy'

## PluginInfo

> Could not import `loopy.PluginInfo`: No module named 'loopy'

## PluginLoader

> Could not import `loopy.PluginLoader`: No module named 'loopy'

## PluginRegistry

> Could not import `loopy.PluginRegistry`: No module named 'loopy'

## ProviderConfig

> Could not import `loopy.ProviderConfig`: No module named 'loopy'

## RateLimitMiddleware

> Could not import `loopy.RateLimitMiddleware`: No module named 'loopy'

## ReadinessLevel

> Could not import `loopy.ReadinessLevel`: No module named 'loopy'

## RealtimeEvent

> Could not import `loopy.RealtimeEvent`: No module named 'loopy'

## RealtimeEventType

> Could not import `loopy.RealtimeEventType`: No module named 'loopy'

## RealtimeSession

> Could not import `loopy.RealtimeSession`: No module named 'loopy'

## RealtimeTransport

> Could not import `loopy.RealtimeTransport`: No module named 'loopy'

## RedactionMatch

> Could not import `loopy.RedactionMatch`: No module named 'loopy'

## Redactor

> Could not import `loopy.Redactor`: No module named 'loopy'

## RetryMiddleware

> Could not import `loopy.RetryMiddleware`: No module named 'loopy'

## RiskLevel

> Could not import `loopy.RiskLevel`: No module named 'loopy'

## Router

> Could not import `loopy.Router`: No module named 'loopy'

## RunOutcome

> Could not import `loopy.RunOutcome`: No module named 'loopy'

## RunRecord

> Could not import `loopy.RunRecord`: No module named 'loopy'

## Skill

> Could not import `loopy.Skill`: No module named 'loopy'

## SkillRegistry

> Could not import `loopy.SkillRegistry`: No module named 'loopy'

## Span

> Could not import `loopy.Span`: No module named 'loopy'

## SpanStatus

> Could not import `loopy.SpanStatus`: No module named 'loopy'

## State

> Could not import `loopy.State`: No module named 'loopy'

## StateGraph

> Could not import `loopy.StateGraph`: No module named 'loopy'

## StateManager

> Could not import `loopy.StateManager`: No module named 'loopy'

## StepResult

> Could not import `loopy.StepResult`: No module named 'loopy'

## StepStatus

> Could not import `loopy.StepStatus`: No module named 'loopy'

## StreamBuffer

> Could not import `loopy.StreamBuffer`: No module named 'loopy'

## StreamChunk

> Could not import `loopy.StreamChunk`: No module named 'loopy'

## StreamEvent

> Could not import `loopy.StreamEvent`: No module named 'loopy'

## TEST_MODEL_SENTINEL

> Could not import `loopy.TEST_MODEL_SENTINEL`: No module named 'loopy'

## TaskDecomposer

> Could not import `loopy.TaskDecomposer`: No module named 'loopy'

## TestModel

> Could not import `loopy.TestModel`: No module named 'loopy'

## TimingMiddleware

> Could not import `loopy.TimingMiddleware`: No module named 'loopy'

## Tracer

> Could not import `loopy.Tracer`: No module named 'loopy'

## ValidationMiddleware

> Could not import `loopy.ValidationMiddleware`: No module named 'loopy'

## Verdict

> Could not import `loopy.Verdict`: No module named 'loopy'

## Verifier

> Could not import `loopy.Verifier`: No module named 'loopy'

## Workflow

> Could not import `loopy.Workflow`: No module named 'loopy'


# Module `loopy.loop`

## AgentLoop

> Could not import `loopy.loop.AgentLoop`: No module named 'loopy'

## LoopConfig

> Could not import `loopy.loop.LoopConfig`: No module named 'loopy'

## StepResult

> Could not import `loopy.loop.StepResult`: No module named 'loopy'

## StepStatus

> Could not import `loopy.loop.StepStatus`: No module named 'loopy'


# Module `loopy.flow`

## Node

> Could not import `loopy.flow.Node`: No module named 'loopy'

## Edge

> Could not import `loopy.flow.Edge`: No module named 'loopy'

## StateGraph

> Could not import `loopy.flow.StateGraph`: No module named 'loopy'

## Context

> Could not import `loopy.flow.Context`: No module named 'loopy'

## Workflow

> Could not import `loopy.flow.Workflow`: No module named 'loopy'

## State

> Could not import `loopy.flow.State`: No module named 'loopy'


# Module `loopy.gateway`

## Gateway

> Could not import `loopy.gateway.Gateway`: No module named 'loopy'

## GatewayResponse

> Could not import `loopy.gateway.GatewayResponse`: No module named 'loopy'

## ModelProvider

> Could not import `loopy.gateway.ModelProvider`: No module named 'loopy'

## ProviderConfig

> Could not import `loopy.gateway.ProviderConfig`: No module named 'loopy'

## ConnectionPool

> Could not import `loopy.gateway.ConnectionPool`: No module named 'loopy'

## TestModel

> Could not import `loopy.gateway.TestModel`: No module named 'loopy'

## TEST_MODEL_SENTINEL

> Could not import `loopy.gateway.TEST_MODEL_SENTINEL`: No module named 'loopy'


# Module `loopy.guardrails`

## GuardrailPipeline

> Could not import `loopy.guardrails.GuardrailPipeline`: No module named 'loopy'

## InputFilter

> Could not import `loopy.guardrails.InputFilter`: No module named 'loopy'

## OutputFilter

> Could not import `loopy.guardrails.OutputFilter`: No module named 'loopy'

## FilterAction

> Could not import `loopy.guardrails.FilterAction`: No module named 'loopy'


# Module `loopy.evals`

## EvalSuite

> Could not import `loopy.evals.EvalSuite`: No module named 'loopy'

## EvalCase

> Could not import `loopy.evals.EvalCase`: No module named 'loopy'

## EvalResult

> Could not import `loopy.evals.EvalResult`: No module named 'loopy'

## EvalReport

> Could not import `loopy.evals.EvalReport`: No module named 'loopy'

## Evaluator

> Could not import `loopy.evals.Evaluator`: No module named 'loopy'

## EvalGate

> Could not import `loopy.evals.EvalGate`: No module named 'loopy'

## EvalGateResult

> Could not import `loopy.evals.EvalGateResult`: No module named 'loopy'

## EvalGateType

> Could not import `loopy.evals.EvalGateType`: No module named 'loopy'

## JudgeConfig

> Could not import `loopy.evals.JudgeConfig`: No module named 'loopy'

## Verdict

> Could not import `loopy.evals.Verdict`: No module named 'loopy'


# Module `loopy.cache`

## LLMCache

> Could not import `loopy.cache.LLMCache`: No module named 'loopy'

## CacheStats

> Could not import `loopy.cache.CacheStats`: No module named 'loopy'


# Module `loopy.observe`

## Tracer

> Could not import `loopy.observe.Tracer`: No module named 'loopy'

## Span

> Could not import `loopy.observe.Span`: No module named 'loopy'

## SpanStatus

> Could not import `loopy.observe.SpanStatus`: No module named 'loopy'

## MetricsCollector

> Could not import `loopy.observe.MetricsCollector`: No module named 'loopy'

## Redactor

> Could not import `loopy.observe.Redactor`: No module named 'loopy'

## RedactionMatch

> Could not import `loopy.observe.RedactionMatch`: No module named 'loopy'


# Module `loopy.mcp`

## MCPClient

> Could not import `loopy.mcp.MCPClient`: No module named 'loopy'

## MCPToolResult

> Could not import `loopy.mcp.MCPToolResult`: No module named 'loopy'

## LocalMCP

> Could not import `loopy.mcp.LocalMCP`: No module named 'loopy'

## MCPTool

> Could not import `loopy.mcp.MCPTool`: No module named 'loopy'


# Module `loopy.agents`

## Orchestrator

> Could not import `loopy.agents.Orchestrator`: No module named 'loopy'

## Router

> Could not import `loopy.agents.Router`: No module named 'loopy'

## TaskDecomposer

> Could not import `loopy.agents.TaskDecomposer`: No module named 'loopy'


# Module `loopy.middleware`

## Pipeline

> Could not import `loopy.middleware.Pipeline`: No module named 'loopy'

## RetryMiddleware

> Could not import `loopy.middleware.RetryMiddleware`: No module named 'loopy'

## CircuitBreakerMiddleware

> Could not import `loopy.middleware.CircuitBreakerMiddleware`: No module named 'loopy'

## FallbackMiddleware

> Could not import `loopy.middleware.FallbackMiddleware`: No module named 'loopy'

## CacheMiddleware

> Could not import `loopy.middleware.CacheMiddleware`: No module named 'loopy'

## LoggingMiddleware

> Could not import `loopy.middleware.LoggingMiddleware`: No module named 'loopy'

## TimingMiddleware

> Could not import `loopy.middleware.TimingMiddleware`: No module named 'loopy'

## ValidationMiddleware

> Could not import `loopy.middleware.ValidationMiddleware`: No module named 'loopy'

## RateLimitMiddleware

> Could not import `loopy.middleware.RateLimitMiddleware`: No module named 'loopy'


# Module `loopy.plugins`

## Plugin

> Could not import `loopy.plugins.Plugin`: No module named 'loopy'

## PluginInfo

> Could not import `loopy.plugins.PluginInfo`: No module named 'loopy'

## PluginLoader

> Could not import `loopy.plugins.PluginLoader`: No module named 'loopy'

## PluginRegistry

> Could not import `loopy.plugins.PluginRegistry`: No module named 'loopy'


# Module `loopy.state`

## StateManager

> Could not import `loopy.state.StateManager`: No module named 'loopy'

## LoopState

> Could not import `loopy.state.LoopState`: No module named 'loopy'

## RunRecord

> Could not import `loopy.state.RunRecord`: No module named 'loopy'

## RunOutcome

> Could not import `loopy.state.RunOutcome`: No module named 'loopy'


# Module `loopy.safety`

## SafetyGate

> Could not import `loopy.safety.SafetyGate`: No module named 'loopy'

## SafetyCheck

> Could not import `loopy.safety.SafetyCheck`: No module named 'loopy'

## SafetyResult

> Could not import `loopy.safety.SafetyResult`: No module named 'loopy'

## EscalationReason

> Could not import `loopy.safety.EscalationReason`: No module named 'loopy'


# Module `loopy.cost`

## CostTracker

> Could not import `loopy.cost.CostTracker`: No module named 'loopy'

## CostReport

> Could not import `loopy.cost.CostReport`: No module named 'loopy'

## BudgetExceeded

> Could not import `loopy.cost.BudgetExceeded`: No module named 'loopy'


# Module `loopy.drift`

## DriftDetector

> Could not import `loopy.drift.DriftDetector`: No module named 'loopy'

## DriftIssue

> Could not import `loopy.drift.DriftIssue`: No module named 'loopy'

## DriftReport

> Could not import `loopy.drift.DriftReport`: No module named 'loopy'


# Module `loopy.skills`

## Skill

> Could not import `loopy.skills.Skill`: No module named 'loopy'

## SkillRegistry

> Could not import `loopy.skills.SkillRegistry`: No module named 'loopy'


# Module `loopy.verification`

## Verifier

> Could not import `loopy.verification.Verifier`: No module named 'loopy'

## AssertionResult

> Could not import `loopy.verification.AssertionResult`: No module named 'loopy'


# Module `loopy.audit`

## AuditReport

> Could not import `loopy.audit.AuditReport`: No module named 'loopy'

## CheckItem

> Could not import `loopy.audit.CheckItem`: No module named 'loopy'

## ReadinessLevel

> Could not import `loopy.audit.ReadinessLevel`: No module named 'loopy'


# Module `loopy.streaming`

## StreamBuffer

> Could not import `loopy.streaming.StreamBuffer`: No module named 'loopy'

## StreamEvent

> Could not import `loopy.streaming.StreamEvent`: No module named 'loopy'

## StreamChunk

> Could not import `loopy.streaming.StreamChunk`: No module named 'loopy'


# Module `loopy.multimodal`

## MultiModalMessage

> Could not import `loopy.multimodal.MultiModalMessage`: No module named 'loopy'

## MultiModalBuilder

> Could not import `loopy.multimodal.MultiModalBuilder`: No module named 'loopy'

## MediaContent

> Could not import `loopy.multimodal.MediaContent`: No module named 'loopy'

## MediaType

> Could not import `loopy.multimodal.MediaType`: No module named 'loopy'

## ImageFormat

> Could not import `loopy.multimodal.ImageFormat`: No module named 'loopy'

## RealtimeSession

> Could not import `loopy.multimodal.RealtimeSession`: No module named 'loopy'

## RealtimeEvent

> Could not import `loopy.multimodal.RealtimeEvent`: No module named 'loopy'

## RealtimeEventType

> Could not import `loopy.multimodal.RealtimeEventType`: No module named 'loopy'

## RealtimeTransport

> Could not import `loopy.multimodal.RealtimeTransport`: No module named 'loopy'


# Module `loopy.compliance`

## ComplianceChecker

> Could not import `loopy.compliance.ComplianceChecker`: No module named 'loopy'

## AuditLogger

> Could not import `loopy.compliance.AuditLogger`: No module named 'loopy'


# Module `loopy.explainability`

## DecisionTracker

> Could not import `loopy.explainability.DecisionTracker`: No module named 'loopy'

## DecisionTrace

> Could not import `loopy.explainability.DecisionTrace`: No module named 'loopy'

## DecisionStep

> Could not import `loopy.explainability.DecisionStep`: No module named 'loopy'

## DecisionType

> Could not import `loopy.explainability.DecisionType`: No module named 'loopy'


# Module `loopy.patterns`

## PatternRegistry

> Could not import `loopy.patterns.PatternRegistry`: No module named 'loopy'

## LoopPattern

> Could not import `loopy.patterns.LoopPattern`: No module named 'loopy'

## PatternCadence

> Could not import `loopy.patterns.PatternCadence`: No module named 'loopy'

## RiskLevel

> Could not import `loopy.patterns.RiskLevel`: No module named 'loopy'
