bazaar-compute-node 0.1.20__tar.gz → 0.1.22__tar.gz

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bazaar-compute-node
-Version: 0.1.20
+Version: 0.1.22
 Summary: Runtime-agnostic computer node daemon for agents and channels.
 License-Expression: AGPL-3.0-only
 License-File: LICENSE

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bazaar-compute-node"
-version = "0.1.20"
+version = "0.1.22"
 description = "Runtime-agnostic computer node daemon for agents and channels."
 readme = "README.md"
 license = "AGPL-3.0-only"

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "bazaar-compute-node"
-version = "0.1.20"
+version = "0.1.22"
 description = "Runtime-agnostic computer node daemon for agents and channels."
 readme = "README.md"
 license = "AGPL-3.0-only"

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/src/bazaar_compute_node/app/attachments.py

@@ -88,10 +88,14 @@ class AttachmentMaterializer:
             size = 0
             descriptor: int | None = None
             try:
+                open_flags = os.O_WRONLY | os.O_CREAT | os.O_EXCL
+                binary_flag = getattr(os, "O_BINARY", None)
+                if binary_flag is not None:
+                    open_flags |= binary_flag
                 descriptor = await asyncio.to_thread(
                     os.open,
                     temporary,
-                    os.O_WRONLY | os.O_CREAT | os.O_EXCL,
+                    open_flags,
                     0o600,
                 )
                 try:
@@ -117,6 +121,12 @@ class AttachmentMaterializer:
                                 raise ValueError("attachment workspace quota exceeded")
                             await asyncio.to_thread(_write_all, descriptor, chunk)
                     await asyncio.to_thread(os.fsync, descriptor)
+                    stored_size = await asyncio.to_thread(os.fstat, descriptor)
+                    if stored_size.st_size != size:
+                        raise OSError(
+                            "attachment write size mismatch: "
+                            f"expected {size}, got {stored_size.st_size}"
+                        )
                 finally:
                     await asyncio.to_thread(os.close, descriptor)
                     descriptor = None
@@ -165,7 +175,8 @@ class AttachmentMaterializer:
             return 0
         return sum(
             path.stat().st_size
-            for path in root.glob("*/content.*")
+            for pattern in ("*/content", "*/content.*")
+            for path in root.glob(pattern)
             if path.is_file() and not path.is_symlink()
         )
 
@@ -183,8 +194,11 @@ def _attachment_suffix(name: str, media_type: str | None) -> str:
     suffix = Path(name).suffix
     if _SAFE_SUFFIX.fullmatch(suffix):
         return suffix
-    guessed = mimetypes.guess_extension(media_type or "") or ".bin"
-    return guessed if _SAFE_SUFFIX.fullmatch(guessed) else ".bin"
+    media_type = (media_type or "").partition(";")[0].strip().lower()
+    if not media_type or media_type.endswith("/octet-stream"):
+        return ""
+    guessed = mimetypes.guess_extension(media_type) or ""
+    return guessed if _SAFE_SUFFIX.fullmatch(guessed) else ""
 
 
 __all__ = ["AttachmentMaterializer"]

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/src/bazaar_compute_node/bcc.py

@@ -12,7 +12,7 @@ from uuid import uuid7
 
 from .app.command import format_message_time
 from .app.transport import LocalCommandClient
-from .core.reminder import format_utc_timestamp, short_id
+from .core.reminder import format_utc_timestamp
 
 
 class BccCommandError(RuntimeError):
