NexusMCP.SessionRegistry behaviour (NexusMCP v0.3.0)

Behaviour for session registry implementations.

The default implementation (NexusMCP.SessionRegistry.Local) wraps Elixir's built-in Registry for single-node usage.

For multi-node deployments, implement this behaviour with :global, :pg, Horde, or your preferred distributed registry.

Configuration

config :nexus_mcp, registry: MyApp.DistributedRegistry

impl()

Returns the configured registry module.

@callback lookup(session_id :: String.t()) :: {:ok, pid()} | :error

@callback register(session_id :: String.t(), pid()) :: :ok | {:error, :already_registered}

@callback unregister(session_id :: String.t()) :: :ok

Returns the configured registry module.