helped
Provide feedback on whether recalled memories were useful to improve AI memory accuracy. This tool strengthens helpful memories and allows unhelpful ones to decay, creating a learning feedback loop.
Instructions
Mark whether a surfaced memory actually helped.
This feedback loop is what makes NeverOnce learn.
Helpful memories get stronger. Unhelpful ones decay.
Args:
memory_id: The memory ID (from recall results).
did_help: True if the memory was useful, False if not.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| memory_id | Yes | ||
| did_help | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- neveronce/server.py:145-157 (handler)The MCP tool handler for 'helped', which calls the memory object's helped method.
def helped(memory_id: int, did_help: bool) -> str: """Mark whether a surfaced memory actually helped. This feedback loop is what makes NeverOnce learn. Helpful memories get stronger. Unhelpful ones decay. Args: memory_id: The memory ID (from recall results). did_help: True if the memory was useful, False if not. """ mem = _get_mem() mem.helped(memory_id, did_help) return f"Memory #{memory_id} marked as {'helpful' if did_help else 'not helpful'}" - neveronce/memory.py:119-125 (helper)The memory manager helper that initiates the effectiveness update.
def helped(self, memory_id: int, did_help: bool) -> None: """Mark whether a surfaced memory actually helped. This is the feedback loop. Memories that help get stronger. Memories that don't get weaker over time. """ self.db.update_effectiveness(memory_id, did_help) - neveronce/db.py:159-172 (helper)The database logic that calculates effectiveness and updates the 'times_helped' count.
def update_effectiveness(self, memory_id: int, helped: bool): mem = self.get(memory_id) if not mem: return surfaced = mem["times_surfaced"] helped_count = mem["times_helped"] + (1 if helped else 0) effectiveness = helped_count / max(surfaced, 1) self.conn.execute( """UPDATE memories SET times_helped = ?, effectiveness = ?, accessed_at = ? WHERE id = ?""", (helped_count, effectiveness, _now(), memory_id), ) self.conn.commit() - neveronce/server.py:144-144 (registration)The MCP tool registration decorator for the 'helped' function.
@mcp.tool()