# Jido Messaging v1.0.0 - Table of Contents

> Messaging and notification system for the Jido ecosystem

## Pages

- [Jido Messaging](readme.md)
- [Changelog](changelog.md)
- [Contributing to Jido Messaging](contributing.md)

## Modules

- [Jido.Messaging](Jido.Messaging.md): Messaging and notification system for the Jido ecosystem.
- [Jido.Messaging.AdapterBridge](Jido.Messaging.AdapterBridge.md): Runtime bridge between `Jido.Messaging` and `Jido.Chat.Adapter`.
- [Jido.Messaging.Adapters.Heartbeat](Jido.Messaging.Adapters.Heartbeat.md): Behaviour for channel-specific health checking.
- [Jido.Messaging.AgentRunner](Jido.Messaging.AgentRunner.md): GenServer that manages an agent's participation in a specific room thread.
- [Jido.Messaging.AgentSupervisor](Jido.Messaging.AgentSupervisor.md): DynamicSupervisor for spawning and managing AgentRunner processes.
- [Jido.Messaging.AuditLogger](Jido.Messaging.AuditLogger.md): Telemetry-based audit logging for Jido.Messaging events.
- [Jido.Messaging.BridgeConfig](Jido.Messaging.BridgeConfig.md): Runtime-editable bridge configuration for adapter-backed ingress/egress.
- [Jido.Messaging.BridgePlugin](Jido.Messaging.BridgePlugin.md): Adapter bridge metadata struct.
- [Jido.Messaging.BridgeRegistry](Jido.Messaging.BridgeRegistry.md): Channel bridge discovery and lookup.
- [Jido.Messaging.BridgeRoomSpec](Jido.Messaging.BridgeRoomSpec.md): Declarative spec for creating a bridge-backed room topology.
- [Jido.Messaging.BridgeServer](Jido.Messaging.BridgeServer.md): Runtime bridge process for a single configured bridge.
- [Jido.Messaging.BridgeStatus](Jido.Messaging.BridgeStatus.md): Runtime bridge health/status snapshot.

- [Jido.Messaging.BridgeSupervisor](Jido.Messaging.BridgeSupervisor.md): Dynamic supervisor for bridge runtime workers.
- [Jido.Messaging.ConfigStore](Jido.Messaging.ConfigStore.md): Runtime-editable bridge and routing control plane.
- [Jido.Messaging.Context](Jido.Messaging.Context.md): Canonical runtime delivery context for `Jido.Messaging`.

- [Jido.Messaging.DeadLetter](Jido.Messaging.DeadLetter.md): Dead-letter storage and replay control plane for terminal outbound failures.
- [Jido.Messaging.DeadLetter.ReplaySupervisor](Jido.Messaging.DeadLetter.ReplaySupervisor.md): Supervisor for partitioned dead-letter replay workers.

- [Jido.Messaging.Deduper](Jido.Messaging.Deduper.md): Central message deduplication using ETS with TTL.
- [Jido.Messaging.Deliver](Jido.Messaging.Deliver.md): Outbound message delivery pipeline through `Jido.Messaging.OutboundGateway`.
- [Jido.Messaging.DeliveryPolicy](Jido.Messaging.DeliveryPolicy.md): Per-bridge outbound retry/backoff policy.

- [Jido.Messaging.Demo.Bridge](Jido.Messaging.Demo.Bridge.md): Bridges messages between Telegram and Discord via Signal Bus subscription.
- [Jido.Messaging.Demo.ChatAgent](Jido.Messaging.Demo.ChatAgent.md): A ReAct-based chat agent that participates in bridged conversations.
- [Jido.Messaging.Demo.ChatAgent.Actions.Echo](Jido.Messaging.Demo.ChatAgent.Actions.Echo.md): Echo back the input text
- [Jido.Messaging.Demo.ChatAgent.Actions.Help](Jido.Messaging.Demo.ChatAgent.Actions.Help.md): Provide help about the bridge system
- [Jido.Messaging.Demo.ChatAgent.Actions.Time](Jido.Messaging.Demo.ChatAgent.Actions.Time.md): Get the current time
- [Jido.Messaging.Demo.ChatAgentRunner](Jido.Messaging.Demo.ChatAgentRunner.md): Wrapper that runs the ChatAgent within the Jido.Messaging AgentRunner framework.
- [Jido.Messaging.Demo.HeartbeatSensor](Jido.Messaging.Demo.HeartbeatSensor.md): A Jido Sensor that emits periodic heartbeat messages to a chat room.
- [Jido.Messaging.Demo.Messaging](Jido.Messaging.Demo.Messaging.md): Demo messaging instance for the echo bot demo.

