basic-memory 0.14.4__py3-none-any.whl → 0.15.1__py3-none-any.whl

basic_memory/mcp/prompts/ai_assistant_guide.py

@@ -1,5 +1,6 @@
 from pathlib import Path
 
+from basic_memory.config import ConfigManager
 from basic_memory.mcp.server import mcp
 from loguru import logger
 
@@ -12,14 +13,58 @@ from loguru import logger
 def ai_assistant_guide() -> str:
     """Return a concise guide on Basic Memory tools and how to use them.
 
-    Args:
-        focus: Optional area to focus on ("writing", "context", "search", etc.)
+    Dynamically adapts instructions based on configuration:
+    - Default project mode: Simplified instructions with automatic project
+    - Regular mode: Project discovery and selection guidance
+    - CLI constraint mode: Single project constraint information
 
     Returns:
         A focused guide on Basic Memory usage.
     """
     logger.info("Loading AI assistant guide resource")
+
+    # Load base guide content
     guide_doc = Path(__file__).parent.parent / "resources" / "ai_assistant_guide.md"
     content = guide_doc.read_text(encoding="utf-8")
-    logger.info(f"Loaded AI assistant guide ({len(content)} chars)")
-    return content
+
+    # Check configuration for mode-specific instructions
+    config = ConfigManager().config
+
+    # Add mode-specific header
+    mode_info = ""
+    if config.default_project_mode:
+        mode_info = f"""
+# 🎯 Default Project Mode Active
+
+**Current Configuration**: All operations automatically use project '{config.default_project}'
+
+**Simplified Usage**: You don't need to specify the project parameter in tool calls.
+- `write_note(title="Note", content="...", folder="docs")` ✅
+- Project parameter is optional and will default to '{config.default_project}'
+- To use a different project, explicitly specify: `project="other-project"`
+
+────────────────────────────────────────
+
+"""
+    else:
+        mode_info = """
+# 🔧 Multi-Project Mode Active
+
+**Current Configuration**: Project parameter required for all operations
+
+**Project Discovery Required**: Use these tools to select a project:
+- `list_memory_projects()` - See all available projects
+- `recent_activity()` - Get project activity and recommendations
+- Remember the user's project choice throughout the conversation
+
+────────────────────────────────────────
+
+"""
+
+    # Prepend mode info to the guide
+    enhanced_content = mode_info + content
+
+    logger.info(
+        f"Loaded AI assistant guide ({len(enhanced_content)} chars) with mode: {'default_project' if config.default_project_mode else 'multi_project'}"
+    )
+    return enhanced_content

basic_memory/mcp/prompts/continue_conversation.py

@@ -10,7 +10,7 @@ from loguru import logger
 from pydantic import Field
 
 from basic_memory.config import get_project_config
-from basic_memory.mcp.async_client import client
+from basic_memory.mcp.async_client import get_client
 from basic_memory.mcp.server import mcp
 from basic_memory.mcp.tools.utils import call_post
 from basic_memory.schemas.base import TimeFrame
