Struct MemoryProtocolHandler 

pub struct MemoryProtocolHandler { /* private fields */ }

The brain-backed protocol handler is read-only and degraded-friendly.

Under the Foundation v1 host, the only durable-memory authority is the oxibrain daemon. The handler holds an Arc<BrainMemoryBackend> (cheap to clone) and queries the daemon synchronously through a per-thread tokio runtime. See docs/superpowers/specs/2026-08-17-oxi-foundation-contract.md § “Read-only Brain-backed resolver”.

Implementations

impl MemoryProtocolHandler

pub fn new(backend: Arc<BrainMemoryBackend>) -> Self

Build a brain-backed protocol handler. The backend’s health is checked lazily; a degraded backend still responds (with a degraded listing) so the URL router does not hard-fail while the daemon is offline.

pub fn with_scope( backend: Arc<BrainMemoryBackend>, scope: impl Into<String>, ) -> Self

Convenience constructor pinning the protocol handler to a specific subject (e.g. the project CWD encoded as the scope).

pub fn resolve_memory_url(&self, url: &str) -> Option<String>

Resolve a memory:// URL against the brain-backed authority. The legacy resolver used a disk-root + file listing; under the Foundation host the same shape is preserved (it surfaces MEMORY.md / memory_summary.md / learned.md / skills/<name>/SKILL.md), but content comes from a brain query.

Returns

• Some(markdown) on hit,
• None on URL parse failure (the router will report “scheme unsupported”).

The protocol handler’s ProtocolHandler::resolve translates the None to SdkError::PortNotConfigured { port: "memory" } for compatibility with the existing router contract.

Trait Implementations

impl Debug for MemoryProtocolHandler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl ProtocolHandler for MemoryProtocolHandler

fn scheme(&self) -> &str

Lowercase scheme this handler serves (“issue”, “pr”, …).

fn resolve<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, url: &'life1 str, _selector: Option<&'life2 str>, _ctx: &'life3 ResolveContext, ) -> Pin<Box<dyn Future<Output = Result<ResolvedUrl, SdkError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Resolve a URL path (scheme already stripped) to text content.

fn immutable(&self) -> bool

When true, the resolved content is immutable (hashline anchor suppressed).