memleaf 0.2.19__tar.gz → 0.2.21__tar.gz

{memleaf-0.2.19 → memleaf-0.2.21}/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to memleaf are documented here.
 
+## 0.2.21 — 2026-09-03
+
+- Fix `memleaf install` for Hermes after the 12th MCP tool was added: the installer now uses the adapter's canonical tool-count constant instead of a stale private `11`.
+- Add a regression invariant that compares the Hermes installer count with the actual public MCP tool tuple, preventing future tool additions from silently breaking installation self-checks.
+- Correct the English README's stale 11-tool and 3-memory/6000-character descriptions so the published documentation matches the v0.2 retrieval contract.
+
+## 0.2.20 — 2026-09-03
+
+- Add `list_todos` for complete active todo retrieval across all scopes with stable pagination, date/status filtering, and current-turn retrieval gating.
+- Remove the managed-turn 3-memory / 6000-character aggregate read block while retaining the 2000-character page limit and audit counters.
+- Add first-class `todo.due_date` (`YYYY-MM-DD`) with evidence-grounded date normalization, update/history/compaction propagation, and legacy Markdown compatibility.
+- Improve automatic extraction so concrete unfinished actions become atomic todos and durable rules remain project/fact memories; mixed rule/action candidates are split or safely deferred without blocking valid siblings.
+- Keep permanent `knowledge/` globally visible to all sessions and supported Agents sharing the same Vault; provenance fields never filter active memory visibility.
+
 ## 0.2.19 — 2026-09-03
 
 - Keep Hermes `<untrusted_tool_result>` search audit status synchronized with

