memmachine-common 0.3.7__tar.gz → 0.3.9__tar.gz

{memmachine_common-0.3.7 → memmachine_common-0.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memmachine-common
-Version: 0.3.7
+Version: 0.3.9
 Summary: MemMachine Common - Shared API models for MemMachine client and server
 Author-email: MemMachine <noreply@memmachine.ai>
 License-Expression: Apache-2.0
@@ -15,6 +15,38 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
+Description-Content-Type: text/markdown
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: regex>=2023.0.0
 Requires-Dist: typing-extensions>=4.0.0
+
+# MemMachine Common
+
+Shared Python models and API types for MemMachine packages.
+
+## Installation
+
+```bash
+pip install memmachine-common
+```
+
+## What this package provides
+
+`memmachine-common` contains the shared Pydantic models and type definitions used by MemMachine Python packages.
+
+Typical users do not need to install it directly unless they are building against MemMachine package internals. It is primarily consumed by:
+- `memmachine-client`
+- `memmachine-server`
+
+## Development
+
+For local development inside the MemMachine monorepo:
+
+```bash
+pip install -e packages/common
+```
+
+## Source
+
+- Repository: <https://github.com/MemMachine/MemMachine>
+- Issues: <https://github.com/MemMachine/MemMachine/issues>

memmachine_common-0.3.9/README.md

@@ -0,0 +1,30 @@
+# MemMachine Common
+
+Shared Python models and API types for MemMachine packages.
+
+## Installation
+
+```bash
+pip install memmachine-common
+```
+
+## What this package provides
+
+`memmachine-common` contains the shared Pydantic models and type definitions used by MemMachine Python packages.
+
+Typical users do not need to install it directly unless they are building against MemMachine package internals. It is primarily consumed by:
+- `memmachine-client`
+- `memmachine-server`
+
+## Development
+
+For local development inside the MemMachine monorepo:
+
+```bash
+pip install -e packages/common
+```
+
+## Source
+
+- Repository: <https://github.com/MemMachine/MemMachine>
+- Issues: <https://github.com/MemMachine/MemMachine/issues>

{memmachine_common-0.3.7 → memmachine_common-0.3.9}/pyproject.toml

@@ -15,6 +15,7 @@ authors = [
   {name="MemMachine", email="noreply@memmachine.ai"},
 ]
 description = "MemMachine Common - Shared API models for MemMachine client and server"
+readme = "README.md"
 keywords = ["memmachine", "common", "api", "models"]
 classifiers = [
     "Programming Language :: Python :: 3",

{memmachine_common-0.3.7 → memmachine_common-0.3.9}/src/memmachine_common/api/config_spec.py

@@ -3,9 +3,10 @@
 from enum import Enum
 from typing import Annotated, Any, Literal
 
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, field_validator
 
 from memmachine_common.api.doc import SpecDoc
+from memmachine_common.api.spec import validate_properties_schema_types
 
 
 class ResourceStatus(str, Enum):
@@ -61,6 +62,16 @@ class ResourcesStatus(BaseModel):
 class LongTermMemoryConfigResponse(BaseModel):
     """Response model for long-term memory configuration."""
 
+    backend: Annotated[
+        Literal["declarative", "event"] | None,
+        Field(
+            default=None,
+            description=(
+                "Long-term memory backend. None means the writer predates the "
+                "discriminator and is treated as 'declarative'."
+            ),
+        ),
+    ]
     embedder: Annotated[
         str | None,
         Field(default=None, description=SpecDoc.LTM_CONFIG_EMBEDDER),
@@ -69,15 +80,52 @@ class LongTermMemoryConfigResponse(BaseModel):
         str | None,
         Field(default=None, description=SpecDoc.LTM_CONFIG_RERANKER),
     ]
+    # Declarative-backend only.
     vector_graph_store: Annotated[
         str | None,
         Field(default=None, description=SpecDoc.LTM_CONFIG_VECTOR_GRAPH_STORE),
     ]
+    # Event-backend only.
+    vector_store: Annotated[
+        str | None,
+        Field(
+            default=None,
+            description="VectorStore resource id (event backend only)",
+        ),
+    ]
+    segment_store: Annotated[
+        str | None,
+        Field(
+            default=None,
+            description=(
+                "SQL engine resource id backing the segment store (event backend only)"
+            ),
+        ),
+    ]
+    properties_schema: Annotated[
+        dict[str, str] | None,
+        Field(
+            default=None,
+            description=(
+                "User-defined filterable properties (event backend only). Maps "
+                'name to type ("bool", "int", "float", "str", "datetime").'
+            ),
+        ),
+    ]
     enabled: Annotated[
         bool,
         Field(default=True, description=SpecDoc.LTM_CONFIG_ENABLED),
     ]
 
+    @field_validator("properties_schema")
+    @classmethod
+    def _validate_properties_schema_types(
+        cls, value: dict[str, str] | None
+    ) -> dict[str, str] | None:
+        if value is None:
+            return value
+        return validate_properties_schema_types(value)
+
 
 class ShortTermMemoryConfigResponse(BaseModel):
     """Response model for short-term memory configuration."""
@@ -368,6 +416,16 @@ class AddLanguageModelSpec(BaseModel):
 class UpdateLongTermMemorySpec(BaseModel):
     """Partial update for long-term memory configuration."""
 
+    backend: Annotated[
+        Literal["declarative", "event"] | None,
+        Field(
+            default=None,
+            description=(
+                "Long-term memory backend. Omit/null to keep the existing "
+                "backend; set 'declarative' or 'event' to switch."
+            ),
+        ),
+    ]
     embedder: Annotated[
         str | None,
         Field(default=None, description=SpecDoc.LTM_EMBEDDER),
@@ -376,10 +434,44 @@ class UpdateLongTermMemorySpec(BaseModel):
         str | None,
         Field(default=None, description=SpecDoc.LTM_RERANKER),
     ]
+    # Declarative-backend only.
     vector_graph_store: Annotated[
         str | None,
         Field(default=None, description=SpecDoc.LTM_VECTOR_GRAPH_STORE),
     ]
+    # Event-backend only.
+    vector_store: Annotated[
+        str | None,
+        Field(
+            default=None,
+            description="VectorStore resource id (event backend only)",
+        ),
+    ]
+    segment_store: Annotated[
+        str | None,
+        Field(
+            default=None,
+            description=(
+                "SQL engine resource id backing the segment store (event backend only)"
+            ),
+        ),
+    ]
+    properties_schema: Annotated[
+        dict[str, str] | None,
+        Field(
+            default=None,
+            description="User-defined filterable properties (event backend only)",
+        ),
+    ]
+
+    @field_validator("properties_schema")
+    @classmethod
+    def _validate_properties_schema_types(
+        cls, value: dict[str, str] | None
+    ) -> dict[str, str] | None:
+        if value is None:
+            return value
+        return validate_properties_schema_types(value)
 
 
 class UpdateShortTermMemorySpec(BaseModel):

{memmachine_common-0.3.7 → memmachine_common-0.3.9}/src/memmachine_common/api/doc.py

@@ -729,7 +729,10 @@ class RouterDoc:
     System returns the top K relevant memories matching the natural language query.
     The result is sorted by timestamp to help with context.
 
-    The filter field allows for filtering based on metadata key-value pairs.
+    The filter field accepts the structured filter expression language.
+    User-defined metadata keys must be referenced with the `m.` or `metadata.` prefix
+    (for example, `m.source = "chat_v3"`). Unknown or unsupported fields are rejected
+    instead of being ignored.
     The set_metadata field scopes semantic memories to matching semantic sets.
     The types field allows specifying which memory types to include in the search.
     """
@@ -740,7 +743,10 @@ class RouterDoc:
     System returns a paginated list of memories stored in the project.
     The page_size and page_num fields control pagination.
 
-    The filter field allows for filtering based on metadata key-value pairs.
+    The filter field accepts the structured filter expression language.
+    User-defined metadata keys must be referenced with the `m.` or `metadata.` prefix
+    (for example, `m.source = "chat_v3"`). Unknown or unsupported fields are rejected
+    instead of being ignored.
     The set_metadata field scopes semantic memories to matching semantic sets.
     The type field allows specifying which memory type to list.
     """

{memmachine_common-0.3.7 → memmachine_common-0.3.9}/src/memmachine_common/api/spec.py

@@ -3,7 +3,7 @@
 import logging
 from datetime import datetime, timezone
 from enum import Enum
-from typing import Annotated, Any
+from typing import Annotated, Any, Literal
 
 import regex
 from pydantic import (
@@ -26,6 +26,35 @@ UTC = timezone.utc
 PropertyValue = bool | int | float | str | datetime
 """Type for stored property values (duplicated here to avoid server dependency)."""
 
+# Canonical type-name set accepted in `properties_schema`. Mirrors
+# `memmachine_server.common.data_types.PROPERTY_TYPE_NAME_TO_PROPERTY_TYPE` but
+# lives here so the API contract validates types at request time rather than
+# deferring failures to service-locator wire-up.
+VALID_PROPERTY_TYPE_NAMES: frozenset[str] = frozenset(
+    {"bool", "int", "float", "str", "datetime"}
+)
+
+
+def validate_properties_schema_types(value: dict[str, str]) -> dict[str, str]:
+    """Reject unknown type names in `properties_schema`.
+
+    Without this check, an unknown type name like `"date"` or `"integer"` is
+    only caught later when service-locator builds the VectorStore collection
+    schema — surfacing as a 500 instead of a 400 at API time.
+    """
+    bad = sorted(
+        f"{name}={type_name!r}"
+        for name, type_name in value.items()
+        if type_name not in VALID_PROPERTY_TYPE_NAMES
+    )
+    if bad:
+        raise ValueError(
+            "properties_schema contains unknown type names "
+            f"(allowed: {sorted(VALID_PROPERTY_TYPE_NAMES)}): {bad}"
+        )
+    return value
+
+
 DEFAULT_ORG_AND_PROJECT_ID = "universal"
 
 logger = logging.getLogger(__name__)
@@ -182,11 +211,27 @@ class ProjectConfig(BaseModel):
     """
     Project configuration model.
 
-    This section defines which reranker and embedder models should be used for
-    the project.  If any field is left empty (""), the system automatically falls
-    back to the globally configured defaults in the server configuration file.
+    Identifies the long-term-memory backend and the resource ids it should
+    bind to. If any string field is left empty (""), the server falls back to
+    its globally-configured defaults.
+
+    Backend selection:
+    - `backend="event"` (default for new projects): uses VectorStore +
+      SegmentStore. Requires `vector_store` and `segment_store`.
+    - `backend="declarative"`: uses VectorGraphStore. Requires
+      `vector_graph_store`.
+    - Empty/null `backend`: server falls back to its parse-time default
+      (declarative, for backwards compatibility with pre-discriminator clients).
     """
 
+    backend: Annotated[
+        Literal["declarative", "event"] | None,
+        Field(
+            default=None,
+            description=("Long-term memory backend. New projects should set 'event'."),
+        ),
+    ]
+
     reranker: Annotated[
         str,
         Field(
@@ -205,6 +250,48 @@ class ProjectConfig(BaseModel):
         ),
     ]
 
+    # Declarative-backend resource id.
+    vector_graph_store: Annotated[
+        str,
+        Field(
+            default="",
+            description="VectorGraphStore resource id (declarative backend only)",
+        ),
+    ]
+
+    # Event-backend resource ids.
+    vector_store: Annotated[
+        str,
+        Field(
+            default="",
+            description="VectorStore resource id (event backend only)",
+        ),
+    ]
+    segment_store: Annotated[
+        str,
+        Field(
+            default="",
+            description=(
+                "SQL engine resource id backing the segment store (event backend only)"
+            ),
+        ),
+    ]
+    properties_schema: Annotated[
+        dict[str, str],
+        Field(
+            default_factory=dict,
+            description=(
+                "User-defined filterable properties (event backend only). Maps "
+                'name to type ("bool", "int", "float", "str", "datetime").'
+            ),
+        ),
+    ]
+
+    @field_validator("properties_schema")
+    @classmethod
+    def _validate_properties_schema_types(cls, value: dict[str, str]) -> dict[str, str]:
+        return validate_properties_schema_types(value)
+
 
 class CreateProjectSpec(BaseModel):
     """

{memmachine_common-0.3.7 → memmachine_common-0.3.9}/src/memmachine_common.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memmachine-common
-Version: 0.3.7
+Version: 0.3.9
 Summary: MemMachine Common - Shared API models for MemMachine client and server
 Author-email: MemMachine <noreply@memmachine.ai>
 License-Expression: Apache-2.0
@@ -15,6 +15,38 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
+Description-Content-Type: text/markdown
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: regex>=2023.0.0
 Requires-Dist: typing-extensions>=4.0.0
+
+# MemMachine Common
+
+Shared Python models and API types for MemMachine packages.
+
+## Installation
+
+```bash
+pip install memmachine-common
+```
+
+## What this package provides
+
+`memmachine-common` contains the shared Pydantic models and type definitions used by MemMachine Python packages.
+
+Typical users do not need to install it directly unless they are building against MemMachine package internals. It is primarily consumed by:
+- `memmachine-client`
+- `memmachine-server`
+
+## Development
+
+For local development inside the MemMachine monorepo:
+
+```bash
+pip install -e packages/common
+```
+
+## Source
+
+- Repository: <https://github.com/MemMachine/MemMachine>
+- Issues: <https://github.com/MemMachine/MemMachine/issues>

{memmachine_common-0.3.7 → memmachine_common-0.3.9}/src/memmachine_common.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+README.md
 pyproject.toml
 src/memmachine_common/__init__.py
 src/memmachine_common.egg-info/PKG-INFO