palaia 2.4.dev1__tar.gz → 2.4.dev2__tar.gz

{palaia-2.4.dev1/palaia.egg-info → palaia-2.4.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: palaia
-Version: 2.4.dev1
+Version: 2.4.dev2
 Summary: Local, cloud-free memory for OpenClaw agents.
 Author-email: byte5 GmbH <hello@byte5.de>
 License: MIT
@@ -51,7 +51,7 @@ Dynamic: license-file
 
 # Palaia — The Knowledge System for AI Agent Teams
 
-**Crash-safe. Local-first. Zero-cloud. The memory system that makes your agents smarter over time.**
+**Your agents forget. Palaia doesn't.**
 
 [![CI](https://github.com/byte5ai/palaia/actions/workflows/ci.yml/badge.svg)](https://github.com/byte5ai/palaia/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/palaia)](https://pypi.org/project/palaia/)
@@ -61,6 +61,54 @@ Dynamic: license-file
 
 ---
 
+## What Palaia Does
+
+AI agents are stateless by default. Every session starts from scratch — no memory of past decisions, no shared knowledge between agents, no context that survives a restart.
+
+Palaia gives your agents a persistent, searchable knowledge store. They save what they learn. They find it again by meaning, not keyword. They share it across tools and sessions — automatically.
+
+---
+
+## What Palaia Is Not
+
+- Not a chatbot or prompt manager
+- Not a cloud service (everything runs locally)
+- Not a vector database you manage yourself (it manages itself)
+- Not limited to one tool — works with OpenClaw, Claude Desktop, Cursor, and any MCP client
+
+---
+
+## What You Get
+
+| Capability | What it means |
+|------------|---------------|
+| **Agents remember across sessions** | Knowledge survives restarts, tool switches, and team handoffs |
+| **Find anything by meaning** | Hybrid BM25 + vector search across 6 embedding providers |
+| **Zero-config local setup** | SQLite with native SIMD vector search — no separate database process |
+| **Works everywhere via MCP** | One memory store for OpenClaw, Claude Desktop, Cursor, and more |
+| **Multi-agent ready** | Private, team, and public scopes — agents see what they should |
+| **Crash-safe by default** | SQLite WAL mode survives power loss, kills, OOM |
+| **Fast** | Embed server keeps model in RAM — CLI queries ~1.5s, MCP/Plugin <500ms |
+| **Scales when needed** | Swap to PostgreSQL + pgvector for distributed teams, no code changes |
+
+---
+
+## Comparison
+
+| Feature | Palaia | claude-mem | Mem0 | Stock Memory |
+|---------|--------|-----------|------|--------------|
+| Local-first | Yes | Yes | No (cloud) | Yes |
+| Cross-tool (MCP) | Yes (any MCP client) | No (Claude Code only) | No | No |
+| Native Vector Search | sqlite-vec / pgvector | ChromaDB (separate) | Cloud | No |
+| Structured Types | memory/process/task | decisions/bugfixes | No | No |
+| Multi-Agent Scopes | private/team/public | No | Per-user | No |
+| Smart Tiering | HOT/WARM/COLD | No | No | No |
+| Embedding Providers | 6 (configurable) | 1 (fixed) | Cloud | None |
+| Open Source | MIT | AGPL-3.0 | Partial | N/A |
+| Crash-safe (WAL) | Yes | Partial | N/A | No |
+
+---
+
 ## Install
 
 ### Recommended: Tell your agent
@@ -122,40 +170,6 @@ palaia status                                        # Check health
 
 ---
 
-## Why Palaia?
-
-| Feature | Details |
-|---------|---------|
-| **Semantic Search** | Hybrid BM25 + vector embeddings. 6 providers: fastembed, sentence-transformers, Ollama, OpenAI, Gemini, BM25. |
-| **Native Vector Search** | sqlite-vec (SIMD KNN) or pgvector (ANN/HNSW). Not Python cosine — real database-level acceleration. |
-| **MCP Server** | `palaia-mcp` — standalone memory for Claude Desktop, Cursor, any MCP host. No OpenClaw required. |
-| **Multi-Backend** | SQLite (default, zero-config) or PostgreSQL + pgvector for distributed teams. |
-| **Crash-Safe** | SQLite WAL mode — survives power loss, kills, OOM. |
-| **Auto-Capture** | OpenClaw plugin captures significant exchanges automatically. |
-| **Structured Types** | memory, process, task — with status, priority, assignee, due date. |
-| **Multi-Agent** | Shared store, scopes (private/team/public), agent aliases, per-agent injection priorities. |
-| **Smart Tiering** | HOT/WARM/COLD rotation based on decay scores and access patterns. |
-| **Embed Server** | Background process holds model in RAM. CLI queries: ~1.5s (was ~3-5s). MCP/Plugin: <500ms. |
-| **Zero-Cloud** | Everything local. No API keys needed for core functionality. |
-
----
-
-## Comparison
-
-| Feature | Palaia | claude-mem | Mem0 | Stock Memory |
-|---------|--------|-----------|------|--------------|
-| Local-first | Yes | Yes | No (cloud) | Yes |
-| Cross-tool (MCP) | Yes (any MCP client) | No (Claude Code only) | No | No |
-| Native Vector Search | sqlite-vec / pgvector | ChromaDB (separate) | Cloud | No |
-| Structured Types | memory/process/task | decisions/bugfixes | No | No |
-| Multi-Agent Scopes | private/team/public | No | Per-user | No |
-| Smart Tiering | HOT/WARM/COLD | No | No | No |
-| Embedding Providers | 6 (configurable) | 1 (fixed) | Cloud | None |
-| Open Source | MIT | AGPL-3.0 | Partial | N/A |
-| Crash-safe (WAL) | Yes | Partial | N/A | No |
-
----
-
 ## Documentation
 
 | Document | Description |

{palaia-2.4.dev1 → palaia-2.4.dev2}/README.md

@@ -1,6 +1,6 @@
 # Palaia — The Knowledge System for AI Agent Teams
 
-**Crash-safe. Local-first. Zero-cloud. The memory system that makes your agents smarter over time.**
+**Your agents forget. Palaia doesn't.**
 
 [![CI](https://github.com/byte5ai/palaia/actions/workflows/ci.yml/badge.svg)](https://github.com/byte5ai/palaia/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/palaia)](https://pypi.org/project/palaia/)
@@ -10,6 +10,54 @@
 
 ---
 
+## What Palaia Does
+
+AI agents are stateless by default. Every session starts from scratch — no memory of past decisions, no shared knowledge between agents, no context that survives a restart.
+
+Palaia gives your agents a persistent, searchable knowledge store. They save what they learn. They find it again by meaning, not keyword. They share it across tools and sessions — automatically.
+
+---
+
+## What Palaia Is Not
+
+- Not a chatbot or prompt manager
+- Not a cloud service (everything runs locally)
+- Not a vector database you manage yourself (it manages itself)
+- Not limited to one tool — works with OpenClaw, Claude Desktop, Cursor, and any MCP client
+
+---
+
+## What You Get
+
+| Capability | What it means |
+|------------|---------------|
+| **Agents remember across sessions** | Knowledge survives restarts, tool switches, and team handoffs |
+| **Find anything by meaning** | Hybrid BM25 + vector search across 6 embedding providers |
+| **Zero-config local setup** | SQLite with native SIMD vector search — no separate database process |
+| **Works everywhere via MCP** | One memory store for OpenClaw, Claude Desktop, Cursor, and more |
+| **Multi-agent ready** | Private, team, and public scopes — agents see what they should |
+| **Crash-safe by default** | SQLite WAL mode survives power loss, kills, OOM |
+| **Fast** | Embed server keeps model in RAM — CLI queries ~1.5s, MCP/Plugin <500ms |
+| **Scales when needed** | Swap to PostgreSQL + pgvector for distributed teams, no code changes |
+
+---
+
+## Comparison
+
+| Feature | Palaia | claude-mem | Mem0 | Stock Memory |
+|---------|--------|-----------|------|--------------|
+| Local-first | Yes | Yes | No (cloud) | Yes |
+| Cross-tool (MCP) | Yes (any MCP client) | No (Claude Code only) | No | No |
+| Native Vector Search | sqlite-vec / pgvector | ChromaDB (separate) | Cloud | No |
+| Structured Types | memory/process/task | decisions/bugfixes | No | No |
+| Multi-Agent Scopes | private/team/public | No | Per-user | No |
+| Smart Tiering | HOT/WARM/COLD | No | No | No |
+| Embedding Providers | 6 (configurable) | 1 (fixed) | Cloud | None |
+| Open Source | MIT | AGPL-3.0 | Partial | N/A |
+| Crash-safe (WAL) | Yes | Partial | N/A | No |
+
+---
+
 ## Install
 
 ### Recommended: Tell your agent
@@ -71,40 +119,6 @@ palaia status                                        # Check health
 
 ---
 
-## Why Palaia?
-
-| Feature | Details |
-|---------|---------|
-| **Semantic Search** | Hybrid BM25 + vector embeddings. 6 providers: fastembed, sentence-transformers, Ollama, OpenAI, Gemini, BM25. |
-| **Native Vector Search** | sqlite-vec (SIMD KNN) or pgvector (ANN/HNSW). Not Python cosine — real database-level acceleration. |
-| **MCP Server** | `palaia-mcp` — standalone memory for Claude Desktop, Cursor, any MCP host. No OpenClaw required. |
-| **Multi-Backend** | SQLite (default, zero-config) or PostgreSQL + pgvector for distributed teams. |
-| **Crash-Safe** | SQLite WAL mode — survives power loss, kills, OOM. |
-| **Auto-Capture** | OpenClaw plugin captures significant exchanges automatically. |
-| **Structured Types** | memory, process, task — with status, priority, assignee, due date. |
-| **Multi-Agent** | Shared store, scopes (private/team/public), agent aliases, per-agent injection priorities. |
-| **Smart Tiering** | HOT/WARM/COLD rotation based on decay scores and access patterns. |
-| **Embed Server** | Background process holds model in RAM. CLI queries: ~1.5s (was ~3-5s). MCP/Plugin: <500ms. |
-| **Zero-Cloud** | Everything local. No API keys needed for core functionality. |
-
----
-
-## Comparison
-
-| Feature | Palaia | claude-mem | Mem0 | Stock Memory |
-|---------|--------|-----------|------|--------------|
-| Local-first | Yes | Yes | No (cloud) | Yes |
-| Cross-tool (MCP) | Yes (any MCP client) | No (Claude Code only) | No | No |
-| Native Vector Search | sqlite-vec / pgvector | ChromaDB (separate) | Cloud | No |
-| Structured Types | memory/process/task | decisions/bugfixes | No | No |
-| Multi-Agent Scopes | private/team/public | No | Per-user | No |
-| Smart Tiering | HOT/WARM/COLD | No | No | No |
-| Embedding Providers | 6 (configurable) | 1 (fixed) | Cloud | None |
-| Open Source | MIT | AGPL-3.0 | Partial | N/A |
-| Crash-safe (WAL) | Yes | Partial | N/A | No |
-
----
-
 ## Documentation
 
 | Document | Description |

{palaia-2.4.dev1 → palaia-2.4.dev2}/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: palaia
-version: "2.4.dev1"
+version: "2.4.dev2"
 description: >
   Local, crash-safe persistent memory for OpenClaw agents.
   SQLite-backed by default. Semantic search, projects, scopes, auto-capture.

{palaia-2.4.dev1 → palaia-2.4.dev2}/palaia/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: palaia
-version: "2.4.dev1"
+version: "2.4.dev2"
 description: >
   Local, crash-safe persistent memory for OpenClaw agents.
   SQLite-backed by default. Semantic search, projects, scopes, auto-capture.

{palaia-2.4.dev1 → palaia-2.4.dev2}/palaia/__init__.py

@@ -4,5 +4,5 @@ Palaia — Local, cloud-free memory for OpenClaw agents.
 
 from __future__ import annotations
 
-__version__ = "2.4.dev1"
+__version__ = "2.4.dev2"
 __author__ = "byte5 GmbH"

{palaia-2.4.dev1 → palaia-2.4.dev2}/palaia/cli_args.py

@@ -98,6 +98,7 @@ def build_parser() -> argparse.ArgumentParser:
     )
     p_query.add_argument("--assignee", default=None, help="Filter by assignee")
     p_query.add_argument("--instance", default=None, help="Filter by session identity")
+    p_query.add_argument("--tags", default=None, help="Filter by tags (comma-separated, AND logic)")
     p_query.add_argument("--before", default=None, help="Only entries created before this ISO timestamp")
     p_query.add_argument("--after", default=None, help="Only entries created after this ISO timestamp")
     p_query.add_argument(
@@ -135,6 +136,7 @@ def build_parser() -> argparse.ArgumentParser:
     p_list = sub.add_parser("list", help="List entries in a tier")
     p_list.add_argument("--tier", default=None, choices=["hot", "warm", "cold"], help="Tier to list (default: hot)")
     p_list.add_argument("--all", action="store_true", help="List across all tiers (hot+warm+cold)")
+    p_list.add_argument("--limit", type=int, default=None, help="Max entries to return")
     p_list.add_argument("--project", default=None, help="Filter by project")
     p_list.add_argument("--tag", default=None, action="append", help="Filter by tag (repeatable, AND logic)")
     p_list.add_argument("--scope", default=None, help="Filter by scope")

{palaia-2.4.dev1 → palaia-2.4.dev2}/palaia/cli_commands.py

@@ -58,6 +58,15 @@ def cmd_query(args):
     has_embeddings = svc_result["has_embeddings"]
     bm25_only = svc_result["bm25_only"]
 
+    # Post-filter by --tags if specified (AND logic, comma-separated)
+    tags_filter = getattr(args, "tags", None)
+    if tags_filter:
+        required_tags = [t.strip() for t in tags_filter.split(",") if t.strip()]
+        results = [
+            r for r in results
+            if all(tag in (r.get("tags") or []) for tag in required_tags)
+        ]
+
     # --- Adaptive Nudging for query (Issue #68) ---
     query_nudge_messages = []
     try:
@@ -234,6 +243,11 @@ def cmd_list(args):
     tier_label = svc_result["tier"]
     entries_with_tier = svc_result["entries_with_tier"]
 
+    # Apply --limit if specified
+    limit = getattr(args, "limit", None)
+    if limit is not None and limit > 0:
+        entries_with_tier = entries_with_tier[:limit]
+
     if json_out(
         {
             "tier": tier_label,

{palaia-2.4.dev1 → palaia-2.4.dev2}/palaia/embed_server.py

@@ -242,6 +242,8 @@ class EmbedServer:
         instance = params.get("instance")
         include_cold = params.get("include_cold", False)
         cross_project = params.get("cross_project", False)
+        before = params.get("before")
+        after = params.get("after")
 
         engine = self._bm25_engine if self._warming_up else self.engine
         results = engine.search(
@@ -255,6 +257,8 @@ class EmbedServer:
             priority=priority,
             assignee=assignee,
             instance=instance,
+            before=before,
+            after=after,
             cross_project=cross_project,
         )
 

{palaia-2.4.dev1 → palaia-2.4.dev2}/palaia/mcp/server.py

@@ -123,7 +123,8 @@ def create_server(root: Path, read_only: bool = False) -> FastMCP:
         header_parts = [
             f"ID: {result['id']}",
             f"Title: {meta.get('title', 'untitled')}",
-            f"Type: {meta.get('scope', 'team')}",
+            f"Type: {meta.get('type', 'memory')}",
+            f"Scope: {meta.get('scope', 'team')}",
             f"Tier: {meta.get('tier', '?')}",
             f"Tags: {', '.join(meta.get('tags', []))}",
             f"Created: {meta.get('created', '?')}",

{palaia-2.4.dev1 → palaia-2.4.dev2}/palaia/search.py

@@ -73,6 +73,7 @@ class SearchEngine:
         self._provider = None
         self._index_cache: list[tuple[str, str, dict]] | None = None
         self._index_dirty = True
+        self._index_cache_key: tuple | None = None  # (include_cold, agent) for cache validity
 
     @property
     def provider(self):
@@ -95,7 +96,8 @@ class SearchEngine:
         Uses a cached index when available. Call invalidate_index() after
         write/edit/gc operations to force a rebuild.
         """
-        if not self._index_dirty and self._index_cache is not None:
+        cache_key = (include_cold, agent)
+        if not self._index_dirty and self._index_cache is not None and self._index_cache_key == cache_key:
             # Re-index BM25 from cache (cheap — no disk reads)
             self.bm25.index([(did, text) for did, text, _meta in self._index_cache])
             return list(self._index_cache)
@@ -112,6 +114,7 @@ class SearchEngine:
             docs_with_meta.append((doc_id, full_text, meta))
         self.bm25.index(docs)
         self._index_cache = docs_with_meta
+        self._index_cache_key = cache_key
         self._index_dirty = False
         return docs_with_meta
 

{palaia-2.4.dev1 → palaia-2.4.dev2}/palaia/services/query.py

@@ -80,6 +80,10 @@ def search_entries(
                     params["instance"] = instance
                 if cross_project:
                     params["cross_project"] = True
+                if before:
+                    params["before"] = before
+                if after:
+                    params["after"] = after
                 result = client.query(params, timeout=5.0)
                 chain_cfg = _config.get("embedding_chain", [])
                 bm25_only = not chain_cfg or chain_cfg == ["bm25"]

{palaia-2.4.dev1 → palaia-2.4.dev2}/palaia/services/write.py

@@ -62,7 +62,8 @@ def write_entry(
         instance=instance,
     )
 
-    # Check dedup and tier
+    # Check dedup: Store.write() returns existing ID on hash collision
+    # Compare with a fresh read to detect if this was a dedup or new write
     entry = store.read(entry_id)
     tier = "hot"
     actual_scope = scope or "team"
@@ -74,6 +75,10 @@ def write_entry(
             if (root / t / f"{entry_id}.md").exists():
                 tier = t
                 break
+        # If entry existed before write (non-hot tier or older timestamp),
+        # it was deduplicated. Hot + just-created = new entry.
+        if tier != "hot":
+            deduplicated = True
 
     # --- Adaptive Nudging (Issue #68) ---
     nudge_messages: list[str] = []

{palaia-2.4.dev1 → palaia-2.4.dev2/palaia.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: palaia
-Version: 2.4.dev1
+Version: 2.4.dev2
 Summary: Local, cloud-free memory for OpenClaw agents.
 Author-email: byte5 GmbH <hello@byte5.de>
 License: MIT
@@ -51,7 +51,7 @@ Dynamic: license-file
 
 # Palaia — The Knowledge System for AI Agent Teams
 
-**Crash-safe. Local-first. Zero-cloud. The memory system that makes your agents smarter over time.**
+**Your agents forget. Palaia doesn't.**
 
 [![CI](https://github.com/byte5ai/palaia/actions/workflows/ci.yml/badge.svg)](https://github.com/byte5ai/palaia/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/palaia)](https://pypi.org/project/palaia/)
@@ -61,6 +61,54 @@ Dynamic: license-file
 
 ---
 
+## What Palaia Does
+
+AI agents are stateless by default. Every session starts from scratch — no memory of past decisions, no shared knowledge between agents, no context that survives a restart.
+
+Palaia gives your agents a persistent, searchable knowledge store. They save what they learn. They find it again by meaning, not keyword. They share it across tools and sessions — automatically.
+
+---
+
+## What Palaia Is Not
+
+- Not a chatbot or prompt manager
+- Not a cloud service (everything runs locally)
+- Not a vector database you manage yourself (it manages itself)
+- Not limited to one tool — works with OpenClaw, Claude Desktop, Cursor, and any MCP client
+
+---
+
+## What You Get
+
+| Capability | What it means |
+|------------|---------------|
+| **Agents remember across sessions** | Knowledge survives restarts, tool switches, and team handoffs |
+| **Find anything by meaning** | Hybrid BM25 + vector search across 6 embedding providers |
+| **Zero-config local setup** | SQLite with native SIMD vector search — no separate database process |
+| **Works everywhere via MCP** | One memory store for OpenClaw, Claude Desktop, Cursor, and more |
+| **Multi-agent ready** | Private, team, and public scopes — agents see what they should |
+| **Crash-safe by default** | SQLite WAL mode survives power loss, kills, OOM |
+| **Fast** | Embed server keeps model in RAM — CLI queries ~1.5s, MCP/Plugin <500ms |
+| **Scales when needed** | Swap to PostgreSQL + pgvector for distributed teams, no code changes |
+
+---
+
+## Comparison
+
+| Feature | Palaia | claude-mem | Mem0 | Stock Memory |
+|---------|--------|-----------|------|--------------|
+| Local-first | Yes | Yes | No (cloud) | Yes |
+| Cross-tool (MCP) | Yes (any MCP client) | No (Claude Code only) | No | No |
+| Native Vector Search | sqlite-vec / pgvector | ChromaDB (separate) | Cloud | No |
+| Structured Types | memory/process/task | decisions/bugfixes | No | No |
+| Multi-Agent Scopes | private/team/public | No | Per-user | No |
+| Smart Tiering | HOT/WARM/COLD | No | No | No |
+| Embedding Providers | 6 (configurable) | 1 (fixed) | Cloud | None |
+| Open Source | MIT | AGPL-3.0 | Partial | N/A |
+| Crash-safe (WAL) | Yes | Partial | N/A | No |
+
+---
+
 ## Install
 
 ### Recommended: Tell your agent
@@ -122,40 +170,6 @@ palaia status                                        # Check health
 
 ---
 
-## Why Palaia?
-
-| Feature | Details |
-|---------|---------|
-| **Semantic Search** | Hybrid BM25 + vector embeddings. 6 providers: fastembed, sentence-transformers, Ollama, OpenAI, Gemini, BM25. |
-| **Native Vector Search** | sqlite-vec (SIMD KNN) or pgvector (ANN/HNSW). Not Python cosine — real database-level acceleration. |
-| **MCP Server** | `palaia-mcp` — standalone memory for Claude Desktop, Cursor, any MCP host. No OpenClaw required. |
-| **Multi-Backend** | SQLite (default, zero-config) or PostgreSQL + pgvector for distributed teams. |
-| **Crash-Safe** | SQLite WAL mode — survives power loss, kills, OOM. |
-| **Auto-Capture** | OpenClaw plugin captures significant exchanges automatically. |
-| **Structured Types** | memory, process, task — with status, priority, assignee, due date. |
-| **Multi-Agent** | Shared store, scopes (private/team/public), agent aliases, per-agent injection priorities. |
-| **Smart Tiering** | HOT/WARM/COLD rotation based on decay scores and access patterns. |
-| **Embed Server** | Background process holds model in RAM. CLI queries: ~1.5s (was ~3-5s). MCP/Plugin: <500ms. |
-| **Zero-Cloud** | Everything local. No API keys needed for core functionality. |
-
----
-
-## Comparison
-
-| Feature | Palaia | claude-mem | Mem0 | Stock Memory |
-|---------|--------|-----------|------|--------------|
-| Local-first | Yes | Yes | No (cloud) | Yes |
-| Cross-tool (MCP) | Yes (any MCP client) | No (Claude Code only) | No | No |
-| Native Vector Search | sqlite-vec / pgvector | ChromaDB (separate) | Cloud | No |
-| Structured Types | memory/process/task | decisions/bugfixes | No | No |
-| Multi-Agent Scopes | private/team/public | No | Per-user | No |
-| Smart Tiering | HOT/WARM/COLD | No | No | No |
-| Embedding Providers | 6 (configurable) | 1 (fixed) | Cloud | None |
-| Open Source | MIT | AGPL-3.0 | Partial | N/A |
-| Crash-safe (WAL) | Yes | Partial | N/A | No |
-
----
-
 ## Documentation
 
 | Document | Description |

{palaia-2.4.dev1 → palaia-2.4.dev2}/palaia.egg-info/SOURCES.txt

@@ -126,6 +126,7 @@ tests/test_project_owner.py
 tests/test_scope.py
 tests/test_scope_enforcement.py
 tests/test_search.py
+tests/test_search_cache.py
 tests/test_search_chain.py
 tests/test_significance.py
 tests/test_skill.py

{palaia-2.4.dev1 → palaia-2.4.dev2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "palaia"
-version = "2.4.dev1"
+version = "2.4.dev2"
 description = "Local, cloud-free memory for OpenClaw agents."
 readme = "README.md"
 license = {text = "MIT"}

palaia-2.4.dev2/tests/test_search_cache.py

@@ -0,0 +1,101 @@
+"""Tests for SearchEngine cache invalidation by corpus params."""
+
+from __future__ import annotations
+
+import pytest
+
+from palaia.config import DEFAULT_CONFIG, save_config
+from palaia.search import SearchEngine
+from palaia.store import Store
+
+
+@pytest.fixture
+def palaia_root(tmp_path):
+    root = tmp_path / ".palaia"
+    root.mkdir()
+    for d in ("hot", "warm", "cold", "wal", "index"):
+        (root / d).mkdir()
+    config = dict(DEFAULT_CONFIG)
+    config["store_version"] = "2.0.0"
+    save_config(root, config)
+    return root
+
+
+@pytest.fixture
+def store(palaia_root):
+    return Store(palaia_root)
+
+
+class TestSearchEngineCacheInvalidation:
+    """Verify that build_index() rebuilds when corpus params change."""
+
+    def test_cache_hit_same_params(self, store):
+        store.write("Test entry for caching", tags=["test"], title="Cache Test")
+        engine = SearchEngine(store)
+
+        # First build — should read from disk
+        docs1 = engine.build_index(include_cold=False, agent=None)
+        assert len(docs1) > 0
+
+        # Second build with same params — should use cache
+        docs2 = engine.build_index(include_cold=False, agent=None)
+        assert len(docs2) == len(docs1)
+        assert not engine._index_dirty
+
+    def test_cache_miss_on_include_cold_change(self, store):
+        store.write("Hot entry", tags=["test"], title="Hot")
+        engine = SearchEngine(store)
+
+        # Build with include_cold=False
+        engine.build_index(include_cold=False, agent=None)
+        assert engine._index_cache_key == (False, None)
+
+        # Build with include_cold=True — cache key differs, should rebuild
+        engine.build_index(include_cold=True, agent=None)
+        assert engine._index_cache_key == (True, None)
+
+    def test_cache_miss_on_agent_change(self, store):
+        store.write("Entry by agent-a", tags=["test"], agent="agent-a", title="A")
+        store.write("Entry by agent-b", tags=["test"], agent="agent-b", title="B")
+        engine = SearchEngine(store)
+
+        # Build for agent-a
+        docs_a = engine.build_index(include_cold=False, agent="agent-a")
+        key_a = engine._index_cache_key
+        assert key_a == (False, "agent-a")
+
+        # Build for agent-b — cache key changes, should rebuild
+        docs_b = engine.build_index(include_cold=False, agent="agent-b")
+        key_b = engine._index_cache_key
+        assert key_b == (False, "agent-b")
+        assert key_a != key_b
+
+    def test_invalidate_index_forces_rebuild(self, store):
+        store.write("Test entry", tags=["test"], title="Invalidation Test")
+        engine = SearchEngine(store)
+
+        engine.build_index()
+        assert not engine._index_dirty
+
+        engine.invalidate_index()
+        assert engine._index_dirty
+        assert engine._index_cache is None
+
+        # Rebuild after invalidation
+        docs = engine.build_index()
+        assert not engine._index_dirty
+        assert len(docs) > 0
+
+    def test_cache_key_combo_cold_and_agent(self, store):
+        """Different (include_cold, agent) combos produce different cache keys."""
+        store.write("Entry", tags=["test"], title="Combo Test")
+        engine = SearchEngine(store)
+
+        engine.build_index(include_cold=False, agent=None)
+        assert engine._index_cache_key == (False, None)
+
+        engine.build_index(include_cold=True, agent="bot")
+        assert engine._index_cache_key == (True, "bot")
+
+        engine.build_index(include_cold=False, agent="bot")
+        assert engine._index_cache_key == (False, "bot")

{palaia-2.4.dev1 → palaia-2.4.dev2}/tests/test_temporal_queries.py

@@ -2,9 +2,12 @@
 
 from __future__ import annotations
 
+import json
+
 import pytest
 
 from palaia.config import DEFAULT_CONFIG, save_config
+from palaia.embed_server import EmbedServer
 from palaia.entry import parse_entry, serialize_entry
 from palaia.search import SearchEngine
 from palaia.store import Store
@@ -108,3 +111,49 @@ class TestTemporalSearch:
         results = engine.search("Late Plan", after="2026-03-15T10:00:00+00:00")
         result_ids = [r["id"] for r in results]
         assert ids[2] not in result_ids
+
+
+class TestEmbedServerTemporalQuery:
+    """Verify embed-server _handle_query forwards before/after to SearchEngine."""
+
+    def test_before_param_forwarded(self, temporal_store):
+        store, ids = temporal_store
+        server = EmbedServer(store.root)
+        response = server.handle_request({
+            "method": "query",
+            "params": {"text": "decision update plan", "before": "2026-02-01"},
+        })
+        assert "result" in response
+        result_ids = [r["id"] for r in response["result"]["results"]]
+        assert ids[0] in result_ids
+        assert ids[1] not in result_ids
+        assert ids[2] not in result_ids
+
+    def test_after_param_forwarded(self, temporal_store):
+        store, ids = temporal_store
+        server = EmbedServer(store.root)
+        response = server.handle_request({
+            "method": "query",
+            "params": {"text": "decision update plan", "after": "2026-03-01"},
+        })
+        assert "result" in response
+        result_ids = [r["id"] for r in response["result"]["results"]]
+        assert ids[2] in result_ids
+        assert ids[0] not in result_ids
+
+    def test_before_and_after_combined(self, temporal_store):
+        store, ids = temporal_store
+        server = EmbedServer(store.root)
+        response = server.handle_request({
+            "method": "query",
+            "params": {
+                "text": "decision update plan",
+                "after": "2026-02-01",
+                "before": "2026-03-01",
+            },
+        })
+        assert "result" in response
+        result_ids = [r["id"] for r in response["result"]["results"]]
+        assert ids[1] in result_ids
+        assert ids[0] not in result_ids
+        assert ids[2] not in result_ids