memorius 0.2.0__tar.gz → 0.3.0__tar.gz

{memorius-0.2.0/memorius.egg-info → memorius-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memorius
-Version: 0.2.0
+Version: 0.3.0
 Summary: Self-contained memory vault for any AI agent — vector search, session diaries, and agent-agnostic hooks.
 Author-email: dimonapatrick243 <dimona.patrick@gmail.com>
 License-Expression: MIT
@@ -37,15 +37,36 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Dynamic: license-file
 
 # Memorius
+<img width="1584" height="672" alt="memorius" src="https://github.com/user-attachments/assets/1a62163d-1ff5-4112-8b8f-1a6b19afab7a" />
+
+<p align="center">
+  <strong>Universal memory vault for any AI agent.</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/memorius/"><img src="https://img.shields.io/pypi/v/memorius?color=blue" alt="PyPI version"></a>
+  <a href="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/test.yml"><img src="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/test.yml/badge.svg" alt="Tests"></a>
+  <a href="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/publish.yml"><img src="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/publish.yml/badge.svg" alt="PyPI publish"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license"></a>
+  <a href="https://python.org"><img src="https://img.shields.io/badge/python-3.11%20%7C%203.12-blue" alt="Python 3.11 | 3.12"></a>
+</p>
+
+> 🧠 **Works with Claude Code, Codex CLI, Gemini CLI, OpenClaude, OpenCode, Pi, and any MCP-compatible agent.**
+>
+> 🌐 **Landing page:** https://dream-pixels-forge.github.io/memorius/
 
-**Universal memory vault for any AI agent.**
+## Why Memorius?
 
-> 🌐 **Landing page:** https://dream-pixels-forge.github.io/memorius/
+Most AI memory tools lock you into one agent ecosystem. Memorius is **agent-agnostic by design** — the same memory vault works whether you use Claude Code, Codex CLI, Gemini CLI, or any MCP-compatible agent. No vendor lock-in.
 
-Memorius is a self-contained, agent-agnostic memory system that gives LLMs and AI
-agents persistent, searchable memory with a hierarchical knowledge organization.
-Drop-in with multi-backend vector storage, pluggable embeddings, built-in MCP + REST
-servers, and auto-detecting agent hooks for **7 different AI coding agents**.
+| Feature | Memorius | Others |
+|---------|----------|--------|
+| Agent support | **7 agents** (auto-detected) | Usually 1-3 |
+| Protocol | **Open MCP standard** | Proprietary plugins |
+| Memory hierarchy | Vault → Shelf → Folder → Note | Flat |
+| Obsidian integration | Native import/export | ❌ |
+| Self-hosted | ✅ No cloud dependency | Often SaaS |
+| Open source | ✅ MIT license | Varies |
 
 ```bash
 pip install memorius
@@ -224,6 +245,59 @@ Available MCP tools:
 | `memorius_diary_write` | Write session diary entry |
 | `memorius_diary_list` | List diary entries |
 | `memorius_vault_ls` | Browse vault hierarchy |
+| `memorius_consolidate` | Merge duplicate memories, extract insights |
+| `memorius_extract` | Extract structured memories from conversation (LLM) |
+| `memorius_factcheck` | Fact-check a statement against stored memories |
+| `memorius_context` | Get formatted memory context for injection |
+| `memorius_session_profile` | Build session memory profile for inheritance |
+| `memorius_graph_stats` | Knowledge graph statistics |
+| `memorius_memory_stats` | Memory tracking statistics |
+
+## Agent Skill Installation
+
+Memorius ships with a ready-to-use agent skill (`skills/memorius/SKILL.md`) for agents that support the Hermes Agent skill format. The skill provides auto-capture rules, smart context injection, session diary templates, and workflow patterns — so agents can use memorius proactively without being told.
+
+### Skill Structure
+
+```
+skills/
+  memorius/
+    SKILL.md              # Full skill definition (auto-capture, context injection, diary rules)
+    README.md             # Quick command reference
+    .memorius_version     # Version tracker
+```
+
+### Installing for Hermes Agent
+
+The skill is designed for [Hermes Agent](https://hermes-agent.nousresearch.com) — copy it into your Hermes skills directory:
+
+```bash
+# Copy the skill
+cp -r skills/memorius ~/.hermes/skills/
+
+# Verify it's loaded
+hermes skills list | grep memorius
+```
+
+Once installed, Hermes will automatically detect it and follow the skill's workflows.
+
+### Installing for Other Agents
+
+Agents that don't use the Hermes skill format can still use memorius via MCP or CLI:
+
+| Agent | Install Command |
+|-------|----------------|
+| Claude Code | `claude mcp add memorius -- memorius serve` |
+| Codex CLI | `codex mcp add memorius -- memorius serve` |
+| Gemini CLI | `gemini mcp add memorius $(which memorius) serve` |
+| Cursor | Add to `.cursor/mcp.json`: `{"mcpServers": {"memorius": {"command": "memorius", "args": ["serve"]}}}` |
+| Aider | `aider --mcp-servers memorius=memorius serve` |
+| Continue | Add memorius to `.continue/config.json` MCP servers |
+| OpenClaw | `openclaw mcp set memorius '{"command":"memorius","args":["serve"]}'` |
+
+See `manifest.yaml` for the full list of supported agents and their install commands.
+
+Copying the SKILL.md file directly may also work for agents with their own skills directory (e.g. `~/.claude/skills/`, `~/.codex/skills/`) — check your agent's documentation.
 
 ## REST API
 
@@ -234,12 +308,21 @@ memorius serve-rest
 | Method | Path | Description |
 |---|---|---|
 | GET | `/health` | Health check |
+| GET | `/status` | System status |
+| GET | `/stats` | Full vault + memory + graph stats |
 | POST | `/store` | Store a memory |
 | POST | `/search` | Semantic search |
-| POST | `/mine` | Extract memories |
-| GET | `/status` | System status |
+| POST | `/mine` | Extract memories from transcript |
 | POST | `/diary` | Write diary entry |
-| GET | `/palace` | Browse hierarchy |
+| GET | `/vault` | Browse vault hierarchy |
+| GET | `/diaries` | List recent diary entries |
+| POST | `/consolidate` | Merge duplicate memories |
+| POST | `/extract` | Extract memories from conversation (LLM) |
+| POST | `/factcheck` | Fact-check statement against vault |
+| POST | `/context` | Get formatted memory context for injection |
+| GET | `/obsidian` | List notes in Obsidian vault |
+| POST | `/obsidian/import` | Import Obsidian notes as memories |
+| POST | `/obsidian/export` | Export memories as Obsidian notes |
 
 ## Agent Hooks
 

{memorius-0.2.0 → memorius-0.3.0}/README.md

@@ -1,13 +1,34 @@
 # Memorius
+<img width="1584" height="672" alt="memorius" src="https://github.com/user-attachments/assets/1a62163d-1ff5-4112-8b8f-1a6b19afab7a" />
+
+<p align="center">
+  <strong>Universal memory vault for any AI agent.</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/memorius/"><img src="https://img.shields.io/pypi/v/memorius?color=blue" alt="PyPI version"></a>
+  <a href="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/test.yml"><img src="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/test.yml/badge.svg" alt="Tests"></a>
+  <a href="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/publish.yml"><img src="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/publish.yml/badge.svg" alt="PyPI publish"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license"></a>
+  <a href="https://python.org"><img src="https://img.shields.io/badge/python-3.11%20%7C%203.12-blue" alt="Python 3.11 | 3.12"></a>
+</p>
+
+> 🧠 **Works with Claude Code, Codex CLI, Gemini CLI, OpenClaude, OpenCode, Pi, and any MCP-compatible agent.**
+>
+> 🌐 **Landing page:** https://dream-pixels-forge.github.io/memorius/
 
-**Universal memory vault for any AI agent.**
+## Why Memorius?
 
-> 🌐 **Landing page:** https://dream-pixels-forge.github.io/memorius/
+Most AI memory tools lock you into one agent ecosystem. Memorius is **agent-agnostic by design** — the same memory vault works whether you use Claude Code, Codex CLI, Gemini CLI, or any MCP-compatible agent. No vendor lock-in.
 
-Memorius is a self-contained, agent-agnostic memory system that gives LLMs and AI
-agents persistent, searchable memory with a hierarchical knowledge organization.
-Drop-in with multi-backend vector storage, pluggable embeddings, built-in MCP + REST
-servers, and auto-detecting agent hooks for **7 different AI coding agents**.
+| Feature | Memorius | Others |
+|---------|----------|--------|
+| Agent support | **7 agents** (auto-detected) | Usually 1-3 |
+| Protocol | **Open MCP standard** | Proprietary plugins |
+| Memory hierarchy | Vault → Shelf → Folder → Note | Flat |
+| Obsidian integration | Native import/export | ❌ |
+| Self-hosted | ✅ No cloud dependency | Often SaaS |
+| Open source | ✅ MIT license | Varies |
 
 ```bash
 pip install memorius
@@ -186,6 +207,59 @@ Available MCP tools:
 | `memorius_diary_write` | Write session diary entry |
 | `memorius_diary_list` | List diary entries |
 | `memorius_vault_ls` | Browse vault hierarchy |
+| `memorius_consolidate` | Merge duplicate memories, extract insights |
+| `memorius_extract` | Extract structured memories from conversation (LLM) |
+| `memorius_factcheck` | Fact-check a statement against stored memories |
+| `memorius_context` | Get formatted memory context for injection |
+| `memorius_session_profile` | Build session memory profile for inheritance |
+| `memorius_graph_stats` | Knowledge graph statistics |
+| `memorius_memory_stats` | Memory tracking statistics |
+
+## Agent Skill Installation
+
+Memorius ships with a ready-to-use agent skill (`skills/memorius/SKILL.md`) for agents that support the Hermes Agent skill format. The skill provides auto-capture rules, smart context injection, session diary templates, and workflow patterns — so agents can use memorius proactively without being told.
+
+### Skill Structure
+
+```
+skills/
+  memorius/
+    SKILL.md              # Full skill definition (auto-capture, context injection, diary rules)
+    README.md             # Quick command reference
+    .memorius_version     # Version tracker
+```
+
+### Installing for Hermes Agent
+
+The skill is designed for [Hermes Agent](https://hermes-agent.nousresearch.com) — copy it into your Hermes skills directory:
+
+```bash
+# Copy the skill
+cp -r skills/memorius ~/.hermes/skills/
+
+# Verify it's loaded
+hermes skills list | grep memorius
+```
+
+Once installed, Hermes will automatically detect it and follow the skill's workflows.
+
+### Installing for Other Agents
+
+Agents that don't use the Hermes skill format can still use memorius via MCP or CLI:
+
+| Agent | Install Command |
+|-------|----------------|
+| Claude Code | `claude mcp add memorius -- memorius serve` |
+| Codex CLI | `codex mcp add memorius -- memorius serve` |
+| Gemini CLI | `gemini mcp add memorius $(which memorius) serve` |
+| Cursor | Add to `.cursor/mcp.json`: `{"mcpServers": {"memorius": {"command": "memorius", "args": ["serve"]}}}` |
+| Aider | `aider --mcp-servers memorius=memorius serve` |
+| Continue | Add memorius to `.continue/config.json` MCP servers |
+| OpenClaw | `openclaw mcp set memorius '{"command":"memorius","args":["serve"]}'` |
+
+See `manifest.yaml` for the full list of supported agents and their install commands.
+
+Copying the SKILL.md file directly may also work for agents with their own skills directory (e.g. `~/.claude/skills/`, `~/.codex/skills/`) — check your agent's documentation.
 
 ## REST API
 
@@ -196,12 +270,21 @@ memorius serve-rest
 | Method | Path | Description |
 |---|---|---|
 | GET | `/health` | Health check |
+| GET | `/status` | System status |
+| GET | `/stats` | Full vault + memory + graph stats |
 | POST | `/store` | Store a memory |
 | POST | `/search` | Semantic search |
-| POST | `/mine` | Extract memories |
-| GET | `/status` | System status |
+| POST | `/mine` | Extract memories from transcript |
 | POST | `/diary` | Write diary entry |
-| GET | `/palace` | Browse hierarchy |
+| GET | `/vault` | Browse vault hierarchy |
+| GET | `/diaries` | List recent diary entries |
+| POST | `/consolidate` | Merge duplicate memories |
+| POST | `/extract` | Extract memories from conversation (LLM) |
+| POST | `/factcheck` | Fact-check statement against vault |
+| POST | `/context` | Get formatted memory context for injection |
+| GET | `/obsidian` | List notes in Obsidian vault |
+| POST | `/obsidian/import` | Import Obsidian notes as memories |
+| POST | `/obsidian/export` | Export memories as Obsidian notes |
 
 ## Agent Hooks
 

{memorius-0.2.0 → memorius-0.3.0}/memorius/__init__.py

@@ -26,4 +26,4 @@ Architecture:
     memorius:  Main CLI — init, mine, search, diary, status, serve, hook
 """
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"

{memorius-0.2.0 → memorius-0.3.0}/memorius/cli/obsidian.py

@@ -13,6 +13,7 @@ from __future__ import annotations
 
 import json
 import logging
+import os
 import re
 from pathlib import Path
 from typing import Any
@@ -34,7 +35,11 @@ OBSIDIAN_VAULT_HINT = (
 
 def _resolve_vault_path(vault_arg: str | None) -> Path:
     """Resolve the Obsidian vault path from arg, env var, or default."""
-    raw = vault_arg or Path.home().as_posix() + "/Documents/Obsidian Vault"
+    raw = (
+        vault_arg
+        or os.environ.get("OBSIDIAN_VAULT_PATH")
+        or Path.home().as_posix() + "/Documents/Obsidian Vault"
+    )
     path = Path(raw).expanduser().resolve()
     return path
 

{memorius-0.2.0 → memorius-0.3.0}/memorius/context_inject.py

@@ -12,7 +12,6 @@ from __future__ import annotations
 import json
 import logging
 import re
-from datetime import datetime, timezone
 from typing import Any
 
 logger = logging.getLogger("memorius.context")

{memorius-0.2.0 → memorius-0.3.0}/memorius/factcheck.py

@@ -14,6 +14,15 @@ from typing import Any
 
 logger = logging.getLogger("memorius.factcheck")
 
+# Confidence scoring constants
+DEFAULT_SIMILARITY_THRESHOLD = 0.7
+CONTRADICTION_CONFIDENCE_PER_ITEM = 0.3
+MAX_CONTRADICTION_CONFIDENCE = 0.9
+VERIFICATION_CONFIDENCE_PER_ITEM = 0.25
+MAX_VERIFICATION_CONFIDENCE = 0.95
+UNCERTAIN_CONFIDENCE = 0.3
+ENTITY_SLOT_MATCH_RATIO = 0.6
+
 
 @dataclass
 class FactCheckResult:
@@ -89,7 +98,7 @@ def check_statement(
     engine,
     statement: str,
     vault: str | None = None,
-    similarity_threshold: float = 0.7,
+    similarity_threshold: float = DEFAULT_SIMILARITY_THRESHOLD,
 ) -> FactCheckResult:
     """Check a statement against stored memories.
 
@@ -144,15 +153,15 @@ def check_statement(
     # Determine verdict
     if contradicting:
         verdict = "contradicted"
-        confidence = min(len(contradicting) * 0.3, 0.9)
+        confidence = min(len(contradicting) * CONTRADICTION_CONFIDENCE_PER_ITEM, MAX_CONTRADICTION_CONFIDENCE)
         explanation = f"Found {len(contradicting)} contradicting memor{'y' if len(contradicting) == 1 else 'ies'}"
     elif matching:
         verdict = "verified"
-        confidence = min(len(matching) * 0.25, 0.95)
+        confidence = min(len(matching) * VERIFICATION_CONFIDENCE_PER_ITEM, MAX_VERIFICATION_CONFIDENCE)
         explanation = f"Found {len(matching)} supporting memor{'y' if len(matching) == 1 else 'ies'}"
     else:
         verdict = "uncertain"
-        confidence = 0.3
+        confidence = UNCERTAIN_CONFIDENCE
         explanation = "Found related memories but none strongly match or contradict"
 
     return FactCheckResult(
@@ -220,7 +229,7 @@ def _detect_contradiction(text_a: str, text_b: str) -> bool:
 
         # If most words match but a few differ (entity slots), it's a conflict
         match_ratio = (min_len - len(diff_positions)) / min_len
-        if match_ratio >= 0.6 and 1 <= len(diff_positions) <= max(1, min_len // 3):
+        if match_ratio >= ENTITY_SLOT_MATCH_RATIO and 1 <= len(diff_positions) <= max(1, min_len // 3):
             # The differing words are potential entity-slot conflicts
             # Exclude common stop words from being counted as entity differences
             stop_words = {
@@ -245,17 +254,45 @@ def _detect_contradiction(text_a: str, text_b: str) -> bool:
 
 
 def _text_similarity(text_a: str, text_b: str) -> float:
-    """Simple text similarity using word overlap (Jaccard)."""
-    words_a = set(text_a.lower().split())
-    words_b = set(text_b.lower().split())
+    """Text similarity using TF-IDF-like weighted word overlap.
+
+    Words that are rarer (appear in fewer of the two texts) get higher weight,
+    making the similarity more meaningful than plain Jaccard.
+    """
+    words_a = text_a.lower().split()
+    words_b = text_b.lower().split()
 
     if not words_a or not words_b:
         return 0.0
 
-    intersection = words_a & words_b
-    union = words_a | words_b
+    set_a = set(words_a)
+    set_b = set(words_b)
+
+    # Term frequency: how often each word appears in its source
+    tf_a = {w: words_a.count(w) / len(words_a) for w in set_a}
+    tf_b = {w: words_b.count(w) / len(words_b) for w in set_b}
+
+    # Inverse document frequency: words appearing in both texts get lower weight
+    all_words = set_a | set_b
+    idf = {}
+    for w in all_words:
+        in_a = 1 if w in set_a else 0
+        in_b = 1 if w in set_b else 0
+        # IDF-like: rare in one text = higher weight
+        idf[w] = 1.0 / (1.0 + in_a + in_b)
+
+    # Weighted overlap
+    intersection = set_a & set_b
+    if not intersection:
+        return 0.0
+
+    weighted_sim = sum(tf_a.get(w, 0) * idf[w] + tf_b.get(w, 0) * idf[w]
+                       for w in intersection)
+    # Normalize by max possible (union)
+    max_sim = sum(tf_a.get(w, 0) * idf[w] + tf_b.get(w, 0) * idf[w]
+                   for w in all_words)
 
-    return len(intersection) / len(union) if union else 0.0
+    return min(weighted_sim / max_sim, 1.0) if max_sim else 0.0
 
 
 def batch_factcheck(

{memorius-0.2.0 → memorius-0.3.0}/memorius/graph.py

@@ -12,7 +12,6 @@ Links are created by:
 
 from __future__ import annotations
 
-import json
 import sqlite3
 from dataclasses import dataclass, field
 from datetime import datetime, timezone
@@ -178,12 +177,13 @@ def auto_link_by_proximity(
     conn: sqlite3.Connection,
     memory_id: str,
     all_memories: list[dict[str, Any]],
-    threshold: float = 0.75,
+    threshold: float = 0.3,
     max_links: int = 10,
 ):
-    """Automatically create links based on embedding proximity.
+    """Automatically create links based on content similarity.
 
     For a given memory, find the most similar others and link them.
+    Uses word overlap (Jaccard) when vectors are not available.
     """
     source = None
     for m in all_memories:
@@ -191,23 +191,41 @@ def auto_link_by_proximity(
             source = m
             break
 
-    if not source or not source.get("vector"):
+    if not source:
         return
 
+    source_content = (source.get("content") or "").lower()
+    if not source_content:
+        return
+    source_words = set(source_content.split())
+
     scored = []
     for m in all_memories:
         if m.get("id") == memory_id:
             continue
-        if not m.get("vector"):
-            continue
-        sim = _cosine_similarity(source["vector"], m["vector"])
+
+        # Prefer vector cosine similarity if available
+        if source.get("vector") and m.get("vector"):
+            sim = _cosine_similarity(source["vector"], m["vector"])
+        else:
+            # Fall back to word overlap (Jaccard)
+            target_content = (m.get("content") or "").lower()
+            if not target_content:
+                continue
+            target_words = set(target_content.split())
+            if not source_words or not target_words:
+                continue
+            intersection = source_words & target_words
+            union = source_words | target_words
+            sim = len(intersection) / len(union) if union else 0.0
+
         if sim >= threshold:
             scored.append((m["id"], sim))
 
     scored.sort(key=lambda x: x[1], reverse=True)
 
     for target_id, sim in scored[:max_links]:
-        link_memories(conn, memory_id, target_id, weight=sim, relation="related")
+        link_memories(conn, memory_id, target_id, weight=round(sim, 4), relation="related")
 
 
 def get_graph_stats(conn: sqlite3.Connection) -> dict[str, Any]:

memorius-0.3.0/memorius/hooks/__init__.py

@@ -0,0 +1,37 @@
+"""
+Universal Hook Lifecycle Adapter for Memorius
+=================================================
+
+Decouples Memorius hooks from any single AI agent's hook protocol.
+
+Adapters are now split into individual files under hooks/adapters/:
+  - claude_code.py, codex.py, gemini.py, openclaw.py
+  - opencode.py, pi.py, openclaude.py, generic.py
+
+This module re-exports everything for backwards compatibility.
+"""
+
+from __future__ import annotations
+
+# Re-export models
+from memorius.hooks.models import (  # noqa: F401
+    HookEventType,
+    HookEvent,
+    HookResult,
+    BaseAgentAdapter,
+    AgentAdapterError,
+)
+
+# Re-export adapters and registry
+from memorius.hooks.adapters import (  # noqa: F401
+    AGENT_ADAPTERS,
+    detect_agent,
+    ClaudeCodeAdapter,
+    CodexAdapter,
+    GeminiCliAdapter,
+    OpenClawAdapter,
+    OpenCodeAdapter,
+    PiAdapter,
+    OpenClaudeAdapter,
+    GenericAgentAdapter,
+)

memorius-0.3.0/memorius/hooks/adapters/__init__.py

@@ -0,0 +1,35 @@
+"""Agent adapters subpackage — one adapter per file."""
+
+from memorius.hooks.adapters.base import BaseAgentAdapter
+from memorius.hooks.adapters.claude_code import ClaudeCodeAdapter
+from memorius.hooks.adapters.codex import CodexAdapter
+from memorius.hooks.adapters.gemini import GeminiCliAdapter
+from memorius.hooks.adapters.openclaw import OpenClawAdapter
+from memorius.hooks.adapters.opencode import OpenCodeAdapter
+from memorius.hooks.adapters.pi import PiAdapter
+from memorius.hooks.adapters.openclaude import OpenClaudeAdapter
+from memorius.hooks.adapters.generic import GenericAgentAdapter
+
+# Registry: ordered by specificity (most specific first)
+AGENT_ADAPTERS: list[type[BaseAgentAdapter]] = [
+    OpenClaudeAdapter,
+    ClaudeCodeAdapter,
+    CodexAdapter,
+    GeminiCliAdapter,
+    OpenClawAdapter,
+    OpenCodeAdapter,
+    PiAdapter,
+    GenericAgentAdapter,  # must be last
+]
+
+
+def detect_agent(data: dict) -> type[BaseAgentAdapter]:
+    """Auto-detect which agent produced this payload."""
+    if isinstance(data, list):
+        return GenericAgentAdapter
+    for adapter_cls in AGENT_ADAPTERS:
+        if adapter_cls is GenericAgentAdapter:
+            continue
+        if adapter_cls.can_parse(data):
+            return adapter_cls
+    return GenericAgentAdapter

memorius-0.3.0/memorius/hooks/adapters/base.py

@@ -0,0 +1,3 @@
+"""Base adapter — re-exports from models for convenience."""
+
+from memorius.hooks.models import BaseAgentAdapter, AgentAdapterError  # noqa: F401

memorius-0.3.0/memorius/hooks/adapters/claude_code.py

@@ -0,0 +1,33 @@
+"""Claude Code adapter."""
+
+from memorius.hooks.models import BaseAgentAdapter, HookEvent, HookEventType
+
+
+class ClaudeCodeAdapter(BaseAgentAdapter):
+    """Parses Claude Code's hook protocol v1."""
+
+    agent_name = "claude-code"
+    event_type_map = {
+        "stop": HookEventType.SESSION_STOP,
+        "precompact": HookEventType.PRE_COMPACT,
+    }
+
+    @classmethod
+    def can_parse(cls, data: dict) -> bool:
+        has_session = bool(data.get("session_id"))
+        has_stop_flag = "stop_hook_active" in data
+        has_hook_name = data.get("hook_name", "").lower() in ("stop", "precompact", "save")
+        return has_session and (has_stop_flag or has_hook_name)
+
+    @classmethod
+    def parse(cls, data: dict) -> HookEvent:
+        raw_type = data.get("hook_name", "stop").lower()
+        event_type = cls.event_type_map.get(raw_type, HookEventType.UNKNOWN)
+        return HookEvent(
+            event_type=event_type,
+            session_id=str(data.get("session_id", "unknown")),
+            transcript_path=data.get("transcript_path"),
+            agent_name=cls.agent_name,
+            raw_payload=data,
+            can_block=True,
+        )

memorius-0.3.0/memorius/hooks/adapters/codex.py

@@ -0,0 +1,32 @@
+"""Codex CLI adapter."""
+
+from memorius.hooks.models import BaseAgentAdapter, HookEvent, HookEventType
+
+
+class CodexAdapter(BaseAgentAdapter):
+    """Parses Codex CLI's hook protocol."""
+
+    agent_name = "codex"
+    event_type_map = {
+        "session-start": HookEventType.SESSION_START,
+        "stop": HookEventType.SESSION_STOP,
+        "precompact": HookEventType.PRE_COMPACT,
+    }
+
+    @classmethod
+    def can_parse(cls, data: dict) -> bool:
+        return bool(data.get("session_id")) and "context_dir" in data
+
+    @classmethod
+    def parse(cls, data: dict) -> HookEvent:
+        raw_type = data.get("event", "stop").lower()
+        event_type = cls.event_type_map.get(raw_type, HookEventType.UNKNOWN)
+        return HookEvent(
+            event_type=event_type,
+            session_id=str(data.get("session_id", "unknown")),
+            transcript_path=data.get("transcript_path"),
+            project_dir=data.get("context_dir"),
+            agent_name=cls.agent_name,
+            raw_payload=data,
+            can_block=True,
+        )

memorius-0.3.0/memorius/hooks/adapters/gemini.py

@@ -0,0 +1,30 @@
+"""Gemini CLI adapter."""
+
+from memorius.hooks.models import BaseAgentAdapter, HookEvent, HookEventType
+
+
+class GeminiCliAdapter(BaseAgentAdapter):
+    """Parses Gemini CLI's PreCompress hook protocol."""
+
+    agent_name = "gemini-cli"
+    event_type_map = {
+        "precompress": HookEventType.PRE_COMPACT,
+    }
+
+    @classmethod
+    def can_parse(cls, data: dict) -> bool:
+        return bool(data.get("session_id")) and "project_id" in data
+
+    @classmethod
+    def parse(cls, data: dict) -> HookEvent:
+        raw_type = data.get("event", "precompress").lower()
+        event_type = cls.event_type_map.get(raw_type, HookEventType.UNKNOWN)
+        return HookEvent(
+            event_type=event_type,
+            session_id=str(data.get("session_id", "unknown")),
+            transcript_path=data.get("transcript_path"),
+            project_dir=data.get("project_dir"),
+            agent_name=cls.agent_name,
+            raw_payload=data,
+            can_block=False,
+        )