Skip to content

Personal AI, On Personal Devices

Python
4.8 KB
Raw Blame
"""Manage persistent agent memory (MEMORY.md)."""

from __future__ import annotations

from pathlib import Path
from typing import Any

from openjarvis.core.paths import get_config_dir
from openjarvis.core.registry import ToolRegistry
from openjarvis.core.types import ToolResult
from openjarvis.tools._stubs import BaseTool, ToolSpec


@ToolRegistry.register("memory_manage")
class MemoryManageTool(BaseTool):
    """Manage persistent agent memory (MEMORY.md)."""

    def __init__(self, memory_path: Path | str | None = None) -> None:
        if memory_path is None:
            memory_path = get_config_dir() / "MEMORY.md"
        self._memory_path = Path(memory_path).expanduser()

    @property
    def spec(self) -> ToolSpec:
        return ToolSpec(
            name="memory_manage",
            description=(
                "Read, add, update, or remove entries in persistent agent memory."
            ),
            parameters={
                "type": "object",
                "properties": {
                    "action": {
                        "type": "string",
                        "enum": ["read", "add", "update", "remove"],
                        "description": "Action to perform on memory.",
                    },
                    "entry": {
                        "type": "string",
                        "description": (
                            "The memory entry content (for add/update/remove)."
                        ),
                    },
                    "new_entry": {
                        "type": "string",
                        "description": (
                            "Replacement content (for update action only)."
                        ),
                    },
                },
                "required": ["action"],
            },
            category="memory",
        )

    def execute(self, **params: Any) -> ToolResult:
        action = params.get("action", "read")
        entry = params.get("entry", "")
        new_entry = params.get("new_entry", "")
        if action == "read":
            return self._read()
        elif action == "add":
            return self._add(entry)
        elif action == "update":
            return self._update(entry, new_entry)
        elif action == "remove":
            return self._remove(entry)
        return ToolResult(
            tool_name=self.spec.name,
            success=False,
            content=f"Unknown action: {action}",
        )

    def _read(self) -> ToolResult:
        content = ""
        if self._memory_path.exists():
            content = self._memory_path.read_text()
        return ToolResult(
            tool_name=self.spec.name,
            success=True,
            content=content or "(empty)",
        )

    def _add(self, entry: str) -> ToolResult:
        if not entry:
            return ToolResult(
                tool_name=self.spec.name,
                success=False,
                content="Entry cannot be empty.",
            )
        self._memory_path.parent.mkdir(parents=True, exist_ok=True)
        existing = self._memory_path.read_text() if self._memory_path.exists() else ""
        self._memory_path.write_text(existing.rstrip() + f"\n- {entry}\n")
        return ToolResult(
            tool_name=self.spec.name,
            success=True,
            content=f"Added: {entry}",
        )

    def _update(self, old: str, new: str) -> ToolResult:
        if not self._memory_path.exists():
            return ToolResult(
                tool_name=self.spec.name,
                success=False,
                content="Memory file does not exist.",
            )
        text = self._memory_path.read_text()
        if old not in text:
            return ToolResult(
                tool_name=self.spec.name,
                success=False,
                content=f"Entry not found: {old}",
            )
        self._memory_path.write_text(text.replace(old, new, 1))
        return ToolResult(
            tool_name=self.spec.name,
            success=True,
            content=f"Updated: {old} -> {new}",
        )

    def _remove(self, entry: str) -> ToolResult:
        if not self._memory_path.exists():
            return ToolResult(
                tool_name=self.spec.name,
                success=False,
                content="Memory file does not exist.",
            )
        text = self._memory_path.read_text()
        lines = text.split("\n")
        new_lines = [ln for ln in lines if entry not in ln]
        if len(new_lines) == len(lines):
            return ToolResult(
                tool_name=self.spec.name,
                success=False,
                content=f"Entry not found: {entry}",
            )
        self._memory_path.write_text("\n".join(new_lines))
        return ToolResult(
            tool_name=self.spec.name,
            success=True,
            content=f"Removed: {entry}",
        )