# sagents

> Build interactive AI agents in Elixir with OTP supervision, middleware composition, human-in-the-loop approvals, sub-agent delegation, and real-time Phoenix LiveView integration. Built on LangChain.

- **URL**: https://www.freshcrate.ai/projects/sagents
- **Author**: sagents-ai
- **Category**: AI Agents
- **Latest version**: `v0.8.0-rc.10` (2026-06-01)
- **License**: NOASSERTION
- **Source**: https://github.com/sagents-ai/sagents
- **Language**: Elixir
- **GitHub**: 214 stars, 21 forks
- **Registry**: github (`sagents-ai/sagents`)
- **Tags**: `agent`, `agentic`, `ai`, `elixir`, `hitl`, `human-in-the-loop`, `llm`, `middleware`

## Description

Build interactive AI agents in Elixir with OTP supervision, middleware composition, human-in-the-loop approvals, sub-agent delegation, and real-time Phoenix LiveView integration. Built on LangChain.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.8.0-rc.10` | 2026-06-01 | High | ## What's Changed * Fix ExDoc warnings for unqualified function references by @brainlid in https://github.com/sagents-ai/sagents/pull/118 * Clear stale interrupt state on every non-interrupted status transition by @brainlid in https://github.com/sagents-ai/sagents/pull/119 * prep for v0.8.0-rc.10 by @brainlid in https://github.com/sagents-ai/sagents/pull/120   **Full Changelog**: https://github.com/sagents-ai/sagents/compare/v0.8.0-rc.9...v0.8.0-rc.10 |
| `v0.8.0-rc.9` | 2026-05-28 | High | ## What's Changed * Add :halt interrupt type for terminal tool-driven workflow stops by @brainlid in https://github.com/sagents-ai/sagents/pull/115 * Make Todo IDs integers to fix lexicographic sort order by @brainlid in https://github.com/sagents-ai/sagents/pull/116 * Increment version and update changelog by @brainlid in https://github.com/sagents-ai/sagents/pull/117   **Full Changelog**: https://github.com/sagents-ai/sagents/compare/v0.8.0-rc.8...v0.8.0-rc.9 |
| `v0.8.0-rc.8` | 2026-05-22 | High | ## What's Changed * Handle :interrupted tool-execution status in StreamingSession by @brainlid in https://github.com/sagents-ai/sagents/pull/112 * Log middleware initialization failures at error level by @brainlid in https://github.com/sagents-ai/sagents/pull/113 * Prep for 0.8.0-rc.8 by @brainlid in https://github.com/sagents-ai/sagents/pull/114   **Full Changelog**: https://github.com/sagents-ai/sagents/compare/v0.8.0-rc.7...v0.8.0-rc.8 |
| `v0.8.0-rc.7` | 2026-05-17 | High | ## What's Changed * update deps by @brainlid in https://github.com/sagents-ai/sagents/pull/106 * Add Sagents.AgentResult helper for structured extraction by @brainlid in https://github.com/sagents-ai/sagents/pull/107 * Add FileSystemServer.get_state/1 and fix CI-flaky subscriber test by @brainlid in https://github.com/sagents-ai/sagents/pull/109 * Add Sagents.Extract for agent-layer structured extraction by @brainlid in https://github.com/sagents-ai/sagents/pull/108 * Remove replace_file_li |
| `v0.8.0-rc.6` | 2026-05-13 | High | ## What's Changed * Support per-call `:initial_messages` on SubAgent invocations by @brainlid in https://github.com/sagents-ai/sagents/pull/100 * Add inline display mode for TodoList middleware by @brainlid in https://github.com/sagents-ai/sagents/pull/101 * Add todo_snapshot content type to display_message template by @brainlid in https://github.com/sagents-ai/sagents/pull/102 * Race-condition guards + shared streaming-session helpers by @brainlid in https://github.com/sagents-ai/sagents/pu |
| `v0.8.0-rc.5` | 2026-05-07 | High | ## What's Changed * Replace the code and moduledoc examples in sagents.ex by @brainlid in https://github.com/sagents-ai/sagents/pull/92 * Add Credo static analysis to CI and precommit by @brainlid in https://github.com/sagents-ai/sagents/pull/93 * Consolidate AgentServer subscribe API into subscribe/3 + unsubscribe/3 by @brainlid in https://github.com/sagents-ai/sagents/pull/94 * Minor docs cleanup around AgentServer.subscribe(agent_id, :debug) by @brainlid in https://github.com/sagents-ai/s |
| `v0.8.0-rc.4` | 2026-05-05 | High | ## What's Changed * Expose agent_id as a top-level tool context key by @brainlid in https://github.com/sagents-ai/sagents/pull/86 * Expose middleware-injected messages to debug subscribers mid-turn by @brainlid in https://github.com/sagents-ai/sagents/pull/87 * Add synthetic display message hook for middleware by @brainlid in https://github.com/sagents-ai/sagents/pull/88 * Recover from stale interrupted state on agent restart by @brainlid in https://github.com/sagents-ai/sagents/pull/89 * B |
| `v0.8.0-rc.1` | 2026-04-29 | High | ## What's Changed * Fixed doc warning by @brainlid in https://github.com/sagents-ai/sagents/pull/75 * Friendlier message for delta_conversion_failed errors by @brainlid in https://github.com/sagents-ai/sagents/pull/77 * Replace Phoenix.PubSub with direct subscriptions for agent events by @brainlid in https://github.com/sagents-ai/sagents/pull/79 * Add optional debug_summary/1 callback to middleware behaviour by @brainlid in https://github.com/sagents-ai/sagents/pull/80 * Rename SubAgent mid |
| `v0.7.0` | 2026-04-22 | High | ## What's Changed * Make SubAgent.task_subagent_boilerplate public by @brainlid in https://github.com/sagents-ai/sagents/pull/66 * Fix generated load_display_messages truncating long conversations by @brainlid in https://github.com/sagents-ai/sagents/pull/68 * Use state returned from middleware on_server_start by @arjan in https://github.com/sagents-ai/sagents/pull/67 * Add configurable max_runs to Agent and SubAgent by @brainlid in https://github.com/sagents-ai/sagents/pull/69 * Fix filesy |
| `v0.6.0` | 2026-04-16 | High | ## What's Changed * Add configurable display_text for TodoList middleware by @brainlid in https://github.com/sagents-ai/sagents/pull/52 * Add enabled flag to DebugLog middleware for production safety by @brainlid in https://github.com/sagents-ai/sagents/pull/53 * Add FileSchema behaviour and rename filesystem tools by @brainlid in https://github.com/sagents-ai/sagents/pull/54 * Document FileSchema and updated tool names in filesystem setup guide by @brainlid in https://github.com/sagents-ai/ |

## Citation

- HTML: https://www.freshcrate.ai/projects/sagents
- Markdown: https://www.freshcrate.ai/projects/sagents.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/sagents/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._