- [Jido.Messaging.Demo.Supervisor](Jido.Messaging.Demo.Supervisor.md): Supervisor for the demo messaging service.
- [Jido.Messaging.Demo.Topology](Jido.Messaging.Demo.Topology.md): YAML-backed bootstrap helpers for demo runtime topology.
- [Jido.Messaging.Directory](Jido.Messaging.Directory.md): Unified directory lookup and search APIs.
- [Jido.Messaging.Gating](Jido.Messaging.Gating.md): Gating hook for authorization decisions.
- [Jido.Messaging.InboundRouter](Jido.Messaging.InboundRouter.md): Inbound routing boundary from raw adapter payloads into runtime ingest.
- [Jido.Messaging.Ingest](Jido.Messaging.Ingest.md): Inbound message processing pipeline.
- [Jido.Messaging.IngressOutcome](Jido.Messaging.IngressOutcome.md): Canonical normalized ingress result for webhook and non-webhook payload paths.

- [Jido.Messaging.IngressSink](Jido.Messaging.IngressSink.md): Shared ingress sink for adapter-owned listener workers.
- [Jido.Messaging.IngressSubscription](Jido.Messaging.IngressSubscription.md): Normalized provider ingress subscription state for a bridge.
- [Jido.Messaging.IngressSubscriptions](Jido.Messaging.IngressSubscriptions.md): Bridge-scoped ingress subscription provisioning.
- [Jido.Messaging.Instance](Jido.Messaging.Instance.md): Represents a channel instance (e.g., a Telegram bot, Discord connection).
- [Jido.Messaging.InstanceReconnectWorker](Jido.Messaging.InstanceReconnectWorker.md): Per-instance lifecycle worker that runs connection probes and reconnect policy.
- [Jido.Messaging.InstanceServer](Jido.Messaging.InstanceServer.md): Per-instance GenServer that tracks lifecycle state and emits signals.
- [Jido.Messaging.InstanceSupervisor](Jido.Messaging.InstanceSupervisor.md): Dynamic supervisor for channel instances.
- [Jido.Messaging.MediaPolicy](Jido.Messaging.MediaPolicy.md): Deterministic media normalization and bounded policy checks.
- [Jido.Messaging.Message](Jido.Messaging.Message.md): Canonical persisted runtime message model for `Jido.Messaging`.

- [Jido.Messaging.Moderation](Jido.Messaging.Moderation.md): Moderation behaviour and utilities for message filtering.
- [Jido.Messaging.Moderators.KeywordFilter](Jido.Messaging.Moderators.KeywordFilter.md): A simple keyword-based content filter.
- [Jido.Messaging.Moderators.RateLimiter](Jido.Messaging.Moderators.RateLimiter.md): Rate limiting moderator to prevent message flooding.
- [Jido.Messaging.MsgContext](Jido.Messaging.MsgContext.md): Normalized message envelope for routing and transport.
- [Jido.Messaging.MsgContext.CommandParser](Jido.Messaging.MsgContext.CommandParser.md): Deterministic command parser for normalized inbound message text.
- [Jido.Messaging.MsgContext.Normalizer](Jido.Messaging.MsgContext.Normalizer.md): Command and mention normalization for `MsgContext`.

- [Jido.Messaging.Onboarding](Jido.Messaging.Onboarding.md): Onboarding flow orchestration APIs.
- [Jido.Messaging.Onboarding.Flow](Jido.Messaging.Onboarding.Flow.md): Persisted onboarding flow state.
- [Jido.Messaging.Onboarding.StateMachine](Jido.Messaging.Onboarding.StateMachine.md): Deterministic onboarding state transitions with persisted idempotency.