{memleaf-0.2.19/src/memleaf.egg-info → memleaf-0.2.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.19
+Version: 0.2.21
 Summary: A local-first Markdown memory core for AI agents
 Author: memleaf contributors
 License-Expression: MIT
@@ -23,8 +23,8 @@ Dynamic: license-file
 
 [English](README.en.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **当前版本：0.2.19。**
-> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.19 通过 PyPI 分发。
+> **当前版本：0.2.21。**
+> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.21 通过 PyPI 分发。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 
 ## 项目定位
@@ -69,12 +69,14 @@ memleaf 不会把整个 Vault 或整段历史对话自动塞进模型上下文
 4. 只有需要引用事实时，才使用同一轮返回的 `retrieval_id` 调用 `read`；
 5. 根据读取到的关键记忆回答，不把所有候选全部读完。
 
+当用户询问当前待办、所有未完成工作、紧急事项或某个日期范围内必须完成的事项时，使用 `list_todos`，默认覆盖所有 Scope；持续分页直到 `has_more=false`，再用同一个 `retrieval_id` 读取所有匹配待办正文。`source/session_id/turn_id` 只用于来源追踪，不参与永久 knowledge 可见性。
+
 当前限制：
 
 - Scope Map 最多 20 项、约 2000 字符；
 - search 候选单页最多 20 项、约 4000 字符；
 - read 单页正文最多 2000 字符；
-- 受管理轮次最多读取 3 个不同记忆、累计 6000 个正文字符；
+- 同一受管理轮次可继续读取所有与问题相关的记忆；`read_count`/`read_chars` 仅用于审计，不再作为阻断配额；
 - `retrieval_id` 必须属于当前轮次，且必须先有成功的 `search` 才能 `read`；
 - `found`、`no_match` 和工具错误是不同状态，错误不能被伪装成无匹配；
 - `context()` 和 Python `search(view="full")` 作为兼容接口保留，但不属于自动检索路径。
@@ -157,12 +159,12 @@ python -m pip install -U memleaf && python -m memleaf install
 4. 激活 `memory.provider=memleaf`；
 5. 通过 Hermes 官方 CLI 配置 memleaf MCP；
 6. 配置 MCP lazy/idle 生命周期；
-7. 验证 MCP Server 能发现 11 个工具；
+7. 验证 MCP Server 能发现 12 个工具；
 8. 写入本地 Agent 状态索引。
 
 完成后重启 Hermes。
 
-如果没有检测到 Hermes、无法取得完整模型路由、Provider 激活失败或 MCP 的 11 工具验证失败，安装会明确返回失败，不会把未完成的接入报告为成功。
+如果没有检测到 Hermes、无法取得完整模型路由、Provider 激活失败或 MCP 的 12 工具验证失败，安装会明确返回失败，不会把未完成的接入报告为成功。
 
 仓库中的 `install.sh` 保留给源码开发、离线源码安装和故障排查；普通 PyPI 用户不需要执行它。
 

{memleaf-0.2.19 → memleaf-0.2.21}/README.en.md

@@ -4,8 +4,8 @@
 
 [中文](README.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **Version: 0.2.19.**
-> The core library, Vault, stdio MCP server, initialization CLI, model routing, memory extraction, controlled retrieval protocol, and host adapters are implemented. memleaf 0.2.19 is distributed through PyPI.
+> **Version: 0.2.21.**
+> The core library, Vault, stdio MCP server, initialization CLI, model routing, memory extraction, controlled retrieval protocol, and host adapters are implemented. memleaf 0.2.21 is distributed through PyPI.
 > **The current release supports Hermes and Codex.** Antigravity is not detected, installed, or configured.
 
 ## Project scope
@@ -55,7 +55,7 @@ Current limits:
 - Scope Map: at most 20 items and approximately 2,000 characters per page;
 - search candidates: at most 20 items and approximately 4,000 characters per page;
 - one read page: at most 2,000 body characters;
-- managed turn: at most 3 distinct memory IDs and 6,000 body characters in total;
+- managed turn: all relevant memories may be read; `read_count` and `read_chars` are audit-only and do not block valid reads;
 - `retrieval_id` must belong to the current turn, and a successful `search` is required before `read`;
 - `found`, `no_match`, and tool errors are distinct states; an error must not be reported as no match;
 - `context()` and Python `search(view="full")` remain available for compatibility, but are not part of the automatic retrieval path.
@@ -80,6 +80,9 @@ Additional rules:
 - Model, parsing, write, or index failures keep the inbox and processing watermark retryable.
 - Automatic cleanup has a 24-hour safety period; a failed processing attempt does not delete the original capture.
 
+
+For current todos, all unfinished work, urgent items, or work due in a date range, use `list_todos`. It covers all scopes by default; continue until `has_more=false`, then read every matching todo body with the same `retrieval_id`. Provenance fields such as `source`, `session_id`, and `turn_id` never filter permanent knowledge visibility.
+
 ## Installation
 
 Python 3.11+ is required. The current release supports Hermes and Codex. Hermes is the default install target; Codex uses an explicit, separate install command.
@@ -138,12 +141,12 @@ Both installation paths automatically:
 4. Activate `memory.provider=memleaf`.
 5. Configure the memleaf MCP entry through Hermes' official CLI.
 6. Configure MCP lazy/idle lifecycle settings.
-7. Verify that the MCP server exposes all 11 tools.
+7. Verify that the MCP server exposes all 12 tools.
 8. Record the local Agent integration status.
 
 Restart Hermes after installation.
 
-If Hermes cannot be detected, no complete model route can be configured, Provider activation fails, or the 11-tool MCP verification fails, the installer returns an explicit failure rather than reporting an incomplete integration as successful.
+If Hermes cannot be detected, no complete model route can be configured, Provider activation fails, or the 12-tool MCP verification fails, the installer returns an explicit failure rather than reporting an incomplete integration as successful.
 
 The repository `install.sh` remains for source development, offline source installation, and troubleshooting. Normal PyPI users do not need to run it.
 
@@ -240,7 +243,7 @@ python -m memleaf.mcp_server --vault "$HOME/.memleaf"
 
 Without `--vault`, the server uses `~/.memleaf`; `MEMLEAF_VAULT` can also specify the Vault. In normal use the server does not need to be kept running manually: Hermes or Codex starts it on demand. stdout contains only JSON-RPC messages so logs do not corrupt the protocol stream.
 
-The server currently exposes 11 tools:
+The server currently exposes 12 tools:
 
 | Tool | Purpose |
 | --- | --- |
@@ -248,6 +251,7 @@ The server currently exposes 11 tools:
 | `context` | Compatibility directory; not used by the automatic retrieval path |
 | `scope_catalog` | Return Scopes, parents, and aliases without memory bodies |
 | `search` | Return a bounded candidate directory and `found`/`no_match` status |
+| `list_todos` | Enumerate current todo memories across scopes with status/date filters and pagination |
 | `read` | Read a selected memory body in pages using the current `retrieval_id` |
 | `process` | Process complete inbox turns under the admission rules |
 | `remember` | Create or update memory after an explicit request |
@@ -256,7 +260,7 @@ The server currently exposes 11 tools:
 | `rebuild_index` | Rebuild local derived indexes |
 | `stats` | Return Vault counts and diagnostic statistics |
 
-Search results are clues; a title alone is not a business fact. Managed retrieval must use the same `retrieval_id` for `search → read`. Tool errors, Scope conflicts, and exhausted read budgets must be handled as such.
+Search results are clues; a title alone is not a business fact. Managed retrieval must use the same `retrieval_id` for `search → read`. Tool errors, Scope conflicts, retrieval-turn violations, and read page/version errors must be handled as such.
 
 ## Python API
 

{memleaf-0.2.19 → memleaf-0.2.21}/README.md

@@ -4,8 +4,8 @@
 
 [English](README.en.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **当前版本：0.2.19。**
-> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.19 通过 PyPI 分发。
+> **当前版本：0.2.21。**
+> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.21 通过 PyPI 分发。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 
 ## 项目定位
@@ -50,12 +50,14 @@ memleaf 不会把整个 Vault 或整段历史对话自动塞进模型上下文
 4. 只有需要引用事实时，才使用同一轮返回的 `retrieval_id` 调用 `read`；
 5. 根据读取到的关键记忆回答，不把所有候选全部读完。
 
+当用户询问当前待办、所有未完成工作、紧急事项或某个日期范围内必须完成的事项时，使用 `list_todos`，默认覆盖所有 Scope；持续分页直到 `has_more=false`，再用同一个 `retrieval_id` 读取所有匹配待办正文。`source/session_id/turn_id` 只用于来源追踪，不参与永久 knowledge 可见性。
+
 当前限制：
 
 - Scope Map 最多 20 项、约 2000 字符；
 - search 候选单页最多 20 项、约 4000 字符；
 - read 单页正文最多 2000 字符；
-- 受管理轮次最多读取 3 个不同记忆、累计 6000 个正文字符；
+- 同一受管理轮次可继续读取所有与问题相关的记忆；`read_count`/`read_chars` 仅用于审计，不再作为阻断配额；
 - `retrieval_id` 必须属于当前轮次，且必须先有成功的 `search` 才能 `read`；
 - `found`、`no_match` 和工具错误是不同状态，错误不能被伪装成无匹配；
 - `context()` 和 Python `search(view="full")` 作为兼容接口保留，但不属于自动检索路径。
@@ -138,12 +140,12 @@ python -m pip install -U memleaf && python -m memleaf install
 4. 激活 `memory.provider=memleaf`；
 5. 通过 Hermes 官方 CLI 配置 memleaf MCP；
 6. 配置 MCP lazy/idle 生命周期；
-7. 验证 MCP Server 能发现 11 个工具；
+7. 验证 MCP Server 能发现 12 个工具；
 8. 写入本地 Agent 状态索引。
 
 完成后重启 Hermes。
 
-如果没有检测到 Hermes、无法取得完整模型路由、Provider 激活失败或 MCP 的 11 工具验证失败，安装会明确返回失败，不会把未完成的接入报告为成功。
+如果没有检测到 Hermes、无法取得完整模型路由、Provider 激活失败或 MCP 的 12 工具验证失败，安装会明确返回失败，不会把未完成的接入报告为成功。
 
 仓库中的 `install.sh` 保留给源码开发、离线源码安装和故障排查；普通 PyPI 用户不需要执行它。
 

{memleaf-0.2.19 → memleaf-0.2.21}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memleaf"
-version = "0.2.19"
+version = "0.2.21"
 description = "A local-first Markdown memory core for AI agents"
 readme = "README.md"
 requires-python = ">=3.11"

{memleaf-0.2.19 → memleaf-0.2.21}/src/memleaf/__init__.py

@@ -1,6 +1,6 @@
 """Local-first Markdown memory core for AI agents."""
 
-__version__ = "0.2.19"
+__version__ = "0.2.21"
 
 from .config import DEFAULT_CONFIG, default_config, load_config, save_config
 from .frontmatter import FrontmatterError, dump_frontmatter, dump_yaml, load_yaml, parse_frontmatter

{memleaf-0.2.19 → memleaf-0.2.21}/src/memleaf/adapters/hermes.py

@@ -24,7 +24,8 @@ from .base import (
 
 
 _MCP_IDLE_TIMEOUT_SECONDS = 60
-_MCP_EXPECTED_TOOL_COUNT = 11
+MCP_EXPECTED_TOOL_COUNT = 12
+_MCP_EXPECTED_TOOL_COUNT = MCP_EXPECTED_TOOL_COUNT
 
 
 def hermes_home_for_platform(
@@ -417,7 +418,7 @@ class HermesAdapter:
         self,
         detection: Detection | None = None,
         *,
-        expected_tools: int = _MCP_EXPECTED_TOOL_COUNT,
+        expected_tools: int = MCP_EXPECTED_TOOL_COUNT,
     ) -> bool:
         """Run the official MCP test and require the expected tool count."""
 

{memleaf-0.2.19 → memleaf-0.2.21}/src/memleaf/compaction.py

@@ -40,6 +40,7 @@ def _content_mapping(value: Memory | Mapping[str, Any]) -> dict[str, Any]:
             "keywords": list(value.keywords),
             "status": value.status,
             "completed_at": value.completed_at,
+            "due_date": value.due_date,
         }
     if not isinstance(value, Mapping):
         raise ValueError("memory content must be a memory or mapping")
@@ -54,6 +55,7 @@ def _content_mapping(value: Memory | Mapping[str, Any]) -> dict[str, Any]:
         "keywords": list(value.get("keywords", [])),
         "status": value.get("status"),
         "completed_at": value.get("completed_at"),
+        "due_date": value.get("due_date"),
     }
 
 
@@ -423,6 +425,7 @@ class Compactor:
                     "keywords",
                     "status",
                     "completed_at",
+                    "due_date",
                 )
             },
         }