@@ -202,7 +202,7 @@ def build_parser() -> argparse.ArgumentParser:
     schedule_parser.add_argument(
         "--message-id",
         metavar="<id>",
-        help="Required full or unique short local inbound message id used as anchor.",
+        help="Required full uuid for the local inbound message used as anchor.",
     )
 
     reminder_subparsers.add_parser(
@@ -241,7 +241,7 @@ def build_parser() -> argparse.ArgumentParser:
         "--id",
         dest="reminder_id",
         metavar="<id>",
-        help="Reminder id (full uuid or short prefix)",
+        help="Reminder id (full uuid)",
     )
     snooze_parser.add_argument(
         "--by",
@@ -258,7 +258,7 @@ def build_parser() -> argparse.ArgumentParser:
         "--id",
         dest="reminder_id",
         metavar="<id>",
-        help="Reminder id (full uuid or short prefix)",
+        help="Reminder id (full uuid)",
     )
     update_parser.add_argument(
         "--fire-at",
@@ -284,14 +284,14 @@ def build_parser() -> argparse.ArgumentParser:
 
     cancel_parser = reminder_subparsers.add_parser(
         "cancel",
-        help="Cancel a scheduled reminder by id (full uuid or 8-char prefix)",
-        description="Cancel a scheduled reminder by id (full uuid or 8-char prefix)",
+        help="Cancel a scheduled reminder by id (full uuid)",
+        description="Cancel a scheduled reminder by id (full uuid)",
     )
     cancel_parser.add_argument(
         "--id",
         dest="reminder_id",
         metavar="<id>",
-        help="Reminder id (full uuid or short prefix)",
+        help="Reminder id (full uuid)",
     )
     return parser
 
@@ -714,13 +714,6 @@ def _require_reminder(result: Mapping[str, object]) -> Mapping[str, object]:
     return reminder
 
 
-def _short_uuid(value: str) -> str:
-    try:
-        return short_id(value)
-    except ValueError as error:
-        raise BccCommandError(str(error), code="INVALID_RESPONSE") from error
-
-
 def _reminder_label(reminder: Mapping[str, object]) -> str:
     repeat_rule = reminder.get("repeat_rule")
     if repeat_rule is None:
@@ -736,7 +729,7 @@ def _quoted_title(reminder: Mapping[str, object]) -> str:
 
 def serialize_reminder_schedule(result: Mapping[str, object]) -> str:
     reminder = _require_reminder(result)
-    reminder_id = _short_uuid(_require_text(reminder, "reminder_id"))
+    reminder_id = _require_text(reminder, "reminder_id")
     next_fire = _optional_non_negative_int(reminder, "next_fire_at_ms")
     if next_fire is None:
         _invalid_response("scheduled Reminder response has no next fire time")
@@ -763,7 +756,7 @@ def serialize_reminder_check(result: Mapping[str, object]) -> str:
         occurrence = item.get("occurrence")
         if not isinstance(occurrence, Mapping):
             _invalid_response("Reminder check item has no occurrence")
-        reminder_id = _short_uuid(_require_text(occurrence, "reminder_id"))
+        reminder_id = _require_text(occurrence, "reminder_id")
         occurrence_no = _require_non_negative_int(occurrence, "occurrence_no")
         if occurrence_no <= 0:
             _invalid_response("Reminder occurrence number must be positive")
@@ -809,8 +802,8 @@ def serialize_reminder_list(result: Mapping[str, object]) -> str:
         return "No reminders."
     lines: list[str] = []
     for reminder in reminders:
-        reminder_id = _short_uuid(_require_text(reminder, "reminder_id"))
-        anchor = _short_uuid(_require_text(reminder, "anchor_message_id"))
+        reminder_id = _require_text(reminder, "reminder_id")
+        anchor = _require_text(reminder, "anchor_message_id")
         state = _require_text(reminder, "state")
         title = _quoted_title(reminder)
         label = _reminder_label(reminder)
@@ -850,7 +843,7 @@ def _serialize_reminder_mutation(
     include_next: bool,
 ) -> str:
     reminder = _require_reminder(result)
-    reminder_id = _short_uuid(_require_text(reminder, "reminder_id"))
+    reminder_id = _require_text(reminder, "reminder_id")
     line = f"Reminder {verb}: #{reminder_id}"
     if not include_next:
         return line

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/src/bazaar_compute_node/contrib/lark/attachments.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import asyncio
 import json
+import mimetypes
 from collections import OrderedDict
 from collections.abc import AsyncIterable, AsyncIterator, Mapping
 from contextlib import suppress
@@ -248,16 +249,22 @@ class LarkResourceCache:
                 ):
                     raise ValueError("resource_too_large")
                 name = _safe_filename(
-                    _content_disposition_filename(
-                        response.headers.get("Content-Disposition")
-                    ),
-                    fallback=name,
+                    name,
+                    fallback=resource.resource_type,
                     resource_type=resource.resource_type,
                 )
                 media_type = _safe_media_type(
                     response.headers.get("Content-Type"),
                     fallback=media_type,
                 )
