feat: add Python 3.10 support

- Lower requires-python from >=3.11 to >=3.10 (aligns with pydantic-ai)
- Add 3.10 to CI test matrix (3.10, 3.11, 3.12, 3.13)
- Replace datetime.UTC (3.11+) with datetime.timezone.utc (all versions)
  across 28 files in src/ and tests/
- Use asyncio.TimeoutError with noqa for ruff UP041 compat
- Update ruff target-version to py310
- Update README, classifiers, and docs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: patrick-chinchill

src/chat_sdk/adapters/discord/adapter.py

@@ -13,7 +13,7 @@
 import os
 import re
 from contextvars import ContextVar
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from typing import Any
 from urllib.parse import quote
 
@@ -60,6 +60,7 @@
     StreamOptions,
     ThreadInfo,
     WebhookOptions,
+    _parse_iso,
 )
 
 DISCORD_API_BASE = "https://discord.com/api/v10"
@@ -588,9 +589,9 @@ async def _handle_forwarded_message(
                 is_me=author_data.get("id") == self._application_id,
             ),
             metadata=MessageMetadata(
-                date_sent=datetime.fromisoformat(data.get("timestamp", ""))
+                date_sent=_parse_iso(data.get("timestamp", ""))
                 if data.get("timestamp")
-                else datetime.now(UTC),
+                else datetime.now(timezone.utc),
                 edited=False,
             ),
             attachments=[
@@ -1239,9 +1240,9 @@ def _parse_discord_message(self, raw: dict[str, Any], thread_id: str) -> Message
                 is_me=is_me,
             ),
             metadata=MessageMetadata(
-                date_sent=datetime.fromisoformat(msg["timestamp"]) if msg.get("timestamp") else datetime.now(UTC),
+                date_sent=_parse_iso(msg["timestamp"]) if msg.get("timestamp") else datetime.now(timezone.utc),
                 edited=msg.get("edited_timestamp") is not None,
-                edited_at=datetime.fromisoformat(msg["edited_timestamp"]) if msg.get("edited_timestamp") else None,
+                edited_at=_parse_iso(msg["edited_timestamp"]) if msg.get("edited_timestamp") else None,
             ),
             attachments=[
                 Attachment(
@@ -1284,7 +1285,7 @@ async def _create_discord_thread(
         message_id: str,
     ) -> dict[str, str]:
         """Create a Discord thread from a message."""
-        thread_name = f"Thread {datetime.now(UTC).isoformat()}"
+        thread_name = f"Thread {datetime.now(timezone.utc).isoformat()}"
 
         self._logger.debug(
             "Discord API: POST thread",

src/chat_sdk/adapters/github/adapter.py

@@ -16,7 +16,7 @@
 import re
 import time
 from collections.abc import AsyncIterable
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from typing import Any
 
 from chat_sdk.adapters.github.cards import card_to_github_markdown
@@ -55,6 +55,7 @@
     ThreadInfo,
     ThreadSummary,
     WebhookOptions,
+    _parse_iso,
 )
 
 REVIEW_COMMENT_THREAD_PATTERN = re.compile(r"^([^/]+)/([^:]+):(\d+):rc:(\d+)$")
@@ -384,11 +385,9 @@ def _parse_issue_comment(
             },
             author=author,
             metadata=MessageMetadata(
-                date_sent=datetime.fromisoformat(created_at.replace("Z", "+00:00"))
-                if created_at
-                else datetime.now(tz=UTC),
+                date_sent=_parse_iso(created_at) if created_at else datetime.now(tz=timezone.utc),
                 edited=edited,
-                edited_at=datetime.fromisoformat(updated_at.replace("Z", "+00:00")) if edited and updated_at else None,
+                edited_at=_parse_iso(updated_at) if edited and updated_at else None,
             ),
             attachments=[],
         )
@@ -426,11 +425,9 @@ def _parse_review_comment(
             },
             author=author,
             metadata=MessageMetadata(
-                date_sent=datetime.fromisoformat(created_at.replace("Z", "+00:00"))
-                if created_at
-                else datetime.now(tz=UTC),
+                date_sent=_parse_iso(created_at) if created_at else datetime.now(tz=timezone.utc),
                 edited=edited,
-                edited_at=datetime.fromisoformat(updated_at.replace("Z", "+00:00")) if edited and updated_at else None,
+                edited_at=_parse_iso(updated_at) if edited and updated_at else None,
             ),
             attachments=[],
         )
