From a47707b384289eb7eec9ab72f6251b332a70a426 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 6 Apr 2026 13:35:21 +0200
Subject: [PATCH 01/16] Refactor memory tools to use names instead of IDs

---
 ...-ffd5e65054bc_add_workspace_description.py |  5 +-
 ...20_0001-a1b2c3d4e5f6_add_revoked_tokens.py |  1 +
 ...04_06_1245-f8c1fc9be252_add_memory_name.py | 70 +++++++++++++++++++
 src/memlord/dao/memory.py                     | 42 ++++++++---
 src/memlord/models/memory.py                  |  3 +
 src/memlord/schemas/__init__.py               |  2 +-
 src/memlord/schemas/delete.py                 |  2 +-
 src/memlord/schemas/list_memories.py          | 40 ++++++++++-
 src/memlord/schemas/recall.py                 |  5 +-
 src/memlord/schemas/search.py                 |  8 +--
 src/memlord/schemas/store.py                  |  2 +-
 src/memlord/schemas/update.py                 |  1 +
 src/memlord/search.py                         | 27 ++++---
 src/memlord/templates/_memory_content.html    | 23 ++++--
 src/memlord/templates/index.html              |  1 +
 src/memlord/templates/memory.html             |  2 +-
 src/memlord/tools/delete.py                   | 11 +--
 src/memlord/tools/get_memory.py               | 31 +++++---
 src/memlord/tools/list_memories.py            | 16 +++--
 src/memlord/tools/move.py                     | 13 ++--
 src/memlord/tools/recall.py                   | 17 ++---
 src/memlord/tools/retrieve.py                 | 36 ++++------
 src/memlord/tools/search_by_tag.py            | 12 ++--
 src/memlord/tools/store.py                    |  7 +-
 src/memlord/tools/update.py                   | 20 ++++--
 src/memlord/ui/base.py                        | 18 ++---
 tests/test_created_at_tz.py                   |  6 +-
 tests/test_pipeline.py                        | 22 +++---
 28 files changed, 315 insertions(+), 128 deletions(-)
 create mode 100644 migrations/versions/2026_04_06_1245-f8c1fc9be252_add_memory_name.py

diff --git a/migrations/versions/2026_03_19_1754-ffd5e65054bc_add_workspace_description.py b/migrations/versions/2026_03_19_1754-ffd5e65054bc_add_workspace_description.py
index a534df3..1637b83 100644
--- a/migrations/versions/2026_03_19_1754-ffd5e65054bc_add_workspace_description.py
+++ b/migrations/versions/2026_03_19_1754-ffd5e65054bc_add_workspace_description.py
@@ -5,6 +5,7 @@
 Create Date: 2026-03-19 17:54:13.555231
 
 """
+
 from typing import Sequence, Union
 
 from alembic import op
@@ -12,8 +13,8 @@
 
 
 # revision identifiers, used by Alembic.
-revision: str = 'ffd5e65054bc'
-down_revision: Union[str, Sequence[str], None] = '8f44baaf5579'
+revision: str = "ffd5e65054bc"
+down_revision: Union[str, Sequence[str], None] = "8f44baaf5579"
 branch_labels: Union[str, Sequence[str], None] = None
 depends_on: Union[str, Sequence[str], None] = None
 
diff --git a/migrations/versions/2026_03_20_0001-a1b2c3d4e5f6_add_revoked_tokens.py b/migrations/versions/2026_03_20_0001-a1b2c3d4e5f6_add_revoked_tokens.py
index 646f7a3..c9752ef 100644
--- a/migrations/versions/2026_03_20_0001-a1b2c3d4e5f6_add_revoked_tokens.py
+++ b/migrations/versions/2026_03_20_0001-a1b2c3d4e5f6_add_revoked_tokens.py
@@ -5,6 +5,7 @@
 Create Date: 2026-03-20 00:01:00.000000
 
 """
+
 from typing import Sequence, Union
 
 from alembic import op
diff --git a/migrations/versions/2026_04_06_1245-f8c1fc9be252_add_memory_name.py b/migrations/versions/2026_04_06_1245-f8c1fc9be252_add_memory_name.py
new file mode 100644
index 0000000..e70d80f
--- /dev/null
+++ b/migrations/versions/2026_04_06_1245-f8c1fc9be252_add_memory_name.py
@@ -0,0 +1,70 @@
+"""add memory name
+
+Revision ID: f8c1fc9be252
+Revises: b942da1196f0
+Create Date: 2026-04-06 12:45:26.136961
+
+"""
+
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = "f8c1fc9be252"
+down_revision: Union[str, Sequence[str], None] = "b942da1196f0"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column("memories", sa.Column("name", sa.Text(), nullable=True))
+    op.create_index(op.f("ix_memories_name"), "memories", ["name"], unique=False)
+    op.create_unique_constraint(
+        "uq_memories_name_workspace", "memories", ["name", "workspace_id"]
+    )
+    # ### end Alembic commands ###
+
+    # Back-fill name from content: if content starts with a short phrase followed
+    # by ":", use that phrase as the name.  Skip if the candidate name would
+    # collide with another memory in the same workspace.
+    op.execute(sa.text("""
+        UPDATE memories
+        SET
+            name    = TRIM(SPLIT_PART(content, ':', 1)),
+            content = TRIM(SUBSTRING(content FROM POSITION(':' IN content) + 1))
+        WHERE
+            POSITION(':' IN content) > 0
+            AND CHAR_LENGTH(TRIM(SPLIT_PART(content, ':', 1))) BETWEEN 3 AND 60
+            AND name IS NULL
+            AND NOT EXISTS (
+                SELECT 1 FROM memories m2
+                WHERE m2.workspace_id = memories.workspace_id
+                  AND m2.id != memories.id
+                  AND POSITION(':' IN m2.content) > 0
+                  AND CHAR_LENGTH(TRIM(SPLIT_PART(m2.content, ':', 1))) BETWEEN 3 AND 60
+                  AND TRIM(SPLIT_PART(m2.content, ':', 1)) = TRIM(SPLIT_PART(memories.content, ':', 1))
+            )
+    """))
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # Restore content: prepend name back if name was set by the back-fill.
+    # We can't know which rows were touched, so we restore all rows that have
+    # a name — concatenating "name: content".
+    op.execute(sa.text("""
+        UPDATE memories
+        SET content = name || ': ' || content
+        WHERE name IS NOT NULL
+    """))
+
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_constraint("uq_memories_name_workspace", "memories", type_="unique")
+    op.drop_index(op.f("ix_memories_name"), table_name="memories")
+    op.drop_column("memories", "name")
+    # ### end Alembic commands ###
diff --git a/src/memlord/dao/memory.py b/src/memlord/dao/memory.py
index afdce76..a935839 100644
--- a/src/memlord/dao/memory.py
+++ b/src/memlord/dao/memory.py
@@ -85,6 +85,15 @@ async def _check_near_duplicate(
                 f"Review with get_memory({dup_row['id']}). Pass force=True to store anyway."
             )
 
+    async def get_id_by_name(self, name: str) -> int | None:
+        workspace_ids = await self._accessible_workspace_ids()
+        return await self._s.scalar(
+            select(Memory.id).where(
+                Memory.name == name,
+                Memory.workspace_id.in_(workspace_ids),
+            )
+        )
+
     async def _personal_workspace_id(self) -> int:
         ws = await WorkspaceDao(self._s).get_personal(self._uid)
         return ws.id
@@ -100,6 +109,7 @@ async def create(
         tags: set[str],
         workspace_id: int | None = None,
         force: bool = False,
+        name: str | None = None,
     ) -> tuple[int, bool]:
         if workspace_id is None:
             workspace_id = await self._personal_workspace_id()
@@ -127,6 +137,7 @@ async def create(
                 embedding=vector,
                 created_by=self._uid,
                 workspace_id=workspace_id,
+                name=name,
             )
             .returning(Memory.id)
         )
@@ -143,7 +154,8 @@ async def update(
         memory_type: MemoryType = _UNSET,  # type: ignore[assignment]
         metadata: dict = _UNSET,  # type: ignore[assignment]
         tags: set[str] = _UNSET,  # type: ignore[assignment]
-    ) -> int:
+        name: str | None = _UNSET,  # type: ignore[assignment]
+    ) -> tuple[int, str | None]:
         """Update memory fields. Pass _UNSET to leave a field unchanged; None sets it to NULL."""
         if workspace_ids is None:
             workspace_ids = await self._accessible_workspace_ids()
@@ -160,6 +172,8 @@ async def update(
             values["memory_type"] = MemoryType(memory_type)
         if metadata is not _UNSET:
             values["extra_data"] = metadata or {}
+        if name is not _UNSET:
+            values["name"] = name
 
         if content is not _UNSET or tags is not _UNSET:
             new_content = (
@@ -189,7 +203,12 @@ async def update(
         if tags is not _UNSET:
             await self._replace_tags(memory_id, tags)  # type: ignore[arg-type]
 
-        return memory_id
+        final_name: str | None = (
+            values["name"]
+            if "name" in values
+            else await self._s.scalar(select(Memory.name).where(Memory.id == memory_id))
+        )
+        return memory_id, final_name
 
     async def delete(self, id: int, workspace_ids: list[int] | None = None) -> None:
         if workspace_ids is None:
@@ -204,23 +223,30 @@ async def delete(self, id: int, workspace_ids: list[int] | None = None) -> None:
         await self._cleanup_orphan_tags()
 
     async def get(
-        self, id: int, workspace_ids: list[int] | None = None
+        self,
+        id: int | None = None,
+        name: str | None = None,
+        workspace_ids: list[int] | None = None,
     ) -> MemoryListItem | None:
+        if id is None and name is None:
+            raise ValueError("Either id or name must be provided")
         if workspace_ids is None:
             workspace_ids = await self._accessible_workspace_ids()
         access_check = Memory.workspace_id.in_(workspace_ids)
 
+        id_filter = Memory.id == id if id is not None else Memory.name == name
         row = (
             (
                 await self._s.execute(
                     select(
                         Memory.id,
+                        Memory.name,
                         Memory.content,
                         Memory.memory_type,
                         Memory.extra_data.label("metadata"),
                         Memory.created_at,
                         Memory.workspace_id,
-                    ).where(Memory.id == id, access_check)
+                    ).where(id_filter, access_check)
                 )
             )
             .mappings()
@@ -228,11 +254,9 @@ async def get(
         )
         if row is None:
             return None
-        tags = (await self.fetch_tags([id])).get(id, [])
-        return MemoryListItem(
-            **row,
-            tags=tags,
-        )
+        memory_id: int = row["id"]
+        tags = (await self.fetch_tags([memory_id])).get(memory_id, [])
+        return MemoryListItem(**row, tags=tags)  # extra "id" silently ignored
 
     async def move(self, id: int, target_workspace_id: int) -> None:
         """Move memory to a different workspace. Raises ValueError if not found or duplicate."""
diff --git a/src/memlord/models/memory.py b/src/memlord/models/memory.py
index 3bb1c1f..67e3796 100644
--- a/src/memlord/models/memory.py
+++ b/src/memlord/models/memory.py
@@ -28,10 +28,13 @@ class Memory(Base):
         nullable=False,
     )
 
+    name = sa.Column(sa.Text, nullable=True, index=True)
+
     __table_args__ = (
         sa.UniqueConstraint(
             "content", "workspace_id", name="uq_memories_content_workspace"
         ),
+        sa.UniqueConstraint("name", "workspace_id", name="uq_memories_name_workspace"),
         sa.Index("ix_memories_search_vector", "search_vector", postgresql_using="gin"),
         sa.Index(
             "ix_memories_embedding",
diff --git a/src/memlord/schemas/__init__.py b/src/memlord/schemas/__init__.py
index 66fffa4..a5d5ca6 100644
--- a/src/memlord/schemas/__init__.py
+++ b/src/memlord/schemas/__init__.py
@@ -1,5 +1,5 @@
 from .delete import DeleteResult
-from .list_memories import MemoryListItem, MemoryPage
+from .list_memories import MemoryDetail, MemoryItem, MemoryListItem, MemoryPage
 from .memory_type import MemoryType
 from .recall import RecallPage, RecallResult
 from .search import MemoryResult, SearchResult
diff --git a/src/memlord/schemas/delete.py b/src/memlord/schemas/delete.py
index 300948c..933f093 100644
--- a/src/memlord/schemas/delete.py
+++ b/src/memlord/schemas/delete.py
@@ -3,4 +3,4 @@
 
 class DeleteResult(BaseModel):
     success: bool
-    id: int
+    name: str | None
diff --git a/src/memlord/schemas/list_memories.py b/src/memlord/schemas/list_memories.py
index c82b655..ba57a22 100644
--- a/src/memlord/schemas/list_memories.py
+++ b/src/memlord/schemas/list_memories.py
@@ -1,12 +1,15 @@
 from datetime import datetime, UTC
 
-from pydantic import BaseModel, Field, field_serializer, NaiveDatetime
+from pydantic import BaseModel, ConfigDict, Field, field_serializer, NaiveDatetime
 
 from .memory_type import MemoryType
 
 
 class MemoryListItem(BaseModel):
+    """Full memory record — used by UI and DAO."""
+
     id: int
+    name: str | None = None
     content: str
     memory_type: MemoryType
     metadata: dict = Field(default_factory=dict)
@@ -19,8 +22,41 @@ def serialize_created_at(self, v: datetime) -> str:
         return v.replace(tzinfo=UTC).isoformat()
 
 
+class MemoryItem(BaseModel):
+    """Slim memory record returned by MCP list/search tools (no id, no content)."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    name: str | None = None
+    memory_type: MemoryType
+    metadata: dict = Field(default_factory=dict)
+    tags: set[str]
+    created_at: NaiveDatetime
+    workspace: str | None = None
+
+    @field_serializer("created_at")
+    def serialize_created_at(self, v: datetime) -> str:
+        return v.replace(tzinfo=UTC).isoformat()
+
+
+class MemoryDetail(BaseModel):
+    """Full memory record returned by get_memory MCP tool."""
+
+    name: str | None = None
+    content: str
+    memory_type: MemoryType
+    metadata: dict = Field(default_factory=dict)
+    tags: set[str]
+    created_at: NaiveDatetime
+    workspace: str | None = None
+
+    @field_serializer("created_at")
+    def serialize_created_at(self, v: datetime) -> str:
+        return v.replace(tzinfo=UTC).isoformat()
+
+
 class MemoryPage(BaseModel):
-    items: list[MemoryListItem] = Field(default_factory=list)
+    items: list[MemoryItem] = Field(default_factory=list)
     total: int = 0
     page: int = 1
     page_size: int = 0
diff --git a/src/memlord/schemas/recall.py b/src/memlord/schemas/recall.py
index e768475..2d5cdb4 100644
--- a/src/memlord/schemas/recall.py
+++ b/src/memlord/schemas/recall.py
@@ -6,12 +6,11 @@
 
 
 class RecallResult(BaseModel):
-    id: int
-    content: str
+    name: str | None
     memory_type: MemoryType | None
     tags: set[str]
     created_at: NaiveDatetime
-    workspace_id: int | None = None
+    workspace: str | None = None
 
     @field_serializer("created_at")
     def serialize_created_at(self, v: datetime) -> str:
diff --git a/src/memlord/schemas/search.py b/src/memlord/schemas/search.py
index a5ef97a..b1ebc15 100644
--- a/src/memlord/schemas/search.py
+++ b/src/memlord/schemas/search.py
@@ -7,22 +7,22 @@
 
 class SearchResult(BaseModel):
     id: int
+    name: str | None
     content: str
     memory_type: MemoryType
     rrf_score: float
     vec_similarity: float | None
-    workspace_id: int | None = None
+    workspace: str | None = None
 
 
 class MemoryResult(BaseModel):
-    id: int
-    content: str
+    name: str | None
     memory_type: MemoryType
     tags: set[str]
     metadata: dict
     created_at: NaiveDatetime
     rrf_score: float
-    workspace_id: int | None = None
+    workspace: str | None = None
 
     @field_serializer("created_at")
     def serialize_created_at(self, v: datetime) -> str:
diff --git a/src/memlord/schemas/store.py b/src/memlord/schemas/store.py
index 06ba4f8..86c3f45 100644
--- a/src/memlord/schemas/store.py
+++ b/src/memlord/schemas/store.py
@@ -15,5 +15,5 @@ class ImportItem(BaseModel):
 
 
 class StoreResult(BaseModel):
-    id: int
+    name: str | None
     created: bool
diff --git a/src/memlord/schemas/update.py b/src/memlord/schemas/update.py
index 40f20fc..84ca713 100644
--- a/src/memlord/schemas/update.py
+++ b/src/memlord/schemas/update.py
@@ -5,6 +5,7 @@
 
 class UpdateMemoryRequest(BaseModel):
     content: str | None = None
+    name: str | None = None
     memory_type: MemoryType | None = None
     tags: set[str] | None = None
     metadata: dict | None = None
diff --git a/src/memlord/search.py b/src/memlord/search.py
index 33151f2..0c7bdf9 100644
--- a/src/memlord/search.py
+++ b/src/memlord/search.py
@@ -7,7 +7,8 @@
 from memlord.config import settings
 from memlord.embeddings import embed
 from memlord.models import Memory, MemoryTag, Tag
-from memlord.schemas import SearchResult
+from memlord.models.workspace import Workspace
+from memlord.schemas import MemoryType, SearchResult
 
 
 async def hybrid_search(
@@ -57,11 +58,13 @@ async def hybrid_search(
     bm25_q = (
         select(
             Memory.id,
+            Memory.name,
             Memory.content,
             Memory.memory_type,
-            Memory.workspace_id,
+            Workspace.name.label("workspace"),
             bm25_rank,
         )
+        .join(Workspace, Memory.workspace_id == Workspace.id)
         .where(
             (Memory.search_vector.op("@@")(tsquery)) | tag_match,
             *conditions,
@@ -82,12 +85,14 @@ async def hybrid_search(
     vec_q = (
         select(
             Memory.id,
+            Memory.name,
             Memory.content,
             Memory.memory_type,
-            Memory.workspace_id,
+            Workspace.name.label("workspace"),
             distance,
             vec_rank,
         )
+        .join(Workspace, Memory.workspace_id == Workspace.id)
         .where(Memory.embedding.isnot(None), *conditions)
         .order_by(distance)
         .limit(n)
@@ -98,12 +103,13 @@ async def hybrid_search(
     bm25_ranks: dict[int, int] = {row.id: row.bm25_rank for row in bm25_rows}
     vec_ranks: dict[int, int] = {row.id: row.vec_rank for row in vec_rows}
     vec_distances: dict[int, float] = {row.id: row.distance for row in vec_rows}
-    contents: dict[int, tuple] = {
-        row.id: (row.content, row.memory_type, row.workspace_id) for row in bm25_rows
+    contents: dict[int, tuple[str, str, MemoryType, str]] = {
+        row.id: (row.name, row.content, row.memory_type, row.workspace)
+        for row in bm25_rows
+    } | {
+        row.id: (row.name, row.content, row.memory_type, row.workspace)
+        for row in vec_rows
     }
-    contents.update(
-        {row.id: (row.content, row.memory_type, row.workspace_id) for row in vec_rows}
-    )
 
     # RRF fusion
     all_ids = set(bm25_ranks) | set(vec_ranks)
@@ -128,13 +134,14 @@ async def hybrid_search(
         ):
             continue
 
-        content, memory_type, workspace_id = contents[doc_id]
+        name, content, memory_type, workspace = contents[doc_id]
         scored.append(
             SearchResult(
                 id=doc_id,
+                name=name,
                 content=content,
                 memory_type=memory_type,  # type: ignore[arg-type]
-                workspace_id=workspace_id,
+                workspace=workspace,
                 rrf_score=rrf,
                 vec_similarity=similarity,
             )
diff --git a/src/memlord/templates/_memory_content.html b/src/memlord/templates/_memory_content.html
index 40b8281..8ac8b20 100644
--- a/src/memlord/templates/_memory_content.html
+++ b/src/memlord/templates/_memory_content.html
@@ -31,7 +31,7 @@
 {% if writable_workspaces %}
 <div class="detail-card">
     <div class="section-title">Move to workspace</div>
-    <form hx-post="/memory/{{ memory.id }}/move"
+    <form hx-post="/memory/{{ memory_id }}/move"
           hx-target="#page-content"
           hx-swap="innerHTML"
           style="display:flex;gap:.5rem;align-items:center">
@@ -47,7 +47,14 @@
 
 <div class="detail-card">
     <div class="section-title">Edit memory</div>
-    <form id="edit-form-{{ memory.id }}">
+    <form id="edit-form-{{ memory_id }}">
+        <div class="form-group">
+            <label class="form-label" for="name">
+                Name <span class="form-hint">— optional, unique within workspace</span>
+            </label>
+            <input class="form-input" id="name"
+                   value="{{ memory.name or '' }}" placeholder="e.g. my-note">
+        </div>
         <div class="form-group">
             <label class="form-label" for="content">Content</label>
             <textarea class="form-textarea" id="content" rows="6">{{ memory.content }}</textarea>
@@ -77,13 +84,13 @@
         </div>
         <div class="form-actions">
             <button type="submit" class="btn-primary-sm">Save changes</button>
-            <button type="button" class="btn-danger-sm" id="delete-btn-{{ memory.id }}">
+            <button type="button" class="btn-danger-sm" id="delete-btn-{{ memory_id }}">
                 Delete memory
             </button>
         </div>
     </form>
     <script>
-        document.getElementById('edit-form-{{ memory.id }}').addEventListener('submit', async function (e) {
+        document.getElementById('edit-form-{{ memory_id }}').addEventListener('submit', async function (e) {
             e.preventDefault();
             const metaRaw = document.getElementById('metadata_str').value.trim();
             let metadata = null;
@@ -96,13 +103,15 @@
                 }
             }
             const tagsRaw = document.getElementById('tags_str').value;
+            const nameVal = document.getElementById('name').value.trim();
             const body = {
+                name: nameVal || null,
                 content: document.getElementById('content').value,
                 memory_type: document.getElementById('memory_type').value,
                 tags: tagsRaw ? tagsRaw.split(',').map(t => t.trim()).filter(Boolean) : [],
                 metadata: metadata,
             };
-            const resp = await fetch('/memory/{{ memory.id }}', {
+            const resp = await fetch('/memory/{{ memory_id }}', {
                 method: 'PUT',
                 headers: {'Content-Type': 'application/json'},
                 body: JSON.stringify(body),
@@ -111,9 +120,9 @@
             htmx.process(document.getElementById('page-content'));
         });
 
-        document.getElementById('delete-btn-{{ memory.id }}').addEventListener('click', async function () {
+        document.getElementById('delete-btn-{{ memory_id }}').addEventListener('click', async function () {
             if (!confirm('Delete this memory?')) return;
-            const resp = await fetch('/memory/{{ memory.id }}', {method: 'DELETE'});
+            const resp = await fetch('/memory/{{ memory_id }}', {method: 'DELETE'});
             if (resp.ok) window.location.href = '/';
         });
     </script>
diff --git a/src/memlord/templates/index.html b/src/memlord/templates/index.html
index b9d65ac..4c7ebfc 100644
--- a/src/memlord/templates/index.html
+++ b/src/memlord/templates/index.html
@@ -218,6 +218,7 @@ <h2 style="font-size:1.0625rem;font-weight:600;letter-spacing:-.02em;margin:0;">
     {% endif %}
     <div class="card-header">
         <a href="/memory/{{ m.id }}" style="flex:1; min-width:0; color:inherit; text-decoration:none;">
+            {% if m.name %}<div style="font-size:.7rem;font-weight:600;color:var(--text-4);margin-bottom:.2rem;font-family:monospace">{{ m.name }}</div>{% endif %}
             <div class="card-content">{{ m.content | truncate(280) }}</div>
         </a>
         <div class="card-actions">
diff --git a/src/memlord/templates/memory.html b/src/memlord/templates/memory.html
index d412681..51aa010 100644
--- a/src/memlord/templates/memory.html
+++ b/src/memlord/templates/memory.html
@@ -1,5 +1,5 @@
 {% extends "base.html" %}
-{% block title %}Memlord — Memory #{{ memory.id }}{% endblock %}
+{% block title %}Memlord — Memory #{{ memory_id }}{% endblock %}
 {% block content %}
 
 <div class="breadcrumb">
diff --git a/src/memlord/tools/delete.py b/src/memlord/tools/delete.py
index 86319ce..9535b65 100644
--- a/src/memlord/tools/delete.py
+++ b/src/memlord/tools/delete.py
@@ -15,11 +15,14 @@
     annotations=ToolAnnotations(destructiveHint=True, idempotentHint=False),
 )
 async def delete_memory(
-    id: int,
+    name: str,
     s: AsyncSession = MCPSessionDep,  # type: ignore[assignment]
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> DeleteResult:
-    """Delete a memory by ID. Removes from vec index and FTS (via trigger)."""
+    """Delete a memory by name."""
     dao = MemoryDao(s, uid)
-    await dao.delete(id)
-    return DeleteResult(success=True, id=id)
+    memory_id = await dao.get_id_by_name(name)
+    if memory_id is None:
+        raise ValueError(f"Memory with name={name!r} not found")
+    await dao.delete(memory_id)
+    return DeleteResult(success=True, name=name)
diff --git a/src/memlord/tools/get_memory.py b/src/memlord/tools/get_memory.py
index 4000dc6..afffa60 100644
--- a/src/memlord/tools/get_memory.py
+++ b/src/memlord/tools/get_memory.py
@@ -4,20 +4,35 @@
 
 from memlord.auth import MCPUserDep
 from memlord.dao import MemoryDao
+from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
-from memlord.schemas import MemoryListItem
+from memlord.schemas import MemoryDetail
 
 mcp = FastMCP()
 
 
 @mcp.tool(annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False))
 async def get_memory(
-    id: int,
+    name: str,
     s: AsyncSession = MCPSessionDep,  # type: ignore[assignment]
     uid: int = MCPUserDep,  # type: ignore[assignment]
-) -> MemoryListItem:
-    """Fetch a single memory by ID with full details (tags, metadata)."""
-    result = await MemoryDao(s, uid).get(id)
-    if result is None:
-        raise ValueError(f"Memory with id={id} not found")
-    return result
+) -> MemoryDetail:
+    """Fetch full content of a memory by name."""
+    item = await MemoryDao(s, uid).get(name=name)
+    if item is None:
+        raise ValueError(f"Memory with name={name!r} not found")
+
+    ws_name: str | None = None
+    if item.workspace_id is not None:
+        names = await WorkspaceDao(s).get_names_by_ids({item.workspace_id})
+        ws_name = names.get(item.workspace_id)
+
+    return MemoryDetail(
+        name=item.name,
+        content=item.content,
+        memory_type=item.memory_type,
+        metadata=item.metadata,
+        tags=item.tags,
+        created_at=item.created_at,
+        workspace=ws_name,
+    )
diff --git a/src/memlord/tools/list_memories.py b/src/memlord/tools/list_memories.py
index f031747..1775a5a 100644
--- a/src/memlord/tools/list_memories.py
+++ b/src/memlord/tools/list_memories.py
@@ -10,17 +10,19 @@
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
 from memlord.models import Memory, MemoryTag, Tag
-from memlord.schemas import MemoryListItem, MemoryPage, MemoryType
+from memlord.models.workspace import Workspace
+from memlord.schemas import MemoryItem, MemoryPage, MemoryType
 
 mcp = FastMCP()
 
 _COLS = (
     Memory.id,
+    Memory.name,
     Memory.content,
     Memory.memory_type,
     Memory.extra_data.label("metadata"),
     Memory.created_at,
-    Memory.workspace_id,
+    Workspace.name.label("workspace"),
 )
 
 
@@ -41,7 +43,11 @@ async def list_memories(
     offset = (page - 1) * page_size
 
     workspace_ids = await WorkspaceDao(s).get_accessible_workspace_ids(uid)
-    q = select(*_COLS).where(Memory.workspace_id.in_(workspace_ids))
+    q = (
+        select(*_COLS)
+        .join(Workspace, Memory.workspace_id == Workspace.id)
+        .where(Memory.workspace_id.in_(workspace_ids))
+    )
 
     if memory_type:
         q = q.where(Memory.memory_type == memory_type)
@@ -82,9 +88,9 @@ async def list_memories(
 
     return MemoryPage(
         items=[
-            MemoryListItem(
+            MemoryItem(
                 **row,
-                tags=tags_map.get(row["id"], []),
+                tags=set(tags_map.get(row["id"], [])),
             )
             for row in rows
         ],
diff --git a/src/memlord/tools/move.py b/src/memlord/tools/move.py
index 00b0d70..6643a18 100644
--- a/src/memlord/tools/move.py
+++ b/src/memlord/tools/move.py
@@ -16,16 +16,21 @@
     annotations=ToolAnnotations(idempotentHint=False, destructiveHint=False),
 )
 async def move_memory(
-    id: int,
+    name: str,
     workspace: str,
     s: AsyncSession = MCPSessionDep,  # type: ignore[assignment]
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> StoreResult:
     """Move a memory to a different workspace.
 
-    id: memory ID to move.
+    name: name of the memory to move.
     workspace: name of the target workspace (must be a member with write access).
     """
+    dao = MemoryDao(s, uid)
+    memory_id = await dao.get_id_by_name(name)
+    if memory_id is None:
+        raise ValueError(f"Memory with name={name!r} not found")
+
     ws = await WorkspaceDao(s).get_by_name(workspace, uid)
     if ws is None:
         raise ValueError(
@@ -33,5 +38,5 @@ async def move_memory(
             "Use list_workspaces() to see available workspaces."
         )
 
-    await MemoryDao(s, uid).move(id, ws.id)
-    return StoreResult(id=id, created=False)
+    await dao.move(memory_id, ws.id)
+    return StoreResult(name=name, created=False)
diff --git a/src/memlord/tools/recall.py b/src/memlord/tools/recall.py
index 3e2c808..476c0b1 100644
--- a/src/memlord/tools/recall.py
+++ b/src/memlord/tools/recall.py
@@ -25,18 +25,14 @@ async def recall_memory(
     query: str,
     n_results: int = 5,
     memory_type: MemoryType | None = None,
-    snippet_length: int = 200,
     workspace: str | None = None,
     s: AsyncSession = MCPSessionDep,  # type: ignore[assignment]
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> RecallPage:
-    """Search memories by time expression + semantics.
+    """Search memories by time expression + semantics. Returns names + metadata only.
 
     Examples: "last week", "yesterday", "about Python last month".
-
-    Returns compact snippets by default (snippet_length=200). To get the full
-    content of a specific memory, call get_memory(id).
-    Set snippet_length=None to return full content immediately.
+    Use get_memory(name=...) to fetch full content of a specific result.
     Pass workspace=<name> to search only within a specific workspace.
     """
     date_from: datetime | None = None
@@ -92,16 +88,11 @@ async def recall_memory(
     return RecallPage(
         items=[
             RecallResult(
-                id=r.id,
-                content=(
-                    r.content
-                    if len(r.content) <= snippet_length
-                    else r.content[:snippet_length] + "..."
-                ),
+                name=r.name,
                 memory_type=r.memory_type,
                 tags=tags_map.get(r.id, set()),
                 created_at=created_map[r.id],
-                workspace_id=r.workspace_id,
+                workspace=r.workspace,
             )
             for r in results
         ]
diff --git a/src/memlord/tools/retrieve.py b/src/memlord/tools/retrieve.py
index 8f7d206..68745fb 100644
--- a/src/memlord/tools/retrieve.py
+++ b/src/memlord/tools/retrieve.py
@@ -20,16 +20,13 @@ async def retrieve_memory(
     limit: int = 10,
     similarity_threshold: float = settings.sim_threshold,
     memory_type: MemoryType | None = None,
-    snippet_length: int = 200,
     workspace: str | None = None,
     s: AsyncSession = MCPSessionDep,  # type: ignore[assignment]
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> list[MemoryResult]:
-    """Hybrid semantic + full-text search over stored memories.
+    """Hybrid semantic + full-text search. Returns names + metadata only.
 
-    Returns compact snippets by default (snippet_length=200). To get the full
-    content of a specific memory, call get_memory(id).
-    Set snippet_length=None to return full content immediately.
+    Use get_memory(name=...) to fetch full content of a specific result.
     Pass workspace=<name> to search only within a specific workspace.
     """
     ws_dao = WorkspaceDao(s)
@@ -57,22 +54,15 @@ async def retrieve_memory(
     tags_map = await dao.fetch_tags(ids)
     meta_map = await dao.fetch_metadata(ids)
 
-    output = []
-    for r in results:
-        metadata, created_at = meta_map.get(r.id, ({}, utcnow()))
-        content = r.content
-        if len(content) > snippet_length:
-            content = content[:snippet_length] + "..."
-        output.append(
-            MemoryResult(
-                id=r.id,
-                content=content,
-                memory_type=r.memory_type,
-                tags=tags_map.get(r.id, []),
-                metadata=metadata,
-                created_at=created_at,
-                rrf_score=r.rrf_score,
-                workspace_id=r.workspace_id,
-            )
+    return [
+        MemoryResult(
+            name=r.name,
+            memory_type=r.memory_type,
+            tags=tags_map.get(r.id, []),
+            metadata=meta_map.get(r.id, ({}, utcnow()))[0],
+            created_at=meta_map.get(r.id, ({}, utcnow()))[1],
+            rrf_score=r.rrf_score,
+            workspace=r.workspace,
         )
-    return output
+        for r in results
+    ]
diff --git a/src/memlord/tools/search_by_tag.py b/src/memlord/tools/search_by_tag.py
index d45f0a1..b377197 100644
--- a/src/memlord/tools/search_by_tag.py
+++ b/src/memlord/tools/search_by_tag.py
@@ -10,17 +10,19 @@
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
 from memlord.models import Memory, MemoryTag, Tag
-from memlord.schemas import MemoryListItem, MemoryPage
+from memlord.models.workspace import Workspace
+from memlord.schemas import MemoryItem, MemoryPage
 
 mcp = FastMCP()
 
 _COLS = (
     Memory.id,
+    Memory.name,
     Memory.content,
     Memory.memory_type,
     Memory.extra_data.label("metadata"),
     Memory.created_at,
-    Memory.workspace_id,
+    Workspace.name.label("workspace"),
 )
 
 
@@ -56,6 +58,7 @@ async def search_by_tag(
         )
         stmt = (
             select(*_COLS)
+            .join(Workspace, Memory.workspace_id == Workspace.id)
             .where(matching_count == len(normalized), access_filter)
             .order_by(Memory.created_at.desc())
         )
@@ -64,6 +67,7 @@ async def search_by_tag(
             select(*_COLS)
             .join(MemoryTag, Memory.id == MemoryTag.memory_id)
             .join(Tag, MemoryTag.tag_id == Tag.id)
+            .join(Workspace, Memory.workspace_id == Workspace.id)
             .where(Tag.name.in_(normalized), access_filter)
             .distinct()
             .order_by(Memory.created_at.desc())
@@ -78,9 +82,9 @@ async def search_by_tag(
 
     return MemoryPage(
         items=[
-            MemoryListItem(
+            MemoryItem(
                 **row,
-                tags=tags_map.get(row["id"], set()),
+                tags=set(tags_map.get(row["id"], [])),
             )
             for row in rows
         ],
diff --git a/src/memlord/tools/store.py b/src/memlord/tools/store.py
index 7dfd17f..dd1a38a 100644
--- a/src/memlord/tools/store.py
+++ b/src/memlord/tools/store.py
@@ -18,6 +18,7 @@
 async def store_memory(
     content: str,
     memory_type: MemoryType,
+    name: str | None = None,
     tags: set[str] | None = None,
     metadata: dict | None = None,
     workspace: str | None = None,
@@ -27,6 +28,7 @@ async def store_memory(
 ) -> StoreResult:
     """Save a new memory. Idempotent: returns existing if content already stored.
 
+    name: optional human-readable name, unique within the workspace.
     workspace: name of the workspace to store into (must be a member).
                Omit or pass None to store as a personal memory.
     force: skip near-duplicate check and store unconditionally.
@@ -46,12 +48,13 @@ async def store_memory(
     workspace_id = ws.id
 
     dao = MemoryDao(s, uid)
-    memory_id, created = await dao.create(
+    _, created = await dao.create(
         content=content,
         memory_type=memory_type,
         metadata=metadata or {},
         tags=tags or [],
         workspace_id=workspace_id,
         force=force,
+        name=name,
     )
-    return StoreResult(id=memory_id, created=created)
+    return StoreResult(name=name, created=created)
diff --git a/src/memlord/tools/update.py b/src/memlord/tools/update.py
index 20f0118..810ee23 100644
--- a/src/memlord/tools/update.py
+++ b/src/memlord/tools/update.py
@@ -17,18 +17,26 @@
     annotations=ToolAnnotations(idempotentHint=False, destructiveHint=False),
 )
 async def update_memory(
-    id: int,
+    name: str,
     memory_type: MemoryType,
     content: str | None = None,
+    new_name: str | None = None,
     tags: set[str] | None = None,
     metadata: dict | None = None,
     s: AsyncSession = MCPSessionDep,  # type: ignore[assignment]
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> StoreResult:
-    """Update an existing memory by ID. Only provided fields are changed."""
+    """Update an existing memory identified by name. Only provided fields are changed.
+
+    new_name: rename the memory to this name.
+    """
     dao = MemoryDao(s, uid)
+    memory_id = await dao.get_id_by_name(name)
+    if memory_id is None:
+        raise ValueError(f"Memory with name={name!r} not found")
+
     data: dict[str, Any] = {
-        "id": id,
+        "id": memory_id,
         "memory_type": MemoryType(memory_type),
     }
 
@@ -38,6 +46,8 @@ async def update_memory(
         data["metadata"] = metadata or {}
     if tags is not None:
         data["tags"] = tags
+    if new_name is not None:
+        data["name"] = new_name
 
-    memory_id = await dao.update(**data)
-    return StoreResult(id=memory_id, created=False)
+    _, final_name = await dao.update(**data)
+    return StoreResult(name=final_name, created=False)
diff --git a/src/memlord/ui/base.py b/src/memlord/ui/base.py
index c71bbbd..4f210e7 100644
--- a/src/memlord/ui/base.py
+++ b/src/memlord/ui/base.py
@@ -26,6 +26,7 @@
 
 _COLS = (
     Memory.id,
+    Memory.name,
     Memory.content,
     Memory.memory_type,
     Memory.created_at,
@@ -158,9 +159,6 @@ async def search(
                     )
                 ).all()
             }
-            ws_ids = {r.workspace_id for r in raw if r.workspace_id}
-            ws_names = await WorkspaceDao(s).get_names_by_ids(ws_ids) if ws_ids else {}
-
             for r in raw:
                 results.append(
                     {
@@ -170,9 +168,7 @@ async def search(
                         "tags": tags_map.get(r.id, []),
                         "created_at": created_map.get(r.id, utcnow()),  # type: ignore[call-overload]
                         "rrf_score": round(r.rrf_score, 4),
-                        "workspace_name": (
-                            ws_names.get(r.workspace_id) if r.workspace_id else None
-                        ),
+                        "workspace_name": r.workspace,
                     }
                 )
     return templates.TemplateResponse(
@@ -206,6 +202,7 @@ async def memory_detail(
         {
             "user": user,
             "memory": memory,
+            "memory_id": id,
             "workspace_name": ws_name,
             "writable_workspaces": writable,
         },
@@ -228,17 +225,19 @@ async def update_memory(
     new_content = (body.content or "").strip() or existing.content
     new_type = (body.memory_type or "").strip() or None
     new_tags = [t.lower().strip() for t in (body.tags or []) if t.strip()]
+    new_name = body.name.strip() if body.name and body.name.strip() else None
 
     data: dict = {
         "id": id,
         "memory_type": new_type,
         "metadata": body.metadata,
         "tags": new_tags,
+        "name": new_name,
     }
     if new_content != existing.content:
         data["content"] = new_content
 
-    await dao.update(**data)
+    await dao.update(**data)  # returns (id, name), ignore here
 
     workspaces = await WorkspaceDao(s).list_workspaces(user.id)
     ws_map = {ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces}
@@ -254,14 +253,15 @@ async def update_memory(
         "_memory_content.html",
         {
             "memory": {
-                "id": id,
                 "content": new_content,
+                "name": new_name,
                 "memory_type": new_type or "",
                 "metadata": body.metadata,
                 "tags": new_tags,
                 "created_at": existing.created_at,
                 "workspace_id": existing.workspace_id,
             },
+            "memory_id": id,
             "workspace_name": ws_name,
             "writable_workspaces": writable,
             "success": "Saved.",
@@ -301,6 +301,7 @@ async def move_memory(
             {
                 "user": user,
                 "memory": memory,
+                "memory_id": id,
                 "workspace_name": ws_name,
                 "writable_workspaces": writable,
                 "error": str(e),
@@ -324,6 +325,7 @@ async def move_memory(
         {
             "user": user,
             "memory": memory,
+            "memory_id": id,
             "workspace_name": ws_name,
             "writable_workspaces": writable,
             "success": "Moved.",
diff --git a/tests/test_created_at_tz.py b/tests/test_created_at_tz.py
index a054aae..101a6bd 100644
--- a/tests/test_created_at_tz.py
+++ b/tests/test_created_at_tz.py
@@ -6,9 +6,9 @@
 
 
 def _assert_tz_aware(created_at: datetime) -> None:
-    assert (
-        created_at.tzinfo is not None
-    ), f"created_at must be timezone-aware: {created_at!r}"
+    assert created_at.tzinfo is not None, (
+        f"created_at must be timezone-aware: {created_at!r}"
+    )
 
 
 async def test_recall_memory_created_at_has_timezone(mcp_client):
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index 3eca557..1589178 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -13,13 +13,14 @@ async def test_pipeline(mcp_client):
             "content": "pipeline test memory",
             "memory_type": MemoryType.fact,
             "tags": ["pipeline", "test"],
+            "name": "pipeline-test",
         },
     )
     assert r.data.created is True
-    mid = r.data.id
+    mid = r.data.name
 
     # --- get ---
-    r = await mcp_client.call_tool("get_memory", {"id": mid})
+    r = await mcp_client.call_tool("get_memory", {"name": mid})
     assert r.data.content == "pipeline test memory"
     assert r.data.memory_type == MemoryType.fact
     assert sorted(r.data.tags) == ["pipeline", "test"]
@@ -28,27 +29,32 @@ async def test_pipeline(mcp_client):
     r = await mcp_client.call_tool(
         "update_memory",
         {
-            "id": mid,
+            "name": mid,
             "memory_type": MemoryType.fact,
             "content": "updated pipeline memory",
             "tags": ["pipeline", "updated"],
         },
     )
-    assert r.data.id == mid
+    assert r.data.name == mid
 
-    r = await mcp_client.call_tool("get_memory", {"id": mid})
+    r = await mcp_client.call_tool("get_memory", {"name": mid})
     assert r.data.content == "updated pipeline memory"
     assert sorted(r.data.tags) == ["pipeline", "updated"]
 
+    # --- list_memories ---
+    r = await mcp_client.call_tool("list_memories", {"page": 1, "page_size": 50})
+    names = [m.name for m in r.data.items]
+    assert mid in names
+
     # --- search by tag ---
     r = await mcp_client.call_tool(
         "search_by_tag", {"tags": ["pipeline", "updated"], "operation": "AND"}
     )
-    ids = [m.id for m in r.data.items]
+    ids = [m.name for m in r.data.items]
     assert mid in ids
 
     # --- delete ---
-    await mcp_client.call_tool("delete_memory", {"id": mid})
+    await mcp_client.call_tool("delete_memory", {"name": mid})
 
     with pytest.raises(Exception):
-        await mcp_client.call_tool("get_memory", {"id": mid})
+        await mcp_client.call_tool("get_memory", {"name": mid})

From 512516e1a53c695b2b835e51e76632ea9f890745 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 6 Apr 2026 13:38:12 +0200
Subject: [PATCH 02/16] Remove greenlet from coverage concurrency settings in
 pyproject.toml

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 232c270..2737033 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -53,7 +53,7 @@ packages = ["src/memlord"]
 [tool.coverage.run]
 source = ["src/memlord"]
 parallel = true
-concurrency = ["thread", "greenlet"]
+concurrency = ["thread"]
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"

From 922b420fb4d316f94d6d2857f73ec4feed948229 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 6 Apr 2026 14:11:52 +0200
Subject: [PATCH 03/16] Simplify test setup by removing pytest-asyncio
 dependencies, restore coverage functionality

---
 pyproject.toml    |   3 --
 tests/conftest.py |  11 ++--
 uv.lock           | 124 ++++++++++++++++++++--------------------------
 3 files changed, 60 insertions(+), 78 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 2737033..4d28b7b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -35,7 +35,6 @@ dev = [
     "pytest==9.*",
     "pytest-asyncio",
     "pytest-cov",
-    "pytest-mock",
     "pytest-xdist",
 ]
 
@@ -52,8 +51,6 @@ packages = ["src/memlord"]
 
 [tool.coverage.run]
 source = ["src/memlord"]
-parallel = true
-concurrency = ["thread"]
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
diff --git a/tests/conftest.py b/tests/conftest.py
index acc2052..744dc30 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -3,7 +3,6 @@
 from unittest.mock import patch
 
 import pytest
-import pytest_asyncio
 from fastmcp import Client
 from httpx import ASGITransport, AsyncClient
 from sqlalchemy import text
@@ -57,7 +56,7 @@ async def cleanup():
         print(f"Warning: failed to drop test database: {e}")
 
 
-@pytest_asyncio.fixture
+@pytest.fixture
 async def session(test_db_url):
     engine = create_async_engine(test_db_url)
     async with engine.connect() as conn:
@@ -66,7 +65,7 @@ async def session(test_db_url):
     await engine.dispose()
 
 
-@pytest_asyncio.fixture
+@pytest.fixture
 async def user_id(session: AsyncSession) -> int:
     """Create a test user (with personal workspace) and return its id."""
     user = await UserDao(session).create(
@@ -77,14 +76,14 @@ async def user_id(session: AsyncSession) -> int:
     return user.id  # type: ignore[return-value]
 
 
-@pytest_asyncio.fixture
+@pytest.fixture
 async def workspace_id(session: AsyncSession, user_id: int) -> int:
     """Return the personal workspace id for the test user."""
     ws = await WorkspaceDao(session).get_personal(user_id)
     return ws.id
 
 
-@pytest_asyncio.fixture
+@pytest.fixture
 async def mcp_client(session, user_id):
     async def _session():
         yield session
@@ -100,7 +99,7 @@ async def _user():
             yield client
 
 
-@pytest_asyncio.fixture
+@pytest.fixture
 async def api_client(session, user_id):
     async def _override_session():
         yield session
diff --git a/uv.lock b/uv.lock
index 07083d8..dba9d70 100644
--- a/uv.lock
+++ b/uv.lock
@@ -243,14 +243,14 @@ wheels = [
 
 [[package]]
 name = "click"
-version = "8.3.1"
+version = "8.3.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "colorama", marker = "sys_platform == 'win32'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065, upload-time = "2025-11-15T20:45:42.706Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/57/75/31212c6bf2503fdf920d87fee5d7a86a2e3bcf444984126f13d8e4016804/click-8.3.2.tar.gz", hash = "sha256:14162b8b3b3550a7d479eafa77dfd3c38d9dc8951f6f69c78913a8f9a7540fd5", size = 302856, upload-time = "2026-04-03T19:14:45.118Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274, upload-time = "2025-11-15T20:45:41.139Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/20/71885d8b97d4f3dde17b1fdb92dbd4908b00541c5a3379787137285f602e/click-8.3.2-py3-none-any.whl", hash = "sha256:1924d2c27c5653561cd2cae4548d1406039cb79b858b747cfea24924bbc1616d", size = 108379, upload-time = "2026-04-03T19:14:43.505Z" },
 ]
 
 [[package]]
@@ -418,7 +418,7 @@ wheels = [
 
 [[package]]
 name = "fastapi"
-version = "0.135.2"
+version = "0.135.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "annotated-doc" },
@@ -427,9 +427,9 @@ dependencies = [
     { name = "typing-extensions" },
     { name = "typing-inspection" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/c4/73/5903c4b13beae98618d64eb9870c3fac4f605523dd0312ca5c80dadbd5b9/fastapi-0.135.2.tar.gz", hash = "sha256:88a832095359755527b7f63bb4c6bc9edb8329a026189eed83d6c1afcf419d56", size = 395833, upload-time = "2026-03-23T14:12:41.697Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/f7/e6/7adb4c5fa231e82c35b8f5741a9f2d055f520c29af5546fd70d3e8e1cd2e/fastapi-0.135.3.tar.gz", hash = "sha256:bd6d7caf1a2bdd8d676843cdcd2287729572a1ef524fc4d65c17ae002a1be654", size = 396524, upload-time = "2026-04-01T16:23:58.188Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/8f/ea/18f6d0457f9efb2fc6fa594857f92810cadb03024975726db6546b3d6fcf/fastapi-0.135.2-py3-none-any.whl", hash = "sha256:0af0447d541867e8db2a6a25c23a8c4bd80e2394ac5529bd87501bbb9e240ca5", size = 117407, upload-time = "2026-03-23T14:12:43.284Z" },
+    { url = "https://files.pythonhosted.org/packages/84/a4/5caa2de7f917a04ada20018eccf60d6cc6145b0199d55ca3711b0fc08312/fastapi-0.135.3-py3-none-any.whl", hash = "sha256:9b0f590c813acd13d0ab43dd8494138eb58e484bfac405db1f3187cfc5810d98", size = 117734, upload-time = "2026-04-01T16:23:59.328Z" },
 ]
 
 [package.optional-dependencies]
@@ -663,7 +663,7 @@ wheels = [
 
 [[package]]
 name = "huggingface-hub"
-version = "1.8.0"
+version = "1.9.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "filelock" },
@@ -676,9 +676,9 @@ dependencies = [
     { name = "typer" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/8e/2a/a847fd02261cd051da218baf99f90ee7c7040c109a01833db4f838f25256/huggingface_hub-1.8.0.tar.gz", hash = "sha256:c5627b2fd521e00caf8eff4ac965ba988ea75167fad7ee72e17f9b7183ec63f3", size = 735839, upload-time = "2026-03-25T16:01:28.152Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/88/bb/62c7aa86f63a05e2f9b96642fdef9b94526a23979820b09f5455deff4983/huggingface_hub-1.9.0.tar.gz", hash = "sha256:0ea5be7a56135c91797cae6ad726e38eaeb6eb4b77cefff5c9d38ba0ecf874f7", size = 750326, upload-time = "2026-04-03T08:35:55.888Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a9/ae/8a3a16ea4d202cb641b51d2681bdd3d482c1c592d7570b3fa264730829ce/huggingface_hub-1.8.0-py3-none-any.whl", hash = "sha256:d3eb5047bd4e33c987429de6020d4810d38a5bef95b3b40df9b17346b7f353f2", size = 625208, upload-time = "2026-03-25T16:01:26.603Z" },
+    { url = "https://files.pythonhosted.org/packages/73/37/0d15d16150e1829f3e90962c99f28257f6de9e526a680b4c6f5acdb54fd2/huggingface_hub-1.9.0-py3-none-any.whl", hash = "sha256:2999328c058d39fd19ab748dd09bd4da2fbaa4f4c1ddea823eab103051e14a1f", size = 637355, upload-time = "2026-04-03T08:35:53.897Z" },
 ]
 
 [[package]]
@@ -886,7 +886,7 @@ wheels = [
 
 [[package]]
 name = "mcp"
-version = "1.26.0"
+version = "1.27.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "anyio" },
@@ -904,9 +904,9 @@ dependencies = [
     { name = "typing-inspection" },
     { name = "uvicorn", marker = "sys_platform != 'emscripten'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/8b/eb/c0cfc62075dc6e1ec1c64d352ae09ac051d9334311ed226f1f425312848a/mcp-1.27.0.tar.gz", hash = "sha256:d3dc35a7eec0d458c1da4976a48f982097ddaab87e278c5511d5a4a56e852b83", size = 607509, upload-time = "2026-04-02T14:48:08.88Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/46/f6b4ad632c67ef35209a66127e4bddc95759649dd595f71f13fba11bdf9a/mcp-1.27.0-py3-none-any.whl", hash = "sha256:5ce1fa81614958e267b21fb2aa34e0aea8e2c6ede60d52aba45fd47246b4d741", size = 215967, upload-time = "2026-04-02T14:48:07.24Z" },
 ]
 
 [[package]]
@@ -947,7 +947,6 @@ dev = [
     { name = "pytest" },
     { name = "pytest-asyncio" },
     { name = "pytest-cov" },
-    { name = "pytest-mock" },
     { name = "pytest-xdist" },
 ]
 
@@ -978,17 +977,16 @@ dev = [
     { name = "pytest", specifier = "==9.*" },
     { name = "pytest-asyncio" },
     { name = "pytest-cov" },
-    { name = "pytest-mock" },
     { name = "pytest-xdist" },
 ]
 
 [[package]]
 name = "more-itertools"
-version = "10.8.0"
+version = "11.0.1"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/ea/5d/38b681d3fce7a266dd9ab73c66959406d565b3e85f21d5e66e1181d93721/more_itertools-10.8.0.tar.gz", hash = "sha256:f638ddf8a1a0d134181275fb5d58b086ead7c6a72429ad725c67503f13ba30bd", size = 137431, upload-time = "2025-09-02T15:23:11.018Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/24/24/e0acc4bf54cba50c1d432c70a72a3df96db4a321b2c4c68432a60759044f/more_itertools-11.0.1.tar.gz", hash = "sha256:fefaf25b7ab08f0b45fa9f1892cae93b9fc0089ef034d39213bce15f1cc9e199", size = 144739, upload-time = "2026-04-02T16:17:45.061Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a4/8e/469e5a4a2f5855992e425f3cb33804cc07bf18d48f2db061aec61ce50270/more_itertools-10.8.0-py3-none-any.whl", hash = "sha256:52d4362373dcf7c52546bc4af9a86ee7c4579df9a8dc268be0a2f949d376cc9b", size = 69667, upload-time = "2025-09-02T15:23:09.635Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/f4/5e52c7319b8087acef603ed6e50dc325c02eaa999355414830468611f13c/more_itertools-11.0.1-py3-none-any.whl", hash = "sha256:eaf287826069452a8f61026c597eae2428b2d1ba2859083abbf240b46842ce6d", size = 72182, upload-time = "2026-04-02T16:17:43.724Z" },
 ]
 
 [[package]]
@@ -1229,15 +1227,15 @@ wheels = [
 
 [[package]]
 name = "pydantic-extra-types"
-version = "2.11.1"
+version = "2.11.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "pydantic" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/66/71/dba38ee2651f84f7842206adbd2233d8bbdb59fb85e9fa14232486a8c471/pydantic_extra_types-2.11.1.tar.gz", hash = "sha256:46792d2307383859e923d8fcefa82108b1a141f8a9c0198982b3832ab5ef1049", size = 172002, upload-time = "2026-03-16T08:08:03.92Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/41/d3/3be31542180c0300b6860129ff1e3a428f3ef580727616ce22462626129b/pydantic_extra_types-2.11.2.tar.gz", hash = "sha256:3a2b83b61fe920925688e7838b59caa90a45637d1dbba2b1364b8d1f7ff72a0a", size = 203929, upload-time = "2026-04-05T20:50:51.556Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/17/c1/3226e6d7f5a4f736f38ac11a6fbb262d701889802595cdb0f53a885ac2e0/pydantic_extra_types-2.11.1-py3-none-any.whl", hash = "sha256:1722ea2bddae5628ace25f2aa685b69978ef533123e5638cfbddb999e0100ec1", size = 79526, upload-time = "2026-03-16T08:08:02.533Z" },
+    { url = "https://files.pythonhosted.org/packages/92/a4/7b6ab05c18d6c6e682382a0f0235301684452c4131a869f45961d1d032c9/pydantic_extra_types-2.11.2-py3-none-any.whl", hash = "sha256:683b8943252543e49760f89733b1519bc62f31d1a287ebbdc5a7b7959fb4acfd", size = 82851, upload-time = "2026-04-05T20:50:50.036Z" },
 ]
 
 [[package]]
@@ -1329,18 +1327,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/9d/7a/d968e294073affff457b041c2be9868a40c1c71f4a35fcc1e45e5493067b/pytest_cov-7.1.0-py3-none-any.whl", hash = "sha256:a0461110b7865f9a271aa1b51e516c9a95de9d696734a2f71e3e78f46e1d4678", size = 22876, upload-time = "2026-03-21T20:11:14.438Z" },
 ]
 
-[[package]]
-name = "pytest-mock"
-version = "3.15.1"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "pytest" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/68/14/eb014d26be205d38ad5ad20d9a80f7d201472e08167f0bb4361e251084a9/pytest_mock-3.15.1.tar.gz", hash = "sha256:1849a238f6f396da19762269de72cb1814ab44416fa73a8686deac10b0d87a0f", size = 34036, upload-time = "2025-09-16T16:37:27.081Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/5a/cc/06253936f4a7fa2e0f48dfe6d851d9c56df896a9ab09ac019d70b760619c/pytest_mock-3.15.1-py3-none-any.whl", hash = "sha256:0a25e2eb88fe5168d535041d09a4529a188176ae608a6d249ee65abc0949630d", size = 10095, upload-time = "2025-09-16T16:37:25.734Z" },
-]
-
 [[package]]
 name = "pytest-xdist"
 version = "3.8.0"
@@ -1377,11 +1363,11 @@ wheels = [
 
 [[package]]
 name = "python-multipart"
-version = "0.0.22"
+version = "0.0.24"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/94/01/979e98d542a70714b0cb2b6728ed0b7c46792b695e3eaec3e20711271ca3/python_multipart-0.0.22.tar.gz", hash = "sha256:7340bef99a7e0032613f56dc36027b959fd3b30a787ed62d310e951f7c3a3a58", size = 37612, upload-time = "2026-01-25T10:15:56.219Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/8a/45/e23b5dc14ddb9918ae4a625379506b17b6f8fc56ca1d82db62462f59aea6/python_multipart-0.0.24.tar.gz", hash = "sha256:9574c97e1c026e00bc30340ef7c7d76739512ab4dfd428fec8c330fa6a5cc3c8", size = 37695, upload-time = "2026-04-05T20:49:13.829Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/1b/d0/397f9626e711ff749a95d96b7af99b9c566a9bb5129b8e4c10fc4d100304/python_multipart-0.0.22-py3-none-any.whl", hash = "sha256:2b2cd894c83d21bf49d702499531c7bafd057d730c201782048f7945d82de155", size = 24579, upload-time = "2026-01-25T10:15:54.811Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/73/89930efabd4da63cea44a3f438aeb753d600123570e6d6264e763617a9ce/python_multipart-0.0.24-py3-none-any.whl", hash = "sha256:9b110a98db707df01a53c194f0af075e736a770dc5058089650d70b4a182f950", size = 24420, upload-time = "2026-04-05T20:49:12.555Z" },
 ]
 
 [[package]]
@@ -1460,26 +1446,26 @@ wheels = [
 
 [[package]]
 name = "regex"
-version = "2026.3.32"
+version = "2026.4.4"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/81/93/5ab3e899c47fa7994e524447135a71cd121685a35c8fe35029005f8b236f/regex-2026.3.32.tar.gz", hash = "sha256:f1574566457161678297a116fa5d1556c5a4159d64c5ff7c760e7c564bf66f16", size = 415605, upload-time = "2026-03-28T21:49:22.012Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/cb/0e/3a246dbf05666918bd3664d9d787f84a9108f6f43cc953a077e4a7dfdb7e/regex-2026.4.4.tar.gz", hash = "sha256:e08270659717f6973523ce3afbafa53515c4dc5dcad637dc215b6fd50f689423", size = 416000, upload-time = "2026-04-03T20:56:28.155Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/38/94/69492c45b0e61b027109d8433a5c3d4f7a90709184c057c7cfc60acb1bfa/regex-2026.3.32-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:ad8d372587e659940568afd009afeb72be939c769c552c9b28773d0337251391", size = 490572, upload-time = "2026-03-28T21:46:28.031Z" },
-    { url = "https://files.pythonhosted.org/packages/92/0a/7dcffeebe0fcac45a1f9caf80712002d3cbd66d7d69d719315ee142b280f/regex-2026.3.32-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:3f5747501b69299c6b0b047853771e4ed390510bada68cb16da9c9c2078343f7", size = 292078, upload-time = "2026-03-28T21:46:29.789Z" },
-    { url = "https://files.pythonhosted.org/packages/e3/ec/988486058ef49eb931476419bae00f164c4ceb44787c45dc7a54b7de0ea4/regex-2026.3.32-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:db976be51375bca900e008941639448d148c655c9545071965d0571ecc04f5d0", size = 289786, upload-time = "2026-03-28T21:46:31.415Z" },
-    { url = "https://files.pythonhosted.org/packages/4a/cf/1955bb5567bc491bd63068e17f75ab0c9ff5e9d08466beec7e347f5e768d/regex-2026.3.32-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:66a5083c3ffe5a5a95f8281ea47a88072d4f24001d562d1d9d28d4cdc005fec5", size = 796431, upload-time = "2026-03-28T21:46:33.101Z" },
-    { url = "https://files.pythonhosted.org/packages/27/8a/67fcbca511b792107540181ee0690df6de877bfbcb41b7ecae7028025ca5/regex-2026.3.32-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e83ce8008b48762be296f1401f19afd9ea29f3d035d1974e0cecb74e9afbd1df", size = 865785, upload-time = "2026-03-28T21:46:35.053Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/59/0677bc44f2c28305edcabc11933777b9ad34e9e8ded7ba573d24e4bc3ee7/regex-2026.3.32-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3aa21bad31db904e0b9055e12c8282df62d43169c4a9d2929407060066ebc74", size = 913593, upload-time = "2026-03-28T21:46:36.835Z" },
-    { url = "https://files.pythonhosted.org/packages/0a/fe/661043d1c263b0d9d10c6ff4e9c9745f3df9641c62b51f96a3473638e7ce/regex-2026.3.32-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f54840bea73541652f1170dc63402a5b776fc851ad36a842da9e5163c1f504a0", size = 801512, upload-time = "2026-03-28T21:46:38.587Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/27/74c986061380e1811a46cf04cdf9c939db9f8c0e63953eddfe37ffd633ea/regex-2026.3.32-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:2ffbadc647325dd4e3118269bda93ded1eb5f5b0c3b7ba79a3da9fbd04f248e9", size = 776182, upload-time = "2026-03-28T21:46:40.69Z" },
-    { url = "https://files.pythonhosted.org/packages/b6/c8/d833397b70cd1bacfcdc0a611f0e2c1f5b91fee8eedd88affcee770cbbb6/regex-2026.3.32-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:66d3126afe7eac41759cd5f0b3b246598086e88e70527c0d68c9e615b81771c4", size = 785837, upload-time = "2026-03-28T21:46:42.926Z" },
-    { url = "https://files.pythonhosted.org/packages/e0/53/fa226b72989b5b93db6926fab5478115e085dfcf077e18d2cb386be0fd23/regex-2026.3.32-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:f785f44a44702dea89b28bce5bc82552490694ce4e144e21a4f0545e364d2150", size = 860612, upload-time = "2026-03-28T21:46:44.8Z" },
-    { url = "https://files.pythonhosted.org/packages/04/28/bdd2fc0c055a1b15702bd4084829bbb6b06095f27990e5bee52b2898ea03/regex-2026.3.32-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:b7836aa13721dbdef658aebd11f60d00de633a95726521860fe1f6be75fa225a", size = 765285, upload-time = "2026-03-28T21:46:46.625Z" },
-    { url = "https://files.pythonhosted.org/packages/b4/da/21f5e2a35a191b27e5a47cccb3914c99e139b49b1342d3f36e64e8cc60f7/regex-2026.3.32-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:5336b1506142eb0f23c96fb4a34b37c4fefd4fed2a7042069f3c8058efe17855", size = 851963, upload-time = "2026-03-28T21:46:48.341Z" },
-    { url = "https://files.pythonhosted.org/packages/18/f4/04ed04ebf335a44083695c22772be6a42efa31900415555563acf02cb4de/regex-2026.3.32-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:b56993a7aeb4140c4770f4f7965c9e5af4f024457d06e23c01b0d47501cb18ed", size = 788332, upload-time = "2026-03-28T21:46:50.454Z" },
-    { url = "https://files.pythonhosted.org/packages/21/25/5355908f479d0dc13d044f88270cdcabc8723efc12e4c2b19e5a94ff1a96/regex-2026.3.32-cp312-cp312-win32.whl", hash = "sha256:d363660f9ef8c734495598d2f3e527fb41f745c73159dc0d743402f049fb6836", size = 266847, upload-time = "2026-03-28T21:46:52.125Z" },
-    { url = "https://files.pythonhosted.org/packages/00/e5/3be71c781a031db5df00735b613895ad5fdbf86c6e3bbea5fbbd7bfb5902/regex-2026.3.32-cp312-cp312-win_amd64.whl", hash = "sha256:c9f261ad3cd97257dc1d9355bfbaa7dd703e06574bffa0fa8fe1e31da915ee38", size = 278034, upload-time = "2026-03-28T21:46:54.096Z" },
-    { url = "https://files.pythonhosted.org/packages/31/5f/27f1e0b1eea4faa99c66daca34130af20c44fae0237bbc98b87999dbc4a8/regex-2026.3.32-cp312-cp312-win_arm64.whl", hash = "sha256:89e50667e7e8c0e7903e4d644a2764fffe9a3a5d6578f72ab7a7b4205bf204b7", size = 270673, upload-time = "2026-03-28T21:46:56.046Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/28/b972a4d3df61e1d7bcf1b59fdb3cddef22f88b6be43f161bb41ebc0e4081/regex-2026.4.4-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:c07ab8794fa929e58d97a0e1796b8b76f70943fa39df225ac9964615cf1f9d52", size = 490434, upload-time = "2026-04-03T20:53:40.219Z" },
+    { url = "https://files.pythonhosted.org/packages/84/20/30041446cf6dc3e0eab344fc62770e84c23b6b68a3b657821f9f80cb69b4/regex-2026.4.4-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:2c785939dc023a1ce4ec09599c032cc9933d258a998d16ca6f2b596c010940eb", size = 292061, upload-time = "2026-04-03T20:53:41.862Z" },
+    { url = "https://files.pythonhosted.org/packages/62/c8/3baa06d75c98c46d4cc4262b71fd2edb9062b5665e868bca57859dadf93a/regex-2026.4.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1b1ce5c81c9114f1ce2f9288a51a8fd3aeea33a0cc440c415bf02da323aa0a76", size = 289628, upload-time = "2026-04-03T20:53:43.701Z" },
+    { url = "https://files.pythonhosted.org/packages/31/87/3accf55634caad8c0acab23f5135ef7d4a21c39f28c55c816ae012931408/regex-2026.4.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:760ef21c17d8e6a4fe8cf406a97cf2806a4df93416ccc82fc98d25b1c20425be", size = 796651, upload-time = "2026-04-03T20:53:45.379Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/0c/aaa2c83f34efedbf06f61cb1942c25f6cf1ee3b200f832c4d05f28306c2e/regex-2026.4.4-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:7088fcdcb604a4417c208e2169715800d28838fefd7455fbe40416231d1d47c1", size = 865916, upload-time = "2026-04-03T20:53:47.064Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/f6/8c6924c865124643e8f37823eca845dc27ac509b2ee58123685e71cd0279/regex-2026.4.4-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:07edca1ba687998968f7db5bc355288d0c6505caa7374f013d27356d93976d13", size = 912287, upload-time = "2026-04-03T20:53:49.422Z" },
+    { url = "https://files.pythonhosted.org/packages/11/0e/a9f6f81013e0deaf559b25711623864970fe6a098314e374ccb1540a4152/regex-2026.4.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:993f657a7c1c6ec51b5e0ba97c9817d06b84ea5fa8d82e43b9405de0defdc2b9", size = 801126, upload-time = "2026-04-03T20:53:51.096Z" },
+    { url = "https://files.pythonhosted.org/packages/71/61/3a0cc8af2dc0c8deb48e644dd2521f173f7e6513c6e195aad9aa8dd77ac5/regex-2026.4.4-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:2b69102a743e7569ebee67e634a69c4cb7e59d6fa2e1aa7d3bdbf3f61435f62d", size = 776788, upload-time = "2026-04-03T20:53:52.889Z" },
+    { url = "https://files.pythonhosted.org/packages/64/0b/8bb9cbf21ef7dee58e49b0fdb066a7aded146c823202e16494a36777594f/regex-2026.4.4-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:6dac006c8b6dda72d86ea3d1333d45147de79a3a3f26f10c1cf9287ca4ca0ac3", size = 785184, upload-time = "2026-04-03T20:53:55.627Z" },
+    { url = "https://files.pythonhosted.org/packages/99/c2/d3e80e8137b25ee06c92627de4e4d98b94830e02b3e6f81f3d2e3f504cf5/regex-2026.4.4-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:50a766ee2010d504554bfb5f578ed2e066898aa26411d57e6296230627cdefa0", size = 859913, upload-time = "2026-04-03T20:53:57.249Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/e6/9d5d876157d969c804622456ef250017ac7a8f83e0e14f903b9e6df5ce95/regex-2026.4.4-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:9e2f5217648f68e3028c823df58663587c1507a5ba8419f4fdfc8a461be76043", size = 765732, upload-time = "2026-04-03T20:53:59.428Z" },
+    { url = "https://files.pythonhosted.org/packages/82/80/b568935b4421388561c8ed42aff77247285d3ae3bb2a6ca22af63bae805e/regex-2026.4.4-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:39d8de85a08e32632974151ba59c6e9140646dcc36c80423962b1c5c0a92e244", size = 852152, upload-time = "2026-04-03T20:54:01.505Z" },
+    { url = "https://files.pythonhosted.org/packages/39/29/f0f81217e21cd998245da047405366385d5c6072048038a3d33b37a79dc0/regex-2026.4.4-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:55d9304e0e7178dfb1e106c33edf834097ddf4a890e2f676f6c5118f84390f73", size = 789076, upload-time = "2026-04-03T20:54:03.323Z" },
+    { url = "https://files.pythonhosted.org/packages/49/1d/1d957a61976ab9d4e767dd4f9d04b66cc0c41c5e36cf40e2d43688b5ae6f/regex-2026.4.4-cp312-cp312-win32.whl", hash = "sha256:04bb679bc0bde8a7bfb71e991493d47314e7b98380b083df2447cda4b6edb60f", size = 266700, upload-time = "2026-04-03T20:54:05.639Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/5c/bf575d396aeb58ea13b06ef2adf624f65b70fafef6950a80fc3da9cae3bc/regex-2026.4.4-cp312-cp312-win_amd64.whl", hash = "sha256:db0ac18435a40a2543dbb3d21e161a6c78e33e8159bd2e009343d224bb03bb1b", size = 277768, upload-time = "2026-04-03T20:54:07.312Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/27/049df16ec6a6828ccd72add3c7f54b4df029669bea8e9817df6fff58be90/regex-2026.4.4-cp312-cp312-win_arm64.whl", hash = "sha256:4ce255cc05c1947a12989c6db801c96461947adb7a59990f1360b5983fab4983", size = 270568, upload-time = "2026-04-03T20:54:09.484Z" },
 ]
 
 [[package]]
@@ -1614,22 +1600,22 @@ wheels = [
 
 [[package]]
 name = "sqlalchemy"
-version = "2.0.48"
+version = "2.0.49"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "greenlet", marker = "platform_machine == 'AMD64' or platform_machine == 'WIN32' or platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'ppc64le' or platform_machine == 'win32' or platform_machine == 'x86_64'" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/1f/73/b4a9737255583b5fa858e0bb8e116eb94b88c910164ed2ed719147bde3de/sqlalchemy-2.0.48.tar.gz", hash = "sha256:5ca74f37f3369b45e1f6b7b06afb182af1fd5dde009e4ffd831830d98cbe5fe7", size = 9886075, upload-time = "2026-03-02T15:28:51.474Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/09/45/461788f35e0364a8da7bda51a1fe1b09762d0c32f12f63727998d85a873b/sqlalchemy-2.0.49.tar.gz", hash = "sha256:d15950a57a210e36dd4cec1aac22787e2a4d57ba9318233e2ef8b2daf9ff2d5f", size = 9898221, upload-time = "2026-04-03T16:38:11.704Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ef/91/a42ae716f8925e9659df2da21ba941f158686856107a61cc97a95e7647a3/sqlalchemy-2.0.48-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:348174f228b99f33ca1f773e85510e08927620caa59ffe7803b37170df30332b", size = 2155737, upload-time = "2026-03-02T15:49:13.207Z" },
-    { url = "https://files.pythonhosted.org/packages/b9/52/f75f516a1f3888f027c1cfb5d22d4376f4b46236f2e8669dcb0cddc60275/sqlalchemy-2.0.48-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:53667b5f668991e279d21f94ccfa6e45b4e3f4500e7591ae59a8012d0f010dcb", size = 3337020, upload-time = "2026-03-02T15:50:34.547Z" },
-    { url = "https://files.pythonhosted.org/packages/37/9a/0c28b6371e0cdcb14f8f1930778cb3123acfcbd2c95bb9cf6b4a2ba0cce3/sqlalchemy-2.0.48-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:34634e196f620c7a61d18d5cf7dc841ca6daa7961aed75d532b7e58b309ac894", size = 3349983, upload-time = "2026-03-02T15:53:25.542Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/46/0aee8f3ff20b1dcbceb46ca2d87fcc3d48b407925a383ff668218509d132/sqlalchemy-2.0.48-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:546572a1793cc35857a2ffa1fe0e58571af1779bcc1ffa7c9fb0839885ed69a9", size = 3279690, upload-time = "2026-03-02T15:50:36.277Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/8c/a957bc91293b49181350bfd55e6dfc6e30b7f7d83dc6792d72043274a390/sqlalchemy-2.0.48-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:07edba08061bc277bfdc772dd2a1a43978f5a45994dd3ede26391b405c15221e", size = 3314738, upload-time = "2026-03-02T15:53:27.519Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/44/1d257d9f9556661e7bdc83667cc414ba210acfc110c82938cb3611eea58f/sqlalchemy-2.0.48-cp312-cp312-win32.whl", hash = "sha256:908a3fa6908716f803b86896a09a2c4dde5f5ce2bb07aacc71ffebb57986ce99", size = 2115546, upload-time = "2026-03-02T15:54:31.591Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/af/c3c7e1f3a2b383155a16454df62ae8c62a30dd238e42e68c24cebebbfae6/sqlalchemy-2.0.48-cp312-cp312-win_amd64.whl", hash = "sha256:68549c403f79a8e25984376480959975212a670405e3913830614432b5daa07a", size = 2142484, upload-time = "2026-03-02T15:54:34.072Z" },
-    { url = "https://files.pythonhosted.org/packages/46/2c/9664130905f03db57961b8980b05cab624afd114bf2be2576628a9f22da4/sqlalchemy-2.0.48-py3-none-any.whl", hash = "sha256:a66fe406437dd65cacd96a72689a3aaaecaebbcd62d81c5ac1c0fdbeac835096", size = 1940202, upload-time = "2026-03-02T15:52:43.285Z" },
+    { url = "https://files.pythonhosted.org/packages/49/b3/2de412451330756aaaa72d27131db6dde23995efe62c941184e15242a5fa/sqlalchemy-2.0.49-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:4bbccb45260e4ff1b7db0be80a9025bb1e6698bdb808b83fff0000f7a90b2c0b", size = 2157681, upload-time = "2026-04-03T16:53:07.132Z" },
+    { url = "https://files.pythonhosted.org/packages/50/84/b2a56e2105bd11ebf9f0b93abddd748e1a78d592819099359aa98134a8bf/sqlalchemy-2.0.49-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fb37f15714ec2652d574f021d479e78cd4eb9d04396dca36568fdfffb3487982", size = 3338976, upload-time = "2026-04-03T17:07:40Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/fa/65fcae2ed62f84ab72cf89536c7c3217a156e71a2c111b1305ab6f0690e2/sqlalchemy-2.0.49-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3bb9ec6436a820a4c006aad1ac351f12de2f2dbdaad171692ee457a02429b672", size = 3351937, upload-time = "2026-04-03T17:12:23.374Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/2f/6fd118563572a7fe475925742eb6b3443b2250e346a0cc27d8d408e73773/sqlalchemy-2.0.49-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8d6efc136f44a7e8bc8088507eaabbb8c2b55b3dbb63fe102c690da0ddebe55e", size = 3281646, upload-time = "2026-04-03T17:07:41.949Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/d7/410f4a007c65275b9cf82354adb4bb8ba587b176d0a6ee99caa16fe638f8/sqlalchemy-2.0.49-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:e06e617e3d4fd9e51d385dfe45b077a41e9d1b033a7702551e3278ac597dc750", size = 3316695, upload-time = "2026-04-03T17:12:25.642Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/95/81f594aa60ded13273a844539041ccf1e66c5a7bed0a8e27810a3b52d522/sqlalchemy-2.0.49-cp312-cp312-win32.whl", hash = "sha256:83101a6930332b87653886c01d1ee7e294b1fe46a07dd9a2d2b4f91bcc88eec0", size = 2117483, upload-time = "2026-04-03T17:05:40.896Z" },
+    { url = "https://files.pythonhosted.org/packages/47/9e/fd90114059175cac64e4fafa9bf3ac20584384d66de40793ae2e2f26f3bb/sqlalchemy-2.0.49-cp312-cp312-win_amd64.whl", hash = "sha256:618a308215b6cececb6240b9abde545e3acdabac7ae3e1d4e666896bf5ba44b4", size = 2144494, upload-time = "2026-04-03T17:05:42.282Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/30/8519fdde58a7bdf155b714359791ad1dc018b47d60269d5d160d311fdc36/sqlalchemy-2.0.49-py3-none-any.whl", hash = "sha256:ec44cfa7ef1a728e88ad41674de50f6db8cfdb3e2af84af86e0041aaf02d43d0", size = 1942158, upload-time = "2026-04-03T16:53:44.135Z" },
 ]
 
 [package.optional-dependencies]
@@ -1751,11 +1737,11 @@ wheels = [
 
 [[package]]
 name = "tzdata"
-version = "2025.3"
+version = "2026.1"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/5e/a7/c202b344c5ca7daf398f3b8a477eeb205cf3b6f32e7ec3a6bac0629ca975/tzdata-2025.3.tar.gz", hash = "sha256:de39c2ca5dc7b0344f2eba86f49d614019d29f060fc4ebc8a417896a620b56a7", size = 196772, upload-time = "2025-12-13T17:45:35.667Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/19/f5/cd531b2d15a671a40c0f66cf06bc3570a12cd56eef98960068ebbad1bf5a/tzdata-2026.1.tar.gz", hash = "sha256:67658a1903c75917309e753fdc349ac0efd8c27db7a0cb406a25be4840f87f98", size = 197639, upload-time = "2026-04-03T11:25:22.002Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c7/b0/003792df09decd6849a5e39c28b513c06e84436a54440380862b5aeff25d/tzdata-2025.3-py2.py3-none-any.whl", hash = "sha256:06a47e5700f3081aab02b2e513160914ff0694bce9947d6b76ebd6bf57cfc5d1", size = 348521, upload-time = "2025-12-13T17:45:33.889Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/70/d460bd685a170790ec89317e9bd33047988e4bce507b831f5db771e142de/tzdata-2026.1-py2.py3-none-any.whl", hash = "sha256:4b1d2be7ac37ceafd7327b961aa3a54e467efbdb563a23655fbfe0d39cfc42a9", size = 348952, upload-time = "2026-04-03T11:25:20.313Z" },
 ]
 
 [[package]]
@@ -1790,15 +1776,15 @@ wheels = [
 
 [[package]]
 name = "uvicorn"
-version = "0.42.0"
+version = "0.44.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
     { name = "h11" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/e3/ad/4a96c425be6fb67e0621e62d86c402b4a17ab2be7f7c055d9bd2f638b9e2/uvicorn-0.42.0.tar.gz", hash = "sha256:9b1f190ce15a2dd22e7758651d9b6d12df09a13d51ba5bf4fc33c383a48e1775", size = 85393, upload-time = "2026-03-16T06:19:50.077Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/5e/da/6eee1ff8b6cbeed47eeb5229749168e81eb4b7b999a1a15a7176e51410c9/uvicorn-0.44.0.tar.gz", hash = "sha256:6c942071b68f07e178264b9152f1f16dfac5da85880c4ce06366a96d70d4f31e", size = 86947, upload-time = "2026-04-06T09:23:22.826Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/0a/89/f8827ccff89c1586027a105e5630ff6139a64da2515e24dafe860bd9ae4d/uvicorn-0.42.0-py3-none-any.whl", hash = "sha256:96c30f5c7abe6f74ae8900a70e92b85ad6613b745d4879eb9b16ccad15645359", size = 68830, upload-time = "2026-03-16T06:19:48.325Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/23/a5bbd9600dd607411fa644c06ff4951bec3a4d82c4b852374024359c19c0/uvicorn-0.44.0-py3-none-any.whl", hash = "sha256:ce937c99a2cc70279556967274414c087888e8cec9f9c94644dfca11bd3ced89", size = 69425, upload-time = "2026-04-06T09:23:21.524Z" },
 ]
 
 [package.optional-dependencies]

From d56650aff96e4a2a144d80023da87f8e65d09e9a Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 6 Apr 2026 14:36:49 +0200
Subject: [PATCH 04/16] Refactor WorkspaceDao to include user ID in
 constructor.

---
 src/memlord/dao/memory.py          |   5 +-
 src/memlord/dao/user.py            |   2 +-
 src/memlord/dao/workspace.py       | 110 ++++++++++++-----------------
 src/memlord/tools/get_memory.py    |   2 +-
 src/memlord/tools/list_memories.py |   2 +-
 src/memlord/tools/move.py          |   2 +-
 src/memlord/tools/recall.py        |   6 +-
 src/memlord/tools/retrieve.py      |   6 +-
 src/memlord/tools/search_by_tag.py |   2 +-
 src/memlord/tools/store.py         |   8 +--
 src/memlord/tools/workspaces.py    |   2 +-
 src/memlord/ui/base.py             |  16 ++---
 src/memlord/ui/data.py             |  12 ++--
 src/memlord/ui/workspaces.py       |  40 +++++------
 tests/test_pipeline.py             |   8 +++
 15 files changed, 107 insertions(+), 116 deletions(-)

diff --git a/src/memlord/dao/memory.py b/src/memlord/dao/memory.py
index a935839..a9a46eb 100644
--- a/src/memlord/dao/memory.py
+++ b/src/memlord/dao/memory.py
@@ -22,6 +22,7 @@ class MemoryDao:
     def __init__(self, s: AsyncSession, uid: int) -> None:
         self._s = s
         self._uid = uid
+        self._ws_dao = WorkspaceDao(s, uid)
 
     async def _upsert_tags(self, memory_id: int, tags: set[str]) -> None:
         for tag_name in tags:
@@ -95,11 +96,11 @@ async def get_id_by_name(self, name: str) -> int | None:
         )
 
     async def _personal_workspace_id(self) -> int:
-        ws = await WorkspaceDao(self._s).get_personal(self._uid)
+        ws = await self._ws_dao.get_personal()
         return ws.id
 
     async def _accessible_workspace_ids(self) -> list[int]:
-        return await WorkspaceDao(self._s).get_accessible_workspace_ids(self._uid)
+        return await self._ws_dao.get_accessible_workspace_ids()
 
     async def create(
         self,
diff --git a/src/memlord/dao/user.py b/src/memlord/dao/user.py
index 444a619..adc619c 100644
--- a/src/memlord/dao/user.py
+++ b/src/memlord/dao/user.py
@@ -96,7 +96,7 @@ async def create(
             .returning(User.id)
         )
         assert user_id is not None
-        await WorkspaceDao(self._s).create_personal(user_id)
+        await WorkspaceDao(self._s, user_id).create_personal()
         return UserInfo(
             id=user_id,
             display_name=display_name.strip(),
diff --git a/src/memlord/dao/workspace.py b/src/memlord/dao/workspace.py
index e31a35a..98d9bf3 100644
--- a/src/memlord/dao/workspace.py
+++ b/src/memlord/dao/workspace.py
@@ -19,18 +19,17 @@
 
 
 class WorkspaceDao:
-    def __init__(self, s: AsyncSession) -> None:
+    def __init__(self, s: AsyncSession, uid: int) -> None:
         self._s = s
+        self._uid = uid
 
-    async def create(
-        self, name: str, owner_id: int, description: str | None = None
-    ) -> WorkspaceInfo:
+    async def create(self, name: str, description: str | None = None) -> WorkspaceInfo:
         workspace_id = await self._s.scalar(
             insert(Workspace)
             .values(
                 name=name,
                 description=description,
-                created_by=owner_id,
+                created_by=self._uid,
                 is_personal=False,
             )
             .returning(Workspace.id)
@@ -38,7 +37,7 @@ async def create(
         assert workspace_id is not None
         await self._s.execute(
             insert(WorkspaceMember).values(
-                workspace_id=workspace_id, user_id=owner_id, role=WorkspaceRole.owner
+                workspace_id=workspace_id, user_id=self._uid, role=WorkspaceRole.owner
             )
         )
         return WorkspaceInfo(
@@ -50,18 +49,18 @@ async def create(
             is_personal=False,
         )
 
-    async def create_personal(self, user_id: int) -> WorkspaceInfo:
-        """Create a personal workspace for user_id and add them as owner."""
-        name = f"__personal_{user_id}__"
+    async def create_personal(self) -> WorkspaceInfo:
+        """Create a personal workspace for self._uid and add them as owner."""
+        name = f"__personal_{self._uid}__"
         workspace_id = await self._s.scalar(
             insert(Workspace)
-            .values(name=name, created_by=user_id, is_personal=True)
+            .values(name=name, created_by=self._uid, is_personal=True)
             .returning(Workspace.id)
         )
         assert workspace_id is not None
         await self._s.execute(
             insert(WorkspaceMember).values(
-                workspace_id=workspace_id, user_id=user_id, role=WorkspaceRole.owner
+                workspace_id=workspace_id, user_id=self._uid, role=WorkspaceRole.owner
             )
         )
         return WorkspaceInfo(
@@ -73,14 +72,8 @@ async def create_personal(self, user_id: int) -> WorkspaceInfo:
             is_personal=True,
         )
 
-    async def get_personal(self, user_id: int) -> WorkspaceInfo:
-        """Return the personal workspace for user_id. Raises if not found."""
-        member_count_subq = (
-            select(sa.func.count())
-            .where(WorkspaceMember.workspace_id == Workspace.id)
-            .correlate(Workspace)
-            .scalar_subquery()
-        )
+    async def get_personal(self) -> WorkspaceInfo:
+        """Return the personal workspace for self._uid. Raises if not found."""
         row = (
             (
                 await self._s.execute(
@@ -88,15 +81,9 @@ async def get_personal(self, user_id: int) -> WorkspaceInfo:
                         Workspace.id,
                         Workspace.name,
                         Workspace.description,
-                        Workspace.is_personal,
-                        WorkspaceMember.role,
-                        member_count_subq.label("member_count"),
-                    )
-                    .join(WorkspaceMember, WorkspaceMember.workspace_id == Workspace.id)
-                    .where(
-                        Workspace.created_by == user_id,
+                    ).where(
+                        Workspace.created_by == self._uid,
                         Workspace.is_personal.is_(True),
-                        WorkspaceMember.user_id == user_id,
                     )
                 )
             )
@@ -104,24 +91,24 @@ async def get_personal(self, user_id: int) -> WorkspaceInfo:
             .one_or_none()
         )
         if row is None:
-            raise ValueError(f"Personal workspace not found for user {user_id}")
+            raise ValueError(f"Personal workspace not found for user {self._uid}")
         return WorkspaceInfo(
             id=row["id"],
             name=row["name"],
             description=row["description"],
-            role=row["role"],
-            member_count=row["member_count"],
+            role=WorkspaceRole.owner,
+            member_count=1,
             is_personal=True,
         )
 
-    async def can_write(self, workspace_id: int, user_id: int) -> bool:
-        """True if user has owner or editor role in the workspace."""
-        role = await self.get_role(workspace_id, user_id)
+    async def can_write(self, workspace_id: int) -> bool:
+        """True if self._uid has owner or editor role in the workspace."""
+        role = await self.get_role(workspace_id, self._uid)
         return role in (WorkspaceRole.owner, WorkspaceRole.editor)
 
-    async def can_read(self, workspace_id: int, user_id: int) -> bool:
-        """True if user is any member of the workspace."""
-        role = await self.get_role(workspace_id, user_id)
+    async def can_read(self, workspace_id: int) -> bool:
+        """True if self._uid is any member of the workspace."""
+        role = await self.get_role(workspace_id, self._uid)
         return role is not None
 
     async def get_role(self, workspace_id: int, user_id: int) -> WorkspaceRole | None:
@@ -160,21 +147,21 @@ async def remove_member(self, workspace_id: int, user_id: int) -> None:
             )
         )
 
-    async def delete_workspace(self, workspace_id: int, owner_id: int) -> None:
-        role = await self.get_role(workspace_id, owner_id)
+    async def delete_workspace(self, workspace_id: int) -> None:
+        role = await self.get_role(workspace_id, self._uid)
         if role != WorkspaceRole.owner:
             raise ValueError("Only the owner can delete a workspace")
         await self._s.execute(delete(Workspace).where(Workspace.id == workspace_id))
 
-    async def get_accessible_workspace_ids(self, user_id: int) -> list[int]:
+    async def get_accessible_workspace_ids(self) -> list[int]:
         rows = await self._s.scalars(
             select(WorkspaceMember.workspace_id).where(
-                WorkspaceMember.user_id == user_id
+                WorkspaceMember.user_id == self._uid
             )
         )
         return list(rows)
 
-    async def list_workspaces(self, user_id: int) -> list[WorkspaceInfo]:
+    async def list_workspaces(self) -> list[WorkspaceInfo]:
         member_count_subq = (
             select(sa.func.count())
             .where(WorkspaceMember.workspace_id == Workspace.id)
@@ -193,7 +180,7 @@ async def list_workspaces(self, user_id: int) -> list[WorkspaceInfo]:
                         member_count_subq.label("member_count"),
                     )
                     .join(WorkspaceMember, WorkspaceMember.workspace_id == Workspace.id)
-                    .where(WorkspaceMember.user_id == user_id)
+                    .where(WorkspaceMember.user_id == self._uid)
                     .order_by(Workspace.name)
                 )
             )
@@ -212,8 +199,8 @@ async def list_workspaces(self, user_id: int) -> list[WorkspaceInfo]:
             for row in rows
         ]
 
-    async def get_by_name(self, name: str, user_id: int) -> WorkspaceInfo | None:
-        """Find a workspace by name among workspaces accessible to user_id."""
+    async def get_by_name(self, name: str) -> WorkspaceInfo | None:
+        """Find a workspace by name among workspaces accessible to self._uid."""
         member_count_subq = (
             select(sa.func.count())
             .where(WorkspaceMember.workspace_id == Workspace.id)
@@ -232,7 +219,7 @@ async def get_by_name(self, name: str, user_id: int) -> WorkspaceInfo | None:
                         member_count_subq.label("member_count"),
                     )
                     .join(WorkspaceMember, WorkspaceMember.workspace_id == Workspace.id)
-                    .where(Workspace.name == name, WorkspaceMember.user_id == user_id)
+                    .where(Workspace.name == name, WorkspaceMember.user_id == self._uid)
                 )
             )
             .mappings()
@@ -249,9 +236,7 @@ async def get_by_name(self, name: str, user_id: int) -> WorkspaceInfo | None:
             is_personal=row["is_personal"],
         )
 
-    async def get_by_id_for_user(
-        self, workspace_id: int, user_id: int
-    ) -> WorkspaceInfo | None:
+    async def get_by_id_for_user(self, workspace_id: int) -> WorkspaceInfo | None:
         member_count_subq = (
             select(sa.func.count())
             .where(WorkspaceMember.workspace_id == workspace_id)
@@ -270,7 +255,8 @@ async def get_by_id_for_user(
                     )
                     .join(WorkspaceMember, WorkspaceMember.workspace_id == Workspace.id)
                     .where(
-                        Workspace.id == workspace_id, WorkspaceMember.user_id == user_id
+                        Workspace.id == workspace_id,
+                        WorkspaceMember.user_id == self._uid,
                     )
                 )
             )
@@ -288,8 +274,8 @@ async def get_by_id_for_user(
             is_personal=row["is_personal"],
         )
 
-    async def rename(self, workspace_id: int, owner_id: int, name: str) -> None:
-        role = await self.get_role(workspace_id, owner_id)
+    async def rename(self, workspace_id: int, name: str) -> None:
+        role = await self.get_role(workspace_id, self._uid)
         if role != WorkspaceRole.owner:
             raise ValueError("Only the owner can rename a workspace")
         await self._s.execute(
@@ -297,9 +283,9 @@ async def rename(self, workspace_id: int, owner_id: int, name: str) -> None:
         )
 
     async def update_description(
-        self, workspace_id: int, owner_id: int, description: str | None
+        self, workspace_id: int, description: str | None
     ) -> None:
-        role = await self.get_role(workspace_id, owner_id)
+        role = await self.get_role(workspace_id, self._uid)
         if role != WorkspaceRole.owner:
             raise ValueError("Only the owner can update the workspace description")
         await self._s.execute(
@@ -338,10 +324,8 @@ async def get_members(self, workspace_id: int) -> list[WorkspaceMemberInfo]:
             for row in rows
         ]
 
-    async def create_invite(
-        self, workspace_id: int, created_by: int, expires_in_hours: int = 72
-    ) -> str:
-        role = await self.get_role(workspace_id, created_by)
+    async def create_invite(self, workspace_id: int, expires_in_hours: int = 72) -> str:
+        role = await self.get_role(workspace_id, self._uid)
         if role is None:
             raise ValueError(f"Not a member of workspace {workspace_id}")
         token = str(uuid.uuid4())
@@ -350,7 +334,7 @@ async def create_invite(
             insert(WorkspaceInvite).values(
                 id=token,
                 workspace_id=workspace_id,
-                created_by=created_by,
+                created_by=self._uid,
                 expires_at=expires_at,
             )
         )
@@ -377,7 +361,7 @@ async def get_invite(self, token: str):
             .one_or_none()
         )
 
-    async def use_invite(self, token: str, user_id: int) -> WorkspaceInfo:
+    async def use_invite(self, token: str) -> WorkspaceInfo:
         row = await self.get_invite(token)
         if row is None:
             raise ValueError("Invalid invite token")
@@ -387,18 +371,18 @@ async def use_invite(self, token: str, user_id: int) -> WorkspaceInfo:
             raise ValueError("Invite has expired")
 
         workspace_id = row["workspace_id"]
-        existing_role = await self.get_role(workspace_id, user_id)
+        existing_role = await self.get_role(workspace_id, self._uid)
         if existing_role is not None:
             raise ValueError("Already a member of this workspace")
 
         await self._s.execute(
             update(WorkspaceInvite)
             .where(WorkspaceInvite.id == token)
-            .values(used_by=user_id, used_at=datetime.utcnow())
+            .values(used_by=self._uid, used_at=datetime.utcnow())
         )
-        await self.add_member(workspace_id, user_id, role=WorkspaceRole.member)
+        await self.add_member(workspace_id, self._uid, role=WorkspaceRole.member)
 
-        ws_info = await self.get_by_id_for_user(workspace_id, user_id)
+        ws_info = await self.get_by_id_for_user(workspace_id)
         assert ws_info is not None
         return ws_info
 
diff --git a/src/memlord/tools/get_memory.py b/src/memlord/tools/get_memory.py
index afffa60..71724ea 100644
--- a/src/memlord/tools/get_memory.py
+++ b/src/memlord/tools/get_memory.py
@@ -24,7 +24,7 @@ async def get_memory(
 
     ws_name: str | None = None
     if item.workspace_id is not None:
-        names = await WorkspaceDao(s).get_names_by_ids({item.workspace_id})
+        names = await WorkspaceDao(s, uid).get_names_by_ids({item.workspace_id})
         ws_name = names.get(item.workspace_id)
 
     return MemoryDetail(
diff --git a/src/memlord/tools/list_memories.py b/src/memlord/tools/list_memories.py
index 1775a5a..265eacc 100644
--- a/src/memlord/tools/list_memories.py
+++ b/src/memlord/tools/list_memories.py
@@ -42,7 +42,7 @@ async def list_memories(
     page_size = min(page_size, 100)
     offset = (page - 1) * page_size
 
-    workspace_ids = await WorkspaceDao(s).get_accessible_workspace_ids(uid)
+    workspace_ids = await WorkspaceDao(s, uid).get_accessible_workspace_ids()
     q = (
         select(*_COLS)
         .join(Workspace, Memory.workspace_id == Workspace.id)
diff --git a/src/memlord/tools/move.py b/src/memlord/tools/move.py
index 6643a18..a106279 100644
--- a/src/memlord/tools/move.py
+++ b/src/memlord/tools/move.py
@@ -31,7 +31,7 @@ async def move_memory(
     if memory_id is None:
         raise ValueError(f"Memory with name={name!r} not found")
 
-    ws = await WorkspaceDao(s).get_by_name(workspace, uid)
+    ws = await WorkspaceDao(s, uid).get_by_name(workspace)
     if ws is None:
         raise ValueError(
             f"Workspace '{workspace}' not found or you are not a member. "
diff --git a/src/memlord/tools/recall.py b/src/memlord/tools/recall.py
index 476c0b1..f80ed7d 100644
--- a/src/memlord/tools/recall.py
+++ b/src/memlord/tools/recall.py
@@ -55,14 +55,14 @@ async def recall_memory(
             remaining = remaining.replace(date_str, "")
         semantic_query = remaining.strip() or query
 
-    ws_dao = WorkspaceDao(s)
+    ws_dao = WorkspaceDao(s, uid)
     if workspace is not None:
-        ws = await ws_dao.get_by_name(workspace, uid)
+        ws = await ws_dao.get_by_name(workspace)
         if ws is None:
             raise ValueError(f"Workspace {workspace!r} not found or not accessible")
         workspace_ids = [ws.id]
     else:
-        workspace_ids = await ws_dao.get_accessible_workspace_ids(uid)
+        workspace_ids = await ws_dao.get_accessible_workspace_ids()
     results = await hybrid_search(
         s,
         query=semantic_query,
diff --git a/src/memlord/tools/retrieve.py b/src/memlord/tools/retrieve.py
index 68745fb..c860be6 100644
--- a/src/memlord/tools/retrieve.py
+++ b/src/memlord/tools/retrieve.py
@@ -29,14 +29,14 @@ async def retrieve_memory(
     Use get_memory(name=...) to fetch full content of a specific result.
     Pass workspace=<name> to search only within a specific workspace.
     """
-    ws_dao = WorkspaceDao(s)
+    ws_dao = WorkspaceDao(s, uid)
     if workspace is not None:
-        ws = await ws_dao.get_by_name(workspace, uid)
+        ws = await ws_dao.get_by_name(workspace)
         if ws is None:
             raise ValueError(f"Workspace {workspace!r} not found or not accessible")
         workspace_ids = [ws.id]
     else:
-        workspace_ids = await ws_dao.get_accessible_workspace_ids(uid)
+        workspace_ids = await ws_dao.get_accessible_workspace_ids()
     results = await hybrid_search(
         s,
         query=query,
diff --git a/src/memlord/tools/search_by_tag.py b/src/memlord/tools/search_by_tag.py
index b377197..771ac6f 100644
--- a/src/memlord/tools/search_by_tag.py
+++ b/src/memlord/tools/search_by_tag.py
@@ -44,7 +44,7 @@ async def search_by_tag(
     if not normalized:
         return MemoryPage()
 
-    workspace_ids = await WorkspaceDao(s).get_accessible_workspace_ids(uid)
+    workspace_ids = await WorkspaceDao(s, uid).get_accessible_workspace_ids()
     access_filter = Memory.workspace_id.in_(workspace_ids)
 
     if operation == "AND":
diff --git a/src/memlord/tools/store.py b/src/memlord/tools/store.py
index dd1a38a..658051a 100644
--- a/src/memlord/tools/store.py
+++ b/src/memlord/tools/store.py
@@ -33,18 +33,18 @@ async def store_memory(
                Omit or pass None to store as a personal memory.
     force: skip near-duplicate check and store unconditionally.
     """
-    ws_dao = WorkspaceDao(s)
+    ws_dao = WorkspaceDao(s, uid)
     if workspace is not None:
-        ws = await ws_dao.get_by_name(workspace, uid)
+        ws = await ws_dao.get_by_name(workspace)
         if ws is None:
             raise ValueError(
                 f"Workspace '{workspace}' not found or you are not a member. "
                 "Use list_workspaces() to see available workspaces."
             )
-        if not await ws_dao.can_write(ws.id, uid):
+        if not await ws_dao.can_write(ws.id):
             raise ValueError(f"You don't have write access to workspace '{workspace}'.")
     else:
-        ws = await ws_dao.get_personal(uid)
+        ws = await ws_dao.get_personal()
     workspace_id = ws.id
 
     dao = MemoryDao(s, uid)
diff --git a/src/memlord/tools/workspaces.py b/src/memlord/tools/workspaces.py
index 5d9a9df..2a89a9b 100644
--- a/src/memlord/tools/workspaces.py
+++ b/src/memlord/tools/workspaces.py
@@ -16,4 +16,4 @@ async def list_workspaces(
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> list[WorkspaceInfo]:
     """List all workspaces you are a member of (personal + shared)."""
-    return await WorkspaceDao(s).list_workspaces(user_id=uid)
+    return await WorkspaceDao(s, uid).list_workspaces()
diff --git a/src/memlord/ui/base.py b/src/memlord/ui/base.py
index 4f210e7..667492d 100644
--- a/src/memlord/ui/base.py
+++ b/src/memlord/ui/base.py
@@ -48,8 +48,8 @@ async def index(
     page_size = min(page_size, 100)
     offset = (page - 1) * page_size
 
-    ws_dao = WorkspaceDao(s)
-    workspaces = await ws_dao.list_workspaces(user.id)
+    ws_dao = WorkspaceDao(s, user.id)
+    workspaces = await ws_dao.list_workspaces()
     workspace_ids = [ws.id for ws in workspaces]
 
     # Apply workspace filter
@@ -139,7 +139,7 @@ async def search(
 ) -> HTMLResponse:
     results = []
     if q:
-        workspace_ids = await WorkspaceDao(s).get_accessible_workspace_ids(user.id)
+        workspace_ids = await WorkspaceDao(s, user.id).get_accessible_workspace_ids()
         raw = await hybrid_search(
             s,
             query=q,
@@ -187,7 +187,7 @@ async def memory_detail(
     if memory is None:
         raise HTTPException(status_code=404, detail="Memory not found")
 
-    workspaces = await WorkspaceDao(s).list_workspaces(user.id)
+    workspaces = await WorkspaceDao(s, user.id).list_workspaces()
     ws_map = {ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces}
     ws_name = ws_map.get(memory.workspace_id) if memory.workspace_id else None
     writable = [
@@ -239,7 +239,7 @@ async def update_memory(
 
     await dao.update(**data)  # returns (id, name), ignore here
 
-    workspaces = await WorkspaceDao(s).list_workspaces(user.id)
+    workspaces = await WorkspaceDao(s, user.id).list_workspaces()
     ws_map = {ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces}
     ws_name = ws_map.get(existing.workspace_id) if existing.workspace_id else None
     writable = [
@@ -277,7 +277,7 @@ async def move_memory(
     user: APIUserDep,
     target_workspace_id: int = Form(...),
 ) -> HTMLResponse:
-    ws_dao = WorkspaceDao(s)
+    ws_dao = WorkspaceDao(s, user.id)
     dao = MemoryDao(s, user.id)
     try:
         await dao.move(id, target_workspace_id)
@@ -285,7 +285,7 @@ async def move_memory(
         memory = await dao.get(id)
         if memory is None:
             raise HTTPException(status_code=404, detail="Memory not found")
-        workspaces = await ws_dao.list_workspaces(user.id)
+        workspaces = await ws_dao.list_workspaces()
         ws_map = {
             ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces
         }
@@ -311,7 +311,7 @@ async def move_memory(
     memory = await dao.get(id)
     if memory is None:
         raise HTTPException(status_code=404, detail="Memory not found")
-    workspaces = await ws_dao.list_workspaces(user.id)
+    workspaces = await ws_dao.list_workspaces()
     ws_map = {ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces}
     ws_name = ws_map.get(memory.workspace_id) if memory.workspace_id else None
     writable = [
diff --git a/src/memlord/ui/data.py b/src/memlord/ui/data.py
index 9a58279..ef2dfe9 100644
--- a/src/memlord/ui/data.py
+++ b/src/memlord/ui/data.py
@@ -30,11 +30,11 @@ async def export_memories_ui(
     workspace_id: int,
     user: APIUserDep,
 ) -> Response:
-    ws_dao = WorkspaceDao(s)
-    if not await ws_dao.can_read(workspace_id, user.id):
+    ws_dao = WorkspaceDao(s, user.id)
+    if not await ws_dao.can_read(workspace_id):
         raise HTTPException(status_code=403, detail="No access to this workspace")
 
-    ws = await ws_dao.get_by_id_for_user(workspace_id, user.id)
+    ws = await ws_dao.get_by_id_for_user(workspace_id)
     assert ws is not None
 
     ts = utcnow().strftime("%Y%m%d-%H%M")
@@ -88,16 +88,16 @@ async def import_memories_ui(
     if not isinstance(items, list):
         raise HTTPException(status_code=400, detail="Expected a JSON array")
 
-    ws_dao = WorkspaceDao(s)
+    ws_dao = WorkspaceDao(s, user.id)
     ws_id: int | None = int(workspace_id) if workspace_id else None
     if ws_id is not None:
-        if not await ws_dao.can_write(ws_id, user.id):
+        if not await ws_dao.can_write(ws_id):
             raise HTTPException(
                 status_code=403, detail="No write access to this workspace"
             )
         target_ws_id = ws_id
     else:
-        personal_ws = await ws_dao.get_personal(user.id)
+        personal_ws = await ws_dao.get_personal()
         target_ws_id = personal_ws.id
 
     dao = MemoryDao(s, user.id)
diff --git a/src/memlord/ui/workspaces.py b/src/memlord/ui/workspaces.py
index 237e196..477406e 100644
--- a/src/memlord/ui/workspaces.py
+++ b/src/memlord/ui/workspaces.py
@@ -15,7 +15,7 @@ async def workspaces_list(
     s: APISessionDep,
     user: APIUserDep,
 ) -> HTMLResponse:
-    workspaces = await WorkspaceDao(s).list_workspaces(user_id=user.id)
+    workspaces = await WorkspaceDao(s, user.id).list_workspaces()
     return templates.TemplateResponse(
         request, "workspaces.html", {"user": user, "workspaces": workspaces}
     )
@@ -47,8 +47,8 @@ async def workspace_new_post(
             status_code=400,
         )
     try:
-        ws = await WorkspaceDao(s).create(
-            name=name, owner_id=user.id, description=description_val
+        ws = await WorkspaceDao(s, user.id).create(
+            name=name, description=description_val
         )
     except IntegrityError:
         return templates.TemplateResponse(
@@ -72,8 +72,8 @@ async def workspace_detail(
     s: APISessionDep,
     user: APIUserDep,
 ) -> HTMLResponse:
-    dao = WorkspaceDao(s)
-    ws = await dao.get_by_id_for_user(workspace_id, user.id)
+    dao = WorkspaceDao(s, user.id)
+    ws = await dao.get_by_id_for_user(workspace_id)
     if ws is None:
         raise HTTPException(status_code=404, detail="Workspace not found")
     members = await dao.get_members(workspace_id)
@@ -94,7 +94,7 @@ async def workspace_rename_post(
     name = name.strip()
     if not name:
         raise HTTPException(status_code=400, detail="Name is required")
-    ws = await WorkspaceDao(s).get_by_id_for_user(workspace_id, user.id)
+    ws = await WorkspaceDao(s, user.id).get_by_id_for_user(workspace_id)
     if ws is None:
         raise HTTPException(status_code=404, detail="Workspace not found")
     if ws.is_personal:
@@ -102,8 +102,8 @@ async def workspace_rename_post(
             status_code=400, detail="Cannot rename a personal workspace"
         )
     try:
-        await WorkspaceDao(s).rename(
-            workspace_id=workspace_id, owner_id=user.id, name=name
+        await WorkspaceDao(s, user.id).rename(
+            workspace_id=workspace_id, name=name
         )
     except ValueError as e:
         raise HTTPException(status_code=403, detail=str(e))
@@ -117,13 +117,12 @@ async def workspace_description_post(
     user: APIUserDep,
     description: str = Form(default=""),
 ) -> Response:
-    ws = await WorkspaceDao(s).get_by_id_for_user(workspace_id, user.id)
+    ws = await WorkspaceDao(s, user.id).get_by_id_for_user(workspace_id)
     if ws is None:
         raise HTTPException(status_code=404, detail="Workspace not found")
     try:
-        await WorkspaceDao(s).update_description(
+        await WorkspaceDao(s, user.id).update_description(
             workspace_id=workspace_id,
-            owner_id=user.id,
             description=description.strip() or None,
         )
     except ValueError as e:
@@ -139,7 +138,7 @@ async def workspace_invite(
     user: APIUserDep,
     expires_in_hours: int = Form(default=72),
 ) -> HTMLResponse:
-    ws = await WorkspaceDao(s).get_by_id_for_user(workspace_id, user.id)
+    ws = await WorkspaceDao(s, user.id).get_by_id_for_user(workspace_id)
     if ws is None:
         raise HTTPException(status_code=404, detail="Workspace not found")
     if ws.is_personal:
@@ -147,9 +146,8 @@ async def workspace_invite(
             status_code=400, detail="Cannot invite to a personal workspace"
         )
     try:
-        token = await WorkspaceDao(s).create_invite(
+        token = await WorkspaceDao(s, user.id).create_invite(
             workspace_id=workspace_id,
-            created_by=user.id,
             expires_in_hours=expires_in_hours,
         )
     except ValueError as e:
@@ -171,8 +169,8 @@ async def workspace_leave(
     s: APISessionDep,
     user: APIUserDep,
 ) -> Response:
-    dao = WorkspaceDao(s)
-    ws = await dao.get_by_id_for_user(workspace_id, user.id)
+    dao = WorkspaceDao(s, user.id)
+    ws = await dao.get_by_id_for_user(workspace_id)
     if ws is None:
         raise HTTPException(status_code=404, detail="Workspace not found")
     if ws.is_personal:
@@ -190,8 +188,8 @@ async def workspace_delete(
     s: APISessionDep,
     user: APIUserDep,
 ) -> Response:
-    dao = WorkspaceDao(s)
-    ws = await dao.get_by_id_for_user(workspace_id, user.id)
+    dao = WorkspaceDao(s, user.id)
+    ws = await dao.get_by_id_for_user(workspace_id)
     if ws is None:
         raise HTTPException(status_code=404, detail="Workspace not found")
     if ws.is_personal:
@@ -199,7 +197,7 @@ async def workspace_delete(
             status_code=400, detail="Cannot delete a personal workspace"
         )
     try:
-        await dao.delete_workspace(workspace_id=workspace_id, owner_id=user.id)
+        await dao.delete_workspace(workspace_id=workspace_id)
     except ValueError as e:
         raise HTTPException(status_code=400, detail=str(e))
     return RedirectResponse("/ui/workspaces", status_code=303)
@@ -212,7 +210,7 @@ async def join_get(
     s: APISessionDep,
     user: APIUserDep,
 ) -> HTMLResponse:
-    row = await WorkspaceDao(s).get_invite(token)
+    row = await WorkspaceDao(s, user.id).get_invite(token)
     if row is None:
         raise HTTPException(status_code=404, detail="Invalid invite token")
     return templates.TemplateResponse(
@@ -235,7 +233,7 @@ async def join_post(
     user: APIUserDep,
 ) -> Response:
     try:
-        ws = await WorkspaceDao(s).use_invite(token=token, user_id=user.id)
+        ws = await WorkspaceDao(s, user.id).use_invite(token=token)
     except ValueError as e:
         raise HTTPException(status_code=400, detail=str(e))
     return RedirectResponse(f"/ui/workspaces/{ws.id}", status_code=303)
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index 1589178..3f0d4c8 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -41,6 +41,14 @@ async def test_pipeline(mcp_client):
     assert r.data.content == "updated pipeline memory"
     assert sorted(r.data.tags) == ["pipeline", "updated"]
 
+    # --- retrieve ---
+    r = await mcp_client.call_tool(
+        "retrieve_memory",
+        {"query": "updated pipeline memory", "limit": 10},
+    )
+    names = [m.name for m in r.data]
+    assert mid in names
+
     # --- list_memories ---
     r = await mcp_client.call_tool("list_memories", {"page": 1, "page_size": 50})
     names = [m.name for m in r.data.items]

From 42d2efa75ce0f970853f86910be53c14713b2bfc Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 6 Apr 2026 14:39:02 +0200
Subject: [PATCH 05/16] fix tests

---
 tests/conftest.py  | 4 ++--
 tests/test_move.py | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index 744dc30..6a55ceb 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -9,7 +9,7 @@
 from sqlalchemy.engine.url import make_url
 from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
 
-from memlord.auth import hash_password, MCPUserDep
+from memlord.auth import MCPUserDep, hash_password
 from memlord.config import settings
 from memlord.dao.user import UserDao
 from memlord.dao.workspace import WorkspaceDao
@@ -79,7 +79,7 @@ async def user_id(session: AsyncSession) -> int:
 @pytest.fixture
 async def workspace_id(session: AsyncSession, user_id: int) -> int:
     """Return the personal workspace id for the test user."""
-    ws = await WorkspaceDao(session).get_personal(user_id)
+    ws = await WorkspaceDao(session, user_id).get_personal()
     return ws.id
 
 
diff --git a/tests/test_move.py b/tests/test_move.py
index b157beb..6a7cbda 100644
--- a/tests/test_move.py
+++ b/tests/test_move.py
@@ -9,7 +9,7 @@
 
 @pytest.fixture
 async def other_workspace_id(session, user_id: int) -> int:
-    ws = await WorkspaceDao(session).create(name="other", owner_id=user_id)
+    ws = await WorkspaceDao(session, user_id).create(name="other")
     return ws.id
 
 
@@ -48,7 +48,7 @@ async def test_move_inaccessible_workspace_raises(session, user_id, memory_id):
         display_name="Other User",
         hashed_password=hash_password("pass"),
     )
-    other_ws = await WorkspaceDao(session).get_personal(other_user.id)
+    other_ws = await WorkspaceDao(session, other_user.id).get_personal()
 
     dao = MemoryDao(session, user_id)
     with pytest.raises(PermissionError, match="No access"):

From c24e58b5bed4c43ceb0c6e120cc1f4a255b40ca1 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 6 Apr 2026 14:39:54 +0200
Subject: [PATCH 06/16] black

---
 src/memlord/ui/workspaces.py | 4 +---
 tests/test_created_at_tz.py  | 6 +++---
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/memlord/ui/workspaces.py b/src/memlord/ui/workspaces.py
index 477406e..e016315 100644
--- a/src/memlord/ui/workspaces.py
+++ b/src/memlord/ui/workspaces.py
@@ -102,9 +102,7 @@ async def workspace_rename_post(
             status_code=400, detail="Cannot rename a personal workspace"
         )
     try:
-        await WorkspaceDao(s, user.id).rename(
-            workspace_id=workspace_id, name=name
-        )
+        await WorkspaceDao(s, user.id).rename(workspace_id=workspace_id, name=name)
     except ValueError as e:
         raise HTTPException(status_code=403, detail=str(e))
     return RedirectResponse(f"/ui/workspaces/{workspace_id}", status_code=303)
diff --git a/tests/test_created_at_tz.py b/tests/test_created_at_tz.py
index 101a6bd..a054aae 100644
--- a/tests/test_created_at_tz.py
+++ b/tests/test_created_at_tz.py
@@ -6,9 +6,9 @@
 
 
 def _assert_tz_aware(created_at: datetime) -> None:
-    assert created_at.tzinfo is not None, (
-        f"created_at must be timezone-aware: {created_at!r}"
-    )
+    assert (
+        created_at.tzinfo is not None
+    ), f"created_at must be timezone-aware: {created_at!r}"
 
 
 async def test_recall_memory_created_at_has_timezone(mcp_client):

From d77bf250b1c027ab83d0f9c63d9e3c65ce401b78 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 6 Apr 2026 16:48:10 +0200
Subject: [PATCH 07/16] Add workspace disambiguation for memory operations

---
 ruff.toml                            |  61 ++++++++++
 src/memlord/dao/memory.py            | 176 ++++++++++++++-------------
 src/memlord/dao/workspace.py         |  66 ++++------
 src/memlord/schemas/list_memories.py |   2 +-
 src/memlord/search.py                |  24 +---
 src/memlord/tools/delete.py          |  16 ++-
 src/memlord/tools/get_memory.py      |  18 ++-
 src/memlord/tools/list_memories.py   |  11 +-
 src/memlord/tools/move.py            |  25 ++--
 src/memlord/tools/recall.py          |   6 +-
 src/memlord/tools/retrieve.py        |   2 +-
 src/memlord/tools/search_by_tag.py   |  16 +--
 src/memlord/tools/store.py           |   7 +-
 src/memlord/tools/update.py          |  16 ++-
 src/memlord/ui/base.py               |  83 +++++--------
 src/memlord/ui/data.py               |   8 +-
 src/memlord/ui/workspaces.py         |  20 +--
 tests/test_created_at_tz.py          |   9 +-
 tests/test_dao.py                    |   8 +-
 tests/test_move.py                   |  18 +--
 20 files changed, 301 insertions(+), 291 deletions(-)
 create mode 100644 ruff.toml

diff --git a/ruff.toml b/ruff.toml
new file mode 100644
index 0000000..48ab935
--- /dev/null
+++ b/ruff.toml
@@ -0,0 +1,61 @@
+# Exclude a variety of commonly ignored directories.
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".hg",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "venv",
+    "migrations/versions",
+]
+
+# Same as Black.
+line-length = 100
+
+# Assume Python 3.12
+target-version = "py312"
+
+[lint]
+select = [
+    "E", # pycodestyle errors
+    "W", # pycodestyle warnings
+    "F", # pyflakes
+    # "I",  # isort
+    "C", # flake8-comprehensions
+    "B", # flake8-bugbear
+]
+ignore = [
+    "B008", # do not perform function calls in argument defaults
+    "C901", # complexity
+    "F403", # import * used in __init__.py
+    "E501", # line too long - covered by black
+    "F401", # unused import - we provide package, not module
+    "E741", # ambiguous variable name
+]
+
+# Allow autofix for all enabled rules (when `--fix`) is provided.
+fixable = ["A", "B", "C", "D", "E", "F"]
+unfixable = []
+
+# Allow unused variables when underscore-prefixed.
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[lint.mccabe]
+# Unlike Flake8, default to a complexity level of 10.
+max-complexity = 10
+
+[lint.isort]
+known-third-party = ["fastapi", "pydantic", "starlette"]
diff --git a/src/memlord/dao/memory.py b/src/memlord/dao/memory.py
index a9a46eb..f14524b 100644
--- a/src/memlord/dao/memory.py
+++ b/src/memlord/dao/memory.py
@@ -1,7 +1,7 @@
 from datetime import datetime
 
 from pgvector.sqlalchemy import Vector
-from sqlalchemy import bindparam, delete, Float, insert, select, update
+from sqlalchemy import Float, bindparam, delete, insert, select, update
 from sqlalchemy.dialects.postgresql import insert as pg_insert
 from sqlalchemy.ext.asyncio import AsyncSession
 
@@ -10,6 +10,7 @@
 from memlord.embeddings import embed
 from memlord.models import Memory, MemoryTag, Tag
 from memlord.schemas import MemoryListItem, MemoryType
+import sqlalchemy as sa
 
 _UNSET = object()
 
@@ -29,9 +30,7 @@ async def _upsert_tags(self, memory_id: int, tags: set[str]) -> None:
             normalized = tag_name.lower().strip()
             if not normalized:
                 continue
-            await self._s.execute(
-                pg_insert(Tag).values(name=normalized).on_conflict_do_nothing()
-            )
+            await self._s.execute(pg_insert(Tag).values(name=normalized).on_conflict_do_nothing())
             tag_id = await self._s.scalar(select(Tag.id).where(Tag.name == normalized))
             await self._s.execute(
                 pg_insert(MemoryTag)
@@ -39,13 +38,13 @@ async def _upsert_tags(self, memory_id: int, tags: set[str]) -> None:
                 .on_conflict_do_nothing()
             )
 
-    async def _fetch_tag_names(self, memory_id: int) -> list[str]:
+    async def _fetch_tag_names(self, memory_id: int) -> set[str]:
         rows = await self._s.execute(
             select(Tag.name)
             .join(MemoryTag, MemoryTag.tag_id == Tag.id)
             .where(MemoryTag.memory_id == memory_id)
         )
-        return [row[0] for row in rows.fetchall()]
+        return {row[0] for row in rows.fetchall()}
 
     async def _cleanup_orphan_tags(self) -> None:
         await self._s.execute(delete(Tag).where(~Tag.id.in_(select(MemoryTag.tag_id))))
@@ -55,9 +54,7 @@ async def _replace_tags(self, memory_id: int, tags: set[str]) -> None:
         await self._upsert_tags(memory_id, tags)
         await self._cleanup_orphan_tags()
 
-    async def _check_near_duplicate(
-        self, vector: list[float], workspace_id: int
-    ) -> None:
+    async def _check_near_duplicate(self, vector: list[float], workspace_id: int) -> None:
         """Raise ValueError if a near-duplicate exists in the workspace."""
         vec_param = bindparam("vec", type_=Vector(384))
         distance_expr = Memory.embedding.op("<=>", return_type=Float)(vec_param)
@@ -86,12 +83,13 @@ async def _check_near_duplicate(
                 f"Review with get_memory({dup_row['id']}). Pass force=True to store anyway."
             )
 
-    async def get_id_by_name(self, name: str) -> int | None:
-        workspace_ids = await self._accessible_workspace_ids()
+    async def get_id_by_name(self, name: str, workspace_id: int | None = None) -> int | None:
+        if workspace_id is None:
+            workspace_id = await self._personal_workspace_id()
         return await self._s.scalar(
             select(Memory.id).where(
                 Memory.name == name,
-                Memory.workspace_id.in_(workspace_ids),
+                Memory.workspace_id == workspace_id,
             )
         )
 
@@ -99,8 +97,8 @@ async def _personal_workspace_id(self) -> int:
         ws = await self._ws_dao.get_personal()
         return ws.id
 
-    async def _accessible_workspace_ids(self) -> list[int]:
-        return await self._ws_dao.get_accessible_workspace_ids()
+    async def _accessible_workspace_ids(self, write: bool = False) -> list[int]:
+        return await self._ws_dao.get_accessible_workspace_ids(write=write)
 
     async def create(
         self,
@@ -150,7 +148,7 @@ async def create(
     async def update(
         self,
         id: int,
-        workspace_ids: list[int] | None = None,
+        workspace_id: int | None = None,
         content: str = _UNSET,  # type: ignore[assignment]
         memory_type: MemoryType = _UNSET,  # type: ignore[assignment]
         metadata: dict = _UNSET,  # type: ignore[assignment]
@@ -158,12 +156,17 @@ async def update(
         name: str | None = _UNSET,  # type: ignore[assignment]
     ) -> tuple[int, str | None]:
         """Update memory fields. Pass _UNSET to leave a field unchanged; None sets it to NULL."""
-        if workspace_ids is None:
-            workspace_ids = await self._accessible_workspace_ids()
-        access_check = Memory.workspace_id.in_(workspace_ids)
+        if workspace_id is None:
+            workspace_id = await self._personal_workspace_id()
+        else:
+            if not await self._ws_dao.can_write(workspace_id):
+                raise ValueError(f"No write access to workspace {workspace_id}")
 
         memory_id = await self._s.scalar(
-            select(Memory.id).where(Memory.id == id, access_check)
+            select(Memory.id).where(
+                Memory.id == id,
+                Memory.workspace_id == workspace_id,
+            )
         )
         if memory_id is None:
             raise ValueError(f"Memory with id={id} not found")
@@ -181,25 +184,16 @@ async def update(
                 content
                 if content is not _UNSET
                 else (
-                    await self._s.scalar(
-                        select(Memory.content).where(Memory.id == memory_id)
-                    )
-                    or ""
+                    await self._s.scalar(select(Memory.content).where(Memory.id == memory_id)) or ""
                 )
             )
-            new_tags = (
-                list(tags)
-                if tags is not _UNSET
-                else await self._fetch_tag_names(memory_id)
-            )
+            new_tags = set(tags) if tags is not _UNSET else await self._fetch_tag_names(memory_id)
             if content is not _UNSET:
                 values["content"] = content
             values["embedding"] = await embed(_embed_text(new_content, new_tags))
 
         if values:
-            await self._s.execute(
-                update(Memory).where(Memory.id == memory_id).values(**values)
-            )
+            await self._s.execute(update(Memory).where(Memory.id == memory_id).values(**values))
 
         if tags is not _UNSET:
             await self._replace_tags(memory_id, tags)  # type: ignore[arg-type]
@@ -211,13 +205,21 @@ async def update(
         )
         return memory_id, final_name
 
-    async def delete(self, id: int, workspace_ids: list[int] | None = None) -> None:
-        if workspace_ids is None:
-            workspace_ids = await self._accessible_workspace_ids()
-        access_check = Memory.workspace_id.in_(workspace_ids)
+    async def delete(self, id: int, workspace_id: int | None = None) -> None:
+        if workspace_id is None:
+            workspace_id = await self._personal_workspace_id()
+        else:
+            if not await self._ws_dao.can_write(workspace_id):
+                raise ValueError(f"No write access to workspace {workspace_id}")
+        workspace_ids = [workspace_id]
 
         result = await self._s.scalar(
-            delete(Memory).where(Memory.id == id, access_check).returning(Memory.id)
+            delete(Memory)
+            .where(
+                Memory.id == id,
+                Memory.workspace_id.in_(workspace_ids),
+            )
+            .returning(Memory.id)
         )
         if result is None:
             raise ValueError(f"Memory with id={id} not found")
@@ -225,75 +227,75 @@ async def delete(self, id: int, workspace_ids: list[int] | None = None) -> None:
 
     async def get(
         self,
+        *,
         id: int | None = None,
         name: str | None = None,
-        workspace_ids: list[int] | None = None,
+        workspace_id: int | None = None,
     ) -> MemoryListItem | None:
         if id is None and name is None:
             raise ValueError("Either id or name must be provided")
-        if workspace_ids is None:
-            workspace_ids = await self._accessible_workspace_ids()
-        access_check = Memory.workspace_id.in_(workspace_ids)
-
-        id_filter = Memory.id == id if id is not None else Memory.name == name
-        row = (
-            (
-                await self._s.execute(
-                    select(
-                        Memory.id,
-                        Memory.name,
-                        Memory.content,
-                        Memory.memory_type,
-                        Memory.extra_data.label("metadata"),
-                        Memory.created_at,
-                        Memory.workspace_id,
-                    ).where(id_filter, access_check)
-                )
-            )
-            .mappings()
-            .one_or_none()
+        if workspace_id is None:
+            workspace_id = await self._personal_workspace_id()
+        else:
+            if not await self._ws_dao.can_read(workspace_id):
+                raise ValueError(f"No read access to workspace {workspace_id}")
+
+        q = select(
+            Memory.id,
+            Memory.name,
+            Memory.content,
+            Memory.memory_type,
+            Memory.extra_data.label("metadata"),
+            Memory.created_at,
+            Memory.workspace_id,
+        ).where(
+            Memory.workspace_id == workspace_id,
         )
+        if id is not None:
+            q = q.where(Memory.id == id)
+        if name is not None:
+            q = q.where(Memory.name == name)
+
+        row = (await self._s.execute(q)).mappings().one_or_none()
         if row is None:
             return None
         memory_id: int = row["id"]
         tags = (await self.fetch_tags([memory_id])).get(memory_id, [])
-        return MemoryListItem(**row, tags=tags)  # extra "id" silently ignored
+        return MemoryListItem(**row, tags=tags)
 
-    async def move(self, id: int, target_workspace_id: int) -> None:
+    async def move(self, id: int, from_workspace_id: int, to_workspace_id: int) -> None:
         """Move memory to a different workspace. Raises ValueError if not found or duplicate."""
-        workspace_ids = await self._accessible_workspace_ids()
-        row = (
-            (
-                await self._s.execute(
-                    select(Memory.id, Memory.content).where(
-                        Memory.id == id, Memory.workspace_id.in_(workspace_ids)
-                    )
-                )
-            )
-            .mappings()
-            .one_or_none()
+        workspace_ids = await self._accessible_workspace_ids(write=True)
+        if to_workspace_id not in workspace_ids:
+            raise PermissionError(f"No access to workspace {to_workspace_id}")
+        if from_workspace_id not in workspace_ids:
+            raise PermissionError(f"No access to workspace {from_workspace_id}")
+
+        q = select(Memory.id, Memory.name, Memory.content).where(
+            Memory.id == id, Memory.workspace_id == from_workspace_id
         )
+
+        row = (await self._s.execute(q)).mappings().one_or_none()
         if row is None:
             raise ValueError(f"Memory with id={id} not found")
-        if target_workspace_id not in workspace_ids:
-            raise PermissionError(
-                f"No access to target workspace {target_workspace_id}"
-            )
+
         duplicate = await self._s.scalar(
             select(Memory.id).where(
-                Memory.content == row["content"],
-                Memory.workspace_id == target_workspace_id,
+                sa.or_(
+                    Memory.content == row["content"],
+                    Memory.name == row["name"],
+                ),
+                Memory.workspace_id == to_workspace_id,
                 Memory.id != id,
             )
         )
         if duplicate is not None:
             raise ValueError(
-                "A memory with the same content already exists in the target workspace"
+                "A memory with the same content or name already exists in the target workspace"
             )
+
         await self._s.execute(
-            update(Memory)
-            .where(Memory.id == id)
-            .values(workspace_id=target_workspace_id)
+            update(Memory).where(Memory.id == id).values(workspace_id=to_workspace_id)
         )
 
     async def fetch_tags(self, memory_ids: list[int]) -> dict[int, set[str]]:
@@ -307,12 +309,12 @@ async def fetch_tags(self, memory_ids: list[int]) -> dict[int, set[str]]:
             result[mid].add(name)
         return result
 
-    async def fetch_metadata(
-        self, memory_ids: list[int]
-    ) -> dict[int, tuple[dict, datetime]]:
+    async def fetch_metadata(self, memory_ids: list[int]) -> dict[int, tuple[dict, datetime]]:
         rows = await self._s.execute(
-            select(Memory.id, Memory.extra_data, Memory.created_at).where(
-                Memory.id.in_(memory_ids)
-            )
+            select(
+                Memory.id,
+                Memory.extra_data,
+                Memory.created_at,
+            ).where(Memory.id.in_(memory_ids))
         )
         return {row.id: (row.extra_data, row.created_at) for row in rows.fetchall()}
diff --git a/src/memlord/dao/workspace.py b/src/memlord/dao/workspace.py
index 98d9bf3..3d8a987 100644
--- a/src/memlord/dao/workspace.py
+++ b/src/memlord/dao/workspace.py
@@ -127,9 +127,7 @@ async def add_member(
         role: WorkspaceRole = WorkspaceRole.member,
     ) -> None:
         await self._s.execute(
-            insert(WorkspaceMember).values(
-                workspace_id=workspace_id, user_id=user_id, role=role
-            )
+            insert(WorkspaceMember).values(workspace_id=workspace_id, user_id=user_id, role=role)
         )
 
     async def remove_member(self, workspace_id: int, user_id: int) -> None:
@@ -137,9 +135,7 @@ async def remove_member(self, workspace_id: int, user_id: int) -> None:
         if role is None:
             raise ValueError(f"Not a member of workspace {workspace_id}")
         if role == WorkspaceRole.owner:
-            raise ValueError(
-                "Owners cannot leave a workspace. Delete the workspace instead."
-            )
+            raise ValueError("Owners cannot leave a workspace. Delete the workspace instead.")
         await self._s.execute(
             delete(WorkspaceMember).where(
                 WorkspaceMember.workspace_id == workspace_id,
@@ -153,12 +149,11 @@ async def delete_workspace(self, workspace_id: int) -> None:
             raise ValueError("Only the owner can delete a workspace")
         await self._s.execute(delete(Workspace).where(Workspace.id == workspace_id))
 
-    async def get_accessible_workspace_ids(self) -> list[int]:
-        rows = await self._s.scalars(
-            select(WorkspaceMember.workspace_id).where(
-                WorkspaceMember.user_id == self._uid
-            )
-        )
+    async def get_accessible_workspace_ids(self, write: bool = False) -> list[int]:
+        q = select(WorkspaceMember.workspace_id).where(WorkspaceMember.user_id == self._uid)
+        if write:
+            q = q.where(WorkspaceMember.role.in_([WorkspaceRole.owner, WorkspaceRole.editor]))
+        rows = await self._s.scalars(q)
         return list(rows)
 
     async def list_workspaces(self) -> list[WorkspaceInfo]:
@@ -207,34 +202,25 @@ async def get_by_name(self, name: str) -> WorkspaceInfo | None:
             .correlate(Workspace)
             .scalar_subquery()
         )
-        row = (
-            (
-                await self._s.execute(
-                    select(
-                        Workspace.id,
-                        Workspace.name,
-                        Workspace.description,
-                        Workspace.is_personal,
-                        WorkspaceMember.role,
-                        member_count_subq.label("member_count"),
-                    )
-                    .join(WorkspaceMember, WorkspaceMember.workspace_id == Workspace.id)
-                    .where(Workspace.name == name, WorkspaceMember.user_id == self._uid)
-                )
+        q = (
+            select(
+                Workspace.id,
+                Workspace.name,
+                Workspace.description,
+                Workspace.is_personal,
+                WorkspaceMember.role,
+                member_count_subq.label("member_count"),
+            )
+            .join(WorkspaceMember, WorkspaceMember.workspace_id == Workspace.id)
+            .where(
+                Workspace.name == name,
+                WorkspaceMember.user_id == self._uid,
             )
-            .mappings()
-            .one_or_none()
         )
+        row = (await self._s.execute(q)).mappings().one_or_none()
         if row is None:
             return None
-        return WorkspaceInfo(
-            id=row["id"],
-            name=row["name"],
-            description=row["description"],
-            role=row["role"],
-            member_count=row["member_count"],
-            is_personal=row["is_personal"],
-        )
+        return WorkspaceInfo(**row)
 
     async def get_by_id_for_user(self, workspace_id: int) -> WorkspaceInfo | None:
         member_count_subq = (
@@ -282,16 +268,12 @@ async def rename(self, workspace_id: int, name: str) -> None:
             update(Workspace).where(Workspace.id == workspace_id).values(name=name)
         )
 
-    async def update_description(
-        self, workspace_id: int, description: str | None
-    ) -> None:
+    async def update_description(self, workspace_id: int, description: str | None) -> None:
         role = await self.get_role(workspace_id, self._uid)
         if role != WorkspaceRole.owner:
             raise ValueError("Only the owner can update the workspace description")
         await self._s.execute(
-            update(Workspace)
-            .where(Workspace.id == workspace_id)
-            .values(description=description)
+            update(Workspace).where(Workspace.id == workspace_id).values(description=description)
         )
 
     async def get_members(self, workspace_id: int) -> list[WorkspaceMemberInfo]:
diff --git a/src/memlord/schemas/list_memories.py b/src/memlord/schemas/list_memories.py
index ba57a22..7005d86 100644
--- a/src/memlord/schemas/list_memories.py
+++ b/src/memlord/schemas/list_memories.py
@@ -15,7 +15,7 @@ class MemoryListItem(BaseModel):
     metadata: dict = Field(default_factory=dict)
     tags: set[str]
     created_at: NaiveDatetime
-    workspace_id: int | None = None
+    workspace_id: int
 
     @field_serializer("created_at")
     def serialize_created_at(self, v: datetime) -> str:
diff --git a/src/memlord/search.py b/src/memlord/search.py
index 0c7bdf9..eede5ab 100644
--- a/src/memlord/search.py
+++ b/src/memlord/search.py
@@ -23,11 +23,7 @@ async def hybrid_search(
 ) -> list[SearchResult]:
     n = (limit or settings.default_limit) * 4
     k = settings.rrf_k
-    threshold = (
-        similarity_threshold
-        if similarity_threshold is not None
-        else settings.sim_threshold
-    )
+    threshold = similarity_threshold or settings.sim_threshold
 
     # Build access filter: all workspaces the user is a member of
     access = Memory.workspace_id.in_(workspace_ids or [])
@@ -77,9 +73,7 @@ async def hybrid_search(
     # Vector KNN via pgvector cosine distance
     vector = await embed(query)
     vec_param = bindparam("vec", type_=Vector(384))
-    distance = Memory.embedding.op("<=>", return_type=Float)(vec_param).label(
-        "distance"
-    )
+    distance = Memory.embedding.op("<=>", return_type=Float)(vec_param).label("distance")
     vec_rank = func.row_number().over(order_by=distance).label("vec_rank")
 
     vec_q = (
@@ -104,12 +98,8 @@ async def hybrid_search(
     vec_ranks: dict[int, int] = {row.id: row.vec_rank for row in vec_rows}
     vec_distances: dict[int, float] = {row.id: row.distance for row in vec_rows}
     contents: dict[int, tuple[str, str, MemoryType, str]] = {
-        row.id: (row.name, row.content, row.memory_type, row.workspace)
-        for row in bm25_rows
-    } | {
-        row.id: (row.name, row.content, row.memory_type, row.workspace)
-        for row in vec_rows
-    }
+        row.id: (row.name, row.content, row.memory_type, row.workspace) for row in bm25_rows
+    } | {row.id: (row.name, row.content, row.memory_type, row.workspace) for row in vec_rows}
 
     # RRF fusion
     all_ids = set(bm25_ranks) | set(vec_ranks)
@@ -127,11 +117,7 @@ async def hybrid_search(
 
         # BM25 hits (content or tag match) are always included; threshold only
         # filters pure vec matches that lack any text/tag signal.
-        if (
-            doc_id not in bm25_ranks
-            and similarity is not None
-            and similarity < threshold
-        ):
+        if doc_id not in bm25_ranks and similarity is not None and similarity < threshold:
             continue
 
         name, content, memory_type, workspace = contents[doc_id]
diff --git a/src/memlord/tools/delete.py b/src/memlord/tools/delete.py
index 9535b65..09f79ec 100644
--- a/src/memlord/tools/delete.py
+++ b/src/memlord/tools/delete.py
@@ -4,6 +4,7 @@
 
 from memlord.auth import MCPUserDep
 from memlord.dao import MemoryDao
+from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
 from memlord.schemas import DeleteResult
 
@@ -16,13 +17,20 @@
 )
 async def delete_memory(
     name: str,
+    workspace: str | None = None,
     s: AsyncSession = MCPSessionDep,  # type: ignore[assignment]
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> DeleteResult:
-    """Delete a memory by name."""
+    """Delete a memory by name. Pass workspace to disambiguate if the name exists in multiple workspaces."""
+    ws_id: int | None = None
+    if workspace is not None:
+        ws = await WorkspaceDao(s, uid).get_by_name(workspace)
+        if ws is None:
+            raise ValueError(f"Workspace {workspace!r} not found")
+        ws_id = ws.id
     dao = MemoryDao(s, uid)
-    memory_id = await dao.get_id_by_name(name)
-    if memory_id is None:
+    item = await dao.get(name=name, workspace_id=ws_id)
+    if item is None:
         raise ValueError(f"Memory with name={name!r} not found")
-    await dao.delete(memory_id)
+    await dao.delete(item.id, item.workspace_id)
     return DeleteResult(success=True, name=name)
diff --git a/src/memlord/tools/get_memory.py b/src/memlord/tools/get_memory.py
index 71724ea..2af134f 100644
--- a/src/memlord/tools/get_memory.py
+++ b/src/memlord/tools/get_memory.py
@@ -14,18 +14,24 @@
 @mcp.tool(annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False))
 async def get_memory(
     name: str,
+    workspace: str | None = None,
     s: AsyncSession = MCPSessionDep,  # type: ignore[assignment]
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> MemoryDetail:
-    """Fetch full content of a memory by name."""
-    item = await MemoryDao(s, uid).get(name=name)
+    """Fetch full content of a memory by name. Pass workspace to disambiguate if the name exists in multiple workspaces."""
+    ws_dao = WorkspaceDao(s, uid)
+    ws_id: int | None = None
+    if workspace is not None:
+        ws = await ws_dao.get_by_name(workspace)
+        if ws is None:
+            raise ValueError(f"Workspace {workspace!r} not found")
+        ws_id = ws.id
+    item = await MemoryDao(s, uid).get(name=name, workspace_id=ws_id)
     if item is None:
         raise ValueError(f"Memory with name={name!r} not found")
 
-    ws_name: str | None = None
-    if item.workspace_id is not None:
-        names = await WorkspaceDao(s, uid).get_names_by_ids({item.workspace_id})
-        ws_name = names.get(item.workspace_id)
+    names = await ws_dao.get_names_by_ids({item.workspace_id})
+    ws_name = names.get(item.workspace_id)
 
     return MemoryDetail(
         name=item.name,
diff --git a/src/memlord/tools/list_memories.py b/src/memlord/tools/list_memories.py
index 265eacc..a3a270f 100644
--- a/src/memlord/tools/list_memories.py
+++ b/src/memlord/tools/list_memories.py
@@ -61,16 +61,9 @@ async def list_memories(
         q = q.where(Memory.id.in_(tag_subq))
 
     total = await s.scalar(select(func.count()).select_from(q.subquery())) or 0
+    q = q.order_by(Memory.created_at.desc()).limit(page_size).offset(offset)
 
-    rows = (
-        (
-            await s.execute(
-                q.order_by(Memory.created_at.desc()).limit(page_size).offset(offset)
-            )
-        )
-        .mappings()
-        .all()
-    )
+    rows = (await s.execute(q)).mappings().all()
 
     total_pages = math.ceil(total / page_size) if total else 0
 
diff --git a/src/memlord/tools/move.py b/src/memlord/tools/move.py
index a106279..438b4ce 100644
--- a/src/memlord/tools/move.py
+++ b/src/memlord/tools/move.py
@@ -17,26 +17,33 @@
 )
 async def move_memory(
     name: str,
-    workspace: str,
+    to_workspace: str,
+    from_workspace: str | None = None,
     s: AsyncSession = MCPSessionDep,  # type: ignore[assignment]
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> StoreResult:
-    """Move a memory to a different workspace.
+    """Move a memory to a different to_workspace.
 
     name: name of the memory to move.
     workspace: name of the target workspace (must be a member with write access).
+    from_workspace: disambiguate source if the name exists in multiple workspaces.
     """
+    ws_dao = WorkspaceDao(s, uid)
+    from_ws_id: int | None = None
+    if from_workspace is not None:
+        from_ws = await ws_dao.get_by_name(from_workspace)
+        if from_ws is None:
+            raise ValueError(f"Workspace {from_workspace!r} not found")
+        from_ws_id = from_ws.id
+
     dao = MemoryDao(s, uid)
-    memory_id = await dao.get_id_by_name(name)
+    memory_id = await dao.get_id_by_name(name, workspace_id=from_ws_id)
     if memory_id is None:
         raise ValueError(f"Memory with name={name!r} not found")
 
-    ws = await WorkspaceDao(s, uid).get_by_name(workspace)
+    ws = await ws_dao.get_by_name(to_workspace)
     if ws is None:
-        raise ValueError(
-            f"Workspace '{workspace}' not found or you are not a member. "
-            "Use list_workspaces() to see available workspaces."
-        )
+        raise ValueError(f"Workspace {to_workspace!r} not found")
 
-    await dao.move(memory_id, ws.id)
+    await dao.move(memory_id, from_ws_id, ws.id)
     return StoreResult(name=name, created=False)
diff --git a/src/memlord/tools/recall.py b/src/memlord/tools/recall.py
index f80ed7d..34712e9 100644
--- a/src/memlord/tools/recall.py
+++ b/src/memlord/tools/recall.py
@@ -59,7 +59,7 @@ async def recall_memory(
     if workspace is not None:
         ws = await ws_dao.get_by_name(workspace)
         if ws is None:
-            raise ValueError(f"Workspace {workspace!r} not found or not accessible")
+            raise ValueError(f"Workspace {workspace!r} not found")
         workspace_ids = [ws.id]
     else:
         workspace_ids = await ws_dao.get_accessible_workspace_ids()
@@ -80,9 +80,7 @@ async def recall_memory(
     ids = [r.id for r in results]
     tags_map = await MemoryDao(s, uid).fetch_tags(ids)
 
-    rows = await s.execute(
-        select(Memory.id, Memory.created_at).where(Memory.id.in_(ids))
-    )
+    rows = await s.execute(select(Memory.id, Memory.created_at).where(Memory.id.in_(ids)))
     created_map = {row.id: row.created_at for row in rows.fetchall()}
 
     return RecallPage(
diff --git a/src/memlord/tools/retrieve.py b/src/memlord/tools/retrieve.py
index c860be6..4af6ca9 100644
--- a/src/memlord/tools/retrieve.py
+++ b/src/memlord/tools/retrieve.py
@@ -33,7 +33,7 @@ async def retrieve_memory(
     if workspace is not None:
         ws = await ws_dao.get_by_name(workspace)
         if ws is None:
-            raise ValueError(f"Workspace {workspace!r} not found or not accessible")
+            raise ValueError(f"Workspace {workspace!r} not found")
         workspace_ids = [ws.id]
     else:
         workspace_ids = await ws_dao.get_accessible_workspace_ids()
diff --git a/src/memlord/tools/search_by_tag.py b/src/memlord/tools/search_by_tag.py
index 771ac6f..7246300 100644
--- a/src/memlord/tools/search_by_tag.py
+++ b/src/memlord/tools/search_by_tag.py
@@ -22,7 +22,7 @@
     Memory.memory_type,
     Memory.extra_data.label("metadata"),
     Memory.created_at,
-    Workspace.name.label("workspace"),
+    Workspace.name.label("to_workspace"),
 )
 
 
@@ -37,15 +37,11 @@ async def search_by_tag(
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> MemoryPage:
     """Search memories by tags. AND: all tags present. OR: any tag present."""
-    if not tags:
-        return MemoryPage()
-
     normalized = [t.lower().strip() for t in tags if t.strip()]
     if not normalized:
         return MemoryPage()
 
     workspace_ids = await WorkspaceDao(s, uid).get_accessible_workspace_ids()
-    access_filter = Memory.workspace_id.in_(workspace_ids)
 
     if operation == "AND":
         matching_count = (
@@ -59,7 +55,10 @@ async def search_by_tag(
         stmt = (
             select(*_COLS)
             .join(Workspace, Memory.workspace_id == Workspace.id)
-            .where(matching_count == len(normalized), access_filter)
+            .where(
+                matching_count == len(normalized),
+                Memory.workspace_id.in_(workspace_ids),
+            )
             .order_by(Memory.created_at.desc())
         )
     else:
@@ -68,7 +67,10 @@ async def search_by_tag(
             .join(MemoryTag, Memory.id == MemoryTag.memory_id)
             .join(Tag, MemoryTag.tag_id == Tag.id)
             .join(Workspace, Memory.workspace_id == Workspace.id)
-            .where(Tag.name.in_(normalized), access_filter)
+            .where(
+                Tag.name.in_(normalized),
+                Memory.workspace_id.in_(workspace_ids),
+            )
             .distinct()
             .order_by(Memory.created_at.desc())
         )
diff --git a/src/memlord/tools/store.py b/src/memlord/tools/store.py
index 658051a..f111aee 100644
--- a/src/memlord/tools/store.py
+++ b/src/memlord/tools/store.py
@@ -18,7 +18,7 @@
 async def store_memory(
     content: str,
     memory_type: MemoryType,
-    name: str | None = None,
+    name: str,
     tags: set[str] | None = None,
     metadata: dict | None = None,
     workspace: str | None = None,
@@ -28,9 +28,8 @@ async def store_memory(
 ) -> StoreResult:
     """Save a new memory. Idempotent: returns existing if content already stored.
 
-    name: optional human-readable name, unique within the workspace.
-    workspace: name of the workspace to store into (must be a member).
-               Omit or pass None to store as a personal memory.
+    name: human-readable name, unique within the workspace.
+    workspace: name of the workspace to store into. Omit to store as a personal memory.
     force: skip near-duplicate check and store unconditionally.
     """
     ws_dao = WorkspaceDao(s, uid)
diff --git a/src/memlord/tools/update.py b/src/memlord/tools/update.py
index 810ee23..11835d7 100644
--- a/src/memlord/tools/update.py
+++ b/src/memlord/tools/update.py
@@ -6,6 +6,7 @@
 
 from memlord.auth import MCPUserDep
 from memlord.dao import MemoryDao
+from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
 from memlord.schemas import MemoryType, StoreResult
 
@@ -23,20 +24,29 @@ async def update_memory(
     new_name: str | None = None,
     tags: set[str] | None = None,
     metadata: dict | None = None,
+    workspace: str | None = None,
     s: AsyncSession = MCPSessionDep,  # type: ignore[assignment]
     uid: int = MCPUserDep,  # type: ignore[assignment]
 ) -> StoreResult:
     """Update an existing memory identified by name. Only provided fields are changed.
 
     new_name: rename the memory to this name.
+    workspace: disambiguate if the name exists in multiple workspaces.
     """
+    ws_id: int | None = None
+    if workspace is not None:
+        ws = await WorkspaceDao(s, uid).get_by_name(workspace)
+        if ws is None:
+            raise ValueError(f"Workspace {workspace!r} not found")
+        ws_id = ws.id
     dao = MemoryDao(s, uid)
-    memory_id = await dao.get_id_by_name(name)
-    if memory_id is None:
+    item = await dao.get(name=name, workspace_id=ws_id)
+    if item is None:
         raise ValueError(f"Memory with name={name!r} not found")
 
     data: dict[str, Any] = {
-        "id": memory_id,
+        "id": item.id,
+        "workspace_id": item.workspace_id,
         "memory_type": MemoryType(memory_type),
     }
 
diff --git a/src/memlord/ui/base.py b/src/memlord/ui/base.py
index 667492d..6b37105 100644
--- a/src/memlord/ui/base.py
+++ b/src/memlord/ui/base.py
@@ -52,13 +52,11 @@ async def index(
     workspaces = await ws_dao.list_workspaces()
     workspace_ids = [ws.id for ws in workspaces]
 
-    # Apply workspace filter
+    # Apply to_workspace filter
     if workspace == "__personal__":
         personal = next((ws for ws in workspaces if ws.is_personal), None)
         access_filter = (
-            Memory.workspace_id == personal.id
-            if personal
-            else Memory.workspace_id.in_([])
+            Memory.workspace_id == personal.id if personal else Memory.workspace_id.in_([])
         )
     elif workspace:
         ws_obj = next((ws for ws in workspaces if ws.name == workspace), None)
@@ -84,11 +82,7 @@ async def index(
 
     total = await s.scalar(select(sa.func.count()).select_from(q.subquery())) or 0
     rows = (
-        (
-            await s.execute(
-                q.order_by(Memory.created_at.desc()).limit(page_size).offset(offset)
-            )
-        )
+        (await s.execute(q.order_by(Memory.created_at.desc()).limit(page_size).offset(offset)))
         .mappings()
         .all()
     )
@@ -96,9 +90,7 @@ async def index(
     ids = [row["id"] for row in rows]
     tags_map = await MemoryDao(s, user.id).fetch_tags(ids)
 
-    ws_display = {
-        ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces
-    }
+    ws_display = {ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces}
 
     memories = [
         {
@@ -123,7 +115,7 @@ async def index(
             "total_pages": total_pages,
             "memory_type": memory_type,
             "tag": tag,
-            "workspace": workspace,
+            "to_workspace": workspace,
             "workspaces": workspaces,
         },
     )
@@ -154,9 +146,7 @@ async def search(
             created_map = {
                 row.id: row.created_at
                 for row in (
-                    await s.execute(
-                        select(Memory.id, Memory.created_at).where(Memory.id.in_(ids))
-                    )
+                    await s.execute(select(Memory.id, Memory.created_at).where(Memory.id.in_(ids)))
                 ).all()
             }
             for r in raw:
@@ -191,9 +181,7 @@ async def memory_detail(
     ws_map = {ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces}
     ws_name = ws_map.get(memory.workspace_id) if memory.workspace_id else None
     writable = [
-        ws
-        for ws in workspaces
-        if ws.role in ("owner", "editor") and ws.id != memory.workspace_id
+        ws for ws in workspaces if ws.role in ("owner", "editor") and ws.id != memory.workspace_id
     ]
 
     return templates.TemplateResponse(
@@ -229,6 +217,7 @@ async def update_memory(
 
     data: dict = {
         "id": id,
+        "workspace_id": existing.workspace_id,
         "memory_type": new_type,
         "metadata": body.metadata,
         "tags": new_tags,
@@ -243,9 +232,7 @@ async def update_memory(
     ws_map = {ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces}
     ws_name = ws_map.get(existing.workspace_id) if existing.workspace_id else None
     writable = [
-        ws
-        for ws in workspaces
-        if ws.role in ("owner", "editor") and ws.id != existing.workspace_id
+        ws for ws in workspaces if ws.role in ("owner", "editor") and ws.id != existing.workspace_id
     ]
 
     return templates.TemplateResponse(
@@ -275,26 +262,25 @@ async def move_memory(
     id: int,
     s: APISessionDep,
     user: APIUserDep,
-    target_workspace_id: int = Form(...),
+    to_workspace_id: int = Form(...),
 ) -> HTMLResponse:
     ws_dao = WorkspaceDao(s, user.id)
     dao = MemoryDao(s, user.id)
+    memory = await dao.get(id)
+
+    if memory is None:
+        raise HTTPException(status_code=404, detail="Memory not found")
+
+    workspaces = await ws_dao.list_workspaces()
+    ws_map = {ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces}
+    ws_name = ws_map.get(memory.workspace_id) if memory.workspace_id else None
+    writable = [
+        ws for ws in workspaces if ws.role in ("owner", "editor") and ws.id != memory.workspace_id
+    ]
+
     try:
-        await dao.move(id, target_workspace_id)
+        await dao.move(memory.id, memory.workspace_id, to_workspace_id)
     except ValueError as e:
-        memory = await dao.get(id)
-        if memory is None:
-            raise HTTPException(status_code=404, detail="Memory not found")
-        workspaces = await ws_dao.list_workspaces()
-        ws_map = {
-            ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces
-        }
-        ws_name = ws_map.get(memory.workspace_id) if memory.workspace_id else None
-        writable = [
-            ws
-            for ws in workspaces
-            if ws.role in ("owner", "editor") and ws.id != memory.workspace_id
-        ]
         return templates.TemplateResponse(
             request,
             "_memory_content.html",
@@ -308,17 +294,6 @@ async def move_memory(
             },
         )
 
-    memory = await dao.get(id)
-    if memory is None:
-        raise HTTPException(status_code=404, detail="Memory not found")
-    workspaces = await ws_dao.list_workspaces()
-    ws_map = {ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces}
-    ws_name = ws_map.get(memory.workspace_id) if memory.workspace_id else None
-    writable = [
-        ws
-        for ws in workspaces
-        if ws.role in ("owner", "editor") and ws.id != memory.workspace_id
-    ]
     return templates.TemplateResponse(
         request,
         "_memory_content.html",
@@ -328,7 +303,7 @@ async def move_memory(
             "memory_id": id,
             "workspace_name": ws_name,
             "writable_workspaces": writable,
-            "success": "Moved.",
+            "success": "Moved",
         },
     )
 
@@ -339,8 +314,12 @@ async def delete_memory_ui(
     s: APISessionDep,
     user: APIUserDep,
 ) -> Response:
-    try:
-        await MemoryDao(s, user.id).delete(id)
-    except ValueError:
+    dao = MemoryDao(s, user.id)
+    item = await dao.get(id=id)
+    if item is None:
         raise HTTPException(status_code=404, detail="Memory not found")
+    try:
+        await dao.delete(item.id, item.workspace_id)
+    except ValueError as e:
+        raise HTTPException(status_code=404, detail="Memory not found") from e
     return Response(content="", status_code=200)
diff --git a/src/memlord/ui/data.py b/src/memlord/ui/data.py
index ef2dfe9..03aa586 100644
--- a/src/memlord/ui/data.py
+++ b/src/memlord/ui/data.py
@@ -92,9 +92,7 @@ async def import_memories_ui(
     ws_id: int | None = int(workspace_id) if workspace_id else None
     if ws_id is not None:
         if not await ws_dao.can_write(ws_id):
-            raise HTTPException(
-                status_code=403, detail="No write access to this workspace"
-            )
+            raise HTTPException(status_code=403, detail="No write access to this workspace")
         target_ws_id = ws_id
     else:
         personal_ws = await ws_dao.get_personal()
@@ -122,7 +120,5 @@ async def import_memories_ui(
         else:
             skipped += 1
 
-    redirect_target = (
-        f"/ui/workspaces/{target_ws_id}?imported={imported}&skipped={skipped}"
-    )
+    redirect_target = f"/ui/workspaces/{target_ws_id}?imported={imported}&skipped={skipped}"
     return RedirectResponse(redirect_target, status_code=status.HTTP_303_SEE_OTHER)
diff --git a/src/memlord/ui/workspaces.py b/src/memlord/ui/workspaces.py
index e016315..cb4e3f6 100644
--- a/src/memlord/ui/workspaces.py
+++ b/src/memlord/ui/workspaces.py
@@ -47,9 +47,7 @@ async def workspace_new_post(
             status_code=400,
         )
     try:
-        ws = await WorkspaceDao(s, user.id).create(
-            name=name, description=description_val
-        )
+        ws = await WorkspaceDao(s, user.id).create(name=name, description=description_val)
     except IntegrityError:
         return templates.TemplateResponse(
             request,
@@ -98,9 +96,7 @@ async def workspace_rename_post(
     if ws is None:
         raise HTTPException(status_code=404, detail="Workspace not found")
     if ws.is_personal:
-        raise HTTPException(
-            status_code=400, detail="Cannot rename a personal workspace"
-        )
+        raise HTTPException(status_code=400, detail="Cannot rename a personal workspace")
     try:
         await WorkspaceDao(s, user.id).rename(workspace_id=workspace_id, name=name)
     except ValueError as e:
@@ -140,18 +136,14 @@ async def workspace_invite(
     if ws is None:
         raise HTTPException(status_code=404, detail="Workspace not found")
     if ws.is_personal:
-        raise HTTPException(
-            status_code=400, detail="Cannot invite to a personal workspace"
-        )
+        raise HTTPException(status_code=400, detail="Cannot invite to a personal workspace")
     try:
         token = await WorkspaceDao(s, user.id).create_invite(
             workspace_id=workspace_id,
             expires_in_hours=expires_in_hours,
         )
     except ValueError as e:
-        return HTMLResponse(
-            f'<div class="alert alert-error">{e}</div>', status_code=400
-        )
+        return HTMLResponse(f'<div class="alert alert-error">{e}</div>', status_code=400)
     base = str(request.base_url).rstrip("/")
     invite_url = f"{base}/ui/join/{token}"
     return templates.TemplateResponse(
@@ -191,9 +183,7 @@ async def workspace_delete(
     if ws is None:
         raise HTTPException(status_code=404, detail="Workspace not found")
     if ws.is_personal:
-        raise HTTPException(
-            status_code=400, detail="Cannot delete a personal workspace"
-        )
+        raise HTTPException(status_code=400, detail="Cannot delete a personal workspace")
     try:
         await dao.delete_workspace(workspace_id=workspace_id)
     except ValueError as e:
diff --git a/tests/test_created_at_tz.py b/tests/test_created_at_tz.py
index a054aae..f32a9f7 100644
--- a/tests/test_created_at_tz.py
+++ b/tests/test_created_at_tz.py
@@ -6,15 +6,13 @@
 
 
 def _assert_tz_aware(created_at: datetime) -> None:
-    assert (
-        created_at.tzinfo is not None
-    ), f"created_at must be timezone-aware: {created_at!r}"
+    assert created_at.tzinfo is not None, f"created_at must be timezone-aware: {created_at!r}"
 
 
 async def test_recall_memory_created_at_has_timezone(mcp_client):
     await mcp_client.call_tool(
         "store_memory",
-        {"content": "tz test memory", "memory_type": MemoryType.fact},
+        {"content": "tz test memory", "memory_type": MemoryType.fact, "name": "test"},
     )
 
     r = await mcp_client.call_tool("recall_memory", {"query": "tz test memory"})
@@ -26,7 +24,7 @@ async def test_recall_memory_created_at_has_timezone(mcp_client):
 async def test_list_memories_created_at_has_timezone(mcp_client):
     await mcp_client.call_tool(
         "store_memory",
-        {"content": "tz list test memory", "memory_type": MemoryType.fact},
+        {"content": "tz list test memory", "memory_type": MemoryType.fact, "name": "test"},
     )
 
     r = await mcp_client.call_tool("list_memories", {})
@@ -39,6 +37,7 @@ async def test_search_by_tag_created_at_has_timezone(mcp_client):
         "store_memory",
         {
             "content": "tz tag test memory",
+            "name": "test",
             "memory_type": MemoryType.fact,
             "tags": ["tz-test"],
         },
diff --git a/tests/test_dao.py b/tests/test_dao.py
index b5c1f39..6aac2f8 100644
--- a/tests/test_dao.py
+++ b/tests/test_dao.py
@@ -38,13 +38,11 @@ async def test_crud(session, user_id, workspace_id):
     assert meta[mid][0] == {"k": "v"}
 
     # update content + tags
-    await dao.update(
-        id=mid, workspace_ids=[workspace_id], content="updated content", tags={"baz"}
-    )
+    await dao.update(id=mid, workspace_id=workspace_id, content="updated content", tags={"baz"})
     tags2 = await dao.fetch_tags([mid])
     assert tags2[mid] == {"baz"}
 
     # delete
-    await dao.delete(mid, workspace_ids=[workspace_id])
+    await dao.delete(mid, workspace_id=workspace_id)
     with pytest.raises(ValueError):
-        await dao.delete(mid, workspace_ids=[workspace_id])
+        await dao.delete(mid, workspace_id=workspace_id)
diff --git a/tests/test_move.py b/tests/test_move.py
index 6a7cbda..c5022a1 100644
--- a/tests/test_move.py
+++ b/tests/test_move.py
@@ -19,7 +19,7 @@ async def memory_id(session, user_id: int, workspace_id: int) -> int:
         content="move me",
         memory_type=MemoryType.fact,
         metadata={},
-        tags=["x"],
+        tags={"x"},
         workspace_id=workspace_id,
     )
     return mid
@@ -29,20 +29,14 @@ async def test_move_changes_workspace(
     session, user_id, workspace_id, other_workspace_id, memory_id
 ):
     dao = MemoryDao(session, user_id)
-    await dao.move(memory_id, other_workspace_id)
+    await dao.move(memory_id, workspace_id, other_workspace_id)
 
-    mem = await dao.get(memory_id)
+    mem = await dao.get(id=memory_id, workspace_id=other_workspace_id)
     assert mem is not None
     assert mem.workspace_id == other_workspace_id
 
 
-async def test_move_not_found(session, user_id, other_workspace_id):
-    dao = MemoryDao(session, user_id)
-    with pytest.raises(ValueError, match="not found"):
-        await dao.move(999999, other_workspace_id)
-
-
-async def test_move_inaccessible_workspace_raises(session, user_id, memory_id):
+async def test_move_inaccessible_workspace_raises(session, user_id, memory_id, workspace_id):
     other_user = await UserDao(session).create(
         email="other@example.com",
         display_name="Other User",
@@ -52,7 +46,7 @@ async def test_move_inaccessible_workspace_raises(session, user_id, memory_id):
 
     dao = MemoryDao(session, user_id)
     with pytest.raises(PermissionError, match="No access"):
-        await dao.move(memory_id, other_ws.id)
+        await dao.move(memory_id, workspace_id, other_ws.id)
 
 
 async def test_move_duplicate_content_raises(
@@ -68,4 +62,4 @@ async def test_move_duplicate_content_raises(
         workspace_id=other_workspace_id,
     )
     with pytest.raises(ValueError, match="already exists"):
-        await dao.move(memory_id, other_workspace_id)
+        await dao.move(memory_id, workspace_id, other_workspace_id)

From 05619c9f4b017c1c961b848df9cb0e13ae15c9e3 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Tue, 7 Apr 2026 19:28:07 +0200
Subject: [PATCH 08/16] ruff format

---
 src/memlord/auth.py                   |  4 +--
 src/memlord/config.py                 |  4 +--
 src/memlord/dao/email_token.py        |  4 +--
 src/memlord/dao/user.py               | 26 ++++++-------------
 src/memlord/db.py                     |  4 +--
 src/memlord/main.py                   |  4 +--
 src/memlord/models/memory.py          |  4 +--
 src/memlord/models/memory_tag.py      |  4 +--
 src/memlord/models/workspace.py       |  4 +--
 src/memlord/oauth.py                  | 36 +++++++--------------------
 src/memlord/ui/login.py               | 12 +++------
 src/memlord/ui/utils.py               |  4 +--
 src/memlord/utils/inject_client_id.py |  4 +--
 tests/test_oauth.py                   |  4 +--
 tests/test_search.py                  | 12 +++------
 15 files changed, 34 insertions(+), 96 deletions(-)

diff --git a/src/memlord/auth.py b/src/memlord/auth.py
index 20e8992..f9bd4d5 100644
--- a/src/memlord/auth.py
+++ b/src/memlord/auth.py
@@ -30,9 +30,7 @@ async def _current_user_gen(
         yield settings.stdio_user_id
         return
     user_id = await s.scalar(
-        select(OAuthClient.user_id).where(
-            OAuthClient.client_id == access_token.client_id
-        )
+        select(OAuthClient.user_id).where(OAuthClient.client_id == access_token.client_id)
     )
     if user_id is None:
         raise PermissionError("Unauthenticated")
diff --git a/src/memlord/config.py b/src/memlord/config.py
index 1187e53..4bb40c2 100644
--- a/src/memlord/config.py
+++ b/src/memlord/config.py
@@ -5,9 +5,7 @@
 
 
 class Settings(BaseSettings):
-    model_config = SettingsConfigDict(
-        env_prefix="MEMLORD_", env_file=".env", extra="ignore"
-    )
+    model_config = SettingsConfigDict(env_prefix="MEMLORD_", env_file=".env", extra="ignore")
 
     db_url: str = "postgresql+asyncpg://postgres:postgres@localhost/memlord"
     db_echo: bool = False
diff --git a/src/memlord/dao/email_token.py b/src/memlord/dao/email_token.py
index 54335d4..285c661 100644
--- a/src/memlord/dao/email_token.py
+++ b/src/memlord/dao/email_token.py
@@ -59,7 +59,5 @@ async def consume(self, raw: str, purpose: TokenPurpose) -> int | None:
             return None
         if utcnow() > row["expires_at"]:
             return None
-        await self._s.execute(
-            delete(EmailToken).where(EmailToken.token_hash == _hash(raw))
-        )
+        await self._s.execute(delete(EmailToken).where(EmailToken.token_hash == _hash(raw)))
         return row["user_id"]
diff --git a/src/memlord/dao/user.py b/src/memlord/dao/user.py
index adc619c..d6b99a1 100644
--- a/src/memlord/dao/user.py
+++ b/src/memlord/dao/user.py
@@ -37,18 +37,16 @@ async def authenticate(self, email: str, password: str) -> UserInfo | None:
         )
 
     async def exists_by_email(self, email: str) -> bool:
-        result = await self._s.scalar(
-            select(User.id).where(User.email == email.strip().lower())
-        )
+        result = await self._s.scalar(select(User.id).where(User.email == email.strip().lower()))
         return result is not None
 
     async def get_by_id(self, id: int) -> UserInfo | None:
         row = (
             (
                 await self._s.execute(
-                    select(
-                        User.id, User.display_name, User.email, User.email_verified
-                    ).where(User.id == id)
+                    select(User.id, User.display_name, User.email, User.email_verified).where(
+                        User.id == id
+                    )
                 )
             )
             .mappings()
@@ -67,25 +65,17 @@ async def get_email_by_id(self, id: int) -> str | None:
         return await self._s.scalar(select(User.email).where(User.id == id))
 
     async def get_id_by_email(self, email: str) -> int | None:
-        return await self._s.scalar(
-            select(User.id).where(User.email == email.strip().lower())
-        )
+        return await self._s.scalar(select(User.id).where(User.email == email.strip().lower()))
 
     async def set_email_verified(self, user_id: int) -> None:
-        await self._s.execute(
-            update(User).where(User.id == user_id).values(email_verified=True)
-        )
+        await self._s.execute(update(User).where(User.id == user_id).values(email_verified=True))
 
     async def set_password(self, user_id: int, hashed_password: str) -> None:
         await self._s.execute(
-            update(User)
-            .where(User.id == user_id)
-            .values(hashed_password=hashed_password)
+            update(User).where(User.id == user_id).values(hashed_password=hashed_password)
         )
 
-    async def create(
-        self, email: str, display_name: str, hashed_password: str
-    ) -> UserInfo:
+    async def create(self, email: str, display_name: str, hashed_password: str) -> UserInfo:
         user_id = await self._s.scalar(
             insert(User)
             .values(
diff --git a/src/memlord/db.py b/src/memlord/db.py
index 6db9f01..398a3a4 100644
--- a/src/memlord/db.py
+++ b/src/memlord/db.py
@@ -16,9 +16,7 @@
 
 @cache
 def get_engine() -> AsyncEngine:
-    return create_async_engine(
-        settings.db_url, echo=settings.db_echo, pool_pre_ping=True
-    )
+    return create_async_engine(settings.db_url, echo=settings.db_echo, pool_pre_ping=True)
 
 
 @cache
diff --git a/src/memlord/main.py b/src/memlord/main.py
index ede0328..ae9f373 100644
--- a/src/memlord/main.py
+++ b/src/memlord/main.py
@@ -27,9 +27,7 @@ async def lifespan(app: FastAPI):
 
 
 @app.exception_handler(PermissionError)
-async def permission_error_handler(
-    request: Request, exc: PermissionError
-) -> JSONResponse:
+async def permission_error_handler(request: Request, exc: PermissionError) -> JSONResponse:
     return JSONResponse(
         status_code=status.HTTP_403_FORBIDDEN,
         content={"detail": str(exc)},
diff --git a/src/memlord/models/memory.py b/src/memlord/models/memory.py
index 67e3796..8cf3db3 100644
--- a/src/memlord/models/memory.py
+++ b/src/memlord/models/memory.py
@@ -31,9 +31,7 @@ class Memory(Base):
     name = sa.Column(sa.Text, nullable=True, index=True)
 
     __table_args__ = (
-        sa.UniqueConstraint(
-            "content", "workspace_id", name="uq_memories_content_workspace"
-        ),
+        sa.UniqueConstraint("content", "workspace_id", name="uq_memories_content_workspace"),
         sa.UniqueConstraint("name", "workspace_id", name="uq_memories_name_workspace"),
         sa.Index("ix_memories_search_vector", "search_vector", postgresql_using="gin"),
         sa.Index(
diff --git a/src/memlord/models/memory_tag.py b/src/memlord/models/memory_tag.py
index 7d60468..09678bf 100644
--- a/src/memlord/models/memory_tag.py
+++ b/src/memlord/models/memory_tag.py
@@ -9,6 +9,4 @@ class MemoryTag(Base):
     memory_id = sa.Column(
         sa.Integer, sa.ForeignKey("memories.id", ondelete="CASCADE"), primary_key=True
     )
-    tag_id = sa.Column(
-        sa.Integer, sa.ForeignKey("tags.id", ondelete="CASCADE"), primary_key=True
-    )
+    tag_id = sa.Column(sa.Integer, sa.ForeignKey("tags.id", ondelete="CASCADE"), primary_key=True)
diff --git a/src/memlord/models/workspace.py b/src/memlord/models/workspace.py
index 922d371..2a627de 100644
--- a/src/memlord/models/workspace.py
+++ b/src/memlord/models/workspace.py
@@ -41,9 +41,7 @@ class WorkspaceMember(Base):
         nullable=False,
     )
     role = sa.Column(sa.Text, nullable=False, server_default="member")
-    joined_at = sa.Column(
-        sa.DateTime(timezone=False), server_default=sa.func.now(), nullable=False
-    )
+    joined_at = sa.Column(sa.DateTime(timezone=False), server_default=sa.func.now(), nullable=False)
 
 
 class WorkspaceInvite(Base):
diff --git a/src/memlord/oauth.py b/src/memlord/oauth.py
index 74b9810..a91abe2 100644
--- a/src/memlord/oauth.py
+++ b/src/memlord/oauth.py
@@ -250,9 +250,7 @@ def _login_get(self, request: Request) -> Response:
         pending_id = request.query_params.get("id", "")
         pending = self._pending.get(pending_id)
         if not pending or pending.expires_at < time.time():
-            logger.warning(
-                "login GET: invalid/expired pending_id=%s...", pending_id[:8]
-            )
+            logger.warning("login GET: invalid/expired pending_id=%s...", pending_id[:8])
             return HTMLResponse(
                 "<h3>Authorization request expired. Please try again.</h3>",
                 status_code=400,
@@ -275,9 +273,7 @@ async def _login_post(self, request: Request) -> Response:
         pending = self._pending.get(pending_id)
         if not pending or pending.expires_at < time.time():
             self._pending.pop(pending_id, None)
-            logger.warning(
-                "login POST: invalid/expired pending_id=%s...", pending_id[:8]
-            )
+            logger.warning("login POST: invalid/expired pending_id=%s...", pending_id[:8])
             return HTMLResponse(
                 "<h3>Authorization request expired. Please try again.</h3>",
                 status_code=400,
@@ -287,18 +283,14 @@ async def _login_post(self, request: Request) -> Response:
             return await self._handle_register(form, pending_id, pending)
         return await self._handle_login(form, pending_id, pending)
 
-    async def _handle_login(
-        self, form, pending_id: str, pending: "_PendingAuth"
-    ) -> Response:
+    async def _handle_login(self, form, pending_id: str, pending: "_PendingAuth") -> Response:
         email = str(form.get("email", "")).strip().lower()
         password = str(form.get("password", ""))
 
         async with self.session() as s:
             exists = await UserDao(s).exists_by_email(email)
             if not exists:
-                logger.info(
-                    "login: email not found, showing register form email=%s", email
-                )
+                logger.info("login: email not found, showing register form email=%s", email)
                 return HTMLResponse(
                     _REGISTER_HTML.format(
                         style=_CARD_STYLE,
@@ -311,9 +303,7 @@ async def _handle_login(
             user = await UserDao(s).authenticate(email, password)
 
         if user is None:
-            logger.warning(
-                "login: wrong password email=%s client_id=%s", email, pending.client_id
-            )
+            logger.warning("login: wrong password email=%s client_id=%s", email, pending.client_id)
             return HTMLResponse(
                 _LOGIN_HTML.format(
                     style=_CARD_STYLE,
@@ -327,9 +317,7 @@ async def _handle_login(
 
         return await self._issue_code(pending_id, pending, user.id)
 
-    async def _handle_register(
-        self, form, pending_id: str, pending: "_PendingAuth"
-    ) -> Response:
+    async def _handle_register(self, form, pending_id: str, pending: "_PendingAuth") -> Response:
         email = str(form.get("email", "")).strip().lower()
         display_name = str(form.get("display_name", "")).strip()
         password = str(form.get("password", ""))
@@ -366,9 +354,7 @@ def _reg_error(msg: str) -> Response:
         logger.info("register: created user id=%d email=%s", user.id, email)
         return await self._issue_code(pending_id, pending, user.id)
 
-    async def _issue_code(
-        self, pending_id: str, pending: "_PendingAuth", user_id: int
-    ) -> Response:
+    async def _issue_code(self, pending_id: str, pending: "_PendingAuth", user_id: int) -> Response:
         del self._pending[pending_id]
 
         # Link this OAuth client to the authenticated user
@@ -437,9 +423,7 @@ async def register_client(self, client_info: OAuthClientInformationFull) -> None
             data["token_endpoint_auth_method"] = "client_secret_basic"
         async with self.session() as s:
             existing_data = await s.scalar(
-                sa.select(OAuthClient.data).where(
-                    OAuthClient.client_id == client_info.client_id
-                )
+                sa.select(OAuthClient.data).where(OAuthClient.client_id == client_info.client_id)
             )
             if existing_data:
                 existing_uris: list[str] = existing_data.get("redirect_uris") or []
@@ -524,9 +508,7 @@ async def load_access_token(self, token: str) -> AccessToken | None:  # type: ig
 
         # Check revocation in DB (survives restarts, works cross-instance).
         async with self.session() as s:
-            revoked = await s.scalar(
-                sa.select(RevokedToken.jti).where(RevokedToken.jti == jti)
-            )
+            revoked = await s.scalar(sa.select(RevokedToken.jti).where(RevokedToken.jti == jti))
         if revoked is not None:
             logger.debug("load_access_token: jti revoked jti=%s...", jti[:8])
             return None
diff --git a/src/memlord/ui/login.py b/src/memlord/ui/login.py
index a10807f..1763306 100644
--- a/src/memlord/ui/login.py
+++ b/src/memlord/ui/login.py
@@ -126,9 +126,7 @@ def _verify_email_body(token: str) -> str:
 if settings.smtp_host:
 
     @router.get("/verify-email", response_class=HTMLResponse)
-    async def verify_email(
-        request: Request, s: APISessionDep, token: str = ""
-    ) -> Response:
+    async def verify_email(request: Request, s: APISessionDep, token: str = "") -> Response:
         if not token:
             return templates.TemplateResponse(
                 request, "verify_email.html", {"error": "Invalid or missing token."}
@@ -144,9 +142,7 @@ async def verify_email(
             )
 
         await UserDao(s).set_email_verified(user_id)
-        return templates.TemplateResponse(
-            request, "verify_email.html", {"success": True}
-        )
+        return templates.TemplateResponse(request, "verify_email.html", {"success": True})
 
     @router.post("/resend-verification")
     async def resend_verification(user: APIUserDep, s: APISessionDep) -> Response:
@@ -208,9 +204,7 @@ async def reset_password_get(request: Request, token: str = "") -> HTMLResponse:
                 {"error": "Invalid or missing token."},
                 status_code=400,
             )
-        return templates.TemplateResponse(
-            request, "reset_password.html", {"token": token}
-        )
+        return templates.TemplateResponse(request, "reset_password.html", {"token": token})
 
     @router.post("/reset-password")
     async def reset_password_post(
diff --git a/src/memlord/ui/utils.py b/src/memlord/ui/utils.py
index d487458..360b9fb 100644
--- a/src/memlord/ui/utils.py
+++ b/src/memlord/ui/utils.py
@@ -23,9 +23,7 @@ def make_session_token(user_id: int) -> str:
     """Return a signed, time-stamped session token for the given user."""
     ts = int(time.time())
     body = f"{user_id}:{ts}"
-    sig = hmac.new(
-        settings.oauth_jwt_secret.encode(), body.encode(), hashlib.sha256
-    ).hexdigest()
+    sig = hmac.new(settings.oauth_jwt_secret.encode(), body.encode(), hashlib.sha256).hexdigest()
     return f"{body}:{sig}"
 
 
diff --git a/src/memlord/utils/inject_client_id.py b/src/memlord/utils/inject_client_id.py
index a3fef33..a7d3115 100644
--- a/src/memlord/utils/inject_client_id.py
+++ b/src/memlord/utils/inject_client_id.py
@@ -23,9 +23,7 @@ async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
             more = msg.get("more_body", False)
         body = b"".join(chunks)
 
-        params = {
-            k: v[0] for k, v in parse_qs(body.decode(), keep_blank_values=True).items()
-        }
+        params = {k: v[0] for k, v in parse_qs(body.decode(), keep_blank_values=True).items()}
         if not params.get("client_id") and params.get("code"):
             entry = self._auth_codes.get(params["code"])
             if entry:
diff --git a/tests/test_oauth.py b/tests/test_oauth.py
index e7e2ef4..2f0ea41 100644
--- a/tests/test_oauth.py
+++ b/tests/test_oauth.py
@@ -50,9 +50,7 @@ def oauth_client():
 def _pkce_pair() -> tuple[str, str]:
     verifier = secrets.token_urlsafe(32)
     challenge = (
-        base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest())
-        .decode()
-        .rstrip("=")
+        base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest()).decode().rstrip("=")
     )
     return verifier, challenge
 
diff --git a/tests/test_search.py b/tests/test_search.py
index 5ad1207..530da72 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -57,9 +57,7 @@ async def test_vector_semantic_match(session, user_id, workspace_id):
 
 async def test_threshold_zero_includes_bm25_hit(session, user_id, workspace_id):
     """Regression: threshold=0.0 must not filter BM25-only matches."""
-    await _store(
-        session, "The quick brown fox jumps over the lazy dog", user_id, workspace_id
-    )
+    await _store(session, "The quick brown fox jumps over the lazy dog", user_id, workspace_id)
 
     results = await hybrid_search(
         session,
@@ -99,9 +97,7 @@ async def test_limit(session, user_id, workspace_id):
 async def test_date_filter_today(session, user_id, workspace_id):
     mid = await _store(session, "something stored today", user_id, workspace_id)
     yesterday = (datetime.now(timezone.utc) - timedelta(days=1)).replace(tzinfo=None)
-    await session.execute(
-        update(Memory).where(Memory.id == mid).values(created_at=yesterday)
-    )
+    await session.execute(update(Memory).where(Memory.id == mid).values(created_at=yesterday))
     mid2 = await _store(session, "something stored recently", user_id, workspace_id)
 
     today_start = datetime.now(timezone.utc).replace(
@@ -121,9 +117,7 @@ async def test_date_filter_today(session, user_id, workspace_id):
 
 async def test_date_filter_includes_today(session, user_id, workspace_id):
     """Regression: date_from = start-of-day must include memories created today."""
-    mid = await _store(
-        session, "python programming language tutorial", user_id, workspace_id
-    )
+    mid = await _store(session, "python programming language tutorial", user_id, workspace_id)
 
     now = datetime.now(timezone.utc).replace(tzinfo=None)
     today_midnight = now.replace(hour=0, minute=0, second=0, microsecond=0)

From 5edf4fda33e0965c948b6ea91739bd9598f9b1a6 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 27 Apr 2026 14:54:10 +0200
Subject: [PATCH 09/16] Ensure 'name' field is non-nullable and add default
 generation logic.

---
 FEDERATION.md                                 | 64 +++++++++++++++++++
 cli.py                                        | 36 +++++++++++
 ...04_08_0002-f8c1fc9be252_add_memory_name.py | 34 ++++++++--
 src/memlord/api/workspaces.py                 |  2 +
 src/memlord/dao/memory.py                     | 10 +--
 src/memlord/models/memory.py                  |  3 +-
 src/memlord/schemas/delete.py                 |  2 +-
 src/memlord/schemas/list_memories.py          |  6 +-
 src/memlord/schemas/recall.py                 |  2 +-
 src/memlord/schemas/search.py                 |  4 +-
 src/memlord/schemas/store.py                  | 14 +++-
 tests/test_dao.py                             |  2 +
 tests/test_data.py                            |  2 +
 tests/test_move.py                            |  2 +
 tests/test_search.py                          |  2 +
 15 files changed, 161 insertions(+), 24 deletions(-)
 create mode 100644 FEDERATION.md
 create mode 100644 cli.py

diff --git a/FEDERATION.md b/FEDERATION.md
new file mode 100644
index 0000000..546c25e
--- /dev/null
+++ b/FEDERATION.md
@@ -0,0 +1,64 @@
+# Federation Refactoring Plan
+
+## Concept
+
+Each memlord server IS a workspace. Users connect multiple servers to their MCP client.
+`list_workspaces` returns registered remote (federated) servers.
+Calling a tool with `workspace="work"` proxies the request to that server.
+Without `workspace`, operates on the local server.
+
+MCP API surface stays identical.
+
+## Steps
+
+### 1. Remove `workspace_id` from `memories`
+- Alembic migration: drop `workspace_id` column
+- Remove from `Memory` model
+- Remove from all queries in `search.py`, `tools/`
+- Remove from schemas (`MemoryOut`, etc.)
+
+### 2. Remove `workspaces` table
+- Alembic migration: drop `workspaces` table
+- Delete `models/workspace.py`
+- Remove from `tools/workspaces.py` (list_workspaces, create_workspace, etc.)
+
+### 3. Add `federated_servers` table
+- Alembic migration: create table (`id`, `name`, `url`, `token`, `created_at`)
+- Add `models/federated_server.py`
+- Add `schemas/federated_server.py`
+
+### 4. Rewrite `list_workspaces`
+- Returns rows from `federated_servers`
+- Optionally include a `"local"` entry representing this server itself
+
+### 5. Add proxy layer
+- When `workspace` param is set: look up URL + token from `federated_servers`, forward MCP tool call via HTTP
+- When `workspace` is absent or `"local"`: execute locally
+- Centralise in `tools/proxy.py` or a decorator
+
+### 6. Simplify all tools
+- Drop `workspace` parameter from local query paths
+- Remove `workspace_id` filters from all SQL queries
+
+### 7. Update UI
+- Remove workspace switcher / workspace management pages
+- Add federated servers management page (list, add, delete)
+
+## Error Handling
+
+- `workspace` explicitly specified → server unavailable: raise error (read or write)
+- `workspace` not specified (fan-out over all) → server unavailable: skip silently
+
+## Search Across Federated Servers
+
+When `workspace` is not specified:
+1. Fire parallel requests: local DB query + one HTTP request per federated server
+2. Each source returns top-N results ordered by relevance (already RRF-ranked internally)
+3. Merge using RRF over ranks from all sources (scores not needed, only order)
+4. Return global top-N
+
+Centralise merge logic in `search.py` as `rrf_merge(ranked_lists) -> list`.
+
+## Out of Scope (for now)
+- Sync / replication between servers
+- Server discovery / registry
diff --git a/cli.py b/cli.py
new file mode 100644
index 0000000..501db65
--- /dev/null
+++ b/cli.py
@@ -0,0 +1,36 @@
+import asyncio
+
+from fastmcp import Client
+from fastmcp.client import StdioTransport
+
+transport = StdioTransport(
+    command="python",
+    args=["src/memlord/main.py", "--stdio"],
+    env={
+        "MEMLORD_STDIO_USER_ID": "1",
+    },
+)
+
+# Local Python script
+client = Client(transport)
+
+
+async def main():
+    async with client:
+        # Basic server interaction
+        await client.ping()
+
+        # List available operations
+        tools = await client.list_tools()
+        print([i.name for i in tools])
+
+        # Execute operations
+        result = await client.call_tool("list_memories")
+        print(result)
+
+        # result = await client.call_tool("get_memory", {"name": "5"})
+        # print(result)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
diff --git a/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py b/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py
index e508c60..d3d777d 100644
--- a/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py
+++ b/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py
@@ -29,9 +29,7 @@ def upgrade() -> None:
     )
     # ### end Alembic commands ###
 
-    # Back-fill name from content: if content starts with a short phrase followed
-    # by ":", use that phrase as the name.  Skip if the candidate name would
-    # collide with another memory in the same workspace.
+    # Pass 1: extract name from "name: content" pattern where unambiguous.
     op.execute(sa.text("""
         UPDATE memories
         SET
@@ -51,16 +49,38 @@ def upgrade() -> None:
             )
     """))
 
+    # Pass 2: fill remaining NULLs from the first 60 chars of content.
+    # Append " #<id>" when that prefix would collide with an existing name or
+    # another NULL row that generates the same prefix in the same workspace.
+    op.execute(sa.text("""
+        UPDATE memories m
+        SET name = CASE
+            WHEN EXISTS (
+                SELECT 1 FROM memories m2
+                WHERE m2.workspace_id = m.workspace_id
+                  AND m2.id != m.id
+                  AND (
+                      m2.name = LEFT(TRIM(m.content), 60)
+                      OR (m2.name IS NULL
+                          AND LEFT(TRIM(m2.content), 60) = LEFT(TRIM(m.content), 60))
+                  )
+            )
+            THEN LEFT(TRIM(m.content), 54) || ' #' || m.id::text
+            ELSE LEFT(TRIM(m.content), 60)
+        END
+        WHERE m.name IS NULL
+    """))
+
+    op.alter_column("memories", "name", nullable=False)
+
 
 def downgrade() -> None:
     """Downgrade schema."""
-    # Restore content: prepend name back if name was set by the back-fill.
-    # We can't know which rows were touched, so we restore all rows that have
-    # a name — concatenating "name: content".
+    # Prepend name back into content for all rows (can't distinguish auto-generated
+    # names from extracted ones, so we restore everything).
     op.execute(sa.text("""
         UPDATE memories
         SET content = name || ': ' || content
-        WHERE name IS NOT NULL
     """))
 
     # ### commands auto generated by Alembic - please adjust! ###
diff --git a/src/memlord/api/workspaces.py b/src/memlord/api/workspaces.py
index 86e003b..91aa252 100644
--- a/src/memlord/api/workspaces.py
+++ b/src/memlord/api/workspaces.py
@@ -182,6 +182,7 @@ async def export_memories(
             await s.execute(
                 select(
                     Memory.id,
+                    Memory.name,
                     Memory.content,
                     Memory.memory_type,
                     Memory.created_at,
@@ -237,6 +238,7 @@ async def import_memories(
             memory_type=parsed.memory_type,
             metadata=parsed.metadata,
             tags=parsed.tags,
+            name=parsed.name,
             workspace_id=workspace_id,
             force=True,
         )
diff --git a/src/memlord/dao/memory.py b/src/memlord/dao/memory.py
index fdf9834..3b5aed6 100644
--- a/src/memlord/dao/memory.py
+++ b/src/memlord/dao/memory.py
@@ -106,9 +106,9 @@ async def create(
         memory_type: MemoryType,
         metadata: dict,
         tags: set[str],
+        name: str,
         workspace_id: int | None = None,
         force: bool = False,
-        name: str | None = None,
     ) -> tuple[int, bool]:
         if workspace_id is None:
             workspace_id = await self._personal_workspace_id()
@@ -157,8 +157,8 @@ async def update(
         metadata: dict = _UNSET,  # type: ignore[assignment]
         tags: set[str] = _UNSET,  # type: ignore[assignment]
         name: str | None = _UNSET,  # type: ignore[assignment]
-    ) -> tuple[int, str | None]:
-        """Update memory fields. Pass _UNSET to leave a field unchanged; None sets it to NULL."""
+    ) -> tuple[int, str]:
+        """Update memory fields. Pass _UNSET to leave a field unchanged."""
         if workspace_id is None:
             workspace_id = await self._personal_workspace_id()
         else:
@@ -198,10 +198,10 @@ async def update(
         if tags is not _UNSET:
             await self._replace_tags(memory_id, tags)
 
-        final_name: str | None = (
+        final_name: str = (
             values["name"]
             if "name" in values
-            else await self._s.scalar(select(Memory.name).where(Memory.id == memory_id))
+            else await self._s.scalar(select(Memory.name).where(Memory.id == memory_id))  # type: ignore[assignment]
         )
         return memory_id, final_name
 
diff --git a/src/memlord/models/memory.py b/src/memlord/models/memory.py
index 8cf3db3..00e2826 100644
--- a/src/memlord/models/memory.py
+++ b/src/memlord/models/memory.py
@@ -9,6 +9,7 @@ class Memory(Base):
     __tablename__ = "memories"
 
     id = sa.Column(sa.Integer, primary_key=True, autoincrement=True)
+    name = sa.Column(sa.Text, nullable=False, index=True)
     content = sa.Column(sa.Text, nullable=False)
     created_by = sa.Column(sa.Integer, sa.ForeignKey("users.id"), nullable=False)
     memory_type = sa.Column(sa.String(50), nullable=False)
@@ -28,8 +29,6 @@ class Memory(Base):
         nullable=False,
     )
 
-    name = sa.Column(sa.Text, nullable=True, index=True)
-
     __table_args__ = (
         sa.UniqueConstraint("content", "workspace_id", name="uq_memories_content_workspace"),
         sa.UniqueConstraint("name", "workspace_id", name="uq_memories_name_workspace"),
diff --git a/src/memlord/schemas/delete.py b/src/memlord/schemas/delete.py
index 933f093..2e0e492 100644
--- a/src/memlord/schemas/delete.py
+++ b/src/memlord/schemas/delete.py
@@ -3,4 +3,4 @@
 
 class DeleteResult(BaseModel):
     success: bool
-    name: str | None
+    name: str
diff --git a/src/memlord/schemas/list_memories.py b/src/memlord/schemas/list_memories.py
index 7005d86..50949df 100644
--- a/src/memlord/schemas/list_memories.py
+++ b/src/memlord/schemas/list_memories.py
@@ -9,7 +9,7 @@ class MemoryListItem(BaseModel):
     """Full memory record — used by UI and DAO."""
 
     id: int
-    name: str | None = None
+    name: str
     content: str
     memory_type: MemoryType
     metadata: dict = Field(default_factory=dict)
@@ -27,7 +27,7 @@ class MemoryItem(BaseModel):
 
     model_config = ConfigDict(extra="ignore")
 
-    name: str | None = None
+    name: str
     memory_type: MemoryType
     metadata: dict = Field(default_factory=dict)
     tags: set[str]
@@ -42,7 +42,7 @@ def serialize_created_at(self, v: datetime) -> str:
 class MemoryDetail(BaseModel):
     """Full memory record returned by get_memory MCP tool."""
 
-    name: str | None = None
+    name: str
     content: str
     memory_type: MemoryType
     metadata: dict = Field(default_factory=dict)
diff --git a/src/memlord/schemas/recall.py b/src/memlord/schemas/recall.py
index 2d5cdb4..93510da 100644
--- a/src/memlord/schemas/recall.py
+++ b/src/memlord/schemas/recall.py
@@ -6,7 +6,7 @@
 
 
 class RecallResult(BaseModel):
-    name: str | None
+    name: str
     memory_type: MemoryType | None
     tags: set[str]
     created_at: NaiveDatetime
diff --git a/src/memlord/schemas/search.py b/src/memlord/schemas/search.py
index fcaab87..8617929 100644
--- a/src/memlord/schemas/search.py
+++ b/src/memlord/schemas/search.py
@@ -7,7 +7,7 @@
 
 class SearchResult(BaseModel):
     id: int
-    name: str | None
+    name: str
     content: str
     memory_type: MemoryType
     rrf_score: float
@@ -16,7 +16,7 @@ class SearchResult(BaseModel):
 
 
 class MemoryResult(BaseModel):
-    name: str | None
+    name: str
     memory_type: MemoryType
     tags: set[str]
     metadata: dict
diff --git a/src/memlord/schemas/store.py b/src/memlord/schemas/store.py
index 86c3f45..34c8790 100644
--- a/src/memlord/schemas/store.py
+++ b/src/memlord/schemas/store.py
@@ -1,6 +1,6 @@
 from datetime import datetime
 
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, model_validator
 
 from .memory_type import MemoryType
 from ..utils.dt import utcnow
@@ -9,11 +9,19 @@
 class ImportItem(BaseModel):
     content: str
     memory_type: MemoryType
-    tags: set[str] = Field(default_factory=list)
+    name: str
+    tags: set[str] = Field(default_factory=set)
     metadata: dict = Field(default_factory=dict)
     created_at: datetime = Field(default_factory=utcnow)
 
+    @model_validator(mode="before")
+    @classmethod
+    def fill_name(cls, data: dict) -> dict:
+        if not data.get("name"):
+            data["name"] = (data.get("content") or "")[:60].strip()
+        return data
+
 
 class StoreResult(BaseModel):
-    name: str | None
+    name: str
     created: bool
diff --git a/tests/test_dao.py b/tests/test_dao.py
index 6aac2f8..1d5e7ee 100644
--- a/tests/test_dao.py
+++ b/tests/test_dao.py
@@ -13,6 +13,7 @@ async def test_crud(session, user_id, workspace_id):
         memory_type=MemoryType.fact,
         metadata={"k": "v"},
         tags={"foo", "bar"},
+        name="hello world",
         workspace_id=workspace_id,
     )
     assert created is True
@@ -24,6 +25,7 @@ async def test_crud(session, user_id, workspace_id):
         memory_type=MemoryType.fact,
         metadata={},
         tags=set(),
+        name="hello world",
         workspace_id=workspace_id,
     )
     assert created2 is False
diff --git a/tests/test_data.py b/tests/test_data.py
index b503dba..5d4f1cf 100644
--- a/tests/test_data.py
+++ b/tests/test_data.py
@@ -6,12 +6,14 @@ async def test_export_import(api_client, workspace_id):
         {
             "content": "imported fact",
             "memory_type": "fact",
+            "name": "imported fact",
             "tags": ["x"],
             "metadata": {},
         },
         {
             "content": "imported pref",
             "memory_type": "preference",
+            "name": "imported pref",
             "tags": [],
             "metadata": {"n": 1},
         },
diff --git a/tests/test_move.py b/tests/test_move.py
index a186bbc..a68e3de 100644
--- a/tests/test_move.py
+++ b/tests/test_move.py
@@ -20,6 +20,7 @@ async def memory_id(session, user_id: int, workspace_id: int) -> int:
         memory_type=MemoryType.fact,
         metadata={},
         tags={"x"},
+        name="move me",
         workspace_id=workspace_id,
     )
     return mid
@@ -59,6 +60,7 @@ async def test_move_duplicate_content_raises(
         memory_type=MemoryType.fact,
         metadata={},
         tags=set(),
+        name="move me",
         workspace_id=other_workspace_id,
     )
     with pytest.raises(ValueError, match="already exists"):
diff --git a/tests/test_search.py b/tests/test_search.py
index 530da72..dfd4a78 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -16,6 +16,7 @@ async def _store(s: AsyncSession, content: str, uid: int, workspace_id: int) ->
         memory_type=MemoryType.fact,
         metadata={},
         tags=[],
+        name=content[:60].strip(),
         workspace_id=workspace_id,
         force=True,
     )
@@ -141,6 +142,7 @@ async def test_tag_search(session, user_id, workspace_id):
         MemoryType.fact,
         {},
         ["matter", "zigbee2mqtt"],
+        name="Zigbee migration plan",
         workspace_id=workspace_id,
     )
     results = await hybrid_search(

From f51e86e67ee4d251d2e29630ab200f37840a22ba Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 27 Apr 2026 14:55:25 +0200
Subject: [PATCH 10/16] Ruff fix

---
 migrations/env.py                    | 3 ++-
 ruff.toml                            | 4 ++--
 src/memlord/auth.py                  | 3 +--
 src/memlord/dao/memory.py            | 3 +--
 src/memlord/db.py                    | 2 +-
 src/memlord/models/workspace.py      | 2 +-
 src/memlord/oauth.py                 | 6 +++---
 src/memlord/schemas/list_memories.py | 4 ++--
 src/memlord/schemas/recall.py        | 4 ++--
 src/memlord/schemas/search.py        | 2 +-
 src/memlord/schemas/store.py         | 2 +-
 src/memlord/ui/login.py              | 5 +++--
 src/memlord/utils/dt.py              | 2 +-
 13 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/migrations/env.py b/migrations/env.py
index d4daa9f..062342f 100644
--- a/migrations/env.py
+++ b/migrations/env.py
@@ -2,10 +2,11 @@
 from logging.config import fileConfig
 
 from alembic import context
+from sqlalchemy.ext.asyncio import create_async_engine
+
 from memlord.config import settings
 from memlord.models import Memory, MemoryTag, OAuthClient, SchemaVersion, Tag  # noqa: F401
 from memlord.models.base import Base
-from sqlalchemy.ext.asyncio import create_async_engine
 
 config = context.config
 
diff --git a/ruff.toml b/ruff.toml
index 5fa1835..4732206 100644
--- a/ruff.toml
+++ b/ruff.toml
@@ -21,7 +21,7 @@ select = [
     "E", # pycodestyle errors
     "W", # pycodestyle warnings
     "F", # pyflakes
-    # "I",  # isort
+    "I", # isort
     "C", # flake8-comprehensions
     "B", # flake8-bugbear
     "PLC0415", # import outside toplevel
@@ -33,7 +33,7 @@ ignore = [
 ]
 
 # Allow autofix for all enabled rules (when `--fix`) is provided.
-fixable = ["A", "B", "C", "D", "E", "F"]
+fixable = ["A", "B", "C", "D", "E", "F", "I"]
 unfixable = []
 
 # Allow unused variables when underscore-prefixed.
diff --git a/src/memlord/auth.py b/src/memlord/auth.py
index f9bd4d5..f86268f 100644
--- a/src/memlord/auth.py
+++ b/src/memlord/auth.py
@@ -1,12 +1,11 @@
 from contextlib import asynccontextmanager
 
 import bcrypt
+from fastmcp.dependencies import Depends as MCPDepends
 from fastmcp.server.dependencies import get_access_token
 from sqlalchemy import select
 from sqlalchemy.ext.asyncio import AsyncSession
 
-from fastmcp.dependencies import Depends as MCPDepends
-
 from memlord.config import settings
 from memlord.db import MCPSessionDep
 from memlord.models.oauth_client import OAuthClient
diff --git a/src/memlord/dao/memory.py b/src/memlord/dao/memory.py
index 3b5aed6..c93cd77 100644
--- a/src/memlord/dao/memory.py
+++ b/src/memlord/dao/memory.py
@@ -1,6 +1,7 @@
 from datetime import datetime
 from typing import Any
 
+import sqlalchemy as sa
 from pgvector.sqlalchemy import Vector
 from sqlalchemy import Float, bindparam, delete, insert, select, update
 from sqlalchemy.dialects.postgresql import insert as pg_insert
@@ -11,7 +12,6 @@
 from memlord.embeddings import embed
 from memlord.models import Memory, MemoryTag, Tag
 from memlord.schemas import MemoryListItem, MemoryType
-import sqlalchemy as sa
 
 _UNSET: Any = object()
 
@@ -259,7 +259,6 @@ async def get(
         tags = (await self.fetch_tags([memory_id])).get(memory_id, set())
         return MemoryListItem(**row, tags=tags)
 
-
     async def move(self, id: int, from_workspace_id: int, to_workspace_id: int) -> None:
         """Move memory to a different workspace. Raises ValueError if not found or duplicate."""
         workspace_ids = await self._accessible_workspace_ids(write=True)
diff --git a/src/memlord/db.py b/src/memlord/db.py
index 398a3a4..e2a4e6d 100644
--- a/src/memlord/db.py
+++ b/src/memlord/db.py
@@ -5,9 +5,9 @@
 from fastapi import Depends as APIDepends
 from fastmcp.dependencies import Depends as MCPDepends
 from sqlalchemy.ext.asyncio import (
-    async_sessionmaker,
     AsyncEngine,
     AsyncSession,
+    async_sessionmaker,
     create_async_engine,
 )
 
diff --git a/src/memlord/models/workspace.py b/src/memlord/models/workspace.py
index f004bb6..aba2479 100644
--- a/src/memlord/models/workspace.py
+++ b/src/memlord/models/workspace.py
@@ -1,7 +1,7 @@
 import sqlalchemy as sa
 
-from .base import Base
 from ..schemas.workspace import WorkspaceRole
+from .base import Base
 
 
 class Workspace(Base):
diff --git a/src/memlord/oauth.py b/src/memlord/oauth.py
index 4b523c0..7b7906f 100644
--- a/src/memlord/oauth.py
+++ b/src/memlord/oauth.py
@@ -10,22 +10,22 @@
 from authlib.jose.errors import JoseError
 from fastmcp.server.auth import OAuthProvider
 from fastmcp.server.auth.auth import AccessToken
-from starlette.middleware import Middleware
-from fastmcp.server.auth.jwt_issuer import derive_jwt_key, JWTIssuer
+from fastmcp.server.auth.jwt_issuer import JWTIssuer, derive_jwt_key
 from fastmcp.server.auth.redirect_validation import matches_allowed_pattern
 from mcp.server.auth.provider import (
     AuthorizationCode,
     AuthorizationParams,
     AuthorizeError,
-    construct_redirect_uri,
     RefreshToken,
     TokenError,
+    construct_redirect_uri,
 )
 from mcp.server.auth.settings import ClientRegistrationOptions, RevocationOptions
 from mcp.shared.auth import OAuthClientInformationFull, OAuthToken
 from pydantic import AnyUrl, BaseModel
 from sqlalchemy.dialects.postgresql import insert as pg_insert
 from sqlalchemy.ext.asyncio import AsyncSession
+from starlette.middleware import Middleware
 from starlette.requests import Request
 from starlette.responses import HTMLResponse, RedirectResponse, Response
 from starlette.routing import Route
diff --git a/src/memlord/schemas/list_memories.py b/src/memlord/schemas/list_memories.py
index 50949df..37f731b 100644
--- a/src/memlord/schemas/list_memories.py
+++ b/src/memlord/schemas/list_memories.py
@@ -1,6 +1,6 @@
-from datetime import datetime, UTC
+from datetime import UTC, datetime
 
-from pydantic import BaseModel, ConfigDict, Field, field_serializer, NaiveDatetime
+from pydantic import BaseModel, ConfigDict, Field, NaiveDatetime, field_serializer
 
 from .memory_type import MemoryType
 
diff --git a/src/memlord/schemas/recall.py b/src/memlord/schemas/recall.py
index 93510da..3cb7459 100644
--- a/src/memlord/schemas/recall.py
+++ b/src/memlord/schemas/recall.py
@@ -1,6 +1,6 @@
-from datetime import datetime, UTC
+from datetime import UTC, datetime
 
-from pydantic import BaseModel, Field, field_serializer, NaiveDatetime
+from pydantic import BaseModel, Field, NaiveDatetime, field_serializer
 
 from .memory_type import MemoryType
 
diff --git a/src/memlord/schemas/search.py b/src/memlord/schemas/search.py
index 8617929..11debf1 100644
--- a/src/memlord/schemas/search.py
+++ b/src/memlord/schemas/search.py
@@ -1,4 +1,4 @@
-from datetime import datetime, UTC
+from datetime import UTC, datetime
 
 from pydantic import BaseModel, NaiveDatetime, field_serializer
 
diff --git a/src/memlord/schemas/store.py b/src/memlord/schemas/store.py
index 34c8790..9a821de 100644
--- a/src/memlord/schemas/store.py
+++ b/src/memlord/schemas/store.py
@@ -2,8 +2,8 @@
 
 from pydantic import BaseModel, Field, model_validator
 
-from .memory_type import MemoryType
 from ..utils.dt import utcnow
+from .memory_type import MemoryType
 
 
 class ImportItem(BaseModel):
diff --git a/src/memlord/ui/login.py b/src/memlord/ui/login.py
index 1763306..1b4f420 100644
--- a/src/memlord/ui/login.py
+++ b/src/memlord/ui/login.py
@@ -7,9 +7,10 @@
 from memlord.dao.email_token import EmailTokenDao
 from memlord.dao.user import UserDao
 from memlord.db import APISessionDep
-from memlord.utils.mail_send import send_email
 from memlord.models.email_token import TokenPurpose
-from .utils import make_session_token, templates, APIUserDep
+from memlord.utils.mail_send import send_email
+
+from .utils import APIUserDep, make_session_token, templates
 
 router = APIRouter()
 
diff --git a/src/memlord/utils/dt.py b/src/memlord/utils/dt.py
index ecd81ce..43ef34b 100644
--- a/src/memlord/utils/dt.py
+++ b/src/memlord/utils/dt.py
@@ -1,4 +1,4 @@
-from datetime import datetime, UTC
+from datetime import UTC, datetime
 
 
 def utcnow():

From dab5c5583c0f7d71d27bf0a9acf13cdbde0d8824 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 27 Apr 2026 14:55:56 +0200
Subject: [PATCH 11/16] fix

---
 FEDERATION.md | 64 ---------------------------------------------------
 cli.py        | 36 -----------------------------
 2 files changed, 100 deletions(-)
 delete mode 100644 FEDERATION.md
 delete mode 100644 cli.py

diff --git a/FEDERATION.md b/FEDERATION.md
deleted file mode 100644
index 546c25e..0000000
--- a/FEDERATION.md
+++ /dev/null
@@ -1,64 +0,0 @@
-# Federation Refactoring Plan
-
-## Concept
-
-Each memlord server IS a workspace. Users connect multiple servers to their MCP client.
-`list_workspaces` returns registered remote (federated) servers.
-Calling a tool with `workspace="work"` proxies the request to that server.
-Without `workspace`, operates on the local server.
-
-MCP API surface stays identical.
-
-## Steps
-
-### 1. Remove `workspace_id` from `memories`
-- Alembic migration: drop `workspace_id` column
-- Remove from `Memory` model
-- Remove from all queries in `search.py`, `tools/`
-- Remove from schemas (`MemoryOut`, etc.)
-
-### 2. Remove `workspaces` table
-- Alembic migration: drop `workspaces` table
-- Delete `models/workspace.py`
-- Remove from `tools/workspaces.py` (list_workspaces, create_workspace, etc.)
-
-### 3. Add `federated_servers` table
-- Alembic migration: create table (`id`, `name`, `url`, `token`, `created_at`)
-- Add `models/federated_server.py`
-- Add `schemas/federated_server.py`
-
-### 4. Rewrite `list_workspaces`
-- Returns rows from `federated_servers`
-- Optionally include a `"local"` entry representing this server itself
-
-### 5. Add proxy layer
-- When `workspace` param is set: look up URL + token from `federated_servers`, forward MCP tool call via HTTP
-- When `workspace` is absent or `"local"`: execute locally
-- Centralise in `tools/proxy.py` or a decorator
-
-### 6. Simplify all tools
-- Drop `workspace` parameter from local query paths
-- Remove `workspace_id` filters from all SQL queries
-
-### 7. Update UI
-- Remove workspace switcher / workspace management pages
-- Add federated servers management page (list, add, delete)
-
-## Error Handling
-
-- `workspace` explicitly specified → server unavailable: raise error (read or write)
-- `workspace` not specified (fan-out over all) → server unavailable: skip silently
-
-## Search Across Federated Servers
-
-When `workspace` is not specified:
-1. Fire parallel requests: local DB query + one HTTP request per federated server
-2. Each source returns top-N results ordered by relevance (already RRF-ranked internally)
-3. Merge using RRF over ranks from all sources (scores not needed, only order)
-4. Return global top-N
-
-Centralise merge logic in `search.py` as `rrf_merge(ranked_lists) -> list`.
-
-## Out of Scope (for now)
-- Sync / replication between servers
-- Server discovery / registry
diff --git a/cli.py b/cli.py
deleted file mode 100644
index 501db65..0000000
--- a/cli.py
+++ /dev/null
@@ -1,36 +0,0 @@
-import asyncio
-
-from fastmcp import Client
-from fastmcp.client import StdioTransport
-
-transport = StdioTransport(
-    command="python",
-    args=["src/memlord/main.py", "--stdio"],
-    env={
-        "MEMLORD_STDIO_USER_ID": "1",
-    },
-)
-
-# Local Python script
-client = Client(transport)
-
-
-async def main():
-    async with client:
-        # Basic server interaction
-        await client.ping()
-
-        # List available operations
-        tools = await client.list_tools()
-        print([i.name for i in tools])
-
-        # Execute operations
-        result = await client.call_tool("list_memories")
-        print(result)
-
-        # result = await client.call_tool("get_memory", {"name": "5"})
-        # print(result)
-
-
-if __name__ == "__main__":
-    asyncio.run(main())

From 5e5d48eb05b468b828044a1ee7725c4baa9d6ff1 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 27 Apr 2026 15:38:42 +0200
Subject: [PATCH 12/16] Fix memory name handling: remove index, adjust
 auto-generation logic.

---
 ...04_08_0002-f8c1fc9be252_add_memory_name.py | 51 +++++++++----------
 src/memlord/api/memories.py                   |  8 ++-
 src/memlord/dao/memory.py                     | 16 +++---
 src/memlord/models/memory.py                  |  2 +-
 src/memlord/schemas/memory_response.py        |  2 +
 src/memlord/templates/index.html              |  1 +
 src/memlord/templates/memory.html             | 12 ++++-
 src/memlord/templates/search.html             |  1 +
 src/memlord/tools/list_memories.py            |  1 -
 src/memlord/tools/search_by_tag.py            |  1 -
 10 files changed, 57 insertions(+), 38 deletions(-)

diff --git a/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py b/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py
index d3d777d..feb83dc 100644
--- a/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py
+++ b/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py
@@ -23,7 +23,6 @@ def upgrade() -> None:
     """Upgrade schema."""
     # ### commands auto generated by Alembic - please adjust! ###
     op.add_column("memories", sa.Column("name", sa.Text(), nullable=True))
-    op.create_index(op.f("ix_memories_name"), "memories", ["name"], unique=False)
     op.create_unique_constraint(
         "uq_memories_name_workspace", "memories", ["name", "workspace_id"]
     )
@@ -33,8 +32,7 @@ def upgrade() -> None:
     op.execute(sa.text("""
         UPDATE memories
         SET
-            name    = TRIM(SPLIT_PART(content, ':', 1)),
-            content = TRIM(SUBSTRING(content FROM POSITION(':' IN content) + 1))
+            name    = TRIM(SPLIT_PART(content, ':', 1))
         WHERE
             POSITION(':' IN content) > 0
             AND CHAR_LENGTH(TRIM(SPLIT_PART(content, ':', 1))) BETWEEN 3 AND 60
@@ -49,25 +47,32 @@ def upgrade() -> None:
             )
     """))
 
+    op.execute(sa.text("""
+       UPDATE memories
+       SET
+           name    = TRIM(SPLIT_PART(content, '\n', 1))
+       WHERE
+           POSITION('\n' IN content) > 0
+         AND CHAR_LENGTH(TRIM(SPLIT_PART(content, '\n', 1))) BETWEEN 3 AND 60
+         AND name IS NULL
+         AND NOT EXISTS (
+           SELECT 1 FROM memories m2
+           WHERE m2.workspace_id = memories.workspace_id
+             AND m2.id != memories.id
+             AND POSITION('\n' IN m2.content) > 0
+             AND CHAR_LENGTH(TRIM(SPLIT_PART(m2.content, '\n', 1))) BETWEEN 3 AND 60
+             AND TRIM(SPLIT_PART(m2.content, '\n', 1)) = TRIM(SPLIT_PART(memories.content, '\n', 1))
+       )
+       """))
+
     # Pass 2: fill remaining NULLs from the first 60 chars of content.
-    # Append " #<id>" when that prefix would collide with an existing name or
-    # another NULL row that generates the same prefix in the same workspace.
     op.execute(sa.text("""
         UPDATE memories m
-        SET name = CASE
-            WHEN EXISTS (
-                SELECT 1 FROM memories m2
-                WHERE m2.workspace_id = m.workspace_id
-                  AND m2.id != m.id
-                  AND (
-                      m2.name = LEFT(TRIM(m.content), 60)
-                      OR (m2.name IS NULL
-                          AND LEFT(TRIM(m2.content), 60) = LEFT(TRIM(m.content), 60))
-                  )
-            )
-            THEN LEFT(TRIM(m.content), 54) || ' #' || m.id::text
-            ELSE LEFT(TRIM(m.content), 60)
-        END
+        SET name = CASE 
+            WHEN LENGTH(m.content) > 60
+            THEN LEFT(TRIM(m.content), 60) || '...'
+            ELSE LEFT(TRIM(m.content), 60) 
+            END
         WHERE m.name IS NULL
     """))
 
@@ -76,15 +81,7 @@ def upgrade() -> None:
 
 def downgrade() -> None:
     """Downgrade schema."""
-    # Prepend name back into content for all rows (can't distinguish auto-generated
-    # names from extracted ones, so we restore everything).
-    op.execute(sa.text("""
-        UPDATE memories
-        SET content = name || ': ' || content
-    """))
-
     # ### commands auto generated by Alembic - please adjust! ###
     op.drop_constraint("uq_memories_name_workspace", "memories", type_="unique")
-    op.drop_index(op.f("ix_memories_name"), table_name="memories")
     op.drop_column("memories", "name")
     # ### end Alembic commands ###
diff --git a/src/memlord/api/memories.py b/src/memlord/api/memories.py
index c42ab12..d45f4ea 100644
--- a/src/memlord/api/memories.py
+++ b/src/memlord/api/memories.py
@@ -24,6 +24,7 @@
 
 _COLS = (
     Memory.id,
+    Memory.name,
     Memory.content,
     Memory.memory_type,
     Memory.created_at,
@@ -85,6 +86,7 @@ async def list_memories(
     memories = [
         MemoryItem(
             id=row["id"],
+            name=row["name"],
             content=row["content"],
             memory_type=row["memory_type"],
             created_at=row["created_at"].strftime("%Y-%m-%d %H:%M:%S"),
@@ -113,6 +115,7 @@ def _build_detail(memory, workspaces) -> MemoryDetail:
     ]
     return MemoryDetail(
         id=memory.id,
+        name=memory.name,
         content=memory.content,
         memory_type=memory.memory_type,
         created_at=memory.created_at.strftime("%Y-%m-%d %H:%M:%S"),
@@ -164,8 +167,11 @@ async def update_memory(
     }
     if new_content != existing.content:
         data["content"] = new_content
+    if body.name is not None:
+        data["name"] = body.name
 
-    await dao.update(**data)
+    _, final_name = await dao.update(**data)
+    existing.name = final_name  # type: ignore[assignment]
     existing.content = new_content
     existing.memory_type = new_type  # type: ignore[assignment]
     existing.tags = new_tags  # type: ignore[assignment]
diff --git a/src/memlord/dao/memory.py b/src/memlord/dao/memory.py
index c93cd77..8231c75 100644
--- a/src/memlord/dao/memory.py
+++ b/src/memlord/dao/memory.py
@@ -193,16 +193,20 @@ async def update(
             values["embedding"] = await embed(_embed_text(new_content, new_tags))
 
         if values:
-            await self._s.execute(update(Memory).where(Memory.id == memory_id).values(**values))
+            final_name: str = await self._s.scalar(  # type: ignore[assignment]
+                update(Memory)
+                .where(Memory.id == memory_id)
+                .values(**values)
+                .returning(Memory.name)
+            )
+        else:
+            final_name = await self._s.scalar(  # type: ignore[assignment]
+                select(Memory.name).where(Memory.id == memory_id)
+            )
 
         if tags is not _UNSET:
             await self._replace_tags(memory_id, tags)
 
-        final_name: str = (
-            values["name"]
-            if "name" in values
-            else await self._s.scalar(select(Memory.name).where(Memory.id == memory_id))  # type: ignore[assignment]
-        )
         return memory_id, final_name
 
     async def delete(self, id: int, workspace_id: int | None = None) -> None:
diff --git a/src/memlord/models/memory.py b/src/memlord/models/memory.py
index 00e2826..b150641 100644
--- a/src/memlord/models/memory.py
+++ b/src/memlord/models/memory.py
@@ -9,7 +9,7 @@ class Memory(Base):
     __tablename__ = "memories"
 
     id = sa.Column(sa.Integer, primary_key=True, autoincrement=True)
-    name = sa.Column(sa.Text, nullable=False, index=True)
+    name = sa.Column(sa.Text, nullable=False)
     content = sa.Column(sa.Text, nullable=False)
     created_by = sa.Column(sa.Integer, sa.ForeignKey("users.id"), nullable=False)
     memory_type = sa.Column(sa.String(50), nullable=False)
diff --git a/src/memlord/schemas/memory_response.py b/src/memlord/schemas/memory_response.py
index 184c2e2..005f28f 100644
--- a/src/memlord/schemas/memory_response.py
+++ b/src/memlord/schemas/memory_response.py
@@ -17,6 +17,7 @@ class WorkspaceSimple(BaseModel):
 
 class MemoryItem(BaseModel):
     id: int
+    name: str
     content: str
     memory_type: str | None
     created_at: str
@@ -27,6 +28,7 @@ class MemoryItem(BaseModel):
 
 class MemoryDetail(BaseModel):
     id: int
+    name: str
     content: str
     memory_type: str | None
     created_at: str
diff --git a/src/memlord/templates/index.html b/src/memlord/templates/index.html
index 88d842e..78b17a0 100644
--- a/src/memlord/templates/index.html
+++ b/src/memlord/templates/index.html
@@ -136,6 +136,7 @@ <h2 style="font-size:1.0625rem;font-weight:600;letter-spacing:-.02em;margin:0;">
             </div>
             <div class="card-header">
                 <a :href="'/memory/' + m.workspace_id + '/' + m.id" style="flex:1;min-width:0;color:inherit;text-decoration:none;">
+                    <div class="card-name" x-text="m.name"></div>
                     <div class="card-content" x-text="m.content.length > 280 ? m.content.slice(0, 280) + '…' : m.content"></div>
                 </a>
                 <div class="card-actions">
diff --git a/src/memlord/templates/memory.html b/src/memlord/templates/memory.html
index 53aebe1..797a4b0 100644
--- a/src/memlord/templates/memory.html
+++ b/src/memlord/templates/memory.html
@@ -21,6 +21,10 @@
                      style="font-size:.75rem;font-weight:600;color:#6366f1;margin-bottom:.75rem;letter-spacing:.03em">
                     ⬡ <span x-text="memory.workspace_name"></span>
                 </div>
+                <div style="margin-bottom:1.25rem">
+                    <div class="detail-label">Name</div>
+                    <div class="detail-content" style="font-weight:600" x-text="memory.name"></div>
+                </div>
                 <div style="margin-bottom:1.25rem">
                     <div class="detail-label">Content</div>
                     <div class="detail-content" x-text="memory.content"></div>
@@ -58,6 +62,10 @@
 
             <div class="detail-card">
                 <div class="section-title">Edit memory</div>
+                <div class="form-group">
+                    <label class="form-label">Name</label>
+                    <input class="form-input" x-model="editName">
+                </div>
                 <div class="form-group">
                     <label class="form-label">Content</label>
                     <textarea class="form-textarea" x-model="editContent" rows="6"></textarea>
@@ -96,6 +104,7 @@
         loading: true,
         successMsg: '',
         errorMsg: '',
+        editName: '',
         editContent: '',
         editType: '',
         editTags: '',
@@ -106,6 +115,7 @@
             const r = await fetch('/api/memories/' + workspaceId + '/' + memoryId);
             if (!r.ok) { this.loading = false; return; }
             this.memory = await r.json();
+            this.editName = this.memory.name;
             this.editContent = this.memory.content;
             this.editType = this.memory.memory_type || 'fact';
             this.editTags = this.memory.tags.join(', ');
@@ -126,7 +136,7 @@
             const r = await fetch('/api/memories/' + this.memory.workspace_id + '/' + this.memory.id, {
                 method: 'PUT',
                 headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ content: this.editContent, memory_type: this.editType, tags, metadata }),
+                body: JSON.stringify({ name: this.editName, content: this.editContent, memory_type: this.editType, tags, metadata }),
             });
             if (r.ok) {
                 this.memory = await r.json();
diff --git a/src/memlord/templates/search.html b/src/memlord/templates/search.html
index 2fc536c..cf1b92e 100644
--- a/src/memlord/templates/search.html
+++ b/src/memlord/templates/search.html
@@ -19,6 +19,7 @@ <h1 class="page-title" x-text="query ? 'Search results' : 'Search'"></h1>
         <div class="card" :class="m.memory_type ? 'card--' + m.memory_type : ''">
             <div class="card-header">
                 <a :href="'/memory/' + m.workspace_id + '/' + m.id" style="flex:1;min-width:0;color:inherit;text-decoration:none;">
+                    <div class="card-name" x-text="m.name"></div>
                     <div class="card-content" x-text="m.content.length > 280 ? m.content.slice(0, 280) + '…' : m.content"></div>
                 </a>
                 <span class="score-badge" x-text="m.rrf_score"></span>
diff --git a/src/memlord/tools/list_memories.py b/src/memlord/tools/list_memories.py
index 6550edf..35399bf 100644
--- a/src/memlord/tools/list_memories.py
+++ b/src/memlord/tools/list_memories.py
@@ -18,7 +18,6 @@
 _COLS = (
     Memory.id,
     Memory.name,
-    Memory.content,
     Memory.memory_type,
     Memory.extra_data.label("metadata"),
     Memory.created_at,
diff --git a/src/memlord/tools/search_by_tag.py b/src/memlord/tools/search_by_tag.py
index 4c1b5b6..a961af8 100644
--- a/src/memlord/tools/search_by_tag.py
+++ b/src/memlord/tools/search_by_tag.py
@@ -17,7 +17,6 @@
 _COLS = (
     Memory.id,
     Memory.name,
-    Memory.content,
     Memory.memory_type,
     Memory.extra_data.label("metadata"),
     Memory.created_at,

From 6c80f2b919137e6ba71a684db786561da962a5a6 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 27 Apr 2026 16:31:03 +0200
Subject: [PATCH 13/16] Refactor pagination logic by introducing a generic
 Paginated model.

---
 src/memlord/api/__init__.py            |  2 +-
 src/memlord/api/memories.py            |  6 +-----
 src/memlord/schemas/list_memories.py   |  9 +++------
 src/memlord/schemas/memory_response.py |  9 +++------
 src/memlord/schemas/pagination.py      | 17 +++++++++++++++++
 src/memlord/templates/index.html       |  4 ++--
 src/memlord/tools/list_memories.py     |  6 ------
 src/memlord/tools/search_by_tag.py     |  1 -
 src/memlord/ui/base.py                 |  2 +-
 9 files changed, 28 insertions(+), 28 deletions(-)
 create mode 100644 src/memlord/schemas/pagination.py

diff --git a/src/memlord/api/__init__.py b/src/memlord/api/__init__.py
index 10ca0d5..d567f70 100644
--- a/src/memlord/api/__init__.py
+++ b/src/memlord/api/__init__.py
@@ -4,7 +4,7 @@
 from .search import router as search_router
 from .workspaces import router as workspaces_router
 
-router = APIRouter(prefix="/api")
+router = APIRouter(prefix="/api", tags=["API"])
 router.include_router(memories_router)
 router.include_router(search_router)
 router.include_router(workspaces_router)
diff --git a/src/memlord/api/memories.py b/src/memlord/api/memories.py
index d45f4ea..e035b78 100644
--- a/src/memlord/api/memories.py
+++ b/src/memlord/api/memories.py
@@ -1,5 +1,3 @@
-import math
-
 import sqlalchemy as sa
 from fastapi import APIRouter, HTTPException
 from sqlalchemy import select
@@ -78,7 +76,6 @@ async def list_memories(
         .mappings()
         .all()
     )
-    total_pages = math.ceil(total / page_size) if total else 0
     ids = [row["id"] for row in rows]
     tags_map = await MemoryDao(s, user.id).fetch_tags(ids)
     ws_display = {ws.id: ("Personal" if ws.is_personal else ws.name) for ws in workspaces}
@@ -98,11 +95,10 @@ async def list_memories(
     ]
 
     return MemoriesResponse(
-        memories=memories,
+        items=memories,
         total=total,
         page=body.page,
         page_size=page_size,
-        total_pages=total_pages,
     )
 
 
diff --git a/src/memlord/schemas/list_memories.py b/src/memlord/schemas/list_memories.py
index 37f731b..0cb4a39 100644
--- a/src/memlord/schemas/list_memories.py
+++ b/src/memlord/schemas/list_memories.py
@@ -3,6 +3,7 @@
 from pydantic import BaseModel, ConfigDict, Field, NaiveDatetime, field_serializer
 
 from .memory_type import MemoryType
+from .pagination import Paginated
 
 
 class MemoryListItem(BaseModel):
@@ -55,9 +56,5 @@ def serialize_created_at(self, v: datetime) -> str:
         return v.replace(tzinfo=UTC).isoformat()
 
 
-class MemoryPage(BaseModel):
-    items: list[MemoryItem] = Field(default_factory=list)
-    total: int = 0
-    page: int = 1
-    page_size: int = 0
-    total_pages: int = 0
+class MemoryPage(Paginated[MemoryItem]): ...
+
diff --git a/src/memlord/schemas/memory_response.py b/src/memlord/schemas/memory_response.py
index 005f28f..5614ff1 100644
--- a/src/memlord/schemas/memory_response.py
+++ b/src/memlord/schemas/memory_response.py
@@ -1,5 +1,7 @@
 from pydantic import BaseModel
 
+from memlord.schemas.pagination import Paginated
+
 
 class MemoriesFilter(BaseModel):
     page: int = 1
@@ -39,12 +41,7 @@ class MemoryDetail(BaseModel):
     writable_workspaces: list[WorkspaceSimple]
 
 
-class MemoriesResponse(BaseModel):
-    memories: list[MemoryItem]
-    total: int
-    page: int
-    page_size: int
-    total_pages: int
+class MemoriesResponse(Paginated[MemoryItem]): ...
 
 
 class MoveRequest(BaseModel):
diff --git a/src/memlord/schemas/pagination.py b/src/memlord/schemas/pagination.py
new file mode 100644
index 0000000..1e1edbb
--- /dev/null
+++ b/src/memlord/schemas/pagination.py
@@ -0,0 +1,17 @@
+import math
+
+from pydantic import BaseModel, Field, computed_field
+
+
+class Paginated[T: BaseModel](BaseModel):
+    items: list[T] = Field(default_factory=list)
+    total: int = 0
+    page: int = 1
+    page_size: int = 0
+
+    @computed_field
+    @property
+    def total_pages(self) -> int:
+        if self.page_size:
+            return math.ceil(self.total / self.page_size)
+        return 0
diff --git a/src/memlord/templates/index.html b/src/memlord/templates/index.html
index 78b17a0..db7577c 100644
--- a/src/memlord/templates/index.html
+++ b/src/memlord/templates/index.html
@@ -189,7 +189,7 @@ <h2 style="font-size:1.0625rem;font-weight:600;letter-spacing:-.02em;margin:0;">
                 this._fetchMemories(),
                 fetch('/api/workspaces').then(r => r.json()),
             ]);
-            this.memories = mems.memories;
+            this.memories = mems.items;
             this.total = mems.total;
             this.totalPages = mems.total_pages;
             this.workspaces = wss.sort((a, b) => b.is_personal - a.is_personal);
@@ -199,7 +199,7 @@ <h2 style="font-size:1.0625rem;font-weight:600;letter-spacing:-.02em;margin:0;">
         async load() {
             this.loading = true;
             const data = await this._fetchMemories();
-            this.memories = data.memories;
+            this.memories = data.items;
             this.total = data.total;
             this.totalPages = data.total_pages;
             this.loading = false;
diff --git a/src/memlord/tools/list_memories.py b/src/memlord/tools/list_memories.py
index 35399bf..c725850 100644
--- a/src/memlord/tools/list_memories.py
+++ b/src/memlord/tools/list_memories.py
@@ -1,5 +1,3 @@
-import math
-
 from fastmcp import FastMCP
 from mcp.types import ToolAnnotations
 from pydantic import Field
@@ -66,15 +64,12 @@ async def list_memories(
 
     rows = (await s.execute(q)).mappings().all()
 
-    total_pages = math.ceil(total / page_size) if total else 0
-
     if not rows:
         return MemoryPage(
             items=[],
             total=total,
             page=page,
             page_size=page_size,
-            total_pages=total_pages,
         )
 
     ids: list[int] = [row["id"] for row in rows]
@@ -91,5 +86,4 @@ async def list_memories(
         total=total,
         page=page,
         page_size=page_size,
-        total_pages=total_pages,
     )
diff --git a/src/memlord/tools/search_by_tag.py b/src/memlord/tools/search_by_tag.py
index a961af8..9976bfc 100644
--- a/src/memlord/tools/search_by_tag.py
+++ b/src/memlord/tools/search_by_tag.py
@@ -97,5 +97,4 @@ async def search_by_tag(
         total=len(rows),
         page=1,
         page_size=len(rows),
-        total_pages=1,
     )
diff --git a/src/memlord/ui/base.py b/src/memlord/ui/base.py
index 9c64f7a..b660dbd 100644
--- a/src/memlord/ui/base.py
+++ b/src/memlord/ui/base.py
@@ -3,7 +3,7 @@
 
 from memlord.ui.utils import APIUserDep, templates
 
-router = APIRouter()
+router = APIRouter(tags=["UI"])
 
 
 @router.get("/", response_class=HTMLResponse)

From 55f5edb0dcee04c5844474a1288d3a6da3b290ce Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 27 Apr 2026 16:49:11 +0200
Subject: [PATCH 14/16] Refactor schema organization by categorizing into 'api'
 and 'tools' packages.

---
 src/memlord/schemas/__init__.py               |  24 +-
 src/memlord/schemas/api/__init__.py           |  11 +
 .../schemas/{store.py => api/import_item.py}  |  10 +-
 .../schemas/{ => api}/memory_response.py      |   0
 src/memlord/schemas/api/search.py             |  17 +
 src/memlord/schemas/{ => api}/update.py       |   2 +-
 src/memlord/schemas/search.py                 |  34 +-
 src/memlord/schemas/tools/__init__.py         |   5 +
 src/memlord/schemas/{ => tools}/delete.py     |   0
 .../schemas/{ => tools}/list_memories.py      |   5 +-
 src/memlord/schemas/{ => tools}/recall.py     |   2 +-
 src/memlord/schemas/tools/retrieve.py         |  19 +
 src/memlord/schemas/tools/store.py            |   6 +
 tests/test_rest_pipeline.py                   |   2 +-
 uv.lock                                       | 389 +++++++++---------
 15 files changed, 280 insertions(+), 246 deletions(-)
 create mode 100644 src/memlord/schemas/api/__init__.py
 rename src/memlord/schemas/{store.py => api/import_item.py} (81%)
 rename src/memlord/schemas/{ => api}/memory_response.py (100%)
 create mode 100644 src/memlord/schemas/api/search.py
 rename src/memlord/schemas/{ => api}/update.py (86%)
 create mode 100644 src/memlord/schemas/tools/__init__.py
 rename src/memlord/schemas/{ => tools}/delete.py (100%)
 rename src/memlord/schemas/{ => tools}/list_memories.py (95%)
 rename src/memlord/schemas/{ => tools}/recall.py (93%)
 create mode 100644 src/memlord/schemas/tools/retrieve.py
 create mode 100644 src/memlord/schemas/tools/store.py

diff --git a/src/memlord/schemas/__init__.py b/src/memlord/schemas/__init__.py
index a27cd01..a0b48cf 100644
--- a/src/memlord/schemas/__init__.py
+++ b/src/memlord/schemas/__init__.py
@@ -1,16 +1,26 @@
-from .delete import DeleteResult
-from .list_memories import MemoryDetail, MemoryItem, MemoryListItem, MemoryPage
-from .memory_response import (
+from .api import (
+    ImportItem,
     MemoriesFilter,
     MemoriesResponse,
     MoveRequest,
+    SearchItem,
+    SearchResponse,
+    UpdateMemoryRequest,
     WorkspaceSimple,
 )
 from .memory_type import MemoryType
-from .recall import RecallPage, RecallResult
-from .search import MemoryResult, SearchItem, SearchResponse, SearchResult
-from .store import ImportItem, StoreResult
-from .update import UpdateMemoryRequest
+from .search import SearchResult
+from .tools import (
+    DeleteResult,
+    MemoryDetail,
+    MemoryItem,
+    MemoryListItem,
+    MemoryPage,
+    MemoryResult,
+    RecallPage,
+    RecallResult,
+    StoreResult,
+)
 from .user import UserInfo
 from .workspace import (
     CreateWorkspaceRequest,
diff --git a/src/memlord/schemas/api/__init__.py b/src/memlord/schemas/api/__init__.py
new file mode 100644
index 0000000..8dc0415
--- /dev/null
+++ b/src/memlord/schemas/api/__init__.py
@@ -0,0 +1,11 @@
+from .import_item import ImportItem
+from .memory_response import (
+    MemoriesFilter,
+    MemoriesResponse,
+    MemoryDetail,
+    MemoryItem,
+    MoveRequest,
+    WorkspaceSimple,
+)
+from .search import SearchItem, SearchResponse
+from .update import UpdateMemoryRequest
diff --git a/src/memlord/schemas/store.py b/src/memlord/schemas/api/import_item.py
similarity index 81%
rename from src/memlord/schemas/store.py
rename to src/memlord/schemas/api/import_item.py
index 9a821de..c61fcdb 100644
--- a/src/memlord/schemas/store.py
+++ b/src/memlord/schemas/api/import_item.py
@@ -2,8 +2,9 @@
 
 from pydantic import BaseModel, Field, model_validator
 
-from ..utils.dt import utcnow
-from .memory_type import MemoryType
+from memlord.utils.dt import utcnow
+
+from ..memory_type import MemoryType
 
 
 class ImportItem(BaseModel):
@@ -20,8 +21,3 @@ def fill_name(cls, data: dict) -> dict:
         if not data.get("name"):
             data["name"] = (data.get("content") or "")[:60].strip()
         return data
-
-
-class StoreResult(BaseModel):
-    name: str
-    created: bool
diff --git a/src/memlord/schemas/memory_response.py b/src/memlord/schemas/api/memory_response.py
similarity index 100%
rename from src/memlord/schemas/memory_response.py
rename to src/memlord/schemas/api/memory_response.py
diff --git a/src/memlord/schemas/api/search.py b/src/memlord/schemas/api/search.py
new file mode 100644
index 0000000..4496470
--- /dev/null
+++ b/src/memlord/schemas/api/search.py
@@ -0,0 +1,17 @@
+from pydantic import BaseModel
+
+
+class SearchItem(BaseModel):
+    id: int
+    content: str
+    memory_type: str | None
+    created_at: str
+    workspace_id: int | None
+    workspace_name: str | None
+    tags: list[str]
+    rrf_score: float
+
+
+class SearchResponse(BaseModel):
+    results: list[SearchItem]
+    query: str
diff --git a/src/memlord/schemas/update.py b/src/memlord/schemas/api/update.py
similarity index 86%
rename from src/memlord/schemas/update.py
rename to src/memlord/schemas/api/update.py
index 84ca713..f67d3a2 100644
--- a/src/memlord/schemas/update.py
+++ b/src/memlord/schemas/api/update.py
@@ -1,6 +1,6 @@
 from pydantic import BaseModel
 
-from .memory_type import MemoryType
+from ..memory_type import MemoryType
 
 
 class UpdateMemoryRequest(BaseModel):
diff --git a/src/memlord/schemas/search.py b/src/memlord/schemas/search.py
index 11debf1..15b8a1e 100644
--- a/src/memlord/schemas/search.py
+++ b/src/memlord/schemas/search.py
@@ -1,6 +1,4 @@
-from datetime import UTC, datetime
-
-from pydantic import BaseModel, NaiveDatetime, field_serializer
+from pydantic import BaseModel
 
 from .memory_type import MemoryType
 
@@ -13,33 +11,3 @@ class SearchResult(BaseModel):
     rrf_score: float
     vec_similarity: float | None
     workspace: str | None = None
-
-
-class MemoryResult(BaseModel):
-    name: str
-    memory_type: MemoryType
-    tags: set[str]
-    metadata: dict
-    created_at: NaiveDatetime
-    rrf_score: float
-    workspace: str | None = None
-
-    @field_serializer("created_at")
-    def serialize_created_at(self, v: datetime) -> str:
-        return v.replace(tzinfo=UTC).isoformat()
-
-
-class SearchItem(BaseModel):
-    id: int
-    content: str
-    memory_type: str | None
-    created_at: str
-    workspace_id: int | None
-    workspace_name: str | None
-    tags: list[str]
-    rrf_score: float
-
-
-class SearchResponse(BaseModel):
-    results: list[SearchItem]
-    query: str
diff --git a/src/memlord/schemas/tools/__init__.py b/src/memlord/schemas/tools/__init__.py
new file mode 100644
index 0000000..432aacc
--- /dev/null
+++ b/src/memlord/schemas/tools/__init__.py
@@ -0,0 +1,5 @@
+from .delete import DeleteResult
+from .list_memories import MemoryDetail, MemoryItem, MemoryListItem, MemoryPage
+from .recall import RecallPage, RecallResult
+from .retrieve import MemoryResult
+from .store import StoreResult
diff --git a/src/memlord/schemas/delete.py b/src/memlord/schemas/tools/delete.py
similarity index 100%
rename from src/memlord/schemas/delete.py
rename to src/memlord/schemas/tools/delete.py
diff --git a/src/memlord/schemas/list_memories.py b/src/memlord/schemas/tools/list_memories.py
similarity index 95%
rename from src/memlord/schemas/list_memories.py
rename to src/memlord/schemas/tools/list_memories.py
index 0cb4a39..a3f7b58 100644
--- a/src/memlord/schemas/list_memories.py
+++ b/src/memlord/schemas/tools/list_memories.py
@@ -2,8 +2,8 @@
 
 from pydantic import BaseModel, ConfigDict, Field, NaiveDatetime, field_serializer
 
-from .memory_type import MemoryType
-from .pagination import Paginated
+from ..memory_type import MemoryType
+from ..pagination import Paginated
 
 
 class MemoryListItem(BaseModel):
@@ -57,4 +57,3 @@ def serialize_created_at(self, v: datetime) -> str:
 
 
 class MemoryPage(Paginated[MemoryItem]): ...
-
diff --git a/src/memlord/schemas/recall.py b/src/memlord/schemas/tools/recall.py
similarity index 93%
rename from src/memlord/schemas/recall.py
rename to src/memlord/schemas/tools/recall.py
index 3cb7459..c0226fe 100644
--- a/src/memlord/schemas/recall.py
+++ b/src/memlord/schemas/tools/recall.py
@@ -2,7 +2,7 @@
 
 from pydantic import BaseModel, Field, NaiveDatetime, field_serializer
 
-from .memory_type import MemoryType
+from ..memory_type import MemoryType
 
 
 class RecallResult(BaseModel):
diff --git a/src/memlord/schemas/tools/retrieve.py b/src/memlord/schemas/tools/retrieve.py
new file mode 100644
index 0000000..9389c6a
--- /dev/null
+++ b/src/memlord/schemas/tools/retrieve.py
@@ -0,0 +1,19 @@
+from datetime import UTC, datetime
+
+from pydantic import BaseModel, NaiveDatetime, field_serializer
+
+from ..memory_type import MemoryType
+
+
+class MemoryResult(BaseModel):
+    name: str
+    memory_type: MemoryType
+    tags: set[str]
+    metadata: dict
+    created_at: NaiveDatetime
+    rrf_score: float
+    workspace: str | None = None
+
+    @field_serializer("created_at")
+    def serialize_created_at(self, v: datetime) -> str:
+        return v.replace(tzinfo=UTC).isoformat()
diff --git a/src/memlord/schemas/tools/store.py b/src/memlord/schemas/tools/store.py
new file mode 100644
index 0000000..83db5df
--- /dev/null
+++ b/src/memlord/schemas/tools/store.py
@@ -0,0 +1,6 @@
+from pydantic import BaseModel
+
+
+class StoreResult(BaseModel):
+    name: str
+    created: bool
diff --git a/tests/test_rest_pipeline.py b/tests/test_rest_pipeline.py
index 142e885..b5622d7 100644
--- a/tests/test_rest_pipeline.py
+++ b/tests/test_rest_pipeline.py
@@ -33,7 +33,7 @@ async def test_pipeline(api_client, workspace_id):
     assert resp.status_code == 200
     body = resp.json()
     assert body["total"] == 1
-    mem = body["memories"][0]
+    mem = body["items"][0]
     mid = mem["id"]
     assert mem["content"] == "rest pipeline memory"
     assert mem["memory_type"] == "fact"
diff --git a/uv.lock b/uv.lock
index 737364d..d165dc0 100644
--- a/uv.lock
+++ b/uv.lock
@@ -108,14 +108,15 @@ wheels = [
 
 [[package]]
 name = "authlib"
-version = "1.6.9"
+version = "1.7.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "cryptography" },
+    { name = "joserfc" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/af/98/00d3dd826d46959ad8e32af2dbb2398868fd9fd0683c26e56d0789bd0e68/authlib-1.6.9.tar.gz", hash = "sha256:d8f2421e7e5980cc1ddb4e32d3f5fa659cfaf60d8eaf3281ebed192e4ab74f04", size = 165134, upload-time = "2026-03-02T07:44:01.998Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/d9/82/4d0603f30c1b4629b1f091bb266b0d7986434891d6940a8c87f8098db24e/authlib-1.7.0.tar.gz", hash = "sha256:b3e326c9aa9cc3ea95fe7d89fd880722d3608da4d00e8a27e061e64b48d801d5", size = 175890, upload-time = "2026-04-18T11:00:28.559Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/53/23/b65f568ed0c22f1efacb744d2db1a33c8068f384b8c9b482b52ebdbc3ef6/authlib-1.6.9-py2.py3-none-any.whl", hash = "sha256:f08b4c14e08f0861dc18a32357b33fbcfd2ea86cfe3fe149484b4d764c4a0ac3", size = 244197, upload-time = "2026-03-02T07:44:00.307Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/48/c954218b2a250e23f178f10167c4173fecb5a75d2c206f0a67ba58006c26/authlib-1.7.0-py2.py3-none-any.whl", hash = "sha256:e36817afb02f6f0b6bf55f150782499ddd6ddf44b402bb055d3263cc65ac9ae0", size = 258779, upload-time = "2026-04-18T11:00:26.64Z" },
 ]
 
 [[package]]
@@ -167,11 +168,11 @@ wheels = [
 
 [[package]]
 name = "cachetools"
-version = "7.0.5"
+version = "7.0.6"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/af/dd/57fe3fdb6e65b25a5987fd2cdc7e22db0aef508b91634d2e57d22928d41b/cachetools-7.0.5.tar.gz", hash = "sha256:0cd042c24377200c1dcd225f8b7b12b0ca53cc2c961b43757e774ebe190fd990", size = 37367, upload-time = "2026-03-09T20:51:29.451Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/76/7b/1755ed2c6bfabd1d98b37ae73152f8dcf94aa40fee119d163c19ed484704/cachetools-7.0.6.tar.gz", hash = "sha256:e5d524d36d65703a87243a26ff08ad84f73352adbeafb1cde81e207b456aaf24", size = 37526, upload-time = "2026-04-20T19:02:23.289Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/06/f3/39cf3367b8107baa44f861dc802cbf16263c945b62d8265d36034fc07bea/cachetools-7.0.5-py3-none-any.whl", hash = "sha256:46bc8ebefbe485407621d0a4264b23c080cedd913921bad7ac3ed2f26c183114", size = 13918, upload-time = "2026-03-09T20:51:27.33Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/c4/cf76242a5da1410917107ff14551764aa405a5fd10cd10cf9a5ca8fa77f4/cachetools-7.0.6-py3-none-any.whl", hash = "sha256:4e94956cfdd3086f12042cdd29318f5ced3893014f7d0d059bf3ead3f85b7f8b", size = 13976, upload-time = "2026-04-20T19:02:21.187Z" },
 ]
 
 [[package]]
@@ -189,11 +190,11 @@ wheels = [
 
 [[package]]
 name = "certifi"
-version = "2026.2.25"
+version = "2026.4.22"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/af/2d/7bf41579a8986e348fa033a31cdd0e4121114f6bce2457e8876010b092dd/certifi-2026.2.25.tar.gz", hash = "sha256:e887ab5cee78ea814d3472169153c2d12cd43b14bd03329a39a9c6e2e80bfba7", size = 155029, upload-time = "2026-02-25T02:54:17.342Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/25/ee/6caf7a40c36a1220410afe15a1cc64993a1f864871f698c0f93acb72842a/certifi-2026.4.22.tar.gz", hash = "sha256:8d455352a37b71bf76a79caa83a3d6c25afee4a385d632127b6afb3963f1c580", size = 137077, upload-time = "2026-04-22T11:26:11.191Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/9a/3c/c17fb3ca2d9c3acff52e30b309f538586f9f5b9c9cf454f3845fc9af4881/certifi-2026.2.25-py3-none-any.whl", hash = "sha256:027692e4402ad994f1c42e52a4997a9763c646b73e4096e4d5d6db8af1d6f0fa", size = 153684, upload-time = "2026-02-25T02:54:15.766Z" },
+    { url = "https://files.pythonhosted.org/packages/22/30/7cd8fdcdfbc5b869528b079bfb76dcdf6056b1a2097a662e5e8c04f42965/certifi-2026.4.22-py3-none-any.whl", hash = "sha256:3cb2210c8f88ba2318d29b0388d1023c8492ff72ecdde4ebdaddbb13a31b1c4a", size = 135707, upload-time = "2026-04-22T11:26:09.372Z" },
 ]
 
 [[package]]
@@ -221,14 +222,14 @@ wheels = [
 
 [[package]]
 name = "click"
-version = "8.3.2"
+version = "8.3.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "colorama", marker = "sys_platform == 'win32'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/57/75/31212c6bf2503fdf920d87fee5d7a86a2e3bcf444984126f13d8e4016804/click-8.3.2.tar.gz", hash = "sha256:14162b8b3b3550a7d479eafa77dfd3c38d9dc8951f6f69c78913a8f9a7540fd5", size = 302856, upload-time = "2026-04-03T19:14:45.118Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/bb/63/f9e1ea081ce35720d8b92acde70daaedace594dc93b693c869e0d5910718/click-8.3.3.tar.gz", hash = "sha256:398329ad4837b2ff7cbe1dd166a4c0f8900c3ca3a218de04466f38f6497f18a2", size = 328061, upload-time = "2026-04-22T15:11:27.506Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/e4/20/71885d8b97d4f3dde17b1fdb92dbd4908b00541c5a3379787137285f602e/click-8.3.2-py3-none-any.whl", hash = "sha256:1924d2c27c5653561cd2cae4548d1406039cb79b858b747cfea24924bbc1616d", size = 108379, upload-time = "2026-04-03T19:14:43.505Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/44/c1221527f6a71a01ec6fbad7fa78f1d50dfa02217385cf0fa3eec7087d59/click-8.3.3-py3-none-any.whl", hash = "sha256:a2bf429bb3033c89fa4936ffb35d5cb471e3719e1f3c8a7c3fff0b8314305613", size = 110502, upload-time = "2026-04-22T15:11:25.044Z" },
 ]
 
 [[package]]
@@ -266,46 +267,46 @@ wheels = [
 
 [[package]]
 name = "cryptography"
-version = "46.0.6"
+version = "47.0.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "cffi", marker = "platform_python_implementation != 'PyPy'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/a4/ba/04b1bd4218cbc58dc90ce967106d51582371b898690f3ae0402876cc4f34/cryptography-46.0.6.tar.gz", hash = "sha256:27550628a518c5c6c903d84f637fbecf287f6cb9ced3804838a1295dc1fd0759", size = 750542, upload-time = "2026-03-25T23:34:53.396Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/47/23/9285e15e3bc57325b0a72e592921983a701efc1ee8f91c06c5f0235d86d9/cryptography-46.0.6-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:64235194bad039a10bb6d2d930ab3323baaec67e2ce36215fd0952fad0930ca8", size = 7176401, upload-time = "2026-03-25T23:33:22.096Z" },
-    { url = "https://files.pythonhosted.org/packages/60/f8/e61f8f13950ab6195b31913b42d39f0f9afc7d93f76710f299b5ec286ae6/cryptography-46.0.6-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:26031f1e5ca62fcb9d1fcb34b2b60b390d1aacaa15dc8b895a9ed00968b97b30", size = 4275275, upload-time = "2026-03-25T23:33:23.844Z" },
-    { url = "https://files.pythonhosted.org/packages/19/69/732a736d12c2631e140be2348b4ad3d226302df63ef64d30dfdb8db7ad1c/cryptography-46.0.6-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:9a693028b9cbe51b5a1136232ee8f2bc242e4e19d456ded3fa7c86e43c713b4a", size = 4425320, upload-time = "2026-03-25T23:33:25.703Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/12/123be7292674abf76b21ac1fc0e1af50661f0e5b8f0ec8285faac18eb99e/cryptography-46.0.6-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:67177e8a9f421aa2d3a170c3e56eca4e0128883cf52a071a7cbf53297f18b175", size = 4278082, upload-time = "2026-03-25T23:33:27.423Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/ba/d5e27f8d68c24951b0a484924a84c7cdaed7502bac9f18601cd357f8b1d2/cryptography-46.0.6-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:d9528b535a6c4f8ff37847144b8986a9a143585f0540fbcb1a98115b543aa463", size = 4926514, upload-time = "2026-03-25T23:33:29.206Z" },
-    { url = "https://files.pythonhosted.org/packages/34/71/1ea5a7352ae516d5512d17babe7e1b87d9db5150b21f794b1377eac1edc0/cryptography-46.0.6-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:22259338084d6ae497a19bae5d4c66b7ca1387d3264d1c2c0e72d9e9b6a77b97", size = 4457766, upload-time = "2026-03-25T23:33:30.834Z" },
-    { url = "https://files.pythonhosted.org/packages/01/59/562be1e653accee4fdad92c7a2e88fced26b3fdfce144047519bbebc299e/cryptography-46.0.6-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:760997a4b950ff00d418398ad73fbc91aa2894b5c1db7ccb45b4f68b42a63b3c", size = 3986535, upload-time = "2026-03-25T23:33:33.02Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/8b/b1ebfeb788bf4624d36e45ed2662b8bd43a05ff62157093c1539c1288a18/cryptography-46.0.6-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:3dfa6567f2e9e4c5dceb8ccb5a708158a2a871052fa75c8b78cb0977063f1507", size = 4277618, upload-time = "2026-03-25T23:33:34.567Z" },
-    { url = "https://files.pythonhosted.org/packages/dd/52/a005f8eabdb28df57c20f84c44d397a755782d6ff6d455f05baa2785bd91/cryptography-46.0.6-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:cdcd3edcbc5d55757e5f5f3d330dd00007ae463a7e7aa5bf132d1f22a4b62b19", size = 4890802, upload-time = "2026-03-25T23:33:37.034Z" },
-    { url = "https://files.pythonhosted.org/packages/ec/4d/8e7d7245c79c617d08724e2efa397737715ca0ec830ecb3c91e547302555/cryptography-46.0.6-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:d4e4aadb7fc1f88687f47ca20bb7227981b03afaae69287029da08096853b738", size = 4457425, upload-time = "2026-03-25T23:33:38.904Z" },
-    { url = "https://files.pythonhosted.org/packages/1d/5c/f6c3596a1430cec6f949085f0e1a970638d76f81c3ea56d93d564d04c340/cryptography-46.0.6-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:2b417edbe8877cda9022dde3a008e2deb50be9c407eef034aeeb3a8b11d9db3c", size = 4405530, upload-time = "2026-03-25T23:33:40.842Z" },
-    { url = "https://files.pythonhosted.org/packages/7e/c9/9f9cea13ee2dbde070424e0c4f621c091a91ffcc504ffea5e74f0e1daeff/cryptography-46.0.6-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:380343e0653b1c9d7e1f55b52aaa2dbb2fdf2730088d48c43ca1c7c0abb7cc2f", size = 4667896, upload-time = "2026-03-25T23:33:42.781Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/b5/1895bc0821226f129bc74d00eccfc6a5969e2028f8617c09790bf89c185e/cryptography-46.0.6-cp311-abi3-win32.whl", hash = "sha256:bcb87663e1f7b075e48c3be3ecb5f0b46c8fc50b50a97cf264e7f60242dca3f2", size = 3026348, upload-time = "2026-03-25T23:33:45.021Z" },
-    { url = "https://files.pythonhosted.org/packages/c3/f8/c9bcbf0d3e6ad288b9d9aa0b1dee04b063d19e8c4f871855a03ab3a297ab/cryptography-46.0.6-cp311-abi3-win_amd64.whl", hash = "sha256:6739d56300662c468fddb0e5e291f9b4d084bead381667b9e654c7dd81705124", size = 3483896, upload-time = "2026-03-25T23:33:46.649Z" },
-    { url = "https://files.pythonhosted.org/packages/c4/cc/f330e982852403da79008552de9906804568ae9230da8432f7496ce02b71/cryptography-46.0.6-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:12cae594e9473bca1a7aceb90536060643128bb274fcea0fc459ab90f7d1ae7a", size = 7162776, upload-time = "2026-03-25T23:34:13.308Z" },
-    { url = "https://files.pythonhosted.org/packages/49/b3/dc27efd8dcc4bff583b3f01d4a3943cd8b5821777a58b3a6a5f054d61b79/cryptography-46.0.6-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:639301950939d844a9e1c4464d7e07f902fe9a7f6b215bb0d4f28584729935d8", size = 4270529, upload-time = "2026-03-25T23:34:15.019Z" },
-    { url = "https://files.pythonhosted.org/packages/e6/05/e8d0e6eb4f0d83365b3cb0e00eb3c484f7348db0266652ccd84632a3d58d/cryptography-46.0.6-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:ed3775295fb91f70b4027aeba878d79b3e55c0b3e97eaa4de71f8f23a9f2eb77", size = 4414827, upload-time = "2026-03-25T23:34:16.604Z" },
-    { url = "https://files.pythonhosted.org/packages/2f/97/daba0f5d2dc6d855e2dcb70733c812558a7977a55dd4a6722756628c44d1/cryptography-46.0.6-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:8927ccfbe967c7df312ade694f987e7e9e22b2425976ddbf28271d7e58845290", size = 4271265, upload-time = "2026-03-25T23:34:18.586Z" },
-    { url = "https://files.pythonhosted.org/packages/89/06/fe1fce39a37ac452e58d04b43b0855261dac320a2ebf8f5260dd55b201a9/cryptography-46.0.6-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:b12c6b1e1651e42ab5de8b1e00dc3b6354fdfd778e7fa60541ddacc27cd21410", size = 4916800, upload-time = "2026-03-25T23:34:20.561Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/8a/b14f3101fe9c3592603339eb5d94046c3ce5f7fc76d6512a2d40efd9724e/cryptography-46.0.6-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:063b67749f338ca9c5a0b7fe438a52c25f9526b851e24e6c9310e7195aad3b4d", size = 4448771, upload-time = "2026-03-25T23:34:22.406Z" },
-    { url = "https://files.pythonhosted.org/packages/01/b3/0796998056a66d1973fd52ee89dc1bb3b6581960a91ad4ac705f182d398f/cryptography-46.0.6-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:02fad249cb0e090b574e30b276a3da6a149e04ee2f049725b1f69e7b8351ec70", size = 3978333, upload-time = "2026-03-25T23:34:24.281Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/3d/db200af5a4ffd08918cd55c08399dc6c9c50b0bc72c00a3246e099d3a849/cryptography-46.0.6-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:7e6142674f2a9291463e5e150090b95a8519b2fb6e6aaec8917dd8d094ce750d", size = 4271069, upload-time = "2026-03-25T23:34:25.895Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/18/61acfd5b414309d74ee838be321c636fe71815436f53c9f0334bf19064fa/cryptography-46.0.6-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:456b3215172aeefb9284550b162801d62f5f264a081049a3e94307fe20792cfa", size = 4878358, upload-time = "2026-03-25T23:34:27.67Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/65/5bf43286d566f8171917cae23ac6add941654ccf085d739195a4eacf1674/cryptography-46.0.6-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:341359d6c9e68834e204ceaf25936dffeafea3829ab80e9503860dcc4f4dac58", size = 4448061, upload-time = "2026-03-25T23:34:29.375Z" },
-    { url = "https://files.pythonhosted.org/packages/e0/25/7e49c0fa7205cf3597e525d156a6bce5b5c9de1fd7e8cb01120e459f205a/cryptography-46.0.6-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:9a9c42a2723999a710445bc0d974e345c32adfd8d2fac6d8a251fa829ad31cfb", size = 4399103, upload-time = "2026-03-25T23:34:32.036Z" },
-    { url = "https://files.pythonhosted.org/packages/44/46/466269e833f1c4718d6cd496ffe20c56c9c8d013486ff66b4f69c302a68d/cryptography-46.0.6-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:6617f67b1606dfd9fe4dbfa354a9508d4a6d37afe30306fe6c101b7ce3274b72", size = 4659255, upload-time = "2026-03-25T23:34:33.679Z" },
-    { url = "https://files.pythonhosted.org/packages/0a/09/ddc5f630cc32287d2c953fc5d32705e63ec73e37308e5120955316f53827/cryptography-46.0.6-cp38-abi3-win32.whl", hash = "sha256:7f6690b6c55e9c5332c0b59b9c8a3fb232ebf059094c17f9019a51e9827df91c", size = 3010660, upload-time = "2026-03-25T23:34:35.418Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/82/ca4893968aeb2709aacfb57a30dec6fa2ab25b10fa9f064b8882ce33f599/cryptography-46.0.6-cp38-abi3-win_amd64.whl", hash = "sha256:79e865c642cfc5c0b3eb12af83c35c5aeff4fa5c672dc28c43721c2c9fdd2f0f", size = 3471160, upload-time = "2026-03-25T23:34:37.191Z" },
+sdist = { url = "https://files.pythonhosted.org/packages/ef/b2/7ffa7fe8207a8c42147ffe70c3e360b228160c1d85dc3faff16aaa3244c0/cryptography-47.0.0.tar.gz", hash = "sha256:9f8e55fe4e63613a5e1cc5819030f27b97742d720203a087802ce4ce9ceb52bb", size = 830863, upload-time = "2026-04-24T19:54:57.056Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a4/98/40dfe932134bdcae4f6ab5927c87488754bf9eb79297d7e0070b78dd58e9/cryptography-47.0.0-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:160ad728f128972d362e714054f6ba0067cab7fb350c5202a9ae8ae4ce3ef1a0", size = 7912214, upload-time = "2026-04-24T19:53:03.864Z" },
+    { url = "https://files.pythonhosted.org/packages/34/c6/2733531243fba725f58611b918056b277692f1033373dcc8bd01af1c05d4/cryptography-47.0.0-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b9a8943e359b7615db1a3ba587994618e094ff3d6fa5a390c73d079ce18b3973", size = 4644617, upload-time = "2026-04-24T19:53:06.909Z" },
+    { url = "https://files.pythonhosted.org/packages/00/e3/b27be1a670a9b87f855d211cf0e1174a5d721216b7616bd52d8581d912ed/cryptography-47.0.0-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:f5c15764f261394b22aef6b00252f5195f46f2ca300bec57149474e2538b31f8", size = 4668186, upload-time = "2026-04-24T19:53:09.053Z" },
+    { url = "https://files.pythonhosted.org/packages/81/b9/8443cfe5d17d482d348cee7048acf502bb89a51b6382f06240fd290d4ca3/cryptography-47.0.0-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:9c59ab0e0fa3a180a5a9c59f3a5abe3ef90d474bc56d7fadfbe80359491b615b", size = 4651244, upload-time = "2026-04-24T19:53:11.217Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/5e/13ed0cdd0eb88ba159d6dd5ebfece8cb901dbcf1ae5ac4072e28b55d3153/cryptography-47.0.0-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:34b4358b925a5ea3e14384ca781a2c0ef7ac219b57bb9eacc4457078e2b19f92", size = 5252906, upload-time = "2026-04-24T19:53:13.532Z" },
+    { url = "https://files.pythonhosted.org/packages/64/16/ed058e1df0f33d440217cd120d41d5dda9dd215a80b8187f68483185af82/cryptography-47.0.0-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:0024b87d47ae2399165a6bfb20d24888881eeab83ae2566d62467c5ff0030ce7", size = 4701842, upload-time = "2026-04-24T19:53:15.618Z" },
+    { url = "https://files.pythonhosted.org/packages/02/e0/3d30986b30fdbd9e969abbdf8ba00ed0618615144341faeb57f395a084fe/cryptography-47.0.0-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:1e47422b5557bb82d3fff997e8d92cff4e28b9789576984f08c248d2b3535d93", size = 4289313, upload-time = "2026-04-24T19:53:17.755Z" },
+    { url = "https://files.pythonhosted.org/packages/df/fd/32db38e3ad0cb331f0691cb4c7a8a6f176f679124dee746b3af6633db4d9/cryptography-47.0.0-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:6f29f36582e6151d9686235e586dd35bb67491f024767d10b842e520dc6a07ac", size = 4650964, upload-time = "2026-04-24T19:53:20.062Z" },
+    { url = "https://files.pythonhosted.org/packages/86/53/5395d944dfd48cb1f67917f533c609c34347185ef15eb4308024c876f274/cryptography-47.0.0-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:a9b761f012a943b7de0e828843c5688d0de94a0578d44d6c85a1bae32f87791f", size = 5207817, upload-time = "2026-04-24T19:53:22.498Z" },
+    { url = "https://files.pythonhosted.org/packages/34/4f/e5711b28e1901f7d480a2b1b688b645aa4c77c73f10731ed17e7f7db3f0d/cryptography-47.0.0-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:4e1de79e047e25d6e9f8cea71c86b4a53aced64134f0f003bbcbf3655fd172c8", size = 4701544, upload-time = "2026-04-24T19:53:24.356Z" },
+    { url = "https://files.pythonhosted.org/packages/22/22/c8ddc25de3010fc8da447648f5a092c40e7a8fadf01dd6d255d9c0b9373d/cryptography-47.0.0-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:ef6b3634087f18d2155b1e8ce264e5345a753da2c5fa9815e7d41315c90f8318", size = 4783536, upload-time = "2026-04-24T19:53:26.665Z" },
+    { url = "https://files.pythonhosted.org/packages/66/b6/d4a68f4ea999c6d89e8498579cba1c5fcba4276284de7773b17e4fa69293/cryptography-47.0.0-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:11dbb9f50a0f1bb9757b3d8c27c1101780efb8f0bdecfb12439c22a74d64c001", size = 4926106, upload-time = "2026-04-24T19:53:28.686Z" },
+    { url = "https://files.pythonhosted.org/packages/54/ed/5f524db1fade9c013aa618e1c99c6ed05e8ffc9ceee6cda22fed22dda3f4/cryptography-47.0.0-cp311-abi3-win32.whl", hash = "sha256:7fda2f02c9015db3f42bb8a22324a454516ed10a8c29ca6ece6cdbb5efe2a203", size = 3258581, upload-time = "2026-04-24T19:53:31.058Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/dc/1b901990b174786569029f67542b3edf72ac068b6c3c8683c17e6a2f5363/cryptography-47.0.0-cp311-abi3-win_amd64.whl", hash = "sha256:f5c3296dab66202f1b18a91fa266be93d6aa0c2806ea3d67762c69f60adc71aa", size = 3775309, upload-time = "2026-04-24T19:53:33.054Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/34/a4fae8ae7c3bc227460c9ae43f56abf1b911da0ec29e0ebac53bb0a4b6b7/cryptography-47.0.0-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:14432c8a9bcb37009784f9594a62fae211a2ae9543e96c92b2a8e4c3cd5cd0c4", size = 7904072, upload-time = "2026-04-24T19:54:06.411Z" },
+    { url = "https://files.pythonhosted.org/packages/01/64/d7b1e54fdb69f22d24a64bb3e88dc718b31c7fb10ef0b9691a3cf7eeea6e/cryptography-47.0.0-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:07efe86201817e7d3c18781ca9770bc0db04e1e48c994be384e4602bc38f8f27", size = 4635767, upload-time = "2026-04-24T19:54:08.519Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/7b/cca826391fb2a94efdcdfe4631eb69306ee1cff0b22f664a412c90713877/cryptography-47.0.0-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:2b45761c6ec22b7c726d6a829558777e32d0f1c8be7c3f3480f9c912d5ee8a10", size = 4654350, upload-time = "2026-04-24T19:54:10.795Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/65/4b57bcc823f42a991627c51c2f68c9fd6eb1393c1756aac876cba2accae2/cryptography-47.0.0-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:edd4da498015da5b9f26d38d3bfc2e90257bfa9cbed1f6767c282a0025ae649b", size = 4643394, upload-time = "2026-04-24T19:54:13.275Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/c4/2c5fbeea70adbbca2bbae865e1d605d6a4a7f8dbd9d33eaf69645087f06c/cryptography-47.0.0-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:9af828c0d5a65c70ec729cd7495a4bf1a67ecb66417b8f02ff125ab8a6326a74", size = 5225777, upload-time = "2026-04-24T19:54:15.18Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/b8/ac57107ef32749d2b244e36069bb688792a363aaaa3acc9e3cf84c130315/cryptography-47.0.0-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:256d07c78a04d6b276f5df935a9923275f53bd1522f214447fdf365494e2d515", size = 4688771, upload-time = "2026-04-24T19:54:17.835Z" },
+    { url = "https://files.pythonhosted.org/packages/56/fc/9f1de22ff8be99d991f240a46863c52d475404c408886c5a38d2b5c3bb26/cryptography-47.0.0-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:5d0e362ff51041b0c0d219cc7d6924d7b8996f57ce5712bdcef71eb3c65a59cc", size = 4270753, upload-time = "2026-04-24T19:54:19.963Z" },
+    { url = "https://files.pythonhosted.org/packages/00/68/d70c852797aa68e8e48d12e5a87170c43f67bb4a59403627259dd57d15de/cryptography-47.0.0-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:1581aef4219f7ca2849d0250edaa3866212fb74bf5667284f46aa92f9e65c1ca", size = 4642911, upload-time = "2026-04-24T19:54:21.818Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/51/661cbee74f594c5d97ff82d34f10d5551c085ca4668645f4606ebd22bd5d/cryptography-47.0.0-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:a49a3eb5341b9503fa3000a9a0db033161db90d47285291f53c2a9d2cd1b7f76", size = 5181411, upload-time = "2026-04-24T19:54:24.376Z" },
+    { url = "https://files.pythonhosted.org/packages/94/87/f2b6c374a82cf076cfa1416992ac8e8ec94d79facc37aec87c1a5cb72352/cryptography-47.0.0-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:2207a498b03275d0051589e326b79d4cf59985c99031b05bb292ac52631c37fe", size = 4688262, upload-time = "2026-04-24T19:54:26.946Z" },
+    { url = "https://files.pythonhosted.org/packages/14/e2/8b7462f4acf21ec509616f0245018bb197194ab0b65c2ea21a0bdd53c0eb/cryptography-47.0.0-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:7a02675e2fabd0c0fc04c868b8781863cbf1967691543c22f5470500ff840b31", size = 4775506, upload-time = "2026-04-24T19:54:28.926Z" },
+    { url = "https://files.pythonhosted.org/packages/70/75/158e494e4c08dc05e039da5bb48553826bd26c23930cf8d3cd5f21fa8921/cryptography-47.0.0-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:80887c5cbd1774683cb126f0ab4184567f080071d5acf62205acb354b4b753b7", size = 4912060, upload-time = "2026-04-24T19:54:30.869Z" },
+    { url = "https://files.pythonhosted.org/packages/06/bd/0a9d3edbf5eadbac926d7b9b3cd0c4be584eeeae4a003d24d9eda4affbbd/cryptography-47.0.0-cp38-abi3-win32.whl", hash = "sha256:ed67ea4e0cfb5faa5bc7ecb6e2b8838f3807a03758eec239d6c21c8769355310", size = 3248487, upload-time = "2026-04-24T19:54:33.494Z" },
+    { url = "https://files.pythonhosted.org/packages/60/80/5681af756d0da3a599b7bdb586fac5a1540f1bcefd2717a20e611ddade45/cryptography-47.0.0-cp38-abi3-win_amd64.whl", hash = "sha256:835d2d7f47cdc53b3224e90810fb1d36ca94ea29cc1801fb4c1bc43876735769", size = 3755737, upload-time = "2026-04-24T19:54:35.408Z" },
 ]
 
 [[package]]
 name = "cyclopts"
-version = "4.10.1"
+version = "4.11.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "attrs" },
@@ -313,9 +314,9 @@ dependencies = [
     { name = "rich" },
     { name = "rich-rst" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/6c/c4/2ce2ca1451487dc7d59f09334c3fa1182c46cfcf0a2d5f19f9b26d53ac74/cyclopts-4.10.1.tar.gz", hash = "sha256:ad4e4bb90576412d32276b14a76f55d43353753d16217f2c3cd5bdceba7f15a0", size = 166623, upload-time = "2026-03-23T14:43:01.098Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/fa/eff8f1abae783bade9b5e9bafafd0040d4dbf51988f9384bfdc0326ba1fc/cyclopts-4.11.0.tar.gz", hash = "sha256:1ffcb9990dbd56b90da19980d31596de9e99019980a215a5d76cf88fe452e94d", size = 170690, upload-time = "2026-04-23T00:23:36.858Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/8a/0b/2261922126b2e50c601fe22d7ff5194e0a4d50e654836260c0665e24d862/cyclopts-4.10.1-py3-none-any.whl", hash = "sha256:35f37257139380a386d9fe4475e1e7c87ca7795765ef4f31abba579fcfcb6ecd", size = 204331, upload-time = "2026-03-23T14:43:02.625Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/37/197db187c260d24d4be1f09d427f59f3fb9a89bcf1354e23865c7bff7607/cyclopts-4.11.0-py3-none-any.whl", hash = "sha256:34318e3823b44b5baa754a5e37ec70a5c17dc81c65e4295ed70e17bc1aeae50d", size = 208494, upload-time = "2026-04-23T00:23:34.948Z" },
 ]
 
 [[package]]
@@ -344,11 +345,11 @@ wheels = [
 
 [[package]]
 name = "docstring-parser"
-version = "0.17.0"
+version = "0.18.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/b2/9d/c3b43da9515bd270df0f80548d9944e389870713cc1fe2b8fb35fe2bcefd/docstring_parser-0.17.0.tar.gz", hash = "sha256:583de4a309722b3315439bb31d64ba3eebada841f2e2cee23b99df001434c912", size = 27442, upload-time = "2025-07-21T07:35:01.868Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/4d/f332313098c1de1b2d2ff91cf2674415cc7cddab2ca1b01ae29774bd5fdf/docstring_parser-0.18.0.tar.gz", hash = "sha256:292510982205c12b1248696f44959db3cdd1740237a968ea1e2e7a900eeb2015", size = 29341, upload-time = "2026-04-14T04:09:19.867Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/55/e2/2537ebcff11c1ee1ff17d8d0b6f4db75873e3b0fb32c2d4a2ee31ecb310a/docstring_parser-0.17.0-py3-none-any.whl", hash = "sha256:cf2569abd23dce8099b300f9b4fa8191e9582dda731fd533daf54c4551658708", size = 36896, upload-time = "2025-07-21T07:35:00.684Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/5f/ed01f9a3cdffbd5a008556fc7b2a08ddb1cc6ace7effa7340604b1d16699/docstring_parser-0.18.0-py3-none-any.whl", hash = "sha256:b3fcbed555c47d8479be0796ef7e19c2670d428d72e96da63f3a40122860374b", size = 22484, upload-time = "2026-04-14T04:09:18.638Z" },
 ]
 
 [[package]]
@@ -396,7 +397,7 @@ wheels = [
 
 [[package]]
 name = "fastapi"
-version = "0.135.3"
+version = "0.136.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "annotated-doc" },
@@ -405,9 +406,9 @@ dependencies = [
     { name = "typing-extensions" },
     { name = "typing-inspection" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/f7/e6/7adb4c5fa231e82c35b8f5741a9f2d055f520c29af5546fd70d3e8e1cd2e/fastapi-0.135.3.tar.gz", hash = "sha256:bd6d7caf1a2bdd8d676843cdcd2287729572a1ef524fc4d65c17ae002a1be654", size = 396524, upload-time = "2026-04-01T16:23:58.188Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/5d/45/c130091c2dfa061bbfe3150f2a5091ef1adf149f2a8d2ae769ecaf6e99a2/fastapi-0.136.1.tar.gz", hash = "sha256:7af665ad7acfa0a3baf8983d393b6b471b9da10ede59c60045f49fbc89a0fa7f", size = 397448, upload-time = "2026-04-23T16:49:44.046Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/84/a4/5caa2de7f917a04ada20018eccf60d6cc6145b0199d55ca3711b0fc08312/fastapi-0.135.3-py3-none-any.whl", hash = "sha256:9b0f590c813acd13d0ab43dd8494138eb58e484bfac405db1f3187cfc5810d98", size = 117734, upload-time = "2026-04-01T16:23:59.328Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/ff/2e4eca3ade2c22fe1dea7043b8ee9dabe47753349eb1b56a202de8af6349/fastapi-0.136.1-py3-none-any.whl", hash = "sha256:a6e9d7eeada96c93a4d69cb03836b44fa34e2854accb7244a1ece36cd4781c3f", size = 117683, upload-time = "2026-04-23T16:49:42.437Z" },
 ]
 
 [package.optional-dependencies]
@@ -446,7 +447,7 @@ standard = [
 
 [[package]]
 name = "fastapi-cloud-cli"
-version = "0.16.0"
+version = "0.17.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "fastar" },
@@ -458,43 +459,44 @@ dependencies = [
     { name = "typer" },
     { name = "uvicorn", extra = ["standard"] },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/75/9b/4c6508ac4d7c080ae35d633172870c7ae5f5cec17e06271172963f1015c8/fastapi_cloud_cli-0.16.0.tar.gz", hash = "sha256:2f785a4d7890734bff977c4cc2ac05204e822198f053c677b135ba716895ee4f", size = 46227, upload-time = "2026-04-07T13:42:21.055Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/96/57/cee8e91b83f39e75ae5562a2237261442a8179dcb3b631c7398113157398/fastapi_cloud_cli-0.17.1.tar.gz", hash = "sha256:0baece208fa88063bec46dccb5fb512f3199162092165e57654b44e64adbc44d", size = 47409, upload-time = "2026-04-27T13:38:07.094Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/85/70/c9667c61191a296a93d2e8717b47162af1b666e252750b1bbb80c15c9526/fastapi_cloud_cli-0.16.0-py3-none-any.whl", hash = "sha256:ebfa3bc0f1077a89ef7c258fba4c23fe2acc7e15e96dd089b59c630559e018d0", size = 33205, upload-time = "2026-04-07T13:42:19.594Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/a0/e252b68cf155409afabea037ab2971f41509481838847f6503fe890884ea/fastapi_cloud_cli-0.17.1-py3-none-any.whl", hash = "sha256:325e0199bdac7cb86f5df4f4a1d2070054095588088ef7b923a60cec458dcd63", size = 34046, upload-time = "2026-04-27T13:38:08.319Z" },
 ]
 
 [[package]]
 name = "fastar"
-version = "0.9.0"
+version = "0.11.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/dd/00/dab9ca274cf1fde19223fea7104631bea254751026e75bf99f2b6d0d1568/fastar-0.9.0.tar.gz", hash = "sha256:d49114d5f0b76c5cc242875d90fa4706de45e0456ddedf416608ecd0787fb410", size = 70124, upload-time = "2026-03-20T14:26:34.503Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/03/0f/0aeb3fc50046617702acc0078b277b58367fd62eb727b9ec733ae0e8bbcc/fastar-0.11.0.tar.gz", hash = "sha256:aa7f100f7313c03fdb20f1385927ba95671071ba308ad0c1763fef295e1895ce", size = 70238, upload-time = "2026-04-13T17:11:17.143Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/4d/9b/300bc0dafa8495718976076db216f42d57b251a582589566a63b4ed2cb82/fastar-0.9.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:7a8b5daa50d9b4c07367dffc40880467170bf1c31ca63a2286506edbe6d3d65b", size = 706914, upload-time = "2026-03-20T14:25:32.501Z" },
-    { url = "https://files.pythonhosted.org/packages/95/97/f1e34c8224dc373c6fab5b33e33be0d184751fdc27013af3278b1e4e6e6c/fastar-0.9.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:9ec841a69fea73361c6df6d9183915c09e9ce3bd96493763fa46019e79918400", size = 627422, upload-time = "2026-03-20T14:25:20.318Z" },
-    { url = "https://files.pythonhosted.org/packages/a9/ad/e2499d136e24c2d896f2ec58183c91c6f8185d758177537724ed2f3e1b54/fastar-0.9.0-cp312-cp312-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:ad46bc23040142e9be4b4005ea366834dbf0f1b6a90b8ecdc3ec96c42dec4adf", size = 865265, upload-time = "2026-03-20T14:24:55.418Z" },
-    { url = "https://files.pythonhosted.org/packages/fe/cf/b6ad68b2ab1d7b74b0d38725d817418016bdd64880b36108be80d2460b4d/fastar-0.9.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:de264da9e8ef6407aa0b23c7c47ed4e34fde867e7c1f6e3cb98945a93e5f89f2", size = 760583, upload-time = "2026-03-20T14:23:50.447Z" },
-    { url = "https://files.pythonhosted.org/packages/b8/96/086116ad46e3b98f6c217919d680e619f2857ffa6b5cc0d7e46e4f214b83/fastar-0.9.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:75c70be3a7da3ff9342f64c15ec3749c13ef56bc28e69075d82d03768532a8d0", size = 758000, upload-time = "2026-03-20T14:24:03.471Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/e6/ea642ea61eea98d609343080399a296a9ff132bd0492a6638d6e0d9e41a7/fastar-0.9.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4a734506b071d2a8844771fe735fbd6d67dd0eec80eef5f189bbe763ebe7a0b8", size = 923647, upload-time = "2026-03-20T14:24:16.875Z" },
-    { url = "https://files.pythonhosted.org/packages/c6/3e/53874aad61e4a664af555a2aa7a52fe46cfadd423db0e592fa0cfe0fa668/fastar-0.9.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8eac084ab215aaf65fa406c9b9da1ac4e697c3d3a1a183e09c488e555802f62d", size = 816528, upload-time = "2026-03-20T14:24:42.048Z" },
-    { url = "https://files.pythonhosted.org/packages/41/df/d663214d35380b07a24a796c48d7d7d4dc3a28ec0756edbcb7e2a81dc572/fastar-0.9.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:acb62e2369834fb23d26327157f0a2dbec40b230c709fa85b1ce96cf010e6fbf", size = 819050, upload-time = "2026-03-20T14:25:08.352Z" },
-    { url = "https://files.pythonhosted.org/packages/7c/5a/455b53f11527568100ba6d5847635430645bad62d676f0bae4173fc85c90/fastar-0.9.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:f2f399fffb74bcd9e9d4507e253ace2430b5ccf61000596bda41e90414bcf4f2", size = 885257, upload-time = "2026-03-20T14:24:28.86Z" },
-    { url = "https://files.pythonhosted.org/packages/4f/dd/0a8ea7b910293b07f8c82ef4e6451262ccf2a6f2020e880f184dc4abd6c2/fastar-0.9.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:87006c8770dfc558aefe927590bbcdaf9648ca4472a9ee6d10dfb7c0bda4ce5b", size = 968135, upload-time = "2026-03-20T14:25:45.614Z" },
-    { url = "https://files.pythonhosted.org/packages/6b/cb/5c7e9231d6ba00e225623947068db09ddd4e401800b0afaf39eece14bfee/fastar-0.9.0-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:4d012644421d669d9746157193f4eafd371e8ae56ff7aef97612a4922418664c", size = 1034940, upload-time = "2026-03-20T14:25:58.893Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/b4/eccfcf7fe9d2a0cea6d71630acc48a762404058c9b3ae1323f74abcda005/fastar-0.9.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:094fd03b2e41b20a2602d340e2b52ad10051d82caa1263411cf247c1b1bc139f", size = 1073807, upload-time = "2026-03-20T14:26:11.694Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/53/6ddda28545b428d54c42f341d797046467c689616a36eae9a43ba56f2545/fastar-0.9.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:59bc500d7b6bdaf2ffb2b632bc6b0f97ddfb3bb7d31b54d61ceb00b5698d6484", size = 1025314, upload-time = "2026-03-20T14:26:24.624Z" },
-    { url = "https://files.pythonhosted.org/packages/03/cf/71e2a67b0a69971044ad57fe7d196287ac32ab710bfc47f34745bb4a7834/fastar-0.9.0-cp312-cp312-win32.whl", hash = "sha256:25a1fd512ce23eb5aaab514742e7c6120244c211c349b86af068c3ae35792ec3", size = 452740, upload-time = "2026-03-20T14:26:56.604Z" },
-    { url = "https://files.pythonhosted.org/packages/c0/c5/0ffa2fffac0d80d2283db577ff23f8d91886010ea858c657f8278c2a222c/fastar-0.9.0-cp312-cp312-win_amd64.whl", hash = "sha256:b10a409797d01ee4062547e95e4a89f6bb52677b144076fd5a1f9d28d463ab10", size = 485282, upload-time = "2026-03-20T14:26:44.926Z" },
-    { url = "https://files.pythonhosted.org/packages/14/20/999d72dc12e793a6c7889176fc42ad917d568d802c91b4126629e9be45a9/fastar-0.9.0-cp312-cp312-win_arm64.whl", hash = "sha256:ea4d98fc62990986ce00d2021f08ff2aa6eae71636415c5a5f65f3a6a657dc5e", size = 461795, upload-time = "2026-03-20T14:26:36.728Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/06/a5773706afc8bd496769786590bbc56d2d0ee419a299cc12ea3f5717fcf3/fastar-0.11.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:3c51f1c2cdddbd1420d2897ace7738e36c65e17f6ae84e0bfe763f8d1068bb97", size = 708394, upload-time = "2026-04-13T17:09:57.269Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/a6/d5e2a4e48495616440a21eed07558219ca90243ad00b0502586f95bd4833/fastar-0.11.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:0d9d6b052baf5380baea866675dab6ccd04ec2460d12b1c46f10ce3f4ee6a820", size = 628417, upload-time = "2026-04-13T17:09:42.145Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/69/9816d69ac8265c9e50456637a487ccfb7a9c566efd9dbcd673df9c2558c2/fastar-0.11.0-cp312-cp312-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:bd2f05666d4df7e14885b5c38fefd92a785917387513d33d837ff42ec143a22f", size = 863950, upload-time = "2026-04-13T17:09:11.506Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/0d/f88daad53aff2e754b6b5ff2a7113f72447a34f6ef17cc23ca99988117b7/fastar-0.11.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c1e6e74aba1ae77ca4aedcaf1697cd413319f4c88a5ccbe5b42c709517c5097e", size = 760737, upload-time = "2026-04-13T17:07:55.958Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/a6/82ef4ecd969d50d92ed3ed9dbd8fe77faa24be5e5736f716edc9f4ce8d62/fastar-0.11.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:38ef77fe940bbc9b37a98bd838727f844b11731cd39358a2640ff864fb385086", size = 757603, upload-time = "2026-04-13T17:08:10.623Z" },
+    { url = "https://files.pythonhosted.org/packages/03/35/50249f0d827251f8ac511495e2eacccebda80a00a0ad73e9615b8113b84f/fastar-0.11.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8955e61b32d6aff82c983217abf80933fd823b0e727586fc72f08043d996fd59", size = 923952, upload-time = "2026-04-13T17:08:25.526Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/d8/faee41659e9c379d906d24eaee6d6833ac8cfef0a5df480e5c2a8d3efb33/fastar-0.11.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:483532442cdb08fbff0169510224eae0836f2f672cea6aacb52847d90fefdc46", size = 816574, upload-time = "2026-04-13T17:08:56.076Z" },
+    { url = "https://files.pythonhosted.org/packages/22/47/0448ea7992b997dad2bf004bfd98eca74b5858630eae080b50c7b17d9ddc/fastar-0.11.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ef5a6071121e05d8287fc75bccb054bcbac8bb0501200a0c0a8feeace5303ea4", size = 819382, upload-time = "2026-04-13T17:09:26.66Z" },
+    { url = "https://files.pythonhosted.org/packages/33/ef/0d63eb43586831b7a6f8b22c4d77125a7c594423af1f4f090fa9541b9b40/fastar-0.11.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:e45e598af5afe8412197d4786efd6cf29be02e7d3d4f6a3461149eae5d7e94f1", size = 885254, upload-time = "2026-04-13T17:08:40.9Z" },
+    { url = "https://files.pythonhosted.org/packages/01/25/edd584675d69e49a165052c3ee886df1c5d574f3e7d813c990306387c623/fastar-0.11.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:2e160919b1c47ddb8538e7e8eb4cd527281b40f0bf75110a75993838ef61f286", size = 971239, upload-time = "2026-04-13T17:10:12.997Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/37/e8bb24f506ba2b08fbaf36c5800e843bd4d542954e9331f00418e2d23349/fastar-0.11.0-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:4bb4dc0fc8f7a6807febcebce8a2f3626ba4955a9263d81ecc630aad83be84c0", size = 1035185, upload-time = "2026-04-13T17:10:30.207Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/bf/be753736296338149ee4cb3e92e2b5423d6ba17c7b951d15218fd7e99bbf/fastar-0.11.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:4ec95af56aa173f6e320e1183001bf108ba59beaf13edd1fc8200648db203588", size = 1072191, upload-time = "2026-04-13T17:10:47.072Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/cd/a81c1aaafb5a22ce57c98ae22f39c89413ed53e4ee6e1b1444b0bd666a6c/fastar-0.11.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:136cf342735464091c39dc3708168f9fdeb9ebea40b1ead937c61afaf46143d9", size = 1028054, upload-time = "2026-04-13T17:11:04.293Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/88/1ce4eed3d70627c95f49ca017f6bbbf2ddcc4b0c601d293259de7689bc20/fastar-0.11.0-cp312-cp312-win32.whl", hash = "sha256:35f23c11b556cc4d3704587faacbc0037f7bdf6c4525cd1d09c70bda4b1c6809", size = 454198, upload-time = "2026-04-13T17:11:45.168Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/1d/26ce92f4331cd61a69840db9ca6115829805eec24f285481a854f578e917/fastar-0.11.0-cp312-cp312-win_amd64.whl", hash = "sha256:920bc56c3c0b8a8ca492904941d1883c1c947c858cd93343356c29122a38f44c", size = 486697, upload-time = "2026-04-13T17:11:31.084Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/96/e6eda4480559c69b05d466e7b5ea9170e81fef3795a73e059959a3258319/fastar-0.11.0-cp312-cp312-win_arm64.whl", hash = "sha256:395248faf89e8a6bd5dc1fd544c8465113b627cb6d7c8b296796b60ebea33593", size = 462591, upload-time = "2026-04-13T17:11:20.577Z" },
 ]
 
 [[package]]
 name = "fastmcp"
-version = "3.2.0"
+version = "3.2.4"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "authlib" },
     { name = "cyclopts" },
     { name = "exceptiongroup" },
+    { name = "griffelib" },
     { name = "httpx" },
     { name = "jsonref" },
     { name = "jsonschema-path" },
@@ -514,18 +516,18 @@ dependencies = [
     { name = "watchfiles" },
     { name = "websockets" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/d0/32/4f1b2cfd7b50db89114949f90158b1dcc2c92a1917b9f57c0ff24e47a2f4/fastmcp-3.2.0.tar.gz", hash = "sha256:d4830b8ffc3592d3d9c76dc0f398904cf41f04910e41a0de38cc1004e0903bef", size = 26318581, upload-time = "2026-03-30T20:25:37.692Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/9c/13/29544fbc6dfe45ea38046af0067311e0bad7acc7d1f2ad38bb08f2409fe2/fastmcp-3.2.4.tar.gz", hash = "sha256:083ecb75b44a4169e7fc0f632f94b781bdb0ff877c6b35b9877cbb566fd4d4d1", size = 28746127, upload-time = "2026-04-14T01:42:24.174Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/4f/67/684fa2d2de1e7504549d4ca457b4f854ccec3cd3be03bd86b33b599fbf58/fastmcp-3.2.0-py3-none-any.whl", hash = "sha256:e71aba3df16f86f546a4a9e513261d3233bcc92bef0dfa647bac3fa33623f681", size = 705550, upload-time = "2026-03-30T20:25:35.499Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/76/b310d52fa0e30d39bd937eb58ec2c1f1ea1b5f519f0575e9dd9612f01deb/fastmcp-3.2.4-py3-none-any.whl", hash = "sha256:e6c9c429171041455e47ab94bb3f83c4657622a0ec28922f6940053959bd58a9", size = 728599, upload-time = "2026-04-14T01:42:26.85Z" },
 ]
 
 [[package]]
 name = "filelock"
-version = "3.25.2"
+version = "3.29.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/94/b8/00651a0f559862f3bb7d6f7477b192afe3f583cc5e26403b44e59a55ab34/filelock-3.25.2.tar.gz", hash = "sha256:b64ece2b38f4ca29dd3e810287aa8c48182bbecd1ae6e9ae126c9b35f1382694", size = 40480, upload-time = "2026-03-11T20:45:38.487Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/b5/fe/997687a931ab51049acce6fa1f23e8f01216374ea81374ddee763c493db5/filelock-3.29.0.tar.gz", hash = "sha256:69974355e960702e789734cb4871f884ea6fe50bd8404051a3530bc07809cf90", size = 57571, upload-time = "2026-04-19T15:39:10.068Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a4/a5/842ae8f0c08b61d6484b52f99a03510a3a72d23141942d216ebe81fefbce/filelock-3.25.2-py3-none-any.whl", hash = "sha256:ca8afb0da15f229774c9ad1b455ed96e85a81373065fb10446672f64444ddf70", size = 26759, upload-time = "2026-03-11T20:45:37.437Z" },
+    { url = "https://files.pythonhosted.org/packages/81/47/dd9a212ef6e343a6857485ffe25bba537304f1913bdbed446a23f7f592e1/filelock-3.29.0-py3-none-any.whl", hash = "sha256:96f5f6344709aa1572bbf631c640e4ebeeb519e08da902c39a001882f30ac258", size = 39812, upload-time = "2026-04-19T15:39:08.752Z" },
 ]
 
 [[package]]
@@ -547,19 +549,29 @@ wheels = [
 
 [[package]]
 name = "greenlet"
-version = "3.3.2"
+version = "3.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/3c/3f/dbf99fb14bfeb88c28f16729215478c0e265cacd6dc22270c8f31bb6892f/greenlet-3.5.0.tar.gz", hash = "sha256:d419647372241bc68e957bf38d5c1f98852155e4146bd1e4121adea81f4f01e4", size = 196995, upload-time = "2026-04-27T13:37:15.544Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ef/32/f2ce6d4cac3e55bc6173f92dbe627e782e1850f89d986c3606feb63aafa7/greenlet-3.5.0-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:db2910d3c809444e0a20147361f343fe2798e106af8d9d8506f5305302655a9f", size = 286228, upload-time = "2026-04-27T12:20:34.421Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/aa/caed9e5adf742315fc7be2a84196373aab4816e540e38ba0d76cb7584d68/greenlet-3.5.0-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3ec9ea74e7268ace7f9aab1b1a4e730193fc661b39a993cd91c606c32d4a3628", size = 601775, upload-time = "2026-04-27T12:52:41.045Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/af/90ae08497400a941595d12774447f752d3dfe0fbb012e35b76bc5c0ff37e/greenlet-3.5.0-cp312-cp312-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:54d243512da35485fc7a6bf3c178fdda6327a9d6506fcdd62b1abd1e41b2927b", size = 614436, upload-time = "2026-04-27T12:59:41.595Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/e9/4eeadf8cb3403ac274245ba75f07844abc7fa5f6787583fc9156ba741e0f/greenlet-3.5.0-cp312-cp312-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:41353ec2ecedf7aa8f682753a41919f8718031a6edac46b8d3dc7ed9e1ceb136", size = 620610, upload-time = "2026-04-27T13:02:39.194Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/e0/2e13df68f367e2f9960616927d60857dd7e56aaadd59a47c644216b2f920/greenlet-3.5.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d280a7f5c331622c69f97eb167f33577ff2d1df282c41cd15907fc0a3ca198c", size = 611388, upload-time = "2026-04-27T12:25:28.008Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/ef/f913b3c0eb7d26d86a2401c5e1546c9d46b657efee724b06f6f4ac5d8824/greenlet-3.5.0-cp312-cp312-manylinux_2_39_riscv64.whl", hash = "sha256:58c1c374fe2b3d852f9b6b11a7dff4c85404e51b9a596fd9e89cf904eb09866d", size = 422775, upload-time = "2026-04-27T13:05:14.261Z" },
+    { url = "https://files.pythonhosted.org/packages/82/f7/393c64055132ac0d488ef6be549253b7e6274194863967ddc0bc8f5b87b8/greenlet-3.5.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:1eb67d5adefb5bd2e182d42678a328979a209e4e82eb93575708185d31d1f588", size = 1570768, upload-time = "2026-04-27T12:53:28.099Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/4b/eaf7735253522cf56d1b74d672a58f54fc114702ceaf05def59aae72f6e1/greenlet-3.5.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:2628d6c86f6cb0cb45e0c3c54058bbec559f57eaae699447748cb3928150577e", size = 1635983, upload-time = "2026-04-27T12:25:26.903Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/fe/4fb3a0805bd5165da5ebf858da7cc01cce8061674106d2cf5bdab32cbfde/greenlet-3.5.0-cp312-cp312-win_amd64.whl", hash = "sha256:d4d9f0624c775f2dfc56ba54d515a8c771044346852a918b405914f6b19d7fd8", size = 238840, upload-time = "2026-04-27T12:23:54.806Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/cb/baa584cb00532126ffe12d9787db0a60c5a4f55c27bfe2666df5d4c30a32/greenlet-3.5.0-cp312-cp312-win_arm64.whl", hash = "sha256:83ed9f27f1680b50e89f40f6df348a290ea234b249a4003d366663a12eab94f2", size = 235615, upload-time = "2026-04-27T12:21:38.57Z" },
+]
+
+[[package]]
+name = "griffelib"
+version = "2.0.2"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/a3/51/1664f6b78fc6ebbd98019a1fd730e83fa78f2db7058f72b1463d3612b8db/greenlet-3.3.2.tar.gz", hash = "sha256:2eaf067fc6d886931c7962e8c6bede15d2f01965560f3359b27c80bde2d151f2", size = 188267, upload-time = "2026-02-20T20:54:15.531Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/9d/82/74f4a3310cdabfbb10da554c3a672847f1ed33c6f61dd472681ce7f1fe67/griffelib-2.0.2.tar.gz", hash = "sha256:3cf20b3bc470e83763ffbf236e0076b1211bac1bc67de13daf494640f2de707e", size = 166461, upload-time = "2026-03-27T11:34:51.091Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ea/ab/1608e5a7578e62113506740b88066bf09888322a311cff602105e619bd87/greenlet-3.3.2-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:ac8d61d4343b799d1e526db579833d72f23759c71e07181c2d2944e429eb09cd", size = 280358, upload-time = "2026-02-20T20:17:43.971Z" },
-    { url = "https://files.pythonhosted.org/packages/a5/23/0eae412a4ade4e6623ff7626e38998cb9b11e9ff1ebacaa021e4e108ec15/greenlet-3.3.2-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3ceec72030dae6ac0c8ed7591b96b70410a8be370b6a477b1dbc072856ad02bd", size = 601217, upload-time = "2026-02-20T20:47:31.462Z" },
-    { url = "https://files.pythonhosted.org/packages/f8/16/5b1678a9c07098ecb9ab2dd159fafaf12e963293e61ee8d10ecb55273e5e/greenlet-3.3.2-cp312-cp312-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a2a5be83a45ce6188c045bcc44b0ee037d6a518978de9a5d97438548b953a1ac", size = 611792, upload-time = "2026-02-20T20:55:58.423Z" },
-    { url = "https://files.pythonhosted.org/packages/5c/c5/cc09412a29e43406eba18d61c70baa936e299bc27e074e2be3806ed29098/greenlet-3.3.2-cp312-cp312-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ae9e21c84035c490506c17002f5c8ab25f980205c3e61ddb3a2a2a2e6c411fcb", size = 626250, upload-time = "2026-02-20T21:02:46.596Z" },
-    { url = "https://files.pythonhosted.org/packages/50/1f/5155f55bd71cabd03765a4aac9ac446be129895271f73872c36ebd4b04b6/greenlet-3.3.2-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:43e99d1749147ac21dde49b99c9abffcbc1e2d55c67501465ef0930d6e78e070", size = 613875, upload-time = "2026-02-20T20:21:01.102Z" },
-    { url = "https://files.pythonhosted.org/packages/fc/dd/845f249c3fcd69e32df80cdab059b4be8b766ef5830a3d0aa9d6cad55beb/greenlet-3.3.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:4c956a19350e2c37f2c48b336a3afb4bff120b36076d9d7fb68cb44e05d95b79", size = 1571467, upload-time = "2026-02-20T20:49:33.495Z" },
-    { url = "https://files.pythonhosted.org/packages/2a/50/2649fe21fcc2b56659a452868e695634722a6655ba245d9f77f5656010bf/greenlet-3.3.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:6c6f8ba97d17a1e7d664151284cb3315fc5f8353e75221ed4324f84eb162b395", size = 1640001, upload-time = "2026-02-20T20:21:09.154Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/40/cc802e067d02af8b60b6771cea7d57e21ef5e6659912814babb42b864713/greenlet-3.3.2-cp312-cp312-win_amd64.whl", hash = "sha256:34308836d8370bddadb41f5a7ce96879b72e2fdfb4e87729330c6ab52376409f", size = 231081, upload-time = "2026-02-20T20:17:28.121Z" },
-    { url = "https://files.pythonhosted.org/packages/58/2e/fe7f36ff1982d6b10a60d5e0740c759259a7d6d2e1dc41da6d96de32fff6/greenlet-3.3.2-cp312-cp312-win_arm64.whl", hash = "sha256:d3a62fa76a32b462a97198e4c9e99afb9ab375115e74e9a83ce180e7a496f643", size = 230331, upload-time = "2026-02-20T20:17:23.34Z" },
+    { url = "https://files.pythonhosted.org/packages/11/8c/c9138d881c79aa0ea9ed83cbd58d5ca75624378b38cee225dcf5c42cc91f/griffelib-2.0.2-py3-none-any.whl", hash = "sha256:925c857658fb1ba40c0772c37acbc2ab650bd794d9c1b9726922e36ea4117ea1", size = 142357, upload-time = "2026-03-27T11:34:46.275Z" },
 ]
 
 [[package]]
@@ -641,7 +653,7 @@ wheels = [
 
 [[package]]
 name = "huggingface-hub"
-version = "1.9.1"
+version = "1.12.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "filelock" },
@@ -654,18 +666,18 @@ dependencies = [
     { name = "typer" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/44/40/68d9b286b125d9318ae95c8f8b206e8672e7244b0eea61ebb4a88037638c/huggingface_hub-1.9.1.tar.gz", hash = "sha256:442af372207cc24dcb089caf507fcd7dbc1217c11d6059a06f6b90afe64e8bd2", size = 750355, upload-time = "2026-04-07T13:47:59.167Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/56/52/1b54cb569509c725a32c1315261ac9fd0e6b91bbbf74d86fca10d3376164/huggingface_hub-1.12.0.tar.gz", hash = "sha256:7c3fe85e24b652334e5d456d7a812cd9a071e75630fac4365d9165ab5e4a34b6", size = 763091, upload-time = "2026-04-24T13:32:08.674Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/3d/af/10a89c54937dccf6c10792770f362d96dd67aedfde108e6e1fd7a0836789/huggingface_hub-1.9.1-py3-none-any.whl", hash = "sha256:8dae771b969b318203727a6c6c5209d25e661f6f0dd010fc09cc4a12cf81c657", size = 637356, upload-time = "2026-04-07T13:47:57.239Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/2b/ef03ddb96bd1123503c2bd6932001020292deea649e9bf4caa2cb65a85bf/huggingface_hub-1.12.0-py3-none-any.whl", hash = "sha256:d74939969585ee35748bd66de09baf84099d461bda7287cd9043bfb99b0e424d", size = 646806, upload-time = "2026-04-24T13:32:06.717Z" },
 ]
 
 [[package]]
 name = "idna"
-version = "3.11"
+version = "3.13"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/ce/cc/762dfb036166873f0059f3b7de4565e1b5bc3d6f28a414c13da27e442f99/idna-3.13.tar.gz", hash = "sha256:585ea8fe5d69b9181ec1afba340451fba6ba764af97026f92a91d4eef164a242", size = 194210, upload-time = "2026-04-22T16:42:42.314Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/13/ad7d7ca3808a898b4612b6fe93cde56b53f3034dcde235acb1f0e1df24c6/idna-3.13-py3-none-any.whl", hash = "sha256:892ea0cde124a99ce773decba204c5552b69c3c67ffd5f232eb7696135bc8bb3", size = 68629, upload-time = "2026-04-22T16:42:40.909Z" },
 ]
 
 [[package]]
@@ -752,6 +764,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/62/a1/3d680cbfd5f4b8f15abc1d571870c5fc3e594bb582bc3b64ea099db13e56/jinja2-3.1.6-py3-none-any.whl", hash = "sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67", size = 134899, upload-time = "2025-03-05T20:05:00.369Z" },
 ]
 
+[[package]]
+name = "joserfc"
+version = "1.6.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cryptography" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/de/c6/de8fdbdfa75c8ca04fead38a82d573df8a82906e984c349d58665f459558/joserfc-1.6.4.tar.gz", hash = "sha256:34ce5f499bfcc5e9ad4cc75077f9278ab3227b71da9aaf28f9ab705f8a560d3c", size = 231866, upload-time = "2026-04-13T13:15:40.632Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b6/f7/210b27752e972edb36d239315b08d3eb6b14824cc4a590da2337d195260b/joserfc-1.6.4-py3-none-any.whl", hash = "sha256:3e4a22b509b41908989237a045e25c8308d5fd47ab96bdae2dd8057c6451003a", size = 70464, upload-time = "2026-04-13T13:15:39.259Z" },
+]
+
 [[package]]
 name = "jsonref"
 version = "1.1.0"
@@ -821,14 +845,14 @@ wheels = [
 
 [[package]]
 name = "mako"
-version = "1.3.10"
+version = "1.3.11"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "markupsafe" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/9e/38/bd5b78a920a64d708fe6bc8e0a2c075e1389d53bef8413725c63ba041535/mako-1.3.10.tar.gz", hash = "sha256:99579a6f39583fa7e5630a28c3c1f440e4e97a414b80372649c0ce338da2ea28", size = 392474, upload-time = "2025-04-10T12:44:31.16Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/59/8a/805404d0c0b9f3d7a326475ca008db57aea9c5c9f2e1e39ed0faa335571c/mako-1.3.11.tar.gz", hash = "sha256:071eb4ab4c5010443152255d77db7faa6ce5916f35226eb02dc34479b6858069", size = 399811, upload-time = "2026-04-14T20:19:51.493Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/87/fb/99f81ac72ae23375f22b7afdb7642aba97c00a713c217124420147681a2f/mako-1.3.10-py3-none-any.whl", hash = "sha256:baef24a52fc4fc514a0887ac600f9f1cff3d82c61d4d700a1fa84d597b88db59", size = 78509, upload-time = "2025-04-10T12:50:53.297Z" },
+    { url = "https://files.pythonhosted.org/packages/68/a5/19d7aaa7e433713ffe881df33705925a196afb9532efc8475d26593921a6/mako-1.3.11-py3-none-any.whl", hash = "sha256:e372c6e333cf004aa736a15f425087ec977e1fcbd2966aae7f17c8dc1da27a77", size = 78503, upload-time = "2026-04-14T20:19:53.233Z" },
 ]
 
 [[package]]
@@ -960,20 +984,11 @@ dev = [
 
 [[package]]
 name = "more-itertools"
-version = "11.0.1"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/24/24/e0acc4bf54cba50c1d432c70a72a3df96db4a321b2c4c68432a60759044f/more_itertools-11.0.1.tar.gz", hash = "sha256:fefaf25b7ab08f0b45fa9f1892cae93b9fc0089ef034d39213bce15f1cc9e199", size = 144739, upload-time = "2026-04-02T16:17:45.061Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/d8/f4/5e52c7319b8087acef603ed6e50dc325c02eaa999355414830468611f13c/more_itertools-11.0.1-py3-none-any.whl", hash = "sha256:eaf287826069452a8f61026c597eae2428b2d1ba2859083abbf240b46842ce6d", size = 72182, upload-time = "2026-04-02T16:17:43.724Z" },
-]
-
-[[package]]
-name = "mpmath"
-version = "1.3.0"
+version = "11.0.2"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/e0/47/dd32fa426cc72114383ac549964eecb20ecfd886d1e5ccf5340b55b02f57/mpmath-1.3.0.tar.gz", hash = "sha256:7a28eb2a9774d00c7bc92411c19a89209d5da7c4c9a9e227be8330a23a25b91f", size = 508106, upload-time = "2023-03-07T16:47:11.061Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/f7/139d22fef48ac78127d18e01d80cf1be40236ae489769d17f35c3d425293/more_itertools-11.0.2.tar.gz", hash = "sha256:392a9e1e362cbc106a2457d37cabf9b36e5e12efd4ebff1654630e76597df804", size = 144659, upload-time = "2026-04-09T15:01:33.297Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/43/e3/7d92a15f894aa0c9c4b49b8ee9ac9850d6e63b03c9c32c0367a13ae62209/mpmath-1.3.0-py3-none-any.whl", hash = "sha256:a0b2b9fe80bbcd81a6647ff13108738cfb482d481d826cc0e02f5b35e5c88d2c", size = 536198, upload-time = "2023-03-07T16:47:09.197Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/98/6af411189d9413534c3eb691182bff1f5c6d44ed2f93f2edfe52a1bbceb8/more_itertools-11.0.2-py3-none-any.whl", hash = "sha256:6e35b35f818b01f691643c6c611bc0902f2e92b46c18fffa77ae1e7c46e912e4", size = 71939, upload-time = "2026-04-09T15:01:32.21Z" },
 ]
 
 [[package]]
@@ -997,21 +1012,20 @@ wheels = [
 
 [[package]]
 name = "onnxruntime"
-version = "1.24.4"
+version = "1.25.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "flatbuffers" },
     { name = "numpy" },
     { name = "packaging" },
     { name = "protobuf" },
-    { name = "sympy" },
 ]
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/d7/38/31db1b232b4ba960065a90c1506ad7a56995cd8482033184e97fadca17cc/onnxruntime-1.24.4-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:cad1c2b3f455c55678ab2a8caa51fb420c25e6e3cf10f4c23653cdabedc8de78", size = 17341875, upload-time = "2026-03-17T22:05:51.669Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/60/c4d1c8043eb42f8a9aa9e931c8c293d289c48ff463267130eca97d13357f/onnxruntime-1.24.4-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1a5c5a544b22f90859c88617ecb30e161ee3349fcc73878854f43d77f00558b5", size = 15172485, upload-time = "2026-03-17T22:03:32.182Z" },
-    { url = "https://files.pythonhosted.org/packages/6d/ab/5b68110e0460d73fad814d5bd11c7b1ddcce5c37b10177eb264d6a36e331/onnxruntime-1.24.4-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0d640eb9f3782689b55cfa715094474cd5662f2f137be6a6f847a594b6e9705c", size = 17244912, upload-time = "2026-03-17T22:04:37.251Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/f4/6b89e297b93704345f0f3f8c62229bee323ef25682a3f9b4f89a39324950/onnxruntime-1.24.4-cp312-cp312-win_amd64.whl", hash = "sha256:535b29475ca42b593c45fbb2152fbf1cdf3f287315bf650e6a724a0a1d065cdb", size = 12596856, upload-time = "2026-03-17T22:05:41.224Z" },
-    { url = "https://files.pythonhosted.org/packages/43/06/8b8ec6e9e6a474fcd5d772453f627ad4549dfe3ab8c0bf70af5afcde551b/onnxruntime-1.24.4-cp312-cp312-win_arm64.whl", hash = "sha256:e6214096e14b7b52e3bee1903dc12dc7ca09cb65e26664668a4620cc5e6f9a90", size = 12270275, upload-time = "2026-03-17T22:05:31.132Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/69/f98c6bda4c34ac382b70c36033a989ceffd1caf5afba47bd2ef26535850f/onnxruntime-1.25.0-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:8ecd3362de3fb496fb3e2d055a95d5acab611cf759a27609c6d99704c9d8f184", size = 17742518, upload-time = "2026-04-22T17:20:34.444Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/c6/19c5bfbc60396791e975652f982bcff9ff4b27947c8e2bf0064ac5d5727b/onnxruntime-1.25.0-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9c99238d20bfa80ac68c7b03c2c936d389189ae40997f78a30d151570d7e18bf", size = 15841110, upload-time = "2026-04-22T17:19:31.284Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/1b/d681878f227513917d8620e4ea504af5eb3313fc01f8aea7b19a976c65db/onnxruntime-1.25.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:be93baa694ef8e5831fcb7b542da21f502b122918b5b9612d9f02972e043ee01", size = 17996146, upload-time = "2026-04-22T17:19:53.792Z" },
+    { url = "https://files.pythonhosted.org/packages/55/fe/ec98e416bd75063dea1e493661c7c939e18660ee41d6a63d7221e5657f48/onnxruntime-1.25.0-cp312-cp312-win_amd64.whl", hash = "sha256:9596040c1f7d247bbfab5d4db1e7651c790235e48e460c7d445ec81687d5a182", size = 12872370, upload-time = "2026-04-22T17:20:22.856Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/86/9a1ac7c8a8eba7967935d4c109fc956d8f9ba61cba61d9368315bb27d0bc/onnxruntime-1.25.0-cp312-cp312-win_arm64.whl", hash = "sha256:463aed7f5e4a3ca5a476db7e9bba9164fa26921ef34c37e59b28c4c61e55f266", size = 12600072, upload-time = "2026-04-22T17:20:11.523Z" },
 ]
 
 [[package]]
@@ -1028,24 +1042,24 @@ wheels = [
 
 [[package]]
 name = "opentelemetry-api"
-version = "1.40.0"
+version = "1.41.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "importlib-metadata" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/2c/1d/4049a9e8698361cc1a1aa03a6c59e4fa4c71e0c0f94a30f988a6876a2ae6/opentelemetry_api-1.40.0.tar.gz", hash = "sha256:159be641c0b04d11e9ecd576906462773eb97ae1b657730f0ecf64d32071569f", size = 70851, upload-time = "2026-03-04T14:17:21.555Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/fa/fc/b7564cbef36601aef0d6c9bc01f7badb64be8e862c2e1c3c5c3b43b53e4f/opentelemetry_api-1.41.1.tar.gz", hash = "sha256:0ad1814d73b875f84494387dae86ce0b12c68556331ce6ce8fe789197c949621", size = 71416, upload-time = "2026-04-24T13:15:38.262Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/5f/bf/93795954016c522008da367da292adceed71cca6ee1717e1d64c83089099/opentelemetry_api-1.40.0-py3-none-any.whl", hash = "sha256:82dd69331ae74b06f6a874704be0cfaa49a1650e1537d4a813b86ecef7d0ecf9", size = 68676, upload-time = "2026-03-04T14:17:01.24Z" },
+    { url = "https://files.pythonhosted.org/packages/29/59/3e7118ed140f76b0982ba4321bdaed1997a0473f9720de2d10788a577033/opentelemetry_api-1.41.1-py3-none-any.whl", hash = "sha256:a22df900e75c76dc08440710e51f52f1aa6b451b429298896023e60db5b3139f", size = 69007, upload-time = "2026-04-24T13:15:15.662Z" },
 ]
 
 [[package]]
 name = "packaging"
-version = "26.0"
+version = "26.2"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/65/ee/299d360cdc32edc7d2cf530f3accf79c4fca01e96ffc950d8a52213bd8e4/packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4", size = 143416, upload-time = "2026-01-21T20:50:39.064Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/d7/f1/e7a6dd94a8d4a5626c03e4e99c87f241ba9e350cd9e6d75123f992427270/packaging-26.2.tar.gz", hash = "sha256:ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661", size = 228134, upload-time = "2026-04-24T20:15:23.917Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/b7/b9/c538f279a4e237a006a2c98387d081e9eb060d203d8ed34467cc0f0b9b53/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366, upload-time = "2026-01-21T20:50:37.788Z" },
+    { url = "https://files.pythonhosted.org/packages/df/b2/87e62e8c3e2f4b32e5fe99e0b86d576da1312593b39f47d8ceef365e95ed/packaging-26.2-py3-none-any.whl", hash = "sha256:5fc45236b9446107ff2415ce77c807cee2862cb6fac22b8a73826d0693b0980e", size = 100195, upload-time = "2026-04-24T20:15:22.081Z" },
 ]
 
 [[package]]
@@ -1071,11 +1085,11 @@ wheels = [
 
 [[package]]
 name = "platformdirs"
-version = "4.9.4"
+version = "4.9.6"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/19/56/8d4c30c8a1d07013911a8fdbd8f89440ef9f08d07a1b50ab8ca8be5a20f9/platformdirs-4.9.4.tar.gz", hash = "sha256:1ec356301b7dc906d83f371c8f487070e99d3ccf9e501686456394622a01a934", size = 28737, upload-time = "2026-03-05T18:34:13.271Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/9f/4a/0883b8e3802965322523f0b200ecf33d31f10991d0401162f4b23c698b42/platformdirs-4.9.6.tar.gz", hash = "sha256:3bfa75b0ad0db84096ae777218481852c0ebc6c727b3168c1b9e0118e458cf0a", size = 29400, upload-time = "2026-04-09T00:04:10.812Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/63/d7/97f7e3a6abb67d8080dd406fd4df842c2be0efaf712d1c899c32a075027c/platformdirs-4.9.4-py3-none-any.whl", hash = "sha256:68a9a4619a666ea6439f2ff250c12a853cd1cbd5158d258bd824a7df6be2f868", size = 21216, upload-time = "2026-03-05T18:34:12.172Z" },
+    { url = "https://files.pythonhosted.org/packages/75/a6/a0a304dc33b49145b21f4808d763822111e67d1c3a32b524a1baf947b6e1/platformdirs-4.9.6-py3-none-any.whl", hash = "sha256:e61adb1d5e5cb3441b4b7710bea7e4c12250ca49439228cc1021c00dcfac0917", size = 21348, upload-time = "2026-04-09T00:04:09.463Z" },
 ]
 
 [[package]]
@@ -1138,7 +1152,7 @@ wheels = [
 
 [[package]]
 name = "pydantic"
-version = "2.12.5"
+version = "2.13.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "annotated-types" },
@@ -1146,9 +1160,9 @@ dependencies = [
     { name = "typing-extensions" },
     { name = "typing-inspection" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/d9/e4/40d09941a2cebcb20609b86a559817d5b9291c49dd6f8c87e5feffbe703a/pydantic-2.13.3.tar.gz", hash = "sha256:af09e9d1d09f4e7fe37145c1f577e1d61ceb9a41924bf0094a36506285d0a84d", size = 844068, upload-time = "2026-04-20T14:46:43.632Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/5a/87/b70ad306ebb6f9b585f114d0ac2137d792b48be34d732d60e597c2f8465a/pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d", size = 463580, upload-time = "2025-11-26T15:11:44.605Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/0a/fd7d723f8f8153418fb40cf9c940e82004fce7e987026b08a68a36dd3fe7/pydantic-2.13.3-py3-none-any.whl", hash = "sha256:6db14ac8dfc9a1e57f87ea2c0de670c251240f43cb0c30a5130e9720dc612927", size = 471981, upload-time = "2026-04-20T14:46:41.402Z" },
 ]
 
 [package.optional-dependencies]
@@ -1158,58 +1172,59 @@ email = [
 
 [[package]]
 name = "pydantic-core"
-version = "2.41.5"
+version = "2.46.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/5f/5d/5f6c63eebb5afee93bcaae4ce9a898f3373ca23df3ccaef086d0233a35a7/pydantic_core-2.41.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f41a7489d32336dbf2199c8c0a215390a751c5b014c2c1c5366e817202e9cdf7", size = 2110990, upload-time = "2025-11-04T13:39:58.079Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/32/9c2e8ccb57c01111e0fd091f236c7b371c1bccea0fa85247ac55b1e2b6b6/pydantic_core-2.41.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:070259a8818988b9a84a449a2a7337c7f430a22acc0859c6b110aa7212a6d9c0", size = 1896003, upload-time = "2025-11-04T13:39:59.956Z" },
-    { url = "https://files.pythonhosted.org/packages/68/b8/a01b53cb0e59139fbc9e4fda3e9724ede8de279097179be4ff31f1abb65a/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e96cea19e34778f8d59fe40775a7a574d95816eb150850a85a7a4c8f4b94ac69", size = 1919200, upload-time = "2025-11-04T13:40:02.241Z" },
-    { url = "https://files.pythonhosted.org/packages/38/de/8c36b5198a29bdaade07b5985e80a233a5ac27137846f3bc2d3b40a47360/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed2e99c456e3fadd05c991f8f437ef902e00eedf34320ba2b0842bd1c3ca3a75", size = 2052578, upload-time = "2025-11-04T13:40:04.401Z" },
-    { url = "https://files.pythonhosted.org/packages/00/b5/0e8e4b5b081eac6cb3dbb7e60a65907549a1ce035a724368c330112adfdd/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:65840751b72fbfd82c3c640cff9284545342a4f1eb1586ad0636955b261b0b05", size = 2208504, upload-time = "2025-11-04T13:40:06.072Z" },
-    { url = "https://files.pythonhosted.org/packages/77/56/87a61aad59c7c5b9dc8caad5a41a5545cba3810c3e828708b3d7404f6cef/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e536c98a7626a98feb2d3eaf75944ef6f3dbee447e1f841eae16f2f0a72d8ddc", size = 2335816, upload-time = "2025-11-04T13:40:07.835Z" },
-    { url = "https://files.pythonhosted.org/packages/0d/76/941cc9f73529988688a665a5c0ecff1112b3d95ab48f81db5f7606f522d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eceb81a8d74f9267ef4081e246ffd6d129da5d87e37a77c9bde550cb04870c1c", size = 2075366, upload-time = "2025-11-04T13:40:09.804Z" },
-    { url = "https://files.pythonhosted.org/packages/d3/43/ebef01f69baa07a482844faaa0a591bad1ef129253ffd0cdaa9d8a7f72d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d38548150c39b74aeeb0ce8ee1d8e82696f4a4e16ddc6de7b1d8823f7de4b9b5", size = 2171698, upload-time = "2025-11-04T13:40:12.004Z" },
-    { url = "https://files.pythonhosted.org/packages/b1/87/41f3202e4193e3bacfc2c065fab7706ebe81af46a83d3e27605029c1f5a6/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c23e27686783f60290e36827f9c626e63154b82b116d7fe9adba1fda36da706c", size = 2132603, upload-time = "2025-11-04T13:40:13.868Z" },
-    { url = "https://files.pythonhosted.org/packages/49/7d/4c00df99cb12070b6bccdef4a195255e6020a550d572768d92cc54dba91a/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:482c982f814460eabe1d3bb0adfdc583387bd4691ef00b90575ca0d2b6fe2294", size = 2329591, upload-time = "2025-11-04T13:40:15.672Z" },
-    { url = "https://files.pythonhosted.org/packages/cc/6a/ebf4b1d65d458f3cda6a7335d141305dfa19bdc61140a884d165a8a1bbc7/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:bfea2a5f0b4d8d43adf9d7b8bf019fb46fdd10a2e5cde477fbcb9d1fa08c68e1", size = 2319068, upload-time = "2025-11-04T13:40:17.532Z" },
-    { url = "https://files.pythonhosted.org/packages/49/3b/774f2b5cd4192d5ab75870ce4381fd89cf218af999515baf07e7206753f0/pydantic_core-2.41.5-cp312-cp312-win32.whl", hash = "sha256:b74557b16e390ec12dca509bce9264c3bbd128f8a2c376eaa68003d7f327276d", size = 1985908, upload-time = "2025-11-04T13:40:19.309Z" },
-    { url = "https://files.pythonhosted.org/packages/86/45/00173a033c801cacf67c190fef088789394feaf88a98a7035b0e40d53dc9/pydantic_core-2.41.5-cp312-cp312-win_amd64.whl", hash = "sha256:1962293292865bca8e54702b08a4f26da73adc83dd1fcf26fbc875b35d81c815", size = 2020145, upload-time = "2025-11-04T13:40:21.548Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/22/91fbc821fa6d261b376a3f73809f907cec5ca6025642c463d3488aad22fb/pydantic_core-2.41.5-cp312-cp312-win_arm64.whl", hash = "sha256:1746d4a3d9a794cacae06a5eaaccb4b8643a131d45fbc9af23e353dc0a5ba5c3", size = 1976179, upload-time = "2025-11-04T13:40:23.393Z" },
-    { url = "https://files.pythonhosted.org/packages/09/32/59b0c7e63e277fa7911c2fc70ccfb45ce4b98991e7ef37110663437005af/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:7da7087d756b19037bc2c06edc6c170eeef3c3bafcb8f532ff17d64dc427adfd", size = 2110495, upload-time = "2025-11-04T13:42:49.689Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/81/05e400037eaf55ad400bcd318c05bb345b57e708887f07ddb2d20e3f0e98/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:aabf5777b5c8ca26f7824cb4a120a740c9588ed58df9b2d196ce92fba42ff8dc", size = 1915388, upload-time = "2025-11-04T13:42:52.215Z" },
-    { url = "https://files.pythonhosted.org/packages/6e/0d/e3549b2399f71d56476b77dbf3cf8937cec5cd70536bdc0e374a421d0599/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c007fe8a43d43b3969e8469004e9845944f1a80e6acd47c150856bb87f230c56", size = 1942879, upload-time = "2025-11-04T13:42:56.483Z" },
-    { url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" },
+sdist = { url = "https://files.pythonhosted.org/packages/2a/ef/f7abb56c49382a246fd2ce9c799691e3c3e7175ec74b14d99e798bcddb1a/pydantic_core-2.46.3.tar.gz", hash = "sha256:41c178f65b8c29807239d47e6050262eb6bf84eb695e41101e62e38df4a5bc2c", size = 471412, upload-time = "2026-04-20T14:40:56.672Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/4b/cb/5b47425556ecc1f3fe18ed2a0083188aa46e1dd812b06e406475b3a5d536/pydantic_core-2.46.3-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:b11b59b3eee90a80a36701ddb4576d9ae31f93f05cb9e277ceaa09e6bf074a67", size = 2101946, upload-time = "2026-04-20T14:40:52.581Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/4f/2fb62c2267cae99b815bbf4a7b9283812c88ca3153ef29f7707200f1d4e5/pydantic_core-2.46.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:af8653713055ea18a3abc1537fe2ebc42f5b0bbb768d1eb79fd74eb47c0ac089", size = 1951612, upload-time = "2026-04-20T14:42:42.996Z" },
+    { url = "https://files.pythonhosted.org/packages/50/6e/b7348fd30d6556d132cddd5bd79f37f96f2601fe0608afac4f5fb01ec0b3/pydantic_core-2.46.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:75a519dab6d63c514f3a81053e5266c549679e4aa88f6ec57f2b7b854aceb1b0", size = 1977027, upload-time = "2026-04-20T14:42:02.001Z" },
+    { url = "https://files.pythonhosted.org/packages/82/11/31d60ee2b45540d3fb0b29302a393dbc01cd771c473f5b5147bcd353e593/pydantic_core-2.46.3-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a6cd87cb1575b1ad05ba98894c5b5c96411ef678fa2f6ed2576607095b8d9789", size = 2063008, upload-time = "2026-04-20T14:44:17.952Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/db/3a9d1957181b59258f44a2300ab0f0be9d1e12d662a4f57bb31250455c52/pydantic_core-2.46.3-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f80a55484b8d843c8ada81ebf70a682f3f00a3d40e378c06cf17ecb44d280d7d", size = 2233082, upload-time = "2026-04-20T14:40:57.934Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/e1/3277c38792aeb5cfb18c2f0c5785a221d9ff4e149abbe1184d53d5f72273/pydantic_core-2.46.3-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3861f1731b90c50a3266316b9044f5c9b405eecb8e299b0a7120596334e4fe9c", size = 2304615, upload-time = "2026-04-20T14:42:12.584Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/d5/e3d9717c9eba10855325650afd2a9cba8e607321697f18953af9d562da2f/pydantic_core-2.46.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fb528e295ed31570ac3dcc9bfdd6e0150bc11ce6168ac87a8082055cf1a67395", size = 2094380, upload-time = "2026-04-20T14:43:05.522Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/20/abac35dedcbfd66c6f0b03e4e3564511771d6c9b7ede10a362d03e110d9b/pydantic_core-2.46.3-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:367508faa4973b992b271ba1494acaab36eb7e8739d1e47be5035fb1ea225396", size = 2135429, upload-time = "2026-04-20T14:41:55.549Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/a5/41bfd1df69afad71b5cf0535055bccc73022715ad362edbc124bc1e021d7/pydantic_core-2.46.3-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5ad3c826fe523e4becf4fe39baa44286cff85ef137c729a2c5e269afbfd0905d", size = 2174582, upload-time = "2026-04-20T14:41:45.96Z" },
+    { url = "https://files.pythonhosted.org/packages/79/65/38d86ea056b29b2b10734eb23329b7a7672ca604df4f2b6e9c02d4ee22fe/pydantic_core-2.46.3-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:ec638c5d194ef8af27db69f16c954a09797c0dc25015ad6123eb2c73a4d271ca", size = 2187533, upload-time = "2026-04-20T14:40:55.367Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/55/a1129141678a2026badc539ad1dee0a71d06f54c2f06a4bd68c030ac781b/pydantic_core-2.46.3-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:28ed528c45446062ee66edb1d33df5d88828ae167de76e773a3c7f64bd14e976", size = 2332985, upload-time = "2026-04-20T14:44:13.05Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/60/cb26f4077719f709e54819f4e8e1d43f4091f94e285eb6bd21e1190a7b7c/pydantic_core-2.46.3-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:aed19d0c783886d5bd86d80ae5030006b45e28464218747dcf83dabfdd092c7b", size = 2373670, upload-time = "2026-04-20T14:41:53.421Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/7e/c3f21882bdf1d8d086876f81b5e296206c69c6082551d776895de7801fa0/pydantic_core-2.46.3-cp312-cp312-win32.whl", hash = "sha256:06d5d8820cbbdb4147578c1fe7ffcd5b83f34508cb9f9ab76e807be7db6ff0a4", size = 1966722, upload-time = "2026-04-20T14:44:30.588Z" },
+    { url = "https://files.pythonhosted.org/packages/57/be/6b5e757b859013ebfbd7adba02f23b428f37c86dcbf78b5bb0b4ffd36e99/pydantic_core-2.46.3-cp312-cp312-win_amd64.whl", hash = "sha256:c3212fda0ee959c1dd04c60b601ec31097aaa893573a3a1abd0a47bcac2968c1", size = 2072970, upload-time = "2026-04-20T14:42:54.248Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/f8/a989b21cc75e9a32d24192ef700eea606521221a89faa40c919ce884f2b1/pydantic_core-2.46.3-cp312-cp312-win_arm64.whl", hash = "sha256:f1f8338dd7a7f31761f1f1a3c47503a9a3b34eea3c8b01fa6ee96408affb5e72", size = 2035963, upload-time = "2026-04-20T14:44:20.4Z" },
+    { url = "https://files.pythonhosted.org/packages/34/42/f426db557e8ab2791bc7562052299944a118655496fbff99914e564c0a94/pydantic_core-2.46.3-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:b12dd51f1187c2eb489af8e20f880362db98e954b54ab792fa5d92e8bcc6b803", size = 2091877, upload-time = "2026-04-20T14:43:27.091Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/4f/86a832a9d14df58e663bfdf4627dc00d3317c2bd583c4fb23390b0f04b8e/pydantic_core-2.46.3-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:f00a0961b125f1a47af7bcc17f00782e12f4cd056f83416006b30111d941dfa3", size = 1932428, upload-time = "2026-04-20T14:40:45.781Z" },
+    { url = "https://files.pythonhosted.org/packages/11/1a/fe857968954d93fb78e0d4b6df5c988c74c4aaa67181c60be7cfe327c0ca/pydantic_core-2.46.3-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:57697d7c056aca4bbb680200f96563e841a6386ac1129370a0102592f4dddff5", size = 1997550, upload-time = "2026-04-20T14:44:02.425Z" },
+    { url = "https://files.pythonhosted.org/packages/17/eb/9d89ad2d9b0ba8cd65393d434471621b98912abb10fbe1df08e480ba57b5/pydantic_core-2.46.3-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fd35aa21299def8db7ef4fe5c4ff862941a9a158ca7b63d61e66fe67d30416b4", size = 2137657, upload-time = "2026-04-20T14:42:45.149Z" },
 ]
 
 [[package]]
 name = "pydantic-extra-types"
-version = "2.11.2"
+version = "2.11.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "pydantic" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/41/d3/3be31542180c0300b6860129ff1e3a428f3ef580727616ce22462626129b/pydantic_extra_types-2.11.2.tar.gz", hash = "sha256:3a2b83b61fe920925688e7838b59caa90a45637d1dbba2b1364b8d1f7ff72a0a", size = 203929, upload-time = "2026-04-05T20:50:51.556Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/66/71/dba38ee2651f84f7842206adbd2233d8bbdb59fb85e9fa14232486a8c471/pydantic_extra_types-2.11.1.tar.gz", hash = "sha256:46792d2307383859e923d8fcefa82108b1a141f8a9c0198982b3832ab5ef1049", size = 172002, upload-time = "2026-03-16T08:08:03.92Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/92/a4/7b6ab05c18d6c6e682382a0f0235301684452c4131a869f45961d1d032c9/pydantic_extra_types-2.11.2-py3-none-any.whl", hash = "sha256:683b8943252543e49760f89733b1519bc62f31d1a287ebbdc5a7b7959fb4acfd", size = 82851, upload-time = "2026-04-05T20:50:50.036Z" },
+    { url = "https://files.pythonhosted.org/packages/17/c1/3226e6d7f5a4f736f38ac11a6fbb262d701889802595cdb0f53a885ac2e0/pydantic_extra_types-2.11.1-py3-none-any.whl", hash = "sha256:1722ea2bddae5628ace25f2aa685b69978ef533123e5638cfbddb999e0100ec1", size = 79526, upload-time = "2026-03-16T08:08:02.533Z" },
 ]
 
 [[package]]
 name = "pydantic-settings"
-version = "2.13.1"
+version = "2.14.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "pydantic" },
     { name = "python-dotenv" },
     { name = "typing-inspection" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/52/6d/fffca34caecc4a3f97bda81b2098da5e8ab7efc9a66e819074a11955d87e/pydantic_settings-2.13.1.tar.gz", hash = "sha256:b4c11847b15237fb0171e1462bf540e294affb9b86db4d9aa5c01730bdbe4025", size = 223826, upload-time = "2026-02-19T13:45:08.055Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/42/98/c8345dccdc31de4228c039a98f6467a941e39558da41c1744fbe29fa5666/pydantic_settings-2.14.0.tar.gz", hash = "sha256:24285fd4b0e0c06507dd9fdfd331ee23794305352aaec8fc4eb92d4047aeb67d", size = 235709, upload-time = "2026-04-20T13:37:40.293Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/00/4b/ccc026168948fec4f7555b9164c724cf4125eac006e176541483d2c959be/pydantic_settings-2.13.1-py3-none-any.whl", hash = "sha256:d56fd801823dbeae7f0975e1f8c8e25c258eb75d278ea7abb5d9cebb01b56237", size = 58929, upload-time = "2026-02-19T13:45:06.034Z" },
+    { url = "https://files.pythonhosted.org/packages/01/dd/bebff3040138f00ae8a102d426b27349b9a49acc310fcae7f92112d867e3/pydantic_settings-2.14.0-py3-none-any.whl", hash = "sha256:fc8d5d692eb7092e43c8647c1c35a3ecd00e040fcf02ed86f4cb5458ca62182e", size = 60940, upload-time = "2026-04-20T13:37:38.586Z" },
 ]
 
 [[package]]
@@ -1323,11 +1338,11 @@ wheels = [
 
 [[package]]
 name = "python-multipart"
-version = "0.0.24"
+version = "0.0.27"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/8a/45/e23b5dc14ddb9918ae4a625379506b17b6f8fc56ca1d82db62462f59aea6/python_multipart-0.0.24.tar.gz", hash = "sha256:9574c97e1c026e00bc30340ef7c7d76739512ab4dfd428fec8c330fa6a5cc3c8", size = 37695, upload-time = "2026-04-05T20:49:13.829Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/69/9b/f23807317a113dc36e74e75eb265a02dd1a4d9082abc3c1064acd22997c4/python_multipart-0.0.27.tar.gz", hash = "sha256:9870a6a8c5a20a5bf4f07c017bd1489006ff8836cff097b6933355ee2b49b602", size = 44043, upload-time = "2026-04-27T10:51:26.649Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a3/73/89930efabd4da63cea44a3f438aeb753d600123570e6d6264e763617a9ce/python_multipart-0.0.24-py3-none-any.whl", hash = "sha256:9b110a98db707df01a53c194f0af075e736a770dc5058089650d70b4a182f950", size = 24420, upload-time = "2026-04-05T20:49:12.555Z" },
+    { url = "https://files.pythonhosted.org/packages/99/78/4126abcbdbd3c559d43e0db7f7b9173fc6befe45d39a2856cc0b8ec2a5a6/python_multipart-0.0.27-py3-none-any.whl", hash = "sha256:6fccfad17a27334bd0193681b369f476eda3409f17381a2d65aa7df3f7275645", size = 29254, upload-time = "2026-04-27T10:51:24.997Z" },
 ]
 
 [[package]]
@@ -1416,15 +1431,15 @@ wheels = [
 
 [[package]]
 name = "rich"
-version = "14.3.3"
+version = "15.0.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "markdown-it-py" },
     { name = "pygments" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/b3/c6/f3b320c27991c46f43ee9d856302c70dc2d0fb2dba4842ff739d5f46b393/rich-14.3.3.tar.gz", hash = "sha256:b8daa0b9e4eef54dd8cf7c86c03713f53241884e814f4e2f5fb342fe520f639b", size = 230582, upload-time = "2026-02-19T17:23:12.474Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/c0/8f/0722ca900cc807c13a6a0c696dacf35430f72e0ec571c4275d2371fca3e9/rich-15.0.0.tar.gz", hash = "sha256:edd07a4824c6b40189fb7ac9bc4c52536e9780fbbfbddf6f1e2502c31b068c36", size = 230680, upload-time = "2026-04-12T08:24:00.75Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/14/25/b208c5683343959b670dc001595f2f3737e051da617f66c31f7c4fa93abc/rich-14.3.3-py3-none-any.whl", hash = "sha256:793431c1f8619afa7d3b52b2cdec859562b950ea0d4b6b505397612db8d5362d", size = 310458, upload-time = "2026-02-19T17:23:13.732Z" },
+    { url = "https://files.pythonhosted.org/packages/82/3b/64d4899d73f91ba49a8c18a8ff3f0ea8f1c1d75481760df8c68ef5235bf5/rich-15.0.0-py3-none-any.whl", hash = "sha256:33bd4ef74232fb73fe9279a257718407f169c09b78a87ad3d296f548e27de0bb", size = 310654, upload-time = "2026-04-12T08:24:02.83Z" },
 ]
 
 [[package]]
@@ -1540,15 +1555,15 @@ wheels = [
 
 [[package]]
 name = "sentry-sdk"
-version = "2.57.0"
+version = "2.58.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "certifi" },
     { name = "urllib3" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/4f/87/46c0406d8b5ddd026f73adaf5ab75ce144219c41a4830b52df4b9ab55f7f/sentry_sdk-2.57.0.tar.gz", hash = "sha256:4be8d1e71c32fb27f79c577a337ac8912137bba4bcbc64a4ec1da4d6d8dc5199", size = 435288, upload-time = "2026-03-31T09:39:29.264Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/26/b3/fb8291170d0e844173164709fc0fa0c221ed75a5da740c8746f2a83b4eb1/sentry_sdk-2.58.0.tar.gz", hash = "sha256:c1144d947352d54e5b7daa63596d9f848adf684989c06c4f5a659f0c85a18f6f", size = 438764, upload-time = "2026-04-13T17:23:26.265Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c9/64/982e07b93219cb52e1cca5d272cb579e2f3eb001956c9e7a9a6d106c9473/sentry_sdk-2.57.0-py2.py3-none-any.whl", hash = "sha256:812c8bf5ff3d2f0e89c82f5ce80ab3a6423e102729c4706af7413fd1eb480585", size = 456489, upload-time = "2026-03-31T09:39:27.524Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/eb/d875669993b762556ae8b2efd86219943b4c0864d22204d622a9aee3052b/sentry_sdk-2.58.0-py2.py3-none-any.whl", hash = "sha256:688d1c704ddecf382ea3326f21a67453d4caa95592d722b7c780a36a9d23109e", size = 460919, upload-time = "2026-04-13T17:23:24.675Z" },
 ]
 
 [[package]]
@@ -1596,15 +1611,15 @@ asyncio = [
 
 [[package]]
 name = "sse-starlette"
-version = "3.3.4"
+version = "3.4.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "anyio" },
     { name = "starlette" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/26/8c/f9290339ef6d79badbc010f067cd769d6601ec11a57d78569c683fb4dd87/sse_starlette-3.3.4.tar.gz", hash = "sha256:aaf92fc067af8a5427192895ac028e947b484ac01edbc3caf00e7e7137c7bef1", size = 32427, upload-time = "2026-03-29T09:00:23.307Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/e1/9a/f35932a8c0eb6b2287b66fa65a0321df8c84e4e355a659c1841a37c39fdb/sse_starlette-3.4.1.tar.gz", hash = "sha256:f780bebcf6c8997fe514e3bd8e8c648d8284976b391c8bed0bcb1f611632b555", size = 35127, upload-time = "2026-04-26T13:32:32.292Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/f8/7f/3de5402f39890ac5660b86bcf5c03f9d855dad5c4ed764866d7b592b46fd/sse_starlette-3.3.4-py3-none-any.whl", hash = "sha256:84bb06e58939a8b38d8341f1bc9792f06c2b53f48c608dd207582b664fc8f3c1", size = 14330, upload-time = "2026-03-29T09:00:21.846Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/07/45c21ed03d708c477367305726b89919b020a3a2a01f72aaf5ad941caf35/sse_starlette-3.4.1-py3-none-any.whl", hash = "sha256:6b43cf21f1d574d582a6e1b0cfbde1c94dc86a32a701a7168c99c4475c6bd1d0", size = 16487, upload-time = "2026-04-26T13:32:30.819Z" },
 ]
 
 [[package]]
@@ -1620,18 +1635,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/0b/c9/584bc9651441b4ba60cc4d557d8a547b5aff901af35bda3a4ee30c819b82/starlette-1.0.0-py3-none-any.whl", hash = "sha256:d3ec55e0bb321692d275455ddfd3df75fff145d009685eb40dc91fc66b03d38b", size = 72651, upload-time = "2026-03-22T18:29:45.111Z" },
 ]
 
-[[package]]
-name = "sympy"
-version = "1.14.0"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "mpmath" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/83/d3/803453b36afefb7c2bb238361cd4ae6125a569b4db67cd9e79846ba2d68c/sympy-1.14.0.tar.gz", hash = "sha256:d3d3fe8df1e5a0b42f0e7bdf50541697dbe7d23746e894990c030e2b05e72517", size = 7793921, upload-time = "2025-04-27T18:05:01.611Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/a2/09/77d55d46fd61b4a135c444fc97158ef34a095e5681d0a6c10b75bf356191/sympy-1.14.0-py3-none-any.whl", hash = "sha256:e091cc3e99d2141a0ba2847328f5479b05d94a6635cb96148ccb3f34671bd8f5", size = 6299353, upload-time = "2025-04-27T18:04:59.103Z" },
-]
-
 [[package]]
 name = "tokenizers"
 version = "0.22.2"
@@ -1672,7 +1675,7 @@ wheels = [
 
 [[package]]
 name = "typer"
-version = "0.24.1"
+version = "0.25.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "annotated-doc" },
@@ -1680,9 +1683,9 @@ dependencies = [
     { name = "rich" },
     { name = "shellingham" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/f5/24/cb09efec5cc954f7f9b930bf8279447d24618bb6758d4f6adf2574c41780/typer-0.24.1.tar.gz", hash = "sha256:e39b4732d65fbdcde189ae76cf7cd48aeae72919dea1fdfc16593be016256b45", size = 118613, upload-time = "2026-02-21T16:54:40.609Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/7b/27/ede8cec7596e0041ba7e7b80b47d132562f56ff454313a16f6084e555c9f/typer-0.25.0.tar.gz", hash = "sha256:123eaf9f19bb40fd268310e12a542c0c6b4fab9c98d9d23342a01ff95e3ce930", size = 120150, upload-time = "2026-04-26T08:46:14.767Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/4a/91/48db081e7a63bb37284f9fbcefda7c44c277b18b0e13fbc36ea2335b71e6/typer-0.24.1-py3-none-any.whl", hash = "sha256:112c1f0ce578bfb4cab9ffdabc68f031416ebcc216536611ba21f04e9aa84c9e", size = 56085, upload-time = "2026-02-21T16:54:41.616Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/72/193d4e586ec5a4db834a36bbeb47641a62f951f114ffd0fe5b1b46e8d56f/typer-0.25.0-py3-none-any.whl", hash = "sha256:ac01b48823d3db9a83c9e164338057eadbb1c9957a2a6b4eeb486669c560b5dc", size = 55993, upload-time = "2026-04-26T08:46:15.889Z" },
 ]
 
 [[package]]
@@ -1708,11 +1711,11 @@ wheels = [
 
 [[package]]
 name = "tzdata"
-version = "2026.1"
+version = "2026.2"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/19/f5/cd531b2d15a671a40c0f66cf06bc3570a12cd56eef98960068ebbad1bf5a/tzdata-2026.1.tar.gz", hash = "sha256:67658a1903c75917309e753fdc349ac0efd8c27db7a0cb406a25be4840f87f98", size = 197639, upload-time = "2026-04-03T11:25:22.002Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/ba/19/1b9b0e29f30c6d35cb345486df41110984ea67ae69dddbc0e8a100999493/tzdata-2026.2.tar.gz", hash = "sha256:9173fde7d80d9018e02a662e168e5a2d04f87c41ea174b139fbef642eda62d10", size = 198254, upload-time = "2026-04-24T15:22:08.651Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/b0/70/d460bd685a170790ec89317e9bd33047988e4bce507b831f5db771e142de/tzdata-2026.1-py2.py3-none-any.whl", hash = "sha256:4b1d2be7ac37ceafd7327b961aa3a54e467efbdb563a23655fbfe0d39cfc42a9", size = 348952, upload-time = "2026-04-03T11:25:20.313Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/e4/dccd7f47c4b64213ac01ef921a1337ee6e30e8c6466046018326977efd95/tzdata-2026.2-py2.py3-none-any.whl", hash = "sha256:bbe9af844f658da81a5f95019480da3a89415801f6cc966806612cc7169bffe7", size = 349321, upload-time = "2026-04-24T15:22:05.876Z" },
 ]
 
 [[package]]
@@ -1747,15 +1750,15 @@ wheels = [
 
 [[package]]
 name = "uvicorn"
-version = "0.44.0"
+version = "0.46.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
     { name = "h11" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/5e/da/6eee1ff8b6cbeed47eeb5229749168e81eb4b7b999a1a15a7176e51410c9/uvicorn-0.44.0.tar.gz", hash = "sha256:6c942071b68f07e178264b9152f1f16dfac5da85880c4ce06366a96d70d4f31e", size = 86947, upload-time = "2026-04-06T09:23:22.826Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/1f/93/041fca8274050e40e6791f267d82e0e2e27dd165627bd640d3e0e378d877/uvicorn-0.46.0.tar.gz", hash = "sha256:fb9da0926999cc6cb22dc7cd71a94a632f078e6ae47ff683c5c420750fb7413d", size = 88758, upload-time = "2026-04-23T07:16:00.151Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/b7/23/a5bbd9600dd607411fa644c06ff4951bec3a4d82c4b852374024359c19c0/uvicorn-0.44.0-py3-none-any.whl", hash = "sha256:ce937c99a2cc70279556967274414c087888e8cec9f9c94644dfca11bd3ced89", size = 69425, upload-time = "2026-04-06T09:23:21.524Z" },
+    { url = "https://files.pythonhosted.org/packages/31/a3/5b1562db76a5a488274b2332a97199b32d0442aca0ed193697fd47786316/uvicorn-0.46.0-py3-none-any.whl", hash = "sha256:bbebbcbed972d162afca128605223022bedd345b7bc7855ce66deb31487a9048", size = 70926, upload-time = "2026-04-23T07:15:58.355Z" },
 ]
 
 [package.optional-dependencies]
@@ -1827,9 +1830,9 @@ wheels = [
 
 [[package]]
 name = "zipp"
-version = "3.23.0"
+version = "3.23.1"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/e3/02/0f2892c661036d50ede074e376733dca2ae7c6eb617489437771209d4180/zipp-3.23.0.tar.gz", hash = "sha256:a07157588a12518c9d4034df3fbbee09c814741a33ff63c05fa29d26a2404166", size = 25547, upload-time = "2025-06-08T17:06:39.4Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/30/21/093488dfc7cc8964ded15ab726fad40f25fd3d788fd741cc1c5a17d78ee8/zipp-3.23.1.tar.gz", hash = "sha256:32120e378d32cd9714ad503c1d024619063ec28aad2248dc6672ad13edfa5110", size = 25965, upload-time = "2026-04-13T23:21:46.6Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/2e/54/647ade08bf0db230bfea292f893923872fd20be6ac6f53b2b936ba839d75/zipp-3.23.0-py3-none-any.whl", hash = "sha256:071652d6115ed432f5ce1d34c336c0adfd6a884660d1e9712a256d3d3bd4b14e", size = 10276, upload-time = "2025-06-08T17:06:38.034Z" },
+    { url = "https://files.pythonhosted.org/packages/08/8a/0861bec20485572fbddf3dfba2910e38fe249796cb73ecdeb74e07eeb8d3/zipp-3.23.1-py3-none-any.whl", hash = "sha256:0b3596c50a5c700c9cb40ba8d86d9f2cc4807e9bedb06bcdf7fac85633e444dc", size = 10378, upload-time = "2026-04-13T23:21:45.386Z" },
 ]

From 9e435a42ff741177fe054af09786cab772e591ce Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 27 Apr 2026 17:02:54 +0200
Subject: [PATCH 15/16] Refactor schema organization by categorizing into 'api'
 and 'tools' packages.

---
 src/memlord/api/memories.py                |  5 +++--
 src/memlord/api/search.py                  |  2 +-
 src/memlord/api/workspaces.py              |  3 +--
 src/memlord/dao/memory.py                  |  5 +----
 src/memlord/schemas/__init__.py            | 23 +---------------------
 src/memlord/schemas/api/__init__.py        |  2 +-
 src/memlord/schemas/api/import_item.py     |  5 +++++
 src/memlord/schemas/api/memory_response.py |  2 +-
 src/memlord/schemas/memory_list_item.py    | 20 +++++++++++++++++++
 src/memlord/schemas/tools/__init__.py      |  2 +-
 src/memlord/schemas/tools/list_memories.py | 17 ----------------
 src/memlord/schemas/workspace.py           |  5 -----
 src/memlord/tools/delete.py                |  2 +-
 src/memlord/tools/get_memory.py            |  2 +-
 src/memlord/tools/list_memories.py         |  3 ++-
 src/memlord/tools/move.py                  |  2 +-
 src/memlord/tools/recall.py                |  3 ++-
 src/memlord/tools/retrieve.py              |  3 ++-
 src/memlord/tools/search_by_tag.py         |  2 +-
 src/memlord/tools/store.py                 |  3 ++-
 src/memlord/tools/update.py                |  3 ++-
 21 files changed, 49 insertions(+), 65 deletions(-)
 create mode 100644 src/memlord/schemas/memory_list_item.py

diff --git a/src/memlord/api/memories.py b/src/memlord/api/memories.py
index e035b78..e3a4c89 100644
--- a/src/memlord/api/memories.py
+++ b/src/memlord/api/memories.py
@@ -6,13 +6,14 @@
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import APISessionDep
 from memlord.models import Memory, MemoryTag, Tag
-from memlord.schemas import MemoryType, UpdateMemoryRequest
-from memlord.schemas.memory_response import (
+from memlord.schemas import MemoryType
+from memlord.schemas.api import (
     MemoriesFilter,
     MemoriesResponse,
     MemoryDetail,
     MemoryItem,
     MoveRequest,
+    UpdateMemoryRequest,
     WorkspaceSimple,
 )
 from memlord.schemas.workspace import WorkspaceRole
diff --git a/src/memlord/api/search.py b/src/memlord/api/search.py
index 366d8b3..c3be69f 100644
--- a/src/memlord/api/search.py
+++ b/src/memlord/api/search.py
@@ -6,7 +6,7 @@
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import APISessionDep
 from memlord.models import Memory
-from memlord.schemas import SearchItem, SearchResponse
+from memlord.schemas.api import SearchItem, SearchResponse
 from memlord.search import hybrid_search
 from memlord.ui.utils import APIUserDep
 
diff --git a/src/memlord/api/workspaces.py b/src/memlord/api/workspaces.py
index 91aa252..ead11bb 100644
--- a/src/memlord/api/workspaces.py
+++ b/src/memlord/api/workspaces.py
@@ -12,14 +12,13 @@
 from memlord.schemas import (
     CreateWorkspaceRequest,
     DescriptionRequest,
-    ImportItem,
-    ImportResult,
     InviteRequest,
     InviteResponse,
     RenameRequest,
     WorkspaceDetailResponse,
     WorkspaceInfo,
 )
+from memlord.schemas.api import ImportItem, ImportResult
 from memlord.schemas.workspace import WorkspaceRole
 from memlord.ui.utils import APIUserDep
 from memlord.utils.dt import utcnow
diff --git a/src/memlord/dao/memory.py b/src/memlord/dao/memory.py
index 8231c75..5ce18ea 100644
--- a/src/memlord/dao/memory.py
+++ b/src/memlord/dao/memory.py
@@ -194,10 +194,7 @@ async def update(
 
         if values:
             final_name: str = await self._s.scalar(  # type: ignore[assignment]
-                update(Memory)
-                .where(Memory.id == memory_id)
-                .values(**values)
-                .returning(Memory.name)
+                update(Memory).where(Memory.id == memory_id).values(**values).returning(Memory.name)
             )
         else:
             final_name = await self._s.scalar(  # type: ignore[assignment]
diff --git a/src/memlord/schemas/__init__.py b/src/memlord/schemas/__init__.py
index a0b48cf..a472e3e 100644
--- a/src/memlord/schemas/__init__.py
+++ b/src/memlord/schemas/__init__.py
@@ -1,31 +1,10 @@
-from .api import (
-    ImportItem,
-    MemoriesFilter,
-    MemoriesResponse,
-    MoveRequest,
-    SearchItem,
-    SearchResponse,
-    UpdateMemoryRequest,
-    WorkspaceSimple,
-)
+from .memory_list_item import MemoryListItem
 from .memory_type import MemoryType
 from .search import SearchResult
-from .tools import (
-    DeleteResult,
-    MemoryDetail,
-    MemoryItem,
-    MemoryListItem,
-    MemoryPage,
-    MemoryResult,
-    RecallPage,
-    RecallResult,
-    StoreResult,
-)
 from .user import UserInfo
 from .workspace import (
     CreateWorkspaceRequest,
     DescriptionRequest,
-    ImportResult,
     InviteRequest,
     InviteResponse,
     RenameRequest,
diff --git a/src/memlord/schemas/api/__init__.py b/src/memlord/schemas/api/__init__.py
index 8dc0415..1d53af3 100644
--- a/src/memlord/schemas/api/__init__.py
+++ b/src/memlord/schemas/api/__init__.py
@@ -1,4 +1,4 @@
-from .import_item import ImportItem
+from .import_item import ImportItem, ImportResult
 from .memory_response import (
     MemoriesFilter,
     MemoriesResponse,
diff --git a/src/memlord/schemas/api/import_item.py b/src/memlord/schemas/api/import_item.py
index c61fcdb..67cf4d6 100644
--- a/src/memlord/schemas/api/import_item.py
+++ b/src/memlord/schemas/api/import_item.py
@@ -21,3 +21,8 @@ def fill_name(cls, data: dict) -> dict:
         if not data.get("name"):
             data["name"] = (data.get("content") or "")[:60].strip()
         return data
+
+
+class ImportResult(BaseModel):
+    imported: int
+    skipped: int
diff --git a/src/memlord/schemas/api/memory_response.py b/src/memlord/schemas/api/memory_response.py
index 5614ff1..577da1f 100644
--- a/src/memlord/schemas/api/memory_response.py
+++ b/src/memlord/schemas/api/memory_response.py
@@ -1,6 +1,6 @@
 from pydantic import BaseModel
 
-from memlord.schemas.pagination import Paginated
+from ..pagination import Paginated
 
 
 class MemoriesFilter(BaseModel):
diff --git a/src/memlord/schemas/memory_list_item.py b/src/memlord/schemas/memory_list_item.py
new file mode 100644
index 0000000..808de03
--- /dev/null
+++ b/src/memlord/schemas/memory_list_item.py
@@ -0,0 +1,20 @@
+from datetime import UTC, datetime
+
+from pydantic import BaseModel, Field, NaiveDatetime, field_serializer
+
+from .memory_type import MemoryType
+
+
+class MemoryListItem(BaseModel):
+    id: int
+    name: str
+    content: str
+    memory_type: MemoryType
+    metadata: dict = Field(default_factory=dict)
+    tags: set[str]
+    created_at: NaiveDatetime
+    workspace_id: int
+
+    @field_serializer("created_at")
+    def serialize_created_at(self, v: datetime) -> str:
+        return v.replace(tzinfo=UTC).isoformat()
diff --git a/src/memlord/schemas/tools/__init__.py b/src/memlord/schemas/tools/__init__.py
index 432aacc..50825dd 100644
--- a/src/memlord/schemas/tools/__init__.py
+++ b/src/memlord/schemas/tools/__init__.py
@@ -1,5 +1,5 @@
 from .delete import DeleteResult
-from .list_memories import MemoryDetail, MemoryItem, MemoryListItem, MemoryPage
+from .list_memories import MemoryDetail, MemoryItem, MemoryPage
 from .recall import RecallPage, RecallResult
 from .retrieve import MemoryResult
 from .store import StoreResult
diff --git a/src/memlord/schemas/tools/list_memories.py b/src/memlord/schemas/tools/list_memories.py
index a3f7b58..7d5b934 100644
--- a/src/memlord/schemas/tools/list_memories.py
+++ b/src/memlord/schemas/tools/list_memories.py
@@ -6,23 +6,6 @@
 from ..pagination import Paginated
 
 
-class MemoryListItem(BaseModel):
-    """Full memory record — used by UI and DAO."""
-
-    id: int
-    name: str
-    content: str
-    memory_type: MemoryType
-    metadata: dict = Field(default_factory=dict)
-    tags: set[str]
-    created_at: NaiveDatetime
-    workspace_id: int
-
-    @field_serializer("created_at")
-    def serialize_created_at(self, v: datetime) -> str:
-        return v.replace(tzinfo=UTC).isoformat()
-
-
 class MemoryItem(BaseModel):
     """Slim memory record returned by MCP list/search tools (no id, no content)."""
 
diff --git a/src/memlord/schemas/workspace.py b/src/memlord/schemas/workspace.py
index a9f001d..dfbbca6 100644
--- a/src/memlord/schemas/workspace.py
+++ b/src/memlord/schemas/workspace.py
@@ -54,8 +54,3 @@ class InviteResponse(BaseModel):
     invite_url: str
     expires_in_hours: int
     role: str
-
-
-class ImportResult(BaseModel):
-    imported: int
-    skipped: int
diff --git a/src/memlord/tools/delete.py b/src/memlord/tools/delete.py
index 09f79ec..040dab4 100644
--- a/src/memlord/tools/delete.py
+++ b/src/memlord/tools/delete.py
@@ -6,7 +6,7 @@
 from memlord.dao import MemoryDao
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
-from memlord.schemas import DeleteResult
+from memlord.schemas.tools import DeleteResult
 
 mcp = FastMCP()
 
diff --git a/src/memlord/tools/get_memory.py b/src/memlord/tools/get_memory.py
index 660a9a8..f184bd4 100644
--- a/src/memlord/tools/get_memory.py
+++ b/src/memlord/tools/get_memory.py
@@ -6,7 +6,7 @@
 from memlord.dao import MemoryDao
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
-from memlord.schemas import MemoryDetail
+from memlord.schemas.tools import MemoryDetail
 
 mcp = FastMCP()
 
diff --git a/src/memlord/tools/list_memories.py b/src/memlord/tools/list_memories.py
index c725850..b197b4f 100644
--- a/src/memlord/tools/list_memories.py
+++ b/src/memlord/tools/list_memories.py
@@ -9,7 +9,8 @@
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
 from memlord.models import Memory, MemoryTag, Tag, Workspace
-from memlord.schemas import MemoryItem, MemoryPage, MemoryType
+from memlord.schemas import MemoryType
+from memlord.schemas.tools import MemoryItem, MemoryPage
 
 mcp = FastMCP()
 
diff --git a/src/memlord/tools/move.py b/src/memlord/tools/move.py
index b2dca48..73c4cad 100644
--- a/src/memlord/tools/move.py
+++ b/src/memlord/tools/move.py
@@ -6,7 +6,7 @@
 from memlord.dao import MemoryDao
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
-from memlord.schemas import StoreResult
+from memlord.schemas.tools import StoreResult
 
 mcp = FastMCP()
 
diff --git a/src/memlord/tools/recall.py b/src/memlord/tools/recall.py
index b8b6fde..3b0f8b6 100644
--- a/src/memlord/tools/recall.py
+++ b/src/memlord/tools/recall.py
@@ -12,7 +12,8 @@
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
 from memlord.models import Memory
-from memlord.schemas import MemoryType, RecallPage, RecallResult
+from memlord.schemas import MemoryType
+from memlord.schemas.tools import RecallPage, RecallResult
 from memlord.search import hybrid_search
 
 mcp = FastMCP()
diff --git a/src/memlord/tools/retrieve.py b/src/memlord/tools/retrieve.py
index 3c0cb03..898e231 100644
--- a/src/memlord/tools/retrieve.py
+++ b/src/memlord/tools/retrieve.py
@@ -8,7 +8,8 @@
 from memlord.dao import MemoryDao
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
-from memlord.schemas import MemoryResult, MemoryType
+from memlord.schemas import MemoryType
+from memlord.schemas.tools import MemoryResult
 from memlord.search import hybrid_search
 from memlord.utils.dt import utcnow
 
diff --git a/src/memlord/tools/search_by_tag.py b/src/memlord/tools/search_by_tag.py
index 9976bfc..bfccdd4 100644
--- a/src/memlord/tools/search_by_tag.py
+++ b/src/memlord/tools/search_by_tag.py
@@ -10,7 +10,7 @@
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
 from memlord.models import Memory, MemoryTag, Tag, Workspace
-from memlord.schemas import MemoryItem, MemoryPage
+from memlord.schemas.tools import MemoryItem, MemoryPage
 
 mcp = FastMCP()
 
diff --git a/src/memlord/tools/store.py b/src/memlord/tools/store.py
index 7fd7733..7cb95fb 100644
--- a/src/memlord/tools/store.py
+++ b/src/memlord/tools/store.py
@@ -7,7 +7,8 @@
 from memlord.dao import MemoryDao
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
-from memlord.schemas import MemoryType, StoreResult
+from memlord.schemas import MemoryType
+from memlord.schemas.tools import StoreResult
 
 mcp = FastMCP()
 
diff --git a/src/memlord/tools/update.py b/src/memlord/tools/update.py
index 11835d7..8de345c 100644
--- a/src/memlord/tools/update.py
+++ b/src/memlord/tools/update.py
@@ -8,7 +8,8 @@
 from memlord.dao import MemoryDao
 from memlord.dao.workspace import WorkspaceDao
 from memlord.db import MCPSessionDep
-from memlord.schemas import MemoryType, StoreResult
+from memlord.schemas import MemoryType
+from memlord.schemas.tools import StoreResult
 
 mcp = FastMCP()
 

From 61e5ddc78111e6ea50beebe8853492d0c8d294e5 Mon Sep 17 00:00:00 2001
From: Myrik <myrik260138@gmail.com>
Date: Mon, 27 Apr 2026 17:05:25 +0200
Subject: [PATCH 16/16] Fix memory name handling for migration: simplify logic
 for short content names.

---
 .../versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py b/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py
index feb83dc..f5a148e 100644
--- a/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py
+++ b/migrations/versions/2026_04_08_0002-f8c1fc9be252_add_memory_name.py
@@ -71,7 +71,7 @@ def upgrade() -> None:
         SET name = CASE 
             WHEN LENGTH(m.content) > 60
             THEN LEFT(TRIM(m.content), 60) || '...'
-            ELSE LEFT(TRIM(m.content), 60) 
+            ELSE m.content
             END
         WHERE m.name IS NULL
     """))