name: memory-gateway-agent
runtime: hermes
version: 0.1.0
description: Hermes plugin adapter for Memory Gateway v1. Provides tools-only mode plus best-effort lifecycle hooks.
entrypoint: register
provides_tools:
  - memory_search
  - memory_append_episode
  - memory_commit_session
  - memory_upsert
  - memory_feedback
provides_hooks:
  - on_session_start
  - pre_llm_call
  - post_llm_call
  - on_session_end
env:
  MEMORY_GATEWAY_URL: http://127.0.0.1:1934
  MEMORY_GATEWAY_AUTO_SEARCH: "true"
  MEMORY_GATEWAY_AUTO_APPEND_EPISODE: "true"
  MEMORY_GATEWAY_AUTO_COMMIT_SESSION: "false"
tools:
  memory_search:
    description: Search Memory Gateway with user/agent/workspace/session ACL.
  memory_append_episode:
    description: Append a safe summarized candidate episode.
  memory_commit_session:
    description: Ask Gateway/EverMemOS to consolidate session episodes.
  memory_upsert:
    description: Upsert a stable memory through Gateway.
  memory_feedback:
    description: Send feedback for a memory record.
hooks:
  on_session_start: __init__:on_session_start
  pre_llm_call: __init__:pre_llm_call
  post_llm_call: __init__:post_llm_call
  on_session_end: __init__:on_session_end
notes:
  - Hooks are best-effort and depend on the Hermes runtime context API.
  - Without hook support, the plugin remains usable as tools-only.
  - This plugin does not store full raw conversations.