---
title: "Agents reference"
description: "This reference covers the Dex Agents packages in production: install, sizing,"
canonical_url: "https://docs.superdurable.io/reference/agents/"
source: "docs/reference/agents/index.mdx"
locale: "en"
---

# Agents reference

This reference covers the Dex Agents packages in production: install, sizing,
limits, timeouts, approvals, Connector tools, upgrades, credentials, and Dex
Web. [Agent Frameworks](https://docs.superdurable.io/agent-frameworks.md) explains how an agent session works
and the rules for tool calls. Server limits on these pages are server-zd
defaults. See the [Server reference](https://docs.superdurable.io/reference/server.md) and
[Application](https://docs.superdurable.io/components/application.md) for the rest of the setup.

## Pages

- [Install the packages](https://docs.superdurable.io/reference/agents/install.md): the Python and TypeScript
  packages, their runtimes, and how they are versioned.
- [AgentEvents Stream](https://docs.superdurable.io/reference/agents/event-stream.md): the Stream backend and
  how to size the live event Stream.
- [Workers and timeouts](https://docs.superdurable.io/reference/agents/workers.md): Worker task slots, Step
  timeouts, long model calls, separate Worker pools, and graceful stop.
- [Limits for long sessions](https://docs.superdurable.io/reference/agents/session-limits.md): the server
  limits a session grows into, what happens at the limit, and compaction.
- [Approvals and waiting sessions](https://docs.superdurable.io/reference/agents/approvals.md): approval
  deadlines, RPC locks, and how to find sessions that wait for a person.
- [Connector tools](https://docs.superdurable.io/reference/agents/connector-tools.md): packages, tool names,
  result size, and Connector connections.
- [Crashes and tool call outcomes](https://docs.superdurable.io/reference/agents/failures.md): what each
  failure repeats, its tests, and how a tool Step's failure picks the call's
  record.
- [Spend limits](https://docs.superdurable.io/reference/agents/spend-limits.md): the **ModelSpendLimit**
  interface and its limits.
- [Upgrades](https://docs.superdurable.io/reference/agents/upgrades.md): deploy agent code while sessions
  wait, and roll out session settings.
- [Credentials](https://docs.superdurable.io/reference/agents/credentials.md): where model keys and tool
  credentials live.
- [Dex Web](https://docs.superdurable.io/reference/agents/dex-web.md): render the session graph and show
  sessions in Dex Web.
- [Change log](https://docs.superdurable.io/reference/agents/changelog.md): user-visible changes in each
  release.

## Release notes

The agents packages are released together as **agents/vX.Y.Z**, on their own
version line. See the
[agents releases](https://github.com/superdurable/dex/releases?q=agents%2Fv\&expanded=true)
on GitHub and the [change log](https://docs.superdurable.io/reference/agents/changelog.md).