Serena

Instructions

Implementation Reference

• src/serena/tools/memory_tools.py:43-53 (handler)

  Implementation of the MCP tool handler for "list_memories". The apply method retrieves the list of memories from the project's memories_manager and serializes it to JSON.
  class ListMemoriesTool(Tool): """ Lists memories in Serena's project-specific memory store. """ def apply(self) -> str: """ List available memories. Any memory can be read using the `read_memory` tool. """ return self._to_json(self.memories_manager.list_memories())
• src/serena/project.py:48-49 (helper)

  Core utility method in MemoriesManager that lists the names of memory files (stripping .md extension) in the project's memories directory.
  def list_memories(self) -> list[str]: return [f.name.replace(".md", "") for f in self._memory_dir.iterdir() if f.is_file()]
• src/serena/tools/tools_base.py:118-125 (registration)

  Class method that derives the MCP tool name 'list_memories' from the class name 'ListMemoriesTool'.
  @classmethod def get_name_from_cls(cls) -> str: name = cls.__name__ if name.endswith("Tool"): name = name[:-4] # convert to snake_case name = "".join(["_" + c.lower() if c.isupper() else c for c in name]).lstrip("_") return name
• src/serena/tools/tools_base.py:359-367 (registration)

  ToolRegistry discovers all Tool subclasses (including ListMemoriesTool) via iter_subclasses and registers them by name.
  for cls in iter_subclasses(Tool): if not any(cls.__module__.startswith(pkg) for pkg in tool_packages): continue is_optional = issubclass(cls, ToolMarkerOptional) name = cls.get_name_from_cls() if name in self._tool_dict: raise ValueError(f"Duplicate tool name found: {name}. Tool classes must have unique names.") self._tool_dict[name] = RegisteredTool(tool_class=cls, is_optional=is_optional, tool_name=name)