Class SessionNoteTool

mini_agent/tools/note_tool.py:17–125

Tool for recording and recalling session notes. The agent can use this tool to: - Record important facts, decisions, or context during sessions - Recall information from previous sessions - Build up knowledge over time Example usage by agent: - record_note("User prefers con

class SessionNoteTool(Tool):
    """Tool for recording and recalling session notes.

    The agent can use this tool to:
    - Record important facts, decisions, or context during sessions
    - Recall information from previous sessions
    - Build up knowledge over time

    Example usage by agent:
    - record_note("User prefers concise responses")
    - record_note("Project uses Python 3.12 and async/await")
    - recall_notes() -> retrieves all recorded notes
    """

    def __init__(self, memory_file: str = "./workspace/.agent_memory.json"):
        """Initialize session note tool.

        Args:
            memory_file: Path to the note storage file
        """
        self.memory_file = Path(memory_file)
        # Lazy loading: file and directory are only created when first note is recorded

    @property
    def name(self) -> str:
        return "record_note"

    @property
    def description(self) -> str:
        return (
            "Record important information as session notes for future reference. "
            "Use this to record key facts, user preferences, decisions, or context "
            "that should be recalled later in the agent execution chain. Each note is timestamped."
        )

    @property
    def parameters(self) -> dict[str, Any]:
        return {
            "type": "object",
            "properties": {
                "content": {
                    "type": "string",
                    "description": "The information to record as a note. Be concise but specific.",
                },
                "category": {
                    "type": "string",
                    "description": "Optional category/tag for this note (e.g., 'user_preference', 'project_info', 'decision')",
                },
            },
            "required": ["content"],
        }

    def _load_from_file(self) -> list:
        """Load notes from file.
        
        Returns empty list if file doesn't exist (lazy loading).
        """
        if not self.memory_file.exists():