+                name = _resolve_resource_name(
+                    event_name=name,
+                    response_name=_content_disposition_filename(
+                        response.headers.get("Content-Disposition")
+                    ),
+                    media_type=media_type,
+                    resource_type=resource.resource_type,
+                )
                 return await self._materializer.materialize(
                     _bounded_stream(
                         response.content.iter_chunked(_RESOURCE_CHUNK_BYTES)
@@ -475,7 +482,7 @@ def _resource_from_mapping(
             break
     name = _safe_filename(
         raw_name,
-        fallback=f"{resource_type}.bin",
+        fallback=resource_type,
         resource_type=resource_type,
     )
     media_type = _safe_media_type(mapping.get("mime_type"))
@@ -550,23 +557,71 @@ def _safe_filename(
     resource_type: str,
 ) -> str:
     candidate = value if isinstance(value, str) and value else fallback
-    if (
-        not candidate
-        or len(candidate) > 255
-        or "/" in candidate
-        or "\\" in candidate
-        or any(ord(character) < 32 or ord(character) == 127 for character in candidate)
-    ):
+    if not _is_safe_filename(candidate):
         candidate = fallback
-    if (
-        not candidate
-        or len(candidate) > 255
-        or "/" in candidate
-        or "\\" in candidate
-        or any(ord(character) < 32 or ord(character) == 127 for character in candidate)
-    ):
-        return f"{resource_type}.bin"
-    return candidate
+    return candidate if _is_safe_filename(candidate) else resource_type
+
+
+def _resolve_resource_name(
+    *,
+    event_name: str,
+    response_name: str | None,
+    media_type: str | None,
+    resource_type: str,
+) -> str:
+    response_name = response_name if _is_safe_filename(response_name) else None
+    if _safe_suffix(event_name):
+        name = event_name
+    elif response_name is not None and _safe_suffix(response_name):
+        name = response_name
+    elif event_name != resource_type:
+        name = event_name
+    elif response_name is not None:
+        name = response_name
+    else:
+        name = event_name
+
+    if _safe_suffix(name):
+        return name
+    suffix = _suffix_from_media_type(media_type)
+    if not suffix and resource_type == "audio":
+        suffix = ".mp3"
+    return f"{name}{suffix}" if suffix else name
+
+
+def _is_safe_filename(value: object) -> bool:
+    return (
+        isinstance(value, str)
+        and bool(value)
+        and len(value) <= 255
+        and "/" not in value
+        and "\\" not in value
+        and not any(ord(character) < 32 or ord(character) == 127 for character in value)
+    )
+
+
+def _safe_suffix(name: str) -> str:
+    dot = name.rfind(".")
+    if dot <= 0:
+        return ""
+    suffix = name[dot:]
+    return (
+        suffix
+        if 1 < len(suffix) <= 11 and suffix[1:].isascii() and suffix[1:].isalnum()
+        else ""
+    )
+
+
+def _suffix_from_media_type(media_type: str | None) -> str:
+    media_type = (media_type or "").partition(";")[0].strip().lower()
+    if not media_type or media_type.endswith("/octet-stream"):
+        return ""
+    suffix = mimetypes.guess_extension(media_type) or ""
+    return (
+        suffix
+        if 1 < len(suffix) <= 11 and suffix[1:].isascii() and suffix[1:].isalnum()
+        else ""
+    )
 
 
 def _safe_media_type(value: object, *, fallback: str | None = None) -> str | None:

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/src/bazaar_compute_node/contrib/sqlite/reminder_repository.py

@@ -49,25 +49,15 @@ class ReminderTransaction(SqliteTransaction):
     async def resolve_inbound_message(
         self,
         session_id: str,
-        message_id_or_prefix: str,
+        message_id: str,
     ) -> InboundMessage | None:
         validate_non_empty_text(session_id, "session_id")
-        reference = canonical_id_reference(message_id_or_prefix)
-        if len(reference) == 8:
-            rows = await self.fetchall(
-                f"SELECT {_INBOUND_COLUMNS} FROM inbound_messages "
-                "WHERE session_id = ? AND message_id LIKE ? ORDER BY seq",
-                (session_id, f"{reference}%"),
-            )
-            if len(rows) > 1:
-                raise ValueError("inbound message id prefix is ambiguous")
-            row = rows[0] if rows else None
-        else:
-            row = await self.fetchone(
-                f"SELECT {_INBOUND_COLUMNS} FROM inbound_messages "
-                "WHERE session_id = ? AND message_id = ?",
-                (session_id, reference),
-            )
+        reference = canonical_id_reference(message_id)
+        row = await self.fetchone(
+            f"SELECT {_INBOUND_COLUMNS} FROM inbound_messages "
+            "WHERE session_id = ? AND message_id = ?",
+            (session_id, reference),
+        )
         if row is None:
             return None
         return inbound_message_from_row(row, await self._attachments(row["message_id"]))
@@ -75,26 +65,15 @@ class ReminderTransaction(SqliteTransaction):
     async def get_reminder(
         self,
         owner_session_id: str,
-        reminder_id_or_prefix: str,
+        reminder_id: str,
     ) -> Reminder | None:
         validate_non_empty_text(owner_session_id, "owner_session_id")
-        reference = canonical_id_reference(reminder_id_or_prefix)
-        if len(reference) == 8:
-            rows = await self.fetchall(
-                f"SELECT {_REMINDER_COLUMNS} FROM reminders "
-                "WHERE owner_session_id = ? AND reminder_id LIKE ? "
-                "ORDER BY reminder_id",
-                (owner_session_id, f"{reference}%"),
-            )
-            if len(rows) > 1:
-                raise ValueError("reminder id prefix is ambiguous")
-            row = rows[0] if rows else None
-        else:
-            row = await self.fetchone(
-                f"SELECT {_REMINDER_COLUMNS} FROM reminders "
-                "WHERE owner_session_id = ? AND reminder_id = ?",
-                (owner_session_id, reference),
-            )
+        reference = canonical_id_reference(reminder_id)
+        row = await self.fetchone(
+            f"SELECT {_REMINDER_COLUMNS} FROM reminders "
+            "WHERE owner_session_id = ? AND reminder_id = ?",
+            (owner_session_id, reference),
+        )
         return reminder_from_row(row) if row is not None else None
 
     async def list_reminders(
@@ -129,8 +108,6 @@ class ReminderTransaction(SqliteTransaction):
         if await self.get_bcn_session(reminder.owner_session_id) is None:
             raise ValueError(f"unknown bcn session: {reminder.owner_session_id}")
         anchor_reference = canonical_id_reference(reminder.anchor_message_id)
-        if len(anchor_reference) != 36:
-            raise ValueError("anchor_message_id must be a full local message id")
         anchor = await self.resolve_inbound_message(
             reminder.owner_session_id, anchor_reference
         )
@@ -555,8 +532,6 @@ class ReminderTransaction(SqliteTransaction):
         marked: list[ReminderOccurrence] = []
         for occurrence_id in occurrence_ids:
             reference = canonical_id_reference(occurrence_id)
-            if len(reference) != 36:
-                raise ValueError("occurrence ids must be full UUIDs")
             row = await self.fetchone(
                 f"SELECT {_OCCURRENCE_COLUMNS} FROM reminder_occurrences "
                 "WHERE occurrence_id = ? AND owner_session_id = ?",

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/src/bazaar_compute_node/contrib/sqlite/scoped_repository.py

@@ -484,26 +484,15 @@ class ReminderTransaction(_ReminderTransaction):
     async def resolve_inbound_message(
         self,
         session_id: str,
-        message_id_or_prefix: str,
+        message_id: str,
     ) -> InboundMessage | None:
         validate_non_empty_text(session_id, "session_id")
-        reference = canonical_id_reference(message_id_or_prefix)
-        if len(reference) == 8:
-            rows = await self.fetchall(
-                f"SELECT {_INBOUND_COLUMNS} FROM inbound_messages "
-                "WHERE agent_id = bcn_agent_id() AND session_id = ? "
-                "AND message_id LIKE ? ORDER BY seq",
-                (session_id, f"{reference}%"),
-            )
-            if len(rows) > 1:
-                raise ValueError("inbound message id prefix is ambiguous")
-            row = rows[0] if rows else None
-        else:
-            row = await self.fetchone(
-                f"SELECT {_INBOUND_COLUMNS} FROM inbound_messages "
-                "WHERE agent_id = bcn_agent_id() AND session_id = ? AND message_id = ?",
-                (session_id, reference),
-            )
+        reference = canonical_id_reference(message_id)
+        row = await self.fetchone(
+            f"SELECT {_INBOUND_COLUMNS} FROM inbound_messages "
+            "WHERE agent_id = bcn_agent_id() AND session_id = ? AND message_id = ?",
+            (session_id, reference),
+        )
         if row is None:
             return None
         return inbound_message_from_row(
@@ -514,27 +503,16 @@ class ReminderTransaction(_ReminderTransaction):
     async def get_reminder(
         self,
         owner_session_id: str,
-        reminder_id_or_prefix: str,
+        reminder_id: str,
     ) -> Reminder | None:
         validate_non_empty_text(owner_session_id, "owner_session_id")
-        reference = canonical_id_reference(reminder_id_or_prefix)
-        if len(reference) == 8:
-            rows = await self.fetchall(
-                f"SELECT {_REMINDER_COLUMNS} FROM reminders "
-                "WHERE agent_id = bcn_agent_id() AND owner_session_id = ? "
-                "AND reminder_id LIKE ? ORDER BY reminder_id",
-                (owner_session_id, f"{reference}%"),
-            )
-            if len(rows) > 1:
-                raise ValueError("reminder id prefix is ambiguous")
-            row = rows[0] if rows else None
-        else:
-            row = await self.fetchone(
-                f"SELECT {_REMINDER_COLUMNS} FROM reminders "
-                "WHERE agent_id = bcn_agent_id() AND owner_session_id = ? "
-                "AND reminder_id = ?",
-                (owner_session_id, reference),
-            )
+        reference = canonical_id_reference(reminder_id)
+        row = await self.fetchone(
+            f"SELECT {_REMINDER_COLUMNS} FROM reminders "
+            "WHERE agent_id = bcn_agent_id() AND owner_session_id = ? "
+            "AND reminder_id = ?",
+            (owner_session_id, reference),
+        )
         return reminder_from_row(row) if row is not None else None
 
     async def list_reminders(
@@ -709,8 +687,6 @@ class ReminderTransaction(_ReminderTransaction):
         marked: list[ReminderOccurrence] = []
         for occurrence_id in occurrence_ids:
             reference = canonical_id_reference(occurrence_id)
-            if len(reference) != 36:
-                raise ValueError("occurrence ids must be full UUIDs")
             row = await self.fetchone(
                 f"SELECT {_OCCURRENCE_COLUMNS} FROM reminder_occurrences "
                 "WHERE agent_id = bcn_agent_id() AND occurrence_id = ? "

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/src/bazaar_compute_node/contrib/wecom/channel.py

@@ -32,6 +32,7 @@ from ...core.models import (
     InboundAttachment,
     InboundMessage,
     SenderIdentity,
+    SenderKind,
 )
 from ...core.outcomes import ProviderCallResult, ProviderCallStatus
 from ...core.runtime import RuntimeStreamItem
@@ -1005,7 +1006,7 @@ class WeComChannel(IChannel):
         canonical_target = f"{target_prefix}:{channel_session_id}"
         received_at_ms = time_ns() // 1_000_000
         content = await self._content(body, message_type)
-        metadata: dict[str, object] = {}
+        metadata: dict[str, object] = {"sender_kind": SenderKind.HUMAN.value}
         create_time = body.get("create_time")
         if isinstance(create_time, int) and not isinstance(create_time, bool):
             metadata["provider_create_time"] = create_time
@@ -1041,6 +1042,7 @@ class WeComChannel(IChannel):
                         mentions_agent=False,
                         notifies_runtime=False,
                         attachments=quote_content.attachments,
+                        metadata={"sender_kind": SenderKind.HUMAN.value},
                     )
                 )
             else:

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/src/bazaar_compute_node/core/orchestration/reminder_command.py

@@ -317,11 +317,6 @@ class ReminderCommandService(IReminderService):
         try:
             anchor = await transaction.resolve_inbound_message(session_id, message_id)
         except ValueError as error:
-            if "ambiguous" in str(error).casefold():
-                raise ReminderCommandFailure(
-                    "REMINDER_ANCHOR_AMBIGUOUS",
-                    str(error),
-                ) from error
             raise ReminderCommandFailure(
                 "REMINDER_ANCHOR_NOT_FOUND",
                 str(error),
@@ -342,11 +337,6 @@ class ReminderCommandService(IReminderService):
         try:
             reminder = await transaction.get_reminder(session_id, reminder_id)
         except ValueError as error:
-            if "ambiguous" in str(error).casefold():
-                raise ReminderCommandFailure(
-                    "REMINDER_ID_AMBIGUOUS",
-                    str(error),
-                ) from error
             raise ReminderCommandFailure(
                 "REMINDER_NOT_FOUND",
                 str(error),

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/src/bazaar_compute_node/core/reminder.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import re
 from dataclasses import dataclass
 from typing import Self
 from unicodedata import category
@@ -21,8 +20,6 @@ from .reminder_schedule import (
     resolve_schedule,
 )
 
-_ID_PREFIX_PATTERN = re.compile(r"[0-9a-fA-F]{8}\Z")
-
 __all__ = [
     "RecurrenceKind",
     "ReminderCancelRequest",
@@ -49,7 +46,6 @@ __all__ = [
     "parse_fire_at",
     "parse_repeat_rule",
     "resolve_schedule",
-    "short_id",
 ]
 
 
@@ -299,27 +295,15 @@ class ReminderCancelResult:
 def canonical_id_reference(value: str) -> str:
     if not isinstance(value, str) or not value:
         raise ValueError("id reference must be a non-empty string")
-    if _ID_PREFIX_PATTERN.fullmatch(value) is not None:
-        return value.lower()
     try:
         parsed = UUID(value)
     except ValueError as error:
-        raise ValueError(
-            "id reference must be a UUID or 8-character hexadecimal prefix"
-        ) from error
+        raise ValueError("id reference must be a canonical full UUID") from error
     if str(parsed) != value.lower():
         raise ValueError("full UUID references must use canonical hyphenated form")
     return str(parsed)
 
 
-def short_id(value: str) -> str:
-    try:
-        parsed = UUID(value)
-    except (TypeError, ValueError) as error:
-        raise ValueError("value must be a full UUID") from error
-    return parsed.hex[:8]
-
-
 def _require_non_negative_int(value: int, field_name: str) -> None:
     if isinstance(value, bool) or not isinstance(value, int) or value < 0:
         raise ValueError(f"{field_name} must be a non-negative integer")

{bazaar_compute_node-0.1.20 → bazaar_compute_node-0.1.22}/src/bazaar_compute_node/core/storage.py

@@ -42,7 +42,7 @@ class IStorageTransaction(Protocol):
     ) -> InboundMessage | None: ...
 
     async def resolve_inbound_message(
-        self, session_id: str, message_id_or_prefix: str
+        self, session_id: str, message_id: str
     ) -> InboundMessage | None: ...
 
     async def list_ready_attachment_paths(self) -> tuple[str, ...]: ...
@@ -75,7 +75,7 @@ class IStorageTransaction(Protocol):
     ) -> OutboundMessage: ...
 
     async def get_reminder(
-        self, owner_session_id: str, reminder_id_or_prefix: str
+        self, owner_session_id: str, reminder_id: str
     ) -> Reminder | None: ...
 
     async def list_reminders(