> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# RunContext

> Per-run state passed to hooks and tools: IDs, session state, dependencies, and resolved tools.

The `RunContext` is an object that can be referenced in pre- and post-hooks, tools, and other parts of the run.

See [Agent State](https://agno-v2.mintlify.site/state/agent/overview.md) for examples of how to use the `RunContext` in your code.

## RunContext Attributes

| Attribute | Type | Description |
| - | - | - |
| `run_id` | `str` | Run ID |
| `session_id` | `str` | Session ID for the run |
| `user_id` | `Optional[str]` | User ID associated with the run |
| `workflow_id` | `Optional[str]` | ID of the workflow this run belongs to, when executed inside a workflow |
| `workflow_name` | `Optional[str]` | Name of the workflow this run belongs to, when executed inside a workflow |
| `dependencies` | `Optional[Dict[str, Any]]` | Dependencies for the run |
| `knowledge_filters` | `Optional[Union[Dict[str, Any], List[FilterExpr]]]` | Knowledge filters for the run |
| `metadata` | `Optional[Dict[str, Any]]` | Metadata associated with the run |
| `session_state` | `Optional[Dict[str, Any]]` | Session state for the run |
| `output_schema` | `Optional[Union[Type[BaseModel], Dict[str, Any]]]` | Output schema for the run, as a Pydantic model or JSON schema dict |
| `messages` | `Optional[List[Message]]` | Live reference to the current run's message list. Hooks receive a shallow copy; individual `Message` objects are shared references |
| `tools` | `Optional[List[Any]]` | Tools resolved for the run, including results of callable tool factories |
| `knowledge` | `Optional[Any]` | Knowledge instance resolved for the run |
| `members` | `Optional[List[Any]]` | Team members resolved for the run |
| `client_tools` | `Optional[List[Any]]` | Per-run additive tools from the client (e.g. AG-UI frontend tools). Merged after `agent.tools` during tool resolution |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.