hermes-agentmemory-capture 0.1.0__py3-none-any.whl

hermes_agentmemory_capture/__init__.py

@@ -0,0 +1,104 @@
+"""hermes-agentmemory-capture: captura automática hacia AgentMemory.
+
+Port del plugin `agentmemory-capture` de OpenCode. Suscribe hooks del
+ciclo de Hermes y los reenvía como observaciones al backend
+(`POST /agentmemory/observe`). Todo es fail-open: un fallo de red o del
+backend jamás interrumpe el turno (los callbacks devuelven None y el
+transporte traga excepciones).
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+
+from .capture import observe
+
+logger = logging.getLogger(__name__)
+
+
+def _project() -> tuple[str, str]:
+    """(project, cwd): basename del directorio de trabajo actual."""
+    cwd = os.getcwd()
+    return os.path.basename(cwd) or cwd, cwd
+
+
+def _sid(kwargs: dict) -> str:
+    return str(kwargs.get("session_id") or kwargs.get("task_id") or "unknown")
+
+
+def on_session_start(**kwargs) -> None:
+    project, cwd = _project()
+    observe(_sid(kwargs), "session_created",
+            {"profile": kwargs.get("profile_name"), "surface": kwargs.get("surface")},
+            project, cwd)
+
+
+def on_session_end(**kwargs) -> None:
+    project, cwd = _project()
+    observe(_sid(kwargs), "session_end",
+            {"reason": kwargs.get("reason")}, project, cwd)
+
+
+def pre_tool_call(tool_name: str = "", args: dict | None = None, **kwargs) -> None:
+    # IMPORTANTE: devolver None. Un dict con {"action": "block"} vetaría
+    # la herramienta; este plugin solo observa.
+    project, cwd = _project()
+    observe(_sid(kwargs), "pre_tool_call",
+            {"tool": tool_name, "args": args or {}}, project, cwd)
+
+
+def post_tool_call(tool_name: str = "", args: dict | None = None, result=None,
+                   status: str | None = None, duration_ms: int = 0, **kwargs) -> None:
+    project, cwd = _project()
+    ok = (status or "ok") == "ok"
+    observe(_sid(kwargs), "post_tool_use" if ok else "post_tool_failure",
+            {"tool": tool_name, "args": args or {}, "result": result,
+             "status": status or "ok", "duration_ms": duration_ms},
+            project, cwd)
+
+
+def pre_llm_call(**kwargs) -> None:
+    project, cwd = _project()
+    observe(_sid(kwargs), "prompt_submit",
+            {"model": kwargs.get("model")}, project, cwd)
+
+
+def post_llm_call(**kwargs) -> None:
+    project, cwd = _project()
+    observe(_sid(kwargs), "assistant_message",
+            {"model": kwargs.get("model"),
+             "stop_reason": kwargs.get("stop_reason")}, project, cwd)
+
+
+def subagent_start(**kwargs) -> None:
+    project, cwd = _project()
+    observe(_sid(kwargs), "subagent_start", {"goal": kwargs.get("goal")}, project, cwd)
+
+
+def subagent_stop(**kwargs) -> None:
+    project, cwd = _project()
+    observe(_sid(kwargs), "subagent_stop",
+            {"status": kwargs.get("status")}, project, cwd)
+
+
+HOOKS = {
+    "on_session_start": on_session_start,
+    "on_session_end": on_session_end,
+    "pre_tool_call": pre_tool_call,
+    "post_tool_call": post_tool_call,
+    "pre_llm_call": pre_llm_call,
+    "post_llm_call": post_llm_call,
+    "subagent_start": subagent_start,
+    "subagent_stop": subagent_stop,
+}
+
+
+def register(ctx) -> None:
+    """Entry point del plugin — lo llama el loader de Hermes."""
+    for name, callback in HOOKS.items():
+        ctx.register_hook(name, callback)
+    logger.info("hermes-agentmemory-capture: %d hooks registrados", len(HOOKS))
+
+
+__all__ = ["register", "HOOKS"]

hermes_agentmemory_capture/capture.py

@@ -0,0 +1,108 @@
+"""Transporte fail-open hacia el backend AgentMemory.
+
+Replica el comportamiento de `post()` en
+`agentmemory-capture.ts` de OpenCode: POST best-effort con timeout corto,
+Bearer con AGENTMEMORY_SECRET, y resolución del secreto (env → ~/.agentmemory).
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import os
+import urllib.request
+from datetime import datetime, timezone
+from pathlib import Path
+
+logger = logging.getLogger(__name__)
+
+TIMEOUT_S = 5
+MAX_DATA_CHARS = 4000
+
+
+def backend_url() -> str:
+    return (os.environ.get("AGENTMEMORY_URL") or "http://localhost:3111").rstrip("/")
+
+
+def _usable(value: object) -> str:
+    text = value.strip() if isinstance(value, str) else ""
+    if not text or (text.startswith("${") and text.endswith("}")):
+        return ""
+    return text
+
+
+def _file_secret() -> str:
+    """Secreto guardado por el propio backend (~/.agentmemory/.env o secret)."""
+    home = Path.home() / ".agentmemory"
+    try:
+        for line in (home / ".env").read_text(encoding="utf-8").splitlines():
+            line = line.strip()
+            if not line or line.startswith("#") or "=" not in line:
+                continue
+            key, _, value = line.partition("=")
+            if key.removeprefix("export ").strip() != "AGENTMEMORY_SECRET":
+                continue
+            value = value.strip()
+            if value[:1] in ("'", '"'):
+                end = value.find(value[0], 1)
+                value = value[1:end] if end > 0 else value[1:]
+            found = _usable(value)
+            if found:
+                return found
+    except OSError:
+        pass
+    try:
+        return _usable((home / "secret").read_text(encoding="utf-8"))
+    except OSError:
+        return ""
+
+
+def _is_loopback(url: str) -> bool:
+    return "localhost" in url or "127.0.0.1" in url or "::1" in url
+
+
+def resolve_secret() -> str:
+    configured = _usable(os.environ.get("AGENTMEMORY_SECRET", ""))
+    if configured:
+        return configured
+    if _is_loopback(backend_url()):
+        return _file_secret()
+    return ""
+
+
+def _trim(value: object) -> object:
+    if isinstance(value, str) and len(value) > MAX_DATA_CHARS:
+        return value[:MAX_DATA_CHARS] + "…[truncado]"
+    if isinstance(value, dict):
+        return {k: _trim(v) for k, v in value.items()}
+    if isinstance(value, (list, tuple)):
+        return [_trim(v) for v in value]
+    return value
+
+
+def observe(session_id: str, hook_type: str, data: dict, project: str = "", cwd: str = "") -> bool:
+    """Envía una observación al backend. Nunca lanza: fail-open por diseño."""
+    try:
+        secret = resolve_secret()
+        body = json.dumps({
+            "hookType": hook_type,
+            "sessionId": session_id or "unknown",
+            "project": project,
+            "cwd": cwd,
+            "timestamp": datetime.now(timezone.utc).isoformat(),
+            "data": _trim(data),
+        }).encode("utf-8")
+        headers = {"Content-Type": "application/json"}
+        if secret:
+            headers["Authorization"] = f"Bearer {secret}"
+        request = urllib.request.Request(
+            f"{backend_url()}/agentmemory/observe",
+            data=body,
+            headers=headers,
+            method="POST",
+        )
+        with urllib.request.urlopen(request, timeout=TIMEOUT_S) as response:
+            return 200 <= response.status < 300
+    except Exception as exc:  # noqa: BLE001 — un hook jamás debe romper el turno
+        logger.debug("agentmemory-capture: POST /observe falló: %s", exc)
+        return False

