Struct ResourceHandler 

pub struct ResourceHandler {
    help_content: HashMap<String, HelpCategory>,
    recall_service: Option<RecallService>,
    topic_index: Option<TopicIndexService>,
    prompt_service: Option<PromptService>,
}

Handler for MCP resources (URN scheme).

Fields

help_content: HashMap<String, HelpCategory>

Help content by category.

recall_service: Option<RecallService>

Optional recall service for memory browsing.

topic_index: Option<TopicIndexService>

Topic index for topic-based resource access.

prompt_service: Option<PromptService>

Optional prompt service for prompt resources.

Implementations

impl ResourceHandler

pub fn new() -> Self

Creates a new resource handler.

pub fn with_prompt_service(self, prompt_service: PromptService) -> Self

Adds a prompt service to the resource handler.

pub fn with_recall_service(self, recall_service: RecallService) -> Self

Adds a recall service to the resource handler.

pub fn with_topic_index(self, topic_index: TopicIndexService) -> Self

Adds a topic index to the resource handler.

pub fn refresh_topic_index(&mut self) -> Result<()>

Builds and refreshes the topic index from the recall service.

Errors

Returns an error if the topic index cannot be built.

pub fn list_resources(&self) -> Vec<ResourceDefinition>

Lists all available resources.

Returns resources organized by type:

• Help topics
• Memory browsing patterns

For advanced filtering, use subcog_recall with the filter argument.

fn build_resource( uri: &str, name: &str, description: &str, mime_type: &str, ) -> ResourceDefinition

fn help_resource_definitions(&self) -> Vec<ResourceDefinition>

fn memory_resource_definitions(&self) -> Vec<ResourceDefinition>

fn domain_resource_definitions() -> Vec<ResourceDefinition>

fn search_topic_resource_definitions() -> Vec<ResourceDefinition>

fn summary_resource_definitions() -> Vec<ResourceDefinition>

fn prompt_resource_definitions() -> Vec<ResourceDefinition>

pub fn get_resource(&mut self, uri: &str) -> Result<ResourceContent>

Gets a resource by URI.

Supported URI patterns:

• subcog://help - Help index
• subcog://help/{topic} - Help topic
• subcog://_ - All memories across all domains
• subcog://_/{namespace} - All memories in a namespace
• subcog://memory/{id} - Get specific memory by ID
• subcog://project/_ - Project-scoped memories (alias for subcog://_)
• subcog://search/{query} - Search memories with a query
• subcog://topics - List all indexed topics
• subcog://topics/{topic} - Get memories for a specific topic
• subcog://summaries - List all consolidated summaries
• subcog://summaries/{id} - Get a specific summary with source memories

For advanced filtering, use subcog_recall with the filter argument.

Errors

Returns an error if the resource is not found.

fn get_help_resource( &self, uri: &str, parts: &[&str], ) -> Result<ResourceContent>

Gets a help resource.

fn get_all_memories_resource( &self, uri: &str, parts: &[&str], ) -> Result<ResourceContent>

Gets all memories resource with optional namespace filter.

URI patterns:

• subcog://_ - All memories across all domains
• subcog://_/{namespace} - All memories in a namespace
• subcog://project/_ - Alias for subcog://_ (project-scoped, future domain filter)

For advanced filtering, use subcog_recall with the filter argument.

fn get_memory_resource( &self, uri: &str, parts: &[&str], ) -> Result<ResourceContent>

Gets a specific memory by ID with full content (cross-domain lookup).

This is the targeted fetch endpoint - returns complete memory data. Use subcog://memory/{id} for cross-domain lookups when ID is known.

fn get_namespace_memories_resource( &self, uri: &str, namespace: &str, ) -> Result<ResourceContent>

Gets memories scoped to a namespace.

fn get_scoped_memory_resource( &self, uri: &str, namespace: &str, memory_id: &str, ) -> Result<ResourceContent>

Gets a specific memory by ID with namespace validation.

fn format_memory_response( &self, uri: &str, memory: &Memory, ) -> Result<ResourceContent>

Formats a memory as a JSON response.

fn list_memories( &self, uri: &str, filter: &SearchFilter, ) -> Result<ResourceContent>

fn get_search_resource( &self, uri: &str, parts: &[&str], ) -> Result<ResourceContent>

Searches memories and returns results.

URI: subcog://search/{query}

fn get_topics_resource( &self, uri: &str, parts: &[&str], ) -> Result<ResourceContent>

Gets topics resource (list or specific topic).

URIs:

• subcog://topics - List all topics
• subcog://topics/{topic} - Get memories for a topic

fn get_namespaces_resource(&self, uri: &str) -> Result<ResourceContent>

Gets namespaces resource listing all available namespaces.

URI: subcog://namespaces

Returns namespace definitions with descriptions and signal words.

fn get_summaries_resource( &self, uri: &str, parts: &[&str], ) -> Result<ResourceContent>

Gets summaries resource (list or specific summary).

URIs:

• subcog://summaries - List all summary nodes
• subcog://summaries/{id} - Get a specific summary with source memories

fn get_specific_summary_resource( &self, uri: &str, recall: &RecallService, summary_id: &str, ) -> Result<ResourceContent>

Gets a specific summary node with its source memories.

Returns the summary content and linked source memories.

fn get_aggregate_prompts_resource( &mut self, uri: &str, ) -> Result<ResourceContent>

Gets aggregate prompts resource listing prompts from all domains.

URI: subcog://_prompts

Returns prompts aggregated from project, user, and org domains. Prompts are deduplicated by name, with project scope taking priority.

fn collect_unique_prompts( seen: &mut HashSet<String>, output: &mut Vec<Value>, prompts: Vec<PromptTemplate>, domain_name: &str, )

Collects unique prompts, skipping those already seen.

fn get_domain_scoped_resource( &mut self, uri: &str, parts: &[&str], domain: DomainScope, ) -> Result<ResourceContent>

Gets domain-scoped resources (prompts or memories).

URIs:

• subcog://{domain}/_prompts - List prompts in domain
• subcog://{domain}/_prompts/{name} - Get specific prompt by name
• subcog://{domain}/_ - List memories in domain (alias)

fn get_prompts_resource( &mut self, uri: &str, domain: DomainScope, ) -> Result<ResourceContent>

Gets prompts for a specific domain scope.

fn get_single_prompt_resource( &mut self, uri: &str, domain: DomainScope, name: &str, ) -> Result<ResourceContent>

Gets a specific prompt by name from a domain scope.

fn get_help_index(&self) -> String

Gets the help index listing all categories.

pub fn list_categories(&self) -> Vec<&HelpCategory>

Gets a list of help categories.

Trait Implementations

impl Default for ResourceHandler

fn default() -> Self

Returns the “default value” for a type.