librefang-registry/plugins/mempalace-indexer/plugin.toml

name = "mempalace-indexer"
version = "0.3.0"
description = "Auto-index conversations into MemPalace and recall relevant memories. No API keys, no cloud."
author = "LibreFang Community"
requirements = "requirements.txt"
librefang_min_version = "2026.4.0"

# ---------------------------------------------------------------------------
# Hook execution settings
#
# MUST sit above [hooks] so they land on the top-level table instead of being
# folded into [hooks] by TOML table scoping rules (validate.py iterates
# data["hooks"].items() expecting every value to be a hook file path).
# ---------------------------------------------------------------------------

# ingest is fast (vector search) — 30 s is generous.
# after_turn does classification + write — 60 s covers a slow machine or large turn.
hook_timeout_secs = 30

# A temporary mempalace outage should not block the agent turn.
on_hook_failure = "warn"

# One silent retry handles transient ChromaDB lock contention.
max_retries = 1
retry_delay_ms = 500

# Python interpreter startup is ~200 ms. Keep subprocesses alive between calls
# to eliminate that overhead on every user message.
persistent_subprocess = true

# ingest results are deterministic for the same message text — cache for 60 s
# to avoid redundant embedding lookups on rapid follow-up turns.
hook_cache_ttl_secs = 60

# Priority 0 (default). Raise to e.g. 10 to run before other recall plugins.
priority = 0

# ---------------------------------------------------------------------------
# System binary requirements
# ---------------------------------------------------------------------------

[[requires]]
binary = "python3"
install_hint = "Install Python 3.9+ from https://python.org or via your system package manager (apt install python3 / brew install python)"

# ---------------------------------------------------------------------------
# Hook scripts
#
# Every value in this section MUST be a path relative to the plugin directory.
# Execution settings live above at the top level.
# ---------------------------------------------------------------------------

[hooks]
ingest = "hooks/ingest.py"
after_turn = "hooks/after_turn.py"

# ---------------------------------------------------------------------------
# [config] — user-configurable settings
#
# The runtime merges user overrides with these defaults and writes the result
# as JSON to the path in LIBREFANG_PLUGIN_CONFIG before each hook subprocess.
# Hooks should read that file (falling back to environment variables for
# backward compatibility with direct invocation).
# ---------------------------------------------------------------------------

[config.palace_path]
type = "string"
default = "~/.mempalace/palace"
description = "Path to the MemPalace directory (passed to mempalace APIs and ChromaDB)."

[config.min_chars]
type = "number"
default = 80
description = "Minimum character length of extracted conversation text to be worth saving. Shorter exchanges are skipped by after_turn."

[config.window_size]
type = "number"
default = 6
description = "Number of recent messages the after_turn hook considers when extracting text (sliding window from the end of the conversation)."

[config.dedup_max]
type = "number"
default = 500
description = "Maximum number of SHA-256 content hashes kept in the per-agent deduplication store. Oldest entries are dropped first when the cap is reached."

[config.lang_detect]
type = "boolean"
default = true
description = "Enable language detection via langdetect. When true, non-English exchanges bypass the English keyword relevance filter and are indexed on length alone."

[config.max_chars]
type = "number"
default = 300
description = "Maximum characters per injected memory snippet in the ingest hook. Longer texts are truncated at the nearest word boundary."

[config.min_similarity]
type = "number"
default = 0.3
description = "Minimum similarity score (0-1, higher = more relevant) for memories returned by the ingest hook. Results below this threshold are dropped. Set to 0 to disable filtering."

[config.n_results]
type = "number"
default = 5
description = "Number of memories the ingest hook retrieves from MemPalace per turn."

[config.max_age_days]
type = "number"
default = 90
description = "Prune drawers older than this many days when running hooks/prune.py. Set to 0 to disable TTL pruning."

# ---------------------------------------------------------------------------
# [integrity] — SHA-256 hashes verified at load time
#
# Regenerate after editing hook files:
#   sha256sum hooks/ingest.py hooks/after_turn.py hooks/prune.py
# ---------------------------------------------------------------------------

[integrity]
"hooks/ingest.py" = "621b17f2d0afbd6142a49963fb57187a500cfeac057c13cb80961b6222bd03e2"
"hooks/after_turn.py" = "1c5bcdade4ca0d785878d60910105208fcff38f74872426ee821363ce5bf9811"
"hooks/prune.py" = "2dceeb9bb0d0b7ee224291bfce600f629f38b4a853cd437774d9b66ef226838d"


[i18n.zh]
name = "MemPalace 索引器"
description = "自动把对话索引进 MemPalace 并召回相关记忆。无需 API key、不依赖云端。"

[i18n.zh-TW]
name = "MemPalace 索引器"
description = "自動將對話索引進 MemPalace 並召回相關記憶。無需 API key、不依賴雲端。"

[i18n.ja]
name = "MemPalace インデクサ"
description = "会話を MemPalace に自動索引し関連メモリを想起。API キー不要・クラウド不要。"

[i18n.ko]
name = "MemPalace 인덱서"
description = "대화를 MemPalace에 자동 색인하고 관련 기억을 회상. API 키 불필요, 클라우드 불필요."

[i18n.de]
name = "MemPalace-Indexer"
description = "Indiziert Gespräche automatisch in MemPalace und ruft passende Erinnerungen ab. Ohne API-Keys, ohne Cloud."

[i18n.es]
name = "Indexador MemPalace"
description = "Indexa automáticamente las conversaciones en MemPalace y recupera memorias relevantes. Sin API keys ni cloud."

[i18n.fr]
name = "Indexeur MemPalace"
description = "Indexe automatiquement les conversations dans MemPalace et rappelle les mémoires pertinentes. Sans clé d'API, sans cloud."