@@ -18,7 +18,7 @@ from basic_memory.schemas.prompt import ContinueConversationRequest
 
 
 @mcp.prompt(
-    name="Continue Conversation",
+    name="continue_conversation",
     description="Continue a previous conversation",
 )
 async def continue_conversation(
@@ -42,20 +42,21 @@ async def continue_conversation(
     """
     logger.info(f"Continuing session, topic: {topic}, timeframe: {timeframe}")
 
-    # Create request model
-    request = ContinueConversationRequest(  # pyright: ignore [reportCallIssue]
-        topic=topic, timeframe=timeframe
-    )
+    async with get_client() as client:
+        # Create request model
+        request = ContinueConversationRequest(  # pyright: ignore [reportCallIssue]
+            topic=topic, timeframe=timeframe
+        )
 
-    project_url = get_project_config().project_url
+        project_url = get_project_config().project_url
 
-    # Call the prompt API endpoint
-    response = await call_post(
-        client,
-        f"{project_url}/prompt/continue-conversation",
-        json=request.model_dump(exclude_none=True),
-    )
+        # Call the prompt API endpoint
+        response = await call_post(
+            client,
+            f"{project_url}/prompt/continue-conversation",
+            json=request.model_dump(exclude_none=True),
+        )
 
-    # Extract the rendered prompt from the response
-    result = response.json()
-    return result["prompt"]
+        # Extract the rendered prompt from the response
+        result = response.json()
+        return result["prompt"]

basic_memory/mcp/prompts/recent_activity.py

@@ -3,7 +3,7 @@
 These prompts help users see what has changed in their knowledge base recently.
 """
 
-from typing import Annotated
+from typing import Annotated, Optional
 
 from loguru import logger
 from pydantic import Field
@@ -12,49 +12,83 @@ from basic_memory.mcp.prompts.utils import format_prompt_context, PromptContext,
 from basic_memory.mcp.server import mcp
 from basic_memory.mcp.tools.recent_activity import recent_activity
 from basic_memory.schemas.base import TimeFrame
+from basic_memory.schemas.memory import GraphContext, ProjectActivitySummary
 from basic_memory.schemas.search import SearchItemType
 
 
 @mcp.prompt(
-    name="Share Recent Activity",
-    description="Get recent activity from across the knowledge base",
+    name="recent_activity",
+    description="Get recent activity from a specific project or across all projects",
 )
 async def recent_activity_prompt(
     timeframe: Annotated[
         TimeFrame,
         Field(description="How far back to look for activity (e.g. '1d', '1 week')"),
     ] = "7d",
+    project: Annotated[
+        Optional[str],
+        Field(
+            description="Specific project to get activity from (None for discovery across all projects)"
+        ),
+    ] = None,
 ) -> str:
-    """Get recent activity from across the knowledge base.
+    """Get recent activity from a specific project or across all projects.
 
-    This prompt helps you see what's changed recently in the knowledge base,
-    showing new or updated documents and related information.
+    This prompt helps you see what's changed recently in the knowledge base.
+    In discovery mode (project=None), it shows activity across all projects.
+    In project-specific mode, it shows detailed activity for one project.
 
     Args:
         timeframe: How far back to look for activity (e.g. '1d', '1 week')
+        project: Specific project to get activity from (None for discovery across all projects)
 
     Returns:
         Formatted summary of recent activity
     """
-    logger.info(f"Getting recent activity, timeframe: {timeframe}")
+    logger.info(f"Getting recent activity, timeframe: {timeframe}, project: {project}")
 
-    recent = await recent_activity.fn(timeframe=timeframe, type=[SearchItemType.ENTITY])
+    recent = await recent_activity.fn(
+        project=project, timeframe=timeframe, type=[SearchItemType.ENTITY]
+    )
 
     # Extract primary results from the hierarchical structure
     primary_results = []
     related_results = []
 
-    if recent.results:
-        # Take up to 5 primary results
-        for item in recent.results[:5]:
-            primary_results.append(item.primary_result)
-            # Add up to 2 related results per primary item
-            if item.related_results:
-                related_results.extend(item.related_results[:2])
+    if isinstance(recent, ProjectActivitySummary):
+        # Discovery mode - extract results from all projects
+        for _, project_activity in recent.projects.items():
+            if project_activity.activity.results:
+                # Take up to 2 primary results per project
+                for item in project_activity.activity.results[:2]:
+                    primary_results.append(item.primary_result)
+                    # Add up to 1 related result per primary item
+                    if item.related_results:
+                        related_results.extend(item.related_results[:1])
+
+        # Limit total results for readability
+        primary_results = primary_results[:8]
+        related_results = related_results[:6]
+
+    elif isinstance(recent, GraphContext):
+        # Project-specific mode - use existing logic
+        if recent.results:
+            # Take up to 5 primary results
+            for item in recent.results[:5]:
+                primary_results.append(item.primary_result)
+                # Add up to 2 related results per primary item
+                if item.related_results:
+                    related_results.extend(item.related_results[:2])
+
+    # Set topic based on mode
+    if project:
+        topic = f"Recent Activity in {project} ({timeframe})"
+    else:
+        topic = f"Recent Activity Across All Projects ({timeframe})"
 
     prompt_context = format_prompt_context(
         PromptContext(
-            topic=f"Recent Activity from ({timeframe})",
+            topic=topic,
             timeframe=timeframe,
             results=[
                 PromptContextItem(
@@ -65,40 +99,90 @@ async def recent_activity_prompt(
         )
     )
 
-    # Add suggestions for summarizing recent activity
+    # Add mode-specific suggestions
     first_title = "Recent Topic"
     if primary_results and len(primary_results) > 0:
         first_title = primary_results[0].title
 
-    capture_suggestions = f"""
+    if project:
+        # Project-specific suggestions
+        capture_suggestions = f"""
     ## Opportunity to Capture Activity Summary
-    
-    Consider creating a summary note of recent activity:
-    
+
+    Consider creating a summary note of recent activity in {project}:
+
     ```python
     await write_note(
+        "{project}",
         title="Activity Summary {timeframe}",
         content='''
-        # Activity Summary for {timeframe}
-        
+        # Activity Summary for {project} ({timeframe})
+
         ## Overview
-        [Summary of key changes and developments over this period]
-        
+        [Summary of key changes and developments in this project over this period]
+
         ## Key Updates
-        [List main updates and their significance]
-        
+        [List main updates and their significance within this project]
+
         ## Observations
         - [trend] [Observation about patterns in recent activity]
         - [insight] [Connection between different activities]
-        
+
         ## Relations
         - summarizes [[{first_title}]]
-        - relates_to [[Project Overview]]
-        '''
+        - relates_to [[{project} Overview]]
+        ''',
+        folder="summaries"
     )
     ```
-    
-    Summarizing periodic activity helps create high-level insights and connections between topics.
+
+    Summarizing periodic activity helps create high-level insights and connections within the project.
+    """
+    else:
+        # Discovery mode suggestions
+        project_count = len(recent.projects) if isinstance(recent, ProjectActivitySummary) else 0
+        most_active = (
+            getattr(recent.summary, "most_active_project", "Unknown")
+            if isinstance(recent, ProjectActivitySummary)
+            else "Unknown"
+        )
+
+        capture_suggestions = f"""
+    ## Cross-Project Activity Discovery
+
+    Found activity across {project_count} projects. Most active: **{most_active}**
+
+    Consider creating a cross-project summary:
+
+    ```python
+    await write_note(
+        "{most_active if most_active != "Unknown" else "main"}",
+        title="Cross-Project Activity Summary {timeframe}",
+        content='''
+        # Cross-Project Activity Summary ({timeframe})
+
+        ## Overview
+        Activity found across {project_count} projects, with {most_active} showing the most activity.
+
+        ## Key Developments
+        [Summarize important changes across all projects]
+
+        ## Project Insights
+        [Note patterns or connections between projects]
+
+        ## Observations
+        - [trend] [Cross-project patterns observed]
+        - [insight] [Connections between different project activities]
+
+        ## Relations
+        - summarizes [[{first_title}]]
+        - relates_to [[Project Portfolio Overview]]
+        ''',
+        folder="summaries"
+    )
+    ```
+
+    Cross-project summaries help identify broader trends and project interconnections.
     """
 
     return prompt_context + capture_suggestions

basic_memory/mcp/prompts/search.py

@@ -9,7 +9,7 @@ from loguru import logger
 from pydantic import Field
 
 from basic_memory.config import get_project_config
-from basic_memory.mcp.async_client import client
+from basic_memory.mcp.async_client import get_client
 from basic_memory.mcp.server import mcp
 from basic_memory.mcp.tools.utils import call_post
 from basic_memory.schemas.base import TimeFrame
@@ -17,7 +17,7 @@ from basic_memory.schemas.prompt import SearchPromptRequest
 
 
 @mcp.prompt(
-    name="Search Knowledge Base",
+    name="search_knowledge_base",
     description="Search across all content in basic-memory",
 )
 async def search_prompt(
@@ -41,16 +41,17 @@ async def search_prompt(
     """
     logger.info(f"Searching knowledge base, query: {query}, timeframe: {timeframe}")
 
-    # Create request model
-    request = SearchPromptRequest(query=query, timeframe=timeframe)
+    async with get_client() as client:
+        # Create request model
+        request = SearchPromptRequest(query=query, timeframe=timeframe)
 
-    project_url = get_project_config().project_url
+        project_url = get_project_config().project_url
 
-    # Call the prompt API endpoint
-    response = await call_post(
-        client, f"{project_url}/prompt/search", json=request.model_dump(exclude_none=True)
-    )
+        # Call the prompt API endpoint
+        response = await call_post(
+            client, f"{project_url}/prompt/search", json=request.model_dump(exclude_none=True)
+        )
 
-    # Extract the rendered prompt from the response
-    result = response.json()
-    return result["prompt"]
+        # Extract the rendered prompt from the response
+        result = response.json()
+        return result["prompt"]

basic_memory/mcp/prompts/utils.py

@@ -103,10 +103,17 @@ def format_prompt_context(context: PromptContext) -> str:
 
                 added_permalinks.add(primary_permalink)
 
-                memory_url = normalize_memory_url(primary_permalink)
+                # Use permalink if available, otherwise use file_path
+                if primary_permalink:
+                    memory_url = normalize_memory_url(primary_permalink)
+                    read_command = f'read_note("{primary_permalink}")'
+                else:
+                    memory_url = f"file://{primary.file_path}"
+                    read_command = f'read_file("{primary.file_path}")'
+
                 section = dedent(f"""
                     --- {memory_url}
-                
+
                     ## {primary.title}
                     - **Type**: {primary.type}
                     """)
@@ -121,8 +128,8 @@ def format_prompt_context(context: PromptContext) -> str:
                         section += f"\n**Excerpt**:\n{content}\n"
 
                 section += dedent(f"""
-    
-                    You can read this document with: `read_note("{primary_permalink}")`
+
+                    You can read this document with: `{read_command}`
                     """)
                 sections.append(section)