# AgentDeck SDK

> The production runtime for agents you already have  -  composition, durable human-in-the-loop approvals, sessions, streaming, run control and one ordered event log, wrapping the OpenAI Agents SDK and LangGraph.

AgentDeck SDK is a Python harness for agents you have to operate. You write agents, workflows and
skills as small declarations in a `.agentdeck/` directory; AgentDeck supplies everything around
them  -  discovery, layered settings, sessions, streaming, MCP servers, durable human-in-the-loop
approvals, run control, and one ordered event log per run.

It wraps the OpenAI Agents SDK and LangGraph rather than replacing them: an `Agent` compiles to an
SDK agent, a `Workflow` compiles to a LangGraph graph, and each is executed by its own engine.
AgentDeck owns configuration; the engines own execution. There is no agent loop here and no graph
engine of its own.

Use it when the wiring around an agent has become the work: several agents and workflows in one
project, a chat surface and a batch path over the same definitions, runs you must inspect
afterwards, approvals that outlive the process that requested them.

## Documentation

- [Agentic software should feel like software](https://agentdecksdk.com/): Build agents, tools and workflows as normal software. AgentDeck gives them one execution model you can observe, control and extend.
- [CLI](https://agentdecksdk.com/reference/cli): The agentdeck command tree, generated from agentdeck/cli.py's own --help output.
- [Deck](https://agentdecksdk.com/reference/deck): The composition root  -  builds a catalog from Agent/Workflow objects or a project directory, and runs every turn on it.
- [events](https://agentdecksdk.com/reference/events)
- [python-api](https://agentdecksdk.com/reference/python-api)
- [run](https://agentdecksdk.com/reference/run)
- [Settings](https://agentdecksdk.com/reference/settings): Every AGENTDECK_* (and OPENAI_*/TAVILY_*) environment variable, generated from agentdeck/runtime/settings.py.
- [Agents](https://agentdecksdk.com/build-your-deck/agents): Declarative agents with tools, instructions, and model configurations.
- [context](https://agentdecksdk.com/build-your-deck/context)
- [deck](https://agentdecksdk.com/build-your-deck/deck)
- [skills](https://agentdecksdk.com/build-your-deck/skills)
- [tools](https://agentdecksdk.com/build-your-deck/tools)
- [workflows](https://agentdecksdk.com/build-your-deck/workflows)
- [index](https://agentdecksdk.com/examples)
- [existing-agents](https://agentdecksdk.com/integrations/existing-agents)
- [langgraph](https://agentdecksdk.com/integrations/langgraph)
- [mcp](https://agentdecksdk.com/integrations/mcp)
- [openai-agents-sdk](https://agentdecksdk.com/integrations/openai-agents-sdk)
- [How Jack is built](https://agentdecksdk.com/jack): What building a real application with AgentDeck looks like, and what AgentDeck provides around your application code.
- [Implementation notes](https://agentdecksdk.com/jack/notes): The decisions behind Jack, and the alternatives each one beat.
- [mental-model](https://agentdecksdk.com/meet-agentdeck/mental-model)
- [Overview](https://agentdecksdk.com/meet-agentdeck/overview): What AgentDeck is, why it exists, and how it works.
- [Quickstart](https://agentdecksdk.com/meet-agentdeck/quickstart): Build a Deck, start a Run, and watch its events.
- [Changelog](https://agentdecksdk.com/resources/changelog): What changed in each release of AgentDeck, and what to do about it when upgrading.
- [Known Issues](https://agentdecksdk.com/resources/known-issues): Defects in the current release that will surprise you, what happens, and what to do until each is fixed.
- [migration-guides](https://agentdecksdk.com/resources/migration-guides)
- [troubleshooting](https://agentdecksdk.com/resources/troubleshooting)
- [events](https://agentdecksdk.com/runs-and-control/events)
- [human-input](https://agentdecksdk.com/runs-and-control/human-input)
- [lifecycle-and-control](https://agentdecksdk.com/runs-and-control/lifecycle-and-control)
- [pause-resume](https://agentdecksdk.com/runs-and-control/pause-resume)
- [runs](https://agentdecksdk.com/runs-and-control/runs)
- [sessions](https://agentdecksdk.com/runs-and-control/sessions)

## Source

- [Repository](https://github.com/agentdecksdk/agentdeck): issues, releases and examples
- [Full documentation as one file](https://agentdecksdk.com/llms-full.txt)