@@ -511,6 +514,7 @@ class Compactor:
             last_hit_at=self._last_hit(source_memories),
             status=status,
             completed_at=summary.get("completed_at"),
+            due_date=summary.get("due_date"),
             extra=extra,
         )
         raw = memory.to_markdown()
@@ -540,6 +544,7 @@ class Compactor:
             and left.sources == right.sources
             and left.status == right.status
             and left.completed_at == right.completed_at
+            and left.due_date == right.due_date
             and left_extra == right_extra
         )
 
@@ -591,6 +596,8 @@ class Compactor:
         replacements: list[_Replacement] = []
         for summary in output["memories"]:
             source_ids = tuple(summary["source_memory_ids"])
+            if summary.get("type") == "todo" and len(source_ids) != 1:
+                raise CompactionError("independent todos cannot be merged by compaction")
             try:
                 source_candidates = [by_id[source_id.casefold()] for source_id in source_ids]
             except KeyError as error:
@@ -638,6 +645,7 @@ class Compactor:
             last_hit_at=source.memory.last_hit_at,
             status=source.memory.status,
             completed_at=source.memory.completed_at,
+            due_date=source.memory.due_date,
             extra=extra,
         )
         return history_id, historical, historical.to_markdown()

{memleaf-0.2.19 → memleaf-0.2.21}/src/memleaf/hermes_provider/__init__.py