@@ -785,17 +782,17 @@ async def list_threads(
                 },
                 author=self._parse_author(pr_user),
                 metadata=MessageMetadata(
-                    date_sent=datetime.fromisoformat(pr.get("created_at", "").replace("Z", "+00:00"))
+                    date_sent=_parse_iso(pr.get("created_at", "").replace("Z", "+00:00"))
                     if pr.get("created_at")
-                    else datetime.now(tz=UTC),
+                    else datetime.now(tz=timezone.utc),
                     edited=pr.get("created_at") != pr.get("updated_at"),
                 ),
             )
             threads.append(
                 ThreadSummary(
                     id=tid,
                     root_message=root_message,
-                    last_reply_at=datetime.fromisoformat(pr.get("updated_at", "").replace("Z", "+00:00"))
+                    last_reply_at=_parse_iso(pr.get("updated_at", "").replace("Z", "+00:00"))
                     if pr.get("updated_at")
                     else None,
                 )
@@ -928,13 +925,9 @@ async def _get_installation_token(self, installation_id: int) -> str:
                 data = await response.json()
 
             token = data["token"]
-            # Parse ISO-8601 expiry from GitHub's response
+            # Parse ISO-8601 expiry; default 1h if absent
             expires_at_str = data.get("expires_at", "")
-            if expires_at_str:
-                expires_at = datetime.fromisoformat(expires_at_str.replace("Z", "+00:00")).timestamp()
-            else:
-                # Default: 1 hour from now (GitHub's default)
-                expires_at = time.time() + 3600
+            expires_at = _parse_iso(expires_at_str).timestamp() if expires_at_str else time.time() + 3600
 
             self._installation_token_cache[installation_id] = (token, expires_at)
             self._logger.debug(

src/chat_sdk/adapters/google_chat/adapter.py

@@ -16,7 +16,7 @@
 import re
 import time
 from collections.abc import AsyncIterable, Awaitable, Callable
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from typing import Any
 
 from chat_sdk.adapters.google_chat.cards import card_to_google_card
@@ -78,6 +78,7 @@
     ThreadInfo,
     ThreadSummary,
     WebhookOptions,
+    _parse_iso,
 )
 
 # Strong-reference set for fire-and-forget tasks to prevent GC collection.
@@ -611,9 +612,7 @@ async def _create_space_subscription_with_cache(
 
             subscription_info = {
                 "subscription_name": result.name,
-                "expire_time": int(datetime.fromisoformat(result.expire_time.replace("Z", "+00:00")).timestamp() * 1000)
-                if result.expire_time
-                else 0,
+                "expire_time": int(_parse_iso(result.expire_time).timestamp() * 1000) if result.expire_time else 0,
             }
 
             if self._state:
@@ -647,7 +646,7 @@ async def _find_existing_subscription(
             for sub in subscriptions:
                 expire_time_str = sub.get("expire_time", "")
                 if expire_time_str:
-                    expire_time = int(datetime.fromisoformat(expire_time_str.replace("Z", "+00:00")).timestamp() * 1000)
+                    expire_time = int(_parse_iso(expire_time_str).timestamp() * 1000)
                     if expire_time > int(time.time() * 1000) + SUBSCRIPTION_REFRESH_BUFFER_MS:
                         return {
                             "subscription_name": sub.get("name", ""),
@@ -2310,7 +2309,7 @@ async def list_threads(
                 last_reply_at: datetime | None = None
                 if create_time:
                     with contextlib.suppress(ValueError, AttributeError):
-                        last_reply_at = datetime.fromisoformat(create_time.replace("Z", "+00:00"))
+                        last_reply_at = _parse_iso(create_time)
 
                 threads.append(
                     ThreadSummary(
@@ -2725,11 +2724,11 @@ def _parse_message_metadata(message: dict[str, Any]) -> Any:
     date_sent: datetime
     if create_time:
         try:
-            date_sent = datetime.fromisoformat(create_time.replace("Z", "+00:00"))
+            date_sent = _parse_iso(create_time)
         except (ValueError, AttributeError):
-            date_sent = datetime.now(tz=UTC)
+            date_sent = datetime.now(tz=timezone.utc)
     else:
-        date_sent = datetime.now(tz=UTC)
+        date_sent = datetime.now(tz=timezone.utc)
 
     return MessageMetadata(
         date_sent=date_sent,

src/chat_sdk/adapters/linear/adapter.py

@@ -15,7 +15,7 @@
 import os
 import re
 import time
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from typing import Any
 
 from chat_sdk.adapters.linear.cards import card_to_linear_markdown
@@ -53,6 +53,7 @@
     StreamOptions,
     ThreadInfo,
     WebhookOptions,
+    _parse_iso,
 )
 
 COMMENT_THREAD_PATTERN = re.compile(r"^([^:]+):c:([^:]+)$")
@@ -415,9 +416,9 @@ def _build_message(
             raw=LinearRawMessage(comment=comment),
             author=author,
             metadata=MessageMetadata(
-                date_sent=datetime.fromisoformat(created_at) if created_at else datetime.now(UTC),
+                date_sent=_parse_iso(created_at) if created_at else datetime.now(timezone.utc),
                 edited=created_at != updated_at,
-                edited_at=datetime.fromisoformat(updated_at) if (created_at != updated_at and updated_at) else None,
+                edited_at=_parse_iso(updated_at) if (created_at != updated_at and updated_at) else None,
             ),
             attachments=[],
         )
@@ -749,10 +750,10 @@ def _comment_node_to_message(
                 is_me=user_id == self._bot_user_id,
             ),
             metadata=MessageMetadata(
-                date_sent=datetime.fromisoformat(node["createdAt"]) if node.get("createdAt") else datetime.now(UTC),
+                date_sent=_parse_iso(node["createdAt"]) if node.get("createdAt") else datetime.now(timezone.utc),
                 edited=node.get("createdAt") != node.get("updatedAt"),
                 edited_at=(
-                    datetime.fromisoformat(node["updatedAt"])
+                    _parse_iso(node["updatedAt"])
                     if node.get("createdAt") != node.get("updatedAt") and node.get("updatedAt")
                     else None
                 ),
@@ -852,9 +853,9 @@ def parse_message(self, raw: LinearRawMessage) -> Message:
                 is_me=user_id == self._bot_user_id,
             ),
             metadata=MessageMetadata(
-                date_sent=(datetime.fromisoformat(created_at) if created_at else datetime.now(UTC)),
+                date_sent=(_parse_iso(created_at) if created_at else datetime.now(timezone.utc)),
                 edited=created_at != updated_at,
-                edited_at=(datetime.fromisoformat(updated_at) if created_at != updated_at and updated_at else None),
+                edited_at=(_parse_iso(updated_at) if created_at != updated_at and updated_at else None),
             ),
             attachments=[],
             raw=raw,

src/chat_sdk/adapters/slack/adapter.py

@@ -20,7 +20,7 @@
 from collections import OrderedDict
 from collections.abc import AsyncIterable, Awaitable, Callable
 from contextvars import ContextVar
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from typing import Any
 from urllib.parse import parse_qs
 
@@ -1574,14 +1574,14 @@ async def _parse_slack_message(
 
         ts_str = event.get("ts", "0")
         try:
-            date_sent = datetime.fromtimestamp(float(ts_str), tz=UTC)
+            date_sent = datetime.fromtimestamp(float(ts_str), tz=timezone.utc)
         except (ValueError, TypeError, OSError):
-            date_sent = datetime.now(tz=UTC)
+            date_sent = datetime.now(tz=timezone.utc)
 
         edited_at: datetime | None = None
         if event.get("edited"):
             try:
-                edited_at = datetime.fromtimestamp(float(event["edited"].get("ts", "0")), tz=UTC)
+                edited_at = datetime.fromtimestamp(float(event["edited"].get("ts", "0")), tz=timezone.utc)
             except (ValueError, TypeError, OSError):
                 edited_at = None
 
@@ -1616,14 +1616,14 @@ def _parse_slack_message_sync(self, event: dict[str, Any], thread_id: str) -> Me
 
         ts_str = event.get("ts", "0")
         try:
-            date_sent = datetime.fromtimestamp(float(ts_str), tz=UTC)
+            date_sent = datetime.fromtimestamp(float(ts_str), tz=timezone.utc)
         except (ValueError, TypeError, OSError):
-            date_sent = datetime.now(tz=UTC)
+            date_sent = datetime.now(tz=timezone.utc)
 
         edited_at: datetime | None = None
         if event.get("edited"):
             try:
-                edited_at = datetime.fromtimestamp(float(event["edited"].get("ts", "0")), tz=UTC)
+                edited_at = datetime.fromtimestamp(float(event["edited"].get("ts", "0")), tz=timezone.utc)
             except (ValueError, TypeError, OSError):
                 edited_at = None
 
@@ -2585,7 +2585,7 @@ async def list_threads(self, channel_id: str, options: ListThreadsOptions | None
                 last_reply_at: datetime | None = None
                 if msg.get("latest_reply"):
                     try:
-                        last_reply_at = datetime.fromtimestamp(float(msg["latest_reply"]), tz=UTC)
+                        last_reply_at = datetime.fromtimestamp(float(msg["latest_reply"]), tz=timezone.utc)
                     except (ValueError, TypeError, OSError):
                         last_reply_at = None
 

src/chat_sdk/adapters/teams/adapter.py

@@ -13,7 +13,7 @@
 import json
 import os
 import re
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from typing import Any, NoReturn
 
 from chat_sdk.adapters.teams.cards import card_to_adaptive_card
@@ -52,6 +52,7 @@
     StreamOptions,
     ThreadInfo,
     WebhookOptions,
+    _parse_iso,
 )
 
 MESSAGEID_CAPTURE_PATTERN = re.compile(r"messageid=(\d+)")
@@ -527,9 +528,9 @@ def _parse_teams_message(
                 is_me=is_me,
             ),
             metadata=MessageMetadata(
-                date_sent=datetime.fromisoformat(activity["timestamp"])
+                date_sent=_parse_iso(activity["timestamp"])
                 if activity.get("timestamp")
-                else datetime.now(UTC),
+                else datetime.now(timezone.utc),
                 edited=False,
             ),
             attachments=attachments,
@@ -1430,7 +1431,7 @@ def _map_graph_message(self, msg: dict[str, Any], thread_id: str) -> Message:
             ),
             metadata=MessageMetadata(
                 date_sent=(
-                    datetime.fromisoformat(msg["createdDateTime"]) if msg.get("createdDateTime") else datetime.now(UTC)
+                    _parse_iso(msg["createdDateTime"]) if msg.get("createdDateTime") else datetime.now(timezone.utc)
                 ),
                 edited=bool(msg.get("lastModifiedDateTime")),
             ),

src/chat_sdk/adapters/telegram/adapter.py

@@ -17,7 +17,7 @@
 import os
 import re
 from dataclasses import dataclass
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from typing import Any
 
 from chat_sdk.adapters.telegram.cards import (
@@ -944,7 +944,7 @@ async def edit_message(
                 metadata=MessageMetadata(
                     date_sent=existing.metadata.date_sent,
                     edited=True,
-                    edited_at=datetime.now(UTC),
+                    edited_at=datetime.now(timezone.utc),
                 ),
                 attachments=existing.attachments,
                 is_mention=existing.is_mention,
@@ -1259,9 +1259,9 @@ def parse_telegram_message(
             raw=raw,
             author=author,
             metadata=MessageMetadata(
-                date_sent=datetime.fromtimestamp(raw["date"], tz=UTC),
+                date_sent=datetime.fromtimestamp(raw["date"], tz=timezone.utc),
                 edited=edit_date is not None,
-                edited_at=(datetime.fromtimestamp(edit_date, tz=UTC) if edit_date is not None else None),
+                edited_at=(datetime.fromtimestamp(edit_date, tz=timezone.utc) if edit_date is not None else None),
             ),
             attachments=self.extract_attachments(raw),
             is_mention=self.is_bot_mentioned(raw, plain_text),

src/chat_sdk/adapters/whatsapp/adapter.py

@@ -15,7 +15,7 @@
 import os
 import time
 from collections.abc import AsyncIterable
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from typing import Any
 from urllib.parse import parse_qs, urlparse
 
@@ -525,7 +525,7 @@ def _build_message(
             metadata=MessageMetadata(
                 date_sent=datetime.fromtimestamp(
                     int(inbound.get("timestamp", "0")),
-                    tz=UTC,
+                    tz=timezone.utc,
                 ),
                 edited=False,
             ),
@@ -981,7 +981,7 @@ def parse_message(self, raw: WhatsAppRawMessage) -> Message:
             metadata=MessageMetadata(
                 date_sent=datetime.fromtimestamp(
                     int(raw["message"].get("timestamp", "0")),
-                    tz=UTC,
+                    tz=timezone.utc,
                 ),
                 edited=False,
             ),