langgraph-api 0.12.0.dev15__py3-none-any.whl → 0.12.0.dev17__py3-none-any.whl

langgraph_api/__init__.py

@@ -1 +1 @@
-__version__ = "0.12.0.dev15"
+__version__ = "0.12.0.dev17"

langgraph_api/api/meta.py

@@ -79,6 +79,7 @@ async def meta_info(request: ApiRequest):
                 "langsmith": bool(config.LANGSMITH_CONTROL_PLANE_API_KEY)
                 and bool(config.TRACING),
                 "langsmith_tracing_replicas": True,
+                "langsmith_tracing_session_on_runs": True,
             },
             "host": {
                 "kind": metadata.HOST,

langgraph_api/grpc/ops/runs.py

@@ -383,6 +383,9 @@ def proto_to_run(proto_run: pb.Run) -> Run:
         "multitask_strategy": MULTITASK_STRATEGY_FROM_PB.get(
             proto_run.multitask_strategy
         ),
+        "langsmith_session_name": proto_run.langsmith_session_name
+        if proto_run.HasField("langsmith_session_name")
+        else None,
     }
 
 
@@ -588,6 +591,7 @@ class Runs(Authenticated):
         if_not_exists: IfNotExists = "reject",
         after_seconds: int = 0,
         ctx: Any = None,
+        langsmith_session_name: str | None = None,
     ) -> AsyncIterator[Run]:
         """Create a run."""
         metadata = metadata or {}
@@ -662,6 +666,9 @@ class Runs(Authenticated):
         if after_seconds > 0:
             request_kwargs["after_seconds"] = int(after_seconds)
 
+        if langsmith_session_name is not None:
+            request_kwargs["langsmith_session_name"] = langsmith_session_name
+
         # Build encryption context for Go layer
         enc_ctx = build_encryption_context("run")
         if enc_ctx is not None:

langgraph_api/models/run.py

@@ -10,6 +10,7 @@ import structlog
 from starlette.exceptions import HTTPException
 from typing_extensions import TypedDict
 
