Tool Schema

{
"name": "mnemosyne_remember",
"description": "Store information in long-term memory. Use for facts, preferences, decisions, and observations that should persist across sessions.",
"parameters": {
  "type": "object",
  "required": ["content"],
  "properties": {
    "content": {
      "type": "string",
      "description": "The information to store. Be specific and self-contained."
    },
    "source": {
      "type": "string",
      "description": "Origin of the memory (e.g., 'conversation', 'tool', 'inference')."
    },
    "importance": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "0.0 = transient, 1.0 = critical. High importance memories are promoted to Episodic Memory during consolidation."
    },
    "scope": {
      "type": "string",
      "enum": ["session", "global"],
      "description": "Session-scoped or globally visible."
    },
    "valid_until": {
      "type": "string",
      "description": "ISO 8601 timestamp for automatic expiry."
    },
    "extract_entities": {
      "type": "boolean",
      "description": "Auto-extract named entities into knowledge graph triples."
    },
    "extract": {
      "type": "boolean",
      "description": "Auto-extract factual statements into knowledge graph triples."
    },
    "author_id": {
      "type": "string",
      "description": "Identifier of the author who created this memory."
    },
    "author_type": {
      "type": "string",
      "enum": ["human", "agent", "system"],
      "description": "Category of the author who created this memory."
    },
    "channel_id": {
      "type": "string",
      "description": "Channel identifier for contextual scoping."
    }
  }
}
}

{
"name": "mnemosyne_recall",
"description": "Retrieve relevant memories from long-term storage. Use when you need context about past interactions, user preferences, or established facts.",
"parameters": {
  "type": "object",
  "required": ["query"],
  "properties": {
    "query": {
      "type": "string",
      "description": "Natural language description of what you're looking for."
    },
    "top_k": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 5,
      "description": "Maximum number of memories to retrieve."
    },
    "author_id": {
      "type": "string",
      "description": "Filter by specific author. (v2.1)"
    },
    "author_type": {
      "type": "string",
      "enum": ["human", "agent", "system"],
      "description": "Filter by author category. (v2.1)"
    },
    "channel_id": {
      "type": "string",
      "description": "Filter by channel for cross-session recall. (v2.1)"
    },
    "vec_weight": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Weight for vector similarity in scoring."
    },
    "fts_weight": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Weight for full-text search in scoring."
    },
    "importance_weight": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Weight for importance score in retrieval ranking."
    }
  }
}
}

{
"name": "mnemosyne_sleep",
"description": "Run sleep consolidation to promote Working Memory entries to Episodic and Semantic memory. Triggers summarization and importance-based promotion. Also runs tiered degradation after consolidation.",
"parameters": {
  "type": "object",
  "properties": {
    "dry_run": {
      "type": "boolean",
      "description": "If true, preview what would happen without making changes."
    },
    "bank": {
      "type": "string",
      "description": "Target memory bank for consolidation (default: the active bank)."
    }
  }
}
}

{
"name": "mnemosyne_get_stats",
"description": "Get memory system statistics including entry counts across all memory stores, database size, and consolidation status.",
"parameters": {
  "type": "object",
  "properties": {
    "bank": {
      "type": "string",
      "description": "Target memory bank for statistics (default: all banks)."
    }
  }
}
}

{
"name": "mnemosyne_forget",
"description": "Delete a specific memory by ID. Use when information is wrong, outdated, or explicitly requested to be removed. Unlike invalidate, this permanently removes the memory.",
"parameters": {
  "type": "object",
  "required": ["memory_id"],
  "properties": {
    "memory_id": {
      "type": "string",
      "description": "The memory ID to permanently delete."
    }
  }
}
}

{
"name": "mnemosyne_update",
"description": "Update an existing memory's content or importance. Only the fields you provide will be changed.",
"parameters": {
  "type": "object",
  "required": ["memory_id"],
  "properties": {
    "memory_id": {
      "type": "string",
      "description": "The memory ID to update."
    },
    "content": {
      "type": "string",
      "description": "New content for the memory."
    },
    "importance": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Updated importance score."
    }
  }
}
}

{
"name": "mnemosyne_invalidate",
"description": "Mark a specific memory as invalidated. Use when information is outdated, incorrect, or explicitly requested to be removed.",
"parameters": {
  "type": "object",
  "required": ["memory_id"],
  "properties": {
    "memory_id": {
      "type": "string",
      "description": "The memory ID to invalidate."
    },
    "replacement_id": {
      "type": "string",
      "description": "Optional replacement memory ID to supersede the invalidated one."
    }
  }
}
}

{
"name": "mnemosyne_triple_add",
"description": "Store a structured fact as a subject-predicate-object triple in the temporal knowledge graph. Use for precise, relational knowledge that benefits from graph queries.",
"parameters": {
  "type": "object",
  "required": ["subject", "predicate", "object"],
  "properties": {
    "subject": {
      "type": "string",
      "description": "The entity the fact is about."
    },
    "predicate": {
      "type": "string",
      "description": "The relationship or property. Use consistent predicates for the same concept."
    },
    "object": {
      "type": "string",
      "description": "The value or target entity."
    }
  }
}
}

{
"name": "mnemosyne_triple_query",
"description": "Query the temporal knowledge graph for structured facts. Use for precise lookups and relationship traversal.",
"parameters": {
  "type": "object",
  "properties": {
    "subject": {
      "type": "string",
      "description": "Filter by subject entity."
    },
    "predicate": {
      "type": "string",
      "description": "Filter by relationship type."
    },
    "object": {
      "type": "string",
      "description": "Filter by value or target entity."
    },
    "as_of": {
      "type": "string",
      "description": "ISO 8601 timestamp for point-in-time query. Returns facts valid as of this time."
    }
  }
}
}

{
"name": "mnemosyne_scratchpad_write",
"description": "Write to the temporary scratchpad workspace for chain-of-thought and planning.",
"parameters": {
  "type": "object",
  "required": ["content"],
  "properties": {
    "content": {
      "type": "string",
      "description": "Content to write to the scratchpad."
    }
  }
}
}

{
"name": "mnemosyne_scratchpad_read",
"description": "Read all entries from the temporary scratchpad workspace.",
"parameters": {
  "type": "object",
  "properties": {}
}
}

{
"name": "mnemosyne_scratchpad_clear",
"description": "Clear all entries from the scratchpad workspace.",
"parameters": {
  "type": "object",
  "properties": {}
}
}

{
"name": "mnemosyne_export",
"description": "Export memories to a file for backup or migration.",
"parameters": {
  "type": "object",
  "required": ["output_path"],
  "properties": {
    "output_path": {
      "type": "string",
      "description": "File path for export (JSON format)."
    }
  }
}
}

{
"name": "mnemosyne_import",
"description": "Import memories from a previously exported file.",
"parameters": {
  "type": "object",
  "required": ["input_path"],
  "properties": {
    "input_path": {
      "type": "string",
      "description": "File path to import from (JSON format)."
    }
  }
}
}

{
"name": "mnemosyne_diagnose",
"description": "Run diagnostic checks on the memory system: database integrity, index health, storage stats.",
"parameters": {
  "type": "object",
  "properties": {}
}
}