> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# middleware • AI Agent SDK
> Middleware System for PraisonAI Agents.
# middleware
AI Agent
Middleware System for PraisonAI Agents.
Provides wrap\_model\_call and wrap\_tool\_call patterns for intercepting
and modifying agent behavior at model/tool call boundaries.
Zero Performance Impact:
* All middleware is optional
* Empty middleware chain is O(1) fast path
* No overhead when middleware not registered
Usage:
from praisonaiagents.hooks import before\_model, wrap\_model\_call, wrap\_tool\_call
@before\_model
def add\_context(request):
request.messages.append(\{"role": "system", "content": "Extra"})
return request
@wrap\_model\_call
def retry\_on\_error(request, call\_next):
for \_ in range(3):
try:
return call\_next(request)
except Exception:
pass
raise RuntimeError("All retries failed")
agent = Agent(name="Test", hooks=\[add\_context, retry\_on\_error])
## Import
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents.hooks import middleware
```
## Classes
Context passed through middleware chain.
Request data for model calls.
Response data from model calls.
Request data for tool calls.
Response data from tool calls.
Synchronous middleware chain executor.
Asynchronous middleware chain executor.
Manages middleware for an agent.
## Functions
Decorator to mark a function as a before\_model hook.
Decorator to mark a function as an after\_model hook.
Decorator to mark a function as a wrap\_model\_call middleware.
Decorator to mark a function as a before\_tool hook.
Decorator to mark a function as an after\_tool hook.
Decorator to mark a function as a wrap\_tool\_call middleware.
Get the hook type of a decorated function.
Check if a function is a middleware (wrap\_\* type).
Categorize hooks by their type.
### Constants
| Name | Value |
| ---- | -------------- |
| `T` | `TypeVar('T')` |
***
## Related Documentation