API Reference Sagents v#0.8.0-rc.4

Sagents provides hierarchical agent capabilities with composable middleware.

Main entry point for creating Agents.

Behaviour for persisting agent state snapshots.

GenServer that wraps a DeepAgent and its State, managing execution lifecycle and broadcasting events via PubSub.

Custom supervisor for managing an Agent and its supporting infrastructure.

Shared utilities for Agent and SubAgent HITL (Human-in-the-Loop) support.

Dynamic supervisor for managing AgentSupervisor instances.

Behaviour for persisting display messages (user-facing message representations).

Public API for filesystem lifecycle management.

Represents a file in the virtual filesystem.

Metadata for a file entry in the virtual filesystem.

Configuration for a filesystem persistence backend.

State management for the FileSystem.

Dynamic supervisor for managing FileSystemServer instances.

Behaviour for persisting files to storage.

Default disk-based persistence implementation.

Behavior for file system persistence callbacks.

GenServer managing virtual filesystem with debounce-based auto-persistence.

Module-based Horde.DynamicSupervisor for agent processes.

Configuration helpers for Horde clustering.

Module-based Horde.DynamicSupervisor for filesystem processes.

Module-based Horde.Registry for dynamic configuration.

Utilities for extracting displayable content from LangChain Messages.

Behaviour for transforming user-submitted messages into separate display and LLM representations.

Behavior for DeepAgent middleware components.

Middleware that gives agents a structured way to ask the user questions.

Middleware that automatically generates conversation titles based on the initial user message.

Middleware that writes detailed, structured logs to per-conversation log files.

Middleware that adds virtual filesystem capabilities to agents.

Middleware that enables human oversight and intervention in agent workflows.

Middleware that identifies and resolves "dangling tool calls" in the message history.

Propagates caller-process state across the three Sagents process boundaries.

Middleware for delegating tasks to specialized SubAgents.

Middleware that automatically manages conversation length through intelligent summarization.

Middleware that adds TODO list management capabilities to agents.

Represents a registered middleware instance with its configuration.

Sagents-specific pipeline steps for custom execution modes.

Standard sagents execution mode.

Optional behavior for hooking into agent state persistence events.

Handles serialization and deserialization of AgentServer state.

Convenience wrappers for Phoenix.Presence operations.

Abstraction over process registry implementations.

Abstraction over dynamic supervisor implementations.

Direct, monitored process subscriptions for GenServers that publish events.

Subscriber bookkeeping for a Sagents.Publisher producer.

Agent state structure for managing agent execution context.

A runnable, pausable, and resumable agent execution context.

Pre-compiled SubAgent with an existing Agent instance.

Configuration for dynamically-created SubAgents.

Behaviour for task modules that describe a named sub-agent "skill".

GenServer wrapper for SubAgent providing blocking API.

DynamicSupervisor for managing ephemeral sub-agent processes.

Consumer-side helpers for Sagents.Publisher producers.

Top-level supervisor for Sagents infrastructure.

Pure helper for line-number math on text content.

TODO item structure for task tracking.

Generates AgentLiveHelpers module for Phoenix LiveView integration with Sagents.

Generates all infrastructure needed for conversation-centric agents.