@@ -268,8 +268,9 @@ def _scope_context(
         "<memleaf-scope-map>\n"
         "Available memleaf memory scopes. For every visible user turn, call "
         "memleaf MCP search at least once using the current conversation and "
-        "this map. Search returns a directory; read only the selected memory "
-        "when needed. A no-match result is valid.\n"
+        "this map. Use list_todos instead of relevance search for global current-todo questions. "
+        "Search/list_todos return directories; read only the selected memory when needed for ordinary "
+        "relevance queries; for global todo queries, read every matching todo item. A no-match result is valid.\n"
     )
     if isinstance(retrieval_id, str) and retrieval_id:
         prefix = (
@@ -421,11 +422,12 @@ def _hermes_search_status(value: Any) -> str:
                 return "error"
             valid_results = all(
                 isinstance(item, Mapping)
-                and set(item) == {"memory_id", "title"}
+                and set(item) in ({"memory_id", "title"}, {"memory_id", "title", "due_date"})
                 and isinstance(item.get("memory_id"), str)
                 and bool(item.get("memory_id"))
                 and isinstance(item.get("title"), str)
                 and bool(item.get("title"))
+                and ("due_date" not in item or item.get("due_date") is None or isinstance(item.get("due_date"), str))
                 for item in results
             )
             if not valid_results:
@@ -1953,8 +1955,12 @@ class MemleafMemoryProvider(MemoryProvider):
             "read(memory_id, retrieval_id) when its body is needed, carrying the "
             "current turn's retrieval_id exactly as supplied; a missing or mismatched "
             "token is a read failure, never a reason to fall back to a file tool. "
-            "Read more only if needed, and do not read all entries to filter unrelated "
-            "items. Hermes has a soft "
+            "Read more only if needed; for ordinary relevance queries, do not read all entries to filter unrelated items. "
+            "When the user asks for current "
+            "todos, all unfinished work, urgent work, or work due in a time range, call memleaf MCP "
+            "list_todos instead of relevance search; omit scope for a global query, follow every "
+            "next_cursor until has_more=false, and read every matching todo body with the same retrieval_id. "
+            "Never exclude a todo because another Hermes session or another Agent created it. Hermes has a soft "
             "observer only: do not claim a search happened unless the visible tool "
             "messages show it. Visible Hermes "
             "turns are durably captured into the local memleaf inbox. Automatic "
@@ -2155,7 +2161,7 @@ class MemleafMemoryProvider(MemoryProvider):
         search_results_used: set[int] = set()
         search_ordinal = 0
         for call in calls:
-            if call.get("name") != "mcp__memleaf__search":
+            if call.get("name") not in {"mcp__memleaf__search", "mcp__memleaf__list_todos"}:
                 continue
             search_ordinal += 1
             arguments = call.get("arguments")

{memleaf-0.2.19 → memleaf-0.2.21}/src/memleaf/hermes_provider/plugin.yaml

@@ -1,5 +1,5 @@
 name: memleaf
-version: 0.2.19
+version: 0.2.21
 description: "Hermes-native external MemoryProvider for local-first Markdown memory shared with the memleaf MCP server."
 hooks:
   - prefetch

{memleaf-0.2.19 → memleaf-0.2.21}/src/memleaf/host_events.py

@@ -32,6 +32,7 @@ from .retrieval_gate import (
     find_pending_continuation,
     mark_degraded,
     observe_search,
+    todo_filter_key,
     request_gate_retry,
     validate_turn,
 )
@@ -306,7 +307,11 @@ def _handle_codex_pre_tool(
     turn_id: str | None,
 ) -> dict[str, Any]:
     tool_name = _field(event, "tool_name", "toolName")
-    if not (_codex_memleaf_tool(tool_name, "search") or _codex_memleaf_tool(tool_name, "read")):
+    if not (
+        _codex_memleaf_tool(tool_name, "search")
+        or _codex_memleaf_tool(tool_name, "list_todos")
+        or _codex_memleaf_tool(tool_name, "read")
+    ):
         return {}
     if session_id is None or turn_id is None:
         return {}
@@ -385,26 +390,70 @@ def _codex_search_status(value: Any) -> str:
     return "error"
 
 
+
+def _codex_todo_result(value: Any) -> tuple[str, bool, str | None]:
+    result = _json_tool_result(value)
+    if not isinstance(result, Mapping) or result.get("isError") is True or "error" in result:
+        return "error", False, None
+    status = result.get("status")
+    items = result.get("results")
+    has_more = result.get("has_more")
+    next_cursor = result.get("next_cursor")
+    if status not in {"found", "no_match"} or not isinstance(items, list) or not isinstance(has_more, bool):
+        return "error", False, None
+    if not all(
+        isinstance(item, Mapping)
+        and set(item) == {"memory_id", "title", "due_date"}
+        and isinstance(item.get("memory_id"), str) and bool(item.get("memory_id"))
+        and isinstance(item.get("title"), str) and bool(item.get("title"))
+        and (item.get("due_date") is None or isinstance(item.get("due_date"), str))
+        for item in items
+    ):
+        return "error", False, None
+    if (has_more and not isinstance(next_cursor, str)) or (not has_more and next_cursor is not None):
+        return "error", False, None
+    if status == "found" and not items:
+        return "error", False, None
+    if status == "no_match" and items:
+        return "error", False, None
+    return status, has_more, next_cursor if isinstance(next_cursor, str) else None
+
+
 def _handle_codex_post_tool(
     runtime: HostRuntime,
     event: Mapping[str, Any],
     session_id: str | None,
     turn_id: str | None,
 ) -> dict[str, Any]:
-    if not _codex_memleaf_tool(_field(event, "tool_name", "toolName"), "search"):
-        return {}
-    if session_id is None or turn_id is None:
+    tool_name = _field(event, "tool_name", "toolName")
+    is_search = _codex_memleaf_tool(tool_name, "search")
+    is_todos = _codex_memleaf_tool(tool_name, "list_todos")
+    if not (is_search or is_todos) or session_id is None or turn_id is None:
         return {}
     tool_input = _field(event, "tool_input", "toolInput")
     call_id = _field(event, "tool_use_id", "toolUseId")
     if not isinstance(tool_input, Mapping) or not isinstance(call_id, str):
         return {}
-    runtime.observe_search(
+    if is_search:
+        runtime.observe_search(
+            session_id=session_id,
+            turn_id=turn_id,
+            status=_codex_search_status(_field(event, "tool_response", "toolResponse")),
+            call_id=call_id,
+            supplied_retrieval_id=tool_input.get("retrieval_id"),
+        )
+        return {}
+    status, has_more, next_cursor = _codex_todo_result(_field(event, "tool_response", "toolResponse"))
+    runtime.observe_todo_list(
         session_id=session_id,
         turn_id=turn_id,
-        status=_codex_search_status(_field(event, "tool_response", "toolResponse")),
+        status=status,
         call_id=call_id,
         supplied_retrieval_id=tool_input.get("retrieval_id"),
+        filter_key=todo_filter_key(tool_input),
+        cursor=tool_input.get("cursor") if isinstance(tool_input.get("cursor"), str) else None,
+        has_more=has_more,
+        next_cursor=next_cursor,
     )
     return {}
 

{memleaf-0.2.19 → memleaf-0.2.21}/src/memleaf/host_runtime.py

@@ -28,6 +28,7 @@ from .retrieval_gate import (
     find_turn,
     mark_degraded,
     observe_search,
+    observe_todo_list,
     request_gate_retry,
     validate_turn,
 )
@@ -40,9 +41,13 @@ _GATE_RETRY_REASON = (
     "a no-match result is acceptable."
 )
 _GATE_ERROR_REASON = (
-    "The memleaf search did not complete. Retry the memleaf search once before "
+    "The memleaf retrieval did not complete. Retry the memleaf memory tool once before "
     "answering; do not treat this error as no match."
 )
+_TODO_PAGINATION_REASON = (
+    "The global todo directory is incomplete. Continue memleaf list_todos with the returned "
+    "next_cursor until has_more=false before answering."
+)
 
 
 @dataclass(frozen=True)
@@ -250,6 +255,38 @@ class HostRuntime:
             return False
         return True
 
+    def observe_todo_list(
+        self,
+        *,
+        session_id: str,
+        turn_id: str,
+        status: str,
+        call_id: str,
+        supplied_retrieval_id: Any,
+        filter_key: str,
+        cursor: str | None,
+        has_more: bool,
+        next_cursor: str | None,
+    ) -> bool:
+        retrieval_id = self._retrieval_id(session_id, turn_id)
+        if retrieval_id is None or supplied_retrieval_id != retrieval_id or not isinstance(call_id, str) or not call_id:
+            return False
+        try:
+            observe_todo_list(
+                self.vault,
+                retrieval_id,
+                status,
+                call_id,
+                filter_key=filter_key,
+                cursor=cursor,
+                has_more=has_more,
+                next_cursor=next_cursor,
+                current_source=self.host,
+            )
+        except RetrievalGateError:
+            return False
+        return True
+
     def complete_turn(
         self,
         *,
@@ -277,7 +314,8 @@ class HostRuntime:
                 if gate_state.get("status") == "DEGRADED":
                     degraded = True
 
-            if gate_state is not None and gate_state.get("status") in {"NOT_SEARCHED", "ERROR"}:
+            todo_pending = gate_state is not None and gate_state.get("todo_list_pending") is True
+            if gate_state is not None and (gate_state.get("status") in {"NOT_SEARCHED", "ERROR"} or todo_pending):
                 retries = int(gate_state.get("gate_retries", 0) or 0)
                 if retries < MAX_GATE_RETRIES:
                     try:
@@ -286,7 +324,9 @@ class HostRuntime:
                         pass
                     else:
                         reason = (
-                            _GATE_ERROR_REASON
+                            _TODO_PAGINATION_REASON
+                            if todo_pending
+                            else _GATE_ERROR_REASON
                             if gate_state.get("status") == "ERROR"
                             else _GATE_RETRY_REASON
                         )

{memleaf-0.2.19 → memleaf-0.2.21}/src/memleaf/installer.py

@@ -19,14 +19,17 @@ from typing import Any
 from . import __version__
 from .adapters.base import update_agents_index
 from .adapters.codex import CodexAdapter
-from .adapters.hermes import HermesAdapter, hermes_home_for_platform
+from .adapters.hermes import (
+    HermesAdapter,
+    MCP_EXPECTED_TOOL_COUNT,
+    hermes_home_for_platform,
+)
 from .cli import _home_from_environment, _prepare_model_route
 from .locking import atomic_write_json
 from .native_registration import ensure_hermes_native_sources
 from .vault import Vault
 
 
-_EXPECTED_TOOLS = 11
 _PROVIDER_VERSION_RE = re.compile(r"^version:\s*([^\s#]+)\s*(?:#.*)?$", re.MULTILINE)
 
 
@@ -401,14 +404,14 @@ def install_hermes(*, vault_path: Path | None = None) -> dict[str, Any]:
             "provider": str(provider_path),
             "model": model,
         }
-    if not adapter.test_mcp(detection, expected_tools=_EXPECTED_TOOLS):
+    if not adapter.test_mcp(detection, expected_tools=MCP_EXPECTED_TOOL_COUNT):
         update_agents_index(
             vault.agents_index_path,
             {"hermes": {"mcp_status": "failed", "mcp_availability": "unavailable"}},
         )
         return {
             "status": "failure",
-            "reason": "Hermes MCP test did not confirm 11 tools",
+            "reason": f"Hermes MCP test did not confirm {MCP_EXPECTED_TOOL_COUNT} tools",
             "core_version": core_version,
             "provider_version": provider_version,
             "vault": str(vault.root),