AgentSessionManager.Config (AgentSessionManager v0.8.0)

Centralized configuration with process-local overrides.

Every operational default in AgentSessionManager — timeouts, buffer sizes, concurrency limits, query limits, and more — is defined here as a single source of truth. Individual modules reference get/1 instead of scattering @default_* module attributes.

Resolution Order

When you call get/1, the value is resolved as follows:

Process-local override — set via put/2, scoped to the calling process. Automatically cleaned up when the process exits.
Application environment — set via config :agent_session_manager, key: value or Application.put_env/3.
Built-in default — hardcoded fallback per key.

This layering follows the same pattern as Elixir's Logger module for per-process log levels. It enables fully concurrent (async: true) testing because each test process can override configuration without affecting any other process.

Application Config Example

# config/config.exs
config :agent_session_manager,
  command_timeout_ms: 60_000,
  max_parallel_sessions: 200

See the Configuration Reference guide for the full list of keys, types, and defaults.

Supported Keys

Feature Flags

Key	Type	Default	Used By
`:telemetry_enabled`	`boolean`	`true`	`Telemetry`
`:audit_logging_enabled`	`boolean`	`true`	`AuditLogger`
`:redaction_enabled`	`boolean`	`false`	`EventBuilder`

Redaction

Key	Type	Default	Used By

`:redaction_patterns`	`:default	list`	`:default`	`EventBuilder`
`:redaction_replacement`	`String.t()	:categorized`	`"[REDACTED]"`	`EventBuilder`

`:redaction_deep_scan`	`boolean`	`true`	`EventBuilder`
`:redaction_scan_metadata`	`boolean`	`false`	`EventBuilder`

Timeouts (milliseconds)

Key	Default	Used By
`:stream_idle_timeout_ms`	`120_000`	`StreamSession`
`:task_shutdown_timeout_ms`	`5_000`	`StreamSession`
`:await_run_timeout_ms`	`60_000`	`SessionServer`
`:drain_timeout_buffer_ms`	`1_000`	`SessionServer.drain/2`
`:command_timeout_ms`	`30_000`	`Exec`, `ShellAdapter`
`:execute_timeout_ms`	`60_000`	`ProviderAdapter`
`:execute_grace_timeout_ms`	`5_000`	`ProviderAdapter`
`:circuit_breaker_cooldown_ms`	`30_000`	`CircuitBreaker`, `Router`
`:sticky_session_ttl_ms`	`300_000`	`ProviderRouter`
`:event_stream_poll_interval_ms`	`250`	`SessionManager`
`:genserver_call_timeout_ms`	`5_000`	`ProviderAdapter`, `SessionStore`

Buffer & Memory Limits

Key	Default	Used By
`:event_buffer_size`	`1_000`	`EventStream`
`:max_output_bytes`	`1_048_576`	`Exec`, `ShellAdapter`
`:max_patch_bytes`	`1_048_576`	`GitBackend`

Concurrency

Key	Default	Used By
`:max_parallel_sessions`	`100`	`ConcurrencyLimiter`
`:max_parallel_runs`	`50`	`ConcurrencyLimiter`
`:max_queued_runs`	`100`	`SessionServer`, `RunQueue`

Circuit Breaker

Key	Default	Used By
`:circuit_breaker_failure_threshold`	`5`	`CircuitBreaker`
`:circuit_breaker_half_open_max_probes`	`1`	`CircuitBreaker`

SQLite

Key	Default	Used By
`:sqlite_max_bind_params`	`32_766`	`EctoSessionStore`
`:sqlite_busy_retry_attempts`	`25`	`EctoSessionStore`
`:sqlite_busy_retry_sleep_ms`	`10`	`EctoSessionStore`

Query Limits

Key	Default	Used By
`:max_query_limit`	`1_000`	`EctoQueryAPI`
`:default_session_query_limit`	`50`	`EctoQueryAPI`, `AshQueryAPI`
`:default_run_query_limit`	`50`	`EctoQueryAPI`, `AshQueryAPI`
`:default_event_query_limit`	`100`	`EctoQueryAPI`, `AshQueryAPI`, `SessionManager`

Retention

Key	Default
`:retention_max_completed_age_days`	`90`
`:retention_hard_delete_after_days`	`30`
`:retention_batch_size`	`100`
`:retention_exempt_statuses`	`[:active, :paused]`
`:retention_exempt_tags`	`["pinned"]`
`:retention_prune_event_types_first`	`[:message_streamed, :token_usage_updated]`

Cost

Key	Default	Used By
`:chars_per_token`	`4`	`TranscriptBuilder`

Shell Adapter

Key	Default	Used By
`:default_shell`	`"/bin/sh"`	`ShellAdapter`
`:default_success_exit_codes`	`[0]`	`ShellAdapter`

Workspace

Key	Default	Used By
`:excluded_workspace_roots`	`[".git", "deps", "_build", "node_modules"]`	`HashBackend`

Routing

Key	Default	Used By
`:default_router_name`	`"router"`	`ProviderRouter`

Summary

Types

key()

Configuration keys supported by this module.

Functions

default(atom)

Returns the built-in default for key, ignoring process-local and application environment overrides.

delete(key)

Removes the process-local override for key.

get(key)

Returns the resolved value for key.

put(key, value)

Sets a process-local override for key.

valid_keys()

Returns the list of valid configuration keys.