+from langgraph_api import config as api_config
 from langgraph_api.auth.noop import UnauthenticatedUser
 from langgraph_api.encryption.middleware import encrypt_request
 from langgraph_api.encryption.shared import (
@@ -35,6 +36,7 @@ from langgraph_api.schema import (
     RunCommand,
     StreamMode,
 )
+from langgraph_api.tracing_session import resolve_tracing_session_name
 from langgraph_api.utils import AsyncConnectionProto, get_auth_ctx, get_user_id
 from langgraph_api.utils.headers import get_configurable_headers
 from langgraph_api.utils.uuids import uuid7
@@ -300,6 +302,10 @@ async def create_valid_run(
     if webhook := payload.get("webhook"):
         await validate_webhook_url_or_raise(str(webhook))
 
+    langsmith_session_name = (
+        resolve_tracing_session_name(payload) if api_config.TRACING else None
+    )
+
     # We can't pass payload directly because config and context have
     # been modified above (with auth context, checkpoint info, etc.)
     fields_to_encrypt = {
@@ -346,6 +352,7 @@ async def create_valid_run(
         prevent_insert_if_inflight=prevent_insert_if_inflight,
         after_seconds=after_seconds,
         if_not_exists=if_not_exists,
+        langsmith_session_name=langsmith_session_name,
     )
     run_ = await run_coro
 

langgraph_api/schema.py

@@ -255,6 +255,8 @@ class Run(TypedDict):
     """The run kwargs."""
     multitask_strategy: MultitaskStrategy
     """Strategy to handle concurrent runs on the same thread."""
+    langsmith_session_name: str | None
+    """LangSmith tracing session (project) name for this run, if tracing is enabled."""
 
 
 class RunSend(TypedDict):
@@ -359,6 +361,7 @@ RunSelectField = Literal[
     "metadata",
     "kwargs",
     "multitask_strategy",
+    "langsmith_session_name",
 ]
 RUN_FIELDS: set[str] = set(RunSelectField.__args__)
 

langgraph_api/tracing_session.py

@@ -0,0 +1,22 @@
+"""LangSmith tracing session helpers."""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any
+
+from langsmith.utils import get_tracer_project
+
+
+def resolve_tracing_session_name(payload: Mapping[str, Any]) -> str:
+    """Return the LangSmith session (project) name for a run.
+
+    Per-run ``langsmith_tracer.project_name`` overrides the deployment default
+    from ``LANGSMITH_PROJECT`` / ``LANGCHAIN_PROJECT``.
+    """
+    ls_tracing = payload.get("langsmith_tracer")
+    if isinstance(ls_tracing, Mapping):
+        project_name = ls_tracing.get("project_name")
+        if isinstance(project_name, str) and project_name:
+            return project_name
+    return get_tracer_project()

{langgraph_api-0.12.0.dev15.dist-info → langgraph_api-0.12.0.dev17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.12.0.dev15
+Version: 0.12.0.dev17
 Author-email: Will Fu-Hinthorn <will@langchain.dev>, Josh Rogers <josh@langchain.dev>, Parker Rule <parker@langchain.dev>
 License: Elastic-2.0
 License-File: LICENSE

{langgraph_api-0.12.0.dev15.dist-info → langgraph_api-0.12.0.dev17.dist-info}/RECORD

@@ -1,4 +1,4 @@
-langgraph_api/__init__.py,sha256=3hHYNZlyWnoc9JVCLo-c7OAsrbQDPhSBvtrj8CKX1z4,29
+langgraph_api/__init__.py,sha256=7OXdM1PuKj42WlPEpYsH7Ln8cgRnfN3ECCN17_8jZvk,29
 langgraph_api/_factory_utils.py,sha256=5JsiJbg_YocVSryN2jwoZTg03-eyymlWMK6sKCmXwz0,5756
 langgraph_api/asgi_transport.py,sha256=XApY3lIWBZTMbbsl8dDJzl0cLGirmAGE0SifqZUnXvs,11896
 langgraph_api/asyncio.py,sha256=smqyAoO9nIyPPQRw1IVSCh85fwoZP4PEo-5dDhxGruc,10676
@@ -21,7 +21,7 @@ langgraph_api/patch.py,sha256=ViUknYvyQWS6y0f5XuaEoci2qB_mQv8vZl-oaUxsI6M,1448
 langgraph_api/queue_entrypoint.py,sha256=-9YnY_GhmDxEiGCc3k-7UqRKK_M3dPriits2iGgYlgU,11327
 langgraph_api/release_tags.py,sha256=BjgGj2vFcA7I0MDRXLw1sUA4jquz-DaKVS0Eq-dYSjE,9091
 langgraph_api/route.py,sha256=_KE8A8Q-J-QfqjGlyM2Kc6n5cirmgt8xmI5-pI8kVEE,8837
-langgraph_api/schema.py,sha256=I_ciXy4YE3Ri4-PAWIvqLNRH2FpC4goTkKwfFwk6wIQ,15100
+langgraph_api/schema.py,sha256=4VhH4V9RmvBqO9MMPbaKk80PUQrPFyTMjDTT8nAZZ6w,15257
 langgraph_api/self_hosted_logs.py,sha256=FoUkPdtpt-nuEhejne8o1Q2phE9CccoHdoR_PvXPcBU,4442
 langgraph_api/self_hosted_metrics.py,sha256=pWsQQ-2ukoFIbmVfzNOSkwCqZ5Cnts6pRSWTII44Ll4,16844
 langgraph_api/serde.py,sha256=V3fO9bkUOlBX3okw5Qi31nlcr59fcuXMgL7DHNyarZY,8855
@@ -32,6 +32,7 @@ langgraph_api/store.py,sha256=i-jVfWzDEmPESVofh1tNWbo0HMLiLz_BSKKV4QjN-dE,5027
 langgraph_api/stream.py,sha256=rJIGe8rEeS6QxQfsDKomUBRED6ZPIF-ALtx4D8Gw0JQ,33348
 langgraph_api/stream_v2.py,sha256=KCIsPf6gs_jrIdZ8D2VTEi5c5p5aRNpVNhMP4kzjp2g,10824
 langgraph_api/traceblock.py,sha256=GhgAtLhAQ8Z8LHtRQq3par-rfPpRBQp2Q7WBACJq1NI,677
+langgraph_api/tracing_session.py,sha256=gmfv-BW1XRar6suVur1P4rTVKWkjElDEb2hhkBduWOs,728
 langgraph_api/validation.py,sha256=XyeKyt7jAICmIlT_b0J0mv2YbwIbNoe4m6zEmfk9gOA,14657
 langgraph_api/webhook.py,sha256=qXEtkE6orek2POeOQmPRsEarJgXIYp-LBrZB-OwITxc,9572
 langgraph_api/worker.py,sha256=HGirbQ1i1hxaayORoihsQ6JMVAq3VsrC8CUxAHwY9t0,21151
@@ -42,7 +43,7 @@ langgraph_api/api/__init__.py,sha256=Zu1ew3dxYZu7cLRAjn-6HcYmtuQBdihlVFMKMJ77Y3c
 langgraph_api/api/a2a.py,sha256=VPllgqfoLUQD6Eqob3RjcegjtKgLhphNGTrTqbNLoIY,95135
 langgraph_api/api/assistants.py,sha256=4v1TpkeeSF7vFrbnOKIvh7BY4K0WamzEdMeTAzwRElE,20786
 langgraph_api/api/event_streaming.py,sha256=nvoaKz4QGklX5YUmY9WQ3vSwhQ1Q81QeQWNR8aEXUz8,17571
-langgraph_api/api/meta.py,sha256=4vqfgJYIqaqwZPfdmvHN00Co7SdeYSnQ1STxyvGWVDw,4698
+langgraph_api/api/meta.py,sha256=5s017GfMs-Ghq6Z5K6yW4UjbVFzCsmeXKn4UEJmfs98,4757
 langgraph_api/api/openapi.py,sha256=Zkdlb9mjrQyHro1TtrDIWVuaBDovxx-uGWJ1fZMOg54,12604
 langgraph_api/api/profile.py,sha256=CA1ZkHALOuP8orYTICnEhcG_JnnA2wnyjbWyeb117jA,3455
 langgraph_api/api/runs.py,sha256=h5droLgaz_aAyILCRJIpbj2KH1PbijCeXcggOSa3Zww,35178
@@ -90,7 +91,7 @@ langgraph_api/grpc/ops/__init__.py,sha256=ACO-Cp7ygehNfOG1ucSH8iMw3hVXbLluxiqczG
 langgraph_api/grpc/ops/assistants.py,sha256=00vY7Dd7BcXaVp_6UrKZIb5b4tQ8Lm5MxJcEpyVPfo0,13902
 langgraph_api/grpc/ops/cache.py,sha256=MoPAmSuOwbt2Cud1YZJm_YJeaDHPFy1IiV4m0PDImgg,1399
 langgraph_api/grpc/ops/crons.py,sha256=oGPW9qW-J4H9baX7Jsee1opsFnXfThHLHh_N47mDf9s,19596
-langgraph_api/grpc/ops/runs.py,sha256=dD2Rne9EBU7z4lGF3OicpIMZNU4MBNbbli1Hw5gz2tw,41479
+langgraph_api/grpc/ops/runs.py,sha256=4-Mp-4MgDAn8uerLrOpmXuUqOdfcnzSmb3hSRlO8HhM,41798
 langgraph_api/grpc/ops/threads.py,sha256=SJraV838nZ0m6wRrCia7sLYh8KK1WfY7x5xmcspZLek,48140
 langgraph_api/grpc/servicers/__init__.py,sha256=l8yqTA_gMbIj0xHw5-RZYo0JbjL-EpFD8RxPMgW_-bA,422
 langgraph_api/grpc/servicers/checkpointer.py,sha256=aeB2hzsDxbb9i-ildx-kylpDxaYtpAUSG6rphOzbDOs,10482
@@ -130,7 +131,7 @@ langgraph_api/middleware/http_logger.py,sha256=jjqLBPqoGRC1UfB2VYKPY2tkq6gT7Rm88
 langgraph_api/middleware/private_network.py,sha256=eQEzWI8epBNUCiNsMu9O27ofHBQ45M0p2OZy5YdUYos,2097
 langgraph_api/middleware/request_id.py,sha256=-p230Q5jDJAJLmSZRqQvB4dFFkJS9B4Vwg6pUgQtI24,1259
 langgraph_api/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langgraph_api/models/run.py,sha256=LfL8nPLPVA0dZMXA_hzfl2GKsZGyPiVW36B0MbbSosc,15793
+langgraph_api/models/run.py,sha256=1jA7HywYT95ekz_gMBkR0dnzR_1gdl5vhqDaackAlwA,16082
 langgraph_api/timing/__init__.py,sha256=lWXHCGh71I8ouF0wUznYRMKHAQ-8VQHF9gf9jkeV5dg,526
 langgraph_api/timing/profiler.py,sha256=_n0qJYJMjCGo95RDuH5z8FIzePGNSNbnm3cvGmcgn6A,6186
 langgraph_api/timing/timer.py,sha256=lC_xu4rlejkFPxqV6k_FD4dWtjpT9cEICBP333hAxTg,9404
@@ -161,17 +162,17 @@ langgraph_runtime/store.py,sha256=7mowndlsIroGHv3NpTSOZDJR0lCuaYMBoTnTrewjslw,11
 LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
 hatch_build.py,sha256=Nn9N-EFfVqmH5q3iCUrhqX6zc7qT1jLI3gWSBN2xgYQ,1738
 logging.json,sha256=sBy8HDDPuucpLbLUD6e8t5fsiQjJoklZsbVHi2qQ7aQ,367
-openapi.json,sha256=0N-D4j0_3ruH6nMF4k5lnqmpV-aoB5Se-WWheCQuQQs,219552
+openapi.json,sha256=_gcvdkH6zWjzvEZ4YPGpJ0AMzTwM1cbJlpVgJSxzM8I,219880
 langgraph_grpc_common/__init__.py,sha256=sO7jFHekQxt6zZPhTPZAWLYLB_S8w7-VuJ7NyWFlFNo,97
 langgraph_grpc_common/checkpointer.py,sha256=u3ERFgqnUCpCYpOSxKR_6Jvo_tR4yDvq7qU-EL61bSg,14022
 langgraph_grpc_common/serde.py,sha256=pxIhgxtrXtwWVhAlLE2LAeSAuKk2ZHtnvAP3DRDT2Qw,6184
-langgraph_grpc_common/store.py,sha256=BIHYT_BTw2ByFAIsomu9vwNVu1kZdUEOjkJChV7rjuA,3721
+langgraph_grpc_common/store.py,sha256=SizRCSOoNVbCHzsNuyuzC9dQdKi4x4WOV5S7pqYWdp8,3846
 langgraph_grpc_common/conversion/__init__.py,sha256=pLsOrRtmF9YkgmCPhcfym6lYOB7PCJTRItyo1YK_AT8,208
 langgraph_grpc_common/conversion/_compat.py,sha256=MIEo69I7tfaPskunPGwBCKheksLwxpw-z-4O3hvO9og,4010
 langgraph_grpc_common/conversion/checkpoint.py,sha256=Ty81cijafeal7blzzXbYFjWpu9iXVb_spFLBZ2FvmgI,12045
 langgraph_grpc_common/conversion/config.py,sha256=HjlHRX-_GpKa1m0RWVL1PEZQCvA3w_8wKVYrtaT06do,13015
 langgraph_grpc_common/conversion/durability.py,sha256=FWhqjzVN4JrrsAL9AwsJkvIorQGNRl14w97Va-WZRk0,991
-langgraph_grpc_common/conversion/store.py,sha256=NGGZp4FiMzJXByIqRRy2qYDxlWeXBGkEN9k1aNTsVUA,6253
+langgraph_grpc_common/conversion/store.py,sha256=ctWDdgpJHEkkCeguWSwmISlS8OJLJLP9srwib-Hi_OE,15211
 langgraph_grpc_common/conversion/struct.py,sha256=yk4jpPdywzn8UosAohun21lU5D_IIglOY9rkBhiG-gA,2072
 langgraph_grpc_common/conversion/value.py,sha256=eZ9fDqKje9tKsO8A_6f0BPSI7lt94Vzuu3NNEEYLFBM,8343
 langgraph_grpc_common/proto/__init__.py,sha256=eBejrrULiDdasi3_Hga_AJW8ZPMkjKyyAeW9Ey640Ks,1375
@@ -179,8 +180,8 @@ langgraph_grpc_common/proto/checkpointer_pb2.py,sha256=c-gaVwNHm7sUzThJDzumME2M_
 langgraph_grpc_common/proto/checkpointer_pb2.pyi,sha256=rGUxQyNFifmu8OPy0S418sCWSBQY_CVckobPXtFfZfs,20763
 langgraph_grpc_common/proto/checkpointer_pb2_grpc.py,sha256=MLhZ7M4g9gjfXZqWenk93oO2uIZSybbFoaeU8bauFPA,20176
 langgraph_grpc_common/proto/checkpointer_pb2_grpc.pyi,sha256=8fPL90WjHnMaREG7l9qYt5fQePeT8YFWQ0qVy56QtYw,10210
-langgraph_grpc_common/proto/core_api_pb2.py,sha256=xbzqAKhwvgc_-J5BlqS7krhOlgKsRgzrb7uhGax1jbo,50813
-langgraph_grpc_common/proto/core_api_pb2.pyi,sha256=lN5P83sM9_gvlPGOkDQIUEq9QDiiffmY2MIQOZtdV7s,206457
+langgraph_grpc_common/proto/core_api_pb2.py,sha256=ggBZW9ywqm2Y4lgpWURuxd0bfit_JUMb1zSZ11UMylc,51014
+langgraph_grpc_common/proto/core_api_pb2.pyi,sha256=1AtbsmQcOzwYSODInI9mEioWcBCtcc3VNBra7FEXICw,207984
 langgraph_grpc_common/proto/core_api_pb2_grpc.py,sha256=zIfWY664xF4r9c48Ys1OcYN4dEmtIWAwYiCzP7gsyLI,81342
 langgraph_grpc_common/proto/core_api_pb2_grpc.pyi,sha256=XLu2-5YZHm9QyZWjWsnUWe7uN6n1-avVvsyR6N5D3fs,29325
 langgraph_grpc_common/proto/encryption_pb2.py,sha256=W9Zs5gclBzKfwHfKDB_83tFfabR9_KK2Lq81xVYleMQ,3355
@@ -231,12 +232,12 @@ langgraph_grpc_common/proto/errors_pb2.py,sha256=JI6x-vBK1AE7DHZ5DQwN1mZWF6C4xTR
 langgraph_grpc_common/proto/errors_pb2.pyi,sha256=rd3-BYUH8V-aO66taL7OOblaLgdrDtf1Vcd38GUoVVM,2181
 langgraph_grpc_common/proto/errors_pb2_grpc.py,sha256=2-LwQ0OPGo-NtC0269q7Fw6GPBxnTLYWq3xP5Eq0_YA,886
 langgraph_grpc_common/proto/errors_pb2_grpc.pyi,sha256=uC9Wnq6uyg488QiONpJ0ba1s_iouQCOYsjd_FDd1XUM,495
-langgraph_grpc_common/proto/store_pb2.py,sha256=5px40nIUag8p0KlE6o5vpvgfenX71BDIr3VjFfFQP6E,3406
-langgraph_grpc_common/proto/store_pb2.pyi,sha256=cZZGod9tBReUukPkjNzssEdz5OBoZ2pecXugbp-9Lmo,9755
+langgraph_grpc_common/proto/store_pb2.py,sha256=uAYM7OcdEOK12iRcPYihC2suSeCo_QdbpNSWfDIkXf8,7652
+langgraph_grpc_common/proto/store_pb2.pyi,sha256=_dcxyxV8moR6H67qU42r2h2p_Ub-PZSHs3OoS9KMdSY,27782
 langgraph_grpc_common/proto/store_pb2_grpc.py,sha256=wSD65QgFkYTkPTHcf7VhyI2FQ7UH_RgIf3vQW3VYlsM,3324
 langgraph_grpc_common/proto/store_pb2_grpc.pyi,sha256=oS1h2cDoq2OjyM8xazcmc8LwRDC5oCAD0zto2QUmPQw,2027
-langgraph_api-0.12.0.dev15.dist-info/METADATA,sha256=nc5DmJfxPOxGO2rAoxSIuNyd_s0yNxlCB-M8FZGlWL8,4631
-langgraph_api-0.12.0.dev15.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-langgraph_api-0.12.0.dev15.dist-info/entry_points.txt,sha256=hGedv8n7cgi41PypMfinwS_HfCwA7xJIfS0jAp8htV8,78
-langgraph_api-0.12.0.dev15.dist-info/licenses/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
-langgraph_api-0.12.0.dev15.dist-info/RECORD,,
+langgraph_api-0.12.0.dev17.dist-info/METADATA,sha256=7Ir52CwtjuY0ASAp6p09CkQVEUvxfqmb9mQoN7o-cgE,4631
+langgraph_api-0.12.0.dev17.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+langgraph_api-0.12.0.dev17.dist-info/entry_points.txt,sha256=hGedv8n7cgi41PypMfinwS_HfCwA7xJIfS0jAp8htV8,78
+langgraph_api-0.12.0.dev17.dist-info/licenses/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
+langgraph_api-0.12.0.dev17.dist-info/RECORD,,

langgraph_grpc_common/conversion/store.py

@@ -11,9 +11,13 @@ from langgraph.store.base import (
     GetOp,
     IndexConfig,
     Item,
+    ListNamespacesOp,
+    MatchCondition,
     Op,
     PutOp,
     Result,
+    SearchItem,
+    SearchOp,
     ensure_embeddings,
     get_text_at_path,
     tokenize_path,
@@ -64,10 +68,92 @@ def _ttl_to_proto_minutes(ttl: float | None) -> int:
     return int(ttl)
 
 
+# Ordered comparisons compare the *text* form of the field (value->>key); $eq/$ne
+# are handled separately as jsonb comparisons.
+_FILTER_OP_BY_NAME = {
+    "$gt": store_pb2.FILTER_OP_GT,
+    "$gte": store_pb2.FILTER_OP_GTE,
+    "$lt": store_pb2.FILTER_OP_LT,
+    "$lte": store_pb2.FILTER_OP_LTE,
+}
+
+# pgvector distance / column types come from the index config as strings; map
+# them to the wire enums (see store.proto DistanceType / VectorType).
+_DISTANCE_TYPE_BY_NAME = {
+    "cosine": store_pb2.DISTANCE_TYPE_COSINE,
+    "l2": store_pb2.DISTANCE_TYPE_L2,
+    "inner_product": store_pb2.DISTANCE_TYPE_INNER_PRODUCT,
+}
+_VECTOR_TYPE_BY_NAME = {
+    "vector": store_pb2.VECTOR_TYPE_VECTOR,
+    "halfvec": store_pb2.VECTOR_TYPE_HALFVEC,
+}
+
+# ListNamespaces match type: langgraph uses the strings "prefix"/"suffix".
+_MATCH_TYPE_BY_NAME = {
+    "prefix": store_pb2.MATCH_TYPE_PREFIX,
+    "suffix": store_pb2.MATCH_TYPE_SUFFIX,
+}
+_MATCH_TYPE_TO_NAME = {op: name for name, op in _MATCH_TYPE_BY_NAME.items()}
+
+
+def _match_type_to_proto(match_type: str) -> int:
+    proto = _MATCH_TYPE_BY_NAME.get(match_type)
+    if proto is None:
+        raise ValueError(f"Unsupported list_namespaces match_type: {match_type!r}")
+    return proto
+
+
+def _filter_to_conditions(
+    filter_dict: dict[str, Any],
+) -> list[store_pb2.FilterCondition]:
+    """Flatten a langgraph filter dict into typed FilterConditions.
+
+    A plain value is an equality match; a dict is a set of operator comparisons.
+    $eq/$ne compare as jsonb; $gt/$gte/$lt/$lte compare on the text form of the
+    value (str(value), produced here so the store never re-derives it). Mirrors
+    OSS PostgresStore._get_filter_condition, done in Python where the DSL is
+    native so the store only maps op -> SQL.
+    """
+    conditions: list[store_pb2.FilterCondition] = []
+    for key, value in filter_dict.items():
+        if isinstance(value, dict):
+            for op_name, op_val in value.items():
+                if op_name in ("$eq", "$ne"):
+                    op = (
+                        store_pb2.FILTER_OP_EQ
+                        if op_name == "$eq"
+                        else store_pb2.FILTER_OP_NE
+                    )
+                    conditions.append(
+                        store_pb2.FilterCondition(
+                            key=key, op=op, operand=orjson.dumps(op_val).decode()
+                        )
+                    )
+                elif op_name in _FILTER_OP_BY_NAME:
+                    conditions.append(
+                        store_pb2.FilterCondition(
+                            key=key, op=_FILTER_OP_BY_NAME[op_name], operand=str(op_val)
+                        )
+                    )
+                else:
+                    raise ValueError(f"Unsupported filter operator: {op_name}")
+        else:
+            conditions.append(
+                store_pb2.FilterCondition(
+                    key=key,
+                    op=store_pb2.FILTER_OP_EQ,
+                    operand=orjson.dumps(value).decode(),
+                )
+            )
+    return conditions
+
+
 def op_to_proto(
     op: Op,
     *,
     vectors: Sequence[store_pb2.VectorValue] | None = None,
+    search_vector: store_pb2.VectorSearch | None = None,
 ) -> store_pb2.Op:
     if isinstance(op, GetOp):
         return store_pb2.Op(
@@ -78,9 +164,14 @@ def op_to_proto(
             )
         )
     if isinstance(op, PutOp):
+        # A PutOp with value=None is a delete in OSS; on the gRPC path it maps to
+        # an explicit DeleteOp so an empty value can't be mistaken for a delete.
         if op.value is None:
-            raise TypeError(
-                "PutOp with value=None (delete) is not supported by gRPC store"
+            return store_pb2.Op(
+                delete=store_pb2.DeleteOp(
+                    namespace=list(op.namespace),
+                    key=str(op.key),
+                )
             )
         put_kwargs: dict[str, Any] = {
             "namespace": list(op.namespace),
@@ -91,6 +182,36 @@ def op_to_proto(
         if vectors is not None:
             put_kwargs["vectors"] = list(vectors)
         return store_pb2.Op(put=store_pb2.PutOp(**put_kwargs))
+    if isinstance(op, SearchOp):
+        # The natural-language query itself is not sent: Python embeds it into
+        # `search_vector`, which is the only semantic-search signal the store needs.
+        search_kwargs: dict[str, Any] = {
+            "namespace_prefix": list(op.namespace_prefix),
+            "limit": op.limit,
+            "offset": op.offset,
+            "refreshTTL": op.refresh_ttl,
+        }
+        if op.filter:
+            search_kwargs["filter"] = _filter_to_conditions(op.filter)
+        if search_vector is not None:
+            search_kwargs["vector"] = search_vector
+        return store_pb2.Op(search=store_pb2.SearchOp(**search_kwargs))
+    if isinstance(op, ListNamespacesOp):
+        list_kwargs: dict[str, Any] = {
+            "limit": op.limit,
+            "offset": op.offset,
+        }
+        if op.match_conditions:
+            list_kwargs["match_conditions"] = [
+                store_pb2.MatchCondition(
+                    match_type=_match_type_to_proto(mc.match_type),
+                    path=list(mc.path),
+                )
+                for mc in op.match_conditions
+            ]
+        if op.max_depth is not None:
+            list_kwargs["max_depth"] = op.max_depth
+        return store_pb2.Op(list_namespaces=store_pb2.ListNamespacesOp(**list_kwargs))
     raise TypeError(f"unsupported op: {type(op).__name__}")
 
 
@@ -114,6 +235,35 @@ def op_from_proto(msg: store_pb2.Op) -> Op:
             value=orjson.loads(p.value_json),
             ttl=ttl,
         )
+    if kind == "delete":
+        d = msg.delete
+        return PutOp(namespace=tuple(d.namespace), key=d.key, value=None)
+    if kind == "search":
+        s = msg.search
+        # `query` (embedded into `vector`) and `filter` (flattened to typed
+        # conditions) are one-directional encodings, not reconstructed here; the
+        # store consumes them and Python never decodes a SearchOp in production.
+        return SearchOp(
+            namespace_prefix=tuple(s.namespace_prefix),
+            limit=s.limit,
+            offset=s.offset,
+            refresh_ttl=s.refreshTTL,
+        )
+    if kind == "list_namespaces":
+        ln = msg.list_namespaces
+        return ListNamespacesOp(
+            match_conditions=tuple(
+                MatchCondition(
+                    match_type=_MATCH_TYPE_TO_NAME[mc.match_type],
+                    path=tuple(mc.path),
+                )
+                for mc in ln.match_conditions
+            )
+            or None,
+            max_depth=ln.max_depth if ln.HasField("max_depth") else None,
+            limit=ln.limit,
+            offset=ln.offset,
+        )
     raise ValueError("empty Op message (no oneof set)")
 
 
@@ -128,6 +278,20 @@ def result_to_proto(result: Result, op: Op) -> store_pb2.OpResult:
         return store_pb2.OpResult(item=_item_to_proto(result))
     if isinstance(op, PutOp):
         return store_pb2.OpResult(none=empty_pb2.Empty())
+    if isinstance(op, SearchOp):
+        items = cast("list[SearchItem]", result or [])
+        return store_pb2.OpResult(
+            search=store_pb2.SearchResult(
+                items=[_search_item_to_proto(item) for item in items]
+            )
+        )
+    if isinstance(op, ListNamespacesOp):
+        namespaces = cast("list[tuple[str, ...]]", result or [])
+        return store_pb2.OpResult(
+            list_namespaces=store_pb2.ListNamespacesResult(
+                namespaces=[store_pb2.Namespace(parts=list(ns)) for ns in namespaces]
+            )
+        )
     raise TypeError(f"unsupported op for result encoding: {type(op).__name__}")
 
 
@@ -137,6 +301,10 @@ def result_from_proto(msg: store_pb2.OpResult) -> Result:
         return None
     if kind == "item":
         return _item_from_proto(msg.item)
+    if kind == "search":
+        return [_search_item_from_proto(item) for item in msg.search.items]
+    if kind == "list_namespaces":
+        return [tuple(ns.parts) for ns in msg.list_namespaces.namespaces]
     raise ValueError("empty OpResult message (no oneof set)")
 
 
@@ -160,6 +328,30 @@ def _item_from_proto(msg: store_pb2.Item) -> Item:
     )
 
 
+def _search_item_to_proto(item: SearchItem) -> store_pb2.SearchItem:
+    kwargs: dict[str, Any] = {
+        "namespace": list(item.namespace),
+        "key": item.key,
+        "value_json": orjson.dumps(item.value),
+        "created_at": _format_dt(item.created_at),
+        "updated_at": _format_dt(item.updated_at),
+    }
+    if item.score is not None:
+        kwargs["score"] = item.score
+    return store_pb2.SearchItem(**kwargs)
+
+
+def _search_item_from_proto(msg: store_pb2.SearchItem) -> SearchItem:
+    return SearchItem(
+        namespace=tuple(msg.namespace),
+        key=msg.key,
+        value=orjson.loads(msg.value_json),
+        created_at=datetime.fromisoformat(msg.created_at),
+        updated_at=datetime.fromisoformat(msg.updated_at),
+        score=msg.score if msg.HasField("score") else None,
+    )
+
+
 def _format_dt(dt: datetime) -> str:
     return dt.isoformat()
 
@@ -200,6 +392,48 @@ async def vectors_for_put_op(
     ]
 
 
+async def query_embedding_for_search_op(
+    op: SearchOp,
+    index_config: IndexConfig,
+    embeddings: Embeddings,
+) -> store_pb2.VectorSearch | None:
+    """Embed a SearchOp's natural-language query for semantic search.
+
+    Returns None when the op has no query (a plain filter/pagination search).
+    Distance params are read from the index config and sent alongside the
+    embedding so the Go store stays stateless.
+    """
+    if not op.query:
+        return None
+
+    vectors = await embeddings.aembed_documents([op.query])
+    if not vectors:
+        return None
+
+    cfg = cast("dict[str, Any]", index_config)
+    distance_type = cfg.get("distance_type", "cosine")
+    vectors_per_doc = cfg.get("__estimated_num_vectors", 1)
+    vector_type = cfg.get("ann_index_config", {}).get("vector_type", "vector")
+
+    if distance_type not in _DISTANCE_TYPE_BY_NAME:
+        raise ValueError(
+            f"gRPC store semantic search does not support distance_type={distance_type!r} "
+            "(only 'cosine', 'l2', 'inner_product')"
+        )
+    if vector_type not in _VECTOR_TYPE_BY_NAME:
+        raise NotImplementedError(
+            f"gRPC store semantic search does not support vector_type={vector_type!r} "
+            "(only 'vector' and 'halfvec')"
+        )
+
+    return store_pb2.VectorSearch(
+        query_embedding=vectors[0],
+        distance_type=_DISTANCE_TYPE_BY_NAME[distance_type],
+        vectors_per_doc=vectors_per_doc,
+        vector_type=_VECTOR_TYPE_BY_NAME[vector_type],
+    )
+
+
 def normalize_index_config(
     index: IndexConfig | None,
 ) -> tuple[Embeddings | None, IndexConfig | None]: