# AgentSessionManager v0.4.1 - Table of Contents

A comprehensive Elixir library for managing AI agent sessions, state persistence,
conversation context, and multi-agent orchestration workflows.

## Pages

- Introduction
  - [README](readme.md)
  - [Getting Started](getting_started.md)
  - [Live Examples](live_examples.md)
  - [Architecture](architecture.md)
  - [Configuration](configuration.md)

- Core Concepts
  - [Sessions and Runs](sessions_and_runs.md)
  - [Events and Streaming](events_and_streaming.md)
  - [Capabilities](capabilities.md)

- Integration
  - [Provider Adapters](provider_adapters.md)
  - [Concurrency](concurrency.md)
  - [Telemetry and Observability](telemetry_and_observability.md)

- Reference
  - [Error Handling](error_handling.md)
  - [Testing](testing.md)
  - [Changelog](changelog.md)
  - [LICENSE](license.md)

## Modules

- Core Domain
  - [AgentSessionManager](AgentSessionManager.md): A comprehensive Elixir library for managing AI agent sessions, state persistence,
conversation context, and multi-agent orchestration workflows.
  - [AgentSessionManager.Core.Capability](AgentSessionManager.Core.Capability.md): Represents a capability that can be assigned to an agent.
  - [AgentSessionManager.Core.Error](AgentSessionManager.Core.Error.md): Normalized error taxonomy for Agent Session Manager.
  - [AgentSessionManager.Core.Event](AgentSessionManager.Core.Event.md): Represents an event in the agent session lifecycle.
  - [AgentSessionManager.Core.Manifest](AgentSessionManager.Core.Manifest.md): Represents an agent manifest that defines the agent's configuration and capabilities.
  - [AgentSessionManager.Core.NormalizedEvent](AgentSessionManager.Core.NormalizedEvent.md): Represents a normalized event in the event stream.
  - [AgentSessionManager.Core.Run](AgentSessionManager.Core.Run.md): Represents a single execution run within a session.
  - [AgentSessionManager.Core.Session](AgentSessionManager.Core.Session.md): Represents an AI agent session.

- Event Pipeline
  - [AgentSessionManager.Core.EventNormalizer](AgentSessionManager.Core.EventNormalizer.md): Event normalization pipeline for transforming provider events into normalized events.
  - [AgentSessionManager.Core.EventStream](AgentSessionManager.Core.EventStream.md): Manages incremental consumption of normalized event streams.

- Capability System
  - [AgentSessionManager.Core.CapabilityResolver](AgentSessionManager.Core.CapabilityResolver.md): Negotiates capabilities between required/optional sets and available provider capabilities.
  - [AgentSessionManager.Core.CapabilityResolver.NegotiationResult](AgentSessionManager.Core.CapabilityResolver.NegotiationResult.md): Represents the result of a capability negotiation.
  - [AgentSessionManager.Core.Registry](AgentSessionManager.Core.Registry.md): A thread-safe registry for storing and retrieving provider manifests.

- Orchestration
  - [AgentSessionManager.SessionManager](AgentSessionManager.SessionManager.md): Orchestrates session lifecycle, run execution, and event handling.

- Ports (Interfaces)
  - [AgentSessionManager.Ports.ProviderAdapter](AgentSessionManager.Ports.ProviderAdapter.md): Port (interface) for AI provider adapters.
  - [AgentSessionManager.Ports.SessionStore](AgentSessionManager.Ports.SessionStore.md): Port (interface) for session storage operations.

- Adapters (Implementations)
  - [AgentSessionManager.Adapters.ClaudeAdapter](AgentSessionManager.Adapters.ClaudeAdapter.md): Provider adapter for Claude (Anthropic) AI models.
  - [AgentSessionManager.Adapters.CodexAdapter](AgentSessionManager.Adapters.CodexAdapter.md): Provider adapter for Codex (Claude Code CLI) integration.
  - [AgentSessionManager.Adapters.InMemorySessionStore](AgentSessionManager.Adapters.InMemorySessionStore.md): In-memory implementation of the SessionStore behaviour.

- Concurrency
  - [AgentSessionManager.Concurrency.ConcurrencyLimiter](AgentSessionManager.Concurrency.ConcurrencyLimiter.md): Enforces concurrency limits for sessions and runs.
  - [AgentSessionManager.Concurrency.ControlOperations](AgentSessionManager.Concurrency.ControlOperations.md): Manages control operations (interrupt, cancel, pause, resume) for runs.

- Observability
  - [AgentSessionManager.AuditLogger](AgentSessionManager.AuditLogger.md): Audit log persistence for observability and compliance.
  - [AgentSessionManager.Config](AgentSessionManager.Config.md): Centralized configuration with process-local overrides.
  - [AgentSessionManager.Telemetry](AgentSessionManager.Telemetry.md): Telemetry event emission for observability.