- [Jido.Messaging.Onboarding.Supervisor](Jido.Messaging.Onboarding.Supervisor.md): Dynamic supervisor for onboarding workers partitioned by onboarding ID.

- [Jido.Messaging.Onboarding.Worker](Jido.Messaging.Onboarding.Worker.md): Runtime process for a single onboarding flow.
- [Jido.Messaging.OutboundGateway](Jido.Messaging.OutboundGateway.md): Partitioned outbound gateway for send/edit delivery operations.
- [Jido.Messaging.OutboundGateway.Supervisor](Jido.Messaging.OutboundGateway.Supervisor.md): Supervisor for outbound gateway partition workers.

- [Jido.Messaging.OutboundRouter](Jido.Messaging.OutboundRouter.md): Outbound bridge router for runtime-configurable adapter delivery.
- [Jido.Messaging.Persistence](Jido.Messaging.Persistence.md): Behaviour for Jido.Messaging storage adapters.
- [Jido.Messaging.Persistence.ETS](Jido.Messaging.Persistence.ETS.md): In-memory ETS adapter for Jido.Messaging.
- [Jido.Messaging.PubSub](Jido.Messaging.PubSub.md): Optional Phoenix.PubSub integration for cross-node events and LiveView support.
- [Jido.Messaging.RoomBinding](Jido.Messaging.RoomBinding.md): Represents a binding between an internal room and an external platform room.
- [Jido.Messaging.RoomServer](Jido.Messaging.RoomServer.md): GenServer that manages a single room's state.
- [Jido.Messaging.RoomSupervisor](Jido.Messaging.RoomSupervisor.md): DynamicSupervisor for spawning and managing RoomServer processes.
- [Jido.Messaging.RoutingPolicy](Jido.Messaging.RoutingPolicy.md): Runtime-editable routing policy for outbound bridge delivery decisions.

- [Jido.Messaging.Runtime](Jido.Messaging.Runtime.md): Runtime state holder for a Jido.Messaging instance.
- [Jido.Messaging.Security](Jido.Messaging.Security.md): Centralized security boundary for inbound verification and outbound sanitization.
- [Jido.Messaging.Security.DefaultAdapter](Jido.Messaging.Security.DefaultAdapter.md): Default security adapter.
- [Jido.Messaging.Sender](Jido.Messaging.Sender.md): Per-instance message sender with retry queue and exponential backoff.
- [Jido.Messaging.SessionKey](Jido.Messaging.SessionKey.md): Session key derivation for conversation scoping.
- [Jido.Messaging.SessionManager](Jido.Messaging.SessionManager.md): Partitioned route-state manager for deterministic session routing.
- [Jido.Messaging.SessionManager.Partition](Jido.Messaging.SessionManager.Partition.md): Partition process for session route state.
- [Jido.Messaging.SessionManager.Supervisor](Jido.Messaging.SessionManager.Supervisor.md): Supervisor for partitioned session-routing workers.

- [Jido.Messaging.Signal](Jido.Messaging.Signal.md): Signal emission for messaging events using dual-emission pattern.
- [Jido.Messaging.Signal.Ext.CorrelationId](Jido.Messaging.Signal.Ext.CorrelationId.md): Signal extension for message correlation tracking in Jido.Messaging.
- [Jido.Messaging.Streaming](Jido.Messaging.Streaming.md): Streaming response support for progressive message updates.
- [Jido.Messaging.Supervisor](Jido.Messaging.Supervisor.md): Main supervisor for a Jido.Messaging instance.
- [Jido.Messaging.Thread](Jido.Messaging.Thread.md): Canonical persisted thread model for `Jido.Messaging`.

- [Jido.Messaging.TopologyValidator](Jido.Messaging.TopologyValidator.md): Validation helpers for bridge-room topology payloads.

- [Jido.Messaging.WebhookPlug](Jido.Messaging.WebhookPlug.md): Generic webhook Plug for adapter-backed bridges.

## Mix Tasks

- [mix jido.messaging.demo](Mix.Tasks.Jido.Messaging.Demo.md): Starts a demo messaging service.