hermes_agentmemory_capture-0.1.0.dist-info/METADATA

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: hermes-agentmemory-capture
+Version: 0.1.0
+Summary: Captura automática de sesiones y herramientas de Hermes hacia AgentMemory
+Author: herjarsa
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# hermes-agentmemory-capture
+
+Port del plugin `agentmemory-capture` de OpenCode a Hermes: captura
+automática de sesiones y uso de herramientas hacia AgentMemory.
+
+Estado: **funcional (HITO 2)** — 8 hooks activos, transporte verificado
+contra backend real. Ver `SPEC.md` para el mapeo y gaps.
+
+## Requisitos
+
+- Backend AgentMemory corriendo (este equipo: `http://localhost:3111` vía pm2).
+- Env vars (sin hardcodear secretos):
+  - `AGENTMEMORY_URL` (ej. `http://localhost:3111`)
+  - `AGENTMEMORY_SECRET`
+
+## Instalación
+
+```bash
+hermes plugins install herjarsa/hermes-agentmemory-capture --yes-deps --enable
+hermes plugins list   # debe salir enabled
+```
+
+### Vía pip (PyPI)
+
+```bash
+pip install hermes-agentmemory-capture
+```
+
+Descubierto automáticamente por Hermes vía entry point
+`hermes_agent.plugins` (requiere reiniciar la sesión).
+
+## Verificación
+
+Captura de prueba → comprobar con las tools MCP `memory_*` o el viewer
+de AgentMemory que el turno quedó registrado.

hermes_agentmemory_capture-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+hermes_agentmemory_capture/__init__.py,sha256=kcNeWw4CpkoG1akaxibspxtWB8i_V7Gk8FGxbEbO77c,3346
+hermes_agentmemory_capture/capture.py,sha256=2yMMSbNK5NiysYCnhYVxDkzOoqfVQ5MmiTKygM9r8FM,3548
+hermes_agentmemory_capture-0.1.0.dist-info/licenses/LICENSE,sha256=3aCX5s5aqXhK_is4S0O6OgDYYXECyUgRsy9XXhmQlXk,1065
+hermes_agentmemory_capture-0.1.0.dist-info/METADATA,sha256=2cSVXalq0MHZ5Jm_uNjaONT4zb2cuG1i4u88Wn_4r6I,1278
+hermes_agentmemory_capture-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+hermes_agentmemory_capture-0.1.0.dist-info/entry_points.txt,sha256=Ulu07p0d0NbuOohkHBPuIaWnlsPsphTDSoeYSYlox84,79
+hermes_agentmemory_capture-0.1.0.dist-info/top_level.txt,sha256=7KvxGQ67xzuDsQLRerAPh5nGf9ow7VteiUEZ3HM0WwM,27
+hermes_agentmemory_capture-0.1.0.dist-info/RECORD,,

hermes_agentmemory_capture-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

hermes_agentmemory_capture-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[hermes_agent.plugins]
+hermes-agentmemory-capture = hermes_agentmemory_capture

hermes_agentmemory_capture-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 herjarsa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hermes_agentmemory_capture-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+hermes_agentmemory_capture