selectools 0.28.0__tar.gz → 0.29.0__tar.gz

{selectools-0.28.0/src/selectools.egg-info → selectools-0.29.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: selectools
-Version: 0.28.0
+Version: 0.29.0
 Summary: Production-ready Python framework for AI agents with multi-agent graphs, hybrid RAG, guardrails, audit logging, 50 evaluators, and a visual builder. Supports OpenAI, Anthropic, Gemini, Ollama. By NichevLabs.
 Author-email: John Nichev <johnnichev@gmail.com>
 Maintainer-email: NichevLabs <support@nichevlabs.com>
@@ -118,6 +118,19 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 # selectools serve agent.yaml
 ```
 
+## What's New in v0.29
+
+### v0.29.0 — Stability Promotions (v1.0 Freeze Prep)
+
+The first beta → stable promotion pass toward the 1.0 API freeze. Additive only — promotions strengthen guarantees, nothing is removed or renamed.
+
+- **24 mature toolbox tools promoted to `@stable`** — calculator, code (incl. `execute_shell`), db, email, GitHub, Linear, Notion, PDF, web search, and Slack tools. They're 4–15 releases old with frozen signatures.
+- **`orchestration`, `patterns`, and `policy` are now stable modules** — their public surfaces (AgentGraph, the checkpoint stores, all five pattern agents, ToolPolicy) were already frozen in v0.25; this aligns the module-level promise. Also promoted `SessionSearchResult` and `PlanningConfig`.
+- **Held `@beta` on purpose** — the v0.27.0 additions (recall tool, injection guardrail, cache-rate cost, Mongo/Dynamo session stores) get one more cycle, and `evals` stays a beta module while its 50 evaluator classes keep growing (its 7 core types are `@stable`).
+- **New `scripts/stability_audit.py`** reports any symbol whose marker disagrees with its module promise, so promotion passes are reproducible.
+
+See `CHANGELOG.md` for the full entry.
+
 ## What's New in v0.28
 
 ### v0.28.0 — Hardening Sweep: Shell Safety, Session Namespaces & Typed Public API

{selectools-0.28.0 → selectools-0.29.0}/README.md

@@ -30,6 +30,19 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 # selectools serve agent.yaml
 ```
 
+## What's New in v0.29
+
+### v0.29.0 — Stability Promotions (v1.0 Freeze Prep)
+
+The first beta → stable promotion pass toward the 1.0 API freeze. Additive only — promotions strengthen guarantees, nothing is removed or renamed.
+
+- **24 mature toolbox tools promoted to `@stable`** — calculator, code (incl. `execute_shell`), db, email, GitHub, Linear, Notion, PDF, web search, and Slack tools. They're 4–15 releases old with frozen signatures.
+- **`orchestration`, `patterns`, and `policy` are now stable modules** — their public surfaces (AgentGraph, the checkpoint stores, all five pattern agents, ToolPolicy) were already frozen in v0.25; this aligns the module-level promise. Also promoted `SessionSearchResult` and `PlanningConfig`.
+- **Held `@beta` on purpose** — the v0.27.0 additions (recall tool, injection guardrail, cache-rate cost, Mongo/Dynamo session stores) get one more cycle, and `evals` stays a beta module while its 50 evaluator classes keep growing (its 7 core types are `@stable`).
+- **New `scripts/stability_audit.py`** reports any symbol whose marker disagrees with its module promise, so promotion passes are reproducible.
+
+See `CHANGELOG.md` for the full entry.
+
 ## What's New in v0.28
 
 ### v0.28.0 — Hardening Sweep: Shell Safety, Session Namespaces & Typed Public API

{selectools-0.28.0 → selectools-0.29.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "selectools"
-version = "0.28.0"
+version = "0.29.0"
 description = "Production-ready Python framework for AI agents with multi-agent graphs, hybrid RAG, guardrails, audit logging, 50 evaluators, and a visual builder. Supports OpenAI, Anthropic, Gemini, Ollama. By NichevLabs."
 readme = "README.md"
 requires-python = ">=3.9"

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/__init__.py

@@ -1,6 +1,6 @@
 """Public exports for the selectools package."""
 
-__version__ = "0.28.0"
+__version__ = "0.29.0"
 
 # Import submodules (lazy loading for optional dependencies)
 from . import embeddings, evals, guardrails, models, observe, patterns, rag, toolbox

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/agent/config.py

@@ -404,7 +404,7 @@ step executes and must return one of:
 """
 
 
-@beta
+@stable
 @dataclass
 class PlanningConfig:
     """Opt-in planning for any Agent: plan -> (approve) -> execute -> synthesize.

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/orchestration/__init__.py

@@ -58,7 +58,7 @@ from .state import (
 )
 from .supervisor import ModelSplit, SupervisorAgent, SupervisorStrategy
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = [
     # Core graph

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/orchestration/checkpoint.py

@@ -392,7 +392,7 @@ class SQLiteCheckpointStore:
 # for implementations that do not define it, so it is registered instead.
 register_stability("CheckpointStore", "stable")
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = [
     "CheckpointMetadata",

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/orchestration/graph.py

@@ -1828,7 +1828,7 @@ class AgentGraph:
         print()
 
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = [
     "AgentGraph",

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/orchestration/node.py

@@ -183,7 +183,7 @@ def build_context_messages(node: GraphNode, state: GraphState) -> List[Any]:
     return default_input_transform(state)
 
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = [
     "GraphNode",

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/orchestration/state.py

@@ -342,7 +342,7 @@ def merge_states(states: List[GraphState], policy: MergePolicy) -> GraphState:
     )
 
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = [
     "STATE_KEY_LAST_OUTPUT",

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/orchestration/supervisor.py

@@ -605,7 +605,7 @@ def _format_history(history: List[Any]) -> str:
     return "\n".join(lines) if lines else "No steps taken yet."
 
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = [
     "SupervisorAgent",

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/patterns/__init__.py

@@ -25,7 +25,7 @@ from .plan_and_execute import PlanAndExecuteAgent, PlanStep
 from .reflective import ReflectionRound, ReflectiveAgent, ReflectiveResult
 from .team_lead import Subtask, TeamLeadAgent, TeamLeadResult
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = [
     # PlanAndExecute

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/patterns/debate.py

@@ -133,6 +133,6 @@ class DebateAgent:
         return DebateResult(conclusion=conclusion, rounds=rounds)
 
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = ["DebateAgent", "DebateRound", "DebateResult"]

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/patterns/plan_and_execute.py

@@ -222,6 +222,6 @@ class PlanAndExecuteAgent:
         return steps
 
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = ["PlanAndExecuteAgent", "PlanStep"]

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/patterns/reflective.py

@@ -135,6 +135,6 @@ class ReflectiveAgent:
         return ReflectiveResult(final_draft=draft, rounds=rounds, approved=approved)
 
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = ["ReflectiveAgent", "ReflectionRound", "ReflectiveResult"]

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/patterns/team_lead.py

@@ -305,6 +305,6 @@ class TeamLeadAgent:
         return TeamLeadResult(content=synthesis.content or work_log, subtasks=all_subtasks)
 
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = ["TeamLeadAgent", "Subtask", "TeamLeadResult"]

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/policy.py

@@ -233,6 +233,6 @@ class ToolPolicy:
         return cls.from_dict(data)
 
 
-__stability__ = "beta"
+__stability__ = "stable"
 
 __all__ = ["ApprovalRequest", "ToolPolicy", "PolicyDecision", "PolicyResult"]

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/sessions.py

@@ -53,7 +53,7 @@ class SessionMetadata:
     updated_at: float
 
 
-@beta
+@stable
 @dataclass(frozen=True)
 class SessionSearchResult:
     """One session matched by :meth:`SessionStore.search`.

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/toolbox/calculator_tools.py

@@ -17,7 +17,7 @@ import ast
 import math
 from typing import Callable, Dict, Union
 
-from ..stability import beta
+from ..stability import stable
 from ..tools import tool
 
 _MAX_EXPRESSION_LENGTH = 2000
@@ -144,7 +144,7 @@ def _eval_node(node: ast.AST) -> _Number:
     raise ValueError(f"expression element '{type(node).__name__}' is not allowed")
 
 
-@beta
+@stable
 @tool(description="Safely evaluate a math expression (arithmetic, sqrt, log, trig, pi/e)")
 def evaluate_expression(expression: str) -> str:
     """
@@ -279,7 +279,7 @@ def _format_quantity(value: float) -> str:
     return f"{value:.6f}".rstrip("0").rstrip(".")
 
 
-@beta
+@stable
 @tool(description="Convert between length, mass, temperature, and data units")
 def unit_convert(value: float, from_unit: str, to_unit: str) -> str:
     """

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/toolbox/code_tools.py

@@ -12,7 +12,7 @@ import shlex
 import subprocess  # nosec B404 — code execution tool
 import tempfile
 
-from ..stability import beta
+from ..stability import stable
 from ..tools import tool
 
 _MAX_OUTPUT_BYTES = 10 * 1024  # 10 KB
@@ -47,7 +47,7 @@ def _truncate(text: str, max_bytes: int = _MAX_OUTPUT_BYTES) -> str:
     return truncated + "\n... (output truncated to 10 KB)"
 
 
-@beta
+@stable
 @tool(description="Execute Python code and return stdout + stderr")
 def execute_python(code: str, timeout: int = 30) -> str:
     """
@@ -114,7 +114,7 @@ def execute_python(code: str, timeout: int = 30) -> str:
             os.unlink(tmp_path)
 
 
-@beta
+@stable
 @tool(description="Execute a shell command and return output")
 def execute_shell(command: str, timeout: int = 30) -> str:
     """

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/toolbox/db_tools.py

@@ -11,7 +11,7 @@ import os
 import re
 import sqlite3
 
-from ..stability import beta
+from ..stability import stable
 from ..tools import tool
 
 
@@ -64,7 +64,7 @@ def _format_table(columns: list[str], rows: list[tuple]) -> str:
     return "\n".join(lines)
 
 
-@beta
+@stable
 @tool(description="Execute a read-only SQL query against a SQLite database")
 def query_sqlite(db_path: str, sql: str, max_rows: int = 100) -> str:
     """
@@ -130,7 +130,7 @@ def query_sqlite(db_path: str, sql: str, max_rows: int = 100) -> str:
             conn.close()
 
 
-@beta
+@stable
 @tool(description="Execute a read-only SQL query against PostgreSQL")
 def query_postgres(connection_string: str, sql: str, max_rows: int = 100) -> str:
     """

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/toolbox/email_tools.py

@@ -20,7 +20,7 @@ from email.message import EmailMessage
 from email.utils import parsedate_to_datetime
 from typing import Optional
 
-from ..stability import beta
+from ..stability import stable
 from ..tools import tool
 
 _DEFAULT_SMTP_PORT = 587
@@ -62,7 +62,7 @@ def _extract_snippet(message: "EmailMessage") -> str:
     return snippet
 
 
-@beta
+@stable
 @tool(description="Send an email via SMTP (TLS)")
 def send_email(
     to: str,
@@ -140,7 +140,7 @@ def send_email(
         return f"Error: Could not connect to SMTP server {host}:{port}: {exc}"
 
 
-@beta
+@stable
 @tool(description="Read the latest emails from an IMAP inbox")
 def read_inbox(
     limit: int = 5,

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/toolbox/github_tools.py

@@ -15,7 +15,7 @@ import urllib.parse
 import urllib.request
 from typing import Any
 
-from ..stability import beta
+from ..stability import stable
 from ..tools import tool
 
 _API_BASE = "https://api.github.com"
@@ -49,7 +49,7 @@ def _github_request(path: str, params: dict[str, str] | None = None) -> Any:
         return json.loads(resp.read().decode("utf-8"))
 
 
-@beta
+@stable
 @tool(description="Search GitHub repositories")
 def github_search_repos(query: str, max_results: int = 5) -> str:
     """
@@ -107,7 +107,7 @@ def github_search_repos(query: str, max_results: int = 5) -> str:
         return f"Error searching GitHub: {e}"
 
 
-@beta
+@stable
 @tool(description="Get file contents from a GitHub repository")
 def github_get_file(repo: str, path: str, ref: str = "main") -> str:
     """
@@ -180,7 +180,7 @@ def github_get_file(repo: str, path: str, ref: str = "main") -> str:
         return f"Error fetching file: {e}"
 
 
-@beta
+@stable
 @tool(description="List issues in a GitHub repository")
 def github_list_issues(repo: str, state: str = "open", max_results: int = 10) -> str:
     """

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/toolbox/linear_tools.py

@@ -16,7 +16,7 @@ import json
 import os
 from typing import Any, Dict, Optional
 
-from ..stability import beta
+from ..stability import stable
 from ..tools import tool
 
 _API_URL = "https://api.linear.app/graphql"
@@ -57,7 +57,7 @@ def _format_graphql_errors(body: Dict[str, Any]) -> str:
     return f"Error: Linear API error: {messages}"
 
 
-@beta
+@stable
 @tool(description="Create an issue in Linear")
 def linear_create_issue(
     team_id: str,
@@ -127,7 +127,7 @@ def linear_create_issue(
         return f"Error creating Linear issue: {type(exc).__name__}: {exc}"
 
 
-@beta
+@stable
 @tool(description="List recent issues in Linear")
 def linear_list_issues(
     team_id: Optional[str] = None,
@@ -206,7 +206,7 @@ def linear_list_issues(
         return f"Error listing Linear issues: {type(exc).__name__}: {exc}"
 
 
-@beta
+@stable
 @tool(description="Update a Linear issue's title, description, or state")
 def linear_update_issue(
     issue_id: str,

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/toolbox/notion_tools.py

@@ -17,7 +17,7 @@ import json
 import os
 from typing import Any, Dict, Optional
 
-from ..stability import beta
+from ..stability import stable
 from ..tools import tool
 
 _API_BASE = "https://api.notion.com/v1"
@@ -53,7 +53,7 @@ def _api_error(response: Any) -> str:
     return f"Error: Notion API returned HTTP {response.status_code}{detail}"
 
 
-@beta
+@stable
 @tool(description="Create a page in Notion")
 def notion_create_page(
     parent_page_id: str,
@@ -123,7 +123,7 @@ def notion_create_page(
         return f"Error creating Notion page: {type(exc).__name__}: {exc}"
 
 
-@beta
+@stable
 @tool(description="Search pages and databases in a Notion workspace")
 def notion_search(query: str, max_results: int = 5, api_key: Optional[str] = None) -> str:
     """
@@ -195,7 +195,7 @@ def notion_search(query: str, max_results: int = 5, api_key: Optional[str] = Non
         return f"Error searching Notion: {type(exc).__name__}: {exc}"
 
 
-@beta
+@stable
 @tool(description="Update a Notion page's title or archive state")
 def notion_update_page(
     page_id: str,

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/toolbox/pdf_tools.py

@@ -12,7 +12,7 @@ from __future__ import annotations
 from pathlib import Path
 from typing import List, Optional
 
-from ..stability import beta
+from ..stability import stable
 from ..tools import tool
 
 _MAX_OUTPUT_CHARS = 20_000
@@ -49,7 +49,7 @@ def _parse_page_spec(pages: Optional[str], page_count: int) -> List[int]:
     return sorted(set(selected))
 
 
-@beta
+@stable
 @tool(description="Extract text content from a PDF file")
 def extract_pdf_text(path: str, pages: Optional[str] = None) -> str:
     """
@@ -97,7 +97,7 @@ def extract_pdf_text(path: str, pages: Optional[str] = None) -> str:
         return f"Error reading PDF: {type(exc).__name__}: {exc}"
 
 
-@beta
+@stable
 @tool(description="Extract tables from a PDF file")
 def extract_pdf_tables(path: str, pages: Optional[str] = None) -> str:
     """

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/toolbox/search_tools.py

@@ -14,7 +14,7 @@ import urllib.request
 from typing import Optional
 
 from .._ssrf import validate_url as _validate_url
-from ..stability import beta
+from ..stability import stable
 from ..tools import tool
 
 _MAX_OUTPUT_BYTES = 10 * 1024  # 10 KB
@@ -43,7 +43,7 @@ def _strip_html_tags(text: str) -> str:
     return text.strip()
 
 
-@beta
+@stable
 @tool(description="Search the web using DuckDuckGo (no API key needed)")
 def web_search(query: str, num_results: int = 5) -> str:
     """
@@ -121,7 +121,7 @@ def web_search(query: str, num_results: int = 5) -> str:
         return f"Error performing web search: {e}"
 
 
-@beta
+@stable
 @tool(description="Fetch a URL and extract text content")
 def scrape_url(url: str, selector: Optional[str] = None) -> str:
     """

{selectools-0.28.0 → selectools-0.29.0}/src/selectools/toolbox/slack_tools.py

@@ -17,7 +17,7 @@ from __future__ import annotations
 import os
 from typing import Any, Optional
 
-from ..stability import beta
+from ..stability import stable
 from ..tools import tool
 
 _MISSING_DEP_ERROR = (
@@ -46,7 +46,7 @@ def _slack_error(exc: Any) -> str:
     return f"Error: Slack API call failed: {type(exc).__name__}"
 
 
-@beta
+@stable
 @tool(description="Send a message to a Slack channel")
 def slack_send_message(channel: str, text: str, token: Optional[str] = None) -> str:
     """
@@ -88,7 +88,7 @@ def slack_send_message(channel: str, text: str, token: Optional[str] = None) ->
         return f"Error sending Slack message: {type(exc).__name__}"
 
 
-@beta
+@stable
 @tool(description="Read recent messages from a Slack channel")
 def slack_read_channel(channel: str, limit: int = 10, token: Optional[str] = None) -> str:
     """
@@ -144,7 +144,7 @@ def slack_read_channel(channel: str, limit: int = 10, token: Optional[str] = Non
         return f"Error reading Slack channel: {type(exc).__name__}"
 
 
-@beta
+@stable
 @tool(description="Search Slack messages across the workspace")
 def slack_search_messages(query: str, count: int = 10, token: Optional[str] = None) -> str:
     """

{selectools-0.28.0 → selectools-0.29.0/src/selectools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: selectools
-Version: 0.28.0
+Version: 0.29.0
 Summary: Production-ready Python framework for AI agents with multi-agent graphs, hybrid RAG, guardrails, audit logging, 50 evaluators, and a visual builder. Supports OpenAI, Anthropic, Gemini, Ollama. By NichevLabs.
 Author-email: John Nichev <johnnichev@gmail.com>
 Maintainer-email: NichevLabs <support@nichevlabs.com>
@@ -118,6 +118,19 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 # selectools serve agent.yaml
 ```
 
+## What's New in v0.29
+
+### v0.29.0 — Stability Promotions (v1.0 Freeze Prep)
+
+The first beta → stable promotion pass toward the 1.0 API freeze. Additive only — promotions strengthen guarantees, nothing is removed or renamed.
+
+- **24 mature toolbox tools promoted to `@stable`** — calculator, code (incl. `execute_shell`), db, email, GitHub, Linear, Notion, PDF, web search, and Slack tools. They're 4–15 releases old with frozen signatures.
+- **`orchestration`, `patterns`, and `policy` are now stable modules** — their public surfaces (AgentGraph, the checkpoint stores, all five pattern agents, ToolPolicy) were already frozen in v0.25; this aligns the module-level promise. Also promoted `SessionSearchResult` and `PlanningConfig`.
+- **Held `@beta` on purpose** — the v0.27.0 additions (recall tool, injection guardrail, cache-rate cost, Mongo/Dynamo session stores) get one more cycle, and `evals` stays a beta module while its 50 evaluator classes keep growing (its 7 core types are `@stable`).
+- **New `scripts/stability_audit.py`** reports any symbol whose marker disagrees with its module promise, so promotion passes are reproducible.
+
+See `CHANGELOG.md` for the full entry.
+
 ## What's New in v0.28
 
 ### v0.28.0 — Hardening Sweep: Shell Safety, Session Namespaces & Typed Public API

{selectools-0.28.0 → selectools-0.29.0}/tests/test_architecture.py

@@ -511,21 +511,21 @@ EXPECTED_MODULE_STABILITY = {
     "observe.otel": "beta",
     "observe.trace_store": "beta",
     "observer": "stable",
-    "orchestration": "beta",
-    "orchestration.checkpoint": "beta",
-    "orchestration.graph": "beta",
-    "orchestration.node": "beta",
-    "orchestration.state": "beta",
-    "orchestration.supervisor": "beta",
+    "orchestration": "stable",
+    "orchestration.checkpoint": "stable",
+    "orchestration.graph": "stable",
+    "orchestration.node": "stable",
+    "orchestration.state": "stable",
+    "orchestration.supervisor": "stable",
     "parser": "stable",
-    "patterns": "beta",
-    "patterns.debate": "beta",
-    "patterns.plan_and_execute": "beta",
-    "patterns.reflective": "beta",
-    "patterns.team_lead": "beta",
+    "patterns": "stable",
+    "patterns.debate": "stable",
+    "patterns.plan_and_execute": "stable",
+    "patterns.reflective": "stable",
+    "patterns.team_lead": "stable",
     "pending": "beta",
     "pipeline": "beta",
-    "policy": "beta",
+    "policy": "stable",
     "pricing": "stable",
     "prompt": "stable",
     "providers": "stable",

{selectools-0.28.0 → selectools-0.29.0}/tests/test_sessions_supabase.py

@@ -641,3 +641,34 @@ class TestSupabaseSessionStoreSearch:
 
         results = store.search('"quartz"')
         assert [r.session_id for r in results] == ["s2"]
+
+
+def test_search_sends_validated_postgrest_json_filter() -> None:
+    """search() filters on the ``memory_json->>messages`` text projection.
+
+    ``col->>key`` is valid PostgREST syntax (extracts a JSON field as text) —
+    confirmed against the Supabase docs (e.g. ``metadata->>stuff`` in a filter).
+    A 2026-06-15 audit flagged this as "always returns empty"; that was a false
+    positive. This test locks the exact column expression so a refactor can't
+    silently send invalid syntax (which WOULD make server-side search empty),
+    and asserts the term is JSON-escaped to match the escaped jsonb projection.
+    """
+    recorded: list = []
+
+    class _RecordingBuilder(FakeQueryBuilder):
+        def ilike(self, col: str, pattern: str) -> "FakeQueryBuilder":
+            recorded.append((col, pattern))
+            return super().ilike(col, pattern)
+
+    class _RecordingClient(FakeSupabaseClient):
+        def table(self, name: str) -> "FakeQueryBuilder":
+            return _RecordingBuilder(self._data, name, "select")
+
+    store = _make_store(_RecordingClient())
+    store.save("s1", _search_memory("quartz crystal"))
+    store.search("quartz")
+
+    assert recorded, "search() issued no ilike filter"
+    assert {col for col, _ in recorded} == {"memory_json->>messages"}
+    # The pattern is wrapped in % and lower-cased per term.
+    assert all(p.startswith("%") and p.endswith("%") for _, p in recorded)